@tinycloud/node-sdk 3.2.6-beta.5 → 3.3.0-beta.7

package/dist/index.d.cts

@@ -1,8 +1,11 @@
-import { ISigner, Bytes, CapabilityPresentationEnvelopeV1, IWasmBindings, PersistedSessionProof, ISessionManager } from '@tinycloud/sdk-core';
+import { ISigner, Bytes, IWasmBindings, PersistedSessionProof, ISessionManager } from '@tinycloud/sdk-core';
 export { ACCOUNT_REGISTRY_PATH, ACCOUNT_REGISTRY_SPACE, AccountApplication, AccountApplicationListOptions, AccountApplicationRegisterOptions, AccountDelegation, AccountDelegationListOptions, AccountDelegationPage, AccountDelegationQueryOptions, AccountDelegationRecord, AccountDelegationResource, AccountDelegationRevokeOptions, AccountIndexEnsureResult, AccountIndexRebuildResult, AccountIndexStatus, AccountIndexedReadOptions, AccountService, AccountServiceConfig, AccountSpace, AccountSpaceListOptions, AccountStatus, AuthorityRefusal, AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, BuildCanonicalDecryptRequestInput, BuildDecryptFactsInput, BuildDecryptInvocationInput, BuiltDecryptInvocation, CallbackStrategy, CanonicalAddress, CanonicalDecryptRequest, CanonicalJson, CanonicalParsedNetworkId, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, CaveatedDelegationUnsupportedError, ClientSession, ColumnInfo, ComposeManifestOptions, ComposedManifestRequest, CreateDelegationParams, DECRYPT_ACTION, DECRYPT_FACT_TYPE, DECRYPT_RESULT_TYPE, DEFAULT_ENCRYPTION_ALG, DEFAULT_KEY_VERSION, DEFAULT_MANIFEST_SPACE, DEFAULT_MANIFEST_VERSION, DEFAULT_SIGNED_READ_URL_EXPIRY_MS, DataVaultConfig, DataVaultService, DatabaseHandle, DecryptCapabilityProof, DecryptEnvelopeOptions, DecryptInvocationFact, DecryptInvocationSigner, DecryptRequestBody, DecryptResponseBody, DecryptTransport, DecryptTransportResponseError, DelegateReceivedShareParams, DelegatedShareAccess, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DelegationRevocationReceipt, DidCacheKeyOptions, DidEqualsOptions, DiscoverNetworkInput, DiscoveredNetwork, DiscoverySource, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, ENCRYPTION_NETWORK_URN_PREFIX, ENCRYPTION_SERVICE, ENCRYPTION_SERVICE_SHORT, ENVELOPE_VERSION, EncodedShareData, EncryptToNetworkInput, EncryptToNetworkOptions, EncryptToNetworkResult, EncryptionCrypto, EncryptionError, EncryptionErrorInput, EncryptionService, EncryptionServiceConfig, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, HookEvent, HookServiceName, HookStreamEvent, HookSubscription, HookWebhookListOptions, HookWebhookRecord, HookWebhookRegistration, HookWebhookScope, HookWebhookUnregisterOptions, HooksService, HooksServiceConfig, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IEncryptionService, IHooksService, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISecretsService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IStorageService, IUserAuthorization, IWasmBindings, IdentityParseError, IngestOptions, InlineEncryptedEnvelope, InvokeFunction, JWK, KVBatchReadResponse, KVCreateSignedReadUrlOptions, KVListPage, KVReadThrough, KVReplicaHandle, KVReplicaSpec, KVReplicaStorage, KVReplicationController, KVReplicationDeps, KVResponse, KVService, KVServiceConfig, KVSignedReadUrlResponse, KeyInfo, KeyProvider, KeyType, LocalGetResult, LocalListResult, LocalReadMeta, LocalReplicaStatus, LocalSyncResult, MAX_SECRET_SCOPE_LENGTH, Manifest, ManifestDefaults, ManifestRegistryRecord, ManifestSecretActions, ManifestValidationError, NETWORK_NAME_PATTERN, NetworkDescriptor, NetworkIdError, NodeDescriptorFetcher, OpenKeyCallbackStrategy, OpenKeySigningRequestBody, OpenKeySigningResponseBody, OpenKeySigningStrategyOptions, OwnerDelegationPermission, ParsedNetworkId, ParsedSecretCatalogKey, PendingWriteRecord, PendingWriteState, PendingWriteStore, PermissionEntry, PermissionNotInManifestError, PersistedSessionData, PinnedKey, PkhDidParts, PrefixedKVService, ProtocolMismatchError, PurgeTarget, QueryOptions, QueryResponse, RandomReceiverKeyInput, ReceiveOptions, ReceiverKeyPair, ReceiverKeySigner, RegisterBatchSuccess, RegisterPolicyV3Input, RegisterPolicyV3Receipt, ReplicaAuthorityState, ReplicaCoverage, ReplicaDevice, ReplicaGatedHandle, ReplicaGrantInfo, ReplicaInspectedStatus, ReplicaState, ReplicaStatusEntry, ReplicationAuthority, ReplicationControl, ReplicationEvent, ReplicationIdentity, ReplicationOptions, ReplicationPurgeReport, ReplicationReason, ReplicationScheduler, ResolvedCapabilities, ResolvedDelegate, ResolvedReplicationOptions, ResolvedSecretPath, ResourceCapability, SECRET_NAME_RE, SECRET_SCOPE_RE, SQLAction, SQLActionType, SQLService, SQLServiceConfig, STORAGE_FULL_MESSAGE, STORAGE_MANAGE_URL, STORAGE_WRITE_TOO_LARGE_MESSAGE, SchemaInfo, SecretCatalogEntry, SecretPayload, SecretPutOptions, SecretScopeOptions, SecretsError, SecretsService, ServiceContext, ServiceContextConfig, ServiceSession, SessionExpiredError, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignInOptions, SignRequest, SignResponse, SignedReceiverKeyInput, SilentNotificationHandler, Space, SpaceAbilitiesMap, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StorageAccountUsage, StorageFullEvent, StorageStatus, StorageStatusOptions, StorageUsage, StorageUsageState, StoredDelegationChain, SubscribeOptions, TC832_RESERVED_SCOPES, TableInfo, TelemetryConfig, TelemetryEventHandler, TinyCloud, TinyCloudConfig, TinyCloudDebugEnableOptions, TinyCloudDebugEvent, TinyCloudDebugLevel, TinyCloudDebugLogger, TinyCloudDebugTimer, TinyCloudSession, UnsupportedFeatureError, VAULT_PERMISSION_SERVICE, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultNetworkReadResult, VaultPublicSpaceKVActions, VaultPutOptions, VerifyDecryptResponseInput, VersionCheckError, ViewInfo, WasmVaultFunctions, WellKnownDescriptorFetcher, addressStorageKey, appSecretScope, buildCanonicalDecryptRequest, buildDecryptAttenuation, buildDecryptFacts, buildDecryptInvocation, buildNetworkId, buildSpaceUri, canonicalHashHex, canonicalSignedResponse, canonicalizeAddress, canonicalizeDid, canonicalizeDidUrl, canonicalizeEncryptionJson, canonicalizeNetworkId, canonicalizeSecretScope, checkDecryptInvocationInput, checkNodeInfo, clearTinyCloudDebugLogs, composeManifestRequest, createCapabilityKeyRegistry, createOpenKeyCallbackSigningStrategy, createSharingService, createSpaceService, createVaultCrypto, decryptEnvelopeWithKey, defaultSpaceCreationHandler, deriveSignedReceiverKey, didCacheKey, didEquals, disableTinyCloudDebug, discoverNetwork, enableTinyCloudDebug, encryptToNetwork, encryptionBase64Decode, encryptionBase64Encode, encryptionError, encryptionUtf8Decode, encryptionUtf8Encode, ensureNetworkUsableForDecrypt, expandActionShortNames, expandPermissionEntries, expandPermissionEntry, generateRandomReceiverKey, getTinyCloudDebugLogs, hexDecode, hexEncode, installTinyCloudDebugGlobals, isCapabilitySubset, isEvmAddress, isNetworkId, isStorageFullError, loadManifest, makePkhSpaceId, makePublicSpaceId, networkDiscoveryKey, openWrappedKey, parseCanonicalNetworkId, parseExpiry, parseNetworkId, parsePkhDid, parseSecretCatalogKey, parseSpaceUri, pkhDid, principalDid, principalDidEquals, resolveManifest, resolveSecretListPrefix, resolveSecretPath, resourceCapabilitiesToSpaceAbilitiesMap, storageUsageState, tinyCloudDebugLogger, validateEnvelope, validateManifest, verifyDecryptResponse } from '@tinycloud/sdk-core';
