@epilot/sdk 2.20.10 → 2.20.11

package/dist/index.cjs

@@ -60,7 +60,7 @@ var _chunkQLWDOKGEcjs = require('./chunk-QLWDOKGE.cjs');
 var _chunkWQBBB6BNcjs = require('./chunk-WQBBB6BN.cjs');
 
 
-var _chunkMPZICOVZcjs = require('./chunk-MPZICOVZ.cjs');
+var _chunk2Q6CNXJ2cjs = require('./chunk-2Q6CNXJ2.cjs');
 
 
 var _chunk424JLS5Gcjs = require('./chunk-424JLS5G.cjs');
@@ -158,7 +158,7 @@ var _chunkWOUASZJWcjs = require('./chunk-WOUASZJW.cjs');
 
 
 
-var _chunkVAGYR2R6cjs = require('./chunk-VAGYR2R6.cjs');
+var _chunkQZH7QNNPcjs = require('./chunk-QZH7QNNP.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -225,7 +225,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunkVAGYR2R6cjs.createApiClient.call(void 0, {
+    entry.instance = _chunkQZH7QNNPcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -258,7 +258,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunkVAGYR2R6cjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkQZH7QNNPcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -378,7 +378,7 @@ var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
     name: "eventCatalog",
-    loader: () => expandDef(_chunkMPZICOVZcjs.require_event_catalog_runtime.call(void 0, ))
+    loader: () => expandDef(_chunk2Q6CNXJ2cjs.require_event_catalog_runtime.call(void 0, ))
   });
   registerApi({
     registry,
@@ -601,9 +601,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunkVAGYR2R6cjs.createApiHandle.call(void 0, {
+    return _chunkQZH7QNNPcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunkVAGYR2R6cjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkQZH7QNNPcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -651,9 +651,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunkVAGYR2R6cjs.help.call(void 0, apiName);
+          return (apiName) => _chunkQZH7QNNPcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunkVAGYR2R6cjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkQZH7QNNPcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -683,4 +683,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkVAGYR2R6cjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkVAGYR2R6cjs.help; exports.openapi = _chunkVAGYR2R6cjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkQZH7QNNPcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkQZH7QNNPcjs.help; exports.openapi = _chunkQZH7QNNPcjs.openapi;

package/dist/index.d.cts

@@ -26,7 +26,7 @@ import { C as Client$j } from './email-template.d-gtQkdaXM.cjs';
 import { C as Client$k } from './entity.d-GfKqzFGA.cjs';
 import { C as Client$l } from './entity-mapping.d-CQv75o8M.cjs';
 import { C as Client$m } from './environments.d-C_BTxz4W.cjs';
-import { C as Client$n } from './event-catalog.d-Bd2wmtlZ.cjs';
+import { C as Client$n } from './event-catalog.d-CCE1qmBN.cjs';
 import { C as Client$o } from './file.d-DELNV63w.cjs';
 import { C as Client$p } from './iban.d-BwdiGbxi.cjs';
 import { C as Client$q } from './integration-toolkit.d-rpj1kvB_.cjs';

package/dist/index.d.ts

@@ -26,7 +26,7 @@ import { C as Client$j } from './email-template.d-gtQkdaXM.js';
 import { C as Client$k } from './entity.d-GfKqzFGA.js';
 import { C as Client$l } from './entity-mapping.d-CQv75o8M.js';
 import { C as Client$m } from './environments.d-C_BTxz4W.js';
-import { C as Client$n } from './event-catalog.d-Bd2wmtlZ.js';
+import { C as Client$n } from './event-catalog.d-CCE1qmBN.js';
 import { C as Client$o } from './file.d-DELNV63w.js';
 import { C as Client$p } from './iban.d-BwdiGbxi.js';
 import { C as Client$q } from './integration-toolkit.d-rpj1kvB_.js';

package/dist/index.js

@@ -60,7 +60,7 @@ import {
 } from "./chunk-D7Q4JGN7.js";
 import {
   require_event_catalog_runtime
-} from "./chunk-EEKJGTAS.js";
+} from "./chunk-LTCN52JS.js";
 import {
   require_file_runtime
 } from "./chunk-FGQBS7TA.js";
@@ -158,7 +158,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-A7UIYIBZ.js";
+} from "./chunk-SMERBU2T.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/docs/event-catalog.md

@@ -29,6 +29,7 @@ const { data } = await eventCatalogClient.listEvents(...)
 - [`createCustomEvent`](#createcustomevent)
 - [`getEvent`](#getevent)
 - [`patchEvent`](#patchevent)
+- [`replaceCustomEventDraft`](#replacecustomeventdraft)
 - [`deprecateCustomEvent`](#deprecatecustomevent)
 - [`previewCustomEvent`](#previewcustomevent)
 - [`publishCustomEventDefinition`](#publishcustomeventdefinition)
@@ -131,6 +132,7 @@ const { data } = await client.listEvents()
       "enabled": true,
       "auto_trigger": true,
       "automation_trigger": true,
+      "api_trigger": true,
       "automation_trigger_only": true,
       "automation_trigger_seed_node": "ticket",
       "event_origin": "builtin",
@@ -163,7 +165,7 @@ const { data } = await client.listEvents()
 
 ### `createCustomEvent`
 
-Reserve an org-scoped custom event name and persist its immutable v1.0 draft definition.
+Reserve an org-scoped custom event name and persist its immutable v1.0 draft definition. Custom events are always projected from an entity graph: entity_graph is required and, in guided mapping mode, 
 
 `POST /v1/events`
 
@@ -205,6 +207,9 @@ const { data } = await client.createCustomEvent(
       ]
     },
     automation_trigger: true,
+    api_trigger: true,
+    automation_trigger_only: false,
+    automation_trigger_seed_node: 'string',
     mapping: {
       mode: 'guided',
       jsonata: 'string'
@@ -261,6 +266,7 @@ const { data } = await client.createCustomEvent(
   "enabled": true,
   "auto_trigger": true,
   "automation_trigger": true,
+  "api_trigger": true,
   "automation_trigger_only": true,
   "automation_trigger_seed_node": "ticket",
   "event_origin": "builtin",
@@ -344,6 +350,7 @@ const { data } = await client.getEvent({
   "enabled": true,
   "auto_trigger": true,
   "automation_trigger": true,
+  "api_trigger": true,
   "automation_trigger_only": true,
   "automation_trigger_seed_node": "ticket",
   "event_origin": "builtin",
@@ -439,6 +446,143 @@ const { data } = await client.patchEvent(
   "enabled": true,
   "auto_trigger": true,
   "automation_trigger": true,
+  "api_trigger": true,
+  "automation_trigger_only": true,
+  "automation_trigger_seed_node": "ticket",
+  "event_origin": "builtin",
+  "mapping": {
+    "mode": "guided",
+    "jsonata": "string"
+  },
+  "lineage": {
+    "base_event_name": "string",
+    "base_event_version": "string"
+  },
+  "success_criteria": [
+    {
+      "entity_schema": "contract",
+      "attribute": "installment_amount"
+    },
+    {
+      "entity_schema": "billing_account",
+      "attribute": "due_date"
+    }
+  ]
+}
+```
+
+</details>
+
+---
+
+### `replaceCustomEventDraft`
+
+Replace the complete v1.0 definition of an org-scoped custom event while it is still an
+unpublished draft. Drafts have no consumers, so their definition is not yet immutable;
+the event name is the ide
+
+`PUT /v1/events/{event_name}`
+
+```ts
+const { data } = await client.replaceCustomEventDraft(
+  {
+    event_name: 'example',
+  },
+  {
+    event_name: 'string',
+    event_title: 'string',
+    event_description: 'string',
+    event_tags: ['string'],
+    schema_fields: {},
+    entity_graph: {
+      nodes: [
+        {
+          id: 'contact',
+          schema: 'contact',
+          cardinality: 'one',
+          fields: ['_id', '_title', 'first_name', 'account', '!account.*._files', '**._product']
+        }
+      ],
+      edges: [
+        {
+          from: 'contact',
+          to: 'billing_account'
+        }
+      ]
+    },
+    entity_operation: {
+      operation: ['createEntity', 'updateEntity'],
+      schema: ['contact', 'contract', 'order'],
+      attribute: ['email', 'phone', 'status'],
+      purpose: ['Kündigung', 'Umzug/Auszug'],
+      purpose_filters: [
+        {
+          id: 'string',
+          display_name: 'string'
+        }
+      ]
+    },
+    automation_trigger: true,
+    api_trigger: true,
+    automation_trigger_only: false,
+    automation_trigger_seed_node: 'string',
+    mapping: {
+      mode: 'guided',
+      jsonata: 'string'
+    },
+    lineage: {
+      base_event_name: 'string',
+      base_event_version: 'string'
+    },
+    example: {}
+  },
+)
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "event_name": "AddMeterReading",
+  "event_title": "Add Meter Reading",
+  "event_description": "Triggered when a new meter reading is added",
+  "event_version": "1.0",
+  "event_status": "active",
+  "event_tags": ["builtin", "metering", "erp"],
+  "schema_fields": {},
+  "entity_graph": {
+    "nodes": [
+      {
+        "id": "contact",
+        "schema": "contact",
+        "cardinality": "one",
+        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]
+      }
+    ],
+    "edges": [
+      {
+        "from": "contact",
+        "to": "billing_account"
+      }
+    ]
+  },
+  "entity_operation": {
+    "operation": ["createEntity", "updateEntity"],
+    "schema": ["contact", "contract", "order"],
+    "attribute": ["email", "phone", "status"],
+    "purpose": ["Kündigung", "Umzug/Auszug"],
+    "purpose_filters": [
+      {
+        "id": "string",
+        "display_name": "string"
+      }
+    ]
+  },
+  "enabled": true,
+  "auto_trigger": true,
+  "automation_trigger": true,
+  "api_trigger": true,
   "automation_trigger_only": true,
   "automation_trigger_seed_node": "ticket",
   "event_origin": "builtin",
@@ -584,6 +728,7 @@ const { data } = await client.publishCustomEventDefinition(
   "enabled": true,
   "auto_trigger": true,
   "automation_trigger": true,
+  "api_trigger": true,
   "automation_trigger_only": true,
   "automation_trigger_seed_node": "ticket",
   "event_origin": "builtin",
@@ -1072,6 +1217,7 @@ type EventConfigBase = {
   enabled?: boolean
   auto_trigger?: boolean
   automation_trigger?: boolean
+  api_trigger?: boolean
   automation_trigger_only?: boolean
   automation_trigger_seed_node?: string
   event_origin?: "builtin" | "custom"
@@ -1146,6 +1292,7 @@ type EventConfig = {
   enabled?: boolean
   auto_trigger?: boolean
   automation_trigger?: boolean
+  api_trigger?: boolean
   automation_trigger_only?: boolean
   automation_trigger_seed_node?: string
   event_origin?: "builtin" | "custom"
@@ -1166,7 +1313,7 @@ type EventConfig = {
 
 ### `CreateCustomEventPayload`
 
-Complete immutable custom-event v1.0 definition. Publication is a separate conditional action.
+Complete immutable custom-event v1.0 definition projected from a required entity graph. Publication is a separate conditional action.
 
 ```ts
 type CreateCustomEventPayload = {
@@ -1182,7 +1329,7 @@ type CreateCustomEventPayload = {
     entity_schema: string
     required?: boolean
   }>
-  entity_graph?: {
+  entity_graph: {
     nodes: Array<{
       id: { ... }
       schema: { ... }
@@ -1205,6 +1352,9 @@ type CreateCustomEventPayload = {
     }>
   }
   automation_trigger?: boolean
+  api_trigger?: boolean
+  automation_trigger_only?: boolean
+  automation_trigger_seed_node?: string
   mapping?: {
     mode: "guided" | "jsonata"
     jsonata?: string
@@ -1230,7 +1380,7 @@ type EventMapping = {
 
 ### `CustomEventLineage`
 
-Optional catalog lineage to a separately named base event. It does not replace the base event.
+Optional catalog lineage to a separately named base event. Built-in inheritance is validated against this exact registered version; its trigger restrictions cannot be removed or replaced. It does not replace the base event.
 
 ```ts
 type CustomEventLineage = {
@@ -1341,7 +1491,7 @@ type AttachmentField = {
 
 ### `CustomSchemaField`
 
-Custom v1 fields support JSON Schema values and context entities; attachment semantics are built-in-only.
+Custom v1 fields support graph-projected JSON Schema values and context entities; attachment semantics are built-in-only.
 
 ```ts
 type CustomSchemaField = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.20.10",
+  "version": "2.20.11",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",

package/definitions/access-token-runtime.json

@@ -1 +0,0 @@
-{"s":"https://access-token.sls.epilot.io","o":[["createAccessToken","post","/v1/access-tokens",null,1],["listAccessTokens","get","/v1/access-tokens",[["token_type","q"]]],["revokeAccessToken","delete","/v1/access-tokens/{id}",[["id","p",true]]],["getAccessTokenJwks","get","/v1/access-tokens/.well-known/jwks.json"],["getAccessTokenOIDC","get","/v1/access-tokens/.well-known/openid-configuration"],["getPublicTokenJwks","get","/v1/access-tokens/public/.well-known/jwks.json"],["getPortalPreviewTokenJwks","get","/v1/access-tokens/portal-preview/.well-known/jwks.json"],["getPublicTokenOIDC","get","/v1/access-tokens/public/.well-known/openid-configuration"],["getPortalPreviewTokenOIDC","get","/v1/access-tokens/portal-preview/.well-known/openid-configuration"]],"v":"3.0.3"}