@orkestrel/router 0.0.1

package/dist/src/server/types.d.ts

@@ -0,0 +1,31 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * Options for `buildRequest` — how to derive the built `Request`'s origin.
+ *
+ * @remarks
+ * - `origin` — an explicit scheme + host to build the request URL against
+ *   (`https://api.example.com`). Omitted ⇒ derived from the connection: the
+ *   socket's `encrypted` presence picks `https`/`http`, and the `Host`
+ *   header supplies the host (absent `Host` ⇒ `localhost`).
+ */
+export interface RequestOptions {
+    readonly origin?: string;
+}
+/**
+ * A `node:http` request handler — the function `createListener` returns,
+ * matching `http.createServer`'s handler signature.
+ *
+ * @remarks
+ * Invoked once per incoming message with the raw `IncomingMessage`/
+ * `ServerResponse` pair; never returns a value (writes the response as a
+ * side effect).
+ */
+export type ListenerFunction = (request: IncomingMessage, response: ServerResponse) => void;
+/**
+ * Derives a consumer's opaque per-request `TState` from the raw
+ * `IncomingMessage` — the `state` argument `createListener` threads into
+ * `dispatcher.handle`.
+ *
+ * @typeParam TState - The consumer's opaque per-request state type
+ */
+export type StateFunction<TState> = (message: IncomingMessage) => TState;

package/package.json

@@ -0,0 +1,93 @@
+{
+	"name": "@orkestrel/router",
+	"version": "0.0.1",
+	"description": "A typed request router for the @orkestrel line — server and browser environments. Part of the @orkestrel line.",
+	"keywords": [
+		"browser",
+		"router",
+		"routing",
+		"server",
+		"typescript",
+		"url"
+	],
+	"homepage": "https://github.com/orkestrel/router#readme",
+	"bugs": "https://github.com/orkestrel/router/issues",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/orkestrel/router.git"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"type": "module",
+	"sideEffects": false,
+	"main": "./dist/src/core/index.js",
+	"types": "./dist/src/core/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/src/core/index.d.ts",
+			"import": "./dist/src/core/index.js",
+			"default": "./dist/src/core/index.js"
+		},
+		"./browser": {
+			"types": "./dist/src/browser/index.d.ts",
+			"import": "./dist/src/browser/index.js",
+			"default": "./dist/src/browser/index.js"
+		},
+		"./server": {
+			"types": "./dist/src/server/index.d.ts",
+			"require": "./dist/src/server/index.cjs",
+			"default": "./dist/src/server/index.cjs"
+		},
+		"./package.json": "./package.json"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"clean": "node -e \"try{require('node:fs').rmSync('dist',{recursive:true,force:true})}catch{}\"",
+		"copy": "node -e \"const fs=require('node:fs'),p=require('node:path'),a=process.argv[1],b=process.argv[2];fs.mkdirSync(p.dirname(b),{recursive:true});fs.cpSync(a,b,{force:true});console.log('Copied: '+a+' to '+b)\"",
+		"tmp:txt": "node -e \"const fs=require('node:fs'),p=require('node:path');function walk(d){for(const e of fs.readdirSync(d,{withFileTypes:true})){const f=p.join(d,e.name);if(e.isDirectory()){walk(f)}else if(!e.name.endsWith('.md')&&!e.name.endsWith('.txt')){const t=f+'.txt';if(!fs.existsSync(t)){fs.renameSync(f,t)}else{console.warn('Skipping '+f+' — target exists: '+t)}}}}try{walk('tmp')}catch(e){if(e.code!=='ENOENT')throw e}\"",
+		"lint": "oxlint --config .oxlintrc.json --fix .",
+		"check": "tsc --noEmit --project tsconfig.json",
+		"check:src": "npm run check:src:core && npm run check:src:browser && npm run check:src:server",
+		"check:src:core": "tsc --noEmit -p configs/src/tsconfig.core.json",
+		"check:src:browser": "tsc --noEmit -p configs/src/tsconfig.browser.json",
+		"check:src:server": "tsc --noEmit -p configs/src/tsconfig.server.json",
+		"format": "oxfmt --config .oxfmtrc.json --write .",
+		"format:check": "oxfmt --config .oxfmtrc.json --check .",
+		"lint:check": "oxlint --config .oxlintrc.json .",
+		"test": "npm run test:src && npm run test:guides",
+		"test:src": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:core --project src:browser --project src:server",
+		"test:src:core": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:core",
+		"test:src:browser": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:browser",
+		"test:src:server": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:server",
+		"test:guides": "vitest run --config vite.config.ts --reporter=dot --project guides",
+		"build": "npm run clean && npm run build:src",
+		"build:src": "npm run build:src:core && npm run build:src:browser && npm run build:src:server",
+		"build:src:core": "vite build --config configs/src/vite.core.config.ts && tsc -p configs/src/tsconfig.core.json",
+		"build:src:browser": "vite build --config configs/src/vite.browser.config.ts && tsc -p configs/src/tsconfig.browser.json",
+		"build:src:server": "vite build --config configs/src/vite.server.config.ts && tsc -p configs/src/tsconfig.server.json",
+		"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run check && npm run build && npm test"
+	},
+	"dependencies": {
+		"@orkestrel/abort": "^0.0.1",
+		"@orkestrel/contract": "^0.0.1",
+		"@orkestrel/emitter": "^0.0.1"
+	},
+	"devDependencies": {
+		"@orkestrel/guide": "^0.0.1",
+		"@types/node": "^26.1.1",
+		"@vitest/browser-playwright": "^4.1.10",
+		"oxfmt": "^0.58.0",
+		"oxlint": "^1.73.0",
+		"typescript": "^6.0.3",
+		"vite": "^8.1.4",
+		"vitest": "^4.1.10"
+	},
+	"engines": {
+		"node": ">=24"
+	}
+}