-export { A as ACCEPTED_MARKER_VERSIONS, a as AuthDelegationArtifact, b as AuthRequestArtifact, B as BOOTSTRAP_COMPLETION_MARKER_KEY, c as BOOTSTRAP_COMPLETION_MARKER_VERSION, d as BootstrapCompletionMarker, e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, i as DelegationAuthority, E as EnsureEncryptionNetworkOptions, F as FileSessionStorage, I as InvalidRestoredSessionError, M as MemorySessionStorage, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationConfig, O as OwnerDelegationReceipt, P as PortableDelegation, R as RUNTIME_DELEGATION_REJECTIONS, l as RestorableSession, m as RuntimeDelegationActivator, n as RuntimeDelegationRejectedError, o as RuntimeDelegationRejection, p as RuntimePermissionGrantOptions, S as SecretPermissionHint, q as SecretReadInput, r as SecretReadResult, s as SessionGrantProof, t as SignStrategy, T as TinyCloudNode, u as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, v as UnifiedOwnerRootReceipt, w as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, x as VerifiedSessionGrant, W as WasmKeyProvider, y as WasmKeyProviderConfig, z as activateCompactRuntimeDelegation, G as activateValidatedRuntimeDelegation, H as createWasmKeyProvider, J as defaultSignStrategy, K as deserializeDelegation, L as grantAuthRequest, Q as serializeDelegation, X as signedCompactUcanExpiry, Y as siweRuntimeDelegation } from './WasmKeyProvider-DEdSyQ0I.cjs';
+export { F as FileSessionStorage, M as MemorySessionStorage, W as WasmKeyProvider, a as WasmKeyProviderConfig, c as createWasmKeyProvider } from './WasmKeyProvider-5Ee7fcAw.cjs';
+export { A as ACCEPTED_MARKER_VERSIONS, a as AuthDelegationArtifact, b as AuthRequestArtifact, B as BOOTSTRAP_COMPLETION_MARKER_KEY, c as BOOTSTRAP_COMPLETION_MARKER_VERSION, d as BootstrapCompletionMarker, e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, i as DelegationAuthority, E as EnsureEncryptionNetworkOptions, I as InvalidRestoredSessionError, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationAuthorizeFn, l as NodeUserAuthorizationConfig, O as OpenKeyAuthorizationResultV1, m as OpenKeyAuthorizeInput, n as OpenKeyAuthorizeTinyCloud, o as OpenKeyBridgeInput, p as OwnerDelegationReceipt, P as PortableDelegation, R as RUNTIME_DELEGATION_REJECTIONS, q as RestorableSession, r as RuntimeDelegationActivator, s as RuntimeDelegationRejectedError, t as RuntimeDelegationRejection, u as RuntimePermissionGrantOptions, S as SecretPermissionHint, v as SecretReadInput, w as SecretReadResult, x as SessionGrantProof, y as SignStrategy, T as TinyCloudNode, z as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, F as UnifiedOwnerRootReceipt, G as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, H as VerifiedSessionGrant, J as activateCompactRuntimeDelegation, K as activateValidatedRuntimeDelegation, L as defaultSignStrategy, M as deserializeDelegation, Q as grantAuthRequest, W as serializeDelegation, X as signedCompactUcanExpiry, Y as siweRuntimeDelegation, Z as wireOpenKeyAuthorize } from './TinyCloudNode-BchWB_zv.cjs';
 import { invoke, invokeAny, computeCid, prepareSession, completeSessionSetup, ensureEip55, makeSpaceId, createDelegation, parseRecapFromSiwe, parseVerifiedRecapFromSiwe, generateHostSIWEMessage, siweToDelegationHeaders, protocolVersion, vault_encrypt, vault_decrypt, vault_derive_key, vault_x25519_from_seed, vault_x25519_dh, vault_random_bytes, vault_sha256 } from '@tinycloud/node-sdk-wasm';
 import { KVReplicaStorage } from '@tinycloud/sdk-services';
