@warlock.js/core 4.0.174 → 4.1.3

package/esm/router/route-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-builder.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/router/route-builder.ts"],"sourcesContent":["import { merge } from \"@mongez/reinforcements\";\nimport { type Router } from \"./router\";\nimport type { RequestHandlerType, RouteOptions } from \"./types\";\n\nexport class RouteBuilder {\n  protected addedRoutes = {\n    get: false,\n    post: false,\n    put: false,\n    delete: false,\n    patch: false,\n    options: false,\n    head: false,\n  };\n\n  public constructor(\n    private readonly router: Router,\n    private readonly path: string,\n    private readonly moreOptions: RouteOptions = {},\n  ) {\n    //\n  }\n\n  /**\n   * Add a get method to the route\n   */\n  public get(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.get) {\n      throw new Error(`Route ${this.path} already has a GET method`);\n    }\n\n    this.addedRoutes.get = true;\n    this.router.get(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Get one resource, appends /:id to the path\n   * For example: /posts/:id\n   */\n  public getOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.get(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a post method to the route\n   */\n  public post(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.post) {\n      throw new Error(`Route ${this.path} already has a POST method`);\n    }\n\n    this.addedRoutes.post = true;\n    this.router.post(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Post one resource, appends /:id to the path\n   * For example: /posts/:id\n   */\n  public postOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.post(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a PUT request handler for current path\n   */\n  public put(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.put) {\n      throw new Error(`Route ${this.path} already has a PUT method`);\n    }\n\n    this.addedRoutes.put = true;\n    this.router.put(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Update one resource, appends /:id to the path\n   */\n  public updateOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.put(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a PATCH request handler for current path\n   */\n  public patch(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.patch) {\n      throw new Error(`Route ${this.path} already has a PATCH method`);\n    }\n\n    this.addedRoutes.patch = true;\n    this.router.patch(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Patch one resource, appends /:id to the path\n   */\n  public patchOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.patch(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a DELETE request handler for current path\n   */\n  public delete(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.delete) {\n      throw new Error(`Route ${this.path} already has a DELETE method`);\n    }\n\n    this.addedRoutes.delete = true;\n    this.router.delete(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Delete one resource, appends /:id to the path\n   */\n  public deleteOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.delete(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  // ============================================================================\n  // RESTful Semantic Aliases\n  // ============================================================================\n\n  /**\n   * List all resources (RESTful alias for GET collection)\n   * @example router.route(\"/posts\").list(listPosts)\n   */\n  public list(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.get(handler, options);\n  }\n\n  /**\n   * Create a new resource (RESTful alias for POST)\n   * @example router.route(\"/posts\").create(createPost)\n   */\n  public create(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.post(handler, options);\n  }\n\n  /**\n   * Show a single resource (RESTful alias for GET one)\n   * @example router.route(\"/posts\").show(showPost) // GET /posts/:id\n   */\n  public show(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.getOne(handler, options);\n  }\n\n  /**\n   * Update a resource (RESTful alias for PUT one)\n   * @example router.route(\"/posts\").update(updatePost) // PUT /posts/:id\n   */\n  public update(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.updateOne(handler, options);\n  }\n\n  /**\n   * Destroy a resource (RESTful alias for DELETE one)\n   * @example router.route(\"/posts\").destroy(deletePost) // DELETE /posts/:id\n   */\n  public destroy(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.deleteOne(handler, options);\n  }\n\n  // ============================================================================\n  // Route Nesting\n  // ============================================================================\n\n  /**\n   * Create a nested route builder\n   * Useful for building nested resources like /posts/:id/comments\n   * @example\n   * router.route(\"/posts/:id\")\n   *   .getOne(showPost)\n   *   .nest(\"/comments\")\n   *     .list(listComments)      // GET /posts/:id/comments\n   *     .create(createComment);  // POST /posts/:id/comments\n   */\n  public nest(path: string, options: RouteOptions = {}): RouteBuilder {\n    const nestedPath = `${this.path}${path}`;\n    const mergedOptions = this.withOptions(options);\n    return new RouteBuilder(this.router, nestedPath, mergedOptions);\n  }\n\n  /**\n   * Set up common RESTful CRUD routes in one call\n   * @example\n   * router.route(\"/posts\").crud({\n   *   list: listPosts,        // GET /posts\n   *   create: createPost,     // POST /posts\n   *   show: showPost,         // GET /posts/:id\n   *   update: updatePost,     // PUT /posts/:id\n   *   destroy: deletePost,    // DELETE /posts/:id\n   *   patch: patchPost,       // PATCH /posts/:id\n   * });\n   */\n  public crud(\n    handlers: {\n      list?: RequestHandlerType;\n      create?: RequestHandlerType;\n      show?: RequestHandlerType;\n      update?: RequestHandlerType;\n      destroy?: RequestHandlerType;\n      patch?: RequestHandlerType;\n    },\n    options: RouteOptions = {},\n  ) {\n    if (handlers.list) this.get(handlers.list, options);\n    if (handlers.create) this.post(handlers.create, options);\n    if (handlers.show) this.getOne(handlers.show, options);\n    if (handlers.update) this.updateOne(handlers.update, options);\n    if (handlers.destroy) this.deleteOne(handlers.destroy, options);\n    if (handlers.patch) this.patchOne(handlers.patch, options);\n    return this;\n  }\n\n  /**\n   * Merge options with moreOptions\n   */\n  protected withOptions(options: RouteOptions = {}) {\n    return merge(this.moreOptions, options);\n  }\n}\n"],"mappings":"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"}

