@crewx/sdk 0.9.0-rc.22 → 0.9.0-rc.221

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

@@ -0,0 +1,67 @@
+import type { AppSyncBinding, AppSyncContinuationCapability, AppSyncConflictArchive, AppSyncConflictArchiveInput, AppSyncConflictResolutionInput, AppSyncConflictResolutionResult, AppSyncConflictSummary, AppSyncAccountDataPurgeInput, AppSyncAccountDataPurgeResult, AppSyncCreationBudget, AppSyncCreationJob, AppSyncDocumentPort, AppSyncGrant, AppSyncListConflictsInput, AppSyncOperationContext, AppSyncRemote, AppSyncStore, DocCreateLedger } from './types.js';
+import { AppSyncSessionFence, type AppSyncGrantFenceToken, type AppSyncSessionFenceToken } from './session-fence.js';
+import { AppSyncScopeRegistry } from './scope.js';
+interface AppSyncContinuationRuntimeDependencies {
+    readonly store: AppSyncStore;
+    readonly continuation?: AppSyncContinuationCapability;
+    readonly remote: AppSyncRemote;
+    readonly documents: AppSyncDocumentPort;
+    readonly creationBudget: AppSyncCreationBudget;
+    readonly createLedger?: DocCreateLedger;
+    readonly onAdapterError?: (error: unknown) => void;
+}
+export declare class AppSyncContinuationRuntime {
+    private readonly dependencies;
+    private readonly scopeRegistry;
+    private readonly sessionFence;
+    private readonly now;
+    private readonly createId;
+    private readonly hasPendingRevoke;
+    private readonly continuation;
+    private readonly continuationStore;
+    private readonly pageSize;
+    constructor(dependencies: AppSyncContinuationRuntimeDependencies, scopeRegistry: AppSyncScopeRegistry, sessionFence: AppSyncSessionFence, now: () => number, createId: () => string, hasPendingRevoke: (bindingId: string) => boolean);
+    tick(binding: AppSyncBinding, grant: AppSyncGrant, session: AppSyncSessionFenceToken, grantToken: AppSyncGrantFenceToken, _context: AppSyncOperationContext): Promise<void>;
+    listConflicts(input: AppSyncListConflictsInput): AppSyncConflictSummary[];
+    private assertHumanBindingIdentity;
+    private requireCurrentSession;
+    private requireHumanOperationBinding;
+    readConflictArchive(input: AppSyncConflictArchiveInput): Promise<AppSyncConflictArchive>;
+    purgeAccountData(input: AppSyncAccountDataPurgeInput): Promise<AppSyncAccountDataPurgeResult>;
+    resolveConflict(input: AppSyncConflictResolutionInput): Promise<AppSyncConflictResolutionResult>;
+    dispatchReattachCreation(binding: AppSyncBinding, grant: AppSyncGrant, session: AppSyncSessionFenceToken, candidate: AppSyncCreationJob, context: AppSyncOperationContext): Promise<void>;
+    private deferClaim;
+    private traverseWithCursorRecovery;
+    private traverseGrantDocs;
+    private traverseDeletedRefs;
+    private validateGrantDocsPage;
+    private validateDeletedRefsPage;
+    private readActiveGrant;
+    private processPendingDiscoveries;
+    private reconcileDiscoveredDocument;
+    private inspectLocal;
+    private readPendingDocument;
+    private validateRemoteDocument;
+    private queueOrConfirmReattachment;
+    private markReattached;
+    private markPendingForReconcile;
+    private applyConditionalSave;
+    private applyEffect;
+    private reconcileAfterLocalRace;
+    private preserveConflict;
+    private recordOutcome;
+    private readRemoteById;
+    private readRemoteDocument;
+    private applyHumanResolution;
+    private cleanupResolvedConflict;
+    private readVerifiedArchive;
+    private refreshConflictAfterStale;
+    private archiveFenceGrant;
+    private purgeFenceGrant;
+    private createArchiveFenceContext;
+    private assertArchiveFenceCurrent;
+    private createFenceContext;
+    private assertFenceCurrent;
+    private isFenceCurrent;
+}
+export {};

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

