@keyneom/sync-kit 0.1.0 → 0.2.0-rc.0

package/dist/stores/google-drive/picker.d.ts

@@ -0,0 +1,89 @@
+import type { Authorization } from "../../core/types.js";
+type PickerDocument = {
+    id?: string;
+    name?: string;
+    mimeType?: string;
+    url?: string;
+};
+type PickerResponse = {
+    action?: string;
+    docs?: PickerDocument[];
+};
+type Picker = {
+    setVisible(visible: boolean): void;
+    dispose?(): void;
+};
+type DocsView = {
+    setIncludeFolders(value: boolean): DocsView;
+    setMimeTypes(value: string): DocsView;
+    setSelectFolderEnabled(value: boolean): DocsView;
+};
+type PickerBuilder = {
+    addView(view: DocsView): PickerBuilder;
+    setAppId(appId: string): PickerBuilder;
+    setCallback(callback: (response: PickerResponse) => void): PickerBuilder;
+    setDeveloperKey(key: string): PickerBuilder;
+    setOAuthToken(token: string): PickerBuilder;
+    setOrigin(origin: string): PickerBuilder;
+    setTitle(title: string): PickerBuilder;
+    build(): Picker;
+};
+type GooglePicker = {
+    Action: {
+        PICKED: string;
+        CANCEL: string;
+    };
+    DocsView: new (viewId: string) => DocsView;
+    PickerBuilder: new () => PickerBuilder;
+    ViewId: {
+        FOLDERS: string;
+    };
+};
+type GoogleApiWindow = Window & {
+    gapi?: {
+        load(name: string, callback: {
+            callback(): void;
+            onerror(): void;
+        }): void;
+    };
+    google?: {
+        picker?: GooglePicker;
+    };
+};
+export type GoogleDrivePickedFolder = {
+    folderId: string;
+    name?: string;
+    url?: string;
+};
+export type GoogleDriveFolderPickerOptions = {
+    developerKey: string;
+    cloudProjectNumber: string;
+    origin?: string;
+    title?: string;
+    window?: GoogleApiWindow;
+    document?: Document;
+};
+/**
+ * Browser-only folder picker for granting drive.file access to a shared app
+ * folder. Loading and UI are explicit; importing this module has no effects.
+ */
+export declare class GoogleDriveFolderPicker {
+    private readonly options;
+    private scriptPromise;
+    private pickerPromise;
+    constructor(options: GoogleDriveFolderPickerOptions);
+    pickFolder(authorization: Authorization): Promise<GoogleDrivePickedFolder | null>;
+    private loadPicker;
+    private loadScript;
+    private browserWindow;
+    private browserDocument;
+}
+export type GoogleDriveOpenState = {
+    action: "open";
+    fileIds: string[];
+    resourceKeys: Record<string, string>;
+    userId?: string;
+};
+export declare function parseGoogleDriveOpenState(input: string | URLSearchParams): GoogleDriveOpenState | null;
+export {};
+//# sourceMappingURL=picker.d.ts.map

package/dist/stores/google-drive/picker.d.ts.map

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

package/dist/stores/google-drive/picker.js

