@relayfile/adapter-core 0.1.18 → 0.1.20

package/dist/src/index.d.ts

@@ -17,4 +17,5 @@ export * from "./docs/generator.js";
 export * from "./docs/mapping-generator.js";
 export * from "./docs/change-detector.js";
 export * from "./docs/updater.js";
+export * from "./storage-bridge/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}

package/dist/src/index.js

@@ -17,4 +17,5 @@ export * from "./docs/generator.js";
 export * from "./docs/mapping-generator.js";
 export * from "./docs/change-detector.js";
 export * from "./docs/updater.js";
+export * from "./storage-bridge/index.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}

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

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

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

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

package/dist/src/pubsub/index.js

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

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

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

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

@@ -0,0 +1,3 @@
+export { InMemoryIdempotencyStore, InMemoryStorageBridgeEventPublisher, publishStorageBridgeEvent, } from "../storage-bridge/publisher.js";
+export type { IdempotencyStore, InMemoryPublisherOptions, PublishStorageBridgeEventOptions, StorageBridgeEventPublisher, StorageBridgeEventPublisherForSource, StorageBridgeEventSubscriber, StorageBridgePublishResult, StorageBridgeSubscription, } from "../storage-bridge/publisher.js";
+//# sourceMappingURL=storage-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-bridge.d.ts","sourceRoot":"","sources":["../../../src/pubsub/storage-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,gCAAgC,EAChC,2BAA2B,EAC3B,oCAAoC,EACpC,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC"}

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

@@ -0,0 +1,2 @@
+export { InMemoryIdempotencyStore, InMemoryStorageBridgeEventPublisher, publishStorageBridgeEvent, } from "../storage-bridge/publisher.js";
+//# sourceMappingURL=storage-bridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-bridge.js","sourceRoot":"","sources":["../../../src/pubsub/storage-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC"}

package/dist/src/storage-bridge/adapter-worker.d.ts