@@ -0,0 +1,92 @@
+import { type AppSyncBinding, type AppSyncBindingInput, type AppSyncBeginControlRequest, type AppSyncControlRequest, type AppSyncControlRequestHandle, type AppSyncControlRequestIdentity, type AppSyncGrantInvalidation, type AppSyncOperationContext, type AppSyncRemote, type AppSyncDocumentPort, type AppSyncCreationBudget, type AppSyncConflictResolutionInput, type AppSyncConflictResolutionResult, type AppSyncConflictArchiveInput, type AppSyncConflictArchive, type AppSyncAccountDataPurgeInput, type AppSyncAccountDataPurgeResult, type AppSyncListConflictsInput, type AppSyncConflictSummary, type AppSyncContinuationCapability, type AppSyncResolveControlRequest, type AppSyncSnapshot, type AppSyncStore, type AppSyncWorkspacePort, type DocCreateLedger } from './types.js';
+import { AppSyncSessionFence } from './session-fence.js';
+import { AppSyncScopeRegistry } from './scope.js';
+export declare class AppSyncRemoteError extends Error {
+    readonly code: string;
+    readonly status?: number | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(code: string, status?: number | undefined, retryAfterMs?: number | undefined);
+}
+export interface AppSyncCoordinatorDependencies {
+    readonly store: AppSyncStore;
+    readonly workspace: AppSyncWorkspacePort;
+    readonly remote: AppSyncRemote;
+    readonly documents: AppSyncDocumentPort;
+    readonly creationBudget: AppSyncCreationBudget;
+    readonly createLedger?: DocCreateLedger;
+    readonly continuation?: AppSyncContinuationCapability;
+    readonly scopeRegistry?: AppSyncScopeRegistry;
+    readonly sessionFence?: AppSyncSessionFence;
+    readonly now?: () => number;
+    readonly createId?: () => string;
+    readonly onAdapterError?: (error: unknown) => void;
+}
+export declare class AppSyncCoordinator {
+    private readonly dependencies;
+    private readonly scopeRegistry;
+    private readonly sessionFence;
+    private readonly now;
+    private readonly createId;
+    private readonly scanRuns;
+    private readonly tickRuns;
+    private readonly remoteReadSemaphore;
+    private readonly continuationRuntime;
+    private scanEpoch;
+    get activeSessionEpoch(): number | null;
+    constructor(dependencies: AppSyncCoordinatorDependencies);
+    bind(input: AppSyncBindingInput): Promise<AppSyncBinding>;
+    scan(bindingId: string, context: AppSyncOperationContext): Promise<AppSyncSnapshot>;
+    tick(bindingId: string, context: AppSyncOperationContext): Promise<AppSyncSnapshot>;
+    private performTick;
+    private limitCreationClaims;
+    private makeDispatchGate;
+    private deferClaim;
+    private recordMissingDispatchGate;
+    suspendAccount(accountKey: string): Promise<void>;
+    invalidateGrant(input: AppSyncGrantInvalidation): Promise<void>;
+    beginControlRequest(input: AppSyncBeginControlRequest): Promise<AppSyncControlRequest>;
+    getControlRequest(input: AppSyncControlRequestHandle): AppSyncControlRequest | undefined;
+    getPendingControlRequest(input: AppSyncControlRequestIdentity): AppSyncControlRequest | undefined;
+    markControlRequestUnknown(input: AppSyncControlRequestHandle): Promise<AppSyncControlRequest>;
+    resolveControlRequest(input: AppSyncResolveControlRequest): Promise<AppSyncControlRequest>;
+    snapshot(bindingId: string): Promise<AppSyncSnapshot>;
+    private performScan;
+    private listAllowedRefs;
+    private readEligibleFile;
+    private beforeDocumentDispatch;
+    private readRemoteDocument;
+    private dispatchCreation;
+    private reconcileExisting;
+    private handleCreationError;
+    private handleExistingError;
+    private markDeleted;
+    private recordOutcome;
+    private recordBeforeDispatchFailure;
+    private writeResult;
+    private validateControlIdentity;
+    private hasPendingRevoke;
+    private holdPendingRevoke;
+    private invalidateStoredGeneration;
+    private pauseUnavailableBinding;
+    private pauseAuthentication;
+    private returnProcessingResultsToWaiting;
+    private suspendDocumentBinding;
+    private reportAdapterError;
+    private activateSession;
+    private suspendBindingsForAccount;
+    private shouldReconcile;
+    private validRemoteDocument;
+    private grantFromBinding;
+    private bindingHasGrant;
+    private isTransferStatus;
+    private isEligible;
+    private requireAuthenticatedAccount;
+    private isCurrent;
+    private refreshBindingStatus;
+    private snapshotNow;
+    listConflicts(input: AppSyncListConflictsInput): AppSyncConflictSummary[];
+    readConflictArchive(input: AppSyncConflictArchiveInput): Promise<AppSyncConflictArchive>;
+    resolveConflict(input: AppSyncConflictResolutionInput): Promise<AppSyncConflictResolutionResult>;
+    purgeAccountData(input: AppSyncAccountDataPurgeInput): Promise<AppSyncAccountDataPurgeResult>;
+    private retryAt;
+}

package/dist/app-sync/create-ledger.d.ts

