@zintrust/core 0.4.17 → 0.4.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.17",
+  "version": "0.4.18",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -11,140 +11,89 @@
     "url": "https://github.com/ZinTrust/ZinTrust/issues"
   },
   "type": "module",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./start": {
+      "types": "./src/start.d.ts",
+      "import": "./src/start.js"
+    },
+    "./cli": {
+      "types": "./src/cli.d.ts",
+      "import": "./src/cli.js"
+    },
+    "./worker-commands": {
+      "types": "./src/worker-commands.d.ts",
+      "import": "./src/worker-commands.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.json": "./package.json"
+  },
+  "dependencies": {
+    "@cloudflare/containers": "^0.1.1",
+    "@zintrust/workers": "^0.4.0",
+    "bcryptjs": "^3.0.3",
+    "bullmq": "^5.71.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "inquirer": "^13.3.2",
+    "jsonwebtoken": "^9.0.3",
+    "mysql2": "^3.20.0",
+    "pg": "^8.20.0"
+  },
+  "overrides": {
+    "ajv": "^8.18.0",
+    "axios": "^1.13.5",
+    "node-forge": "1.3.3",
+    "cross-spawn": "^7.0.5",
+    "glob": "^11.1.0",
+    "minimatch": "^10.2.2",
+    "rollup": "^4.59.0",
+    "flatted": "^3.4.2",
+    "@actions/github": {
+      "undici": "^6.24.0"
+    },
+    "@actions/http-client": {
+      "undici": "^6.24.0"
+    },
+    "miniflare": {
+      "undici": "^7.24.4"
+    }
+  },
   "bin": {
-    "zintrust": "./bin/zintrust.ts",
-    "zin": "./bin/zin.ts",
-    "z": "./bin/z.ts",
-    "zt": "./bin/zt.ts"
+    "zintrust": "bin/zintrust.js",
+    "zin": "bin/zin.js",
+    "z": "bin/z.js",
+    "zt": "bin/zt.js"
   },
   "files": [
     "bin",
     "src",
-    "public",
-    "index.js",
-    "index.d.ts"
+    "public"
   ],
   "engines": {
     "node": ">=20.0.0",
     "npm": ">=9.0.0"
   },
