@zintrust/core 0.4.27 → 0.4.28

package/database/migrations/20260109152114_add_way_tasks_table.js

@@ -0,0 +1,22 @@
+/**
+ * Migration: AddWayTasksTable
+ * Modifies tasks table
+ */
+import { Schema as MigrationSchema } from '../../src/migrations/schema';
+export const migration = {
+    /**
+     * Run migration
+     */
+    async up(db) {
+        const schema = MigrationSchema.create(db);
+        await schema.table('tasks', (table) => {
+            table.string('way');
+        });
+    },
+    /**
+     * Rollback migration
+     */
+    async down(_db) {
+        // Note: dropping columns/FKs varies by driver; SQLite/D1 requires a table rebuild.
+    },
+};

package/database/migrations/20260218121500_create_jwt_revocations_table.d.ts

@@ -0,0 +1,7 @@
+import type { IDatabase } from '../../src/orm/Database';
+export interface Migration {
+    up(db: IDatabase): Promise<void>;
+    down(db: IDatabase): Promise<void>;
+}
+export declare const migration: Migration;
+//# sourceMappingURL=20260218121500_create_jwt_revocations_table.d.ts.map

package/database/migrations/20260218121500_create_jwt_revocations_table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260218121500_create_jwt_revocations_table.d.ts","sourceRoot":"","sources":["../../../database/migrations/20260218121500_create_jwt_revocations_table.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,SAAS,EAAE,SAmBvB,CAAC"}

package/database/migrations/20260218121500_create_jwt_revocations_table.js

@@ -0,0 +1,22 @@
+/**
+ * Migration: CreateJwtRevocationsTable
+ * Creates a storage table for JWT token revocation (token invalidation).
+ */
+import { Schema as MigrationSchema } from '../../src/migrations/schema';
+export const migration = {
+    async up(db) {
+        const schema = MigrationSchema.create(db);
+        await schema.create('zintrust_jwt_revocations', (table) => {
+            table.id();
+            table.string('jti', 128).unique();
+            table.string('sub', 191).nullable();
+            table.bigInteger('expires_at_ms');
+            table.timestamp('revoked_at').notNullable().default('CURRENT_TIMESTAMP');
+            table.index(['expires_at_ms']);
+        });
+    },
+    async down(db) {
+        const schema = MigrationSchema.create(db);
+        await schema.dropIfExists('zintrust_jwt_revocations');
+    },
+};

package/database/migrations/20260222120000_add_kind_to_jwt_revocations_table.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migration: AddKindToJwtRevocationsTable
+ * Adds a 'kind' column so the same table can distinguish revoked tokens vs active sessions.
+ */
+import type { IDatabase } from '../../src/orm/Database';
+export interface Migration {
+    up(db: IDatabase): Promise<void>;
+    down(db: IDatabase): Promise<void>;
+}
+export declare const migration: Migration;
+//# sourceMappingURL=20260222120000_add_kind_to_jwt_revocations_table.d.ts.map

package/database/migrations/20260222120000_add_kind_to_jwt_revocations_table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260222120000_add_kind_to_jwt_revocations_table.d.ts","sourceRoot":"","sources":["../../../database/migrations/20260222120000_add_kind_to_jwt_revocations_table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,SAAS,EAAE,SAgBvB,CAAC"}

package/database/migrations/20260222120000_add_kind_to_jwt_revocations_table.js

@@ -0,0 +1,20 @@
+/**
+ * Migration: AddKindToJwtRevocationsTable
+ * Adds a 'kind' column so the same table can distinguish revoked tokens vs active sessions.
+ */
+import { Schema as MigrationSchema } from '../../src/migrations/schema';
+export const migration = {
+    async up(db) {
+        const schema = MigrationSchema.create(db);
+        const hasKind = await schema.hasColumn('zintrust_jwt_revocations', 'kind');
+        if (!hasKind) {
+            await schema.table('zintrust_jwt_revocations', (table) => {
+                table.string('kind', 16).notNullable().default('revoked');
+                table.index(['kind']);
+            });
+        }
+    },
+    async down(_db) {
+        // Note: dropping columns/FKs varies by driver; SQLite/D1 requires a table rebuild.
+    },
+};

