gruber 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,15 @@
 {
   "name": "gruber",
   "type": "module",
+  "license": "MIT",
+  "repository": "robb-j/gruber",
+  "author": {
+    "name": "Rob Anderson",
+    "url": "https://www.r0b.io"
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
     "superstruct": "^1.0.3",
     "urlpattern-polyfill": "^9.0.0"
@@ -12,11 +21,13 @@
   },
   "exports": {
     ".": {
+      "types": "./types/mod.d.ts",
       "import": "./source/mod.js"
     },
     "./*.js": {
+      "types": "./types/*.d.ts",
       "import": "./source/*.js"
     }
   },
-  "version": "0.1.0"
+  "version": "0.2.0"
 }

package/source/node-router.js

@@ -22,7 +22,10 @@ import { FetchRouter } from "../core/fetch-router.js";
 export class NodeRouter {
 	/** @param {NodeRouterOptions} options */
 	constructor(options = {}) {
-		this.router = new FetchRouter(options.routes ?? []);
+		this.router = new FetchRouter({
+			routes: options.routes,
+			errorHandler: (error, request) => this.onRouteError(error, request),
+		});
 	}
 
 	/** @param {Request} request */
@@ -38,6 +41,10 @@ export class NodeRouter {
 		};
 	}
 
+	onRouteError(error, request) {
+		console.error("Fatal Route Error", error);
+	}
+
 	/**
 		@param {import("node:http").ServerResponse} res
 		@param {Response} response

package/source/package.json

@@ -1,6 +1,15 @@
 {
 	"name": "gruber",
 	"type": "module",
+	"license": "MIT",
+	"repository": "robb-j/gruber",
+	"author": {
+		"name": "Rob Anderson",
+		"url": "https://www.r0b.io"
+	},
+	"engines": {
+		"node": ">=20"
+	},
 	"dependencies": {
 		"superstruct": "^1.0.3",
 		"urlpattern-polyfill": "^9.0.0"

package/source/postgres.js

@@ -10,10 +10,27 @@ import {
 export { Migrator, defineMigration };
 
 /** @typedef {import("postgres").Sql} Sql */
-/** @typedef {import("../core/migrator.js").MigratorOptions} MigratorOptions */
+
+/**
+ * @template T
+ * @typedef {import("../core/migrator.js").MigratorOptions<T>} MigratorOptions
+ */
+
+/**
+ * @template T
+ * @typedef {import("../core/migrator.js").MigrationOptions<T>} MigrationOptions
+ */
 
 const migrationExtensions = new Set([".ts", ".js"]);
 
+/**
+ * TODO: this isn't documented
+ * @param {MigrationOptions<Sql>} options
+ */
+export function definePostgresMigration(options) {
+	return defineMigration(options);
+}
+
 /**
  * @typedef {object} NodePostgresMigratorOptions
  * @property {Sql} sql

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "include": [
+    "source/**/*",
+    "core/**/*"
+  ],
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "allowJs": true,
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "declarationMap": true,
+    "outDir": "types",
+    "skipLibCheck": true
+  }
+}

package/types/core/configuration.d.ts

