@stryke/helpers 0.9.35 → 0.9.36

package/dist/memoize.mjs

@@ -1,2 +1,20 @@
-const e=e=>{let t=Object.prototype.hasOwnProperty,n={};return r=>t.call(n,r)?n[r]:n[r]=e(r)};export{e as memoizeOnId};
+//#region src/memoize.ts
+/**
+* Memoizes a function based on its string identifier.
+*
+* @param fn - The function to memoize.
+* @returns A memoized version of the input function.
+*/
+const memoizeOnId = (fn) => {
+	const hasOwnProperty = Object.prototype.hasOwnProperty;
+	const results = {};
+	const memoizedFn = (id) => {
+		if (hasOwnProperty.call(results, id)) return results[id];
+		return results[id] = fn(id);
+	};
+	return memoizedFn;
+};
+
+//#endregion
+export { memoizeOnId };
 //# sourceMappingURL=memoize.mjs.map

package/dist/memoize.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"memoize.mjs","names":["results: Record<string, T>"],"sources":["../src/memoize.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Memoizes a function based on its string identifier.\n *\n * @param fn - The function to memoize.\n * @returns A memoized version of the input function.\n */\nexport const memoizeOnId = <T>(fn: (id: string) => T) => {\n  // eslint-disable-next-line ts/unbound-method\n  const hasOwnProperty = Object.prototype.hasOwnProperty;\n  const results: Record<string, T> = {};\n\n  const memoizedFn = (id: string) => {\n    if (hasOwnProperty.call(results, id)) {\n      return results[id];\n    }\n    return (results[id] = fn(id));\n  };\n\n  return memoizedFn;\n};\n"],"mappings":"AAwBA,MAAa,EAAkB,GAA0B,CAEvD,IAAM,EAAiB,OAAO,UAAU,eAClCA,EAA6B,EAAE,CASrC,MAPoB,IACd,EAAe,KAAK,EAAS,EAAG,CAC3B,EAAQ,GAET,EAAQ,GAAM,EAAG,EAAG"}
+{"version":3,"file":"memoize.mjs","names":["results: Record<string, T>"],"sources":["../src/memoize.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Memoizes a function based on its string identifier.\n *\n * @param fn - The function to memoize.\n * @returns A memoized version of the input function.\n */\nexport const memoizeOnId = <T>(fn: (id: string) => T) => {\n  // eslint-disable-next-line ts/unbound-method\n  const hasOwnProperty = Object.prototype.hasOwnProperty;\n  const results: Record<string, T> = {};\n\n  const memoizedFn = (id: string) => {\n    if (hasOwnProperty.call(results, id)) {\n      return results[id];\n    }\n    return (results[id] = fn(id));\n  };\n\n  return memoizedFn;\n};\n"],"mappings":";;;;;;;AAwBA,MAAa,eAAkB,OAA0B;CAEvD,MAAM,iBAAiB,OAAO,UAAU;CACxC,MAAMA,UAA6B,EAAE;CAErC,MAAM,cAAc,OAAe;AACjC,MAAI,eAAe,KAAK,SAAS,GAAG,CAClC,QAAO,QAAQ;AAEjB,SAAQ,QAAQ,MAAM,GAAG,GAAG;;AAG9B,QAAO"}

package/dist/mutex.cjs

