@zintrust/core 0.4.26 → 0.4.28

package/routes/apiDev.js

@@ -0,0 +1,92 @@
+/**
+ * Example Routes
+ * Demonstrates routing patterns
+ */
+// import { MultiLoginController } from '@app/Controllers/MultiLoginController';
+import { Router } from '../src/routes/Router.js';
+import { registerMailUiPag } from './mail.js';
+import registerDirectMysqlTestRoutes from './TestRoutes.js';
+import { JobStateTracker } from '../src/index.js';
+const trackerStatuses = new Set([
+    'pending',
+    'active',
+    'completed',
+    'failed',
+    'stalled',
+    'timeout',
+    'pending_recovery',
+    'dead_letter',
+    'manual_review',
+    'delayed',
+]);
+const getQueryValue = (req, key) => {
+    const raw = req.getQueryParam(key);
+    if (Array.isArray(raw)) {
+        return raw.length > 0 ? String(raw[0]) : undefined;
+    }
+    if (typeof raw === 'string')
+        return raw;
+    return undefined;
+};
+const parseLimit = (value) => {
+    if (value === undefined || value.trim().length === 0)
+        return 200;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return 200;
+    return Math.min(5000, parsed);
+};
+const normalizeOptional = (value) => {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    return trimmed;
+};
+const parseStatus = (value) => {
+    const normalized = normalizeOptional(value);
+    if (normalized === undefined)
+        return undefined;
+    if (!trackerStatuses.has(normalized))
+        return undefined;
+    return normalized;
+};
+const buildTrackerResponse = (req) => {
+    const queueName = normalizeOptional(getQueryValue(req, 'queue'));
+    const status = parseStatus(getQueryValue(req, 'status'));
+    const jobId = normalizeOptional(getQueryValue(req, 'jobId'));
+    const limit = parseLimit(getQueryValue(req, 'limit'));
+    const records = JobStateTracker.list({
+        queueName,
+        status,
+        limit,
+    });
+    const transitions = JobStateTracker.getTransitions({
+        queueName,
+        jobId,
+        limit,
+    });
+    const processId = typeof process === 'undefined' ? null : process.pid;
+    return {
+        processId,
+        queueName: queueName ?? null,
+        status: status ?? null,
+        jobId: jobId ?? null,
+        limit,
+        records,
+        transitions,
+        summary: JobStateTracker.getSummary(queueName),
+        generatedAt: new Date().toISOString(),
+    };
+};
+const registerQueueTrackerDebugRoute = (_router) => {
+    Router.get(_router, '/_debug/queue/tracker', async (req, res) => {
+        res.json(buildTrackerResponse(req));
+    });
+};
+export function registerDevRoutes(_router) {
+    registerDirectMysqlTestRoutes(_router);
+    registerQueueTrackerDebugRoute(_router);
+    registerMailUiPag(_router);
+}

package/routes/broadcast.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Broadcast Routes
+ *
+ * Runtime-only endpoints for broadcast.
+ * Provider setup and secret provisioning remain CLI-only.
+ */
+import { type IRouter } from '../src/routes/Router';
+export declare function registerBroadcastRoutes(router: IRouter): void;
+//# sourceMappingURL=broadcast.d.ts.map

package/routes/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../routes/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAsB7D"}

package/routes/broadcast.js

@@ -0,0 +1,27 @@
+/**
+ * Broadcast Routes
+ *
+ * Runtime-only endpoints for broadcast.
+ * Provider setup and secret provisioning remain CLI-only.
+ */
+import { Router } from '../src/routes/Router.js';
+export function registerBroadcastRoutes(router) {
+    Router.get(router, '/broadcast/health', async (_req, res) => {
+        res.json({ ok: true });
+    });
+    Router.post(router, '/broadcast/send', async (req, res) => {
+        const body = (req.body ?? {});
+        const channel = typeof body['channel'] === 'string' ? body['channel'] : '';
+        const event = typeof body['event'] === 'string' ? body['event'] : '';
+        const data = body['data'];
+        if (!channel || !event) {
+            res
+                .setStatus(400)
+                .json({ ok: false, error: 'Invalid payload: channel and event are required' });
+            return;
+        }
+        const { Broadcast } = await import('../src/tools/broadcast/Broadcast.js');
+        const result = await Broadcast.send(channel, event, data);
+        res.json({ ok: true, result });
+    });
+}

