@epilot/sdk 2.20.58 → 2.20.60

package/dist/{external-values.d-DjP9C_-r.d.cts → external-values.d-23q55J5P.d.cts}

@@ -13,6 +13,38 @@ declare namespace Components {
         HookId?: Parameters.HookId /* ^[a-zA-Z0-9_-]{1,100}$ */;
     }
     namespace Schemas {
+        /**
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
+         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         *
+         */
+        export type ContextRequirement = /**
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
+         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         *
+         */
+        /**
+         * The consumer supplies the bound entities of `schema` under `Context.<schema>`, e.g. a hook
+         * interpolating `{{ Context.contract[0].external_id }}` declares
+         * `{ type: entity, schema: contract }`.
+         *
+         */
+        EntityContextRequirement;
+        /**
+         * The consumer supplies the bound entities of `schema` under `Context.<schema>`, e.g. a hook
+         * interpolating `{{ Context.contract[0].external_id }}` declares
+         * `{ type: entity, schema: contract }`.
+         *
+         */
+        export interface EntityContextRequirement {
+            type: "entity";
+            /**
+             * Entity schema slug, e.g. `contract`.
+             * example:
+             * contract
+             */
+            schema: string;
+        }
         export interface ExternalValueError {
             /**
              * Set for per-result errors; absent for hook-level failures
@@ -48,6 +80,19 @@ declare namespace Components {
             name: TranslatedString;
             description?: TranslatedString;
             results: ExternalValueResultSummary[];
+            /**
+             * What the hook needs the consumer to supply in `context`, as declared in the hook
+             * config. Omitted when the hook declares none. A rule builder must require these
+             * contexts on any rule that uses the hook, so the caller passes them in `context`.
+             * More requirement types will follow; consumers ignore types they do not know.
+             *
+             */
+            contexts?: /**
+             * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
+             * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+             *
+             */
+            ContextRequirement[];
         }
         export interface ExternalValueResultSummary {
             id: string;
@@ -59,11 +104,13 @@ declare namespace Components {
          * example:
          * {
          *   "context": {
-         *     "input": "123,45",
-         *     "contract": {
-         *       "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
-         *       "installment_amount": 110
-         *     }
+         *     "contract": [
+         *       {
+         *         "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
+         *         "external_id": "C-1001",
+         *         "installment_amount": 110
+         *       }
+         *     ]
          *   },
          *   "consumer": {
          *     "type": "validation_rule",
@@ -75,11 +122,12 @@ declare namespace Components {
             /**
              * Everything the consumer supplies for interpolation, as one name → value map.
              * Exposed to the hook's Liquid templates as `Context` / `context`, e.g.
-             * `{{ context.input }}`, `{{ context.contract.installment_amount }}`.
+             * `{{ context.contract[0].external_id }}`.
              *
-             * The names are up to the consumer; this API does not interpret them. By
-             * convention the journey runtime passes the validated value of a validation
-             * rule as `input` and every configured context binding under its own name.
+             * One entry per context requirement the consumer bound (see
+             * `ExternalValueHookSummary.contexts`): for an `entity` requirement, the bound
+             * entities of that schema under its schema slug. This API gives no name special
+             * treatment.
              *
              */
             context: {
@@ -165,11 +213,13 @@ declare namespace Paths {
          * example:
          * {
          *   "context": {
-         *     "input": "123,45",
-         *     "contract": {
-         *       "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
-         *       "installment_amount": 110
-         *     }
+         *     "contract": [
+         *       {
+         *         "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
+         *         "external_id": "C-1001",
+         *         "installment_amount": 110
+         *       }
+         *     ]
          *   },
          *   "consumer": {
          *     "type": "validation_rule",
@@ -217,11 +267,13 @@ declare namespace Paths {
          * example:
          * {
          *   "context": {
-         *     "input": "123,45",
-         *     "contract": {
-         *       "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
-         *       "installment_amount": 110
-         *     }
+         *     "contract": [
+         *       {
+         *         "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
+         *         "external_id": "C-1001",
+         *         "installment_amount": 110
+         *       }
+         *     ]
          *   },
          *   "consumer": {
          *     "type": "validation_rule",
@@ -378,6 +430,8 @@ interface PathsDictionary {
 type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
+type ContextRequirement = Components.Schemas.ContextRequirement;
+type EntityContextRequirement = Components.Schemas.EntityContextRequirement;
 type ExternalValueError = Components.Schemas.ExternalValueError;
 type ExternalValueErrorCode = Components.Schemas.ExternalValueErrorCode;
 type ExternalValueHookList = Components.Schemas.ExternalValueHookList;
@@ -388,4 +442,4 @@ type ResolveExternalValueRequest = Components.Schemas.ResolveExternalValueReques
 type ResolveExternalValueResponse = Components.Schemas.ResolveExternalValueResponse;
 type TranslatedString = Components.Schemas.TranslatedString;
 
-export { type Client as C, type ExternalValueError as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, Components as a, type PathsDictionary as b, type ExternalValueErrorCode as c, type ExternalValueHookList as d, type ExternalValueHookSummary as e, type ExternalValueResultSummary as f, type ExternalValueType as g, type ResolveExternalValueResponse as h };
+export { type Client as C, type EntityContextRequirement as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, Components as a, type PathsDictionary as b, type ContextRequirement as c, type ExternalValueError as d, type ExternalValueErrorCode as e, type ExternalValueHookList as f, type ExternalValueHookSummary as g, type ExternalValueResultSummary as h, type ExternalValueType as i, type ResolveExternalValueResponse as j };

package/dist/{external-values.d-DjP9C_-r.d.ts → external-values.d-23q55J5P.d.ts}

@@ -13,6 +13,38 @@ declare namespace Components {
         HookId?: Parameters.HookId /* ^[a-zA-Z0-9_-]{1,100}$ */;
     }
     namespace Schemas {
+        /**
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
+         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         *
+         */
+        export type ContextRequirement = /**
+         * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
+         * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+         *
+         */
+        /**
+         * The consumer supplies the bound entities of `schema` under `Context.<schema>`, e.g. a hook
+         * interpolating `{{ Context.contract[0].external_id }}` declares
+         * `{ type: entity, schema: contract }`.
+         *
+         */
+        EntityContextRequirement;
+        /**
+         * The consumer supplies the bound entities of `schema` under `Context.<schema>`, e.g. a hook
+         * interpolating `{{ Context.contract[0].external_id }}` declares
+         * `{ type: entity, schema: contract }`.
+         *
+         */
+        export interface EntityContextRequirement {
+            type: "entity";
+            /**
+             * Entity schema slug, e.g. `contract`.
+             * example:
+             * contract
+             */
+            schema: string;
+        }
         export interface ExternalValueError {
             /**
              * Set for per-result errors; absent for hook-level failures
@@ -48,6 +80,19 @@ declare namespace Components {
             name: TranslatedString;
             description?: TranslatedString;
             results: ExternalValueResultSummary[];
+            /**
+             * What the hook needs the consumer to supply in `context`, as declared in the hook
+             * config. Omitted when the hook declares none. A rule builder must require these
+             * contexts on any rule that uses the hook, so the caller passes them in `context`.
+             * More requirement types will follow; consumers ignore types they do not know.
+             *
+             */
+            contexts?: /**
+             * Something a hook needs the consumer to supply in `context`, discriminated by `type`.
+             * Today only `entity`; more types will follow. Consumers ignore types they do not know.
+             *
+             */
+            ContextRequirement[];
         }
         export interface ExternalValueResultSummary {
             id: string;
@@ -59,11 +104,13 @@ declare namespace Components {
          * example:
          * {
          *   "context": {
-         *     "input": "123,45",
-         *     "contract": {
-         *       "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
-         *       "installment_amount": 110
-         *     }
+         *     "contract": [
+         *       {
+         *         "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
+         *         "external_id": "C-1001",
+         *         "installment_amount": 110
+         *       }
+         *     ]
          *   },
          *   "consumer": {
          *     "type": "validation_rule",
@@ -75,11 +122,12 @@ declare namespace Components {
             /**
              * Everything the consumer supplies for interpolation, as one name → value map.
              * Exposed to the hook's Liquid templates as `Context` / `context`, e.g.
-             * `{{ context.input }}`, `{{ context.contract.installment_amount }}`.
+             * `{{ context.contract[0].external_id }}`.
              *
-             * The names are up to the consumer; this API does not interpret them. By
-             * convention the journey runtime passes the validated value of a validation
-             * rule as `input` and every configured context binding under its own name.
+             * One entry per context requirement the consumer bound (see
+             * `ExternalValueHookSummary.contexts`): for an `entity` requirement, the bound
+             * entities of that schema under its schema slug. This API gives no name special
+             * treatment.
              *
              */
             context: {
@@ -165,11 +213,13 @@ declare namespace Paths {
          * example:
          * {
          *   "context": {
-         *     "input": "123,45",
-         *     "contract": {
-         *       "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
-         *       "installment_amount": 110
-         *     }
+         *     "contract": [
+         *       {
+         *         "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
+         *         "external_id": "C-1001",
+         *         "installment_amount": 110
+         *       }
+         *     ]
          *   },
          *   "consumer": {
          *     "type": "validation_rule",
@@ -217,11 +267,13 @@ declare namespace Paths {
          * example:
          * {
          *   "context": {
-         *     "input": "123,45",
-         *     "contract": {
-         *       "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
-         *       "installment_amount": 110
-         *     }
+         *     "contract": [
+         *       {
+         *         "_id": "8a7e3f5e-9c0c-4c74-8d4a-1a1a1a1a1a1a",
+         *         "external_id": "C-1001",
+         *         "installment_amount": 110
+         *       }
+         *     ]
          *   },
          *   "consumer": {
          *     "type": "validation_rule",
@@ -378,6 +430,8 @@ interface PathsDictionary {
 type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
+type ContextRequirement = Components.Schemas.ContextRequirement;
+type EntityContextRequirement = Components.Schemas.EntityContextRequirement;
 type ExternalValueError = Components.Schemas.ExternalValueError;
 type ExternalValueErrorCode = Components.Schemas.ExternalValueErrorCode;
 type ExternalValueHookList = Components.Schemas.ExternalValueHookList;
@@ -388,4 +442,4 @@ type ResolveExternalValueRequest = Components.Schemas.ResolveExternalValueReques
 type ResolveExternalValueResponse = Components.Schemas.ResolveExternalValueResponse;
 type TranslatedString = Components.Schemas.TranslatedString;
 
-export { type Client as C, type ExternalValueError as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, Components as a, type PathsDictionary as b, type ExternalValueErrorCode as c, type ExternalValueHookList as d, type ExternalValueHookSummary as e, type ExternalValueResultSummary as f, type ExternalValueType as g, type ResolveExternalValueResponse as h };
+export { type Client as C, type EntityContextRequirement as E, type OperationMethods as O, Paths as P, type ResolveExternalValueRequest as R, type TranslatedString as T, Components as a, type PathsDictionary as b, type ContextRequirement as c, type ExternalValueError as d, type ExternalValueErrorCode as e, type ExternalValueHookList as f, type ExternalValueHookSummary as g, type ExternalValueResultSummary as h, type ExternalValueType as i, type ResolveExternalValueResponse as j };

package/dist/index.cjs

@@ -90,7 +90,7 @@ var _chunkYO4M3BZLcjs = require('./chunk-YO4M3BZL.cjs');
 var _chunkRPWTWCDCcjs = require('./chunk-RPWTWCDC.cjs');
 
 
-var _chunkEPZ3JT2Wcjs = require('./chunk-EPZ3JT2W.cjs');
+var _chunkY7KWK5H2cjs = require('./chunk-Y7KWK5H2.cjs');
 
 
 var _chunkQYHNZLHScjs = require('./chunk-QYHNZLHS.cjs');
@@ -170,7 +170,7 @@ var _chunkWOUASZJWcjs = require('./chunk-WOUASZJW.cjs');
 
 
 
-var _chunkS5K3TLPQcjs = require('./chunk-S5K3TLPQ.cjs');
+var _chunkRBSTI4X4cjs = require('./chunk-RBSTI4X4.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -244,7 +244,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunkS5K3TLPQcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkRBSTI4X4cjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -277,7 +277,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunkS5K3TLPQcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkRBSTI4X4cjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -427,7 +427,7 @@ var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
     name: "integrationToolkit",
-    loader: () => expandDef(_chunkEPZ3JT2Wcjs.require_integration_toolkit_runtime.call(void 0, ))
+    loader: () => expandDef(_chunkY7KWK5H2cjs.require_integration_toolkit_runtime.call(void 0, ))
   });
   registerApi({
     registry,
@@ -640,9 +640,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunkS5K3TLPQcjs.createApiHandle.call(void 0, {
+    return _chunkRBSTI4X4cjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunkS5K3TLPQcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkRBSTI4X4cjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -690,9 +690,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunkS5K3TLPQcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkRBSTI4X4cjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunkS5K3TLPQcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkRBSTI4X4cjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -722,4 +722,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkS5K3TLPQcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkS5K3TLPQcjs.help; exports.openapi = _chunkS5K3TLPQcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkRBSTI4X4cjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkRBSTI4X4cjs.help; exports.openapi = _chunkRBSTI4X4cjs.openapi;

package/dist/index.d.cts

@@ -7,7 +7,7 @@ import { C as Client } from './access-token.d-Yy-yrft_.cjs';
 import { C as Client$1 } from './address.d-CwAPOVxa.cjs';
 import { C as Client$2 } from './address-suggestions.d-_YwTOR-9.cjs';
 import { C as Client$3 } from './ai-agents.d-B3TkP4mo.cjs';
-import { C as Client$4 } from './app.d-CqXqNLxq.cjs';
+import { C as Client$4 } from './app.d-DbOr4uIC.cjs';
 import { C as Client$5 } from './audit-logs.d-BRToFqeX.cjs';
 import { C as Client$6 } from './automation.d-B8g3nYp-.cjs';
 import { C as Client$7 } from './billing.d-DA3sViEF.cjs';
@@ -28,11 +28,11 @@ import { C as Client$l } from './entity.d-BwsBk0Po.cjs';
 import { C as Client$m } from './entity-mapping.d-8MtWa2_L.cjs';
 import { C as Client$n } from './environments.d-qL1urwAq.cjs';
 import { C as Client$o } from './event-catalog.d-BrAxYS9D.cjs';
-import { C as Client$p } from './external-values.d-DjP9C_-r.cjs';
+import { C as Client$p } from './external-values.d-23q55J5P.cjs';
 import { C as Client$q } from './file.d-DELNV63w.cjs';
 import { C as Client$r } from './iban.d-BwdiGbxi.cjs';
 import { C as Client$s } from './identity.d-BBL0NI_O.cjs';
-import { C as Client$t } from './integration-toolkit.d-DWslwG3c.cjs';
+import { C as Client$t } from './integration-toolkit.d-oORkWs_H.cjs';
 import { C as Client$u } from './journey.d-CMtM6U3Y.cjs';
 import { C as Client$v } from './kanban.d-BHnSRCYW.cjs';
 import { C as Client$w } from './message.d-DwnqO-Us.cjs';

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import { C as Client } from './access-token.d-Yy-yrft_.js';
 import { C as Client$1 } from './address.d-CwAPOVxa.js';
 import { C as Client$2 } from './address-suggestions.d-_YwTOR-9.js';
 import { C as Client$3 } from './ai-agents.d-B3TkP4mo.js';
-import { C as Client$4 } from './app.d-CqXqNLxq.js';
+import { C as Client$4 } from './app.d-DbOr4uIC.js';
 import { C as Client$5 } from './audit-logs.d-BRToFqeX.js';
 import { C as Client$6 } from './automation.d-B8g3nYp-.js';
 import { C as Client$7 } from './billing.d-DA3sViEF.js';
@@ -28,11 +28,11 @@ 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 './external-values.d-DjP9C_-r.js';
+import { C as Client$p } from './external-values.d-23q55J5P.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-DWslwG3c.js';
+import { C as Client$t } from './integration-toolkit.d-oORkWs_H.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';

package/dist/index.js

@@ -90,7 +90,7 @@ import {
 } from "./chunk-3IBAPVLY.js";
 import {
   require_integration_toolkit_runtime
-} from "./chunk-6JWMDS4Z.js";
+} from "./chunk-MBWCGRCK.js";
 import {
   require_journey_runtime
 } from "./chunk-I3ZZES76.js";
@@ -170,7 +170,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-VAC7N66U.js";
+} from "./chunk-4MDOL6ZZ.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";