@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld

@@ -0,0 +1,90 @@
+{
+  "@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/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy",
+      "@type": "Class",
+      "requireElement": "MultiDomainIdentifierStrategy",
+      "extends": [
+        "css:dist/util/identifiers/SingleRootIdentifierStrategy.jsonld#SingleRootIdentifierStrategy"
+      ],
+      "comment": "MultiDomainIdentifierStrategy - 支持多个域名的 IdentifierStrategy  特性： 1. 支持多个 baseUrl（如 id.undefineds.co 和 pods.undefineds.co） 2. 存储使用完整 URI（各域名数据独立存储） 3. 适用于 Cloud 模式同时处理 WebID 和 Pod 数据",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy_primaryBaseUrl",
+          "range": "xsd:string",
+          "comment": "主要 baseUrl（用于生成新资源路径）"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy_additionalBaseUrls",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeArray",
+                "parameterRangeValue": "xsd:string"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "额外支持的 baseUrl 列表"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_primaryBaseUrl",
+          "memberFieldName": "primaryBaseUrl"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_additionalBaseUrls",
+          "memberFieldName": "additionalBaseUrls"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_supportsIdentifier",
+          "memberFieldName": "supportsIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_getStoragePath",
+          "memberFieldName": "getStoragePath"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_getCanonicalUrl",
+          "memberFieldName": "getCanonicalUrl"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_getPrimaryBaseUrl",
+          "memberFieldName": "getPrimaryBaseUrl"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy__member_getAllBaseUrls",
+          "memberFieldName": "getAllBaseUrls"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy_primaryBaseUrl"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/MultiDomainIdentifierStrategy.jsonld#MultiDomainIdentifierStrategy_additionalBaseUrls"
+        }
+      ]
+    }
+  ]
+}

package/dist/util/identifiers/PathBasedPodIdentifierStrategy.d.ts

@@ -0,0 +1,78 @@
+import { BaseIdentifierStrategy } from '@solid/community-server';
+import type { ResourceIdentifier } from '@solid/community-server';
+export interface PathBasedPodIdentifierStrategyOptions {
+    /** 基础 URL，如 https://pods.undefineds.co */
+    baseUrl: string;
+}
+/**
+ * Path-based Pod Identifier Strategy
+ *
+ * 支持格式: baseDomain/{pod-name}/resource
+ *
+ * 示例:
+ * - https://pods.undefineds.co/alice/data.ttl
+ * - https://pods.undefineds.co/bob/profile/card
+ *
+ * 路径结构:
+ * - /{pod-name}/ 表示一个 Pod 的根容器
+ * - /{pod-name}/resource 表示 Pod 内的资源
+ *
+ * 适用于单域名多 Pod 场景（没有子域名前缀）
+ */
+export declare class PathBasedPodIdentifierStrategy extends BaseIdentifierStrategy {
+    private readonly logger;
+    private readonly baseUrl;
+    private readonly baseDomain;
+    constructor(options: PathBasedPodIdentifierStrategyOptions);
+    /**
+     * 系统路径 - 不需要遵循 pod 路径格式
+     */
+    private readonly systemPaths;
+    /**
+     * 检查 identifier 是否被支持
+     *
+     * 条件:
+     * 1. hostname 必须匹配 baseDomain（完全匹配）
+     * 2. 路径必须以 /{pod-name}/ 开头，或者是系统路径
+     */
+    supportsIdentifier(identifier: ResourceIdentifier): boolean;
+    /**
+     * 检查路径是否是系统路径
+     * 根路径 "/" 也作为系统路径处理（用于服务根目录访问）
+     */
+    private isSystemPath;
+    /**
+     * 检查是否是根容器
+     *
+     * 只有服务根路径 "/" 是真正的根容器
+     * Pod 根路径 "/{pod-name}/" 不是 CSS 意义上的根容器，它们有父容器 "/"
+     */
+    isRootContainer(identifier: ResourceIdentifier): boolean;
+    /**
+     * 从 identifier 提取 Pod 名称
+     */
+    extractPodName(identifier: ResourceIdentifier): string | undefined;
+    /**
+     * 从路径提取 Pod 名称
+     * /alice/data.ttl -> alice
+     * / -> undefined
+     */
+    private extractPodNameFromPath;
+    /**
+     * 获取 Pod 的根容器 identifier
+     */
+    getPodRootIdentifier(podName: string): ResourceIdentifier;
+    /**
+     * 验证 pod 名称格式
+     * 允许: 字母、数字、连字符、下划线
+     */
+    private isValidPodName;
+    /**
+     * 获取父容器
+     * 覆盖基类方法以支持 Pod 路径结构
+     * - /alice/data.ttl -> /alice/
+     * - /alice/ -> / (服务根)
+     * - / -> 报错 (服务根没有父容器)
+     */
+    getParentContainer(identifier: ResourceIdentifier): ResourceIdentifier;
+}

