alepha 0.20.1 → 0.20.3

package/dist/router/index.d.ts

@@ -3,6 +3,7 @@ declare abstract class RouterProvider<T extends Route = Route> {
   protected routePathRegex: RegExp;
   protected tree: Tree<T>;
   protected cache: Map<string, RouteMatch<T>>;
+  protected maxCacheSize: number;
   match(path: string): RouteMatch<T>;
   protected test(path: string): void;
   protected push(route: T): void;
@@ -67,17 +68,12 @@ interface Tree<T extends Route> {
  */
 declare class TemplatedPathParser {
   protected static readonly PARAM_REGEX: RegExp;
-  protected readonly template: string;
-  protected readonly separator: string;
+  readonly template: string;
+  readonly separator: string;
+  readonly paramNames: readonly string[];
+  readonly hasParams: boolean;
+  protected readonly extractRegex: RegExp | null;
   constructor(template: string, separator?: string);
-  /**
-   * Returns true if the template contains at least one `{param}` placeholder.
-   */
-  get hasParams(): boolean;
-  /**
-   * Returns an ordered list of parameter names found in the template.
-   */
-  get paramNames(): string[];
   /**
    * Replaces each `{param}` in the template with the corresponding value
    * from the provided params record.
@@ -85,10 +81,12 @@ declare class TemplatedPathParser {
   interpolate(params: Record<string, string>): string;
   /**
    * Extracts parameter values from a concrete path by matching it against
-   * the template structure. Returns an empty object when the template has
-   * no parameters.
+   * the template structure.
+   *
+   * Returns `null` when the path does not match the template.
+   * Returns `{}` when the template has no parameters and the path matches.
    */
-  extract(path: string): Record<string, string>;
+  extract(path: string): Record<string, string> | null;
   /**
    * Replaces each `{param}` placeholder in the template with the given
    * wildcard string. Defaults to `"+"` (MQTT-style).
@@ -99,6 +97,8 @@ declare class TemplatedPathParser {
    * trailing separator (unless the path is just the separator itself).
    */
   normalize(path: string): string;
+  protected buildExtractRegex(): RegExp;
+  protected escapeRegex(s: string): string;
 }
 //#endregion
 export { Route, RouteMatch, RouterProvider, TemplatedPathParser, Tree };

package/dist/router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"mappings":";uBAEsB,cAAA,WAAyB,KAAA,GAAQ,KAAA;EAAA,UAC3C,cAAA,EAAgB,MAAA;EAAA,UAEhB,IAAA,EAAM,IAAA,CAAK,CAAA;EAAA,UACX,KAAA,EAAK,GAAA,SAAA,UAAA,CAAA,CAAA;EAER,KAAA,CAAM,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UAS7B,IAAA,CAAK,IAAA;EAAA,UAML,IAAA,CAAK,KAAA,EAAO,CAAA;EAAA,UA8DZ,gBAAA,CAAiB,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UA4C3C,SAAA,CAAU,KAAA,EAAO,UAAA,CAAW,CAAA,IAAK,UAAA,CAAW,CAAA;EAAA,UAa5C,WAAA,CAAY,IAAA;AAAA;AAAA,UAYP,UAAA,WAAqB,KAAA;EACpC,KAAA,GAAQ,CAAA;EACR,MAAA,GAAS,MAAA;AAAA;AAAA,UAGM,KAAA;EACf,IAAA;EA/BsC;;;;;;;EAwCtC,SAAA,GAAY,MAAA;AAAA;AAAA,UAGG,IAAA,WAAe,KAAA;EAC9B,KAAA,GAAQ,CAAA;EACR,QAAA;IAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;EAAA;EAEtB,KAAA;IACE,KAAA,GAAQ,CAAA;IACR,IAAA;IACA,QAAA;MAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;IAAA;EAAA;EAGxB,QAAA;IACE,KAAA,EAAO,CAAA;EAAA;AAAA;;;;AAvLX;;;;;;;;;;;;;;;;;;;;;cCoBa,mBAAA;EAAA,0BACe,WAAA,EAAW,MAAA;EAAA,mBAElB,QAAA;EAAA,mBACA,SAAA;cAEP,QAAA,UAAkB,SAAA;EDzBJ;;;EAAA,ICiCtB,SAAA,CAAA;ED9BM;;;EAAA,ICqCN,UAAA,CAAA;EDnCG;;;;EC2CP,WAAA,CAAY,MAAA,EAAQ,MAAA;EDlCL;;;;;EC8Cf,OAAA,CAAQ,IAAA,WAAe,MAAA;EDsBmB;;;;ECoB1C,WAAA,CAAY,QAAA;EDwBQ;;;;EChBpB,SAAA,CAAU,IAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"mappings":";uBAEsB,cAAA,WAAyB,KAAA,GAAQ,KAAA;EAAA,UAC3C,cAAA,EAAgB,MAAA;EAAA,UAEhB,IAAA,EAAM,IAAA,CAAK,CAAA;EAAA,UACX,KAAA,EAAK,GAAA,SAAA,UAAA,CAAA,CAAA;EAAA,UACL,YAAA;EAEH,KAAA,CAAM,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UAY7B,IAAA,CAAK,IAAA;EAAA,UAML,IAAA,CAAK,KAAA,EAAO,CAAA;EAAA,UA+DZ,gBAAA,CAAiB,IAAA,WAAe,UAAA,CAAW,CAAA;EAAA,UA4C3C,SAAA,CAAU,KAAA,EAAO,UAAA,CAAW,CAAA,IAAK,UAAA,CAAW,CAAA;EAAA,UAa5C,WAAA,CAAY,IAAA;AAAA;AAAA,UAYP,UAAA,WAAqB,KAAA;EACpC,KAAA,GAAQ,CAAA;EACR,MAAA,GAAS,MAAA;AAAA;AAAA,UAGM,KAAA;EACf,IAAA;EA/B2B;;;;;;;EAwC3B,SAAA,GAAY,MAAA;AAAA;AAAA,UAGG,IAAA,WAAe,KAAA;EAC9B,KAAA,GAAQ,CAAA;EACR,QAAA;IAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;EAAA;EAEtB,KAAA;IACE,KAAA,GAAQ,CAAA;IACR,IAAA;IACA,QAAA;MAAA,CACG,GAAA,WAAc,IAAA,CAAK,CAAA;IAAA;EAAA;EAGxB,QAAA;IACE,KAAA,EAAO,CAAA;EAAA;AAAA;;;;AA5LX;;;;;;;;;;;;;;;;;;;;;cCsBa,mBAAA;EAAA,0BACe,WAAA,EAAW,MAAA;EAAA,SAErB,QAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;EAAA,SACA,SAAA;EAAA,mBACG,YAAA,EAAc,MAAA;cAErB,QAAA,UAAkB,SAAA;ED5BT;;;;EC+CrB,WAAA,CAAY,MAAA,EAAQ,MAAA;ED7CV;;;;;;;EC2DV,OAAA,CAAQ,IAAA,WAAe,MAAA;EDvCD;;;;EC4DtB,WAAA,CAAY,QAAA;EDGyC;;;;ECKrD,SAAA,CAAU,IAAA;EAAA,UAaA,iBAAA,CAAA,GAAqB,MAAA;EAAA,UAerB,WAAA,CAAY,CAAA;AAAA"}

package/dist/router/index.js

@@ -4,11 +4,21 @@ var RouterProvider = class {
 	routePathRegex = /^\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;
 	tree = { children: {} };
 	cache = /* @__PURE__ */ new Map();
+	maxCacheSize = 1e4;
 	match(path) {
-		if (this.cache.has(path)) return this.cache.get(path);
-		const result = this.mapParams(this.createRouteMatch(path));
-		this.cache.set(path, result);
-		return result;
+		const pathname = path.split("?", 1)[0];
+		const hit = this.cache.get(pathname);
+		if (hit) return {
+			route: hit.route,
+			params: { ...hit.params }
+		};
+		const result = this.mapParams(this.createRouteMatch(pathname));
+		if (this.cache.size >= this.maxCacheSize) this.cache.clear();
+		this.cache.set(pathname, result);
+		return {
+			route: result.route,
+			params: { ...result.params }
+		};
 	}
 	test(path) {
 		if (!this.routePathRegex.test(path)) throw new AlephaError(`Route '${path}' is not valid`);
@@ -16,6 +26,7 @@ var RouterProvider = class {
 	push(route) {
 		const path = route.path.replaceAll("//", "/");
 		this.test(path);
+		this.cache.clear();
 		const parts = this.createParts(path);
 		let cursor = this.tree;
 		for (let i = 0; i < parts.length; i++) {
@@ -128,50 +139,41 @@ var RouterProvider = class {
 * parser.wildcardize("*");                               // "cache:*:*"
 * ```
 */
-var TemplatedPathParser = class {
+var TemplatedPathParser = class TemplatedPathParser {
 	static PARAM_REGEX = /\{([^}]+)\}/g;
 	template;
 	separator;
+	paramNames;
+	hasParams;
+	extractRegex;
 	constructor(template, separator = "/") {
+		if (separator.length !== 1) throw new AlephaError(`TemplatedPathParser separator must be a single character, got '${separator}'`);
 		this.template = template;
 		this.separator = separator;
-	}
-	/**
-	* Returns true if the template contains at least one `{param}` placeholder.
-	*/
-	get hasParams() {
-		return /\{[^}]+\}/.test(this.template);
-	}
-	/**
-	* Returns an ordered list of parameter names found in the template.
-	*/
-	get paramNames() {
-		return [...this.template.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+		this.paramNames = [...template.matchAll(TemplatedPathParser.PARAM_REGEX)].map((m) => m[1]);
+		this.hasParams = this.paramNames.length > 0;
+		this.extractRegex = this.hasParams ? this.buildExtractRegex() : null;
 	}
 	/**
 	* Replaces each `{param}` in the template with the corresponding value
 	* from the provided params record.
 	*/
 	interpolate(params) {
-		return this.template.replace(/\{([^}]+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+		return this.template.replace(TemplatedPathParser.PARAM_REGEX, (_, name) => params[name] ?? `{${name}}`);
 	}
 	/**
 	* Extracts parameter values from a concrete path by matching it against
-	* the template structure. Returns an empty object when the template has
-	* no parameters.
+	* the template structure.
+	*
+	* Returns `null` when the path does not match the template.
+	* Returns `{}` when the template has no parameters and the path matches.
 	*/
 	extract(path) {
-		const names = this.paramNames;
-		if (names.length === 0) return {};
-		const escapedSeparator = this.separator.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-		const regexSource = this.template.replace(/[.*+?^${}()|[\]\\]/g, (char) => {
-			if (char === "{" || char === "}") return char;
-			return `\\${char}`;
-		}).replace(/\{([^}]+)\}/g, `([^${escapedSeparator}]+)`);
-		const match = new RegExp(`^${regexSource}$`).exec(path);
-		if (!match) return {};
+		if (!this.extractRegex) return path === this.template ? {} : null;
+		const match = this.extractRegex.exec(path);
+		if (!match) return null;
 		const result = {};
-		for (let i = 0; i < names.length; i++) result[names[i]] = match[i + 1];
+		for (let i = 0; i < this.paramNames.length; i++) result[this.paramNames[i]] = match[i + 1];
 		return result;
 	}
 	/**
@@ -179,7 +181,7 @@ var TemplatedPathParser = class {
 	* wildcard string. Defaults to `"+"` (MQTT-style).
 	*/
 	wildcardize(wildcard = "+") {
-		return this.template.replace(/\{[^}]+\}/g, wildcard);
+		return this.template.replace(TemplatedPathParser.PARAM_REGEX, wildcard);
 	}
 	/**
 	* Normalises a path by collapsing repeated separators and stripping a
@@ -187,11 +189,22 @@ var TemplatedPathParser = class {
 	*/
 	normalize(path) {
 		const sep = this.separator;
-		const escapedSep = sep.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		const escapedSep = this.escapeRegex(sep);
 		let result = path.replace(new RegExp(`${escapedSep}{2,}`, "g"), sep);
 		if (result.endsWith(sep) && result.length > sep.length) result = result.slice(0, -sep.length);
 		return result;
 	}
+	buildExtractRegex() {
+		const escapedSeparator = this.escapeRegex(this.separator);
+		const regexSource = this.template.replace(/[.*+?^${}()|[\]\\]/g, (char) => {
+			if (char === "{" || char === "}") return char;
+			return `\\${char}`;
+		}).replace(/\{[^}]+\}/g, `([^${escapedSeparator}]+)`);
+		return new RegExp(`^${regexSource}$`);
+	}
+	escapeRegex(s) {
+		return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	}
 };
 //#endregion
 export { RouterProvider, TemplatedPathParser };

package/dist/router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n\n  public match(path: string): RouteMatch<T> {\n    if (this.cache.has(path)) {\n      return this.cache.get(path)!;\n    }\n    const result = this.mapParams(this.createRouteMatch(path));\n    this.cache.set(path, result);\n    return result;\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n","/**\n * Parses and manipulates templated paths with `{param}` placeholders.\n *\n * Used by both RouterProvider (HTTP routes) and TopicProvider (pub/sub topics)\n * to handle parameterized path templates in a unified way.\n *\n * @example\n * ```ts\n * const parser = new TemplatedPathParser(\"/users/{userId}/posts/{postId}\");\n * parser.interpolate({ userId: \"7\", postId: \"42\" }); // \"/users/7/posts/42\"\n * parser.extract(\"/users/7/posts/42\");               // { userId: \"7\", postId: \"42\" }\n * parser.wildcardize(\"+\");                           // \"/users/+/posts/+\"\n * ```\n *\n * @example\n * ```ts\n * // Redis-style colon-separated keys\n * const parser = new TemplatedPathParser(\"cache:{namespace}:{key}\", \":\");\n * parser.interpolate({ namespace: \"users\", key: \"42\" }); // \"cache:users:42\"\n * parser.wildcardize(\"*\");                               // \"cache:*:*\"\n * ```\n */\nexport class TemplatedPathParser {\n  protected static readonly PARAM_REGEX = /\\{([^}]+)\\}/g;\n\n  protected readonly template: string;\n  protected readonly separator: string;\n\n  constructor(template: string, separator = \"/\") {\n    this.template = template;\n    this.separator = separator;\n  }\n\n  /**\n   * Returns true if the template contains at least one `{param}` placeholder.\n   */\n  get hasParams(): boolean {\n    return /\\{[^}]+\\}/.test(this.template);\n  }\n\n  /**\n   * Returns an ordered list of parameter names found in the template.\n   */\n  get paramNames(): string[] {\n    return [...this.template.matchAll(/\\{([^}]+)\\}/g)].map((m) => m[1]);\n  }\n\n  /**\n   * Replaces each `{param}` in the template with the corresponding value\n   * from the provided params record.\n   */\n  interpolate(params: Record<string, string>): string {\n    return this.template.replace(\n      /\\{([^}]+)\\}/g,\n      (_, name: string) => params[name] ?? `{${name}}`,\n    );\n  }\n\n  /**\n   * Extracts parameter values from a concrete path by matching it against\n   * the template structure. Returns an empty object when the template has\n   * no parameters.\n   */\n  extract(path: string): Record<string, string> {\n    const names = this.paramNames;\n    if (names.length === 0) {\n      return {};\n    }\n\n    const escapedSeparator = this.separator.replace(\n      /[.*+?^${}()|[\\]\\\\]/g,\n      \"\\\\$&\",\n    );\n\n    // Build a regex from the template: escape literal parts, replace {param} with a capture group\n    const regexSource = this.template\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, (char) => {\n        // Allow { and } through so we can then replace them as param groups\n        if (char === \"{\" || char === \"}\") {\n          return char;\n        }\n        return `\\\\${char}`;\n      })\n      // After escaping literal chars, replace {name} patterns with capture groups.\n      // The separator is already escaped above, so we match anything that is not the separator.\n      .replace(/\\{([^}]+)\\}/g, `([^${escapedSeparator}]+)`);\n\n    const regex = new RegExp(`^${regexSource}$`);\n    const match = regex.exec(path);\n\n    if (!match) {\n      return {};\n    }\n\n    const result: Record<string, string> = {};\n    for (let i = 0; i < names.length; i++) {\n      result[names[i]] = match[i + 1];\n    }\n    return result;\n  }\n\n  /**\n   * Replaces each `{param}` placeholder in the template with the given\n   * wildcard string. Defaults to `\"+\"` (MQTT-style).\n   */\n  wildcardize(wildcard = \"+\"): string {\n    return this.template.replace(/\\{[^}]+\\}/g, wildcard);\n  }\n\n  /**\n   * Normalises a path by collapsing repeated separators and stripping a\n   * trailing separator (unless the path is just the separator itself).\n   */\n  normalize(path: string): string {\n    const sep = this.separator;\n    const escapedSep = sep.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n    // Replace consecutive separators with a single one\n    let result = path.replace(new RegExp(`${escapedSep}{2,}`, \"g\"), sep);\n\n    // Strip trailing separator, but preserve a lone separator\n    if (result.endsWith(sep) && result.length > sep.length) {\n      result = result.slice(0, -sep.length);\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/router/providers/RouterProvider.ts","../../src/router/TemplatedPathParser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport abstract class RouterProvider<T extends Route = Route> {\n  protected routePathRegex: RegExp = /^\\/[A-Za-z0-9._~!$&%'()*+,;=:@{}?/-]*$/;\n\n  protected tree: Tree<T> = { children: {} };\n  protected cache = new Map<string, RouteMatch<T>>();\n  protected maxCacheSize = 10_000;\n\n  public match(path: string): RouteMatch<T> {\n    const pathname = path.split(\"?\", 1)[0];\n    const hit = this.cache.get(pathname);\n    if (hit) {\n      return { route: hit.route, params: { ...hit.params } };\n    }\n    const result = this.mapParams(this.createRouteMatch(pathname));\n    if (this.cache.size >= this.maxCacheSize) this.cache.clear();\n    this.cache.set(pathname, result);\n    return { route: result.route, params: { ...result.params } };\n  }\n\n  protected test(path: string): void {\n    if (!this.routePathRegex.test(path)) {\n      throw new AlephaError(`Route '${path}' is not valid`);\n    }\n  }\n\n  protected push(route: T): void {\n    const path = route.path.replaceAll(\"//\", \"/\");\n\n    this.test(path);\n    this.cache.clear();\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    for (let i = 0; i < parts.length; i++) {\n      const isLast = i === parts.length - 1;\n      let part = parts[i].toLowerCase(); // url is case-insensitive\n      if (part === \"*\" && isLast) {\n        cursor.wildcard = { route };\n        break;\n      }\n\n      if (part.includes(\"*\")) {\n        throw new AlephaError(`Route '${path}' has an invalid wildcard syntax`);\n      }\n\n      if (part.includes(\"{\") || part.includes(\"}\")) {\n        if (part.startsWith(\"{\") && part.endsWith(\"}\")) {\n          part = `:${part.slice(1, -1)}`; // convert {param} to :param\n        } else {\n          throw new AlephaError(`Route '${path}' has an invalid param syntax`);\n        }\n      }\n\n      if (part.startsWith(\":\")) {\n        const name = parts[i].slice(1).replaceAll(\"}\", \"\");\n        if (!name) {\n          throw new AlephaError(`Route '${path}' has an empty param name`);\n        }\n        if (!cursor.param) {\n          cursor.param = { name, children: {} };\n        } else if (cursor.param.name !== name) {\n          // damn, 2 url params with different names\n          // got this case with /customers/:id and /customers/:userId/payments\n          route.mapParams ??= {};\n          route.mapParams[cursor.param.name] = name;\n        }\n\n        if (isLast) {\n          cursor.param.route = route;\n        }\n\n        cursor = cursor.param;\n        continue;\n      }\n\n      if (!cursor.children[part]) {\n        cursor.children[part] = { children: {} };\n      }\n\n      if (isLast) {\n        cursor.children[part].route = route;\n      }\n\n      cursor = cursor.children[part];\n    }\n  }\n\n  protected createRouteMatch(path: string): RouteMatch<T> {\n    if (path[0] !== \"/\") {\n      throw new AlephaError(`Path '${path}' must start with \"/\"`);\n    }\n\n    const parts = this.createParts(path);\n\n    let cursor = this.tree;\n    let wildcard: { route: T } | undefined;\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i].toLowerCase(); // url is case-insensitive\n      if (cursor.children[part]) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        cursor = cursor.children[part];\n      } else if (cursor.param) {\n        if (cursor.wildcard) {\n          wildcard = cursor.wildcard;\n        }\n        params[cursor.param.name] = parts[i];\n        cursor = cursor.param;\n      } else if (cursor.wildcard) {\n        params[\"*\"] = parts.slice(i).join(\"/\");\n        return { route: cursor.wildcard.route, params };\n      } else {\n        return { route: wildcard?.route, params };\n      }\n    }\n\n    if (!cursor?.route) {\n      // when \"/a/*\" - trigger if \"/a\"\n      if (cursor.wildcard) {\n        return { route: cursor.wildcard.route, params };\n      }\n      // return deep wildcard or nothing\n      return { route: wildcard?.route, params };\n    }\n\n    return { route: cursor.route, params };\n  }\n\n  protected mapParams(match: RouteMatch<T>): RouteMatch<T> {\n    if (match.route?.mapParams && match.params) {\n      for (const [key, value] of Object.entries(match.route.mapParams)) {\n        if (match.params[key]) {\n          match.params[value] = match.params[key];\n          delete match.params[key];\n        }\n      }\n    }\n\n    return match;\n  }\n\n  protected createParts(path: string): string[] {\n    let pathname = path.split(\"?\")[0].replaceAll(\"//\", \"/\");\n\n    // remove trailing slash\n    if (pathname.endsWith(\"/\") && pathname.length > 1) {\n      pathname = pathname.slice(0, -1);\n    }\n\n    return pathname.split(\"/\").slice(1);\n  }\n}\n\nexport interface RouteMatch<T extends Route> {\n  route?: T;\n  params?: Record<string, string>;\n}\n\nexport interface Route {\n  path: string;\n\n  /**\n   * Rename a param in the route.\n   * This is automatically filled when you have scenarios like:\n   * `/customers/:id` and `/customers/:userId/payments`\n   *\n   * In this case, `:id` will be renamed to `:userId` in the second route.\n   */\n  mapParams?: Record<string, string>;\n}\n\nexport interface Tree<T extends Route> {\n  route?: T;\n  children: {\n    [key: string]: Tree<T>;\n  };\n  param?: {\n    route?: T;\n    name: string;\n    children: {\n      [key: string]: Tree<T>;\n    };\n  };\n  wildcard?: {\n    route: T;\n  };\n}\n","import { AlephaError } from \"alepha\";\n\n/**\n * Parses and manipulates templated paths with `{param}` placeholders.\n *\n * Used by both RouterProvider (HTTP routes) and TopicProvider (pub/sub topics)\n * to handle parameterized path templates in a unified way.\n *\n * @example\n * ```ts\n * const parser = new TemplatedPathParser(\"/users/{userId}/posts/{postId}\");\n * parser.interpolate({ userId: \"7\", postId: \"42\" }); // \"/users/7/posts/42\"\n * parser.extract(\"/users/7/posts/42\");               // { userId: \"7\", postId: \"42\" }\n * parser.wildcardize(\"+\");                           // \"/users/+/posts/+\"\n * ```\n *\n * @example\n * ```ts\n * // Redis-style colon-separated keys\n * const parser = new TemplatedPathParser(\"cache:{namespace}:{key}\", \":\");\n * parser.interpolate({ namespace: \"users\", key: \"42\" }); // \"cache:users:42\"\n * parser.wildcardize(\"*\");                               // \"cache:*:*\"\n * ```\n */\nexport class TemplatedPathParser {\n  protected static readonly PARAM_REGEX = /\\{([^}]+)\\}/g;\n\n  public readonly template: string;\n  public readonly separator: string;\n  public readonly paramNames: readonly string[];\n  public readonly hasParams: boolean;\n  protected readonly extractRegex: RegExp | null;\n\n  constructor(template: string, separator = \"/\") {\n    if (separator.length !== 1) {\n      throw new AlephaError(\n        `TemplatedPathParser separator must be a single character, got '${separator}'`,\n      );\n    }\n    this.template = template;\n    this.separator = separator;\n    this.paramNames = [\n      ...template.matchAll(TemplatedPathParser.PARAM_REGEX),\n    ].map((m) => m[1]);\n    this.hasParams = this.paramNames.length > 0;\n    this.extractRegex = this.hasParams ? this.buildExtractRegex() : null;\n  }\n\n  /**\n   * Replaces each `{param}` in the template with the corresponding value\n   * from the provided params record.\n   */\n  interpolate(params: Record<string, string>): string {\n    return this.template.replace(\n      TemplatedPathParser.PARAM_REGEX,\n      (_, name: string) => params[name] ?? `{${name}}`,\n    );\n  }\n\n  /**\n   * Extracts parameter values from a concrete path by matching it against\n   * the template structure.\n   *\n   * Returns `null` when the path does not match the template.\n   * Returns `{}` when the template has no parameters and the path matches.\n   */\n  extract(path: string): Record<string, string> | null {\n    if (!this.extractRegex) {\n      return path === this.template ? {} : null;\n    }\n\n    const match = this.extractRegex.exec(path);\n    if (!match) {\n      return null;\n    }\n\n    const result: Record<string, string> = {};\n    for (let i = 0; i < this.paramNames.length; i++) {\n      result[this.paramNames[i]] = match[i + 1];\n    }\n    return result;\n  }\n\n  /**\n   * Replaces each `{param}` placeholder in the template with the given\n   * wildcard string. Defaults to `\"+\"` (MQTT-style).\n   */\n  wildcardize(wildcard = \"+\"): string {\n    return this.template.replace(TemplatedPathParser.PARAM_REGEX, wildcard);\n  }\n\n  /**\n   * Normalises a path by collapsing repeated separators and stripping a\n   * trailing separator (unless the path is just the separator itself).\n   */\n  normalize(path: string): string {\n    const sep = this.separator;\n    const escapedSep = this.escapeRegex(sep);\n\n    let result = path.replace(new RegExp(`${escapedSep}{2,}`, \"g\"), sep);\n\n    if (result.endsWith(sep) && result.length > sep.length) {\n      result = result.slice(0, -sep.length);\n    }\n\n    return result;\n  }\n\n  protected buildExtractRegex(): RegExp {\n    const escapedSeparator = this.escapeRegex(this.separator);\n\n    const regexSource = this.template\n      .replace(/[.*+?^${}()|[\\]\\\\]/g, (char) => {\n        if (char === \"{\" || char === \"}\") {\n          return char;\n        }\n        return `\\\\${char}`;\n      })\n      .replace(/\\{[^}]+\\}/g, `([^${escapedSeparator}]+)`);\n\n    return new RegExp(`^${regexSource}$`);\n  }\n\n  protected escapeRegex(s: string): string {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n}\n"],"mappings":"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"}

package/dist/scheduler/index.d.ts

@@ -2,6 +2,7 @@ import * as _$alepha from "alepha";
 import { Alepha, Async, KIND, Primitive, Static } from "alepha";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
 import * as _$alepha_logger0 from "alepha/logger";
+import { Cron } from "cron-schedule";
 import * as _$dayjs from "dayjs";
 
 //#region ../../src/scheduler/constants/CRON.d.ts
@@ -14,89 +15,6 @@ declare const CRON: {
   EVERY_DAY_AT_MIDNIGHT: string;
 };
 //#endregion
-//#region ../../../../node_modules/cron-schedule/dist/cron.d.ts
-/**
- * An object with contains for each element of a date, which values are allowed.
- * Everything starting at 0, except for days.
- */
-interface ICronDefinition {
-  readonly seconds: Set<number>;
-  readonly minutes: Set<number>;
-  readonly hours: Set<number>;
-  readonly days: Set<number>;
-  readonly months: Set<number>;
-  readonly weekdays: Set<number>;
-}
-declare class Cron {
-  readonly seconds: ReadonlyArray<number>;
-  readonly minutes: ReadonlyArray<number>;
-  readonly hours: ReadonlyArray<number>;
-  readonly days: ReadonlyArray<number>;
-  readonly months: ReadonlyArray<number>;
-  readonly weekdays: ReadonlyArray<number>;
-  readonly reversed: {
-    seconds: ReadonlyArray<number>;
-    minutes: ReadonlyArray<number>;
-    hours: ReadonlyArray<number>;
-    days: ReadonlyArray<number>;
-    months: ReadonlyArray<number>;
-    weekdays: ReadonlyArray<number>;
-  };
-  constructor({
-    seconds,
-    minutes,
-    hours,
-    days,
-    months,
-    weekdays
-  }: ICronDefinition);
-  /**
-   * Find the next or previous hour, starting from the given start hour that matches the hour constraint.
-   * startHour itself might also be allowed.
-   */
-  private findAllowedHour;
-  /**
-   * Find the next or previous minute, starting from the given start minute that matches the minute constraint.
-   * startMinute itself might also be allowed.
-   */
-  private findAllowedMinute;
-  /**
-   * Find the next or previous second, starting from the given start second that matches the second constraint.
-   * startSecond itself IS NOT allowed.
-   */
-  private findAllowedSecond;
-  /**
-   * Find the next or previous time, starting from the given start time that matches the hour, minute
-   * and second constraints. startTime itself might also be allowed.
-   */
-  private findAllowedTime;
-  /**
-   * Find the next or previous day in the given month, starting from the given startDay
-   * that matches either the day or the weekday constraint. startDay itself might also be allowed.
-   */
-  private findAllowedDayInMonth;
-  /** Gets the next date starting from the given start date or now. */
-  getNextDate(startDate?: Date): Date;
-  /** Gets the specified amount of future dates starting from the given start date or now. */
-  getNextDates(amount: number, startDate?: Date): Date[];
-  /**
-   * Get an ES6 compatible iterator which iterates over the next dates starting from startDate or now.
-   * The iterator runs until the optional endDate is reached or forever.
-   */
-  getNextDatesIterator(startDate?: Date, endDate?: Date): Generator<Date, undefined, undefined>;
-  /** Gets the previous date starting from the given start date or now. */
-  getPrevDate(startDate?: Date): Date;
-  /** Gets the specified amount of previous dates starting from the given start date or now. */
-  getPrevDates(amount: number, startDate?: Date): Date[];
-  /**
-   * Get an ES6 compatible iterator which iterates over the previous dates starting from startDate or now.
-   * The iterator runs until the optional endDate is reached or forever.
-   */
-  getPrevDatesIterator(startDate?: Date, endDate?: Date): Generator<Date, undefined, undefined>;
-  /** Returns true when there is a cron date at the given date. */
-  matchDate(date: Date): boolean;
-}
-//#endregion
 //#region ../../src/scheduler/providers/CronProvider.d.ts
 declare class CronProvider {
   protected readonly dt: DateTimeProvider;

package/dist/scheduler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["ICronDefinition","Set","seconds","minutes","hours","days","months","weekdays","Cron","ReadonlyArray","Date","Generator","reversed","constructor","findAllowedHour","findAllowedMinute","findAllowedSecond","findAllowedTime","findAllowedDayInMonth","getNextDate","startDate","getNextDates","amount","getNextDatesIterator","endDate","getPrevDate","getPrevDates","getPrevDatesIterator","matchDate","date"],"sources":["../../src/scheduler/constants/CRON.ts","../../../../node_modules/cron-schedule/dist/cron.d.ts","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"x_google_ignoreList":[1],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/scheduler/constants/CRON.ts","../../src/scheduler/providers/CronProvider.ts","../../src/scheduler/primitives/$scheduler.ts","../../src/scheduler/providers/WorkerdCronProvider.ts","../../src/scheduler/index.ts"],"mappings":"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"}