@stacksjs/orm 0.75.183 → 0.75.184

package/dist/auto-crud.d.ts

@@ -390,8 +390,8 @@ export declare const SYSTEM_COLUMNS: string[];
  *     get: (v) => null | ReturnType<unknown> | unknown,
  *     set: (v) => null | unknown | ReturnType<unknown.stringify>
  *   },
- *   datetime: { get: (v) => Date | null, set: (v) => unknown },
- *   date: { get: (v) => Date | null, set: (v) => unknown },
+ *   datetime: { get: (v) => null | unknown, set: (v) => ReturnType<unknown> | unknown },
+ *   date: { get: (v) => null | unknown, set: (v) => unknown },
  *   array: {
  *     get: (v) => never[] | unknown | ReturnType<unknown> | never[],
  *     set: (v) => null | ReturnType<unknown.stringify> | unknown

package/dist/auto-crud.js

@@ -1 +1 @@
-export{isUniqueViolation}from"@stacksjs/error-handling";import{isUniqueViolation}from"@stacksjs/error-handling";export function mapWriteError(err,modelName,op){const e=err;if(err instanceof Error&&typeof e.status==="number"&&Number.isInteger(e.status)&&e.status>=400&&e.status<600){const body={error:err.message};if(e.details!==void 0)body.details=e.details;return{status:e.status,body}}if(isUniqueViolation(err))return{status:409,body:{error:`${modelName} already exists`}};return{status:500,body:{error:`Failed to ${op} ${modelName}`,detail:String(err)}}}export function toSnakeCase(s){let hasUppercase=!1;for(let index=0;index<s.length;index++){const code=s.charCodeAt(index);if(code>127)return s.replace(/([a-z\d])([A-Z])/g,"$1_$2").replace(/([A-Z])([A-Z][a-z])/g,"$1_$2").toLowerCase();if(code>=65&&code<=90)hasUppercase=!0}if(!hasUppercase)return s;let result="";for(let index=0;index<s.length;index++){const code=s.charCodeAt(index);if(code<65||code>90){result+=s[index];continue}const previous=index>0?s.charCodeAt(index-1):0,next=index+1<s.length?s.charCodeAt(index+1):0,followsWord=previous>=97&&previous<=122||previous>=48&&previous<=57,endsAcronym=previous>=65&&previous<=90&&next>=97&&next<=122;if(index>0&&(followsWord||endsAcronym))result+="_";result+=String.fromCharCode(code+32)}return result}export function toSnakeCaseKeys(data){const out={};for(const[k,v]of Object.entries(data))out[toSnakeCase(k)]=v;return out}export function apiBasePath(uri,prefix){const cleanPrefix=String(prefix||"").replace(/^\/+|\/+$/g,""),cleanUri=String(uri).replace(/^\/+/,"");return`/api/${cleanPrefix?`${cleanPrefix}/`:""}${cleanUri}`}export function teamOwnershipField(model){if(!model)return null;const attributes=model.attributes??{};if(Object.prototype.hasOwnProperty.call(attributes,"teamId")||Object.prototype.hasOwnProperty.call(attributes,"team_id"))return"team_id";return model.belongsTo?.some((relation)=>relation==="Team")?"team_id":null}export function userOwnershipField(model){if(!model)return null;const attributes=model.attributes??{};if(Object.prototype.hasOwnProperty.call(attributes,"userId")||Object.prototype.hasOwnProperty.call(attributes,"user_id"))return"user_id";return model.belongsTo?.some((relation)=>relation==="User")?"user_id":null}export function ownershipDeclaredUnscoped(model){return model?.ownership===!1}export function stampOwnership(data,field,value){const ownerKey=Object.keys(data).find((key)=>toSnakeCase(key)===toSnakeCase(field));if(Array.isArray(value)){if(ownerKey===void 0)return{data,error:"Ownership value is required"};if(!value.some((allowed)=>String(allowed)===String(data[ownerKey])))return{data,error:"Ownership value is not available to this caller"};return{data:{...data,[field]:data[ownerKey]}}}if(value===null||value===void 0)return{data,error:"Caller has no ownership identity"};const stamped={...data};for(const key of Object.keys(stamped))if(toSnakeCase(key)===toSnakeCase(field))delete stamped[key];stamped[field]=value;return{data:stamped}}export function getWritableFields(model){if(!model)return[];const fields=Object.entries(model.attributes??{}).filter(([,attribute])=>attribute?.fillable===!0).map(([name])=>name);for(const relation of model.belongsTo??[]){if(typeof relation!=="string"||!relation.trim())continue;const words=toSnakeCase(relation.trim()).split("_").filter(Boolean);if(words.length===0)continue;const relationField=`${words[0]}${words.slice(1).map((word)=>`${word[0]?.toUpperCase()}${word.slice(1)}`).join("")}Id`;fields.push(relationField)}return[...new Set(fields)]}export function filterFillable(body,fillableFields){if(!body||fillableFields.length===0)return{};const result={};let snakeByField;for(const field of fillableFields){if(field in body){result[field]=body[field];continue}snakeByField??=resolveFieldSpellingMap(fillableFields);const snake=snakeByField.get(field);if(snake!==field&&snake in body)result[field]=body[snake]}return result}export function normalizeValidationValue(rule,value){if(rule?.name!=="date"||value instanceof Date||typeof value!=="string")return value;const match=/^(\d{4})-(\d{2})-(\d{2})$/.exec(value);if(!match)return value;const year=Number(match[1]),month=Number(match[2]),day=Number(match[3]),parsed=new Date(Date.UTC(year,month-1,day));if(parsed.getUTCFullYear()!==year||parsed.getUTCMonth()!==month-1||parsed.getUTCDate()!==day)return value;return parsed}const fieldSpellingsByList=new WeakMap,fieldSpellingMaps=new WeakMap;function resolveFieldSpellings(fields){const cached=fieldSpellingsByList.get(fields);if(cached&&cached.length===fields.length){let unchanged=!0;for(let index=0;index<fields.length;index++)if(cached[index]?.field!==fields[index]){unchanged=!1;break}if(unchanged)return cached}const resolved=fields.map((field)=>({field,snake:toSnakeCase(field)}));fieldSpellingsByList.set(fields,resolved);return resolved}function resolveFieldSpellingMap(fields){const spellings=resolveFieldSpellings(fields),cached=fieldSpellingMaps.get(spellings);if(cached)return cached;const resolved=new Map(spellings.map(({field,snake})=>[field,snake]));fieldSpellingMaps.set(spellings,resolved);return resolved}export function dropHiddenInputs(data,hiddenFields){if(!hiddenFields.length)return data;const out={...data};for(const{field,snake}of resolveFieldSpellings(hiddenFields)){delete out[field];if(snake!==field)delete out[snake]}return out}export function stripHidden(record,hiddenFields){if(!record||hiddenFields.length===0)return record;const result={...record};for(const{field,snake}of resolveFieldSpellings(hiddenFields)){delete result[field];if(snake!==field)delete result[snake]}return result}export const SYSTEM_COLUMNS=["id","uuid","created_at","updated_at","deleted_at"];export function buildReadColumnMap(attributes,hiddenFields){const map=new Map;for(const name of[...Object.keys(attributes??{}),...SYSTEM_COLUMNS]){const column=toSnakeCase(name);if(!/^\w+$/.test(column))continue;map.set(name,column);map.set(column,column)}for(const f of hiddenFields){map.delete(f);map.delete(toSnakeCase(f))}return map}export function applySorting(query,sortParam,columns){if(!sortParam)return query;let q=query;for(const rawToken of String(sortParam).split(",")){const tok=rawToken.trim();if(!tok)continue;const desc=tok.startsWith("-"),requested=desc?tok.slice(1):tok;if(!/^\w+$/.test(requested))continue;const column=columns.get(requested);if(!column)continue;q=q.orderBy(column,desc?"desc":"asc")}return q}export const AUTO_CRUD_CASTERS={string:{get:(v)=>v!=null?String(v):null,set:(v)=>v!=null?String(v):null},number:{get:(v)=>v!=null?Number(v):null,set:(v)=>v!=null?Number(v):null},integer:{get:(v)=>v!=null?Math.trunc(Number(v)):null,set:(v)=>v!=null?Math.trunc(Number(v)):null},float:{get:(v)=>v!=null?Number.parseFloat(String(v)):null,set:(v)=>v!=null?Number.parseFloat(String(v)):null},boolean:{get:(v)=>v===1||v==="1"||v===!0||v==="true",set:(v)=>v===!0||v===1||v==="1"||v==="true"?1:0},json:{get:(v)=>v==null?null:typeof v==="string"?safeJSON(v):v,set:(v)=>v==null?null:typeof v==="string"?v:JSON.stringify(v)},datetime:{get:(v)=>v?new Date(v):null,set:(v)=>v instanceof Date?v.toISOString():v},date:{get:(v)=>v?new Date(v):null,set:(v)=>v instanceof Date?v.toISOString().split("T")[0]:v},array:{get:(v)=>v==null?[]:Array.isArray(v)?v:typeof v==="string"?safeJSONOrEmpty(v):[],set:(v)=>v==null?null:Array.isArray(v)?JSON.stringify(v):v}};const autoCrudCastsByDefinition=new WeakMap;function resolveAutoCrudCasts(casts,attrs){const cached=autoCrudCastsByDefinition.get(casts);if(cached&&cached.length===attrs.length){let unchanged=!0;for(let index=0;index<attrs.length;index++){const attr=attrs[index];if(cached[index]?.attr!==attr||cached[index]?.definition!==casts[attr]){unchanged=!1;break}}if(unchanged)return cached}const resolved=[];for(const attr of attrs){const castDef=casts[attr],caster=typeof castDef==="string"?AUTO_CRUD_CASTERS[castDef]:castDef;resolved.push({attr,snake:toSnakeCase(attr),definition:castDef,caster})}autoCrudCastsByDefinition.set(casts,resolved);return resolved}function safeJSON(s){try{return JSON.parse(s)}catch{return s}}function safeJSONOrEmpty(_s){try{return JSON.parse(_s)}catch{return[]}}export function applyCasts(record,casts,direction){if(!record||typeof record!=="object"||!casts)return record;const attrs=Object.keys(casts);if(attrs.length===0)return record;const resolvedCasts=resolveAutoCrudCasts(casts,attrs);if(resolvedCasts.length===0)return record;const out={...record};for(const{attr,caster,snake}of resolvedCasts){if(!caster)continue;const cast=caster[direction];if(typeof cast!=="function")continue;if(Object.prototype.hasOwnProperty.call(out,attr))out[attr]=cast.call(caster,out[attr]);if(snake!==attr&&Object.prototype.hasOwnProperty.call(out,snake))out[snake]=cast.call(caster,out[snake])}return out}const writeValidatorsByAttributes=new WeakMap;function resolveWriteValidators(attributes){const cached=writeValidatorsByAttributes.get(attributes);if(cached)return cached;const validators=[];for(const[field,definition]of Object.entries(attributes)){const rule=definition?.validation?.rule;if(!rule||typeof rule.validate!=="function")continue;validators.push({definition,field,hasDefault:definition!==null&&typeof definition==="object"&&Object.prototype.hasOwnProperty.call(definition,"default"),rule})}writeValidatorsByAttributes.set(attributes,validators);return validators}export function hasWriteValidators(model){const attributes=model?.attributes;if(!attributes||typeof attributes!=="object")return!1;for(const definition of Object.values(attributes)){const rule=definition?.validation?.rule;if(rule&&typeof rule.validate==="function")return!0}return!1}export function validateWriteBody(data,model,hook){const attributes=model?.attributes;if(!attributes||typeof attributes!=="object")return{valid:!0};const validators=resolveWriteValidators(attributes);if(validators.length===0)return{valid:!0};const errors={};let hasErrors=!1;for(const validator of validators){const{definition,field,hasDefault,rule}=validator,present=Object.prototype.hasOwnProperty.call(data,field);if(!present&&hook==="updating")continue;const raw=present?data[field]:hasDefault?definition.default:void 0,value=normalizeValidationValue(rule,raw),result=rule.validate(value);if(!result?.valid&&Array.isArray(result?.errors)&&result.errors.length>0){hasErrors=!0;errors[field]=result.errors.map((e)=>definition.validation?.message?.[e?.code]??e?.message??"invalid")}}return hasErrors?{valid:!1,errors}:{valid:!0}}export function routeShapeKey(method,path){return`${method}\x00${routeShape(path)}`}export function indexRouteShapes(routes){const index=new Map;for(const route of routes){const key=routeShapeKey(String(route.method??""),String(route.path??""));if(!index.has(key))index.set(key,route)}return index}export function findShadowingRoute(routes,method,path){const shape=routeShape(path);return routes.find((r)=>r.method===method&&routeShape(String(r.path??""))===shape)}export function routeShape(path){return path.replace(/\{[^}]*\}/g,"{}").replace(/:[^/]+/g,"{}")}function middlewareList(raw){if(Array.isArray(raw))return raw.filter((m)=>typeof m==="string"&&m.length>0);return typeof raw==="string"&&raw?[raw]:[]}export function resolveApiMiddleware(useApi,dashboard){const declared=typeof useApi==="object"&&useApi!==null&&"middleware"in useApi,raw=useApi?.middleware,role=dashboardRoleMiddleware(dashboard);if(!declared)return{read:withDashboardRole(["auth"],role),write:withDashboardRole(["auth"],role),declared:!1};if(raw&&typeof raw==="object"&&!Array.isArray(raw)){const split=raw;return{read:withDashboardRole("read"in split?middlewareList(split.read):["auth"],role),write:withDashboardRole("write"in split?middlewareList(split.write):["auth"],role),declared:!0}}const list=middlewareList(raw);return{read:withDashboardRole(list,role),write:withDashboardRole(list,role),declared:!0}}export function dashboardRoleMiddleware(dashboard){if(!dashboard||typeof dashboard!=="object")return null;const options=dashboard;if(options.enforce===!1)return null;if(!Array.isArray(options.roles))return null;const roles=options.roles.filter((role)=>typeof role==="string").map((role)=>role.trim()).filter((role)=>role.length>0);return roles.length>0?`role:${roles.join(",")}`:null}export const API_ABILITIES=["index","show","store","update","destroy"];const ABILITY_SIDE={index:"read",show:"read",store:"write",update:"write",destroy:"write"};export function resolveAbilityMiddleware(useApi,dashboard){const{read,write,declared}=resolveApiMiddleware(useApi,dashboard),role=dashboardRoleMiddleware(dashboard),raw=useApi?.middleware,declaredPerAbility=raw&&typeof raw==="object"&&!Array.isArray(raw)?raw:void 0,abilities={};for(const ability of API_ABILITIES)abilities[ability]=declaredPerAbility&&ability in declaredPerAbility?withDashboardRole(middlewareList(declaredPerAbility[ability]),role):ABILITY_SIDE[ability]==="read"?read:write;return{abilities,read,write,declared}}function withDashboardRole(list,role){if(!role||list.length===0)return list;if(list.some((entry)=>entry==="role"||entry.startsWith("role:")))return list;return[...list,role]}export function describeContradictoryRoleGates(entries){if(entries.length===0)return null;const named=[...entries].sort((a,b)=>a.model.localeCompare(b.model)).map((entry)=>`${entry.model} (${[...entry.abilities].join(", ")})`).join(", ");return`[orm] ${entries.length} model(s) role-gate their sidebar row and publish part of the matching API to everyone, because \`useApi.middleware\` declares those abilities empty - ${named}. Drop the empty list to let \`dashboard.roles\` gate them, or set \`dashboard.enforce: false\` to keep the row hidden and the API public.`}export const POLICY_ABILITY={index:"viewAny",show:"view",store:"create",update:"update",destroy:"delete"};export async function policyDecision(modelName,ability,deps,subject){let gate;try{gate=await deps.gate()}catch{return null}if(!gate||!gate.hasPolicy(modelName))return null;try{const user=await deps.user(),verdict=subject===void 0?await gate.inspectFor(modelName,ability,user):await gate.inspectFor(modelName,ability,user,subject);if(verdict&&!verdict.isAllowed)return{status:403,message:verdict.message||"This action is unauthorized."};return null}catch{return{status:403,message:"This action is unauthorized."}}}export const INDEX_DEFAULT_PER_PAGE=15,INDEX_MAX_PER_PAGE=100;export function resolveIndexPageArgs(params){const pageRaw=Number.parseInt(params.get("page")||String(1),10),page=Number.isFinite(pageRaw)?Math.max(1,pageRaw):1,perPageRaw=Number.parseInt(params.get("per_page")||String(INDEX_DEFAULT_PER_PAGE),10),perPage=Math.min(Number.isFinite(perPageRaw)?Math.max(1,perPageRaw):INDEX_DEFAULT_PER_PAGE,INDEX_MAX_PER_PAGE);return{page,perPage,offset:(page-1)*perPage}}function pageUrl(url,page){const out=new URL(url.toString());out.searchParams.set("page",String(page));return`${out.pathname}${out.search}`}export function buildIndexMeta(url,page,perPage,rowCount,hasMore,total){const offset=(page-1)*perPage,empty=rowCount===0,meta={page,per_page:perPage,from:empty?null:offset+1,to:empty?null:offset+rowCount,has_more_pages:hasMore,prev_page_url:page>1?pageUrl(url,page-1):null,next_page_url:hasMore?pageUrl(url,page+1):null};if(total!==void 0&&!Number.isNaN(total)){const lastPage=Math.max(1,Math.ceil(total/perPage));meta.total=total;meta.last_page=lastPage;meta.first_page_url=pageUrl(url,1);meta.last_page_url=pageUrl(url,lastPage)}return meta}export function buildIndexPaginator(url,page,perPage,rowCount,hasMore,total){const{page:currentPage,...rest}=buildIndexMeta(url,page,perPage,rowCount,hasMore,total);return{current_page:currentPage,...rest}}export function resolveRowScopingPolicy(configured,envOverride){return(envOverride??configured??"").toString().trim().toLowerCase()==="warn"?"warn":"deny"}export function describeUnscopedMutatingModels(modelNames,policy){if(modelNames.length===0)return null;const names=[...modelNames].sort().join(", ");if(policy==="deny")return`[orm] security.api.rowScoping is 'deny': NOT registering store/update/destroy for ${modelNames.length} model(s) `+`with no row-level scoping \u2014 ${names}. Give a model an \`ownership\` config or a \`team_id\` column to restore its writes.`;return`[orm] ${modelNames.length} model(s) publish mutating routes with no row-level scoping, so an authenticated caller can write any row \u2014 `+`${names}. Scope one with an \`ownership\` config or a \`team_id\` column; intended for public catalog tables. Set \`security.api.rowScoping: 'deny'\` (config/security.ts) to stop generating these routes instead.`}
+export{isUniqueViolation}from"@stacksjs/error-handling";import{parseSqlDateTime,sqlDateTime}from"@stacksjs/database/runtime";import{isUniqueViolation}from"@stacksjs/error-handling";export function mapWriteError(err,modelName,op){const e=err;if(err instanceof Error&&typeof e.status==="number"&&Number.isInteger(e.status)&&e.status>=400&&e.status<600){const body={error:err.message};if(e.details!==void 0)body.details=e.details;return{status:e.status,body}}if(isUniqueViolation(err))return{status:409,body:{error:`${modelName} already exists`}};return{status:500,body:{error:`Failed to ${op} ${modelName}`,detail:String(err)}}}export function toSnakeCase(s){let hasUppercase=!1;for(let index=0;index<s.length;index++){const code=s.charCodeAt(index);if(code>127)return s.replace(/([a-z\d])([A-Z])/g,"$1_$2").replace(/([A-Z])([A-Z][a-z])/g,"$1_$2").toLowerCase();if(code>=65&&code<=90)hasUppercase=!0}if(!hasUppercase)return s;let result="";for(let index=0;index<s.length;index++){const code=s.charCodeAt(index);if(code<65||code>90){result+=s[index];continue}const previous=index>0?s.charCodeAt(index-1):0,next=index+1<s.length?s.charCodeAt(index+1):0,followsWord=previous>=97&&previous<=122||previous>=48&&previous<=57,endsAcronym=previous>=65&&previous<=90&&next>=97&&next<=122;if(index>0&&(followsWord||endsAcronym))result+="_";result+=String.fromCharCode(code+32)}return result}export function toSnakeCaseKeys(data){const out={};for(const[k,v]of Object.entries(data))out[toSnakeCase(k)]=v;return out}export function apiBasePath(uri,prefix){const cleanPrefix=String(prefix||"").replace(/^\/+|\/+$/g,""),cleanUri=String(uri).replace(/^\/+/,"");return`/api/${cleanPrefix?`${cleanPrefix}/`:""}${cleanUri}`}export function teamOwnershipField(model){if(!model)return null;const attributes=model.attributes??{};if(Object.prototype.hasOwnProperty.call(attributes,"teamId")||Object.prototype.hasOwnProperty.call(attributes,"team_id"))return"team_id";return model.belongsTo?.some((relation)=>relation==="Team")?"team_id":null}export function userOwnershipField(model){if(!model)return null;const attributes=model.attributes??{};if(Object.prototype.hasOwnProperty.call(attributes,"userId")||Object.prototype.hasOwnProperty.call(attributes,"user_id"))return"user_id";return model.belongsTo?.some((relation)=>relation==="User")?"user_id":null}export function ownershipDeclaredUnscoped(model){return model?.ownership===!1}export function stampOwnership(data,field,value){const ownerKey=Object.keys(data).find((key)=>toSnakeCase(key)===toSnakeCase(field));if(Array.isArray(value)){if(ownerKey===void 0)return{data,error:"Ownership value is required"};if(!value.some((allowed)=>String(allowed)===String(data[ownerKey])))return{data,error:"Ownership value is not available to this caller"};return{data:{...data,[field]:data[ownerKey]}}}if(value===null||value===void 0)return{data,error:"Caller has no ownership identity"};const stamped={...data};for(const key of Object.keys(stamped))if(toSnakeCase(key)===toSnakeCase(field))delete stamped[key];stamped[field]=value;return{data:stamped}}export function getWritableFields(model){if(!model)return[];const fields=Object.entries(model.attributes??{}).filter(([,attribute])=>attribute?.fillable===!0).map(([name])=>name);for(const relation of model.belongsTo??[]){if(typeof relation!=="string"||!relation.trim())continue;const words=toSnakeCase(relation.trim()).split("_").filter(Boolean);if(words.length===0)continue;const relationField=`${words[0]}${words.slice(1).map((word)=>`${word[0]?.toUpperCase()}${word.slice(1)}`).join("")}Id`;fields.push(relationField)}return[...new Set(fields)]}export function filterFillable(body,fillableFields){if(!body||fillableFields.length===0)return{};const result={};let snakeByField;for(const field of fillableFields){if(field in body){result[field]=body[field];continue}snakeByField??=resolveFieldSpellingMap(fillableFields);const snake=snakeByField.get(field);if(snake!==field&&snake in body)result[field]=body[snake]}return result}export function normalizeValidationValue(rule,value){if(rule?.name!=="date"||value instanceof Date||typeof value!=="string")return value;const match=/^(\d{4})-(\d{2})-(\d{2})$/.exec(value);if(!match)return value;const year=Number(match[1]),month=Number(match[2]),day=Number(match[3]),parsed=new Date(Date.UTC(year,month-1,day));if(parsed.getUTCFullYear()!==year||parsed.getUTCMonth()!==month-1||parsed.getUTCDate()!==day)return value;return parsed}const fieldSpellingsByList=new WeakMap,fieldSpellingMaps=new WeakMap;function resolveFieldSpellings(fields){const cached=fieldSpellingsByList.get(fields);if(cached&&cached.length===fields.length){let unchanged=!0;for(let index=0;index<fields.length;index++)if(cached[index]?.field!==fields[index]){unchanged=!1;break}if(unchanged)return cached}const resolved=fields.map((field)=>({field,snake:toSnakeCase(field)}));fieldSpellingsByList.set(fields,resolved);return resolved}function resolveFieldSpellingMap(fields){const spellings=resolveFieldSpellings(fields),cached=fieldSpellingMaps.get(spellings);if(cached)return cached;const resolved=new Map(spellings.map(({field,snake})=>[field,snake]));fieldSpellingMaps.set(spellings,resolved);return resolved}export function dropHiddenInputs(data,hiddenFields){if(!hiddenFields.length)return data;const out={...data};for(const{field,snake}of resolveFieldSpellings(hiddenFields)){delete out[field];if(snake!==field)delete out[snake]}return out}export function stripHidden(record,hiddenFields){if(!record||hiddenFields.length===0)return record;const result={...record};for(const{field,snake}of resolveFieldSpellings(hiddenFields)){delete result[field];if(snake!==field)delete result[snake]}return result}export const SYSTEM_COLUMNS=["id","uuid","created_at","updated_at","deleted_at"];export function buildReadColumnMap(attributes,hiddenFields){const map=new Map;for(const name of[...Object.keys(attributes??{}),...SYSTEM_COLUMNS]){const column=toSnakeCase(name);if(!/^\w+$/.test(column))continue;map.set(name,column);map.set(column,column)}for(const f of hiddenFields){map.delete(f);map.delete(toSnakeCase(f))}return map}export function applySorting(query,sortParam,columns){if(!sortParam)return query;let q=query;for(const rawToken of String(sortParam).split(",")){const tok=rawToken.trim();if(!tok)continue;const desc=tok.startsWith("-"),requested=desc?tok.slice(1):tok;if(!/^\w+$/.test(requested))continue;const column=columns.get(requested);if(!column)continue;q=q.orderBy(column,desc?"desc":"asc")}return q}export const AUTO_CRUD_CASTERS={string:{get:(v)=>v!=null?String(v):null,set:(v)=>v!=null?String(v):null},number:{get:(v)=>v!=null?Number(v):null,set:(v)=>v!=null?Number(v):null},integer:{get:(v)=>v!=null?Math.trunc(Number(v)):null,set:(v)=>v!=null?Math.trunc(Number(v)):null},float:{get:(v)=>v!=null?Number.parseFloat(String(v)):null,set:(v)=>v!=null?Number.parseFloat(String(v)):null},boolean:{get:(v)=>v===1||v==="1"||v===!0||v==="true",set:(v)=>v===!0||v===1||v==="1"||v==="true"?1:0},json:{get:(v)=>v==null?null:typeof v==="string"?safeJSON(v):v,set:(v)=>v==null?null:typeof v==="string"?v:JSON.stringify(v)},datetime:{get:(v)=>v==null||v===""?null:v instanceof Date?v:parseSqlDateTime(v),set:(v)=>v instanceof Date?sqlDateTime(v):v},date:{get:(v)=>v==null||v===""?null:v instanceof Date?v:parseSqlDateTime(v),set:(v)=>v instanceof Date?v.toISOString().split("T")[0]:v},array:{get:(v)=>v==null?[]:Array.isArray(v)?v:typeof v==="string"?safeJSONOrEmpty(v):[],set:(v)=>v==null?null:Array.isArray(v)?JSON.stringify(v):v}};const autoCrudCastsByDefinition=new WeakMap;function resolveAutoCrudCasts(casts,attrs){const cached=autoCrudCastsByDefinition.get(casts);if(cached&&cached.length===attrs.length){let unchanged=!0;for(let index=0;index<attrs.length;index++){const attr=attrs[index];if(cached[index]?.attr!==attr||cached[index]?.definition!==casts[attr]){unchanged=!1;break}}if(unchanged)return cached}const resolved=[];for(const attr of attrs){const castDef=casts[attr],caster=typeof castDef==="string"?AUTO_CRUD_CASTERS[castDef]:castDef;resolved.push({attr,snake:toSnakeCase(attr),definition:castDef,caster})}autoCrudCastsByDefinition.set(casts,resolved);return resolved}function safeJSON(s){try{return JSON.parse(s)}catch{return s}}function safeJSONOrEmpty(_s){try{return JSON.parse(_s)}catch{return[]}}export function applyCasts(record,casts,direction){if(!record||typeof record!=="object"||!casts)return record;const attrs=Object.keys(casts);if(attrs.length===0)return record;const resolvedCasts=resolveAutoCrudCasts(casts,attrs);if(resolvedCasts.length===0)return record;const out={...record};for(const{attr,caster,snake}of resolvedCasts){if(!caster)continue;const cast=caster[direction];if(typeof cast!=="function")continue;if(Object.prototype.hasOwnProperty.call(out,attr))out[attr]=cast.call(caster,out[attr]);if(snake!==attr&&Object.prototype.hasOwnProperty.call(out,snake))out[snake]=cast.call(caster,out[snake])}return out}const writeValidatorsByAttributes=new WeakMap;function resolveWriteValidators(attributes){const cached=writeValidatorsByAttributes.get(attributes);if(cached)return cached;const validators=[];for(const[field,definition]of Object.entries(attributes)){const rule=definition?.validation?.rule;if(!rule||typeof rule.validate!=="function")continue;validators.push({definition,field,hasDefault:definition!==null&&typeof definition==="object"&&Object.prototype.hasOwnProperty.call(definition,"default"),rule})}writeValidatorsByAttributes.set(attributes,validators);return validators}export function hasWriteValidators(model){const attributes=model?.attributes;if(!attributes||typeof attributes!=="object")return!1;for(const definition of Object.values(attributes)){const rule=definition?.validation?.rule;if(rule&&typeof rule.validate==="function")return!0}return!1}export function validateWriteBody(data,model,hook){const attributes=model?.attributes;if(!attributes||typeof attributes!=="object")return{valid:!0};const validators=resolveWriteValidators(attributes);if(validators.length===0)return{valid:!0};const errors={};let hasErrors=!1;for(const validator of validators){const{definition,field,hasDefault,rule}=validator,present=Object.prototype.hasOwnProperty.call(data,field);if(!present&&hook==="updating")continue;const raw=present?data[field]:hasDefault?definition.default:void 0,value=normalizeValidationValue(rule,raw),result=rule.validate(value);if(!result?.valid&&Array.isArray(result?.errors)&&result.errors.length>0){hasErrors=!0;errors[field]=result.errors.map((e)=>definition.validation?.message?.[e?.code]??e?.message??"invalid")}}return hasErrors?{valid:!1,errors}:{valid:!0}}export function routeShapeKey(method,path){return`${method}\x00${routeShape(path)}`}export function indexRouteShapes(routes){const index=new Map;for(const route of routes){const key=routeShapeKey(String(route.method??""),String(route.path??""));if(!index.has(key))index.set(key,route)}return index}export function findShadowingRoute(routes,method,path){const shape=routeShape(path);return routes.find((r)=>r.method===method&&routeShape(String(r.path??""))===shape)}export function routeShape(path){return path.replace(/\{[^}]*\}/g,"{}").replace(/:[^/]+/g,"{}")}function middlewareList(raw){if(Array.isArray(raw))return raw.filter((m)=>typeof m==="string"&&m.length>0);return typeof raw==="string"&&raw?[raw]:[]}export function resolveApiMiddleware(useApi,dashboard){const declared=typeof useApi==="object"&&useApi!==null&&"middleware"in useApi,raw=useApi?.middleware,role=dashboardRoleMiddleware(dashboard);if(!declared)return{read:withDashboardRole(["auth"],role),write:withDashboardRole(["auth"],role),declared:!1};if(raw&&typeof raw==="object"&&!Array.isArray(raw)){const split=raw;return{read:withDashboardRole("read"in split?middlewareList(split.read):["auth"],role),write:withDashboardRole("write"in split?middlewareList(split.write):["auth"],role),declared:!0}}const list=middlewareList(raw);return{read:withDashboardRole(list,role),write:withDashboardRole(list,role),declared:!0}}export function dashboardRoleMiddleware(dashboard){if(!dashboard||typeof dashboard!=="object")return null;const options=dashboard;if(options.enforce===!1)return null;if(!Array.isArray(options.roles))return null;const roles=options.roles.filter((role)=>typeof role==="string").map((role)=>role.trim()).filter((role)=>role.length>0);return roles.length>0?`role:${roles.join(",")}`:null}export const API_ABILITIES=["index","show","store","update","destroy"];const ABILITY_SIDE={index:"read",show:"read",store:"write",update:"write",destroy:"write"};export function resolveAbilityMiddleware(useApi,dashboard){const{read,write,declared}=resolveApiMiddleware(useApi,dashboard),role=dashboardRoleMiddleware(dashboard),raw=useApi?.middleware,declaredPerAbility=raw&&typeof raw==="object"&&!Array.isArray(raw)?raw:void 0,abilities={};for(const ability of API_ABILITIES)abilities[ability]=declaredPerAbility&&ability in declaredPerAbility?withDashboardRole(middlewareList(declaredPerAbility[ability]),role):ABILITY_SIDE[ability]==="read"?read:write;return{abilities,read,write,declared}}function withDashboardRole(list,role){if(!role||list.length===0)return list;if(list.some((entry)=>entry==="role"||entry.startsWith("role:")))return list;return[...list,role]}export function describeContradictoryRoleGates(entries){if(entries.length===0)return null;const named=[...entries].sort((a,b)=>a.model.localeCompare(b.model)).map((entry)=>`${entry.model} (${[...entry.abilities].join(", ")})`).join(", ");return`[orm] ${entries.length} model(s) role-gate their sidebar row and publish part of the matching API to everyone, because \`useApi.middleware\` declares those abilities empty - ${named}. Drop the empty list to let \`dashboard.roles\` gate them, or set \`dashboard.enforce: false\` to keep the row hidden and the API public.`}export const POLICY_ABILITY={index:"viewAny",show:"view",store:"create",update:"update",destroy:"delete"};export async function policyDecision(modelName,ability,deps,subject){let gate;try{gate=await deps.gate()}catch{return null}if(!gate||!gate.hasPolicy(modelName))return null;try{const user=await deps.user(),verdict=subject===void 0?await gate.inspectFor(modelName,ability,user):await gate.inspectFor(modelName,ability,user,subject);if(verdict&&!verdict.isAllowed)return{status:403,message:verdict.message||"This action is unauthorized."};return null}catch{return{status:403,message:"This action is unauthorized."}}}export const INDEX_DEFAULT_PER_PAGE=15,INDEX_MAX_PER_PAGE=100;export function resolveIndexPageArgs(params){const pageRaw=Number.parseInt(params.get("page")||String(1),10),page=Number.isFinite(pageRaw)?Math.max(1,pageRaw):1,perPageRaw=Number.parseInt(params.get("per_page")||String(INDEX_DEFAULT_PER_PAGE),10),perPage=Math.min(Number.isFinite(perPageRaw)?Math.max(1,perPageRaw):INDEX_DEFAULT_PER_PAGE,INDEX_MAX_PER_PAGE);return{page,perPage,offset:(page-1)*perPage}}function pageUrl(url,page){const out=new URL(url.toString());out.searchParams.set("page",String(page));return`${out.pathname}${out.search}`}export function buildIndexMeta(url,page,perPage,rowCount,hasMore,total){const offset=(page-1)*perPage,empty=rowCount===0,meta={page,per_page:perPage,from:empty?null:offset+1,to:empty?null:offset+rowCount,has_more_pages:hasMore,prev_page_url:page>1?pageUrl(url,page-1):null,next_page_url:hasMore?pageUrl(url,page+1):null};if(total!==void 0&&!Number.isNaN(total)){const lastPage=Math.max(1,Math.ceil(total/perPage));meta.total=total;meta.last_page=lastPage;meta.first_page_url=pageUrl(url,1);meta.last_page_url=pageUrl(url,lastPage)}return meta}export function buildIndexPaginator(url,page,perPage,rowCount,hasMore,total){const{page:currentPage,...rest}=buildIndexMeta(url,page,perPage,rowCount,hasMore,total);return{current_page:currentPage,...rest}}export function resolveRowScopingPolicy(configured,envOverride){return(envOverride??configured??"").toString().trim().toLowerCase()==="warn"?"warn":"deny"}export function describeUnscopedMutatingModels(modelNames,policy){if(modelNames.length===0)return null;const names=[...modelNames].sort().join(", ");if(policy==="deny")return`[orm] security.api.rowScoping is 'deny': NOT registering store/update/destroy for ${modelNames.length} model(s) `+`with no row-level scoping \u2014 ${names}. Give a model an \`ownership\` config or a \`team_id\` column to restore its writes.`;return`[orm] ${modelNames.length} model(s) publish mutating routes with no row-level scoping, so an authenticated caller can write any row \u2014 `+`${names}. Scope one with an \`ownership\` config or a \`team_id\` column; intended for public catalog tables. Set \`security.api.rowScoping: 'deny'\` (config/security.ts) to stop generating these routes instead.`}

