@pixmason/nest-cloudbase-sdk 0.1.0

package/README.md

@@ -0,0 +1,240 @@
+# @pixmason/nest-cloudbase-sdk
+
+一个面向 NestJS 的 CloudBase SDK 封装模块，支持动态配置注入（`forRoot` / `forRootAsync`）、基础 CRUD、批量操作、聚合查询、存在性判断与 Repository 模式。
+
+## 特性
+
+- 支持 Nest 动态模块：`CloudbaseModule.forRoot`、`CloudbaseModule.forRootAsync`
+- 统一数据能力：`findOne/createData/updateData/removeData`
+- 批量能力：`findMany/updateMany/removeMany/updateByIds`
+- 统计与存在性：`countTotal/isExistData/findExistData/findExistIds`
+- 高级聚合：`findManyByPipeline`
+- Repository 模式：按集合创建仓储，减少重复传参
+- 中文错误提示 + 错误码，便于全局异常拦截
+
+## 安装
+
+### npm
+
+```bash
+npm i @pixmason/nest-cloudbase-sdk
+```
+
+### pnpm
+
+```bash
+pnpm add @pixmason/nest-cloudbase-sdk
+```
+
+### yarn
+
+```bash
+yarn add @pixmason/nest-cloudbase-sdk
+```
+
+## 快速开始
+
+### 1) 在 AppModule 注册（同步配置）
+
+```ts
+import { Module } from '@nestjs/common'
+import { CloudbaseModule } from '@pixmason/nest-cloudbase-sdk'
+
+@Module({
+	imports: [
+		CloudbaseModule.forRoot({
+			env: '你的环境ID',
+			secretId: '你的SecretId',
+			secretKey: '你的SecretKey',
+			batchLimit: 100, // 可选，默认 100
+		}),
+	],
+})
+export class AppModule {}
+```
+
+### 2) 在服务中注入并调用
+
+```ts
+import { Injectable } from '@nestjs/common'
+import { CloudbaseService } from '@pixmason/nest-cloudbase-sdk'
+
+@Injectable()
+export class UserService {
+	constructor(private readonly cloudbaseService: CloudbaseService) {}
+
+	async getUserList() {
+		return this.cloudbaseService.findMany('users', {
+			currentPage: 1,
+			pageSize: 20,
+			where: { status: 'active' },
+			sort: { _id: -1 },
+			withTotal: true, // 默认就是 true
+		})
+	}
+}
+```
+
+## 支持的调用方式
+
+### 模块初始化
+
+- `CloudbaseModule.forRoot(options)`
+- `CloudbaseModule.forRootAsync({ imports, inject, useFactory })`
+
+### CloudbaseService 方法
+
+- `findOne(collection, where)`
+- `createData(collection, data)`（支持单条和批量）
+- `updateData(collection, where, data)`
+- `removeData(collection, where)`
+- `findMany(collection, params)`
+- `findManyByPipeline(collection, pipeline)`
+- `updateMany(collection, where, data)`
+- `updateByIds(collection, items)`
+- `removeMany(collection, where)`
+- `countTotal(collection, where?)`
+- `findExistData(collection, ids, field?)`
+- `isExistData(collection, ids, options?)`
+- `findExistIds(collection, ids)`
+- `repository(collection)`
+
+### Repository 调用方式
+
+```ts
+const userRepo = cloudbaseService.repository<{ _id: string; name: string }>('users')
+
+await userRepo.findOne({ _id: 'xxx' })
+await userRepo.findMany({ currentPage: 1, pageSize: 10 })
+await userRepo.createData({ name: 'Tom' })
+await userRepo.isExistData(['id1', 'id2'], { allMustExist: true })
+```
+
+## 完整接入示例（forRootAsync）
+
+### 1) AppModule
+
+```ts
+import { Module } from '@nestjs/common'
+import { ConfigModule, ConfigService } from '@nestjs/config'
+import { CloudbaseModule } from '@pixmason/nest-cloudbase-sdk'
+
+@Module({
+	imports: [
+		ConfigModule.forRoot({ isGlobal: true }),
+		CloudbaseModule.forRootAsync({
+			imports: [ConfigModule],
+			inject: [ConfigService],
+			useFactory: (configService: ConfigService) => ({
+				env: configService.get<string>('ENV_ID'),
+				secretId: configService.get<string>('SECRET_ID'),
+				secretKey: configService.get<string>('SECRET_KEY'),
+				batchLimit: Number(configService.get<string>('BATCH_LIMIT') ?? 100),
+			}),
+		}),
+	],
+})
+export class AppModule {}
+```
+
+### 2) 业务 Service
+
+```ts
+import { Injectable } from '@nestjs/common'
+import { CloudbaseService } from '@pixmason/nest-cloudbase-sdk'
+
+@Injectable()
+export class DemoService {
+	constructor(private readonly cloudbaseService: CloudbaseService) {}
+
+	async demo(collection: string) {
+		const created = await this.cloudbaseService.createData(collection, [{ name: 'A' }, { name: 'B' }])
+
+		const page = await this.cloudbaseService.findMany(collection, {
+			currentPage: 1,
+			pageSize: 20,
+			where: {},
+			sort: { _id: 1 },
+		})
+
+		const existAny = await this.cloudbaseService.isExistData(collection, created.ids)
+		const existAll = await this.cloudbaseService.isExistData(collection, created.ids, {
+			allMustExist: true,
+		})
+
+		return {
+			created,
+			page,
+			existAny,
+			existAll,
+		}
+	}
+}
+```
+
+## 常用返回结构
+
+### findMany
+
+```ts
+{
+  data: T[];
+  currentPage: number;
+  pageSize: number;
+  total?: number;
+}
+```
+
+- 默认 `withTotal = true`
+
+### createData
+
+```ts
+{
+  id?: string;   // 单条创建时返回
+  ids: string[]; // 单条/批量统一返回
+  total: number; // 创建成功条数
+}
+```
+
+## isExistData 说明
+
+`isExistData(collection, ids, { allMustExist })`
+
+- `allMustExist = false`（默认）：存在任意一条即返回 `true`
+- `allMustExist = true`：只有全部存在才返回 `true`
+
+## 错误处理
+
+SDK 抛出的错误类型为 `CloudbaseSdkError`，可通过 `code` 统一处理：
+
+- `CLOUDBASE_INIT_FAILED`：初始化失败
+- `CLOUDBASE_QUERY_FAILED`：查询/写入等数据库操作失败
+- `CLOUDBASE_INVALID_PARAM`：参数不合法
+
+示例：
+
+```ts
+try {
+	await cloudbaseService.findMany('users', { currentPage: 1, pageSize: 10 })
+} catch (error) {
+	if (error instanceof CloudbaseSdkError) {
+		console.log(error.code, error.message)
+	}
+}
+```
+
+## 配置项说明
+
+`CloudbaseModuleOptions`：
+
+- `env?: string`
+- `accessKey?: string`
+- `secretId?: string`
+- `secretKey?: string`
+- `sessionToken?: string`
+- `context?: unknown`
+- `timeout?: number`
+- `proxy?: string`
+- `version?: string`
+- `batchLimit?: number`（可选，默认 100）