-  "scripts": {
-    "worker-plugins:ensure": "node scripts/ensure-worker-plugins.mjs",
-    "ci:remove-dev-routes": "node scripts/toggle-dev-routes.mjs remove",
-    "ci:coverage-prep": "node -e \"if (process.env.CI==='true' || process.env.CI==='1') require('node:child_process').execSync('node scripts/toggle-dev-routes.mjs remove', { stdio: 'inherit' })\"",
-    "clean": "rm -rf dist",
-    "core:link-dist": "mkdir -p node_modules/@zintrust && rm -rf node_modules/@zintrust/core && ln -s ../../dist node_modules/@zintrust/core && ls -la node_modules/@zintrust/core && cat node_modules/@zintrust/core/package.json | head -n 8",
-    "prebuild": "npm run -s worker-plugins:ensure && node scripts/toggle-dev-routes.mjs comment && node scripts/clean-src-emit.mjs",
-    "build": "npm run clean && npm run templates:check && tsc && tsc-alias && node scripts/rewrite-dist-tsconfig-aliases.mjs && node scripts/fix-dist-esm-imports.mjs && node scripts/fix-worker-aliases.mjs && node scripts/copy-cli-templates-to-dist.mjs && node scripts/copy-getting-started-to-dist-readme.mjs && node scripts/copy-docs-public-to-dist.mjs && node scripts/generate-dist-package.mjs && node scripts/replace-build-placeholders.mjs && node scripts/add-version-banner.mjs && node scripts/generate-build-manifest.mjs && npm run packages:build:all",
-    "core:build:dist": "npm run -s worker-plugins:ensure && npm run clean && npm run templates:check && tsc && tsc-alias && node scripts/rewrite-dist-tsconfig-aliases.mjs && node scripts/fix-dist-esm-imports.mjs && node scripts/fix-worker-aliases.mjs && node scripts/copy-cli-templates-to-dist.mjs && node scripts/copy-getting-started-to-dist-readme.mjs && node scripts/copy-docs-public-to-dist.mjs && node scripts/generate-dist-package.mjs && node scripts/replace-build-placeholders.mjs && node scripts/add-version-banner.mjs && node scripts/generate-build-manifest.mjs",
-    "postbuild": "node scripts/toggle-dev-routes.mjs uncomment",
-    "build:ci": "export CI=true && npm run -s ci:remove-dev-routes && npm run clean && npm run templates:check && tsc && tsc-alias && node scripts/rewrite-dist-tsconfig-aliases.mjs && node scripts/copy-docs-public-to-dist.mjs && node scripts/fix-dist-esm-imports.mjs && node scripts/fix-worker-aliases.mjs && node scripts/generate-dist-package.mjs && node scripts/replace-build-placeholders.mjs && node scripts/add-version-banner.mjs && node scripts/generate-build-manifest.mjs && npm run packages:build:all",
-    "build:dk": "export CI=true && npm run -s ci:remove-dev-routes && npm run clean && npm run templates:check && npm run packages:build:docker && tsc && tsc-alias && node scripts/rewrite-dist-tsconfig-aliases.mjs && node scripts/copy-docs-public-to-dist.mjs && node scripts/fix-dist-esm-imports.mjs && node scripts/fix-worker-aliases.mjs && node scripts/generate-dist-package.mjs && node scripts/replace-build-placeholders.mjs && node scripts/add-version-banner.mjs && node scripts/generate-build-manifest.mjs",
-    "prebuild:ci": "npm run -s worker-plugins:ensure && npm run -s ci:remove-dev-routes",
-    "prepro:build": "npm run -s worker-plugins:ensure && node scripts/toggle-dev-routes.mjs comment",
-    "pro:build": "npm run clean && npm test && npm run templates:check && tsc && tsc-alias && node scripts/rewrite-dist-tsconfig-aliases.mjs && node scripts/fix-dist-esm-imports.mjs && node scripts/fix-worker-aliases.mjs && node scripts/copy-docs-public-to-dist.mjs && node scripts/copy-cli-templates-to-dist.mjs && node scripts/copy-getting-started-to-dist-readme.mjs && node scripts/generate-dist-package.mjs && node scripts/replace-build-placeholders.mjs && node scripts/add-version-banner.mjs && node scripts/generate-build-manifest.mjs && npm run packages:build:all",
-    "watch": "tsc --watch --noEmit",
-    "pretest": "npm run -s worker-plugins:ensure",
-    "test": "vitest run",
-    "test:workers": "vitest run tests/workers",
-    "test:watch": "vitest",
-    "pretest:coverage": "npm run -s worker-plugins:ensure && npm run -s ci:coverage-prep",
-    "test:coverage": "vitest run --coverage",
-    "coverage:diff": "tsx scripts/coverage-diff.ts",
-    "coverage:patch": "sh scripts/coverage-patch.sh",
-    "lint": "node scripts/ci/ensure-eslint-ajv8.mjs && eslint \"src/**/*.ts\" \"app/**/*.ts\" \"routes/**/*.ts\" \"packages/**/*.ts\" \"tests/**/*.ts\" \"bin/**/*.ts\" \"database/**/*.ts\"",
-    "format": "prettier --write 'src/**/*.ts'",
-    "packages:build": "node scripts/build-all-packages.mjs",
-    "packages:build:all": "node scripts/build-all-packages.mjs --all",
-    "packages:build:docker": "node scripts/build-all-packages.mjs --all --exclude d1-migrator",
-    "dev": "./bin/z.ts s",
-    "idea": "npm --prefix ideas run deploy",
-    "idea:dry-run": "npm --prefix ideas run deploy:dry-run",
-    "idea:dev": "npm --prefix ideas run dev",
-    "deploy": "cd docs-website && wrangler types && wrangler deploy --env ${WRANGLER_ENV:-production}",
-    "deploy:wk": "wrangler deploy --env worker",
-    "deploy:d1": "wrangler deploy --env d1-proxy",
-    "deploy:kv": "wrangler deploy --env kv-proxy",
-    "deploy:cp": "./bin/z.ts deploy:ccp",
-    "dev:cp": "node scripts/dev-cp.mjs",
-    "dev:cp:clean": "node scripts/dev-cp.mjs --clean-images",
-    "dev:cp:build": "npm run dev:cp -- --pull",
-    "dev:cp:pull": "npm run dev:cp -- --pull",
-    "dev:d1": "wrangler dev --env d1-proxy",
-    "dev:kv": "wrangler dev --env kv-proxy",
-    "templates:sync": "npm run templates:check && node -e \"console.log('templates:sync is disabled for now (no auto-updates). Update src/templates manually.');\"",
-    "templates:check": "tsx src/scripts/TemplateImportsCheck.ts",
-    "env:generate": "tsx src/scripts/GenerateEnvArtifacts.ts",
-    "git-reload": "git rm -r --cached .  && git add .",
-    "start": "node dist/src/bootstrap.js",
-    "pretype-check": "npm run -s worker-plugins:ensure",
-    "type-check": "tsc --noEmit -p tsconfig.json",
-    "test:sonar": "npm run -s ci:coverage-prep && vitest run --coverage && tsx dev/sonar-scan.ts",
-    "sonarqube": "tsx dev/sonar-scan.ts",
-    "sonarqube:setup": "node dev/sonarqube-setup.js",
-    "sonarcloud:issues": "tsx dev/sonarcloud-issues.ts",
-    "sonarcloud:issues:low": "tsx dev/sonarcloud-issues.ts --low --open",
-    "sonarcloud:issues:measures": "tsx dev/sonarcloud-issues.ts --measures",
-    "sonarcloud:check": "bash dev/sonarcloud-check.sh",
-    "update": "node dev/update-deps.mjs",
-    "docker:build": "docker build --target runtime -t zintrust:latest .",
-    "docker:build:prod": "docker build -t zintrust:latest --target runtime .",
-    "docker:build:worker": "docker build --target worker -t zintrust-worker:latest .",
-    "docker:smoke": "node scripts/docker-image-smoke.mjs base && node scripts/docker-image-smoke.mjs worker",
-    "docker:smoke:base": "node scripts/docker-image-smoke.mjs base",
-    "docker:smoke:worker": "node scripts/docker-image-smoke.mjs worker",
-    "docker:prune": "docker system prune -a --volumes --force",
-    "docker:up": "docker-compose up -d",
-    "docker:down": "docker-compose down",
-    "docker:stop": "docker-compose stop",
-    "docker:logs": "docker-compose logs -f app",
-    "docker:shell": "docker-compose run --rm app sh",
-    "docker:test": "docker-compose exec app npm test",
-    "docker:migrate": "docker-compose exec app node dist/bootstrap.js migrate",
-    "microservices:generate": "tsx bin/zintrust-microservices.ts generate",
-    "microservices:bundle": "tsx bin/zintrust-microservices.ts bundle",
-    "microservices:docker": "tsx bin/zintrust-microservices.ts docker",
-    "microservices:discover": "tsx bin/zintrust-microservices.ts discover",
-    "microservices:status": "tsx bin/zintrust-microservices.ts status",
-    "microservices:health": "tsx bin/zintrust-microservices.ts health",
-    "docs:dev:vue": "cd docs-website/vue && npm run dev",
-    "docs:dev": "node scripts/docs-website-dev.mjs --port 7030",
-    "docs:build:vue": "mkdir -p docs-website/vue/public && cp docs-website/zintrust.svg docs-website/vue/public/ && cp docs/*.md docs-website/vue/ && cd docs-website/vue && npm run build && cp -R .vitepress/dist/* ../public/",
-    "docs:build:portal": "node scripts/docs-build-portal.mjs",
-    "docs:build:all": "rm -rf docs-website/public && npm run docs:build:portal && npm run docs:build:vue",
-    "docs:brand:png": "node scripts/convert-brand-svgs-to-png.mjs --input docs-website/brand --max 2048",
-    "dbl": "npm run docs:build:all",
-    "zintrust:prepare": "tsx bin/zintrust.ts prepare",
-    "ecommerce:up": "cd services/ecommerce && docker-compose up -d",
-    "ecommerce:down": "cd services/ecommerce && docker-compose down",
-    "ecommerce:logs": "cd services/ecommerce && docker-compose logs -f",
-    "cleanup:github-actions": "bash ./dev/cleanup-github-actions.sh",
-    "commemtout": "bash ./scripts/disable-plugins-import.sh",
-    "duplication:check": "node scripts/ci/duplication-check.mjs",
-    "prepare": "node -e \"const omit=(process.env.npm_config_omit||'').split(',').map(s=>s.trim()).filter(Boolean); const skip=process.env.NODE_ENV==='production'||process.env.CI==='true'||process.env.CI==='1'||omit.includes('dev'); process.exit(skip?0:1)\" || husky",
-    "postinstall": "node -e \"process.exit(0)\"",
-    "check-up": "npx npm-check-updates",
-    "pub": "npm run pro:build && cd dist && npm publish",
-    "pub:ci": "cd dist && npm publish --access public",
-    "rebuild:bcrypt": "npm rebuild bcrypt",
-    "rebuild:native": "npm rebuild bcrypt better-sqlite3",
-    "b:push": "npm run lint --max-warnings=0",
-    "bg": "npm install -g /opt/homebrew/var/www/Sites/zintrust/dist",
-    "release:sync-versions": "node scripts/release/sync-package-versions.mjs",
-    "release:publish-packages": "node scripts/release/publish-packages.mjs",
-    "release:publish-all": "npm run release:sync-versions && npm run release:publish-packages",
-    "cag": "npm run cleanup:github-actions",
-    "core": "npm run core:build:dist",
-    "prewg": "npm run -s worker-plugins:ensure",
-    "wg": "zin s --wg --env development"
-  },
-  "lint-staged": {
-    "src/**/*.ts": [
-      "eslint --fix"
-    ]
-  },
   "keywords": [
     "framework",
     "typescript",
@@ -161,72 +110,7 @@
   ],
   "author": "ZinTrust Team",
   "license": "MIT",
