@ooneex/routing 0.0.2 → 0.2.0

package/dist/index.d.ts

@@ -1,17 +1,15 @@
+import { ControllerClassType as ControllerClassType2 } from "@ooneex/controller";
 import { AssertType as AssertType2 } from "@ooneex/validation";
 import { Environment } from "@ooneex/app-env";
 import { ControllerClassType } from "@ooneex/controller";
+import { PermissionClassType } from "@ooneex/permission";
 import { ERole } from "@ooneex/role";
 import { HttpMethodType } from "@ooneex/types";
 import { AssertType, IAssert } from "@ooneex/validation";
-type RouteNamespace = "api" | "client" | "admin" | "public" | "auth" | "webhook" | "internal" | "external" | "system" | "health" | "metrics" | "docs";
-/**
-* Common route actions
-*/
-type RouteAction = "list" | "show" | "read" | "create" | "update" | "delete" | "store" | "edit" | "index" | "search" | "filter" | "sort" | "export" | "import" | "upload" | "download" | "duplicate" | "clone" | "archive" | "restore" | "activate" | "deactivate" | "enable" | "disable" | "publish" | "unpublish" | "approve" | "reject" | "cancel" | "confirm" | "validate" | "verify" | "reset" | "refresh" | "sync" | "backup" | "migrate" | "seed" | "truncate" | "count" | "exists" | "find" | "aggregate" | "bulk" | "batch" | "preview" | "template" | "history" | "audit" | "log" | "track" | "monitor" | "health" | "status" | "ping" | "test" | "debug" | "info" | "stats" | "report" | "analytics" | "metrics" | "summary" | "detail" | "config" | "settings" | "preferences" | "profile" | "avatar" | "password" | "login" | "logout" | "register" | "unregister" | "subscribe" | "unsubscribe" | "follow" | "unfollow" | "like" | "unlike" | "share" | "comment" | "reply" | "rate" | "review" | "bookmark" | "favorite" | "tag" | "untag" | "assign" | "unassign" | "invite" | "revoke" | "grant" | "deny" | "lock" | "unlock" | "move" | "copy" | "rename" | "reorder" | "merge" | "split" | "convert" | "transform" | "process" | "queue" | "retry" | "skip" | "pause" | "resume" | "stop" | "start" | "restart" | "reload" | "clear" | "flush" | "purge" | "cleanup" | "optimize" | "compress" | "decompress" | "manage" | "administer" | "supervise" | "oversee" | "govern" | "control" | "execute" | "perform" | "run" | "operate" | "handle" | "maintain" | "service" | "support" | "assist" | "help" | "guide" | "instruct" | "teach" | "train" | "educate" | "inform" | "notify" | "alert" | "warn" | "remind" | "schedule" | "plan" | "organize" | "arrange" | "coordinate" | "integrate" | "connect" | "link" | "bind" | "attach" | "detach" | "separate" | "isolate" | "quarantine" | "protect" | "secure" | "encrypt" | "decrypt" | "encode" | "decode" | "format" | "parse" | "serialize" | "deserialize" | "marshal" | "unmarshal" | "package" | "unpack" | "bundle" | "unbundle" | "group" | "ungroup" | "categorize" | "classify" | "sort" | "order" | "rank" | "prioritize" | "weight" | "score" | "evaluate" | "assess" | "measure" | "calculate" | "compute" | "analyze" | "examine" | "inspect" | "check" | "scan" | "detect" | "discover" | "explore" | "browse" | "navigate" | "travel" | "visit" | "access" | "enter" | "exit" | "leave" | "join" | "connect" | "disconnect" | "reconnect" | "establish" | "initialize" | "setup" | "configure" | "customize" | "personalize" | "adapt" | "adjust" | "modify" | "change" | "alter" | "revise" | "amend" | "correct" | "fix" | "repair" | "restore" | "recover" | "retrieve" | "fetch" | "get" | "obtain" | "acquire" | "receive" | "accept" | "take" | "capture" | "record" | "save" | "store" | "preserve" | "keep" | "retain" | "hold" | "maintain" | "sustain" | "continue" | "proceed" | "advance" | "progress" | "develop" | "evolve" | "grow" | "expand" | "extend" | "stretch" | "scale" | "resize" | "adjust" | "tune" | "calibrate" | "balance" | "stabilize" | "normalize" | "standardize" | "regulate" | "moderate" | "mediate" | "negotiate" | "compromise" | "resolve" | "solve" | "address" | "tackle" | "approach" | "handle" | "deal" | "cope" | "manage" | "oversee" | "supervise" | "direct" | "lead" | "command" | "instruct" | "order" | "request" | "ask" | "query" | "question" | "inquire" | "investigate" | "research" | "study" | "learn" | "understand" | "comprehend" | "grasp" | "realize" | "recognize" | "identify" | "determine" | "decide" | "choose" | "select" | "pick" | "opt" | "prefer" | "favor" | "recommend" | "suggest" | "propose" | "offer" | "provide" | "supply" | "deliver" | "send" | "transmit" | "transfer" | "forward" | "relay" | "redirect" | "route" | "dispatch" | "distribute" | "allocate" | "assign" | "designate" | "appoint" | "nominate" | "elect" | "vote" | "poll" | "survey" | "interview" | "question" | "examine" | "test" | "trial" | "experiment" | "try" | "attempt" | "endeavor" | "strive" | "effort" | "work" | "labor" | "toil" | "struggle" | "fight" | "battle" | "compete" | "contest" | "challenge" | "oppose" | "resist" | "defend" | "protect" | "guard" | "shield" | "cover" | "hide" | "conceal" | "mask" | "disguise" | "camouflage" | "cloak" | "wrap" | "enclose" | "contain" | "include" | "encompass" | "comprise" | "consist" | "compose" | "constitute" | "form" | "shape" | "mold" | "craft" | "build" | "construct" | "assemble" | "compile" | "gather" | "collect" | "accumulate" | "amass" | "pile" | "stack" | "heap" | "load" | "fill" | "populate" | "occupy" | "inhabit" | "reside" | "dwell" | "live" | "exist" | "become" | "turn" | "transform" | "metamorphose" | "evolve" | "mutate" | "adapt" | "adjust" | "accommodate" | "conform" | "comply" | "obey" | "follow" | "adhere" | "stick" | "attach" | "fasten" | "secure" | "tie" | "bind" | "connect" | "join" | "unite" | "merge" | "combine" | "mix" | "blend" | "fuse" | "integrate" | "incorporate" | "embed" | "insert" | "inject" | "introduce" | "import" | "bring" | "carry" | "transport" | "convey" | "deliver" | "distribute" | "spread" | "scatter" | "disperse" | "disseminate" | "broadcast" | "publish" | "announce" | "declare" | "proclaim" | "state" | "express" | "voice" | "speak" | "say" | "tell" | "communicate" | "convey" | "relay" | "transmit" | "send" | "deliver" | "transfer" | "move" | "shift" | "relocate" | "migrate" | "travel" | "journey" | "voyage" | "trip" | "visit" | "tour" | "explore" | "discover" | "find" | "locate" | "position" | "place" | "put" | "set" | "lay" | "rest" | "sit" | "stand" | "rise" | "lift" | "raise" | "elevate" | "boost" | "enhance" | "improve" | "upgrade" | "update" | "refresh" | "renew" | "revive" | "restore" | "repair" | "fix" | "mend" | "heal" | "cure" | "treat" | "remedy" | "solve" | "resolve" | "settle" | "conclude" | "finish" | "complete" | "end" | "terminate" | "stop" | "halt" | "pause" | "break" | "interrupt" | "suspend" | "delay" | "postpone" | "defer" | "wait" | "hold" | "keep" | "retain" | "preserve" | "maintain" | "sustain" | "support" | "uphold" | "defend" | "protect" | "safeguard" | "secure" | "ensure" | "guarantee" | "warrant" | "promise" | "pledge" | "commit" | "dedicate" | "devote" | "consecrate" | "sacrifice" | "offer" | "give" | "donate" | "contribute" | "provide" | "supply" | "furnish" | "equip" | "outfit" | "prepare" | "ready" | "arrange" | "organize" | "plan" | "design" | "create" | "make" | "produce" | "manufacture" | "fabricate" | "construct" | "build" | "erect" | "establish" | "found" | "institute" | "inaugurate" | "launch" | "start" | "begin" | "commence" | "initiate" | "trigger" | "activate" | "enable" | "turn-on" | "switch-on" | "power-on" | "boot" | "startup" | "load" | "run" | "execute" | "perform" | "operate" | "function" | "work" | "act" | "behave" | "conduct" | "direct" | "guide" | "lead" | "steer" | "navigate" | "pilot" | "drive" | "control" | "command" | "rule" | "govern" | "regulate" | "manage" | "administer" | "handle" | "deal" | "process" | "treat" | "handle" | "manipulate" | "operate" | "use" | "utilize" | "employ" | "apply" | "implement" | "deploy" | "install" | "setup" | "configure" | "adjust" | "tune" | "optimize" | "improve" | "enhance" | "refine" | "polish" | "perfect" | "complete" | "finalize" | "conclude" | "close" | "shut" | "seal" | "lock" | "secure" | "protect" | "defend" | "guard" | "watch" | "monitor" | "observe" | "supervise" | "oversee" | "manage";
-/**
-* Valid route name segment - alphanumeric with optional hyphens/underscores
-*/
+declare const VALID_NAMESPACES: readonly ["api", "client", "admin", "public", "auth", "webhook", "internal", "external", "system", "health", "metrics", "docs"];
+declare const VALID_ACTIONS: readonly ["list", "show", "read", "create", "update", "delete", "store", "edit", "index", "search", "filter", "sort", "export", "import", "upload", "download", "duplicate", "clone", "archive", "restore", "activate", "deactivate", "enable", "disable", "publish", "unpublish", "approve", "reject", "cancel", "confirm", "validate", "verify", "reset", "refresh", "sync", "backup", "migrate", "seed", "truncate", "count", "exists", "find", "aggregate", "bulk", "batch", "preview", "template", "history", "audit", "log", "track", "monitor", "health", "status", "ping", "test", "debug", "info", "stats", "report", "analytics", "metrics", "summary", "detail", "config", "settings", "preferences", "profile", "avatar", "password", "login", "logout", "register", "unregister", "subscribe", "unsubscribe", "follow", "unfollow", "like", "unlike", "share", "comment", "reply", "rate", "review", "bookmark", "favorite", "tag", "untag", "assign", "unassign", "invite", "revoke", "grant", "deny", "lock", "unlock", "move", "copy", "rename", "reorder", "merge", "split", "convert", "transform", "process", "queue", "retry", "skip", "pause", "resume", "stop", "start", "restart", "reload", "clear", "flush", "purge", "cleanup", "optimize", "compress", "decompress", "manage", "administer", "supervise", "oversee", "govern", "control", "execute", "perform", "run", "operate", "handle", "maintain", "service", "support", "assist", "help", "guide", "instruct", "teach", "train", "educate", "inform", "notify", "alert", "warn", "remind", "schedule", "plan", "organize", "arrange", "coordinate", "integrate", "connect", "link", "bind", "attach", "detach", "separate", "isolate", "quarantine", "protect", "secure", "encrypt", "decrypt", "encode", "decode", "format", "parse", "serialize", "deserialize", "marshal", "unmarshal", "package", "unpack", "bundle", "unbundle", "group", "ungroup", "categorize", "classify", "order", "rank", "prioritize", "weight", "score", "evaluate", "assess", "measure", "calculate", "compute", "analyze", "examine", "inspect", "check", "scan", "detect", "discover", "explore", "browse", "navigate", "travel", "visit", "access", "enter", "exit", "leave", "join", "disconnect", "reconnect", "establish", "initialize", "setup", "configure", "customize", "personalize", "adapt", "adjust", "modify", "change", "alter", "revise", "amend", "correct", "fix", "repair", "recover", "retrieve", "fetch", "get", "obtain", "acquire", "receive", "accept", "take", "capture", "record", "save", "preserve", "keep", "retain", "hold", "sustain", "continue", "proceed", "advance", "progress", "develop", "evolve", "grow", "expand", "extend", "stretch", "scale", "resize", "tune", "calibrate", "balance", "stabilize", "normalize", "standardize", "regulate", "moderate", "mediate", "negotiate", "compromise", "resolve", "solve", "address", "tackle", "approach", "deal", "cope", "direct", "lead", "command", "instruct", "order", "request", "ask", "query", "question", "inquire", "investigate", "research", "study", "learn", "understand", "comprehend", "grasp", "realize", "recognize", "identify", "determine", "decide", "choose", "select", "pick", "opt", "prefer", "favor", "recommend", "suggest", "propose", "offer", "provide", "supply", "deliver", "send", "transmit", "transfer", "forward", "relay", "redirect", "route", "dispatch", "distribute", "allocate", "designate", "appoint", "nominate", "elect", "vote", "poll", "survey", "interview", "examine", "trial", "experiment", "try", "attempt", "endeavor", "strive", "effort", "work", "labor", "toil", "struggle", "fight", "battle", "compete", "contest", "challenge", "oppose", "resist", "defend", "guard", "shield", "cover", "hide", "conceal", "mask", "disguise", "camouflage", "cloak", "wrap", "enclose", "contain", "include", "encompass", "comprise", "consist", "compose", "constitute", "form", "shape", "mold", "craft", "build", "construct", "assemble", "compile", "gather", "collect", "accumulate", "amass", "pile", "stack", "heap", "load", "fill", "populate", "occupy", "inhabit", "reside", "dwell", "live", "exist", "become", "turn", "metamorphose", "mutate", "accommodate", "conform", "comply", "obey", "follow", "adhere", "stick", "fasten", "tie", "unite", "combine", "mix", "blend", "fuse", "incorporate", "embed", "insert", "inject", "introduce", "bring", "carry", "transport", "convey", "spread", "scatter", "disperse", "disseminate", "broadcast", "announce", "declare", "proclaim", "state", "express", "voice", "speak", "say", "tell", "communicate", "shift", "relocate", "journey", "voyage", "trip", "tour", "locate", "position", "place", "put", "set", "lay", "rest", "sit", "stand", "rise", "lift", "raise", "elevate", "boost", "enhance", "improve", "upgrade", "renew", "revive", "mend", "heal", "cure", "treat", "remedy", "settle", "conclude", "finish", "complete", "end", "terminate", "halt", "break", "interrupt", "suspend", "delay", "postpone", "defer", "wait", "uphold", "safeguard", "ensure", "guarantee", "warrant", "promise", "pledge", "commit", "dedicate", "devote", "consecrate", "sacrifice", "give", "donate", "contribute", "furnish", "equip", "outfit", "prepare", "ready", "design", "make", "produce", "manufacture", "fabricate", "erect", "found", "institute", "inaugurate", "launch", "begin", "commence", "initiate", "trigger", "turn-on", "switch-on", "power-on", "boot", "startup", "function", "act", "behave", "conduct", "steer", "pilot", "drive", "rule", "manipulate", "use", "utilize", "employ", "apply", "implement", "deploy", "install", "refine", "polish", "perfect", "finalize", "close", "shut", "seal", "watch", "observe"];
+type RouteNamespace = (typeof VALID_NAMESPACES)[number];
+type RouteAction = (typeof VALID_ACTIONS)[number];
 type RouteNameSegment = string;
 /**
 * Route name type that enforces 'api.users.list' format
@@ -33,11 +31,13 @@ type RouteConfigType = {
 	ip?: string[];
 	host?: string[];
 	roles?: ERole[];
+	permission?: PermissionClassType;
+	cache?: boolean;
 	isSocket: boolean;
 	generate?: {
 		doc?: boolean;
 		fetcher?: boolean;
-		query?: boolean;
+		queryHook?: boolean;
 	};
 };
 interface IRouter {
@@ -45,7 +45,7 @@ interface IRouter {
 	findRouteByPath: (path: string) => RouteConfigType[] | null;
 	findRouteByName: (name: RouteNameType) => RouteConfigType | null;
 	getRoutes: () => Map<string, RouteConfigType[]>;
-	getSocketRoutes: () => Map<string, RouteConfigType[]>;
+	getSocketRoutes: () => Map<string, RouteConfigType>;
 	getHttpRoutes: () => Map<string, RouteConfigType[]>;
 	generate: <P extends Record<string, string | number> = Record<string, string | number>>(name: RouteNameType, params?: P) => string;
 }
@@ -110,7 +110,7 @@ type ValidRoutePath = RoutePathType<string>;
 type TypedRouteConfig<T extends string> = Omit<RouteConfigType, "method" | "path" | "isSocket" | "controller" | "params"> & {
 	params?: ExtractParameters<T> extends never ? never : Record<ExtractParameters<T>, AssertType2>;
 };
-type InferredRouteDecorator = (target: new (...args: unknown[]) => unknown) => void;
+type InferredRouteDecorator = (target: ControllerClassType2) => void;
 type RouteDecoratorFunction = <T extends string>(path: RoutePathType<T>, config: TypedRouteConfig<T>) => InferredRouteDecorator;
 declare const Route: {
 	get: RouteDecoratorFunction;
@@ -128,10 +128,11 @@ declare class Router implements IRouter {
 	findRouteByPath(path: string): RouteConfigType[] | null;
 	findRouteByName(name: string): RouteConfigType | null;
 	getRoutes(): Map<string, RouteConfigType[]>;
-	getSocketRoutes(): Map<string, RouteConfigType[]>;
+	getSocketRoutes(): Map<string, RouteConfigType>;
 	getHttpRoutes(): Map<string, RouteConfigType[]>;
 	generate<P extends Record<string, string | number> = Record<string, string | number>>(name: string, params?: P): string;
 }
+declare const router: Router;
 import { Exception } from "@ooneex/exception";
 declare class RouterException extends Exception {
 	constructor(message: string, data?: Record<string, unknown>);
@@ -222,5 +223,5 @@ declare const routeConfigToTypeString: (config: Pick<RouteConfigType, "params" |
 declare const routeConfigToJsonDoc: (config: RouteConfigType) => Record<string, unknown>;
 declare const routeConfigToFetcherString: (config: RouteConfigType) => string;
 declare const routeConfigToSocketString: (config: RouteConfigType) => string;
-declare const routeConfigToUseQueryString: (config: RouteConfigType, baseURL?: string) => string;
-export { routeConfigToUseQueryString, routeConfigToTypeString, routeConfigToSocketString, routeConfigToJsonDoc, routeConfigToFetcherString, isValidRoutePath, extractParameterNames, ValidateRoutePath, ValidRoutePath, RouterException, Router, RoutePathType, RouteParameters, RouteNamespace, RouteNameType, RouteNameSegment, RouteConfigType, RouteAction, Route, ParameterCount, IsParameter, IRouter, HasParameters, ExtractParameters, CountParameters };
+declare const routeConfigToHookString: (config: RouteConfigType) => string;
+export { router, routeConfigToTypeString, routeConfigToSocketString, routeConfigToJsonDoc, routeConfigToHookString, routeConfigToFetcherString, isValidRoutePath, extractParameterNames, ValidateRoutePath, ValidRoutePath, VALID_NAMESPACES, VALID_ACTIONS, RouterException, Router, RoutePathType, RouteParameters, RouteNamespace, RouteNameType, RouteNameSegment, RouteConfigType, RouteAction, Route, ParameterCount, IsParameter, IRouter, HasParameters, ExtractParameters, CountParameters };

package/dist/index.js

@@ -1,94 +1,101 @@
-import{container as h,EContainerScope as n}from"@ooneex/container";import{Exception as p}from"@ooneex/exception";import{HttpStatus as r}from"@ooneex/http-status";class Z extends p{constructor(R,w={}){super(R,{status:r.Code.InternalServerError,data:w});this.name="RouterException"}}class U{routes=new Map;addRoute(R){let w=R.name;for(let M of this.routes[Symbol.iterator]())if(M[1].find((H)=>H.name===w))throw new Z(`Route with name '${w}' already exists`,R);let $=this.routes.get(R.path)??[];if(R.isSocket&&$.find((M)=>M.isSocket))throw new Z(`Socket route with path '${R.path}' already exists`,R);if(!R.isSocket&&$.find((M)=>!M.isSocket&&M.method===R.method))throw new Z(`Route with path '${R.path}' and method '${R.method}' already exists`,R);return $.push(R),this.routes.set(R.path,$),h.add(R.controller,n.Singleton),this}findRouteByPath(R){return this.routes.get(R)??null}findRouteByName(R){for(let w of this.routes[Symbol.iterator]()){let $=w[1].find((M)=>M.name===R);if($)return $}return null}getRoutes(){return this.routes}getSocketRoutes(){let R=new Map;for(let[w,$]of this.routes){let M=$.filter((x)=>x.isSocket);if(M.length>0)R.set(w,M)}return R}getHttpRoutes(){let R=new Map;for(let[w,$]of this.routes){let M=$.filter((x)=>!x.isSocket);if(M.length>0)R.set(w,M)}return R}generate(R,w){let $=this.findRouteByName(R);if(!$)throw new Z(`Route with name '${R}' not found`);let M=$.path,x=M.match(/:[a-zA-Z0-9_]+/g)||[];if(x.length>0){if(!w||typeof w!=="object"||w===null)throw new Z(`Route '${R}' requires parameters, but none were provided`);for(let H of x){let v=H.substring(1);if(!(v in w))throw new Z(`Missing required parameter '${v}' for route '${R}'`);M=M.replace(H,String(w[v]))}}return M}}var q=new U;var Y=(R)=>{return(w,$)=>{return(M)=>{let x={...$,path:w,method:R,isSocket:!1,controller:M};q.addRoute(x)}}},f=()=>{return(R,w)=>{return($)=>{let M={...w,path:R,method:"GET",isSocket:!0,controller:$};q.addRoute(M)}}},uR={get:Y("GET"),post:Y("POST"),put:Y("PUT"),delete:Y("DELETE"),patch:Y("PATCH"),options:Y("OPTIONS"),head:Y("HEAD"),socket:f()};import{toPascalCase as Q}from"@ooneex/utils";var zR=(R)=>{if(!R.startsWith("/"))return!1;if(R.includes("//"))return!1;if(R.includes("::"))return!1;if(R.endsWith(":"))return!1;if(R.includes("/:")){let w=R.split("/");for(let $ of w){if($.startsWith(":")&&$.length===1)return!1;if($.includes(":")&&!$.startsWith(":"))return!1}}return!0},g=(R)=>{let w=R.match(/:([^/]+)/g);return w?w.map(($)=>$.slice(1)):[]},_=(R)=>{if(!R||typeof R!=="object")return"unknown";let w=R;if(w.type)switch(w.type){case"string":return"string";case"number":case"integer":return"number";case"boolean":return"boolean";case"null":return"null";case"array":if(w.items)return`${_(w.items)}[]`;return"unknown[]";case"object":if(w.properties&&typeof w.properties==="object"){let $=[],M=Array.isArray(w.required)?w.required:[];for(let[x,H]of Object.entries(w.properties)){let v=M.includes(x),u=_(H);$.push(`${x}${v?"":"?"}: ${u}`)}return`{ ${$.join("; ")} }`}return"Record<string, unknown>"}if(w.anyOf||w.oneOf){let $=w.anyOf||w.oneOf;if(Array.isArray($))return $.map((M)=>_(M)).join(" | ")}if(w.allOf&&Array.isArray(w.allOf))return w.allOf.map(($)=>_($)).join(" & ");return"unknown"},b=(R)=>{if(!R.response&&!R.params&&!R.payload&&!R.queries)return"never";let w=[];if(R.response)try{let M=("getConstraint"in R.response?R.response.getConstraint():R.response).toJsonSchema(),x=_(M);if(x==="unknown"||x==="{  }"||x==="Record<string, unknown>")x="never";w.push(`response: ${x}`)}catch{w.push("response: never")}if(R.params){let $=[];for(let[M,x]of Object.entries(R.params))try{let v=("getConstraint"in x?x.getConstraint():x).toJsonSchema(),u=_(v);if(u==="unknown"||u==="{  }"||u==="Record<string, unknown>")u="never";$.push(`${M}: ${u}`)}catch{$.push(`${M}: never`)}if($.length>0){let M=`{ ${$.join("; ")} }`;w.push(`params: ${M}`)}else w.push("params: never")}if(R.payload)try{let M=("getConstraint"in R.payload?R.payload.getConstraint():R.payload).toJsonSchema(),x=_(M);if(x==="unknown"||x==="{  }"||x==="Record<string, unknown>")x="never";w.push(`payload: ${x}`)}catch{w.push("payload: never")}if(R.queries)try{let M=("getConstraint"in R.queries?R.queries.getConstraint():R.queries).toJsonSchema(),x=_(M);if(x==="unknown"||x==="{  }"||x==="Record<string, unknown>")x="never";w.push(`queries: ${x}`)}catch{w.push("queries: never")}return`{
+// @bun
+import{container as s,EContainerScope as f}from"@ooneex/container";import{Exception as p}from"@ooneex/exception";import{HttpStatus as n}from"@ooneex/http-status";class T extends p{constructor(t,w={}){super(t,{status:n.Code.InternalServerError,data:w});this.name="RouterException"}}class j{routes=new Map;addRoute(t){let w=t.name;for(let x of this.routes[Symbol.iterator]())if(x[1].find((M)=>M.name===w))throw new T(`Route with name '${w}' already exists`,t);let u=this.routes.get(t.path)??[];if(t.isSocket&&u.find((x)=>x.isSocket))throw new T(`Socket route with path '${t.path}' already exists`,t);if(!t.isSocket&&u.find((x)=>!x.isSocket&&x.method===t.method))throw new T(`Route with path '${t.path}' and method '${t.method}' already exists`,t);return u.push(t),this.routes.set(t.path,u),s.add(t.controller,f.Singleton),this}findRouteByPath(t){return this.routes.get(t)??null}findRouteByName(t){for(let w of this.routes[Symbol.iterator]()){let u=w[1].find((x)=>x.name===t);if(u)return u}return null}getRoutes(){return this.routes}getSocketRoutes(){let t=new Map;for(let[w,u]of this.routes){let x=u.find((R)=>R.isSocket);if(x)t.set(w,x)}return t}getHttpRoutes(){let t=new Map;for(let[w,u]of this.routes){let x=u.filter((R)=>!R.isSocket);if(x.length>0)t.set(w,x)}return t}generate(t,w){let u=this.findRouteByName(t);if(!u)throw new T(`Route with name '${t}' not found`);let x=u.path,R=x.match(/:[a-zA-Z0-9_]+/g)||[];if(R.length>0){if(!w||typeof w!=="object"||w===null)throw new T(`Route '${t}' requires parameters, but none were provided`);for(let M of R){let C=M.substring(1);if(!(C in w))throw new T(`Missing required parameter '${C}' for route '${t}'`);x=x.replace(M,String(w[C]))}}return x}}var _=new j;var k=(t)=>{return(w,u)=>{return(x)=>{let R={...u,path:w,method:t,isSocket:!1,controller:x};_.addRoute(R)}}},a=()=>{return(t,w)=>{return(u)=>{let x={...w,path:t,method:"GET",isSocket:!0,controller:u};_.addRoute(x)}}},g={get:k("GET"),post:k("POST"),put:k("PUT"),delete:k("DELETE"),patch:k("PATCH"),options:k("OPTIONS"),head:k("HEAD"),socket:a()};var dt=["api","client","admin","public","auth","webhook","internal","external","system","health","metrics","docs"],It=["list","show","read","create","update","delete","store","edit","index","search","filter","sort","export","import","upload","download","duplicate","clone","archive","restore","activate","deactivate","enable","disable","publish","unpublish","approve","reject","cancel","confirm","validate","verify","reset","refresh","sync","backup","migrate","seed","truncate","count","exists","find","aggregate","bulk","batch","preview","template","history","audit","log","track","monitor","health","status","ping","test","debug","info","stats","report","analytics","metrics","summary","detail","config","settings","preferences","profile","avatar","password","login","logout","register","unregister","subscribe","unsubscribe","follow","unfollow","like","unlike","share","comment","reply","rate","review","bookmark","favorite","tag","untag","assign","unassign","invite","revoke","grant","deny","lock","unlock","move","copy","rename","reorder","merge","split","convert","transform","process","queue","retry","skip","pause","resume","stop","start","restart","reload","clear","flush","purge","cleanup","optimize","compress","decompress","manage","administer","supervise","oversee","govern","control","execute","perform","run","operate","handle","maintain","service","support","assist","help","guide","instruct","teach","train","educate","inform","notify","alert","warn","remind","schedule","plan","organize","arrange","coordinate","integrate","connect","link","bind","attach","detach","separate","isolate","quarantine","protect","secure","encrypt","decrypt","encode","decode","format","parse","serialize","deserialize","marshal","unmarshal","package","unpack","bundle","unbundle","group","ungroup","categorize","classify","order","rank","prioritize","weight","score","evaluate","assess","measure","calculate","compute","analyze","examine","inspect","check","scan","detect","discover","explore","browse","navigate","travel","visit","access","enter","exit","leave","join","disconnect","reconnect","establish","initialize","setup","configure","customize","personalize","adapt","adjust","modify","change","alter","revise","amend","correct","fix","repair","recover","retrieve","fetch","get","obtain","acquire","receive","accept","take","capture","record","save","preserve","keep","retain","hold","sustain","continue","proceed","advance","progress","develop","evolve","grow","expand","extend","stretch","scale","resize","tune","calibrate","balance","stabilize","normalize","standardize","regulate","moderate","mediate","negotiate","compromise","resolve","solve","address","tackle","approach","deal","cope","direct","lead","command","instruct","order","request","ask","query","question","inquire","investigate","research","study","learn","understand","comprehend","grasp","realize","recognize","identify","determine","decide","choose","select","pick","opt","prefer","favor","recommend","suggest","propose","offer","provide","supply","deliver","send","transmit","transfer","forward","relay","redirect","route","dispatch","distribute","allocate","designate","appoint","nominate","elect","vote","poll","survey","interview","examine","trial","experiment","try","attempt","endeavor","strive","effort","work","labor","toil","struggle","fight","battle","compete","contest","challenge","oppose","resist","defend","guard","shield","cover","hide","conceal","mask","disguise","camouflage","cloak","wrap","enclose","contain","include","encompass","comprise","consist","compose","constitute","form","shape","mold","craft","build","construct","assemble","compile","gather","collect","accumulate","amass","pile","stack","heap","load","fill","populate","occupy","inhabit","reside","dwell","live","exist","become","turn","metamorphose","mutate","accommodate","conform","comply","obey","follow","adhere","stick","fasten","tie","unite","combine","mix","blend","fuse","incorporate","embed","insert","inject","introduce","bring","carry","transport","convey","spread","scatter","disperse","disseminate","broadcast","announce","declare","proclaim","state","express","voice","speak","say","tell","communicate","shift","relocate","journey","voyage","trip","tour","locate","position","place","put","set","lay","rest","sit","stand","rise","lift","raise","elevate","boost","enhance","improve","upgrade","renew","revive","mend","heal","cure","treat","remedy","settle","conclude","finish","complete","end","terminate","halt","break","interrupt","suspend","delay","postpone","defer","wait","uphold","safeguard","ensure","guarantee","warrant","promise","pledge","commit","dedicate","devote","consecrate","sacrifice","give","donate","contribute","furnish","equip","outfit","prepare","ready","design","make","produce","manufacture","fabricate","erect","found","institute","inaugurate","launch","begin","commence","initiate","trigger","turn-on","switch-on","power-on","boot","startup","function","act","behave","conduct","steer","pilot","drive","rule","manipulate","use","utilize","employ","apply","implement","deploy","install","refine","polish","perfect","finalize","close","shut","seal","watch","observe"];import{toPascalCase as W}from"@ooneex/utils";import{jsonSchemaToTypeString as v}from"@ooneex/validation";var Tt=(t)=>{if(!t.startsWith("/"))return!1;if(t.includes("//"))return!1;if(t.includes("::"))return!1;if(t.endsWith(":"))return!1;if(t.includes("/:")){let w=t.split("/");for(let u of w){if(u.startsWith(":")&&u.length===1)return!1;if(u.includes(":")&&!u.startsWith(":"))return!1}}return!0},c=(t)=>{let w=t.match(/:([^/]+)/g);return w?w.map((u)=>u.slice(1)):[]},K=(t)=>{if(!t.response&&!t.params&&!t.payload&&!t.queries)return"never";let w=[];if(t.response)try{let x=("getConstraint"in t.response?t.response.getConstraint():t.response).toJsonSchema(),R=v(x);if(R==="unknown"||R==="{  }"||R==="Record<string, unknown>")R="never";w.push(`response: ${R}`)}catch{w.push("response: never")}if(t.params){let u=[];for(let[x,R]of Object.entries(t.params))try{let C=("getConstraint"in R?R.getConstraint():R).toJsonSchema(),E=v(C);if(E==="unknown"||E==="{  }"||E==="Record<string, unknown>")E="never";u.push(`${x}: ${E}`)}catch{u.push(`${x}: never`)}if(u.length>0){let x=`{ ${u.join("; ")} }`;w.push(`params: ${x}`)}else w.push("params: never")}if(t.payload)try{let x=("getConstraint"in t.payload?t.payload.getConstraint():t.payload).toJsonSchema(),R=v(x);if(R==="unknown"||R==="{  }"||R==="Record<string, unknown>")R="never";w.push(`payload: ${R}`)}catch{w.push("payload: never")}if(t.queries)try{let x=("getConstraint"in t.queries?t.queries.getConstraint():t.queries).toJsonSchema(),R=v(x);if(R==="unknown"||R==="{  }"||R==="Record<string, unknown>")R="never";w.push(`queries: ${R}`)}catch{w.push("queries: never")}return`{
   ${w.join(`;
   `)};
-}`},L=(R)=>{try{return(R&&typeof R==="object"&&"getConstraint"in R?R.getConstraint():R).toJsonSchema()}catch{return{type:"unknown"}}},BR=(R)=>{let w={name:R.name,path:R.path,method:R.method,description:R.description,controller:R.controller.name,isSocket:R.isSocket,parameters:g(R.path)},$={};if(R.params){let x={type:"object",properties:{}};for(let[H,v]of Object.entries(R.params)){let u=L(v);delete u.$schema,u.required=!0,x.properties[H]=u}$.params=x}if(R.queries){let x=L(R.queries);if(delete x.$schema,x.type==="object"&&x.properties){let H=x.required||[],v=x.properties;for(let u of Object.keys(v)){let I=v[u];I.required=H.includes(u)}delete x.required}$.queries=x}if(R.payload){let x=L(R.payload);if(delete x.$schema,x.type==="object"&&x.properties){let H=x.required||[],v=x.properties;for(let u of Object.keys(v)){let I=v[u];I.required=H.includes(u)}delete x.required}$.payload=x}if(R.response){let x=L(R.response);if(delete x.$schema,x.type==="object"&&x.properties){let H=x.required||[],v=x.properties;for(let u of Object.keys(v)){let I=v[u];I.required=H.includes(u)}delete x.required}$.response=x}if(Object.keys($).length>0)w.schemas=$;let M={};if(R.env&&R.env.length>0)M.environments=R.env;if(R.roles&&R.roles.length>0)M.roles=R.roles;if(R.ip&&R.ip.length>0)M.allowedIPs=R.ip;if(R.host&&R.host.length>0)M.allowedHosts=R.host;if(Object.keys(M).length>0)w.security=M;return w},O=(R)=>{let w=R.split(".");return w[w.length-1]||""},W=(R,w=!0)=>{let $=w?"config.params":"params";return R.replace(/:(\w+)/g,(M,x)=>`\${${$}.${x}}`)},IR=(R)=>{let w=O(R.name),$=`${w.charAt(0).toUpperCase()+w.slice(1)}RouteConfigType`,M=`${Q(R.name)}Fetcher`,x=R.method.toLowerCase(),H=b(R),v=`export type ${$} = ${H}`,u=[],I=R.params&&Object.keys(R.params).length>0,E=R.payload!==void 0,G=R.queries!==void 0;if(I)u.push(`params: ${$}["params"]`);if(E)u.push(`payload: ${$}["payload"]`);if(G)u.push(`queries: ${$}["queries"]`);let V=u.length>0?`config: {
-    ${u.join(`;
+}`},X=(t)=>{try{return(t&&typeof t==="object"&&"getConstraint"in t?t.getConstraint():t).toJsonSchema()}catch{return{type:"unknown"}}},Ot=(t)=>{let w={name:t.name,path:t.path,method:t.method,description:t.description,controller:t.controller.name,isSocket:t.isSocket,parameters:c(t.path)},u={};if(t.params){let R={type:"object",properties:{}};for(let[M,C]of Object.entries(t.params)){let E=X(C);delete E.$schema,E.required=!0,R.properties[M]=E}u.params=R}if(t.queries){let R=X(t.queries);if(delete R.$schema,R.type==="object"&&R.properties){let M=R.required||[],C=R.properties;for(let E of Object.keys(C)){let $=C[E];$.required=M.includes(E)}delete R.required}u.queries=R}if(t.payload){let R=X(t.payload);if(delete R.$schema,R.type==="object"&&R.properties){let M=R.required||[],C=R.properties;for(let E of Object.keys(C)){let $=C[E];$.required=M.includes(E)}delete R.required}u.payload=R}if(t.response){let R=X(t.response);if(delete R.$schema,R.type==="object"&&R.properties){let M=R.required||[],C=R.properties;for(let E of Object.keys(C)){let $=C[E];$.required=M.includes(E)}delete R.required}u.response=R}if(Object.keys(u).length>0)w.schemas=u;let x={};if(t.env&&t.env.length>0)x.environments=t.env;if(t.roles&&t.roles.length>0)x.roles=t.roles;if(t.ip&&t.ip.length>0)x.allowedIPs=t.ip;if(t.host&&t.host.length>0)x.allowedHosts=t.host;if(Object.keys(x).length>0)w.security=x;return w},l=(t)=>{let w=t.split(".");return w[w.length-1]||""},Y=(t,w=!0)=>{let u=w?"config.params":"params";return t.replace(/:(\w+)/g,(x,R)=>`\${${u}.${R}}`)},J=(t)=>{return`Object.entries(${t} || {}).reduce((params, [key, value]) => { params.append(key, String(value)); return params; }, new URLSearchParams()).toString()`},Gt=(t)=>{let w=l(t.name),u=`${w.charAt(0).toUpperCase()+w.slice(1)}RouteConfigType`,x=`${W(t.name)}Fetcher`,R=t.method.toLowerCase(),M=K(t),C=M==="never",E=C?"":`export type ${u} = ${M}`,$=[],A=t.params&&Object.keys(t.params).length>0,O=t.payload!==void 0,z=t.queries!==void 0,d=t.response?`${u}["response"]`:"never";if(A)$.push(`params: ${u}["params"]`);if(O)$.push(`payload: ${u}["payload"]`);if(z)$.push(`queries: ${u}["queries"]`);let I=$.length>0?`config: {
+    ${$.join(`;
     `)};
-  }`:"",z=W(R.path),B=`\`${z}\``;if(G)B=`\`${z}?\${new URLSearchParams(config.queries as Record<string, string>).toString()}\``;let C=["post","put","patch"],X="";if(C.includes(x)&&E)X=`return await fetcher.${x}<${$}["response"]>(
-      ${B},
+  }`:"",H=Y(t.path),b=`\`${H}\``;if(z)b=`\`${H}?\${${J("config.queries")}}\``;let G=["post","put","patch"],F="";if(G.includes(R)&&O)F=`return await fetcher.${R}<${d}>(
+      ${b},
       config.payload,
-    );`;else X=`return await fetcher.${x}<${$}["response"]>(
-      ${B},
-    );`;let A=`export class ${M} {
-  constructor(private baseURL: string) {}
+    );`;else F=`return await fetcher.${R}<${d}>(
+      ${b},
+    );`;let U=`export class ${x} {
+  public async ${w}(${I}): Promise<ResponseDataType<${d}>> {
 
-  public async ${w}(${V}): Promise<ResponseDataType<${$}["response"]>> {
-    const fetcher = new Fetcher(this.baseURL);
+    const fetcher = new Fetcher();
 
-    ${X}
+    ${F}
   }
-}`;return`${`import type { ResponseDataType } from "@ooneex/http-response";
-import { Fetcher } from "@ooneex/fetcher";`}
+}`,B=`import { Fetcher } from "@ooneex/fetcher";
+import type { ResponseDataType } from "@ooneex/http-response";`;return C?`${B}
 
-${v}
+${U}`:`${B}
 
-${A}`},ZR=(R)=>{let w=O(R.name),$=`${w.charAt(0).toUpperCase()+w.slice(1)}RouteConfigType`,M=`${Q(R.name)}Socket`,x=b(R),H=`export type ${$} = ${x}`,v=R.params&&Object.keys(R.params).length>0,u=R.payload&&Object.keys(R.payload).length>0,I=R.queries&&Object.keys(R.queries).length>0,E=v?`params: ${$}["params"]`:"",V=`\`\${this.baseURL}${W(R.path,!1)}\``,z=[];if(u)z.push(`payload: ${$}["payload"]`);if(I)z.push(`queries: ${$}["queries"]`);z.push("language?: LocaleInfoType");let B=z.length>0?`{ ${z.join("; ")} }`:"Record<string, unknown>",C=`export class ${M} {
-  constructor(private baseURL: string) {}
+${E}
 
-  public ${w}(${E}): ISocket {
-    const url = ${V};
-    const socket = new Socket<${B}, ${$}["response"]>(url);
+${U}`},kt=(t)=>{let w=l(t.name),u=`${w.charAt(0).toUpperCase()+w.slice(1)}RouteConfigType`,x=`${W(t.name)}Socket`,R=K(t),M=R==="never",C=M?"":`export type ${u} = ${R}`,E=t.params&&Object.keys(t.params).length>0,$=t.payload&&Object.keys(t.payload).length>0,A=t.queries&&Object.keys(t.queries).length>0,O=E?`params: ${u}["params"]`:"",d=`\`${Y(t.path,!1)}\``,I=[];if($)I.push(`payload: ${u}["payload"]`);if(A)I.push(`queries: ${u}["queries"]`);I.push("language?: LocaleInfoType");let H=I.length>0?`{ ${I.join("; ")} }`:"Record<string, unknown>",b=t.response?`${u}["response"]`:"never",G=`export class ${x} {
+  public ${w}(${O}): ISocket<${H}, ${b}> {
+    const url = ${d};
+    const socket = new Socket<${H}, ${b}>(url);
 
-    socket.onMessage((response) => {
+    socket.onMessage((response: ResponseDataType<${b}>) => {
       // TODO: Handle socket message event
     });
 
-    socket.onOpen((event) => {
+    socket.onOpen((event: Event) => {
       // TODO: Handle socket open event
     });
 
-    socket.onClose((event) => {
+    socket.onClose((event: CloseEvent) => {
       // TODO: Handle socket close event
     });
 
-    socket.onError((event, response) => {
+    socket.onError((event: Event, response?: ResponseDataType<${b}>) => {
       // TODO: Handle socket error event
     });
 
     return socket;
   }
-}`;return`${`import type { LocaleInfoType } from "@ooneex/translation";
-import { type ISocket, Socket } from "@ooneex/socket/client"`}
+}`,F=`import type { ResponseDataType } from "@ooneex/http-response";
+import { type ISocket, Socket } from "@ooneex/socket/client";
+import type { LocaleInfoType } from "@ooneex/translation";`;return M?`${F}
 
-${H}
+${G}`:`${F}
 
-${C}`},_R=(R,w="")=>{let $=O(R.name),M=`${$.charAt(0).toUpperCase()+$.slice(1)}RouteConfigType`,x=`use${Q(R.name)}`,H=R.method.toUpperCase(),v=b(R),u=`export type ${M} = ${v}`,E=["GET","HEAD","OPTIONS"].includes(H),G=R.params&&Object.keys(R.params).length>0,V=R.payload!==void 0,z=R.queries!==void 0;if(E){let F=[];if(G)F.push(`params: ${M}["params"]`);if(z)F.push(`queries?: ${M}["queries"]`);let S=F.length>0?`config: {
-  ${F.join(`;
+${C}
+
+${G}`},zt=(t)=>{let w=l(t.name),u=`${w.charAt(0).toUpperCase()+w.slice(1)}RouteConfigType`,x=`use${W(t.name)}`,R=t.method.toUpperCase(),M=K(t),C=M==="never",E=C?"":`export type ${u} = ${M}`,A=["GET","HEAD","OPTIONS"].includes(R),O=t.params&&Object.keys(t.params).length>0,z=t.payload!==void 0,d=t.queries!==void 0,I=t.response?`${u}["response"]`:"never";if(A){let L=[];if(O)L.push(`params: ${u}["params"]`);if(d)L.push(`queries?: ${u}["queries"]`);let m=L.length>0?`config: {
+  ${L.join(`;
   `)};
-}`:"",J=`[${R.name.split(".").map((K)=>`'${K}'`).join(", ")}`;if(G&&R.params){let K=Object.keys(R.params);for(let m of K)J+=`, config.params.${m}`}if(z)J+=", config.queries";J+="]";let j=W(R.path),D=`\`${j}\``;if(z)D=`\`${j}?\${new URLSearchParams(config.queries as Record<string, string>).toString()}\``;let P=H.toLowerCase(),t=`const fetcher = new Fetcher('${w}');
-      const url = ${D};
+}`:"",Z=`[${t.name.split(".").map((D)=>`'${D}'`).join(", ")}`;if(O&&t.params){let D=Object.keys(t.params);for(let e of D)Z+=`, config.params.${e}`}if(d)Z+=", config.queries";Z+="]";let N=Y(t.path),S=`\`${N}\``;if(d)S=`\`${N}?\${${J("config.queries")}}\``;let h=R.toLowerCase(),y=`const fetcher = new Fetcher();
+      const url = ${S};
 
-      return await fetcher.${P}<${M}["response"]>(url);`,y=`export const ${x} = (${S}) => {
+      return await fetcher.${h}<${I}>(url);`,P=`export const ${x} = (${m}) => {
   return useQuery({
-    queryKey: ${J},
+    queryKey: ${Z},
     queryFn: async () => {
-      ${t}
+      ${y}
     },
   });
-};`;return`${`import { useQuery } from '@tanstack/react-query';
-import { Fetcher } from '@ooneex/fetcher';`}
+};`,o=`import { useQuery } from '@tanstack/react-query';
+import { Fetcher } from '@ooneex/fetcher';`;return C?`${o}
+
+${P}`:`${o}
 
-${u}
+${E}
 
-${y}`}let B=[];if(G)B.push(`params: ${M}["params"]`);if(V)B.push(`payload: ${M}["payload"]`);if(z)B.push(`queries?: ${M}["queries"]`);let C=B.length>0?`config: {
-    ${B.join(`;
+${P}`}let H=[];if(O)H.push(`params: ${u}["params"]`);if(z)H.push(`payload: ${u}["payload"]`);if(d)H.push(`queries?: ${u}["queries"]`);let b=H.length>0?`config: {
+    ${H.join(`;
     `)};
-  }`:"config?: Record<string, never>",X=W(R.path),A=`\`${X}\``;if(z)A=`\`${X}\${config.queries ? \`?\${new URLSearchParams(config.queries as Record<string, string>).toString()}\` : ''}\``;let l=["POST","PUT","PATCH"].includes(H)&&V,d=H.toLowerCase(),k=`const fetcher = new Fetcher('${w}');
-      const url = ${A};
+  }`:"config?: Record<string, never>",G=Y(t.path),F=`\`${G}\``;if(d)F=`\`${G}\${config.queries ? \`?\${${J("config.queries")}}\` : ''}\``;let B=["POST","PUT","PATCH"].includes(R)&&z,q=R.toLowerCase(),V=`const fetcher = new Fetcher();
+      const url = ${F};
 
-      `;if(l)k+=`return await fetcher.${d}<${M}["response"]>(url, config.payload);`;else k+=`return await fetcher.${d}<${M}["response"]>(url);`;let T=`export const ${x} = () => {
+      `;if(B)V+=`return await fetcher.${q}<${I}>(url, config.payload);`;else V+=`return await fetcher.${q}<${I}>(url);`;let r=`export const ${x} = () => {
   const mutation = useMutation({
-    mutationFn: async (${C}) => {
-      ${k}
+    mutationFn: async (${b}) => {
+      ${V}
     },
   });
 
   return mutation;
-};`;return`${`import { useMutation } from '@tanstack/react-query';
-import { Fetcher } from '@ooneex/fetcher';`}
+};`,Q=`import { useMutation } from '@tanstack/react-query';
+import { Fetcher } from '@ooneex/fetcher';`;return C?`${Q}
+
+${r}`:`${Q}
 
-${u}
+${E}
 
-${T}`};export{_R as routeConfigToUseQueryString,b as routeConfigToTypeString,ZR as routeConfigToSocketString,BR as routeConfigToJsonDoc,IR as routeConfigToFetcherString,zR as isValidRoutePath,g as extractParameterNames,Z as RouterException,U as Router,uR as Route};
+${r}`};export{_ as router,K as routeConfigToTypeString,kt as routeConfigToSocketString,Ot as routeConfigToJsonDoc,zt as routeConfigToHookString,Gt as routeConfigToFetcherString,Tt as isValidRoutePath,c as extractParameterNames,dt as VALID_NAMESPACES,It as VALID_ACTIONS,T as RouterException,j as Router,g as Route};
 
-//# debugId=F38C937393AEFC1764756E2164756E21
+//# debugId=71957B2AF18D3E1B64756E2164756E21