@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/identity/drizzle/PodLookupRepository.d.ts

@@ -0,0 +1,59 @@
+import { type IdentityDatabase } from './db';
+export interface PodLookupResult {
+    podId: string;
+    accountId: string;
+    baseUrl: string;
+    nodeId?: string;
+    edgeNodeId?: string;
+}
+export interface PodMigrationStatus {
+    podId: string;
+    nodeId?: string;
+    migrationStatus?: 'syncing' | 'done' | null;
+    migrationTargetNode?: string;
+    migrationProgress?: number;
+}
+/**
+ * Repository for Pod lookup operations.
+ *
+ * Reads Pod data from CSS's internal_kv table where account data is stored.
+ * CSS stores account data at key "accounts/data/{accountId}" with Pod info
+ * nested in the "**pod**" field.
+ */
+export declare class PodLookupRepository {
+    private readonly db;
+    private readonly kvTableName;
+    private readonly usageTableName;
+    constructor(db: IdentityDatabase, kvTableName?: string);
+    /**
+     * Find Pod by resource path (matches longest baseUrl prefix).
+     */
+    findByResourceIdentifier(resourcePath: string): Promise<PodLookupResult | undefined>;
+    /**
+     * Get Pod by ID.
+     */
+    findById(podId: string): Promise<PodLookupResult | undefined>;
+    /**
+     * Get migration status for a Pod from identity_pod_usage table.
+     */
+    getMigrationStatus(podId: string): Promise<PodMigrationStatus | undefined>;
+    /**
+     * Set the nodeId for a Pod in identity_pod_usage table.
+     */
+    setNodeId(podId: string, nodeId: string): Promise<void>;
+    /**
+     * Update migration status for a Pod in identity_pod_usage table.
+     */
+    setMigrationStatus(podId: string, status: 'syncing' | 'done' | null, targetNode?: string | null, progress?: number | null): Promise<void>;
+    /**
+     * List all pods.
+     */
+    listAllPods(): Promise<PodLookupResult[]>;
+    /**
+     * Extract all pods from CSS's internal_kv storage.
+     *
+     * It keeps backward compatibility with legacy rows that already expose
+     * id/account_id/base_url columns (used by some unit tests and older schemas).
+     */
+    private getAllPods;
+}