@@ -0,0 +1,98 @@
+import { type JsonValue, type StorageBridgeEvent } from "./event.js";
+import { type IdempotencyStore, type StorageBridgeEventPublisher, type StorageBridgeSubscription } from "./publisher.js";
+export type StorageBridgeContentBody = string | Uint8Array | ArrayBuffer | Buffer | null;
+export interface StorageBridgeFetchedContent {
+    readonly body: StorageBridgeContentBody;
+    readonly contentType?: string;
+    readonly headers?: Record<string, string>;
+    readonly metadata?: Record<string, JsonValue>;
+}
+export interface StorageBridgeFetchContentContext<Config = unknown> {
+    readonly config: Config;
+    readonly signal?: AbortSignal;
+}
+export interface StorageBridgeContentFetcher<Config = unknown> {
+    (event: StorageBridgeEvent, context: StorageBridgeFetchContentContext<Config>): Promise<StorageBridgeFetchedContent> | StorageBridgeFetchedContent;
+}
+export interface StorageBridgeRelayFileClient {
+    ingestWebhook(input: StorageBridgeWebhookEnvelope): Promise<unknown>;
+}
+export interface StorageBridgeWebhookEnvelope {
+    readonly workspaceId: string;
+    readonly provider: string;
+    readonly event_type: "file.created" | "file.updated" | "file.deleted";
+    readonly path: string;
+    readonly delivery_id: string;
+    readonly timestamp: string;
+    readonly data: {
+        readonly contentBase64: string | null;
+        readonly contentType: string | null;
+        readonly sizeBytes: number | null;
+        readonly fingerprint: string | null;
+        readonly resourceId: string;
+        readonly metadata: Record<string, JsonValue>;
+    };
+    readonly headers: Record<string, string>;
+    readonly semantics: {
+        readonly properties: Record<string, JsonValue>;
+    };
+}
+export interface RetryPolicy {
+    readonly maxAttempts: number;
+    readonly baseDelayMs: number;
+    readonly maxDelayMs?: number;
+    readonly jitterRatio?: number;
+}
+export interface DeadLetterRecord {
+    readonly event: StorageBridgeEvent;
+    readonly envelope?: StorageBridgeWebhookEnvelope;
+    readonly attempts: number;
+    readonly error: string;
+    readonly failedAt: string;
+}
+export interface DeadLetterSink {
+    push(record: DeadLetterRecord): Promise<void> | void;
+}
+export declare class InMemoryDeadLetterSink implements DeadLetterSink {
+    readonly records: DeadLetterRecord[];
+    push(record: DeadLetterRecord): void;
+}
+export interface StorageBridgeAdapterWorkerOptions<Config = unknown> {
+    readonly provider: string;
+    readonly workspaceId?: string;
+    readonly config: Config;
+    readonly publisher: StorageBridgeEventPublisher;
+    readonly client: StorageBridgeRelayFileClient;
+    readonly fetchContent: StorageBridgeContentFetcher<Config>;
+    readonly idempotencyStore?: IdempotencyStore;
+    readonly retryPolicy?: Partial<RetryPolicy>;
+    readonly deadLetterSink?: DeadLetterSink;
+    readonly sleep?: (ms: number) => Promise<void>;
+    readonly signal?: AbortSignal;
+}
+export interface StorageBridgeWorkerResult {
+    readonly eventId: string;
+    readonly delivered: boolean;
+    readonly duplicate: boolean;
+    readonly attempts: number;
+    readonly envelope?: StorageBridgeWebhookEnvelope;
+}
+export declare class StorageBridgeAdapterWorker<Config = unknown> {
+    private readonly options;
+    private readonly idempotencyStore;
+    private readonly retryPolicy;
+    private readonly deadLetterSink;
+    private readonly sleep;
+    private subscription?;
+    constructor(options: StorageBridgeAdapterWorkerOptions<Config>);
+    start(): StorageBridgeSubscription;
+    stop(): void;
+    handleEvent(event: StorageBridgeEvent): Promise<StorageBridgeWorkerResult>;
+}
+export declare function buildStorageBridgeWebhookEnvelope(input: {
+    readonly event: StorageBridgeEvent;
+    readonly provider?: string;
+    readonly workspaceId?: string;
+    readonly content?: StorageBridgeFetchedContent;
+}): StorageBridgeWebhookEnvelope;
+//# sourceMappingURL=adapter-worker.d.ts.map

package/dist/src/storage-bridge/adapter-worker.d.ts.map

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

package/dist/src/storage-bridge/adapter-worker.js