package/dist/cloudbase.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import { CloudbaseModuleAsyncOptions, CloudbaseModuleOptions } from './interfaces/cloudbase-module-options.interface';
+export declare class CloudbaseModule {
+    static forRoot(options: CloudbaseModuleOptions): DynamicModule;
+    static forRootAsync(options: CloudbaseModuleAsyncOptions): DynamicModule;
+}

package/dist/cloudbase.module.js

@@ -0,0 +1,46 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var CloudbaseModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudbaseModule = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("./constants");
+const cloudbase_service_1 = require("./cloudbase.service");
+let CloudbaseModule = CloudbaseModule_1 = class CloudbaseModule {
+    static forRoot(options) {
+        return {
+            module: CloudbaseModule_1,
+            providers: [
+                {
+                    provide: constants_1.CLOUDBASE_MODULE_OPTIONS,
+                    useValue: options,
+                },
+                cloudbase_service_1.CloudbaseService,
+            ],
+            exports: [cloudbase_service_1.CloudbaseService],
+        };
+    }
+    static forRootAsync(options) {
+        const asyncOptionsProvider = {
+            provide: constants_1.CLOUDBASE_MODULE_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject ?? [],
+        };
+        return {
+            module: CloudbaseModule_1,
+            imports: options.imports ?? [],
+            providers: [asyncOptionsProvider, cloudbase_service_1.CloudbaseService],
+            exports: [cloudbase_service_1.CloudbaseService],
+        };
+    }
+};
+exports.CloudbaseModule = CloudbaseModule;
+exports.CloudbaseModule = CloudbaseModule = CloudbaseModule_1 = __decorate([
+    (0, common_1.Module)({})
+], CloudbaseModule);
+//# sourceMappingURL=cloudbase.module.js.map

