shfs 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# shfs
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.5. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/fs-DSmBon4m.d.mts

@@ -0,0 +1,21 @@
+//#region src/stream.d.ts
+type Stream<T> = AsyncIterable<T>;
+//#endregion
+//#region src/fs/fs.d.ts
+interface FS {
+  readFile(path: string): Promise<Uint8Array>;
+  readLines(path: string): Stream<string>;
+  writeFile(path: string, content: Uint8Array): Promise<void>;
+  deleteFile(path: string): Promise<void>;
+  readdir(path: string): Stream<string>;
+  mkdir(path: string, recursive?: boolean): Promise<void>;
+  stat(path: string): Promise<{
+    isDirectory: boolean;
+    size: number;
+    mtime: Date;
+  }>;
+  exists(path: string): Promise<boolean>;
+}
+//#endregion
+export { Stream as n, FS as t };
+//# sourceMappingURL=fs-DSmBon4m.d.mts.map

package/dist/fs.d.mts

@@ -0,0 +1,25 @@
+import { n as Stream, t as FS } from "./fs-DSmBon4m.mjs";
+
+//#region src/fs/memory.d.ts
+declare class MemoryFS implements FS {
+  private readonly files;
+  private readonly directories;
+  private readonly fileMetadata;
+  constructor();
+  setFile(path: string, content: string | Uint8Array): void;
+  readFile(path: string): Promise<Uint8Array>;
+  readLines(path: string): Stream<string>;
+  writeFile(path: string, content: Uint8Array): Promise<void>;
+  deleteFile(path: string): Promise<void>;
+  readdir(glob: string): Stream<string>;
+  mkdir(path: string, recursive?: boolean): Promise<void>;
+  stat(path: string): Promise<{
+    isDirectory: boolean;
+    size: number;
+    mtime: Date;
+  }>;
+  exists(path: string): Promise<boolean>;
+}
+//#endregion
+export { type FS, MemoryFS };
+//# sourceMappingURL=fs.d.mts.map

package/dist/fs.mjs

@@ -0,0 +1,95 @@
+//#region src/fs/memory.ts
+const TRAILING_SLASH_REGEX = /\/$/;
+var MemoryFS = class {
+	files = /* @__PURE__ */ new Map();
+	directories = /* @__PURE__ */ new Set();
+	fileMetadata = /* @__PURE__ */ new Map();
+	constructor() {
+		this.directories.add("/");
+		this.fileMetadata.set("/", {
+			mtime: /* @__PURE__ */ new Date(),
+			isDirectory: true
+		});
+	}
+	setFile(path, content) {
+		const encoded = typeof content === "string" ? new TextEncoder().encode(content) : content;
+		this.files.set(path, encoded);
+		this.fileMetadata.set(path, {
+			mtime: /* @__PURE__ */ new Date(),
+			isDirectory: false
+		});
+	}
+	async readFile(path) {
+		const content = this.files.get(path);
+		if (!content) throw new Error(`File not found: ${path}`);
+		return content;
+	}
+	async *readLines(path) {
+		const content = this.files.get(path);
+		if (!content) throw new Error(`File not found: ${path}`);
+		yield* new TextDecoder().decode(content).split("\n").filter((_, i, arr) => !(i === arr.length - 1 && arr[i] === ""));
+	}
+	async writeFile(path, content) {
+		this.files.set(path, content);
+	}
+	async deleteFile(path) {
+		if (!this.files.has(path)) throw new Error(`File not found: ${path}`);
+		this.files.delete(path);
+	}
+	async *readdir(glob) {
+		const pattern = glob.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/\./g, "\\.");
+		const regex = /* @__PURE__ */ new RegExp(`^${pattern}$`);
+		const paths = Array.from(this.files.keys()).filter((path) => regex.test(path)).sort();
+		for (const path of paths) yield path;
+	}
+	async mkdir(path, recursive = false) {
+		if (this.directories.has(path) || this.files.has(path)) throw new Error(`Directory already exists: ${path}`);
+		if (recursive) {
+			const parts = path.split("/").filter(Boolean);
+			let current = "";
+			for (const part of parts) {
+				current += `/${part}`;
+				if (!(this.directories.has(current) || this.files.has(current))) {
+					this.directories.add(current);
+					this.fileMetadata.set(current, {
+						mtime: /* @__PURE__ */ new Date(),
+						isDirectory: true
+					});
+				}
+			}
+		} else {
+			const parentPath = path.substring(0, path.lastIndexOf("/")) || "/";
+			if (parentPath !== "/" && !this.directories.has(parentPath) && !this.files.has(parentPath)) throw new Error(`No such file or directory: ${parentPath}`);
+			this.directories.add(path);
+			this.fileMetadata.set(path, {
+				mtime: /* @__PURE__ */ new Date(),
+				isDirectory: true
+			});
+		}
+	}
+	async stat(path) {
+		const normalizedPath = path.replace(TRAILING_SLASH_REGEX, "") || "/";
+		if (this.directories.has(normalizedPath)) return {
+			isDirectory: true,
+			size: 0,
+			mtime: this.fileMetadata.get(normalizedPath)?.mtime || /* @__PURE__ */ new Date()
+		};
+		if (this.files.has(normalizedPath)) {
+			const content = this.files.get(normalizedPath);
+			if (content === void 0) throw new Error(`No such file or directory: ${path}`);
+			return {
+				isDirectory: false,
+				size: content.byteLength,
+				mtime: this.fileMetadata.get(normalizedPath)?.mtime || /* @__PURE__ */ new Date()
+			};
+		}
+		throw new Error(`No such file or directory: ${path}`);
+	}
+	async exists(path) {
+		return this.files.has(path) || this.directories.has(path);
+	}
+};
+
+//#endregion
+export { MemoryFS };
+//# sourceMappingURL=fs.mjs.map