-  "overrides": {
-    "ajv": "^8.18.0",
-    "axios": "^1.13.5",
-    "node-forge": "1.3.3",
-    "cross-spawn": "^7.0.5",
-    "glob": "^11.1.0",
-    "minimatch": "^10.2.2",
-    "rollup": "^4.59.0",
-    "flatted": "^3.4.2",
-    "@actions/github": {
-      "undici": "^6.24.0"
-    },
-    "@actions/http-client": {
-      "undici": "^6.24.0"
-    },
-    "miniflare": {
-      "undici": "^7.24.4"
-    }
-  },
-  "dependencies": {
-    "@cloudflare/containers": "^0.1.1",
-    "@zintrust/workers": "^0.4.0",
-    "bcryptjs": "^3.0.3",
-    "bullmq": "^5.71.0",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "inquirer": "^13.3.2",
-    "jsonwebtoken": "^9.0.3",
-    "mysql2": "^3.20.0",
-    "pg": "^8.20.0"
-  },
-  "devDependencies": {
-    "@codecov/vite-plugin": "^1.9.1",
-    "@eslint/js": "^10.0.1",
-    "@faker-js/faker": "^10.3.0",
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/resources": "^2.6.0",
-    "@opentelemetry/sdk-node": "^0.213.0",
-    "@opentelemetry/semantic-conventions": "^1.40.0",
-    "@resvg/resvg-js": "^2.6.2",
-    "@types/bcrypt": "^6.0.0",
-    "@types/bcryptjs": "^3.0.0",
-    "@types/better-sqlite3": "7.6.13",
-    "@types/jsonwebtoken": "^9.0.10",
-    "@types/mssql": "^9.1.9",
-    "@types/node": "^25.5.0",
-    "@types/pg": "^8.18.0",
-    "@vitest/coverage-v8": "^4.1.0",
-    "ajv-draft-04": "^1.0.0",
-    "better-sqlite3": "^12.8.0",
-    "es-module-loader": "^2.3.0",
-    "eslint": "^10.0.3",
-    "globals": "^17.4.0",
-    "hot-shots": "^14.2.0",
-    "husky": "^9.1.7",
-    "jscpd": "^4.0.8",
-    "lint-staged": "^16.4.0",
-    "miniflare": "^4.20260312.1",
-    "mongodb": "^7.1.0",
-    "mssql": "^12.2.0",
-    "prom-client": "^15.1.3",
-    "sonarqube-scanner": "^4.3.5",
-    "tsc-alias": "^1.8.16",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.0",
-    "vitest": "^4.1.0"
+  "publishConfig": {
+    "access": "public"
   }
 }

