@getrheo/contracts 1.0.0

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/index.ts","../src/identity.ts","../src/events.ts"],"names":["z"],"mappings":"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","file":"events.js","sourcesContent":["export const ENVIRONMENTS = ['test', 'live'] as const;\nexport type Environment = (typeof ENVIRONMENTS)[number];\n\nexport const ROLES = ['owner', 'editor'] as const;\nexport type Role = (typeof ROLES)[number];\n\nexport const STEP_TYPES = [\n  'carousel',\n  'single_choice',\n  'multiple_choice',\n  'text_input',\n  'scale_input',\n  'cta',\n] as const;\nexport type StepType = (typeof STEP_TYPES)[number];\n\nexport const FIELD_CLASSIFICATIONS = ['safe', 'sensitive'] as const;\nexport type FieldClassification = (typeof FIELD_CLASSIFICATIONS)[number];\n\nexport const MEDIA_TYPES = ['image', 'font', 'lottie', 'video'] as const;\nexport type MediaType = (typeof MEDIA_TYPES)[number];\n\nexport const IMAGE_MIME_TYPES = [\n  'image/png',\n  'image/jpeg',\n  'image/webp',\n  'image/gif',\n  'image/svg+xml',\n] as const;\nexport const MAX_IMAGE_BYTES = 5 * 1024 * 1024;\n\n/** Lottie sources are JSON on the same CDN as images. */\nexport const LOTTIE_MIME_TYPES = ['application/json', 'text/json'] as const;\nexport const MAX_LOTTIE_BYTES = 10 * 1024 * 1024;\n\n/** Video files on the same CDN as images (mp4, webm, mov). */\nexport const VIDEO_MIME_TYPES = ['video/mp4', 'video/webm', 'video/quicktime'] as const;\nexport const MAX_VIDEO_BYTES = 50 * 1024 * 1024;\n\nexport const FONT_MIME_TYPES = [\n  'font/ttf',\n  'font/otf',\n  'font/woff',\n  'font/woff2',\n  'application/font-woff',\n  'application/font-woff2',\n  'application/x-font-ttf',\n  'application/x-font-otf',\n  'application/octet-stream',\n] as const;\nexport const FONT_FILE_EXTENSIONS = ['.ttf', '.otf', '.woff', '.woff2'] as const;\nexport const MAX_FONT_BYTES = 10 * 1024 * 1024;\n\nexport const EVENT_NAMES = [\n  'flow_started',\n  'step_viewed',\n  'step_completed',\n  'step_skipped',\n  'choice_selected',\n  'text_submitted',\n  'flow_completed',\n  'flow_abandoned',\n  'decision_evaluated',\n  'external_link_opened',\n  'surface_presented',\n  'surface_outcome',\n  'app_review_prompt_shown',\n  'app_review_prompt_dismissed',\n  /** Emitted once per provider id when merged SDK attributes first expose that attribution source (used for integration health checks). */\n  'attribution_context_observed',\n  /** Successful in-app purchase from an external surface (e.g. RevenueCat paywall); commerce fields live in `properties`. */\n  'iap_purchase',\n] as const;\nexport type EventName = (typeof EVENT_NAMES)[number];\n\nexport const PUBLISHABLE_KEY_PREFIX = 'ob_pk_';\nexport const API_VERSION = 'v1';\n\nexport const DEFAULT_LOCALE = 'en';\n\nexport const AUTOSAVE_DEBOUNCE_MS = 800;\nexport const SDK_EVENT_FLUSH_MS = 5000;\n","import { z } from 'zod';\n\nexport const SdkIdentitySchema = z.object({\n  appUserId: z.string().min(1),\n  customUserId: z.string().min(1).optional(),\n  sessionId: z.string().min(1).optional(),\n});\nexport type SdkIdentity = z.infer<typeof SdkIdentitySchema>;\n\nexport const SdkContextSchema = z.object({\n  platform: z.enum(['ios', 'android', 'web']).optional(),\n  appVersion: z.string().optional(),\n  locale: z.string().optional(),\n  customProperties: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),\n});\nexport type SdkContext = z.infer<typeof SdkContextSchema>;\n","import { z } from 'zod';\nimport { EVENT_NAMES } from './constants/index';\nimport { SdkContextSchema, SdkIdentitySchema } from './identity';\n\nexport const EventNameSchema = z.enum(EVENT_NAMES);\n\nexport const SdkEventSchema = z.object({\n  eventId: z.string().uuid(),\n  name: EventNameSchema,\n  timestamp: z.string().datetime(),\n  flowId: z.string().uuid(),\n  /** Resolved version the SDK was rendering when the event occurred. */\n  versionId: z.string().uuid(),\n  experimentId: z.string().uuid().nullable().optional(),\n  variantId: z.string().nullable().optional(),\n  stepId: z.string().nullable().optional(),\n  identity: SdkIdentitySchema,\n  context: SdkContextSchema.optional(),\n  properties: z\n    .record(\n      z.string(),\n      z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(z.string())]),\n    )\n    .optional(),\n  /** for text_submitted, marks this value as sensitive so backend redacts */\n  fieldClassification: z.enum(['safe', 'sensitive']).optional(),\n});\nexport type SdkEvent = z.infer<typeof SdkEventSchema>;\n\nexport const SdkEventBatchSchema = z.object({\n  events: z.array(SdkEventSchema).min(1).max(500),\n});\nexport type SdkEventBatch = z.infer<typeof SdkEventBatchSchema>;\n"]}

