resora 0.2.17 → 0.2.18

package/dist/index.cjs

@@ -1,7 +1,1138 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`fs`),l=require(`path`);l=s(l);let u=require(`module`),d=require(`url`),f=require(`@h3ravel/musket`);function ee(e){return e}let p,m,h=[`meta`,`links`],g={first:`first`,last:`last`,prev:`prev`,next:`next`},te=``,ne=`page`,_={to:`to`,from:`from`,links:`links`,path:`path`,total:`total`,per_page:`per_page`,last_page:`last_page`,current_page:`current_page`},v={previous:`previous`,next:`next`};const re=e=>{p=e},ie=()=>p,y=e=>{m=e},b=()=>m,ae=e=>{m={...m||{},rootKey:e}},oe=e=>{m={...m||{},wrap:e}},se=()=>m?.wrap,ce=()=>m?.rootKey,le=e=>{m={...m||{},factory:e}},ue=()=>m?.factory,x=e=>{h=e},S=()=>h,de=e=>{g={...g,...e}},fe=()=>g,pe=e=>{te=e},me=()=>te,he=e=>{ne=e},C=()=>ne,ge=e=>{_=e},_e=()=>_,ve=e=>{v={...v,...e}},ye=()=>v;let be;const w=e=>{be=e},T=()=>be,E=e=>{if(!e||typeof e!=`object`)return typeof e==`string`?e:void 0;let t=e;return t.req&&typeof t.req==`object`?D(t.req):D(t)},D=e=>{if(typeof e.originalUrl==`string`)return e.originalUrl;if(typeof e.url==`string`)try{let t=new URL(e.url);return t.pathname+t.search}catch{return e.url}},O=e=>{if(!e||typeof e!=`object`)return;let t=e;return t.res&&typeof t.res==`object`?t.res:e},k=e=>{w(E(e))},A=e=>{if(typeof e!=`object`||!e||Array.isArray(e)||e instanceof Date||e instanceof RegExp)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null},j=(e,t,n=`data`)=>!t||Object.keys(t).length===0?e:Array.isArray(e)?{[n]:e,...t}:A(e)?{...e,...t}:{[n]:e,...t},M=(e,t)=>{if(!t)return e;if(!e)return t;let n={...e};for(let[e,r]of Object.entries(t)){let t=n[e];A(t)&&A(r)?n[e]=M(t,r):n[e]=r}return n},N=e=>{if(!e||typeof e!=`object`)return!1;let t=e;return typeof t.toObject==`function`&&typeof t.getRawAttributes==`function`},P=e=>!e||typeof e!=`object`?!1:typeof e.all==`function`,F=e=>{if(Array.isArray(e))return e.map(e=>F(e));if(N(e))return F(e.toObject());if(P(e)){let t=e.all();return Array.isArray(t)?t.map(e=>F(e)):F(t)}return A(e)?Object.entries(e).reduce((e,[t,n])=>(e[t]=F(n),e),{}):e},I=()=>{let e=S();return Array.isArray(e)?{metaKey:e.includes(`meta`)?`meta`:void 0,linksKey:e.includes(`links`)?`links`:void 0,cursorKey:e.includes(`cursor`)?`cursor`:void 0}:{metaKey:e.meta,linksKey:e.links,cursorKey:e.cursor}},xe=e=>{if(e===null)return;let t=Number(e);if(!(!Number.isInteger(t)||t<1))return t},Se=(e,t)=>{try{return new URL(e,`http://resora.local`).searchParams.get(t)}catch{let n=e.indexOf(`?`);return n<0?null:new URLSearchParams(e.slice(n+1)).get(t)}},L=(e,t=C()||`page`)=>{let n=e===void 0?T():E(e);if(n)return xe(Se(n,t))},Ce=e=>t=>L(e,t),R=(e,t)=>{if(e===void 0)return;let n=t||T()||``,r=me()||``,i=C()||`page`,a=n.indexOf(`?`),o=a>=0?n.slice(0,a):n,s=a>=0?n.slice(a+1):``;if(/^https?:\/\//i.test(o)){let t=new URL(n);return t.searchParams.set(i,String(e)),t.toString()}let c=r.replace(/\/$/,``),l=o.replace(/^\//,``);if(/^https?:\/\//i.test(c)){let t=l?`${c}/${l}`:c,n=new URL(t);if(s)for(let[e,t]of new URLSearchParams(s))n.searchParams.set(e,t);return n.searchParams.set(i,String(e)),n.toString()}let u=[c,l].filter(Boolean).join(`/`),d=u?`/${u}`:`/`,f=new URLSearchParams(s);return f.set(i,String(e)),`${d}?${f.toString()}`},we=e=>{let t=e.currentPage,n=e.lastPage,r=e.hasMorePages;return{firstPage:typeof n==`number`?1:void 0,lastPage:n,nextPage:typeof n==`number`?typeof t==`number`&&t<n?t+1:void 0:r&&typeof t==`number`?t+1:void 0,prevPage:typeof t==`number`&&t>1?t-1:void 0}},z=(e,t)=>e.links&&Object.prototype.hasOwnProperty.call(e.links,t),B=e=>{let{metaKey:t,linksKey:n,cursorKey:r}=I(),i={},a=!!e&&typeof e==`object`&&!!e.meta&&typeof e.meta==`object`&&(Array.isArray(e.data)||P(e.data)),o=a?we(e.meta):void 0,s=a?{first:typeof e.firstPageUrl==`function`?e.firstPageUrl():void 0,last:typeof e.lastPageUrl==`function`?e.lastPageUrl():void 0,prev:typeof e.previousPageUrl==`function`?e.previousPageUrl():void 0,next:typeof e.nextPageUrl==`function`?e.nextPageUrl():void 0}:void 0,c=e?.pagination||(a?{...e.meta,...o||{},path:e.urlDriver?.path}:void 0),l=e?.cursor,u={},d={};if(c){let e=T()||c.path,t=e?R(c.currentPage,e)??e:void 0,n={first:z(c,`first`)?c.links.first:R(c.firstPage,e)??s?.first,last:z(c,`last`)?c.links.last:R(c.lastPage,e)??s?.last,prev:z(c,`prev`)?c.links.prev:R(c.prevPage,e)??s?.prev,next:z(c,`next`)?c.links.next:R(c.nextPage,e)??s?.next},r=Object.fromEntries(Object.entries(n).filter(([,e])=>e!==void 0)),i={to:c.to,from:c.from,links:c.links||(a&&Object.keys(r).length?r:void 0),path:t,total:c.total,per_page:c.perPage,last_page:c.lastPage,current_page:c.currentPage};for(let[e,t]of Object.entries(_e())){if(!t)continue;let n=i[e];n!==void 0&&(u[t]=n)}for(let[e,t]of Object.entries(fe())){if(!t)continue;let r=n[e];r!==void 0&&(d[t]=r)}}if(l){let e={},t={previous:l.previous,next:l.next};for(let[n,r]of Object.entries(ye())){if(!r)continue;let i=t[n];i!==void 0&&(e[r]=i)}r&&Object.keys(e).length>0?i[r]=e:Object.keys(e).length>0&&(u.cursor=e)}return t&&Object.keys(u).length>0&&(i[t]=u),n&&Object.keys(d).length>0&&(i[n]=d),i},V=({payload:e,meta:t,metaKey:n=`meta`,wrap:r=!0,rootKey:i=`data`,factory:a,context:o})=>{if(a)return a(e,{...o,rootKey:i,meta:t});if(!r)return t===void 0?e:A(e)?{...e,[n]:t}:{[i]:e,[n]:t};let s={[i]:e};return t!==void 0&&(s[n]=t),s},Te=(e,t)=>{let n=e?.with;if(typeof n!=`function`||n===t||n.length>0)return;let r=n.call(e);return A(r)?r:void 0},H=Symbol(`resora.conditional.missing`),Ee=(e,t)=>e?typeof t==`function`?t():t:H,De=e=>e??H,Oe=(e,t)=>{if(!e)return{};let n=typeof t==`function`?t():t;return A(n)?n:{}},U=e=>{if(e===H)return H;if(Array.isArray(e))return e.map(e=>U(e)).filter(e=>e!==H);if(A(e)){let t={};for(let[n,r]of Object.entries(e)){let e=U(r);e!==H&&(t[n]=e)}return t}return e},W=e=>e.replace(/([a-z0-9])([A-Z])/g,`$1 $2`).replace(/([A-Z]+)([A-Z][a-z])/g,`$1 $2`).replace(/[-_\s]+/g,` `).trim().toLowerCase().split(` `).filter(Boolean),ke=e=>W(e).map((e,t)=>t===0?e:e.charAt(0).toUpperCase()+e.slice(1)).join(``),Ae=e=>W(e).join(`_`),je=e=>W(e).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(``),Me=e=>W(e).join(`-`),G=e=>{if(typeof e==`function`)return e;switch(e){case`camel`:return ke;case`snake`:return Ae;case`pascal`:return je;case`kebab`:return Me}},K=(e,t)=>e==null?e:Array.isArray(e)?e.map(e=>K(e,t)):e instanceof Date||e instanceof RegExp?e:typeof e==`object`?Object.fromEntries(Object.entries(e).map(([e,n])=>[t(e),K(n,t)])):e;let q=l.default.resolve(process.cwd(),`node_modules/resora/stubs`);(0,c.existsSync)(q)||(q=l.default.resolve(process.cwd(),`stubs`));const Ne=()=>({stubsDir:q,preferredCase:`camel`,responseStructure:{wrap:!0,rootKey:`data`},paginatedExtras:[`meta`,`links`],baseUrl:``,pageName:`page`,paginatedLinks:{first:`first`,last:`last`,prev:`prev`,next:`next`},paginatedMeta:{to:`to`,from:`from`,links:`links`,path:`path`,total:`total`,per_page:`per_page`,last_page:`last_page`,current_page:`current_page`},cursorMeta:{previous:`previous`,next:`next`},resourcesDir:`src/resources`,stubs:{config:`resora.config.stub`,resource:`resource.stub`,collection:`resource.collection.stub`}}),J=e=>{let t=Ne();return Object.assign(t,e,{stubs:Object.assign(t.stubs,e.stubs||{})},{cursorMeta:Object.assign(t.cursorMeta,e.cursorMeta||{})},{paginatedMeta:e.paginatedMeta||t.paginatedMeta},{paginatedLinks:Object.assign(t.paginatedLinks,e.paginatedLinks||{})},{responseStructure:Object.assign(t.responseStructure,e.responseStructure||{})})};let Y=!1,X;const Pe=()=>{Y=!1,X=void 0},Fe=e=>{e.preferredCase!==`camel`&&re(e.preferredCase),y(e.responseStructure),x(e.paginatedExtras),de(e.paginatedLinks),ge(e.paginatedMeta),ve(e.cursorMeta),pe(e.baseUrl),he(e.pageName)},Ie=async e=>await import(`${(0,d.pathToFileURL)(e).href}?resora_runtime=${Date.now()}`),Le=e=>{Fe(J((e?.default??e)||{})),Y=!0},Re=()=>{let e=(0,u.createRequire)(e(`url`).pathToFileURL(__filename).href),t=[l.default.join(process.cwd(),`resora.config.cjs`)];for(let n of t)if((0,c.existsSync)(n))try{return Le(e(n)),!0}catch{continue}return!1},Z=async()=>{if(!Y){if(X)return await X;Re()||(X=(async()=>{let e=[l.default.join(process.cwd(),`resora.config.js`),l.default.join(process.cwd(),`resora.config.ts`)];for(let t of e)if((0,c.existsSync)(t))try{Le(await Ie(t));return}catch{continue}Y=!0})(),await X)}};Z();var ze=class{command;config={};constructor(e={}){this.config=J(e)}async loadConfig(e={}){this.config=J(e);let t=[(0,l.join)(process.cwd(),`resora.config.ts`),(0,l.join)(process.cwd(),`resora.config.js`),(0,l.join)(process.cwd(),`resora.config.cjs`)];for(let e of t)if((0,c.existsSync)(e))try{let{default:t}=await import(e);Object.assign(this.config,t);break}catch(t){console.error(`Error loading config file at ${e}:`,t)}return this}getConfig(){return this.config}init(){let e=(0,l.join)(process.cwd(),`resora.config.js`),t=(0,l.join)(this.config.stubsDir,this.config.stubs.config);return(0,c.existsSync)(e)&&!this.command.option(`force`)&&(this.command.error(`Error: ${e} already exists.`),process.exit(1)),this.ensureDirectory(e),(0,c.existsSync)(e)&&this.command.option(`force`)&&(0,c.copyFileSync)(e,e.replace(/\.js$/,`.backup.${Date.now()}.js`)),(0,c.writeFileSync)(e,(0,c.readFileSync)(t,`utf-8`)),{path:e}}ensureDirectory(e){let t=(0,l.dirname)(e);(0,c.existsSync)(t)||(0,c.mkdirSync)(t,{recursive:!0})}generateFile(e,t,n,r){(0,c.existsSync)(t)&&!r?.force?(this.command.error(`Error: ${t} already exists.`),process.exit(1)):(0,c.existsSync)(t)&&r?.force&&(0,c.rmSync)(t);let i=(0,c.readFileSync)(e,`utf-8`);for(let[e,t]of Object.entries(n))i=i.replace(RegExp(`{{${e}}}`,`g`),t);return this.ensureDirectory(t),(0,c.writeFileSync)(t,i),t}makeResource(e,t){let n=e;t?.collection&&!e.endsWith(`Collection`)&&!e.endsWith(`Resource`)?n+=`Collection`:!t?.collection&&!e.endsWith(`Resource`)&&!e.endsWith(`Collection`)&&(n+=`Resource`);let r=`${n}.ts`,i=(0,l.join)(this.config.resourcesDir,r),a=(0,l.join)(this.config.stubsDir,t?.collection||e.endsWith(`Collection`)?this.config.stubs.collection:this.config.stubs.resource);(0,c.existsSync)(a)||(this.command.error(`Error: Stub file ${a} not found.`),process.exit(1)),n=n.split(`/`).pop()?.split(`.`).shift();let o=n.replace(/(Resource|Collection)$/,``)+`Resource`,s=[`/**`,` * The resource that this collection collects.`,` */`,`collects = ${o}`].join(`
-`),u=`import ${o} from './${o}'\n`,d=(!!t?.collection||e.endsWith(`Collection`))&&(0,c.existsSync)((0,l.join)(this.config.resourcesDir,`${o}.ts`)),f=this.generateFile(a,i,{ResourceName:n,CollectionResourceName:n.replace(/(Resource|Collection)$/,``)+`Resource`,"collects = Resource":d?s:``,"import = Resource":d?u:``},t);return{name:n,path:f}}},Be=class extends f.Command{signature=`init
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let fs = require("fs");
+let path = require("path");
+path = __toESM(path);
+let module$1 = require("module");
+let url = require("url");
+let _h3ravel_musket = require("@h3ravel/musket");
+
+//#region src/ApiResource.ts
+/**
+* ApiResource function to return the Resource instance
+* 
+* @param instance Resource instance
+* @returns Resource instance
+*/
+function ApiResource(instance) {
+	return instance;
+}
+
+//#endregion
+//#region src/utilities/state.ts
+let globalPreferredCase;
+let globalResponseStructure;
+let globalPaginatedExtras = ["meta", "links"];
+let globalPaginatedLinks = {
+	first: "first",
+	last: "last",
+	prev: "prev",
+	next: "next"
+};
+let globalBaseUrl = "";
+let globalPageName = "page";
+let globalPaginatedMeta = {
+	to: "to",
+	from: "from",
+	links: "links",
+	path: "path",
+	total: "total",
+	per_page: "per_page",
+	last_page: "last_page",
+	current_page: "current_page"
+};
+let globalCursorMeta = {
+	previous: "previous",
+	next: "next"
+};
+/**
+* Sets the global case style for response keys, which will be applied 
+* to all responses unless overridden by individual resource configurations.
+* 
+* @param style The case style to set as the global default for response keys. 
+*/
+const setGlobalCase = (style) => {
+	globalPreferredCase = style;
+};
+/**
+* Retrieves the global case style for response keys, which is used 
+* to determine how keys in responses should be formatted.
+* 
+* @returns 
+*/
+const getGlobalCase = () => {
+	return globalPreferredCase;
+};
+/**
+* Sets the global response structure configuration, which defines how 
+* responses should be structured across the application.
+* 
+* @param config The response structure configuration object.
+*/
+const setGlobalResponseStructure = (config) => {
+	globalResponseStructure = config;
+};
+/**
+* Retrieves the global response structure configuration, which 
+* defines how  responses should be structured across the application.
+* 
+* @returns 
+*/
+const getGlobalResponseStructure = () => {
+	return globalResponseStructure;
+};
+/**
+* Sets the global response root key, which is the key under which 
+* the main data will be nested in responses if wrapping is enabled.
+* 
+* @param rootKey The root key to set for response data.
+*/
+const setGlobalResponseRootKey = (rootKey) => {
+	globalResponseStructure = {
+		...globalResponseStructure || {},
+		rootKey
+	};
+};
+/**
+* Sets the global response wrap option, which determines whether responses 
+* should be wrapped in a root key or returned unwrapped when possible.
+* 
+* @param wrap The wrap option to set for responses.
+*/
+const setGlobalResponseWrap = (wrap) => {
+	globalResponseStructure = {
+		...globalResponseStructure || {},
+		wrap
+	};
+};
+/**
+* Retrieves the global response wrap option, which indicates whether responses 
+* should be wrapped in a root key or returned unwrapped when possible.
+* 
+* @returns 
+*/
+const getGlobalResponseWrap = () => {
+	return globalResponseStructure?.wrap;
+};
+/**
+* Retrieves the global response root key, which is the key under which the main 
+* data will be nested in responses if wrapping is enabled.
+* 
+* @returns 
+*/
+const getGlobalResponseRootKey = () => {
+	return globalResponseStructure?.rootKey;
+};
+/**
+* Sets the global response factory, which is a custom function that can be used 
+* to produce a completely custom response structure based on the provided 
+* payload and context.
+* 
+* @param factory The response factory function to set as the global default for response construction.
+*/
+const setGlobalResponseFactory = (factory) => {
+	globalResponseStructure = {
+		...globalResponseStructure || {},
+		factory
+	};
+};
+/**
+* Retrieves the global response factory, which is a custom function that 
+* can be used to produce a completely custom response structure based on 
+* the provided payload and context.
+* 
+* @returns 
+*/
+const getGlobalResponseFactory = () => {
+	return globalResponseStructure?.factory;
+};
+/**
+* Sets the global paginated extras configuration, which defines the keys 
+* to use for pagination metadata, links, and cursor information in paginated responses.
+* 
+* @param extras The paginated extras configuration object.
+*/
+const setGlobalPaginatedExtras = (extras) => {
+	globalPaginatedExtras = extras;
+};
+/**
+* Retrieves the global paginated extras configuration, which defines the keys to use for pagination metadata, links, and cursor information in paginated responses.
+* 
+* @returns 
+*/
+const getGlobalPaginatedExtras = () => {
+	return globalPaginatedExtras;
+};
+/**
+* Sets the global paginated links configuration, which defines the keys to 
+* use for pagination links (first, last, prev, next) in paginated responses.
+* 
+* @param links The paginated links configuration object.
+*/
+const setGlobalPaginatedLinks = (links) => {
+	globalPaginatedLinks = {
+		...globalPaginatedLinks,
+		...links
+	};
+};
+/**
+* Retrieves the global paginated links configuration, which defines the keys to use for pagination links (first, last, prev, next) in paginated responses.
+* 
+* @returns 
+*/
+const getGlobalPaginatedLinks = () => {
+	return globalPaginatedLinks;
+};
+/**
+* Sets the global base URL, which is used for generating pagination links in responses.
+* 
+* @param baseUrl The base URL to set for pagination link generation.
+*/
+const setGlobalBaseUrl = (baseUrl) => {
+	globalBaseUrl = baseUrl;
+};
+/**
+* Retrieves the global base URL, which is used for generating pagination links in responses.
+* 
+* @returns 
+*/
+const getGlobalBaseUrl = () => {
+	return globalBaseUrl;
+};
+/**
+* Sets the global page name, which is the query parameter name used for the page number in paginated requests and link generation.
+* 
+* @param pageName 
+*/
+const setGlobalPageName = (pageName) => {
+	globalPageName = pageName;
+};
+/**
+* Retrieves the global page name, which is the query parameter name 
+* used for the page number in paginated requests and link generation.
+* 
+* @returns 
+*/
+const getGlobalPageName = () => {
+	return globalPageName;
+};
+/**
+* Retrieves the keys to use for pagination extras (meta, links, cursor) based 
+* on the global configuration.
+* 
+* @param meta Whether to include pagination metadata in the response.
+*/
+const setGlobalPaginatedMeta = (meta) => {
+	globalPaginatedMeta = meta;
+};
+/**
+* Retrieves the keys to use for pagination extras (meta, links, cursor) based 
+* on the global configuration.
+* 
+* @returns The global pagination metadata configuration.
+*/
+const getGlobalPaginatedMeta = () => {
+	return globalPaginatedMeta;
+};
+/**
+* Sets the global cursor meta configuration, which defines the keys to use 
+* for cursor pagination metadata (previous, next) in responses.
+* 
+* @param meta The cursor meta configuration object.
+*/
+const setGlobalCursorMeta = (meta) => {
+	globalCursorMeta = {
+		...globalCursorMeta,
+		...meta
+	};
+};
+/**
+* Retrieves the keys to use for cursor pagination metadata (previous, next) in 
+* responses based on the global configuration.
+* 
+* @returns The global cursor pagination metadata configuration.
+*/
+const getGlobalCursorMeta = () => {
+	return globalCursorMeta;
+};
+let globalRequestUrl;
+/**
+* Sets the current request URL, used as a fallback for pagination link generation
+* when no explicit path is provided in the pagination data.
+* 
+* @param url The request URL or pathname to set.
+*/
+const setRequestUrl = (url) => {
+	globalRequestUrl = url;
+};
+/**
+* Retrieves the current request URL, used as a fallback path for pagination links.
+* 
+* @returns The current request URL, or undefined if not set.
+*/
+const getRequestUrl = () => {
+	return globalRequestUrl;
+};
+/**
+* Extracts the request URL pathname (with query string) from an HTTP context.
+*
+* Both Express middleware and H3 HTTPEvent expose `{ req, res }`. The `req`
+* object carries URL information:
+* - H3 / Web standard `Request`: `req.url` is a full URL string
+* - Express `Request`: `req.originalUrl` is the pathname + query string
+*
+* The function also accepts a plain `req` object directly or a string URL.
+*
+* @param ctx An HTTP context `{ req, res }`, a bare `Request` object, or a string URL.
+* @returns The pathname with query string, or undefined.
+*/
+const extractRequestUrl = (ctx) => {
+	if (!ctx || typeof ctx !== "object") return typeof ctx === "string" ? ctx : void 0;
+	const obj = ctx;
+	if (obj.req && typeof obj.req === "object") return extractUrlFromRequest(obj.req);
+	return extractUrlFromRequest(obj);
+};
+/**
+* Extracts the URL pathname + query string from a request object.
+*
+* Handles both Web standard `Request` (H3) where `url` is a full URL string,
+* and Express `Request` where `originalUrl` or `url` provide the path.
+*/
+const extractUrlFromRequest = (req) => {
+	if (typeof req.originalUrl === "string") return req.originalUrl;
+	if (typeof req.url === "string") try {
+		const parsed = new URL(req.url);
+		return parsed.pathname + parsed.search;
+	} catch {
+		return req.url;
+	}
+};
+/**
+* Extracts the response object from an HTTP context.
+*
+* If the context has a `res` property (Express middleware `{ req, res }` or
+* H3 HTTPEvent), returns `ctx.res`. Otherwise assumes the value is already
+* a bare response object and returns it directly.
+*
+* @param ctx The HTTP context or bare response.
+* @returns The response object, or undefined.
+*/
+const extractResponseFromCtx = (ctx) => {
+	if (!ctx || typeof ctx !== "object") return;
+	const obj = ctx;
+	if (obj.res && typeof obj.res === "object") return obj.res;
+	return ctx;
+};
+/**
+* Sets the current request context. Extracts the request URL from the provided
+* context and stores it for use in pagination link generation.
+* 
+* Can be called from middleware to make the request URL available to all
+* resources created during the request lifecycle.
+* 
+* @param ctx An HTTP context `{ req, res }`, Express Request, H3 HTTPEvent, or bare request.
+*/
+const setCtx = (ctx) => {
+	setRequestUrl(extractRequestUrl(ctx));
+};
+
+//#endregion
+//#region src/utilities/objects.ts
+/**
+* Utility functions for working with objects, including type checking, merging, and property manipulation.
+* 
+* @param value The value to check.
+* @returns `true` if the value is a plain object, `false` otherwise.
+*/
+const isPlainObject = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	if (Array.isArray(value) || value instanceof Date || value instanceof RegExp) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+};
+/**
+* Appends extra properties to a response body, ensuring that the main data is wrapped under a specified root key if necessary.
+* 
+* @param body The original response body, which can be an object, array, or primitive value.
+* @param extra Extra properties to append to the response body.
+* @param rootKey The root key under which to wrap the main data if necessary.
+* @returns The response body with the extra properties appended.
+*/
+const appendRootProperties = (body, extra, rootKey = "data") => {
+	if (!extra || Object.keys(extra).length === 0) return body;
+	if (Array.isArray(body)) return {
+		[rootKey]: body,
+		...extra
+	};
+	if (isPlainObject(body)) return {
+		...body,
+		...extra
+	};
+	return {
+		[rootKey]: body,
+		...extra
+	};
+};
+/**
+* Deeply merges two metadata objects, combining nested objects recursively.
+* 
+* @param base The base metadata object to merge into.
+* @param incoming The incoming metadata object to merge from.
+* @returns 
+*/
+const mergeMetadata = (base, incoming) => {
+	if (!incoming) return base;
+	if (!base) return incoming;
+	const merged = { ...base };
+	for (const [key, value] of Object.entries(incoming)) {
+		const existing = merged[key];
+		if (isPlainObject(existing) && isPlainObject(value)) merged[key] = mergeMetadata(existing, value);
+		else merged[key] = value;
+	}
+	return merged;
+};
+
+//#endregion
+//#region src/utilities/arkorm.ts
+/**
+* Type guard to check if a value is an Arkorm-like model, which is defined as an object 
+* that has a toObject method and optionally getRawAttributes, getAttribute, and 
+* setAttribute methods.
+* 
+* @param value  The value to check
+* @returns True if the value is an Arkorm-like model, false otherwise
+*/
+const isArkormLikeModel = (value) => {
+	if (!value || typeof value !== "object") return false;
+	const candidate = value;
+	return typeof candidate.toObject === "function" && typeof candidate.getRawAttributes === "function";
+};
+/**
+* Type guard to check if a value is an Arkorm-like collection, which is defined as an object
+* 
+* @param value 
+* @returns 
+*/
+const isArkormLikeCollection = (value) => {
+	if (!value || typeof value !== "object") return false;
+	return typeof value.all === "function";
+};
+/**
+* Normalize a value for serialization by recursively converting Arkorm-like models and 
+* collections to plain objects, while preserving the structure of arrays and plain objects.
+* 
+* @param value The value to normalize
+* @returns The normalized value, ready for serialization
+*/
+const normalizeSerializableData = (value) => {
+	if (Array.isArray(value)) return value.map((item) => normalizeSerializableData(item));
+	if (isArkormLikeModel(value)) return normalizeSerializableData(value.toObject());
+	if (isArkormLikeCollection(value)) {
+		const collectionData = value.all();
+		if (Array.isArray(collectionData)) return collectionData.map((item) => normalizeSerializableData(item));
+		return normalizeSerializableData(collectionData);
+	}
+	if (isPlainObject(value)) return Object.entries(value).reduce((accumulator, [key, nestedValue]) => {
+		accumulator[key] = normalizeSerializableData(nestedValue);
+		return accumulator;
+	}, {});
+	return value;
+};
+
+//#endregion
+//#region src/utilities/pagination.ts
+/**
+* Retrieves the configured keys for pagination extras (meta, links, cursor) based on the application's configuration.
+* 
+* @returns An object containing the keys for meta, links, and cursor extras, or `undefined` if not configured.
+*/
+const getPaginationExtraKeys = () => {
+	const extras = getGlobalPaginatedExtras();
+	if (Array.isArray(extras)) return {
+		metaKey: extras.includes("meta") ? "meta" : void 0,
+		linksKey: extras.includes("links") ? "links" : void 0,
+		cursorKey: extras.includes("cursor") ? "cursor" : void 0
+	};
+	return {
+		metaKey: extras.meta,
+		linksKey: extras.links,
+		cursorKey: extras.cursor
+	};
+};
+const parsePageValue = (value) => {
+	if (value === null) return;
+	const page = Number(value);
+	if (!Number.isInteger(page) || page < 1) return;
+	return page;
+};
+const getPageValueFromUrl = (requestUrl, pageName) => {
+	try {
+		return new URL(requestUrl, "http://resora.local").searchParams.get(pageName);
+	} catch {
+		const qIndex = requestUrl.indexOf("?");
+		if (qIndex < 0) return null;
+		return new URLSearchParams(requestUrl.slice(qIndex + 1)).get(pageName);
+	}
+};
+/**
+* Resolves the current page number from a request context or the globally
+* stored request URL, using the configured page query name by default.
+*
+* @param ctx Optional request context or URL.
+* @param pageName Optional page query parameter name.
+* @returns
+*/
+const resolveCurrentPage = (ctx, pageName = getGlobalPageName() || "page") => {
+	const requestUrl = typeof ctx === "undefined" ? getRequestUrl() : extractRequestUrl(ctx);
+	if (!requestUrl) return;
+	return parsePageValue(getPageValueFromUrl(requestUrl, pageName));
+};
+/**
+* Creates an Arkorm-compatible current-page resolver backed by Resora's
+* request-context URL parsing.
+*
+* @param ctx Optional request context or URL.
+* @returns
+*/
+const createArkormCurrentPageResolver = (ctx) => {
+	return (pageName) => resolveCurrentPage(ctx, pageName);
+};
+/**
+* Builds a pagination URL for a given page number and path, using the global base URL and page name configuration.
+*
+* URL resolution follows a three-tier priority:
+* 1. Full URL – when `pathName` is absolute or `baseUrl` is set alongside a path
+* 2. Path-relative – when only a path is available (e.g. `/users?page=2`)
+* 3. Bare fallback – `/?page=X` when neither base URL nor path is available
+*
+* @param page The page number for which to build the URL. If `undefined`, the function will return `undefined`.
+* @param pathName The path to use for the URL. If not provided, it will default to an empty string.
+* @returns
+*/
+const buildPageUrl = (page, pathName) => {
+	if (typeof page === "undefined") return;
+	const rawPath = pathName || getRequestUrl() || "";
+	const base = getGlobalBaseUrl() || "";
+	const pageName = getGlobalPageName() || "page";
+	const qIndex = rawPath.indexOf("?");
+	const pathOnly = qIndex >= 0 ? rawPath.slice(0, qIndex) : rawPath;
+	const existingSearch = qIndex >= 0 ? rawPath.slice(qIndex + 1) : "";
+	if (/^https?:\/\//i.test(pathOnly)) {
+		const url = new URL(rawPath);
+		url.searchParams.set(pageName, String(page));
+		return url.toString();
+	}
+	const normalizedBase = base.replace(/\/$/, "");
+	const normalizedPath = pathOnly.replace(/^\//, "");
+	if (/^https?:\/\//i.test(normalizedBase)) {
+		const root = normalizedPath ? `${normalizedBase}/${normalizedPath}` : normalizedBase;
+		const url = new URL(root);
+		if (existingSearch) for (const [k, v] of new URLSearchParams(existingSearch)) url.searchParams.set(k, v);
+		url.searchParams.set(pageName, String(page));
+		return url.toString();
+	}
+	const segments = [normalizedBase, normalizedPath].filter(Boolean).join("/");
+	const pathBase = segments ? `/${segments}` : "/";
+	const params = new URLSearchParams(existingSearch);
+	params.set(pageName, String(page));
+	return `${pathBase}?${params.toString()}`;
+};
+/**
+* Derives page numbers (firstPage, lastPage, nextPage, prevPage) from an
+* Arkorm-style pagination meta object so that buildPageUrl() can generate
+* links that respect the auto-detected request URL and query string.
+*/
+const derivePageNumbers = (meta) => {
+	const currentPage = meta.currentPage;
+	const lastPage = meta.lastPage;
+	const hasMorePages = meta.hasMorePages;
+	return {
+		firstPage: typeof lastPage === "number" ? 1 : void 0,
+		lastPage,
+		nextPage: typeof lastPage === "number" ? typeof currentPage === "number" && currentPage < lastPage ? currentPage + 1 : void 0 : hasMorePages && typeof currentPage === "number" ? currentPage + 1 : void 0,
+		prevPage: typeof currentPage === "number" && currentPage > 1 ? currentPage - 1 : void 0
+	};
+};
+/**
+* Extracts a pagination link (e.g. 'first', 'last', 'prev', 'next') from a 
+* pagination object, if it exists.
+* 
+* @param pagination 
+* @param rel 
+* @returns 
+*/
+const hasPaginationLink = (pagination, rel) => {
+	return pagination.links && Object.prototype.hasOwnProperty.call(pagination.links, rel);
+};
+/**
+* Builds pagination extras (meta, links, cursor) for a given resource based on 
+* its pagination and cursor properties, using the configured keys for each type of extra.
+* 
+* @param resource The resource for which to build pagination extras. 
+* @returns An object containing the pagination extras (meta, links, cursor) for the resource.
+*/
+const buildPaginationExtras = (resource) => {
+	const { metaKey, linksKey, cursorKey } = getPaginationExtraKeys();
+	const extra = {};
+	const isArkormPaginatorLike = !!resource && typeof resource === "object" && !!resource.meta && typeof resource.meta === "object" && (Array.isArray(resource.data) || isArkormLikeCollection(resource.data));
+	const arkormPageNumbers = isArkormPaginatorLike ? derivePageNumbers(resource.meta) : void 0;
+	const arkormFallbackLinks = isArkormPaginatorLike ? {
+		first: typeof resource.firstPageUrl === "function" ? resource.firstPageUrl() : void 0,
+		last: typeof resource.lastPageUrl === "function" ? resource.lastPageUrl() : void 0,
+		prev: typeof resource.previousPageUrl === "function" ? resource.previousPageUrl() : void 0,
+		next: typeof resource.nextPageUrl === "function" ? resource.nextPageUrl() : void 0
+	} : void 0;
+	const pagination = resource?.pagination || (isArkormPaginatorLike ? {
+		...resource.meta,
+		...arkormPageNumbers || {},
+		path: resource.urlDriver?.path
+	} : void 0);
+	const cursor = resource?.cursor;
+	const metaBlock = {};
+	const linksBlock = {};
+	if (pagination) {
+		const effectivePath = getRequestUrl() || pagination.path;
+		const currentPagePath = effectivePath ? buildPageUrl(pagination.currentPage, effectivePath) ?? effectivePath : void 0;
+		const linksSource = {
+			first: hasPaginationLink(pagination, "first") ? pagination.links.first : buildPageUrl(pagination.firstPage, effectivePath) ?? arkormFallbackLinks?.first,
+			last: hasPaginationLink(pagination, "last") ? pagination.links.last : buildPageUrl(pagination.lastPage, effectivePath) ?? arkormFallbackLinks?.last,
+			prev: hasPaginationLink(pagination, "prev") ? pagination.links.prev : buildPageUrl(pagination.prevPage, effectivePath) ?? arkormFallbackLinks?.prev,
+			next: hasPaginationLink(pagination, "next") ? pagination.links.next : buildPageUrl(pagination.nextPage, effectivePath) ?? arkormFallbackLinks?.next
+		};
+		const resolvedLinks = Object.fromEntries(Object.entries(linksSource).filter(([, v]) => v !== void 0));
+		const metaSource = {
+			to: pagination.to,
+			from: pagination.from,
+			links: pagination.links || (isArkormPaginatorLike && Object.keys(resolvedLinks).length ? resolvedLinks : void 0),
+			path: currentPagePath,
+			total: pagination.total,
+			per_page: pagination.perPage,
+			last_page: pagination.lastPage,
+			current_page: pagination.currentPage
+		};
+		for (const [sourceKey, outputKey] of Object.entries(getGlobalPaginatedMeta())) {
+			if (!outputKey) continue;
+			const value = metaSource[sourceKey];
+			if (typeof value !== "undefined") metaBlock[outputKey] = value;
+		}
+		for (const [sourceKey, outputKey] of Object.entries(getGlobalPaginatedLinks())) {
+			if (!outputKey) continue;
+			const value = linksSource[sourceKey];
+			if (typeof value !== "undefined") linksBlock[outputKey] = value;
+		}
+	}
+	if (cursor) {
+		const cursorBlock = {};
+		const cursorSource = {
+			previous: cursor.previous,
+			next: cursor.next
+		};
+		for (const [sourceKey, outputKey] of Object.entries(getGlobalCursorMeta())) {
+			if (!outputKey) continue;
+			const value = cursorSource[sourceKey];
+			if (typeof value !== "undefined") cursorBlock[outputKey] = value;
+		}
+		if (cursorKey && Object.keys(cursorBlock).length > 0) extra[cursorKey] = cursorBlock;
+		else if (Object.keys(cursorBlock).length > 0) metaBlock.cursor = cursorBlock;
+	}
+	if (metaKey && Object.keys(metaBlock).length > 0) extra[metaKey] = metaBlock;
+	if (linksKey && Object.keys(linksBlock).length > 0) extra[linksKey] = linksBlock;
+	return extra;
+};
+
+//#endregion
+//#region src/utilities/response.ts
+/**
+* Builds a response envelope based on the provided payload, 
+* metadata, and configuration options.
+* 
+* @param config The configuration object containing payload, metadata, and other options for building the response.
+*/
+const buildResponseEnvelope = ({ payload, meta, metaKey = "meta", wrap = true, rootKey = "data", factory, context }) => {
+	if (factory) return factory(payload, {
+		...context,
+		rootKey,
+		meta
+	});
+	if (!wrap) {
+		if (typeof meta === "undefined") return payload;
+		if (isPlainObject(payload)) return {
+			...payload,
+			[metaKey]: meta
+		};
+		return {
+			[rootKey]: payload,
+			[metaKey]: meta
+		};
+	}
+	const body = { [rootKey]: payload };
+	if (typeof meta !== "undefined") body[metaKey] = meta;
+	return body;
+};
+
+//#endregion
+//#region src/utilities/metadata.ts
+/**
+* Resolves metadata from a resource instance by checking for a custom `with` method. 
+* If the method exists and is different from the base method, it calls it to retrieve metadata. 
+* This allows resources to provide additional metadata for response construction.
+* 
+* @param instance The resource instance to check for a custom `with` method.
+* @param baseWithMethod The base `with` method to compare against.
+* @returns The resolved metadata or `undefined` if no custom metadata is provided.
+*/
+const resolveWithHookMetadata = (instance, baseWithMethod) => {
+	const candidate = instance?.with;
+	if (typeof candidate !== "function" || candidate === baseWithMethod) return;
+	if (candidate.length > 0) return;
+	const result = candidate.call(instance);
+	return isPlainObject(result) ? result : void 0;
+};
+
+//#endregion
+//#region src/utilities/conditional.ts
+const CONDITIONAL_ATTRIBUTE_MISSING = Symbol("resora.conditional.missing");
+/**
+* Resolves a value based on a condition. If the condition is falsy, it returns a special symbol indicating that the attribute is missing. 
+* 
+* 
+* @param condition The condition to evaluate.
+* @param value The value or function to resolve if the condition is truthy.
+* @returns The resolved value or a symbol indicating the attribute is missing.
+*/
+const resolveWhen = (condition, value) => {
+	if (!condition) return CONDITIONAL_ATTRIBUTE_MISSING;
+	return typeof value === "function" ? value() : value;
+};
+/**
+* Resolves a value only if it is not null or undefined. 
+* 
+* @param value The value to resolve.
+* @returns The resolved value or a symbol indicating the attribute is missing.
+*/
+const resolveWhenNotNull = (value) => {
+	return value === null || typeof value === "undefined" ? CONDITIONAL_ATTRIBUTE_MISSING : value;
+};
+/**
+* Conditionally merges object attributes based on a condition. 
+* 
+* @param condition 
+* @param value 
+* @returns 
+*/
+const resolveMergeWhen = (condition, value) => {
+	if (!condition) return {};
+	const resolved = typeof value === "function" ? value() : value;
+	return isPlainObject(resolved) ? resolved : {};
+};
+/**
+*  Recursively sanitizes an object or array by removing any attributes that are marked as missing using the special symbol.
+* 
+* @param value The value to sanitize.
+* @returns The sanitized value.
+*/
+const sanitizeConditionalAttributes = (value) => {
+	if (value === CONDITIONAL_ATTRIBUTE_MISSING) return CONDITIONAL_ATTRIBUTE_MISSING;
+	if (Array.isArray(value)) return value.map((item) => sanitizeConditionalAttributes(item)).filter((item) => item !== CONDITIONAL_ATTRIBUTE_MISSING);
+	if (isPlainObject(value)) {
+		const result = {};
+		for (const [key, nestedValue] of Object.entries(value)) {
+			const sanitizedValue = sanitizeConditionalAttributes(nestedValue);
+			if (sanitizedValue === CONDITIONAL_ATTRIBUTE_MISSING) continue;
+			result[key] = sanitizedValue;
+		}
+		return result;
+	}
+	return value;
+};
+
+//#endregion
+//#region src/utilities/case.ts
+/**
+* Splits a string into words based on common delimiters and capitalization patterns.
+* Handles camelCase, PascalCase, snake_case, kebab-case, and space-separated words.
+* 
+* @param str 
+* @returns 
+*/
+const splitWords = (str) => {
+	return str.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[-_\s]+/g, " ").trim().toLowerCase().split(" ").filter(Boolean);
+};
+/**
+* Transforms a string to camelCase.
+* 
+* @param str 
+* @returns 
+*/
+const toCamelCase = (str) => {
+	return splitWords(str).map((w, i) => i === 0 ? w : w.charAt(0).toUpperCase() + w.slice(1)).join("");
+};
+/**
+* Transforms a string to snake_case.
+* 
+* @param str 
+* @returns 
+*/
+const toSnakeCase = (str) => {
+	return splitWords(str).join("_");
+};
+/**
+* Transforms a string to PascalCase.
+* 
+* @param str 
+* @returns 
+*/
+const toPascalCase = (str) => {
+	return splitWords(str).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+};
+/**
+* Transforms a string to kebab-case.
+* 
+* @param str 
+* @returns 
+*/
+const toKebabCase = (str) => {
+	return splitWords(str).join("-");
+};
+/**
+* Retrieves the appropriate case transformation function based on the provided style.
+* 
+* @param style 
+* @returns 
+*/
+const getCaseTransformer = (style) => {
+	if (typeof style === "function") return style;
+	switch (style) {
+		case "camel": return toCamelCase;
+		case "snake": return toSnakeCase;
+		case "pascal": return toPascalCase;
+		case "kebab": return toKebabCase;
+	}
+};
+/**
+* Transforms the keys of an object (including nested objects and arrays) using 
+* the provided transformer function.
+* 
+* @param obj 
+* @param transformer 
+* @returns 
+*/
+const transformKeys = (obj, transformer) => {
+	if (obj === null || obj === void 0) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => transformKeys(item, transformer));
+	if (obj instanceof Date || obj instanceof RegExp) return obj;
+	if (typeof obj === "object") return Object.fromEntries(Object.entries(obj).map(([key, value]) => [transformer(key), transformKeys(value, transformer)]));
+	return obj;
+};
+
+//#endregion
+//#region src/utilities/config.ts
+let stubsDir = path.default.resolve(process.cwd(), "node_modules/resora/stubs");
+if (!(0, fs.existsSync)(stubsDir)) stubsDir = path.default.resolve(process.cwd(), "stubs");
+/**
+* Get the default configuration for the application
+* 
+* @returns 
+*/
+const getDefaultConfig = () => {
+	return {
+		stubsDir,
+		preferredCase: "camel",
+		responseStructure: {
+			wrap: true,
+			rootKey: "data"
+		},
+		paginatedExtras: ["meta", "links"],
+		baseUrl: "",
+		pageName: "page",
+		paginatedLinks: {
+			first: "first",
+			last: "last",
+			prev: "prev",
+			next: "next"
+		},
+		paginatedMeta: {
+			to: "to",
+			from: "from",
+			links: "links",
+			path: "path",
+			total: "total",
+			per_page: "per_page",
+			last_page: "last_page",
+			current_page: "current_page"
+		},
+		cursorMeta: {
+			previous: "previous",
+			next: "next"
+		},
+		resourcesDir: "src/resources",
+		stubs: {
+			config: "resora.config.stub",
+			resource: "resource.stub",
+			collection: "resource.collection.stub"
+		}
+	};
+};
+/**
+* Defines the configuration for the application by merging the provided configuration with the default configuration. This function takes a partial configuration object as input and returns a complete configuration object that includes all required properties, using default values for any properties that are not specified in the input.
+* 
+* @param config 
+* @returns 
+*/
+const defineConfig = (config) => {
+	const defConf = getDefaultConfig();
+	return Object.assign(defConf, config, { stubs: Object.assign(defConf.stubs, config.stubs || {}) }, { cursorMeta: Object.assign(defConf.cursorMeta, config.cursorMeta || {}) }, { paginatedMeta: config.paginatedMeta || defConf.paginatedMeta }, { paginatedLinks: Object.assign(defConf.paginatedLinks, config.paginatedLinks || {}) }, { responseStructure: Object.assign(defConf.responseStructure, config.responseStructure || {}) });
+};
+
+//#endregion
+//#region src/utilities/runtime-config.ts
+let runtimeConfigLoaded = false;
+let runtimeConfigLoadingPromise;
+/**
+* Resets the runtime configuration state for testing purposes.
+* 
+* @returns
+*/
+const resetRuntimeConfigForTests = () => {
+	runtimeConfigLoaded = false;
+	runtimeConfigLoadingPromise = void 0;
+};
+/**
+* Applies the provided configuration to the global state of the application. 
+* 
+* @param config The complete configuration object to apply.
+*/
+const applyRuntimeConfig = (config) => {
+	if (config.preferredCase !== "camel") setGlobalCase(config.preferredCase);
+	setGlobalResponseStructure(config.responseStructure);
+	setGlobalPaginatedExtras(config.paginatedExtras);
+	setGlobalPaginatedLinks(config.paginatedLinks);
+	setGlobalPaginatedMeta(config.paginatedMeta);
+	setGlobalCursorMeta(config.cursorMeta);
+	setGlobalBaseUrl(config.baseUrl);
+	setGlobalPageName(config.pageName);
+};
+/**
+* Loads the runtime configuration by searching for configuration files in the current working directory. 
+* @param configPath The path to the configuration file to load.
+* @returns 
+*/
+const importConfigFile = async (configPath) => {
+	return await import(`${(0, url.pathToFileURL)(configPath).href}?resora_runtime=${Date.now()}`);
+};
+/**
+* Resolves the imported configuration and applies it to the global state.
+* 
+* @param imported 
+*/
+const resolveAndApply = (imported) => {
+	applyRuntimeConfig(defineConfig((imported?.default ?? imported) || {}));
+	runtimeConfigLoaded = true;
+};
+/**
+* Loads the runtime configuration synchronously by searching for CommonJS configuration files in the current working directory. 
+* 
+* @returns 
+*/
+const loadRuntimeConfigSync = () => {
+	const require = (0, module$1.createRequire)(require("url").pathToFileURL(__filename).href);
+	const syncConfigPaths = [path.default.join(process.cwd(), "resora.config.cjs")];
+	for (const configPath of syncConfigPaths) {
+		if (!(0, fs.existsSync)(configPath)) continue;
+		try {
+			resolveAndApply(require(configPath));
+			return true;
+		} catch {
+			continue;
+		}
+	}
+	return false;
+};
+/**
+* Loads the runtime configuration by searching for configuration files in the current working directory. 
+* 
+* @returns 
+*/
+const loadRuntimeConfig = async () => {
+	if (runtimeConfigLoaded) return;
+	if (runtimeConfigLoadingPromise) return await runtimeConfigLoadingPromise;
+	if (loadRuntimeConfigSync()) return;
+	runtimeConfigLoadingPromise = (async () => {
+		const possibleConfigPaths = [path.default.join(process.cwd(), "resora.config.js"), path.default.join(process.cwd(), "resora.config.ts")];
+		for (const configPath of possibleConfigPaths) {
+			if (!(0, fs.existsSync)(configPath)) continue;
+			try {
+				resolveAndApply(await importConfigFile(configPath));
+				return;
+			} catch {
+				continue;
+			}
+		}
+		runtimeConfigLoaded = true;
+	})();
+	await runtimeConfigLoadingPromise;
+};
+loadRuntimeConfig();
+
+//#endregion
+//#region src/cli/CliApp.ts
+var CliApp = class {
+	command;
+	config = {};
+	constructor(config = {}) {
+		this.config = defineConfig(config);
+	}
+	async loadConfig(config = {}) {
+		this.config = defineConfig(config);
+		const possibleConfigPaths = [
+			(0, path.join)(process.cwd(), "resora.config.ts"),
+			(0, path.join)(process.cwd(), "resora.config.js"),
+			(0, path.join)(process.cwd(), "resora.config.cjs")
+		];
+		for (const configPath of possibleConfigPaths) if ((0, fs.existsSync)(configPath)) try {
+			const { default: userConfig } = await import(configPath);
+			Object.assign(this.config, userConfig);
+			break;
+		} catch (e) {
+			console.error(`Error loading config file at ${configPath}:`, e);
+		}
+		return this;
+	}
+	/**
+	* Get the current configuration object
+	* @returns 
+	*/
+	getConfig() {
+		return this.config;
+	}
+	/**
+	* Initialize Resora by creating a default config file in the current directory
+	* 
+	* @returns 
+	*/
+	init() {
+		const outputPath = (0, path.join)(process.cwd(), "resora.config.js");
+		const stubPath = (0, path.join)(this.config.stubsDir, this.config.stubs.config);
+		if ((0, fs.existsSync)(outputPath) && !this.command.option("force")) {
+			this.command.error(`Error: ${outputPath} already exists.`);
+			process.exit(1);
+		}
+		this.ensureDirectory(outputPath);
+		if ((0, fs.existsSync)(outputPath) && this.command.option("force")) (0, fs.copyFileSync)(outputPath, outputPath.replace(/\.js$/, `.backup.${Date.now()}.js`));
+		(0, fs.writeFileSync)(outputPath, (0, fs.readFileSync)(stubPath, "utf-8"));
+		return { path: outputPath };
+	}
+	/**
+	* Utility to ensure directory exists
+	*
+	* @param filePath
+	*/
+	ensureDirectory(filePath) {
+		const dir = (0, path.dirname)(filePath);
+		if (!(0, fs.existsSync)(dir)) (0, fs.mkdirSync)(dir, { recursive: true });
+	}
+	/**
+	* Utility to generate file from stub
+	*
+	* @param stubPath
+	* @param outputPath
+	* @param replacements
+	*/
+	generateFile(stubPath, outputPath, replacements, options) {
+		if ((0, fs.existsSync)(outputPath) && !options?.force) {
+			this.command.error(`Error: ${outputPath} already exists.`);
+			process.exit(1);
+		} else if ((0, fs.existsSync)(outputPath) && options?.force) (0, fs.rmSync)(outputPath);
+		let content = (0, fs.readFileSync)(stubPath, "utf-8");
+		for (const [key, value] of Object.entries(replacements)) content = content.replace(new RegExp(`{{${key}}}`, "g"), value);
+		this.ensureDirectory(outputPath);
+		(0, fs.writeFileSync)(outputPath, content);
+		return outputPath;
+	}
+	/**
+	* Command to create a new resource or resource collection file
+	*
+	* @param name
+	* @param options
+	*/
+	makeResource(name, options) {
+		let resourceName = name;
+		if (options?.collection && !name.endsWith("Collection") && !name.endsWith("Resource")) resourceName += "Collection";
+		else if (!options?.collection && !name.endsWith("Resource") && !name.endsWith("Collection")) resourceName += "Resource";
+		const fileName = `${resourceName}.ts`;
+		const outputPath = (0, path.join)(this.config.resourcesDir, fileName);
+		const stubPath = (0, path.join)(this.config.stubsDir, options?.collection || name.endsWith("Collection") ? this.config.stubs.collection : this.config.stubs.resource);
+		if (!(0, fs.existsSync)(stubPath)) {
+			this.command.error(`Error: Stub file ${stubPath} not found.`);
+			process.exit(1);
+		}
+		resourceName = resourceName.split("/").pop()?.split(".").shift();
+		const collectsName = resourceName.replace(/(Resource|Collection)$/, "") + "Resource";
+		const collects = [
+			"/**",
+			" * The resource that this collection collects.",
+			" */",
+			`collects = ${collectsName}`
+		].join("\n");
+		const collectsImport = `import ${collectsName} from './${collectsName}'\n`;
+		const hasCollects = (!!options?.collection || name.endsWith("Collection")) && (0, fs.existsSync)((0, path.join)(this.config.resourcesDir, `${collectsName}.ts`));
+		const path$3 = this.generateFile(stubPath, outputPath, {
+			ResourceName: resourceName,
+			CollectionResourceName: resourceName.replace(/(Resource|Collection)$/, "") + "Resource",
+			"collects = Resource": hasCollects ? collects : "",
+			"import = Resource": hasCollects ? collectsImport : ""
+		}, options);
+		return {
+			name: resourceName,
+			path: path$3
+		};
+	}
+};
+
+//#endregion
+//#region src/cli/commands/InitCommand.ts
+var InitCommand = class extends _h3ravel_musket.Command {
+	signature = `init
         {--force : Force overwrite if config file already exists (existing file will be backed up) }
-    `;description=`Initialize Resora`;async handle(){this.app.command=this,this.app.init(),this.success(`Resora initialized`)}},Ve=class extends f.Command{signature=`#create:
+    `;
+	description = "Initialize Resora";
+	async handle() {
+		this.app.command = this;
+		this.app.init();
+		this.success("Resora initialized");
+	}
+};
+
+//#endregion
+//#region src/cli/commands/MakeResource.ts
+var MakeResource = class extends _h3ravel_musket.Command {
+	signature = `#create:
         {resource : Generates a new resource file.
             | {name : Name of the resource to create}
             | {--c|collection : Make a resource collection}
@@ -15,11 +1146,1408 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.
             | {prefix : prefix of the resources to create, "Admin" will create AdminResource, AdminCollection} 
             | {--force : Create the resource or collection file even if it already exists.}
         }
-    `;description=`Create a new resource or resource collection file`;async handle(){this.app.command=this;let e=``,t=this.argument(`name`)||this.argument(`prefix`),n=this.dictionary.name||this.dictionary.baseCommand;if([`resource`,`collection`].includes(n)&&!t)return void this.error(`Error: Name argument is required.`);if(n===`all`&&!t)return void this.error(`Error: Prefix argument is required.`);switch(n){case`resource`:({path:e}=this.app.makeResource(t,this.options()));break;case`collection`:({path:e}=this.app.makeResource(t+`Collection`,this.options()));break;case`all`:{let n=this.app.makeResource(t,{force:this.option(`force`)}),r=this.app.makeResource(t+`Collection`,{collection:!0,force:this.option(`force`)});e=`${n.path}, ${r.path}`;break}default:this.fail(`Unknown action: ${n}`)}this.success(`Created: ${e}`)}};String.raw`
+    `;
+	description = "Create a new resource or resource collection file";
+	async handle() {
+		this.app.command = this;
+		let path = "";
+		const name = this.argument("name") || this.argument("prefix");
+		const action = this.dictionary.name || this.dictionary.baseCommand;
+		if (["resource", "collection"].includes(action) && !name) return void this.error("Error: Name argument is required.");
+		if (action === "all" && !name) return void this.error("Error: Prefix argument is required.");
+		switch (action) {
+			case "resource":
+				({path} = this.app.makeResource(name, this.options()));
+				break;
+			case "collection":
+				({path} = this.app.makeResource(name + "Collection", this.options()));
+				break;
+			case "all": {
+				const o1 = this.app.makeResource(name, { force: this.option("force") });
+				const o2 = this.app.makeResource(name + "Collection", {
+					collection: true,
+					force: this.option("force")
+				});
+				path = `${o1.path}, ${o2.path}`;
+				break;
+			}
+			default: this.fail(`Unknown action: ${action}`);
+		}
+		this.success(`Created: ${path}`);
+	}
+};
+
+//#endregion
+//#region src/cli/logo.ts
+var logo_default = String.raw`
   _____                           
  |  __ \                          
  | |__) |___  ___  ___  _ __ __ _ 
  |  _  // _ \/ __|/ _ \| '__/ _, |
  | | \ \  __/\__ \ (_) | | | (_| |
  |_|  \_\___||___/\___/|_|  \__,_|                                                                                           
-`;var Q=class{_status=200;headers={};constructor(e,t){this.response=e,this.body=t}setStatusCode(e){return this._status=e,this}setBody(e){return this.body=e,this}status(){return this._status}statusText(){if(`statusMessage`in this.response)return this.response.statusMessage;if(`statusText`in this.response)return this.response.statusText}setCookie(e,t,n){return this.#e(`Set-Cookie`,`${e}=${t}; ${Object.entries(n||{}).map(([e,t])=>`${e}=${t}`).join(`; `)}`),this}setHeaders(e){for(let[t,n]of Object.entries(e))this.#e(t,n);return this}header(e,t){return this.#e(e,t),this}#e(e,t){this.headers[e]=t,`headers`in this.response?this.response.headers.set(e,t):`setHeader`in this.response&&this.response.setHeader(e,t)}send(e){if(e!==void 0&&(this.body=e),`send`in this.response&&typeof this.response.send==`function`){`statusCode`in this.response&&(this.response.statusCode=this._status);let e=this.response.send(this.body);return e&&`status`in e&&typeof e.status==`function`?e.status(this._status):`status`in this.response&&typeof this.response.status==`function`&&this.response.status(this._status),this.body}return`status`in this.response&&typeof this.response.status!=`function`&&(this.response.status=this._status),this.body}then(e,t){return Promise.resolve(this.send()).then(e,t)}catch(e){return this.then(void 0,e)}finally(e){return this.then(e,e)}},$=class{static preferredCase;static responseStructure;static config;static ctx;instanceConfig;additionalMeta;called={};constructor(){Z()}static setCtx(e){k(e),this.ctx=e}when(e,t){return Ee(e,t)}whenNotNull(e){return De(e)}mergeWhen(e,t){return Oe(e,t)}with(e){if(this.called.with=!0,e===void 0)return this.additionalMeta||{};let t=typeof e==`function`?e(this.getResourceForMeta()):e;return this.additionalMeta=M(this.additionalMeta,t),this.called.json&&this.applyMetaToBody(t,this.resolveCurrentRootKey()),this}withMeta(e){return this.with(e),this}resolveMergedMeta(e){return M(Te(this,e),this.additionalMeta)}runResponse(e){this.called.toResponse=!0,e.ensureJson();let t=e.body(),n=e.createServerResponse(e.rawResponse,t);return this.called.withResponse=!0,e.callWithResponse(n,e.rawResponse),typeof n?.setBody==`function`&&n.setBody(e.body()),n}runThen(e){this.called.then=!0,e.ensureJson();let t=e.body(),n;e.rawResponse===void 0?(this.called.withResponse=!0,e.callWithResponse()):(n=e.createServerResponse(e.rawResponse,t),this.called.withResponse=!0,e.callWithResponse(n,e.rawResponse));let r=e.body();typeof n?.setBody==`function`&&n.setBody(r);let i=Promise.resolve(r).then(e.onfulfilled,e.onrejected);return typeof n?.send==`function`?n.send(r):e.rawResponse!==void 0&&e.sendRawResponse&&e.sendRawResponse(e.rawResponse,r),i}config(e){return e===void 0?this.instanceConfig||{}:(this.instanceConfig={...this.instanceConfig||{},...e,responseStructure:{...this.instanceConfig?.responseStructure||{},...e.responseStructure||{}}},this)}resolveSerializerConfig(e,t){let n=typeof e.config==`function`?e.config():{};return{preferredCase:this.instanceConfig?.preferredCase??n?.preferredCase,responseStructure:{...n?.responseStructure||{},...this.instanceConfig?.responseStructure||{}}}}resolveSerializerCaseStyle(e,t){return this.resolveSerializerConfig(e,t).preferredCase??e.preferredCase??t?.preferredCase??ie()}resolveSerializerResponseStructure(e,t){let n=this.resolveSerializerConfig(e,t),r=b();return{wrap:n.responseStructure?.wrap??e.responseStructure?.wrap??t?.responseStructure?.wrap??r?.wrap??!0,rootKey:n.responseStructure?.rootKey??e.responseStructure?.rootKey??t?.responseStructure?.rootKey??r?.rootKey??`data`,factory:n.responseStructure?.factory??e.responseStructure?.factory??t?.responseStructure?.factory??r?.factory}}},He=class e extends ${body={data:{}};res;resource;collects;withResponseContext;constructor(t,n){if(super(),n&&(e.ctx=n),this.resource=t,n){let e=E(n);e&&w(e),this.res=O(n)}let r=!!this.resource&&typeof this.resource==`object`&&`data`in this.resource,i=r?this.resource.data:void 0,a=!!i&&!Array.isArray(i),o=r?i:this.resource;if(o&&typeof o==`object`&&!Array.isArray(o)&&!P(o)){let e=N(o)?Object.keys(o.toObject()):Object.keys(o);for(let t of e)t in this||Object.defineProperty(this,t,{enumerable:!0,configurable:!0,get:()=>N(o)&&typeof o.getAttribute==`function`?o.getAttribute(t):a?i[t]:this.resource[t],set:e=>{if(N(o)&&typeof o.setAttribute==`function`){o.setAttribute(t,e);return}if(a){i[t]=e;return}this.resource[t]=e}})}}data(){return this.resource}getBody(){return this.json(),this.body}setBody(e){return this.body=e,this}resolveCollectsConfig(){let e=this.collects;if(!e)return;let t=typeof e.config==`function`?e.config():{};return{preferredCase:t.preferredCase??e.preferredCase,responseStructure:{...e.responseStructure||{},...t.responseStructure||{}}}}resolveResponseStructure(){return this.resolveSerializerResponseStructure(this.constructor,this.resolveCollectsConfig())}resolveCurrentRootKey(){return this.resolveResponseStructure().rootKey}applyMetaToBody(e,t){this.body=j(this.body,e,t)}getResourceForMeta(){return this.resource}getPayloadKey(){let{wrap:e,rootKey:t,factory:n}=this.resolveResponseStructure();return n||!e?void 0:t}json(){if(!this.called.json){this.called.json=!0;let t=F(this.data());Array.isArray(t)&&this.collects&&(t=t.map(e=>new this.collects(e).data())),!Array.isArray(t)&&t&&t.data!==void 0&&(t=t.data),t=U(t);let n=B(this.resource),{metaKey:r}=I(),i=r?n[r]:void 0;r&&delete n[r];let a=this.resolveSerializerCaseStyle(this.constructor,this.resolveCollectsConfig());if(a){let e=G(a);t=K(t,e)}let o=this.resolveMergedMeta(e.prototype.with),{wrap:s,rootKey:c,factory:l}=this.resolveResponseStructure();this.body=V({payload:t,meta:i,metaKey:r,wrap:s,rootKey:c,factory:l,context:{type:`generic`,resource:this.resource}}),this.body=j(this.body,{...n,...o||{}},c)}return this}toObject(){this.called.toObject=!0,this.json();let e=F(this.resource);return!Array.isArray(e)&&e&&e.data!==void 0&&(e=e.data),e}toArray(){return this.called.toArray=!0,this.toObject()}additional(e){this.called.additional=!0,this.json();let t=e.data;delete e.data,delete e.pagination;let n=this.getPayloadKey();return t&&n&&this.body[n]!==void 0&&(this.body[n]=Array.isArray(this.body[n])?[...this.body[n],...t]:{...this.body[n],...t}),this.body={...this.body,...e},this}response(t){let n=t??this.res??e.ctx?.res??e.ctx;return this.runResponse({ensureJson:()=>this.json(),rawResponse:n,body:()=>this.body,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)}})}withResponse(e,t){return this}then(t,n){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onfulfilled:t,onrejected:n})}catch(t){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onrejected:t})}finally(t){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onfulfilled:t,onrejected:t})}},Ue=class e extends ${body={data:[]};res;resource;collects;withResponseContext;isPaginatedCollectible(e){if(!e||typeof e!=`object`)return!1;let t=e;return t.pagination&&Array.isArray(t.data)?!0:t.meta&&typeof t.meta==`object`&&`currentPage`in t.meta?Array.isArray(t.data)||P(t.data):!1}constructor(t,n){if(super(),n&&(e.ctx=n),this.resource=t,n){let e=E(n);e&&w(e),this.res=O(n)}}data(){return this.toObject()}getBody(){return this.json(),this.body}setBody(e){return this.body=e,this}resolveCollectsConfig(){let e=this.collects;if(!e)return;let t=typeof e.config==`function`?e.config():{};return{preferredCase:t.preferredCase??e.preferredCase,responseStructure:{...e.responseStructure||{},...t.responseStructure||{}}}}resolveResponseStructure(){return this.resolveSerializerResponseStructure(this.constructor,this.resolveCollectsConfig())}resolveCurrentRootKey(){return this.resolveResponseStructure().rootKey}applyMetaToBody(e,t){this.body=j(this.body,e,t)}getResourceForMeta(){return this.resource}getPayloadKey(){let{wrap:e,rootKey:t,factory:n}=this.resolveResponseStructure();return n||!e?void 0:t}json(){if(!this.called.json){this.called.json=!0;let t=this.data();this.collects&&(t=t.map(e=>new this.collects(e).data())),t=F(t),t=U(t);let n=Array.isArray(this.resource)?{}:B(this.resource),{metaKey:r}=I(),i=r?n[r]:void 0;r&&delete n[r];let a=this.resolveSerializerCaseStyle(this.constructor,this.resolveCollectsConfig());if(a){let e=G(a);t=K(t,e)}let o=this.resolveMergedMeta(e.prototype.with),{wrap:s,rootKey:c,factory:l}=this.resolveResponseStructure();this.body=V({payload:t,meta:i,metaKey:r,wrap:s,rootKey:c,factory:l,context:{type:`collection`,resource:this.resource}}),this.body=j(this.body,{...n,...o||{}},c)}return this}toObject(){return this.called.toObject=!0,this.json(),F(Array.isArray(this.resource)?this.resource:P(this.resource)?this.resource.all():this.resource.data)}toArray(){return this.called.toArray=!0,this.toObject()}additional(e){this.called.additional=!0,this.json(),delete e.cursor,delete e.pagination;let t=this.getPayloadKey();return e.data&&t&&Array.isArray(this.body[t])&&(this.body[t]=[...this.body[t],...e.data]),this.body={...this.body,...e},this}response(t){let n=t??this.res??e.ctx?.res??e.ctx;return this.runResponse({ensureJson:()=>this.json(),rawResponse:n,body:()=>this.body,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)}})}withResponse(e,t){return this}setCollects(e){return this.collects=e,this}then(t,n){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onfulfilled:t,onrejected:n})}catch(t){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onrejected:t})}finally(t){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onfulfilled:t,onrejected:t})}},We=class e extends ${body={data:{}};res;resource;withResponseContext;constructor(t,n){if(super(),n&&(e.ctx=n),this.resource=t,n){let e=E(n);e&&w(e),this.res=O(n)}let r=this.resource.data??this.resource;if(!Array.isArray(r)){let e=N(r)?Object.keys(r.toObject()):Object.keys(r);for(let t of e)t in this||Object.defineProperty(this,t,{enumerable:!0,configurable:!0,get:()=>N(r)&&typeof r.getAttribute==`function`?r.getAttribute(t):this.resource.data?.[t]??this.resource[t],set:e=>{if(N(r)&&typeof r.setAttribute==`function`){r.setAttribute(t,e);return}this.resource.data&&this.resource.data[t]?this.resource.data[t]=e:this.resource[t]=e}})}}static collection(e){return new Ue(e).setCollects(this)}data(){return this.toObject()}getBody(){return this.json(),this.body}setBody(e){return this.body=e,this}resolveResponseStructure(){return this.resolveSerializerResponseStructure(this.constructor)}resolveCurrentRootKey(){return this.resolveResponseStructure().rootKey}applyMetaToBody(e,t){this.body=j(this.body,e,t)}getResourceForMeta(){return this.resource}getPayloadKey(){let{wrap:e,rootKey:t,factory:n}=this.resolveResponseStructure();return n||!e?void 0:t}json(){if(!this.called.json){this.called.json=!0;let t=F(this.data());!Array.isArray(t)&&t&&t.data!==void 0&&(t=t.data),t=U(t);let n=this.resolveSerializerCaseStyle(this.constructor);if(n){let e=G(n);t=K(t,e)}let r=this.resolveMergedMeta(e.prototype.with),{wrap:i,rootKey:a,factory:o}=this.resolveResponseStructure();this.body=V({payload:t,wrap:i,rootKey:a,factory:o,context:{type:`resource`,resource:this.resource}}),this.body=j(this.body,r,a)}return this}toObject(){this.called.toObject=!0,this.json();let e=F(this.resource);return!Array.isArray(e)&&e&&e.data!==void 0&&(e=e.data),e}toArray(){return this.called.toArray=!0,this.toObject()}additional(e){this.called.additional=!0,this.json();let t=this.getPayloadKey();return e.data&&t&&this.body[t]!==void 0&&(this.body[t]=Array.isArray(this.body[t])?[...this.body[t],...e.data]:{...this.body[t],...e.data}),this.body={...this.body,...e},this}response(t){let n=t??this.res??e.ctx?.res??e.ctx;return this.runResponse({ensureJson:()=>this.json(),rawResponse:n,body:()=>this.body,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)}})}withResponse(e,t){return this}then(t,n){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onfulfilled:t,onrejected:n})}catch(t){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onrejected:t})}finally(t){return this.runThen({ensureJson:()=>this.json(),body:()=>this.body,rawResponse:this.res??e.ctx?.res??e.ctx,createServerResponse:(e,t)=>{let n=new Q(e,t);return this.withResponseContext={response:n,raw:e},n},callWithResponse:(e,t)=>{this.withResponse(e,t)},sendRawResponse:(e,t)=>{e.send(t)},onfulfilled:t,onrejected:t})}};exports.ApiResource=ee,exports.CONDITIONAL_ATTRIBUTE_MISSING=H,exports.CliApp=ze,exports.GenericResource=He,exports.InitCommand=Be,exports.MakeResource=Ve,exports.Resource=We,exports.ResourceCollection=Ue,exports.ServerResponse=Q,exports.appendRootProperties=j,exports.applyRuntimeConfig=Fe,exports.buildPaginationExtras=B,exports.buildResponseEnvelope=V,exports.createArkormCurrentPageResolver=Ce,exports.defineConfig=J,exports.extractRequestUrl=E,exports.extractResponseFromCtx=O,exports.getCaseTransformer=G,exports.getDefaultConfig=Ne,exports.getGlobalBaseUrl=me,exports.getGlobalCase=ie,exports.getGlobalCursorMeta=ye,exports.getGlobalPageName=C,exports.getGlobalPaginatedExtras=S,exports.getGlobalPaginatedLinks=fe,exports.getGlobalPaginatedMeta=_e,exports.getGlobalResponseFactory=ue,exports.getGlobalResponseRootKey=ce,exports.getGlobalResponseStructure=b,exports.getGlobalResponseWrap=se,exports.getPaginationExtraKeys=I,exports.getRequestUrl=T,exports.hasPaginationLink=z,exports.isArkormLikeCollection=P,exports.isArkormLikeModel=N,exports.isPlainObject=A,exports.loadRuntimeConfig=Z,exports.mergeMetadata=M,exports.normalizeSerializableData=F,exports.resetRuntimeConfigForTests=Pe,exports.resolveCurrentPage=L,exports.resolveMergeWhen=Oe,exports.resolveWhen=Ee,exports.resolveWhenNotNull=De,exports.resolveWithHookMetadata=Te,exports.sanitizeConditionalAttributes=U,exports.setCtx=k,exports.setGlobalBaseUrl=pe,exports.setGlobalCase=re,exports.setGlobalCursorMeta=ve,exports.setGlobalPageName=he,exports.setGlobalPaginatedExtras=x,exports.setGlobalPaginatedLinks=de,exports.setGlobalPaginatedMeta=ge,exports.setGlobalResponseFactory=le,exports.setGlobalResponseRootKey=ae,exports.setGlobalResponseStructure=y,exports.setGlobalResponseWrap=oe,exports.setRequestUrl=w,exports.splitWords=W,exports.toCamelCase=ke,exports.toKebabCase=Me,exports.toPascalCase=je,exports.toSnakeCase=Ae,exports.transformKeys=K;
+`;
+
+//#endregion
+//#region src/ServerResponse.ts
+/**
+* ServerResponse class to handle HTTP response construction and sending, compatible 
+* with both Express and H3 response objects.
+* 
+* @author Legacy (3m1n3nc3)
+* @since 0.1.0
+*/
+var ServerResponse = class {
+	_status = 200;
+	headers = {};
+	constructor(response, body) {
+		this.response = response;
+		this.body = body;
+	}
+	/**
+	* Set the HTTP status code for the response
+	* 
+	* @param status 
+	* @returns The current ServerResponse instance
+	*/
+	setStatusCode(status) {
+		this._status = status;
+		return this;
+	}
+	/**
+	* Replace the response body that will be dispatched.
+	*
+	* @param body
+	* @returns The current ServerResponse instance
+	*/
+	setBody(body) {
+		this.body = body;
+		return this;
+	}
+	/**
+	* Get the current HTTP status code for the response
+	* 
+	* @returns 
+	*/
+	status() {
+		return this._status;
+	}
+	/**
+	* Get the current HTTP status text for the response
+	* 
+	* @returns 
+	*/
+	statusText() {
+		if ("statusMessage" in this.response) return this.response.statusMessage;
+		else if ("statusText" in this.response) return this.response.statusText;
+	}
+	/**
+	* Set a cookie in the response header
+	* 
+	* @param name The name of the cookie
+	* @param value The value of the cookie
+	* @param options Optional cookie attributes (e.g., path, domain, maxAge)
+	* @returns The current ServerResponse instance
+	*/
+	setCookie(name, value, options) {
+		this.#addHeader("Set-Cookie", `${name}=${value}; ${Object.entries(options || {}).map(([key, val]) => `${key}=${val}`).join("; ")}`);
+		return this;
+	}
+	/**
+	* Convert the resource to a JSON response body
+	* 
+	* @param headers Optional headers to add to the response
+	* @returns The current ServerResponse instance
+	*/
+	setHeaders(headers) {
+		for (const [key, value] of Object.entries(headers)) this.#addHeader(key, value);
+		return this;
+	}
+	/**
+	* Add a single header to the response
+	* 
+	* @param key The name of the header
+	* @param value The value of the header
+	* @returns The current ServerResponse instance
+	*/
+	header(key, value) {
+		this.#addHeader(key, value);
+		return this;
+	}
+	/**
+	* Add a single header to the response
+	* 
+	* @param key The name of the header
+	* @param value The value of the header
+	*/
+	#addHeader(key, value) {
+		this.headers[key] = value;
+		if ("headers" in this.response) this.response.headers.set(key, value);
+		else if ("setHeader" in this.response) this.response.setHeader(key, value);
+	}
+	/**
+	* Dispatch the current body and apply any deferred transport state.
+	*
+	* @param body Optional body override
+	* @returns The dispatched response body
+	*/
+	send(body) {
+		if (typeof body !== "undefined") this.body = body;
+		if ("send" in this.response && typeof this.response.send === "function") {
+			if ("statusCode" in this.response) this.response.statusCode = this._status;
+			const sentResponse = this.response.send(this.body);
+			if (sentResponse && "status" in sentResponse && typeof sentResponse.status === "function") sentResponse.status(this._status);
+			else if ("status" in this.response && typeof this.response.status === "function") this.response.status(this._status);
+			return this.body;
+		}
+		if ("status" in this.response && typeof this.response.status !== "function") this.response.status = this._status;
+		return this.body;
+	}
+	/**
+	* Promise-like then method to allow chaining with async/await or .then() syntax
+	* 
+	* @param onfulfilled  Callback to handle the fulfilled state of the promise, receiving the response body
+	* @param onrejected  Callback to handle the rejected state of the promise, receiving the error reason
+	* @returns A promise that resolves to the result of the onfulfilled or onrejected callback 
+	*/
+	then(onfulfilled, onrejected) {
+		return Promise.resolve(this.send()).then(onfulfilled, onrejected);
+	}
+	/**
+	* Promise-like catch method to handle rejected state of the promise
+	* 
+	* @param onrejected 
+	* @returns 
+	*/
+	catch(onrejected) {
+		return this.then(void 0, onrejected);
+	}
+	/**
+	* Promise-like finally method to handle cleanup after promise is settled
+	* 
+	* @param onfinally 
+	* @returns 
+	*/
+	finally(onfinally) {
+		return this.then(onfinally, onfinally);
+	}
+};
+
+//#endregion
+//#region src/BaseSerializer.ts
+/**
+* @description BaseSerializer is an abstract class that provides common functionality for
+* serializing resources. It handles configuration, metadata management, and response 
+* structure resolution. Concrete serializers should extend this class and implement 
+* the abstract methods to define how resources are transformed and how metadata is 
+* applied to the response body.
+* 
+* @author Legacy (3m1n3nc3)
+* @since 0.2.8
+*/
+var BaseSerializer = class {
+	static preferredCase;
+	static responseStructure;
+	static config;
+	static ctx;
+	instanceConfig;
+	additionalMeta;
+	called = {};
+	constructor() {
+		loadRuntimeConfig();
+	}
+	/**
+	* Sets the current request context for pagination URL detection.
+	* Call from middleware to make the request path available to all
+	* resources created during the request lifecycle.
+	* 
+	* Accepts an Express Request, H3Event, `{ req }` object, or a plain URL string.
+	* 
+	* @param ctx The request context.
+	*/
+	static setCtx(ctx) {
+		setCtx(ctx);
+		this.ctx = ctx;
+	}
+	/**
+	* Helper method to conditionally resolve a value based on a condition. 
+	* 
+	* @param condition 
+	* @param value 
+	* @returns 
+	*/
+	when(condition, value) {
+		return resolveWhen(condition, value);
+	}
+	/**
+	* Helper method to conditionally resolve a value only if it's not null or undefined.
+	* 
+	* @param value 
+	* @returns 
+	*/
+	whenNotNull(value) {
+		return resolveWhenNotNull(value);
+	}
+	/**
+	* Helper method to conditionally merge values into the response based on a condition.
+	* 
+	* @param condition 
+	* @param value 
+	* @returns 
+	*/
+	mergeWhen(condition, value) {
+		return resolveMergeWhen(condition, value);
+	}
+	/**
+	* Add additional metadata to the response. If called without arguments.
+	* 
+	* @param meta 
+	* @returns 
+	*/
+	with(meta) {
+		this.called.with = true;
+		if (typeof meta === "undefined") return this.additionalMeta || {};
+		const resolvedMeta = typeof meta === "function" ? meta(this.getResourceForMeta()) : meta;
+		this.additionalMeta = mergeMetadata(this.additionalMeta, resolvedMeta);
+		if (this.called.json) this.applyMetaToBody(resolvedMeta, this.resolveCurrentRootKey());
+		return this;
+	}
+	/**
+	* Add additional metadata to the response, ensuring it is merged with any existing metadata.
+	* 
+	* @param meta 
+	* @returns 
+	*/
+	withMeta(meta) {
+		this.with(meta);
+		return this;
+	}
+	/**
+	* Resolve the merged metadata for the current response, combining any metadata 
+	* defined in hooks with additional metadata added via with() or withMeta().
+	* 
+	* @param withMethod 
+	* @returns 
+	*/
+	resolveMergedMeta(withMethod) {
+		return mergeMetadata(resolveWithHookMetadata(this, withMethod), this.additionalMeta);
+	}
+	/**
+	* Run the response generation process, ensuring that the response is properly structured.
+	* 
+	* @param input 
+	* @returns 
+	*/
+	runResponse(input) {
+		this.called.toResponse = true;
+		input.ensureJson();
+		const resolvedBody = input.body();
+		const response = input.createServerResponse(input.rawResponse, resolvedBody);
+		this.called.withResponse = true;
+		input.callWithResponse(response, input.rawResponse);
+		if (typeof response?.setBody === "function") response.setBody(input.body());
+		return response;
+	}
+	/**
+	* Run the thenable process for the resource, allowing for async handling and 
+	* response generation.
+	* 
+	* @param input 
+	* @returns 
+	*/
+	runThen(input) {
+		this.called.then = true;
+		input.ensureJson();
+		const initialBody = input.body();
+		let response;
+		if (typeof input.rawResponse !== "undefined") {
+			response = input.createServerResponse(input.rawResponse, initialBody);
+			this.called.withResponse = true;
+			input.callWithResponse(response, input.rawResponse);
+		} else {
+			this.called.withResponse = true;
+			input.callWithResponse();
+		}
+		const resolvedBody = input.body();
+		if (typeof response?.setBody === "function") response.setBody(resolvedBody);
+		const resolved = Promise.resolve(resolvedBody).then(input.onfulfilled, input.onrejected);
+		if (typeof response?.send === "function") response.send(resolvedBody);
+		else if (typeof input.rawResponse !== "undefined" && input.sendRawResponse) input.sendRawResponse(input.rawResponse, resolvedBody);
+		return resolved;
+	}
+	/**
+	* Get or set the resource-level configuration for this serializer instance.
+	* 
+	* @param config The configuration object to set for this serializer instance, or undefined to get the current configuration.
+	* @returns 
+	*/
+	config(config) {
+		if (typeof config === "undefined") return this.instanceConfig || {};
+		this.instanceConfig = {
+			...this.instanceConfig || {},
+			...config,
+			responseStructure: {
+				...this.instanceConfig?.responseStructure || {},
+				...config.responseStructure || {}
+			}
+		};
+		return this;
+	}
+	/**
+	* Resolve the effective serializer configuration for this instance, combining 
+	* class-level and instance-level configurations.
+	* 
+	* @param localConstructor 
+	* @param _fallbackConfig 
+	* @returns 
+	*/
+	resolveSerializerConfig(localConstructor, _fallbackConfig) {
+		const classConfig = typeof localConstructor.config === "function" ? localConstructor.config() : {};
+		return {
+			preferredCase: this.instanceConfig?.preferredCase ?? classConfig?.preferredCase,
+			responseStructure: {
+				...classConfig?.responseStructure || {},
+				...this.instanceConfig?.responseStructure || {}
+			}
+		};
+	}
+	/**
+	* Resolve the preferred case style for this serializer instance, considering 
+	* instance-level configuration, class-level configuration, and global defaults.
+	* 
+	* @param localConstructor The constructor of the serializer class.
+	* @param fallbackConfig    The fallback configuration to use if no other configuration is found.
+	* @returns The resolved    case style for this serializer instance.
+	*/
+	resolveSerializerCaseStyle(localConstructor, fallbackConfig) {
+		return this.resolveSerializerConfig(localConstructor, fallbackConfig).preferredCase ?? localConstructor.preferredCase ?? fallbackConfig?.preferredCase ?? getGlobalCase();
+	}
+	/**
+	* Resolve the response structure configuration for this serializer instance, considering
+	* 
+	* @param localConstructor 
+	* @param fallbackConfig 
+	* @returns 
+	*/
+	resolveSerializerResponseStructure(localConstructor, fallbackConfig) {
+		const localConfig = this.resolveSerializerConfig(localConstructor, fallbackConfig);
+		const global = getGlobalResponseStructure();
+		return {
+			wrap: localConfig.responseStructure?.wrap ?? localConstructor.responseStructure?.wrap ?? fallbackConfig?.responseStructure?.wrap ?? global?.wrap ?? true,
+			rootKey: localConfig.responseStructure?.rootKey ?? localConstructor.responseStructure?.rootKey ?? fallbackConfig?.responseStructure?.rootKey ?? global?.rootKey ?? "data",
+			factory: localConfig.responseStructure?.factory ?? localConstructor.responseStructure?.factory ?? fallbackConfig?.responseStructure?.factory ?? global?.factory
+		};
+	}
+};
+
+//#endregion
+//#region src/GenericResource.ts
+/**
+* GenericResource class to handle API resource transformation and response building
+* 
+* @author Legacy (3m1n3nc3)
+* @since 0.1.0
+* @see BaseSerializer for shared serialization logic and configuration handling
+*/
+var GenericResource = class GenericResource extends BaseSerializer {
+	body = { data: {} };
+	res;
+	resource;
+	collects;
+	withResponseContext;
+	constructor(rsc, ctx) {
+		super();
+		if (ctx) GenericResource.ctx = ctx;
+		this.resource = rsc;
+		if (ctx) {
+			const url = extractRequestUrl(ctx);
+			if (url) setRequestUrl(url);
+			this.res = extractResponseFromCtx(ctx);
+		}
+		const hasDataPayload = !!this.resource && typeof this.resource === "object" && "data" in this.resource;
+		const dataPayload = hasDataPayload ? this.resource.data : void 0;
+		const hasObjectDataPayload = !!dataPayload && !Array.isArray(dataPayload);
+		const source = hasDataPayload ? dataPayload : this.resource;
+		/**
+		* Copy properties from rsc to this instance for easy 
+		* access, but only if data is not an array
+		*/
+		if (source && typeof source === "object" && !Array.isArray(source) && !isArkormLikeCollection(source)) {
+			const sourceKeys = isArkormLikeModel(source) ? Object.keys(source.toObject()) : Object.keys(source);
+			for (const key of sourceKeys) if (!(key in this)) Object.defineProperty(this, key, {
+				enumerable: true,
+				configurable: true,
+				get: () => {
+					if (isArkormLikeModel(source) && typeof source.getAttribute === "function") return source.getAttribute(key);
+					if (hasObjectDataPayload) return dataPayload[key];
+					return this.resource[key];
+				},
+				set: (value) => {
+					if (isArkormLikeModel(source) && typeof source.setAttribute === "function") {
+						source.setAttribute(key, value);
+						return;
+					}
+					if (hasObjectDataPayload) {
+						dataPayload[key] = value;
+						return;
+					}
+					this.resource[key] = value;
+				}
+			});
+		}
+	}
+	/**
+	* Get the original resource data
+	*/
+	data() {
+		return this.resource;
+	}
+	/**
+	* Get the current serialized output body.
+	*/
+	getBody() {
+		this.json();
+		return this.body;
+	}
+	/**
+	* Replace the current serialized output body.
+	*/
+	setBody(body) {
+		this.body = body;
+		return this;
+	}
+	resolveCollectsConfig() {
+		const collectedResource = this.collects;
+		if (!collectedResource) return;
+		const collectedConfig = typeof collectedResource.config === "function" ? collectedResource.config() : {};
+		return {
+			preferredCase: collectedConfig.preferredCase ?? collectedResource.preferredCase,
+			responseStructure: {
+				...collectedResource.responseStructure || {},
+				...collectedConfig.responseStructure || {}
+			}
+		};
+	}
+	resolveResponseStructure() {
+		return this.resolveSerializerResponseStructure(this.constructor, this.resolveCollectsConfig());
+	}
+	/**
+	* Resolve the current root key for the response structure, based on configuration and defaults.
+	* 
+	* @returns 
+	*/
+	resolveCurrentRootKey() {
+		return this.resolveResponseStructure().rootKey;
+	}
+	/**
+	* Apply metadata properties to the response body, ensuring they are merged with.
+	* 
+	* @param meta 
+	* @param rootKey 
+	*/
+	applyMetaToBody(meta, rootKey) {
+		this.body = appendRootProperties(this.body, meta, rootKey);
+	}
+	/**
+	* Get the resource data to be used for generating metadata.
+	* 
+	* @returns 
+	*/
+	getResourceForMeta() {
+		return this.resource;
+	}
+	getPayloadKey() {
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		return factory || !wrap ? void 0 : rootKey;
+	}
+	/**
+	* Convert resource to JSON response format
+	* 
+	* @returns 
+	*/
+	json() {
+		if (!this.called.json) {
+			this.called.json = true;
+			let data = normalizeSerializableData(this.data());
+			if (Array.isArray(data) && this.collects) data = data.map((item) => new this.collects(item).data());
+			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
+			data = sanitizeConditionalAttributes(data);
+			const paginationExtras = buildPaginationExtras(this.resource);
+			const { metaKey } = getPaginationExtraKeys();
+			const configuredMeta = metaKey ? paginationExtras[metaKey] : void 0;
+			if (metaKey) delete paginationExtras[metaKey];
+			const caseStyle = this.resolveSerializerCaseStyle(this.constructor, this.resolveCollectsConfig());
+			if (caseStyle) {
+				const transformer = getCaseTransformer(caseStyle);
+				data = transformKeys(data, transformer);
+			}
+			const customMeta = this.resolveMergedMeta(GenericResource.prototype.with);
+			const { wrap, rootKey, factory } = this.resolveResponseStructure();
+			this.body = buildResponseEnvelope({
+				payload: data,
+				meta: configuredMeta,
+				metaKey,
+				wrap,
+				rootKey,
+				factory,
+				context: {
+					type: "generic",
+					resource: this.resource
+				}
+			});
+			this.body = appendRootProperties(this.body, {
+				...paginationExtras,
+				...customMeta || {}
+			}, rootKey);
+		}
+		return this;
+	}
+	/**
+	* Convert resource to object format (for collections).
+	*
+	* @returns
+	*/
+	toObject() {
+		this.called.toObject = true;
+		this.json();
+		let data = normalizeSerializableData(this.resource);
+		if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
+		return data;
+	}
+	/**
+	* Convert resource to object format and return original data.
+	* 
+	* @deprecated Use toObject() instead.
+	* @alias toArray
+	* @since 0.2.9
+	*/
+	toArray() {
+		this.called.toArray = true;
+		return this.toObject();
+	}
+	/**
+	* Add additional properties to the response body
+	* 
+	* @param extra  Additional properties to merge into the response body
+	* @returns 
+	*/
+	additional(extra) {
+		this.called.additional = true;
+		this.json();
+		const extraData = extra.data;
+		delete extra.data;
+		delete extra.pagination;
+		const payloadKey = this.getPayloadKey();
+		if (extraData && payloadKey && typeof this.body[payloadKey] !== "undefined") this.body[payloadKey] = Array.isArray(this.body[payloadKey]) ? [...this.body[payloadKey], ...extraData] : {
+			...this.body[payloadKey],
+			...extraData
+		};
+		this.body = {
+			...this.body,
+			...extra
+		};
+		return this;
+	}
+	/**
+	* Build a response object, writing to the provided raw response if possible.
+	* 
+	* @param res 
+	* @returns 
+	*/
+	response(res) {
+		const rawResponse = res ?? this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx;
+		return this.runResponse({
+			ensureJson: () => this.json(),
+			rawResponse,
+			body: () => this.body,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			}
+		});
+	}
+	/**
+	* Customize the outgoing transport response right before dispatch.
+	*
+	* Override in custom classes to mutate headers/status/body.
+	*/
+	withResponse(_response, _rawResponse) {
+		return this;
+	}
+	/**
+	* Promise-like then method to allow chaining with async/await or .then() syntax
+	* 
+	* @param onfulfilled  Callback to handle the fulfilled state of the promise, receiving the response body
+	* @param onrejected  Callback to handle the rejected state of the promise, receiving the error reason
+	* @returns A promise that resolves to the result of the onfulfilled or onrejected callback 
+	*/
+	then(onfulfilled, onrejected) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onfulfilled,
+			onrejected
+		});
+	}
+	/**
+	* Promise-like catch method to handle rejected state of the promise
+	*
+	* @param onrejected
+	* @returns
+	*/
+	catch(onrejected) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onrejected
+		});
+	}
+	/**
+	* Promise-like finally method to handle cleanup after promise is settled
+	*
+	* @param onfinally
+	* @returns
+	*/
+	finally(onfinally) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onfulfilled: onfinally,
+			onrejected: onfinally
+		});
+	}
+};
+
+//#endregion
+//#region src/ResourceCollection.ts
+/**
+* ResourceCollection class to handle API resource transformation and response building 
+* for collections
+* 
+* @author Legacy (3m1n3nc3)
+* @since 0.1.0
+* @see BaseSerializer for shared serialization logic and configuration handling
+*/
+var ResourceCollection = class ResourceCollection extends BaseSerializer {
+	body = { data: [] };
+	res;
+	resource;
+	collects;
+	withResponseContext;
+	/**
+	* Type guard to determine if the provided value is a Collectible with pagination information.
+	* 
+	* @param value The value to check.
+	* @returns     True if the value is a Collectible with pagination information, false otherwise.
+	*/
+	isPaginatedCollectible(value) {
+		if (!value || typeof value !== "object") return false;
+		const resource = value;
+		if (resource.pagination && Array.isArray(resource.data)) return true;
+		if (!(!!resource.meta && typeof resource.meta === "object" && "currentPage" in resource.meta)) return false;
+		return Array.isArray(resource.data) || isArkormLikeCollection(resource.data);
+	}
+	constructor(rsc, ctx) {
+		super();
+		if (ctx) ResourceCollection.ctx = ctx;
+		this.resource = rsc;
+		if (ctx) {
+			const url = extractRequestUrl(ctx);
+			if (url) setRequestUrl(url);
+			this.res = extractResponseFromCtx(ctx);
+		}
+	}
+	/**
+	* Get the original resource data
+	*/
+	data() {
+		return this.toObject();
+	}
+	/**
+	* Get the current serialized output body.
+	*/
+	getBody() {
+		this.json();
+		return this.body;
+	}
+	/**
+	* Replace the current serialized output body.
+	*/
+	setBody(body) {
+		this.body = body;
+		return this;
+	}
+	resolveCollectsConfig() {
+		const collectedResource = this.collects;
+		if (!collectedResource) return;
+		const collectedConfig = typeof collectedResource.config === "function" ? collectedResource.config() : {};
+		return {
+			preferredCase: collectedConfig.preferredCase ?? collectedResource.preferredCase,
+			responseStructure: {
+				...collectedResource.responseStructure || {},
+				...collectedConfig.responseStructure || {}
+			}
+		};
+	}
+	resolveResponseStructure() {
+		return this.resolveSerializerResponseStructure(this.constructor, this.resolveCollectsConfig());
+	}
+	/**
+	* Resolve the current root key for the response structure, based on configuration and defaults.
+	* 
+	* @returns 
+	*/
+	resolveCurrentRootKey() {
+		return this.resolveResponseStructure().rootKey;
+	}
+	/**
+	* Apply metadata properties to the response body, ensuring they are merged with 
+	* any existing properties and respecting the configured root key.
+	* 
+	* @param meta 
+	* @param rootKey 
+	*/
+	applyMetaToBody(meta, rootKey) {
+		this.body = appendRootProperties(this.body, meta, rootKey);
+	}
+	/**
+	* Get the resource data to be used for generating metadata, allowing for 
+	* customization in subclasses.
+	* 
+	* @returns 
+	*/
+	getResourceForMeta() {
+		return this.resource;
+	}
+	/**
+	* Get the appropriate key for the response payload based on the current response 
+	* structure configuration.
+	* 
+	* @returns The key to use for the response payload, or undefined if no key is needed.
+	*/
+	getPayloadKey() {
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		return factory || !wrap ? void 0 : rootKey;
+	}
+	/**
+	* Convert resource to JSON response format
+	* 
+	* @returns 
+	*/
+	json() {
+		if (!this.called.json) {
+			this.called.json = true;
+			let data = this.data();
+			if (this.collects) data = data.map((item) => new this.collects(item).data());
+			data = normalizeSerializableData(data);
+			data = sanitizeConditionalAttributes(data);
+			const paginationExtras = !Array.isArray(this.resource) ? buildPaginationExtras(this.resource) : {};
+			const { metaKey } = getPaginationExtraKeys();
+			const configuredMeta = metaKey ? paginationExtras[metaKey] : void 0;
+			if (metaKey) delete paginationExtras[metaKey];
+			const caseStyle = this.resolveSerializerCaseStyle(this.constructor, this.resolveCollectsConfig());
+			if (caseStyle) {
+				const transformer = getCaseTransformer(caseStyle);
+				data = transformKeys(data, transformer);
+			}
+			const customMeta = this.resolveMergedMeta(ResourceCollection.prototype.with);
+			const { wrap, rootKey, factory } = this.resolveResponseStructure();
+			this.body = buildResponseEnvelope({
+				payload: data,
+				meta: configuredMeta,
+				metaKey,
+				wrap,
+				rootKey,
+				factory,
+				context: {
+					type: "collection",
+					resource: this.resource
+				}
+			});
+			this.body = appendRootProperties(this.body, {
+				...paginationExtras,
+				...customMeta || {}
+			}, rootKey);
+		}
+		return this;
+	}
+	/**
+	* Convert resource to object format and return original data.
+	*
+	* @returns
+	*/
+	toObject() {
+		this.called.toObject = true;
+		this.json();
+		return normalizeSerializableData(Array.isArray(this.resource) ? this.resource : isArkormLikeCollection(this.resource) ? this.resource.all() : this.resource.data);
+	}
+	/**
+	* Convert resource to object format and return original data.
+	* 
+	* @deprecated Use toObject() instead.
+	* @alias toArray
+	* @since 0.2.9
+	*/
+	toArray() {
+		this.called.toArray = true;
+		return this.toObject();
+	}
+	/**
+	* Add additional properties to the response body
+	* 
+	* @param extra  Additional properties to merge into the response body
+	* @returns 
+	*/
+	additional(extra) {
+		this.called.additional = true;
+		this.json();
+		delete extra.cursor;
+		delete extra.pagination;
+		const payloadKey = this.getPayloadKey();
+		if (extra.data && payloadKey && Array.isArray(this.body[payloadKey])) this.body[payloadKey] = [...this.body[payloadKey], ...extra.data];
+		this.body = {
+			...this.body,
+			...extra
+		};
+		return this;
+	}
+	/**
+	* Build a response object, optionally accepting a raw response to mutate in withResponse.
+	* 
+	* @param res Optional raw response object (e.g. Express Response or H3Event res)
+	* @returns 
+	*/
+	response(res) {
+		const rawResponse = res ?? this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx;
+		return this.runResponse({
+			ensureJson: () => this.json(),
+			rawResponse,
+			body: () => this.body,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			}
+		});
+	}
+	/**
+	* Customize the outgoing transport response right before dispatch.
+	*
+	* Override in custom classes to mutate headers/status/body.
+	*/
+	withResponse(_response, _rawResponse) {
+		return this;
+	}
+	setCollects(collects) {
+		this.collects = collects;
+		return this;
+	}
+	/**
+	* Promise-like then method to allow chaining with async/await or .then() syntax
+	* 
+	* @param onfulfilled  Callback to handle the fulfilled state of the promise, receiving the response body
+	* @param onrejected  Callback to handle the rejected state of the promise, receiving the error reason
+	* @returns A promise that resolves to the result of the onfulfilled or onrejected callback 
+	*/
+	then(onfulfilled, onrejected) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onfulfilled,
+			onrejected
+		});
+	}
+	/**
+	* Promise-like catch method to handle rejected state of the promise
+	* 
+	* @param onrejected 
+	* @returns 
+	*/
+	catch(onrejected) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onrejected
+		});
+	}
+	/**
+	* Promise-like finally method to handle cleanup after promise is settled
+	* 
+	* @param onfinally 
+	* @returns 
+	*/
+	finally(onfinally) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onfulfilled: onfinally,
+			onrejected: onfinally
+		});
+	}
+};
+
+//#endregion
+//#region src/Resource.ts
+/**
+* Resource class to handle API resource transformation and response building
+* 
+* 
+* @author Legacy (3m1n3nc3)
+* @since 0.1.0
+* @see BaseSerializer for shared serialization logic and configuration handling
+*/
+var Resource = class Resource extends BaseSerializer {
+	body = { data: {} };
+	res;
+	resource;
+	withResponseContext;
+	constructor(rsc, ctx) {
+		super();
+		if (ctx) Resource.ctx = ctx;
+		this.resource = rsc;
+		if (ctx) {
+			const url = extractRequestUrl(ctx);
+			if (url) setRequestUrl(url);
+			this.res = extractResponseFromCtx(ctx);
+		}
+		const source = this.resource.data ?? this.resource;
+		/**
+		* Copy properties from rsc to this instance for easy 
+		* access, but only if data is not an array
+		*/
+		if (!Array.isArray(source)) {
+			const sourceKeys = isArkormLikeModel(source) ? Object.keys(source.toObject()) : Object.keys(source);
+			for (const key of sourceKeys) if (!(key in this)) Object.defineProperty(this, key, {
+				enumerable: true,
+				configurable: true,
+				get: () => {
+					if (isArkormLikeModel(source) && typeof source.getAttribute === "function") return source.getAttribute(key);
+					return this.resource.data?.[key] ?? this.resource[key];
+				},
+				set: (value) => {
+					if (isArkormLikeModel(source) && typeof source.setAttribute === "function") {
+						source.setAttribute(key, value);
+						return;
+					}
+					if (this.resource.data && this.resource.data[key]) this.resource.data[key] = value;
+					else this.resource[key] = value;
+				}
+			});
+		}
+	}
+	/**
+	* Create a ResourceCollection from an array of resource data or a Collectible instance
+	* 
+	* @param data 
+	* @returns 
+	*/
+	static collection(data) {
+		return new ResourceCollection(data).setCollects(this);
+	}
+	/**
+	* Get the original resource data
+	*/
+	data() {
+		return this.toObject();
+	}
+	/**
+	* Get the current serialized output body.
+	*/
+	getBody() {
+		this.json();
+		return this.body;
+	}
+	/**
+	* Replace the current serialized output body.
+	*/
+	setBody(body) {
+		this.body = body;
+		return this;
+	}
+	resolveResponseStructure() {
+		return this.resolveSerializerResponseStructure(this.constructor);
+	}
+	/**
+	* Resolve the current root key for the response body based on configuration and defaults.
+	* 
+	* @returns 
+	*/
+	resolveCurrentRootKey() {
+		return this.resolveResponseStructure().rootKey;
+	}
+	applyMetaToBody(meta, rootKey) {
+		this.body = appendRootProperties(this.body, meta, rootKey);
+	}
+	getResourceForMeta() {
+		return this.resource;
+	}
+	getPayloadKey() {
+		const { wrap, rootKey, factory } = this.resolveResponseStructure();
+		return factory || !wrap ? void 0 : rootKey;
+	}
+	/**
+	* Convert resource to JSON response format
+	* 
+	* @returns 
+	*/
+	json() {
+		if (!this.called.json) {
+			this.called.json = true;
+			let data = normalizeSerializableData(this.data());
+			if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
+			data = sanitizeConditionalAttributes(data);
+			const caseStyle = this.resolveSerializerCaseStyle(this.constructor);
+			if (caseStyle) {
+				const transformer = getCaseTransformer(caseStyle);
+				data = transformKeys(data, transformer);
+			}
+			const customMeta = this.resolveMergedMeta(Resource.prototype.with);
+			const { wrap, rootKey, factory } = this.resolveResponseStructure();
+			this.body = buildResponseEnvelope({
+				payload: data,
+				wrap,
+				rootKey,
+				factory,
+				context: {
+					type: "resource",
+					resource: this.resource
+				}
+			});
+			this.body = appendRootProperties(this.body, customMeta, rootKey);
+		}
+		return this;
+	}
+	/**
+	* Convert resource to object format (for collections) or return original data for single resources.
+	*
+	* @returns
+	*/
+	toObject() {
+		this.called.toObject = true;
+		this.json();
+		let data = normalizeSerializableData(this.resource);
+		if (!Array.isArray(data) && data && typeof data.data !== "undefined") data = data.data;
+		return data;
+	}
+	/**
+	* Convert resource to object format and return original data.
+	* 
+	* @deprecated Use toObject() instead.
+	* @alias toArray
+	* @since 0.2.9
+	*/
+	toArray() {
+		this.called.toArray = true;
+		return this.toObject();
+	}
+	/**
+	* Add additional properties to the response body
+	* 
+	* @param extra  Additional properties to merge into the response body
+	* @returns 
+	*/
+	additional(extra) {
+		this.called.additional = true;
+		this.json();
+		const payloadKey = this.getPayloadKey();
+		if (extra.data && payloadKey && typeof this.body[payloadKey] !== "undefined") this.body[payloadKey] = Array.isArray(this.body[payloadKey]) ? [...this.body[payloadKey], ...extra.data] : {
+			...this.body[payloadKey],
+			...extra.data
+		};
+		this.body = {
+			...this.body,
+			...extra
+		};
+		return this;
+	}
+	/**
+	* Build a response object, optionally accepting a raw response to mutate in withResponse.
+	* 
+	* @param res Optional raw response object (e.g. Express Response or H3Event res)
+	* @returns 
+	*/
+	response(res) {
+		const rawResponse = res ?? this.res ?? Resource.ctx?.res ?? Resource.ctx;
+		return this.runResponse({
+			ensureJson: () => this.json(),
+			rawResponse,
+			body: () => this.body,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			}
+		});
+	}
+	/**
+	* Customize the outgoing transport response right before dispatch.
+	*
+	* Override in custom classes to mutate headers/status/body.
+	*/
+	withResponse(_response, _rawResponse) {
+		return this;
+	}
+	/**
+	* Promise-like then method to allow chaining with async/await or .then() syntax
+	* 
+	* @param onfulfilled  Callback to handle the fulfilled state of the promise, receiving the response body
+	* @param onrejected  Callback to handle the rejected state of the promise, receiving the error reason
+	* @returns A promise that resolves to the result of the onfulfilled or onrejected callback 
+	*/
+	then(onfulfilled, onrejected) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? Resource.ctx?.res ?? Resource.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onfulfilled,
+			onrejected
+		});
+	}
+	/**
+	* Promise-like catch method to handle rejected state of the promise
+	* 
+	* @param onrejected 
+	* @returns 
+	*/
+	catch(onrejected) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? Resource.ctx?.res ?? Resource.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onrejected
+		});
+	}
+	/**
+	* Promise-like finally method to handle cleanup after promise is settled
+	* 
+	* @param onfinally 
+	* @returns 
+	*/
+	finally(onfinally) {
+		return this.runThen({
+			ensureJson: () => this.json(),
+			body: () => this.body,
+			rawResponse: this.res ?? Resource.ctx?.res ?? Resource.ctx,
+			createServerResponse: (raw, body) => {
+				const response = new ServerResponse(raw, body);
+				this.withResponseContext = {
+					response,
+					raw
+				};
+				return response;
+			},
+			callWithResponse: (response, raw) => {
+				this.withResponse(response, raw);
+			},
+			sendRawResponse: (raw, body) => {
+				raw.send(body);
+			},
+			onfulfilled: onfinally,
+			onrejected: onfinally
+		});
+	}
+};
+
+//#endregion
+exports.ApiResource = ApiResource;
+exports.CONDITIONAL_ATTRIBUTE_MISSING = CONDITIONAL_ATTRIBUTE_MISSING;
+exports.CliApp = CliApp;
+exports.GenericResource = GenericResource;
+exports.InitCommand = InitCommand;
+exports.MakeResource = MakeResource;
+exports.Resource = Resource;
+exports.ResourceCollection = ResourceCollection;
+exports.ServerResponse = ServerResponse;
+exports.appendRootProperties = appendRootProperties;
+exports.applyRuntimeConfig = applyRuntimeConfig;
+exports.buildPaginationExtras = buildPaginationExtras;
+exports.buildResponseEnvelope = buildResponseEnvelope;
+exports.createArkormCurrentPageResolver = createArkormCurrentPageResolver;
+exports.defineConfig = defineConfig;
+exports.extractRequestUrl = extractRequestUrl;
+exports.extractResponseFromCtx = extractResponseFromCtx;
+exports.getCaseTransformer = getCaseTransformer;
+exports.getDefaultConfig = getDefaultConfig;
+exports.getGlobalBaseUrl = getGlobalBaseUrl;
+exports.getGlobalCase = getGlobalCase;
+exports.getGlobalCursorMeta = getGlobalCursorMeta;
+exports.getGlobalPageName = getGlobalPageName;
+exports.getGlobalPaginatedExtras = getGlobalPaginatedExtras;
+exports.getGlobalPaginatedLinks = getGlobalPaginatedLinks;
+exports.getGlobalPaginatedMeta = getGlobalPaginatedMeta;
+exports.getGlobalResponseFactory = getGlobalResponseFactory;
+exports.getGlobalResponseRootKey = getGlobalResponseRootKey;
+exports.getGlobalResponseStructure = getGlobalResponseStructure;
+exports.getGlobalResponseWrap = getGlobalResponseWrap;
+exports.getPaginationExtraKeys = getPaginationExtraKeys;
+exports.getRequestUrl = getRequestUrl;
+exports.hasPaginationLink = hasPaginationLink;
+exports.isArkormLikeCollection = isArkormLikeCollection;
+exports.isArkormLikeModel = isArkormLikeModel;
+exports.isPlainObject = isPlainObject;
+exports.loadRuntimeConfig = loadRuntimeConfig;
+exports.mergeMetadata = mergeMetadata;
+exports.normalizeSerializableData = normalizeSerializableData;
+exports.resetRuntimeConfigForTests = resetRuntimeConfigForTests;
+exports.resolveCurrentPage = resolveCurrentPage;
+exports.resolveMergeWhen = resolveMergeWhen;
+exports.resolveWhen = resolveWhen;
+exports.resolveWhenNotNull = resolveWhenNotNull;
+exports.resolveWithHookMetadata = resolveWithHookMetadata;
+exports.sanitizeConditionalAttributes = sanitizeConditionalAttributes;
+exports.setCtx = setCtx;
+exports.setGlobalBaseUrl = setGlobalBaseUrl;
+exports.setGlobalCase = setGlobalCase;
+exports.setGlobalCursorMeta = setGlobalCursorMeta;
+exports.setGlobalPageName = setGlobalPageName;
+exports.setGlobalPaginatedExtras = setGlobalPaginatedExtras;
+exports.setGlobalPaginatedLinks = setGlobalPaginatedLinks;
+exports.setGlobalPaginatedMeta = setGlobalPaginatedMeta;
+exports.setGlobalResponseFactory = setGlobalResponseFactory;
+exports.setGlobalResponseRootKey = setGlobalResponseRootKey;
+exports.setGlobalResponseStructure = setGlobalResponseStructure;
+exports.setGlobalResponseWrap = setGlobalResponseWrap;
+exports.setRequestUrl = setRequestUrl;
+exports.splitWords = splitWords;
+exports.toCamelCase = toCamelCase;
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = toPascalCase;
+exports.toSnakeCase = toSnakeCase;
+exports.transformKeys = transformKeys;