@@ -1 +1,80 @@
-const e=require(`./semaphore.cjs`);var t=class{semaphore=new e.Semaphore(1);get isLocked(){return this.semaphore.available===0}async acquire(){return this.semaphore.acquire()}release(){this.semaphore.release()}};exports.Mutex=t;
+const require_semaphore = require('./semaphore.cjs');
+
+//#region src/mutex.ts
+/**
+* A Mutex (mutual exclusion lock) for async functions.
+* It allows only one async task to access a critical section at a time.
+*
+* @example
+* ```typescript
+* const mutex = new Mutex();
+*
+* async function criticalSection() {
+*   await mutex.acquire();
+*   try {
+*     // This code section cannot be executed simultaneously
+*   } finally {
+*     mutex.release();
+*   }
+* }
+*
+* criticalSection();
+* criticalSection(); // This call will wait until the first call releases the mutex.
+* ```
+*/
+var Mutex = class {
+	semaphore = new require_semaphore.Semaphore(1);
+	/**
+	* Checks if the mutex is currently locked.
+	* @returns True if the mutex is locked, false otherwise.
+	*
+	* @example
+	* const mutex = new Mutex();
+	* console.log(mutex.isLocked); // false
+	* await mutex.acquire();
+	* console.log(mutex.isLocked); // true
+	* mutex.release();
+	* console.log(mutex.isLocked); // false
+	*/
+	get isLocked() {
+		return this.semaphore.available === 0;
+	}
+	/**
+	* Acquires the mutex, blocking if necessary until it is available.
+	* @returns A promise that resolves when the mutex is acquired.
+	*
+	* @example
+	* ```typescript
+	* const mutex = new Mutex();
+	* await mutex.acquire();
+	* try {
+	*   // This code section cannot be executed simultaneously
+	* } finally {
+	*   mutex.release();
+	* }
+	* ```
+	*/
+	async acquire() {
+		return this.semaphore.acquire();
+	}
+	/**
+	* Releases the mutex, allowing another waiting task to proceed.
+	*
+	* @example
+	* ```typescript
+	* const mutex = new Mutex();
+	* await mutex.acquire();
+	* try {
+	*   // This code section cannot be executed simultaneously
+	* } finally {
+	*   mutex.release(); // Allows another waiting task to proceed.
+	* }
+	* ```
+	*/
+	release() {
+		this.semaphore.release();
+	}
+};
+
+//#endregion
+exports.Mutex = Mutex;

package/dist/mutex.mjs

@@ -1,2 +1,81 @@
-import{Semaphore as e}from"./semaphore.mjs";var t=class{semaphore=new e(1);get isLocked(){return this.semaphore.available===0}async acquire(){return this.semaphore.acquire()}release(){this.semaphore.release()}};export{t as Mutex};
+import { Semaphore } from "./semaphore.mjs";
+
+//#region src/mutex.ts
+/**
+* A Mutex (mutual exclusion lock) for async functions.
+* It allows only one async task to access a critical section at a time.
+*
+* @example
+* ```typescript
+* const mutex = new Mutex();
+*
+* async function criticalSection() {
+*   await mutex.acquire();
+*   try {
+*     // This code section cannot be executed simultaneously
+*   } finally {
+*     mutex.release();
+*   }
+* }
+*
+* criticalSection();
+* criticalSection(); // This call will wait until the first call releases the mutex.
+* ```
+*/
+var Mutex = class {
+	semaphore = new Semaphore(1);
+	/**
+	* Checks if the mutex is currently locked.
+	* @returns True if the mutex is locked, false otherwise.
+	*
+	* @example
+	* const mutex = new Mutex();
+	* console.log(mutex.isLocked); // false
+	* await mutex.acquire();
+	* console.log(mutex.isLocked); // true
+	* mutex.release();
+	* console.log(mutex.isLocked); // false
+	*/
+	get isLocked() {
+		return this.semaphore.available === 0;
+	}
+	/**
+	* Acquires the mutex, blocking if necessary until it is available.
+	* @returns A promise that resolves when the mutex is acquired.
+	*
+	* @example
+	* ```typescript
+	* const mutex = new Mutex();
+	* await mutex.acquire();
+	* try {
+	*   // This code section cannot be executed simultaneously
+	* } finally {
+	*   mutex.release();
+	* }
+	* ```
+	*/
+	async acquire() {
+		return this.semaphore.acquire();
+	}
+	/**
+	* Releases the mutex, allowing another waiting task to proceed.
+	*
+	* @example
+	* ```typescript
+	* const mutex = new Mutex();
+	* await mutex.acquire();
+	* try {
+	*   // This code section cannot be executed simultaneously
+	* } finally {
+	*   mutex.release(); // Allows another waiting task to proceed.
+	* }
+	* ```
+	*/
+	release() {
+		this.semaphore.release();
+	}
+};
+
+//#endregion
+export { Mutex };
 //# sourceMappingURL=mutex.mjs.map