package/dist/experiments-DN8pQa_D.d.ts

@@ -0,0 +1,530 @@
+import { z } from 'zod';
+
+/**
+ * Experiment lifecycle:
+ *   * draft             — being configured; no traffic.
+ *   * running           — bucketing live SDK requests across arms.
+ *   * pending_decision  — endsAt has passed but the experiment keeps
+ *                         serving traffic (frozen bucketing). The
+ *                         operator must promote a winner or extend.
+ *   * stopped           — terminal; channel typically pinned to a
+ *                         winner version at stop time.
+ */
+declare const ExperimentStatusSchema: z.ZodEnum<["draft", "running", "pending_decision", "stopped"]>;
+type ExperimentStatus = z.infer<typeof ExperimentStatusSchema>;
+/**
+ * One arm of an experiment. Each arm pins its own version of a (possibly
+ * different) flow, so cross-flow A/Bs are first-class.
+ */
+declare const VariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    experimentId: z.ZodString;
+    name: z.ZodString;
+    weight: z.ZodNumber;
+    flowId: z.ZodNullable<z.ZodString>;
+    versionId: z.ZodNullable<z.ZodString>;
+    /** Convenience read fields populated by list/get endpoints. */
+    flowName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    versionNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    versionLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    flowId: string | null;
+    weight: number;
+    versionId: string | null;
+    experimentId: string;
+    versionNumber?: number | null | undefined;
+    flowName?: string | null | undefined;
+    versionLabel?: string | null | undefined;
+}, {
+    id: string;
+    name: string;
+    flowId: string | null;
+    weight: number;
+    versionId: string | null;
+    experimentId: string;
+    versionNumber?: number | null | undefined;
+    flowName?: string | null | undefined;
+    versionLabel?: string | null | undefined;
+}>;
+type Variant = z.infer<typeof VariantSchema>;
+declare const ExperimentEndedReasonSchema: z.ZodEnum<["manual", "scheduled_resolved"]>;
+type ExperimentEndedReason = z.infer<typeof ExperimentEndedReasonSchema>;
+declare const ExperimentSchema: z.ZodObject<{
+    id: z.ZodString;
+    appId: z.ZodString;
+    /** Internal channel uuid. */
+    channelId: z.ZodString;
+    /** Display name of the channel (denormalized for list views). */
+    channelName: z.ZodString;
+    /** Test/live env of the channel — kept for badges and analytics filters. */
+    channelEnvironment: z.ZodEnum<["test", "live"]>;
+    name: z.ZodString;
+    status: z.ZodEnum<["draft", "running", "pending_decision", "stopped"]>;
+    variants: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        experimentId: z.ZodString;
+        name: z.ZodString;
+        weight: z.ZodNumber;
+        flowId: z.ZodNullable<z.ZodString>;
+        versionId: z.ZodNullable<z.ZodString>;
+        /** Convenience read fields populated by list/get endpoints. */
+        flowName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        versionNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        versionLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        flowId: string | null;
+        weight: number;
+        versionId: string | null;
+        experimentId: string;
+        versionNumber?: number | null | undefined;
+        flowName?: string | null | undefined;
+        versionLabel?: string | null | undefined;
+    }, {
+        id: string;
+        name: string;
+        flowId: string | null;
+        weight: number;
+        versionId: string | null;
+        experimentId: string;
+        versionNumber?: number | null | undefined;
+        flowName?: string | null | undefined;
+        versionLabel?: string | null | undefined;
+    }>, "many">;
+    startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stoppedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    endsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    endedReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<["manual", "scheduled_resolved"]>>>;
+    archivedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    /** Dashboard user who created the experiment (null for legacy rows). */
+    createdByUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Display: full name, else @username, else email; null when unknown. */
+    createdByLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    /** Power-analysis inputs; nulls → dashboard defaults for sample accumulation. */
+    statsDesignBaselineCvr: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    statsDesignMdePp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    statsDesignAlpha: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    statsDesignPower: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    status: "draft" | "running" | "pending_decision" | "stopped";
+    id: string;
+    name: string;
+    createdAt: string;
+    tags: string[];
+    appId: string;
+    channelId: string;
+    channelName: string;
+    channelEnvironment: "test" | "live";
+    variants: {
+        id: string;
+        name: string;
+        flowId: string | null;
+        weight: number;
+        versionId: string | null;
+        experimentId: string;
+        versionNumber?: number | null | undefined;
+        flowName?: string | null | undefined;
+        versionLabel?: string | null | undefined;
+    }[];
+    archivedAt?: string | null | undefined;
+    createdByUserId?: string | null | undefined;
+    startedAt?: string | null | undefined;
+    stoppedAt?: string | null | undefined;
+    endsAt?: string | null | undefined;
+    endedReason?: "manual" | "scheduled_resolved" | null | undefined;
+    createdByLabel?: string | null | undefined;
+    statsDesignBaselineCvr?: number | null | undefined;
+    statsDesignMdePp?: number | null | undefined;
+    statsDesignAlpha?: number | null | undefined;
+    statsDesignPower?: number | null | undefined;
+}, {
+    status: "draft" | "running" | "pending_decision" | "stopped";
+    id: string;
+    name: string;
+    createdAt: string;
+    tags: string[];
+    appId: string;
+    channelId: string;
+    channelName: string;
+    channelEnvironment: "test" | "live";
+    variants: {
+        id: string;
+        name: string;
+        flowId: string | null;
+        weight: number;
+        versionId: string | null;
+        experimentId: string;
+        versionNumber?: number | null | undefined;
+        flowName?: string | null | undefined;
+        versionLabel?: string | null | undefined;
+    }[];
+    archivedAt?: string | null | undefined;
+    createdByUserId?: string | null | undefined;
+    startedAt?: string | null | undefined;
+    stoppedAt?: string | null | undefined;
+    endsAt?: string | null | undefined;
+    endedReason?: "manual" | "scheduled_resolved" | null | undefined;
+    createdByLabel?: string | null | undefined;
+    statsDesignBaselineCvr?: number | null | undefined;
+    statsDesignMdePp?: number | null | undefined;
+    statsDesignAlpha?: number | null | undefined;
+    statsDesignPower?: number | null | undefined;
+}>;
+type Experiment = z.infer<typeof ExperimentSchema>;
+/** Defaults for sample accumulation / required-N (aligned with `resolveExperimentSampleDesign` in this package). */
+declare const EXPERIMENT_STATS_DESIGN_DEFAULTS: {
+    readonly statsDesignBaselineCvr: 0.342;
+    readonly statsDesignMdePp: 3;
+    readonly statsDesignAlpha: 0.05;
+    readonly statsDesignPower: 0.8;
+};
+declare const ExperimentStatsDesignInputSchema: z.ZodObject<{
+    statsDesignBaselineCvr: z.ZodNumber;
+    statsDesignMdePp: z.ZodNumber;
+    statsDesignAlpha: z.ZodNumber;
+    statsDesignPower: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    statsDesignBaselineCvr: number;
+    statsDesignMdePp: number;
+    statsDesignAlpha: number;
+    statsDesignPower: number;
+}, {
+    statsDesignBaselineCvr: number;
+    statsDesignMdePp: number;
+    statsDesignAlpha: number;
+    statsDesignPower: number;
+}>;
+type ExperimentStatsDesignInput = z.infer<typeof ExperimentStatsDesignInputSchema>;
+declare const CreateExperimentRequestSchema: z.ZodObject<{
+    channelId: z.ZodString;
+    name: z.ZodString;
+    /** Required auto-stop. Hour granularity is enforced server-side. */
+    endsAt: z.ZodString;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>, string[], string[]>>;
+    statsDesignBaselineCvr: z.ZodOptional<z.ZodNumber>;
+    statsDesignMdePp: z.ZodOptional<z.ZodNumber>;
+    statsDesignAlpha: z.ZodOptional<z.ZodNumber>;
+    statsDesignPower: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    channelId: string;
+    endsAt: string;
+    tags?: string[] | undefined;
+    statsDesignBaselineCvr?: number | undefined;
+    statsDesignMdePp?: number | undefined;
+    statsDesignAlpha?: number | undefined;
+    statsDesignPower?: number | undefined;
+}, {
+    name: string;
+    channelId: string;
+    endsAt: string;
+    tags?: string[] | undefined;
+    statsDesignBaselineCvr?: number | undefined;
+    statsDesignMdePp?: number | undefined;
+    statsDesignAlpha?: number | undefined;
+    statsDesignPower?: number | undefined;
+}>;
+type CreateExperimentRequest = z.infer<typeof CreateExperimentRequestSchema>;
+/** Patch shape for editing experiments. Name/channel/endsAt only apply while `draft`; tags may be updated in any status. */
+declare const UpdateExperimentRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    channelId: z.ZodOptional<z.ZodString>;
+    endsAt: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>, string[], string[]>>;
+    statsDesignBaselineCvr: z.ZodOptional<z.ZodNumber>;
+    statsDesignMdePp: z.ZodOptional<z.ZodNumber>;
+    statsDesignAlpha: z.ZodOptional<z.ZodNumber>;
+    statsDesignPower: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    channelId?: string | undefined;
+    endsAt?: string | undefined;
+    statsDesignBaselineCvr?: number | undefined;
+    statsDesignMdePp?: number | undefined;
+    statsDesignAlpha?: number | undefined;
+    statsDesignPower?: number | undefined;
+}, {
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    channelId?: string | undefined;
+    endsAt?: string | undefined;
+    statsDesignBaselineCvr?: number | undefined;
+    statsDesignMdePp?: number | undefined;
+    statsDesignAlpha?: number | undefined;
+    statsDesignPower?: number | undefined;
+}>;
+type UpdateExperimentRequest = z.infer<typeof UpdateExperimentRequestSchema>;
+/**
+ * Push back the auto-stop time on a `pending_decision` experiment. The
+ * server flips it back to `running` and leaves the channel assignment
+ * untouched (the channel was already pointing at this experiment).
+ */
+declare const ExtendExperimentRequestSchema: z.ZodObject<{
+    endsAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    endsAt: string;
+}, {
+    endsAt: string;
+}>;
+type ExtendExperimentRequest = z.infer<typeof ExtendExperimentRequestSchema>;
+/**
+ * Stop an experiment with an explicit channel fallback. The two writes
+ * (status flip + channel pin) are atomic on the server. The fallback
+ * either re-pins to one of the experiment's variant versions, or to
+ * any other version in the app.
+ */
+declare const StopExperimentRequestSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"variant">;
+    variantId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "variant";
+    variantId: string;
+}, {
+    kind: "variant";
+    variantId: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"version">;
+    flowId: z.ZodString;
+    versionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "version";
+    flowId: string;
+    versionId: string;
+}, {
+    kind: "version";
+    flowId: string;
+    versionId: string;
+}>]>;
+type StopExperimentRequest = z.infer<typeof StopExperimentRequestSchema>;
+declare const CreateVariantRequestSchema: z.ZodObject<{
+    weight: z.ZodNumber;
+    flowId: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    weight: number;
+    flowId?: string | undefined;
+    versionId?: string | undefined;
+}, {
+    weight: number;
+    flowId?: string | undefined;
+    versionId?: string | undefined;
+}>;
+type CreateVariantRequest = z.infer<typeof CreateVariantRequestSchema>;
+declare const ReorderExperimentVariantsRequestSchema: z.ZodObject<{
+    variantIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    variantIds: string[];
+}, {
+    variantIds: string[];
+}>;
+type ReorderExperimentVariantsRequest = z.infer<typeof ReorderExperimentVariantsRequestSchema>;
+declare const UpdateExperimentStatusRequestSchema: z.ZodObject<{
+    status: z.ZodEnum<["draft", "running", "pending_decision", "stopped"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "draft" | "running" | "pending_decision" | "stopped";
+}, {
+    status: "draft" | "running" | "pending_decision" | "stopped";
+}>;
+type UpdateExperimentStatusRequest = z.infer<typeof UpdateExperimentStatusRequestSchema>;
+declare const ListExperimentsResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        appId: z.ZodString;
+        /** Internal channel uuid. */
+        channelId: z.ZodString;
+        /** Display name of the channel (denormalized for list views). */
+        channelName: z.ZodString;
+        /** Test/live env of the channel — kept for badges and analytics filters. */
+        channelEnvironment: z.ZodEnum<["test", "live"]>;
+        name: z.ZodString;
+        status: z.ZodEnum<["draft", "running", "pending_decision", "stopped"]>;
+        variants: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            experimentId: z.ZodString;
+            name: z.ZodString;
+            weight: z.ZodNumber;
+            flowId: z.ZodNullable<z.ZodString>;
+            versionId: z.ZodNullable<z.ZodString>;
+            /** Convenience read fields populated by list/get endpoints. */
+            flowName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            versionNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            versionLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            flowId: string | null;
+            weight: number;
+            versionId: string | null;
+            experimentId: string;
+            versionNumber?: number | null | undefined;
+            flowName?: string | null | undefined;
+            versionLabel?: string | null | undefined;
+        }, {
+            id: string;
+            name: string;
+            flowId: string | null;
+            weight: number;
+            versionId: string | null;
+            experimentId: string;
+            versionNumber?: number | null | undefined;
+            flowName?: string | null | undefined;
+            versionLabel?: string | null | undefined;
+        }>, "many">;
+        startedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        stoppedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        endsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        endedReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<["manual", "scheduled_resolved"]>>>;
+        archivedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        /** Dashboard user who created the experiment (null for legacy rows). */
+        createdByUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Display: full name, else @username, else email; null when unknown. */
+        createdByLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tags: z.ZodArray<z.ZodString, "many">;
+        /** Power-analysis inputs; nulls → dashboard defaults for sample accumulation. */
+        statsDesignBaselineCvr: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        statsDesignMdePp: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        statsDesignAlpha: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        statsDesignPower: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "draft" | "running" | "pending_decision" | "stopped";
+        id: string;
+        name: string;
+        createdAt: string;
+        tags: string[];
+        appId: string;
+        channelId: string;
+        channelName: string;
+        channelEnvironment: "test" | "live";
+        variants: {
+            id: string;
+            name: string;
+            flowId: string | null;
+            weight: number;
+            versionId: string | null;
+            experimentId: string;
+            versionNumber?: number | null | undefined;
+            flowName?: string | null | undefined;
+            versionLabel?: string | null | undefined;
+        }[];
+        archivedAt?: string | null | undefined;
+        createdByUserId?: string | null | undefined;
+        startedAt?: string | null | undefined;
+        stoppedAt?: string | null | undefined;
+        endsAt?: string | null | undefined;
+        endedReason?: "manual" | "scheduled_resolved" | null | undefined;
+        createdByLabel?: string | null | undefined;
+        statsDesignBaselineCvr?: number | null | undefined;
+        statsDesignMdePp?: number | null | undefined;
+        statsDesignAlpha?: number | null | undefined;
+        statsDesignPower?: number | null | undefined;
+    }, {
+        status: "draft" | "running" | "pending_decision" | "stopped";
+        id: string;
+        name: string;
+        createdAt: string;
+        tags: string[];
+        appId: string;
+        channelId: string;
+        channelName: string;
+        channelEnvironment: "test" | "live";
+        variants: {
+            id: string;
+            name: string;
+            flowId: string | null;
+            weight: number;
+            versionId: string | null;
+            experimentId: string;
+            versionNumber?: number | null | undefined;
+            flowName?: string | null | undefined;
+            versionLabel?: string | null | undefined;
+        }[];
+        archivedAt?: string | null | undefined;
+        createdByUserId?: string | null | undefined;
+        startedAt?: string | null | undefined;
+        stoppedAt?: string | null | undefined;
+        endsAt?: string | null | undefined;
+        endedReason?: "manual" | "scheduled_resolved" | null | undefined;
+        createdByLabel?: string | null | undefined;
+        statsDesignBaselineCvr?: number | null | undefined;
+        statsDesignMdePp?: number | null | undefined;
+        statsDesignAlpha?: number | null | undefined;
+        statsDesignPower?: number | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        status: "draft" | "running" | "pending_decision" | "stopped";
+        id: string;
+        name: string;
+        createdAt: string;
+        tags: string[];
+        appId: string;
+        channelId: string;
+        channelName: string;
+        channelEnvironment: "test" | "live";
+        variants: {
+            id: string;
+            name: string;
+            flowId: string | null;
+            weight: number;
+            versionId: string | null;
+            experimentId: string;
+            versionNumber?: number | null | undefined;
+            flowName?: string | null | undefined;
+            versionLabel?: string | null | undefined;
+        }[];
+        archivedAt?: string | null | undefined;
+        createdByUserId?: string | null | undefined;
+        startedAt?: string | null | undefined;
+        stoppedAt?: string | null | undefined;
+        endsAt?: string | null | undefined;
+        endedReason?: "manual" | "scheduled_resolved" | null | undefined;
+        createdByLabel?: string | null | undefined;
+        statsDesignBaselineCvr?: number | null | undefined;
+        statsDesignMdePp?: number | null | undefined;
+        statsDesignAlpha?: number | null | undefined;
+        statsDesignPower?: number | null | undefined;
+    }[];
+}, {
+    items: {
+        status: "draft" | "running" | "pending_decision" | "stopped";
+        id: string;
+        name: string;
+        createdAt: string;
+        tags: string[];
+        appId: string;
+        channelId: string;
+        channelName: string;
+        channelEnvironment: "test" | "live";
+        variants: {
+            id: string;
+            name: string;
+            flowId: string | null;
+            weight: number;
+            versionId: string | null;
+            experimentId: string;
+            versionNumber?: number | null | undefined;
+            flowName?: string | null | undefined;
+            versionLabel?: string | null | undefined;
+        }[];
+        archivedAt?: string | null | undefined;
+        createdByUserId?: string | null | undefined;
+        startedAt?: string | null | undefined;
+        stoppedAt?: string | null | undefined;
+        endsAt?: string | null | undefined;
+        endedReason?: "manual" | "scheduled_resolved" | null | undefined;
+        createdByLabel?: string | null | undefined;
+        statsDesignBaselineCvr?: number | null | undefined;
+        statsDesignMdePp?: number | null | undefined;
+        statsDesignAlpha?: number | null | undefined;
+        statsDesignPower?: number | null | undefined;
+    }[];
+}>;
+
+export { type CreateExperimentRequest as C, type ExperimentStatus as E, ListExperimentsResponseSchema as L, type ReorderExperimentVariantsRequest as R, type StopExperimentRequest as S, type UpdateExperimentRequest as U, type Variant as V, CreateExperimentRequestSchema as a, type CreateVariantRequest as b, CreateVariantRequestSchema as c, EXPERIMENT_STATS_DESIGN_DEFAULTS as d, type Experiment as e, type ExperimentEndedReason as f, ExperimentEndedReasonSchema as g, ExperimentSchema as h, type ExperimentStatsDesignInput as i, ExperimentStatsDesignInputSchema as j, ExperimentStatusSchema as k, type ExtendExperimentRequest as l, ExtendExperimentRequestSchema as m, ReorderExperimentVariantsRequestSchema as n, StopExperimentRequestSchema as o, UpdateExperimentRequestSchema as p, type UpdateExperimentStatusRequest as q, UpdateExperimentStatusRequestSchema as r, VariantSchema as s };