package/routes/mail.d.ts

@@ -0,0 +1,12 @@
+import { type IRouter } from '../src/index.js';
+import '../app/Workers/TestWorker';
+export declare const demonstrateDelayScheduling: () => Promise<void>;
+export declare const demonstratePriorityJobOrdering: () => Promise<void>;
+export declare const demonstrateRetryControl: () => Promise<void>;
+export declare const demonstrateDeduplication: () => Promise<void>;
+export declare const demonstrateCustomLockProvider: () => Promise<void>;
+export declare const demonstrateBulkProcessing: () => Promise<void>;
+export declare const demonstrateMetadataTracking: () => Promise<void>;
+export declare const demonstrateCombinedAdvancedOptions: () => Promise<void>;
+export declare const registerMailUiPag: (router: IRouter) => Promise<void>;
+//# sourceMappingURL=mail.d.ts.map

package/routes/mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../routes/mail.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,yBAAyB,CAAC;AAEjC,eAAO,MAAM,0BAA0B,QAAa,OAAO,CAAC,IAAI,CAU/D,CAAC;AAEF,eAAO,MAAM,8BAA8B,QAAa,OAAO,CAAC,IAAI,CAUnE,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAa,OAAO,CAAC,IAAI,CAS5D,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CA4B7D,CAAC;AAEF,eAAO,MAAM,6BAA6B,QAAa,OAAO,CAAC,IAAI,CA4BlE,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAa,OAAO,CAAC,IAAI,CAU9D,CAAC;AAEF,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,IAAI,CAehE,CAAC;AAEF,eAAO,MAAM,kCAAkC,QAAa,OAAO,CAAC,IAAI,CAcvE,CAAC;AA4CF,eAAO,MAAM,iBAAiB,GAAU,QAAQ,OAAO,KAAG,OAAO,CAAC,IAAI,CAkDrE,CAAC"}

package/routes/mail.js

