@adonis-agora/payments 0.2.0 → 0.3.0

package/dist/assets/spa/index.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="robots" content="noindex, nofollow" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&family=Space+Grotesk:wght@400;500;600;700&display=swap"
+      rel="stylesheet"
+    />
+    <title>payments · billing console</title>
+    <script type="module" crossorigin src="/__PAYMENTS_DASHBOARD__/assets/index-CvEbJEnq.js"></script>
+    <link rel="stylesheet" crossorigin href="/__PAYMENTS_DASHBOARD__/assets/index-CT5Zon6P.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/commands/main.d.ts

@@ -1,5 +1,6 @@
 import { ListLoader } from '@adonisjs/core/ace';
 import MakeBillable from './make_billable.js';
+import PaymentsHealth from './payments_health.js';
 import PaymentsSync from './payments_sync.js';
 import PaymentsWebhook from './payments_webhook.js';
 /**
@@ -7,10 +8,10 @@ import PaymentsWebhook from './payments_webhook.js';
  * `rcFile.addCommand('@adonis-agora/payments/commands')` (done by this package's
  * `configure`). The ace kernel imports this module and treats it as a commands loader: a
  * {@link ListLoader} over the payments commands (`make:billable`, `make:webhook-handler`,
- * `payments:webhook`, `payments:sync`) provides their metadata and constructors.
+ * `payments:webhook`, `payments:sync`, `payments:health`) provides their metadata and constructors.
  */
-declare const loader: ListLoader<typeof MakeBillable | typeof PaymentsSync | typeof PaymentsWebhook>;
+declare const loader: ListLoader<typeof MakeBillable | typeof PaymentsHealth | typeof PaymentsSync | typeof PaymentsWebhook>;
 export declare const getMetaData: () => Promise<import("@adonisjs/core/types/ace").CommandMetaData[]>;
-export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof MakeBillable | typeof PaymentsSync | typeof PaymentsWebhook | null>;
+export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof MakeBillable | typeof PaymentsHealth | typeof PaymentsSync | typeof PaymentsWebhook | null>;
 export default loader;
 //# sourceMappingURL=main.d.ts.map

package/dist/commands/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,gFAAoF,CAAC;AAEjG,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,sJAAiC,CAAC;AAEzD,eAAe,MAAM,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAClD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,wGAMV,CAAC;AAEH,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,8KAAiC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/commands/main.js

@@ -1,6 +1,7 @@
 import { ListLoader } from '@adonisjs/core/ace';
 import MakeBillable from './make_billable.js';
 import MakeWebhookHandler from './make_webhook_handler.js';
+import PaymentsHealth from './payments_health.js';
 import PaymentsSync from './payments_sync.js';
 import PaymentsWebhook from './payments_webhook.js';
 /**
@@ -8,9 +9,15 @@ import PaymentsWebhook from './payments_webhook.js';
  * `rcFile.addCommand('@adonis-agora/payments/commands')` (done by this package's
  * `configure`). The ace kernel imports this module and treats it as a commands loader: a
  * {@link ListLoader} over the payments commands (`make:billable`, `make:webhook-handler`,
- * `payments:webhook`, `payments:sync`) provides their metadata and constructors.
+ * `payments:webhook`, `payments:sync`, `payments:health`) provides their metadata and constructors.
  */
-const loader = new ListLoader([MakeBillable, MakeWebhookHandler, PaymentsWebhook, PaymentsSync]);
+const loader = new ListLoader([
+    MakeBillable,
+    MakeWebhookHandler,
+    PaymentsWebhook,
+    PaymentsSync,
+    PaymentsHealth,
+]);
 export const getMetaData = loader.getMetaData.bind(loader);
 export const getCommand = loader.getCommand.bind(loader);
 export default loader;

package/dist/commands/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,kBAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,kBAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAClD,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;IAC5B,YAAY;IACZ,kBAAkB;IAClB,eAAe;IACf,YAAY;IACZ,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/commands/payments_health.d.ts

