@xylabs/assert 4.3.1 → 4.3.3

package/dist/neutral/assertDefinedEx.d.ts

@@ -0,0 +1,15 @@
+import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts';
+/**
+ *
+ * Intended for simple null/undefined checks for variables
+ *
+ * @param expr - Expression to be evaluated for truthiness
+ * @param message - Message in Error if expression is false, may be a function that returns a string
+ * @throws AssertExError
+ * @returns Value of expression
+ */
+declare function assertDefinedEx<T>(expr: T | null | undefined): T;
+declare function assertDefinedEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T;
+declare function assertDefinedEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T;
+export { assertDefinedEx };
+//# sourceMappingURL=assertDefinedEx.d.ts.map

package/dist/neutral/assertDefinedEx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertDefinedEx.d.ts","sourceRoot":"","sources":["../../src/assertDefinedEx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;;;;GAQG;AACH,iBAAS,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,CAAA;AAC1D,iBAAS,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAChG,iBAAS,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAchH,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/dist/neutral/assertEx.d.ts

@@ -0,0 +1,19 @@
+import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts';
+/**
+ *
+ * Intended for simple truthiness checks for variables
+ *
+ * @param expr - Expression to be evaluated for truthiness
+ * @param message - Message in Error if expression is false, may be a function that returns a string
+ * @throws AssertExError
+ * @returns Value of expression
+ */
+declare function assertEx<T>(expr: T | null | undefined): T;
+/**
+ * @deprecated - replace string with () => string
+ */
+declare function assertEx<T>(expr: T | null | undefined, message?: string): T;
+declare function assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T;
+declare function assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T;
+export { assertEx };
+//# sourceMappingURL=assertEx.d.ts.map

package/dist/neutral/assertEx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertEx.d.ts","sourceRoot":"","sources":["../../src/assertEx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;;;;GAQG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,CAAA;AACnD;;GAEG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;AACrE,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACzF,iBAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAczG,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/neutral/index.d.ts

@@ -1,20 +1,4 @@
-export type AssertExMessageFunc<T> = (value?: T | null) => string;
-export type AssertExErrorFunc<T, R extends Error> = (value?: T | null) => R;
-/**
- *
- * Intended for simple null/undefined checks for variables
- *
- * @param expr - Expression to be evaluated for truthiness
- * @param message - Message in Error if expression is false, may be a function that returns a string
- * @throws AssertExError
- * @returns Value of expression
- */
-declare function assertEx<T>(expr: T | null | undefined): T;
-/**
- * @deprecated - replace string with () => string
- */
-declare function assertEx<T>(expr: T | null | undefined, message?: string): T;
-declare function assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T;
-declare function assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T;
-export { assertEx };
+export * from './assertDefinedEx.ts';
+export * from './assertEx.ts';
+export type * from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,CAAA;AACjE,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAA;AAE3E;;;;;;;;GAQG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,CAAA;AACnD;;GAEG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAA;AACrE,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACzF,iBAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAczG,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,mBAAmB,YAAY,CAAA"}

package/dist/neutral/index.mjs

