@tinycloud/sdk-services 3.7.0 → 3.8.0-beta.2

package/dist/kv/replication/index.d.cts

@@ -1,5 +1,5 @@
-import { K as KVReplicationDeps, a as KVReplicationController, R as ReplicationIdentity, P as PendingWriteStore } from '../../scope-44m8GKdi.cjs';
-export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, b as KVListPage, c as KVReadThrough, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, m as PinnedKey, n as ProfileReplicaApprovalEntry, o as ProfileReplicaDeferredDenyOutcome, p as ProfileReplicaDeferredToken, q as ProfileReplicaLogoutPending, r as ProfileReplicaPreflight, s as ProfileReplicaPurge, t as ProfileReplicaRemoteLogoutState, u as ProfileReplicaRootIdentity, v as ProfileReplicaUnknownEntry, w as PurgeTarget, x as ReplicaAccountGate, y as ReplicaAdmitHook, z as ReplicaAuthorityState, B as ReplicaBrowserGateAccess, D as ReplicaBrowserGateSnapshot, E as ReplicaBrowserGateTx, F as ReplicaBrowserPageAdmission, G as ReplicaClock, H as ReplicaCoverage, I as ReplicaDeliveryDecision, J as ReplicaDenyInput, M as ReplicaDenyOutcome, N as ReplicaDevice, O as ReplicaEraseReport, Q as ReplicaGateAccess, S as ReplicaGateReason, T as ReplicaGateScope, U as ReplicaGateSnapshot, V as ReplicaGateTx, W as ReplicaGatedError, X as ReplicaGatedHandle, Y as ReplicaGatedSpec, Z as ReplicaGatedStorage, _ as ReplicaGrantInfo, $ as ReplicaGuardedStore, a0 as ReplicaInspectedStatus, a1 as ReplicaLifecycleGate, a2 as ReplicaPageAdmission, a3 as ReplicaPartitionEraser, a4 as ReplicaPartitionIndexEntry, a5 as ReplicaPeerCommit, a6 as ReplicaPrivateGateHash, a7 as ReplicaPurgeIntent, a8 as ReplicaQuotaLedger, a9 as ReplicaQuotaSpec, aa as ReplicaSessionStamp, ab as ReplicaStampedReply, ac as ReplicaState, ad as ReplicaStatusEntry, ae as ReplicationAuthority, af as ReplicationControl, ag as ReplicationEvent, ah as ReplicationOptions, ai as ReplicationPurgeReport, aj as ReplicationReason, ak as ReplicationScheduler, al as ResolvedReplicationOptions, am as SaltedHash, an as canonicalReplicationIdentity, ao as replicationIdentityKey, ap as requiresSecretsOptIn } from '../../scope-44m8GKdi.cjs';
+import { K as KVReplicationDeps, a as KVReplicationController, R as ReplicationIdentity, P as PendingWriteStore } from '../../scope-D7bzmU6F.cjs';
+export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, b as KVListPage, c as KVReadThrough, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, m as PinnedKey, n as ProfileReplicaApprovalEntry, o as ProfileReplicaDeferredDenyOutcome, p as ProfileReplicaDeferredToken, q as ProfileReplicaLogoutPending, r as ProfileReplicaPreflight, s as ProfileReplicaPurge, t as ProfileReplicaRemoteLogoutState, u as ProfileReplicaRootIdentity, v as ProfileReplicaUnknownEntry, w as PurgeTarget, x as ReplicaAccountGate, y as ReplicaAdmitHook, z as ReplicaAuthorityState, B as ReplicaBrowserGateAccess, D as ReplicaBrowserGateSnapshot, E as ReplicaBrowserGateTx, F as ReplicaBrowserPageAdmission, G as ReplicaClock, H as ReplicaCoverage, I as ReplicaDeliveryDecision, J as ReplicaDenyInput, M as ReplicaDenyOutcome, N as ReplicaDevice, O as ReplicaEraseReport, Q as ReplicaGateAccess, S as ReplicaGateReason, T as ReplicaGateScope, U as ReplicaGateSnapshot, V as ReplicaGateTx, W as ReplicaGatedError, X as ReplicaGatedHandle, Y as ReplicaGatedSpec, Z as ReplicaGatedStorage, _ as ReplicaGrantInfo, $ as ReplicaGuardedStore, a0 as ReplicaInspectedStatus, a1 as ReplicaLifecycleGate, a2 as ReplicaLocalEraseOutcome, a3 as ReplicaPageAdmission, a4 as ReplicaPartitionEraser, a5 as ReplicaPartitionIndexEntry, a6 as ReplicaPeerCommit, a7 as ReplicaPrivateGateHash, a8 as ReplicaPurgeError, a9 as ReplicaPurgeFailedEvent, aa as ReplicaPurgeIntent, ab as ReplicaPurgeLocalCopyResult, ac as ReplicaPurgeTrigger, ad as ReplicaQuotaLedger, ae as ReplicaQuotaSpec, af as ReplicaSessionStamp, ag as ReplicaStampedReply, ah as ReplicaState, ai as ReplicaStatusEntry, aj as ReplicationAuthority, ak as ReplicationControl, al as ReplicationEvent, am as ReplicationOptions, an as ReplicationPurgeReport, ao as ReplicationReason, ap as ReplicationScheduler, aq as ResolvedReplicationOptions, ar as SaltedHash, as as canonicalReplicationIdentity, at as replicationIdentityKey, au as requiresSecretsOptIn } from '../../scope-D7bzmU6F.cjs';
 export { ClampConsentAnchor, ConsentDeadlineMs, EffectiveGrantExpiry, EffectiveGrantExpiryInput, MintRemainingMs, NeedsSilentRenewal, ReplicaConsentAnchor, ReplicaConsentSource, ReplicaGrantPolicy } from './grantPolicyTypes.cjs';
 export { kvPrefixCovers } from './prefix.cjs';
 import '../../types-DAOyIbXu.cjs';