package/dist/externalSurfaceIntegrations.d.ts

@@ -0,0 +1,20 @@
+import { ResolvedAppIntegrations } from './appIntegrations.js';
+import { RevenueCatSurfacePresentation, SurfaceProvider, ExternalSurfaceConfig } from './externalSurfaces.js';
+import 'zod';
+import './decisions.js';
+
+/** Enabled app integrations that can be chosen for an external integration step (excludes `unspecified`). */
+type ExternalSurfaceIntegrationProvider = Exclude<SurfaceProvider, 'unspecified'>;
+/** App integrations that are turned on and may power an external integration canvas step. */
+declare const listEnabledExternalSurfaceProviders: (integrations: ResolvedAppIntegrations) => ExternalSurfaceIntegrationProvider[];
+declare const externalSurfaceProviderLabel: (provider: SurfaceProvider) => string;
+declare const externalSurfaceProviderMenuDescription: (provider: ExternalSurfaceIntegrationProvider) => string;
+type CreateExternalSurfaceConfigOptions = {
+    offeringId?: string;
+    placementId?: string;
+    presentation?: RevenueCatSurfacePresentation;
+};
+/** Build manifest `config` for a surface provider (extend the switch as new providers ship). */
+declare const createExternalSurfaceConfig: (provider: SurfaceProvider, options?: CreateExternalSurfaceConfigOptions) => ExternalSurfaceConfig;
+
+export { type CreateExternalSurfaceConfigOptions, type ExternalSurfaceIntegrationProvider, createExternalSurfaceConfig, externalSurfaceProviderLabel, externalSurfaceProviderMenuDescription, listEnabledExternalSurfaceProviders };

