seishiro 0.1.90-dev → 0.2.1-release

package/README.md

@@ -1,7 +1,7 @@
 # Seishiro API
 
 Seishiro eliminates the complexity of routing folder structures and replaces them with a single control center. Just use one endpoint, manage it through the Registry, and control your entire application data flow (Web, Mobile, and SSR) with consistent standards.
-
+<!-- 
 ## Tasks
 
 - [x] Registry Controllers
@@ -11,8 +11,8 @@ Seishiro eliminates the complexity of routing folder structures and replaces the
 - [x] Protocol Response
 - [x] Middleware Runner
 - [x] Action Executed
-- [ ] Versioning Header (Pending...)
-- [ ] Language Switch (Pending...)
+- [x] Versioning Header
+- [x] Language Switch -->
 
 ## Installation
 
@@ -78,7 +78,7 @@ const sysaction = await action.SystemAction({
   system: {
     headers: {...}, // Header KV (Key, Value)
     cookies: {...}, // Cookie KV (Key, Value)
-    ip: "103.214.146.116", // IP Address (IP Client - Example)
+    ip: "127.0.0.1", // IP Address (IP Client - Example)
     location: "JKT, Jakarta, Jakarta Pusat", // Location (Location Client By IP & PeerDB - Example)
   },
   type: "user:login", // Type Action
@@ -94,7 +94,7 @@ const serveraction = await action.ServerAction({
   system: {
     headers: {...}, // Header KV (Key, Value)
     cookies: {...}, // Cookie KV (Key, Value)
-    ip: "103.214.146.116", // IP Address (IP Client - Example)
+    ip: "127.0.0.1", // IP Address (IP Client - Example)
     location: "JKT, Jakarta, Jakarta Pusat", // Location (Location Client By IP & PeerDB - Example)
   },
   type: "user:profile", // Type Action
@@ -109,7 +109,7 @@ const apiaction = action.APIAction({
   system: {
     headers: {...}, // Header KV (Key, Value)
     cookies: {...}, // Cookie KV (Key, Value)
-    ip: "103.214.146.116", // IP Address (IP Client - Example)
+    ip: "127.0.0.1", // IP Address (IP Client - Example)
     location: "JKT, Jakarta, Jakarta Pusat", // Location (Location Client By IP & PeerDB - Example)
   },
   type: "user:profile", // Type Action

package/cjs/index.js

@@ -1 +1 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.Actions=exports.PolicyBuilder=exports.MessageBuilder=exports.RegistryBuilder=void 0;var registry_1=require("./lib/registry");Object.defineProperty(exports,"RegistryBuilder",{enumerable:!0,get:function(){return __importDefault(registry_1).default}});var message_1=require("./lib/message");Object.defineProperty(exports,"MessageBuilder",{enumerable:!0,get:function(){return __importDefault(message_1).default}});var policy_1=require("./lib/policy");Object.defineProperty(exports,"PolicyBuilder",{enumerable:!0,get:function(){return __importDefault(policy_1).default}});var actions_1=require("./lib/actions");Object.defineProperty(exports,"Actions",{enumerable:!0,get:function(){return __importDefault(actions_1).default}});
+"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.Actions=exports.PolicyBuilder=exports.MessageBuilder=exports.RegistryBuilder=void 0;var registry_js_1=require("./lib/registry.js");Object.defineProperty(exports,"RegistryBuilder",{enumerable:!0,get:function(){return __importDefault(registry_js_1).default}});var message_js_1=require("./lib/message.js");Object.defineProperty(exports,"MessageBuilder",{enumerable:!0,get:function(){return __importDefault(message_js_1).default}});var policy_js_1=require("./lib/policy.js");Object.defineProperty(exports,"PolicyBuilder",{enumerable:!0,get:function(){return __importDefault(policy_js_1).default}});var actions_js_1=require("./lib/actions.js");Object.defineProperty(exports,"Actions",{enumerable:!0,get:function(){return __importDefault(actions_js_1).default}});

package/cjs/lib/actions.js

@@ -1 +1 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const crypto_1=__importDefault(require("crypto")),buffer_1=require("buffer");class Actions{registry;message;policy;constructor({registry:e,message:r,policy:t}){this.registry=e,this.message=r,this.policy=t}BookRegistry(){const e="hex",r=crypto_1.default.randomBytes(16),t=this.policy.apply(),s=this.registry.apply(),i=crypto_1.default.createHash("sha256").update(String(t.passkey||"").trim()).digest(),o={listkey:Object.keys(s).filter(e=>!t.noaction_api.includes(e)),version_now:t.version_now,version_min:t.version_min,version_forceupdate:t.version_forceupdate},a=crypto_1.default.createCipheriv("aes-256-ctr",i,r),n=buffer_1.Buffer.concat([r,a.update(JSON.stringify(o),"utf-8"),a.final()]);return{iv_length:16,type_base:e,iv:r.toString(e),data:n.toString(e)}}ResponseBuilder(e={},r){const t=!e.data||e.error||!e||"object"!=typeof e||Array.isArray(e)?e.status||400:e.status||200,s="object"!=typeof e.headers||Array.isArray(e.headers)?[]:Object.entries(e.headers).map(([e,r])=>({key:e,value:r})),i=Array.isArray(e.set_cookie)?(e.set_cookie||[]).filter(e=>"object"==typeof e&&!Array.isArray(e)&&e.key&&e.value):[],o=Array.isArray(e.rm_cookie)?(e.rm_cookie||[]).filter(e=>"object"==typeof e&&!Array.isArray(e)&&e.key):[],a=e.redirect||null;if(!e.data||e.error||!e||"object"!=typeof e||Array.isArray(e)){const r=this.message.error(e.error||"system:no-response-sending",e.params||[]);return{header:s,set_cookie:i,rm_cookie:o,status:t,redirect:a,error:e.error||"system:no-response-sending",response:{status:t,message:r.message,protocol:r.protocol,context:r.context,params:r.params}}}return{header:s,set_cookie:i,rm_cookie:o,status:t,redirect:a,error:null,response:{status:t,data:e.data||{}}}}async SystemAction({system:e,middleware:r={},type:t,data:s}){try{const i=this.registry.get(t||"");if(!i)return this.ResponseBuilder({error:"system:no-registry",status:404},e);if(Array.isArray(i)){const o=await i[0]({system:e,middleware:r,type:t,data:s});let a=o;o?.skipBuilder||(a=this.ResponseBuilder(o,e));const n=await i[1]({system:e,middleware:a,type:t,data:s});return this.ResponseBuilder(n,e)}const o=await i({system:e,middleware:r,type:t,data:s});return this.ResponseBuilder(o,e)}catch(r){return console.log("[Context Action Error Internal!]:",r),this.ResponseBuilder({error:"system:internal-server-error",status:500},e)}}async ServerAction({system:e,middleware:r,type:t,data:s}){return this.policy.apply().noaction_server.includes(t||"")?this.ResponseBuilder({error:"system:no-registry",status:404},e):this.SystemAction({system:e,middleware:r,type:t,data:s})}async APIAction({system:e,middleware:r,type:t,data:s}){return this.policy.apply().noaction_api.includes(t||"")?this.ResponseBuilder({error:"system:no-registry",status:404},e):this.SystemAction({system:e,middleware:r,type:t,data:s})}}exports.default=Actions;
+"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const crypto_1=__importDefault(require("crypto")),buffer_1=require("buffer"),extract_lang_js_1=__importDefault(require("../utils/extract-lang.js"));class Actions{registry;message;policy;cache_book;constructor({registry:e,message:t,policy:r}){this.registry=e,this.message=t,this.policy=r,this.cache_book=null}BookRegistry(){if(this.cache_book)return this.cache_book;const e="hex",t=crypto_1.default.randomBytes(16),r=this.policy.apply(),s=this.registry.apply(),i=crypto_1.default.createHash("sha256").update(String(r.passkey||"").trim()).digest(),o={listkey:Object.keys(s).filter(e=>!r.noaction_api.includes(e)),version_now:r.version_now,version_min:r.version_min,version_forceupdate:r.version_forceupdate},a=crypto_1.default.createCipheriv("aes-256-ctr",i,t),n=buffer_1.Buffer.concat([t,a.update(JSON.stringify(o),"utf-8"),a.final()]),c={iv_length:16,type_base:e,iv:t.toString(e),data:n.toString(e)};return this.cache_book=c,c}ResponseBuilder(e={},t,r="en"){const s=!e||"object"!=typeof e||Array.isArray(e)||!!e.error||!e.data,i=e?.status||(s?400:200),o=e?.redirect||null,a=[];if(e?.headers&&"object"==typeof e.headers&&!Array.isArray(e.headers))for(const[t,r]of Object.entries(e.headers))a.push({key:t,value:r});const n=[];if(Array.isArray(e?.set_cookie))for(const t of e.set_cookie)t&&"object"==typeof t&&t.key&&t.value&&n.push(t);const c=[];if(Array.isArray(e?.rm_cookie))for(const t of e.rm_cookie)t&&"string"==typeof t&&c.push(t);const l={header:a,set_cookie:n,rm_cookie:c,status:i,redirect:o};if(s){const t=e?.error||"system:no-response-sending",s=this.message.error(t,e?.params||[],r);return{...l,error:t,response:{status:i,message:s.message,protocol:s.protocol,context:s.context,params:s.params}}}return{...l,error:null,response:{status:i,data:e.data||{}}}}async SystemAction({system:e,middleware:t={},context_manager:r="system-action",type:s,data:i}){const o=e?.headers||{},a=o["x-seishiro-lang"]||o["accept-language"],n=a?(0,extract_lang_js_1.default)(a):e?.lang||"en";try{const a=this.policy.apply(),c=o["x-seishiro-client"];if("api-action"===r&&!c)return this.ResponseBuilder({error:"system:client-version-required",status:400},e,n);if(c&&"api-action"===r){const t=this.policy.version_info(c);if(!t.is_version_min&&t.info_upgrade)return this.ResponseBuilder({error:"system:need-upgrade-client",status:426,params:[{min:a.version_min,now:a.version_now}]},e,n)}const l=this.registry.get(s||"");if(!l)return this.ResponseBuilder({error:"system:no-registry",status:404},e,n);const u={...e,lang:n};let p=t,y=l;if(Array.isArray(l)){const[e,r]=l,o=await e({system:u,middleware:t,type:s,data:i});p=a.skip_middleware_context||o?.skipBuilder?o:this.ResponseBuilder(o,u,n),y=r}const d=await y({system:u,middleware:p,type:s,data:i});return this.ResponseBuilder(d,u,n)}catch(t){return console.error("[Seishiro Core Error]:",t),this.ResponseBuilder({error:"system:internal-server-error",status:500},e,n)}}async ServerAction({system:e,middleware:t,type:r,data:s}){if(this.policy.apply().noaction_server.includes(r||"")){const t=(0,extract_lang_js_1.default)(e?.headers?.["x-seishiro-lang"]||e?.headers?.["accept-language"]||e?.lang||"en");return this.ResponseBuilder({error:"system:no-registry",status:404},e,t)}return this.SystemAction({system:e,middleware:t,context_manager:"server-action",type:r,data:s})}async APIAction({system:e,middleware:t,type:r,data:s}){if(this.policy.apply().noaction_api.includes(r||"")){const t=(0,extract_lang_js_1.default)(e?.headers?.["x-seishiro-lang"]||e?.headers?.["accept-language"]||e?.lang||"en");return this.ResponseBuilder({error:"system:no-registry",status:404},e,t)}return this.SystemAction({system:e,middleware:t,context_manager:"api-action",type:r,data:s})}}exports.default=Actions;

package/cjs/lib/message.js

@@ -1 +1 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const format_key_1=__importDefault(require("../utils/format-key")),message_1=require("../constants/message");class MessageBuilder{message_build_lang="";message_logic={};constructor(e="en"){this.message_build_lang=String(e||"en").toLowerCase().replace(/[^a-z]/g,"").slice(0,2),this.message_logic={}}set(e,s){const t=(0,format_key_1.default)(e);if("string"!=typeof s)throw new Error("Message value is only type string!");if("string"!=typeof e)throw new Error("Message key is only type string!");this.message_logic[this.message_build_lang]||(this.message_logic[this.message_build_lang]={}),this.message_logic[this.message_build_lang][t]=String(s).trim()}get(e="",s=this.message_build_lang){const t=(0,format_key_1.default)(e);let a=s;return this.message_logic[a]||(console.warn("[Debugging Message]: Language not found on logic, using default language!"),a=this.message_logic[message_1.DefaultLanguage]?message_1.DefaultLanguage:Object.keys(this.message_logic||{})[0]),this.message_logic[a]?String(this.message_logic[a][t]||"").trim():(console.warn("[Debugging Message]: Language or variable not found on logic!"),String(`[!NoneVariable ${t}]`))}errorMessage(e="",s={},t=this.message_build_lang){let a=this.get(e,t);return Object.keys(s||{}).forEach(e=>{const t=s[e]||"",i=new RegExp(`{{${e}}}`,"g");a=a.replace(i,t)}),a}error(e="",s=[],t=this.message_build_lang){const[a,...i]=String(e||"").split(":"),g=String(i.join(":")).split("|"),o=g.map((e,a)=>{const i=s[a];return this.errorMessage(e,i,t)}).join(", ");return{protocol:(0,format_key_1.default)(a),context:g,params:s,message:o}}apply(){return this.message_logic}use(e){if(e instanceof MessageBuilder){const s=e.apply();for(const e in s)if(Object.prototype.hasOwnProperty.call(s,e)){const t=s[e];this.message_logic[e]||(this.message_logic[e]={}),Object.assign(this.message_logic[e],t)}}else{if("object"!=typeof e||null===e)throw new Error('The "use" input must be a MessageBuilder or mapping object!');for(const s in e)Object.prototype.hasOwnProperty.call(e,s)&&this.set(s,e[s])}}}exports.default=MessageBuilder;
+"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const format_key_js_1=__importDefault(require("../utils/format-key.js")),message_js_1=require("../constants/message.js");class MessageBuilder{message_build_lang="";message_logic=new Map;constructor(e="en"){this.message_build_lang=String(e||"en").toLowerCase().replace(/[^a-z]/g,"").slice(0,2),this.message_logic=new Map}set(e,s){if("string"!=typeof s||"string"!=typeof e)throw new Error("Key and Value must be string!");const t=(0,format_key_js_1.default)(e);this.message_logic.has(this.message_build_lang)||this.message_logic.set(this.message_build_lang,new Map),this.message_logic.get(this.message_build_lang).set(t,s.trim())}get(e="",s=this.message_build_lang){const t=(0,format_key_js_1.default)(e);let a=this.message_logic.get(s);return a||(a=this.message_logic.get(message_js_1.DefaultLanguage),!a&&this.message_logic.size>0&&(a=this.message_logic.values().next().value)),a?a.get(t)||"":`[!NoneVariable ${t}]`}errorMessage(e="",s={},t=this.message_build_lang){const a=this.get(e,t);return s&&0!==Object.keys(s).length?a.replace(/{{(\w+)}}/g,(e,t)=>s[t]||e):a}error(e="",s=[],t=this.message_build_lang){const a=e.indexOf(":");if(-1===a)return{protocol:"unknown",context:[e],params:s,message:e};const i=(0,format_key_js_1.default)(e.substring(0,a)),r=e.substring(a+1).split("|");let g="";for(let e=0;e<r.length;e++){g+=(0===e?"":", ")+this.errorMessage(r[e],s[e],t)}return{protocol:i,context:r,params:s,message:g}}apply(){return this.message_logic}use(e){if(e instanceof MessageBuilder){e.apply().forEach((e,s)=>{let t=this.message_logic.get(s);t||(t=new Map,this.message_logic.set(s,t)),e.forEach((e,s)=>{t.set(s,e)})})}else{if("object"!=typeof e||null===e)throw new Error('The "use" input must be a MessageBuilder or mapping object!');for(const s in e)Object.prototype.hasOwnProperty.call(e,s)&&this.set(s,e[s])}}}exports.default=MessageBuilder;

package/cjs/lib/policy.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});class PolicyBuilder{passkey;version_now;version_min;version_forceupdate;noaction_api;noaction_server;constructor({passkey:i,version_now:e,version_min:o,version_forceupdate:n=!0}){if(!i||!e||!o)throw new Error("PolicyBuilder: passkey, version_now, and version_min are required!");this.passkey=i,this.version_now=e,this.version_min=o,this.version_forceupdate=n,this.noaction_api=[],this.noaction_server=[]}noaction(i="",e=[]){const o=["server-action","api-action"];for(let i of e)if(!o.includes(i))throw new Error(`Invalid action type: ${i}. Only allowed actions are: ${o.join(", ")}`);if("string"!=typeof i)throw new Error("Invalid key type, it only string!");for(let o of e)"api-action"===o?this.noaction_api.push(i):"server-action"===o&&this.noaction_server.push(i)}compareVersions(i,e){const o=i=>i.replace(/-.*$/,""),n=o(i).split(".").map(Number),r=o(e).split(".").map(Number);for(let i=0;i<Math.max(n.length,r.length);i++){const e=n[i]||0,o=r[i]||0;if(e>o)return 1;if(e<o)return-1}return 0}version_info(i=""){const e=this.compareVersions(i,this.version_min)>=0,o=this.compareVersions(i,this.version_now)>=0;return{info_upgrade:this.version_forceupdate,is_version_min:e,is_version_now:o}}apply(){return{passkey:this.passkey,version_now:this.version_now,version_min:this.version_min,version_forceupdate:this.version_forceupdate,noaction_api:this.noaction_api,noaction_server:this.noaction_server}}}exports.default=PolicyBuilder;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});class PolicyBuilder{passkey;version_now;version_min;version_forceupdate;noaction_api;noaction_server;compiled_policy=null;skip_middleware_context;parsed_min;parsed_now;constructor({passkey:e,version_now:i,version_min:o,version_forceupdate:s=!0,skip_middleware_context:r=!1}){if(!e||!i||!o)throw new Error("PolicyBuilder: passkey, version_now, and version_min are required!");this.passkey=e,this.version_now=i,this.version_min=o,this.parsed_min=this.parseVersion(o),this.parsed_now=this.parseVersion(i),this.version_forceupdate=s,this.noaction_api=[],this.noaction_server=[],this.skip_middleware_context=r,this.refresh()}noaction(e="",i=[]){const o=["server-action","api-action"];for(let e of i)if(!o.includes(e))throw new Error(`Invalid action type: ${e}. Only allowed actions are: ${o.join(", ")}`);if("string"!=typeof e)throw new Error("Invalid key type, it only string!");for(let o of i)"api-action"===o?this.noaction_api.push(e):"server-action"===o&&this.noaction_server.push(e)}parseVersion(e){return e.split(".").map(Number)}compare(e,i){const o=Math.max(e.length,i.length);for(let s=0;s<o;s++){const o=e[s]||0,r=i[s]||0;if(o!==r)return o>r?1:-1}return 0}version_info(e=""){const i=this.parseVersion(e);return{info_upgrade:this.version_forceupdate,is_version_min:this.compare(i,this.parsed_min)>=0,is_version_now:this.compare(i,this.parsed_now)>=0}}refresh(){this.compiled_policy={passkey:this.passkey,version_now:this.version_now,version_min:this.version_min,version_forceupdate:this.version_forceupdate,noaction_api:this.noaction_api,noaction_server:this.noaction_server,skip_middleware_context:this.skip_middleware_context}}apply(){return this.compiled_policy}}exports.default=PolicyBuilder;

package/cjs/lib/registry.js

@@ -1 +1 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0});const format_key_1=__importDefault(require("../utils/format-key"));class RegistryBuilder{registry_logic={};constructor(){this.registry_logic={}}set(t,e,r){const i=(0,format_key_1.default)(t);if("function"!=typeof e)throw new Error("Registry function is only type function!");if("string"!=typeof t)throw new Error("Registry key is only type string!");this.registry_logic[i]=r&&"function"==typeof r?[r,e]:e}get(t){const e=(0,format_key_1.default)(t);return this.registry_logic[e]||void 0}apply(){return this.registry_logic}use(t){const e=t instanceof RegistryBuilder?t.registry_logic:t;if("object"!=typeof e||null===e)throw new Error('The "use" input must be a RegistryBuilder or mapping object!');Object.entries(e).forEach(([t,e])=>{if(Array.isArray(e)){const[r,i]=e;this.set(t,i,r)}else"function"==typeof e&&this.set(t,e)})}}exports.default=RegistryBuilder;
+"use strict";var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0});const format_key_js_1=__importDefault(require("../utils/format-key.js"));class RegistryBuilder{registry_logic;constructor(){this.registry_logic=new Map}set(t,e,r){const i=(0,format_key_js_1.default)(t);if("function"!=typeof e)throw new Error("Registry function is only type function!");if("string"!=typeof t)throw new Error("Registry key is only type string!");r&&"function"==typeof r?this.registry_logic.set(i,[r,e]):this.registry_logic.set(i,e)}get(t){const e=(0,format_key_js_1.default)(t);return this.registry_logic.get(e)||void 0}apply(){return this.registry_logic}use(t){if(t instanceof RegistryBuilder)for(const[e,r]of t.registry_logic)this.registry_logic.set(e,r);else{if("object"!=typeof t||null===t)throw new Error('The "use" input must be a RegistryBuilder or mapping object!');for(const[e,r]of Object.entries(t))Array.isArray(r)?this.set(e,r[1],r[0]):"function"==typeof r&&this.set(e,r)}}}exports.default=RegistryBuilder;

