ioredis-toolkit 0.0.9 → 0.5.0

package/dist/redis/config.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { RedisConfigurationError } from './errors.js';
+const endpoint = z.object({
+    host: z.string().min(1),
+    port: z.number().int().min(1).max(65535),
+});
+/** Runtime schema for the standalone Redis connection subset accepted by this package. */
+export const RedisConnectionConfigSchema = z.preprocess((input) => {
+    if (input && typeof input === 'object' && !('mode' in input)) {
+        return { ...input, mode: 'standalone' };
+    }
+    return input;
+}, z.discriminatedUnion('mode', [
+    z.object({
+        mode: z.literal('standalone'),
+        host: z.string().default('127.0.0.1'),
+        port: z.number().int().min(1).max(65535).default(6379),
+        password: z.string().optional(),
+        username: z.string().optional(),
+        db: z.number().int().nonnegative().default(0),
+        tls: z.unknown().optional(),
+    }).passthrough(),
+    z.object({
+        mode: z.literal('sentinel'),
+        sentinels: z.array(endpoint).min(1),
+        name: z.string().min(1),
+        username: z.string().optional(),
+        password: z.string().optional(),
+        db: z.number().int().nonnegative().default(0),
+        tls: z.unknown().optional(),
+    }).passthrough(),
+    z.object({
+        mode: z.literal('cluster'),
+        nodes: z.array(endpoint).min(1),
+        redisOptions: z.record(z.string(), z.unknown()).optional(),
+    }).passthrough(),
+]));
+/**
+ * Validates the public Redis connection configuration and returns it in the
+ * package's topology-independent shape. Unsupported extra ioredis options are
+ * preserved so advanced users can still configure retries, TLS, timeouts, and
+ * other supported client features. `mode` may be omitted for standalone Redis,
+ * matching {@link StandaloneRedisConfig}'s optional `mode` field.
+ */
+export function parseRedisConnectionConfig(input) {
+    const result = RedisConnectionConfigSchema.safeParse(input ?? {});
+    if (!result.success) {
+        throw new RedisConfigurationError(result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; '));
+    }
+    return result.data;
+}
+//# sourceMappingURL=config.js.map

package/dist/redis/config.js.map

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

package/dist/redis/errors.d.ts

@@ -0,0 +1,5 @@
+/** Thrown when Redis connection configuration is invalid, or a module is used while disabled. */
+export declare class RedisConfigurationError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/redis/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/redis/errors.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CACpD"}

package/dist/redis/errors.js

@@ -0,0 +1,5 @@
+/** Thrown when Redis connection configuration is invalid, or a module is used while disabled. */
+export class RedisConfigurationError extends Error {
+    constructor(message, options) { super(message, options); this.name = 'RedisConfigurationError'; }
+}
+//# sourceMappingURL=errors.js.map

package/dist/redis/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/redis/errors.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe,EAAE,OAAsB,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC,CAAC,CAAC;CACzH"}

package/dist/redis/types.d.ts

@@ -0,0 +1,135 @@
+import type { Cluster, ClusterNode, ClusterOptions, Redis, RedisOptions } from 'ioredis';
+/** Supported Redis deployment topologies. */
+export type RedisMode = 'standalone' | 'sentinel' | 'cluster';
+/** Connection options for a single Redis server. */
+export interface StandaloneRedisConfig extends RedisOptions {
+    /** Selects standalone Redis. Optional for backwards-compatible single-node configuration. */
+    mode?: 'standalone';
+}
+/** Connection options for Redis Sentinel. */
+export interface SentinelRedisConfig extends RedisOptions {
+    /** Selects Sentinel mode. */
+    mode: 'sentinel';
+    /** Sentinel endpoints used to discover the current master. */
+    sentinels: Array<{
+        host: string;
+        port: number;
+    }>;
+    /** Sentinel master service name. */
+    name: string;
+}
+/** Connection options for Redis Cluster. */
+export interface ClusterRedisConfig extends ClusterOptions {
+    /** Selects Cluster mode. */
+    mode: 'cluster';
+    /** Initial cluster startup nodes. */
+    nodes: ClusterNode[];
+}
+/** Union of supported Redis topology configurations. */
+export type RedisConfig = StandaloneRedisConfig | SentinelRedisConfig | ClusterRedisConfig;
+/** Runtime connection type created by this package. */
+export type RedisConnection = Redis | Cluster;
+/** Options controlling bounded fan-out against Redis Cluster nodes/slots. */
+export interface ClusterFanoutOptions {
+    /** Maximum number of concurrent node/slot operations. Defaults to a conservative value. */
+    concurrency?: number;
+}
+/** Minimal Redis command surface consumed by the package modules. */
+export interface RedisCommandClient {
+    /** Reads a string value. */
+    get(key: string): Promise<string | null>;
+    /** Writes a string value with raw Redis option arguments. */
+    set(key: string, value: string, ...args: string[]): Promise<string | null>;
+    /** Performs legacy SETNX. */
+    setnx(key: string, value: string): Promise<number>;
+    /** Deletes one or more keys. */
+    del(...keys: string[]): Promise<number>;
+    /** Returns the number of existing keys. */
+    exists(...keys: string[]): Promise<number>;
+    /** Sets a TTL in seconds. */
+    expire(key: string, seconds: number): Promise<number>;
+    /** Sets a TTL in milliseconds. */
+    pexpire(key: string, milliseconds: number): Promise<number>;
+    /** Reads TTL in seconds. */
+    ttl(key: string): Promise<number>;
+    /** Adds one sorted-set member. */
+    zadd(key: string, score: number, member: string): Promise<number>;
+    /** Removes sorted-set members. */
+    zrem(key: string, ...members: string[]): Promise<number>;
+    /** Returns sorted-set cardinality. */
+    zcard(key: string): Promise<number>;
+    /** Reads one sorted-set member score. */
+    zscore(key: string, member: string): Promise<string | null>;
+    /** Reads sorted-set members by rank. */
+    zrange(key: string, start: number, stop: number, ...args: string[]): Promise<string[]>;
+    /** Reads sorted-set members by score. */
+    zrangebyscore(key: string, min: string | number, max: string | number, ...args: string[]): Promise<string[]>;
+    /** Pops the lowest-score sorted-set members. */
+    zpopmin(key: string, count?: number): Promise<string[]>;
+    /** Atomically increments an integer value. */
+    incrby(key: string, increment: number): Promise<number>;
+    /** Atomically decrements an integer value. */
+    decrby(key: string, decrement: number): Promise<number>;
+    /** Executes a cached Lua script by SHA. */
+    evalsha(sha: string, numKeys: number, ...args: string[]): Promise<unknown>;
+    /** Executes Lua source directly. */
+    eval(script: string, numKeys: number, ...args: string[]): Promise<unknown>;
+    /** Loads Lua source and returns its SHA-1. */
+    script(command: 'LOAD', script: string): Promise<string>;
+    /** Reads Redis server time. */
+    time(): Promise<[string, string]>;
+    /** Pings Redis. */
+    ping(): Promise<string>;
+    /** Scans keys from one Redis node. */
+    scan(cursor: string, ...args: string[]): Promise<[string, string[]]>;
+    /** Publishes a string message. */
+    publish(channel: string, message: string): Promise<number>;
+    /** Appends a Redis Stream entry. */
+    xadd(key: string, ...args: string[]): Promise<string>;
+    /** Executes an XGROUP CREATE operation. */
+    xgroup(command: 'CREATE', key: string, group: string, id: string, ...args: string[]): Promise<string>;
+    /** Reads a Redis Stream. */
+    xread(...args: string[]): Promise<unknown>;
+    /** Reads a Redis Stream through a consumer group. */
+    xreadgroup(...args: string[]): Promise<unknown>;
+    /** Acknowledges consumer-group entries. */
+    xack(key: string, group: string, ...ids: string[]): Promise<number>;
+    /** Deletes Stream entries. */
+    xdel(key: string, ...ids: string[]): Promise<number>;
+    /** Returns Stream length. */
+    xlen(key: string): Promise<number>;
+    /** Creates a Redis pipeline. */
+    pipeline(): RedisPipeline;
+    /** Reads multiple values in input-key order. */
+    mget(...keys: string[]): Promise<Array<string | null>>;
+    /** Creates a dedicated duplicate connection, e.g. for Pub/Sub consumers. */
+    duplicateConnection(): RedisConnection;
+    /** Reads multiple keys while preserving input order and grouping Cluster requests by slot. */
+    mgetClusterAware(keys: string[], options?: ClusterFanoutOptions): Promise<Array<string | null>>;
+    /** Scans all master nodes in Cluster mode or the standalone server otherwise. */
+    scanCluster(pattern: string, count?: number, options?: ClusterFanoutOptions): Promise<string[]>;
+    /** Scans and deletes matching keys without using `KEYS`, `FLUSHDB`, or cross-slot multi-key commands. */
+    deletePatternClusterAware(pattern: string, options?: ClusterFanoutOptions): Promise<number>;
+}
+/** Minimal pipeline surface needed by this package. */
+export interface RedisPipeline {
+    /** Queues GET. */
+    get(key: string): RedisPipeline;
+    /** Queues EXISTS. */
+    exists(key: string): RedisPipeline;
+    /** Queues DEL. */
+    del(...keys: string[]): RedisPipeline;
+    /** Queues ZRANGE. */
+    zrange(key: string, start: number, stop: number, ...args: string[]): RedisPipeline;
+    /** Queues ZREM. */
+    zrem(key: string, ...members: string[]): RedisPipeline;
+    /** Queues ZSCORE. */
+    zscore(key: string, member: string): RedisPipeline;
+    /** Queues SET. */
+    set(key: string, value: string, ...args: string[]): RedisPipeline;
+    /** Queues EXPIRE. */
+    expire(key: string, seconds: number): RedisPipeline;
+    /** Executes the pipeline. Each tuple contains a command-level error and result. */
+    exec(): Promise<Array<[Error | null, unknown]> | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/redis/types.d.ts.map

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

package/dist/redis/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/redis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/redis/types.ts"],"names":[],"mappings":""}

package/dist/redis/wrapper.d.ts

@@ -0,0 +1,88 @@
+import type { ClusterFanoutOptions, RedisCommandClient, RedisConnection, RedisPipeline } from './types.js';
+export type { ClusterFanoutOptions } from './types.js';
+/**
+ * Topology-independent Redis command adapter.
+ *
+ * The wrapper deliberately exposes only the commands required by this package and
+ * centralizes Cluster-aware multi-key behavior so higher-level modules remain topology agnostic.
+ */
+export declare class RedisClientWrapper implements RedisCommandClient {
+    private readonly client;
+    /** Creates a wrapper around an existing ioredis Redis or Cluster connection. */
+    constructor(client: RedisConnection);
+    /** Reads a string value. */
+    get(key: string): Promise<string | null>;
+    /** Writes a string value using raw Redis option arguments. */
+    set(key: string, value: string, ...args: string[]): Promise<string | null>;
+    /** Reads multiple values in input-key order. */
+    mget(...keys: string[]): Promise<Array<string | null>>;
+    /** Performs SETNX. */
+    setnx(key: string, value: string): Promise<number>;
+    /** Deletes keys, splitting cross-slot deletions into safe groups in Cluster mode. */
+    del(...keys: string[]): Promise<number>;
+    /** Returns the number of existing keys. */
+    exists(...keys: string[]): Promise<number>;
+    /** Sets an expiration in seconds. */
+    expire(key: string, seconds: number): Promise<number>;
+    /** Sets an expiration in milliseconds. */
+    pexpire(key: string, milliseconds: number): Promise<number>;
+    /** Reads remaining TTL in seconds. */
+    ttl(key: string): Promise<number>;
+    /** Adds one sorted-set member. */
+    zadd(key: string, score: number, member: string): Promise<number>;
+    /** Removes sorted-set members. */
+    zrem(key: string, ...members: string[]): Promise<number>;
+    /** Returns sorted-set cardinality. */
+    zcard(key: string): Promise<number>;
+    /** Reads a sorted-set member score. */
+    zscore(key: string, member: string): Promise<string | null>;
+    /** Reads sorted-set members by rank. */
+    zrange(key: string, start: number, stop: number, ...args: string[]): Promise<string[]>;
+    /** Reads sorted-set members by score. */
+    zrangebyscore(key: string, min: string | number, max: string | number, ...args: string[]): Promise<string[]>;
+    /** Pops the lowest sorted-set members. */
+    zpopmin(key: string, count?: number): Promise<string[]>;
+    /** Atomically increments an integer. */
+    incrby(key: string, increment: number): Promise<number>;
+    /** Atomically decrements an integer. */
+    decrby(key: string, decrement: number): Promise<number>;
+    /** Executes a cached Lua script. */
+    evalsha(sha: string, numKeys: number, ...args: string[]): Promise<unknown>;
+    /** Executes Lua source. */
+    eval(script: string, numKeys: number, ...args: string[]): Promise<unknown>;
+    /** Loads a Lua script. */
+    script(command: 'LOAD', script: string): Promise<string>;
+    /** Reads server time. */
+    time(): Promise<[string, string]>;
+    /** Pings Redis. */
+    ping(): Promise<string>;
+    /** Scans one Redis node or the standalone server. */
+    scan(cursor: string, ...args: string[]): Promise<[string, string[]]>;
+    /** Publishes a string message. */
+    publish(channel: string, message: string): Promise<number>;
+    /** Appends a Stream entry. */
+    xadd(key: string, ...args: string[]): Promise<string>;
+    /** Creates a consumer group. */
+    xgroup(command: 'CREATE', key: string, group: string, id: string, ...args: string[]): Promise<string>;
+    /** Reads Stream entries. */
+    xread(...args: string[]): Promise<unknown>;
+    /** Reads Stream entries through a consumer group. */
+    xreadgroup(...args: string[]): Promise<unknown>;
+    /** Acknowledges Stream entries. */
+    xack(key: string, group: string, ...ids: string[]): Promise<number>;
+    /** Deletes Stream entries. */
+    xdel(key: string, ...ids: string[]): Promise<number>;
+    /** Returns Stream length. */
+    xlen(key: string): Promise<number>;
+    /** Creates a pipeline. Command-level errors must be inspected in the returned tuples. */
+    pipeline(): RedisPipeline;
+    /** Creates a dedicated duplicate connection for Pub/Sub consumers. */
+    duplicateConnection(): RedisConnection;
+    /** Reads multiple keys while preserving input order and grouping Cluster requests by slot. */
+    mgetClusterAware(keys: string[], options?: ClusterFanoutOptions): Promise<Array<string | null>>;
+    /** Scans all master nodes in Cluster mode or the standalone server otherwise. */
+    scanCluster(pattern: string, count?: number, options?: ClusterFanoutOptions): Promise<string[]>;
+    /** Scans and deletes matching keys without using `KEYS`, `FLUSHDB`, or cross-slot multi-key commands. */
+    deletePatternClusterAware(pattern: string, options?: ClusterFanoutOptions): Promise<number>;
+}
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/redis/wrapper.d.ts.map

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

package/dist/redis/wrapper.js

@@ -0,0 +1,206 @@
+import { Cluster } from 'ioredis';
+import { redisHashSlot } from './cluster.js';
+/**
+ * Topology-independent Redis command adapter.
+ *
+ * The wrapper deliberately exposes only the commands required by this package and
+ * centralizes Cluster-aware multi-key behavior so higher-level modules remain topology agnostic.
+ */
+export class RedisClientWrapper {
+    client;
+    /** Creates a wrapper around an existing ioredis Redis or Cluster connection. */
+    constructor(client) {
+        this.client = client;
+    }
+    /** Reads a string value. */
+    get(key) { return this.client.get(key); }
+    /** Writes a string value using raw Redis option arguments. */
+    set(key, value, ...args) {
+        return this.client.set(key, value, ...args);
+    }
+    /** Reads multiple values in input-key order. */
+    mget(...keys) {
+        return this.client.mget(...keys);
+    }
+    /** Performs SETNX. */
+    setnx(key, value) { return this.client.setnx(key, value); }
+    /** Deletes keys, splitting cross-slot deletions into safe groups in Cluster mode. */
+    async del(...keys) {
+        if (keys.length <= 1 || !(this.client instanceof Cluster))
+            return this.client.del(...keys);
+        const groups = new Map();
+        for (const key of keys) {
+            const slot = redisHashSlot(key);
+            const group = groups.get(slot) ?? [];
+            group.push(key);
+            groups.set(slot, group);
+        }
+        let deleted = 0;
+        await boundedMap([...groups.values()], 4, async (group) => {
+            for (const batch of chunk(group, 200))
+                deleted += await this.client.del(...batch);
+        });
+        return deleted;
+    }
+    /** Returns the number of existing keys. */
+    exists(...keys) { return this.client.exists(...keys); }
+    /** Sets an expiration in seconds. */
+    expire(key, seconds) { return this.client.expire(key, seconds); }
+    /** Sets an expiration in milliseconds. */
+    pexpire(key, milliseconds) { return this.client.pexpire(key, milliseconds); }
+    /** Reads remaining TTL in seconds. */
+    ttl(key) { return this.client.ttl(key); }
+    /** Adds one sorted-set member. */
+    zadd(key, score, member) { return this.client.zadd(key, score, member); }
+    /** Removes sorted-set members. */
+    zrem(key, ...members) { return this.client.zrem(key, ...members); }
+    /** Returns sorted-set cardinality. */
+    zcard(key) { return this.client.zcard(key); }
+    /** Reads a sorted-set member score. */
+    zscore(key, member) { return this.client.zscore(key, member); }
+    /** Reads sorted-set members by rank. */
+    zrange(key, start, stop, ...args) {
+        return this.client.zrange(key, String(start), String(stop), ...args);
+    }
+    /** Reads sorted-set members by score. */
+    zrangebyscore(key, min, max, ...args) {
+        return this.client.zrangebyscore(key, String(min), String(max), ...args);
+    }
+    /** Pops the lowest sorted-set members. */
+    zpopmin(key, count) { return count === undefined ? this.client.zpopmin(key) : this.client.zpopmin(key, count); }
+    /** Atomically increments an integer. */
+    incrby(key, increment) { return this.client.incrby(key, increment); }
+    /** Atomically decrements an integer. */
+    decrby(key, decrement) { return this.client.decrby(key, decrement); }
+    /** Executes a cached Lua script. */
+    evalsha(sha, numKeys, ...args) { return this.client.evalsha(sha, numKeys, ...args); }
+    /** Executes Lua source. */
+    eval(script, numKeys, ...args) { return this.client.eval(script, numKeys, ...args); }
+    /** Loads a Lua script. */
+    script(command, script) {
+        return this.client.script(command, script);
+    }
+    /** Reads server time. */
+    time() {
+        return this.client.time().then(([seconds, microseconds]) => [String(seconds), String(microseconds)]);
+    }
+    /** Pings Redis. */
+    ping() { return this.client.ping(); }
+    /** Scans one Redis node or the standalone server. */
+    scan(cursor, ...args) {
+        return this.client.scan(cursor, ...args);
+    }
+    /** Publishes a string message. */
+    publish(channel, message) { return this.client.publish(channel, message); }
+    /** Appends a Stream entry. */
+    xadd(key, ...args) {
+        return this.client.xadd(key, ...args);
+    }
+    /** Creates a consumer group. */
+    xgroup(command, key, group, id, ...args) {
+        return this.client.xgroup(command, key, group, id, ...args);
+    }
+    /** Reads Stream entries. */
+    xread(...args) {
+        return this.client.xread(...args);
+    }
+    /** Reads Stream entries through a consumer group. */
+    xreadgroup(...args) {
+        return this.client.xreadgroup(...args);
+    }
+    /** Acknowledges Stream entries. */
+    xack(key, group, ...ids) { return this.client.xack(key, group, ...ids); }
+    /** Deletes Stream entries. */
+    xdel(key, ...ids) { return this.client.xdel(key, ...ids); }
+    /** Returns Stream length. */
+    xlen(key) { return this.client.xlen(key); }
+    /** Creates a pipeline. Command-level errors must be inspected in the returned tuples. */
+    pipeline() { return this.client.pipeline(); }
+    /** Creates a dedicated duplicate connection for Pub/Sub consumers. */
+    duplicateConnection() { return this.client.duplicate(); }
+    /** Reads multiple keys while preserving input order and grouping Cluster requests by slot. */
+    async mgetClusterAware(keys, options = {}) {
+        if (keys.length === 0)
+            return [];
+        if (!(this.client instanceof Cluster))
+            return this.client.mget(...keys);
+        const grouped = new Map();
+        keys.forEach((key, index) => {
+            const slot = redisHashSlot(key);
+            const group = grouped.get(slot) ?? [];
+            group.push({ key, index });
+            grouped.set(slot, group);
+        });
+        const result = Array.from({ length: keys.length }, () => null);
+        await boundedMap([...grouped.values()], options.concurrency ?? 4, async (group) => {
+            const values = await this.client.mget(...group.map(item => item.key));
+            values.forEach((value, index) => { result[group[index].index] = value; });
+        });
+        return result;
+    }
+    /** Scans all master nodes in Cluster mode or the standalone server otherwise. */
+    async scanCluster(pattern, count = 500, options = {}) {
+        if (!(this.client instanceof Cluster)) {
+            const out = [];
+            let cursor = '0';
+            do {
+                const [next, keys] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', String(count));
+                out.push(...keys);
+                cursor = next;
+            } while (cursor !== '0');
+            return out;
+        }
+        const nodes = this.client.nodes('master');
+        const out = [];
+        await boundedMap(nodes, options.concurrency ?? 2, async (node) => {
+            let cursor = '0';
+            do {
+                const [next, keys] = await node.scan(cursor, 'MATCH', pattern, 'COUNT', String(count));
+                out.push(...keys);
+                cursor = next;
+            } while (cursor !== '0');
+        });
+        return out;
+    }
+    /** Scans and deletes matching keys without using `KEYS`, `FLUSHDB`, or cross-slot multi-key commands. */
+    async deletePatternClusterAware(pattern, options = {}) {
+        const keys = await this.scanCluster(pattern, 500, options);
+        if (keys.length === 0)
+            return 0;
+        if (!(this.client instanceof Cluster))
+            return this.del(...keys);
+        const groups = new Map();
+        for (const key of keys) {
+            const slot = redisHashSlot(key);
+            const group = groups.get(slot) ?? [];
+            group.push(key);
+            groups.set(slot, group);
+        }
+        let deleted = 0;
+        await boundedMap([...groups.values()], options.concurrency ?? 4, async (group) => {
+            for (const batch of chunk(group, 200))
+                deleted += await this.del(...batch);
+        });
+        return deleted;
+    }
+}
+/** Runs bounded concurrent asynchronous work over an array. */
+async function boundedMap(items, concurrency, fn) {
+    const width = Math.max(1, Math.min(Math.floor(concurrency), items.length || 1));
+    let cursor = 0;
+    const worker = async () => {
+        while (cursor < items.length) {
+            const index = cursor++;
+            await fn(items[index]);
+        }
+    };
+    await Promise.all(Array.from({ length: width }, () => worker()));
+}
+/** Splits an array into bounded chunks. */
+function chunk(items, size) {
+    const out = [];
+    for (let i = 0; i < items.length; i += size)
+        out.push(items.slice(i, i + size));
+    return out;
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/redis/wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../../src/redis/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAEA;IAD7B,gFAAgF;IAChF,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IACxD,4BAA4B;IAC5B,GAAG,CAAC,GAAW,IAA4B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzE,8DAA8D;IAC9D,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,GAAG,IAAc;QAC/C,OAAQ,IAAI,CAAC,MAAM,CAAC,GAA6D,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACzG,CAAC;IACD,gDAAgD;IAChD,IAAI,CAAC,GAAG,IAAc;QACpB,OAAQ,IAAI,CAAC,MAAM,CAAC,IAAqE,CAAC,GAAG,IAAI,CAAC,CAAC;IACrG,CAAC;IACD,sBAAsB;IACtB,KAAK,CAAC,GAAW,EAAE,KAAa,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5F,qFAAqF;IACrF,KAAK,CAAC,GAAG,CAAC,GAAG,IAAc;QACzB,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,YAAY,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACtD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE,OAAO,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,2CAA2C;IAC3C,MAAM,CAAC,GAAG,IAAc,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF,qCAAqC;IACrC,MAAM,CAAC,GAAW,EAAE,OAAe,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClG,0CAA0C;IAC1C,OAAO,CAAC,GAAW,EAAE,YAAoB,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9G,sCAAsC;IACtC,GAAG,CAAC,GAAW,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClE,kCAAkC;IAClC,IAAI,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClH,kCAAkC;IAClC,IAAI,CAAC,GAAW,EAAE,GAAG,OAAiB,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtG,sCAAsC;IACtC,KAAK,CAAC,GAAW,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtE,uCAAuC;IACvC,MAAM,CAAC,GAAW,EAAE,MAAc,IAA4B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACvG,wCAAwC;IACxC,MAAM,CAAC,GAAW,EAAE,KAAa,EAAE,IAAY,EAAE,GAAG,IAAc;QAChE,OAAQ,IAAI,CAAC,MAAM,CAAC,MAA2D,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7H,CAAC;IACD,yCAAyC;IACzC,aAAa,CAAC,GAAW,EAAE,GAAoB,EAAE,GAAoB,EAAE,GAAG,IAAc;QACtF,OAAQ,IAAI,CAAC,MAAM,CAAC,aAAkE,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACjI,CAAC;IACD,0CAA0C;IAC1C,OAAO,CAAC,GAAW,EAAE,KAAc,IAAuB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACpJ,wCAAwC;IACxC,MAAM,CAAC,GAAW,EAAE,SAAiB,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtG,wCAAwC;IACxC,MAAM,CAAC,GAAW,EAAE,SAAiB,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtG,oCAAoC;IACpC,OAAO,CAAC,GAAW,EAAE,OAAe,EAAE,GAAG,IAAc,IAAsB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACjI,2BAA2B;IAC3B,IAAI,CAAC,MAAc,EAAE,OAAe,EAAE,GAAG,IAAc,IAAsB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACjI,0BAA0B;IAC1B,MAAM,CAAC,OAAe,EAAE,MAAc;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAoB,CAAC;IAChE,CAAC;IACD,yBAAyB;IACzB,IAAI;QACF,OAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACtI,CAAC;IACD,mBAAmB;IACnB,IAAI,KAAsB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,qDAAqD;IACrD,IAAI,CAAC,MAAc,EAAE,GAAG,IAAc;QACpC,OAAQ,IAAI,CAAC,MAAM,CAAC,IAAmE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3G,CAAC;IACD,kCAAkC;IAClC,OAAO,CAAC,OAAe,EAAE,OAAe,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5G,8BAA8B;IAC9B,IAAI,CAAC,GAAW,EAAE,GAAG,IAAc;QACjC,OAAQ,IAAI,CAAC,MAAM,CAAC,IAA8D,CAAC,GAAG,EAAE,GAAG,IAAI,CAAoB,CAAC;IACtH,CAAC;IACD,gCAAgC;IAChC,MAAM,CAAC,OAAiB,EAAE,GAAW,EAAE,KAAa,EAAE,EAAU,EAAE,GAAG,IAAc;QACjF,OAAQ,IAAI,CAAC,MAAM,CAAC,MAAyD,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAClH,CAAC;IACD,4BAA4B;IAC5B,KAAK,CAAC,GAAG,IAAc;QACrB,OAAQ,IAAI,CAAC,MAAM,CAAC,KAAyD,CAAC,GAAG,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,qDAAqD;IACrD,UAAU,CAAC,GAAG,IAAc;QAC1B,OAAQ,IAAI,CAAC,MAAM,CAAC,UAA8D,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9F,CAAC;IACD,mCAAmC;IACnC,IAAI,CAAC,GAAW,EAAE,KAAa,EAAE,GAAG,GAAa,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACpH,8BAA8B;IAC9B,IAAI,CAAC,GAAW,EAAE,GAAG,GAAa,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9F,6BAA6B;IAC7B,IAAI,CAAC,GAAW,IAAqB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,yFAAyF;IACzF,QAAQ,KAAoB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAA8B,CAAC,CAAC,CAAC;IACxF,sEAAsE;IACtE,mBAAmB,KAAsB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAqB,CAAC,CAAC,CAAC;IAE7F,8FAA8F;IAC9F,KAAK,CAAC,gBAAgB,CAAC,IAAc,EAAE,UAAgC,EAAE;QACvE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,YAAY,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiD,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC1B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAyB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACtE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,KAAK,GAAG,GAAG,EAAE,UAAgC,EAAE;QAChF,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,YAAY,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,GAAa,EAAE,CAAC;YACzB,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,GAAG,CAAC;gBACF,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9F,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBAClB,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;YACzB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YAC7D,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,GAAG,CAAC;gBACF,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACvF,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBAClB,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;QAC3B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yGAAyG;IACzG,KAAK,CAAC,yBAAyB,CAAC,OAAe,EAAE,UAAgC,EAAE;QACjF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,YAAY,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC7E,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE,OAAO,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,+DAA+D;AAC/D,KAAK,UAAU,UAAU,CAAI,KAAU,EAAE,WAAmB,EAAE,EAA8B;IAC1F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IAChF,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;YACvB,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,2CAA2C;AAC3C,SAAS,KAAK,CAAI,KAAU,EAAE,IAAY;IACxC,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/session/config.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+/** Runtime schema for session configuration and security invariants. */
+export declare const SessionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    namespace: z.ZodDefault<z.ZodString>;
+    tokenBytes: z.ZodDefault<z.ZodNumber>;
+    ttl: z.ZodDefault<z.ZodNumber>;
+    idleTimeout: z.ZodOptional<z.ZodNumber>;
+    absoluteTimeout: z.ZodOptional<z.ZodNumber>;
+    touchInterval: z.ZodDefault<z.ZodNumber>;
+    rolling: z.ZodDefault<z.ZodBoolean>;
+    securityVersionEnabled: z.ZodDefault<z.ZodBoolean>;
+    maxSessionsPerUser: z.ZodDefault<z.ZodNumber>;
+    maxMetadataBytes: z.ZodDefault<z.ZodNumber>;
+    maxBatchSize: z.ZodDefault<z.ZodNumber>;
+    maxConcurrency: z.ZodDefault<z.ZodNumber>;
+    storeIpAddress: z.ZodDefault<z.ZodBoolean>;
+    storeUserAgent: z.ZodDefault<z.ZodBoolean>;
+    storeDeviceId: z.ZodDefault<z.ZodBoolean>;
+    encryption: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    circuitBreaker: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        failureThreshold: z.ZodDefault<z.ZodNumber>;
+        resetTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        halfOpenMaxRequests: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    cookie: z.ZodDefault<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        httpOnly: z.ZodDefault<z.ZodBoolean>;
+        secure: z.ZodDefault<z.ZodBoolean>;
+        sameSite: z.ZodDefault<z.ZodEnum<{
+            strict: "strict";
+            lax: "lax";
+            none: "none";
+        }>>;
+        domain: z.ZodOptional<z.ZodString>;
+        path: z.ZodDefault<z.ZodString>;
+        maxAge: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Fully normalized session configuration returned by {@link parseSessionConfig}. */
+export type SessionConfig = z.infer<typeof SessionConfigSchema>;
+/** Validates and applies secure defaults to session configuration. */
+export declare function parseSessionConfig(input: unknown): SessionConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/session/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/session/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wEAAwE;AACxE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyF5B,CAAC;AACL,qFAAqF;AACrF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAShE"}