@jskit-ai/agent-docs 0.1.290 → 0.1.292

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.
Files changed (37) hide show
  1. package/guide/agent/app-setup/existing-application-migration.md +1 -1
  2. package/guide/agent/framework/data-access.md +309 -22
  3. package/guide/agent/framework/material-3.md +40 -39
  4. package/guide/agent/framework/sanity-checks.md +19 -12
  5. package/package.json +1 -1
  6. package/patterns/feature-package/example/booking-engine/package.json +1 -1
  7. package/patterns/minimal-foundation/example/package.json +4 -4
  8. package/patterns/shell-foundation/example/package.json +5 -5
  9. package/patterns/shell-foundation/example/packages/main/package.json +1 -1
  10. package/reference/autogen/PATTERN_INDEX.md +38 -38
  11. package/reference/autogen/packages/agent-runtime.md +4 -0
  12. package/reference/autogen/packages/crud-core.md +1 -1
  13. package/reference/autogen/packages/kernel.md +1 -1
  14. package/reference/autogen/packages/resource-core.md +1 -0
  15. package/reference/autogen/packages/resource-runtime.md +39 -3
  16. package/reference/autogen/packages/workspaces-core.md +0 -2
  17. package/reference/autogen/tooling/jskit-catalog.md +30 -10
  18. package/skills/jskit/references/data-access.md +309 -22
  19. package/skills/jskit/references/existing-application-migration.md +1 -1
  20. package/skills/jskit/references/heuristics/ui-testing.md +6 -3
  21. package/skills/jskit/references/material-3.md +40 -39
  22. package/skills/jskit/references/pattern-index.md +38 -38
  23. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +4 -4
  24. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +5 -5
  25. package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
  26. package/skills/jskit/references/patterns/auth/accounts-hub/example/package.json +3 -3
  27. package/skills/jskit/references/patterns/auth/oidc-sign-in/example/package.json +2 -2
  28. package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
  29. package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
  30. package/skills/jskit/references/patterns/crud/crud-feature-package/example/packages/books/package.json +3 -3
  31. package/skills/jskit/references/patterns/database/mysql-application/example/package.json +2 -2
  32. package/skills/jskit/references/patterns/database/postgres-application/example/package.json +2 -2
  33. package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
  34. package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
  35. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +3 -3
  36. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +6 -6
  37. package/skills/jskit/references/sanity-checks.md +19 -12
@@ -4,9 +4,9 @@
4
4
 
5
5
  Before calling a list, a save, a test, a refactor, a screen or a deployment
6
6
  done, measure what it costs and does, judge whether that is sane, and fix the
7
- cause when it is not. This page holds JSKIT's part: the pitfalls JSKIT's own
7
+ cause when it is not. This page holds JSKIT's part: the pitfalls its own
8
8
  packages cause, then the JSKIT call, helper or setting that applies each
9
- check, with one line on what it catches and why.
9
+ check, and what it catches.
10
10
 
11
11
  ## JSKIT's own pitfalls
12
12
 
@@ -67,10 +67,14 @@ expects the relationship id or an unselected field never gets it.
67
67
  ### Every row
68
68
 
69
69
  - A handle's `query()` answers one page and refuses a missing or oversized