package/cjs/types/actions.types.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});

package/cjs/utils/extract-lang.js

@@ -1 +1 @@
-"use strict";function extractLanguage(t=""){return String(t||"").trim().split(",").map(t=>t.split(";")[0].split("-")[0].trim()).filter((t,i,r)=>r.indexOf(t)===i)}
+"use strict";function extractLanguage(t=""){return String(t||"").trim().split(",").map(t=>t.split(";")[0].split("-")[0].trim()).filter((t,e,r)=>r.indexOf(t)===e)[0]}Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=extractLanguage;

package/esm/index.d.ts

@@ -1,4 +1,4 @@
-export { default as RegistryBuilder } from "./lib/registry";
-export { default as MessageBuilder } from "./lib/message";
-export { default as PolicyBuilder } from "./lib/policy";
-export { default as Actions } from "./lib/actions";
+export { default as RegistryBuilder } from "./lib/registry.js";
+export { default as MessageBuilder } from "./lib/message.js";
+export { default as PolicyBuilder } from "./lib/policy.js";
+export { default as Actions } from "./lib/actions.js";

package/esm/index.js

@@ -1 +1 @@
-export{default as RegistryBuilder}from"./lib/registry";export{default as MessageBuilder}from"./lib/message";export{default as PolicyBuilder}from"./lib/policy";export{default as Actions}from"./lib/actions";
+export{default as RegistryBuilder}from"./lib/registry.js";export{default as MessageBuilder}from"./lib/message.js";export{default as PolicyBuilder}from"./lib/policy.js";export{default as Actions}from"./lib/actions.js";

