@epilot/sdk 2.5.0 → 2.7.0

package/dist/event-catalog-5JBHJJ2I.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
+
+// src/docs/event-catalog.json
+var event_catalog_default = '# Event Catalog API\n\n- **Base URL:** `https://event-catalog.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/event-catalog](https://docs.epilot.io/api/event-catalog)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.eventCatalog.listEvents(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/event-catalog\'\n\nconst eventCatalogClient = getClient()\nauthorize(eventCatalogClient, () => \'<token>\')\nconst { data } = await eventCatalogClient.listEvents(...)\n```\n\n## Operations\n\n**Event Catalog**\n- [`listEvents`](#listevents)\n- [`getEvent`](#getevent)\n- [`patchEvent`](#patchevent)\n- [`getEventJSONSchema`](#geteventjsonschema)\n- [`getEventExample`](#geteventexample)\n- [`searchEventHistory`](#searcheventhistory)\n- [`searchEventHistoryV2`](#searcheventhistoryv2)\n- [`getHistoricalEvent`](#gethistoricalevent)\n- [`triggerEvent`](#triggerevent)\n\n**Schemas**\n- [`EventConfigBase`](#eventconfigbase)\n- [`EventConfig`](#eventconfig)\n- [`UpdateEventPayload`](#updateeventpayload)\n- [`PrimitiveField`](#primitivefield)\n- [`ContextEntity`](#contextentity)\n- [`AttachmentField`](#attachmentfield)\n- [`SchemaField`](#schemafield)\n- [`CommonEventMetadata`](#commoneventmetadata)\n- [`EventJsonSchema`](#eventjsonschema)\n- [`Event`](#event)\n- [`EventSummary`](#eventsummary)\n- [`GraphDefinition`](#graphdefinition)\n- [`GraphNode`](#graphnode)\n- [`GraphEdge`](#graphedge)\n- [`EntityOperationTrigger`](#entityoperationtrigger)\n- [`SearchOptions`](#searchoptions)\n- [`SearchOptionsV2`](#searchoptionsv2)\n- [`FieldsParam`](#fieldsparam)\n- [`TriggerEventPayload`](#triggereventpayload)\n- [`TriggerEventResponse`](#triggereventresponse)\n- [`EventAttachment`](#eventattachment)\n\n### `listEvents`\n\nRetrieve list of available business events\n\n`GET /v1/events`\n\n```ts\nconst { data } = await client.listEvents()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "event_name": "AddMeterReading",\n      "event_title": "Add Meter Reading",\n      "event_description": "Triggered when a new meter reading is added",\n      "event_version": "1.0.0",\n      "event_status": "active",\n      "event_tags": ["builtin", "metering", "erp"],\n      "schema_fields": {},\n      "entity_graph": {\n        "nodes": [\n          {\n            "id": "contact",\n            "schema": "contact",\n            "cardinality": "one",\n            "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n          }\n        ],\n        "edges": [\n          {\n            "from": "contact",\n            "to": "billing_account"\n          }\n        ]\n      },\n      "entity_operation": {\n        "operation": ["createEntity", "updateEntity"],\n        "schema": ["contact", "contract", "order"],\n        "attribute": ["email", "phone", "status"],\n        "purpose": ["K\xFCndigung", "Umzug/Auszug"]\n      },\n      "enabled": true,\n      "auto_trigger": true,\n      "automation_trigger": true\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getEvent`\n\nRetrieve the configuration of a specific business event\n\n`GET /v1/events/{event_name}`\n\n```ts\nconst { data } = await client.getEvent({\n  event_name: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true\n}\n```\n\n</details>\n\n---\n\n### `patchEvent`\n\nUpdate the configuration of a specific business event for the organization\n\n`PATCH /v1/events/{event_name}`\n\n```ts\nconst { data } = await client.patchEvent(\n  {\n    event_name: \'example\',\n  },\n  {\n    event_name: \'AddMeterReading\',\n    event_title: \'Add Meter Reading\',\n    event_description: \'Triggered when a new meter reading is added\',\n    event_version: \'1.0.0\',\n    event_status: \'active\',\n    event_tags: [\'builtin\', \'metering\', \'erp\'],\n    schema_fields: {},\n    entity_graph: {\n      nodes: [\n        {\n          id: \'contact\',\n          schema: \'contact\',\n          cardinality: \'one\',\n          fields: [\'_id\', \'_title\', \'first_name\', \'account\', \'!account.*._files\', \'**._product\']\n        }\n      ],\n      edges: [\n        {\n          from: \'contact\',\n          to: \'billing_account\'\n        }\n      ]\n    },\n    entity_operation: {\n      operation: [\'createEntity\', \'updateEntity\'],\n      schema: [\'contact\', \'contract\', \'order\'],\n      attribute: [\'email\', \'phone\', \'status\'],\n      purpose: [\'K\xFCndigung\', \'Umzug/Auszug\']\n    },\n    enabled: true,\n    auto_trigger: true,\n    automation_trigger: true\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_name": "AddMeterReading",\n  "event_title": "Add Meter Reading",\n  "event_description": "Triggered when a new meter reading is added",\n  "event_version": "1.0.0",\n  "event_status": "active",\n  "event_tags": ["builtin", "metering", "erp"],\n  "schema_fields": {},\n  "entity_graph": {\n    "nodes": [\n      {\n        "id": "contact",\n        "schema": "contact",\n        "cardinality": "one",\n        "fields": ["_id", "_title", "first_name", "account", "!account.*._files", "**._product"]\n      }\n    ],\n    "edges": [\n      {\n        "from": "contact",\n        "to": "billing_account"\n      }\n    ]\n  },\n  "entity_operation": {\n    "operation": ["createEntity", "updateEntity"],\n    "schema": ["contact", "contract", "order"],\n    "attribute": ["email", "phone", "status"],\n    "purpose": ["K\xFCndigung", "Umzug/Auszug"]\n  },\n  "enabled": true,\n  "auto_trigger": true,\n  "automation_trigger": true\n}\n```\n\n</details>\n\n---\n\n### `getEventJSONSchema`\n\nRetrieve the JSON Schema of a specific business event\n\n`GET /v1/events/{event_name}/json_schema`\n\n```ts\nconst { data } = await client.getEventJSONSchema({\n  event_name: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "type": "object",\n  "properties": {\n    "_org_id": {\n      "type": "string",\n      "description": "epilot tenant/organization ID"\n    },\n    "_event_time": {\n      "type": "string",\n      "format": "date-time",\n      "description": "ISO 8601 timestamp when event occurred"\n    },\n    "_event_id": {\n      "type": "string",\n      "description": "Unique event identifier (ULID)"\n    },\n    "_event_name": {\n      "type": "string",\n      "description": "Event name from catalog"\n    },\n    "_event_version": {\n      "type": "string",\n      "description": "Event version (semver)"\n    },\n    "_event_source": {\n      "type": "string",\n      "description": "Source that triggered the event"\n    },\n    "reading_value": {\n      "type": "number",\n      "description": "The meter reading value"\n    },\n    "reading_date": {\n      "type": "string",\n      "format": "date-time",\n      "description": "ISO 8601 timestamp when reading was taken"\n    },\n    "read_by": {\n      "type": "string",\n      "description": "Name or identifier of who submitted the reading"\n    },\n    "reason": {\n      "type": "string",\n      "enum": ["regular", "move-in", "move-out", "supplier-change", "correction", "final"],\n      "description": "Reason for the meter reading"\n    },\n    "direction": {\n      "type": "string",\n      "enum": ["feed-in", "feed-out"],\n      "description": "Direction of energy flow"\n    },\n    "source": {\n      "type": "string",\n      "enum": ["portal", "360", "api", "automation"],\n      "description": "Source system where reading was submitted"\n    },\n    "meter_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the meter"\n    },\n    "counter_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the meter counter"\n    },\n    "meter_number": {\n      "type": "string",\n      "description": "Human-readable meter number"\n    },\n    "obis_number": {\n      "type": "string",\n      "description": "OBIS code of the counter"\n    },\n    "unit": {\n      "type": "string",\n      "description": "Unit of measurement (e.g., kWh, m3)"\n    },\n    "customer_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the customer"\n    },\n    "contract_id": {\n      "type": "string",\n      "format": "uuid",\n      "description": "Entity ID of the contract"\n    },\n    "user_id": {\n      "type": "string",\n      "description": "ID of the user who submitted the reading"\n    },\n    "user_email": {\n      "type": "string",\n      "format": "email",\n      "description": "Email of the user who submitted the reading"\n    }\n  },\n  "required": ["_org_id", "_event_time", "_event_id", "_event_name", "_event_version", "_event_source", "reading_value", "reading_date", "read_by", "reason", "direction", "source", "meter_id", "counter_id", "meter_number", "obis_number", "unit", "customer_id", "contract_id"]\n}\n```\n\n</details>\n\n---\n\n### `getEventExample`\n\nGenerate a sample event payload based on the event\'s JSON Schema\n\n`GET /v1/events/{event_name}/example`\n\n```ts\nconst { data } = await client.getEventExample({\n  event_name: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{}\n```\n\n</details>\n\n---\n\n### `searchEventHistory`\n\nPaginated history of events\n\n`POST /v1/events/{event_name}:history`\n\n```ts\nconst { data } = await client.searchEventHistory(\n  {\n    event_name: \'example\',\n  },\n  {\n    limit: 10,\n    cursor: {\n      event_time: \'2025-10-31 12:34:56\',\n      event_id: \'evt_1234567890abcdef\'\n    },\n    timestamp: {\n      from: \'2025-10-01T00:00:00Z\',\n      to: \'2025-10-31T23:59:59Z\'\n    },\n    event_id: \'evt_1234567890abcdef\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "_org_id": "org_123456",\n      "_event_time": "2024-01-01T12:00:00Z",\n      "_event_id": "01FZ4Z5FZ5FZ5FZ5FZ5FZ5FZ5F",\n      "_event_name": "MeterReading",\n      "_event_version": "1.0.0",\n      "_event_source": "api",\n      "_trigger_source_type": "api",\n      "_trigger_source": "user_123456",\n      "reading_value": 123.45,\n      "reading_date": "2024-01-01T11:59:00Z",\n      "read_by": "John Doe",\n      "reason": "regular",\n      "direction": "feed-out",\n      "source": "portal",\n      "meter_id": "550e8400-e29b-41d4-a716-446655440000",\n      "counter_id": "660e8400-e29b-41d4-a716-446655440000",\n      "meter_number": "MT123456789",\n      "obis_number": "1-0:1.8.0",\n      "unit": "kWh",\n      "customer_id": "770e8400-e29b-41d4-a716-446655440000",\n      "contract_id": "880e8400-e29b-41d4-a716-446655440000"\n    }\n  ],\n  "next_cursor": {\n    "event_time": "2025-10-31T12:34:56Z",\n    "event_id": "evt_1234567890abcdef"\n  }\n}\n```\n\n</details>\n\n---\n\n### `searchEventHistoryV2`\n\nPaginated history of events with projected/lightweight payload (v2).\n\n`POST /v2/events/{event_name}:history`\n\n```ts\nconst { data } = await client.searchEventHistoryV2(\n  {\n    event_name: \'example\',\n  },\n  {\n    limit: 10,\n    cursor: {\n      event_time: \'2025-10-31 12:34:56\',\n      event_id: \'evt_1234567890abcdef\'\n    },\n    timestamp: {\n      from: \'2025-10-01T00:00:00Z\',\n      to: \'2025-10-31T23:59:59Z\'\n    },\n    event_id: \'evt_1234567890abcdef\',\n    fields: [\'_id\', \'_title\', \'first_name\', \'account\', \'!account.*._files\', \'**._product\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "_org_id": "string",\n      "_event_time": "1970-01-01T00:00:00.000Z",\n      "_event_id": "string",\n      "_event_name": "string",\n      "_event_version": "1.0.0",\n      "_event_source": "string",\n      "_trigger_source_type": "api",\n      "_trigger_source": "string",\n      "_ack_id": "string"\n    }\n  ],\n  "next_cursor": {\n    "event_time": "2025-10-31T12:34:56Z",\n    "event_id": "evt_1234567890abcdef"\n  }\n}\n```\n\n</details>\n\n---\n\n### `getHistoricalEvent`\n\nFetch a single historical event by id with full hydration\n\n`GET /v2/events/{event_name}/history/{event_id}`\n\n```ts\nconst { data } = await client.getHistoricalEvent({\n  event_name: \'example\',\n  event_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "_org_id": "org_123456",\n  "_event_time": "2024-01-01T12:00:00Z",\n  "_event_id": "01FZ4Z5FZ5FZ5FZ5FZ5FZ5FZ5F",\n  "_event_name": "MeterReading",\n  "_event_version": "1.0.0",\n  "_event_source": "api",\n  "_trigger_source_type": "api",\n  "_trigger_source": "user_123456",\n  "reading_value": 123.45,\n  "reading_date": "2024-01-01T11:59:00Z",\n  "read_by": "John Doe",\n  "reason": "regular",\n  "direction": "feed-out",\n  "source": "portal",\n  "meter_id": "550e8400-e29b-41d4-a716-446655440000",\n  "counter_id": "660e8400-e29b-41d4-a716-446655440000",\n  "meter_number": "MT123456789",\n  "obis_number": "1-0:1.8.0",\n  "unit": "kWh",\n  "customer_id": "770e8400-e29b-41d4-a716-446655440000",\n  "contract_id": "880e8400-e29b-41d4-a716-446655440000"\n}\n```\n\n</details>\n\n---\n\n### `triggerEvent`\n\nExplicitly trigger an event by providing input field values and an optional entity seed\nfor graph hydration. The event must be enabled for the organization.\n\n`POST /v1/events/{event_name}:trigger`\n\n```ts\nconst { data } = await client.triggerEvent(\n  {\n    event_name: \'example\',\n  },\n  {\n    seed: {\n      entity_id: \'3fa85f64-5717-4562-b3fc-2c963f66afa6\',\n      node_id: \'string\'\n    },\n    fields: {},\n    skip_hydration: [\'string\'],\n    _trigger_source_type: \'string\',\n    _trigger_source: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "success": true,\n  "event_id": "string",\n  "event_bridge_event_id": "string"\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `EventConfigBase`\n\nBase properties shared between EventConfig and UpdateEventPayload\n\n```ts\ntype EventConfigBase = {\n  event_name?: string\n  event_title?: string\n  event_description?: string\n  event_version?: string\n  event_status?: "active" | "deprecated" | "draft" | "disabled"\n  event_tags?: string[]\n  schema_fields?: Record<string, {\n    json_schema: object\n    required?: boolean\n    graph_source?: string\n  } | {\n    entity_schema: string\n    required?: boolean\n  } | {\n    items: {\n      entity_id: { ... }\n      filename?: { ... }\n      mime_type?: { ... }\n      size_bytes?: { ... }\n      s3ref?: { ... }\n      version_index: { ... }\n      readable_size?: { ... }\n    }\n    required?: boolean\n  }>\n  entity_graph?: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n  entity_operation?: {\n    operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n    schema: string[]\n    attribute?: string[]\n    purpose?: string[]\n  }\n  enabled?: boolean\n  auto_trigger?: boolean\n  automation_trigger?: boolean\n}\n```\n\n### `EventConfig`\n\nEvent configuration with required fields\n\n```ts\ntype EventConfig = {\n  event_name: string\n  event_title?: string\n  event_description?: string\n  event_version: string\n  event_status?: "active" | "deprecated" | "draft" | "disabled"\n  event_tags?: string[]\n  schema_fields: Record<string, {\n    json_schema: object\n    required?: boolean\n    graph_source?: string\n  } | {\n    entity_schema: string\n    required?: boolean\n  } | {\n    items: {\n      entity_id: { ... }\n      filename?: { ... }\n      mime_type?: { ... }\n      size_bytes?: { ... }\n      s3ref?: { ... }\n      version_index: { ... }\n      readable_size?: { ... }\n    }\n    required?: boolean\n  }>\n  entity_graph?: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n  entity_operation?: {\n    operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n    schema: string[]\n    attribute?: string[]\n    purpose?: string[]\n  }\n  enabled?: boolean\n  auto_trigger?: boolean\n  automation_trigger?: boolean\n}\n```\n\n### `UpdateEventPayload`\n\nPayload for updating an event configuration.\nAccepts the same fields as EventConfig (all optional for PATCH).\nCurrently `enabled` and `auto_trigger` fields are processed.\n\n\n```ts\ntype UpdateEventPayload = {\n  event_name?: string\n  event_title?: string\n  event_description?: string\n  event_version?: string\n  event_status?: "active" | "deprecated" | "draft" | "disabled"\n  event_tags?: string[]\n  schema_fields?: Record<string, {\n    json_schema: object\n    required?: boolean\n    graph_source?: string\n  } | {\n    entity_schema: string\n    required?: boolean\n  } | {\n    items: {\n      entity_id: { ... }\n      filename?: { ... }\n      mime_type?: { ... }\n      size_bytes?: { ... }\n      s3ref?: { ... }\n      version_index: { ... }\n      readable_size?: { ... }\n    }\n    required?: boolean\n  }>\n  entity_graph?: {\n    nodes: Array<{\n      id: { ... }\n      schema: { ... }\n      cardinality?: { ... }\n      fields?: { ... }\n    }>\n    edges: Array<{\n      from: { ... }\n      to: { ... }\n    }>\n  }\n  entity_operation?: {\n    operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n    schema: string[]\n    attribute?: string[]\n    purpose?: string[]\n  }\n  enabled?: boolean\n  auto_trigger?: boolean\n  automation_trigger?: boolean\n}\n```\n\n### `PrimitiveField`\n\nA primitive JSON Schema field definition\n\n```ts\ntype PrimitiveField = {\n  json_schema: object\n  required?: boolean\n  graph_source?: string\n}\n```\n\n### `ContextEntity`\n\n```ts\ntype ContextEntity = {\n  entity_schema: string\n  required?: boolean\n}\n```\n\n### `AttachmentField`\n\nA schema field representing file attachments associated with the event.\nPresent in schema_fields for events tagged with "attachment".\n\n\n```ts\ntype AttachmentField = {\n  items: {\n    entity_id: string // uuid\n    filename?: string\n    mime_type?: string\n    size_bytes?: number\n    s3ref?: {\n      bucket: { ... }\n      key: { ... }\n    }\n    version_index: number\n    readable_size?: string\n  }\n  required?: boolean\n}\n```\n\n### `SchemaField`\n\n```ts\ntype SchemaField = {\n  json_schema: object\n  required?: boolean\n  graph_source?: string\n} | {\n  entity_schema: string\n  required?: boolean\n} | {\n  items: {\n    entity_id: string // uuid\n    filename?: string\n    mime_type?: string\n    size_bytes?: number\n    s3ref?: {\n      bucket: { ... }\n      key: { ... }\n    }\n    version_index: number\n    readable_size?: string\n  }\n  required?: boolean\n}\n```\n\n### `CommonEventMetadata`\n\nCommon metadata fields present in all event payloads\n\n```ts\ntype CommonEventMetadata = object\n```\n\n### `EventJsonSchema`\n\nJSON Schema declaring the event payload structure\n\n```ts\ntype EventJsonSchema = object\n```\n\n### `Event`\n\nAn event instance in the event history\n\n```ts\ntype Event = {\n  _org_id: string\n  _event_time: string // date-time\n  _event_id: string\n  _event_name: string\n  _event_version: string\n  _event_source: string\n  _trigger_source_type?: string\n  _trigger_source?: string\n  _ack_id?: string\n}\n```\n\n### `EventSummary`\n\nA lightweight event summary returned by the v2 history endpoint.\n\nIncludes the standard `_*` metadata fields plus a projected subset of the\nevent payload. Hydrated entity objects (values carrying `_schema` or `_id`\nand arrays of such objects) are stripped \u2014 fetch via\n`GET /v2/events/{event_name}/his\n\n```ts\ntype EventSummary = {\n  _org_id: string\n  _event_time: string // date-time\n  _event_id: string\n  _event_name: string\n  _event_version: string\n  _event_source: string\n  _trigger_source_type?: string\n  _trigger_source?: string\n  _ack_id?: string\n}\n```\n\n### `GraphDefinition`\n\nEntity graph definition for resolving related entities\n\n```ts\ntype GraphDefinition = {\n  nodes: Array<{\n    id: string\n    schema: string\n    cardinality?: "one" | "many"\n    fields?: object\n  }>\n  edges: Array<{\n    from: string\n    to: string\n  }>\n}\n```\n\n### `GraphNode`\n\nA node in the entity graph\n\n```ts\ntype GraphNode = {\n  id: string\n  schema: string\n  cardinality?: "one" | "many"\n  fields?: object\n}\n```\n\n### `GraphEdge`\n\nAn edge connecting two nodes in the graph\n\n```ts\ntype GraphEdge = {\n  from: string\n  to: string\n}\n```\n\n### `EntityOperationTrigger`\n\nConfiguration for triggering an event based on entity operations.\n\nWhen an entity operation matches the configured criteria, the event will be triggered.\n- On createEntity: the attribute must be present in the entity payload\n- On updateEntity: the attribute must be in diff.added, diff.updated, or di\n\n```ts\ntype EntityOperationTrigger = {\n  operation: "createEntity" | "updateEntity" | "deleteEntity"[]\n  schema: string[]\n  attribute?: string[]\n  purpose?: string[]\n}\n```\n\n### `SearchOptions`\n\n```ts\ntype SearchOptions = {\n  limit?: number\n  cursor?: {\n    event_time?: string\n    event_id?: string\n  }\n  timestamp?: {\n    from?: string // date-time\n    to?: string // date-time\n  }\n  event_id?: string\n}\n```\n\n### `SearchOptionsV2`\n\nSearch options for the v2 history endpoint.\n\nExtends `SearchOptions` with an optional `fields` projection. When `fields`\nis omitted, the response includes all `_*` metadata plus all scalar payload\nfields (and primitive arrays / empty objects/arrays) after entity stripping.\nWhen `fields` is provided,\n\n```ts\ntype SearchOptionsV2 = {\n  limit?: number\n  cursor?: {\n    event_time?: string\n    event_id?: string\n  }\n  timestamp?: {\n    from?: string // date-time\n    to?: string // date-time\n  }\n  event_id?: string\n  fields?: string[]\n}\n```\n\n### `FieldsParam`\n\nList of entity fields to include or exclude in the response\n\nUse ! to exclude fields, e.g. `!_id` to exclude the `_id` field.\n\nGlobbing and globstart (**) is supported for nested fields.\n\n\n```ts\ntype FieldsParam = string[]\n```\n\n### `TriggerEventPayload`\n\nPayload for explicitly triggering an event via API\n\n```ts\ntype TriggerEventPayload = {\n  seed?: {\n    entity_id: string // uuid\n    node_id: string\n  }\n  fields?: Record<string, unknown>\n  skip_hydration?: string[]\n  _trigger_source_type?: string\n  _trigger_source?: string\n}\n```\n\n### `TriggerEventResponse`\n\nResponse from triggering an event\n\n```ts\ntype TriggerEventResponse = {\n  success: boolean\n  event_id: string\n  event_bridge_event_id?: string\n}\n```\n\n### `EventAttachment`\n\nA file attachment associated with an event\n\n```ts\ntype EventAttachment = {\n  entity_id: string // uuid\n  filename?: string\n  mime_type?: string\n  size_bytes?: number\n  s3ref?: {\n    bucket: string\n    key: string\n  }\n  version_index: number\n  readable_size?: string\n}\n```\n';
+
+
+exports.default = event_catalog_default;

