@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/keyvalue/PostgresKeyValueStorage.d.ts

@@ -0,0 +1,34 @@
+import { Pool } from 'pg';
+import type { Finalizable, Initializable, KeyValueStorage } from '@solid/community-server';
+export interface PostgresKeyValueStorageOptions {
+    connectionString: string;
+    tableName?: string;
+    namespace?: string;
+    /**
+     * 共享的 pg Pool 实例（避免多个组件创建独立连接池导致死锁）
+     * 如果提供，将忽略 connectionString
+     */
+    pool?: Pool;
+}
+export declare class PostgresKeyValueStorage<T = unknown> implements KeyValueStorage<string, T>, Initializable, Finalizable {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly pool;
+    private readonly tableName;
+    private readonly quotedTableName;
+    private readonly namespace;
+    private readonly ready;
+    private readonly sharedPoolConfig?;
+    constructor(options: PostgresKeyValueStorageOptions);
+    initialize(): Promise<void>;
+    finalize(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T): Promise<this>;
+    delete(key: string): Promise<boolean>;
+    entries(): AsyncIterableIterator<[string, T]>;
+    protected ensureTable(): Promise<void>;
+    protected toStorageKey(key: string): string;
+    protected formatIdentifier(name: string): string;
+    protected validateAndSerialize(value: T, key: string): string;
+    protected parseValue(raw: any): T | undefined;
+}

