@adonis-agora/payments 0.2.0 → 0.3.0

package/dist/src/billing/mixins/with_payment.js

@@ -4,13 +4,24 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseModel, column } from '@adonisjs/lucid/orm';
+import { randomUUID } from 'node:crypto';
+import { BaseModel, beforeCreate, column } from '@adonisjs/lucid/orm';
 /**
  * The Lucid model backing the `billing_payments` table. Mirrors the gateway payment —
  * kept locally so webhook processing and the app can query payment history without
  * calling the gateway API.
  */
 export class BillingPayment extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row) {
+        if (!row.id)
+            row.id = randomUUID();
+    }
 }
 __decorate([
     column({ isPrimary: true })
@@ -25,7 +36,7 @@ __decorate([
     column()
 ], BillingPayment.prototype, "status", void 0);
 __decorate([
-    column()
+    column({ consume: (value) => (value === null ? null : Number(value)) })
 ], BillingPayment.prototype, "amount", void 0);
 __decorate([
     column()
@@ -36,6 +47,12 @@ __decorate([
 __decorate([
     column({ serializeAs: null })
 ], BillingPayment.prototype, "subscriptionId", void 0);
+__decorate([
+    column()
+], BillingPayment.prototype, "externalReference", void 0);
+__decorate([
+    column({ consume: (value) => (value === null ? null : Number(value)) })
+], BillingPayment.prototype, "refundedAmount", void 0);
 __decorate([
     column({ serializeAs: null })
 ], BillingPayment.prototype, "payload", void 0);
@@ -48,6 +65,9 @@ __decorate([
 __decorate([
     column.dateTime({ serializeAs: null })
 ], BillingPayment.prototype, "paidAt", void 0);
+__decorate([
+    beforeCreate()
+], BillingPayment, "assignUuid", null);
 /**
  * Mixin to attach payment columns to a custom model.
  */
@@ -65,7 +85,7 @@ export function withPayment() {
             column()
         ], PaymentMixin.prototype, "status", void 0);
         __decorate([
-            column()
+            column({ consume: (value) => (value === null ? null : Number(value)) })
         ], PaymentMixin.prototype, "amount", void 0);
         __decorate([
             column()
@@ -76,6 +96,12 @@ export function withPayment() {
         __decorate([
             column({ serializeAs: null })
         ], PaymentMixin.prototype, "subscriptionId", void 0);
+        __decorate([
+            column()
+        ], PaymentMixin.prototype, "externalReference", void 0);
+        __decorate([
+            column({ consume: (value) => (value === null ? null : Number(value)) })
+        ], PaymentMixin.prototype, "refundedAmount", void 0);
         __decorate([
             column({ serializeAs: null })
         ], PaymentMixin.prototype, "payload", void 0);

package/dist/src/billing/mixins/with_payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"with_payment.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_payment.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,SAAS;CAqC5C;AAnCS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;0CACT;AAIX;IADP,MAAM,EAAE;iDACiB;AAGlB;IADP,MAAM,EAAE;gDACgB;AAGjB;IADP,MAAM,EAAE;8CACc;AAGf;IADP,MAAM,EAAE;8CACc;AAGf;IADP,MAAM,EAAE;gDACgB;AAGjB;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;kDACI;AAG1B;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;sDACQ;AAG9B;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;+CACW;AAGjC;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;iDACV;AAGpB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;iDAC5B;AAGpB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;8CACP;AAsBlC;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,CACL,UAAiB,EACS,EAAE;QAC5B,MAAM,YAAa,SAAQ,UAAU;SAiCpC;QA/BS;YADP,MAAM,EAAE;uDACiB;QAGlB;YADP,MAAM,EAAE;sDACgB;QAGjB;YADP,MAAM,EAAE;oDACc;QAGf;YADP,MAAM,EAAE;oDACc;QAGf;YADP,MAAM,EAAE;sDACgB;QAGjB;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;wDACI;QAG1B;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;4DACQ;QAG9B;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;qDACW;QAGjC;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;uDACV;QAGpB;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;uDAC5B;QAGpB;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;oDACP;QAElC,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"with_payment.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_payment.ts"],"names":[],"mappings":"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"}

package/dist/src/billing/mixins/with_subscription.d.ts

@@ -8,6 +8,13 @@ import type { DateTime } from 'luxon';
  * model. Stores resolve it through the config (`billing.subscriptionModel`).
  */
 export declare class BillingSubscription extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row: BillingSubscription): void;
     id: string;
     /** Gateway subscription id (Stripe `sub_...`, Asaas `sub_...`, Woovi `globalID`). */
     gatewayId: string;

package/dist/src/billing/mixins/with_subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with_subscription.d.ts","sourceRoot":"","sources":["../../../../src/billing/mixins/with_subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAExC,EAAE,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IAE7E,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAG7B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IAGxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGjC,SAAS,EAAE,QAAQ,CAAC;IAGpB,SAAS,EAAE,QAAQ,CAAC;CAC7B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,oBAAoB,CAAC,OAAO,SAAS,CAAC,IAAI,KAAK,GAAG;IACjG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,eAAe,CAAC;CACvC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,KACtB,KAAK,SAAS,oBAAoB,CAAC,OAAO,SAAS,CAAC,EAC1D,YAAY,KAAK,KAChB,sBAAsB,CAAC,KAAK,CAAC,CAkCjC"}
+{"version":3,"file":"with_subscription.d.ts","sourceRoot":"","sources":["../../../../src/billing/mixins/with_subscription.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAwB,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD;;;;;OAKG;IAEH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAKzC,EAAE,EAAE,MAAM,CAAC;IAEnB,qFAAqF;IAE7E,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,MAAM,CAAC;IAGf,MAAM,EAAE,MAAM,CAAC;IAGf,UAAU,EAAE,MAAM,CAAC;IAGnB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAG7B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IAGxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGjC,SAAS,EAAE,QAAQ,CAAC;IAGpB,SAAS,EAAE,QAAQ,CAAC;CAC7B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,oBAAoB,CAAC,OAAO,SAAS,CAAC,IAAI,KAAK,GAAG;IACjG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,eAAe,CAAC;CACvC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,KACtB,KAAK,SAAS,oBAAoB,CAAC,OAAO,SAAS,CAAC,EAC1D,YAAY,KAAK,KAChB,sBAAsB,CAAC,KAAK,CAAC,CAkCjC"}

package/dist/src/billing/mixins/with_subscription.js

@@ -4,7 +4,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseModel, column } from '@adonisjs/lucid/orm';
+import { randomUUID } from 'node:crypto';
+import { BaseModel, beforeCreate, column } from '@adonisjs/lucid/orm';
 /**
  * The Lucid model backing the `billing_subscriptions` table.
  *
@@ -12,6 +13,16 @@ import { BaseModel, column } from '@adonisjs/lucid/orm';
  * model. Stores resolve it through the config (`billing.subscriptionModel`).
  */
 export class BillingSubscription extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row) {
+        if (!row.id)
+            row.id = randomUUID();
+    }
 }
 __decorate([
     column({ isPrimary: true })
@@ -46,6 +57,9 @@ __decorate([
 __decorate([
     column.dateTime({ autoCreate: true, autoUpdate: true })
 ], BillingSubscription.prototype, "updatedAt", void 0);
+__decorate([
+    beforeCreate()
+], BillingSubscription, "assignUuid", null);
 /**
  * Mixin to attach subscription columns/relationships to a custom model.
  *

package/dist/src/billing/mixins/with_subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"with_subscription.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_subscription.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;CAkCjD;AAhCS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;+CACT;AAIX;IADP,MAAM,EAAE;sDACiB;AAGlB;IADP,MAAM,EAAE;qDACgB;AAGjB;IADP,MAAM,EAAE;mDACc;AAGf;IADP,MAAM,EAAE;mDACc;AAGf;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;uDACH;AAGnB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;wDACF;AAG7B;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;mDACP;AAGxB;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;oDACW;AAGjC;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDACV;AAGpB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDAC5B;AAqB9B;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CACL,UAAiB,EACc,EAAE;QACjC,MAAM,iBAAkB,SAAQ,UAAU;SA8BzC;QA5BS;YADP,MAAM,EAAE;4DACiB;QAGlB;YADP,MAAM,EAAE;2DACgB;QAGjB;YADP,MAAM,EAAE;yDACc;QAGf;YADP,MAAM,EAAE;yDACc;QAGf;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;6DACH;QAGnB;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;8DACF;QAG7B;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;yDACP;QAGxB;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;0DACW;QAGjC;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;4DACV;QAGpB;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;4DAC5B;QAE9B,OAAO,iBAAiB,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"with_subscription.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_subscription.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGtE;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD;;;;;OAKG;IAEI,AAAP,MAAM,CAAC,UAAU,CAAC,GAAwB;QACxC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IACrC,CAAC;CAmCF;AAhCS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;+CACT;AAIX;IADP,MAAM,EAAE;sDACiB;AAGlB;IADP,MAAM,EAAE;qDACgB;AAGjB;IADP,MAAM,EAAE;mDACc;AAGf;IADP,MAAM,EAAE;mDACc;AAGf;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;uDACH;AAGnB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;wDACF;AAG7B;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;mDACP;AAGxB;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;oDACW;AAGjC;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDACV;AAGpB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDAC5B;AApCrB;IADN,YAAY,EAAE;2CAGd;AAuDH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CACL,UAAiB,EACc,EAAE;QACjC,MAAM,iBAAkB,SAAQ,UAAU;SA8BzC;QA5BS;YADP,MAAM,EAAE;4DACiB;QAGlB;YADP,MAAM,EAAE;2DACgB;QAGjB;YADP,MAAM,EAAE;yDACc;QAGf;YADP,MAAM,EAAE;yDACc;QAGf;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;6DACH;QAGnB;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;8DACF;QAG7B;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;yDACP;QAGxB;YADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;0DACW;QAGjC;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;4DACV;QAGpB;YADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;4DAC5B;QAE9B,OAAO,iBAAiB,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/billing/mixins/with_usage_event.d.ts

@@ -6,6 +6,13 @@ import type { DateTime } from 'luxon';
  * the billing layer aggregates them per meter for a period to bill usage-based plans.
  */
 export declare class BillingUsageEvent extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row: BillingUsageEvent): void;
     id: string;
     /** The subscription this usage belongs to, when metered against a subscription. */
     subscriptionId: string | null;

package/dist/src/billing/mixins/with_usage_event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with_usage_event.d.ts","sourceRoot":"","sources":["../../../../src/billing/mixins/with_usage_event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAEtC,EAAE,EAAE,MAAM,CAAC;IAEnB,mFAAmF;IAE3E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,qEAAqE;IAE7D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,wEAAwE;IAEhE,KAAK,EAAE,MAAM,CAAC;IAEtB,mFAAmF;IAE3E,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,UAAU,EAAE,QAAQ,CAAC;IAGrB,SAAS,EAAE,QAAQ,CAAC;CAC7B"}
+{"version":3,"file":"with_usage_event.d.ts","sourceRoot":"","sources":["../../../../src/billing/mixins/with_usage_event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAwB,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C;;;;;OAKG;IAEH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAKvC,EAAE,EAAE,MAAM,CAAC;IAEnB,mFAAmF;IAE3E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,qEAAqE;IAE7D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,wEAAwE;IAEhE,KAAK,EAAE,MAAM,CAAC;IAEtB,mFAAmF;IAE3E,QAAQ,EAAE,MAAM,CAAC;IAGjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,UAAU,EAAE,QAAQ,CAAC;IAGrB,SAAS,EAAE,QAAQ,CAAC;CAC7B"}

package/dist/src/billing/mixins/with_usage_event.js

@@ -4,13 +4,24 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseModel, column } from '@adonisjs/lucid/orm';
+import { randomUUID } from 'node:crypto';
+import { BaseModel, beforeCreate, column } from '@adonisjs/lucid/orm';
 /**
  * The Lucid model backing the `billing_usage_events` table — a metered subscription's
  * consumption ledger. One row per usage event (e.g. an API call, a stored GB, a message);
  * the billing layer aggregates them per meter for a period to bill usage-based plans.
  */
 export class BillingUsageEvent extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row) {
+        if (!row.id)
+            row.id = randomUUID();
+    }
 }
 __decorate([
     column({ isPrimary: true })
@@ -36,4 +47,7 @@ __decorate([
 __decorate([
     column.dateTime({ autoCreate: true, autoUpdate: true })
 ], BillingUsageEvent.prototype, "updatedAt", void 0);
+__decorate([
+    beforeCreate()
+], BillingUsageEvent, "assignUuid", null);
 //# sourceMappingURL=with_usage_event.js.map

package/dist/src/billing/mixins/with_usage_event.js.map

@@ -1 +1 @@
-{"version":3,"file":"with_usage_event.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_usage_event.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;CA4B/C;AA1BS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;6CACT;AAIX;IADP,MAAM,EAAE;yDAC6B;AAI9B;IADP,MAAM,EAAE;qDACyB;AAI1B;IADP,MAAM,EAAE;gDACa;AAId;IADP,MAAM,EAAE;mDACgB;AAGjB;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;mDACY;AAGlC;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;qDACT;AAGrB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;oDAC5B"}
+{"version":3,"file":"with_usage_event.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_usage_event.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGtE;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C;;;;;OAKG;IAEI,AAAP,MAAM,CAAC,UAAU,CAAC,GAAsB;QACtC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IACrC,CAAC;CA6BF;AA1BS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;6CACT;AAIX;IADP,MAAM,EAAE;yDAC6B;AAI9B;IADP,MAAM,EAAE;qDACyB;AAI1B;IADP,MAAM,EAAE;gDACa;AAId;IADP,MAAM,EAAE;mDACgB;AAGjB;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;mDACY;AAGlC;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;qDACT;AAGrB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;oDAC5B;AA9BrB;IADN,YAAY,EAAE;yCAGd"}

package/dist/src/billing/mixins/with_webhook_event.d.ts

@@ -6,6 +6,13 @@ import type { DateTime } from 'luxon';
  * webhook is never processed twice.
  */
 export declare class BillingWebhookEvent extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row: BillingWebhookEvent): void;
     id: string;
     /** Gateway event id — the idempotency key. */
     gatewayEventId: string;
@@ -13,6 +20,17 @@ export declare class BillingWebhookEvent extends BaseModel {
     type: string;
     status: 'received' | 'processed' | 'failed';
     payload: Record<string, unknown>;
+    /**
+     * The NORMALIZED event (`WebhookEvent.data`) this delivery carried.
+     *
+     * Stored so the dashboard's retry can rebuild the event without calling `parseWebhook`,
+     * which would re-verify a signature computed from headers the ledger never kept — the
+     * reason a retry used to answer `422` on every gateway that signs its webhooks.
+     *
+     * `null` on rows written before an earlier schema ran; the
+     * retry says so rather than replaying half an event.
+     */
+    normalized: Record<string, unknown> | null;
     /** Error message when processing failed. */
     error: string | null;
     createdAt: DateTime;

package/dist/src/billing/mixins/with_webhook_event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with_webhook_event.d.ts","sourceRoot":"","sources":["../../../../src/billing/mixins/with_webhook_event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAExC,EAAE,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAEtC,cAAc,EAAE,MAAM,CAAC;IAGvB,QAAQ,EAAE,MAAM,CAAC;IAGjB,IAAI,EAAE,MAAM,CAAC;IAGb,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IAG5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,4CAA4C;IAEpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,SAAS,EAAE,QAAQ,CAAC;IAGpB,SAAS,EAAE,QAAQ,CAAC;CAC7B"}
+{"version":3,"file":"with_webhook_event.d.ts","sourceRoot":"","sources":["../../../../src/billing/mixins/with_webhook_event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAwB,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD;;;;;OAKG;IAEH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAKzC,EAAE,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAEtC,cAAc,EAAE,MAAM,CAAC;IAGvB,QAAQ,EAAE,MAAM,CAAC;IAGjB,IAAI,EAAE,MAAM,CAAC;IAGb,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IAG5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;;;;;OASG;IAEK,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnD,4CAA4C;IAEpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,SAAS,EAAE,QAAQ,CAAC;IAGpB,SAAS,EAAE,QAAQ,CAAC;CAC7B"}

package/dist/src/billing/mixins/with_webhook_event.js

@@ -4,13 +4,24 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseModel, column } from '@adonisjs/lucid/orm';
+import { randomUUID } from 'node:crypto';
+import { BaseModel, beforeCreate, column } from '@adonisjs/lucid/orm';
 /**
  * The Lucid model backing the `billing_webhook_events` table — the idempotency ledger.
  * Every webhook event is recorded here (keyed by gateway event id) so a re-delivered
  * webhook is never processed twice.
  */
 export class BillingWebhookEvent extends BaseModel {
+    /**
+     * The `id` column is a `uuid` with no database-side default (see the published
+     * migration), so nothing but this hook fills it. Generating it here rather than in the
+     * migration keeps every supported dialect working — `gen_random_uuid()` is Postgres-only
+     * — and means an app that already ran the migration needs no new one.
+     */
+    static assignUuid(row) {
+        if (!row.id)
+            row.id = randomUUID();
+    }
 }
 __decorate([
     column({ isPrimary: true })
@@ -30,6 +41,9 @@ __decorate([
 __decorate([
     column({ serializeAs: null })
 ], BillingWebhookEvent.prototype, "payload", void 0);
+__decorate([
+    column({ serializeAs: null })
+], BillingWebhookEvent.prototype, "normalized", void 0);
 __decorate([
     column({ serializeAs: null })
 ], BillingWebhookEvent.prototype, "error", void 0);
@@ -39,4 +53,7 @@ __decorate([
 __decorate([
     column.dateTime({ autoCreate: true, autoUpdate: true })
 ], BillingWebhookEvent.prototype, "updatedAt", void 0);
+__decorate([
+    beforeCreate()
+], BillingWebhookEvent, "assignUuid", null);
 //# sourceMappingURL=with_webhook_event.js.map

package/dist/src/billing/mixins/with_webhook_event.js.map

@@ -1 +1 @@
-{"version":3,"file":"with_webhook_event.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_webhook_event.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;CA6BjD;AA3BS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;+CACT;AAIX;IADP,MAAM,EAAE;2DACsB;AAGvB;IADP,MAAM,EAAE;qDACgB;AAGjB;IADP,MAAM,EAAE;iDACY;AAGb;IADP,MAAM,EAAE;mDAC2C;AAG5C;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;oDACW;AAIjC;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;kDACD;AAGrB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDACV;AAGpB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDAC5B"}
+{"version":3,"file":"with_webhook_event.js","sourceRoot":"","sources":["../../../../src/billing/mixins/with_webhook_event.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGtE;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAChD;;;;;OAKG;IAEI,AAAP,MAAM,CAAC,UAAU,CAAC,GAAwB;QACxC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IACrC,CAAC;CA2CF;AAxCS;IADP,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;+CACT;AAIX;IADP,MAAM,EAAE;2DACsB;AAGvB;IADP,MAAM,EAAE;qDACgB;AAGjB;IADP,MAAM,EAAE;iDACY;AAGb;IADP,MAAM,EAAE;mDAC2C;AAG5C;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;oDACW;AAajC;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;uDACqB;AAI3C;IADP,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;kDACD;AAGrB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDACV;AAGpB;IADP,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;sDAC5B;AA5CrB;IADN,YAAY,EAAE;2CAGd"}

package/dist/src/billing/resolve_dispatch.d.ts

@@ -0,0 +1,22 @@
+import type { PaymentsConfig } from '../define_config.js';
+import type { WebhookDispatchMode } from './webhook_dispatcher.js';
+/** Which half of a split deployment a process is. */
+export type BillingRole = 'all' | 'api' | 'worker';
+/**
+ * The dispatch backend for a config: `billing.dispatcher` when set, else the
+ * legacy `billing.durable` alias, else `'auto'`.
+ *
+ * `dispatcher` is read FIRST because it is the only option able to name every backend; the
+ * boolean alias can only say durable or not.
+ */
+export declare function resolveDispatchMode(config: PaymentsConfig): WebhookDispatchMode;
+/** Which half this process is. Defaults to running both. */
+export declare function resolveRole(config: PaymentsConfig): BillingRole;
+/**
+ * Splitting api/worker only works when the dispatcher puts a channel between the
+ * halves. `'in-process'` runs the processor inline — an `'api'` process would
+ * process everything itself and a `'worker'` would sit idle — and `'auto'` can
+ * silently resolve to it, so neither may be split on.
+ */
+export declare function assertRoleIsDispatchable(role: BillingRole, mode: WebhookDispatchMode): void;
+//# sourceMappingURL=resolve_dispatch.d.ts.map

package/dist/src/billing/resolve_dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_dispatch.d.ts","sourceRoot":"","sources":["../../../src/billing/resolve_dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAkB/E;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAO3F"}

package/dist/src/billing/resolve_dispatch.js

@@ -0,0 +1,44 @@
+/**
+ * The dispatch backend for a config: `billing.dispatcher` when set, else the
+ * legacy `billing.durable` alias, else `'auto'`.
+ *
+ * `dispatcher` is read FIRST because it is the only option able to name every backend; the
+ * boolean alias can only say durable or not.
+ */
+export function resolveDispatchMode(config) {
+    const dispatcher = config.billing?.dispatcher;
+    // `'queue'` was in the type, in the config docs and in the dispatcher's own comments, and
+    // was implemented nowhere: `queueDispatch` was declared and never read, so the mode fell
+    // through to the `'auto'` branch and silently ran durable-or-in-process. Worse, splitting
+    // api/worker was ALLOWED on it, which produced an api process doing all the work and a
+    // worker sitting idle. Refusing at boot is the only honest answer until it exists.
+    if (dispatcher === 'queue') {
+        throw new Error('[payments] `billing.dispatcher: "queue"` is not implemented — it never was, and it silently ran the in-process or durable backend instead. Use "durable" (a real channel, and the only mode that can split billing.role) or "in-process". Track the queue backend in the roadmap.');
+    }
+    if (dispatcher !== undefined)
+        return dispatcher;
+    const legacy = config.billing?.durable ?? 'auto';
+    if (legacy === true)
+        return 'durable';
+    if (legacy === false)
+        return 'in-process';
+    return 'auto';
+}
+/** Which half this process is. Defaults to running both. */
+export function resolveRole(config) {
+    return config.billing?.role ?? 'all';
+}
+/**
+ * Splitting api/worker only works when the dispatcher puts a channel between the
+ * halves. `'in-process'` runs the processor inline — an `'api'` process would
+ * process everything itself and a `'worker'` would sit idle — and `'auto'` can
+ * silently resolve to it, so neither may be split on.
+ */
+export function assertRoleIsDispatchable(role, mode) {
+    if (role === 'all')
+        return;
+    if (mode === 'durable')
+        return;
+    throw new Error(`[payments] billing.role is "${role}", which splits receiving from processing — but billing.dispatcher is "${mode}", which has no channel between the two halves. Set dispatcher to "durable", or drop billing.role.`);
+}
+//# sourceMappingURL=resolve_dispatch.js.map

package/dist/src/billing/resolve_dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_dispatch.js","sourceRoot":"","sources":["../../../src/billing/resolve_dispatch.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC;IAC9C,0FAA0F;IAC1F,yFAAyF;IACzF,0FAA0F;IAC1F,uFAAuF;IACvF,mFAAmF;IACnF,IAAK,UAAqB,KAAK,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,mRAAmR,CACpR,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAEhD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;IACjD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAiB,EAAE,IAAyB;IACnF,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO;IAC3B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAE/B,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,0EAA0E,IAAI,oGAAoG,CACtN,CAAC;AACJ,CAAC"}

package/dist/src/billing/resolve_store.d.ts

@@ -0,0 +1,18 @@
+import type { PaymentsConfig } from '../define_config.js';
+import type { BillingStore } from './billing_store.js';
+import { LucidBillingStore } from './lucid_billing_store.js';
+/**
+ * The billing store for a config: `billing.store` when the app declared one,
+ * otherwise the Lucid store over the published tables.
+ *
+ * Extracted from the provider so the default, the override and the DI-token rule
+ * below are covered by tests that run the real thing rather than a copy of it.
+ */
+export declare function resolveBillingStore(config: PaymentsConfig): Promise<BillingStore>;
+/**
+ * Whether a resolved store may be bound in the container under the
+ * `LucidBillingStore` token. Binding a custom store there would make `@inject()`
+ * hand back something the annotation does not describe.
+ */
+export declare function isInjectableAsLucid(store: BillingStore): store is LucidBillingStore;
+//# sourceMappingURL=resolve_store.d.ts.map

package/dist/src/billing/resolve_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_store.d.ts","sourceRoot":"","sources":["../../../src/billing/resolve_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAgBvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,IAAI,iBAAiB,CAEnF"}

package/dist/src/billing/resolve_store.js

@@ -0,0 +1,35 @@
+import { LucidBillingStore } from './lucid_billing_store.js';
+/**
+ * The billing store for a config: `billing.store` when the app declared one,
+ * otherwise the Lucid store over the published tables.
+ *
+ * Extracted from the provider so the default, the override and the DI-token rule
+ * below are covered by tests that run the real thing rather than a copy of it.
+ */
+export async function resolveBillingStore(config) {
+    const autoCreateSchema = config.billing?.autoCreateSchema !== false;
+    const factory = config.billing?.store;
+    if (!factory)
+        return new LucidBillingStore({}, { autoCreateSchema });
+    const store = await factory({ config: () => config });
+    // The flag has to reach a store the APP built too. `billing.store` is how an app swaps in
+    // its own models — `() => lucidBillingStore({ paymentModel: MyPayment })` — and that store
+    // is constructed before the provider ever reads the config, so it defaults to creating
+    // tables. Skipping it here would run DDL against exactly the shared database
+    // `autoCreateSchema: false` was set to protect.
+    //
+    // Only ever turned OFF: a store the app built and configured itself is not something to
+    // switch schema creation ON for behind its back.
+    if (!autoCreateSchema && store instanceof LucidBillingStore)
+        store.disableAutoCreateSchema();
+    return store;
+}
+/**
+ * Whether a resolved store may be bound in the container under the
+ * `LucidBillingStore` token. Binding a custom store there would make `@inject()`
+ * hand back something the annotation does not describe.
+ */
+export function isInjectableAsLucid(store) {
+    return store instanceof LucidBillingStore;
+}
+//# sourceMappingURL=resolve_store.js.map

package/dist/src/billing/resolve_store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_store.js","sourceRoot":"","sources":["../../../src/billing/resolve_store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAsB;IAC9D,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,KAAK,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,iBAAiB,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAErE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,0FAA0F;IAC1F,2FAA2F;IAC3F,uFAAuF;IACvF,6EAA6E;IAC7E,gDAAgD;IAChD,EAAE;IACF,wFAAwF;IACxF,iDAAiD;IACjD,IAAI,CAAC,gBAAgB,IAAI,KAAK,YAAY,iBAAiB;QAAE,KAAK,CAAC,uBAAuB,EAAE,CAAC;IAC7F,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC5C,CAAC"}

package/dist/src/billing/schema.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The billing schema, as standalone idempotent functions.
+ *
+ * This is the ecosystem convention — a lib owns its own schema — and it is why
+ * `@adonis-agora/durable` exports `createDurableTables` and `@adonis-agora/authz` exports
+ * `createAuthzTables`. This package did not follow it, and the cost showed up quickly: every
+ * column added after the first release became another migration file with hand-written
+ * `hasColumn` / `hasTable` guards, and an app adopting the library had three files to publish
+ * and run before it could take a single payment.
+ *
+ * Two paths, one DDL. {@link LucidBillingStore} calls {@link createBillingTables} once on
+ * first use (`autoCreateSchema`, on by default), and the published migration stub calls the
+ * SAME function — so the two can never drift, which is the whole reason the DDL lives here
+ * rather than in a stub the store knows nothing about.
+ *
+ * The DDL is portable `rawQuery` (`CREATE TABLE IF NOT EXISTS`) rather than Knex's schema
+ * builder, matching the posture authz takes: it keeps the `@adonisjs/lucid` coupling to the
+ * `rawQuery` surface, and it is idempotent by construction — which is what lets an install
+ * that already ran the old Knex migration call this and have it do nothing.
+ */
+/** The bindings a Lucid `rawQuery` accepts. */
+export type LucidQueryBindings = readonly unknown[] | Record<string, unknown>;
+/**
+ * The slice of a Lucid query client these functions rely on. Both the root `Database` and a
+ * connection client satisfy it, so the dependency is on the surface rather than a concrete
+ * Lucid type.
+ *
+ * `rawQuery` is declared as a METHOD, not a function-typed property: methods are checked
+ * bivariantly, which is what lets a real Lucid client — whose signature is more specific than
+ * this mirror — satisfy the interface under `strictFunctionTypes`. Declared the other way, no
+ * real client satisfies it and the published migration stub does not compile in a consumer
+ * app even though every check inside this repo passes.
+ */
+export interface LucidQueryClient {
+    rawQuery(sql: string, bindings?: LucidQueryBindings): Promise<unknown>;
+}
+/**
+ * A Lucid `Database`, connection, or query client.
+ *
+ * Dialect detection accepts both shapes the library is handed: the root `Database` exposes
+ * the dialect via `connection().dialect`, while a migration's deferred query client
+ * (`this.defer((db) => …)`) exposes `dialect` directly.
+ */
+export interface LucidDatabase extends LucidQueryClient {
+    dialect?: {
+        name?: string;
+    };
+    connection?(name?: string): {
+        dialect?: {
+            name?: string;
+        };
+    };
+}
+/**
+ * Every table the billing layer owns.
+ *
+ * Deliberately NOT configurable, unlike authz's table names. The models are the source of
+ * truth here (`BillingModels` lets an app swap any of them), and DDL that could name a table
+ * the models do not read is a way to create an empty table beside a missing one. An app that
+ * renames a table swaps the model and writes its own migration.
+ */
+export declare const BILLING_TABLES: readonly ["billing_customers", "billing_subscriptions", "billing_payments", "billing_webhook_events", "billing_disputes", "billing_usage_events", "billing_audit_events"];
+/** Best-effort dialect name; `undefined` when it cannot be read. */
+export declare function detectDialect(db: LucidDatabase): string | undefined;
+/**
+ * Create every billing table, idempotently.
+ *
+ * Safe to call from a Lucid migration's `up()`, and safe to call repeatedly at boot — which
+ * is exactly what {@link LucidBillingStore} does when `autoCreateSchema` is on. An install
+ * that already ran the older Knex migrations gets no-ops: every statement is
+ * `IF NOT EXISTS`.
+ *
+ * It also carries columns added AFTER a table shipped — see the block at the end. That is
+ * what makes this a real upgrade path rather than a first-install convenience: an app that
+ * ran the 0.2.0 migration and then upgrades gets the columns the new code reads, without
+ * having to be told to publish and run a second migration.
+ */
+export declare function createBillingTables(db: LucidDatabase): Promise<void>;
+/**
+ * Register a "forget the cached schema" callback. Returns the unregister function.
+ * Internal — {@link LucidBillingStore} is the only caller.
+ */
+export declare function registerBillingSchemaCache(reset: () => void): () => void;
+/**
+ * Drop every billing table, newest-dependency-first.
+ *
+ * Only for a migration's `down()` and for tests. There is no auto-drop and there will not be
+ * one: a library that can delete a payments table on a config typo is a library that will.
+ *
+ * Every live store is told to forget its cached schema afterwards, so a store built before
+ * the drop re-creates the tables on its next query instead of querying tables that are gone.
+ */
+export declare function dropBillingTables(db: LucidDatabase): Promise<void>;
+/**
+ * Empty every billing table, keeping the schema.
+ *
+ * What a test suite actually needs between groups, and the reason it is here rather than in
+ * every app: dropping the tables invalidates the store (see above), while leaving the ROWS
+ * in place means one test's webhook ledger deduplicates the next test's event — the
+ * library's own idempotency working perfectly, against the suite. The app that found this
+ * hand-wrote it with a `to_regclass` guard; this is that, dialect-agnostically.
+ *
+ * Order is the reverse of creation, so a foreign key never blocks a delete. `DELETE FROM`
+ * rather than `TRUNCATE`: it is the one statement every dialect here spells the same way,
+ * and these tables are test-sized.
+ */
+export declare function truncateBillingTables(db: LucidDatabase): Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/billing/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/billing/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,2KAQjB,CAAC;AAEX,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAQnE;AAsFD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmP1E;AAaD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5E"}