@martel/calyx 1.8.0 → 1.10.0

package/bun.lock

@@ -12,6 +12,7 @@
         "@nestjs/common": "^11.1.27",
         "@nestjs/core": "^11.1.27",
         "@nestjs/platform-express": "^11.1.27",
+        "@nestjs/swagger": "^11.4.5",
         "@semantic-release/changelog": "^6.0.3",
         "@semantic-release/git": "^10.0.1",
         "@semantic-release/github": "^12.0.0",
@@ -45,14 +46,20 @@
 
     "@lukeed/csprng": ["@lukeed/csprng@1.1.0", "", {}, "sha512-Z7C/xXCiGWsg0KuKsHTKJxbWhpI3Vs5GwLfOean7MGyVFGqdRgBbAjOCh6u4bbjPc/8MJ2pZmK/0DLdCbivLDA=="],
 
+    "@microsoft/tsdoc": ["@microsoft/tsdoc@0.16.0", "", {}, "sha512-xgAyonlVVS+q7Vc7qLW0UrJU7rSFcETRWsqdXZtjzRU8dF+6CkozTK4V4y1LwOX7j8r/vHphjDeMeGI4tNGeGA=="],
+
     "@minimistjs/subarg": ["@minimistjs/subarg@1.0.0", "", { "dependencies": { "minimist": "^1.1.0" } }, "sha512-Q/ONBiM2zNeYUy0mVSO44mWWKYM3UHuEK43PKIOzJCbvUnPoMH1K+gk3cf1kgnCVJFlWmddahQQCmrmBGlk9jQ=="],
 
     "@nestjs/common": ["@nestjs/common@11.1.27", "", { "dependencies": { "file-type": "21.3.4", "iterare": "1.2.1", "load-esm": "1.0.3", "tslib": "2.8.1", "uid": "2.0.2" }, "peerDependencies": { "class-transformer": ">=0.4.1", "class-validator": ">=0.13.2", "reflect-metadata": "^0.1.12 || ^0.2.0", "rxjs": "^7.1.0" }, "optionalPeers": ["class-transformer", "class-validator"] }, "sha512-kEGSzqM2lWr4whh4Ubflw+oPZSEzxvRMu9WL+LveZploJWTjec5bBlCiRVlVzTPg2kIwBiLwWSvCCW7Wnin1gg=="],
 
     "@nestjs/core": ["@nestjs/core@11.1.27", "", { "dependencies": { "fast-safe-stringify": "2.1.1", "iterare": "1.2.1", "path-to-regexp": "8.4.2", "tslib": "2.8.1", "uid": "2.0.2" }, "peerDependencies": { "@nestjs/common": "^11.0.0", "@nestjs/microservices": "^11.0.0", "@nestjs/platform-express": "^11.0.0", "@nestjs/websockets": "^11.0.0", "reflect-metadata": "^0.1.12 || ^0.2.0", "rxjs": "^7.1.0" }, "optionalPeers": ["@nestjs/microservices", "@nestjs/platform-express", "@nestjs/websockets"] }, "sha512-K6DX7hcqmZdeXkv7tsPakKBRCgqL19a4mtbX4FluY0hWtFdtPKp6lbe+lb8gWPfvLdbOWr/CPScn7BSjBX+Ecg=="],
 
+    "@nestjs/mapped-types": ["@nestjs/mapped-types@2.1.1", "", { "peerDependencies": { "@nestjs/common": "^10.0.0 || ^11.0.0", "class-transformer": "^0.4.0 || ^0.5.0", "class-validator": "^0.13.0 || ^0.14.0 || ^0.15.0", "reflect-metadata": "^0.1.12 || ^0.2.0" }, "optionalPeers": ["class-transformer", "class-validator"] }, "sha512-SCCoMEJ6jdeI5h/N+KCVF1+pmg/hmEkNA5nHTS8Gvww7T/LCl4o1gFLinw2iQ60w7slFkszHcGLKGdazVI4F8A=="],
+
     "@nestjs/platform-express": ["@nestjs/platform-express@11.1.27", "", { "dependencies": { "cors": "2.8.6", "express": "5.2.1", "multer": "2.1.1", "path-to-regexp": "8.4.2", "tslib": "2.8.1" }, "peerDependencies": { "@nestjs/common": "^11.0.0", "@nestjs/core": "^11.0.0" } }, "sha512-0ZFhz6H6EdGh4xQVbUNwjoAwBuz73P7FvUAl67h9CTdMqQlJDaQYJApBv8pKfVZ1fGjMCbl0m9DcC6pXaZPWSQ=="],
 
