@shipeasy/openapi 1.4.0 → 1.6.0

package/dist/operations/events.js

@@ -0,0 +1,121 @@
+// src/operations/util.ts
+var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
+var bool = (i, k) => i[k] === void 0 ? void 0 : i[k];
+
+// src/operations/events.ts
+var GROUP = ["events"];
+var PROPS_DESC = `Event properties as a JSON array, e.g. '[{"name":"amount","type":"number","required":true}]'. type is one of string|number|boolean. Replaces the full set on update/approve.`;
+function props(i) {
+  return i.props === void 0 ? void 0 : i.props;
+}
+var eventOperations = [
+  {
+    group: GROUP,
+    name: "list",
+    mutates: false,
+    summary: "List catalogued events",
+    description: "List every catalogued event (including pending auto-discovered names). Pass `pending` to show only the unapproved queue.",
+    params: [{ name: "pending", type: "boolean", description: "Show only pending (unapproved) events." }],
+    examples: [
+      { run: "shipeasy metrics events list" },
+      { note: "Review the auto-discovered queue", run: "shipeasy metrics events list --pending true" }
+    ],
+    run: async (client, i) => {
+      const rows = await client.events.list();
+      return bool(i, "pending") ? rows.filter((e) => e.pending === 1) : rows;
+    }
+  },
+  {
+    group: GROUP,
+    name: "get",
+    mutates: false,
+    summary: "Show one catalogued event",
+    description: "Resolve an event by id, id-prefix, or name and return its full detail.",
+    params: [{ name: "event", type: "string", description: "Event id or name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy metrics events get checkout_completed" }],
+    run: (client, i) => client.events.resolve(i.event)
+  },
+  {
+    group: GROUP,
+    name: "create",
+    mutates: true,
+    summary: "Register a new event",
+    description: "Register a new event name and (optionally) its typed properties.",
+    params: [
+      { name: "name", type: "string", description: "Event name.", required: true, positional: true },
+      { name: "folder", type: "string", description: "Folder to file it under." },
+      { name: "description", type: "string", description: "Human-readable description." },
+      { name: "props", type: "json", description: PROPS_DESC }
+    ],
+    examples: [
+      { run: "shipeasy metrics events create checkout_completed" },
+      { note: "With a typed, required property", run: `shipeasy metrics events create purchase --props '[{"name":"amount","type":"number","required":true}]'` }
+    ],
+    run: (client, i) => client.events.create({
+      name: i.name,
+      folder: str(i, "folder") ?? null,
+      ...i.description ? { description: i.description } : {},
+      properties: props(i) ?? []
+    })
+  },
+  {
+    group: GROUP,
+    name: "update",
+    mutates: true,
+    summary: "Update an event",
+    description: "Update an event's folder, description, or properties (props replace the full set).",
+    params: [
+      { name: "event", type: "string", description: "Event id.", required: true, positional: true },
+      { name: "folder", type: "string", description: "New folder." },
+      { name: "description", type: "string", description: "New description." },
+      { name: "props", type: "json", description: PROPS_DESC }
+    ],
+    examples: [{ run: "shipeasy metrics events update evt_3f9a --folder checkout" }],
+    run: (client, i) => {
+      const patch = {};
+      if (i.folder !== void 0) patch.folder = i.folder;
+      if (i.description !== void 0) patch.description = i.description;
+      const p = props(i);
+      if (p) patch.properties = p;
+      return client.events.update(i.event, patch);
+    }
+  },
+  {
+    group: GROUP,
+    name: "approve",
+    mutates: true,
+    summary: "Approve a pending event",
+    description: "Promote a pending (auto-discovered) event so metrics can query it. Optionally declare its folder/props on approval.",
+    params: [
+      { name: "event", type: "string", description: "Event id.", required: true, positional: true },
+      { name: "folder", type: "string", description: "Folder to file it under." },
+      { name: "description", type: "string", description: "Description." },
+      { name: "props", type: "json", description: PROPS_DESC }
+    ],
+    examples: [{ note: "Promote an auto-discovered event", run: "shipeasy metrics events approve evt_3f9a" }],
+    run: (client, i) => {
+      const body = {};
+      if (i.folder !== void 0) body.folder = i.folder;
+      if (i.description !== void 0) body.description = i.description;
+      const p = props(i);
+      if (p) body.properties = p;
+      return client.events.approve(i.event, body);
+    }
+  },
+  {
+    group: GROUP,
+    name: "archive",
+    mutates: true,
+    summary: "Archive an event",
+    description: "Archive (remove) an event from the catalog by id.",
+    params: [{ name: "event", type: "string", description: "Event id.", required: true, positional: true }],
+    examples: [{ run: "shipeasy metrics events archive evt_3f9a" }],
+    run: async (client, i) => {
+      await client.events.delete(i.event);
+      return { ok: true, archived: i.event };
+    }
+  }
+];
+export {
+  eventOperations
+};

