@ayepi/deno 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,26 @@
+# @ayepi/deno
+
+[Deno](https://deno.com) adapter for [`@ayepi/core`](https://www.npmjs.com/package/@ayepi/core).
+Deno is fetch-native and upgrades WebSockets with the built-in
+`Deno.upgradeWebSocket`, so this adapter has **zero dependencies** — HTTP goes
+straight to `app.fetch` and the upgraded socket is wired to `app.ws.*`.
+
+```ts
+import { serve } from 'npm:@ayepi/deno'
+import { server } from 'npm:@ayepi/core'
+
+const close = serve(app, { port: 3000, path: '/ws' })
+```
+
+## For AI coding agents
+
+This package ships dense, machine-oriented reference docs written for **AI coding agents**
+(Claude Code, Cursor, and the like) to understand and drive the package — point your agent at them:
+
+- [`ayepi-deno.md`](./ayepi-deno.md)
+
+They live next to the source in the [repo](https://github.com/ClickerMonkey/ayepi/tree/main/packages/deno) and are **not** shipped in the npm tarball.
+
+## License
+
+MIT © Philip Diffenderfer

package/dist/index.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/index.ts
+/** `WebSocket.readyState` value for an open socket (per the WHATWG spec). */
+const WS_OPEN = 1;
+/**
+* Boot an ayepi app on Deno's built-in HTTP + WebSocket server.
+*
+* @returns a `close()` function that shuts the server down and resolves once it
+* has finished.
+*/
+function serve(app, opts) {
+	const deno = globalThis.Deno;
+	if (!deno) throw new Error("@ayepi/deno: not running under Deno (no global `Deno`)");
+	const handler = (req) => {
+		if (req.headers.get("upgrade")?.toLowerCase() === "websocket" && (opts.path === void 0 || new URL(req.url).pathname === opts.path)) {
+			const { socket, response } = deno.upgradeWebSocket(req);
+			let conn = null;
+			socket.onopen = () => {
+				conn = app.ws.open((frame) => {
+					if (socket.readyState === WS_OPEN) socket.send(frame);
+				}, req);
+			};
+			socket.onmessage = (ev) => {
+				if (conn) app.ws.message(conn, String(ev.data));
+			};
+			socket.onclose = () => {
+				if (conn) app.ws.close(conn);
+			};
+			socket.onerror = () => {
+				if (conn) app.ws.close(conn);
+			};
+			return response;
+		}
+		return app.fetch(req);
+	};
+	const server = deno.serve({
+		port: opts.port,
+		hostname: opts.hostname,
+		onListen: (info) => opts.onListen?.(info)
+	}, handler);
+	return async () => {
+		await server.shutdown();
+	};
+}
+//#endregion
+exports.serve = serve;

package/dist/index.d.cts

@@ -0,0 +1,28 @@
+import { AnySpec, Server } from "@ayepi/core";
+
+//#region src/index.d.ts
+
+type AnyApp = Server<AnySpec>;
+/** Options for {@link serve}. */
+interface ServeOptions {
+  /** TCP port to listen on. */
+  readonly port: number;
+  /** Interface to bind. */
+  readonly hostname?: string;
+  /** Restrict WebSocket upgrades to this pathname (e.g. `'/ws'`). */
+  readonly path?: string;
+  /** Called once the server is listening. */
+  readonly onListen?: (info: {
+    port: number;
+    hostname: string;
+  }) => void;
+}
+/**
+ * Boot an ayepi app on Deno's built-in HTTP + WebSocket server.
+ *
+ * @returns a `close()` function that shuts the server down and resolves once it
+ * has finished.
+ */
+declare function serve(app: AnyApp, opts: ServeOptions): () => Promise<void>;
+//#endregion
+export { ServeOptions, serve };

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { AnySpec, Server } from "@ayepi/core";
+
+//#region src/index.d.ts
+
+type AnyApp = Server<AnySpec>;
+/** Options for {@link serve}. */
+interface ServeOptions {
+  /** TCP port to listen on. */
+  readonly port: number;
+  /** Interface to bind. */
+  readonly hostname?: string;
+  /** Restrict WebSocket upgrades to this pathname (e.g. `'/ws'`). */
+  readonly path?: string;
+  /** Called once the server is listening. */
+  readonly onListen?: (info: {
+    port: number;
+    hostname: string;
+  }) => void;
+}
+/**
+ * Boot an ayepi app on Deno's built-in HTTP + WebSocket server.
+ *
+ * @returns a `close()` function that shuts the server down and resolves once it
+ * has finished.
+ */
+declare function serve(app: AnyApp, opts: ServeOptions): () => Promise<void>;
+//#endregion
+export { ServeOptions, serve };

package/dist/index.js

@@ -0,0 +1,45 @@
+//#region src/index.ts
+/** `WebSocket.readyState` value for an open socket (per the WHATWG spec). */
+const WS_OPEN = 1;
+/**
+* Boot an ayepi app on Deno's built-in HTTP + WebSocket server.
+*
+* @returns a `close()` function that shuts the server down and resolves once it
+* has finished.
+*/
+function serve(app, opts) {
+	const deno = globalThis.Deno;
+	if (!deno) throw new Error("@ayepi/deno: not running under Deno (no global `Deno`)");
+	const handler = (req) => {
+		if (req.headers.get("upgrade")?.toLowerCase() === "websocket" && (opts.path === void 0 || new URL(req.url).pathname === opts.path)) {
+			const { socket, response } = deno.upgradeWebSocket(req);
+			let conn = null;
+			socket.onopen = () => {
+				conn = app.ws.open((frame) => {
+					if (socket.readyState === WS_OPEN) socket.send(frame);
+				}, req);
+			};
+			socket.onmessage = (ev) => {
+				if (conn) app.ws.message(conn, String(ev.data));
+			};
+			socket.onclose = () => {
+				if (conn) app.ws.close(conn);
+			};
+			socket.onerror = () => {
+				if (conn) app.ws.close(conn);
+			};
+			return response;
+		}
+		return app.fetch(req);
+	};
+	const server = deno.serve({
+		port: opts.port,
+		hostname: opts.hostname,
+		onListen: (info) => opts.onListen?.(info)
+	}, handler);
+	return async () => {
+		await server.shutdown();
+	};
+}
+//#endregion
+export { serve };

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@ayepi/deno",
+  "version": "0.1.0",
+  "description": "Deno adapter for @ayepi/core — fetch-native HTTP + native WebSocket, zero dependencies",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ClickerMonkey/ayepi.git",
+    "directory": "packages/deno"
+  },
+  "homepage": "https://github.com/ClickerMonkey/ayepi/tree/main/packages/deno#readme",
+  "bugs": {
+    "url": "https://github.com/ClickerMonkey/ayepi/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "deno": ">=1.40.0"
+  },
+  "peerDependencies": {
+    "@ayepi/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.8",
+    "publint": "^0.3.0",
+    "tsdown": "^0.12.0",
+    "vitest": "^2.1.8",
+    "zod": "^4.4.3",
+    "@ayepi/core": "0.1.0"
+  },
+  "keywords": [
+    "ayepi",
+    "@ayepi/core",
+    "deno",
+    "websocket",
+    "adapter",
+    "server",
+    "fetch"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --coverage",
+    "publint": "publint"
+  }
+}