@tinycloud/sdk-services 3.11.0 → 3.12.0-beta.16

package/dist/kv/index.d.cts

@@ -1,7 +1,7 @@
-import { B as BaseService } from '../BaseService-O0iyuFLk.cjs';
-import { f as Result, c as IService } from '../types-CSd0RYir.cjs';
-import { aI as KVGetOptions, aN as KVResponse, aB as KVBatchReadResponse, aM as KVPutOptions, ay as KVBatchPutItem, az as KVBatchPutOptions, aA as KVBatchPutResponse, aK as KVListOptions, aL as KVListResponse, aE as KVChangesOptions, aF as KVChangesResponse, aH as KVDeleteOptions, aJ as KVHeadOptions, aG as KVCreateSignedReadUrlOptions, aQ as KVSignedReadUrlResponse, aP as KVServiceConfig, c as KVReadThrough } from '../scope-DEgc9f-W.cjs';
-export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, av as DEFAULT_SIGNED_READ_URL_EXPIRY_MS, aw as KVAction, ax as KVActionType, aC as KVChange, aD as KVChangesAuthority, b as KVListPage, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, a as KVReplicationController, K as KVReplicationDeps, aO as KVResponseHeaders, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, P as PendingWriteStore, m as PinnedKey, w as PurgeTarget, z as ReplicaAuthorityState, H as ReplicaCoverage, N as ReplicaDevice, X as ReplicaGatedHandle, _ as ReplicaGrantInfo, a0 as ReplicaInspectedStatus, ah as ReplicaState, ai as ReplicaStatusEntry, aj as ReplicationAuthority, ak as ReplicationControl, al as ReplicationEvent, R as ReplicationIdentity, am as ReplicationOptions, an as ReplicationPurgeReport, ao as ReplicationReason, ap as ReplicationScheduler, aq as ResolvedReplicationOptions, as as canonicalReplicationIdentity, at as replicationIdentityKey, au as requiresSecretsOptIn } from '../scope-DEgc9f-W.cjs';
+import { B as BaseService } from '../BaseService-CdBkfPGE.cjs';
+import { f as Result, c as IService } from '../types-DjAP8dve.cjs';
+import { aI as KVGetOptions, aN as KVResponse, aB as KVBatchReadResponse, aM as KVPutOptions, ay as KVBatchPutItem, az as KVBatchPutOptions, aA as KVBatchPutResponse, aK as KVListOptions, aL as KVListResponse, aE as KVChangesOptions, aF as KVChangesResponse, aH as KVDeleteOptions, aJ as KVHeadOptions, aG as KVCreateSignedReadUrlOptions, aQ as KVSignedReadUrlResponse, aP as KVServiceConfig, c as KVReadThrough } from '../scope-DtcbyRKY.cjs';
+export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, av as DEFAULT_SIGNED_READ_URL_EXPIRY_MS, aw as KVAction, ax as KVActionType, aC as KVChange, aD as KVChangesAuthority, b as KVListPage, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, a as KVReplicationController, K as KVReplicationDeps, aO as KVResponseHeaders, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, P as PendingWriteStore, m as PinnedKey, w as PurgeTarget, z as ReplicaAuthorityState, H as ReplicaCoverage, N as ReplicaDevice, X as ReplicaGatedHandle, _ as ReplicaGrantInfo, a0 as ReplicaInspectedStatus, ah as ReplicaState, ai as ReplicaStatusEntry, aj as ReplicationAuthority, ak as ReplicationControl, al as ReplicationEvent, R as ReplicationIdentity, am as ReplicationOptions, an as ReplicationPurgeReport, ao as ReplicationReason, ap as ReplicationScheduler, aq as ResolvedReplicationOptions, as as canonicalReplicationIdentity, at as replicationIdentityKey, au as requiresSecretsOptIn } from '../scope-DtcbyRKY.cjs';
 export { kvPrefixCovers } from './replication/prefix.cjs';
 import './replication/contractConstants.cjs';
 import './replication/grantPolicyConstants.cjs';
