@adonis-agora/payments 0.2.0

package/dist/stubs/database/migrations/create_billing_tables.stub

@@ -0,0 +1,90 @@
+{{{
+  exports({ to: app.migrationsPath(`${new Date().getTime()}_create_billing_tables.ts`) })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+
+export default class extends BaseSchema {
+  protected tableName = 'billing_customers'
+
+  async up() {
+    this.schema.createTable('billing_customers', (table) => {
+      table.uuid('id').primary()
+      table.string('owner_type')
+      table.string('owner_id')
+      table.string('gateway_id').unique()
+      table.string('provider')
+      table.string('email').nullable()
+      table.string('name').nullable()
+      table.string('tax_id').nullable()
+      table.jsonb('metadata').nullable()
+      table.timestamp('created_at', { useTz: true }).notNullable()
+      table.timestamp('updated_at', { useTz: true }).notNullable()
+      table.index(['owner_type', 'owner_id'], 'billing_customers_owner_idx')
+    })
+
+    this.schema.createTable('billing_subscriptions', (table) => {
+      table.uuid('id').primary()
+      table.string('gateway_id').unique()
+      table.string('provider')
+      table.string('status')
+      table.string('plan_id')
+      table.string('customer_id').nullable()
+      table.timestamp('trial_ends_at', { useTz: true }).nullable()
+      table.timestamp('ends_at', { useTz: true }).nullable()
+      table.jsonb('payload').nullable()
+      table.timestamp('created_at', { useTz: true }).notNullable()
+      table.timestamp('updated_at', { useTz: true }).notNullable()
+      table.index(['customer_id'], 'billing_subscriptions_customer_idx')
+    })
+
+    this.schema.createTable('billing_payments', (table) => {
+      table.uuid('id').primary()
+      table.string('gateway_id').unique()
+      table.string('provider')
+      table.string('status')
+      table.bigInteger('amount')
+      table.string('currency', 3)
+      table.string('customer_id').nullable()
+      table.string('subscription_id').nullable()
+      table.jsonb('payload').nullable()
+      table.timestamp('paid_at', { useTz: true }).nullable()
+      table.timestamp('created_at', { useTz: true }).notNullable()
+      table.timestamp('updated_at', { useTz: true }).notNullable()
+      table.index(['customer_id'], 'billing_payments_customer_idx')
+      table.index(['subscription_id'], 'billing_payments_subscription_idx')
+    })
+
+    this.schema.createTable('billing_webhook_events', (table) => {
+      table.uuid('id').primary()
+      table.string('gateway_event_id').unique()
+      table.string('provider')
+      table.string('type')
+      table.string('status')
+      table.jsonb('payload').nullable()
+      table.text('error').nullable()
+      table.timestamp('created_at', { useTz: true }).notNullable()
+      table.timestamp('updated_at', { useTz: true }).notNullable()
+    })
+
+    this.schema.createTable('billing_usage_events', (table) => {
+      table.uuid('id').primary()
+      table.string('subscription_id').nullable()
+      table.string('customer_id').nullable()
+      table.string('meter')
+      table.integer('quantity').defaultTo(1)
+      table.jsonb('metadata').nullable()
+      table.timestamp('recorded_at', { useTz: true }).notNullable()
+      table.timestamp('updated_at', { useTz: true }).notNullable()
+      table.index(['subscription_id', 'meter'], 'billing_usage_subscription_meter_idx')
+      table.index(['customer_id', 'meter'], 'billing_usage_customer_meter_idx')
+    })
+  }
+
+  async down() {
+    this.schema.dropTable('billing_customers')
+    this.schema.dropTable('billing_subscriptions')
+    this.schema.dropTable('billing_payments')
+    this.schema.dropTable('billing_webhook_events')
+    this.schema.dropTable('billing_usage_events')
+  }
+}

package/dist/stubs/main.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Absolute path to the published stubs directory (`dist/stubs/`).
+ *
+ * Computed lazily on first call — NOT at module import — and memoized, so importing this
+ * package never evaluates `fileURLToPath(new URL('./', import.meta.url))` at load time
+ * (see the same hazard fix in `@adonis-agora/media`).
+ */
+export declare function stubsRoot(): string;
+//# sourceMappingURL=main.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../stubs/main.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}

package/dist/stubs/main.js

@@ -0,0 +1,16 @@
+import { fileURLToPath } from 'node:url';
+let cached;
+/**
+ * Absolute path to the published stubs directory (`dist/stubs/`).
+ *
+ * Computed lazily on first call — NOT at module import — and memoized, so importing this
+ * package never evaluates `fileURLToPath(new URL('./', import.meta.url))` at load time
+ * (see the same hazard fix in `@adonis-agora/media`).
+ */
+export function stubsRoot() {
+    if (cached === undefined) {
+        cached = fileURLToPath(new URL('./', import.meta.url));
+    }
+    return cached;
+}
+//# sourceMappingURL=main.js.map

package/dist/stubs/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../stubs/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,MAA0B,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stubs/make/billable/main.stub

@@ -0,0 +1,28 @@
+{{#var billableName = string(entity.name).pascalCase().toString()}}
+{{#var billableFileName = string(entity.name).snakeCase().removeSuffix('model').toString() + '_model'}}
+{{{
+  exports({
+    to: app.makePath('app/models', entity.path, billableFileName + '.ts')
+  })
+}}}
+import { BaseModel, compose } from '@adonisjs/lucid/orm'
+import { column } from '@adonisjs/lucid/orm'
+import { withBillable } from '@adonis-agora/payments'
+
+/**
+ * {{ billableName }} — the billable model. Compose `withBillable()` to add the billing
+ * customer columns (billingCustomerId, billingProvider) and use the payments service
+ * to charge, subscribe and manage payment methods.
+ *
+ * ```ts
+ * const payments = await app.container.make(PaymentsManager)
+ * const driver = payments.driver('pix')
+ * const customer = await driver.createCustomer({ name: user.name, email: user.email })
+ * user.billingCustomerId = customer.id
+ * await user.save()
+ * ```
+ */
+export default class {{ billableName }} extends compose(BaseModel, withBillable()) {
+  @column({ isPrimary: true })
+  declare id: string
+}

package/dist/stubs/make/webhook_handler/main.stub

@@ -0,0 +1,29 @@
+{{#var handlerName = string(entity.name).pascalCase().toString()}}
+{{#var fileName = string(entity.name).snakeCase().toString()}}
+{{{
+  exports({
+    to: app.makePath('app/payment_handlers', entity.path, fileName + '.ts')
+  })
+}}}
+import { inject } from '@adonisjs/core'
+import type { WebhookEvent } from '@adonis-agora/payments'
+
+/**
+ * Webhook handler para `{{ entity.name }}` — rodado pela rota da própria lib
+ * (`/payments/webhook/:provider`) dentro do WebhookProcessor. Um throw marca o evento
+ * como failed no ledger e o dispatcher re-tenta (durable/in-process).
+ *
+ * Faça a lógica pesada rodar numa fila/workflow durable e dispatch aqui:
+ *
+ *   const engine = await app.container.make(WorkflowEngine)
+ *   await engine.start(MyWorkflow, { ... }, randomUUID())
+ */
+@inject()
+export default class {{ handlerName }}Handler {
+  static readonly eventType = '{{ entity.name }}'
+
+  async handle(event: WebhookEvent): Promise<void> {
+    // Sua lógica de negócio (ou dispatch pra um workflow durable / job da fila)...
+    void event
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@adonis-agora/payments",
+  "version": "0.2.0",
+  "description": "Billing library for AdonisJS — multi-gateway payments (Stripe, AbacatePay, Asaas, Woovi) with a Cashier-style subscription billing layer: Billable mixin, Lucid stores, idempotent webhook processing and an optional Durable-backed dispatcher. Part of the Agora ecosystem.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DavideCarvalho/adonis-agora-payments.git",
+    "directory": "packages/adonis"
+  },
+  "author": "Davi Carvalho <davi@goflip.ai>",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    },
+    "./services/main": {
+      "types": "./dist/src/services/main.d.ts",
+      "import": "./dist/src/services/main.js",
+      "default": "./dist/src/services/main.js"
+    },
+    "./payments_provider": {
+      "types": "./dist/providers/payments_provider.d.ts",
+      "import": "./dist/providers/payments_provider.js",
+      "default": "./dist/providers/payments_provider.js"
+    },
+    "./configure": {
+      "types": "./dist/configure.d.ts",
+      "import": "./dist/configure.js",
+      "default": "./dist/configure.js"
+    },
+    "./commands": {
+      "types": "./dist/commands/main.d.ts",
+      "import": "./dist/commands/main.js",
+      "default": "./dist/commands/main.js"
+    },
+    "./commands/*": {
+      "types": "./dist/commands/*.d.ts",
+      "import": "./dist/commands/*.js",
+      "default": "./dist/commands/*.js"
+    },
+    "./hooks/webhook_handlers": {
+      "types": "./dist/src/hooks/webhook_handlers.d.ts",
+      "import": "./dist/src/hooks/webhook_handlers.js",
+      "default": "./dist/src/hooks/webhook_handlers.js"
+    },
+    "./testing": {
+      "types": "./dist/src/testing/index.d.ts",
+      "import": "./dist/src/testing/index.js",
+      "default": "./dist/src/testing/index.js"
+    },
+    "./telescope": {
+      "types": "./dist/src/telescope/index.d.ts",
+      "import": "./dist/src/telescope/index.js",
+      "default": "./dist/src/telescope/index.js"
+    },
+    "./drivers/asaas": {
+      "types": "./dist/src/drivers/asaas.d.ts",
+      "import": "./dist/src/drivers/asaas.js",
+      "default": "./dist/src/drivers/asaas.js"
+    },
+    "./drivers/stripe": {
+      "types": "./dist/src/drivers/stripe.d.ts",
+      "import": "./dist/src/drivers/stripe.js",
+      "default": "./dist/src/drivers/stripe.js"
+    },
+    "./drivers/abacate": {
+      "types": "./dist/src/drivers/abacate.d.ts",
+      "import": "./dist/src/drivers/abacate.js",
+      "default": "./dist/src/drivers/abacate.js"
+    },
+    "./drivers/woovi": {
+      "types": "./dist/src/drivers/woovi.d.ts",
+      "import": "./dist/src/drivers/woovi.js",
+      "default": "./dist/src/drivers/woovi.js"
+    },
+    "./types": {
+      "types": "./dist/src/types.d.ts",
+      "import": "./dist/src/types.js",
+      "default": "./dist/src/types.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "@adonis-agora/durable": ">=0.1.0 <1.0.0",
+    "@adonisjs/core": "^7.3.0",
+    "@adonisjs/lucid": "^22.4.0",
+    "@woovi/node-sdk": "^1.0.0",
+    "stripe": "^17.0.0 || ^18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@adonis-agora/durable": {
+      "optional": true
+    },
+    "@adonisjs/lucid": {
+      "optional": true
+    },
+    "@woovi/node-sdk": {
+      "optional": true
+    },
+    "stripe": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@adonisjs/assembler": "^8.5.0",
+    "@adonisjs/core": "7.4.0",
+    "@adonisjs/lucid": "^22.4.0",
+    "@types/luxon": "^3.7.5",
+    "@types/node": "^20.0.0",
+    "@woovi/node-sdk": "^1.0.0",
+    "luxon": "^3.7.2",
+    "stripe": "^18.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "3.2.7"
+  },
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "keywords": [
+    "adonisjs",
+    "adonis",
+    "payments",
+    "billing",
+    "subscriptions",
+    "stripe",
+    "abacatepay",
+    "asaas",
+    "woovi",
+    "openpix",
+    "pix",
+    "agora"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && pnpm run copy:stubs",
+    "copy:stubs": "mkdir -p dist/stubs/config dist/stubs/database/migrations dist/stubs/make/billable dist/stubs/make/webhook_handler && cp -r stubs/config/. dist/stubs/config/ && cp -r stubs/database/migrations/. dist/stubs/database/migrations/ && cp -r stubs/make/billable/. dist/stubs/make/billable/ && cp -r stubs/make/webhook_handler/. dist/stubs/make/webhook_handler/",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}