@epilot/sdk 2.20.50 → 2.20.51

package/dist/index.d.ts

@@ -28,34 +28,35 @@ import { C as Client$l } from './entity.d-BwsBk0Po.js';
 import { C as Client$m } from './entity-mapping.d-8MtWa2_L.js';
 import { C as Client$n } from './environments.d-qL1urwAq.js';
 import { C as Client$o } from './event-catalog.d-BrAxYS9D.js';
-import { C as Client$p } from './file.d-DELNV63w.js';
-import { C as Client$q } from './iban.d-BwdiGbxi.js';
-import { C as Client$r } from './identity.d-BBL0NI_O.js';
-import { C as Client$s } from './integration-toolkit.d-CLlaZx6b.js';
-import { C as Client$t } from './journey.d-CMtM6U3Y.js';
-import { C as Client$u } from './kanban.d-BHnSRCYW.js';
-import { C as Client$v } from './message.d-DwnqO-Us.js';
-import { C as Client$w } from './metering.d-BP04w-gR.js';
-import { C as Client$x } from './notes.d-rbcyHfiB.js';
-import { C as Client$y } from './notification.d-r89Jec85.js';
-import { C as Client$z } from './organization.d-DqwnNxMg.js';
-import { C as Client$A } from './partner-directory.d-BCIjHoGs.js';
-import { C as Client$B } from './permissions.d-BKoyMhU7.js';
-import { C as Client$C } from './pricing.d-BMV5QoZ7.js';
-import { C as Client$D } from './pricing-tier.d-Cg0jl6n_.js';
-import { C as Client$E } from './purpose.d-CbIYfTua.js';
-import { C as Client$F } from './query.d-Cmp78IhZ.js';
-import { C as Client$G } from './sandbox.d-BdbOFzDu.js';
-import { C as Client$H } from './sharing.d-sOXq-gtz.js';
-import { C as Client$I } from './snapshot.d-DT0zg2CS.js';
-import { C as Client$J } from './submission.d-BamwfhXw.js';
-import { C as Client$K } from './targeting.d-BYVSahmV.js';
-import { C as Client$L } from './template-variables.d-Ble9TSBa.js';
-import { C as Client$M } from './user.d-rqYtwsCz.js';
-import { C as Client$N } from './validation-rules.d-Bbo90IYn.js';
-import { C as Client$O } from './webhooks.d-DqOEzFsp.js';
-import { C as Client$P } from './workflow.d-5cyNJgVQ.js';
-import { C as Client$Q } from './workflow-definition.d-CweGhhBU.js';
+import { C as Client$p } from './external-values.d-DjP9C_-r.js';
+import { C as Client$q } from './file.d-DELNV63w.js';
+import { C as Client$r } from './iban.d-BwdiGbxi.js';
+import { C as Client$s } from './identity.d-BBL0NI_O.js';
+import { C as Client$t } from './integration-toolkit.d-CLlaZx6b.js';
+import { C as Client$u } from './journey.d-CMtM6U3Y.js';
+import { C as Client$v } from './kanban.d-BHnSRCYW.js';
+import { C as Client$w } from './message.d-DwnqO-Us.js';
+import { C as Client$x } from './metering.d-BP04w-gR.js';
+import { C as Client$y } from './notes.d-rbcyHfiB.js';
+import { C as Client$z } from './notification.d-r89Jec85.js';
+import { C as Client$A } from './organization.d-DqwnNxMg.js';
+import { C as Client$B } from './partner-directory.d-BCIjHoGs.js';
+import { C as Client$C } from './permissions.d-BKoyMhU7.js';
+import { C as Client$D } from './pricing.d-BMV5QoZ7.js';
+import { C as Client$E } from './pricing-tier.d-Cg0jl6n_.js';
+import { C as Client$F } from './purpose.d-CbIYfTua.js';
+import { C as Client$G } from './query.d-Cmp78IhZ.js';
+import { C as Client$H } from './sandbox.d-BdbOFzDu.js';
+import { C as Client$I } from './sharing.d-sOXq-gtz.js';
+import { C as Client$J } from './snapshot.d-DT0zg2CS.js';
+import { C as Client$K } from './submission.d-BamwfhXw.js';
+import { C as Client$L } from './targeting.d-BYVSahmV.js';
+import { C as Client$M } from './template-variables.d-Ble9TSBa.js';
+import { C as Client$N } from './user.d-rqYtwsCz.js';
+import { C as Client$O } from './validation-rules.d-Bbo90IYn.js';
+import { C as Client$P } from './webhooks.d-DqOEzFsp.js';
+import { C as Client$Q } from './workflow.d-5cyNJgVQ.js';
+import { C as Client$R } from './workflow-definition.d-CweGhhBU.js';
 
 type SDKClientMap = {
     accessToken: Client;
@@ -83,34 +84,35 @@ type SDKClientMap = {
     entityMapping: Client$m;
     environments: Client$n;
     eventCatalog: Client$o;
-    file: Client$p;
-    iban: Client$q;
-    identity: Client$r;
-    integrationToolkit: Client$s;
-    journey: Client$t;
-    kanban: Client$u;
-    message: Client$v;
-    metering: Client$w;
-    notes: Client$x;
-    notification: Client$y;
-    organization: Client$z;
-    partnerDirectory: Client$A;
-    permissions: Client$B;
-    pricing: Client$C;
-    pricingTier: Client$D;
-    purpose: Client$E;
-    query: Client$F;
-    sandbox: Client$G;
-    sharing: Client$H;
-    snapshot: Client$I;
-    submission: Client$J;
-    targeting: Client$K;
-    templateVariables: Client$L;
-    user: Client$M;
-    validationRules: Client$N;
-    webhooks: Client$O;
-    workflow: Client$P;
-    workflowDefinition: Client$Q;
+    externalValues: Client$p;
+    file: Client$q;
+    iban: Client$r;
+    identity: Client$s;
+    integrationToolkit: Client$t;
+    journey: Client$u;
+    kanban: Client$v;
+    message: Client$w;
+    metering: Client$x;
+    notes: Client$y;
+    notification: Client$z;
+    organization: Client$A;
+    partnerDirectory: Client$B;
+    permissions: Client$C;
+    pricing: Client$D;
+    pricingTier: Client$E;
+    purpose: Client$F;
+    query: Client$G;
+    sandbox: Client$H;
+    sharing: Client$I;
+    snapshot: Client$J;
+    submission: Client$K;
+    targeting: Client$L;
+    templateVariables: Client$M;
+    user: Client$N;
+    validationRules: Client$O;
+    webhooks: Client$P;
+    workflow: Client$Q;
+    workflowDefinition: Client$R;
 };
 
 type LargeResponseConfig = {

package/dist/index.js

@@ -19,6 +19,9 @@ import {
 import {
   require_workflow_runtime
 } from "./chunk-522LYPPW.js";
+import {
+  require_pricing_tier_runtime
+} from "./chunk-6VWCUZ5M.js";
 import {
   require_pricing_runtime
 } from "./chunk-QZ3FPCEP.js";
@@ -40,6 +43,9 @@ import {
 import {
   require_submission_runtime
 } from "./chunk-IJR3GZKC.js";
+import {
+  require_kanban_runtime
+} from "./chunk-IQOCHPWU.js";
 import {
   require_message_runtime
 } from "./chunk-OT6AETWN.js";
@@ -61,15 +67,15 @@ import {
 import {
   require_permissions_runtime
 } from "./chunk-SITPUXIR.js";
-import {
-  require_pricing_tier_runtime
-} from "./chunk-6VWCUZ5M.js";
 import {
   require_environments_runtime
 } from "./chunk-2LEEXRJX.js";
 import {
   require_event_catalog_runtime
 } from "./chunk-M6G3GHCU.js";
+import {
+  require_external_values_runtime
+} from "./chunk-CMEMMJ3T.js";
 import {
   require_file_runtime
 } from "./chunk-FGQBS7TA.js";
@@ -85,9 +91,6 @@ import {
 import {
   require_journey_runtime
 } from "./chunk-I3ZZES76.js";
-import {
-  require_kanban_runtime
-} from "./chunk-IQOCHPWU.js";
 import {
   require_data_governance_runtime
 } from "./chunk-5ED7FB3Q.js";
@@ -164,7 +167,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-VMA2UKDS.js";
+} from "./chunk-3FRPGY3C.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";
@@ -391,6 +394,11 @@ var registerBuiltinApis = (registry) => {
     name: "eventCatalog",
     loader: () => expandDef(require_event_catalog_runtime())
   });
+  registerApi({
+    registry,
+    name: "externalValues",
+    loader: () => expandDef(require_external_values_runtime())
+  });
   registerApi({
     registry,
     name: "file",

package/docs/external-values.md

@@ -0,0 +1,330 @@
+# External Values API
+
+- **Base URL:** `https://external-values.sls.epilot.io`
+- **Full API Docs:** [https://docs.epilot.io/api/external-values](https://docs.epilot.io/api/external-values)
+
+## Usage
+
+```ts
+import { epilot } from '@epilot/sdk'
+
+epilot.authorize(() => '<token>')
+const { data } = await epilot.externalValues.listExternalValues(...)
+```
+
+### Tree-shakeable import
+
+```ts
+import { getClient, authorize } from '@epilot/sdk/external-values'
+
+const externalValuesClient = getClient()
+authorize(externalValuesClient, () => '<token>')
+const { data } = await externalValuesClient.listExternalValues(...)
+```
+
+## Operations
+
+**external-values**
+- [`listExternalValues`](#listexternalvalues)
+- [`resolveExternalValue`](#resolveexternalvalue)
+- [`resolvePortalExternalValue`](#resolveportalexternalvalue)
+
+**Schemas**
+- [`TranslatedString`](#translatedstring)
+- [`ExternalValueType`](#externalvaluetype)
+- [`ResolveExternalValueRequest`](#resolveexternalvaluerequest)
+- [`ExternalValueErrorCode`](#externalvalueerrorcode)
+- [`ExternalValueError`](#externalvalueerror)
+- [`ResolveExternalValueResponse`](#resolveexternalvalueresponse)
+- [`ExternalValueResultSummary`](#externalvalueresultsummary)
+- [`ExternalValueHookSummary`](#externalvaluehooksummary)
+- [`ExternalValueHookList`](#externalvaluehooklist)
+
+### `listExternalValues`
+
+List hooks and their results of all enabled installed apps that declare an
+`EXTERNAL_VALUES` component. Intended for pickers (e.g. the validation-rules builder).
+
+`GET /v1/external-values`
+
+```ts
+const { data } = await client.listExternalValues()
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "hooks": [
+    {
+      "app_id": "string",
+      "app_name": "string",
+      "hook_id": "string",
+      "name": {
+        "de": "string",
+        "en": "string"
+      },
+      "description": {
+        "de": "string",
+        "en": "string"
+      },
+      "results": [
+        {
+          "id": "string",
+          "type": "number",
+          "name": {
+            "de": "string",
+            "en": "string"
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+</details>
+
+---
+
+### `resolveExternalValue`
+
+Resolve an external value hook for an epilot 360 user (builder preview, entity-attribute
+rules). The organization is taken from the caller's token.
+
+`POST /v1/external-values/{app_id}/hooks/{hook_id}:resolve`
+
+```ts
+const { data } = await client.resolveExternalValue(
+  {
+    app_id: 'example',
+    hook_id: 'example',
+  },
+  {
+    context: {
+      input: '123,45',
+      contract: {
+        _id: '8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a',
+        installment_amount: 110
+      }
+    },
+    consumer: {
+      type: 'validation_rule',
+      rule_id: '6c0a9e1e-2f4b-4e6a-8f8e-2b2b2b2b2b2b'
+    }
+  },
+)
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "values": {
+    "predicted": 132
+  },
+  "errors": [
+    {
+      "result_id": "limit",
+      "code": "coercion_failed",
+      "message": "Cannot coerce \"n/a\" to number"
+    }
+  ],
+  "policy": {
+    "on_unavailable": "skip"
+  }
+}
+```
+
+</details>
+
+---
+
+### `resolvePortalExternalValue`
+
+Resolve an external value hook for a portal end customer (private journeys, portal).
+The organization is taken from the portal token claims.
+
+`POST /v1/portal/external-values/{app_id}/hooks/{hook_id}:resolve`
+
+```ts
+const { data } = await client.resolvePortalExternalValue(
+  {
+    app_id: 'example',
+    hook_id: 'example',
+  },
+  {
+    context: {
+      input: '123,45',
+      contract: {
+        _id: '8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a',
+        installment_amount: 110
+      }
+    },
+    consumer: {
+      type: 'validation_rule',
+      rule_id: '6c0a9e1e-2f4b-4e6a-8f8e-2b2b2b2b2b2b'
+    }
+  },
+)
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "values": {
+    "predicted": 132
+  },
+  "errors": [
+    {
+      "result_id": "limit",
+      "code": "coercion_failed",
+      "message": "Cannot coerce \"n/a\" to number"
+    }
+  ],
+  "policy": {
+    "on_unavailable": "skip"
+  }
+}
+```
+
+</details>
+
+---
+
+## Schemas
+
+### `TranslatedString`
+
+```ts
+type TranslatedString = {
+  de: string
+  en?: string
+}
+```
+
+### `ExternalValueType`
+
+```ts
+type ExternalValueType = "number" | "text" | "date" | "boolean"
+```
+
+### `ResolveExternalValueRequest`
+
+```ts
+type ResolveExternalValueRequest = {
+  context: Record<string, unknown>
+  consumer?: {
+    type?: string
+    rule_id?: string
+    journey_id?: string
+  }
+}
+```
+
+### `ExternalValueErrorCode`
+
+- `timeout`: the third-party call exceeded `timeout_ms`
+- `upstream_error`: the third-party call failed or returned a non-2xx status
+- `auth_failed`: the `auth` pre-call failed
+- `extraction_failed`: template/path/jsonata threw or yielded null / empty
+- `coercion_failed`: the extracted value could n
+
+```ts
+type ExternalValueErrorCode = "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"
+```
+
+### `ExternalValueError`
+
+```ts
+type ExternalValueError = {
+  result_id?: string
+  code: "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"
+  message: string
+}
+```
+
+### `ResolveExternalValueResponse`
+
+```ts
+type ResolveExternalValueResponse = {
+  values: Record<string, number | string | boolean>
+  errors: Array<{
+    result_id?: string
+    code: "timeout" | "upstream_error" | "auth_failed" | "extraction_failed" | "coercion_failed"
+    message: string
+  }>
+  policy: {
+    on_unavailable: "skip" | "block"
+  }
+  cached?: boolean
+}
+```
+
+### `ExternalValueResultSummary`
+
+```ts
+type ExternalValueResultSummary = {
+  id: string
+  type: "number" | "text" | "date" | "boolean"
+  name: {
+    de: string
+    en?: string
+  }
+}
+```
+
+### `ExternalValueHookSummary`
+
+```ts
+type ExternalValueHookSummary = {
+  app_id: string
+  app_name: string
+  hook_id: string
+  name: {
+    de: string
+    en?: string
+  }
+  description?: {
+    de: string
+    en?: string
+  }
+  results: Array<{
+    id: string
+    type: "number" | "text" | "date" | "boolean"
+    name: {
+      de: { ... }
+      en?: { ... }
+    }
+  }>
+}
+```
+
+### `ExternalValueHookList`
+
+```ts
+type ExternalValueHookList = {
+  hooks: Array<{
+    app_id: string
+    app_name: string
+    hook_id: string
+    name: {
+      de: { ... }
+      en?: { ... }
+    }
+    description?: {
+      de: { ... }
+      en?: { ... }
+    }
+    results: Array<{
+      id: { ... }
+      type: { ... }
+      name: { ... }
+    }>
+  }>
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.20.50",
+  "version": "2.20.51",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -165,6 +165,12 @@
       "require": "./dist/apis/event-catalog.cjs"
     },
     "./event-catalog/openapi.json": "./definitions/event-catalog.json",
+    "./external-values": {
+      "types": "./dist/apis/external-values.d.ts",
+      "import": "./dist/apis/external-values.js",
+      "require": "./dist/apis/external-values.cjs"
+    },
+    "./external-values/openapi.json": "./definitions/external-values.json",
     "./file": {
       "types": "./dist/apis/file.d.ts",
       "import": "./dist/apis/file.js",
@@ -448,6 +454,9 @@
       "event-catalog": [
         "./dist/apis/event-catalog.d.ts"
       ],
+      "external-values": [
+        "./dist/apis/external-values.d.ts"
+      ],
       "file": [
         "./dist/apis/file.d.ts"
       ],

package/dist/README-OSHX3IVR.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/README.json
-var README_default = "<h1 align=\"center\"><img alt=\"epilot\" src=\"https://raw.githubusercontent.com/epilot-dev/sdk-js/main/logo.png\" width=\"200\"><br>@epilot/sdk</h1>\n\n<p align=\"center\">\n  <a href=\"https://github.com/epilot-dev/sdk-js/actions?query=workflow%3ACI\"><img src=\"https://github.com/epilot-dev/sdk-js/workflows/CI/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://www.npmjs.com/package/@epilot/sdk\"><img src=\"https://img.shields.io/npm/v/@epilot/sdk.svg\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/epilot-dev/sdk-js/blob/main/\"><img src=\"http://img.shields.io/:license-mit-blue.svg\" alt=\"License\"></a>\n</p>\n\n<p align=\"center\">JavaScript/TypeScript SDK for epilot APIs. Full types, tree-shakeable imports, and lazy-loaded OpenAPI specs.</p>\n\n## Install\n\n```bash\nnpm i @epilot/sdk axios openapi-client-axios\n```\n\n## Quick Start\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-bearer-token>')\n\nconst { data: entity } = await epilot.entity.createEntity(\n  { slug: 'contact' },\n  { first_name: 'John', last_name: 'Doe' },\n)\n\nconst { data: file } = await epilot.file.getFile({ id: 'file-123' })\n\nconst { data: executions } = await epilot.workflow.getExecutions()\n```\n\nAPI clients are built on [openapi-client-axios](https://openapistack.co/docs/openapi-client-axios/intro/), which generates fully typed operation methods on top of regular [axios](https://axios-http.com/docs/intro) instances. All standard axios features (interceptors, defaults, config) work as expected. Each operation is forwarded to a lazy singleton \u2014 the spec is loaded and the client initialized on first use, then cached.\n\nFull API documentation: [https://docs.epilot.io/api](https://docs.epilot.io/api)\n\n## API Reference\n\n<!-- api-reference-table -->\n| API | Import | Docs |\n| --- | ------ | ---- |\n| `epilot.accessToken` | `@epilot/sdk/access-token` | [docs](./docs/access-token.md) |\n| `epilot.address` | `@epilot/sdk/address` | [docs](./docs/address.md) |\n| `epilot.addressSuggestions` | `@epilot/sdk/address-suggestions` | [docs](./docs/address-suggestions.md) |\n| `epilot.aiAgents` | `@epilot/sdk/ai-agents` | [docs](./docs/ai-agents.md) |\n| `epilot.app` | `@epilot/sdk/app` | [docs](./docs/app.md) |\n| `epilot.auditLogs` | `@epilot/sdk/audit-logs` | [docs](./docs/audit-logs.md) |\n| `epilot.automation` | `@epilot/sdk/automation` | [docs](./docs/automation.md) |\n| `epilot.billing` | `@epilot/sdk/billing` | [docs](./docs/billing.md) |\n| `epilot.blueprintManifest` | `@epilot/sdk/blueprint-manifest` | [docs](./docs/blueprint-manifest.md) |\n| `epilot.calendar` | `@epilot/sdk/calendar` | [docs](./docs/calendar.md) |\n| `epilot.chat` | `@epilot/sdk/chat` | [docs](./docs/chat.md) |\n| `epilot.configurationHub` | `@epilot/sdk/configuration-hub` | [docs](./docs/configuration-hub.md) |\n| `epilot.consent` | `@epilot/sdk/consent` | [docs](./docs/consent.md) |\n| `epilot.customerPortal` | `@epilot/sdk/customer-portal` | [docs](./docs/customer-portal.md) |\n| `epilot.dashboard` | `@epilot/sdk/dashboard` | [docs](./docs/dashboard.md) |\n| `epilot.dataGovernance` | `@epilot/sdk/data-governance` | [docs](./docs/data-governance.md) |\n| `epilot.deduplication` | `@epilot/sdk/deduplication` | [docs](./docs/deduplication.md) |\n| `epilot.design` | `@epilot/sdk/design` | [docs](./docs/design.md) |\n| `epilot.document` | `@epilot/sdk/document` | [docs](./docs/document.md) |\n| `epilot.emailSettings` | `@epilot/sdk/email-settings` | [docs](./docs/email-settings.md) |\n| `epilot.emailTemplate` | `@epilot/sdk/email-template` | [docs](./docs/email-template.md) |\n| `epilot.entity` | `@epilot/sdk/entity` | [docs](./docs/entity.md) |\n| `epilot.entityMapping` | `@epilot/sdk/entity-mapping` | [docs](./docs/entity-mapping.md) |\n| `epilot.environments` | `@epilot/sdk/environments` | [docs](./docs/environments.md) |\n| `epilot.eventCatalog` | `@epilot/sdk/event-catalog` | [docs](./docs/event-catalog.md) |\n| `epilot.file` | `@epilot/sdk/file` | [docs](./docs/file.md) |\n| `epilot.iban` | `@epilot/sdk/iban` | [docs](./docs/iban.md) |\n| `epilot.identity` | `@epilot/sdk/identity` | [docs](./docs/identity.md) |\n| `epilot.integrationToolkit` | `@epilot/sdk/integration-toolkit` | [docs](./docs/integration-toolkit.md) |\n| `epilot.journey` | `@epilot/sdk/journey` | [docs](./docs/journey.md) |\n| `epilot.kanban` | `@epilot/sdk/kanban` | [docs](./docs/kanban.md) |\n| `epilot.message` | `@epilot/sdk/message` | [docs](./docs/message.md) |\n| `epilot.metering` | `@epilot/sdk/metering` | [docs](./docs/metering.md) |\n| `epilot.notes` | `@epilot/sdk/notes` | [docs](./docs/notes.md) |\n| `epilot.notification` | `@epilot/sdk/notification` | [docs](./docs/notification.md) |\n| `epilot.organization` | `@epilot/sdk/organization` | [docs](./docs/organization.md) |\n| `epilot.partnerDirectory` | `@epilot/sdk/partner-directory` | [docs](./docs/partner-directory.md) |\n| `epilot.permissions` | `@epilot/sdk/permissions` | [docs](./docs/permissions.md) |\n| `epilot.pricing` | `@epilot/sdk/pricing` | [docs](./docs/pricing.md) |\n| `epilot.pricingTier` | `@epilot/sdk/pricing-tier` | [docs](./docs/pricing-tier.md) |\n| `epilot.purpose` | `@epilot/sdk/purpose` | [docs](./docs/purpose.md) |\n| `epilot.query` | `@epilot/sdk/query` | [docs](./docs/query.md) |\n| `epilot.sandbox` | `@epilot/sdk/sandbox` | [docs](./docs/sandbox.md) |\n| `epilot.sharing` | `@epilot/sdk/sharing` | [docs](./docs/sharing.md) |\n| `epilot.snapshot` | `@epilot/sdk/snapshot` | [docs](./docs/snapshot.md) |\n| `epilot.submission` | `@epilot/sdk/submission` | [docs](./docs/submission.md) |\n| `epilot.targeting` | `@epilot/sdk/targeting` | [docs](./docs/targeting.md) |\n| `epilot.templateVariables` | `@epilot/sdk/template-variables` | [docs](./docs/template-variables.md) |\n| `epilot.user` | `@epilot/sdk/user` | [docs](./docs/user.md) |\n| `epilot.validationRules` | `@epilot/sdk/validation-rules` | [docs](./docs/validation-rules.md) |\n| `epilot.webhooks` | `@epilot/sdk/webhooks` | [docs](./docs/webhooks.md) |\n| `epilot.workflow` | `@epilot/sdk/workflow` | [docs](./docs/workflow.md) |\n| `epilot.workflowDefinition` | `@epilot/sdk/workflow-definition` | [docs](./docs/workflow-definition.md) |\n<!-- /api-reference-table -->\n\n## OpenAPI Spec\n\nRetrieve the full OpenAPI specification for any API at runtime. The spec is lazy-loaded on first call and cached.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Via API handle\nconst entitySpec = await epilot.entity.openapi()\nconsole.log(entitySpec.info.title) // \"Entity API\"\nconsole.log(entitySpec.paths)       // all paths with full schemas\n\n// Via top-level method\nconst spec = await epilot.openapi('entity')\n```\n\nFor tree-shakeable imports:\n\n```ts\nimport { openapi } from '@epilot/sdk/entity'\n\nconst spec = await openapi()\n```\n\n## Explicit Client Access\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\n\n// Get the cached singleton client\nconst entityClient = epilot.entity.getClient()\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Create a fresh (non-singleton) client instance\nconst freshClient = epilot.entity.createClient()\nauthorize(freshClient, () => '<my-token>')\n```\n\n## Tree-Shakeable Imports\n\nImport only what you need. Other APIs never touch your bundle.\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Or use the handle for direct operation forwarding\nimport { entity } from '@epilot/sdk/entity'\nconst { data } = await entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n## Types\n\nEach API subpath re-exports all schema types generated from the OpenAPI spec. Import them directly:\n\n```ts\nimport type { Entity, EntitySchema, RelationAttribute } from '@epilot/sdk/entity'\nimport type { FileItem } from '@epilot/sdk/file'\nimport type { AutomationFlow } from '@epilot/sdk/automation'\n```\n\nThe `Client`, `OperationMethods`, and `PathsDictionary` types are also available for typing client instances:\n\n```ts\nimport type { Client } from '@epilot/sdk/entity'\n\nconst entityClient: Client = epilot.entity.getClient()\n```\n\n## Headers\n\n### Global Headers\n\nSet default headers applied to all clients. Useful for `x-epilot-org-id`, `x-epilot-user-id`, etc.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.headers({\n  'x-epilot-org-id': 'org-123',\n  'x-epilot-user-id': 'user-456',\n})\n\nconst { data } = await epilot.entity.searchEntities(...)\n```\n\n### Standard Axios Headers\n\nUse standard axios `defaults.headers.common` on individual clients:\n\n```ts\nconst entityClient = epilot.entity.getClient()\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Auth Patterns\n\n`authorize()` accepts a string or a function. The function form is preferred \u2014 it is called on every request, so tokens stay fresh.\n\n```ts\nimport { authorize } from '@epilot/sdk'\nimport { getClient } from '@epilot/sdk/entity'\n\n// Per-client \u2014 function predicate (recommended)\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\n// Per-client \u2014 async function (e.g. OAuth / session)\nauthorize(entityClient, async () => {\n  return await getTokenFromSession()\n})\n\n// Per-client \u2014 static string (sets default header once)\nauthorize(entityClient, 'my-static-api-token')\n```\n\n```ts\n// Global \u2014 applies to all clients resolved from the SDK\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.authorize(async () => await getTokenFromSession())\nepilot.authorize('my-static-api-token')\n```\n\n## Fresh Client Instance\n\n```ts\nimport { createClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = createClient()\nauthorize(entityClient, () => '<my-token>')\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Multiple SDK Instances\n\n```ts\nimport { createSDK } from '@epilot/sdk'\n\nconst sdk1 = createSDK()\nsdk1.authorize(() => '<token-for-org-1>')\nsdk1.headers({ 'x-epilot-org-id': 'org-1' })\n\nconst sdk2 = createSDK()\nsdk2.authorize(() => '<token-for-org-2>')\nsdk2.headers({ 'x-epilot-org-id': 'org-2' })\n```\n\n\n## Interceptors\n\nUse axios interceptors for custom request/response processing. Since clients are axios instances, you can use `client.interceptors` directly:\n\n```ts\nentityClient.interceptors.response.use((response) => {\n  console.debug(`${response.config.method?.toUpperCase()} ${response.config.url}`, {\n    status: response.status,\n    data: response.data,\n  })\n  return response\n})\n```\n\nOr register global interceptors applied to all clients:\n\n```ts\nepilot.interceptors.request((config) => {\n  config.headers['x-correlation-id'] = generateTraceId()\n  return config\n})\n```\n\n## Auto-Retry (429 Too Many Requests)\n\nThe SDK automatically retries requests that receive a `429 Too Many Requests` response. It respects the `Retry-After` header (in seconds) to determine how long to wait before retrying.\n\nEnabled by default with up to 3 retries.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Customize retry behavior\nepilot.retry({ maxRetries: 5, defaultDelayMs: 2000 })\n\n// Disable retries\nepilot.retry({ maxRetries: 0 })\n```\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `maxRetries` | `3` | Maximum number of retries. Set to `0` to disable. |\n| `defaultDelayMs` | `1000` | Fallback delay in ms when `Retry-After` header is missing. |\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyRetryInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyRetryInterceptor({ client: entityClient, config: { maxRetries: 3 } })\n```\n\n## Large Response Handling (413 Payload Too Large)\n\nepilot APIs use a [large response middleware](https://github.com/epilot-dev/aws-lambda-utility-middlewares) to work around the AWS Lambda 6MB response limit. When a response exceeds ~5.1MB, the API uploads the payload to S3 and returns a presigned URL instead.\n\nThe SDK handles this transparently \u2014 it sends the opt-in `Accept` header and automatically fetches the full payload from S3 when a large response URL is returned. Enabled by default.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Disable large response handling\nepilot.largeResponse({ enabled: false })\n```\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyLargeResponseInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyLargeResponseInterceptor({ client: entityClient, config: { enabled: true } })\n```\n\n## Overrides & Custom APIs\n\nOverride built-in API specs or register custom APIs via `.epilot/sdk-overrides.json`. This is useful for testing new versions of an API spec or getting the latest types without waiting for an SDK release.\n\n```json\n{\n  \"entity\": \"./specs/entity-openapi.json\",\n  \"myNewApi\": \"./specs/my-new-api-openapi.json\"\n}\n```\n\n```ts\n// Built-in API with overridden spec\nconst { data } = await epilot.entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n### Override Commands\n\n```bash\n# Apply all overrides from .epilot/sdk-overrides.json\nnpx epilot-sdk override\n\n# Override a single API\nnpx epilot-sdk override entity ./my-local-entity-spec.yaml\n\n# Regenerate types after spec changes\nnpx epilot-sdk typegen\n```\n\n<details>\n<summary>Migration from <code>@epilot/*-client</code></summary>\n\nDrop-in replacement \u2014 just change the import path:\n\n```ts\n// Before\nimport { getClient, createClient, authorize } from '@epilot/entity-client'\nimport type { Client, Entity } from '@epilot/entity-client'\n\n// After\nimport { getClient, createClient, authorize } from '@epilot/sdk/entity'\nimport type { Client, Entity } from '@epilot/sdk/entity'\n```\n\n</details>\n\n<details>\n<summary>Client Lifecycle</summary>\n\nWhen you call `authorize()`, `headers()`, `retry()`, `largeResponse()`, or `interceptors`, the SDK invalidates all cached client instances. The next operation call creates a fresh client with the updated configuration.\n\n**Operation methods are always up to date** \u2014 calls like `epilot.entity.getEntity(...)` re-resolve the client on every invocation, so they always use the latest config.\n\n**Direct `getClient()` references can go stale** \u2014 if you hold a reference and then change config, your reference still points to the old client:\n\n```ts\nconst entityClient = epilot.entity.getClient()\n\nepilot.authorize('new-token') // invalidates all cached clients\n\n// entityClient still has the old token\n// epilot.entity.getEntity(...) will use a new client with the new token\n```\n\nIf you need a long-lived reference that survives config changes, call `getClient()` again after changing config, or use operation methods directly.\n\n</details>\n";
-
-
-exports.default = README_default;

package/dist/README-ZSJDIPZZ.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/README.json
-var README_default = "<h1 align=\"center\"><img alt=\"epilot\" src=\"https://raw.githubusercontent.com/epilot-dev/sdk-js/main/logo.png\" width=\"200\"><br>@epilot/sdk</h1>\n\n<p align=\"center\">\n  <a href=\"https://github.com/epilot-dev/sdk-js/actions?query=workflow%3ACI\"><img src=\"https://github.com/epilot-dev/sdk-js/workflows/CI/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://www.npmjs.com/package/@epilot/sdk\"><img src=\"https://img.shields.io/npm/v/@epilot/sdk.svg\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/epilot-dev/sdk-js/blob/main/\"><img src=\"http://img.shields.io/:license-mit-blue.svg\" alt=\"License\"></a>\n</p>\n\n<p align=\"center\">JavaScript/TypeScript SDK for epilot APIs. Full types, tree-shakeable imports, and lazy-loaded OpenAPI specs.</p>\n\n## Install\n\n```bash\nnpm i @epilot/sdk axios openapi-client-axios\n```\n\n## Quick Start\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-bearer-token>')\n\nconst { data: entity } = await epilot.entity.createEntity(\n  { slug: 'contact' },\n  { first_name: 'John', last_name: 'Doe' },\n)\n\nconst { data: file } = await epilot.file.getFile({ id: 'file-123' })\n\nconst { data: executions } = await epilot.workflow.getExecutions()\n```\n\nAPI clients are built on [openapi-client-axios](https://openapistack.co/docs/openapi-client-axios/intro/), which generates fully typed operation methods on top of regular [axios](https://axios-http.com/docs/intro) instances. All standard axios features (interceptors, defaults, config) work as expected. Each operation is forwarded to a lazy singleton \u2014 the spec is loaded and the client initialized on first use, then cached.\n\nFull API documentation: [https://docs.epilot.io/api](https://docs.epilot.io/api)\n\n## API Reference\n\n<!-- api-reference-table -->\n| API | Import | Docs |\n| --- | ------ | ---- |\n| `epilot.accessToken` | `@epilot/sdk/access-token` | [docs](./docs/access-token.md) |\n| `epilot.address` | `@epilot/sdk/address` | [docs](./docs/address.md) |\n| `epilot.addressSuggestions` | `@epilot/sdk/address-suggestions` | [docs](./docs/address-suggestions.md) |\n| `epilot.aiAgents` | `@epilot/sdk/ai-agents` | [docs](./docs/ai-agents.md) |\n| `epilot.app` | `@epilot/sdk/app` | [docs](./docs/app.md) |\n| `epilot.auditLogs` | `@epilot/sdk/audit-logs` | [docs](./docs/audit-logs.md) |\n| `epilot.automation` | `@epilot/sdk/automation` | [docs](./docs/automation.md) |\n| `epilot.billing` | `@epilot/sdk/billing` | [docs](./docs/billing.md) |\n| `epilot.blueprintManifest` | `@epilot/sdk/blueprint-manifest` | [docs](./docs/blueprint-manifest.md) |\n| `epilot.calendar` | `@epilot/sdk/calendar` | [docs](./docs/calendar.md) |\n| `epilot.chat` | `@epilot/sdk/chat` | [docs](./docs/chat.md) |\n| `epilot.configurationHub` | `@epilot/sdk/configuration-hub` | [docs](./docs/configuration-hub.md) |\n| `epilot.consent` | `@epilot/sdk/consent` | [docs](./docs/consent.md) |\n| `epilot.customerPortal` | `@epilot/sdk/customer-portal` | [docs](./docs/customer-portal.md) |\n| `epilot.dashboard` | `@epilot/sdk/dashboard` | [docs](./docs/dashboard.md) |\n| `epilot.dataGovernance` | `@epilot/sdk/data-governance` | [docs](./docs/data-governance.md) |\n| `epilot.deduplication` | `@epilot/sdk/deduplication` | [docs](./docs/deduplication.md) |\n| `epilot.design` | `@epilot/sdk/design` | [docs](./docs/design.md) |\n| `epilot.document` | `@epilot/sdk/document` | [docs](./docs/document.md) |\n| `epilot.emailSettings` | `@epilot/sdk/email-settings` | [docs](./docs/email-settings.md) |\n| `epilot.emailTemplate` | `@epilot/sdk/email-template` | [docs](./docs/email-template.md) |\n| `epilot.entity` | `@epilot/sdk/entity` | [docs](./docs/entity.md) |\n| `epilot.entityMapping` | `@epilot/sdk/entity-mapping` | [docs](./docs/entity-mapping.md) |\n| `epilot.environments` | `@epilot/sdk/environments` | [docs](./docs/environments.md) |\n| `epilot.eventCatalog` | `@epilot/sdk/event-catalog` | [docs](./docs/event-catalog.md) |\n| `epilot.file` | `@epilot/sdk/file` | [docs](./docs/file.md) |\n| `epilot.iban` | `@epilot/sdk/iban` | [docs](./docs/iban.md) |\n| `epilot.identity` | `@epilot/sdk/identity` | [docs](./docs/identity.md) |\n| `epilot.integrationToolkit` | `@epilot/sdk/integration-toolkit` | [docs](./docs/integration-toolkit.md) |\n| `epilot.journey` | `@epilot/sdk/journey` | [docs](./docs/journey.md) |\n| `epilot.kanban` | `@epilot/sdk/kanban` | [docs](./docs/kanban.md) |\n| `epilot.message` | `@epilot/sdk/message` | [docs](./docs/message.md) |\n| `epilot.metering` | `@epilot/sdk/metering` | [docs](./docs/metering.md) |\n| `epilot.notes` | `@epilot/sdk/notes` | [docs](./docs/notes.md) |\n| `epilot.notification` | `@epilot/sdk/notification` | [docs](./docs/notification.md) |\n| `epilot.organization` | `@epilot/sdk/organization` | [docs](./docs/organization.md) |\n| `epilot.partnerDirectory` | `@epilot/sdk/partner-directory` | [docs](./docs/partner-directory.md) |\n| `epilot.permissions` | `@epilot/sdk/permissions` | [docs](./docs/permissions.md) |\n| `epilot.pricing` | `@epilot/sdk/pricing` | [docs](./docs/pricing.md) |\n| `epilot.pricingTier` | `@epilot/sdk/pricing-tier` | [docs](./docs/pricing-tier.md) |\n| `epilot.purpose` | `@epilot/sdk/purpose` | [docs](./docs/purpose.md) |\n| `epilot.query` | `@epilot/sdk/query` | [docs](./docs/query.md) |\n| `epilot.sandbox` | `@epilot/sdk/sandbox` | [docs](./docs/sandbox.md) |\n| `epilot.sharing` | `@epilot/sdk/sharing` | [docs](./docs/sharing.md) |\n| `epilot.snapshot` | `@epilot/sdk/snapshot` | [docs](./docs/snapshot.md) |\n| `epilot.submission` | `@epilot/sdk/submission` | [docs](./docs/submission.md) |\n| `epilot.targeting` | `@epilot/sdk/targeting` | [docs](./docs/targeting.md) |\n| `epilot.templateVariables` | `@epilot/sdk/template-variables` | [docs](./docs/template-variables.md) |\n| `epilot.user` | `@epilot/sdk/user` | [docs](./docs/user.md) |\n| `epilot.validationRules` | `@epilot/sdk/validation-rules` | [docs](./docs/validation-rules.md) |\n| `epilot.webhooks` | `@epilot/sdk/webhooks` | [docs](./docs/webhooks.md) |\n| `epilot.workflow` | `@epilot/sdk/workflow` | [docs](./docs/workflow.md) |\n| `epilot.workflowDefinition` | `@epilot/sdk/workflow-definition` | [docs](./docs/workflow-definition.md) |\n<!-- /api-reference-table -->\n\n## OpenAPI Spec\n\nRetrieve the full OpenAPI specification for any API at runtime. The spec is lazy-loaded on first call and cached.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Via API handle\nconst entitySpec = await epilot.entity.openapi()\nconsole.log(entitySpec.info.title) // \"Entity API\"\nconsole.log(entitySpec.paths)       // all paths with full schemas\n\n// Via top-level method\nconst spec = await epilot.openapi('entity')\n```\n\nFor tree-shakeable imports:\n\n```ts\nimport { openapi } from '@epilot/sdk/entity'\n\nconst spec = await openapi()\n```\n\n## Explicit Client Access\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\n\n// Get the cached singleton client\nconst entityClient = epilot.entity.getClient()\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Create a fresh (non-singleton) client instance\nconst freshClient = epilot.entity.createClient()\nauthorize(freshClient, () => '<my-token>')\n```\n\n## Tree-Shakeable Imports\n\nImport only what you need. Other APIs never touch your bundle.\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\nconst { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })\n\n// Or use the handle for direct operation forwarding\nimport { entity } from '@epilot/sdk/entity'\nconst { data } = await entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n## Types\n\nEach API subpath re-exports all schema types generated from the OpenAPI spec. Import them directly:\n\n```ts\nimport type { Entity, EntitySchema, RelationAttribute } from '@epilot/sdk/entity'\nimport type { FileItem } from '@epilot/sdk/file'\nimport type { AutomationFlow } from '@epilot/sdk/automation'\n```\n\nThe `Client`, `OperationMethods`, and `PathsDictionary` types are also available for typing client instances:\n\n```ts\nimport type { Client } from '@epilot/sdk/entity'\n\nconst entityClient: Client = epilot.entity.getClient()\n```\n\n## Headers\n\n### Global Headers\n\nSet default headers applied to all clients. Useful for `x-epilot-org-id`, `x-epilot-user-id`, etc.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.headers({\n  'x-epilot-org-id': 'org-123',\n  'x-epilot-user-id': 'user-456',\n})\n\nconst { data } = await epilot.entity.searchEntities(...)\n```\n\n### Standard Axios Headers\n\nUse standard axios `defaults.headers.common` on individual clients:\n\n```ts\nconst entityClient = epilot.entity.getClient()\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Auth Patterns\n\n`authorize()` accepts a string or a function. The function form is preferred \u2014 it is called on every request, so tokens stay fresh.\n\n```ts\nimport { authorize } from '@epilot/sdk'\nimport { getClient } from '@epilot/sdk/entity'\n\n// Per-client \u2014 function predicate (recommended)\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\n\n// Per-client \u2014 async function (e.g. OAuth / session)\nauthorize(entityClient, async () => {\n  return await getTokenFromSession()\n})\n\n// Per-client \u2014 static string (sets default header once)\nauthorize(entityClient, 'my-static-api-token')\n```\n\n```ts\n// Global \u2014 applies to all clients resolved from the SDK\nimport { epilot } from '@epilot/sdk'\n\nepilot.authorize(() => '<my-token>')\nepilot.authorize(async () => await getTokenFromSession())\nepilot.authorize('my-static-api-token')\n```\n\n## Fresh Client Instance\n\n```ts\nimport { createClient, authorize } from '@epilot/sdk/entity'\n\nconst entityClient = createClient()\nauthorize(entityClient, () => '<my-token>')\nentityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'\n```\n\n## Multiple SDK Instances\n\n```ts\nimport { createSDK } from '@epilot/sdk'\n\nconst sdk1 = createSDK()\nsdk1.authorize(() => '<token-for-org-1>')\nsdk1.headers({ 'x-epilot-org-id': 'org-1' })\n\nconst sdk2 = createSDK()\nsdk2.authorize(() => '<token-for-org-2>')\nsdk2.headers({ 'x-epilot-org-id': 'org-2' })\n```\n\n\n## Interceptors\n\nUse axios interceptors for custom request/response processing. Since clients are axios instances, you can use `client.interceptors` directly:\n\n```ts\nentityClient.interceptors.response.use((response) => {\n  console.debug(`${response.config.method?.toUpperCase()} ${response.config.url}`, {\n    status: response.status,\n    data: response.data,\n  })\n  return response\n})\n```\n\nOr register global interceptors applied to all clients:\n\n```ts\nepilot.interceptors.request((config) => {\n  config.headers['x-correlation-id'] = generateTraceId()\n  return config\n})\n```\n\n## Auto-Retry (429 Too Many Requests)\n\nThe SDK automatically retries requests that receive a `429 Too Many Requests` response. It respects the `Retry-After` header (in seconds) to determine how long to wait before retrying.\n\nEnabled by default with up to 3 retries.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Customize retry behavior\nepilot.retry({ maxRetries: 5, defaultDelayMs: 2000 })\n\n// Disable retries\nepilot.retry({ maxRetries: 0 })\n```\n\n| Option | Default | Description |\n| --- | --- | --- |\n| `maxRetries` | `3` | Maximum number of retries. Set to `0` to disable. |\n| `defaultDelayMs` | `1000` | Fallback delay in ms when `Retry-After` header is missing. |\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyRetryInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyRetryInterceptor({ client: entityClient, config: { maxRetries: 3 } })\n```\n\n## Large Response Handling (413 Payload Too Large)\n\nepilot APIs use a [large response middleware](https://github.com/epilot-dev/aws-lambda-utility-middlewares) to work around the AWS Lambda 6MB response limit. When a response exceeds ~5.1MB, the API uploads the payload to S3 and returns a presigned URL instead.\n\nThe SDK handles this transparently \u2014 it sends the opt-in `Accept` header and automatically fetches the full payload from S3 when a large response URL is returned. Enabled by default.\n\n```ts\nimport { epilot } from '@epilot/sdk'\n\n// Disable large response handling\nepilot.largeResponse({ enabled: false })\n```\n\nFor individually imported clients (tree-shakeable imports), apply the interceptor manually:\n\n```ts\nimport { getClient, authorize } from '@epilot/sdk/entity'\nimport { applyLargeResponseInterceptor } from '@epilot/sdk'\n\nconst entityClient = getClient()\nauthorize(entityClient, () => '<my-token>')\napplyLargeResponseInterceptor({ client: entityClient, config: { enabled: true } })\n```\n\n## Overrides & Custom APIs\n\nOverride built-in API specs or register custom APIs via `.epilot/sdk-overrides.json`. This is useful for testing new versions of an API spec or getting the latest types without waiting for an SDK release.\n\n```json\n{\n  \"entity\": \"./specs/entity-openapi.json\",\n  \"myNewApi\": \"./specs/my-new-api-openapi.json\"\n}\n```\n\n```ts\n// Built-in API with overridden spec\nconst { data } = await epilot.entity.getEntity({ slug: 'contact', id: '123' })\n```\n\n### Override Commands\n\n```bash\n# Apply all overrides from .epilot/sdk-overrides.json\nnpx epilot-sdk override\n\n# Override a single API\nnpx epilot-sdk override entity ./my-local-entity-spec.yaml\n\n# Regenerate types after spec changes\nnpx epilot-sdk typegen\n```\n\n<details>\n<summary>Migration from <code>@epilot/*-client</code></summary>\n\nDrop-in replacement \u2014 just change the import path:\n\n```ts\n// Before\nimport { getClient, createClient, authorize } from '@epilot/entity-client'\nimport type { Client, Entity } from '@epilot/entity-client'\n\n// After\nimport { getClient, createClient, authorize } from '@epilot/sdk/entity'\nimport type { Client, Entity } from '@epilot/sdk/entity'\n```\n\n</details>\n\n<details>\n<summary>Client Lifecycle</summary>\n\nWhen you call `authorize()`, `headers()`, `retry()`, `largeResponse()`, or `interceptors`, the SDK invalidates all cached client instances. The next operation call creates a fresh client with the updated configuration.\n\n**Operation methods are always up to date** \u2014 calls like `epilot.entity.getEntity(...)` re-resolve the client on every invocation, so they always use the latest config.\n\n**Direct `getClient()` references can go stale** \u2014 if you hold a reference and then change config, your reference still points to the old client:\n\n```ts\nconst entityClient = epilot.entity.getClient()\n\nepilot.authorize('new-token') // invalidates all cached clients\n\n// entityClient still has the old token\n// epilot.entity.getEntity(...) will use a new client with the new token\n```\n\nIf you need a long-lived reference that survives config changes, call `getClient()` again after changing config, or use operation methods directly.\n\n</details>\n";
-export {
-  README_default as default
-};