openxiangda-nest 2.0.0-alpha.39 → 2.0.0-alpha.40

package/README.md

@@ -4,6 +4,21 @@ NestJS integration for platform-gateway requests. The global transport guard ver
 
 Ordinary CRUD remains in the platform Data API. Use NestJS only for real business actions, and keep the platform as the authoritative identity and authorization owner.
 
+Start application backends with the canonical bootstrap so gateway signatures
+are verified against the exact incoming request bytes:
+
+```ts
+import 'reflect-metadata';
+import { bootstrapOpenXiangdaApplication } from 'openxiangda-nest';
+import { AppModule } from './app.module.js';
+
+await bootstrapOpenXiangdaApplication(AppModule);
+```
+
+Do not create a separate `NestFactory` or `FastifyAdapter` in application code.
+The standard bootstrap owns raw-body capture, proxy trust, shutdown hooks, and
+the runtime listen contract.
+
 `OpenXiangdaStandardOperations` provides the default transaction patterns for
 meeting interval overlap, course capacity/duplicate selection, and visitor
 duplicate reservation checks. Each pattern queries through the verified request

package/dist/bootstrap.d.ts

@@ -0,0 +1,15 @@
+import type { Type } from '@nestjs/common';
+import { type NestFastifyApplication } from '@nestjs/platform-fastify';
+export interface OpenXiangdaApplicationBootstrapOptions {
+    port?: number;
+    host?: string;
+    trustProxy?: boolean;
+}
+/**
+ * Starts the canonical OpenXiangda 2.0 NestJS runtime.
+ *
+ * Raw body capture is part of the gateway assertion contract, so applications
+ * must not reproduce the NestFactory/Fastify setup themselves.
+ */
+export declare function bootstrapOpenXiangdaApplication(rootModule: Type<unknown>, options?: OpenXiangdaApplicationBootstrapOptions): Promise<NestFastifyApplication>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,sCAAsC;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,EACzB,OAAO,GAAE,sCAA2C,GACnD,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/bootstrap.js

@@ -0,0 +1,19 @@
+import { NestFactory } from '@nestjs/core';
+import { FastifyAdapter, } from '@nestjs/platform-fastify';
+/**
+ * Starts the canonical OpenXiangda 2.0 NestJS runtime.
+ *
+ * Raw body capture is part of the gateway assertion contract, so applications
+ * must not reproduce the NestFactory/Fastify setup themselves.
+ */
+export async function bootstrapOpenXiangdaApplication(rootModule, options = {}) {
+    const app = await NestFactory.create(rootModule, new FastifyAdapter({ trustProxy: options.trustProxy ?? true }), { rawBody: true });
+    app.enableShutdownHooks();
+    const production = process.env.NODE_ENV === 'production';
+    const port = options.port ??
+        Number(process.env.OPENXIANGDA_APP_PORT || process.env.PORT || 3000);
+    const host = options.host ?? (production ? '0.0.0.0' : '127.0.0.1');
+    await app.listen(port, host);
+    return app;
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,cAAc,GAEf,MAAM,0BAA0B,CAAC;AAQlC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,UAAyB,EACzB,UAAkD,EAAE;IAEpD,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,CAClC,UAAU,EACV,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC,EAC9D,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;IACF,GAAG,CAAC,mBAAmB,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IACzD,MAAM,IAAI,GACR,OAAO,CAAC,IAAI;QACZ,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './authz.js';
+export * from './bootstrap.js';
 export * from './assignee-provider.js';
 export * from './application-credentials.js';
 export * from './data-api.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './authz.js';
+export * from './bootstrap.js';
 export * from './assignee-provider.js';
 export * from './application-credentials.js';
 export * from './data-api.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-nest",
-  "version": "2.0.0-alpha.39",
+  "version": "2.0.0-alpha.40",
   "description": "Official NestJS application backend SDK for OpenXiangda 2.0.",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,12 +22,14 @@
   "peerDependencies": {
     "@nestjs/common": ">=11 <12",
     "@nestjs/core": ">=11 <12",
+    "@nestjs/platform-fastify": ">=11 <12",
     "reflect-metadata": ">=0.2 <1",
     "rxjs": ">=7 <8"
   },
   "devDependencies": {
     "@nestjs/common": "11.1.29",
     "@nestjs/core": "11.1.29",
+    "@nestjs/platform-fastify": "11.1.29",
     "reflect-metadata": "0.2.2",
     "rxjs": "7.8.2"
   },