@hanzo/commerce 7.6.0 → 7.6.3

package/dist/util/promo-codes.js

@@ -0,0 +1,100 @@
+const referallCodeDiscountedSkus = [
+    'LXM-CR-B-ABT', 'LXM-CR-B-GM', 'LXM-CR-F-CC', 'LXM-CR-F-IC', 'LXM-CR-E-24G', 'LXM-CR-E-SS', 'LXM-CR-S-RT', // credit cards
+    'LXM-VL-GN', 'LXM-VL-VL', 'LXM-VL-MI', 'LXM-VL-NA', // validators
+    'LXM-PS-PS', // pass
+    'LXM-AG-B-1_OZ', // silver
+];
+const PROMO_CODES = [
+    {
+        type: 'percent',
+        code: 'ANGEL',
+        value: 22
+    },
+    {
+        type: 'percent',
+        code: 'NASSER',
+        value: 11.11
+    },
+    {
+        type: 'percent',
+        code: 'ROSEY',
+        value: 20
+    },
+    {
+        type: 'percent',
+        code: 'IYKYK',
+        value: 11.1
+    },
+    {
+        type: 'percent',
+        code: 'GENESIS',
+        value: 99,
+        skus: ['LXM-PS-PS']
+    },
+    {
+        type: 'percent',
+        code: 'ANTJE',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'ASHLEY',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'CALE',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'DARA',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'KENJI',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'MAJOR',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'CYRUS',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'STOBIE',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'SKYLER',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    },
+    {
+        type: 'percent',
+        code: 'ZEEKAY',
+        value: 33.3,
+        skus: referallCodeDiscountedSkus
+    }
+];
+// TODO: implement a real API call
+const getPromoFromApi = async (code) => {
+    return PROMO_CODES.find(promo => promo.code === code);
+};
+export { getPromoFromApi as default };
+//# sourceMappingURL=promo-codes.js.map

package/dist/util/promo-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promo-codes.js","sourceRoot":"","sources":["../../util/promo-codes.ts"],"names":[],"mappings":"AAEA,MAAM,0BAA0B,GAAG;IACjC,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe;IAC1H,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa;IACjE,WAAW,EAAG,OAAO;IACrB,eAAe,EAAE,SAAS;CAC3B,CAAA;AAED,MAAM,WAAW,GAAY;IAC3B;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE;KACV;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK;KACb;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE;KACV;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;KACZ;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,CAAC,WAAW,CAAC;KACpB;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,0BAA0B;KACjC;CACF,CAAA;AAED,kCAAkC;AAClC,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;IAC7C,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AACvD,CAAC,CAAA;AAED,OAAO,EACL,eAAe,IAAI,OAAO,EAC3B,CAAA"}

package/dist/util/selection-ui-specifiers.d.ts

@@ -0,0 +1,3 @@
+import type { SelectionUISpecifier } from '../types';
+export declare const initSelectionUI: (v: Record<string, SelectionUISpecifier>) => void;
+export declare const getSelectionUISpecifier: (skuPath: string) => SelectionUISpecifier;

package/dist/util/selection-ui-specifiers.js

@@ -0,0 +1,24 @@
+import sep from '../service/sep';
+const DEFAULT = {
+    multiFamily: {
+        type: 'all-variants-carousel'
+    },
+    singleFamily: { type: 'carousel' }
+};
+const map = new Map();
+// key: first two tokens of path
+export const initSelectionUI = (v) => {
+    // Might have multiple calls client and server side
+    if (map.size > 0) {
+        map.clear();
+    }
+    for (let [key, value] of Object.entries(v)) {
+        map.set(key, value);
+    }
+};
+export const getSelectionUISpecifier = (skuPath) => {
+    const key = skuPath.split(sep.tok).slice(0, 2).join(sep.tok);
+    const result = map.get(key);
+    return result ?? DEFAULT;
+};
+//# sourceMappingURL=selection-ui-specifiers.js.map

