@undefineds.co/xpod 0.3.24 → 0.3.26

package/dist/storage/keyvalue/BaseKeyValueStorage.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseKeyValueStorage = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+class BaseKeyValueStorage {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.ready = Promise.resolve();
+        this.tableName = options.tableName ?? 'internal_kv';
+        this.namespace = options.namespace ?? '';
+        assertIdentifier(this.tableName);
+    }
+    setReady(ready) {
+        this.ready = ready;
+    }
+    async initialize() {
+        await this.ready;
+    }
+    async finalize() {
+        await this.ready;
+        await this.closeStorage();
+    }
+    async has(key) {
+        await this.ready;
+        return this.hasValue(this.toStorageKey(key));
+    }
+    async get(key) {
+        await this.ready;
+        const raw = await this.selectValue(this.toStorageKey(key));
+        if (typeof raw === 'undefined') {
+            return undefined;
+        }
+        return this.parseValue(raw);
+    }
+    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.upsertValue(storageKey, payload);
+        return this;
+    }
+    async delete(key) {
+        await this.ready;
+        return this.deleteValue(this.toStorageKey(key));
+    }
+    async *entries() {
+        await this.ready;
+        const prefix = this.namespace;
+        const rows = await this.selectEntries(prefix);
+        for (const row of 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];
+        }
+    }
+    toStorageKey(key) {
+        return `${this.namespace}${key}`;
+    }
+    validateAndSerialize(value, key) {
+        try {
+            const payload = JSON.stringify(value ?? null);
+            if (payload === 'undefined') {
+                throw new Error('Cannot serialize undefined value');
+            }
+            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 {
+            const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;
+            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.BaseKeyValueStorage = BaseKeyValueStorage;
+function assertIdentifier(name) {
+    if (!/^[A-Za-z0-9_]+$/u.test(name)) {
+        throw new Error(`Invalid identifier: "${name}". Only alphanumeric and underscore are allowed.`);
+    }
+}
+//# sourceMappingURL=BaseKeyValueStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseKeyValueStorage.js","sourceRoot":"","sources":["../../../src/storage/keyvalue/BaseKeyValueStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Finalizable,\n  Initializable,\n  KeyValueStorage,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\n\nexport interface BaseKeyValueStorageOptions {\n  tableName?: string;\n  namespace?: string;\n}\n\nexport interface BaseKeyValueStorageRow {\n  key: string;\n  value: unknown;\n}\n\nexport abstract class BaseKeyValueStorage<T = unknown> implements\n  KeyValueStorage<string, T>,\n  Initializable,\n  Finalizable {\n  protected readonly logger = getLoggerFor(this);\n  protected readonly tableName: string;\n  protected readonly namespace: string;\n\n  private ready: Promise<void> = Promise.resolve();\n\n  protected constructor(options: BaseKeyValueStorageOptions) {\n    this.tableName = options.tableName ?? 'internal_kv';\n    this.namespace = options.namespace ?? '';\n    assertIdentifier(this.tableName);\n  }\n\n  protected setReady(ready: Promise<void>): void {\n    this.ready = ready;\n  }\n\n  public async initialize(): Promise<void> {\n    await this.ready;\n  }\n\n  public async finalize(): Promise<void> {\n    await this.ready;\n    await this.closeStorage();\n  }\n\n  public async has(key: string): Promise<boolean> {\n    await this.ready;\n    return this.hasValue(this.toStorageKey(key));\n  }\n\n  public async get(key: string): Promise<T | undefined> {\n    await this.ready;\n    const raw = await this.selectValue(this.toStorageKey(key));\n    if (typeof raw === 'undefined') {\n      return undefined;\n    }\n    return this.parseValue(raw);\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.upsertValue(storageKey, payload);\n    return this;\n  }\n\n  public async delete(key: string): Promise<boolean> {\n    await this.ready;\n    return this.deleteValue(this.toStorageKey(key));\n  }\n\n  public async *entries(): AsyncIterableIterator<[ string, T ]> {\n    await this.ready;\n    const prefix = this.namespace;\n    const rows = await this.selectEntries(prefix);\n\n    for (const row of rows) {\n      if (!row.key.startsWith(prefix)) {\n        continue;\n      }\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\n      yield [ logicalKey, value ];\n    }\n  }\n\n  protected toStorageKey(key: string): string {\n    return `${this.namespace}${key}`;\n  }\n\n  protected validateAndSerialize(value: T, key: string): string {\n    try {\n      const payload = JSON.stringify(value ?? null);\n      if (payload === 'undefined') {\n        throw new Error('Cannot serialize undefined value');\n      }\n      JSON.parse(payload);\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: unknown): T | undefined {\n    try {\n      const parsed = typeof raw === 'string' ? JSON.parse(raw) : raw;\n\n      if (parsed && typeof parsed === 'object' && 'key' in parsed && 'payload' in parsed) {\n        return (parsed as { payload: T }).payload;\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  protected abstract closeStorage(): Promise<void>;\n  protected abstract hasValue(key: string): Promise<boolean>;\n  protected abstract selectValue(key: string): Promise<unknown | undefined>;\n  protected abstract upsertValue(key: string, payload: string): Promise<void>;\n  protected abstract deleteValue(key: string): Promise<boolean>;\n  protected abstract selectEntries(prefix: string): Promise<BaseKeyValueStorageRow[]>;\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"]}

package/dist/storage/keyvalue/BaseKeyValueStorage.jsonld

@@ -0,0 +1,177 @@
+{
+  "@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/BaseKeyValueStorage.jsonld#BaseKeyValueStorage",
+      "@type": "AbstractClass",
+      "requireElement": "BaseKeyValueStorage",
+      "extends": [
+        {
+          "@type": "GenericComponentExtension",
+          "component": "css:dist/storage/keyvalue/KeyValueStorage.jsonld#KeyValueStorage",
+          "genericTypeInstances": [
+            "xsd:string",
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__generic_T"
+            }
+          ]
+        },
+        "css:dist/init/Initializable.jsonld#Initializable",
+        "css:dist/init/final/Finalizable.jsonld#Finalizable"
+      ],
+      "genericTypeParameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__generic_T",
+          "default": {
+            "@type": "ParameterRangeWildcard"
+          }
+        }
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage_options_tableName",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage_options_namespace",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_tableName",
+          "memberFieldName": "tableName",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_namespace",
+          "memberFieldName": "namespace",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_ready",
+          "memberFieldName": "ready"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_setReady",
+          "memberFieldName": "setReady"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_has",
+          "memberFieldName": "has"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_get",
+          "memberFieldName": "get"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_set",
+          "memberFieldName": "set"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_delete",
+          "memberFieldName": "delete"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_entries",
+          "memberFieldName": "entries"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_toStorageKey",
+          "memberFieldName": "toStorageKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_validateAndSerialize",
+          "memberFieldName": "validateAndSerialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_parseValue",
+          "memberFieldName": "parseValue"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_closeStorage",
+          "memberFieldName": "closeStorage"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_hasValue",
+          "memberFieldName": "hasValue"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_selectValue",
+          "memberFieldName": "selectValue"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_upsertValue",
+          "memberFieldName": "upsertValue"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_deleteValue",
+          "memberFieldName": "deleteValue"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage__member_selectEntries",
+          "memberFieldName": "selectEntries"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "tableName",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage_options_tableName"
+              }
+            },
+            {
+              "keyRaw": "namespace",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/BaseKeyValueStorage.jsonld#BaseKeyValueStorage_options_namespace"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -1,5 +1,5 @@
 import { Pool } from 'pg';
-import type { Finalizable, Initializable, KeyValueStorage } from '@solid/community-server';
+import { BaseKeyValueStorage, type BaseKeyValueStorageRow } from './BaseKeyValueStorage';
 export interface PostgresKeyValueStorageOptions {
     connectionString: string;
     tableName?: string;
@@ -10,25 +10,16 @@ export interface PostgresKeyValueStorageOptions {
      */
     pool?: Pool;
 }
-export declare class PostgresKeyValueStorage<T = unknown> implements KeyValueStorage<string, T>, Initializable, Finalizable {
-    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+export declare class PostgresKeyValueStorage<T = unknown> extends BaseKeyValueStorage<T> {
     private readonly pool;
-    private readonly tableName;
     private readonly quotedTableName;
-    private readonly namespace;
-    private readonly ready;
     private readonly sharedConnectionString?;
     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;
+    protected closeStorage(): Promise<void>;
+    protected hasValue(key: string): Promise<boolean>;
+    protected selectValue(key: string): Promise<unknown | undefined>;
+    protected upsertValue(key: string, payload: string): Promise<void>;
+    protected deleteValue(key: string): Promise<boolean>;
+    protected selectEntries(prefix: string): Promise<BaseKeyValueStorageRow[]>;
+    private ensureTable;
 }

package/dist/storage/keyvalue/PostgresKeyValueStorage.js

@@ -1,17 +1,11 @@
 "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 {
+const BaseKeyValueStorage_1 = require("./BaseKeyValueStorage");
+class PostgresKeyValueStorage extends BaseKeyValueStorage_1.BaseKeyValueStorage {
     constructor(options) {
-        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
-        // 使用共享的连接池，避免多个组件创建独立连接池导致死锁
+        super(options);
         if (options.pool) {
             this.pool = options.pool;
             this.sharedConnectionString = undefined;
@@ -20,78 +14,43 @@ class PostgresKeyValueStorage {
             this.sharedConnectionString = options.connectionString;
             this.pool = (0, PostgresPoolManager_1.getSharedPool)({ connectionString: options.connectionString });
         }
-        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;
+        const tableName = options.tableName ?? 'internal_kv';
+        this.quotedTableName = formatIdentifier(tableName);
+        this.setReady(this.ensureTable());
     }
-    async finalize() {
+    async closeStorage() {
         if (!this.sharedConnectionString) {
             return;
         }
         (0, PostgresPoolManager_1.releaseSharedPool)({ connectionString: this.sharedConnectionString });
     }
-    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]);
+    async hasValue(key) {
+        const result = await this.pool.query(`SELECT EXISTS (SELECT 1 FROM ${this.quotedTableName} WHERE key = $1) AS exists`, [key]);
         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]);
+    async selectValue(key) {
+        const result = await this.pool.query(`SELECT value FROM ${this.quotedTableName} WHERE key = $1 LIMIT 1`, [key]);
         if ((result.rowCount ?? 0) === 0) {
             return undefined;
         }
-        // JSONB column returns object, TEXT column returns string
-        return this.parseValue(result.rows[0].value);
+        return 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;
-        }
+    async upsertValue(key, payload) {
         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;
+       ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_at = NOW()`, [key, payload]);
     }
-    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]);
+    async deleteValue(key) {
+        const result = await this.pool.query(`DELETE FROM ${this.quotedTableName} WHERE key = $1`, [key]);
         return (result.rowCount ?? 0) > 0;
     }
-    async *entries() {
-        await this.ready;
-        const prefix = this.namespace;
+    async selectEntries(prefix) {
         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];
-        }
+        return result.rows;
     }
     async ensureTable() {
         await this.pool.query(`
@@ -102,43 +61,12 @@ class PostgresKeyValueStorage {
       )
     `);
     }
-    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;
+function formatIdentifier(name) {
+    if (!/^[A-Za-z0-9_]+$/u.test(name)) {
+        throw new Error(`Invalid identifier: "${name}". Only alphanumeric and underscore are allowed.`);
+    }
+    return `"${name}"`;
+}
 //# sourceMappingURL=PostgresKeyValueStorage.js.map

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

@@ -1 +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, releaseSharedPool } 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 sharedConnectionString?: string;\n\n  public constructor(options: PostgresKeyValueStorageOptions) {\n    // 使用共享的连接池，避免多个组件创建独立连接池导致死锁\n    if (options.pool) {\n      this.pool = options.pool;\n      this.sharedConnectionString = undefined;\n    } else {\n      this.sharedConnectionString = options.connectionString;\n      this.pool = getSharedPool({ connectionString: options.connectionString });\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 (!this.sharedConnectionString) {\n      return;\n    }\n    releaseSharedPool({ connectionString: this.sharedConnectionString });\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"]}
+{"version":3,"file":"PostgresKeyValueStorage.js","sourceRoot":"","sources":["../../../src/storage/keyvalue/PostgresKeyValueStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import { Pool } from 'pg';\nimport { getSharedPool, releaseSharedPool } from '../database/PostgresPoolManager';\nimport { BaseKeyValueStorage, type BaseKeyValueStorageRow } from './BaseKeyValueStorage';\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\nexport class PostgresKeyValueStorage<T = unknown> extends BaseKeyValueStorage<T> {\n  private readonly pool: Pool;\n  private readonly quotedTableName: string;\n  private readonly sharedConnectionString?: string;\n\n  public constructor(options: PostgresKeyValueStorageOptions) {\n    super(options);\n\n    if (options.pool) {\n      this.pool = options.pool;\n      this.sharedConnectionString = undefined;\n    } else {\n      this.sharedConnectionString = options.connectionString;\n      this.pool = getSharedPool({ connectionString: options.connectionString });\n    }\n\n    const tableName = options.tableName ?? 'internal_kv';\n    this.quotedTableName = formatIdentifier(tableName);\n    this.setReady(this.ensureTable());\n  }\n\n  protected async closeStorage(): Promise<void> {\n    if (!this.sharedConnectionString) {\n      return;\n    }\n    releaseSharedPool({ connectionString: this.sharedConnectionString });\n  }\n\n  protected async hasValue(key: string): Promise<boolean> {\n    const result = await this.pool.query<{ exists: boolean }>(\n      `SELECT EXISTS (SELECT 1 FROM ${this.quotedTableName} WHERE key = $1) AS exists`,\n      [ key ],\n    );\n    return result.rows[0]?.exists ?? false;\n  }\n\n  protected async selectValue(key: string): Promise<unknown | undefined> {\n    const result = await this.pool.query<{ value: unknown }>(\n      `SELECT value FROM ${this.quotedTableName} WHERE key = $1 LIMIT 1`,\n      [ key ],\n    );\n    if ((result.rowCount ?? 0) === 0) {\n      return undefined;\n    }\n    return result.rows[0]?.value;\n  }\n\n  protected async upsertValue(key: string, payload: string): Promise<void> {\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      [ key, payload ],\n    );\n  }\n\n  protected async deleteValue(key: string): Promise<boolean> {\n    const result = await this.pool.query(\n      `DELETE FROM ${this.quotedTableName} WHERE key = $1`,\n      [ key ],\n    );\n    return (result.rowCount ?? 0) > 0;\n  }\n\n  protected async selectEntries(prefix: string): Promise<BaseKeyValueStorageRow[]> {\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<BaseKeyValueStorageRow>(query, values);\n    return result.rows;\n  }\n\n  private 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\nfunction formatIdentifier(name: string): string {\n  if (!/^[A-Za-z0-9_]+$/u.test(name)) {\n    throw new Error(`Invalid identifier: \"${name}\". Only alphanumeric and underscore are allowed.`);\n  }\n  return `\"${name}\"`;\n}\n"]}