@@ -0,0 +1,57 @@
+/** @typedef {Record<string, import("superstruct").Struct<any, any>>} ObjectSchema */
+export class Configuration {
+    static spec: symbol;
+    /** @param {ConfigurationOptions} options */
+    constructor(options: ConfigurationOptions);
+    options: ConfigurationOptions;
+    /**
+     * @template {ObjectSchema} T
+     * @param {T} spec
+     */
+    object<T extends ObjectSchema>(spec: T): any;
+    /**
+     * @template {SpecOptions} Spec @param {Spec} spec
+     * @returns {import("superstruct").Struct<string, null>}
+     */
+    string<Spec extends SpecOptions>(spec?: Spec): any;
+    /**
+     * @template {SpecOptions} Spec @param {Spec} spec
+     * @returns {import("superstruct").Struct<URL, null>}
+     */
+    url<Spec_1 extends SpecOptions>(spec: Spec_1): any;
+    /** @param {SpecOptions} spec */
+    _getValue(spec: SpecOptions): string;
+    /**
+     * @template T
+     * @param {URL} url
+     * @param {import("superstruct").Struct<T>} spec
+     * @returns {Promise<T>}
+     */
+    load<T_1>(url: URL, spec: any): Promise<T_1>;
+    /** @template T @param {T} config */
+    getUsage<T_2>(spec: any): string;
+    /**
+     * @template T @param {T} config
+     * @param {string} [prefix]
+     * @returns {{ config: any, fields: [string, string] }}
+     */
+    describeSpecification<T_3>(spec: any, prefix?: string): {
+        config: any;
+        fields: [string, string];
+    };
+}
+export type SpecOptions = {
+    variable?: string;
+    flag?: string;
+    fallback: string;
+};
+export type ConfigurationOptions = {
+    superstruct: typeof import("superstruct");
+    readTextFile: (url: URL) => Promise<string | null>;
+    getEnvironmentVariable: (key: string) => (string | undefined);
+    getCommandArgument: (key: string) => (string | undefined);
+    stringify: (value: any) => (string | Promise<string>);
+    parse: (value: string) => (any);
+};
+export type ObjectSchema = Record<string, import("superstruct").Struct<any, any>>;
+//# sourceMappingURL=configuration.d.ts.map

package/types/core/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../core/configuration.js"],"names":[],"mappings":"AA4BA,qFAAqF;AAErF;IACC,oBAA2C;IAI3C,4CAA4C;IAC5C,qBADY,oBAAoB,EAM/B;IARD,8BAA4C;IAU5C;;;OAGG;IACH,6CAOC;IAED;;;OAGG;IACH,mDAUC;IAED;;;OAGG;IACH,mDAcC;IAED,gCAAgC;IAChC,gBADY,WAAW,UAWtB;IAED;;;;;OAKG;IACH,eAJW,GAAG,2BAkBb;IAED,oCAAoC;IACpC,iCAkBC;IAED;;;;OAIG;IACH,+CAHW,MAAM,GACJ;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAkCrD;CACD;;eAtLa,MAAM;WACN,MAAM;cACN,MAAM;;;;wBAMA,GAAG,KAAK,QAAQ,MAAM,GAAG,IAAI,CAAC;kCAC9B,MAAM,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;8BAC/B,MAAM,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;uBAC7B,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,MAAM,CAAC,CAAC;mBAClC,MAAM,KAAK,CAAC,GAAG,CAAC;;2BAYxB,OAAO,MAAM,EAAE,OAAO,aAAa,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC"}

package/types/core/configuration.test.d.ts

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

package/types/core/configuration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.test.d.ts","sourceRoot":"","sources":["../../core/configuration.test.js"],"names":[],"mappings":""}

package/types/core/fetch-router.d.ts

@@ -0,0 +1,52 @@
+/** @typedef {import("./types.ts").RouteDefinition<any>} RouteDefinition */
+/** @typedef {(error: unknown, request: Request) => unknown} RouteErrorHandler */
+/**
+ * @typedef {object} MatchedRoute
+ * @property {RouteDefinition} route
+ * @property {URL} url
+ * @property {URLPatternResult} result
+ */
+/**
+ * @typedef {object} FetchRouterOptions
+ * @property {RouteDefinition[]} [routes]
+ * @property {RouteErrorHandler} [errorHandler]
+ */
+/** A rudimentary HTTP router using fetch Request & Responses with RouteDefinitions based on URLPattern */
+export class FetchRouter {
+    /** @param {FetchRouterOptions} [options] */
+    constructor(options?: FetchRouterOptions);
+    /** @type {RouteDefinition} */ routes: import("./types.ts").RouteDefinition<any>;
+    /** @type {RouteErrorHandler | null} */ errorHandler: RouteErrorHandler | null;
+    /**
+     * Finds routes that match the request method and URLPattern
+     * and get's the matched parameters and parsed URL
+     * @param {Request} request
+     * @returns {Iterator<MatchedRoute>}
+     */
+    findMatchingRoutes(request: Request): Iterator<MatchedRoute>;
+    /**
+     * Go through each route match and try to get a Response
+     * @param {Request} request
+     * @param {Iterator<MatchedRoute>} matches
+     */
+    processMatches(request: Request, matches: Iterator<MatchedRoute>): Promise<Response>;
+    /**
+     * @param {Request} request
+     * @param {unknown} error
+     */
+    handleError(request: Request, error: unknown): Response;
+    /** @param {Request} request */
+    getResponse(request: Request): Promise<Response>;
+}
+export type RouteDefinition = import("./types.ts").RouteDefinition<any>;
+export type RouteErrorHandler = (error: unknown, request: Request) => unknown;
+export type MatchedRoute = {
+    route: import("./types.ts").RouteDefinition<any>;
+    url: URL;
+    result: URLPatternResult;
+};
+export type FetchRouterOptions = {
+    routes?: import("./types.ts").RouteDefinition<any>[];
+    errorHandler?: RouteErrorHandler;
+};
+//# sourceMappingURL=fetch-router.d.ts.map