package/dist/cloudbase.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudbase.module.js","sourceRoot":"","sources":["../src/cloudbase.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAiE;AACjE,2CAAuD;AAKvD,2DAAuD;AAGhD,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAC,OAA+B;QAC5C,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,oCAAwB;oBACjC,QAAQ,EAAE,OAAO;iBAClB;gBACD,oCAAgB;aACjB;YACD,OAAO,EAAE,CAAC,oCAAgB,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAoC;QACtD,MAAM,oBAAoB,GAAa;YACrC,OAAO,EAAE,oCAAwB;YACjC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE,CAAC,oBAAoB,EAAE,oCAAgB,CAAC;YACnD,OAAO,EAAE,CAAC,oCAAgB,CAAC;SAC5B,CAAC;IACJ,CAAC;CACF,CAAA;AA7BY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,eAAe,CA6B3B"}

package/dist/cloudbase.repository.d.ts

@@ -0,0 +1,23 @@
+import type { CloudbaseService } from './cloudbase.service';
+import type { CreateDataResult, DifferentialUpdateItem, ExistDataOptions, FindManyParams, FindManyResult } from './interfaces/cloudbase-query.interface';
+export declare class CloudbaseRepository<T extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly service;
+    private readonly collection;
+    constructor(service: CloudbaseService, collection: string);
+    findOne(where: Record<string, unknown>): Promise<T | null>;
+    createData(data: T | T[]): Promise<CreateDataResult>;
+    updateData(where: Record<string, unknown>, data: Partial<T>): Promise<number>;
+    removeData(where: Record<string, unknown>): Promise<number>;
+    findMany(params?: FindManyParams): Promise<FindManyResult<T>>;
+    findManyByPipeline(pipeline: Array<Record<string, unknown>> | ((aggregate: any) => any)): Promise<T[]>;
+    updateMany(where: Record<string, unknown>, data: Partial<T>): Promise<number>;
+    updateByIds(items: Array<DifferentialUpdateItem<T>>): Promise<number>;
+    removeMany(where: Record<string, unknown>): Promise<number>;
+    countTotal(where?: Record<string, unknown>): Promise<number>;
+    findExistData(ids: string[], field?: Record<string, boolean | 0 | 1>): Promise<Array<Record<string, unknown>>>;
+    isExistData(ids: string[], options?: ExistDataOptions): Promise<boolean>;
+    findExistIds(ids: string[]): Promise<{
+        foundIds: string[];
+        missingIds: string[];
+    }>;
+}

package/dist/cloudbase.repository.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudbaseRepository = void 0;
+class CloudbaseRepository {
+    constructor(service, collection) {
+        this.service = service;
+        this.collection = collection;
+    }
+    findOne(where) {
+        return this.service.findOne(this.collection, where);
+    }
+    createData(data) {
+        return this.service.createData(this.collection, data);
+    }
+    updateData(where, data) {
+        return this.service.updateData(this.collection, where, data);
+    }
+    removeData(where) {
+        return this.service.removeData(this.collection, where);
+    }
+    findMany(params = {}) {
+        return this.service.findMany(this.collection, params);
+    }
+    findManyByPipeline(pipeline) {
+        return this.service.findManyByPipeline(this.collection, pipeline);
+    }
+    updateMany(where, data) {
+        return this.service.updateMany(this.collection, where, data);
+    }
+    updateByIds(items) {
+        return this.service.updateByIds(this.collection, items);
+    }
+    removeMany(where) {
+        return this.service.removeMany(this.collection, where);
+    }
+    countTotal(where = {}) {
+        return this.service.countTotal(this.collection, where);
+    }
+    findExistData(ids, field = { _id: true }) {
+        return this.service.findExistData(this.collection, ids, field);
+    }
+    isExistData(ids, options = {}) {
+        return this.service.isExistData(this.collection, ids, options);
+    }
+    findExistIds(ids) {
+        return this.service.findExistIds(this.collection, ids);
+    }
+}
+exports.CloudbaseRepository = CloudbaseRepository;
+//# sourceMappingURL=cloudbase.repository.js.map

