@ingram-tech/nk-billing 0.2.0 → 0.2.1

package/dist/balance.d.ts

@@ -1,6 +1,6 @@
 /**
- * Customer-balance wallet — Stripe's own credit ledger, for pay-as-you-go sites
- * (domains.ingram.tech). Distinct from the in-app credit ledger in
+ * Customer-balance wallet — Stripe's own credit ledger, for pay-as-you-go
+ * sites. Distinct from the in-app credit ledger in
  * `@ingram-tech/nk-billing/credits`: this stores the balance *in Stripe* as a
  * signed integer (negative = credit available to the customer), so there is no
  * local table to keep in sync. Pick this when the unit you sell is money;

package/dist/balance.js

@@ -1,6 +1,6 @@
 /**
- * Customer-balance wallet — Stripe's own credit ledger, for pay-as-you-go sites
- * (domains.ingram.tech). Distinct from the in-app credit ledger in
+ * Customer-balance wallet — Stripe's own credit ledger, for pay-as-you-go
+ * sites. Distinct from the in-app credit ledger in
  * `@ingram-tech/nk-billing/credits`: this stores the balance *in Stripe* as a
  * signed integer (negative = credit available to the customer), so there is no
  * local table to keep in sync. Pick this when the unit you sell is money;

package/dist/client.d.ts

@@ -4,8 +4,9 @@
  *
  * This is the one pattern every Ingram site had hand-rolled identically (the
  * `getStripe()` singleton); it lives here once now. Single-mode sites call
- * {@link getStripe}; the dual-mode site (cloud.ingram.tech) calls
- * {@link stripeFor} with a mode and gets one memoised client per mode.
+ * {@link getStripe}; a dual-mode site (its own merchant of record, running the
+ * Stripe sandbox beside live) calls {@link stripeFor} with a mode and gets one
+ * memoised client per mode.
  */
 import Stripe from "stripe";
 import { type StripeMode } from "./keys.js";

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAexD;;mCAEmC;AACnC,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED;0CAC0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAelD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAexD;;mCAEmC;AACnC,wBAAgB,SAAS,IAAI,MAAM,CAOlC;AAED;0CAC0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAelD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}

package/dist/client.js

@@ -4,8 +4,9 @@
  *
  * This is the one pattern every Ingram site had hand-rolled identically (the
  * `getStripe()` singleton); it lives here once now. Single-mode sites call
- * {@link getStripe}; the dual-mode site (cloud.ingram.tech) calls
- * {@link stripeFor} with a mode and gets one memoised client per mode.
+ * {@link getStripe}; a dual-mode site (its own merchant of record, running the
+ * Stripe sandbox beside live) calls {@link stripeFor} with a mode and gets one
+ * memoised client per mode.
  */
 import Stripe from "stripe";
 import { billingEnv } from "./keys.js";

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AAExD,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,MAAM,MAAM,GAAwC,EAAE,CAAC;AAEvD,SAAS,SAAS,CAAC,GAAW;IAC7B,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;IACpC,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,MAAM,GAAG,UAAU;QACxB,CAAC,CAAE,EAAE,UAAU,EAA8C;QAC7D,CAAC,CAAC,SAAS,CAAC;IACb,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;mCAEmC;AACnC,MAAM,UAAU,SAAS;IACxB,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC1C,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC1D,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;0CAC0C;AAC1C,MAAM,UAAU,SAAS,CAAC,IAAgB;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,GACR,IAAI,KAAK,MAAM;QACd,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB;QACpC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACd,qBAAqB,IAAI,CAAC,WAAW,EAAE,iCAAiC,CACxE,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACtB,OAAO,MAAM,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB;IACjC,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,MAAM,CAAC,IAAI,CAAC;IACnB,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AAExD,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,MAAM,MAAM,GAAwC,EAAE,CAAC;AAEvD,SAAS,SAAS,CAAC,GAAW;IAC7B,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;IACpC,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,MAAM,GAAG,UAAU;QACxB,CAAC,CAAE,EAAE,UAAU,EAA8C;QAC7D,CAAC,CAAC,SAAS,CAAC;IACb,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;mCAEmC;AACnC,MAAM,UAAU,SAAS;IACxB,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC1C,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC1D,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;0CAC0C;AAC1C,MAAM,UAAU,SAAS,CAAC,IAAgB;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,GACR,IAAI,KAAK,MAAM;QACd,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB;QACpC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACd,qBAAqB,IAAI,CAAC,WAAW,EAAE,iCAAiC,CACxE,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACtB,OAAO,MAAM,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB;IACjC,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,MAAM,CAAC,IAAI,CAAC;IACnB,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/credits.d.ts

