get-or-throw 1.2.0 → 1.3.0

package/README.md

@@ -9,6 +9,7 @@ setting.
 - Works with both objects and arrays.
 - Supports negative indexing for arrays.
 - Allows for custom error messages.
+- Zero dependencies.
 
 ## Installation
 

package/dist/index.cjs

@@ -33,7 +33,14 @@ function getOrThrow(objOrArr, keyOrIndex, errorMessage) {
       index = length + index;
     }
     if (index >= 0 && index < length) {
-      return objOrArr[index];
+      const value = objOrArr[index];
+      if (value === void 0) {
+        throw new Error(
+          errorMessage ?? `Value at index ${String(keyOrIndex)} is undefined.`
+        );
+      } else {
+        return value;
+      }
     } else {
       throw new Error(
         errorMessage ?? `Index ${String(keyOrIndex)} is out of bounds.`
@@ -41,7 +48,14 @@ function getOrThrow(objOrArr, keyOrIndex, errorMessage) {
     }
   } else {
     if (keyOrIndex in objOrArr) {
-      return objOrArr[keyOrIndex];
+      const value = objOrArr[keyOrIndex];
+      if (value === void 0) {
+        throw new Error(
+          errorMessage ?? `Value at key "${String(keyOrIndex)}" is undefined.`
+        );
+      } else {
+        return value;
+      }
     } else {
       throw new Error(
         errorMessage ?? `Key "${String(keyOrIndex)}" does not exist in the object.`

package/dist/index.d.cts

@@ -1,13 +1,15 @@
 /**
- * Get a value from an object or array, or throw an error if the key or index
- * does not exist.
+ * Get a value from an object or array, and throw an error if the key or index
+ * does not exist or if the resulting value is undefined.
  *
  * @param objOrArr The object or array to get the value from.
  * @param keyOrIndex The key or index to get the value from.
  * @param errorMessage Optional error message to include in the error thrown.
  * @returns The value at the given key or index.
- * @throws An error if the key or index does not exist.
+ * @throws An error if the key or index does not exist, or if the resulting
+ *   value is undefined.
  */
-declare function getOrThrow<T extends object, K extends keyof T>(objOrArr: T | T[], keyOrIndex: K | number, errorMessage?: string): T[K] | T;
+declare function getOrThrow<T extends object, K extends keyof T>(obj: T, key: K, errorMessage?: string): T[K];
+declare function getOrThrow<T>(arr: T[], index: number, errorMessage?: string): T;
 
 export { getOrThrow };

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 /**
- * Get a value from an object or array, or throw an error if the key or index
- * does not exist.
+ * Get a value from an object or array, and throw an error if the key or index
+ * does not exist or if the resulting value is undefined.
  *
  * @param objOrArr The object or array to get the value from.
  * @param keyOrIndex The key or index to get the value from.
  * @param errorMessage Optional error message to include in the error thrown.
  * @returns The value at the given key or index.
- * @throws An error if the key or index does not exist.
+ * @throws An error if the key or index does not exist, or if the resulting
+ *   value is undefined.
  */
-declare function getOrThrow<T extends object, K extends keyof T>(objOrArr: T | T[], keyOrIndex: K | number, errorMessage?: string): T[K] | T;
+declare function getOrThrow<T extends object, K extends keyof T>(obj: T, key: K, errorMessage?: string): T[K];
+declare function getOrThrow<T>(arr: T[], index: number, errorMessage?: string): T;
 
 export { getOrThrow };

package/dist/index.js

@@ -7,7 +7,14 @@ function getOrThrow(objOrArr, keyOrIndex, errorMessage) {
       index = length + index;
     }
     if (index >= 0 && index < length) {
-      return objOrArr[index];
+      const value = objOrArr[index];
+      if (value === void 0) {
+        throw new Error(
+          errorMessage ?? `Value at index ${String(keyOrIndex)} is undefined.`
+        );
+      } else {
+        return value;
+      }
     } else {
       throw new Error(
         errorMessage ?? `Index ${String(keyOrIndex)} is out of bounds.`
@@ -15,7 +22,14 @@ function getOrThrow(objOrArr, keyOrIndex, errorMessage) {
     }
   } else {
     if (keyOrIndex in objOrArr) {
-      return objOrArr[keyOrIndex];
+      const value = objOrArr[keyOrIndex];
+      if (value === void 0) {
+        throw new Error(
+          errorMessage ?? `Value at key "${String(keyOrIndex)}" is undefined.`
+        );
+      } else {
+        return value;
+      }
     } else {
       throw new Error(
         errorMessage ?? `Key "${String(keyOrIndex)}" does not exist in the object.`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-or-throw",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A convenience function for adhering to Typescript's noUncheckedIndexedAccess rule",
   "type": "module",
   "main": "dist/index.cjs",
@@ -28,7 +28,8 @@
   },
   "homepage": "https://github.com/0x80/get-or-throw#readme",
   "devDependencies": {
-    "@codecompose/typescript-config": "^1.0.5",
+    "@codecompose/typescript-config": "^1.1.2",
+    "del-cli": "^5.1.0",
     "prettier": "^3.3.3",
     "prettier-plugin-jsdoc": "^1.3.0",
     "tsup": "^8.3.0",
@@ -36,6 +37,7 @@
   },
   "scripts": {
     "build": "tsup",
+    "clean": "del dist tsconfig.tsbuildinfo",
     "test": "echo \"Error: no test specified\" && exit 1"
   }
 }

package/src/get-or-throw.ts

@@ -1,13 +1,24 @@
 /**
- * Get a value from an object or array, or throw an error if the key or index
- * does not exist.
+ * Get a value from an object or array, and throw an error if the key or index
+ * does not exist or if the resulting value is undefined.
  *
  * @param objOrArr The object or array to get the value from.
  * @param keyOrIndex The key or index to get the value from.
  * @param errorMessage Optional error message to include in the error thrown.
  * @returns The value at the given key or index.
- * @throws An error if the key or index does not exist.
+ * @throws An error if the key or index does not exist, or if the resulting
+ *   value is undefined.
  */
+export function getOrThrow<T extends object, K extends keyof T>(
+  obj: T,
+  key: K,
+  errorMessage?: string
+): T[K];
+export function getOrThrow<T>(
+  arr: T[],
+  index: number,
+  errorMessage?: string
+): T;
 export function getOrThrow<T extends object, K extends keyof T>(
   objOrArr: T | T[],
   keyOrIndex: K | number,
@@ -23,7 +34,15 @@ export function getOrThrow<T extends object, K extends keyof T>(
     }
 
     if (index >= 0 && index < length) {
-      return objOrArr[index]!;
+      const value = objOrArr[index];
+
+      if (value === undefined) {
+        throw new Error(
+          errorMessage ?? `Value at index ${String(keyOrIndex)} is undefined.`
+        );
+      } else {
+        return value;
+      }
     } else {
       throw new Error(
         errorMessage ?? `Index ${String(keyOrIndex)} is out of bounds.`
@@ -31,7 +50,15 @@ export function getOrThrow<T extends object, K extends keyof T>(
     }
   } else {
     if (keyOrIndex in objOrArr) {
-      return objOrArr[keyOrIndex as K];
+      const value = objOrArr[keyOrIndex as K];
+
+      if (value === undefined) {
+        throw new Error(
+          errorMessage ?? `Value at key "${String(keyOrIndex)}" is undefined.`
+        );
+      } else {
+        return value;
+      }
     } else {
       throw new Error(
         errorMessage ??

package/tsconfig.json

@@ -1,7 +1,3 @@
 {
-  "extends": "@codecompose/typescript-config/library.json",
-  "compilerOptions": {
-    "composite": false,
-    "incremental": false
-  }
+  "extends": "@codecompose/typescript-config/single-library.json"
 }