@zenstackhq/server 2.0.0-beta.3 → 2.0.0-beta.4

package/README.md

@@ -1,5 +1,5 @@
-# ZenStack Fastify Plugin Library
+# ZenStack Server Adapters
 
-This package provides a Fastify plugin for ZenStack.
+This package provides adapters and utilities for integrating with popular Node.js servers, including Express, Fastify, and Nest.js.
 
 Visit [Homepage](https://zenstack.dev) for more details.

package/nestjs/index.d.ts

@@ -0,0 +1 @@
+export * from './zenstack.module';

package/nestjs/index.js

@@ -0,0 +1,18 @@
+"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("./zenstack.module"), exports);
+//# sourceMappingURL=index.js.map

package/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/nestjs/zenstack.module.d.ts

@@ -0,0 +1,49 @@
+import { type DynamicModule, type FactoryProvider, type ModuleMetadata, type Provider } from '@nestjs/common';
+/**
+ * The default token used to export the enhanced Prisma service.
+ */
+export declare const ENHANCED_PRISMA = "ENHANCED_PRISMA";
+/**
+ * ZenStack module options.
+ */
+export interface ZenStackModuleOptions {
+    /**
+     * A callback for getting an enhanced `PrismaClient`.
+     */
+    getEnhancedPrisma: () => unknown;
+}
+/**
+ * ZenStack module async registration options.
+ */
+export interface ZenStackModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /**
+     * Whether the module is global-scoped.
+     */
+    global?: boolean;
+    /**
+     * The token to export the enhanced Prisma service. Default is {@link ENHANCED_PRISMA}.
+     */
+    exportToken?: string;
+    /**
+     * The factory function to create the enhancement options.
+     */
+    useFactory: (...args: unknown[]) => Promise<ZenStackModuleOptions> | ZenStackModuleOptions;
+    /**
+     * The dependencies to inject into the factory function.
+     */
+    inject?: FactoryProvider['inject'];
+    /**
+     * Extra providers to facilitate dependency injection.
+     */
+    extraProviders?: Provider[];
+}
+/**
+ * The ZenStack module for NestJS. The module exports an enhanced Prisma service,
+ * by default with token {@link ENHANCED_PRISMA}.
+ */
+export declare class ZenStackModule {
+    /**
+     * Registers the ZenStack module with the specified options.
+     */
+    static registerAsync(options: ZenStackModuleAsyncOptions): DynamicModule;
+}

package/nestjs/zenstack.module.js

@@ -0,0 +1,74 @@
+"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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var ZenStackModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZenStackModule = exports.ENHANCED_PRISMA = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * The default token used to export the enhanced Prisma service.
+ */
+exports.ENHANCED_PRISMA = 'ENHANCED_PRISMA';
+/**
+ * The ZenStack module for NestJS. The module exports an enhanced Prisma service,
+ * by default with token {@link ENHANCED_PRISMA}.
+ */
+let ZenStackModule = ZenStackModule_1 = class ZenStackModule {
+    /**
+     * Registers the ZenStack module with the specified options.
+     */
+    static registerAsync(options) {
+        var _a, _b, _c;
+        return {
+            module: ZenStackModule_1,
+            global: options === null || options === void 0 ? void 0 : options.global,
+            imports: options.imports,
+            providers: [
+                {
+                    provide: (_a = options.exportToken) !== null && _a !== void 0 ? _a : exports.ENHANCED_PRISMA,
+                    useFactory: (
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    ...args) => __awaiter(this, void 0, void 0, function* () {
+                        const { getEnhancedPrisma } = yield options.useFactory(...args);
+                        if (!getEnhancedPrisma) {
+                            throw new Error('`getEnhancedPrisma` must be provided in the options');
+                        }
+                        // create a proxy to intercept all calls to the Prisma service and forward
+                        // to the enhanced version
+                        return new Proxy({}, {
+                            get(_target, prop) {
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                const enhancedPrisma = getEnhancedPrisma();
+                                if (!enhancedPrisma) {
+                                    throw new Error('`getEnhancedPrisma` must return a valid Prisma client');
+                                }
+                                return enhancedPrisma[prop];
+                            },
+                        });
+                    }),
+                    inject: options.inject,
+                },
+                ...((_b = options.extraProviders) !== null && _b !== void 0 ? _b : []),
+            ],
+            exports: [(_c = options.exportToken) !== null && _c !== void 0 ? _c : exports.ENHANCED_PRISMA],
+        };
+    }
+};
+exports.ZenStackModule = ZenStackModule;
+exports.ZenStackModule = ZenStackModule = ZenStackModule_1 = __decorate([
+    (0, common_1.Module)({})
+], ZenStackModule);
+//# sourceMappingURL=zenstack.module.js.map

