@shipeasy/openapi 1.6.0 → 2.2.0

package/dist/schemas/index.js

@@ -1,762 +0,0 @@
-// src/schemas/constants.ts
-var CONFIG_ENVS = ["dev", "staging", "prod"];
-var CONFIG_KINDS = ["config", "killswitch"];
-
-// src/schemas/pagination.ts
-import { z } from "zod";
-var DEFAULT_PAGE_SIZE = 100;
-var MAX_PAGE_SIZE = 500;
-var pageQuerySchema = z.object({
-  limit: z.coerce.number().int().min(1).max(MAX_PAGE_SIZE).default(DEFAULT_PAGE_SIZE),
-  cursor: z.string().min(1).optional()
-});
-var SEP = "|";
-function encodeCursor(parts) {
-  if (parts.ts.includes(SEP)) {
-    throw new Error(`pagination: ts must not contain '${SEP}'`);
-  }
-  return base64UrlEncode(`${parts.ts}${SEP}${parts.id}`);
-}
-function decodeCursor(cursor) {
-  let raw;
-  try {
-    raw = base64UrlDecode(cursor);
-  } catch {
-    throw new Error("pagination: cursor is not valid base64url");
-  }
-  const sep = raw.indexOf(SEP);
-  if (sep < 0) throw new Error("pagination: cursor missing separator");
-  const ts = raw.slice(0, sep);
-  const id = raw.slice(sep + 1);
-  if (!ts || !id) throw new Error("pagination: cursor parts empty");
-  return { ts, id };
-}
-function base64UrlEncode(s) {
-  const b64 = btoa(s);
-  return b64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
-function base64UrlDecode(s) {
-  const pad = s.length % 4 === 0 ? "" : "=".repeat(4 - s.length % 4);
-  return atob(s.replace(/-/g, "+").replace(/_/g, "/") + pad);
-}
-
-// src/schemas/folder.ts
-import { z as z2 } from "zod";
-var folderSchema = z2.string().max(256).regex(/^[a-zA-Z0-9_-]+$/, "Folder must be alphanumeric, `_` or `-` (no `/`).").nullable().optional().describe(
-  "Optional folder name used to group items in the dashboard. Part of the SDK lookup key: an item in folder `checkout` named `new-cart` is referenced as `checkout/new-cart` from the SDK."
-);
-
-// src/schemas/metric-name.ts
-import { z as z3 } from "zod";
-var metricNameSchema = z3.string().regex(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?)?$/).max(128);
-
-// src/schemas/configs.ts
-import { z as z4 } from "zod";
-var SEGMENT = /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/;
-var RESERVED_FOLDER = "_default";
-var configNameSchema = z4.string().max(128).refine(
-  (s) => {
-    const parts = s.split(".");
-    if (parts.length !== 2) return false;
-    return parts.every((p, i) => p === RESERVED_FOLDER && i === 0 ? true : SEGMENT.test(p));
-  },
-  {
-    message: "Must be `folder.name` \u2014 exactly two lowercase segments separated by a dot (e.g. `pricing.tiers`)."
-  }
-).describe(
-  "Stable config key in `folder.name` form (two lowercase segments separated by a dot, e.g. `pricing.tiers`). Used by SDKs as `Shipeasy.getConfig('<name>')`. Immutable after create."
-);
-var configKindSchema = z4.enum(CONFIG_KINDS);
-var configEnvSchema = z4.enum(CONFIG_ENVS).describe("Target environment. One of the project's configured envs (`dev`, `stage`, `prod`).");
-var jsonSchemaSchema = z4.record(z4.string(), z4.unknown()).refine((s) => s.type === "object", { message: "Top-level schema type must be 'object'" }).describe(
-  "JSON Schema (draft 2020-12) describing the shape of the config value. Top-level `type` must be `'object'`; every published value is validated against this schema."
-);
-var initialValuesSchema = z4.union([z4.unknown(), z4.record(configEnvSchema, z4.unknown())]).describe(
-  "Initial config value. Either a single JSON object applied to every env, or a `{ env: value }` map seeding per-env values. Must match `schema`. Defaults to `{}` on every env when omitted."
-);
-var configCreateSchema = z4.object({
-  name: configNameSchema,
-  description: z4.string().max(512).optional().describe("Optional free-form description shown in the dashboard. Max 512 chars."),
-  folder: folderSchema,
-  schema: jsonSchemaSchema,
-  value: initialValuesSchema.optional()
-}).describe("Body for `POST /api/admin/configs`. `name` + `schema` required.");
-var configUpdateSchema = z4.object({
-  schema: jsonSchemaSchema.optional().describe(
-    "Replacement schema. When supplied, the new schema is validated against every published value before it lands."
-  ),
-  value: z4.unknown().optional().describe(
-    "Flat value applied to **every** env. Publishes a new version per env. To target one env, use `PUT /{id}/drafts` then `POST /{id}/publish`."
-  ),
-  folder: folderSchema
-}).describe(
-  "Body for `PATCH /api/admin/configs/{id}`. Partial \u2014 only supplied fields change. `value` republishes on every env."
-);
-var configSchemaUpdateSchema = z4.object({ schema: jsonSchemaSchema }).describe("Schema-only update. Does not bump value versions or rebuild KV.");
-var configDraftUpsertSchema = z4.object({
-  env: configEnvSchema,
-  value: z4.unknown().describe("Draft value to stage on `env`. Validated against the config's current schema.")
-}).describe(
-  "Body for `PUT /api/admin/configs/{id}/drafts`. Stages a value for a single env without publishing."
-);
-var configPublishSchema = z4.object({ env: configEnvSchema }).describe(
-  "Body for `POST /api/admin/configs/{id}/publish` and `DELETE /api/admin/configs/{id}/drafts`. Names the target env."
-);
-var configEnvPublishedSchema = z4.object({
-  version: z4.number().int().describe("Monotonically increasing version per env."),
-  publishedAt: z4.string().describe("ISO-8601 publish timestamp."),
-  publishedBy: z4.string().describe("Email/id of the actor who published this version.")
-});
-var configDraftSummarySchema = z4.object({
-  updatedAt: z4.string().describe("ISO-8601 last-edit timestamp on the draft."),
-  authorEmail: z4.string().describe("Email/id of the actor who last edited the draft."),
-  baseVersion: z4.number().int().describe("Published version the draft was forked from.")
-});
-var configResponseSchema = z4.object({
-  id: z4.string().describe("Stable opaque config id (`cfg_\u2026`)."),
-  name: configNameSchema,
-  description: z4.string().nullable(),
-  schema: jsonSchemaSchema,
-  updatedAt: z4.string().describe("ISO-8601 timestamp of last mutation."),
-  envs: z4.record(configEnvSchema, configEnvPublishedSchema).describe("Per-env latest published version metadata."),
-  drafts: z4.record(configEnvSchema, configDraftSummarySchema).describe("Per-env active drafts (if any)."),
-  values: z4.record(configEnvSchema, z4.unknown()).optional().describe("Per-env latest published values (only returned by `GET /{id}`, not list)."),
-  draftValues: z4.record(configEnvSchema, z4.unknown()).optional().describe("Per-env draft values (only returned by `GET /{id}`).")
-});
-var configCreateResponseSchema = z4.object({
-  id: z4.string().describe("Newly assigned config id."),
-  name: configNameSchema
-});
-var configUpdateResponseSchema = z4.object({
-  id: z4.string().describe("Config id that was updated.")
-});
-var configDeleteResponseSchema = z4.object({ ok: z4.literal(true) });
-var configDraftSaveResponseSchema = z4.object({
-  id: z4.string(),
-  env: configEnvSchema,
-  baseVersion: z4.number().int().describe("Published version the draft is based on."),
-  updatedAt: z4.string()
-});
-var configDraftDiscardResponseSchema = z4.object({ ok: z4.literal(true) });
-var configPublishResponseSchema = z4.object({
-  id: z4.string(),
-  env: configEnvSchema,
-  version: z4.number().int().describe("Newly published version on `env`.")
-});
-var configActivityEntrySchema = z4.object({
-  id: z4.string(),
-  action: z4.string().describe("Audit action (e.g. `config.create`, `config.publish`)."),
-  actorEmail: z4.string(),
-  actorType: z4.enum(["user", "cli", "system"]),
-  payload: z4.unknown().nullable(),
-  createdAt: z4.string().describe("ISO-8601 timestamp.")
-});
-var configActivityResponseSchema = z4.array(configActivityEntrySchema).describe("Recent audit rows for one config, newest first.");
-
-// src/schemas/gates.ts
-import { z as z5 } from "zod";
-var gateRuleSchema = z5.object({
-  attr: z5.string().min(1).describe(
-    "Attribute key on the evaluation context (e.g. `country`, `plan`, `email`). Matched case-sensitively against `Shipeasy.checkGate(user, name)` input."
-  ),
-  op: z5.enum([
-    "eq",
-    "neq",
-    "in",
-    "not_in",
-    "gt",
-    "gte",
-    "lt",
-    "lte",
-    "contains",
-    "regex",
-    "semver_gt",
-    "semver_gte",
-    "semver_lt",
-    "semver_lte",
-    "gate_pass",
-    "exp_in"
-  ]).describe(
-    'Comparison operator. Equality: `eq`/`neq`. Set membership: `in`/`not_in` (value is an array). Numeric order: `gt`/`gte`/`lt`/`lte`. Semver order: `semver_gt`/`semver_gte`/`semver_lt`/`semver_lte` (value is a dotted version like `4.2.0`). String: `contains` (substring), `regex` (JS-flavour pattern, value is the pattern string). Cross-resource references (evaluated only on the worker hot path, where both KV blobs load): `gate_pass` (`value` is another gate\'s name \u2014 true when that gate passes for the same caller); `exp_in` (`attr` is a running experiment\'s name, `value` is a group name, `"$holdout"`, or `"$any"` \u2014 true when the caller is in that variant / the universe holdout / any variant).'
-  ),
-  value: z5.unknown().describe(
-    'Operand. Shape depends on `op`: scalar for `eq/neq/gt/gte/lt/lte/contains/semver_*`; array of scalars for `in/not_in`; string pattern for `regex`; referenced gate name for `gate_pass`; group name / `"$holdout"` / `"$any"` for `exp_in`.'
-  )
-}).describe(
-  "Single targeting predicate. A gate's `rules` array is evaluated with AND semantics; use the gatekeeper `stack` for OR / fall-through logic."
-);
-var gateNameSchema = z5.string().regex(
-  /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?)?$/,
-  "lowercase, digits, _/-; optional folder.name shape"
-).max(128).describe(
-  "Stable gate key used by SDKs (`Shipeasy.checkGate(user, '<name>')`). Single segment or `folder.name`. Lowercase letters, digits, `_` or `-`; max 128 chars. Immutable after create \u2014 rename = delete + recreate."
-);
-var rampSchema = z5.object({
-  from: z5.number().int().min(0).max(1e4).describe("Start of the ramp in basis points (0\u201310000)."),
-  to: z5.number().int().min(0).max(1e4).describe("End of the ramp in basis points (0\u201310000)."),
-  startAt: z5.number().int().nonnegative().describe("Ramp start, epoch milliseconds (UTC)."),
-  durationMs: z5.number().int().positive().describe("Ramp length in milliseconds.")
-}).describe(
-  "Linear rollout ramp. The effective rollout % interpolates `from`\u2192`to` over `[startAt, startAt+durationMs]`, clamped outside that window, evaluated against the wall-clock at eval time. Overrides the entry's static `rolloutPct` while present."
-);
-var stackedConditionSchema = z5.object({
-  id: z5.string().min(1).describe(
-    "Client-supplied stable id for the stack entry (used for React keys, audit diffs, and as the default per-condition rollout salt)."
-  ),
-  type: z5.literal("condition").describe("Discriminator. `condition` = rule-based predicate sub-gate."),
-  name: z5.string().optional().describe("Human label shown in the dashboard."),
-  fromTemplate: z5.string().nullable().optional().describe(
-    "Id of the project template this entry was seeded from, or `null` if hand-authored."
-  ),
-  pass: z5.enum(["all", "any"]).optional().describe("Combinator across `rules`. `all` = AND (default), `any` = OR."),
-  rules: z5.array(gateRuleSchema).default([]).describe("Predicates evaluated under `pass`. Empty array = match nothing."),
-  rolloutPct: z5.number().int().min(0).max(1e4).optional().describe(
-    "Per-condition rollout in basis points. After the rules match, the caller is bucketed at this %; in-bucket \u2192 gate `true`, otherwise fall through to the next entry. Absent \u21D2 10000 (100%, every matching caller passes)."
-  ),
-  bucketBy: z5.string().optional().describe("Attribute used to hash the caller into the per-condition bucket. Default `userID`."),
-  salt: z5.string().optional().describe("Per-condition hash salt. Defaults to the entry `id`, then the gate salt."),
-  ramp: rampSchema.optional(),
-  locked: z5.boolean().optional().describe("If `true`, dashboard hides edit controls (e.g. the trailing public-floor entry).")
-}).describe(
-  "Rule-based sub-gate. When the rules match and the caller falls in the per-condition rollout bucket, evaluation short-circuits and the gate returns `true`; otherwise it falls through to the next entry."
-);
-var stackedRolloutSchema = z5.object({
-  id: z5.string().min(1).describe("Client-supplied stable id for the stack entry."),
-  type: z5.literal("rollout").describe("Discriminator. `rollout` = percentage-bucket sub-gate."),
-  name: z5.string().optional().describe("Human label shown in the dashboard."),
-  fromTemplate: z5.string().nullable().optional().describe("Source template id, or `null`."),
-  rolloutPct: z5.number().int().min(0).max(1e4).describe(
-    "Bucket size in basis points (0\u201310000 = 0%\u2013100%). `5000` = 50%, `100` = 1%, allows sub-1% precision."
-  ),
-  bucketBy: z5.string().optional().describe(
-    "Attribute used to hash the caller into a bucket. Defaults to `user.userID`. Use e.g. `accountID` to bucket whole accounts together."
-  ),
-  salt: z5.string().optional().describe(
-    "Per-entry hash salt. Defaults to the gate's salt. Set explicitly to keep two rollouts independent or correlated across gates."
-  ),
-  ramp: rampSchema.optional(),
-  locked: z5.boolean().optional().describe("If `true`, dashboard hides edit controls.")
-}).describe(
-  "Percentage-rollout sub-gate. Hashes `bucketBy` (default `userID`) with `salt` and returns `true` for `rolloutPct/10000` fraction of callers (or the ramp's effective % when `ramp` is set)."
-);
-var stackedGateEntrySchema = z5.discriminatedUnion("type", [stackedConditionSchema, stackedRolloutSchema]).describe(
-  "One entry in the ordered gatekeeper stack. Evaluated top-to-bottom; first matching entry decides. Mix `condition` and `rollout` entries to express `internal-only` + `1% beta` + `50% public` in a single gate."
-);
-var gateMetadataFields = {
-  title: z5.string().max(140).optional().describe("Human-readable title shown in the dashboard. Free-form, no key format constraint."),
-  description: z5.string().max(2e3).optional().describe("Long-form description / runbook. Markdown is rendered in the dashboard."),
-  folder: folderSchema,
-  group: z5.string().max(64).optional().describe("Group label for dashboard organisation (e.g. team or product area)."),
-  owner_email: z5.string().max(190).optional().describe("Owner contact. Displayed verbatim; not used for auth.")
-};
-var gateMetadataPatchSchema = z5.object(gateMetadataFields);
-var gateCreateSchema = z5.object({
-  name: gateNameSchema,
-  enabled: z5.boolean().default(true).describe(
-    "Master switch. Defaults to `true`. Set `false` to create the gate disabled (evaluates to `false` regardless of rules/rollout); flip on via `POST /{id}/enable` or PATCH."
-  ),
-  rollout_pct: z5.number().int().min(0).max(1e4).default(0).describe(
-    "Initial rollout in **basis points** (0\u201310000 = 0%\u2013100%) \u2014 `100` here means **1%**, not 100%. Use `rollout_percent` (0\u2013100) below if you'd rather think in percent. Use `0` to create the gate dark and ramp via PATCH after deploy validation."
-  ),
-  rollout_percent: z5.number().min(0).max(100).optional().describe(
-    "Initial rollout as a **percentage** (0\u2013100, fractional ok). Friendlier alias for `rollout_pct`; converted internally to basis points (e.g. `100` here = 10000 bp = 100%). If both `rollout_pct` and `rollout_percent` are set, `rollout_percent` wins."
-  ),
-  rules: z5.array(gateRuleSchema).default([]).describe(
-    "Targeting predicates. AND-combined. If non-empty, the gate returns `true` only for callers that satisfy every rule **and** fall under `rollout_pct`."
-  ),
-  salt: z5.string().min(1).max(64).optional().describe(
-    "Hash salt for percentage bucketing. Auto-generated if omitted. Provide explicitly to keep a gate's buckets stable across delete/recreate. **Immutable after create** \u2014 there is no PATCH for `salt` because changing it would re-bucket every caller."
-  ),
-  stack: z5.array(stackedGateEntrySchema).nullable().optional().describe(
-    "Optional gatekeeper stack. When provided, takes precedence over `rules` + `rollout_pct` at evaluation time. Omit (or pass `null`) for a flat gate."
-  ),
-  ...gateMetadataFields
-}).describe(
-  "Body for `POST /api/admin/gates`. At minimum supply `name`; everything else has sensible defaults."
-);
-var gateUpdateSchema = z5.object({
-  rollout_pct: z5.number().int().min(0).max(1e4).optional().describe(
-    "New rollout in **basis points** (0\u201310000 = 0%\u2013100%) \u2014 `100` here means **1%**. Use `rollout_percent` (0\u2013100) below for percent. Omit both to leave unchanged."
-  ),
-  rollout_percent: z5.number().min(0).max(100).optional().describe(
-    "New rollout as a **percentage** (0\u2013100). Friendlier alias for `rollout_pct`; converted internally. Wins over `rollout_pct` if both are supplied. Omit both to leave unchanged."
-  ),
-  rules: z5.array(gateRuleSchema).optional().describe(
-    "Replaces the rule list wholesale. To add a value to an `in` rule, send the full new `rules` array with the augmented `value` (e.g. previous `['US','CA']` \u2192 `['US','CA','GB']`)."
-  ),
-  enabled: z5.boolean().optional().describe(
-    "Master switch. `false` makes the gate evaluate to `false` for every caller regardless of `rollout_pct`, `rules`, or `stack` \u2014 use as kill switch."
-  ),
-  stack: z5.array(stackedGateEntrySchema).nullable().optional().describe(
-    "Replaces the gatekeeper stack wholesale. Send `null` to revert to flat `rules` + `rollout_pct` evaluation."
-  ),
-  ...gateMetadataFields
-}).describe(
-  "Body for `PATCH /api/admin/gates/{id}`. Partial \u2014 only supplied fields change. Array fields (`rules`, `stack`) replace, not merge."
-);
-var gateResponseSchema = z5.object({
-  id: z5.string().describe("Stable opaque gate id (`gat_\u2026`)."),
-  name: gateNameSchema,
-  /** D1 stores enabled as 0/1; clients see either form. */
-  enabled: z5.union([z5.boolean(), z5.number().int().min(0).max(1)]).describe("Master switch. Returned as `1`/`0` from D1; treat truthy as enabled."),
-  /** Rollout percentage in basis points (0–10000 = 0%–100%). */
-  rolloutPct: z5.number().int().min(0).max(1e4).describe("Current rollout in basis points (0\u201310000)."),
-  rules: z5.array(gateRuleSchema).optional(),
-  salt: z5.string().optional().describe("Hash salt used for percentage bucketing."),
-  title: z5.string().nullable().optional(),
-  description: z5.string().nullable().optional(),
-  folder: z5.string().nullable().optional(),
-  groupName: z5.string().nullable().optional().describe("Group label (note: `groupName` in response, `group` in request)."),
-  ownerEmail: z5.string().nullable().optional().describe("Owner email (note: `ownerEmail` in response, `owner_email` in request)."),
-  stack: z5.array(stackedGateEntrySchema).nullable().optional(),
-  updatedAt: z5.string().describe("ISO-8601 timestamp of last mutation.")
-});
-var gateCreateResponseSchema = z5.object({
-  id: z5.string().describe("Newly assigned gate id (`gat_\u2026`)."),
-  name: gateNameSchema
-});
-var gateUpdateResponseSchema = z5.object({ id: z5.string().describe("Gate id that was updated.") }).describe("Update returns only the id \u2014 re-fetch via `GET /api/admin/gates` for the full row.");
-var gateDeleteResponseSchema = z5.object({ ok: z5.literal(true) });
-var gateToggleResponseSchema = z5.object({
-  id: z5.string(),
-  enabled: z5.boolean()
-});
-
-// src/schemas/killswitches.ts
-import { z as z6 } from "zod";
-var SWITCH_KEY_RE = /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/;
-var switchKeySchema = z6.string().max(64).regex(SWITCH_KEY_RE, {
-  message: "Switch keys must be lowercase, no dots."
-}).describe(
-  "Single-segment switch key (lowercase letters, digits, `_`/`-`; no dots). Used as the nested switch entry inside a killswitch's `switches` map."
-);
-var killswitchValueSchema = z6.object({
-  value: z6.boolean().describe(
-    "Default boolean delivered when no `switches` entry matches the caller's switch key."
-  ),
-  switches: z6.record(switchKeySchema, z6.boolean()).optional().describe(
-    "Per-switch overrides. When present, a matching key takes precedence over `value` on the client."
-  )
-}).describe("Runtime killswitch payload returned to SDKs.");
-var killswitchCreateSchema = z6.object({
-  name: configNameSchema.describe(
-    "Stable killswitch key in `folder.name` form (two lowercase segments separated by a dot \u2014 e.g. `payments.checkout`). Immutable after create."
-  ),
-  description: z6.string().max(512).optional().describe("Optional free-form description shown in the dashboard. Max 512 chars."),
-  folder: folderSchema,
-  value: z6.boolean().optional().describe(
-    "Default value applied to every env at creation. Defaults to `false`. Use `true` to ship the killswitch pre-tripped."
-  ),
-  switches: z6.record(switchKeySchema, z6.boolean()).optional().describe(
-    "Initial per-switch overrides applied to every env. Empty/omitted leaves the killswitch with only the flat `value`."
-  )
-}).describe("Body for `POST /api/admin/killswitches`. Only `name` is required.");
-var killswitchUpdateSchema = z6.object({
-  description: z6.string().max(512).nullish().describe("New description, or `null` to clear it. Max 512 chars."),
-  folder: folderSchema,
-  value: z6.boolean().optional().describe(
-    "Flat value applied to every env. Publishes a new version per env when set. Omit to leave values unchanged."
-  ),
-  switches: z6.record(switchKeySchema, z6.boolean()).optional().describe(
-    "Replace the switches map wholesale on every env. To edit a single entry on a single env use `PUT /{id}/switch` instead."
-  )
-}).describe(
-  "Body for `PATCH /api/admin/killswitches/{id}`. Partial \u2014 only supplied fields change. `switches` replaces wholesale (no merge)."
-);
-var killswitchSwitchSetSchema = z6.object({
-  env: configEnvSchema.describe("Target environment (`dev`/`stage`/`prod`)."),
-  switchKey: switchKeySchema.describe("Switch key to set."),
-  value: z6.boolean().describe("New boolean value for this `switchKey` on this `env`.")
-}).describe(
-  "Body for `PUT /api/admin/killswitches/{id}/switch`. Sets or updates one switch entry on one env."
-);
-var killswitchValueSetSchema = z6.object({
-  env: configEnvSchema.describe("Target environment whose flat default flips."),
-  value: z6.boolean().describe("New flat default for this env. Existing switches carry forward unchanged.")
-}).describe(
-  "Body for the killswitch quick-toggle. Sets the flat `value` on one env without touching its switches."
-);
-var killswitchSwitchUnsetSchema = z6.object({
-  env: configEnvSchema.describe("Target environment."),
-  switchKey: switchKeySchema.describe("Switch key to remove.")
-}).describe(
-  "Body for `DELETE /api/admin/killswitches/{id}/switch`. Removes one switch entry from one env."
-);
-var killswitchEnvEntrySchema = z6.object({
-  value: z6.boolean().describe("Flat boolean published for this env."),
-  switches: z6.record(switchKeySchema, z6.boolean()).optional(),
-  version: z6.number().int().describe("Monotonically increasing version per env."),
-  publishedAt: z6.string().describe("ISO-8601 publish timestamp for this version.")
-});
-var killswitchResponseSchema = z6.object({
-  id: z6.string().describe("Stable opaque killswitch id."),
-  name: configNameSchema,
-  description: z6.string().nullable().describe("Free-form description or `null`."),
-  updatedAt: z6.string().describe("ISO-8601 timestamp of last mutation."),
-  envs: z6.record(configEnvSchema, killswitchEnvEntrySchema).describe("Per-env latest value, switches, version, and publish timestamp.")
-});
-var killswitchCreateResponseSchema = z6.object({
-  id: z6.string().describe("Newly assigned killswitch id."),
-  name: configNameSchema
-});
-var killswitchUpdateResponseSchema = z6.object({
-  id: z6.string().describe("Killswitch id that was updated.")
-});
-var killswitchDeleteResponseSchema = z6.object({ ok: z6.literal(true) });
-var killswitchSwitchSetResponseSchema = z6.object({
-  id: z6.string(),
-  env: configEnvSchema,
-  switchKey: switchKeySchema,
-  value: z6.boolean()
-});
-var killswitchSwitchUnsetResponseSchema = z6.object({
-  id: z6.string(),
-  env: configEnvSchema,
-  switchKey: switchKeySchema,
-  removed: z6.boolean().describe("`true` if the entry existed and was removed, `false` if no-op.")
-});
-
-// src/schemas/universes.ts
-import { z as z7 } from "zod";
-var universeNameSchema = z7.string().regex(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?)?$/).max(128).describe(
-  "Stable universe key. Single segment or `folder.name`. Lowercase letters, digits, `_` or `-`; max 128 chars. Immutable after create."
-);
-var holdoutRangeSchema = z7.tuple([z7.number().int().min(0).max(9999), z7.number().int().min(0).max(9999)]).refine(([lo, hi]) => lo <= hi, "lo must be <= hi").nullable().describe(
-  "Inclusive `[lo, hi]` bucket range (0\u20139999) reserved as the **holdout** \u2014 callers hashed into this slice are excluded from every experiment in the universe. `null` disables the holdout. Pro plan or higher required."
-);
-var universeCreateSchema = z7.object({
-  name: universeNameSchema,
-  folder: folderSchema,
-  unit_type: z7.string().default("user_id").describe(
-    "Unit of randomisation. Typically `user_id`. Use `account_id` to keep whole accounts in the same group across an experiment."
-  ),
-  holdout_range: holdoutRangeSchema.default(null)
-}).describe("Body for `POST /api/admin/universes`. Only `name` is required.");
-var universeUpdateSchema = z7.object({
-  folder: folderSchema,
-  holdout_range: holdoutRangeSchema.optional()
-}).describe(
-  "Body for `PATCH /api/admin/universes/{id}`. Only `holdout_range` is mutable \u2014 name and unit_type are immutable after create."
-);
-var universeResponseSchema = z7.object({
-  id: z7.string().describe("Stable opaque universe id."),
-  name: universeNameSchema,
-  unitType: z7.string().describe("Unit of randomisation. Snake-case in request (`unit_type`), camelCase in response."),
-  holdoutRange: z7.tuple([z7.number(), z7.number()]).nullable().describe("Reserved holdout bucket range, or `null` if none."),
-  createdAt: z7.string().describe("ISO-8601 timestamp of creation.")
-});
-var universeCreateResponseSchema = z7.object({
-  id: z7.string().describe("Newly assigned universe id."),
-  name: universeNameSchema
-});
-var universeUpdateResponseSchema = z7.object({
-  id: z7.string().describe("Universe id that was updated.")
-});
-var universeDeleteResponseSchema = z7.object({ ok: z7.literal(true) });
-
-// src/schemas/experiments.ts
-import { z as z8 } from "zod";
-var experimentInlineMetricSchema = z8.object({
-  name: metricNameSchema.optional(),
-  query: z8.string().min(1).max(4096).describe("Metric DSL string, e.g. `count_users(checkout_completed)`.")
-});
-var experimentNameSchema = z8.string().regex(/^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?)?$/).max(128).describe(
-  "Stable experiment key. Single segment or `folder.name` (a-z, 0-9, `_`/`-`; max 128 chars). Used by SDKs as `Shipeasy.getExperiment(user, '<name>')`. Immutable after create."
-);
-var experimentGroupSchema = z8.object({
-  name: z8.string().min(1).max(64).describe("Group label (e.g. `control`, `treatment_a`). Max 64 chars."),
-  weight: z8.number().int().min(0).max(1e4).describe(
-    "Allocation weight in basis points (0\u201310000). The sum across all groups must equal exactly **10000** (100%)."
-  ),
-  params: z8.record(z8.string(), z8.unknown()).default({}).describe(
-    "Per-group parameter values delivered to the SDK when a caller is hashed into this group. Keys must match the experiment's `params` schema."
-  )
-}).describe("One variant in the experiment. Weights across all groups must sum to 10000.");
-var paramSchemaSchema = z8.record(z8.string(), z8.enum(["string", "bool", "number"])).describe(
-  "Map of param-name \u2192 scalar type. Defines the shape of `groups[].params`. Example: `{ headline: 'string', show_cta: 'bool' }`."
-);
-var bucketBySchema = z8.string().min(1).max(128).regex(
-  /^[a-zA-Z_][a-zA-Z0-9_]*$/,
-  "Must be a user-attribute name (letters, digits, underscore; not starting with a digit)."
-).describe(
-  "User-attribute name used as the bucketing key \u2014 e.g. `user_id` (default), `session_id`, `device_id`, or a custom attribute like `company_id` to keep a whole org on one variant. Defaults to `user_id` when omitted."
-);
-var experimentCreateSchema = z8.object({
-  name: experimentNameSchema,
-  description: z8.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),
-  hypothesis: z8.string().max(4e3).nullable().default(null).describe("Hypothesis statement shown in the editor. Display-only."),
-  tag: z8.string().max(64).nullable().default(null).describe("Short tag chip rendered next to the name. Display-only."),
-  owner_email: z8.string().max(254).nullable().default(null).describe("Owner email. Display-only."),
-  audience: z8.string().max(256).nullable().default(null).describe("Audience label shown in the editor. Display-only."),
-  bucket_by: bucketBySchema.nullable().default(null),
-  folder: folderSchema,
-  universe: z8.string().min(1).describe(
-    "Name of an existing universe in the project. Returns `422` if the universe doesn't exist."
-  ),
-  targeting_gate: z8.string().nullable().default(null).describe(
-    "Optional gate name. Only callers that pass the gate are enrolled in the experiment."
-  ),
-  allocation_pct: z8.number().int().min(0).max(1e4).default(0).describe(
-    "Share of the (gated) audience allocated to the experiment, in basis points (0\u201310000 = 0%\u2013100%). `0` = unallocated. Immutable while the experiment is running."
-  ),
-  salt: z8.string().min(1).max(64).optional().describe("Hash salt for bucketing. Auto-generated if omitted. Immutable while running."),
-  params: paramSchemaSchema.default({}),
-  groups: z8.array(experimentGroupSchema).min(2).describe(
-    "Two or more variants. Weights must sum to exactly 10000 (100%). Immutable while running."
-  ),
-  significance_threshold: z8.number().min(1e-4).max(0.5).default(0.05).describe(
-    "p-value cutoff used by the analysis pass. Defaults to `0.05`. Values other than 0.05 require Pro plan or higher."
-  ),
-  min_runtime_days: z8.number().int().min(0).max(365).default(0).describe("Minimum days the experiment must run before results are considered conclusive."),
-  min_sample_size: z8.number().int().min(1).default(100).describe("Minimum exposures per group before results are considered conclusive."),
-  sequential_testing: z8.boolean().default(false).describe(
-    "Enable sequential testing (always-valid p-values). Requires Premium plan or higher."
-  ),
-  goal_metric: experimentInlineMetricSchema.optional().describe(
-    "Single goal metric defined inline as a DSL query. The underlying event is auto-created if missing."
-  ),
-  guardrail_metrics: z8.array(experimentInlineMetricSchema).max(10).default([]).describe(
-    "Up to 10 guardrail metrics defined inline. Each is upserted (event + metric) and attached with role=guardrail."
-  )
-}).refine(
-  (e) => e.groups.reduce((s, g) => s + g.weight, 0) === 1e4,
-  "groups weights must sum to exactly 10000"
-).describe(
-  "Body for `POST /api/admin/experiments`. `name`, `universe`, and `groups` (\u22652, weights sum to 10000) required."
-);
-var experimentUpdateSchema = z8.object({
-  name: experimentNameSchema.optional(),
-  description: z8.string().max(2e3).nullable().optional(),
-  hypothesis: z8.string().max(4e3).nullable().optional(),
-  tag: z8.string().max(64).nullable().optional(),
-  owner_email: z8.string().max(254).nullable().optional(),
-  audience: z8.string().max(256).nullable().optional(),
-  bucket_by: bucketBySchema.nullable().optional(),
-  folder: folderSchema,
-  targeting_gate: z8.string().nullable().optional(),
-  allocation_pct: z8.number().int().min(0).max(1e4).optional().describe("Basis-points allocation (0\u201310000). Immutable while the experiment is running."),
-  salt: z8.string().min(1).max(64).optional().describe("Hash salt. Immutable while running."),
-  universe: z8.string().optional().describe(
-    "New universe name. Immutable while running. Returns `422` if the universe doesn't exist."
-  ),
-  params: paramSchemaSchema.optional(),
-  groups: z8.array(experimentGroupSchema).min(2).optional().describe("Replacement groups. Weights must sum to 10000. Immutable while running."),
-  significance_threshold: z8.number().min(1e-4).max(0.5).optional(),
-  min_runtime_days: z8.number().int().min(0).max(365).optional(),
-  min_sample_size: z8.number().int().min(1).optional(),
-  sequential_testing: z8.boolean().optional(),
-  goal_metric: experimentInlineMetricSchema.optional().describe("Replaces the goal metric (event auto-upserted)."),
-  guardrail_metrics: z8.array(experimentInlineMetricSchema).max(10).optional().describe("Replaces the guardrail set wholesale (event auto-upserted per entry).")
-}).describe(
-  "Body for `PATCH /api/admin/experiments/{id}`. Partial \u2014 only supplied fields change. `allocation_pct`, `groups`, `salt`, `universe`, `params` are immutable while the experiment is running (stop first)."
-);
-var experimentStatusUpdateSchema = z8.object({
-  status: z8.enum(["draft", "running", "stopped", "archived"]).describe(
-    "Target status. Allowed transitions: `draft \u2192 running`, `running \u2192 stopped`, `stopped \u2192 archived`, `draft \u2192 archived`, and `archived \u2192 draft` (restore \u2014 only if the experiment never started). Restarting an archived experiment directly is not allowed; restore it to draft first, then start."
-  )
-}).describe("Body for `POST /api/admin/experiments/{id}/status`.");
-var experimentMetricsUpdateSchema = z8.object({
-  metrics: z8.array(
-    z8.object({
-      metric_id: z8.string().describe("Existing metric id in the project."),
-      role: z8.enum(["goal", "guardrail", "secondary"]).describe(
-        "Metric role. `goal` drives the decision, `guardrail` blocks ship if degraded, `secondary` is informational."
-      )
-    })
-  ).describe("Replacement metrics list \u2014 replaces the current attachments wholesale.")
-}).describe(
-  "Body for `POST /api/admin/experiments/{id}/metrics`. Replaces the experiment's metric attachments wholesale. Returns `422` if any `metric_id` is unknown."
-);
-var experimentResponseSchema = z8.object({
-  id: z8.string().describe("Stable opaque experiment id (`exp_\u2026`)."),
-  name: experimentNameSchema,
-  description: z8.string().nullable(),
-  hypothesis: z8.string().nullable(),
-  tag: z8.string().nullable(),
-  ownerEmail: z8.string().nullable(),
-  audience: z8.string().nullable(),
-  bucketBy: bucketBySchema.nullable(),
-  folder: z8.string().nullable(),
-  status: z8.enum(["draft", "running", "stopped", "archived"]),
-  universe: z8.string().describe("Universe name this experiment draws from."),
-  targetingGate: z8.string().nullable(),
-  allocationPct: z8.number().int().describe("Allocation in basis points (0\u201310000)."),
-  salt: z8.string(),
-  params: z8.record(z8.string(), z8.enum(["string", "bool", "number"])),
-  groups: z8.array(experimentGroupSchema),
-  significanceThreshold: z8.number(),
-  minRuntimeDays: z8.number().int(),
-  minSampleSize: z8.number().int(),
-  sequentialTesting: z8.boolean(),
-  startedAt: z8.string().nullable().describe("ISO-8601 timestamp the experiment last transitioned to `running`, or `null`."),
-  stoppedAt: z8.string().nullable().optional(),
-  updatedAt: z8.string()
-});
-var experimentCreateResponseSchema = z8.object({
-  id: z8.string().describe("Newly assigned experiment id."),
-  name: experimentNameSchema
-});
-var experimentUpdateResponseSchema = z8.object({
-  id: z8.string().describe("Experiment id that was updated.")
-});
-var experimentDeleteResponseSchema = z8.object({ ok: z8.literal(true) });
-var experimentStatusResponseSchema = z8.object({
-  id: z8.string(),
-  status: z8.enum(["draft", "running", "stopped", "archived"])
-});
-var experimentMetricsResponseSchema = z8.object({
-  id: z8.string(),
-  metrics: z8.array(
-    z8.object({
-      metric_id: z8.string(),
-      role: z8.enum(["goal", "guardrail", "secondary"])
-    })
-  )
-});
-var experimentResultRowSchema = z8.object({
-  metric: z8.string(),
-  group_name: z8.string(),
-  ds: z8.string().describe("Date slice (`YYYY-MM-DD`)."),
-  n: z8.number().nullable(),
-  mean: z8.number().nullable(),
-  delta_pct: z8.number().nullable(),
-  p_value: z8.number().nullable(),
-  srm_detected: z8.number().nullable().describe("`1` if sample-ratio mismatch detected, else `0`.")
-});
-var experimentResultsResponseSchema = z8.object({
-  experiment: z8.object({
-    id: z8.string(),
-    name: experimentNameSchema,
-    status: z8.enum(["draft", "running", "stopped", "archived"])
-  }),
-  results: z8.array(experimentResultRowSchema)
-});
-var experimentTimeseriesResponseSchema = z8.object({
-  experiment: z8.object({
-    id: z8.string(),
-    name: experimentNameSchema,
-    status: z8.enum(["draft", "running", "stopped", "archived"])
-  }),
-  series: z8.array(experimentResultRowSchema)
-});
-var experimentReanalyzeResponseSchema = z8.object({
-  id: z8.string(),
-  queued: z8.literal(true)
-});
-
-// src/schemas/alert-rules.ts
-import { z as z9 } from "zod";
-var ALERT_COMPARATORS = ["gt", "gte", "lt", "lte"];
-var ALERT_SEVERITIES = ["danger", "warn", "info"];
-var notificationTargetSchema = z9.object({
-  slackChannel: z9.object({
-    id: z9.string().min(1).describe("Slack channel id (e.g. C0123ABCD)."),
-    name: z9.string().min(1).describe("Slack channel name (without the leading #).")
-  }).nullish().describe("Slack channel to post this rule's alert to. Requires a Slack connector."),
-  email: z9.string().email().nullish().describe("Email address to notify for this rule (overrides the default recipient).")
-}).strict();
-var alertRuleCreateSchema = z9.object({
-  name: z9.string().min(1).max(120).describe("Human label for the rule, shown on the alert and the rules list."),
-  metricId: z9.string().min(1).describe("Id of the metric to evaluate."),
-  comparator: z9.enum(ALERT_COMPARATORS).describe("How the metric value is compared to the threshold (gt/gte/lt/lte)."),
-  threshold: z9.number().finite().describe("Threshold the metric value is compared against."),
-  windowHours: z9.number().int().min(1).max(720).default(24).describe("Lookback window (hours) the metric is aggregated over. 1\u2013720."),
-  severity: z9.enum(ALERT_SEVERITIES).default("warn").describe("Severity of the raised alert."),
-  enabled: z9.boolean().default(true).describe("Whether the rule is evaluated by the cron."),
-  notify: notificationTargetSchema.nullish().describe("Where to deliver this rule's alert (Slack channel and/or email target).")
-}).strict();
-var alertRuleUpdateSchema = z9.object({
-  name: z9.string().min(1).max(120),
-  comparator: z9.enum(ALERT_COMPARATORS),
-  threshold: z9.number().finite(),
-  windowHours: z9.number().int().min(1).max(720),
-  severity: z9.enum(ALERT_SEVERITIES),
-  enabled: z9.boolean(),
-  notify: notificationTargetSchema.nullish()
-}).partial().strict();
-export {
-  ALERT_COMPARATORS,
-  ALERT_SEVERITIES,
-  CONFIG_ENVS,
-  CONFIG_KINDS,
-  DEFAULT_PAGE_SIZE,
-  MAX_PAGE_SIZE,
-  SWITCH_KEY_RE,
-  alertRuleCreateSchema,
-  alertRuleUpdateSchema,
-  bucketBySchema,
-  configActivityEntrySchema,
-  configActivityResponseSchema,
-  configCreateResponseSchema,
-  configCreateSchema,
-  configDeleteResponseSchema,
-  configDraftDiscardResponseSchema,
-  configDraftSaveResponseSchema,
-  configDraftUpsertSchema,
-  configEnvSchema,
-  configKindSchema,
-  configNameSchema,
-  configPublishResponseSchema,
-  configPublishSchema,
-  configResponseSchema,
-  configSchemaUpdateSchema,
-  configUpdateResponseSchema,
-  configUpdateSchema,
-  decodeCursor,
-  encodeCursor,
-  experimentCreateResponseSchema,
-  experimentCreateSchema,
-  experimentDeleteResponseSchema,
-  experimentGroupSchema,
-  experimentInlineMetricSchema,
-  experimentMetricsResponseSchema,
-  experimentMetricsUpdateSchema,
-  experimentNameSchema,
-  experimentReanalyzeResponseSchema,
-  experimentResponseSchema,
-  experimentResultsResponseSchema,
-  experimentStatusResponseSchema,
-  experimentStatusUpdateSchema,
-  experimentTimeseriesResponseSchema,
-  experimentUpdateResponseSchema,
-  experimentUpdateSchema,
-  folderSchema,
-  gateCreateResponseSchema,
-  gateCreateSchema,
-  gateDeleteResponseSchema,
-  gateMetadataPatchSchema,
-  gateNameSchema,
-  gateResponseSchema,
-  gateRuleSchema,
-  gateToggleResponseSchema,
-  gateUpdateResponseSchema,
-  gateUpdateSchema,
-  holdoutRangeSchema,
-  jsonSchemaSchema,
-  killswitchCreateResponseSchema,
-  killswitchCreateSchema,
-  killswitchDeleteResponseSchema,
-  killswitchResponseSchema,
-  killswitchSwitchSetResponseSchema,
-  killswitchSwitchSetSchema,
-  killswitchSwitchUnsetResponseSchema,
-  killswitchSwitchUnsetSchema,
-  killswitchUpdateResponseSchema,
-  killswitchUpdateSchema,
-  killswitchValueSchema,
-  killswitchValueSetSchema,
-  metricNameSchema,
-  notificationTargetSchema,
-  pageQuerySchema,
-  paramSchemaSchema,
-  rampSchema,
-  stackedGateEntrySchema,
-  switchKeySchema,
-  universeCreateResponseSchema,
-  universeCreateSchema,
-  universeDeleteResponseSchema,
-  universeNameSchema,
-  universeResponseSchema,
-  universeUpdateResponseSchema,
-  universeUpdateSchema
-};