@dangayle/rustlike 0.1.0

package/dist/node.d.mts

@@ -0,0 +1,46 @@
+import { g as Result, s as Iter, t as AsyncIter } from "./async-iter-1OXm1ncF.mjs";
+
+//#region src/node.d.ts
+/**
+ * Create an Iter that lazily reads lines from a file.
+ * Uses Node.js fs.readFileSync but yields lines lazily via generator.
+ *
+ * Note: This reads the entire file into memory but yields lines lazily.
+ * For truly streaming line-by-line reading, use asyncIterLines.
+ *
+ * @param filepath - Path to the file to read
+ * @returns Result with Iter<string> on success, error message on failure
+ *
+ * @example
+ * const lines = iterLinesSync('data.txt');
+ * lines.match({
+ *   ok: (iter) => iter.skip(1).map(parseLine).collect(),
+ *   err: (e) => console.error(e)
+ * });
+ */
+declare function iterLinesSync(filepath: string): Result<Iter<string>, string>;
+/**
+ * Create an AsyncIter that reads lines from a file using streaming.
+ * Truly memory-efficient - reads lines on-demand without loading entire file.
+ *
+ * Uses Node.js readline with createReadStream for efficient streaming.
+ *
+ * @param filepath - Path to the file to read
+ * @returns Promise of Result with AsyncIter<string> on success, error message on failure
+ *
+ * @example
+ * const result = await asyncIterLines('large-log.txt');
+ * result.match({
+ *   ok: async (iter) => {
+ *     const errors = await iter
+ *       .filter(line => line.includes('ERROR'))
+ *       .take(100)
+ *       .collect();
+ *   },
+ *   err: (e) => console.error(e)
+ * });
+ */
+declare function asyncIterLines(filepath: string): Promise<Result<AsyncIter<string>, string>>;
+//#endregion
+export { asyncIterLines, iterLinesSync };
+//# sourceMappingURL=node.d.mts.map

package/dist/node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.mts","names":[],"sources":["../src/node.ts"],"mappings":";;;AAiFA;;;;;;;;;;;;;;;;;AAAA,iBA1CgB,aAAA,CAAc,QAAA,WAAmB,MAAA,CAAO,IAAA;;;;;;;;;;;;;;;;;;;;;;iBA0ClC,cAAA,CAAe,QAAA,WAAmB,OAAA,CAAQ,MAAA,CAAO,SAAA"}

package/dist/node.mjs

