lynnix 0.0.1

package/dist/utils/parseReqBody.js

@@ -0,0 +1,415 @@
+/**
+ * Lynnix
+ * File-based hypermedia routing middleware for Node.js, Mutor.js, and HTMX.
+ *
+ * @author Onah Victor <victoronah.dev@gmail.com>
+ * @repository https://github.com/allAboutJS/Lynnix
+ * @license MIT
+ */
+/**
+ * Parse an incoming request body into a Lynnix-friendly shape.
+ *
+ * Supported content types:
+ * - `application/json`
+ * - `application/x-www-form-urlencoded`
+ * - `multipart/form-data`
+ *
+ * Parsed text values are assigned to `req.body` and uploaded files are assigned
+ * to `req.files`, similar to middleware such as multer/formidable.
+ *
+ * Design goals:
+ * - stream-based parsing for forms/uploads
+ * - bounded in-memory buffering for cross-environment compatibility
+ * - no temporary filesystem dependency, so it works in serverless runtimes too
+ * - dynamic imports for optional peer dependencies like `@fastify/busboy` and `qs`
+ */
+const DEFAULT_BODY_LIMIT = 1024 * 1024;
+const DEFAULT_FILE_SIZE_LIMIT = 10 * 1024 * 1024;
+const DEFAULT_FILE_COUNT_LIMIT = 10;
+const DEFAULT_FIELD_COUNT_LIMIT = 100;
+const DEFAULT_PART_COUNT_LIMIT = 110;
+let bodyParserJsonPromise = null;
+let busboyConstructorPromise = null;
+let qsModulePromise = null;
+export default async function parseReqBody(req, res, options = {}) {
+    const rawReq = req.raw;
+    if (!rawReq.method || ["GET", "HEAD"].includes(rawReq.method.toUpperCase())) {
+        const result = { body: {}, files: {} };
+        req.body = result.body;
+        req.files = result.files;
+        return result;
+    }
+    const contentType = getHeaderValue(rawReq.headers["content-type"]).toLowerCase();
+    if (!contentType) {
+        const result = { body: {}, files: {} };
+        req.body = result.body;
+        req.files = result.files;
+        return;
+    }
+    if (contentType.includes("application/json")) {
+        const result = await parseJsonRequestBody(req, res, options);
+        if (result) {
+            req.body = result.body;
+            req.files = result.files;
+        }
+        return;
+    }
+    if (contentType.includes("application/x-www-form-urlencoded")) {
+        const result = await parseUrlEncodedBody(req, options);
+        if (result) {
+            req.body = result.body;
+            req.files = result.files;
+        }
+        return;
+    }
+    if (contentType.includes("multipart/form-data")) {
+        const result = await parseMultipartBody(req, options);
+        if (result) {
+            req.body = result.body;
+            req.files = result.files;
+        }
+        return;
+    }
+    const result = { body: {}, files: {} };
+    req.body = result.body;
+    req.files = result.files;
+    return result;
+}
+async function parseJsonRequestBody(req, res, options) {
+    const createJsonParser = await loadJsonBodyParser();
+    // Return early if the JSON parser is not available
+    if (!createJsonParser) {
+        console.error(`[Lynnix] Parsing JSON requests requires the optional peer dependency "body-parser"`);
+        return;
+    }
+    const jsonParser = createJsonParser({
+        limit: options.jsonLimit ?? options.bodyLimit ?? DEFAULT_BODY_LIMIT,
+    });
+    const rawReq = req.raw;
+    await new Promise((resolve, reject) => {
+        jsonParser(rawReq, res.raw, (error) => {
+            if (error) {
+                reject(normalizeError(error, "Failed to parse JSON request body"));
+                return;
+            }
+            resolve();
+        });
+    });
+    return {
+        body: (rawReq.body ?? {}),
+        files: {},
+    };
+}
+async function parseUrlEncodedBody(req, options) {
+    const Busboy = await loadBusboy();
+    const entries = [];
+    const rawReq = req.raw;
+    // Allow URL-encoded body parsing only if Busboy is available
+    if (!Busboy) {
+        console.error(`[Lynnix] Parsing URL-encoded requests requires the optional peer dependency "@fastify/busboy"`);
+        return;
+    }
+    return new Promise((resolve, reject) => {
+        const busboy = new Busboy({
+            headers: rawReq.headers,
+            limits: {
+                fieldNameSize: options.fieldNameSize,
+                fieldSize: options.fieldSize ?? options.bodyLimit ?? DEFAULT_BODY_LIMIT,
+                fields: options.fields ?? DEFAULT_FIELD_COUNT_LIMIT,
+            },
+        });
+        let settled = false;
+        const fail = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            reject(error);
+        };
+        busboy.on("field", (fieldName, value, fieldNameTruncated, valueTruncated) => {
+            if (fieldNameTruncated) {
+                fail(new Error(`Urlencoded field name exceeded the allowed size: ${fieldName}`));
+                return;
+            }
+            if (valueTruncated) {
+                fail(new Error(`Urlencoded field value exceeded the allowed size: ${fieldName}`));
+                return;
+            }
+            entries.push([fieldName, value]);
+        });
+        busboy.on("fieldsLimit", () => {
+            fail(new Error("Urlencoded request exceeded the configured field limit"));
+        });
+        busboy.on("partsLimit", () => {
+            fail(new Error("Urlencoded request exceeded the configured parts limit"));
+        });
+        busboy.on("error", (error) => {
+            fail(normalizeError(error, "Failed to parse urlencoded request body"));
+        });
+        busboy.on("finish", async () => {
+            if (settled) {
+                return;
+            }
+            try {
+                const body = await parseUrlEncodedEntries(entries, options);
+                settled = true;
+                resolve({ body, files: {} });
+            }
+            catch (error) {
+                fail(normalizeError(error, "Failed to parse urlencoded request body"));
+            }
+        });
+        rawReq.pipe(busboy);
+    });
+}
+async function parseMultipartBody(req, options) {
+    const Busboy = await loadBusboy();
+    if (!Busboy) {
+        console.error(`[Lynnix] Parsing multipart requests requires the optional peer dependency "@fastify/busboy"`);
+        return;
+    }
+    const body = {};
+    const files = {};
+    const filePromises = [];
+    const allowedMimeTypes = options.allowedMimeTypes ?? null;
+    const allowMultipleFilesPerField = options.allowMultipleFilesPerField ?? false;
+    const rawReq = req.raw;
+    return new Promise((resolve, reject) => {
+        const busboy = new Busboy({
+            headers: rawReq.headers,
+            preservePath: options.preservePath ?? false,
+            limits: {
+                fieldNameSize: options.fieldNameSize,
+                fieldSize: options.fieldSize ?? DEFAULT_BODY_LIMIT,
+                fields: options.fields ?? DEFAULT_FIELD_COUNT_LIMIT,
+                fileSize: options.fileSize ?? DEFAULT_FILE_SIZE_LIMIT,
+                files: options.files ?? DEFAULT_FILE_COUNT_LIMIT,
+                parts: options.parts ?? DEFAULT_PART_COUNT_LIMIT,
+                headerPairs: options.headerPairs,
+                headerSize: options.headerSize,
+            },
+        });
+        let settled = false;
+        const fail = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            reject(error);
+        };
+        busboy.on("field", (fieldName, value, fieldNameTruncated, valueTruncated) => {
+            if (fieldNameTruncated) {
+                fail(new Error(`Multipart field name exceeded the allowed size: ${fieldName}`));
+                return;
+            }
+            if (valueTruncated) {
+                fail(new Error(`Multipart field value exceeded the allowed size: ${fieldName}`));
+                return;
+            }
+            appendValue(body, fieldName, value);
+        });
+        busboy.on("file", (fieldName, stream, filename, encoding, mimeType) => {
+            // Busboy can surface unnamed file parts. If there is no filename, we
+            // treat the part as discardable and drain the stream so parsing can finish.
+            if (!filename) {
+                stream.resume();
+                return;
+            }
+            // Reject unsupported uploads as early as possible, but always resume the
+            // stream first so Busboy can continue consuming the rest of the request.
+            if (allowedMimeTypes && !matchesMimeType(mimeType, allowedMimeTypes)) {
+                stream.resume();
+                fail(new Error(`File field ${fieldName} uses unsupported mime type ${mimeType}`));
+                return;
+            }
+            // Enforce the single-file-per-field contract before buffering anything.
+            if (!allowMultipleFilesPerField && files[fieldName]) {
+                stream.resume();
+                fail(new Error(`Multiple files are not allowed for the field ${fieldName}`));
+                return;
+            }
+            // File contents are buffered in memory with size limits instead of being
+            // written to disk. This keeps the parser portable across Node servers and
+            // serverless environments where temp storage may be unavailable.
+            const filePromise = consumeFileStream(stream, fieldName, filename, encoding, mimeType).then((file) => {
+                appendFile(files, fieldName, file, allowMultipleFilesPerField);
+            });
+            filePromises.push(filePromise.catch((error) => fail(normalizeError(error, "Failed to read uploaded file"))));
+        });
+        busboy.on("filesLimit", () => {
+            fail(new Error("Multipart request exceeded the configured file limit"));
+        });
+        busboy.on("fieldsLimit", () => {
+            fail(new Error("Multipart request exceeded the configured field limit"));
+        });
+        busboy.on("partsLimit", () => {
+            fail(new Error("Multipart request exceeded the configured parts limit"));
+        });
+        busboy.on("error", (error) => {
+            fail(normalizeError(error, "Failed to parse multipart request body"));
+        });
+        busboy.on("finish", () => {
+            Promise.all(filePromises)
+                .then(() => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                resolve({ body, files });
+            })
+                .catch((error) => {
+                fail(normalizeError(error, "Failed to finalize multipart request body"));
+            });
+        });
+        rawReq.pipe(busboy);
+    });
+}
+/**
+ * Consume one uploaded file stream into a bounded in-memory buffer.
+ *
+ * The stream is fully drained so Busboy can complete parsing, but uploads that
+ * hit configured limits are rejected instead of being silently truncated.
+ */
+async function consumeFileStream(stream, fieldName, filename, encoding, mimeType) {
+    const chunks = [];
+    let size = 0;
+    let limitReached = false;
+    return new Promise((resolve, reject) => {
+        // Busboy emits `limit` when the configured file size is exceeded. We keep
+        // draining until `end`, then reject with a deterministic error.
+        stream.on("limit", () => {
+            limitReached = true;
+        });
+        stream.on("data", (chunk) => {
+            const buffer = toBuffer(chunk);
+            size += buffer.length;
+            chunks.push(buffer);
+        });
+        stream.on("error", (error) => {
+            reject(normalizeError(error, `Failed to process uploaded file ${filename}`));
+        });
+        stream.on("end", () => {
+            // Reject oversized files instead of returning partial buffers. That keeps
+            // downstream handlers from accidentally treating truncated uploads as valid.
+            if (limitReached || stream.truncated) {
+                reject(new Error(`Uploaded file for field ${fieldName} exceeded the configured file size limit`));
+                return;
+            }
+            resolve({
+                fieldName,
+                filename,
+                encoding,
+                mimeType,
+                size,
+                buffer: Buffer.concat(chunks),
+                truncated: false,
+            });
+        });
+    });
+}
+async function parseUrlEncodedEntries(entries, options) {
+    if (!entries.length) {
+        return {};
+    }
+    const queryString = entries
+        .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+        .join("&");
+    const qsModule = await loadQsModule();
+    if (qsModule) {
+        return qsModule.parse(queryString, options.qsOptions);
+    }
+    const fallback = {};
+    for (let i = 0; i < entries.length; i++) {
+        const [key, value] = entries[i];
+        appendValue(fallback, key, value);
+    }
+    return fallback;
+}
+async function loadJsonBodyParser() {
+    if (!bodyParserJsonPromise) {
+        bodyParserJsonPromise = import("body-parser")
+            .then((mod) => mod.default.json.bind(mod.default))
+            .catch(() => {
+            console.log(`[Lynnix] Parsing JSON requests requires the optional peer dependency "body-parser"`);
+            return null;
+        });
+    }
+    return bodyParserJsonPromise;
+}
+async function loadBusboy() {
+    if (!busboyConstructorPromise) {
+        busboyConstructorPromise = import("@fastify/busboy")
+            .then((mod) => mod.default)
+            .catch(() => {
+            console.log(`[Lynnix] Parsing form requests requires the optional peer dependency "@fastify/busboy"`);
+            return null;
+        });
+    }
+    return busboyConstructorPromise;
+}
+async function loadQsModule() {
+    if (!qsModulePromise) {
+        qsModulePromise = import("qs")
+            .then((mod) => ({ parse: mod.default.parse.bind(mod.default) }))
+            .catch(() => {
+            console.log(`[Lynnix] Parsing search queries requires the optional peer dependency "qs"`);
+            return null;
+        });
+    }
+    return qsModulePromise;
+}
+function appendValue(target, key, value) {
+    const existing = target[key];
+    if (typeof existing === "undefined") {
+        target[key] = value;
+        return;
+    }
+    if (Array.isArray(existing)) {
+        existing.push(value);
+        return;
+    }
+    target[key] = [existing, value];
+}
+function appendFile(target, key, file, allowMultipleFilesPerField) {
+    const existing = target[key];
+    if (typeof existing === "undefined") {
+        target[key] = allowMultipleFilesPerField ? [file] : file;
+        return;
+    }
+    if (Array.isArray(existing)) {
+        existing.push(file);
+        return;
+    }
+    target[key] = [existing, file];
+}
+function matchesMimeType(mimeType, allowedMimeTypes) {
+    for (let i = 0; i < allowedMimeTypes.length; i++) {
+        const allowed = allowedMimeTypes[i];
+        if (allowed === mimeType) {
+            return true;
+        }
+        if (allowed.endsWith("/*")) {
+            const prefix = allowed.slice(0, allowed.indexOf("/"));
+            if (mimeType.startsWith(`${prefix}/`)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function getHeaderValue(value) {
+    if (Array.isArray(value)) {
+        return value[0] ?? "";
+    }
+    return value ?? "";
+}
+function normalizeError(error, fallbackMessage) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(fallbackMessage);
+}
+function toBuffer(chunk) {
+    return Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+}
+//# sourceMappingURL=parseReqBody.js.map

package/dist/utils/parseReqBody.js.map

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

package/dist/utils/runMiddlewares.d.ts

@@ -0,0 +1,5 @@
+import type { RoutesMap } from "../types.js";
+import type LynnixRequest from "./lynnixRequest.js";
+import type LynnixResponse from "./lynnixResponse.js";
+export default function runMiddlewares(req: LynnixRequest, res: LynnixResponse, route: string, routesMap: RoutesMap): Promise<void>;
+//# sourceMappingURL=runMiddlewares.d.ts.map

package/dist/utils/runMiddlewares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMiddlewares.d.ts","sourceRoot":"","sources":["../../src/utils/runMiddlewares.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAEtD,wBAA8B,cAAc,CAC3C,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,iBAqBpB"}

package/dist/utils/runMiddlewares.js

@@ -0,0 +1,18 @@
+import { pathToFileURL } from "node:url";
+import getMiddlewareChain from "./getMiddlewareChain.js";
+export default async function runMiddlewares(req, res, route, routesMap) {
+    const middlewareChain = getMiddlewareChain(route, routesMap);
+    for (let i = 0; i < middlewareChain.length; i++) {
+        const middlewarePath = middlewareChain[i];
+        const mod = await import(pathToFileURL(middlewarePath).href);
+        if (typeof mod?.default !== "function") {
+            console.warn(`[Lynnix] Middleware at ${middlewarePath} is not a function`);
+            continue;
+        }
+        await mod.default(req, res);
+        if (res.raw.writableEnded) {
+            return;
+        }
+    }
+}
+//# sourceMappingURL=runMiddlewares.js.map

package/dist/utils/runMiddlewares.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMiddlewares.js","sourceRoot":"","sources":["../../src/utils/runMiddlewares.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,kBAAkB,MAAM,yBAAyB,CAAC;AAIzD,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,cAAc,CAC3C,GAAkB,EAClB,GAAmB,EACnB,KAAa,EACb,SAAoB;IAEpB,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,cAAc,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC;QAE7D,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,CACX,0BAA0B,cAAc,oBAAoB,CAC5D,CAAC;YACF,SAAS;QACV,CAAC;QAED,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE5B,IAAI,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YAC3B,OAAO;QACR,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/utils/sortRoutes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lynnix
+ * File-based hypermedia routing middleware for Node.js, Mutor.js, and HTMX.
+ *
+ * @author Onah Victor <victoronah.dev@gmail.com>
+ * @repository https://github.com/allAboutJS/Lynnix
+ * @license MIT
+ */
+/**
+ * Sorts an array of routes, placing static routes before dynamic routes.
+ *
+ * @param routes An array of routes to sort.
+ * @returns The sorted array of routes.
+ */
+export declare function sortRoutes(routes: string[]): string[];
+//# sourceMappingURL=sortRoutes.d.ts.map

package/dist/utils/sortRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortRoutes.d.ts","sourceRoot":"","sources":["../../src/utils/sortRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,YAqC1C"}

package/dist/utils/sortRoutes.js

@@ -0,0 +1,44 @@
+/**
+ * Lynnix
+ * File-based hypermedia routing middleware for Node.js, Mutor.js, and HTMX.
+ *
+ * @author Onah Victor <victoronah.dev@gmail.com>
+ * @repository https://github.com/allAboutJS/Lynnix
+ * @license MIT
+ */
+/**
+ * Sorts an array of routes, placing static routes before dynamic routes.
+ *
+ * @param routes An array of routes to sort.
+ * @returns The sorted array of routes.
+ */
+export function sortRoutes(routes) {
+    const isCatchAll = (route) => /\[\[.*\]\]/.test(route);
+    const isDynamic = (route) => /\[.*\]/.test(route);
+    const depth = (route) => route.split("/").filter(Boolean).length;
+    const staticCount = (route) => route.split("/").filter((seg) => seg && !/^\[/.test(seg)).length;
+    return routes.sort((a, b) => {
+        const aCatchAll = isCatchAll(a);
+        const bCatchAll = isCatchAll(b);
+        if (aCatchAll !== bCatchAll) {
+            return aCatchAll ? 1 : -1;
+        }
+        const aDynamic = isDynamic(a);
+        const bDynamic = isDynamic(b);
+        if (aDynamic !== bDynamic) {
+            return aDynamic ? 1 : -1;
+        }
+        // Within catch-all tier: deeper prefix is more specific, wins
+        if (aCatchAll) {
+            return depth(b) - depth(a);
+        }
+        // Within static/dynamic tier: more static segments = more specific, wins
+        const staticDiff = staticCount(b) - staticCount(a);
+        if (staticDiff !== 0) {
+            return staticDiff;
+        }
+        // Same static segment count: shallower wins
+        return depth(a) - depth(b);
+    });
+}
+//# sourceMappingURL=sortRoutes.js.map

package/dist/utils/sortRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortRoutes.js","sourceRoot":"","sources":["../../src/utils/sortRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB;IAC1C,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE,CACrC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAElE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAEhC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAE9B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,8DAA8D;QAC9D,IAAI,SAAS,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,yEAAyE;QACzE,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAEnD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,UAAU,CAAC;QACnB,CAAC;QAED,4CAA4C;QAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+	"name": "lynnix",
+	"version": "0.0.1",
+	"description": "File-based hypermedia routing middleware for Node.js and HTMX",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/types.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"scripts": {
+		"build": "tsc",
+		"prepublishOnly": "npm run build"
+	},
+	"repository": "https://github.com/allaboutjs/lynnix",
+	"author": "Onah Victor",
+	"license": "MIT",
+	"private": false,
+	"type": "module",
+	"dependencies": {
+		"mutorjs": "^3.0.2"
+	},
+	"peerDependencies": {
+		"@fastify/busboy": "^3.2.0",
+		"body-parser": "^2.3.0",
+		"cookie": "^1.1.1",
+		"qs": "^6.15.2"
+	},
+	"peerDependenciesMeta": {
+		"@fastify/busboy": {
+			"optional": true
+		},
+		"body-parser": {
+			"optional": true
+		},
+		"cookie": {
+			"optional": true
+		},
+		"qs": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@types/body-parser": "^1.19.6",
+		"@types/node": "^25.9.3",
+		"@types/qs": "^6.15.1",
+		"tsx": "^4.22.4"
+	},
+	"allowScripts": {
+		"esbuild@0.28.1": true
+	},
+	"keywords": [
+		"htmx",
+		"hypermedia",
+		"routing",
+		"ssr",
+		"file-based",
+		"mutor",
+		"node"
+	]
+}