dirent-router 1.0.0

package/CLAUDE.md

@@ -0,0 +1,33 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+dirent-router is a TypeScript library and CLI that generates type-safe route definitions from a file-system directory structure (Next.js-style routing). It scans a directory for TypeScript files, extracts exported functions as HTTP method handlers, and produces a flat array of route definitions.
+
+## Commands
+
+- **Build**: `pnpm build` (runs both `pnpm build:lib` and `pnpm build:bin`)
+- **Type check**: `pnpm check`
+- **Test**: `pnpm test` (vitest)
+- **Run single test**: `pnpm vitest run src/endpoint.test.ts`
+- **Format**: `pnpm prettier --write .`
+
+## Architecture
+
+The pipeline flows: **scan directory → build file tree → parse endpoints → import modules → flatten routes**.
+
+- `src/router.ts` — Core logic. `findRouteStructure()` recursively walks the routes directory building a `RouteStructure` tree. `findRouteDefs()` converts file paths to endpoint strings (stripping `.ts`/`index.ts`). `flattenRoutes()` dynamically imports each module, extracts exported functions as HTTP methods, and deduplicates by endpoint. Public API: `getRoutes(config)`.
+- `src/endpoint.ts` — Parses endpoint path strings into `EndpointPart[]` segments typed as `path` or `variable` (bracket syntax like `[id]`).
+- `src/bin.ts` — CLI entry point. Takes a directory argument, calls `getRoutes()`, outputs JSON.
+- `src/index.ts` — Library entry re-exporting `endpoint.ts` and `router.ts`.
+
+Route files export named functions corresponding to HTTP methods (e.g., `export const get = ...`, `export const post = ...`). Directory segments wrapped in brackets (e.g., `[id]/`) become route variables.
+
+## TypeScript Configuration
+
+- Module system: `nodenext` with `esnext` target
+- Strict mode with additional strictness: `noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`
+- Library builds to `dist/`, CLI builds to `bin/`
+- Package manager: pnpm

package/README.md

@@ -0,0 +1,102 @@
+# dirent-router
+Generate routes from a directory
+
+## Install
+```
+npm install dirent-router
+# or
+pnpm install dirent-router
+```
+
+## Route Directory Structure
+
+Each `.ts` file in your routes directory becomes an endpoint. Exported function names correspond to HTTP methods (`get`, `post`, `put`, `delete`, etc.).
+
+- `index.ts` files map to the parent directory path
+- Other `.ts` files map to a path segment matching their filename
+- Directory names wrapped in brackets (e.g., `[id]`) become route variables
+
+**Example:**
+
+```
+routes/
+├── index.ts              →  /
+├── companies/
+│   ├── index.ts          →  /companies
+│   ├── search.ts         →  /companies/search
+│   └── [id]/
+│       └── index.ts      →  /companies/[id]
+```
+
+```typescript
+// routes/index.ts
+export const get = () => {
+  return 'foo';
+}
+
+// routes/companies/index.ts
+export const get = () => {
+  return [{ id: 'a' }, { id: 'b' }];
+}
+
+export const post = () => {
+  return { ok: true };
+}
+
+// routes/companies/search.ts
+export const get = (searchQuery: string) => {
+  return { searchQuery };
+}
+
+// routes/companies/[id]/index.ts
+export const get = (id: string) => {
+  return { id };
+}
+```
+
+## Usage
+
+### Integration
+```typescript
+import fs from "fs";
+import { getRoutes } from "dirent-router";
+
+const routes = await getRoutes({
+  routesDir: "./path/to/your/routes",
+});
+
+console.log(
+  JSON.stringify(
+    routes,
+    (_, v) => (typeof v === "function" ? `${v.name}(...)` : v),
+    2,
+  ),
+);
+
+// Output example
+[
+  {
+    "filepath": "sample-routes/companies/[id]",
+    "relativepath": "companies/[id]",
+    "endpoint": "/companies/[id]",
+    "args": [
+      {
+        "type": "path",
+        "value": "companies"
+      },
+      {
+        "type": "variable",
+        "value": "id"
+      }
+    ],
+    "methods": {
+      get: "[Function]"
+    }
+  }
+]
+```
+
+### CLI
+```
+dirent-router ./path/to/your/routes
+```