package/dist/cloudbase.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudbase.repository.js","sourceRoot":"","sources":["../src/cloudbase.repository.ts"],"names":[],"mappings":";;;AASA,MAAa,mBAAmB;IAC9B,YACmB,OAAyB,EACzB,UAAkB;QADlB,YAAO,GAAP,OAAO,CAAkB;QACzB,eAAU,GAAV,UAAU,CAAQ;IAClC,CAAC;IAEJ,OAAO,CAAC,KAA8B;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAI,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,IAAa;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,UAAU,CAAC,KAA8B,EAAE,IAAgB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAI,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,KAA8B;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,SAAyB,EAAE;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAI,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,kBAAkB,CAChB,QAAoE;QAEpE,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAI,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED,UAAU,CAAC,KAA8B,EAAE,IAAgB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAI,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,KAAuC;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAI,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,KAA8B;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,QAAiC,EAAE;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,aAAa,CACX,GAAa,EACb,QAAyC,EAAE,GAAG,EAAE,IAAI,EAAE;QAEtD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,GAAa,EAAE,UAA4B,EAAE;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,YAAY,CAAC,GAAa;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;CACF;AA9DD,kDA8DC"}

package/dist/cloudbase.service.d.ts

@@ -0,0 +1,35 @@
+import { CloudbaseRepository } from './cloudbase.repository';
+import { CloudbaseModuleOptions } from './interfaces/cloudbase-module-options.interface';
+import { CreateDataResult, DifferentialUpdateItem, ExistDataOptions, FindManyParams, FindManyResult } from './interfaces/cloudbase-query.interface';
+export declare class CloudbaseService {
+    private readonly options;
+    private readonly app;
+    private readonly db;
+    private readonly command;
+    private readonly batchLimit;
+    constructor(options: CloudbaseModuleOptions);
+    repository<T extends Record<string, unknown> = Record<string, unknown>>(collection: string): CloudbaseRepository<T>;
+    findOne<T>(collection: string, where: Record<string, unknown>): Promise<T | null>;
+    createData<T extends Record<string, unknown>>(collection: string, data: T | T[]): Promise<CreateDataResult>;
+    updateData<T extends Record<string, unknown>>(collection: string, where: Record<string, unknown>, data: Partial<T>): Promise<number>;
+    removeData(collection: string, where: Record<string, unknown>): Promise<number>;
+    findMany<T>(collection: string, params?: FindManyParams): Promise<FindManyResult<T>>;
+    findManyByPipeline<T>(collection: string, pipeline: Array<Record<string, unknown>> | ((aggregate: any) => any)): Promise<T[]>;
+    updateMany<T extends Record<string, unknown>>(collection: string, where: Record<string, unknown>, data: Partial<T>): Promise<number>;
+    updateByIds<T extends Record<string, unknown>>(collection: string, items: Array<DifferentialUpdateItem<T>>): Promise<number>;
+    removeMany(collection: string, where: Record<string, unknown>): Promise<number>;
+    countTotal(collection: string, where?: Record<string, unknown>): Promise<number>;
+    findExistData(collection: string, ids: string[], field?: Record<string, boolean | 0 | 1>): Promise<Array<Record<string, unknown>>>;
+    isExistData(collection: string, ids: string[], options?: ExistDataOptions): Promise<boolean>;
+    findExistIds(collection: string, ids: string[]): Promise<{
+        foundIds: string[];
+        missingIds: string[];
+    }>;
+    private col;
+    private applySort;
+    private chunk;
+    private unique;
+    private sanitizeBatchLimit;
+    private extractCreatedIds;
+    private wrapError;
+}