package/dist/util/identifiers/PathBasedPodIdentifierStrategy.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathBasedPodIdentifierStrategy = 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");
+/**
+ * Path-based Pod Identifier Strategy
+ *
+ * 支持格式: baseDomain/{pod-name}/resource
+ *
+ * 示例:
+ * - https://pods.undefineds.co/alice/data.ttl
+ * - https://pods.undefineds.co/bob/profile/card
+ *
+ * 路径结构:
+ * - /{pod-name}/ 表示一个 Pod 的根容器
+ * - /{pod-name}/resource 表示 Pod 内的资源
+ *
+ * 适用于单域名多 Pod 场景（没有子域名前缀）
+ */
+class PathBasedPodIdentifierStrategy extends community_server_1.BaseIdentifierStrategy {
+    constructor(options) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        /**
+         * 系统路径 - 不需要遵循 pod 路径格式
+         */
+        this.systemPaths = [
+            '/.oidc/',
+            '/.well-known/',
+            '/idp/',
+            '/.notifications/',
+            '/storage-description/',
+        ];
+        if (!options.baseUrl) {
+            throw new Error('PathBasedPodIdentifierStrategy requires a baseUrl.');
+        }
+        this.baseUrl = (0, PathUtil_1.ensureTrailingSlash)(options.baseUrl.toLowerCase());
+        // 从 baseUrl 提取域名
+        const parsed = new node_url_1.URL(this.baseUrl);
+        this.baseDomain = parsed.hostname;
+        this.logger.info(`Initialized with baseUrl: ${this.baseUrl}, 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 !== this.baseDomain) {
+                return false;
+            }
+            // 检查是否是系统路径
+            const pathname = target.pathname;
+            if (this.isSystemPath(pathname)) {
+                return true;
+            }
+            // 路径必须包含 pod 名称 (至少 /{pod}/)
+            const podName = this.extractPodNameFromPath(pathname);
+            if (!podName || !this.isValidPodName(podName)) {
+                this.logger.debug(`Invalid podName in path: ${pathname}`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            this.logger.warn(`Failed to parse identifier ${identifier.path}: ${error.message}`);
+            return false;
+        }
+    }
+    /**
+     * 检查路径是否是系统路径
+     * 根路径 "/" 也作为系统路径处理（用于服务根目录访问）
+     */
+    isSystemPath(pathname) {
+        if (pathname === '/' || pathname === '') {
+            return true;
+        }
+        return this.systemPaths.some(prefix => pathname.startsWith(prefix));
+    }
+    /**
+     * 检查是否是根容器
+     *
+     * 只有服务根路径 "/" 是真正的根容器
+     * Pod 根路径 "/{pod-name}/" 不是 CSS 意义上的根容器，它们有父容器 "/"
+     */
+    isRootContainer(identifier) {
+        try {
+            const target = new node_url_1.URL(identifier.path);
+            const pathname = (0, PathUtil_1.ensureTrailingSlash)(target.pathname);
+            // 只有服务根路径 "/" 是根容器
+            const isRoot = pathname === '/';
+            this.logger.debug(`isRootContainer(${identifier.path}): pathname=${pathname}, isRoot=${isRoot}`);
+            return isRoot;
+        }
+        catch (error) {
+            this.logger.warn(`isRootContainer(${identifier.path}): error=${error}`);
+            return false;
+        }
+    }
+    /**
+     * 从 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) {
+        return {
+            path: `https://${this.baseDomain}/${podName}/`
+        };
+    }
+    /**
+     * 验证 pod 名称格式
+     * 允许: 字母、数字、连字符、下划线
+     */
+    isValidPodName(podName) {
+        if (!podName || podName.length === 0 || podName.length > 64) {
+            return false;
+        }
+        // 不允许以点开头或包含斜杠
+        return /^[a-zA-Z0-9_-]+$/.test(podName);
+    }
+    /**
+     * 获取父容器
+     * 覆盖基类方法以支持 Pod 路径结构
+     * - /alice/data.ttl -> /alice/
+     * - /alice/ -> / (服务根)
+     * - / -> 报错 (服务根没有父容器)
+     */
+    getParentContainer(identifier) {
+        this.logger.debug(`getParentContainer called for: ${identifier.path}`);
+        if (!this.supportsIdentifier(identifier)) {
+            this.logger.warn(`getParentContainer: ${identifier.path} is not supported`);
+            throw new community_server_1.InternalServerError(`The identifier ${identifier.path} is outside the configured identifier space.`);
+        }
+        const target = new node_url_1.URL(identifier.path);
+        const pathname = (0, PathUtil_1.ensureTrailingSlash)(target.pathname);
+        this.logger.debug(`getParentContainer: pathname=${pathname}, isRoot=${pathname === '/'}`);
+        // 服务根路径 "/" 没有父容器
+        if (pathname === '/') {
+            this.logger.warn(`getParentContainer: ${identifier.path} is root container, throwing error`);
+            throw new community_server_1.InternalServerError(`Cannot obtain the parent of ${identifier.path} because it is a root container.`);
+        }
+        // 提取父路径
+        const segments = pathname.split('/').filter(Boolean);
+        if (segments.length === 1) {
+            // Pod 根路径 /{pod}/ 的父是 /
+            return { path: `${target.protocol}//${target.host}/` };
+        }
+        // 其他路径，去掉最后一段
+        const parentPath = segments.slice(0, -1).join('/');
+        return { path: `${target.protocol}//${target.host}/${parentPath}/` };
+    }
+}
+exports.PathBasedPodIdentifierStrategy = PathBasedPodIdentifierStrategy;
+//# sourceMappingURL=PathBasedPodIdentifierStrategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PathBasedPodIdentifierStrategy.js","sourceRoot":"","sources":["../../../src/util/identifiers/PathBasedPodIdentifierStrategy.ts"],"names":[],"mappings":"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","sourcesContent":["import { URL } from 'node:url';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { BaseIdentifierStrategy, InternalServerError } from '@solid/community-server';\nimport type { ResourceIdentifier } from '@solid/community-server';\nimport { ensureTrailingSlash } from '@solid/community-server/dist/util/PathUtil';\n\nexport interface PathBasedPodIdentifierStrategyOptions {\n  /** 基础 URL，如 https://pods.undefineds.co */\n  baseUrl: string;\n}\n\n/**\n * Path-based Pod Identifier Strategy\n *\n * 支持格式: baseDomain/{pod-name}/resource\n *\n * 示例:\n * - https://pods.undefineds.co/alice/data.ttl\n * - https://pods.undefineds.co/bob/profile/card\n *\n * 路径结构:\n * - /{pod-name}/ 表示一个 Pod 的根容器\n * - /{pod-name}/resource 表示 Pod 内的资源\n *\n * 适用于单域名多 Pod 场景（没有子域名前缀）\n */\nexport class PathBasedPodIdentifierStrategy extends BaseIdentifierStrategy {\n  private readonly logger = getLoggerFor(this);\n  private readonly baseUrl: string;\n  private readonly baseDomain: string;\n\n  public constructor(options: PathBasedPodIdentifierStrategyOptions) {\n    super();\n    if (!options.baseUrl) {\n      throw new Error('PathBasedPodIdentifierStrategy requires a baseUrl.');\n    }\n    this.baseUrl = ensureTrailingSlash(options.baseUrl.toLowerCase());\n    // 从 baseUrl 提取域名\n    const parsed = new URL(this.baseUrl);\n    this.baseDomain = parsed.hostname;\n    this.logger.info(`Initialized with baseUrl: ${this.baseUrl}, baseDomain: ${this.baseDomain}`);\n  }\n\n  /**\n   * 系统路径 - 不需要遵循 pod 路径格式\n   */\n  private readonly systemPaths = [\n    '/.oidc/',\n    '/.well-known/',\n    '/idp/',\n    '/.notifications/',\n    '/storage-description/',\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 !== this.baseDomain) {\n        return false;\n      }\n\n      // 检查是否是系统路径\n      const pathname = target.pathname;\n      if (this.isSystemPath(pathname)) {\n        return true;\n      }\n\n      // 路径必须包含 pod 名称 (至少 /{pod}/)\n      const podName = this.extractPodNameFromPath(pathname);\n      if (!podName || !this.isValidPodName(podName)) {\n        this.logger.debug(`Invalid podName in path: ${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   */\n  private isSystemPath(pathname: string): boolean {\n    if (pathname === '/' || pathname === '') {\n      return true;\n    }\n    return this.systemPaths.some(prefix => pathname.startsWith(prefix));\n  }\n\n  /**\n   * 检查是否是根容器\n   *\n   * 只有服务根路径 \"/\" 是真正的根容器\n   * Pod 根路径 \"/{pod-name}/\" 不是 CSS 意义上的根容器，它们有父容器 \"/\"\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      // 只有服务根路径 \"/\" 是根容器\n      const isRoot = pathname === '/';\n      this.logger.debug(`isRootContainer(${identifier.path}): pathname=${pathname}, isRoot=${isRoot}`);\n      return isRoot;\n    } catch (error) {\n      this.logger.warn(`isRootContainer(${identifier.path}): error=${error}`);\n      return false;\n    }\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): ResourceIdentifier {\n    return {\n      path: `https://${this.baseDomain}/${podName}/`\n    };\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  /**\n   * 获取父容器\n   * 覆盖基类方法以支持 Pod 路径结构\n   * - /alice/data.ttl -> /alice/\n   * - /alice/ -> / (服务根)\n   * - / -> 报错 (服务根没有父容器)\n   */\n  public override getParentContainer(identifier: ResourceIdentifier): ResourceIdentifier {\n    this.logger.debug(`getParentContainer called for: ${identifier.path}`);\n\n    if (!this.supportsIdentifier(identifier)) {\n      this.logger.warn(`getParentContainer: ${identifier.path} is not supported`);\n      throw new InternalServerError(`The identifier ${identifier.path} is outside the configured identifier space.`);\n    }\n\n    const target = new URL(identifier.path);\n    const pathname = ensureTrailingSlash(target.pathname);\n\n    this.logger.debug(`getParentContainer: pathname=${pathname}, isRoot=${pathname === '/'}`);\n\n    // 服务根路径 \"/\" 没有父容器\n    if (pathname === '/') {\n      this.logger.warn(`getParentContainer: ${identifier.path} is root container, throwing error`);\n      throw new InternalServerError(`Cannot obtain the parent of ${identifier.path} because it is a root container.`);\n    }\n\n    // 提取父路径\n    const segments = pathname.split('/').filter(Boolean);\n\n    if (segments.length === 1) {\n      // Pod 根路径 /{pod}/ 的父是 /\n      return { path: `${target.protocol}//${target.host}/` };\n    }\n\n    // 其他路径，去掉最后一段\n    const parentPath = segments.slice(0, -1).join('/');\n    return { path: `${target.protocol}//${target.host}/${parentPath}/` };\n  }\n}\n"]}