package/bin/bin.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/bin/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/bin/bin.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const router_1 = require("./router");
+const main = async () => {
+    const routesDir = process.argv[2];
+    if (!routesDir) {
+        console.error(`Please provide directory where routes are stored`);
+        return;
+    }
+    if (!fs_1.default.existsSync(routesDir)) {
+        console.error(`${routesDir}: No such file or directory`);
+        return;
+    }
+    const routes = await (0, router_1.getRoutes)({
+        routesDir,
+    });
+    console.log(JSON.stringify(routes, (_, v) => (typeof v === "function" ? `${v.name}(...)` : v), 2));
+};
+main().catch((e) => console.error(e));
+//# sourceMappingURL=bin.js.map

package/bin/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,qCAAqC;AAErC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;IACtB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IACD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,6BAA6B,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAS,EAAC;QAC7B,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,MAAM,EACN,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAC1D,CAAC,CACF,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/bin/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/bin/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/bin/common/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/bin/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/bin/common/types.d.ts

@@ -0,0 +1,4 @@
+export type LooseSyncFunction = (...args: any[]) => any;
+export type LooseAsyncFunction = (...args: any[]) => Promise<any>;
+export type LooseFunction = LooseSyncFunction | LooseAsyncFunction;
+//# sourceMappingURL=types.d.ts.map

package/bin/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AACxD,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,CAAC"}

package/bin/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/bin/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":""}

package/bin/endpoint.d.ts

@@ -0,0 +1,6 @@
+export type EndpointPart = {
+    type: 'path' | 'variable';
+    value: string;
+};
+export declare const parseEndpoint: (buff: string) => EndpointPart[];
+//# sourceMappingURL=endpoint.d.ts.map

package/bin/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,YAAY,EAwCxD,CAAC"}

package/bin/endpoint.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEndpoint = void 0;
+const parseEndpoint = (buff) => {
+    const slices = [];
+    const len = buff.length;
+    let i = 0;
+    let c = buff[i++];
+    const advance = () => {
+        c = buff[i++];
+        return c;
+    };
+    while (i <= len) {
+        if (c !== "[" && c !== '/' && i <= len) {
+            let param = "";
+            while (c !== "/" && c !== "[" && i <= len) {
+                param += c;
+                c = advance();
+            }
+            slices.push({
+                type: 'path',
+                value: param,
+            });
+        }
+        if (c === "[") {
+            let param = "";
+            c = advance();
+            while (c !== "]" && i < len) {
+                param += c;
+                c = advance();
+            }
+            slices.push({
+                type: 'variable',
+                value: param,
+            });
+        }
+        c = advance();
+    }
+    return slices;
+};
+exports.parseEndpoint = parseEndpoint;
+//# sourceMappingURL=endpoint.js.map

package/bin/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":";;;AAKO,MAAM,aAAa,GAAG,CAAC,IAAY,EAAkB,EAAE;IAC5D,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,GAAW,CAAC,CAAC;IAClB,IAAI,CAAC,GAAW,IAAI,CAAC,CAAC,EAAE,CAAE,CAAC;IAE3B,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACvC,IAAI,KAAK,GAAW,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC1C,KAAK,IAAI,CAAC,CAAC;gBACX,CAAC,GAAG,OAAO,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,IAAI,KAAK,GAAW,EAAE,CAAC;YACvB,CAAC,GAAG,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;gBAC5B,KAAK,IAAI,CAAC,CAAC;gBACX,CAAC,GAAG,OAAO,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QAED,CAAC,GAAG,OAAO,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAxCW,QAAA,aAAa,iBAwCxB"}

package/bin/router.d.ts