package/dist/operations/experiments.d.ts

@@ -0,0 +1,28 @@
+import { Operation } from './types.js';
+import '../resources/index.js';
+import 'zod/v4/core';
+import 'zod';
+import '../resources/attributes.js';
+import '../transport.js';
+import '../resources/i18n.js';
+import '../resources/projects.js';
+import '../resources/ops.js';
+import '../resources/events.js';
+import '../resources/metrics.js';
+import '../resources/alert-rules.js';
+import '../schemas/alert-rules.js';
+import '../resources/killswitches.js';
+import '../schemas/killswitches.js';
+import '../schemas/pagination.js';
+import '../resources/universes.js';
+import '../schemas/universes.js';
+import '../resources/configs.js';
+import '../schemas/configs.js';
+import '../resources/experiments.js';
+import '../schemas/experiments.js';
+import '../resources/gates.js';
+import '../schemas/gates.js';
+
+declare const experimentOperations: Operation[];
+
+export { experimentOperations };

package/dist/operations/experiments.js

@@ -0,0 +1,280 @@
+// src/operations/util.ts
+var num = (i, k) => i[k] === void 0 ? void 0 : i[k];
+var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
+var bool = (i, k) => i[k] === void 0 ? void 0 : i[k];
+
+// src/operations/experiments.ts
+var GROUP = ["release", "experiments"];
+var DEFAULT_GROUPS = [
+  { name: "control", weight: 5e3, params: {} },
+  { name: "test", weight: 5e3, params: {} }
+];
+var AGGREGATIONS = [
+  "count_users",
+  "count_events",
+  "retention_7d",
+  "retention_30d",
+  "sum",
+  "avg"
+];
+function buildGoalMetric(i) {
+  const event = str(i, "successEvent");
+  if (!event) return void 0;
+  const agg = str(i, "successAggregation") ?? "count_users";
+  const value = str(i, "successValue");
+  switch (agg) {
+    case "count_users":
+      return { query: `count_users(${event})` };
+    case "count_events":
+      return { query: `count(${event})` };
+    case "retention_7d":
+      return { query: `retention_7d(${event})` };
+    case "retention_30d":
+      return { query: `retention_30d(${event})` };
+    case "sum":
+    case "avg":
+      if (!value)
+        throw new Error(
+          `successAggregation '${agg}' requires successValue \u2014 the numeric event property to ${agg} (e.g. "amount")`
+        );
+      return { query: `${agg}(${event}, ${value})` };
+    default:
+      throw new Error(`Unknown successAggregation '${agg}'`);
+  }
+}
+function parseGuardrails(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (typeof entry === "string") {
+      const query = entry.trim();
+      if (query) out.push({ query });
+    } else if (entry && typeof entry === "object") {
+      const o = entry;
+      const query = typeof o.query === "string" ? o.query.trim() : "";
+      if (query)
+        out.push(typeof o.name === "string" && o.name ? { query, name: o.name } : { query });
+    }
+  }
+  return out;
+}
+function computeVerdict(detail, results) {
+  if (results.some((r) => r.srm_detected === 1))
+    return { verdict: "invalid_srm", reason: "sample-ratio mismatch detected" };
+  if (detail.status !== "running") return { verdict: "not_running", reason: `status=${detail.status}` };
+  if (!results.length) return { verdict: "wait", reason: "no data yet" };
+  const withP = results.filter((r) => r.p_value !== null);
+  if (!withP.length) return { verdict: "wait", reason: "no p-values yet" };
+  const best = withP.reduce((a, b) => a.p_value < b.p_value ? a : b);
+  const threshold = detail.significance_threshold ?? 0.05;
+  if (best.p_value < threshold) return { verdict: "ship" };
+  const startedAt = detail.startedAt ?? detail.started_at;
+  const daysRunning = startedAt ? (Date.now() - new Date(startedAt).getTime()) / (1e3 * 60 * 60 * 24) : 0;
+  return daysRunning < (detail.min_runtime_days ?? 0) ? { verdict: "wait", reason: "min runtime not reached" } : { verdict: "hold" };
+}
+var experimentOperations = [
+  {
+    group: GROUP,
+    name: "list",
+    mutates: false,
+    summary: "List experiments",
+    description: "Return every experiment (status, universe, allocation).",
+    params: [],
+    examples: [{ run: "shipeasy release experiments list" }],
+    run: (client) => client.experiments.listAll()
+  },
+  {
+    group: GROUP,
+    name: "create",
+    mutates: true,
+    summary: "Create an experiment",
+    description: "Create an experiment draft with groups, params, optional targeting gate, a success (goal) metric, optional guardrail metrics, and full statistical config. Pass `successEvent` (+ `successAggregation`) to attach the goal metric inline \u2014 required before the experiment can be started. Defaults to a 50/50 control-vs-test split at 100% allocation in the `default` universe. Does NOT start \u2014 call `start`.",
+    params: [
+      { name: "name", type: "string", description: "Experiment name.", required: true, positional: true },
+      { name: "universe", type: "string", description: "Universe name. Defaults to 'default'." },
+      { name: "allocation", type: "number", description: "Allocation percentage, 0\u2013100. Defaults to 100." },
+      { name: "groups", type: "json", description: "Groups as JSON [{name,weight,params}]. weight is basis points." },
+      { name: "params", type: "json", description: "Parameter schema {name: type}." },
+      { name: "targetingGate", type: "string", description: "Targeting gate name." },
+      { name: "bucketBy", type: "string", description: "Attribute to bucket by (defaults to the universe unit)." },
+      { name: "salt", type: "string", description: "Override hash salt." },
+      { name: "successEvent", type: "string", description: "Event name for the inline goal metric. Attaching one makes the draft startable." },
+      { name: "successAggregation", type: "string", description: `Goal-metric reducer. Defaults to count_users.`, enum: [...AGGREGATIONS] },
+      { name: "successValue", type: "string", description: "Numeric event property for sum/avg goal metrics." },
+      { name: "guardrailMetrics", type: "json", description: "Up to 10 guardrail metrics: JSON array of DSL query strings or {query,name}." },
+      { name: "significance", type: "number", description: "Significance threshold (0.0001\u20130.5). Defaults to 0.05." },
+      { name: "minRuntimeDays", type: "number", description: "Minimum runtime in days." },
+      { name: "minSampleSize", type: "number", description: "Minimum sample size." },
+      { name: "sequentialTesting", type: "boolean", description: "Enable sequential testing (always-valid p-values; Premium+)." },
+      { name: "description", type: "string", description: "Human-readable description." }
+    ],
+    examples: [
+      { note: "Default 50/50, full traffic", run: "shipeasy release experiments create pricing-page" },
+      {
+        note: "Attach a goal metric so it's startable",
+        run: "shipeasy release experiments create checkout-cta --universe web --success-event checkout_completed"
+      }
+    ],
+    run: (client, i) => {
+      const goal_metric = buildGoalMetric(i);
+      const guardrail_metrics = parseGuardrails(i.guardrailMetrics);
+      return client.experiments.create({
+        name: i.name,
+        universe: str(i, "universe") ?? "default",
+        allocation_pct: Math.round((num(i, "allocation") ?? 100) * 100),
+        groups: i.groups ?? DEFAULT_GROUPS,
+        params: i.params ?? {},
+        targeting_gate: str(i, "targetingGate") ?? null,
+        ...str(i, "bucketBy") ? { bucket_by: str(i, "bucketBy") } : {},
+        ...str(i, "description") !== void 0 ? { description: str(i, "description") } : {},
+        ...i.salt ? { salt: i.salt } : {},
+        ...num(i, "significance") !== void 0 ? { significance_threshold: num(i, "significance") } : {},
+        ...num(i, "minRuntimeDays") !== void 0 ? { min_runtime_days: num(i, "minRuntimeDays") } : {},
+        ...num(i, "minSampleSize") !== void 0 ? { min_sample_size: num(i, "minSampleSize") } : {},
+        ...bool(i, "sequentialTesting") !== void 0 ? { sequential_testing: bool(i, "sequentialTesting") } : {},
+        ...goal_metric ? { goal_metric } : {},
+        ...guardrail_metrics.length ? { guardrail_metrics } : {}
+      });
+    }
+  },
+  {
+    group: GROUP,
+    name: "update",
+    mutates: true,
+    summary: "Update an experiment",
+    description: "Patch allocation, groups, params, targeting gate, or stats thresholds. Pass `targetingGate` = 'null' to clear it.",
+    params: [
+      { name: "name", type: "string", description: "Experiment name.", required: true, positional: true },
+      { name: "allocation", type: "number", description: "Allocation percentage, 0\u2013100." },
+      { name: "groups", type: "json", description: "Groups as JSON [{name,weight,params}]." },
+      { name: "params", type: "json", description: "Parameter schema {name: type}." },
+      { name: "targetingGate", type: "string", description: "Targeting gate name ('null' to clear)." },
+      { name: "bucketBy", type: "string", description: "Attribute to bucket by (empty string clears)." },
+      { name: "successEvent", type: "string", description: "Attach/replace the goal metric from this event." },
+      { name: "successAggregation", type: "string", description: "Goal-metric reducer (with successEvent).", enum: [...AGGREGATIONS] },
+      { name: "successValue", type: "string", description: "Numeric event property for sum/avg goal metrics." },
+      { name: "guardrailMetrics", type: "json", description: "Replace the guardrail set: JSON array of DSL queries or {query,name}." },
+      { name: "significance", type: "number", description: "Significance threshold (0.0001\u20130.5)." },
+      { name: "minRuntimeDays", type: "number", description: "Minimum runtime in days." },
+      { name: "minSampleSize", type: "number", description: "Minimum sample size." },
+      { name: "sequentialTesting", type: "boolean", description: "Enable sequential testing (always-valid p-values)." }
+    ],
+    examples: [
+      { note: "Dial allocation to 50%", run: "shipeasy release experiments update pricing-page --allocation 50" },
+      { note: "Clear targeting + tighten significance", run: "shipeasy release experiments update checkout-cta --targeting-gate null --significance 0.01" }
+    ],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      const patch = {};
+      const allocation = num(i, "allocation");
+      if (allocation !== void 0) patch.allocation_pct = Math.round(allocation * 100);
+      if (i.groups !== void 0) patch.groups = i.groups;
+      if (i.params !== void 0) patch.params = i.params;
+      if (i.targetingGate !== void 0)
+        patch.targeting_gate = i.targetingGate === "null" ? null : i.targetingGate;
+      if (str(i, "bucketBy") !== void 0) patch.bucket_by = str(i, "bucketBy") || null;
+      if (i.significance !== void 0) patch.significance_threshold = i.significance;
+      if (i.minRuntimeDays !== void 0) patch.min_runtime_days = i.minRuntimeDays;
+      if (i.minSampleSize !== void 0) patch.min_sample_size = i.minSampleSize;
+      if (bool(i, "sequentialTesting") !== void 0) patch.sequential_testing = bool(i, "sequentialTesting");
+      if (i.guardrailMetrics !== void 0) patch.guardrail_metrics = parseGuardrails(i.guardrailMetrics);
+      const goal_metric = buildGoalMetric(i);
+      if (goal_metric) patch.goal_metric = goal_metric;
+      return client.experiments.update(e.id, patch);
+    }
+  },
+  {
+    group: GROUP,
+    name: "start",
+    mutates: true,
+    summary: "Start an experiment",
+    description: "Move an experiment from draft to running.",
+    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release experiments start pricing-page" }],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      return client.experiments.start(e.id);
+    }
+  },
+  {
+    group: GROUP,
+    name: "stop",
+    mutates: true,
+    summary: "Stop a running experiment",
+    description: "Stop a running experiment. Optionally name a `promoteGroup` to record an intent note (actual promotion happens in the dashboard).",
+    params: [
+      { name: "name", type: "string", description: "Experiment name.", required: true, positional: true },
+      { name: "promoteGroup", type: "string", description: "Group to note as the winner to promote." }
+    ],
+    examples: [{ run: "shipeasy release experiments stop pricing-page" }],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      const result = await client.experiments.stop(e.id);
+      const promote = str(i, "promoteGroup");
+      return {
+        ...result,
+        ...promote ? {
+          promote_group_note: `Manual promotion needed: promote group '${promote}' in the dashboard or via PATCH /api/admin/experiments/${e.id}.`
+        } : {}
+      };
+    }
+  },
+  {
+    group: GROUP,
+    name: "archive",
+    mutates: true,
+    summary: "Archive a stopped experiment",
+    description: "Archive (soft-delete) a stopped experiment, hiding it from the default list while preserving results.",
+    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release experiments archive pricing-page" }],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      return client.experiments.archive(e.id);
+    }
+  },
+  {
+    group: GROUP,
+    name: "restore",
+    mutates: true,
+    summary: "Restore an archived experiment to draft",
+    description: "Restore a soft-deleted (archived) experiment back to `draft`. Allowed only if it never started; one that already ran must be cloned instead. Preserves the goal metric.",
+    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release experiments restore pricing-page" }],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      return client.experiments.restore(e.id);
+    }
+  },
+  {
+    group: GROUP,
+    name: "reanalyze",
+    mutates: true,
+    summary: "Re-run the analysis pass",
+    description: "Trigger a fresh analysis pass for an experiment.",
+    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release experiments reanalyze pricing-page" }],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      return client.experiments.reanalyze(e.id);
+    }
+  },
+  {
+    group: GROUP,
+    name: "status",
+    mutates: false,
+    summary: "Show experiment status, verdict, and latest results",
+    description: "Return the experiment, its latest per-metric results (enrolment, deltas, p-values), and a ship/hold/wait/not_running/invalid_srm verdict computed from the goal metric vs the significance threshold and minimum runtime.",
+    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release experiments status pricing-page" }],
+    run: async (client, i) => {
+      const e = await client.experiments.resolve(i.name);
+      const detail = await client.experiments.get(e.id).catch(() => e);
+      const results = await client.experiments.results(e.id).catch(() => []);
+      const { verdict, reason } = computeVerdict(detail, results);
+      return { verdict, ...reason ? { reason } : {}, experiment: detail, results };
+    }
+  }
+];
+export {
+  experimentOperations
+};