+    "@nestjs/swagger": ["@nestjs/swagger@11.4.5", "", { "dependencies": { "@microsoft/tsdoc": "0.16.0", "@nestjs/mapped-types": "2.1.1", "js-yaml": "4.3.0", "lodash": "4.18.1", "path-to-regexp": "8.4.2", "swagger-ui-dist": "5.32.8" }, "peerDependencies": { "@fastify/static": "^8.0.0 || ^9.0.0", "@nestjs/common": "^11.0.1", "@nestjs/core": "^11.0.1", "class-transformer": "*", "class-validator": "*", "reflect-metadata": "^0.1.12 || ^0.2.0" }, "optionalPeers": ["@fastify/static", "class-transformer", "class-validator"] }, "sha512-lvndlJmWBVDOUT0uEtLi6sSpW1syK2/nbAlHBhiELBORMpJGe9+EiWAT9qHtB10jW91L2Jmlwkr0/lttsYZrig=="],
+
     "@octokit/auth-token": ["@octokit/auth-token@6.0.0", "", {}, "sha512-P4YJBPdPSpWTQ1NU4XYdvHvXJJDxM6YwpS0FZHRgP7YFkdVxsWcpWGy/NVqlAA7PcPCnMacXlRm1y2PFZRWL/w=="],
 
     "@octokit/core": ["@octokit/core@7.0.6", "", { "dependencies": { "@octokit/auth-token": "^6.0.0", "@octokit/graphql": "^9.0.3", "@octokit/request": "^10.0.6", "@octokit/request-error": "^7.0.2", "@octokit/types": "^16.0.0", "before-after-hook": "^4.0.0", "universal-user-agent": "^7.0.0" } }, "sha512-DhGl4xMVFGVIyMwswXeyzdL4uXD5OGILGX5N8Y+f6W7LhC1Ze2poSNrkF/fedpVDHEEZ+PHFW0vL14I+mm8K3Q=="],
@@ -81,6 +88,8 @@
 
     "@pnpm/npm-conf": ["@pnpm/npm-conf@3.0.3", "", { "dependencies": { "@pnpm/config.env-replace": "^1.1.0", "@pnpm/network.ca-file": "^1.0.1", "config-chain": "^1.1.11" } }, "sha512-//0sR/cow/s4ICQaYoAobOl4aU8cjU6x/V24V7XkKotb9+O+3zySIYp146vpaobYHnxa4pZX8NkV54Z5AwbDKA=="],
 
+    "@scarf/scarf": ["@scarf/scarf@1.4.0", "", {}, "sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ=="],
+
     "@sec-ant/readable-stream": ["@sec-ant/readable-stream@0.4.1", "", {}, "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg=="],
 
     "@semantic-release/changelog": ["@semantic-release/changelog@6.0.3", "", { "dependencies": { "@semantic-release/error": "^3.0.0", "aggregate-error": "^3.0.0", "fs-extra": "^11.0.0", "lodash": "^4.17.4" }, "peerDependencies": { "semantic-release": ">=18.0.0" } }, "sha512-dZuR5qByyfe3Y03TpmCvAxCyTnp7r5XwtHRf/8vD9EAn4ZWbavUX8adMtXYzE86EVh0gyLA7lm5yW4IV30XUag=="],
@@ -677,6 +686,8 @@
 
     "supports-hyperlinks": ["supports-hyperlinks@3.2.0", "", { "dependencies": { "has-flag": "^4.0.0", "supports-color": "^7.0.0" } }, "sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig=="],
 
