openreceive 0.4.23 → 0.4.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb5542a9163a02e90baa6f8938172785600029980002c119fde4631b452da20c
-  data.tar.gz: 7f71eb77da79968df633485d01ca9e7a89bbd839186a1daf1d137323f889daba
+  metadata.gz: 92de70ca1044470b160698913fc4bcec615f0529de243fc7df86eddcd6d7cf95
+  data.tar.gz: e390588c785aa70eb0641f34e31d6953886592db3c2c24ddd67f8e17e797a1ea
 SHA512:
-  metadata.gz: 75465da88449b28ff097b5b4a4d7eadb141e2ba8be2a1e4797ae021fd23ba876df3b50cbef86e7afb0b05df4f718e957dd78a5c4979cda2558e79bb9642c20c4
-  data.tar.gz: 90884d4fef6027acb5919a5a9d36c0e7d1ba066d13d21db1793c940dad7c2c6653288a26efb0540eccb7b7baf37a4817e99d3826fb58af034aa594bc303ff260
+  metadata.gz: 2a14369f2156c50c446260eafe5d4915406d90e3a075a547770f2e0f6fcbd44c9c73c2b89ea3c11266b9afde8df7732a45ae5225cc0cc32f966d27bd74f23283
+  data.tar.gz: e6aae3ef1fccb7348e8b48a5150cb2e2d1ba437137256e06adde9c4f37c40666be992dae9c4a63de5ef931551f1afca600470b0af18003ff6c52e63608a904ee

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.4.25 - 2026-10-13
+
+Release with the complete 0.4.25 package family. The bundled agent skill
+adds directions for Flask and NestJS, and every server stack's directions
+link the new guide for mobile apps. No Ruby runtime changes from 0.4.24.
+
+## 0.4.24 - 2026-10-12
+
+Release with the complete 0.4.24 package family. The gem's registry page
+now links openreceive.org's Rails page. The bundled agent skill's
+Lovable directions need `@openreceive/*` 0.4.24, whose Supabase functions
+no longer hang when two requests write one order, and keep the app's own
+order flow. Its FastAPI directions run doctor through `dotenv run` and never
+load `.env` into the shell, and the Node, Next.js, Fastify, FastAPI and Django
+directions link the serverless guide. No Ruby runtime changes from 0.4.23.
+
 ## 0.4.23 - 2026-10-11
 
 Release with the complete 0.4.23 package family. The bundled agent skill adds

data/lib/openreceive/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenReceive
-  VERSION = "0.4.23"
+  VERSION = "0.4.25"
 end

data/skills/integrate-openreceive/SKILL.md

@@ -2,7 +2,7 @@
 name: integrate-openreceive
 description: >
   Integrate OpenReceive Bitcoin Lightning checkout and optional USDT, USDC,
-  SOL, and ETH swaps. Use for Node.js, Express, Fastify, Next.js, Rails,
+  SOL, and ETH swaps. Use for Node.js, Express, Fastify, Next.js, NestJS, Rails,
   Python, Django, FastAPI, Laravel, plain PHP, WordPress/WooCommerce,
   React, Vue, Svelte, Angular, or plain HTML applications, or connecting
   BTCPay Server to a receive-only NWC wallet. A configured swap provider
@@ -32,10 +32,13 @@ connected wallet; asset and network availability depends on the provider.
    - Node, Express: [references/node.md](references/node.md)
    - Node, Fastify: [references/fastify.md](references/fastify.md)
    - Node, Next.js App Router: [references/next.md](references/next.md)
+   - Node, NestJS (Express platform): [references/nestjs.md](references/nestjs.md)
    - Rails: [references/rails.md](references/rails.md)
    - Python, FastAPI: [references/fastapi.md](references/fastapi.md)
    - Plain PHP: [references/php.md](references/php.md)
    - Django: [references/django.md](references/django.md)
+   - Flask: [references/flask.md](references/flask.md) — a one-file Blueprint
+     copied from the quickstart; there is no `openreceive.flask` package.
    - Laravel: [references/laravel.md](references/laravel.md)
    - WordPress + WooCommerce: [references/woocommerce.md](references/woocommerce.md) — the packaged gateway and merchant settings.
    - Lovable (TanStack Start on Cloudflare Workers, with Supabase):
