@aios-medical/cashier-nestjs

中文文档
1.7.0发布于 2026/10/16MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 1926

出纳机的NestJS模块:与Root,RootAsync,可注入出纳服务机和例外过滤器统一订阅账单.

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 文档
  4. 许可证

@aios- medical/cashier-nestjs (医疗) 互联网档案馆的存檔,存档日期2013-12-22

npm License: MIT

雀巢JS模块 出纳员,用于节点.js和TypeScript的统一订阅收费. 登记在 forRoot 或者说 forRootAsync输入 CashierService 将计费错误转换成合适的 HTTP 响应。 支持雀巢JS 9,10,11和12.

安装

npm install @aios-medical/cashier @aios-medical/cashier-nestjs stripe recurly

使用量

import { Injectable, Module } from '@nestjs/common';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { APP_FILTER } from '@nestjs/core';
import {
  CashierExceptionFilter,
  CashierModule,
  CashierService,
} from '@aios-medical/cashier-nestjs';
import { CashierProvider } from '@aios-medical/cashier';

@Module({
  imports: [
    CashierModule.forRootAsync({
      isGlobal: true,
      imports: [ConfigModule],
      inject: [ConfigService],
      useFactory: (config: ConfigService) => ({
        default: CashierProvider.Stripe,
        providers: {
          stripe: { apiKey: config.getOrThrow('STRIPE_SECRET_KEY') },
          recurly: { apiKey: config.getOrThrow('RECURLY_API_KEY') },
        },
      }),
    }),
  ],
  providers: [{ provide: APP_FILTER, useClass: CashierExceptionFilter }],
})
export class AppModule {}

@Injectable()
export class BillingService {
  constructor(private readonly cashier: CashierService) {}

  getInvoice(invoiceId: string) {
    return this.cashier.use().invoices.get(invoiceId);
  }
}
打电话驱动程序
cashier.use()这个 default 供养. 通过更改配置切换提供者 .
cashier.use(CashierProvider.Recurly)一个提供者来自 providers。 。 。 .
cashier.use(CashierProvider.Stripe, { apiKey })其他全权证书,按运行时间提交.

文档

  • 雀巢JS指南:每个选项,例外过滤和测试.
  • API 参考:客户、发票、付款、产品、价格和订阅.
  • 错误:每个出错分类和HTTP响应.

许可证

麻省理工学院 阿联酋

版本与发布记录

@aios-medical/cashier-nestjs 共发布 10 个版本,首次发布于 2026/10/02;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.0latest2026/10/1622 天前
1.6.02026/10/1424 天前
1.5.02026/10/1226 天前
1.4.12026/10/1127 天前
1.4.02026/10/1029 天前
1.3.02026/10/041 个月前

关于 @aios-medical/cashier-nestjs 的常见问题

@aios-medical/cashier-nestjs 是什么?

出纳机的NestJS模块:与Root,RootAsync,可注入出纳服务机和例外过滤器统一订阅账单.

如何安装 @aios-medical/cashier-nestjs?

在项目目录运行 npm install @aios-medical/cashier-nestjs,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@nestjs/core(^9.0.0 || ^10.0.0 || ^11.0.0 || ^12.0.0)、@nestjs/common(^9.0.0 || ^10.0.0 || ^11.0.0 || ^12.0.0)、@aios-medical/cashier(^1.7.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aios-medical/cashier-nestjs 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aios-medical/cashier-nestjs 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aios-medical/cashier-nestjs 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aios-medical/cashier-nestjs 可以商用吗?

@aios-medical/cashier-nestjs 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aios-medical/cashier-nestjs 的下载量有多少?

根据 npm 官方下载统计,@aios-medical/cashier-nestjs 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,926 次,日均约 64 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aios-medical/cashier-nestjs 还在维护吗?

最新版本 1.7.0 发布于 2026/10/16(22 天前);至今共发布 10 个版本,其中过去 12 个月发布了 10 个;首次发布于 2026/10/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。