@@ -0,0 +1,87 @@
+import { f as Ok, n as asyncIter, s as iter, u as Err } from "./async-iter-aLdg-qp2.mjs";
+import * as fs from "fs";
+import * as readline from "readline";
+
+//#region src/node.ts
+/**
+* Node.js-specific utilities for rustlike.
+*
+* This module contains functions that depend on Node.js built-in modules
+* (fs, readline) and should only be imported in Node.js environments.
+* Browser and edge runtime consumers should use the main 'rustlike' entry point.
+*
+* Import from 'rustlike/node' to access these functions.
+*/
+/**
+* Create an Iter that lazily reads lines from a file.
+* Uses Node.js fs.readFileSync but yields lines lazily via generator.
+*
+* Note: This reads the entire file into memory but yields lines lazily.
+* For truly streaming line-by-line reading, use asyncIterLines.
+*
+* @param filepath - Path to the file to read
+* @returns Result with Iter<string> on success, error message on failure
+*
+* @example
+* const lines = iterLinesSync('data.txt');
+* lines.match({
+*   ok: (iter) => iter.skip(1).map(parseLine).collect(),
+*   err: (e) => console.error(e)
+* });
+*/
+function iterLinesSync(filepath) {
+	try {
+		const lines = fs.readFileSync(filepath, "utf-8").split("\n");
+		if (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+		return Ok(iter(lines));
+	} catch (error) {
+		if (error instanceof Error) return Err(`Failed to read file '${filepath}': ${error.message}`);
+		return Err(`Failed to read file '${filepath}': ${String(error)}`);
+	}
+}
+/**
+* Create an AsyncIter that reads lines from a file using streaming.
+* Truly memory-efficient - reads lines on-demand without loading entire file.
+*
+* Uses Node.js readline with createReadStream for efficient streaming.
+*
+* @param filepath - Path to the file to read
+* @returns Promise of Result with AsyncIter<string> on success, error message on failure
+*
+* @example
+* const result = await asyncIterLines('large-log.txt');
+* result.match({
+*   ok: async (iter) => {
+*     const errors = await iter
+*       .filter(line => line.includes('ERROR'))
+*       .take(100)
+*       .collect();
+*   },
+*   err: (e) => console.error(e)
+* });
+*/
+async function asyncIterLines(filepath) {
+	try {
+		await fs.promises.access(filepath, fs.constants.R_OK);
+	} catch (error) {
+		if (error instanceof Error) return Err(`Failed to access file '${filepath}': ${error.message}`);
+		return Err(`Failed to access file '${filepath}': ${String(error)}`);
+	}
+	return Ok(asyncIter((async function* () {
+		const fileStream = fs.createReadStream(filepath, { encoding: "utf-8" });
+		const rl = readline.createInterface({
+			input: fileStream,
+			crlfDelay: Infinity
+		});
+		try {
+			for await (const line of rl) yield line;
+		} finally {
+			rl.close();
+			fileStream.destroy();
+		}
+	})()));
+}
+
+//#endregion
+export { asyncIterLines, iterLinesSync };
+//# sourceMappingURL=node.mjs.map

package/dist/node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.mjs","names":[],"sources":["../src/node.ts"],"sourcesContent":["/**\n * Node.js-specific utilities for rustlike.\n *\n * This module contains functions that depend on Node.js built-in modules\n * (fs, readline) and should only be imported in Node.js environments.\n * Browser and edge runtime consumers should use the main 'rustlike' entry point.\n *\n * Import from 'rustlike/node' to access these functions.\n */\n\nimport * as fs from \"fs\";\nimport * as readline from \"readline\";\nimport { Result, Ok, Err } from \"./core\";\nimport { iter } from \"./iter\";\nimport { asyncIter } from \"./async-iter\";\nimport type { Iter } from \"./iter\";\nimport type { AsyncIter } from \"./async-iter\";\n\n// ============================================================================\n// File Reading (Sync)\n// ============================================================================\n\n/**\n * Create an Iter that lazily reads lines from a file.\n * Uses Node.js fs.readFileSync but yields lines lazily via generator.\n *\n * Note: This reads the entire file into memory but yields lines lazily.\n * For truly streaming line-by-line reading, use asyncIterLines.\n *\n * @param filepath - Path to the file to read\n * @returns Result with Iter<string> on success, error message on failure\n *\n * @example\n * const lines = iterLinesSync('data.txt');\n * lines.match({\n *   ok: (iter) => iter.skip(1).map(parseLine).collect(),\n *   err: (e) => console.error(e)\n * });\n */\nexport function iterLinesSync(filepath: string): Result<Iter<string>, string> {\n  try {\n    const content = fs.readFileSync(filepath, \"utf-8\");\n    const lines = content.split(\"\\n\");\n    // Remove trailing empty line if file ends with newline\n    if (lines.length > 0 && lines[lines.length - 1] === \"\") {\n      lines.pop();\n    }\n    return Ok(iter(lines));\n  } catch (error) {\n    if (error instanceof Error) {\n      return Err(`Failed to read file '${filepath}': ${error.message}`);\n    }\n    return Err(`Failed to read file '${filepath}': ${String(error)}`);\n  }\n}\n\n// ============================================================================\n// File Reading (Async)\n// ============================================================================\n\n/**\n * Create an AsyncIter that reads lines from a file using streaming.\n * Truly memory-efficient - reads lines on-demand without loading entire file.\n *\n * Uses Node.js readline with createReadStream for efficient streaming.\n *\n * @param filepath - Path to the file to read\n * @returns Promise of Result with AsyncIter<string> on success, error message on failure\n *\n * @example\n * const result = await asyncIterLines('large-log.txt');\n * result.match({\n *   ok: async (iter) => {\n *     const errors = await iter\n *       .filter(line => line.includes('ERROR'))\n *       .take(100)\n *       .collect();\n *   },\n *   err: (e) => console.error(e)\n * });\n */\nexport async function asyncIterLines(filepath: string): Promise<Result<AsyncIter<string>, string>> {\n  // Check if file exists first\n  try {\n    await fs.promises.access(filepath, fs.constants.R_OK);\n  } catch (error) {\n    if (error instanceof Error) {\n      return Err(`Failed to access file '${filepath}': ${error.message}`);\n    }\n    return Err(`Failed to access file '${filepath}': ${String(error)}`);\n  }\n\n  // Create the async iterator using readline\n  const asyncIterator = (async function* () {\n    const fileStream = fs.createReadStream(filepath, { encoding: \"utf-8\" });\n    const rl = readline.createInterface({\n      input: fileStream,\n      crlfDelay: Infinity, // Handle both \\n and \\r\\n\n    });\n\n    try {\n      for await (const line of rl) {\n        yield line;\n      }\n    } finally {\n      rl.close();\n      fileStream.destroy();\n    }\n  })();\n\n  return Ok(asyncIter(asyncIterator));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,cAAc,UAAgD;AAC5E,KAAI;EAEF,MAAM,QADU,GAAG,aAAa,UAAU,QAAQ,CAC5B,MAAM,KAAK;AAEjC,MAAI,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,OAAO,GAClD,OAAM,KAAK;AAEb,SAAO,GAAG,KAAK,MAAM,CAAC;UACf,OAAO;AACd,MAAI,iBAAiB,MACnB,QAAO,IAAI,wBAAwB,SAAS,KAAK,MAAM,UAAU;AAEnE,SAAO,IAAI,wBAAwB,SAAS,KAAK,OAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;AA6BrE,eAAsB,eAAe,UAA8D;AAEjG,KAAI;AACF,QAAM,GAAG,SAAS,OAAO,UAAU,GAAG,UAAU,KAAK;UAC9C,OAAO;AACd,MAAI,iBAAiB,MACnB,QAAO,IAAI,0BAA0B,SAAS,KAAK,MAAM,UAAU;AAErE,SAAO,IAAI,0BAA0B,SAAS,KAAK,OAAO,MAAM,GAAG;;AAqBrE,QAAO,GAAG,WAjBa,mBAAmB;EACxC,MAAM,aAAa,GAAG,iBAAiB,UAAU,EAAE,UAAU,SAAS,CAAC;EACvE,MAAM,KAAK,SAAS,gBAAgB;GAClC,OAAO;GACP,WAAW;GACZ,CAAC;AAEF,MAAI;AACF,cAAW,MAAM,QAAQ,GACvB,OAAM;YAEA;AACR,MAAG,OAAO;AACV,cAAW,SAAS;;KAEpB,CAE8B,CAAC"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@dangayle/rustlike",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dangayle/rustlike.git"
+  },
+  "homepage": "https://github.com/dangayle/rustlike#readme",
+  "bugs": {
+    "url": "https://github.com/dangayle/rustlike/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "TypeScript utilities for writing Rust-like code: Result, Option, exhaustive matching, and immutability helpers",
+  "keywords": [
+    "functional",
+    "immutable",
+    "option",
+    "pattern-matching",
+    "result",
+    "rust",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Dan Gayle <dangayle@gmail.com>",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./node": {
+      "import": {
+        "types": "./dist/node.d.mts",
+        "default": "./dist/node.mjs"
+      },
+      "require": {
+        "types": "./dist/node.d.cts",
+        "default": "./dist/node.cjs"
+      }
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "oxfmt": "^0.36.0",
+    "oxlint": "^1.51.0",
+    "oxlint-tsgolint": "^0.16.0",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsdown && pnpm -C packages/eslint-plugin-rustlike build",
+    "build:lib": "tsdown",
+    "build:plugin": "pnpm -C packages/eslint-plugin-rustlike build",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "test:run": "vitest run && pnpm -C packages/eslint-plugin-rustlike test",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint src/ examples/",
+    "lint:fix": "oxlint --fix src/ examples/",
+    "typecheck": "tsc --noEmit",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check"
+  }
+}