@jskit-ai/agent-docs 0.1.171 → 0.1.173

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 (29) hide show
  1. package/guide/agent/app-setup/database-layer.md +22 -0
  2. package/package.json +1 -1
  3. package/patterns/feature-package/example/booking-engine/package.json +1 -1
  4. package/patterns/minimal-foundation/example/package.json +4 -4
  5. package/patterns/minimal-foundation/example/playwright.config.mjs +1 -1
  6. package/patterns/shell-foundation/example/package.json +5 -5
  7. package/patterns/shell-foundation/example/packages/main/package.json +1 -1
  8. package/patterns/shell-foundation/example/playwright.config.mjs +1 -1
  9. package/patterns/ui-testing.md +26 -2
  10. package/reference/autogen/PATTERN_INDEX.md +35 -35
  11. package/skills/jskit/references/pattern-index.md +35 -35
  12. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +4 -4
  13. package/skills/jskit/references/patterns/app/minimal-foundation/example/playwright.config.mjs +1 -1
  14. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +5 -5
  15. package/skills/jskit/references/patterns/app/shell-foundation/example/packages/main/package.json +1 -1
  16. package/skills/jskit/references/patterns/app/shell-foundation/example/playwright.config.mjs +1 -1
  17. package/skills/jskit/references/patterns/auth/supabase-auth/example/package.json +1 -1
  18. package/skills/jskit/references/patterns/connectors/calendar-cli/example/package.json +4 -4
  19. package/skills/jskit/references/patterns/crud/json-api-resource-package/example/packages/books/package.json +2 -2
  20. package/skills/jskit/references/patterns/database/mysql-application/PATTERN.md +28 -1
  21. package/skills/jskit/references/patterns/database/mysql-application/example/.env.example +2 -0
  22. package/skills/jskit/references/patterns/database/mysql-application/example/package.json +1 -1
  23. package/skills/jskit/references/patterns/database/mysql-application/example/tests/browser/database.js +68 -0
  24. package/skills/jskit/references/patterns/database/postgres-application/example/package.json +1 -1
  25. package/skills/jskit/references/patterns/realtime/realtime-application/example/package.json +2 -2
  26. package/skills/jskit/references/patterns/server/feature-package/example/booking-engine/package.json +1 -1
  27. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users/package.json +2 -2
  28. package/skills/jskit/references/patterns/users/user-administration-server/example/packages/users-workspace/package.json +3 -3
  29. package/templates/app/AGENTS.md +7 -0
@@ -161,3 +161,25 @@ not merely because a useful resource has behavior beyond list and save.
161
161
  Do not add migration receipts, sync ledgers, generator provenance, or dialect
162
162
  questionnaires. The installed graph, migration source, environment, and
163
163
  database migration table are sufficient.
164
+
165
+ ## Browser test preparation
166
+
167
+ Keep the test schema and migration history between routine browser runs. The
168
+ MySQL application pattern includes `example/tests/browser/database.js`: it
169
+ validates the exact `BROWSER_TEST_DB_NAME`, applies pending migrations, clears test rows,
170
+ and runs one explicit fixture seed. Restore migration-owned baseline rows in
171
+ that seed. Prove repeat preparation, stale-data removal, pending migrations, and
172
+ isolation from the normal database before adopting the launcher. Give disposable
173
+ integration and migration tests their own `TEST_DB_NAME`; require the two names
174
+ to differ and provision exact grants for each. Run disposable cleanup between
175
+ two browser preparations in the regression test to prove it cannot erase the
176
+ reusable schema. Startup reports applied migration counts and phase durations
177
+ so a cold rebuild is visible to the caller.
178
+
179
+ Run related checks in one suite invocation and prepare only their required
180
+ fixtures. The application foundations use the development launcher for ordinary
181
+ browser checks; fresh-schema migration proofs and production builds are separate.
182
+ A managed suite uses the host's server URL and identity, starts no second server,
183
+ and restores normal Preview after the batch. Database isolation alone does not
184
+ disable email, payments or other external effects: configure those test controls
185
+ and verify the actual server identity before destructive requests.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.171",
3
+ "version": "0.1.173",
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.1.199",
8
+ "@jskit-ai/kernel": "0.1.201",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.199",
37
+ "@jskit-ai/kernel": "0.1.201",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,12 +42,12 @@
42
42
  "vue": "^3.5.38",
43
43
  "vue-router": "^5.1.0",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.197",
45
+ "@jskit-ai/http-runtime": "0.1.199",
46
46
  "@fastify/fast-json-stringify-compiler": "^5.1.0"
47
47
  },