package/dist/define-model.d.ts

@@ -85,6 +85,41 @@ export declare function toAttrs<T = unknown>(value: unknown): T;
  * dist-only-app split makes that a real arrangement, not a hypothetical.
  */
 export declare const MODEL_DEFINITION: unique symbol;
+/**
+ * @defaultValue
+ * ```ts
+ * {
+ *   string: {
+ *     get: (v) => ReturnType<unknown> | null,
+ *     set: (v) => ReturnType<unknown> | null
+ *   },
+ *   number: {
+ *     get: (v) => ReturnType<unknown> | null,
+ *     set: (v) => ReturnType<unknown> | null
+ *   },
+ *   integer: {
+ *     get: (v) => ReturnType<unknown.trunc> | null,
+ *     set: (v) => ReturnType<unknown.trunc> | null
+ *   },
+ *   float: {
+ *     get: (v) => ReturnType<unknown.parseFloat> | null,
+ *     set: (v) => ReturnType<unknown.parseFloat> | null
+ *   },
+ *   boolean: { get: (v) => boolean, set: (v) => number },
+ *   json: {
+ *     get: (v) => unknown,
+ *     set: (v) => null | unknown | ReturnType<unknown.stringify>
+ *   },
+ *   datetime: { get: (v) => null | unknown, set: (v) => ReturnType<unknown> | unknown },
+ *   date: { get: (v) => null | unknown, set: (v) => unknown },
+ *   array: {
+ *     get: (v) => unknown,
+ *     set: (v) => null | ReturnType<unknown.stringify> | unknown
+ *   }
+ * }
+ * ```
+ */
+export declare const builtInCasters: Record<CastType, CasterInterface>;
 /**
  * Custom caster interface for user-defined attribute transformations.
  */

