@gershy/clearing 0.0.16 → 0.0.17

package/cmp/cjs/main.d.ts

@@ -16,5 +16,15 @@ export declare const getCls: (i: any) => any;
 export declare const isCls: ClsCheck;
 export declare const inCls: ClsCheck;
 export declare const skip: undefined;
+type Then = {
+    <V, R0 = V, R1 = never>(val: Promise<V>, rsv?: (v: V) => R0, rjc?: (e: any) => R1): Promise<R0 | R1>;
+    <V, R0 = V, R1 = never>(val: V, rsv?: (v: V) => R0, rjc?: (e: any) => R1): R0 | R1;
+};
+export declare const then: Then;
+type Safe = {
+    <V, R0 = never>(fn: () => Promise<V>, rjc?: (e: any) => R0): Promise<V | R0>;
+    <V, R0 = never>(fn: () => V, rjc?: (e: any) => R0): Promise<V | R0>;
+};
+export declare const safe: Safe;
 declare const applyClearing: () => void;
 export default applyClearing;

package/cmp/cjs/main.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.skip = exports.inCls = exports.isCls = exports.getCls = exports.getClsName = void 0;
+exports.safe = exports.then = exports.skip = exports.inCls = exports.isCls = exports.getCls = exports.getClsName = void 0;
 const getClsName = i => {
     if (i === null)
         return 'Null';
@@ -27,6 +27,30 @@ exports.isCls = isCls;
 const inCls = (i, C) => i instanceof C;
 exports.inCls = inCls;
 exports.skip = undefined;
+const then = (val, rsv = (v => v), rjc = ((e) => { throw e; })) => {
+    // Act on `val` regardless of whether it's a Promise or immediate value; return `rsv(val)`
+    // either immediately or as a Promise
+    if ((0, exports.inCls)(val, Promise))
+        return val.then(rsv).catch(rjc);
+    try {
+        return rsv(val);
+    }
+    catch (err) {
+        return rjc(err);
+    }
+};
+exports.then = then;
+const safe = (fn, rjc = e => { throw e; }) => {
+    // Execute a function which returns a value either synchronously or asynchronously; in both cases
+    // allows errors occurring from function execution to be handled
+    try {
+        return (0, exports.then)(fn(), v => v, rjc);
+    }
+    catch (err) {
+        return rjc(err);
+    }
+};
+exports.safe = safe;
 const applyClearing = (() => {
     const global = globalThis;
     // Prevent multiple installations...

package/cmp/mjs/main.d.ts

@@ -16,5 +16,15 @@ export declare const getCls: (i: any) => any;
 export declare const isCls: ClsCheck;
 export declare const inCls: ClsCheck;
 export declare const skip: undefined;
+type Then = {
+    <V, R0 = V, R1 = never>(val: Promise<V>, rsv?: (v: V) => R0, rjc?: (e: any) => R1): Promise<R0 | R1>;
+    <V, R0 = V, R1 = never>(val: V, rsv?: (v: V) => R0, rjc?: (e: any) => R1): R0 | R1;
+};
+export declare const then: Then;
+type Safe = {
+    <V, R0 = never>(fn: () => Promise<V>, rjc?: (e: any) => R0): Promise<V | R0>;
+    <V, R0 = never>(fn: () => V, rjc?: (e: any) => R0): Promise<V | R0>;
+};
+export declare const safe: Safe;
 declare const applyClearing: () => void;
 export default applyClearing;

package/cmp/mjs/main.js

@@ -20,6 +20,28 @@ export const isCls = (i, C) => {
 };
 export const inCls = (i, C) => i instanceof C;
 export const skip = undefined;
+export const then = (val, rsv = (v => v), rjc = ((e) => { throw e; })) => {
+    // Act on `val` regardless of whether it's a Promise or immediate value; return `rsv(val)`
+    // either immediately or as a Promise
+    if (inCls(val, Promise))
+        return val.then(rsv).catch(rjc);
+    try {
+        return rsv(val);
+    }
+    catch (err) {
+        return rjc(err);
+    }
+};
+export const safe = (fn, rjc = e => { throw e; }) => {
+    // Execute a function which returns a value either synchronously or asynchronously; in both cases
+    // allows errors occurring from function execution to be handled
+    try {
+        return then(fn(), v => v, rjc);
+    }
+    catch (err) {
+        return rjc(err);
+    }
+};
 const applyClearing = (() => {
     const global = globalThis;
     // Prevent multiple installations...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gershy/clearing",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "Adds the features you always wish javascript had!",
   "keywords": [
     "clearing",
@@ -38,9 +38,9 @@
   "scripts": {
     "test": "npm run ts.check && npx tsx ./src/main.test.ts",
     "ts.check": "npx tsc --noEmit",
-    "build.cjs": "tsc -p ts/tsconfig.cjs.json",
-    "build.mjs": "tsc -p ts/tsconfig.mjs.json",
-    "build": "node ./build.js removeCmp && npm run build.cjs && npm run build.mjs && node ./build.js finalizeExportVariants",
+    "build.cjs": "tsc -p build/tsconfig.cjs.json",
+    "build.mjs": "tsc -p build/tsconfig.mjs.json",
+    "build": "node ./build/act.js removeCmp && npm run build.cjs && npm run build.mjs && node ./build/act.js finalizeExportVariants",
     "git.pub": "npm run test && git add --all && git commit -m \"automated\" && git push",
     "npm.login": "npm login",
     "npm.pub": "npm run test && npm run build && npm publish --access public"