@shipeasy/openapi 1.6.0 → 2.2.0

package/dist/resources/killswitches.js

@@ -1,514 +0,0 @@
-// src/resources/killswitches.ts
-import { z as z4 } from "zod";
-
-// src/schemas/killswitches.ts
-import { z as z3 } from "zod";
-
-// src/schemas/configs.ts
-import { z as z2 } from "zod";
-
-// src/schemas/constants.ts
-var CONFIG_ENVS = ["dev", "staging", "prod"];
-var CONFIG_KINDS = ["config", "killswitch"];
-
-// src/schemas/folder.ts
-import { z } from "zod";
-var folderSchema = z.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/configs.ts
-var SEGMENT = /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/;
-var RESERVED_FOLDER = "_default";
-var configNameSchema = z2.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 = z2.enum(CONFIG_KINDS);
-var configEnvSchema = z2.enum(CONFIG_ENVS).describe("Target environment. One of the project's configured envs (`dev`, `stage`, `prod`).");
-var jsonSchemaSchema = z2.record(z2.string(), z2.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 = z2.union([z2.unknown(), z2.record(configEnvSchema, z2.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 = z2.object({
-  name: configNameSchema,
-  description: z2.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 = z2.object({
-  schema: jsonSchemaSchema.optional().describe(
-    "Replacement schema. When supplied, the new schema is validated against every published value before it lands."
-  ),
-  value: z2.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 = z2.object({ schema: jsonSchemaSchema }).describe("Schema-only update. Does not bump value versions or rebuild KV.");
-var configDraftUpsertSchema = z2.object({
-  env: configEnvSchema,
-  value: z2.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 = z2.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 = z2.object({
-  version: z2.number().int().describe("Monotonically increasing version per env."),
-  publishedAt: z2.string().describe("ISO-8601 publish timestamp."),
-  publishedBy: z2.string().describe("Email/id of the actor who published this version.")
-});
-var configDraftSummarySchema = z2.object({
-  updatedAt: z2.string().describe("ISO-8601 last-edit timestamp on the draft."),
-  authorEmail: z2.string().describe("Email/id of the actor who last edited the draft."),
-  baseVersion: z2.number().int().describe("Published version the draft was forked from.")
-});
-var configResponseSchema = z2.object({
-  id: z2.string().describe("Stable opaque config id (`cfg_\u2026`)."),
-  name: configNameSchema,
-  description: z2.string().nullable(),
-  schema: jsonSchemaSchema,
-  updatedAt: z2.string().describe("ISO-8601 timestamp of last mutation."),
-  envs: z2.record(configEnvSchema, configEnvPublishedSchema).describe("Per-env latest published version metadata."),
-  drafts: z2.record(configEnvSchema, configDraftSummarySchema).describe("Per-env active drafts (if any)."),
-  values: z2.record(configEnvSchema, z2.unknown()).optional().describe("Per-env latest published values (only returned by `GET /{id}`, not list)."),
-  draftValues: z2.record(configEnvSchema, z2.unknown()).optional().describe("Per-env draft values (only returned by `GET /{id}`).")
-});
-var configCreateResponseSchema = z2.object({
-  id: z2.string().describe("Newly assigned config id."),
-  name: configNameSchema
-});
-var configUpdateResponseSchema = z2.object({
-  id: z2.string().describe("Config id that was updated.")
-});
-var configDeleteResponseSchema = z2.object({ ok: z2.literal(true) });
-var configDraftSaveResponseSchema = z2.object({
-  id: z2.string(),
-  env: configEnvSchema,
-  baseVersion: z2.number().int().describe("Published version the draft is based on."),
-  updatedAt: z2.string()
-});
-var configDraftDiscardResponseSchema = z2.object({ ok: z2.literal(true) });
-var configPublishResponseSchema = z2.object({
-  id: z2.string(),
-  env: configEnvSchema,
-  version: z2.number().int().describe("Newly published version on `env`.")
-});
-var configActivityEntrySchema = z2.object({
-  id: z2.string(),
-  action: z2.string().describe("Audit action (e.g. `config.create`, `config.publish`)."),
-  actorEmail: z2.string(),
-  actorType: z2.enum(["user", "cli", "system"]),
-  payload: z2.unknown().nullable(),
-  createdAt: z2.string().describe("ISO-8601 timestamp.")
-});
-var configActivityResponseSchema = z2.array(configActivityEntrySchema).describe("Recent audit rows for one config, newest first.");
-
-// src/schemas/killswitches.ts
-var SWITCH_KEY_RE = /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/;
-var switchKeySchema = z3.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 = z3.object({
-  value: z3.boolean().describe(
-    "Default boolean delivered when no `switches` entry matches the caller's switch key."
-  ),
-  switches: z3.record(switchKeySchema, z3.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 = z3.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: z3.string().max(512).optional().describe("Optional free-form description shown in the dashboard. Max 512 chars."),
-  folder: folderSchema,
-  value: z3.boolean().optional().describe(
-    "Default value applied to every env at creation. Defaults to `false`. Use `true` to ship the killswitch pre-tripped."
-  ),
-  switches: z3.record(switchKeySchema, z3.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 = z3.object({
-  description: z3.string().max(512).nullish().describe("New description, or `null` to clear it. Max 512 chars."),
-  folder: folderSchema,
-  value: z3.boolean().optional().describe(
-    "Flat value applied to every env. Publishes a new version per env when set. Omit to leave values unchanged."
-  ),
-  switches: z3.record(switchKeySchema, z3.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 = z3.object({
-  env: configEnvSchema.describe("Target environment (`dev`/`stage`/`prod`)."),
-  switchKey: switchKeySchema.describe("Switch key to set."),
-  value: z3.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 = z3.object({
-  env: configEnvSchema.describe("Target environment whose flat default flips."),
-  value: z3.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 = z3.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 = z3.object({
-  value: z3.boolean().describe("Flat boolean published for this env."),
-  switches: z3.record(switchKeySchema, z3.boolean()).optional(),
-  version: z3.number().int().describe("Monotonically increasing version per env."),
-  publishedAt: z3.string().describe("ISO-8601 publish timestamp for this version.")
-});
-var killswitchResponseSchema = z3.object({
-  id: z3.string().describe("Stable opaque killswitch id."),
-  name: configNameSchema,
-  description: z3.string().nullable().describe("Free-form description or `null`."),
-  updatedAt: z3.string().describe("ISO-8601 timestamp of last mutation."),
-  envs: z3.record(configEnvSchema, killswitchEnvEntrySchema).describe("Per-env latest value, switches, version, and publish timestamp.")
-});
-var killswitchCreateResponseSchema = z3.object({
-  id: z3.string().describe("Newly assigned killswitch id."),
-  name: configNameSchema
-});
-var killswitchUpdateResponseSchema = z3.object({
-  id: z3.string().describe("Killswitch id that was updated.")
-});
-var killswitchDeleteResponseSchema = z3.object({ ok: z3.literal(true) });
-var killswitchSwitchSetResponseSchema = z3.object({
-  id: z3.string(),
-  env: configEnvSchema,
-  switchKey: switchKeySchema,
-  value: z3.boolean()
-});
-var killswitchSwitchUnsetResponseSchema = z3.object({
-  id: z3.string(),
-  env: configEnvSchema,
-  switchKey: switchKeySchema,
-  removed: z3.boolean().describe("`true` if the entry existed and was removed, `false` if no-op.")
-});
-
-// src/transport.ts
-var ApiError = class extends Error {
-  constructor(message, status) {
-    super(message);
-    this.status = status;
-    this.name = "ApiError";
-  }
-  status;
-};
-
-// src/resources/killswitches.ts
-var killswitchListResponseSchema = z4.object({
-  data: z4.array(killswitchResponseSchema),
-  next_cursor: z4.string().nullable()
-});
-var BASE = "/api/admin/killswitches";
-function killswitchesClient(t) {
-  async function list(opts = {}) {
-    const query = {};
-    if (opts.limit !== void 0) query.limit = String(opts.limit);
-    if (opts.cursor) query.cursor = opts.cursor;
-    return t.request("GET", BASE, void 0, query);
-  }
-  async function listAll() {
-    const out = [];
-    let cursor;
-    do {
-      const page = await list({ limit: 500, cursor });
-      out.push(...page.data);
-      cursor = page.next_cursor ?? void 0;
-    } while (cursor);
-    return out;
-  }
-  async function resolve(idOrName) {
-    try {
-      return await t.request("GET", `${BASE}/${idOrName}`);
-    } catch (err) {
-      if (!(err instanceof ApiError) || err.status !== 404) throw err;
-    }
-    const all = await listAll();
-    const found = all.find((k) => k.name === idOrName);
-    if (!found) throw new ApiError(`Killswitch '${idOrName}' not found`, 404);
-    return found;
-  }
-  return {
-    list,
-    listAll,
-    resolve,
-    get: (id) => t.request("GET", `${BASE}/${id}`),
-    create: (input) => t.request("POST", BASE, killswitchCreateSchema.parse(input)),
-    update: (id, input) => t.request("PATCH", `${BASE}/${id}`, killswitchUpdateSchema.parse(input)),
-    delete: (id) => t.request("DELETE", `${BASE}/${id}`),
-    setSwitch: (id, input) => t.request("PUT", `${BASE}/${id}/switch`, killswitchSwitchSetSchema.parse(input)),
-    unsetSwitch: (id, input) => t.request("DELETE", `${BASE}/${id}/switch`, killswitchSwitchUnsetSchema.parse(input))
-  };
-}
-var SAMPLE_KS = {
-  id: "ksw_01j7w9d8h2k4m6n8p0q2r4s6t8",
-  name: "payments.checkout",
-  description: "Master kill for the checkout flow. Trip to fall back to the legacy provider.",
-  updatedAt: "2026-05-09T18:22:11.000Z",
-  envs: {
-    dev: { value: false, version: 3, publishedAt: "2026-05-09T18:22:11.000Z" },
-    stage: { value: false, version: 3, publishedAt: "2026-05-09T18:22:11.000Z" },
-    prod: {
-      value: false,
-      switches: { eu_region: true },
-      version: 5,
-      publishedAt: "2026-05-09T18:22:11.000Z"
-    }
-  }
-};
-var killswitchesResource = {
-  name: "killswitches",
-  basePath: BASE,
-  describeOne: "killswitch",
-  describeMany: "killswitches",
-  tag: {
-    name: "Killswitches",
-    description: [
-      "Killswitches: per-env boolean overrides for kill-style operational toggles. Optimised for incident response \u2014 no rules, no rollout, just a flat boolean (plus optional per-key overrides) versioned per environment.",
-      "",
-      "**Identity.** Each killswitch is keyed by `name` in `folder.name` form (e.g. `payments.checkout`). Immutable after create.",
-      "",
-      "**Per-env values.** Every killswitch stores one version stream per env (`dev`, `stage`, `prod`). A `PATCH` with `value`/`switches` applies to **every** env in one shot (publishes a new version per env). To touch a single env, use `PUT /{id}/switch` and friends.",
-      "",
-      "**Switches map.** Optional `switches: { key: bool }` overrides the flat `value` for specific named call sites \u2014 useful for region/feature-scoped kills.",
-      "",
-      "**Versioning.** Each publish (create, update, set-switch, unset-switch) bumps the per-env `version` monotonically. SDKs deliver the latest published version."
-    ].join("\n")
-  },
-  schemas: {
-    create: killswitchCreateSchema,
-    update: killswitchUpdateSchema,
-    setSwitch: killswitchSwitchSetSchema,
-    unsetSwitch: killswitchSwitchUnsetSchema
-  },
-  actions: [
-    { name: "setSwitch", description: "Set or update one switch entry on one env" },
-    { name: "unsetSwitch", description: "Remove one switch entry from one env" }
-  ],
-  endpoints: [
-    {
-      operationId: "listKillswitches",
-      method: "GET",
-      path: "",
-      summary: "List killswitches",
-      description: "Returns a single page of killswitches ordered by `updated_at desc, id desc`. Each row includes the latest published `value`/`switches`/`version` per env.",
-      response: killswitchListResponseSchema,
-      examples: { response: { data: [SAMPLE_KS], next_cursor: null } },
-      useCase: "Snapshot every killswitch in the project \u2014 e.g. to render an incident-response runbook listing every kill and its current trip state."
-    },
-    {
-      operationId: "getKillswitch",
-      method: "GET",
-      path: "/{id}",
-      summary: "Get one killswitch",
-      description: "Returns the killswitch metadata plus the latest published `value`/`switches`/`version` per env.",
-      pathParams: { id: "Stable opaque killswitch id (`ksw_\u2026`)." },
-      response: killswitchResponseSchema,
-      examples: { response: SAMPLE_KS },
-      useCase: "Fetch the current state of one killswitch \u2014 e.g. to verify a trip propagated before declaring an incident mitigated."
-    },
-    {
-      operationId: "createKillswitch",
-      method: "POST",
-      path: "",
-      summary: "Create a killswitch",
-      description: [
-        "Creates a new killswitch with `value` (default `false`) applied to **every** env at version 1.",
-        "",
-        "Returns `409` if `name` already exists in the project."
-      ].join("\n"),
-      successStatus: 201,
-      request: killswitchCreateSchema,
-      response: killswitchCreateResponseSchema,
-      examples: {
-        requestExamples: {
-          minimal: {
-            summary: "Minimal \u2014 name only, untripped",
-            description: "Smallest valid body. Creates a killswitch with `value: false` on every env.",
-            value: { name: "payments.checkout" }
-          },
-          preTripped: {
-            summary: "Pre-tripped on create",
-            description: "Ship the killswitch already tripped (`value: true`) \u2014 useful when provisioning a kill ahead of a deploy you want to ship with the feature off.",
-            value: {
-              name: "payments.checkout",
-              description: "Master kill for the new checkout flow.",
-              value: true
-            }
-          },
-          withSwitches: {
-            summary: "With per-region switches",
-            description: "Seed a `switches` map so specific named call sites can be tripped independently of the flat `value`.",
-            value: {
-              name: "payments.checkout",
-              value: false,
-              switches: { eu_region: true, apac_region: false }
-            }
-          }
-        },
-        response: { id: "ksw_01j7w9d8h2k4m6n8p0q2r4s6t8", name: "payments.checkout" }
-      },
-      useCase: [
-        '- **Untripped create** \u2014 `{ "name": "payments.checkout" }`. Provision the kill ahead of an incident.',
-        '- **Pre-tripped** \u2014 `{ "value": true }` to ship the killswitch already engaged.',
-        "- **With switches** \u2014 seed `switches` to carve out per-region/per-tenant kills from day one."
-      ].join("\n")
-    },
-    {
-      operationId: "updateKillswitch",
-      method: "PATCH",
-      path: "/{id}",
-      summary: "Update a killswitch",
-      description: [
-        "Partial update applied to **every** env. Setting `value`/`switches` publishes a new version per env. Description-only patches don't bump versions.",
-        "",
-        "To change a single switch on a single env, use `PUT /{id}/switch` instead."
-      ].join("\n"),
-      pathParams: { id: "Stable opaque killswitch id." },
-      request: killswitchUpdateSchema,
-      response: killswitchUpdateResponseSchema,
-      examples: {
-        requestExamples: {
-          trip: {
-            summary: "Trip the killswitch on every env",
-            description: "Sets `value: true` on dev/stage/prod, bumping each env's version by one.",
-            value: { value: true }
-          },
-          untrip: {
-            summary: "Untrip on every env",
-            description: "Sets `value: false` on every env.",
-            value: { value: false }
-          },
-          replaceSwitches: {
-            summary: "Replace switches map",
-            description: "Replaces the per-key overrides wholesale on every env. Pass `{}` to clear.",
-            value: { switches: { eu_region: true, apac_region: true } }
-          },
-          updateDescription: {
-            summary: "Description-only update",
-            description: "Doesn't bump versions or trigger a republish \u2014 only metadata changes.",
-            value: { description: "Master kill \u2014 owner: payments-platform" }
-          }
-        },
-        response: { id: "ksw_01j7w9d8h2k4m6n8p0q2r4s6t8" }
-      },
-      useCase: [
-        '- **Trip everywhere** \u2014 `{ "value": true }`. Kills the feature across dev/stage/prod in one call.',
-        '- **Untrip everywhere** \u2014 `{ "value": false }`.',
-        "- **Replace switches** \u2014 send the full new map; per-key edits use `PUT /{id}/switch`.",
-        "- **Update description** \u2014 metadata-only patches don't bump versions."
-      ].join("\n")
-    },
-    {
-      operationId: "deleteKillswitch",
-      method: "DELETE",
-      path: "/{id}",
-      summary: "Delete a killswitch",
-      description: "Soft-deletes the killswitch and rebuilds the project's flags KV blob so SDKs stop seeing it.",
-      pathParams: { id: "Stable opaque killswitch id." },
-      response: killswitchDeleteResponseSchema,
-      examples: { response: { ok: true } },
-      useCase: "Tear down a killswitch after the feature it protected has been removed."
-    },
-    {
-      operationId: "setKillswitchSwitch",
-      method: "PUT",
-      path: "/{id}/switch",
-      summary: "Set one switch entry",
-      description: [
-        "Sets or updates a single `switchKey` on a single `env`. Publishes one new version on that env only \u2014 other envs untouched.",
-        "",
-        "Use this for surgical per-env, per-key flips during incident response (e.g. trip `eu_region` on prod without touching the flat `value` or other envs)."
-      ].join("\n"),
-      pathParams: { id: "Stable opaque killswitch id." },
-      request: killswitchSwitchSetSchema,
-      response: killswitchSwitchSetResponseSchema,
-      examples: {
-        requestExamples: {
-          tripRegion: {
-            summary: "Trip eu_region on prod",
-            description: "Sets `switches.eu_region = true` on prod only. Other envs and the flat `value` are unchanged.",
-            value: { env: "prod", switchKey: "eu_region", value: true }
-          },
-          untripRegion: {
-            summary: "Untrip eu_region on prod",
-            description: "Flip the same entry back off without removing it from the map.",
-            value: { env: "prod", switchKey: "eu_region", value: false }
-          }
-        },
-        response: {
-          id: "ksw_01j7w9d8h2k4m6n8p0q2r4s6t8",
-          env: "prod",
-          switchKey: "eu_region",
-          value: true
-        }
-      },
-      useCase: [
-        '- **Trip a region** \u2014 `{ "env": "prod", "switchKey": "eu_region", "value": true }`.',
-        "- **Untrip without removing** \u2014 same payload with `value: false`. To remove the entry entirely use `DELETE /{id}/switch`."
-      ].join("\n")
-    },
-    {
-      operationId: "unsetKillswitchSwitch",
-      method: "DELETE",
-      path: "/{id}/switch",
-      summary: "Remove one switch entry",
-      description: [
-        "Removes a single `switchKey` from the `switches` map on a single `env`. Publishes a new version on that env.",
-        "",
-        "Returns `{ removed: false }` if the entry didn't exist (idempotent no-op)."
-      ].join("\n"),
-      pathParams: { id: "Stable opaque killswitch id." },
-      request: killswitchSwitchUnsetSchema,
-      response: killswitchSwitchUnsetResponseSchema,
-      examples: {
-        requestExamples: {
-          removeRegion: {
-            summary: "Remove eu_region from prod",
-            description: "Drops the `eu_region` override on prod so the flat `value` applies again.",
-            value: { env: "prod", switchKey: "eu_region" }
-          }
-        },
-        response: {
-          id: "ksw_01j7w9d8h2k4m6n8p0q2r4s6t8",
-          env: "prod",
-          switchKey: "eu_region",
-          removed: true
-        }
-      },
-      useCase: "Clean up a per-region override after the incident is resolved so the flat `value` governs again."
-    }
-  ]
-};
-export {
-  killswitchesClient,
-  killswitchesResource
-};

package/dist/resources/metrics.d.ts

@@ -1,54 +0,0 @@
-import { Transport } from '../transport.js';
-
-/**
- * Metric definitions — the event-backed queries that power tracking dashboards
- * and experiment success/guardrail metrics. A metric pins one event, one
- * aggregation, and (for sum/avg) a value path, expressed as the metric query
- * DSL or its typed IR form.
- *
- * The admin endpoint accepts either `query` (the DSL string) or `query_ir`
- * (the typed IR). The CLI's vendored DSL parser turns `--query` into IR
- * client-side for an early error; the server validates either form, so the
- * registry op can pass `query` straight through and stay worker-safe (no
- * parser bundled into the shared registry).
- */
-interface Metric {
-    id: string;
-    name: string;
-    folder: string | null;
-    eventName: string;
-    aggregation: string;
-    valuePath: string | null;
-    queryIr?: unknown;
-    [key: string]: unknown;
-}
-interface MetricCreateInput {
-    name: string;
-    event_name: string;
-    folder?: string | null;
-    winsorize_pct?: number;
-    min_detectable_effect?: number | null;
-    /** Metric query DSL string, e.g. `sum(purchase, amount)`. */
-    query?: string;
-    /** Typed IR form (alternative to `query`). */
-    query_ir?: unknown;
-}
-interface MetricsClient {
-    /** Every metric in the project (the list endpoint is not paginated). */
-    list(): Promise<Metric[]>;
-    /** Fetch one metric by its full id. */
-    get(id: string): Promise<Metric>;
-    /** Resolve by exact id, unique id-prefix, or exact (unique) name. */
-    resolve(idOrName: string): Promise<Metric>;
-    create(input: MetricCreateInput): Promise<{
-        id: string;
-        name: string;
-    }>;
-    /** Soft-delete (the user-facing verb is `archive`). */
-    delete(id: string): Promise<{
-        ok: true;
-    }>;
-}
-declare function metricsClient(t: Transport): MetricsClient;
-
-export { type Metric, type MetricCreateInput, type MetricsClient, metricsClient };

package/dist/resources/metrics.js

@@ -1,40 +0,0 @@
-// src/transport.ts
-var ApiError = class extends Error {
-  constructor(message, status) {
-    super(message);
-    this.status = status;
-    this.name = "ApiError";
-  }
-  status;
-};
-
-// src/resources/metrics.ts
-var BASE = "/api/admin/metrics";
-function metricsClient(t) {
-  async function list() {
-    return t.request("GET", BASE);
-  }
-  async function resolve(idOrName) {
-    const all = await list();
-    const byId = all.find((m) => m.id === idOrName);
-    if (byId) return byId;
-    const byPrefix = all.filter((m) => m.id.startsWith(idOrName));
-    if (byPrefix.length === 1) return byPrefix[0];
-    if (byPrefix.length > 1) throw new ApiError(`Metric id prefix '${idOrName}' is ambiguous`, 400);
-    const byName = all.filter((m) => m.name === idOrName);
-    if (byName.length === 1) return byName[0];
-    if (byName.length > 1)
-      throw new ApiError(`Metric name '${idOrName}' is ambiguous \u2014 pass an id`, 400);
-    throw new ApiError(`Metric '${idOrName}' not found`, 404);
-  }
-  return {
-    list,
-    resolve,
-    get: (id) => t.request("GET", `${BASE}/${id}`),
-    create: (input) => t.request("POST", BASE, input),
-    delete: (id) => t.request("DELETE", `${BASE}/${id}`)
-  };
-}
-export {
-  metricsClient
-};