70
- `page.size`, because json-rest-api would otherwise cut the list without an
71
- error. A read its callers treat as complete uses `queryAll()`, because the
72
- missing rows otherwise vanish from every picker and delivery built on it
70
+ `page.size`, where json-rest-api would cut the list silently. A read its
71
+ callers treat as complete uses `queryAll()`, or the missing rows vanish from
72
+ every picker and delivery built on it
73
73
  ([Reads](/guide/framework/data-access#reads-shaped-for-the-screen)).
74
+ - A grouped `aggregate()` answers every group or throws
75
+ `RESOURCE_GROUP_LIMIT`; past `pageLimits().request` groups, page it with
76
+ `page: { size, number }`
77
+ ([The handle's calls](/guide/framework/data-access#the-handle-s-calls)).
74
78
  - A lookup by a unique key matches at most one row: `get(id)`, or a `query()`
75
79
  of page size 1.
76
80
 
@@ -79,12 +83,11 @@ expects the relationship id or an unselected field never gets it.
79
83
  - Count a path's queries with `expectFlatQueries()` from
80
84
  `@jskit-ai/resource-runtime/test`, or `countQueries()` from
81
85
  `@jskit-ai/database-runtime/server/testDatabases`, at a few rows and at a
82
- realistic number; the count should follow tables and pages, not rows
86
+ realistic number; it should follow tables and pages, not rows
83
87
  ([Tests](/guide/framework/data-access#tests)).
84
88
  - A JSON:API read adds a few lookup and visibility queries per page and per
85
- relationship field, and json-rest-api reads each relationship's related ids
86
- in one statement however many rows the page has. Both follow pages, not
87
- rows, so `expectFlatQueries` passes them.
89
+ relationship field, and one statement per relationship for its related ids.
90
+ Both follow pages, not rows, so `expectFlatQueries` passes them.
88
91
  - A handle's `get()` or `query()`, or a service `get`, inside a loop is the
89
92
  usual per-row read; batch it with an id-list filter through `queryAll()` or
90
93
  `include`, grouped with `Map.groupBy()`
@@ -108,11 +111,15 @@ expects the relationship id or an unselected field never gets it.
108
111
  `DB_NAME`, because tests write and delete rows and would destroy the
109
112
  developer's data. A skip for want of a test database is a failure.
110
113
  - Test databases restore a stored snapshot checked by a digest of the
111
- migration and seed sources, and the harness reports each preparation phase's
112
- duration, so slow preparation shows ([Test databases are prepared
114
+ migration and seed sources, and the harness times each preparation phase,
115
+ so slow preparation shows ([Test databases are prepared
113
116
  once](/guide/framework/typed-features#test-databases-are-prepared-once),
114
117
  [integration test
115
118
  databases](/guide/app-setup/database-layer#integration-test-databases)).
119
+ - A component's content and states are checked in a Vitest component test;
120
+ a browser check is an assertion in the Playwright spec that already reaches
121
+ that screen. Every Playwright run ends with its 10 slowest tests: compare a
122
+ new test's time, and the suite's, before and after.
116
123
 
117
124
  ### Inputs and access
118
125
 
@@ -135,7 +142,7 @@ Before changing a JSKIT feature, list where its behaviour lives, with the test
135
142
  that covers each item, and walk the list again after: routes, actions and
136
143
  their input schemas, row policies, CRUD fields, lookups and hooks, placements
137
144
  and navigation meta, messages and their codes, events, jobs and migrations.
138
- These are the places a consolidation drops behaviour without a failing build.
145
+ A consolidation drops behaviour there without a failing build.
139
146
 
140
147
  ### Changes others depend on
141
148
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.290",
3
+ "version": "0.1.292",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
@@ -5,7 +5,7 @@
5
5
  "private": true,
6
6
  "type": "module",
7
7
  "dependencies": {
8
- "@jskit-ai/kernel": "0.2.16",
8
+ "@jskit-ai/kernel": "0.2.17",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
@@ -34,8 +34,8 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.2.16",
38
- "@jskit-ai/material-web": "0.1.4",
37
+ "@jskit-ai/kernel": "0.2.17",
38
+ "@jskit-ai/material-web": "0.1.5",
39
39
  "@tanstack/vue-query": "^5.101.0",
40
40
  "fastify": "^5.12.7",
41
41
  "pino": "^10.3.1",
@@ -44,13 +44,13 @@
44
44
  "vue": "^3.5.44",
45
45
  "vue-router": "^5.3.1",
46
46
  "vuetify": "^4.3.0",
47
- "@jskit-ai/http-runtime": "0.2.16",
47
+ "@jskit-ai/http-runtime": "0.2.17",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
49
49
  "@vue/devtools-api": "^8.2.1"
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.248",
53
- "@jskit-ai/jskit-catalog": "0.2.42",
53
+ "@jskit-ai/jskit-catalog": "0.2.44",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "eslint": "^10.8.0",
@@ -34,8 +34,8 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.2.16",
38
- "@jskit-ai/material-web": "0.1.4",
37
+ "@jskit-ai/kernel": "0.2.17",
38
+ "@jskit-ai/material-web": "0.1.5",
39
39
  "@tanstack/vue-query": "^5.101.0",
40
40
  "fastify": "^5.12.7",
41
41
  "pino": "^10.3.1",
@@ -44,14 +44,14 @@
44
44
  "vue": "^3.5.44",
45
45
  "vue-router": "^5.3.1",
46
46
  "vuetify": "^4.3.0",
47
- "@jskit-ai/http-runtime": "0.2.16",
48
- "@jskit-ai/shell-web": "0.2.20",
47
+ "@jskit-ai/http-runtime": "0.2.17",
48
+ "@jskit-ai/shell-web": "0.2.21",
49
49
  "@fastify/fast-json-stringify-compiler": "^5.1.0",
50
50
  "@vue/devtools-api": "^8.2.1"
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.248",
54
- "@jskit-ai/jskit-catalog": "0.2.42",
54
+ "@jskit-ai/jskit-catalog": "0.2.44",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",
@@ -9,7 +9,7 @@
9
9
  },
10
10
  "description": "App-local runtime composition and lightweight glue.",
11
11
  "dependencies": {
12
- "@jskit-ai/kernel": "0.2.16"
12
+ "@jskit-ai/kernel": "0.2.17"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.290`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.292`
19
19
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.290`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.292`
30
30
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
32
32
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.2.36`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.38`
41
41
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -48,7 +48,7 @@ Run one OpenID Connect sign-in for all of an owner's apps as its own JSKIT proje
48
48
 
49
49
  - Id: `auth/accounts-hub`
50
50
  - Keywords: `accounts hub`, `auth`, `authentication`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
51
- - Owner: `@jskit-ai/oidc-issuer-core@0.1.24`
51
+ - Owner: `@jskit-ai/oidc-issuer-core@0.1.25`
52
52
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/accounts-hub/PATTERN.md)
53
53
  - Examples: [example/](../../skills/jskit/references/patterns/auth/accounts-hub/example/)
54
54
  - Requires: `@jskit-ai/oidc-issuer-core`
@@ -59,7 +59,7 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
59
59
 
60
60
  - Id: `auth/auth-surface`
61
61
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
62
- - Owner: `@jskit-ai/auth-web@0.2.22`
62
+ - Owner: `@jskit-ai/auth-web@0.2.23`
63
63
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
64
64
  - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
65
65
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -70,7 +70,7 @@ Let people sign in with the accounts they already have in an accounts hub or ano
70
70
 
71
71
  - Id: `auth/oidc-sign-in`
72
72
  - Keywords: `accounts hub`, `auth`, `authentication`, `back-channel logout`, `dynamic client registration`, `issuer`, `master login`, `oidc`, `openid connect`, `single sign-on`, `sso`
73
- - Owner: `@jskit-ai/auth-provider-oidc-core@0.2.24`
73
+ - Owner: `@jskit-ai/auth-provider-oidc-core@0.2.25`
74
74
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/oidc-sign-in/PATTERN.md)
75
75
  - Examples: [example/](../../skills/jskit/references/patterns/auth/oidc-sign-in/example/)
76
76
  - Requires: `@jskit-ai/auth-provider-oidc-core`, `@jskit-ai/auth-web`
@@ -81,7 +81,7 @@ Add Supabase authentication through normal npm composition, explicit environment
81
81
 
82
82
  - Id: `auth/supabase-auth`
83
83
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
84
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.2.18`
84
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.2.19`
85
85
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
86
86
  - Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
87
87
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -92,7 +92,7 @@ Resolve an administrator environment key or an individual user's grant, then use
92
92
 
93
93
  - Id: `connectors/ai-connections`
94
94
  - Keywords: `ai`, `api-key`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
95
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
96
96
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/ai-connections/PATTERN.md)
97
97
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/ai-connections/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
103
103
 
104
104
  - Id: `connectors/api-key-connection`
105
105
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
106
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
107
107
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/api-key-connection/PATTERN.md)
108
108
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/api-key-connection/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
114
114
 
115
115
  - Id: `connectors/assistant-mcp`
116
116
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
117
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
118
118
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp/PATTERN.md)
119
119
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
125
125
 
126
126
  - Id: `connectors/assistant-mcp-oauth`
127
127
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
128
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
128
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
129
129
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/PATTERN.md)
130
130
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/example/)
131
131
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -136,7 +136,7 @@ Compose signed AWS operations, file configuration and application authorization
136
136
 
137
137
  - Id: `connectors/aws-storage-queries`
138
138
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
139
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
140
140
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/aws-storage-queries/PATTERN.md)
141
141
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/aws-storage-queries/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Compose reusable connection libraries with portable configuration, application o
147
147
 
148
148
  - Id: `connectors/calendar-cli`
149
149
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
150
- - Owner: `@jskit-ai/connector-google-calendar@0.2.20`
150
+ - Owner: `@jskit-ai/connector-google-calendar@0.2.22`
151
151
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/calendar-cli/PATTERN.md)
152
152
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/calendar-cli/example/)
153
153
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -158,7 +158,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
158
158
 
159
159
  - Id: `connectors/event-delivery`
160
160
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
161
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
162
162
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/event-delivery/PATTERN.md)
163
163
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/event-delivery/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Wire service-account grants, file storage, explicit message actions and public b
169
169
 
170
170
  - Id: `connectors/firebase-messaging`
171
171
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
172
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
173
173
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/firebase-messaging/PATTERN.md)
174
174
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/firebase-messaging/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
180
180
 
