@crewx/sdk 0.9.0-rc.23 → 0.9.0-rc.230

package/dist/app-sync/types.d.ts

@@ -0,0 +1,855 @@
+import type { AppSyncScopeDefinition } from './scope.js';
+export declare const APP_SYNC_APP_ID: "workout-log";
+export declare const APP_SYNC_SCOPE_VERSION: "workout-log.records.v1";
+export declare const APP_SYNC_LOCAL_RECORD_LIMIT = 500;
+export declare const APP_SYNC_PAGE_SIZE = 100;
+export declare const APP_SYNC_FRONT_MATTER_MAX_BYTES: number;
+export declare const APP_SYNC_CONTINUATION_MIN_INTERVAL_MS = 60000;
+export declare const APP_SYNC_CONTINUATION_MAX_PAGE_SIZE = 200;
+export declare const DOC001_CREATE_LIMIT_PER_WINDOW = 20;
+export declare const DOC001_CREATE_WINDOW_MS = 60000;
+export type AppSyncStatus = 'local_only' | 'consent_required' | 'checking' | 'syncing' | 'synced' | 'partial' | 'offline' | 'revoked' | 'unavailable' | 'stopping';
+export type AppSyncResultStatus = 'waiting' | 'processing' | 'synced' | 'failed' | 'conflict' | 'blocked' | 'excluded' | 'deleted';
+export type AppSyncJobStatus = 'waiting' | 'processing' | 'completed' | 'failed' | 'conflict' | 'blocked' | 'invalidated' | 'deleted';
+export interface AppSyncEligibility {
+    readonly featureEnabled: boolean;
+    readonly ownerAllowlisted: boolean;
+}
+export interface AppSyncSessionState {
+    readonly authenticated: boolean;
+    readonly accountKey: string | null;
+}
+export interface AppSyncOperationContext {
+    readonly session: AppSyncSessionState;
+    readonly eligibility: AppSyncEligibility;
+    readonly appVersion: string;
+}
+export interface AppSyncBinding {
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly workspaceId: string;
+    readonly appId: typeof APP_SYNC_APP_ID;
+    readonly rootSegments: readonly string[];
+    readonly grantId: string | null;
+    readonly grantGeneration: number | null;
+    readonly scopeVersion: string | null;
+    readonly status: AppSyncStatus;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+export interface AppSyncBindingInput {
+    readonly session: AppSyncSessionState;
+    readonly eligibility: AppSyncEligibility;
+    readonly workspaceId: string;
+    readonly resolvedRootSegments: readonly string[];
+}
+export interface AppSyncGrantInvalidation {
+    readonly bindingId: string;
+    readonly session: AppSyncSessionState;
+    readonly grantId: string;
+    readonly generation: number;
+}
+export interface AppSyncScopeSelectors {
+    readonly exactFiles: readonly ['exercises.md'];
+    readonly directFolders: readonly ['routines', 'workouts'];
+    readonly suffix: '.md';
+    readonly maxDepth: 1;
+}
+export interface AppSyncFileEntry {
+    readonly ref: string;
+    readonly isSymlink: boolean;
+    readonly staysWithinRoot: boolean;
+}
+export interface AppSyncFileRead {
+    readonly markdown: string;
+    readonly isSymlink: boolean;
+    readonly staysWithinRoot: boolean;
+}
+export interface AppSyncFilePage {
+    readonly entries: readonly AppSyncFileEntry[];
+    readonly nextCursor: string | null;
+}
+export interface AppSyncWorkspacePort {
+    listAllowedFiles(input: {
+        readonly rootSegments: readonly string[];
+        readonly selectors: AppSyncScopeSelectors;
+        readonly cursor: string | null;
+        readonly pageSize: number;
+        readonly signal: AbortSignal;
+    }): Promise<AppSyncFilePage>;
+    readFile(input: {
+        readonly rootSegments: readonly string[];
+        readonly ref: string;
+        readonly signal: AbortSignal;
+    }): Promise<AppSyncFileRead>;
+}
+export interface AppSyncGrant {
+    readonly grantId: string;
+    readonly appId: string;
+    readonly generation: number;
+    readonly scopeVersion: string;
+    readonly scope: AppSyncScopeDefinition;
+}
+export interface AppSyncGrantSnapshot {
+    readonly appId: string;
+    readonly available: boolean;
+    readonly status: 'active' | 'revoked' | 'none';
+    readonly grant: AppSyncGrant | null;
+}
+export interface AppSyncRemoteDocument {
+    readonly docId: string;
+    readonly currentRevision: number;
+    readonly markdownVersion: string;
+    readonly markdown: string;
+    readonly appGrantId: string;
+    readonly appGrantGeneration: number;
+}
+export interface AppSyncOperationFence {
+    readonly accountKey: string;
+    readonly sessionEpoch: number;
+    readonly bindingId: string;
+    readonly workspaceId: string;
+    readonly rootFingerprint: string;
+    readonly grantId: string;
+    readonly grantGeneration: number;
+    readonly scopeVersion: typeof APP_SYNC_SCOPE_VERSION;
+    readonly signal: AbortSignal;
+    assertCurrent(): void;
+}
+export interface AppSyncGrantDoc {
+    readonly docId: string;
+    readonly ref: string;
+    readonly title: string;
+    readonly currentRevision: number;
+    readonly markdownVersion: string;
+    readonly updatedAt: string;
+    readonly appGrantGeneration: number;
+    readonly needsReattach: boolean;
+}
+export interface AppSyncGrantDocsPage {
+    readonly appId: typeof APP_SYNC_APP_ID;
+    readonly grantId: string;
+    readonly generation: number;
+    readonly scopeVersion: typeof APP_SYNC_SCOPE_VERSION;
+    readonly listedAt: string;
+    readonly items: readonly AppSyncGrantDoc[];
+    readonly nextCursor: string | null;
+}
+export interface AppSyncDeletedRef {
+    readonly refHash: string;
+    readonly deletedAt: string;
+}
+export interface AppSyncDeletedRefsPage {
+    readonly appId: typeof APP_SYNC_APP_ID;
+    readonly grantId: string;
+    readonly generation: number;
+    readonly listedAt: string;
+    readonly items: readonly AppSyncDeletedRef[];
+    readonly nextCursor: string | null;
+}
+export interface AppSyncCreateResult {
+    readonly docId: string;
+    readonly currentRevision: number;
+    readonly markdownVersion: string;
+    readonly appGrantId: string;
+    readonly appGrantGeneration: number;
+    readonly replayed: boolean;
+    readonly reattached?: boolean;
+}
+export type DocCreateDispatchSource = 'human' | 'app_create' | 'app_reattach';
+export interface DocCreateDispatchInput {
+    readonly accountKey: string;
+    readonly requestId: string;
+    readonly source: DocCreateDispatchSource;
+    readonly now: number;
+}
+export type AppSyncSendDecision = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly retryAt: number;
+};
+export type AppSyncSendGate = (() => AppSyncSendDecision) & {
+    readonly calls: number;
+};
+export type DocCreateLedgerPeek = {
+    readonly available: true;
+    readonly remaining: number;
+} | {
+    readonly available: false;
+    readonly retryAt: number;
+};
+export interface DocCreateLedger {
+    peek(accountKey: string, now: number): DocCreateLedgerPeek;
+    reserve(input: DocCreateDispatchInput): AppSyncSendDecision;
+    reserveForced(input: DocCreateDispatchInput): void;
+    prune(now: number): number;
+}
+export interface AppSyncRemote {
+    readonly capabilities?: {
+        readonly dispatchGate?: true;
+    };
+    readGrant(input: {
+        readonly accountKey: string;
+        readonly appId: typeof APP_SYNC_APP_ID;
+        readonly signal: AbortSignal;
+        readonly fence?: AppSyncOperationFence;
+    }): Promise<AppSyncGrantSnapshot>;
+    createGrantedDocument(input: {
+        readonly accountKey: string;
+        readonly appId: typeof APP_SYNC_APP_ID;
+        readonly ref: string;
+        readonly requestId: string;
+        readonly markdown: string;
+        readonly appVersion: string;
+        readonly appGrant: {
+            readonly grantId: string;
+            readonly generation: number;
+        };
+        readonly signal: AbortSignal;
+        readonly fence?: AppSyncOperationFence;
+        readonly dispatchGate?: AppSyncSendGate;
+    }): Promise<AppSyncCreateResult>;
+    readDocument(input: {
+        readonly accountKey: string;
+        readonly docId: string;
+        readonly signal: AbortSignal;
+        readonly fence?: AppSyncOperationFence;
+    }): Promise<AppSyncRemoteDocument>;
+    listGrantDocs?(input: {
+        readonly accountKey: string;
+        readonly appId: typeof APP_SYNC_APP_ID;
+        readonly grantId: string;
+        readonly generation: number;
+        readonly cursor: string | null;
+        readonly limit: number;
+        readonly signal: AbortSignal;
+        readonly fence: AppSyncOperationFence;
+    }): Promise<AppSyncGrantDocsPage>;
+    listDeletedRefs?(input: {
+        readonly accountKey: string;
+        readonly appId: typeof APP_SYNC_APP_ID;
+        readonly grantId: string;
+        readonly generation: number;
+        readonly cursor: string | null;
+        readonly limit: number;
+        readonly signal: AbortSignal;
+        readonly fence: AppSyncOperationFence;
+    }): Promise<AppSyncDeletedRefsPage>;
+}
+export interface AppSyncCreationJob {
+    readonly jobId: string;
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly grantId: string;
+    readonly grantGeneration: number;
+    readonly ref: string;
+    readonly requestId: string;
+    readonly fingerprint: string;
+    readonly operationKind?: 'create' | 'reattach';
+    readonly documentId?: string | null;
+    readonly status: AppSyncJobStatus;
+    readonly attempts: number;
+    readonly nextAttemptAt: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+export type AppSyncCreationClaim = Pick<AppSyncCreationJob, 'jobId' | 'attempts' | 'nextAttemptAt'>;
+export interface AppSyncResult {
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly ref: string;
+    readonly grantId: string;
+    readonly grantGeneration: number;
+    readonly sourceFingerprint: string | null;
+    readonly syncedFingerprint: string | null;
+    readonly documentId: string | null;
+    readonly status: AppSyncResultStatus;
+    readonly errorCode: string | null;
+    readonly nextAttemptAt: number;
+    readonly attempts: number;
+    readonly updatedAt: number;
+}
+export type AppSyncControlRequestKind = 'connect' | 'revoke';
+export type AppSyncControlRequestState = 'pending' | 'unknown' | 'confirmed' | 'failed';
+export type AppSyncControlResolution = 'remote' | 'human';
+export interface AppSyncControlRequest {
+    readonly requestId: string;
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly appId: typeof APP_SYNC_APP_ID;
+    readonly workspaceId: string;
+    readonly rootFingerprint: string;
+    readonly kind: AppSyncControlRequestKind;
+    readonly state: AppSyncControlRequestState;
+    readonly grantId: string | null;
+    readonly generation: number | null;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly resolvedAt: number | null;
+    readonly resolution: AppSyncControlResolution | null;
+    readonly resolutionId: string | null;
+}
+export interface AppSyncControlRequestIdentity {
+    readonly bindingId: string;
+    readonly session: AppSyncSessionState;
+    readonly workspaceId: string;
+    readonly resolvedRootSegments: readonly string[];
+}
+export interface AppSyncBeginControlRequest extends AppSyncControlRequestIdentity {
+    readonly requestId: string;
+    readonly kind: AppSyncControlRequestKind;
+    readonly grantId?: string | null;
+    readonly generation?: number | null;
+}
+export interface AppSyncControlRequestHandle extends AppSyncControlRequestIdentity {
+    readonly requestId: string;
+}
+export interface AppSyncResolveControlRequest extends AppSyncControlRequestHandle {
+    readonly outcome: 'confirmed' | 'failed';
+    readonly resolution: AppSyncControlResolution;
+    readonly resolutionId: string;
+    readonly observedGrant?: AppSyncGrant | null;
+}
+export interface AppSyncCounts {
+    readonly N: number;
+    readonly S: number;
+    readonly P: number;
+    readonly I: number;
+    readonly F: number;
+    readonly C: number;
+    readonly B: number;
+    readonly D: number;
+}
+export interface AppSyncSnapshot {
+    readonly binding: AppSyncBinding | null;
+    readonly status: AppSyncStatus;
+    readonly counts: AppSyncCounts;
+    readonly results: readonly AppSyncResult[];
+}
+export interface AppSyncDocumentOutcome {
+    readonly status: 'synced' | 'waiting' | 'processing' | 'conflict' | 'failed' | 'blocked';
+    readonly syncedFingerprint?: string;
+    readonly errorCode?: string;
+    readonly retryAt?: number;
+    readonly dispatch: 'none' | 'attempted';
+}
+export type AppSyncBeforeDispatchResult = {
+    readonly ok: true;
+    readonly markdown: string;
+    readonly fingerprint: string;
+} | {
+    readonly ok: false;
+    readonly reason: 'session_stale' | 'grant_stale' | 'control_request_pending' | 'deleted' | 'unsafe' | 'missing' | 'read_error' | 'out_of_scope';
+};
+export interface AppSyncDocumentPort {
+    attachCreated(input: {
+        readonly binding: AppSyncBinding;
+        readonly grant: AppSyncGrant;
+        readonly ref: string;
+        readonly document: AppSyncRemoteDocument;
+        readonly localMarkdown: string;
+        readonly sourceFingerprint: string;
+        readonly signal: AbortSignal;
+    }): Promise<AppSyncDocumentOutcome>;
+    reconcileExisting(input: {
+        readonly binding: AppSyncBinding;
+        readonly grant: AppSyncGrant;
+        readonly ref: string;
+        readonly document: AppSyncRemoteDocument;
+        readonly localMarkdown: string;
+        readonly sourceFingerprint: string;
+        readonly signal: AbortSignal;
+        readonly beforeDispatch: () => Promise<AppSyncBeforeDispatchResult>;
+    }): Promise<AppSyncDocumentOutcome>;
+    suspendBinding(input: {
+        readonly binding: AppSyncBinding;
+        readonly grantId: string | null;
+        readonly generation: number | null;
+        readonly reason: 'logout' | 'account_switch' | 'revoked' | 'regranted' | 'scope_mismatch' | 'ineligible' | 'auth_required' | 'revoke_pending';
+    }): Promise<void>;
+    inspectContinuation?(input: {
+        readonly binding: AppSyncBinding;
+        readonly grant: AppSyncGrant;
+        readonly ref: string;
+        readonly fence: AppSyncOperationFence;
+    }): Promise<AppSyncDocumentInspection>;
+    applyContinuation?(input: AppSyncContinuationEffect): Promise<AppSyncContinuationApplyResult>;
+}
+export interface AppSyncDocumentBaseline {
+    readonly revision: number;
+    readonly markdownVersion: string;
+}
+export type AppSyncDocumentInspection = {
+    readonly exists: false;
+    readonly localVersion: null;
+    readonly localFingerprint: null;
+    readonly markdown: null;
+    readonly baseline: AppSyncDocumentBaseline | null;
+} | {
+    readonly exists: true;
+    readonly localVersion: string;
+    readonly localFingerprint: string;
+    readonly markdown: string;
+    readonly baseline: AppSyncDocumentBaseline | null;
+};
+export type AppSyncContinuationSourceCheck = {
+    readonly ok: true;
+    readonly localVersion: string;
+    readonly markdown: string;
+    readonly fingerprint: string;
+} | {
+    readonly ok: false;
+    readonly reason: 'stale' | 'unsafe' | 'out_of_scope' | 'session_stale' | 'deleted';
+};
+export type AppSyncContinuationEffect = {
+    readonly kind: 'attach_equal';
+    readonly binding: AppSyncBinding;
+    readonly grant: AppSyncGrant;
+    readonly ref: string;
+    readonly document: AppSyncRemoteDocument;
+    readonly expectedLocalVersion: string;
+    readonly expectedLocalFingerprint: string;
+    readonly fence: AppSyncOperationFence;
+} | {
+    readonly kind: 'create_absent' | 'cas_pull';
+    readonly binding: AppSyncBinding;
+    readonly grant: AppSyncGrant;
+    readonly ref: string;
+    readonly document: AppSyncRemoteDocument;
+    readonly expectedLocalVersion: null | string;
+    readonly fence: AppSyncOperationFence;
+} | {
+    readonly kind: 'conditional_save';
+    readonly binding: AppSyncBinding;
+    readonly grant: AppSyncGrant;
+    readonly ref: string;
+    readonly documentId: string;
+    readonly expectedLocalVersion: string;
+    readonly expectedRemoteRevision: number;
+    readonly expectedRemoteFingerprint: string;
+    readonly markdown: string;
+    readonly markdownFingerprint: string;
+    readonly needsReattach: boolean;
+    readonly fence: AppSyncOperationFence;
+    readonly beforeDispatch: () => Promise<AppSyncContinuationSourceCheck>;
+};
+export type AppSyncContinuationApplyResult = {
+    readonly status: 'applied';
+    readonly dispatch: 'none' | 'attempted';
+} | {
+    readonly status: 'stale_local';
+    readonly dispatch: 'none' | 'attempted';
+} | {
+    readonly status: 'conflict';
+    readonly dispatch: 'attempted';
+    readonly errorCode?: string;
+} | {
+    readonly status: 'deferred';
+    readonly dispatch: 'none';
+    readonly retryAt?: number;
+    readonly errorCode?: string;
+} | {
+    readonly status: 'failed';
+    readonly dispatch: 'none' | 'attempted';
+    readonly errorCode: string;
+    readonly retryAt?: number;
+};
+export type AppSyncConflictPreservationStatus = 'pending' | 'ready' | 'failed';
+export type AppSyncConflictState = 'open' | 'resolving' | 'superseded' | 'resolved' | 'kept_both' | 'purging';
+export type AppSyncConflictChoice = 'keep_local' | 'use_cloud' | 'keep_both';
+export interface AppSyncConflict {
+    readonly conflictId: string;
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly workspaceId: string;
+    readonly rootFingerprint: string;
+    readonly grantId: string;
+    readonly grantGeneration: number;
+    readonly scopeVersion: typeof APP_SYNC_SCOPE_VERSION;
+    readonly ref: string;
+    readonly documentId: string;
+    readonly localVersion: string;
+    readonly localFingerprint: string;
+    readonly baselineRevision: number | null;
+    readonly baselineFingerprint: string | null;
+    readonly remoteRevision: number;
+    readonly remoteFingerprint: string;
+    readonly needsReattach: boolean;
+    readonly vaultHandle: string | null;
+    readonly preservationStatus: AppSyncConflictPreservationStatus;
+    readonly state: AppSyncConflictState;
+    readonly supersededBy: string | null;
+    readonly resolutionRequestId: string | null;
+    readonly resolutionChoice: AppSyncConflictChoice | null;
+    readonly cleanupPending: boolean;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+export interface AppSyncConflictResolutionInput {
+    readonly bindingId: string;
+    readonly session: AppSyncSessionState;
+    readonly eligibility: AppSyncEligibility;
+    readonly expectedSessionEpoch: number;
+    readonly workspaceId: string;
+    readonly resolvedRootSegments: readonly string[];
+    readonly conflictId: string;
+    readonly requestId: string;
+    readonly humanIdentity: string;
+    readonly appVersion: string;
+    readonly choice: AppSyncConflictChoice;
+    readonly expectedLocalVersion: string;
+    readonly expectedRemoteRevision: number;
+    readonly expectedRemoteFingerprint: string;
+}
+export interface AppSyncConflictResolutionResult {
+    readonly status: 'resolved' | 'kept_both';
+    readonly conflict: AppSyncConflictSummary;
+    readonly cleanupPending: boolean;
+}
+export type AppSyncConflictSummary = Omit<AppSyncConflict, 'vaultHandle'> & {
+    readonly sessionEpoch: number;
+};
+export interface AppSyncConflictArchiveInput {
+    readonly bindingId: string;
+    readonly session: AppSyncSessionState;
+    readonly eligibility: AppSyncEligibility;
+    readonly expectedSessionEpoch: number;
+    readonly workspaceId: string;
+    readonly resolvedRootSegments: readonly string[];
+    readonly conflictId: string;
+}
+export interface AppSyncConflictArchive {
+    readonly conflictId: string;
+    readonly localVersion: string;
+    readonly localFingerprint: string;
+    readonly remoteRevision: number;
+    readonly remoteFingerprint: string;
+    readonly markdown: string;
+}
+export interface AppSyncAccountDataPurgeInput {
+    readonly bindingId: string;
+    readonly session: AppSyncSessionState;
+    readonly expectedSessionEpoch: number;
+    readonly workspaceId: string;
+    readonly resolvedRootSegments: readonly string[];
+    readonly requestId: string;
+    readonly humanIdentity: string;
+    readonly intent: 'device_account_data_deleted';
+}
+export interface AppSyncAccountDataPurgeResult {
+    readonly requestId: string;
+    readonly status: 'purged' | 'cleanup_pending';
+    readonly remainingArchiveCount: number;
+}
+export interface AppSyncConflictVaultPort {
+    preserve(input: {
+        readonly accountKey: string;
+        readonly conflictId: string;
+        readonly markdown: string;
+        readonly fingerprint: string;
+        readonly fence: AppSyncOperationFence;
+    }): Promise<{
+        readonly handle: string;
+        readonly fingerprint: string;
+    }>;
+    read(input: {
+        readonly accountKey: string;
+        readonly handle: string;
+        readonly expectedFingerprint: string;
+        readonly fence: AppSyncOperationFence;
+    }): Promise<{
+        readonly markdown: string;
+        readonly fingerprint: string;
+    }>;
+    remove(input: {
+        readonly accountKey: string;
+        readonly handle: string;
+        readonly fence: AppSyncOperationFence;
+    }): Promise<void>;
+}
+export interface AppSyncContinuationCapability {
+    readonly store: AppSyncStore & AppSyncContinuationStore;
+    readonly conflictVault: AppSyncConflictVaultPort;
+    readonly pageSize?: number;
+}
+export interface AppSyncListConflictsInput {
+    readonly bindingId: string;
+    readonly session: AppSyncSessionState;
+    readonly eligibility: AppSyncEligibility;
+    readonly workspaceId: string;
+    readonly resolvedRootSegments: readonly string[];
+}
+export interface AppSyncDiscoveryCheckpoint {
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly workspaceId: string;
+    readonly rootFingerprint: string;
+    readonly grantId: string;
+    readonly grantGeneration: number;
+    readonly scopeVersion: typeof APP_SYNC_SCOPE_VERSION;
+    readonly lastCycleStartedAt: number | null;
+    readonly cycleStartedAt: number | null;
+    readonly docsCursor: string | null;
+    readonly docsComplete: boolean;
+    readonly deletedCursor: string | null;
+    readonly deletedComplete: boolean;
+    readonly updatedAt: number;
+}
+export interface AppSyncPendingDiscovery {
+    readonly bindingId: string;
+    readonly accountKey: string;
+    readonly grantId: string;
+    readonly grantGeneration: number;
+    readonly ref: string;
+    readonly docId: string;
+    readonly listedRevision: number;
+    readonly listedFingerprint: string;
+    readonly appGrantGeneration: number;
+    readonly needsReattach: boolean;
+    readonly needsReconcile: boolean;
+    readonly status: 'waiting' | 'processing' | 'failed' | 'invalidated';
+    readonly errorCode: string | null;
+    readonly attempts: number;
+    readonly updatedAt: number;
+}
+export interface AppSyncContinuationStore {
+    getDiscoveryCheckpoint(bindingId: string): AppSyncDiscoveryCheckpoint | undefined;
+    beginDiscoveryCycle(input: {
+        readonly binding: AppSyncBinding;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): AppSyncDiscoveryCheckpoint | null;
+    resetDiscoveryCycle(input: {
+        readonly binding: AppSyncBinding;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    commitGrantDocsPage(input: {
+        readonly binding: AppSyncBinding;
+        readonly fence: AppSyncOperationFence;
+        readonly items: readonly AppSyncGrantDoc[];
+        readonly expectedCursor: string | null;
+        readonly nextCursor: string | null;
+        readonly now: number;
+    }): void;
+    commitDeletedRefsPage(input: {
+        readonly binding: AppSyncBinding;
+        readonly fence: AppSyncOperationFence;
+        readonly items: readonly AppSyncDeletedRef[];
+        readonly expectedCursor: string | null;
+        readonly nextCursor: string | null;
+        readonly now: number;
+    }): void;
+    listPendingDiscoveries(bindingId: string, grantId: string, generation: number, limit?: number): AppSyncPendingDiscovery[];
+    getPendingDiscovery(bindingId: string, grantId: string, generation: number, ref: string): AppSyncPendingDiscovery | undefined;
+    updatePendingDiscovery(input: {
+        readonly bindingId: string;
+        readonly grantId: string;
+        readonly generation: number;
+        readonly ref: string;
+        readonly fence: AppSyncOperationFence;
+        readonly patch: Partial<Pick<AppSyncPendingDiscovery, 'listedRevision' | 'listedFingerprint' | 'docId' | 'appGrantGeneration' | 'needsReattach' | 'needsReconcile' | 'status' | 'errorCode' | 'attempts'>>;
+        readonly now: number;
+    }): void;
+    completePendingDiscovery(input: {
+        readonly bindingId: string;
+        readonly grantId: string;
+        readonly generation: number;
+        readonly ref: string;
+        readonly fence: AppSyncOperationFence;
+    }): void;
+    recordKnownDeletion(input: {
+        readonly binding: AppSyncBinding;
+        readonly grant: AppSyncGrant;
+        readonly ref: string;
+        readonly refHash: string;
+        readonly documentId: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    recordContinuationOutcome(input: {
+        readonly binding: AppSyncBinding;
+        readonly grant: AppSyncGrant;
+        readonly ref: string;
+        readonly sourceFingerprint: string | null;
+        readonly syncedFingerprint: string | null;
+        readonly documentId: string | null;
+        readonly status: AppSyncResultStatus;
+        readonly errorCode: string | null;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    enqueueReattachJob(input: {
+        readonly binding: AppSyncBinding;
+        readonly grant: AppSyncGrant;
+        readonly ref: string;
+        readonly documentId: string;
+        readonly fingerprint: string;
+        readonly requestId: string;
+        readonly jobId: string;
+        readonly now: number;
+        readonly fence: AppSyncOperationFence;
+    }): AppSyncCreationJob;
+    putConflict(input: {
+        readonly conflict: AppSyncConflict;
+        readonly fence: AppSyncOperationFence;
+    }): AppSyncConflict;
+    rebindConflict(input: {
+        readonly conflictId: string;
+        readonly grant: AppSyncGrant;
+        readonly needsReattach: boolean;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): AppSyncConflict;
+    supersedeOpenConflicts(input: {
+        readonly bindingId: string;
+        readonly ref: string;
+        readonly supersededBy: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    getConflict(conflictId: string): AppSyncConflict | undefined;
+    listConflicts(bindingId: string): AppSyncConflict[];
+    beginConflictResolution(input: {
+        readonly conflictId: string;
+        readonly requestId: string;
+        readonly humanIdentity: string;
+        readonly choice: AppSyncConflictChoice;
+        readonly expectedLocalVersion: string;
+        readonly expectedRemoteRevision: number;
+        readonly expectedRemoteFingerprint: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    finishConflictResolution(input: {
+        readonly conflictId: string;
+        readonly requestId: string;
+        readonly choice: AppSyncConflictChoice;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): AppSyncConflict;
+    abortConflictResolution(input: {
+        readonly conflictId: string;
+        readonly requestId: string;
+        readonly state: 'stale' | 'failed';
+        readonly errorCode: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    markConflictResolutionUnknown(input: {
+        readonly conflictId: string;
+        readonly requestId: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    finishConflictArchiveCleanup(input: {
+        readonly conflictId: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    markConflictPurging(input: {
+        readonly conflictId: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): AppSyncConflict;
+    deletePurgedConflict(input: {
+        readonly conflictId: string;
+        readonly expectedVaultHandle: string | null;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    beginAccountDataPurge(input: {
+        readonly requestId: string;
+        readonly binding: AppSyncBinding;
+        readonly humanIdentity: string;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    finishAccountDataPurge(input: {
+        readonly requestId: string;
+        readonly binding: AppSyncBinding;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    getAccountDataPurge(requestId: string): {
+        readonly requestId: string;
+        readonly bindingId: string;
+        readonly accountKey: string;
+        readonly workspaceId: string;
+        readonly rootFingerprint: string;
+        readonly humanIdentity: string;
+        readonly state: 'pending' | 'complete';
+    } | undefined;
+}
+export interface AppSyncCreationBudget {
+    runCreate<T>(input: {
+        readonly accountKey: string;
+        readonly signal: AbortSignal;
+        readonly dispatch: () => Promise<T>;
+    }): Promise<{
+        readonly status: 'dispatched';
+        readonly value: T;
+    } | {
+        readonly status: 'deferred';
+        readonly retryAt: number;
+    }>;
+}
+export interface AppSyncStore {
+    bind(input: {
+        readonly bindingId: string;
+        readonly accountKey: string;
+        readonly workspaceId: string;
+        readonly appId: typeof APP_SYNC_APP_ID;
+        readonly rootSegments: readonly string[];
+        readonly now: number;
+    }): AppSyncBinding;
+    getBinding(bindingId: string): AppSyncBinding | undefined;
+    getBindingForAccountApp(accountKey: string, appId: typeof APP_SYNC_APP_ID): AppSyncBinding | undefined;
+    beginControlRequest(input: AppSyncControlRequest): AppSyncControlRequest;
+    getControlRequest(requestId: string): AppSyncControlRequest | undefined;
+    getPendingControlRequest(bindingId: string): AppSyncControlRequest | undefined;
+    getConfirmedRevoke(bindingId: string, grantId: string, generation: number): AppSyncControlRequest | undefined;
+    updateControlRequest(requestId: string, patch: {
+        readonly state: AppSyncControlRequestState;
+        readonly grantId: string | null;
+        readonly generation: number | null;
+        readonly resolution: AppSyncControlResolution | null;
+        readonly resolutionId: string | null;
+        readonly resolvedAt: number | null;
+        readonly now: number;
+    }): AppSyncControlRequest;
+    updateBinding(bindingId: string, patch: Partial<Pick<AppSyncBinding, 'grantId' | 'grantGeneration' | 'scopeVersion' | 'status'>>, now: number): void;
+    enqueueCreation(input: {
+        readonly jobId: string;
+        readonly requestId: string;
+        readonly bindingId: string;
+        readonly accountKey: string;
+        readonly grantId: string;
+        readonly grantGeneration: number;
+        readonly ref: string;
+        readonly fingerprint: string;
+        readonly now: number;
+    }): AppSyncCreationJob;
+    listRunnableCreations(bindingId: string, grantId: string, generation: number, now: number): AppSyncCreationJob[];
+    claimCreation(jobId: string, now: number, leaseMs: number): AppSyncCreationJob | undefined;
+    deferCreation?(claim: AppSyncCreationClaim, nextAttemptAt: number, now: number): boolean;
+    updateCreation(jobId: string, patch: {
+        readonly status: AppSyncJobStatus;
+        readonly nextAttemptAt: number;
+        readonly now: number;
+    }): void;
+    releaseProcessingCreations(bindingId: string, grantId: string, generation: number, now: number): void;
+    invalidateGrantJobs(bindingId: string, grantId: string, generation: number, now: number): void;
+    upsertResult(input: Omit<AppSyncResult, 'updatedAt' | 'nextAttemptAt' | 'attempts'> & {
+        readonly updatedAt: number;
+        readonly nextAttemptAt?: number;
+        readonly attempts?: number;
+    }): void;
+    getResult(bindingId: string, ref: string): AppSyncResult | undefined;
+    listResults(bindingId: string): AppSyncResult[];
+    hasDeletedRef(accountKey: string, appId: typeof APP_SYNC_APP_ID, refHash: string): boolean;
+    suppressDeletedRef(accountKey: string, appId: typeof APP_SYNC_APP_ID, refHash: string, now: number): void;
+    countDeletedRefs(accountKey: string, appId: typeof APP_SYNC_APP_ID): number;
+    listBindingsForAccount(accountKey: string): AppSyncBinding[];
+}