package/dist/{event-catalog-runtime-5HQSAJVX.cjs → event-catalog-runtime-B2BPKQVG.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkBLNXQAMXcjs = require('./chunk-BLNXQAMX.cjs');
+var _chunkCBDKPGO5cjs = require('./chunk-CBDKPGO5.cjs');
 require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunkBLNXQAMXcjs.require_event_catalog_runtime.call(void 0, );
+exports. default = _chunkCBDKPGO5cjs.require_event_catalog_runtime.call(void 0, );

package/dist/{event-catalog-runtime-6FA3SCRI.js → event-catalog-runtime-N262TQ3Y.js}

@@ -1,5 +1,5 @@
 import {
   require_event_catalog_runtime
-} from "./chunk-TME4YJNP.js";
+} from "./chunk-OCMIXJWC.js";
 import "./chunk-YPSWSI3M.js";
 export default require_event_catalog_runtime();

package/dist/{event-catalog.d-ENw6HO-w.d.cts → event-catalog.d-mQJLSYUo.d.cts}

@@ -1,12 +1,22 @@
 import { OpenAPIClient, Parameters, UnknownParamsObject, AxiosRequestConfig, OperationResponse } from 'openapi-client-axios';
 
 /* Auto-copied from event-catalog-client */
-/* eslint-disable */
-
 
 
 declare namespace Components {
     namespace Schemas {
+        /**
+         * A schema field representing file attachments associated with the event.
+         * Present in schema_fields for events tagged with "attachment".
+         *
+         */
+        export interface AttachmentField {
+            items: /* A file attachment associated with an event */ EventAttachment;
+            /**
+             * Whether this field is required in the event payload
+             */
+            required?: boolean;
+        }
         /**
          * Common metadata fields present in all event payloads
          * example:
@@ -193,6 +203,48 @@ declare namespace Components {
              */
             _ack_id?: string;
         }
+        /**
+         * A file attachment associated with an event
+         */
+        export interface EventAttachment {
+            /**
+             * Entity ID of the file
+             */
+            entity_id: string; // uuid
+            /**
+             * Name of the file
+             */
+            filename?: string;
+            /**
+             * MIME type of the file (e.g., application/pdf)
+             */
+            mime_type?: string;
+            /**
+             * File size in bytes
+             */
+            size_bytes?: number;
+            /**
+             * S3 reference for the file content
+             */
+            s3ref?: {
+                /**
+                 * S3 bucket name
+                 */
+                bucket: string;
+                /**
+                 * S3 object key
+                 */
+                key: string;
+            };
+            /**
+             * File version index (always 0 for newly created files)
+             */
+            version_index: number;
+            /**
+             * Human-readable file size (e.g., "200 KB")
+             */
+            readable_size?: string;
+        }
         /**
          * Event configuration with required fields
          */
@@ -634,6 +686,64 @@ declare namespace Components {
          */
         export interface EventJsonSchema {
         }
+        /**
+         * A lightweight event summary returned by the v2 history endpoint.
+         *
+         * Includes the standard `_*` metadata fields plus a projected subset of the
+         * event payload. Hydrated entity objects (values carrying `_schema` or `_id`
+         * and arrays of such objects) are stripped — fetch via
+         * `GET /v2/events/{event_name}/history/{event_id}` for full hydration.
+         *
+         * Projected scalar payload fields appear as additional top-level properties.
+         *
+         */
+        export interface EventSummary {
+            [name: string]: any;
+            /**
+             * epilot tenant/organization ID
+             */
+            _org_id: string;
+            /**
+             * ISO 8601 timestamp when event occurred
+             */
+            _event_time: string; // date-time
+            /**
+             * Unique event identifier (ULID)
+             */
+            _event_id: string;
+            /**
+             * Event name from catalog
+             */
+            _event_name: string;
+            /**
+             * Event version (semver)
+             * example:
+             * 1.0.0
+             */
+            _event_version: string;
+            /**
+             * Source that triggered the event
+             */
+            _event_source: string;
+            /**
+             * The type of system that triggered the event.
+             * Common values: api, automation, operation, portal_user
+             *
+             * example:
+             * api
+             */
+            _trigger_source_type?: string;
+            /**
+             * Identifier of the specific trigger source.
+             *
+             */
+            _trigger_source?: string;
+            /**
+             * Unique acknowledgment tracking ID for the event.
+             *
+             */
+            _ack_id?: string;
+        }
         /**
          * List of entity fields to include or exclude in the response
          *
@@ -762,7 +872,12 @@ declare namespace Components {
              */
             graph_source?: string;
         }
-        export type SchemaField = /* A primitive JSON Schema field definition */ PrimitiveField | ContextEntity;
+        export type SchemaField = /* A primitive JSON Schema field definition */ PrimitiveField | ContextEntity | /**
+         * A schema field representing file attachments associated with the event.
+         * Present in schema_fields for events tagged with "attachment".
+         *
+         */
+        AttachmentField;
         export interface SearchOptions {
             /**
              * Maximum number of results to return
@@ -809,6 +924,81 @@ declare namespace Components {
              */
             event_id?: string;
         }
+        /**
+         * Search options for the v2 history endpoint.
+         *
+         * Extends `SearchOptions` with an optional `fields` projection. When `fields`
+         * is omitted, the response includes all `_*` metadata plus all scalar payload
+         * fields (and primitive arrays / empty objects/arrays) after entity stripping.
+         * When `fields` is provided, glob/exclusion semantics from `FieldsParam` apply
+         * against `payload.*` paths; `_*` metadata is always included. Entity stripping
+         * runs AFTER selection.
+         *
+         */
+        export interface SearchOptionsV2 {
+            /**
+             * Maximum number of results to return
+             */
+            limit?: number;
+            /**
+             * Cursor for pagination. Use the next_cursor from the previous response to get the next page.
+             */
+            cursor?: {
+                /**
+                 * Timestamp from the last event in the previous page
+                 * example:
+                 * 2025-10-31 12:34:56
+                 */
+                event_time?: string;
+                /**
+                 * Event ID from the last event in the previous page
+                 * example:
+                 * evt_1234567890abcdef
+                 */
+                event_id?: string;
+            };
+            /**
+             * Filter events by timestamp range
+             */
+            timestamp?: {
+                /**
+                 * Start timestamp in ISO 8601 format
+                 * example:
+                 * 2025-10-01T00:00:00Z
+                 */
+                from?: string; // date-time
+                /**
+                 * End timestamp in ISO 8601 format
+                 * example:
+                 * 2025-10-31T23:59:59Z
+                 */
+                to?: string; // date-time
+            };
+            /**
+             * Filter by specific event ID
+             * example:
+             * evt_1234567890abcdef
+             */
+            event_id?: string;
+            fields?: /**
+             * List of entity fields to include or exclude in the response
+             *
+             * Use ! to exclude fields, e.g. `!_id` to exclude the `_id` field.
+             *
+             * Globbing and globstart (**) is supported for nested fields.
+             *
+             * example:
+             * [
+             *   "_id",
+             *   "_title",
+             *   "first_name",
+             *   "account",
+             *   "!account.*._files",
+             *   "**._product"
+             * ]
+             */
+            FieldsParam;
+        }
         /**
          * Payload for explicitly triggering an event via API
          */
@@ -880,7 +1070,7 @@ declare namespace Components {
         /**
          * Payload for updating an event configuration.
          * Accepts the same fields as EventConfig (all optional for PATCH).
-         * Currently only `enabled` and `auto_trigger` fields are processed, other fields are ignored.
+         * Currently `enabled` and `auto_trigger` fields are processed.
          *
          */
         export interface UpdateEventPayload {
@@ -1209,6 +1399,48 @@ declare namespace Paths {
             Components.Schemas.EventJsonSchema;
         }
     }
+    namespace GetHistoricalEvent {
+        namespace Parameters {
+            export type EventId = string;
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+            event_id: Parameters.EventId;
+        }
+        namespace Responses {
+            export type $200 = /**
+             * An event instance in the event history
+             * example:
+             * {
+             *   "_org_id": "org_123456",
+             *   "_event_time": "2024-01-01T12:00:00Z",
+             *   "_event_id": "01FZ4Z5FZ5FZ5FZ5FZ5FZ5FZ5F",
+             *   "_event_name": "MeterReading",
+             *   "_event_version": "1.0.0",
+             *   "_event_source": "api",
+             *   "_trigger_source_type": "api",
+             *   "_trigger_source": "user_123456",
+             *   "reading_value": 123.45,
+             *   "reading_date": "2024-01-01T11:59:00Z",
+             *   "read_by": "John Doe",
+             *   "reason": "regular",
+             *   "direction": "feed-out",
+             *   "source": "portal",
+             *   "meter_id": "550e8400-e29b-41d4-a716-446655440000",
+             *   "counter_id": "660e8400-e29b-41d4-a716-446655440000",
+             *   "meter_number": "MT123456789",
+             *   "obis_number": "1-0:1.8.0",
+             *   "unit": "kWh",
+             *   "customer_id": "770e8400-e29b-41d4-a716-446655440000",
+             *   "contract_id": "880e8400-e29b-41d4-a716-446655440000"
+             * }
+             */
+            Components.Schemas.Event;
+            export interface $404 {
+            }
+        }
+    }
     namespace ListEvents {
         namespace Responses {
             export interface $200 {
@@ -1226,7 +1458,7 @@ declare namespace Paths {
         export type RequestBody = /**
          * Payload for updating an event configuration.
          * Accepts the same fields as EventConfig (all optional for PATCH).
-         * Currently only `enabled` and `auto_trigger` fields are processed, other fields are ignored.
+         * Currently `enabled` and `auto_trigger` fields are processed.
          *
          */
         Components.Schemas.UpdateEventPayload;
@@ -1294,6 +1526,59 @@ declare namespace Paths {
             }
         }
     }
+    namespace SearchEventHistoryV2 {
+        namespace Parameters {
+            export type EventName = string;
+        }
+        export interface PathParameters {
+            event_name: Parameters.EventName;
+        }
+        export type RequestBody = /**
+         * Search options for the v2 history endpoint.
+         *
+         * Extends `SearchOptions` with an optional `fields` projection. When `fields`
+         * is omitted, the response includes all `_*` metadata plus all scalar payload
+         * fields (and primitive arrays / empty objects/arrays) after entity stripping.
+         * When `fields` is provided, glob/exclusion semantics from `FieldsParam` apply
+         * against `payload.*` paths; `_*` metadata is always included. Entity stripping
+         * runs AFTER selection.
+         *
+         */
+        Components.Schemas.SearchOptionsV2;
+        namespace Responses {
+            export interface $200 {
+                results?: /**
+                 * A lightweight event summary returned by the v2 history endpoint.
+                 *
+                 * Includes the standard `_*` metadata fields plus a projected subset of the
+                 * event payload. Hydrated entity objects (values carrying `_schema` or `_id`
+                 * and arrays of such objects) are stripped — fetch via
+                 * `GET /v2/events/{event_name}/history/{event_id}` for full hydration.
+                 *
+                 * Projected scalar payload fields appear as additional top-level properties.
+                 *
+                 */
+                Components.Schemas.EventSummary[];
+                /**
+                 * Cursor for pagination. Use this to get the next page of results.
+                 */
+                next_cursor?: {
+                    /**
+                     * Timestamp from the last event in the current page
+                     * example:
+                     * 2025-10-31T12:34:56Z
+                     */
+                    event_time?: string;
+                    /**
+                     * Event ID from the last event in the current page
+                     * example:
+                     * evt_1234567890abcdef
+                     */
+                    event_id?: string;
+                } | null;
+            }
+        }
+    }
     namespace TriggerEvent {
         namespace Parameters {
             export type EventName = string;
@@ -1376,6 +1661,32 @@ interface OperationMethods {
     data?: Paths.SearchEventHistory.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.SearchEventHistory.Responses.$200>
+  /**
+   * searchEventHistoryV2 - searchEventHistoryV2
+   * 
+   * Paginated history of events with projected/lightweight payload (v2).
+   * 
+   * Returns `EventSummary` objects instead of fully hydrated `Event` objects:
+   * nested entity graphs (objects/arrays-of-objects carrying `_schema`/`_id`)
+   * are stripped. Use GET /v2/events/{event_name}/history/{event_id} to fetch
+   * the full hydrated event for a single result.
+   * 
+   */
+  'searchEventHistoryV2'(
+    parameters?: Parameters<Paths.SearchEventHistoryV2.PathParameters> | null,
+    data?: Paths.SearchEventHistoryV2.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.SearchEventHistoryV2.Responses.$200>
+  /**
+   * getHistoricalEvent - getHistoricalEvent
+   * 
+   * Fetch a single historical event by id with full hydration
+   */
+  'getHistoricalEvent'(
+    parameters?: Parameters<Paths.GetHistoricalEvent.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetHistoricalEvent.Responses.$200>
   /**
    * triggerEvent - triggerEvent
    * 
@@ -1466,6 +1777,36 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.SearchEventHistory.Responses.$200>
   }
+  ['/v2/events/{event_name}:history']: {
+    /**
+     * searchEventHistoryV2 - searchEventHistoryV2
+     * 
+     * Paginated history of events with projected/lightweight payload (v2).
+     * 
+     * Returns `EventSummary` objects instead of fully hydrated `Event` objects:
+     * nested entity graphs (objects/arrays-of-objects carrying `_schema`/`_id`)
+     * are stripped. Use GET /v2/events/{event_name}/history/{event_id} to fetch
+     * the full hydrated event for a single result.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.SearchEventHistoryV2.PathParameters> | null,
+      data?: Paths.SearchEventHistoryV2.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.SearchEventHistoryV2.Responses.$200>
+  }
+  ['/v2/events/{event_name}/history/{event_id}']: {
+    /**
+     * getHistoricalEvent - getHistoricalEvent
+     * 
+     * Fetch a single historical event by id with full hydration
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetHistoricalEvent.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetHistoricalEvent.Responses.$200>
+  }
   ['/v1/events/{event_name}:trigger']: {
     /**
      * triggerEvent - triggerEvent
@@ -1490,13 +1831,16 @@ interface PathsDictionary {
 type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
+type AttachmentField = Components.Schemas.AttachmentField;
 type CommonEventMetadata = Components.Schemas.CommonEventMetadata;
 type ContextEntity = Components.Schemas.ContextEntity;
 type EntityOperationTrigger = Components.Schemas.EntityOperationTrigger;
 type Event = Components.Schemas.Event;
+type EventAttachment = Components.Schemas.EventAttachment;
 type EventConfig = Components.Schemas.EventConfig;
 type EventConfigBase = Components.Schemas.EventConfigBase;
 type EventJsonSchema = Components.Schemas.EventJsonSchema;
+type EventSummary = Components.Schemas.EventSummary;
 type FieldsParam = Components.Schemas.FieldsParam;
 type GraphDefinition = Components.Schemas.GraphDefinition;
 type GraphEdge = Components.Schemas.GraphEdge;
@@ -1504,8 +1848,9 @@ type GraphNode = Components.Schemas.GraphNode;
 type PrimitiveField = Components.Schemas.PrimitiveField;
 type SchemaField = Components.Schemas.SchemaField;
 type SearchOptions = Components.Schemas.SearchOptions;
+type SearchOptionsV2 = Components.Schemas.SearchOptionsV2;
 type TriggerEventPayload = Components.Schemas.TriggerEventPayload;
 type TriggerEventResponse = Components.Schemas.TriggerEventResponse;
 type UpdateEventPayload = Components.Schemas.UpdateEventPayload;
 
-export { type Client as C, type EntityOperationTrigger as E, type FieldsParam as F, type GraphDefinition as G, type OperationMethods as O, Paths as P, type SchemaField as S, type TriggerEventPayload as T, type UpdateEventPayload as U, Components as a, type PathsDictionary as b, type CommonEventMetadata as c, type ContextEntity as d, type Event as e, type EventConfig as f, type EventConfigBase as g, type EventJsonSchema as h, type GraphEdge as i, type GraphNode as j, type PrimitiveField as k, type SearchOptions as l, type TriggerEventResponse as m };
+export { type AttachmentField as A, type Client as C, type EntityOperationTrigger as E, type FieldsParam as F, type GraphDefinition as G, type OperationMethods as O, Paths as P, type SchemaField as S, type TriggerEventPayload as T, type UpdateEventPayload as U, Components as a, type PathsDictionary as b, type CommonEventMetadata as c, type ContextEntity as d, type Event as e, type EventAttachment as f, type EventConfig as g, type EventConfigBase as h, type EventJsonSchema as i, type EventSummary as j, type GraphEdge as k, type GraphNode as l, type PrimitiveField as m, type SearchOptions as n, type SearchOptionsV2 as o, type TriggerEventResponse as p };