181
181
  - Id: `connectors/google-ads-search`
182
182
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
183
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
184
184
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/google-ads-search/PATTERN.md)
185
185
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/google-ads-search/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
191
191
 
192
192
  - Id: `connectors/oauth-connection`
193
193
  - Keywords: `accounting`, `assistant permissions`, `books`, `cli`, `client credentials`, `connectors`, `consent`, `crm`, `databricks`, `developer token`, `fabric`, `files`, `gaql`, `google ads`, `graphql`, `integrations`, `linkedin`, `microsoft`, `oauth`, `powerpoint`, `salesforce`, `service principal`, `shopify`, `soql`, `staffing`, `tiktok`, `twitch`, `wave`, `word`, `wordpress`, `workday`, `xero`, `zoho`
194
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
195
195
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md)
196
196
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/oauth-connection/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
202
202
 
203
203
  - Id: `connectors/paddle-catalogue`
204
204
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
205
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
206
206
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/paddle-catalogue/PATTERN.md)
207
207
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/paddle-catalogue/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
213
213
 
214
214
  - Id: `connectors/public-image`
215
215
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
216
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
217
217
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/public-image/PATTERN.md)
218
218
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/public-image/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Compose file configuration, Redshift Data API operations and application query o
224
224
 
225
225
  - Id: `connectors/redshift-queries`
