@mikara89/cap-storage-prisma 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -1,6 +1,22 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [2.2.1](https://github.com/mikara89/cap-nodejs/compare/@mikara89/cap-storage-prisma@2.2.0...@mikara89/cap-storage-prisma@2.2.1) (2026-07-11)
+
+### Bug Fixes
+
+- **release:** prevent release-tooling subprocess hang ([0f5790f](https://github.com/mikara89/cap-nodejs/commit/0f5790f243ea35c37a95e02e86b5bfaa6400df45))
+- **release:** restore Lerna release authority ([044f165](https://github.com/mikara89/cap-nodejs/commit/044f1658247a8ba6efb4870ca1c76610138a948e))
+
+### Reverts
+
+- Revert "chore(release): prepare 2.3.0" ([de35e0e](https://github.com/mikara89/cap-nodejs/commit/de35e0ef6bec2f4aa6b94092298908be91186c11))
+
 # Changelog
 
-## 2.3.0
+## 2.2.0 (2026-06-27)
 
 - Release the framework-free Prisma outbox and inbox adapter as a current
   first-party storage option.
@@ -11,9 +27,3 @@
 - Cover PostgreSQL and MySQL claim behavior with DB integration tests; keep
   SQLite as a local and single-process option.
 - Keep shared SQL-core extraction deferred.
-
-## 2.2.0
-
-- Add the framework-free Prisma publish and received storage adapter.
-- Add raw-SQL schema initialization for PostgreSQL, MySQL/MariaDB, and SQLite.
-- Add interactive transaction support through `Prisma.TransactionClient`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CAP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,6 +13,16 @@ Prisma providers `postgresql`, `mysql`, and `sqlite`; `postgres` and `mariadb`
 are accepted adapter aliases. Pass the provider explicitly because Prisma does
 not expose a stable public runtime provider API for adapter logic.
 
+For the optional NestJS entry point, install the Nest peer dependencies used by
+your application:
+
+```sh
+npm install @nestjs/common @nestjs/core reflect-metadata
+```
+
+Those dependencies are optional when using only the framework-neutral root
+API.
+
 ## Schema
 
 Initialize CAP tables through raw SQL without adding CAP models to your Prisma
@@ -57,6 +67,125 @@ values. It does not use generated model delegates or require CAP models in the
 application schema. Table names are the only dynamic identifiers and are
 strictly validated before quoting.
 
+### NestJS
+
+The root import remains framework-neutral. Import Nest integration from the
+explicit `@mikara89/cap-storage-prisma/nest` subpath; it exports
+`PrismaStorageModule`, its `Options`/`AsyncOptions`/`OptionsFactory` types,
+and the existing CAP `PUBLISH_STORAGE` and `RECEIVED_STORAGE` tokens.
+
+The module binds `PrismaPublishStorage` and `PrismaReceivedStorage` to those
+CAP tokens. It uses the injected application client and does not call
+`$connect()` or `$disconnect()`: connection lifecycle remains application-owned.
+
+Provide a direct application client under any token you choose. There is no
+assumption about a provider called `PrismaService` or a particular Prisma Nest
+library:
+
+```ts
+import { Module } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+import { PrismaStorageModule } from '@mikara89/cap-storage-prisma/nest';
+
+export const APP_DATABASE = Symbol('APP_DATABASE');
+const prisma = new PrismaClient();
+
+@Module({
+  providers: [{ provide: APP_DATABASE, useValue: prisma }],
+  exports: [APP_DATABASE],
+})
+export class DatabaseModule {}
+
+@Module({
+  imports: [
+    PrismaStorageModule.forRoot({
+      imports: [DatabaseModule],
+      clientToken: APP_DATABASE,
+      storageOptions: { provider: 'postgresql' },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+An application-defined `PrismaService` works when it is exported under your
+chosen token; CAP does not require a particular implementation:
+
+```ts
+import { Injectable, Module } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+@Injectable()
+export class PrismaService extends PrismaClient {}
+
+@Module({
+  providers: [
+    PrismaService,
+    { provide: APP_DATABASE, useExisting: PrismaService },
+  ],
+  exports: [APP_DATABASE],
+})
+export class DatabaseModule {}
+```
+
+Use `forRootAsync` for application-provided storage options:
+
+```ts
+import { Module } from '@nestjs/common';
+import type { PrismaStorageOptions } from '@mikara89/cap-storage-prisma';
+import { PrismaStorageModule } from '@mikara89/cap-storage-prisma/nest';
+
+export const STORAGE_OPTIONS = Symbol('STORAGE_OPTIONS');
+
+@Module({
+  providers: [
+    { provide: STORAGE_OPTIONS, useValue: { provider: 'postgresql' } },
+  ],
+  exports: [STORAGE_OPTIONS],
+})
+class StorageConfigModule {}
+
+PrismaStorageModule.forRootAsync({
+  imports: [DatabaseModule, StorageConfigModule],
+  clientToken: APP_DATABASE,
+  inject: [STORAGE_OPTIONS],
+  useFactory: (options: PrismaStorageOptions) => options,
+});
+```
+
+The class and existing-provider variants call exactly
+`createPrismaStorageOptions()`:
+
+```ts
+import { Injectable, Module } from '@nestjs/common';
+import {
+  PrismaStorageModule,
+  type PrismaStorageOptionsFactory,
+} from '@mikara89/cap-storage-prisma/nest';
+
+@Injectable()
+class PrismaOptionsFactory implements PrismaStorageOptionsFactory {
+  createPrismaStorageOptions() {
+    return { provider: 'postgresql' as const };
+  }
+}
+
+@Module({ providers: [PrismaOptionsFactory], exports: [PrismaOptionsFactory] })
+class ExistingConfigModule {}
+
+PrismaStorageModule.forRootAsync({
+  imports: [DatabaseModule],
+  clientToken: APP_DATABASE,
+  useClass: PrismaOptionsFactory,
+});
+
+PrismaStorageModule.forRootAsync({
+  imports: [DatabaseModule, ExistingConfigModule],
+  clientToken: APP_DATABASE,
+  useExisting: PrismaOptionsFactory,
+});
+```
+
 ## Transactions
 
 The transaction context is `Prisma.TransactionClient`. Root operations use the

package/dist/nest/index.d.ts

@@ -0,0 +1,3 @@
+export * from './prisma-storage.module';
+export * from './tokens';
+//# sourceMappingURL=index.d.ts.map

package/dist/nest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nest/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC"}

package/dist/nest/index.js

@@ -0,0 +1,19 @@
+"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("./prisma-storage.module"), exports);
+__exportStar(require("./tokens"), exports);
+//# sourceMappingURL=index.js.map

package/dist/nest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nest/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,2CAAyB"}

package/dist/nest/prisma-storage.module.d.ts

@@ -0,0 +1,23 @@
+import { DynamicModule } from '@nestjs/common';
+import type { InjectionToken, ModuleMetadata, OptionalFactoryDependency, Type } from '@nestjs/common';
+import type { PrismaStorageOptions } from '../prisma-storage-options';
+export interface PrismaStorageModuleOptions {
+    clientToken: InjectionToken;
+    imports?: ModuleMetadata['imports'];
+    storageOptions: PrismaStorageOptions;
+}
+export interface PrismaStorageOptionsFactory {
+    createPrismaStorageOptions(): Promise<PrismaStorageOptions> | PrismaStorageOptions;
+}
+export interface PrismaStorageModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    clientToken: InjectionToken;
+    useExisting?: Type<PrismaStorageOptionsFactory>;
+    useClass?: Type<PrismaStorageOptionsFactory>;
+    useFactory?: (...args: unknown[]) => Promise<PrismaStorageOptions> | PrismaStorageOptions;
+    inject?: (InjectionToken | OptionalFactoryDependency)[];
+}
+export declare class PrismaStorageModule {
+    static forRoot(options: PrismaStorageModuleOptions): DynamicModule;
+    static forRootAsync(options: PrismaStorageModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=prisma-storage.module.d.ts.map

package/dist/nest/prisma-storage.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-storage.module.d.ts","sourceRoot":"","sources":["../../src/nest/prisma-storage.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,yBAAyB,EAEzB,IAAI,EACL,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAItE,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACpC,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,0BAA0B,IACtB,OAAO,CAAC,oBAAoB,CAAC,GAC7B,oBAAoB,CAAC;CAC1B;AAED,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAC3D,cAAc,EACd,SAAS,CACV;IACC,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,CACX,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,cAAc,GAAG,yBAAyB,CAAC,EAAE,CAAC;CACzD;AAGD,qBACa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa;IAOlE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,+BAA+B,GAAG,aAAa;CAQ7E"}

package/dist/nest/prisma-storage.module.js

@@ -0,0 +1,69 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaStorageModule = void 0;
+const common_1 = require("@nestjs/common");
+const cap_core_1 = require("@mikara89/cap-core");
+const prisma_publish_storage_1 = require("../prisma-publish-storage");
+const prisma_received_storage_1 = require("../prisma-received-storage");
+const PRISMA_STORAGE_OPTIONS = Symbol('CAP_PRISMA_STORAGE_OPTIONS');
+let PrismaStorageModule = class PrismaStorageModule {
+    static forRoot(options) {
+        return createModule(options.clientToken, options.imports ?? [], {
+            provide: PRISMA_STORAGE_OPTIONS,
+            useValue: options.storageOptions,
+        });
+    }
+    static forRootAsync(options) {
+        return createModule(options.clientToken, options.imports ?? [], createAsyncOptionsProvider(options), options.useClass && !options.useExisting ? [options.useClass] : []);
+    }
+};
+exports.PrismaStorageModule = PrismaStorageModule;
+exports.PrismaStorageModule = PrismaStorageModule = __decorate([
+    (0, common_1.Module)({})
+], PrismaStorageModule);
+function createModule(clientToken, imports, optionsProvider, extraProviders = []) {
+    return {
+        module: PrismaStorageModule,
+        imports,
+        providers: [
+            ...extraProviders,
+            optionsProvider,
+            {
+                provide: cap_core_1.PUBLISH_STORAGE,
+                useFactory: (client, options) => new prisma_publish_storage_1.PrismaPublishStorage(client, options),
+                inject: [clientToken, PRISMA_STORAGE_OPTIONS],
+            },
+            {
+                provide: cap_core_1.RECEIVED_STORAGE,
+                useFactory: (client, options) => new prisma_received_storage_1.PrismaReceivedStorage(client, options),
+                inject: [clientToken, PRISMA_STORAGE_OPTIONS],
+            },
+        ],
+        exports: [cap_core_1.PUBLISH_STORAGE, cap_core_1.RECEIVED_STORAGE],
+    };
+}
+function createAsyncOptionsProvider(options) {
+    if (options.useFactory) {
+        return {
+            provide: PRISMA_STORAGE_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject ?? [],
+        };
+    }
+    const factoryToken = options.useExisting ?? options.useClass;
+    if (!factoryToken) {
+        throw new Error('Invalid PrismaStorageModuleAsyncOptions: must provide useFactory, useExisting, or useClass');
+    }
+    return {
+        provide: PRISMA_STORAGE_OPTIONS,
+        useFactory: (factory) => factory.createPrismaStorageOptions(),
+        inject: [factoryToken],
+    };
+}
+//# sourceMappingURL=prisma-storage.module.js.map

package/dist/nest/prisma-storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-storage.module.js","sourceRoot":"","sources":["../../src/nest/prisma-storage.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAuD;AAQvD,iDAAuE;AAEvE,sEAAiE;AACjE,wEAAmE;AAGnE,MAAM,sBAAsB,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AA6B7D,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAmC;QAChD,OAAO,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE;YAC9D,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE,OAAO,CAAC,cAAc;SACjC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAwC;QAC1D,OAAO,YAAY,CACjB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,OAAO,IAAI,EAAE,EACrB,0BAA0B,CAAC,OAAO,CAAC,EACnC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;CACF,CAAA;AAhBY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CAgB/B;AAED,SAAS,YAAY,CACnB,WAA2B,EAC3B,OAA+C,EAC/C,eAAyB,EACzB,iBAA6B,EAAE;IAE/B,OAAO;QACL,MAAM,EAAE,mBAAmB;QAC3B,OAAO;QACP,SAAS,EAAE;YACT,GAAG,cAAc;YACjB,eAAe;YACf;gBACE,OAAO,EAAE,0BAAe;gBACxB,UAAU,EAAE,CAAC,MAAuB,EAAE,OAA6B,EAAE,EAAE,CACrE,IAAI,6CAAoB,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC3C,MAAM,EAAE,CAAC,WAAW,EAAE,sBAAsB,CAAC;aAC9C;YACD;gBACE,OAAO,EAAE,2BAAgB;gBACzB,UAAU,EAAE,CAAC,MAAuB,EAAE,OAA6B,EAAE,EAAE,CACrE,IAAI,+CAAqB,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC5C,MAAM,EAAE,CAAC,WAAW,EAAE,sBAAsB,CAAC;aAC9C;SACF;QACD,OAAO,EAAE,CAAC,0BAAe,EAAE,2BAAgB,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,OAAwC;IAExC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,sBAAsB;YAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAC7D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,sBAAsB;QAC/B,UAAU,EAAE,CAAC,OAAoC,EAAE,EAAE,CACnD,OAAO,CAAC,0BAA0B,EAAE;QACtC,MAAM,EAAE,CAAC,YAAY,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/nest/tokens.d.ts

@@ -0,0 +1,2 @@
+export { PUBLISH_STORAGE, RECEIVED_STORAGE } from '@mikara89/cap-core';
+//# sourceMappingURL=tokens.d.ts.map

package/dist/nest/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/nest/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/nest/tokens.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECEIVED_STORAGE = exports.PUBLISH_STORAGE = void 0;
+var cap_core_1 = require("@mikara89/cap-core");
+Object.defineProperty(exports, "PUBLISH_STORAGE", { enumerable: true, get: function () { return cap_core_1.PUBLISH_STORAGE; } });
+Object.defineProperty(exports, "RECEIVED_STORAGE", { enumerable: true, get: function () { return cap_core_1.RECEIVED_STORAGE; } });
+//# sourceMappingURL=tokens.js.map

package/dist/nest/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/nest/tokens.ts"],"names":[],"mappings":";;;AAAA,+CAAuE;AAA9D,2GAAA,eAAe,OAAA;AAAE,4GAAA,gBAAgB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikara89/cap-storage-prisma",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Prisma storage adapter for CAP",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,13 +32,16 @@
     "test": "npm run generate:test-clients && jest",
     "lint": "eslint \"src/**/*.ts\" --fix"
   },
+  "dependencies": {
+    "@mikara89/cap-core": "^2.2.0"
+  },
   "peerDependencies": {
-    "@mikara89/cap-core": "^2.2.0",
-    "@prisma/client": "^6.0.0"
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@prisma/client": "^6.0.0",
+    "reflect-metadata": "^0.2.0"
   },
   "devDependencies": {
-    "@mikara89/cap-core": "file:../cap-core",
-    "@mikara89/cap-testing": "file:../cap-testing",
     "@prisma/client": "^6.0.0",
     "@types/node": "^22.0.0",
     "prisma": "^6.0.0",
@@ -50,6 +53,25 @@
       "require": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./nest": {
+      "types": "./dist/nest/index.d.ts",
+      "require": "./dist/nest/index.js",
+      "default": "./dist/nest/index.js"
+    },
+    "./nest/*": {
+      "types": "./dist/nest/*.d.ts",
+      "require": "./dist/nest/*.js",
+      "default": "./dist/nest/*.js"
+    },
     "./package.json": "./package.json"
-  }
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    }
+  },
+  "gitHead": "603680434b5fd3bec561f400b825ad21a87b1f21"
 }