package/types/core/fetch-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-router.d.ts","sourceRoot":"","sources":["../../core/fetch-router.js"],"names":[],"mappings":"AAEA,2EAA2E;AAE3E,iFAAiF;AAEjF;;;;;GAKG;AAEH;;;;GAIG;AAEH,0GAA0G;AAC1G;IAIC,4CAA4C;IAC5C,sBADY,kBAAkB,EAI7B;IAPD,8BAA8B,CAAC,kDAAO;IACtC,uCAAuC,CAAC,cAA7B,iBAAiB,GAAG,IAAI,CAAkB;IAQrD;;;;;OAKG;IACH,4BAHW,OAAO,GACL,SAAS,YAAY,CAAC,CAalC;IAED;;;;OAIG;IACH,wBAHW,OAAO,WACP,SAAS,YAAY,CAAC,qBAehC;IAED;;;OAGG;IACH,qBAHW,OAAO,SACP,OAAO,YAUjB;IAED,+BAA+B;IAC/B,qBADY,OAAO,qBAUlB;CACD;8BA5Fa,OAAO,YAAY,EAAE,eAAe,CAAC,GAAG,CAAC;wCAEjC,OAAO,WAAW,OAAO,KAAK,OAAO;;;SAK7C,GAAG;YACH,gBAAgB;;;aAKhB,2CAAiB;mBACjB,iBAAiB"}

package/types/core/fetch-router.test.d.ts

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

package/types/core/fetch-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-router.test.d.ts","sourceRoot":"","sources":["../../core/fetch-router.test.js"],"names":[],"mappings":""}

package/types/core/http.d.ts

@@ -0,0 +1,55 @@
+/** @typedef {import("./types.ts").HTTPMethod} HTTPMethod */
+/** @typedef {import("./types.ts").RouteResult} RouteResult */
+/**
+ * @template {string} T
+ * @typedef {import("./types.ts").ExtractRouteParams<T>} ExtractRouteParams */
+/**
+ * @template T
+ * @typedef {import("./types.ts").RouteContext<T>} RouteContext
+ */
+/**
+ * @template T
+ * @typedef {import("./types.ts").RouteHandler<T>} RouteHandler
+ */
+/**
+ * @template {string} T
+ * @typedef {import("./types.ts").RouteOptions<T>} RouteOptions
+ */
+/**
+ * @template [T]
+ * @typedef {import("./types.ts").RouteDefinition<T>} RouteDefinition
+ */
+/**
+ * @template {string} T
+ * @param {RouteOptions<T>} init
+ * @returns {RouteDefinition<T>}
+ */
+export function defineRoute<T extends string>(init: import("./types.ts").RouteOptions<T>): import("./types.ts").RouteDefinition<T>;
+export class HTTPError extends Error {
+    /** https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400 */
+    static badRequest(): HTTPError;
+    /** https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401 */
+    static unauthorized(): HTTPError;
+    /** https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404 */
+    static notFound(): HTTPError;
+    /** https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500 */
+    static internalServerError(): HTTPError;
+    /** https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/501 */
+    static notImplemented(): HTTPError;
+    /**
+     * @param {number} status
+     * @param {string} statusText
+     */
+    constructor(status?: number, statusText?: string);
+    /** @type {number} */ status: number;
+    /** @type {string}*/ statusText: string;
+    toResponse(): Response;
+}
+export type HTTPMethod = import("./types.ts").HTTPMethod;
+export type RouteResult = import("./types.ts").RouteResult;
+export type ExtractRouteParams<T extends string> = import("./types.ts").ExtractRouteParams<T>;
+export type RouteContext<T> = import("./types.ts").RouteContext<T>;
+export type RouteHandler<T> = import("./types.ts").RouteHandler<T>;
+export type RouteOptions<T extends string> = import("./types.ts").RouteOptions<T>;
+export type RouteDefinition<T = any> = import("./types.ts").RouteDefinition<T>;
+//# sourceMappingURL=http.d.ts.map