@@ -0,0 +1,27 @@
+import { type AppSyncSendDecision, type AppSyncSendGate, type DocCreateDispatchInput, type DocCreateDispatchSource, type DocCreateLedger, type DocCreateLedgerPeek } from './types.js';
+type SqliteDatabase = import('better-sqlite3').Database;
+export declare class AppSyncBudgetDeferredError extends Error {
+    readonly retryAt: number;
+    readonly code = "APP_SYNC_BUDGET_DEFERRED";
+    constructor(retryAt: number);
+}
+export declare class SqliteDocCreateLedger implements DocCreateLedger {
+    private readonly sqlite;
+    constructor(sqlite: SqliteDatabase);
+    peek(accountKey: string, now: number): DocCreateLedgerPeek;
+    reserve(input: DocCreateDispatchInput): AppSyncSendDecision;
+    reserveForced(input: DocCreateDispatchInput): void;
+    prune(now: number): number;
+    private readWindow;
+    private insert;
+    private deleteExpired;
+}
+export declare function createDispatchGate(input: {
+    readonly ledger: DocCreateLedger;
+    readonly accountKey: string;
+    readonly requestId: string;
+    readonly source: DocCreateDispatchSource;
+    readonly now: () => number;
+    readonly guard?: () => void;
+}): AppSyncSendGate;
+export {};

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

@@ -0,0 +1,9 @@
+export { AppSyncCoordinator, AppSyncRemoteError } from './coordinator.js';
+export type { AppSyncCoordinatorDependencies } from './coordinator.js';
+export { AppSyncBudgetDeferredError, SqliteDocCreateLedger, createDispatchGate } from './create-ledger.js';
+export { AppSyncSessionFence } from './session-fence.js';
+export { AppSyncScopeRegistry, APP_SYNC_SCOPE_DEFINITION, APP_SYNC_SCOPE_SELECTORS, APP_SYNC_SCOPE_VERSION, fingerprintMarkdown, normalizeResolvedRootSegments, } from './scope.js';
+export { SqliteAppSyncStore } from './sqlite-store.js';
+export type { AppSyncFrontMatterValidation, AppSyncRefValidation, AppSyncScopeDefinition, AppSyncScopeKind, } from './scope.js';
+export type { AppSyncGrantFenceToken, AppSyncSessionFenceToken } from './session-fence.js';
+export { APP_SYNC_APP_ID, APP_SYNC_CONTINUATION_MAX_PAGE_SIZE, APP_SYNC_CONTINUATION_MIN_INTERVAL_MS, APP_SYNC_FRONT_MATTER_MAX_BYTES, APP_SYNC_LOCAL_RECORD_LIMIT, APP_SYNC_PAGE_SIZE, DOC001_CREATE_LIMIT_PER_WINDOW, DOC001_CREATE_WINDOW_MS, type AppSyncBinding, type AppSyncBindingInput, type AppSyncBeginControlRequest, type AppSyncBeforeDispatchResult, type AppSyncCounts, type AppSyncControlRequest, type AppSyncControlRequestHandle, type AppSyncControlRequestIdentity, type AppSyncControlRequestKind, type AppSyncControlRequestState, type AppSyncControlResolution, type AppSyncConflict, type AppSyncConflictArchive, type AppSyncConflictArchiveInput, type AppSyncConflictChoice, type AppSyncConflictPreservationStatus, type AppSyncConflictResolutionInput, type AppSyncConflictResolutionResult, type AppSyncConflictState, type AppSyncConflictSummary, type AppSyncConflictVaultPort, type AppSyncAccountDataPurgeInput, type AppSyncAccountDataPurgeResult, type AppSyncContinuationApplyResult, type AppSyncContinuationCapability, type AppSyncContinuationEffect, type AppSyncContinuationSourceCheck, type AppSyncContinuationStore, type AppSyncCreateResult, type AppSyncCreationBudget, type AppSyncCreationClaim, type AppSyncCreationJob, type AppSyncDocumentOutcome, type AppSyncDocumentBaseline, type AppSyncDocumentInspection, type AppSyncDocumentPort, type AppSyncEligibility, type AppSyncFileEntry, type AppSyncFilePage, type AppSyncFileRead, type AppSyncGrant, type AppSyncGrantDoc, type AppSyncGrantDocsPage, type AppSyncDeletedRef, type AppSyncDeletedRefsPage, type AppSyncDiscoveryCheckpoint, type AppSyncPendingDiscovery, type AppSyncOperationFence, type AppSyncGrantInvalidation, type AppSyncGrantSnapshot, type AppSyncJobStatus, type AppSyncListConflictsInput, type AppSyncOperationContext, type AppSyncRemote, type AppSyncRemoteDocument, type AppSyncSendDecision, type AppSyncSendGate, type AppSyncResolveControlRequest, type AppSyncResult, type AppSyncResultStatus, type AppSyncScopeSelectors, type AppSyncSessionState, type AppSyncSnapshot, type AppSyncStatus, type AppSyncStore, type AppSyncWorkspacePort, type DocCreateDispatchInput, type DocCreateDispatchSource, type DocCreateLedger, type DocCreateLedgerPeek, } from './types.js';