package/esm/router/route-registry.mjs

@@ -0,0 +1,61 @@
+import FindMyWay from "find-my-way";
+
+//#region ../../@warlock.js/core/src/router/route-registry.ts
+/**
+* Route Registry
+* Manages dynamic route matching using find-my-way for HMR support
+*/
+var RouteRegistry = class {
+	constructor() {
+		this.router = FindMyWay({
+			ignoreTrailingSlash: true,
+			caseSensitive: false
+		});
+	}
+	/**
+	* Register all routes from the router's internal list
+	*/
+	register(routes) {
+		for (const route of routes) if (route.method === "all") {
+			this.registerRoute({
+				...route,
+				method: "GET"
+			});
+			this.registerRoute({
+				...route,
+				method: "POST"
+			});
+		} else this.registerRoute(route);
+	}
+	/**
+	* Register a single route
+	*/
+	registerRoute(route) {
+		this.router.on(route.method, route.path, (req, res, params) => {
+			return {
+				route,
+				params
+			};
+		});
+	}
+	/**
+	* Find a matching route for the given method and URL
+	* @returns Matched route with extracted params, or null if no match
+	*/
+	find(method, url) {
+		const path = url.split("?")[0];
+		const match = this.router.find(method, path);
+		if (!match) return null;
+		return match.handler(null, null, match.params, match.store, {});
+	}
+	/**
+	* Get all registered routes count (for debugging)
+	*/
+	getRouteCount() {
+		return this.router.prettyPrint().split("\n").filter((line) => line.trim()).length;
+	}
+};
+
+//#endregion
+export { RouteRegistry };
+//# sourceMappingURL=route-registry.mjs.map