package/dist/mutex.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mutex.mjs","names":[],"sources":["../src/mutex.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Semaphore } from \"./semaphore\";\n\n/**\n * A Mutex (mutual exclusion lock) for async functions.\n * It allows only one async task to access a critical section at a time.\n *\n * @example\n * ```typescript\n * const mutex = new Mutex();\n *\n * async function criticalSection() {\n *   await mutex.acquire();\n *   try {\n *     // This code section cannot be executed simultaneously\n *   } finally {\n *     mutex.release();\n *   }\n * }\n *\n * criticalSection();\n * criticalSection(); // This call will wait until the first call releases the mutex.\n * ```\n */\nexport class Mutex {\n  private semaphore = new Semaphore(1);\n\n  /**\n   * Checks if the mutex is currently locked.\n   * @returns True if the mutex is locked, false otherwise.\n   *\n   * @example\n   * const mutex = new Mutex();\n   * console.log(mutex.isLocked); // false\n   * await mutex.acquire();\n   * console.log(mutex.isLocked); // true\n   * mutex.release();\n   * console.log(mutex.isLocked); // false\n   */\n  public get isLocked(): boolean {\n    return this.semaphore.available === 0;\n  }\n\n  /**\n   * Acquires the mutex, blocking if necessary until it is available.\n   * @returns A promise that resolves when the mutex is acquired.\n   *\n   * @example\n   * ```typescript\n   * const mutex = new Mutex();\n   * await mutex.acquire();\n   * try {\n   *   // This code section cannot be executed simultaneously\n   * } finally {\n   *   mutex.release();\n   * }\n   * ```\n   */\n  public async acquire(): Promise<void> {\n    return this.semaphore.acquire();\n  }\n\n  /**\n   * Releases the mutex, allowing another waiting task to proceed.\n   *\n   * @example\n   * ```typescript\n   * const mutex = new Mutex();\n   * await mutex.acquire();\n   * try {\n   *   // This code section cannot be executed simultaneously\n   * } finally {\n   *   mutex.release(); // Allows another waiting task to proceed.\n   * }\n   * ```\n   */\n  public release(): void {\n    this.semaphore.release();\n  }\n}\n"],"mappings":"4CAyCA,IAAa,EAAb,KAAmB,CACjB,UAAoB,IAAI,EAAU,EAAE,CAcpC,IAAW,UAAoB,CAC7B,OAAO,KAAK,UAAU,YAAc,EAkBtC,MAAa,SAAyB,CACpC,OAAO,KAAK,UAAU,SAAS,CAiBjC,SAAuB,CACrB,KAAK,UAAU,SAAS"}
+{"version":3,"file":"mutex.mjs","names":[],"sources":["../src/mutex.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Semaphore } from \"./semaphore\";\n\n/**\n * A Mutex (mutual exclusion lock) for async functions.\n * It allows only one async task to access a critical section at a time.\n *\n * @example\n * ```typescript\n * const mutex = new Mutex();\n *\n * async function criticalSection() {\n *   await mutex.acquire();\n *   try {\n *     // This code section cannot be executed simultaneously\n *   } finally {\n *     mutex.release();\n *   }\n * }\n *\n * criticalSection();\n * criticalSection(); // This call will wait until the first call releases the mutex.\n * ```\n */\nexport class Mutex {\n  private semaphore = new Semaphore(1);\n\n  /**\n   * Checks if the mutex is currently locked.\n   * @returns True if the mutex is locked, false otherwise.\n   *\n   * @example\n   * const mutex = new Mutex();\n   * console.log(mutex.isLocked); // false\n   * await mutex.acquire();\n   * console.log(mutex.isLocked); // true\n   * mutex.release();\n   * console.log(mutex.isLocked); // false\n   */\n  public get isLocked(): boolean {\n    return this.semaphore.available === 0;\n  }\n\n  /**\n   * Acquires the mutex, blocking if necessary until it is available.\n   * @returns A promise that resolves when the mutex is acquired.\n   *\n   * @example\n   * ```typescript\n   * const mutex = new Mutex();\n   * await mutex.acquire();\n   * try {\n   *   // This code section cannot be executed simultaneously\n   * } finally {\n   *   mutex.release();\n   * }\n   * ```\n   */\n  public async acquire(): Promise<void> {\n    return this.semaphore.acquire();\n  }\n\n  /**\n   * Releases the mutex, allowing another waiting task to proceed.\n   *\n   * @example\n   * ```typescript\n   * const mutex = new Mutex();\n   * await mutex.acquire();\n   * try {\n   *   // This code section cannot be executed simultaneously\n   * } finally {\n   *   mutex.release(); // Allows another waiting task to proceed.\n   * }\n   * ```\n   */\n  public release(): void {\n    this.semaphore.release();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyCA,IAAa,QAAb,MAAmB;CACjB,AAAQ,YAAY,IAAI,UAAU,EAAE;;;;;;;;;;;;;CAcpC,IAAW,WAAoB;AAC7B,SAAO,KAAK,UAAU,cAAc;;;;;;;;;;;;;;;;;CAkBtC,MAAa,UAAyB;AACpC,SAAO,KAAK,UAAU,SAAS;;;;;;;;;;;;;;;;CAiBjC,AAAO,UAAgB;AACrB,OAAK,UAAU,SAAS"}

package/dist/noop.cjs

@@ -1 +1,24 @@
-const e=e=>{};async function t(e){}exports.asyncNoop=t,exports.noop=e;
+
+//#region src/noop.ts
+/**
+* A no op, or no-op, function for no operation
+*
+* @remarks Please see {@link https://dev.to/praneshpsg239/noop-in-javascript-478h | this article} for more information.
+*
+* @param _params - An optional parameter passed to the function. It can be anything (but is not used in any way)
+*/
+const noop = (_params) => {};
+/**
+* An asynchronous no-operation function that does nothing.
+* This can be used as a placeholder or default function.
+*
+* @example
+* asyncNoop(); // Does nothing
+*
+* @returns This function returns a Promise that resolves to undefined.
+*/
+async function asyncNoop(_params) {}
+
+//#endregion
+exports.asyncNoop = asyncNoop;
+exports.noop = noop;

package/dist/noop.mjs

@@ -1,2 +1,23 @@
-const e=e=>{};async function t(e){}export{t as asyncNoop,e as noop};
+//#region src/noop.ts
+/**
+* A no op, or no-op, function for no operation
+*
+* @remarks Please see {@link https://dev.to/praneshpsg239/noop-in-javascript-478h | this article} for more information.
+*
+* @param _params - An optional parameter passed to the function. It can be anything (but is not used in any way)
+*/
+const noop = (_params) => {};
+/**
+* An asynchronous no-operation function that does nothing.
+* This can be used as a placeholder or default function.
+*
+* @example
+* asyncNoop(); // Does nothing
+*
+* @returns This function returns a Promise that resolves to undefined.
+*/
+async function asyncNoop(_params) {}
+
+//#endregion
+export { asyncNoop, noop };
 //# sourceMappingURL=noop.mjs.map

package/dist/noop.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"noop.mjs","names":[],"sources":["../src/noop.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\n/**\n * A no op, or no-op, function for no operation\n *\n * @remarks Please see {@link https://dev.to/praneshpsg239/noop-in-javascript-478h | this article} for more information.\n *\n * @param _params - An optional parameter passed to the function. It can be anything (but is not used in any way)\n */\nexport const noop = (_params?: unknown): void => {};\n\n/**\n * An asynchronous no-operation function that does nothing.\n * This can be used as a placeholder or default function.\n *\n * @example\n * asyncNoop(); // Does nothing\n *\n * @returns This function returns a Promise that resolves to undefined.\n */\nexport async function asyncNoop(_params?: unknown): Promise<void> {}\n"],"mappings":"AAwBA,MAAa,EAAQ,GAA4B,GAWjD,eAAsB,EAAU,EAAkC"}
+{"version":3,"file":"noop.mjs","names":[],"sources":["../src/noop.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\n/**\n * A no op, or no-op, function for no operation\n *\n * @remarks Please see {@link https://dev.to/praneshpsg239/noop-in-javascript-478h | this article} for more information.\n *\n * @param _params - An optional parameter passed to the function. It can be anything (but is not used in any way)\n */\nexport const noop = (_params?: unknown): void => {};\n\n/**\n * An asynchronous no-operation function that does nothing.\n * This can be used as a placeholder or default function.\n *\n * @example\n * asyncNoop(); // Does nothing\n *\n * @returns This function returns a Promise that resolves to undefined.\n */\nexport async function asyncNoop(_params?: unknown): Promise<void> {}\n"],"mappings":";;;;;;;;AAwBA,MAAa,QAAQ,YAA4B;;;;;;;;;;AAWjD,eAAsB,UAAU,SAAkC"}

