@arikajs/session 0.0.5

package/dist/Session.d.ts

@@ -0,0 +1,88 @@
+import { SessionDriver } from './Contracts/SessionDriver';
+/**
+ * Per-request session instance.
+ *
+ * Features:
+ * - Lazy loading: session data is loaded from the driver only on first access
+ * - Write optimization: data is only persisted when it has been modified (dirty)
+ * - Flash data: one-request messages automatically cleared after the next request
+ * - Session regeneration: generate a new ID to prevent session fixation
+ */
+export declare class Session {
+    private readonly driver;
+    private _sessionId;
+    private readonly ttlSeconds;
+    private _data;
+    private _dirty;
+    private _destroyed;
+    private _newId;
+    constructor(driver: SessionDriver, _sessionId: string, ttlSeconds: number);
+    private ensureLoaded;
+    /**
+     * Get the current session ID.
+     */
+    getId(): string;
+    /**
+     * Check if the session has been modified.
+     */
+    isDirty(): boolean;
+    /**
+     * Check if the session has been destroyed.
+     */
+    isDestroyed(): boolean;
+    /**
+     * Set a value in the session.
+     */
+    set(key: string, value: any): Promise<void>;
+    /**
+     * Alias for set() — compatible with the old put() convention.
+     */
+    put(key: string, value: any): Promise<void>;
+    /**
+     * Get a value from the session. Returns defaultValue if not found.
+     */
+    get(key: string, defaultValue?: any): Promise<any>;
+    /**
+     * Check whether a key exists in the session.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Remove a key from the session.
+     */
+    forget(key: string): Promise<void>;
+    /**
+     * Return all session data.
+     */
+    all(): Promise<Record<string, any>>;
+    /**
+     * Store flash data — only available during the next request.
+     */
+    flash(key: string, value: any): Promise<void>;
+    /**
+     * Keep flash keys alive for one more request.
+     */
+    reflash(...keys: string[]): Promise<void>;
+    /**
+     * Completely destroy this session (removes from storage).
+     */
+    destroy(): Promise<void>;
+    /**
+     * Regenerate the session ID (prevents session fixation).
+     * The old session is destroyed and a new ID is created.
+     */
+    regenerate(): Promise<string>;
+    /**
+     * Persist session data back to the driver.
+     * Only writes if data has changed (write optimization).
+     */
+    save(): Promise<void>;
+    /**
+     * On load: remove flash keys from the PREVIOUS request (unless kept).
+     */
+    private ageFlashData;
+    /**
+     * On save: move __flash_new__ → __flash__ for the next request.
+     */
+    private prepareFlashForNextRequest;
+}
+//# sourceMappingURL=Session.d.ts.map

package/dist/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../src/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAOZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR/B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAuB;gBAGhB,MAAM,EAAE,aAAa,EAC9B,UAAU,EAAE,MAAM,EACT,UAAU,EAAE,MAAM;YAOzB,YAAY;IAa1B;;OAEG;IACI,KAAK,IAAI,MAAM;IAItB;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,GAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAKrE;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C;;OAEG;IACU,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAKhD;;OAEG;IACU,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1D;;OAEG;IACU,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAa1C;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAOrC"}

package/dist/Session.js