48
48
  "devDependencies": {
49
- "@jskit-ai/config-eslint": "0.1.196",
50
- "@jskit-ai/jskit-catalog": "0.1.224",
49
+ "@jskit-ai/config-eslint": "0.1.198",
50
+ "@jskit-ai/jskit-catalog": "0.1.226",
51
51
  "@playwright/test": "1.61.1",
52
52
  "@vitejs/plugin-vue": "^6.0.7",
53
53
  "eslint": "^10.8.0",
@@ -19,7 +19,7 @@ export default defineConfig({
19
19
  },
20
20
  ...(managedBaseUrl ? {} : {
21
21
  webServer: {
22
- command: "npm run build && node ./bin/server.js",
22
+ command: "npm run develop",
23
23
  env: {
24
24
  PORT: "4173"
25
25
  },
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.199",
37
+ "@jskit-ai/kernel": "0.1.201",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,14 +42,14 @@
42
42
  "vue": "^3.5.38",
43
43
  "vue-router": "^5.1.0",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.197",
45
+ "@jskit-ai/http-runtime": "0.1.199",
46
46
  "@mdi/js": "^7.4.47",
47
- "@jskit-ai/shell-web": "0.1.203",
47
+ "@jskit-ai/shell-web": "0.1.205",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0"
49
49
  },
50
50
  "devDependencies": {
51
- "@jskit-ai/config-eslint": "0.1.196",
52
- "@jskit-ai/jskit-catalog": "0.1.224",
51
+ "@jskit-ai/config-eslint": "0.1.198",
52
+ "@jskit-ai/jskit-catalog": "0.1.226",
53
53
  "@playwright/test": "1.61.1",
54
54
  "@vitejs/plugin-vue": "^6.0.7",
55
55
  "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.1.199"
12
+ "@jskit-ai/kernel": "0.1.201"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -19,7 +19,7 @@ export default defineConfig({
19
19
  },
20
20
  ...(managedBaseUrl ? {} : {
21
21
  webServer: {
22
- command: "npm run build && node ./bin/server.js",
22
+ command: "npm run develop",
23
23
  env: {
24
24
  PORT: "4173"
25
25
  },
@@ -22,6 +22,30 @@ Rules:
22
22
  - Vibe64 supplies an authenticated context through `VIBE64_PLAYWRIGHT_STORAGE_STATE`. Treat that file as a temporary secret: do not commit it, print it, or retain it after the run.
23
23
  - Do not install a browser when the environment provides a managed browser runner.
24
24
 
25
+ ## Keep startup incremental
26
+
27
+ Run related cases in one suite invocation. Prepare the isolated database and
28
+ fixtures once for that invocation, never once per test. Retain the test schema
29
+ and migration ledger, apply only pending migrations, and reset fixture data
30
+ deterministically. Restore any migration-owned baseline rows through the test
31
+ seed. MySQL applications start from the `database/mysql-application` pattern's
32
+ `example/tests/browser/database.js`. Require a repeat-start regression test that
33
+ proves unchanged migration history, removal of stale data, pending migration
34
+ application, and isolation from the normal database.
35
+
36
+ Use `BROWSER_TEST_DB_NAME` for that retained schema and a different
37
+ `TEST_DB_NAME` for disposable integration and migration tests. Reject a name
38
+ collision before connecting. Include disposable cleanup between browser starts
39
+ in the regression: one test's teardown must not erase another test's migrations.
40
+
41
+ Do not drop/recreate the database, replay completed migrations, build every
42
+ module fixture, or run a production frontend build for each focused check.
43
+ Choose small fixture sets for the selected suite. Fresh-schema migration tests
44
+ and production-artifact tests are separate operations. Measure migration,
45
+ fixture, and server startup time before retrying a slow launch or raising its
46
+ deadline. When a host supplies a managed target, use its scoped suite command so
47
+ one startup serves the whole batch and cleanup restores normal Preview.
48
+
25
49
  ## Preserve baseline tests
26
50
 
27
51
  Foundation-pattern baseline tests are app-owned and customizable. Adapt infrastructure
@@ -91,8 +115,8 @@ Run the focused Playwright command directly:
91
115
  npx playwright test tests/e2e/contacts.spec.ts -g filters
92
116
  ```
93
117
 
94
- For local pre-merge review, follow the focused run with the application's
95
- ordinary lint, package, build, and test scripts.
118
+ Use the application's relevant focused checks. Do not automatically follow each
119
+ browser check with a full lint, build, or test sweep; follow its verification policy.
96
120
 
97
121
  Do not mark the chunk done if:
98
122
 
@@ -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.171`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.173`
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.171`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.173`
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.1.170`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.172`
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 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
48
48
 
49
49
  - Id: `auth/auth-surface`
50
50
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
51
- - Owner: `@jskit-ai/auth-web@0.1.199`
51
+ - Owner: `@jskit-ai/auth-web@0.1.201`
52
52
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
53
53
  - Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
54
54
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
59
59
 
60
60
  - Id: `auth/supabase-auth`
61
61
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
62
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.196`
62
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.198`
63
63
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
64
64
  - Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
65
65
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -70,7 +70,7 @@ Resolve an administrator environment key or an individual user's grant, then use
70
70
 
71
71
  - Id: `connectors/ai-connections`
72
72
  - Keywords: `ai`, `api-key`, `big-pickle`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
73
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
73
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
74
74
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/ai-connections/PATTERN.md)
75
75
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/ai-connections/example/)
76
76
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -81,7 +81,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
81
81
 
82
82
  - Id: `connectors/api-key-connection`
83
83
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
84
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
84
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
85
85
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/api-key-connection/PATTERN.md)
86
86
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/api-key-connection/example/)
87
87
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -92,7 +92,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
92
92
 
93
93
  - Id: `connectors/assistant-mcp`
94
94
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
95
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
96
96
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp/PATTERN.md)
97
97
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
103
103
 
104
104
  - Id: `connectors/assistant-mcp-oauth`
105
105
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
106
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
107
107
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/PATTERN.md)
108
108
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/assistant-mcp-oauth/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose signed AWS operations, file configuration and application authorization
114
114
 
115
115
  - Id: `connectors/aws-storage-queries`
116
116
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
117
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
118
118
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/aws-storage-queries/PATTERN.md)
119
119
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/aws-storage-queries/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Compose reusable connection libraries with portable configuration, application o
125
125
 
126
126
  - Id: `connectors/calendar-cli`
127
127
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
128
- - Owner: `@jskit-ai/connector-google-calendar@0.1.16`
128
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.18`
129
129
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/calendar-cli/PATTERN.md)
130
130
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/calendar-cli/example/)
131
131
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -136,7 +136,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
136
136
 
137
137
  - Id: `connectors/event-delivery`
138
138
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
139
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
140
140
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/event-delivery/PATTERN.md)
141
141
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/event-delivery/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Wire service-account grants, file storage, explicit message actions and public b
147
147
 
148
148
  - Id: `connectors/firebase-messaging`
149
149
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
150
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
150
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
151
151
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/firebase-messaging/PATTERN.md)
152
152
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/firebase-messaging/example/)
153
153
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -158,7 +158,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
158
158
 
159
159
  - Id: `connectors/google-ads-search`
160
160
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
161
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
162
162
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/google-ads-search/PATTERN.md)
163
163
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/google-ads-search/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
169
169
 
170
170
  - Id: `connectors/oauth-connection`
171
171
  - 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`
172
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
173
173
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/oauth-connection/PATTERN.md)
174
174
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/oauth-connection/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
180
180
 
181
181
  - Id: `connectors/paddle-catalogue`
182
182
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
183
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
184
184
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/paddle-catalogue/PATTERN.md)
185
185
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/paddle-catalogue/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
191
191
 
192
192
  - Id: `connectors/public-image`
193
193
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
194
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
195
195
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/public-image/PATTERN.md)
196
196
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/public-image/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose file configuration, Redshift Data API operations and application query o
202
202
 
203
203
  - Id: `connectors/redshift-queries`
204
204
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
205
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
206
206
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/redshift-queries/PATTERN.md)
207
207
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/redshift-queries/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
213
213
 
214
214
  - Id: `connectors/source-scanning`
215
215
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
216
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
217
217
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/connectors/source-scanning/PATTERN.md)
218
218
  - Examples: [example/](../../skills/jskit/references/patterns/connectors/source-scanning/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Add a protected administration surface, settings shell, and semantic navigation
224
224
 
225
225
  - Id: `console/console-surface`
226
226
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
227
- - Owner: `@jskit-ai/console-web@0.1.167`
227
+ - Owner: `@jskit-ai/console-web@0.1.169`
228
228
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
229
229
  - Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
230
230
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -235,7 +235,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
235
235
 
236
236
  - Id: `crud/crud-screen-set`
237
237
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
238
- - Owner: `@jskit-ai/http-web@0.1.44`
238
+ - Owner: `@jskit-ai/http-web@0.1.46`
239
239
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
240
240
  - Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
241
241
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -246,7 +246,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
246
246
 
247
247
  - Id: `crud/json-api-resource-package`
248
248
  - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
249
- - Owner: `@jskit-ai/crud-core@0.1.210`
249
+ - Owner: `@jskit-ai/crud-core@0.1.212`
250
250
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md)
251
251
  - Examples: [example/](../../skills/jskit/references/patterns/crud/json-api-resource-package/example/)
252
252
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -257,7 +257,7 @@ Define an authenticated application resource whose records belong to the current
257
257
 
258
258
  - Id: `crud/resource-contract`
259
259
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
260
- - Owner: `@jskit-ai/resource-crud-core@0.1.141`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.143`
261
261
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/resource-contract/PATTERN.md)
262
262
  - Examples: [example/](../../skills/jskit/references/patterns/crud/resource-contract/example/)
263
263
  - Requires: `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
268
268
 
269
269
  - Id: `database/mysql-application`
270
270
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
271
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.197`
271
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.199`
272
272
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
273
273
  - Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
274
274
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -279,7 +279,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
279
279
 
280
280
  - Id: `database/postgres-application`
281
281
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
282
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.196`
282
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.198`
283
283
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
284
284
  - Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
285
285
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -290,7 +290,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
290
290
 
291
291
  - Id: `mobile/android-application`
292
292
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
293
- - Owner: `@jskit-ai/mobile-capacitor@0.1.134`
293
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.136`
294
294
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
295
295
  - Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
296
296
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -301,7 +301,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
301
301
 
302
302
  - Id: `realtime/realtime-application`
303
303
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
304
- - Owner: `@jskit-ai/realtime@0.1.196`
304
+ - Owner: `@jskit-ai/realtime@0.1.198`
305
305
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
306
306
  - Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
307
307
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -312,7 +312,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
312
312
 
313
313
  - Id: `rewards/google-rewarded`
314
314
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
315
- - Owner: `@jskit-ai/rewarded-web@0.1.135`
315
+ - Owner: `@jskit-ai/rewarded-web@0.1.137`
316
316
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/rewards/google-rewarded/PATTERN.md)
317
317
  - Examples: [example/](../../skills/jskit/references/patterns/rewards/google-rewarded/example/)
318
318
  - Requires: `@jskit-ai/rewarded-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.171`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.173`
327
327
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
@@ -334,7 +334,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
334
334
 
335
335
  - Id: `shell/application-shell`
336
336
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
337
- - Owner: `@jskit-ai/shell-web@0.1.203`
337
+ - Owner: `@jskit-ai/shell-web@0.1.205`
338
338
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
339
339
  - Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
340
340
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Add product routes and shell extensions through file routing, semantic placement
345
345
 
346
346
  - Id: `ui/page-and-placement`
347
347
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
348
- - Owner: `@jskit-ai/shell-web@0.1.203`
348
+ - Owner: `@jskit-ai/shell-web@0.1.205`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
351
351
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -356,7 +356,7 @@ Compose an account settings route and profile, preference, and notification sect
356
356
 
357
357
  - Id: `users/account-settings`
358
358
  - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
359
- - Owner: `@jskit-ai/users-web@0.1.217`
359
+ - Owner: `@jskit-ai/users-web@0.1.219`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
362
362
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -367,7 +367,7 @@ Expose user administration and workspace-scoped member operations through app-ow
367
367
 
368
368
  - Id: `users/user-administration-server`
369
369
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
370
- - Owner: `@jskit-ai/users-core@0.1.212`
370
+ - Owner: `@jskit-ai/users-core@0.1.214`
371
371
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
372
372
  - Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
373
373
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -378,7 +378,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
378
378
 
379
379
  - Id: `workspaces/workspace-server`
380
380
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
381
- - Owner: `@jskit-ai/workspaces-core@0.1.177`
381
+ - Owner: `@jskit-ai/workspaces-core@0.1.179`
382
382
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
383
383
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
384
384
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -389,7 +389,7 @@ Compose workspace selection, invitation, member administration, settings, and re
389
389
 
390
390
  - Id: `workspaces/workspace-surfaces`
391
391
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
392
- - Owner: `@jskit-ai/workspaces-web@0.1.178`
392
+ - Owner: `@jskit-ai/workspaces-web@0.1.180`
393
393
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
394
394
  - Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -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.171`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.173`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](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.171`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.173`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](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.1.170`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.1.172`
41
41
  - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](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 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
48
48
 
49
49
  - Id: `auth/auth-surface`
50
50
  - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
51
- - Owner: `@jskit-ai/auth-web@0.1.199`
51
+ - Owner: `@jskit-ai/auth-web@0.1.201`
52
52
  - Read: [PATTERN.md](patterns/auth/auth-surface/PATTERN.md)
53
53
  - Examples: [example/](patterns/auth/auth-surface/example/)
54
54
  - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
@@ -59,7 +59,7 @@ Add Supabase authentication through normal npm composition, explicit environment
59
59
 
60
60
  - Id: `auth/supabase-auth`
61
61
  - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
62
- - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.196`
62
+ - Owner: `@jskit-ai/auth-provider-supabase-core@0.1.198`
63
63
  - Read: [PATTERN.md](patterns/auth/supabase-auth/PATTERN.md)
64
64
  - Examples: [example/](patterns/auth/supabase-auth/example/)
65
65
  - Requires: `@jskit-ai/auth-provider-supabase-core`
@@ -70,7 +70,7 @@ Resolve an administrator environment key or an individual user's grant, then use
70
70
 
71
71
  - Id: `connectors/ai-connections`
72
72
  - Keywords: `ai`, `api-key`, `big-pickle`, `cli`, `environment`, `free`, `models`, `ownership`, `zai`, `zen`
73
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
73
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
74
74
  - Read: [PATTERN.md](patterns/connectors/ai-connections/PATTERN.md)
75
75
  - Examples: [example/](patterns/connectors/ai-connections/example/)
76
76
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -81,7 +81,7 @@ Compose provider operations, authorization and encrypted file storage from a CLI
81
81
 
82
82
  - Id: `connectors/api-key-connection`
83
83
  - Keywords: `api-key`, `clay`, `cli`, `clickhouse`, `connectors`, `dbt`, `files`, `firecrawl`, `granola`, `integrations`, `metrics`, `prestashop`, `resend`, `semantic-layer`, `semrush`, `x-twitter`
84
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
84
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
85
85
  - Read: [PATTERN.md](patterns/connectors/api-key-connection/PATTERN.md)
86
86
  - Examples: [example/](patterns/connectors/api-key-connection/example/)
87
87
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -92,7 +92,7 @@ Compose token-based MCP discovery and explicitly authorized tool calls using the
92
92
 
93
93
  - Id: `connectors/assistant-mcp`
94
94
  - Keywords: `assistant`, `cli`, `connectors`, `files`, `integrations`, `mcp`, `n8n`, `sanity`
95
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
95
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
96
96
  - Read: [PATTERN.md](patterns/connectors/assistant-mcp/PATTERN.md)
97
97
  - Examples: [example/](patterns/connectors/assistant-mcp/example/)
98
98
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -103,7 +103,7 @@ Configure assistant OAuth clients, then compose existing state, encrypted file g
103
103
 
104
104
  - Id: `connectors/assistant-mcp-oauth`
105
105
  - Keywords: `amplitude`, `assistant`, `atlassian`, `canva`, `cli`, `client metadata`, `confidence`, `connectors`, `figma`, `files`, `granola`, `hex`, `mcp`, `miro`, `oauth`
106
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
106
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
107
107
  - Read: [PATTERN.md](patterns/connectors/assistant-mcp-oauth/PATTERN.md)
108
108
  - Examples: [example/](patterns/connectors/assistant-mcp-oauth/example/)
109
109
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -114,7 +114,7 @@ Compose signed AWS operations, file configuration and application authorization
114
114
 
115
115
  - Id: `connectors/aws-storage-queries`
116
116
  - Keywords: `athena`, `aws`, `cli`, `connectors`, `files`, `iam`, `queries`, `s3`, `storage`, `sts`
117
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
117
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
118
118
  - Read: [PATTERN.md](patterns/connectors/aws-storage-queries/PATTERN.md)
119
119
  - Examples: [example/](patterns/connectors/aws-storage-queries/example/)
120
120
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -125,7 +125,7 @@ Compose reusable connection libraries with portable configuration, application o
125
125
 
126
126
  - Id: `connectors/calendar-cli`
127
127
  - Keywords: `calendar`, `cli`, `connectors`, `google`, `integrations`, `oauth`, `permissions`
128
- - Owner: `@jskit-ai/connector-google-calendar@0.1.16`
128
+ - Owner: `@jskit-ai/connector-google-calendar@0.1.18`
129
129
  - Read: [PATTERN.md](patterns/connectors/calendar-cli/PATTERN.md)
130
130
  - Examples: [example/](patterns/connectors/calendar-cli/example/)
131
131
  - Requires: `@jskit-ai/connector-google-calendar`, `@jskit-ai/connectors-core`, `@jskit-ai/database-runtime-mysql`
@@ -136,7 +136,7 @@ Compose the shared connector runtime for event delivery while leaving workflow c
136
136
 
137
137
  - Id: `connectors/event-delivery`
138
138
  - Keywords: `cli`, `connectors`, `events`, `files`, `inngest`, `integrations`, `workflows`
139
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
139
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
140
140
  - Read: [PATTERN.md](patterns/connectors/event-delivery/PATTERN.md)
141
141
  - Examples: [example/](patterns/connectors/event-delivery/example/)
142
142
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -147,7 +147,7 @@ Wire service-account grants, file storage, explicit message actions and public b
147
147
 
148
148
  - Id: `connectors/firebase-messaging`
149
149
  - Keywords: `cli`, `connectors`, `fcm`, `files`, `firebase`, `integrations`, `jwt`, `notifications`, `push`, `service-account`, `vapid`
150
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
150
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
151
151
  - Read: [PATTERN.md](patterns/connectors/firebase-messaging/PATTERN.md)
152
152
  - Examples: [example/](patterns/connectors/firebase-messaging/example/)
153
153
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -158,7 +158,7 @@ Compose reviewed Search campaigns with project-owned Google OAuth and portable s
158
158
 
159
159
  - Id: `connectors/google-ads-search`
160
160
  - Keywords: `ads`, `campaigns`, `cli`, `connectors`, `conversion`, `google`, `search`
161
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
161
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
162
162
  - Read: [PATTERN.md](patterns/connectors/google-ads-search/PATTERN.md)
163
163
  - Examples: [example/](patterns/connectors/google-ads-search/example/)
164
164
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -169,7 +169,7 @@ Compose provider consent, verification and encrypted file persistence from an ap
169
169
 
170
170
  - Id: `connectors/oauth-connection`
171
171
  - 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`
172
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
172
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
173
173
  - Read: [PATTERN.md](patterns/connectors/oauth-connection/PATTERN.md)
174
174
  - Examples: [example/](patterns/connectors/oauth-connection/example/)
175
175
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -180,7 +180,7 @@ Compose a sequential catalogue batch and preserve partial success for applicatio
180
180
 
181
181
  - Id: `connectors/paddle-catalogue`
182
182
  - Keywords: `batch`, `paddle`, `payments`, `prices`, `products`
183
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
183
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
184
184
  - Read: [PATTERN.md](patterns/connectors/paddle-catalogue/PATTERN.md)
185
185
  - Examples: [example/](patterns/connectors/paddle-catalogue/example/)
186
186
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -191,7 +191,7 @@ Resolve a publishable image key deliberately and use the shared URL library in a
191
191
 
192
192
  - Id: `connectors/public-image`
193
193
  - Keywords: `cli`, `connectors`, `files`, `images`, `integrations`, `logo-dev`, `public-key`
194
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
194
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
195
195
  - Read: [PATTERN.md](patterns/connectors/public-image/PATTERN.md)
196
196
  - Examples: [example/](patterns/connectors/public-image/example/)
197
197
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -202,7 +202,7 @@ Compose file configuration, Redshift Data API operations and application query o
202
202
 
203
203
  - Id: `connectors/redshift-queries`
204
204
  - Keywords: `aws`, `cli`, `connectors`, `files`, `iam`, `provisioned`, `redshift`, `serverless`, `sql`, `warehouse`
205
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
205
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
206
206
  - Read: [PATTERN.md](patterns/connectors/redshift-queries/PATTERN.md)
207
207
  - Examples: [example/](patterns/connectors/redshift-queries/example/)
208
208
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -213,7 +213,7 @@ Use the shared scanner runtime from a CLI or a host worker with portable configu
213
213
 
214
214
  - Id: `connectors/source-scanning`
215
215
  - Keywords: `cancellation`, `cli`, `connectors`, `integrations`, `scanning`, `security`, `source`, `wiz`, `worker`
216
- - Owner: `@jskit-ai/connectors-catalog@0.1.16`
216
+ - Owner: `@jskit-ai/connectors-catalog@0.1.18`
217
217
  - Read: [PATTERN.md](patterns/connectors/source-scanning/PATTERN.md)
218
218
  - Examples: [example/](patterns/connectors/source-scanning/example/)
219
219
  - Requires: `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`
@@ -224,7 +224,7 @@ Add a protected administration surface, settings shell, and semantic navigation
224
224
 
225
225
  - Id: `console/console-surface`
226
226
  - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
227
- - Owner: `@jskit-ai/console-web@0.1.167`
227
+ - Owner: `@jskit-ai/console-web@0.1.169`
228
228
  - Read: [PATTERN.md](patterns/console/console-surface/PATTERN.md)
229
229
  - Examples: [example/](patterns/console/console-surface/example/)
230
230
  - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
@@ -235,7 +235,7 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
235
235
 
236
236
  - Id: `crud/crud-screen-set`
237
237
  - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
238
- - Owner: `@jskit-ai/http-web@0.1.44`
238
+ - Owner: `@jskit-ai/http-web@0.1.46`
239
239
  - Read: [PATTERN.md](patterns/crud/crud-screen-set/PATTERN.md)
240
240
  - Examples: [example/](patterns/crud/crud-screen-set/example/)
241
241
  - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
@@ -246,7 +246,7 @@ Build a complete application-owned CRUD server package from a migration, resourc
246
246
 
247
247
  - Id: `crud/json-api-resource-package`
248
248
  - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
249
- - Owner: `@jskit-ai/crud-core@0.1.210`
249
+ - Owner: `@jskit-ai/crud-core@0.1.212`
250
250
  - Read: [PATTERN.md](patterns/crud/json-api-resource-package/PATTERN.md)
251
251
  - Examples: [example/](patterns/crud/json-api-resource-package/example/)
252
252
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
@@ -257,7 +257,7 @@ Define an authenticated application resource whose records belong to the current
257
257
 
258
258
  - Id: `crud/resource-contract`
259
259
  - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
260
- - Owner: `@jskit-ai/resource-crud-core@0.1.141`
260
+ - Owner: `@jskit-ai/resource-crud-core@0.1.143`
261
261
  - Read: [PATTERN.md](patterns/crud/resource-contract/PATTERN.md)
262
262
  - Examples: [example/](patterns/crud/resource-contract/example/)
263
263
  - Requires: `@jskit-ai/resource-crud-core`
@@ -268,7 +268,7 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
268
268
 
269
269
  - Id: `database/mysql-application`
270
270
  - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
271
- - Owner: `@jskit-ai/database-runtime-mysql@0.1.197`
271
+ - Owner: `@jskit-ai/database-runtime-mysql@0.1.199`
272
272
  - Read: [PATTERN.md](patterns/database/mysql-application/PATTERN.md)
273
273
  - Examples: [example/](patterns/database/mysql-application/example/)
274
274
  - Requires: `@jskit-ai/database-runtime-mysql`
@@ -279,7 +279,7 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
279
279
 
280
280
  - Id: `database/postgres-application`
281
281
  - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
282
- - Owner: `@jskit-ai/database-runtime-postgres@0.1.196`
282
+ - Owner: `@jskit-ai/database-runtime-postgres@0.1.198`
283
283
  - Read: [PATTERN.md](patterns/database/postgres-application/PATTERN.md)
284
284
  - Examples: [example/](patterns/database/postgres-application/example/)
285
285
  - Requires: `@jskit-ai/database-runtime-postgres`
@@ -290,7 +290,7 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
290
290
 
291
291
  - Id: `mobile/android-application`
292
292
  - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
293
- - Owner: `@jskit-ai/mobile-capacitor@0.1.134`
293
+ - Owner: `@jskit-ai/mobile-capacitor@0.1.136`
294
294
  - Read: [PATTERN.md](patterns/mobile/android-application/PATTERN.md)
295
295
  - Examples: [example/](patterns/mobile/android-application/example/)
296
296
  - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
@@ -301,7 +301,7 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
301
301
 
302
302
  - Id: `realtime/realtime-application`
303
303
  - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
304
- - Owner: `@jskit-ai/realtime@0.1.196`
304
+ - Owner: `@jskit-ai/realtime@0.1.198`
305
305
  - Read: [PATTERN.md](patterns/realtime/realtime-application/PATTERN.md)
306
306
  - Examples: [example/](patterns/realtime/realtime-application/example/)
307
307
  - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
@@ -312,7 +312,7 @@ Compose application-owned Google Publisher Tag delivery with the generic rewarde
312
312
 
313
313
  - Id: `rewards/google-rewarded`
314
314
  - Keywords: `ads`, `google`, `publisher tag`, `rewarded`, `unlock`
315
- - Owner: `@jskit-ai/rewarded-web@0.1.135`
315
+ - Owner: `@jskit-ai/rewarded-web@0.1.137`
316
316
  - Read: [PATTERN.md](patterns/rewards/google-rewarded/PATTERN.md)
317
317
  - Examples: [example/](patterns/rewards/google-rewarded/example/)
318
318
  - Requires: `@jskit-ai/rewarded-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
323
323
 
324
324
  - Id: `server/feature-package`
325
325
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
326
- - Owner: `@jskit-ai/agent-docs@0.1.171`
326
+ - Owner: `@jskit-ai/agent-docs@0.1.173`
327
327
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
328
328
  - Examples: [example/](patterns/server/feature-package/example/)
329
329
  - Requires: `@jskit-ai/kernel`
@@ -334,7 +334,7 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
334
334
 
335
335
  - Id: `shell/application-shell`
336
336
  - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
337
- - Owner: `@jskit-ai/shell-web@0.1.203`
337
+ - Owner: `@jskit-ai/shell-web@0.1.205`
338
338
  - Read: [PATTERN.md](patterns/shell/application-shell/PATTERN.md)
339
339
  - Examples: [example/](patterns/shell/application-shell/example/)
340
340
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Add product routes and shell extensions through file routing, semantic placement
345
345
 
346
346
  - Id: `ui/page-and-placement`
347
347
  - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
348
- - Owner: `@jskit-ai/shell-web@0.1.203`
348
+ - Owner: `@jskit-ai/shell-web@0.1.205`
349
349
  - Read: [PATTERN.md](patterns/ui/page-and-placement/PATTERN.md)
350
350
  - Examples: [example/](patterns/ui/page-and-placement/example/)
351
351
  - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -356,7 +356,7 @@ Compose an account settings route and profile, preference, and notification sect
356
356
 
357
357
  - Id: `users/account-settings`
358
358
  - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
359
- - Owner: `@jskit-ai/users-web@0.1.217`
359
+ - Owner: `@jskit-ai/users-web@0.1.219`
360
360
  - Read: [PATTERN.md](patterns/users/account-settings/PATTERN.md)
361
361
  - Examples: [example/](patterns/users/account-settings/example/)
362
362
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
@@ -367,7 +367,7 @@ Expose user administration and workspace-scoped member operations through app-ow
367
367
 
368
368
  - Id: `users/user-administration-server`
369
369
  - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
370
- - Owner: `@jskit-ai/users-core@0.1.212`
370
+ - Owner: `@jskit-ai/users-core@0.1.214`
371
371
  - Read: [PATTERN.md](patterns/users/user-administration-server/PATTERN.md)
372
372
  - Examples: [example/](patterns/users/user-administration-server/example/)
373
373
  - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
@@ -378,7 +378,7 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
378
378
 
379
379
  - Id: `workspaces/workspace-server`
380
380
  - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
381
- - Owner: `@jskit-ai/workspaces-core@0.1.177`
381
+ - Owner: `@jskit-ai/workspaces-core@0.1.179`
382
382
  - Read: [PATTERN.md](patterns/workspaces/workspace-server/PATTERN.md)
383
383
  - Examples: [example/](patterns/workspaces/workspace-server/example/)
384
384
  - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
@@ -389,7 +389,7 @@ Compose workspace selection, invitation, member administration, settings, and re
389
389
 
390
390
  - Id: `workspaces/workspace-surfaces`
391
391
  - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
392
- - Owner: `@jskit-ai/workspaces-web@0.1.178`
392
+ - Owner: `@jskit-ai/workspaces-web@0.1.180`
393
393
  - Read: [PATTERN.md](patterns/workspaces/workspace-surfaces/PATTERN.md)
394
394
  - Examples: [example/](patterns/workspaces/workspace-surfaces/example/)
395
395
  - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.199",
37
+ "@jskit-ai/kernel": "0.1.201",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,12 +42,12 @@
42
42
  "vue": "^3.5.38",
43
43
  "vue-router": "^5.1.0",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.197",
45
+ "@jskit-ai/http-runtime": "0.1.199",
46
46
  "@fastify/fast-json-stringify-compiler": "^5.1.0"
47
47
  },