package/esm/router/route-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-registry.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/router/route-registry.ts"],"sourcesContent":["import FindMyWay, { type HTTPMethod, type Instance } from \"find-my-way\";\nimport type { Route } from \"./types\";\n\n/**\n * Route Registry\n * Manages dynamic route matching using find-my-way for HMR support\n */\nexport class RouteRegistry {\n  private router: Instance<any>;\n\n  public constructor() {\n    this.router = FindMyWay({\n      ignoreTrailingSlash: true,\n      caseSensitive: false,\n    });\n  }\n\n  /**\n   * Register all routes from the router's internal list\n   */\n  public register(routes: Route[]): void {\n    // Register each route\n    for (const route of routes) {\n      if (route.method === \"all\") {\n        this.registerRoute({\n          ...route,\n          method: \"GET\",\n        });\n\n        this.registerRoute({\n          ...route,\n          method: \"POST\",\n        });\n      } else {\n        this.registerRoute(route);\n      }\n    }\n  }\n\n  /**\n   * Register a single route\n   */\n  public registerRoute(route: Route): void {\n    this.router.on(route.method as HTTPMethod, route.path, (req, res, params) => {\n      // Store the route and params for later use\n      return { route, params };\n    });\n  }\n\n  /**\n   * Find a matching route for the given method and URL\n   * @returns Matched route with extracted params, or null if no match\n   */\n  public find(\n    method: string,\n    url: string,\n  ): { route: Route; params: Record<string, string> } | null {\n    // Strip query string from URL (find-my-way expects just the path)\n    const path = url.split(\"?\")[0];\n\n    const match = this.router.find(method as HTTPMethod, path);\n\n    if (!match) {\n      return null;\n    }\n\n    // find-my-way handler expects (req, res, params, store, searchParams)\n    // We only care about the return value which contains { route, params }\n    return match.handler(null as any, null as any, match.params, match.store, {});\n  }\n\n  /**\n   * Get all registered routes count (for debugging)\n   */\n  public getRouteCount(): number {\n    return this.router\n      .prettyPrint()\n      .split(\"\\n\")\n      .filter((line) => line.trim()).length;\n  }\n}\n"],"mappings":";;;;;;;AAOA,IAAa,gBAAb,MAA2B;CAGzB,AAAO,cAAc;EACnB,KAAK,SAAS,UAAU;GACtB,qBAAqB;GACrB,eAAe;EACjB,CAAC;CACH;;;;CAKA,AAAO,SAAS,QAAuB;EAErC,KAAK,MAAM,SAAS,QAClB,IAAI,MAAM,WAAW,OAAO;GAC1B,KAAK,cAAc;IACjB,GAAG;IACH,QAAQ;GACV,CAAC;GAED,KAAK,cAAc;IACjB,GAAG;IACH,QAAQ;GACV,CAAC;EACH,OACE,KAAK,cAAc,KAAK;CAG9B;;;;CAKA,AAAO,cAAc,OAAoB;EACvC,KAAK,OAAO,GAAG,MAAM,QAAsB,MAAM,OAAO,KAAK,KAAK,WAAW;GAE3E,OAAO;IAAE;IAAO;GAAO;EACzB,CAAC;CACH;;;;;CAMA,AAAO,KACL,QACA,KACyD;EAEzD,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE;EAE5B,MAAM,QAAQ,KAAK,OAAO,KAAK,QAAsB,IAAI;EAEzD,IAAI,CAAC,OACH,OAAO;EAKT,OAAO,MAAM,QAAQ,MAAa,MAAa,MAAM,QAAQ,MAAM,OAAO,CAAC,CAAC;CAC9E;;;;CAKA,AAAO,gBAAwB;EAC7B,OAAO,KAAK,OACT,YAAY,EACZ,MAAM,IAAI,EACV,QAAQ,SAAS,KAAK,KAAK,CAAC,EAAE;CACnC;AACF"}

package/esm/router/router.d.mts

