@zintrust/core 0.1.18 → 0.1.19

package/src/scripts/TemplateSync.js

@@ -126,6 +126,12 @@ const rewriteStarterTemplateImports = (relPath, content) => {
     // Starter templates should import framework APIs from the public package surface,
     // not from internal path-alias modules that only exist in the framework repo.
     return (content
+        // Starter templates should not rely on local config/env wrappers.
+        // Normalize Env imports to come from the public package surface.
+        .replaceAll("from '../env';", "from '@zintrust/core';")
+        .replaceAll('from "../env";', 'from "@zintrust/core";')
+        .replaceAll("from './env';", "from '@zintrust/core';")
+        .replaceAll('from "./env";', 'from "@zintrust/core";')
         // Node-singletons are internal to this repo; starter templates should use Node built-ins.
         .replaceAll("'@node-singletons/fs'", "'node:fs'")
         .replaceAll('"@node-singletons/fs"', '"node:fs"')

package/src/start.d.ts

@@ -0,0 +1,21 @@
+export declare const isNodeMain: (importMetaUrl: string) => boolean;
+/**
+ * Start the Node server (dev/prod) by delegating to the framework bootstrap.
+ *
+ * This uses a non-literal dynamic import so Worker bundlers don't pull Node-only modules.
+ */
+export declare const start: () => Promise<void>;
+/**
+ * Cloudflare Workers entry (module worker style).
+ */
+export { default } from './functions/cloudflare';
+export { default as cloudflareWorker } from './functions/cloudflare';
+/**
+ * Deno fetch handler.
+ */
+export { default as deno } from './functions/deno';
+/**
+ * AWS Lambda handler.
+ */
+export { handler } from './functions/lambda';
+//# sourceMappingURL=start.d.ts.map

package/src/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/start.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,KAAG,OAYlD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAS1C,CAAC;AAEF;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/src/start.js

@@ -0,0 +1,60 @@
+const isNodeRuntime = () => {
+    // Avoid importing any `node:*` modules so this file remains Worker-safe.
+    // In Workers/Deno, `process` is typically undefined.
+    return (typeof process !== 'undefined' &&
+        typeof process === 'object' &&
+        process !== null &&
+        typeof process.versions === 'object');
+};
+const fileUrlToPathLike = (value) => {
+    if (!value.startsWith('file://'))
+        return value;
+    // Basic file URL decoding (sufficient for macOS/Linux paths).
+    try {
+        return decodeURIComponent(value.slice('file://'.length));
+    }
+    catch {
+        return value.slice('file://'.length);
+    }
+};
+export const isNodeMain = (importMetaUrl) => {
+    if (!isNodeRuntime())
+        return false;
+    const argv1 = process.argv;
+    const scriptPath = Array.isArray(argv1) ? String(argv1[1] ?? '') : '';
+    if (scriptPath === '')
+        return false;
+    const here = fileUrlToPathLike(importMetaUrl);
+    if (scriptPath === here)
+        return true;
+    // Best-effort: handle relative argv paths and runner wrappers.
+    return scriptPath.endsWith(here);
+};
+/**
+ * Start the Node server (dev/prod) by delegating to the framework bootstrap.
+ *
+ * This uses a non-literal dynamic import so Worker bundlers don't pull Node-only modules.
+ */
+export const start = async () => {
+    /* c8 ignore start */
+    if (!isNodeRuntime())
+        return;
+    // Compiled output places bootstrap at `dist/src/boot/bootstrap.js`.
+    // This file compiles to `dist/src/start.js`, so relative import is stable.
+    // In unit tests, importing bootstrap has heavy side effects (starts server + exits).
+    await import('./boot/' + 'bootstrap.js');
+    /* c8 ignore stop */
+};
+/**
+ * Cloudflare Workers entry (module worker style).
+ */
+export { default } from './functions/cloudflare.js';
+export { default as cloudflareWorker } from './functions/cloudflare.js';
+/**
+ * Deno fetch handler.
+ */
+export { default as deno } from './functions/deno.js';
+/**
+ * AWS Lambda handler.
+ */
+export { handler } from './functions/lambda.js';

package/src/templates/features/Queue.ts.tpl

@@ -1,7 +1,6 @@
 // TEMPLATE_START
 
-import { generateSecureJobId } from '@common/uuid';
-import { Logger } from '@config/logger';
+import { generateSecureJobId, Logger } from '@zintrust/core';
 
 export interface QueueJob {
   id: string;
@@ -44,4 +43,4 @@ export const Queue = Object.freeze({
   },
 });
 
-// TEMPLATE_END
+// TEMPLATE_END

package/src/templates/project/basic/.env.example.tpl

@@ -1,6 +1,6 @@
 NODE_ENV=development
 APP_NAME={{projectName}}
-APP_PORT={{port}}
+PORT={{port}}
 APP_DEBUG=true
 APP_KEY=
 

package/src/templates/project/basic/app/Controllers/UserController.ts.tpl

@@ -3,10 +3,8 @@
  * Example controller demonstrating request handling
  */
 
-import { User } from '../Models/User';
-import { Logger } from '@zintrust/core';
-import { IRequest } from '@zintrust/core';
-import { IResponse } from '@zintrust/core';
+import { User } from '@app/Models/User';
+import { IRequest, Logger, IResponse } from '@zintrust/core';
 
 /**
  * User Controller Interface

package/src/templates/project/basic/app/Middleware/ProfilerMiddleware.ts.tpl

@@ -4,9 +4,7 @@
  * Enables request profiling when ENABLE_PROFILER environment variable is set
  */
 
-import { Logger } from '@zintrust/core';
-import { Middleware } from '@zintrust/core';
-import { RequestProfiler } from '@zintrust/core';
+import { Middleware, Logger , RequestProfiler} from '@zintrust/core';
 
 /**
  * ProfilerMiddleware wraps request execution with performance profiling

package/src/templates/project/basic/app/Middleware/index.ts.tpl

@@ -1,16 +1,11 @@
-import type { CsrfTokenManagerType, ICsrfTokenManager } from '@zintrust/core';
-import type { IJwtManager, JwtAlgorithm, JwtManagerType } from '@zintrust/core';
 /**
  * Example Middleware
  * Common middleware patterns for Zintrust
  */
 
-import { Logger } from '@zintrust/core';
-import { IRequest } from '@zintrust/core';
-import { IResponse } from '@zintrust/core';
-import { XssProtection } from '@zintrust/core';
-import type { ISchema, SchemaType } from '@zintrust/core';
-import { Validator } from '@zintrust/core';
+import type { IJwtManager, JwtAlgorithm, JwtManagerType, ISchema, SchemaType, CsrfTokenManagerType, ICsrfTokenManager } from '@zintrust/core';
+import { Logger , Validator, IRequest, IResponse, XssProtection} from '@zintrust/core';
+
 
 type JwtManagerInput = IJwtManager | JwtManagerType;
 type CsrfManagerInput = ICsrfTokenManager | CsrfTokenManagerType;

package/src/templates/project/basic/app/Models/Post.ts.tpl

@@ -2,9 +2,8 @@
  * Example Post Model
  */
 
-import { IRelationship } from '@zintrust/core';
-import { User } from './User';
-import { IModel, Model, ModelConfig } from '@zintrust/core';
+import { User } from '@app/Models/User';
+import { IModel, Model, ModelConfig, IRelationship } from '@zintrust/core';
 
 export const PostConfig: ModelConfig = {
   table: 'posts',

package/src/templates/project/basic/app/Models/User.ts.tpl

@@ -2,7 +2,7 @@
  * User Model
  */
 
-import { Post } from './Post';
+import { Post } from '@app/Models/Post';
 import { IModel, Model } from '@zintrust/core';
 
 /**

package/src/templates/project/basic/config/FileLogWriter.ts.tpl

@@ -6,7 +6,7 @@
  */
 
 import { ensureDirSafe } from '@zintrust/core';
-import { Env } from './env';
+import { Env } from '@zintrust/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 

package/src/templates/project/basic/config/SecretsManager.ts.tpl

@@ -4,13 +4,13 @@
  * Supports: AWS Secrets Manager, Parameter Store, Cloudflare KV, Deno env
  */
 
-import { Logger } from './logger';
+import { Logger } from '@zintrust/core';
 import type {
   GetSecretOptions,
   SecretConfig,
   SecretsManagerInstance,
   SetSecretOptions,
-} from './type';
+} from '@zintrust/core';
 import { ErrorFactory } from '@zintrust/core';
 
 let instance: SecretsManagerInstance | undefined;

package/src/templates/project/basic/config/StartupConfigValidator.ts.tpl

@@ -1,5 +1,5 @@
-import { appConfig } from './app';
-import type { StartupConfigValidationError, StartupConfigValidationResult } from './type';
+import { appConfig } from '@zintrust/core';
+import type { StartupConfigValidationError, StartupConfigValidationResult } from '@zintrust/core';
 import { ErrorFactory } from '@zintrust/core';
 
 const isSensitiveKey = (key: string): boolean => {

package/src/templates/project/basic/config/app.ts.tpl

@@ -4,8 +4,8 @@
  * Sealed namespace for immutability
  */
 
-import { Env } from './env';
-import type { Environment, ProcessLike, StartMode } from './type';
+import { Env } from '@zintrust/core';
+import type { Environment, ProcessLike, StartMode } from '@zintrust/core';
 
 const getProcessLike = (): ProcessLike | undefined => {
   return typeof process === 'undefined' ? undefined : (process as unknown as ProcessLike);
@@ -99,7 +99,7 @@ const appConfigObj = {
   port:
     typeof (Env as unknown as { PORT?: unknown }).PORT === 'number'
       ? (Env as unknown as { PORT: number }).PORT
-      : readEnvInt('APP_PORT', 3000),
+      : readEnvInt('PORT', readEnvInt('APP_PORT', 3000)),
 
   /**
    * Application host

package/src/templates/project/basic/config/broadcast.ts.tpl

@@ -5,8 +5,7 @@
  * Driver selection must be dynamic (tests may mutate process.env).
  */
 
-import { Env } from './env';
-import {
+import  type{
   BroadcastConfigInput,
   BroadcastDrivers,
   InMemoryBroadcastDriverConfig,
@@ -14,13 +13,13 @@ import {
   PusherBroadcastDriverConfig,
   RedisBroadcastDriverConfig,
   RedisHttpsBroadcastDriverConfig,
-} from './type';
-import { ErrorFactory } from '@zintrust/core';
+} from '@zintrust/core';
+import { ErrorFactory,Env } from '@zintrust/core';
 
 const normalizeDriverName = (value: string): string => value.trim().toLowerCase();
 
 const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
-  return Object.prototype.hasOwnProperty.call(obj, key);
+  return Object.hasOwn(obj, key);
 };
 
 const getDefaultBroadcaster = (drivers: BroadcastDrivers): string => {

package/src/templates/project/basic/config/cache.ts.tpl

@@ -4,9 +4,8 @@
  * Sealed namespace for immutability
  */
 
-import { Env } from './env';
-import { CacheConfigInput, CacheDriverConfig } from './type';
-import { ErrorFactory } from '@zintrust/core';
+import type { CacheConfigInput, CacheDriverConfig } from '@zintrust/core';
+import { ErrorFactory , Env} from '@zintrust/core';
 
 const getCacheDriver = (config: CacheConfigInput, name?: string): CacheDriverConfig => {
   const selected = String(name ?? config.default).trim();

package/src/templates/project/basic/config/cloudflare.ts.tpl

@@ -5,7 +5,7 @@
  * This keeps runtime-specific globals out of adapters/drivers.
  */
 
-import { KVNamespace, WorkersEnv } from './type';
+import type { KVNamespace, WorkersEnv } from '@zintrust/core';
 import type { DatabaseConfig, ID1Database } from '@zintrust/core';
 
 const getWorkersEnv = (): WorkersEnv | null => {

package/src/templates/project/basic/config/database.ts.tpl

@@ -4,12 +4,12 @@
  * Sealed namespace for immutability
  */
 
-import { Env } from './env';
-import { DatabaseConfigShape, DatabaseConnectionConfig, DatabaseConnections } from './type';
+import { Env } from '@zintrust/core';
+import type { DatabaseConfigShape, DatabaseConnectionConfig, DatabaseConnections } from '@zintrust/core';
 import { ErrorFactory } from '@zintrust/core';
 
 const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
-  return Object.prototype.hasOwnProperty.call(obj, key);
+  return Object.hasOwn(obj, key);
 };
 
 const getDefaultConnection = (connections: DatabaseConnections): string => {
@@ -48,6 +48,12 @@ const connections = {
     database: Env.DB_DATABASE,
     migrations: 'database/migrations',
   },
+  d1: {
+    driver: 'd1' as const,
+  },
+  'd1-remote': {
+    driver: 'd1-remote' as const,
+  },
   postgresql: {
     driver: 'postgresql' as const,
     host: Env.DB_HOST,

package/src/templates/project/basic/config/env.ts.tpl

@@ -6,7 +6,7 @@
  * Safe for both Node.js and serverless runtimes (Cloudflare Workers, Deno, Lambda)
  */
 
-import { ProcessLike } from './type';
+import type { ProcessLike } from '@zintrust/core';
 
 const getProcessLike = (): ProcessLike | undefined => {
   return typeof process === 'undefined' ? undefined : (process as unknown as ProcessLike);

package/src/templates/project/basic/config/features.ts.tpl

@@ -1,5 +1,5 @@
-import { Env } from './env';
-import { Logger } from './logger';
+import { Env } from '@zintrust/core';
+import { Logger } from '@zintrust/core';
 
 /**
  * Feature Flags State

package/src/templates/project/basic/config/index.ts.tpl

@@ -3,27 +3,45 @@
  * Central export point for all configuration
  */
 
-import { appConfig } from './app';
-import broadcastConfig from './broadcast';
-import { cacheConfig } from './cache';
-import { databaseConfig } from './database';
-import { microservicesConfig } from './microservices';
-import { middlewareConfig } from './middleware';
-import notificationConfig from './notification';
-import { queueConfig } from './queue';
-import { securityConfig } from './security';
-import { storageConfig } from './storage';
+import {
+  appConfig,
+  broadcastConfig,
+  cacheConfig,
+  databaseConfig,
+  microservicesConfig,
+  middlewareConfig,
+  notificationConfig,
+  queueConfig,
+  securityConfig,
+  storageConfig,
+} from '@zintrust/core';
 
-export { appConfig, type AppConfig } from './app';
-export { default as broadcastConfig } from './broadcast';
-export { cacheConfig, type CacheConfig } from './cache';
-export { databaseConfig, type DatabaseConfig } from './database';
-export { microservicesConfig, type MicroservicesConfig } from './microservices';
-export { middlewareConfig } from './middleware';
-export { notificationConfig, type NotificationConfig } from './notification';
-export { queueConfig, type QueueConfig } from './queue';
-export { securityConfig } from './security';
-export { storageConfig, type StorageConfig } from './storage';
+export {
+  appConfig,
+  broadcastConfig,
+  cacheConfig,
+  databaseConfig,
+  microservicesConfig,
+  middlewareConfig,
+  notificationConfig,
+  queueConfig,
+  securityConfig,
+  storageConfig,
+} from '@zintrust/core';
+
+export type {
+  AppConfig,
+  CacheConfig,
+  MicroservicesConfig,
+  QueueConfig,
+  StorageConfig,
+} from '@zintrust/core';
+
+// Core exports this as `DatabaseRuntimeConfig`; keep template API stable.
+export type { DatabaseRuntimeConfig as DatabaseConfig } from '@zintrust/core';
+
+export type BroadcastConfig = typeof broadcastConfig;
+export type NotificationConfig = typeof notificationConfig;
 
 /**
  * Combined configuration object