package/dist/util/selection-ui-specifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-ui-specifiers.js","sourceRoot":"","sources":["../../util/selection-ui-specifiers.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,gBAAgB,CAAA;AAEhC,MAAM,OAAO,GAAG;IACd,WAAW,EAAE;QACX,IAAI,EAAE,uBAAuB;KAC9B;IACD,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;CACJ,CAAA;AAEhC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAgC,CAAA;AAEjD,gCAAgC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAuC,EAAE,EAAE;IAEvE,mDAAmD;IACrD,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,EAAE,CAAA;IACb,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAe,EAAwB,EAAE;IAC/E,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,OAAO,MAAM,IAAI,OAAO,CAAA;AAC1B,CAAC,CAAA"}

package/dist/util/square-payment.d.ts

@@ -0,0 +1,7 @@
+declare global {
+    interface BigInt {
+        toJSON(): string;
+    }
+}
+declare const processPayment: (sourceId: string, amount: number, verificationToken: string) => Promise<any>;
+export { processPayment as default };

package/dist/util/square-payment.js

@@ -0,0 +1,37 @@
+// Payment processing - requires API endpoint
+// For static builds, this will call an external payment API
+BigInt.prototype.toJSON = function () { return this.toString(); };
+const processPayment = async (sourceId, amount, verificationToken) => {
+    // For static builds, payments should be processed via an API endpoint
+    // Check if we're in a browser environment
+    if (typeof window !== 'undefined') {
+        // Client-side: call the payment API
+        try {
+            const response = await fetch('/api/payment', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    sourceId,
+                    amount,
+                    verificationToken
+                })
+            });
+            if (!response.ok) {
+                console.error('Payment API error:', response.statusText);
+                return null;
+            }
+            return await response.json();
+        }
+        catch (error) {
+            console.error('Error processing payment:', error);
+            return null;
+        }
+    }
+    // Server-side (for SSR builds only, not static export)
+    console.warn('Server-side payment processing not available in static export');
+    return null;
+};
+export { processPayment as default };
+//# sourceMappingURL=square-payment.js.map

package/dist/util/square-payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"square-payment.js","sourceRoot":"","sources":["../../util/square-payment.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,4DAA4D;AAS5D,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,cAAa,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;AAEhE,MAAM,cAAc,GAAG,KAAK,EAAE,QAAgB,EAAE,MAAc,EAAE,iBAAyB,EAAE,EAAE;IAC3F,sEAAsE;IACtE,0CAA0C;IAC1C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,QAAQ;oBACR,MAAM;oBACN,iBAAiB;iBAClB,CAAC;aACH,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;gBACxD,OAAO,IAAI,CAAA;YACb,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAA;YACjD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,OAAO,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC7E,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,OAAO,EACL,cAAc,IAAI,OAAO,EAC1B,CAAA"}

package/dist/util/use-sync-sku-param-w-current-item.d.ts

@@ -0,0 +1,2 @@
+declare const useSyncSkuParamWithCurrentItem: (familyLevel: number, setMessage: (m: string | undefined) => void, setLoading?: (l: boolean) => void) => void;
+export default useSyncSkuParamWithCurrentItem;

package/dist/util/use-sync-sku-param-w-current-item.js

