@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/util/identifiers/SubdomainPodIdentifierStrategy.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubdomainPodIdentifierStrategy = void 0;
+const node_url_1 = require("node:url");
+const global_logger_factory_1 = require("global-logger-factory");
+const community_server_1 = require("@solid/community-server");
+const PathUtil_1 = require("@solid/community-server/dist/util/PathUtil");
+/**
+ * Subdomain Pod Identifier Strategy
+ *
+ * 支持格式: {node-id}.baseDomain/{pod-name}/resource
+ *
+ * 示例:
+ * - https://node1.pods.undefineds.site/alice/data.ttl
+ * - https://node1.pods.undefineds.site/bob/profile/card
+ *
+ * 路径结构:
+ * - /{pod-name}/ 表示一个 Pod 的根容器
+ * - /{pod-name}/resource 表示 Pod 内的资源
+ */
+class SubdomainPodIdentifierStrategy extends community_server_1.BaseIdentifierStrategy {
+    constructor(options) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        if (!options.baseDomain) {
+            throw new Error('SubdomainPodIdentifierStrategy requires a baseDomain.');
+        }
+        this.baseDomain = options.baseDomain.toLowerCase();
+        this.logger.info(`Initialized with baseDomain: ${this.baseDomain}`);
+    }
+    /**
+     * 检查 identifier 是否被支持
+     *
+     * 条件:
+     * 1. hostname 必须匹配 *.baseDomain
+     * 2. 路径必须以 /{pod-name}/ 开头
+     */
+    supportsIdentifier(identifier) {
+        try {
+            const target = new node_url_1.URL(identifier.path);
+            const hostname = target.hostname.toLowerCase();
+            // 必须匹配 *.baseDomain
+            if (!hostname.endsWith(`.${this.baseDomain}`)) {
+                return false;
+            }
+            // 提取 node-id
+            const nodeId = this.extractNodeId(hostname);
+            if (!nodeId || !this.isValidNodeId(nodeId)) {
+                this.logger.debug(`Invalid nodeId in hostname: ${hostname}`);
+                return false;
+            }
+            // 路径必须包含 pod 名称 (至少 /{pod}/)
+            const podName = this.extractPodNameFromPath(target.pathname);
+            if (!podName || !this.isValidPodName(podName)) {
+                this.logger.debug(`Invalid podName in path: ${target.pathname}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            this.logger.warn(`Failed to parse identifier ${identifier.path}: ${error.message}`);
+            return false;
+        }
+    }
+    /**
+     * 检查是否是根容器
+     *
+     * 根容器是 /{pod-name}/
+     */
+    isRootContainer(identifier) {
+        try {
+            const target = new node_url_1.URL(identifier.path);
+            const pathname = (0, PathUtil_1.ensureTrailingSlash)(target.pathname);
+            // 根容器路径应该是 /{pod}/
+            const segments = pathname.split('/').filter(Boolean);
+            return segments.length === 1;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 从 hostname 提取 node-id
+     * node1.pods.undefineds.site -> node1
+     */
+    extractNodeId(hostname) {
+        const suffix = `.${this.baseDomain}`;
+        const lowerHostname = hostname.toLowerCase();
+        if (!lowerHostname.endsWith(suffix)) {
+            return undefined;
+        }
+        const nodeId = lowerHostname.slice(0, -suffix.length);
+        return nodeId || undefined;
+    }
+    /**
+     * 从 identifier 提取 Pod 名称
+     */
+    extractPodName(identifier) {
+        try {
+            const target = new node_url_1.URL(identifier.path);
+            return this.extractPodNameFromPath(target.pathname);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 从路径提取 Pod 名称
+     * /alice/data.ttl -> alice
+     * / -> undefined
+     */
+    extractPodNameFromPath(pathname) {
+        const segments = pathname.split('/').filter(Boolean);
+        return segments[0];
+    }
+    /**
+     * 获取 Pod 的根容器 identifier
+     */
+    getPodRootIdentifier(podName, nodeId) {
+        return {
+            path: `https://${nodeId}.${this.baseDomain}/${podName}/`
+        };
+    }
+    /**
+     * 验证 node-id 格式
+     * 允许: 字母、数字、连字符
+     * 不允许: 空、点、特殊字符
+     */
+    isValidNodeId(nodeId) {
+        if (!nodeId || nodeId.length === 0 || nodeId.length > 63) {
+            return false;
+        }
+        // DNS 标签规则: 字母数字连字符，不能以连字符开头或结尾
+        return /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(nodeId);
+    }
+    /**
+     * 验证 pod 名称格式
+     * 允许: 字母、数字、连字符、下划线
+     */
+    isValidPodName(podName) {
+        if (!podName || podName.length === 0 || podName.length > 64) {
+            return false;
+        }
+        // 不允许以点开头或包含斜杠
+        return /^[a-zA-Z0-9_-]+$/.test(podName);
+    }
+}
+exports.SubdomainPodIdentifierStrategy = SubdomainPodIdentifierStrategy;
+//# sourceMappingURL=SubdomainPodIdentifierStrategy.js.map

package/dist/util/identifiers/SubdomainPodIdentifierStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubdomainPodIdentifierStrategy.js","sourceRoot":"","sources":["../../../src/util/identifiers/SubdomainPodIdentifierStrategy.ts"],"names":[],"mappings":";;;AAAA,uCAA+B;AAC/B,iEAAqD;AACrD,8DAAiE;AAEjE,yEAAiF;AAOjF;;;;;;;;;;;;GAYG;AACH,MAAa,8BAA+B,SAAQ,yCAAsB;IAIxE,YAAmB,OAA8C;QAC/D,KAAK,EAAE,CAAC;QAJO,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAK3C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACa,kBAAkB,CAAC,UAA8B;QAC/D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,cAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAE/C,oBAAoB;YACpB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;gBAC9C,OAAO,KAAK,CAAC;YACf,CAAC;YAED,aAAa;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;gBAC7D,OAAO,KAAK,CAAC;YACf,CAAC;YAED,6BAA6B;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,UAAU,CAAC,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/F,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACa,eAAe,CAAC,UAA8B;QAC5D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,cAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAA,8BAAmB,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAEtD,mBAAmB;YACnB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,QAAgB;QACnC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,MAAM,IAAI,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,cAAc,CAAC,UAA8B;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,cAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,sBAAsB,CAAC,QAAgB;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,oBAAoB,CAAC,OAAe,EAAE,MAAc;QACzD,OAAO;YACL,IAAI,EAAE,WAAW,MAAM,IAAI,IAAI,CAAC,UAAU,IAAI,OAAO,GAAG;SACzD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,aAAa,CAAC,MAAc;QAClC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,gCAAgC;QAChC,OAAO,0CAA0C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,OAAe;QACpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,eAAe;QACf,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF;AA5ID,wEA4IC","sourcesContent":["import { URL } from 'node:url';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { BaseIdentifierStrategy } from '@solid/community-server';\nimport type { ResourceIdentifier } from '@solid/community-server';\nimport { ensureTrailingSlash } from '@solid/community-server/dist/util/PathUtil';\n\nexport interface SubdomainPodIdentifierStrategyOptions {\n  /** 基础域名，如 pods.undefineds.site */\n  baseDomain: string;\n}\n\n/**\n * Subdomain Pod Identifier Strategy\n *\n * 支持格式: {node-id}.baseDomain/{pod-name}/resource\n *\n * 示例:\n * - https://node1.pods.undefineds.site/alice/data.ttl\n * - https://node1.pods.undefineds.site/bob/profile/card\n *\n * 路径结构:\n * - /{pod-name}/ 表示一个 Pod 的根容器\n * - /{pod-name}/resource 表示 Pod 内的资源\n */\nexport class SubdomainPodIdentifierStrategy extends BaseIdentifierStrategy {\n  private readonly logger = getLoggerFor(this);\n  private readonly baseDomain: string;\n\n  public constructor(options: SubdomainPodIdentifierStrategyOptions) {\n    super();\n    if (!options.baseDomain) {\n      throw new Error('SubdomainPodIdentifierStrategy requires a baseDomain.');\n    }\n    this.baseDomain = options.baseDomain.toLowerCase();\n    this.logger.info(`Initialized with baseDomain: ${this.baseDomain}`);\n  }\n\n  /**\n   * 检查 identifier 是否被支持\n   *\n   * 条件:\n   * 1. hostname 必须匹配 *.baseDomain\n   * 2. 路径必须以 /{pod-name}/ 开头\n   */\n  public override supportsIdentifier(identifier: ResourceIdentifier): boolean {\n    try {\n      const target = new URL(identifier.path);\n      const hostname = target.hostname.toLowerCase();\n\n      // 必须匹配 *.baseDomain\n      if (!hostname.endsWith(`.${this.baseDomain}`)) {\n        return false;\n      }\n\n      // 提取 node-id\n      const nodeId = this.extractNodeId(hostname);\n      if (!nodeId || !this.isValidNodeId(nodeId)) {\n        this.logger.debug(`Invalid nodeId in hostname: ${hostname}`);\n        return false;\n      }\n\n      // 路径必须包含 pod 名称 (至少 /{pod}/)\n      const podName = this.extractPodNameFromPath(target.pathname);\n      if (!podName || !this.isValidPodName(podName)) {\n        this.logger.debug(`Invalid podName in path: ${target.pathname}`);\n        return false;\n      }\n\n      return true;\n    } catch (error: unknown) {\n      this.logger.warn(`Failed to parse identifier ${identifier.path}: ${(error as Error).message}`);\n      return false;\n    }\n  }\n\n  /**\n   * 检查是否是根容器\n   *\n   * 根容器是 /{pod-name}/\n   */\n  public override isRootContainer(identifier: ResourceIdentifier): boolean {\n    try {\n      const target = new URL(identifier.path);\n      const pathname = ensureTrailingSlash(target.pathname);\n\n      // 根容器路径应该是 /{pod}/\n      const segments = pathname.split('/').filter(Boolean);\n      return segments.length === 1;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * 从 hostname 提取 node-id\n   * node1.pods.undefineds.site -> node1\n   */\n  public extractNodeId(hostname: string): string | undefined {\n    const suffix = `.${this.baseDomain}`;\n    const lowerHostname = hostname.toLowerCase();\n\n    if (!lowerHostname.endsWith(suffix)) {\n      return undefined;\n    }\n\n    const nodeId = lowerHostname.slice(0, -suffix.length);\n    return nodeId || undefined;\n  }\n\n  /**\n   * 从 identifier 提取 Pod 名称\n   */\n  public extractPodName(identifier: ResourceIdentifier): string | undefined {\n    try {\n      const target = new URL(identifier.path);\n      return this.extractPodNameFromPath(target.pathname);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * 从路径提取 Pod 名称\n   * /alice/data.ttl -> alice\n   * / -> undefined\n   */\n  private extractPodNameFromPath(pathname: string): string | undefined {\n    const segments = pathname.split('/').filter(Boolean);\n    return segments[0];\n  }\n\n  /**\n   * 获取 Pod 的根容器 identifier\n   */\n  public getPodRootIdentifier(podName: string, nodeId: string): ResourceIdentifier {\n    return {\n      path: `https://${nodeId}.${this.baseDomain}/${podName}/`\n    };\n  }\n\n  /**\n   * 验证 node-id 格式\n   * 允许: 字母、数字、连字符\n   * 不允许: 空、点、特殊字符\n   */\n  private isValidNodeId(nodeId: string): boolean {\n    if (!nodeId || nodeId.length === 0 || nodeId.length > 63) {\n      return false;\n    }\n    // DNS 标签规则: 字母数字连字符，不能以连字符开头或结尾\n    return /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(nodeId);\n  }\n\n  /**\n   * 验证 pod 名称格式\n   * 允许: 字母、数字、连字符、下划线\n   */\n  private isValidPodName(podName: string): boolean {\n    if (!podName || podName.length === 0 || podName.length > 64) {\n      return false;\n    }\n    // 不允许以点开头或包含斜杠\n    return /^[a-zA-Z0-9_-]+$/.test(podName);\n  }\n}\n"]}

package/dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld

@@ -0,0 +1,84 @@
+{
+  "@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/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy",
+      "@type": "Class",
+      "requireElement": "SubdomainPodIdentifierStrategy",
+      "extends": [
+        "css:dist/util/identifiers/BaseIdentifierStrategy.jsonld#BaseIdentifierStrategy"
+      ],
+      "comment": "Subdomain Pod Identifier Strategy  支持格式: {node-id}.baseDomain/{pod-name}/resource  示例: - https://node1.pods.undefineds.site/alice/data.ttl - https://node1.pods.undefineds.site/bob/profile/card  路径结构: - /{pod-name}/ 表示一个 Pod 的根容器 - /{pod-name}/resource 表示 Pod 内的资源",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy_options_baseDomain",
+          "range": "xsd:string",
+          "comment": "基础域名，如 pods.undefineds.site"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_baseDomain",
+          "memberFieldName": "baseDomain"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_supportsIdentifier",
+          "memberFieldName": "supportsIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_isRootContainer",
+          "memberFieldName": "isRootContainer"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_extractNodeId",
+          "memberFieldName": "extractNodeId"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_extractPodName",
+          "memberFieldName": "extractPodName"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_extractPodNameFromPath",
+          "memberFieldName": "extractPodNameFromPath"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_getPodRootIdentifier",
+          "memberFieldName": "getPodRootIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_isValidNodeId",
+          "memberFieldName": "isValidNodeId"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy__member_isValidPodName",
+          "memberFieldName": "isValidPodName"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "baseDomain",
+              "value": {
+                "@id": "undefineds:dist/util/identifiers/SubdomainPodIdentifierStrategy.jsonld#SubdomainPodIdentifierStrategy_options_baseDomain"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/util/locking/DebugRedisLocker.d.ts

@@ -0,0 +1,8 @@
+import { RedisLocker, ResourceIdentifier } from "@solid/community-server";
+export declare class DebugRedisLocker extends RedisLocker {
+    protected logger: import("global-logger-factory").Logger<unknown>;
+    withWriteLock<T>(identifier: ResourceIdentifier, callback: () => Promise<T>): Promise<T>;
+    withReadLock<T>(identifier: ResourceIdentifier, callback: () => Promise<T>): Promise<T>;
+    acquire(identifier: ResourceIdentifier): Promise<void>;
+    release(identifier: ResourceIdentifier): Promise<void>;
+}

package/dist/util/locking/DebugRedisLocker.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugRedisLocker = void 0;
+const community_server_1 = require("@solid/community-server");
+const global_logger_factory_1 = require("global-logger-factory");
+class DebugRedisLocker extends community_server_1.RedisLocker {
+    constructor() {
+        super(...arguments);
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+    }
+    async withWriteLock(identifier, callback) {
+        this.logger.debug(`trying withWriteLock[${identifier.path}]`);
+        const result = await super.withWriteLock(identifier, callback);
+        this.logger.debug(`releasing withWriteLock[${identifier.path}]`);
+        return result;
+    }
+    async withReadLock(identifier, callback) {
+        this.logger.debug(`trying withReadLock[${identifier.path}]`);
+        const result = await super.withReadLock(identifier, callback);
+        this.logger.debug(`releasing withReadLock[${identifier.path}]`);
+        return result;
+    }
+    async acquire(identifier) {
+        this.logger.debug(`trying withLock[${identifier.path}]`);
+        return await super.acquire(identifier);
+    }
+    async release(identifier) {
+        this.logger.debug(`releasing withLock[${identifier.path}]`);
+        return await super.release(identifier);
+    }
+}
+exports.DebugRedisLocker = DebugRedisLocker;
+//# sourceMappingURL=DebugRedisLocker.js.map

package/dist/util/locking/DebugRedisLocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugRedisLocker.js","sourceRoot":"","sources":["../../../src/util/locking/DebugRedisLocker.ts"],"names":[],"mappings":";;;AAAA,8DAGiC;AACjC,iEAAqD;AAErD,MAAa,gBAAiB,SAAQ,8BAAW;IAAjD;;QACqB,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;IA+BjD,CAAC;IA7BU,KAAK,CAAC,aAAa,CAC1B,UAA8B,EAC9B,QAA0B;QAE1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,KAAK,CAAC,YAAY,CACzB,UAA8B,EAC9B,QAA0B;QAE1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEQ,KAAK,CAAC,OAAO,CAAC,UAA8B;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QACzD,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAEQ,KAAK,CAAC,OAAO,CAAC,UAA8B;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5D,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;CACF;AAhCD,4CAgCC","sourcesContent":["import {\n  RedisLocker,\n  ResourceIdentifier,\n} from \"@solid/community-server\";\nimport { getLoggerFor } from 'global-logger-factory';\n\nexport class DebugRedisLocker extends RedisLocker {\n  protected override logger = getLoggerFor(this);\n\n  override async withWriteLock<T>(\n    identifier: ResourceIdentifier,\n    callback: () => Promise<T>,\n  ): Promise<T> {\n    this.logger.debug(`trying withWriteLock[${identifier.path}]`);\n    const result = await super.withWriteLock(identifier, callback);\n    this.logger.debug(`releasing withWriteLock[${identifier.path}]`);\n    return result;\n  }\n\n  override async withReadLock<T>(\n    identifier: ResourceIdentifier,\n    callback: () => Promise<T>,\n  ): Promise<T> {\n    this.logger.debug(`trying withReadLock[${identifier.path}]`);\n    const result = await super.withReadLock(identifier, callback);\n    this.logger.debug(`releasing withReadLock[${identifier.path}]`);\n    return result;\n  }\n\n  override async acquire(identifier: ResourceIdentifier): Promise<void> {\n    this.logger.debug(`trying withLock[${identifier.path}]`);\n    return await super.acquire(identifier);\n  }\n\n  override async release(identifier: ResourceIdentifier): Promise<void> {\n    this.logger.debug(`releasing withLock[${identifier.path}]`);\n    return await super.release(identifier);\n  }\n}\n"]}

package/dist/util/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Simple logger with configurable prefix.
+ * Used by xpod main process and subprocesses.
+ */
+export declare function setLogPrefix(prefix: string): void;
+export declare function getLogPrefix(): string;
+export declare const logger: {
+    log(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+};

package/dist/util/logger.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Simple logger with configurable prefix.
+ * Used by xpod main process and subprocesses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setLogPrefix = setLogPrefix;
+exports.getLogPrefix = getLogPrefix;
+let globalPrefix = '[xpod]';
+function setLogPrefix(prefix) {
+    globalPrefix = prefix;
+}
+function getLogPrefix() {
+    return globalPrefix;
+}
+exports.logger = {
+    log(...args) {
+        console.log(globalPrefix, ...args);
+    },
+    info(...args) {
+        console.log(globalPrefix, ...args);
+    },
+    warn(...args) {
+        console.warn(globalPrefix, ...args);
+    },
+    error(...args) {
+        console.error(globalPrefix, ...args);
+    },
+    debug(...args) {
+        if (process.env.DEBUG) {
+            console.log(globalPrefix, '[DEBUG]', ...args);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,oCAEC;AAED,oCAEC;AARD,IAAI,YAAY,GAAG,QAAQ,CAAC;AAE5B,SAAgB,YAAY,CAAC,MAAc;IACzC,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,SAAgB,YAAY;IAC1B,OAAO,YAAY,CAAC;AACtB,CAAC;AAEY,QAAA,MAAM,GAAG;IACpB,GAAG,CAAC,GAAG,IAAe;QACpB,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["/**\n * Simple logger with configurable prefix.\n * Used by xpod main process and subprocesses.\n */\n\nlet globalPrefix = '[xpod]';\n\nexport function setLogPrefix(prefix: string): void {\n  globalPrefix = prefix;\n}\n\nexport function getLogPrefix(): string {\n  return globalPrefix;\n}\n\nexport const logger = {\n  log(...args: unknown[]): void {\n    console.log(globalPrefix, ...args);\n  },\n  info(...args: unknown[]): void {\n    console.log(globalPrefix, ...args);\n  },\n  warn(...args: unknown[]): void {\n    console.warn(globalPrefix, ...args);\n  },\n  error(...args: unknown[]): void {\n    console.error(globalPrefix, ...args);\n  },\n  debug(...args: unknown[]): void {\n    if (process.env.DEBUG) {\n      console.log(globalPrefix, '[DEBUG]', ...args);\n    }\n  },\n};\n"]}

package/dist/util/stream/BandwidthThrottleTransform.d.ts

@@ -0,0 +1,8 @@
+import { Transform } from 'stream';
+export interface BandwidthThrottleTransformOptions {
+    bytesPerSecond: number;
+    objectMode?: boolean;
+    measure?: (chunk: unknown, encoding: BufferEncoding) => number;
+}
+export type BandwidthThrottleTransform = Transform;
+export declare function createBandwidthThrottleTransform(options: BandwidthThrottleTransformOptions): Transform;

package/dist/util/stream/BandwidthThrottleTransform.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBandwidthThrottleTransform = createBandwidthThrottleTransform;
+const stream_1 = require("stream");
+function createBandwidthThrottleTransform(options) {
+    const bytesPerSecond = options.bytesPerSecond;
+    const measure = options.measure ?? defaultMeasure;
+    let nextAvailableTime = Date.now();
+    return new stream_1.Transform({
+        objectMode: options.objectMode ?? false,
+        readableObjectMode: options.objectMode ?? false,
+        writableObjectMode: options.objectMode ?? false,
+        transform(chunk, encoding, callback) {
+            if (bytesPerSecond <= 0) {
+                callback(null, chunk);
+                return;
+            }
+            const size = safeMeasure(chunk, encoding, measure);
+            if (size <= 0) {
+                callback(null, chunk);
+                return;
+            }
+            const now = Date.now();
+            if (nextAvailableTime < now) {
+                nextAvailableTime = now;
+            }
+            const durationMs = (size / bytesPerSecond) * 1000;
+            const delay = Math.max(0, nextAvailableTime - now);
+            nextAvailableTime += durationMs;
+            if (delay <= 0) {
+                callback(null, chunk);
+                return;
+            }
+            setTimeout(() => callback(null, chunk), delay);
+        },
+    });
+}
+function safeMeasure(chunk, encoding, measure) {
+    try {
+        return measure(chunk, encoding) ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function defaultMeasure(chunk, encoding) {
+    if (chunk instanceof Buffer) {
+        return chunk.length;
+    }
+    if (typeof chunk === 'string') {
+        return Buffer.byteLength(chunk, encoding);
+    }
+    return 0;
+}
+//# sourceMappingURL=BandwidthThrottleTransform.js.map

package/dist/util/stream/BandwidthThrottleTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BandwidthThrottleTransform.js","sourceRoot":"","sources":["../../../src/util/stream/BandwidthThrottleTransform.ts"],"names":[],"mappings":";;AAUA,4EAsCC;AAhDD,mCAAmC;AAUnC,SAAgB,gCAAgC,CAAC,OAA0C;IACzF,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAClD,IAAI,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEnC,OAAO,IAAI,kBAAS,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QACvC,kBAAkB,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QAC/C,kBAAkB,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QAC/C,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ;YACjC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;gBACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACd,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,iBAAiB,GAAG,GAAG,EAAE,CAAC;gBAC5B,iBAAiB,GAAG,GAAG,CAAC;YAC1B,CAAC;YAED,MAAM,UAAU,GAAG,CAAC,IAAI,GAAG,cAAc,CAAC,GAAG,IAAI,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,GAAG,CAAC,CAAC;YACnD,iBAAiB,IAAI,UAAU,CAAC;YAEhC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAClB,KAAc,EACd,QAAwB,EACxB,OAA6D;IAE7D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,QAAwB;IAC9D,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC","sourcesContent":["import { Transform } from 'stream';\n\nexport interface BandwidthThrottleTransformOptions {\n  bytesPerSecond: number;\n  objectMode?: boolean;\n  measure?: (chunk: unknown, encoding: BufferEncoding) => number;\n}\n\nexport type BandwidthThrottleTransform = Transform;\n\nexport function createBandwidthThrottleTransform(options: BandwidthThrottleTransformOptions): Transform {\n  const bytesPerSecond = options.bytesPerSecond;\n  const measure = options.measure ?? defaultMeasure;\n  let nextAvailableTime = Date.now();\n\n  return new Transform({\n    objectMode: options.objectMode ?? false,\n    readableObjectMode: options.objectMode ?? false,\n    writableObjectMode: options.objectMode ?? false,\n    transform(chunk, encoding, callback) {\n      if (bytesPerSecond <= 0) {\n        callback(null, chunk);\n        return;\n      }\n\n      const size = safeMeasure(chunk, encoding, measure);\n      if (size <= 0) {\n        callback(null, chunk);\n        return;\n      }\n\n      const now = Date.now();\n      if (nextAvailableTime < now) {\n        nextAvailableTime = now;\n      }\n\n      const durationMs = (size / bytesPerSecond) * 1000;\n      const delay = Math.max(0, nextAvailableTime - now);\n      nextAvailableTime += durationMs;\n\n      if (delay <= 0) {\n        callback(null, chunk);\n        return;\n      }\n\n      setTimeout(() => callback(null, chunk), delay);\n    },\n  });\n}\n\nfunction safeMeasure(\n  chunk: unknown,\n  encoding: BufferEncoding,\n  measure: (chunk: unknown, encoding: BufferEncoding) => number,\n): number {\n  try {\n    return measure(chunk, encoding) ?? 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction defaultMeasure(chunk: unknown, encoding: BufferEncoding): number {\n  if (chunk instanceof Buffer) {\n    return chunk.length;\n  }\n  if (typeof chunk === 'string') {\n    return Buffer.byteLength(chunk, encoding);\n  }\n  return 0;\n}\n"]}

package/dist/vocab/external.d.ts

@@ -0,0 +1,216 @@
+/**
+ * External Vocabularies - 外部标准词汇表
+ *
+ * 常用的 RDF 标准词汇表，避免重复定义。
+ */
+type NamespaceObject<T extends Record<string, string>> = ((term: string) => string) & {
+    prefix: string;
+    uri: string;
+} & {
+    [K in keyof T]: string;
+};
+/**
+ * Dublin Core Terms
+ * @see https://www.dublincore.org/specifications/dublin-core/dcmi-terms/
+ */
+export declare const DCTerms: NamespaceObject<{
+    title: string;
+    description: string;
+    creator: string;
+    created: string;
+    modified: string;
+    date: string;
+    type: string;
+    format: string;
+    identifier: string;
+    language: string;
+    subject: string;
+}>;
+/**
+ * Linked Data Platform
+ * @see https://www.w3.org/ns/ldp
+ */
+export declare const LDP: NamespaceObject<{
+    Resource: string;
+    Container: string;
+    BasicContainer: string;
+    DirectContainer: string;
+    IndirectContainer: string;
+    NonRDFSource: string;
+    RDFSource: string;
+    contains: string;
+    member: string;
+    membershipResource: string;
+    hasMemberRelation: string;
+    isMemberOfRelation: string;
+    insertedContentRelation: string;
+}>;
+/**
+ * Schema.org vocabulary (常用子集)
+ * @see https://schema.org/
+ */
+export declare const Schema: NamespaceObject<{
+    Person: string;
+    Organization: string;
+    Thing: string;
+    CreativeWork: string;
+    Article: string;
+    WebPage: string;
+    SoftwareApplication: string;
+    name: string;
+    description: string;
+    url: string;
+    image: string;
+    email: string;
+    dateCreated: string;
+    dateModified: string;
+    author: string;
+    creator: string;
+}>;
+/**
+ * RDF vocabulary
+ * @see https://www.w3.org/1999/02/22-rdf-syntax-ns
+ */
+export declare const RDF: NamespaceObject<{
+    type: string;
+    Property: string;
+    Statement: string;
+    subject: string;
+    predicate: string;
+    object: string;
+    first: string;
+    rest: string;
+    nil: string;
+}>;
+/**
+ * RDFS vocabulary
+ * @see https://www.w3.org/2000/01/rdf-schema
+ */
+export declare const RDFS: NamespaceObject<{
+    Class: string;
+    Resource: string;
+    Literal: string;
+    label: string;
+    comment: string;
+    subClassOf: string;
+    subPropertyOf: string;
+    domain: string;
+    range: string;
+    seeAlso: string;
+    isDefinedBy: string;
+}>;
+/**
+ * XSD datatypes
+ * @see https://www.w3.org/2001/XMLSchema
+ */
+export declare const XSD: NamespaceObject<{
+    string: string;
+    boolean: string;
+    integer: string;
+    decimal: string;
+    float: string;
+    double: string;
+    date: string;
+    time: string;
+    dateTime: string;
+    duration: string;
+    anyURI: string;
+}>;
+/**
+ * FOAF vocabulary
+ * @see http://xmlns.com/foaf/0.1/
+ */
+export declare const FOAF: NamespaceObject<{
+    Person: string;
+    Agent: string;
+    Organization: string;
+    Document: string;
+    Image: string;
+    name: string;
+    nick: string;
+    mbox: string;
+    homepage: string;
+    knows: string;
+    maker: string;
+    primaryTopic: string;
+    isPrimaryTopicOf: string;
+}>;
+/**
+ * ACL vocabulary
+ * @see http://www.w3.org/ns/auth/acl
+ */
+export declare const ACL: NamespaceObject<{
+    Authorization: string;
+    Access: string;
+    Read: string;
+    Write: string;
+    Append: string;
+    Control: string;
+    accessTo: string;
+    default: string;
+    agent: string;
+    agentClass: string;
+    agentGroup: string;
+    mode: string;
+    origin: string;
+}>;
+/**
+ * Solid vocabulary
+ * @see http://www.w3.org/ns/solid/terms
+ */
+export declare const Solid: NamespaceObject<{
+    TypeIndex: string;
+    ListedDocument: string;
+    UnlistedDocument: string;
+    Notification: string;
+    oidcIssuer: string;
+    account: string;
+    privateTypeIndex: string;
+    publicTypeIndex: string;
+    storageQuota: string;
+    storageUsage: string;
+    forClass: string;
+    instance: string;
+    instanceContainer: string;
+}>;
+/**
+ * SIOC vocabulary (for chat threads/content)
+ * @see http://rdfs.org/sioc/ns#
+ */
+export declare const SIOC: NamespaceObject<{
+    Thread: string;
+    Post: string;
+    Forum: string;
+    Container: string;
+    Item: string;
+    UserAccount: string;
+    content: string;
+    has_reply: string;
+    reply_of: string;
+    has_container: string;
+    container_of: string;
+    has_creator: string;
+    has_parent: string;
+    has_space: string;
+    num_replies: string;
+}>;
+/**
+ * Meeting vocabulary (SolidOS chat)
+ * @see http://www.w3.org/ns/pim/meeting#
+ */
+export declare const Meeting: NamespaceObject<{
+    LongChat: string;
+    ShortChat: string;
+    Meeting: string;
+    Message: string;
+    sharedNotes: string;
+}>;
+/**
+ * Workflow vocabulary (used for chat message linking)
+ * @see http://www.w3.org/2005/01/wf/flow#
+ */
+export declare const WF: NamespaceObject<{
+    message: string;
+    participant: string;
+}>;
+export {};