package/dist/cloudbase.service.js

@@ -0,0 +1,287 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudbaseService = void 0;
+const common_1 = require("@nestjs/common");
+const p_map_1 = __importDefault(require("p-map"));
+const cloudbase_repository_1 = require("./cloudbase.repository");
+const constants_1 = require("./constants");
+const cloudbase_sdk_error_1 = require("./errors/cloudbase-sdk.error");
+const DEFAULT_BATCH_LIMIT = 100;
+const MAX_PAGE_SIZE = 1000;
+let CloudbaseService = class CloudbaseService {
+    constructor(options) {
+        this.options = options;
+        try {
+            const cloudbase = require('@cloudbase/node-sdk');
+            const { batchLimit, ...initOptions } = options;
+            this.batchLimit = this.sanitizeBatchLimit(batchLimit);
+            this.app = cloudbase.init(initOptions);
+            this.db = this.app.database();
+            this.command = this.db.command;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new cloudbase_sdk_error_1.CloudbaseSdkError(cloudbase_sdk_error_1.CLOUDBASE_ERROR_CODE.INIT_FAILED, `CloudBase 初始化失败：${message}`);
+        }
+    }
+    repository(collection) {
+        return new cloudbase_repository_1.CloudbaseRepository(this, collection);
+    }
+    async findOne(collection, where) {
+        return this.wrapError('查询单条数据', async () => {
+            const res = (await this.col(collection)
+                .where(where)
+                .limit(1)
+                .get());
+            return res.data?.[0] ?? null;
+        });
+    }
+    async createData(collection, data) {
+        return this.wrapError('创建数据', async () => {
+            if (Array.isArray(data) && data.length === 0) {
+                throw new cloudbase_sdk_error_1.CloudbaseSdkError(cloudbase_sdk_error_1.CLOUDBASE_ERROR_CODE.INVALID_PARAM, '创建数据不能为空数组');
+            }
+            const res = (await this.col(collection).add(data));
+            const ids = this.extractCreatedIds(res);
+            const isArrayInput = Array.isArray(data);
+            return {
+                id: isArrayInput ? undefined : ids[0],
+                ids,
+                total: ids.length,
+            };
+        });
+    }
+    async updateData(collection, where, data) {
+        return this.wrapError('更新单条数据', async () => {
+            const target = await this.findOne(collection, where);
+            if (!target?._id) {
+                return 0;
+            }
+            const res = (await this.col(collection).doc(target._id).update(data));
+            return Number(res.updated ?? 0);
+        });
+    }
+    async removeData(collection, where) {
+        return this.wrapError('删除单条数据', async () => {
+            const target = await this.findOne(collection, where);
+            if (!target?._id) {
+                return 0;
+            }
+            const res = (await this.col(collection).doc(target._id).remove());
+            return Number(res.deleted ?? 0);
+        });
+    }
+    async findMany(collection, params = {}) {
+        return this.wrapError('查询多条数据', async () => {
+            const { currentPage = 1, pageSize = DEFAULT_BATCH_LIMIT, where = {}, sort = { _id: 1 }, field, withTotal = true, } = params;
+            const safePage = Math.max(Number(currentPage) || 1, 1);
+            const safeSize = Math.min(Math.max(Number(pageSize) || DEFAULT_BATCH_LIMIT, 1), MAX_PAGE_SIZE);
+            const skip = (safePage - 1) * safeSize;
+            let query = this.col(collection).where(where);
+            if (field && Object.keys(field).length > 0) {
+                query = query.field(field);
+            }
+            query = this.applySort(query, sort).skip(skip).limit(safeSize);
+            const res = (await query.get());
+            const result = {
+                data: res.data ?? [],
+                currentPage: safePage,
+                pageSize: safeSize,
+            };
+            if (withTotal) {
+                const countRes = (await this.col(collection).where(where).count());
+                result.total = Number(countRes.total ?? 0);
+            }
+            return result;
+        });
+    }
+    async findManyByPipeline(collection, pipeline) {
+        return this.wrapError('聚合查询', async () => {
+            const aggregate = this.col(collection).aggregate();
+            if (typeof pipeline === 'function') {
+                const cursor = pipeline(aggregate);
+                const res = (await cursor.end());
+                return res.data ?? [];
+            }
+            let cursor = aggregate;
+            for (const stage of pipeline) {
+                const entries = Object.entries(stage);
+                if (entries.length === 0) {
+                    continue;
+                }
+                if (entries.length > 1) {
+                    throw new cloudbase_sdk_error_1.CloudbaseSdkError(cloudbase_sdk_error_1.CLOUDBASE_ERROR_CODE.INVALID_PARAM, '每个聚合阶段仅允许一个操作符');
+                }
+                const [[rawOperator, rawPayload]] = entries;
+                if (!rawOperator) {
+                    continue;
+                }
+                const operator = rawOperator.startsWith('$') ? rawOperator.slice(1) : rawOperator;
+                if (typeof cursor[operator] !== 'function') {
+                    throw new cloudbase_sdk_error_1.CloudbaseSdkError(cloudbase_sdk_error_1.CLOUDBASE_ERROR_CODE.INVALID_PARAM, `不支持的聚合操作符：${rawOperator}`);
+                }
+                cursor = cursor[operator](rawPayload);
+            }
+            const res = (await cursor.end());
+            return res.data ?? [];
+        });
+    }
+    async updateMany(collection, where, data) {
+        return this.wrapError('批量更新数据', async () => {
+            const res = (await this.col(collection).where(where).update(data));
+            return Number(res.updated ?? 0);
+        });
+    }
+    async updateByIds(collection, items) {
+        return this.wrapError('按 ID 差异化批量更新数据', async () => {
+            const validItems = items.filter((item) => item.id && Object.keys(item.data).length > 0);
+            const chunks = this.chunk(validItems, this.batchLimit);
+            let affected = 0;
+            for (const chunk of chunks) {
+                const results = await (0, p_map_1.default)(chunk, async (item) => {
+                    const res = (await this.col(collection).doc(item.id).update(item.data));
+                    return Number(res.updated ?? 0);
+                }, {
+                    concurrency: this.batchLimit,
+                    stopOnError: false,
+                });
+                affected += results.reduce((sum, cur) => sum + cur, 0);
+            }
+            return affected;
+        });
+    }
+    async removeMany(collection, where) {
+        return this.wrapError('批量删除数据', async () => {
+            const res = (await this.col(collection).where(where).remove());
+            return Number(res.deleted ?? 0);
+        });
+    }
+    async countTotal(collection, where = {}) {
+        return this.wrapError('统计数据总数', async () => {
+            const res = (await this.col(collection).where(where).count());
+            return Number(res.total ?? 0);
+        });
+    }
+    async findExistData(collection, ids, field = { _id: true }) {
+        return this.wrapError('查询存在数据', async () => {
+            const uniqueIds = this.unique(ids);
+            if (uniqueIds.length === 0) {
+                return [];
+            }
+            const chunks = this.chunk(uniqueIds, this.batchLimit);
+            const results = await (0, p_map_1.default)(chunks, async (idChunk) => {
+                const res = (await this.col(collection)
+                    .where({ _id: this.command.in(idChunk) })
+                    .field(field)
+                    .get());
+                return res.data ?? [];
+            }, {
+                concurrency: Math.min(chunks.length, this.batchLimit),
+                stopOnError: false,
+            });
+            return results.flat();
+        });
+    }
+    async isExistData(collection, ids, options = {}) {
+        return this.wrapError('判断数据是否存在', async () => {
+            const { allMustExist = false } = options;
+            const uniqueIds = this.unique(ids);
+            if (uniqueIds.length === 0) {
+                return false;
+            }
+            const { foundIds } = await this.findExistIds(collection, uniqueIds);
+            return allMustExist ? foundIds.length === uniqueIds.length : foundIds.length > 0;
+        });
+    }
+    async findExistIds(collection, ids) {
+        return this.wrapError('查询存在 ID', async () => {
+            const uniqueIds = this.unique(ids);
+            const existing = await this.findExistData(collection, uniqueIds, { _id: true });
+            const foundSet = new Set(existing
+                .map((item) => String(item._id ?? ''))
+                .filter((id) => id.length > 0));
+            const foundIds = uniqueIds.filter((id) => foundSet.has(id));
+            const missingIds = uniqueIds.filter((id) => !foundSet.has(id));
+            return { foundIds, missingIds };
+        });
+    }
+    col(collection) {
+        if (!collection || typeof collection !== 'string') {
+            throw new cloudbase_sdk_error_1.CloudbaseSdkError(cloudbase_sdk_error_1.CLOUDBASE_ERROR_CODE.INVALID_PARAM, '集合名称不能为空');
+        }
+        return this.db.collection(collection);
+    }
+    applySort(query, sort) {
+        let chained = query;
+        for (const [field, order] of Object.entries(sort)) {
+            const normalized = order === -1 || order === 'desc' ? 'desc' : 'asc';
+            chained = chained.orderBy(field, normalized);
+        }
+        return chained;
+    }
+    chunk(list, size) {
+        if (list.length === 0) {
+            return [];
+        }
+        const chunks = [];
+        for (let index = 0; index < list.length; index += size) {
+            chunks.push(list.slice(index, index + size));
+        }
+        return chunks;
+    }
+    unique(list) {
+        return [...new Set(list.filter((item) => typeof item === 'string' && item.length > 0))];
+    }
+    sanitizeBatchLimit(value) {
+        const parsed = Number(value);
+        if (!Number.isFinite(parsed) || parsed <= 0) {
+            return DEFAULT_BATCH_LIMIT;
+        }
+        return Math.floor(parsed);
+    }
+    extractCreatedIds(res) {
+        const fromArray = Array.isArray(res.ids)
+            ? res.ids
+            : Array.isArray(res.idList)
+                ? res.idList
+                : [];
+        const fromSingle = res.id ? [res.id] : [];
+        return [...fromSingle, ...fromArray]
+            .map((item) => String(item))
+            .filter((item) => item.length > 0);
+    }
+    async wrapError(actionName, handler) {
+        try {
+            return await handler();
+        }
+        catch (error) {
+            if (error instanceof cloudbase_sdk_error_1.CloudbaseSdkError) {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new cloudbase_sdk_error_1.CloudbaseSdkError(cloudbase_sdk_error_1.CLOUDBASE_ERROR_CODE.QUERY_FAILED, `${actionName}失败：${message}`);
+        }
+    }
+};
+exports.CloudbaseService = CloudbaseService;
+exports.CloudbaseService = CloudbaseService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.CLOUDBASE_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], CloudbaseService);
+//# sourceMappingURL=cloudbase.service.js.map

