@zintrust/core 0.1.19 → 0.1.21

package/src/cli/d1/WranglerConfig.js

@@ -0,0 +1,122 @@
+import * as fs from '../../node-singletons/fs.js';
+import * as path from '../../node-singletons/path.js';
+const createStripState = () => ({
+    inString: false,
+    escaped: false,
+    inLineComment: false,
+    inBlockComment: false,
+    skipNext: false,
+});
+const consumeSkipNext = (state) => {
+    if (!state.skipNext)
+        return false;
+    state.skipNext = false;
+    return true;
+};
+const handleLineComment = (state, ch, out) => {
+    if (!state.inLineComment)
+        return false;
+    if (ch === '\n') {
+        state.inLineComment = false;
+        out.push(ch);
+    }
+    return true;
+};
+const handleBlockComment = (state, ch, next) => {
+    if (!state.inBlockComment)
+        return false;
+    if (ch === '*' && next === '/') {
+        state.inBlockComment = false;
+        state.skipNext = true;
+    }
+    return true;
+};
+const handleString = (state, ch, out) => {
+    if (!state.inString)
+        return false;
+    out.push(ch);
+    if (state.escaped) {
+        state.escaped = false;
+        return true;
+    }
+    if (ch === '\\') {
+        state.escaped = true;
+        return true;
+    }
+    if (ch === '"') {
+        state.inString = false;
+    }
+    return true;
+};
+const tryStartString = (state, ch, out) => {
+    if (ch !== '"')
+        return false;
+    state.inString = true;
+    out.push(ch);
+    return true;
+};
+const tryStartLineComment = (state, ch, next) => {
+    if (ch !== '/' || next !== '/')
+        return false;
+    state.inLineComment = true;
+    state.skipNext = true;
+    return true;
+};
+const tryStartBlockComment = (state, ch, next) => {
+    if (ch !== '/' || next !== '*')
+        return false;
+    state.inBlockComment = true;
+    state.skipNext = true;
+    return true;
+};
+const processStripChar = (state, ch, next, out) => {
+    if (consumeSkipNext(state))
+        return true;
+    if (handleLineComment(state, ch, out))
+        return true;
+    if (handleBlockComment(state, ch, next))
+        return true;
+    if (handleString(state, ch, out))
+        return true;
+    if (tryStartString(state, ch, out))
+        return true;
+    if (tryStartLineComment(state, ch, next))
+        return true;
+    if (tryStartBlockComment(state, ch, next))
+        return true;
+    return false;
+};
+const stripJsonc = (input) => {
+    const state = createStripState();
+    const out = [];
+    for (let i = 0; i < input.length; i += 1) {
+        const ch = input[i] ?? '';
+        const next = i + 1 < input.length ? (input[i + 1] ?? '') : '';
+        if (processStripChar(state, ch, next, out))
+            continue;
+        out.push(ch);
+    }
+    return out.join('');
+};
+export const WranglerConfig = Object.freeze({
+    getD1MigrationsDir(projectRoot, dbName) {
+        const configPath = path.join(projectRoot, 'wrangler.jsonc');
+        if (!fs.existsSync(configPath))
+            return 'migrations';
+        try {
+            const raw = fs.readFileSync(configPath, 'utf8');
+            const parsed = JSON.parse(stripJsonc(raw));
+            const list = parsed.d1_databases;
+            if (!Array.isArray(list) || list.length === 0)
+                return 'migrations';
+            const match = typeof dbName === 'string'
+                ? list.find((d) => d.database_name === dbName)
+                : (list[0] ?? undefined);
+            const dir = match?.migrations_dir;
+            return typeof dir === 'string' && dir.trim() !== '' ? dir : 'migrations';
+        }
+        catch {
+            return 'migrations';
+        }
+    },
+});

package/src/cli/d1/WranglerD1.d.ts

@@ -0,0 +1,11 @@
+import type { IBaseCommand } from '../BaseCommand';
+type ApplyOptions = {
+    cmd: IBaseCommand;
+    dbName: string;
+    isLocal: boolean;
+};
+export declare const WranglerD1: Readonly<{
+    applyMigrations(opts: ApplyOptions): string;
+}>;
+export {};
+//# sourceMappingURL=WranglerD1.d.ts.map

package/src/cli/d1/WranglerD1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WranglerD1.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/WranglerD1.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,KAAK,YAAY,GAAG;IAClB,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,UAAU;0BACC,YAAY,GAAG,MAAM;EAc3C,CAAC"}