@@ -0,0 +1,179 @@
+import { SyncKitError } from "../../core/errors.js";
+const PICKER_SCRIPT = "https://apis.google.com/js/api.js";
+const DRIVE_FOLDER_MIME_TYPE = "application/vnd.google-apps.folder";
+/**
+ * Browser-only folder picker for granting drive.file access to a shared app
+ * folder. Loading and UI are explicit; importing this module has no effects.
+ */
+export class GoogleDriveFolderPicker {
+    options;
+    scriptPromise = null;
+    pickerPromise = null;
+    constructor(options) {
+        this.options = options;
+        if (!options.developerKey.trim()) {
+            throw new TypeError("developerKey must not be empty.");
+        }
+        if (!options.cloudProjectNumber.trim()) {
+            throw new TypeError("cloudProjectNumber must not be empty.");
+        }
+    }
+    async pickFolder(authorization) {
+        await this.loadPicker();
+        const pickerApi = this.browserWindow().google?.picker;
+        if (!pickerApi) {
+            throw new SyncKitError("provider", "Google Picker loaded without its folder API.");
+        }
+        return new Promise((resolve, reject) => {
+            let picker;
+            const finish = (value) => {
+                picker?.dispose?.();
+                resolve(value);
+            };
+            const view = new pickerApi.DocsView(pickerApi.ViewId.FOLDERS)
+                .setIncludeFolders(true)
+                .setMimeTypes(DRIVE_FOLDER_MIME_TYPE)
+                .setSelectFolderEnabled(true);
+            try {
+                picker = new pickerApi.PickerBuilder()
+                    .addView(view)
+                    .setAppId(this.options.cloudProjectNumber)
+                    .setDeveloperKey(this.options.developerKey)
+                    .setOAuthToken(authorization.accessToken)
+                    .setOrigin(this.options.origin ?? this.browserWindow().location.origin)
+                    .setTitle(this.options.title ?? "Choose the shared app folder")
+                    .setCallback((response) => {
+                    if (response.action === pickerApi.Action.CANCEL) {
+                        finish(null);
+                        return;
+                    }
+                    if (response.action !== pickerApi.Action.PICKED)
+                        return;
+                    const document = response.docs?.[0];
+                    if (!document?.id ||
+                        (document.mimeType &&
+                            document.mimeType !== DRIVE_FOLDER_MIME_TYPE)) {
+                        reject(new SyncKitError("compatibility", "Google Picker did not return a Drive folder."));
+                        return;
+                    }
+                    finish({
+                        folderId: document.id,
+                        ...(document.name ? { name: document.name } : {}),
+                        ...(document.url ? { url: document.url } : {}),
+                    });
+                })
+                    .build();
+                picker.setVisible(true);
+            }
+            catch (error) {
+                reject(new SyncKitError("provider", "Google Picker could not be opened.", { cause: error }));
+            }
+        });
+    }
+    async loadPicker() {
+        if (this.browserWindow().google?.picker)
+            return;
+        await this.loadScript();
+        this.pickerPromise ??= new Promise((resolve, reject) => {
+            const gapi = this.browserWindow().gapi;
+            if (!gapi) {
+                reject(new SyncKitError("provider", "The Google API loader is unavailable."));
+                return;
+            }
+            gapi.load("picker", {
+                callback: () => resolve(),
+                onerror: () => {
+                    this.pickerPromise = null;
+                    reject(new SyncKitError("provider", "The Google Picker API could not be loaded."));
+                },
+            });
+        });
+        await this.pickerPromise;
+    }
+    loadScript() {
+        if (this.browserWindow().gapi)
+            return Promise.resolve();
+        if (this.scriptPromise)
+            return this.scriptPromise;
+        this.scriptPromise = new Promise((resolve, reject) => {
+            const script = this.browserDocument().createElement("script");
+            script.src = PICKER_SCRIPT;
+            script.async = true;
+            script.defer = true;
+            script.onload = () => resolve();
+            script.onerror = () => {
+                this.scriptPromise = null;
+                reject(new SyncKitError("provider", "The Google API loader could not be loaded."));
+            };
+            this.browserDocument().head.append(script);
+        });
+        return this.scriptPromise;
+    }
+    browserWindow() {
+        const value = this.options.window ??
+            (typeof window === "undefined"
+                ? undefined
+                : window);
+        if (!value) {
+            throw new SyncKitError("configuration", "Google Picker requires a browser window.");
+        }
+        return value;
+    }
+    browserDocument() {
+        const value = this.options.document ??
+            (typeof document === "undefined" ? undefined : document);
+        if (!value) {
+            throw new SyncKitError("configuration", "Google Picker requires a browser document.");
+        }
+        return value;
+    }
+}
+export function parseGoogleDriveOpenState(input) {
+    const params = typeof input === "string"
+        ? new URLSearchParams(input.startsWith("?") ? input.slice(1) : input)
+        : input;
+    const encoded = params.get("state");
+    if (!encoded)
+        return null;
+    let value;
+    try {
+        value = JSON.parse(encoded);
+    }
+    catch (error) {
+        throw new SyncKitError("compatibility", "The Google Drive Open-with state is not valid JSON.", { cause: error });
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new SyncKitError("compatibility", "The Google Drive Open-with state must be an object.");
+    }
+    const state = value;
+    if (state.action !== "open")
+        return null;
+    if (!Array.isArray(state.ids) ||
+        state.ids.length === 0 ||
+        !state.ids.every((id) => typeof id === "string" && id.length > 0)) {
+        throw new SyncKitError("compatibility", "The Google Drive Open-with state has no file IDs.");
+    }
+    const resourceKeys = {};
+    if (state.resourceKeys !== undefined) {
+        if (!state.resourceKeys ||
+            typeof state.resourceKeys !== "object" ||
+            Array.isArray(state.resourceKeys)) {
+            throw new SyncKitError("compatibility", "The Google Drive resource keys are malformed.");
+        }
+        for (const [fileId, resourceKey] of Object.entries(state.resourceKeys)) {
+            if (typeof resourceKey !== "string" || resourceKey.length === 0) {
+                throw new SyncKitError("compatibility", "A Google Drive resource key is malformed.");
+            }
+            resourceKeys[fileId] = resourceKey;
+        }
+    }
+    return {
+        action: "open",
+        fileIds: state.ids.map((id) => String(id)),
+        resourceKeys,
+        ...(typeof state.userId === "string" && state.userId
+            ? { userId: state.userId }
+            : {}),
+    };
+}
+//# sourceMappingURL=picker.js.map

