@elaraai/east-node-std 0.0.1-beta.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAW5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,qDAQxB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,qDAQ5B,CAAC;AAGF,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,86 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * East Node - Node.js platform integration for East language
+ *
+ * @packageDocumentation
+ */
+// Export test utilities
+export * from "./test.js";
+// Export platform function definitions and implementations
+export * from "./console.js";
+export * from "./fs.js";
+export * from "./path.js";
+export * from "./crypto.js";
+export * from "./time.js";
+export * from "./fetch.js";
+export * from "./random.js";
+// Import implementations for combined export
+import { ConsoleImpl } from "./console.js";
+import { FileSystemImpl } from "./fs.js";
+import { PathImpl } from "./path.js";
+import { CryptoImpl } from "./crypto.js";
+import { TimeImpl } from "./time.js";
+import { FetchImpl } from "./fetch.js";
+import { RandomImpl } from "./random.js";
+/**
+ * Complete Node.js platform implementation.
+ *
+ * Pass this array to `compile()` or `compileAsync()` to enable all Node.js platform functions.
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { NodePlatform, Console, FileSystem } from "@elaraai/east-node-std";
+ *
+ * const fn = East.function([], NullType, $ => {
+ *     const content = $.let(FileSystem.readFile("data.txt"));
+ *     $(Console.log(content));
+ * });
+ *
+ * // Note: Use compileAsync since TimeImpl uses async
+ * const compiled = fn.toIR().compileAsync(NodePlatform);
+ * await compiled();
+ * ```
+ */
+export const NodePlatform = [
+    ...ConsoleImpl,
+    ...FileSystemImpl,
+    ...PathImpl,
+    ...CryptoImpl,
+    ...TimeImpl,
+    ...FetchImpl,
+    ...RandomImpl,
+];
+/**
+ * Synchronous subset of Node.js platform (excludes Time.sleep and Fetch operations).
+ *
+ * Use this for programs that don't need async operations.
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { NodePlatformSync, Console } from "@elaraai/east-node-std";
+ *
+ * const fn = East.function([], NullType, $ => {
+ *     $(Console.log("Hello, World!"));
+ * });
+ *
+ * const compiled = fn.toIR().compile(NodePlatformSync);
+ * compiled();
+ * ```
+ */
+export const NodePlatformSync = [
+    ...ConsoleImpl,
+    ...FileSystemImpl,
+    ...PathImpl,
+    ...CryptoImpl,
+    ...RandomImpl,
+    // TimeImpl excluded (has async sleep)
+    // FetchImpl excluded (all async)
+];
+// Re-export all exports as a nested EastNode namespace (matching East.East pattern)
+export * as EastNode from './index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,wBAAwB;AACxB,cAAc,WAAW,CAAC;AAE1B,2DAA2D;AAC3D,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAE5B,6CAA6C;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,GAAG,WAAW;IACd,GAAG,cAAc;IACjB,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,QAAQ;IACX,GAAG,SAAS;IACZ,GAAG,UAAU;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,WAAW;IACd,GAAG,cAAc;IACjB,GAAG,QAAQ;IACX,GAAG,UAAU;IACb,GAAG,UAAU;IACb,sCAAsC;IACtC,iCAAiC;CACpC,CAAC;AAEF,oFAAoF;AACpF,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/path.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { StringType, ArrayType } from "@elaraai/east";
+import type { PlatformFunction, PlatformFunctionDef } from "@elaraai/east/internal";
+/**
+ * Joins path segments into a single path.
+ *
+ * Combines an array of path segments using the platform-specific path separator.
+ * Normalizes the resulting path by resolving `.` and `..` segments. Empty segments
+ * are ignored.
+ *
+ * This is a platform function for the East language, enabling path joining
+ * in East programs running on Node.js.
+ *
+ * @param segments - Array of path segments to join (e.g., ["dir", "subdir", "file.txt"])
+ * @returns The joined path with platform-specific separators
+ *
+ * @example
+ * ```ts
+ * const buildPath = East.function([], StringType, $ => {
+ *     const segments = East.value(["home", "user", "documents", "file.txt"]);
+ *     return Path.join(segments);
+ *     // Returns: "home/user/documents/file.txt" (Unix) or "home\\user\\documents\\file.txt" (Windows)
+ * });
+ * ```
+ */
+export declare const path_join: PlatformFunctionDef<[ReturnType<typeof ArrayType<typeof StringType>>], typeof StringType>;
+/**
+ * Resolves a path to an absolute path.
+ *
+ * Converts a relative path to an absolute path by resolving it against the current
+ * working directory. If the path is already absolute, it is normalized and returned.
+ * Resolves `.` and `..` segments to their actual locations.
+ *
+ * This is a platform function for the East language, enabling path resolution
+ * in East programs running on Node.js.
+ *
+ * @param path - The path to resolve (relative or absolute)
+ * @returns The absolute path
+ *
+ * @example
+ * ```ts
+ * const getAbsolutePath = East.function([], StringType, $ => {
+ *     return Path.resolve("../documents/file.txt");
+ *     // Returns: "/home/user/documents/file.txt" (example)
+ * });
+ * ```
+ */
+export declare const path_resolve: PlatformFunctionDef<[typeof StringType], typeof StringType>;
+/**
+ * Gets the directory name from a path.
+ *
+ * Extracts the directory portion of a path by removing the last segment (file name).
+ * Similar to the Unix `dirname` command. Trailing path separators are ignored.
+ *
+ * This is a platform function for the East language, enabling directory extraction
+ * in East programs running on Node.js.
+ *
+ * @param path - The file path to extract directory from
+ * @returns The directory portion of the path
+ *
+ * @example
+ * ```ts
+ * const getDir = East.function([], StringType, $ => {
+ *     return Path.dirname("/home/user/documents/file.txt");
+ *     // Returns: "/home/user/documents"
+ * });
+ * ```
+ */
+export declare const path_dirname: PlatformFunctionDef<[typeof StringType], typeof StringType>;
+/**
+ * Gets the base name (file name) from a path.
+ *
+ * Extracts the last segment of a path, typically the file name. Similar to the Unix
+ * `basename` command. Trailing path separators are ignored.
+ *
+ * This is a platform function for the East language, enabling filename extraction
+ * in East programs running on Node.js.
+ *
+ * @param path - The file path to extract filename from
+ * @returns The file name portion of the path (including extension)
+ *
+ * @example
+ * ```ts
+ * const getFilename = East.function([], StringType, $ => {
+ *     return Path.basename("/home/user/documents/file.txt");
+ *     // Returns: "file.txt"
+ * });
+ * ```
+ */
+export declare const path_basename: PlatformFunctionDef<[typeof StringType], typeof StringType>;
+/**
+ * Gets the file extension from a path.
+ *
+ * Extracts the file extension from a path, including the leading dot. If the path
+ * has no extension or ends with a dot, returns an empty string. Only returns the
+ * last extension if multiple dots are present.
+ *
+ * This is a platform function for the East language, enabling extension extraction
+ * in East programs running on Node.js.
+ *
+ * @param path - The file path to extract extension from
+ * @returns The file extension including the dot (e.g., ".txt"), or empty string if none
+ *
+ * @example
+ * ```ts
+ * const getExtension = East.function([], StringType, $ => {
+ *     return Path.extname("/home/user/documents/file.txt");
+ *     // Returns: ".txt"
+ * });
+ * ```
+ */
+export declare const path_extname: PlatformFunctionDef<[typeof StringType], typeof StringType>;
+/**
+ * Node.js implementation of path platform functions.
+ *
+ * Pass this array to {@link East.compile} to enable path operations.
+ */
+declare const PathImpl: PlatformFunction[];
+/**
+ * Grouped path manipulation platform functions.
+ *
+ * Provides path utilities for East programs.
+ *
+ * @example
+ * ```ts
+ * import { East, StringType } from "@elaraai/east";
+ * import { Path } from "@elaraai/east-node-std";
+ *
+ * const buildPath = East.function([], StringType, $ => {
+ *     const segments = East.value(["dir", "subdir", "file.txt"]);
+ *     const fullPath = $.let(Path.join(segments));
+ *     const ext = $.let(Path.extname(fullPath));
+ *     return fullPath;
+ * });
+ *
+ * const compiled = East.compile(buildPath.toIR(), Path.Implementation);
+ * await compiled();  // Returns: "dir/subdir/file.txt"
+ * ```
+ */
+export declare const Path: {
+    /**
+     * Joins path segments into a single path.
+     *
+     * Combines an array of path segments using the platform-specific path separator.
+     * Normalizes the resulting path and ignores empty segments.
+     *
+     * @param segments - Array of path segments to join
+     * @returns The joined path with platform-specific separators
+     *
+     * @example
+     * ```ts
+     * const buildPath = East.function([], StringType, $ => {
+     *     const segments = East.value(["home", "user", "file.txt"]);
+     *     return Path.join(segments);
+     * });
+     * ```
+     */
+    readonly join: PlatformFunctionDef<[ArrayType<StringType>], StringType>;
+    /**
+     * Resolves a path to an absolute path.
+     *
+     * Converts a relative path to an absolute path by resolving it against the
+     * current working directory. Normalizes the path and resolves `.` and `..` segments.
+     *
+     * @param path - The path to resolve (relative or absolute)
+     * @returns The absolute path
+     *
+     * @example
+     * ```ts
+     * const getAbsolutePath = East.function([], StringType, $ => {
+     *     return Path.resolve("../documents/file.txt");
+     * });
+     * ```
+     */
+    readonly resolve: PlatformFunctionDef<[StringType], StringType>;
+    /**
+     * Gets the directory name from a path.
+     *
+     * Extracts the directory portion of a path by removing the last segment (file name).
+     * Trailing path separators are ignored.
+     *
+     * @param path - The file path to extract directory from
+     * @returns The directory portion of the path
+     *
+     * @example
+     * ```ts
+     * const getDir = East.function([], StringType, $ => {
+     *     return Path.dirname("/home/user/documents/file.txt");
+     * });
+     * ```
+     */
+    readonly dirname: PlatformFunctionDef<[StringType], StringType>;
+    /**
+     * Gets the base name (file name) from a path.
+     *
+     * Extracts the last segment of a path, typically the file name.
+     * Trailing path separators are ignored.
+     *
+     * @param path - The file path to extract filename from
+     * @returns The file name portion of the path (including extension)
+     *
+     * @example
+     * ```ts
+     * const getFilename = East.function([], StringType, $ => {
+     *     return Path.basename("/home/user/documents/file.txt");
+     * });
+     * ```
+     */
+    readonly basename: PlatformFunctionDef<[StringType], StringType>;
+    /**
+     * Gets the file extension from a path.
+     *
+     * Extracts the file extension from a path, including the leading dot.
+     * Returns empty string if no extension exists.
+     *
+     * @param path - The file path to extract extension from
+     * @returns The file extension including the dot (e.g., ".txt"), or empty string
+     *
+     * @example
+     * ```ts
+     * const getExtension = East.function([], StringType, $ => {
+     *     return Path.extname("file.txt");
+     * });
+     *
+     * const compiled = East.compile(getExtension.toIR(), Path.Implementation);
+     * await compiled();  // Returns: ".txt"
+     * ```
+     */
+    readonly extname: PlatformFunctionDef<[StringType], StringType>;
+    /**
+     * Node.js implementation of path platform functions.
+     *
+     * Pass this to {@link East.compile} to enable path operations.
+     */
+    readonly Implementation: PlatformFunction[];
+};
+export { PathImpl };
+//# sourceMappingURL=path.d.ts.map