package/dist/identity/drizzle/PodLookupRepository.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodLookupRepository = void 0;
+const drizzle_orm_1 = require("drizzle-orm");
+const db_1 = require("./db");
+/**
+ * Repository for Pod lookup operations.
+ *
+ * Reads Pod data from CSS's internal_kv table where account data is stored.
+ * CSS stores account data at key "accounts/data/{accountId}" with Pod info
+ * nested in the "**pod**" field.
+ */
+class PodLookupRepository {
+    constructor(db, kvTableName) {
+        this.db = db;
+        this.kvTableName = kvTableName ?? 'internal_kv';
+        this.usageTableName = 'identity_pod_usage';
+    }
+    /**
+     * Find Pod by resource path (matches longest baseUrl prefix).
+     */
+    async findByResourceIdentifier(resourcePath) {
+        const pods = await this.getAllPods();
+        let bestMatch;
+        let bestLength = 0;
+        for (const pod of pods) {
+            if (resourcePath.startsWith(pod.baseUrl) && pod.baseUrl.length > bestLength) {
+                bestMatch = pod;
+                bestLength = pod.baseUrl.length;
+            }
+        }
+        return bestMatch;
+    }
+    /**
+     * Get Pod by ID.
+     */
+    async findById(podId) {
+        const pods = await this.getAllPods();
+        return pods.find((p) => p.podId === podId);
+    }
+    /**
+     * Get migration status for a Pod from identity_pod_usage table.
+     */
+    async getMigrationStatus(podId) {
+        try {
+            const tableId = drizzle_orm_1.sql.identifier([this.usageTableName]);
+            const result = await (0, db_1.executeQuery)(this.db, (0, drizzle_orm_1.sql) `
+        SELECT pod_id, node_id, migration_status, migration_target_node, migration_progress
+        FROM ${tableId}
+        WHERE pod_id = ${podId}
+        LIMIT 1
+      `);
+            if (result.rows.length === 0) {
+                return undefined;
+            }
+            const row = result.rows[0];
+            return {
+                podId: row.pod_id ?? row.id ?? podId,
+                nodeId: row.node_id ?? undefined,
+                migrationStatus: row.migration_status,
+                migrationTargetNode: row.migration_target_node ?? undefined,
+                migrationProgress: row.migration_progress ?? undefined,
+            };
+        }
+        catch {
+            // Table might not exist.
+            return undefined;
+        }
+    }
+    /**
+     * Set the nodeId for a Pod in identity_pod_usage table.
+     */
+    async setNodeId(podId, nodeId) {
+        const tableId = drizzle_orm_1.sql.identifier([this.usageTableName]);
+        await (0, db_1.executeStatement)(this.db, (0, drizzle_orm_1.sql) `
+      INSERT INTO ${tableId} (pod_id, account_id, node_id)
+      VALUES (${podId}, '', ${nodeId})
+      ON CONFLICT (pod_id) DO UPDATE SET node_id = ${nodeId}
+    `);
+    }
+    /**
+     * Update migration status for a Pod in identity_pod_usage table.
+     */
+    async setMigrationStatus(podId, status, targetNode, progress) {
+        const tableId = drizzle_orm_1.sql.identifier([this.usageTableName]);
+        await (0, db_1.executeStatement)(this.db, (0, drizzle_orm_1.sql) `
+      INSERT INTO ${tableId} (pod_id, account_id, migration_status, migration_target_node, migration_progress)
+      VALUES (${podId}, '', ${status}, ${targetNode ?? null}, ${progress ?? 0})
+      ON CONFLICT (pod_id) DO UPDATE SET
+        migration_status = ${status},
+        migration_target_node = ${targetNode ?? null},
+        migration_progress = ${progress ?? 0}
+    `);
+    }
+    /**
+     * List all pods.
+     */
+    async listAllPods() {
+        return this.getAllPods();
+    }
+    /**
+     * Extract all pods from CSS's internal_kv storage.
+     *
+     * It keeps backward compatibility with legacy rows that already expose
+     * id/account_id/base_url columns (used by some unit tests and older schemas).
+     */
+    async getAllPods() {
+        const kvTableId = drizzle_orm_1.sql.identifier([this.kvTableName]);
+        const result = await (0, db_1.executeQuery)(this.db, (0, drizzle_orm_1.sql) `
+      SELECT key, value FROM ${kvTableId}
+      WHERE key LIKE 'accounts/data/%'
+    `);
+        const pods = [];
+        for (const row of result.rows) {
+            if (row.id && row.account_id && row.base_url) {
+                pods.push({
+                    podId: String(row.id),
+                    accountId: String(row.account_id),
+                    baseUrl: String(row.base_url),
+                    nodeId: row.node_id ? String(row.node_id) : undefined,
+                    edgeNodeId: row.edge_node_id ? String(row.edge_node_id) : undefined,
+                });
+                continue;
+            }
+            if (!row.key || row.value === undefined) {
+                continue;
+            }
+            try {
+                const accountId = row.key.replace('accounts/data/', '');
+                const data = typeof row.value === 'string' ? JSON.parse(row.value) : row.value;
+                const podMap = data['**pod**'] || data.pod || {};
+                for (const [podId, podData] of Object.entries(podMap)) {
+                    const pod = podData;
+                    if (pod.baseUrl && typeof pod.baseUrl === 'string') {
+                        pods.push({
+                            podId,
+                            accountId,
+                            baseUrl: pod.baseUrl,
+                            nodeId: typeof pod.nodeId === 'string' ? pod.nodeId : undefined,
+                            edgeNodeId: typeof pod.edgeNodeId === 'string' ? pod.edgeNodeId : undefined,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Skip malformed entries.
+            }
+        }
+        return pods;
+    }
+}
+exports.PodLookupRepository = PodLookupRepository;
+//# sourceMappingURL=PodLookupRepository.js.map

package/dist/identity/drizzle/PodLookupRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodLookupRepository.js","sourceRoot":"","sources":["../../../src/identity/drizzle/PodLookupRepository.ts"],"names":[],"mappings":"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","sourcesContent":["import { sql } from 'drizzle-orm';\nimport { type IdentityDatabase, executeQuery, executeStatement } from './db';\n\nexport interface PodLookupResult {\n  podId: string;\n  accountId: string;\n  baseUrl: string;\n  nodeId?: string;\n  edgeNodeId?: string;\n}\n\nexport interface PodMigrationStatus {\n  podId: string;\n  nodeId?: string;\n  migrationStatus?: 'syncing' | 'done' | null;\n  migrationTargetNode?: string;\n  migrationProgress?: number;\n}\n\ninterface InternalKvRow {\n  key?: string;\n  value?: string;\n  id?: string;\n  account_id?: string;\n  base_url?: string;\n  node_id?: string;\n  edge_node_id?: string;\n}\n\n/**\n * Repository for Pod lookup operations.\n *\n * Reads Pod data from CSS's internal_kv table where account data is stored.\n * CSS stores account data at key \"accounts/data/{accountId}\" with Pod info\n * nested in the \"**pod**\" field.\n */\nexport class PodLookupRepository {\n  private readonly kvTableName: string;\n  private readonly usageTableName: string;\n\n  public constructor(\n    private readonly db: IdentityDatabase,\n    kvTableName?: string,\n  ) {\n    this.kvTableName = kvTableName ?? 'internal_kv';\n    this.usageTableName = 'identity_pod_usage';\n  }\n\n  /**\n   * Find Pod by resource path (matches longest baseUrl prefix).\n   */\n  public async findByResourceIdentifier(resourcePath: string): Promise<PodLookupResult | undefined> {\n    const pods = await this.getAllPods();\n\n    let bestMatch: PodLookupResult | undefined;\n    let bestLength = 0;\n\n    for (const pod of pods) {\n      if (resourcePath.startsWith(pod.baseUrl) && pod.baseUrl.length > bestLength) {\n        bestMatch = pod;\n        bestLength = pod.baseUrl.length;\n      }\n    }\n\n    return bestMatch;\n  }\n\n  /**\n   * Get Pod by ID.\n   */\n  public async findById(podId: string): Promise<PodLookupResult | undefined> {\n    const pods = await this.getAllPods();\n    return pods.find((p) => p.podId === podId);\n  }\n\n  /**\n   * Get migration status for a Pod from identity_pod_usage table.\n   */\n  public async getMigrationStatus(podId: string): Promise<PodMigrationStatus | undefined> {\n    try {\n      const tableId = sql.identifier([this.usageTableName]);\n      const result = await executeQuery<{\n        pod_id?: string;\n        id?: string;\n        node_id?: string | null;\n        migration_status?: string | null;\n        migration_target_node?: string | null;\n        migration_progress?: number | null;\n      }>(this.db, sql`\n        SELECT pod_id, node_id, migration_status, migration_target_node, migration_progress\n        FROM ${tableId}\n        WHERE pod_id = ${podId}\n        LIMIT 1\n      `);\n\n      if (result.rows.length === 0) {\n        return undefined;\n      }\n      const row = result.rows[0];\n      return {\n        podId: row.pod_id ?? row.id ?? podId,\n        nodeId: row.node_id ?? undefined,\n        migrationStatus: row.migration_status as 'syncing' | 'done' | null | undefined,\n        migrationTargetNode: row.migration_target_node ?? undefined,\n        migrationProgress: row.migration_progress ?? undefined,\n      };\n    } catch {\n      // Table might not exist.\n      return undefined;\n    }\n  }\n\n  /**\n   * Set the nodeId for a Pod in identity_pod_usage table.\n   */\n  public async setNodeId(podId: string, nodeId: string): Promise<void> {\n    const tableId = sql.identifier([this.usageTableName]);\n    await executeStatement(this.db, sql`\n      INSERT INTO ${tableId} (pod_id, account_id, node_id)\n      VALUES (${podId}, '', ${nodeId})\n      ON CONFLICT (pod_id) DO UPDATE SET node_id = ${nodeId}\n    `);\n  }\n\n  /**\n   * Update migration status for a Pod in identity_pod_usage table.\n   */\n  public async setMigrationStatus(\n    podId: string,\n    status: 'syncing' | 'done' | null,\n    targetNode?: string | null,\n    progress?: number | null,\n  ): Promise<void> {\n    const tableId = sql.identifier([this.usageTableName]);\n    await executeStatement(this.db, sql`\n      INSERT INTO ${tableId} (pod_id, account_id, migration_status, migration_target_node, migration_progress)\n      VALUES (${podId}, '', ${status}, ${targetNode ?? null}, ${progress ?? 0})\n      ON CONFLICT (pod_id) DO UPDATE SET\n        migration_status = ${status},\n        migration_target_node = ${targetNode ?? null},\n        migration_progress = ${progress ?? 0}\n    `);\n  }\n\n  /**\n   * List all pods.\n   */\n  public async listAllPods(): Promise<PodLookupResult[]> {\n    return this.getAllPods();\n  }\n\n  /**\n   * Extract all pods from CSS's internal_kv storage.\n   *\n   * It keeps backward compatibility with legacy rows that already expose\n   * id/account_id/base_url columns (used by some unit tests and older schemas).\n   */\n  private async getAllPods(): Promise<PodLookupResult[]> {\n    const kvTableId = sql.identifier([this.kvTableName]);\n\n    const result = await executeQuery<InternalKvRow>(this.db, sql`\n      SELECT key, value FROM ${kvTableId}\n      WHERE key LIKE 'accounts/data/%'\n    `);\n\n    const pods: PodLookupResult[] = [];\n\n    for (const row of result.rows) {\n      if (row.id && row.account_id && row.base_url) {\n        pods.push({\n          podId: String(row.id),\n          accountId: String(row.account_id),\n          baseUrl: String(row.base_url),\n          nodeId: row.node_id ? String(row.node_id) : undefined,\n          edgeNodeId: row.edge_node_id ? String(row.edge_node_id) : undefined,\n        });\n        continue;\n      }\n\n      if (!row.key || row.value === undefined) {\n        continue;\n      }\n\n      try {\n        const accountId = row.key.replace('accounts/data/', '');\n        const data = typeof row.value === 'string' ? JSON.parse(row.value) : row.value;\n\n        const podMap = (data as any)['**pod**'] || (data as any).pod || {};\n\n        for (const [podId, podData] of Object.entries(podMap)) {\n          const pod = podData as Record<string, unknown>;\n          if (pod.baseUrl && typeof pod.baseUrl === 'string') {\n            pods.push({\n              podId,\n              accountId,\n              baseUrl: pod.baseUrl,\n              nodeId: typeof pod.nodeId === 'string' ? pod.nodeId : undefined,\n              edgeNodeId: typeof pod.edgeNodeId === 'string' ? pod.edgeNodeId : undefined,\n            });\n          }\n        }\n      } catch {\n        // Skip malformed entries.\n      }\n    }\n\n    return pods;\n  }\n}\n"]}

package/dist/identity/drizzle/WebIdProfileRepository.d.ts

@@ -0,0 +1,58 @@
+/**
+ * WebID Profile Repository
+ *
+ * 管理 WebID Profile 的托管，支持身份与存储分离架构
+ */
+import type { IdentityDatabase } from './db';
+export interface WebIdProfile {
+    username: string;
+    webidUrl: string;
+    storageUrl?: string;
+    storageMode: 'cloud' | 'local' | 'custom';
+    oidcIssuer?: string;
+    profileData?: Record<string, unknown>;
+    accountId?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateWebIdProfileInput {
+    username: string;
+    storageMode?: 'cloud' | 'local' | 'custom';
+    storageUrl?: string;
+    accountId?: string;
+}
+export interface UpdateStorageInput {
+    storageUrl: string;
+    storageMode?: 'cloud' | 'local' | 'custom';
+}
+export declare class WebIdProfileRepository {
+    private readonly db;
+    private readonly baseUrl;
+    constructor(db: IdentityDatabase, options: {
+        baseUrl: string;
+    });
+    /**
+     * 创建 WebID Profile
+     */
+    create(input: CreateWebIdProfileInput): Promise<WebIdProfile>;
+    /**
+     * 获取 WebID Profile
+     */
+    get(username: string): Promise<WebIdProfile | null>;
+    /**
+     * 更新 Storage URL（用于 Local 节点更新指针）
+     */
+    updateStorage(username: string, input: UpdateStorageInput): Promise<WebIdProfile | null>;
+    /**
+     * 删除 WebID Profile
+     */
+    delete(username: string): Promise<boolean>;
+    /**
+     * 生成 WebID Profile 的 Turtle 格式
+     */
+    generateProfileTurtle(profile: WebIdProfile): string;
+    /**
+     * 生成默认的 Profile 数据（JSON-LD 格式）
+     */
+    private generateDefaultProfile;
+}

package/dist/identity/drizzle/WebIdProfileRepository.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * WebID Profile Repository
+ *
+ * 管理 WebID Profile 的托管，支持身份与存储分离架构
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebIdProfileRepository = void 0;
+const drizzle_orm_1 = require("drizzle-orm");
+const global_logger_factory_1 = require("global-logger-factory");
+const logger = (0, global_logger_factory_1.getLoggerFor)('WebIdProfileRepository');
+class WebIdProfileRepository {
+    constructor(db, options) {
+        this.db = db;
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+    }
+    /**
+     * 创建 WebID Profile
+     */
+    async create(input) {
+        const { username, storageMode = 'cloud', storageUrl, accountId } = input;
+        // 生成 WebID URL
+        const webidUrl = `${this.baseUrl}/${username}/profile/card#me`;
+        // 默认 storage URL
+        const defaultStorageUrl = storageMode === 'cloud'
+            ? `${this.baseUrl}/${username}/`
+            : storageUrl;
+        // 生成默认的 Profile 数据
+        const profileData = this.generateDefaultProfile(username, webidUrl, defaultStorageUrl);
+        const now = new Date();
+        await this.db.insert(this.db.schema.webidProfiles).values({
+            username,
+            webidUrl,
+            storageUrl: defaultStorageUrl,
+            storageMode,
+            oidcIssuer: this.baseUrl,
+            profileData,
+            accountId,
+            createdAt: now,
+            updatedAt: now,
+        });
+        logger.info(`Created WebID profile for ${username}: ${webidUrl}`);
+        return {
+            username,
+            webidUrl,
+            storageUrl: defaultStorageUrl,
+            storageMode,
+            oidcIssuer: this.baseUrl,
+            profileData,
+            accountId,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    /**
+     * 获取 WebID Profile
+     */
+    async get(username) {
+        const results = await this.db
+            .select()
+            .from(this.db.schema.webidProfiles)
+            .where((0, drizzle_orm_1.eq)(this.db.schema.webidProfiles.username, username))
+            .limit(1);
+        if (results.length === 0) {
+            return null;
+        }
+        const row = results[0];
+        return {
+            username: row.username,
+            webidUrl: row.webidUrl,
+            storageUrl: row.storageUrl ?? undefined,
+            storageMode: row.storageMode ?? 'cloud',
+            oidcIssuer: row.oidcIssuer ?? undefined,
+            profileData: row.profileData,
+            accountId: row.accountId ?? undefined,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+        };
+    }
+    /**
+     * 更新 Storage URL（用于 Local 节点更新指针）
+     */
+    async updateStorage(username, input) {
+        const { storageUrl, storageMode } = input;
+        const existing = await this.get(username);
+        if (!existing) {
+            return null;
+        }
+        // 更新 Profile 数据中的 storage
+        const profileData = {
+            ...(existing.profileData ?? {}),
+            'solid:storage': { '@id': storageUrl },
+        };
+        const now = new Date();
+        await this.db
+            .update(this.db.schema.webidProfiles)
+            .set({
+            storageUrl,
+            storageMode: storageMode ?? existing.storageMode,
+            profileData,
+            updatedAt: now,
+        })
+            .where((0, drizzle_orm_1.eq)(this.db.schema.webidProfiles.username, username));
+        logger.info(`Updated storage for ${username}: ${storageUrl}`);
+        return {
+            ...existing,
+            storageUrl,
+            storageMode: storageMode ?? existing.storageMode,
+            profileData,
+            updatedAt: now,
+        };
+    }
+    /**
+     * 删除 WebID Profile
+     */
+    async delete(username) {
+        const result = await this.db
+            .delete(this.db.schema.webidProfiles)
+            .where((0, drizzle_orm_1.eq)(this.db.schema.webidProfiles.username, username));
+        // drizzle 返回的结果格式因数据库而异
+        return true;
+    }
+    /**
+     * 生成 WebID Profile 的 Turtle 格式
+     */
+    generateProfileTurtle(profile) {
+        const { webidUrl, storageUrl, oidcIssuer } = profile;
+        return `@prefix foaf: <http://xmlns.com/foaf/0.1/>.
+@prefix solid: <http://www.w3.org/ns/solid/terms#>.
+
+<${webidUrl}>
+    a foaf:Person;
+    solid:oidcIssuer <${oidcIssuer}>${storageUrl ? `;
+    solid:storage <${storageUrl}>` : ''}.
+`;
+    }
+    /**
+     * 生成默认的 Profile 数据（JSON-LD 格式）
+     */
+    generateDefaultProfile(username, webidUrl, storageUrl) {
+        const profile = {
+            '@context': {
+                foaf: 'http://xmlns.com/foaf/0.1/',
+                solid: 'http://www.w3.org/ns/solid/terms#',
+            },
+            '@id': webidUrl,
+            '@type': 'foaf:Person',
+            'solid:oidcIssuer': { '@id': this.baseUrl },
+        };
+        if (storageUrl) {
+            profile['solid:storage'] = { '@id': storageUrl };
+        }
+        return profile;
+    }
+}
+exports.WebIdProfileRepository = WebIdProfileRepository;
+//# sourceMappingURL=WebIdProfileRepository.js.map

package/dist/identity/drizzle/WebIdProfileRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebIdProfileRepository.js","sourceRoot":"","sources":["../../../src/identity/drizzle/WebIdProfileRepository.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WebID Profile Repository\n *\n * 管理 WebID Profile 的托管，支持身份与存储分离架构\n */\n\nimport { eq } from 'drizzle-orm';\nimport type { IdentityDatabase } from './db';\nimport { getLoggerFor } from 'global-logger-factory';\n\nconst logger = getLoggerFor('WebIdProfileRepository');\n\nexport interface WebIdProfile {\n  username: string;\n  webidUrl: string;\n  storageUrl?: string;\n  storageMode: 'cloud' | 'local' | 'custom';\n  oidcIssuer?: string;\n  profileData?: Record<string, unknown>;\n  accountId?: string;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface CreateWebIdProfileInput {\n  username: string;\n  storageMode?: 'cloud' | 'local' | 'custom';\n  storageUrl?: string;\n  accountId?: string;\n}\n\nexport interface UpdateStorageInput {\n  storageUrl: string;\n  storageMode?: 'cloud' | 'local' | 'custom';\n}\n\nexport class WebIdProfileRepository {\n  private readonly baseUrl: string;\n\n  constructor(\n    private readonly db: IdentityDatabase,\n    options: { baseUrl: string },\n  ) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n  }\n\n  /**\n   * 创建 WebID Profile\n   */\n  async create(input: CreateWebIdProfileInput): Promise<WebIdProfile> {\n    const { username, storageMode = 'cloud', storageUrl, accountId } = input;\n\n    // 生成 WebID URL\n    const webidUrl = `${this.baseUrl}/${username}/profile/card#me`;\n\n    // 默认 storage URL\n    const defaultStorageUrl = storageMode === 'cloud'\n      ? `${this.baseUrl}/${username}/`\n      : storageUrl;\n\n    // 生成默认的 Profile 数据\n    const profileData = this.generateDefaultProfile(username, webidUrl, defaultStorageUrl);\n\n    const now = new Date();\n\n    await this.db.insert(this.db.schema.webidProfiles).values({\n      username,\n      webidUrl,\n      storageUrl: defaultStorageUrl,\n      storageMode,\n      oidcIssuer: this.baseUrl,\n      profileData,\n      accountId,\n      createdAt: now,\n      updatedAt: now,\n    });\n\n    logger.info(`Created WebID profile for ${username}: ${webidUrl}`);\n\n    return {\n      username,\n      webidUrl,\n      storageUrl: defaultStorageUrl,\n      storageMode,\n      oidcIssuer: this.baseUrl,\n      profileData,\n      accountId,\n      createdAt: now,\n      updatedAt: now,\n    };\n  }\n\n  /**\n   * 获取 WebID Profile\n   */\n  async get(username: string): Promise<WebIdProfile | null> {\n    const results = await this.db\n      .select()\n      .from(this.db.schema.webidProfiles)\n      .where(eq(this.db.schema.webidProfiles.username, username))\n      .limit(1);\n\n    if (results.length === 0) {\n      return null;\n    }\n\n    const row = results[0];\n    return {\n      username: row.username,\n      webidUrl: row.webidUrl,\n      storageUrl: row.storageUrl ?? undefined,\n      storageMode: (row.storageMode as 'cloud' | 'local' | 'custom') ?? 'cloud',\n      oidcIssuer: row.oidcIssuer ?? undefined,\n      profileData: row.profileData as Record<string, unknown> | undefined,\n      accountId: row.accountId ?? undefined,\n      createdAt: row.createdAt,\n      updatedAt: row.updatedAt,\n    };\n  }\n\n  /**\n   * 更新 Storage URL（用于 Local 节点更新指针）\n   */\n  async updateStorage(username: string, input: UpdateStorageInput): Promise<WebIdProfile | null> {\n    const { storageUrl, storageMode } = input;\n\n    const existing = await this.get(username);\n    if (!existing) {\n      return null;\n    }\n\n    // 更新 Profile 数据中的 storage\n    const profileData = {\n      ...(existing.profileData ?? {}),\n      'solid:storage': { '@id': storageUrl },\n    };\n\n    const now = new Date();\n\n    await this.db\n      .update(this.db.schema.webidProfiles)\n      .set({\n        storageUrl,\n        storageMode: storageMode ?? existing.storageMode,\n        profileData,\n        updatedAt: now,\n      })\n      .where(eq(this.db.schema.webidProfiles.username, username));\n\n    logger.info(`Updated storage for ${username}: ${storageUrl}`);\n\n    return {\n      ...existing,\n      storageUrl,\n      storageMode: storageMode ?? existing.storageMode,\n      profileData,\n      updatedAt: now,\n    };\n  }\n\n  /**\n   * 删除 WebID Profile\n   */\n  async delete(username: string): Promise<boolean> {\n    const result = await this.db\n      .delete(this.db.schema.webidProfiles)\n      .where(eq(this.db.schema.webidProfiles.username, username));\n\n    // drizzle 返回的结果格式因数据库而异\n    return true;\n  }\n\n  /**\n   * 生成 WebID Profile 的 Turtle 格式\n   */\n  generateProfileTurtle(profile: WebIdProfile): string {\n    const { webidUrl, storageUrl, oidcIssuer } = profile;\n\n    return `@prefix foaf: <http://xmlns.com/foaf/0.1/>.\n@prefix solid: <http://www.w3.org/ns/solid/terms#>.\n\n<${webidUrl}>\n    a foaf:Person;\n    solid:oidcIssuer <${oidcIssuer}>${storageUrl ? `;\n    solid:storage <${storageUrl}>` : ''}.\n`;\n  }\n\n  /**\n   * 生成默认的 Profile 数据（JSON-LD 格式）\n   */\n  private generateDefaultProfile(\n    username: string,\n    webidUrl: string,\n    storageUrl?: string,\n  ): Record<string, unknown> {\n    const profile: Record<string, unknown> = {\n      '@context': {\n        foaf: 'http://xmlns.com/foaf/0.1/',\n        solid: 'http://www.w3.org/ns/solid/terms#',\n      },\n      '@id': webidUrl,\n      '@type': 'foaf:Person',\n      'solid:oidcIssuer': { '@id': this.baseUrl },\n    };\n\n    if (storageUrl) {\n      profile['solid:storage'] = { '@id': storageUrl };\n    }\n\n    return profile;\n  }\n}\n"]}

package/dist/identity/drizzle/db.d.ts

@@ -0,0 +1,60 @@
+import type { SQL } from 'drizzle-orm/sql';
+import * as pgSchema from './schema.pg';
+import * as sqliteSchema from './schema.sqlite';
+export type IdentityDatabase = any;
+export type IdentitySchema = typeof pgSchema | typeof sqliteSchema;
+/**
+ * Standardized query result format across databases.
+ */
+export interface QueryResult<T = Record<string, unknown>> {
+    rows: T[];
+}
+/**
+ * Returns true if the connection string is a SQLite URL.
+ */
+export declare function isSqliteUrl(connectionString: string): boolean;
+/**
+ * Get or create a Drizzle database connection with the appropriate schema.
+ * Supports both PostgreSQL and SQLite.
+ */
+export declare function getIdentityDatabase(connectionString: string): IdentityDatabase;
+/**
+ * Get the schema for a given connection string.
+ */
+export declare function getIdentitySchema(connectionString: string): IdentitySchema;
+/**
+ * Safely get a Drizzle database connection, returning undefined on error.
+ * Use this when the identity database is optional (e.g., for usage tracking).
+ */
+export declare function tryGetIdentityDatabase(connectionString: string): IdentityDatabase | undefined;
+export declare function closeAllIdentityConnections(): Promise<void>;
+/**
+ * Check if a database connection is SQLite.
+ * SQLite drizzle has `all()` method but no `execute()` method.
+ * PostgreSQL drizzle has `execute()` method but no `all()` method.
+ */
+export declare function isDatabaseSqlite(db: IdentityDatabase): boolean;
+/**
+ * Execute a SQL query uniformly across PostgreSQL and SQLite.
+ * Returns a standardized result with rows array.
+ *
+ * @example
+ * const result = await executeQuery(db, sql`SELECT * FROM users WHERE id = ${userId}`);
+ * if (result.rows.length > 0) { ... }
+ */
+export declare function executeQuery<T = Record<string, unknown>>(db: IdentityDatabase, query: SQL): Promise<QueryResult<T>>;
+/**
+ * Execute a SQL statement that doesn't return rows (INSERT, UPDATE, DELETE).
+ * Works uniformly across PostgreSQL and SQLite.
+ */
+export declare function executeStatement(db: IdentityDatabase, query: SQL): Promise<void>;
+/**
+ * Convert a Date to a value suitable for the database.
+ * SQLite uses Unix timestamps (seconds), PostgreSQL uses Date objects.
+ */
+export declare function toDbTimestamp(db: IdentityDatabase, date: Date): number | Date;
+/**
+ * Parse a timestamp value from database result to Date.
+ * Handles both Unix timestamps (SQLite) and Date objects (PostgreSQL).
+ */
+export declare function fromDbTimestamp(value: unknown): Date | undefined;