@absolutejs/billing 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -6,6 +6,12 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.9.0 — 2026-09-11
+
+### Added
+
+- **Add bounded customer billing reports, receipt cursors and reconciled usage projections**
+
 ## 0.8.0 — 2026-09-11
 
 ### Added

package/README.md

@@ -102,3 +102,5 @@ BSL-1.1 with named carveout against hosted SaaS billing platforms
 ## Secure credit checkout
 
 [Purchase-only handoffs](docs/checkout-handoffs.md) provide expiring, single-use browser capabilities without a full login session.
+
+`@absolutejs/billing/reports` provides customer-facing status, receipt pagination, and usage contracts. `parseUsageRange` uses a half-open UTC date interval of at most 90 days (default: the last 30 days including today). Receipt cursors are positions, never authorization: bind every query, reversal join, and cursor to the caller's account. Readers must project through the public helpers, which omit provider costs, payment tokens and vault references. Usage day and feature totals must reconcile exactly; purchased dollars and consumed service credits are different measures. Automatic refill is currently unsupported.

package/changelog.json

@@ -2,6 +2,16 @@
   "contract": 1,
   "name": "@absolutejs/billing",
   "releases": [
+    {
+      "version": "0.9.0",
+      "date": "2026-09-11",
+      "changes": [
+        {
+          "kind": "added",
+          "summary": "Add bounded customer billing reports, receipt cursors and reconciled usage projections"
+        }
+      ]
+    },
     {
       "version": "0.8.0",
       "date": "2026-09-11",

package/dist/reports.d.ts

@@ -0,0 +1,65 @@
+/** Public customer reports. No payment tokens, vault references, or provider costs. */
+export type BillingStatus = {
+    portalAccess: boolean;
+    subscription: {
+        status: string;
+        renewsAt: string | null;
+        cancelAtPeriodEnd: boolean;
+    } | null;
+    credits: {
+        remaining: number;
+        reserved: number;
+        purchased: number;
+        promotional: number;
+        debt: number;
+    };
+    automaticRefill: false;
+};
+export type BillingReceipt = {
+    id: string;
+    issuedAt: string;
+    currency: string;
+    amountCents: number;
+    refundedAmountCents: number;
+    source: "credit_purchase" | "initial" | "plan_change" | "renewal";
+    status: "paid" | "partially_refunded" | "refunded";
+};
+export type ReceiptCursor = {
+    at: string;
+    id: string;
+};
+export type ReceiptPageRequest = {
+    limit: number;
+    cursor: ReceiptCursor | null;
+};
+export type ReceiptPage = {
+    receipts: BillingReceipt[];
+    nextCursor: string | null;
+};
+export type UsageRange = {
+    from: string;
+    to: string;
+};
+export type CustomerUsageReport = {
+    from: string;
+    to: string;
+    creditsConsumed: number;
+    events: number;
+    byDay: {
+        day: string;
+        credits: number;
+        events: number;
+    }[];
+    byFeature: {
+        feature: string;
+        credits: number;
+        events: number;
+    }[];
+};
+export declare const parseUsageRange: (input: unknown, now?: Date) => UsageRange;
+/** Cursor is a position, never authorization. Consumers must filter by account. */
+export declare const encodeReceiptCursor: (cursor: ReceiptCursor) => string;
+export declare const parseReceiptPage: (input: unknown) => ReceiptPageRequest;
+export declare const projectBillingStatus: (value: BillingStatus) => BillingStatus;
+export declare const projectReceiptPage: (value: ReceiptPage, limit: number) => ReceiptPage;
+export declare const projectUsageReport: (value: CustomerUsageReport, range: UsageRange) => CustomerUsageReport;

package/dist/reports.js

@@ -0,0 +1,146 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/reports.ts
+var DAY_MS = 86400000;
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var only = (input, keys) => {
+  if (!record(input) || Object.keys(input).some((key) => !keys.includes(key)))
+    throw new Error("Invalid report input");
+  return input;
+};
+var integer = (value) => {
+  if (!Number.isSafeInteger(value) || value < 0)
+    throw new Error("Invalid report amount");
+  return value;
+};
+var iso = (value) => {
+  if (!Number.isFinite(Date.parse(value)) || new Date(value).toISOString() !== value)
+    throw new Error("Invalid report timestamp");
+  return value;
+};
+var day = (value) => {
+  if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value) || new Date(value + "T00:00:00.000Z").toISOString().slice(0, 10) !== value)
+    throw new Error("Expected a UTC calendar date");
+  return value;
+};
+var parseUsageRange = (input, now = new Date) => {
+  const args = only(input, ["from", "to"]);
+  const tomorrow = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()) + DAY_MS);
+  const to = day(args.to ?? tomorrow.toISOString().slice(0, 10));
+  const from = day(args.from ?? new Date(Date.parse(to) - 30 * DAY_MS).toISOString().slice(0, 10));
+  const duration = Date.parse(to) - Date.parse(from);
+  if (duration <= 0 || duration > 90 * DAY_MS || Date.parse(to) > tomorrow.getTime())
+    throw new Error("Choose a range of 1\u201390 UTC days, ending no later than tomorrow");
+  return { from, to };
+};
+var encodeReceiptCursor = (cursor) => {
+  if (!UUID.test(cursor.id))
+    throw new Error("Invalid receipt cursor");
+  return Buffer.from(JSON.stringify({ at: iso(cursor.at), id: cursor.id })).toString("base64url");
+};
+var parseReceiptPage = (input) => {
+  const args = only(input, ["limit", "cursor"]);
+  const limit = args.limit ?? 20;
+  if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > 50)
+    throw new Error("Receipt limit must be 1\u201350");
+  if (args.cursor === undefined || args.cursor === null)
+    return { limit, cursor: null };
+  if (typeof args.cursor !== "string" || args.cursor.length > 256 || !/^[A-Za-z0-9_-]+$/.test(args.cursor))
+    throw new Error("Invalid receipt cursor");
+  const decoded = JSON.parse(Buffer.from(args.cursor, "base64url").toString("utf8"));
+  if (!record(decoded) || typeof decoded.at !== "string" || typeof decoded.id !== "string" || !UUID.test(decoded.id))
+    throw new Error("Invalid receipt cursor");
+  return { limit, cursor: { at: iso(decoded.at), id: decoded.id } };
+};
+var projectBillingStatus = (value) => ({
+  portalAccess: value.portalAccess === true,
+  subscription: value.subscription ? {
+    status: String(value.subscription.status).slice(0, 64),
+    renewsAt: value.subscription.renewsAt === null ? null : iso(value.subscription.renewsAt),
+    cancelAtPeriodEnd: value.subscription.cancelAtPeriodEnd === true
+  } : null,
+  credits: {
+    remaining: integer(value.credits.remaining),
+    reserved: integer(value.credits.reserved),
+    purchased: integer(value.credits.purchased),
+    promotional: integer(value.credits.promotional),
+    debt: integer(value.credits.debt)
+  },
+  automaticRefill: false
+});
+var projectReceiptPage = (value, limit) => {
+  if (value.receipts.length > limit)
+    throw new Error("Receipt page exceeds its limit");
+  if (value.nextCursor !== null)
+    parseReceiptPage({ cursor: value.nextCursor });
+  return {
+    receipts: value.receipts.map((row) => {
+      if (!UUID.test(row.id) || !/^[A-Z]{3}$/.test(row.currency) || !["credit_purchase", "initial", "plan_change", "renewal"].includes(row.source) || !["paid", "partially_refunded", "refunded"].includes(row.status) || row.refundedAmountCents > row.amountCents)
+        throw new Error("Invalid receipt");
+      return {
+        id: row.id,
+        issuedAt: iso(row.issuedAt),
+        currency: row.currency,
+        amountCents: integer(row.amountCents),
+        refundedAmountCents: integer(row.refundedAmountCents),
+        source: row.source,
+        status: row.status
+      };
+    }),
+    nextCursor: value.nextCursor
+  };
+};
+var projectUsageReport = (value, range) => {
+  if (value.from !== range.from || value.to !== range.to || value.byDay.length > 90 || value.byFeature.length > 21)
+    throw new Error("Invalid usage report bounds");
+  const byDay = value.byDay.map((row) => ({
+    day: day(row.day),
+    credits: integer(row.credits),
+    events: integer(row.events)
+  }));
+  const byFeature = value.byFeature.map((row) => ({
+    feature: row.feature.slice(0, 128),
+    credits: integer(row.credits),
+    events: integer(row.events)
+  }));
+  const credits = integer(value.creditsConsumed), events = integer(value.events);
+  for (const rows of [byDay, byFeature])
+    if (rows.reduce((sum, row) => sum + row.credits, 0) !== credits || rows.reduce((sum, row) => sum + row.events, 0) !== events)
+      throw new Error("Usage breakdown does not reconcile");
+  if (new Set(byDay.map((row) => row.day)).size !== byDay.length || byDay.some((row) => row.day < range.from || row.day >= range.to))
+    throw new Error("Invalid usage days");
+  return {
+    from: range.from,
+    to: range.to,
+    creditsConsumed: credits,
+    events,
+    byDay,
+    byFeature
+  };
+};
+export {
+  encodeReceiptCursor,
+  parseReceiptPage,
+  parseUsageRange,
+  projectBillingStatus,
+  projectReceiptPage,
+  projectUsageReport
+};
+
+//# debugId=1CCF8D983CF6711964756E2164756E21
+//# sourceMappingURL=reports.js.map