package/dist/define-model.js

@@ -1 +1 @@
-import{createModel,registerModel}from"@stacksjs/query-builder";import{log}from"@stacksjs/logging/runtime";import{snakeCase}from"@stacksjs/strings";import{AsyncLocalStorage}from"node:async_hooks";import{toCursorPaginator,toPaginator,toSimplePaginator}from"@stacksjs/pagination";import{enrichPaginatorUrls,resolveCursorArgs,resolvePageArgs}from"./paginator-request";import{hasWriteValidators,validateWriteBody}from"./auto-crud";let modelEventsModule;const eventSuppression=new AsyncLocalStorage;function eventsAreSuppressed(){return eventSuppression.getStore()?.suppressed===!0}export function withoutEvents(fn){return Promise.resolve(eventSuppression.run({suppressed:!0},fn))}const validationSuppression=new AsyncLocalStorage;function validationIsSuppressed(){return validationSuppression.getStore()?.suppressed===!0}export function withoutValidation(fn){return Promise.resolve(validationSuppression.run({suppressed:!0},fn))}export const MODEL_DEFINITION=Symbol.for("stacks.orm.modelDefinition");export class ModelValidationError extends Error{status=422;errors;constructor(modelName,errors){const fields=Object.keys(errors).join(", ");super(`${modelName} validation failed: ${fields}`);this.name="ModelValidationError";this.errors=errors}}const jsonParseFailureSeen=new Set,COLUMN_NAME_CACHE_LIMIT=4096,columnNameCache=Object.create(null);let columnNameCacheSize=0;function toColumnName(attribute){const cached=columnNameCache[attribute];if(cached!==void 0)return cached;const column=snakeCase(attribute);if(columnNameCacheSize<COLUMN_NAME_CACHE_LIMIT){columnNameCache[attribute]=column;columnNameCacheSize++}return column}function logJsonParseFailure(raw,err){const preview=typeof raw==="string"?raw.slice(0,80):String(raw),key=`${typeof raw}:${preview}`;if(jsonParseFailureSeen.has(key))return;jsonParseFailureSeen.add(key);const message=err instanceof Error?err.message:String(err);console.error(`[orm] JSON cast failed to parse value (returning null): ${message} - value preview: ${JSON.stringify(preview)}`)}const builtInCasters={string:{get:(v)=>v!=null?String(v):null,set:(v)=>v!=null?String(v):null},number:{get:(v)=>v!=null?Number(v):null,set:(v)=>v!=null?Number(v):null},integer:{get:(v)=>v!=null?Math.trunc(Number(v)):null,set:(v)=>v!=null?Math.trunc(Number(v)):null},float:{get:(v)=>v!=null?Number.parseFloat(String(v)):null,set:(v)=>v!=null?Number.parseFloat(String(v)):null},boolean:{get:(v)=>v===1||v==="1"||v===!0||v==="true",set:(v)=>v===!0||v===1||v==="1"||v==="true"?1:0},json:{get:(v)=>{if(v==null)return null;if(typeof v==="string")try{return JSON.parse(v)}catch(err){logJsonParseFailure(v,err);return null}return v},set:(v)=>{if(v==null)return null;return typeof v==="string"?v:JSON.stringify(v)}},datetime:{get:(v)=>v?new Date(v):null,set:(v)=>v instanceof Date?v.toISOString():v},date:{get:(v)=>v?new Date(v):null,set:(v)=>v instanceof Date?v.toISOString().split("T")[0]:v},array:{get:(v)=>{if(v==null)return[];if(Array.isArray(v))return v;if(typeof v==="string")try{return JSON.parse(v)}catch{return[]}return[]},set:(v)=>{if(v==null)return null;return Array.isArray(v)?JSON.stringify(v):v}}};function resolveCaster(cast){return typeof cast==="string"?builtInCasters[cast]:cast}const resolvedModelCastsByDefinition=new WeakMap;function resolveModelCasts(casts){const attrs=Object.keys(casts),cached=resolvedModelCastsByDefinition.get(casts);if(cached&&cached.length===attrs.length){let unchanged=!0;for(let index=0;index<attrs.length;index++){const attr=attrs[index];if(cached[index]?.attr!==attr||cached[index]?.definition!==casts[attr]){unchanged=!1;break}}if(unchanged)return cached}const resolved=attrs.map((attr)=>{const definition=casts[attr];return{attr,definition,caster:resolveCaster(definition)}});resolvedModelCastsByDefinition.set(casts,resolved);return resolved}function castAttributes(row,casts,direction){if(!row||typeof row!=="object")return row;const result={...row};for(const{attr,caster}of resolveModelCasts(casts))if(attr in result)result[attr]=caster[direction].call(caster,result[attr]);return result}function isModelInstanceInternalKey(key){return key==="_attributes"||key==="_original"||key==="_definition"||key==="_hasSaved"||key==="_relations"}const STACKS_PROXY_TAG=Symbol.for("stacks.modelInstanceProxy");let defaultModelInstanceProxyHandler;const castModelInstanceProxyHandlers=new WeakMap,TRAIT_INSTANCE_METHOD_BINDINGS={messenger:{bag:"_messaging",mode:"id"},tags:{bag:"_taggable",mode:"id"},tagCount:{bag:"_taggable",mode:"id"},addTag:{bag:"_taggable",mode:"id"},activeTags:{bag:"_taggable",mode:"id"},inactiveTags:{bag:"_taggable",mode:"id"},removeTag:{bag:"_taggable",mode:"id"},categories:{bag:"_categorizable",mode:"id"},categoryCount:{bag:"_categorizable",mode:"id"},addCategory:{bag:"_categorizable",mode:"id"},activeCategories:{bag:"_categorizable",mode:"id"},inactiveCategories:{bag:"_categorizable",mode:"id"},removeCategory:{bag:"_categorizable",mode:"id"},comments:{bag:"_commentable",mode:"id"},commentCount:{bag:"_commentable",mode:"id"},addComment:{bag:"_commentable",mode:"id"},approvedComments:{bag:"_commentable",mode:"id"},pendingComments:{bag:"_commentable",mode:"id"},rejectedComments:{bag:"_commentable",mode:"id"},likes:{bag:"_likeable",mode:"id"},likeCount:{bag:"_likeable",mode:"id"},like:{bag:"_likeable",mode:"id"},unlike:{bag:"_likeable",mode:"id"},isLiked:{bag:"_likeable",mode:"id"},...Object.fromEntries(BILLABLE_INSTANCE_METHODS.map((name)=>[name,{bag:"_billable",mode:"model"}])),generateTwoFactorForModel:{bag:"_twoFactor",mode:"model"},verifyTwoFactorCode:{bag:"_twoFactor",mode:"model"}};function resolveRelationPath(relations,path){if(!relations||!path)return null;const segments=path.split(".");let current=relations;for(const segment of segments){if(current==null||typeof current!=="object")return null;const obj=current;if("_attributes"in obj&&obj._attributes&&typeof obj._attributes==="object"){const attrs=obj._attributes;if(segment in attrs){current=attrs[segment];continue}}if(segment in obj){current=obj[segment];continue}return null}return current??null}function keepWrapped(result,raw,wrapped){if(result&&typeof result.then==="function")return result.then((value)=>value===raw?wrapped:value);return result===raw?wrapped:result}function wrapModelInstance(instance,casts){if(!instance||typeof instance!=="object")return instance;const candidate=instance;if(candidate[STACKS_PROXY_TAG])return instance;const attrs=candidate._attributes;if(!attrs||typeof attrs!=="object")return instance;if(casts){for(const{attr,caster}of resolveModelCasts(casts))if(Object.hasOwn(attrs,attr))attrs[attr]=caster.get.call(caster,attrs[attr])}let handler=casts?castModelInstanceProxyHandlers.get(casts):defaultModelInstanceProxyHandler;if(!handler){handler={get(rawTarget,prop,recv){const target=rawTarget;if(prop===STACKS_PROXY_TAG)return!0;if(prop==="saveAsync")return async function(){const def=target._definition,setters=def?.set;if(setters&&typeof target.isDirty==="function"){for(const[key,fn]of Object.entries(setters)){if(typeof fn!=="function")continue;if(!target.isDirty(key))continue;const result=fn(target._attributes),value=result&&typeof result.then==="function"?await result:result;target._attributes[key]=value}const original=def.set;def.set={};try{return keepWrapped(target.save(),rawTarget,recv)}finally{def.set=original}}return keepWrapped(target.save(),rawTarget,recv)};if(prop==="save")return function(){const def=target._definition,setters=def?.set;if(setters&&Object.keys(setters).length>0&&typeof target.isDirty==="function"){for(const[key,fn]of Object.entries(setters)){if(typeof fn!=="function")continue;if(!target.isDirty(key))continue;const result=fn(target._attributes);if(result&&typeof result.then==="function")throw Error(`Setter for "${key}" returned a Promise - use \`saveAsync()\` instead of \`save()\` when a model has async setters.`);target._attributes[key]=result}const original=def.set;def.set={};try{return keepWrapped(target.save(),rawTarget,recv)}finally{def.set=original}}return keepWrapped(target.save(),rawTarget,recv)};if(prop==="updateAsync")return async function(data){if(data&&typeof data==="object"&&!Array.isArray(data))for(const[k,v]of Object.entries(data))recv[k]=v;return recv.saveAsync()};if(prop==="saveQuietly")return function(){return withoutEvents(()=>target.save())};if(prop==="saveAsyncQuietly")return function(){return withoutEvents(()=>recv.saveAsync())};if(prop==="updateQuietly")return function(data){return withoutEvents(()=>target.update(data))};if(prop==="updateAsyncQuietly")return function(data){return withoutEvents(()=>recv.updateAsync(data))};if(prop==="deleteQuietly")return function(){return withoutEvents(()=>target.delete())};if(prop==="toSearchableObject")return function toSearchableObject(){const search=target._definition?.traits?.useSearch;if(!search)return null;const attrs=target._attributes;if(!attrs)return null;if(search===!0){const doc={...attrs};if(attrs.id!=null)doc.id=String(attrs.id);return doc}const doc={},keys=search.displayable?.length?search.displayable:[...search.searchable??[],...search.filterable??[],...search.sortable??[],"id"],denormalize=search.denormalize??{},relations=target._relations;for(const key of keys){const snake=snakeCase(key),own=attrs[snake]??attrs[key];if(own!==void 0){doc[snake]=own;continue}const path=denormalize[key]??denormalize[snake];if(path){doc[snake]=resolveRelationPath(relations,path);continue}doc[snake]=void 0}if(attrs.id!=null)doc.id=String(attrs.id);return doc};if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const a=target._attributes;if(a&&Object.hasOwn(a,prop))return a[prop];const rels=target._relations;if(rels&&Object.hasOwn(rels,prop)){const related=rels[prop];if(Array.isArray(related))return related.map((x)=>wrapModelInstance(x,casts));return related&&typeof related==="object"?wrapModelInstance(related,casts):related}const binding=TRAIT_INSTANCE_METHOD_BINDINGS[prop];if(binding){const fn=target._definition?.__traitMethods?.[binding.bag]?.[prop];if(typeof fn==="function")return binding.mode==="model"?(...args)=>fn(recv,...args):(...args)=>fn(target.id,...args)}if(a){const column=toColumnName(prop);if(column!==prop&&Object.hasOwn(a,column))return a[column]}}const v=Reflect.get(target,prop,target);return typeof v==="function"?v.bind(target):v},set(rawTarget,prop,value,recv){const target=rawTarget;if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const{_attributes:a,set:setter}=target;if(a&&Object.hasOwn(a,prop)){if(typeof setter==="function")setter.call(target,prop,value);else a[prop]=value;return!0}if(a){const column=toColumnName(prop);if(column!==prop&&Object.hasOwn(a,column)){if(typeof setter==="function")setter.call(target,column,value);else a[column]=value;return!0}}if(a&&!(prop in target)){if(typeof setter==="function")setter.call(target,prop,value);else a[prop]=value;return!0}}return Reflect.set(target,prop,value,recv)},has(rawTarget,prop){const target=rawTarget;if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const a=target._attributes;if(a&&Object.hasOwn(a,prop))return!0;const rels=target._relations;if(rels&&Object.hasOwn(rels,prop))return!0;if(a){const column=toColumnName(prop);if(column!==prop&&Object.hasOwn(a,column))return!0}}return Reflect.has(target,prop)},deleteProperty(rawTarget,prop){const target=rawTarget;if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const a=target._attributes;if(a&&Object.hasOwn(a,prop)){delete a[prop];return!0}}return Reflect.deleteProperty(target,prop)},ownKeys(rawTarget){const a=rawTarget._attributes;return a?Object.keys(a):[]},getOwnPropertyDescriptor(rawTarget,prop){const target=rawTarget;if(typeof prop==="string"){const a=target._attributes;if(a&&Object.hasOwn(a,prop))return{configurable:!0,enumerable:!0,value:a[prop],writable:!0}}return Object.getOwnPropertyDescriptor(target,prop)}};if(casts)castModelInstanceProxyHandlers.set(casts,handler);else defaultModelInstanceProxyHandler=handler}return new Proxy(instance,handler)}const QB_TERMINATORS=Object.assign(Object.create(null),{get:!0,first:!0,last:!0,firstOrFail:!0,find:!0,findOrFail:!0,all:!0,paginate:!0,simplePaginate:!0,cursorPaginate:!0}),PAGINATE_ADAPTERS={paginate:toPaginator,simplePaginate:toSimplePaginator,cursorPaginate:toCursorPaginator},STACKS_QB_PROXY_TAG=Symbol.for("stacks.queryBuilderProxy");function finalizeQueryResult(result,propName,casts){if(QB_TERMINATORS[propName]){if(Array.isArray(result))return result.map((item)=>wrapModelInstance(item,casts));const adapter=PAGINATE_ADAPTERS[propName];if(adapter&&result&&Array.isArray(result.data)){const wrappedData=result.data.map((item)=>wrapModelInstance(item,casts)),canonical=adapter({...result,data:wrappedData});return enrichPaginatorUrls(canonical)}if(result&&Array.isArray(result.data))return{...result,data:result.data.map((item)=>wrapModelInstance(item,casts))};return wrapModelInstance(result,casts)}if(result&&typeof result==="object"&&typeof result.get==="function")return wrapQueryBuilder(result,casts);return result}function wrapQueryBuilder(qb,casts){if(!qb||typeof qb!=="object")return qb;if(qb[STACKS_QB_PROXY_TAG])return qb;return new Proxy(qb,{get(target,prop,recv){if(prop===STACKS_QB_PROXY_TAG)return!0;const v=Reflect.get(target,prop,recv);if(typeof v!=="function")return v;const propName=String(prop);return function(...args){let callArgs=args;if(propName==="paginate"||propName==="simplePaginate"){const{perPage,page}=resolvePageArgs(args[0],args[1]);callArgs=[perPage,page]}else if(propName==="cursorPaginate"){const{perPage,cursor}=resolveCursorArgs(args[0],args[1]);callArgs=[perPage,cursor,args[2],args[3]]}const result=v.apply(target,callArgs);if(!QB_TERMINATORS[propName]&&result===target)return recv;if(result&&typeof result.then==="function")return result.then((resolved)=>finalizeQueryResult(resolved,propName,casts));return finalizeQueryResult(result,propName,casts)}}})}function wrapReadsWithProxy(baseModel,casts){const applyReadResult=(result)=>Array.isArray(result)?result.map((item)=>wrapModelInstance(item,casts)):wrapModelInstance(result,casts),directReads=["find","first","last","all","firstOrFail","findOrFail","findMany"];for(const method of directReads){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=function(...args){const result=original.apply(this,args);if(result&&typeof result.then==="function")return result.then(applyReadResult);return applyReadResult(result)}}const writeReturningInstance=["create","createMany","firstOrCreate","updateOrCreate","make"];for(const method of writeReturningInstance){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=function(...args){const result=original.apply(this,args);if(result&&typeof result.then==="function")return result.then(applyReadResult);return applyReadResult(result)}}const queryBuilderEntrypoints=["query","where","orWhere","whereIn","whereNotIn","whereNull","whereNotNull","whereLike","whereBetween","whereNotBetween","orderBy","orderByDesc","select","with","limit","take","skip","latest","oldest"];for(const method of queryBuilderEntrypoints){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=function(...args){const qb=original.apply(this,args);return wrapQueryBuilder(qb,casts)}}}export class ModelNotFoundError extends Error{model;id;constructor(model,id){super(id!=null?`[ORM] ${model} not found for id=${String(id)}`:`[ORM] No matching ${model} row`);this.name="ModelNotFoundError";this.model=model;this.id=id}}export class MassAssignmentException extends Error{model;attribute;reason;constructor(model,attribute,reason){const why=reason==="guarded"?`'${attribute}' is marked guarded`:`'${attribute}' is not in the fillable allowlist`;super(`[ORM] Mass assignment to ${model} forbidden: ${why}. Use ${model}.forceCreate(...) / .forceUpdate(...) to bypass.`);this.name="MassAssignmentException";this.model=model;this.attribute=attribute;this.reason=reason}}const MASS_ASSIGNMENT_SYSTEM_COLUMNS=new Set(["id","created_at","updated_at","deleted_at","uuid"]),massAssignmentRuleSets=new WeakMap;function resolveMassAssignmentRuleSet(attrs){const cached=massAssignmentRuleSets.get(attrs);if(cached)return cached;const declared=new Set,fillable=new Set,guarded=new Set;for(const[key,attribute]of Object.entries(attrs)){const column=toColumnName(key);declared.add(column);if(attribute?.fillable===!0)fillable.add(column);if(attribute?.guarded===!0)guarded.add(column)}const rules={allowed:fillable.size>0?fillable:declared,guarded};massAssignmentRuleSets.set(attrs,rules);return rules}function applyMassAssignmentRules(definition,data,options={}){if(options.force)return data;if(!data||typeof data!=="object"||Array.isArray(data))return data;const attrs=definition.attributes;if(!attrs)return data;const{allowed,guarded}=resolveMassAssignmentRuleSet(attrs);for(const key in data){if(!Object.hasOwn(data,key))continue;const col=toColumnName(key);if(MASS_ASSIGNMENT_SYSTEM_COLUMNS.has(col))continue;if(guarded.has(col))throw new MassAssignmentException(definition.name,key,"guarded");if(col.endsWith("_id"))continue;if(!allowed.has(col))throw new MassAssignmentException(definition.name,key,"not-fillable")}return data}async function applyDefinedSetters(definition,data){const setters=definition.set;if(!setters||typeof setters!=="object")return data;const out={...data};for(const[key,fn]of Object.entries(setters)){if(typeof fn!=="function"||!(key in out))continue;try{out[key]=await fn(out)}catch(err){log.error(`[orm] ${definition.name}.set.${key} threw - skipping setter`,err)}}return out}function addStaticHelpers(baseModel,definition){const pk=definition.primaryKey||"id",unwrappedCreate=baseModel.create;function getWhere(method){const w=baseModel.where;if(typeof w!=="function")throw Error(`[ORM] ${definition.name}.${method} needs a working where(): the underlying query builder did not expose one`);return w}function getFind(method){const f=baseModel.find;if(typeof f!=="function")throw Error(`[ORM] ${definition.name}.${method} needs a working find(): the underlying query builder did not expose one`);return f}function getCreate(method){const c=baseModel.create;if(typeof c!=="function")throw Error(`[ORM] ${definition.name}.${method} cannot create: the underlying query builder did not expose create()`);return c}baseModel.update=async function(id,data){if(id==null)throw Error(`[ORM] ${definition.name}.update requires an id as the first argument`);if(!data||typeof data!=="object"||Array.isArray(data))throw Error(`[ORM] ${definition.name}.update requires a data object as the second argument`);if(Object.keys(data).length===0){log.debug(`[orm] ${definition.name}.update called with empty data - short-circuiting and returning current row`);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):null}applyMassAssignmentRules(definition,data);const finalData=await applyDefinedSetters(definition,data);await getWhere("update").call(baseModel,pk,id).update(finalData);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):null};if(typeof baseModel.forceUpdate!=="function")baseModel.forceUpdate=async function(id,data){if(id==null)throw Error(`[ORM] ${definition.name}.forceUpdate requires an id as the first argument`);if(!data||typeof data!=="object"||Array.isArray(data))throw Error(`[ORM] ${definition.name}.forceUpdate requires a data object as the second argument`);const finalData=await applyDefinedSetters(definition,data);await getWhere("forceUpdate").call(baseModel,pk,id).update(finalData);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):null};if(typeof baseModel.forceCreate!=="function")baseModel.forceCreate=async function(data){if(!data||typeof data!=="object"||Array.isArray(data))throw Error(`[ORM] ${definition.name}.forceCreate requires a data object`);const make=baseModel.make;if(typeof make==="function"){const instance=await make.call(baseModel);if(instance&&typeof instance.forceFill==="function"&&typeof instance.save==="function"){instance.forceFill(data);const saved=await instance.save();return saved&&typeof saved==="object"&&saved!==instance&&!saved[STACKS_PROXY_TAG]?instance:saved??instance}}if(typeof unwrappedCreate!=="function")throw Error(`[ORM] ${definition.name}.forceCreate cannot create: the underlying query builder did not expose create()`);return await unwrappedCreate.call(baseModel,data)};baseModel.delete=async function(id){if(id==null)throw Error(`[ORM] ${definition.name}.delete requires an id as the first argument`);if(!await getFind("delete").call(baseModel,id))return!1;await getWhere("delete").call(baseModel,pk,id).delete();return!0};if(typeof baseModel.findOrFail!=="function")baseModel.findOrFail=async function(id){const row=await getFind("findOrFail").call(baseModel,id);if(row==null)throw new ModelNotFoundError(definition.name,id);return row};if(typeof baseModel.exists!=="function")baseModel.exists=async function(id){if(id==null)return!1;const q=getWhere("exists").call(baseModel,pk,id);if(typeof q.count==="function"){const n=await q.count();return Number(n)>0}const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id)!=null:!1};if(typeof baseModel.firstOrCreate!=="function")baseModel.firstOrCreate=async function(attrs,defaults={}){if(!attrs||typeof attrs!=="object"||Array.isArray(attrs))throw Error(`[ORM] ${definition.name}.firstOrCreate requires a where-attrs object`);const q=getWhere("firstOrCreate").call(baseModel,attrs),existing=typeof q.first==="function"?await q.first():await q;if(existing)return existing;const payload={...attrs,...defaults};applyMassAssignmentRules(definition,payload);return await getCreate("firstOrCreate").call(baseModel,payload)};if(typeof baseModel.updateOrCreate!=="function")baseModel.updateOrCreate=async function(attrs,values){if(!attrs||typeof attrs!=="object"||Array.isArray(attrs))throw Error(`[ORM] ${definition.name}.updateOrCreate requires a where-attrs object`);if(!values||typeof values!=="object"||Array.isArray(values))throw Error(`[ORM] ${definition.name}.updateOrCreate requires a values object`);const q=getWhere("updateOrCreate").call(baseModel,attrs),existing=typeof q.first==="function"?await q.first():await q;if(existing){applyMassAssignmentRules(definition,values);const id=existing[pk];await getWhere("updateOrCreate").call(baseModel,pk,id).update(values);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):{...existing,...values}}const payload={...attrs,...values};applyMassAssignmentRules(definition,payload);return await getCreate("updateOrCreate").call(baseModel,payload)};if(typeof baseModel.count!=="function")baseModel.count=async function(){const q=baseModel;if(typeof q.query==="function"){const builder=q.query();if(typeof builder?.count==="function"){const n=await builder.count();return Number(n)||0}}const{all,get}=baseModel;if(typeof all==="function")return(await all.call(baseModel)||[]).length;if(typeof get==="function")return(await get.call(baseModel)||[]).length;return 0};if(typeof baseModel.pluck!=="function")baseModel.pluck=async function(column){if(!column||typeof column!=="string")throw Error(`[ORM] ${definition.name}.pluck requires a column name`);const all=baseModel.all;return((typeof all==="function"?await all.call(baseModel):[])||[]).map((r)=>r?.[column])};if(typeof baseModel.whereIn!=="function")baseModel.whereIn=async function(column,values){if(!column||typeof column!=="string")throw Error(`[ORM] ${definition.name}.whereIn requires a column name`);if(!Array.isArray(values))throw Error(`[ORM] ${definition.name}.whereIn requires an array of values`);if(values.length===0)return[];const w=baseModel.where;if(typeof w!=="function")return[];const q=w.call(baseModel,column,"in",values);if(q&&typeof q.get==="function")return await q.get();return await q};const orderHelpers=[["latest","desc"],["oldest","asc"]];for(const[name,dir]of orderHelpers)if(typeof baseModel[name]!=="function")baseModel[name]=async function(column="created_at"){const q=baseModel,builder=typeof q.query==="function"?q.query():q;if(typeof builder?.orderBy==="function"){const ordered=builder.orderBy(column,dir);if(typeof ordered.first==="function")return await ordered.first();if(typeof ordered.get==="function")return(await ordered.get())?.[0]??null}const all=baseModel.all;if(typeof all!=="function")return null;return[...await all.call(baseModel)||[]].sort((a,b)=>{const av=a?.[column],bv=b?.[column];if(av===bv)return 0;return(av>bv?1:-1)*(dir==="desc"?-1:1)})[0]??null};const searchConfig=resolveSearchConfig(definition.traits?.useSearch,definition);if(searchConfig){const indexName=searchConfig.index??definition.table??snakeCase(`${definition.name}s`);if(typeof baseModel.search!=="function")baseModel.search=function(query,params){return createSearchQueryBuilder(baseModel,indexName,query,params,searchConfig.searchable)};if(typeof baseModel.makeAllSearchable!=="function")baseModel.makeAllSearchable=async function(chunkSize=500){const all=baseModel.all;if(typeof all!=="function")throw Error(`[ORM] ${definition.name}.makeAllSearchable cannot run: the underlying query builder did not expose all()`);const{useSearchEngine}=await import("@stacksjs/search-engine"),engine=useSearchEngine();let total=0;const query=baseModel.query;if(typeof query==="function")try{const q=query.call(baseModel);if(q&&typeof q.chunk==="function"){await q.chunk(chunkSize,async(rows)=>{const docs=await projectDocumentsFromTrait(rows,searchConfig);if(docs.length>0)await engine.addDocuments(indexName,docs);total+=docs.length});return total}}catch{}const rows=await all.call(baseModel)||[],docs=await projectDocumentsFromTrait(rows,searchConfig);if(docs.length>0)await engine.addDocuments(indexName,docs);return docs.length};if(typeof baseModel.removeAllFromSearch!=="function")baseModel.removeAllFromSearch=async function(){const{searchEngineReady}=await import("@stacksjs/search-engine");await(await searchEngineReady()).deleteAllDocuments(indexName)}}}export async function projectDocumentsFromTrait(models,config){if(models.length===0)return[];if(typeof config.shapeMany==="function"){const docs=await config.shapeMany(models);if(!Array.isArray(docs)||docs.length!==models.length)throw TypeError(`[orm/search] shapeMany returned ${Array.isArray(docs)?docs.length:typeof docs} documents for ${models.length} rows. It must return one document per row, in order, or documents are indexed under the wrong ids.`);return docs.filter(Boolean)}return(await Promise.all(models.map((model)=>projectDocumentFromTrait(model,config)))).filter(Boolean)}function hiddenAttributeNames(definition){const hidden=new Set,attributes=definition.attributes??{};for(const[name,attribute]of Object.entries(attributes))if(attribute?.hidden)hidden.add(name);return hidden}function withoutHidden(document,hidden){if(!document||hidden.size===0)return document;const safe={};for(const[key,value]of Object.entries(document))if(!hidden.has(key))safe[key]=value;return safe}async function projectDocumentFromTrait(model,config){if(typeof config.shape==="function")try{return await config.shape(model)}catch{return}const fromHook=model?.toSearchableObject?.();if(fromHook!==void 0)return fromHook;return withoutHidden(model?._attributes??(typeof model?.toJSON==="function"?model.toJSON():null),config.hidden??new Set)}function createSearchQueryBuilder(_baseModel,indexName,query,initialParams,searchableFields){const defaultQueryBy=searchableFields&&searchableFields.length>0?{query_by:[...searchableFields].join(",")}:{};let params={q:query,...defaultQueryBy,...initialParams??{}};const builder={with(extra){params={...params,...extra};return builder},where(filter){params={...params,filter};return builder},async get(){const{useSearchEngine}=await import("@stacksjs/search-engine");return(await useSearchEngine().search(indexName,params))?.hits??[]},async paginate(perPage,page=1){if(!Number.isInteger(perPage)||perPage<1)throw TypeError(`[orm/search] paginate() needs a positive integer page size, got ${perPage}`);if(!Number.isInteger(page)||page<1)throw TypeError(`[orm/search] paginate() pages are 1-based, got ${page}`);const{useSearchEngine}=await import("@stacksjs/search-engine"),result=await useSearchEngine().search(indexName,{...params,limit:perPage,offset:(page-1)*perPage});return{hits:result.hits??[],total:Number(result.estimatedTotalHits??result.nbHits??result.total??0),page,perPage}},async raw(){const{useSearchEngine}=await import("@stacksjs/search-engine");return await useSearchEngine().search(indexName,params)}};return builder}function encryptedAliases(key){const snake=snakeCase(key);return snake===key?[key]:[key,snake]}async function decryptAttrsInPlace(row,encryptedKeys){if(!row||typeof row!=="object")return;const bag=row._attributes??row;for(const key of encryptedKeys)for(const alias of encryptedAliases(key)){if(!(alias in bag))continue;const value=bag[alias];if(!isEncrypted(value))continue;bag[alias]=await decryptValue(value)}}function wrapReadsWithEncryption(baseModel,encryptedKeys){if(encryptedKeys.length===0)return;const decryptResult=async(r)=>{if(Array.isArray(r)){for(const item of r)await decryptAttrsInPlace(item,encryptedKeys);return r}if(r&&typeof r==="object"&&Array.isArray(r.data)){for(const item of r.data)await decryptAttrsInPlace(item,encryptedKeys);return r}if(r)await decryptAttrsInPlace(r,encryptedKeys);return r},directReads=["find","first","last","all","firstOrFail","findOrFail","findMany"];for(const method of directReads){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(...args){const result=await original.apply(this,args);return await decryptResult(result)}}const writeReturningInstance=["create","createMany","firstOrCreate","updateOrCreate","make"];for(const method of writeReturningInstance){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(...args){const result=await original.apply(this,args);return await decryptResult(result)}}for(const method of["update","forceUpdate"]){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(id,data){const result=await original.call(this,id,data);return await decryptResult(result)}}const terminals=["first","firstOrFail","get","all","find","findOrFail","last","paginate","simplePaginate"],decorateBuilder=(builder)=>{if(!builder||typeof builder!=="object")return builder;const target=builder;if(target.__stacksEncryptedReads)return builder;for(const method of terminals){const original=target[method];if(typeof original!=="function")continue;target[method]=async function(...args){return await decryptResult(await original.apply(this,args))}}for(const method of["where","whereIn","whereNull","whereNotNull","orWhere","orderBy","orderByDesc","limit","offset","with"]){const original=target[method];if(typeof original!=="function")continue;target[method]=function(...args){return decorateBuilder(original.apply(this,args))}}Object.defineProperty(target,"__stacksEncryptedReads",{value:!0,enumerable:!1});return builder};for(const entry of["where","whereIn","whereNull","whereNotNull","orderBy","orderByDesc","limit","query"]){const original=baseModel[entry];if(typeof original!=="function")continue;baseModel[entry]=function(...args){return decorateBuilder(original.apply(this,args))}}}function wrapWritesWithEncryption(baseModel,encryptedKeys){if(encryptedKeys.length===0)return;const encryptArg=async(data)=>{if(!data||typeof data!=="object"||Array.isArray(data))return data;const out={...data};for(const key of encryptedKeys)for(const alias of encryptedAliases(key))if(alias in out)out[alias]=await encryptValue(out[alias]);return out},writeMethods=["create","firstOrCreate","updateOrCreate","forceCreate"],originalCreateMany=baseModel.createMany;if(typeof originalCreateMany==="function")baseModel.createMany=async function(items,...rest){const encrypted=Array.isArray(items)?await Promise.all(items.map(encryptArg)):items;return await originalCreateMany.call(this,encrypted,...rest)};for(const method of writeMethods){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(...args){args[0]=await encryptArg(args[0]);if(args[1])args[1]=await encryptArg(args[1]);return await original.apply(this,args)}}for(const method of["update","forceUpdate"]){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(id,data){const enc=await encryptArg(data);return await original.call(this,id,enc)}}}function wrapWritesWithMassAssignment(baseModel,definition){const origCreate=baseModel.create;if(typeof origCreate==="function")baseModel.create=async function(data,...rest){applyMassAssignmentRules(definition,data);const finalData=await applyDefinedSetters(definition,data);return await origCreate.call(this,finalData,...rest)};const origCreateMany=baseModel.createMany;if(typeof origCreateMany==="function")baseModel.createMany=async function(items,...rest){const finalItems=[];for(const data of items){applyMassAssignmentRules(definition,data);finalItems.push(await applyDefinedSetters(definition,data))}return await origCreateMany.call(this,finalItems,...rest)};for(const method of["firstOrCreate","updateOrCreate"]){const orig=baseModel[method];if(typeof orig!=="function")continue}}function wrapWritesWithValidation(baseModel,definition){if(!hasWriteValidators(definition))return;const modelName=String(definition?.name??baseModel.name??"Model"),check=(data,hook)=>{if(validationIsSuppressed())return;if(!data||typeof data!=="object"||Array.isArray(data))return;const result=validateWriteBody(data,definition,hook);if(!result.valid)throw new ModelValidationError(modelName,result.errors)},origCreate=baseModel.create;if(typeof origCreate==="function")baseModel.create=async function(data,...rest){check(data,"creating");return await origCreate.call(this,data,...rest)};const origCreateMany=baseModel.createMany;if(typeof origCreateMany==="function")baseModel.createMany=async function(items,...rest){if(Array.isArray(items))for(const data of items)check(data,"creating");return await origCreateMany.call(this,items,...rest)};const origUpdate=baseModel.update;if(typeof origUpdate==="function")baseModel.update=async function(id,data,...rest){check(data,"updating");return await origUpdate.call(this,id,data,...rest)}}function wrapQueryMethodsWithCasts(baseModel,casts){const writeMethods=["create","firstOrCreate","updateOrCreate"],originalCreateMany=baseModel.createMany;if(typeof originalCreateMany==="function")baseModel.createMany=async function(items,...rest){const cast=Array.isArray(items)?items.map((item)=>item&&typeof item==="object"&&!Array.isArray(item)?castAttributes(item,casts,"set"):item):items;return await originalCreateMany.call(this,cast,...rest)};for(const method of writeMethods){const original=baseModel[method];if(typeof original==="function")baseModel[method]=async function(...args){log.debug(`[orm] ${method.charAt(0).toUpperCase()+method.slice(1)} ${String(baseModel.name||"unknown")}`,args[0]);if(args[0]&&typeof args[0]==="object"&&!Array.isArray(args[0]))args[0]=castAttributes(args[0],casts,"set");return await original.apply(this,args)}}const origUpdate=baseModel.update;if(typeof origUpdate==="function")baseModel.update=async function(id,data){const cast=data&&typeof data==="object"&&!Array.isArray(data)?castAttributes(data,casts,"set"):data;return await origUpdate.call(this,id,cast)}}import{createMessagingMethods}from"./messaging";import{createTaggableMethods}from"./traits/taggable";import{createCategorizableMethods}from"./traits/categorizable";import{createCommentableMethods}from"./traits/commentable";import{BILLABLE_INSTANCE_METHODS,createBillableMethods}from"./traits/billable";import{createLikeableMethods}from"./traits/likeable";import{createTwoFactorMethods}from"./traits/two-factor";import{createSoftDeleteMethods,resolveSoftDeleteOptions,cascadeSoftDelete}from"./traits/soft-deletes";import{applyAudit,resolveAuditOptions}from"./traits/audit";import{applyActivityLog,resolveActivityLogOptions}from"./traits/activity-log";import{collectEncryptedAttributes,decryptValue,encryptValue,isEncrypted}from"./utils/encrypted";const KNOWN_TRAITS=new Set(["useUuid","useTimestamps","timestampable","useSoftDeletes","softDeletable","useApi","useAuth","authenticatable","useSearch","searchable","useSeeder","seedable","useSocials","billable","observe","useAudit","useActivityLog","prunable","sharding","likeable","taggable","categorizable","useMessaging","commentable","commentables","broadcastOn","broadcastWith","gdpr"]);export function defineModel(definition){log.debug(`[orm] Defining model: ${definition.name} (table: ${definition.table})`);for(const trait of Object.keys(definition.traits??{}))if(!KNOWN_TRAITS.has(trait))log.warn(`[orm] Model '${definition.name}' declares an unknown trait '${trait}'. It does nothing. Known traits: ${[...KNOWN_TRAITS].sort().join(", ")}.`);const observeHooks=buildEventHooks(definition),searchHooks=buildSearchHooks(definition),hooks=mergeModelHooks(observeHooks,searchHooks),traitMethods=buildTraitMethods(definition);definition.__traitMethods=traitMethods;const authenticatable=definition.traits;if((authenticatable?.useAuth||authenticatable?.authenticatable)&&definition.name!=="PersonalAccessToken"){const declared=definition.morphMany;if(!declared||!("tokenable"in declared))definition.morphMany={...declared??{},tokenable:"PersonalAccessToken"}}const defWithHooks=hooks?{...definition,hooks:{...definition.hooks,...hooks}}:definition,baseModel=createModel(defWithHooks);wrapReadsWithProxy(baseModel,definition.casts);addStaticHelpers(baseModel,defWithHooks);wrapWritesWithMassAssignment(baseModel,defWithHooks);if(definition.casts&&Object.keys(definition.casts).length>0)wrapQueryMethodsWithCasts(baseModel,definition.casts);const encryptedKeys=collectEncryptedAttributes(definition);if(encryptedKeys.length>0){wrapWritesWithEncryption(baseModel,encryptedKeys);wrapReadsWithEncryption(baseModel,encryptedKeys)}const softDeleteFlag=definition.traits?.useSoftDeletes;if(softDeleteFlag)applySoftDeletes(baseModel,defWithHooks,softDeleteFlag);const useAuditDecl=definition.traits?.useAudit;if(useAuditDecl){const auditOpts=resolveAuditOptions(useAuditDecl);applyAudit(baseModel,definition.name,definition.primaryKey||"id",auditOpts)}const activityOptions=resolveActivityLogOptions(definition.traits?.useActivityLog);if(activityOptions)applyActivityLog(baseModel,definition.name,definition.primaryKey||"id",activityOptions,[...hiddenAttributeNames(definition)]);wrapWritesWithValidation(baseModel,defWithHooks);const withHelpers=baseModel;withHelpers.withoutValidation=function(fn){return withoutValidation(fn)};withHelpers.withoutEvents=function(fn){return withoutEvents(fn)};for(const method of["create","createMany","update","firstOrCreate","updateOrCreate","forceCreate","forceUpdate","delete","forceDelete","softDelete","restore"]){const orig=baseModel[method];if(typeof orig!=="function")continue;const quietName=`${method}Quietly`;if(typeof baseModel[quietName]==="function")continue;baseModel[quietName]=function(...args){return withoutEvents(()=>orig.apply(baseModel,args))}}const finalModel=Object.assign(baseModel,traitMethods,{...definition,getDefinition:()=>definition,_isStacksModel:!0});registerModel(definition.name,finalModel);Object.defineProperty(finalModel,MODEL_DEFINITION,{value:definition,enumerable:!1,configurable:!0});return finalModel}function buildEventHooks(definition){const observe=definition.traits?.observe;if(!observe)return;const modelName=definition.name.toLowerCase(),toEventPayload=(model)=>{const attributes=model?.attributes;if(!attributes||typeof attributes!=="object")return model;const pk=definition.primaryKey||"id",payload={...attributes};if(payload[pk]===void 0&&model[pk]!==void 0)payload[pk]=model[pk];return payload},dispatchEvent=async(event,data)=>{if(eventsAreSuppressed())return;try{const{dispatch}=modelEventsModule??=await import("@stacksjs/events");await dispatch(event,data)}catch(err){if(err&&typeof err==="object"&&"code"in err&&err.code==="MODULE_NOT_FOUND")return;console.error(`[ORM] Event '${event}' handler error:`,err);if(process.env.STACKS_ORM_EVENT_ERRORS!=="swallow")throw err}},broadcastOnFn=definition.traits?.broadcastOn,broadcastWithFn=definition.traits?.broadcastWith,broadcastingEnabled=typeof broadcastOnFn==="function"&&typeof broadcastWithFn==="function",dispatchBroadcast=async(event,model)=>{if(!broadcastingEnabled)return;if(eventsAreSuppressed())return;try{const channelsRaw=broadcastOnFn(model),channels=Array.isArray(channelsRaw)?channelsRaw:[channelsRaw],payload=broadcastWithFn(model),broadcast=(await import("@stacksjs/realtime").catch(()=>null))?.broadcast;if(typeof broadcast!=="function")return;for(const channel of channels){if(typeof channel!=="string"||channel.length===0)continue;await broadcast(channel,event,payload)}}catch(err){if(err&&typeof err==="object"&&"code"in err&&err.code==="MODULE_NOT_FOUND")return;console.error(`[ORM] Broadcast '${event}' handler error:`,err);if(process.env.STACKS_ORM_BROADCAST_ERRORS==="throw")throw err}},dispatchBeforeEvent=async(event,data)=>{if(eventsAreSuppressed())return!0;let eventsModule;try{eventsModule=modelEventsModule??=await import("@stacksjs/events");const{dispatchAndCollect}=eventsModule,results=await dispatchAndCollect(event,data);if(results.some((result)=>result.ok&&result.value===!1))return!1;const failure=results.find((result)=>!result.ok);if(failure&&!failure.ok)throw failure.error}catch(err){if(!eventsModule&&err&&typeof err==="object"&&"code"in err&&err.code==="MODULE_NOT_FOUND")return!0;console.error(`[ORM] Before-event '${event}' handler error:`,err);if(process.env.STACKS_ORM_EVENT_ERRORS!=="swallow")throw err}return!0},events=observe===!0?["create","update","delete"]:Array.isArray(observe)?observe:[],hooks={};if(events.includes("create")){hooks.beforeCreate=async(model)=>{log.debug(`[orm] Create ${modelName}`,model);if(!await dispatchBeforeEvent(`${modelName}:saving`,model))throw Error(`[ORM] ${modelName}:saving event cancelled the operation`);if(!await dispatchBeforeEvent(`${modelName}:creating`,model))throw Error(`[ORM] ${modelName}:creating event cancelled the operation`)};hooks.afterCreate=async(model)=>{const payload=toEventPayload(model);await dispatchEvent(`${modelName}:created`,payload);await dispatchEvent(`${modelName}:saved`,payload);await dispatchBroadcast(`${modelName}:created`,model)}}if(events.includes("update")){hooks.beforeUpdate=async(model)=>{log.debug(`[orm] Update ${modelName}#${model?.id??"unknown"}`,model);if(!await dispatchBeforeEvent(`${modelName}:saving`,model))throw Error(`[ORM] ${modelName}:saving event cancelled the operation`);if(!await dispatchBeforeEvent(`${modelName}:updating`,model))throw Error(`[ORM] ${modelName}:updating event cancelled the operation`)};hooks.afterUpdate=async(model)=>{const payload=toEventPayload(model);await dispatchEvent(`${modelName}:updated`,payload);await dispatchEvent(`${modelName}:saved`,payload);await dispatchBroadcast(`${modelName}:updated`,model)}}if(events.includes("delete")){hooks.beforeDelete=async(model)=>{log.debug(`[orm] Delete ${modelName}#${model?.id??"unknown"}`);if(!await dispatchBeforeEvent(`${modelName}:deleting`,model))throw Error(`[ORM] ${modelName}:deleting event cancelled the operation`)};hooks.afterDelete=async(model)=>{await dispatchEvent(`${modelName}:deleted`,toEventPayload(model));await dispatchBroadcast(`${modelName}:deleted`,model)}}return hooks}function mergeModelHooks(...sets){const merged={},names=new Set;for(const set of sets){if(!set)continue;for(const name of Object.keys(set))names.add(name)}for(const name of names){const fns=sets.map((s)=>s?.[name]).filter((fn)=>typeof fn==="function");if(!fns.length)continue;merged[name]=async(...args)=>{for(const fn of fns)await fn(...args)}}return Object.keys(merged).length?merged:void 0}function resolveSearchConfig(useSearch,definition){if(!useSearch)return null;const base=useSearch===!0?{}:typeof useSearch==="object"?{...useSearch}:null;if(!base)return null;if(definition)base.hidden=hiddenAttributeNames(definition);return base}function buildSearchHooks(definition){const config=resolveSearchConfig(definition.traits?.useSearch,definition);if(!config)return;const searchConfig=config,indexName=searchConfig.index??definition.table??snakeCase(`${definition.name}s`);async function projectDocument(model){if(typeof searchConfig.shapeMany==="function")try{const[doc]=await projectDocumentsFromTrait([model],searchConfig);return doc}catch(err){log.warn(`[orm/search] shapeMany() threw for ${definition.name}: ${err.message}`);return}if(typeof searchConfig.shape==="function")try{return await searchConfig.shape(model)}catch(err){log.warn(`[orm/search] shape() threw for ${definition.name}: ${err.message}`);return}const fromHook=wrapModelInstance(model).toSearchableObject?.();if(fromHook!==void 0)return fromHook;return model?._attributes??(typeof model?.toJSON==="function"?model.toJSON():null)}const syncDocument=async(model)=>{if(eventsAreSuppressed())return;const doc=await projectDocument(model);if(!doc)return;if(config.queueable){try{const{Jobs}=await import("@stacksjs/queue");await Jobs.dispatch("SyncSearchIndexJob",{index:indexName,op:"upsert",doc})}catch(err){log.warn(`[orm/search] queue dispatch failed for ${definition.name}; falling back to inline: ${err.message}`);await indexInline(indexName,doc,definition.name)}return}await indexInline(indexName,doc,definition.name)};return{afterCreate:syncDocument,afterUpdate:syncDocument,afterDelete:async(model)=>{if(eventsAreSuppressed())return;const id=model?.id??model?._attributes?.id;if(id==null)return;if(config.queueable){try{const{Jobs}=await import("@stacksjs/queue");await Jobs.dispatch("SyncSearchIndexJob",{index:indexName,op:"delete",id:Number(id)})}catch(err){log.warn(`[orm/search] queue dispatch failed for ${definition.name}#${id}; falling back to inline: ${err.message}`);await removeInline(indexName,Number(id),definition.name)}return}await removeInline(indexName,Number(id),definition.name)}}}const searchFailures=new Map;function warnSearchFailure(key,message){const seen=searchFailures.get(key)??0;searchFailures.set(key,seen+1);if(seen===0)log.warn(`[orm/search] ${message}`);else if(seen===9)log.warn(`[orm/search] ${key} is still failing; further identical warnings suppressed for this process.`)}async function indexInline(indexName,doc,modelName){try{const{useSearchEngine}=await import("@stacksjs/search-engine");await useSearchEngine().addDocument(indexName,doc)}catch(err){warnSearchFailure(`index:${modelName}`,`Failed to index ${modelName}: ${err.message}`)}}async function removeInline(indexName,id,modelName){try{const{useSearchEngine}=await import("@stacksjs/search-engine");await useSearchEngine().deleteDocument(indexName,id)}catch(err){warnSearchFailure(`remove:${modelName}`,`Failed to remove ${modelName}#${id}: ${err.message}`)}}function buildTraitMethods(definition){const methods={},{table:tableName,traits}=definition;if(!traits)return methods;if(traits?.useMessaging)methods._messaging=createMessagingMethods(tableName);if(traits.taggable)methods._taggable=createTaggableMethods(tableName);if(traits.categorizable)methods._categorizable=createCategorizableMethods(tableName);if(traits.commentable)methods._commentable=createCommentableMethods(tableName);if(traits.billable)methods._billable=createBillableMethods(tableName);if(traits.likeable){const likeableOpts=typeof traits.likeable==="object"?traits.likeable:void 0;methods._likeable=createLikeableMethods(tableName,likeableOpts)}const useAuth=traits.useAuth||traits.authenticatable;if(typeof useAuth==="object"&&useAuth&&"useTwoFactor"in useAuth&&useAuth.useTwoFactor)methods._twoFactor=createTwoFactorMethods();return methods}function applySoftDeletes(baseModel,definition,traitFlag){const helpers=createSoftDeleteMethods(baseModel,definition.primaryKey||"id"),options=resolveSoftDeleteOptions(traitFlag),parentDef=definition,modelName=definition.name.toLowerCase(),observeOn=definition.traits?.observe!=null&&definition.traits?.observe!==!1,fireRestoring=async(id)=>{if(!observeOn||eventsAreSuppressed())return!0;try{const{dispatchAsync}=modelEventsModule??=await import("@stacksjs/events"),results=await dispatchAsync(`${modelName}:restoring`,{id});if(Array.isArray(results)&&results.some((r)=>r===!1))return!1}catch(err){if(err?.code!=="MODULE_NOT_FOUND")console.error(`[ORM] Before-event '${modelName}:restoring' handler error:`,err)}return!0},fireRestored=async(id)=>{if(!observeOn||eventsAreSuppressed())return;try{const{dispatch}=modelEventsModule??=await import("@stacksjs/events");await dispatch(`${modelName}:restored`,{id})}catch(err){if(err?.code!=="MODULE_NOT_FOUND")console.error(`[ORM] Event '${modelName}:restored' handler error:`,err)}},transactional=process.env.STACKS_ORM_CASCADE_SWALLOW!=="true",softDeleteFn=async(id)=>{if(!options.cascade?.length||!transactional){const ok=await helpers.softDelete(id);if(ok&&options.cascade?.length)await cascadeSoftDelete(parentDef,options,id,"softDelete");return ok}const{db}=await import("@stacksjs/database/runtime");return await db.transaction(async()=>{const ok=await helpers.softDelete(id);if(ok)await cascadeSoftDelete(parentDef,options,id,"softDelete");return ok})},restoreFn=async(id)=>{if(!await fireRestoring(id))return!1;if(!options.cascade?.length||!transactional){const ok=await helpers.restore(id);if(ok){if(options.cascade?.length)await cascadeSoftDelete(parentDef,options,id,"restore");await fireRestored(id)}return ok}const{db}=await import("@stacksjs/database/runtime"),ok=await db.transaction(async()=>{const inner=await helpers.restore(id);if(inner)await cascadeSoftDelete(parentDef,options,id,"restore");return inner});if(ok)await fireRestored(id);return ok};baseModel.softDelete=softDeleteFn;baseModel.restore=restoreFn;baseModel.forceDelete=helpers.forceDelete;baseModel.withTrashed=helpers.withTrashed;baseModel.onlyTrashed=helpers.onlyTrashed;baseModel.delete=softDeleteFn}export function toAttrs(value){if(value==null)return value;if(Array.isArray(value))return value.map((v)=>toAttrs(v));if(typeof value!=="object")return value;const candidate=value;if(typeof candidate.toJSON==="function")return candidate.toJSON();if(candidate._attributes&&typeof candidate._attributes==="object")return candidate._attributes;return value}
+import{createModel,registerModel}from"@stacksjs/query-builder";import{log}from"@stacksjs/logging/runtime";import{parseSqlDateTime,sqlDateTime}from"@stacksjs/database/runtime";import{snakeCase}from"@stacksjs/strings";import{AsyncLocalStorage}from"node:async_hooks";import{toCursorPaginator,toPaginator,toSimplePaginator}from"@stacksjs/pagination";import{enrichPaginatorUrls,resolveCursorArgs,resolvePageArgs}from"./paginator-request";import{hasWriteValidators,validateWriteBody}from"./auto-crud";let modelEventsModule;const eventSuppression=new AsyncLocalStorage;function eventsAreSuppressed(){return eventSuppression.getStore()?.suppressed===!0}export function withoutEvents(fn){return Promise.resolve(eventSuppression.run({suppressed:!0},fn))}const validationSuppression=new AsyncLocalStorage;function validationIsSuppressed(){return validationSuppression.getStore()?.suppressed===!0}export function withoutValidation(fn){return Promise.resolve(validationSuppression.run({suppressed:!0},fn))}export const MODEL_DEFINITION=Symbol.for("stacks.orm.modelDefinition");export class ModelValidationError extends Error{status=422;errors;constructor(modelName,errors){const fields=Object.keys(errors).join(", ");super(`${modelName} validation failed: ${fields}`);this.name="ModelValidationError";this.errors=errors}}const jsonParseFailureSeen=new Set,COLUMN_NAME_CACHE_LIMIT=4096,columnNameCache=Object.create(null);let columnNameCacheSize=0;function toColumnName(attribute){const cached=columnNameCache[attribute];if(cached!==void 0)return cached;const column=snakeCase(attribute);if(columnNameCacheSize<COLUMN_NAME_CACHE_LIMIT){columnNameCache[attribute]=column;columnNameCacheSize++}return column}function logJsonParseFailure(raw,err){const preview=typeof raw==="string"?raw.slice(0,80):String(raw),key=`${typeof raw}:${preview}`;if(jsonParseFailureSeen.has(key))return;jsonParseFailureSeen.add(key);const message=err instanceof Error?err.message:String(err);console.error(`[orm] JSON cast failed to parse value (returning null): ${message} - value preview: ${JSON.stringify(preview)}`)}export const builtInCasters={string:{get:(v)=>v!=null?String(v):null,set:(v)=>v!=null?String(v):null},number:{get:(v)=>v!=null?Number(v):null,set:(v)=>v!=null?Number(v):null},integer:{get:(v)=>v!=null?Math.trunc(Number(v)):null,set:(v)=>v!=null?Math.trunc(Number(v)):null},float:{get:(v)=>v!=null?Number.parseFloat(String(v)):null,set:(v)=>v!=null?Number.parseFloat(String(v)):null},boolean:{get:(v)=>v===1||v==="1"||v===!0||v==="true",set:(v)=>v===!0||v===1||v==="1"||v==="true"?1:0},json:{get:(v)=>{if(v==null)return null;if(typeof v==="string")try{return JSON.parse(v)}catch(err){logJsonParseFailure(v,err);return null}return v},set:(v)=>{if(v==null)return null;return typeof v==="string"?v:JSON.stringify(v)}},datetime:{get:(v)=>v==null||v===""?null:v instanceof Date?v:parseSqlDateTime(v),set:(v)=>v instanceof Date?sqlDateTime(v):v},date:{get:(v)=>v==null||v===""?null:v instanceof Date?v:parseSqlDateTime(v),set:(v)=>v instanceof Date?v.toISOString().split("T")[0]:v},array:{get:(v)=>{if(v==null)return[];if(Array.isArray(v))return v;if(typeof v==="string")try{return JSON.parse(v)}catch{return[]}return[]},set:(v)=>{if(v==null)return null;return Array.isArray(v)?JSON.stringify(v):v}}};function resolveCaster(cast){return typeof cast==="string"?builtInCasters[cast]:cast}const resolvedModelCastsByDefinition=new WeakMap;function resolveModelCasts(casts){const attrs=Object.keys(casts),cached=resolvedModelCastsByDefinition.get(casts);if(cached&&cached.length===attrs.length){let unchanged=!0;for(let index=0;index<attrs.length;index++){const attr=attrs[index];if(cached[index]?.attr!==attr||cached[index]?.definition!==casts[attr]){unchanged=!1;break}}if(unchanged)return cached}const resolved=attrs.map((attr)=>{const definition=casts[attr];return{attr,definition,caster:resolveCaster(definition)}});resolvedModelCastsByDefinition.set(casts,resolved);return resolved}function castAttributes(row,casts,direction){if(!row||typeof row!=="object")return row;const result={...row};for(const{attr,caster}of resolveModelCasts(casts))if(attr in result)result[attr]=caster[direction].call(caster,result[attr]);return result}function isModelInstanceInternalKey(key){return key==="_attributes"||key==="_original"||key==="_definition"||key==="_hasSaved"||key==="_relations"}const STACKS_PROXY_TAG=Symbol.for("stacks.modelInstanceProxy");let defaultModelInstanceProxyHandler;const castModelInstanceProxyHandlers=new WeakMap,TRAIT_INSTANCE_METHOD_BINDINGS={messenger:{bag:"_messaging",mode:"id"},tags:{bag:"_taggable",mode:"id"},tagCount:{bag:"_taggable",mode:"id"},addTag:{bag:"_taggable",mode:"id"},activeTags:{bag:"_taggable",mode:"id"},inactiveTags:{bag:"_taggable",mode:"id"},removeTag:{bag:"_taggable",mode:"id"},categories:{bag:"_categorizable",mode:"id"},categoryCount:{bag:"_categorizable",mode:"id"},addCategory:{bag:"_categorizable",mode:"id"},activeCategories:{bag:"_categorizable",mode:"id"},inactiveCategories:{bag:"_categorizable",mode:"id"},removeCategory:{bag:"_categorizable",mode:"id"},comments:{bag:"_commentable",mode:"id"},commentCount:{bag:"_commentable",mode:"id"},addComment:{bag:"_commentable",mode:"id"},approvedComments:{bag:"_commentable",mode:"id"},pendingComments:{bag:"_commentable",mode:"id"},rejectedComments:{bag:"_commentable",mode:"id"},likes:{bag:"_likeable",mode:"id"},likeCount:{bag:"_likeable",mode:"id"},like:{bag:"_likeable",mode:"id"},unlike:{bag:"_likeable",mode:"id"},isLiked:{bag:"_likeable",mode:"id"},...Object.fromEntries(BILLABLE_INSTANCE_METHODS.map((name)=>[name,{bag:"_billable",mode:"model"}])),generateTwoFactorForModel:{bag:"_twoFactor",mode:"model"},verifyTwoFactorCode:{bag:"_twoFactor",mode:"model"}};function resolveRelationPath(relations,path){if(!relations||!path)return null;const segments=path.split(".");let current=relations;for(const segment of segments){if(current==null||typeof current!=="object")return null;const obj=current;if("_attributes"in obj&&obj._attributes&&typeof obj._attributes==="object"){const attrs=obj._attributes;if(segment in attrs){current=attrs[segment];continue}}if(segment in obj){current=obj[segment];continue}return null}return current??null}function keepWrapped(result,raw,wrapped){if(result&&typeof result.then==="function")return result.then((value)=>value===raw?wrapped:value);return result===raw?wrapped:result}function wrapModelInstance(instance,casts){if(!instance||typeof instance!=="object")return instance;const candidate=instance;if(candidate[STACKS_PROXY_TAG])return instance;const attrs=candidate._attributes;if(!attrs||typeof attrs!=="object")return instance;if(casts){for(const{attr,caster}of resolveModelCasts(casts))if(Object.hasOwn(attrs,attr))attrs[attr]=caster.get.call(caster,attrs[attr])}let handler=casts?castModelInstanceProxyHandlers.get(casts):defaultModelInstanceProxyHandler;if(!handler){handler={get(rawTarget,prop,recv){const target=rawTarget;if(prop===STACKS_PROXY_TAG)return!0;if(prop==="saveAsync")return async function(){const def=target._definition,setters=def?.set;if(setters&&typeof target.isDirty==="function"){for(const[key,fn]of Object.entries(setters)){if(typeof fn!=="function")continue;if(!target.isDirty(key))continue;const result=fn(target._attributes),value=result&&typeof result.then==="function"?await result:result;target._attributes[key]=value}const original=def.set;def.set={};try{return keepWrapped(target.save(),rawTarget,recv)}finally{def.set=original}}return keepWrapped(target.save(),rawTarget,recv)};if(prop==="save")return function(){const def=target._definition,setters=def?.set;if(setters&&Object.keys(setters).length>0&&typeof target.isDirty==="function"){for(const[key,fn]of Object.entries(setters)){if(typeof fn!=="function")continue;if(!target.isDirty(key))continue;const result=fn(target._attributes);if(result&&typeof result.then==="function")throw Error(`Setter for "${key}" returned a Promise - use \`saveAsync()\` instead of \`save()\` when a model has async setters.`);target._attributes[key]=result}const original=def.set;def.set={};try{return keepWrapped(target.save(),rawTarget,recv)}finally{def.set=original}}return keepWrapped(target.save(),rawTarget,recv)};if(prop==="updateAsync")return async function(data){if(data&&typeof data==="object"&&!Array.isArray(data))for(const[k,v]of Object.entries(data))recv[k]=v;return recv.saveAsync()};if(prop==="saveQuietly")return function(){return withoutEvents(()=>target.save())};if(prop==="saveAsyncQuietly")return function(){return withoutEvents(()=>recv.saveAsync())};if(prop==="updateQuietly")return function(data){return withoutEvents(()=>target.update(data))};if(prop==="updateAsyncQuietly")return function(data){return withoutEvents(()=>recv.updateAsync(data))};if(prop==="deleteQuietly")return function(){return withoutEvents(()=>target.delete())};if(prop==="toSearchableObject")return function toSearchableObject(){const search=target._definition?.traits?.useSearch;if(!search)return null;const attrs=target._attributes;if(!attrs)return null;if(search===!0){const doc={...attrs};if(attrs.id!=null)doc.id=String(attrs.id);return doc}const doc={},keys=search.displayable?.length?search.displayable:[...search.searchable??[],...search.filterable??[],...search.sortable??[],"id"],denormalize=search.denormalize??{},relations=target._relations;for(const key of keys){const snake=snakeCase(key),own=attrs[snake]??attrs[key];if(own!==void 0){doc[snake]=own;continue}const path=denormalize[key]??denormalize[snake];if(path){doc[snake]=resolveRelationPath(relations,path);continue}doc[snake]=void 0}if(attrs.id!=null)doc.id=String(attrs.id);return doc};if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const a=target._attributes;if(a&&Object.hasOwn(a,prop))return a[prop];const rels=target._relations;if(rels&&Object.hasOwn(rels,prop)){const related=rels[prop];if(Array.isArray(related))return related.map((x)=>wrapModelInstance(x,casts));return related&&typeof related==="object"?wrapModelInstance(related,casts):related}const binding=TRAIT_INSTANCE_METHOD_BINDINGS[prop];if(binding){const fn=target._definition?.__traitMethods?.[binding.bag]?.[prop];if(typeof fn==="function")return binding.mode==="model"?(...args)=>fn(recv,...args):(...args)=>fn(target.id,...args)}if(a){const column=toColumnName(prop);if(column!==prop&&Object.hasOwn(a,column))return a[column]}}const v=Reflect.get(target,prop,target);return typeof v==="function"?v.bind(target):v},set(rawTarget,prop,value,recv){const target=rawTarget;if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const{_attributes:a,set:setter}=target;if(a&&Object.hasOwn(a,prop)){if(typeof setter==="function")setter.call(target,prop,value);else a[prop]=value;return!0}if(a){const column=toColumnName(prop);if(column!==prop&&Object.hasOwn(a,column)){if(typeof setter==="function")setter.call(target,column,value);else a[column]=value;return!0}}if(a&&!(prop in target)){if(typeof setter==="function")setter.call(target,prop,value);else a[prop]=value;return!0}}return Reflect.set(target,prop,value,recv)},has(rawTarget,prop){const target=rawTarget;if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const a=target._attributes;if(a&&Object.hasOwn(a,prop))return!0;const rels=target._relations;if(rels&&Object.hasOwn(rels,prop))return!0;if(a){const column=toColumnName(prop);if(column!==prop&&Object.hasOwn(a,column))return!0}}return Reflect.has(target,prop)},deleteProperty(rawTarget,prop){const target=rawTarget;if(typeof prop==="string"&&!isModelInstanceInternalKey(prop)){const a=target._attributes;if(a&&Object.hasOwn(a,prop)){delete a[prop];return!0}}return Reflect.deleteProperty(target,prop)},ownKeys(rawTarget){const a=rawTarget._attributes;return a?Object.keys(a):[]},getOwnPropertyDescriptor(rawTarget,prop){const target=rawTarget;if(typeof prop==="string"){const a=target._attributes;if(a&&Object.hasOwn(a,prop))return{configurable:!0,enumerable:!0,value:a[prop],writable:!0}}return Object.getOwnPropertyDescriptor(target,prop)}};if(casts)castModelInstanceProxyHandlers.set(casts,handler);else defaultModelInstanceProxyHandler=handler}return new Proxy(instance,handler)}const QB_TERMINATORS=Object.assign(Object.create(null),{get:!0,first:!0,last:!0,firstOrFail:!0,find:!0,findOrFail:!0,all:!0,paginate:!0,simplePaginate:!0,cursorPaginate:!0}),PAGINATE_ADAPTERS={paginate:toPaginator,simplePaginate:toSimplePaginator,cursorPaginate:toCursorPaginator},STACKS_QB_PROXY_TAG=Symbol.for("stacks.queryBuilderProxy");function finalizeQueryResult(result,propName,casts){if(QB_TERMINATORS[propName]){if(Array.isArray(result))return result.map((item)=>wrapModelInstance(item,casts));const adapter=PAGINATE_ADAPTERS[propName];if(adapter&&result&&Array.isArray(result.data)){const wrappedData=result.data.map((item)=>wrapModelInstance(item,casts)),canonical=adapter({...result,data:wrappedData});return enrichPaginatorUrls(canonical)}if(result&&Array.isArray(result.data))return{...result,data:result.data.map((item)=>wrapModelInstance(item,casts))};return wrapModelInstance(result,casts)}if(result&&typeof result==="object"&&typeof result.get==="function")return wrapQueryBuilder(result,casts);return result}function wrapQueryBuilder(qb,casts){if(!qb||typeof qb!=="object")return qb;if(qb[STACKS_QB_PROXY_TAG])return qb;return new Proxy(qb,{get(target,prop,recv){if(prop===STACKS_QB_PROXY_TAG)return!0;const v=Reflect.get(target,prop,recv);if(typeof v!=="function")return v;const propName=String(prop);return function(...args){let callArgs=args;if(propName==="paginate"||propName==="simplePaginate"){const{perPage,page}=resolvePageArgs(args[0],args[1]);callArgs=[perPage,page]}else if(propName==="cursorPaginate"){const{perPage,cursor}=resolveCursorArgs(args[0],args[1]);callArgs=[perPage,cursor,args[2],args[3]]}const result=v.apply(target,callArgs);if(!QB_TERMINATORS[propName]&&result===target)return recv;if(result&&typeof result.then==="function")return result.then((resolved)=>finalizeQueryResult(resolved,propName,casts));return finalizeQueryResult(result,propName,casts)}}})}function wrapReadsWithProxy(baseModel,casts){const applyReadResult=(result)=>Array.isArray(result)?result.map((item)=>wrapModelInstance(item,casts)):wrapModelInstance(result,casts),directReads=["find","first","last","all","firstOrFail","findOrFail","findMany"];for(const method of directReads){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=function(...args){const result=original.apply(this,args);if(result&&typeof result.then==="function")return result.then(applyReadResult);return applyReadResult(result)}}const writeReturningInstance=["create","createMany","firstOrCreate","updateOrCreate","make"];for(const method of writeReturningInstance){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=function(...args){const result=original.apply(this,args);if(result&&typeof result.then==="function")return result.then(applyReadResult);return applyReadResult(result)}}const queryBuilderEntrypoints=["query","where","orWhere","whereIn","whereNotIn","whereNull","whereNotNull","whereLike","whereBetween","whereNotBetween","orderBy","orderByDesc","select","with","limit","take","skip","latest","oldest"];for(const method of queryBuilderEntrypoints){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=function(...args){const qb=original.apply(this,args);return wrapQueryBuilder(qb,casts)}}}export class ModelNotFoundError extends Error{model;id;constructor(model,id){super(id!=null?`[ORM] ${model} not found for id=${String(id)}`:`[ORM] No matching ${model} row`);this.name="ModelNotFoundError";this.model=model;this.id=id}}export class MassAssignmentException extends Error{model;attribute;reason;constructor(model,attribute,reason){const why=reason==="guarded"?`'${attribute}' is marked guarded`:`'${attribute}' is not in the fillable allowlist`;super(`[ORM] Mass assignment to ${model} forbidden: ${why}. Use ${model}.forceCreate(...) / .forceUpdate(...) to bypass.`);this.name="MassAssignmentException";this.model=model;this.attribute=attribute;this.reason=reason}}const MASS_ASSIGNMENT_SYSTEM_COLUMNS=new Set(["id","created_at","updated_at","deleted_at","uuid"]),massAssignmentRuleSets=new WeakMap;function resolveMassAssignmentRuleSet(attrs){const cached=massAssignmentRuleSets.get(attrs);if(cached)return cached;const declared=new Set,fillable=new Set,guarded=new Set;for(const[key,attribute]of Object.entries(attrs)){const column=toColumnName(key);declared.add(column);if(attribute?.fillable===!0)fillable.add(column);if(attribute?.guarded===!0)guarded.add(column)}const rules={allowed:fillable.size>0?fillable:declared,guarded};massAssignmentRuleSets.set(attrs,rules);return rules}function applyMassAssignmentRules(definition,data,options={}){if(options.force)return data;if(!data||typeof data!=="object"||Array.isArray(data))return data;const attrs=definition.attributes;if(!attrs)return data;const{allowed,guarded}=resolveMassAssignmentRuleSet(attrs);for(const key in data){if(!Object.hasOwn(data,key))continue;const col=toColumnName(key);if(MASS_ASSIGNMENT_SYSTEM_COLUMNS.has(col))continue;if(guarded.has(col))throw new MassAssignmentException(definition.name,key,"guarded");if(col.endsWith("_id"))continue;if(!allowed.has(col))throw new MassAssignmentException(definition.name,key,"not-fillable")}return data}async function applyDefinedSetters(definition,data){const setters=definition.set;if(!setters||typeof setters!=="object")return data;const out={...data};for(const[key,fn]of Object.entries(setters)){if(typeof fn!=="function"||!(key in out))continue;try{out[key]=await fn(out)}catch(err){log.error(`[orm] ${definition.name}.set.${key} threw - skipping setter`,err)}}return out}function addStaticHelpers(baseModel,definition){const pk=definition.primaryKey||"id",unwrappedCreate=baseModel.create;function getWhere(method){const w=baseModel.where;if(typeof w!=="function")throw Error(`[ORM] ${definition.name}.${method} needs a working where(): the underlying query builder did not expose one`);return w}function getFind(method){const f=baseModel.find;if(typeof f!=="function")throw Error(`[ORM] ${definition.name}.${method} needs a working find(): the underlying query builder did not expose one`);return f}function getCreate(method){const c=baseModel.create;if(typeof c!=="function")throw Error(`[ORM] ${definition.name}.${method} cannot create: the underlying query builder did not expose create()`);return c}baseModel.update=async function(id,data){if(id==null)throw Error(`[ORM] ${definition.name}.update requires an id as the first argument`);if(!data||typeof data!=="object"||Array.isArray(data))throw Error(`[ORM] ${definition.name}.update requires a data object as the second argument`);if(Object.keys(data).length===0){log.debug(`[orm] ${definition.name}.update called with empty data - short-circuiting and returning current row`);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):null}applyMassAssignmentRules(definition,data);const finalData=await applyDefinedSetters(definition,data);await getWhere("update").call(baseModel,pk,id).update(finalData);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):null};if(typeof baseModel.forceUpdate!=="function")baseModel.forceUpdate=async function(id,data){if(id==null)throw Error(`[ORM] ${definition.name}.forceUpdate requires an id as the first argument`);if(!data||typeof data!=="object"||Array.isArray(data))throw Error(`[ORM] ${definition.name}.forceUpdate requires a data object as the second argument`);const finalData=await applyDefinedSetters(definition,data);await getWhere("forceUpdate").call(baseModel,pk,id).update(finalData);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):null};if(typeof baseModel.forceCreate!=="function")baseModel.forceCreate=async function(data){if(!data||typeof data!=="object"||Array.isArray(data))throw Error(`[ORM] ${definition.name}.forceCreate requires a data object`);const make=baseModel.make;if(typeof make==="function"){const instance=await make.call(baseModel);if(instance&&typeof instance.forceFill==="function"&&typeof instance.save==="function"){instance.forceFill(data);const saved=await instance.save();return saved&&typeof saved==="object"&&saved!==instance&&!saved[STACKS_PROXY_TAG]?instance:saved??instance}}if(typeof unwrappedCreate!=="function")throw Error(`[ORM] ${definition.name}.forceCreate cannot create: the underlying query builder did not expose create()`);return await unwrappedCreate.call(baseModel,data)};baseModel.delete=async function(id){if(id==null)throw Error(`[ORM] ${definition.name}.delete requires an id as the first argument`);if(!await getFind("delete").call(baseModel,id))return!1;await getWhere("delete").call(baseModel,pk,id).delete();return!0};if(typeof baseModel.findOrFail!=="function")baseModel.findOrFail=async function(id){const row=await getFind("findOrFail").call(baseModel,id);if(row==null)throw new ModelNotFoundError(definition.name,id);return row};if(typeof baseModel.exists!=="function")baseModel.exists=async function(id){if(id==null)return!1;const q=getWhere("exists").call(baseModel,pk,id);if(typeof q.count==="function"){const n=await q.count();return Number(n)>0}const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id)!=null:!1};if(typeof baseModel.firstOrCreate!=="function")baseModel.firstOrCreate=async function(attrs,defaults={}){if(!attrs||typeof attrs!=="object"||Array.isArray(attrs))throw Error(`[ORM] ${definition.name}.firstOrCreate requires a where-attrs object`);const q=getWhere("firstOrCreate").call(baseModel,attrs),existing=typeof q.first==="function"?await q.first():await q;if(existing)return existing;const payload={...attrs,...defaults};applyMassAssignmentRules(definition,payload);return await getCreate("firstOrCreate").call(baseModel,payload)};if(typeof baseModel.updateOrCreate!=="function")baseModel.updateOrCreate=async function(attrs,values){if(!attrs||typeof attrs!=="object"||Array.isArray(attrs))throw Error(`[ORM] ${definition.name}.updateOrCreate requires a where-attrs object`);if(!values||typeof values!=="object"||Array.isArray(values))throw Error(`[ORM] ${definition.name}.updateOrCreate requires a values object`);const q=getWhere("updateOrCreate").call(baseModel,attrs),existing=typeof q.first==="function"?await q.first():await q;if(existing){applyMassAssignmentRules(definition,values);const id=existing[pk];await getWhere("updateOrCreate").call(baseModel,pk,id).update(values);const f=baseModel.find;return typeof f==="function"?await f.call(baseModel,id):{...existing,...values}}const payload={...attrs,...values};applyMassAssignmentRules(definition,payload);return await getCreate("updateOrCreate").call(baseModel,payload)};if(typeof baseModel.count!=="function")baseModel.count=async function(){const q=baseModel;if(typeof q.query==="function"){const builder=q.query();if(typeof builder?.count==="function"){const n=await builder.count();return Number(n)||0}}const{all,get}=baseModel;if(typeof all==="function")return(await all.call(baseModel)||[]).length;if(typeof get==="function")return(await get.call(baseModel)||[]).length;return 0};if(typeof baseModel.pluck!=="function")baseModel.pluck=async function(column){if(!column||typeof column!=="string")throw Error(`[ORM] ${definition.name}.pluck requires a column name`);const all=baseModel.all;return((typeof all==="function"?await all.call(baseModel):[])||[]).map((r)=>r?.[column])};if(typeof baseModel.whereIn!=="function")baseModel.whereIn=async function(column,values){if(!column||typeof column!=="string")throw Error(`[ORM] ${definition.name}.whereIn requires a column name`);if(!Array.isArray(values))throw Error(`[ORM] ${definition.name}.whereIn requires an array of values`);if(values.length===0)return[];const w=baseModel.where;if(typeof w!=="function")return[];const q=w.call(baseModel,column,"in",values);if(q&&typeof q.get==="function")return await q.get();return await q};const orderHelpers=[["latest","desc"],["oldest","asc"]];for(const[name,dir]of orderHelpers)if(typeof baseModel[name]!=="function")baseModel[name]=async function(column="created_at"){const q=baseModel,builder=typeof q.query==="function"?q.query():q;if(typeof builder?.orderBy==="function"){const ordered=builder.orderBy(column,dir);if(typeof ordered.first==="function")return await ordered.first();if(typeof ordered.get==="function")return(await ordered.get())?.[0]??null}const all=baseModel.all;if(typeof all!=="function")return null;return[...await all.call(baseModel)||[]].sort((a,b)=>{const av=a?.[column],bv=b?.[column];if(av===bv)return 0;return(av>bv?1:-1)*(dir==="desc"?-1:1)})[0]??null};const searchConfig=resolveSearchConfig(definition.traits?.useSearch,definition);if(searchConfig){const indexName=searchConfig.index??definition.table??snakeCase(`${definition.name}s`);if(typeof baseModel.search!=="function")baseModel.search=function(query,params){return createSearchQueryBuilder(baseModel,indexName,query,params,searchConfig.searchable)};if(typeof baseModel.makeAllSearchable!=="function")baseModel.makeAllSearchable=async function(chunkSize=500){const all=baseModel.all;if(typeof all!=="function")throw Error(`[ORM] ${definition.name}.makeAllSearchable cannot run: the underlying query builder did not expose all()`);const{useSearchEngine}=await import("@stacksjs/search-engine"),engine=useSearchEngine();let total=0;const query=baseModel.query;if(typeof query==="function")try{const q=query.call(baseModel);if(q&&typeof q.chunk==="function"){await q.chunk(chunkSize,async(rows)=>{const docs=await projectDocumentsFromTrait(rows,searchConfig);if(docs.length>0)await engine.addDocuments(indexName,docs);total+=docs.length});return total}}catch{}const rows=await all.call(baseModel)||[],docs=await projectDocumentsFromTrait(rows,searchConfig);if(docs.length>0)await engine.addDocuments(indexName,docs);return docs.length};if(typeof baseModel.removeAllFromSearch!=="function")baseModel.removeAllFromSearch=async function(){const{searchEngineReady}=await import("@stacksjs/search-engine");await(await searchEngineReady()).deleteAllDocuments(indexName)}}}export async function projectDocumentsFromTrait(models,config){if(models.length===0)return[];if(typeof config.shapeMany==="function"){const docs=await config.shapeMany(models);if(!Array.isArray(docs)||docs.length!==models.length)throw TypeError(`[orm/search] shapeMany returned ${Array.isArray(docs)?docs.length:typeof docs} documents for ${models.length} rows. It must return one document per row, in order, or documents are indexed under the wrong ids.`);return docs.filter(Boolean)}return(await Promise.all(models.map((model)=>projectDocumentFromTrait(model,config)))).filter(Boolean)}function hiddenAttributeNames(definition){const hidden=new Set,attributes=definition.attributes??{};for(const[name,attribute]of Object.entries(attributes))if(attribute?.hidden)hidden.add(name);return hidden}function withoutHidden(document,hidden){if(!document||hidden.size===0)return document;const safe={};for(const[key,value]of Object.entries(document))if(!hidden.has(key))safe[key]=value;return safe}async function projectDocumentFromTrait(model,config){if(typeof config.shape==="function")try{return await config.shape(model)}catch{return}const fromHook=model?.toSearchableObject?.();if(fromHook!==void 0)return fromHook;return withoutHidden(model?._attributes??(typeof model?.toJSON==="function"?model.toJSON():null),config.hidden??new Set)}function createSearchQueryBuilder(_baseModel,indexName,query,initialParams,searchableFields){const defaultQueryBy=searchableFields&&searchableFields.length>0?{query_by:[...searchableFields].join(",")}:{};let params={q:query,...defaultQueryBy,...initialParams??{}};const builder={with(extra){params={...params,...extra};return builder},where(filter){params={...params,filter};return builder},async get(){const{useSearchEngine}=await import("@stacksjs/search-engine");return(await useSearchEngine().search(indexName,params))?.hits??[]},async paginate(perPage,page=1){if(!Number.isInteger(perPage)||perPage<1)throw TypeError(`[orm/search] paginate() needs a positive integer page size, got ${perPage}`);if(!Number.isInteger(page)||page<1)throw TypeError(`[orm/search] paginate() pages are 1-based, got ${page}`);const{useSearchEngine}=await import("@stacksjs/search-engine"),result=await useSearchEngine().search(indexName,{...params,limit:perPage,offset:(page-1)*perPage});return{hits:result.hits??[],total:Number(result.estimatedTotalHits??result.nbHits??result.total??0),page,perPage}},async raw(){const{useSearchEngine}=await import("@stacksjs/search-engine");return await useSearchEngine().search(indexName,params)}};return builder}function encryptedAliases(key){const snake=snakeCase(key);return snake===key?[key]:[key,snake]}async function decryptAttrsInPlace(row,encryptedKeys){if(!row||typeof row!=="object")return;const bag=row._attributes??row;for(const key of encryptedKeys)for(const alias of encryptedAliases(key)){if(!(alias in bag))continue;const value=bag[alias];if(!isEncrypted(value))continue;bag[alias]=await decryptValue(value)}}function wrapReadsWithEncryption(baseModel,encryptedKeys){if(encryptedKeys.length===0)return;const decryptResult=async(r)=>{if(Array.isArray(r)){for(const item of r)await decryptAttrsInPlace(item,encryptedKeys);return r}if(r&&typeof r==="object"&&Array.isArray(r.data)){for(const item of r.data)await decryptAttrsInPlace(item,encryptedKeys);return r}if(r)await decryptAttrsInPlace(r,encryptedKeys);return r},directReads=["find","first","last","all","firstOrFail","findOrFail","findMany"];for(const method of directReads){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(...args){const result=await original.apply(this,args);return await decryptResult(result)}}const writeReturningInstance=["create","createMany","firstOrCreate","updateOrCreate","make"];for(const method of writeReturningInstance){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(...args){const result=await original.apply(this,args);return await decryptResult(result)}}for(const method of["update","forceUpdate"]){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(id,data){const result=await original.call(this,id,data);return await decryptResult(result)}}const terminals=["first","firstOrFail","get","all","find","findOrFail","last","paginate","simplePaginate"],decorateBuilder=(builder)=>{if(!builder||typeof builder!=="object")return builder;const target=builder;if(target.__stacksEncryptedReads)return builder;for(const method of terminals){const original=target[method];if(typeof original!=="function")continue;target[method]=async function(...args){return await decryptResult(await original.apply(this,args))}}for(const method of["where","whereIn","whereNull","whereNotNull","orWhere","orderBy","orderByDesc","limit","offset","with"]){const original=target[method];if(typeof original!=="function")continue;target[method]=function(...args){return decorateBuilder(original.apply(this,args))}}Object.defineProperty(target,"__stacksEncryptedReads",{value:!0,enumerable:!1});return builder};for(const entry of["where","whereIn","whereNull","whereNotNull","orderBy","orderByDesc","limit","query"]){const original=baseModel[entry];if(typeof original!=="function")continue;baseModel[entry]=function(...args){return decorateBuilder(original.apply(this,args))}}}function wrapWritesWithEncryption(baseModel,encryptedKeys){if(encryptedKeys.length===0)return;const encryptArg=async(data)=>{if(!data||typeof data!=="object"||Array.isArray(data))return data;const out={...data};for(const key of encryptedKeys)for(const alias of encryptedAliases(key))if(alias in out)out[alias]=await encryptValue(out[alias]);return out},writeMethods=["create","firstOrCreate","updateOrCreate","forceCreate"],originalCreateMany=baseModel.createMany;if(typeof originalCreateMany==="function")baseModel.createMany=async function(items,...rest){const encrypted=Array.isArray(items)?await Promise.all(items.map(encryptArg)):items;return await originalCreateMany.call(this,encrypted,...rest)};for(const method of writeMethods){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(...args){args[0]=await encryptArg(args[0]);if(args[1])args[1]=await encryptArg(args[1]);return await original.apply(this,args)}}for(const method of["update","forceUpdate"]){const original=baseModel[method];if(typeof original!=="function")continue;baseModel[method]=async function(id,data){const enc=await encryptArg(data);return await original.call(this,id,enc)}}}function wrapWritesWithMassAssignment(baseModel,definition){const origCreate=baseModel.create;if(typeof origCreate==="function")baseModel.create=async function(data,...rest){applyMassAssignmentRules(definition,data);const finalData=await applyDefinedSetters(definition,data);return await origCreate.call(this,finalData,...rest)};const origCreateMany=baseModel.createMany;if(typeof origCreateMany==="function")baseModel.createMany=async function(items,...rest){const finalItems=[];for(const data of items){applyMassAssignmentRules(definition,data);finalItems.push(await applyDefinedSetters(definition,data))}return await origCreateMany.call(this,finalItems,...rest)};for(const method of["firstOrCreate","updateOrCreate"]){const orig=baseModel[method];if(typeof orig!=="function")continue}}function wrapWritesWithValidation(baseModel,definition){if(!hasWriteValidators(definition))return;const modelName=String(definition?.name??baseModel.name??"Model"),check=(data,hook)=>{if(validationIsSuppressed())return;if(!data||typeof data!=="object"||Array.isArray(data))return;const result=validateWriteBody(data,definition,hook);if(!result.valid)throw new ModelValidationError(modelName,result.errors)},origCreate=baseModel.create;if(typeof origCreate==="function")baseModel.create=async function(data,...rest){check(data,"creating");return await origCreate.call(this,data,...rest)};const origCreateMany=baseModel.createMany;if(typeof origCreateMany==="function")baseModel.createMany=async function(items,...rest){if(Array.isArray(items))for(const data of items)check(data,"creating");return await origCreateMany.call(this,items,...rest)};const origUpdate=baseModel.update;if(typeof origUpdate==="function")baseModel.update=async function(id,data,...rest){check(data,"updating");return await origUpdate.call(this,id,data,...rest)}}function wrapQueryMethodsWithCasts(baseModel,casts){const writeMethods=["create","firstOrCreate","updateOrCreate"],originalCreateMany=baseModel.createMany;if(typeof originalCreateMany==="function")baseModel.createMany=async function(items,...rest){const cast=Array.isArray(items)?items.map((item)=>item&&typeof item==="object"&&!Array.isArray(item)?castAttributes(item,casts,"set"):item):items;return await originalCreateMany.call(this,cast,...rest)};for(const method of writeMethods){const original=baseModel[method];if(typeof original==="function")baseModel[method]=async function(...args){log.debug(`[orm] ${method.charAt(0).toUpperCase()+method.slice(1)} ${String(baseModel.name||"unknown")}`,args[0]);if(args[0]&&typeof args[0]==="object"&&!Array.isArray(args[0]))args[0]=castAttributes(args[0],casts,"set");return await original.apply(this,args)}}const origUpdate=baseModel.update;if(typeof origUpdate==="function")baseModel.update=async function(id,data){const cast=data&&typeof data==="object"&&!Array.isArray(data)?castAttributes(data,casts,"set"):data;return await origUpdate.call(this,id,cast)}}import{createMessagingMethods}from"./messaging";import{createTaggableMethods}from"./traits/taggable";import{createCategorizableMethods}from"./traits/categorizable";import{createCommentableMethods}from"./traits/commentable";import{BILLABLE_INSTANCE_METHODS,createBillableMethods}from"./traits/billable";import{createLikeableMethods}from"./traits/likeable";import{createTwoFactorMethods}from"./traits/two-factor";import{createSoftDeleteMethods,resolveSoftDeleteOptions,cascadeSoftDelete}from"./traits/soft-deletes";import{applyAudit,resolveAuditOptions}from"./traits/audit";import{applyActivityLog,resolveActivityLogOptions}from"./traits/activity-log";import{collectEncryptedAttributes,decryptValue,encryptValue,isEncrypted}from"./utils/encrypted";const KNOWN_TRAITS=new Set(["useUuid","useTimestamps","timestampable","useSoftDeletes","softDeletable","useApi","useAuth","authenticatable","useSearch","searchable","useSeeder","seedable","useSocials","billable","observe","useAudit","useActivityLog","prunable","sharding","likeable","taggable","categorizable","useMessaging","commentable","commentables","broadcastOn","broadcastWith","gdpr"]);export function defineModel(definition){log.debug(`[orm] Defining model: ${definition.name} (table: ${definition.table})`);for(const trait of Object.keys(definition.traits??{}))if(!KNOWN_TRAITS.has(trait))log.warn(`[orm] Model '${definition.name}' declares an unknown trait '${trait}'. It does nothing. Known traits: ${[...KNOWN_TRAITS].sort().join(", ")}.`);const observeHooks=buildEventHooks(definition),searchHooks=buildSearchHooks(definition),hooks=mergeModelHooks(observeHooks,searchHooks),traitMethods=buildTraitMethods(definition);definition.__traitMethods=traitMethods;const authenticatable=definition.traits;if((authenticatable?.useAuth||authenticatable?.authenticatable)&&definition.name!=="PersonalAccessToken"){const declared=definition.morphMany;if(!declared||!("tokenable"in declared))definition.morphMany={...declared??{},tokenable:"PersonalAccessToken"}}const defWithHooks=hooks?{...definition,hooks:{...definition.hooks,...hooks}}:definition,baseModel=createModel(defWithHooks);wrapReadsWithProxy(baseModel,definition.casts);addStaticHelpers(baseModel,defWithHooks);wrapWritesWithMassAssignment(baseModel,defWithHooks);if(definition.casts&&Object.keys(definition.casts).length>0)wrapQueryMethodsWithCasts(baseModel,definition.casts);const encryptedKeys=collectEncryptedAttributes(definition);if(encryptedKeys.length>0){wrapWritesWithEncryption(baseModel,encryptedKeys);wrapReadsWithEncryption(baseModel,encryptedKeys)}const softDeleteFlag=definition.traits?.useSoftDeletes;if(softDeleteFlag)applySoftDeletes(baseModel,defWithHooks,softDeleteFlag);const useAuditDecl=definition.traits?.useAudit;if(useAuditDecl){const auditOpts=resolveAuditOptions(useAuditDecl);applyAudit(baseModel,definition.name,definition.primaryKey||"id",auditOpts)}const activityOptions=resolveActivityLogOptions(definition.traits?.useActivityLog);if(activityOptions)applyActivityLog(baseModel,definition.name,definition.primaryKey||"id",activityOptions,[...hiddenAttributeNames(definition)]);wrapWritesWithValidation(baseModel,defWithHooks);const withHelpers=baseModel;withHelpers.withoutValidation=function(fn){return withoutValidation(fn)};withHelpers.withoutEvents=function(fn){return withoutEvents(fn)};for(const method of["create","createMany","update","firstOrCreate","updateOrCreate","forceCreate","forceUpdate","delete","forceDelete","softDelete","restore"]){const orig=baseModel[method];if(typeof orig!=="function")continue;const quietName=`${method}Quietly`;if(typeof baseModel[quietName]==="function")continue;baseModel[quietName]=function(...args){return withoutEvents(()=>orig.apply(baseModel,args))}}const finalModel=Object.assign(baseModel,traitMethods,{...definition,getDefinition:()=>definition,_isStacksModel:!0});registerModel(definition.name,finalModel);Object.defineProperty(finalModel,MODEL_DEFINITION,{value:definition,enumerable:!1,configurable:!0});return finalModel}function buildEventHooks(definition){const observe=definition.traits?.observe;if(!observe)return;const modelName=definition.name.toLowerCase(),toEventPayload=(model)=>{const attributes=model?.attributes;if(!attributes||typeof attributes!=="object")return model;const pk=definition.primaryKey||"id",payload={...attributes};if(payload[pk]===void 0&&model[pk]!==void 0)payload[pk]=model[pk];return payload},dispatchEvent=async(event,data)=>{if(eventsAreSuppressed())return;try{const{dispatch}=modelEventsModule??=await import("@stacksjs/events");await dispatch(event,data)}catch(err){if(err&&typeof err==="object"&&"code"in err&&err.code==="MODULE_NOT_FOUND")return;console.error(`[ORM] Event '${event}' handler error:`,err);if(process.env.STACKS_ORM_EVENT_ERRORS!=="swallow")throw err}},broadcastOnFn=definition.traits?.broadcastOn,broadcastWithFn=definition.traits?.broadcastWith,broadcastingEnabled=typeof broadcastOnFn==="function"&&typeof broadcastWithFn==="function",dispatchBroadcast=async(event,model)=>{if(!broadcastingEnabled)return;if(eventsAreSuppressed())return;try{const channelsRaw=broadcastOnFn(model),channels=Array.isArray(channelsRaw)?channelsRaw:[channelsRaw],payload=broadcastWithFn(model),broadcast=(await import("@stacksjs/realtime").catch(()=>null))?.broadcast;if(typeof broadcast!=="function")return;for(const channel of channels){if(typeof channel!=="string"||channel.length===0)continue;await broadcast(channel,event,payload)}}catch(err){if(err&&typeof err==="object"&&"code"in err&&err.code==="MODULE_NOT_FOUND")return;console.error(`[ORM] Broadcast '${event}' handler error:`,err);if(process.env.STACKS_ORM_BROADCAST_ERRORS==="throw")throw err}},dispatchBeforeEvent=async(event,data)=>{if(eventsAreSuppressed())return!0;let eventsModule;try{eventsModule=modelEventsModule??=await import("@stacksjs/events");const{dispatchAndCollect}=eventsModule,results=await dispatchAndCollect(event,data);if(results.some((result)=>result.ok&&result.value===!1))return!1;const failure=results.find((result)=>!result.ok);if(failure&&!failure.ok)throw failure.error}catch(err){if(!eventsModule&&err&&typeof err==="object"&&"code"in err&&err.code==="MODULE_NOT_FOUND")return!0;console.error(`[ORM] Before-event '${event}' handler error:`,err);if(process.env.STACKS_ORM_EVENT_ERRORS!=="swallow")throw err}return!0},events=observe===!0?["create","update","delete"]:Array.isArray(observe)?observe:[],hooks={};if(events.includes("create")){hooks.beforeCreate=async(model)=>{log.debug(`[orm] Create ${modelName}`,model);if(!await dispatchBeforeEvent(`${modelName}:saving`,model))throw Error(`[ORM] ${modelName}:saving event cancelled the operation`);if(!await dispatchBeforeEvent(`${modelName}:creating`,model))throw Error(`[ORM] ${modelName}:creating event cancelled the operation`)};hooks.afterCreate=async(model)=>{const payload=toEventPayload(model);await dispatchEvent(`${modelName}:created`,payload);await dispatchEvent(`${modelName}:saved`,payload);await dispatchBroadcast(`${modelName}:created`,model)}}if(events.includes("update")){hooks.beforeUpdate=async(model)=>{log.debug(`[orm] Update ${modelName}#${model?.id??"unknown"}`,model);if(!await dispatchBeforeEvent(`${modelName}:saving`,model))throw Error(`[ORM] ${modelName}:saving event cancelled the operation`);if(!await dispatchBeforeEvent(`${modelName}:updating`,model))throw Error(`[ORM] ${modelName}:updating event cancelled the operation`)};hooks.afterUpdate=async(model)=>{const payload=toEventPayload(model);await dispatchEvent(`${modelName}:updated`,payload);await dispatchEvent(`${modelName}:saved`,payload);await dispatchBroadcast(`${modelName}:updated`,model)}}if(events.includes("delete")){hooks.beforeDelete=async(model)=>{log.debug(`[orm] Delete ${modelName}#${model?.id??"unknown"}`);if(!await dispatchBeforeEvent(`${modelName}:deleting`,model))throw Error(`[ORM] ${modelName}:deleting event cancelled the operation`)};hooks.afterDelete=async(model)=>{await dispatchEvent(`${modelName}:deleted`,toEventPayload(model));await dispatchBroadcast(`${modelName}:deleted`,model)}}return hooks}function mergeModelHooks(...sets){const merged={},names=new Set;for(const set of sets){if(!set)continue;for(const name of Object.keys(set))names.add(name)}for(const name of names){const fns=sets.map((s)=>s?.[name]).filter((fn)=>typeof fn==="function");if(!fns.length)continue;merged[name]=async(...args)=>{for(const fn of fns)await fn(...args)}}return Object.keys(merged).length?merged:void 0}function resolveSearchConfig(useSearch,definition){if(!useSearch)return null;const base=useSearch===!0?{}:typeof useSearch==="object"?{...useSearch}:null;if(!base)return null;if(definition)base.hidden=hiddenAttributeNames(definition);return base}function buildSearchHooks(definition){const config=resolveSearchConfig(definition.traits?.useSearch,definition);if(!config)return;const searchConfig=config,indexName=searchConfig.index??definition.table??snakeCase(`${definition.name}s`);async function projectDocument(model){if(typeof searchConfig.shapeMany==="function")try{const[doc]=await projectDocumentsFromTrait([model],searchConfig);return doc}catch(err){log.warn(`[orm/search] shapeMany() threw for ${definition.name}: ${err.message}`);return}if(typeof searchConfig.shape==="function")try{return await searchConfig.shape(model)}catch(err){log.warn(`[orm/search] shape() threw for ${definition.name}: ${err.message}`);return}const fromHook=wrapModelInstance(model).toSearchableObject?.();if(fromHook!==void 0)return fromHook;return model?._attributes??(typeof model?.toJSON==="function"?model.toJSON():null)}const syncDocument=async(model)=>{if(eventsAreSuppressed())return;const doc=await projectDocument(model);if(!doc)return;if(config.queueable){try{const{Jobs}=await import("@stacksjs/queue");await Jobs.dispatch("SyncSearchIndexJob",{index:indexName,op:"upsert",doc})}catch(err){log.warn(`[orm/search] queue dispatch failed for ${definition.name}; falling back to inline: ${err.message}`);await indexInline(indexName,doc,definition.name)}return}await indexInline(indexName,doc,definition.name)};return{afterCreate:syncDocument,afterUpdate:syncDocument,afterDelete:async(model)=>{if(eventsAreSuppressed())return;const id=model?.id??model?._attributes?.id;if(id==null)return;if(config.queueable){try{const{Jobs}=await import("@stacksjs/queue");await Jobs.dispatch("SyncSearchIndexJob",{index:indexName,op:"delete",id:Number(id)})}catch(err){log.warn(`[orm/search] queue dispatch failed for ${definition.name}#${id}; falling back to inline: ${err.message}`);await removeInline(indexName,Number(id),definition.name)}return}await removeInline(indexName,Number(id),definition.name)}}}const searchFailures=new Map;function warnSearchFailure(key,message){const seen=searchFailures.get(key)??0;searchFailures.set(key,seen+1);if(seen===0)log.warn(`[orm/search] ${message}`);else if(seen===9)log.warn(`[orm/search] ${key} is still failing; further identical warnings suppressed for this process.`)}async function indexInline(indexName,doc,modelName){try{const{useSearchEngine}=await import("@stacksjs/search-engine");await useSearchEngine().addDocument(indexName,doc)}catch(err){warnSearchFailure(`index:${modelName}`,`Failed to index ${modelName}: ${err.message}`)}}async function removeInline(indexName,id,modelName){try{const{useSearchEngine}=await import("@stacksjs/search-engine");await useSearchEngine().deleteDocument(indexName,id)}catch(err){warnSearchFailure(`remove:${modelName}`,`Failed to remove ${modelName}#${id}: ${err.message}`)}}function buildTraitMethods(definition){const methods={},{table:tableName,traits}=definition;if(!traits)return methods;if(traits?.useMessaging)methods._messaging=createMessagingMethods(tableName);if(traits.taggable)methods._taggable=createTaggableMethods(tableName);if(traits.categorizable)methods._categorizable=createCategorizableMethods(tableName);if(traits.commentable)methods._commentable=createCommentableMethods(tableName);if(traits.billable)methods._billable=createBillableMethods(tableName);if(traits.likeable){const likeableOpts=typeof traits.likeable==="object"?traits.likeable:void 0;methods._likeable=createLikeableMethods(tableName,likeableOpts)}const useAuth=traits.useAuth||traits.authenticatable;if(typeof useAuth==="object"&&useAuth&&"useTwoFactor"in useAuth&&useAuth.useTwoFactor)methods._twoFactor=createTwoFactorMethods();return methods}function applySoftDeletes(baseModel,definition,traitFlag){const helpers=createSoftDeleteMethods(baseModel,definition.primaryKey||"id"),options=resolveSoftDeleteOptions(traitFlag),parentDef=definition,modelName=definition.name.toLowerCase(),observeOn=definition.traits?.observe!=null&&definition.traits?.observe!==!1,fireRestoring=async(id)=>{if(!observeOn||eventsAreSuppressed())return!0;try{const{dispatchAsync}=modelEventsModule??=await import("@stacksjs/events"),results=await dispatchAsync(`${modelName}:restoring`,{id});if(Array.isArray(results)&&results.some((r)=>r===!1))return!1}catch(err){if(err?.code!=="MODULE_NOT_FOUND")console.error(`[ORM] Before-event '${modelName}:restoring' handler error:`,err)}return!0},fireRestored=async(id)=>{if(!observeOn||eventsAreSuppressed())return;try{const{dispatch}=modelEventsModule??=await import("@stacksjs/events");await dispatch(`${modelName}:restored`,{id})}catch(err){if(err?.code!=="MODULE_NOT_FOUND")console.error(`[ORM] Event '${modelName}:restored' handler error:`,err)}},transactional=process.env.STACKS_ORM_CASCADE_SWALLOW!=="true",softDeleteFn=async(id)=>{if(!options.cascade?.length||!transactional){const ok=await helpers.softDelete(id);if(ok&&options.cascade?.length)await cascadeSoftDelete(parentDef,options,id,"softDelete");return ok}const{db}=await import("@stacksjs/database/runtime");return await db.transaction(async()=>{const ok=await helpers.softDelete(id);if(ok)await cascadeSoftDelete(parentDef,options,id,"softDelete");return ok})},restoreFn=async(id)=>{if(!await fireRestoring(id))return!1;if(!options.cascade?.length||!transactional){const ok=await helpers.restore(id);if(ok){if(options.cascade?.length)await cascadeSoftDelete(parentDef,options,id,"restore");await fireRestored(id)}return ok}const{db}=await import("@stacksjs/database/runtime"),ok=await db.transaction(async()=>{const inner=await helpers.restore(id);if(inner)await cascadeSoftDelete(parentDef,options,id,"restore");return inner});if(ok)await fireRestored(id);return ok};baseModel.softDelete=softDeleteFn;baseModel.restore=restoreFn;baseModel.forceDelete=helpers.forceDelete;baseModel.withTrashed=helpers.withTrashed;baseModel.onlyTrashed=helpers.onlyTrashed;baseModel.delete=softDeleteFn}export function toAttrs(value){if(value==null)return value;if(Array.isArray(value))return value.map((v)=>toAttrs(v));if(typeof value!=="object")return value;const candidate=value;if(typeof candidate.toJSON==="function")return candidate.toJSON();if(candidate._attributes&&typeof candidate._attributes==="object")return candidate._attributes;return value}

package/package.json

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