@keyneom/sync-kit 0.1.1 → 0.2.0-rc.1

package/dist/sharing/change-detector.d.ts

@@ -0,0 +1,40 @@
+import type { SharingChangeDetectionResult, SharingSyncCheckpoint, SharedDatasetHead } from "./checkpoint.js";
+export type { SharedDatasetHead, SharingChangeDetectionResult, SharingNotificationEvent, SharingSyncCheckpoint, } from "./checkpoint.js";
+export type SharingChangeDetectorOptions = {
+    now?: () => Date;
+    tokenExpiresAt?: number;
+    tokenExpiringSoonMs?: number;
+};
+/**
+ * Metadata-only poll for Tier A notifications. Does not decrypt, sign, or
+ * mutate Drive state.
+ */
+export declare function detectSharingChanges(listKeyResponses: () => Promise<readonly {
+    fileId: string;
+    exchangeId: string;
+}[]>, listDatasetHeads: () => Promise<readonly SharedDatasetHead[]>, checkpoint: SharingSyncCheckpoint, options?: SharingChangeDetectorOptions): Promise<SharingChangeDetectionResult>;
+export declare class SharingChangeDetector {
+    private readonly options;
+    constructor(options: {
+        listKeyResponses: () => Promise<readonly {
+            fileId: string;
+            exchangeId: string;
+        }[]>;
+        listDatasetHeads: () => Promise<readonly SharedDatasetHead[]>;
+        tokenExpiresAt?: () => number | undefined;
+        now?: () => Date;
+        tokenExpiringSoonMs?: number;
+    });
+    detect(checkpoint: SharingSyncCheckpoint): Promise<SharingChangeDetectionResult>;
+}
+export declare function createSharingChangeDetectorFromTransport(transport: {
+    listExchanges(options?: {
+        kind?: "invitation" | "key-response";
+    }): Promise<readonly {
+        fileId: string;
+        exchangeId: string;
+        kind: string;
+    }[]>;
+    listDatasetHeads(): Promise<readonly SharedDatasetHead[]>;
+}, options?: Omit<ConstructorParameters<typeof SharingChangeDetector>[0], "listKeyResponses" | "listDatasetHeads">): SharingChangeDetector;
+//# sourceMappingURL=change-detector.d.ts.map

package/dist/sharing/change-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-detector.d.ts","sourceRoot":"","sources":["../../src/sharing/change-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAE5B,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAWzB,MAAM,MAAM,4BAA4B,GAAG;IACzC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,gBAAgB,EAAE,MAAM,OAAO,CAC7B,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAClD,EACD,gBAAgB,EAAE,MAAM,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,EAC7D,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,4BAA4B,CAAC,CAuDvC;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE;QACxB,gBAAgB,EAAE,MAAM,OAAO,CAC7B,SAAS;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,EAAE,CAClD,CAAC;QACF,gBAAgB,EAAE,MAAM,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;QAC9D,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;QAC1C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B;IAGH,MAAM,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAejF;AAED,wBAAgB,wCAAwC,CACtD,SAAS,EAAE;IACT,aAAa,CAAC,OAAO,CAAC,EAAE;QACtB,IAAI,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;KACtC,GAAG,OAAO,CACT,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAChE,CAAC;IACF,gBAAgB,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAC3D,EACD,OAAO,GAAE,IAAI,CACX,qBAAqB,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,EACtD,kBAAkB,GAAG,kBAAkB,CACnC,GACL,qBAAqB,CAYvB"}

package/dist/sharing/change-detector.js

