@usebillow/sdk 0.5.0

package/dist/billing-status-BZQN_gm7.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Charge / invoice / refund / payment-method / webhook-delivery status vocabularies,
+ * mirrored for the SDK (which cannot import the server-side `@billow/core`). The DB-enum
+ * ones (charge, invoice, refund, payment method) mirror core enums and are parity-tested
+ * against it (see billing-status.test.ts); webhook-delivery status is a free-text column
+ * server-side with a fixed vocabulary, documented here.
+ */
+/** A charge's lifecycle status — mirrors `@billow/core` `CHARGE_STATUSES`. */
+declare const CHARGE_STATUSES: readonly ["pending", "processing", "succeeded", "failed", "requires_reconciliation", "disputed"];
+type ChargeStatus = (typeof CHARGE_STATUSES)[number];
+/** An invoice's lifecycle status — mirrors `@billow/core` `INVOICE_STATUSES`. */
+declare const INVOICE_STATUSES: readonly ["draft", "open", "paid", "uncollectible", "void"];
+type InvoiceStatus = (typeof INVOICE_STATUSES)[number];
+/** A refund's lifecycle status — mirrors `@billow/core` `REFUND_STATUSES`. */
+declare const REFUND_STATUSES: readonly ["pending", "succeeded", "failed"];
+type RefundStatus = (typeof REFUND_STATUSES)[number];
+/** A saved payment method's status — mirrors `@billow/core` `PAYMENT_METHOD_STATUSES`. */
+declare const PAYMENT_METHOD_STATUSES: readonly ["active", "expired", "removed"];
+type PaymentMethodStatus = (typeof PAYMENT_METHOD_STATUSES)[number];
+/**
+ * A webhook delivery attempt's status. Not a DB enum (a free-text column); the dispatcher
+ * inserts one row per attempt with exactly `delivered` (a 2xx) or `failed` (anything else) —
+ * see `packages/server/src/jobs/outbox.ts`. (Retry/backoff state lives on the outbox event,
+ * a separate table, not on the delivery record.)
+ */
+declare const WEBHOOK_DELIVERY_STATUSES: readonly ["delivered", "failed"];
+type WebhookDeliveryStatus = (typeof WEBHOOK_DELIVERY_STATUSES)[number];
+
+export { type ChargeStatus as C, type InvoiceStatus as I, type PaymentMethodStatus as P, type RefundStatus as R, type WebhookDeliveryStatus as W, CHARGE_STATUSES as a, INVOICE_STATUSES as b, PAYMENT_METHOD_STATUSES as c, REFUND_STATUSES as d, WEBHOOK_DELIVERY_STATUSES as e };

package/dist/billing-status-BZQN_gm7.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Charge / invoice / refund / payment-method / webhook-delivery status vocabularies,
+ * mirrored for the SDK (which cannot import the server-side `@billow/core`). The DB-enum
+ * ones (charge, invoice, refund, payment method) mirror core enums and are parity-tested
+ * against it (see billing-status.test.ts); webhook-delivery status is a free-text column
+ * server-side with a fixed vocabulary, documented here.
+ */
+/** A charge's lifecycle status — mirrors `@billow/core` `CHARGE_STATUSES`. */
+declare const CHARGE_STATUSES: readonly ["pending", "processing", "succeeded", "failed", "requires_reconciliation", "disputed"];
+type ChargeStatus = (typeof CHARGE_STATUSES)[number];
+/** An invoice's lifecycle status — mirrors `@billow/core` `INVOICE_STATUSES`. */
+declare const INVOICE_STATUSES: readonly ["draft", "open", "paid", "uncollectible", "void"];
+type InvoiceStatus = (typeof INVOICE_STATUSES)[number];
+/** A refund's lifecycle status — mirrors `@billow/core` `REFUND_STATUSES`. */
+declare const REFUND_STATUSES: readonly ["pending", "succeeded", "failed"];
+type RefundStatus = (typeof REFUND_STATUSES)[number];
+/** A saved payment method's status — mirrors `@billow/core` `PAYMENT_METHOD_STATUSES`. */
+declare const PAYMENT_METHOD_STATUSES: readonly ["active", "expired", "removed"];
+type PaymentMethodStatus = (typeof PAYMENT_METHOD_STATUSES)[number];
+/**
+ * A webhook delivery attempt's status. Not a DB enum (a free-text column); the dispatcher
+ * inserts one row per attempt with exactly `delivered` (a 2xx) or `failed` (anything else) —
+ * see `packages/server/src/jobs/outbox.ts`. (Retry/backoff state lives on the outbox event,
+ * a separate table, not on the delivery record.)
+ */
+declare const WEBHOOK_DELIVERY_STATUSES: readonly ["delivered", "failed"];
+type WebhookDeliveryStatus = (typeof WEBHOOK_DELIVERY_STATUSES)[number];
+
+export { type ChargeStatus as C, type InvoiceStatus as I, type PaymentMethodStatus as P, type RefundStatus as R, type WebhookDeliveryStatus as W, CHARGE_STATUSES as a, INVOICE_STATUSES as b, PAYMENT_METHOD_STATUSES as c, REFUND_STATUSES as d, WEBHOOK_DELIVERY_STATUSES as e };