package/dist/externalSurfaceIntegrations.js

@@ -0,0 +1,49 @@
+// src/externalSurfaceIntegrations.ts
+var listEnabledExternalSurfaceProviders = (integrations) => {
+  const out = [];
+  if (integrations.revenuecat.enabled) out.push("revenuecat");
+  return out;
+};
+var externalSurfaceProviderLabel = (provider) => {
+  switch (provider) {
+    case "unspecified":
+      return "Not selected";
+    case "revenuecat":
+      return "RevenueCat";
+    default: {
+      const _exhaustive = provider;
+      return _exhaustive;
+    }
+  }
+};
+var externalSurfaceProviderMenuDescription = (provider) => {
+  switch (provider) {
+    case "revenuecat":
+      return "Present the host RevenueCat paywall and branch on purchase, restore, dismiss, or failure.";
+    default: {
+      const _exhaustive = provider;
+      return _exhaustive;
+    }
+  }
+};
+var createExternalSurfaceConfig = (provider, options) => {
+  switch (provider) {
+    case "unspecified":
+      return { provider: "unspecified" };
+    case "revenuecat":
+      return {
+        provider: "revenuecat",
+        ...options?.offeringId ? { offeringId: options.offeringId } : {},
+        ...options?.placementId ? { placementId: options.placementId } : {},
+        ...options?.presentation ? { presentation: options.presentation } : {}
+      };
+    default: {
+      const _exhaustive = provider;
+      return _exhaustive;
+    }
+  }
+};
+
+export { createExternalSurfaceConfig, externalSurfaceProviderLabel, externalSurfaceProviderMenuDescription, listEnabledExternalSurfaceProviders };
+//# sourceMappingURL=externalSurfaceIntegrations.js.map
+//# sourceMappingURL=externalSurfaceIntegrations.js.map