@@ -0,0 +1,138 @@
+/* istanbul ignore file */
+import AdvancedEmailJobService from '../app/Jobs/AdvancedEmailJobService.js';
+import { Mail } from '../src/tools/mail/Mail.js';
+import { Logger, Router } from '../src/index.js';
+// Ensure TestWorker is registered for dashboard visibility
+import '../app/Workers/TestWorker.js';
+export const demonstrateDelayScheduling = async () => {
+    // Schedule email for 1 hour from now - job won't process until delay expires
+    await AdvancedEmailJobService.sendScheduledLock('scheduled@zintrust.com', 'Meeting Reminder', 'welcome', { meetingTime: '2026-02-01T10:00:00Z' }, 3600000 // 1 hour delay in milliseconds
+    );
+    // AdvancedEmailJobService.processAll();
+};
+export const demonstratePriorityJobOrdering = async () => {
+    // High priority urgent email - processes before lower priority jobs
+    await AdvancedEmailJobService.sendHighPriority('urgent@zintrust.com', 'URGENT: System Alert', 'welcome', { alertType: 'critical' }, { priority: 10, attempts: 5 }, // Higher number = higher priority,
+    'advanced-queue-redis');
+};
+export const demonstrateRetryControl = async () => {
+    // Email with custom retry attempts and exponential backoff
+    await AdvancedEmailJobService.sendHighPriority('retry@zintrust.com', 'Retry Test', 'welcome', { test: 'retry-logic' }, { attempts: 7, delay: 0 } // Will retry 7 times with exponential backoff
+    );
+};
+export const demonstrateDeduplication = async () => {
+    // Prevents duplicate emails from being sent within 24-hour window
+    await AdvancedEmailJobService.sendWithDeduplication('dedup@zintrust.com', 'Welcome Email', 'welcome', { name: 'User' }, 'welcome-user-123', // Same uniqueId = same job
+    'example-redis1');
+    await AdvancedEmailJobService.sendWithDeduplication('dedup-2@zintrust.com', 'Weekly Digest', 'welcome', { digest: 'week-1', delay: 300000 }, 'weekly-digest-001', 'example-redis1');
+    await AdvancedEmailJobService.sendWithDeduplication('dedup-3@zintrust.com', 'Invoice Ready', 'welcome', { invoiceId: 'inv-8899', delay: 300000 }, 'invoice-inv-8899', 'advanced-queue');
+};
+export const demonstrateCustomLockProvider = async () => {
+    // Use custom lock provider (redis/database/memory) for uniqueness
+    await AdvancedEmailJobService.sendWithUniqueLock('unique@zintrust.com', 'Password Reset', 'welcome', { token: 'abc123' }, 'redis', // uniqueVia: 'redis' | 'database' | 'memory'
+    'example-redis1');
+    await AdvancedEmailJobService.sendWithUniqueLock('unique-2@zintrust.com', 'Email Verification', 'welcome', { token: 'verify-456' }, 'memory', 'advanced-queue');
+    await AdvancedEmailJobService.sendWithUniqueLock('unique-3@zintrust.com', 'Account Recovery', 'welcome', { token: 'recover-789' }, 'database', 'example-redis1');
+};
+export const demonstrateBulkProcessing = async () => {
+    // Send bulk emails with batch ID and per-recipient deduplication
+    await AdvancedEmailJobService.sendBulk(['bulk1@zintrust.com', 'bulk2@zintrust.com', 'bulk3@zintrust.com'], 'Monthly Newsletter', 'welcome', { campaign: 'Q1-2026', issue: 'January' }, 'batch-newsletter-202601', // batchId for tracking
+    'advanced-queue');
+};
+export const demonstrateMetadataTracking = async () => {
+    // Email with campaign tracking metadata
+    await AdvancedEmailJobService.sendWithMetadata('metadata@zintrust.com', 'Campaign Email', 'welcome', { userName: 'Alice' }, {
+        campaign: 'winter-sale',
+        source: 'web-signup',
+        priority: 'high',
+        tags: ['marketing', 'promotion', 'new-user'],
+    }, 'example-redis1');
+};
+export const demonstrateCombinedAdvancedOptions = async () => {
+    // High-priority scheduled email with retry logic
+    await AdvancedEmailJobService.sendHighPriority('combined@zintrust.com', 'VIP Scheduled Notification', 'welcome', { vipLevel: 'platinum' }, {
+        priority: 10, // High priority
+        delay: 300000, // 5 minutes delay
+        attempts: 5, // Retry up to 5 times
+    }, 'example-redis1');
+};
+const TestAdvancedJob = async () => {
+    // ====================================================================
+    // SCENARIO 1: Delay Scheduling (delay option)
+    // ====================================================================
+    // await demonstrateDelayScheduling();
+    // ====================================================================
+    // SCENARIO 2: Priority Job Ordering (priority option)
+    // ====================================================================
+    await demonstratePriorityJobOrdering();
+    // ====================================================================
+    // SCENARIO 3: Retry Control (attempts + backoff options)
+    // ====================================================================
+    // await demonstrateRetryControl();
+    // ====================================================================
+    // SCENARIO 4: Deduplication Support (uniqueId + deduplication options)
+    // ====================================================================
+    // await demonstrateDeduplication();
+    // ====================================================================
+    // SCENARIO 5: Custom Lock Provider (uniqueVia option)
+    // ====================================================================
+    // await demonstrateCustomLockProvider();
+    // ====================================================================
+    // SCENARIO 6: Bulk Processing with Deduplication
+    // ====================================================================
+    // await demonstrateBulkProcessing();
+    // ====================================================================
+    // SCENARIO 7: Metadata Tracking (custom envelope data)
+    // ====================================================================
+    // await demonstrateMetadataTracking();
+    // ====================================================================
+    // SCENARIO 8: Combined Advanced Options
+    // ====================================================================
+    // await demonstrateCombinedAdvancedOptions();
+};
+export const registerMailUiPag = async (router) => {
+    /* istanbul ignore next */
+    // const { EmailJobService } = await import('../app/Jobs/EmailJobService');
+    const handler = async (req, res) => {
+        try {
+            await TestAdvancedJob();
+        }
+        catch (error) {
+            Logger.warn('Mail preview queue trigger failed', {
+                route: '/mail/:template',
+                template: req.getParam('template') ?? 'welcome',
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        const templateName = req.getParam('template') ?? 'welcome';
+        const templates = {
+            welcome: 'welcome',
+            general: 'general',
+            custom: 'custom',
+            'job-completed': 'job-completed',
+            'performance-report': 'performance-report',
+            'password-reset': 'password-reset',
+            'worker-alert': 'worker-alert',
+        };
+        const finalTemplate = templates[templateName] ?? 'welcome';
+        const variablesByTemplate = {
+            welcome: { name: 'Alice' },
+            general: {
+                name: 'Alice',
+                headline: 'Hello Alice',
+                message: 'Welcome to ZinTrust platform.',
+                primary_color: '#0ea5e9',
+            },
+            custom: { name: 'Alice' },
+        };
+        const html = await Mail.render({
+            template: finalTemplate,
+            variables: variablesByTemplate[finalTemplate] ?? { name: 'Alice' },
+        });
+        res.html(html);
+    };
+    if (typeof Router?.get !== 'function') {
+        return;
+    }
+    Router.get(router, '/mail/:template', handler);
+};

package/routes/storage.d.ts

@@ -0,0 +1,4 @@
+import { type IRouter } from '../src/routes/Router';
+export declare function registerStorageRoutes(router: IRouter): void;
+export default registerStorageRoutes;
+//# sourceMappingURL=storage.d.ts.map

package/routes/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../routes/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,qBAAqB,CAAC;AAI3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAiC3D;AAED,eAAe,qBAAqB,CAAC"}

package/routes/storage.js

@@ -0,0 +1,35 @@
+import { HTTP_HEADERS } from '../src/config/constants.js';
+import { Env } from '../src/config/env.js';
+import { Router } from '../src/routes/Router.js';
+import { LocalSignedUrl } from '../src/tools/storage/LocalSignedUrl.js';
+import { Storage } from '../src/tools/storage/index.js';
+export function registerStorageRoutes(router) {
+    Router.get(router, '/storage/download', async (req, res) => {
+        const tokenRaw = req.getQueryParam('token');
+        const token = typeof tokenRaw === 'string' ? tokenRaw : '';
+        if (token.trim() === '') {
+            res.setStatus(400).json({ message: 'Missing token' });
+            return;
+        }
+        const appKey = Env.get('APP_KEY', '');
+        if (appKey.trim() === '') {
+            res.setStatus(500).json({ message: 'Storage signing is not configured' });
+            return;
+        }
+        try {
+            const payload = LocalSignedUrl.verifyToken(token, appKey);
+            // Only local disk is supported by this route.
+            if (payload.disk !== 'local') {
+                res.setStatus(400).json({ message: 'Unsupported disk' });
+                return;
+            }
+            const contents = await Storage.get('local', payload.key);
+            res.setHeader(HTTP_HEADERS.CONTENT_TYPE, 'application/octet-stream');
+            res.setStatus(200).send(contents);
+        }
+        catch {
+            res.setStatus(403).json({ message: 'Invalid or expired token' });
+        }
+    });
+}
+export default registerStorageRoutes;

package/src/boot/bootstrap.js

@@ -10,6 +10,7 @@ import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { ProjectRuntime } from '../runtime/ProjectRuntime.js';
+import { WorkerProjectAutoImports } from '../runtime/WorkerProjectAutoImports.js';
 import { loadWorkersModule } from '../runtime/WorkersModule.js';
 let appInstance;
 let serverInstance;
@@ -165,6 +166,10 @@ async function useWorkerStarter() {
     // Initialize worker management system
     let workerInit = null;
     try {
+        const projectWorkerEntrypoint = await WorkerProjectAutoImports.tryImportProjectWorkerEntrypoint();
+        if (!projectWorkerEntrypoint.ok && projectWorkerEntrypoint.reason === 'import-failed') {
+            Logger.warn(`Project worker entrypoint import failed: ${projectWorkerEntrypoint.errorMessage ?? 'Unknown error'}`);
+        }
         const workers = await loadWorkersModule();
         if (workers?.WorkerInit !== undefined) {
             workerInit = workers.WorkerInit;

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;AAsEH,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;AAsPD;;;;;;;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;AAwEH,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;AAwPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}

package/src/cli/CLI.js

@@ -11,6 +11,7 @@ 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 { D1ProxyCommand } from './commands/D1ProxyCommand.js';
 import { DbSeedCommand } from './commands/DbSeedCommand.js';
 import { DebugCommand } from './commands/DebugCommand.js';
 import { DeployCommand } from './commands/DeployCommand.js';
@@ -28,6 +29,7 @@ import { InitProducerCommand } from './commands/InitProducerCommand.js';
 import { InitProxyCommand } from './commands/InitProxyCommand.js';
 import { JwtDevCommand } from './commands/JwtDevCommand.js';
 import { KeyGenerateCommand } from './commands/KeyGenerateCommand.js';
+import { KvProxyCommand } from './commands/KvProxyCommand.js';
 import { MakeMailTemplateCommand } from './commands/MakeMailTemplateCommand.js';
 import { MakeNotificationTemplateCommand } from './commands/MakeNotificationTemplateCommand.js';
 import { MigrateCommand } from './commands/MigrateCommand.js';
@@ -128,6 +130,8 @@ const buildCommandRegistry = () => {
         RoutesCommand.create(),
         JwtDevCommand,
         ProxyCommand.create(),
+        D1ProxyCommand.create(),
+        KvProxyCommand.create(),
         MySqlProxyCommand.create(),
         PostgresProxyCommand.create(),
         MongoDBProxyCommand.create(),

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"D1ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6LrE,eAAO,MAAM,cAAc;cACf,YAAY;EAmCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/D1ProxyCommand.js

@@ -0,0 +1,170 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { maybeRunProxyWatchMode } from '../commands/ProxyCommandUtils.js';
+import { SpawnUtil } from '../utils/spawn.js';
+import { Env } from '../../config/env.js';
+import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isNonEmptyString } from '../../helper/index.js';
+import { existsSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
+import { join } from '../../node-singletons/path.js';
+const DEFAULT_CONFIG = 'wrangler.jsonc';
+const DEFAULT_COMPATIBILITY_DATE = '2026-03-12';
+const DEFAULT_BINDING = 'ZIN_DB';
+const DEFAULT_DATABASE_NAME = 'd1-proxy-db';
+const DEFAULT_DATABASE_ID = '<your-d1-database-id>';
+const DEFAULT_MIGRATIONS_DIR = 'database/migrations/d1';
+const trimOption = (value) => {
+    if (!isNonEmptyString(value))
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+const resolveConfigPath = (raw) => {
+    const trimmed = trimOption(raw);
+    return trimmed ?? DEFAULT_CONFIG;
+};
+const findQuotedValue = (content, key) => {
+    const pattern = new RegExp(String.raw `"${key}"\s*:\s*"([^"]+)"`);
+    const match = pattern.exec(content);
+    return trimOption(match?.[1]);
+};
+const resolveConfigValues = (content, options) => {
+    const fileContent = content ?? '';
+    return {
+        binding: trimOption(options.binding) ??
+            trimOption(Env.get('D1_BINDING', '')) ??
+            findQuotedValue(fileContent, 'D1_BINDING') ??
+            findQuotedValue(fileContent, 'binding') ??
+            DEFAULT_BINDING,
+        databaseName: trimOption(options.databaseName) ??
+            trimOption(Env.get('D1_DATABASE_NAME', '')) ??
+            findQuotedValue(fileContent, 'database_name') ??
+            DEFAULT_DATABASE_NAME,
+        databaseId: trimOption(options.databaseId) ??
+            trimOption(Env.get('D1_DATABASE_ID', '')) ??
+            findQuotedValue(fileContent, 'database_id') ??
+            DEFAULT_DATABASE_ID,
+        migrationsDir: trimOption(options.migrationsDir) ??
+            findQuotedValue(fileContent, 'migrations_dir') ??
+            DEFAULT_MIGRATIONS_DIR,
+    };
+};
+const renderD1ProxyEnvBlock = (values) => {
+    return [
+        '    "d1-proxy": {',
+        '      "name": "zintrust-d1-proxy",',
+        '      "main": "./src/proxy/d1/ZintrustD1Proxy.ts",',
+        '      "compatibility_flags": ["nodejs_compat"],',
+        `      "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
+        '      "vars": {',
+        `        "D1_BINDING": "${values.binding}",`,
+        '        "ZT_PROXY_SIGNING_WINDOW_MS": "60000",',
+        '        "ZT_MAX_BODY_BYTES": "131072",',
+        '        "ZT_MAX_SQL_BYTES": "32768",',
+        '        "ZT_MAX_PARAMS": "256",',
+        '        "NODE_ENV": "development",',
+        String.raw `        "ZT_D1_STATEMENTS_JSON": "{\"health\":\"select 1 as ok\"}"`,
+        '      },',
+        '      "d1_databases": [',
+        '        {',
+        `          "binding": "${values.binding}",`,
+        `          "database_name": "${values.databaseName}",`,
+        `          "database_id": "${values.databaseId}",`,
+        `          "migrations_dir": "${values.migrationsDir}"`,
+        '        }',
+        '      ]',
+        '    }',
+    ].join('\n');
+};
+const renderDefaultWranglerConfig = (values) => {
+    return [
+        '{',
+        '  "name": "zintrust-api",',
+        '  "main": "./src/functions/cloudflare.ts",',
+        `  "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
+        '  "compatibility_flags": ["nodejs_compat"],',
+        '  "env": {',
+        renderD1ProxyEnvBlock(values),
+        '  }',
+        '}',
+        '',
+    ].join('\n');
+};
+const injectEnvBlock = (content, block) => {
+    if (/"d1-proxy"\s*:\s*\{/.test(content))
+        return content;
+    if (/"env"\s*:\s*\{\s*\}/m.test(content)) {
+        return content.replace(/"env"\s*:\s*\{\s*\}/m, `"env": {\n${block}\n  }`);
+    }
+    if (/"env"\s*:\s*\{/m.test(content)) {
+        return content.replace(/"env"\s*:\s*\{/m, (match) => `${match}\n${block},`);
+    }
+    const closingIndex = content.lastIndexOf('}');
+    if (closingIndex < 0) {
+        throw ErrorFactory.createCliError('Invalid wrangler.jsonc: missing closing brace.');
+    }
+    const before = content.slice(0, closingIndex).trimEnd();
+    const suffix = before.endsWith('{') ? '\n' : ',\n';
+    return `${before}${suffix}  "env": {\n${block}\n  }\n}\n`;
+};
+const ensureWranglerConfig = (configPath, options) => {
+    if (!existsSync(configPath)) {
+        const values = resolveConfigValues(undefined, options);
+        writeFileSync(configPath, renderDefaultWranglerConfig(values), 'utf-8');
+        return { createdFile: true, insertedEnv: true, values };
+    }
+    const content = readFileSync(configPath, 'utf-8');
+    const values = resolveConfigValues(content, options);
+    const next = injectEnvBlock(content, renderD1ProxyEnvBlock(values));
+    if (next !== content) {
+        writeFileSync(configPath, next, 'utf-8');
+        return { createdFile: false, insertedEnv: true, values };
+    }
+    return { createdFile: false, insertedEnv: false, values };
+};
+const warnOnPlaceholderDatabaseId = (values) => {
+    if (values.databaseId !== DEFAULT_DATABASE_ID)
+        return;
+    Logger.warn('Could not resolve a D1 database id automatically. Update wrangler.jsonc or pass --database-id before relying on the generated d1-proxy environment.');
+};
+const addOptions = (command) => {
+    command.option('-c, --config <path>', 'Wrangler config file', DEFAULT_CONFIG);
+    command.option('--watch', 'Auto-restart proxy on file changes');
+    command.option('--binding <name>', 'D1 binding name', DEFAULT_BINDING);
+    command.option('--database-name <name>', 'Cloudflare D1 database name');
+    command.option('--database-id <id>', 'Cloudflare D1 database id');
+    command.option('--migrations-dir <path>', 'Cloudflare D1 migrations directory', DEFAULT_MIGRATIONS_DIR);
+};
+export const D1ProxyCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'proxy:d1',
+            aliases: ['d1:proxy'],
+            description: 'Start the local Cloudflare D1 proxy Worker via Wrangler and scaffold env.d1-proxy in wrangler.jsonc when missing',
+            addOptions,
+            execute: async (options) => {
+                await maybeRunProxyWatchMode(options.watch);
+                const cwd = process.cwd();
+                const configPath = join(cwd, resolveConfigPath(options.config));
+                const result = ensureWranglerConfig(configPath, options);
+                if (result.createdFile) {
+                    Logger.info(`Created ${configPath} with a default d1-proxy environment.`);
+                }
+                else if (result.insertedEnv) {
+                    Logger.info(`Added env.d1-proxy to ${configPath}.`);
+                }
+                warnOnPlaceholderDatabaseId(result.values);
+                const exitCode = await SpawnUtil.spawnAndWait({
+                    command: 'wrangler',
+                    args: ['dev', '--config', configPath, '--env', 'd1-proxy'],
+                    env: process.env,
+                    forwardSignals: false,
+                });
+                if (exitCode !== 0) {
+                    process.exit(exitCode);
+                }
+            },
+        });
+    },
+});
+export default D1ProxyCommand;

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;AAyKlE,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;AA8MlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAqBtB,CAAC"}