package/src/auth/Auth.d.ts

@@ -0,0 +1,20 @@
+import { type Secret, type SignOptions } from 'jsonwebtoken';
+export declare const Auth: Readonly<{
+    /**
+     * Hash a password
+     */
+    hash(password: string): Promise<string>;
+    /**
+     * Compare a password with a hash
+     */
+    compare(password: string, hash: string): Promise<boolean>;
+    /**
+     * Generate a JWT token
+     */
+    generateToken(payload: Record<string, unknown>, secret: Secret, expiresIn?: NonNullable<SignOptions["expiresIn"]>): string;
+    /**
+     * Verify a JWT token
+     */
+    verifyToken<T>(token: string, secret: Secret): T;
+}>;
+//# sourceMappingURL=Auth.d.ts.map

package/src/auth/Auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../../src/auth/Auth.ts"],"names":[],"mappings":"AAEA,OAAY,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAIlE,eAAO,MAAM,IAAI;IACf;;OAEG;mBACkB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C;;OAEG;sBACqB,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;OAEG;2BAEQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACxB,MAAM,cACH,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,GAC/C,MAAM;IAKT;;OAEG;gBACS,CAAC,SAAS,MAAM,UAAU,MAAM,GAAG,CAAC;EAGhD,CAAC"}