package/database/migrations/20260222123000_add_user_id_to_jwt_revocations_table.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migration: AddUserIdToJwtRevocationsTable
+ * Adds a 'user_id' column so developers can attribute JWT session/revocation rows to a user.
+ */
+import type { IDatabase } from '../../src/orm/Database';
+export interface Migration {
+    up(db: IDatabase): Promise<void>;
+    down(db: IDatabase): Promise<void>;
+}
+export declare const migration: Migration;
+//# sourceMappingURL=20260222123000_add_user_id_to_jwt_revocations_table.d.ts.map

package/database/migrations/20260222123000_add_user_id_to_jwt_revocations_table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260222123000_add_user_id_to_jwt_revocations_table.d.ts","sourceRoot":"","sources":["../../../database/migrations/20260222123000_add_user_id_to_jwt_revocations_table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,SAAS,EAAE,SAgBvB,CAAC"}

package/database/migrations/20260222123000_add_user_id_to_jwt_revocations_table.js

@@ -0,0 +1,20 @@
+/**
+ * Migration: AddUserIdToJwtRevocationsTable
+ * Adds a 'user_id' column so developers can attribute JWT session/revocation rows to a user.
+ */
+import { Schema as MigrationSchema } from '../../src/migrations/schema';
+export const migration = {
+    async up(db) {
+        const schema = MigrationSchema.create(db);
+        const hasUserId = await schema.hasColumn('zintrust_jwt_revocations', 'user_id');
+        if (!hasUserId) {
+            await schema.table('zintrust_jwt_revocations', (table) => {
+                table.string('user_id', 191).nullable();
+                table.index(['user_id']);
+            });
+        }
+    },
+    async down(_db) {
+        // Note: dropping columns/FKs varies by driver; SQLite/D1 requires a table rebuild.
+    },
+};

package/database/migrations/20260327112651_create_posts_table.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migration: CreatePostsTable
+ * Creates posts table
+ */
+import type { IDatabase } from '../../src/orm/Database';
+export interface Migration {
+    up(db: IDatabase): Promise<void>;
+    down(db: IDatabase): Promise<void>;
+}
+export declare const migration: Migration;
+//# sourceMappingURL=20260327112651_create_posts_table.d.ts.map

package/database/migrations/20260327112651_create_posts_table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260327112651_create_posts_table.d.ts","sourceRoot":"","sources":["../../../database/migrations/20260327112651_create_posts_table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,SAAS,EAAE,SAoBvB,CAAC"}

package/database/migrations/20260327112651_create_posts_table.js

@@ -0,0 +1,24 @@
+/**
+ * Migration: CreatePostsTable
+ * Creates posts table
+ */
+import { Schema as MigrationSchema } from '../../src/migrations/schema';
+export const migration = {
+    /**
+     * Run migration
+     */
+    async up(db) {
+        const schema = MigrationSchema.create(db);
+        await schema.create('posts', (table) => {
+            table.id();
+            table.timestamps();
+        });
+    },
+    /**
+     * Rollback migration
+     */
+    async down(db) {
+        const schema = MigrationSchema.create(db);
+        await schema.dropIfExists('posts');
+    },
+};

package/database/seeders/DatabaseSeeder.d.ts

@@ -0,0 +1,5 @@
+import type { IDatabase } from '../../src/orm/Database';
+export declare const DatabaseSeeder: Readonly<{
+    run(db: IDatabase): Promise<void>;
+}>;
+//# sourceMappingURL=DatabaseSeeder.d.ts.map

package/database/seeders/DatabaseSeeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseSeeder.d.ts","sourceRoot":"","sources":["../../../database/seeders/DatabaseSeeder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,cAAc;YACX,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;EAWvC,CAAC"}