@@ -1,6 +1,6 @@
 /**
  * The in-app credit ledger — the stateful half of nk-billing, for sites that
- * meter usage in abstract "credits" rather than money (integrain). It follows
+ * meter usage in abstract "credits" rather than money. It follows
  * nextkit's Django-app model: this package owns its tables and ships their
  * migration (`migrations/0001_billing.sql`), and takes the database connection by
  * **injection** so it never reaches into the consuming site's schema.

package/dist/credits.js

@@ -1,6 +1,6 @@
 /**
  * The in-app credit ledger — the stateful half of nk-billing, for sites that
- * meter usage in abstract "credits" rather than money (integrain). It follows
+ * meter usage in abstract "credits" rather than money. It follows
  * nextkit's Django-app model: this package owns its tables and ships their
  * migration (`migrations/0001_billing.sql`), and takes the database connection by
  * **injection** so it never reaches into the consuming site's schema.

package/dist/customers.d.ts

@@ -4,15 +4,15 @@
  * then finds it back by metadata search — no local `stripe_customer_id` column is
  * required just to locate the customer (though sites cache it for speed).
  *
- * The metadata key differs per site (`financica_organization_id`,
- * `integrain_org_id`, …), so it is always passed in explicitly via
- * {@link CustomerRef} rather than baked in here — that is the framework seam.
+ * The metadata key differs per site (`acme_organization_id`, `acme_user_id`,
+ * …), so it is always passed in explicitly via {@link CustomerRef} rather than
+ * baked in here — that is the framework seam.
  */
 import type Stripe from "stripe";
 /** Identifies a Stripe customer by a metadata tag → local entity id. */
 export interface CustomerRef {
     /** The Stripe `metadata` key the local id is stored under, e.g.
-     *  "integrain_org_id". Choose one per site and use it everywhere. */
+     *  "acme_org_id". Choose one per site and use it everywhere. */
     metadataKey: string;
     /** The local entity id (org id, user id, …). */
     id: string;

package/dist/customers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../src/customers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC3B;yEACqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,IAAI,CAAC;CACT;AAED;;gBAEgB;AAChB,wBAAsB,YAAY,CACjC,GAAG,EAAE,WAAW,EAChB,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAMjC;AAED;;eAEe;AACf,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,eAAoB,EAC7B,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAiC1B;AAED;gEACgE;AAChE,wBAAsB,yBAAyB,CAC9C,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;8CAC8C;AAC9C,wBAAsB,4BAA4B,CACjD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CACF,EACD,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAKf"}
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../src/customers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC3B;oEACgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,IAAI,CAAC;CACT;AAED;;gBAEgB;AAChB,wBAAsB,YAAY,CACjC,GAAG,EAAE,WAAW,EAChB,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAMjC;AAED;;eAEe;AACf,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,eAAoB,EAC7B,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAiC1B;AAED;gEACgE;AAChE,wBAAsB,yBAAyB,CAC9C,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;8CAC8C;AAC9C,wBAAsB,4BAA4B,CACjD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CACF,EACD,MAAM,GAAE,MAAoB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/customers.js

@@ -4,9 +4,9 @@
  * then finds it back by metadata search — no local `stripe_customer_id` column is
  * required just to locate the customer (though sites cache it for speed).
  *
- * The metadata key differs per site (`financica_organization_id`,
- * `integrain_org_id`, …), so it is always passed in explicitly via
- * {@link CustomerRef} rather than baked in here — that is the framework seam.
+ * The metadata key differs per site (`acme_organization_id`, `acme_user_id`,
+ * …), so it is always passed in explicitly via {@link CustomerRef} rather than
+ * baked in here — that is the framework seam.
  */
 import { getStripe } from "./client.js";
 /** The customer for `ref`, found by metadata search, or null if none exists yet.

package/dist/keys.d.ts

@@ -8,17 +8,17 @@
  *
  * Two deployment shapes are supported, picked per call site, never both at once:
  *
- *   1. Single-mode (the default — financica / integrain / thornhill): one
- *      account, one key. `getStripe()` reads STRIPE_SECRET_KEY and
- *      `webhookSecret()` reads STRIPE_WEBHOOK_SECRET.
+ *   1. Single-mode (the default for most sites): one account, one key.
+ *      `getStripe()` reads STRIPE_SECRET_KEY and `webhookSecret()` reads
+ *      STRIPE_WEBHOOK_SECRET.
  *
- *   2. Dual-mode (cloud.ingram.tech, which is its own merchant of record and
- *      runs the Stripe sandbox beside live): `stripeFor("test"|"live")` reads
+ *   2. Dual-mode (a site that is its own merchant of record and runs the Stripe
+ *      sandbox beside live): `stripeFor("test"|"live")` reads
  *      STRIPE_SECRET_KEY_{TEST,LIVE} and `webhookSecret(mode)` reads
  *      STRIPE_WEBHOOK_SECRET_{TEST,LIVE}.
  *
  * Nothing here hardcodes a price ID. Prices are resolved at runtime by their
- * stable Stripe `lookup_key` (set on the Price in the infra Pulumi program), so
+ * stable Stripe `lookup_key` (set on the Price out of band, e.g. in your IaC), so
  * the same key resolves in test and live even though their price IDs differ.
  */
 /** Which Stripe account a dual-mode site is talking to. */

package/dist/keys.js

@@ -8,17 +8,17 @@
  *
  * Two deployment shapes are supported, picked per call site, never both at once:
  *
- *   1. Single-mode (the default — financica / integrain / thornhill): one
- *      account, one key. `getStripe()` reads STRIPE_SECRET_KEY and
- *      `webhookSecret()` reads STRIPE_WEBHOOK_SECRET.
+ *   1. Single-mode (the default for most sites): one account, one key.
+ *      `getStripe()` reads STRIPE_SECRET_KEY and `webhookSecret()` reads
+ *      STRIPE_WEBHOOK_SECRET.
  *
- *   2. Dual-mode (cloud.ingram.tech, which is its own merchant of record and
- *      runs the Stripe sandbox beside live): `stripeFor("test"|"live")` reads
+ *   2. Dual-mode (a site that is its own merchant of record and runs the Stripe
+ *      sandbox beside live): `stripeFor("test"|"live")` reads
  *      STRIPE_SECRET_KEY_{TEST,LIVE} and `webhookSecret(mode)` reads
  *      STRIPE_WEBHOOK_SECRET_{TEST,LIVE}.
  *
  * Nothing here hardcodes a price ID. Prices are resolved at runtime by their
- * stable Stripe `lookup_key` (set on the Price in the infra Pulumi program), so
+ * stable Stripe `lookup_key` (set on the Price out of band, e.g. in your IaC), so
  * the same key resolves in test and live even though their price IDs differ.
  */
 import { z } from "zod";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ingram-tech/nk-billing",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"description": "The Ingram billing foundation: composable Stripe primitives (client, customers, prices, currency, checkout, subscriptions, webhooks) plus an injection-based Postgres credit ledger and event-dedup store.",
 	"license": "MIT",
 	"type": "module",
@@ -33,13 +33,13 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"stripe": "^22.0.0",
-		"zod": "^4.0.0"
+		"stripe": "^22.3.0",
+		"zod": "^4.4.3"
 	},
 	"devDependencies": {
-		"@ingram-tech/nk-dev": "workspace:*",
-		"@types/node": "^25.0.0",
+		"@ingram-tech/nk-dev": "0.2.4",
+		"@types/node": "^26.0.1",
 		"typescript": "^6.0.3",
-		"vitest": "^4.1.6"
+		"vitest": "^4.1.9"
 	}
 }