@@ -0,0 +1,31 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace payments:health` — the scheduled check for the six silent failures of a billing
+ * install: events claimed and never finished, events the dispatcher gave up on, charges
+ * created that never confirmed, a chargeback whose evidence window is about to close, a
+ * chargeback that is simply open, and deliveries the endpoint refused.
+ *
+ * Two of those are the reason to run this on a cron rather than when something looks wrong.
+ * A closing evidence window is not a failure at all — nothing is broken, and the money goes
+ * anyway if nobody answers in time. A refused delivery leaves no ledger row (it is rejected
+ * before an event exists), so a rotated webhook credential looks exactly like a quiet
+ * gateway from the inside: no events, no failures, and revenue that simply stops.
+ *
+ * Exits non-zero when anything is wrong, so a cron entry or a container healthcheck can
+ * page on it without parsing the output. `--json` prints the machine-readable form for a
+ * metrics shipper.
+ */
+export default class PaymentsHealth extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    stuckAfter?: number;
+    unconfirmedAfter?: number;
+    window?: number;
+    disputeWindow?: number;
+    rejectedWindow?: number;
+    json?: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=payments_health.d.ts.map

package/dist/commands/payments_health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments_health.d.ts","sourceRoot":"","sources":["../../commands/payments_health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,OAAgB,WAAW,SAAqB;IAChD,OAAgB,WAAW,SACkF;IAC7G,OAAgB,OAAO,EAAE,cAAc,CAAsB;IAKrD,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,IAAI,CAAC,EAAE,OAAO,CAAC;IAER,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4DpC"}

package/dist/commands/payments_health.js

@@ -0,0 +1,113 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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 { BaseCommand, flags } from '@adonisjs/core/ace';
+import { billingHealth } from '../src/billing/billing_health.js';
+import { resolveBillingStore } from '../src/billing/resolve_store.js';
+/**
+ * `node ace payments:health` — the scheduled check for the six silent failures of a billing
+ * install: events claimed and never finished, events the dispatcher gave up on, charges
+ * created that never confirmed, a chargeback whose evidence window is about to close, a
+ * chargeback that is simply open, and deliveries the endpoint refused.
+ *
+ * Two of those are the reason to run this on a cron rather than when something looks wrong.
+ * A closing evidence window is not a failure at all — nothing is broken, and the money goes
+ * anyway if nobody answers in time. A refused delivery leaves no ledger row (it is rejected
+ * before an event exists), so a rotated webhook credential looks exactly like a quiet
+ * gateway from the inside: no events, no failures, and revenue that simply stops.
+ *
+ * Exits non-zero when anything is wrong, so a cron entry or a container healthcheck can
+ * page on it without parsing the output. `--json` prints the machine-readable form for a
+ * metrics shipper.
+ */
+export default class PaymentsHealth extends BaseCommand {
+    static commandName = 'payments:health';
+    static description = 'Report stuck and failed webhooks, unconfirmed charges, open and closing disputes, and refused deliveries';
+    static options = { startApp: true };
+    async run() {
+        const config = this.app.config.get('payments', {});
+        if (config.billing?.enabled === false) {
+            this.logger.error('The billing layer is disabled (billing.enabled = false). Nothing to check.');
+            this.exitCode = 1;
+            return;
+        }
+        const store = await resolveBillingStore(config);
+        const report = await billingHealth(store, {
+            ...(this.stuckAfter !== undefined ? { stuckAfter: this.stuckAfter * 60_000 } : {}),
+            ...(this.unconfirmedAfter !== undefined
+                ? { unconfirmedAfter: this.unconfirmedAfter * 60_000 }
+                : {}),
+            ...(this.window !== undefined ? { failedWithin: this.window * 3_600_000 } : {}),
+            ...(this.disputeWindow !== undefined
+                ? { disputeDueWithin: this.disputeWindow * 3_600_000 }
+                : {}),
+            ...(this.rejectedWindow !== undefined
+                ? { rejectedWithin: this.rejectedWindow * 3_600_000 }
+                : {}),
+        });
+        if (this.json) {
+            this.logger.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            for (const check of report.checks) {
+                const line = `${check.count}  ${check.label}`;
+                if (check.healthy)
+                    this.logger.success(line);
+                else
+                    this.logger.error(`${line}\n     ${check.hint}`);
+            }
+            for (const failure of report.failures) {
+                this.logger.info(`  ${failure.provider} ${failure.type}: ${failure.count} failed`);
+            }
+            // WHICH windows are closing, soonest first — a count names nobody to email and no
+            // gateway dashboard to open. The list is capped; the check's count is not, so a
+            // report can name twenty of fifty without pretending it named all of them.
+            for (const dispute of report.deadlines) {
+                const due = dispute.evidenceDueBy?.toISOString() ?? 'unknown';
+                this.logger.info(`  ${dispute.provider} ${dispute.gatewayId} (payment ${dispute.paymentGatewayId}): evidence due ${due}`);
+            }
+            // The open-dispute check exists BECAUSE a deadline is usually absent — Asaas' own
+            // webhook examples never carry one — so printing only `deadlines` would fire a count
+            // that names nobody, on precisely the installs the check was added for.
+            const named = new Set(report.deadlines.map((dispute) => dispute.gatewayId));
+            for (const dispute of report.openDisputes) {
+                if (named.has(dispute.gatewayId))
+                    continue;
+                this.logger.info(`  ${dispute.provider} ${dispute.gatewayId} (payment ${dispute.paymentGatewayId}): open, no deadline given`);
+            }
+        }
+        // Non-zero so a scheduler notices without reading the output.
+        if (!report.healthy)
+            this.exitCode = 1;
+    }
+}
+__decorate([
+    flags.number({
+        description: 'Minutes an event may sit unfinished before it counts as stuck (default 15)',
+    })
+], PaymentsHealth.prototype, "stuckAfter", void 0);
+__decorate([
+    flags.number({
+        description: 'Minutes a charge may stay pending before it counts as unconfirmed (default 120)',
+    })
+], PaymentsHealth.prototype, "unconfirmedAfter", void 0);
+__decorate([
+    flags.number({ description: 'Window in hours that failures are counted over (default 24)' })
+], PaymentsHealth.prototype, "window", void 0);
+__decorate([
+    flags.number({
+        description: 'Hours ahead to look for a dispute whose evidence window closes (default 72). Windows already past are always counted',
+    })
+], PaymentsHealth.prototype, "disputeWindow", void 0);
+__decorate([
+    flags.number({
+        description: 'Window in hours that refused deliveries are counted over (default 24)',
+    })
+], PaymentsHealth.prototype, "rejectedWindow", void 0);
+__decorate([
+    flags.boolean({ description: 'Print the report as JSON' })
+], PaymentsHealth.prototype, "json", void 0);
+//# sourceMappingURL=payments_health.js.map

package/dist/commands/payments_health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments_health.js","sourceRoot":"","sources":["../../commands/payments_health.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAGtE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,MAAM,CAAU,WAAW,GAAG,iBAAiB,CAAC;IAChD,MAAM,CAAU,WAAW,GACzB,0GAA0G,CAAC;IAC7G,MAAM,CAAU,OAAO,GAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IA6BpD,KAAK,CAAC,GAAG;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAiB,UAAU,EAAE,EAAE,CAAC,CAAC;QACnE,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,4EAA4E,CAC7E,CAAC;YACF,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE;YACxC,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS;gBACrC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,GAAG,MAAM,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS;gBAClC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,aAAa,GAAG,SAAS,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;gBACnC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,GAAG,SAAS,EAAE;gBACrD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC9C,IAAI,KAAK,CAAC,OAAO;oBAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;oBACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;YACrF,CAAC;YACD,kFAAkF;YAClF,gFAAgF;YAChF,2EAA2E;YAC3E,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACvC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,SAAS,CAAC;gBAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,aAAa,OAAO,CAAC,gBAAgB,mBAAmB,GAAG,EAAE,CACxG,CAAC;YACJ,CAAC;YACD,kFAAkF;YAClF,qFAAqF;YACrF,wEAAwE;YACxE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;YAC5E,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;oBAAE,SAAS;gBAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,aAAa,OAAO,CAAC,gBAAgB,4BAA4B,CAC5G,CAAC;YACJ,CAAC;QACH,CAAC;QAED,8DAA8D;QAC9D,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzC,CAAC;;AAnFO;IAHP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EAAE,4EAA4E;KAC1F,CAAC;kDAC0B;AAKpB;IAHP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EAAE,iFAAiF;KAC/F,CAAC;wDACgC;AAG1B;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC;8CACrE;AAMhB;IAJP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EACT,sHAAsH;KACzH,CAAC;qDAC6B;AAKvB;IAHP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EAAE,uEAAuE;KACrF,CAAC;sDAC8B;AAGxB;IADP,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;4CACpC"}

package/dist/commands/payments_sync.d.ts

@@ -2,10 +2,24 @@ import { BaseCommand } from '@adonisjs/core/ace';
 import type { CommandOptions } from '@adonisjs/core/types/ace';
 /**
  * `node ace payments:sync [--provider=stripe] [--customer=cus_123 | --all]` — reconcile
- * local billing records with the gateway. Useful after missed webhooks or manual
- * dashboard changes: pulls recent invoices for a customer (or every customer in
- * `billing_customers` with `--all`) and upserts the paid ones into the local store, so
- * the billing tables converge with the gateway.
+ * local billing records with the gateway. Useful after missed webhooks or manual dashboard
+ * changes: pages through every invoice for a customer (or for every recorded customer with
+ * `--all`), asks the gateway what each charge's payment actually says, and writes that into
+ * the local store — so the billing tables converge with the gateway.
+ *
+ * Three properties this command has to have, and did not:
+ *
+ * 1. **Every invoice, not the first page.** It read one unpaginated listing and reported the
+ *    total as if it were the whole customer.
+ * 2. **Both directions.** It wrote `status: 'paid'` and nothing else, counting everything
+ *    that was not paid as "skipped (non-paid)" — so a local row saying `paid` while the
+ *    gateway said refunded or charged back could never be corrected, which is precisely the
+ *    drift a gateway-is-truth reconcile exists for.
+ * 3. **The gateway's settlement date, or none.** It stamped `paidAt: new Date()`, which moved
+ *    historic revenue into the month the reconcile ran.
+ *
+ * One local state is deliberately NOT reconcilable from the gateway: `disputed`. See the
+ * comment on it below.
  */
 export default class PaymentsSync extends BaseCommand {
     #private;

package/dist/commands/payments_sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payments_sync.d.ts","sourceRoot":"","sources":["../../commands/payments_sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM/D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;;IACnD,OAAgB,WAAW,SAAmB;IAC9C,OAAgB,WAAW,SAA6D;IACxF,OAAgB,OAAO,EAAE,cAAc,CAA+B;IAG9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,GAAG,CAAC,EAAE,OAAO,CAAC;IAEP,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqEpC"}
+{"version":3,"file":"payments_sync.d.ts","sourceRoot":"","sources":["../../commands/payments_sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAsB/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;;IACnD,OAAgB,WAAW,SAAmB;IAC9C,OAAgB,WAAW,SAA6D;IACxF,OAAgB,OAAO,EAAE,cAAc,CAA+B;IAG9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,GAAG,CAAC,EAAE,OAAO,CAAC;IAEP,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2JpC"}

package/dist/commands/payments_sync.js

@@ -5,15 +5,43 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { BaseCommand, flags } from '@adonisjs/core/ace';
-import db from '@adonisjs/lucid/services/db';
-import { LucidBillingStore } from '../src/billing/lucid_billing_store.js';
+import { resolveBillingStore } from '../src/billing/resolve_store.js';
 import { PaymentsManager } from '../src/payments_manager.js';
+/** Customers pulled per page while iterating `--all`. */
+const PAGE = 100;
+/**
+ * A gateway-sent settlement date as a `Date`, or `undefined` when there is nothing usable.
+ *
+ * Never a fallback to "now". `revenue()` windows on `paid_at`, so a manufactured date files
+ * money in the month the reconcile ran rather than the month it was earned — and running the
+ * reconcile twice, in two months, counted the same charge in both.
+ */
+function parseInstant(value) {
+    if (value === undefined)
+        return undefined;
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? undefined : parsed;
+}
 /**
  * `node ace payments:sync [--provider=stripe] [--customer=cus_123 | --all]` — reconcile
- * local billing records with the gateway. Useful after missed webhooks or manual
- * dashboard changes: pulls recent invoices for a customer (or every customer in
- * `billing_customers` with `--all`) and upserts the paid ones into the local store, so
- * the billing tables converge with the gateway.
+ * local billing records with the gateway. Useful after missed webhooks or manual dashboard
+ * changes: pages through every invoice for a customer (or for every recorded customer with
+ * `--all`), asks the gateway what each charge's payment actually says, and writes that into
+ * the local store — so the billing tables converge with the gateway.
+ *
+ * Three properties this command has to have, and did not:
+ *
+ * 1. **Every invoice, not the first page.** It read one unpaginated listing and reported the
+ *    total as if it were the whole customer.
+ * 2. **Both directions.** It wrote `status: 'paid'` and nothing else, counting everything
+ *    that was not paid as "skipped (non-paid)" — so a local row saying `paid` while the
+ *    gateway said refunded or charged back could never be corrected, which is precisely the
+ *    drift a gateway-is-truth reconcile exists for.
+ * 3. **The gateway's settlement date, or none.** It stamped `paidAt: new Date()`, which moved
+ *    historic revenue into the month the reconcile ran.
+ *
+ * One local state is deliberately NOT reconcilable from the gateway: `disputed`. See the
+ * comment on it below.
  */
 export default class PaymentsSync extends BaseCommand {
     static commandName = 'payments:sync';
@@ -26,7 +54,7 @@ export default class PaymentsSync extends BaseCommand {
             return;
         }
         if (!this.customer && !this.all) {
-            this.logger.error('Pass --customer=<gateway customer id> to sync one customer, or --all to sync every customer in billing_customers.');
+            this.logger.error('Pass --customer=<gateway customer id> to sync one customer, or --all to sync every recorded gateway customer.');
             return;
         }
         const manager = await this.app.container.make(PaymentsManager);
@@ -34,50 +62,118 @@ export default class PaymentsSync extends BaseCommand {
         // Some gateways (Woovi/OpenPix) have no invoice concept — fail early with a clear
         // message instead of listing nothing.
         manager.assertCapability(driver, 'invoices');
-        const store = new LucidBillingStore();
-        const customers = this.customer ? [this.customer] : await this.#listCustomers();
+        // The CONFIGURED store, not a fresh Lucid one: an app that pointed `billing.store`
+        // somewhere else would otherwise have its reconcile write to a database the rest of
+        // the billing layer never reads.
+        const store = await resolveBillingStore(config);
+        const customers = this.customer
+            ? [this.customer]
+            : await this.#listCustomers(store, this.provider);
         if (customers.length === 0) {
-            this.logger.info('No customers to sync (billing_customers is empty).');
+            this.logger.info('No customers recorded to sync. `--all` iterates the mappings written by ensureCustomer({ store }) / store.saveCustomer() — see the billing docs.');
             return;
         }
         let synced = 0;
+        let protectedRows = 0;
         for (const customerId of customers) {
             const invoices = await driver.listInvoices(customerId);
-            let skipped = 0;
+            let changed = 0;
+            let unchanged = 0;
+            let undecided = 0;
             for (const invoice of invoices) {
-                // Only sync invoices that represent a settled/paid billing event.
-                if (invoice.status === 'paid') {
-                    await store.savePayment({
-                        gatewayId: invoice.gatewayId,
-                        provider: invoice.provider,
-                        status: 'paid',
-                        amount: invoice.amount.amount,
-                        currency: invoice.amount.currency,
-                        ...(invoice.customerId !== undefined ? { customerId: invoice.customerId } : {}),
-                        ...(invoice.subscriptionId !== undefined
-                            ? { subscriptionId: invoice.subscriptionId }
-                            : {}),
-                        paidAt: new Date(),
-                        payload: invoice.payload,
-                    });
-                    synced += 1;
+                const local = await store.findPaymentByGatewayId(invoice.gatewayId);
+                // The converged case, and the reason a second run of this command is cheap: the
+                // gateway says paid, the local row says paid, and it already carries a settlement
+                // date. There is nothing a `findPayment` could tell us, so it is not asked.
+                if (local !== null &&
+                    local.status === 'paid' &&
+                    local.paidAt &&
+                    invoice.status === 'paid') {
+                    unchanged += 1;
+                    continue;
                 }
-                else {
-                    skipped += 1;
+                // `Invoice.status` cannot say `refunded` or `disputed` — its vocabulary has no
+                // members for them, so a reversed charge arrives here as `draft`. That is the exact
+                // drift a gateway-is-truth reconcile exists to correct, so the authority is the
+                // PAYMENT resource, which speaks `BillingStatus`: the listing enumerates, the payment
+                // decides.
+                const remote = await driver.findPayment(invoice.gatewayId);
+                if (remote === null) {
+                    undecided += 1;
+                    continue;
                 }
+                // The one local state the gateway does not get to overwrite. A chargeback is money
+                // the bank has pulled back, it lives in `billing_disputes` with a deadline, and the
+                // gateway's payment resource frequently goes on reporting the charge as received
+                // while the dispute is open — so reconciling `disputed` back to `paid` here would
+                // re-count money that is gone and silence the dispute at the same time. Only
+                // `payment.dispute_closed`, which carries an outcome, resolves one.
+                if (local !== null && local.status === 'disputed' && remote.status !== 'disputed') {
+                    protectedRows += 1;
+                    this.logger.warning(`  ${invoice.gatewayId}: local row is disputed, gateway says ${remote.status} — left alone. A dispute is resolved by its close event, not by a reconcile.`);
+                    continue;
+                }
+                // Already agreed, with nothing left to add: same status, and either the settlement
+                // date is recorded or the gateway has none to give. Skipped so a reconcile over a
+                // stable install writes nothing at all rather than churning every row's `updated_at`.
+                if (local !== null &&
+                    local.status === remote.status &&
+                    (local.paidAt || remote.paidAt === undefined)) {
+                    unchanged += 1;
+                    continue;
+                }
+                // The gateway's OWN settlement date, and never a substitute for it. Stamping
+                // `new Date()` here — which is what this did — relocated historic revenue into the
+                // month the reconcile ran, so running it twice in different months counted the same
+                // charge in both. An already-recorded `paid_at` is never overwritten, and an invoice
+                // that carries none records none: absent means "not stated" to `savePayment`, which
+                // leaves whatever is there alone.
+                const settledAt = local?.paidAt ? undefined : parseInstant(remote.paidAt);
+                await store.savePayment({
+                    gatewayId: invoice.gatewayId,
+                    provider: invoice.provider,
+                    // Both directions. Writing only `paid` meant a local row saying `paid` while the
+                    // gateway said refunded or charged back could never be corrected — and every such
+                    // row was counted as "skipped (non-paid)", which read like nothing was wrong.
+                    status: remote.status,
+                    amount: remote.amount.amount,
+                    currency: remote.amount.currency,
+                    ...(invoice.customerId !== undefined ? { customerId: invoice.customerId } : {}),
+                    ...(invoice.subscriptionId !== undefined
+                        ? { subscriptionId: invoice.subscriptionId }
+                        : {}),
+                    ...(settledAt !== undefined ? { paidAt: settledAt } : {}),
+                    payload: invoice.payload,
+                });
+                changed += 1;
+                synced += 1;
             }
-            this.logger.info(`  ${customerId}: ${invoices.length} invoice(s), ${invoices.length - skipped} synced, ${skipped} skipped (non-paid)`);
+            this.logger.info(`  ${customerId}: ${invoices.length} invoice(s), ${changed} reconciled, ${unchanged} already current, ${undecided} undecidable (gateway had no payment)`);
         }
-        this.logger.success(`Synced ${synced} paid invoice(s) across ${customers.length} customer(s).`);
+        this.logger.success(`Reconciled ${synced} payment(s) across ${customers.length} customer(s)${protectedRows > 0 ? `; ${protectedRows} disputed row(s) left alone` : ''}.`);
     }
-    /** Gateway customer ids from the `billing_customers` table (best-effort). */
-    async #listCustomers() {
-        try {
-            const rows = await db.from('billing_customers').select('gateway_id');
-            return rows.map((row) => row.gateway_id);
-        }
-        catch {
-            return [];
+    /**
+     * Gateway customer ids from the recorded customer mappings.
+     *
+     * Read through the STORE rather than the table: `billing.store` is a configured seam, and
+     * a reconcile that queried `billing_customers` directly would iterate a table the rest of
+     * the billing layer no longer uses the moment an app points that seam elsewhere.
+     *
+     * Paged, because `--all` on a large install would otherwise select the whole table into
+     * memory before the first invoice is fetched.
+     */
+    async #listCustomers(store, provider) {
+        const ids = [];
+        for (let offset = 0;; offset += PAGE) {
+            const page = await store.listCustomers({
+                limit: PAGE,
+                offset,
+                ...(provider !== undefined ? { provider } : {}),
+            });
+            for (const row of page)
+                ids.push(row.gatewayId);
+            if (page.length < PAGE)
+                return ids;
         }
     }
 }
@@ -89,7 +185,7 @@ __decorate([
 ], PaymentsSync.prototype, "customer", void 0);
 __decorate([
     flags.boolean({
-        description: 'Sync invoices for every customer in the billing_customers table',
+        description: 'Sync invoices for every recorded gateway customer',
     })
 ], PaymentsSync.prototype, "all", void 0);
 //# sourceMappingURL=payments_sync.js.map

package/dist/commands/payments_sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"payments_sync.js","sourceRoot":"","sources":["../../commands/payments_sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payments_sync.js","sourceRoot":"","sources":["../../commands/payments_sync.ts"],"names":[],"mappings":"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"}

package/dist/configure.d.ts

@@ -2,11 +2,18 @@ import type Configure from '@adonisjs/core/commands/configure';
 /**
  * `node ace configure @adonis-agora/payments` — auto-wires the package:
  *
- * 1. registers the payments service provider in `adonisrc.ts`;
- * 2. publishes `config/payments.ts`;
- * 3. publishes the Lucid migrations for the billing tables (run `node ace migration:run`;
- *    delete the file if you only use payments without the billing layer);
- * 4. registers the env validations for the payment providers.
+ * 1. registers the payments service provider in `adonisrc.ts`, plus the optional
+ *    dashboard provider;
+ * 2. registers the Assembler `init` hook that generates the `app/payment_handlers/`
+ *    barrel (discovery works without it — the provider falls back to a runtime scan —
+ *    but the barrel removes that scan from boot);
+ * 3. publishes `config/payments.ts`, `config/payments_dashboard.ts` and
+ *    `config/payments_client.ts` (the browser status endpoint — off unless enabled);
+ * 4. publishes ONE Lucid migration for the billing tables, which most apps can delete: the
+ *    library creates its own schema on first use (`billing.autoCreateSchema`, on by
+ *    default), so the file is there for apps that would rather run the DDL explicitly. Both
+ *    paths call the same `createBillingTables`;
+ * 5. registers the env validations for the payment providers.
  */
 export declare function configure(command: Configure): Promise<void>;
 //# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAyBjD"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBA+BjD"}

package/dist/configure.js

@@ -2,21 +2,33 @@ import { stubsRoot } from './stubs/main.js';
 /**
  * `node ace configure @adonis-agora/payments` — auto-wires the package:
  *
- * 1. registers the payments service provider in `adonisrc.ts`;
- * 2. publishes `config/payments.ts`;
- * 3. publishes the Lucid migrations for the billing tables (run `node ace migration:run`;
- *    delete the file if you only use payments without the billing layer);
- * 4. registers the env validations for the payment providers.
+ * 1. registers the payments service provider in `adonisrc.ts`, plus the optional
+ *    dashboard provider;
+ * 2. registers the Assembler `init` hook that generates the `app/payment_handlers/`
+ *    barrel (discovery works without it — the provider falls back to a runtime scan —
+ *    but the barrel removes that scan from boot);
+ * 3. publishes `config/payments.ts`, `config/payments_dashboard.ts` and
+ *    `config/payments_client.ts` (the browser status endpoint — off unless enabled);
+ * 4. publishes ONE Lucid migration for the billing tables, which most apps can delete: the
+ *    library creates its own schema on first use (`billing.autoCreateSchema`, on by
+ *    default), so the file is there for apps that would rather run the DDL explicitly. Both
+ *    paths call the same `createBillingTables`;
+ * 5. registers the env validations for the payment providers.
  */
 export async function configure(command) {
     const codemods = await command.createCodemods();
     // biome-ignore lint/suspicious/noExplicitAny: `createCodemods` types the callback; matching media.
     await codemods.updateRcFile((rcFile) => {
         rcFile.addProvider('@adonis-agora/payments/payments_provider');
+        rcFile.addProvider('@adonis-agora/payments/dashboard_provider');
+        rcFile.addProvider('@adonis-agora/payments/payments_client_provider');
         rcFile.addCommand('@adonis-agora/payments/commands');
+        rcFile.addAssemblerHook('init', '@adonis-agora/payments/hooks/webhook_handlers');
     });
     const stubs = stubsRoot();
     await codemods.makeUsingStub(stubs, 'config/payments.stub', {});
+    await codemods.makeUsingStub(stubs, 'config/payments_dashboard.stub', {});
+    await codemods.makeUsingStub(stubs, 'config/payments_client.stub', {});
     await codemods.makeUsingStub(stubs, 'database/migrations/create_billing_tables.stub', {});
     await codemods.defineEnvValidations({
         leadingComment: 'PAYMENTS_',
@@ -28,6 +40,7 @@ export async function configure(command) {
             ASAAS_API_KEY: 'Env.schema.string.optional()',
             WOOVI_APP_ID: 'Env.schema.string.optional()',
             FOCUS_NFE_TOKEN: 'Env.schema.string.optional()',
+            PAYMENTS_DASHBOARD_TOKEN: 'Env.schema.string.optional()',
         },
     });
 }

package/dist/configure.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,mGAAmG;IACnG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAW,EAAE,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,gDAAgD,EAAE,EAAE,CAAC,CAAC;IAE1F,MAAM,QAAQ,CAAC,oBAAoB,CAAC;QAClC,cAAc,EAAE,WAAW;QAC3B,SAAS,EAAE;YACT,UAAU,EAAE,8BAA8B;YAC1C,qBAAqB,EAAE,8BAA8B;YACrD,eAAe,EAAE,8BAA8B;YAC/C,kBAAkB,EAAE,8BAA8B;YAClD,aAAa,EAAE,8BAA8B;YAC7C,YAAY,EAAE,8BAA8B;YAC5C,eAAe,EAAE,8BAA8B;SAChD;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,mGAAmG;IACnG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAW,EAAE,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,WAAW,CAAC,2CAA2C,CAAC,CAAC;QAChE,MAAM,CAAC,WAAW,CAAC,iDAAiD,CAAC,CAAC;QACtE,MAAM,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;QACrD,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,+CAA+C,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,gCAAgC,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,6BAA6B,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,gDAAgD,EAAE,EAAE,CAAC,CAAC;IAE1F,MAAM,QAAQ,CAAC,oBAAoB,CAAC;QAClC,cAAc,EAAE,WAAW;QAC3B,SAAS,EAAE;YACT,UAAU,EAAE,8BAA8B;YAC1C,qBAAqB,EAAE,8BAA8B;YACrD,eAAe,EAAE,8BAA8B;YAC/C,kBAAkB,EAAE,8BAA8B;YAClD,aAAa,EAAE,8BAA8B;YAC7C,YAAY,EAAE,8BAA8B;YAC5C,eAAe,EAAE,8BAA8B;YAC/C,wBAAwB,EAAE,8BAA8B;SACzD;KACF,CAAC,CAAC;AACL,CAAC"}