@angadie/chittie-transport-node 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Asyncdot Engineering
+
+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.
+
+Portions of this software are vendored from MIT-licensed projects and retain
+their original copyright notices; see VENDOR.md.
+
+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,44 @@
+# @angadie/chittie-transport-node
+
+Network (LAN/Wi-Fi) transport for chittie on **Node / Electron / print-servers**: opens a raw TCP socket to a network printer and streams ESC/POS bytes. **Zero dependencies** (uses `node:net`).
+
+Network printers (Epson TM, Star TSP, most kitchen/counter units) listen on **TCP port 9100** (RAW / JetDirect) — the de-facto standard. This is the same approach as `node-thermal-printer`'s Network interface and the native NetPrinter adapters inside RN printer libraries.
+
+## Install
+
+```bash
+pnpm add @angadie/chittie-transport-node @angadie/chittie-transport
+```
+
+## Usage
+
+```ts
+import { render, Printer, Text, Cut } from '@angadie/chittie';
+import { print } from '@angadie/chittie-transport';
+import { createNetworkTransport } from '@angadie/chittie-transport-node';
+
+const bytes = render(<Printer width={48}><Text bold>KITCHEN</Text><Cut /></Printer>);
+
+const transport = createNetworkTransport({ host: '192.168.1.50', port: 9100 });
+await print(transport, bytes); // connect → write; call transport.disconnect() when done
+```
+
+`createNetworkTransport({ host, port = 9100, timeoutMs = 5000 })`.
+
+## Network printing on other platforms
+
+- **React Native (Wi-Fi printers):** Node's `net` isn't available — use [`react-native-tcp-socket`](https://github.com/Rapsssito/react-native-tcp-socket) (its `write` accepts a `Uint8Array` directly) with `createTransport` from [`@angadie/chittie-transport-react-native`](../chittie-transport-react-native):
+
+  ```ts
+  import TcpSocket from 'react-native-tcp-socket';
+  import { createTransport } from '@angadie/chittie-transport-react-native';
+
+  const socket = TcpSocket.createConnection({ host: '192.168.1.50', port: 9100 }, () => {});
+  const transport = createTransport({ write: (b) => { socket.write(Buffer.from(b)); return Promise.resolve(); } });
+  ```
+
+- **Browser:** ⚠️ browsers **cannot open raw TCP sockets**, so a web page can't reach `host:9100` directly. Either route through a **backend proxy** (server holds the socket — use this package there), or use the printer's **HTTP API**: Epson **ePOS-Print** (XML over HTTP) or Star **WebPRNT**.
+
+## License
+
+MIT.

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { Transport } from "@angadie/chittie-transport";
+
+//#region src/index.d.ts
+interface NetworkOptions {
+  host: string;
+  /** RAW/JetDirect port — 9100 is the de-facto standard for ESC/POS network printers. */
+  port?: number;
+  /** Connection timeout in ms (default 5000). */
+  timeoutMs?: number;
+}
+/**
+ * Network (LAN/Wi-Fi) transport for Node / Electron / print-servers: opens a raw
+ * TCP socket to a network printer (host:9100) and streams ESC/POS bytes — the
+ * same approach as node-thermal-printer's Network interface and the native
+ * NetPrinter adapters in RN printer libs. Zero dependencies (uses node:net).
+ */
+declare function createNetworkTransport(options: NetworkOptions): Transport;
+//#endregion
+export { NetworkOptions, createNetworkTransport };

package/dist/index.mjs

@@ -0,0 +1,57 @@
+import { createConnection } from "node:net";
+//#region src/index.ts
+/**
+* Network (LAN/Wi-Fi) transport for Node / Electron / print-servers: opens a raw
+* TCP socket to a network printer (host:9100) and streams ESC/POS bytes — the
+* same approach as node-thermal-printer's Network interface and the native
+* NetPrinter adapters in RN printer libs. Zero dependencies (uses node:net).
+*/
+function createNetworkTransport(options) {
+	const port = options.port ?? 9100;
+	const timeoutMs = options.timeoutMs ?? 5e3;
+	let socket = null;
+	return {
+		connect() {
+			return new Promise((resolve, reject) => {
+				const s = createConnection({
+					host: options.host,
+					port
+				});
+				s.setTimeout(timeoutMs);
+				s.once("connect", () => {
+					s.setTimeout(0);
+					socket = s;
+					resolve();
+				});
+				s.once("timeout", () => {
+					s.destroy();
+					reject(/* @__PURE__ */ new Error(`chittie: connection to ${options.host}:${port} timed out after ${timeoutMs}ms`));
+				});
+				s.once("error", reject);
+			});
+		},
+		write(data) {
+			return new Promise((resolve, reject) => {
+				if (!socket) {
+					reject(/* @__PURE__ */ new Error("chittie: not connected — call connect() first"));
+					return;
+				}
+				socket.write(Buffer.from(data), (err) => err ? reject(err) : resolve());
+			});
+		},
+		disconnect() {
+			return new Promise((resolve) => {
+				if (!socket) {
+					resolve();
+					return;
+				}
+				socket.end(() => {
+					socket = null;
+					resolve();
+				});
+			});
+		}
+	};
+}
+//#endregion
+export { createNetworkTransport };

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@angadie/chittie-transport-node",
+  "version": "0.1.0",
+  "description": "Node/Electron network (LAN) transport for chittie — raw TCP to an ESC/POS printer on port 9100. Zero deps (node:net).",
+  "license": "MIT",
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@angadie/chittie-transport": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx spikes/network.spike.ts"
+  }
+}