@cimplify/sdk 0.70.3 → 0.72.0

package/dist/server/tanstack.mjs

@@ -0,0 +1,279 @@
+import '../chunk-3G6RQLXK.mjs';
+
+// src/server/tanstack.ts
+var TANSTACK_R2_BUCKET_BINDING = "CIMPLIFY_CACHE_R2_BUCKET";
+var TANSTACK_R2_PREFIX_ENV = "CIMPLIFY_CACHE_R2_PREFIX";
+var TANSTACK_PATH_INDEX_BINDING = "CIMPLIFY_PATH_INDEX";
+var TANSTACK_CACHE_NAMESPACE = "nitro";
+var CIMPLIFY_TAG_PREFIX = "cimplify:";
+var CIMPLIFY_CACHE_META_FIELD = "__cimplifyCache";
+var EMPTY_STORAGE_KEY = "__cimplify_empty_key__";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function metadataFrom(value) {
+  if (!isRecord(value)) return void 0;
+  const metadata = value[CIMPLIFY_CACHE_META_FIELD];
+  return isRecord(metadata) ? metadata : void 0;
+}
+function cimplifyTagsFrom(candidates) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const candidate of candidates) {
+    for (const tag of candidate ?? []) {
+      if (!tag.startsWith(CIMPLIFY_TAG_PREFIX) || seen.has(tag)) continue;
+      seen.add(tag);
+    }
+  }
+  return [...seen];
+}
+function extractTags(key, value, options, driverOptions) {
+  const optionMeta = metadataFrom(options);
+  const valueMeta = metadataFrom(value);
+  const valueRecord = isRecord(value) ? value : void 0;
+  const nestedValue = isRecord(valueRecord?.value) ? valueRecord.value : void 0;
+  const configured = typeof driverOptions.tags === "function" ? driverOptions.tags(key, value, options) : driverOptions.tags;
+  return cimplifyTagsFrom([
+    configured,
+    optionMeta?.tags,
+    options?.tags,
+    options?.cimplifyTags,
+    options?.cacheTags,
+    valueMeta?.tags,
+    stringArray(valueRecord?.tags),
+    stringArray(valueRecord?.cimplifyTags),
+    stringArray(valueRecord?.cacheTags),
+    stringArray(nestedValue?.tags),
+    stringArray(nestedValue?.cimplifyTags),
+    stringArray(nestedValue?.cacheTags)
+  ]);
+}
+function extractCacheKey(key, value, options, driverOptions) {
+  const configured = typeof driverOptions.cacheKey === "function" ? driverOptions.cacheKey(key, value, options) : driverOptions.cacheKey;
+  if (configured) return configured;
+  const optionMeta = metadataFrom(options);
+  const valueMeta = metadataFrom(value);
+  if (optionMeta?.cacheKey) return optionMeta.cacheKey;
+  if (options?.cacheKey) return options.cacheKey;
+  if (options?.cimplifyCacheKey) return options.cimplifyCacheKey;
+  if (valueMeta?.cacheKey) return valueMeta.cacheKey;
+  return key;
+}
+function extractIsFetch(key, value, options, driverOptions) {
+  if (typeof driverOptions.isFetch === "function") {
+    return driverOptions.isFetch(key, value, options);
+  }
+  if (typeof driverOptions.isFetch === "boolean") return driverOptions.isFetch;
+  const optionMeta = metadataFrom(options);
+  const valueMeta = metadataFrom(value);
+  return Boolean(
+    optionMeta?.isFetch ?? options?.isFetch ?? options?.cimplifyIsFetch ?? valueMeta?.isFetch ?? false
+  );
+}
+function valueForStorage(value) {
+  if (!isRecord(value) || !(CIMPLIFY_CACHE_META_FIELD in value)) return value;
+  const { [CIMPLIFY_CACHE_META_FIELD]: _metadata, ...rest } = value;
+  return rest;
+}
+function joinR2Parts(...parts) {
+  return parts.map((part) => part.trim().replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
+}
+function encodeStorageKey(key) {
+  return key === "" ? EMPTY_STORAGE_KEY : encodeURIComponent(key);
+}
+function decodeStorageKey(key) {
+  if (key === EMPTY_STORAGE_KEY) return "";
+  try {
+    return decodeURIComponent(key);
+  } catch {
+    return key;
+  }
+}
+function cimplifyTanstackR2Key(prefix, key, namespace = TANSTACK_CACHE_NAMESPACE) {
+  return joinR2Parts(prefix, namespace, encodeStorageKey(key));
+}
+function cimplifyTanstackR2ListPrefix(prefix, base, namespace) {
+  if (!base) return `${joinR2Parts(prefix, namespace)}/`;
+  return cimplifyTanstackR2Key(prefix, base, namespace);
+}
+function storageKeyFromR2Key(prefix, namespace, key) {
+  const base = `${joinR2Parts(prefix, namespace)}/`;
+  const encoded = key.startsWith(base) ? key.slice(base.length) : key;
+  return decodeStorageKey(encoded);
+}
+function pathIndexFor(env) {
+  if (!env.pathIndex) return null;
+  return env.pathIndex.get(env.pathIndex.idFromName(env.prefix));
+}
+async function resolveRuntimeEnv(options) {
+  const env = await options.getEnv?.() ?? options.env;
+  const r2 = env?.[TANSTACK_R2_BUCKET_BINDING];
+  const prefix = options.prefix ?? env?.[TANSTACK_R2_PREFIX_ENV];
+  if (!r2 || !prefix) return null;
+  return {
+    r2,
+    prefix,
+    pathIndex: env?.[TANSTACK_PATH_INDEX_BINDING]
+  };
+}
+async function registerIndex(env, cacheKey, r2Key, tags, isFetch) {
+  if (tags.length === 0) return;
+  const index = pathIndexFor(env);
+  if (!index) return;
+  try {
+    await index.indexAdd(cacheKey, r2Key, tags, isFetch);
+  } catch {
+  }
+}
+async function listR2Keys(r2, prefix) {
+  const keys = [];
+  let cursor;
+  do {
+    const page = await r2.list({ prefix, cursor });
+    keys.push(...page.objects.map((object) => object.key));
+    cursor = page.truncated ? page.cursor : void 0;
+  } while (cursor);
+  return keys;
+}
+async function putAndIndex(runtimeEnv, driverOptions, key, storedValue, indexValue, options) {
+  const namespace = driverOptions.namespace ?? TANSTACK_CACHE_NAMESPACE;
+  const r2Key = cimplifyTanstackR2Key(runtimeEnv.prefix, key, namespace);
+  try {
+    await runtimeEnv.r2.put(r2Key, storedValue);
+  } catch {
+    return;
+  }
+  try {
+    const tags = extractTags(key, indexValue, options, driverOptions);
+    if (tags.length === 0) return;
+    await registerIndex(
+      runtimeEnv,
+      extractCacheKey(key, indexValue, options, driverOptions),
+      r2Key,
+      tags,
+      extractIsFetch(key, indexValue, options, driverOptions)
+    );
+  } catch {
+  }
+}
+async function getRawItem(driverOptions, key) {
+  const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+  if (!runtimeEnv) return null;
+  try {
+    const object = await runtimeEnv.r2.get(
+      cimplifyTanstackR2Key(
+        runtimeEnv.prefix,
+        key,
+        driverOptions.namespace ?? TANSTACK_CACHE_NAMESPACE
+      )
+    );
+    return object ? await object.text() : null;
+  } catch {
+    return null;
+  }
+}
+function cimplifyTanstackCacheOptions(metadata) {
+  return { [CIMPLIFY_CACHE_META_FIELD]: metadata };
+}
+function withCimplifyCacheMetadata(value, metadata) {
+  return { ...value, [CIMPLIFY_CACHE_META_FIELD]: metadata };
+}
+function createCimplifyTanstackCacheDriver(options = {}) {
+  const driverOptions = { ...options };
+  return {
+    name: "cimplify-tanstack-r2-cache",
+    options: driverOptions,
+    async hasItem(key) {
+      const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+      if (!runtimeEnv) return false;
+      try {
+        const object = await runtimeEnv.r2.head(
+          cimplifyTanstackR2Key(
+            runtimeEnv.prefix,
+            key,
+            driverOptions.namespace ?? TANSTACK_CACHE_NAMESPACE
+          )
+        );
+        return Boolean(object);
+      } catch {
+        return false;
+      }
+    },
+    async getItem(key) {
+      const raw = await getRawItem(driverOptions, key);
+      if (raw === null) return null;
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return raw;
+      }
+    },
+    async getItemRaw(key) {
+      return getRawItem(driverOptions, key);
+    },
+    async setItem(key, value, options2) {
+      const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+      if (!runtimeEnv) return;
+      const strippedValue = valueForStorage(value);
+      await putAndIndex(
+        runtimeEnv,
+        driverOptions,
+        key,
+        JSON.stringify(strippedValue) ?? "null",
+        value,
+        options2
+      );
+    },
+    async setItemRaw(key, value, options2) {
+      const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+      if (!runtimeEnv) return;
+      await putAndIndex(runtimeEnv, driverOptions, key, value, value, options2);
+    },
+    async removeItem(key) {
+      const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+      if (!runtimeEnv) return;
+      try {
+        await runtimeEnv.r2.delete(
+          cimplifyTanstackR2Key(
+            runtimeEnv.prefix,
+            key,
+            driverOptions.namespace ?? TANSTACK_CACHE_NAMESPACE
+          )
+        );
+      } catch {
+      }
+    },
+    async getKeys(base) {
+      const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+      if (!runtimeEnv) return [];
+      const namespace = driverOptions.namespace ?? TANSTACK_CACHE_NAMESPACE;
+      try {
+        const keys = await listR2Keys(
+          runtimeEnv.r2,
+          cimplifyTanstackR2ListPrefix(runtimeEnv.prefix, base, namespace)
+        );
+        return keys.map((key) => storageKeyFromR2Key(runtimeEnv.prefix, namespace, key));
+      } catch {
+        return [];
+      }
+    },
+    async clear(base) {
+      const runtimeEnv = await resolveRuntimeEnv(driverOptions);
+      if (!runtimeEnv) return;
+      const namespace = driverOptions.namespace ?? TANSTACK_CACHE_NAMESPACE;
+      try {
+        const keys = await listR2Keys(
+          runtimeEnv.r2,
+          cimplifyTanstackR2ListPrefix(runtimeEnv.prefix, base, namespace)
+        );
+        await Promise.all(keys.map((key) => runtimeEnv.r2.delete(key)));
+      } catch {
+      }
+    }
+  };
+}
+var cimplifyTanstackCacheDriver = createCimplifyTanstackCacheDriver;
+
+export { CIMPLIFY_CACHE_META_FIELD, CIMPLIFY_TAG_PREFIX, TANSTACK_CACHE_NAMESPACE, TANSTACK_PATH_INDEX_BINDING, TANSTACK_R2_BUCKET_BINDING, TANSTACK_R2_PREFIX_ENV, cimplifyTanstackCacheDriver, cimplifyTanstackCacheOptions, cimplifyTanstackR2Key, createCimplifyTanstackCacheDriver, withCimplifyCacheMetadata };