package/dist/omit.cjs

@@ -1 +1,30 @@
-function e(e,t){let n={...e};for(let e=0;e<t.length;e++){let r=t[e];r&&delete n[r]}return n}exports.omit=e;
+
+//#region src/omit.ts
+/**
+* Creates a new object with specified keys omitted.
+*
+* This function takes an object and an array of keys, and returns a new object that
+* excludes the properties corresponding to the specified keys.
+*
+* @param obj - The object to omit keys from.
+* @param keys - An array of keys to be omitted from the object.
+* @returns A new object with the specified keys omitted.
+*
+* @example
+* ```typescript
+* const obj = { a: 1, b: 2, c: 3 };
+* const result = omit(obj, ['b', 'c']);
+* // result will be { a: 1 }
+* ```
+*/
+function omit(obj, keys) {
+	const result = { ...obj };
+	for (let i = 0; i < keys.length; i++) {
+		const key = keys[i];
+		if (key) delete result[key];
+	}
+	return result;
+}
+
+//#endregion
+exports.omit = omit;

package/dist/omit.mjs

@@ -1,2 +1,30 @@
-function e(e,t){let n={...e};for(let e=0;e<t.length;e++){let r=t[e];r&&delete n[r]}return n}export{e as omit};
+//#region src/omit.ts
+/**
+* Creates a new object with specified keys omitted.
+*
+* This function takes an object and an array of keys, and returns a new object that
+* excludes the properties corresponding to the specified keys.
+*
+* @param obj - The object to omit keys from.
+* @param keys - An array of keys to be omitted from the object.
+* @returns A new object with the specified keys omitted.
+*
+* @example
+* ```typescript
+* const obj = { a: 1, b: 2, c: 3 };
+* const result = omit(obj, ['b', 'c']);
+* // result will be { a: 1 }
+* ```
+*/
+function omit(obj, keys) {
+	const result = { ...obj };
+	for (let i = 0; i < keys.length; i++) {
+		const key = keys[i];
+		if (key) delete result[key];
+	}
+	return result;
+}
+
+//#endregion
+export { omit };
 //# sourceMappingURL=omit.mjs.map

