@epilot/sdk 2.20.8-alpha.0 → 2.20.9

package/docs/validation-rules.md

@@ -65,6 +65,13 @@ const { data } = await validationRulesClient.getValidationRules(...)
 - [`RelativeDateValue`](#relativedatevalue)
 - [`RangeValue`](#rangevalue)
 - [`NoValue`](#novalue)
+- [`DocumentRuleType`](#documentruletype)
+- [`DocumentCheck`](#documentcheck)
+- [`DocumentCondition`](#documentcondition)
+- [`DocumentOperator`](#documentoperator)
+- [`DocumentConditionValue`](#documentconditionvalue)
+- [`FileTypesValue`](#filetypesvalue)
+- [`CriteriaValue`](#criteriavalue)
 - [`AppliesWhen`](#applieswhen)
 - [`ContextRequirement`](#contextrequirement)
 
@@ -682,6 +689,18 @@ type UpdateValidationRuleRequest = {
       applies_when?: { ... }
       allow_failure?: { ... }
     }>
+  } | {
+    input_type: "document"
+    check: {
+      level: { ... }
+    }
+    conditions: Array<{
+      id: { ... }
+      operator: { ... }
+      value: { ... }
+      error_message: { ... }
+      allow_failure?: { ... }
+    }>
   }
   contexts?: Array<{
     schema: string
@@ -737,6 +756,18 @@ type ValidationRuleBase = {
       applies_when?: { ... }
       allow_failure?: { ... }
     }>
+  } | {
+    input_type: "document"
+    check: {
+      level: { ... }
+    }
+    conditions: Array<{
+      id: { ... }
+      operator: { ... }
+      value: { ... }
+      error_message: { ... }
+      allow_failure?: { ... }
+    }>
   }
   contexts?: Array<{
     schema: string
@@ -2261,6 +2292,261 @@ type NoValue = {
 }
 ```
 
+### `DocumentRuleType`
+
+Declarative validation rule (schema version v2) for uploaded files. The rule declares how deep
+the check goes (`check.level`) and the conditions the file must satisfy. Property conditions
+(file type, size, page count, image resolution, blank and password-protected detection) are
+deterministic and av
+
+```ts
+type DocumentRuleType = {
+  input_type: "document"
+  check: {
+    level: "basic" | "standard" | "advanced"
+  }
+  conditions: Array<{
+    id: string
+    operator: "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"
+    value: {
+      source: { ... }
+      data: { ... }
+    } | {
+      source: { ... }
+      min: { ... }
+      max: { ... }
+    } | {
+      source: { ... }
+    } | {
+      source: { ... }
+      types: { ... }
+    } | {
+      source: { ... }
+      text: { ... }
+    }
+    error_message: string
+    allow_failure?: boolean
+  }>
+}
+```
+
+### `DocumentCheck`
+
+How deep the document check goes. Levels are cumulative.
+
+```ts
+type DocumentCheck = {
+  level: "basic" | "standard" | "advanced"
+}
+```
+
+### `DocumentCondition`
+
+A single check the uploaded file must satisfy.
+
+```ts
+type DocumentCondition = {
+  id: string
+  operator: "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"
+  value: {
+    source: "static"
+    data: number | string | boolean
+  } | {
+    source: "range"
+    min: {
+      source: { ... }
+      data: { ... }
+    } | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    } | {
+      source: { ... }
+      offset: { ... }
+      unit: { ... }
+      anchor?: { ... }
+    } | {
+      source: { ... }
+      key: { ... }
+      adjust?: { ... }
+    } | {
+      source: { ... }
+      app_id: { ... }
+      hook_id: { ... }
+      result_id: { ... }
+      adjust?: { ... }
+    }
+    max: {
+      source: { ... }
+      data: { ... }
+    } | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    } | {
+      source: { ... }
+      offset: { ... }
+      unit: { ... }
+      anchor?: { ... }
+    } | {
+      source: { ... }
+      key: { ... }
+      adjust?: { ... }
+    } | {
+      source: { ... }
+      app_id: { ... }
+      hook_id: { ... }
+      result_id: { ... }
+      adjust?: { ... }
+    }
+  } | {
+    source: "none"
+  } | {
+    source: "file_types"
+    types: "image" | "pdf" | "document" | "spreadsheet"[]
+  } | {
+    source: "criteria"
+    text: string
+  }
+  error_message: string
+  allow_failure?: boolean
+}
+```
+
+### `DocumentOperator`
+
+Predefined document check. Value compatibility (enforced at write time):
+- fileTypeIn: `file_types` value listing the accepted file categories.
+- sizeBelow: static integer, maximum file size in bytes.
+- pageCountBetween: `range` of static non-negative integers (inclusive).
+- resolutionAtLeast / reso
+
+```ts
+type DocumentOperator = "fileTypeIn" | "sizeBelow" | "pageCountBetween" | "resolutionAtLeast" | "resolutionAtMost" | "isNotBlank" | "isNotPasswordProtected" | "meetsCriteria"
+```
+
+### `DocumentConditionValue`
+
+The value of a document condition - a static scalar, a range, nothing, accepted file categories, or a free-text criterion.
+
+```ts
+type DocumentConditionValue = {
+  source: "static"
+  data: number | string | boolean
+} | {
+  source: "range"
+  min: {
+    source: "static"
+    data: number | string | boolean
+  } | {
+    source: "context"
+    path: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  } | {
+    source: "relative_date"
+    offset: number
+    unit: "days" | "months" | "years"
+    anchor?: "today"
+  } | {
+    source: "environment"
+    key: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  } | {
+    source: "external"
+    app_id: string
+    hook_id: string
+    result_id: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  }
+  max: {
+    source: "static"
+    data: number | string | boolean
+  } | {
+    source: "context"
+    path: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  } | {
+    source: "relative_date"
+    offset: number
+    unit: "days" | "months" | "years"
+    anchor?: "today"
+  } | {
+    source: "environment"
+    key: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  } | {
+    source: "external"
+    app_id: string
+    hook_id: string
+    result_id: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  }
+} | {
+  source: "none"
+} | {
+  source: "file_types"
+  types: "image" | "pdf" | "document" | "spreadsheet"[]
+} | {
+  source: "criteria"
+  text: string
+}
+```
+
+### `FileTypesValue`
+
+Accepted file categories; each category expands to a mime list at check time.
+
+```ts
+type FileTypesValue = {
+  source: "file_types"
+  types: "image" | "pdf" | "document" | "spreadsheet"[]
+}
+```
+
+### `CriteriaValue`
+
+A free-text requirement judged against the document's extracted content, e.g. "The photo shows
+an electricity meter with the meter number and the current reading fully legible." One requirement
+per condition keeps results specific and lets each requirement be graded separately.
+
+
+```ts
+type CriteriaValue = {
+  source: "criteria"
+  text: string
+}
+```
+
 ### `AppliesWhen`
 
 Optional precondition on a condition: the condition only takes part in the

package/package.json

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

package/dist/environments-DBHM4GKI.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/environments.json
-var environments_default = '# Environments API\n\n- **Base URL:** `https://environments.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/environments](https://docs.epilot.io/api/environments)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.environments.listEnvironmentVariables(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/environments\'\n\nconst environmentsClient = getClient()\nauthorize(environmentsClient, () => \'<token>\')\nconst { data } = await environmentsClient.listEnvironmentVariables(...)\n```\n\n## Operations\n\n**environments**\n- [`listEnvironmentVariables`](#listenvironmentvariables)\n- [`createEnvironmentVariable`](#createenvironmentvariable)\n- [`listEnvironmentGroups`](#listenvironmentgroups)\n- [`putEnvironmentGroup`](#putenvironmentgroup)\n- [`deleteEnvironmentGroup`](#deleteenvironmentgroup)\n- [`getEnvironmentVariable`](#getenvironmentvariable)\n- [`updateEnvironmentVariable`](#updateenvironmentvariable)\n- [`deleteEnvironmentVariable`](#deleteenvironmentvariable)\n\n**Schemas**\n- [`EnvironmentValueType`](#environmentvaluetype)\n- [`StringTranslations`](#stringtranslations)\n- [`MapEntry`](#mapentry)\n- [`MapValue`](#mapvalue)\n- [`JsonValue`](#jsonvalue)\n- [`LinkValue`](#linkvalue)\n- [`LinkFields`](#linkfields)\n- [`ListItemType`](#listitemtype)\n- [`ListOfText`](#listoftext)\n- [`ListOfNumber`](#listofnumber)\n- [`ListOfBoolean`](#listofboolean)\n- [`ListOfJson`](#listofjson)\n- [`ListOfLink`](#listoflink)\n- [`ListValue`](#listvalue)\n- [`EnvironmentValue`](#environmentvalue)\n- [`EnvironmentVariable`](#environmentvariable)\n- [`EnvironmentVariableListItem`](#environmentvariablelistitem)\n- [`EnvironmentVariableList`](#environmentvariablelist)\n- [`EnvironmentVariableCreateRequest`](#environmentvariablecreaterequest)\n- [`EnvironmentVariableUpdateRequest`](#environmentvariableupdaterequest)\n- [`EnvironmentGroup`](#environmentgroup)\n- [`EnvironmentGroupList`](#environmentgrouplist)\n- [`EnvironmentGroupUpsertRequest`](#environmentgroupupsertrequest)\n\n### `listEnvironmentVariables`\n\nList all environment variables for the organization. Returns metadata only, no secret values.\n\n`GET /v1/environments`\n\n```ts\nconst { data } = await client.listEnvironmentVariables()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "items": [\n    {\n      "key": "string",\n      "type": "String",\n      "description": "string",\n      "group": "string",\n      "value": "string",\n      "protected": true,\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createEnvironmentVariable`\n\nCreate a new environment variable or secret for the organization. If `group` is provided and the group does not yet exist, it is created automatically.\n\n`POST /v1/environments`\n\n```ts\nconst { data } = await client.createEnvironmentVariable(\n  null,\n  {\n    key: \'string\',\n    type: \'String\',\n    description: \'string\',\n    group: \'string\',\n    value: \'string\',\n    protected: true\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "key": "string",\n  "type": "String",\n  "description": "string",\n  "group": "string",\n  "value": "string",\n  "protected": true,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `listEnvironmentGroups`\n\nList all environment groups for the organization.\n\n`GET /v1/environments/groups`\n\n```ts\nconst { data } = await client.listEnvironmentGroups()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "items": [\n    {\n      "name": "string",\n      "description": "string",\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `putEnvironmentGroup`\n\nCreate or update an environment group by name. Acts as an upsert \u2014 creates the group if it does not exist.\n\n`PUT /v1/environments/groups/{name}`\n\n```ts\nconst { data } = await client.putEnvironmentGroup(\n  {\n    name: \'example\',\n  },\n  {\n    description: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "name": "string",\n  "description": "string",\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `deleteEnvironmentGroup`\n\nDeletes a group. Variables assigned to this group become ungrouped.\n\n`DELETE /v1/environments/groups/{name}`\n\n```ts\nconst { data } = await client.deleteEnvironmentGroup({\n  name: \'example\',\n})\n```\n\n---\n\n### `getEnvironmentVariable`\n\nGet an environment variable by key. Returns value for non-secret types, omitted for SecretString.\n\n`GET /v1/environments/{key}`\n\n```ts\nconst { data } = await client.getEnvironmentVariable({\n  key: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "key": "string",\n  "type": "String",\n  "description": "string",\n  "group": "string",\n  "value": "string",\n  "protected": true,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateEnvironmentVariable`\n\nCreate or update an environment variable. Acts as an upsert \u2014 creates the variable if it does not exist. If `group` is provided and the group does not yet exist, it is created automatically.\n\n`PUT /v1/environments/{key}`\n\n```ts\nconst { data } = await client.updateEnvironmentVariable(\n  {\n    key: \'example\',\n  },\n  {\n    type: \'String\',\n    value: \'string\',\n    description: \'string\',\n    group: \'string\',\n    protected: true\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "key": "string",\n  "type": "String",\n  "description": "string",\n  "group": "string",\n  "value": "string",\n  "protected": true,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `deleteEnvironmentVariable`\n\nDelete an environment variable by key.\n\n`DELETE /v1/environments/{key}`\n\n```ts\nconst { data } = await client.deleteEnvironmentVariable({\n  key: \'example\',\n})\n```\n\n---\n\n## Schemas\n\n### `EnvironmentValueType`\n\nThe structure a variable\'s value holds. `SecretString` is encrypted at rest and\nits value is never returned. `Text`, `Number`, `Boolean`, `Map`, `JSON`, `Link` and\n`List` may be served to browser-facing consumers; `String` and `SecretString` may not.\n\n\n```ts\ntype EnvironmentValueType = "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n```\n\n### `StringTranslations`\n\nA string translated per language. Keys are language codes (e.g. `de`,\n`en-US`), matching the hyphen-only BCP-47 form epilot\'s i18n stack uses\neverywhere else: `^[a-z]{2,3}(-[A-Za-z0-9]+)*$`. The server enforces\nthat with LANGUAGE_KEY_PATTERN in src/core/value-types.ts \u2014 the two are\nnot otherwise lin\n\n```ts\ntype StringTranslations = Record<string, string>\n```\n\n### `MapEntry`\n\nOne entry of a Map. `key` is the token a journey submits; `value` is\nwhat the customer reads \u2014 either one string, or one string per\nlanguage. Every entry of a Map must agree on which of the two it uses.\n\n\n```ts\ntype MapEntry = {\n  key: string\n  value: string | Record<string, string>\n}\n```\n\n### `MapValue`\n\n```ts\ntype MapValue = {\n  fallbackLanguage?: string\n  options: Array<{\n    key: string\n    value: string | Record<string, string>\n  }>\n}\n```\n\n### `JsonValue`\n\nArbitrary JSON object, e.g. a flat key/value map used by integrations for\nenum translation: {"Mr.": 1, "Ms. / Mrs.": 2}. Max 32 KB serialised.\n\n\n```ts\ntype JsonValue = Record<string, unknown>\n```\n\n### `LinkValue`\n\nOne URL with a label and description a customer reads. `label` and\n`description` are each either a plain string or one string per language;\nthe two fields decide that independently \u2014 a plain string means "the\nsame in every language". A translated field must carry the fallback\nlanguage.\n\nThe URL must\n\n```ts\ntype LinkValue = {\n  url: string\n  label: string | Record<string, string>\n  description?: string | Record<string, string>\n  fallbackLanguage?: string\n}\n```\n\n### `LinkFields`\n\nThe fields of a link, without a fallback language \u2014 the shape a `List`\nitem carries. Inside a list the fallback belongs to the wrapper, which\nowns the language tabs for every row.\n\nRestated rather than composed with `LinkValue`: `allOf` plus\n`additionalProperties: false` is rejected by most validato\n\n```ts\ntype LinkFields = {\n  url: string\n  label: string | Record<string, string>\n  description?: string | Record<string, string>\n}\n```\n\n### `ListItemType`\n\nThe element type a `List` holds. `String` and `SecretString` are absent\ndeliberately: they are the two types never served to browser-facing\nconsumers, and a `List` is. `Map` is already a keyed collection, and a\nlist of lists has no consumer.\n\n\n```ts\ntype ListItemType = "Text" | "Number" | "Boolean" | "JSON" | "Link"\n```\n\n### `ListOfText`\n\n```ts\ntype ListOfText = {\n  itemType: "Text"\n  items: string[]\n}\n```\n\n### `ListOfNumber`\n\n```ts\ntype ListOfNumber = {\n  itemType: "Number"\n  items: number[]\n}\n```\n\n### `ListOfBoolean`\n\n```ts\ntype ListOfBoolean = {\n  itemType: "Boolean"\n  items: boolean[]\n}\n```\n\n### `ListOfJson`\n\n```ts\ntype ListOfJson = {\n  itemType: "JSON"\n  items: Record<string, unknown>[]\n}\n```\n\n### `ListOfLink`\n\nA list of links. `fallbackLanguage` applies to every item\'s translated\n`label` and `description`; items may mix plain and translated fields\nfreely, since a plain string is a complete answer for any language.\n\n\n```ts\ntype ListOfLink = {\n  itemType: "Link"\n  fallbackLanguage?: string\n  items: Array<{\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n  }>\n}\n```\n\n### `ListValue`\n\nAn ordered collection of one declared element type. Items round-trip in\nthe order written; nothing sorts them. Holds at most 100 items.\n\nThe whole value is limited to 32768 characters when serialised \u2014 the\nserver enforces this, and it is not expressible per-property here.\n\n\n```ts\ntype ListValue = {\n  itemType: "Text"\n  items: string[]\n} | {\n  itemType: "Number"\n  items: number[]\n} | {\n  itemType: "Boolean"\n  items: boolean[]\n} | {\n  itemType: "JSON"\n  items: Record<string, unknown>[]\n} | {\n  itemType: "Link"\n  fallbackLanguage?: string\n  items: Array<{\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n  }>\n}\n```\n\n### `EnvironmentValue`\n\nA variable\'s value. The JSON type corresponds to the variable\'s `type`:\n`String`, `SecretString` and `Text` are strings, `Number` is a number,\n`Boolean` is a boolean, and `Map`, `JSON`, `Link` and `List` are objects.\nNumbers are IEEE 754 doubles; integers above 2^53 may lose precision on\nround-trip.\n\n```ts\ntype EnvironmentValue = string | number | boolean | {\n  fallbackLanguage?: string\n  options: Array<{\n    key: string\n    value: string | Record<string, string>\n  }>\n} | Record<string, unknown> | {\n  url: string\n  label: string | Record<string, string>\n  description?: string | Record<string, string>\n  fallbackLanguage?: string\n} | {\n  itemType: "Text"\n  items: string[]\n} | {\n  itemType: "Number"\n  items: number[]\n} | {\n  itemType: "Boolean"\n  items: boolean[]\n} | {\n  itemType: "JSON"\n  items: Record<string, unknown>[]\n} | {\n  itemType: "Link"\n  fallbackLanguage?: string\n  items: Array<{\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n  }>\n}\n```\n\n### `EnvironmentVariable`\n\n```ts\ntype EnvironmentVariable = {\n  key: string\n  type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  description?: string\n  group?: string\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  protected?: boolean\n  created_at: string // date-time\n  updated_at: string // date-time\n}\n```\n\n### `EnvironmentVariableListItem`\n\n```ts\ntype EnvironmentVariableListItem = {\n  key: string\n  type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  description?: string\n  group?: string\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  protected?: boolean\n  created_at: string // date-time\n  updated_at: string // date-time\n}\n```\n\n### `EnvironmentVariableList`\n\n```ts\ntype EnvironmentVariableList = {\n  items: Array<{\n    key: string\n    type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n    description?: string\n    group?: string\n    value?: string | number | boolean | {\n      fallbackLanguage?: { ... }\n      options: { ... }\n    } | Record<string, unknown> | {\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n      fallbackLanguage?: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      fallbackLanguage?: { ... }\n      items: { ... }\n    }\n    protected?: boolean\n    created_at: string // date-time\n    updated_at: string // date-time\n  }>\n}\n```\n\n### `EnvironmentVariableCreateRequest`\n\n```ts\ntype EnvironmentVariableCreateRequest = {\n  key: string\n  type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  description?: string\n  group?: string\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  protected?: boolean\n}\n```\n\n### `EnvironmentVariableUpdateRequest`\n\n```ts\ntype EnvironmentVariableUpdateRequest = {\n  type?: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  description?: string\n  group?: string\n  protected?: boolean\n}\n```\n\n### `EnvironmentGroup`\n\n```ts\ntype EnvironmentGroup = {\n  name: string\n  description?: string\n  created_at: string // date-time\n  updated_at: string // date-time\n}\n```\n\n### `EnvironmentGroupList`\n\n```ts\ntype EnvironmentGroupList = {\n  items: Array<{\n    name: string\n    description?: string\n    created_at: string // date-time\n    updated_at: string // date-time\n  }>\n}\n```\n\n### `EnvironmentGroupUpsertRequest`\n\n```ts\ntype EnvironmentGroupUpsertRequest = {\n  description?: string\n}\n```\n';
-
-
-exports.default = environments_default;

package/dist/environments-JVPK6LSD.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/environments.json
-var environments_default = '# Environments API\n\n- **Base URL:** `https://environments.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/environments](https://docs.epilot.io/api/environments)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.environments.listEnvironmentVariables(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/environments\'\n\nconst environmentsClient = getClient()\nauthorize(environmentsClient, () => \'<token>\')\nconst { data } = await environmentsClient.listEnvironmentVariables(...)\n```\n\n## Operations\n\n**environments**\n- [`listEnvironmentVariables`](#listenvironmentvariables)\n- [`createEnvironmentVariable`](#createenvironmentvariable)\n- [`listEnvironmentGroups`](#listenvironmentgroups)\n- [`putEnvironmentGroup`](#putenvironmentgroup)\n- [`deleteEnvironmentGroup`](#deleteenvironmentgroup)\n- [`getEnvironmentVariable`](#getenvironmentvariable)\n- [`updateEnvironmentVariable`](#updateenvironmentvariable)\n- [`deleteEnvironmentVariable`](#deleteenvironmentvariable)\n\n**Schemas**\n- [`EnvironmentValueType`](#environmentvaluetype)\n- [`StringTranslations`](#stringtranslations)\n- [`MapEntry`](#mapentry)\n- [`MapValue`](#mapvalue)\n- [`JsonValue`](#jsonvalue)\n- [`LinkValue`](#linkvalue)\n- [`LinkFields`](#linkfields)\n- [`ListItemType`](#listitemtype)\n- [`ListOfText`](#listoftext)\n- [`ListOfNumber`](#listofnumber)\n- [`ListOfBoolean`](#listofboolean)\n- [`ListOfJson`](#listofjson)\n- [`ListOfLink`](#listoflink)\n- [`ListValue`](#listvalue)\n- [`EnvironmentValue`](#environmentvalue)\n- [`EnvironmentVariable`](#environmentvariable)\n- [`EnvironmentVariableListItem`](#environmentvariablelistitem)\n- [`EnvironmentVariableList`](#environmentvariablelist)\n- [`EnvironmentVariableCreateRequest`](#environmentvariablecreaterequest)\n- [`EnvironmentVariableUpdateRequest`](#environmentvariableupdaterequest)\n- [`EnvironmentGroup`](#environmentgroup)\n- [`EnvironmentGroupList`](#environmentgrouplist)\n- [`EnvironmentGroupUpsertRequest`](#environmentgroupupsertrequest)\n\n### `listEnvironmentVariables`\n\nList all environment variables for the organization. Returns metadata only, no secret values.\n\n`GET /v1/environments`\n\n```ts\nconst { data } = await client.listEnvironmentVariables()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "items": [\n    {\n      "key": "string",\n      "type": "String",\n      "description": "string",\n      "group": "string",\n      "value": "string",\n      "protected": true,\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createEnvironmentVariable`\n\nCreate a new environment variable or secret for the organization. If `group` is provided and the group does not yet exist, it is created automatically.\n\n`POST /v1/environments`\n\n```ts\nconst { data } = await client.createEnvironmentVariable(\n  null,\n  {\n    key: \'string\',\n    type: \'String\',\n    description: \'string\',\n    group: \'string\',\n    value: \'string\',\n    protected: true\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "key": "string",\n  "type": "String",\n  "description": "string",\n  "group": "string",\n  "value": "string",\n  "protected": true,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `listEnvironmentGroups`\n\nList all environment groups for the organization.\n\n`GET /v1/environments/groups`\n\n```ts\nconst { data } = await client.listEnvironmentGroups()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "items": [\n    {\n      "name": "string",\n      "description": "string",\n      "created_at": "1970-01-01T00:00:00.000Z",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `putEnvironmentGroup`\n\nCreate or update an environment group by name. Acts as an upsert \u2014 creates the group if it does not exist.\n\n`PUT /v1/environments/groups/{name}`\n\n```ts\nconst { data } = await client.putEnvironmentGroup(\n  {\n    name: \'example\',\n  },\n  {\n    description: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "name": "string",\n  "description": "string",\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `deleteEnvironmentGroup`\n\nDeletes a group. Variables assigned to this group become ungrouped.\n\n`DELETE /v1/environments/groups/{name}`\n\n```ts\nconst { data } = await client.deleteEnvironmentGroup({\n  name: \'example\',\n})\n```\n\n---\n\n### `getEnvironmentVariable`\n\nGet an environment variable by key. Returns value for non-secret types, omitted for SecretString.\n\n`GET /v1/environments/{key}`\n\n```ts\nconst { data } = await client.getEnvironmentVariable({\n  key: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "key": "string",\n  "type": "String",\n  "description": "string",\n  "group": "string",\n  "value": "string",\n  "protected": true,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateEnvironmentVariable`\n\nCreate or update an environment variable. Acts as an upsert \u2014 creates the variable if it does not exist. If `group` is provided and the group does not yet exist, it is created automatically.\n\n`PUT /v1/environments/{key}`\n\n```ts\nconst { data } = await client.updateEnvironmentVariable(\n  {\n    key: \'example\',\n  },\n  {\n    type: \'String\',\n    value: \'string\',\n    description: \'string\',\n    group: \'string\',\n    protected: true\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "key": "string",\n  "type": "String",\n  "description": "string",\n  "group": "string",\n  "value": "string",\n  "protected": true,\n  "created_at": "1970-01-01T00:00:00.000Z",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `deleteEnvironmentVariable`\n\nDelete an environment variable by key.\n\n`DELETE /v1/environments/{key}`\n\n```ts\nconst { data } = await client.deleteEnvironmentVariable({\n  key: \'example\',\n})\n```\n\n---\n\n## Schemas\n\n### `EnvironmentValueType`\n\nThe structure a variable\'s value holds. `SecretString` is encrypted at rest and\nits value is never returned. `Text`, `Number`, `Boolean`, `Map`, `JSON`, `Link` and\n`List` may be served to browser-facing consumers; `String` and `SecretString` may not.\n\n\n```ts\ntype EnvironmentValueType = "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n```\n\n### `StringTranslations`\n\nA string translated per language. Keys are language codes (e.g. `de`,\n`en-US`), matching the hyphen-only BCP-47 form epilot\'s i18n stack uses\neverywhere else: `^[a-z]{2,3}(-[A-Za-z0-9]+)*$`. The server enforces\nthat with LANGUAGE_KEY_PATTERN in src/core/value-types.ts \u2014 the two are\nnot otherwise lin\n\n```ts\ntype StringTranslations = Record<string, string>\n```\n\n### `MapEntry`\n\nOne entry of a Map. `key` is the token a journey submits; `value` is\nwhat the customer reads \u2014 either one string, or one string per\nlanguage. Every entry of a Map must agree on which of the two it uses.\n\n\n```ts\ntype MapEntry = {\n  key: string\n  value: string | Record<string, string>\n}\n```\n\n### `MapValue`\n\n```ts\ntype MapValue = {\n  fallbackLanguage?: string\n  options: Array<{\n    key: string\n    value: string | Record<string, string>\n  }>\n}\n```\n\n### `JsonValue`\n\nArbitrary JSON object, e.g. a flat key/value map used by integrations for\nenum translation: {"Mr.": 1, "Ms. / Mrs.": 2}. Max 32 KB serialised.\n\n\n```ts\ntype JsonValue = Record<string, unknown>\n```\n\n### `LinkValue`\n\nOne URL with a label and description a customer reads. `label` and\n`description` are each either a plain string or one string per language;\nthe two fields decide that independently \u2014 a plain string means "the\nsame in every language". A translated field must carry the fallback\nlanguage.\n\nThe URL must\n\n```ts\ntype LinkValue = {\n  url: string\n  label: string | Record<string, string>\n  description?: string | Record<string, string>\n  fallbackLanguage?: string\n}\n```\n\n### `LinkFields`\n\nThe fields of a link, without a fallback language \u2014 the shape a `List`\nitem carries. Inside a list the fallback belongs to the wrapper, which\nowns the language tabs for every row.\n\nRestated rather than composed with `LinkValue`: `allOf` plus\n`additionalProperties: false` is rejected by most validato\n\n```ts\ntype LinkFields = {\n  url: string\n  label: string | Record<string, string>\n  description?: string | Record<string, string>\n}\n```\n\n### `ListItemType`\n\nThe element type a `List` holds. `String` and `SecretString` are absent\ndeliberately: they are the two types never served to browser-facing\nconsumers, and a `List` is. `Map` is already a keyed collection, and a\nlist of lists has no consumer.\n\n\n```ts\ntype ListItemType = "Text" | "Number" | "Boolean" | "JSON" | "Link"\n```\n\n### `ListOfText`\n\n```ts\ntype ListOfText = {\n  itemType: "Text"\n  items: string[]\n}\n```\n\n### `ListOfNumber`\n\n```ts\ntype ListOfNumber = {\n  itemType: "Number"\n  items: number[]\n}\n```\n\n### `ListOfBoolean`\n\n```ts\ntype ListOfBoolean = {\n  itemType: "Boolean"\n  items: boolean[]\n}\n```\n\n### `ListOfJson`\n\n```ts\ntype ListOfJson = {\n  itemType: "JSON"\n  items: Record<string, unknown>[]\n}\n```\n\n### `ListOfLink`\n\nA list of links. `fallbackLanguage` applies to every item\'s translated\n`label` and `description`; items may mix plain and translated fields\nfreely, since a plain string is a complete answer for any language.\n\n\n```ts\ntype ListOfLink = {\n  itemType: "Link"\n  fallbackLanguage?: string\n  items: Array<{\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n  }>\n}\n```\n\n### `ListValue`\n\nAn ordered collection of one declared element type. Items round-trip in\nthe order written; nothing sorts them. Holds at most 100 items.\n\nThe whole value is limited to 32768 characters when serialised \u2014 the\nserver enforces this, and it is not expressible per-property here.\n\n\n```ts\ntype ListValue = {\n  itemType: "Text"\n  items: string[]\n} | {\n  itemType: "Number"\n  items: number[]\n} | {\n  itemType: "Boolean"\n  items: boolean[]\n} | {\n  itemType: "JSON"\n  items: Record<string, unknown>[]\n} | {\n  itemType: "Link"\n  fallbackLanguage?: string\n  items: Array<{\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n  }>\n}\n```\n\n### `EnvironmentValue`\n\nA variable\'s value. The JSON type corresponds to the variable\'s `type`:\n`String`, `SecretString` and `Text` are strings, `Number` is a number,\n`Boolean` is a boolean, and `Map`, `JSON`, `Link` and `List` are objects.\nNumbers are IEEE 754 doubles; integers above 2^53 may lose precision on\nround-trip.\n\n```ts\ntype EnvironmentValue = string | number | boolean | {\n  fallbackLanguage?: string\n  options: Array<{\n    key: string\n    value: string | Record<string, string>\n  }>\n} | Record<string, unknown> | {\n  url: string\n  label: string | Record<string, string>\n  description?: string | Record<string, string>\n  fallbackLanguage?: string\n} | {\n  itemType: "Text"\n  items: string[]\n} | {\n  itemType: "Number"\n  items: number[]\n} | {\n  itemType: "Boolean"\n  items: boolean[]\n} | {\n  itemType: "JSON"\n  items: Record<string, unknown>[]\n} | {\n  itemType: "Link"\n  fallbackLanguage?: string\n  items: Array<{\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n  }>\n}\n```\n\n### `EnvironmentVariable`\n\n```ts\ntype EnvironmentVariable = {\n  key: string\n  type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  description?: string\n  group?: string\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  protected?: boolean\n  created_at: string // date-time\n  updated_at: string // date-time\n}\n```\n\n### `EnvironmentVariableListItem`\n\n```ts\ntype EnvironmentVariableListItem = {\n  key: string\n  type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  description?: string\n  group?: string\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  protected?: boolean\n  created_at: string // date-time\n  updated_at: string // date-time\n}\n```\n\n### `EnvironmentVariableList`\n\n```ts\ntype EnvironmentVariableList = {\n  items: Array<{\n    key: string\n    type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n    description?: string\n    group?: string\n    value?: string | number | boolean | {\n      fallbackLanguage?: { ... }\n      options: { ... }\n    } | Record<string, unknown> | {\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n      fallbackLanguage?: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      items: { ... }\n    } | {\n      itemType: { ... }\n      fallbackLanguage?: { ... }\n      items: { ... }\n    }\n    protected?: boolean\n    created_at: string // date-time\n    updated_at: string // date-time\n  }>\n}\n```\n\n### `EnvironmentVariableCreateRequest`\n\n```ts\ntype EnvironmentVariableCreateRequest = {\n  key: string\n  type: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  description?: string\n  group?: string\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  protected?: boolean\n}\n```\n\n### `EnvironmentVariableUpdateRequest`\n\n```ts\ntype EnvironmentVariableUpdateRequest = {\n  type?: "String" | "SecretString" | "Text" | "Number" | "Boolean" | "Map" | "JSON" | "Link" | "List"\n  value?: string | number | boolean | {\n    fallbackLanguage?: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  } | Record<string, unknown> | {\n    url: string\n    label: string | Record<string, string>\n    description?: string | Record<string, string>\n    fallbackLanguage?: string\n  } | {\n    itemType: "Text"\n    items: string[]\n  } | {\n    itemType: "Number"\n    items: number[]\n  } | {\n    itemType: "Boolean"\n    items: boolean[]\n  } | {\n    itemType: "JSON"\n    items: Record<string, unknown>[]\n  } | {\n    itemType: "Link"\n    fallbackLanguage?: string\n    items: Array<{\n      url: { ... }\n      label: { ... }\n      description?: { ... }\n    }>\n  }\n  description?: string\n  group?: string\n  protected?: boolean\n}\n```\n\n### `EnvironmentGroup`\n\n```ts\ntype EnvironmentGroup = {\n  name: string\n  description?: string\n  created_at: string // date-time\n  updated_at: string // date-time\n}\n```\n\n### `EnvironmentGroupList`\n\n```ts\ntype EnvironmentGroupList = {\n  items: Array<{\n    name: string\n    description?: string\n    created_at: string // date-time\n    updated_at: string // date-time\n  }>\n}\n```\n\n### `EnvironmentGroupUpsertRequest`\n\n```ts\ntype EnvironmentGroupUpsertRequest = {\n  description?: string\n}\n```\n';
-export {
-  environments_default as default
-};