@lowdefy/docs-content 7.0.0 → 7.1.0
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/content/actions/resetvalidation.md +2 -0
- package/content/actions/setstate.md +0 -2
- package/content/actions/validate.md +1 -1
- package/content/adapter-reference/mongodbauthadapter.md +2 -2
- package/content/agents/agents-introduction.md +1 -1
- package/content/callback-reference/auth0logoutcallback.md +1 -1
- package/content/concepts/ai-agent-docs.md +2 -2
- package/content/concepts/blocks.md +1 -1
- package/content/concepts/connections-and-requests.md +8 -8
- package/content/concepts/custom-html.md +1 -1
- package/content/concepts/logger.md +1 -1
- package/content/concepts/lowdefy-api.md +3 -3
- package/content/concepts/page-and-app-state.md +2 -2
- package/content/concepts/theming.md +1 -1
- package/content/connections/axioshttp.md +1 -1
- package/content/display-blocks/aggrid.md +3 -3
- package/content/migration/v3-to-v4.md +2 -2
- package/content/operators/_ref.md +6 -6
- package/content/provider-reference/auth-js-providers.md +2 -2
- package/content/provider-reference/openidconnectprovider.md +1 -1
- package/content/testing/config-tests.md +2 -2
- package/content/testing/journey-data-sets.md +21 -21
- package/content/tutorial/tutorial-create-page.md +1 -1
- package/content/tutorial/tutorial-requests-api.md +1 -1
- package/content/tutorial/tutorial-requests-sql.md +1 -1
- package/content/tutorial/tutorial-start.md +1 -1
- package/content/user-authentication/auth-configuration.md +9 -9
- package/content/user-authentication/protected-pages-apis.md +4 -4
- package/content/user-authentication/roles.md +2 -2
- package/content/websockets/websocket-publish.md +1 -1
- package/content/websockets/websockets-introduction.md +1 -1
- package/hazards.json +0 -12
- package/index.json +326 -93
- package/package.json +3 -2
- package/scripts/collectImportedFiles.js +80 -0
- package/scripts/recordSourceHashes.js +9 -6
- package/content/learn/showcase.md +0 -8
|
@@ -11,7 +11,7 @@ For a login method to work you must configure **at least one mechanism** (`email
|
|
|
11
11
|
A required signing secret, given as a `_secret` reference:
|
|
12
12
|
|
|
13
13
|
```yaml
|
|
14
|
-
lowdefy:
|
|
14
|
+
lowdefy: 7.0.0
|
|
15
15
|
auth:
|
|
16
16
|
secret:
|
|
17
17
|
_secret: BETTER_AUTH_SECRET
|
|
@@ -24,7 +24,7 @@ Also pin the app's canonical origin — the `url` of the current environment in
|
|
|
24
24
|
Sessions, users, accounts and organizations are stored through an adapter:
|
|
25
25
|
|
|
26
26
|
```yaml
|
|
27
|
-
lowdefy:
|
|
27
|
+
lowdefy: 7.0.0
|
|
28
28
|
auth:
|
|
29
29
|
database:
|
|
30
30
|
id: auth_db
|
|
@@ -46,7 +46,7 @@ See the [MongoDBAuthAdapter](/MongoDBAuthAdapter) reference. Collection names fo
|
|
|
46
46
|
- **Passkeys** — `auth.passkey` (`enabled`, `rpId`, `rpName`).
|
|
47
47
|
|
|
48
48
|
```yaml
|
|
49
|
-
lowdefy:
|
|
49
|
+
lowdefy: 7.0.0
|
|
50
50
|
auth:
|
|
51
51
|
emailAndPassword:
|
|
52
52
|
enabled: true
|
|
@@ -58,7 +58,7 @@ auth:
|
|
|
58
58
|
`auth.email` references an **SMTP connection** by id — the connection owns `from`, `replyTo`, the transport and the delivery filter, and is shared by every auth email flow. There is no inline transport shape. Optionally map individual flows to your own notification templates:
|
|
59
59
|
|
|
60
60
|
```yaml
|
|
61
|
-
lowdefy:
|
|
61
|
+
lowdefy: 7.0.0
|
|
62
62
|
auth:
|
|
63
63
|
email:
|
|
64
64
|
connectionId: email # an SMTP connection in connections[]
|
|
@@ -94,7 +94,7 @@ BetterAuth ships no UI — your app owns its auth pages, and `auth.authPages` po
|
|
|
94
94
|
| `magicLink` | — | landing page for the sign-in email (opt-in; see below) |
|
|
95
95
|
|
|
96
96
|
```yaml
|
|
97
|
-
lowdefy:
|
|
97
|
+
lowdefy: 7.0.0
|
|
98
98
|
auth:
|
|
99
99
|
authPages:
|
|
100
100
|
signIn: /login
|
|
@@ -113,7 +113,7 @@ A verification email links to Better Auth's verify endpoint, which confirms the
|
|
|
113
113
|
Set the key and the sign-in email links to a page of your own instead, with the token and the callback destinations carried on its URL query. Fetching a Lowdefy page is harmless, so the token stays unspent until a real click runs [`MagicLinkVerify`](/MagicLinkVerify):
|
|
114
114
|
|
|
115
115
|
```yaml
|
|
116
|
-
lowdefy:
|
|
116
|
+
lowdefy: 7.0.0
|
|
117
117
|
auth:
|
|
118
118
|
magicLink:
|
|
119
119
|
enabled: true
|
|
@@ -161,7 +161,7 @@ See [Two-Factor Authentication](/two-factor) for the two-factor pages, and the [
|
|
|
161
161
|
Database sessions. Length is `expiresIn` (seconds, default 604800 = 7 days); `updateAge` (default 86400) is how often an active session's expiry is refreshed:
|
|
162
162
|
|
|
163
163
|
```yaml
|
|
164
|
-
lowdefy:
|
|
164
|
+
lowdefy: 7.0.0
|
|
165
165
|
auth:
|
|
166
166
|
session:
|
|
167
167
|
expiresIn: 43200 # 12 hours in seconds
|
|
@@ -177,7 +177,7 @@ auth:
|
|
|
177
177
|
- **API strategies** — `auth.strategies` authenticates non-session callers (server-to-server) with an `apiKey` or a `jwt`:
|
|
178
178
|
|
|
179
179
|
```yaml
|
|
180
|
-
lowdefy:
|
|
180
|
+
lowdefy: 7.0.0
|
|
181
181
|
auth:
|
|
182
182
|
strategies:
|
|
183
183
|
- id: service-key
|
|
@@ -231,7 +231,7 @@ Add the `auth.dev.mockUser` section to your `lowdefy.yaml`:
|
|
|
231
231
|
|
|
232
232
|
###### Configure a mock user for development
|
|
233
233
|
```yaml
|
|
234
|
-
lowdefy:
|
|
234
|
+
lowdefy: 7.0.0
|
|
235
235
|
|
|
236
236
|
auth:
|
|
237
237
|
providers:
|
|
@@ -14,7 +14,7 @@ The 404 page (used to indicate that a requested page cannot be found) is always
|
|
|
14
14
|
|
|
15
15
|
###### List specific public pages and APIs:
|
|
16
16
|
```yaml
|
|
17
|
-
lowdefy:
|
|
17
|
+
lowdefy: 7.0.0
|
|
18
18
|
auth:
|
|
19
19
|
pages:
|
|
20
20
|
protected: true
|
|
@@ -31,7 +31,7 @@ auth:
|
|
|
31
31
|
|
|
32
32
|
###### List specific protected pages and APIs:
|
|
33
33
|
```yaml
|
|
34
|
-
lowdefy:
|
|
34
|
+
lowdefy: 7.0.0
|
|
35
35
|
auth:
|
|
36
36
|
pages:
|
|
37
37
|
public: true
|
|
@@ -47,7 +47,7 @@ auth:
|
|
|
47
47
|
|
|
48
48
|
###### Mixed configuration:
|
|
49
49
|
```yaml
|
|
50
|
-
lowdefy:
|
|
50
|
+
lowdefy: 7.0.0
|
|
51
51
|
auth:
|
|
52
52
|
# Protect specific pages while keeping most public
|
|
53
53
|
pages:
|
|
@@ -75,7 +75,7 @@ Exact page IDs still work: `home`, `team-users/users-list`.
|
|
|
75
75
|
|
|
76
76
|
###### Wildcard pattern example:
|
|
77
77
|
```yaml
|
|
78
|
-
lowdefy:
|
|
78
|
+
lowdefy: 7.0.0
|
|
79
79
|
auth:
|
|
80
80
|
pages:
|
|
81
81
|
protected: true
|
|
@@ -7,7 +7,7 @@ Roles are read from the `roles` field on the [user object](/user-object) — an
|
|
|
7
7
|
Declare the role names your app uses in `auth.roles` (id, optional label and description) so tooling can list them:
|
|
8
8
|
|
|
9
9
|
```yaml
|
|
10
|
-
lowdefy:
|
|
10
|
+
lowdefy: 7.0.0
|
|
11
11
|
auth:
|
|
12
12
|
roles:
|
|
13
13
|
- id: user-admin
|
|
@@ -24,7 +24,7 @@ Similarly, the API endpoints that are protected by roles are configured in the `
|
|
|
24
24
|
|
|
25
25
|
###### Protect pages and API endpoints using roles:
|
|
26
26
|
```yaml
|
|
27
|
-
lowdefy:
|
|
27
|
+
lowdefy: 7.0.0
|
|
28
28
|
auth:
|
|
29
29
|
pages:
|
|
30
30
|
public: true
|
package/hazards.json
CHANGED
|
@@ -40,17 +40,5 @@
|
|
|
40
40
|
"appliesTo": { "types": [":reject"] },
|
|
41
41
|
"message": ":reject is the routine's reply, not an exception. A :catch never runs for it, :finally does, and :throw is the caught path.",
|
|
42
42
|
"see": "controls/reject"
|
|
43
|
-
},
|
|
44
|
-
{
|
|
45
|
-
"id": "setstate-parent-keeps-hidden-inputs",
|
|
46
|
-
"appliesTo": { "types": ["SetState"] },
|
|
47
|
-
"message": "Setting a parent object to {} or null does not clear an input that is hidden at that moment: the input keeps its last value and writes it back to state when it shows again. Set each input's own key to null instead.",
|
|
48
|
-
"see": "actions/setstate"
|
|
49
|
-
},
|
|
50
|
-
{
|
|
51
|
-
"id": "validate-no-cascade",
|
|
52
|
-
"appliesTo": { "types": ["Validate", "ResetValidation"] },
|
|
53
|
-
"message": "blockIds match exact block IDs and do not cascade to child blocks. A container's ID, or an ID that matches no block, validates nothing and succeeds. Match the inputs instead, for example regex: ^contact\\. for the inputs under contact.",
|
|
54
|
-
"see": "actions/validate"
|
|
55
43
|
}
|
|
56
44
|
]
|