@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/keyvalue/RedisKeyValueStorage.jsonld

@@ -0,0 +1,237 @@
+{
+  "@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/RedisKeyValueStorage.jsonld#RedisKeyValueStorage",
+      "@type": "Class",
+      "requireElement": "RedisKeyValueStorage",
+      "extends": [
+        {
+          "@type": "GenericComponentExtension",
+          "component": "css:dist/storage/keyvalue/KeyValueStorage.jsonld#KeyValueStorage",
+          "genericTypeInstances": [
+            "xsd:string",
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__generic_T"
+            }
+          ]
+        },
+        "css:dist/init/Initializable.jsonld#Initializable",
+        "css:dist/init/final/Finalizable.jsonld#Finalizable"
+      ],
+      "genericTypeParameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__generic_T",
+          "default": {
+            "@type": "ParameterRangeWildcard"
+          }
+        }
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_client",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_username",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_password",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_database",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_namespace",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_tls",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_scanCount",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_client",
+          "memberFieldName": "client"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_prefix",
+          "memberFieldName": "prefix"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_scanCount",
+          "memberFieldName": "scanCount"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_has",
+          "memberFieldName": "has"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_get",
+          "memberFieldName": "get"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_set",
+          "memberFieldName": "set"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_delete",
+          "memberFieldName": "delete"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_entries",
+          "memberFieldName": "entries"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_createClient",
+          "memberFieldName": "createClient"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_toStorageKey",
+          "memberFieldName": "toStorageKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_fromStorageKey",
+          "memberFieldName": "fromStorageKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_parse",
+          "memberFieldName": "parse"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage__member_getTtl",
+          "memberFieldName": "getTtl"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "client",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_client"
+              }
+            },
+            {
+              "keyRaw": "username",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_username"
+              }
+            },
+            {
+              "keyRaw": "password",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_password"
+              }
+            },
+            {
+              "keyRaw": "database",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_database"
+              }
+            },
+            {
+              "keyRaw": "namespace",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_namespace"
+              }
+            },
+            {
+              "keyRaw": "tls",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_tls"
+              }
+            },
+            {
+              "keyRaw": "scanCount",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/RedisKeyValueStorage.jsonld#RedisKeyValueStorage_options_scanCount"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+import type { Finalizable, Initializable, KeyValueStorage } from '@solid/community-server';
+export interface SqliteKeyValueStorageOptions {
+    /** Path to SQLite database file (can be prefixed with sqlite:) */
+    path: string;
+    tableName?: string;
+    namespace?: string;
+}
+/**
+ * SQLite-backed KeyValueStorage for local deployments.
+ * Stores internal CSS data (OIDC tokens, migration status, etc.) in SQLite.
+ */
+export declare class SqliteKeyValueStorage<T = unknown> implements KeyValueStorage<string, T>, Initializable, Finalizable {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private db;
+    private readonly path;
+    private readonly tableName;
+    private readonly namespace;
+    constructor(options: SqliteKeyValueStorageOptions);
+    initialize(): Promise<void>;
+    finalize(): Promise<void>;
+    private getDb;
+    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 toStorageKey(key: string): string;
+    protected validateAndSerialize(value: T, key: string): string;
+    protected parseValue(raw: string): T | undefined;
+}

package/dist/storage/keyvalue/SqliteKeyValueStorage.js

@@ -0,0 +1,164 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteKeyValueStorage = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const global_logger_factory_1 = require("global-logger-factory");
+function assertIdentifier(name) {
+    if (!/^[A-Za-z0-9_]+$/u.test(name)) {
+        throw new Error(`Invalid identifier: "${name}". Only alphanumeric and underscore are allowed.`);
+    }
+}
+function parseSqlitePath(path) {
+    // Handle sqlite: prefix (e.g., "sqlite:./data/identity.sqlite")
+    if (path.startsWith('sqlite:')) {
+        return path.slice(7);
+    }
+    return path;
+}
+/**
+ * SQLite-backed KeyValueStorage for local deployments.
+ * Stores internal CSS data (OIDC tokens, migration status, etc.) in SQLite.
+ */
+class SqliteKeyValueStorage {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.db = null;
+        this.path = parseSqlitePath(options.path);
+        this.tableName = options.tableName ?? 'internal_kv';
+        this.namespace = options.namespace ?? '';
+        assertIdentifier(this.tableName);
+    }
+    async initialize() {
+        if (this.db)
+            return;
+        this.db = new better_sqlite3_1.default(this.path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      )
+    `);
+        this.logger.info(`SqliteKeyValueStorage initialized: ${this.path}`);
+    }
+    async finalize() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    getDb() {
+        if (!this.db) {
+            // Lazy initialization
+            this.db = new better_sqlite3_1.default(this.path);
+            this.db.pragma('journal_mode = WAL');
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS ${this.tableName} (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL,
+          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+            this.logger.info(`SqliteKeyValueStorage initialized: ${this.path}`);
+        }
+        return this.db;
+    }
+    async has(key) {
+        const storageKey = this.toStorageKey(key);
+        const stmt = this.getDb().prepare(`SELECT 1 FROM ${this.tableName} WHERE key = ? LIMIT 1`);
+        const result = stmt.get(storageKey);
+        return result !== undefined;
+    }
+    async get(key) {
+        const storageKey = this.toStorageKey(key);
+        const stmt = this.getDb().prepare(`SELECT value FROM ${this.tableName} WHERE key = ? LIMIT 1`);
+        const result = stmt.get(storageKey);
+        if (!result) {
+            return undefined;
+        }
+        return this.parseValue(result.value);
+    }
+    async set(key, value) {
+        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;
+        }
+        const stmt = this.getDb().prepare(`
+      INSERT INTO ${this.tableName} (key, value, updated_at)
+      VALUES (?, ?, datetime('now'))
+      ON CONFLICT (key) DO UPDATE SET value = excluded.value, updated_at = datetime('now')
+    `);
+        stmt.run(storageKey, payload);
+        return this;
+    }
+    async delete(key) {
+        const storageKey = this.toStorageKey(key);
+        const stmt = this.getDb().prepare(`DELETE FROM ${this.tableName} WHERE key = ?`);
+        const result = stmt.run(storageKey);
+        return result.changes > 0;
+    }
+    async *entries() {
+        const prefix = this.namespace;
+        const query = prefix.length > 0
+            ? `SELECT key, value FROM ${this.tableName} WHERE key LIKE ?`
+            : `SELECT key, value FROM ${this.tableName}`;
+        const stmt = this.getDb().prepare(query);
+        const rows = prefix.length > 0
+            ? stmt.all(`${prefix}%`)
+            : stmt.all();
+        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`);
+            }
+            // 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 {
+            const parsed = JSON.parse(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: ${raw}`);
+            return undefined;
+        }
+    }
+}
+exports.SqliteKeyValueStorage = SqliteKeyValueStorage;
+//# sourceMappingURL=SqliteKeyValueStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteKeyValueStorage.js","sourceRoot":"","sources":["../../../src/storage/keyvalue/SqliteKeyValueStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import Database from 'better-sqlite3';\nimport type {\n  Finalizable,\n  Initializable,\n  KeyValueStorage,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\n\nexport interface SqliteKeyValueStorageOptions {\n  /** Path to SQLite database file (can be prefixed with sqlite:) */\n  path: string;\n  tableName?: string;\n  namespace?: string;\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\nfunction parseSqlitePath(path: string): string {\n  // Handle sqlite: prefix (e.g., \"sqlite:./data/identity.sqlite\")\n  if (path.startsWith('sqlite:')) {\n    return path.slice(7);\n  }\n  return path;\n}\n\n/**\n * SQLite-backed KeyValueStorage for local deployments.\n * Stores internal CSS data (OIDC tokens, migration status, etc.) in SQLite.\n */\nexport class SqliteKeyValueStorage<T = unknown> implements\n  KeyValueStorage<string, T>,\n  Initializable,\n  Finalizable {\n  protected readonly logger = getLoggerFor(this);\n  private db: Database.Database | null = null;\n  private readonly path: string;\n  private readonly tableName: string;\n  private readonly namespace: string;\n\n  public constructor(options: SqliteKeyValueStorageOptions) {\n    this.path = parseSqlitePath(options.path);\n    this.tableName = options.tableName ?? 'internal_kv';\n    this.namespace = options.namespace ?? '';\n    assertIdentifier(this.tableName);\n  }\n\n  public async initialize(): Promise<void> {\n    if (this.db) return;\n\n    this.db = new Database(this.path);\n    this.db.pragma('journal_mode = WAL');\n\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS ${this.tableName} (\n        key TEXT PRIMARY KEY,\n        value TEXT NOT NULL,\n        updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n      )\n    `);\n\n    this.logger.info(`SqliteKeyValueStorage initialized: ${this.path}`);\n  }\n\n  public async finalize(): Promise<void> {\n    if (this.db) {\n      this.db.close();\n      this.db = null;\n    }\n  }\n\n  private getDb(): Database.Database {\n    if (!this.db) {\n      // Lazy initialization\n      this.db = new Database(this.path);\n      this.db.pragma('journal_mode = WAL');\n\n      this.db.exec(`\n        CREATE TABLE IF NOT EXISTS ${this.tableName} (\n          key TEXT PRIMARY KEY,\n          value TEXT NOT NULL,\n          updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n        )\n      `);\n\n      this.logger.info(`SqliteKeyValueStorage initialized: ${this.path}`);\n    }\n    return this.db;\n  }\n\n  public async has(key: string): Promise<boolean> {\n    const storageKey = this.toStorageKey(key);\n    const stmt = this.getDb().prepare(\n      `SELECT 1 FROM ${this.tableName} WHERE key = ? LIMIT 1`\n    );\n    const result = stmt.get(storageKey);\n    return result !== undefined;\n  }\n\n  public async get(key: string): Promise<T | undefined> {\n    const storageKey = this.toStorageKey(key);\n    const stmt = this.getDb().prepare(\n      `SELECT value FROM ${this.tableName} WHERE key = ? LIMIT 1`\n    );\n    const result = stmt.get(storageKey) as { value: string } | undefined;\n    if (!result) {\n      return undefined;\n    }\n    return this.parseValue(result.value);\n  }\n\n  public async set(key: string, value: T): Promise<this> {\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    const stmt = this.getDb().prepare(`\n      INSERT INTO ${this.tableName} (key, value, updated_at)\n      VALUES (?, ?, datetime('now'))\n      ON CONFLICT (key) DO UPDATE SET value = excluded.value, updated_at = datetime('now')\n    `);\n    stmt.run(storageKey, payload);\n    return this;\n  }\n\n  public async delete(key: string): Promise<boolean> {\n    const storageKey = this.toStorageKey(key);\n    const stmt = this.getDb().prepare(\n      `DELETE FROM ${this.tableName} WHERE key = ?`\n    );\n    const result = stmt.run(storageKey);\n    return result.changes > 0;\n  }\n\n  public async *entries(): AsyncIterableIterator<[string, T]> {\n    const prefix = this.namespace;\n    const query = prefix.length > 0\n      ? `SELECT key, value FROM ${this.tableName} WHERE key LIKE ?`\n      : `SELECT key, value FROM ${this.tableName}`;\n\n    const stmt = this.getDb().prepare(query);\n    const rows = prefix.length > 0\n      ? stmt.all(`${prefix}%`) as { key: string; value: string }[]\n      : stmt.all() as { key: string; value: string }[];\n\n    for (const row of 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 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\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: string): T | undefined {\n    try {\n      const parsed = JSON.parse(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: ${raw}`);\n      return undefined;\n    }\n  }\n}\n"]}

package/dist/storage/keyvalue/SqliteKeyValueStorage.jsonld

@@ -0,0 +1,167 @@
+{
+  "@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/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage",
+      "@type": "Class",
+      "requireElement": "SqliteKeyValueStorage",
+      "extends": [
+        {
+          "@type": "GenericComponentExtension",
+          "component": "css:dist/storage/keyvalue/KeyValueStorage.jsonld#KeyValueStorage",
+          "genericTypeInstances": [
+            "xsd:string",
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__generic_T"
+            }
+          ]
+        },
+        "css:dist/init/Initializable.jsonld#Initializable",
+        "css:dist/init/final/Finalizable.jsonld#Finalizable"
+      ],
+      "comment": "SQLite-backed KeyValueStorage for local deployments. Stores internal CSS data (OIDC tokens, migration status, etc.) in SQLite.",
+      "genericTypeParameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__generic_T",
+          "default": {
+            "@type": "ParameterRangeWildcard"
+          }
+        }
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options_path",
+          "range": "xsd:string",
+          "comment": "Path to SQLite database file (can be prefixed with sqlite:)"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options_tableName",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options_namespace",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_db",
+          "memberFieldName": "db"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_path",
+          "memberFieldName": "path"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_tableName",
+          "memberFieldName": "tableName"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_namespace",
+          "memberFieldName": "namespace"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_initialize",
+          "memberFieldName": "initialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_finalize",
+          "memberFieldName": "finalize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_getDb",
+          "memberFieldName": "getDb"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_has",
+          "memberFieldName": "has"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_get",
+          "memberFieldName": "get"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_set",
+          "memberFieldName": "set"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_delete",
+          "memberFieldName": "delete"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_entries",
+          "memberFieldName": "entries"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_toStorageKey",
+          "memberFieldName": "toStorageKey"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_validateAndSerialize",
+          "memberFieldName": "validateAndSerialize"
+        },
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage__member_parseValue",
+          "memberFieldName": "parseValue"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "path",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options_path"
+              }
+            },
+            {
+              "keyRaw": "tableName",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options_tableName"
+              }
+            },
+            {
+              "keyRaw": "namespace",
+              "value": {
+                "@id": "undefineds:dist/storage/keyvalue/SqliteKeyValueStorage.jsonld#SqliteKeyValueStorage_options_namespace"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}