package/database/seeders/DatabaseSeeder.js

@@ -0,0 +1,15 @@
+import { SeederDiscovery } from '../../src/seeders/SeederDiscovery';
+import { SeederLoader } from '../../src/seeders/SeederLoader';
+import { CommonUtils } from '../../src/common/index';
+import * as path from '../../src/node-singletons/path';
+export const DatabaseSeeder = Object.freeze({
+    async run(db) {
+        const dir = CommonUtils.esmDirname(import.meta.url);
+        const files = SeederDiscovery.listSeederFiles(dir).filter((filePath) => {
+            const base = path.basename(filePath, path.extname(filePath));
+            return base !== 'DatabaseSeeder';
+        });
+        const seeders = await Promise.all(files.map((filePath) => SeederLoader.load(filePath)));
+        await Promise.all(seeders.map((seeder) => seeder.run(db)));
+    },
+});

package/database/seeders/UserSeeder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * UserSeeder
+ * Seeder for populating User table with test data
+ */
+import { UserFactory } from '../factories/UserFactory';
+import type { IDatabase } from '../../src/orm/Database';
+export declare const UserSeeder: Readonly<{
+    /**
+     * Run the seeder
+     * Populates the user table with 10 records
+     */
+    run(db?: IDatabase): Promise<void>;
+    /**
+     * Get records from this seeder
+     */
+    getRecords(count: number): Promise<ReturnType<ReturnType<typeof UserFactory.new>["count"]>>;
+    /**
+     * Seed with specific states
+     */
+    seedWithStates(db?: IDatabase): Promise<void>;
+    /**
+     * Seed with relationships
+     */
+    seedWithRelationships(db?: IDatabase): Promise<void>;
+    /**
+     * Reset seeder (truncate table)
+     */
+    reset(db?: IDatabase): Promise<void>;
+}>;
+//# sourceMappingURL=UserSeeder.d.ts.map

package/database/seeders/UserSeeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserSeeder.d.ts","sourceRoot":"","sources":["../../../database/seeders/UserSeeder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA2B/C,eAAO,MAAM,UAAU;IACrB;;;OAGG;aACY,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxC;;OAEG;sBAEM,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAKnE;;OAEG;wBACuB,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnD;;OAEG;+BAC8B,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D;;OAEG;eACc,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;EAS1C,CAAC"}

package/database/seeders/UserSeeder.js