48
48
  "devDependencies": {
49
- "@jskit-ai/config-eslint": "0.1.196",
50
- "@jskit-ai/jskit-catalog": "0.1.224",
49
+ "@jskit-ai/config-eslint": "0.1.198",
50
+ "@jskit-ai/jskit-catalog": "0.1.226",
51
51
  "@playwright/test": "1.61.1",
52
52
  "@vitejs/plugin-vue": "^6.0.7",
53
53
  "eslint": "^10.8.0",
@@ -19,7 +19,7 @@ export default defineConfig({
19
19
  },
20
20
  ...(managedBaseUrl ? {} : {
21
21
  webServer: {
22
- command: "npm run build && node ./bin/server.js",
22
+ command: "npm run develop",
23
23
  env: {
24
24
  PORT: "4173"
25
25
  },
@@ -34,7 +34,7 @@
34
34
  "dependencies": {
35
35
  "@local/main": "0.1.0",
36
36
  "@fastify/static": "^10.1.3",
37
- "@jskit-ai/kernel": "0.1.199",
37
+ "@jskit-ai/kernel": "0.1.201",
38
38
  "@tanstack/vue-query": "^5.101.0",
39
39
  "fastify": "^5.8.5",
40
40
  "json-rest-schema": "^1.0.17",
@@ -42,14 +42,14 @@
42
42
  "vue": "^3.5.38",
43
43
  "vue-router": "^5.1.0",
44
44
  "vuetify": "^4.1.2",
45
- "@jskit-ai/http-runtime": "0.1.197",
45
+ "@jskit-ai/http-runtime": "0.1.199",
46
46
  "@mdi/js": "^7.4.47",
47
- "@jskit-ai/shell-web": "0.1.203",
47
+ "@jskit-ai/shell-web": "0.1.205",
48
48
  "@fastify/fast-json-stringify-compiler": "^5.1.0"
49
49
  },
50
50
  "devDependencies": {
51
- "@jskit-ai/config-eslint": "0.1.196",
52
- "@jskit-ai/jskit-catalog": "0.1.224",
51
+ "@jskit-ai/config-eslint": "0.1.198",
52
+ "@jskit-ai/jskit-catalog": "0.1.226",
53
53
  "@playwright/test": "1.61.1",
54
54
  "@vitejs/plugin-vue": "^6.0.7",
55
55
  "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.1.199"
12
+ "@jskit-ai/kernel": "0.1.201"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -19,7 +19,7 @@ export default defineConfig({
19
19
  },
20
20
  ...(managedBaseUrl ? {} : {
21
21
  webServer: {
22
- command: "npm run build && node ./bin/server.js",
22
+ command: "npm run develop",
23
23
  env: {
24
24
  PORT: "4173"
25
25
  },
@@ -2,6 +2,6 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/auth-provider-supabase-core": "0.1.196"
5
+ "@jskit-ai/auth-provider-supabase-core": "0.1.198"
6
6
  }
7
7
  }
@@ -7,10 +7,10 @@
7
7
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
8
8
  },
9
9
  "dependencies": {
10
- "@jskit-ai/connectors-core": "0.1.16",
11
- "@jskit-ai/connector-google-calendar": "0.1.16",
12
- "@jskit-ai/database-runtime": "0.1.199",
13
- "@jskit-ai/database-runtime-mysql": "0.1.197",
10
+ "@jskit-ai/connectors-core": "0.1.18",
11
+ "@jskit-ai/connector-google-calendar": "0.1.18",
12
+ "@jskit-ai/database-runtime": "0.1.201",
13
+ "@jskit-ai/database-runtime-mysql": "0.1.199",
14
14
  "knex": "^3.1.0"
15
15
  }
16
16
  }
@@ -8,8 +8,8 @@
8
8
  "./shared": "./src/shared/index.js"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/crud-core": "0.1.210",
12
- "@jskit-ai/resource-crud-core": "0.1.141"
11
+ "@jskit-ai/crud-core": "0.1.212",
12
+ "@jskit-ai/resource-crud-core": "0.1.143"
13
13
  },
14
14
  "jskit": {
15
15
  "kind": "runtime",
@@ -48,7 +48,29 @@ Knex discovers package-owned migrations from the installed dependency graph.
48
48
  `example/knexfile.js` loads an optional local `.env` and fixes the MySQL dialect.
49
49
  `example/scripts/prepare-database.js` is the portable migrate-then-seed
50
50
  entrypoint for managed sessions and deployments. `example/.env.example` names
51
- the five connection values without a secret.
51
+ the connection values and separate test databases without a secret.
52
+
53
+ `example/tests/browser/database.js` is the application-owned browser preparation
54
+ helper. It requires the exact `BROWSER_TEST_DB_NAME`, rejects the ordinary and
55
+ disposable `TEST_DB_NAME` databases,
56
+ retains the schema and migration ledger, applies pending migrations, then clears
57
+ test rows and calls one explicit fixture seed transaction. The seed must restore
58
+ any migration-owned baseline rows the app needs. Call it once before starting
59
+ the isolated test server, never in `beforeEach`. It closes its connections without
60
+ dropping the database. The launcher selects that database only for its own server
61
+ and identity process, disables external effects, and proves actual server identity
62
+ before the suite writes data. It must not edit the normal environment. Provision
63
+ both test databases with exact grants for the application account. A disposable
64
+ integration or migration test must never drop the browser database.
65
+
66
+ Startup reports whether the schema exists, the number of migrations applied,
67
+ and the migration, fixture-reset and seed durations. Use those measurements to
68
+ diagnose a slow start before rerunning a browser case.
69
+
70
+ Keep fixtures small for the selected test scope. Run related cases in one suite
71
+ invocation. Use the development launcher for ordinary browser checks; test the
72
+ production build separately when needed. Fresh-schema migration proofs are
73
+ separate from browser startup.
52
74
 
53
75
  ## Variation points
54
76
 
@@ -66,6 +88,11 @@ it as `seed` to `prepareDatabaseFromApp()`.
66
88
  - Run `npm run db:migrate:status` and the application verification command.
67
89
  - Exercise one transaction and one negative connection case.
68
90
  - When a seed exists, run `db:prepare` twice and require the second run to be safe.
91
+ - For browser preparation, run a disposable test between two starts: the second applies no
92
+ old migrations, stale fixture data is removed, baseline rows are restored,
93
+ foreign-key checks remain enabled, and the normal database is unchanged.
94
+ Also prove that a new pending migration is applied. Keep this as a regression
95
+ test when adapting the example; reject a harness that recreates the schema.
69
96
 
70
97
  `example/.github/workflows/verify.yml` is a normal app-owned CI workflow with
71
98
  an explicit MariaDB service. Adapt it as source rather than generating it from
@@ -3,3 +3,5 @@ DB_PORT=3306
3
3
  DB_NAME=application
4
4
  DB_USER=application
5
5
  DB_PASSWORD=replace-me
6
+ TEST_DB_NAME=application_test
7
+ BROWSER_TEST_DB_NAME=application_browser_test
@@ -8,6 +8,6 @@
8
8
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/database-runtime-mysql": "0.1.197"
11
+ "@jskit-ai/database-runtime-mysql": "0.1.199"
12
12
  }
13
13
  }
@@ -0,0 +1,68 @@
1
+ import knex from "knex";
2
+
3
+ // Application-owned test setup. Schema migration tests use a separate fresh database.
4
+ async function prepareBrowserTestDatabase({ knexConfig, environment = process.env, seed }) {
5
+ const started = performance.now();
6
+ if (environment.NODE_ENV === "production") throw new Error("Browser tests cannot prepare a production runtime.");
7
+ if (typeof seed !== "function") throw new TypeError("An explicit browser fixture seed is required.");
8
+ if (knexConfig?.client !== "mysql2" || !knexConfig.connection || typeof knexConfig.connection !== "object") {
9
+ throw new Error("Browser preparation requires a resolved MySQL Knex configuration.");
10
+ }
11
+ const database = String(environment.BROWSER_TEST_DB_NAME || "").trim();
12
+ if (!/^[a-zA-Z0-9_]{1,64}$/.test(database)) throw new Error("BROWSER_TEST_DB_NAME must name the exact browser database.");
13
+ const protectedNames = [knexConfig.connection.database, environment.DB_NAME, environment.TEST_DB_NAME];
14
+ if (environment.DATABASE_URL) {
15
+ try { protectedNames.push(decodeURIComponent(new URL(environment.DATABASE_URL).pathname.slice(1))); }
16
+ catch { throw new Error("DATABASE_URL must be a valid database URL."); }
17
+ }
18
+ if (!knexConfig.connection.database || protectedNames.some(name => String(name || "").trim().toLowerCase() === database.toLowerCase())) {
19
+ throw new Error("BROWSER_TEST_DB_NAME must differ from the application and disposable TEST_DB_NAME databases.");
20
+ }
21
+ const adminConnection = { ...knexConfig.connection };
22
+ delete adminConnection.database;
23
+ const admin = knex({ ...knexConfig, connection: adminConnection, pool: { min: 0, max: 1 } });
24
+ let schemaExisted;
25
+ try {
26
+ const [[row]] = await admin.raw("SELECT COUNT(*) AS count FROM information_schema.SCHEMATA WHERE SCHEMA_NAME = ?", [database]);
27
+ schemaExisted = Number(row.count) === 1;
28
+ await admin.raw("CREATE DATABASE IF NOT EXISTS ??", [database]);
29
+ }
30
+ finally { await admin.destroy(); }
31
+ console.info(`Browser database ${database}: ${schemaExisted ? "existing schema" : "new schema"}.`);
32
+ const db = knex({ ...knexConfig, connection: { ...knexConfig.connection, database } });
33
+ try {
34
+ const migrationStarted = performance.now();
35
+ const [, migrations] = await db.migrate.latest();
36
+ const migrationMs = Math.round(performance.now() - migrationStarted);
37
+ console.info(`Browser migrations: ${migrations.length} applied in ${migrationMs}ms.`);
38
+ const resetStarted = performance.now();
39
+ let resetTables = 0;
40
+ const connection = await db.client.acquireConnection();
41
+ try {
42
+ const [[actual]] = await db.raw("SELECT DATABASE() AS databaseName").connection(connection);
43
+ if (actual.databaseName !== database) throw new Error("Browser reset requires the exact BROWSER_TEST_DB_NAME connection.");
44
+ const [tables] = await db.raw(
45
+ "SELECT TABLE_NAME AS name FROM information_schema.TABLES WHERE TABLE_SCHEMA = ? AND TABLE_TYPE = 'BASE TABLE'", [database]
46
+ ).connection(connection);
47
+ const ledger = knexConfig.migrations?.tableName || "knex_migrations";
48
+ await db.raw("SET FOREIGN_KEY_CHECKS = 0").connection(connection);
49
+ try {
50
+ for (const { name } of tables) {
51
+ if (name === ledger || name === `${ledger}_lock`) continue;
52
+ await db.raw("TRUNCATE TABLE ??", [name]).connection(connection);
53
+ resetTables += 1;
54
+ }
55
+ } finally { await db.raw("SET FOREIGN_KEY_CHECKS = 1").connection(connection); }
56
+ } finally { await db.client.releaseConnection(connection); }
57
+ const resetMs = Math.round(performance.now() - resetStarted);
58
+ console.info(`Browser fixture reset: ${resetTables} tables in ${resetMs}ms.`);
59
+ const seedStarted = performance.now();
60
+ await db.transaction(seed);
61
+ const seedMs = Math.round(performance.now() - seedStarted);
62
+ const totalMs = Math.round(performance.now() - started);
63
+ console.info(`Browser fixture seed: ${seedMs}ms; database preparation total: ${totalMs}ms.`);
64
+ return { database, migrations, schemaExisted, timings: { migrationMs, resetMs, seedMs, totalMs } };
65
+ } finally { await db.destroy(); }
66
+ }
67
+
68
+ export { prepareBrowserTestDatabase };
@@ -8,6 +8,6 @@
8
8
  "db:migrate:status": "knex --knexfile ./knexfile.js migrate:list"
9
9
  },
10
10
  "dependencies": {
11
- "@jskit-ai/database-runtime-postgres": "0.1.196"
11
+ "@jskit-ai/database-runtime-postgres": "0.1.198"
12
12
  }
13
13
  }
@@ -2,7 +2,7 @@
2
2
  "private": true,
3
3
  "type": "module",
4
4
  "dependencies": {
5
- "@jskit-ai/realtime": "0.1.196",
6
- "@jskit-ai/shell-web": "0.1.203"
5
+ "@jskit-ai/realtime": "0.1.198",
6
+ "@jskit-ai/shell-web": "0.1.205"
7
7
  }
8
8
  }
@@ -5,7 +5,7 @@
5
5
  "private": true,
6
6
  "type": "module",
7
7
  "dependencies": {
8
- "@jskit-ai/kernel": "0.1.199",
8
+ "@jskit-ai/kernel": "0.1.201",
9
9
  "json-rest-schema": "^1.0.17"
10
10
  },
11
11
  "exports": {
@@ -9,8 +9,8 @@
9
9
  "./shared": "./src/shared/index.js"
10
10
  },
11
11
  "dependencies": {
12
- "@jskit-ai/crud-core": "0.1.210",
13
- "@jskit-ai/resource-crud-core": "0.1.141"
12
+ "@jskit-ai/crud-core": "0.1.212",
13
+ "@jskit-ai/resource-crud-core": "0.1.143"
14
14
  },
15
15
  "jskit": {
16
16
  "kind": "runtime",
@@ -9,9 +9,9 @@
9
9
  "./shared": "./src/shared/index.js"
10
10
  },
11
11
  "dependencies": {
12
- "@jskit-ai/crud-core": "0.1.210",
13
- "@jskit-ai/resource-crud-core": "0.1.141",
14
- "@jskit-ai/workspaces-core": "0.1.177"
12
+ "@jskit-ai/crud-core": "0.1.212",
13
+ "@jskit-ai/resource-crud-core": "0.1.143",
14
+ "@jskit-ai/workspaces-core": "0.1.179"
15
15
  },
16
16
  "jskit": {
17
17
  "kind": "runtime",
@@ -12,6 +12,13 @@ Before implementation, read the narrow relevant source pattern completely. If
12
12
  its owner package is installed, prefer that version-matched package-owned copy.
13
13
  Do not install an unrelated runtime package only to read documentation.
14
14
 
15
+ Before adding or changing browser-test setup, read `patterns/ui-testing.md` in
16
+ this package. Routine tests reuse the isolated schema and prepare fixtures once
17
+ per suite invocation. Keep `BROWSER_TEST_DB_NAME` distinct from disposable
18
+ `TEST_DB_NAME` and prove that disposable cleanup preserves browser migrations.
19
+ Require repeat-start regression proof; do not rebuild the
20
+ database or production frontend for each focused browser check.
21
+
15
22
  Pages never start with a page header, title block, welcome heading, or other
16
23
  standalone heading copy. Start with the useful content and actions. If the user
17
24
  wants a heading, they will ask for or add one.