@coswic/aipay 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @coswic/aipay
 
+## 0.7.2 — 2026-10-09
+
+- README: describe AI-Pay's invitation-only beta instead of self sign-up seats (only invited users can create an account; public registration is not open; your users must be invited before their first sign-in through your app; production does not accept top-ups at the moment), and explain what `aipay test` and the developer commands do when the user or the developer account is not invited. No behavior change.
+- Depends on `@coswic/aipay-sdk` ^0.4.2 (documentation release).
+
+## 0.7.1 — 2026-09-30
+
+- `aipay test`: when the completion step returns 402 `insufficient_balance`, the hint now says nothing was charged and that the app should tell the user their AI credit is insufficient, instead of telling the developer to top up in the Console.
+- README: describe AI-Pay's free beta instead of invited testing (production does not accept top-ups at the moment), point to the environment's own API base and authorization server, and link the product and developer documentation.
+
+## 0.7.0 — 2026-09-11
+
+- `aipay region set` accepts a full US address (`--line1`, `--line2`, `--city`, `--zip`, required for US accounts), and `aipay region` shows the address and the resolved sales-tax jurisdiction.
+
+## 0.6.0 — 2026-09-11
+
+- Add `aipay region` and `aipay region set --country CC [--state US-XX] --accept-terms` to declare the developer account's region non-interactively; a `403 region_required` from the developer API is reported with the fix.
+
 ## 0.5.0 — 2026-09-08
 
 - Add `apps callbacks list/add/remove` with the developer’s own management authorization and linked-project defaults.

package/README.md

@@ -9,6 +9,17 @@ npx @coswic/aipay@latest init --app <client_id> --auth <authorization server> --
 npx @coswic/aipay test
 ```
 
+## Documentation and links
+
+- **Developer guide**: https://ai-pay.coswic.ai/docs?lang=en — the CLI section lists every command; its Markdown edition (https://ai-pay.coswic.ai/docs.md?lang=en) is what `aipay init` saves as `aipay-agent.md` for your coding agent.
+- **SDK**: [`@coswic/aipay-sdk`](https://www.npmjs.com/package/@coswic/aipay-sdk) — installed by `aipay init`.
+- **Models and prices**: https://ai-pay.coswic.ai/models?lang=en · **API contract**: https://ai-pay.coswic.ai/openapi.yaml
+- **Product overview and what is open today**: https://ai-pay.coswic.ai/about?lang=en
+
+AI-Pay's production environment is in a free beta limited to invited users: only invited users can create an account and use the service, public registration is not open, and your users must also be invited before their first sign-in through your app's "Sign in with AI-Pay". Production does not accept top-ups at the moment. `<api base>` and `<authorization server>` are the endpoints of the environment you integrate with — the developer guide fetched from that environment has both filled in.
+
+`aipay test` signs in as a real user: during the invitation-only beta that user must already hold an invitation (and have accepted the latest Terms), otherwise the sign-in never reaches the callback and `test` ends with the loopback timeout. The developer account you use with `aipay login` must be invited too; otherwise the developer commands keep answering 401 ("run `aipay login` again").
+
 ## Commands
 
 | Command | What it does |
@@ -112,4 +123,9 @@ pnpm --filter @coswic/aipay test
 pnpm --filter @coswic/aipay build
 ```
 
+Tests use a fresh temporary token directory and force file storage for each case, so a local
+developer login or OS keychain cannot affect the suite. Tests that pass an explicit `env`
+must also provide a temporary `AIPAY_CONFIG_DIR` and `AIPAY_TOKEN_STORE=file`; an empty
+`env` falls back to the real home directory. Temporary credentials are removed after each test.
+
 Zero runtime dependencies besides the SDK. Node 20+.

package/dist/commands/test.js

@@ -120,7 +120,7 @@ export async function runTest(args, out, deps = {}) {
         catch (e) {
             if (e instanceof InsufficientBalanceError) {
                 result.completion = { error: 'insufficient_balance' };
-                out.line('warn', 'signed in fine, but this account has no balance for a completion — top up in the Console and rerun');
+                out.line('warn', 'signed in fine, but this account does not have enough AI credit for a completion (402 insufficient_balance; nothing was charged) — in your app, tell the user their AI credit is insufficient; rerun with an account that has credit');
                 await reportSetupEvent(project.app.client_id, 'cli.test', { ok: false, error_code: 'insufficient_balance' }, out, env);
                 out.result(result);
                 return EXIT.problem;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@coswic/aipay",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "AI-Pay CLI — developer sign-in, App and callback management, project integration, diagnostics, and real sign-in + AI receipt verification.",
   "license": "MIT",
+  "homepage": "https://ai-pay.coswic.ai/docs?lang=en",
   "type": "module",
   "bin": {
     "aipay": "./dist/bin.js"
@@ -25,7 +26,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@coswic/aipay-sdk": "^0.3.2"
+    "@coswic/aipay-sdk": "^0.4.2"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",