@undefineds.co/xpod 0.3.5 → 0.3.14

package/dist/solidfs/PodSolidFsHttpClient.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodSolidFsHttpClient = void 0;
+exports.resolvePodWorkspaceResourceUrl = resolvePodWorkspaceResourceUrl;
+exports.solidAuthFromContext = solidAuthFromContext;
+const AuthContext_1 = require("../api/auth/AuthContext");
+class PodSolidFsHttpClient {
+    constructor(options = {}) {
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.tokenEndpoint = options.tokenEndpoint ?? resolveDefaultTokenEndpoint();
+    }
+    async request(input, init) {
+        return this.fetchImpl(input, init);
+    }
+    async createAuthHeaders(context, operation) {
+        const auth = solidAuthFromContext(context);
+        if (!auth) {
+            throw new Error(`Cannot ${operation} without Solid auth context`);
+        }
+        const headers = new Headers();
+        if (auth.accessToken) {
+            headers.set('Authorization', `${auth.tokenType ?? 'Bearer'} ${auth.accessToken}`);
+            return headers;
+        }
+        const token = await this.exchangeClientCredentials(auth);
+        headers.set('Authorization', `${token.tokenType ?? 'Bearer'} ${token.accessToken}`);
+        return headers;
+    }
+    async exchangeClientCredentials(auth) {
+        if (!this.tokenEndpoint) {
+            throw new Error('Cannot access Pod HTTP resource with client credentials because CSS token endpoint is not configured');
+        }
+        if (!auth.clientId || !auth.clientSecret) {
+            throw new Error('Cannot access Pod HTTP resource without access token or Solid client credentials');
+        }
+        const response = await this.request(this.tokenEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: new URLSearchParams({
+                grant_type: 'client_credentials',
+                client_id: auth.clientId,
+                client_secret: auth.clientSecret,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`SolidFS token exchange failed: ${response.status} ${await response.text().catch(() => '')}`);
+        }
+        const token = await response.json();
+        if (!token.access_token) {
+            throw new Error(`SolidFS token exchange response missing access_token: ${JSON.stringify(token)}`);
+        }
+        return {
+            accessToken: token.access_token,
+            tokenType: token.token_type?.toUpperCase() === 'DPOP' ? 'DPoP' : 'Bearer',
+        };
+    }
+}
+exports.PodSolidFsHttpClient = PodSolidFsHttpClient;
+function resolvePodWorkspaceResourceUrl(relativePath, workspace) {
+    try {
+        const base = new URL(workspace.workspace.endsWith('/') ? workspace.workspace : `${workspace.workspace}/`);
+        if (base.protocol !== 'http:' && base.protocol !== 'https:') {
+            return undefined;
+        }
+        return new URL(normalizePodRelativePath(relativePath), base).href;
+    }
+    catch {
+        return undefined;
+    }
+}
+function solidAuthFromContext(context) {
+    const auth = context?.auth;
+    return auth && (0, AuthContext_1.isSolidAuth)(auth) ? auth : undefined;
+}
+function normalizePodRelativePath(input) {
+    const parts = input.split(/[\\/]+/u).filter((part) => part.length > 0);
+    if (input.startsWith('/') || parts.length === 0 || parts.includes('..')) {
+        throw new Error(`Invalid Pod resource relative path: ${input}`);
+    }
+    return parts.join('/');
+}
+function resolveDefaultTokenEndpoint() {
+    if (process.env.CSS_TOKEN_ENDPOINT) {
+        return process.env.CSS_TOKEN_ENDPOINT;
+    }
+    if (process.env.CSS_BASE_URL) {
+        return new URL('.oidc/token', process.env.CSS_BASE_URL.endsWith('/') ? process.env.CSS_BASE_URL : `${process.env.CSS_BASE_URL}/`).href;
+    }
+    return undefined;
+}
+//# sourceMappingURL=PodSolidFsHttpClient.js.map

package/dist/solidfs/PodSolidFsHttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodSolidFsHttpClient.js","sourceRoot":"","sources":["../../src/solidfs/PodSolidFsHttpClient.ts"],"names":[],"mappings":";;;AAwEA,wEAUC;AAED,oDAGC;AAtFD,yDAAsD;AAStD,MAAa,oBAAoB;IAI/B,YAAmB,UAAuC,EAAE;QAC1D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,2BAA2B,EAAE,CAAC;IAC9E,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,IAAiB;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,OAAgB,EAAE,SAAiB;QAChE,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,UAAU,SAAS,6BAA6B,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAClF,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACpF,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,IAAsB;QAC5D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;QAC1H,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,mCAAmC;aACpD;YACD,IAAI,EAAE,IAAI,eAAe,CAAC;gBACxB,UAAU,EAAE,oBAAoB;gBAChC,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,aAAa,EAAE,IAAI,CAAC,YAAY;aACjC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoD,CAAC;QACtF,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yDAAyD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,OAAO;YACL,WAAW,EAAE,KAAK,CAAC,YAAY;YAC/B,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SAC1E,CAAC;IACJ,CAAC;CACF;AA5DD,oDA4DC;AAED,SAAgB,8BAA8B,CAAC,YAAoB,EAAE,SAA0B;IAC7F,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1G,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,wBAAwB,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,MAAM,IAAI,GAAI,OAAoC,EAAE,IAA+B,CAAC;IACpF,OAAO,IAAI,IAAI,IAAA,yBAAW,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,2BAA2B;IAClC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC7B,OAAO,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACzI,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { AuthContext, SolidAuthContext } from '../api/auth/AuthContext';\nimport { isSolidAuth } from '../api/auth/AuthContext';\nimport type { StoreContext } from '../api/chatkit/store';\nimport type { SolidFsManifest } from './types';\n\nexport interface PodSolidFsHttpClientOptions {\n  fetch?: typeof fetch;\n  tokenEndpoint?: string;\n}\n\nexport class PodSolidFsHttpClient {\n  private readonly fetchImpl: typeof fetch;\n  private readonly tokenEndpoint?: string;\n\n  public constructor(options: PodSolidFsHttpClientOptions = {}) {\n    this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);\n    this.tokenEndpoint = options.tokenEndpoint ?? resolveDefaultTokenEndpoint();\n  }\n\n  public async request(input: string, init: RequestInit): Promise<Response> {\n    return this.fetchImpl(input, init);\n  }\n\n  public async createAuthHeaders(context: unknown, operation: string): Promise<Headers> {\n    const auth = solidAuthFromContext(context);\n    if (!auth) {\n      throw new Error(`Cannot ${operation} without Solid auth context`);\n    }\n\n    const headers = new Headers();\n    if (auth.accessToken) {\n      headers.set('Authorization', `${auth.tokenType ?? 'Bearer'} ${auth.accessToken}`);\n      return headers;\n    }\n\n    const token = await this.exchangeClientCredentials(auth);\n    headers.set('Authorization', `${token.tokenType ?? 'Bearer'} ${token.accessToken}`);\n    return headers;\n  }\n\n  private async exchangeClientCredentials(auth: SolidAuthContext): Promise<{ accessToken: string; tokenType?: 'Bearer' | 'DPoP' }> {\n    if (!this.tokenEndpoint) {\n      throw new Error('Cannot access Pod HTTP resource with client credentials because CSS token endpoint is not configured');\n    }\n    if (!auth.clientId || !auth.clientSecret) {\n      throw new Error('Cannot access Pod HTTP resource without access token or Solid client credentials');\n    }\n    const response = await this.request(this.tokenEndpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/x-www-form-urlencoded',\n      },\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n        client_id: auth.clientId,\n        client_secret: auth.clientSecret,\n      }),\n    });\n    if (!response.ok) {\n      throw new Error(`SolidFS token exchange failed: ${response.status} ${await response.text().catch(() => '')}`);\n    }\n    const token = await response.json() as { access_token?: string; token_type?: string };\n    if (!token.access_token) {\n      throw new Error(`SolidFS token exchange response missing access_token: ${JSON.stringify(token)}`);\n    }\n    return {\n      accessToken: token.access_token,\n      tokenType: token.token_type?.toUpperCase() === 'DPOP' ? 'DPoP' : 'Bearer',\n    };\n  }\n}\n\nexport function resolvePodWorkspaceResourceUrl(relativePath: string, workspace: SolidFsManifest): string | undefined {\n  try {\n    const base = new URL(workspace.workspace.endsWith('/') ? workspace.workspace : `${workspace.workspace}/`);\n    if (base.protocol !== 'http:' && base.protocol !== 'https:') {\n      return undefined;\n    }\n    return new URL(normalizePodRelativePath(relativePath), base).href;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function solidAuthFromContext(context: unknown): SolidAuthContext | undefined {\n  const auth = (context as StoreContext | undefined)?.auth as AuthContext | undefined;\n  return auth && isSolidAuth(auth) ? auth : undefined;\n}\n\nfunction normalizePodRelativePath(input: string): string {\n  const parts = input.split(/[\\\\/]+/u).filter((part) => part.length > 0);\n  if (input.startsWith('/') || parts.length === 0 || parts.includes('..')) {\n    throw new Error(`Invalid Pod resource relative path: ${input}`);\n  }\n  return parts.join('/');\n}\n\nfunction resolveDefaultTokenEndpoint(): string | undefined {\n  if (process.env.CSS_TOKEN_ENDPOINT) {\n    return process.env.CSS_TOKEN_ENDPOINT;\n  }\n  if (process.env.CSS_BASE_URL) {\n    return new URL('.oidc/token', process.env.CSS_BASE_URL.endsWith('/') ? process.env.CSS_BASE_URL : `${process.env.CSS_BASE_URL}/`).href;\n  }\n  return undefined;\n}\n"]}

package/dist/solidfs/PodSolidFsHydrator.d.ts

@@ -0,0 +1,27 @@
+import { type SolidFsCommitHydratedInput, type SolidFsHydrateInput, type SolidFsHydrator } from './types';
+export interface PodSolidFsHydratorOptions {
+    fetch?: typeof fetch;
+    tokenEndpoint?: string;
+}
+/**
+ * Hydrates object-backed Pod resources through the normal Pod HTTP boundary.
+ *
+ * The API runtime should not reach into CSS' storage container. GET/PUT/DELETE
+ * through CSS keeps authorization, object backends, and MixData/RDF indexing in
+ * one protocol path.
+ */
+export declare class PodSolidFsHydrator implements SolidFsHydrator {
+    private readonly http;
+    constructor(options?: PodSolidFsHydratorOptions);
+    hydrate(input: SolidFsHydrateInput): Promise<{
+        contentType?: string;
+        sourceVersion?: string;
+    }>;
+    commit(input: SolidFsCommitHydratedInput): Promise<{
+        sourceVersion?: string;
+    }>;
+    delete(input: SolidFsCommitHydratedInput): Promise<void>;
+    private resolveResourceUrl;
+    private resolveChangeResourceUrl;
+    private responseVersion;
+}

package/dist/solidfs/PodSolidFsHydrator.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodSolidFsHydrator = void 0;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const promises_2 = require("node:stream/promises");
+const types_1 = require("./types");
+const PodSolidFsHttpClient_1 = require("./PodSolidFsHttpClient");
+/**
+ * Hydrates object-backed Pod resources through the normal Pod HTTP boundary.
+ *
+ * The API runtime should not reach into CSS' storage container. GET/PUT/DELETE
+ * through CSS keeps authorization, object backends, and MixData/RDF indexing in
+ * one protocol path.
+ */
+class PodSolidFsHydrator {
+    constructor(options = {}) {
+        this.http = new PodSolidFsHttpClient_1.PodSolidFsHttpClient(options);
+    }
+    async hydrate(input) {
+        const resourceUrl = this.resolveResourceUrl(input.path, input.workspace);
+        const headers = await this.http.createAuthHeaders(input.context, `hydrate SolidFS object: ${resourceUrl}`);
+        const response = await this.http.request(resourceUrl, {
+            method: 'GET',
+            headers,
+        });
+        if (response.status === 404) {
+            throw new types_1.SolidFsNotFoundError(`SolidFS object not found: ${resourceUrl}`);
+        }
+        if (!response.ok) {
+            throw new Error(`SolidFS object hydrate failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);
+        }
+        if (!response.body) {
+            throw new Error(`SolidFS object hydrate failed for ${resourceUrl}: empty response body`);
+        }
+        await (0, promises_1.mkdir)(node_path_1.default.dirname(input.targetPath), { recursive: true });
+        await (0, promises_2.pipeline)(response.body, (0, node_fs_1.createWriteStream)(input.targetPath));
+        return {
+            contentType: response.headers.get('content-type') ?? undefined,
+            sourceVersion: this.responseVersion(response),
+        };
+    }
+    async commit(input) {
+        const resourceUrl = this.resolveChangeResourceUrl(input);
+        const headers = await this.http.createAuthHeaders(input.context, `commit SolidFS object: ${resourceUrl}`);
+        if (input.change.contentType) {
+            headers.set('Content-Type', input.change.contentType);
+        }
+        if (input.change.sourceVersion) {
+            headers.set('If-Match', input.change.sourceVersion);
+        }
+        const response = await this.http.request(resourceUrl, {
+            method: 'PUT',
+            headers,
+            body: (0, node_fs_1.createReadStream)(input.change.sourcePath),
+            duplex: 'half',
+        });
+        if (response.status === 409 || response.status === 412) {
+            throw new types_1.SolidFsConflictError([{
+                    path: input.change.path,
+                    sourcePath: input.change.sourcePath,
+                    expectedVersion: input.change.sourceVersion,
+                    actualVersion: this.responseVersion(response),
+                    message: `Object authority changed before SolidFS commit: ${resourceUrl}`,
+                }]);
+        }
+        if (!response.ok) {
+            throw new Error(`SolidFS object commit failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);
+        }
+        return {
+            sourceVersion: this.responseVersion(response),
+        };
+    }
+    async delete(input) {
+        const resourceUrl = this.resolveChangeResourceUrl(input);
+        const headers = await this.http.createAuthHeaders(input.context, `delete SolidFS object: ${resourceUrl}`);
+        if (input.change.sourceVersion) {
+            headers.set('If-Match', input.change.sourceVersion);
+        }
+        const response = await this.http.request(resourceUrl, {
+            method: 'DELETE',
+            headers,
+        });
+        if (response.status === 409 || response.status === 412) {
+            throw new types_1.SolidFsConflictError([{
+                    path: input.change.path,
+                    sourcePath: input.change.sourcePath,
+                    expectedVersion: input.change.sourceVersion,
+                    actualVersion: this.responseVersion(response),
+                    message: `Object authority changed before SolidFS delete: ${resourceUrl}`,
+                }]);
+        }
+        if (!response.ok && response.status !== 404) {
+            throw new Error(`SolidFS object delete failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);
+        }
+    }
+    resolveResourceUrl(relativePath, workspace) {
+        const resourceUrl = (0, PodSolidFsHttpClient_1.resolvePodWorkspaceResourceUrl)(relativePath, workspace);
+        if (!resourceUrl) {
+            throw new Error(`Cannot resolve SolidFS Pod resource URL for ${relativePath} in ${workspace.workspace}`);
+        }
+        return resourceUrl;
+    }
+    resolveChangeResourceUrl(input) {
+        if (input.change.resource) {
+            try {
+                const url = new URL(input.change.resource);
+                if (url.protocol === 'http:' || url.protocol === 'https:') {
+                    return url.href;
+                }
+            }
+            catch {
+                // Fall through to workspace-relative resolution.
+            }
+        }
+        return this.resolveResourceUrl(input.change.path, input.workspace);
+    }
+    responseVersion(response) {
+        return response.headers.get('etag') ?? response.headers.get('last-modified') ?? undefined;
+    }
+}
+exports.PodSolidFsHydrator = PodSolidFsHydrator;
+//# sourceMappingURL=PodSolidFsHydrator.js.map

package/dist/solidfs/PodSolidFsHydrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodSolidFsHydrator.js","sourceRoot":"","sources":["../../src/solidfs/PodSolidFsHydrator.ts"],"names":[],"mappings":"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","sourcesContent":["import { createReadStream, createWriteStream } from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport { pipeline } from 'node:stream/promises';\n\nimport { SolidFsConflictError, SolidFsNotFoundError, type SolidFsCommitHydratedInput, type SolidFsHydrateInput, type SolidFsHydrator } from './types';\nimport { PodSolidFsHttpClient, resolvePodWorkspaceResourceUrl } from './PodSolidFsHttpClient';\n\nexport interface PodSolidFsHydratorOptions {\n  fetch?: typeof fetch;\n  tokenEndpoint?: string;\n}\n\n/**\n * Hydrates object-backed Pod resources through the normal Pod HTTP boundary.\n *\n * The API runtime should not reach into CSS' storage container. GET/PUT/DELETE\n * through CSS keeps authorization, object backends, and MixData/RDF indexing in\n * one protocol path.\n */\nexport class PodSolidFsHydrator implements SolidFsHydrator {\n  private readonly http: PodSolidFsHttpClient;\n\n  public constructor(options: PodSolidFsHydratorOptions = {}) {\n    this.http = new PodSolidFsHttpClient(options);\n  }\n\n  public async hydrate(input: SolidFsHydrateInput): Promise<{ contentType?: string; sourceVersion?: string }> {\n    const resourceUrl = this.resolveResourceUrl(input.path, input.workspace);\n    const headers = await this.http.createAuthHeaders(input.context, `hydrate SolidFS object: ${resourceUrl}`);\n    const response = await this.http.request(resourceUrl, {\n      method: 'GET',\n      headers,\n    });\n\n    if (response.status === 404) {\n      throw new SolidFsNotFoundError(`SolidFS object not found: ${resourceUrl}`);\n    }\n    if (!response.ok) {\n      throw new Error(`SolidFS object hydrate failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);\n    }\n    if (!response.body) {\n      throw new Error(`SolidFS object hydrate failed for ${resourceUrl}: empty response body`);\n    }\n\n    await mkdir(path.dirname(input.targetPath), { recursive: true });\n    await pipeline(response.body as any, createWriteStream(input.targetPath));\n\n    return {\n      contentType: response.headers.get('content-type') ?? undefined,\n      sourceVersion: this.responseVersion(response),\n    };\n  }\n\n  public async commit(input: SolidFsCommitHydratedInput): Promise<{ sourceVersion?: string }> {\n    const resourceUrl = this.resolveChangeResourceUrl(input);\n    const headers = await this.http.createAuthHeaders(input.context, `commit SolidFS object: ${resourceUrl}`);\n    if (input.change.contentType) {\n      headers.set('Content-Type', input.change.contentType);\n    }\n    if (input.change.sourceVersion) {\n      headers.set('If-Match', input.change.sourceVersion);\n    }\n\n    const response = await this.http.request(resourceUrl, {\n      method: 'PUT',\n      headers,\n      body: createReadStream(input.change.sourcePath) as any,\n      duplex: 'half' as any,\n    } as RequestInit);\n\n    if (response.status === 409 || response.status === 412) {\n      throw new SolidFsConflictError([{\n        path: input.change.path,\n        sourcePath: input.change.sourcePath,\n        expectedVersion: input.change.sourceVersion,\n        actualVersion: this.responseVersion(response),\n        message: `Object authority changed before SolidFS commit: ${resourceUrl}`,\n      }]);\n    }\n    if (!response.ok) {\n      throw new Error(`SolidFS object commit failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);\n    }\n\n    return {\n      sourceVersion: this.responseVersion(response),\n    };\n  }\n\n  public async delete(input: SolidFsCommitHydratedInput): Promise<void> {\n    const resourceUrl = this.resolveChangeResourceUrl(input);\n    const headers = await this.http.createAuthHeaders(input.context, `delete SolidFS object: ${resourceUrl}`);\n    if (input.change.sourceVersion) {\n      headers.set('If-Match', input.change.sourceVersion);\n    }\n\n    const response = await this.http.request(resourceUrl, {\n      method: 'DELETE',\n      headers,\n    });\n\n    if (response.status === 409 || response.status === 412) {\n      throw new SolidFsConflictError([{\n        path: input.change.path,\n        sourcePath: input.change.sourcePath,\n        expectedVersion: input.change.sourceVersion,\n        actualVersion: this.responseVersion(response),\n        message: `Object authority changed before SolidFS delete: ${resourceUrl}`,\n      }]);\n    }\n    if (!response.ok && response.status !== 404) {\n      throw new Error(`SolidFS object delete failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);\n    }\n  }\n\n  private resolveResourceUrl(relativePath: string, workspace: SolidFsHydrateInput['workspace']): string {\n    const resourceUrl = resolvePodWorkspaceResourceUrl(relativePath, workspace);\n    if (!resourceUrl) {\n      throw new Error(`Cannot resolve SolidFS Pod resource URL for ${relativePath} in ${workspace.workspace}`);\n    }\n    return resourceUrl;\n  }\n\n  private resolveChangeResourceUrl(input: SolidFsCommitHydratedInput): string {\n    if (input.change.resource) {\n      try {\n        const url = new URL(input.change.resource);\n        if (url.protocol === 'http:' || url.protocol === 'https:') {\n          return url.href;\n        }\n      } catch {\n        // Fall through to workspace-relative resolution.\n      }\n    }\n    return this.resolveResourceUrl(input.change.path, input.workspace);\n  }\n\n  private responseVersion(response: Response): string | undefined {\n    return response.headers.get('etag') ?? response.headers.get('last-modified') ?? undefined;\n  }\n}\n"]}

package/dist/solidfs/PodSolidFsSyncer.d.ts

@@ -0,0 +1,21 @@
+import type { SolidFsChange, SolidFsManifest, SolidFsSyncer } from './types';
+export interface PodSolidFsSyncerOptions {
+    fetch?: typeof fetch;
+    tokenEndpoint?: string;
+}
+/**
+ * Writes SolidFS RDF file changes back through the Pod HTTP surface.
+ *
+ * The CSS/MixDataAccessor path remains responsible for parsing RDF documents
+ * into the structured RDF index. This adapter only bridges runtime workspace
+ * edits back to the Pod resource URL with the caller's stored auth context.
+ */
+export declare class PodSolidFsSyncer implements SolidFsSyncer {
+    private readonly http;
+    constructor(options?: PodSolidFsSyncerOptions);
+    shouldTrack(input: {
+        workspace: string;
+    }): boolean;
+    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;
+}
+export declare function resolvePodResourceUrl(change: SolidFsChange, workspace: SolidFsManifest): string | undefined;

package/dist/solidfs/PodSolidFsSyncer.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodSolidFsSyncer = void 0;
+exports.resolvePodResourceUrl = resolvePodResourceUrl;
+const node_fs_1 = require("node:fs");
+const RdfContentTypes_1 = require("../storage/rdf/RdfContentTypes");
+const PodSolidFsHttpClient_1 = require("./PodSolidFsHttpClient");
+/**
+ * Writes SolidFS RDF file changes back through the Pod HTTP surface.
+ *
+ * The CSS/MixDataAccessor path remains responsible for parsing RDF documents
+ * into the structured RDF index. This adapter only bridges runtime workspace
+ * edits back to the Pod resource URL with the caller's stored auth context.
+ */
+class PodSolidFsSyncer {
+    constructor(options = {}) {
+        this.http = new PodSolidFsHttpClient_1.PodSolidFsHttpClient(options);
+    }
+    shouldTrack(input) {
+        try {
+            const url = new URL(input.workspace);
+            return url.protocol === 'http:' || url.protocol === 'https:';
+        }
+        catch {
+            return false;
+        }
+    }
+    async sync(change, workspace, context) {
+        if (!isRdfChange(change)) {
+            return;
+        }
+        const resourceUrl = resolvePodResourceUrl(change, workspace);
+        if (!resourceUrl) {
+            return;
+        }
+        const headers = await this.http.createAuthHeaders(context, `sync SolidFS RDF change: ${resourceUrl}`);
+        if (change.type === 'deleted') {
+            const response = await this.http.request(resourceUrl, {
+                method: 'DELETE',
+                headers,
+            });
+            if (!response.ok && response.status !== 404) {
+                throw new Error(`SolidFS RDF delete sync failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);
+            }
+            return;
+        }
+        headers.set('Content-Type', change.contentType ?? 'text/turtle');
+        const response = await this.http.request(resourceUrl, {
+            method: 'PUT',
+            headers,
+            body: (0, node_fs_1.createReadStream)(change.sourcePath),
+            duplex: 'half',
+        });
+        if (!response.ok) {
+            throw new Error(`SolidFS RDF write sync failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);
+        }
+    }
+}
+exports.PodSolidFsSyncer = PodSolidFsSyncer;
+function resolvePodResourceUrl(change, workspace) {
+    if (change.resource) {
+        try {
+            const url = new URL(change.resource);
+            if (url.protocol === 'http:' || url.protocol === 'https:') {
+                return url.href;
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return (0, PodSolidFsHttpClient_1.resolvePodWorkspaceResourceUrl)(change.path, workspace);
+}
+function isRdfChange(change) {
+    return (0, RdfContentTypes_1.isRdfDocument)(change.contentType, change.path);
+}
+//# sourceMappingURL=PodSolidFsSyncer.js.map

package/dist/solidfs/PodSolidFsSyncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodSolidFsSyncer.js","sourceRoot":"","sources":["../../src/solidfs/PodSolidFsSyncer.ts"],"names":[],"mappings":"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","sourcesContent":["import { createReadStream } from 'node:fs';\n\nimport type { SolidFsChange, SolidFsManifest, SolidFsSyncer } from './types';\nimport { isRdfDocument } from '../storage/rdf/RdfContentTypes';\nimport { PodSolidFsHttpClient, resolvePodWorkspaceResourceUrl } from './PodSolidFsHttpClient';\n\nexport interface PodSolidFsSyncerOptions {\n  fetch?: typeof fetch;\n  tokenEndpoint?: string;\n}\n\n/**\n * Writes SolidFS RDF file changes back through the Pod HTTP surface.\n *\n * The CSS/MixDataAccessor path remains responsible for parsing RDF documents\n * into the structured RDF index. This adapter only bridges runtime workspace\n * edits back to the Pod resource URL with the caller's stored auth context.\n */\nexport class PodSolidFsSyncer implements SolidFsSyncer {\n  private readonly http: PodSolidFsHttpClient;\n\n  public constructor(options: PodSolidFsSyncerOptions = {}) {\n    this.http = new PodSolidFsHttpClient(options);\n  }\n\n  public shouldTrack(input: { workspace: string }): boolean {\n    try {\n      const url = new URL(input.workspace);\n      return url.protocol === 'http:' || url.protocol === 'https:';\n    } catch {\n      return false;\n    }\n  }\n\n  public async sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void> {\n    if (!isRdfChange(change)) {\n      return;\n    }\n\n    const resourceUrl = resolvePodResourceUrl(change, workspace);\n    if (!resourceUrl) {\n      return;\n    }\n\n    const headers = await this.http.createAuthHeaders(context, `sync SolidFS RDF change: ${resourceUrl}`);\n    if (change.type === 'deleted') {\n      const response = await this.http.request(resourceUrl, {\n        method: 'DELETE',\n        headers,\n      });\n      if (!response.ok && response.status !== 404) {\n        throw new Error(`SolidFS RDF delete sync failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);\n      }\n      return;\n    }\n\n    headers.set('Content-Type', change.contentType ?? 'text/turtle');\n    const response = await this.http.request(resourceUrl, {\n      method: 'PUT',\n      headers,\n      body: createReadStream(change.sourcePath) as any,\n      duplex: 'half' as any,\n    } as RequestInit);\n    if (!response.ok) {\n      throw new Error(`SolidFS RDF write sync failed for ${resourceUrl}: ${response.status} ${await response.text().catch(() => '')}`);\n    }\n  }\n}\n\nexport function resolvePodResourceUrl(change: SolidFsChange, workspace: SolidFsManifest): string | undefined {\n  if (change.resource) {\n    try {\n      const url = new URL(change.resource);\n      if (url.protocol === 'http:' || url.protocol === 'https:') {\n        return url.href;\n      }\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  }\n  return resolvePodWorkspaceResourceUrl(change.path, workspace);\n}\n\nfunction isRdfChange(change: SolidFsChange): boolean {\n  return isRdfDocument(change.contentType, change.path);\n}\n"]}

package/dist/solidfs/RdfIndexSolidFsSyncer.d.ts

@@ -0,0 +1,22 @@
+import { type ResourceIdentifier } from '@solid/community-server';
+import type { LocalRdfIndexAccessor } from '../storage/accessors/MixDataAccessor';
+import type { RdfTextIndex } from '../storage/rdf';
+import type { SolidFsChange, SolidFsManifest, SolidFsSyncer } from './types';
+export interface RdfIndexSolidFsSyncerOptions {
+    index: LocalRdfIndexAccessor;
+    textIndex?: RdfTextIndex;
+    resolveIdentifier?: (change: SolidFsChange, workspace: SolidFsManifest) => ResourceIdentifier | undefined;
+}
+/**
+ * Refreshes the structured RDF index for standard RDF documents changed
+ * through a SolidFS materialized workspace.
+ */
+export declare class RdfIndexSolidFsSyncer implements SolidFsSyncer {
+    private readonly index;
+    private readonly textIndex?;
+    private readonly resolveIdentifier;
+    constructor(options: RdfIndexSolidFsSyncerOptions);
+    shouldTrackPath(relativePath: string): boolean;
+    sync(change: SolidFsChange, workspace: SolidFsManifest): Promise<void>;
+}
+export declare function defaultResolveIdentifier(change: SolidFsChange, workspace: SolidFsManifest): ResourceIdentifier | undefined;

package/dist/solidfs/RdfIndexSolidFsSyncer.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RdfIndexSolidFsSyncer = void 0;
+exports.defaultResolveIdentifier = defaultResolveIdentifier;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const community_server_1 = require("@solid/community-server");
+const RdfContentTypes_1 = require("../storage/rdf/RdfContentTypes");
+/**
+ * Refreshes the structured RDF index for standard RDF documents changed
+ * through a SolidFS materialized workspace.
+ */
+class RdfIndexSolidFsSyncer {
+    constructor(options) {
+        this.index = options.index;
+        this.textIndex = options.textIndex;
+        this.resolveIdentifier = options.resolveIdentifier ?? defaultResolveIdentifier;
+    }
+    shouldTrackPath(relativePath) {
+        return isRdfPath(relativePath) || (this.textIndex ? isTextPath(relativePath) : false);
+    }
+    async sync(change, workspace) {
+        if (!isTrackedChange(change)) {
+            return;
+        }
+        const identifier = this.resolveIdentifier(change, workspace);
+        if (!identifier && isRdfChange(change) && !this.textIndex) {
+            return;
+        }
+        if (change.type === 'deleted') {
+            if (identifier && isRdfChange(change)) {
+                await this.index.deleteLocalRdfIndex(identifier);
+            }
+            if (this.textIndex && isTextIndexableChange(change)) {
+                this.textIndex.deleteSource(change.resource ?? sourceFromWorkspace(change, workspace));
+            }
+            return;
+        }
+        if (identifier && isRdfChange(change)) {
+            const localPath = change.path.split(node_path_1.default.sep).join('/');
+            await this.index.syncLocalRdfDocument(identifier, (0, community_server_1.guardStream)((0, node_fs_1.createReadStream)(change.sourcePath)), change.contentType, {
+                source: change.resource ?? sourceFromWorkspace(change, workspace),
+                workspace: workspace.workspace,
+                localPath,
+                sourceVersion: change.sourceVersion,
+            });
+        }
+        if (this.textIndex && isTextIndexableChange(change)) {
+            const text = await (0, promises_1.readFile)(change.sourcePath, 'utf8');
+            this.textIndex.indexText({
+                source: change.resource ?? sourceFromWorkspace(change, workspace),
+                workspace: workspace.workspace,
+                localPath: change.path.split(node_path_1.default.sep).join('/'),
+                contentType: change.contentType,
+                sourceVersion: change.sourceVersion,
+            }, text);
+        }
+    }
+}
+exports.RdfIndexSolidFsSyncer = RdfIndexSolidFsSyncer;
+function defaultResolveIdentifier(change, workspace) {
+    if (change.resource) {
+        try {
+            const resource = new URL(change.resource);
+            if (resource.protocol === 'http:' || resource.protocol === 'https:') {
+                return { path: resource.href };
+            }
+        }
+        catch {
+            return undefined;
+        }
+        return undefined;
+    }
+    try {
+        const base = new URL(workspace.workspace.endsWith('/') ? workspace.workspace : `${workspace.workspace}/`);
+        if (base.protocol !== 'http:' && base.protocol !== 'https:') {
+            return undefined;
+        }
+        const normalized = change.path.split(node_path_1.default.sep).join('/');
+        return { path: new URL(normalized, base).href };
+    }
+    catch {
+        return undefined;
+    }
+}
+function isRdfChange(change) {
+    return (0, RdfContentTypes_1.isRdfDocument)(change.contentType, change.path);
+}
+function isLineAddressableRdfChange(change) {
+    return (0, RdfContentTypes_1.isLineAddressableRdf)(change.contentType, change.path);
+}
+function isTextChange(change) {
+    return isTextContentType(change.contentType) || isTextPath(change.path);
+}
+function isTextIndexableChange(change) {
+    return isLineAddressableRdfChange(change) || isTextChange(change);
+}
+function isTrackedChange(change) {
+    return isRdfChange(change) || isTextChange(change);
+}
+function isRdfPath(filePath) {
+    return (0, RdfContentTypes_1.isRdfDocumentPath)(filePath);
+}
+function isTextPath(filePath) {
+    const lower = filePath.toLowerCase();
+    return lower.endsWith('.md')
+        || lower.endsWith('.markdown')
+        || lower.endsWith('.mdown')
+        || lower.endsWith('.txt')
+        || lower.endsWith('.log');
+}
+function isTextContentType(contentType) {
+    const normalized = (0, RdfContentTypes_1.normalizeContentType)(contentType);
+    return normalized === 'text/plain'
+        || normalized === 'text/markdown'
+        || normalized === 'text/x-markdown';
+}
+function sourceFromWorkspace(change, workspace) {
+    try {
+        const base = new URL(workspace.workspace.endsWith('/') ? workspace.workspace : `${workspace.workspace}/`);
+        return new URL(change.path.split(node_path_1.default.sep).join('/'), base).href;
+    }
+    catch {
+        return change.sourcePath;
+    }
+}
+//# sourceMappingURL=RdfIndexSolidFsSyncer.js.map

package/dist/solidfs/RdfIndexSolidFsSyncer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RdfIndexSolidFsSyncer.js","sourceRoot":"","sources":["../../src/solidfs/RdfIndexSolidFsSyncer.ts"],"names":[],"mappings":"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","sourcesContent":["import { createReadStream } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\nimport { guardStream, type ResourceIdentifier } from '@solid/community-server';\n\nimport type { LocalRdfIndexAccessor } from '../storage/accessors/MixDataAccessor';\nimport type { RdfTextIndex } from '../storage/rdf';\nimport {\n  isLineAddressableRdf,\n  isRdfDocument,\n  isRdfDocumentPath,\n  normalizeContentType,\n} from '../storage/rdf/RdfContentTypes';\nimport type { SolidFsChange, SolidFsManifest, SolidFsSyncer } from './types';\n\nexport interface RdfIndexSolidFsSyncerOptions {\n  index: LocalRdfIndexAccessor;\n  textIndex?: RdfTextIndex;\n  resolveIdentifier?: (change: SolidFsChange, workspace: SolidFsManifest) => ResourceIdentifier | undefined;\n}\n\n/**\n * Refreshes the structured RDF index for standard RDF documents changed\n * through a SolidFS materialized workspace.\n */\nexport class RdfIndexSolidFsSyncer implements SolidFsSyncer {\n  private readonly index: LocalRdfIndexAccessor;\n  private readonly textIndex?: RdfTextIndex;\n  private readonly resolveIdentifier: NonNullable<RdfIndexSolidFsSyncerOptions['resolveIdentifier']>;\n\n  public constructor(options: RdfIndexSolidFsSyncerOptions) {\n    this.index = options.index;\n    this.textIndex = options.textIndex;\n    this.resolveIdentifier = options.resolveIdentifier ?? defaultResolveIdentifier;\n  }\n\n  public shouldTrackPath(relativePath: string): boolean {\n    return isRdfPath(relativePath) || (this.textIndex ? isTextPath(relativePath) : false);\n  }\n\n  public async sync(change: SolidFsChange, workspace: SolidFsManifest): Promise<void> {\n    if (!isTrackedChange(change)) {\n      return;\n    }\n\n    const identifier = this.resolveIdentifier(change, workspace);\n    if (!identifier && isRdfChange(change) && !this.textIndex) {\n      return;\n    }\n\n    if (change.type === 'deleted') {\n      if (identifier && isRdfChange(change)) {\n        await this.index.deleteLocalRdfIndex(identifier);\n      }\n      if (this.textIndex && isTextIndexableChange(change)) {\n        this.textIndex.deleteSource(change.resource ?? sourceFromWorkspace(change, workspace));\n      }\n      return;\n    }\n\n    if (identifier && isRdfChange(change)) {\n      const localPath = change.path.split(path.sep).join('/');\n      await this.index.syncLocalRdfDocument(\n        identifier,\n        guardStream(createReadStream(change.sourcePath)),\n        change.contentType,\n        {\n          source: change.resource ?? sourceFromWorkspace(change, workspace),\n          workspace: workspace.workspace,\n          localPath,\n          sourceVersion: change.sourceVersion,\n        },\n      );\n    }\n\n    if (this.textIndex && isTextIndexableChange(change)) {\n      const text = await readFile(change.sourcePath, 'utf8');\n      this.textIndex.indexText({\n        source: change.resource ?? sourceFromWorkspace(change, workspace),\n        workspace: workspace.workspace,\n        localPath: change.path.split(path.sep).join('/'),\n        contentType: change.contentType,\n        sourceVersion: change.sourceVersion,\n      }, text);\n    }\n  }\n}\n\nexport function defaultResolveIdentifier(\n  change: SolidFsChange,\n  workspace: SolidFsManifest,\n): ResourceIdentifier | undefined {\n  if (change.resource) {\n    try {\n      const resource = new URL(change.resource);\n      if (resource.protocol === 'http:' || resource.protocol === 'https:') {\n        return { path: resource.href };\n      }\n    } catch {\n      return undefined;\n    }\n    return undefined;\n  }\n\n  try {\n    const base = new URL(workspace.workspace.endsWith('/') ? workspace.workspace : `${workspace.workspace}/`);\n    if (base.protocol !== 'http:' && base.protocol !== 'https:') {\n      return undefined;\n    }\n    const normalized = change.path.split(path.sep).join('/');\n    return { path: new URL(normalized, base).href };\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isRdfChange(change: SolidFsChange): boolean {\n  return isRdfDocument(change.contentType, change.path);\n}\n\nfunction isLineAddressableRdfChange(change: SolidFsChange): boolean {\n  return isLineAddressableRdf(change.contentType, change.path);\n}\n\nfunction isTextChange(change: SolidFsChange): boolean {\n  return isTextContentType(change.contentType) || isTextPath(change.path);\n}\n\nfunction isTextIndexableChange(change: SolidFsChange): boolean {\n  return isLineAddressableRdfChange(change) || isTextChange(change);\n}\n\nfunction isTrackedChange(change: SolidFsChange): boolean {\n  return isRdfChange(change) || isTextChange(change);\n}\n\nfunction isRdfPath(filePath: string): boolean {\n  return isRdfDocumentPath(filePath);\n}\n\nfunction isTextPath(filePath: string): boolean {\n  const lower = filePath.toLowerCase();\n  return lower.endsWith('.md')\n    || lower.endsWith('.markdown')\n    || lower.endsWith('.mdown')\n    || lower.endsWith('.txt')\n    || lower.endsWith('.log');\n}\n\nfunction isTextContentType(contentType: string | undefined): boolean {\n  const normalized = normalizeContentType(contentType);\n  return normalized === 'text/plain'\n    || normalized === 'text/markdown'\n    || normalized === 'text/x-markdown';\n}\n\nfunction sourceFromWorkspace(change: SolidFsChange, workspace: SolidFsManifest): string {\n  try {\n    const base = new URL(workspace.workspace.endsWith('/') ? workspace.workspace : `${workspace.workspace}/`);\n    return new URL(change.path.split(path.sep).join('/'), base).href;\n  } catch {\n    return change.sourcePath;\n  }\n}\n"]}

package/dist/solidfs/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types';
+export * from './LocalSolidFS';
+export * from './PodSolidFsHttpClient';
+export * from './PodSolidFsHydrator';
+export * from './RdfIndexSolidFsSyncer';
+export * from './PodSolidFsSyncer';
+export * from './LocalFirstRdfRepresentationResolver';

package/dist/solidfs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./LocalSolidFS"), exports);
+__exportStar(require("./PodSolidFsHttpClient"), exports);
+__exportStar(require("./PodSolidFsHydrator"), exports);
+__exportStar(require("./RdfIndexSolidFsSyncer"), exports);
+__exportStar(require("./PodSolidFsSyncer"), exports);
+__exportStar(require("./LocalFirstRdfRepresentationResolver"), exports);
+//# sourceMappingURL=index.js.map

package/dist/solidfs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/solidfs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,iDAA+B;AAC/B,yDAAuC;AACvC,uDAAqC;AACrC,0DAAwC;AACxC,qDAAmC;AACnC,wEAAsD","sourcesContent":["export * from './types';\nexport * from './LocalSolidFS';\nexport * from './PodSolidFsHttpClient';\nexport * from './PodSolidFsHydrator';\nexport * from './RdfIndexSolidFsSyncer';\nexport * from './PodSolidFsSyncer';\nexport * from './LocalFirstRdfRepresentationResolver';\n"]}