@apex-inc/sdk 0.10.0 → 0.12.0

package/dist/management.d.ts

@@ -46,6 +46,10 @@ export declare function createManagementClient(cfg: ManagementConfig): {
      */
     getSaasRecurringRevenue(opts?: {
         months?: number;
+        /** Explicit window start, YYYY-MM-DD (mapped to calendar months). */
+        start?: string;
+        /** Explicit window end, YYYY-MM-DD. */
+        end?: string;
     }): Promise<unknown>;
     /**
      * SaaS pack — expansion vs contraction MRR, expanded-account counts,
@@ -53,21 +57,34 @@ export declare function createManagementClient(cfg: ManagementConfig): {
      */
     getSaasExpansion(opts?: {
         months?: number;
+        /** Explicit window start, YYYY-MM-DD (mapped to calendar months). */
+        start?: string;
+        /** Explicit window end, YYYY-MM-DD. */
+        end?: string;
     }): Promise<unknown>;
     /**
-     * DTC pack — per-product funnel (views → adds → purchases → refunds)
-     * via the shared item aggregator. Wraps GET /api/dtc/merchandising.
+     * E-commerce pack — per-product funnel (views → adds → purchases →
+     * refunds) via the shared item aggregator. Wraps
+     * GET /api/ecommerce/product-sales.
      */
-    getDtcMerchandising(opts?: {
+    getEcommerceProductSales(opts?: {
         days?: number;
+        /** Explicit window start, YYYY-MM-DD (event log holds 180 days). */
+        start?: string;
+        /** Explicit window end, YYYY-MM-DD. */
+        end?: string;
     }): Promise<unknown>;
     /**
-     * DTC pack — refund rate (money back) and return rate (goods back —
-     * separate metrics, never summed), reasons, refund cycle time, AOV,
-     * repeat purchase. Wraps GET /api/dtc/returns.
+     * E-commerce pack — refund rate (money back) and return rate (goods
+     * back — separate metrics, never summed), reasons, refund cycle time,
+     * AOV, repeat purchase. Wraps GET /api/ecommerce/returns.
      */
-    getDtcReturns(opts?: {
+    getEcommerceReturns(opts?: {
         days?: number;
+        /** Explicit window start, YYYY-MM-DD (event log holds 180 days). */
+        start?: string;
+        /** Explicit window end, YYYY-MM-DD. */
+        end?: string;
     }): Promise<unknown>;
     /**
      * Marketplace pack — the six pillars (liquidity, supply & demand,
@@ -77,6 +94,10 @@ export declare function createManagementClient(cfg: ManagementConfig): {
      */
     getMarketplaceMetrics(opts?: {
         days?: number;
+        /** Explicit window start, YYYY-MM-DD (event log holds 180 days). */
+        start?: string;
+        /** Explicit window end, YYYY-MM-DD. */
+        end?: string;
         category?: string;
         geo?: string;
         price_band?: string;
@@ -90,6 +111,10 @@ export declare function createManagementClient(cfg: ManagementConfig): {
      */
     getClientPortfolio(opts: {
         orgId: string;
+        /** Explicit window start, YYYY-MM-DD (mapped to calendar months). */
+        start?: string;
+        /** Explicit window end, YYYY-MM-DD. */
+        end?: string;
     }): Promise<unknown>;
     assignVariant(experimentId: string, visitorId: string): Promise<AssignVariantResult>;
     /** Fetch a single experiment (unified shape). */
@@ -129,6 +154,68 @@ export declare function createManagementClient(cfg: ManagementConfig): {
         /** Promote a Conversion to primary (only one can be primary at a time). */
         setPrimary(conversionId: string): Promise<ApexConversion>;
     };
+    adoption: {
+        /** List the workspace's adoption milestones. */
+        list(): Promise<ApexAdoptionMilestone[]>;
+        /** Fetch one milestone, or null if it doesn't exist. */
+        get(id: string): Promise<ApexAdoptionMilestone | null>;
+        /** Create a milestone. Starts inactive unless `active: true`. */
+        create(params: ApexAdoptionCreate): Promise<ApexAdoptionMilestone>;
+        /** Patch a milestone (name, priority, active, gapPolicy, adoptedWhen, ...). */
+        update(id: string, updates: Partial<ApexAdoptionCreate> & {
+            active?: boolean;
+        }): Promise<ApexAdoptionMilestone>;
+        /** Delete a milestone. */
+        delete(id: string): Promise<void>;
+        /** Aggregated per-milestone metrics + workspace health (counts only). */
+        metrics(): Promise<ApexAdoptionMetricsResponse>;
+        /**
+         * Per-user adoption progress (milestone status + timestamps). Holdout
+         * membership is intentionally NOT returned by the API, to keep the
+         * experiment unbiased. `endUserId` must be a valid user id (not an email).
+         */
+        progress(endUserId: string): Promise<ApexAdoptionUserProgress[]>;
+        /**
+         * Tenant-owned feature groupings — how the milestone builder groups a
+         * workspace's own events into named "features". Wraps
+         * `/api/adoption/features`.
+         */
+        features: {
+            list(): Promise<ApexAdoptionFeature[]>;
+            /** Create or upsert (by key) a feature grouping. */
+            create(params: {
+                key?: string;
+                label: string;
+                eventNames?: string[];
+            }): Promise<ApexAdoptionFeature>;
+            delete(key: string): Promise<void>;
+        };
+    };
+    segments: {
+        list(opts?: {
+            scope?: "workspace" | "org";
+            include_archived?: boolean;
+        }): Promise<ApexSegment[]>;
+        get(id: string, opts?: {
+            scope?: "workspace" | "org";
+        }): Promise<ApexSegment | null>;
+        create(params: ApexSegmentCreate): Promise<ApexSegment>;
+        update(id: string, updates: Partial<ApexSegmentCreate> & {
+            scope?: "workspace" | "org";
+        }): Promise<ApexSegment>;
+        delete(id: string, opts?: {
+            scope?: "workspace" | "org";
+        }): Promise<void>;
+    };
+    events: {
+        define(params: {
+            name: string;
+            description: string;
+            fields?: Record<string, string>;
+            domain?: string;
+        }): Promise<ApexGovernedEvent>;
+        list(): Promise<ApexGovernedEvent[]>;
+    };
     targets: {
         list(): Promise<ApexTarget[]>;
         create(params: {
@@ -435,6 +522,115 @@ export interface ApexTarget {
     createdAt?: string;
     updatedAt?: string;
 }
+export interface ApexAdoptionAdoptedWhen {
+    kind: "event" | "trait";
+    eventName?: string;
+    traitPath?: string;
+    traitOp?: "equals" | "not_equals" | "exists";
+    traitValue?: string | number | boolean;
+}
+export interface ApexAdoptionGapPolicy {
+    kind: "days_since_signup" | "event_not_fired";
+    days: number;
+    sinceEventName?: string;
+}
+export interface ApexAdoptionMilestone {
+    id: string;
+    featureKey: string;
+    name: string;
+    adoptedWhen: ApexAdoptionAdoptedWhen;
+    priority: number;
+    gapPolicy: ApexAdoptionGapPolicy;
+    nudgeJourneyId?: string;
+    active: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ApexAdoptionFeature {
+    workspaceKey: string;
+    key: string;
+    label: string;
+    eventNames: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/** Friendly condition grammar (compiled server-side into a predicate). */
+export interface ApexFriendlyEventCondition {
+    verb: "has" | "hasnt";
+    event: string;
+    /** Omitted / <= 0 = ever; otherwise last-N-days. */
+    window_days?: number;
+}
+export interface ApexFriendlyAttributeCondition {
+    attribute: string;
+    op: "is" | "is_not" | "exists";
+    value?: string | number | boolean | Array<string | number | boolean>;
+}
+export type ApexFriendlyCondition = ApexFriendlyEventCondition | ApexFriendlyAttributeCondition;
+export interface ApexFriendlyGroup {
+    match: "all" | "any";
+    conditions: ApexFriendlyCondition[];
+}
+export interface ApexFriendlyConditions {
+    match: "all" | "any";
+    groups: ApexFriendlyGroup[];
+}
+export interface ApexSegment {
+    id: string;
+    orgId: string;
+    workspaceKey?: string;
+    scope: "workspace" | "org";
+    name: string;
+    description?: string;
+    predicate: unknown;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Create a segment from friendly `conditions` OR a raw `predicate`. */
+export interface ApexSegmentCreate {
+    name: string;
+    description?: string;
+    scope?: "workspace" | "org";
+    conditions?: ApexFriendlyConditions;
+    predicate?: unknown;
+}
+/** Governed (defined-but-maybe-unfired) event definition. */
+export interface ApexGovernedEvent {
+    name: string;
+    description: string;
+    domain?: string;
+    fields: Record<string, string>;
+    schemaVer: string;
+    status: "draft" | "published";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ApexAdoptionCreate {
+    name: string;
+    featureKey: string;
+    adoptedWhen: ApexAdoptionAdoptedWhen;
+    priority?: number;
+    gapPolicy?: Partial<ApexAdoptionGapPolicy>;
+    nudgeJourneyId?: string;
+    active?: boolean;
+}
+/**
+ * A single milestone's progress for one end-user. Snake_case mirrors the
+ * `/api/adoption/progress` wire shape. Holdout membership is never included.
+ */
+export interface ApexAdoptionUserProgress {
+    milestone_id: string;
+    feature_key: string | null;
+    name: string | null;
+    status: "pending" | "adopted" | "nudged" | "dismissed";
+    adopted_at?: string;
+    nudged_at?: string;
+    last_checked_at?: string;
+}
+export interface ApexAdoptionMetricsResponse {
+    metrics: Array<Record<string, unknown>>;
+    health?: Record<string, unknown>;
+}
 export type ApexDataSourceKind = "website" | "ios" | "android" | "server" | "pos" | "kiosk" | "extension" | "other";
 export type ApexDataSourceStatus = "not-started" | "listening" | "live" | "stalled";
 export interface ApexDataSource {

package/dist/management.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../src/management.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../src/management.ts"],"names":[],"mappings":"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"}

package/dist/management.js

@@ -15,6 +15,24 @@ function keyHeaders(cfg) {
         "x-apex-workspace": cfg.workspaceKey,
     };
 }
+/**
+ * Query string for the pack report windows: relative (`days` / `months`)
+ * or explicit `start` + `end` (YYYY-MM-DD, both required together —
+ * explicit bounds win server-side).
+ */
+function windowQuery(opts) {
+    const params = new URLSearchParams();
+    if (opts?.days)
+        params.set("days", String(opts.days));
+    if (opts?.months)
+        params.set("months", String(opts.months));
+    if (opts?.start && opts?.end) {
+        params.set("start", opts.start);
+        params.set("end", opts.end);
+    }
+    const qs = params.toString();
+    return qs ? `?${qs}` : "";
+}
 /**
  * Create a minimal management client for server-side experiment reads and variant assignment.
  * Assignment uses Cookie apex_vid + apex_project so GET /api/experiments/[id]/assign resolves consistently.
@@ -66,6 +84,12 @@ function createManagementClient(cfg) {
         // query params exactly (shipped params ARE the SDK signature). All
         // endpoints require the `analytics:read` API-key scope; responses
         // apply the same small-n suppression as the dashboard widgets.
+        //
+        // Windowing (2026-07-03 parity with the dashboard date picker): every
+        // report accepts EITHER a relative window (`days` / `months`) OR an
+        // explicit `start` + `end` (YYYY-MM-DD). Explicit bounds win. Month-
+        // grain reports (SaaS MRR, client portfolio) map start/end to the UTC
+        // calendar months the range covers.
         /**
          * SaaS pack — MRR / ARR / monthly waterfall (new / expansion /
          * reactivation / contraction / churn) + NRR / GRR for the last
@@ -74,7 +98,7 @@ function createManagementClient(cfg) {
          * GET /api/saas/recurring-revenue.
          */
         async getSaasRecurringRevenue(opts) {
-            const q = opts?.months ? `?months=${opts.months}` : "";
+            const q = windowQuery(opts);
             const res = await fetch(`${root}/api/saas/recurring-revenue${q}`, { headers });
             if (!res.ok) {
                 const text = await res.text().catch(() => "");
@@ -87,7 +111,7 @@ function createManagementClient(cfg) {
          * and seat growth. Wraps GET /api/saas/expansion.
          */
         async getSaasExpansion(opts) {
-            const q = opts?.months ? `?months=${opts.months}` : "";
+            const q = windowQuery(opts);
             const res = await fetch(`${root}/api/saas/expansion${q}`, { headers });
             if (!res.ok) {
                 const text = await res.text().catch(() => "");
@@ -96,29 +120,30 @@ function createManagementClient(cfg) {
             return res.json();
         },
         /**
-         * DTC pack — per-product funnel (views → adds → purchases → refunds)
-         * via the shared item aggregator. Wraps GET /api/dtc/merchandising.
+         * E-commerce pack — per-product funnel (views → adds → purchases →
+         * refunds) via the shared item aggregator. Wraps
+         * GET /api/ecommerce/product-sales.
          */
-        async getDtcMerchandising(opts) {
-            const q = opts?.days ? `?days=${opts.days}` : "";
-            const res = await fetch(`${root}/api/dtc/merchandising${q}`, { headers });
+        async getEcommerceProductSales(opts) {
+            const q = windowQuery(opts);
+            const res = await fetch(`${root}/api/ecommerce/product-sales${q}`, { headers });
             if (!res.ok) {
                 const text = await res.text().catch(() => "");
-                throw new Error(`Apex getDtcMerchandising failed (${res.status}): ${text}`);
+                throw new Error(`Apex getEcommerceProductSales failed (${res.status}): ${text}`);
             }
             return res.json();
         },
         /**
-         * DTC pack — refund rate (money back) and return rate (goods back —
-         * separate metrics, never summed), reasons, refund cycle time, AOV,
-         * repeat purchase. Wraps GET /api/dtc/returns.
+         * E-commerce pack — refund rate (money back) and return rate (goods
+         * back — separate metrics, never summed), reasons, refund cycle time,
+         * AOV, repeat purchase. Wraps GET /api/ecommerce/returns.
          */
-        async getDtcReturns(opts) {
-            const q = opts?.days ? `?days=${opts.days}` : "";
-            const res = await fetch(`${root}/api/dtc/returns${q}`, { headers });
+        async getEcommerceReturns(opts) {
+            const q = windowQuery(opts);
+            const res = await fetch(`${root}/api/ecommerce/returns${q}`, { headers });
             if (!res.ok) {
                 const text = await res.text().catch(() => "");
-                throw new Error(`Apex getDtcReturns failed (${res.status}): ${text}`);
+                throw new Error(`Apex getEcommerceReturns failed (${res.status}): ${text}`);
             }
             return res.json();
         },
@@ -132,6 +157,10 @@ function createManagementClient(cfg) {
             const params = new URLSearchParams();
             if (opts?.days)
                 params.set("days", String(opts.days));
+            if (opts?.start && opts?.end) {
+                params.set("start", opts.start);
+                params.set("end", opts.end);
+            }
             if (opts?.category)
                 params.set("category", opts.category);
             if (opts?.geo)
@@ -154,7 +183,14 @@ function createManagementClient(cfg) {
          * returns 401/403. Wraps GET /api/agency/clients.
          */
         async getClientPortfolio(opts) {
-            const res = await fetch(`${root}/api/agency/clients?orgId=${encodeURIComponent(opts.orgId)}`, { headers });
+            const params = new URLSearchParams({ orgId: opts.orgId });
+            if (opts.start && opts.end) {
+                params.set("start", opts.start);
+                params.set("end", opts.end);
+            }
+            const res = await fetch(`${root}/api/agency/clients?${params.toString()}`, {
+                headers,
+            });
             if (!res.ok) {
                 const text = await res.text().catch(() => "");
                 throw new Error(`Apex getClientPortfolio failed (${res.status}): ${text}`);
@@ -253,6 +289,189 @@ function createManagementClient(cfg) {
                 return res.json();
             },
         },
+        // ─── Adoption Engine ──────────────────────────────────────────────
+        //
+        // Per-feature adoption milestones defined over the workspace's own
+        // events/traits. Apex nudges users who haven't adopted (one next-best
+        // nudge per user) and measures lift against a holdout. Wraps the same
+        // /api/adoption endpoints the dashboard + MCP server use.
+        adoption: {
+            /** List the workspace's adoption milestones. */
+            async list() {
+                const res = await fetch(`${root}/api/adoption/milestones`, { headers });
+                if (!res.ok)
+                    throw new Error(`Apex adoption.list failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.data?.milestones ?? [];
+            },
+            /** Fetch one milestone, or null if it doesn't exist. */
+            async get(id) {
+                const res = await fetch(`${root}/api/adoption/milestones/${encodeURIComponent(id)}`, { headers });
+                if (res.status === 404)
+                    return null;
+                if (!res.ok)
+                    throw new Error(`Apex adoption.get failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.data?.milestone ?? null;
+            },
+            /** Create a milestone. Starts inactive unless `active: true`. */
+            async create(params) {
+                const res = await fetch(`${root}/api/adoption/milestones`, {
+                    method: "POST", headers, body: JSON.stringify(params),
+                });
+                if (!res.ok)
+                    throw new Error(`Apex adoption.create failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.data.milestone;
+            },
+            /** Patch a milestone (name, priority, active, gapPolicy, adoptedWhen, ...). */
+            async update(id, updates) {
+                const res = await fetch(`${root}/api/adoption/milestones/${encodeURIComponent(id)}`, {
+                    method: "PATCH", headers, body: JSON.stringify(updates),
+                });
+                if (!res.ok)
+                    throw new Error(`Apex adoption.update failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.data.milestone;
+            },
+            /** Delete a milestone. */
+            async delete(id) {
+                const res = await fetch(`${root}/api/adoption/milestones/${encodeURIComponent(id)}`, {
+                    method: "DELETE", headers,
+                });
+                if (!res.ok)
+                    throw new Error(`Apex adoption.delete failed (${res.status}): ${await res.text().catch(() => "")}`);
+            },
+            /** Aggregated per-milestone metrics + workspace health (counts only). */
+            async metrics() {
+                const res = await fetch(`${root}/api/adoption/metrics`, { headers });
+                if (!res.ok)
+                    throw new Error(`Apex adoption.metrics failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.data ?? { metrics: [] };
+            },
+            /**
+             * Per-user adoption progress (milestone status + timestamps). Holdout
+             * membership is intentionally NOT returned by the API, to keep the
+             * experiment unbiased. `endUserId` must be a valid user id (not an email).
+             */
+            async progress(endUserId) {
+                const res = await fetch(`${root}/api/adoption/progress?end_user_id=${encodeURIComponent(endUserId)}`, { headers });
+                if (!res.ok)
+                    throw new Error(`Apex adoption.progress failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.data?.progress ?? [];
+            },
+            /**
+             * Tenant-owned feature groupings — how the milestone builder groups a
+             * workspace's own events into named "features". Wraps
+             * `/api/adoption/features`.
+             */
+            features: {
+                async list() {
+                    const res = await fetch(`${root}/api/adoption/features`, { headers });
+                    if (!res.ok)
+                        throw new Error(`Apex adoption.features.list failed (${res.status}): ${await res.text().catch(() => "")}`);
+                    const json = (await res.json());
+                    return json.data?.features ?? [];
+                },
+                /** Create or upsert (by key) a feature grouping. */
+                async create(params) {
+                    const res = await fetch(`${root}/api/adoption/features`, {
+                        method: "POST", headers, body: JSON.stringify(params),
+                    });
+                    if (!res.ok)
+                        throw new Error(`Apex adoption.features.create failed (${res.status}): ${await res.text().catch(() => "")}`);
+                    const json = (await res.json());
+                    return json.data.feature;
+                },
+                async delete(key) {
+                    const res = await fetch(`${root}/api/adoption/features?key=${encodeURIComponent(key)}`, {
+                        method: "DELETE", headers,
+                    });
+                    if (!res.ok)
+                        throw new Error(`Apex adoption.features.delete failed (${res.status}): ${await res.text().catch(() => "")}`);
+                },
+            },
+        },
+        // ─── Segments ─────────────────────────────────────────────────────
+        //
+        // Saved groups of customers over the workspace's own events + traits.
+        // `create`/`update` accept EITHER friendly `conditions` (compiled
+        // server-side) OR a raw `predicate` — the same one grammar the
+        // dashboard chip builder and the MCP `create_segment` tool speak.
+        segments: {
+            async list(opts) {
+                const q = new URLSearchParams();
+                if (opts?.scope)
+                    q.set("scope", opts.scope);
+                if (opts?.include_archived)
+                    q.set("includeArchived", "1");
+                const qs = q.toString();
+                const res = await fetch(`${root}/api/segments${qs ? `?${qs}` : ""}`, { headers });
+                if (!res.ok)
+                    throw new Error(`Apex segments.list failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return Array.isArray(json) ? json : (json.data ?? []);
+            },
+            async get(id, opts) {
+                const q = opts?.scope ? `?scope=${opts.scope}` : "";
+                const res = await fetch(`${root}/api/segments/${encodeURIComponent(id)}${q}`, { headers });
+                if (res.status === 404)
+                    return null;
+                if (!res.ok)
+                    throw new Error(`Apex segments.get failed (${res.status}): ${await res.text().catch(() => "")}`);
+                return res.json();
+            },
+            async create(params) {
+                const res = await fetch(`${root}/api/segments`, {
+                    method: "POST", headers, body: JSON.stringify({ scope: "workspace", ...params }),
+                });
+                if (!res.ok)
+                    throw new Error(`Apex segments.create failed (${res.status}): ${await res.text().catch(() => "")}`);
+                return res.json();
+            },
+            async update(id, updates) {
+                const res = await fetch(`${root}/api/segments/${encodeURIComponent(id)}`, {
+                    method: "PATCH", headers, body: JSON.stringify(updates),
+                });
+                if (!res.ok)
+                    throw new Error(`Apex segments.update failed (${res.status}): ${await res.text().catch(() => "")}`);
+                return res.json();
+            },
+            async delete(id, opts) {
+                const q = opts?.scope ? `?scope=${opts.scope}` : "";
+                const res = await fetch(`${root}/api/segments/${encodeURIComponent(id)}${q}`, {
+                    method: "DELETE", headers,
+                });
+                if (!res.ok)
+                    throw new Error(`Apex segments.delete failed (${res.status}): ${await res.text().catch(() => "")}`);
+            },
+        },
+        // ─── Events (schema registry) ─────────────────────────────────────
+        //
+        // Define an event BEFORE it fires (governed events). Defining ≠ firing:
+        // a developer still calls `apex.track("...")` from the app to make it
+        // live. Wraps `/api/schema/events`.
+        events: {
+            async define(params) {
+                const res = await fetch(`${root}/api/schema/events`, {
+                    method: "POST",
+                    headers,
+                    body: JSON.stringify({ fields: {}, ...params }),
+                });
+                if (!res.ok)
+                    throw new Error(`Apex events.define failed (${res.status}): ${await res.text().catch(() => "")}`);
+                return res.json();
+            },
+            async list() {
+                const res = await fetch(`${root}/api/schema/events`, { headers });
+                if (!res.ok)
+                    throw new Error(`Apex events.list failed (${res.status}): ${await res.text().catch(() => "")}`);
+                const json = (await res.json());
+                return json.events ?? [];
+            },
+        },
         // ─── Targets (Goals & Conversions Convergence) ────────────────────
         //
         // A Target is an aggregate KPI number to hit by a date (MRR, pipeline,