package/types/core/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../core/http.js"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8DAA8D;AAE9D;;8EAE8E;AAE9E;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;;GAIG;AACH,mIAMC;AAID;IACC,mEAAmE;IACnE,+BAEC;IAED,mEAAmE;IACnE,iCAEC;IAED,mEAAmE;IACnE,6BAEC;IAED,mEAAmE;IACnE,wCAEC;IAED,mEAAmE;IACnE,mCAEC;IAKD;;;OAGG;IACH,qBAHW,MAAM,eACN,MAAM,EAQhB;IAbD,qBAAqB,CAAC,QAAX,MAAM,CAAY;IAC7B,oBAAoB,CAAC,YAAV,MAAM,CAAe;IAchC,uBAKC;CACD;yBAzFa,OAAO,YAAY,EAAE,UAAU;0BAC/B,OAAO,YAAY,EAAE,WAAW;mDAIjC,OAAO,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;8BAI1C,OAAO,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;8BAKpC,OAAO,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;6CAKpC,OAAO,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;uCAKpC,OAAO,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC"}

package/types/core/http.test.d.ts

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

package/types/core/http.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.d.ts","sourceRoot":"","sources":["../../core/http.test.js"],"names":[],"mappings":""}

package/types/core/migrator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @template [T=unknown]
+ * @typedef {object} MigrationOptions
+ * @property {(value: T) => void | Promise<void>} up
+ * @property {(value: T) => void | Promise<void>} down
+ */
+/**
+ * @template [T=unknown]
+ * @typedef {object} MigrationDefinition
+ * @property {string} name
+ * @property {(value: T) => void | Promise<void>} up
+ * @property {(value: T) => void | Promise<void>} down
+ */
+/**
+ * @typedef {object} MigrationRecord
+ * @property {string} name
+ */
+/**
+ * @template T @param {MigrationOptions<T>} options
+ * @returns {MigrationOptions<T>}
+ */
+export function defineMigration<T>(options: MigrationOptions<T>): MigrationOptions<T>;
+/**
+ * @template T
+ * @typedef {object} MigratorOptions
+ * @property {() => Promise<MigrationDefinition<T>[]>} getDefinitions
+ * @property {() => Promise<MigrationRecord[]>} getRecords
+ * @property {(def: MigrationDefinition<T>, direction: "up"|"down") => void | Promise<void>} execute
+ */
+/** @template T */
+export class Migrator<T> {
+    /** @param {MigratorOptions<T>} options */
+    constructor(options: MigratorOptions<T>);
+    options: MigratorOptions<T>;
+    up(): Promise<void>;
+    down(): Promise<void>;
+    _getTodo(direction: any, count: any): Promise<MigrationDefinition<T>[]>;
+}
+export type MigrationOptions<T = unknown> = {
+    up: (value: T) => void | Promise<void>;
+    down: (value: T) => void | Promise<void>;
+};
+export type MigrationDefinition<T = unknown> = {
+    name: string;
+    up: (value: T) => void | Promise<void>;
+    down: (value: T) => void | Promise<void>;
+};
+export type MigrationRecord = {
+    name: string;
+};
+export type MigratorOptions<T> = {
+    getDefinitions: () => Promise<MigrationDefinition<T>[]>;
+    getRecords: () => Promise<MigrationRecord[]>;
+    execute: (def: MigrationDefinition<T>, direction: "up" | "down") => void | Promise<void>;
+};
+//# sourceMappingURL=migrator.d.ts.map

