@ever-works/contracts 1.0.0

package/dist/item/index.cjs

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/item/index.d.cts

@@ -0,0 +1,195 @@
+/**
+ * Identifiable entity with id and name
+ */
+interface Identifiable {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Category for organizing items in a work
+ */
+interface Category {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly icon_url?: string;
+    /**
+     * Inline SVG markup for the category icon. Populated by the
+     * AI category-icon generator (curated lookup → AI fallback).
+     * Sanitized server-side before persistence.
+     */
+    readonly icon_svg?: string;
+    /** Lower numbers = higher priority (e.g., 1 = first, 2 = second, etc.) */
+    readonly priority?: number;
+}
+/**
+ * Tag for labeling items
+ */
+interface Tag {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Collection for curated item lists that span across categories
+ */
+interface Collection {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly icon_url?: string;
+    /**
+     * Inline SVG markup for the collection icon. Same generator path
+     * as `Category.icon_svg`; sanitized server-side.
+     */
+    readonly icon_svg?: string;
+    /** Lower numbers = higher priority (e.g., 1 = first, 2 = second, etc.) */
+    readonly priority?: number;
+}
+/**
+ * Brand information for items
+ */
+interface Brand {
+    readonly id: string;
+    readonly name: string;
+    readonly logo_url?: string;
+    readonly website?: string;
+}
+/**
+ * Badge representing an evaluated attribute of an item
+ */
+interface Badge {
+    readonly value: string;
+    readonly evaluated_at?: string;
+    readonly details?: string | null;
+    /** Legacy field for backward compatibility */
+    readonly type?: string;
+}
+/**
+ * Collection of badges for an item, keyed by badge name
+ */
+type ItemBadges = Record<string, Badge>;
+/**
+ * Result of badge evaluation for an item
+ */
+interface BadgeEvaluationResult {
+    readonly badges: ItemBadges;
+    readonly evaluation_summary: string;
+    readonly evaluated_at: string;
+    readonly domain_type?: string;
+}
+/**
+ * Health status for an item's source URL.
+ */
+type ItemHealthStatus = 'unchecked' | 'healthy' | 'unknown' | 'warning' | 'broken';
+/**
+ * Result of the latest source URL health check for an item.
+ */
+interface ItemHealth {
+    readonly status: ItemHealthStatus;
+    readonly checked_at?: string;
+    readonly status_code?: number | null;
+    readonly message?: string | null;
+    readonly failure_count?: number;
+    readonly checked_via?: 'manual' | 'schedule';
+}
+/**
+ * Reachability status for an item's source URL.
+ */
+type ItemSourceReachabilityStatus = 'reachable' | 'broken' | 'unknown';
+/**
+ * AI-evaluated source accuracy status for whether a source URL is a good source for the item.
+ */
+type ItemSourceAccuracyStatus = 'accurate' | 'generic' | 'weak' | 'unknown';
+/**
+ * Result of validating both source URL reachability and source accuracy.
+ */
+interface ItemSourceValidation {
+    readonly reachability_status: ItemSourceReachabilityStatus;
+    readonly accuracy_status: ItemSourceAccuracyStatus;
+    readonly checked_at?: string;
+    readonly confidence_score?: number | null;
+    readonly is_relevant?: boolean;
+    readonly is_specific?: boolean;
+    readonly is_official?: boolean;
+    readonly reason?: string | null;
+    readonly suggested_source_url?: string | null;
+}
+/**
+ * Core item data structure for work entries
+ */
+interface ItemData {
+    readonly name: string;
+    readonly description: string;
+    readonly featured?: boolean;
+    readonly order?: number;
+    readonly source_url: string;
+    readonly category: string | readonly string[];
+    readonly slug?: string;
+    readonly tags: readonly string[] | readonly Tag[];
+    readonly collection?: string;
+    readonly markdown?: string;
+    readonly badges?: ItemBadges;
+    readonly brand?: string | Brand;
+    readonly brand_logo_url?: string | null;
+    readonly images?: readonly string[];
+    readonly health?: ItemHealth;
+    readonly source_validation?: ItemSourceValidation;
+}
+/**
+ * Mutable version of ItemData for use during processing
+ */
+interface MutableItemData {
+    name: string;
+    description: string;
+    featured?: boolean;
+    order?: number;
+    source_url: string;
+    category: string | string[];
+    slug?: string;
+    tags: string[] | Tag[];
+    collection?: string;
+    markdown?: string;
+    badges?: ItemBadges;
+    brand?: string | Brand;
+    brand_logo_url?: string | null;
+    images?: string[];
+    health?: ItemHealth;
+    source_validation?: ItemSourceValidation;
+}
+/**
+ * A single dimension/axis used to compare two items (e.g. "Performance", "Pricing")
+ */
+interface ComparisonDimension {
+    readonly name: string;
+    readonly item_a_summary: string;
+    readonly item_b_summary: string;
+    readonly item_a_score?: number;
+    readonly item_b_score?: number;
+    readonly winner?: 'item_a' | 'item_b' | 'tie';
+}
+interface ComparisonSource {
+    readonly title: string;
+    readonly url: string;
+    readonly note?: string;
+}
+/**
+ * Full comparison data for an "A vs B" comparison page
+ */
+interface ComparisonData {
+    readonly id: string;
+    readonly slug: string;
+    readonly title: string;
+    readonly item_a_slug: string;
+    readonly item_b_slug: string;
+    readonly item_a_name: string;
+    readonly item_b_name: string;
+    readonly category: string;
+    readonly summary: string;
+    readonly verdict: string;
+    readonly verdict_winner?: 'item_a' | 'item_b' | 'tie';
+    readonly dimensions: readonly ComparisonDimension[];
+    readonly sources: readonly ComparisonSource[];
+    readonly generated_at: string;
+}
+
+export type { Badge, BadgeEvaluationResult, Brand, Category, Collection, ComparisonData, ComparisonDimension, ComparisonSource, Identifiable, ItemBadges, ItemData, ItemHealth, ItemHealthStatus, ItemSourceAccuracyStatus, ItemSourceReachabilityStatus, ItemSourceValidation, MutableItemData, Tag };

package/dist/item/index.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Identifiable entity with id and name
+ */
+interface Identifiable {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Category for organizing items in a work
+ */
+interface Category {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly icon_url?: string;
+    /**
+     * Inline SVG markup for the category icon. Populated by the
+     * AI category-icon generator (curated lookup → AI fallback).
+     * Sanitized server-side before persistence.
+     */
+    readonly icon_svg?: string;
+    /** Lower numbers = higher priority (e.g., 1 = first, 2 = second, etc.) */
+    readonly priority?: number;
+}
+/**
+ * Tag for labeling items
+ */
+interface Tag {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Collection for curated item lists that span across categories
+ */
+interface Collection {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly icon_url?: string;
+    /**
+     * Inline SVG markup for the collection icon. Same generator path
+     * as `Category.icon_svg`; sanitized server-side.
+     */
+    readonly icon_svg?: string;
+    /** Lower numbers = higher priority (e.g., 1 = first, 2 = second, etc.) */
+    readonly priority?: number;
+}
+/**
+ * Brand information for items
+ */
+interface Brand {
+    readonly id: string;
+    readonly name: string;
+    readonly logo_url?: string;
+    readonly website?: string;
+}
+/**
+ * Badge representing an evaluated attribute of an item
+ */
+interface Badge {
+    readonly value: string;
+    readonly evaluated_at?: string;
+    readonly details?: string | null;
+    /** Legacy field for backward compatibility */
+    readonly type?: string;
+}
+/**
+ * Collection of badges for an item, keyed by badge name
+ */
+type ItemBadges = Record<string, Badge>;
+/**
+ * Result of badge evaluation for an item
+ */
+interface BadgeEvaluationResult {
+    readonly badges: ItemBadges;
+    readonly evaluation_summary: string;
+    readonly evaluated_at: string;
+    readonly domain_type?: string;
+}
+/**
+ * Health status for an item's source URL.
+ */
+type ItemHealthStatus = 'unchecked' | 'healthy' | 'unknown' | 'warning' | 'broken';
+/**
+ * Result of the latest source URL health check for an item.
+ */
+interface ItemHealth {
+    readonly status: ItemHealthStatus;
+    readonly checked_at?: string;
+    readonly status_code?: number | null;
+    readonly message?: string | null;
+    readonly failure_count?: number;
+    readonly checked_via?: 'manual' | 'schedule';
+}
+/**
+ * Reachability status for an item's source URL.
+ */
+type ItemSourceReachabilityStatus = 'reachable' | 'broken' | 'unknown';
+/**
+ * AI-evaluated source accuracy status for whether a source URL is a good source for the item.
+ */
+type ItemSourceAccuracyStatus = 'accurate' | 'generic' | 'weak' | 'unknown';
+/**
+ * Result of validating both source URL reachability and source accuracy.
+ */
+interface ItemSourceValidation {
+    readonly reachability_status: ItemSourceReachabilityStatus;
+    readonly accuracy_status: ItemSourceAccuracyStatus;
+    readonly checked_at?: string;
+    readonly confidence_score?: number | null;
+    readonly is_relevant?: boolean;
+    readonly is_specific?: boolean;
+    readonly is_official?: boolean;
+    readonly reason?: string | null;
+    readonly suggested_source_url?: string | null;
+}
+/**
+ * Core item data structure for work entries
+ */
+interface ItemData {
+    readonly name: string;
+    readonly description: string;
+    readonly featured?: boolean;
+    readonly order?: number;
+    readonly source_url: string;
+    readonly category: string | readonly string[];
+    readonly slug?: string;
+    readonly tags: readonly string[] | readonly Tag[];
+    readonly collection?: string;
+    readonly markdown?: string;
+    readonly badges?: ItemBadges;
+    readonly brand?: string | Brand;
+    readonly brand_logo_url?: string | null;
+    readonly images?: readonly string[];
+    readonly health?: ItemHealth;
+    readonly source_validation?: ItemSourceValidation;
+}
+/**
+ * Mutable version of ItemData for use during processing
+ */
+interface MutableItemData {
+    name: string;
+    description: string;
+    featured?: boolean;
+    order?: number;
+    source_url: string;
+    category: string | string[];
+    slug?: string;
+    tags: string[] | Tag[];
+    collection?: string;
+    markdown?: string;
+    badges?: ItemBadges;
+    brand?: string | Brand;
+    brand_logo_url?: string | null;
+    images?: string[];
+    health?: ItemHealth;
+    source_validation?: ItemSourceValidation;
+}
+/**
+ * A single dimension/axis used to compare two items (e.g. "Performance", "Pricing")
+ */
+interface ComparisonDimension {
+    readonly name: string;
+    readonly item_a_summary: string;
+    readonly item_b_summary: string;
+    readonly item_a_score?: number;
+    readonly item_b_score?: number;
+    readonly winner?: 'item_a' | 'item_b' | 'tie';
+}
+interface ComparisonSource {
+    readonly title: string;
+    readonly url: string;
+    readonly note?: string;
+}
+/**
+ * Full comparison data for an "A vs B" comparison page
+ */
+interface ComparisonData {
+    readonly id: string;
+    readonly slug: string;
+    readonly title: string;
+    readonly item_a_slug: string;
+    readonly item_b_slug: string;
+    readonly item_a_name: string;
+    readonly item_b_name: string;
+    readonly category: string;
+    readonly summary: string;
+    readonly verdict: string;
+    readonly verdict_winner?: 'item_a' | 'item_b' | 'tie';
+    readonly dimensions: readonly ComparisonDimension[];
+    readonly sources: readonly ComparisonSource[];
+    readonly generated_at: string;
+}
+
+export type { Badge, BadgeEvaluationResult, Brand, Category, Collection, ComparisonData, ComparisonDimension, ComparisonSource, Identifiable, ItemBadges, ItemData, ItemHealth, ItemHealthStatus, ItemSourceAccuracyStatus, ItemSourceReachabilityStatus, ItemSourceValidation, MutableItemData, Tag };

package/dist/item/index.js

@@ -0,0 +1 @@
+

package/dist/telemetry/index.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+// src/telemetry/zero-friction-funnel.ts
+var ZERO_FRICTION_FUNNEL_EVENTS = {
+  LANDING_PROMPT_SUBMIT: "zero_friction.landing_prompt_submit",
+  ANON_USER_CREATED: "zero_friction.anon_user_created",
+  WIZARD_FINISHED: "zero_friction.wizard_finished",
+  WORK_CREATED: "zero_friction.work_created",
+  REPOS_PUSHED: "zero_friction.repos_pushed",
+  DEPLOY_STARTED: "zero_friction.deploy_started",
+  DEPLOY_READY: "zero_friction.deploy_ready",
+  CLAIM_ACCOUNT: "zero_friction.claim_account"
+};
+
+exports.ZERO_FRICTION_FUNNEL_EVENTS = ZERO_FRICTION_FUNNEL_EVENTS;

package/dist/telemetry/index.d.cts

@@ -0,0 +1,120 @@
+/**
+ * EW-617 G8 — wire format for the zero-friction prompt → deployed Work
+ * funnel events.
+ *
+ * These types pin the canonical event names + payload shapes so the
+ * emit sites (G1 landing form, G2 anon auth, G3 claim, G4 quick-create,
+ * deploy.service.ts, etc.) all agree on the schema and downstream
+ * consumers (PostHog dashboards, log queries, the OpenTelemetry sink)
+ * can rely on stable fields.
+ *
+ * Emit sites in scope:
+ *
+ *   landing-prompt-submit       — website  (G1) — apps/web/components/global/LandingPromptForm.tsx
+ *   anon-user-created           — platform (G2) — apps/api/.../anonymous-auth.service.ts
+ *   wizard-finished             — platform (G4) — apps/web/components/onboarding/EverWorksOnboardingWizard.tsx
+ *   work-created                — platform (G4) — apps/api/.../works.controller.ts (quickCreateWork)
+ *   repos-pushed                — platform       — packages/agent/src/services/work-lifecycle.service.ts (EW-614 path)
+ *   deploy-started              — platform       — apps/api/.../deploy.service.ts (deploy())
+ *   deploy-ready                — platform       — apps/api/.../tasks/deployment-verifier.service.ts
+ *   claim-account               — platform (G3) — apps/api/.../claim-account.service.ts
+ *
+ * Bumping the schema version is a follow-up PR; for now treat the
+ * shapes as additive (clients should ignore unknown fields).
+ */
+declare const ZERO_FRICTION_FUNNEL_EVENTS: {
+    readonly LANDING_PROMPT_SUBMIT: "zero_friction.landing_prompt_submit";
+    readonly ANON_USER_CREATED: "zero_friction.anon_user_created";
+    readonly WIZARD_FINISHED: "zero_friction.wizard_finished";
+    readonly WORK_CREATED: "zero_friction.work_created";
+    readonly REPOS_PUSHED: "zero_friction.repos_pushed";
+    readonly DEPLOY_STARTED: "zero_friction.deploy_started";
+    readonly DEPLOY_READY: "zero_friction.deploy_ready";
+    readonly CLAIM_ACCOUNT: "zero_friction.claim_account";
+};
+type ZeroFrictionFunnelEvent = (typeof ZERO_FRICTION_FUNNEL_EVENTS)[keyof typeof ZERO_FRICTION_FUNNEL_EVENTS];
+interface FunnelEventBase {
+    /** ISO 8601 timestamp the event was emitted. */
+    readonly timestamp: string;
+    /**
+     * Correlation id that survives across the full funnel. Origin: G1
+     * mints a UUID v4 on submit, carries it via the URL fragment
+     * (`#prompt=…&corrId=…`), G4 reads it into wizard state, every
+     * downstream emit reuses it. Lets ops trace a single user across
+     * multiple services + asynchronous task runs.
+     */
+    readonly correlationId: string;
+    /**
+     * Numeric step (1..8) so PostHog can build a funnel without
+     * hard-coding event ordering. Pinned at the top of each interface
+     * below.
+     */
+    readonly funnelStep: number;
+}
+interface LandingPromptSubmitEvent extends FunnelEventBase {
+    readonly funnelStep: 1;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.LANDING_PROMPT_SUBMIT;
+    readonly promptLength: number;
+    /** UA family for top-of-funnel segmentation; never raw UA string. */
+    readonly clientKind: 'browser' | 'crawler' | 'unknown';
+    readonly referer?: string | null;
+}
+interface AnonUserCreatedEvent extends FunnelEventBase {
+    readonly funnelStep: 2;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.ANON_USER_CREATED;
+    readonly anonUserId: string;
+    readonly anonymousExpiresAt: string;
+    /** Truncated /24 (IPv4) or /48 (IPv6) so we never persist raw IPs. */
+    readonly ipPrefix: string | null;
+}
+interface WizardFinishedEvent extends FunnelEventBase {
+    readonly funnelStep: 3;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.WIZARD_FINISHED;
+    readonly userId: string;
+    readonly isAnonymous: boolean;
+    /** Choices captured at the moment Generate-now was clicked. */
+    readonly aiChoice: string;
+    readonly storageChoice: string;
+    readonly deployChoice: string;
+}
+interface WorkCreatedEvent extends FunnelEventBase {
+    readonly funnelStep: 4;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.WORK_CREATED;
+    readonly userId: string;
+    readonly workId: string;
+    readonly workSlug: string;
+    /** True when the row was created via /api/works/quick-create. */
+    readonly viaQuickCreate: boolean;
+}
+interface ReposPushedEvent extends FunnelEventBase {
+    readonly funnelStep: 5;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.REPOS_PUSHED;
+    readonly workId: string;
+    /** `ever-works-cloud/<slug>-data`, `<slug>-website`, `<slug>-mcp`. */
+    readonly repos: readonly string[];
+}
+interface DeployStartedEvent extends FunnelEventBase {
+    readonly funnelStep: 6;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.DEPLOY_STARTED;
+    readonly workId: string;
+    readonly deployProvider: string;
+    readonly ingressHost: string | null;
+}
+interface DeployReadyEvent extends FunnelEventBase {
+    readonly funnelStep: 7;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.DEPLOY_READY;
+    readonly workId: string;
+    readonly websiteUrl: string;
+    /** Milliseconds from `deploy-started` to `deploy-ready`. */
+    readonly elapsedMs: number;
+}
+interface ClaimAccountEvent extends FunnelEventBase {
+    readonly funnelStep: 8;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.CLAIM_ACCOUNT;
+    readonly userId: string;
+    /** True if the user came in via the zero-friction flow + claimed. */
+    readonly viaZeroFriction: boolean;
+}
+type ZeroFrictionFunnelPayload = LandingPromptSubmitEvent | AnonUserCreatedEvent | WizardFinishedEvent | WorkCreatedEvent | ReposPushedEvent | DeployStartedEvent | DeployReadyEvent | ClaimAccountEvent;
+
+export { type AnonUserCreatedEvent, type ClaimAccountEvent, type DeployReadyEvent, type DeployStartedEvent, type FunnelEventBase, type LandingPromptSubmitEvent, type ReposPushedEvent, type WizardFinishedEvent, type WorkCreatedEvent, ZERO_FRICTION_FUNNEL_EVENTS, type ZeroFrictionFunnelEvent, type ZeroFrictionFunnelPayload };

package/dist/telemetry/index.d.ts

@@ -0,0 +1,120 @@
+/**
+ * EW-617 G8 — wire format for the zero-friction prompt → deployed Work
+ * funnel events.
+ *
+ * These types pin the canonical event names + payload shapes so the
+ * emit sites (G1 landing form, G2 anon auth, G3 claim, G4 quick-create,
+ * deploy.service.ts, etc.) all agree on the schema and downstream
+ * consumers (PostHog dashboards, log queries, the OpenTelemetry sink)
+ * can rely on stable fields.
+ *
+ * Emit sites in scope:
+ *
+ *   landing-prompt-submit       — website  (G1) — apps/web/components/global/LandingPromptForm.tsx
+ *   anon-user-created           — platform (G2) — apps/api/.../anonymous-auth.service.ts
+ *   wizard-finished             — platform (G4) — apps/web/components/onboarding/EverWorksOnboardingWizard.tsx
+ *   work-created                — platform (G4) — apps/api/.../works.controller.ts (quickCreateWork)
+ *   repos-pushed                — platform       — packages/agent/src/services/work-lifecycle.service.ts (EW-614 path)
+ *   deploy-started              — platform       — apps/api/.../deploy.service.ts (deploy())
+ *   deploy-ready                — platform       — apps/api/.../tasks/deployment-verifier.service.ts
+ *   claim-account               — platform (G3) — apps/api/.../claim-account.service.ts
+ *
+ * Bumping the schema version is a follow-up PR; for now treat the
+ * shapes as additive (clients should ignore unknown fields).
+ */
+declare const ZERO_FRICTION_FUNNEL_EVENTS: {
+    readonly LANDING_PROMPT_SUBMIT: "zero_friction.landing_prompt_submit";
+    readonly ANON_USER_CREATED: "zero_friction.anon_user_created";
+    readonly WIZARD_FINISHED: "zero_friction.wizard_finished";
+    readonly WORK_CREATED: "zero_friction.work_created";
+    readonly REPOS_PUSHED: "zero_friction.repos_pushed";
+    readonly DEPLOY_STARTED: "zero_friction.deploy_started";
+    readonly DEPLOY_READY: "zero_friction.deploy_ready";
+    readonly CLAIM_ACCOUNT: "zero_friction.claim_account";
+};
+type ZeroFrictionFunnelEvent = (typeof ZERO_FRICTION_FUNNEL_EVENTS)[keyof typeof ZERO_FRICTION_FUNNEL_EVENTS];
+interface FunnelEventBase {
+    /** ISO 8601 timestamp the event was emitted. */
+    readonly timestamp: string;
+    /**
+     * Correlation id that survives across the full funnel. Origin: G1
+     * mints a UUID v4 on submit, carries it via the URL fragment
+     * (`#prompt=…&corrId=…`), G4 reads it into wizard state, every
+     * downstream emit reuses it. Lets ops trace a single user across
+     * multiple services + asynchronous task runs.
+     */
+    readonly correlationId: string;
+    /**
+     * Numeric step (1..8) so PostHog can build a funnel without
+     * hard-coding event ordering. Pinned at the top of each interface
+     * below.
+     */
+    readonly funnelStep: number;
+}
+interface LandingPromptSubmitEvent extends FunnelEventBase {
+    readonly funnelStep: 1;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.LANDING_PROMPT_SUBMIT;
+    readonly promptLength: number;
+    /** UA family for top-of-funnel segmentation; never raw UA string. */
+    readonly clientKind: 'browser' | 'crawler' | 'unknown';
+    readonly referer?: string | null;
+}
+interface AnonUserCreatedEvent extends FunnelEventBase {
+    readonly funnelStep: 2;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.ANON_USER_CREATED;
+    readonly anonUserId: string;
+    readonly anonymousExpiresAt: string;
+    /** Truncated /24 (IPv4) or /48 (IPv6) so we never persist raw IPs. */
+    readonly ipPrefix: string | null;
+}
+interface WizardFinishedEvent extends FunnelEventBase {
+    readonly funnelStep: 3;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.WIZARD_FINISHED;
+    readonly userId: string;
+    readonly isAnonymous: boolean;
+    /** Choices captured at the moment Generate-now was clicked. */
+    readonly aiChoice: string;
+    readonly storageChoice: string;
+    readonly deployChoice: string;
+}
+interface WorkCreatedEvent extends FunnelEventBase {
+    readonly funnelStep: 4;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.WORK_CREATED;
+    readonly userId: string;
+    readonly workId: string;
+    readonly workSlug: string;
+    /** True when the row was created via /api/works/quick-create. */
+    readonly viaQuickCreate: boolean;
+}
+interface ReposPushedEvent extends FunnelEventBase {
+    readonly funnelStep: 5;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.REPOS_PUSHED;
+    readonly workId: string;
+    /** `ever-works-cloud/<slug>-data`, `<slug>-website`, `<slug>-mcp`. */
+    readonly repos: readonly string[];
+}
+interface DeployStartedEvent extends FunnelEventBase {
+    readonly funnelStep: 6;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.DEPLOY_STARTED;
+    readonly workId: string;
+    readonly deployProvider: string;
+    readonly ingressHost: string | null;
+}
+interface DeployReadyEvent extends FunnelEventBase {
+    readonly funnelStep: 7;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.DEPLOY_READY;
+    readonly workId: string;
+    readonly websiteUrl: string;
+    /** Milliseconds from `deploy-started` to `deploy-ready`. */
+    readonly elapsedMs: number;
+}
+interface ClaimAccountEvent extends FunnelEventBase {
+    readonly funnelStep: 8;
+    readonly event: typeof ZERO_FRICTION_FUNNEL_EVENTS.CLAIM_ACCOUNT;
+    readonly userId: string;
+    /** True if the user came in via the zero-friction flow + claimed. */
+    readonly viaZeroFriction: boolean;
+}
+type ZeroFrictionFunnelPayload = LandingPromptSubmitEvent | AnonUserCreatedEvent | WizardFinishedEvent | WorkCreatedEvent | ReposPushedEvent | DeployStartedEvent | DeployReadyEvent | ClaimAccountEvent;
+
+export { type AnonUserCreatedEvent, type ClaimAccountEvent, type DeployReadyEvent, type DeployStartedEvent, type FunnelEventBase, type LandingPromptSubmitEvent, type ReposPushedEvent, type WizardFinishedEvent, type WorkCreatedEvent, ZERO_FRICTION_FUNNEL_EVENTS, type ZeroFrictionFunnelEvent, type ZeroFrictionFunnelPayload };

package/dist/telemetry/index.js

@@ -0,0 +1,13 @@
+// src/telemetry/zero-friction-funnel.ts
+var ZERO_FRICTION_FUNNEL_EVENTS = {
+  LANDING_PROMPT_SUBMIT: "zero_friction.landing_prompt_submit",
+  ANON_USER_CREATED: "zero_friction.anon_user_created",
+  WIZARD_FINISHED: "zero_friction.wizard_finished",
+  WORK_CREATED: "zero_friction.work_created",
+  REPOS_PUSHED: "zero_friction.repos_pushed",
+  DEPLOY_STARTED: "zero_friction.deploy_started",
+  DEPLOY_READY: "zero_friction.deploy_ready",
+  CLAIM_ACCOUNT: "zero_friction.claim_account"
+};
+
+export { ZERO_FRICTION_FUNNEL_EVENTS };