@apex-inc/sdk 0.1.1 → 0.6.0

package/dist/index.d.ts

@@ -1,5 +1,11 @@
 export interface ApexConfig {
-    projectKey: string;
+    workspaceKey: string;
+    /**
+     * @deprecated Use `workspaceKey`. Permanent back-compat alias from
+     * the project→workspace rename (2026-06); existing installs passing
+     * `projectKey` keep working forever.
+     */
+    projectKey?: string;
     apiUrl?: string;
     /** Flush interval in ms (default: 5000) */
     flushInterval?: number;
@@ -7,6 +13,25 @@ export interface ApexConfig {
     flushAt?: number;
     /** Enable debug logging (default: false) */
     debug?: boolean;
+    /**
+     * MMP-070 — Web environment override.
+     *
+     * Apex auto-detects production / preview / localhost from the
+     * request hostname at ingest, which works correctly out of the box
+     * for ~95% of merchants. Set this when:
+     *
+     *   - Your staging deploy lives on a custom domain that looks like
+     *     production (e.g. `app-staging.acme.com` resolves to
+     *     production but you want it billed as preview).
+     *   - You want to force `localhost` in a hosted test harness.
+     *   - You're running CI smoke tests that should never bill.
+     *
+     * Accepted values: `"production"`, `"preview"`, `"localhost"`.
+     * Server-side, `preview` and `localhost` are FREE — they don't
+     * count toward billing or fire outbound webhooks unless the
+     * webhook explicitly opts into those audiences.
+     */
+    environment?: "production" | "preview" | "localhost";
 }
 export interface TrackEvent {
     event: string;
@@ -17,18 +42,85 @@ export interface IdentifyPayload {
     userId: string;
     traits?: Record<string, unknown>;
 }
+/**
+ * MWO-009 — Group payload. Used for B2B account-level grouping so
+ * Apex can compute Product-Qualified Account (PQA) rollups from
+ * individual user events.
+ */
+export interface GroupPayload {
+    groupId: string;
+    traits?: Record<string, unknown>;
+}
+/**
+ * MWO-009 — Feature usage payload. Fire from your app when a feature
+ * is used so adoption rates and aha-moment funnels can be derived
+ * without bespoke queries.
+ */
+export interface FeaturePayload {
+    featureKey: string;
+    enabled?: boolean;
+    variant?: string;
+    properties?: Record<string, unknown>;
+}
 /**
  * Initialize the Apex SDK. Must be called before track() or identify().
+ * Accepts `workspaceKey` (canonical) or the deprecated `projectKey`.
  */
-export declare function init(options: ApexConfig): void;
+export declare function init(options: ApexConfig | (Omit<ApexConfig, "workspaceKey"> & {
+    workspaceKey?: string;
+    projectKey: string;
+})): void;
 /**
  * Track a custom event.
  */
 export declare function track(event: string, properties?: Record<string, unknown>): void;
+/**
+ * Canonical Apex Spec user attribute names (snake_case). Emitting these
+ * keeps templates clean — `{{first_name}}` resolves directly. Aliases like
+ * `firstName` / `zip` still work (Apex maps them), but canonical names skip
+ * the mapping step. Arbitrary custom traits are allowed alongside these.
+ */
+export interface CanonicalUserTraits {
+    email?: string;
+    email_verified?: boolean;
+    first_name?: string;
+    last_name?: string;
+    full_name?: string;
+    username?: string;
+    phone?: string;
+    avatar_url?: string;
+    title?: string;
+    company?: string;
+    gender?: string;
+    birthday?: string;
+    address_line1?: string;
+    address_line2?: string;
+    city?: string;
+    region?: string;
+    postal_code?: string;
+    country?: string;
+    country_code?: string;
+    timezone?: string;
+    locale?: string;
+    created_at?: string;
+    last_seen_at?: string;
+    plan?: string;
+    subscription_status?: string;
+    trial_ends_at?: string;
+    lifetime_value?: number;
+    marketing_opt_in?: boolean;
+    /** Stitch server-side identify to the browser session (apex_vid cookie). */
+    visitorId?: string;
+}
+/** Traits accepted by `identify()` — canonical attributes plus any custom keys. */
+export type IdentifyTraits = CanonicalUserTraits & Record<string, unknown>;
 /**
  * Identify a user with traits (email, name, plan, etc.).
  * Also performs identity stitching if the userId looks like an email.
  *
+ * Prefer canonical snake_case trait names (see `CanonicalUserTraits`) so
+ * templates resolve them cleanly.
+ *
  * Pass `traits.visitorId` (the browser's `apex_vid` cookie value) to stitch
  * server-side identify calls to the real browser session. Without it, the SDK
  * creates a synthetic visitor ID that is disconnected from marketing touchpoints.
@@ -36,7 +128,25 @@ export declare function track(event: string, properties?: Record<string, unknown
  * PLG integration pattern:
  *   apex.identify('user@example.com', { visitorId: req.cookies.apex_vid })
  */
-export declare function identify(userId_: string, traits?: Record<string, unknown>): void;
+export declare function identify(userId_: string, traits?: IdentifyTraits): void;
+export declare function group(groupId_: string, traits?: Record<string, unknown>): void;
+/**
+ * MWO-009 — Feature usage. Fire from your app whenever a user
+ * touches a named feature. Variant + enabled support wiring to
+ * Apex experiment payloads — if Phase 8's experiment engine served
+ * a variant, pass it through here to close the loop between
+ * assignment and adoption.
+ */
+export declare function feature(featureKey: string, opts?: {
+    enabled?: boolean;
+    variant?: string;
+    properties?: Record<string, unknown>;
+}): void;
+/**
+ * Returns the most recently set groupId (if any). Callers can use
+ * this to decorate their own payloads or assert in tests.
+ */
+export declare function currentGroupId(): string | null;
 /**
  * Track a form submission event with the email for identity stitching.
  */
@@ -50,9 +160,149 @@ export declare function trackForm(formData: {
  * Immediately flush all queued events to the server.
  */
 export declare function flush(): void;
+/** Canonical line shape consumed by the server-side cart rollup. */
+export interface CartLine {
+    /** Merchant SKU (required for stable line identity). */
+    sku: string;
+    /** Items in the line. Negative values are clamped to 0 server-side. */
+    qty: number;
+    priceCents?: number;
+    currency?: string;
+    /** Display name for the Contact-drawer rendering. */
+    name?: string;
+    /**
+     * Stable per-merchant line id. Defaults to `sku` server-side, but
+     * pass an explicit value (e.g. `cart_line_<id>`) when a single SKU
+     * can have multiple cart lines (e.g. configurable products).
+     */
+    stableLineId?: string;
+}
+/**
+ * Helpers grouped under `trackCart.*` so call sites read naturally
+ * (`apex.trackCart.add({...})`). The implementation just delegates to
+ * `track()` with the canonical event names.
+ */
+export declare const trackCart: {
+    /** Fired when a user adds an item to their cart. */
+    readonly add: (line: CartLine) => void;
+    /** Fired when a user removes an item from their cart. */
+    readonly remove: (opts: {
+        sku: string;
+        qty: number;
+        stableLineId?: string;
+        /** Optional total cart value post-remove for snapshot reconciliation. */
+        cartValueCents?: number;
+        currency?: string;
+    }) => void;
+    /**
+     * Full-cart reconciliation snapshot. Use whenever the canonical
+     * cart state is loaded (login restore, app foreground, cart screen
+     * mount). The server-side rollup replaces all stored lines wholesale
+     * — this is the "source of truth" event when deltas drift.
+     */
+    readonly snapshot: (opts: {
+        lines: CartLine[];
+        currency?: string;
+    }) => void;
+    /** Fired on checkout success; clears the rolled-up cart. */
+    readonly checkout: (opts: {
+        orderId: string;
+        totalCents: number;
+        currency?: string;
+    }) => void;
+};
 /**
  * Shut down the SDK — flush remaining events and stop the timer.
  */
 export declare function shutdown(): void;
-export { createManagementClient, type ManagementConfig, type AssignVariantResult, } from "./management";
+export { createManagementClient, type ManagementConfig, type AssignVariantResult, type CommChannel, type EndUserCommPreferences, type InboxNotification, type ApexDataSourceKind, type ApexDataSourceStatus, type ApexDataSource, type ApexDataSourceHealth, type ApexHostSeen, type ApexAnalyticsSources, } from "./management";
+/**
+ * Configuration for server-side event delivery.
+ */
+export interface ServerEventsConfig {
+    /** Server API key (`apex_sk_…`). Required. */
+    apiKey: string;
+    /**
+     * Apex API base URL (defaults to `https://app.apex.inc`). Override
+     * for self-hosted instances or local dev.
+     */
+    apiUrl?: string;
+    /**
+     * When your org has multiple workspaces, set this to disambiguate.
+     * Optional — Apex auto-picks if the org has exactly one workspace.
+     */
+    workspaceKey?: string;
+}
+/**
+ * A single server-side event in the Apex Spec shape.
+ */
+export interface ServerEvent {
+    /** Event name. Use Apex Spec verbs ("purchase_completed",
+     *  "signup_completed") for free dashboard wiring; arbitrary strings
+     *  are accepted. */
+    type: string;
+    /** Visitor ID that ties this event back to the original web /
+     *  mobile session. Optional when you only have an email. */
+    visitorId?: string;
+    /** Email address. Server-side stitches by email when visitorId is
+     *  not available. */
+    email?: string;
+    /** Free-form event payload (value, currency, order_id, …). */
+    data?: Record<string, unknown>;
+    /** ISO 8601 timestamp. Defaults to receipt time on the server. */
+    timestamp?: string;
+}
+/**
+ * Response from a successful (or deduplicated) batch.
+ */
+export interface ServerEventsResponse {
+    data: {
+        received: number;
+        duplicates: number;
+        errors: Array<{
+            index: number;
+            reason: string;
+        }>;
+        deduped?: boolean;
+    };
+    metadata?: {
+        workspaceKey?: string;
+        idempotencyKey?: string;
+        batchSize?: number;
+    };
+}
+/**
+ * Generate a stable idempotency key. Prefers `crypto.randomUUID()`
+ * when available (Node 19+, modern browsers). Falls back to a
+ * timestamp + random suffix that's good enough to avoid collisions
+ * within a single process.
+ */
+export declare function newIdempotencyKey(): string;
+/**
+ * Send a single event server-to-server. Useful for Stripe webhooks,
+ * CRM-driven conversions, and any backend signal that should land in
+ * Apex without going through the browser snippet.
+ *
+ * @example
+ * await sendServerEvent(
+ *   { apiKey: process.env.APEX_API_KEY! },
+ *   {
+ *     type: "purchase_completed",
+ *     email: "user@example.com",
+ *     data: { value: 99, currency: "USD", order_id: "order_42" },
+ *   },
+ *   { idempotencyKey: stripeEvent.id }
+ * );
+ */
+export declare function sendServerEvent(config: ServerEventsConfig, event: ServerEvent, options?: {
+    idempotencyKey?: string;
+}): Promise<ServerEventsResponse>;
+/**
+ * Send up to 100 events server-to-server in one request. Larger
+ * batches must be sharded by the caller (the API returns 400
+ * `batch_too_large` otherwise).
+ */
+export declare function sendServerEvents(config: ServerEventsConfig, events: ServerEvent[], options?: {
+    idempotencyKey?: string;
+}): Promise<ServerEventsResponse>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AA4ED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAK9C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAW/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBhF;AA+BD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAgBP;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAI5B;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAQ/B;AAED,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -33,13 +33,19 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createManagementClient = void 0;
+exports.createManagementClient = exports.trackCart = void 0;
 exports.init = init;
 exports.track = track;
 exports.identify = identify;
+exports.group = group;
+exports.feature = feature;
+exports.currentGroupId = currentGroupId;
 exports.trackForm = trackForm;
 exports.flush = flush;
 exports.shutdown = shutdown;
+exports.newIdempotencyKey = newIdempotencyKey;
+exports.sendServerEvent = sendServerEvent;
+exports.sendServerEvents = sendServerEvents;
 const isBrowser = typeof window !== "undefined";
 const DEFAULT_API_URL = isBrowser ? window.location.origin : "http://localhost:3000";
 let config = null;
@@ -56,9 +62,14 @@ async function sendBatch(events) {
     const apiUrl = config.apiUrl ?? DEFAULT_API_URL;
     const url = `${apiUrl.replace(/\/$/, "")}/api/events`;
     const body = JSON.stringify({
-        projectKey: config.projectKey,
+        workspaceKey: config.workspaceKey,
         userId,
         events,
+        // MMP-070 — propagate the SDK-level environment override (when
+        // set by `apex.init({ environment })`). The server prefers this
+        // over auto-detection from the Referer/Origin host. Mobile SDKs
+        // don't send this field; they set `mobile.releaseChannel` instead.
+        ...(config.environment ? { webEnvironment: config.environment } : {}),
     });
     try {
         const fetchFn = typeof fetch !== "undefined" ? fetch : await loadNodeFetch();
@@ -105,11 +116,16 @@ function enqueue(event) {
 // ─── Public API ──────────────────────────────────────────────────────────────
 /**
  * Initialize the Apex SDK. Must be called before track() or identify().
+ * Accepts `workspaceKey` (canonical) or the deprecated `projectKey`.
  */
 function init(options) {
-    config = options;
+    const workspaceKey = options.workspaceKey ?? options.projectKey;
+    if (!workspaceKey) {
+        throw new Error("apex.init: `workspaceKey` is required");
+    }
+    config = { ...options, workspaceKey };
     queue = [];
-    log("Initialized with project:", options.projectKey);
+    log("Initialized with workspace:", workspaceKey);
     startFlushTimer();
 }
 /**
@@ -131,6 +147,9 @@ function track(event, properties) {
  * Identify a user with traits (email, name, plan, etc.).
  * Also performs identity stitching if the userId looks like an email.
  *
+ * Prefer canonical snake_case trait names (see `CanonicalUserTraits`) so
+ * templates resolve them cleanly.
+ *
  * Pass `traits.visitorId` (the browser's `apex_vid` cookie value) to stitch
  * server-side identify calls to the real browser session. Without it, the SDK
  * creates a synthetic visitor ID that is disconnected from marketing touchpoints.
@@ -153,15 +172,21 @@ function identify(userId_, traits) {
     const email = userId_.includes("@") ? userId_ : traits?.email;
     if (email) {
         const browserVisitorId = traits?.visitorId;
-        stitchIdentity(email, browserVisitorId, traits);
+        // Forward the caller's stable user id as `userId` whenever it is NOT
+        // itself an email — this becomes the highest-precedence
+        // `internal_user_id` identifier server-side, which is what makes
+        // anonymous→known reconciliation deterministic. Always identify with
+        // your own user id (e.g. Cognito sub / DB id), not just an email.
+        const stableUserId = userId_.includes("@") ? undefined : userId_;
+        stitchIdentity(email, browserVisitorId, traits, stableUserId);
     }
 }
-async function stitchIdentity(email, browserVisitorId, metadata) {
+async function stitchIdentity(email, browserVisitorId, metadata, stableUserId) {
     if (!config)
         return;
     const apiUrl = config.apiUrl ?? DEFAULT_API_URL;
     const url = `${apiUrl.replace(/\/$/, "")}/api/identity/stitch`;
-    const effectiveVisitorId = browserVisitorId || `sdk-${config.projectKey}-${email}`;
+    const effectiveVisitorId = browserVisitorId || `sdk-${config.workspaceKey}-${email}`;
     try {
         const fetchFn = typeof fetch !== "undefined" ? fetch : await loadNodeFetch();
         await fetchFn(url, {
@@ -170,7 +195,8 @@ async function stitchIdentity(email, browserVisitorId, metadata) {
             body: JSON.stringify({
                 visitorId: effectiveVisitorId,
                 email,
-                projectKey: config.projectKey,
+                workspaceKey: config.workspaceKey,
+                ...(stableUserId ? { userId: stableUserId } : {}),
                 metadata: metadata ?? {},
             }),
         });
@@ -180,6 +206,56 @@ async function stitchIdentity(email, browserVisitorId, metadata) {
         log("Identity stitch failed:", err);
     }
 }
+/**
+ * MWO-009 — Group a user into an account / company / team so B2B
+ * PQA rollups can be derived. Calling `group("acme-inc")` stamps
+ * every subsequent `track`/`feature` event with `groupId`.
+ */
+let groupId = null;
+function group(groupId_, traits) {
+    if (!config) {
+        console.warn("[apex-sdk] Call init() before group()");
+        return;
+    }
+    groupId = groupId_;
+    log("Group:", groupId_, traits);
+    enqueue({
+        type: "group",
+        payload: { groupId: groupId_, traits },
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * MWO-009 — Feature usage. Fire from your app whenever a user
+ * touches a named feature. Variant + enabled support wiring to
+ * Apex experiment payloads — if Phase 8's experiment engine served
+ * a variant, pass it through here to close the loop between
+ * assignment and adoption.
+ */
+function feature(featureKey, opts = {}) {
+    if (!config) {
+        console.warn("[apex-sdk] Call init() before feature()");
+        return;
+    }
+    log("Feature:", featureKey, opts);
+    enqueue({
+        type: "feature",
+        payload: {
+            featureKey,
+            enabled: opts.enabled,
+            variant: opts.variant,
+            properties: opts.properties,
+        },
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Returns the most recently set groupId (if any). Callers can use
+ * this to decorate their own payloads or assert in tests.
+ */
+function currentGroupId() {
+    return groupId;
+}
 /**
  * Track a form submission event with the email for identity stitching.
  */
@@ -207,6 +283,34 @@ function flush() {
     const batch = queue.splice(0, queue.length);
     sendBatch(batch);
 }
+/**
+ * Helpers grouped under `trackCart.*` so call sites read naturally
+ * (`apex.trackCart.add({...})`). The implementation just delegates to
+ * `track()` with the canonical event names.
+ */
+exports.trackCart = {
+    /** Fired when a user adds an item to their cart. */
+    add(line) {
+        track("add_to_cart", { ...line });
+    },
+    /** Fired when a user removes an item from their cart. */
+    remove(opts) {
+        track("remove_from_cart", { ...opts });
+    },
+    /**
+     * Full-cart reconciliation snapshot. Use whenever the canonical
+     * cart state is loaded (login restore, app foreground, cart screen
+     * mount). The server-side rollup replaces all stored lines wholesale
+     * — this is the "source of truth" event when deltas drift.
+     */
+    snapshot(opts) {
+        track("cart_snapshot", { ...opts });
+    },
+    /** Fired on checkout success; clears the rolled-up cart. */
+    checkout(opts) {
+        track("checkout_completed", { ...opts });
+    },
+};
 /**
  * Shut down the SDK — flush remaining events and stop the timer.
  */
@@ -221,4 +325,74 @@ function shutdown() {
 }
 var management_1 = require("./management");
 Object.defineProperty(exports, "createManagementClient", { enumerable: true, get: function () { return management_1.createManagementClient; } });
+/**
+ * Generate a stable idempotency key. Prefers `crypto.randomUUID()`
+ * when available (Node 19+, modern browsers). Falls back to a
+ * timestamp + random suffix that's good enough to avoid collisions
+ * within a single process.
+ */
+function newIdempotencyKey() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    return `idk_${Date.now()}_${Math.random().toString(36).slice(2, 12)}`;
+}
+/**
+ * Send a single event server-to-server. Useful for Stripe webhooks,
+ * CRM-driven conversions, and any backend signal that should land in
+ * Apex without going through the browser snippet.
+ *
+ * @example
+ * await sendServerEvent(
+ *   { apiKey: process.env.APEX_API_KEY! },
+ *   {
+ *     type: "purchase_completed",
+ *     email: "user@example.com",
+ *     data: { value: 99, currency: "USD", order_id: "order_42" },
+ *   },
+ *   { idempotencyKey: stripeEvent.id }
+ * );
+ */
+async function sendServerEvent(config, event, options = {}) {
+    return sendServerEvents(config, [event], options);
+}
+/**
+ * Send up to 100 events server-to-server in one request. Larger
+ * batches must be sharded by the caller (the API returns 400
+ * `batch_too_large` otherwise).
+ */
+async function sendServerEvents(config, events, options = {}) {
+    if (!config.apiKey) {
+        throw new Error("apex-sdk: sendServerEvent requires apiKey");
+    }
+    if (events.length === 0) {
+        throw new Error("apex-sdk: sendServerEvent requires at least one event");
+    }
+    if (events.length > 100) {
+        throw new Error("apex-sdk: sendServerEvents batch_too_large — max 100 events; shard yourself");
+    }
+    const apiUrl = (config.apiUrl ?? "https://app.apex.inc").replace(/\/$/, "");
+    const url = `${apiUrl}/api/v1/events`;
+    const idempotencyKey = options.idempotencyKey ?? newIdempotencyKey();
+    const headers = {
+        "content-type": "application/json",
+        "x-api-key": config.apiKey,
+        "idempotency-key": idempotencyKey,
+    };
+    if (config.workspaceKey)
+        headers["x-apex-workspace"] = config.workspaceKey;
+    const fetchFn = typeof fetch !== "undefined" ? fetch : await loadNodeFetch();
+    const res = await fetchFn(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ events }),
+    });
+    const json = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        const code = json.error?.code ?? `http_${res.status}`;
+        const message = json.error?.message ?? `HTTP ${res.status}`;
+        throw new Error(`apex-sdk: sendServerEvent failed (${code}): ${message}`);
+    }
+    return json;
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmGA,oBAKC;AAKD,sBAWC;AAaD,4BAkBC;AAkCD,8BAqBC;AAKD,sBAIC;AAKD,4BAQC;AAxMD,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC;AAChD,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC;AAErF,IAAI,MAAM,GAAsB,IAAI,CAAC;AACrC,IAAI,KAAK,GAAkB,EAAE,CAAC;AAC9B,IAAI,UAAU,GAA0C,IAAI,CAAC;AAC7D,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,SAAS,GAAG,CAAC,GAAG,IAAe;IAC7B,IAAI,MAAM,EAAE,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,MAAqB;IAC5C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE3C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC;IAChD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC;IAEtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,aAAa,EAAE,CAAC;QAC7E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI;SACL,CAAC,CAAC;QACH,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,+DAA+D;IAC/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,yBAAa,YAAsB,uCAAC,CAAC;QACjD,OAAO,GAAG,CAAC,OAAkC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,UAAU;QAAE,OAAO;IACvB,MAAM,QAAQ,GAAG,MAAM,EAAE,aAAa,IAAI,IAAI,CAAC;IAC/C,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;IAElD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QACvD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;YACjD,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ;gBAAE,KAAK,EAAE,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAkB;IACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,IAAI,OAAO;QAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,IAAI,CAAC,OAAmB;IACtC,MAAM,GAAG,OAAO,CAAC;IACjB,KAAK,GAAG,EAAE,CAAC;IACX,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,eAAe,EAAE,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,KAAa,EAAE,UAAoC;IACvE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACjC,OAAO,CAAC;QACN,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACnE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,OAAe,EAAE,MAAgC;IACxE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IACD,MAAM,GAAG,OAAO,CAAC;IACjB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC;QACN,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QACpC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,MAAM,EAAE,KAA4B,CAAC;IACtF,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,gBAAgB,GAAG,MAAM,EAAE,SAA+B,CAAC;QACjE,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,KAAa,EACb,gBAAyB,EACzB,QAAkC;IAElC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC;IAChD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC;IAE/D,MAAM,kBAAkB,GAAG,gBAAgB,IAAI,OAAO,MAAM,CAAC,UAAU,IAAI,KAAK,EAAE,CAAC;IAEnF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,aAAa,EAAE,CAAC;QAC7E,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,kBAAkB;gBAC7B,KAAK;gBACL,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,QAAQ,IAAI,EAAE;aACzB,CAAC;SACH,CAAC,CAAC;QACH,GAAG,CAAC,wBAAwB,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,QAKzB;IACC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IACnD,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAEjC,KAAK,CAAC,aAAa,EAAE;QACnB,MAAM;QACN,UAAU,EAAE,MAAM;QAClB,KAAK;QACL,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;KAClB,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK;IACnB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,SAAS,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ;IACtB,KAAK,EAAE,CAAC;IACR,IAAI,UAAU,EAAE,CAAC;QACf,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1B,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,MAAM,GAAG,IAAI,CAAC;IACd,GAAG,CAAC,WAAW,CAAC,CAAC;AACnB,CAAC;AAED,2CAIsB;AAHpB,oHAAA,sBAAsB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}