package/dist/cloudbase.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudbase.service.js","sourceRoot":"","sources":["../src/cloudbase.service.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const CLOUDBASE_MODULE_OPTIONS = "CLOUDBASE_MODULE_OPTIONS";

package/dist/constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLOUDBASE_MODULE_OPTIONS = void 0;
+exports.CLOUDBASE_MODULE_OPTIONS = 'CLOUDBASE_MODULE_OPTIONS';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,wBAAwB,GAAG,0BAA0B,CAAC"}

package/dist/errors/cloudbase-sdk.error.d.ts

@@ -0,0 +1,10 @@
+export declare const CLOUDBASE_ERROR_CODE: {
+    readonly INIT_FAILED: "CLOUDBASE_INIT_FAILED";
+    readonly QUERY_FAILED: "CLOUDBASE_QUERY_FAILED";
+    readonly INVALID_PARAM: "CLOUDBASE_INVALID_PARAM";
+};
+export type CloudbaseErrorCode = (typeof CLOUDBASE_ERROR_CODE)[keyof typeof CLOUDBASE_ERROR_CODE];
+export declare class CloudbaseSdkError extends Error {
+    readonly code: CloudbaseErrorCode;
+    constructor(code: CloudbaseErrorCode, message: string);
+}

package/dist/errors/cloudbase-sdk.error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudbaseSdkError = exports.CLOUDBASE_ERROR_CODE = void 0;
+exports.CLOUDBASE_ERROR_CODE = {
+    INIT_FAILED: 'CLOUDBASE_INIT_FAILED',
+    QUERY_FAILED: 'CLOUDBASE_QUERY_FAILED',
+    INVALID_PARAM: 'CLOUDBASE_INVALID_PARAM',
+};
+class CloudbaseSdkError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = 'CloudbaseSdkError';
+        this.code = code;
+    }
+}
+exports.CloudbaseSdkError = CloudbaseSdkError;
+//# sourceMappingURL=cloudbase-sdk.error.js.map