@@ -0,0 +1,97 @@
+/**
+ * UserSeeder
+ * Seeder for populating User table with test data
+ */
+import { Logger } from '../../src/config/logger';
+import { UserFactory } from '../factories/UserFactory';
+import { Auth } from '../../src/auth/Auth';
+async function truncateUsersTable(db) {
+    await db.table('users').where('id', 'IS NOT', null).delete();
+}
+function normalizeUserFactoryRecord(record) {
+    const row = record;
+    const name = typeof row['name'] === 'string' ? row['name'] : 'User';
+    const email = typeof row['email'] === 'string' ? row['email'] : `${name}@example.com`;
+    return { name, email };
+}
+async function insertUserFactoryRecords(db, records, getPassword) {
+    await Promise.all(records.map(async (record) => {
+        const { name, email } = normalizeUserFactoryRecord(record);
+        const password = await getPassword();
+        return db.table('users').insert({ name, email, password });
+    }));
+}
+export const UserSeeder = Object.freeze({
+    /**
+     * Run the seeder
+     * Populates the user table with 10 records
+     */
+    async run(db) {
+        if (db === undefined) {
+            Logger.warn('UserSeeder.run() was called without a db instance; skipping.');
+            return;
+        }
+        const count = 10;
+        const factory = UserFactory.new();
+        // Optionally truncate the table before seeding
+        await truncateUsersTable(db);
+        // Generate and create records
+        const records = factory.count(count);
+        await insertUserFactoryRecords(db, records, () => Auth.hash('password'));
+        Logger.info(`✅ Seeded ${count} user records`);
+    },
+    /**
+     * Get records from this seeder
+     */
+    async getRecords(count) {
+        const factory = UserFactory.new();
+        return factory.count(count);
+    },
+    /**
+     * Seed with specific states
+     */
+    async seedWithStates(db) {
+        if (db === undefined) {
+            Logger.warn('UserSeeder.seedWithStates() was called without a db instance; skipping.');
+            return;
+        }
+        const factory = UserFactory.new();
+        // Create active records (50%)
+        const active = factory.state('active').count(Math.ceil(10 * 0.5));
+        const activePromise = insertUserFactoryRecords(db, active, () => Auth.hash('password'));
+        // Create inactive records (30%)
+        const inactive = factory.state('inactive').count(Math.ceil(10 * 0.3));
+        const inactivePromise = insertUserFactoryRecords(db, inactive, () => Auth.hash('password'));
+        // Create deleted records (20%)
+        const deleted = factory.state('deleted').count(Math.ceil(10 * 0.2));
+        const deletedPromise = insertUserFactoryRecords(db, deleted, () => Auth.hash('password'));
+        await Promise.all([activePromise, inactivePromise, deletedPromise]);
+        Logger.info(`✅ Seeded 10 user records with state distribution`);
+    },
+    /**
+     * Seed with relationships
+     */
+    async seedWithRelationships(db) {
+        if (db === undefined) {
+            Logger.warn('UserSeeder.seedWithRelationships() was called without a db instance; skipping.');
+            return;
+        }
+        const factory = UserFactory.new();
+        const password = await Auth.hash('password');
+        const records = factory.count(10);
+        // Create records with relationships (implement as needed)
+        await insertUserFactoryRecords(db, records, async () => password);
+        Logger.info(`✅ Seeded 10 user records with relationships`);
+    },
+    /**
+     * Reset seeder (truncate table)
+     */
+    async reset(db) {
+        if (db === undefined) {
+            Logger.warn('UserSeeder.reset() was called without a db instance; skipping.');
+            return;
+        }
+        await truncateUsersTable(db);
+        Logger.info('✅ Truncated users table');
+    },
+});

package/index.d.ts

@@ -0,0 +1 @@
+export * from './src/index';

package/index.js

@@ -0,0 +1 @@
+export * from './src/index.js';

package/package.json

@@ -1,50 +1,51 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.27",
-  "description": "Production-grade TypeScript backend framework for JavaScript",
-  "homepage": "https://zintrust.com",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ZinTrust/ZinTrust.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ZinTrust/ZinTrust/issues"
-  },
+  "version": "0.4.28",
   "type": "module",
-  "main": "src/index.js",
-  "types": "src/index.d.ts",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "bin": {
+    "zintrust": "./bin/zintrust.js",
+    "zin": "./bin/zin.js",
+    "z": "./bin/z.js",
+    "zt": "./bin/zt.js"
+  },
   "exports": {
     ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js"
+      "types": "./index.d.ts",
+      "default": "./index.js"
     },
     "./start": {
-      "types": "./src/start.d.ts",
-      "import": "./src/start.js"
+      "types": "./start.d.ts",
+      "default": "./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"
+      "default": "./src/cli.js"
     },
     "./proxy": {
       "types": "./src/proxy.d.ts",
-      "import": "./src/proxy.js"
+      "default": "./src/proxy.js"
+    },
+    "./proxy/*": {
+      "types": "./src/proxy/*.d.ts",
+      "default": "./src/proxy/*.js"
     },
     "./collections": {
       "types": "./src/collections/index.d.ts",
-      "import": "./src/collections/index.js"
+      "default": "./src/collections/index.js"
     },
     "./helper": {
       "types": "./src/helper/index.d.ts",
-      "import": "./src/helper/index.js"
+      "default": "./src/helper/index.js"
     },
     "./node": {
       "types": "./src/node.d.ts",
-      "import": "./src/node.js"
+      "default": "./src/node.js"
+    },
+    "./routes/*": {
+      "types": "./routes/*.d.ts",
+      "default": "./routes/*.js"
     },
     "./package.json": "./package.json"
   },