package/dist/storage/keyvalue/PostgresKeyValueStorage.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresKeyValueStorage = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const PostgresPoolManager_1 = require("../database/PostgresPoolManager");
+function assertIdentifier(name) {
+    if (!/^[A-Za-z0-9_]+$/u.test(name)) {
+        throw new Error(`Invalid identifier: "${name}". Only alphanumeric and underscore are allowed.`);
+    }
+}
+class PostgresKeyValueStorage {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        // 使用共享的连接池，避免多个组件创建独立连接池导致死锁
+        if (options.pool) {
+            this.pool = options.pool;
+        }
+        else {
+            this.sharedPoolConfig = { connectionString: options.connectionString };
+            this.pool = (0, PostgresPoolManager_1.getSharedPool)(this.sharedPoolConfig);
+        }
+        this.tableName = options.tableName ?? 'internal_kv';
+        this.namespace = options.namespace ?? '';
+        assertIdentifier(this.tableName);
+        this.quotedTableName = this.formatIdentifier(this.tableName);
+        this.ready = this.ensureTable();
+    }
+    async initialize() {
+        await this.ready;
+    }
+    async finalize() {
+        // If a Pool was provided explicitly, this storage owns it.
+        if (this.sharedPoolConfig) {
+            (0, PostgresPoolManager_1.releaseSharedPoolImmediately)(this.sharedPoolConfig);
+        }
+        else {
+            await this.pool.end();
+        }
+    }
+    async has(key) {
+        await this.ready;
+        const storageKey = this.toStorageKey(key);
+        const result = await this.pool.query(`SELECT EXISTS (SELECT 1 FROM ${this.quotedTableName} WHERE key = $1) AS exists`, [storageKey]);
+        return result.rows[0]?.exists ?? false;
+    }
+    async get(key) {
+        await this.ready;
+        const storageKey = this.toStorageKey(key);
+        const result = await this.pool.query(`SELECT value FROM ${this.quotedTableName} WHERE key = $1 LIMIT 1`, [storageKey]);
+        if ((result.rowCount ?? 0) === 0) {
+            return undefined;
+        }
+        // JSONB column returns object, TEXT column returns string
+        return this.parseValue(result.rows[0].value);
+    }
+    async set(key, value) {
+        await this.ready;
+        const storageKey = this.toStorageKey(key);
+        let payload;
+        try {
+            payload = this.validateAndSerialize(value, key);
+        }
+        catch (error) {
+            this.logger.error(`Failed to serialize value for key "${key}": ${error}`);
+            throw error;
+        }
+        await this.pool.query(`INSERT INTO ${this.quotedTableName} (key, value)
+       VALUES ($1, $2)
+       ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_at = NOW()`, [storageKey, payload]);
+        return this;
+    }
+    async delete(key) {
+        await this.ready;
+        const storageKey = this.toStorageKey(key);
+        const result = await this.pool.query(`DELETE FROM ${this.quotedTableName} WHERE key = $1`, [storageKey]);
+        return (result.rowCount ?? 0) > 0;
+    }
+    async *entries() {
+        await this.ready;
+        const prefix = this.namespace;
+        const query = prefix.length > 0 ?
+            `SELECT key, value FROM ${this.quotedTableName} WHERE key LIKE $1` :
+            `SELECT key, value FROM ${this.quotedTableName}`;
+        const values = prefix.length > 0 ? [`${prefix}%`] : [];
+        const result = await this.pool.query(query, values);
+        for (const row of result.rows) {
+            if (!row.key.startsWith(prefix)) {
+                continue;
+            }
+            const logicalKey = row.key.slice(prefix.length);
+            const value = this.parseValue(row.value);
+            if (typeof value === 'undefined') {
+                continue;
+            }
+            yield [logicalKey, value];
+        }
+    }
+    async ensureTable() {
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS ${this.quotedTableName} (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      )
+    `);
+    }
+    toStorageKey(key) {
+        return `${this.namespace}${key}`;
+    }
+    formatIdentifier(name) {
+        return `"${name}"`;
+    }
+    validateAndSerialize(value, key) {
+        try {
+            const payload = JSON.stringify(value ?? null);
+            // Basic validation
+            if (payload === 'undefined') {
+                throw new Error(`Cannot serialize undefined value`);
+            }
+            // Validate JSON can be parsed back
+            JSON.parse(payload);
+            return payload;
+        }
+        catch (error) {
+            this.logger.error(`JSON serialization failed for key "${key}": ${error}`);
+            throw new Error(`JSON serialization failed for key "${key}": ${error}`);
+        }
+    }
+    parseValue(raw) {
+        try {
+            // JSONB column returns object, TEXT column returns string
+            const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+            // Handle CSS internal storage format: {"key": "...", "payload": ...}
+            if (parsed && typeof parsed === 'object' && 'key' in parsed && 'payload' in parsed) {
+                return parsed.payload;
+            }
+            return parsed;
+        }
+        catch (error) {
+            this.logger.error(`Failed to parse stored value: ${error}. Raw value: ${JSON.stringify(raw)}`);
+            return undefined;
+        }
+    }
+}
+exports.PostgresKeyValueStorage = PostgresKeyValueStorage;
+//# sourceMappingURL=PostgresKeyValueStorage.js.map

package/dist/storage/keyvalue/PostgresKeyValueStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresKeyValueStorage.js","sourceRoot":"","sources":["../../../src/storage/keyvalue/PostgresKeyValueStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Pool } from 'pg';\nimport type {\n  Finalizable,\n  Initializable,\n  KeyValueStorage,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { getSharedPool, releaseSharedPoolImmediately } from '../database/PostgresPoolManager';\n\nexport interface PostgresKeyValueStorageOptions {\n  connectionString: string;\n  tableName?: string;\n  namespace?: string;\n  /** \n   * 共享的 pg Pool 实例（避免多个组件创建独立连接池导致死锁）\n   * 如果提供，将忽略 connectionString\n   */\n  pool?: Pool;\n}\n\nfunction assertIdentifier(name: string): void {\n  if (!/^[A-Za-z0-9_]+$/u.test(name)) {\n    throw new Error(`Invalid identifier: \"${name}\". Only alphanumeric and underscore are allowed.`);\n  }\n}\n\nexport class PostgresKeyValueStorage<T = unknown> implements\n  KeyValueStorage<string, T>,\n  Initializable,\n  Finalizable {\n  protected readonly logger = getLoggerFor(this);\n  private readonly pool: Pool;\n  private readonly tableName: string;\n  private readonly quotedTableName: string;\n  private readonly namespace: string;\n  private readonly ready: Promise<void>;\n  private readonly sharedPoolConfig?: { connectionString: string };\n\n  public constructor(options: PostgresKeyValueStorageOptions) {\n    // 使用共享的连接池，避免多个组件创建独立连接池导致死锁\n    if (options.pool) {\n      this.pool = options.pool;\n    } else {\n      this.sharedPoolConfig = { connectionString: options.connectionString };\n      this.pool = getSharedPool(this.sharedPoolConfig);\n    }\n    this.tableName = options.tableName ?? 'internal_kv';\n    this.namespace = options.namespace ?? '';\n    assertIdentifier(this.tableName);\n    this.quotedTableName = this.formatIdentifier(this.tableName);\n    this.ready = this.ensureTable();\n  }\n\n  public async initialize(): Promise<void> {\n    await this.ready;\n  }\n\n  public async finalize(): Promise<void> {\n    // If a Pool was provided explicitly, this storage owns it.\n    if (this.sharedPoolConfig) {\n      releaseSharedPoolImmediately(this.sharedPoolConfig);\n    } else {\n      await this.pool.end();\n    }\n  }\n\n\n  public async has(key: string): Promise<boolean> {\n    await this.ready;\n    const storageKey = this.toStorageKey(key);\n    const result = await this.pool.query<{ exists: boolean }>(\n      `SELECT EXISTS (SELECT 1 FROM ${this.quotedTableName} WHERE key = $1) AS exists`,\n      [ storageKey ],\n    );\n    return result.rows[0]?.exists ?? false;\n  }\n\n  public async get(key: string): Promise<T | undefined> {\n    await this.ready;\n    const storageKey = this.toStorageKey(key);\n    const result = await this.pool.query<{ value: any }>(\n      `SELECT value FROM ${this.quotedTableName} WHERE key = $1 LIMIT 1`,\n      [ storageKey ],\n    );\n    if ((result.rowCount ?? 0) === 0) {\n      return undefined;\n    }\n    // JSONB column returns object, TEXT column returns string\n    return this.parseValue(result.rows[0].value);\n  }\n\n  public async set(key: string, value: T): Promise<this> {\n    await this.ready;\n    const storageKey = this.toStorageKey(key);\n    \n    let payload: string;\n    try {\n      payload = this.validateAndSerialize(value, key);\n    } catch (error: unknown) {\n      this.logger.error(`Failed to serialize value for key \"${key}\": ${error}`);\n      throw error;\n    }\n    \n    await this.pool.query(\n      `INSERT INTO ${this.quotedTableName} (key, value)\n       VALUES ($1, $2)\n       ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_at = NOW()`,\n      [ storageKey, payload ],\n    );\n    return this;\n  }\n\n  public async delete(key: string): Promise<boolean> {\n    await this.ready;\n    const storageKey = this.toStorageKey(key);\n    const result = await this.pool.query(\n      `DELETE FROM ${this.quotedTableName} WHERE key = $1`,\n      [ storageKey ],\n    );\n    return (result.rowCount ?? 0) > 0;\n  }\n\n  public async *entries(): AsyncIterableIterator<[ string, T ]> {\n    await this.ready;\n    const prefix = this.namespace;\n    const query = prefix.length > 0 ?\n      `SELECT key, value FROM ${this.quotedTableName} WHERE key LIKE $1` :\n      `SELECT key, value FROM ${this.quotedTableName}`;\n    const values = prefix.length > 0 ? [ `${prefix}%` ] : [];\n    const result = await this.pool.query<{ key: string; value: any }>(query, values);\n    for (const row of result.rows) {\n      if (!row.key.startsWith(prefix)) {\n        continue;\n      }\n      const logicalKey = row.key.slice(prefix.length);\n      const value = this.parseValue(row.value);\n      if (typeof value === 'undefined') {\n        continue;\n      }\n      yield [ logicalKey, value ];\n    }\n  }\n\n  protected async ensureTable(): Promise<void> {\n    await this.pool.query(`\n      CREATE TABLE IF NOT EXISTS ${this.quotedTableName} (\n        key TEXT PRIMARY KEY,\n        value TEXT NOT NULL,\n        updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()\n      )\n    `);\n  }\n\n  protected toStorageKey(key: string): string {\n    return `${this.namespace}${key}`;\n  }\n\n  protected formatIdentifier(name: string): string {\n    return `\"${name}\"`;\n  }\n\n  protected validateAndSerialize(value: T, key: string): string {\n    try {\n      const payload = JSON.stringify(value ?? null);\n      \n      // Basic validation\n      if (payload === 'undefined') {\n        throw new Error(`Cannot serialize undefined value`);\n      }\n      \n      // Validate JSON can be parsed back\n      JSON.parse(payload);\n      \n      return payload;\n    } catch (error: unknown) {\n      this.logger.error(`JSON serialization failed for key \"${key}\": ${error}`);\n      throw new Error(`JSON serialization failed for key \"${key}\": ${error}`);\n    }\n  }\n\n  protected parseValue(raw: any): T | undefined {\n    try {\n      // JSONB column returns object, TEXT column returns string\n      const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;\n      \n      // Handle CSS internal storage format: {\"key\": \"...\", \"payload\": ...}\n      if (parsed && typeof parsed === 'object' && 'key' in parsed && 'payload' in parsed) {\n        return parsed.payload as T;\n      }\n      \n      return parsed as T;\n    } catch (error: unknown) {\n      this.logger.error(`Failed to parse stored value: ${error}. Raw value: ${JSON.stringify(raw)}`);\n      return undefined;\n    }\n  }\n\n}\n"]}

