@guillaume-docquier/tools-ts 4.1.0 → 4.2.0

package/README.md

@@ -101,12 +101,13 @@ consistent context, scopes, formatting, and redaction.
 Use these small utilities to keep common asynchronous and callback patterns
 consistent.
 
-| Export            | What it is                    | Use it when                                                                     |
-| ----------------- | ----------------------------- | ------------------------------------------------------------------------------- |
-| `setTimeoutAsync` | Promise-based timeout helper. | You want `await`-friendly delays that work in browser and Node environments.    |
-| `debounce`        | Creates a debounced callback. | A repeated event should trigger work only after calls have settled for a delay. |
-| `noop`            | Synchronous no-op function.   | You need a safe default callback that intentionally does nothing.               |
-| `asyncNoop`       | Asynchronous no-op function.  | You need a safe default async callback or hook that resolves immediately.       |
+| Export            | What it is                                 | Use it when                                                                     |
+| ----------------- | ------------------------------------------ | ------------------------------------------------------------------------------- |
+| `setTimeoutAsync` | Promise-based timeout helper.              | You want `await`-friendly delays that work in browser and Node environments.    |
+| `debounce`        | Creates a debounced callback.              | A repeated event should trigger work only after calls have settled for a delay. |
+| `noop`            | Synchronous no-op function.                | You need a safe default callback that intentionally does nothing.               |
+| `asyncNoop`       | Asynchronous no-op function.               | You need a safe default async callback or hook that resolves immediately.       |
+| `omit`            | Runtime equivalent of `Omit<TType, TKey>`. | You need to remove keys from an object.                                         |
 
 ### Measurement
 

package/dist/entry.tools-ts.d.ts

@@ -6,6 +6,7 @@ export { isNodeJSError } from "./errors/isNodeJSError.js";
 export { getEnumKey } from "./getEnumKey.js";
 export type * from "./utility-types.js";
 export { asArray } from "./asArray.js";
+export { omit } from "./omit.js";
 export { Assert } from "./Assert.js";
 export { Result, type Success, type Failure } from "./Result.js";
 export { Measure } from "./Measure.js";

package/dist/entry.tools-ts.js

@@ -5,6 +5,7 @@ export { NotImplementedError } from "./errors/NotImplementedError.js";
 export { isNodeJSError } from "./errors/isNodeJSError.js";
 export { getEnumKey } from "./getEnumKey.js";
 export { asArray } from "./asArray.js";
+export { omit } from "./omit.js";
 export { Assert } from "./Assert.js";
 export { Result } from "./Result.js";
 export { Measure } from "./Measure.js";

package/dist/entry.tools-ts.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.tools-ts.js","sourceRoot":"","sources":["../src/entry.tools-ts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAKvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAA4B,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"entry.tools-ts.js","sourceRoot":"","sources":["../src/entry.tools-ts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAKvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAA4B,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/noop.d.ts

@@ -1,10 +1,10 @@
 /**
  * Does nothing.
- * Usually used a default parameter for optional callbacks.
+ * Usually used as a default parameter for optional callbacks.
  */
 export declare function noop(): void;
 /**
  * Asynchronously does nothing.
- * Usually used a default parameter for async optional callbacks.
+ * Usually used as a default parameter for async optional callbacks.
  */
 export declare function asyncNoop(): Promise<void>;

package/dist/noop.js

@@ -1,11 +1,11 @@
 /**
  * Does nothing.
- * Usually used a default parameter for optional callbacks.
+ * Usually used as a default parameter for optional callbacks.
  */
 export function noop() { }
 /**
  * Asynchronously does nothing.
- * Usually used a default parameter for async optional callbacks.
+ * Usually used as a default parameter for async optional callbacks.
  */
 export async function asyncNoop() { }
 //# sourceMappingURL=noop.js.map

package/dist/omit.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns the given record with omitted keys.
+ *
+ * @example
+ * ```ts
+ * const record = { a: 1, b: 2, c: 3 }
+ * const omitted = omit(record, "b", "c")
+ *
+ * console.log(record) // { a: 1, b: 2, c: 3 }
+ * console.log(omitted) // { a: 1 }
+ * ```
+ */
+export declare function omit<TRecord extends Record<string, unknown>, TKey extends keyof TRecord>(record: Readonly<TRecord>, ...keys: TKey[]): Omit<TRecord, TKey>;

package/dist/omit.js

@@ -0,0 +1,20 @@
+/**
+ * Returns the given record with omitted keys.
+ *
+ * @example
+ * ```ts
+ * const record = { a: 1, b: 2, c: 3 }
+ * const omitted = omit(record, "b", "c")
+ *
+ * console.log(record) // { a: 1, b: 2, c: 3 }
+ * console.log(omitted) // { a: 1 }
+ * ```
+ */
+export function omit(record, ...keys) {
+    const result = { ...record };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+//# sourceMappingURL=omit.js.map

package/dist/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../src/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAClB,MAAyB,EACzB,GAAG,IAAY;IAEf,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAE5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guillaume-docquier/tools-ts",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "My personal collection of typescript tools",
   "homepage": "https://github.com/Guillaume-Docquier/tools-ts",
   "repository": {