@quickback-dev/cli 0.65.0 → 0.65.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +1 -1
- package/dist/skill/docs/changelog/index.md +30 -0
- package/dist/skill/docs/configure/domains.md +11 -0
- package/dist/skill/docs/define/sealed-protocol.md +1 -1
- package/dist/skill/docs/platform/auth/plugins/index.md +9 -2
- package/package.json +1 -1
- package/src/skill/docs/changelog/index.md +30 -0
- package/src/skill/docs/configure/domains.md +11 -0
- package/src/skill/docs/define/sealed-protocol.md +1 -1
- package/src/skill/docs/platform/auth/plugins/index.md +9 -2
package/dist/index.js
CHANGED
|
@@ -8,6 +8,36 @@ The current release series. Older entries are archived by version range:
|
|
|
8
8
|
- [v0.20 – v0.29](/changelog/v0.2x)
|
|
9
9
|
- [v0.18 and earlier](/changelog/v0.1x)
|
|
10
10
|
|
|
11
|
+
## v0.65.x — August 16, 2026
|
|
12
|
+
|
|
13
|
+
### Passkeys no longer silently degrade to `rpID: 'localhost'`
|
|
14
|
+
|
|
15
|
+
The generated passkey plugin (and the SEALED reveal step-up, which must verify
|
|
16
|
+
against the same relying party) now bakes a compile-time fallback derived from
|
|
17
|
+
your configured domain — `account.domain` when set, else the unified host.
|
|
18
|
+
`ACCOUNT_URL` remains a runtime override, and its **bare origin** is now used
|
|
19
|
+
for WebAuthn even when the value carries a path (`https://host/account`), so
|
|
20
|
+
one variable serves both the email link base and the relying-party origin.
|
|
21
|
+
The rpID derivation also stops stripping two-label hostnames to a bare TLD
|
|
22
|
+
(`example.com` no longer became rpID `com`). `localhost` now applies only to
|
|
23
|
+
projects with no configured domain at all.
|
|
24
|
+
|
|
25
|
+
### `APP_URL` — per-deploy override for `account.appUrl`
|
|
26
|
+
|
|
27
|
+
`account.appUrl` is baked at compile time into the Account SPA runtime config
|
|
28
|
+
and the "Go To App" email CTAs, which pointed preview/dev deploys at
|
|
29
|
+
production. Set `APP_URL` on the deploy target to override both at serve
|
|
30
|
+
time — same one-bundle-several-hostnames pattern as `EXTRA_APP_HOSTS` and
|
|
31
|
+
`BETTER_AUTH_URL`.
|
|
32
|
+
|
|
33
|
+
### Account SPA keeps its `/account` basepath through login redirects
|
|
34
|
+
|
|
35
|
+
On path-mounted deployments, a post-login redirect could navigate to a bare
|
|
36
|
+
path (`/dashboard` instead of `/account/dashboard`) and fall through to a
|
|
37
|
+
tenant route. The callback sanitizer now re-applies the basepath to
|
|
38
|
+
same-origin paths, covering every sign-in flow (password, passkey, email OTP,
|
|
39
|
+
signup) and social-link callbacks.
|
|
40
|
+
|
|
11
41
|
## v0.65.0 — August 16, 2026
|
|
12
42
|
|
|
13
43
|
### All Quickback auth plugins are now bundled — zero `@quickback-dev/*` npm dependencies
|
|
@@ -287,6 +287,17 @@ Mirrors the existing `BETTER_AUTH_URL` auto-trust behavior, where the deployed w
|
|
|
287
287
|
> When more than one app is hostname-mounted, extras attach to the first registered apps middleware (Hono runs middleware in registration order and terminates on first match). If you need extras to route to a specific app in a multi-app deploy, set `apps[*].domain` directly and recompile rather than using this env var.
|
|
288
288
|
|
|
289
289
|
|
|
290
|
+
### Per-deploy app URL
|
|
291
|
+
|
|
292
|
+
`account.appUrl` is baked at compile time into the Account SPA's runtime config and used as the "Go To App" link base in transactional emails — so a preview or dev worker would send emails and render links pointing at production. Set `APP_URL` on the deploy target to override both at serve time: the worker merges it into the runtime config injected into every served shell, and email templates prefer it over `ACCOUNT_URL`.
|
|
293
|
+
|
|
294
|
+
```toml title="wrangler.preview.toml"
|
|
295
|
+
[vars]
|
|
296
|
+
APP_URL = "https://app-preview.example.com"
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
Unset means zero behavior change. (Setting it changes the injected runtime-config bytes, so a strict-CSP deploy relying on the precomputed script hash should keep it unset on the production target — the same tradeoff as named-dev host injection.)
|
|
300
|
+
|
|
290
301
|
## See Also
|
|
291
302
|
|
|
292
303
|
- [Configuration](/configure) — CMS and Account config options
|
|
@@ -269,7 +269,7 @@ When the passkey plugin is enabled, `/reveal` verifies a WebAuthn assertion whos
|
|
|
269
269
|
| Field | Value |
|
|
270
270
|
|---|---|
|
|
271
271
|
| `challenge` | the `/challenge` `nonce` **as the base64url string** (the client signs the b64url text, the server passes `expectedChallenge = nonce`) |
|
|
272
|
-
| `rpID` | the passkey plugin's `rpID` — i.e. `crossSubDomainCookies.domain` (leading dot stripped) when configured, else the host of `env.ACCOUNT_URL
|
|
272
|
+
| `rpID` | the passkey plugin's `rpID` — i.e. `crossSubDomainCookies.domain` (leading dot stripped) when configured, else the registrable host of `env.ACCOUNT_URL`, else the compile-time account origin (both emissions share one resolution, so they cannot skew) |
|
|
273
273
|
| `userVerification` | **required** (`requireUserVerification: true` — a reveal is a deliberate re-auth) |
|
|
274
274
|
| origin | the resolved account origin (mirrors the `passkey({ rpID, origin })` plugin) |
|
|
275
275
|
|
|
@@ -193,8 +193,15 @@ auth: defineAuth("better-auth", {
|
|
|
193
193
|
}),
|
|
194
194
|
```
|
|
195
195
|
|
|
196
|
-
**
|
|
197
|
-
|
|
196
|
+
**Relying party resolution:**
|
|
197
|
+
|
|
198
|
+
WebAuthn needs a relying party ID and origin. The generated plugin resolves them in this order:
|
|
199
|
+
|
|
200
|
+
1. `advanced.crossSubDomainCookies.domain` (leading dot stripped) becomes the `rpID` when configured — credentials then work across sibling subdomains.
|
|
201
|
+
2. The `ACCOUNT_URL` env var, when set on the deploy target: `rpID` is its registrable hostname (`account.example.com` → `example.com`; a two-label host like `example.com` is kept whole) and the origin is its **bare origin** — a path suffix such as `/account` is dropped, so the same variable can keep serving as the email link base.
|
|
202
|
+
3. The compile-time account origin — `account.domain` when configured, else the project's unified host. Baked automatically; no env var required.
|
|
203
|
+
|
|
204
|
+
`rpID: 'localhost'` applies only when the project has no configured domain at all (pure local dev). If passkey registration returns 500 on a deployed worker, check that one of the three sources above resolves to the hostname the Account UI is actually served from.
|
|
198
205
|
|
|
199
206
|
**Endpoints:**
|
|
200
207
|
- `POST /auth/v1/passkey/register/options` - Get registration challenge
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@quickback-dev/cli",
|
|
3
|
-
"version": "0.65.
|
|
3
|
+
"version": "0.65.1",
|
|
4
4
|
"description": "CLI for Quickback — define your backend in TypeScript, compile to a fully wired Cloudflare Worker (or Bun / Node) with auth, database, migrations, security, CMS, and Account UI.",
|
|
5
5
|
"author": "Kardoe Incorporated <paul@kardoe.com>",
|
|
6
6
|
"license": "MIT",
|
|
@@ -8,6 +8,36 @@ The current release series. Older entries are archived by version range:
|
|
|
8
8
|
- [v0.20 – v0.29](/changelog/v0.2x)
|
|
9
9
|
- [v0.18 and earlier](/changelog/v0.1x)
|
|
10
10
|
|
|
11
|
+
## v0.65.x — August 16, 2026
|
|
12
|
+
|
|
13
|
+
### Passkeys no longer silently degrade to `rpID: 'localhost'`
|
|
14
|
+
|
|
15
|
+
The generated passkey plugin (and the SEALED reveal step-up, which must verify
|
|
16
|
+
against the same relying party) now bakes a compile-time fallback derived from
|
|
17
|
+
your configured domain — `account.domain` when set, else the unified host.
|
|
18
|
+
`ACCOUNT_URL` remains a runtime override, and its **bare origin** is now used
|
|
19
|
+
for WebAuthn even when the value carries a path (`https://host/account`), so
|
|
20
|
+
one variable serves both the email link base and the relying-party origin.
|
|
21
|
+
The rpID derivation also stops stripping two-label hostnames to a bare TLD
|
|
22
|
+
(`example.com` no longer became rpID `com`). `localhost` now applies only to
|
|
23
|
+
projects with no configured domain at all.
|
|
24
|
+
|
|
25
|
+
### `APP_URL` — per-deploy override for `account.appUrl`
|
|
26
|
+
|
|
27
|
+
`account.appUrl` is baked at compile time into the Account SPA runtime config
|
|
28
|
+
and the "Go To App" email CTAs, which pointed preview/dev deploys at
|
|
29
|
+
production. Set `APP_URL` on the deploy target to override both at serve
|
|
30
|
+
time — same one-bundle-several-hostnames pattern as `EXTRA_APP_HOSTS` and
|
|
31
|
+
`BETTER_AUTH_URL`.
|
|
32
|
+
|
|
33
|
+
### Account SPA keeps its `/account` basepath through login redirects
|
|
34
|
+
|
|
35
|
+
On path-mounted deployments, a post-login redirect could navigate to a bare
|
|
36
|
+
path (`/dashboard` instead of `/account/dashboard`) and fall through to a
|
|
37
|
+
tenant route. The callback sanitizer now re-applies the basepath to
|
|
38
|
+
same-origin paths, covering every sign-in flow (password, passkey, email OTP,
|
|
39
|
+
signup) and social-link callbacks.
|
|
40
|
+
|
|
11
41
|
## v0.65.0 — August 16, 2026
|
|
12
42
|
|
|
13
43
|
### All Quickback auth plugins are now bundled — zero `@quickback-dev/*` npm dependencies
|
|
@@ -287,6 +287,17 @@ Mirrors the existing `BETTER_AUTH_URL` auto-trust behavior, where the deployed w
|
|
|
287
287
|
> When more than one app is hostname-mounted, extras attach to the first registered apps middleware (Hono runs middleware in registration order and terminates on first match). If you need extras to route to a specific app in a multi-app deploy, set `apps[*].domain` directly and recompile rather than using this env var.
|
|
288
288
|
|
|
289
289
|
|
|
290
|
+
### Per-deploy app URL
|
|
291
|
+
|
|
292
|
+
`account.appUrl` is baked at compile time into the Account SPA's runtime config and used as the "Go To App" link base in transactional emails — so a preview or dev worker would send emails and render links pointing at production. Set `APP_URL` on the deploy target to override both at serve time: the worker merges it into the runtime config injected into every served shell, and email templates prefer it over `ACCOUNT_URL`.
|
|
293
|
+
|
|
294
|
+
```toml title="wrangler.preview.toml"
|
|
295
|
+
[vars]
|
|
296
|
+
APP_URL = "https://app-preview.example.com"
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
Unset means zero behavior change. (Setting it changes the injected runtime-config bytes, so a strict-CSP deploy relying on the precomputed script hash should keep it unset on the production target — the same tradeoff as named-dev host injection.)
|
|
300
|
+
|
|
290
301
|
## See Also
|
|
291
302
|
|
|
292
303
|
- [Configuration](/configure) — CMS and Account config options
|
|
@@ -269,7 +269,7 @@ When the passkey plugin is enabled, `/reveal` verifies a WebAuthn assertion whos
|
|
|
269
269
|
| Field | Value |
|
|
270
270
|
|---|---|
|
|
271
271
|
| `challenge` | the `/challenge` `nonce` **as the base64url string** (the client signs the b64url text, the server passes `expectedChallenge = nonce`) |
|
|
272
|
-
| `rpID` | the passkey plugin's `rpID` — i.e. `crossSubDomainCookies.domain` (leading dot stripped) when configured, else the host of `env.ACCOUNT_URL
|
|
272
|
+
| `rpID` | the passkey plugin's `rpID` — i.e. `crossSubDomainCookies.domain` (leading dot stripped) when configured, else the registrable host of `env.ACCOUNT_URL`, else the compile-time account origin (both emissions share one resolution, so they cannot skew) |
|
|
273
273
|
| `userVerification` | **required** (`requireUserVerification: true` — a reveal is a deliberate re-auth) |
|
|
274
274
|
| origin | the resolved account origin (mirrors the `passkey({ rpID, origin })` plugin) |
|
|
275
275
|
|
|
@@ -193,8 +193,15 @@ auth: defineAuth("better-auth", {
|
|
|
193
193
|
}),
|
|
194
194
|
```
|
|
195
195
|
|
|
196
|
-
**
|
|
197
|
-
|
|
196
|
+
**Relying party resolution:**
|
|
197
|
+
|
|
198
|
+
WebAuthn needs a relying party ID and origin. The generated plugin resolves them in this order:
|
|
199
|
+
|
|
200
|
+
1. `advanced.crossSubDomainCookies.domain` (leading dot stripped) becomes the `rpID` when configured — credentials then work across sibling subdomains.
|
|
201
|
+
2. The `ACCOUNT_URL` env var, when set on the deploy target: `rpID` is its registrable hostname (`account.example.com` → `example.com`; a two-label host like `example.com` is kept whole) and the origin is its **bare origin** — a path suffix such as `/account` is dropped, so the same variable can keep serving as the email link base.
|
|
202
|
+
3. The compile-time account origin — `account.domain` when configured, else the project's unified host. Baked automatically; no env var required.
|
|
203
|
+
|
|
204
|
+
`rpID: 'localhost'` applies only when the project has no configured domain at all (pure local dev). If passkey registration returns 500 on a deployed worker, check that one of the three sources above resolves to the hostname the Account UI is actually served from.
|
|
198
205
|
|
|
199
206
|
**Endpoints:**
|
|
200
207
|
- `POST /auth/v1/passkey/register/options` - Get registration challenge
|