package/dist/chunk-CCG4F5FK.js

@@ -0,0 +1,48 @@
+// src/billing-status.ts
+var CHARGE_STATUSES = [
+  "pending",
+  "processing",
+  "succeeded",
+  "failed",
+  "requires_reconciliation",
+  "disputed"
+];
+var INVOICE_STATUSES = ["draft", "open", "paid", "uncollectible", "void"];
+var REFUND_STATUSES = ["pending", "succeeded", "failed"];
+var PAYMENT_METHOD_STATUSES = ["active", "expired", "removed"];
+var WEBHOOK_DELIVERY_STATUSES = ["delivered", "failed"];
+
+// src/subscription-status.ts
+var SUBSCRIPTION_STATUSES = [
+  "incomplete",
+  "incomplete_expired",
+  "trialing",
+  "active",
+  "past_due",
+  "paused",
+  "canceled",
+  "unpaid"
+];
+var ACTIVE_SUBSCRIPTION_STATUSES = [
+  "trialing",
+  "active",
+  "past_due"
+];
+var TERMINAL_SUBSCRIPTION_STATUSES = [
+  "incomplete_expired",
+  "canceled"
+];
+var NEVER_ACTIVATED_SUBSCRIPTION_STATUSES = [
+  "incomplete",
+  "incomplete_expired"
+];
+function grantsAccess(status) {
+  return ACTIVE_SUBSCRIPTION_STATUSES.includes(status);
+}
+function isTerminal(status) {
+  return TERMINAL_SUBSCRIPTION_STATUSES.includes(status);
+}
+
+export { ACTIVE_SUBSCRIPTION_STATUSES, CHARGE_STATUSES, INVOICE_STATUSES, NEVER_ACTIVATED_SUBSCRIPTION_STATUSES, PAYMENT_METHOD_STATUSES, REFUND_STATUSES, SUBSCRIPTION_STATUSES, TERMINAL_SUBSCRIPTION_STATUSES, WEBHOOK_DELIVERY_STATUSES, grantsAccess, isTerminal };
+//# sourceMappingURL=chunk-CCG4F5FK.js.map
+//# sourceMappingURL=chunk-CCG4F5FK.js.map