package/dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld

@@ -0,0 +1,88 @@
+{
+  "@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/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy",
+      "@type": "Class",
+      "requireElement": "PathBasedPodIdentifierStrategy",
+      "extends": [
+        "css:dist/util/identifiers/BaseIdentifierStrategy.jsonld#BaseIdentifierStrategy"
+      ],
+      "comment": "Path-based Pod Identifier Strategy  支持格式: baseDomain/{pod-name}/resource  示例: - https://pods.undefineds.co/alice/data.ttl - https://pods.undefineds.co/bob/profile/card  路径结构: - /{pod-name}/ 表示一个 Pod 的根容器 - /{pod-name}/resource 表示 Pod 内的资源  适用于单域名多 Pod 场景（没有子域名前缀）",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy_options_baseUrl",
+          "range": "xsd:string",
+          "comment": "基础 URL，如 https://pods.undefineds.co"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_baseUrl",
+          "memberFieldName": "baseUrl"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_baseDomain",
+          "memberFieldName": "baseDomain"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_systemPaths",
+          "memberFieldName": "systemPaths"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_supportsIdentifier",
+          "memberFieldName": "supportsIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_isSystemPath",
+          "memberFieldName": "isSystemPath"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_isRootContainer",
+          "memberFieldName": "isRootContainer"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_extractPodName",
+          "memberFieldName": "extractPodName"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_extractPodNameFromPath",
+          "memberFieldName": "extractPodNameFromPath"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_getPodRootIdentifier",
+          "memberFieldName": "getPodRootIdentifier"
+        },
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy__member_isValidPodName",
+          "memberFieldName": "isValidPodName"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "baseUrl",
+              "value": {
+                "@id": "undefineds:dist/util/identifiers/PathBasedPodIdentifierStrategy.jsonld#PathBasedPodIdentifierStrategy_options_baseUrl"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/util/identifiers/SubdomainPodIdentifierStrategy.d.ts

@@ -0,0 +1,68 @@
+import { BaseIdentifierStrategy } from '@solid/community-server';
+import type { ResourceIdentifier } from '@solid/community-server';
+export interface SubdomainPodIdentifierStrategyOptions {
+    /** 基础域名，如 pods.undefineds.site */
+    baseDomain: string;
+}
+/**
+ * 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 内的资源
+ */
+export declare class SubdomainPodIdentifierStrategy extends BaseIdentifierStrategy {
+    private readonly logger;
+    private readonly baseDomain;
+    constructor(options: SubdomainPodIdentifierStrategyOptions);
+    /**
+     * 检查 identifier 是否被支持
+     *
+     * 条件:
+     * 1. hostname 必须匹配 *.baseDomain
+     * 2. 路径必须以 /{pod-name}/ 开头
+     */
+    supportsIdentifier(identifier: ResourceIdentifier): boolean;
+    /**
+     * 检查是否是根容器
+     *
+     * 根容器是 /{pod-name}/
+     */
+    isRootContainer(identifier: ResourceIdentifier): boolean;
+    /**
+     * 从 hostname 提取 node-id
+     * node1.pods.undefineds.site -> node1
+     */
+    extractNodeId(hostname: string): string | undefined;
+    /**
+     * 从 identifier 提取 Pod 名称
+     */
+    extractPodName(identifier: ResourceIdentifier): string | undefined;
+    /**
+     * 从路径提取 Pod 名称
+     * /alice/data.ttl -> alice
+     * / -> undefined
+     */
+    private extractPodNameFromPath;
+    /**
+     * 获取 Pod 的根容器 identifier
+     */
+    getPodRootIdentifier(podName: string, nodeId: string): ResourceIdentifier;
+    /**
+     * 验证 node-id 格式
+     * 允许: 字母、数字、连字符
+     * 不允许: 空、点、特殊字符
+     */
+    private isValidNodeId;
+    /**
+     * 验证 pod 名称格式
+     * 允许: 字母、数字、连字符、下划线
+     */
+    private isValidPodName;
+}