@arikajs/session 0.0.5

package/dist/Drivers/DatabaseDriver.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseDriver = void 0;
+/**
+ * DatabaseDriver — stores sessions using a SQL database table.
+ * Depends on the application's database instance implementing basic
+ * table(), where(), update(), insert(), and delete() methods.
+ */
+class DatabaseDriver {
+    constructor(database, table = 'sessions', connection) {
+        this.database = database;
+        this.table = table;
+        this.connection = connection;
+    }
+    async load(sessionId) {
+        const session = await this.database.table(this.table, this.connection)
+            .where('id', sessionId)
+            .first();
+        if (!session)
+            return null;
+        if (session.expiration && session.expiration <= Math.floor(Date.now() / 1000)) {
+            await this.destroy(sessionId);
+            return null;
+        }
+        try {
+            return JSON.parse(session.payload);
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(sessionId, data, ttlSeconds) {
+        const payload = JSON.stringify(data);
+        const expiration = Math.floor(Date.now() / 1000) + ttlSeconds;
+        const exists = await this.database.table(this.table, this.connection)
+            .where('id', sessionId)
+            .exists();
+        if (exists) {
+            await this.database.table(this.table, this.connection)
+                .where('id', sessionId)
+                .update({ payload, expiration });
+        }
+        else {
+            // Need to insert user_id into the table as well if this is a framework user
+            let userId = null;
+            if (data['auth_user_id']) {
+                userId = data['auth_user_id'];
+            }
+            try {
+                await this.database.table(this.table, this.connection).insert({
+                    id: sessionId,
+                    user_id: userId,
+                    ip_address: null, // these could be populated via middleware later
+                    user_agent: null,
+                    payload,
+                    expiration,
+                });
+            }
+            catch {
+                // Ignore duplicate key errors if two requests spawn here due to race
+                await this.database.table(this.table, this.connection)
+                    .where('id', sessionId)
+                    .update({ payload, expiration });
+            }
+        }
+    }
+    async destroy(sessionId) {
+        await this.database.table(this.table, this.connection)
+            .where('id', sessionId)
+            .delete();
+    }
+    async gc(maxLifetimeSeconds) {
+        // Collect everything <= current time
+        const now = Math.floor(Date.now() / 1000);
+        await this.database.table(this.table, this.connection)
+            .where('expiration', '<=', now)
+            .delete();
+    }
+    async acquireLock(sessionId, timeoutSeconds) {
+        // Simple pessimistic locking in a separate locks table, or just use DB transactions.
+        // For simplicity and to avoid creating a new table, we attempt to save a lock flag or rely on DB timeouts.
+        // Returning true here as a simple mock; true database locking requires named locks or a dedicated lock column.
+        return true;
+    }
+    async releaseLock(sessionId) {
+        // Release logic goes here.
+    }
+}
+exports.DatabaseDriver = DatabaseDriver;
+//# sourceMappingURL=DatabaseDriver.js.map

package/dist/Drivers/DatabaseDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseDriver.js","sourceRoot":"","sources":["../../src/Drivers/DatabaseDriver.ts"],"names":[],"mappings":"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"}

package/dist/Drivers/FileDriver.d.ts

@@ -0,0 +1,18 @@
+import { SessionDriver } from '../Contracts/SessionDriver';
+/**
+ * FileDriver — stores sessions as JSON files on disk.
+ * Suitable for single-server applications. Supports GC via file scanning.
+ */
+export declare class FileDriver implements SessionDriver {
+    private readonly directory;
+    constructor(directory: string);
+    private ensureDirectory;
+    private filePath;
+    load(sessionId: string): Promise<Record<string, any> | null>;
+    save(sessionId: string, data: Record<string, any>, ttlSeconds: number): Promise<void>;
+    destroy(sessionId: string): Promise<void>;
+    gc(maxLifetimeSeconds: number): Promise<void>;
+    acquireLock(sessionId: string, timeoutSeconds: number): Promise<boolean>;
+    releaseLock(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=FileDriver.d.ts.map

package/dist/Drivers/FileDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDriver.d.ts","sourceRoot":"","sources":["../../src/Drivers/FileDriver.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAO3D;;;GAGG;AACH,qBAAa,UAAW,YAAW,aAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAI9C,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,QAAQ;IAWH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAmB5D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,EAAE,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B7C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBxE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM7D"}

package/dist/Drivers/FileDriver.js

@@ -0,0 +1,170 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileDriver = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const crypto = __importStar(require("node:crypto"));
+/**
+ * FileDriver — stores sessions as JSON files on disk.
+ * Suitable for single-server applications. Supports GC via file scanning.
+ */
+class FileDriver {
+    constructor(directory) {
+        this.directory = directory;
+        this.ensureDirectory();
+    }
+    ensureDirectory() {
+        if (!fs.existsSync(this.directory)) {
+            fs.mkdirSync(this.directory, { recursive: true });
+        }
+    }
+    filePath(sessionId) {
+        // Use a simple hash-based subdirectory to avoid huge flat folders
+        const hash = crypto.createHash('md5').update(sessionId).digest('hex');
+        const sub = hash.slice(0, 2);
+        const dir = path.join(this.directory, sub);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        return path.join(dir, `${sessionId}.json`);
+    }
+    async load(sessionId) {
+        const file = this.filePath(sessionId);
+        if (!fs.existsSync(file))
+            return null;
+        try {
+            const raw = fs.readFileSync(file, 'utf8');
+            const entry = JSON.parse(raw);
+            if (Date.now() > entry.expiresAt) {
+                fs.unlinkSync(file);
+                return null;
+            }
+            return entry.data;
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(sessionId, data, ttlSeconds) {
+        const file = this.filePath(sessionId);
+        const entry = {
+            data,
+            expiresAt: Date.now() + ttlSeconds * 1000,
+        };
+        try {
+            fs.writeFileSync(file, JSON.stringify(entry), 'utf8');
+        }
+        catch {
+            // Silently fail — don't crash the request
+        }
+    }
+    async destroy(sessionId) {
+        const file = this.filePath(sessionId);
+        if (fs.existsSync(file)) {
+            try {
+                fs.unlinkSync(file);
+            }
+            catch { }
+        }
+    }
+    async gc(maxLifetimeSeconds) {
+        const now = Date.now();
+        const maxMs = maxLifetimeSeconds * 1000;
+        const scanDir = (dir) => {
+            if (!fs.existsSync(dir))
+                return;
+            for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    scanDir(fullPath);
+                }
+                else if (entry.name.endsWith('.json')) {
+                    try {
+                        const raw = fs.readFileSync(fullPath, 'utf8');
+                        const session = JSON.parse(raw);
+                        if (now > session.expiresAt) {
+                            fs.unlinkSync(fullPath);
+                        }
+                    }
+                    catch {
+                        // Corrupt file — remove it
+                        try {
+                            fs.unlinkSync(fullPath);
+                        }
+                        catch { }
+                    }
+                }
+            }
+        };
+        scanDir(this.directory);
+    }
+    async acquireLock(sessionId, timeoutSeconds) {
+        const lockPath = this.filePath(sessionId) + '.lock';
+        if (fs.existsSync(lockPath)) {
+            try {
+                const stat = fs.statSync(lockPath);
+                // If it's stale, break it
+                if (Date.now() - stat.mtimeMs > timeoutSeconds * 1000) {
+                    fs.unlinkSync(lockPath);
+                }
+                else {
+                    return false;
+                }
+            }
+            catch {
+                return false;
+            }
+        }
+        try {
+            fs.writeFileSync(lockPath, '', { flag: 'wx' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async releaseLock(sessionId) {
+        const lockPath = this.filePath(sessionId) + '.lock';
+        if (fs.existsSync(lockPath)) {
+            try {
+                fs.unlinkSync(lockPath);
+            }
+            catch { }
+        }
+    }
+}
+exports.FileDriver = FileDriver;
+//# sourceMappingURL=FileDriver.js.map

package/dist/Drivers/FileDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDriver.js","sourceRoot":"","sources":["../../src/Drivers/FileDriver.ts"],"names":[],"mappings":"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"}

package/dist/Drivers/MemoryDriver.d.ts

@@ -0,0 +1,16 @@
+import { SessionDriver } from '../Contracts/SessionDriver';
+/**
+ * MemoryDriver — stores sessions in a JavaScript Map.
+ * ⚠️ Development only. Data is lost on server restart and not shared across processes.
+ */
+export declare class MemoryDriver implements SessionDriver {
+    private store;
+    load(sessionId: string): Promise<Record<string, any> | null>;
+    save(sessionId: string, data: Record<string, any>, ttlSeconds: number): Promise<void>;
+    destroy(sessionId: string): Promise<void>;
+    gc(maxLifetimeSeconds: number): Promise<void>;
+    private lockedSessions;
+    acquireLock(sessionId: string, timeoutSeconds: number): Promise<boolean>;
+    releaseLock(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=MemoryDriver.d.ts.map

package/dist/Drivers/MemoryDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../src/Drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC9C,OAAO,CAAC,KAAK,CAA4E;IAE5E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAU5D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,EAAE,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,OAAO,CAAC,cAAc,CAA0B;IAEnC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASxE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7D"}

package/dist/Drivers/MemoryDriver.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryDriver = void 0;
+/**
+ * MemoryDriver — stores sessions in a JavaScript Map.
+ * ⚠️ Development only. Data is lost on server restart and not shared across processes.
+ */
+class MemoryDriver {
+    constructor() {
+        this.store = new Map();
+        this.lockedSessions = new Set();
+    }
+    async load(sessionId) {
+        const entry = this.store.get(sessionId);
+        if (!entry)
+            return null;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(sessionId);
+            return null;
+        }
+        return entry.data;
+    }
+    async save(sessionId, data, ttlSeconds) {
+        this.store.set(sessionId, {
+            data,
+            expiresAt: Date.now() + ttlSeconds * 1000,
+        });
+    }
+    async destroy(sessionId) {
+        this.store.delete(sessionId);
+    }
+    async gc(maxLifetimeSeconds) {
+        const now = Date.now();
+        for (const [id, entry] of this.store.entries()) {
+            if (now > entry.expiresAt) {
+                this.store.delete(id);
+            }
+        }
+    }
+    async acquireLock(sessionId, timeoutSeconds) {
+        if (this.lockedSessions.has(sessionId))
+            return false;
+        this.lockedSessions.add(sessionId);
+        // Auto-release after timeout just in case it crashes
+        setTimeout(() => this.lockedSessions.delete(sessionId), timeoutSeconds * 1000);
+        return true;
+    }
+    async releaseLock(sessionId) {
+        this.lockedSessions.delete(sessionId);
+    }
+}
+exports.MemoryDriver = MemoryDriver;
+//# sourceMappingURL=MemoryDriver.js.map

package/dist/Drivers/MemoryDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryDriver.js","sourceRoot":"","sources":["../../src/Drivers/MemoryDriver.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,YAAY;IAAzB;QACY,UAAK,GAAkE,IAAI,GAAG,EAAE,CAAC;QAgCjF,mBAAc,GAAgB,IAAI,GAAG,EAAE,CAAC;IAcpD,CAAC;IA5CU,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAAyB,EAAE,UAAkB;QAC9E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE;YACtB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI;SAC5C,CAAC,CAAC;IACP,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,SAAiB;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,EAAE,CAAC,kBAA0B;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IAIM,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,cAAsB;QAC9D,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEnC,qDAAqD;QACrD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,SAAiB;QACtC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;CACJ;AA/CD,oCA+CC"}

package/dist/Drivers/RedisDriver.d.ts

@@ -0,0 +1,20 @@
+import { SessionDriver } from '../Contracts/SessionDriver';
+import Redis, { Cluster } from 'ioredis';
+/**
+ * RedisDriver — stores sessions using Redis.
+ * Supports native TTL (no GC needed) and excellent session locking.
+ */
+export declare class RedisDriver implements SessionDriver {
+    private readonly redis;
+    private readonly prefix;
+    constructor(redis: Redis | Cluster, prefix?: string);
+    private key;
+    private lockKey;
+    load(sessionId: string): Promise<Record<string, any> | null>;
+    save(sessionId: string, data: Record<string, any>, ttlSeconds: number): Promise<void>;
+    destroy(sessionId: string): Promise<void>;
+    gc(maxLifetimeSeconds: number): Promise<void>;
+    acquireLock(sessionId: string, timeoutSeconds: number): Promise<boolean>;
+    releaseLock(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=RedisDriver.d.ts.map

package/dist/Drivers/RedisDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../src/Drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,qBAAa,WAAY,YAAW,aAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,KAAK,GAAG,OAAO,EACtB,MAAM,GAAE,MAAyB;IAGtD,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,OAAO;IAIF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAU5D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrF,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,EAAE,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7D"}

package/dist/Drivers/RedisDriver.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisDriver = void 0;
+/**
+ * RedisDriver — stores sessions using Redis.
+ * Supports native TTL (no GC needed) and excellent session locking.
+ */
+class RedisDriver {
+    constructor(redis, prefix = 'arika_session:') {
+        this.redis = redis;
+        this.prefix = prefix;
+    }
+    key(sessionId) {
+        return this.prefix + sessionId;
+    }
+    lockKey(sessionId) {
+        return this.prefix + 'lock:' + sessionId;
+    }
+    async load(sessionId) {
+        const raw = await this.redis.get(this.key(sessionId));
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(sessionId, data, ttlSeconds) {
+        const raw = JSON.stringify(data);
+        if (ttlSeconds > 0) {
+            await this.redis.set(this.key(sessionId), raw, 'EX', ttlSeconds);
+        }
+        else {
+            await this.redis.set(this.key(sessionId), raw);
+        }
+    }
+    async destroy(sessionId) {
+        await this.redis.del(this.key(sessionId));
+    }
+    async gc(maxLifetimeSeconds) {
+        // Redis handles TTL automatically — no-op.
+    }
+    async acquireLock(sessionId, timeoutSeconds) {
+        const result = await this.redis.set(this.lockKey(sessionId), '1', 'EX', timeoutSeconds, 'NX');
+        return result === 'OK';
+    }
+    async releaseLock(sessionId) {
+        await this.redis.del(this.lockKey(sessionId));
+    }
+}
+exports.RedisDriver = RedisDriver;
+//# sourceMappingURL=RedisDriver.js.map

package/dist/Drivers/RedisDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisDriver.js","sourceRoot":"","sources":["../../src/Drivers/RedisDriver.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,WAAW;IACpB,YACqB,KAAsB,EACtB,SAAiB,gBAAgB;QADjC,UAAK,GAAL,KAAK,CAAiB;QACtB,WAAM,GAAN,MAAM,CAA2B;IAClD,CAAC;IAEG,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACnC,CAAC;IAEO,OAAO,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAAyB,EAAE,UAAkB;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,SAAiB;QAClC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,EAAE,CAAC,kBAA0B;QACtC,2CAA2C;IAC/C,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,cAAsB;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QAC9F,OAAO,MAAM,KAAK,IAAI,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,SAAiB;QACtC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAClD,CAAC;CACJ;AAjDD,kCAiDC"}

package/dist/Middleware/StartSession.d.ts

@@ -0,0 +1,19 @@
+import { SessionManager } from '../SessionManager';
+/**
+ * StartSession middleware.
+ *
+ * Lifecycle:
+ *  1. Read session ID from the request cookie (or generate a new one)
+ *  2. Create a Session instance (lazy — does NOT hit storage yet)
+ *  3. Attach `request.session` so controllers can use it
+ *  4. After response: save dirty session data back to the driver
+ *  5. Write Set-Cookie header with (possibly new/rotated) session ID
+ *  6. Probabilistically run GC
+ */
+export declare class StartSession {
+    private readonly manager;
+    constructor(manager: SessionManager);
+    handle(request: any, next: (req: any) => Promise<any>, response?: any): Promise<any>;
+    private writeSetCookie;
+}
+//# sourceMappingURL=StartSession.d.ts.map

package/dist/Middleware/StartSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartSession.d.ts","sourceRoot":"","sources":["../../src/Middleware/StartSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEvC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA8EjG,OAAO,CAAC,cAAc;CAuBzB"}

package/dist/Middleware/StartSession.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartSession = void 0;
+/**
+ * StartSession middleware.
+ *
+ * Lifecycle:
+ *  1. Read session ID from the request cookie (or generate a new one)
+ *  2. Create a Session instance (lazy — does NOT hit storage yet)
+ *  3. Attach `request.session` so controllers can use it
+ *  4. After response: save dirty session data back to the driver
+ *  5. Write Set-Cookie header with (possibly new/rotated) session ID
+ *  6. Probabilistically run GC
+ */
+class StartSession {
+    constructor(manager) {
+        this.manager = manager;
+    }
+    async handle(request, next, response) {
+        const config = this.manager.config;
+        const cookieHelper = this.manager.getCookieHelper();
+        // 1. Resolve session ID
+        const cookieHeader = (typeof request.header === 'function' ? request.header('cookie') : null) ??
+            request.req?.headers?.cookie ??
+            '';
+        let sessionId = cookieHelper.read(cookieHeader);
+        let isNewSession = false;
+        if (!sessionId) {
+            sessionId = cookieHelper.generate();
+            isNewSession = true;
+        }
+        // 2. Create a lazy Session instance
+        const session = this.manager.createSession(sessionId);
+        // 3. Attach to request
+        request.session = session;
+        // Acquire lock if enabled
+        const locking = config.locking ?? false;
+        const lockTimeout = config.lockTimeout ?? 10; // seconds
+        let locked = false;
+        try {
+            if (locking && typeof this.manager.driver().acquireLock === 'function') {
+                const startTime = Date.now();
+                while (!locked) {
+                    locked = await this.manager.driver().acquireLock(sessionId, lockTimeout);
+                    if (locked)
+                        break;
+                    if (Date.now() - startTime > lockTimeout * 1000) {
+                        break; // Timeout reached, proceed anyway to prevent hanging forever
+                    }
+                    // Wait 50ms before retrying
+                    await new Promise(r => setTimeout(r, 50));
+                }
+            }
+            // 4. Run pipeline
+            const res = await next(request);
+            // 5. Persist session
+            await session.save();
+            // 6. Write cookie (always refresh TTL, or on new session)
+            if (isNewSession || session.isDirty() || !session.isDestroyed()) {
+                const cookieValue = session.isDestroyed()
+                    ? cookieHelper.clear(config.path ?? '/')
+                    : cookieHelper.write(session.getId(), {
+                        lifetime: config.lifetime * 60,
+                        path: config.path ?? '/',
+                        secure: config.secure ?? false,
+                        httpOnly: config.httpOnly ?? true,
+                        sameSite: config.sameSite ?? 'Lax',
+                    });
+                this.writeSetCookie(res, response, cookieValue);
+            }
+            // 7. GC with configured probability
+            const gcProbability = config.gcProbability ?? 0.01;
+            if (Math.random() < gcProbability) {
+                const maxLifetime = config.lifetime * 60;
+                this.manager.driver().gc(maxLifetime).catch(() => { });
+            }
+            return res;
+        }
+        finally {
+            if (locked && typeof this.manager.driver().releaseLock === 'function') {
+                await this.manager.driver().releaseLock(sessionId).catch(() => { });
+            }
+        }
+    }
+    writeSetCookie(res, fallbackResponse, cookieValue) {
+        const targetRes = res || fallbackResponse;
+        // If it's an ArikaJS Response object, push to its internal cookies array
+        if (targetRes && targetRes._cookies && Array.isArray(targetRes._cookies)) {
+            targetRes._cookies.push(cookieValue);
+            return;
+        }
+        // Try to write to the underlying Node.js ServerResponse before it is terminated
+        const nodeRes = targetRes?.raw ?? null;
+        if (nodeRes && typeof nodeRes.setHeader === 'function' && !nodeRes.headersSent) {
+            const existing = nodeRes.getHeader('Set-Cookie');
+            if (Array.isArray(existing)) {
+                nodeRes.setHeader('Set-Cookie', [...existing, cookieValue]);
+            }
+            else if (typeof existing === 'string') {
+                nodeRes.setHeader('Set-Cookie', [existing, cookieValue]);
+            }
+            else {
+                nodeRes.setHeader('Set-Cookie', cookieValue);
+            }
+        }
+    }
+}
+exports.StartSession = StartSession;
+//# sourceMappingURL=StartSession.js.map

package/dist/Middleware/StartSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartSession.js","sourceRoot":"","sources":["../../src/Middleware/StartSession.ts"],"names":[],"mappings":"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"}