@resq-sw/helpers 0.1.0

package/lib/parse-code-path.js

@@ -0,0 +1,160 @@
+//#region src/parse-code-path.ts
+/**
+* Copyright 2026 ResQ
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/**
+* Parses and constructs a formatted string representing the code location, including the file path,
+* associated entity name (such as a function, class, component, or decorator), and human context.
+*
+* The result is useful for debugging, developer logging, and traceability—matching the entity (function, class, etc.)
+* and the context in source code references.
+*
+* @template C The type of the context value.
+* @template T The type of the entity parameter.
+* @param {C} context - A description, situation, or custom value relevant to this code path.
+* @param {T} entity - The entity whose name is included; may be a function, class, object, component, decorator, or their name.
+* @returns {string} A formatted string: "location: <path> @<entity>: <context>".
+* @throws {Error} This function does not throw directly, but see {@link getFilePath}, which may throw in rare stack-trace parsing errors.
+* @example
+* // Function usage
+* function myFunction() {}
+* parseCodePath('initialization', myFunction);
+* // => "location: /current/dir/file.js @myFunction: initialization"
+*
+* // Class usage
+* class MyClass {}
+* parseCodePath('instantiating MyClass', MyClass);
+* // => "location: ... @MyClass: instantiating MyClass"
+*
+* // String as entity
+* parseCodePath('some context', 'EntityAsString');
+* // => "location: ... @EntityAsString: some context"
+*
+
+* @see parseCodePathDetailed
+
+* @readonly
+* @public
+* @version 1.0.0
+*/
+const parseCodePath = (context, entity) => {
+	const entityName = extractEntityName(entity);
+	return `location: ${getFilePath()} @${entityName}: ${context}`;
+};
+/**
+* Extracts a standardized name from an entity, supporting functions, classes, instances, symbols, and strings.
+*
+* - For functions or classes, returns the function's/class's `name` or 'AnonymousFunction'
+* - For instances, extracts the class/constructor name
+* - For string entities, returns the string itself
+* - For symbols, returns their string representation
+* - Returns 'UnknownEntity' if no name is found
+*
+* @template T The type of the entity.
+* @param {T} entity - The entity to extract a name from.
+* @returns {string} The extracted name or 'UnknownEntity' if not determinable.
+* @example
+* extractEntityName(function test() {}); // 'test'
+* extractEntityName(class MyClass {}); // 'MyClass'
+* extractEntityName('ManualName'); // 'ManualName'
+* extractEntityName(Symbol('sym')); // 'Symbol(sym)'
+*
+
+* @readonly
+* @public
+* @version 1.0.0
+*/
+function extractEntityName(entity) {
+	if (typeof entity === "function") return entity.name || "AnonymousFunction";
+	if (typeof entity === "object" && entity !== null) {
+		const entityConstructor = entity.constructor;
+		if (typeof entityConstructor === "function" && entityConstructor.name) return entityConstructor.name;
+	}
+	if (typeof entity === "string") return entity;
+	if (typeof entity === "symbol") return entity.toString();
+	return "UnknownEntity";
+}
+/**
+* Attempts to determine the current file path in both Node.js and browser-like environments.
+* Utilizes `__filename` if available (Node), or parses the call stack when not.
+* Falls back to process.cwd() or 'unknown-location' if all else fails.
+*
+* @returns {string} The current file path, URL, or 'unknown-location'.
+* @throws {Error} Throws if unexpected errors occur in stack trace parsing (caught internally, returns 'unknown-location').
+* @example
+* getFilePath(); // "/Users/user/project/src/utils/formatting/parse-code-path.js"
+*
+
+* @web
+* @readonly
+* @private
+* @version 1.0.0
+*/
+function getFilePath() {
+	try {
+		if (typeof __filename !== "undefined") return __filename;
+		const stack = (/* @__PURE__ */ new Error("Stack trace for file path extraction")).stack;
+		if (stack) {
+			const stackLine = stack.split("\n")[2];
+			if (stackLine) {
+				const match = /https?:\/\/[^)]+/.exec(stackLine) || /file:\/\/[^)]+/.exec(stackLine) || /at\s+(.+):\d+:\d+/.exec(stackLine);
+				if (match) return match[1] || match[0];
+			}
+		}
+		return process?.cwd?.() || "unknown-location";
+	} catch {
+		return "unknown-location";
+	}
+}
+/**
+* Parses and constructs a detailed formatted location string, including file path, entity, and context,
+* with optional line number, ISO timestamp, and custom prefix control. Useful for enhanced debugging or audit logs.
+*
+* @template C The type of the context parameter.
+* @template T The type of entity (function, class, etc.).
+* @param {C} context - Context description of the operation or location.
+* @param {T} entity - The entity whose name is included.
+* @param {object} [options] - Optional configuration for output.
+* @param {boolean} [options.includeLineNumber] - If true, appends the call site line number.
+* @param {boolean} [options.includeTimestamp] - If true, appends an ISO 8601 timestamp.
+* @param {string}  [options.customPrefix] - Custom prefix instead of default "location".
+* @returns {string} Detailed formatted location string.
+* @throws {Error} Does not throw directly but relies on internal getFilePath logic.
+* @example
+* parseCodePathDetailed('init', MyClass, {includeLineNumber: true, includeTimestamp: true});
+* // => "location: ...:42 [2024-06-01T08:00:00.000Z] @MyClass: init"
+*
+
+* @see parseCodePath
+
+* @readonly
+* @public
+* @version 1.0.0
+*/
+const parseCodePathDetailed = (context, entity, options = {}) => {
+	const entityName = extractEntityName(entity);
+	const filePath = getFilePath();
+	let locationInfo = `${options.customPrefix || "location"}: ${filePath}`;
+	if (options.includeLineNumber) try {
+		const lineMatch = ((/* @__PURE__ */ new Error("Stack trace for line number extraction")).stack?.split("\n")[2])?.match(/:(\d+):\d+/);
+		if (lineMatch) locationInfo += `:${lineMatch[1]}`;
+	} catch {}
+	if (options.includeTimestamp) locationInfo += ` [${(/* @__PURE__ */ new Date()).toISOString()}]`;
+	return `${locationInfo} @${entityName}: ${context}`;
+};
+//#endregion
+export { parseCodePath, parseCodePathDetailed };
+
+//# sourceMappingURL=parse-code-path.js.map

