acrylblends 1.0.10 → 1.2.0

package/lib/src-LX0E4ec4.js

@@ -1,117 +0,0 @@
-import { c as Request, i as createAdaptorServer, r as UpgradeHub } from "./test-websocket-BLeEvybj.js";
-import "./serve-static-C1Nkj_xB.js";
-import { Service } from "@deepseek-ai/cordis";
-import z from "@deepseek-ai/schemastery";
-//#region ../../plugins/acryl-node-server/src/index.ts
-/** Stable Cordis plugin name, equal to the package name and the Loader row id. */
-const name = "acryl-node-server";
-const inject = ["router"];
-/** Every field has a default, so a caller passes only what it changes: `ctx.plugin(plugin, { ... })` takes the partial shape. */
-const Config = z.object({
-	hostname: z.string().default("127.0.0.1").description("Address to bind. Loopback by default; binding elsewhere exposes the app to the network."),
-	port: z.number().min(0).max(65535).default(0).description("Port to listen on; 0 lets the system choose. A taken port is followed by the next free one."),
-	scan: z.number().min(0).default(20).description("How many further ports to try when the configured one is taken."),
-	websocket: z.object({
-		maxPayload: z.number().min(1).default(1024 * 1024).description("The largest WebSocket frame accepted, in bytes; a bigger one closes the socket with 1009."),
-		heartbeat: z.number().min(0).default(3e4).description("Milliseconds between pings; a peer that did not answer the last one is terminated. 0 turns it off."),
-		grace: z.number().min(0).default(2e3).description("Milliseconds a closing socket gets before it is terminated when its plugin unloads.")
-	}).default({})
-});
-var NodeServer = class extends Service {
-	hostname;
-	config;
-	server;
-	hub;
-	bound = 0;
-	constructor(ctx, config) {
-		super(ctx, "nodeServer");
-		this.config = config;
-		this.hostname = config.hostname;
-		const router = ctx.router;
-		this.server = createAdaptorServer({
-			fetch: (request, { incoming }) => router.fetch(new Request(request), {
-				remoteAddress: incoming.socket.remoteAddress,
-				localPort: incoming.socket.localPort
-			}),
-			hostname: config.hostname,
-			overrideGlobalObjects: false
-		});
-		ctx.effect(() => async () => {
-			await this.hub?.close();
-			this.server.closeAllConnections();
-			if (this.server.listening) await new Promise((resolve) => {
-				this.server.close(() => {
-					resolve();
-				});
-			});
-		}, "acryl-node-server: close listener and open connections");
-	}
-	/**
-	* `upgradeWebSocket` for the plugin that asks (call it once, in `apply`): `app.get('/ws', upgrade((c) => ({ onMessage(event, ws) { ... } })))`. Checks go in ordinary middleware on the
-	* route, and a handler that returns a `Response` refuses the upgrade with that status before any handshake. Every socket it accepts belongs to the calling plugin: when the plugin
-	* unloads they are closed with 1001 within `websocket.grace` and the handler sees `close` once. Pass `{ textOnly: true }` to drop binary frames. Needs the `ws` package.
-	*/
-	upgrades() {
-		if (!this.hub) {
-			this.hub = new UpgradeHub(this.config.websocket);
-			this.hub.attach(this.server, this.ctx.router);
-		}
-		return this.hub.upgradeWebSocketFor(this.ctx);
-	}
-	/** How many WebSocket connections are open now. */
-	get sockets() {
-		return this.hub?.size ?? 0;
-	}
-	/** The port in use, 0 before the server listens. */
-	get port() {
-		return this.bound;
-	}
-	/** The address clients use. */
-	get url() {
-		return `http://${this.hostname.includes(":") ? `[${this.hostname}]` : this.hostname}:${String(this.bound)}`;
-	}
-	/** Bind, scanning past taken ports. */
-	async listen() {
-		const { port, scan, hostname } = this.config;
-		const last = port === 0 ? 0 : Math.min(65535, port + scan);
-		for (let candidate = port; candidate <= last; candidate += 1) try {
-			await new Promise((resolve, reject) => {
-				const onError = (error) => {
-					reject(error);
-				};
-				this.server.once("error", onError);
-				this.server.listen(candidate, hostname, () => {
-					this.server.off("error", onError);
-					resolve();
-				});
-			});
-			this.bound = this.server.address().port;
-			return;
-		} catch (error) {
-			if (!isPortUnavailable(error)) throw error;
-		}
-		throw new Error(`acryl-node-server: no free port from ${String(port)} to ${String(last)} on ${hostname}`);
-	}
-};
-/**
-* Whether a failed bind means "this port, try the next one". A port another socket holds answers `EADDRINUSE` everywhere. On Windows a port
-* inside a range the system reserves (Hyper-V, WSL and Docker exclude ranges, `netsh interface ipv4 show excludedportrange`) answers
-* `EACCES`, which is a property of that port too; elsewhere `EACCES` means the process may not bind low ports at all, so moving on would
-* only hide the reason.
-*/
-function isPortUnavailable(error, platform = process.platform) {
-	const code = error?.code;
-	return code === "EADDRINUSE" || platform === "win32" && code === "EACCES";
-}
-/** Loads once the server listens, so a plugin that injects `nodeServer` can rely on `url`. A failure to bind fails the plugin. */
-async function apply(ctx, config = {}) {
-	await new NodeServer(ctx, {
-		hostname: "127.0.0.1",
-		port: 0,
-		scan: 20,
-		websocket: {},
-		...config
-	}).listen();
-}
-//#endregion
-export { isPortUnavailable as a, inject as i, NodeServer as n, name as o, apply as r, Config as t };

package/shared/SKILL.md

@@ -1,14 +0,0 @@
----
-name: app-guide
-description: How to change, run and check the __APP_NAME__ app. Use it before adding a feature, a route, a plugin or a dependency to this app, and before saying the work is done.
----
-
-# Working in __APP_NAME__
-
-1. **Read first.** `AGENTS.md` in this folder says how the app is laid out. The framework's API is in `docs/framework/`: start at `docs/framework/README.md`, and
-   `docs/framework/api/summary.md` is the one-page summary. Parts the docs mark "not yet available" are not in this app.
-2. **Make the change small.** Your own routes are a plugin (`src/routes.ts`) that builds an `Acryl` app and mounts it; test a route with `await app.request('/path')`.
-3. **One plugin folder.** A plugin lives in `plugins/<name>/` (`npx acrylblends add <name>` copies a library plugin there). There is no `src/plugins/` and no `extensions/`.
-4. **Defaults are swappable.** The database, the key-value store, the server and the window are plugins behind ports. The table "Defaults you can swap" in `AGENTS.md` names each default and where it is swapped. Never reach around a port to a driver: `npx acrylblends check-deps` fails the check.
-5. **Look at the running app.** Start it (`npm run dev`, in the background), open its address in a browser, then run `.acryl/bin/acryl brief`, `look` and `act`: the door shows the page as text with refs and clicks or types on it. Read the section "The door" of `AGENTS.md` for the verbs. Without the door, check the page by hand.
-6. **Done means checked.** `npm test` passes, and the change shows in the running app after a restart. No secret goes in a file or in `git status`: keys come from environment variables.