package/src/auth/Auth.js

@@ -0,0 +1,33 @@
+// TEMPLATE_START
+import bcrypt from 'bcryptjs';
+import jwt from 'jsonwebtoken';
+const { sign, verify } = jwt;
+export const Auth = Object.freeze({
+    /**
+     * Hash a password
+     */
+    async hash(password) {
+        const salt = await bcrypt.genSalt(10);
+        return bcrypt.hash(password, salt);
+    },
+    /**
+     * Compare a password with a hash
+     */
+    async compare(password, hash) {
+        return bcrypt.compare(password, hash);
+    },
+    /**
+     * Generate a JWT token
+     */
+    generateToken(payload, secret, expiresIn = '1h') {
+        const options = { expiresIn };
+        return sign(payload, secret, options);
+    },
+    /**
+     * Verify a JWT token
+     */
+    verifyToken(token, secret) {
+        return verify(token, secret);
+    },
+});
+// TEMPLATE_END

package/src/boot/Application.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Application - Framework core entry point
+ * Handles application lifecycle, booting, and environment
+ */
+import type { IApplication } from './registry/type';
+/**
+ * Application Factory
+ */
+export declare const Application: Readonly<{
+    /**
+     * Create a new application instance
+     */
+    create(basePath?: string): IApplication;
+}>;
+export default Application;
+//# sourceMappingURL=Application.d.ts.map

package/src/boot/Application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAkC,MAAM,gBAAgB,CAAC;AA2DnF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EA0CvC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/src/boot/Application.js