@@ -0,0 +1,61 @@
+"use client";
+import { useEffect } from 'react';
+import { reaction } from 'mobx';
+import { useQueryState, parseAsString, parseAsBoolean, } from 'next-usequerystate';
+import { useCommerce } from '../service/context';
+import sep from '../service/sep';
+const PLEASE_SELECT_FACETS = 'Please select an option from each group.';
+const useSyncSkuParamWithCurrentItem = (familyLevel, setMessage, setLoading) => {
+    const cmmc = useCommerce();
+    const [skuParam, setSkuParam] = useQueryState('sku', parseAsString.withDefault('').withOptions({ clearOnDefault: true }));
+    const [addParam, setAddParam] = useQueryState('add', parseAsBoolean.withDefault(false).withOptions({ clearOnDefault: true }));
+    useEffect(() => {
+        return reaction(() => ({
+            specifiedCat: cmmc.selectedFamilies.length === 1 ? cmmc.selectedFamilies[0] : undefined,
+            currentItem: cmmc.currentItem
+        }), ({ specifiedCat, currentItem }) => {
+            //console.log("REACTION: " + `CAT ID: ${family?.id} SKU: ${item?.sku}`)
+            if (currentItem) {
+                // if we set the currentItem w sku, then user selects other facets
+                if (specifiedCat && currentItem.familyId != specifiedCat.id) {
+                    cmmc.setCurrentItem(specifiedCat.products[0].sku);
+                }
+                setSkuParam(cmmc.currentItem.sku);
+            }
+            else if (specifiedCat) {
+                cmmc.setCurrentItem(specifiedCat.products[0].sku);
+                setSkuParam(cmmc.currentItem.sku);
+            }
+        });
+    }, []);
+    useEffect(() => {
+        const setCurrentFamilyFromSku = (sku) => {
+            const toks = sku.split(sep.tok);
+            const fv = {};
+            // TODO: confirm that extra trailing nonsense tokens won't break selectPaths()
+            for (let i = 1; i < familyLevel; i++) {
+                if (i in toks) {
+                    fv[i] = [toks[i]];
+                }
+            }
+            cmmc.selectPaths(fv);
+        };
+        // setCI returns true if it's a recognized sku
+        if (skuParam && cmmc.setCurrentItem(skuParam)) {
+            if (addParam) {
+                if (cmmc.currentItem.quantity === 0) {
+                    cmmc.currentItem.increment();
+                }
+                setAddParam(false);
+            }
+            setCurrentFamilyFromSku(skuParam);
+            setMessage(undefined);
+        }
+        else {
+            setMessage(PLEASE_SELECT_FACETS);
+        }
+        setLoading && setLoading(false);
+    }, [skuParam]);
+};
+export default useSyncSkuParamWithCurrentItem;
+//# sourceMappingURL=use-sync-sku-param-w-current-item.js.map

package/dist/util/use-sync-sku-param-w-current-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sync-sku-param-w-current-item.js","sourceRoot":"","sources":["../../util/use-sync-sku-param-w-current-item.ts"],"names":[],"mappings":"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"}

package/index.ts

@@ -17,6 +17,7 @@ export { Commerce, CommerceApiError, hanzoCommerce } from './client'
 export type {
   CommerceClientConfig,
   Balance,
+  TierResponse,
   Transaction,
   Subscription,
   Plan,
@@ -37,4 +38,20 @@ export type {
   Referrer,
   Affiliate,
   CreditGrant,
-} from './client'
+} from './client'
+
+// Server-side usage metering (the one way every product meters to commerce)
+export {
+  Metering,
+  DEFAULT_COMMERCE_URL,
+  identityFromHeaders,
+  HEADER_USER_ID,
+  HEADER_ORG_ID,
+} from './metering'
+export type {
+  MeteringConfig,
+  MeteringIdentity,
+  UsageEvent,
+  RecordResult,
+  AuthDecision,
+} from './metering'

package/metering.test.ts

