@mdbase-dev/connect 0.1.0-beta.31 → 0.1.0-beta.33

package/dist/files.js

@@ -2,48 +2,55 @@ import { FILE_PROTOCOL_VERSION } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnectError, connectError } from "./errors.js";
 import { IncrementalSha256 } from "./file-sha256.js";
 import { BinaryPartReader } from "./file-stream-source.js";
-const HASH_CHUNK_BYTES = 1024 * 1024;
-const DEFAULT_CONCURRENCY = 4;
-const MAX_CONCURRENCY = 8;
-const MAX_OBJECT_ATTEMPTS = 3;
-const MAX_BUFFERED_DOWNLOAD_BYTES = 64 * 1024 * 1024;
-const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
-const SHA256_DIGEST = /^sha256:[0-9a-f]{64}$/u;
+import { MAX_BUFFERED_DOWNLOAD_BYTES, MAX_OBJECT_ATTEMPTS, SHA256_DIGEST, UUID, browserObjectHeaders, chunkLength, hashBlob, mapConcurrent, normalizeFileError, requirePreparedPart, requireTransferSession, requireTransferStatus, retryChunk, sourceBlob, throwIfAborted, uploadBodyBytes, uploadBodyLength, validConcurrency, validPageSize } from "./file-transfer-internals.js";
+import { createRequestBudget, resolveConnectTimeouts, withCooperativeRequestBudget } from "./request-budget.js";
 /** Ergonomic facade over resumable, authority-specific file delivery. */
 export class MdbaseFileClient {
     capability;
     request;
     framed;
     hosted;
-    constructor(capability, request, framed, hosted) {
+    timeouts;
+    constructor(capability, request, framed, hosted, timeouts = resolveConnectTimeouts()) {
         this.capability = capability;
         this.request = request;
         this.framed = framed;
         this.hosted = hosted;
+        this.timeouts = timeouts;
     }
     async *list(options = {}) {
-        this.requireAction("list");
-        let after;
-        do {
-            throwIfAborted(options.signal);
-            const query = new URLSearchParams({
-                protocol_version: String(FILE_PROTOCOL_VERSION),
-                ...(options.folder ? { folder: options.folder } : {}),
-                ...(after ? { after } : {}),
-                ...(options.pageSize ? { limit: String(validPageSize(options.pageSize)) } : {})
-            });
-            const page = await this.request("GET", `?${query.toString()}`, undefined, options.signal);
-            if (page.protocol_version !== 1 || page.type !== "files_page" || !Array.isArray(page.files)) {
-                throw connectError("invalid_operation_response", "The authority returned an invalid file page.");
-            }
-            for (const file of page.files) {
-                throwIfAborted(options.signal);
-                yield file;
-            }
-            after = page.next;
-        } while (after);
+        const budget = createRequestBudget(options, this.timeouts.requestMs);
+        const signal = budget.signal;
+        try {
+            this.requireAction("list");
+            let after;
+            do {
+                throwIfAborted(signal);
+                const query = new URLSearchParams({
+                    protocol_version: String(FILE_PROTOCOL_VERSION),
+                    ...(options.folder ? { folder: options.folder } : {}),
+                    ...(after ? { after } : {}),
+                    ...(options.pageSize ? { limit: String(validPageSize(options.pageSize)) } : {})
+                });
+                const page = await this.request("GET", `?${query.toString()}`, undefined, signal);
+                if (page.protocol_version !== 1 || page.type !== "files_page" || !Array.isArray(page.files)) {
+                    throw connectError("invalid_operation_response", "The authority returned an invalid file page.");
+                }
+                for (const file of page.files) {
+                    throwIfAborted(signal);
+                    yield clientFileDescriptor(file);
+                }
+                after = page.next;
+            } while (after);
+        }
+        finally {
+            budget.dispose();
+        }
     }
     async upload(path, source, options = {}) {
+        return withCooperativeRequestBudget(options, this.timeouts.uploadMs, (budget) => this.uploadWithinBudget(path, source, { ...options, signal: budget.signal, timeoutMs: null }));
+    }
+    async uploadWithinBudget(path, source, options) {
         this.requireAction(options.ifRevision ? "replace" : "add");
         const blob = sourceBlob(source, options.mediaType);
         const concurrency = validConcurrency(options.concurrency);
@@ -63,6 +70,13 @@ export class MdbaseFileClient {
      * Reuse `transferId` with a newly opened source after an ambiguous failure.
      */
     async uploadStream(path, source, options = {}) {
+        return withCooperativeRequestBudget(options, this.timeouts.uploadMs, (budget) => this.uploadStreamWithinBudget(path, source, {
+            ...options,
+            signal: budget.signal,
+            timeoutMs: null
+        }));
+    }
+    async uploadStreamWithinBudget(path, source, options) {
         this.requireAction(options.ifRevision ? "replace" : "add");
         if (!Number.isSafeInteger(source.size) || source.size < 0) {
             throw connectError("invalid_request", "Streamed file size must be a non-negative safe integer.");
@@ -116,16 +130,21 @@ export class MdbaseFileClient {
             const partCount = session.strategy.kind === "object_put"
                 ? 1
                 : Math.ceil(size / partSize);
+            const status = await this.request("GET", `transfers/${encodeURIComponent(transferId)}`, undefined, options.signal);
+            requireTransferStatus(status, session);
+            if (status.state !== "open" && status.state !== "committed") {
+                throw connectError("invalid_operation_response", `The authority cannot resume a ${status.state} file transfer.`);
+            }
             prepareSource?.(partSize);
-            if (!framed && session.received.length === partCount) {
-                const replay = await this.tryReplayUploadCommit(transferId, session.strategy.kind === "object_multipart" ? session.uploaded_parts : undefined, options.signal);
+            if (!framed && status.received.length === partCount) {
+                const replay = await this.tryReplayUploadCommit(transferId, session.strategy.kind === "object_multipart" ? status.uploaded_parts : undefined, options.signal);
                 if (replay) {
                     committed = true;
-                    return replay.file;
+                    return clientFileDescriptor(replay.file);
                 }
             }
-            const received = new Set(session.received);
-            const uploadedParts = new Map((session.uploaded_parts ?? []).map((part) => [part.part_number - 1, part]));
+            const received = new Set(status.received);
+            const uploadedParts = new Map(status.uploaded_parts.map((part) => [part.part_number - 1, part]));
             let transferredBytes = [...received].reduce((total, index) => total + chunkLength(size, partSize, index), 0);
             const parts = await mapConcurrent(partCount, concurrency, async (partIndex) => {
                 const offset = partIndex * partSize;
@@ -160,7 +179,7 @@ export class MdbaseFileClient {
                 throw connectError("invalid_operation_response", "The authority returned an invalid file receipt.");
             }
             committed = true;
-            return receipt.file;
+            return clientFileDescriptor(receipt.file);
         }
         catch (error) {
             throw normalizeFileError(error);
@@ -188,10 +207,13 @@ export class MdbaseFileClient {
             const copy = new Uint8Array(chunk.byteLength);
             copy.set(chunk);
             return copy.buffer;
-        }), { type: file.media_type ?? "" });
+        }), { type: file.mediaType ?? "" });
     }
     /** Download and verify a file with network backpressure and bounded buffering. */
     async downloadStream(file, options = {}) {
+        return withCooperativeRequestBudget(options, this.timeouts.requestMs, (budget) => this.openDownloadStream(file, options, budget.signal));
+    }
+    async openDownloadStream(file, options, startupSignal) {
         this.requireAction("read");
         validConcurrency(options.concurrency);
         const transferId = crypto.randomUUID();
@@ -201,9 +223,9 @@ export class MdbaseFileClient {
                 protocol_version: FILE_PROTOCOL_VERSION,
                 type: "open_file_download",
                 transfer_id: transferId,
-                file_id: file.file_id,
+                file_id: file.fileId,
                 revision: file.revision
-            }, options.signal);
+            }, startupSignal);
             requireTransferSession(session, transferId, "download");
             if (session.total_size !== file.size
                 || session.strategy.kind !== "object_ranges"
@@ -240,7 +262,7 @@ export class MdbaseFileClient {
             await this.abort(transferId);
         };
         const verify = () => {
-            if (receivedBytes !== file.size || `sha256:${hash.digestHex()}` !== file.content_digest) {
+            if (receivedBytes !== file.size || `sha256:${hash.digestHex()}` !== file.contentDigest) {
                 throw connectError("invalid_operation_response", "Downloaded file bytes failed integrity verification.");
             }
         };
@@ -333,15 +355,18 @@ export class MdbaseFileClient {
         return new Uint8Array(await (await this.download(file, options)).arrayBuffer());
     }
     async move(file, path, options = {}) {
+        return withCooperativeRequestBudget(options, this.timeouts.requestMs, (budget) => this.moveWithinBudget(file, path, { ...options, signal: budget.signal, timeoutMs: null }));
+    }
+    async moveWithinBudget(file, path, options) {
         this.requireAction("move");
         const mutationId = options.mutationId ?? crypto.randomUUID();
         let receipt;
         try {
-            receipt = await this.request("POST", `${encodeURIComponent(file.file_id)}/move`, {
+            receipt = await this.request("POST", `${encodeURIComponent(file.fileId)}/move`, {
                 protocol_version: FILE_PROTOCOL_VERSION,
                 type: "move_file",
                 mutation_id: mutationId,
-                file_id: file.file_id,
+                file_id: file.fileId,
                 if_revision: options.ifRevision ?? file.revision,
                 from_path: file.path,
                 path,
@@ -356,22 +381,25 @@ export class MdbaseFileClient {
         if (receipt.protocol_version !== 1
             || receipt.type !== "file_moved"
             || receipt.mutation_id !== mutationId
-            || receipt.file.file_id !== file.file_id
+            || receipt.file.file_id !== file.fileId
             || receipt.file.path !== path) {
             throw connectError("invalid_operation_response", "The authority returned an invalid file move receipt.");
         }
-        return receipt.file;
+        return clientFileDescriptor(receipt.file);
     }
     async delete(file, options = {}) {
+        return withCooperativeRequestBudget(options, this.timeouts.requestMs, (budget) => this.deleteWithinBudget(file, { ...options, signal: budget.signal, timeoutMs: null }));
+    }
+    async deleteWithinBudget(file, options) {
         this.requireAction("delete");
         const mutationId = options.mutationId ?? crypto.randomUUID();
         let receipt;
         try {
-            receipt = await this.request("POST", `${encodeURIComponent(file.file_id)}/delete`, {
+            receipt = await this.request("POST", `${encodeURIComponent(file.fileId)}/delete`, {
                 protocol_version: FILE_PROTOCOL_VERSION,
                 type: "delete_file",
                 mutation_id: mutationId,
-                file_id: file.file_id,
+                file_id: file.fileId,
                 if_revision: options.ifRevision ?? file.revision,
                 path: file.path
             }, options.signal);
@@ -382,11 +410,18 @@ export class MdbaseFileClient {
         if (receipt.protocol_version !== 1
             || receipt.type !== "file_deleted"
             || receipt.mutation_id !== mutationId
-            || receipt.file_id !== file.file_id
+            || receipt.file_id !== file.fileId
             || receipt.previous_path !== file.path) {
             throw connectError("invalid_operation_response", "The authority returned an invalid file delete receipt.");
         }
-        return receipt;
+        return {
+            protocolVersion: receipt.protocol_version,
+            type: receipt.type,
+            mutationId: receipt.mutation_id,
+            fileId: receipt.file_id,
+            previousPath: receipt.previous_path,
+            revision: receipt.revision
+        };
     }
     async uploadPart(transferId, partIndex, offset, body, contentLength, requireEtag, signal) {
         for (let attempt = 1; attempt <= MAX_OBJECT_ATTEMPTS; attempt += 1) {
@@ -465,180 +500,15 @@ export class MdbaseFileClient {
         await this.request("DELETE", `transfers/${encodeURIComponent(transferId)}`).catch(() => undefined);
     }
 }
-async function hashBlob(blob, signal, progress) {
-    const hash = new IncrementalSha256();
-    for (let offset = 0; offset < blob.size; offset += HASH_CHUNK_BYTES) {
-        throwIfAborted(signal);
-        const chunk = new Uint8Array(await blob.slice(offset, offset + HASH_CHUNK_BYTES).arrayBuffer());
-        hash.update(chunk);
-        progress(Math.min(blob.size, offset + chunk.byteLength));
-    }
-    if (blob.size === 0)
-        progress(0);
-    return hash.digestHex();
-}
-function sourceBlob(source, mediaType) {
-    if (source instanceof Blob) {
-        return mediaType && mediaType !== source.type
-            ? source.slice(0, source.size, mediaType)
-            : source;
-    }
-    if (source instanceof ArrayBuffer)
-        return new Blob([source], { type: mediaType });
-    const copy = new Uint8Array(source.byteLength);
-    copy.set(new Uint8Array(source.buffer, source.byteOffset, source.byteLength));
-    return new Blob([copy.buffer], { type: mediaType });
-}
-function uploadBodyLength(body) {
-    return body instanceof Blob ? body.size : body.byteLength;
-}
-async function uploadBodyBytes(body) {
-    return body instanceof Blob
-        ? new Uint8Array(await body.arrayBuffer())
-        : body;
-}
-function validConcurrency(value = DEFAULT_CONCURRENCY) {
-    if (!Number.isInteger(value) || value < 1 || value > MAX_CONCURRENCY) {
-        throw connectError("invalid_request", `File concurrency must be between 1 and ${MAX_CONCURRENCY}.`);
-    }
-    return value;
-}
-function validPageSize(value) {
-    if (!Number.isInteger(value) || value < 1 || value > 1_000) {
-        throw connectError("invalid_request", "File page size must be between 1 and 1000.");
-    }
-    return value;
-}
-function requireTransferSession(session, transferId, direction) {
-    if (session.protocol_version !== 1
-        || session.type !== "file_transfer"
-        || session.transfer_id !== transferId
-        || session.direction !== direction
-        || !Number.isSafeInteger(session.total_size)
-        || session.total_size < 0
-        || !Array.isArray(session.received)
-        || !validTransferStrategy(session)) {
-        throw connectError("invalid_operation_response", "The authority returned an invalid file transfer session.");
-    }
-    const partSize = session.strategy.kind === "framed_chunks"
-        ? session.strategy.chunk_size
-        : session.strategy.kind === "object_put"
-            ? Math.max(1, session.total_size)
-            : session.strategy.part_size;
-    const partCount = session.strategy.kind === "object_put"
-        ? 1
-        : Math.ceil(session.total_size / partSize);
-    if (new Set(session.received).size !== session.received.length
-        || session.received.some((index) => !Number.isSafeInteger(index) || index < 0 || index >= partCount)) {
-        throw connectError("invalid_operation_response", "The authority returned invalid transfer progress.");
-    }
-    const uploadedParts = session.uploaded_parts ?? [];
-    if (!Array.isArray(uploadedParts)
-        || uploadedParts.some((part, index) => !Number.isSafeInteger(part?.part_number)
-            || part.part_number < 1
-            || part.part_number > partCount
-            || typeof part.etag !== "string"
-            || part.etag.length === 0
-            || part.etag.length > 255
-            || (index > 0 && uploadedParts[index - 1].part_number >= part.part_number))
-        || (session.strategy.kind === "object_multipart"
-            ? uploadedParts.length !== session.received.length
-                || uploadedParts.some((part, index) => part.part_number - 1 !== session.received[index])
-            : uploadedParts.length !== 0)) {
-        throw connectError("invalid_operation_response", "The authority returned invalid uploaded part receipts.");
-    }
-}
-function validTransferStrategy(session) {
-    if (session.strategy.kind === "framed_chunks") {
-        return session.protection === "grant_aead_v1"
-            && Number.isSafeInteger(session.strategy.chunk_size)
-            && session.strategy.chunk_size > 0;
-    }
-    if (session.protection !== "transport_tls")
-        return false;
-    if (session.strategy.kind === "object_put")
-        return true;
-    return Number.isSafeInteger(session.strategy.part_size) && session.strategy.part_size > 0;
-}
-function chunkLength(totalSize, partSize, index) {
-    return Math.min(partSize, Math.max(0, totalSize - index * partSize));
-}
-async function retryChunk(work, signal) {
-    for (let attempt = 1; attempt <= MAX_OBJECT_ATTEMPTS; attempt += 1) {
-        throwIfAborted(signal);
-        try {
-            return await work();
-        }
-        catch (error) {
-            if (signal?.aborted || attempt === MAX_OBJECT_ATTEMPTS)
-                throw error;
-        }
-    }
-    throw new Error("Unreachable file chunk retry state.");
-}
-function requirePreparedPart(part, transferId, partIndex, offset, contentLength, method) {
-    let url;
-    try {
-        url = new URL(part.url);
-    }
-    catch {
-        throw connectError("invalid_operation_response", "The authority returned an invalid object URL.");
-    }
-    if (part.protocol_version !== 1
-        || part.type !== "file_part"
-        || part.transfer_id !== transferId
-        || part.part_index !== partIndex
-        || part.offset !== offset
-        || part.content_length !== contentLength
-        || part.method.toUpperCase() !== method
-        || url.protocol !== "https:"
-            && !(url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]", "::1"].includes(url.hostname))
-        || url.username
-        || url.password) {
-        throw connectError("invalid_operation_response", "The authority returned an invalid prepared file part.");
-    }
-}
-function browserObjectHeaders(headers) {
-    const result = new Headers();
-    for (const [name, value] of Object.entries(headers)) {
-        if (["host", "content-length"].includes(name.toLowerCase()))
-            continue;
-        result.set(name, value);
-    }
-    return result;
-}
-async function mapConcurrent(count, concurrency, work) {
-    const results = new Array(count);
-    let next = 0;
-    await Promise.all(Array.from({ length: Math.min(count, concurrency) }, async () => {
-        while (next < count) {
-            const index = next;
-            next += 1;
-            results[index] = await work(index);
-        }
-    }));
-    return results;
-}
-function throwIfAborted(signal) {
-    if (signal?.aborted) {
-        throw connectError("operation_cancelled", "The file transfer was cancelled.", {
-            operationOutcome: "not_sent",
-            cause: signal.reason
-        });
-    }
-}
-function normalizeFileError(error) {
-    if (error instanceof MdbaseConnectError)
-        return error;
-    if (typeof DOMException !== "undefined"
-        && error instanceof DOMException
-        && error.name === "AbortError") {
-        return connectError("operation_cancelled", "The file transfer was cancelled.", {
-            operationOutcome: "not_sent",
-            cause: error
-        });
-    }
-    return connectError("temporarily_unavailable", "The file transfer could not be completed.", {
-        cause: error
-    });
+function clientFileDescriptor(file) {
+    return {
+        fileId: file.file_id,
+        path: file.path,
+        revision: file.revision,
+        contentDigest: file.content_digest,
+        size: file.size,
+        ...(file.media_type ? { mediaType: file.media_type } : {}),
+        mediaClass: file.media_class,
+        modifiedAt: file.modified_at
+    };
 }

package/dist/hosted-file-request.js

@@ -1,5 +1,5 @@
 import { connectError } from "./errors.js";
-import { apiError } from "./runtime-utils.js";
+import { apiError, decodeJsonResponse } from "./runtime-utils.js";
 export async function sendHostedFileRequest(token, method, path, input, signal, proofHeaders) {
     if (!token.authority) {
         throw connectError("not_remote_authority", "This authorization has no remote authority endpoint.");
@@ -30,7 +30,7 @@ export async function performHostedFileRequest(token, method, path, input, signa
         }
         response = await sendHostedFileRequest(active, method, path, input, signal, proofHeaders);
     }
-    const body = await response.json().catch(() => ({}));
+    const body = await decodeJsonResponse(response, "invalid_operation_response", "The hosted authority returned an invalid file response.");
     if (!response.ok) {
         throw apiError(body, "operation_failed", "Collection file request failed.", response.status);
     }
@@ -47,7 +47,7 @@ export async function performHostedFilePartRequest(token, path, expectedLength,
         response = await sendHostedFileRequest(active, "GET", path, undefined, signal, proofHeaders);
     }
     if (!response.ok) {
-        const body = await response.json().catch(() => ({}));
+        const body = await decodeJsonResponse(response, "invalid_operation_response", "The hosted authority returned an invalid file range error response.");
         throw apiError(body, "operation_failed", "Collection file range request failed.", response.status);
     }
     const contentLength = response.headers.get("content-length");

package/dist/index.d.ts

@@ -1,20 +1,25 @@
-export { decryptRelayResponse, encryptRelayRequest, IndexedDbGrantKeyStore, MemoryGrantKeyStore, RelayCryptoError, type RelayBinding, type GrantKeyRecord, type GrantKeyStore } from "./crypto.js";
-export { FileTransferCryptoError, GrantFileTransferCipher, type FileTransferBinding } from "./file-crypto.js";
-export { ApplicationIdentityStoreError, IndexedDbApplicationIdentityStore, MemoryApplicationIdentityStore, applicationInstallationId, authorizationSigningMessage, signApplicationAuthorization, type ApplicationIdentity, type ApplicationIdentityStore } from "./application-identity.js";
-export * from "./authorization-types.js";
-export * from "./application-session.js";
-export * from "./collection-client.js";
-export * from "./connect-options.js";
-export * from "./mdbase-connect.js";
-export * from "./connection.js";
-export * from "./connection-types.js";
-export * from "./capabilities.js";
-export * from "./errors.js";
-export * from "./files.js";
-export * from "./notifications.js";
-export * from "./outcomes.js";
-export * from "./operation-types.js";
-export * from "./selection.js";
+export type { MdbaseDeviceAuthorization } from "./authorization-types.js";
+export { MdbaseApplicationSession, MdbaseMemoryVerificationStore } from "./application-session.js";
+export type { MdbaseApplicationSessionOptions, MdbaseApplicationVerificationStore, MdbaseDefinitionUpdate, MdbaseCollectionSetupUpdate, MdbaseApplicationSessionSnapshot } from "./application-session.js";
+export type { MdbaseConnectOptions, MdbaseConnectTimeouts, MdbaseFrontmatter } from "./connect-options.js";
+export { MdbaseConnect } from "./mdbase-connect.js";
+export { MdbaseConnection } from "./connection.js";
+export type { MdbaseAuthorizationTarget, MdbaseAuthorizeOptions, MdbaseConnectionAuthorizeOptions, MdbaseConnectEnvironment, MdbaseAuthorizationResult, MdbaseAuthorizationOutcome } from "./connection.js";
+export type { MdbaseConnectionRoute, DirectAccessStatus, MdbaseConnectionInfo, MdbaseAuthorizationCapabilities, MdbaseSyncTransport, MdbaseSyncConnection } from "./connection-types.js";
+export { effectiveCapabilities } from "./capabilities.js";
+export type { MdbaseCapabilityState, MdbaseCapabilityEvidence, MdbaseEffectiveCapability, MdbaseEffectiveCapabilities } from "./capabilities.js";
+export { MdbaseConnectError, isRetryableConnectError } from "./errors.js";
+export type { ConnectErrorContext } from "./errors.js";
+export { MdbaseFileClient } from "./files.js";
+export type { MdbaseFileSource, CollectionFileDescriptor, MdbaseFileDeleteReceipt, MdbaseFileStreamSource, MdbaseFileProgress, MdbaseFileListOptions, MdbaseFileUploadOptions, MdbaseFileStreamUploadOptions, MdbaseFileDownloadOptions, MdbaseFileMoveOptions, MdbaseFileDeleteOptions } from "./files.js";
+export { parseMdbasePushPayload, parseMdbaseNativeNotificationData, showMdbasePushNotification } from "./notifications.js";
+export type { MdbaseNotificationRegistrationOptions, MdbaseNotificationRegistration, MdbaseNativeNotificationRegistrationOptions, MdbaseNativeNotificationRegistration, MdbaseNativeNotificationData, MdbasePushPayload } from "./notifications.js";
+export type { ConnectSuccess, ConnectFailure, ConnectOutcome, CommonOperationProblemCode, RegistrationProblemCode, AuthorizationProblemCode, NotificationProblemCode, DirectAccessProblemCode, SessionProblemCode, CollectionSetupProblemCode, CollectionDescriptionProblemCode, CollectionReadProblemCode, CollectionQueryProblemCode, CollectionMutationProblemCode, CollectionChangesProblemCode, CollectionTypeProblemCode } from "./outcomes.js";
+export type { MdbaseDesiredTimer, MdbaseTimer, MdbaseTimerList, MdbaseTimerReconciliation, ReadInput, DataContractSelector, CollectionFileMetadata, DataContractViewIdentity, QueryRecord, RecordDocument, QueryInput, QueryProjection, QuerySelectionExpression, QueryOrder, QuerySummary, QueryResult, QueryPagesOptions, QueryAllOptions, QueryPage, ConnectRequestOptions, MutationEstimate, MutationProgressState, MutationProgress, MutationProgressOptions, RenameProgressOptions, DeleteProgressOptions, PendingMutationSummary, PendingMutation, CreateInput, UpdateInput, DeleteInput, DeleteResult, DeletePreflightResult, RenameInput, RenameResult, RenamePreflightResult, ReadTypeInput, CreateTypeInput, UpdateTypeInput, ReadViewSourceInput, CreateViewSourceInput, UpdateViewSourceInput, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, SavedViewPresentation, SavedViewSource, SavedViewProperty, SavedNamedView, SavedViewDocument, SavedViewList, SavedViewSourceDocument, SavedViewExecution, ContractSetupChoice, TypePackResourceDiff, TypePackReceipt, TypePackAssessment, TypePackApplyResult, ConfigurationContributionValue, ConfigurationRequirement, ConfigurationProvision, ApplicationCollectionSetupRequirements, ApplicationCollectionSetupProvisions, ConfigurationSetupConflict, ConfigurationSetupAssessment, CollectionSetupAssessment, CollectionSetupReceipt, CollectionSetupApplyResult, AssessTypePackInput, ApplyTypePackInput, AssessCollectionSetupInput, ApplyCollectionSetupInput, ChangesInput, WatchOptions, WatchRetryOptions, WatchStatus, WatchInput, MdbaseWatchSubscription, CollectionChange, CollectionChangesPage, CollectionDescription, CollectionContractDescriptor, CollectionContractImplementationDescriptor, CollectionTypeDescriptor } from "./operation-types.js";
+export { externalStore } from "./external-store.js";
+export type { MdbaseExternalStore } from "./external-store.js";
+export { MdbaseBrowserSelection, MdbaseMemorySelection } from "./selection.js";
+export type { MdbaseSelectionHistory, MdbaseApplicationSelection, MdbaseBrowserSelectionOptions } from "./selection.js";
 export type { MdbaseUnavailableReason } from "./session.js";
-export { createPkce } from "./runtime-utils.js";
-export type { ApplicationProvisions, ApplicationCapabilityId, ApplicationCapabilityRequirements, ApplicationRequirements, ApplicationNotifications, ApplicationAuthorizationBinding, ApplicationAuthorizationProof, CollectionChange, CollectionChangesPage, CollectionContractDescriptor, CollectionDescription, CollectionFileMetadata, FileAction, CollectionOperation as MdbaseOperation, CollectionTypeDescriptor, CollectionTypeDocument, ConnectOperationOutcome, ConnectProblem, ConnectProblemCategory, ConnectProblemCode, ConnectProblemDetailsByCode, ConnectRecoveryAction, ContractRequirement, DataContractViewIdentity, GrantScope, JsonObject, MdbaseAppManifest, NotificationCriterion, MdbaseDiagnostic, MdbaseOperationEnvelope, KnownConnectProblem, RecordDocument, QueryRecord, SavedNamedView, SavedViewDocument, SavedViewExecution, SavedViewList, SavedViewPresentation, SavedViewProperty, SavedViewSource, SavedViewSourceDocument, ReadViewSourceInput, CreateViewSourceInput, UpdateViewSourceInput, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, TypePackManifest, TypePackManifestResource, TypePackApplyResult, TypePackAssessment, TypePackReceipt, AssessTypePackInput, ApplyTypePackInput, TypePackProvision, TypePackResourceDiff, TypePackSourceResource, UnknownConnectProblem } from "@mdbase-dev/connect-protocol";
+export { MDBASE_RECORD_CREATED_CONTRACT, MDBASE_TIMER_FIRED_CONTRACT, operationsForApplicationCapabilities } from "@mdbase-dev/connect-protocol";
+export type { ApplicationProvisions, ApplicationCapabilityId, ApplicationCapabilityRequirements, ApplicationRequirements, ApplicationNotifications, ApplicationAuthorizationBinding, ApplicationAuthorizationProof, FileAction, FileCapability, CollectionOperation as MdbaseOperation, CollectionTypeDocument, ConnectOperationOutcome, ConnectProblem, ConnectProblemCategory, ConnectProblemCode, ConnectProblemDetailsByCode, ConnectRecoveryAction, ContractRequirement, GrantScope, JsonObject, MdbaseAppManifest, NotificationCriterion, MdbaseDiagnostic, MdbaseOperationEnvelope, KnownConnectProblem, TypePackManifest, TypePackManifestResource, TypePackProvision, TypePackSourceResource, UnknownConnectProblem } from "@mdbase-dev/connect-protocol";

package/dist/index.js

@@ -1,18 +1,10 @@
-export { decryptRelayResponse, encryptRelayRequest, IndexedDbGrantKeyStore, MemoryGrantKeyStore, RelayCryptoError } from "./crypto.js";
-export { FileTransferCryptoError, GrantFileTransferCipher } from "./file-crypto.js";
-export { ApplicationIdentityStoreError, IndexedDbApplicationIdentityStore, MemoryApplicationIdentityStore, applicationInstallationId, authorizationSigningMessage, signApplicationAuthorization } from "./application-identity.js";
-export * from "./authorization-types.js";
-export * from "./application-session.js";
-export * from "./collection-client.js";
-export * from "./connect-options.js";
-export * from "./mdbase-connect.js";
-export * from "./connection.js";
-export * from "./connection-types.js";
-export * from "./capabilities.js";
-export * from "./errors.js";
-export * from "./files.js";
-export * from "./notifications.js";
-export * from "./outcomes.js";
-export * from "./operation-types.js";
-export * from "./selection.js";
-export { createPkce } from "./runtime-utils.js";
+export { MdbaseApplicationSession, MdbaseMemoryVerificationStore } from "./application-session.js";
+export { MdbaseConnect } from "./mdbase-connect.js";
+export { MdbaseConnection } from "./connection.js";
+export { effectiveCapabilities } from "./capabilities.js";
+export { MdbaseConnectError, isRetryableConnectError } from "./errors.js";
+export { MdbaseFileClient } from "./files.js";
+export { parseMdbasePushPayload, parseMdbaseNativeNotificationData, showMdbasePushNotification } from "./notifications.js";
+export { externalStore } from "./external-store.js";
+export { MdbaseBrowserSelection, MdbaseMemorySelection } from "./selection.js";
+export { MDBASE_RECORD_CREATED_CONTRACT, MDBASE_TIMER_FIRED_CONTRACT, operationsForApplicationCapabilities } from "@mdbase-dev/connect-protocol";

package/dist/internal-types.d.ts

@@ -1,7 +1,8 @@
-import type { ApplicationNotifications, ApplicationRequirements, CollectionOperation, EncryptedRelayOperationRequest, GrantEncryption, FileCapability, GrantScope } from "@mdbase-dev/connect-protocol";
+import type { ApplicationNotifications, ApplicationRequirements, CollectionOperation, EncryptedRelayOperationRequest, GrantEncryption, FileCapability, GrantScope, MdbaseOperationRequest, MutationOperationIdentifier } from "@mdbase-dev/connect-protocol";
 import { encryptRelayRequest } from "./crypto.js";
 export interface Application {
     id: string;
+    family_identity: string;
     manifest_digest: string;
     name: string;
     distribution?: "web" | "portable";
@@ -58,10 +59,16 @@ export interface PendingMutation {
     collectionId: string;
     grantId?: string;
     keyId?: string;
+    keyHandle?: string;
+    applicationId?: string;
+    encryption?: GrantEncryption;
     operation: CollectionOperation;
+    mutation?: MutationOperationIdentifier;
     inputFingerprint: string;
     requestId: string;
     envelope?: EncryptedRelayOperationRequest;
+    /** Exact plaintext protocol request for transports that do not use a grant envelope. */
+    request?: MdbaseOperationRequest;
     createdAt: number;
 }
 export interface OperationAttempt {
@@ -70,6 +77,7 @@ export interface OperationAttempt {
     encryptedRequest?: Awaited<ReturnType<typeof encryptRelayRequest>>;
     directDeliveryUncertain?: boolean;
     pendingMutation?: boolean;
+    pendingMutationRecord?: PendingMutation;
     resumingMutation?: boolean;
 }
 export declare const DEFAULT_OPERATIONS: CollectionOperation[];

package/dist/local-file-transport.d.ts

@@ -5,8 +5,8 @@ interface LocalFileTransportOptions {
     keyStore: GrantKeyStore;
     serverUrl: string;
     loopbackUrl: string;
-    authorizedToken(): Promise<StoredToken | null>;
-    refreshAuthorization(): Promise<StoredToken>;
+    authorizedToken(signal?: AbortSignal): Promise<StoredToken | null>;
+    refreshAuthorization(signal?: AbortSignal): Promise<StoredToken>;
     shouldAttemptDirect(token: StoredToken): Promise<boolean>;
     onDirectAvailable(): void;
     onDirectUnavailable(): void;