226
226
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
227
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
227
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
228
228
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md)
229
229
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/redshift-queries/example/)
230
230
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -235,7 +235,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
235
235
 
236
236
  - Id: `connectors/source-scanning`
237
237
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
238
- - Owner: `@jskit-ai/connectors-catalog@0.2.20`
238
+ - Owner: `@jskit-ai/connectors-catalog@0.2.22`
239
239
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/source-scanning/PATTERN.md)
240
240
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/source-scanning/example/)
241
241
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -246,7 +246,7 @@ Add a protected administration surface, settings shell, and semantic navigation
246
246
 
247
247
  - Id: `console/console-surface`
248
248
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
249
- - Owner: `@jskit-ai/console-web@0.1.247`
249
+ - Owner: `@jskit-ai/console-web@0.1.249`
250
250
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
251
251
  - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
252
252
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -257,7 +257,7 @@ Define an application table resource whose records belong to the current user, a
257
257
 
258
258
  - Id: `crud/crud-contract`
259
259
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `table`, `user`
260
- - Owner: `@jskit-ai/resource-crud-core@0.1.207`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.208`
261
261
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-contract/PATTERN.md)
262
262
  - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-contract/example/)
263
263
  - Requires: `@jskit-ai/resource-core`, `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Build a complete application-owned CRUD server package from a migration, a table
268
268
 
269
269
  - Id: `crud/crud-feature-package`
270
270
  - Keywords: `actions`, `crud`, `database`, `defineCrudFeature`, `json-api`, `migration`, `owns`, `permissions`, `repository`, `routes`, `service`, `table resource`
271
- - Owner: `@jskit-ai/crud-core@0.2.20`
271
+ - Owner: `@jskit-ai/crud-core@0.2.22`
272
272
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-feature-package/PATTERN.md)
273
273
  - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-feature-package/example/)