package/dist/storage/keyvalue/PostgresKeyValueStorage.jsonld

@@ -0,0 +1,192 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage",
+      "@type": "Class",
+      "requireElement": "PostgresKeyValueStorage",
+      "extends": [
+        {
+          "@type": "GenericComponentExtension",
+          "component": "css:dist/storage/keyvalue/KeyValueStorage.jsonld#KeyValueStorage",
+          "genericTypeInstances": [
+            "xsd:string",
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__generic_T"
+            }
+          ]
+        },
+        "css:dist/init/Initializable.jsonld#Initializable",
+        "css:dist/init/final/Finalizable.jsonld#Finalizable"
+      ],
+      "genericTypeParameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__generic_T",
+          "default": {
+            "@type": "ParameterRangeWildcard"
+          }
+        }
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_connectionString",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_tableName",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_namespace",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_pool",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "urn:npm:pg:Pool",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "共享的 pg Pool 实例（避免多个组件创建独立连接池导致死锁） 如果提供，将忽略 connectionString"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_pool",
+          "memberFieldName": "pool"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_tableName",
+          "memberFieldName": "tableName"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_quotedTableName",
+          "memberFieldName": "quotedTableName"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_namespace",
+          "memberFieldName": "namespace"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_ready",
+          "memberFieldName": "ready"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_has",
+          "memberFieldName": "has"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_get",
+          "memberFieldName": "get"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_set",
+          "memberFieldName": "set"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_delete",
+          "memberFieldName": "delete"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_entries",
+          "memberFieldName": "entries"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_ensureTable",
+          "memberFieldName": "ensureTable"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_toStorageKey",
+          "memberFieldName": "toStorageKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_formatIdentifier",
+          "memberFieldName": "formatIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_validateAndSerialize",
+          "memberFieldName": "validateAndSerialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage__member_parseValue",
+          "memberFieldName": "parseValue"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "connectionString",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_connectionString"
+              }
+            },
+            {
+              "keyRaw": "tableName",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_tableName"
+              }
+            },
+            {
+              "keyRaw": "namespace",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_namespace"
+              }
+            },
+            {
+              "keyRaw": "pool",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/PostgresKeyValueStorage.jsonld#PostgresKeyValueStorage_options_pool"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/storage/keyvalue/RedisKeyValueStorage.d.ts

@@ -0,0 +1,30 @@
+import { Redis } from 'ioredis';
+import type { Finalizable, Initializable, KeyValueStorage } from '@solid/community-server';
+export interface RedisKeyValueStorageOptions {
+    client: string;
+    username?: string;
+    password?: string;
+    database?: number;
+    namespace?: string;
+    tls?: boolean;
+    scanCount?: number;
+}
+export declare class RedisKeyValueStorage<T = unknown> implements KeyValueStorage<string, T>, Initializable, Finalizable {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly client;
+    private readonly prefix;
+    private readonly scanCount;
+    constructor(options: RedisKeyValueStorageOptions);
+    initialize(): Promise<void>;
+    finalize(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    get(key: string): Promise<T | undefined>;
+    set(key: string, value: T): Promise<this>;
+    delete(key: string): Promise<boolean>;
+    entries(): AsyncIterableIterator<[string, T]>;
+    protected createClient(options: RedisKeyValueStorageOptions): Redis;
+    protected toStorageKey(key: string): string;
+    protected fromStorageKey(storageKey: string): string;
+    protected parse(raw: string): T | undefined;
+    protected getTtl(value: T): number;
+}

package/dist/storage/keyvalue/RedisKeyValueStorage.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisKeyValueStorage = void 0;
+const ioredis_1 = require("ioredis");
+const global_logger_factory_1 = require("global-logger-factory");
+class RedisKeyValueStorage {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        if (!options.client) {
+            throw new Error('Redis client configuration is required.');
+        }
+        this.prefix = options.namespace ?? 'css:kv:';
+        this.scanCount = options.scanCount ?? 100;
+        this.client = this.createClient(options);
+    }
+    async initialize() {
+        await this.client.ping();
+    }
+    async finalize() {
+        await this.client.quit().catch((error) => {
+            this.logger.warn(`Failed to close Redis connection: ${error}`);
+        });
+    }
+    async has(key) {
+        const result = await this.client.exists(this.toStorageKey(key));
+        return result > 0;
+    }
+    async get(key) {
+        const raw = await this.client.get(this.toStorageKey(key));
+        if (raw == null) {
+            return undefined;
+        }
+        return this.parse(raw);
+    }
+    async set(key, value) {
+        const storageKey = this.toStorageKey(key);
+        const payload = JSON.stringify(value ?? null);
+        const ttl = this.getTtl(value);
+        if (ttl > 0) {
+            await this.client.set(storageKey, payload, 'PX', ttl);
+        }
+        else {
+            await this.client.set(storageKey, payload);
+        }
+        return this;
+    }
+    async delete(key) {
+        const result = await this.client.del(this.toStorageKey(key));
+        return result > 0;
+    }
+    async *entries() {
+        const match = `${this.prefix}*`;
+        let cursor = '0';
+        do {
+            const [nextCursor, keys] = await this.client.scan(cursor, 'MATCH', match, 'COUNT', this.scanCount);
+            cursor = nextCursor;
+            if (keys.length === 0) {
+                continue;
+            }
+            const values = await this.client.mget(keys);
+            for (let index = 0; index < keys.length; index += 1) {
+                const raw = values[index];
+                if (raw == null) {
+                    continue;
+                }
+                const logicalKey = this.fromStorageKey(keys[index]);
+                const value = this.parse(raw);
+                if (typeof value === 'undefined') {
+                    continue;
+                }
+                yield [logicalKey, value];
+            }
+        } while (cursor !== '0');
+    }
+    createClient(options) {
+        if (options.client.startsWith('redis://') || options.client.startsWith('rediss://')) {
+            return new ioredis_1.Redis(options.client, {
+                username: options.username,
+                password: options.password,
+                db: options.database,
+                tls: options.tls ? {} : undefined,
+                lazyConnect: false,
+            });
+        }
+        const match = /^(?:([^:]+):)?(\d{2,5})$/u.exec(options.client);
+        if (!match) {
+            throw new Error(`Invalid Redis client string "${options.client}". Expected "host:port" or "port".`);
+        }
+        const host = match[1];
+        const port = Number.parseInt(match[2], 10);
+        return new ioredis_1.Redis({
+            host: host ?? '127.0.0.1',
+            port,
+            username: options.username,
+            password: options.password,
+            db: options.database,
+            tls: options.tls ? {} : undefined,
+            lazyConnect: false,
+        });
+    }
+    toStorageKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    fromStorageKey(storageKey) {
+        return storageKey.slice(this.prefix.length);
+    }
+    parse(raw) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            this.logger.error(`Failed to parse Redis payload: ${error}`);
+            return undefined;
+        }
+    }
+    getTtl(value) {
+        if (!value || typeof value !== 'object') {
+            return 0;
+        }
+        const maybeExpires = value.expires;
+        if (typeof maybeExpires !== 'string') {
+            return 0;
+        }
+        const expiresAt = Number(new Date(maybeExpires));
+        if (Number.isNaN(expiresAt)) {
+            return 0;
+        }
+        const ttl = expiresAt - Date.now();
+        return ttl > 0 ? ttl : 0;
+    }
+}
+exports.RedisKeyValueStorage = RedisKeyValueStorage;
+//# sourceMappingURL=RedisKeyValueStorage.js.map

