@ramonyx/router 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ramonymous
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# @ramonyx/router
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Paket framework Ramonyx.
+
+> **Alpha (0.1.0)** — framework Node.js ini adalah baseline produksi;
+> runtime Rust/V8 bersifat eksperimental. Butuh **Node.js ≥ 24**.
+
+## Instalasi
+
+```bash
+npm install @ramonyx/router
+```
+
+Repo: https://github.com/RamonyxJS/ramonyx · Lisensi: MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { RouteMatch, RouteTable } from "./match.js";
+export { createRouteTable, matchRoute } from "./match.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createRouteTable, matchRoute } from "./match.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/router/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export type { RouteMatch, RouteTable } from \"./match.ts\";\nexport { createRouteTable, matchRoute } from \"./match.ts\";\n"]}

package/dist/match.d.ts

@@ -0,0 +1,27 @@
+import type { RouteEntry } from "@ramonyx/core";
+export type RouteMatch = {
+    readonly kind: "match";
+    readonly entry: RouteEntry;
+    readonly params: Readonly<Record<string, string>>;
+} | {
+    readonly kind: "method-not-allowed";
+    readonly allow: readonly string[];
+} | {
+    readonly kind: "not-found";
+};
+interface CompiledEntry {
+    readonly entry: RouteEntry;
+    readonly segments: readonly string[];
+    readonly method: string;
+}
+export interface RouteTable {
+    readonly entries: readonly RouteEntry[];
+    readonly compiled: readonly CompiledEntry[];
+}
+export declare function createRouteTable(entries: readonly RouteEntry[]): RouteTable;
+/**
+ * Matching sederhana untuk Phase 1: statis + parameter (`[name]`).
+ * Route statis menang atas parameter; trailing slash dinormalisasi.
+ */
+export declare function matchRoute(table: RouteTable, method: string, pathname: string): RouteMatch;
+export {};

package/dist/match.js

@@ -0,0 +1,91 @@
+/** Segmen pola catch-all `[...name]` — hanya valid di posisi terakhir. */
+const CATCH_ALL = /^\[\.\.\.([A-Za-z0-9_]+)\]$/;
+function splitPath(path) {
+    const normalized = path.length > 1 && path.endsWith("/") ? path.slice(0, -1) : path;
+    if (normalized === "/" || normalized === "") {
+        return [];
+    }
+    return normalized.split("/").filter((segment) => segment.length > 0);
+}
+function safeDecode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        // Nilai URL tidak valid; pakai apa adanya.
+        return value;
+    }
+}
+export function createRouteTable(entries) {
+    const compiled = entries.map((entry) => ({
+        entry,
+        segments: splitPath(entry.path),
+        method: entry.method.toUpperCase(),
+    }));
+    return { entries, compiled };
+}
+/**
+ * Matching sederhana untuk Phase 1: statis + parameter (`[name]`).
+ * Route statis menang atas parameter; trailing slash dinormalisasi.
+ */
+export function matchRoute(table, method, pathname) {
+    const segments = splitPath(pathname);
+    const upperMethod = method.toUpperCase();
+    const allow = new Set();
+    let best;
+    for (const candidate of table.compiled) {
+        const lastPattern = candidate.segments.at(-1);
+        const catchAll = lastPattern === undefined ? null : CATCH_ALL.exec(lastPattern);
+        const fixedLength = candidate.segments.length - (catchAll === null ? 0 : 1);
+        // Tanpa catch-all: panjang harus sama. Dengan catch-all `[...name]`: minimal 1 segmen sisa.
+        if (catchAll === null
+            ? candidate.segments.length !== segments.length
+            : segments.length < fixedLength + 1) {
+            continue;
+        }
+        const params = {};
+        let score = 0;
+        let matched = true;
+        for (let index = 0; index < fixedLength; index += 1) {
+            const pattern = candidate.segments[index];
+            const value = segments[index];
+            if (pattern === undefined || value === undefined) {
+                matched = false;
+                break;
+            }
+            if (pattern.startsWith("[") && pattern.endsWith("]") && pattern.length > 2) {
+                params[pattern.slice(1, -1)] = safeDecode(value);
+                score += 1;
+            }
+            else if (pattern === value) {
+                score += 2;
+            }
+            else {
+                matched = false;
+                break;
+            }
+        }
+        if (matched && catchAll?.[1] !== undefined) {
+            // Catch-all menambah skor 0 → selalu kalah dari pola statis/parameter yang cocok.
+            params[catchAll[1]] = segments.slice(fixedLength).map(safeDecode).join("/");
+        }
+        if (!matched) {
+            continue;
+        }
+        if (candidate.method !== upperMethod) {
+            allow.add(candidate.method);
+            continue;
+        }
+        if (best === undefined || score > best.score) {
+            best = { entry: candidate.entry, params, score };
+        }
+    }
+    if (best !== undefined) {
+        return { kind: "match", entry: best.entry, params: best.params };
+    }
+    if (allow.size > 0) {
+        return { kind: "method-not-allowed", allow: [...allow].sort() };
+    }
+    return { kind: "not-found" };
+}
+//# sourceMappingURL=match.js.map