package/esm/lib/actions.d.ts

@@ -1,7 +1,7 @@
-import { RegistryParams } from "../types/registry.type";
-import RegistryBuilder from "./registry";
-import MessageBuilder from "./message";
-import PolicyBuilder from "./policy";
+import { RegistryParams } from "../types/registry.type.js";
+import RegistryBuilder from "./registry.js";
+import MessageBuilder from "./message.js";
+import PolicyBuilder from "./policy.js";
 /**
  * @class Actions
  * @description The main orchestrator of the Seishiro API. It handles the execution flow
@@ -11,6 +11,7 @@ export default class Actions {
     private registry;
     private message;
     private policy;
+    private cache_book;
     /**
      * @constructor
      * @param {Object} params - Configuration instances.
@@ -27,7 +28,7 @@ export default class Actions {
      * @method BookRegistry
      * @description Generates an encrypted list of available API registries and application versions.
      * This is used to securely expose allowed actions to the client side.
-     * @returns {Object} An object containing encryption metadata (iv, type_base) and the encrypted 'data' string.
+     * @returns {Object} An object containing encryption metadata (iv, type_base) and the encrypted "data" string.
      */
     BookRegistry(): {
         iv_length: number;
@@ -50,33 +51,25 @@ export default class Actions {
      * @param {RegistryParams} params - The request payload containing system info, type, data, and optional middleware state.
      * @returns {Promise<Object>} A promise that resolves to a standardized response object via ResponseBuilder.
      */
-    SystemAction({ system, middleware, type, data }: RegistryParams): Promise<{
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
+    SystemAction({ system, middleware, context_manager, type, data, }: RegistryParams): Promise<{
         error: any;
         response: {
             status: any;
             message: string;
             protocol: string;
             context: string[];
-            params: object[];
+            params: import("../types/message.type.js").MessageErrorContextOpt[];
             data?: undefined;
         };
-    } | {
         header: {
             key: string;
             value: unknown;
         }[];
-        set_cookie: any;
-        rm_cookie: any;
+        set_cookie: any[];
+        rm_cookie: string[];
         status: any;
         redirect: any;
+    } | {
         error: null;
         response: {
             status: any;
@@ -86,6 +79,14 @@ export default class Actions {
             context?: undefined;
             params?: undefined;
         };
+        header: {
+            key: string;
+            value: unknown;
+        }[];
+        set_cookie: any[];
+        rm_cookie: string[];
+        status: any;
+        redirect: any;
     }>;
     /**
      * @method ServerAction
@@ -95,32 +96,24 @@ export default class Actions {
      * @returns {Promise<Object>} The standardized response or a 404 error if the action is restricted by policy.
      */
     ServerAction({ system, middleware, type, data }: RegistryParams): Promise<{
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
         error: any;
         response: {
             status: any;
             message: string;
             protocol: string;
             context: string[];
-            params: object[];
+            params: import("../types/message.type.js").MessageErrorContextOpt[];
             data?: undefined;
         };
-    } | {
         header: {
             key: string;
             value: unknown;
         }[];
-        set_cookie: any;
-        rm_cookie: any;
+        set_cookie: any[];
+        rm_cookie: string[];
         status: any;
         redirect: any;
+    } | {
         error: null;
         response: {
             status: any;
@@ -130,6 +123,14 @@ export default class Actions {
             context?: undefined;
             params?: undefined;
         };
+        header: {
+            key: string;
+            value: unknown;
+        }[];
+        set_cookie: any[];
+        rm_cookie: string[];
+        status: any;
+        redirect: any;
     }>;
     /**
      * @method APIAction
@@ -139,32 +140,24 @@ export default class Actions {
      * @returns {Promise<Object>} The standardized response or a 404 error if the action is restricted by policy.
      */
     APIAction({ system, middleware, type, data }: RegistryParams): Promise<{
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
         error: any;
         response: {
             status: any;
             message: string;
             protocol: string;
             context: string[];
-            params: object[];
+            params: import("../types/message.type.js").MessageErrorContextOpt[];
             data?: undefined;
         };
-    } | {
         header: {
             key: string;
             value: unknown;
         }[];
-        set_cookie: any;
-        rm_cookie: any;
+        set_cookie: any[];
+        rm_cookie: string[];
         status: any;
         redirect: any;
+    } | {
         error: null;
         response: {
             status: any;
@@ -174,5 +167,13 @@ export default class Actions {
             context?: undefined;
             params?: undefined;
         };
+        header: {
+            key: string;
+            value: unknown;
+        }[];
+        set_cookie: any[];
+        rm_cookie: string[];
+        status: any;
+        redirect: any;
     }>;
 }

package/esm/lib/actions.js

@@ -1 +1 @@
-import crypto from"crypto";import{Buffer}from"buffer";export default class Actions{registry;message;policy;constructor({registry:e,message:r,policy:t}){this.registry=e,this.message=r,this.policy=t}BookRegistry(){const e="hex",r=crypto.randomBytes(16),t=this.policy.apply(),s=this.registry.apply(),o=crypto.createHash("sha256").update(String(t.passkey||"").trim()).digest(),i={listkey:Object.keys(s).filter(e=>!t.noaction_api.includes(e)),version_now:t.version_now,version_min:t.version_min,version_forceupdate:t.version_forceupdate},a=crypto.createCipheriv("aes-256-ctr",o,r),n=Buffer.concat([r,a.update(JSON.stringify(i),"utf-8"),a.final()]);return{iv_length:16,type_base:e,iv:r.toString(e),data:n.toString(e)}}ResponseBuilder(e={},r){const t=!e.data||e.error||!e||"object"!=typeof e||Array.isArray(e)?e.status||400:e.status||200,s="object"!=typeof e.headers||Array.isArray(e.headers)?[]:Object.entries(e.headers).map(([e,r])=>({key:e,value:r})),o=Array.isArray(e.set_cookie)?(e.set_cookie||[]).filter(e=>"object"==typeof e&&!Array.isArray(e)&&e.key&&e.value):[],i=Array.isArray(e.rm_cookie)?(e.rm_cookie||[]).filter(e=>"object"==typeof e&&!Array.isArray(e)&&e.key):[],a=e.redirect||null;if(!e.data||e.error||!e||"object"!=typeof e||Array.isArray(e)){const r=this.message.error(e.error||"system:no-response-sending",e.params||[]);return{header:s,set_cookie:o,rm_cookie:i,status:t,redirect:a,error:e.error||"system:no-response-sending",response:{status:t,message:r.message,protocol:r.protocol,context:r.context,params:r.params}}}return{header:s,set_cookie:o,rm_cookie:i,status:t,redirect:a,error:null,response:{status:t,data:e.data||{}}}}async SystemAction({system:e,middleware:r={},type:t,data:s}){try{const o=this.registry.get(t||"");if(!o)return this.ResponseBuilder({error:"system:no-registry",status:404},e);if(Array.isArray(o)){const i=await o[0]({system:e,middleware:r,type:t,data:s});let a=i;i?.skipBuilder||(a=this.ResponseBuilder(i,e));const n=await o[1]({system:e,middleware:a,type:t,data:s});return this.ResponseBuilder(n,e)}const i=await o({system:e,middleware:r,type:t,data:s});return this.ResponseBuilder(i,e)}catch(r){return console.log("[Context Action Error Internal!]:",r),this.ResponseBuilder({error:"system:internal-server-error",status:500},e)}}async ServerAction({system:e,middleware:r,type:t,data:s}){return this.policy.apply().noaction_server.includes(t||"")?this.ResponseBuilder({error:"system:no-registry",status:404},e):this.SystemAction({system:e,middleware:r,type:t,data:s})}async APIAction({system:e,middleware:r,type:t,data:s}){return this.policy.apply().noaction_api.includes(t||"")?this.ResponseBuilder({error:"system:no-registry",status:404},e):this.SystemAction({system:e,middleware:r,type:t,data:s})}}
+import crypto from"crypto";import{Buffer}from"buffer";import extractLanguage from"../utils/extract-lang.js";export default class Actions{registry;message;policy;cache_book;constructor({registry:e,message:r,policy:t}){this.registry=e,this.message=r,this.policy=t,this.cache_book=null}BookRegistry(){if(this.cache_book)return this.cache_book;const e="hex",r=crypto.randomBytes(16),t=this.policy.apply(),s=this.registry.apply(),o=crypto.createHash("sha256").update(String(t.passkey||"").trim()).digest(),i={listkey:Object.keys(s).filter(e=>!t.noaction_api.includes(e)),version_now:t.version_now,version_min:t.version_min,version_forceupdate:t.version_forceupdate},a=crypto.createCipheriv("aes-256-ctr",o,r),n=Buffer.concat([r,a.update(JSON.stringify(i),"utf-8"),a.final()]),c={iv_length:16,type_base:e,iv:r.toString(e),data:n.toString(e)};return this.cache_book=c,c}ResponseBuilder(e={},r,t="en"){const s=!e||"object"!=typeof e||Array.isArray(e)||!!e.error||!e.data,o=e?.status||(s?400:200),i=e?.redirect||null,a=[];if(e?.headers&&"object"==typeof e.headers&&!Array.isArray(e.headers))for(const[r,t]of Object.entries(e.headers))a.push({key:r,value:t});const n=[];if(Array.isArray(e?.set_cookie))for(const r of e.set_cookie)r&&"object"==typeof r&&r.key&&r.value&&n.push(r);const c=[];if(Array.isArray(e?.rm_cookie))for(const r of e.rm_cookie)r&&"string"==typeof r&&c.push(r);const p={header:a,set_cookie:n,rm_cookie:c,status:o,redirect:i};if(s){const r=e?.error||"system:no-response-sending",s=this.message.error(r,e?.params||[],t);return{...p,error:r,response:{status:o,message:s.message,protocol:s.protocol,context:s.context,params:s.params}}}return{...p,error:null,response:{status:o,data:e.data||{}}}}async SystemAction({system:e,middleware:r={},context_manager:t="system-action",type:s,data:o}){const i=e?.headers||{},a=i["x-seishiro-lang"]||i["accept-language"],n=a?extractLanguage(a):e?.lang||"en";try{const a=this.policy.apply(),c=i["x-seishiro-client"];if("api-action"===t&&!c)return this.ResponseBuilder({error:"system:client-version-required",status:400},e,n);if(c&&"api-action"===t){const r=this.policy.version_info(c);if(!r.is_version_min&&r.info_upgrade)return this.ResponseBuilder({error:"system:need-upgrade-client",status:426,params:[{min:a.version_min,now:a.version_now}]},e,n)}const p=this.registry.get(s||"");if(!p)return this.ResponseBuilder({error:"system:no-registry",status:404},e,n);const y={...e,lang:n};let l=r,u=p;if(Array.isArray(p)){const[e,t]=p,i=await e({system:y,middleware:r,type:s,data:o});l=a.skip_middleware_context||i?.skipBuilder?i:this.ResponseBuilder(i,y,n),u=t}const d=await u({system:y,middleware:l,type:s,data:o});return this.ResponseBuilder(d,y,n)}catch(r){return console.error("[Seishiro Core Error]:",r),this.ResponseBuilder({error:"system:internal-server-error",status:500},e,n)}}async ServerAction({system:e,middleware:r,type:t,data:s}){if(this.policy.apply().noaction_server.includes(t||"")){const r=extractLanguage(e?.headers?.["x-seishiro-lang"]||e?.headers?.["accept-language"]||e?.lang||"en");return this.ResponseBuilder({error:"system:no-registry",status:404},e,r)}return this.SystemAction({system:e,middleware:r,context_manager:"server-action",type:t,data:s})}async APIAction({system:e,middleware:r,type:t,data:s}){if(this.policy.apply().noaction_api.includes(t||"")){const r=extractLanguage(e?.headers?.["x-seishiro-lang"]||e?.headers?.["accept-language"]||e?.lang||"en");return this.ResponseBuilder({error:"system:no-registry",status:404},e,r)}return this.SystemAction({system:e,middleware:r,context_manager:"api-action",type:t,data:s})}}

package/esm/lib/message.d.ts

@@ -1,4 +1,4 @@
-import type { MessageKey, MessageValue, MessageLang, MessageLogic, MessageLogicLang, MessageErrorContext, MessageErrorContextOpt, MessageErrorContextSlug } from "../types/message.type";
+import type { MessageKey, MessageValue, MessageLang, MessageLogic, MessageLogicLang, MessageErrorContext, MessageErrorContextOpt, MessageErrorContextSlug } from "../types/message.type.js";
 /**
  * @class MessageBuilder
  * @description Handles multi-language response messages, error formatting, and dynamic template replacement.
@@ -50,7 +50,7 @@ export default class MessageBuilder {
     error(errorStr?: MessageErrorContext, errorOpts?: MessageErrorContextOpt[], lang?: MessageLang): {
         protocol: string;
         context: string[];
-        params: object[];
+        params: MessageErrorContextOpt[];
         message: string;
     };
     /**

package/esm/lib/message.js

@@ -1 +1 @@
-import formatKey from"../utils/format-key";import{DefaultLanguage}from"../constants/message";export default class MessageBuilder{message_build_lang="";message_logic={};constructor(e="en"){this.message_build_lang=String(e||"en").toLowerCase().replace(/[^a-z]/g,"").slice(0,2),this.message_logic={}}set(e,s){const t=formatKey(e);if("string"!=typeof s)throw new Error("Message value is only type string!");if("string"!=typeof e)throw new Error("Message key is only type string!");this.message_logic[this.message_build_lang]||(this.message_logic[this.message_build_lang]={}),this.message_logic[this.message_build_lang][t]=String(s).trim()}get(e="",s=this.message_build_lang){const t=formatKey(e);let g=s;return this.message_logic[g]||(console.warn("[Debugging Message]: Language not found on logic, using default language!"),g=this.message_logic[DefaultLanguage]?DefaultLanguage:Object.keys(this.message_logic||{})[0]),this.message_logic[g]?String(this.message_logic[g][t]||"").trim():(console.warn("[Debugging Message]: Language or variable not found on logic!"),String(`[!NoneVariable ${t}]`))}errorMessage(e="",s={},t=this.message_build_lang){let g=this.get(e,t);return Object.keys(s||{}).forEach(e=>{const t=s[e]||"",a=new RegExp(`{{${e}}}`,"g");g=g.replace(a,t)}),g}error(e="",s=[],t=this.message_build_lang){const[g,...a]=String(e||"").split(":"),i=String(a.join(":")).split("|"),o=i.map((e,g)=>{const a=s[g];return this.errorMessage(e,a,t)}).join(", ");return{protocol:formatKey(g),context:i,params:s,message:o}}apply(){return this.message_logic}use(e){if(e instanceof MessageBuilder){const s=e.apply();for(const e in s)if(Object.prototype.hasOwnProperty.call(s,e)){const t=s[e];this.message_logic[e]||(this.message_logic[e]={}),Object.assign(this.message_logic[e],t)}}else{if("object"!=typeof e||null===e)throw new Error('The "use" input must be a MessageBuilder or mapping object!');for(const s in e)Object.prototype.hasOwnProperty.call(e,s)&&this.set(s,e[s])}}}
+import formatKey from"../utils/format-key.js";import{DefaultLanguage}from"../constants/message.js";export default class MessageBuilder{message_build_lang="";message_logic=new Map;constructor(e="en"){this.message_build_lang=String(e||"en").toLowerCase().replace(/[^a-z]/g,"").slice(0,2),this.message_logic=new Map}set(e,s){if("string"!=typeof s||"string"!=typeof e)throw new Error("Key and Value must be string!");const t=formatKey(e);this.message_logic.has(this.message_build_lang)||this.message_logic.set(this.message_build_lang,new Map),this.message_logic.get(this.message_build_lang).set(t,s.trim())}get(e="",s=this.message_build_lang){const t=formatKey(e);let a=this.message_logic.get(s);return a||(a=this.message_logic.get(DefaultLanguage),!a&&this.message_logic.size>0&&(a=this.message_logic.values().next().value)),a?a.get(t)||"":`[!NoneVariable ${t}]`}errorMessage(e="",s={},t=this.message_build_lang){const a=this.get(e,t);return s&&0!==Object.keys(s).length?a.replace(/{{(\w+)}}/g,(e,t)=>s[t]||e):a}error(e="",s=[],t=this.message_build_lang){const a=e.indexOf(":");if(-1===a)return{protocol:"unknown",context:[e],params:s,message:e};const g=formatKey(e.substring(0,a)),i=e.substring(a+1).split("|");let r="";for(let e=0;e<i.length;e++){r+=(0===e?"":", ")+this.errorMessage(i[e],s[e],t)}return{protocol:g,context:i,params:s,message:r}}apply(){return this.message_logic}use(e){if(e instanceof MessageBuilder){e.apply().forEach((e,s)=>{let t=this.message_logic.get(s);t||(t=new Map,this.message_logic.set(s,t)),e.forEach((e,s)=>{t.set(s,e)})})}else{if("object"!=typeof e||null===e)throw new Error('The "use" input must be a MessageBuilder or mapping object!');for(const s in e)Object.prototype.hasOwnProperty.call(e,s)&&this.set(s,e[s])}}}

package/esm/lib/policy.d.ts

@@ -1,4 +1,4 @@
-import { PolicyNoActionAPIAction, PolicyNoActionServerAction, PolicyNoActionKey, PolicyNoActionBase } from "../types/policy.type";
+import { PolicyNoActionKey, PolicyNoActionBase } from "../types/policy.type.js";
 /**
  * @class PolicyBuilder
  * @description Manages application policies including security passkeys, version control,
@@ -11,6 +11,10 @@ export default class PolicyBuilder {
     private version_forceupdate;
     private noaction_api;
     private noaction_server;
+    private compiled_policy;
+    private skip_middleware_context;
+    private parsed_min;
+    private parsed_now;
     /**
      * @constructor
      * @param {Object} config - The policy configuration.
@@ -20,11 +24,12 @@ export default class PolicyBuilder {
      * @param {boolean} [config.version_forceupdate=true] - Flag to indicate if clients below version_min must update.
      * @throws {Error} If passkey, version_now, or version_min is missing.
      */
-    constructor({ passkey, version_now, version_min, version_forceupdate, }: {
+    constructor({ passkey, version_now, version_min, version_forceupdate, skip_middleware_context, }: {
         passkey: string;
         version_now: string;
         version_min: string;
         version_forceupdate?: boolean;
+        skip_middleware_context?: boolean;
     });
     /**
      * @method noaction
@@ -34,37 +39,28 @@ export default class PolicyBuilder {
      * @throws {Error} If the protocol type is invalid or the key is not a string.
      */
     noaction(type?: PolicyNoActionKey, action?: PolicyNoActionBase): void;
-    /**
-     * @method compareVersions
-     * @private
-     * @description Compares two semantic version strings to determine their order.
-     * @param {string} v1 - First version string.
-     * @param {string} v2 - Second version string.
-     * @returns {number} 1 if v1 > v2, -1 if v1 < v2, and 0 if they are equal.
-     */
-    private compareVersions;
+    private parseVersion;
+    private compare;
     /**
      * @method version_info
      * @description Checks a provided version against the minimum and current version requirements.
      * @param {string} [version=""] - The version string to validate (usually from the client).
      * @returns {Object} An object containing upgrade flags and version compatibility status.
      */
-    version_info(version?: string): {
+    version_info(clientVersion?: string): {
         info_upgrade: boolean;
         is_version_min: boolean;
         is_version_now: boolean;
     };
+    /**
+     * @method refresh
+     * @description Refreshes the compiled policy.
+     */
+    private refresh;
     /**
      * @method apply
      * @description Retrieves the compiled policy configuration.
      * @returns {Object} All policy settings including restricted actions and versioning data.
      */
-    apply(): {
-        passkey: string;
-        version_now: string;
-        version_min: string;
-        version_forceupdate: boolean;
-        noaction_api: PolicyNoActionAPIAction;
-        noaction_server: PolicyNoActionServerAction;
-    };
+    apply(): any;
 }

package/esm/lib/policy.js

@@ -1 +1 @@
-export default class PolicyBuilder{passkey;version_now;version_min;version_forceupdate;noaction_api;noaction_server;constructor({passkey:i,version_now:o,version_min:n,version_forceupdate:e=!0}){if(!i||!o||!n)throw new Error("PolicyBuilder: passkey, version_now, and version_min are required!");this.passkey=i,this.version_now=o,this.version_min=n,this.version_forceupdate=e,this.noaction_api=[],this.noaction_server=[]}noaction(i="",o=[]){const n=["server-action","api-action"];for(let i of o)if(!n.includes(i))throw new Error(`Invalid action type: ${i}. Only allowed actions are: ${n.join(", ")}`);if("string"!=typeof i)throw new Error("Invalid key type, it only string!");for(let n of o)"api-action"===n?this.noaction_api.push(i):"server-action"===n&&this.noaction_server.push(i)}compareVersions(i,o){const n=i=>i.replace(/-.*$/,""),e=n(i).split(".").map(Number),r=n(o).split(".").map(Number);for(let i=0;i<Math.max(e.length,r.length);i++){const o=e[i]||0,n=r[i]||0;if(o>n)return 1;if(o<n)return-1}return 0}version_info(i=""){const o=this.compareVersions(i,this.version_min)>=0,n=this.compareVersions(i,this.version_now)>=0;return{info_upgrade:this.version_forceupdate,is_version_min:o,is_version_now:n}}apply(){return{passkey:this.passkey,version_now:this.version_now,version_min:this.version_min,version_forceupdate:this.version_forceupdate,noaction_api:this.noaction_api,noaction_server:this.noaction_server}}}
+export default class PolicyBuilder{passkey;version_now;version_min;version_forceupdate;noaction_api;noaction_server;compiled_policy=null;skip_middleware_context;parsed_min;parsed_now;constructor({passkey:i,version_now:e,version_min:o,version_forceupdate:s=!0,skip_middleware_context:n=!1}){if(!i||!e||!o)throw new Error("PolicyBuilder: passkey, version_now, and version_min are required!");this.passkey=i,this.version_now=e,this.version_min=o,this.parsed_min=this.parseVersion(o),this.parsed_now=this.parseVersion(e),this.version_forceupdate=s,this.noaction_api=[],this.noaction_server=[],this.skip_middleware_context=n,this.refresh()}noaction(i="",e=[]){const o=["server-action","api-action"];for(let i of e)if(!o.includes(i))throw new Error(`Invalid action type: ${i}. Only allowed actions are: ${o.join(", ")}`);if("string"!=typeof i)throw new Error("Invalid key type, it only string!");for(let o of e)"api-action"===o?this.noaction_api.push(i):"server-action"===o&&this.noaction_server.push(i)}parseVersion(i){return i.split(".").map(Number)}compare(i,e){const o=Math.max(i.length,e.length);for(let s=0;s<o;s++){const o=i[s]||0,n=e[s]||0;if(o!==n)return o>n?1:-1}return 0}version_info(i=""){const e=this.parseVersion(i);return{info_upgrade:this.version_forceupdate,is_version_min:this.compare(e,this.parsed_min)>=0,is_version_now:this.compare(e,this.parsed_now)>=0}}refresh(){this.compiled_policy={passkey:this.passkey,version_now:this.version_now,version_min:this.version_min,version_forceupdate:this.version_forceupdate,noaction_api:this.noaction_api,noaction_server:this.noaction_server,skip_middleware_context:this.skip_middleware_context}}apply(){return this.compiled_policy}}

package/esm/lib/registry.d.ts

@@ -1,4 +1,4 @@
-import type { RegistryKey, RegistryFunction, RegistryLogic, RegistryMiddleware } from "../types/registry.type";
+import type { RegistryKey, RegistryFunction, RegistryLogic, RegistryMiddleware } from "../types/registry.type.js";
 /**
  * @class RegistryBuilder
  * @description Centralizes the mapping of unique action keys to their respective controllers

package/esm/lib/registry.js

@@ -1 +1 @@
-import formatKey from"../utils/format-key";export default class RegistryBuilder{registry_logic={};constructor(){this.registry_logic={}}set(t,r,e){const i=formatKey(t);if("function"!=typeof r)throw new Error("Registry function is only type function!");if("string"!=typeof t)throw new Error("Registry key is only type string!");this.registry_logic[i]=e&&"function"==typeof e?[e,r]:r}get(t){const r=formatKey(t);return this.registry_logic[r]||void 0}apply(){return this.registry_logic}use(t){const r=t instanceof RegistryBuilder?t.registry_logic:t;if("object"!=typeof r||null===r)throw new Error('The "use" input must be a RegistryBuilder or mapping object!');Object.entries(r).forEach(([t,r])=>{if(Array.isArray(r)){const[e,i]=r;this.set(t,i,e)}else"function"==typeof r&&this.set(t,r)})}}
+import formatKey from"../utils/format-key.js";export default class RegistryBuilder{registry_logic;constructor(){this.registry_logic=new Map}set(t,r,e){const i=formatKey(t);if("function"!=typeof r)throw new Error("Registry function is only type function!");if("string"!=typeof t)throw new Error("Registry key is only type string!");e&&"function"==typeof e?this.registry_logic.set(i,[e,r]):this.registry_logic.set(i,r)}get(t){const r=formatKey(t);return this.registry_logic.get(r)||void 0}apply(){return this.registry_logic}use(t){if(t instanceof RegistryBuilder)for(const[r,e]of t.registry_logic)this.registry_logic.set(r,e);else{if("object"!=typeof t||null===t)throw new Error('The "use" input must be a RegistryBuilder or mapping object!');for(const[r,e]of Object.entries(t))Array.isArray(e)?this.set(r,e[1],e[0]):"function"==typeof e&&this.set(r,e)}}}

package/esm/types/actions.types.d.ts

@@ -0,0 +1,6 @@
+export type cacheBookType = {
+    iv_length: number;
+    type_base: string;
+    iv: string;
+    data: string;
+} | null;

package/esm/types/actions.types.js

@@ -0,0 +1 @@
+export{};

package/esm/types/message.type.d.ts

@@ -3,11 +3,7 @@ export type MessageLang = string | "en" | "id";
 export type MessageValue = string;
 export type MessageErrorContext = string;
 export type MessageErrorContextSlug = string;
-export type MessageErrorContextOpt = object;
+export type MessageErrorContextOpt = Record<string, string>;
 export type MessageErrorContextTrack = string;
-export type MessageLogicLang = {
-    [key: MessageLang]: {
-        [key: MessageKey]: MessageValue;
-    };
-};
+export type MessageLogicLang = Map<MessageLang, Map<MessageKey, MessageValue>>;
 export type MessageLogic = Record<MessageKey, MessageValue>;

package/esm/types/registry.type.d.ts

@@ -1,16 +1,21 @@
 export type RegistryKey = string;
 export type RegistryParams = {
     system: {
-        cookies: object;
-        headers: object;
+        cookies: {
+            [key: string]: any;
+        };
+        headers: {
+            [key: string]: any;
+        };
         ip: string;
         location: string;
         lang: string | "en";
     };
     type: RegistryKey;
+    context_manager?: string;
     middleware?: object | Function | Promise<any>;
     data: object;
 };
 export type RegistryFunction = (params: RegistryParams) => any;
 export type RegistryMiddleware = (params: RegistryParams) => any;
-export type RegistryLogic = Record<RegistryKey, RegistryFunction | [RegistryMiddleware, RegistryFunction]>;
+export type RegistryLogic = Map<RegistryKey, RegistryFunction | [RegistryMiddleware, RegistryFunction]>;

package/esm/utils/extract-lang.d.ts

@@ -8,4 +8,4 @@
  * extractLanguage("en-GB,en-US;q=0.9,id;q=0.8")
  * // returns ["en", "id"]
  */
-declare function extractLanguage(lang?: string): string[];
+export default function extractLanguage(lang?: string): string;

package/esm/utils/extract-lang.js

@@ -1 +1 @@
-"use strict";function extractLanguage(t=""){return String(t||"").trim().split(",").map(t=>t.split(";")[0].split("-")[0].trim()).filter((t,i,r)=>r.indexOf(t)===i)}
+export default function extractLanguage(t=""){return String(t||"").trim().split(",").map(t=>t.split(";")[0].split("-")[0].trim()).filter((t,i,r)=>r.indexOf(t)===i)[0]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seishiro",
-  "version": "0.1.90-dev",
+  "version": "0.2.1-release",
   "description": "A simple response context API that eliminates the complexity of routing folder structures and replaces them with a single control center.",
   "type": "module",
   "main": "./cjs/index.js",
@@ -31,5 +31,18 @@
     "@types/node": "^25.2.2",
     "glob": "^13.0.2",
     "terser": "^5.46.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ernestoyoofi/seishiro.git"
+  },
+  "homepage": "https://github.com/ernestoyoofi/seishiro#readme",
+  "keywords": [
+    "api",
+    "context",
+    "seishiro"
+  ],
+  "bugs": {
+    "url": "https://github.com/ernestoyoofi/seishiro/issues"
   }
 }

package/cjs/constants/message.d.ts

@@ -1 +0,0 @@
-export declare const DefaultLanguage: string;

package/cjs/constants/registry.d.ts

@@ -1,3 +0,0 @@
-export declare const ServerAction: string;
-export declare const APIAction: string;
-export declare const PolicyAction: string[];

package/cjs/index.d.ts

@@ -1,4 +0,0 @@
-export { default as RegistryBuilder } from "./lib/registry";
-export { default as MessageBuilder } from "./lib/message";
-export { default as PolicyBuilder } from "./lib/policy";
-export { default as Actions } from "./lib/actions";

package/cjs/lib/actions.d.ts

@@ -1,178 +0,0 @@
-import { RegistryParams } from "../types/registry.type";
-import RegistryBuilder from "./registry";
-import MessageBuilder from "./message";
-import PolicyBuilder from "./policy";
-/**
- * @class Actions
- * @description The main orchestrator of the Seishiro API. It handles the execution flow
- * by coordinating between Registry, Message, and Policy builders across different protocols.
- */
-export default class Actions {
-    private registry;
-    private message;
-    private policy;
-    /**
-     * @constructor
-     * @param {Object} params - Configuration instances.
-     * @param {RegistryBuilder} params.registry - Instance to manage route/controller mapping.
-     * @param {MessageBuilder} params.message - Instance to handle localized error/response messages.
-     * @param {PolicyBuilder} params.policy - Instance to manage security and versioning rules.
-     */
-    constructor({ registry, message, policy, }: {
-        registry: RegistryBuilder;
-        message: MessageBuilder;
-        policy: PolicyBuilder;
-    });
-    /**
-     * @method BookRegistry
-     * @description Generates an encrypted list of available API registries and application versions.
-     * This is used to securely expose allowed actions to the client side.
-     * @returns {Object} An object containing encryption metadata (iv, type_base) and the encrypted 'data' string.
-     */
-    BookRegistry(): {
-        iv_length: number;
-        type_base: string;
-        iv: string;
-        data: string;
-    };
-    /**
-     * @method ResponseBuilder
-     * @private
-     * @description Standardizes the response structure for all action types, handling headers, cookies, and errors.
-     * @param {any} dataRes - The raw result or error object from the controller/middleware.
-     * @param {RegistryParams["system"]} system - The system context (headers, cookies, ip, etc.) from the request.
-     * @returns {Object} A unified response object containing headers, cookies, status code, and the final data/error payload.
-     */
-    private ResponseBuilder;
-    /**
-     * @method SystemAction
-     * @description The core execution engine that processes controllers and middlewares.
-     * @param {RegistryParams} params - The request payload containing system info, type, data, and optional middleware state.
-     * @returns {Promise<Object>} A promise that resolves to a standardized response object via ResponseBuilder.
-     */
-    SystemAction({ system, middleware, type, data }: RegistryParams): Promise<{
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
-        error: any;
-        response: {
-            status: any;
-            message: string;
-            protocol: string;
-            context: string[];
-            params: object[];
-            data?: undefined;
-        };
-    } | {
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
-        error: null;
-        response: {
-            status: any;
-            data: any;
-            message?: undefined;
-            protocol?: undefined;
-            context?: undefined;
-            params?: undefined;
-        };
-    }>;
-    /**
-     * @method ServerAction
-     * @description Entry point for Server-side actions (e.g., Next.js Server Actions).
-     * It checks against server-specific policies before executing.
-     * @param {RegistryParams} params - The request payload.
-     * @returns {Promise<Object>} The standardized response or a 404 error if the action is restricted by policy.
-     */
-    ServerAction({ system, middleware, type, data }: RegistryParams): Promise<{
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
-        error: any;
-        response: {
-            status: any;
-            message: string;
-            protocol: string;
-            context: string[];
-            params: object[];
-            data?: undefined;
-        };
-    } | {
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
-        error: null;
-        response: {
-            status: any;
-            data: any;
-            message?: undefined;
-            protocol?: undefined;
-            context?: undefined;
-            params?: undefined;
-        };
-    }>;
-    /**
-     * @method APIAction
-     * @description Entry point for REST API requests.
-     * It checks against API-specific policies to prevent unauthorized access to sensitive endpoints.
-     * @param {RegistryParams} params - The request payload.
-     * @returns {Promise<Object>} The standardized response or a 404 error if the action is restricted by policy.
-     */
-    APIAction({ system, middleware, type, data }: RegistryParams): Promise<{
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
-        error: any;
-        response: {
-            status: any;
-            message: string;
-            protocol: string;
-            context: string[];
-            params: object[];
-            data?: undefined;
-        };
-    } | {
-        header: {
-            key: string;
-            value: unknown;
-        }[];
-        set_cookie: any;
-        rm_cookie: any;
-        status: any;
-        redirect: any;
-        error: null;
-        response: {
-            status: any;
-            data: any;
-            message?: undefined;
-            protocol?: undefined;
-            context?: undefined;
-            params?: undefined;
-        };
-    }>;
-}

package/cjs/lib/message.d.ts

@@ -1,69 +0,0 @@
-import type { MessageKey, MessageValue, MessageLang, MessageLogic, MessageLogicLang, MessageErrorContext, MessageErrorContextOpt, MessageErrorContextSlug } from "../types/message.type";
-/**
- * @class MessageBuilder
- * @description Handles multi-language response messages, error formatting, and dynamic template replacement.
- * It allows the application to return consistent, localized messages across different platforms.
- */
-export default class MessageBuilder {
-    private message_build_lang;
-    private message_logic;
-    /**
-     * @constructor
-     * @param {MessageLang} [language="en"] - The default language code (e.g., 'en', 'id').
-     * It will be sanitized to a 2-character lowercase string.
-     */
-    constructor(language?: MessageLang);
-    /**
-     * @method set
-     * @description Registers a specific message template for the current active language.
-     * @param {MessageKey} key - The unique identifier for the message.
-     * @param {MessageValue} value - The message string (supports {{variable}} placeholders).
-     * @throws {Error} If key or value is not a string.
-     */
-    set(key: MessageKey, value: MessageValue): void;
-    /**
-     * @method get
-     * @description Retrieves a raw message template based on the key and language.
-     * Falls back to the default language if the requested language is not found.
-     * @param {MessageKey} [key=""] - The message identifier to look up.
-     * @param {MessageLang} [lang=this.message_build_lang] - Optional language override.
-     * @returns {MessageValue} The raw message string or a fallback indicator if not found.
-     */
-    get(key?: MessageKey, lang?: MessageLang): MessageValue;
-    /**
-     * @method errorMessage
-     * @description Processes a template by replacing {{key}} placeholders with actual values.
-     * @param {MessageErrorContextSlug} [errorSlug=""] - The message key/slug.
-     * @param {MessageErrorContextOpt} [errorOpt={}] - Object containing key-value pairs for replacement.
-     * @param {MessageLang} [lang=this.message_build_lang] - The language to use.
-     * @returns {string} The fully formatted message string.
-     */
-    errorMessage(errorSlug?: MessageErrorContextSlug, errorOpt?: MessageErrorContextOpt, lang?: MessageLang): string;
-    /**
-     * @method error
-     * @description Parses a complex error string (protocol:slug|slug) and returns a structured error object.
-     * @param {MessageErrorContext} [errorStr=""] - The raw error string (e.g., "auth:user-not-found").
-     * @param {MessageErrorContextOpt[]} [errorOpts=[]] - Array of option objects for multiple slugs.
-     * @param {MessageLang} [lang=this.message_build_lang] - The target language.
-     * @returns {Object} Structured error containing protocol, context array, params, and the final joined message.
-     */
-    error(errorStr?: MessageErrorContext, errorOpts?: MessageErrorContextOpt[], lang?: MessageLang): {
-        protocol: string;
-        context: string[];
-        params: object[];
-        message: string;
-    };
-    /**
-     * @method apply
-     * @description Returns the entire compiled message logic object.
-     * @returns {MessageLogicLang} The internal storage of languages and their messages.
-     */
-    apply(): MessageLogicLang;
-    /**
-     * @method use
-     * @description Merges messages from another MessageBuilder instance or a plain object into the current one.
-     * @param {MessageBuilder | MessageLogic} input - The source of new messages.
-     * @throws {Error} If the input type is invalid.
-     */
-    use(input: MessageBuilder | MessageLogic): void;
-}

package/cjs/lib/policy.d.ts

@@ -1,70 +0,0 @@
-import { PolicyNoActionAPIAction, PolicyNoActionServerAction, PolicyNoActionKey, PolicyNoActionBase } from "../types/policy.type";
-/**
- * @class PolicyBuilder
- * @description Manages application policies including security passkeys, version control,
- * and protocol-specific action restrictions (Gatekeeping).
- */
-export default class PolicyBuilder {
-    private passkey;
-    private version_now;
-    private version_min;
-    private version_forceupdate;
-    private noaction_api;
-    private noaction_server;
-    /**
-     * @constructor
-     * @param {Object} config - The policy configuration.
-     * @param {string} config.passkey - Secret key used for registry encryption (SHA-256).
-     * @param {string} config.version_now - The current stable version of the application.
-     * @param {string} config.version_min - The minimum required version for clients to operate.
-     * @param {boolean} [config.version_forceupdate=true] - Flag to indicate if clients below version_min must update.
-     * @throws {Error} If passkey, version_now, or version_min is missing.
-     */
-    constructor({ passkey, version_now, version_min, version_forceupdate, }: {
-        passkey: string;
-        version_now: string;
-        version_min: string;
-        version_forceupdate?: boolean;
-    });
-    /**
-     * @method noaction
-     * @description Restricts specific action types from being accessed via certain protocols.
-     * @param {PolicyNoActionKey} [type=""] - The registry key/action type to restrict.
-     * @param {PolicyNoActionBase} [action=[]] - Array of protocols to block ('server-action' or 'api-action').
-     * @throws {Error} If the protocol type is invalid or the key is not a string.
-     */
-    noaction(type?: PolicyNoActionKey, action?: PolicyNoActionBase): void;
-    /**
-     * @method compareVersions
-     * @private
-     * @description Compares two semantic version strings to determine their order.
-     * @param {string} v1 - First version string.
-     * @param {string} v2 - Second version string.
-     * @returns {number} 1 if v1 > v2, -1 if v1 < v2, and 0 if they are equal.
-     */
-    private compareVersions;
-    /**
-     * @method version_info
-     * @description Checks a provided version against the minimum and current version requirements.
-     * @param {string} [version=""] - The version string to validate (usually from the client).
-     * @returns {Object} An object containing upgrade flags and version compatibility status.
-     */
-    version_info(version?: string): {
-        info_upgrade: boolean;
-        is_version_min: boolean;
-        is_version_now: boolean;
-    };
-    /**
-     * @method apply
-     * @description Retrieves the compiled policy configuration.
-     * @returns {Object} All policy settings including restricted actions and versioning data.
-     */
-    apply(): {
-        passkey: string;
-        version_now: string;
-        version_min: string;
-        version_forceupdate: boolean;
-        noaction_api: PolicyNoActionAPIAction;
-        noaction_server: PolicyNoActionServerAction;
-    };
-}

package/cjs/lib/registry.d.ts

@@ -1,46 +0,0 @@
-import type { RegistryKey, RegistryFunction, RegistryLogic, RegistryMiddleware } from "../types/registry.type";
-/**
- * @class RegistryBuilder
- * @description Centralizes the mapping of unique action keys to their respective controllers
- * and optional middlewares. It acts as the routing table for the Seishiro API system.
- */
-export default class RegistryBuilder {
-    private registry_logic;
-    /**
-     * @constructor
-     * @description Initializes an empty registry storage.
-     */
-    constructor();
-    /**
-     * @method set
-     * @description Registers a controller and an optional middleware to a specific key.
-     * If a middleware is provided, the registry will store them as an array [middleware, function].
-     * @param {RegistryKey} key - The unique identifier for the action (e.g., 'user:login').
-     * @param {RegistryFunction} function_regis - The main controller function to execute.
-     * @param {RegistryMiddleware} [middleware] - Optional middleware function to execute before the main controller.
-     * @throws {Error} If the controller is not a function or the key is not a string.
-     */
-    set(key: RegistryKey, function_regis: RegistryFunction, middleware?: RegistryMiddleware): void;
-    /**
-     * @method get
-     * @description Retrieves the registered function(s) associated with a specific key.
-     * @param {RegistryKey} key - The key to look up in the registry.
-     * @returns {RegistryFunction | [RegistryMiddleware, RegistryFunction] | undefined}
-     * Returns a single function, an array containing [middleware, controller], or undefined if not found.
-     */
-    get(key: RegistryKey): RegistryFunction | [RegistryMiddleware, RegistryFunction] | undefined;
-    /**
-     * @method apply
-     * @description Returns the raw internal registry logic mapping.
-     * @returns {RegistryLogic} The complete object mapping of keys to functions/middlewares.
-     */
-    apply(): RegistryLogic;
-    /**
-     * @method use
-     * @description Merges another RegistryBuilder instance or a raw registry object into the current instance.
-     * This is useful for modularizing routes across different files.
-     * @param {RegistryBuilder | RegistryLogic} input - The source registry to be merged.
-     * @throws {Error} If the input is not a RegistryBuilder instance or a valid mapping object.
-     */
-    use(input: RegistryBuilder | RegistryLogic): void;
-}

package/cjs/types/message.type.d.ts

@@ -1,13 +0,0 @@
-export type MessageKey = string;
-export type MessageLang = string | "en" | "id";
-export type MessageValue = string;
-export type MessageErrorContext = string;
-export type MessageErrorContextSlug = string;
-export type MessageErrorContextOpt = object;
-export type MessageErrorContextTrack = string;
-export type MessageLogicLang = {
-    [key: MessageLang]: {
-        [key: MessageKey]: MessageValue;
-    };
-};
-export type MessageLogic = Record<MessageKey, MessageValue>;

package/cjs/types/policy.type.d.ts

@@ -1,10 +0,0 @@
-export type PolicyPassKey = string;
-export type PolicyVersionNow = string;
-export type PolicyVersionMin = string;
-export type PolicyVersionForceUpdate = boolean;
-export type PolicyNoActionKey = string;
-type AllowedActions = "server-action" | "api-action";
-export type PolicyNoActionBase = AllowedActions[];
-export type PolicyNoActionAPIAction = string[];
-export type PolicyNoActionServerAction = string[];
-export {};

package/cjs/types/registry.type.d.ts

@@ -1,16 +0,0 @@
-export type RegistryKey = string;
-export type RegistryParams = {
-    system: {
-        cookies: object;
-        headers: object;
-        ip: string;
-        location: string;
-        lang: string | "en";
-    };
-    type: RegistryKey;
-    middleware?: object | Function | Promise<any>;
-    data: object;
-};
-export type RegistryFunction = (params: RegistryParams) => any;
-export type RegistryMiddleware = (params: RegistryParams) => any;
-export type RegistryLogic = Record<RegistryKey, RegistryFunction | [RegistryMiddleware, RegistryFunction]>;

package/cjs/utils/extract-lang.d.ts

@@ -1,11 +0,0 @@
-/**
- * @function extractLanguage
- * @description Parses the HTTP 'Accept-Language' header string into a clean array of unique language codes.
- * It handles weights (q-values) and sub-tags (e.g., 'en-US' becomes 'en') to simplify language matching.
- * * @param {string} [lang=""] - The raw Accept-Language header string (e.g., "en-US,en;q=0.9,id;q=0.8").
- * @returns {string[]} An array of unique, two-letter language codes (e.g., ["en", "id"]).
- * * @example
- * extractLanguage("en-GB,en-US;q=0.9,id;q=0.8")
- * // returns ["en", "id"]
- */
-declare function extractLanguage(lang?: string): string[];

package/cjs/utils/format-key.d.ts

@@ -1,13 +0,0 @@
-/**
- * @function formatKey
- * @description Sanitizes and standardizes a string key by removing whitespace and illegal characters.
- * It ensures that keys used in Registry, Message, and Policy builders remain consistent
- * and safe for object property mapping.
- * * @param {string} [strkey=""] - The raw string key to be formatted.
- * @param {string} Returns a sanitized string containing only alphanumeric characters,
- * hyphens (-), dots (.), and colons (:).
- * * @example
- * formatKey(" user:login @") // returns "user:login"
- * formatKey("System-Error!") // returns "System-error"
- */
-export default function formatKey(strkey?: string): string;