@@ -0,0 +1,169 @@
+import { storageBridgeWebhookEventType, validateStorageBridgeEvent, } from "./event.js";
+import { InMemoryIdempotencyStore, } from "./publisher.js";
+export class InMemoryDeadLetterSink {
+    records = [];
+    push(record) {
+        this.records.push(record);
+    }
+}
+const DEFAULT_RETRY_POLICY = {
+    maxAttempts: 3,
+    baseDelayMs: 250,
+    maxDelayMs: 5_000,
+    jitterRatio: 0,
+};
+export class StorageBridgeAdapterWorker {
+    options;
+    idempotencyStore;
+    retryPolicy;
+    deadLetterSink;
+    sleep;
+    subscription;
+    constructor(options) {
+        this.options = options;
+        this.idempotencyStore =
+            options.idempotencyStore ?? new InMemoryIdempotencyStore();
+        this.retryPolicy = { ...DEFAULT_RETRY_POLICY, ...options.retryPolicy };
+        this.deadLetterSink = options.deadLetterSink ?? new InMemoryDeadLetterSink();
+        this.sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    start() {
+        if (this.subscription)
+            return this.subscription;
+        this.subscription = this.options.publisher.subscribe(async (event) => {
+            await this.handleEvent(event);
+        });
+        return this.subscription;
+    }
+    stop() {
+        this.subscription?.unsubscribe();
+        this.subscription = undefined;
+    }
+    async handleEvent(event) {
+        const validEvent = validateStorageBridgeEvent(event);
+        const deliveryKey = `storage-bridge:ingest:${validEvent.eventId}`;
+        const claimed = await this.idempotencyStore.claim(deliveryKey);
+        if (!claimed) {
+            return {
+                eventId: validEvent.eventId,
+                delivered: false,
+                duplicate: true,
+                attempts: 0,
+            };
+        }
+        let envelope;
+        let attempts = 0;
+        try {
+            const content = validEvent.changeType === "deleted"
+                ? { body: null }
+                : await this.options.fetchContent(validEvent, {
+                    config: this.options.config,
+                    signal: this.options.signal,
+                });
+            envelope = buildStorageBridgeWebhookEnvelope({
+                event: validEvent,
+                provider: this.options.provider,
+                workspaceId: this.options.workspaceId,
+                content,
+            });
+            await retry(async () => {
+                attempts += 1;
+                if (!envelope)
+                    throw new Error("Storage bridge webhook envelope missing");
+                await this.options.client.ingestWebhook(envelope);
+            }, this.retryPolicy, this.sleep);
+            return {
+                eventId: validEvent.eventId,
+                delivered: true,
+                duplicate: false,
+                attempts,
+                envelope,
+            };
+        }
+        catch (error) {
+            await this.deadLetterSink.push({
+                event: validEvent,
+                envelope,
+                attempts,
+                error: toErrorMessage(error),
+                failedAt: new Date().toISOString(),
+            });
+            throw error;
+        }
+    }
+}
+export function buildStorageBridgeWebhookEnvelope(input) {
+    const event = validateStorageBridgeEvent(input.event);
+    const body = input.content?.body ?? null;
+    const bodyBase64 = body === null ? null : bodyToBuffer(body).toString("base64");
+    const metadata = {
+        ...event.metadata,
+        ...(input.content?.metadata ?? {}),
+    };
+    return {
+        workspaceId: event.workspaceId ?? input.workspaceId ?? "",
+        provider: input.provider ?? event.source,
+        event_type: storageBridgeWebhookEventType(event.changeType),
+        path: event.relayfilePath,
+        delivery_id: event.eventId,
+        timestamp: event.occurredAt,
+        data: {
+            contentBase64: bodyBase64,
+            contentType: input.content?.contentType ?? null,
+            sizeBytes: event.sizeBytes,
+            fingerprint: event.fingerprint,
+            resourceId: event.resourceId,
+            metadata,
+        },
+        headers: {
+            "x-relayfile-storage-bridge-source": event.source,
+            "x-relayfile-storage-bridge-event-id": event.eventId,
+            ...(input.content?.headers ?? {}),
+        },
+        semantics: {
+            properties: {
+                "storage_bridge.source": event.source,
+                "storage_bridge.change_type": event.changeType,
+                "storage_bridge.resource_id": event.resourceId,
+                "storage_bridge.fingerprint": event.fingerprint,
+                "storage_bridge.delivery_id": event.eventId,
+            },
+        },
+    };
+}
+async function retry(fn, policy, sleep) {
+    let lastError;
+    for (let attempt = 1; attempt <= policy.maxAttempts; attempt += 1) {
+        try {
+            await fn();
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= policy.maxAttempts)
+                break;
+            await sleep(computeRetryDelay(policy, attempt));
+        }
+    }
+    throw lastError;
+}
+function computeRetryDelay(policy, attempt) {
+    const capped = Math.min(policy.maxDelayMs ?? Number.POSITIVE_INFINITY, policy.baseDelayMs * 2 ** Math.max(0, attempt - 1));
+    if (!policy.jitterRatio)
+        return capped;
+    const spread = capped * policy.jitterRatio;
+    return Math.max(0, capped - spread + Math.random() * spread * 2);
+}
+function bodyToBuffer(body) {
+    if (Buffer.isBuffer(body))
+        return body;
+    if (typeof body === "string")
+        return Buffer.from(body);
+    if (body instanceof ArrayBuffer)
+        return Buffer.from(body);
+    return Buffer.from(body);
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=adapter-worker.js.map

package/dist/src/storage-bridge/adapter-worker.js.map

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

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

@@ -0,0 +1,32 @@
+import type { JsonValue } from "./event.js";
+export interface AdapterResourceConfig {
+    readonly name: string;
+    readonly path: string;
+    readonly pathPattern: RegExp;
+    readonly idPattern: RegExp;
+    readonly schema: string;
+    readonly createExample: string;
+    readonly operations?: readonly AdapterResourceOperation[];
+}
+export type AdapterResourceOperation = "create" | "update" | "delete";
+export interface JsonSchemaObject {
+    readonly $schema?: string;
+    readonly type?: string | readonly string[];
+    readonly readOnly?: boolean;
+    readonly properties?: Record<string, JsonSchemaObject>;
+    readonly items?: JsonSchemaObject;
+    readonly anyOf?: readonly JsonSchemaObject[];
+    readonly oneOf?: readonly JsonSchemaObject[];
+    readonly allOf?: readonly JsonSchemaObject[];
+    readonly additionalProperties?: boolean | JsonSchemaObject;
+    readonly [key: string]: unknown;
+}
+export declare class ReadOnlyFieldError extends Error {
+    readonly fields: readonly string[];
+    constructor(fields: readonly string[]);
+}
+export declare function findResourceByPath(resources: readonly AdapterResourceConfig[], path: string): AdapterResourceConfig | undefined;
+export declare function assertReadOnlyFieldsRejected(schema: JsonSchemaObject, patch: Record<string, unknown>): void;
+export declare function collectReadOnlyFields(schema: JsonSchemaObject, prefix?: string): string[];
+export declare function isJsonRecord(value: unknown): value is Record<string, JsonValue>;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/storage-bridge/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC3D;AAED,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAC3D,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEvB,MAAM,EAAE,SAAS,MAAM,EAAE;CAKtC;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,IAAI,EAAE,MAAM,GACX,qBAAqB,GAAG,SAAS,CAGnC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAMN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,SAAK,GACV,MAAM,EAAE,CAeV;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE/E"}

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

@@ -0,0 +1,53 @@
+export class ReadOnlyFieldError extends Error {
+    fields;
+    constructor(fields) {
+        super(`Writeback attempted to modify read-only fields: ${fields.join(", ")}`);
+        this.name = "ReadOnlyFieldError";
+        this.fields = fields;
+    }
+}
+export function findResourceByPath(resources, path) {
+    const normalizedPath = path.endsWith(".json") ? path : path.replace(/\/$/, "");
+    return resources.find((resource) => resource.pathPattern.test(normalizedPath));
+}
+export function assertReadOnlyFieldsRejected(schema, patch) {
+    const readOnlyFields = collectReadOnlyFields(schema);
+    const rejected = readOnlyFields.filter((field) => hasPath(patch, field));
+    if (rejected.length > 0) {
+        throw new ReadOnlyFieldError(rejected);
+    }
+}
+export function collectReadOnlyFields(schema, prefix = "") {
+    const fields = [];
+    for (const [name, child] of Object.entries(schema.properties ?? {})) {
+        const path = prefix ? `${prefix}.${name}` : name;
+        if (child.readOnly)
+            fields.push(path);
+        fields.push(...collectReadOnlyFields(child, path));
+    }
+    for (const branch of [
+        ...(schema.anyOf ?? []),
+        ...(schema.oneOf ?? []),
+        ...(schema.allOf ?? []),
+    ]) {
+        fields.push(...collectReadOnlyFields(branch, prefix));
+    }
+    return [...new Set(fields)];
+}
+export function isJsonRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasPath(value, path) {
+    const parts = path.split(".");
+    let cursor = value;
+    for (const part of parts) {
+        if (!isPlainRecord(cursor) || !(part in cursor))
+            return false;
+        cursor = cursor[part];
+    }
+    return true;
+}
+function isPlainRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=discovery.js.map

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

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

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

@@ -0,0 +1,70 @@
+export declare const STORAGE_BRIDGE_SOURCES: readonly ["google-drive", "gcs", "sharepoint", "onedrive", "azure-blob", "dropbox", "gmail", "s3", "box", "postgres", "redis"];
+export type StorageBridgeSource = (typeof STORAGE_BRIDGE_SOURCES)[number];
+export declare const STORAGE_BRIDGE_CHANGE_TYPES: readonly ["created", "updated", "deleted"];
+export type StorageBridgeChangeType = (typeof STORAGE_BRIDGE_CHANGE_TYPES)[number];
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];
+export type StorageBridgeMetadata = Record<string, JsonValue>;
+export interface StorageBridgeEvent {
+    readonly eventId: string;
+    readonly occurredAt: string;
+    readonly detectedAt: string;
+    readonly source: StorageBridgeSource;
+    readonly changeType: StorageBridgeChangeType;
+    readonly relayfilePath: string;
+    readonly resourceId: string;
+    readonly sizeBytes: number | null;
+    readonly fingerprint: string | null;
+    readonly metadata: StorageBridgeMetadata;
+    readonly workspaceId: string | null;
+}
+export type StorageBridgeEventForSource<Source extends StorageBridgeSource> = StorageBridgeEvent & {
+    readonly source: Source;
+};
+export interface StorageBridgeSourceMetadata {
+    readonly source: StorageBridgeSource;
+    readonly providerConfigKey?: string;
+    readonly accountId?: string;
+    readonly connectionId?: string;
+    readonly subscriptionId?: string;
+    readonly nativeEventId?: string;
+    readonly cursor?: string;
+    readonly raw?: JsonValue;
+}
+export interface CreateStorageBridgeEventInput<Source extends StorageBridgeSource = StorageBridgeSource> {
+    readonly eventId?: string;
+    readonly occurredAt?: string | Date;
+    readonly detectedAt?: string | Date;
+    readonly source: Source;
+    readonly changeType: StorageBridgeChangeType;
+    readonly relayfilePath: string;
+    readonly resourceId: string;
+    readonly sizeBytes?: number | null;
+    readonly fingerprint?: string | null;
+    readonly metadata?: StorageBridgeMetadata;
+    readonly workspaceId?: string | null;
+    readonly sourceMetadata?: Omit<StorageBridgeSourceMetadata, "source">;
+}
+export declare class StorageBridgeEventValidationError extends Error {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+export declare function createStorageBridgeEvent<Source extends StorageBridgeSource>(input: CreateStorageBridgeEventInput<Source>): StorageBridgeEventForSource<Source>;
+export declare function createStorageBridgeSourceMetadata(source: StorageBridgeSource, metadata?: Omit<StorageBridgeSourceMetadata, "source">): StorageBridgeSourceMetadata;
+export declare function storageBridgeSourceMetadataToJson(metadata: StorageBridgeSourceMetadata): Record<string, JsonValue>;
+export declare function storageBridgeWebhookEventType(changeType: StorageBridgeChangeType): "file.created" | "file.updated" | "file.deleted";
+export declare function validateStorageBridgeEvent(value: unknown): StorageBridgeEvent;
+export declare function isStorageBridgeEvent(value: unknown): value is StorageBridgeEvent;
+export declare function buildStorageBridgeEventId(input: {
+    readonly source: StorageBridgeSource;
+    readonly changeType: StorageBridgeChangeType;
+    readonly relayfilePath: string;
+    readonly resourceId: string;
+    readonly occurredAt: string;
+    readonly fingerprint?: string | null;
+}): string;
+export declare function toIsoTimestamp(value: string | Date): string;
+//# sourceMappingURL=event.d.ts.map

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

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