+import { ProfileReplicaPurge } from '@tinycloud/sdk-services/kv/replication';
+export { ProfileReplicaDeferredToken, ProfileReplicaPurge } from '@tinycloud/sdk-services/kv/replication';
 import 'events';
 
 /**
@@ -51,88 +54,6 @@ declare class PrivateKeySigner implements ISigner {
     signMessage(message: Bytes | string): Promise<string>;
 }
 
-/**
- * Structural shape of the OpenKey SDK's `authorizeTinyCloud()` method.
- * Callers pass any object that conforms to this shape — typically an
- * `OpenKey` instance from `@openkey/sdk` — without either package
- * needing to import from the other.
- */
-interface OpenKeyAuthorizeTinyCloud {
-    authorizeTinyCloud(request: {
-        protocolVersion: 1;
-        siwe: string;
-        keyId?: string;
-        jwk?: Record<string, unknown>;
-        host?: string;
-        /**
-         * Display-only presentation envelope. Forwarded to the OpenKey
-         * widget review UI. The envelope MUST NEVER expand authority — the
-         * ReCap payload remains the sole gate — and the widget/server
-         * validates and size-bounds it before use.
-         */
-        presentation?: CapabilityPresentationEnvelopeV1;
-    }): Promise<{
-        protocolVersion: 1;
-        address: string;
-        signature: string;
-        signedMessage: string;
-        selectedActionKeys: string[];
-        permissions: Array<{
-            service: string;
-            space: string;
-            path: string;
-            actions: string[];
-        }>;
-    }>;
-}
-interface OpenKeyBridgeInput {
-    protocolVersion: 1;
-    siwe: string;
-    jwk: Record<string, unknown>;
-    host?: string;
-    /** Optional keyId hint the caller wants OpenKey to bind to. */
-    keyId?: string;
-    /**
-     * Optional presentation envelope built by `NodeUserAuthorization`
-     * from its `_manifest`. Passed through to `authorizeTinyCloud` so the
-     * widget can render honest provenance labels and the OpenKey server
-     * can origin-bind the browser origin against the app's well-known
-     * manifest. Display-only.
-     */
-    presentation?: CapabilityPresentationEnvelopeV1;
-}
-type NodeUserAuthorizationAuthorizeFn = (input: OpenKeyBridgeInput) => Promise<{
-    protocolVersion: 1;
-    address: string;
-    signature: string;
-    signedMessage: string;
-    selectedActionKeys: string[];
-    permissions: Array<{
-        service: string;
-        space: string;
-        path: string;
-        actions: string[];
-    }>;
-}>;
-/**
- * Wire a concrete OpenKey-shaped SDK object into the `authorizeFn`
- * `NodeUserAuthorization.signInWithOpenKey` expects. Rejects any
- * response that does not carry the canonical rich-result shape so
- * wire drift shows up at the bridge boundary rather than deep inside
- * `signInWithOpenKeyResult`.
- *
- * @example
- * ```ts
- * import { OpenKey } from '@openkey/sdk';
- * import { wireOpenKeyAuthorize } from '@tinycloud/node-sdk';
- * const openkey = new OpenKey({ appName: 'my-app' });
- * await openkey.connect();
- * const authorize = wireOpenKeyAuthorize(openkey);
- * const clientSession = await nodeAuth.signInWithOpenKey(authorize);
- * ```
- */
-declare function wireOpenKeyAuthorize(openkey: OpenKeyAuthorizeTinyCloud): NodeUserAuthorizationAuthorizeFn;
-
 /**
  * Internal helpers for TinyCloudNode.delegateTo and the legacy
  * createDelegation compatibility shim. Exported from their own module so
@@ -201,10 +122,8 @@ declare class NodeWasmBindings implements IWasmBindings {
 type MutationGuard = <T>(section: () => Promise<T>) => Promise<T>;
 
 /**
- * `sqliteReplicaStorage` (TC-858 §6.3, §10.1-10.3, §11.1) — the Node/CLI
- * `KVReplicaStorage`: SQLite replicas under a per-identity partition, a
- * durable file pending store when a `guard` serializes mutations, a per-
- * replica `syncedThroughEpoch` fence, and purge across the device union.
+ * `sqliteReplicaStorage` — Node/CLI SQLite replicas with a mandatory
+ * profile lifecycle gate and durable identity-scoped pending file.
  *
  * `@tinycloud/replica`, `@tinycloud/replica/sqlite` and
  * `@tinycloud/node-sdk-wasm` load lazily — only inside `open`, `purge`,
@@ -216,6 +135,29 @@ type MutationGuard = <T>(section: () => Promise<T>) => Promise<T>;
  * pins the declarations against the real modules wherever replica IS built.
  */
 