@@ -550,7 +550,7 @@ declare class KVService extends BaseService implements IKVService {
     private readThrough;
     private readThroughReady;
     /** Delay KV routing until an asynchronously loaded read-through is attached. */
-    setReadThroughReady(ready: Promise<unknown>): void;
+    setReadThroughReady(ready: Promise<unknown> | (() => Promise<unknown>)): void;
     /**
      * Create a new KVService instance.
      *

package/dist/kv/index.d.ts

@@ -1,7 +1,7 @@
-import { B as BaseService } from '../BaseService-Ma2MwJAd.js';
-import { f as Result, c as IService } from '../types-CSd0RYir.js';
-import { aI as KVGetOptions, aN as KVResponse, aB as KVBatchReadResponse, aM as KVPutOptions, ay as KVBatchPutItem, az as KVBatchPutOptions, aA as KVBatchPutResponse, aK as KVListOptions, aL as KVListResponse, aE as KVChangesOptions, aF as KVChangesResponse, aH as KVDeleteOptions, aJ as KVHeadOptions, aG as KVCreateSignedReadUrlOptions, aQ as KVSignedReadUrlResponse, aP as KVServiceConfig, c as KVReadThrough } from '../scope-BZr0QwxX.js';
-export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, av as DEFAULT_SIGNED_READ_URL_EXPIRY_MS, aw as KVAction, ax as KVActionType, aC as KVChange, aD as KVChangesAuthority, b as KVListPage, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, a as KVReplicationController, K as KVReplicationDeps, aO as KVResponseHeaders, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, P as PendingWriteStore, m as PinnedKey, w as PurgeTarget, z as ReplicaAuthorityState, H as ReplicaCoverage, N as ReplicaDevice, X as ReplicaGatedHandle, _ as ReplicaGrantInfo, a0 as ReplicaInspectedStatus, ah as ReplicaState, ai as ReplicaStatusEntry, aj as ReplicationAuthority, ak as ReplicationControl, al as ReplicationEvent, R as ReplicationIdentity, am as ReplicationOptions, an as ReplicationPurgeReport, ao as ReplicationReason, ap as ReplicationScheduler, aq as ResolvedReplicationOptions, as as canonicalReplicationIdentity, at as replicationIdentityKey, au as requiresSecretsOptIn } from '../scope-BZr0QwxX.js';
+import { B as BaseService } from '../BaseService-BRDG69KR.js';
+import { f as Result, c as IService } from '../types-DjAP8dve.js';
+import { aI as KVGetOptions, aN as KVResponse, aB as KVBatchReadResponse, aM as KVPutOptions, ay as KVBatchPutItem, az as KVBatchPutOptions, aA as KVBatchPutResponse, aK as KVListOptions, aL as KVListResponse, aE as KVChangesOptions, aF as KVChangesResponse, aH as KVDeleteOptions, aJ as KVHeadOptions, aG as KVCreateSignedReadUrlOptions, aQ as KVSignedReadUrlResponse, aP as KVServiceConfig, c as KVReadThrough } from '../scope-J20PQP3u.js';
+export { A as AuthorityRefusal, C as CLEAR_PENDING_WARNING, av as DEFAULT_SIGNED_READ_URL_EXPIRY_MS, aw as KVAction, ax as KVActionType, aC as KVChange, aD as KVChangesAuthority, b as KVListPage, d as KVReplicaHandle, e as KVReplicaSpec, f as KVReplicaStorage, a as KVReplicationController, K as KVReplicationDeps, aO as KVResponseHeaders, L as LocalGetResult, g as LocalListResult, h as LocalReadMeta, i as LocalReplicaStatus, j as LocalSyncResult, k as PendingWriteRecord, l as PendingWriteState, P as PendingWriteStore, m as PinnedKey, w as PurgeTarget, z as ReplicaAuthorityState, H as ReplicaCoverage, N as ReplicaDevice, X as ReplicaGatedHandle, _ as ReplicaGrantInfo, a0 as ReplicaInspectedStatus, ah as ReplicaState, ai as ReplicaStatusEntry, aj as ReplicationAuthority, ak as ReplicationControl, al as ReplicationEvent, R as ReplicationIdentity, am as ReplicationOptions, an as ReplicationPurgeReport, ao as ReplicationReason, ap as ReplicationScheduler, aq as ResolvedReplicationOptions, as as canonicalReplicationIdentity, at as replicationIdentityKey, au as requiresSecretsOptIn } from '../scope-J20PQP3u.js';
 export { kvPrefixCovers } from './replication/prefix.js';
 import './replication/contractConstants.js';
 import './replication/grantPolicyConstants.js';
@@ -550,7 +550,7 @@ declare class KVService extends BaseService implements IKVService {
     private readThrough;
     private readThroughReady;
     /** Delay KV routing until an asynchronously loaded read-through is attached. */
-    setReadThroughReady(ready: Promise<unknown>): void;
+    setReadThroughReady(ready: Promise<unknown> | (() => Promise<unknown>)): void;
     /**
      * Create a new KVService instance.
      *

package/dist/kv/index.js

@@ -10,6 +10,10 @@ var ErrorCodes = {
   /** HTTP 401: a delegation the cited one rests on was revoked. */
   AUTH_DELEGATION_ANCESTOR_REVOKED: "AUTH_DELEGATION_ANCESTOR_REVOKED",
   NETWORK_ERROR: "NETWORK_ERROR",
+  NODE_NOT_RESPONDING: "NODE_NOT_RESPONDING",
+  NODE_IDENTITY_MISMATCH: "NODE_IDENTITY_MISMATCH",
+  PARTIAL_NODE_WRITE: "PARTIAL_NODE_WRITE",
+  RESOURCE_NOT_ROUTED: "RESOURCE_NOT_ROUTED",
   TIMEOUT: "TIMEOUT",
   ABORTED: "ABORTED",
   INVALID_INPUT: "INVALID_INPUT",
@@ -161,6 +165,34 @@ function parseNetworkId(networkId) {
   return { networkId, ownerDid, name };
 }
 
+// src/resourceRouting.ts
+var ROUTING_FAILURE_CODES = {
+  NODE_NOT_RESPONDING: true,
+  PARTIAL_NODE_WRITE: true,
+  NODE_IDENTITY_MISMATCH: true,
+  RESOURCE_NOT_ROUTED: true,
+  DECRYPTION_DEPENDENCY_UNAVAILABLE: true,
+  registry_unavailable: true,
+  node_not_found: true,
+  node_registry_entry_exists: true
+};
+function isRoutingFailureCode(code) {
+  return Object.prototype.hasOwnProperty.call(ROUTING_FAILURE_CODES, code);
+}
+function routingFailure(error) {
+  if (typeof error === "object" && error !== null && "code" in error && "message" in error && typeof error.code === "string" && typeof error.message === "string" && isRoutingFailureCode(error.code)) {
+    const candidate = "meta" in error ? error.meta : void 0;
+    let meta = typeof candidate === "object" && candidate !== null && !Array.isArray(candidate) ? candidate : void 0;
+    if (error.code === "NODE_NOT_RESPONDING" && "hosts" in error && Array.isArray(error.hosts)) {
+      meta = { ...meta, hosts: error.hosts };
+    } else if (error.code === "PARTIAL_NODE_WRITE" && "succeeded" in error && Array.isArray(error.succeeded) && "failed" in error && Array.isArray(error.failed)) {
+      meta = { ...meta, succeeded: error.succeeded, failed: error.failed };
+    }
+    return { code: error.code, message: error.message, ...error instanceof Error ? { cause: error } : {}, ...meta ? { meta } : {} };
+  }
+  return void 0;
+}
+
 // src/errors.ts
 function parsePermissionHint(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
@@ -434,6 +466,8 @@ function storageRejectionError(service, status, meta, responseText) {
   return status === 402 ? storageQuotaExceededError(service, STORAGE_FULL_MESSAGE, quotaMeta) : storageLimitReachedError(service, STORAGE_WRITE_TOO_LARGE_MESSAGE, quotaMeta);
 }
 function wrapError(service, error, defaultCode = ErrorCodes.NETWORK_ERROR) {
+  const routing = routingFailure(error);
+  if (routing) return { ...routing, service };
   if (error instanceof Error) {
     if (isRequestTimeoutError(error)) {
       return timeoutError(service, error.timeoutMs, error);
@@ -945,11 +979,15 @@ var KVService = class extends BaseService {
   }
   /** Delay KV routing until an asynchronously loaded read-through is attached. */
   setReadThroughReady(ready) {
-    const settled = ready.then(() => void 0, () => void 0);
-    this.readThroughReady = settled;
-    void settled.then(() => {
-      if (this.readThroughReady === settled) this.readThroughReady = null;
-    });
+    const start = () => {
+      if (typeof ready === "function") ready = Promise.resolve().then(ready);
+      const finish = () => {
+        if (this.readThroughReady === start) this.readThroughReady = null;
+      };
+      return ready.then(finish, finish);
+    };
+    this.readThroughReady = start;
+    if (typeof ready !== "function") void start();
   }
   /**
    * Get the service configuration.
@@ -1196,7 +1234,6 @@ var KVService = class extends BaseService {
     return aligned;
   }
   async batchRead(keys, action, options) {
-    if (this.readThroughReady !== null) await this.readThroughReady;
     if (!this.requireAuth()) return err(authRequiredError("kv"));
     if (keys.length === 0) return ok({ results: [], count: 0 });
     if (keys.length > MAX_KV_BATCH_READ_ITEMS) {
@@ -1447,7 +1484,7 @@ var KVService = class extends BaseService {
    */
   async get(key, options) {
     return this.withTelemetry("get", key, async () => {
-      if (this.readThroughReady !== null) await this.readThroughReady;
+      if (options?.source !== "network" && this.readThroughReady !== null) await this.readThroughReady();
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
@@ -1566,7 +1603,7 @@ var KVService = class extends BaseService {
    */
   async put(key, value, options) {
     return this.withTelemetry("put", key, async () => {
-      if (this.readThroughReady !== null) await this.readThroughReady;
+      if (this.readThroughReady !== null) await this.readThroughReady();
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
@@ -1651,7 +1688,7 @@ var KVService = class extends BaseService {
    */
   async batchPut(items, options) {
     return this.withTelemetry("batchPut", String(items.length), async () => {
-      if (this.readThroughReady !== null) await this.readThroughReady;
+      if (this.readThroughReady !== null) await this.readThroughReady();
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
@@ -1850,7 +1887,7 @@ var KVService = class extends BaseService {
    */
   async list(options) {
     return this.withTelemetry("list", options?.prefix, async () => {
-      if (this.readThroughReady !== null) await this.readThroughReady;
+      if (options?.source !== "network" && this.readThroughReady !== null) await this.readThroughReady();
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }
@@ -2138,7 +2175,7 @@ var KVService = class extends BaseService {
    */
   async delete(key, options) {
     return this.withTelemetry("delete", key, async () => {
-      if (this.readThroughReady !== null) await this.readThroughReady;
+      if (this.readThroughReady !== null) await this.readThroughReady();
       if (!this.requireAuth()) {
         return err(authRequiredError("kv"));
       }