package/dist/externalSurfaceIntegrations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/externalSurfaceIntegrations.ts"],"names":[],"mappings":";AAWO,IAAM,mCAAA,GAAsC,CACjD,YAAA,KACyC;AACzC,EAAA,MAAM,MAA4C,EAAC;AACnD,EAAA,IAAI,YAAA,CAAa,UAAA,CAAW,OAAA,EAAS,GAAA,CAAI,KAAK,YAAY,CAAA;AAC1D,EAAA,OAAO,GAAA;AACT;AAEO,IAAM,4BAAA,GAA+B,CAAC,QAAA,KAAsC;AACjF,EAAA,QAAQ,QAAA;AAAU,IAChB,KAAK,aAAA;AACH,MAAA,OAAO,cAAA;AAAA,IACT,KAAK,YAAA;AACH,MAAA,OAAO,YAAA;AAAA,IACT,SAAS;AACP,MAAA,MAAM,WAAA,GAAqB,QAAA;AAC3B,MAAA,OAAO,WAAA;AAAA,IACT;AAAA;AAEJ;AAEO,IAAM,sCAAA,GAAyC,CACpD,QAAA,KACW;AACX,EAAA,QAAQ,QAAA;AAAU,IAChB,KAAK,YAAA;AACH,MAAA,OAAO,2FAAA;AAAA,IACT,SAAS;AACP,MAAA,MAAM,WAAA,GAAqB,QAAA;AAC3B,MAAA,OAAO,WAAA;AAAA,IACT;AAAA;AAEJ;AASO,IAAM,2BAAA,GAA8B,CACzC,QAAA,EACA,OAAA,KAC0B;AAC1B,EAAA,QAAQ,QAAA;AAAU,IAChB,KAAK,aAAA;AACH,MAAA,OAAO,EAAE,UAAU,aAAA,EAAc;AAAA,IACnC,KAAK,YAAA;AACH,MAAA,OAAO;AAAA,QACL,QAAA,EAAU,YAAA;AAAA,QACV,GAAI,SAAS,UAAA,GAAa,EAAE,YAAY,OAAA,CAAQ,UAAA,KAAe,EAAC;AAAA,QAChE,GAAI,SAAS,WAAA,GAAc,EAAE,aAAa,OAAA,CAAQ,WAAA,KAAgB,EAAC;AAAA,QACnE,GAAI,SAAS,YAAA,GAAe,EAAE,cAAc,OAAA,CAAQ,YAAA,KAAiB;AAAC,OACxE;AAAA,IACF,SAAS;AACP,MAAA,MAAM,WAAA,GAAqB,QAAA;AAC3B,MAAA,OAAO,WAAA;AAAA,IACT;AAAA;AAEJ","file":"externalSurfaceIntegrations.js","sourcesContent":["import type { ResolvedAppIntegrations } from './appIntegrations';\nimport type {\n  ExternalSurfaceConfig,\n  RevenueCatSurfacePresentation,\n  SurfaceProvider,\n} from './externalSurfaces';\n\n/** Enabled app integrations that can be chosen for an external integration step (excludes `unspecified`). */\nexport type ExternalSurfaceIntegrationProvider = Exclude<SurfaceProvider, 'unspecified'>;\n\n/** App integrations that are turned on and may power an external integration canvas step. */\nexport const listEnabledExternalSurfaceProviders = (\n  integrations: ResolvedAppIntegrations,\n): ExternalSurfaceIntegrationProvider[] => {\n  const out: ExternalSurfaceIntegrationProvider[] = [];\n  if (integrations.revenuecat.enabled) out.push('revenuecat');\n  return out;\n};\n\nexport const externalSurfaceProviderLabel = (provider: SurfaceProvider): string => {\n  switch (provider) {\n    case 'unspecified':\n      return 'Not selected';\n    case 'revenuecat':\n      return 'RevenueCat';\n    default: {\n      const _exhaustive: never = provider;\n      return _exhaustive;\n    }\n  }\n};\n\nexport const externalSurfaceProviderMenuDescription = (\n  provider: ExternalSurfaceIntegrationProvider,\n): string => {\n  switch (provider) {\n    case 'revenuecat':\n      return 'Present the host RevenueCat paywall and branch on purchase, restore, dismiss, or failure.';\n    default: {\n      const _exhaustive: never = provider;\n      return _exhaustive;\n    }\n  }\n};\n\nexport type CreateExternalSurfaceConfigOptions = {\n  offeringId?: string;\n  placementId?: string;\n  presentation?: RevenueCatSurfacePresentation;\n};\n\n/** Build manifest `config` for a surface provider (extend the switch as new providers ship). */\nexport const createExternalSurfaceConfig = (\n  provider: SurfaceProvider,\n  options?: CreateExternalSurfaceConfigOptions,\n): ExternalSurfaceConfig => {\n  switch (provider) {\n    case 'unspecified':\n      return { provider: 'unspecified' };\n    case 'revenuecat':\n      return {\n        provider: 'revenuecat',\n        ...(options?.offeringId ? { offeringId: options.offeringId } : {}),\n        ...(options?.placementId ? { placementId: options.placementId } : {}),\n        ...(options?.presentation ? { presentation: options.presentation } : {}),\n      };\n    default: {\n      const _exhaustive: never = provider;\n      return _exhaustive;\n    }\n  }\n};\n"]}