@@ -0,0 +1,96 @@
+function datasetHeadSignature(head) {
+    return [
+        head.etag ?? "",
+        head.version ?? "",
+        head.headRevisionId ?? "",
+        head.modifiedTime ?? "",
+    ].join("|");
+}
+/**
+ * Metadata-only poll for Tier A notifications. Does not decrypt, sign, or
+ * mutate Drive state.
+ */
+export async function detectSharingChanges(listKeyResponses, listDatasetHeads, checkpoint, options = {}) {
+    const now = options.now ?? (() => new Date());
+    const events = [];
+    const tokenExpiringSoonMs = options.tokenExpiringSoonMs ?? 5 * 60_000;
+    if (options.tokenExpiresAt !== undefined) {
+        if (options.tokenExpiresAt <= now().getTime()) {
+            events.push({ kind: "token-expired" });
+            return {
+                checkpoint: { ...checkpoint, lastPollAt: now().toISOString() },
+                events,
+            };
+        }
+        if (options.tokenExpiresAt - now().getTime() <= tokenExpiringSoonMs) {
+            events.push({
+                kind: "token-expiring-soon",
+                expiresAt: new Date(options.tokenExpiresAt).toISOString(),
+            });
+        }
+    }
+    const seenResponses = new Set(checkpoint.lastSeenKeyResponseFileIds ?? []);
+    const responses = await listKeyResponses();
+    for (const response of responses) {
+        if (!seenResponses.has(response.fileId)) {
+            events.push({
+                kind: "pending-key-response",
+                exchangeId: response.exchangeId,
+                fileId: response.fileId,
+            });
+        }
+    }
+    const previousHeads = checkpoint.datasetHeads ?? {};
+    const nextHeads = {};
+    const heads = await listDatasetHeads();
+    for (const head of heads) {
+        nextHeads[head.datasetId] = head;
+        const previous = previousHeads[head.datasetId];
+        if (previous &&
+            datasetHeadSignature(previous) !== datasetHeadSignature(head)) {
+            events.push({
+                kind: "shared-dataset-changed",
+                datasetId: head.datasetId,
+                fileId: head.fileId,
+            });
+        }
+    }
+    return {
+        checkpoint: {
+            lastPollAt: now().toISOString(),
+            lastSeenKeyResponseFileIds: responses.map((response) => response.fileId),
+            datasetHeads: nextHeads,
+        },
+        events,
+    };
+}
+export class SharingChangeDetector {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    detect(checkpoint) {
+        const tokenExpiresAt = this.options.tokenExpiresAt?.();
+        return detectSharingChanges(this.options.listKeyResponses, this.options.listDatasetHeads, checkpoint, {
+            ...(this.options.now ? { now: this.options.now } : {}),
+            ...(tokenExpiresAt !== undefined ? { tokenExpiresAt } : {}),
+            ...(this.options.tokenExpiringSoonMs !== undefined
+                ? { tokenExpiringSoonMs: this.options.tokenExpiringSoonMs }
+                : {}),
+        });
+    }
+}
+export function createSharingChangeDetectorFromTransport(transport, options = {}) {
+    return new SharingChangeDetector({
+        listKeyResponses: async () => {
+            const exchanges = await transport.listExchanges({ kind: "key-response" });
+            return exchanges.map((exchange) => ({
+                fileId: exchange.fileId,
+                exchangeId: exchange.exchangeId,
+            }));
+        },
+        listDatasetHeads: () => transport.listDatasetHeads(),
+        ...options,
+    });
+}
+//# sourceMappingURL=change-detector.js.map

package/dist/sharing/change-detector.js.map

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

package/dist/sharing/checkpoint.d.ts

@@ -0,0 +1,32 @@
+export type SharedDatasetHead = {
+    datasetId: string;
+    fileId: string;
+    modifiedTime?: string;
+    version?: string;
+    headRevisionId?: string;
+    etag?: string;
+};
+export type SharingSyncCheckpoint = {
+    lastPollAt?: string;
+    lastSeenKeyResponseFileIds?: string[];
+    datasetHeads?: Record<string, SharedDatasetHead>;
+};
+export type SharingNotificationEvent = {
+    kind: "pending-key-response";
+    exchangeId: string;
+    fileId: string;
+} | {
+    kind: "shared-dataset-changed";
+    datasetId: string;
+    fileId: string;
+} | {
+    kind: "token-expiring-soon";
+    expiresAt: string;
+} | {
+    kind: "token-expired";
+};
+export type SharingChangeDetectionResult = {
+    checkpoint: SharingSyncCheckpoint;
+    events: SharingNotificationEvent[];
+};
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/sharing/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/sharing/checkpoint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,EAAE,qBAAqB,CAAC;IAClC,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACpC,CAAC"}

package/dist/sharing/checkpoint.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkpoint.js.map

package/dist/sharing/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/sharing/checkpoint.ts"],"names":[],"mappings":""}

package/dist/sharing/controller.d.ts