274
274
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-core`, `@jskit-ai/resource-crud-core`
@@ -279,7 +279,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
279
279
 
280
280
  - Id: `crud/crud-screen-set`
281
281
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
282
- - Owner: `@jskit-ai/http-web@0.2.25`
282
+ - Owner: `@jskit-ai/http-web@0.2.26`
283
283
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
284
284
  - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
285
285
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-core`, `@jskit-ai/resource-crud-core`
@@ -290,7 +290,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
290
290
 
291
291
  - Id: `database/mysql-application`
292
292
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
293
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.263`
293
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.264`
294
294
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
295
295
  - Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
296
296
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -301,7 +301,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
301
301
 
302
302
  - Id: `database/postgres-application`
303
303
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
304
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.262`
304
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.263`
305
305
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
306
306
  - Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
307
307
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -312,7 +312,7 @@ Describe one database table once (its fields, columns, ownership, search and sor
312
312
 
313
313
  - Id: `database/table-resource`
314
314
  - Keywords: `database`, `defaultTo`, `defineTableResource`, `lockVersionField`, `lookup`, `ownership`, `owns`, `resource`, `system`, `table`, `workspace_or_shared`
315
- - Owner: `@jskit-ai/resource-core@0.1.207`
315
+ - Owner: `@jskit-ai/resource-core@0.1.208`
316
316
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/table-resource/PATTERN.md)
317
317
  - Examples: [example/](../../skills/jskit/references/patterns/database/table-resource/example/)
318
318
  - Requires: `@jskit-ai/resource-core`
@@ -323,7 +323,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
323
323
 
324
324
  - Id: `mobile/android-application`
325
325
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
326
- - Owner: `@jskit-ai/mobile-capacitor@0.2.20`
326
+ - Owner: `@jskit-ai/mobile-capacitor@0.2.21`
327
327
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
328
328
  - Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
329
329
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -334,7 +334,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
334
334
 
335
335
  - Id: `realtime/realtime-application`
336
336
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
337
- - Owner: `@jskit-ai/realtime@0.2.23`
337
+ - Owner: `@jskit-ai/realtime@0.2.24`
338
338
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
339
339
  - Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
340
340
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
345
345
 
346
346
  - Id: `rewards/google-rewarded`
347
347
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
348
- - Owner: `@jskit-ai/rewarded-web@0.2.25`
348
+ - Owner: `@jskit-ai/rewarded-web@0.2.27`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/rewards/google-rewarded/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/patterns/rewards/google-rewarded/example/)
351
351
  - Requires: `@jskit-ai/rewarded-web`
@@ -356,7 +356,7 @@ Define a server feature through explicit capabilities and first-class actions, a
356
356
 
357
357
  - Id: `server/feature-package`
358
358
  - Keywords: `actions`, `aggregate`, `feature`, `handle`, `orchestration`, `owns`, `package`, `provider`, `repository`, `routes`, `server`, `table resource`
359
- - Owner: `@jskit-ai/agent-docs@0.1.290`
359
+ - Owner: `@jskit-ai/agent-docs@0.1.292`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
362
362
  - Requires: `@jskit-ai/kernel`
@@ -367,7 +367,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
367
367
 
368
368
  - Id: `shell/application-shell`
369
369
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
370
- - Owner: `@jskit-ai/shell-web@0.2.20`
370
+ - Owner: `@jskit-ai/shell-web@0.2.21`
371
371
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
372
372
  - Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
373
373
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -378,7 +378,7 @@ Add product routes and shell extensions through file routing, semantic placement
378
378
 
379
379
  - Id: `ui/page-and-placement`
380
380
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
381
- - Owner: `@jskit-ai/shell-web@0.2.20`
381
+ - Owner: `@jskit-ai/shell-web@0.2.21`
382
382
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
383
383
  - Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
384
384
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -389,7 +389,7 @@ Compose an account settings route and profile, preference, notification, and sig
389
389
 
390
390
  - Id: `users/account-settings`
391
391
  - Keywords: `account`, `link provider`, `notifications`, `oauth`, `preferences`, `profile`, `settings`, `sign-in methods`, `user`, `vue`