@@ -0,0 +1,95 @@
+/**
+ * Application - Framework core entry point
+ * Handles application lifecycle, booting, and environment
+ */
+import { appConfig } from '../config/index.js';
+import { ServiceContainer } from '../container/ServiceContainer.js';
+import { MiddlewareStack } from '../middleware/MiddlewareStack.js';
+import { Router } from '../routes/Router.js';
+import { createLifecycle, registerFrameworkShutdownHooks } from './registry/runtime.js';
+const ShutdownManager = Object.freeze({
+    create() {
+        const hooks = [];
+        return Object.freeze({
+            add(hook) {
+                hooks.push(hook);
+            },
+            async run() {
+                // Run hooks in parallel for better performance
+                await Promise.all(hooks.map(async (hook) => hook()));
+            },
+        });
+    },
+});
+const resolveBasePath = (basePath) => {
+    if (typeof basePath === 'string')
+        return basePath;
+    if (typeof process !== 'undefined' && typeof process.cwd === 'function')
+        return process.cwd();
+    return '';
+};
+const makeJoinFromBase = (resolvedBasePath) => (subPath) => {
+    return resolvedBasePath.length > 0 ? `${resolvedBasePath}/${subPath}` : subPath;
+};
+const registerCorePaths = (container, resolvedBasePath, joinFromBase) => {
+    container.singleton('paths', {
+        base: resolvedBasePath,
+        app: joinFromBase('app'),
+        config: joinFromBase('config'),
+        database: joinFromBase('database'),
+        routes: joinFromBase('routes'),
+        tests: joinFromBase('tests'),
+    });
+};
+const registerCoreInstances = (params) => {
+    params.container.singleton('env', params.environment);
+    params.container.singleton('router', params.router);
+    params.container.singleton('middleware', params.middlewareStack);
+    params.container.singleton('container', params.container);
+    params.container.singleton('shutdownManager', params.shutdownManager);
+};
+/**
+ * Application Factory
+ */
+export const Application = Object.freeze({
+    /**
+     * Create a new application instance
+     */
+    create(basePath) {
+        const resolvedBasePath = resolveBasePath(basePath);
+        const joinFromBase = makeJoinFromBase(resolvedBasePath);
+        const environment = appConfig.environment;
+        const container = ServiceContainer.create();
+        const router = Router.createRouter();
+        const middlewareStack = MiddlewareStack.create();
+        const shutdownManager = ShutdownManager.create();
+        let booted = false;
+        registerCorePaths(container, resolvedBasePath, joinFromBase);
+        registerCoreInstances({ container, environment, router, middlewareStack, shutdownManager });
+        registerFrameworkShutdownHooks(shutdownManager);
+        const { boot, shutdown } = createLifecycle({
+            environment,
+            resolvedBasePath,
+            router,
+            shutdownManager,
+            getBooted: () => booted,
+            setBooted: (value) => {
+                booted = value;
+            },
+        });
+        return {
+            boot,
+            shutdown,
+            isBooted: () => booted,
+            isDevelopment: () => appConfig.isDevelopment(),
+            isProduction: () => appConfig.isProduction(),
+            isTesting: () => appConfig.isTesting(),
+            getEnvironment: () => environment,
+            getRouter: () => router,
+            getContainer: () => container,
+            getMiddlewareStack: () => middlewareStack,
+            getBasePath: () => resolvedBasePath,
+        };
+    },
+});
+export default Application;

package/src/boot/Server.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Server - HTTP Server implementation
+ * Uses Node.js built-in HTTP server with no external dependencies
+ */
+import type { IKernel } from '../http/Kernel';
+import * as http from '../node-singletons/http';
+import type { IApplication } from './registry/type';
+export interface IServer {
+    listen(): Promise<void>;
+    close(): Promise<void>;
+    getHttpServer(): http.Server;
+}
+/**
+ * Server - HTTP Server implementation
+ * Refactored to Functional Object pattern
+ */
+export declare const Server: Readonly<{
+    /**
+     * Create a new server instance
+     */
+    create(app: IApplication, port?: number, host?: string, kernel?: IKernel | null): IServer;
+}>;
+export default Server;
+//# sourceMappingURL=Server.d.ts.map

package/src/boot/Server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../../src/boot/Server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;CAC9B;AAkED;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;gBACS,YAAY,SAAS,MAAM,SAAS,MAAM,WAAU,OAAO,GAAG,IAAI,GAAU,OAAO;EA4D/F,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/src/boot/Server.js