+/** CLI-only crash fence; generic SQLite stores do not opt in to this path. */
+declare const REPLICA_LOGOUT_PENDING_FILE = "replica-logout-pending.json";
+/** Every CLI read path, including legacy replica commands, checks this marker before delivery. */
+declare function assertProfileLogoutClear(profileDir: string): void;
+/** The domain-separated owner binding persisted as a logout marker's `principalDigest`. */
+declare function logoutPrincipalDigest(principal: string): string;
+/** Exported for the CLI, which shows the same route for a recovery report's `gate_restored`. */
+declare const RESTORED_GATE_MESSAGE: string;
+/** Directory-fsync boundary: durable renames for the pending store (a test seam lets a unit test observe the code path). */
+type DirSync = (dir: string) => Promise<void>;
+/**
+ * CLI-facing profile lifecycle. `guard` is the same profile lock as CLI
+ * session/key writes and MUST be reentrant within one async call chain: the CLI
+ * calls this facade while it already holds that lock.
+ */
+declare function createProfileReplicaPurge(options: {
+    profileDir: string;
+    guard: MutationGuard;
+    /** Exact regular diagnostics file names the CLI writes directly under `replication/`. */
+    diagnosticFiles?: readonly string[];
+    /** Observe directory-fsync ordering in tests; production uses fsyncDir. @internal */
+    dirSync?: DirSync;
+}): ProfileReplicaPurge;
 /**
  * The public Node-entry adapter (§2.5): durable SQLite replicas partitioned
  * by canonical identity, and ALWAYS the durable partitioned pending-write
@@ -226,6 +168,10 @@ type MutationGuard = <T>(section: () => Promise<T>) => Promise<T>;
 declare function sqliteReplicaStorage(options: {
     dir: string;
     guard?: MutationGuard;
+    gateFile?: string;
+    logoutPendingFile?: string;
+    /** CLI opt-in; see `SqliteReplicaStorageOptions.diagnosticFiles`. */
+    diagnosticFiles?: readonly string[];
 }): KVReplicaStorage;
 
-export { type NodeUserAuthorizationAuthorizeFn, NodeWasmBindings, type OpenKeyAuthorizeTinyCloud, type OpenKeyBridgeInput, PrivateKeySigner, extractSiweExpiration, sqliteReplicaStorage, wireOpenKeyAuthorize };
+export { NodeWasmBindings, PrivateKeySigner, REPLICA_LOGOUT_PENDING_FILE, RESTORED_GATE_MESSAGE, assertProfileLogoutClear, createProfileReplicaPurge, extractSiweExpiration, logoutPrincipalDigest, sqliteReplicaStorage };

package/dist/index.d.ts