392
- - Owner: `@jskit-ai/users-web@0.2.30`
392
+ - Owner: `@jskit-ai/users-web@0.2.32`
393
393
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
394
394
  - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -400,7 +400,7 @@ Expose user administration and workspace-scoped member operations through app-ow
400
400
 
401
401
  - Id: `users/user-administration-server`
402
402
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
403
- - Owner: `@jskit-ai/users-core@0.2.21`
403
+ - Owner: `@jskit-ai/users-core@0.2.23`
404
404
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
405
405
  - Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
406
406
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -411,7 +411,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
411
411
 
412
412
  - Id: `workspaces/workspace-server`
413
413
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
414
- - Owner: `@jskit-ai/workspaces-core@0.2.21`
414
+ - Owner: `@jskit-ai/workspaces-core@0.2.23`
415
415
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
416
416
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
417
417
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -422,7 +422,7 @@ Compose workspace selection, invitation, member administration, settings, and re
422
422
 
423
423
  - Id: `workspaces/workspace-surfaces`
424
424
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
425
- - Owner: `@jskit-ai/workspaces-web@0.2.30`
425
+ - Owner: `@jskit-ai/workspaces-web@0.2.32`
426
426
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
427
427
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
428
428
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -164,3 +164,7 @@ Exports
164
164
  ### `migrations/agent_initial.cjs`
165
165
  Exports
166
166
  - None
167
+
168
+ ### `migrations/agent_summaries_follows.cjs`
169
+ Exports
170
+ - None
@@ -100,7 +100,7 @@ Exports
100
100
  Local functions
101
101
  - `documentNotFound()`
102
102
  - `requireDocument(document)`
103
- - `isNotFound(error)`
103
+ - `isNotFound(error, resourceName)`
104
104
  - `recordOutput(crud)`
105
105
  - `contractShape(crud)`
106
106
  - `includedShape({ attributes, relationships }, labelKey = "")`
@@ -751,7 +751,7 @@ Local functions
751
751
  - `withoutActionCatalogue(dependencies)`
752
752
  - `normalizeOwns(owns, featureId)`
753
753
  - `normalizeSystemScope(systemScope, featureId)`
754
- - `resourceDependencies({ resourceRuntime }, { featureId, owns, systemScope })`
754
+ - `resourceDependencies({ resourceRuntime }, { featureId, owns, systemScope }, requires)`
755
755
 
756
756
  ### `server/features/index.js`
757
757
  Exports
@@ -39,6 +39,7 @@ Exports
39
39
  - `storedTimestamps(schema, names = RECORD_TIMESTAMPS)`
40
40
  Local functions
41
41
  - `expandLookupField(fieldKey, fieldDefinition)`
42
+ - `requireBlobLimits(fieldKey, fieldDefinition)`
42
43
  - `normalizeTableSchema(schema)`
43
44
  - `requireText(value, label)`
44
45
  - `requireOwnership(value)`
@@ -33,6 +33,7 @@ Local functions
33
33
  ### `src/server/errors.js`
34
34
  Exports
35
35
  - `DuplicateOwnerError`
36
+ - `GroupLimitError`
36
37
  - `MissingScopeError`
37
38
  - `PageSizeError`
38
39
  - `RowLimitError`
@@ -41,6 +42,14 @@ Exports
41
42
  - `UnpagedQueryError`
42
43
  - `UnsupportedDatabaseError`
43
44
 
45
+ ### `src/server/filterJoinSources.js`
46
+ Exports
47
+ - `filterJoinSources(featureId, resource, searchSchema)`
48
+ - `joinSourceHooks({ resourceName, declared, ownerOf })`
49
+ - `withCallOptions(jsonRestContext, options)`
50
+ Local functions
51
+ - `preparedFilter(resourceName, filter, applyFilter)`
52
+
44
53
  ### `src/server/foreignKeyCheck.js`
45
54
  Exports
46
55
  - `checkForeignKeys({ knex, resources, tables = [] })`
@@ -50,6 +59,21 @@ Local functions
50
59
  - `sameKey(left, right)`
51
60
  - `declaredForeignKeys(knex, resources)`
52
61
 