package/dist/chunk-CCG4F5FK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/billing-status.ts","../src/subscription-status.ts"],"names":[],"mappings":";AASO,IAAM,eAAA,GAAkB;AAAA,EAC7B,SAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,QAAA;AAAA,EACA,yBAAA;AAAA,EACA;AACF;AAIO,IAAM,mBAAmB,CAAC,OAAA,EAAS,MAAA,EAAQ,MAAA,EAAQ,iBAAiB,MAAM;AAI1E,IAAM,eAAA,GAAkB,CAAC,SAAA,EAAW,WAAA,EAAa,QAAQ;AAIzD,IAAM,uBAAA,GAA0B,CAAC,QAAA,EAAU,SAAA,EAAW,SAAS;AAS/D,IAAM,yBAAA,GAA4B,CAAC,WAAA,EAAa,QAAQ;;;ACxBxD,IAAM,qBAAA,GAAwB;AAAA,EACnC,YAAA;AAAA,EACA,oBAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAQO,IAAM,4BAAA,GAA8D;AAAA,EACzE,UAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;AAGO,IAAM,8BAAA,GAAgE;AAAA,EAC3E,oBAAA;AAAA,EACA;AACF;AAGO,IAAM,qCAAA,GAAuE;AAAA,EAClF,YAAA;AAAA,EACA;AACF;AAGO,SAAS,aAAa,MAAA,EAAqC;AAChE,EAAA,OAAO,4BAAA,CAA6B,SAAS,MAAM,CAAA;AACrD;AAGO,SAAS,WAAW,MAAA,EAAqC;AAC9D,EAAA,OAAO,8BAAA,CAA+B,SAAS,MAAM,CAAA;AACvD","file":"chunk-CCG4F5FK.js","sourcesContent":["/**\n * Charge / invoice / refund / payment-method / webhook-delivery status vocabularies,\n * mirrored for the SDK (which cannot import the server-side `@billow/core`). The DB-enum\n * ones (charge, invoice, refund, payment method) mirror core enums and are parity-tested\n * against it (see billing-status.test.ts); webhook-delivery status is a free-text column\n * server-side with a fixed vocabulary, documented here.\n */\n\n/** A charge's lifecycle status — mirrors `@billow/core` `CHARGE_STATUSES`. */\nexport const CHARGE_STATUSES = [\n  \"pending\",\n  \"processing\",\n  \"succeeded\",\n  \"failed\",\n  \"requires_reconciliation\",\n  \"disputed\",\n] as const;\nexport type ChargeStatus = (typeof CHARGE_STATUSES)[number];\n\n/** An invoice's lifecycle status — mirrors `@billow/core` `INVOICE_STATUSES`. */\nexport const INVOICE_STATUSES = [\"draft\", \"open\", \"paid\", \"uncollectible\", \"void\"] as const;\nexport type InvoiceStatus = (typeof INVOICE_STATUSES)[number];\n\n/** A refund's lifecycle status — mirrors `@billow/core` `REFUND_STATUSES`. */\nexport const REFUND_STATUSES = [\"pending\", \"succeeded\", \"failed\"] as const;\nexport type RefundStatus = (typeof REFUND_STATUSES)[number];\n\n/** A saved payment method's status — mirrors `@billow/core` `PAYMENT_METHOD_STATUSES`. */\nexport const PAYMENT_METHOD_STATUSES = [\"active\", \"expired\", \"removed\"] as const;\nexport type PaymentMethodStatus = (typeof PAYMENT_METHOD_STATUSES)[number];\n\n/**\n * A webhook delivery attempt's status. Not a DB enum (a free-text column); the dispatcher\n * inserts one row per attempt with exactly `delivered` (a 2xx) or `failed` (anything else) —\n * see `packages/server/src/jobs/outbox.ts`. (Retry/backoff state lives on the outbox event,\n * a separate table, not on the delivery record.)\n */\nexport const WEBHOOK_DELIVERY_STATUSES = [\"delivered\", \"failed\"] as const;\nexport type WebhookDeliveryStatus = (typeof WEBHOOK_DELIVERY_STATUSES)[number];\n","/**\n * The subscription status vocabulary + access predicate, mirrored from @billow/core\n * (`enums.ts` + `billing/subscription-state.ts`) so SDK consumers can type and branch on\n * billow's own model instead of hand-maintaining a union that drifts (a real bug: an app\n * copy once carried a non-existent `ended` status - that string is a webhook event type,\n * not a subscription status).\n *\n * Mirrored, not imported: @billow/core is a server package the published SDK cannot depend\n * on (the same reason @billow/contracts mirrors core's pure logic). The parity test\n * `subscription-status.test.ts` imports @billow/core and fails CI on any drift.\n */\n\n/** The 8 canonical subscription statuses, in lifecycle order. */\nexport const SUBSCRIPTION_STATUSES = [\n  \"incomplete\",\n  \"incomplete_expired\",\n  \"trialing\",\n  \"active\",\n  \"past_due\",\n  \"paused\",\n  \"canceled\",\n  \"unpaid\",\n] as const;\n\nexport type SubscriptionStatus = (typeof SUBSCRIPTION_STATUSES)[number];\n\n/**\n * Statuses that currently grant access (a live commitment): `trialing`, `active`, and\n * `past_due` (access is retained through dunning). Note `paused` does NOT grant access.\n */\nexport const ACTIVE_SUBSCRIPTION_STATUSES: readonly SubscriptionStatus[] = [\n  \"trialing\",\n  \"active\",\n  \"past_due\",\n];\n\n/** Statuses a subscription can never leave: `incomplete_expired` and `canceled`. */\nexport const TERMINAL_SUBSCRIPTION_STATUSES: readonly SubscriptionStatus[] = [\n  \"incomplete_expired\",\n  \"canceled\",\n];\n\n/** Statuses in which a subscription never activated (no access was ever granted). */\nexport const NEVER_ACTIVATED_SUBSCRIPTION_STATUSES: readonly SubscriptionStatus[] = [\n  \"incomplete\",\n  \"incomplete_expired\",\n];\n\n/** Whether access should currently be granted for a subscription in this state. */\nexport function grantsAccess(status: SubscriptionStatus): boolean {\n  return ACTIVE_SUBSCRIPTION_STATUSES.includes(status);\n}\n\n/** Whether this is a terminal status the subscription can never leave. */\nexport function isTerminal(status: SubscriptionStatus): boolean {\n  return TERMINAL_SUBSCRIPTION_STATUSES.includes(status);\n}\n"]}