@@ -1,8 +1,11 @@
-import { ISigner, Bytes, CapabilityPresentationEnvelopeV1, IWasmBindings, PersistedSessionProof, ISessionManager } from '@tinycloud/sdk-core';
+import { ISigner, Bytes, IWasmBindings, PersistedSessionProof, ISessionManager } from '@tinycloud/sdk-core';
 export { ACCOUNT_REGISTRY_PATH, ACCOUNT_REGISTRY_SPACE, AccountApplication, AccountApplicationListOptions, AccountApplicationRegisterOptions, AccountDelegation, AccountDelegationListOptions, AccountDelegationPage, AccountDelegationQueryOptions, AccountDelegationRecord, AccountDelegationResource, AccountDelegationRevokeOptions, AccountIndexEnsureResult, AccountIndexRebuildResult, AccountIndexStatus, AccountIndexedReadOptions, AccountService, AccountServiceConfig, AccountSpace, AccountSpaceListOptions, AccountStatus, AuthorityRefusal, AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, BuildCanonicalDecryptRequestInput, BuildDecryptFactsInput, BuildDecryptInvocationInput, BuiltDecryptInvocation, CallbackStrategy, CanonicalAddress, CanonicalDecryptRequest, CanonicalJson, CanonicalParsedNetworkId, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, CaveatedDelegationUnsupportedError, ClientSession, ColumnInfo, ComposeManifestOptions, ComposedManifestRequest, CreateDelegationParams, DECRYPT_ACTION, DECRYPT_FACT_TYPE, DECRYPT_RESULT_TYPE, DEFAULT_ENCRYPTION_ALG, DEFAULT_KEY_VERSION, DEFAULT_MANIFEST_SPACE, DEFAULT_MANIFEST_VERSION, DEFAULT_SIGNED_READ_URL_EXPIRY_MS, DataVaultConfig, DataVaultService, DatabaseHandle, DecryptCapabilityProof, DecryptEnvelopeOptions, DecryptInvocationFact, DecryptInvocationSigner, DecryptRequestBody, DecryptResponseBody, DecryptTransport, DecryptTransportResponseError, DelegateReceivedShareParams, DelegatedShareAccess, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DelegationRevocationReceipt, DidCacheKeyOptions, DidEqualsOptions, DiscoverNetworkInput, DiscoveredNetwork, DiscoverySource, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, ENCRYPTION_NETWORK_URN_PREFIX, ENCRYPTION_SERVICE, ENCRYPTION_SERVICE_SHORT, ENVELOPE_VERSION, EncodedShareData, EncryptToNetworkInput, EncryptToNetworkOptions, EncryptToNetworkResult, EncryptionCrypto, EncryptionError, EncryptionErrorInput, EncryptionService, EncryptionServiceConfig, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, HookEvent, HookServiceName, HookStreamEvent, HookSubscription, HookWebhookListOptions, HookWebhookRecord, HookWebhookRegistration, HookWebhookScope, HookWebhookUnregisterOptions, HooksService, HooksServiceConfig, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IEncryptionService, IHooksService, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISecretsService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IStorageService, IUserAuthorization, IWasmBindings, IdentityParseError, IngestOptions, InlineEncryptedEnvelope, InvokeFunction, JWK, KVBatchReadResponse, KVCreateSignedReadUrlOptions, KVListPage, KVReadThrough, KVReplicaHandle, KVReplicaSpec, KVReplicaStorage, KVReplicationController, KVReplicationDeps, KVResponse, KVService, KVServiceConfig, KVSignedReadUrlResponse, KeyInfo, KeyProvider, KeyType, LocalGetResult, LocalListResult, LocalReadMeta, LocalReplicaStatus, LocalSyncResult, MAX_SECRET_SCOPE_LENGTH, Manifest, ManifestDefaults, ManifestRegistryRecord, ManifestSecretActions, ManifestValidationError, NETWORK_NAME_PATTERN, NetworkDescriptor, NetworkIdError, NodeDescriptorFetcher, OpenKeyCallbackStrategy, OpenKeySigningRequestBody, OpenKeySigningResponseBody, OpenKeySigningStrategyOptions, OwnerDelegationPermission, ParsedNetworkId, ParsedSecretCatalogKey, PendingWriteRecord, PendingWriteState, PendingWriteStore, PermissionEntry, PermissionNotInManifestError, PersistedSessionData, PinnedKey, PkhDidParts, PrefixedKVService, ProtocolMismatchError, PurgeTarget, QueryOptions, QueryResponse, RandomReceiverKeyInput, ReceiveOptions, ReceiverKeyPair, ReceiverKeySigner, RegisterBatchSuccess, RegisterPolicyV3Input, RegisterPolicyV3Receipt, ReplicaAuthorityState, ReplicaCoverage, ReplicaDevice, ReplicaGatedHandle, ReplicaGrantInfo, ReplicaInspectedStatus, ReplicaState, ReplicaStatusEntry, ReplicationAuthority, ReplicationControl, ReplicationEvent, ReplicationIdentity, ReplicationOptions, ReplicationPurgeReport, ReplicationReason, ReplicationScheduler, ResolvedCapabilities, ResolvedDelegate, ResolvedReplicationOptions, ResolvedSecretPath, ResourceCapability, SECRET_NAME_RE, SECRET_SCOPE_RE, SQLAction, SQLActionType, SQLService, SQLServiceConfig, STORAGE_FULL_MESSAGE, STORAGE_MANAGE_URL, STORAGE_WRITE_TOO_LARGE_MESSAGE, SchemaInfo, SecretCatalogEntry, SecretPayload, SecretPutOptions, SecretScopeOptions, SecretsError, SecretsService, ServiceContext, ServiceContextConfig, ServiceSession, SessionExpiredError, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignInOptions, SignRequest, SignResponse, SignedReceiverKeyInput, SilentNotificationHandler, Space, SpaceAbilitiesMap, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StorageAccountUsage, StorageFullEvent, StorageStatus, StorageStatusOptions, StorageUsage, StorageUsageState, StoredDelegationChain, SubscribeOptions, TC832_RESERVED_SCOPES, TableInfo, TelemetryConfig, TelemetryEventHandler, TinyCloud, TinyCloudConfig, TinyCloudDebugEnableOptions, TinyCloudDebugEvent, TinyCloudDebugLevel, TinyCloudDebugLogger, TinyCloudDebugTimer, TinyCloudSession, UnsupportedFeatureError, VAULT_PERMISSION_SERVICE, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultNetworkReadResult, VaultPublicSpaceKVActions, VaultPutOptions, VerifyDecryptResponseInput, VersionCheckError, ViewInfo, WasmVaultFunctions, WellKnownDescriptorFetcher, addressStorageKey, appSecretScope, buildCanonicalDecryptRequest, buildDecryptAttenuation, buildDecryptFacts, buildDecryptInvocation, buildNetworkId, buildSpaceUri, canonicalHashHex, canonicalSignedResponse, canonicalizeAddress, canonicalizeDid, canonicalizeDidUrl, canonicalizeEncryptionJson, canonicalizeNetworkId, canonicalizeSecretScope, checkDecryptInvocationInput, checkNodeInfo, clearTinyCloudDebugLogs, composeManifestRequest, createCapabilityKeyRegistry, createOpenKeyCallbackSigningStrategy, createSharingService, createSpaceService, createVaultCrypto, decryptEnvelopeWithKey, defaultSpaceCreationHandler, deriveSignedReceiverKey, didCacheKey, didEquals, disableTinyCloudDebug, discoverNetwork, enableTinyCloudDebug, encryptToNetwork, encryptionBase64Decode, encryptionBase64Encode, encryptionError, encryptionUtf8Decode, encryptionUtf8Encode, ensureNetworkUsableForDecrypt, expandActionShortNames, expandPermissionEntries, expandPermissionEntry, generateRandomReceiverKey, getTinyCloudDebugLogs, hexDecode, hexEncode, installTinyCloudDebugGlobals, isCapabilitySubset, isEvmAddress, isNetworkId, isStorageFullError, loadManifest, makePkhSpaceId, makePublicSpaceId, networkDiscoveryKey, openWrappedKey, parseCanonicalNetworkId, parseExpiry, parseNetworkId, parsePkhDid, parseSecretCatalogKey, parseSpaceUri, pkhDid, principalDid, principalDidEquals, resolveManifest, resolveSecretListPrefix, resolveSecretPath, resourceCapabilitiesToSpaceAbilitiesMap, storageUsageState, tinyCloudDebugLogger, validateEnvelope, validateManifest, verifyDecryptResponse } from '@tinycloud/sdk-core';