package/dist/omit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"omit.mjs","names":[],"sources":["../src/omit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                             ⚡ Storm Software \n\n This code was released as part of a Storm Software project. The project\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/license.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software\n Documentation:            https://stormsoftware.com/docs\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Creates a new object with specified keys omitted.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * excludes the properties corresponding to the specified keys.\n *\n * @param obj - The object to omit keys from.\n * @param keys - An array of keys to be omitted from the object.\n * @returns A new object with the specified keys omitted.\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = omit(obj, ['b', 'c']);\n * // result will be { a: 1 }\n * ```\n */\nexport function omit<T extends Record<string, any>, K extends keyof T>(\n  obj: T,\n  keys: readonly K[]\n): Omit<T, K> {\n  const result = { ...obj };\n\n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n    if (key) {\n      delete result[key];\n    }\n  }\n\n  return result as Omit<T, K>;\n}\n"],"mappings":"AAmCA,SAAgB,EACd,EACA,EACY,CACZ,IAAM,EAAS,CAAE,GAAG,EAAK,CAEzB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAQ,IAAK,CACpC,IAAM,EAAM,EAAK,GACb,GACF,OAAO,EAAO,GAIlB,OAAO"}
+{"version":3,"file":"omit.mjs","names":[],"sources":["../src/omit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                             ⚡ Storm Software \n\n This code was released as part of a Storm Software project. The project\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/license.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software\n Documentation:            https://stormsoftware.com/docs\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Creates a new object with specified keys omitted.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * excludes the properties corresponding to the specified keys.\n *\n * @param obj - The object to omit keys from.\n * @param keys - An array of keys to be omitted from the object.\n * @returns A new object with the specified keys omitted.\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = omit(obj, ['b', 'c']);\n * // result will be { a: 1 }\n * ```\n */\nexport function omit<T extends Record<string, any>, K extends keyof T>(\n  obj: T,\n  keys: readonly K[]\n): Omit<T, K> {\n  const result = { ...obj };\n\n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n    if (key) {\n      delete result[key];\n    }\n  }\n\n  return result as Omit<T, K>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmCA,SAAgB,KACd,KACA,MACY;CACZ,MAAM,SAAS,EAAE,GAAG,KAAK;AAEzB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;AACjB,MAAI,IACF,QAAO,OAAO;;AAIlB,QAAO"}

package/dist/once.cjs

@@ -1 +1,27 @@
-function e(e){return e}function t(t){let n,r=!1;return e(function(...e){return r||=(n=t.apply(this,e),!0),n})}exports.once=t,exports.safeFunctionCast=e;
+
+//#region src/once.ts
+/** silence "error TS2322" but practically this is safer and more convenient than resorting to `any` in a random place */
+function safeFunctionCast(fn) {
+	return fn;
+}
+/**
+* Executes a function only once.
+*
+* @param fn - The function to be executed only once.
+* @returns A function that, when called, will execute the original function only once.
+*/
+function once(fn) {
+	let result;
+	let called = false;
+	return safeFunctionCast(function(...args) {
+		if (!called) {
+			result = fn.apply(this, args);
+			called = true;
+		}
+		return result;
+	});
+}
+
+//#endregion
+exports.once = once;
+exports.safeFunctionCast = safeFunctionCast;

package/dist/once.mjs

@@ -1,2 +1,26 @@
-function e(e){return e}function t(t){let n,r=!1;return e(function(...e){return r||=(n=t.apply(this,e),!0),n})}export{t as once,e as safeFunctionCast};
+//#region src/once.ts
+/** silence "error TS2322" but practically this is safer and more convenient than resorting to `any` in a random place */
+function safeFunctionCast(fn) {
+	return fn;
+}
+/**
+* Executes a function only once.
+*
+* @param fn - The function to be executed only once.
+* @returns A function that, when called, will execute the original function only once.
+*/
+function once(fn) {
+	let result;
+	let called = false;
+	return safeFunctionCast(function(...args) {
+		if (!called) {
+			result = fn.apply(this, args);
+			called = true;
+		}
+		return result;
+	});
+}
+
+//#endregion
+export { once, safeFunctionCast };
 //# sourceMappingURL=once.mjs.map

package/dist/once.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"once.mjs","names":["result: ReturnType<TFunc>"],"sources":["../src/once.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/** silence \"error TS2322\" but practically this is safer and more convenient than resorting to `any` in a random place */\nexport function safeFunctionCast<TFunc extends (...args: any[]) => any>(\n  fn: (...args: Parameters<TFunc>) => ReturnType<TFunc>\n): TFunc {\n  // @ts-expect-error\n  //   error TS2322: Type '(...args: Parameters<F>) => ReturnType<F>' is not assignable to type 'F'.\n  //   '(...args: Parameters<F>) => ReturnType<F>' is assignable to the constraint of type 'F', but 'F' could be instantiated with a different subtype of constraint '(...args: any[]) => any'.\n  return fn;\n}\n\n/**\n * Executes a function only once.\n *\n * @param fn - The function to be executed only once.\n * @returns A function that, when called, will execute the original function only once.\n */\nexport function once<TFunc extends (...args: any[]) => any>(fn: TFunc): TFunc {\n  let result: ReturnType<TFunc>;\n  let called = false;\n\n  // eslint-disable-next-line func-names\n  return safeFunctionCast<TFunc>(function (this: unknown, ...args) {\n    if (!called) {\n      result = fn.apply(this, args);\n      called = true;\n    }\n    return result;\n  });\n}\n"],"mappings":"AAmBA,SAAgB,EACd,EACO,CAIP,OAAO,EAST,SAAgB,EAA4C,EAAkB,CAC5E,IAAIA,EACA,EAAS,GAGb,OAAO,EAAwB,SAAyB,GAAG,EAAM,CAK/D,MAJA,CAEE,KADA,EAAS,EAAG,MAAM,KAAM,EAAK,CACpB,IAEJ,GACP"}
+{"version":3,"file":"once.mjs","names":["result: ReturnType<TFunc>"],"sources":["../src/once.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/** silence \"error TS2322\" but practically this is safer and more convenient than resorting to `any` in a random place */\nexport function safeFunctionCast<TFunc extends (...args: any[]) => any>(\n  fn: (...args: Parameters<TFunc>) => ReturnType<TFunc>\n): TFunc {\n  // @ts-expect-error\n  //   error TS2322: Type '(...args: Parameters<F>) => ReturnType<F>' is not assignable to type 'F'.\n  //   '(...args: Parameters<F>) => ReturnType<F>' is assignable to the constraint of type 'F', but 'F' could be instantiated with a different subtype of constraint '(...args: any[]) => any'.\n  return fn;\n}\n\n/**\n * Executes a function only once.\n *\n * @param fn - The function to be executed only once.\n * @returns A function that, when called, will execute the original function only once.\n */\nexport function once<TFunc extends (...args: any[]) => any>(fn: TFunc): TFunc {\n  let result: ReturnType<TFunc>;\n  let called = false;\n\n  // eslint-disable-next-line func-names\n  return safeFunctionCast<TFunc>(function (this: unknown, ...args) {\n    if (!called) {\n      result = fn.apply(this, args);\n      called = true;\n    }\n    return result;\n  });\n}\n"],"mappings":";;AAmBA,SAAgB,iBACd,IACO;AAIP,QAAO;;;;;;;;AAST,SAAgB,KAA4C,IAAkB;CAC5E,IAAIA;CACJ,IAAI,SAAS;AAGb,QAAO,iBAAwB,SAAyB,GAAG,MAAM;AAC/D,MAAI,CAAC,QAAQ;AACX,YAAS,GAAG,MAAM,MAAM,KAAK;AAC7B,YAAS;;AAEX,SAAO;GACP"}

