@epilot/sdk 2.8.0-rc.0 → 2.8.1

package/dist/webhooks-SK2STDKR.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/webhooks.json
-var webhooks_default = '# Webhooks\n\n- **Base URL:** `https://webhooks.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/webhooks](https://docs.epilot.io/api/webhooks)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.webhooks.getPublicKey(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/webhooks\'\n\nconst webhooksClient = getClient()\nauthorize(webhooksClient, () => \'<token>\')\nconst { data } = await webhooksClient.getPublicKey(...)\n```\n\n## Operations\n\n**webhooks**\n- [`getPublicKey`](#getpublickey)\n- [`getConfiguredEvents`](#getconfiguredevents)\n- [`getConfigs`](#getconfigs)\n- [`createConfig`](#createconfig)\n- [`getConfig`](#getconfig)\n- [`updateConfig`](#updateconfig)\n- [`deleteConfig`](#deleteconfig)\n- [`testOAuth`](#testoauth)\n- [`triggerWebhook`](#triggerwebhook)\n- [`batchReplayEvents`](#batchreplayevents)\n- [`getEventById`](#geteventbyid)\n- [`replayEvent`](#replayevent)\n- [`getWebhookExample`](#getwebhookexample)\n\n**Events**\n- [`getWebhookEventsV2`](#getwebhookeventsv2)\n\n**Schemas**\n- [`PublicKeyResponse`](#publickeyresponse)\n- [`SearchOptions`](#searchoptions)\n- [`EventListResponse`](#eventlistresponse)\n- [`HttpMethod`](#httpmethod)\n- [`AuthType`](#authtype)\n- [`Filter`](#filter)\n- [`WebhookCondition`](#webhookcondition)\n- [`WebhookConditionGroup`](#webhookconditiongroup)\n- [`Auth`](#auth)\n- [`BasicAuthConfig`](#basicauthconfig)\n- [`OAuthConfig`](#oauthconfig)\n- [`ApiKeyConfig`](#apikeyconfig)\n- [`WebhookConfig`](#webhookconfig)\n- [`EventConfigResp`](#eventconfigresp)\n- [`EventConfigEntry`](#eventconfigentry)\n- [`ErrorResp`](#errorresp)\n- [`TriggerWebhookResp`](#triggerwebhookresp)\n- [`PayloadConfiguration`](#payloadconfiguration)\n- [`CustomHeader`](#customheader)\n- [`CustomOAuthParameter`](#customoauthparameter)\n- [`Metadata`](#metadata)\n- [`ExecutionPayload`](#executionpayload)\n- [`WebhookEvent`](#webhookevent)\n- [`ExampleRequest`](#examplerequest)\n- [`ExampleResponse`](#exampleresponse)\n- [`TestOAuthResponse`](#testoauthresponse)\n- [`BatchReplayRequest`](#batchreplayrequest)\n\n### `getPublicKey`\n\nReturns the platform-level Ed25519 public key used to verify\nasymmetric (v1a) webhook signatures. This endpoint is unauthenticated since the public key is not a secret, but the orgId parameter is requ\n\n`GET /v1/webhooks/.well-known/public-key`\n\n```ts\nconst { data } = await client.getPublicKey({\n  orgId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "public_key": "-----BEGIN PUBLIC KEY-----\\nMCowBQYDK2VwAyEA...\\n-----END PUBLIC KEY-----\\n",\n  "algorithm": "ed25519",\n  "issuer": "epilot"\n}\n```\n\n</details>\n\n---\n\n### `getConfiguredEvents`\n\nRetrieve events that can trigger webhooks\n\n`GET /v1/webhooks/configured-events`\n\n```ts\nconst { data } = await client.getConfiguredEvents()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n[\n  {\n    "eventName": "customer_request_created",\n    "eventLabel": "Customer Request Created"\n  }\n]\n```\n\n</details>\n\n---\n\n### `getConfigs`\n\nSearch Webhook Client Configs\n\n`GET /v1/webhooks/configs`\n\n```ts\nconst { data } = await client.getConfigs({\n  eventName: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n[\n  {\n    "eventName": "CustomerRequest_Created",\n    "url": "https://my-partner-service.api.com",\n    "httpMethod": "POST",\n    "enabled": true,\n    "auth": {\n      "authType": "BASIC",\n      "basicAuthConfig": {\n        "username": "secretUsername",\n        "password": "secret7825@!"\n      }\n    },\n    "filter": {\n      "keyToFilter": "customer_request.productId",\n      "supportedValues": ["2324245", "5253642"]\n    }\n  }\n]\n```\n\n</details>\n\n---\n\n### `createConfig`\n\nCreate Webhook Client Config\n\n`POST /v1/webhooks/configs`\n\n```ts\nconst { data } = await client.createConfig(\n  null,\n  {\n    eventName: \'CustomerRequest_Created\',\n    url: \'https://my-partner-service.api.com\',\n    httpMethod: \'POST\',\n    enabled: true,\n    auth: {\n      authType: \'BASIC\',\n      basicAuthConfig: {\n        username: \'secretUsername\',\n        password: \'secret7825@!\'\n      }\n    },\n    filter: {\n      keyToFilter: \'customer_request.productId\',\n      supportedValues: [\'2324245\', \'5253642\']\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "eventName": "CustomerRequest_Created",\n  "url": "https://my-partner-service.api.com",\n  "httpMethod": "POST",\n  "enabled": true,\n  "auth": {\n    "authType": "BASIC",\n    "basicAuthConfig": {\n      "username": "secretUsername",\n      "password": "secret7825@!"\n    }\n  },\n  "filter": {\n    "keyToFilter": "customer_request.productId",\n    "supportedValues": ["2324245", "5253642"]\n  }\n}\n```\n\n</details>\n\n---\n\n### `getConfig`\n\nGet webhook config by id\n\n`GET /v1/webhooks/configs/{configId}`\n\n```ts\nconst { data } = await client.getConfig({\n  configId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "eventName": "CustomerRequest_Created",\n  "url": "https://my-partner-service.api.com",\n  "httpMethod": "POST",\n  "enabled": true,\n  "auth": {\n    "authType": "BASIC",\n    "basicAuthConfig": {\n      "username": "secretUsername",\n      "password": "secret7825@!"\n    }\n  },\n  "filter": {\n    "keyToFilter": "customer_request.productId",\n    "supportedValues": ["2324245", "5253642"]\n  }\n}\n```\n\n</details>\n\n---\n\n### `updateConfig`\n\nUpdate Webhook Client Config\n\n`PUT /v1/webhooks/configs/{configId}`\n\n```ts\nconst { data } = await client.updateConfig(\n  {\n    configId: \'example\',\n  },\n  {\n    eventName: \'CustomerRequest_Created\',\n    url: \'https://my-partner-service.api.com\',\n    httpMethod: \'POST\',\n    enabled: true,\n    auth: {\n      authType: \'BASIC\',\n      basicAuthConfig: {\n        username: \'secretUsername\',\n        password: \'secret7825@!\'\n      }\n    },\n    filter: {\n      keyToFilter: \'customer_request.productId\',\n      supportedValues: [\'2324245\', \'5253642\']\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "eventName": "CustomerRequest_Created",\n  "url": "https://my-partner-service.api.com",\n  "httpMethod": "POST",\n  "enabled": true,\n  "auth": {\n    "authType": "BASIC",\n    "basicAuthConfig": {\n      "username": "secretUsername",\n      "password": "secret7825@!"\n    }\n  },\n  "filter": {\n    "keyToFilter": "customer_request.productId",\n    "supportedValues": ["2324245", "5253642"]\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteConfig`\n\nDelete Webhook Client Config\n\n`DELETE /v1/webhooks/configs/{configId}`\n\n```ts\nconst { data } = await client.deleteConfig({\n  configId: \'example\',\n})\n```\n\n---\n\n### `testOAuth`\n\nTest OAuth connection\n\n`POST /v1/webhooks/configs/{configId}/test-oauth`\n\n```ts\nconst { data } = await client.testOAuth({\n  configId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "success": true,\n  "expires_in": 3600,\n  "token_type": "Bearer",\n  "message": "OAuth token exchange successful"\n}\n```\n\n</details>\n\n---\n\n### `triggerWebhook`\n\ntriggers a webhook event either async or sync\n\n`POST /v1/webhooks/configs/{configId}/trigger`\n\n```ts\nconst { data } = await client.triggerWebhook(\n  {\n    sync: true,\n    configId: \'example\',\n  },\n  {\n    metadata: {\n      action: \'Manual triggered by user with id 123456\',\n      origin: \'string\',\n      creation_timestamp: \'string\',\n      webhook_id: \'string\',\n      webhook_name: \'string\',\n      automation_name: \'string\',\n      organization_id: \'string\',\n      user_id: \'string\',\n      correlation_id: \'string\',\n      execution_id: \'string\',\n      action_id: \'string\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status_code": "string",\n  "message": "string",\n  "body": {},\n  "code": "string",\n  "status": "succeeded",\n  "start_date": "string",\n  "end_date": "string",\n  "event_id": "string"\n}\n```\n\n</details>\n\n---\n\n### `batchReplayEvents`\n\nReplay a batch of webhook events\n\n`POST /v1/webhooks/configs/{configId}/events/replay-batch`\n\n```ts\nconst { data } = await client.batchReplayEvents(\n  {\n    configId: \'example\',\n  },\n  {\n    eventIds: [\'2f1b7cf8-ff55-4359-966f-e56f39a52c94\', \'48c984bf-466b-470b-b743-d07cea168243\']\n  },\n)\n```\n\n---\n\n### `getEventById`\n\nGet a webhook event by its id\n\n`GET /v1/webhooks/configs/{configId}/events/{eventId}`\n\n```ts\nconst { data } = await client.getEventById({\n  configId: \'example\',\n  eventId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "event_id": "string",\n  "org_id": "string",\n  "webhook_config_id": "string",\n  "url": "string",\n  "created_at": "2021-04-27T12:01:13.000Z",\n  "event_name": "string",\n  "http_response": {\n    "status_code": 0,\n    "message": "string",\n    "body": {},\n    "code": "string"\n  },\n  "metadata": {\n    "action": "Manual triggered by user with id 123456",\n    "origin": "string",\n    "creation_timestamp": "string",\n    "webhook_id": "string",\n    "webhook_name": "string",\n    "automation_name": "string",\n    "organization_id": "string",\n    "user_id": "string",\n    "correlation_id": "string",\n    "execution_id": "string",\n    "action_id": "string"\n  },\n  "status": "succeeded",\n  "http_method": "GET",\n  "payload": "string"\n}\n```\n\n</details>\n\n---\n\n### `replayEvent`\n\nReplay a webhook event\n\n`POST /v1/webhooks/configs/{configId}/events/{eventId}/replay`\n\n```ts\nconst { data } = await client.replayEvent({\n  configId: \'example\',\n  eventId: \'example\',\n})\n```\n\n---\n\n### `getWebhookExample`\n\nGenerate an example payload for a webhook configuration based on trigger type\n\n`POST /v1/webhooks/configs/{configId}/example`\n\n```ts\nconst { data } = await client.getWebhookExample(\n  {\n    configId: \'example\',\n  },\n  {\n    automation_id: \'automation_123\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "metadata": {\n    "action": "Manual triggered by user with id 123456",\n    "origin": "string",\n    "creation_timestamp": "string",\n    "webhook_id": "string",\n    "webhook_name": "string",\n    "automation_name": "string",\n    "organization_id": "string",\n    "user_id": "string",\n    "correlation_id": "string",\n    "execution_id": "string",\n    "action_id": "string"\n  },\n  "entity": {},\n  "relations": [\n    {}\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getWebhookEventsV2`\n\nList webhook events and filter them by status, timestamp, etc.\n\n`POST /v2/webhooks/configs/{configId}/events`\n\n```ts\nconst { data } = await client.getWebhookEventsV2(\n  {\n    configId: \'example\',\n  },\n  {\n    limit: 25,\n    cursor: {\n      created_at: \'2025-10-31T12:34:56Z\',\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    status: \'succeeded\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "data": [\n    {\n      "event_id": "string",\n      "org_id": "string",\n      "webhook_config_id": "string",\n      "url": "string",\n      "created_at": "2021-04-27T12:01:13.000Z",\n      "event_name": "string",\n      "http_response": {\n        "status_code": 0,\n        "message": "string",\n        "body": {},\n        "code": "string"\n      },\n      "metadata": {\n        "action": "Manual triggered by user with id 123456",\n        "origin": "string",\n        "creation_timestamp": "string",\n        "webhook_id": "string",\n        "webhook_name": "string",\n        "automation_name": "string",\n        "organization_id": "string",\n        "user_id": "string",\n        "correlation_id": "string",\n        "execution_id": "string",\n        "action_id": "string"\n      },\n      "status": "succeeded",\n      "http_method": "GET",\n      "payload": "string"\n    }\n  ],\n  "next_cursor": {\n    "created_at": "2025-10-31T12:34:56Z",\n    "event_id": "evt_1234567890abcdef"\n  },\n  "has_more": true\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `PublicKeyResponse`\n\n```ts\ntype PublicKeyResponse = {\n  public_key: string\n  algorithm: string\n  issuer?: string\n}\n```\n\n### `SearchOptions`\n\n```ts\ntype SearchOptions = {\n  limit?: number\n  cursor?: {\n    created_at?: string // date-time\n    event_id?: string\n  }\n  timestamp?: {\n    from?: string // date-time\n    to?: string // date-time\n  }\n  event_id?: string\n  status?: "succeeded" | "failed" | "skipped"\n}\n```\n\n### `EventListResponse`\n\n```ts\ntype EventListResponse = {\n  data?: Array<{\n    event_id: string\n    org_id: string\n    webhook_config_id: string\n    url?: string\n    created_at?: string\n    event_name?: string\n    http_response?: {\n      status_code?: { ... }\n      message?: { ... }\n      body?: { ... }\n      code?: { ... }\n    }\n    metadata?: {\n      action?: { ... }\n      origin?: { ... }\n      creation_timestamp?: { ... }\n      webhook_id?: { ... }\n      webhook_name?: { ... }\n      automation_name?: { ... }\n      organization_id: { ... }\n      user_id?: { ... }\n      correlation_id?: { ... }\n      execution_id?: { ... }\n      action_id?: { ... }\n    }\n    status?: "succeeded" | "failed" | "in_progress" | "skipped"\n    http_method?: "GET" | "POST" | "PUT"\n    payload?: string\n  }>\n  next_cursor?: {\n    created_at?: string // date-time\n    event_id?: string\n  }\n  has_more?: boolean\n}\n```\n\n### `HttpMethod`\n\n```ts\ntype HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD"\n```\n\n### `AuthType`\n\n```ts\ntype AuthType = "BASIC" | "OAUTH_CLIENT_CREDENTIALS" | "API_KEY" | "NONE"\n```\n\n### `Filter`\n\n```ts\ntype Filter = {\n  keyToFilter: string\n  supportedValues: string[]\n}\n```\n\n### `WebhookCondition`\n\nA condition that must be met for the webhook to fire.\n\n```ts\ntype WebhookCondition = {\n  field: string\n  operation: "equals" | "not_equals" | "any_of" | "none_of" | "contains" | "not_contains" | "starts_with" | "ends_with" | "greater_than" | "less_than" | "greater_than_or_equals" | "less_than_or_equals" | "is_empty" | "is_not_empty"\n  values?: string[]\n  field_type?: "string" | "number" | "boolean" | "date" | "datetime"\n  is_array_field?: boolean\n  repeatable_item_op?: boolean\n}\n```\n\n### `WebhookConditionGroup`\n\nA group of conditions with a logical operator. Multiple conditions are AND-ed by default.\n\n```ts\ntype WebhookConditionGroup = {\n  conditions?: Array<{\n    field: string\n    operation: "equals" | "not_equals" | "any_of" | "none_of" | "contains" | "not_contains" | "starts_with" | "ends_with" | "greater_than" | "less_than" | "greater_than_or_equals" | "less_than_or_equals" | "is_empty" | "is_not_empty"\n    values?: string[]\n    field_type?: "string" | "number" | "boolean" | "date" | "datetime"\n    is_array_field?: boolean\n    repeatable_item_op?: boolean\n  }>\n  logical_operator?: "AND" | "OR"\n}\n```\n\n### `Auth`\n\n```ts\ntype Auth = {\n  authType: "BASIC" | "OAUTH_CLIENT_CREDENTIALS" | "API_KEY" | "NONE"\n  basicAuthConfig?: {\n    username: string\n    password?: string\n    passwordIsEnvVar?: boolean\n  }\n  oauthConfig?: {\n    clientId: string\n    clientSecret?: string\n    clientSecretIsEnvVar?: boolean\n    endpoint: string\n    httpMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD"\n    customParameterList?: Array<{\n      type: { ... }\n      key: { ... }\n      value: { ... }\n    }>\n  }\n  apiKeyConfig?: {\n    keyName: string\n    keyValue?: string\n    keyValueIsEnvVar?: boolean\n  }\n}\n```\n\n### `BasicAuthConfig`\n\nTo be sent only if authType is BASIC\n\n```ts\ntype BasicAuthConfig = {\n  username: string\n  password?: string\n  passwordIsEnvVar?: boolean\n}\n```\n\n### `OAuthConfig`\n\nTo be sent only if authType is OAUTH_CLIENT_CREDENTIALS\n\n```ts\ntype OAuthConfig = {\n  clientId: string\n  clientSecret?: string\n  clientSecretIsEnvVar?: boolean\n  endpoint: string\n  httpMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD"\n  customParameterList?: Array<{\n    type: "body" | "query" | "header"\n    key: string\n    value: string\n  }>\n}\n```\n\n### `ApiKeyConfig`\n\nTo be sent only if authType is API_KEY\n\n```ts\ntype ApiKeyConfig = {\n  keyName: string\n  keyValue?: string\n  keyValueIsEnvVar?: boolean\n}\n```\n\n### `WebhookConfig`\n\n```ts\ntype WebhookConfig = {\n  id?: string\n  name: string\n  eventName: string\n  url?: string\n  creationTime?: string\n  updatedTime?: string\n  httpMethod?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD"\n  enabled?: boolean\n  auth?: {\n    authType: "BASIC" | "OAUTH_CLIENT_CREDENTIALS" | "API_KEY" | "NONE"\n    basicAuthConfig?: {\n      username: { ... }\n      password?: { ... }\n      passwordIsEnvVar?: { ... }\n    }\n    oauthConfig?: {\n      clientId: { ... }\n      clientSecret?: { ... }\n      clientSecretIsEnvVar?: { ... }\n      endpoint: { ... }\n      httpMethod: { ... }\n      customParameterList?: { ... }\n    }\n    apiKeyConfig?: {\n      keyName: { ... }\n      keyValue?: { ... }\n      keyValueIsEnvVar?: { ... }\n    }\n  }\n  filter?: {\n    keyToFilter: string\n    supportedValues: string[]\n  }\n  payloadConfiguration?: {\n    hydrate_entity?: boolean\n    include_relations?: boolean\n    include_activity?: boolean\n    include_changed_attributes?: boolean\n    apply_changesets?: boolean\n    custom_headers?: Record<string, string>\n  }\n  enableStaticIP?: boolean\n  protected?: boolean\n  secureProxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n  status?: "active" | "inactive" | "incomplete"\n  jsonataExpression?: string\n  deliveryMode?: "json_base64" | "binary_multipart"\n  multipartConfig?: {\n    fileFieldName?: string\n    fileFieldStrategy?: "single" | "multi"\n    fileSource?: string\n    extraFields?: Record<string, string>\n  }\n  filterConditions?: {\n    conditions?: Array<{\n      field: { ... }\n      operation: { ... }\n      values?: { ... }\n      field_type?: { ... }\n      is_array_field?: { ... }\n      repeatable_item_op?: { ... }\n    }>\n    logical_operator?: "AND" | "OR"\n  }\n  _manifest?: string // uuid[]\n  signingSecret?: string\n}\n```\n\n### `EventConfigResp`\n\n```ts\ntype EventConfigResp = Array<{\n  eventName?: string\n  eventLabel?: string\n}>\n```\n\n### `EventConfigEntry`\n\n```ts\ntype EventConfigEntry = {\n  eventName?: string\n  eventLabel?: string\n}\n```\n\n### `ErrorResp`\n\n```ts\ntype ErrorResp = {\n  message?: string\n}\n```\n\n### `TriggerWebhookResp`\n\n```ts\ntype TriggerWebhookResp = {\n  status_code?: string\n  message?: string\n  body?: object\n  code?: string\n  status?: "succeeded" | "failed"\n  start_date?: string\n  end_date?: string\n  event_id: string\n}\n```\n\n### `PayloadConfiguration`\n\nConfiguration for the webhook payload\n\n```ts\ntype PayloadConfiguration = {\n  hydrate_entity?: boolean\n  include_relations?: boolean\n  include_activity?: boolean\n  include_changed_attributes?: boolean\n  apply_changesets?: boolean\n  custom_headers?: Record<string, string>\n}\n```\n\n### `CustomHeader`\n\nObject representing custom headers as key-value pairs.\n\n```ts\ntype CustomHeader = Record<string, string>\n```\n\n### `CustomOAuthParameter`\n\nCustom key/value pair of either type body, query or header\n\n```ts\ntype CustomOAuthParameter = {\n  type: "body" | "query" | "header"\n  key: string\n  value: string\n}\n```\n\n### `Metadata`\n\nContains the metadata about the configured event\n\n```ts\ntype Metadata = {\n  action?: string\n  origin?: string\n  creation_timestamp?: string\n  webhook_id?: string\n  webhook_name?: string\n  automation_name?: string\n  organization_id: string\n  user_id?: string\n  correlation_id?: string\n  execution_id?: string\n  action_id?: string\n}\n```\n\n### `ExecutionPayload`\n\nPayload for triggering a webhook\n\n```ts\ntype ExecutionPayload = {\n  metadata: {\n    action?: string\n    origin?: string\n    creation_timestamp?: string\n    webhook_id?: string\n    webhook_name?: string\n    automation_name?: string\n    organization_id: string\n    user_id?: string\n    correlation_id?: string\n    execution_id?: string\n    action_id?: string\n  }\n}\n```\n\n### `WebhookEvent`\n\n```ts\ntype WebhookEvent = {\n  event_id: string\n  org_id: string\n  webhook_config_id: string\n  url?: string\n  created_at?: string\n  event_name?: string\n  http_response?: {\n    status_code?: number\n    message?: string\n    body?: object\n    code?: string\n  }\n  metadata?: {\n    action?: string\n    origin?: string\n    creation_timestamp?: string\n    webhook_id?: string\n    webhook_name?: string\n    automation_name?: string\n    organization_id: string\n    user_id?: string\n    correlation_id?: string\n    execution_id?: string\n    action_id?: string\n  }\n  status?: "succeeded" | "failed" | "in_progress" | "skipped"\n  http_method?: "GET" | "POST" | "PUT"\n  payload?: string\n}\n```\n\n### `ExampleRequest`\n\n```ts\ntype ExampleRequest = {\n  automation_id?: string\n}\n```\n\n### `ExampleResponse`\n\n```ts\ntype ExampleResponse = {\n  metadata?: {\n    action?: string\n    origin?: string\n    creation_timestamp?: string\n    webhook_id?: string\n    webhook_name?: string\n    automation_name?: string\n    organization_id: string\n    user_id?: string\n    correlation_id?: string\n    execution_id?: string\n    action_id?: string\n  }\n  entity?: Record<string, unknown>\n  relations?: Record<string, unknown>[]\n}\n```\n\n### `TestOAuthResponse`\n\n```ts\ntype TestOAuthResponse = {\n  success: boolean\n  expires_in?: number\n  token_type?: string\n  message: string\n}\n```\n\n### `BatchReplayRequest`\n\n```ts\ntype BatchReplayRequest = {\n  eventIds: string[]\n}\n```\n';
-
-
-exports.default = webhooks_default;

