@coswic/aipay 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @coswic/aipay
 
+## 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,15 @@ 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: signing in with a Google account for the first time creates an account while self sign-up seats last; once they are full, only invited emails can create an account. 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.
+
 ## Commands
 
 | Command | What it does |
@@ -112,4 +121,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.1",
   "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.1"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",