package/dist/pick.cjs

@@ -1 +1,30 @@
-function e(e,t){let n={};for(let r=0;r<t.length;r++){let i=t[r];i&&Object.hasOwn(e,i)&&(n[i]=e[i])}return n}exports.pick=e;
+
+//#region src/pick.ts
+/**
+* Creates a new object composed of the picked object properties.
+*
+* This function takes an object and an array of keys, and returns a new object that
+* includes only the properties corresponding to the specified keys.
+*
+* @param obj - The object to pick keys from.
+* @param keys - An array of keys to be picked from the object.
+* @returns A new object with the specified keys picked.
+*
+* @example
+* ```typescript
+* const obj = { a: 1, b: 2, c: 3 };
+* const result = pick(obj, ['a', 'c']);
+* // result will be { a: 1, c: 3 }
+* ```
+*/
+function pick(obj, keys) {
+	const result = {};
+	for (let i = 0; i < keys.length; i++) {
+		const key = keys[i];
+		if (key && Object.hasOwn(obj, key)) result[key] = obj[key];
+	}
+	return result;
+}
+
+//#endregion
+exports.pick = pick;

package/dist/pick.mjs

@@ -1,2 +1,30 @@
-function e(e,t){let n={};for(let r=0;r<t.length;r++){let i=t[r];i&&Object.hasOwn(e,i)&&(n[i]=e[i])}return n}export{e as pick};
+//#region src/pick.ts
+/**
+* Creates a new object composed of the picked object properties.
+*
+* This function takes an object and an array of keys, and returns a new object that
+* includes only the properties corresponding to the specified keys.
+*
+* @param obj - The object to pick keys from.
+* @param keys - An array of keys to be picked from the object.
+* @returns A new object with the specified keys picked.
+*
+* @example
+* ```typescript
+* const obj = { a: 1, b: 2, c: 3 };
+* const result = pick(obj, ['a', 'c']);
+* // result will be { a: 1, c: 3 }
+* ```
+*/
+function pick(obj, keys) {
+	const result = {};
+	for (let i = 0; i < keys.length; i++) {
+		const key = keys[i];
+		if (key && Object.hasOwn(obj, key)) result[key] = obj[key];
+	}
+	return result;
+}
+
+//#endregion
+export { pick };
 //# sourceMappingURL=pick.mjs.map

