@relayfile/adapter-core 0.1.18 → 0.1.20

package/dist/src/storage-bridge/writeback.d.ts

@@ -0,0 +1,41 @@
+import { type AdapterResourceConfig, type JsonSchemaObject } from "./discovery.js";
+export type StorageBridgeWritebackMethod = "PUT" | "PATCH" | "DELETE";
+export interface StorageBridgeWritebackRequest {
+    readonly workspaceId: string;
+    readonly path: string;
+    readonly content?: string | Buffer | Uint8Array | Record<string, unknown> | null;
+    readonly method?: StorageBridgeWritebackMethod;
+}
+export interface ParsedStorageBridgeWriteback {
+    readonly resource: AdapterResourceConfig;
+    readonly operation: "create" | "update" | "delete";
+    readonly id: string;
+    readonly canonical: boolean;
+    readonly filename: string;
+    readonly payload?: Record<string, unknown>;
+}
+export interface StorageBridgeWritebackCreated {
+    readonly created: string;
+    readonly path: string;
+    readonly url?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface StorageBridgeWritebackHandlers<Result = unknown> {
+    create(input: ParsedStorageBridgeWriteback): Promise<StorageBridgeWritebackCreated> | StorageBridgeWritebackCreated;
+    update(input: ParsedStorageBridgeWriteback): Promise<Result> | Result;
+    delete(input: ParsedStorageBridgeWriteback): Promise<Result> | Result;
+}
+export interface DispatchStorageBridgeWritebackOptions<Result = unknown> {
+    readonly resources: readonly AdapterResourceConfig[];
+    readonly schemas?: Record<string, JsonSchemaObject>;
+    readonly handlers: StorageBridgeWritebackHandlers<Result>;
+}
+export declare function dispatchStorageBridgeWriteback<Result = unknown>(request: StorageBridgeWritebackRequest, options: DispatchStorageBridgeWritebackOptions<Result>): Promise<StorageBridgeWritebackCreated | Result>;
+export declare function parseStorageBridgeWriteback(request: StorageBridgeWritebackRequest, resources: readonly AdapterResourceConfig[]): ParsedStorageBridgeWriteback;
+export declare function buildStorageBridgeCreateResult(input: {
+    readonly resourcePath: string;
+    readonly id: string;
+    readonly url?: string;
+    readonly metadata?: Record<string, unknown>;
+}): StorageBridgeWritebackCreated;
+//# sourceMappingURL=writeback.d.ts.map

package/dist/src/storage-bridge/writeback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../src/storage-bridge/writeback.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,8BAA8B,CAAC,MAAM,GAAG,OAAO;IAC9D,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC,GAAG,6BAA6B,CAAC;IACpH,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACvE;AAED,MAAM,WAAW,qCAAqC,CAAC,MAAM,GAAG,OAAO;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC,MAAM,CAAC,CAAC;CAC3D;AAED,wBAAsB,8BAA8B,CAAC,MAAM,GAAG,OAAO,EACnE,OAAO,EAAE,6BAA6B,EACtC,OAAO,EAAE,qCAAqC,CAAC,MAAM,CAAC,GACrD,OAAO,CAAC,6BAA6B,GAAG,MAAM,CAAC,CAejD;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,6BAA6B,EACtC,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAC1C,4BAA4B,CAsC9B;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,GAAG,6BAA6B,CAQhC"}

package/dist/src/storage-bridge/writeback.js

@@ -0,0 +1,85 @@
+import { assertReadOnlyFieldsRejected, findResourceByPath, } from "./discovery.js";
+export async function dispatchStorageBridgeWriteback(request, options) {
+    const parsed = parseStorageBridgeWriteback(request, options.resources);
+    const schema = options.schemas?.[parsed.resource.schema];
+    if (schema && parsed.payload && parsed.operation !== "create") {
+        assertReadOnlyFieldsRejected(schema, parsed.payload);
+    }
+    switch (parsed.operation) {
+        case "create":
+            return options.handlers.create(parsed);
+        case "update":
+            return options.handlers.update(parsed);
+        case "delete":
+            return options.handlers.delete(parsed);
+    }
+}
+export function parseStorageBridgeWriteback(request, resources) {
+    const resource = findResourceByPath(resources, request.path);
+    if (!resource) {
+        throw new Error(`No storage bridge writeback resource matched ${request.path}`);
+    }
+    const filename = request.path.split("/").filter(Boolean).at(-1);
+    if (!filename) {
+        throw new Error(`Storage bridge writeback path has no filename: ${request.path}`);
+    }
+    const id = stripJsonExtension(decodeURIComponent(filename));
+    if (id === "new") {
+        throw new Error("Storage bridge writeback creates must use any non-canonical filename; new.json is not supported");
+    }
+    const canonical = resource.idPattern.test(id);
+    const method = request.method ?? "PUT";
+    const operation = method === "DELETE" ? "delete" : canonical ? "update" : "create";
+    if (operation === "delete" && !canonical) {
+        throw new Error(`Storage bridge delete requires a canonical id matching ${resource.idPattern}`);
+    }
+    const payload = operation === "delete" ? undefined : parseWritebackContent(request.content);
+    return {
+        resource,
+        operation,
+        id,
+        canonical,
+        filename,
+        payload,
+    };
+}
+export function buildStorageBridgeCreateResult(input) {
+    const path = `${input.resourcePath.replace(/\/$/, "")}/${encodeURIComponent(input.id)}.json`;
+    return {
+        created: input.id,
+        path,
+        ...(input.url ? { url: input.url } : {}),
+        ...(input.metadata ? { metadata: input.metadata } : {}),
+    };
+}
+function parseWritebackContent(content) {
+    if (content === undefined || content === null)
+        return {};
+    if (typeof content === "string")
+        return parseJsonObject(content);
+    if (Buffer.isBuffer(content))
+        return parseJsonObject(content.toString("utf8"));
+    if (content instanceof Uint8Array) {
+        return parseJsonObject(Buffer.from(content).toString("utf8"));
+    }
+    if (typeof content === "object" && !Array.isArray(content)) {
+        return content;
+    }
+    throw new Error("Storage bridge writeback content must be a JSON object");
+}
+function parseJsonObject(content) {
+    try {
+        const parsed = JSON.parse(content);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch (error) {
+        throw new Error(`Storage bridge writeback content is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    throw new Error("Storage bridge writeback content must be a JSON object");
+}
+function stripJsonExtension(filename) {
+    return filename.endsWith(".json") ? filename.slice(0, -5) : filename;
+}
+//# sourceMappingURL=writeback.js.map

package/dist/src/storage-bridge/writeback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeback.js","sourceRoot":"","sources":["../../../src/storage-bridge/writeback.ts"],"names":[],"mappings":"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"}

package/dist/src/writeback/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./storage-bridge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/writeback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/writeback/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/src/writeback/index.js

@@ -0,0 +1,2 @@
+export * from "./storage-bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/src/writeback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/writeback/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/src/writeback/storage-bridge.d.ts

@@ -0,0 +1,5 @@
+export { buildStorageBridgeCreateResult, dispatchStorageBridgeWriteback, parseStorageBridgeWriteback, } from "../storage-bridge/writeback.js";
+export type { DispatchStorageBridgeWritebackOptions, ParsedStorageBridgeWriteback, StorageBridgeWritebackCreated, StorageBridgeWritebackHandlers, StorageBridgeWritebackMethod, StorageBridgeWritebackRequest, } from "../storage-bridge/writeback.js";
+export { assertReadOnlyFieldsRejected, collectReadOnlyFields, findResourceByPath, ReadOnlyFieldError, } from "../storage-bridge/discovery.js";
+export type { AdapterResourceConfig, AdapterResourceOperation, JsonSchemaObject, } from "../storage-bridge/discovery.js";
+//# sourceMappingURL=storage-bridge.d.ts.map

package/dist/src/writeback/storage-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-bridge.d.ts","sourceRoot":"","sources":["../../../src/writeback/storage-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,qCAAqC,EACrC,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,gCAAgC,CAAC"}

package/dist/src/writeback/storage-bridge.js

@@ -0,0 +1,3 @@
+export { buildStorageBridgeCreateResult, dispatchStorageBridgeWriteback, parseStorageBridgeWriteback, } from "../storage-bridge/writeback.js";
+export { assertReadOnlyFieldsRejected, collectReadOnlyFields, findResourceByPath, ReadOnlyFieldError, } from "../storage-bridge/discovery.js";
+//# sourceMappingURL=storage-bridge.js.map

package/dist/src/writeback/storage-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-bridge.js","sourceRoot":"","sources":["../../../src/writeback/storage-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AAWxC,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC"}

package/dist/tests/storage-bridge/all-priority-adapters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=all-priority-adapters.test.d.ts.map

package/dist/tests/storage-bridge/all-priority-adapters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-priority-adapters.test.d.ts","sourceRoot":"","sources":["../../../tests/storage-bridge/all-priority-adapters.test.ts"],"names":[],"mappings":""}