package/dist/reports.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/reports.ts"],
+  "sourcesContent": [
+    "/** Public customer reports. No payment tokens, vault references, or provider costs. */\nexport type BillingStatus = {\n  portalAccess: boolean;\n  subscription: {\n    status: string;\n    renewsAt: string | null;\n    cancelAtPeriodEnd: boolean;\n  } | null;\n  credits: {\n    remaining: number;\n    reserved: number;\n    purchased: number;\n    promotional: number;\n    debt: number;\n  };\n  automaticRefill: false;\n};\nexport type BillingReceipt = {\n  id: string;\n  issuedAt: string;\n  currency: string;\n  amountCents: number;\n  refundedAmountCents: number;\n  source: \"credit_purchase\" | \"initial\" | \"plan_change\" | \"renewal\";\n  status: \"paid\" | \"partially_refunded\" | \"refunded\";\n};\nexport type ReceiptCursor = { at: string; id: string };\nexport type ReceiptPageRequest = {\n  limit: number;\n  cursor: ReceiptCursor | null;\n};\nexport type ReceiptPage = {\n  receipts: BillingReceipt[];\n  nextCursor: string | null;\n};\nexport type UsageRange = { from: string; to: string };\nexport type CustomerUsageReport = {\n  from: string;\n  to: string;\n  creditsConsumed: number;\n  events: number;\n  byDay: { day: string; credits: number; events: number }[];\n  byFeature: { feature: string; credits: number; events: number }[];\n};\nconst DAY_MS = 86_400_000;\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\nconst record = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst only = (input: unknown, keys: readonly string[]) => {\n  if (!record(input) || Object.keys(input).some((key) => !keys.includes(key)))\n    throw new Error(\"Invalid report input\");\n  return input;\n};\nconst integer = (value: number) => {\n  if (!Number.isSafeInteger(value) || value < 0)\n    throw new Error(\"Invalid report amount\");\n  return value;\n};\nconst iso = (value: string) => {\n  if (\n    !Number.isFinite(Date.parse(value)) ||\n    new Date(value).toISOString() !== value\n  )\n    throw new Error(\"Invalid report timestamp\");\n  return value;\n};\nconst day = (value: unknown) => {\n  if (\n    typeof value !== \"string\" ||\n    !/^\\d{4}-\\d{2}-\\d{2}$/.test(value) ||\n    new Date(value + \"T00:00:00.000Z\").toISOString().slice(0, 10) !== value\n  )\n    throw new Error(\"Expected a UTC calendar date\");\n  return value;\n};\nexport const parseUsageRange = (\n  input: unknown,\n  now = new Date(),\n): UsageRange => {\n  const args = only(input, [\"from\", \"to\"]);\n  const tomorrow = new Date(\n    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()) +\n      DAY_MS,\n  );\n  const to = day(args.to ?? tomorrow.toISOString().slice(0, 10));\n  const from = day(\n    args.from ??\n      new Date(Date.parse(to) - 30 * DAY_MS).toISOString().slice(0, 10),\n  );\n  const duration = Date.parse(to) - Date.parse(from);\n  if (\n    duration <= 0 ||\n    duration > 90 * DAY_MS ||\n    Date.parse(to) > tomorrow.getTime()\n  )\n    throw new Error(\n      \"Choose a range of 1–90 UTC days, ending no later than tomorrow\",\n    );\n  return { from, to };\n};\n/** Cursor is a position, never authorization. Consumers must filter by account. */\nexport const encodeReceiptCursor = (cursor: ReceiptCursor) => {\n  if (!UUID.test(cursor.id)) throw new Error(\"Invalid receipt cursor\");\n  return Buffer.from(\n    JSON.stringify({ at: iso(cursor.at), id: cursor.id }),\n  ).toString(\"base64url\");\n};\nexport const parseReceiptPage = (input: unknown): ReceiptPageRequest => {\n  const args = only(input, [\"limit\", \"cursor\"]);\n  const limit = args.limit ?? 20;\n  if (\n    typeof limit !== \"number\" ||\n    !Number.isInteger(limit) ||\n    limit < 1 ||\n    limit > 50\n  )\n    throw new Error(\"Receipt limit must be 1–50\");\n  if (args.cursor === undefined || args.cursor === null)\n    return { limit, cursor: null };\n  if (\n    typeof args.cursor !== \"string\" ||\n    args.cursor.length > 256 ||\n    !/^[A-Za-z0-9_-]+$/.test(args.cursor)\n  )\n    throw new Error(\"Invalid receipt cursor\");\n  const decoded: unknown = JSON.parse(\n    Buffer.from(args.cursor, \"base64url\").toString(\"utf8\"),\n  );\n  if (\n    !record(decoded) ||\n    typeof decoded.at !== \"string\" ||\n    typeof decoded.id !== \"string\" ||\n    !UUID.test(decoded.id)\n  )\n    throw new Error(\"Invalid receipt cursor\");\n  return { limit, cursor: { at: iso(decoded.at), id: decoded.id } };\n};\nexport const projectBillingStatus = (value: BillingStatus): BillingStatus => ({\n  portalAccess: value.portalAccess === true,\n  subscription: value.subscription\n    ? {\n        status: String(value.subscription.status).slice(0, 64),\n        renewsAt:\n          value.subscription.renewsAt === null\n            ? null\n            : iso(value.subscription.renewsAt),\n        cancelAtPeriodEnd: value.subscription.cancelAtPeriodEnd === true,\n      }\n    : null,\n  credits: {\n    remaining: integer(value.credits.remaining),\n    reserved: integer(value.credits.reserved),\n    purchased: integer(value.credits.purchased),\n    promotional: integer(value.credits.promotional),\n    debt: integer(value.credits.debt),\n  },\n  automaticRefill: false,\n});\nexport const projectReceiptPage = (\n  value: ReceiptPage,\n  limit: number,\n): ReceiptPage => {\n  if (value.receipts.length > limit)\n    throw new Error(\"Receipt page exceeds its limit\");\n  if (value.nextCursor !== null) parseReceiptPage({ cursor: value.nextCursor });\n  return {\n    receipts: value.receipts.map((row) => {\n      if (\n        !UUID.test(row.id) ||\n        !/^[A-Z]{3}$/.test(row.currency) ||\n        ![\"credit_purchase\", \"initial\", \"plan_change\", \"renewal\"].includes(\n          row.source,\n        ) ||\n        ![\"paid\", \"partially_refunded\", \"refunded\"].includes(row.status) ||\n        row.refundedAmountCents > row.amountCents\n      )\n        throw new Error(\"Invalid receipt\");\n      return {\n        id: row.id,\n        issuedAt: iso(row.issuedAt),\n        currency: row.currency,\n        amountCents: integer(row.amountCents),\n        refundedAmountCents: integer(row.refundedAmountCents),\n        source: row.source,\n        status: row.status,\n      };\n    }),\n    nextCursor: value.nextCursor,\n  };\n};\nexport const projectUsageReport = (\n  value: CustomerUsageReport,\n  range: UsageRange,\n): CustomerUsageReport => {\n  if (\n    value.from !== range.from ||\n    value.to !== range.to ||\n    value.byDay.length > 90 ||\n    value.byFeature.length > 21\n  )\n    throw new Error(\"Invalid usage report bounds\");\n  const byDay = value.byDay.map((row) => ({\n    day: day(row.day),\n    credits: integer(row.credits),\n    events: integer(row.events),\n  }));\n  const byFeature = value.byFeature.map((row) => ({\n    feature: row.feature.slice(0, 128),\n    credits: integer(row.credits),\n    events: integer(row.events),\n  }));\n  const credits = integer(value.creditsConsumed),\n    events = integer(value.events);\n  for (const rows of [byDay, byFeature])\n    if (\n      rows.reduce((sum, row) => sum + row.credits, 0) !== credits ||\n      rows.reduce((sum, row) => sum + row.events, 0) !== events\n    )\n      throw new Error(\"Usage breakdown does not reconcile\");\n  if (\n    new Set(byDay.map((row) => row.day)).size !== byDay.length ||\n    byDay.some((row) => row.day < range.from || row.day >= range.to)\n  )\n    throw new Error(\"Invalid usage days\");\n  return {\n    from: range.from,\n    to: range.to,\n    creditsConsumed: credits,\n    events,\n    byDay,\n    byFeature,\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "1CCF8D983CF6711964756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/billing",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Provider-neutral pricing and invoice computation used by the hosted AbsoluteJS.ai platform. Converts metered usage into exact integer-micro line items with tiers and allowances.",
   "repository": {
     "type": "git",
@@ -52,6 +52,11 @@
       "types": "./dist/checkoutHandoff.d.ts",
       "import": "./dist/checkoutHandoff.js",
       "default": "./dist/checkoutHandoff.js"
+    },
+    "./reports": {
+      "types": "./dist/reports.d.ts",
+      "import": "./dist/reports.js",
+      "default": "./dist/reports.js"
     }
   },
   "publishConfig": {
@@ -66,7 +71,7 @@
     "docs/checkout-handoffs.md"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build src/index.ts src/ledger.ts src/prepaid.ts src/prepaidPostgres.ts src/creditWork.ts src/checkoutHandoff.ts src/manifest.ts --root ./src --outdir dist --sourcemap --target=bun && tsc --project tsconfig.build.json && absolute-manifest emit",
+    "build": "rm -rf dist && bun build src/index.ts src/ledger.ts src/prepaid.ts src/prepaidPostgres.ts src/creditWork.ts src/checkoutHandoff.ts src/reports.ts src/manifest.ts --root ./src --outdir dist --sourcemap --target=bun && tsc --project tsconfig.build.json && absolute-manifest emit",
     "test": "bun test tests/",
     "typecheck": "tsc --noEmit",
     "format": "prettier --write \"./**/*.{ts,json,md}\"",