@@ -0,0 +1,192 @@
+import { FastifyInstance } from "../http/server.mjs";
+import { GroupedRoutesOptions, RequestHandler, RequestHandlerType, ResourceMethod, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
+import { RouteBuilder } from "./route-builder.mjs";
+import { FastifyHttpProxyOptions } from "@fastify/http-proxy";
+import { FastifyStaticOptions } from "@fastify/static";
+
+//#region ../../@warlock.js/core/src/router/router.d.ts
+declare class Router {
+  /**
+   * Routes list
+   */
+  private routes;
+  /**
+   * Router Instance
+   */
+  private static instance;
+  /**
+   * Static paths
+   */
+  protected staticDirectories: FastifyStaticOptions[];
+  /**
+   * Event listeners
+   */
+  protected eventListeners: Record<string, ((router: Router, server: FastifyInstance) => void)[]>;
+  /**
+   * Stacks
+   * Stacks will be used for grouping routes to add prefix, name or middleware
+   */
+  protected stacks: RouterStacks;
+  /**
+   * Get router instance
+   */
+  static getInstance(): Router;
+  private constructor();
+  /**
+   * Listen to router before scan
+   */
+  beforeScanning(callback: (router: Router, server: FastifyInstance) => void): this;
+  /**
+   * Listen to router after scanning
+   */
+  afterScanning(callback: (router: Router, server: FastifyInstance) => void): this;
+  /**
+   * Redirect path to another path
+   */
+  redirect(from: string, to: string, redirectMode?: "temporary" | "permanent"): this;
+  /**
+   * Server static folder
+   */
+  directory(options: FastifyStaticOptions): this;
+  /**
+   * Serve file
+   */
+  file(path: string, location: string, cacheTime?: number): this;
+  /**
+   * Serve cached file, it will cache the file to 1 year by default
+   */
+  cachedFile(path: string, location: string, cacheTime?: number): this;
+  /**
+   * Serve list of files
+   */
+  files(files: Record<string, string>, cacheTime?: number): void;
+  /**
+   * Serve list of cached files, it will cache the file to 1 year by default
+   */
+  cachedFiles(files: Record<string, string>, cacheTime?: number): void;
+  /**
+   * Add proxy route
+   */
+  proxy(path: string, baseUrl: string, options?: Omit<FastifyHttpProxyOptions, "prefix" | "upstream">): this;
+  proxy(options: FastifyHttpProxyOptions): this;
+  /**
+   * Add route to routes list
+   */
+  add(method: Route["method"], path: string | string[], handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add a request that accepts all methods
+   */
+  any(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add get request method
+   */
+  get(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add post request method
+   */
+  post(path: string | string[], handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add put request method
+   */
+  put(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add delete request method
+   */
+  delete(path: string | string[], handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add patch request method
+   */
+  patch(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add head request method
+   */
+  head(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Add options request method
+   */
+  options(path: string, handler: RequestHandlerType, options?: RouteOptions): this;
+  /**
+   * Get a chainable route builder for the same route path
+   */
+  route(path: string, options?: RouteOptions): RouteBuilder;
+  /**
+   * Add full restful resource routes
+   * This method will generate the following routes:
+   * 1. GET /path: list all resources
+   * 2. GET /path/:id: get a single resource
+   * 3. POST /path: create a new resource
+   * 4. PUT /path/:id: update a resource
+   * 5. DELETE /path/:id: delete a resource
+   * 6. PATCH /path/:id: update a resource partially
+   */
+  restfulResource(path: string, resource: RouteResource, options?: RouteOptions & {
+    only?: ResourceMethod[];
+    except?: ResourceMethod[];
+    replace?: Partial<Record<ResourceMethod, RequestHandler>> & {
+      bulkDelete?: RequestHandler;
+    };
+  }): this;
+  /**
+   * Group routes with options
+   */
+  group(options: GroupedRoutesOptions, callback: RouterGroupCallback): this;
+  /**
+   * Add prefix to all routes in the given callback
+   */
+  prefix(prefix: string, callback: () => void): this;
+  /**
+   * Add API version prefix to all routes in the given callback
+   * Automatically formats the version as /v{version}
+   * @example
+   * router.version("1", () => {
+   *   router.get("/users", getUsersV1); // /v1/users
+   * });
+   *
+   * router.version("2", () => {
+   *   router.get("/users", getUsersV2); // /v2/users
+   * });
+   */
+  version(version: string | number, callback: () => void): this;
+  /**
+   * Wrap route additions with a source file path
+   * Used for tracking which routes come from which file (for HMR)
+   * @param sourceFile Relative path to the source file (e.g., "src/app/users/routes.ts")
+   * @param callback Function that adds routes (will have sourceFile injected)
+   */
+  withSourceFile<T = any>(sourceFile: string, callback: () => T | Promise<T>): Promise<T | undefined>;
+  /**
+   * Remove all routes that belong to a specific source file
+   * Used when reloading routes files via HMR
+   * @param sourceFile Relative path to the source file
+   */
+  removeRoutesBySourceFile(sourceFile: string): void;
+  /**
+   * Manage validation system for the given resource
+   */
+  private manageValidation;
+  /**
+   * Get all routes list
+   */
+  list(): Route[];
+  /**
+   * Register routes to the server
+   */
+  scan(server: FastifyInstance): void;
+  /**
+   * Scan routes for the development server
+   * Uses wildcard routing with find-my-way for HMR support
+   */
+  scanDevServer(server: FastifyInstance): void;
+  /**
+   * Get the route path for the given route name
+   */
+  getRoute(name: string, params?: any): string;
+  /**
+   * Handle the given route
+   */
+  private handleRoute;
+}
+declare const router: Router;
+//#endregion
+export { Router, router };
+//# sourceMappingURL=router.d.mts.map

package/esm/router/router.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/router/router.ts"],"mappings":"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"}