@@ -0,0 +1,21 @@
+import { LooseFunction } from "./common";
+import { EndpointPart } from "./endpoint";
+export interface RouterConfig {
+    routesDir: string;
+}
+export type RouteStructure = {
+    filepath: string;
+    children: RouteStructure[];
+};
+export type RouteMethods = Record<string, LooseFunction>;
+export type RouteDefinition = {
+    filepath: string;
+    relativepath: string;
+    endpoint: string;
+    args: EndpointPart[];
+    methods: RouteMethods;
+    children: RouteDefinition[];
+};
+export type FlatRouteDefinition = Omit<RouteDefinition, "children">;
+export declare const getRoutes: (cfg: RouterConfig) => Promise<FlatRouteDefinition[]>;
+//# sourceMappingURL=router.d.ts.map

package/bin/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAIzD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;AAsGpE,eAAO,MAAM,SAAS,GACpB,KAAK,YAAY,KAChB,OAAO,CAAC,mBAAmB,EAAE,CAK/B,CAAC"}

package/bin/router.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoutes = void 0;
+const util_1 = require("./util");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const endpoint_1 = require("./endpoint");
+// ---- implementation ----
+const getEntries = async (path) => {
+    const entries = (await promises_1.default.readdir(path, {
+        recursive: false,
+        withFileTypes: true,
+    })).filter((entry) => {
+        return ((entry.isDirectory() || entry.name.endsWith(".ts")) &&
+            !entry.name.includes("#") &&
+            !entry.name.includes("~"));
+    });
+    return entries;
+};
+const findRouteStructure = async (path) => {
+    const entries = await getEntries(path);
+    const children = (await Promise.all(entries.map(async (entry) => {
+        const abspath = path_1.default.join(entry.parentPath, entry.name);
+        if (entry.isDirectory()) {
+            return await findRouteStructure(abspath);
+        }
+        return {
+            filepath: abspath,
+            children: [],
+        };
+    }))).flat();
+    return {
+        filepath: path,
+        children: children,
+    };
+};
+const findRouteDefs = async (rootPath, structure) => {
+    const relativepath = path_1.default.relative(rootPath, structure.filepath);
+    const endpoint = "/" +
+        [relativepath]
+            .map((x) => x.replace("index.ts", "").replace(".ts", ""))
+            .map((x) => (x.endsWith("/") ? x.slice(0, -1) : x))[0];
+    return {
+        filepath: structure.filepath,
+        relativepath: relativepath,
+        endpoint: endpoint,
+        args: (0, endpoint_1.parseEndpoint)(endpoint),
+        methods: {},
+        children: await Promise.all(structure.children.map(async (child) => {
+            return findRouteDefs(rootPath, child);
+        })),
+    };
+};
+const flattenRoutes = async (defs) => {
+    const items = [];
+    const q = [defs];
+    const seen = new Set();
+    while (q.length > 0) {
+        const next = q.pop();
+        if (seen.has(next.endpoint))
+            continue;
+        seen.add(next.endpoint);
+        const methods = {};
+        try {
+            const module = await import(next.filepath);
+            for (const [k, v] of Object.entries(module)) {
+                if (typeof v === "function") {
+                    methods[k] = v;
+                }
+            }
+        }
+        catch (e) {
+            console.error(e);
+        }
+        items.push((0, util_1.omit)({ ...next, methods }, "children"));
+        q.push(...next.children);
+    }
+    return (0, util_1.uniqueBy)(items, (x) => x.endpoint);
+};
+const getRoutes = async (cfg) => {
+    const rootPath = path_1.default.resolve(cfg.routesDir);
+    const structure = await findRouteStructure(rootPath);
+    const defs = await findRouteDefs(rootPath, structure);
+    return await flattenRoutes(defs);
+};
+exports.getRoutes = getRoutes;
+//# sourceMappingURL=router.js.map

package/bin/router.js.map

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

package/bin/util.d.ts

@@ -0,0 +1,3 @@
+export declare const omit: <T extends Record<PropertyKey, unknown>, Keys extends keyof T>(obj: T, ...keys: Keys[]) => Omit<T, Keys>;
+export declare const uniqueBy: <T, Key extends (item: T) => unknown>(arr: T[], key: Key) => T[];
+//# sourceMappingURL=util.d.ts.map