package/dist/kv/replication/index.d.ts

@@ -1,5 +1,5 @@
-import { K as KVReplicationDeps, a as KVReplicationController, R as ReplicationIdentity, P as PendingWriteStore } from '../../scope-CAJbG-yz.js';
-export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, b as KVListPage, c as KVReadThrough, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, m as PinnedKey, n as ProfileReplicaApprovalEntry, o as ProfileReplicaDeferredDenyOutcome, p as ProfileReplicaDeferredToken, q as ProfileReplicaLogoutPending, r as ProfileReplicaPreflight, s as ProfileReplicaPurge, t as ProfileReplicaRemoteLogoutState, u as ProfileReplicaRootIdentity, v as ProfileReplicaUnknownEntry, w as PurgeTarget, x as ReplicaAccountGate, y as ReplicaAdmitHook, z as ReplicaAuthorityState, B as ReplicaBrowserGateAccess, D as ReplicaBrowserGateSnapshot, E as ReplicaBrowserGateTx, F as ReplicaBrowserPageAdmission, G as ReplicaClock, H as ReplicaCoverage, I as ReplicaDeliveryDecision, J as ReplicaDenyInput, M as ReplicaDenyOutcome, N as ReplicaDevice, O as ReplicaEraseReport, Q as ReplicaGateAccess, S as ReplicaGateReason, T as ReplicaGateScope, U as ReplicaGateSnapshot, V as ReplicaGateTx, W as ReplicaGatedError, X as ReplicaGatedHandle, Y as ReplicaGatedSpec, Z as ReplicaGatedStorage, _ as ReplicaGrantInfo, $ as ReplicaGuardedStore, a0 as ReplicaInspectedStatus, a1 as ReplicaLifecycleGate, a2 as ReplicaPageAdmission, a3 as ReplicaPartitionEraser, a4 as ReplicaPartitionIndexEntry, a5 as ReplicaPeerCommit, a6 as ReplicaPrivateGateHash, a7 as ReplicaPurgeIntent, a8 as ReplicaQuotaLedger, a9 as ReplicaQuotaSpec, aa as ReplicaSessionStamp, ab as ReplicaStampedReply, ac as ReplicaState, ad as ReplicaStatusEntry, ae as ReplicationAuthority, af as ReplicationControl, ag as ReplicationEvent, ah as ReplicationOptions, ai as ReplicationPurgeReport, aj as ReplicationReason, ak as ReplicationScheduler, al as ResolvedReplicationOptions, am as SaltedHash, an as canonicalReplicationIdentity, ao as replicationIdentityKey, ap as requiresSecretsOptIn } from '../../scope-CAJbG-yz.js';
+import { K as KVReplicationDeps, a as KVReplicationController, R as ReplicationIdentity, P as PendingWriteStore } from '../../scope-_HAUxOPl.js';
+export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, b as KVListPage, c as KVReadThrough, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, m as PinnedKey, n as ProfileReplicaApprovalEntry, o as ProfileReplicaDeferredDenyOutcome, p as ProfileReplicaDeferredToken, q as ProfileReplicaLogoutPending, r as ProfileReplicaPreflight, s as ProfileReplicaPurge, t as ProfileReplicaRemoteLogoutState, u as ProfileReplicaRootIdentity, v as ProfileReplicaUnknownEntry, w as PurgeTarget, x as ReplicaAccountGate, y as ReplicaAdmitHook, z as ReplicaAuthorityState, B as ReplicaBrowserGateAccess, D as ReplicaBrowserGateSnapshot, E as ReplicaBrowserGateTx, F as ReplicaBrowserPageAdmission, G as ReplicaClock, H as ReplicaCoverage, I as ReplicaDeliveryDecision, J as ReplicaDenyInput, M as ReplicaDenyOutcome, N as ReplicaDevice, O as ReplicaEraseReport, Q as ReplicaGateAccess, S as ReplicaGateReason, T as ReplicaGateScope, U as ReplicaGateSnapshot, V as ReplicaGateTx, W as ReplicaGatedError, X as ReplicaGatedHandle, Y as ReplicaGatedSpec, Z as ReplicaGatedStorage, _ as ReplicaGrantInfo, $ as ReplicaGuardedStore, a0 as ReplicaInspectedStatus, a1 as ReplicaLifecycleGate, a2 as ReplicaLocalEraseOutcome, a3 as ReplicaPageAdmission, a4 as ReplicaPartitionEraser, a5 as ReplicaPartitionIndexEntry, a6 as ReplicaPeerCommit, a7 as ReplicaPrivateGateHash, a8 as ReplicaPurgeError, a9 as ReplicaPurgeFailedEvent, aa as ReplicaPurgeIntent, ab as ReplicaPurgeLocalCopyResult, ac as ReplicaPurgeTrigger, ad as ReplicaQuotaLedger, ae as ReplicaQuotaSpec, af as ReplicaSessionStamp, ag as ReplicaStampedReply, ah as ReplicaState, ai as ReplicaStatusEntry, aj as ReplicationAuthority, ak as ReplicationControl, al as ReplicationEvent, am as ReplicationOptions, an as ReplicationPurgeReport, ao as ReplicationReason, ap as ReplicationScheduler, aq as ResolvedReplicationOptions, ar as SaltedHash, as as canonicalReplicationIdentity, at as replicationIdentityKey, au as requiresSecretsOptIn } from '../../scope-_HAUxOPl.js';
 export { ClampConsentAnchor, ConsentDeadlineMs, EffectiveGrantExpiry, EffectiveGrantExpiryInput, MintRemainingMs, NeedsSilentRenewal, ReplicaConsentAnchor, ReplicaConsentSource, ReplicaGrantPolicy } from './grantPolicyTypes.js';
 export { kvPrefixCovers } from './prefix.js';
 import '../../types-DAOyIbXu.js';