package/dist/testing/msw.js

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkXQ6LEDEO_js = require('../chunk-XQ6LEDEO.js');
+var chunkOGQFDCZM_js = require('../chunk-OGQFDCZM.js');
 require('../chunk-XA3ZNR75.js');
 require('../chunk-OWW5GUSB.js');
 
 // src/mock/msw.ts
 async function createMswHandlers(options = {}) {
   const baseUrl = options.baseUrl ?? "http://localhost:8787";
-  const handle = chunkXQ6LEDEO_js.createMockApp(options);
+  const handle = chunkOGQFDCZM_js.createMockApp(options);
   const msw = await import('msw').catch(() => {
     throw new Error("msw is required to use @cimplify/sdk/mock/msw \u2014 install it as a peer dependency");
   });

package/dist/testing/msw.mjs

@@ -1,4 +1,4 @@
-import { createMockApp } from '../chunk-QXMO2LGU.mjs';
+import { createMockApp } from '../chunk-J7L5LHGK.mjs';
 import '../chunk-AMZXALF6.mjs';
 import '../chunk-3G6RQLXK.mjs';
 

package/dist/testing/suite.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkXGKMSLMJ_js = require('../chunk-XGKMSLMJ.js');
-require('../chunk-XQ6LEDEO.js');
+var chunkY64AIRGW_js = require('../chunk-Y64AIRGW.js');
+require('../chunk-OGQFDCZM.js');
 require('../chunk-QS4XDVHI.js');
 require('../chunk-CV5QMDQS.js');
 require('../chunk-7Y2O3E4D.js');
@@ -20,11 +20,11 @@ var PLACEHOLDER_PHRASES = [
 function createBrandSuite(opts) {
   vitest.describe(opts.label ?? "brand schema", () => {
     vitest.it("conforms to the Cimplify brand contract", () => {
-      vitest.expect(() => chunkXGKMSLMJ_js.assertBrand(opts.brand)).not.toThrow();
+      vitest.expect(() => chunkY64AIRGW_js.assertBrand(opts.brand)).not.toThrow();
     });
     vitest.it("declares a known mock seed", () => {
       const b = opts.brand;
-      vitest.expect(chunkXGKMSLMJ_js.SeedNameSchema.safeParse(b.mock?.seed).success).toBe(true);
+      vitest.expect(chunkY64AIRGW_js.SeedNameSchema.safeParse(b.mock?.seed).success).toBe(true);
     });
     vitest.it("has no placeholder copy left in", () => {
       const offenders = [];
@@ -56,7 +56,7 @@ ${msg}`);
       vitest.expect(b.mock?.businessId).toMatch(/^bus_/);
     });
     vitest.it("zod-parses cleanly", () => {
-      const result = chunkXGKMSLMJ_js.BrandSchema.safeParse(opts.brand);
+      const result = chunkY64AIRGW_js.BrandSchema.safeParse(opts.brand);
       if (!result.success) {
         throw new Error(
           "Brand schema violations:\n" + result.error.issues.map((i) => `  \u2022 brand.${i.path.join(".")}: ${i.message}`).join("\n")
@@ -71,23 +71,23 @@ function createCartFlowSuite(opts = {}) {
   vitest.describe(opts.label ?? "cart flow against in-process mock", () => {
     let h;
     vitest.beforeEach(() => {
-      h = chunkXGKMSLMJ_js.createTestClient(opts);
+      h = chunkY64AIRGW_js.createTestClient(opts);
     });
     vitest.afterEach(() => h.dispose());
     vitest.it("starts with an empty cart matching the canonical shape", async () => {
       const res = await h.client.cart.get();
       vitest.expect(res.ok).toBe(true);
       if (!res.ok) return;
-      vitest.expect(() => chunkXGKMSLMJ_js.assertCart(res.value)).not.toThrow();
+      vitest.expect(() => chunkY64AIRGW_js.assertCart(res.value)).not.toThrow();
       vitest.expect(res.value.items).toHaveLength(0);
     });
     vitest.it("adds the first product, persists it, and returns a shape-valid cart", async () => {
-      const { product, variantId } = await chunkXGKMSLMJ_js.fixtures.addFirstProduct(h.client);
+      const { product, variantId } = await chunkY64AIRGW_js.fixtures.addFirstProduct(h.client);
       vitest.expect(product.id).toBeTruthy();
       const get = await h.client.cart.get();
       vitest.expect(get.ok).toBe(true);
       if (!get.ok) return;
-      vitest.expect(() => chunkXGKMSLMJ_js.assertCart(get.value)).not.toThrow();
+      vitest.expect(() => chunkY64AIRGW_js.assertCart(get.value)).not.toThrow();
       vitest.expect(get.value.items).toHaveLength(1);
       vitest.expect(get.value.items[0]?.item_id).toBe(product.id);
       if (variantId) {
@@ -98,8 +98,8 @@ function createCartFlowSuite(opts = {}) {
       vitest.expect(parseFloat(String(get.value.pricing.subtotal))).toBeGreaterThan(0);
     });
     vitest.it("dedupes by line_key when adding the same product twice", async () => {
-      await chunkXGKMSLMJ_js.fixtures.addFirstProduct(h.client);
-      await chunkXGKMSLMJ_js.fixtures.addFirstProduct(h.client);
+      await chunkY64AIRGW_js.fixtures.addFirstProduct(h.client);
+      await chunkY64AIRGW_js.fixtures.addFirstProduct(h.client);
       const res = await h.client.cart.get();
       vitest.expect(res.ok).toBe(true);
       if (!res.ok) return;
@@ -107,7 +107,7 @@ function createCartFlowSuite(opts = {}) {
       vitest.expect(res.value.items[0]?.quantity).toBe(2);
     });
     vitest.it("removes items and zeroes the subtotal", async () => {
-      await chunkXGKMSLMJ_js.fixtures.addFirstProduct(h.client);
+      await chunkY64AIRGW_js.fixtures.addFirstProduct(h.client);
       const before = await h.client.cart.get();
       if (!before.ok) throw before.error;
       const itemId = before.value.items[0]?.id;
@@ -133,28 +133,28 @@ function createContractSuite(opts = {}) {
   vitest.describe(opts.label ?? "SDK \u2194 mock contract", () => {
     let h;
     vitest.beforeEach(() => {
-      h = chunkXGKMSLMJ_js.createTestClient(opts);
+      h = chunkY64AIRGW_js.createTestClient(opts);
     });
     vitest.afterEach(() => h.dispose());
     vitest.it("AddItemPayload schema accepts a minimal valid body", () => {
-      const result = chunkXGKMSLMJ_js.AddItemPayloadSchema.safeParse({ item_id: "prod_x", quantity: 1 });
+      const result = chunkY64AIRGW_js.AddItemPayloadSchema.safeParse({ item_id: "prod_x", quantity: 1 });
       vitest.expect(result.success).toBe(true);
     });
     vitest.it("AddItemPayload schema rejects negative quantity", () => {
-      const result = chunkXGKMSLMJ_js.AddItemPayloadSchema.safeParse({ item_id: "prod_x", quantity: -1 });
+      const result = chunkY64AIRGW_js.AddItemPayloadSchema.safeParse({ item_id: "prod_x", quantity: -1 });
       vitest.expect(result.success).toBe(false);
     });
     vitest.it("AddItemPayload schema rejects empty item_id", () => {
-      const result = chunkXGKMSLMJ_js.AddItemPayloadSchema.safeParse({ item_id: "", quantity: 1 });
+      const result = chunkY64AIRGW_js.AddItemPayloadSchema.safeParse({ item_id: "", quantity: 1 });
       vitest.expect(result.success).toBe(false);
     });
     vitest.it("Cart line items returned by the mock match CartItemSchema", async () => {
-      const { product } = await chunkXGKMSLMJ_js.fixtures.addFirstProduct(h.client);
+      const { product } = await chunkY64AIRGW_js.fixtures.addFirstProduct(h.client);
       const get = await h.client.cart.get();
       if (!get.ok) throw get.error;
       vitest.expect(get.value.items.length).toBeGreaterThan(0);
       for (const item of get.value.items) {
-        const result = chunkXGKMSLMJ_js.CartItemSchema.safeParse(item);
+        const result = chunkY64AIRGW_js.CartItemSchema.safeParse(item);
         if (!result.success) {
           const issues = result.error.issues.map((i) => `  \u2022 ${i.path.join(".")}: ${i.message}`).join("\n");
           throw new Error(`Cart item shape mismatch for ${product.name}:
@@ -164,19 +164,19 @@ ${issues}`);
       }
     });
     vitest.it("CheckoutResponse from the mock includes bill_token", async () => {
-      await chunkXGKMSLMJ_js.fixtures.addFirstProduct(h.client);
+      await chunkY64AIRGW_js.fixtures.addFirstProduct(h.client);
       const cartRes = await h.client.cart.get();
       if (!cartRes.ok) throw cartRes.error;
       const checkout = await h.client.checkout.process({
         cart_id: cartRes.value.id,
-        customer: chunkXGKMSLMJ_js.fixtures.customer(),
+        customer: chunkY64AIRGW_js.fixtures.customer(),
         order_type: "delivery",
         payment_method: "mobile_money",
         mobile_money_details: { phone_number: "+233244000000", provider: "mtn" }
       });
       vitest.expect(checkout.ok).toBe(true);
       if (!checkout.ok) return;
-      const result = chunkXGKMSLMJ_js.CheckoutResponseSchema.safeParse(checkout.value);
+      const result = chunkY64AIRGW_js.CheckoutResponseSchema.safeParse(checkout.value);
       if (!result.success) {
         const issues = result.error.issues.map((i) => `  \u2022 ${i.path.join(".")}: ${i.message}`).join("\n");
         throw new Error(`CheckoutResponse shape mismatch:

package/dist/testing/suite.mjs

@@ -1,5 +1,5 @@
-import { assertBrand, SeedNameSchema, BrandSchema, createTestClient, assertCart, fixtures, AddItemPayloadSchema, CartItemSchema, CheckoutResponseSchema } from '../chunk-UUW7WBCG.mjs';
-import '../chunk-QXMO2LGU.mjs';
+import { assertBrand, SeedNameSchema, BrandSchema, createTestClient, assertCart, fixtures, AddItemPayloadSchema, CartItemSchema, CheckoutResponseSchema } from '../chunk-BYWJSPT4.mjs';
+import '../chunk-J7L5LHGK.mjs';
 import '../chunk-H337NF4O.mjs';
 import '../chunk-3BKMNVTR.mjs';
 import '../chunk-TD3AY34U.mjs';