package/bin/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,GACf,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,IAAI,SAAS,MAAM,CAAC,EAEpB,KAAK,CAAC,EACN,GAAG,MAAM,IAAI,EAAE,KACd,IAAI,CAAC,CAAC,EAAE,IAAI,CAQd,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,EAC1D,KAAK,CAAC,EAAE,EACR,KAAK,GAAG,KACP,CAAC,EAUH,CAAC"}

package/bin/util.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniqueBy = exports.omit = void 0;
+const omit = (obj, ...keys) => {
+    const result = { ...obj };
+    for (const k of keys) {
+        delete result[k];
+    }
+    return result;
+};
+exports.omit = omit;
+const uniqueBy = (arr, key) => {
+    const seen = new Set();
+    return arr.filter((x) => {
+        const k = key(x);
+        if (seen.has(k)) {
+            return false;
+        }
+        seen.add(k);
+        return true;
+    });
+};
+exports.uniqueBy = uniqueBy;
+//# sourceMappingURL=util.js.map

package/bin/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":";;;AAAO,MAAM,IAAI,GAAG,CAIlB,GAAM,EACN,GAAG,IAAY,EACA,EAAE;IACjB,MAAM,MAAM,GAAkB,EAAE,GAAG,GAAG,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,CAAmC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAdW,QAAA,IAAI,QAcf;AAEK,MAAM,QAAQ,GAAG,CACtB,GAAQ,EACR,GAAQ,EACH,EAAE;IACP,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAbW,QAAA,QAAQ,YAanB"}

package/dist/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/common/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/common/types.d.ts

@@ -0,0 +1,4 @@
+export type LooseSyncFunction = (...args: any[]) => any;
+export type LooseAsyncFunction = (...args: any[]) => Promise<any>;
+export type LooseFunction = LooseSyncFunction | LooseAsyncFunction;
+//# sourceMappingURL=types.d.ts.map

package/dist/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AACxD,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,CAAC"}

package/dist/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":""}

package/dist/endpoint.d.ts

@@ -0,0 +1,6 @@
+export type EndpointPart = {
+    type: 'path' | 'variable';
+    value: string;
+};
+export declare const parseEndpoint: (buff: string) => EndpointPart[];
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,YAAY,EAwCxD,CAAC"}

package/dist/endpoint.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEndpoint = void 0;
+const parseEndpoint = (buff) => {
+    const slices = [];
+    const len = buff.length;
+    let i = 0;
+    let c = buff[i++];
+    const advance = () => {
+        c = buff[i++];
+        return c;
+    };
+    while (i <= len) {
+        if (c !== "[" && c !== '/' && i <= len) {
+            let param = "";
+            while (c !== "/" && c !== "[" && i <= len) {
+                param += c;
+                c = advance();
+            }
+            slices.push({
+                type: 'path',
+                value: param,
+            });
+        }
+        if (c === "[") {
+            let param = "";
+            c = advance();
+            while (c !== "]" && i < len) {
+                param += c;
+                c = advance();
+            }
+            slices.push({
+                type: 'variable',
+                value: param,
+            });
+        }
+        c = advance();
+    }
+    return slices;
+};
+exports.parseEndpoint = parseEndpoint;
+//# sourceMappingURL=endpoint.js.map