-export { A as ACCEPTED_MARKER_VERSIONS, a as AuthDelegationArtifact, b as AuthRequestArtifact, B as BOOTSTRAP_COMPLETION_MARKER_KEY, c as BOOTSTRAP_COMPLETION_MARKER_VERSION, d as BootstrapCompletionMarker, e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, i as DelegationAuthority, E as EnsureEncryptionNetworkOptions, F as FileSessionStorage, I as InvalidRestoredSessionError, M as MemorySessionStorage, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationConfig, O as OwnerDelegationReceipt, P as PortableDelegation, R as RUNTIME_DELEGATION_REJECTIONS, l as RestorableSession, m as RuntimeDelegationActivator, n as RuntimeDelegationRejectedError, o as RuntimeDelegationRejection, p as RuntimePermissionGrantOptions, S as SecretPermissionHint, q as SecretReadInput, r as SecretReadResult, s as SessionGrantProof, t as SignStrategy, T as TinyCloudNode, u as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, v as UnifiedOwnerRootReceipt, w as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, x as VerifiedSessionGrant, W as WasmKeyProvider, y as WasmKeyProviderConfig, z as activateCompactRuntimeDelegation, G as activateValidatedRuntimeDelegation, H as createWasmKeyProvider, J as defaultSignStrategy, K as deserializeDelegation, L as grantAuthRequest, Q as serializeDelegation, X as signedCompactUcanExpiry, Y as siweRuntimeDelegation } from './WasmKeyProvider-DEdSyQ0I.js';
+export { F as FileSessionStorage, M as MemorySessionStorage, W as WasmKeyProvider, a as WasmKeyProviderConfig, c as createWasmKeyProvider } from './WasmKeyProvider-5Ee7fcAw.js';
+export { A as ACCEPTED_MARKER_VERSIONS, a as AuthDelegationArtifact, b as AuthRequestArtifact, B as BOOTSTRAP_COMPLETION_MARKER_KEY, c as BOOTSTRAP_COMPLETION_MARKER_VERSION, d as BootstrapCompletionMarker, e as BootstrapWarning, C as CompactRuntimeDelegationInput, f as CreateOwnerDelegationParams, D as DelegateToOptions, g as DelegateToResult, h as DelegatedAccess, i as DelegationAuthority, E as EnsureEncryptionNetworkOptions, I as InvalidRestoredSessionError, N as NodeEventEmitterStrategy, j as NodeUserAuthorization, k as NodeUserAuthorizationAuthorizeFn, l as NodeUserAuthorizationConfig, O as OpenKeyAuthorizationResultV1, m as OpenKeyAuthorizeInput, n as OpenKeyAuthorizeTinyCloud, o as OpenKeyBridgeInput, p as OwnerDelegationReceipt, P as PortableDelegation, R as RUNTIME_DELEGATION_REJECTIONS, q as RestorableSession, r as RuntimeDelegationActivator, s as RuntimeDelegationRejectedError, t as RuntimeDelegationRejection, u as RuntimePermissionGrantOptions, S as SecretPermissionHint, v as SecretReadInput, w as SecretReadResult, x as SessionGrantProof, y as SignStrategy, T as TinyCloudNode, z as TinyCloudNodeConfig, U as UnifiedOwnerRootInput, F as UnifiedOwnerRootReceipt, G as UnsupportedSessionRestoreError, V as ValidatedRuntimeDelegation, H as VerifiedSessionGrant, J as activateCompactRuntimeDelegation, K as activateValidatedRuntimeDelegation, L as defaultSignStrategy, M as deserializeDelegation, Q as grantAuthRequest, W as serializeDelegation, X as signedCompactUcanExpiry, Y as siweRuntimeDelegation, Z as wireOpenKeyAuthorize } from './TinyCloudNode-BchWB_zv.js';
 import { invoke, invokeAny, computeCid, prepareSession, completeSessionSetup, ensureEip55, makeSpaceId, createDelegation, parseRecapFromSiwe, parseVerifiedRecapFromSiwe, generateHostSIWEMessage, siweToDelegationHeaders, protocolVersion, vault_encrypt, vault_decrypt, vault_derive_key, vault_x25519_from_seed, vault_x25519_dh, vault_random_bytes, vault_sha256 } from '@tinycloud/node-sdk-wasm';
 import { KVReplicaStorage } from '@tinycloud/sdk-services';