package/dist/{scope-44m8GKdi.d.cts → scope-D7bzmU6F.d.cts}

@@ -591,7 +591,9 @@ type ReplicaGateReason =
 /** Browser only: the `localStorage` logout marker is set. */
  | "logout_pending"
 /** The gate store itself could not be read; fail closed. */
- | "gate_unavailable";
+ | "gate_unavailable"
+/** Browser: replication is configured but no wallet provider can prove the connected account. */
+ | "wallet_provider_required";
 /** Shape of every gate refusal error: `Error & { code: "REPLICA_GATED"; gate }`. */
 interface ReplicaGatedError extends Error {
     code: "REPLICA_GATED";
@@ -877,6 +879,63 @@ interface ReplicaLifecycleGate {
     }): Promise<ReplicaEraseReport>;
     /** Outstanding intents; non-empty means status `purgePending: true`. */
     pendingPurge(): Promise<ReplicaPurgeIntent[]>;
+    /**
+     * Browser only. Under the gate lock, erases pending intents and deletes the whole origin
+     * database. Deletes only when nothing live is at stake: the gate is denied (null principal),
+     * the gate is behind the persisted deny tombstone, or the logout marker is set with a tombstone.
+     * A live or other-account gate is `refused` and left untouched. On a failed delete it sets the
+     * logout marker (when a tombstone exists) so `recover` finishes the erase on the next load.
+     * Never clears the deny tombstone.
+     */
+    eraseLocalCopy?(o: {
+        signal: AbortSignal;
+    }): Promise<ReplicaLocalEraseOutcome>;
+}
+/** Result of {@link ReplicaLifecycleGate.eraseLocalCopy}. */
+type ReplicaLocalEraseOutcome = 
+/** The database is gone and the logout marker (if any) is cleared. */
+{
+    status: "erased";
+}
+/** Delete blocked or storage error; a retry can succeed. `marker` is true when the next-load marker is set. */
+ | {
+    status: "failed";
+    code: string;
+    marker: boolean;
+}
+/** The gate does not authorize destruction; nothing was deleted. A retry cannot succeed until the gate is denied. */
+ | {
+    status: "refused";
+    code: string;
+};
+/** What triggered a local-copy erase. */
+type ReplicaPurgeTrigger = "sign_out" | "account_switch" | "purge_local_copy";
+/** Result of `replication.purgeLocalCopy()`. `retryNow` means a short bounded retry is meaningful. */
+type ReplicaPurgeLocalCopyResult = {
+    ok: true;
+} | {
+    ok: false;
+    retryNow: boolean;
+};
+/**
+ * Emitted (`on("replica.purge.failed", …)`) when the local copy could not be erased after the
+ * bounded retries. The SDK finishes the erase on the next load through the logout marker.
+ */
+interface ReplicaPurgeFailedEvent {
+    type: "replica.purge.failed";
+    trigger: ReplicaPurgeTrigger;
+    /** Typed reason: `logout_pending` (marker set, erase retried on next load) or `gate_unavailable`. */
+    reason: ReplicaGateReason;
+    /** Storage error code of the last attempt. */
+    code: string;
+    /** True when a short bounded retry is meaningful (delete blocked or storage error). */
+    retryNow: boolean;
+}
+/** Rejection of `signOut()` when the deny itself was `unguarded` and the erase did not complete. */
+interface ReplicaPurgeError extends Error {
+    code: "REPLICA_PURGE_FAILED";
+    reason: ReplicaGateReason;
+    retryNow: boolean;
 }
 /** Node/CLI profile-local fencing token, not a secret capability; the profile lock remains authoritative. */
 interface ProfileReplicaDeferredToken {
@@ -1764,6 +1823,15 @@ interface ReplicationControl {
      * and committed records remain. Exposed callers MUST show CLEAR_PENDING_WARNING first.
      */
     clearPending(): Promise<number>;
+    /**
+     * Browser: erases the whole local copy (the IndexedDB database) once the account has been
+     * denied by sign-out or account switch; `signOut()` and account switch already do this. Retries
+     * a few times when the delete is blocked. `{ ok: false, retryNow: true }`: the copy is still
+     * there and a short bounded retry is meaningful (the deny outcome kept the keys, or the delete
+     * is blocked); the SDK also finishes the erase on the next load. `retryNow: false`: nothing is
+     * erasable now (a session is live, or the storage has no browser database). Never rejects.
+     */
+    purgeLocalCopy(): Promise<ReplicaPurgeLocalCopyResult>;
     close(): Promise<void>;
 }
 interface ReplicationOptions {
@@ -1772,6 +1840,8 @@ interface ReplicationOptions {
     prefixes: string[];
     /** Required for prefixes/spaces where requiresSecretsOptIn returns true. */
     allowSecrets?: boolean;
+    /** Sign-in asks for kv/sync on each declared prefix only and never widens to a root entry that covers them. */
+    syncScope?: "prefixes";
     /** Background interval; default 60 seconds. */
     syncIntervalMs?: number;
     maxStalenessMs?: number;
@@ -1970,4 +2040,4 @@ declare function replicationIdentityKey(id: ReplicationIdentity): string;
 /** Whether replicating this space/prefix can copy encrypted secret material to disk. */
 declare function requiresSecretsOptIn(space: string, prefix: string): boolean;
 
-export { type ReplicaGuardedStore as $, type AuthorityRefusal as A, type ReplicaBrowserGateAccess as B, CLEAR_PENDING_WARNING as C, type ReplicaBrowserGateSnapshot as D, type ReplicaBrowserGateTx as E, type ReplicaBrowserPageAdmission as F, type ReplicaClock as G, type ReplicaCoverage as H, type ReplicaDeliveryDecision as I, type ReplicaDenyInput as J, type KVReplicationDeps as K, type LocalGetResult as L, type ReplicaDenyOutcome as M, type ReplicaDevice as N, type ReplicaEraseReport as O, type PendingWriteStore as P, type ReplicaGateAccess as Q, type ReplicationIdentity as R, type ReplicaGateReason as S, type ReplicaGateScope as T, type ReplicaGateSnapshot as U, type ReplicaGateTx as V, type ReplicaGatedError as W, type ReplicaGatedHandle as X, type ReplicaGatedSpec as Y, type ReplicaGatedStorage as Z, type ReplicaGrantInfo as _, type KVReplicationController as a, type ReplicaInspectedStatus as a0, type ReplicaLifecycleGate as a1, type ReplicaPageAdmission as a2, type ReplicaPartitionEraser as a3, type ReplicaPartitionIndexEntry as a4, type ReplicaPeerCommit as a5, type ReplicaPrivateGateHash as a6, type ReplicaPurgeIntent as a7, type ReplicaQuotaLedger as a8, type ReplicaQuotaSpec as a9, type KVChangesResponse as aA, type KVCreateSignedReadUrlOptions as aB, type KVDeleteOptions as aC, type KVGetOptions as aD, type KVHeadOptions as aE, type KVListOptions as aF, type KVListResponse as aG, type KVPutOptions as aH, type KVResponse as aI, type KVResponseHeaders as aJ, type KVServiceConfig as aK, type KVSignedReadUrlResponse as aL, type ReplicaSessionStamp as aa, type ReplicaStampedReply as ab, type ReplicaState as ac, type ReplicaStatusEntry as ad, type ReplicationAuthority as ae, type ReplicationControl as af, type ReplicationEvent as ag, type ReplicationOptions as ah, type ReplicationPurgeReport as ai, type ReplicationReason as aj, type ReplicationScheduler as ak, type ResolvedReplicationOptions as al, type SaltedHash as am, canonicalReplicationIdentity as an, replicationIdentityKey as ao, requiresSecretsOptIn as ap, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as aq, KVAction as ar, type KVActionType as as, type KVBatchPutItem as at, type KVBatchPutOptions as au, type KVBatchPutResponse as av, type KVBatchReadResponse as aw, type KVChange as ax, type KVChangesAuthority as ay, type KVChangesOptions as az, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type ProfileReplicaApprovalEntry as n, type ProfileReplicaDeferredDenyOutcome as o, type ProfileReplicaDeferredToken as p, type ProfileReplicaLogoutPending as q, type ProfileReplicaPreflight as r, type ProfileReplicaPurge as s, type ProfileReplicaRemoteLogoutState as t, type ProfileReplicaRootIdentity as u, type ProfileReplicaUnknownEntry as v, type PurgeTarget as w, type ReplicaAccountGate as x, type ReplicaAdmitHook as y, type ReplicaAuthorityState as z };
+export { type ReplicaGuardedStore as $, type AuthorityRefusal as A, type ReplicaBrowserGateAccess as B, CLEAR_PENDING_WARNING as C, type ReplicaBrowserGateSnapshot as D, type ReplicaBrowserGateTx as E, type ReplicaBrowserPageAdmission as F, type ReplicaClock as G, type ReplicaCoverage as H, type ReplicaDeliveryDecision as I, type ReplicaDenyInput as J, type KVReplicationDeps as K, type LocalGetResult as L, type ReplicaDenyOutcome as M, type ReplicaDevice as N, type ReplicaEraseReport as O, type PendingWriteStore as P, type ReplicaGateAccess as Q, type ReplicationIdentity as R, type ReplicaGateReason as S, type ReplicaGateScope as T, type ReplicaGateSnapshot as U, type ReplicaGateTx as V, type ReplicaGatedError as W, type ReplicaGatedHandle as X, type ReplicaGatedSpec as Y, type ReplicaGatedStorage as Z, type ReplicaGrantInfo as _, type KVReplicationController as a, type ReplicaInspectedStatus as a0, type ReplicaLifecycleGate as a1, type ReplicaLocalEraseOutcome as a2, type ReplicaPageAdmission as a3, type ReplicaPartitionEraser as a4, type ReplicaPartitionIndexEntry as a5, type ReplicaPeerCommit as a6, type ReplicaPrivateGateHash as a7, type ReplicaPurgeError as a8, type ReplicaPurgeFailedEvent as a9, type KVBatchPutResponse as aA, type KVBatchReadResponse as aB, type KVChange as aC, type KVChangesAuthority as aD, type KVChangesOptions as aE, type KVChangesResponse as aF, type KVCreateSignedReadUrlOptions as aG, type KVDeleteOptions as aH, type KVGetOptions as aI, type KVHeadOptions as aJ, type KVListOptions as aK, type KVListResponse as aL, type KVPutOptions as aM, type KVResponse as aN, type KVResponseHeaders as aO, type KVServiceConfig as aP, type KVSignedReadUrlResponse as aQ, type ReplicaPurgeIntent as aa, type ReplicaPurgeLocalCopyResult as ab, type ReplicaPurgeTrigger as ac, type ReplicaQuotaLedger as ad, type ReplicaQuotaSpec as ae, type ReplicaSessionStamp as af, type ReplicaStampedReply as ag, type ReplicaState as ah, type ReplicaStatusEntry as ai, type ReplicationAuthority as aj, type ReplicationControl as ak, type ReplicationEvent as al, type ReplicationOptions as am, type ReplicationPurgeReport as an, type ReplicationReason as ao, type ReplicationScheduler as ap, type ResolvedReplicationOptions as aq, type SaltedHash as ar, canonicalReplicationIdentity as as, replicationIdentityKey as at, requiresSecretsOptIn as au, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as av, KVAction as aw, type KVActionType as ax, type KVBatchPutItem as ay, type KVBatchPutOptions as az, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type ProfileReplicaApprovalEntry as n, type ProfileReplicaDeferredDenyOutcome as o, type ProfileReplicaDeferredToken as p, type ProfileReplicaLogoutPending as q, type ProfileReplicaPreflight as r, type ProfileReplicaPurge as s, type ProfileReplicaRemoteLogoutState as t, type ProfileReplicaRootIdentity as u, type ProfileReplicaUnknownEntry as v, type PurgeTarget as w, type ReplicaAccountGate as x, type ReplicaAdmitHook as y, type ReplicaAuthorityState as z };

package/dist/{scope-CAJbG-yz.d.ts → scope-_HAUxOPl.d.ts}

@@ -591,7 +591,9 @@ type ReplicaGateReason =
 /** Browser only: the `localStorage` logout marker is set. */
  | "logout_pending"
 /** The gate store itself could not be read; fail closed. */
- | "gate_unavailable";
+ | "gate_unavailable"
+/** Browser: replication is configured but no wallet provider can prove the connected account. */
+ | "wallet_provider_required";
 /** Shape of every gate refusal error: `Error & { code: "REPLICA_GATED"; gate }`. */
 interface ReplicaGatedError extends Error {
     code: "REPLICA_GATED";
@@ -877,6 +879,63 @@ interface ReplicaLifecycleGate {
     }): Promise<ReplicaEraseReport>;
     /** Outstanding intents; non-empty means status `purgePending: true`. */
     pendingPurge(): Promise<ReplicaPurgeIntent[]>;
+    /**
+     * Browser only. Under the gate lock, erases pending intents and deletes the whole origin
+     * database. Deletes only when nothing live is at stake: the gate is denied (null principal),
+     * the gate is behind the persisted deny tombstone, or the logout marker is set with a tombstone.
+     * A live or other-account gate is `refused` and left untouched. On a failed delete it sets the
+     * logout marker (when a tombstone exists) so `recover` finishes the erase on the next load.
+     * Never clears the deny tombstone.
+     */
+    eraseLocalCopy?(o: {
+        signal: AbortSignal;
+    }): Promise<ReplicaLocalEraseOutcome>;
+}
+/** Result of {@link ReplicaLifecycleGate.eraseLocalCopy}. */
+type ReplicaLocalEraseOutcome = 
+/** The database is gone and the logout marker (if any) is cleared. */
+{
+    status: "erased";
+}
+/** Delete blocked or storage error; a retry can succeed. `marker` is true when the next-load marker is set. */
+ | {
+    status: "failed";
+    code: string;
+    marker: boolean;
+}
+/** The gate does not authorize destruction; nothing was deleted. A retry cannot succeed until the gate is denied. */
+ | {
+    status: "refused";
+    code: string;
+};
+/** What triggered a local-copy erase. */
+type ReplicaPurgeTrigger = "sign_out" | "account_switch" | "purge_local_copy";
+/** Result of `replication.purgeLocalCopy()`. `retryNow` means a short bounded retry is meaningful. */
+type ReplicaPurgeLocalCopyResult = {
+    ok: true;
+} | {
+    ok: false;
+    retryNow: boolean;
+};
+/**
+ * Emitted (`on("replica.purge.failed", …)`) when the local copy could not be erased after the
+ * bounded retries. The SDK finishes the erase on the next load through the logout marker.
+ */
+interface ReplicaPurgeFailedEvent {
+    type: "replica.purge.failed";
+    trigger: ReplicaPurgeTrigger;
+    /** Typed reason: `logout_pending` (marker set, erase retried on next load) or `gate_unavailable`. */
+    reason: ReplicaGateReason;
+    /** Storage error code of the last attempt. */
+    code: string;
+    /** True when a short bounded retry is meaningful (delete blocked or storage error). */
+    retryNow: boolean;
+}
+/** Rejection of `signOut()` when the deny itself was `unguarded` and the erase did not complete. */
+interface ReplicaPurgeError extends Error {
+    code: "REPLICA_PURGE_FAILED";
+    reason: ReplicaGateReason;
+    retryNow: boolean;
 }
 /** Node/CLI profile-local fencing token, not a secret capability; the profile lock remains authoritative. */
 interface ProfileReplicaDeferredToken {
@@ -1764,6 +1823,15 @@ interface ReplicationControl {
      * and committed records remain. Exposed callers MUST show CLEAR_PENDING_WARNING first.
      */
     clearPending(): Promise<number>;
+    /**
+     * Browser: erases the whole local copy (the IndexedDB database) once the account has been
+     * denied by sign-out or account switch; `signOut()` and account switch already do this. Retries
+     * a few times when the delete is blocked. `{ ok: false, retryNow: true }`: the copy is still
+     * there and a short bounded retry is meaningful (the deny outcome kept the keys, or the delete
+     * is blocked); the SDK also finishes the erase on the next load. `retryNow: false`: nothing is
+     * erasable now (a session is live, or the storage has no browser database). Never rejects.
+     */
+    purgeLocalCopy(): Promise<ReplicaPurgeLocalCopyResult>;
     close(): Promise<void>;
 }
 interface ReplicationOptions {
@@ -1772,6 +1840,8 @@ interface ReplicationOptions {
     prefixes: string[];
     /** Required for prefixes/spaces where requiresSecretsOptIn returns true. */
     allowSecrets?: boolean;
+    /** Sign-in asks for kv/sync on each declared prefix only and never widens to a root entry that covers them. */
+    syncScope?: "prefixes";
     /** Background interval; default 60 seconds. */
     syncIntervalMs?: number;
     maxStalenessMs?: number;
@@ -1970,4 +2040,4 @@ declare function replicationIdentityKey(id: ReplicationIdentity): string;
 /** Whether replicating this space/prefix can copy encrypted secret material to disk. */
 declare function requiresSecretsOptIn(space: string, prefix: string): boolean;
 
-export { type ReplicaGuardedStore as $, type AuthorityRefusal as A, type ReplicaBrowserGateAccess as B, CLEAR_PENDING_WARNING as C, type ReplicaBrowserGateSnapshot as D, type ReplicaBrowserGateTx as E, type ReplicaBrowserPageAdmission as F, type ReplicaClock as G, type ReplicaCoverage as H, type ReplicaDeliveryDecision as I, type ReplicaDenyInput as J, type KVReplicationDeps as K, type LocalGetResult as L, type ReplicaDenyOutcome as M, type ReplicaDevice as N, type ReplicaEraseReport as O, type PendingWriteStore as P, type ReplicaGateAccess as Q, type ReplicationIdentity as R, type ReplicaGateReason as S, type ReplicaGateScope as T, type ReplicaGateSnapshot as U, type ReplicaGateTx as V, type ReplicaGatedError as W, type ReplicaGatedHandle as X, type ReplicaGatedSpec as Y, type ReplicaGatedStorage as Z, type ReplicaGrantInfo as _, type KVReplicationController as a, type ReplicaInspectedStatus as a0, type ReplicaLifecycleGate as a1, type ReplicaPageAdmission as a2, type ReplicaPartitionEraser as a3, type ReplicaPartitionIndexEntry as a4, type ReplicaPeerCommit as a5, type ReplicaPrivateGateHash as a6, type ReplicaPurgeIntent as a7, type ReplicaQuotaLedger as a8, type ReplicaQuotaSpec as a9, type KVChangesResponse as aA, type KVCreateSignedReadUrlOptions as aB, type KVDeleteOptions as aC, type KVGetOptions as aD, type KVHeadOptions as aE, type KVListOptions as aF, type KVListResponse as aG, type KVPutOptions as aH, type KVResponse as aI, type KVResponseHeaders as aJ, type KVServiceConfig as aK, type KVSignedReadUrlResponse as aL, type ReplicaSessionStamp as aa, type ReplicaStampedReply as ab, type ReplicaState as ac, type ReplicaStatusEntry as ad, type ReplicationAuthority as ae, type ReplicationControl as af, type ReplicationEvent as ag, type ReplicationOptions as ah, type ReplicationPurgeReport as ai, type ReplicationReason as aj, type ReplicationScheduler as ak, type ResolvedReplicationOptions as al, type SaltedHash as am, canonicalReplicationIdentity as an, replicationIdentityKey as ao, requiresSecretsOptIn as ap, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as aq, KVAction as ar, type KVActionType as as, type KVBatchPutItem as at, type KVBatchPutOptions as au, type KVBatchPutResponse as av, type KVBatchReadResponse as aw, type KVChange as ax, type KVChangesAuthority as ay, type KVChangesOptions as az, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type ProfileReplicaApprovalEntry as n, type ProfileReplicaDeferredDenyOutcome as o, type ProfileReplicaDeferredToken as p, type ProfileReplicaLogoutPending as q, type ProfileReplicaPreflight as r, type ProfileReplicaPurge as s, type ProfileReplicaRemoteLogoutState as t, type ProfileReplicaRootIdentity as u, type ProfileReplicaUnknownEntry as v, type PurgeTarget as w, type ReplicaAccountGate as x, type ReplicaAdmitHook as y, type ReplicaAuthorityState as z };
+export { type ReplicaGuardedStore as $, type AuthorityRefusal as A, type ReplicaBrowserGateAccess as B, CLEAR_PENDING_WARNING as C, type ReplicaBrowserGateSnapshot as D, type ReplicaBrowserGateTx as E, type ReplicaBrowserPageAdmission as F, type ReplicaClock as G, type ReplicaCoverage as H, type ReplicaDeliveryDecision as I, type ReplicaDenyInput as J, type KVReplicationDeps as K, type LocalGetResult as L, type ReplicaDenyOutcome as M, type ReplicaDevice as N, type ReplicaEraseReport as O, type PendingWriteStore as P, type ReplicaGateAccess as Q, type ReplicationIdentity as R, type ReplicaGateReason as S, type ReplicaGateScope as T, type ReplicaGateSnapshot as U, type ReplicaGateTx as V, type ReplicaGatedError as W, type ReplicaGatedHandle as X, type ReplicaGatedSpec as Y, type ReplicaGatedStorage as Z, type ReplicaGrantInfo as _, type KVReplicationController as a, type ReplicaInspectedStatus as a0, type ReplicaLifecycleGate as a1, type ReplicaLocalEraseOutcome as a2, type ReplicaPageAdmission as a3, type ReplicaPartitionEraser as a4, type ReplicaPartitionIndexEntry as a5, type ReplicaPeerCommit as a6, type ReplicaPrivateGateHash as a7, type ReplicaPurgeError as a8, type ReplicaPurgeFailedEvent as a9, type KVBatchPutResponse as aA, type KVBatchReadResponse as aB, type KVChange as aC, type KVChangesAuthority as aD, type KVChangesOptions as aE, type KVChangesResponse as aF, type KVCreateSignedReadUrlOptions as aG, type KVDeleteOptions as aH, type KVGetOptions as aI, type KVHeadOptions as aJ, type KVListOptions as aK, type KVListResponse as aL, type KVPutOptions as aM, type KVResponse as aN, type KVResponseHeaders as aO, type KVServiceConfig as aP, type KVSignedReadUrlResponse as aQ, type ReplicaPurgeIntent as aa, type ReplicaPurgeLocalCopyResult as ab, type ReplicaPurgeTrigger as ac, type ReplicaQuotaLedger as ad, type ReplicaQuotaSpec as ae, type ReplicaSessionStamp as af, type ReplicaStampedReply as ag, type ReplicaState as ah, type ReplicaStatusEntry as ai, type ReplicationAuthority as aj, type ReplicationControl as ak, type ReplicationEvent as al, type ReplicationOptions as am, type ReplicationPurgeReport as an, type ReplicationReason as ao, type ReplicationScheduler as ap, type ResolvedReplicationOptions as aq, type SaltedHash as ar, canonicalReplicationIdentity as as, replicationIdentityKey as at, requiresSecretsOptIn as au, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as av, KVAction as aw, type KVActionType as ax, type KVBatchPutItem as ay, type KVBatchPutOptions as az, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type ProfileReplicaApprovalEntry as n, type ProfileReplicaDeferredDenyOutcome as o, type ProfileReplicaDeferredToken as p, type ProfileReplicaLogoutPending as q, type ProfileReplicaPreflight as r, type ProfileReplicaPurge as s, type ProfileReplicaRemoteLogoutState as t, type ProfileReplicaRootIdentity as u, type ProfileReplicaUnknownEntry as v, type PurgeTarget as w, type ReplicaAccountGate as x, type ReplicaAdmitHook as y, type ReplicaAuthorityState as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinycloud/sdk-services",
-  "version": "3.7.0",
+  "version": "3.8.0-beta.2",
   "description": "TinyCloud SDK Services - Platform-agnostic service implementations",
   "author": "TinyCloud, Inc.",
   "license": "EGPL",