package/dist/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":";;;AAKO,MAAM,aAAa,GAAG,CAAC,IAAY,EAAkB,EAAE;IAC5D,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,GAAW,CAAC,CAAC;IAClB,IAAI,CAAC,GAAW,IAAI,CAAC,CAAC,EAAE,CAAE,CAAC;IAE3B,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACvC,IAAI,KAAK,GAAW,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;gBAC1C,KAAK,IAAI,CAAC,CAAC;gBACX,CAAC,GAAG,OAAO,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,IAAI,KAAK,GAAW,EAAE,CAAC;YACvB,CAAC,GAAG,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;gBAC5B,KAAK,IAAI,CAAC,CAAC;gBACX,CAAC,GAAG,OAAO,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QAED,CAAC,GAAG,OAAO,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAxCW,QAAA,aAAa,iBAwCxB"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './endpoint';
+export * from './router';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./endpoint"), exports);
+__exportStar(require("./router"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB"}

package/dist/router.d.ts

@@ -0,0 +1,21 @@
+import { LooseFunction } from "./common";
+import { EndpointPart } from "./endpoint";
+export interface RouterConfig {
+    routesDir: string;
+}
+export type RouteStructure = {
+    filepath: string;
+    children: RouteStructure[];
+};
+export type RouteMethods = Record<string, LooseFunction>;
+export type RouteDefinition = {
+    filepath: string;
+    relativepath: string;
+    endpoint: string;
+    args: EndpointPart[];
+    methods: RouteMethods;
+    children: RouteDefinition[];
+};
+export type FlatRouteDefinition = Omit<RouteDefinition, "children">;
+export declare const getRoutes: (cfg: RouterConfig) => Promise<FlatRouteDefinition[]>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAIzD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;AAsGpE,eAAO,MAAM,SAAS,GACpB,KAAK,YAAY,KAChB,OAAO,CAAC,mBAAmB,EAAE,CAK/B,CAAC"}

package/dist/router.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoutes = void 0;
+const util_1 = require("./util");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const endpoint_1 = require("./endpoint");
+// ---- implementation ----
+const getEntries = async (path) => {
+    const entries = (await promises_1.default.readdir(path, {
+        recursive: false,
+        withFileTypes: true,
+    })).filter((entry) => {
+        return ((entry.isDirectory() || entry.name.endsWith(".ts")) &&
+            !entry.name.includes("#") &&
+            !entry.name.includes("~"));
+    });
+    return entries;
+};
+const findRouteStructure = async (path) => {
+    const entries = await getEntries(path);
+    const children = (await Promise.all(entries.map(async (entry) => {
+        const abspath = path_1.default.join(entry.parentPath, entry.name);
+        if (entry.isDirectory()) {
+            return await findRouteStructure(abspath);
+        }
+        return {
+            filepath: abspath,
+            children: [],
+        };
+    }))).flat();
+    return {
+        filepath: path,
+        children: children,
+    };
+};
+const findRouteDefs = async (rootPath, structure) => {
+    const relativepath = path_1.default.relative(rootPath, structure.filepath);
+    const endpoint = "/" +
+        [relativepath]
+            .map((x) => x.replace("index.ts", "").replace(".ts", ""))
+            .map((x) => (x.endsWith("/") ? x.slice(0, -1) : x))[0];
+    return {
+        filepath: structure.filepath,
+        relativepath: relativepath,
+        endpoint: endpoint,
+        args: (0, endpoint_1.parseEndpoint)(endpoint),
+        methods: {},
+        children: await Promise.all(structure.children.map(async (child) => {
+            return findRouteDefs(rootPath, child);
+        })),
+    };
+};
+const flattenRoutes = async (defs) => {
+    const items = [];
+    const q = [defs];
+    const seen = new Set();
+    while (q.length > 0) {
+        const next = q.pop();
+        if (seen.has(next.endpoint))
+            continue;
+        seen.add(next.endpoint);
+        const methods = {};
+        try {
+            const module = await import(next.filepath);
+            for (const [k, v] of Object.entries(module)) {
+                if (typeof v === "function") {
+                    methods[k] = v;
+                }
+            }
+        }
+        catch (e) {
+            console.error(e);
+        }
+        items.push((0, util_1.omit)({ ...next, methods }, "children"));
+        q.push(...next.children);
+    }
+    return (0, util_1.uniqueBy)(items, (x) => x.endpoint);
+};
+const getRoutes = async (cfg) => {
+    const rootPath = path_1.default.resolve(cfg.routesDir);
+    const structure = await findRouteStructure(rootPath);
+    const defs = await findRouteDefs(rootPath, structure);
+    return await flattenRoutes(defs);
+};
+exports.getRoutes = getRoutes;
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/util.d.ts

@@ -0,0 +1,3 @@
+export declare const omit: <T extends Record<PropertyKey, unknown>, Keys extends keyof T>(obj: T, ...keys: Keys[]) => Omit<T, Keys>;
+export declare const uniqueBy: <T, Key extends (item: T) => unknown>(arr: T[], key: Key) => T[];
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,GACf,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,IAAI,SAAS,MAAM,CAAC,EAEpB,KAAK,CAAC,EACN,GAAG,MAAM,IAAI,EAAE,KACd,IAAI,CAAC,CAAC,EAAE,IAAI,CAQd,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,EAC1D,KAAK,CAAC,EAAE,EACR,KAAK,GAAG,KACP,CAAC,EAUH,CAAC"}

package/dist/util.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniqueBy = exports.omit = void 0;
+const omit = (obj, ...keys) => {
+    const result = { ...obj };
+    for (const k of keys) {
+        delete result[k];
+    }
+    return result;
+};
+exports.omit = omit;
+const uniqueBy = (arr, key) => {
+    const seen = new Set();
+    return arr.filter((x) => {
+        const k = key(x);
+        if (seen.has(k)) {
+            return false;
+        }
+        seen.add(k);
+        return true;
+    });
+};
+exports.uniqueBy = uniqueBy;
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":";;;AAAO,MAAM,IAAI,GAAG,CAIlB,GAAM,EACN,GAAG,IAAY,EACA,EAAE;IACjB,MAAM,MAAM,GAAkB,EAAE,GAAG,GAAG,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,CAAmC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAdW,QAAA,IAAI,QAcf;AAEK,MAAM,QAAQ,GAAG,CACtB,GAAQ,EACR,GAAQ,EACH,EAAE;IACP,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAbW,QAAA,QAAQ,YAanB"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "dirent-router",
+  "version": "1.0.0",
+  "description": "",
+  "main": "./src/index.ts",
+  "types": "./dist/index.d.ts",
+  "typings": "./dist/index.d.ts",
+  "bin": {
+    "dirent-router": "./bin/bin.js"
+  },
+  "scripts": {
+    "test": "vitest",
+    "build:lib": "tsc -p ./tsconfig.lib.json",
+    "build:bin": "tsc -p ./tsconfig.bin.json",
+    "build": "pnpm build:lib && pnpm build:bin",
+    "check": "tsc -p ./tsconfig.json --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.28.2",
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/sample-routes/companies/[id]/index.ts

@@ -0,0 +1,3 @@
+export const get = (id: string) => {
+  return { id };
+}

package/sample-routes/companies/index.ts

@@ -0,0 +1,7 @@
+export const get = () => {
+  return [{ id: 'a' }, { id: 'b' }]
+}
+
+export const post = () => {
+  return { ok: true };
+}

package/sample-routes/companies/search.ts

@@ -0,0 +1,3 @@
+export const get = (searchQuery: string) => {
+  return { searchQuery };
+}

package/sample-routes/index.ts

@@ -0,0 +1,3 @@
+export const get = () => {
+  return 'foo';
+}

package/src/bin.ts

@@ -0,0 +1,27 @@
+import fs from "fs";
+import { getRoutes } from "./router";
+
+const main = async () => {
+  const routesDir = process.argv[2];
+  if (!routesDir) {
+    console.error(`Please provide directory where routes are stored`);
+    return;
+  }
+  if (!fs.existsSync(routesDir)) {
+    console.error(`${routesDir}: No such file or directory`);
+    return;
+  }
+  const routes = await getRoutes({
+    routesDir,
+  });
+
+  console.log(
+    JSON.stringify(
+      routes,
+      (_, v) => (typeof v === "function" ? `${v.name}(...)` : v),
+      2,
+    ),
+  );
+};
+
+main().catch((e) => console.error(e));

package/src/common/index.ts

@@ -0,0 +1 @@
+export * from './types';

package/src/common/types.ts

@@ -0,0 +1,3 @@
+export type LooseSyncFunction = (...args: any[]) => any;
+export type LooseAsyncFunction = (...args: any[]) => Promise<any>;
+export type LooseFunction = LooseSyncFunction | LooseAsyncFunction;

package/src/endpoint.test.ts

@@ -0,0 +1,60 @@
+import { describe, assert } from "vitest";
+import { EndpointPart, parseEndpoint } from "./endpoint";
+
+type ParseExpect = {
+  input: string;
+  output: EndpointPart[];
+};
+
+const EXPECTED_RESULTS: Array<ParseExpect> = [
+  {
+    input: "/index.ts",
+    output: [
+      {
+        type: "path",
+        value: "index.ts",
+      },
+    ],
+  },
+  {
+    input: "/user/[id]/index.ts",
+    output: [
+      { type: "path", value: "user" },
+      { type: "variable", value: "id" },
+      { type: "path", value: "index.ts" },
+    ],
+  },
+  {
+    input: "/user/foobar.ts",
+    output: [
+      { type: "path", value: "user" },
+      { type: "path", value: "foobar.ts" },
+    ],
+  },
+  {
+    input: "/user/[id]/entity/[id]/index.ts",
+    output: [
+      { type: "path", value: "user" },
+      { type: "variable", value: "id" },
+      { type: "path", value: "entity" },
+      { type: "variable", value: "id" },
+      { type: "path", value: "index.ts" },
+    ],
+  },
+];
+
+describe("Parse route path", (it) => {
+  it("should create correct slices", () => {
+    for (const expected of EXPECTED_RESULTS) {
+      const output = parseEndpoint(expected.input);
+      assert.strictEqual(output.length, expected.output.length);
+      for (let i = 0; i < output.length; i++) {
+        const a = output[i]!;
+        const b = expected.output[i]!;
+
+        assert.strictEqual(a.value, b.value);
+        assert.strictEqual(a.type, b.type);
+      }
+    }
+  });
+});

package/src/endpoint.ts

@@ -0,0 +1,46 @@
+export type EndpointPart = {
+  type: 'path' | 'variable';
+  value: string;
+};
+
+export const parseEndpoint = (buff: string): EndpointPart[] => {
+  const slices: EndpointPart[] = [];
+  const len = buff.length;
+  let i: number = 0;
+  let c: string = buff[i++]!;
+
+  const advance = () => {
+    c = buff[i++]!;
+    return c;
+  };
+
+  while (i <= len) {
+    if (c !== "[" && c !== '/' && i <= len) {
+      let param: string = "";
+      while (c !== "/" && c !== "[" && i <= len) {
+        param += c;
+        c = advance();
+      }
+      slices.push({
+        type: 'path',
+        value: param,
+      });
+    }
+    if (c === "[") {
+      let param: string = "";
+      c = advance();
+      while (c !== "]" && i < len) {
+        param += c;
+        c = advance();
+      }
+      slices.push({
+        type: 'variable',
+        value: param,
+      });
+    }
+
+    c = advance();
+  }
+
+  return slices;
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './endpoint';
+export * from './router';

package/src/router.ts

@@ -0,0 +1,139 @@
+import { omit, uniqueBy } from "./util";
+import { Dirent } from "fs";
+import fs from "fs/promises";
+import pathlib from "path";
+import { LooseFunction } from "./common";
+import { EndpointPart, parseEndpoint } from "./endpoint";
+
+// ---- types ----
+
+export interface RouterConfig {
+  routesDir: string;
+}
+
+export type RouteStructure = {
+  filepath: string;
+  children: RouteStructure[];
+};
+
+export type RouteMethods = Record<string, LooseFunction>;
+
+export type RouteDefinition = {
+  filepath: string;
+  relativepath: string;
+  endpoint: string;
+  args: EndpointPart[];
+  methods: RouteMethods;
+  children: RouteDefinition[];
+};
+
+export type FlatRouteDefinition = Omit<RouteDefinition, "children">;
+
+// ---- implementation ----
+
+const getEntries = async (path: string) => {
+  const entries: Dirent<string>[] = (
+    await fs.readdir(path, {
+      recursive: false,
+      withFileTypes: true,
+    })
+  ).filter((entry) => {
+    return (
+      (entry.isDirectory() || entry.name.endsWith(".ts")) &&
+      !entry.name.includes("#") &&
+      !entry.name.includes("~")
+    );
+  });
+  return entries;
+};
+
+const findRouteStructure = async (path: string): Promise<RouteStructure> => {
+  const entries = await getEntries(path);
+  const children = (
+    await Promise.all(
+      entries.map(async (entry): Promise<RouteStructure> => {
+        const abspath = pathlib.join(entry.parentPath, entry.name);
+        if (entry.isDirectory()) {
+          return await findRouteStructure(abspath);
+        }
+
+        return {
+          filepath: abspath,
+          children: [],
+        };
+      }),
+    )
+  ).flat();
+
+  return {
+    filepath: path,
+    children: children,
+  };
+};
+
+const findRouteDefs = async (
+  rootPath: string,
+  structure: RouteStructure,
+): Promise<RouteDefinition> => {
+  const relativepath = pathlib.relative(rootPath, structure.filepath);
+  const endpoint =
+    "/" +
+    [relativepath]
+      .map((x) => x.replace("index.ts", "").replace(".ts", ""))
+      .map((x) => (x.endsWith("/") ? x.slice(0, -1) : x))[0]!;
+
+  return {
+    filepath: structure.filepath,
+    relativepath: relativepath,
+    endpoint: endpoint,
+    args: parseEndpoint(endpoint),
+    methods: {},
+    children: await Promise.all(
+      structure.children.map(async (child) => {
+        return findRouteDefs(rootPath, child);
+      }),
+    ),
+  };
+};
+
+const flattenRoutes = async (
+  defs: RouteDefinition,
+): Promise<FlatRouteDefinition[]> => {
+  const items: FlatRouteDefinition[] = [];
+  const q: Array<RouteDefinition> = [defs];
+  const seen = new Set<string>();
+
+  while (q.length > 0) {
+    const next = q.pop()!;
+    if (seen.has(next.endpoint)) continue;
+    seen.add(next.endpoint);
+
+    const methods: RouteMethods = {};
+
+    try {
+      const module = await import(next.filepath);
+
+      for (const [k, v] of Object.entries(module)) {
+        if (typeof v === "function") {
+          (methods as Record<string, unknown>)[k] = v;
+        }
+      }
+    } catch (e) {
+      console.error(e);
+    }
+
+    items.push(omit({ ...next, methods }, "children"));
+    q.push(...next.children);
+  }
+
+  return uniqueBy(items, (x) => x.endpoint);
+};
+
+export const getRoutes = async (
+  cfg: RouterConfig,
+): Promise<FlatRouteDefinition[]> => {
+  const rootPath = pathlib.resolve(cfg.routesDir);
+  const structure = await findRouteStructure(rootPath);
+  const defs = await findRouteDefs(rootPath, structure);
+  return await flattenRoutes(defs);
+};

package/src/util.ts

@@ -0,0 +1,30 @@
+export const omit = <
+  T extends Record<PropertyKey, unknown>,
+  Keys extends keyof T,
+>(
+  obj: T,
+  ...keys: Keys[]
+): Omit<T, Keys> => {
+  const result: Omit<T, Keys> = { ...obj };
+
+  for (const k of keys) {
+    delete result[k as unknown as keyof typeof result];
+  }
+
+  return result;
+};
+
+export const uniqueBy = <T, Key extends (item: T) => unknown>(
+  arr: T[],
+  key: Key,
+): T[] => {
+  const seen = new Set<unknown>();
+  return arr.filter((x) => {
+    const k = key(x);
+    if (seen.has(k)) {
+      return false;
+    }
+    seen.add(k);
+    return true;
+  });
+};

package/tsconfig.bin.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./bin",
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "types": ["node"],
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "strict": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["./src/bin.ts"],
+  "exclude": ["./src/**/*.test.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "emit": false,
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "types": ["node"],
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "strict": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["./src/**/*.ts"]
+}

package/tsconfig.lib.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext"],
+    "types": ["node"],
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "strict": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["./src/**/*.ts"],
+  "exclude": ["./src/**/*.test.ts", "./src/bin.ts"]
+}