package/dist/errors/cloudbase-sdk.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudbase-sdk.error.js","sourceRoot":"","sources":["../../src/errors/cloudbase-sdk.error.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG;IAClC,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,aAAa,EAAE,yBAAyB;CAChC,CAAC;AAKX,MAAa,iBAAkB,SAAQ,KAAK;IAG1C,YAAY,IAAwB,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,8CAQC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cloudbase.repository';
+export * from './cloudbase.module';
+export * from './cloudbase.service';
+export * from './errors/cloudbase-sdk.error';
+export * from './interfaces/cloudbase-module-options.interface';
+export * from './interfaces/cloudbase-query.interface';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cloudbase.repository"), exports);
+__exportStar(require("./cloudbase.module"), exports);
+__exportStar(require("./cloudbase.service"), exports);
+__exportStar(require("./errors/cloudbase-sdk.error"), exports);
+__exportStar(require("./interfaces/cloudbase-module-options.interface"), exports);
+__exportStar(require("./interfaces/cloudbase-query.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,qDAAmC;AACnC,sDAAoC;AACpC,+DAA6C;AAC7C,kFAAgE;AAChE,yEAAuD"}

package/dist/interfaces/cloudbase-module-options.interface.d.ts

@@ -0,0 +1,17 @@
+import { ModuleMetadata } from '@nestjs/common';
+export interface CloudbaseModuleOptions {
+    env?: string;
+    accessKey?: string;
+    secretId?: string;
+    secretKey?: string;
+    sessionToken?: string;
+    context?: unknown;
+    timeout?: number;
+    proxy?: string;
+    version?: string;
+    batchLimit?: number;
+}
+export interface CloudbaseModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    inject?: any[];
+    useFactory: (...args: unknown[]) => Promise<CloudbaseModuleOptions> | CloudbaseModuleOptions;
+}