package/lib/parse-code-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-code-path.js","names":[],"sources":["../src/parse-code-path.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Parses and constructs a formatted string representing the code location, including the file path,\n * associated entity name (such as a function, class, component, or decorator), and human context.\n *\n * The result is useful for debugging, developer logging, and traceability—matching the entity (function, class, etc.)\n * and the context in source code references.\n *\n * @template C The type of the context value.\n * @template T The type of the entity parameter.\n * @param {C} context - A description, situation, or custom value relevant to this code path.\n * @param {T} entity - The entity whose name is included; may be a function, class, object, component, decorator, or their name.\n * @returns {string} A formatted string: \"location: <path> @<entity>: <context>\".\n * @throws {Error} This function does not throw directly, but see {@link getFilePath}, which may throw in rare stack-trace parsing errors.\n * @example\n * // Function usage\n * function myFunction() {}\n * parseCodePath('initialization', myFunction);\n * // => \"location: /current/dir/file.js @myFunction: initialization\"\n *\n * // Class usage\n * class MyClass {}\n * parseCodePath('instantiating MyClass', MyClass);\n * // => \"location: ... @MyClass: instantiating MyClass\"\n *\n * // String as entity\n * parseCodePath('some context', 'EntityAsString');\n * // => \"location: ... @EntityAsString: some context\"\n *\n\n * @see parseCodePathDetailed\n\n * @readonly\n * @public\n * @version 1.0.0\n */\nexport const parseCodePath = <C, T>(context: C, entity: T): string => {\n  const entityName = extractEntityName(entity);\n  const filePath = getFilePath();\n\n  return `location: ${filePath} @${entityName}: ${context}`;\n};\n\n/**\n * Extracts a standardized name from an entity, supporting functions, classes, instances, symbols, and strings.\n *\n * - For functions or classes, returns the function's/class's `name` or 'AnonymousFunction'\n * - For instances, extracts the class/constructor name\n * - For string entities, returns the string itself\n * - For symbols, returns their string representation\n * - Returns 'UnknownEntity' if no name is found\n *\n * @template T The type of the entity.\n * @param {T} entity - The entity to extract a name from.\n * @returns {string} The extracted name or 'UnknownEntity' if not determinable.\n * @example\n * extractEntityName(function test() {}); // 'test'\n * extractEntityName(class MyClass {}); // 'MyClass'\n * extractEntityName('ManualName'); // 'ManualName'\n * extractEntityName(Symbol('sym')); // 'Symbol(sym)'\n *\n\n * @readonly\n * @public\n * @version 1.0.0\n */\nfunction extractEntityName<T>(entity: T): string {\n  if (typeof entity === 'function') {\n    return entity.name || 'AnonymousFunction';\n  }\n  if (typeof entity === 'object' && entity !== null) {\n    const entityConstructor = entity.constructor;\n    if (typeof entityConstructor === 'function' && entityConstructor.name) {\n      return entityConstructor.name;\n    }\n  }\n  if (typeof entity === 'string') {\n    return entity;\n  }\n  if (typeof entity === 'symbol') {\n    return entity.toString();\n  }\n  return 'UnknownEntity';\n}\n\n/**\n * Attempts to determine the current file path in both Node.js and browser-like environments.\n * Utilizes `__filename` if available (Node), or parses the call stack when not.\n * Falls back to process.cwd() or 'unknown-location' if all else fails.\n *\n * @returns {string} The current file path, URL, or 'unknown-location'.\n * @throws {Error} Throws if unexpected errors occur in stack trace parsing (caught internally, returns 'unknown-location').\n * @example\n * getFilePath(); // \"/Users/user/project/src/utils/formatting/parse-code-path.js\"\n *\n\n * @web\n * @readonly\n * @private\n * @version 1.0.0\n */\nfunction getFilePath(): string {\n  try {\n    if (typeof __filename !== 'undefined') {\n      return __filename;\n    }\n    const stack = new Error('Stack trace for file path extraction').stack;\n    if (stack) {\n      const stackLine = stack.split('\\n')[2]; // Get caller's line\n      if (stackLine) {\n        const match =\n          /https?:\\/\\/[^)]+/.exec(stackLine) ||\n          /file:\\/\\/[^)]+/.exec(stackLine) ||\n          /at\\s+(.+):\\d+:\\d+/.exec(stackLine);\n        if (match) {\n          return match[1] || match[0];\n        }\n      }\n    }\n    return process?.cwd?.() || 'unknown-location';\n  } catch {\n    return 'unknown-location';\n  }\n}\n\n/**\n * Parses and constructs a detailed formatted location string, including file path, entity, and context,\n * with optional line number, ISO timestamp, and custom prefix control. Useful for enhanced debugging or audit logs.\n *\n * @template C The type of the context parameter.\n * @template T The type of entity (function, class, etc.).\n * @param {C} context - Context description of the operation or location.\n * @param {T} entity - The entity whose name is included.\n * @param {object} [options] - Optional configuration for output.\n * @param {boolean} [options.includeLineNumber] - If true, appends the call site line number.\n * @param {boolean} [options.includeTimestamp] - If true, appends an ISO 8601 timestamp.\n * @param {string}  [options.customPrefix] - Custom prefix instead of default \"location\".\n * @returns {string} Detailed formatted location string.\n * @throws {Error} Does not throw directly but relies on internal getFilePath logic.\n * @example\n * parseCodePathDetailed('init', MyClass, {includeLineNumber: true, includeTimestamp: true});\n * // => \"location: ...:42 [2024-06-01T08:00:00.000Z] @MyClass: init\"\n *\n\n * @see parseCodePath\n\n * @readonly\n * @public\n * @version 1.0.0\n */\nexport const parseCodePathDetailed = <C, T>(\n  context: C,\n  entity: T,\n  options: {\n    includeLineNumber?: boolean;\n    includeTimestamp?: boolean;\n    customPrefix?: string;\n  } = {},\n): string => {\n  const entityName = extractEntityName(entity);\n  const filePath = getFilePath();\n  const prefix = options.customPrefix || 'location';\n\n  let locationInfo = `${prefix}: ${filePath}`;\n\n  if (options.includeLineNumber) {\n    try {\n      const stack = new Error('Stack trace for line number extraction').stack;\n      const callerLine = stack?.split('\\n')[2];\n      const lineMatch = callerLine?.match(/:(\\d+):\\d+/);\n      if (lineMatch) {\n        locationInfo += `:${lineMatch[1]}`;\n      }\n    } catch {\n      // Ignore errors in line number extraction\n    }\n  }\n\n  if (options.includeTimestamp) {\n    locationInfo += ` [${new Date().toISOString()}]`;\n  }\n\n  return `${locationInfo} @${entityName}: ${context}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,iBAAuB,SAAY,WAAsB;CACpE,MAAM,aAAa,kBAAkB,OAAO;AAG5C,QAAO,aAFU,aAAa,CAED,IAAI,WAAW,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;AA0BlD,SAAS,kBAAqB,QAAmB;AAC/C,KAAI,OAAO,WAAW,WACpB,QAAO,OAAO,QAAQ;AAExB,KAAI,OAAO,WAAW,YAAY,WAAW,MAAM;EACjD,MAAM,oBAAoB,OAAO;AACjC,MAAI,OAAO,sBAAsB,cAAc,kBAAkB,KAC/D,QAAO,kBAAkB;;AAG7B,KAAI,OAAO,WAAW,SACpB,QAAO;AAET,KAAI,OAAO,WAAW,SACpB,QAAO,OAAO,UAAU;AAE1B,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAS,cAAsB;AAC7B,KAAI;AACF,MAAI,OAAO,eAAe,YACxB,QAAO;EAET,MAAM,yBAAQ,IAAI,MAAM,uCAAuC,EAAC;AAChE,MAAI,OAAO;GACT,MAAM,YAAY,MAAM,MAAM,KAAK,CAAC;AACpC,OAAI,WAAW;IACb,MAAM,QACJ,mBAAmB,KAAK,UAAU,IAClC,iBAAiB,KAAK,UAAU,IAChC,oBAAoB,KAAK,UAAU;AACrC,QAAI,MACF,QAAO,MAAM,MAAM,MAAM;;;AAI/B,SAAO,SAAS,OAAO,IAAI;SACrB;AACN,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BX,MAAa,yBACX,SACA,QACA,UAII,EAAE,KACK;CACX,MAAM,aAAa,kBAAkB,OAAO;CAC5C,MAAM,WAAW,aAAa;CAG9B,IAAI,eAAe,GAFJ,QAAQ,gBAAgB,WAEV,IAAI;AAEjC,KAAI,QAAQ,kBACV,KAAI;EAGF,MAAM,8BAFQ,IAAI,MAAM,yCAAyC,EAAC,OACxC,MAAM,KAAK,CAAC,KACR,MAAM,aAAa;AACjD,MAAI,UACF,iBAAgB,IAAI,UAAU;SAE1B;AAKV,KAAI,QAAQ,iBACV,iBAAgB,sBAAK,IAAI,MAAM,EAAC,aAAa,CAAC;AAGhD,QAAO,GAAG,aAAa,IAAI,WAAW,IAAI"}