package/dist/pick.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pick.mjs","names":[],"sources":["../src/pick.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                             ⚡ Storm Software \n\n This code was released as part of a Storm Software project. The project\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/license.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software\n Documentation:            https://stormsoftware.com/docs\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Creates a new object composed of the picked object properties.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * includes only the properties corresponding to the specified keys.\n *\n * @param obj - The object to pick keys from.\n * @param keys - An array of keys to be picked from the object.\n * @returns A new object with the specified keys picked.\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = pick(obj, ['a', 'c']);\n * // result will be { a: 1, c: 3 }\n * ```\n */\nexport function pick<T extends Record<string, any>, K extends keyof T>(\n  obj: T,\n  keys: readonly K[]\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n\n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n\n    if (key && Object.hasOwn(obj, key)) {\n      result[key] = obj[key];\n    }\n  }\n\n  return result;\n}\n"],"mappings":"AAmCA,SAAgB,EACd,EACA,EACY,CACZ,IAAM,EAAS,EAAE,CAEjB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAQ,IAAK,CACpC,IAAM,EAAM,EAAK,GAEb,GAAO,OAAO,OAAO,EAAK,EAAI,GAChC,EAAO,GAAO,EAAI,IAItB,OAAO"}
+{"version":3,"file":"pick.mjs","names":[],"sources":["../src/pick.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                             ⚡ Storm Software \n\n This code was released as part of a Storm Software project. The project\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/license.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software\n Documentation:            https://stormsoftware.com/docs\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Creates a new object composed of the picked object properties.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * includes only the properties corresponding to the specified keys.\n *\n * @param obj - The object to pick keys from.\n * @param keys - An array of keys to be picked from the object.\n * @returns A new object with the specified keys picked.\n *\n * @example\n * ```typescript\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = pick(obj, ['a', 'c']);\n * // result will be { a: 1, c: 3 }\n * ```\n */\nexport function pick<T extends Record<string, any>, K extends keyof T>(\n  obj: T,\n  keys: readonly K[]\n): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n\n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n\n    if (key && Object.hasOwn(obj, key)) {\n      result[key] = obj[key];\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmCA,SAAgB,KACd,KACA,MACY;CACZ,MAAM,SAAS,EAAE;AAEjB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;AAEjB,MAAI,OAAO,OAAO,OAAO,KAAK,IAAI,CAChC,QAAO,OAAO,IAAI;;AAItB,QAAO"}