package/dist/interfaces/cloudbase-module-options.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cloudbase-module-options.interface.js.map

package/dist/interfaces/cloudbase-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudbase-module-options.interface.js","sourceRoot":"","sources":["../../src/interfaces/cloudbase-module-options.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/cloudbase-query.interface.d.ts

@@ -0,0 +1,27 @@
+export type SortOrder = 1 | -1 | 'asc' | 'desc';
+export interface FindManyParams {
+    currentPage?: number;
+    pageSize?: number;
+    where?: Record<string, unknown>;
+    sort?: Record<string, SortOrder>;
+    field?: Record<string, boolean | 0 | 1>;
+    withTotal?: boolean;
+}
+export interface FindManyResult<T> {
+    data: T[];
+    currentPage: number;
+    pageSize: number;
+    total?: number;
+}
+export interface DifferentialUpdateItem<T extends Record<string, unknown>> {
+    id: string;
+    data: Partial<T>;
+}
+export interface CreateDataResult {
+    id?: string;
+    ids: string[];
+    total: number;
+}
+export interface ExistDataOptions {
+    allMustExist?: boolean;
+}

package/dist/interfaces/cloudbase-query.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cloudbase-query.interface.js.map

package/dist/interfaces/cloudbase-query.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudbase-query.interface.js","sourceRoot":"","sources":["../../src/interfaces/cloudbase-query.interface.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@pixmason/nest-cloudbase-sdk",
+  "version": "0.1.0",
+  "description": "NestJS CloudBase module with dynamic initialization and CRUD helpers",
+  "license": "MIT",
+  "author": "PixMason",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0"
+  },
+  "dependencies": {
+    "@cloudbase/node-sdk": "^3.8.4",
+    "p-map": "^7.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.3"
+  }
+}