package/lib/task-exec.d.ts

@@ -0,0 +1,26 @@
+//#region src/task-exec.d.ts
+/**
+ * Copyright 2026 ResQ
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare class TaskExec {
+  private readonly tasks;
+  private handler;
+  exec(func: (...args: unknown[]) => unknown, ttl: number): void;
+  private handleNext;
+  private execNext;
+}
+//#endregion
+export { TaskExec };
+//# sourceMappingURL=task-exec.d.ts.map

package/lib/task-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-exec.d.ts","names":[],"sources":["../src/task-exec.ts"],"mappings":";;AAmBA;;;;;;;;;;;;;;cAAa,QAAA;EAAA,iBACM,KAAA;EAAA,QAGT,OAAA;EAER,IAAA,CAAK,IAAA,MAAU,IAAA,yBAA6B,GAAA;EAAA,QAKpC,UAAA;EAAA,QASA,QAAA;AAAA"}

package/lib/task-exec.js

@@ -0,0 +1,45 @@
+import TinyQueue from "tinyqueue";
+//#region src/task-exec.ts
+/**
+* Copyright 2026 ResQ
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*     http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+var TaskExec = class {
+	tasks = new TinyQueue([], (a, b) => a.execTime - b.execTime);
+	handler;
+	exec(func, ttl) {
+		this.tasks.push({
+			func,
+			execTime: Date.now() + ttl
+		});
+		this.handleNext();
+	}
+	handleNext() {
+		if (!this.tasks.length) return;
+		const { execTime } = this.tasks.peek();
+		this.execNext(Math.max(execTime - Date.now(), 0));
+	}
+	execNext(ttl) {
+		clearTimeout(this.handler);
+		this.handler = setTimeout(() => {
+			const { func } = this.tasks.pop();
+			func();
+			this.handleNext();
+		}, ttl);
+	}
+};
+//#endregion
+export { TaskExec };
+
+//# sourceMappingURL=task-exec.js.map

package/lib/task-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-exec.js","names":[],"sources":["../src/task-exec.ts"],"sourcesContent":["/**\n * Copyright 2026 ResQ\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport TinyQueue from 'tinyqueue';\nimport type { TimedTask } from './task-exec.types.js';\n\nexport class TaskExec {\n  private readonly tasks = new TinyQueue<TimedTask>([], (a, b) => a.execTime - b.execTime);\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private handler: ReturnType<typeof setTimeout> | undefined;\n\n  exec(func: (...args: unknown[]) => unknown, ttl: number): void {\n    this.tasks.push({ func, execTime: Date.now() + ttl });\n    this.handleNext();\n  }\n\n  private handleNext(): void {\n    if (!this.tasks.length) {\n      return;\n    }\n\n    const { execTime } = this.tasks.peek()!;\n    this.execNext(Math.max(execTime - Date.now(), 0));\n  }\n\n  private execNext(ttl: number): void {\n    clearTimeout(this.handler);\n    this.handler = setTimeout(() => {\n      const { func } = this.tasks.pop()!;\n      func();\n      this.handleNext();\n    }, ttl);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,IAAa,WAAb,MAAsB;CACpB,QAAyB,IAAI,UAAqB,EAAE,GAAG,GAAG,MAAM,EAAE,WAAW,EAAE,SAAS;CAGxF;CAEA,KAAK,MAAuC,KAAmB;AAC7D,OAAK,MAAM,KAAK;GAAE;GAAM,UAAU,KAAK,KAAK,GAAG;GAAK,CAAC;AACrD,OAAK,YAAY;;CAGnB,aAA2B;AACzB,MAAI,CAAC,KAAK,MAAM,OACd;EAGF,MAAM,EAAE,aAAa,KAAK,MAAM,MAAM;AACtC,OAAK,SAAS,KAAK,IAAI,WAAW,KAAK,KAAK,EAAE,EAAE,CAAC;;CAGnD,SAAiB,KAAmB;AAClC,eAAa,KAAK,QAAQ;AAC1B,OAAK,UAAU,iBAAiB;GAC9B,MAAM,EAAE,SAAS,KAAK,MAAM,KAAK;AACjC,SAAM;AACN,QAAK,YAAY;KAChB,IAAI"}

package/lib/task-exec.types.d.ts

@@ -0,0 +1,23 @@
+//#region src/task-exec.types.d.ts
+/**
+ * Copyright 2026 ResQ
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+type TimedTask = {
+  func: (...args: unknown[]) => unknown;
+  execTime: number;
+};
+//#endregion
+export { TimedTask };
+//# sourceMappingURL=task-exec.types.d.ts.map

package/lib/task-exec.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-exec.types.d.ts","names":[],"sources":["../src/task-exec.types.ts"],"mappings":";;AAgBA;;;;;;;;;;;;;;KAAY,SAAA;EACV,IAAA,MAAU,IAAA;EACV,QAAA;AAAA"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@resq-sw/helpers",
+  "version": "0.1.0",
+  "description": "Functional utilities, type guards, result types, performance measurement, and async task execution",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "default": "./lib/index.js"
+    },
+    "./formatting": {
+      "types": "./lib/formatting/index.d.ts",
+      "import": "./lib/formatting/index.js",
+      "default": "./lib/formatting/index.js"
+    },
+    "./browser": {
+      "types": "./lib/browser/index.d.ts",
+      "import": "./lib/browser/index.js",
+      "default": "./lib/browser/index.js"
+    }
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": ["lib", "README.md"],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@resq-sw/logger": "workspace:*",
+    "tinyqueue": "^3.0.0"
+  },
+  "devDependencies": {
+    "jsdom": "^29.0.2",
+    "tsdown": "^0.21.7",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/resq-software/npm.git",
+    "directory": "packages/helpers"
+  },
+  "keywords": ["helpers", "utilities", "result-type", "type-guards", "task-queue"],
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}