@avsbhq/node 1.6.0 → 1.6.2

package/README.md

@@ -55,7 +55,7 @@ Get the SDK key for the environment you want to target from your A vs B project'
 AVSB_SDK_KEY=sdk_production_...
 ```
 
-When used server-side, the SDK key only ever needs to leave the server to hit the datafile CDN — it should never end up in client-rendered HTML, browser bundles, or browser-accessible config. Store it in environment variables only.
+When used server-side, the SDK key only ever needs to leave the server to hit the datafile CDN; it should never end up in client-rendered HTML, browser bundles, or browser-accessible config. Store it in environment variables only.
 
 Server SDK keys cannot be rotated without a process restart; the new key must be set in the environment before the server boots (or trigger a rolling restart in your orchestrator).
 
@@ -63,7 +63,7 @@ Server SDK keys cannot be rotated without a process restart; the new key must be
 
 ## 4. Identity
 
-The server SDK is stateless per request — it does not hold a persistent context. Pass the user context on each call using `forUser()` or as a `context` option on individual calls.
+The server SDK is stateless per request; it does not hold a persistent context. Pass the user context on each call using `forUser()` or as a `context` option on individual calls.
 
 ### `forUser(context)` / `createUserContext(context)`
 
@@ -106,7 +106,7 @@ const flag = server.getBoolFlag('big-cart-banner', false, {
     viewedSkus: ['SKU-1', 'SKU-2'], // for "products viewed" matching on SKU
     viewedCategories: ['trainers'], // for "products viewed" matching on category
     purchaseHistory: {
-      // PurchaseHistoryAttribute — exported for your own declarations
+      // PurchaseHistoryAttribute, exported for your own declarations
       hasPurchased: true,
       lastPurchaseAt: 1765500000000, // epoch milliseconds (optional)
       lifetimeSpend: 540.0, // decimal MAJOR units (optional)
@@ -118,9 +118,9 @@ const flag = server.getBoolFlag('big-cart-banner', false, {
 
 Server-side semantics to be aware of:
 
-- **All money is decimal major units.** Condition values are stored in minor units and converted using the project currency exponent from the datafile (default 2) — you never pass minor units.
-- **Missing or mistyped attributes evaluate the condition to `false`.** A completely absent `purchaseHistory` makes ALL purchase-history operators false — including `has_not_purchased`. On the server, absence means "not provided", not "never purchased" (this deliberately diverges from the browser snippet, where a profile miss is authoritative).
-- **Dataset-backed "products viewed" conditions evaluate `false` on the server.** Dataset view windows live in the browser; server callers use literal SKU/category lists. The session/30-day window distinction is also browser-only — supply whatever view list you consider current.
+- **All money is decimal major units.** Condition values are stored in minor units and converted using the project currency exponent from the datafile (default 2); you never pass minor units.
+- **Missing or mistyped attributes evaluate the condition to `false`.** A completely absent `purchaseHistory` makes ALL purchase-history operators false, including `has_not_purchased`. On the server, absence means "not provided", not "never purchased" (this deliberately diverges from the browser snippet, where a profile miss is authoritative).
+- **Dataset-backed "products viewed" conditions evaluate `false` on the server.** Dataset view windows live in the browser; server callers use literal SKU/category lists. The session/30-day window distinction is also browser-only; supply whatever view list you consider current.
 
 ### `alias(previousContext, newContext)`
 
@@ -135,7 +135,7 @@ await server.alias(
 
 ### Sharing identity with the web snippet
 
-To measure one metric across both the A vs B web snippet and this SDK (the setup behind cross-project metrics), the context `key` must equal the browser snippet's visitor id — the `_avsb_visitor` cookie UUID returned by `avsb.getVisitorId()`. Results join on raw id equality, so a different key means the two surfaces never line up. Forward the snippet id from the browser and use it as the key here, or link an internal account id to it with `alias()`. Full guide: [Shared Visitor Identity](https://avsb.cloud/docs/developer-reference/shared-visitor-identity).
+To measure one metric across both the A vs B web snippet and this SDK (the setup behind cross-project metrics), the context `key` must equal the browser snippet's visitor id: the `_avsb_visitor` cookie UUID returned by `avsb.getVisitorId()`. Results join on raw id equality, so a different key means the two surfaces never line up. Forward the snippet id from the browser and use it as the key here, or link an internal account id to it with `alias()`. Full guide: [Shared Visitor Identity](https://avsb.cloud/docs/developer-reference/shared-visitor-identity).
 
 ---
 
@@ -180,13 +180,13 @@ const flag = server.getFlag<boolean>('checkout-v2', false, {
 ### The `Flag<T>` object
 
 ```ts
-flag.value          // T — the variation value
+flag.value          // T, the variation value
 flag.isEnabled()    // true if source === 'rule' && value is truthy
 flag.variationKey   // 'on' | 'off' | 'control' | null (null = default served)
 flag.exists()       // false when source === 'not_found'
 flag.source         // 'rule' | 'sticky' | 'holdout' | 'datafileOverride' | 'default' | ...
 flag.ruleId         // which rule matched
-flag.reasons        // string[] — evaluation path
+flag.reasons        // string[], evaluation path
 ```
 
 ### `getAllFlags(context, options?)`
@@ -275,7 +275,7 @@ if (!result.success && !result.degraded) {
 }
 ```
 
-`onReady()` never rejects — it always resolves. Check `result.success` to decide whether to proceed.
+`onReady()` never rejects; it always resolves. Check `result.success` to decide whether to proceed.
 
 ### Event bus
 
