@dainamite/billing 0.17.0

package/dist/modules/billing/migrations/Migration20260519000000_billing.js

@@ -0,0 +1,144 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260519000000_billing extends Migration {
+  async up() {
+    this.addSql(`create table "billing_accounts" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "customer_id" text not null,
+      "name" text not null,
+      "currency_code" text not null,
+      "bill_cycle" text not null,
+      "bill_cycle_anchor" text not null,
+      "invoice_email" text not null,
+      "invoice_language" text not null,
+      "tax_id" text null,
+      "invoice_address" jsonb not null,
+      "next_bill_date" date not null,
+      "last_bill_date" date null,
+      "is_active" boolean not null default true,
+      "created_at" timestamptz not null,
+      "updated_at" timestamptz not null,
+      "deleted_at" timestamptz null,
+      constraint "billing_accounts_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index "billing_accounts_next_bill_date_idx" on "billing_accounts" ("organization_id", "tenant_id", "next_bill_date") where "deleted_at" is null;`);
+    this.addSql(`create index "billing_accounts_customer_idx" on "billing_accounts" ("organization_id", "tenant_id", "customer_id");`);
+    this.addSql(`create index "billing_accounts_sort_idx" on "billing_accounts" ("organization_id", "tenant_id", "deleted_at", "created_at");`);
+    this.addSql(`create table "billing_items" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "bill_account_id" uuid not null,
+      "type" text not null,
+      "bill_start_date" date not null,
+      "bill_end_date" date null,
+      "description" text not null,
+      "rate_json" jsonb not null,
+      "uom_code" text null,
+      "subscription_id" text null,
+      "subscription_item_id" text null,
+      "source_ref" text null,
+      "currency_mismatch" boolean not null default false,
+      "billed_to_date" date null,
+      "is_active" boolean not null default true,
+      "created_at" timestamptz not null,
+      "updated_at" timestamptz not null,
+      "deleted_at" timestamptz null,
+      constraint "billing_items_pkey" primary key ("id")
+    );`);
+    this.addSql(`alter table "billing_items" add constraint "billing_items_source_ref_unique" unique ("tenant_id", "bill_account_id", "source_ref");`);
+    this.addSql(`create index "billing_items_account_type_idx" on "billing_items" ("bill_account_id", "type");`);
+    this.addSql(`create index "billing_items_account_active_idx" on "billing_items" ("bill_account_id", "type", "is_active") where "deleted_at" is null;`);
+    this.addSql(`create index "billing_items_subscription_idx" on "billing_items" ("organization_id", "tenant_id", "subscription_id");`);
+    this.addSql(`create table "billing_account_usage" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "bill_account_id" uuid not null,
+      "uom_code" text not null,
+      "quantity" numeric(18, 4) not null,
+      "period_start" timestamptz not null,
+      "period_end" timestamptz not null,
+      "line_description" text null,
+      "source_ref" text null,
+      "rated_in_bill_run_id" uuid null,
+      "is_active" boolean not null default true,
+      "created_at" timestamptz not null,
+      "updated_at" timestamptz not null,
+      "deleted_at" timestamptz null,
+      constraint "billing_account_usage_pkey" primary key ("id")
+    );`);
+    this.addSql(`alter table "billing_account_usage" add constraint "billing_account_usage_source_ref_unique" unique ("tenant_id", "bill_account_id", "source_ref");`);
+    this.addSql(`create index "billing_account_usage_rating_idx" on "billing_account_usage" ("bill_account_id", "uom_code", "rated_in_bill_run_id", "period_end");`);
+    this.addSql(`create table "billing_runs" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "triggered_by" text not null,
+      "parent_run_id" uuid null,
+      "dry_run" boolean not null default false,
+      "test_mode" boolean not null default false,
+      "catch_up" boolean not null default false,
+      "scoped_account_ids" jsonb null,
+      "as_of_date" date not null,
+      "started_at" timestamptz null,
+      "finished_at" timestamptz null,
+      "status" text not null,
+      "summary" jsonb null,
+      "is_active" boolean not null default true,
+      "created_at" timestamptz not null,
+      "updated_at" timestamptz not null,
+      "deleted_at" timestamptz null,
+      constraint "billing_runs_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index "billing_runs_tenant_status_idx" on "billing_runs" ("tenant_id", "status", "started_at");`);
+    this.addSql(`create index "billing_runs_parent_idx" on "billing_runs" ("parent_run_id");`);
+    this.addSql(`create table "billing_run_outcomes" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "bill_run_id" uuid not null,
+      "bill_account_id" uuid not null,
+      "status" text not null,
+      "error_message" text null,
+      "warnings" jsonb null,
+      "draft_invoice_id" uuid null,
+      "is_active" boolean not null default true,
+      "created_at" timestamptz not null,
+      "updated_at" timestamptz not null,
+      "deleted_at" timestamptz null,
+      constraint "billing_run_outcomes_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index "billing_run_outcomes_run_status_idx" on "billing_run_outcomes" ("bill_run_id", "status");`);
+    this.addSql(`create index "billing_run_outcomes_account_history_idx" on "billing_run_outcomes" ("organization_id", "tenant_id", "bill_account_id", "created_at");`);
+    this.addSql(`create table "billing_draft_invoice_edits" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "invoice_id" uuid not null,
+      "invoice_line_id" uuid null,
+      "user_id" uuid not null,
+      "action" text not null,
+      "before_json" jsonb null,
+      "after_json" jsonb null,
+      "created_at" timestamptz not null,
+      "deleted_at" timestamptz null,
+      constraint "billing_draft_invoice_edits_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index "billing_draft_invoice_edits_invoice_idx" on "billing_draft_invoice_edits" ("organization_id", "tenant_id", "invoice_id", "created_at");`);
+    this.addSql(`create index "billing_draft_invoice_edits_user_idx" on "billing_draft_invoice_edits" ("organization_id", "tenant_id", "user_id", "created_at");`);
+  }
+  async down() {
+    this.addSql(`drop table if exists "billing_draft_invoice_edits" cascade;`);
+    this.addSql(`drop table if exists "billing_run_outcomes" cascade;`);
+    this.addSql(`drop table if exists "billing_runs" cascade;`);
+    this.addSql(`drop table if exists "billing_account_usage" cascade;`);
+    this.addSql(`drop table if exists "billing_items" cascade;`);
+    this.addSql(`drop table if exists "billing_accounts" cascade;`);
+  }
+}
+export {
+  Migration20260519000000_billing
+};
+//# sourceMappingURL=Migration20260519000000_billing.js.map