package/dist/storage/keyvalue/RedisKeyValueStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisKeyValueStorage.js","sourceRoot":"","sources":["../../../src/storage/keyvalue/RedisKeyValueStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Redis } from 'ioredis';\nimport type {\n  Finalizable,\n  Initializable,\n  KeyValueStorage,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\n\nexport interface RedisKeyValueStorageOptions {\n  client: string;\n  username?: string;\n  password?: string;\n  database?: number;\n  namespace?: string;\n  tls?: boolean;\n  scanCount?: number;\n}\n\nexport class RedisKeyValueStorage<T = unknown> implements\n  KeyValueStorage<string, T>,\n  Initializable,\n  Finalizable {\n  protected readonly logger = getLoggerFor(this);\n  private readonly client: Redis;\n  private readonly prefix: string;\n  private readonly scanCount: number;\n\n  public constructor(options: RedisKeyValueStorageOptions) {\n    if (!options.client) {\n      throw new Error('Redis client configuration is required.');\n    }\n    this.prefix = options.namespace ?? 'css:kv:';\n    this.scanCount = options.scanCount ?? 100;\n    this.client = this.createClient(options);\n  }\n\n  public async initialize(): Promise<void> {\n    await this.client.ping();\n  }\n\n  public async finalize(): Promise<void> {\n    await this.client.quit().catch((error: unknown) => {\n      this.logger.warn(`Failed to close Redis connection: ${error}`);\n    });\n  }\n\n  public async has(key: string): Promise<boolean> {\n    const result = await this.client.exists(this.toStorageKey(key));\n    return result > 0;\n  }\n\n  public async get(key: string): Promise<T | undefined> {\n    const raw = await this.client.get(this.toStorageKey(key));\n    if (raw == null) {\n      return undefined;\n    }\n    return this.parse(raw);\n  }\n\n  public async set(key: string, value: T): Promise<this> {\n    const storageKey = this.toStorageKey(key);\n    const payload = JSON.stringify(value ?? null);\n    const ttl = this.getTtl(value);\n    if (ttl > 0) {\n      await this.client.set(storageKey, payload, 'PX', ttl);\n    } else {\n      await this.client.set(storageKey, payload);\n    }\n    return this;\n  }\n\n  public async delete(key: string): Promise<boolean> {\n    const result = await this.client.del(this.toStorageKey(key));\n    return result > 0;\n  }\n\n  public async *entries(): AsyncIterableIterator<[ string, T ]> {\n    const match = `${this.prefix}*`;\n    let cursor = '0';\n    do {\n      const [ nextCursor, keys ] = await this.client.scan(cursor, 'MATCH', match, 'COUNT', this.scanCount);\n      cursor = nextCursor;\n      if (keys.length === 0) {\n        continue;\n      }\n      const values = await this.client.mget(keys);\n      for (let index = 0; index < keys.length; index += 1) {\n        const raw = values[index];\n        if (raw == null) {\n          continue;\n        }\n        const logicalKey = this.fromStorageKey(keys[index]);\n        const value = this.parse(raw);\n        if (typeof value === 'undefined') {\n          continue;\n        }\n        yield [ logicalKey, value ];\n      }\n    } while (cursor !== '0');\n  }\n\n  protected createClient(options: RedisKeyValueStorageOptions): Redis {\n    if (options.client.startsWith('redis://') || options.client.startsWith('rediss://')) {\n      return new Redis(options.client, {\n        username: options.username,\n        password: options.password,\n        db: options.database,\n        tls: options.tls ? {} : undefined,\n        lazyConnect: false,\n      });\n    }\n    const match = /^(?:([^:]+):)?(\\d{2,5})$/u.exec(options.client);\n    if (!match) {\n      throw new Error(`Invalid Redis client string \"${options.client}\". Expected \"host:port\" or \"port\".`);\n    }\n    const host = match[1];\n    const port = Number.parseInt(match[2], 10);\n    return new Redis({\n      host: host ?? '127.0.0.1',\n      port,\n      username: options.username,\n      password: options.password,\n      db: options.database,\n      tls: options.tls ? {} : undefined,\n      lazyConnect: false,\n    });\n  }\n\n  protected toStorageKey(key: string): string {\n    return `${this.prefix}${key}`;\n  }\n\n  protected fromStorageKey(storageKey: string): string {\n    return storageKey.slice(this.prefix.length);\n  }\n\n  protected parse(raw: string): T | undefined {\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error: unknown) {\n      this.logger.error(`Failed to parse Redis payload: ${error}`);\n      return undefined;\n    }\n  }\n\n  protected getTtl(value: T): number {\n    if (!value || typeof value !== 'object') {\n      return 0;\n    }\n    const maybeExpires = (value as Record<string, unknown>).expires;\n    if (typeof maybeExpires !== 'string') {\n      return 0;\n    }\n    const expiresAt = Number(new Date(maybeExpires));\n    if (Number.isNaN(expiresAt)) {\n      return 0;\n    }\n    const ttl = expiresAt - Date.now();\n    return ttl > 0 ? ttl : 0;\n  }\n}\n"]}