package/dist/stores/google-drive/picker.js.map

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

package/dist/stores/google-drive/sharing.d.ts

@@ -0,0 +1,55 @@
+import type { Authorization, AuthorizationProvider } from "../../core/types.js";
+import { type SharedBackupEnvelopeV1, type SharingInvitationV1, type SharingPublicKeyResponseV1, type SharingRole } from "../../sharing/index.js";
+import type { SharedBackupStorage, SharedBackupTransport, SharedDatasetFile, SharedDatasetPermission, SharedExchangeFile, SharedKeyResponseFile, VersionedSharedDataset } from "../../sharing/transport.js";
+import { GoogleDriveFileStore } from "./index.js";
+export type GoogleDriveSharedBackupTransportOptions = {
+    appId: string;
+    authorizationProvider: AuthorizationProvider<Authorization>;
+    folderName?: string;
+    parentFolderId?: string;
+    selectedAppFolderId?: string;
+    drive?: GoogleDriveFileStore;
+};
+/**
+ * Backendless Google Drive implementation of the shared-backup transport.
+ * Authorization, encryption, and permission changes all happen in the client.
+ */
+export declare class GoogleDriveSharedBackupTransport implements SharedBackupTransport {
+    private readonly options;
+    private readonly drive;
+    private storagePromise;
+    constructor(options: GoogleDriveSharedBackupTransportOptions);
+    ensureStorage(): Promise<SharedBackupStorage>;
+    listDatasets(): Promise<SharedDatasetFile[]>;
+    readDataset(fileId: string): Promise<VersionedSharedDataset>;
+    createDataset(datasetId: string, envelope: SharedBackupEnvelopeV1): Promise<VersionedSharedDataset>;
+    writeDataset(current: VersionedSharedDataset, envelope: SharedBackupEnvelopeV1): Promise<VersionedSharedDataset>;
+    grantExchangeAccess(emailAddress: string, options?: {
+        sendNotificationEmail?: boolean;
+        emailMessage?: string;
+    }): Promise<{
+        drivePermissionId: string;
+        appFolderId: string;
+    }>;
+    createInvitation(invitation: SharingInvitationV1): Promise<string>;
+    createKeyResponse(response: SharingPublicKeyResponseV1): Promise<string>;
+    listExchanges(options?: {
+        exchangeId?: string;
+        kind?: SharedExchangeFile["kind"];
+    }): Promise<SharedExchangeFile[]>;
+    readInvitation(fileId: string): Promise<SharingInvitationV1>;
+    readKeyResponse(fileId: string, expectedDrivePermissionId: string): Promise<SharedKeyResponseFile>;
+    deleteExchange(fileId: string): Promise<void>;
+    setDatasetPermission(fileId: string, emailAddress: string, role: Exclude<SharingRole, "owner">, options?: {
+        existingDirectPermissionId?: string;
+        hasInheritedReadAccess?: boolean;
+    }): Promise<SharedDatasetPermission>;
+    removeDatasetPermission(fileId: string, permissionId: string): Promise<void>;
+    private ensureStorageNow;
+    private listAll;
+    private properties;
+    private assertManagedFile;
+    private assertEnvelopeDataset;
+    private authorize;
+}
+//# sourceMappingURL=sharing.d.ts.map

