fix: promote runtime & driver deps to fix npm install bootstrap

Author: os-zhuang

.changeset/driver-sql-optional-natives.md

@@ -0,0 +1,10 @@
+---
+'@objectstack/driver-sql': patch
+---
+
+Promote native database client packages so npm consumers can boot without manual installs.
+
+- `better-sqlite3` is now an `optionalDependency` (prebuilt binaries cover the common case), so `npx @objectstack/cli start` boots a default SQLite database out-of-the-box.
+- `pg`, `mysql2`, `sqlite3`, and `tedious` are declared as optional `peerDependencies` (`peerDependenciesMeta.optional = true`), removing install warnings while keeping the loader-on-demand pattern.
+
+Fixes: `Knex: Cannot find module 'better-sqlite3'` on fresh `npm install @objectstack/cli` followed by `objectstack start`.

.changeset/runtime-promote-dyn-imports.md

@@ -0,0 +1,24 @@
+---
+"@objectstack/runtime": patch
+"@objectstack/cli": patch
+---
+
+Fix `npx @objectstack/cli start` crashing with `Cannot find package
+'@objectstack/metadata'` (and friends).
+
+`@objectstack/runtime` dynamically `import()`s `@objectstack/metadata`,
+`@objectstack/objectql`, and the storage drivers (`driver-memory`,
+`driver-sql`, `driver-sqlite-wasm`, `driver-turso`) from
+`createStandaloneStack` / `createDefaultHostConfig`, but they were only
+listed in `devDependencies` — so when the package was installed from npm
+(rather than the workspace) these imports failed at boot.
+
+They are now declared as real `dependencies`. `@objectstack/driver-mongodb`
+remains an `optionalDependency` because the standalone stack only loads
+it when the user passes a `mongodb://` URL (the failure path already has
+a friendly error message).
+
+Also adds a small quick-start CLI command (`objectstack start`) that
+auto-creates `~/.objectstack/{data,dist,auth-secret}`, boots an empty
+kernel with Studio + marketplace mounted, and lets users install apps at
+runtime — no `objectstack.config.ts` required.

packages/plugins/driver-sql/package.json

@@ -23,6 +23,21 @@
     "knex": "^3.2.10",
     "nanoid": "^5.1.11"
   },
+  "optionalDependencies": {
+    "better-sqlite3": "^12.10.0"
+  },
+  "peerDependencies": {
+    "mysql2": "^3.0.0",
+    "pg": "^8.0.0",
+    "sqlite3": "^5.0.0",
+    "tedious": "^18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "mysql2": { "optional": true },
+    "pg": { "optional": true },
+    "sqlite3": { "optional": true },
+    "tedious": { "optional": true }
+  },
   "devDependencies": {
     "@types/node": "^25.9.1",
     "better-sqlite3": "^12.10.0",

packages/runtime/package.json

@@ -20,7 +20,13 @@
   },
   "dependencies": {
     "@objectstack/core": "workspace:*",
+    "@objectstack/driver-memory": "workspace:*",
+    "@objectstack/driver-sql": "workspace:*",
+    "@objectstack/driver-sqlite-wasm": "workspace:*",
+    "@objectstack/driver-turso": "workspace:*",
     "@objectstack/formula": "workspace:*",
+    "@objectstack/metadata": "workspace:*",
+    "@objectstack/objectql": "workspace:*",
     "@objectstack/observability": "workspace:*",
     "@objectstack/plugin-auth": "workspace:*",
     "@objectstack/plugin-security": "workspace:*",
@@ -32,14 +38,10 @@
     "quickjs-emscripten": "^0.32.0",
     "zod": "^4.4.3"
   },
+  "optionalDependencies": {
+    "@objectstack/driver-mongodb": "workspace:*"
+  },
   "devDependencies": {
-    "@objectstack/driver-memory": "workspace:*",
-    "@objectstack/driver-mongodb": "workspace:*",
-    "@objectstack/driver-sql": "workspace:*",
-    "@objectstack/driver-sqlite-wasm": "workspace:*",
-    "@objectstack/driver-turso": "workspace:*",
-    "@objectstack/metadata": "workspace:*",
-    "@objectstack/objectql": "workspace:*",
     "typescript": "^6.0.3",
     "vitest": "^4.1.7"
   },