@@ -382,7 +382,7 @@ app.get('/checkout', (req, res) => {
 })
 ```
 
-`expressMiddleware` decorates each request with `req.avsb` — a `UserBoundClient` scoped to the context returned by `contextFrom`. It also opens an `AsyncLocalStorage` scope so `getRequestClient()` from `@avsbhq/utils` works anywhere in the call chain.
+`expressMiddleware` decorates each request with `req.avsb`: a `UserBoundClient` scoped to the context returned by `contextFrom`. It also opens an `AsyncLocalStorage` scope so `getRequestClient()` from `@avsbhq/utils` works anywhere in the call chain.
 
 ### Fastify
 
@@ -443,7 +443,7 @@ DynamoDB and PostgreSQL adapters are available in `@avsbhq/utils`.
 
 ### Real-time streaming
 
-Enable SSE streaming to receive datafile updates the instant a flag changes — no polling delay:
+Enable SSE streaming to receive datafile updates the instant a flag changes, with no polling delay:
 
 ```ts
 const server = new AvsbServer({
@@ -480,7 +480,7 @@ const entries = user.getDecisionLog().entries
 | `client.variation('key', context, default)` | `server.forUser(ctx).getBoolFlag('key', default).value` |
 | `client.variationDetail('key', context, default)` | `server.forUser(ctx).getFlag('key', default)` |
 | `client.track('event', context, { metricValue })` | `server.forUser(ctx).track('event', { value })` |
-| `client.identify(context)` | not applicable — server is stateless; use `forUser(ctx)` |
+| `client.identify(context)` | not applicable (server is stateless); use `forUser(ctx)` |
 | `client.allFlagsState(context)` | `server.getAllFlags(ctx)` |
 | `client.close()` | `await server.close()` |
 
@@ -488,7 +488,7 @@ Key differences:
 - `getFlag` returns `Flag<T>` not a raw value. Access `.value` for the primitive.
 - `track` uses `value` (not `metricValue`) for the numeric metric.
 - The server is context-free at construction; all evaluation is per-request via `forUser()`.
-- Multi-context is native — no `ldUser` adapter needed.
+- Multi-context is native, with no `ldUser` adapter needed.
 
 ### From Statsig Node
 

package/dist/index.cjs

@@ -50,7 +50,7 @@ function createDatasetsClient(options) {
   const requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
   async function get(slug, key) {
     if (!slug || !key) {
-      logger.warn("datasets.get called with an empty slug or key \u2014 returning not found");
+      logger.warn("datasets.get called with an empty slug or key; returning not found");
       return miss(slug, null);
     }
     const datafile = getDatafile();
@@ -60,11 +60,11 @@ function createDatasetsClient(options) {
     }
     const dataset = datafile.datasets?.find((d) => d.slug === slug);
     if (!dataset) {
-      logger.debug(`Dataset "${slug}" not present in datafile \u2014 returning not found`);
+      logger.debug(`Dataset "${slug}" not present in datafile; returning not found`);
       return miss(slug, null);
     }
     if (!dataset.liveVersion) {
-      logger.debug(`Dataset "${slug}" has no live version \u2014 returning not found`);
+      logger.debug(`Dataset "${slug}" has no live version; returning not found`);
       return miss(slug, null);
     }
     const base = datafile.collectEndpoint.replace(/\/+$/, "");
@@ -92,6 +92,205 @@ function createDatasetsClient(options) {
   return { get };
 }
 
+// src/recs.ts
+var DEFAULT_REQUEST_TIMEOUT2 = 1e4;
+var MAX_SEED_CHARS = 256;
+var MAX_SEEDS = 3;
+var MAX_ITEMS_CAP = 24;
+var DEFAULT_MAX_ITEMS = 8;
+var MAX_ID_CHARS = 64;
+var MAX_ATTR_VALUE_CHARS = 512;
+var GLOBAL_SEED = "_global";
+function clampMaxItems(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 1) return DEFAULT_MAX_ITEMS;
+  return Math.min(Math.floor(value), MAX_ITEMS_CAP);
+}
+function asText(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return "";
+}
+function joinIds(ids) {
+  let out = "";
+  for (const id of ids) {
+    const next = out === "" ? id : `${out},${id}`;
+    if (next.length > MAX_ATTR_VALUE_CHARS) break;
+    out = next;
+  }
+  return out;
+}
+function toRecProducts(items, cap) {
+  const out = [];
+  for (const item of items) {
+    if (out.length >= cap) break;
+    if (item === null || typeof item !== "object") continue;
+    const fields = item;
+    const id = (asText(fields.id) || asText(fields.sku)).slice(0, MAX_ID_CHARS);
+    if (id === "") continue;
+    const product = { id };
+    const title = asText(fields.title);
+    if (title) product.title = title;
+    const image = asText(fields.image);
+    if (image) product.image = image;
+    const href = asText(fields.href) || asText(fields.url);
+    if (href && !/^\s*javascript:/i.test(href)) product.href = href;
+    const category = asText(fields.category);
+    if (category) product.category = category;
+    if (typeof fields.price === "number" && Number.isFinite(fields.price)) {
+      product.price = Math.round(fields.price);
+    }
+    if (typeof fields.compareAtPrice === "number" && Number.isFinite(fields.compareAtPrice)) {
+      product.compareAtPrice = Math.round(fields.compareAtPrice);
+    }
+    if (typeof fields.currency === "string" && fields.currency !== "") {
+      product.currency = fields.currency;
+    }
+    const availability = fields.availability;
+    if (availability === "in_stock" || availability === "out_of_stock" || availability === "removed") {
+      product.availability = availability;
+    }
+    out.push(product);
+  }
+  return out;
+}
+function miss2(recipe, degraded) {
+  return { items: [], served: false, recipe, source: null, fallbackStep: null, degraded };
+}
+function createRecsClient(options) {
+  const { sdkKey, getDatafile, getTracker, logger } = options;
+  const requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT2;
+  function resolveSeeds(context) {
+    const clip = (s) => s.slice(0, MAX_SEED_CHARS);
+    if (Array.isArray(context?.seeds)) {
+      const seeds = context.seeds.filter((s) => typeof s === "string" && s !== "").slice(0, MAX_SEEDS).map(clip);
+      if (seeds.length > 0) return seeds;
+    }
+    if (typeof context?.seed === "string" && context.seed !== "") return [clip(context.seed)];
+    return [GLOBAL_SEED];
+  }
+  async function get(req) {
+    try {
+      const recipeHandle = typeof req?.recipe === "string" ? req.recipe : "";
+      if (recipeHandle === "") {
+        logger.warn("recs.get called with an empty recipe; returning served:false");
+        return miss2("", false);
+      }
+      const datafile = getDatafile();
+      if (!datafile) {
+        logger.debug(`SDK not ready, returning served:false for recipe "${recipeHandle}"`);
+        return miss2(recipeHandle, false);
+      }
+      const recipes = datafile.recipes;
+      const entry = recipes?.find((r) => r.recipe === recipeHandle) ?? null;
+      if (!entry) {
+        logger.debug(`Recipe "${recipeHandle}" not present in datafile; returning served:false`);
+        return miss2(recipeHandle, false);
+      }
+      const seeds = resolveSeeds(req.context);
+      const maxItems = clampMaxItems(req.maxItems);
+      const excludeOutOfStock = typeof req.excludeOutOfStock === "boolean" ? req.excludeOutOfStock : entry.excludeOutOfStock;
+      const body = {
+        snippetKey: sdkKey,
+        assigned: 0,
+        sources: [{ chain: entry.chain }],
+        maxItems,
+        excludeOutOfStock,
+        merch: entry.merch ?? [],
+        sessionAffinity: entry.sessionAffinity
+      };
+      if (seeds.length === 1) body.seedKey = seeds[0];
+      else body.seedKeys = seeds;
+      const base = datafile.collectEndpoint.replace(/\/+$/, "").replace("/v1/collect/batch", "");
+      const res = await fetch(`${base}/v1/recs/resolve`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(requestTimeout)
+      });
+      if (!res.ok) {
+        logger.warn("Recs resolve failed", { recipe: recipeHandle, status: res.status });
+        return miss2(recipeHandle, true);
+      }
+      const parsed = await res.json();
+      const data = parsed?.data;
+      if (!data || typeof data !== "object") return miss2(recipeHandle, true);
+      const items = toRecProducts(Array.isArray(data.items) ? data.items : [], maxItems);
+      const servedStep = data.served ?? null;
+      const served = servedStep !== null && items.length > 0;
+      if (req.attribution) {
+        const tracker = getTracker();
+        if (tracker) {
+          tracker.queue({
+            visitorId: req.attribution.visitorId,
+            experimentId: req.attribution.experimentId,
+            variationId: req.attribution.variationId,
+            eventName: "rec:impression",
+            revenue: null,
+            timestamp: Date.now(),
+            pageUrl: "",
+            attributes: {
+              recipe: entry.recipe,
+              seed: joinIds(seeds),
+              slug: servedStep?.slug ?? "",
+              version: servedStep ? String(servedStep.version) : "",
+              step: servedStep ? String(servedStep.step) : "",
+              served: served ? "true" : "false",
+              items: joinIds(items.map((i) => i.id))
+            }
+          });
+        } else {
+          logger.warn("recs.get attribution supplied before tracker is ready; impression dropped");
+        }
+      }
+      return {
+        items,
+        served,
+        recipe: entry.recipe,
+        source: servedStep?.slug ?? null,
+        fallbackStep: servedStep?.step ?? null,
+        degraded: false
+      };
+    } catch (e) {
+      logger.warn("Recs resolve error", {
+        recipe: typeof req?.recipe === "string" ? req.recipe : "",
+        error: String(e)
+      });
+      return miss2(typeof req?.recipe === "string" ? req.recipe : "", true);
+    }
+  }
+  function trackClick(productId, opts) {
+    if (typeof productId !== "string" || productId === "") {
+      logger.warn("recs.trackClick called with an empty productId; dropped");
+      return;
+    }
+    if (!opts || !opts.visitorId || !opts.experimentId || !opts.variationId) {
+      logger.warn("recs.trackClick requires visitorId/experimentId/variationId; dropped");
+      return;
+    }
+    const tracker = getTracker();
+    if (!tracker) {
+      logger.warn("recs.trackClick called before tracker is ready; click dropped");
+      return;
+    }
+    const position = typeof opts.position === "number" && Number.isInteger(opts.position) && opts.position >= 1 ? String(opts.position) : "";
+    tracker.queue({
+      visitorId: opts.visitorId,
+      experimentId: opts.experimentId,
+      variationId: opts.variationId,
+      eventName: "rec:click",
+      revenue: null,
+      timestamp: Date.now(),
+      pageUrl: "",
+      attributes: {
+        recipe: typeof opts.recipe === "string" ? opts.recipe : "",
+        item: productId.slice(0, MAX_ID_CHARS),
+        position
+      }
+    });
+  }
+  return { get, trackClick };
+}
+
 // src/decisionLog.ts
 function createDecisionLog() {
   const entries = [];
@@ -291,7 +490,7 @@ function createServerTracker(options) {
 var import_streaming = require("@avsbhq/utils/streaming");
 
 // src/version.ts
-var SDK_VERSION = "0.3.0";
+var SDK_VERSION = "1.6.2";
 
 // src/UserBoundClient.ts
 function createUserBoundClient(server, context) {
@@ -438,7 +637,7 @@ var AvsbServer = class {
   readyPromise = null;
   pendingEvents = [];
   /**
-   * §6 — `client.utils.*` surface. Constructed lazily on first access so
+   * §6: `client.utils.*` surface. Constructed lazily on first access so
    * the utils package is only imported when actually consumed.
    *
    * The server's event surface (`ServerEventMap`) is a subset of the
@@ -471,7 +670,7 @@ var AvsbServer = class {
    * Server-side datasets read surface (e-commerce suite Phase 2).
    * Constructed lazily on first access, mirroring the `utils` getter.
    * `client.datasets.get(slug, key)` resolves the live version from the
-   * current datafile and never throws — see ./datasets.ts.
+   * current datafile and never throws; see ./datasets.ts.
    */
   _datasets = null;
   get datasets() {
@@ -484,6 +683,25 @@ var AvsbServer = class {
     }
     return this._datasets;
   }
+  /**
+   * Server-side recommendations surface (e-commerce suite overhaul, C3).
+   * Constructed lazily on first access, mirroring the `datasets` getter.
+   * `client.recs.get({ recipe, … })` resolves the recipe registry from the
+   * current datafile and never throws; impressions/clicks ride the server
+   * tracker's queue and revenue attaches via the existing `trackPurchase`.
+   */
+  _recs = null;
+  get recs() {
+    if (!this._recs) {
+      this._recs = createRecsClient({
+        sdkKey: this.sdkKey,
+        getDatafile: () => this.datafile,
+        getTracker: () => this.tracker,
+        logger: this.logger
+      });
+    }
+    return this._recs;
+  }
   constructor(options) {
     this.sdkKey = options.sdkKey;
     this.pollingInterval = Math.max(options.pollingInterval ?? 6e4, 5e3);
@@ -606,7 +824,7 @@ var AvsbServer = class {
     const decisionLog = options?.decisionLog;
     if (!context) {
       this.logger.warn(
-        `getFlag called without context for flagKey="${flagKey}" \u2014 returning default`
+        `getFlag called without context for flagKey="${flagKey}"; returning default`
       );
       return (0, import_core2.notFoundFlag)(defaultValue, "no context provided");
     }
@@ -868,7 +1086,7 @@ var AvsbServer = class {
     const mismatch = (0, import_core2.checkExpectedType)(datafileFlag, expectedType, flag.value);
     if (mismatch) {
       this.logger.warn(
-        `Type mismatch on flag "${flagKey}": ${mismatch} \u2014 returning default`
+        `Type mismatch on flag "${flagKey}": ${mismatch}; returning default`
       );
       return (0, import_core2.notFoundFlag)(defaultValue, mismatch);
     }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { FlagDatafile, StickyBucketService, Logger, EvaluationSource, StickyAssignment, DecideOption, Flag, TrackPayload, DecisionLog, InitResult, EvalContext } from '@avsbhq/core';
-export { DatafileDataset, DatafileDatasetType, DecideOption, DecisionLog, DecisionLogEntry, EvalContext, EvaluationSource, ExposureEvent, Flag, FlagDatafile, FlagEvaluationDetails, InitResult, Logger, MetricEvent, MultiContext, RuleType, SingleContext, StickyAssignment, StickyBucketService, TrackPayload, consoleLogger, consoleTransport, createLogger, noopLogger } from '@avsbhq/core';
+export { DatafileDataset, DatafileDatasetType, DecideOption, DecisionLog, DecisionLogEntry, EvalContext, EvaluationSource, ExposureEvent, Flag, FlagDatafile, FlagEvaluationDetails, InitResult, Logger, MetricEvent, MultiContext, PurchaseHistoryAttribute, RuleType, SingleContext, StickyAssignment, StickyBucketService, TrackPayload, consoleLogger, consoleTransport, createLogger, noopLogger } from '@avsbhq/core';
 import { AvsbUtils } from '@avsbhq/utils';
 export { AvsbUtils } from '@avsbhq/utils';
 export { StreamingClient, StreamingOptions, createStreamingClient } from '@avsbhq/utils/streaming';
@@ -66,7 +66,7 @@ interface MiddlewareConfig {
 /**
  * Purchase order shape for server-side purchase tracking.
  * Mirrors the client-side snippet PurchaseOrder interface.
- * Decimal values are forwarded as-is — no server-side currency conversion.
+ * Decimal values are forwarded as-is; no server-side currency conversion.
  */
 interface PurchaseOrder {
     /** Required. Unique order/transaction identifier. */
@@ -80,8 +80,19 @@ interface PurchaseOrder {
     tax?: number;
     discount?: number;
     coupon?: string;
+    /** Mark this as a test purchase. Test orders are stored but excluded from all
+     *  revenue, profit, recommendation, and audience calculations. Only send when
+     *  intentionally testing your integration. */
+    test?: boolean;
     items?: Array<{
         sku: string;
+        /**
+         * Canonical product-grain key (e-commerce suite overhaul, contract C1).
+         * Pass when known so order items join catalog/recommendation analytics
+         * without alias resolution; the ingestion worker derives it from `sku`
+         * otherwise.
+         */
+        productKey?: string;
         name?: string;
         price?: number;
         quantity?: number;
@@ -124,6 +135,95 @@ interface DatasetsClient {
     get(slug: string, key: string): Promise<DatasetGetResult>;
 }
 
+/**
+ * Server-side recommendations client (e-commerce suite overhaul, contract C3).
+ *
+ * Mirrors ./datasets.ts: resolves a recipe handle against the datafile's
+ * recipe registry (`datafile.recipes`, additive) and POSTs the standard
+ * resolve body to the edge worker:
+ *
+ *   POST {ingestionHost}/v1/recs/resolve
+ *
+ * The ingestion host is derived from the datafile's `collectEndpoint`. The
+ * worker's key cache resolves SDK keys as well as snippet keys, so the body's
+ * key field simply carries the SDK key.
+ *
+ * Attribution is OPT-IN server-side: `get()` fires a `rec:impression` (via
+ * the server tracker) only when the caller passes `attribution`; a server
+ * has no ambient variation context the way a browser harness does.
+ *
+ * Error posture matches datasets/flag evaluation: this client NEVER throws.
+ * Unknown recipe, SDK not ready, HTTP errors, timeouts and network failures
+ * all degrade to `{ items: [], served: false }`.
+ */
+interface RecProduct {
+    id: string;
+    title?: string;
+    image?: string;
+    href?: string;
+    category?: string;
+    /** MINOR units (ISO-4217). */
+    price?: number;
+    /** MINOR units. */
+    compareAtPrice?: number;
+    currency?: string;
+    availability?: 'in_stock' | 'out_of_stock' | 'removed';
+}
+interface RecsAttribution {
+    visitorId: string;
+    experimentId: string;
+    variationId: string;
+}
+interface RecsGetRequest {
+    recipe: string;
+    context?: {
+        /** Single seed product key (product page). */
+        seed?: string;
+        /** Up to 3 seed product keys (cart page). */
+        seeds?: string[];
+    };
+    maxItems?: number;
+    excludeOutOfStock?: boolean;
+    /** When present, a rec:impression is queued with these ids on success. */
+    attribution?: RecsAttribution;
+}
+interface RecsResult {
+    items: RecProduct[];
+    served: boolean;
+    recipe: string;
+    /** Slug of the chain step that served, null on a miss. */
+    source: string | null;
+    fallbackStep: number | null;
+    /** True when the resolve failed (timeout / network / HTTP / parse). */
+    degraded: boolean;
+}
+interface RecsClient {
+    /** Resolve items for a recipe. Never throws. */
+    get(req: RecsGetRequest): Promise<RecsResult>;
+    /**
+     * Queue a rec:click for a product the shopper clicked. Pass `recipe` when
+     * known: results group click-through by (variation, recipe).
+     */
+    trackClick(productId: string, opts: RecsAttribution & {
+        position?: number;
+        recipe?: string;
+    }): void;
+}
+/**
+ * One entry of the datafile recipe registry (contract C3). Additive on
+ * FlagDatafile; SDKs on older datafiles see it absent.
+ */
+interface DatafileRecipe {
+    recipe: string;
+    chain: Array<{
+        slug: string;
+        version: number;
+    }>;
+    excludeOutOfStock: boolean;
+    sessionAffinity: boolean;
+    merch?: unknown[];
+}
+
 /**
  * A per-request scoped client with a bound EvalContext.
  *
@@ -131,7 +231,7 @@ interface DatasetsClient {
  * alias. All flag evaluations and track calls use the bound context.
  *
  * Forced decisions set on a UserBoundClient survive only for the lifetime
- * of the instance — they do not affect the shared AvsbServer override state.
+ * of the instance; they do not affect the shared AvsbServer override state.
  * This makes them safe for test middleware and per-request debugging.
  *
  * Spec §5.8.
@@ -195,7 +295,7 @@ declare class AvsbServer {
     private readyPromise;
     private pendingEvents;
     /**
-     * §6 — `client.utils.*` surface. Constructed lazily on first access so
+     * §6: `client.utils.*` surface. Constructed lazily on first access so
      * the utils package is only imported when actually consumed.
      *
      * The server's event surface (`ServerEventMap`) is a subset of the
@@ -209,10 +309,19 @@ declare class AvsbServer {
      * Server-side datasets read surface (e-commerce suite Phase 2).
      * Constructed lazily on first access, mirroring the `utils` getter.
      * `client.datasets.get(slug, key)` resolves the live version from the
-     * current datafile and never throws — see ./datasets.ts.
+     * current datafile and never throws; see ./datasets.ts.
      */
     private _datasets;
     get datasets(): DatasetsClient;
+    /**
+     * Server-side recommendations surface (e-commerce suite overhaul, C3).
+     * Constructed lazily on first access, mirroring the `datasets` getter.
+     * `client.recs.get({ recipe, … })` resolves the recipe registry from the
+     * current datafile and never throws; impressions/clicks ride the server
+     * tracker's queue and revenue attaches via the existing `trackPurchase`.
+     */
+    private _recs;
+    get recs(): RecsClient;
     constructor(options: AvsbServerOptions);
     onReady(): Promise<InitResult>;
     private initializeAndReady;
@@ -303,6 +412,6 @@ declare class RedisStickyBucketService implements StickyBucketService {
 
 declare function createDecisionLog(): DecisionLog;
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "1.6.2";
 
-export { AvsbServer, type AvsbServerOptions, type DatasetGetResult, type DatasetsClient, type EventOptions, type GetAllFlagsOptions, type GetFlagOptions, InMemoryStickyBucketService, type MiddlewareConfig, type PurchaseOrder, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type UserBoundClient, createDecisionLog, expressMiddleware, fastifyPlugin };
+export { AvsbServer, type AvsbServerOptions, type DatafileRecipe, type DatasetGetResult, type DatasetsClient, type EventOptions, type GetAllFlagsOptions, type GetFlagOptions, InMemoryStickyBucketService, type MiddlewareConfig, type PurchaseOrder, type RecProduct, type RecsAttribution, type RecsClient, type RecsGetRequest, type RecsResult, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type UserBoundClient, createDecisionLog, expressMiddleware, fastifyPlugin };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { FlagDatafile, StickyBucketService, Logger, EvaluationSource, StickyAssignment, DecideOption, Flag, TrackPayload, DecisionLog, InitResult, EvalContext } from '@avsbhq/core';
-export { DatafileDataset, DatafileDatasetType, DecideOption, DecisionLog, DecisionLogEntry, EvalContext, EvaluationSource, ExposureEvent, Flag, FlagDatafile, FlagEvaluationDetails, InitResult, Logger, MetricEvent, MultiContext, RuleType, SingleContext, StickyAssignment, StickyBucketService, TrackPayload, consoleLogger, consoleTransport, createLogger, noopLogger } from '@avsbhq/core';
+export { DatafileDataset, DatafileDatasetType, DecideOption, DecisionLog, DecisionLogEntry, EvalContext, EvaluationSource, ExposureEvent, Flag, FlagDatafile, FlagEvaluationDetails, InitResult, Logger, MetricEvent, MultiContext, PurchaseHistoryAttribute, RuleType, SingleContext, StickyAssignment, StickyBucketService, TrackPayload, consoleLogger, consoleTransport, createLogger, noopLogger } from '@avsbhq/core';
 import { AvsbUtils } from '@avsbhq/utils';
 export { AvsbUtils } from '@avsbhq/utils';
 export { StreamingClient, StreamingOptions, createStreamingClient } from '@avsbhq/utils/streaming';
@@ -66,7 +66,7 @@ interface MiddlewareConfig {
 /**
  * Purchase order shape for server-side purchase tracking.
  * Mirrors the client-side snippet PurchaseOrder interface.
- * Decimal values are forwarded as-is — no server-side currency conversion.
+ * Decimal values are forwarded as-is; no server-side currency conversion.
  */
 interface PurchaseOrder {
     /** Required. Unique order/transaction identifier. */
@@ -80,8 +80,19 @@ interface PurchaseOrder {
     tax?: number;
     discount?: number;
     coupon?: string;
+    /** Mark this as a test purchase. Test orders are stored but excluded from all
+     *  revenue, profit, recommendation, and audience calculations. Only send when
+     *  intentionally testing your integration. */
+    test?: boolean;
     items?: Array<{
         sku: string;
+        /**
+         * Canonical product-grain key (e-commerce suite overhaul, contract C1).
+         * Pass when known so order items join catalog/recommendation analytics
+         * without alias resolution; the ingestion worker derives it from `sku`
+         * otherwise.
+         */
+        productKey?: string;
         name?: string;
         price?: number;
         quantity?: number;
@@ -124,6 +135,95 @@ interface DatasetsClient {
     get(slug: string, key: string): Promise<DatasetGetResult>;
 }
 
+/**
+ * Server-side recommendations client (e-commerce suite overhaul, contract C3).
+ *
+ * Mirrors ./datasets.ts: resolves a recipe handle against the datafile's
+ * recipe registry (`datafile.recipes`, additive) and POSTs the standard
+ * resolve body to the edge worker:
+ *
+ *   POST {ingestionHost}/v1/recs/resolve
+ *
+ * The ingestion host is derived from the datafile's `collectEndpoint`. The
+ * worker's key cache resolves SDK keys as well as snippet keys, so the body's
+ * key field simply carries the SDK key.
+ *
+ * Attribution is OPT-IN server-side: `get()` fires a `rec:impression` (via
+ * the server tracker) only when the caller passes `attribution`; a server
+ * has no ambient variation context the way a browser harness does.
+ *
+ * Error posture matches datasets/flag evaluation: this client NEVER throws.
+ * Unknown recipe, SDK not ready, HTTP errors, timeouts and network failures
+ * all degrade to `{ items: [], served: false }`.
+ */
+interface RecProduct {
+    id: string;
+    title?: string;
+    image?: string;
+    href?: string;
+    category?: string;
+    /** MINOR units (ISO-4217). */
+    price?: number;
+    /** MINOR units. */
+    compareAtPrice?: number;
+    currency?: string;
+    availability?: 'in_stock' | 'out_of_stock' | 'removed';
+}
+interface RecsAttribution {
+    visitorId: string;
+    experimentId: string;
+    variationId: string;
+}
+interface RecsGetRequest {
+    recipe: string;
+    context?: {
+        /** Single seed product key (product page). */
+        seed?: string;
+        /** Up to 3 seed product keys (cart page). */
+        seeds?: string[];
+    };
+    maxItems?: number;
+    excludeOutOfStock?: boolean;
+    /** When present, a rec:impression is queued with these ids on success. */
+    attribution?: RecsAttribution;
+}
+interface RecsResult {
+    items: RecProduct[];
+    served: boolean;
+    recipe: string;
+    /** Slug of the chain step that served, null on a miss. */
+    source: string | null;
+    fallbackStep: number | null;
+    /** True when the resolve failed (timeout / network / HTTP / parse). */
+    degraded: boolean;
+}
+interface RecsClient {
+    /** Resolve items for a recipe. Never throws. */
+    get(req: RecsGetRequest): Promise<RecsResult>;
+    /**
+     * Queue a rec:click for a product the shopper clicked. Pass `recipe` when
+     * known: results group click-through by (variation, recipe).
+     */
+    trackClick(productId: string, opts: RecsAttribution & {
+        position?: number;
+        recipe?: string;
+    }): void;
+}
+/**
+ * One entry of the datafile recipe registry (contract C3). Additive on
+ * FlagDatafile; SDKs on older datafiles see it absent.
+ */
+interface DatafileRecipe {
+    recipe: string;
+    chain: Array<{
+        slug: string;
+        version: number;
+    }>;
+    excludeOutOfStock: boolean;
+    sessionAffinity: boolean;
+    merch?: unknown[];
+}
+
 /**
  * A per-request scoped client with a bound EvalContext.
  *
@@ -131,7 +231,7 @@ interface DatasetsClient {
  * alias. All flag evaluations and track calls use the bound context.
  *
  * Forced decisions set on a UserBoundClient survive only for the lifetime
- * of the instance — they do not affect the shared AvsbServer override state.
+ * of the instance; they do not affect the shared AvsbServer override state.
  * This makes them safe for test middleware and per-request debugging.
  *
  * Spec §5.8.
@@ -195,7 +295,7 @@ declare class AvsbServer {
     private readyPromise;
     private pendingEvents;
     /**
-     * §6 — `client.utils.*` surface. Constructed lazily on first access so
+     * §6: `client.utils.*` surface. Constructed lazily on first access so
      * the utils package is only imported when actually consumed.
      *
      * The server's event surface (`ServerEventMap`) is a subset of the
@@ -209,10 +309,19 @@ declare class AvsbServer {
      * Server-side datasets read surface (e-commerce suite Phase 2).
      * Constructed lazily on first access, mirroring the `utils` getter.
      * `client.datasets.get(slug, key)` resolves the live version from the
-     * current datafile and never throws — see ./datasets.ts.
+     * current datafile and never throws; see ./datasets.ts.
      */
     private _datasets;
     get datasets(): DatasetsClient;
+    /**
+     * Server-side recommendations surface (e-commerce suite overhaul, C3).
+     * Constructed lazily on first access, mirroring the `datasets` getter.
+     * `client.recs.get({ recipe, … })` resolves the recipe registry from the
+     * current datafile and never throws; impressions/clicks ride the server
+     * tracker's queue and revenue attaches via the existing `trackPurchase`.
+     */
+    private _recs;
+    get recs(): RecsClient;
     constructor(options: AvsbServerOptions);
     onReady(): Promise<InitResult>;
     private initializeAndReady;
@@ -303,6 +412,6 @@ declare class RedisStickyBucketService implements StickyBucketService {
 
 declare function createDecisionLog(): DecisionLog;
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "1.6.2";
 
-export { AvsbServer, type AvsbServerOptions, type DatasetGetResult, type DatasetsClient, type EventOptions, type GetAllFlagsOptions, type GetFlagOptions, InMemoryStickyBucketService, type MiddlewareConfig, type PurchaseOrder, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type UserBoundClient, createDecisionLog, expressMiddleware, fastifyPlugin };
+export { AvsbServer, type AvsbServerOptions, type DatafileRecipe, type DatasetGetResult, type DatasetsClient, type EventOptions, type GetAllFlagsOptions, type GetFlagOptions, InMemoryStickyBucketService, type MiddlewareConfig, type PurchaseOrder, type RecProduct, type RecsAttribution, type RecsClient, type RecsGetRequest, type RecsResult, type RedisLike, type RedisStickyBucketOptions, RedisStickyBucketService, SDK_VERSION, type UserBoundClient, createDecisionLog, expressMiddleware, fastifyPlugin };

package/dist/index.js

@@ -23,7 +23,7 @@ function createDatasetsClient(options) {
   const requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
   async function get(slug, key) {
     if (!slug || !key) {
-      logger.warn("datasets.get called with an empty slug or key \u2014 returning not found");
+      logger.warn("datasets.get called with an empty slug or key; returning not found");
       return miss(slug, null);
     }
     const datafile = getDatafile();
@@ -33,11 +33,11 @@ function createDatasetsClient(options) {
     }
     const dataset = datafile.datasets?.find((d) => d.slug === slug);
     if (!dataset) {
-      logger.debug(`Dataset "${slug}" not present in datafile \u2014 returning not found`);
+      logger.debug(`Dataset "${slug}" not present in datafile; returning not found`);
       return miss(slug, null);
     }
     if (!dataset.liveVersion) {
-      logger.debug(`Dataset "${slug}" has no live version \u2014 returning not found`);
+      logger.debug(`Dataset "${slug}" has no live version; returning not found`);
       return miss(slug, null);
     }
     const base = datafile.collectEndpoint.replace(/\/+$/, "");
@@ -65,6 +65,205 @@ function createDatasetsClient(options) {
   return { get };
 }
 
+// src/recs.ts
+var DEFAULT_REQUEST_TIMEOUT2 = 1e4;
+var MAX_SEED_CHARS = 256;
+var MAX_SEEDS = 3;
+var MAX_ITEMS_CAP = 24;
+var DEFAULT_MAX_ITEMS = 8;
+var MAX_ID_CHARS = 64;
+var MAX_ATTR_VALUE_CHARS = 512;
+var GLOBAL_SEED = "_global";
+function clampMaxItems(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 1) return DEFAULT_MAX_ITEMS;
+  return Math.min(Math.floor(value), MAX_ITEMS_CAP);
+}
+function asText(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return "";
+}
+function joinIds(ids) {
+  let out = "";
+  for (const id of ids) {
+    const next = out === "" ? id : `${out},${id}`;
+    if (next.length > MAX_ATTR_VALUE_CHARS) break;
+    out = next;
+  }
+  return out;
+}
+function toRecProducts(items, cap) {
+  const out = [];
+  for (const item of items) {
+    if (out.length >= cap) break;
+    if (item === null || typeof item !== "object") continue;
+    const fields = item;
+    const id = (asText(fields.id) || asText(fields.sku)).slice(0, MAX_ID_CHARS);
+    if (id === "") continue;
+    const product = { id };
+    const title = asText(fields.title);
+    if (title) product.title = title;
+    const image = asText(fields.image);
+    if (image) product.image = image;
+    const href = asText(fields.href) || asText(fields.url);
+    if (href && !/^\s*javascript:/i.test(href)) product.href = href;
+    const category = asText(fields.category);
+    if (category) product.category = category;
+    if (typeof fields.price === "number" && Number.isFinite(fields.price)) {
+      product.price = Math.round(fields.price);
+    }
+    if (typeof fields.compareAtPrice === "number" && Number.isFinite(fields.compareAtPrice)) {
+      product.compareAtPrice = Math.round(fields.compareAtPrice);
+    }
+    if (typeof fields.currency === "string" && fields.currency !== "") {
+      product.currency = fields.currency;
+    }
+    const availability = fields.availability;
+    if (availability === "in_stock" || availability === "out_of_stock" || availability === "removed") {
+      product.availability = availability;
+    }
+    out.push(product);
+  }
+  return out;
+}
+function miss2(recipe, degraded) {
+  return { items: [], served: false, recipe, source: null, fallbackStep: null, degraded };
+}
+function createRecsClient(options) {
+  const { sdkKey, getDatafile, getTracker, logger } = options;
+  const requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT2;
+  function resolveSeeds(context) {
+    const clip = (s) => s.slice(0, MAX_SEED_CHARS);
+    if (Array.isArray(context?.seeds)) {
+      const seeds = context.seeds.filter((s) => typeof s === "string" && s !== "").slice(0, MAX_SEEDS).map(clip);
+      if (seeds.length > 0) return seeds;
+    }
+    if (typeof context?.seed === "string" && context.seed !== "") return [clip(context.seed)];
+    return [GLOBAL_SEED];
+  }
+  async function get(req) {
+    try {
+      const recipeHandle = typeof req?.recipe === "string" ? req.recipe : "";
+      if (recipeHandle === "") {
+        logger.warn("recs.get called with an empty recipe; returning served:false");
+        return miss2("", false);
+      }
+      const datafile = getDatafile();
+      if (!datafile) {
+        logger.debug(`SDK not ready, returning served:false for recipe "${recipeHandle}"`);
+        return miss2(recipeHandle, false);
+      }
+      const recipes = datafile.recipes;
+      const entry = recipes?.find((r) => r.recipe === recipeHandle) ?? null;
+      if (!entry) {
+        logger.debug(`Recipe "${recipeHandle}" not present in datafile; returning served:false`);
+        return miss2(recipeHandle, false);
+      }
+      const seeds = resolveSeeds(req.context);
+      const maxItems = clampMaxItems(req.maxItems);
+      const excludeOutOfStock = typeof req.excludeOutOfStock === "boolean" ? req.excludeOutOfStock : entry.excludeOutOfStock;
+      const body = {
+        snippetKey: sdkKey,
+        assigned: 0,
+        sources: [{ chain: entry.chain }],
+        maxItems,
+        excludeOutOfStock,
+        merch: entry.merch ?? [],
+        sessionAffinity: entry.sessionAffinity
+      };
+      if (seeds.length === 1) body.seedKey = seeds[0];
+      else body.seedKeys = seeds;
+      const base = datafile.collectEndpoint.replace(/\/+$/, "").replace("/v1/collect/batch", "");
+      const res = await fetch(`${base}/v1/recs/resolve`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(requestTimeout)
+      });
+      if (!res.ok) {
+        logger.warn("Recs resolve failed", { recipe: recipeHandle, status: res.status });
+        return miss2(recipeHandle, true);
+      }
+      const parsed = await res.json();
+      const data = parsed?.data;
+      if (!data || typeof data !== "object") return miss2(recipeHandle, true);
+      const items = toRecProducts(Array.isArray(data.items) ? data.items : [], maxItems);
+      const servedStep = data.served ?? null;
+      const served = servedStep !== null && items.length > 0;
+      if (req.attribution) {
+        const tracker = getTracker();
+        if (tracker) {
+          tracker.queue({
+            visitorId: req.attribution.visitorId,
+            experimentId: req.attribution.experimentId,
+            variationId: req.attribution.variationId,
+            eventName: "rec:impression",
+            revenue: null,
+            timestamp: Date.now(),
+            pageUrl: "",
+            attributes: {
+              recipe: entry.recipe,
+              seed: joinIds(seeds),
+              slug: servedStep?.slug ?? "",
+              version: servedStep ? String(servedStep.version) : "",
+              step: servedStep ? String(servedStep.step) : "",
+              served: served ? "true" : "false",
+              items: joinIds(items.map((i) => i.id))
+            }
+          });
+        } else {
+          logger.warn("recs.get attribution supplied before tracker is ready; impression dropped");
+        }
+      }
+      return {
+        items,
+        served,
+        recipe: entry.recipe,
+        source: servedStep?.slug ?? null,
+        fallbackStep: servedStep?.step ?? null,
+        degraded: false
+      };
+    } catch (e) {
+      logger.warn("Recs resolve error", {
+        recipe: typeof req?.recipe === "string" ? req.recipe : "",
+        error: String(e)
+      });
+      return miss2(typeof req?.recipe === "string" ? req.recipe : "", true);
+    }
+  }
+  function trackClick(productId, opts) {
+    if (typeof productId !== "string" || productId === "") {
+      logger.warn("recs.trackClick called with an empty productId; dropped");
+      return;
+    }
+    if (!opts || !opts.visitorId || !opts.experimentId || !opts.variationId) {
+      logger.warn("recs.trackClick requires visitorId/experimentId/variationId; dropped");
+      return;
+    }
+    const tracker = getTracker();
+    if (!tracker) {
+      logger.warn("recs.trackClick called before tracker is ready; click dropped");
+      return;
+    }
+    const position = typeof opts.position === "number" && Number.isInteger(opts.position) && opts.position >= 1 ? String(opts.position) : "";
+    tracker.queue({
+      visitorId: opts.visitorId,
+      experimentId: opts.experimentId,
+      variationId: opts.variationId,
+      eventName: "rec:click",
+      revenue: null,
+      timestamp: Date.now(),
+      pageUrl: "",
+      attributes: {
+        recipe: typeof opts.recipe === "string" ? opts.recipe : "",
+        item: productId.slice(0, MAX_ID_CHARS),
+        position
+      }
+    });
+  }
+  return { get, trackClick };
+}
+
 // src/decisionLog.ts
 function createDecisionLog() {
   const entries = [];
@@ -267,7 +466,7 @@ import {
 } from "@avsbhq/utils/streaming";
 
 // src/version.ts
-var SDK_VERSION = "0.3.0";
+var SDK_VERSION = "1.6.2";
 
 // src/UserBoundClient.ts
 function createUserBoundClient(server, context) {
@@ -414,7 +613,7 @@ var AvsbServer = class {
   readyPromise = null;
   pendingEvents = [];
   /**
-   * §6 — `client.utils.*` surface. Constructed lazily on first access so
+   * §6: `client.utils.*` surface. Constructed lazily on first access so
    * the utils package is only imported when actually consumed.
    *
    * The server's event surface (`ServerEventMap`) is a subset of the
@@ -447,7 +646,7 @@ var AvsbServer = class {
    * Server-side datasets read surface (e-commerce suite Phase 2).
    * Constructed lazily on first access, mirroring the `utils` getter.
    * `client.datasets.get(slug, key)` resolves the live version from the
-   * current datafile and never throws — see ./datasets.ts.
+   * current datafile and never throws; see ./datasets.ts.
    */
   _datasets = null;
   get datasets() {
@@ -460,6 +659,25 @@ var AvsbServer = class {
     }
     return this._datasets;
   }
+  /**
+   * Server-side recommendations surface (e-commerce suite overhaul, C3).
+   * Constructed lazily on first access, mirroring the `datasets` getter.
+   * `client.recs.get({ recipe, … })` resolves the recipe registry from the
+   * current datafile and never throws; impressions/clicks ride the server
+   * tracker's queue and revenue attaches via the existing `trackPurchase`.
+   */
+  _recs = null;
+  get recs() {
+    if (!this._recs) {
+      this._recs = createRecsClient({
+        sdkKey: this.sdkKey,
+        getDatafile: () => this.datafile,
+        getTracker: () => this.tracker,
+        logger: this.logger
+      });
+    }
+    return this._recs;
+  }
   constructor(options) {
     this.sdkKey = options.sdkKey;
     this.pollingInterval = Math.max(options.pollingInterval ?? 6e4, 5e3);
@@ -582,7 +800,7 @@ var AvsbServer = class {
     const decisionLog = options?.decisionLog;
     if (!context) {
       this.logger.warn(
-        `getFlag called without context for flagKey="${flagKey}" \u2014 returning default`
+        `getFlag called without context for flagKey="${flagKey}"; returning default`
       );
       return notFoundFlag2(defaultValue, "no context provided");
     }
@@ -844,7 +1062,7 @@ var AvsbServer = class {
     const mismatch = checkExpectedType(datafileFlag, expectedType, flag.value);
     if (mismatch) {
       this.logger.warn(
-        `Type mismatch on flag "${flagKey}": ${mismatch} \u2014 returning default`
+        `Type mismatch on flag "${flagKey}": ${mismatch}; returning default`
       );
       return notFoundFlag2(defaultValue, mismatch);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avsbhq/node",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -33,8 +33,8 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@avsbhq/core": "1.3.0",
-    "@avsbhq/utils": "1.0.1"
+    "@avsbhq/core": "1.4.0",
+    "@avsbhq/utils": "1.0.2"
   },
   "devDependencies": {
     "tsup": "^8.0.0",