@stacksjs/defaults 0.75.320 → 0.75.322

package/ai/skills/stacks-desktop/SKILL.md

@@ -100,6 +100,29 @@ interface Desktop {
 
 ## Local-first apps: owning the launcher
 
+### Model-backed offline native apps
+
+An app created with `buddy new <name> --native` can use `craft.config.ts`'s
+`backend: { entry: 'app/Desktop/api.ts' }` to bundle a Bun backend. The native
+host owns an authenticated ephemeral loopback session and the backend's lifetime.
+The binary does not need an installed Bun, external server or source files.
+
+Define models under `app/Models` with `defineModel` from `@stacksjs/orm/define-model`.
+In the backend, import those models explicitly and use `openNativeDatabase` and
+`createNativeModelApi` from `@stacksjs/orm/native`. Pass an absolute SQLite path
+inside Application Support and an explicit model registry. The same query-builder
+migration planner derives the schema and atomically records its snapshot in the
+database. Additive upgrades preserve rows; destructive changes are refused.
+
+CRUD follows `traits.useApi.uri` and its explicit `routes` list. Native models
+declare `middleware: []` because the transport owns session authorization.
+`createNativeModelApi` requires an `authorize(request, model, ability)` callback
+on every request. Only return true unconditionally when the handler runs solely
+behind stx's authenticated native backend. Never expose that handler through an
+unprotected HTTP server. Web middleware declarations are refused by this native
+adapter instead of silently skipped. Writes use the model's validation, fillable
+allowlist and hidden-field serialization; index requests have bounded pagination.
+
 The launcher Stacks compiles opens a Craft window on the URL in `desktop.json`,
 which is what a hosted Stacks application wants. An app whose subject is the
 machine it runs on - a disk cleaner, a log viewer, a device tool - has no such

package/ai/skills/stacks-native/CATALOG.md

@@ -53,7 +53,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/features` | [`stacks-features`](../stacks-features/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/features/src/index.ts) | 1 |
 | `@stacksjs/forms` | [`stacks-forms`](../stacks-forms/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/forms/src/index.ts) | 4 |
 | `@stacksjs/git` | [`stacks-git`](../stacks-git/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/git/src/index.ts) | 2 |
-| `@stacksjs/github` | [`stacks-git`](../stacks-git/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/index.ts) | 7 |
+| `@stacksjs/github` | [`stacks-git`](../stacks-git/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/index.ts) | 8 |
 | `@stacksjs/health` | [`stacks-health`](../stacks-health/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/health/src/index.ts) | 2 |
 | `@stacksjs/http` | [`stacks-http`](../stacks-http/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/http/src/index.ts) | 2 |
 | `@stacksjs/i18n` | [`stacks-i18n`](../stacks-i18n/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/i18n/src/index.ts) | 4 |
@@ -65,7 +65,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/newsletter` | [`stacks-newsletter`](../stacks-newsletter/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/newsletter/src/index.ts) | 7 |
 | `@stacksjs/notifications` | [`stacks-notifications`](../stacks-notifications/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts) | 16 |
 | `@stacksjs/objects` | [`stacks-objects`](../stacks-objects/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/objects/src/index.ts) | 4 |
-| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 72 |
+| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 73 |
 | `@stacksjs/pagination` | [`stacks-pagination`](../stacks-pagination/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/pagination/src/index.ts) | 0 |
 | `@stacksjs/path` | [`stacks-path`](../stacks-path/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/index.ts) | 13 |
 | `@stacksjs/payments` | [`stacks-payments`](../stacks-payments/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/payments/src/index.ts) | 29 |
@@ -519,11 +519,11 @@ Evidence directory: [2 retained tests](https://github.com/stacksjs/stacks/blob/m
 
 Guidance: [`stacks-git`](../stacks-git/SKILL.md). Source: [storage/framework/core/github/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/index.ts).
 
-Declared runtime exports: `GITHUB_API`, `GITHUB_API_VERSION`, `clearDashboardCache`, `createPullRequestWithFiles`, `detectNewlyFailedRuns`, `detectRunnerPressure`, `fetchAllRepos`, `fetchBotPRCounts`, `fetchFailedJobs`, `fetchPullRequestCounts`, `fetchRepoActiveRuns`, `fetchRepoStatus`, `fetchRepositoryFile`, `fetchRepositoryTree`, `fetchRunJobs`, `fetchWorkflowRuns`, `getDashboardData`, `ghFetch`, `ghHeaders`, `githubHeaders`, `githubJson`, `githubRequest`, `mapWithConcurrency`.
+Declared runtime exports: `GITHUB_API`, `GITHUB_API_VERSION`, `clearDashboardCache`, `createPullRequestWithFiles`, `detectNewlyFailedRuns`, `detectRunnerPressure`, `fetchAllRepos`, `fetchBotPRCounts`, `fetchFailedJobs`, `fetchGitHubNotifications`, `fetchGitHubViewer`, `fetchPullRequestCounts`, `fetchRepoActiveRuns`, `fetchRepoStatus`, `fetchRepositoryFile`, `fetchRepositoryTree`, `fetchRunJobs`, `fetchWorkflowRuns`, `getDashboardData`, `ghFetch`, `ghHeaders`, `githubHeaders`, `githubJson`, `githubRequest`, `mapWithConcurrency`, `searchGitHubIssues`, `searchGitHubRepositories`.
 
-Local source modules: [src/bots.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/bots.ts), [src/client.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/client.ts), [src/dashboard.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/dashboard.ts), [src/failure-detector.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/failure-detector.ts), [src/pull-requests.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/pull-requests.ts), [src/repos.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/repos.ts), [src/run-history.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/run-history.ts), [src/runner-pressure-detector.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/runner-pressure-detector.ts), [src/runners.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/runners.ts), [src/runs.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/runs.ts).
+Local source modules: [src/bots.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/bots.ts), [src/client.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/client.ts), [src/dashboard.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/dashboard.ts), [src/failure-detector.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/failure-detector.ts), [src/pull-requests.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/pull-requests.ts), [src/repos.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/repos.ts), [src/run-history.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/run-history.ts), [src/runner-pressure-detector.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/runner-pressure-detector.ts), [src/runners.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/runners.ts), [src/runs.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/runs.ts), [src/search.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/src/search.ts).
 
-Evidence directory: [7 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [8 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/github/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/health
 
@@ -635,7 +635,7 @@ Declared runtime exports: `Activity`, `AnalyticsEvent`, `Auction`, `AuctionItem`
 
 Local source modules: [src/auto-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/auto-crud.ts), [src/batch-loader.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/batch-loader.ts), [src/db.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/db.ts), [src/define-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/define-model.ts), [src/extend-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/extend-model.ts), [src/gdpr/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/gdpr/index.ts), [src/generate-database-schema.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/generate-database-schema.ts), [src/locked-row.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/locked-row.ts), [src/messaging.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/messaging.ts), [src/model-types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/model-types.ts), [src/ownership.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/ownership.ts), [src/paginator-request.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/paginator-request.ts), [src/row-token.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/row-token.ts), [src/subquery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/subquery.ts), [src/traits/audit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/audit.ts), [src/traits/billable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/billable.ts), [src/traits/categorizable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/categorizable.ts), [src/traits/commentable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/commentable.ts), [src/traits/likeable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/likeable.ts), [src/traits/taggable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/taggable.ts), [src/transaction.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/transaction.ts), [src/types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/types.ts), [src/utils/encrypted.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/encrypted.ts), [src/utils/prunable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/prunable.ts).
 
-Evidence directory: [72 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [73 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/pagination
 

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.320",
+  "version": "0.75.322",
   "description": "Stacks, built into VS Code: stx templates, pickier linting and formatting, encrypted env files, the dev server preview and every buddy command. No other extensions required.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.320",
+  "version": "0.75.322",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -45,7 +45,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.320",
+    "@stacksjs/mobile": "0.75.322",
     "@stacksjs/sanitizer": "0.2.711",
     "@stacksjs/stx": "0.2.711",
     "@xterm/addon-fit": "^0.11.0",