@relyio/sdk 0.2.0 → 0.3.0

package/dist/{index-B-KiFHbx.d.ts → index-Dx01iwaf.d.ts}

@@ -1,5 +1,6 @@
-import { M as MergedRelyIOConfig, A as ApiPath, a as ApiMethod, G as PathParamsOf, r as ApiResponse, W as Wire, q as RequestConfig, B as BaseContent, c as WhereClause, e as SortOptions, f as ContentQueryResult, Q as QueryOptions, C as CreateInput, U as UpdateInput, S as SDKError, v as BaseValidationError, u as ValidationViolation, H as components, R as RelyIOConfig } from './index-BsUqCAu8.js';
-import { x as SchemaDefinition, y as SchemaContentTypeNames, a6 as InferContentType, K as SchemaAssetTypeNames, at as InferAssetType, z as SchemaSingletonNames, ac as InferSingleton, J as SchemaSettingsGroupNames, an as InferSettingsGroup, G as SchemaQueryNames, H as SchemaLocaleCodes } from './define-schema-DHvUCKwj.js';
+import { M as MergedRelyIOConfig, A as ApiPath, a as ApiMethod, G as PathParamsOf, r as ApiResponse, W as Wire, q as RequestConfig, B as BaseContent, c as WhereClause, e as SortOptions, f as ContentQueryResult, Q as QueryOptions, C as CreateInput, U as UpdateInput, S as SDKError, v as BaseValidationError, u as ValidationViolation, H as components, R as RelyIOConfig } from './index-DuEhsGdE.js';
+import { a as SchemaDefinition, b as SchemaContentTypeNames, h as SchemaAssetTypeNames, M as InferAssetType, c as SchemaSingletonNames, t as InferSingleton, g as SchemaSettingsGroupNames, E as InferSettingsGroup, e as SchemaQueryNames, f as SchemaLocaleCodes } from './define-schema-BD6HSPnG.js';
+import { J as InferContentType } from './define-content-type-CBfnTWSS.js';
 
 /**
  * What a call site supplies beside the route it named.
@@ -38,7 +39,7 @@ declare class HttpClient {
     private baseUrl;
     private defaultHeaders;
     private timeout;
-    private retryConfig;
+    private retryPolicy;
     private debug;
     private logger?;
     private config;
@@ -56,7 +57,16 @@ declare class HttpClient {
         data: unknown;
     } ? Wire<P, M, T>['data'] : never>;
     /**
-     * Make an HTTP request with retry logic
+     * Make an HTTP request, retrying only where a retry is safe.
+     *
+     * The headers are merged **once**, before the first attempt, and every attempt
+     * sends that same object. That is what makes a minted `Idempotency-Key` stable
+     * across the retries of one logical write: the service sees one key and
+     * answers the replay from the original outcome instead of applying it twice.
+     *
+     * The loop always makes one attempt. The incumbent's `while (attempt <
+     * maxAttempts)` made none at `retryAttempts: 0` — a value the config validator
+     * accepts — and then dereferenced an unassigned `lastError`.
      */
     request<T = unknown>(config: RequestConfig): Promise<ApiResponse<T>>;
     /**
@@ -113,7 +123,6 @@ declare class HttpClient {
     private mergeRequestConfig;
     private buildQueryString;
     private headersToObject;
-    private calculateRetryDelay;
     private sleep;
     private log;
 }
@@ -427,13 +436,20 @@ declare class ContentByIdBuilder<T extends BaseContent = BaseContent> {
  */
 interface RetryableWriteOptions {
     /**
-     * A caller-chosen key that makes a retry of **this** write safe.
+     * A key that makes a retry of **this** write safe.
      *
      * A replay inside the service's window returns the original outcome rather
      * than applying twice. The service derives that response from committed state
      * pinned to the recorded version — it does not store bytes — so a replay after
      * the version has been pruned is refused `RESOURCE_EXPIRED` rather than
      * answered from a stale copy.
+     *
+     * **The SDK mints one when you do not.** It used to be caller-supplied and
+     * nothing else, which meant the default write carried no key while the retry
+     * loop replayed it anyway — the one mechanism that makes a replay safe was
+     * optional on the one path that needed it. Supply your own to make a key
+     * outlive the process: a job that may be restarted wants a key derived from
+     * the work, not one minted per call.
      */
     idempotencyKey?: string;
 }