seishiro 0.1.8-dev → 0.1.85-dev

package/cjs/constants/message.js

@@ -1,4 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultLanguage = void 0;
-exports.DefaultLanguage = "en";
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.DefaultLanguage=void 0,exports.DefaultLanguage="en";

package/cjs/constants/registry.js

@@ -1,6 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PolicyAction = exports.APIAction = exports.ServerAction = void 0;
-exports.ServerAction = "server-action";
-exports.APIAction = "api-action";
-exports.PolicyAction = ["server-action", "api-action"];
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.PolicyAction=exports.APIAction=exports.ServerAction=void 0,exports.ServerAction="server-action",exports.APIAction="api-action",exports.PolicyAction=["server-action","api-action"];

package/cjs/index.js

@@ -1,14 +1 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Actions = exports.PolicyBuilder = exports.MessageBuilder = exports.RegistryBuilder = void 0;
-var registry_1 = require("./lib/registry");
-Object.defineProperty(exports, "RegistryBuilder", { enumerable: true, get: function () { return __importDefault(registry_1).default; } });
-var message_1 = require("./lib/message");
-Object.defineProperty(exports, "MessageBuilder", { enumerable: true, get: function () { return __importDefault(message_1).default; } });
-var policy_1 = require("./lib/policy");
-Object.defineProperty(exports, "PolicyBuilder", { enumerable: true, get: function () { return __importDefault(policy_1).default; } });
-var actions_1 = require("./lib/actions");
-Object.defineProperty(exports, "Actions", { enumerable: true, 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_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}});

package/cjs/lib/actions.js