package/nestjs/zenstack.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zenstack.module.js","sourceRoot":"","sources":["../../src/nestjs/zenstack.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,2CAAsH;AAEtH;;GAEG;AACU,QAAA,eAAe,GAAG,iBAAiB,CAAC;AA0CjD;;;GAGG;AAEI,IAAM,cAAc,sBAApB,MAAM,cAAc;IACvB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAmC;;QACpD,OAAO;YACH,MAAM,EAAE,gBAAc;YACtB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE;gBACP;oBACI,OAAO,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,uBAAe;oBAC/C,UAAU,EAAE;oBACR,8DAA8D;oBAC9D,GAAG,IAAe,EACpB,EAAE;wBACA,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;wBAChE,IAAI,CAAC,iBAAiB,EAAE,CAAC;4BACrB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;wBAC3E,CAAC;wBAED,0EAA0E;wBAC1E,0BAA0B;wBAE1B,OAAO,IAAI,KAAK,CACZ,EAAE,EACF;4BACI,GAAG,CAAC,OAAO,EAAE,IAAI;gCACb,8DAA8D;gCAC9D,MAAM,cAAc,GAAQ,iBAAiB,EAAE,CAAC;gCAChD,IAAI,CAAC,cAAc,EAAE,CAAC;oCAClB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;gCAC7E,CAAC;gCACD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;4BAChC,CAAC;yBACJ,CACJ,CAAC;oBACN,CAAC,CAAA;oBACD,MAAM,EAAE,OAAO,CAAC,MAAM;iBACzB;gBACD,GAAG,CAAC,MAAA,OAAO,CAAC,cAAc,mCAAI,EAAE,CAAC;aACpC;YACD,OAAO,EAAE,CAAC,MAAA,OAAO,CAAC,WAAW,mCAAI,uBAAe,CAAC;SACpD,CAAC;IACN,CAAC;CACJ,CAAA;AA7CY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CA6C1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenstackhq/server",
-  "version": "2.0.0-beta.3",
+  "version": "2.0.0-beta.4",
   "displayName": "ZenStack Server-side Adapters",
   "description": "ZenStack server-side adapters",
   "homepage": "https://zenstack.dev",
@@ -27,9 +27,11 @@
     "url-pattern": "^1.0.3",
     "zod": "^3.22.4",
     "zod-validation-error": "^1.5.0",
-    "@zenstackhq/runtime": "2.0.0-beta.3"
+    "@zenstackhq/runtime": "2.0.0-beta.4"
   },
   "devDependencies": {
+    "@nestjs/platform-express": "^10.3.5",
+    "@nestjs/testing": "^10.3.5",
     "@sveltejs/kit": "1.21.0",
     "@types/body-parser": "^1.19.2",
     "@types/express": "^4.17.17",
@@ -44,7 +46,8 @@
     "next": "^13.4.5",
     "nuxt": "^3.7.4",
     "supertest": "^6.3.3",
-    "@zenstackhq/testtools": "2.0.0-beta.3"
+    "@nestjs/common": "^10.0.0",
+    "@zenstackhq/testtools": "2.0.0-beta.4"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -57,6 +60,7 @@
     "./next/pages-route-handler": "./next/pages-route-handler.js",
     "./sveltekit": "./sveltekit/index.js",
     "./nuxt": "./nuxt/index.js",
+    "./nestjs": "./nestjs/index.js",
     "./types": "./types.js"
   },
   "scripts": {