package/types/core/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../core/migrator.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AAEH;;;GAGG;AACH,sFAKC;AAED;;;;;;GAMG;AAEH,kBAAkB;AAClB;IACC,0CAA0C;IAC1C,qBADY,gBAAgB,CAAC,CAAC,EAG7B;IADA,4BAAsB;IAGvB,oBAIC;IAED,sBAIC;IAED,wEAQC;CACD;;gBAhEqB,CAAC,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;kBAC1B,CAAC,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;;;UAMlC,MAAM;gBACE,CAAC,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;kBAC1B,CAAC,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;;;UAKlC,MAAM;;;oBAiBN,MAAM,QAAQ,oBAAoB,CAAC,CAAC,EAAE,CAAC;gBACvC,MAAM,QAAQ,eAAe,EAAE,CAAC;mBAC1B,oBAAoB,CAAC,CAAC,aAAa,IAAI,GAAC,MAAM,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC"}

package/types/core/migrator.test.d.ts

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

package/types/core/migrator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.test.d.ts","sourceRoot":"","sources":["../../core/migrator.test.js"],"names":[],"mappings":""}

package/types/core/mod.d.ts

@@ -0,0 +1,7 @@
+export * from "./configuration.js";
+export * from "./fetch-router.js";
+export * from "./http.js";
+export * from "./migrator.js";
+export * from "./postgres.js";
+export * from "./utilities.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/core/mod.d.ts.map

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

package/types/core/postgres.d.ts

@@ -0,0 +1,43 @@
+/** @typedef {import("postgres").Sql} Sql */
+/** @typedef {import("./migrator.js").MigratorOptions} MigratorOptions */
+/** @typedef {import("./migrator.js").MigrationRecord} MigrationRecord */
+/** @typedef {import("./migrator.js").MigrationDefinition} MigrationDefinition */
+/**
+    @param {Sql} sql
+    @returns {Promise<MigrationRecord[]>}
+    */
+export function _getMigrationRecords(sql: Sql): Promise<MigrationRecord[]>;
+/**
+ * @param {MigrationDefinition} def
+ * @param {"up" | "down"} direction
+ * @param {Sql} sql
+ */
+export function _execute(def: MigrationDefinition, direction: "up" | "down", sql: Sql): Promise<void>;
+/**
+ * @param {MigrationDefinition} def
+ * @param {Sql} sql
+ */
+export function _executeUp(def: MigrationDefinition, sql: Sql): Promise<void>;
+/**
+ * @param {MigrationDefinition} def
+ * @param {Sql} sql
+ */
+export function _executeDown(def: MigrationDefinition, sql: Sql): Promise<void>;
+/**
+ * @typedef {object} PostgresMigratorOptions
+ * @property {Sql} sql
+ */
+/**
+ * @param {PostgresMigratorOptions} options
+ * @returns {MigratorOptions<Sql>}
+ */
+export function getPostgresMigratorOptions(options: PostgresMigratorOptions): any;
+export const bootstrapMigration: import("./migrator.js").MigrationOptions<any>;
+export type Sql = import("postgres").Sql;
+export type MigratorOptions = any;
+export type MigrationRecord = import("./migrator.js").MigrationRecord;
+export type MigrationDefinition = import("./migrator.js").MigrationDefinition;
+export type PostgresMigratorOptions = {
+    sql: Sql;
+};
+//# sourceMappingURL=postgres.d.ts.map