@@ -60,58 +61,6 @@
     "mysql2": "^3.20.0",
     "pg": "^8.20.0"
   },
-  "overrides": {
-    "ajv": "^8.18.0",
-    "axios": "^1.13.5",
-    "node-forge": "^1.4.0",
-    "brace-expansion": "^5.0.5",
-    "picomatch": "^4.0.4",
-    "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.js",
-    "zin": "bin/zin.js",
-    "z": "bin/z.js",
-    "zt": "bin/zt.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "public"
-  ],
-  "engines": {
-    "node": ">=20.0.0",
-    "npm": ">=9.0.0"
-  },
-  "keywords": [
-    "framework",
-    "typescript",
-    "backend",
-    "orm",
-    "query-builder",
-    "rest-api",
-    "react",
-    "react-api",
-    "vue",
-    "vue-api",
-    "symfony",
-    "laravel"
-  ],
-  "author": "ZinTrust Team",
-  "license": "MIT",
   "publishConfig": {
     "access": "public"
   }

package/packages/cache-redis/src/RedisProxyAdapter.d.ts

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

package/packages/cache-redis/src/RedisProxyAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisProxyAdapter.d.ts","sourceRoot":"","sources":["../../../../packages/cache-redis/src/RedisProxyAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmI9C,eAAO,MAAM,iBAAiB;cAClB,WAAW;EA6CrB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/packages/cache-redis/src/RedisProxyAdapter.js

