@relayfile/adapter-core 0.1.19 → 0.1.20

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

@@ -0,0 +1,178 @@
+import { createHash } from "node:crypto";
+export const STORAGE_BRIDGE_SOURCES = [
+    "google-drive",
+    "gcs",
+    "sharepoint",
+    "onedrive",
+    "azure-blob",
+    "dropbox",
+    "gmail",
+    "s3",
+    "box",
+    "postgres",
+    "redis",
+];
+export const STORAGE_BRIDGE_CHANGE_TYPES = [
+    "created",
+    "updated",
+    "deleted",
+];
+export class StorageBridgeEventValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(`Invalid StorageBridgeEvent: ${issues.join("; ")}`);
+        this.name = "StorageBridgeEventValidationError";
+        this.issues = issues;
+    }
+}
+export function createStorageBridgeEvent(input) {
+    const occurredAt = toIsoTimestamp(input.occurredAt ?? new Date());
+    const detectedAt = toIsoTimestamp(input.detectedAt ?? new Date());
+    const metadata = {
+        ...(input.metadata ?? {}),
+        ...(input.sourceMetadata
+            ? {
+                source: storageBridgeSourceMetadataToJson(createStorageBridgeSourceMetadata(input.source, input.sourceMetadata)),
+            }
+            : {}),
+    };
+    const event = {
+        eventId: input.eventId ??
+            buildStorageBridgeEventId({
+                source: input.source,
+                changeType: input.changeType,
+                relayfilePath: input.relayfilePath,
+                resourceId: input.resourceId,
+                occurredAt,
+                fingerprint: input.fingerprint ?? null,
+            }),
+        occurredAt,
+        detectedAt,
+        source: input.source,
+        changeType: input.changeType,
+        relayfilePath: input.relayfilePath,
+        resourceId: input.resourceId,
+        sizeBytes: input.sizeBytes ?? null,
+        fingerprint: input.fingerprint ?? null,
+        metadata,
+        workspaceId: input.workspaceId ?? null,
+    };
+    return validateStorageBridgeEvent(event);
+}
+export function createStorageBridgeSourceMetadata(source, metadata = {}) {
+    return compactObject({
+        source,
+        providerConfigKey: metadata.providerConfigKey,
+        accountId: metadata.accountId,
+        connectionId: metadata.connectionId,
+        subscriptionId: metadata.subscriptionId,
+        nativeEventId: metadata.nativeEventId,
+        cursor: metadata.cursor,
+        raw: metadata.raw,
+    });
+}
+export function storageBridgeSourceMetadataToJson(metadata) {
+    return compactObject({
+        source: metadata.source,
+        providerConfigKey: metadata.providerConfigKey,
+        accountId: metadata.accountId,
+        connectionId: metadata.connectionId,
+        subscriptionId: metadata.subscriptionId,
+        nativeEventId: metadata.nativeEventId,
+        cursor: metadata.cursor,
+        raw: metadata.raw,
+    });
+}
+export function storageBridgeWebhookEventType(changeType) {
+    return `file.${changeType}`;
+}
+export function validateStorageBridgeEvent(value) {
+    const issues = [];
+    if (!isRecord(value)) {
+        throw new StorageBridgeEventValidationError(["event must be an object"]);
+    }
+    requireNonEmptyString(value, "eventId", issues);
+    requireIsoTimestamp(value, "occurredAt", issues);
+    requireIsoTimestamp(value, "detectedAt", issues);
+    requireOneOf(value, "source", STORAGE_BRIDGE_SOURCES, issues);
+    requireOneOf(value, "changeType", STORAGE_BRIDGE_CHANGE_TYPES, issues);
+    requireAbsolutePath(value, "relayfilePath", issues);
+    requireNonEmptyString(value, "resourceId", issues);
+    if (value.sizeBytes !== null) {
+        if (typeof value.sizeBytes !== "number" ||
+            !Number.isFinite(value.sizeBytes) ||
+            value.sizeBytes < 0) {
+            issues.push("sizeBytes must be a non-negative number or null");
+        }
+    }
+    if (value.fingerprint !== null && typeof value.fingerprint !== "string") {
+        issues.push("fingerprint must be a string or null");
+    }
+    if (!isRecord(value.metadata)) {
+        issues.push("metadata must be an object");
+    }
+    if (value.workspaceId !== null && typeof value.workspaceId !== "string") {
+        issues.push("workspaceId must be a string or null");
+    }
+    if (issues.length > 0) {
+        throw new StorageBridgeEventValidationError(issues);
+    }
+    return value;
+}
+export function isStorageBridgeEvent(value) {
+    try {
+        validateStorageBridgeEvent(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function buildStorageBridgeEventId(input) {
+    const digest = createHash("sha256")
+        .update([
+        input.source,
+        input.changeType,
+        input.relayfilePath,
+        input.resourceId,
+        input.occurredAt,
+        input.fingerprint ?? "",
+    ].join("\0"))
+        .digest("hex")
+        .slice(0, 32);
+    return `${input.source}:${digest}`;
+}
+export function toIsoTimestamp(value) {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new StorageBridgeEventValidationError(["timestamp is not a valid date"]);
+    }
+    return date.toISOString();
+}
+function compactObject(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireNonEmptyString(value, key, issues) {
+    if (typeof value[key] !== "string" || value[key].trim() === "") {
+        issues.push(`${key} must be a non-empty string`);
+    }
+}
+function requireAbsolutePath(value, key, issues) {
+    if (typeof value[key] !== "string" || !value[key].startsWith("/")) {
+        issues.push(`${key} must be an absolute relayfile path`);
+    }
+}
+function requireIsoTimestamp(value, key, issues) {
+    if (typeof value[key] !== "string" || Number.isNaN(Date.parse(value[key]))) {
+        issues.push(`${key} must be an ISO timestamp string`);
+    }
+}
+function requireOneOf(value, key, allowed, issues) {
+    if (typeof value[key] !== "string" || !allowed.includes(value[key])) {
+        issues.push(`${key} must be one of ${allowed.join(", ")}`);
+    }
+}
+//# sourceMappingURL=event.js.map

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

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

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

@@ -0,0 +1,7 @@
+export * from "./event.js";
+export * from "./publisher.js";
+export * from "./adapter-worker.js";
+export * from "./nango-fallback.js";
+export * from "./discovery.js";
+export * from "./writeback.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage-bridge/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,7 @@
+export * from "./event.js";
+export * from "./publisher.js";
+export * from "./adapter-worker.js";
+export * from "./nango-fallback.js";
+export * from "./discovery.js";
+export * from "./writeback.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage-bridge/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/src/storage-bridge/nango-fallback.d.ts

@@ -0,0 +1,36 @@
+import { type JsonValue, type StorageBridgeEvent, type StorageBridgeSource } from "./event.js";
+export declare const NANGO_FALLBACK_PROVIDER_CONFIG_KEYS: readonly ["google-drive", "sharepoint-online", "sharepoint", "one-drive", "onedrive", "dropbox", "box", "google-mail", "gmail"];
+export type NangoFallbackProviderConfigKey = (typeof NANGO_FALLBACK_PROVIDER_CONFIG_KEYS)[number];
+export interface NangoSyncWebhookPayload {
+    readonly providerConfigKey: string;
+    readonly connectionId?: string;
+    readonly syncName?: string;
+    readonly model?: string;
+    readonly responseResults?: {
+        readonly added?: number;
+        readonly updated?: number;
+        readonly deleted?: number;
+    };
+    readonly records?: readonly NangoSyncRecord[];
+    readonly modifiedAfter?: string;
+    readonly metadata?: Record<string, JsonValue>;
+}
+export type NangoSyncRecord = Record<string, unknown>;
+export interface MapNangoSyncRecordInput {
+    readonly providerConfigKey: string;
+    readonly record: NangoSyncRecord;
+    readonly workspaceId?: string | null;
+    readonly accountId?: string;
+    readonly connectionId?: string;
+    readonly syncName?: string;
+    readonly detectedAt?: string | Date;
+}
+export declare function mapNangoProviderToSource(providerConfigKey: string): StorageBridgeSource;
+export declare function mapNangoSyncRecord(input: MapNangoSyncRecordInput): StorageBridgeEvent;
+export declare function computeResourceId(source: StorageBridgeSource, record: NangoSyncRecord): string;
+export declare function computeRelayfilePath(input: {
+    readonly source: StorageBridgeSource;
+    readonly record: NangoSyncRecord;
+    readonly accountId: string;
+}): string;
+//# sourceMappingURL=nango-fallback.d.ts.map

package/dist/src/storage-bridge/nango-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nango-fallback.d.ts","sourceRoot":"","sources":["../../../src/storage-bridge/nango-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGzB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,mCAAmC,iIAUtC,CAAC;AAEX,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,MAAM,GACxB,mBAAmB,CAoBrB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CA4DpB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,eAAe,GACtB,MAAM,CAkBR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAyCT"}

package/dist/src/storage-bridge/nango-fallback.js

@@ -0,0 +1,194 @@
+import { buildStorageBridgeEventId, createStorageBridgeEvent, } from "./event.js";
+export const NANGO_FALLBACK_PROVIDER_CONFIG_KEYS = [
+    "google-drive",
+    "sharepoint-online",
+    "sharepoint",
+    "one-drive",
+    "onedrive",
+    "dropbox",
+    "box",
+    "google-mail",
+    "gmail",
+];
+export function mapNangoProviderToSource(providerConfigKey) {
+    switch (providerConfigKey) {
+        case "google-drive":
+            return "google-drive";
+        case "sharepoint":
+        case "sharepoint-online":
+            return "sharepoint";
+        case "one-drive":
+        case "onedrive":
+            return "onedrive";
+        case "dropbox":
+            return "dropbox";
+        case "box":
+            return "box";
+        case "google-mail":
+        case "gmail":
+            return "gmail";
+        default:
+            throw new Error(`Unsupported Nango providerConfigKey "${providerConfigKey}"`);
+    }
+}
+export function mapNangoSyncRecord(input) {
+    const source = mapNangoProviderToSource(input.providerConfigKey);
+    const resourceId = computeResourceId(source, input.record);
+    const relayfilePath = computeRelayfilePath({
+        source,
+        record: input.record,
+        accountId: input.accountId ?? input.connectionId ?? "default",
+    });
+    const occurredAt = readString(input.record, "updatedAt") ??
+        readString(input.record, "updated_at") ??
+        readString(input.record, "modifiedTime") ??
+        readString(input.record, "lastModifiedDateTime") ??
+        new Date().toISOString();
+    const changeType = computeNangoChangeType(input.record);
+    const fingerprint = readString(input.record, "etag") ??
+        readString(input.record, "eTag") ??
+        readString(input.record, "rev") ??
+        readString(input.record, "sha1") ??
+        null;
+    const sizeBytes = readNumber(input.record, "size") ??
+        readNumber(input.record, "sizeBytes") ??
+        null;
+    const eventInput = {
+        eventId: buildStorageBridgeEventId({
+            source,
+            changeType,
+            relayfilePath,
+            resourceId,
+            occurredAt,
+            fingerprint,
+        }),
+        occurredAt,
+        detectedAt: input.detectedAt,
+        source,
+        changeType,
+        relayfilePath,
+        resourceId,
+        sizeBytes,
+        fingerprint,
+        workspaceId: input.workspaceId ?? null,
+        metadata: {
+            nango: toJsonObject({
+                providerConfigKey: input.providerConfigKey,
+                connectionId: input.connectionId,
+                syncName: input.syncName,
+                record: sanitizeJson(input.record),
+            }),
+        },
+        sourceMetadata: {
+            providerConfigKey: input.providerConfigKey,
+            connectionId: input.connectionId,
+            accountId: input.accountId,
+            raw: sanitizeJson(input.record),
+        },
+    };
+    return createStorageBridgeEvent(eventInput);
+}
+export function computeResourceId(source, record) {
+    const direct = readString(record, "id") ??
+        readString(record, "fileId") ??
+        readString(record, "itemId") ??
+        readString(record, "threadId") ??
+        readString(record, "messageId") ??
+        readString(record, "path_lower") ??
+        readString(record, "path") ??
+        readString(record, "name");
+    if (direct)
+        return direct;
+    const stableRecord = JSON.stringify(sanitizeJson(record));
+    if (stableRecord && stableRecord !== "{}") {
+        return `${source}:${stableRecord}`;
+    }
+    throw new Error(`Cannot compute resource id for ${source} Nango record`);
+}
+export function computeRelayfilePath(input) {
+    const { source, record, accountId } = input;
+    switch (source) {
+        case "google-drive": {
+            const id = encodeSegment(computeResourceId(source, record));
+            const filePath = readString(record, "path") ?? readString(record, "name");
+            return filePath
+                ? `/google-drive/${encodeSegment(accountId)}/${trimLeadingSlash(filePath)}`
+                : `/google-drive/${encodeSegment(accountId)}/files/${id}.json`;
+        }
+        case "sharepoint": {
+            const siteId = encodeSegment(readString(record, "siteId") ?? "default-site");
+            const driveId = encodeSegment(readString(record, "driveId") ?? "default-drive");
+            const id = encodeSegment(computeResourceId(source, record));
+            return `/sharepoint/${siteId}/${driveId}/items/${id}.json`;
+        }
+        case "onedrive": {
+            const id = encodeSegment(computeResourceId(source, record));
+            return `/onedrive/${encodeSegment(accountId)}/items/${id}.json`;
+        }
+        case "dropbox": {
+            const path = readString(record, "path_display") ??
+                readString(record, "path_lower") ??
+                readString(record, "path") ??
+                `${computeResourceId(source, record)}.json`;
+            return `/dropbox/${encodeSegment(accountId)}/files/${trimLeadingSlash(path)}`;
+        }
+        case "box": {
+            const id = encodeSegment(computeResourceId(source, record));
+            return `/box/files/${id}.json`;
+        }
+        case "gmail": {
+            const threadId = encodeSegment(readString(record, "threadId") ?? computeResourceId(source, record));
+            return `/gmail/${encodeSegment(accountId)}/threads/${threadId}.json`;
+        }
+        default:
+            throw new Error(`Nango fallback is not supported for ${source}`);
+    }
+}
+function computeNangoChangeType(record) {
+    const deleted = readBoolean(record, "deleted") ??
+        readBoolean(record, "_deleted") ??
+        readBoolean(record, "isDeleted");
+    if (deleted)
+        return "deleted";
+    const createdAt = readString(record, "createdAt") ?? readString(record, "created_at");
+    const updatedAt = readString(record, "updatedAt") ?? readString(record, "updated_at");
+    return createdAt && updatedAt && createdAt === updatedAt ? "created" : "updated";
+}
+function readString(record, key) {
+    const value = record[key];
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function readNumber(record, key) {
+    const value = record[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function readBoolean(record, key) {
+    const value = record[key];
+    return typeof value === "boolean" ? value : undefined;
+}
+function encodeSegment(segment) {
+    return encodeURIComponent(segment);
+}
+function trimLeadingSlash(path) {
+    return path.replace(/^\/+/, "");
+}
+function toJsonObject(input) {
+    return Object.fromEntries(Object.entries(input)
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => [key, sanitizeJson(value)]));
+}
+function sanitizeJson(value) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(sanitizeJson);
+    if (typeof value === "object" && value !== null) {
+        return toJsonObject(value);
+    }
+    return String(value);
+}
+//# sourceMappingURL=nango-fallback.js.map

package/dist/src/storage-bridge/nango-fallback.js.map

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

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

@@ -0,0 +1,54 @@
+import { type StorageBridgeEvent, type StorageBridgeEventForSource, type StorageBridgeSource } from "./event.js";
+export interface StorageBridgePublishResult {
+    readonly eventId: string;
+    readonly published: boolean;
+    readonly duplicate: boolean;
+}
+export interface StorageBridgeEventSubscriber {
+    (event: StorageBridgeEvent): void | Promise<void>;
+}
+export interface StorageBridgeSubscription {
+    unsubscribe(): void;
+}
+export interface StorageBridgeEventPublisher {
+    publish(event: StorageBridgeEvent): Promise<StorageBridgePublishResult>;
+    subscribe(subscriber: StorageBridgeEventSubscriber): StorageBridgeSubscription;
+}
+export interface StorageBridgeEventPublisherForSource<Source extends StorageBridgeSource> {
+    publish(event: StorageBridgeEventForSource<Source>): Promise<StorageBridgePublishResult> | StorageBridgePublishResult;
+}
+export interface IdempotencyStore {
+    claim(key: string, ttlMs?: number): Promise<boolean> | boolean;
+    release?(key: string): Promise<void> | void;
+}
+export declare class InMemoryIdempotencyStore implements IdempotencyStore {
+    private readonly seen;
+    claim(key: string, ttlMs?: number): boolean;
+    release(key: string): void;
+    clear(): void;
+    private pruneExpired;
+}
+export interface InMemoryPublisherOptions {
+    readonly idempotencyStore?: IdempotencyStore;
+    readonly idempotencyTtlMs?: number;
+    readonly onSubscriberError?: (error: unknown, event: StorageBridgeEvent) => void | Promise<void>;
+}
+export declare class InMemoryStorageBridgeEventPublisher implements StorageBridgeEventPublisher {
+    private readonly subscribers;
+    private readonly idempotencyStore;
+    private readonly idempotencyTtlMs?;
+    private readonly onSubscriberError?;
+    readonly events: StorageBridgeEvent[];
+    constructor(options?: InMemoryPublisherOptions);
+    publish(event: StorageBridgeEvent): Promise<StorageBridgePublishResult>;
+    subscribe(subscriber: StorageBridgeEventSubscriber): StorageBridgeSubscription;
+    publishUnchecked(event: StorageBridgeEvent): Promise<void>;
+}
+export interface PublishStorageBridgeEventOptions {
+    readonly idempotencyStore?: IdempotencyStore;
+    readonly idempotencyTtlMs?: number;
+    readonly idempotencyKey?: string;
+    readonly skipPublisherIdempotency?: boolean;
+}
+export declare function publishStorageBridgeEvent(publisher: StorageBridgeEventPublisher, event: StorageBridgeEvent, options?: PublishStorageBridgeEventOptions): Promise<StorageBridgePublishResult>;
+//# sourceMappingURL=publisher.d.ts.map

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

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

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

@@ -0,0 +1,90 @@
+import { validateStorageBridgeEvent, } from "./event.js";
+export class InMemoryIdempotencyStore {
+    seen = new Map();
+    claim(key, ttlMs) {
+        this.pruneExpired();
+        if (this.seen.has(key))
+            return false;
+        this.seen.set(key, ttlMs ? Date.now() + ttlMs : Number.POSITIVE_INFINITY);
+        return true;
+    }
+    release(key) {
+        this.seen.delete(key);
+    }
+    clear() {
+        this.seen.clear();
+    }
+    pruneExpired() {
+        const now = Date.now();
+        for (const [key, expiresAt] of this.seen) {
+            if (expiresAt <= now)
+                this.seen.delete(key);
+        }
+    }
+}
+export class InMemoryStorageBridgeEventPublisher {
+    subscribers = new Set();
+    idempotencyStore;
+    idempotencyTtlMs;
+    onSubscriberError;
+    events = [];
+    constructor(options = {}) {
+        this.idempotencyStore =
+            options.idempotencyStore ?? new InMemoryIdempotencyStore();
+        this.idempotencyTtlMs = options.idempotencyTtlMs;
+        this.onSubscriberError = options.onSubscriberError;
+    }
+    async publish(event) {
+        return publishStorageBridgeEvent(this, event, {
+            idempotencyStore: this.idempotencyStore,
+            idempotencyTtlMs: this.idempotencyTtlMs,
+            skipPublisherIdempotency: true,
+        });
+    }
+    subscribe(subscriber) {
+        this.subscribers.add(subscriber);
+        return {
+            unsubscribe: () => {
+                this.subscribers.delete(subscriber);
+            },
+        };
+    }
+    async publishUnchecked(event) {
+        this.events.push(event);
+        await Promise.all([...this.subscribers].map(async (subscriber) => {
+            try {
+                await subscriber(event);
+            }
+            catch (error) {
+                await this.onSubscriberError?.(error, event);
+            }
+        }));
+    }
+}
+export async function publishStorageBridgeEvent(publisher, event, options = {}) {
+    const validEvent = validateStorageBridgeEvent(event);
+    const key = options.idempotencyKey ?? `storage-bridge:publish:${validEvent.eventId}`;
+    if (options.idempotencyStore) {
+        const claimed = await options.idempotencyStore.claim(key, options.idempotencyTtlMs);
+        if (!claimed) {
+            return {
+                eventId: validEvent.eventId,
+                published: false,
+                duplicate: true,
+            };
+        }
+    }
+    if (options.skipPublisherIdempotency &&
+        publisher instanceof InMemoryStorageBridgeEventPublisher) {
+        await publisher.publishUnchecked(validEvent);
+    }
+    else {
+        await publisher.publish(validEvent);
+    }
+    return {
+        eventId: validEvent.eventId,
+        published: true,
+        duplicate: false,
+    };
+}
+//# sourceMappingURL=publisher.js.map

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

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