chore(main): release 3.3.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.2.1"
+  ".": "3.3.0"
 }

CHANGELOG.md

@@ -4,6 +4,13 @@
 
 - publish the npmjs package through the official npm provenance path
 
+## [3.3.0](https://github.com/alexasomba/better-auth-paystack/compare/v3.2.1...v3.3.0) (2026-08-22)
+
+
+### Features
+
+* consolidate Paystack billing and example parity ([4e355f6](https://github.com/alexasomba/better-auth-paystack/commit/4e355f6ad4638bd79b015da65cad710c6e4b5416))
+
 ## [3.2.1](https://github.com/alexasomba/better-auth-paystack/compare/v3.2.0...v3.2.1) (2026-08-05)
 
 

_artifacts/domain_map.yaml

@@ -1,6 +1,6 @@
 library:
   name: better-auth-paystack
-  version: 3.2.1
+  version: 3.3.0
   repository: https://github.com/alexasomba/better-auth-paystack
   description: >-
     Paystack billing plugin for Better Auth with subscriptions, transactions,

_artifacts/skill_tree.yaml

@@ -1,6 +1,6 @@
 library:
   name: better-auth-paystack
-  version: 3.2.1
+  version: 3.3.0
   repository: https://github.com/alexasomba/better-auth-paystack
   license: MIT
   compatibility: >-

package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-auth-paystack",
-  "version": "4.0.0",
+  "version": "3.3.0",
   "description": "Production-ready Paystack billing plugin for Better Auth. Supports subscriptions, one-time payments, organization billing, secure webhooks and more",
   "keywords": [
     "africa",

skills/better-auth-paystack-setup/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Configure better-auth-paystack with Better Auth. Use when adding the paystack() server plugin, paystackClient() client plugin, schema overrides, products/plans, webhook verification, or canonical authClient.paystack/subscription/transaction actions.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-billing-flows/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Build Paystack transaction and subscription flows with better-auth-paystack. Use for initialize/verify transaction, create/upgrade/cancel/restore/list subscriptions, products/plans, billing portal links, webhooks, reconcilePaystackTransaction, chargeSubscriptionRenewal, syncPaystackProducts, and syncPaystackPlans.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-catalog-limits/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Configure products, Paystack-native plans, local-managed plans, free trials, seat billing, resource limits, and catalog sync in better-auth-paystack. Use when tasks mention planCode, freeTrial, trial eligibility, seatAmount, seatPlanCode, limits, products, syncPaystackProducts, or syncPaystackPlans.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-client-api/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Modify or use the better-auth-paystack browser client API. Use for paystackClient(), authClient.paystack, authClient.transaction, authClient.subscription, initializeTransaction, verifyTransaction, listTransactions, listSubscriptions, listProducts, listPlans, subscription billingPortal/manageLink, cancel/restore methods, BetterFetch throw option return types, and legacy disable/enable aliases.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-local-subscriptions/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Implement, debug, or test local-managed subscription behavior in better-auth-paystack. Use for local plans without planCode, saved authorization renewal, chargeSubscriptionRenewal, seat billing, prorateAndCharge, pendingPlan, LOC_ subscription codes, trial transitions, schedule-at-period-end upgrades, and Paystack-managed vs local-managed behavior.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-organization-billing/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Configure organization billing in better-auth-paystack. Use for organization.enabled, Better Auth organization plugin setup, owner/admin default billing authorization, organization.billingRoles, subscription.authorizeReference, organization Paystack customers, seats, invitations, members, and team limits.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-schema-migrations/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Modify or review better-auth-paystack database schema behavior. Use for paystackProduct, paystackPlan, paystackTransaction, subscription, user.paystackCustomerCode, organization.paystackCustomerCode/email, Better Auth schema overrides, mergeSchema behavior, migrations, indexes, unique fields, and backward-compatible table or field changes.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-tanstack-start/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Integrate better-auth-paystack in TanStack Start. Use for Better Auth API routes, tanstackStartCookies(), server functions, getRequestHeaders(), authClient Paystack actions, admin billing server functions, and Cloudflare Workers deployment.
 type: composition
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-testing-fixtures/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Test better-auth-paystack changes. Use for choosing focused vp test commands, Better Auth test clients, in-memory adapters, mocked Paystack SDK responses, webhook signatures, TanStack example tests, integration tests, type-safety tests, and verification before landing changes.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

skills/paystack-webhooks-events/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Implement, debug, or test better-auth-paystack webhook handling. Use for Paystack webhook signatures, secretKey verification, trusted IP checks, charge.success, reconcilePaystackTransaction, subscription.create, subscription.disable, subscription.enable, product quantity updates, subscription status changes, metadata parsing, and event hooks.
 type: core
 library: "better-auth-paystack"
-library_version: "3.2.1" # x-release-please-version
+library_version: "3.3.0" # x-release-please-version
 license: "MIT"
 compatibility: "Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; better-auth-paystack >=3.0.0 <4.0.0"
 sources:

src/version.ts

@@ -1 +1 @@
-export const PACKAGE_VERSION = "4.0.0"; // x-release-please-version
+export const PACKAGE_VERSION = "3.3.0"; // x-release-please-version