@@ -0,0 +1,123 @@
+/**
+ * Server - HTTP Server implementation
+ * Uses Node.js built-in HTTP server with no external dependencies
+ */
+import { appConfig } from '../config/app.js';
+import { HTTP_HEADERS } from '../config/constants.js';
+import { Logger } from '../config/logger.js';
+import { ServiceContainer } from '../container/ServiceContainer.js';
+import { ErrorRouting } from '../routes/error.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { Kernel } from '../http/Kernel.js';
+import { Request } from '../http/Request.js';
+import { Response } from '../http/Response.js';
+import * as http from '../node-singletons/http.js';
+/**
+ * Set security headers on response
+ */
+const getContentSecurityPolicyForPath = () => {
+    // Default CSP for the API/framework
+    return ("default-src 'self'; " +
+        "script-src 'self' 'unsafe-inline'; " +
+        "style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; " +
+        "style-src-elem 'self' 'unsafe-inline' https://fonts.googleapis.com; " +
+        "img-src 'self' data:; " +
+        "font-src 'self' https://fonts.gstatic.com;");
+};
+const setSecurityHeaders = (res, contentType) => {
+    res.setHeader(HTTP_HEADERS.X_POWERED_BY, 'ZinTrust');
+    res.setHeader(HTTP_HEADERS.X_CONTENT_TYPE_OPTIONS, 'nosniff');
+    res.setHeader(HTTP_HEADERS.X_FRAME_OPTIONS, 'DENY');
+    res.setHeader(HTTP_HEADERS.X_XSS_PROTECTION, '1; mode=block');
+    res.setHeader(HTTP_HEADERS.REFERRER_POLICY, 'strict-origin-when-cross-origin');
+    // Only apply CSP to HTML responses, not API endpoints
+    // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
+    if (contentType !== undefined && contentType !== null && contentType.includes('text/html')) {
+        res.setHeader(HTTP_HEADERS.CONTENT_SECURITY_POLICY, getContentSecurityPolicyForPath());
+    }
+};
+const handleRequest = async (params, req, res) => {
+    let request;
+    let response;
+    try {
+        const contentType = req?.headers['content-type'];
+        setSecurityHeaders(res, contentType);
+        if (!req) {
+            throw ErrorFactory.createConnectionError('Request object is missing');
+        }
+        const kernel = params.getKernel();
+        request = Request.create(req);
+        response = Response.create(res);
+        // Delegate request lifecycle to Kernel (routing + middleware + handler execution).
+        await kernel.handleRequest(request, response);
+    }
+    catch (error) {
+        ErrorFactory.createTryCatchError('Server error:', error);
+        // Prefer wrapper-based error handling when available.
+        if (request !== undefined && response !== undefined) {
+            ErrorRouting.handleInternalServerErrorWithWrappers(request, response, error);
+            return;
+        }
+        ErrorRouting.handleInternalServerErrorRaw(res);
+    }
+};
+/**
+ * Server - HTTP Server implementation
+ * Refactored to Functional Object pattern
+ */
+export const Server = Object.freeze({
+    /**
+     * Create a new server instance
+     */
+    create(app, port, host, kernel = null) {
+        const serverPort = port ?? appConfig.port;
+        const serverHost = host ?? appConfig.host;
+        let kernelInstance = kernel;
+        const getKernel = () => {
+            if (kernelInstance !== null)
+                return kernelInstance;
+            const anyApp = app;
+            const container = typeof anyApp.getContainer === 'function'
+                ? anyApp.getContainer()
+                : ServiceContainer.create();
+            kernelInstance = Kernel.create(app.getRouter(), container);
+            return kernelInstance;
+        };
+        const httpServer = http.createServer(async (req, res) => handleRequest({ getKernel }, req, res));
+        const sockets = new Set();
+        httpServer.on('connection', (socket) => {
+            sockets.add(socket);
+            socket.on('close', () => sockets.delete(socket));
+        });
+        return {
+            async listen() {
+                return new Promise((resolve) => {
+                    httpServer.listen(serverPort, serverHost, () => {
+                        resolve();
+                    });
+                });
+            },
+            async close() {
+                return new Promise((resolve) => {
+                    httpServer.close(() => {
+                        Logger.info('ZinTrust server stopped');
+                        resolve();
+                    });
+                    // Ensure keep-alive / hanging connections don't block shutdown
+                    for (const socket of sockets) {
+                        try {
+                            socket.destroy();
+                        }
+                        catch {
+                            // best-effort
+                        }
+                    }
+                });
+            },
+            getHttpServer() {
+                return httpServer;
+            },
+        };
+    },
+});
+export default Server;

package/src/boot/bootstrap.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Application Bootstrap
+ * Entry point for running the ZinTrust server
+ * Sealed namespace for immutability
+ */
+export {};
+//# sourceMappingURL=bootstrap.d.ts.map

package/src/boot/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/boot/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}