+    "swagger-ui-dist": ["swagger-ui-dist@5.32.8", "", { "dependencies": { "@scarf/scarf": "=1.4.0" } }, "sha512-dgMdWXIgnI4zX4OPhKEdWnlDODbgm8W3AX0Ivn/BBqcUh6xZsBxhZMnvk6DJyRz1BTrj8dPxtarmEGgkz30oyA=="],
+
     "tagged-tag": ["tagged-tag@1.0.0", "", {}, "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng=="],
 
     "temp-dir": ["temp-dir@3.0.0", "", {}, "sha512-nHc6S/bwIilKHNRgK/3jlhDoIHcp45YgyiwcAk46Tr0LfEqGBVpmiAyuiuxeVE44m3mXnEeVhaipLOEWmH+Njw=="],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@martel/calyx",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "High-performance Bun-native NestJS-compatible framework",
   "main": "src/index.ts",
   "bin": {
@@ -19,15 +19,16 @@
     "@nestjs/common": "^11.1.27",
     "@nestjs/core": "^11.1.27",
     "@nestjs/platform-express": "^11.1.27",
+    "@nestjs/swagger": "^11.4.5",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.0",
+    "@semantic-release/npm": "^13.0.0",
     "@types/autocannon": "^7.12.7",
     "@types/bun": "latest",
     "autocannon": "^8.0.0",
     "rxjs": "^7.8.2",
-    "semantic-release": "^25.0.0",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.0",
-    "@semantic-release/npm": "^13.0.0"
+    "semantic-release": "^25.0.0"
   },
   "publishConfig": {
     "access": "public",

package/src/cli/index.ts

@@ -85,7 +85,20 @@ function runBuild(cmdArgs: string[]) {
   }
 
   console.log('Building Calyx application using bun build...');
-  const proc = spawnSync('bun', ['build', mainPath, '--outdir', './dist', '--target', 'bun'], { stdio: 'inherit' });
+  const proc = spawnSync('bun', [
+    'build',
+    mainPath,
+    '--outdir',
+    './dist',
+    '--target',
+    'bun',
+    '--external',
+    'mongoose',
+    '--external',
+    'typeorm',
+    '--external',
+    'graphql'
+  ], { stdio: 'inherit' });
   if (proc.status === 0) {
     console.log('Build completed successfully. Output at ./dist/main.js');
   }
@@ -108,11 +121,14 @@ function runNew(name: string) {
   mkdirSync(name, { recursive: true });
   mkdirSync(join(name, 'src'), { recursive: true });
 
-  const isDevMode = process.env.CALYX_DEV === 'true';
+  let isDevMode = process.env.CALYX_DEV === 'true';
+  const selfPkgPath = join(import.meta.dir, '../../package.json');
+  if (existsSync(selfPkgPath)) {
+    isDevMode = true; // Auto-detect workspace dev environment
+  }
   
   let packageVersion = '0.1.0';
   try {
-    const selfPkgPath = join(import.meta.dir, '../../package.json');
     if (existsSync(selfPkgPath)) {
       const selfPkg = JSON.parse(readFileSync(selfPkgPath, 'utf-8'));
       if (selfPkg.version) {

package/src/compression/compression.middleware.ts

@@ -0,0 +1,7 @@
+export function compression() {
+  return (req: any, res: any, next: any) => {
+    // Tag the response to enable compression
+    res.compressionEnabled = true;
+    next();
+  };
+}

package/src/cookies/cookies.ts

@@ -0,0 +1,69 @@
+import { createParamDecorator } from '../http/decorators.ts';
+
+export interface CookieOptions {
+  maxAge?: number;
+  expires?: Date;
+  httpOnly?: boolean;
+  secure?: boolean;
+  path?: string;
+  domain?: string;
+  sameSite?: 'lax' | 'strict' | 'none' | boolean;
+}
+
+export function parseCookies(cookieHeader: string): Record<string, string> {
+  const cookies: Record<string, string> = {};
+  if (!cookieHeader) return cookies;
+  const parts = cookieHeader.split(';');
+  for (let i = 0; i < parts.length; i++) {
+    const part = parts[i];
+    const eqIdx = part.indexOf('=');
+    if (eqIdx !== -1) {
+      const key = part.substring(0, eqIdx).trim();
+      const val = part.substring(eqIdx + 1).trim();
+      cookies[key] = decodeURIComponent(val);
+    }
+  }
+  return cookies;
+}
+
+export function formatCookie(name: string, value: string, options: CookieOptions = {}): string {
+  let str = `${name}=${encodeURIComponent(value)}`;
+  if (options.maxAge !== undefined) {
+    str += `; Max-Age=${options.maxAge}`;
+  }
+  if (options.expires !== undefined) {
+    str += `; Expires=${options.expires.toUTCString()}`;
+  }
+  if (options.path !== undefined) {
+    str += `; Path=${options.path}`;
+  } else {
+    str += `; Path=/`;
+  }
+  if (options.domain !== undefined) {
+    str += `; Domain=${options.domain}`;
+  }
+  if (options.secure) {
+    str += `; Secure`;
+  }
+  if (options.httpOnly) {
+    str += `; HttpOnly`;
+  }
+  if (options.sameSite !== undefined) {
+    if (options.sameSite === true) {
+      str += `; SameSite=Strict`;
+    } else if (options.sameSite === 'lax') {
+      str += `; SameSite=Lax`;
+    } else if (options.sameSite === 'strict') {
+      str += `; SameSite=Strict`;
+    } else if (options.sameSite === 'none') {
+      str += `; SameSite=None`;
+    }
+  }
+  return str;
+}
+
+export const Cookies = createParamDecorator((data: string | undefined, ctx) => {
+  const req = ctx.switchToHttp().getRequest();
+  const cookies = (req as any).cookies || {};
+  return data ? cookies[data] : cookies;
+});

package/src/database/mongoose.module.ts

@@ -0,0 +1,250 @@
+import { Database } from 'bun:sqlite';
+import { Module, DynamicModule, Inject } from '../core/decorators.ts';
+import { ConnectionManager } from './typeorm.module.ts';
+
+// Dynamic detection of Mongoose availability
+let isMongooseAvailable = false;
+try {
+  require.resolve('mongoose');
+  isMongooseAvailable = true;
+} catch {
+  // ignore
+}
+
+class QueryPromise<T> {
+  constructor(private readonly promise: Promise<T>) {}
+  then(onfulfilled?: any, onrejected?: any) {
+    return this.promise.then(onfulfilled, onrejected);
+  }
+  catch(onrejected?: any) {
+    return this.promise.catch(onrejected);
+  }
+  finally(onfn?: any) {
+    return this.promise.finally(onfn);
+  }
+  exec(): Promise<T> {
+    return this.promise;
+  }
+}
+
+// Native Sqlite-backed document store model fallback
+class NativeSqliteModel<T extends Record<string, any>> {
+  private tableName: string;
+
+  constructor(private readonly db: Database, private readonly modelName: string) {
+    this.tableName = `mongo_${modelName.toLowerCase()}`;
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        data TEXT
+      )
+    `);
+  }
+
+  private toDoc(row: any): T | null {
+    if (!row) return null;
+    try {
+      const obj = JSON.parse(row.data);
+      obj._id = row.id;
+      return obj as T;
+    } catch {
+      return null;
+    }
+  }
+
+  async create(doc: Partial<T> | Partial<T>[]): Promise<any> {
+    const docs = Array.isArray(doc) ? doc : [doc];
+    const created: T[] = [];
+    for (const d of docs) {
+      const dataCopy = { ...d };
+      delete dataCopy._id;
+      const jsonStr = JSON.stringify(dataCopy);
+      const result = this.db.query(`INSERT INTO ${this.tableName} (data) VALUES ($data) RETURNING id`).get({
+        $data: jsonStr,
+      }) as any;
+      created.push({ ...d, _id: result.id } as unknown as T);
+    }
+    return Array.isArray(doc) ? created : created[0];
+  }
+
+  async find(conditions: Partial<T> = {}): Promise<T[]> {
+    if (Object.keys(conditions).length === 0) {
+      const rows = this.db.query(`SELECT id, data FROM ${this.tableName}`).all() as any[];
+      return rows.map((r) => this.toDoc(r)).filter(Boolean) as T[];
+    }
+
+    const conds: string[] = [];
+    const params: Record<string, any> = {};
+
+    for (const [key, val] of Object.entries(conditions)) {
+      if (key === '_id') {
+        conds.push(`id = $id`);
+        params['$id'] = val;
+      } else {
+        conds.push(`json_extract(data, '$.${key}') = $${key}`);
+        params[`$${key}`] = val;
+      }
+    }
+
+    const sql = `SELECT id, data FROM ${this.tableName} WHERE ${conds.join(' AND ')}`;
+    const rows = this.db.query(sql).all(params) as any[];
+    return rows.map((r) => this.toDoc(r)).filter(Boolean) as T[];
+  }
+
+  async findOne(conditions: Partial<T> = {}): Promise<T | null> {
+    const list = await this.find(conditions);
+    return list.length > 0 ? list[0] : null;
+  }
+
+  async updateOne(conditions: Partial<T>, update: Partial<T>): Promise<any> {
+    const doc = await this.findOne(conditions);
+    if (!doc) return { matchedCount: 0, modifiedCount: 0 };
+
+    const updatedData = { ...doc, ...update };
+    const id = doc._id;
+    delete updatedData._id;
+
+    this.db.query(`UPDATE ${this.tableName} SET data = $data WHERE id = $id`).run({
+      $data: JSON.stringify(updatedData),
+      $id: id,
+    });
+
+    return { matchedCount: 1, modifiedCount: 1 };
+  }
+
+  async deleteOne(conditions: Partial<T>): Promise<any> {
+    const doc = await this.findOne(conditions);
+    if (!doc) return { deletedCount: 0 };
+
+    this.db.query(`DELETE FROM ${this.tableName} WHERE id = $id`).run({ $id: doc._id });
+    return { deletedCount: 1 };
+  }
+}
+
+// Unified Mongoose Model wrapper
+export class Model<T extends Record<string, any>> {
+  private modelPromise: Promise<any>;
+
+  constructor(
+    connOrDbPromise: Promise<any>,
+    private readonly modelName: string,
+    private readonly schema: any,
+    private readonly isNative: boolean
+  ) {
+    if (isNative) {
+      this.modelPromise = connOrDbPromise.then((db) => new NativeSqliteModel(db, modelName));
+    } else {
+      this.modelPromise = connOrDbPromise.then((conn) => {
+        // Compile schema/model using real mongoose connection
+        return conn.models[modelName] || conn.model(modelName, schema || {});
+      });
+    }
+  }
+
+  create(doc: Partial<T> | Partial<T>[]): QueryPromise<any> {
+    const promise = this.modelPromise.then((model) => model.create(doc));
+    return new QueryPromise(promise);
+  }
+
+  find(conditions: Partial<T> = {}): QueryPromise<T[]> {
+    const promise = this.modelPromise.then(async (model) => {
+      const q = model.find(conditions);
+      return typeof q.exec === 'function' ? await q.exec() : await q;
+    });
+    return new QueryPromise(promise);
+  }
+
+  findOne(conditions: Partial<T> = {}): QueryPromise<T | null> {
+    const promise = this.modelPromise.then(async (model) => {
+      const q = model.findOne(conditions);
+      return typeof q.exec === 'function' ? await q.exec() : await q;
+    });
+    return new QueryPromise(promise);
+  }
+
+  updateOne(conditions: Partial<T>, update: Partial<T>): QueryPromise<any> {
+    const promise = this.modelPromise.then(async (model) => {
+      const q = model.updateOne(conditions, update);
+      return typeof q.exec === 'function' ? await q.exec() : await q;
+    });
+    return new QueryPromise(promise);
+  }
+
+  deleteOne(conditions: Partial<T>): QueryPromise<any> {
+    const promise = this.modelPromise.then(async (model) => {
+      const q = model.deleteOne(conditions);
+      return typeof q.exec === 'function' ? await q.exec() : await q;
+    });
+    return new QueryPromise(promise);
+  }
+}
+
+export function InjectModel(name: string): ParameterDecorator & PropertyDecorator {
+  return Inject(`Model_${name}`);
+}
+
+@Module({})
+export class MongooseModule {
+  static forRoot(uri: string, options: any = {}): DynamicModule {
+    const isUsingMongoose = isMongooseAvailable && !options.useNativeFallback;
+
+    let connOrDbPromise: Promise<any>;
+    if (isUsingMongoose) {
+      connOrDbPromise = (async () => {
+        const mongoose = await import('mongoose');
+        const conn = mongoose.createConnection(uri, options);
+        // Wait for connection to open
+        await new Promise((resolve, reject) => {
+          conn.once('open', resolve);
+          conn.once('error', reject);
+        });
+        return conn;
+      })();
+    } else {
+      let dbPath = ':memory:';
+      if (uri.startsWith('mongodb://') || uri.startsWith('mongodb+srv://')) {
+        const match = uri.match(/\/([a-zA-Z0-9_-]+)(?:\?|$)/);
+        if (match && match[1]) {
+          dbPath = `${match[1]}.db`;
+        }
+      }
+      connOrDbPromise = Promise.resolve(ConnectionManager.getOrCreate(dbPath));
+    }
+
+    return {
+      module: MongooseModule,
+      providers: [
+        {
+          provide: 'Calyx_Mongo_Connection',
+          useValue: connOrDbPromise,
+        },
+        {
+          provide: 'Calyx_Mongo_IsNative',
+          useValue: !isUsingMongoose,
+        },
+      ],
+      exports: ['Calyx_Mongo_Connection', 'Calyx_Mongo_IsNative'],
+      global: true,
+    };
+  }
+
+  static forFeature(models: { name: string; schema?: any }[] = []): DynamicModule {
+    const providers = models.map((m) => {
+      return {
+        provide: `Model_${m.name}`,
+        useFactory: (connOrDbPromise: Promise<any>, isNative: boolean) => {
+          const resolvedPromise = connOrDbPromise ?? Promise.resolve(ConnectionManager.getOrCreate());
+          const resolvedIsNative = isNative !== undefined ? isNative : true;
+          return new Model(resolvedPromise, m.name, m.schema, resolvedIsNative);
+        },
+        inject: ['Calyx_Mongo_Connection', 'Calyx_Mongo_IsNative'],
+      };
+    });
+
+    return {
+      module: MongooseModule,
+      providers,
+      exports: models.map((m) => `Model_${m.name}`),
+    };
+  }
+}