@@ -1,4 +1,14 @@
-// src/index.ts
+// src/assertDefinedEx.ts
+function assertDefinedEx(expr, messageOrFunc) {
+  if (expr !== void 0 && expr !== null) return expr;
+  if (typeof messageOrFunc === "function") {
+    const errorOrMessage = messageOrFunc(expr);
+    throw typeof errorOrMessage === "string" ? new Error(errorOrMessage) : errorOrMessage;
+  }
+  throw new Error(messageOrFunc);
+}
+
+// src/assertEx.ts
 function assertEx(expr, messageOrFunc) {
   if (expr) return expr;
   if (typeof messageOrFunc === "function") {
@@ -8,6 +18,7 @@ function assertEx(expr, messageOrFunc) {
   throw new Error(messageOrFunc);
 }
 export {
+  assertDefinedEx,
   assertEx
 };
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["export type AssertExMessageFunc<T> = (value?: T | null) => string\nexport type AssertExErrorFunc<T, R extends Error> = (value?: T | null) => R\n\n/**\n *\n * Intended for simple null/undefined checks for variables\n *\n * @param expr - Expression to be evaluated for truthiness\n * @param message - Message in Error if expression is false, may be a function that returns a string\n * @throws AssertExError\n * @returns Value of expression\n */\nfunction assertEx<T>(expr: T | null | undefined): T\n/**\n * @deprecated - replace string with () => string\n */\nfunction assertEx<T>(expr: T | null | undefined, message?: string): T\nfunction assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T\nfunction assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T\nfunction assertEx<T, R extends Error, P extends string | AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(\n  expr: T | null | undefined,\n  messageOrFunc?: P,\n): T {\n  if (expr) return expr\n  if (typeof messageOrFunc === 'function') {\n    const errorOrMessage = messageOrFunc(expr)\n    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage\n  }\n  // a string was sent\n  throw new Error(messageOrFunc)\n}\n\nexport { assertEx }\n"],"mappings":";AAmBA,SAAS,SACP,MACA,eACG;AACH,MAAI,KAAM,QAAO;AACjB,MAAI,OAAO,kBAAkB,YAAY;AACvC,UAAM,iBAAiB,cAAc,IAAI;AACzC,UAAM,OAAO,mBAAmB,WAAW,IAAI,MAAM,cAAc,IAAI;AAAA,EACzE;AAEA,QAAM,IAAI,MAAM,aAAa;AAC/B;","names":[]}
+{"version":3,"sources":["../../src/assertDefinedEx.ts","../../src/assertEx.ts"],"sourcesContent":["import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts'\n\n/**\n *\n * Intended for simple null/undefined checks for variables\n *\n * @param expr - Expression to be evaluated for truthiness\n * @param message - Message in Error if expression is false, may be a function that returns a string\n * @throws AssertExError\n * @returns Value of expression\n */\nfunction assertDefinedEx<T>(expr: T | null | undefined): T\nfunction assertDefinedEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T\nfunction assertDefinedEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T\nfunction assertDefinedEx<T, R extends Error, P extends string | AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(\n  expr: T | null | undefined,\n  messageOrFunc?: P,\n): T {\n  if (expr !== undefined && expr !== null) return expr\n  if (typeof messageOrFunc === 'function') {\n    const errorOrMessage = messageOrFunc(expr)\n    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage\n  }\n  // a string was sent\n  throw new Error(messageOrFunc)\n}\n\nexport { assertDefinedEx }\n","import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts'\n\n/**\n *\n * Intended for simple truthiness checks for variables\n *\n * @param expr - Expression to be evaluated for truthiness\n * @param message - Message in Error if expression is false, may be a function that returns a string\n * @throws AssertExError\n * @returns Value of expression\n */\nfunction assertEx<T>(expr: T | null | undefined): T\n/**\n * @deprecated - replace string with () => string\n */\nfunction assertEx<T>(expr: T | null | undefined, message?: string): T\nfunction assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T\nfunction assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T\nfunction assertEx<T, R extends Error, P extends string | AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(\n  expr: T | null | undefined,\n  messageOrFunc?: P,\n): T {\n  if (expr) return expr\n  if (typeof messageOrFunc === 'function') {\n    const errorOrMessage = messageOrFunc(expr)\n    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage\n  }\n  // a string was sent\n  throw new Error(messageOrFunc)\n}\n\nexport { assertEx }\n"],"mappings":";AAcA,SAAS,gBACP,MACA,eACG;AACH,MAAI,SAAS,UAAa,SAAS,KAAM,QAAO;AAChD,MAAI,OAAO,kBAAkB,YAAY;AACvC,UAAM,iBAAiB,cAAc,IAAI;AACzC,UAAM,OAAO,mBAAmB,WAAW,IAAI,MAAM,cAAc,IAAI;AAAA,EACzE;AAEA,QAAM,IAAI,MAAM,aAAa;AAC/B;;;ACPA,SAAS,SACP,MACA,eACG;AACH,MAAI,KAAM,QAAO;AACjB,MAAI,OAAO,kBAAkB,YAAY;AACvC,UAAM,iBAAiB,cAAc,IAAI;AACzC,UAAM,OAAO,mBAAmB,WAAW,IAAI,MAAM,cAAc,IAAI;AAAA,EACzE;AAEA,QAAM,IAAI,MAAM,aAAa;AAC/B;","names":[]}

package/dist/neutral/types.d.ts

@@ -0,0 +1,3 @@
+export type AssertExMessageFunc<T> = (value?: T | null) => string;
+export type AssertExErrorFunc<T, R extends Error> = (value?: T | null) => R;
+//# sourceMappingURL=types.d.ts.map

package/dist/neutral/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,CAAA;AACjE,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/assert",
-  "version": "4.3.1",
+  "version": "4.3.3",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "keywords": [
     "xylabs",

package/src/assertDefinedEx.ts

@@ -0,0 +1,28 @@
+import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts'
+
+/**
+ *
+ * Intended for simple null/undefined checks for variables
+ *
+ * @param expr - Expression to be evaluated for truthiness
+ * @param message - Message in Error if expression is false, may be a function that returns a string
+ * @throws AssertExError
+ * @returns Value of expression
+ */
+function assertDefinedEx<T>(expr: T | null | undefined): T
+function assertDefinedEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T
+function assertDefinedEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T
+function assertDefinedEx<T, R extends Error, P extends string | AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(
+  expr: T | null | undefined,
+  messageOrFunc?: P,
+): T {
+  if (expr !== undefined && expr !== null) return expr
+  if (typeof messageOrFunc === 'function') {
+    const errorOrMessage = messageOrFunc(expr)
+    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage
+  }
+  // a string was sent
+  throw new Error(messageOrFunc)
+}
+
+export { assertDefinedEx }

package/src/assertEx.ts

@@ -0,0 +1,32 @@
+import type { AssertExErrorFunc, AssertExMessageFunc } from './types.ts'
+
+/**
+ *
+ * Intended for simple truthiness checks for variables
+ *
+ * @param expr - Expression to be evaluated for truthiness
+ * @param message - Message in Error if expression is false, may be a function that returns a string
+ * @throws AssertExError
+ * @returns Value of expression
+ */
+function assertEx<T>(expr: T | null | undefined): T
+/**
+ * @deprecated - replace string with () => string
+ */
+function assertEx<T>(expr: T | null | undefined, message?: string): T
+function assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T
+function assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T
+function assertEx<T, R extends Error, P extends string | AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(
+  expr: T | null | undefined,
+  messageOrFunc?: P,
+): T {
+  if (expr) return expr
+  if (typeof messageOrFunc === 'function') {
+    const errorOrMessage = messageOrFunc(expr)
+    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage
+  }
+  // a string was sent
+  throw new Error(messageOrFunc)
+}
+
+export { assertEx }

package/src/index.ts

@@ -1,33 +1,3 @@
-export type AssertExMessageFunc<T> = (value?: T | null) => string
-export type AssertExErrorFunc<T, R extends Error> = (value?: T | null) => R
-
-/**
- *
- * Intended for simple null/undefined checks for variables
- *
- * @param expr - Expression to be evaluated for truthiness
- * @param message - Message in Error if expression is false, may be a function that returns a string
- * @throws AssertExError
- * @returns Value of expression
- */
-function assertEx<T>(expr: T | null | undefined): T
-/**
- * @deprecated - replace string with () => string
- */
-function assertEx<T>(expr: T | null | undefined, message?: string): T
-function assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T
-function assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T
-function assertEx<T, R extends Error, P extends string | AssertExMessageFunc<T> | AssertExErrorFunc<T, R>>(
-  expr: T | null | undefined,
-  messageOrFunc?: P,
-): T {
-  if (expr) return expr
-  if (typeof messageOrFunc === 'function') {
-    const errorOrMessage = messageOrFunc(expr)
-    throw typeof errorOrMessage === 'string' ? new Error(errorOrMessage) : errorOrMessage
-  }
-  // a string was sent
-  throw new Error(messageOrFunc)
-}
-
-export { assertEx }
+export * from './assertDefinedEx.ts'
+export * from './assertEx.ts'
+export type * from './types.ts'

package/src/types.ts

@@ -0,0 +1,2 @@
+export type AssertExMessageFunc<T> = (value?: T | null) => string
+export type AssertExErrorFunc<T, R extends Error> = (value?: T | null) => R