+import { ProfileReplicaPurge } from '@tinycloud/sdk-services/kv/replication';
+export { ProfileReplicaDeferredToken, ProfileReplicaPurge } from '@tinycloud/sdk-services/kv/replication';
 import 'events';
 
 /**
@@ -51,88 +54,6 @@ declare class PrivateKeySigner implements ISigner {
     signMessage(message: Bytes | string): Promise<string>;
 }
 
-/**
- * Structural shape of the OpenKey SDK's `authorizeTinyCloud()` method.
- * Callers pass any object that conforms to this shape — typically an
- * `OpenKey` instance from `@openkey/sdk` — without either package
- * needing to import from the other.
- */
-interface OpenKeyAuthorizeTinyCloud {
-    authorizeTinyCloud(request: {
-        protocolVersion: 1;
-        siwe: string;
-        keyId?: string;
-        jwk?: Record<string, unknown>;
-        host?: string;
-        /**
-         * Display-only presentation envelope. Forwarded to the OpenKey
-         * widget review UI. The envelope MUST NEVER expand authority — the
-         * ReCap payload remains the sole gate — and the widget/server
-         * validates and size-bounds it before use.
-         */
-        presentation?: CapabilityPresentationEnvelopeV1;
-    }): Promise<{
-        protocolVersion: 1;
-        address: string;
-        signature: string;
-        signedMessage: string;
-        selectedActionKeys: string[];
-        permissions: Array<{
-            service: string;
-            space: string;
-            path: string;
-            actions: string[];
-        }>;
-    }>;
-}
-interface OpenKeyBridgeInput {
-    protocolVersion: 1;
-    siwe: string;
-    jwk: Record<string, unknown>;
-    host?: string;
-    /** Optional keyId hint the caller wants OpenKey to bind to. */
-    keyId?: string;
-    /**
-     * Optional presentation envelope built by `NodeUserAuthorization`
-     * from its `_manifest`. Passed through to `authorizeTinyCloud` so the
-     * widget can render honest provenance labels and the OpenKey server
-     * can origin-bind the browser origin against the app's well-known
-     * manifest. Display-only.
-     */
-    presentation?: CapabilityPresentationEnvelopeV1;
-}
-type NodeUserAuthorizationAuthorizeFn = (input: OpenKeyBridgeInput) => Promise<{
-    protocolVersion: 1;
-    address: string;
-    signature: string;
-    signedMessage: string;
-    selectedActionKeys: string[];
-    permissions: Array<{
-        service: string;
-        space: string;
-        path: string;
-        actions: string[];
-    }>;
-}>;
-/**
- * Wire a concrete OpenKey-shaped SDK object into the `authorizeFn`
- * `NodeUserAuthorization.signInWithOpenKey` expects. Rejects any
- * response that does not carry the canonical rich-result shape so
- * wire drift shows up at the bridge boundary rather than deep inside
- * `signInWithOpenKeyResult`.
- *
- * @example
- * ```ts
- * import { OpenKey } from '@openkey/sdk';
- * import { wireOpenKeyAuthorize } from '@tinycloud/node-sdk';
- * const openkey = new OpenKey({ appName: 'my-app' });
- * await openkey.connect();
- * const authorize = wireOpenKeyAuthorize(openkey);
- * const clientSession = await nodeAuth.signInWithOpenKey(authorize);
- * ```
- */
-declare function wireOpenKeyAuthorize(openkey: OpenKeyAuthorizeTinyCloud): NodeUserAuthorizationAuthorizeFn;
-
 /**
  * Internal helpers for TinyCloudNode.delegateTo and the legacy
  * createDelegation compatibility shim. Exported from their own module so
@@ -201,10 +122,8 @@ declare class NodeWasmBindings implements IWasmBindings {
 type MutationGuard = <T>(section: () => Promise<T>) => Promise<T>;
 
 /**
- * `sqliteReplicaStorage` (TC-858 §6.3, §10.1-10.3, §11.1) — the Node/CLI
- * `KVReplicaStorage`: SQLite replicas under a per-identity partition, a
- * durable file pending store when a `guard` serializes mutations, a per-
- * replica `syncedThroughEpoch` fence, and purge across the device union.
+ * `sqliteReplicaStorage` — Node/CLI SQLite replicas with a mandatory
+ * profile lifecycle gate and durable identity-scoped pending file.
  *
  * `@tinycloud/replica`, `@tinycloud/replica/sqlite` and
  * `@tinycloud/node-sdk-wasm` load lazily — only inside `open`, `purge`,
@@ -216,6 +135,29 @@ type MutationGuard = <T>(section: () => Promise<T>) => Promise<T>;
  * pins the declarations against the real modules wherever replica IS built.
  */
 
