@amigo-ai/platform-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amigo AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,330 @@
+# @amigo-ai/platform-sdk
+
+Official TypeScript SDK for the [Amigo Platform API](https://api.platform.amigo.ai/v1/docs).
+
+## Installation
+
+```bash
+npm install @amigo-ai/platform-sdk
+```
+
+## Quick start
+
+```typescript
+import { AmigoClient } from '@amigo-ai/platform-sdk'
+
+const client = new AmigoClient({
+  apiKey: 'your-api-key',
+  workspaceId: 'your-workspace-id',
+})
+
+// List agents
+const { items: agents } = await client.agents.list()
+
+// Emit a world event
+await client.world.emitEvent({
+  entity_id: 'entity-id',
+  event_type: 'appointment_scheduled',
+  data: { appointment_id: 'appt-001' },
+})
+
+// Get call analytics for the last 30 days
+const stats = await client.analytics.getCalls({ period: '30d' })
+console.log(stats.total_calls, stats.avg_duration_seconds)
+```
+
+## Configuration
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `apiKey` | `string` | Yes | Your Platform API key — create one at Workspace Settings > API Keys |
+| `workspaceId` | `string` | Yes | Your workspace ID — all resource operations are scoped to this |
+| `baseUrl` | `string` | No | Override the API base URL (default: `https://api.platform.amigo.ai`) |
+| `retry` | `RetryOptions` | No | Retry configuration for transient failures |
+
+### Retry options
+
+```typescript
+const client = new AmigoClient({
+  apiKey: 'your-key',
+  workspaceId: 'your-workspace-id',
+  retry: {
+    maxAttempts: 3,    // Total attempts including first. Default: 3
+    baseDelayMs: 250,  // Base delay for exponential backoff. Default: 250
+    maxDelayMs: 30000, // Cap on delay. Default: 30_000
+  },
+})
+```
+
+GET requests are retried on 408, 429, 500, 502, 503, 504. POST requests are only retried on 429 with a `Retry-After` header. Backoff uses full jitter.
+
+## Resources
+
+### Agents
+
+```typescript
+// Create an agent
+const agent = await client.agents.create({
+  name: 'Patient Intake Agent',
+  description: 'Handles inbound scheduling calls',
+})
+
+// Create a version (the versioned config object)
+const version = await client.agents.createVersion(agent.id, {
+  name: 'v1',
+  identity: {
+    name: 'Alex',
+    role: 'Scheduling Coordinator',
+    developed_by: 'Acme Health',
+    default_spoken_language: 'en',
+    relationship_to_developer: {
+      ownership: 'Acme Health',
+      type: 'assistant',
+      conversation_visibility: 'public',
+      thought_visibility: 'private',
+    },
+  },
+})
+
+// Get the latest version
+const latest = await client.agents.getVersion(agent.id, 'latest')
+
+const { items: agents } = await client.agents.list({ search: 'intake' })
+```
+
+### Skills
+
+```typescript
+const skill = await client.skills.create({
+  slug: 'schedule-appointment',
+  name: 'Schedule Appointment',
+  description: 'Books appointments in the EHR system',
+  input_schema: {
+    type: 'object',
+    properties: {
+      patient_id: { type: 'string' },
+      appointment_type: { type: 'string' },
+    },
+    required: ['patient_id', 'appointment_type'],
+  },
+  execution_tier: 'orchestrated',
+})
+
+// Test with a sample input
+const result = await client.skills.test(skill.id, {
+  input: { patient_id: 'MRN-001', appointment_type: 'follow-up' },
+})
+console.log(result.success, result.output)
+```
+
+### Services
+
+Services wire together an agent + context graph + phone channel.
+
+```typescript
+const { items: services } = await client.services.list()
+const service = await client.services.get('service-id')
+console.log(service.agent_name, service.channel_type, service.version_sets)
+```
+
+### World Model
+
+The world model tracks entities (patients, contacts, appointments) and the events that flow through them.
+
+```typescript
+// Create an entity
+const patient = await client.world.createEntity({
+  entity_type: 'patient',
+  canonical_id: 'MRN-12345',
+  display_name: 'Jane Doe',
+})
+
+// Emit an event
+await client.world.emitEvent({
+  entity_id: patient.id,
+  event_type: 'call_completed',
+  data: { duration_seconds: 180, outcome: 'appointment_scheduled' },
+})
+
+// Query timeline
+const timeline = await client.world.getTimeline(patient.id)
+
+// Search entities
+const results = await client.world.search('Jane Doe', { entity_type: 'patient' })
+
+// View sync status from connectors
+const syncStatus = await client.world.getSyncStatusBySink()
+```
+
+### Calls
+
+Calls are read-only — they are created by the voice pipeline.
+
+```typescript
+const { items: calls } = await client.calls.list({
+  direction: 'inbound',
+  service_id: 'service-id',
+})
+
+// Get full detail with transcript and intelligence
+const detail = await client.calls.get(calls[0].call_sid)
+console.log(detail.intelligence?.summary)
+console.log(detail.transcript)
+
+// Analytics benchmarks
+const benchmarks = await client.calls.getBenchmarks({ days: 30 })
+```
+
+### Analytics
+
+```typescript
+// Dashboard KPIs with period-over-period deltas
+const dashboard = await client.analytics.getDashboard({ days: 7 })
+console.log(dashboard.call_volume.value, dashboard.call_volume.delta_pct)
+console.log(dashboard.avg_quality.value)
+
+// Call volume time series
+const calls = await client.analytics.getCalls({ period: '30d' })
+console.log(calls.total_calls, calls.calls_by_date)
+
+// Per-agent performance
+const { agents } = await client.analytics.getAgents({ period: '7d' })
+
+// Compare two periods
+const comparison = await client.analytics.compareCallPeriods({
+  current_from: '2026-04-01',
+  current_to: '2026-04-15',
+  previous_from: '2026-03-15',
+  previous_to: '2026-03-31',
+})
+```
+
+### Agent Memory
+
+Agent Memory tracks structured long-term facts about entities across conversations.
+
+```typescript
+// Get all dimension scores for an entity
+const dims = await client.memory.getEntityDimensions('entity-id')
+console.log(dims.dimensions) // preferences, health_history, etc.
+
+// Get individual facts for a dimension
+const facts = await client.memory.getEntityFacts('entity-id', { dimension: 'preferences' })
+
+// Workspace-level memory health
+const analytics = await client.memory.getAnalytics()
+console.log(analytics.coverage_rate, analytics.total_facts)
+```
+
+### Integrations
+
+```typescript
+const { items: integrations } = await client.integrations.list({ enabled: true })
+
+// Test a specific endpoint
+const result = await client.integrations.testEndpoint(
+  'integration-id',
+  'geocode',
+  { textQuery: '123 Main St, Springfield' },
+)
+```
+
+### Data Sources
+
+```typescript
+const { items: sources } = await client.dataSources.list()
+const source = await client.dataSources.get('source-id')
+console.log(source.source_type, source.health_status, source.last_sync_at)
+```
+
+### Settings
+
+```typescript
+// Voice
+const voice = await client.settings.voice.get()
+await client.settings.voice.update({ voice_id: 'new-voice-id', speed: 1.1 })
+
+// Retention
+const retention = await client.settings.retention.get()
+await client.settings.retention.update({ call_recordings_days: 90 })
+
+// Memory dimensions
+const memory = await client.settings.memory.get()
+console.log(memory.dimensions) // list of configured memory dimensions
+```
+
+### Billing
+
+```typescript
+const usage = await client.billing.getUsage()
+console.log(usage.meters, usage.total_events)
+
+const { items: invoices } = await client.billing.listInvoices()
+```
+
+## Pagination
+
+All list methods return `{ items, has_more, continuation_token }`. Use the `paginate` utility to iterate all pages automatically:
+
+```typescript
+import { AmigoClient, paginate } from '@amigo-ai/platform-sdk'
+
+for await (const entity of paginate((token) =>
+  client.world.listEntities({ continuation_token: token, limit: 100 }),
+)) {
+  // process entity
+}
+```
+
+## Error handling
+
+All SDK errors extend `AmigoError`. Use type guards for specific handling:
+
+```typescript
+import {
+  AmigoClient,
+  AmigoError,
+  isNotFoundError,
+  isRateLimitError,
+  isAuthenticationError,
+} from '@amigo-ai/platform-sdk'
+
+try {
+  await client.agents.get('agent-id')
+} catch (err) {
+  if (isNotFoundError(err)) {
+    console.log('Agent not found')
+  } else if (isRateLimitError(err)) {
+    console.log('Rate limited, retry after:', err.retryAfter, 'seconds')
+  } else if (isAuthenticationError(err)) {
+    console.log('Invalid API key')
+  } else if (err instanceof AmigoError) {
+    console.log('API error:', err.message, err.errorCode, err.requestId)
+  }
+}
+```
+
+### Error classes
+
+| Class | HTTP Status | Description |
+|-------|-------------|-------------|
+| `BadRequestError` | 400 | Malformed request |
+| `AuthenticationError` | 401 | Invalid or expired API key |
+| `PermissionError` | 403 | Insufficient permissions |
+| `NotFoundError` | 404 | Resource does not exist |
+| `ConflictError` | 409 | Duplicate slug or version conflict |
+| `ValidationError` | 422 | Request body validation failure |
+| `RateLimitError` | 429 | Too many requests — check `.retryAfter` |
+| `ServerError` | 5xx | Server-side error |
+| `ConfigurationError` | — | SDK misconfiguration at init time |
+| `NetworkError` | — | Fetch/network failure |
+
+## CommonJS (CJS) usage
+
+```javascript
+const { AmigoClient } = require('@amigo-ai/platform-sdk')
+```
+
+## License
+
+MIT

package/dist/core/auth.js

@@ -0,0 +1,32 @@
+/**
+ * Auth middleware for the Amigo Platform SDK.
+ *
+ * The platform-api accepts Bearer tokens in two forms:
+ *   1. RS256 JWT issued by the Identity service
+ *   2. Legacy API keys (created via POST /v1/{workspace_id}/api-keys)
+ *
+ * This SDK accepts an API key string and attaches it directly as
+ * `Authorization: Bearer {apiKey}`. No token exchange is required.
+ */
+import { AuthenticationError } from './errors.js';
+/**
+ * Creates openapi-fetch middleware that attaches the Bearer token
+ * to every outgoing request and converts 401 responses to AuthenticationError.
+ */
+export function createAuthMiddleware(config) {
+    return {
+        async onRequest({ request }) {
+            request.headers.set('Authorization', `Bearer ${config.apiKey}`);
+            return request;
+        },
+        async onResponse({ response }) {
+            if (response.status === 401) {
+                throw new AuthenticationError('Invalid or expired API key. Check your credentials.', {
+                    statusCode: 401,
+                });
+            }
+            return response;
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/core/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAMjD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO;QACL,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE;YACzB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;YAC/D,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE;YAC3B,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,mBAAmB,CAAC,qDAAqD,EAAE;oBACnF,UAAU,EAAE,GAAG;iBAChB,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/core/branded-types.js

@@ -0,0 +1,22 @@
+// --- Constructors ---
+export const workspaceId = (id) => id;
+export const apiKeyId = (id) => id;
+export const agentId = (id) => id;
+export const personaId = (id) => id;
+export const skillId = (id) => id;
+export const serviceId = (id) => id;
+export const contextGraphId = (id) => id;
+export const callId = (id) => id;
+export const phoneNumberId = (id) => id;
+export const integrationId = (id) => id;
+export const entityId = (id) => id;
+export const eventId = (id) => id;
+export const surfaceId = (id) => id;
+export const operatorId = (id) => id;
+export const triggerId = (id) => id;
+export const simulationRunId = (id) => id;
+export const simulationSessionId = (id) => id;
+export const scribeSessionId = (id) => id;
+export const functionId = (id) => id;
+export const dataSourceId = (id) => id;
+//# sourceMappingURL=branded-types.js.map

package/dist/core/branded-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded-types.js","sourceRoot":"","sources":["../../src/core/branded-types.ts"],"names":[],"mappings":"AA8BA,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAe,EAAE,CAAC,EAAiB,CAAA;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAY,EAAE,CAAC,EAAc,CAAA;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAa,CAAA;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAa,EAAE,CAAC,EAAe,CAAA;AACnE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAa,CAAA;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAa,EAAE,CAAC,EAAe,CAAA;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAU,EAAkB,EAAE,CAAC,EAAoB,CAAA;AAClF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,EAAY,CAAA;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,EAAmB,CAAA;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,EAAmB,CAAA;AAC/E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAY,EAAE,CAAC,EAAc,CAAA;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAa,CAAA;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAa,EAAE,CAAC,EAAe,CAAA;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAc,EAAE,CAAC,EAAgB,CAAA;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAa,EAAE,CAAC,EAAe,CAAA;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAU,EAAmB,EAAE,CAAC,EAAqB,CAAA;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAU,EAAuB,EAAE,CAAC,EAAyB,CAAA;AACjG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAU,EAAmB,EAAE,CAAC,EAAqB,CAAA;AACrF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAc,EAAE,CAAC,EAAgB,CAAA;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAU,EAAgB,EAAE,CAAC,EAAkB,CAAA"}

package/dist/core/errors.js

@@ -0,0 +1,168 @@
+/**
+ * Error hierarchy for the Amigo Platform SDK.
+ * All errors extend AmigoError which can be caught with a single catch.
+ */
+/** Base class for all Amigo Platform SDK errors */
+export class AmigoError extends Error {
+    statusCode;
+    errorCode;
+    requestId;
+    detail;
+    constructor(message, ctx = {}) {
+        super(message);
+        this.name = this.constructor.name;
+        this.statusCode = ctx.statusCode;
+        this.errorCode = ctx.errorCode;
+        this.requestId = ctx.requestId;
+        this.detail = ctx.detail;
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** 400 Bad Request */
+export class BadRequestError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 400 });
+    }
+}
+/** 401 Unauthorized — invalid or missing API key */
+export class AuthenticationError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 401 });
+    }
+}
+/** 403 Forbidden — insufficient permissions */
+export class PermissionError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 403 });
+    }
+}
+/** 404 Not Found */
+export class NotFoundError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 404 });
+    }
+}
+/** 409 Conflict — duplicate slug or resource version conflict */
+export class ConflictError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 409 });
+    }
+}
+/** 422 Unprocessable Entity — validation failure */
+export class ValidationError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 422 });
+    }
+}
+/** 429 Too Many Requests */
+export class RateLimitError extends AmigoError {
+    retryAfter;
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 429 });
+        this.retryAfter = ctx.retryAfter;
+    }
+}
+/** 5xx Server Error */
+export class ServerError extends AmigoError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: ctx.statusCode ?? 500 });
+    }
+}
+/** 503 Service Unavailable */
+export class ServiceUnavailableError extends ServerError {
+    constructor(message, ctx = {}) {
+        super(message, { ...ctx, statusCode: 503 });
+    }
+}
+/** Network or fetch failure (no HTTP status available) */
+export class NetworkError extends AmigoError {
+    constructor(message, cause) {
+        super(message);
+        if (cause !== undefined) {
+            ;
+            this.cause = cause;
+        }
+    }
+}
+/** Failed to parse response body */
+export class ParseError extends AmigoError {
+    body;
+    constructor(message, body) {
+        super(message);
+        this.body = body;
+    }
+}
+/** SDK misconfiguration */
+export class ConfigurationError extends AmigoError {
+    constructor(message) {
+        super(message);
+    }
+}
+export async function createApiError(response) {
+    let body = {};
+    let rawBody;
+    try {
+        rawBody = await response.text();
+        body = JSON.parse(rawBody);
+    }
+    catch {
+        // ignore parse failure
+    }
+    const ctx = {
+        statusCode: response.status,
+        errorCode: body.error_code,
+        requestId: body.request_id,
+        detail: body.detail,
+    };
+    const message = body.message ?? body.detail ?? response.statusText ?? `HTTP ${response.status}`;
+    switch (response.status) {
+        case 400:
+            return new BadRequestError(message, ctx);
+        case 401:
+            return new AuthenticationError(message, ctx);
+        case 403:
+            return new PermissionError(message, ctx);
+        case 404:
+            return new NotFoundError(message, ctx);
+        case 409:
+            return new ConflictError(message, ctx);
+        case 422:
+            return new ValidationError(message, ctx);
+        case 429: {
+            const retryAfter = parseRetryAfter(response);
+            return new RateLimitError(message, { ...ctx, retryAfter });
+        }
+        case 503:
+            return new ServiceUnavailableError(message, ctx);
+        default:
+            return new ServerError(message, ctx);
+    }
+}
+function parseRetryAfter(response) {
+    const header = response.headers.get('Retry-After');
+    if (!header)
+        return undefined;
+    const seconds = Number(header);
+    if (!isNaN(seconds))
+        return seconds;
+    const date = new Date(header);
+    if (!isNaN(date.getTime())) {
+        return Math.max(0, Math.ceil((date.getTime() - Date.now()) / 1000));
+    }
+    return undefined;
+}
+// --- Type guards ---
+export function isAmigoError(err) {
+    return err instanceof AmigoError;
+}
+export function isNotFoundError(err) {
+    return err instanceof NotFoundError;
+}
+export function isRateLimitError(err) {
+    return err instanceof RateLimitError;
+}
+export function isAuthenticationError(err) {
+    return err instanceof AuthenticationError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/core/openapi-client.js

@@ -0,0 +1,66 @@
+/**
+ * Creates a configured openapi-fetch client with auth, error handling, and retry middleware.
+ */
+import createClient from 'openapi-fetch';
+import { createAuthMiddleware } from './auth.js';
+import { createApiError } from './errors.js';
+import { shouldRetry, computeDelay, resolveRetryOptions } from './retry.js';
+export function createAmigoClient(config) {
+    const retryOptions = resolveRetryOptions(config.retry);
+    const client = createClient({ baseUrl: config.baseUrl });
+    // Auth middleware — attaches Bearer token and converts 401
+    client.use(createAuthMiddleware({ apiKey: config.apiKey }));
+    // Error middleware — converts HTTP error responses to typed errors
+    const errorMiddleware = {
+        async onResponse({ response }) {
+            if (response.status >= 400) {
+                throw await createApiError(response);
+            }
+            return response;
+        },
+    };
+    client.use(errorMiddleware);
+    // Retry middleware — exponential backoff with jitter
+    const retryMiddleware = {
+        async onRequest({ request, schemaPath }) {
+            // Store method for use in onResponse
+            ;
+            request._method =
+                request.method.toUpperCase();
+            void schemaPath;
+            return request;
+        },
+        async onResponse({ request, response }) {
+            const method = request._method ?? request.method.toUpperCase();
+            let attempt = 0;
+            let currentResponse = response;
+            while (shouldRetry({
+                method,
+                attempt,
+                response: currentResponse,
+                options: retryOptions,
+            })) {
+                const delayMs = computeDelay(attempt, currentResponse, retryOptions);
+                await sleep(delayMs);
+                attempt++;
+                try {
+                    const retried = await fetch(request.clone());
+                    currentResponse = retried;
+                    if (currentResponse.status < 400)
+                        return currentResponse;
+                }
+                catch {
+                    // Network error on retry — fall through to throw original
+                    break;
+                }
+            }
+            return currentResponse;
+        },
+    };
+    client.use(retryMiddleware);
+    return client;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=openapi-client.js.map

package/dist/core/openapi-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-client.js","sourceRoot":"","sources":["../../src/core/openapi-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,YAAiC,MAAM,eAAe,CAAA;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAA;AAU9F,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAEtD,MAAM,MAAM,GAAG,YAAY,CAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IAE/D,2DAA2D;IAC3D,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAE3D,mEAAmE;IACnE,MAAM,eAAe,GAAe;QAClC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE;YAC3B,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC3B,MAAM,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;YACtC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;KACF,CAAA;IACD,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IAE3B,qDAAqD;IACrD,MAAM,eAAe,GAAe;QAClC,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE;YACrC,qCAAqC;YACrC,CAAC;YAAC,OAA0C,CAAC,OAAO;gBAClD,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;YAC9B,KAAK,UAAU,CAAA;YACf,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE;YACpC,MAAM,MAAM,GAAI,OAA0C,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;YAClG,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,IAAI,eAAe,GAAG,QAAQ,CAAA;YAE9B,OACE,WAAW,CAAC;gBACV,MAAM;gBACN,OAAO;gBACP,QAAQ,EAAE,eAAe;gBACzB,OAAO,EAAE,YAAY;aACtB,CAAC,EACF,CAAC;gBACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,CAAC,CAAA;gBACpE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAA;gBACpB,OAAO,EAAE,CAAA;gBACT,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;oBAC5C,eAAe,GAAG,OAAO,CAAA;oBACzB,IAAI,eAAe,CAAC,MAAM,GAAG,GAAG;wBAAE,OAAO,eAAe,CAAA;gBAC1D,CAAC;gBAAC,MAAM,CAAC;oBACP,0DAA0D;oBAC1D,MAAK;gBACP,CAAC;YACH,CAAC;YAED,OAAO,eAAe,CAAA;QACxB,CAAC;KACF,CAAA;IACD,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IAE3B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC"}