@@ -0,0 +1,199 @@
+/**
+ * Contract tests for @hanzo/commerce/metering.
+ *
+ * Self-contained: mocks global fetch and asserts the exact commerce wire
+ * contract, mirroring github.com/hanzoai/go-sdk/metering's tests so the two
+ * clients gate on the identical balance source. Runnable standalone with:
+ *
+ *   npx -y -p typescript@5.9.3 -p tsx tsx pkgs/commerce/metering.test.ts
+ *
+ * It uses no test-runner dependency (the package ships none); a tiny harness
+ * below prints PASS/FAIL and exits non-zero on failure.
+ */
+
+import { Metering, identityFromHeaders } from './metering'
+
+// ---- tiny assert harness ----
+let failures = 0
+let count = 0
+function test(name: string, fn: () => Promise<void> | void) {
+  count++
+  Promise.resolve()
+    .then(fn)
+    .then(() => console.log(`ok   - ${name}`))
+    .catch((err) => {
+      failures++
+      console.error(`FAIL - ${name}\n       ${err?.message ?? err}`)
+    })
+}
+function eq(actual: unknown, expected: unknown, msg = '') {
+  if (actual !== expected) throw new Error(`${msg} expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`)
+}
+function ok(cond: boolean, msg = '') {
+  if (!cond) throw new Error(msg || 'expected true')
+}
+
+// ---- fetch mock ----
+type Captured = { url: string; method: string; headers: Record<string, string>; body: unknown }
+function mockFetch(status: number, json: unknown): { restore: () => void; last: () => Captured | null } {
+  const original = globalThis.fetch
+  let last: Captured | null = null
+  globalThis.fetch = (async (input: RequestInfo | URL, init?: RequestInit) => {
+    const hdrs: Record<string, string> = {}
+    const h = init?.headers as Record<string, string> | undefined
+    if (h) for (const [k, v] of Object.entries(h)) hdrs[k.toLowerCase()] = v as string
+    last = {
+      url: input.toString(),
+      method: init?.method ?? 'GET',
+      headers: hdrs,
+      body: init?.body ? JSON.parse(init.body as string) : undefined,
+    }
+    return {
+      ok: status >= 200 && status < 300,
+      status,
+      statusText: `HTTP ${status}`,
+      json: async () => json,
+      text: async () => JSON.stringify(json),
+    } as Response
+  }) as typeof fetch
+  return { restore: () => { globalThis.fetch = original }, last: () => last }
+}
+
+const BASE = 'http://commerce.test'
+
+test('authorize allows when available > 0 and hits the canonical contract', async () => {
+  const fx = mockFetch(200, { user: 'hanzo/alice', currency: 'usd', balance: 5000, holds: 0, available: 5000 })
+  const meter = new Metering({ baseUrl: BASE, token: 'svc-token', org: 'hanzo' })
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  fx.restore()
+
+  ok(d.allowed, 'should allow')
+  eq(d.available, 5000, 'available')
+  const c = fx.last()!
+  eq(c.method, 'GET', 'method')
+  ok(c.url.startsWith(`${BASE}/v1/billing/balance?`), `url=${c.url}`)
+  ok(c.url.includes('user=hanzo%2Falice'), `url must url-encode user: ${c.url}`)
+  ok(c.url.includes('currency=usd'), `url must carry currency: ${c.url}`)
+  eq(c.headers['authorization'], 'Bearer svc-token', 'bearer')
+  eq(c.headers['x-iam-org-id'], 'hanzo', 'org header')
+})
+
+test('authorize denies (insufficient) when available == 0', async () => {
+  const fx = mockFetch(200, { available: 0 })
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo' })
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  fx.restore()
+  ok(!d.allowed, 'should deny')
+  eq(d.reason, 'insufficient_balance', 'reason')
+})
+
+test('authorize fail-closed on commerce error (503/unavailable)', async () => {
+  const fx = mockFetch(500, { error: 'boom' })
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo' })
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  fx.restore()
+  ok(!d.allowed, 'fail-closed must deny on 500')
+  eq(d.reason, 'balance_unavailable', 'reason')
+})
+
+test('authorize fail-open allows on commerce error when configured', async () => {
+  const fx = mockFetch(503, { error: 'down' })
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo', failOpen: true })
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  fx.restore()
+  ok(d.allowed, 'fail-open must allow')
+})
+
+test('authorize not-configured allows', async () => {
+  const meter = new Metering({}) // no baseUrl
+  ok(!meter.enabled, 'enabled should be false')
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  ok(d.allowed, 'not-configured must allow')
+})
+
+test('tier-aware authorize uses effectiveAvailable and hits /v1/billing/tier', async () => {
+  const fx = mockFetch(200, { user: 'hanzo/alice', tier: { name: 'free' }, balance: { currency: 'usd', prepaidAvailable: 0, dailyRemaining: 100, effectiveAvailable: 100 } })
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo', tierAware: true })
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  fx.restore()
+  ok(d.allowed, 'included allotment should allow')
+  eq(d.available, 100, 'effective available')
+  ok(fx.last()!.url.startsWith(`${BASE}/v1/billing/tier?`), `tier url=${fx.last()!.url}`)
+})
+
+test('tier-aware authorize denies when effectiveAvailable == 0', async () => {
+  const fx = mockFetch(200, { balance: { effectiveAvailable: 0, prepaidAvailable: 0, dailyRemaining: 0, currency: 'usd' } })
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo', tierAware: true })
+  const d = await meter.authorize({ user: 'hanzo/alice' })
+  fx.restore()
+  ok(!d.allowed && d.reason === 'insufficient_balance', 'exhausted must deny insufficient')
+})
+
+test('per-call org overrides default', async () => {
+  const fx = mockFetch(200, { available: 1 })
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo' })
+  await meter.authorize({ user: 'zoo/bob', org: 'zoo' })
+  fx.restore()
+  eq(fx.last()!.headers['x-iam-org-id'], 'zoo', 'per-call org override')
+})
+
+test('record posts canonical payload', async () => {
+  const fx = mockFetch(201, { transactionId: 'tx_123', user: 'hanzo/alice', amount: 250, currency: 'usd', type: 'withdraw' })
+  const meter = new Metering({ baseUrl: BASE, token: 'svc-token', org: 'hanzo' })
+  const res = await meter.record({ user: 'hanzo/alice', amount: 250, provider: 'search', requestId: 'req-9', status: 'success' })
+  fx.restore()
+
+  ok(res !== null && res.transactionId === 'tx_123' && res.amount === 250, 'record result')
+  const c = fx.last()!
+  eq(c.method, 'POST', 'method')
+  eq(c.url, `${BASE}/v1/billing/usage`, 'usage url')
+  eq(c.headers['authorization'], 'Bearer svc-token', 'bearer')
+  eq(c.headers['x-iam-org-id'], 'hanzo', 'org header')
+  const b = c.body as Record<string, unknown>
+  eq(b.user, 'hanzo/alice', 'body.user')
+  eq(b.amount, 250, 'body.amount')
+  eq(b.currency, 'usd', 'body.currency defaulted')
+  eq(b.provider, 'search', 'body.provider')
+  eq(b.requestId, 'req-9', 'body.requestId')
+  ok(!('org' in b), 'org must not leak into the body')
+})
+
+test('record zero-amount is a no-op (no fetch)', async () => {
+  const fx = mockFetch(200, {})
+  const meter = new Metering({ baseUrl: BASE, token: 't', org: 'hanzo' })
+  const res = await meter.record({ user: 'hanzo/alice', amount: 0 })
+  fx.restore()
+  ok(res === null, 'zero-amount returns null')
+  ok(fx.last() === null, 'zero-amount must not call commerce')
+})
+
+test('record not-configured is a no-op', async () => {
+  const meter = new Metering({})
+  const res = await meter.record({ user: 'hanzo/alice', amount: 100 })
+  ok(res === null, 'not-configured returns null')
+})
+
+test('fromEnv applies defaults and reads KMS-sourced token', () => {
+  const meter = Metering.fromEnv({ COMMERCE_SERVICE_TOKEN: 'kms-token', METERING_TIER_AWARE: 'true' })
+  ok(meter.enabled, 'fromEnv default base URL enables the meter')
+})
+
+test('fromEnv honors METERING_DISABLED', () => {
+  const meter = Metering.fromEnv({ METERING_DISABLED: 'true', COMMERCE_URL: BASE })
+  ok(!meter.enabled, 'disabled must not be enabled')
+})
+
+test('identityFromHeaders builds org/sub from gateway headers', () => {
+  const id = identityFromHeaders({ 'x-org-id': 'zoo', 'x-user-id': 'bob' })
+  eq(id.user, 'zoo/bob', 'user')
+  eq(id.org, 'zoo', 'org')
+})
+
+// summary
+setTimeout(() => {
+  if (failures > 0) {
+    console.error(`\n${failures}/${count} tests FAILED`)
+    process.exit(1)
+  }
+  console.log(`\nall ${count} tests passed`)
+}, 200)