package/src/cli/d1/WranglerD1.js

@@ -0,0 +1,16 @@
+import { resolveNpmPath } from '../../common/index.js';
+import { appConfig } from '../../config/app.js';
+import { execFileSync } from '../../node-singletons/child-process.js';
+export const WranglerD1 = Object.freeze({
+    applyMigrations(opts) {
+        const args = ['d1', 'migrations', 'apply', opts.dbName, opts.isLocal ? '--local' : '--remote'];
+        const npmPath = resolveNpmPath();
+        opts.cmd.debug(`Executing: npm exec --yes -- wrangler ${args.join(' ')}`);
+        const result = execFileSync(npmPath, ['exec', '--yes', '--', 'wrangler', ...args], {
+            stdio: 'pipe',
+            encoding: 'utf8',
+            env: appConfig.getSafeEnv(),
+        });
+        return result;
+    },
+});

package/src/cli/scaffolding/ControllerGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ControllerGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ControllerGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgChG;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA2CjG;AA4bD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC"}
+{"version":3,"file":"ControllerGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ControllerGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAcD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAgChG;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA2CjG;AA8eD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC"}

package/src/cli/scaffolding/ControllerGenerator.js

@@ -117,7 +117,7 @@ function generateCrudController(options) {
  * Auto-generated CRUD controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 import { ${modelName} } from '@app/Models/${modelName}';
 
 function handleError(res: IResponse, error: unknown): void {
@@ -125,7 +125,7 @@ function handleError(res: IResponse, error: unknown): void {
   res.setStatus(500).json({ error: message });
 }
 
-export const ${className} = Object.freeze({
+const controller = Object.freeze({
   ...Controller,
 ${buildIndexMethod(modelName)},
 
@@ -137,6 +137,16 @@ ${buildUpdateMethod(modelName)},
 
 ${buildDestroyMethod(modelName)},
 });
+
+export type ${className}Api = typeof controller;
+
+export const ${className} = Object.freeze({
+  create(): ${className}Api {
+    return controller;
+  },
+});
+
+export default ${className};
 `;
 }
 /**
@@ -276,23 +286,33 @@ function generateApiController(options) {
  * Auto-generated API controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 
 function handleError(res: IResponse, error: unknown): void {
   const message = error instanceof Error ? error.message : 'Internal server error';
   res.setStatus(500).json({ error: message });
 }
 
-export const ${className} = {\n  ...Controller,
-${buildApiControllerBody(className)},
-};
+const controller = Object.freeze({\n  ...Controller,
+${buildApiControllerBody()},
+});
+
+export type ${className}Api = typeof controller;
+
+export const ${className} = Object.freeze({
+  create(): ${className}Api {
+    return controller;
+  },
+});
+
+export default ${className};
 `;
 }
 /**
  * Build API controller body
  */
-function buildApiControllerBody(className) {
-    return `${buildApiMainHandler(className)},
+function buildApiControllerBody() {
+    return `${buildApiMainHandler()},
 
 ${buildApiMethodHandlers()},
 `;
@@ -300,7 +320,7 @@ ${buildApiMethodHandlers()},
 /**
  * Build API main handler
  */
-function buildApiMainHandler(className) {
+function buildApiMainHandler() {
     return `  /**
    * API endpoint template
    */
@@ -310,13 +330,13 @@ function buildApiMainHandler(className) {
 
       // Route to appropriate handler
       if (method === 'GET') {
-        await ${className}.handleGet(req, res);
+        await controller.handleGet(req, res);
       } else if (method === 'POST') {
-        await ${className}.handlePost(req, res);
+        await controller.handlePost(req, res);
       } else if (method === 'PUT') {
-        await ${className}.handlePut(req, res);
+        await controller.handlePut(req, res);
       } else if (method === 'DELETE') {
-        await ${className}.handleDelete(req, res);
+        await controller.handleDelete(req, res);
       } else {
         res.setStatus(405).json({ error: 'Method not allowed' });
       }
@@ -367,14 +387,14 @@ function generateGraphQLController(options) {
  * Auto-generated GraphQL controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 
 function handleError(res: IResponse, error: unknown): void {
   const message = error instanceof Error ? error.message : 'GraphQL error';
   res.setStatus(500).json({ errors: [{ message }] });
 }
 
-export const ${className} = {\n  ...Controller,
+const controller = Object.freeze({\n  ...Controller,
   /**
    * GraphQL endpoint
    */
@@ -389,7 +409,7 @@ export const ${className} = {\n  ...Controller,
       const query = body.query as string;
 
       // TODO: Execute GraphQL query
-      const result = await ${className}.executeQuery(query);
+      const result = await controller.executeQuery(query);
 
       res.json(result);
     } catch (error) {
@@ -404,7 +424,17 @@ export const ${className} = {\n  ...Controller,
     // TODO: Implement GraphQL execution
     return { data: null };
   },
-};
+});
+
+export type ${className}Api = typeof controller;
+
+export const ${className} = Object.freeze({
+  create(): ${className}Api {
+    return controller;
+  },
+});
+
+export default ${className};
 `;
 }
 /**
@@ -419,7 +449,7 @@ function generateWebSocketController(options) {
 
 import { Logger } from '../../config/logger';
 
-export const ${className} = {
+const controller = Object.freeze({
   /**
    * Handle WebSocket connection
    */
@@ -441,7 +471,17 @@ export const ${className} = {
   async onDisconnect(socket: { id: string }): Promise<void> {
     Logger.info('Client disconnected:', { socketId: socket.id });
   },
-};
+});
+
+export type ${className}Api = typeof controller;
+
+export const ${className} = Object.freeze({
+  create(): ${className}Api {
+    return controller;
+  },
+});
+
+export default ${className};
 `;
 }
 /**
@@ -454,7 +494,7 @@ function generateWebhookController(options) {
  * Auto-generated Webhook controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 import { Logger } from '../../config/logger';
 
 function handleError(res: IResponse, error: unknown): void {
@@ -462,15 +502,25 @@ function handleError(res: IResponse, error: unknown): void {
   res.setStatus(500).json({ error: message });
 }
 
-export const ${className} = {\n  ...Controller,
-${buildWebhookControllerBody(className)},
-};
+const controller = Object.freeze({\n  ...Controller,
+${buildWebhookControllerBody()},
+});
+
+export type ${className}Api = typeof controller;
+
+export const ${className} = Object.freeze({
+  create(): ${className}Api {
+    return controller;
+  },
+});
+
+export default ${className};
 `;
 }
 /**
  * Build Webhook controller body
  */
-function buildWebhookControllerBody(className) {
+function buildWebhookControllerBody() {
     return `  /**
    * Handle incoming webhook
    */
@@ -478,13 +528,13 @@ function buildWebhookControllerBody(className) {
     try {
       // Verify webhook signature
       const signature = req.getHeader('x-webhook-signature');
-      if (${className}.verifySignature(req, signature as string) === false) {
+      if (controller.verifySignature(req, signature as string) === false) {
         res.setStatus(401).json({ error: 'Invalid signature' });
         return;
       }
 
       const body = req.getBody();
-      await ${className}.processWebhook(body);
+      await controller.processWebhook(body);
 
       res.json({ success: true });
     } catch (error) {

package/src/cli/scaffolding/FactoryGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FactoryGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/FactoryGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B5E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyB9F;AA+SD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;EAI3B,CAAC"}
+{"version":3,"file":"FactoryGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/FactoryGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B5E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyB9F;AAiTD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;EAI3B,CAAC"}

package/src/cli/scaffolding/FactoryGenerator.js

@@ -156,8 +156,10 @@ ${statePatterns}
 
         return result;
       }
+    };
+
     return factory;
-  }`;
+  },`;
 }
 /**
  * Build import statements

package/src/cli/scaffolding/GovernanceScaffolder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * GovernanceScaffolder
+ *
+ * Adds optional governance tooling to a generated app:
+ * - ESLint config + scripts
+ * - Architecture tests (Vitest)
+ */
+export type GovernanceScaffoldOptions = Readonly<{
+    writeEslintConfig?: boolean;
+    writeArchTests?: boolean;
+    install?: boolean;
+    packageManager?: string;
+}>;
+export type GovernanceScaffoldResult = Readonly<{
+    success: boolean;
+    filesCreated: string[];
+    message: string;
+}>;
+export declare const GovernanceScaffolder: Readonly<{
+    scaffold(projectRoot: string, options?: GovernanceScaffoldOptions): Promise<GovernanceScaffoldResult>;
+}>;
+export default GovernanceScaffolder;
+//# sourceMappingURL=GovernanceScaffolder.d.ts.map

package/src/cli/scaffolding/GovernanceScaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GovernanceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/GovernanceScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AA8RH,eAAO,MAAM,oBAAoB;0BAEhB,MAAM,YACV,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;EA+DpC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}