@shipeasy/openapi 1.2.0 → 1.5.0

package/dist/resources/index.d.ts

@@ -80,6 +80,8 @@ declare const RESOURCE_REGISTRY: readonly [{
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: zod.ZodUnknown;
             }, zod_v4_core.$strip>>>;
@@ -110,9 +112,20 @@ declare const RESOURCE_REGISTRY: readonly [{
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: zod.ZodUnknown;
                 }, zod_v4_core.$strip>>>;
+                rolloutPct: zod.ZodOptional<zod.ZodNumber>;
+                bucketBy: zod.ZodOptional<zod.ZodString>;
+                salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>, zod.ZodObject<{
                 id: zod.ZodString;
@@ -122,6 +135,12 @@ declare const RESOURCE_REGISTRY: readonly [{
                 rolloutPct: zod.ZodNumber;
                 bucketBy: zod.ZodOptional<zod.ZodString>;
                 salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>], "type">>>>;
         }, zod_v4_core.$strip>;
@@ -150,6 +169,8 @@ declare const RESOURCE_REGISTRY: readonly [{
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: zod.ZodUnknown;
             }, zod_v4_core.$strip>>>;
@@ -180,9 +201,20 @@ declare const RESOURCE_REGISTRY: readonly [{
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: zod.ZodUnknown;
                 }, zod_v4_core.$strip>>>;
+                rolloutPct: zod.ZodOptional<zod.ZodNumber>;
+                bucketBy: zod.ZodOptional<zod.ZodString>;
+                salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>, zod.ZodObject<{
                 id: zod.ZodString;
@@ -192,6 +224,12 @@ declare const RESOURCE_REGISTRY: readonly [{
                 rolloutPct: zod.ZodNumber;
                 bucketBy: zod.ZodOptional<zod.ZodString>;
                 salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>], "type">>>>;
         }, zod_v4_core.$strip>;
@@ -232,6 +270,8 @@ declare const RESOURCE_REGISTRY: readonly [{
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: zod.ZodUnknown;
                 }, zod_v4_core.$strip>>>;
@@ -267,9 +307,20 @@ declare const RESOURCE_REGISTRY: readonly [{
                             semver_gte: "semver_gte";
                             semver_lt: "semver_lt";
                             semver_lte: "semver_lte";
+                            gate_pass: "gate_pass";
+                            exp_in: "exp_in";
                         }>;
                         value: zod.ZodUnknown;
                     }, zod_v4_core.$strip>>>;
+                    rolloutPct: zod.ZodOptional<zod.ZodNumber>;
+                    bucketBy: zod.ZodOptional<zod.ZodString>;
+                    salt: zod.ZodOptional<zod.ZodString>;
+                    ramp: zod.ZodOptional<zod.ZodObject<{
+                        from: zod.ZodNumber;
+                        to: zod.ZodNumber;
+                        startAt: zod.ZodNumber;
+                        durationMs: zod.ZodNumber;
+                    }, zod_v4_core.$strip>>;
                     locked: zod.ZodOptional<zod.ZodBoolean>;
                 }, zod_v4_core.$strip>, zod.ZodObject<{
                     id: zod.ZodString;
@@ -279,6 +330,12 @@ declare const RESOURCE_REGISTRY: readonly [{
                     rolloutPct: zod.ZodNumber;
                     bucketBy: zod.ZodOptional<zod.ZodString>;
                     salt: zod.ZodOptional<zod.ZodString>;
+                    ramp: zod.ZodOptional<zod.ZodObject<{
+                        from: zod.ZodNumber;
+                        to: zod.ZodNumber;
+                        startAt: zod.ZodNumber;
+                        durationMs: zod.ZodNumber;
+                    }, zod_v4_core.$strip>>;
                     locked: zod.ZodOptional<zod.ZodBoolean>;
                 }, zod_v4_core.$strip>], "type">>>>;
                 updatedAt: zod.ZodString;
@@ -348,6 +405,8 @@ declare const RESOURCE_REGISTRY: readonly [{
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: zod.ZodUnknown;
             }, zod_v4_core.$strip>>>;
@@ -378,9 +437,20 @@ declare const RESOURCE_REGISTRY: readonly [{
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: zod.ZodUnknown;
                 }, zod_v4_core.$strip>>>;
+                rolloutPct: zod.ZodOptional<zod.ZodNumber>;
+                bucketBy: zod.ZodOptional<zod.ZodString>;
+                salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>, zod.ZodObject<{
                 id: zod.ZodString;
@@ -390,6 +460,12 @@ declare const RESOURCE_REGISTRY: readonly [{
                 rolloutPct: zod.ZodNumber;
                 bucketBy: zod.ZodOptional<zod.ZodString>;
                 salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>], "type">>>>;
         }, zod_v4_core.$strip>;
@@ -515,6 +591,8 @@ declare const RESOURCE_REGISTRY: readonly [{
                     semver_gte: "semver_gte";
                     semver_lt: "semver_lt";
                     semver_lte: "semver_lte";
+                    gate_pass: "gate_pass";
+                    exp_in: "exp_in";
                 }>;
                 value: zod.ZodUnknown;
             }, zod_v4_core.$strip>>>;
@@ -545,9 +623,20 @@ declare const RESOURCE_REGISTRY: readonly [{
                         semver_gte: "semver_gte";
                         semver_lt: "semver_lt";
                         semver_lte: "semver_lte";
+                        gate_pass: "gate_pass";
+                        exp_in: "exp_in";
                     }>;
                     value: zod.ZodUnknown;
                 }, zod_v4_core.$strip>>>;
+                rolloutPct: zod.ZodOptional<zod.ZodNumber>;
+                bucketBy: zod.ZodOptional<zod.ZodString>;
+                salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>, zod.ZodObject<{
                 id: zod.ZodString;
@@ -557,6 +646,12 @@ declare const RESOURCE_REGISTRY: readonly [{
                 rolloutPct: zod.ZodNumber;
                 bucketBy: zod.ZodOptional<zod.ZodString>;
                 salt: zod.ZodOptional<zod.ZodString>;
+                ramp: zod.ZodOptional<zod.ZodObject<{
+                    from: zod.ZodNumber;
+                    to: zod.ZodNumber;
+                    startAt: zod.ZodNumber;
+                    durationMs: zod.ZodNumber;
+                }, zod_v4_core.$strip>>;
                 locked: zod.ZodOptional<zod.ZodBoolean>;
             }, zod_v4_core.$strip>], "type">>>>;
         }, zod_v4_core.$strip>;
@@ -709,11 +804,7 @@ declare const RESOURCE_REGISTRY: readonly [{
             tag: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
             owner_email: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
             audience: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
-            bucket_by: zod.ZodDefault<zod.ZodNullable<zod.ZodEnum<{
-                user_id: "user_id";
-                session_id: "session_id";
-                device_id: "device_id";
-            }>>>;
+            bucket_by: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
             folder: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             universe: zod.ZodString;
             targeting_gate: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
@@ -749,11 +840,7 @@ declare const RESOURCE_REGISTRY: readonly [{
             tag: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             owner_email: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             audience: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
-            bucket_by: zod.ZodOptional<zod.ZodNullable<zod.ZodEnum<{
-                user_id: "user_id";
-                session_id: "session_id";
-                device_id: "device_id";
-            }>>>;
+            bucket_by: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             folder: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             targeting_gate: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             allocation_pct: zod.ZodOptional<zod.ZodNumber>;
@@ -814,11 +901,7 @@ declare const RESOURCE_REGISTRY: readonly [{
                 tag: zod.ZodNullable<zod.ZodString>;
                 ownerEmail: zod.ZodNullable<zod.ZodString>;
                 audience: zod.ZodNullable<zod.ZodString>;
-                bucketBy: zod.ZodNullable<zod.ZodEnum<{
-                    user_id: "user_id";
-                    session_id: "session_id";
-                    device_id: "device_id";
-                }>>;
+                bucketBy: zod.ZodNullable<zod.ZodString>;
                 folder: zod.ZodNullable<zod.ZodString>;
                 status: zod.ZodEnum<{
                     draft: "draft";
@@ -901,11 +984,7 @@ declare const RESOURCE_REGISTRY: readonly [{
             tag: zod.ZodNullable<zod.ZodString>;
             ownerEmail: zod.ZodNullable<zod.ZodString>;
             audience: zod.ZodNullable<zod.ZodString>;
-            bucketBy: zod.ZodNullable<zod.ZodEnum<{
-                user_id: "user_id";
-                session_id: "session_id";
-                device_id: "device_id";
-            }>>;
+            bucketBy: zod.ZodNullable<zod.ZodString>;
             folder: zod.ZodNullable<zod.ZodString>;
             status: zod.ZodEnum<{
                 draft: "draft";
@@ -980,11 +1059,7 @@ declare const RESOURCE_REGISTRY: readonly [{
             tag: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
             owner_email: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
             audience: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
-            bucket_by: zod.ZodDefault<zod.ZodNullable<zod.ZodEnum<{
-                user_id: "user_id";
-                session_id: "session_id";
-                device_id: "device_id";
-            }>>>;
+            bucket_by: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
             folder: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             universe: zod.ZodString;
             targeting_gate: zod.ZodDefault<zod.ZodNullable<zod.ZodString>>;
@@ -1119,11 +1194,7 @@ declare const RESOURCE_REGISTRY: readonly [{
             tag: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             owner_email: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             audience: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
-            bucket_by: zod.ZodOptional<zod.ZodNullable<zod.ZodEnum<{
-                user_id: "user_id";
-                session_id: "session_id";
-                device_id: "device_id";
-            }>>>;
+            bucket_by: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             folder: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             targeting_gate: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
             allocation_pct: zod.ZodOptional<zod.ZodNumber>;

package/dist/resources/index.js

@@ -29,12 +29,14 @@ var gateRuleSchema = z2.object({
     "semver_gt",
     "semver_gte",
     "semver_lt",
-    "semver_lte"
+    "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)."
+    '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: z2.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`."
+    '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."
@@ -45,9 +47,17 @@ var gateNameSchema = z2.string().regex(
 ).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 = z2.object({
+  from: z2.number().int().min(0).max(1e4).describe("Start of the ramp in basis points (0\u201310000)."),
+  to: z2.number().int().min(0).max(1e4).describe("End of the ramp in basis points (0\u201310000)."),
+  startAt: z2.number().int().nonnegative().describe("Ramp start, epoch milliseconds (UTC)."),
+  durationMs: z2.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 = z2.object({
   id: z2.string().min(1).describe(
-    "Client-supplied stable id for the stack entry (used for React keys, audit diffs)."
+    "Client-supplied stable id for the stack entry (used for React keys, audit diffs, and as the default per-condition rollout salt)."
   ),
   type: z2.literal("condition").describe("Discriminator. `condition` = rule-based predicate sub-gate."),
   name: z2.string().optional().describe("Human label shown in the dashboard."),
@@ -56,9 +66,15 @@ var stackedConditionSchema = z2.object({
   ),
   pass: z2.enum(["all", "any"]).optional().describe("Combinator across `rules`. `all` = AND (default), `any` = OR."),
   rules: z2.array(gateRuleSchema).default([]).describe("Predicates evaluated under `pass`. Empty array = match nothing."),
+  rolloutPct: z2.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: z2.string().optional().describe("Attribute used to hash the caller into the per-condition bucket. Default `userID`."),
+  salt: z2.string().optional().describe("Per-condition hash salt. Defaults to the entry `id`, then the gate salt."),
+  ramp: rampSchema.optional(),
   locked: z2.boolean().optional().describe("If `true`, dashboard hides edit controls (e.g. the trailing public-floor entry).")
 }).describe(
-  "Rule-based sub-gate. When matched, evaluation short-circuits and the gate returns `true` for the current caller."
+  "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 = z2.object({
   id: z2.string().min(1).describe("Client-supplied stable id for the stack entry."),
@@ -74,9 +90,10 @@ var stackedRolloutSchema = z2.object({
   salt: z2.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: z2.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."
+  "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 = z2.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."
@@ -530,7 +547,12 @@ var experimentGroupSchema = z5.object({
 var paramSchemaSchema = z5.record(z5.string(), z5.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 = z5.enum(["user_id", "session_id", "device_id"]).describe("Identifier used as the bucketing key. `user_id` is sticky across sessions.");
+var bucketBySchema = z5.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 = z5.object({
   name: experimentNameSchema,
   description: z5.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),
@@ -2274,6 +2296,13 @@ var killswitchesResource = {
 import { z as z13 } from "zod";
 var ALERT_COMPARATORS = ["gt", "gte", "lt", "lte"];
 var ALERT_SEVERITIES = ["danger", "warn", "info"];
+var notificationTargetSchema = z13.object({
+  slackChannel: z13.object({
+    id: z13.string().min(1).describe("Slack channel id (e.g. C0123ABCD)."),
+    name: z13.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: z13.string().email().nullish().describe("Email address to notify for this rule (overrides the default recipient).")
+}).strict();
 var alertRuleCreateSchema = z13.object({
   name: z13.string().min(1).max(120).describe("Human label for the rule, shown on the alert and the rules list."),
   metricId: z13.string().min(1).describe("Id of the metric to evaluate."),
@@ -2281,7 +2310,8 @@ var alertRuleCreateSchema = z13.object({
   threshold: z13.number().finite().describe("Threshold the metric value is compared against."),
   windowHours: z13.number().int().min(1).max(720).default(24).describe("Lookback window (hours) the metric is aggregated over. 1\u2013720."),
   severity: z13.enum(ALERT_SEVERITIES).default("warn").describe("Severity of the raised alert."),
-  enabled: z13.boolean().default(true).describe("Whether the rule is evaluated by the cron.")
+  enabled: z13.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 = z13.object({
   name: z13.string().min(1).max(120),
@@ -2289,7 +2319,8 @@ var alertRuleUpdateSchema = z13.object({
   threshold: z13.number().finite(),
   windowHours: z13.number().int().min(1).max(720),
   severity: z13.enum(ALERT_SEVERITIES),
-  enabled: z13.boolean()
+  enabled: z13.boolean(),
+  notify: notificationTargetSchema.nullish()
 }).partial().strict();
 
 // src/resources/alert-rules.ts

package/dist/schemas/alert-rules.d.ts

@@ -2,6 +2,14 @@ import { z } from 'zod';
 
 declare const ALERT_COMPARATORS: readonly ["gt", "gte", "lt", "lte"];
 declare const ALERT_SEVERITIES: readonly ["danger", "warn", "info"];
+declare const notificationTargetSchema: z.ZodObject<{
+    slackChannel: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+type NotificationTarget = z.infer<typeof notificationTargetSchema>;
 declare const alertRuleCreateSchema: z.ZodObject<{
     name: z.ZodString;
     metricId: z.ZodString;
@@ -19,6 +27,13 @@ declare const alertRuleCreateSchema: z.ZodObject<{
         info: "info";
     }>>;
     enabled: z.ZodDefault<z.ZodBoolean>;
+    notify: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        slackChannel: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 declare const alertRuleUpdateSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
@@ -36,8 +51,15 @@ declare const alertRuleUpdateSchema: z.ZodObject<{
         info: "info";
     }>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
+    notify: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        slackChannel: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>>;
 }, z.core.$strict>;
 type AlertRuleCreate = z.infer<typeof alertRuleCreateSchema>;
 type AlertRuleUpdate = z.infer<typeof alertRuleUpdateSchema>;
 
-export { ALERT_COMPARATORS, ALERT_SEVERITIES, type AlertRuleCreate, type AlertRuleUpdate, alertRuleCreateSchema, alertRuleUpdateSchema };
+export { ALERT_COMPARATORS, ALERT_SEVERITIES, type AlertRuleCreate, type AlertRuleUpdate, type NotificationTarget, alertRuleCreateSchema, alertRuleUpdateSchema, notificationTargetSchema };

package/dist/schemas/alert-rules.js

@@ -2,6 +2,13 @@
 import { z } from "zod";
 var ALERT_COMPARATORS = ["gt", "gte", "lt", "lte"];
 var ALERT_SEVERITIES = ["danger", "warn", "info"];
+var notificationTargetSchema = z.object({
+  slackChannel: z.object({
+    id: z.string().min(1).describe("Slack channel id (e.g. C0123ABCD)."),
+    name: z.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: z.string().email().nullish().describe("Email address to notify for this rule (overrides the default recipient).")
+}).strict();
 var alertRuleCreateSchema = z.object({
   name: z.string().min(1).max(120).describe("Human label for the rule, shown on the alert and the rules list."),
   metricId: z.string().min(1).describe("Id of the metric to evaluate."),
@@ -9,7 +16,8 @@ var alertRuleCreateSchema = z.object({
   threshold: z.number().finite().describe("Threshold the metric value is compared against."),
   windowHours: z.number().int().min(1).max(720).default(24).describe("Lookback window (hours) the metric is aggregated over. 1\u2013720."),
   severity: z.enum(ALERT_SEVERITIES).default("warn").describe("Severity of the raised alert."),
-  enabled: z.boolean().default(true).describe("Whether the rule is evaluated by the cron.")
+  enabled: z.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 = z.object({
   name: z.string().min(1).max(120),
@@ -17,11 +25,13 @@ var alertRuleUpdateSchema = z.object({
   threshold: z.number().finite(),
   windowHours: z.number().int().min(1).max(720),
   severity: z.enum(ALERT_SEVERITIES),
-  enabled: z.boolean()
+  enabled: z.boolean(),
+  notify: notificationTargetSchema.nullish()
 }).partial().strict();
 export {
   ALERT_COMPARATORS,
   ALERT_SEVERITIES,
   alertRuleCreateSchema,
-  alertRuleUpdateSchema
+  alertRuleUpdateSchema,
+  notificationTargetSchema
 };

package/dist/schemas/experiments.d.ts

@@ -16,11 +16,7 @@ declare const paramSchemaSchema: z.ZodRecord<z.ZodString, z.ZodEnum<{
     number: "number";
     bool: "bool";
 }>>;
-declare const bucketBySchema: z.ZodEnum<{
-    user_id: "user_id";
-    session_id: "session_id";
-    device_id: "device_id";
-}>;
+declare const bucketBySchema: z.ZodString;
 declare const experimentCreateSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -28,11 +24,7 @@ declare const experimentCreateSchema: z.ZodObject<{
     tag: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     owner_email: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     audience: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    bucket_by: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
-        user_id: "user_id";
-        session_id: "session_id";
-        device_id: "device_id";
-    }>>>;
+    bucket_by: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     universe: z.ZodString;
     targeting_gate: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -68,11 +60,7 @@ declare const experimentUpdateSchema: z.ZodObject<{
     tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     owner_email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     audience: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    bucket_by: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        user_id: "user_id";
-        session_id: "session_id";
-        device_id: "device_id";
-    }>>>;
+    bucket_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     targeting_gate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     allocation_pct: z.ZodOptional<z.ZodNumber>;
@@ -127,11 +115,7 @@ declare const experimentResponseSchema: z.ZodObject<{
     tag: z.ZodNullable<z.ZodString>;
     ownerEmail: z.ZodNullable<z.ZodString>;
     audience: z.ZodNullable<z.ZodString>;
-    bucketBy: z.ZodNullable<z.ZodEnum<{
-        user_id: "user_id";
-        session_id: "session_id";
-        device_id: "device_id";
-    }>>;
+    bucketBy: z.ZodNullable<z.ZodString>;
     folder: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
         draft: "draft";

package/dist/schemas/experiments.js

@@ -31,7 +31,12 @@ var experimentGroupSchema = z3.object({
 var paramSchemaSchema = z3.record(z3.string(), z3.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 = z3.enum(["user_id", "session_id", "device_id"]).describe("Identifier used as the bucketing key. `user_id` is sticky across sessions.");
+var bucketBySchema = z3.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 = z3.object({
   name: experimentNameSchema,
   description: z3.string().max(2e3).nullable().default(null).describe("Free-form description. Max 2000 chars, markdown rendered in the dashboard."),