@stacksjs/orm 0.75.482 → 0.75.483

package/dist/native.d.ts

@@ -5,6 +5,13 @@ import type { StacksModelDefinition } from './define-model';
  * Own one SQLite database in a native backend process. Schema comes from the
  * same migration planner as Buddy; additive upgrades and the snapshot commit
  * atomically. Destructive upgrades require an explicit application migration.
+ *
+ * One destructive change is tolerated rather than refused: a column that is in
+ * the store but not in this build's models. That is what an installed app sees
+ * after a rollback, and refusing left it unable to open at all — in a launcher
+ * with no dock icon, with nothing on screen to say why. The column is kept
+ * instead. This build cannot read it, so keeping it costs only space, and the
+ * build that wrote it still can.
  */
 export declare function openNativeDatabase(options: { path: string, models: Record<string, NativeModel> }): Database;
 /**

package/dist/native.js

@@ -1 +1 @@
-import{Database}from"bun:sqlite";import{chmodSync,mkdirSync}from"node:fs";import{dirname,isAbsolute}from"node:path";import{buildMigrationPlan,configureOrm,generateDiffOperations,setConfig}from"@stacksjs/query-builder";import{apiBasePath,filterFillable,getWritableFields,mapWriteError,resolveIndexPageArgs}from"./auto-crud";import{MODEL_DEFINITION,toAttrs}from"./define-model";export function openNativeDatabase(options){if(options.path!==":memory:"&&!isAbsolute(options.path))throw Error("A native database requires an absolute Application Support path");if(options.path!==":memory:")mkdirSync(dirname(options.path),{recursive:!0,mode:448});const db=new Database(options.path,{create:!0});try{setConfig({verbose:!1});if(options.path!==":memory:")chmodSync(options.path,384);db.exec("PRAGMA foreign_keys = OFF; PRAGMA busy_timeout = 5000;");const models=Object.fromEntries(Object.entries(options.models).map(([name,model])=>[name,model[MODEL_DEFINITION]])),next=buildMigrationPlan(models,{dialect:"sqlite"});db.transaction(()=>{db.exec("CREATE TABLE IF NOT EXISTS _stacks_native_schema (id INTEGER PRIMARY KEY CHECK (id = 1), snapshot TEXT NOT NULL)");const saved=db.query("SELECT snapshot FROM _stacks_native_schema WHERE id = 1").get(),previous=saved?JSON.parse(saved.snapshot):void 0,diff=generateDiffOperations(previous,next,{externalTransaction:!0});if(diff.operations.some((operation)=>operation.destructive))throw Error("Native model upgrade contains destructive changes; provide an explicit data migration");for(const statement of diff.statements)if(statement.replace(/--[^\n]*/g,"").trim())db.exec(statement);if(db.query("PRAGMA foreign_key_check").all().length)throw Error("Native model upgrade violates foreign-key constraints");db.query("INSERT INTO _stacks_native_schema (id, snapshot) VALUES (1, ?) ON CONFLICT (id) DO UPDATE SET snapshot = excluded.snapshot").run(JSON.stringify(next))}).immediate();db.exec("PRAGMA foreign_keys = ON;");configureOrm({database:db});return db}catch(error){db.close();throw error}}export function createNativeModelApi(options){const models=Object.entries(options.models).flatMap(([name,model])=>{const definition=model[MODEL_DEFINITION],api=definition.traits?.useApi;if(!api||typeof api!=="object")return[];if(!Array.isArray(api.middleware)||api.middleware.length)throw Error(`${name}: native CRUD requires explicit middleware: [] and transport authorization`);if(!api.uri)throw Error(`${name}: native CRUD requires a useApi uri`);return[{name,model,definition,api,base:apiBasePath(api.uri,api.prefix)}]}),json=(data,status=200)=>Response.json(data,{status,headers:{"cache-control":"private, no-store"}});return async(request)=>{const url=new URL(request.url);for(const entry of models){const{name,model,definition,api,base}=entry,suffix=url.pathname.slice(base.length);if(!url.pathname.startsWith(base)||suffix&&!/^\/\d+$/.test(suffix))continue;const id=suffix?Number(suffix.slice(1)):void 0,ability=request.method==="GET"?id===void 0?"index":"show":request.method==="POST"&&id===void 0?"store":["PATCH","PUT"].includes(request.method)&&id!==void 0?"update":request.method==="DELETE"&&id!==void 0?"destroy":void 0;if(!ability||!api.routes?.includes(ability))return json({error:"Method not allowed"},405);if(!await options.authorize(request,name,ability))return json({error:"Forbidden"},403);try{if(ability==="index"){const{perPage,offset}=resolveIndexPageArgs(url.searchParams);return json({data:toAttrs(await model.limit(perPage).offset(offset).get())})}if(id!==void 0&&!await model.find(id))return json({error:"Not found"},404);if(ability==="show")return json({data:toAttrs(await model.find(id))});if(ability==="destroy"){await model.destroy(id);return new Response(null,{status:204})}let body;try{body=await request.json()}catch{return json({error:"Invalid JSON"},400)}if(!body||typeof body!=="object"||Array.isArray(body))return json({error:"Expected an object"},422);const fields=getWritableFields({attributes:definition.attributes,belongsTo:Object.values(definition.belongsTo??{})}),data=filterFillable(body,fields),row=ability==="store"?await model.create(data):await model.update(id,data);return json({data:toAttrs(row)},ability==="store"?201:200)}catch(error){const result=mapWriteError(error,name,ability==="store"?"create":"update"),body={...result.body};delete body.detail;return json(body,result.status)}}return null}}
+import{Database}from"bun:sqlite";import{chmodSync,mkdirSync}from"node:fs";import{dirname,isAbsolute}from"node:path";import{buildMigrationPlan,configureOrm,generateDiffOperations,setConfig}from"@stacksjs/query-builder";import{apiBasePath,filterFillable,getWritableFields,mapWriteError,resolveIndexPageArgs}from"./auto-crud";import{MODEL_DEFINITION,toAttrs}from"./define-model";const sameSql=(sql)=>(sql??"").replace(/\s+/g," ").trim();function retainingColumns(next,previous,retained){const wanted=new Map;for(const operation of retained){if(!operation.table||!operation.column)continue;const columns=wanted.get(operation.table)??new Set;columns.add(operation.column);wanted.set(operation.table,columns)}if(!wanted.size)return next;const plan=next,before=previous,tables=(plan.tables??[]).map((table)=>{const names=wanted.get(table.table??"");if(!names?.size)return table;const carried=((before?.tables??[]).find((entry)=>entry.table===table.table)?.columns??[]).filter((column)=>column.name&&names.has(column.name));return carried.length?{...table,columns:[...table.columns??[],...carried]}:table});return{...plan,tables}}export function openNativeDatabase(options){if(options.path!==":memory:"&&!isAbsolute(options.path))throw Error("A native database requires an absolute Application Support path");if(options.path!==":memory:")mkdirSync(dirname(options.path),{recursive:!0,mode:448});const db=new Database(options.path,{create:!0});try{setConfig({verbose:!1});if(options.path!==":memory:")chmodSync(options.path,384);db.exec("PRAGMA foreign_keys = OFF; PRAGMA busy_timeout = 5000;");const models=Object.fromEntries(Object.entries(options.models).map(([name,model])=>[name,model[MODEL_DEFINITION]])),next=buildMigrationPlan(models,{dialect:"sqlite"});db.transaction(()=>{db.exec("CREATE TABLE IF NOT EXISTS _stacks_native_schema (id INTEGER PRIMARY KEY CHECK (id = 1), snapshot TEXT NOT NULL)");const saved=db.query("SELECT snapshot FROM _stacks_native_schema WHERE id = 1").get(),previous=saved?JSON.parse(saved.snapshot):void 0,diff=generateDiffOperations(previous,next,{externalTransaction:!0}),retained=diff.operations.filter((operation)=>operation.destructive&&operation.kind==="drop_column");if(diff.operations.some((operation)=>operation.destructive&&operation.kind!=="drop_column"))throw Error("Native model upgrade contains destructive changes; provide an explicit data migration");const kept=new Set(diff.operations.filter((operation)=>!retained.includes(operation)).map((operation)=>sameSql(operation.sql))),skip=new Set(retained.map((operation)=>sameSql(operation.sql)).filter((sql)=>sql&&!kept.has(sql)));for(const statement of diff.statements){if(skip.has(sameSql(statement)))continue;if(statement.replace(/--[^\n]*/g,"").trim())db.exec(statement)}if(db.query("PRAGMA foreign_key_check").all().length)throw Error("Native model upgrade violates foreign-key constraints");db.query("INSERT INTO _stacks_native_schema (id, snapshot) VALUES (1, ?) ON CONFLICT (id) DO UPDATE SET snapshot = excluded.snapshot").run(JSON.stringify(retainingColumns(next,previous,retained)))}).immediate();db.exec("PRAGMA foreign_keys = ON;");configureOrm({database:db});return db}catch(error){db.close();throw error}}export function createNativeModelApi(options){const models=Object.entries(options.models).flatMap(([name,model])=>{const definition=model[MODEL_DEFINITION],api=definition.traits?.useApi;if(!api||typeof api!=="object")return[];if(!Array.isArray(api.middleware)||api.middleware.length)throw Error(`${name}: native CRUD requires explicit middleware: [] and transport authorization`);if(!api.uri)throw Error(`${name}: native CRUD requires a useApi uri`);return[{name,model,definition,api,base:apiBasePath(api.uri,api.prefix)}]}),json=(data,status=200)=>Response.json(data,{status,headers:{"cache-control":"private, no-store"}});return async(request)=>{const url=new URL(request.url);for(const entry of models){const{name,model,definition,api,base}=entry,suffix=url.pathname.slice(base.length);if(!url.pathname.startsWith(base)||suffix&&!/^\/\d+$/.test(suffix))continue;const id=suffix?Number(suffix.slice(1)):void 0,ability=request.method==="GET"?id===void 0?"index":"show":request.method==="POST"&&id===void 0?"store":["PATCH","PUT"].includes(request.method)&&id!==void 0?"update":request.method==="DELETE"&&id!==void 0?"destroy":void 0;if(!ability||!api.routes?.includes(ability))return json({error:"Method not allowed"},405);if(!await options.authorize(request,name,ability))return json({error:"Forbidden"},403);try{if(ability==="index"){const{perPage,offset}=resolveIndexPageArgs(url.searchParams);return json({data:toAttrs(await model.limit(perPage).offset(offset).get())})}if(id!==void 0&&!await model.find(id))return json({error:"Not found"},404);if(ability==="show")return json({data:toAttrs(await model.find(id))});if(ability==="destroy"){await model.destroy(id);return new Response(null,{status:204})}let body;try{body=await request.json()}catch{return json({error:"Invalid JSON"},400)}if(!body||typeof body!=="object"||Array.isArray(body))return json({error:"Expected an object"},422);const fields=getWritableFields({attributes:definition.attributes,belongsTo:Object.values(definition.belongsTo??{})}),data=filterFillable(body,fields),row=ability==="store"?await model.create(data):await model.update(id,data);return json({data:toAttrs(row)},ability==="store"?201:200)}catch(error){const result=mapWriteError(error,name,ability==="store"?"create":"update"),body={...result.body};delete body.detail;return json(body,result.status)}}return null}}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/orm",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.482",
+  "version": "0.75.483",
   "description": "The Stacks ORM integration",
   "author": "Chris Breuer",
   "contributors": [
@@ -63,31 +63,31 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/cache": "0.75.482",
-    "@stacksjs/cli": "0.75.482",
-    "@stacksjs/config": "0.75.482",
-    "@stacksjs/database": "0.75.482",
-    "@stacksjs/env": "0.75.482",
-    "@stacksjs/error-handling": "0.75.482",
-    "@stacksjs/events": "0.75.482",
-    "@stacksjs/logging": "0.75.482",
-    "@stacksjs/model-meta": "0.75.482",
-    "@stacksjs/pagination": "0.75.482",
-    "@stacksjs/path": "0.75.482",
-    "@stacksjs/query-builder": "0.75.482",
-    "@stacksjs/realtime": "0.75.482",
-    "@stacksjs/router": "0.75.482",
-    "@stacksjs/storage": "0.75.482",
-    "@stacksjs/strings": "0.75.482",
+    "@stacksjs/cache": "0.75.483",
+    "@stacksjs/cli": "0.75.483",
+    "@stacksjs/config": "0.75.483",
+    "@stacksjs/database": "0.75.483",
+    "@stacksjs/env": "0.75.483",
+    "@stacksjs/error-handling": "0.75.483",
+    "@stacksjs/events": "0.75.483",
+    "@stacksjs/logging": "0.75.483",
+    "@stacksjs/model-meta": "0.75.483",
+    "@stacksjs/pagination": "0.75.483",
+    "@stacksjs/path": "0.75.483",
+    "@stacksjs/query-builder": "0.75.483",
+    "@stacksjs/realtime": "0.75.483",
+    "@stacksjs/router": "0.75.483",
+    "@stacksjs/storage": "0.75.483",
+    "@stacksjs/strings": "0.75.483",
     "@stacksjs/ts-validation": "^0.5.7",
-    "@stacksjs/validation": "0.75.482",
+    "@stacksjs/validation": "0.75.483",
     "bun-query-builder": "^0.3.38"
   },
   "peerDependencies": {
-    "@stacksjs/auth": "0.75.482",
-    "@stacksjs/payments": "0.75.482",
-    "@stacksjs/queue": "0.75.482",
-    "@stacksjs/search-engine": "0.75.482",
+    "@stacksjs/auth": "0.75.483",
+    "@stacksjs/payments": "0.75.483",
+    "@stacksjs/queue": "0.75.483",
+    "@stacksjs/search-engine": "0.75.483",
     "stripe": "23.0.0"
   },
   "peerDependenciesMeta": {
@@ -108,7 +108,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/types": "0.75.482",
+    "@stacksjs/types": "0.75.483",
     "better-dx": "^0.2.24",
     "stripe": "23.0.0"
   }