@@ -51,11 +54,12 @@ connected wallet; asset and network availability depends on the provider.
 
 Install, per adapter — Express: `npm install @openreceive/express @openreceive/react`;
 Fastify: `npm install @openreceive/fastify @openreceive/react`; Next.js:
-`npm install @openreceive/next @openreceive/react`. Swap the UI package (`vue`,
+`npm install @openreceive/next @openreceive/react`; NestJS:
+`npm install @openreceive/express @openreceive/http @openreceive/react`. Swap the UI package (`vue`,
 `svelte`, `angular`, `elements`) for the frontend the app already has. Install
 (Rails): `bundle add openreceive-rails`.
 Django: `pip install "openreceive[django]"`; FastAPI:
-`pip install "openreceive[fastapi]"`; Laravel: `composer require openreceive/laravel`;
+`pip install "openreceive[fastapi]"`; Flask: `pip install "openreceive[sqlalchemy]"`; Laravel: `composer require openreceive/laravel`;
 plain PHP: `composer require openreceive/openreceive nyholm/psr7 nyholm/psr7-server`.
 
 ## The three server objects

data/skills/integrate-openreceive/references/btcpay.md

@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/btcpay/full.md
 - Never tick the spend-capable override to make a save succeed.
 - Do not suggest rotating or revoking a code because it was pasted here.
 
-These directions describe OpenReceive 0.4.23.
+These directions describe OpenReceive 0.4.25.
 
 Connect a BTCPay Server store to a receive-only NWC wallet with the OpenReceive
 plugin, and optionally let payers pay BTCPay invoices with USDT, USDC, ETH or

data/skills/integrate-openreceive/references/django.md

@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/django/full.md
 - Do not suggest rotating or revoking a code because it was pasted here.
 - Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
 
-These directions describe OpenReceive 0.4.23.
+These directions describe OpenReceive 0.4.25.
 
 Add OpenReceive to a Django project — the app you are already working in. You
 do not need a copy of the OpenReceive source: the Python package is on PyPI
@@ -389,7 +389,9 @@ enough; drop the `.md` for the same page a person would read.
 - https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
 - https://openreceive.org/guides/storage.md — the engine tables and the attempt state machine
 - https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
+- https://openreceive.org/guides/serverless.md — when the app runs serverless (Netlify, AWS Lambda, Cloud Run, Google AI Studio): pooled database URLs, timeouts, and why it needs no cron or worker
 - https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
+- https://openreceive.org/guides/mobile-apps.md — when a mobile app takes the payment: the checkout page it opens, and what the App Store and Google Play allow
 - https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
 - https://openreceive.org/guides/headless-checkout.md — the controller, the display models, refunds
 - https://openreceive.org/guides/provider-registry.md — where the wallet logos and pay
@@ -405,7 +407,7 @@ enough; drop the `.md` for the same page a person would read.
 - https://openreceive.org/guides/api-reference.md — every route, option and error code
 - https://openreceive.org/guides/custom-checkout-route.md — advanced: replacing the mounted engine's routes with your own
 - https://openreceive.org/guides/react-material-ui-recipe.md — a worked custom UI on a component library
-- https://openreceive.org/guides/flask-recipe.md — the same engine as a Flask Blueprint, if this app is Flask after all
+- https://openreceive.org/agent-directions/flask.md — the same engine as a Flask Blueprint: follow those directions instead if this app is Flask after all
 - https://openreceive.org/guides.md — the index, if what you need is not above
 
 Questions, or a problem with the library itself:

data/skills/integrate-openreceive/references/fastapi.md

@@ -3,7 +3,7 @@ This is the full file; follow it from Step 0.
 # OpenReceive agent directions (FastAPI)
 
 ```sh
-# READ THIS FIRST: this file is 39 KB and a summary drops required steps. Download it whole:
+# READ THIS FIRST: this file is 41 KB and a summary drops required steps. Download it whole:
 curl -fsSL https://openreceive.org/agent-directions/fastapi/full.md
 # Skip the download only if you already have all of it: pasted, read from disk or fetched raw.
 ```
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/fastapi/full.md
 - Do not suggest rotating or revoking a code because it was pasted here.
 - Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
 
-These directions describe OpenReceive 0.4.23.
+These directions describe OpenReceive 0.4.25.
 
 Add OpenReceive to a FastAPI application — the app you are already working in.
 You do not need a copy of the OpenReceive source: the engine is on PyPI
@@ -126,6 +126,11 @@ you store it. Ask one question per message.
    with `uvicorn --env-file .env` (update the app's run script or Procfile, not
    just your own command). When it is started with Docker Compose, give the
    service `env_file: .env`. Restart the server after writing the file.
+   Doctor needs the file too: run it as
+   `dotenv -f .env run -- openreceive doctor …`. The `dotenv` command comes
+   with python-dotenv, which `uvicorn --env-file` already needs; if it is
+   missing, `pip install "python-dotenv[cli]"`. Never `source`, `export` or
+   `cat` the file: the codes contain `&`, and the shell prints the pieces.
 
 Do not invent placeholder URIs. Start the quickstart only once `NWC_URI` is
 saved and `LSC_URI_PRIMARY` is saved or explicitly declined. The first boot
@@ -133,8 +138,9 @@ runs the receive-only preflight: if it reports spend methods such as
 `pay_invoice`, remove `NWC_URI` from `.env` and ask for a receive-only code
 again. Never set the spend-capable override to get past it.
 
-After the router is wired, run `openreceive doctor --app <module>:app`. It
-reports `NWC_URI` presence without printing it, probes the wallet, and names
+After the router is wired, run
+`dotenv -f .env run -- openreceive doctor --app <module>:app`. It reports
+`NWC_URI` presence without printing it, probes the wallet, and names
 any hook still on a placeholder and whether the migration ran. Exit code 1 is a
 finding to fix, not a reason to skip the check.
 
@@ -152,7 +158,8 @@ Only then start the quickstart.
 ## After the quickstart — hand over, then stop
 
 The quickstart is done when
-`openreceive doctor --app <module>:app --url <app url>` is clean and this app
+`dotenv -f .env run -- openreceive doctor --app <module>:app --url <app url>`
+is clean and this app
 serves the checkout page for one of its orders. Doctor names any failed check
 and exits nonzero; fix it before going on.
 
@@ -383,7 +390,9 @@ enough; drop the `.md` for the same page a person would read.
 - https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
 - https://openreceive.org/guides/storage.md — the payment tables and the attempt state machine
 - https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
+- https://openreceive.org/guides/serverless.md — when the app runs serverless (Netlify, AWS Lambda, Cloud Run, Google AI Studio): pooled database URLs, timeouts, and why it needs no cron or worker
 - https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
+- https://openreceive.org/guides/mobile-apps.md — when a mobile app takes the payment: the checkout page it opens, and what the App Store and Google Play allow
 - https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
 - https://openreceive.org/guides/headless-checkout.md — the controller, the display models, refunds
 - https://openreceive.org/guides/provider-registry.md — where the wallet logos and pay
@@ -399,7 +408,7 @@ enough; drop the `.md` for the same page a person would read.
 - https://openreceive.org/guides/api-reference.md — every route, option and error code
 - https://openreceive.org/guides/custom-checkout-route.md — advanced: replacing the shipped adapter's routes with your own
 - https://openreceive.org/guides/react-material-ui-recipe.md — a worked custom UI on a component library
-- https://openreceive.org/guides/flask-recipe.md — the same engine as a Flask Blueprint, if this app is Flask after all
+- https://openreceive.org/agent-directions/flask.md — the same engine as a Flask Blueprint: follow those directions instead if this app is Flask after all
 - https://openreceive.org/guides.md — the index, if what you need is not above
 
 Questions, or a problem with the library itself:
@@ -436,7 +445,7 @@ with the Django quickstart. A page without a bundler uses
 
 |          | Packages                                                                                                                      |
 | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| Server   | `openreceive[fastapi]`, `openreceive[django]`, `openreceive[sqlalchemy]` (Flask and plain WSGI/ASGI: the Flask recipe) |
+| Server   | `openreceive[fastapi]`, `openreceive[django]`, `openreceive[sqlalchemy]` (Flask and plain WSGI/ASGI: [the Flask quickstart](https://openreceive.org/guides/quickstart-flask.md)) |
 | Frontend | `@openreceive/react`, `@openreceive/vue`, `@openreceive/svelte`, `@openreceive/angular`, `@openreceive/elements` (plain HTML) |
 
 Use `uv` or a virtualenv on Python 3.10 or newer. A system Python 3.9 cannot
@@ -658,8 +667,13 @@ send it after commit.
 
 A page without a bundler renders the same checkout as a custom element:
 `<openreceive-checkout reference="…" prefix="/openreceive">` from
-`@openreceive/elements`. You can also serve its standalone build from your
-static directory.
+`@openreceive/elements`. For Jinja templates without a JavaScript build, serve
+its standalone build from your static directory: copy
+`openreceive-checkout.js` and `openreceive-checkout.css` from
+`node_modules/@openreceive/elements/dist/standalone/` to `static/openreceive/`,
+and load both on the checkout page. The `openreceive` package from PyPI carries
+the same two files in `openreceive/django/static/openreceive/`, so you can copy
+them from there without npm.
 
 Buy a Button is a runnable illustration of the boundary
 (`examples/buttons/server/fastapi`).
@@ -671,9 +685,16 @@ shape onto the models in THIS app.
 ### 6. Verify
 
 ```sh
-openreceive doctor --app main:app
+dotenv -f .env run -- openreceive doctor --app main:app
 ```
 
+Doctor reads the process environment. `dotenv -f .env run --` loads `.env`
+into it, as `uvicorn --env-file .env` does for the server. The `dotenv`
+command comes with python-dotenv, which `uvicorn --env-file` needs anyway; if
+it is missing, run `pip install "python-dotenv[cli]"`. Never `source` or
+`export` `.env` in a shell: the codes contain `&`, and the shell splits the
+line and prints the pieces.
+
 `openreceive doctor` checks Python, `NWC_URI`, and swap-provider
 configuration. It also probes the wallet relay to confirm the code is
 receive-only. With `--app module:attr` (your FastAPI app, the router, or an

data/skills/integrate-openreceive/references/fastify.md

@@ -3,7 +3,7 @@ This is the full file; follow it from Step 0.
 # OpenReceive agent directions (Fastify)
 
 ```sh
-# READ THIS FIRST: this file is 38 KB and a summary drops required steps. Download it whole:
+# READ THIS FIRST: this file is 39 KB and a summary drops required steps. Download it whole:
 curl -fsSL https://openreceive.org/agent-directions/fastify/full.md
 # Skip the download only if you already have all of it: pasted, read from disk or fetched raw.
 ```
@@ -17,7 +17,7 @@ curl -fsSL https://openreceive.org/agent-directions/fastify/full.md
 - Do not suggest rotating or revoking a code because it was pasted here.
 - Start the quickstart only once the NWC code is saved, and the LSC code is saved or the user said "Bitcoin only".
 
-These directions describe OpenReceive 0.4.23.
+These directions describe OpenReceive 0.4.25.
 
 Add OpenReceive to a Fastify application — the app you are already working in.
 You do not need a copy of the OpenReceive source: the packages are on npm, and
@@ -372,8 +372,10 @@ enough; drop the `.md` for the same page a person would read.
 - https://openreceive.org/guides/environment-variables.md — every variable, and what is deliberately not one
 - https://openreceive.org/guides/storage.md — the payment tables and the attempt state machine
 - https://openreceive.org/guides/supabase.md — when the database is Supabase: its pooler, its certificate, and locking the tables away from its Data API
+- https://openreceive.org/guides/serverless.md — when the app runs serverless (Netlify, AWS Lambda, Cloud Run, Google AI Studio): pooled database URLs, timeouts, and why it needs no cron or worker
 - https://openreceive.org/guides/node-orms.md — recipes for Prisma, Drizzle, Knex, TypeORM, Sequelize
 - https://openreceive.org/guides/frontend-checkout.md — the drop-in's props, attributes and slots
+- https://openreceive.org/guides/mobile-apps.md — when a mobile app takes the payment: the checkout page it opens, and what the App Store and Google Play allow
 - https://openreceive.org/guides/checkout-ux.md — read before building any custom UI
 - https://openreceive.org/guides/headless-checkout.md — the controller, the display models, refunds
 - https://openreceive.org/guides/provider-registry.md — where the wallet logos and pay