package/docs/focus-pocus.md

@@ -1,460 +0,0 @@
-# Focus Pocus API
-
-- **Base URL:** `https://focus-pocus.dev.sls.epilot.io`
-- **Full API Docs:** [https://docs.epilot.io/api/focus-pocus](https://docs.epilot.io/api/focus-pocus)
-
-## Usage
-
-```ts
-import { epilot } from '@epilot/sdk'
-
-epilot.authorize(() => '<token>')
-const { data } = await epilot.focusPocus.getHealth(...)
-```
-
-### Tree-shakeable import
-
-```ts
-import { getClient, authorize } from '@epilot/sdk/focus-pocus'
-
-const focusPocusClient = getClient()
-authorize(focusPocusClient, () => '<token>')
-const { data } = await focusPocusClient.getHealth(...)
-```
-
-## Operations
-
-**Health**
-- [`getHealth`](#gethealth)
-
-**Achievements**
-- [`listAchievements`](#listachievements)
-- [`getAchievement`](#getachievement)
-
-**Challenges**
-- [`getSuggestedChallenge`](#getsuggestedchallenge)
-- [`acceptChallenge`](#acceptchallenge)
-- [`dismissChallenge`](#dismisschallenge)
-- [`listActiveChallenges`](#listactivechallenges)
-
-**Events**
-- [`postEvent`](#postevent)
-
-**Schemas**
-- [`HealthResponse`](#healthresponse)
-- [`ErrorResponse`](#errorresponse)
-- [`ConflictError`](#conflicterror)
-- [`ChallengeSuggested`](#challengesuggested)
-- [`ChallengeActive`](#challengeactive)
-- [`ActiveChallengeListResponse`](#activechallengelistresponse)
-- [`AchievementFeedItem`](#achievementfeeditem)
-- [`AchievementFeedListResponse`](#achievementfeedlistresponse)
-- [`EventIngestRequest`](#eventingestrequest)
-- [`EventAccepted`](#eventaccepted)
-
-### `getHealth`
-
-Liveness probe for the Focus Pocus API. Requires a valid EpilotAuth token.
-
-`GET /v1/health`
-
-```ts
-const { data } = await client.getHealth()
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "status": "ok",
-  "stage": "dev",
-  "service": "focus-pocus-api"
-}
-```
-
-</details>
-
----
-
-### `listAchievements`
-
-Unified feed for the authenticated user: returns active challenges and completed
-v1 static achievement unlocks. The `userId` is read from the EpilotAuth claim —
-no user path or query parameter is acce
-
-`GET /v1/achievements`
-
-```ts
-const { data } = await client.listAchievements()
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "results": [
-    {
-      "id": "string",
-      "challenge_template_id": "string",
-      "category": "string",
-      "title": "string",
-      "description": "string",
-      "badge_image_url": "string",
-      "icon": "string",
-      "status": "active",
-      "accepted_at": "1970-01-01T00:00:00.000Z",
-      "deadline": "1970-01-01T00:00:00.000Z",
-      "time_remaining_ms": 0,
-      "unlocked_at": "1970-01-01T00:00:00.000Z",
-      "xp_awarded": 0,
-      "just_unlocked": true
-    }
-  ],
-  "total": 0
-}
-```
-
-</details>
-
----
-
-### `getAchievement`
-
-Single user-scoped achievement or active-challenge item. Returns 404 if the id
-does not belong to the authenticated user.
-
-`GET /v1/achievements/{id}`
-
-```ts
-const { data } = await client.getAchievement({
-  id: '123e4567-e89b-12d3-a456-426614174000',
-})
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "id": "string",
-  "challenge_template_id": "string",
-  "category": "string",
-  "title": "string",
-  "description": "string",
-  "badge_image_url": "string",
-  "icon": "string",
-  "status": "active",
-  "accepted_at": "1970-01-01T00:00:00.000Z",
-  "deadline": "1970-01-01T00:00:00.000Z",
-  "time_remaining_ms": 0,
-  "unlocked_at": "1970-01-01T00:00:00.000Z",
-  "xp_awarded": 0,
-  "just_unlocked": true
-}
-```
-
-</details>
-
----
-
-### `getSuggestedChallenge`
-
-Returns a suggested challenge for the authenticated user. The suggestion is
-persisted with a 7-day TTL. Calling again with the same `(user, category)`
-within 24h returns the existing suggestion withou
-
-`GET /v1/challenges/suggest`
-
-```ts
-const { data } = await client.getSuggestedChallenge({
-  route: 'example',
-  entity_type: 'example',
-  category_hint: 'example',
-})
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "id": "string",
-  "challenge_template_id": "string",
-  "category": "string",
-  "title": "string",
-  "description": "string",
-  "badge_image_url": "string",
-  "default_duration_hours": 1,
-  "status": "suggested",
-  "suggested_at": "1970-01-01T00:00:00.000Z"
-}
-```
-
-</details>
-
----
-
-### `acceptChallenge`
-
-Accept a suggested challenge. Atomically transitions the challenge from
-`suggested` to `active` using a conditional DynamoDB UpdateItem. Returns 409 if
-the challenge has already been transitioned or t
-
-`POST /v1/challenges/{id}/accept`
-
-```ts
-const { data } = await client.acceptChallenge({
-  id: '123e4567-e89b-12d3-a456-426614174000',
-})
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "id": "string",
-  "challenge_template_id": "string",
-  "category": "string",
-  "title": "string",
-  "description": "string",
-  "badge_image_url": "string",
-  "status": "active",
-  "accepted_at": "1970-01-01T00:00:00.000Z",
-  "deadline": "1970-01-01T00:00:00.000Z",
-  "time_remaining_ms": 0
-}
-```
-
-</details>
-
----
-
-### `dismissChallenge`
-
-Dismiss a suggested challenge. Atomically transitions the challenge from
-`suggested` to `dismissed`. The challenge template is filtered from `/suggest`
-responses for the next 24h. Returns 409 if the c
-
-`POST /v1/challenges/{id}/dismiss`
-
-```ts
-const { data } = await client.dismissChallenge({
-  id: '123e4567-e89b-12d3-a456-426614174000',
-})
-```
-
----
-
-### `listActiveChallenges`
-
-Returns all active challenges for the authenticated user. Challenges whose
-deadline has passed are lazily expired (fire-and-forget UpdateItem) and
-excluded from the response. The result set is bounded
-
-`GET /v1/challenges/active`
-
-```ts
-const { data } = await client.listActiveChallenges()
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "results": [
-    {
-      "id": "string",
-      "challenge_template_id": "string",
-      "category": "string",
-      "title": "string",
-      "description": "string",
-      "badge_image_url": "string",
-      "status": "active",
-      "accepted_at": "1970-01-01T00:00:00.000Z",
-      "deadline": "1970-01-01T00:00:00.000Z",
-      "time_remaining_ms": 0
-    }
-  ],
-  "total": 0
-}
-```
-
-</details>
-
----
-
-### `postEvent`
-
-Persist-first event ingest. Accepts an activity event, writes it to the event log
-idempotently (keyed by `event_id`), and returns 202. Achievement evaluation happens
-asynchronously — no unlocks are re
-
-`POST /v1/events`
-
-```ts
-const { data } = await client.postEvent(
-  null,
-  {
-    event_id: 'string',
-    event_type: 'string',
-    actor_user_id: 'string',
-    occurred_at: '1970-01-01T00:00:00.000Z',
-    properties: {}
-  },
-)
-```
-
----
-
-## Schemas
-
-### `HealthResponse`
-
-```ts
-type HealthResponse = {
-  status: "ok"
-  stage: string
-  service: string
-}
-```
-
-### `ErrorResponse`
-
-```ts
-type ErrorResponse = {
-  status: number
-  error: string
-}
-```
-
-### `ConflictError`
-
-```ts
-type ConflictError = {
-  status: 409
-  error: string
-  reason: "already_transitioned" | "too_many_active" | "deadline_passed"
-}
-```
-
-### `ChallengeSuggested`
-
-```ts
-type ChallengeSuggested = {
-  id: string
-  challenge_template_id: string
-  category: string
-  title: string
-  description: string
-  badge_image_url: string
-  default_duration_hours: number
-  status: "suggested"
-  suggested_at: string // date-time
-}
-```
-
-### `ChallengeActive`
-
-```ts
-type ChallengeActive = {
-  id: string
-  challenge_template_id: string
-  category: string
-  title: string
-  description: string
-  badge_image_url: string
-  status: "active"
-  accepted_at: string // date-time
-  deadline: string // date-time
-  time_remaining_ms: number
-}
-```
-
-### `ActiveChallengeListResponse`
-
-```ts
-type ActiveChallengeListResponse = {
-  results: Array<{
-    id: string
-    challenge_template_id: string
-    category: string
-    title: string
-    description: string
-    badge_image_url: string
-    status: "active"
-    accepted_at: string // date-time
-    deadline: string // date-time
-    time_remaining_ms: number
-  }>
-  total: number
-}
-```
-
-### `AchievementFeedItem`
-
-```ts
-type AchievementFeedItem = {
-  id: string
-  challenge_template_id?: string
-  category: string
-  title: string
-  description: string
-  badge_image_url?: string
-  icon?: string
-  status: "active" | "completed" | "expired"
-  accepted_at?: string // date-time
-  deadline?: string // date-time
-  time_remaining_ms?: number
-  unlocked_at?: string // date-time
-  xp_awarded?: number
-  just_unlocked: boolean
-}
-```
-
-### `AchievementFeedListResponse`
-
-```ts
-type AchievementFeedListResponse = {
-  results: Array<{
-    id: string
-    challenge_template_id?: string
-    category: string
-    title: string
-    description: string
-    badge_image_url?: string
-    icon?: string
-    status: "active" | "completed" | "expired"
-    accepted_at?: string // date-time
-    deadline?: string // date-time
-    time_remaining_ms?: number
-    unlocked_at?: string // date-time
-    xp_awarded?: number
-    just_unlocked: boolean
-  }>
-  total: number
-}
-```
-
-### `EventIngestRequest`
-
-```ts
-type EventIngestRequest = {
-  event_id: string
-  event_type: string
-  actor_user_id: string
-  occurred_at: string // date-time
-  properties?: Record<string, unknown>
-}
-```
-
-### `EventAccepted`
-
-```ts
-type EventAccepted = {
-  accepted: true
-}
-```