package/dist/fs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.mjs","names":[],"sources":["../src/fs/memory.ts"],"sourcesContent":["import type { Stream } from '../stream';\nimport type { FS } from './fs';\n\nexport type { FS } from './fs';\n\nconst TRAILING_SLASH_REGEX = /\\/$/;\n\nexport class MemoryFS implements FS {\n\tprivate readonly files = new Map<string, Uint8Array>();\n\tprivate readonly directories = new Set<string>();\n\tprivate readonly fileMetadata = new Map<\n\t\tstring,\n\t\t{ mtime: Date; isDirectory: boolean }\n\t>();\n\n\tconstructor() {\n\t\t// Initialize root directory\n\t\tthis.directories.add('/');\n\t\tthis.fileMetadata.set('/', { mtime: new Date(), isDirectory: true });\n\t}\n\n\tsetFile(path: string, content: string | Uint8Array): void {\n\t\tconst encoded =\n\t\t\ttypeof content === 'string'\n\t\t\t\t? new TextEncoder().encode(content)\n\t\t\t\t: content;\n\t\tthis.files.set(path, encoded);\n\t\tthis.fileMetadata.set(path, { mtime: new Date(), isDirectory: false });\n\t}\n\n\tasync readFile(path: string): Promise<Uint8Array> {\n\t\tconst content = this.files.get(path);\n\t\tif (!content) {\n\t\t\tthrow new Error(`File not found: ${path}`);\n\t\t}\n\t\treturn content;\n\t}\n\n\tasync *readLines(path: string): Stream<string> {\n\t\tconst content = this.files.get(path);\n\t\tif (!content) {\n\t\t\tthrow new Error(`File not found: ${path}`);\n\t\t}\n\t\tconst text = new TextDecoder().decode(content);\n\t\tconst lines = text\n\t\t\t.split('\\n')\n\t\t\t.filter((_, i, arr) => !(i === arr.length - 1 && arr[i] === ''));\n\t\tyield* lines;\n\t}\n\n\tasync writeFile(path: string, content: Uint8Array): Promise<void> {\n\t\tthis.files.set(path, content);\n\t}\n\n\tasync deleteFile(path: string): Promise<void> {\n\t\tif (!this.files.has(path)) {\n\t\t\tthrow new Error(`File not found: ${path}`);\n\t\t}\n\t\tthis.files.delete(path);\n\t}\n\n\tasync *readdir(glob: string): Stream<string> {\n\t\tconst pattern = glob\n\t\t\t.replace(/\\*\\*/g, '.*')\n\t\t\t.replace(/\\*/g, '[^/]*')\n\t\t\t.replace(/\\?/g, '[^/]')\n\t\t\t.replace(/\\./g, '\\\\.');\n\n\t\tconst regex = new RegExp(`^${pattern}$`);\n\n\t\tconst paths = Array.from(this.files.keys())\n\t\t\t.filter((path) => regex.test(path))\n\t\t\t.sort();\n\n\t\tfor (const path of paths) {\n\t\t\tyield path;\n\t\t}\n\t}\n\n\tasync mkdir(path: string, recursive = false): Promise<void> {\n\t\tif (this.directories.has(path) || this.files.has(path)) {\n\t\t\tthrow new Error(`Directory already exists: ${path}`);\n\t\t}\n\n\t\tif (recursive) {\n\t\t\t// Create all parent directories\n\t\t\tconst parts = path.split('/').filter(Boolean);\n\t\t\tlet current = '';\n\t\t\tfor (const part of parts) {\n\t\t\t\tcurrent += `/${part}`;\n\t\t\t\tif (\n\t\t\t\t\t!(this.directories.has(current) || this.files.has(current))\n\t\t\t\t) {\n\t\t\t\t\tthis.directories.add(current);\n\t\t\t\t\tthis.fileMetadata.set(current, {\n\t\t\t\t\t\tmtime: new Date(),\n\t\t\t\t\t\tisDirectory: true,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\t// Check if parent directory exists\n\t\t\tconst parentPath = path.substring(0, path.lastIndexOf('/')) || '/';\n\t\t\tif (\n\t\t\t\tparentPath !== '/' &&\n\t\t\t\t!this.directories.has(parentPath) &&\n\t\t\t\t!this.files.has(parentPath)\n\t\t\t) {\n\t\t\t\tthrow new Error(`No such file or directory: ${parentPath}`);\n\t\t\t}\n\t\t\tthis.directories.add(path);\n\t\t\tthis.fileMetadata.set(path, {\n\t\t\t\tmtime: new Date(),\n\t\t\t\tisDirectory: true,\n\t\t\t});\n\t\t}\n\t}\n\n\tasync stat(\n\t\tpath: string\n\t): Promise<{ isDirectory: boolean; size: number; mtime: Date }> {\n\t\t// Normalize path by removing trailing slash\n\t\tconst normalizedPath = path.replace(TRAILING_SLASH_REGEX, '') || '/';\n\n\t\tif (this.directories.has(normalizedPath)) {\n\t\t\treturn {\n\t\t\t\tisDirectory: true,\n\t\t\t\tsize: 0,\n\t\t\t\tmtime:\n\t\t\t\t\tthis.fileMetadata.get(normalizedPath)?.mtime || new Date(),\n\t\t\t};\n\t\t}\n\n\t\tif (this.files.has(normalizedPath)) {\n\t\t\tconst content = this.files.get(normalizedPath);\n\t\t\tif (content === undefined) {\n\t\t\t\tthrow new Error(`No such file or directory: ${path}`);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tisDirectory: false,\n\t\t\t\tsize: content.byteLength,\n\t\t\t\tmtime:\n\t\t\t\t\tthis.fileMetadata.get(normalizedPath)?.mtime || new Date(),\n\t\t\t};\n\t\t}\n\n\t\tthrow new Error(`No such file or directory: ${path}`);\n\t}\n\n\tasync exists(path: string): Promise<boolean> {\n\t\treturn this.files.has(path) || this.directories.has(path);\n\t}\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,46 @@
+import { t as FS } from "./fs-DSmBon4m.mjs";
+
+//#region src/record.d.ts
+interface FileRecord {
+  kind: 'file';
+  path: string;
+}
+interface LineRecord {
+  kind: 'line';
+  text: string;
+  file?: string;
+  lineNum?: number;
+}
+interface JsonRecord {
+  kind: 'json';
+  value: unknown;
+}
+/**
+ * Record is the unit of data flowing through pipelines.
+ * Commands operate on records, not bytes.
+ */
+type Record = FileRecord | LineRecord | JsonRecord;
+//#endregion
+//#region src/shell/shell.d.ts
+declare class Shell {
+  private readonly fs;
+  constructor(fs: FS);
+  $: (strings: TemplateStringsArray, ...exprs: unknown[]) => {
+    json(): Promise<unknown[]>;
+    lines(): Promise<string[]>;
+    raw(): Promise<Record[]>;
+    stdout(): Promise<void>;
+    text(): Promise<string>;
+  };
+  exec(strings: TemplateStringsArray, ...exprs: unknown[]): {
+    json(): Promise<unknown[]>;
+    lines(): Promise<string[]>;
+    raw(): Promise<Record[]>;
+    stdout(): Promise<void>;
+    text(): Promise<string>;
+  };
+  private _exec;
+}
+//#endregion
+export { Shell };
+//# sourceMappingURL=index.d.mts.map