@@ -1,207 +1 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const crypto_1 = __importDefault(require("crypto"));
-const buffer_1 = require("buffer");
-/**
- * @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.
- */
-class Actions {
-    registry;
-    message;
-    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, }) {
-        this.registry = registry;
-        this.message = message;
-        this.policy = policy;
-    }
-    /**
-     * @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() {
-        // Default Configuration
-        const algorithm = "aes-256-ctr";
-        const type_base = "hex";
-        const ivLength = 16;
-        const ivKey = crypto_1.default.randomBytes(ivLength);
-        // Dynamic Info
-        const policyInfo = this.policy.apply();
-        const registry = this.registry.apply();
-        const keyencrypt = crypto_1.default
-            .createHash("sha256")
-            .update(String(policyInfo.passkey || "").trim())
-            .digest();
-        // Data List
-        const buildRegistry = {
-            listkey: Object.keys(registry).filter((a) => !policyInfo.noaction_api.includes(a)),
-            version_now: policyInfo.version_now,
-            version_min: policyInfo.version_min,
-            version_forceupdate: policyInfo.version_forceupdate,
-        };
-        // Create Encrypted Data
-        const cipher = crypto_1.default.createCipheriv(algorithm, keyencrypt, ivKey);
-        const results = buffer_1.Buffer.concat([
-            ivKey,
-            cipher.update(JSON.stringify(buildRegistry), "utf-8"),
-            cipher.final(),
-        ]);
-        return {
-            iv_length: ivLength,
-            type_base: type_base,
-            iv: ivKey.toString(type_base),
-            data: results.toString(type_base),
-        };
-    }
-    /**
-     * @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.
-     */
-    ResponseBuilder(dataRes = {}, system) {
-        const responseStatus = dataRes.error
-            ? dataRes.status || 400
-            : dataRes.status || 200;
-        const setHeaders = typeof dataRes.headers === "object" && !Array.isArray(dataRes.headers)
-            ? Object.entries(dataRes.headers).map(([key, value]) => {
-                return {
-                    key: key,
-                    value: value,
-                };
-            })
-            : [];
-        const setCookie = Array.isArray(dataRes.set_cookie)
-            ? (dataRes.set_cookie || []).filter((a) => typeof a === "object" && !Array.isArray(a) && a.key && a.value)
-            : [];
-        const rmCookie = Array.isArray(dataRes.rm_cookie)
-            ? (dataRes.rm_cookie || []).filter((a) => typeof a === "object" && !Array.isArray(a) && a.key)
-            : [];
-        const redirect = dataRes.redirect || null;
-        if (dataRes.error || !dataRes || typeof dataRes !== "object") {
-            const buildingMessage = this.message.error(dataRes.error || "system:no-response-sending", []);
-            return {
-                header: setHeaders,
-                set_cookie: setCookie,
-                rm_cookie: rmCookie,
-                status: responseStatus,
-                redirect: redirect,
-                error: dataRes.error || "system:no-response-sending",
-                response: {
-                    status: responseStatus,
-                    message: buildingMessage.message,
-                    protocol: buildingMessage.protocol,
-                    context: buildingMessage.context,
-                    params: buildingMessage.params,
-                },
-            };
-        }
-        return {
-            header: setHeaders,
-            set_cookie: setCookie,
-            rm_cookie: rmCookie,
-            status: responseStatus,
-            redirect: redirect,
-            error: null,
-            response: {
-                status: responseStatus,
-                data: dataRes.data || {},
-            },
-        };
-    }
-    /**
-     * @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.
-     */
-    async SystemAction({ system, middleware = {}, type, data }) {
-        try {
-            const showregistry = this.registry;
-            const getregistry = showregistry.get(type || "");
-            if (!getregistry) {
-                return this.ResponseBuilder({
-                    error: "system:no-registry",
-                    status: 404,
-                }, system);
-            }
-            if (Array.isArray(getregistry)) {
-                const middlewareExecuted = await getregistry[0]({
-                    system,
-                    middleware,
-                    type,
-                    data,
-                });
-                const responsesMiddleware = this.ResponseBuilder(middlewareExecuted, system);
-                const executedResponse = await getregistry[1]({
-                    system,
-                    middleware: responsesMiddleware,
-                    type,
-                    data,
-                });
-                return this.ResponseBuilder(executedResponse, system);
-            }
-            const executedResponse = await getregistry({
-                system,
-                middleware,
-                type,
-                data,
-            });
-            return this.ResponseBuilder(executedResponse, system);
-        }
-        catch (error) {
-            return this.ResponseBuilder({
-                error: "system:internal-server-error",
-                status: 500,
-            }, system);
-        }
-    }
-    /**
-     * @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.
-     */
-    async ServerAction({ system, middleware, type, data }) {
-        if (this.policy.apply().noaction_server.includes(type || "")) {
-            return this.ResponseBuilder({
-                error: "system:no-registry",
-                status: 404,
-            }, system);
-        }
-        return this.SystemAction({ system, middleware, type, data });
-    }
-    /**
-     * @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.
-     */
-    async APIAction({ system, middleware, type, data }) {
-        if (this.policy.apply().noaction_api.includes(type || "")) {
-            return this.ResponseBuilder({
-                error: "system:no-registry",
-                status: 404,
-            }, system);
-        }
-        return this.SystemAction({ system, middleware, type, data });
-    }
-}
-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");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(),a={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},o=crypto_1.default.createCipheriv("aes-256-ctr",i,r),n=buffer_1.Buffer.concat([r,o.update(JSON.stringify(a),"utf-8"),o.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):[],a=Array.isArray(e.rm_cookie)?(e.rm_cookie||[]).filter(e=>"object"==typeof e&&!Array.isArray(e)&&e.key):[],o=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",[]);return{header:s,set_cookie:i,rm_cookie:a,status:t,redirect:o,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:a,status:t,redirect:o,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 a=await i[0]({system:e,middleware:r,type:t,data:s}),o=this.ResponseBuilder(a,e),n=await i[1]({system:e,middleware:o,type:t,data:s});return this.ResponseBuilder(n,e)}const a=await i({system:e,middleware:r,type:t,data:s});return this.ResponseBuilder(a,e)}catch(r){return 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;

package/cjs/lib/message.js

@@ -1,156 +1 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const format_key_1 = __importDefault(require("../utils/format-key"));
-const message_1 = require("../constants/message");
-/**
- * @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.
- */
-class MessageBuilder {
-    message_build_lang = "";
-    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 = "en") {
-        this.message_build_lang = String(language || "en")
-            .toLowerCase()
-            .replace(/[^a-z]/g, "")
-            .slice(0, 2);
-        this.message_logic = {};
-    }
-    /**
-     * @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, value) {
-        const keyStr = (0, format_key_1.default)(key);
-        if (typeof value !== "string") {
-            throw new Error("Message value is only type string!");
-        }
-        if (typeof key !== "string") {
-            throw new Error("Message key is only type string!");
-        }
-        if (!this.message_logic[this.message_build_lang]) {
-            this.message_logic[this.message_build_lang] = {};
-        }
-        this.message_logic[this.message_build_lang][keyStr] = String(value).trim();
-    }
-    /**
-     * @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 = "", lang = this.message_build_lang) {
-        const keyStr = (0, format_key_1.default)(key);
-        let langSupport = lang;
-        // Not Language On Logic
-        if (!this.message_logic[langSupport]) {
-            console.warn("[Debugging Message]: Language not found on logic, using default language!");
-            if (this.message_logic[message_1.DefaultLanguage]) {
-                langSupport = message_1.DefaultLanguage;
-            }
-            else {
-                langSupport = Object.keys(this.message_logic || {})[0];
-            }
-        }
-        if (!this.message_logic[langSupport]) {
-            console.warn("[Debugging Message]: Language or variable not found on logic!");
-            return String(`[!NoneVariable ${keyStr}]`);
-        }
-        // Return
-        return String(this.message_logic[langSupport][keyStr] || "").trim();
-    }
-    /**
-     * @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 = "", errorOpt = {}, lang = this.message_build_lang) {
-        let messageContext = this.get(errorSlug, lang);
-        Object.keys(errorOpt || {}).forEach((keys) => {
-            const values = errorOpt[keys] || "";
-            const pattern = new RegExp(`{{${keys}}}`, "g");
-            messageContext = messageContext.replace(pattern, values);
-        });
-        return messageContext;
-    }
-    /**
-     * @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 = "", errorOpts = [], lang = this.message_build_lang) {
-        const [protocol, ...messages] = String(errorStr || "").split(":");
-        const messageContext = String(messages.join(":")).split("|");
-        const messageArrayCtx = messageContext
-            .map((errorSlug, key) => {
-            const getOpt = errorOpts[key];
-            return this.errorMessage(errorSlug, getOpt, lang);
-        })
-            .join(", ");
-        return {
-            protocol: (0, format_key_1.default)(protocol),
-            context: messageContext,
-            params: errorOpts,
-            message: messageArrayCtx,
-        };
-    }
-    /**
-     * @method apply
-     * @description Returns the entire compiled message logic object.
-     * @returns {MessageLogicLang} The internal storage of languages and their messages.
-     */
-    apply() {
-        return this.message_logic;
-    }
-    /**
-     * @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) {
-        if (input instanceof MessageBuilder) {
-            const otherLogic = input.apply();
-            for (const lang in otherLogic) {
-                if (Object.prototype.hasOwnProperty.call(otherLogic, lang)) {
-                    const messages = otherLogic[lang];
-                    if (!this.message_logic[lang]) {
-                        this.message_logic[lang] = {};
-                    }
-                    Object.assign(this.message_logic[lang], messages);
-                }
-            }
-        }
-        else if (typeof input === "object" && input !== null) {
-            for (const key in input) {
-                if (Object.prototype.hasOwnProperty.call(input, key)) {
-                    this.set(key, input[key]);
-                }
-            }
-        }
-        else {
-            throw new Error('The "use" input must be a MessageBuilder or mapping object!');
-        }
-    }
-}
-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_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;

package/cjs/lib/policy.js

@@ -1,116 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * @class PolicyBuilder
- * @description Manages application policies including security passkeys, version control,
- * and protocol-specific action restrictions (Gatekeeping).
- */
-class PolicyBuilder {
-    passkey;
-    version_now;
-    version_min;
-    version_forceupdate;
-    noaction_api;
-    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 = true, }) {
-        if (!passkey || !version_now || !version_min) {
-            throw new Error("PolicyBuilder: passkey, version_now, and version_min are required!");
-        }
-        this.passkey = passkey;
-        this.version_now = version_now;
-        this.version_min = version_min;
-        this.version_forceupdate = version_forceupdate;
-        this.noaction_api = [];
-        this.noaction_server = [];
-    }
-    /**
-     * @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 = "", action = []) {
-        const onlyAllowed = ["server-action", "api-action"];
-        for (let actionRes of action) {
-            if (!onlyAllowed.includes(actionRes)) {
-                throw new Error(`Invalid action type: ${actionRes}. Only allowed actions are: ${onlyAllowed.join(", ")}`);
-            }
-        }
-        if (typeof type !== "string") {
-            throw new Error(`Invalid key type, it only string!`);
-        }
-        for (let actionRes of action) {
-            if (actionRes === "api-action") {
-                this.noaction_api.push(type);
-            }
-            else if (actionRes === "server-action") {
-                this.noaction_server.push(type);
-            }
-        }
-    }
-    /**
-     * @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.
-     */
-    compareVersions(v1, v2) {
-        const clean = (v) => v.replace(/-.*$/, "");
-        const p1 = clean(v1).split(".").map(Number);
-        const p2 = clean(v2).split(".").map(Number);
-        for (let i = 0; i < Math.max(p1.length, p2.length); i++) {
-            const n1 = p1[i] || 0;
-            const n2 = p2[i] || 0;
-            if (n1 > n2)
-                return 1;
-            if (n1 < n2)
-                return -1;
-        }
-        return 0;
-    }
-    /**
-     * @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 = "") {
-        const comparisonMin = this.compareVersions(version, this.version_min);
-        const comparisonNow = this.compareVersions(version, this.version_now);
-        const minimumVersion = comparisonMin >= 0;
-        const matchWithNow = comparisonNow >= 0;
-        return {
-            info_upgrade: this.version_forceupdate,
-            is_version_min: minimumVersion,
-            is_version_now: matchWithNow,
-        };
-    }
-    /**
-     * @method apply
-     * @description Retrieves the compiled policy configuration.
-     * @returns {Object} All policy settings including restricted actions and versioning data.
-     */
-    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;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;