package/dist/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../../packages/router/src/match.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RouteEntry } from \"@ramonyx/core\";\n\nexport type RouteMatch =\n  | {\n      readonly kind: \"match\";\n      readonly entry: RouteEntry;\n      readonly params: Readonly<Record<string, string>>;\n    }\n  | { readonly kind: \"method-not-allowed\"; readonly allow: readonly string[] }\n  | { readonly kind: \"not-found\" };\n\ninterface CompiledEntry {\n  readonly entry: RouteEntry;\n  readonly segments: readonly string[];\n  readonly method: string;\n}\n\n/** Segmen pola catch-all `[...name]` — hanya valid di posisi terakhir. */\nconst CATCH_ALL = /^\\[\\.\\.\\.([A-Za-z0-9_]+)\\]$/;\n\nexport interface RouteTable {\n  readonly entries: readonly RouteEntry[];\n  readonly compiled: readonly CompiledEntry[];\n}\n\nfunction splitPath(path: string): readonly string[] {\n  const normalized = path.length > 1 && path.endsWith(\"/\") ? path.slice(0, -1) : path;\n  if (normalized === \"/\" || normalized === \"\") {\n    return [];\n  }\n  return normalized.split(\"/\").filter((segment) => segment.length > 0);\n}\n\nfunction safeDecode(value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    // Nilai URL tidak valid; pakai apa adanya.\n    return value;\n  }\n}\n\nexport function createRouteTable(entries: readonly RouteEntry[]): RouteTable {\n  const compiled = entries.map((entry) => ({\n    entry,\n    segments: splitPath(entry.path),\n    method: entry.method.toUpperCase(),\n  }));\n  return { entries, compiled };\n}\n\n/**\n * Matching sederhana untuk Phase 1: statis + parameter (`[name]`).\n * Route statis menang atas parameter; trailing slash dinormalisasi.\n */\nexport function matchRoute(table: RouteTable, method: string, pathname: string): RouteMatch {\n  const segments = splitPath(pathname);\n  const upperMethod = method.toUpperCase();\n  const allow = new Set<string>();\n  let best: { entry: RouteEntry; params: Record<string, string>; score: number } | undefined;\n\n  for (const candidate of table.compiled) {\n    const lastPattern = candidate.segments.at(-1);\n    const catchAll = lastPattern === undefined ? null : CATCH_ALL.exec(lastPattern);\n    const fixedLength = candidate.segments.length - (catchAll === null ? 0 : 1);\n\n    // Tanpa catch-all: panjang harus sama. Dengan catch-all `[...name]`: minimal 1 segmen sisa.\n    if (\n      catchAll === null\n        ? candidate.segments.length !== segments.length\n        : segments.length < fixedLength + 1\n    ) {\n      continue;\n    }\n\n    const params: Record<string, string> = {};\n    let score = 0;\n    let matched = true;\n\n    for (let index = 0; index < fixedLength; index += 1) {\n      const pattern = candidate.segments[index];\n      const value = segments[index];\n      if (pattern === undefined || value === undefined) {\n        matched = false;\n        break;\n      }\n      if (pattern.startsWith(\"[\") && pattern.endsWith(\"]\") && pattern.length > 2) {\n        params[pattern.slice(1, -1)] = safeDecode(value);\n        score += 1;\n      } else if (pattern === value) {\n        score += 2;\n      } else {\n        matched = false;\n        break;\n      }\n    }\n\n    if (matched && catchAll?.[1] !== undefined) {\n      // Catch-all menambah skor 0 → selalu kalah dari pola statis/parameter yang cocok.\n      params[catchAll[1]] = segments.slice(fixedLength).map(safeDecode).join(\"/\");\n    }\n\n    if (!matched) {\n      continue;\n    }\n\n    if (candidate.method !== upperMethod) {\n      allow.add(candidate.method);\n      continue;\n    }\n\n    if (best === undefined || score > best.score) {\n      best = { entry: candidate.entry, params, score };\n    }\n  }\n\n  if (best !== undefined) {\n    return { kind: \"match\", entry: best.entry, params: best.params };\n  }\n  if (allow.size > 0) {\n    return { kind: \"method-not-allowed\", allow: [...allow].sort() };\n  }\n  return { kind: \"not-found\" };\n}\n"]}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@ramonyx/router",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Paket framework Ramonyx.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "dependencies": {
+    "@ramonyx/core": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RamonyxJS/ramonyx"
+  }
 }