@zintrust/core 0.1.19 → 0.1.21

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

@@ -1,55 +1,15 @@
+import { Env, type CacheConfigOverrides } from '@zintrust/core';
+
 /**
- * Cache Configuration
- * Caching drivers and settings
- * Sealed namespace for immutability
+ * Cache Configuration (default override)
+ *
+ * Keep this file declarative:
+ * - Core owns env parsing/default logic.
+ * - Projects can override config by editing values below.
  */
 
-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();
-  const storeName = selected === 'default' ? String(config.default).trim() : selected;
-  const isExplicitSelection =
-    name !== undefined && String(name).trim().length > 0 && String(name).trim() !== 'default';
-
-  if (storeName.length > 0 && Object.hasOwn(config.drivers, storeName)) {
-    const resolved = (config.drivers as Record<string, CacheDriverConfig>)[storeName];
-    if (resolved !== undefined) return resolved;
-  }
-
-  if (isExplicitSelection) {
-    throw ErrorFactory.createConfigError(`Cache store not configured: ${storeName}`);
-  }
-
-  if (Object.keys(config.drivers ?? {}).length === 0) {
-    throw ErrorFactory.createConfigError('No cache stores are configured');
-  }
-
-  throw ErrorFactory.createConfigError(
-    `Cache default store not configured: ${storeName || '<empty>'}`
-  );
-};
-
-const cacheConfigObj = {
-  /**
-   * Default cache driver
-   */
-  default: (() => {
-    const envConnection = Env.get('CACHE_CONNECTION', '').trim();
-
-    const envDriver =
-      typeof (Env as unknown as { CACHE_DRIVER?: unknown }).CACHE_DRIVER === 'string'
-        ? String((Env as unknown as { CACHE_DRIVER?: unknown }).CACHE_DRIVER)
-        : Env.get('CACHE_DRIVER', 'memory');
-
-    const selected = envConnection.length > 0 ? envConnection : String(envDriver ?? 'memory');
-    return selected.trim().toLowerCase();
-  })(),
-
-  /**
-   * Cache drivers
-   */
+export default {
+  default: Env.get('CACHE_CONNECTION', Env.get('CACHE_DRIVER', 'memory')).trim().toLowerCase(),
   drivers: {
     memory: {
       driver: 'memory' as const,
@@ -63,7 +23,7 @@ const cacheConfigObj = {
     },
     mongodb: {
       driver: 'mongodb' as const,
-      uri: Env.get('MONGO_URI'),
+      uri: Env.get('MONGO_URI', ''),
       db: Env.get('MONGO_DB', 'zintrust_cache'),
       ttl: Env.getInt('CACHE_MONGO_TTL', 3600),
     },
@@ -76,24 +36,6 @@ const cacheConfigObj = {
       ttl: Env.getInt('CACHE_KV_TTL', 3600),
     },
   },
-
-  /**
-   * Get cache driver config
-   */
-  getDriver(name?: string): CacheDriverConfig {
-    return getCacheDriver(this, name);
-  },
-
-  /**
-   * Key prefix for all cache keys
-   */
   keyPrefix: Env.get('CACHE_KEY_PREFIX', 'zintrust:'),
-
-  /**
-   * Default cache TTL (seconds)
-   */
-  ttl: Env.getInt('CACHE_DEFAULT_TTL', 3600),
-};
-
-export const cacheConfig = Object.freeze(cacheConfigObj);
-export type CacheConfig = typeof cacheConfig;
+  ttl: Env.getInt('CACHE_TTL', 3600),
+} satisfies CacheConfigOverrides;

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

@@ -1,43 +1,8 @@
 /**
- * Cloudflare Workers Environment Access
+ * Cloudflare Workers helpers (template)
  *
- * Centralizes access to Workers bindings via globalThis.env.
- * This keeps runtime-specific globals out of adapters/drivers.
+ * Keep this file declarative:
+ * - Core owns runtime-specific binding logic.
  */
 
-import type { KVNamespace, WorkersEnv } from '@zintrust/core';
-import type { DatabaseConfig, ID1Database } from '@zintrust/core';
-
-const getWorkersEnv = (): WorkersEnv | null => {
-  const env = (globalThis as unknown as { env?: unknown }).env;
-  if (env === undefined || env === null) return null;
-  if (typeof env !== 'object') return null;
-  return env as WorkersEnv;
-};
-
-const getD1Binding = (config: DatabaseConfig): ID1Database | null => {
-  if (config.d1 !== undefined && config.d1 !== null) return config.d1;
-
-  const env = getWorkersEnv();
-  const envDb = env === null ? undefined : (env['DB'] as ID1Database | undefined);
-  if (envDb !== undefined) return envDb;
-
-  const globalDb = (globalThis as unknown as { DB?: ID1Database }).DB;
-  if (globalDb !== undefined) return globalDb;
-
-  return null;
-};
-
-const getKVBinding = (bindingName = 'CACHE'): KVNamespace | null => {
-  const env = getWorkersEnv();
-  if (env === null) return null;
-
-  const kv = env[bindingName] as KVNamespace | undefined;
-  return kv ?? null;
-};
-
-export const Cloudflare = Object.freeze({
-  getWorkersEnv,
-  getD1Binding,
-  getKVBinding,
-});
+export { Cloudflare } from '@zintrust/core';

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

@@ -1,70 +1,14 @@
 /**
- * Framework Constants
- * Centralized string literals to prevent duplication (SonarQube S1192)
- * Sealed namespace for immutability
+ * Framework Constants (template)
+ *
+ * Keep this file declarative:
+ * - Core owns canonical constants.
  */
 
-const HTTP_HEADERS = {
-  CONTENT_TYPE: 'Content-Type',
-  ACCEPT: 'Accept',
-  AUTHORIZATION: 'Authorization',
-  X_TRACE_ID: 'X-Trace-Id',
-  X_SERVICE_CALL: 'X-Service-Call',
-  X_POWERED_BY: 'X-Powered-By',
-  X_CONTENT_TYPE_OPTIONS: 'X-Content-Type-Options',
-  X_FRAME_OPTIONS: 'X-Frame-Options',
-  X_XSS_PROTECTION: 'X-XSS-Protection',
-  REFERRER_POLICY: 'Referrer-Policy',
-  CONTENT_SECURITY_POLICY: 'Content-Security-Policy',
-} as const;
-
-const MIME_TYPES = {
-  JSON: 'application/json',
-  HTML: 'text/html',
-  TEXT: 'text/plain',
-  JS: 'text/javascript',
-  CSS: 'text/css',
-  PNG: 'image/png',
-  JPG: 'image/jpg',
-  GIF: 'image/gif',
-  SVG: 'image/svg+xml',
-  WAV: 'audio/wav',
-  MP4: 'video/mp4',
-  WOFF: 'application/font-woff',
-  TTF: 'application/font-ttf',
-  EOT: 'application/vnd.ms-fontobject',
-  OTF: 'application/font-otf',
-  WASM: 'application/wasm',
-} as const;
-
-const ENV_KEYS = {
-  NODE_ENV: 'NODE_ENV',
-  PORT: 'PORT',
-  HOST: 'HOST',
-  APP_NAME: 'APP_NAME',
-  DB_CONNECTION: 'DB_CONNECTION',
-  DB_HOST: 'DB_HOST',
-  DB_PORT: 'DB_PORT',
-  DB_DATABASE: 'DB_DATABASE',
-  DB_USERNAME: 'DB_USERNAME',
-  DB_PASSWORD: 'DB_PASSWORD', // NOSONARQUBE
-} as const;
-
-const DEFAULTS = {
-  CONNECTION: 'default',
-  DOMAIN: 'default',
-  NAMESPACE: 'default',
-} as const;
-
-/**
- * Constants namespace - sealed for immutability
- */
-export const Constants = Object.freeze({
+export {
+  Constants,
+  DEFAULTS,
+  ENV_KEYS,
   HTTP_HEADERS,
   MIME_TYPES,
-  ENV_KEYS,
-  DEFAULTS,
-});
-
-// Re-export for backward compatibility
-export { DEFAULTS, ENV_KEYS, HTTP_HEADERS, MIME_TYPES };
+} from '@zintrust/core';

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

@@ -1,131 +1,74 @@
+import { Env, type DatabaseConfigOverrides } from '@zintrust/core';
+
 /**
- * Database Configuration
- * Database connections and pooling settings
- * Sealed namespace for immutability
+ * Database Configuration (default override)
+ *
+ * Keep this file declarative:
+ * - Core owns driver setup and env parsing/default logic.
+ * - Projects can override config by editing values below.
  */
 
-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.hasOwn(obj, key);
-};
-
-const getDefaultConnection = (connections: DatabaseConnections): string => {
-  const envSelectedRaw = Env.get('DB_CONNECTION', '');
-  const value = String(envSelectedRaw ?? '').trim();
-
-  if (value.length > 0 && hasOwn(connections, value)) return value;
-
-  if (envSelectedRaw.trim().length > 0) {
-    throw ErrorFactory.createConfigError(`Database connection not configured: ${value}`);
-  }
-
-  return hasOwn(connections, 'sqlite') ? 'sqlite' : (Object.keys(connections)[0] ?? 'sqlite');
-};
-
-const getDatabaseConnection = (config: DatabaseConfigShape): DatabaseConnectionConfig => {
-  const connName = config.default;
-  const resolved = config.connections[connName];
-  if (resolved !== undefined) return resolved;
-
-  // Backwards-compatible fallback.
-  const sqliteFallback = config.connections['sqlite'];
-  if (sqliteFallback !== undefined) return sqliteFallback;
-
-  const first = Object.values(config.connections)[0];
-  if (first !== undefined) return first;
-
-  throw ErrorFactory.createConfigError(
-    `No database connections are configured (default='${connName}').`
-  );
+const parseReadHosts = (raw: string): string[] | undefined => {
+  const list = String(raw ?? '')
+    .split(',')
+    .map((v) => v.trim())
+    .filter((v) => v.length > 0);
+  return list.length > 0 ? list : undefined;
 };
 
-const connections = {
-  sqlite: {
-    driver: 'sqlite' as const,
-    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,
-    port: Env.DB_PORT,
-    database: Env.DB_DATABASE,
-    username: Env.DB_USERNAME,
-    password: Env.DB_PASSWORD,
-    ssl: Env.getBool('DB_SSL', false),
-    pooling: {
-      enabled: Env.getBool('DB_POOLING', true),
-      min: Env.getInt('DB_POOL_MIN', 5),
-      max: Env.getInt('DB_POOL_MAX', 20),
-      idleTimeout: Env.getInt('DB_IDLE_TIMEOUT', 30000),
-      connectionTimeout: Env.getInt('DB_CONNECTION_TIMEOUT', 10000),
+export default {
+  default: Env.get('DB_CONNECTION', 'mysql'),
+  connections: {
+    sqlite: {
+      driver: 'sqlite' as const,
+      database: 'database/sqlite.db',
+      migrations: 'database/migrations',
     },
-  },
-  mysql: {
-    driver: 'mysql' as const,
-    host: Env.DB_HOST,
-    port: Env.DB_PORT,
-    database: Env.DB_DATABASE,
-    username: Env.DB_USERNAME,
-    password: Env.DB_PASSWORD,
-    pooling: {
-      enabled: Env.getBool('DB_POOLING', true),
-      min: Env.getInt('DB_POOL_MIN', 5),
-      max: Env.getInt('DB_POOL_MAX', 20),
+    postgresql: {
+      driver: 'postgresql' as const,
+      host: Env.get('DB_HOST', 'localhost'),
+      port: Env.getInt('DB_PORT_POSTGRESQL', 5432),
+      database: Env.get('DB_DATABASE_POSTGRESQL', 'postgres'),
+      username: Env.get('DB_USERNAME_POSTGRESQL', 'postgres'),
+      password: Env.get('DB_PASSWORD_POSTGRESQL', 'pass'),
+      ssl: Env.getBool('DB_SSL', false),
+      readHosts: parseReadHosts(Env.get('DB_READ_HOSTS_POSTGRESQL', '127.0.0.1')),
+      pooling: {
+        enabled: Env.getBool('DB_POOLING', true),
+        min: Env.getInt('DB_POOL_MIN', 5),
+        max: Env.getInt('DB_POOL_MAX', 20),
+        idleTimeout: Env.getInt('DB_IDLE_TIMEOUT', 30000),
+        connectionTimeout: Env.getInt('DB_CONNECTION_TIMEOUT', 10000),
+      },
+    },
+    mysql: {
+      driver: 'mysql' as const,
+      host: Env.get('DB_HOST', 'localhost'),
+      port: Env.getInt('DB_PORT', 3306),
+      database: Env.get('DB_DATABASE', 'zintrust'),
+      username: Env.get('DB_USERNAME', 'root'),
+      password: Env.get('DB_PASSWORD', 'pass'),
+      readHosts: parseReadHosts(Env.get('DB_READ_HOSTS', '127.0.0.1')),
+      pooling: {
+        enabled: Env.getBool('DB_POOLING', true),
+        min: Env.getInt('DB_POOL_MIN', 5),
+        max: Env.getInt('DB_POOL_MAX', 20),
+      },
+    },
+    sqlserver: {
+      driver: 'sqlserver' as const,
+      host: Env.get('DB_HOST_MSSQL', Env.get('DB_HOST', 'localhost')),
+      port: Env.getInt('DB_PORT_MSSQL', 1433),
+      database: Env.get('DB_DATABASE_MSSQL', 'zintrust'),
+      username: Env.get('DB_USERNAME_MSSQL', 'sa'),
+      password: Env.get('DB_PASSWORD_MSSQL', 'pass'),
+      readHosts: parseReadHosts(Env.get('DB_READ_HOSTS_MSSQL', '127.0.0.1')),
+    },
+    d1: {
+      driver: 'd1' as const,
+    },
+    'd1-remote': {
+      driver: 'd1-remote' as const,
     },
   },
-} satisfies DatabaseConnections;
-
-const databaseConfigObj = {
-  /**
-   * Default database connection
-   */
-  default: getDefaultConnection(connections),
-
-  /**
-   * Database connections
-   */
-  connections,
-
-  /**
-   * Get current connection config
-   */
-  getConnection(this: DatabaseConfigShape): DatabaseConnectionConfig {
-    return getDatabaseConnection(this);
-  },
-
-  /**
-   * Enable query logging
-   */
-  logging: {
-    enabled: Env.DEBUG,
-    level: Env.get('DB_LOG_LEVEL', 'debug'),
-  },
-
-  /**
-   * Migration settings
-   */
-  migrations: {
-    directory: 'database/migrations',
-    extension: Env.get('DB_MIGRATION_EXT', '.ts'),
-  },
-
-  /**
-   * Seeding settings
-   */
-  seeders: {
-    directory: 'database/seeders',
-  },
-};
-
-export const databaseConfig = Object.freeze(databaseConfigObj);
-export type DatabaseConfig = typeof databaseConfig;
+} satisfies DatabaseConfigOverrides;

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

@@ -1,173 +1,9 @@
 /**
- * Environment Configuration
- * Type-safe access to environment variables
+ * Environment Configuration (template)
  *
- * Sealed namespace pattern - all exports through Env namespace
- * Safe for both Node.js and serverless runtimes (Cloudflare Workers, Deno, Lambda)
+ * Keep this file declarative:
+ * - Core owns env parsing/default logic.
+ * - Projects should import `Env` from here (re-exported from core).
  */
 
-import type { ProcessLike } from '@zintrust/core';
-
-const getProcessLike = (): ProcessLike | undefined => {
-  return typeof process === 'undefined' ? undefined : (process as unknown as ProcessLike);
-};
-
-const dirnameFromExecPath = (execPath: string, platform?: string): string => {
-  const separator = platform === 'win32' ? '\\' : '/';
-  const lastSep = execPath.lastIndexOf(separator);
-  if (lastSep <= 0) return '';
-  return execPath.slice(0, lastSep);
-};
-
-// Private helper functions
-const get = (key: string, defaultValue?: string): string => {
-  const proc = getProcessLike();
-  const env = proc?.env ?? {};
-  return env[key] ?? defaultValue ?? '';
-};
-
-const getInt = (key: string, defaultValue?: number): number => {
-  const proc = getProcessLike();
-  const env = proc?.env ?? {};
-  const value = env[key];
-  if (value === undefined || value === null) return defaultValue ?? 0;
-  if (typeof value === 'string' && value.trim() === '') return defaultValue ?? 0;
-  return Number.parseInt(value, 10);
-};
-
-const getBool = (key: string, defaultValue?: boolean): boolean => {
-  const proc = getProcessLike();
-  const env = proc?.env ?? {};
-  const value = env[key];
-  if (value === undefined || value === null) return defaultValue ?? false;
-  return value.toLowerCase() === 'true' || value === '1';
-};
-
-const getDefaultLogLevel = (): 'debug' | 'info' | 'warn' | 'error' => {
-  const NODE_ENV_VALUE = get('NODE_ENV', 'development');
-  if (NODE_ENV_VALUE === 'production') return 'info';
-  if (NODE_ENV_VALUE === 'testing') return 'error';
-  return 'debug';
-};
-
-// Sealed namespace with all environment configuration
-export const Env = Object.freeze({
-  // Helper functions
-  get,
-  getInt,
-  getBool,
-
-  // Core
-  NODE_ENV: get('NODE_ENV', 'development'),
-  // Prefer PORT, fallback to APP_PORT for compatibility
-  PORT: getInt('PORT', getInt('APP_PORT', 3000)),
-  HOST: get('HOST', 'localhost'),
-  APP_NAME: get('APP_NAME', 'ZinTrust'),
-  APP_KEY: get('APP_KEY', ''),
-  // Optional key rotation support (comma-separated or JSON array of keys)
-  APP_PREVIOUS_KEYS: get('APP_PREVIOUS_KEYS', ''),
-
-  // Database
-  DB_CONNECTION: get('DB_CONNECTION', 'sqlite'),
-  DB_HOST: get('DB_HOST', 'localhost'),
-  DB_PORT: getInt('DB_PORT', 5432),
-  // Accept DB_PATH as an alias for sqlite file path (many env templates use it).
-  DB_DATABASE: get('DB_DATABASE', get('DB_PATH', 'zintrust')),
-  DB_USERNAME: get('DB_USERNAME', 'postgres'),
-  DB_PASSWORD: get('DB_PASSWORD', ''),
-  DB_READ_HOSTS: get('DB_READ_HOSTS', ''),
-
-  // Cloudflare
-  D1_DATABASE_ID: get('D1_DATABASE_ID'),
-  KV_NAMESPACE_ID: get('KV_NAMESPACE_ID'),
-
-  // Cloudflare proxy services (D1/KV outside Cloudflare)
-  D1_REMOTE_URL: get('D1_REMOTE_URL', ''),
-  D1_REMOTE_KEY_ID: get('D1_REMOTE_KEY_ID', ''),
-  D1_REMOTE_SECRET: get('D1_REMOTE_SECRET', ''),
-  D1_REMOTE_MODE: get('D1_REMOTE_MODE', 'registry'),
-
-  KV_REMOTE_URL: get('KV_REMOTE_URL', ''),
-  KV_REMOTE_KEY_ID: get('KV_REMOTE_KEY_ID', ''),
-  KV_REMOTE_SECRET: get('KV_REMOTE_SECRET', ''),
-  KV_REMOTE_NAMESPACE: get('KV_REMOTE_NAMESPACE', ''),
-
-  // Proxy client tuning
-  ZT_PROXY_SIGNING_WINDOW_MS: getInt('ZT_PROXY_SIGNING_WINDOW_MS', 60000),
-  ZT_PROXY_TIMEOUT_MS: getInt('ZT_PROXY_TIMEOUT_MS', 30000),
-
-  // Cache
-  CACHE_DRIVER: get('CACHE_DRIVER', 'memory'),
-  REDIS_HOST: get('REDIS_HOST', 'localhost'),
-  REDIS_PORT: getInt('REDIS_PORT', 6379),
-  REDIS_PASSWORD: get('REDIS_PASSWORD', ''),
-  MONGO_URI: get('MONGO_URI'),
-  MONGO_DB: get('MONGO_DB', 'zintrust_cache'),
-
-  // AWS
-  AWS_REGION: get('AWS_REGION', 'us-east-1'),
-  AWS_LAMBDA_FUNCTION_NAME: get('AWS_LAMBDA_FUNCTION_NAME'),
-  AWS_LAMBDA_FUNCTION_VERSION: get('AWS_LAMBDA_FUNCTION_VERSION'),
-  AWS_EXECUTION_ENV: get('AWS_EXECUTION_ENV'),
-  LAMBDA_TASK_ROOT: get('LAMBDA_TASK_ROOT'),
-
-  // Microservices
-  MICROSERVICES: get('MICROSERVICES'),
-  SERVICES: get('SERVICES'),
-  MICROSERVICES_TRACING: getBool('MICROSERVICES_TRACING'),
-  MICROSERVICES_TRACING_RATE: Number.parseFloat(get('MICROSERVICES_TRACING_RATE', '1.0')),
-  DATABASE_ISOLATION: get('DATABASE_ISOLATION', 'shared'),
-  SERVICE_API_KEY: get('SERVICE_API_KEY'),
-  SERVICE_JWT_SECRET: get('SERVICE_JWT_SECRET'),
-
-  // Security
-  DEBUG: getBool('DEBUG', false),
-  ENABLE_MICROSERVICES: getBool('ENABLE_MICROSERVICES', false),
-  TOKEN_TTL: getInt('TOKEN_TTL', 3600000),
-  TOKEN_LENGTH: getInt('TOKEN_LENGTH', 32),
-
-  // Encryption interop
-  ENCRYPTION_CIPHER: get('ENCRYPTION_CIPHER', ''),
-
-  // Deployment
-  ENVIRONMENT: get('ENVIRONMENT', 'development'),
-  REQUEST_TIMEOUT: getInt('REQUEST_TIMEOUT', 30000),
-  MAX_BODY_SIZE: getInt('MAX_BODY_SIZE', 10485760),
-  SHUTDOWN_TIMEOUT: getInt('SHUTDOWN_TIMEOUT', 10000),
-
-  // Logging
-  LOG_LEVEL: get('LOG_LEVEL', getDefaultLogLevel()) as 'debug' | 'info' | 'warn' | 'error',
-  LOG_FORMAT: get('LOG_FORMAT', 'text'),
-  DISABLE_LOGGING: getBool('DISABLE_LOGGING', false),
-  LOG_HTTP_REQUEST: getBool('LOG_HTTP_REQUEST', false),
-  LOG_TO_FILE: getBool('LOG_TO_FILE', false),
-  LOG_ROTATION_SIZE: getInt('LOG_ROTATION_SIZE', 10485760),
-  LOG_ROTATION_DAYS: getInt('LOG_ROTATION_DAYS', 7),
-
-  // Paths (safely constructed for Node.js environments)
-  NODE_BIN_DIR: (() => {
-    try {
-      const proc = getProcessLike();
-      if (proc?.execPath === null || proc?.execPath === undefined) return '';
-      return dirnameFromExecPath(proc.execPath, proc.platform);
-    } catch {
-      // Fallback for non-Node environments
-      return '';
-    }
-  })(),
-  SAFE_PATH: (() => {
-    try {
-      const proc = getProcessLike();
-      if (proc?.execPath === null || proc?.execPath === undefined) return '';
-
-      const binDir = dirnameFromExecPath(proc.execPath, proc.platform);
-      if (proc.platform === 'win32') {
-        return [String.raw`C:\Windows\System32`, String.raw`C:\Windows`, binDir].join(';');
-      }
-      return ['/usr/bin', '/bin', '/usr/sbin', '/sbin', binDir].join(':');
-    } catch {
-      // Fallback for non-Node environments
-      return '';
-    }
-  })(),
-});
+export { Env } from '@zintrust/core';

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

@@ -1,57 +1,9 @@
-import { Env } from '@zintrust/core';
-import { Logger } from '@zintrust/core';
-
-/**
- * Feature Flags State
- * Internal state managed by the module
- */
-let _rawQueryEnabled = false;
-
 /**
- * Feature Flags - Controls access to advanced/experimental features
- * Sealed namespace for immutability
+ * Feature Flags (template)
+ *
+ * Keep this file declarative:
+ * - Core owns runtime feature flag behavior.
  */
-export const FeatureFlags = Object.freeze({
-  /**
-   * Initialize all feature flags from environment
-   * Called once during application bootstrap
-   */
-  initialize(): void {
-    _rawQueryEnabled = Env.get('USE_RAW_QRY') === 'true';
-
-    if (_rawQueryEnabled) {
-      Logger.warn(
-        '⚠️  FEATURE FLAG ENABLED: Raw SQL Queries are now available via adapter.rawQuery()'
-      );
-      Logger.warn('⚠️  This bypasses QueryBuilder safety - use only when necessary');
-      Logger.warn('⚠️  Ensure parameters are properly bound to prevent SQL injection');
-    } else {
-      Logger.info('🔒 Raw SQL Queries are DISABLED (default, recommended for production)');
-    }
-  },
-
-  /**
-   * Check if raw queries are enabled
-   * Returns cached flag value (no environment lookup)
-   */
-  isRawQueryEnabled(): boolean {
-    return _rawQueryEnabled;
-  },
-
-  /**
-   * Reset flags (primarily for testing)
-   */
-  reset(): void {
-    _rawQueryEnabled = false;
-  },
-
-  /**
-   * Set raw query enabled state
-   * Primarily for testing to avoid 'as any' type casting
-   */
-  setRawQueryEnabled(enabled: boolean): void {
-    _rawQueryEnabled = enabled;
-  },
-});
 
-export default FeatureFlags;
+export { FeatureFlags } from '@zintrust/core';
+export { FeatureFlags as default } from '@zintrust/core';