+/** CLI-only crash fence; generic SQLite stores do not opt in to this path. */
+declare const REPLICA_LOGOUT_PENDING_FILE = "replica-logout-pending.json";
+/** Every CLI read path, including legacy replica commands, checks this marker before delivery. */
+declare function assertProfileLogoutClear(profileDir: string): void;
+/** The domain-separated owner binding persisted as a logout marker's `principalDigest`. */
+declare function logoutPrincipalDigest(principal: string): string;
+/** Exported for the CLI, which shows the same route for a recovery report's `gate_restored`. */
+declare const RESTORED_GATE_MESSAGE: string;
+/** Directory-fsync boundary: durable renames for the pending store (a test seam lets a unit test observe the code path). */
+type DirSync = (dir: string) => Promise<void>;
+/**
+ * CLI-facing profile lifecycle. `guard` is the same profile lock as CLI
+ * session/key writes and MUST be reentrant within one async call chain: the CLI
+ * calls this facade while it already holds that lock.
+ */
+declare function createProfileReplicaPurge(options: {
+    profileDir: string;
+    guard: MutationGuard;
+    /** Exact regular diagnostics file names the CLI writes directly under `replication/`. */
+    diagnosticFiles?: readonly string[];
+    /** Observe directory-fsync ordering in tests; production uses fsyncDir. @internal */
+    dirSync?: DirSync;
+}): ProfileReplicaPurge;
 /**
  * The public Node-entry adapter (§2.5): durable SQLite replicas partitioned
  * by canonical identity, and ALWAYS the durable partitioned pending-write
@@ -226,6 +168,10 @@ type MutationGuard = <T>(section: () => Promise<T>) => Promise<T>;
 declare function sqliteReplicaStorage(options: {
     dir: string;
     guard?: MutationGuard;
+    gateFile?: string;
+    logoutPendingFile?: string;
+    /** CLI opt-in; see `SqliteReplicaStorageOptions.diagnosticFiles`. */
+    diagnosticFiles?: readonly string[];
 }): KVReplicaStorage;
 
-export { type NodeUserAuthorizationAuthorizeFn, NodeWasmBindings, type OpenKeyAuthorizeTinyCloud, type OpenKeyBridgeInput, PrivateKeySigner, extractSiweExpiration, sqliteReplicaStorage, wireOpenKeyAuthorize };
+export { NodeWasmBindings, PrivateKeySigner, REPLICA_LOGOUT_PENDING_FILE, RESTORED_GATE_MESSAGE, assertProfileLogoutClear, createProfileReplicaPurge, extractSiweExpiration, logoutPrincipalDigest, sqliteReplicaStorage };