package/dist/operations/gates.d.ts

@@ -0,0 +1,28 @@
+import { Operation } from './types.js';
+import '../resources/index.js';
+import 'zod/v4/core';
+import 'zod';
+import '../resources/attributes.js';
+import '../transport.js';
+import '../resources/i18n.js';
+import '../resources/projects.js';
+import '../resources/ops.js';
+import '../resources/events.js';
+import '../resources/metrics.js';
+import '../resources/alert-rules.js';
+import '../schemas/alert-rules.js';
+import '../resources/killswitches.js';
+import '../schemas/killswitches.js';
+import '../schemas/pagination.js';
+import '../resources/universes.js';
+import '../schemas/universes.js';
+import '../resources/configs.js';
+import '../schemas/configs.js';
+import '../resources/experiments.js';
+import '../schemas/experiments.js';
+import '../resources/gates.js';
+import '../schemas/gates.js';
+
+declare const gateOperations: Operation[];
+
+export { gateOperations };

package/dist/operations/gates.js

@@ -0,0 +1,132 @@
+// src/operations/util.ts
+var num = (i, k) => i[k] === void 0 ? void 0 : i[k];
+
+// src/operations/gates.ts
+var ROLLOUT_DESC = "Rollout percentage, 0\u2013100 (converted to basis points internally).";
+var RULES_DESC = `Targeting rules as a JSON array, e.g. '[{"attr":"plan","op":"eq","value":"pro"}]'. AND-combined.`;
+var STACK_DESC = "Gatekeeper stack as a JSON array of ordered first-match-wins tiers (condition/rollout steps, rolloutPct in basis points). Takes precedence over flat rules/rollout. Pass to express internal \u222A beta \u222A public in one gate.";
+var gateOperations = [
+  {
+    group: ["release", "flags"],
+    name: "list",
+    mutates: false,
+    summary: "List all feature gates",
+    description: "Return every feature gate in the project (name, enabled, rollout %), ordered by most recently updated.",
+    params: [],
+    examples: [{ run: "shipeasy release flags list" }],
+    run: (client) => client.gates.listAll()
+  },
+  {
+    group: ["release", "flags"],
+    name: "create",
+    mutates: true,
+    summary: "Create a feature gate",
+    description: "Create a feature gate. A flat gate is `rules` + a single `rollout` %. For tiered rollouts (e.g. 'US @ 50% \u2192 bots @ 30% \u2192 everyone else @ 10%') pass `stack` \u2014 an ordered list of steps evaluated first-match-wins; flat `rules`/`rollout` are then ignored.",
+    params: [
+      { name: "name", type: "string", description: "Gate key (lowercase, digits, _/-).", required: true, positional: true },
+      { name: "rollout", type: "number", description: ROLLOUT_DESC },
+      { name: "rules", type: "json", description: RULES_DESC },
+      { name: "salt", type: "string", description: "Override hash salt (immutable after create)." },
+      { name: "stack", type: "json", description: STACK_DESC }
+    ],
+    examples: [
+      { note: "Off by default; flip it on later", run: "shipeasy release flags create checkout-v2" },
+      {
+        note: "Roll out to 25% of pro-plan users",
+        run: `shipeasy release flags create new-ui --rollout 25 --rules '[{"attr":"plan","op":"eq","value":"pro"}]'`
+      }
+    ],
+    run: (client, i) => client.gates.create({
+      name: i.name,
+      rollout_pct: Math.round((num(i, "rollout") ?? 0) * 100),
+      // Validated at runtime by gateCreateSchema.parse inside gates.create().
+      rules: i.rules ?? [],
+      ...i.salt ? { salt: i.salt } : {},
+      ...i.stack ? { stack: i.stack } : {}
+    })
+  },
+  {
+    group: ["release", "flags"],
+    name: "update",
+    mutates: true,
+    summary: "Update a gate's rollout, rules, stack, or enabled flag",
+    description: "Update a feature gate's rollout, rules, gatekeeper stack, or enabled flag. Pass `stack` to replace the tiered rollout wholesale; array fields replace, they do not merge.",
+    params: [
+      { name: "name", type: "string", description: "Gate name to update.", required: true, positional: true },
+      { name: "rollout", type: "number", description: ROLLOUT_DESC },
+      { name: "rules", type: "json", description: RULES_DESC + " Replaces the existing rules wholesale." },
+      { name: "stack", type: "json", description: STACK_DESC + " Pass null to revert to flat evaluation." },
+      { name: "enabled", type: "boolean", description: "Master switch \u2014 false forces the gate off for every caller." }
+    ],
+    examples: [{ note: "Ramp to 50%", run: "shipeasy release flags update checkout-v2 --rollout 50" }],
+    run: async (client, i) => {
+      const gate = await client.gates.resolve(i.name);
+      const patch = {};
+      const rollout = num(i, "rollout");
+      if (rollout !== void 0) patch.rollout_pct = Math.round(rollout * 100);
+      if (i.rules !== void 0) patch.rules = i.rules;
+      if (i.stack !== void 0) patch.stack = i.stack;
+      if (i.enabled !== void 0) patch.enabled = i.enabled;
+      return client.gates.update(gate.id, patch);
+    }
+  },
+  {
+    group: ["release", "flags"],
+    name: "enable",
+    mutates: true,
+    summary: "Enable a feature gate",
+    description: "Set `enabled: true`, preserving the current rollout %.",
+    params: [{ name: "name", type: "string", description: "Gate name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release flags enable checkout-v2" }],
+    run: async (client, i) => {
+      const gate = await client.gates.resolve(i.name);
+      return client.gates.enable(gate.id);
+    }
+  },
+  {
+    group: ["release", "flags"],
+    name: "disable",
+    mutates: true,
+    summary: "Disable a feature gate (kill switch)",
+    description: "Set `enabled: false` so the gate evaluates to `false` for every caller regardless of rules/rollout.",
+    params: [{ name: "name", type: "string", description: "Gate name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release flags disable checkout-v2" }],
+    run: async (client, i) => {
+      const gate = await client.gates.resolve(i.name);
+      return client.gates.disable(gate.id);
+    }
+  },
+  {
+    group: ["release", "flags"],
+    name: "rollout",
+    mutates: true,
+    summary: "Set rollout percentage (0\u2013100)",
+    description: "Resolve the gate by name and set its rollout percentage (0\u2013100).",
+    params: [
+      { name: "name", type: "string", description: "Gate name.", required: true, positional: true },
+      { name: "pct", type: "number", description: "Rollout percentage, 0\u2013100.", required: true, positional: true }
+    ],
+    examples: [
+      { note: "Ramp to 50%", run: "shipeasy release flags rollout checkout-v2 50" },
+      { note: "Instant kill \u2014 set to 0", run: "shipeasy release flags rollout checkout-v2 0" }
+    ],
+    run: (client, i) => client.gates.setRollout(i.name, num(i, "pct"))
+  },
+  {
+    group: ["release", "flags"],
+    name: "archive",
+    mutates: true,
+    summary: "Archive a feature gate",
+    description: "Archive (soft-delete) a feature gate by name. Refuses if a running experiment references it as a targeting gate.",
+    params: [{ name: "name", type: "string", description: "Gate name.", required: true, positional: true }],
+    examples: [{ run: "shipeasy release flags archive checkout-v2" }],
+    run: async (client, i) => {
+      const gate = await client.gates.resolve(i.name);
+      await client.gates.delete(gate.id);
+      return { ok: true, archived: i.name };
+    }
+  }
+];
+export {
+  gateOperations
+};

package/dist/operations/i18n.d.ts

@@ -0,0 +1,28 @@
+import { Operation } from './types.js';
+import '../resources/index.js';
+import 'zod/v4/core';
+import 'zod';
+import '../resources/attributes.js';
+import '../transport.js';
+import '../resources/i18n.js';
+import '../resources/projects.js';
+import '../resources/ops.js';
+import '../resources/events.js';
+import '../resources/metrics.js';
+import '../resources/alert-rules.js';
+import '../schemas/alert-rules.js';
+import '../resources/killswitches.js';
+import '../schemas/killswitches.js';
+import '../schemas/pagination.js';
+import '../resources/universes.js';
+import '../schemas/universes.js';
+import '../resources/configs.js';
+import '../schemas/configs.js';
+import '../resources/experiments.js';
+import '../schemas/experiments.js';
+import '../resources/gates.js';
+import '../schemas/gates.js';
+
+declare const i18nOperations: Operation[];
+
+export { i18nOperations };