package/types/core/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../core/postgres.js"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,yEAAyE;AACzE,yEAAyE;AACzE,iFAAiF;AAEjF;;;MAGG;AACH,0CAHS,GAAG,GACD,QAAQ,eAAe,EAAE,CAAC,CAYpC;AAED;;;;GAIG;AACH,8BAJW,mBAAmB,aACnB,IAAI,GAAG,MAAM,OACb,GAAG,iBAQb;AAED;;;GAGG;AACH,gCAHW,mBAAmB,OACnB,GAAG,iBAQb;AAED;;;GAGG;AACH,kCAHW,mBAAmB,OACnB,GAAG,iBAQb;AAkBD;;;GAGG;AAEH;;;GAGG;AACH,oDAHW,uBAAuB,OASjC;AA/BD,+EAcG;kBAxEW,OAAO,UAAU,EAAE,GAAG;;8BAEtB,OAAO,eAAe,EAAE,eAAe;kCACvC,OAAO,eAAe,EAAE,mBAAmB;;SAyE3C,GAAG"}

package/types/core/test-deps.d.ts

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

package/types/core/test-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-deps.d.ts","sourceRoot":"","sources":["../../core/test-deps.js"],"names":[],"mappings":""}

package/types/core/types.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="urlpattern-polyfill" />
+export type HTTPMethod = "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "CONNECT";
+export type RouteResult = Promise<Response | undefined> | Response | undefined;
+export type ExtractRouteParams<T extends string> = T extends `${string}:${infer Param}/${infer Rest}` ? Param | ExtractRouteParams<Rest> : T extends `${string}:${infer Param}` ? Param : never;
+export interface RouteContext<T> {
+    request: Request;
+    params: T;
+    url: URL;
+}
+export interface RouteHandler<T> {
+    (context: RouteContext<T>): RouteResult;
+}
+export interface RouteOptions<T extends string> {
+    method: HTTPMethod;
+    pathname: T;
+    handler: RouteHandler<Record<ExtractRouteParams<T>, string>>;
+}
+export interface RouteDefinition<T> {
+    method: HTTPMethod;
+    pattern: URLPattern;
+    handler: RouteHandler<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/types/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../core/types.ts"],"names":[],"mappings":";AAEA,MAAM,MAAM,UAAU,GACnB,KAAK,GACL,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,SAAS,CAAC;AAEb,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAC9C,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GAC/C,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAChC,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,EAAE,GACnC,KAAK,GACL,KAAK,CAAC;AAEX,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC;IACV,GAAG,EAAE,GAAG,CAAC;CACT;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;CACxC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACzB"}

package/types/core/utilities.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @template T @param {T} fields
+ * @param {(keyof T)[]} columns
+ * @param {string} fallback
+ */
+export function formatMarkdownTable<T>(fields: T, columns: (keyof T)[], fallback: string): string;
+/**
+ * @template {() => any} T
+ * @param {T} handler
+ * @returns {T}
+ */
+export function loader<T extends () => any>(handler: T): T;
+//# sourceMappingURL=utilities.d.ts.map

package/types/core/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../core/utilities.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,kFAFW,MAAM,UAmChB;AAED;;;;GAIG;AACH,uCAJoB,GAAG,iBAWtB"}

package/types/core/utilities.test.d.ts

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

package/types/core/utilities.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.test.d.ts","sourceRoot":"","sources":["../../core/utilities.test.js"],"names":[],"mappings":""}

package/types/source/configuration.d.ts

@@ -0,0 +1,24 @@
+/**
+    @typedef {object} NodeConfigurationOptions
+    @property {import("superstruct")} superstruct
+*/
+/** @param {NodeConfigurationOptions} options */
+export function getNodeConfigOptions(options: NodeConfigurationOptions): {
+    superstruct: typeof import("superstruct");
+    readTextFile(url: any): Promise<any>;
+    getEnvironmentVariable(key: any): any;
+    getCommandArgument(key: any): any;
+    stringify(config: any): string;
+    parse(data: any): any;
+};
+/**
+ * This is a syntax sugar for `new Configuration(getNodeConfigOptions(options))`
+ * @param {NodeConfigurationOptions} options
+ */
+export function getNodeConfiguration(options: NodeConfigurationOptions): Configuration;
+export { Configuration };
+export type NodeConfigurationOptions = {
+    superstruct: typeof import("superstruct");
+};
+import { Configuration } from "../core/configuration.js";
+//# sourceMappingURL=configuration.d.ts.map

package/types/source/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../source/configuration.js"],"names":[],"mappings":"AAQA;;;EAGE;AAEF,gDAAgD;AAChD,8CADY,wBAAwB;;;;;;;EA4BnC;AAED;;;GAGG;AACH,8CAFW,wBAAwB,iBAIlC;;;;;8BA7C6B,0BAA0B"}

package/types/source/core.d.ts

@@ -0,0 +1,2 @@
+export * from "../core/mod.js";
+//# sourceMappingURL=core.d.ts.map

package/types/source/core.d.ts.map

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

package/types/source/express-router.d.ts

@@ -0,0 +1,28 @@
+/**
+    A HTTP router for Express applications
+
+    ```js
+    const router = new ExpressRouter(...)
+
+    const app = express()
+        .use(...)
+        .use(router.middleware());
+        .use(...)
+    ```
+*/
+export class ExpressRouter {
+    /** @param {NodeRouterOptions} options */
+    constructor(options?: NodeRouterOptions);
+    router: FetchRouter;
+    /** @returns {import("express").RequestHandler} */
+    middleware(): any;
+    /** @param {Request} request */
+    getResponse(request: Request): Promise<Response>;
+    /**
+        @param {import("express").Response} res
+        @param {Response} response
+     */
+    respond(res: any, response: Response): void;
+}
+import { FetchRouter } from "../core/fetch-router.js";
+//# sourceMappingURL=express-router.d.ts.map

package/types/source/express-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-router.d.ts","sourceRoot":"","sources":["../../source/express-router.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;EAWE;AACF;IACC,yCAAyC;IACzC,yCAEC;IADA,oBAAmD;IAGpD,kDAAkD;IAClD,kBAOC;IAED,+BAA+B;IAC/B,qBADY,OAAO,qBAGlB;IAED;;;OAGG;IACH,4BAFS,QAAQ,QAahB;CACD;4BApD2B,yBAAyB"}

package/types/source/koa-router.d.ts

@@ -0,0 +1,33 @@
+/** @typedef {import("koa").Context} Context */
+/** @typedef {import("./node-router.js").NodeRouterOptions} NodeRouterOptions */
+/**
+    A HTTP router for Koa applications
+
+    ```js
+    const router = new KoaRouter(...)
+
+    const app = new Koa()
+        .use(koaHelmet())
+        .use(...)
+        .use(router.middleware());
+        .use(...)
+    ```
+*/
+export class KoaRouter {
+    /** @param {NodeRouterOptions} options */
+    constructor(options?: NodeRouterOptions);
+    router: FetchRouter;
+    /** @returns {import("koa").Middleware} */
+    middleware(): any;
+    /** @param {Request} request */
+    getResponse(request: Request): Promise<Response>;
+    /**
+        @param {Context} ctx
+        @param {Response} response
+    */
+    respond(ctx: any, response: Response): void;
+}
+export type Context = any;
+export type NodeRouterOptions = import("./node-router.js").NodeRouterOptions;
+import { FetchRouter } from "../core/fetch-router.js";
+//# sourceMappingURL=koa-router.d.ts.map

package/types/source/koa-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"koa-router.d.ts","sourceRoot":"","sources":["../../source/koa-router.js"],"names":[],"mappings":"AAKA,+CAA+C;AAC/C,gFAAgF;AAEhF;;;;;;;;;;;;EAYE;AACF;IACC,yCAAyC;IACzC,sBADY,iBAAiB,EAG5B;IADA,oBAAmD;IAGpD,0CAA0C;IAC1C,kBAOC;IAED,+BAA+B;IAC/B,qBADY,OAAO,qBAGlB;IAED;;;MAGE;IACF,4BAFS,QAAQ,QAchB;CACD;;gCArDa,OAAO,kBAAkB,EAAE,iBAAiB;4BAJ9B,yBAAyB"}

package/types/source/mod.d.ts

@@ -0,0 +1,7 @@
+export * from "./configuration.js";
+export * from "./core.js";
+export * from "./express-router.js";
+export * from "./koa-router.js";
+export * from "./node-router.js";
+export * from "./postgres.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/source/mod.d.ts.map

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