@arke-institute/sdk 2.3.14 → 2.6.1

package/dist/{crypto-Fh8b6rTi.d.ts → crypto-96bEBoO_.d.ts}

@@ -1,9 +1,49 @@
 import { Client } from 'openapi-fetch';
-import { paths } from './generated/index.js';
+import { paths, components } from './generated/index.js';
+
+/**
+ * Retry logic for transient network and server errors
+ */
+/**
+ * Configuration for retry behavior
+ */
+interface RetryConfig {
+    /**
+     * Maximum number of retry attempts
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay in milliseconds before first retry
+     * @default 100
+     */
+    initialDelay?: number;
+    /**
+     * Maximum delay in milliseconds (caps exponential backoff)
+     * @default 5000
+     */
+    maxDelay?: number;
+    /**
+     * Whether to retry on 5xx server errors
+     * @default true
+     */
+    retryOn5xx?: boolean;
+    /**
+     * Whether to retry on network errors (connection refused, DNS, timeouts)
+     * @default true
+     */
+    retryOnNetworkError?: boolean;
+    /**
+     * Optional callback invoked before each retry attempt
+     * Useful for logging or monitoring
+     */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
 
 /**
  * SDK configuration types
  */
+
 interface ArkeClientConfig {
     /**
      * Base URL for the Arke API
@@ -34,6 +74,29 @@ interface ArkeClientConfig {
      * Custom headers to include in all requests
      */
     headers?: Record<string, string>;
+    /**
+     * Retry configuration for transient errors
+     *
+     * Set to `false` to disable retries entirely.
+     * If not specified, uses default retry behavior (3 retries with exponential backoff).
+     *
+     * CAS conflicts (409) are never retried - they are returned immediately.
+     *
+     * @example
+     * ```typescript
+     * const arke = new ArkeClient({
+     *   authToken: 'ak_...',
+     *   retry: {
+     *     maxRetries: 5,
+     *     initialDelay: 200,
+     *     onRetry: (attempt, error, delay) => {
+     *       console.log(`Retry ${attempt} after ${delay}ms`);
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    retry?: RetryConfig | false;
 }
 declare const DEFAULT_CONFIG: Required<Pick<ArkeClientConfig, 'baseUrl' | 'network'>>;
 
@@ -167,6 +230,31 @@ declare class ArkeClient {
         data: ReadableStream<Uint8Array> | null | undefined;
         error: unknown;
     }>;
+    /**
+     * Upload file content
+     *
+     * This is a convenience method that handles the binary body serialization
+     * that openapi-fetch doesn't handle automatically for non-JSON bodies.
+     *
+     * @example
+     * ```typescript
+     * // Upload from a Blob
+     * const blob = new Blob(['Hello, world!'], { type: 'text/plain' });
+     * const { data, error } = await arke.uploadFileContent('01ABC...', blob, 'text/plain');
+     *
+     * // Upload from an ArrayBuffer
+     * const buffer = new TextEncoder().encode('Hello, world!').buffer;
+     * const { data, error } = await arke.uploadFileContent('01ABC...', buffer, 'text/plain');
+     *
+     * // Upload from a Uint8Array
+     * const bytes = new TextEncoder().encode('Hello, world!');
+     * const { data, error } = await arke.uploadFileContent('01ABC...', bytes, 'text/plain');
+     * ```
+     */
+    uploadFileContent(fileId: string, content: Blob | ArrayBuffer | Uint8Array, contentType: string): Promise<{
+        data: components['schemas']['UploadContentResponse'] | undefined;
+        error: unknown;
+    }>;
 }
 /**
  * Create a new ArkeClient instance

package/dist/{crypto-k-x66Nei.d.cts → crypto-wBQ1LBgz.d.cts}

@@ -1,9 +1,49 @@
 import { Client } from 'openapi-fetch';
-import { paths } from './generated/index.cjs';
+import { paths, components } from './generated/index.cjs';
+
+/**
+ * Retry logic for transient network and server errors
+ */
+/**
+ * Configuration for retry behavior
+ */
+interface RetryConfig {
+    /**
+     * Maximum number of retry attempts
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay in milliseconds before first retry
+     * @default 100
+     */
+    initialDelay?: number;
+    /**
+     * Maximum delay in milliseconds (caps exponential backoff)
+     * @default 5000
+     */
+    maxDelay?: number;
+    /**
+     * Whether to retry on 5xx server errors
+     * @default true
+     */
+    retryOn5xx?: boolean;
+    /**
+     * Whether to retry on network errors (connection refused, DNS, timeouts)
+     * @default true
+     */
+    retryOnNetworkError?: boolean;
+    /**
+     * Optional callback invoked before each retry attempt
+     * Useful for logging or monitoring
+     */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
 
 /**
  * SDK configuration types
  */
+
 interface ArkeClientConfig {
     /**
      * Base URL for the Arke API
@@ -34,6 +74,29 @@ interface ArkeClientConfig {
      * Custom headers to include in all requests
      */
     headers?: Record<string, string>;
+    /**
+     * Retry configuration for transient errors
+     *
+     * Set to `false` to disable retries entirely.
+     * If not specified, uses default retry behavior (3 retries with exponential backoff).
+     *
+     * CAS conflicts (409) are never retried - they are returned immediately.
+     *
+     * @example
+     * ```typescript
+     * const arke = new ArkeClient({
+     *   authToken: 'ak_...',
+     *   retry: {
+     *     maxRetries: 5,
+     *     initialDelay: 200,
+     *     onRetry: (attempt, error, delay) => {
+     *       console.log(`Retry ${attempt} after ${delay}ms`);
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    retry?: RetryConfig | false;
 }
 declare const DEFAULT_CONFIG: Required<Pick<ArkeClientConfig, 'baseUrl' | 'network'>>;
 
@@ -167,6 +230,31 @@ declare class ArkeClient {
         data: ReadableStream<Uint8Array> | null | undefined;
         error: unknown;
     }>;
+    /**
+     * Upload file content
+     *
+     * This is a convenience method that handles the binary body serialization
+     * that openapi-fetch doesn't handle automatically for non-JSON bodies.
+     *
+     * @example
+     * ```typescript
+     * // Upload from a Blob
+     * const blob = new Blob(['Hello, world!'], { type: 'text/plain' });
+     * const { data, error } = await arke.uploadFileContent('01ABC...', blob, 'text/plain');
+     *
+     * // Upload from an ArrayBuffer
+     * const buffer = new TextEncoder().encode('Hello, world!').buffer;
+     * const { data, error } = await arke.uploadFileContent('01ABC...', buffer, 'text/plain');
+     *
+     * // Upload from a Uint8Array
+     * const bytes = new TextEncoder().encode('Hello, world!');
+     * const { data, error } = await arke.uploadFileContent('01ABC...', bytes, 'text/plain');
+     * ```
+     */
+    uploadFileContent(fileId: string, content: Blob | ArrayBuffer | Uint8Array, contentType: string): Promise<{
+        data: components['schemas']['UploadContentResponse'] | undefined;
+        error: unknown;
+    }>;
 }
 /**
  * Create a new ArkeClient instance