package/cjs/lib/registry.js

@@ -1,89 +1 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const format_key_1 = __importDefault(require("../utils/format-key"));
-/**
- * @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.
- */
-class RegistryBuilder {
-    registry_logic = {};
-    /**
-     * @constructor
-     * @description Initializes an empty registry storage.
-     */
-    constructor() {
-        this.registry_logic = {};
-    }
-    /**
-     * @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, function_regis, middleware) {
-        const keyStr = (0, format_key_1.default)(key);
-        if (typeof function_regis !== "function") {
-            throw new Error("Registry function is only type function!");
-        }
-        if (typeof key !== "string") {
-            throw new Error("Registry key is only type string!");
-        }
-        if (!!middleware && typeof middleware === "function") {
-            this.registry_logic[keyStr] = [middleware, function_regis];
-        }
-        else {
-            this.registry_logic[keyStr] = function_regis;
-        }
-    }
-    /**
-     * @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) {
-        const keyStr = (0, format_key_1.default)(key);
-        return this.registry_logic[keyStr] || undefined;
-    }
-    /**
-     * @method apply
-     * @description Returns the raw internal registry logic mapping.
-     * @returns {RegistryLogic} The complete object mapping of keys to functions/middlewares.
-     */
-    apply() {
-        return this.registry_logic;
-    }
-    /**
-     * @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) {
-        const logic = input instanceof RegistryBuilder ? input.registry_logic : input;
-        if (typeof logic === "object" && logic !== null) {
-            Object.entries(logic).forEach(([key, val]) => {
-                if (Array.isArray(val)) {
-                    const [middleware, func] = val;
-                    this.set(key, func, middleware);
-                }
-                else if (typeof val === "function") {
-                    this.set(key, val);
-                }
-            });
-        }
-        else {
-            throw new Error('The "use" input must be a RegistryBuilder or mapping object!');
-        }
-    }
-}
-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_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;

package/cjs/types/message.type.js

@@ -1,3 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// Message Error Context
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});

package/cjs/types/policy.type.js

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

package/cjs/types/registry.type.js

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

package/cjs/utils/extract-lang.js

@@ -1,25 +1 @@
-"use strict";
-/**
- * @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"]
- */
-function extractLanguage(lang = "") {
-    const acceptLang = String(lang || "").trim();
-    const toArrayLang = acceptLang
-        .split(",")
-        .map((item) => {
-        // Split by ';' to remove quality weights (q=0.9)
-        // Then split by '-' to convert locale (en-US) to primary language (en)
-        const lang = item.split(";")[0].split("-")[0];
-        return lang.trim();
-    })
-        // Remove duplicates from the array
-        .filter((value, index, self) => self.indexOf(value) === index);
-    return toArrayLang;
-}
+"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)}