package/dist/stores/google-drive/sharing.d.ts.map

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

package/dist/stores/google-drive/sharing.js

@@ -0,0 +1,295 @@
+import { SyncKitError } from "../../core/errors.js";
+import { parseSharedBackupEnvelopeV1, parseSharingInvitationV1, parseSharingPublicKeyResponseV1, } from "../../sharing/index.js";
+import { assertDriveFileProvenance, ensureGoogleDriveSyncKitFolder, GoogleDriveFileStore, SYNC_KIT_APP_ID_PROPERTY, SYNC_KIT_DATASET_ID_PROPERTY, SYNC_KIT_KIND_PROPERTY, SYNC_KIT_PROTOCOL_PROPERTY, } from "./index.js";
+const SHARING_PROTOCOL = "sharing-v1";
+/**
+ * Backendless Google Drive implementation of the shared-backup transport.
+ * Authorization, encryption, and permission changes all happen in the client.
+ */
+export class GoogleDriveSharedBackupTransport {
+    options;
+    drive;
+    storagePromise = null;
+    constructor(options) {
+        this.options = options;
+        if (!options.appId.trim())
+            throw new TypeError("appId must not be empty.");
+        this.drive = options.drive ?? new GoogleDriveFileStore();
+    }
+    async ensureStorage() {
+        this.storagePromise ??= this.ensureStorageNow().catch((error) => {
+            this.storagePromise = null;
+            throw error;
+        });
+        return this.storagePromise;
+    }
+    async listDatasets() {
+        const authorization = await this.authorize();
+        const storage = await this.ensureStorage();
+        const files = await this.listAll(authorization, {
+            parentId: storage.appFolderId,
+            appProperties: this.properties("dataset"),
+        });
+        return files.map((file) => ({
+            datasetId: requiredProperty(file, SYNC_KIT_DATASET_ID_PROPERTY, "dataset"),
+            fileId: file.fileId,
+            name: file.name,
+            ...(file.capabilities?.canEdit === undefined
+                ? {}
+                : { canEdit: file.capabilities.canEdit }),
+        }));
+    }
+    async readDataset(fileId) {
+        const authorization = await this.authorize();
+        const metadata = await this.drive.get(fileId, authorization);
+        this.assertManagedFile(metadata, "dataset");
+        const datasetId = requiredProperty(metadata, SYNC_KIT_DATASET_ID_PROPERTY, "dataset");
+        const document = await this.drive.readTextVersioned(fileId, authorization);
+        const version = document.etag ?? metadata.etag;
+        if (!version) {
+            throw new SyncKitError("state", "Google Drive did not expose an ETag for the dataset; a safe conditional write is unavailable.");
+        }
+        const envelope = parseSharedBackupEnvelopeV1(document.content);
+        if (envelope.appId !== this.options.appId ||
+            envelope.backupId !== datasetId) {
+            throw new SyncKitError("compatibility", "The Drive dataset metadata does not match its encrypted envelope.");
+        }
+        return {
+            datasetId,
+            fileId,
+            name: metadata.name,
+            ...(metadata.capabilities?.canEdit === undefined
+                ? {}
+                : { canEdit: metadata.capabilities.canEdit }),
+            envelope,
+            version,
+        };
+    }
+    async createDataset(datasetId, envelope) {
+        requireNonEmpty(datasetId, "datasetId");
+        this.assertEnvelopeDataset(datasetId, envelope);
+        const authorization = await this.authorize();
+        const storage = await this.ensureStorage();
+        const fileId = await this.drive.create(`${datasetId}.sync-kit.json`, JSON.stringify(envelope), authorization, {
+            parentId: storage.appFolderId,
+            contentType: "application/json",
+            appProperties: {
+                ...this.properties("dataset"),
+                [SYNC_KIT_DATASET_ID_PROPERTY]: datasetId,
+            },
+        });
+        return this.readDataset(fileId);
+    }
+    async writeDataset(current, envelope) {
+        this.assertEnvelopeDataset(current.datasetId, envelope);
+        if (envelope.parentRevisionId !== current.envelope.revisionId) {
+            throw new SyncKitError("conflict", "The new dataset revision does not descend from the version being replaced.");
+        }
+        const authorization = await this.authorize();
+        const written = await this.drive.write(current.fileId, JSON.stringify(envelope), authorization, {
+            contentType: "application/json",
+            ifMatch: current.version,
+        });
+        if (!written.etag)
+            return this.readDataset(current.fileId);
+        return {
+            ...current,
+            envelope,
+            version: written.etag,
+        };
+    }
+    async grantExchangeAccess(emailAddress, options = {}) {
+        requireNonEmpty(emailAddress, "emailAddress");
+        const authorization = await this.authorize();
+        const storage = await this.ensureStorage();
+        const appPermissionId = await this.drive.share(storage.appFolderId, emailAddress, "reader", authorization, options);
+        const exchangePermissionId = await this.drive.share(storage.exchangesFolderId, emailAddress, "writer", authorization, { sendNotificationEmail: false });
+        if (exchangePermissionId !== appPermissionId) {
+            throw new SyncKitError("provider", "Google Drive returned inconsistent permission IDs for one account.");
+        }
+        return {
+            drivePermissionId: appPermissionId,
+            appFolderId: storage.appFolderId,
+        };
+    }
+    async createInvitation(invitation) {
+        if (invitation.appId !== this.options.appId) {
+            throw new SyncKitError("compatibility", "The invitation belongs to another application.");
+        }
+        const authorization = await this.authorize();
+        const storage = await this.ensureStorage();
+        if (invitation.appFolderId !== storage.appFolderId) {
+            throw new SyncKitError("compatibility", "The invitation references another app folder.");
+        }
+        return this.drive.create(`${invitation.exchangeId}-invitation.json`, JSON.stringify(invitation), authorization, {
+            parentId: storage.exchangesFolderId,
+            contentType: "application/json",
+            appProperties: {
+                ...this.properties("invitation"),
+                "sync-kit-exchange-id": invitation.exchangeId,
+            },
+        });
+    }
+    async createKeyResponse(response) {
+        if (response.appId !== this.options.appId) {
+            throw new SyncKitError("compatibility", "The key response belongs to another application.");
+        }
+        const authorization = await this.authorize();
+        const storage = await this.ensureStorage();
+        return this.drive.create(`${response.exchangeId}-${response.keyId}-response.json`, JSON.stringify(response), authorization, {
+            parentId: storage.exchangesFolderId,
+            contentType: "application/json",
+            appProperties: {
+                ...this.properties("key-response"),
+                "sync-kit-exchange-id": response.exchangeId,
+                "sync-kit-key-id": response.keyId,
+            },
+        });
+    }
+    async listExchanges(options = {}) {
+        const authorization = await this.authorize();
+        const storage = await this.ensureStorage();
+        const files = await this.listAll(authorization, {
+            parentId: storage.exchangesFolderId,
+            appProperties: {
+                [SYNC_KIT_APP_ID_PROPERTY]: this.options.appId,
+                [SYNC_KIT_PROTOCOL_PROPERTY]: SHARING_PROTOCOL,
+                ...(options.kind
+                    ? { [SYNC_KIT_KIND_PROPERTY]: options.kind }
+                    : {}),
+                ...(options.exchangeId
+                    ? { "sync-kit-exchange-id": options.exchangeId }
+                    : {}),
+            },
+        });
+        return files.map((file) => {
+            const kind = requiredProperty(file, SYNC_KIT_KIND_PROPERTY, "exchange");
+            if (kind !== "invitation" && kind !== "key-response") {
+                throw new SyncKitError("compatibility", "A managed exchange file has an unsupported kind.");
+            }
+            const keyId = file.appProperties?.["sync-kit-key-id"];
+            return {
+                fileId: file.fileId,
+                exchangeId: requiredProperty(file, "sync-kit-exchange-id", "exchange"),
+                kind,
+                ...(keyId ? { keyId } : {}),
+                ...(file.createdTime ? { createdTime: file.createdTime } : {}),
+            };
+        });
+    }
+    async readInvitation(fileId) {
+        const authorization = await this.authorize();
+        const metadata = await this.drive.get(fileId, authorization);
+        this.assertManagedFile(metadata, "invitation");
+        return parseSharingInvitationV1(await this.drive.readText(fileId, authorization));
+    }
+    async readKeyResponse(fileId, expectedDrivePermissionId) {
+        const authorization = await this.authorize();
+        const metadata = await this.drive.get(fileId, authorization);
+        this.assertManagedFile(metadata, "key-response");
+        assertDriveFileProvenance(metadata, {
+            permissionId: expectedDrivePermissionId,
+        });
+        const response = parseSharingPublicKeyResponseV1(await this.drive.readText(fileId, authorization));
+        return {
+            fileId,
+            response,
+            ownerPermissionId: expectedDrivePermissionId,
+        };
+    }
+    async deleteExchange(fileId) {
+        await this.drive.delete(fileId, await this.authorize());
+    }
+    async setDatasetPermission(fileId, emailAddress, role, options = {}) {
+        const driveRole = role === "viewer" ? "reader" : "writer";
+        if (options.existingDirectPermissionId) {
+            await this.drive.updatePermission(fileId, options.existingDirectPermissionId, driveRole, await this.authorize());
+            return {
+                permissionId: options.existingDirectPermissionId,
+                role: driveRole,
+            };
+        }
+        if (driveRole === "reader" && options.hasInheritedReadAccess) {
+            return { role: "reader" };
+        }
+        const permissionId = await this.drive.share(fileId, emailAddress, driveRole, await this.authorize(), { sendNotificationEmail: false });
+        return { permissionId, role: driveRole };
+    }
+    async removeDatasetPermission(fileId, permissionId) {
+        await this.drive.removePermission(fileId, permissionId, await this.authorize());
+    }
+    async ensureStorageNow() {
+        const authorization = await this.authorize();
+        const appFolderId = this.options.selectedAppFolderId ??
+            (await ensureGoogleDriveSyncKitFolder(authorization, {
+                appId: this.options.appId,
+                ...(this.options.folderName
+                    ? { folderName: this.options.folderName }
+                    : {}),
+                ...(this.options.parentFolderId
+                    ? { parentFolderId: this.options.parentFolderId }
+                    : {}),
+                drive: this.drive,
+            })).appFolderId;
+        const exchangeProperties = this.properties("exchange-folder");
+        const existing = await this.drive.list(authorization, {
+            parentId: appFolderId,
+            appProperties: exchangeProperties,
+        });
+        const exchangesFolderId = existing.files.find((file) => file.name === "exchanges")?.fileId ??
+            (await this.drive.createFolder("exchanges", authorization, {
+                parentId: appFolderId,
+                appProperties: exchangeProperties,
+                writersCanShare: false,
+            }));
+        return { appFolderId, exchangesFolderId };
+    }
+    async listAll(authorization, options) {
+        const files = [];
+        let pageToken;
+        do {
+            const page = await this.drive.list(authorization, {
+                ...options,
+                ...(pageToken ? { pageToken } : {}),
+            });
+            files.push(...page.files);
+            pageToken = page.nextPageToken;
+        } while (pageToken);
+        return files;
+    }
+    properties(kind) {
+        return {
+            [SYNC_KIT_APP_ID_PROPERTY]: this.options.appId,
+            [SYNC_KIT_PROTOCOL_PROPERTY]: SHARING_PROTOCOL,
+            [SYNC_KIT_KIND_PROPERTY]: kind,
+        };
+    }
+    assertManagedFile(file, kind) {
+        if (file.appProperties?.[SYNC_KIT_APP_ID_PROPERTY] !== this.options.appId ||
+            file.appProperties?.[SYNC_KIT_PROTOCOL_PROPERTY] !== SHARING_PROTOCOL ||
+            file.appProperties?.[SYNC_KIT_KIND_PROPERTY] !== kind) {
+            throw new SyncKitError("compatibility", `The selected Drive file is not a managed ${kind} for this application.`);
+        }
+    }
+    assertEnvelopeDataset(datasetId, envelope) {
+        if (envelope.appId !== this.options.appId ||
+            envelope.backupId !== datasetId) {
+            throw new SyncKitError("compatibility", "The shared-backup envelope belongs to another dataset.");
+        }
+    }
+    authorize() {
+        return this.options.authorizationProvider.authorize();
+    }
+}
+function requiredProperty(file, name, label) {
+    const value = file.appProperties?.[name];
+    if (!value) {
+        throw new SyncKitError("compatibility", `A managed ${label} file is missing ${name}.`);
+    }
+    return value;
+}
+function requireNonEmpty(value, name) {
+    if (!value.trim())
+        throw new TypeError(`${name} must not be empty.`);
+}
+//# sourceMappingURL=sharing.js.map