package/dist/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS,EAAE,mBAAmB,CAAC,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,UAAU,CAAmE,CAAC;AAEpL;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,YAAY,EAAE,mBAAmB,CAAC,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,UAAU,CAA2D,CAAC;AAEjJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,EAAE,mBAAmB,CAAC,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,UAAU,CAA2D,CAAC;AAEjJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,aAAa,EAAE,mBAAmB,CAAC,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,UAAU,CAA4D,CAAC;AAEnJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,YAAY,EAAE,mBAAmB,CAAC,CAAC,OAAO,UAAU,CAAC,EAAE,OAAO,UAAU,CAA2D,CAAC;AAEjJ;;;;GAIG;AACH,QAAA,MAAM,QAAQ,EAAE,gBAAgB,EAmD/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;OAeG;;IAGH;;;;;;;;;;;;;;;;;;OAkBG;;IAGH;;;;OAIG;;CAEG,CAAC;AAGX,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/path.js

@@ -0,0 +1,299 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, StringType, ArrayType } from "@elaraai/east";
+import { EastError } from "@elaraai/east/internal";
+import { join, resolve, dirname, basename, extname } from "node:path";
+/**
+ * Joins path segments into a single path.
+ *
+ * Combines an array of path segments using the platform-specific path separator.
+ * Normalizes the resulting path by resolving `.` and `..` segments. Empty segments
+ * are ignored.
+ *
+ * This is a platform function for the East language, enabling path joining
+ * in East programs running on Node.js.
+ *
+ * @param segments - Array of path segments to join (e.g., ["dir", "subdir", "file.txt"])
+ * @returns The joined path with platform-specific separators
+ *
+ * @example
+ * ```ts
+ * const buildPath = East.function([], StringType, $ => {
+ *     const segments = East.value(["home", "user", "documents", "file.txt"]);
+ *     return Path.join(segments);
+ *     // Returns: "home/user/documents/file.txt" (Unix) or "home\\user\\documents\\file.txt" (Windows)
+ * });
+ * ```
+ */
+export const path_join = East.platform("path_join", [ArrayType(StringType)], StringType);
+/**
+ * Resolves a path to an absolute path.
+ *
+ * Converts a relative path to an absolute path by resolving it against the current
+ * working directory. If the path is already absolute, it is normalized and returned.
+ * Resolves `.` and `..` segments to their actual locations.
+ *
+ * This is a platform function for the East language, enabling path resolution
+ * in East programs running on Node.js.
+ *
+ * @param path - The path to resolve (relative or absolute)
+ * @returns The absolute path
+ *
+ * @example
+ * ```ts
+ * const getAbsolutePath = East.function([], StringType, $ => {
+ *     return Path.resolve("../documents/file.txt");
+ *     // Returns: "/home/user/documents/file.txt" (example)
+ * });
+ * ```
+ */
+export const path_resolve = East.platform("path_resolve", [StringType], StringType);
+/**
+ * Gets the directory name from a path.
+ *
+ * Extracts the directory portion of a path by removing the last segment (file name).
+ * Similar to the Unix `dirname` command. Trailing path separators are ignored.
+ *
+ * This is a platform function for the East language, enabling directory extraction
+ * in East programs running on Node.js.
+ *
+ * @param path - The file path to extract directory from
+ * @returns The directory portion of the path
+ *
+ * @example
+ * ```ts
+ * const getDir = East.function([], StringType, $ => {
+ *     return Path.dirname("/home/user/documents/file.txt");
+ *     // Returns: "/home/user/documents"
+ * });
+ * ```
+ */
+export const path_dirname = East.platform("path_dirname", [StringType], StringType);
+/**
+ * Gets the base name (file name) from a path.
+ *
+ * Extracts the last segment of a path, typically the file name. Similar to the Unix
+ * `basename` command. Trailing path separators are ignored.
+ *
+ * This is a platform function for the East language, enabling filename extraction
+ * in East programs running on Node.js.
+ *
+ * @param path - The file path to extract filename from
+ * @returns The file name portion of the path (including extension)
+ *
+ * @example
+ * ```ts
+ * const getFilename = East.function([], StringType, $ => {
+ *     return Path.basename("/home/user/documents/file.txt");
+ *     // Returns: "file.txt"
+ * });
+ * ```
+ */
+export const path_basename = East.platform("path_basename", [StringType], StringType);
+/**
+ * Gets the file extension from a path.
+ *
+ * Extracts the file extension from a path, including the leading dot. If the path
+ * has no extension or ends with a dot, returns an empty string. Only returns the
+ * last extension if multiple dots are present.
+ *
+ * This is a platform function for the East language, enabling extension extraction
+ * in East programs running on Node.js.
+ *
+ * @param path - The file path to extract extension from
+ * @returns The file extension including the dot (e.g., ".txt"), or empty string if none
+ *
+ * @example
+ * ```ts
+ * const getExtension = East.function([], StringType, $ => {
+ *     return Path.extname("/home/user/documents/file.txt");
+ *     // Returns: ".txt"
+ * });
+ * ```
+ */
+export const path_extname = East.platform("path_extname", [StringType], StringType);
+/**
+ * Node.js implementation of path platform functions.
+ *
+ * Pass this array to {@link East.compile} to enable path operations.
+ */
+const PathImpl = [
+    path_join.implement((segments) => {
+        try {
+            return join(...segments);
+        }
+        catch (err) {
+            throw new EastError(`Failed to join path segments: ${err.message}`, {
+                location: { filename: "path_join", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    path_resolve.implement((path) => {
+        try {
+            return resolve(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to resolve path: ${err.message}`, {
+                location: { filename: "path_resolve", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    path_dirname.implement((path) => {
+        try {
+            return dirname(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to get dirname: ${err.message}`, {
+                location: { filename: "path_dirname", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    path_basename.implement((path) => {
+        try {
+            return basename(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to get basename: ${err.message}`, {
+                location: { filename: "path_basename", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    path_extname.implement((path) => {
+        try {
+            return extname(path);
+        }
+        catch (err) {
+            throw new EastError(`Failed to get extname: ${err.message}`, {
+                location: { filename: "path_extname", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+];
+/**
+ * Grouped path manipulation platform functions.
+ *
+ * Provides path utilities for East programs.
+ *
+ * @example
+ * ```ts
+ * import { East, StringType } from "@elaraai/east";
+ * import { Path } from "@elaraai/east-node-std";
+ *
+ * const buildPath = East.function([], StringType, $ => {
+ *     const segments = East.value(["dir", "subdir", "file.txt"]);
+ *     const fullPath = $.let(Path.join(segments));
+ *     const ext = $.let(Path.extname(fullPath));
+ *     return fullPath;
+ * });
+ *
+ * const compiled = East.compile(buildPath.toIR(), Path.Implementation);
+ * await compiled();  // Returns: "dir/subdir/file.txt"
+ * ```
+ */
+export const Path = {
+    /**
+     * Joins path segments into a single path.
+     *
+     * Combines an array of path segments using the platform-specific path separator.
+     * Normalizes the resulting path and ignores empty segments.
+     *
+     * @param segments - Array of path segments to join
+     * @returns The joined path with platform-specific separators
+     *
+     * @example
+     * ```ts
+     * const buildPath = East.function([], StringType, $ => {
+     *     const segments = East.value(["home", "user", "file.txt"]);
+     *     return Path.join(segments);
+     * });
+     * ```
+     */
+    join: path_join,
+    /**
+     * Resolves a path to an absolute path.
+     *
+     * Converts a relative path to an absolute path by resolving it against the
+     * current working directory. Normalizes the path and resolves `.` and `..` segments.
+     *
+     * @param path - The path to resolve (relative or absolute)
+     * @returns The absolute path
+     *
+     * @example
+     * ```ts
+     * const getAbsolutePath = East.function([], StringType, $ => {
+     *     return Path.resolve("../documents/file.txt");
+     * });
+     * ```
+     */
+    resolve: path_resolve,
+    /**
+     * Gets the directory name from a path.
+     *
+     * Extracts the directory portion of a path by removing the last segment (file name).
+     * Trailing path separators are ignored.
+     *
+     * @param path - The file path to extract directory from
+     * @returns The directory portion of the path
+     *
+     * @example
+     * ```ts
+     * const getDir = East.function([], StringType, $ => {
+     *     return Path.dirname("/home/user/documents/file.txt");
+     * });
+     * ```
+     */
+    dirname: path_dirname,
+    /**
+     * Gets the base name (file name) from a path.
+     *
+     * Extracts the last segment of a path, typically the file name.
+     * Trailing path separators are ignored.
+     *
+     * @param path - The file path to extract filename from
+     * @returns The file name portion of the path (including extension)
+     *
+     * @example
+     * ```ts
+     * const getFilename = East.function([], StringType, $ => {
+     *     return Path.basename("/home/user/documents/file.txt");
+     * });
+     * ```
+     */
+    basename: path_basename,
+    /**
+     * Gets the file extension from a path.
+     *
+     * Extracts the file extension from a path, including the leading dot.
+     * Returns empty string if no extension exists.
+     *
+     * @param path - The file path to extract extension from
+     * @returns The file extension including the dot (e.g., ".txt"), or empty string
+     *
+     * @example
+     * ```ts
+     * const getExtension = East.function([], StringType, $ => {
+     *     return Path.extname("file.txt");
+     * });
+     *
+     * const compiled = East.compile(getExtension.toIR(), Path.Implementation);
+     * await compiled();  // Returns: ".txt"
+     * ```
+     */
+    extname: path_extname,
+    /**
+     * Node.js implementation of path platform functions.
+     *
+     * Pass this to {@link East.compile} to enable path operations.
+     */
+    Implementation: PathImpl,
+};
+// Export for backwards compatibility
+export { PathImpl };
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":"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"}

package/dist/random/crypto-rng.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Vendored from npm package 'random' (https://github.com/transitive-bullshit/random)
+ * Originally by Travis Fischer, distributed under MIT license
+ */
+import RNG, { type SeedType } from "./rng.js";
+/**
+ * Cryptographically secure RNG using Node.js crypto.randomBytes
+ *
+ * Note: Seeding is not supported for cryptographic RNG as it uses the OS entropy source.
+ * The seed/clone methods are provided for API compatibility but have no effect.
+ */
+export default class CryptoRNG extends RNG {
+    get name(): string;
+    /**
+     * Generate a random number in [0, 1) using crypto.randomBytes
+     */
+    next(): number;
+    /**
+     * Seeding is not supported for cryptographic RNG (no-op for API compatibility)
+     */
+    seed(_seed?: SeedType, _opts?: Record<string, unknown>): void;
+    /**
+     * Clone returns a new instance (seeding not supported)
+     */
+    clone(_seed?: SeedType, _opts?: Record<string, unknown>): RNG;
+}
+//# sourceMappingURL=crypto-rng.d.ts.map

package/dist/random/crypto-rng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-rng.d.ts","sourceRoot":"","sources":["../../src/random/crypto-rng.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH;;;GAGG;AAGH,OAAO,GAAG,EAAE,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,GAAG;IACtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,IAAI,MAAM;IAQd;;OAEG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7D;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG;CAGhE"}