@@ -0,0 +1,232 @@
+"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.Session = void 0;
+/**
+ * Per-request session instance.
+ *
+ * Features:
+ * - Lazy loading: session data is loaded from the driver only on first access
+ * - Write optimization: data is only persisted when it has been modified (dirty)
+ * - Flash data: one-request messages automatically cleared after the next request
+ * - Session regeneration: generate a new ID to prevent session fixation
+ */
+class Session {
+    constructor(driver, _sessionId, ttlSeconds) {
+        this.driver = driver;
+        this._sessionId = _sessionId;
+        this.ttlSeconds = ttlSeconds;
+        this._data = null; // null = not yet loaded
+        this._dirty = false;
+        this._destroyed = false;
+        this._newId = null; // set when regenerated
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    //  Lazy loading
+    // ──────────────────────────────────────────────────────────────────────────
+    async ensureLoaded() {
+        if (this._data === null) {
+            const loaded = await this.driver.load(this._sessionId);
+            this._data = loaded ?? {};
+            // Age out flash data from the previous request
+            this.ageFlashData();
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    //  Public API
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Get the current session ID.
+     */
+    getId() {
+        return this._newId ?? this._sessionId;
+    }
+    /**
+     * Check if the session has been modified.
+     */
+    isDirty() {
+        return this._dirty;
+    }
+    /**
+     * Check if the session has been destroyed.
+     */
+    isDestroyed() {
+        return this._destroyed;
+    }
+    /**
+     * Set a value in the session.
+     */
+    async set(key, value) {
+        await this.ensureLoaded();
+        this._data[key] = value;
+        this._dirty = true;
+    }
+    /**
+     * Alias for set() — compatible with the old put() convention.
+     */
+    async put(key, value) {
+        return this.set(key, value);
+    }
+    /**
+     * Get a value from the session. Returns defaultValue if not found.
+     */
+    async get(key, defaultValue = null) {
+        await this.ensureLoaded();
+        return key in this._data ? this._data[key] : defaultValue;
+    }
+    /**
+     * Check whether a key exists in the session.
+     */
+    async has(key) {
+        await this.ensureLoaded();
+        return key in this._data;
+    }
+    /**
+     * Remove a key from the session.
+     */
+    async forget(key) {
+        await this.ensureLoaded();
+        if (key in this._data) {
+            delete this._data[key];
+            this._dirty = true;
+        }
+    }
+    /**
+     * Return all session data.
+     */
+    async all() {
+        await this.ensureLoaded();
+        return { ...this._data };
+    }
+    /**
+     * Store flash data — only available during the next request.
+     */
+    async flash(key, value) {
+        await this.ensureLoaded();
+        this._data[key] = value;
+        // Track which keys are flash so we can purge them
+        const flashKeys = this._data['__flash__'] ?? [];
+        if (!flashKeys.includes(key))
+            flashKeys.push(key);
+        this._data['__flash__'] = flashKeys;
+        this._dirty = true;
+    }
+    /**
+     * Keep flash keys alive for one more request.
+     */
+    async reflash(...keys) {
+        await this.ensureLoaded();
+        const flashKeys = this._data['__flash__'] ?? [];
+        const keepKeys = this._data['__flash_keep__'] ?? [];
+        const targets = keys.length > 0 ? keys : flashKeys;
+        for (const k of targets) {
+            if (!keepKeys.includes(k))
+                keepKeys.push(k);
+        }
+        this._data['__flash_keep__'] = keepKeys;
+        this._dirty = true;
+    }
+    /**
+     * Completely destroy this session (removes from storage).
+     */
+    async destroy() {
+        await this.driver.destroy(this._sessionId);
+        this._data = {};
+        this._dirty = false;
+        this._destroyed = true;
+    }
+    /**
+     * Regenerate the session ID (prevents session fixation).
+     * The old session is destroyed and a new ID is created.
+     */
+    async regenerate() {
+        await this.ensureLoaded();
+        await this.driver.destroy(this._sessionId);
+        const crypto = await Promise.resolve().then(() => __importStar(require('node:crypto')));
+        this._newId = crypto.randomBytes(20).toString('hex');
+        this._dirty = true;
+        return this._newId;
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    //  Lifecycle (called by StartSession middleware)
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * Persist session data back to the driver.
+     * Only writes if data has changed (write optimization).
+     */
+    async save() {
+        if (this._destroyed)
+            return;
+        if (this._data === null)
+            return; // never accessed, skip write
+        // Promote next-request flash keys
+        this.prepareFlashForNextRequest();
+        if (this._dirty) {
+            const id = this._newId ?? this._sessionId;
+            await this.driver.save(id, this._data, this.ttlSeconds);
+        }
+    }
+    // ──────────────────────────────────────────────────────────────────────────
+    //  Flash internals
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * On load: remove flash keys from the PREVIOUS request (unless kept).
+     */
+    ageFlashData() {
+        const flashKeys = this._data['__flash__'] ?? [];
+        const keepKeys = this._data['__flash_keep__'] ?? [];
+        for (const key of flashKeys) {
+            if (!keepKeys.includes(key)) {
+                delete this._data[key];
+            }
+        }
+        // Reset tracking
+        this._data['__flash__'] = [];
+        this._data['__flash_keep__'] = [];
+    }
+    /**
+     * On save: move __flash_new__ → __flash__ for the next request.
+     */
+    prepareFlashForNextRequest() {
+        if (!this._data)
+            return;
+        const newFlash = this._data['__flash_new__'] ?? [];
+        const existing = this._data['__flash__'] ?? [];
+        this._data['__flash__'] = [...new Set([...existing, ...newFlash])];
+        delete this._data['__flash_new__'];
+    }
+}
+exports.Session = Session;
+//# sourceMappingURL=Session.js.map

package/dist/Session.js.map

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

package/dist/SessionManager.d.ts

@@ -0,0 +1,51 @@
+import { SessionDriver } from './Contracts/SessionDriver';
+import { Session } from './Session';
+import { CookieSessionId } from './CookieSessionId';
+export interface SessionConfig {
+    driver: string;
+    lifetime: number;
+    cookie: string;
+    path: string;
+    storagePath: string;
+    secure: boolean;
+    httpOnly: boolean;
+    sameSite: string;
+    locking: boolean;
+    lockTimeout: number;
+    gcProbability: number;
+    secret: string;
+    connection?: any;
+    table?: string;
+    prefix?: string;
+}
+/**
+ * SessionManager creates and manages session instances backed by configurable drivers.
+ */
+export declare class SessionManager {
+    private readonly config;
+    private customCreators;
+    private driverInstances;
+    constructor(config: SessionConfig);
+    /**
+     * Resolve a driver instance (cached per driver name).
+     */
+    driver(name?: string): SessionDriver;
+    /**
+     * Create a new Session instance for the given raw session ID (from cookie).
+     */
+    createSession(sessionId: string): Session;
+    /**
+     * The CookieSessionId helper for reading/writing session cookies.
+     */
+    getCookieHelper(): CookieSessionId;
+    /**
+     * Register a custom driver factory.
+     */
+    extend(driverName: string, factory: (config: SessionConfig) => SessionDriver): this;
+    private createDriver;
+    private createMemoryDriver;
+    private createFileDriver;
+    private createRedisDriver;
+    private createDatabaseDriver;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../src/SessionManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,cAAc;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,cAAc,CAAoE;IAC1F,OAAO,CAAC,eAAe,CAAyC;gBAEnC,MAAM,EAAE,aAAa;IAElD;;OAEG;IACI,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAU3C;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQhD;;OAEG;IACI,eAAe,IAAI,eAAe;IAIzC;;OAEG;IACI,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,GAAG,IAAI;IAK1F,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,oBAAoB;CAM/B"}

package/dist/SessionManager.js

@@ -0,0 +1,117 @@
+"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.SessionManager = void 0;
+const path = __importStar(require("node:path"));
+const MemoryDriver_1 = require("./Drivers/MemoryDriver");
+const FileDriver_1 = require("./Drivers/FileDriver");
+const RedisDriver_1 = require("./Drivers/RedisDriver");
+const DatabaseDriver_1 = require("./Drivers/DatabaseDriver");
+const Session_1 = require("./Session");
+const CookieSessionId_1 = require("./CookieSessionId");
+/**
+ * SessionManager creates and manages session instances backed by configurable drivers.
+ */
+class SessionManager {
+    constructor(config) {
+        this.config = config;
+        this.customCreators = new Map();
+        this.driverInstances = new Map();
+    }
+    /**
+     * Resolve a driver instance (cached per driver name).
+     */
+    driver(name) {
+        const driverName = name ?? this.config.driver;
+        if (!this.driverInstances.has(driverName)) {
+            this.driverInstances.set(driverName, this.createDriver(driverName));
+        }
+        return this.driverInstances.get(driverName);
+    }
+    /**
+     * Create a new Session instance for the given raw session ID (from cookie).
+     */
+    createSession(sessionId) {
+        return new Session_1.Session(this.driver(), sessionId, this.config.lifetime * 60);
+    }
+    /**
+     * The CookieSessionId helper for reading/writing session cookies.
+     */
+    getCookieHelper() {
+        return new CookieSessionId_1.CookieSessionId(this.config.cookie, this.config.secret);
+    }
+    /**
+     * Register a custom driver factory.
+     */
+    extend(driverName, factory) {
+        this.customCreators.set(driverName, factory);
+        return this;
+    }
+    createDriver(name) {
+        if (this.customCreators.has(name)) {
+            return this.customCreators.get(name)(this.config);
+        }
+        switch (name) {
+            case 'memory': return this.createMemoryDriver();
+            case 'file': return this.createFileDriver();
+            case 'redis': return this.createRedisDriver();
+            case 'database': return this.createDatabaseDriver();
+            default:
+                throw new Error(`Session driver [${name}] is not supported.`);
+        }
+    }
+    createMemoryDriver() {
+        return new MemoryDriver_1.MemoryDriver();
+    }
+    createFileDriver() {
+        const p = this.config.storagePath;
+        const absPath = path.isAbsolute(p) ? p : path.resolve(process.cwd(), p);
+        return new FileDriver_1.FileDriver(absPath);
+    }
+    createRedisDriver() {
+        if (!this.config.connection) {
+            throw new Error('Redis connection is required for the [redis] session driver.');
+        }
+        return new RedisDriver_1.RedisDriver(this.config.connection, this.config.prefix ?? 'arika_session:');
+    }
+    createDatabaseDriver() {
+        if (!this.config.connection) {
+            throw new Error('Database connection is required for the [database] session driver.');
+        }
+        return new DatabaseDriver_1.DatabaseDriver(this.config.connection, this.config.table ?? 'sessions');
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=SessionManager.js.map

package/dist/SessionManager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Session } from './Session';
+export { SessionManager } from './SessionManager';
+export { CookieSessionId } from './CookieSessionId';
+export { StartSession } from './Middleware/StartSession';
+export { SessionDriver } from './Contracts/SessionDriver';
+export { MemoryDriver } from './Drivers/MemoryDriver';
+export { FileDriver } from './Drivers/FileDriver';
+export { RedisDriver } from './Drivers/RedisDriver';
+export { DatabaseDriver } from './Drivers/DatabaseDriver';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseDriver = exports.RedisDriver = exports.FileDriver = exports.MemoryDriver = exports.StartSession = exports.CookieSessionId = exports.SessionManager = exports.Session = void 0;
+var Session_1 = require("./Session");
+Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return Session_1.Session; } });
+var SessionManager_1 = require("./SessionManager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return SessionManager_1.SessionManager; } });
+var CookieSessionId_1 = require("./CookieSessionId");
+Object.defineProperty(exports, "CookieSessionId", { enumerable: true, get: function () { return CookieSessionId_1.CookieSessionId; } });
+var StartSession_1 = require("./Middleware/StartSession");
+Object.defineProperty(exports, "StartSession", { enumerable: true, get: function () { return StartSession_1.StartSession; } });
+var MemoryDriver_1 = require("./Drivers/MemoryDriver");
+Object.defineProperty(exports, "MemoryDriver", { enumerable: true, get: function () { return MemoryDriver_1.MemoryDriver; } });
+var FileDriver_1 = require("./Drivers/FileDriver");
+Object.defineProperty(exports, "FileDriver", { enumerable: true, get: function () { return FileDriver_1.FileDriver; } });
+var RedisDriver_1 = require("./Drivers/RedisDriver");
+Object.defineProperty(exports, "RedisDriver", { enumerable: true, get: function () { return RedisDriver_1.RedisDriver; } });
+var DatabaseDriver_1 = require("./Drivers/DatabaseDriver");
+Object.defineProperty(exports, "DatabaseDriver", { enumerable: true, get: function () { return DatabaseDriver_1.DatabaseDriver; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,0DAAyD;AAAhD,4GAAA,YAAY,OAAA;AAErB,uDAAsD;AAA7C,4GAAA,YAAY,OAAA;AACrB,mDAAkD;AAAzC,wGAAA,UAAU,OAAA;AACnB,qDAAoD;AAA3C,0GAAA,WAAW,OAAA;AACpB,2DAA0D;AAAjD,gHAAA,cAAc,OAAA"}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "@arikajs/session",
+    "version": "0.0.5",
+    "description": "Powerful, secure, driver-based session management for the ArikaJS framework.",
+    "license": "MIT",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "clean": "rm -rf dist",
+        "prepare": "echo skip",
+        "dev": "tsc -p tsconfig.json --watch"
+    },
+    "files": [
+        "dist"
+    ],
+    "keywords": [
+        "arika",
+        "arika-js",
+        "session",
+        "middleware",
+        "cookies",
+        "web"
+    ],
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ArikaJs/arikajs.git",
+        "directory": "packages/session"
+    },
+    "bugs": {
+        "url": "https://github.com/ArikaJs/arikajs/issues"
+    },
+    "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/session#readme",
+    "dependencies": {
+        "cookie": "^0.6.0",
+        "ioredis": "^5.3.2"
+    },
+    "devDependencies": {
+        "@types/cookie": "^0.6.0",
+        "@types/node": "^20.11.24",
+        "typescript": "^5.3.3"
+    },
+    "author": "Prakash Tank"
+}