@@ -0,0 +1,144 @@
+import { Env, ErrorFactory, Logger, SignedRequest } from '../../../src/index.js';
+const resolveSigningPrefix = (baseUrl) => {
+    try {
+        const parsed = new URL(baseUrl);
+        const path = parsed.pathname.endsWith('/') ? parsed.pathname.slice(0, -1) : parsed.pathname;
+        if (path === '' || path === '/')
+            return undefined;
+        return path;
+    }
+    catch {
+        return undefined;
+    }
+};
+const buildRequestUrl = (baseUrl, path) => {
+    const url = new URL(baseUrl);
+    const basePath = url.pathname.endsWith('/') ? url.pathname.slice(0, -1) : url.pathname;
+    const requestPath = path.startsWith('/') ? path : `/${path}`;
+    url.pathname = `${basePath}${requestPath}`;
+    return url;
+};
+const buildSigningUrl = (requestUrl, baseUrl) => {
+    const prefix = resolveSigningPrefix(baseUrl);
+    if (!prefix)
+        return requestUrl;
+    if (requestUrl.pathname === prefix || requestUrl.pathname.startsWith(`${prefix}/`)) {
+        const signingUrl = new URL(requestUrl.toString());
+        const stripped = requestUrl.pathname.slice(prefix.length);
+        signingUrl.pathname = stripped.startsWith('/') ? stripped : `/${stripped}`;
+        return signingUrl;
+    }
+    return requestUrl;
+};
+const resolveBaseUrl = () => {
+    const explicit = Env.get('REDIS_PROXY_URL', '').trim();
+    if (explicit !== '')
+        return explicit;
+    const host = Env.get('REDIS_PROXY_HOST', '127.0.0.1');
+    const port = Env.getInt('REDIS_PROXY_PORT', 8791);
+    return `http://${host}:${port}`;
+};
+const buildProxySettings = () => {
+    const baseUrl = resolveBaseUrl();
+    const rawKeyId = Env.get('REDIS_PROXY_KEY_ID', '').trim();
+    const fallbackKeyId = (Env.APP_NAME ?? 'zintrust').trim().toLowerCase().replaceAll(/\s+/g, '_');
+    const keyId = (rawKeyId === '' ? fallbackKeyId : rawKeyId) || undefined;
+    const secret = Env.get('REDIS_PROXY_SECRET', '') || Env.APP_KEY || undefined;
+    const timeoutMs = Env.getInt('REDIS_PROXY_TIMEOUT_MS', Env.ZT_PROXY_TIMEOUT_MS);
+    return { baseUrl, keyId, secret, timeoutMs };
+};
+const buildHeaders = async (settings, requestUrl, body) => {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (settings.keyId && settings.secret) {
+        const signingUrl = buildSigningUrl(requestUrl, settings.baseUrl);
+        const signed = await SignedRequest.createHeaders({
+            method: 'POST',
+            url: signingUrl,
+            body,
+            keyId: settings.keyId,
+            secret: settings.secret,
+        });
+        Object.assign(headers, signed);
+    }
+    else {
+        Logger.warn('[redis-proxy] Proxy signing disabled; sending unsigned request.');
+    }
+    return headers;
+};
+const requestProxy = async (settings, path, payload) => {
+    if (settings.baseUrl.trim() === '') {
+        throw ErrorFactory.createConfigError('Redis proxy URL is missing (REDIS_PROXY_URL)');
+    }
+    const body = JSON.stringify(payload);
+    const url = buildRequestUrl(settings.baseUrl, path);
+    const headers = await buildHeaders(settings, url, body);
+    const timeoutSignal = typeof AbortSignal !== 'undefined' && 'timeout' in AbortSignal;
+    const signal = timeoutSignal ? AbortSignal.timeout(settings.timeoutMs) : undefined;
+    const response = await fetch(url.toString(), {
+        method: 'POST',
+        headers,
+        body,
+        signal,
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw ErrorFactory.createTryCatchError(`Redis proxy request failed (${response.status})`, text);
+    }
+    return (await response.json());
+};
+const toNumber = (value) => {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : 0;
+    }
+    return 0;
+};
+export const RedisProxyAdapter = Object.freeze({
+    create() {
+        const settings = buildProxySettings();
+        const sendCommand = async (command, args) => {
+            const response = await requestProxy(settings, '/zin/redis/command', {
+                command,
+                args,
+            });
+            return response.result;
+        };
+        return {
+            async get(key) {
+                const result = await sendCommand('GET', [key]);
+                if (result === null)
+                    return null;
+                try {
+                    return JSON.parse(result);
+                }
+                catch {
+                    return null;
+                }
+            },
+            async set(key, value, ttl) {
+                const json = JSON.stringify(value);
+                if (Number.isFinite(ttl) && (ttl ?? 0) > 0) {
+                    await sendCommand('SET', [key, json, 'EX', ttl]);
+                }
+                else {
+                    await sendCommand('SET', [key, json]);
+                }
+            },
+            async delete(key) {
+                await sendCommand('DEL', [key]);
+            },
+            async clear() {
+                await sendCommand('FLUSHDB', []);
+            },
+            async has(key) {
+                const result = await sendCommand('EXISTS', [key]);
+                return toNumber(result) > 0;
+            },
+        };
+    },
+});
+export default RedisProxyAdapter;

package/packages/cache-redis/src/index.d.ts

@@ -0,0 +1,27 @@
+export interface CacheDriver {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+export type RedisCacheConfig = {
+    driver: 'redis';
+    host: string;
+    port: number;
+    ttl: number;
+    password?: string;
+    database?: number;
+};
+export declare const RedisCacheDriver: Readonly<{
+    create(config: RedisCacheConfig): CacheDriver;
+}>;
+export default RedisCacheDriver;
+export { RedisProxyAdapter } from './RedisProxyAdapter.js';
+/**
+ * Package version and build metadata
+ * Available at runtime for debugging and health checks
+ */
+export declare const _ZINTRUST_CACHE_REDIS_VERSION = "0.1.15";
+export declare const _ZINTRUST_CACHE_REDIS_BUILD_DATE = "__BUILD_DATE__";
+//# sourceMappingURL=index.d.ts.map