62
+ ### `src/server/handleBlobs.js`
63
+ Exports
64
+ - `blobBuffers(resource, data)`
65
+ - `blobFields(resource)`
66
+ - `checkBlobReads(name, caller, blobs, rows = 1)`
67
+ - `checkBlobValues(resource, rows)`
68
+ - `namedBlobs(resource, fields, resourceNamed)`
69
+ - `refuseBlobsInJson(name, blobs)`
70
+ Local functions
71
+ - `labelsOf(blobs)`
72
+
73
+ ### `src/server/handleEveryRow.js`
74
+ Exports
75
+ - `createEveryRowReads({ api, name, resource, jsonRest, readFields, contextOf, hiddenFields, settings, resourceNamed })`
76
+
53
77
  ### `src/server/handleGuards.js`
54
78
  Exports
55
79
  - `formatOf(name, options)`
@@ -74,6 +98,8 @@ Exports
74
98
  Local functions
75
99
  - `namedHiddenFields(resource, fields)`
76
100
  - `storedValue(value, { type, precision, scale })`
101
+ - `refusedCall(error)`
102
+ - `isAsyncGenerator(value)`
77
103
  - `fieldNames(fields)`
78
104
  - `isKnexValue(value)`
79
105
  - `withoutFullBuilder(value, label)`
@@ -84,12 +110,16 @@ Local functions
84
110
 
85
111
  ### `src/server/handleLocks.js`
86
112
  Exports
87
- - `createLockReads({ name, resource, jsonRest, readFields, contextOf, hiddenFields })`
113
+ - `createLockReads({ api, name, resource, jsonRest, readFields, contextOf, hiddenFields, handleNamed, resourceNamed })`
88
114
  - `lockModeOf(name, caller, lockMode)`
115
+ Local functions
116
+ - `lockedIncludes(resource, caller, include)`
89
117
 
90
118
  ### `src/server/handleRecords.js`
91
119
  Exports
92
120
  - `aggregateMeasures(measures)`
121
+ - `defaultFieldList({ outputFields, outputRelationships, idProperty })`
122
+ - `includedRelationships(include)`
93
123
  - `MANY_RETURNING`
94
124
  - `SINGLE_RETURNING`
95
125
  - `handleRecords(resource, records, { include, fields } = {}, resourceNamed)`
@@ -111,7 +141,6 @@ Local functions
111
141
  - `setsOwnTimestamps(context)`
112
142
  - `atPrecision(field, value)`
113
143
  - `stampedAttributes(resource, attributes, stamp, context)`
114
- - `includedRelationships(include)`
115
144
  - `handleRecord(resource, record, included, named, resourceNamed)`
116
145
 
117
146
  ### `src/server/index.js`
@@ -128,6 +157,7 @@ Exports
128
157
  - `withoutHiddenFields`
129
158
  - `passedOn`
130
159
  - `DuplicateOwnerError`
160
+ - `GroupLimitError`
131
161
  - `MissingScopeError`
132
162
  - `PageSizeError`
133
163
  - `RowLimitError`
@@ -146,6 +176,11 @@ Exports
146
176
  - `findOrCreateRecord({ get, create }, attributes, options)`
147
177
  - `lockOrCreate(handle, row, options, work)`
148
178
 
179
+ ### `src/server/manyRowChannel.js`
180
+ Exports
181
+ - `MANY_ROW_CHANNEL`
182
+ - `reportedPageRead(knex, resource, read)`
183
+
149
184
  ### `src/server/rawExpression.js`
150
185
  Exports
151
186
  - `valueOnlyRaw(label, knex, args)`
@@ -155,7 +190,7 @@ Local functions
155
190
  ### `src/server/resourceHandle.js`
156
191
  Exports
157
192
  - `MANY_ROW_CHANNEL`
158
- - `createResourceHandle({ api, resource, hooks, settings, resourceNamed })`
193
+ - `createResourceHandle({ api, resource, hooks, settings, resourceNamed, handleNamed })`
159
194
  Local functions
160
195
  - `reportManyRow(resource, operation, rows, chunkSize)`
161
196
  - `requireHandleTransaction(name, options)`
@@ -216,5 +251,6 @@ Exports
216
251
  - `type JsonRestResource`
217
252
  - `type ResourceRuntime`
218
253
  - `type ResourceHandle`
254
+ - `type HiddenFieldReads`
219
255
  - `type ResourceCallOptions`
220
256
  - `type SystemContext`