@crewx/sdk 0.9.0-rc.21 → 0.9.0-rc.210

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

@@ -0,0 +1,35 @@
+import type { AppSyncScopeSelectors } from './types.js';
+export { APP_SYNC_SCOPE_VERSION } from './types.js';
+export type AppSyncScopeKind = 'exercises' | 'routine' | 'workout';
+export interface AppSyncScopeDefinition {
+    readonly root: string;
+    readonly include: readonly string[];
+    readonly idPattern: string;
+    readonly exclude: readonly string[];
+}
+export type AppSyncRefValidation = {
+    readonly valid: true;
+    readonly kind: AppSyncScopeKind;
+} | {
+    readonly valid: false;
+    readonly reason: 'out_of_scope';
+};
+export type AppSyncFrontMatterValidation = {
+    readonly valid: true;
+    readonly kind: AppSyncScopeKind;
+} | {
+    readonly valid: false;
+    readonly reason: 'invalid_front_matter' | 'app_mismatch' | 'kind_mismatch';
+};
+export declare const APP_SYNC_SCOPE_VERSION_LITERAL: "workout-log.records.v1";
+export declare const APP_SYNC_SCOPE_DEFINITION: AppSyncScopeDefinition;
+export declare const APP_SYNC_SCOPE_SELECTORS: AppSyncScopeSelectors;
+export declare class AppSyncScopeRegistry {
+    readonly scopeVersion: "workout-log.records.v1";
+    readonly definition: AppSyncScopeDefinition;
+    matchesDefinition(scopeVersion: unknown, candidate: unknown): boolean;
+    validateRef(ref: unknown): AppSyncRefValidation;
+    validateFrontMatter(ref: string, markdown: string): AppSyncFrontMatterValidation;
+}
+export declare function fingerprintMarkdown(markdown: string): string;
+export declare function normalizeResolvedRootSegments(value: unknown): string[] | null;

package/dist/app-sync/session-fence.d.ts

@@ -0,0 +1,26 @@
+export interface AppSyncSessionFenceToken {
+    readonly accountKey: string;
+    readonly epoch: number;
+    readonly signal: AbortSignal;
+}
+export interface AppSyncGrantFenceToken extends AppSyncSessionFenceToken {
+    readonly grantId: string;
+    readonly generation: number;
+}
+export declare class AppSyncSessionFence {
+    private epoch;
+    private activeSession;
+    private readonly grantControllers;
+    get activeAccountKey(): string | null;
+    get activeSessionEpoch(): number | null;
+    currentToken(accountKey: string): AppSyncSessionFenceToken | null;
+    activate(accountKey: string): AppSyncSessionFenceToken;
+    captureGrant(session: AppSyncSessionFenceToken, grantId: string, generation: number): AppSyncGrantFenceToken;
+    isCurrent(token: AppSyncSessionFenceToken): boolean;
+    release(token: AppSyncGrantFenceToken): void;
+    cancelGrant(accountKey: string, grantId: string, generation: number): void;
+    suspend(accountKey?: string): void;
+    private toSessionToken;
+    private abortActiveSession;
+    private grantKey;
+}

package/dist/app-sync/sqlite-store.d.ts

@@ -0,0 +1,237 @@
+import { BaseSqliteRepository } from '../repository/base-sqlite-repository.js';
+import { APP_SYNC_APP_ID, type AppSyncBinding, type AppSyncCreationJob, type AppSyncCreationClaim, type AppSyncContinuationStore, type AppSyncConflict, type AppSyncConflictChoice, type AppSyncControlRequest, type AppSyncControlRequestState, type AppSyncControlResolution, type AppSyncJobStatus, type AppSyncResult, type AppSyncResultStatus, type AppSyncDiscoveryCheckpoint, type AppSyncPendingDiscovery, type AppSyncOperationFence, type AppSyncGrant, type AppSyncGrantDoc, type AppSyncDeletedRef, type AppSyncStore } from './types.js';
+export declare class SqliteAppSyncStore extends BaseSqliteRepository implements AppSyncStore, AppSyncContinuationStore {
+    private readonly handle;
+    private readonly sqlite;
+    constructor(dbPath?: string);
+    close(): void;
+    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[];
+    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;
+    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;
+    finishAccountDataPurge(input: {
+        readonly requestId: string;
+        readonly binding: AppSyncBinding;
+        readonly fence: AppSyncOperationFence;
+        readonly now: number;
+    }): void;
+    private assertCheckpointCursor;
+    private markResultDeleted;
+    private assertContinuationFence;
+    private assertPurgeFence;
+    private assertAccountKey;
+    private assertText;
+}