@@ -0,0 +1,169 @@
+import { type SharedBackupCodec, type SharingAccountBindingV1, type SharingDatasetGrantV1, type SharingInvitationV1, type SharingRole } from "./index.js";
+import type { SharedBackupStorage, SharedBackupTransport, SharedDatasetFile, SharedExchangeFile } from "./transport.js";
+import { type WebCryptoSharingIdentity } from "./web-crypto.js";
+export { IndexedDbSharedBackupRegistry } from "./registry-indexeddb.js";
+export type SharedBackupControllerCodec<T> = SharedBackupCodec<T> & {
+    merge(local: T, remote: T): T;
+    fingerprint(value: T): string;
+};
+export type SharedDatasetRegistryRecord = {
+    datasetId: string;
+    fileId?: string;
+    trustedOwnerKeyId: string;
+    lastRevisionId?: string;
+    seenRevisionIds?: string[];
+    participantPermissionIds?: Record<string, string>;
+};
+export interface SharedBackupRegistry {
+    get(datasetId: string): Promise<SharedDatasetRegistryRecord | null>;
+    set(record: SharedDatasetRegistryRecord): Promise<void>;
+    delete(datasetId: string): Promise<void>;
+}
+export declare class MemorySharedBackupRegistry implements SharedBackupRegistry {
+    private readonly records;
+    get(datasetId: string): Promise<SharedDatasetRegistryRecord | null>;
+    set(record: SharedDatasetRegistryRecord): Promise<void>;
+    delete(datasetId: string): Promise<void>;
+}
+export type SharedDatasetResult<T> = {
+    datasetId: string;
+    fileId: string;
+    revisionId: string;
+    value: T;
+    outcome: "created" | "loaded" | "updated" | "unchanged";
+};
+export type SharingInvitationResult = {
+    invitation: SharingInvitationV1;
+    invitationFileId: string;
+    drivePermissionId: string;
+};
+export type AcceptedDatasetResult = {
+    datasetId: string;
+    fileId?: string;
+    revisionId?: string;
+    permissionId?: string;
+    status: "accepted" | "failed";
+    error?: unknown;
+};
+export type RotatedDatasetResult = {
+    datasetId: string;
+    status: "rotated" | "failed";
+    revisionId?: string;
+    error?: unknown;
+};
+export type DrivePermissionReconciliationAction = {
+    kind: "granted" | "updated";
+    keyId: string;
+    permissionId: string;
+    role: "reader" | "writer";
+} | {
+    kind: "removed";
+    permissionId: string;
+} | {
+    kind: "unchanged";
+    keyId: string;
+} | {
+    kind: "skipped";
+    keyId: string;
+    reason: string;
+};
+export type DrivePermissionReconciliationResult = {
+    datasetId: string;
+    actions: DrivePermissionReconciliationAction[];
+};
+export type SharedBackupControllerOptions<T> = {
+    appId: string;
+    codec: SharedBackupControllerCodec<T>;
+    identity(): Promise<WebCryptoSharingIdentity>;
+    transport: SharedBackupTransport;
+    registry: SharedBackupRegistry;
+    crypto?: Crypto;
+    now?: () => Date;
+    randomUUID?: () => string;
+    createAccountBinding?(context: {
+        appId: string;
+        exchangeId: string;
+        sharingKeyId: string;
+    }): Promise<SharingAccountBindingV1>;
+    verifyAccountBinding?(binding: SharingAccountBindingV1, context: {
+        appId: string;
+        exchangeId: string;
+        sharingKeyId: string;
+        credentialId: string;
+    }): Promise<{
+        subject: string;
+    }>;
+    requireAccountBinding?: boolean;
+    resolveFork?(context: {
+        datasetId: string;
+        lastVerifiedRevisionId: string;
+        remoteRevisionId: string;
+        localValue: T;
+        remoteValue: T;
+    }): Promise<"merge" | "reject">;
+};
+/**
+ * Headless, backend-independent sharing orchestration. Consumers own UI,
+ * persistence, lifecycle policy, and conflict resolution.
+ */
+export declare class SharedBackupController<T> {
+    private readonly options;
+    private queue;
+    constructor(options: SharedBackupControllerOptions<T>);
+    ensureStorage(): Promise<SharedBackupStorage>;
+    listDatasets(): Promise<SharedDatasetFile[]>;
+    createDataset(datasetId: string, value: T): Promise<SharedDatasetResult<T>>;
+    loadDataset(datasetId: string): Promise<SharedDatasetResult<T>>;
+    syncDataset(datasetId: string, localValue: T): Promise<SharedDatasetResult<T>>;
+    inviteParticipant(input: {
+        emailAddress: string;
+        requestedGrants: SharingDatasetGrantV1[];
+        expiresAt?: string;
+        sendNotificationEmail?: boolean;
+        emailMessage?: string;
+        /** Consumer landing URL; folder ID is appended before the Drive notification. */
+        joinLandingUrl?: string;
+        /** Fully built join URL; must already include the app folder ID when used. */
+        joinUrl?: string;
+        appDisplayName?: string;
+    }): Promise<SharingInvitationResult>;
+    listExchanges(options?: {
+        exchangeId?: string;
+        kind?: SharedExchangeFile["kind"];
+    }): Promise<SharedExchangeFile[]>;
+    submitKeyResponse(invitationFileId: string): Promise<{
+        responseFileId: string;
+        exchangeId: string;
+    }>;
+    acceptKeyResponse(input: {
+        invitation: SharingInvitationV1;
+        responseFileId: string;
+        recipientEmailAddress: string;
+    }): Promise<AcceptedDatasetResult[]>;
+    setDatasetRole(input: {
+        datasetId: string;
+        keyId: string;
+        role: Exclude<SharingRole, "owner">;
+        emailAddress: string;
+    }): Promise<SharedDatasetResult<T>>;
+    revokeDatasetKey(input: {
+        datasetId: string;
+        keyId: string;
+    }): Promise<SharedDatasetResult<T>>;
+    rotateLocalKey(replacementIdentity: WebCryptoSharingIdentity, datasetIds: string[]): Promise<RotatedDatasetResult[]>;
+    reconcileDrivePermissions(input: {
+        datasetId: string;
+        participantEmails: Record<string, string>;
+    }): Promise<DrivePermissionReconciliationResult>;
+    private changeParticipants;
+    private readDatasetById;
+    private requiredRegistry;
+    private verifyHead;
+    private initialOwnerRecord;
+    private persistHead;
+    private crypto;
+    private cryptoOptions;
+    private serialized;
+}
+export declare function createSharedBackupController<T>(options: SharedBackupControllerOptions<T>): SharedBackupController<T>;
+//# sourceMappingURL=controller.d.ts.map

package/dist/sharing/controller.d.ts.map

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