@tinycloud/sdk-services 3.1.0-beta.2 → 3.1.0-beta.7

package/dist/kv/index.d.cts

@@ -1,4 +1,4 @@
-import { B as BaseService } from '../BaseService-BhpVpA9b.cjs';
+import { B as BaseService } from '../BaseService-C8zRy0ww.cjs';
 import { R as Result, I as IService } from '../types-qwMmB7qB.cjs';
 
 /**
@@ -23,8 +23,11 @@ interface KVServiceConfig {
      */
     prefix?: string;
     /**
-     * Default timeout in milliseconds for KV operations.
-     * Overrides the context-level timeout if set.
+     * Default timeout in milliseconds for each KV request, including reading
+     * the response body. When it elapses the request is aborted and the
+     * operation returns an `ErrorCodes.TIMEOUT` error. A per-call `timeout`
+     * option overrides it. Unset (the default), `0`, or `Infinity` means no
+     * timeout.
      */
     timeout?: number;
     /** Allow additional config properties */
@@ -55,7 +58,8 @@ interface KVGetOptions {
      */
     maxResponseBytes?: number;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -85,7 +89,8 @@ interface KVPutOptions {
     /** Only write when the key does not exist. */
     ifNoneMatch?: "*";
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -123,7 +128,8 @@ interface KVBatchPutOptions {
      */
     prefix?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -182,7 +188,8 @@ interface KVListOptions {
     /** Opaque scope-bound cursor returned by a previous bounded list. */
     cursor?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -201,7 +208,8 @@ interface KVDeleteOptions {
     /** Only delete when the current object has this strong ETag. */
     ifMatch?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -218,7 +226,8 @@ interface KVHeadOptions {
      */
     prefix?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -259,7 +268,8 @@ interface KVCreateSignedReadUrlOptions {
      */
     etag?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -882,7 +892,7 @@ declare class KVService extends BaseService implements IKVService {
      * @param path - Resource path
      * @param action - KV action
      * @param body - Optional request body
-     * @param signal - Optional abort signal
+     * @param signal - Request signal from createRequestSignal()
      * @returns Fetch response
      */
     private invokeOperation;
@@ -918,12 +928,16 @@ declare class KVService extends BaseService implements IKVService {
      */
     private parseResponse;
     private createSignedReadUrlError;
+    /** A known 401/403 keeps its typed status even if reading its body fails. */
+    private readAuthorizationText;
     /**
      * AUTH_UNAUTHORIZED for a 401/403 response. The message keeps the HTTP
      * status and the server text (`<context>: <status> - <text>`, the same
      * shape as every other KV failure) so callers that rethrow only the message
      * still see the status; `meta.status` carries it for typed callers.
-     * Resource/ability hints are parsed from the raw body, never the message.
+     * Server hints must match the requested path/action (whether the node sends
+     * a relative path or full resource); metadata uses only the request-derived
+     * canonical resource under the authenticated session's space.
      */
     private authorizationFailure;
     private normalizeSignedReadUrlResponse;

package/dist/kv/index.d.ts

@@ -1,4 +1,4 @@
-import { B as BaseService } from '../BaseService-CuV-ZVPs.js';
+import { B as BaseService } from '../BaseService-DU-lE-Qx.js';
 import { R as Result, I as IService } from '../types-qwMmB7qB.js';
 
 /**
@@ -23,8 +23,11 @@ interface KVServiceConfig {
      */
     prefix?: string;
     /**
-     * Default timeout in milliseconds for KV operations.
-     * Overrides the context-level timeout if set.
+     * Default timeout in milliseconds for each KV request, including reading
+     * the response body. When it elapses the request is aborted and the
+     * operation returns an `ErrorCodes.TIMEOUT` error. A per-call `timeout`
+     * option overrides it. Unset (the default), `0`, or `Infinity` means no
+     * timeout.
      */
     timeout?: number;
     /** Allow additional config properties */
@@ -55,7 +58,8 @@ interface KVGetOptions {
      */
     maxResponseBytes?: number;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -85,7 +89,8 @@ interface KVPutOptions {
     /** Only write when the key does not exist. */
     ifNoneMatch?: "*";
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -123,7 +128,8 @@ interface KVBatchPutOptions {
      */
     prefix?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -182,7 +188,8 @@ interface KVListOptions {
     /** Opaque scope-bound cursor returned by a previous bounded list. */
     cursor?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -201,7 +208,8 @@ interface KVDeleteOptions {
     /** Only delete when the current object has this strong ETag. */
     ifMatch?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -218,7 +226,8 @@ interface KVHeadOptions {
      */
     prefix?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -259,7 +268,8 @@ interface KVCreateSignedReadUrlOptions {
      */
     etag?: string;
     /**
-     * Custom timeout for this operation in milliseconds.
+     * Custom timeout for this operation in milliseconds. Overrides
+     * `KVServiceConfig.timeout`; `0` disables a configured timeout.
      */
     timeout?: number;
     /**
@@ -882,7 +892,7 @@ declare class KVService extends BaseService implements IKVService {
      * @param path - Resource path
      * @param action - KV action
      * @param body - Optional request body
-     * @param signal - Optional abort signal
+     * @param signal - Request signal from createRequestSignal()
      * @returns Fetch response
      */
     private invokeOperation;
@@ -918,12 +928,16 @@ declare class KVService extends BaseService implements IKVService {
      */
     private parseResponse;
     private createSignedReadUrlError;
+    /** A known 401/403 keeps its typed status even if reading its body fails. */
+    private readAuthorizationText;
     /**
      * AUTH_UNAUTHORIZED for a 401/403 response. The message keeps the HTTP
      * status and the server text (`<context>: <status> - <text>`, the same
      * shape as every other KV failure) so callers that rethrow only the message
      * still see the status; `meta.status` carries it for typed callers.
-     * Resource/ability hints are parsed from the raw body, never the message.
+     * Server hints must match the requested path/action (whether the node sends
+     * a relative path or full resource); metadata uses only the request-derived
+     * canonical resource under the authenticated session's space.
      */
     private authorizationFailure;
     private normalizeSignedReadUrlResponse;