package/dist/modules/billing/migrations/Migration20260519000000_billing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/migrations/Migration20260519000000_billing.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations'\n\n/**\n * Initial Billing module schema (XD-249 Phase 0).\n *\n * Frozen as hand-written. Why this is OK despite the \"no hand-written\n * migrations\" rule in AGENTS.md:\n *\n *   - At Phase 0 (May 2026) the standalone-app build of\n *     `@open-mercato/cli@0.6.0` did not auto-discover entities from\n *     `@dainamite/*` workspaces, so `yarn mercato db generate` produced\n *     an empty diff. The CLI patch shipped in this PR fixes the\n *     resolver going forward (see `packages/cpq/scripts/cli-resolver.patch.mjs`\n *     usage), but **regenerating THIS initial migration would mean\n *     wiping every existing billing_* table on every tenant** to let\n *     the CLI re-emit the same `create table` statements. That's\n *     never safe on a live system.\n *   - The 1:1 mapping against `packages/billing/src/modules/billing/data/entities.ts`\n *     has been validated against production-shape data (CPQ \u2192 billing\n *     end-to-end flow). Any subsequent schema change MUST go through\n *     `yarn mercato db generate` \u2014 the CLI now correctly walks\n *     workspace `@dainamite/*` packages, so future migration files\n *     in this folder will be generated, not hand-written.\n */\nexport class Migration20260519000000_billing extends Migration {\n  async up(): Promise<void> {\n    // \u2500\u2500\u2500 billing_accounts \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table \"billing_accounts\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"customer_id\" text not null,\n      \"name\" text not null,\n      \"currency_code\" text not null,\n      \"bill_cycle\" text not null,\n      \"bill_cycle_anchor\" text not null,\n      \"invoice_email\" text not null,\n      \"invoice_language\" text not null,\n      \"tax_id\" text null,\n      \"invoice_address\" jsonb not null,\n      \"next_bill_date\" date not null,\n      \"last_bill_date\" date null,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null,\n      \"updated_at\" timestamptz not null,\n      \"deleted_at\" timestamptz null,\n      constraint \"billing_accounts_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index \"billing_accounts_next_bill_date_idx\" on \"billing_accounts\" (\"organization_id\", \"tenant_id\", \"next_bill_date\") where \"deleted_at\" is null;`)\n    this.addSql(`create index \"billing_accounts_customer_idx\" on \"billing_accounts\" (\"organization_id\", \"tenant_id\", \"customer_id\");`)\n    this.addSql(`create index \"billing_accounts_sort_idx\" on \"billing_accounts\" (\"organization_id\", \"tenant_id\", \"deleted_at\", \"created_at\");`)\n\n    // \u2500\u2500\u2500 billing_items \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table \"billing_items\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"bill_account_id\" uuid not null,\n      \"type\" text not null,\n      \"bill_start_date\" date not null,\n      \"bill_end_date\" date null,\n      \"description\" text not null,\n      \"rate_json\" jsonb not null,\n      \"uom_code\" text null,\n      \"subscription_id\" text null,\n      \"subscription_item_id\" text null,\n      \"source_ref\" text null,\n      \"currency_mismatch\" boolean not null default false,\n      \"billed_to_date\" date null,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null,\n      \"updated_at\" timestamptz not null,\n      \"deleted_at\" timestamptz null,\n      constraint \"billing_items_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`alter table \"billing_items\" add constraint \"billing_items_source_ref_unique\" unique (\"tenant_id\", \"bill_account_id\", \"source_ref\");`)\n    this.addSql(`create index \"billing_items_account_type_idx\" on \"billing_items\" (\"bill_account_id\", \"type\");`)\n    this.addSql(`create index \"billing_items_account_active_idx\" on \"billing_items\" (\"bill_account_id\", \"type\", \"is_active\") where \"deleted_at\" is null;`)\n    this.addSql(`create index \"billing_items_subscription_idx\" on \"billing_items\" (\"organization_id\", \"tenant_id\", \"subscription_id\");`)\n\n    // \u2500\u2500\u2500 billing_account_usage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table \"billing_account_usage\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"bill_account_id\" uuid not null,\n      \"uom_code\" text not null,\n      \"quantity\" numeric(18, 4) not null,\n      \"period_start\" timestamptz not null,\n      \"period_end\" timestamptz not null,\n      \"line_description\" text null,\n      \"source_ref\" text null,\n      \"rated_in_bill_run_id\" uuid null,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null,\n      \"updated_at\" timestamptz not null,\n      \"deleted_at\" timestamptz null,\n      constraint \"billing_account_usage_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`alter table \"billing_account_usage\" add constraint \"billing_account_usage_source_ref_unique\" unique (\"tenant_id\", \"bill_account_id\", \"source_ref\");`)\n    this.addSql(`create index \"billing_account_usage_rating_idx\" on \"billing_account_usage\" (\"bill_account_id\", \"uom_code\", \"rated_in_bill_run_id\", \"period_end\");`)\n\n    // \u2500\u2500\u2500 billing_runs \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table \"billing_runs\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"triggered_by\" text not null,\n      \"parent_run_id\" uuid null,\n      \"dry_run\" boolean not null default false,\n      \"test_mode\" boolean not null default false,\n      \"catch_up\" boolean not null default false,\n      \"scoped_account_ids\" jsonb null,\n      \"as_of_date\" date not null,\n      \"started_at\" timestamptz null,\n      \"finished_at\" timestamptz null,\n      \"status\" text not null,\n      \"summary\" jsonb null,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null,\n      \"updated_at\" timestamptz not null,\n      \"deleted_at\" timestamptz null,\n      constraint \"billing_runs_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index \"billing_runs_tenant_status_idx\" on \"billing_runs\" (\"tenant_id\", \"status\", \"started_at\");`)\n    this.addSql(`create index \"billing_runs_parent_idx\" on \"billing_runs\" (\"parent_run_id\");`)\n\n    // \u2500\u2500\u2500 billing_run_outcomes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table \"billing_run_outcomes\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"bill_run_id\" uuid not null,\n      \"bill_account_id\" uuid not null,\n      \"status\" text not null,\n      \"error_message\" text null,\n      \"warnings\" jsonb null,\n      \"draft_invoice_id\" uuid null,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null,\n      \"updated_at\" timestamptz not null,\n      \"deleted_at\" timestamptz null,\n      constraint \"billing_run_outcomes_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index \"billing_run_outcomes_run_status_idx\" on \"billing_run_outcomes\" (\"bill_run_id\", \"status\");`)\n    this.addSql(`create index \"billing_run_outcomes_account_history_idx\" on \"billing_run_outcomes\" (\"organization_id\", \"tenant_id\", \"bill_account_id\", \"created_at\");`)\n\n    // \u2500\u2500\u2500 billing_draft_invoice_edits \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table \"billing_draft_invoice_edits\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"invoice_id\" uuid not null,\n      \"invoice_line_id\" uuid null,\n      \"user_id\" uuid not null,\n      \"action\" text not null,\n      \"before_json\" jsonb null,\n      \"after_json\" jsonb null,\n      \"created_at\" timestamptz not null,\n      \"deleted_at\" timestamptz null,\n      constraint \"billing_draft_invoice_edits_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index \"billing_draft_invoice_edits_invoice_idx\" on \"billing_draft_invoice_edits\" (\"organization_id\", \"tenant_id\", \"invoice_id\", \"created_at\");`)\n    this.addSql(`create index \"billing_draft_invoice_edits_user_idx\" on \"billing_draft_invoice_edits\" (\"organization_id\", \"tenant_id\", \"user_id\", \"created_at\");`)\n  }\n\n  async down(): Promise<void> {\n    this.addSql(`drop table if exists \"billing_draft_invoice_edits\" cascade;`)\n    this.addSql(`drop table if exists \"billing_run_outcomes\" cascade;`)\n    this.addSql(`drop table if exists \"billing_runs\" cascade;`)\n    this.addSql(`drop table if exists \"billing_account_usage\" cascade;`)\n    this.addSql(`drop table if exists \"billing_items\" cascade;`)\n    this.addSql(`drop table if exists \"billing_accounts\" cascade;`)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAwBnB,MAAM,wCAAwC,UAAU;AAAA,EAC7D,MAAM,KAAoB;AAExB,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAoBT;AACH,SAAK,OAAO,yJAAyJ;AACrK,SAAK,OAAO,qHAAqH;AACjI,SAAK,OAAO,8HAA8H;AAG1I,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAqBT;AACH,SAAK,OAAO,qIAAqI;AACjJ,SAAK,OAAO,+FAA+F;AAC3G,SAAK,OAAO,yIAAyI;AACrJ,SAAK,OAAO,uHAAuH;AAGnI,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAiBT;AACH,SAAK,OAAO,qJAAqJ;AACjK,SAAK,OAAO,mJAAmJ;AAG/J,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAoBT;AACH,SAAK,OAAO,wGAAwG;AACpH,SAAK,OAAO,6EAA6E;AAGzF,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAeT;AACH,SAAK,OAAO,yGAAyG;AACrH,SAAK,OAAO,sJAAsJ;AAGlK,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAaT;AACH,SAAK,OAAO,uJAAuJ;AACnK,SAAK,OAAO,iJAAiJ;AAAA,EAC/J;AAAA,EAEA,MAAM,OAAsB;AAC1B,SAAK,OAAO,6DAA6D;AACzE,SAAK,OAAO,sDAAsD;AAClE,SAAK,OAAO,8CAA8C;AAC1D,SAAK,OAAO,uDAAuD;AACnE,SAAK,OAAO,+CAA+C;AAC3D,SAAK,OAAO,kDAAkD;AAAA,EAChE;AACF;",
+  "names": []
+}

package/dist/modules/billing/setup.js

@@ -0,0 +1,190 @@
+import { features as billingAclFeatures } from "./acl.js";
+import {
+  Dictionary,
+  DictionaryEntry
+} from "@open-mercato/core/modules/dictionaries/data/entities";
+import { ModuleConfig } from "@open-mercato/core/modules/configs/data/entities";
+const BILLING_UOM_DICTIONARY_KEY = "billing.uom";
+const SALES_INVOICE_STATUS_DICTIONARY_KEY = "sales.invoice_status";
+const BILLING_UOM_CODES = [
+  // time
+  { value: "hour", label: "Hour" },
+  { value: "day", label: "Day" },
+  { value: "week", label: "Week" },
+  { value: "month", label: "Month" },
+  // volume
+  { value: "gb", label: "Gigabyte" },
+  { value: "tb", label: "Terabyte" },
+  { value: "mb", label: "Megabyte" },
+  // requests / tokens
+  { value: "request", label: "Request" },
+  { value: "api_request", label: "API Request" },
+  { value: "token", label: "Token" },
+  { value: "input_token", label: "Input Token" },
+  { value: "output_token", label: "Output Token" },
+  // seats / devices
+  { value: "seat", label: "Seat" },
+  { value: "user", label: "User" },
+  { value: "device", label: "Device" },
+  { value: "active_user", label: "Active User" }
+];
+const INVOICE_STATUS_ENTRIES = [
+  // `posted` is the canonical "issued" state and is also the default a
+  // freshly created invoice transitions to — but billing creates drafts,
+  // so `draft` is the default DictionaryEntry for new rows.
+  { value: "draft", label: "Draft", isDefault: true, color: "#9ca3af" },
+  { value: "posted", label: "Posted", isDefault: false, color: "#2563eb" },
+  { value: "paid", label: "Paid", isDefault: false, color: "#16a34a" },
+  { value: "void", label: "Void", isDefault: false, color: "#dc2626" }
+];
+async function ensureDictionary(em, scope, params) {
+  const existing = await em.findOne(Dictionary, {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    key: params.key,
+    deletedAt: null
+  });
+  if (existing) return existing;
+  const dictionary = em.create(Dictionary, {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    key: params.key,
+    name: params.name,
+    description: params.description,
+    isSystem: true,
+    isActive: true,
+    managerVisibility: "hidden",
+    createdAt: /* @__PURE__ */ new Date(),
+    updatedAt: /* @__PURE__ */ new Date()
+  });
+  em.persist(dictionary);
+  await em.flush();
+  return dictionary;
+}
+async function ensureDictionaryEntries(em, scope, dictionary, entries) {
+  const existing = await em.find(DictionaryEntry, {
+    dictionary,
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId
+  });
+  const existingValues = new Set(existing.map((e) => e.value));
+  let position = existing.length;
+  for (const entry of entries) {
+    if (existingValues.has(entry.value)) continue;
+    em.persist(
+      em.create(DictionaryEntry, {
+        dictionary,
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId,
+        value: entry.value,
+        normalizedValue: entry.value.trim().toLowerCase(),
+        label: entry.label,
+        color: entry.color ?? null,
+        position,
+        isDefault: entry.isDefault ?? false,
+        createdAt: /* @__PURE__ */ new Date(),
+        updatedAt: /* @__PURE__ */ new Date()
+      })
+    );
+    position += 1;
+  }
+  await em.flush();
+}
+async function seedBillingUomDictionary(em, scope) {
+  const dict = await ensureDictionary(em, scope, {
+    key: BILLING_UOM_DICTIONARY_KEY,
+    name: "Billing units of measure",
+    description: "Units billing accepts on usage records (exact match \u2014 no conversion)."
+  });
+  await ensureDictionaryEntries(em, scope, dict, BILLING_UOM_CODES);
+}
+async function seedInvoiceStatusDictionary(em, scope) {
+  const dict = await ensureDictionary(em, scope, {
+    key: SALES_INVOICE_STATUS_DICTIONARY_KEY,
+    name: "Sales invoice statuses",
+    description: "draft \u2192 posted \u2192 paid (or void). Drives the billing draft/post lifecycle."
+  });
+  await ensureDictionaryEntries(em, scope, dict, INVOICE_STATUS_ENTRIES);
+}
+async function ensureModuleConfig(em, params) {
+  const existing = await em.findOne(ModuleConfig, {
+    moduleId: params.moduleId,
+    name: params.name
+  });
+  if (existing) return;
+  em.persist(
+    em.create(ModuleConfig, {
+      moduleId: params.moduleId,
+      name: params.name,
+      valueJson: params.value,
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    })
+  );
+  await em.flush();
+}
+async function seedBillingConfigs(em) {
+  await ensureModuleConfig(em, {
+    moduleId: "billing",
+    name: "cron_schedule",
+    value: "0 2 * * *"
+  });
+  await ensureModuleConfig(em, {
+    moduleId: "billing",
+    name: "cron_enabled",
+    value: true
+  });
+  await ensureModuleConfig(em, {
+    moduleId: "billing",
+    name: "invoice_number.format",
+    value: "INV-{YYYY}-{0000001}"
+  });
+  await ensureModuleConfig(em, {
+    moduleId: "billing",
+    name: "invoice_number.reset_cycle",
+    value: "yearly"
+  });
+}
+const ALL_BILLING_FEATURES = billingAclFeatures.map((f) => f.id);
+const setup = {
+  defaultRoleFeatures: {
+    // Org admins get every billing feature — `billing.*` wildcard is matched
+    // by the shared feature matcher (`hasFeature` is wildcard-aware).
+    admin: ["billing.*"],
+    // Day-to-day finance operator persona.
+    billing_admin: [...ALL_BILLING_FEATURES],
+    // Read-only + dry-run preview — auditor / finance-watcher persona.
+    billing_finance_user: [
+      "billing.account.view",
+      "billing.item.view",
+      "billing.usage.view",
+      "billing.run.view",
+      "billing.run.dry_run",
+      "billing.invoice.view"
+    ],
+    // Narrow scope for external usage-ingestion API keys.
+    billing_usage_writer: ["billing.usage.ingest"]
+  },
+  /**
+   * Tenant init: per-tenant module configs (cron, invoice number defaults).
+   * Runs inside `setupInitialTenant()`, always — no `--no-examples` gate.
+   */
+  async onTenantCreated({ em }) {
+    await seedBillingConfigs(em);
+  },
+  /**
+   * Reference data: dictionaries (UoM, invoice statuses). Always runs
+   * during `mercato init`. Idempotent — re-seed is safe.
+   */
+  async seedDefaults({ em, tenantId, organizationId }) {
+    const scope = { tenantId, organizationId };
+    await seedBillingUomDictionary(em, scope);
+    await seedInvoiceStatusDictionary(em, scope);
+  }
+};
+var setup_default = setup;
+export {
+  setup_default as default,
+  setup
+};
+//# sourceMappingURL=setup.js.map

package/dist/modules/billing/setup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/billing/setup.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\nimport { features as billingAclFeatures } from './acl'\nimport {\n  Dictionary,\n  DictionaryEntry,\n} from '@open-mercato/core/modules/dictionaries/data/entities'\nimport { ModuleConfig } from '@open-mercato/core/modules/configs/data/entities'\n\n/**\n * Billing module setup \u2014 per-tenant defaults at module installation.\n *\n * Idempotency contract:\n *   - All seed helpers below check for an existing row before inserting.\n *   - Safe to re-run on every `mercato init` and on `auth sync-role-acls`.\n *\n * What this file seeds:\n *   - `billing.uom` dictionary with 16 global codes (operators can add more).\n *   - `sales.invoice_status` dictionary with `draft` / `posted` / `paid` /\n *     `void` so the core/sales Invoice entity's dictionary-driven status\n *     workflow has values to point at. (Core/sales does NOT seed these \u2014\n *     billing owns them per Phase 0 validation.)\n *   - `billing.cron_schedule` + `billing.cron_enabled` module configs.\n *   - `billing.invoice_number.format` + `.reset_cycle` configs (per-tenant\n *     defaults; the actual atomic numbering uses core/sales'\n *     `SalesDocumentSequence` which is created by core/sales' own\n *     `onTenantCreated`).\n *\n * Default role-feature grants:\n *   - `admin` gets every `billing.*` feature.\n *   - `billing_admin` is the day-to-day finance operator.\n *   - `billing_finance_user` is read + dry-run (no posting / no real trigger).\n *   - `billing_usage_writer` is the narrow scope for external system API keys.\n */\n\nconst BILLING_UOM_DICTIONARY_KEY = 'billing.uom'\nconst SALES_INVOICE_STATUS_DICTIONARY_KEY = 'sales.invoice_status'\n\nconst BILLING_UOM_CODES = [\n  // time\n  { value: 'hour', label: 'Hour' },\n  { value: 'day', label: 'Day' },\n  { value: 'week', label: 'Week' },\n  { value: 'month', label: 'Month' },\n  // volume\n  { value: 'gb', label: 'Gigabyte' },\n  { value: 'tb', label: 'Terabyte' },\n  { value: 'mb', label: 'Megabyte' },\n  // requests / tokens\n  { value: 'request', label: 'Request' },\n  { value: 'api_request', label: 'API Request' },\n  { value: 'token', label: 'Token' },\n  { value: 'input_token', label: 'Input Token' },\n  { value: 'output_token', label: 'Output Token' },\n  // seats / devices\n  { value: 'seat', label: 'Seat' },\n  { value: 'user', label: 'User' },\n  { value: 'device', label: 'Device' },\n  { value: 'active_user', label: 'Active User' },\n] as const\n\nconst INVOICE_STATUS_ENTRIES = [\n  // `posted` is the canonical \"issued\" state and is also the default a\n  // freshly created invoice transitions to \u2014 but billing creates drafts,\n  // so `draft` is the default DictionaryEntry for new rows.\n  { value: 'draft', label: 'Draft', isDefault: true, color: '#9ca3af' },\n  { value: 'posted', label: 'Posted', isDefault: false, color: '#2563eb' },\n  { value: 'paid', label: 'Paid', isDefault: false, color: '#16a34a' },\n  { value: 'void', label: 'Void', isDefault: false, color: '#dc2626' },\n] as const\n\ntype SeedScope = { tenantId: string; organizationId: string }\n\nasync function ensureDictionary(\n  em: EntityManager,\n  scope: SeedScope,\n  params: { key: string; name: string; description: string },\n): Promise<Dictionary> {\n  const existing = await em.findOne(Dictionary, {\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    key: params.key,\n    deletedAt: null,\n  })\n  if (existing) return existing\n  const dictionary = em.create(Dictionary, {\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    key: params.key,\n    name: params.name,\n    description: params.description,\n    isSystem: true,\n    isActive: true,\n    managerVisibility: 'hidden',\n    createdAt: new Date(),\n    updatedAt: new Date(),\n  })\n  em.persist(dictionary)\n  await em.flush()\n  return dictionary\n}\n\nasync function ensureDictionaryEntries(\n  em: EntityManager,\n  scope: SeedScope,\n  dictionary: Dictionary,\n  entries: ReadonlyArray<{\n    value: string\n    label: string\n    isDefault?: boolean\n    color?: string\n  }>,\n): Promise<void> {\n  const existing = await em.find(DictionaryEntry, {\n    dictionary,\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n  })\n  const existingValues = new Set(existing.map((e) => e.value))\n  let position = existing.length\n  for (const entry of entries) {\n    if (existingValues.has(entry.value)) continue\n    em.persist(\n      em.create(DictionaryEntry, {\n        dictionary,\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n        value: entry.value,\n        normalizedValue: entry.value.trim().toLowerCase(),\n        label: entry.label,\n        color: entry.color ?? null,\n        position,\n        isDefault: entry.isDefault ?? false,\n        createdAt: new Date(),\n        updatedAt: new Date(),\n      }),\n    )\n    position += 1\n  }\n  await em.flush()\n}\n\nasync function seedBillingUomDictionary(em: EntityManager, scope: SeedScope): Promise<void> {\n  const dict = await ensureDictionary(em, scope, {\n    key: BILLING_UOM_DICTIONARY_KEY,\n    name: 'Billing units of measure',\n    description: 'Units billing accepts on usage records (exact match \u2014 no conversion).',\n  })\n  await ensureDictionaryEntries(em, scope, dict, BILLING_UOM_CODES)\n}\n\nasync function seedInvoiceStatusDictionary(em: EntityManager, scope: SeedScope): Promise<void> {\n  const dict = await ensureDictionary(em, scope, {\n    key: SALES_INVOICE_STATUS_DICTIONARY_KEY,\n    name: 'Sales invoice statuses',\n    description: 'draft \u2192 posted \u2192 paid (or void). Drives the billing draft/post lifecycle.',\n  })\n  await ensureDictionaryEntries(em, scope, dict, INVOICE_STATUS_ENTRIES)\n}\n\nasync function ensureModuleConfig(\n  em: EntityManager,\n  params: { moduleId: string; name: string; value: unknown },\n): Promise<void> {\n  const existing = await em.findOne(ModuleConfig, {\n    moduleId: params.moduleId,\n    name: params.name,\n  })\n  if (existing) return\n  em.persist(\n    em.create(ModuleConfig, {\n      moduleId: params.moduleId,\n      name: params.name,\n      valueJson: params.value as Record<string, unknown> | null,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n    }),\n  )\n  await em.flush()\n}\n\nasync function seedBillingConfigs(em: EntityManager): Promise<void> {\n  await ensureModuleConfig(em, {\n    moduleId: 'billing',\n    name: 'cron_schedule',\n    value: '0 2 * * *',\n  })\n  await ensureModuleConfig(em, {\n    moduleId: 'billing',\n    name: 'cron_enabled',\n    value: true,\n  })\n  await ensureModuleConfig(em, {\n    moduleId: 'billing',\n    name: 'invoice_number.format',\n    value: 'INV-{YYYY}-{0000001}',\n  })\n  await ensureModuleConfig(em, {\n    moduleId: 'billing',\n    name: 'invoice_number.reset_cycle',\n    value: 'yearly',\n  })\n}\n\n// Derived from `acl.ts` so a new feature added there automatically lands\n// in every role that should get \"everything billing\" \u2014 no parallel list\n// to keep in sync.\nconst ALL_BILLING_FEATURES = billingAclFeatures.map((f) => f.id)\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    // Org admins get every billing feature \u2014 `billing.*` wildcard is matched\n    // by the shared feature matcher (`hasFeature` is wildcard-aware).\n    admin: ['billing.*'],\n\n    // Day-to-day finance operator persona.\n    billing_admin: [...ALL_BILLING_FEATURES],\n\n    // Read-only + dry-run preview \u2014 auditor / finance-watcher persona.\n    billing_finance_user: [\n      'billing.account.view',\n      'billing.item.view',\n      'billing.usage.view',\n      'billing.run.view',\n      'billing.run.dry_run',\n      'billing.invoice.view',\n    ],\n\n    // Narrow scope for external usage-ingestion API keys.\n    billing_usage_writer: ['billing.usage.ingest'],\n  },\n\n  /**\n   * Tenant init: per-tenant module configs (cron, invoice number defaults).\n   * Runs inside `setupInitialTenant()`, always \u2014 no `--no-examples` gate.\n   */\n  async onTenantCreated({ em }) {\n    await seedBillingConfigs(em)\n  },\n\n  /**\n   * Reference data: dictionaries (UoM, invoice statuses). Always runs\n   * during `mercato init`. Idempotent \u2014 re-seed is safe.\n   */\n  async seedDefaults({ em, tenantId, organizationId }) {\n    const scope = { tenantId, organizationId }\n    await seedBillingUomDictionary(em, scope)\n    await seedInvoiceStatusDictionary(em, scope)\n  },\n}\n\nexport default setup\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/billing/subscribers/payment-captured-to-paid.js

@@ -0,0 +1,47 @@
+import { createRequestContainer } from "@open-mercato/shared/lib/di/container";
+import { SalesInvoice } from "@open-mercato/core/modules/sales/data/entities";
+import { resolveInvoiceStatusEntryId } from "../lib/invoiceStatus.js";
+const metadata = {
+  event: "payment_gateways.payment.captured",
+  persistent: true,
+  id: "billing-payment-captured-to-paid"
+};
+async function handle(payload) {
+  if (!payload?.paymentId || !payload.tenantId || !payload.organizationId) {
+    return;
+  }
+  const container = await createRequestContainer();
+  const em = container.resolve("em").fork();
+  const invoice = await em.findOne(SalesInvoice, {
+    id: payload.paymentId,
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId,
+    deletedAt: null
+  });
+  if (!invoice) {
+    return;
+  }
+  if (invoice.status === "paid") {
+    return;
+  }
+  if (invoice.status !== "posted") {
+    return;
+  }
+  const paidStatusEntryId = await resolveInvoiceStatusEntryId(
+    em,
+    payload.tenantId,
+    payload.organizationId,
+    "paid"
+  );
+  invoice.status = "paid";
+  invoice.statusEntryId = paidStatusEntryId;
+  invoice.paidTotalAmount = invoice.grandTotalGrossAmount;
+  invoice.outstandingAmount = "0";
+  invoice.updatedAt = /* @__PURE__ */ new Date();
+  await em.flush();
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=payment-captured-to-paid.js.map

package/dist/modules/billing/subscribers/payment-captured-to-paid.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/subscribers/payment-captured-to-paid.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { SalesInvoice } from '@open-mercato/core/modules/sales/data/entities'\nimport { resolveInvoiceStatusEntryId } from '../lib/invoiceStatus'\n\n/**\n * Subscriber: payment captured \u2192 billing invoice paid.\n *\n * Spec wishlist was `payments.payment.completed` carrying `invoice_id`.\n * The actual upstream event is `payment_gateways.payment.captured` and\n * its payload carries `paymentId` \u2014 set by whoever created the payment\n * session. Billing flows that drive their own payment sessions can\n * pass `paymentId = invoice.id`; the subscriber matches on that.\n *\n * Behaviour:\n *   1. Try to find a `core/sales` invoice with `id = payload.paymentId`\n *      scoped to the same tenant/organization.\n *   2. If found AND its `status == 'posted'`, flip it to `'paid'`\n *      (resolves the `paid` `DictionaryEntry`, updates `status` +\n *      `status_entry_id`). Drafts and already-paid / voided invoices\n *      are left untouched.\n *   3. If `paymentId` does not point at a billing-known invoice (e.g.\n *      the payment was for a `sales.order`), the subscriber is a\n *      no-op \u2014 every other module's own subscriber owns its slice.\n *\n * Cross-tenant safety: we always re-scope by `tenantId` +\n * `organizationId` from the event payload. A malformed payload (e.g.\n * missing scope fields) short-circuits without touching the DB.\n *\n * Idempotency: re-firing the same captured event finds the invoice\n * already paid and skips silently.\n */\n\nexport const metadata = {\n  event: 'payment_gateways.payment.captured',\n  persistent: true,\n  id: 'billing-payment-captured-to-paid',\n}\n\ntype CapturedPayload = {\n  paymentId?: string\n  transactionId?: string\n  organizationId?: string\n  tenantId?: string\n  providerKey?: string\n}\n\nexport default async function handle(payload: CapturedPayload): Promise<void> {\n  if (!payload?.paymentId || !payload.tenantId || !payload.organizationId) {\n    return\n  }\n\n  const container = await createRequestContainer()\n  const em = (container.resolve('em') as EntityManager).fork()\n\n  const invoice = await em.findOne(SalesInvoice, {\n    id: payload.paymentId,\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n    deletedAt: null,\n  })\n  if (!invoice) {\n    // The captured payment isn't for a billing invoice \u2014 silent\n    // no-op. Other subscribers (sales, checkout) handle their slice.\n    return\n  }\n  if (invoice.status === 'paid') {\n    // Already paid \u2014 idempotent re-firing.\n    return\n  }\n  if (invoice.status !== 'posted') {\n    // A captured payment for a draft / void invoice is suspicious but\n    // not actionable here. Future iteration: log to audit_logs.\n    return\n  }\n\n  const paidStatusEntryId = await resolveInvoiceStatusEntryId(\n    em,\n    payload.tenantId,\n    payload.organizationId,\n    'paid',\n  )\n  invoice.status = 'paid'\n  invoice.statusEntryId = paidStatusEntryId\n  invoice.paidTotalAmount = invoice.grandTotalGrossAmount\n  invoice.outstandingAmount = '0'\n  invoice.updatedAt = new Date()\n  await em.flush()\n}\n"],
+  "mappings": "AACA,SAAS,8BAA8B;AACvC,SAAS,oBAAoB;AAC7B,SAAS,mCAAmC;AA8BrC,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAUA,eAAO,OAA8B,SAAyC;AAC5E,MAAI,CAAC,SAAS,aAAa,CAAC,QAAQ,YAAY,CAAC,QAAQ,gBAAgB;AACvE;AAAA,EACF;AAEA,QAAM,YAAY,MAAM,uBAAuB;AAC/C,QAAM,KAAM,UAAU,QAAQ,IAAI,EAAoB,KAAK;AAE3D,QAAM,UAAU,MAAM,GAAG,QAAQ,cAAc;AAAA,IAC7C,IAAI,QAAQ;AAAA,IACZ,UAAU,QAAQ;AAAA,IAClB,gBAAgB,QAAQ;AAAA,IACxB,WAAW;AAAA,EACb,CAAC;AACD,MAAI,CAAC,SAAS;AAGZ;AAAA,EACF;AACA,MAAI,QAAQ,WAAW,QAAQ;AAE7B;AAAA,EACF;AACA,MAAI,QAAQ,WAAW,UAAU;AAG/B;AAAA,EACF;AAEA,QAAM,oBAAoB,MAAM;AAAA,IAC9B;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR;AAAA,EACF;AACA,UAAQ,SAAS;AACjB,UAAQ,gBAAgB;AACxB,UAAQ,kBAAkB,QAAQ;AAClC,UAAQ,oBAAoB;AAC5B,UAAQ,YAAY,oBAAI,KAAK;AAC7B,QAAM,GAAG,MAAM;AACjB;",
+  "names": []
+}

package/dist/modules/billing/translations.js

@@ -0,0 +1,5 @@
+const translatableFields = {};
+export {
+  translatableFields
+};
+//# sourceMappingURL=translations.js.map

package/dist/modules/billing/translations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/billing/translations.ts"],
+  "sourcesContent": ["/**\n * Translatable fields for billing entities.\n *\n * Phase 0 keeps this empty \u2014 the Billing Account name and invoice line\n * descriptions are user-entered free text, not localizable templates.\n * If we ever ship localized invoice templates (Phase 4 admin UI), the\n * template label fields land here.\n */\nexport const translatableFields: Record<string, string[]> = {}\n"],
+  "mappings": "AAQO,MAAM,qBAA+C,CAAC;",
+  "names": []
+}

package/dist/modules/billing/workers/reap-stale-bill-runs.js

@@ -0,0 +1,31 @@
+import { BillRun } from "../data/entities.js";
+const metadata = {
+  queue: "billing-reap-stale-runs",
+  id: "billing:reap-stale-bill-runs",
+  concurrency: 1
+};
+const STALE_THRESHOLD_MS = 60 * 60 * 1e3;
+async function handle(_job, ctx) {
+  const em = ctx.resolve("em");
+  const threshold = new Date(Date.now() - STALE_THRESHOLD_MS);
+  const stale = await em.find(BillRun, {
+    status: "running",
+    startedAt: { $lt: threshold }
+  });
+  if (stale.length === 0) return;
+  const now = /* @__PURE__ */ new Date();
+  for (const run of stale) {
+    run.status = "failed";
+    run.finishedAt = now;
+    const summary = run.summary ?? {};
+    summary.reaper_message = "Stale running run reaped after crash; advisory lock released";
+    summary.reaped_at = now.toISOString();
+    run.summary = summary;
+  }
+  await em.flush();
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=reap-stale-bill-runs.js.map

package/dist/modules/billing/workers/reap-stale-bill-runs.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/billing/workers/reap-stale-bill-runs.ts"],
+  "sourcesContent": ["import type { JobContext, QueuedJob, WorkerMeta } from '@open-mercato/queue'\nimport type { FilterQuery } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { BillRun } from '../data/entities'\n\nexport const metadata: WorkerMeta = {\n  queue: 'billing-reap-stale-runs',\n  id: 'billing:reap-stale-bill-runs',\n  concurrency: 1,\n}\n\ntype HandlerContext = JobContext & {\n  resolve: <T = unknown>(name: string) => T\n}\n\n/**\n * Reaper for \"zombie\" Bill Runs left in `status='running'` after a crash.\n *\n * Background \u2014 the Bill Run engine acquires a per-tenant Postgres\n * transaction-scoped advisory lock (`pg_try_advisory_xact_lock`). When the\n * holding transaction ends (commit / rollback / process death) the lock is\n * released automatically \u2014 so there is no lock leak \u2014 but the `BillRun`\n * row's `status='running'` stays set forever, blocking restarts and\n * confusing the dashboard.\n *\n * Phase 0 ships this as the **registered worker shell** so the module's\n * worker auto-discovery includes it from day one. The active-advisory-lock\n * check (which is what distinguishes a real zombie from a healthy\n * long-running run) lands with the Bill Run engine itself in Phase 2.\n *\n * For now the heuristic is time-only: any `running` row older than 1 hour\n * is marked failed with an explanatory message. That is conservative \u2014\n * real runs almost never take an hour even for 500k-account tenants\n * (see spec Performance Considerations).\n */\nconst STALE_THRESHOLD_MS = 60 * 60 * 1000 // 1 hour\n\nexport default async function handle(_job: QueuedJob, ctx: HandlerContext): Promise<void> {\n  const em = ctx.resolve<EntityManager>('em')\n  const threshold = new Date(Date.now() - STALE_THRESHOLD_MS)\n  const stale = await em.find(BillRun, {\n    status: 'running',\n    startedAt: { $lt: threshold },\n  } satisfies FilterQuery<BillRun>)\n  if (stale.length === 0) return\n  const now = new Date()\n  for (const run of stale) {\n    run.status = 'failed'\n    run.finishedAt = now\n    const summary = (run.summary ?? {}) as Record<string, unknown>\n    summary.reaper_message =\n      'Stale running run reaped after crash; advisory lock released'\n    summary.reaped_at = now.toISOString()\n    run.summary = summary\n  }\n  await em.flush()\n}\n"],
+  "mappings": "AAGA,SAAS,eAAe;AAEjB,MAAM,WAAuB;AAAA,EAClC,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,aAAa;AACf;AA0BA,MAAM,qBAAqB,KAAK,KAAK;AAErC,eAAO,OAA8B,MAAiB,KAAoC;AACxF,QAAM,KAAK,IAAI,QAAuB,IAAI;AAC1C,QAAM,YAAY,IAAI,KAAK,KAAK,IAAI,IAAI,kBAAkB;AAC1D,QAAM,QAAQ,MAAM,GAAG,KAAK,SAAS;AAAA,IACnC,QAAQ;AAAA,IACR,WAAW,EAAE,KAAK,UAAU;AAAA,EAC9B,CAAgC;AAChC,MAAI,MAAM,WAAW,EAAG;AACxB,QAAM,MAAM,oBAAI,KAAK;AACrB,aAAW,OAAO,OAAO;AACvB,QAAI,SAAS;AACb,QAAI,aAAa;AACjB,UAAM,UAAW,IAAI,WAAW,CAAC;AACjC,YAAQ,iBACN;AACF,YAAQ,YAAY,IAAI,YAAY;AACpC,QAAI,UAAU;AAAA,EAChB;AACA,QAAM,GAAG,MAAM;AACjB;",
+  "names": []
+}