@rg-dev/stdlib 1.0.52 → 1.0.54

package/lib/browser-env.cjs

@@ -19,10 +19,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/browser-env.ts
 var browser_env_exports = {};
 __export(browser_env_exports, {
+  VERSION: () => VERSION,
   copyToClipboard: () => copyToClipboard,
   parseFormData: () => parseFormData
 });
 module.exports = __toCommonJS(browser_env_exports);
+
+// src/index.ts
+var VERSION = "1";
+
+// src/browser-env.ts
 function parseFormData(e) {
   if (e instanceof FormData) {
     return Object.fromEntries(e.entries());

package/lib/browser-env.d.cts

@@ -1,3 +1,5 @@
+export { VERSION } from './index.cjs';
+
 declare function parseFormData<T = Record<string, string>>(e: Event | FormData | HTMLFormElement): T;
 declare function copyToClipboard(content: any, opts?: {
     throwOnError: boolean;

package/lib/browser-env.d.ts

@@ -1,3 +1,5 @@
+export { VERSION } from './index.js';
+
 declare function parseFormData<T = Record<string, string>>(e: Event | FormData | HTMLFormElement): T;
 declare function copyToClipboard(content: any, opts?: {
     throwOnError: boolean;

package/lib/browser-env.js

@@ -1,3 +1,6 @@
+// src/index.ts
+var VERSION = "1";
+
 // src/browser-env.ts
 function parseFormData(e) {
   if (e instanceof FormData) {
@@ -67,6 +70,7 @@ function fallback(content) {
   }
 }
 export {
+  VERSION,
   copyToClipboard,
   parseFormData
 };

package/lib/common-env.cjs

@@ -36,6 +36,7 @@ var common_env_exports = {};
 __export(common_env_exports, {
   Optional: () => Optional,
   StringBuilder: () => StringBuilder,
+  VERSION: () => VERSION,
   catchInline: () => catchInline,
   doSafe: () => doSafe,
   fetchHelperJSON: () => fetchHelperJSON,
@@ -44,6 +45,7 @@ __export(common_env_exports, {
   isNonEmptyString: () => isNonEmptyString,
   isNumber: () => isNumber,
   isRunningOnServer: () => isRunningOnServer,
+  lazyValue: () => lazyValue,
   promiseRetry: () => promiseRetry,
   promiseWithTimeout: () => promiseWithTimeout,
   sleep: () => sleep,
@@ -51,6 +53,9 @@ __export(common_env_exports, {
 });
 module.exports = __toCommonJS(common_env_exports);
 
+// src/index.ts
+var VERSION = "1";
+
 // src/promise-retry.ts
 var defaultOptions = {
   maxAttempts: 10,
@@ -255,3 +260,14 @@ function isPromise(value) {
 function isNonEmptyString(str) {
   return typeof str == "string" && str.trim().length > 0;
 }
+function lazyValue(function_) {
+  let isCalled = false;
+  let result = void 0;
+  return () => {
+    if (!isCalled) {
+      isCalled = true;
+      result = function_();
+    }
+    return result;
+  };
+}

package/lib/common-env.d.cts

@@ -1,3 +1,5 @@
+export { VERSION } from './index.cjs';
+
 type Options = {
     maxAttempts: number;
     retryDelay: number;
@@ -73,5 +75,6 @@ declare function doSafe(safe: () => Promise<void> | void, onError?: (error: Erro
 declare function isRunningOnServer(): boolean;
 declare function useServer(fn: () => (Promise<any> | void), onError?: (err: Error) => void): Promise<any>;
 declare function isNonEmptyString(str?: string): boolean;
+declare function lazyValue<T = unknown>(function_: () => T): () => T;
 
-export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, StringBuilder, catchInline, doSafe, fetchHelperJSON, fetchHelperPost, fetchHelperText, isNonEmptyString, isNumber, isRunningOnServer, promiseRetry, promiseWithTimeout, sleep, useServer };
+export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, StringBuilder, catchInline, doSafe, fetchHelperJSON, fetchHelperPost, fetchHelperText, isNonEmptyString, isNumber, isRunningOnServer, lazyValue, promiseRetry, promiseWithTimeout, sleep, useServer };

package/lib/common-env.d.ts

@@ -1,3 +1,5 @@
+export { VERSION } from './index.js';
+
 type Options = {
     maxAttempts: number;
     retryDelay: number;
@@ -73,5 +75,6 @@ declare function doSafe(safe: () => Promise<void> | void, onError?: (error: Erro
 declare function isRunningOnServer(): boolean;
 declare function useServer(fn: () => (Promise<any> | void), onError?: (err: Error) => void): Promise<any>;
 declare function isNonEmptyString(str?: string): boolean;
+declare function lazyValue<T = unknown>(function_: () => T): () => T;
 
-export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, StringBuilder, catchInline, doSafe, fetchHelperJSON, fetchHelperPost, fetchHelperText, isNonEmptyString, isNumber, isRunningOnServer, promiseRetry, promiseWithTimeout, sleep, useServer };
+export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, StringBuilder, catchInline, doSafe, fetchHelperJSON, fetchHelperPost, fetchHelperText, isNonEmptyString, isNumber, isRunningOnServer, lazyValue, promiseRetry, promiseWithTimeout, sleep, useServer };

package/lib/common-env.js

@@ -16,6 +16,9 @@ var __spreadValues = (a, b) => {
 };
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// src/index.ts
+var VERSION = "1";
+
 // src/promise-retry.ts
 var defaultOptions = {
   maxAttempts: 10,
@@ -220,9 +223,21 @@ function isPromise(value) {
 function isNonEmptyString(str) {
   return typeof str == "string" && str.trim().length > 0;
 }
+function lazyValue(function_) {
+  let isCalled = false;
+  let result = void 0;
+  return () => {
+    if (!isCalled) {
+      isCalled = true;
+      result = function_();
+    }
+    return result;
+  };
+}
 export {
   Optional,
   StringBuilder,
+  VERSION,
   catchInline,
   doSafe,
   fetchHelperJSON,
@@ -231,6 +246,7 @@ export {
   isNonEmptyString,
   isNumber,
   isRunningOnServer,
+  lazyValue,
   promiseRetry,
   promiseWithTimeout,
   sleep,

package/lib/node-download.cjs

@@ -6182,12 +6182,16 @@ var init_src = __esm({
 // src/node-download.ts
 var node_download_exports = {};
 __export(node_download_exports, {
+  VERSION: () => VERSION,
   downloadFile: () => downloadFile
 });
 module.exports = __toCommonJS(node_download_exports);
 var fs2 = __toESM(require("fs"), 1);
 var import_stream = require("stream");
 
+// src/index.ts
+var VERSION = "1";
+
 // src/common-env.ts
 async function catchInline(cb) {
   try {

package/lib/node-download.d.cts

@@ -1,3 +1,5 @@
+export { VERSION } from './index.cjs';
+
 declare function downloadFile(url: string, destination: string, headers?: Record<string, any>): Promise<string>;
 
 export { downloadFile };

package/lib/node-download.d.ts

@@ -1,3 +1,5 @@
+export { VERSION } from './index.js';
+
 declare function downloadFile(url: string, destination: string, headers?: Record<string, any>): Promise<string>;
 
 export { downloadFile };

package/lib/node-download.js

@@ -6188,6 +6188,9 @@ var init_src = __esm({
 import * as fs2 from "fs";
 import { Readable } from "stream";
 
+// src/index.ts
+var VERSION = "1";
+
 // src/common-env.ts
 async function catchInline(cb) {
   try {
@@ -6237,6 +6240,7 @@ function downloadFile(url, destination, headers) {
   );
 }
 export {
+  VERSION,
   downloadFile
 };
 /*! Bundled license information:

package/lib/node-env.cjs

@@ -51,7 +51,7 @@ var require_command_exists = __commonJS({
     var exec = require("child_process").exec;
     var execSync = require("child_process").execSync;
     var fs2 = require("fs");
-    var path2 = require("path");
+    var path3 = require("path");
     var access = fs2.access;
     var accessSync = fs2.accessSync;
     var constants = fs2.constants || fs2;
@@ -155,8 +155,8 @@ var require_command_exists = __commonJS({
       cleanInput = function(s) {
         var isPathName = /[\\]/.test(s);
         if (isPathName) {
-          var dirname = '"' + path2.dirname(s) + '"';
-          var basename = '"' + path2.basename(s) + '"';
+          var dirname = '"' + path3.dirname(s) + '"';
+          var basename = '"' + path3.basename(s) + '"';
           return dirname + ":" + basename;
         }
         return '"' + s + '"';
@@ -204,12 +204,14 @@ var node_env_exports = {};
 __export(node_env_exports, {
   SSEClient: () => SSEClient,
   SSEResponse: () => SSEResponse,
+  VERSION: () => VERSION,
   checkCommandExistsOrThrow: () => checkCommandExistsOrThrow,
   checkIfDirExistsOrThrow: () => checkIfDirExistsOrThrow,
   checkIfFileExistsOrThrow: () => checkIfFileExistsOrThrow,
   chmodPlusX: () => chmodPlusX,
   createTempDir: () => createTempDir,
   createTempFilePath: () => createTempFilePath,
+  getEnvPaths: () => getEnvPaths,
   isWindows: () => isWindows,
   throwIfDirNotEmpty: () => throwIfDirNotEmpty,
   typedSystemArch: () => typedSystemArch
@@ -338,7 +340,69 @@ var SSEClient = class extends import_events.EventEmitter {
   }
 };
 
+// src/index.ts
+var VERSION = "1";
+
+// node_modules/env-paths/index.js
+var import_node_path = __toESM(require("path"), 1);
+var import_node_os = __toESM(require("os"), 1);
+var import_node_process = __toESM(require("process"), 1);
+var homedir = import_node_os.default.homedir();
+var tmpdir = import_node_os.default.tmpdir();
+var { env } = import_node_process.default;
+var macos = (name) => {
+  const library = import_node_path.default.join(homedir, "Library");
+  return {
+    data: import_node_path.default.join(library, "Application Support", name),
+    config: import_node_path.default.join(library, "Preferences", name),
+    cache: import_node_path.default.join(library, "Caches", name),
+    log: import_node_path.default.join(library, "Logs", name),
+    temp: import_node_path.default.join(tmpdir, name)
+  };
+};
+var windows = (name) => {
+  const appData = env.APPDATA || import_node_path.default.join(homedir, "AppData", "Roaming");
+  const localAppData = env.LOCALAPPDATA || import_node_path.default.join(homedir, "AppData", "Local");
+  return {
+    // Data/config/cache/log are invented by me as Windows isn't opinionated about this
+    data: import_node_path.default.join(localAppData, name, "Data"),
+    config: import_node_path.default.join(appData, name, "Config"),
+    cache: import_node_path.default.join(localAppData, name, "Cache"),
+    log: import_node_path.default.join(localAppData, name, "Log"),
+    temp: import_node_path.default.join(tmpdir, name)
+  };
+};
+var linux = (name) => {
+  const username = import_node_path.default.basename(homedir);
+  return {
+    data: import_node_path.default.join(env.XDG_DATA_HOME || import_node_path.default.join(homedir, ".local", "share"), name),
+    config: import_node_path.default.join(env.XDG_CONFIG_HOME || import_node_path.default.join(homedir, ".config"), name),
+    cache: import_node_path.default.join(env.XDG_CACHE_HOME || import_node_path.default.join(homedir, ".cache"), name),
+    // https://wiki.debian.org/XDGBaseDirectorySpecification#state
+    log: import_node_path.default.join(env.XDG_STATE_HOME || import_node_path.default.join(homedir, ".local", "state"), name),
+    temp: import_node_path.default.join(tmpdir, username, name)
+  };
+};
+function envPaths(name, { suffix = "nodejs" } = {}) {
+  if (typeof name !== "string") {
+    throw new TypeError(`Expected a string, got ${typeof name}`);
+  }
+  if (suffix) {
+    name += `-${suffix}`;
+  }
+  if (import_node_process.default.platform === "darwin") {
+    return macos(name);
+  }
+  if (import_node_process.default.platform === "win32") {
+    return windows(name);
+  }
+  return linux(name);
+}
+
 // src/node-env.ts
+function getEnvPaths(name, options) {
+  return envPaths(name, options);
+}
 function isWindows() {
   return import_os.default.platform() === "win32";
 }
@@ -358,14 +422,14 @@ function chmodPlusX(filePath) {
     console.error(`Failed to chmod +x ${filePath}:`, String((e == null ? void 0 : e.message) || e));
   }
 }
-async function checkIfDirExistsOrThrow(path2) {
-  if (!path2) throw "path is empty";
-  path2 = removeQuotes(path2);
-  if (!await fs.pathExists(path2)) {
-    throw new Error(`path ${path2} not exists`);
+async function checkIfDirExistsOrThrow(path3) {
+  if (!path3) throw "path is empty";
+  path3 = removeQuotes(path3);
+  if (!await fs.pathExists(path3)) {
+    throw new Error(`path ${path3} not exists`);
   }
-  if (!(await fs.stat(path2)).isDirectory()) {
-    throw new Error(`${path2} is a file, require dir`);
+  if (!(await fs.stat(path3)).isDirectory()) {
+    throw new Error(`${path3} is a file, require dir`);
   }
 }
 function createTempDir() {

package/lib/node-env.d.cts

@@ -1,5 +1,6 @@
 import { Response } from 'express';
 import { EventEmitter } from 'events';
+export { VERSION } from './index.cjs';
 
 declare class SSEResponse<Events extends string = 'message'> {
     private res;
@@ -27,6 +28,75 @@ declare class SSEClient extends EventEmitter {
     close(): void;
 }
 
+interface Options {
+	/**
+	__Don't use this option unless you really have to!__
+
+	Suffix appended to the project name to avoid name conflicts with native apps. Pass an empty string to disable it.
+
+	@default 'nodejs'
+	*/
+	readonly suffix?: string;
+}
+
+interface Paths {
+	/**
+	Directory for data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Application Support/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Data` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Data`)
+	- Linux: `~/.local/share/MyApp-nodejs` (or `$XDG_DATA_HOME/MyApp-nodejs`)
+	*/
+	readonly data: string;
+
+	/**
+	Directory for data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Preferences/MyApp-nodejs`
+	- Windows: `%APPDATA%\MyApp-nodejs\Config` (for example, `C:\Users\USERNAME\AppData\Roaming\MyApp-nodejs\Config`)
+	- Linux: `~/.config/MyApp-nodejs` (or `$XDG_CONFIG_HOME/MyApp-nodejs`)
+	*/
+	readonly config: string;
+
+	/**
+	Directory for non-essential data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Caches/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Cache` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Cache`)
+	- Linux: `~/.cache/MyApp-nodejs` (or `$XDG_CACHE_HOME/MyApp-nodejs`)
+	*/
+	readonly cache: string;
+
+	/**
+	Directory for log files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Logs/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Log` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Log`)
+	- Linux: `~/.local/state/MyApp-nodejs` (or `$XDG_STATE_HOME/MyApp-nodejs`)
+	*/
+	readonly log: string;
+
+	/**
+	Directory for temporary files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `/var/folders/jf/f2twvvvs5jl_m49tf034ffpw0000gn/T/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\Temp\MyApp-nodejs` (for example, `C:\Users\USERNAME\AppData\Local\Temp\MyApp-nodejs`)
+	- Linux: `/tmp/USERNAME/MyApp-nodejs`
+	*/
+	readonly temp: string;
+}
+
+declare function getEnvPaths(name: string, options?: Options): Paths;
 declare function isWindows(): boolean;
 type SystemArch = "x64" | "arm64" | "arm" | "ia32" | "ppc64" | "s390x" | "loong64" | "riscv64";
 declare function typedSystemArch(): SystemArch;
@@ -41,4 +111,4 @@ declare function throwIfDirNotEmpty(dirPath: string): Promise<void>;
 declare function checkCommandExistsOrThrow(cmd: string): Promise<void>;
 declare function checkIfFileExistsOrThrow(thePath: string): Promise<void>;
 
-export { SSEClient, SSEResponse, type SystemArch, checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, createTempFilePath, isWindows, throwIfDirNotEmpty, typedSystemArch };
+export { SSEClient, SSEResponse, type SystemArch, checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, createTempFilePath, getEnvPaths, isWindows, throwIfDirNotEmpty, typedSystemArch };

package/lib/node-env.d.ts

@@ -1,5 +1,6 @@
 import { Response } from 'express';
 import { EventEmitter } from 'events';
+export { VERSION } from './index.js';
 
 declare class SSEResponse<Events extends string = 'message'> {
     private res;
@@ -27,6 +28,75 @@ declare class SSEClient extends EventEmitter {
     close(): void;
 }
 
+interface Options {
+	/**
+	__Don't use this option unless you really have to!__
+
+	Suffix appended to the project name to avoid name conflicts with native apps. Pass an empty string to disable it.
+
+	@default 'nodejs'
+	*/
+	readonly suffix?: string;
+}
+
+interface Paths {
+	/**
+	Directory for data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Application Support/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Data` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Data`)
+	- Linux: `~/.local/share/MyApp-nodejs` (or `$XDG_DATA_HOME/MyApp-nodejs`)
+	*/
+	readonly data: string;
+
+	/**
+	Directory for data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Preferences/MyApp-nodejs`
+	- Windows: `%APPDATA%\MyApp-nodejs\Config` (for example, `C:\Users\USERNAME\AppData\Roaming\MyApp-nodejs\Config`)
+	- Linux: `~/.config/MyApp-nodejs` (or `$XDG_CONFIG_HOME/MyApp-nodejs`)
+	*/
+	readonly config: string;
+
+	/**
+	Directory for non-essential data files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Caches/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Cache` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Cache`)
+	- Linux: `~/.cache/MyApp-nodejs` (or `$XDG_CACHE_HOME/MyApp-nodejs`)
+	*/
+	readonly cache: string;
+
+	/**
+	Directory for log files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `~/Library/Logs/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\MyApp-nodejs\Log` (for example, `C:\Users\USERNAME\AppData\Local\MyApp-nodejs\Log`)
+	- Linux: `~/.local/state/MyApp-nodejs` (or `$XDG_STATE_HOME/MyApp-nodejs`)
+	*/
+	readonly log: string;
+
+	/**
+	Directory for temporary files.
+
+	Example locations (with the default `nodejs` suffix):
+
+	- macOS: `/var/folders/jf/f2twvvvs5jl_m49tf034ffpw0000gn/T/MyApp-nodejs`
+	- Windows: `%LOCALAPPDATA%\Temp\MyApp-nodejs` (for example, `C:\Users\USERNAME\AppData\Local\Temp\MyApp-nodejs`)
+	- Linux: `/tmp/USERNAME/MyApp-nodejs`
+	*/
+	readonly temp: string;
+}
+
+declare function getEnvPaths(name: string, options?: Options): Paths;
 declare function isWindows(): boolean;
 type SystemArch = "x64" | "arm64" | "arm" | "ia32" | "ppc64" | "s390x" | "loong64" | "riscv64";
 declare function typedSystemArch(): SystemArch;
@@ -41,4 +111,4 @@ declare function throwIfDirNotEmpty(dirPath: string): Promise<void>;
 declare function checkCommandExistsOrThrow(cmd: string): Promise<void>;
 declare function checkIfFileExistsOrThrow(thePath: string): Promise<void>;
 
-export { SSEClient, SSEResponse, type SystemArch, checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, createTempFilePath, isWindows, throwIfDirNotEmpty, typedSystemArch };
+export { SSEClient, SSEResponse, type SystemArch, checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, createTempFilePath, getEnvPaths, isWindows, throwIfDirNotEmpty, typedSystemArch };

package/lib/node-env.js

@@ -52,7 +52,7 @@ var require_command_exists = __commonJS({
     var exec = __require("child_process").exec;
     var execSync = __require("child_process").execSync;
     var fs2 = __require("fs");
-    var path2 = __require("path");
+    var path3 = __require("path");
     var access = fs2.access;
     var accessSync = fs2.accessSync;
     var constants = fs2.constants || fs2;
@@ -156,8 +156,8 @@ var require_command_exists = __commonJS({
       cleanInput = function(s) {
         var isPathName = /[\\]/.test(s);
         if (isPathName) {
-          var dirname = '"' + path2.dirname(s) + '"';
-          var basename = '"' + path2.basename(s) + '"';
+          var dirname = '"' + path3.dirname(s) + '"';
+          var basename = '"' + path3.basename(s) + '"';
           return dirname + ":" + basename;
         }
         return '"' + s + '"';
@@ -203,8 +203,8 @@ var require_command_exists2 = __commonJS({
 // src/node-env.ts
 var import_command_exists = __toESM(require_command_exists2(), 1);
 import * as fs from "fs-extra";
-import os from "os";
-import path from "path";
+import os2 from "os";
+import path2 from "path";
 
 // src/SSEResponse.ts
 var SSEResponse = class {
@@ -324,19 +324,81 @@ var SSEClient = class extends EventEmitter {
   }
 };
 
+// src/index.ts
+var VERSION = "1";
+
+// node_modules/env-paths/index.js
+import path from "path";
+import os from "os";
+import process2 from "process";
+var homedir = os.homedir();
+var tmpdir = os.tmpdir();
+var { env } = process2;
+var macos = (name) => {
+  const library = path.join(homedir, "Library");
+  return {
+    data: path.join(library, "Application Support", name),
+    config: path.join(library, "Preferences", name),
+    cache: path.join(library, "Caches", name),
+    log: path.join(library, "Logs", name),
+    temp: path.join(tmpdir, name)
+  };
+};
+var windows = (name) => {
+  const appData = env.APPDATA || path.join(homedir, "AppData", "Roaming");
+  const localAppData = env.LOCALAPPDATA || path.join(homedir, "AppData", "Local");
+  return {
+    // Data/config/cache/log are invented by me as Windows isn't opinionated about this
+    data: path.join(localAppData, name, "Data"),
+    config: path.join(appData, name, "Config"),
+    cache: path.join(localAppData, name, "Cache"),
+    log: path.join(localAppData, name, "Log"),
+    temp: path.join(tmpdir, name)
+  };
+};
+var linux = (name) => {
+  const username = path.basename(homedir);
+  return {
+    data: path.join(env.XDG_DATA_HOME || path.join(homedir, ".local", "share"), name),
+    config: path.join(env.XDG_CONFIG_HOME || path.join(homedir, ".config"), name),
+    cache: path.join(env.XDG_CACHE_HOME || path.join(homedir, ".cache"), name),
+    // https://wiki.debian.org/XDGBaseDirectorySpecification#state
+    log: path.join(env.XDG_STATE_HOME || path.join(homedir, ".local", "state"), name),
+    temp: path.join(tmpdir, username, name)
+  };
+};
+function envPaths(name, { suffix = "nodejs" } = {}) {
+  if (typeof name !== "string") {
+    throw new TypeError(`Expected a string, got ${typeof name}`);
+  }
+  if (suffix) {
+    name += `-${suffix}`;
+  }
+  if (process2.platform === "darwin") {
+    return macos(name);
+  }
+  if (process2.platform === "win32") {
+    return windows(name);
+  }
+  return linux(name);
+}
+
 // src/node-env.ts
+function getEnvPaths(name, options) {
+  return envPaths(name, options);
+}
 function isWindows() {
-  return os.platform() === "win32";
+  return os2.platform() === "win32";
 }
 function typedSystemArch() {
-  return os.arch();
+  return os2.arch();
 }
 function chmodPlusX(filePath) {
-  if (os.platform() === "win32") {
+  if (os2.platform() === "win32") {
     return;
   }
   try {
-    const resolvedPath = path.resolve(filePath);
+    const resolvedPath = path2.resolve(filePath);
     const stats = fs.statSync(resolvedPath);
     const newMode = stats.mode | 73;
     fs.chmodSync(resolvedPath, newMode);
@@ -344,21 +406,21 @@ function chmodPlusX(filePath) {
     console.error(`Failed to chmod +x ${filePath}:`, String((e == null ? void 0 : e.message) || e));
   }
 }
-async function checkIfDirExistsOrThrow(path2) {
-  if (!path2) throw "path is empty";
-  path2 = removeQuotes(path2);
-  if (!await fs.pathExists(path2)) {
-    throw new Error(`path ${path2} not exists`);
+async function checkIfDirExistsOrThrow(path3) {
+  if (!path3) throw "path is empty";
+  path3 = removeQuotes(path3);
+  if (!await fs.pathExists(path3)) {
+    throw new Error(`path ${path3} not exists`);
   }
-  if (!(await fs.stat(path2)).isDirectory()) {
-    throw new Error(`${path2} is a file, require dir`);
+  if (!(await fs.stat(path3)).isDirectory()) {
+    throw new Error(`${path3} is a file, require dir`);
   }
 }
 function createTempDir() {
-  const tmpDir = os.tmpdir();
+  const tmpDir = os2.tmpdir();
   const timestamp = Date.now();
   const tempDirName = `temp_dir_${timestamp}_${Math.random().toString(36).slice(2)}`;
-  const tempDirPath = path.join(tmpDir, tempDirName);
+  const tempDirPath = path2.join(tmpDir, tempDirName);
   console.log("tempDir", tempDirPath);
   fs.mkdirSync(tempDirPath);
   return tempDirPath;
@@ -372,7 +434,7 @@ function createTempFilePath(ext) {
     ext = void 0;
   }
   const name = `temp_file_${process.pid}_${Date.now()}_${Math.random().toString(36).slice(2)}${ext ? `.${ext}` : ""}`;
-  const fullPath = path.join(os.tmpdir(), name);
+  const fullPath = path2.join(os2.tmpdir(), name);
   return {
     getName: () => fullPath,
     cleanUp: () => {
@@ -419,12 +481,14 @@ function removeQuotes(str) {
 export {
   SSEClient,
   SSEResponse,
+  VERSION,
   checkCommandExistsOrThrow,
   checkIfDirExistsOrThrow,
   checkIfFileExistsOrThrow,
   chmodPlusX,
   createTempDir,
   createTempFilePath,
+  getEnvPaths,
   isWindows,
   throwIfDirNotEmpty,
   typedSystemArch

package/lib/trpc-helpers.cjs

@@ -46,12 +46,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/trpc-helpers.ts
 var trpc_helpers_exports = {};
 __export(trpc_helpers_exports, {
-  TrpcServerHelpers: () => TrpcServerHelpers
+  TrpcServerHelpers: () => TrpcServerHelpers,
+  VERSION: () => VERSION
 });
 module.exports = __toCommonJS(trpc_helpers_exports);
 var import_server = require("@trpc/server");
 var trpcExpress = __toESM(require("@trpc/server/adapters/express"), 1);
 var import_superjson = __toESM(require("superjson"), 1);
+
+// src/index.ts
+var VERSION = "1";
+
+// src/trpc-helpers.ts
 var TrpcServerHelpers = class {
   static createExpressTrpcServer() {
     if (globalThis.Headers == void 0) {

package/lib/trpc-helpers.d.cts

@@ -1,6 +1,7 @@
 import { initTRPC } from '@trpc/server';
 import * as trpcExpress from '@trpc/server/adapters/express';
 import { Handler } from 'express';
+export { VERSION } from './index.cjs';
 
 type TrpcExpressRootType = ReturnType<ReturnType<typeof initTRPC.context<trpcExpress.CreateExpressContextOptions>>['create']>;
 declare class TrpcServerHelpers {

package/lib/trpc-helpers.d.ts

@@ -1,6 +1,7 @@
 import { initTRPC } from '@trpc/server';
 import * as trpcExpress from '@trpc/server/adapters/express';
 import { Handler } from 'express';
+export { VERSION } from './index.js';
 
 type TrpcExpressRootType = ReturnType<ReturnType<typeof initTRPC.context<trpcExpress.CreateExpressContextOptions>>['create']>;
 declare class TrpcServerHelpers {

package/lib/trpc-helpers.js

@@ -22,6 +22,11 @@ var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 import { initTRPC } from "@trpc/server";
 import * as trpcExpress from "@trpc/server/adapters/express";
 import superjson from "superjson";
+
+// src/index.ts
+var VERSION = "1";
+
+// src/trpc-helpers.ts
 var TrpcServerHelpers = class {
   static createExpressTrpcServer() {
     if (globalThis.Headers == void 0) {
@@ -39,5 +44,6 @@ var TrpcServerHelpers = class {
   }
 };
 export {
-  TrpcServerHelpers
+  TrpcServerHelpers,
+  VERSION
 };

package/package.json

@@ -1,48 +1,67 @@
 {
   "name": "@rg-dev/stdlib",
-  "version": "1.0.52",
+  "version": "1.0.54",
   "description": "",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "tsup && node after-build.mjs",
-    "ts":"tsdown"
+    "ts": "tsdown"
   },
   "author": "",
   "license": "ISC",
   "files": [
     "lib"
   ],
-
+  "typesVersions": {
+    "*": {
+      "lib/trpc-helpers": [
+        "lib/trpc-helpers.d.ts"
+      ],
+      "lib/common-env": [
+        "lib/common-env.d.ts"
+      ],
+      "lib/browser-env": [
+        "lib/browser-env.d.ts"
+      ],
+      "lib/node-env": [
+        "lib/node-env.d.ts"
+      ],
+      "lib/node-download": [
+        "lib/node-download.d.ts"
+      ]
+    }
+  },
   "types": "./lib/index.d.ts",
   "type": "module",
   "exports": {
-
-    ".":{
+    ".": {
       "import": "./lib/index.js",
-      "require": "./lib/index.cjs"
+      "require": "./lib/index.cjs",
+      "types": "./lib/index.d.ts"
     },
-
-
     "./lib/trpc-helpers": {
       "import": "./lib/trpc-helpers.js",
-      "require": "./lib/trpc-helpers.cjs"
+      "require": "./lib/trpc-helpers.cjs",
+      "types": "./lib/trpc-helpers.d.ts"
     },
     "./lib/node-env": {
       "import": "./lib/node-env.js",
-      "require": "./lib/node-env.cjs"
+      "require": "./lib/node-env.cjs",
+      "types": "./lib/node-env.d.ts"
     },
     "./lib/browser-env": {
-      "import": "./lib/browser-env.js"
+      "import": "./lib/browser-env.js",
+      "types": "./lib/browser-env.d.ts"
     },
     "./lib/common-env": {
       "import": "./lib/common-env.js",
-      "require": "./lib/common-env.cjs"
-  
+      "require": "./lib/common-env.cjs",
+      "types": "./lib/common-env.d.ts"
     },
     "./lib/node-download": {
       "import": "./lib/node-download.js",
-      "require": "./lib/node-download.cjs"
-
+      "require": "./lib/node-download.cjs",
+      "types": "./lib/node-download.d.ts"
     }
   },
   "dependencies": {
@@ -52,7 +71,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "tsdown": "^0.19.0",
+    "env-paths": "^3.0.0",
     "@trpc/server": "^11.1.1",
     "@types/command-exists": "^1.2.3",
     "@types/express": "^5.0.6",
@@ -63,6 +82,7 @@
     "express": "^5.1.0",
     "node-fetch": "^3.3.2",
     "superjson": "^2.2.6",
+    "tsdown": "^0.19.0",
     "tsup": "^8.0.1",
     "typescript": "^5.9.3"
   }