resora 0.2.18 → 1.0.0

package/README.md

@@ -174,6 +174,23 @@ It works with:
 
 Adapters can be added without changing application logic.
 
+## Plugin System
+
+Resora exposes a first-class plugin registry for opt-in integrations and lifecycle extensions.
+
+```ts
+import { registerPlugin } from 'resora';
+import { clearRouterExpressPlugin } from '@resora/plugin-clear-router';
+
+registerPlugin(clearRouterExpressPlugin);
+```
+
+Plugins can:
+
+- hook into serialization and response dispatch
+- inject framework integrations without core changes
+- register reusable transformation utilities
+
 ## Conditional Rendering Example
 
 ```ts

package/bin/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,rmSync as i,writeFileSync as a}from"fs";import o,{dirname as s,join as c}from"path";import{createRequire as l}from"module";import{pathToFileURL as u}from"url";import{Command as d,Kernel as f}from"@h3ravel/musket";let p={first:`first`,last:`last`,prev:`prev`,next:`next`},m={previous:`previous`,next:`next`};const h=e=>{p={...p,...e}},g=e=>{m={...m,...e}};let _=o.resolve(process.cwd(),`node_modules/resora/stubs`);t(_)||(_=o.resolve(process.cwd(),`stubs`));const v=()=>({stubsDir:_,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`}}),y=e=>{let t=v();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 b=!1,x;const S=e=>{e.preferredCase!==`camel`&&e.preferredCase,e.responseStructure,e.paginatedExtras,h(e.paginatedLinks),e.paginatedMeta,g(e.cursorMeta),e.baseUrl,e.pageName},C=async e=>await import(`${u(e).href}?resora_runtime=${Date.now()}`),w=e=>{S(y((e?.default??e)||{})),b=!0},T=()=>{let e=l(import.meta.url),n=[o.join(process.cwd(),`resora.config.cjs`)];for(let r of n)if(t(r))try{return w(e(r)),!0}catch{continue}return!1};(async()=>{if(!b){if(x)return await x;T()||(x=(async()=>{let e=[o.join(process.cwd(),`resora.config.js`),o.join(process.cwd(),`resora.config.ts`)];for(let n of e)if(t(n))try{w(await C(n));return}catch{continue}b=!0})(),await x)}})();var E=class{command;config={};constructor(e={}){this.config=y(e)}async loadConfig(e={}){this.config=y(e);let n=[c(process.cwd(),`resora.config.ts`),c(process.cwd(),`resora.config.js`),c(process.cwd(),`resora.config.cjs`)];for(let e of n)if(t(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 n=c(process.cwd(),`resora.config.js`),i=c(this.config.stubsDir,this.config.stubs.config);return t(n)&&!this.command.option(`force`)&&(this.command.error(`Error: ${n} already exists.`),process.exit(1)),this.ensureDirectory(n),t(n)&&this.command.option(`force`)&&e(n,n.replace(/\.js$/,`.backup.${Date.now()}.js`)),a(n,r(i,`utf-8`)),{path:n}}ensureDirectory(e){let r=s(e);t(r)||n(r,{recursive:!0})}generateFile(e,n,o,s){t(n)&&!s?.force?(this.command.error(`Error: ${n} already exists.`),process.exit(1)):t(n)&&s?.force&&i(n);let c=r(e,`utf-8`);for(let[e,t]of Object.entries(o))c=c.replace(RegExp(`{{${e}}}`,`g`),t);return this.ensureDirectory(n),a(n,c),n}makeResource(e,n){let r=e;n?.collection&&!e.endsWith(`Collection`)&&!e.endsWith(`Resource`)?r+=`Collection`:!n?.collection&&!e.endsWith(`Resource`)&&!e.endsWith(`Collection`)&&(r+=`Resource`);let i=`${r}.ts`,a=c(this.config.resourcesDir,i),o=c(this.config.stubsDir,n?.collection||e.endsWith(`Collection`)?this.config.stubs.collection:this.config.stubs.resource);t(o)||(this.command.error(`Error: Stub file ${o} not found.`),process.exit(1)),r=r.split(`/`).pop()?.split(`.`).shift();let s=r.replace(/(Resource|Collection)$/,``)+`Resource`,l=[`/**`,` * The resource that this collection collects.`,` */`,`collects = ${s}`].join(`
-`),u=`import ${s} from './${s}'\n`,d=(!!n?.collection||e.endsWith(`Collection`))&&t(c(this.config.resourcesDir,`${s}.ts`)),f=this.generateFile(o,a,{ResourceName:r,CollectionResourceName:r.replace(/(Resource|Collection)$/,``)+`Resource`,"collects = Resource":d?l:``,"import = Resource":d?u:``},n);return{name:r,path:f}}},D=class extends d{signature=`init
+import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,rmSync as i,writeFileSync as a}from"fs";import o,{dirname as s,join as c}from"path";import{AsyncLocalStorage as l}from"node:async_hooks";import{createRequire as u}from"module";import{pathToFileURL as d}from"url";import{Command as f,Kernel as p}from"@h3ravel/musket";let m={first:`first`,last:`last`,prev:`prev`,next:`next`},h={previous:`previous`,next:`next`};const g=e=>{m={...m,...e}},_=e=>{h={...h,...e}};new l;let v=o.resolve(process.cwd(),`node_modules/resora/stubs`);t(v)||(v=o.resolve(process.cwd(),`stubs`));const y=()=>({stubsDir:v,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`}}),b=e=>{let t=y();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 x=!1,S;const C=e=>{e.preferredCase!==`camel`&&e.preferredCase,e.responseStructure,e.paginatedExtras,g(e.paginatedLinks),e.paginatedMeta,_(e.cursorMeta),e.baseUrl,e.pageName},w=async e=>await import(`${d(e).href}?resora_runtime=${Date.now()}`),T=e=>{C(b((e?.default??e)||{})),x=!0},E=()=>{let e=u(import.meta.url),n=[o.join(process.cwd(),`resora.config.cjs`)];for(let r of n)if(t(r))try{return T(e(r)),!0}catch{continue}return!1};(async()=>{if(!x){if(S)return await S;E()||(S=(async()=>{let e=[o.join(process.cwd(),`resora.config.js`),o.join(process.cwd(),`resora.config.ts`)];for(let n of e)if(t(n))try{T(await w(n));return}catch{continue}x=!0})(),await S)}})();var D=class{command;config={};constructor(e={}){this.config=b(e)}async loadConfig(e={}){this.config=b(e);let n=[c(process.cwd(),`resora.config.ts`),c(process.cwd(),`resora.config.js`),c(process.cwd(),`resora.config.cjs`)];for(let e of n)if(t(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 n=c(process.cwd(),`resora.config.js`),i=c(this.config.stubsDir,this.config.stubs.config);return t(n)&&!this.command.option(`force`)&&(this.command.error(`Error: ${n} already exists.`),process.exit(1)),this.ensureDirectory(n),t(n)&&this.command.option(`force`)&&e(n,n.replace(/\.js$/,`.backup.${Date.now()}.js`)),a(n,r(i,`utf-8`)),{path:n}}ensureDirectory(e){let r=s(e);t(r)||n(r,{recursive:!0})}generateFile(e,n,o,s){t(n)&&!s?.force?(this.command.error(`Error: ${n} already exists.`),process.exit(1)):t(n)&&s?.force&&i(n);let c=r(e,`utf-8`);for(let[e,t]of Object.entries(o))c=c.replace(RegExp(`{{${e}}}`,`g`),t);return this.ensureDirectory(n),a(n,c),n}makeResource(e,n){let r=e;n?.collection&&!e.endsWith(`Collection`)&&!e.endsWith(`Resource`)?r+=`Collection`:!n?.collection&&!e.endsWith(`Resource`)&&!e.endsWith(`Collection`)&&(r+=`Resource`);let i=`${r}.ts`,a=c(this.config.resourcesDir,i),o=c(this.config.stubsDir,n?.collection||e.endsWith(`Collection`)?this.config.stubs.collection:this.config.stubs.resource);t(o)||(this.command.error(`Error: Stub file ${o} not found.`),process.exit(1)),r=r.split(`/`).pop()?.split(`.`).shift();let s=r.replace(/(Resource|Collection)$/,``)+`Resource`,l=[`/**`,` * The resource that this collection collects.`,` */`,`collects = ${s}`].join(`
+`),u=`import ${s} from './${s}'\n`,d=(!!n?.collection||e.endsWith(`Collection`))&&t(c(this.config.resourcesDir,`${s}.ts`)),f=this.generateFile(o,a,{ResourceName:r,CollectionResourceName:r.replace(/(Resource|Collection)$/,``)+`Resource`,"collects = Resource":d?l:``,"import = Resource":d?u:``},n);return{name:r,path:f}}},O=class extends f{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`)}},O=class extends d{signature=`#create:
+    `;description=`Initialize Resora`;async handle(){this.app.command=this,this.app.init(),this.success(`Resora initialized`)}},k=class extends f{signature=`#create:
         {resource : Generates a new resource file.
             | {name : Name of the resource to create}
             | {--c|collection : Make a resource collection}
@@ -16,11 +16,11 @@ import{copyFileSync as e,existsSync as t,mkdirSync as n,readFileSync as r,rmSync
             | {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}`)}},k=String.raw`
+    `;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}`)}},A=String.raw`
   _____                           
  |  __ \                          
  | |__) |___  ___  ___  _ __ __ _ 
  |  _  // _ \/ __|/ _ \| '__/ _, |
  | | \ \  __/\__ \ (_) | | | (_| |
  |_|  \_\___||___/\___/|_|  \__,_|                                                                                           
-`;const A=new E;await f.init(await A.loadConfig(),{logo:k,name:`Resora CLI`,baseCommands:[O,D,...A.getConfig().extraCommands||[]],exceptionHandler(e){throw e}});export{};
+`;const j=new D;await p.init(await j.loadConfig(),{logo:A,name:`Resora CLI`,baseCommands:[k,O,...j.getConfig().extraCommands||[]],exceptionHandler(e){throw e}});export{};

package/dist/index.cjs

@@ -29,6 +29,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 let fs = require("fs");
 let path = require("path");
 path = __toESM(path);
+let node_async_hooks = require("node:async_hooks");
 let module$1 = require("module");
 let url = require("url");
 let _h3ravel_musket = require("@h3ravel/musket");
@@ -282,6 +283,8 @@ const getGlobalCursorMeta = () => {
 	return globalCursorMeta;
 };
 let globalRequestUrl;
+let globalCtx;
+const requestContextStore = new node_async_hooks.AsyncLocalStorage();
 /**
 * Sets the current request URL, used as a fallback for pagination link generation
 * when no explicit path is provided in the pagination data.
@@ -297,7 +300,16 @@ const setRequestUrl = (url) => {
 * @returns The current request URL, or undefined if not set.
 */
 const getRequestUrl = () => {
-	return globalRequestUrl;
+	return requestContextStore.getStore()?.url ?? globalRequestUrl;
+};
+const runWithCtx = (ctx, callback) => {
+	return requestContextStore.run({
+		ctx,
+		url: extractRequestUrl(ctx)
+	}, callback);
+};
+const getCtx = () => {
+	return requestContextStore.getStore()?.ctx ?? globalCtx;
 };
 /**
 * Extracts the request URL pathname (with query string) from an HTTP context.
@@ -359,6 +371,7 @@ const extractResponseFromCtx = (ctx) => {
 * @param ctx An HTTP context `{ req, res }`, Express Request, H3 HTTPEvent, or bare request.
 */
 const setCtx = (ctx) => {
+	globalCtx = ctx;
 	setRequestUrl(extractRequestUrl(ctx));
 };
 
@@ -1188,6 +1201,51 @@ var logo_default = String.raw`
  |_|  \_\___||___/\___/|_|  \__,_|                                                                                           
 `;
 
+//#endregion
+//#region src/plugins.ts
+const registeredPlugins = /* @__PURE__ */ new Map();
+const registeredUtilities = /* @__PURE__ */ new Map();
+const getRegisteredPlugins = () => {
+	return Array.from(registeredPlugins.values());
+};
+const registerUtility = (name, utility) => {
+	registeredUtilities.set(name, utility);
+	return utility;
+};
+const getUtility = (name) => {
+	return registeredUtilities.get(name);
+};
+const pluginApi = {
+	runWithCtx,
+	setCtx,
+	getCtx,
+	registerUtility,
+	getUtility,
+	getRegisteredPlugins
+};
+const definePlugin = (plugin) => {
+	return plugin;
+};
+const registerPlugin = (plugins) => {
+	for (const plugin of Array.isArray(plugins) ? plugins : [plugins]) {
+		if (registeredPlugins.has(plugin.name)) continue;
+		registeredPlugins.set(plugin.name, plugin);
+		plugin.setup?.(pluginApi);
+	}
+	return getRegisteredPlugins();
+};
+const runPluginHook = (hook, event) => {
+	for (const plugin of registeredPlugins.values()) {
+		const handler = plugin[hook];
+		if (typeof handler === "function") handler(event, pluginApi);
+	}
+	return event;
+};
+const resetPluginsForTests = () => {
+	registeredPlugins.clear();
+	registeredUtilities.clear();
+};
+
 //#endregion
 //#region src/ServerResponse.ts
 /**
@@ -1293,14 +1351,38 @@ var ServerResponse = class {
 	*/
 	send(body) {
 		if (typeof body !== "undefined") this.body = body;
+		const beforeSend = runPluginHook("beforeSend", {
+			response: this,
+			rawResponse: this.response,
+			body: this.body,
+			status: this._status,
+			headers: { ...this.headers }
+		});
+		this.body = beforeSend.body;
+		this._status = beforeSend.status;
+		this.headers = { ...beforeSend.headers };
 		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);
+			runPluginHook("afterSend", {
+				response: this,
+				rawResponse: this.response,
+				body: this.body,
+				status: this._status,
+				headers: { ...this.headers }
+			});
 			return this.body;
 		}
 		if ("status" in this.response && typeof this.response.status !== "function") this.response.status = this._status;
+		runPluginHook("afterSend", {
+			response: this,
+			rawResponse: this.response,
+			body: this.body,
+			status: this._status,
+			headers: { ...this.headers }
+		});
 		return this.body;
 	}
 	/**
@@ -1399,6 +1481,63 @@ var BaseSerializer = class {
 		return resolveMergeWhen(condition, value);
 	}
 	/**
+	* Apply registered plugins for the serialization process, allowing plugins to 
+	* modify the response body and metadata before the response is sent.
+	* 
+	* @param body 
+	* @returns 
+	*/
+	applySerializePlugins(body) {
+		return runPluginHook("afterSerialize", runPluginHook("beforeSerialize", {
+			serializer: this,
+			serializerType: this.getSerializerType(),
+			resource: this.getResourceForMeta(),
+			body
+		})).body;
+	}
+	/**
+	* Apply registered plugins for the response process, allowing plugins to modify the 
+	* response body, headers, and status before the response is sent.
+	* 
+	* @param input 
+	* @returns 
+	*/
+	applyResponsePlugins(input) {
+		const beforeResponse = runPluginHook("beforeResponse", {
+			serializer: this,
+			serializerType: this.getSerializerType(),
+			rawResponse: input.rawResponse,
+			response: input.response,
+			body: input.body
+		});
+		this.setBody(beforeResponse.body);
+		if (typeof input.response?.setBody === "function") input.response.setBody(beforeResponse.body);
+		const afterResponse = runPluginHook("afterResponse", beforeResponse);
+		this.setBody(afterResponse.body);
+		if (typeof input.response?.setBody === "function") input.response.setBody(afterResponse.body);
+		return afterResponse.body;
+	}
+	/**
+	* Resolve the raw response object from the provided response or the current 
+	* context, allowing plugins to access and modify the raw response before it is sent. 
+	* 
+	* @param response 
+	* @returns 
+	*/
+	resolveRawResponse(response) {
+		if (typeof response !== "undefined") return response;
+		return extractResponseFromCtx(getCtx() ?? this.constructor.ctx);
+	}
+	/**
+	* Dispatch a body to a raw response object when it exposes a send() transport method.
+	*
+	* @param raw
+	* @param body
+	*/
+	sendRawResponseBody(raw, body) {
+		if (raw && typeof raw.send === "function") raw.send(body);
+	}
+	/**
 	* Add additional metadata to the response. If called without arguments.
 	* 
 	* @param meta 
@@ -1446,6 +1585,11 @@ var BaseSerializer = class {
 		this.called.withResponse = true;
 		input.callWithResponse(response, input.rawResponse);
 		if (typeof response?.setBody === "function") response.setBody(input.body());
+		this.applyResponsePlugins({
+			body: input.body(),
+			rawResponse: input.rawResponse,
+			response
+		});
 		return response;
 	}
 	/**
@@ -1470,9 +1614,14 @@ var BaseSerializer = class {
 		}
 		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);
+		const dispatchedBody = this.applyResponsePlugins({
+			body: resolvedBody,
+			rawResponse: input.rawResponse,
+			response
+		});
+		const resolved = Promise.resolve(dispatchedBody).then(input.onfulfilled, input.onrejected);
+		if (typeof response?.send === "function") response.send(dispatchedBody);
+		else if (typeof input.rawResponse !== "undefined" && input.sendRawResponse) input.sendRawResponse(input.rawResponse, dispatchedBody);
 		return resolved;
 	}
 	/**
@@ -1656,6 +1805,9 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	getResourceForMeta() {
 		return this.resource;
 	}
+	getSerializerType() {
+		return "generic";
+	}
 	getPayloadKey() {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
@@ -1699,6 +1851,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 				...paginationExtras,
 				...customMeta || {}
 			}, rootKey);
+			this.body = this.applySerializePlugins(this.body);
 		}
 		return this;
 	}
@@ -1755,7 +1908,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 	* @returns 
 	*/
 	response(res) {
-		const rawResponse = res ?? this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx;
+		const rawResponse = this.resolveRawResponse(res ?? this.res);
 		return this.runResponse({
 			ensureJson: () => this.json(),
 			rawResponse,
@@ -1792,7 +1945,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -1805,7 +1958,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onfulfilled,
 			onrejected
@@ -1821,7 +1974,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -1834,7 +1987,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onrejected
 		});
@@ -1849,7 +2002,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? GenericResource.ctx?.res ?? GenericResource.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -1862,7 +2015,7 @@ var GenericResource = class GenericResource extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onfulfilled: onfinally,
 			onrejected: onfinally
@@ -1971,6 +2124,9 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	getResourceForMeta() {
 		return this.resource;
 	}
+	getSerializerType() {
+		return "collection";
+	}
 	/**
 	* Get the appropriate key for the response payload based on the current response 
 	* structure configuration.
@@ -2020,6 +2176,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 				...paginationExtras,
 				...customMeta || {}
 			}, rootKey);
+			this.body = this.applySerializePlugins(this.body);
 		}
 		return this;
 	}
@@ -2070,7 +2227,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	* @returns 
 	*/
 	response(res) {
-		const rawResponse = res ?? this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx;
+		const rawResponse = this.resolveRawResponse(res ?? this.res);
 		return this.runResponse({
 			ensureJson: () => this.json(),
 			rawResponse,
@@ -2103,15 +2260,15 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 	/**
 	* 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
+	* @param onfulfilled  Callback to handle the fulfilled state of the promise
+	* @param onrejected  Callback to handle the rejected state of the promise
 	* @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,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -2124,7 +2281,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onfulfilled,
 			onrejected
@@ -2140,7 +2297,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -2153,7 +2310,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onrejected
 		});
@@ -2168,7 +2325,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? ResourceCollection.ctx?.res ?? ResourceCollection.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -2181,7 +2338,7 @@ var ResourceCollection = class ResourceCollection extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onfulfilled: onfinally,
 			onrejected: onfinally
@@ -2284,6 +2441,9 @@ var Resource = class Resource extends BaseSerializer {
 	getResourceForMeta() {
 		return this.resource;
 	}
+	getSerializerType() {
+		return "resource";
+	}
 	getPayloadKey() {
 		const { wrap, rootKey, factory } = this.resolveResponseStructure();
 		return factory || !wrap ? void 0 : rootKey;
@@ -2317,6 +2477,7 @@ var Resource = class Resource extends BaseSerializer {
 				}
 			});
 			this.body = appendRootProperties(this.body, customMeta, rootKey);
+			this.body = this.applySerializePlugins(this.body);
 		}
 		return this;
 	}
@@ -2370,7 +2531,7 @@ var Resource = class Resource extends BaseSerializer {
 	* @returns 
 	*/
 	response(res) {
-		const rawResponse = res ?? this.res ?? Resource.ctx?.res ?? Resource.ctx;
+		const rawResponse = this.resolveRawResponse(res ?? this.res);
 		return this.runResponse({
 			ensureJson: () => this.json(),
 			rawResponse,
@@ -2407,7 +2568,7 @@ var Resource = class Resource extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? Resource.ctx?.res ?? Resource.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -2420,7 +2581,7 @@ var Resource = class Resource extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onfulfilled,
 			onrejected
@@ -2436,7 +2597,7 @@ var Resource = class Resource extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? Resource.ctx?.res ?? Resource.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -2449,7 +2610,7 @@ var Resource = class Resource extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onrejected
 		});
@@ -2464,7 +2625,7 @@ var Resource = class Resource extends BaseSerializer {
 		return this.runThen({
 			ensureJson: () => this.json(),
 			body: () => this.body,
-			rawResponse: this.res ?? Resource.ctx?.res ?? Resource.ctx,
+			rawResponse: this.resolveRawResponse(this.res),
 			createServerResponse: (raw, body) => {
 				const response = new ServerResponse(raw, body);
 				this.withResponseContext = {
@@ -2477,7 +2638,7 @@ var Resource = class Resource extends BaseSerializer {
 				this.withResponse(response, raw);
 			},
 			sendRawResponse: (raw, body) => {
-				raw.send(body);
+				this.sendRawResponseBody(raw, body);
 			},
 			onfulfilled: onfinally,
 			onrejected: onfinally
@@ -2501,9 +2662,11 @@ exports.buildPaginationExtras = buildPaginationExtras;
 exports.buildResponseEnvelope = buildResponseEnvelope;
 exports.createArkormCurrentPageResolver = createArkormCurrentPageResolver;
 exports.defineConfig = defineConfig;
+exports.definePlugin = definePlugin;
 exports.extractRequestUrl = extractRequestUrl;
 exports.extractResponseFromCtx = extractResponseFromCtx;
 exports.getCaseTransformer = getCaseTransformer;
+exports.getCtx = getCtx;
 exports.getDefaultConfig = getDefaultConfig;
 exports.getGlobalBaseUrl = getGlobalBaseUrl;
 exports.getGlobalCase = getGlobalCase;
@@ -2517,7 +2680,9 @@ exports.getGlobalResponseRootKey = getGlobalResponseRootKey;
 exports.getGlobalResponseStructure = getGlobalResponseStructure;
 exports.getGlobalResponseWrap = getGlobalResponseWrap;
 exports.getPaginationExtraKeys = getPaginationExtraKeys;
+exports.getRegisteredPlugins = getRegisteredPlugins;
 exports.getRequestUrl = getRequestUrl;
+exports.getUtility = getUtility;
 exports.hasPaginationLink = hasPaginationLink;
 exports.isArkormLikeCollection = isArkormLikeCollection;
 exports.isArkormLikeModel = isArkormLikeModel;
@@ -2525,12 +2690,17 @@ exports.isPlainObject = isPlainObject;
 exports.loadRuntimeConfig = loadRuntimeConfig;
 exports.mergeMetadata = mergeMetadata;
 exports.normalizeSerializableData = normalizeSerializableData;
+exports.registerPlugin = registerPlugin;
+exports.registerUtility = registerUtility;
+exports.resetPluginsForTests = resetPluginsForTests;
 exports.resetRuntimeConfigForTests = resetRuntimeConfigForTests;
 exports.resolveCurrentPage = resolveCurrentPage;
 exports.resolveMergeWhen = resolveMergeWhen;
 exports.resolveWhen = resolveWhen;
 exports.resolveWhenNotNull = resolveWhenNotNull;
 exports.resolveWithHookMetadata = resolveWithHookMetadata;
+exports.runPluginHook = runPluginHook;
+exports.runWithCtx = runWithCtx;
 exports.sanitizeConditionalAttributes = sanitizeConditionalAttributes;
 exports.setCtx = setCtx;
 exports.setGlobalBaseUrl = setGlobalBaseUrl;