@zintrust/core 0.1.41 → 0.1.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -22,6 +22,22 @@
       "types": "./src/start.d.ts",
       "import": "./src/start.js"
     },
+    "./cli": {
+      "types": "./src/cli.d.ts",
+      "import": "./src/cli.js"
+    },
+    "./proxy": {
+      "types": "./src/proxy.d.ts",
+      "import": "./src/proxy.js"
+    },
+    "./collections": {
+      "types": "./src/collections/index.d.ts",
+      "import": "./src/collections/index.js"
+    },
+    "./helper": {
+      "types": "./src/helper/index.d.ts",
+      "import": "./src/helper/index.js"
+    },
     "./node": {
       "types": "./src/node.d.ts",
       "import": "./src/node.js"

package/src/boot/bootstrap.js

@@ -37,29 +37,45 @@ const logBootstrapErrorDetails = (error) => {
         // best-effort logging
     }
 };
-const startSchedulesIfNeeded = async (app) => {
+const startSchedulesIfNeeded = async (application) => {
     try {
+        if (Env.getBool('SCHEDULES_ENABLED', false) === false)
+            return;
         const runtime = appConfig.detectRuntime();
         if (runtime !== 'nodejs' && runtime !== 'fargate')
             return;
-        const { create: createScheduleRunner } = await import('../scheduler/ScheduleRunner.js');
-        const schedules = await import('../schedules/index.js');
-        const runner = createScheduleRunner();
-        for (const schedule of Object.values(schedules)) {
-            // Each schedule is expected to export a default ISchedule
-            // @ts-ignore
-            runner.register(schedule);
+        const { SchedulerRuntime } = await import('../scheduler/SchedulerRuntime.js');
+        const coreSchedules = await import('../schedules/index.js');
+        let appSchedules = {};
+        try {
+            const appSchedulesModuleId = '@app/' + 'Schedules';
+            appSchedules = (await import(appSchedulesModuleId));
+        }
+        catch {
+            /* v8 ignore next */
+            appSchedules = {};
         }
-        runner.start();
+        const isSchedule = (value) => {
+            if (value === null || value === undefined || typeof value !== 'object')
+                return false;
+            return ('name' in value &&
+                typeof value.name === 'string' &&
+                value.name.trim().length > 0);
+        };
+        const coreScheduleEntries = Object.values(coreSchedules).filter(isSchedule);
+        const appScheduleEntries = Object.values(appSchedules).filter(isSchedule);
+        SchedulerRuntime.registerMany(coreScheduleEntries, 'core');
+        SchedulerRuntime.registerMany(appScheduleEntries, 'app');
+        SchedulerRuntime.start();
         // Add shutdown hook to stop schedules gracefully
-        const shutdownManager = app.getContainer().get('shutdownManager');
+        const shutdownManager = application.getContainer().get('shutdownManager');
         if ((typeof shutdownManager === 'object' || typeof shutdownManager === 'function') &&
             shutdownManager !== null &&
             'add' in shutdownManager &&
             typeof shutdownManager.add === 'function') {
             shutdownManager.add(async () => {
                 const scheduleTimeoutMs = Env.getInt('SCHEDULE_SHUTDOWN_TIMEOUT_MS', 30000);
-                await runner.stop(scheduleTimeoutMs);
+                await SchedulerRuntime.stop(scheduleTimeoutMs);
             });
         }
     }

package/src/boot/registry/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA+I9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AA+KF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAsE7D,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA+I9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AAyLF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAuE7D,CAAC"}

package/src/boot/registry/runtime.js

@@ -293,6 +293,16 @@ const initializeQueueHttpGateway = async (router) => {
         Logger.warn('Failed to register Queue HTTP gateway routes', error);
     }
 };
+const initializeScheduleHttpGateway = async (router) => {
+    try {
+        const { ScheduleHttpGateway } = await import('../../scheduler/ScheduleHttpGateway.js');
+        ScheduleHttpGateway.create().registerRoutes(router);
+        Logger.info('Schedule HTTP gateway route registered at /api/_sys/schedule/rpc');
+    }
+    catch (error) {
+        Logger.warn('Failed to register Schedule HTTP gateway routes', error);
+    }
+};
 export const createLifecycle = (params) => {
     const boot = async () => {
         if (params.getBooted())
@@ -324,6 +334,7 @@ export const createLifecycle = (params) => {
             await initializeWorkers(params.router);
             await initializeQueueMonitor(params.router);
             await initializeQueueHttpGateway(params.router);
+            await initializeScheduleHttpGateway(params.router);
         }
         // Register service providers
         // Bootstrap services

package/src/cli/CLI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2DH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAiPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAuPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}

package/src/cli/CLI.js

@@ -8,6 +8,7 @@ import { ConfigCommand } from './commands/ConfigCommand.js';
 import { ContainerProxiesCommand } from './commands/ContainerProxiesCommand.js';
 import { ContainerWorkersCommand } from './commands/ContainerWorkersCommand.js';
 import { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from './commands/CreateCommand.js';
+import { D1LearnCommand } from './commands/D1LearnCommand.js';
 import { D1MigrateCommand } from './commands/D1MigrateCommand.js';
 import { DbSeedCommand } from './commands/DbSeedCommand.js';
 import { DebugCommand } from './commands/DebugCommand.js';
@@ -17,6 +18,7 @@ import { DeployContainerWorkersCommand } from './commands/DeployContainerWorkers
 import { DoctorArchitectureCommand } from './commands/DoctorArchitectureCommand.js';
 import { FixCommand } from './commands/FixCommand.js';
 import { InitContainerCommand } from './commands/InitContainerCommand.js';
+import { InitEcosystemCommand } from './commands/InitEcosystemCommand.js';
 import { InitProducerCommand } from './commands/InitProducerCommand.js';
 import { InitProxyCommand } from './commands/InitProxyCommand.js';
 import { JwtDevCommand } from './commands/JwtDevCommand.js';
@@ -34,12 +36,16 @@ import { PostgresProxyCommand } from './commands/PostgresProxyCommand.js';
 import { PrepareCommand } from './commands/PrepareCommand.js';
 import { ProxyCommand } from './commands/ProxyCommand.js';
 import { PublishCommand } from './commands/PublishCommand.js';
+import { PutCommand } from './commands/PutCommand.js';
 import { QACommand } from './commands/QACommand.js';
 import { QueueCommand } from './commands/QueueCommand.js';
 import { QueueRecoveryCommand } from './commands/QueueRecoveryCommand.js';
 import { RedisProxyCommand } from './commands/RedisProxyCommand.js';
 import { ResourceControlCommand } from './commands/ResourceControlCommand.js';
 import { RoutesCommand } from './commands/RoutesCommand.js';
+import { ScheduleListCommand } from './commands/ScheduleListCommand.js';
+import { ScheduleRunCommand } from './commands/ScheduleRunCommand.js';
+import { ScheduleStartCommand } from './commands/ScheduleStartCommand.js';
 import { SecretsCommand } from './commands/SecretsCommand.js';
 import { SimulateCommand } from './commands/SimulateCommand.js';
 import { SmtpProxyCommand } from './commands/SmtpProxyCommand.js';
@@ -71,6 +77,7 @@ const buildCommandRegistry = () => {
         InitContainerCommand.create(),
         InitProxyCommand.create(),
         InitProducerCommand.create(),
+        InitEcosystemCommand.create(),
         DoctorArchitectureCommand.create(),
         AddCommand.create(),
         CreateCommand.create(),
@@ -79,12 +86,16 @@ const buildCommandRegistry = () => {
         StartCommand.create(),
         QueueCommand.create(),
         QueueRecoveryCommand.create(),
+        ScheduleListCommand.create(),
+        ScheduleRunCommand.create(),
+        ScheduleStartCommand.create(),
         BroadcastWorkCommand.create(),
         NotificationWorkCommand.create(),
         ResourceControlCommand,
         MigrateWorkerCommand.create(),
         MigrateCommand.create(),
         DbSeedCommand.create(),
+        D1LearnCommand.create(),
         D1MigrateCommand.create(),
         DebugCommand.create(),
         SecretsCommand.create(),
@@ -93,6 +104,7 @@ const buildCommandRegistry = () => {
         ContainerProxiesCommand.create(),
         PluginCommand.create(),
         PublishCommand.create(),
+        PutCommand.create(),
         DeployCommand.create(),
         DeployContainerWorkersCommand.create(),
         DeployContainerProxiesCommand.create(),

package/src/cli/commands/ConfigCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmVrE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EAsEtB,CAAC"}
+{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiVrE;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EAsEtB,CAAC"}

package/src/cli/commands/ConfigCommand.js

@@ -8,6 +8,7 @@ import { ConfigValidator } from '../config/ConfigValidator.js';
 import { ErrorHandler } from '../ErrorHandler.js';
 import { PromptHelper } from '../PromptHelper.js';
 import { Logger } from '../../config/logger.js';
+import { isArray, isObject } from '../../helper/index.js';
 import chalk from 'chalk';
 const addOptions = (command) => {
     command.argument('[action]', 'Action: get, set, list, reset, edit, export');
@@ -225,9 +226,8 @@ const handleEdit = async (cmd, manager) => {
 const handleExport = (cmd, manager) => {
     cmd.info(typeof manager.export === 'function' ? manager.export() : '{}');
 };
-const isUnknownArray = (value) => Array.isArray(value);
 const getArg = (args, index) => {
-    if (!isUnknownArray(args))
+    if (!isArray(args))
         return undefined;
     const value = args[index];
     return typeof value === 'string' ? value : undefined;
@@ -236,9 +236,7 @@ const executeConfig = async (cmd, options) => {
     const typedCmd = cmd;
     const command = cmd.getCommand();
     const toRecord = (value) => {
-        if (value === null || typeof value !== 'object' || Array.isArray(value))
-            return {};
-        return value;
+        return isObject(value) ? value : {};
     };
     const commandOpts = typeof command.opts === 'function' ? toRecord(command.opts()) : {};
     const mergedOptions = {

package/src/cli/commands/D1LearnCommand.d.ts

@@ -0,0 +1,9 @@
+/**
+ * D1 Learn Command
+ * Runs a command in "learning mode" to capture D1 SQL statements for the registry.
+ */
+import { type IBaseCommand } from '../BaseCommand';
+export declare const D1LearnCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+//# sourceMappingURL=D1LearnCommand.d.ts.map

package/src/cli/commands/D1LearnCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"D1LearnCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1LearnCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgGvF,eAAO,MAAM,cAAc;cACf,YAAY;EAiEtB,CAAC"}

package/src/cli/commands/D1LearnCommand.js

@@ -0,0 +1,143 @@
+/**
+ * D1 Learn Command
+ * Runs a command in "learning mode" to capture D1 SQL statements for the registry.
+ */
+import { BaseCommand } from '../BaseCommand.js';
+import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isNonEmptyString, isObject } from '../../helper/index.js';
+import * as fs from '../../node-singletons/fs.js';
+import { StatementRegistryBuild } from '../../orm/SchemaStatemenWriter.js';
+import { spawn } from 'node:child_process';
+const LEARN_FILE = 'storage/d1-learned.jsonl';
+const isRecord = (value) => isObject(value);
+const coerceStringRegistry = (value) => {
+    if (!isRecord(value))
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        if (isNonEmptyString(v))
+            out[k] = v;
+    }
+    return out;
+};
+const readExistingRegistryFile = async (outputFile) => {
+    try {
+        await fs.stat(outputFile);
+        const existingContent = await fs.readFile(outputFile, 'utf-8');
+        const existingJson = JSON.parse(existingContent);
+        if (isRecord(existingJson) && 'queries' in existingJson) {
+            return coerceStringRegistry(existingJson['queries']);
+        }
+        return coerceStringRegistry(existingJson);
+    }
+    catch {
+        return {};
+    }
+};
+const cleanLearnFile = async () => {
+    try {
+        await fs.rm(LEARN_FILE, { force: true });
+    }
+    catch {
+        // ignore
+    }
+};
+const parseLearnedFile = async () => {
+    try {
+        const content = await fs.readFile(LEARN_FILE, 'utf-8');
+        return StatementRegistryBuild.fromJsonl(content);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return {};
+        }
+        throw err;
+    }
+};
+const runLearner = async (cmd, args) => {
+    return new Promise((resolve, reject) => {
+        Logger.info(`Starting learner: ${cmd} ${args.join(' ')}`);
+        Logger.info(`Capturing queries to ${LEARN_FILE}...`);
+        const child = spawn(cmd, args, {
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                ZT_D1_LEARN_FILE: LEARN_FILE,
+                D1_REMOTE_MODE: 'sql',
+            },
+        });
+        child.on('close', (code) => {
+            // Allow code 0 or 1 (tests fail sometimes but still run queries)
+            // Actually, we resolve regardless so we can harvest what ran
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                // We log error but resolve to process partial results
+                Logger.error(`Command exited with code ${code}`);
+                resolve();
+            }
+        });
+        child.on('error', (err) => {
+            reject(err);
+        });
+    });
+};
+export const D1LearnCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'd1:learn',
+            description: 'Run a command to learn D1 queries and generate a statement registry',
+            addOptions: (c) => {
+                c.argument('<command>', 'The command to run (e.g. "npm test")')
+                    .option('-o, --output <file>', 'Output JSON file (default: d1-statements.json)')
+                    .option('-a, --append', 'Append to existing output file instead of overwriting');
+            },
+            async execute(options) {
+                const learnOptions = options;
+                // In BaseCommand, positional arguments are stored in options.args array
+                // We defined .argument('<command>') so it's the first element.
+                const commandStr = options.args && options.args.length > 0 ? options.args[0] : '';
+                if (commandStr === '') {
+                    Logger.error('Missing command argument');
+                    return;
+                }
+                const outputFile = learnOptions.output ?? 'd1-statements.json';
+                const append = learnOptions.append === true;
+                // 1. Prepare
+                await cleanLearnFile();
+                const parts = commandStr.split(' ');
+                const cmdExe = parts[0];
+                const args = parts.slice(1);
+                // 2. Run command
+                try {
+                    await runLearner(cmdExe, args);
+                }
+                catch (err) {
+                    throw ErrorFactory.createCliError(`Learner failed to start: ${err.message}`);
+                }
+                // 3. Process results
+                const learned = await parseLearnedFile();
+                const count = Object.keys(learned).length;
+                if (count === 0) {
+                    Logger.warn('No D1 queries were captured.');
+                    return;
+                }
+                Logger.info(`Captured ${count} unique queries.`);
+                // 4. Merge with existing if needed
+                let finalMap = learned;
+                if (append) {
+                    const existingMap = await readExistingRegistryFile(outputFile);
+                    finalMap = StatementRegistryBuild.merge(existingMap, learned);
+                }
+                // 5. Output
+                // One-line JSON is easiest to paste into `wrangler secret put ZT_D1_STATEMENTS_JSON`.
+                const outputContent = StatementRegistryBuild.toStatementsJson(finalMap);
+                await fs.writeFile(outputFile, outputContent);
+                Logger.info(`Registry written to ${outputFile}`);
+            },
+        });
+        return cmd;
+    },
+});

package/src/cli/commands/D1MigrateCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"D1MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAyDrE;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,YAAY;EAwBtB,CAAC"}
+{"version":3,"file":"D1MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8GrE;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,YAAY;EAyBtB,CAAC"}

package/src/cli/commands/D1MigrateCommand.js

@@ -1,9 +1,13 @@
 import { BaseCommand } from '../BaseCommand.js';
+import { D1SqlMigrations } from '../d1/D1SqlMigrations.js';
+import { WranglerConfig } from '../d1/WranglerConfig.js';
 import { WranglerD1 } from '../d1/WranglerD1.js';
 import { resolveNpmPath } from '../../common/index.js';
 import { appConfig } from '../../config/app.js';
+import { databaseConfig } from '../../config/database.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import * as path from '../../node-singletons/path.js';
 const RESOLVED_VOID = Promise.resolve();
 const runWrangler = async (cmd, args) => {
     // Back-compat entrypoint for tests; we only use this for D1 migrations apply.
@@ -13,30 +17,64 @@ const runWrangler = async (cmd, args) => {
     await RESOLVED_VOID;
     return WranglerD1.applyMigrations({ cmd, dbName, isLocal });
 };
-const executeD1Migrate = async (cmd, options) => {
+const getDbName = (options) => {
+    const value = options['database'];
+    return typeof value === 'string' && value.trim() !== '' ? value : 'zintrust_db';
+};
+const buildExecutionContext = (options) => {
+    const isWorkerCommand = process.argv.includes('d1:migrate:worker');
     const isLocal = options['local'] === true || options['remote'] !== true;
-    const dbName = typeof options['database'] === 'string' && options['database'].trim() !== ''
-        ? options['database']
-        : 'zintrust_db';
-    cmd.info(`Running D1 migrations for ${dbName} (${isLocal ? 'local' : 'remote'})...`);
+    const dbName = getDbName(options);
+    const projectRoot = process.cwd();
+    const migrationsRelDir = isWorkerCommand
+        ? path.join('database', 'migrations', 'd1')
+        : WranglerConfig.getD1MigrationsDir(projectRoot, dbName);
+    const sourceMigrationsDir = isWorkerCommand
+        ? path.join('packages', 'workers', 'migrations')
+        : databaseConfig.migrations.directory;
+    return {
+        isLocal,
+        dbName,
+        projectRoot,
+        migrationsRelDir,
+        sourceMigrationsDir,
+        outputDir: path.join(projectRoot, migrationsRelDir),
+    };
+};
+const handleMigrationError = (cmd, error) => {
+    Logger.error('D1 Migration failed', error);
+    ErrorFactory.createCliError('D1 Migration failed', error);
+    const err = error;
+    if (err.stdout !== undefined && err.stdout.length > 0)
+        cmd.info(err.stdout.toString());
+    if (err.stderr !== undefined && err.stderr.length > 0) {
+        const stderr = err.stderr.toString();
+        Logger.error('Wrangler stderr', stderr);
+        ErrorFactory.createCliError('Wrangler stderr', stderr);
+    }
+    throw error;
+};
+const executeD1Migrate = async (cmd, options) => {
+    const ctx = buildExecutionContext(options);
+    cmd.info(`Running D1 migrations for ${ctx.dbName} (${ctx.isLocal ? 'local' : 'remote'})...`);
+    cmd.info(`Generating D1 SQL migrations into ${ctx.migrationsRelDir}...`);
     await RESOLVED_VOID;
     try {
-        const output = WranglerD1.applyMigrations({ cmd, dbName, isLocal });
+        const generated = await D1SqlMigrations.compileAndWrite({
+            projectRoot: ctx.projectRoot,
+            globalDir: ctx.sourceMigrationsDir,
+            extension: databaseConfig.migrations.extension,
+            includeGlobal: true,
+            outputDir: ctx.outputDir,
+        });
+        cmd.info(`Generated ${generated.length} SQL migration file(s).`);
+        const output = WranglerD1.applyMigrations({ cmd, dbName: ctx.dbName, isLocal: ctx.isLocal });
         if (output !== '')
             cmd.info(output);
         cmd.info('✓ D1 migrations completed successfully');
     }
     catch (error) {
-        Logger.error('D1 Migration failed', error);
-        ErrorFactory.createCliError('D1 Migration failed', error);
-        const err = error;
-        if (err.stdout !== undefined && err.stdout.length > 0)
-            cmd.info(err.stdout.toString());
-        if (err.stderr !== undefined && err.stderr.length > 0)
-            Logger.error('Wrangler stderr', err.stderr.toString());
-        if (err.stderr !== undefined && err.stderr.length > 0)
-            ErrorFactory.createCliError('Wrangler stderr', err.stderr.toString());
-        throw error;
+        handleMigrationError(cmd, error);
     }
 };
 /**
@@ -60,6 +98,7 @@ export const D1MigrateCommand = Object.freeze({
         const cmd = BaseCommand.create({
             name: 'd1:migrate',
             description: 'Run Cloudflare D1 migrations',
+            aliases: ['d1:migrate:worker'],
             addOptions,
             execute: async (options) => executeD1Migrate(cmd, options),
         });

package/src/cli/commands/InitContainerCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InitContainerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/InitContainerCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAoNlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAkBtB,CAAC"}
+{"version":3,"file":"InitContainerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/InitContainerCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmOlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAkBtB,CAAC"}

package/src/cli/commands/InitContainerCommand.js

@@ -76,6 +76,22 @@ services:
       - DB_DATABASE_MYSQL=\${DB_DATABASE_MYSQL:-zintrust}
       - DB_USERNAME_MYSQL=\${DB_USERNAME_MYSQL:-zintrust}
       - DB_PASSWORD_MYSQL=\${DB_PASSWORD_MYSQL:-secret}
+
+      # Cloudflare D1
+      - D1_DATABASE_ID=\${D1_DATABASE_ID}
+      - D1_ACCOUNT_ID=\${D1_ACCOUNT_ID}
+      - D1_API_TOKEN=\${D1_API_TOKEN}
+      - D1_REMOTE_URL=\${D1_REMOTE_URL}
+      - D1_REMOTE_KEY_ID=\${D1_REMOTE_KEY_ID}
+      - D1_REMOTE_SECRET=\${D1_REMOTE_SECRET}
+
+      # Cloudflare KV
+      - KV_NAMESPACE_ID=\${KV_NAMESPACE_ID}
+      - KV_ACCOUNT_ID=\${KV_ACCOUNT_ID}
+      - KV_API_TOKEN=\${KV_API_TOKEN}
+      - KV_REMOTE_URL=\${KV_REMOTE_URL}
+      - KV_REMOTE_KEY_ID=\${KV_REMOTE_KEY_ID}
+      - KV_REMOTE_SECRET=\${KV_REMOTE_SECRET}
     ports:
       - '7772:7772'
 
@@ -101,7 +117,7 @@ RUN apk add --no-cache python3 make g++
 COPY package.json package-lock.json ./
 
 # Install dependencies (including dev dependencies needed for build)
-RUN --mount=type=cache,target=/root/.npm \
+RUN --mount=type=cache,target=/root/.npm,id=zintrust-npm-cache,sharing=locked \
   npm config set fetch-retries 5 \
     && npm config set fetch-retry-mintimeout 20000 \
     && npm config set fetch-retry-maxtimeout 120000 \
@@ -112,7 +128,7 @@ COPY . .
 
 # Build TypeScript to JavaScript
 ARG BUILD_VARIANT=full
-RUN --mount=type=cache,target=/root/.npm npm run build:dk
+RUN --mount=type=cache,target=/root/.npm,id=zintrust-npm-cache,sharing=locked npm run build:dk
 
 # Runtime Stage - Production image
 FROM node:20-alpine AS runtime
@@ -131,11 +147,10 @@ RUN addgroup -g 1001 -S nodejs && adduser -S nodejs -u 1001
 COPY package.json package-lock.json ./
 
 # Install only production dependencies (requires build tools for native modules)
-RUN --mount=type=cache,target=/root/.npm \
+RUN --mount=type=cache,target=/root/.npm,id=zintrust-npm-cache,sharing=locked \
   apk add --no-cache --virtual .build-deps python3 make g++ \
   && npm ci --omit=dev \
-    && apk del .build-deps \
-    && npm cache clean --force
+    && apk del .build-deps
 
 # Copy compiled code from builder stage
 COPY --from=builder /app/dist ./dist
@@ -157,7 +172,7 @@ EXPOSE 7772
 # Start application (compiled JS; no tsx needed in runtime)
 CMD ["node", "dist/src/boot/bootstrap.js"]
 `;
-const backupSuffix = () => new Date().toISOString().replace(/[:.]/g, '-');
+const backupSuffix = () => new Date().toISOString().replaceAll(/[:.]/g, '-');
 const backupFileIfExists = (filePath) => {
     if (!existsSync(filePath))
         return;

package/src/cli/commands/InitEcosystemCommand.d.ts

@@ -0,0 +1,6 @@
+import { type IBaseCommand } from '../BaseCommand';
+export declare const InitEcosystemCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default InitEcosystemCommand;
+//# sourceMappingURL=InitEcosystemCommand.d.ts.map

package/src/cli/commands/InitEcosystemCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InitEcosystemCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/InitEcosystemCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAoDlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAOtB,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/src/cli/commands/InitEcosystemCommand.js

@@ -0,0 +1,51 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { PromptHelper } from '../PromptHelper.js';
+import { Logger } from '../../config/logger.js';
+import { copyFileSync, existsSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
+import { join } from '../../node-singletons/path.js';
+import { fileURLToPath } from '../../node-singletons/url.js';
+const backupSuffix = () => new Date().toISOString().replaceAll(/[:.]/g, '-');
+const backupFileIfExists = (filePath) => {
+    if (!existsSync(filePath))
+        return;
+    const backupPath = `${filePath}.bak.${backupSuffix()}`;
+    copyFileSync(filePath, backupPath);
+    Logger.info(`🗂️ Backup created: ${backupPath}`);
+};
+const readTemplate = (relPathFromThisModule) => {
+    const absPath = fileURLToPath(new URL(relPathFromThisModule, import.meta.url));
+    return readFileSync(absPath, 'utf-8');
+};
+const TEMPLATE_ECOSYSTEM = readTemplate('../../templates/docker/docker-compose.ecosystem.yml.tpl');
+const TEMPLATE_SCHEDULES = readTemplate('../../templates/docker/docker-compose.schedules.yml.tpl');
+const writeScaffoldFile = async (cwd, fileName, content) => {
+    const outPath = join(cwd, fileName);
+    let shouldWrite = true;
+    if (existsSync(outPath)) {
+        shouldWrite = await PromptHelper.confirm(`${fileName} already exists. Overwrite?`, false);
+    }
+    if (!shouldWrite) {
+        Logger.info(`Skipped ${fileName}`);
+        return;
+    }
+    backupFileIfExists(outPath);
+    writeFileSync(outPath, content);
+    Logger.info(`✅ Created ${fileName}`);
+};
+const execute = async () => {
+    const cwd = process.cwd();
+    await writeScaffoldFile(cwd, 'docker-compose.ecosystem.yml', TEMPLATE_ECOSYSTEM);
+    await writeScaffoldFile(cwd, 'docker-compose.schedules.yml', TEMPLATE_SCHEDULES);
+    Logger.info('✅ Ecosystem scaffolding complete.');
+    Logger.info('Next: docker compose -f docker-compose.ecosystem.yml up -d');
+};
+export const InitEcosystemCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'init:ecosystem',
+            description: 'Scaffold docker-compose.ecosystem.yml and docker-compose.schedules.yml',
+            execute,
+        });
+    },
+});
+export default InitEcosystemCommand;

package/src/cli/commands/MigrateCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6ZrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0erE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}