await-me 1.0.3 → 1.0.5

package/dist/index.cjs

@@ -0,0 +1,2 @@
+var L=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var _=(r,e)=>{for(var n in e)L(r,n,{get:e[n],enumerable:!0})},A=(r,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of m(e))!O.call(r,c)&&c!==n&&L(r,c,{get:()=>e[c],enumerable:!(o=Y(e,c))||o.enumerable});return r};var g=r=>A(L({},"__esModule",{value:!0}),r);var i=(r,e,n)=>new Promise((o,c)=>{var E=s=>{try{u(n.next(s))}catch(y){c(y)}},a=s=>{try{u(n.throw(s))}catch(y){c(y)}},u=s=>s.done?o(s.value):Promise.resolve(s.value).then(E,a);u((n=n.apply(r,e)).next())});var h={};_(h,{RETURN_STYLES:()=>t,STYLES:()=>t,WaitForMe:()=>x,createAsyncHandler:()=>l,isSuccess:()=>d,toResult:()=>S,valueOf:()=>T});module.exports=g(h);var t={FALSE_STYLE:"false-style",TRUE_STYLE:"true-style",GO_STYLE:"goStyle",ERROR_STYLE:"errorStyle",ONLY_ERROR:"only-error",BOOLEAN:"boolean"};function l(r={}){let{returnStyle:e=t.GO_STYLE,conditionalHandlerChain:n=[],defaultHandler:o=E=>{throw E}}=r;return function(E){return i(this,null,function*(){try{let a=yield E;switch(e){case t.GO_STYLE:return[null,a];case t.ONLY_ERROR:return 0;case t.BOOLEAN:return!0;default:return a}}catch(a){let u=!1;for(let{ifTrue:s,doIt:y}of n)if(s(a)){try{y(a)}catch(H){}u=!0;break}switch(e){case t.GO_STYLE:return[a,null];case t.ONLY_ERROR:return 1;case t.BOOLEAN:return!1;case t.FALSE_STYLE:case t.TRUE_STYLE:if(!u)try{o(a)}catch(s){}return e!==t.FALSE_STYLE;case t.ERROR_STYLE:return a;default:if(!u)return o(a);throw a}}})}}var p=l({returnStyle:t.GO_STYLE});function R(r,e,n){if(r){if(typeof r=="object"&&typeof r.fn=="function"){let o=Array.isArray(r.params)?r.params:[];r.fn(...o);return}typeof r=="string"&&console[e](r,n||"")}}function f(r,e,n){if(r){if(typeof r=="string"){e==="error"&&R(r,"error",n);return}e==="error"&&r.error?R(r.error,"error",n):e==="success"&&r.success&&R(r.success,"log")}}function T(r,e){return i(this,null,function*(){let[n,o]=yield p(r);return n?(f(e,"error",n),!1):(f(e,"success"),o)})}function d(r,e){return i(this,null,function*(){let[n]=yield p(r);return n?(f(e,"error",n),!1):(f(e,"success"),!0)})}function S(r,e){return i(this,null,function*(){let[n,o]=yield p(r);return n?(f(e,"error",n),{success:!1,data:null,error:n}):(f(e,"success"),{success:!0,data:o,error:null})})}var x={create:l,valueOf:T,isSuccess:d,toResult:S,STYLES:t};0&&(module.exports={RETURN_STYLES,STYLES,WaitForMe,createAsyncHandler,isSuccess,toResult,valueOf});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../../await-me-ts/src/core.ts","../../await-me-ts/src/derivatives/index.ts"],"sourcesContent":["import { \n  createAsyncHandler, \n  RETURN_STYLES, \n  valueOf, \n  isSuccess, \n  toResult \n} from 'await-me-ts';\n\n/**\n * Symmetric Reflection: \n * We export the exact functions from the core engine.\n */\nexport {\n  createAsyncHandler,\n  valueOf,\n  isSuccess,\n  toResult,\n  RETURN_STYLES as STYLES // Alias for convenience, while keeping core name\n};\n\n/**\n * Optional: The Barrel Namespace\n * Provides the same symmetry for those who prefer dot-notation.\n */\nexport const WaitForMe = {\n  create: createAsyncHandler,\n  valueOf,\n  isSuccess,\n  toResult,\n  STYLES: RETURN_STYLES\n} as const;\n\n// Re-export all types from core for full IDE support\nexport * from 'await-me-ts';\n","export const RETURN_STYLES = {\n  FALSE_STYLE: 'false-style',\n  TRUE_STYLE: 'true-style',\n  GO_STYLE: 'goStyle',\n  ERROR_STYLE: 'errorStyle',\n  ONLY_ERROR: 'only-error',\n  BOOLEAN: 'boolean',\n} as const;\n\nexport type ReturnStyle = typeof RETURN_STYLES[keyof typeof RETURN_STYLES];\n\n// New: Explicit interface to ensure the returned function is generic\nexport interface AsyncWrappedFunction {\n  <T>(promise: Promise<T>): Promise<any>;\n}\n\nexport interface ConditionalHandler<T = any, E = any> {\n  ifTrue: (error: E) => boolean;\n  doIt: (error: E) => void;\n}\n\nexport interface AsyncHandlerConfig<T = any, E = any> {\n  returnStyle?: ReturnStyle;\n  conditionalHandlerChain?: ConditionalHandler<T, E>[];\n  defaultHandler?: (error: E) => any;\n}\n\nexport function createAsyncHandler<E = any>(config: AsyncHandlerConfig<any, E> = {}): AsyncWrappedFunction {\n  const {\n    returnStyle = RETURN_STYLES.GO_STYLE,\n    conditionalHandlerChain = [],\n    defaultHandler = (e: E) => { throw e; }\n  } = config;\n\n  // The implementation now strictly follows the generic interface\n  const handler: AsyncWrappedFunction = async function<T>(promise: Promise<T>): Promise<any> {\n    try {\n      const data = await promise;\n      switch (returnStyle) {\n        case RETURN_STYLES.GO_STYLE: return [null, data];\n        case RETURN_STYLES.ONLY_ERROR: return 0;\n        case RETURN_STYLES.BOOLEAN: return true;\n        default: return data;\n      }\n    } catch (error: any) {\n      let executedConditional = false;\n      for (const { ifTrue, doIt } of conditionalHandlerChain) {\n        if (ifTrue(error)) {\n          try { doIt(error); } catch (hErr) { }\n          executedConditional = true;\n          break;\n        }\n      }\n\n      switch (returnStyle) {\n        case RETURN_STYLES.GO_STYLE: return [error, null];\n        case RETURN_STYLES.ONLY_ERROR: return 1;\n        case RETURN_STYLES.BOOLEAN: return false;\n        case RETURN_STYLES.FALSE_STYLE:\n        case RETURN_STYLES.TRUE_STYLE:\n          if (!executedConditional) {\n            try { defaultHandler(error); } catch (hErr) { }\n          }\n          return returnStyle === RETURN_STYLES.FALSE_STYLE ? false : true;\n        case RETURN_STYLES.ERROR_STYLE: return error;\n        default:\n          if (!executedConditional) return defaultHandler(error);\n          throw error;\n      }\n    }\n  };\n\n  return handler;\n}\n","import { createAsyncHandler, RETURN_STYLES } from '../core.ts';\n\n// Internal handler typed for Go-style [Error, Data]\nconst internalHandler = createAsyncHandler({\n  returnStyle: RETURN_STYLES.GO_STYLE,\n});\n\ntype LogEntry = string | { fn: (...args: any[]) => void; params?: any[] };\ntype LogConfig = string | { error?: LogEntry; success?: LogEntry };\n\nfunction executeAction(entry: LogEntry | undefined, method: 'error' | 'log', payload?: any) {\n  if (!entry) return;\n  if (typeof entry === 'object' && typeof entry.fn === 'function') {\n    const params = Array.isArray(entry.params) ? entry.params : [];\n    entry.fn(...params);\n    return;\n  }\n  if (typeof entry === 'string') console[method](entry, payload || '');\n}\n\nfunction handleLog(config: LogConfig | undefined, type: 'error' | 'success', payload?: any) {\n  if (!config) return;\n  if (typeof config === 'string') {\n    if (type === 'error') executeAction(config, 'error', payload);\n    return;\n  }\n  if (type === 'error' && config.error) executeAction(config.error, 'error', payload);\n  else if (type === 'success' && config.success) executeAction(config.success, 'log');\n}\n\n/**\n * Returns the data <T> or false on failure.\n */\nexport async function valueOf<T>(promise: Promise<T>, config?: LogConfig): Promise<T | false> {\n  const [err, data] = await internalHandler<T>(promise);\n  if (err) { \n    handleLog(config, 'error', err); \n    return false; \n  }\n  handleLog(config, 'success');\n  return data as T;\n}\n\n/**\n * Returns true if the operation succeeded, false otherwise.\n */\nexport async function isSuccess(promise: Promise<any>, config?: LogConfig): Promise<boolean> {\n  const [err] = await internalHandler(promise);\n  if (err) { \n    handleLog(config, 'error', err); \n    return false; \n  }\n  handleLog(config, 'success');\n  return true;\n}\n\n/**\n * Returns an object { success, data, error }.\n * Safe for APIs that might return literal 'false' or 'null' as valid data.\n */\nexport async function toResult<T, E = any>(promise: Promise<T>, config?: LogConfig): Promise<{ success: boolean; data: T | null; error: E | null }> {\n  const [err, data] = await internalHandler<T>(promise);\n  if (err) {\n    handleLog(config, 'error', err);\n    return { success: false, data: null, error: err as E };\n  }\n  handleLog(config, 'success');\n  return { success: true, data: data as T, error: null };\n}\n"],"mappings":"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","names":["src_exports","__export","RETURN_STYLES","WaitForMe","createAsyncHandler","isSuccess","toResult","valueOf","__toCommonJS","RETURN_STYLES","createAsyncHandler","config","returnStyle","conditionalHandlerChain","defaultHandler","e","promise","__async","data","error","executedConditional","ifTrue","doIt","hErr","internalHandler","createAsyncHandler","RETURN_STYLES","executeAction","entry","method","payload","params","handleLog","config","type","valueOf","promise","__async","err","data","isSuccess","toResult","WaitForMe","createAsyncHandler","valueOf","isSuccess","toResult","RETURN_STYLES"]}

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+import { createAsyncHandler, valueOf, isSuccess, toResult } from 'await-me-ts';
+export * from 'await-me-ts';
+export { RETURN_STYLES as STYLES, createAsyncHandler, isSuccess, toResult, valueOf } from 'await-me-ts';
+
+/**
+ * Optional: The Barrel Namespace
+ * Provides the same symmetry for those who prefer dot-notation.
+ */
+declare const WaitForMe: {
+    readonly create: typeof createAsyncHandler;
+    readonly valueOf: typeof valueOf;
+    readonly isSuccess: typeof isSuccess;
+    readonly toResult: typeof toResult;
+    readonly STYLES: {
+        readonly FALSE_STYLE: "false-style";
+        readonly TRUE_STYLE: "true-style";
+        readonly GO_STYLE: "goStyle";
+        readonly ERROR_STYLE: "errorStyle";
+        readonly ONLY_ERROR: "only-error";
+        readonly BOOLEAN: "boolean";
+    };
+};
+
+export { WaitForMe };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { createAsyncHandler, valueOf, isSuccess, toResult } from 'await-me-ts';
+export * from 'await-me-ts';
+export { RETURN_STYLES as STYLES, createAsyncHandler, isSuccess, toResult, valueOf } from 'await-me-ts';
+
+/**
+ * Optional: The Barrel Namespace
+ * Provides the same symmetry for those who prefer dot-notation.
+ */
+declare const WaitForMe: {
+    readonly create: typeof createAsyncHandler;
+    readonly valueOf: typeof valueOf;
+    readonly isSuccess: typeof isSuccess;
+    readonly toResult: typeof toResult;
+    readonly STYLES: {
+        readonly FALSE_STYLE: "false-style";
+        readonly TRUE_STYLE: "true-style";
+        readonly GO_STYLE: "goStyle";
+        readonly ERROR_STYLE: "errorStyle";
+        readonly ONLY_ERROR: "only-error";
+        readonly BOOLEAN: "boolean";
+    };
+};
+
+export { WaitForMe };

package/dist/index.global.js

@@ -0,0 +1,2 @@
+var WaitForMeJS=(()=>{var L=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var _=(r,e)=>{for(var n in e)L(r,n,{get:e[n],enumerable:!0})},A=(r,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of m(e))!O.call(r,c)&&c!==n&&L(r,c,{get:()=>e[c],enumerable:!(o=Y(e,c))||o.enumerable});return r};var g=r=>A(L({},"__esModule",{value:!0}),r);var i=(r,e,n)=>new Promise((o,c)=>{var E=s=>{try{u(n.next(s))}catch(y){c(y)}},a=s=>{try{u(n.throw(s))}catch(y){c(y)}},u=s=>s.done?o(s.value):Promise.resolve(s.value).then(E,a);u((n=n.apply(r,e)).next())});var h={};_(h,{RETURN_STYLES:()=>t,STYLES:()=>t,WaitForMe:()=>x,createAsyncHandler:()=>l,isSuccess:()=>d,toResult:()=>S,valueOf:()=>T});var t={FALSE_STYLE:"false-style",TRUE_STYLE:"true-style",GO_STYLE:"goStyle",ERROR_STYLE:"errorStyle",ONLY_ERROR:"only-error",BOOLEAN:"boolean"};function l(r={}){let{returnStyle:e=t.GO_STYLE,conditionalHandlerChain:n=[],defaultHandler:o=E=>{throw E}}=r;return function(E){return i(this,null,function*(){try{let a=yield E;switch(e){case t.GO_STYLE:return[null,a];case t.ONLY_ERROR:return 0;case t.BOOLEAN:return!0;default:return a}}catch(a){let u=!1;for(let{ifTrue:s,doIt:y}of n)if(s(a)){try{y(a)}catch(H){}u=!0;break}switch(e){case t.GO_STYLE:return[a,null];case t.ONLY_ERROR:return 1;case t.BOOLEAN:return!1;case t.FALSE_STYLE:case t.TRUE_STYLE:if(!u)try{o(a)}catch(s){}return e!==t.FALSE_STYLE;case t.ERROR_STYLE:return a;default:if(!u)return o(a);throw a}}})}}var p=l({returnStyle:t.GO_STYLE});function R(r,e,n){if(r){if(typeof r=="object"&&typeof r.fn=="function"){let o=Array.isArray(r.params)?r.params:[];r.fn(...o);return}typeof r=="string"&&console[e](r,n||"")}}function f(r,e,n){if(r){if(typeof r=="string"){e==="error"&&R(r,"error",n);return}e==="error"&&r.error?R(r.error,"error",n):e==="success"&&r.success&&R(r.success,"log")}}function T(r,e){return i(this,null,function*(){let[n,o]=yield p(r);return n?(f(e,"error",n),!1):(f(e,"success"),o)})}function d(r,e){return i(this,null,function*(){let[n]=yield p(r);return n?(f(e,"error",n),!1):(f(e,"success"),!0)})}function S(r,e){return i(this,null,function*(){let[n,o]=yield p(r);return n?(f(e,"error",n),{success:!1,data:null,error:n}):(f(e,"success"),{success:!0,data:o,error:null})})}var x={create:l,valueOf:T,isSuccess:d,toResult:S,STYLES:t};return g(h);})();
+//# sourceMappingURL=index.global.js.map

package/dist/index.global.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../../await-me-ts/src/core.ts","../../await-me-ts/src/derivatives/index.ts"],"sourcesContent":["import { \n  createAsyncHandler, \n  RETURN_STYLES, \n  valueOf, \n  isSuccess, \n  toResult \n} from 'await-me-ts';\n\n/**\n * Symmetric Reflection: \n * We export the exact functions from the core engine.\n */\nexport {\n  createAsyncHandler,\n  valueOf,\n  isSuccess,\n  toResult,\n  RETURN_STYLES as STYLES // Alias for convenience, while keeping core name\n};\n\n/**\n * Optional: The Barrel Namespace\n * Provides the same symmetry for those who prefer dot-notation.\n */\nexport const WaitForMe = {\n  create: createAsyncHandler,\n  valueOf,\n  isSuccess,\n  toResult,\n  STYLES: RETURN_STYLES\n} as const;\n\n// Re-export all types from core for full IDE support\nexport * from 'await-me-ts';\n","export const RETURN_STYLES = {\n  FALSE_STYLE: 'false-style',\n  TRUE_STYLE: 'true-style',\n  GO_STYLE: 'goStyle',\n  ERROR_STYLE: 'errorStyle',\n  ONLY_ERROR: 'only-error',\n  BOOLEAN: 'boolean',\n} as const;\n\nexport type ReturnStyle = typeof RETURN_STYLES[keyof typeof RETURN_STYLES];\n\n// New: Explicit interface to ensure the returned function is generic\nexport interface AsyncWrappedFunction {\n  <T>(promise: Promise<T>): Promise<any>;\n}\n\nexport interface ConditionalHandler<T = any, E = any> {\n  ifTrue: (error: E) => boolean;\n  doIt: (error: E) => void;\n}\n\nexport interface AsyncHandlerConfig<T = any, E = any> {\n  returnStyle?: ReturnStyle;\n  conditionalHandlerChain?: ConditionalHandler<T, E>[];\n  defaultHandler?: (error: E) => any;\n}\n\nexport function createAsyncHandler<E = any>(config: AsyncHandlerConfig<any, E> = {}): AsyncWrappedFunction {\n  const {\n    returnStyle = RETURN_STYLES.GO_STYLE,\n    conditionalHandlerChain = [],\n    defaultHandler = (e: E) => { throw e; }\n  } = config;\n\n  // The implementation now strictly follows the generic interface\n  const handler: AsyncWrappedFunction = async function<T>(promise: Promise<T>): Promise<any> {\n    try {\n      const data = await promise;\n      switch (returnStyle) {\n        case RETURN_STYLES.GO_STYLE: return [null, data];\n        case RETURN_STYLES.ONLY_ERROR: return 0;\n        case RETURN_STYLES.BOOLEAN: return true;\n        default: return data;\n      }\n    } catch (error: any) {\n      let executedConditional = false;\n      for (const { ifTrue, doIt } of conditionalHandlerChain) {\n        if (ifTrue(error)) {\n          try { doIt(error); } catch (hErr) { }\n          executedConditional = true;\n          break;\n        }\n      }\n\n      switch (returnStyle) {\n        case RETURN_STYLES.GO_STYLE: return [error, null];\n        case RETURN_STYLES.ONLY_ERROR: return 1;\n        case RETURN_STYLES.BOOLEAN: return false;\n        case RETURN_STYLES.FALSE_STYLE:\n        case RETURN_STYLES.TRUE_STYLE:\n          if (!executedConditional) {\n            try { defaultHandler(error); } catch (hErr) { }\n          }\n          return returnStyle === RETURN_STYLES.FALSE_STYLE ? false : true;\n        case RETURN_STYLES.ERROR_STYLE: return error;\n        default:\n          if (!executedConditional) return defaultHandler(error);\n          throw error;\n      }\n    }\n  };\n\n  return handler;\n}\n","import { createAsyncHandler, RETURN_STYLES } from '../core.ts';\n\n// Internal handler typed for Go-style [Error, Data]\nconst internalHandler = createAsyncHandler({\n  returnStyle: RETURN_STYLES.GO_STYLE,\n});\n\ntype LogEntry = string | { fn: (...args: any[]) => void; params?: any[] };\ntype LogConfig = string | { error?: LogEntry; success?: LogEntry };\n\nfunction executeAction(entry: LogEntry | undefined, method: 'error' | 'log', payload?: any) {\n  if (!entry) return;\n  if (typeof entry === 'object' && typeof entry.fn === 'function') {\n    const params = Array.isArray(entry.params) ? entry.params : [];\n    entry.fn(...params);\n    return;\n  }\n  if (typeof entry === 'string') console[method](entry, payload || '');\n}\n\nfunction handleLog(config: LogConfig | undefined, type: 'error' | 'success', payload?: any) {\n  if (!config) return;\n  if (typeof config === 'string') {\n    if (type === 'error') executeAction(config, 'error', payload);\n    return;\n  }\n  if (type === 'error' && config.error) executeAction(config.error, 'error', payload);\n  else if (type === 'success' && config.success) executeAction(config.success, 'log');\n}\n\n/**\n * Returns the data <T> or false on failure.\n */\nexport async function valueOf<T>(promise: Promise<T>, config?: LogConfig): Promise<T | false> {\n  const [err, data] = await internalHandler<T>(promise);\n  if (err) { \n    handleLog(config, 'error', err); \n    return false; \n  }\n  handleLog(config, 'success');\n  return data as T;\n}\n\n/**\n * Returns true if the operation succeeded, false otherwise.\n */\nexport async function isSuccess(promise: Promise<any>, config?: LogConfig): Promise<boolean> {\n  const [err] = await internalHandler(promise);\n  if (err) { \n    handleLog(config, 'error', err); \n    return false; \n  }\n  handleLog(config, 'success');\n  return true;\n}\n\n/**\n * Returns an object { success, data, error }.\n * Safe for APIs that might return literal 'false' or 'null' as valid data.\n */\nexport async function toResult<T, E = any>(promise: Promise<T>, config?: LogConfig): Promise<{ success: boolean; data: T | null; error: E | null }> {\n  const [err, data] = await internalHandler<T>(promise);\n  if (err) {\n    handleLog(config, 'error', err);\n    return { success: false, data: null, error: err as E };\n  }\n  handleLog(config, 'success');\n  return { success: true, data: data as T, error: null };\n}\n"],"mappings":"+nBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,mBAAAE,EAAA,WAAAA,EAAA,cAAAC,EAAA,uBAAAC,EAAA,cAAAC,EAAA,aAAAC,EAAA,YAAAC,ICAO,IAAMC,EAAgB,CAC3B,YAAa,cACb,WAAY,aACZ,SAAU,UACV,YAAa,aACb,WAAY,aACZ,QAAS,SACX,EAoBO,SAASC,EAA4BC,EAAqC,CAAC,EAAyB,CACzG,GAAM,CACJ,YAAAC,EAAcH,EAAc,SAC5B,wBAAAI,EAA0B,CAAC,EAC3B,eAAAC,EAAkBC,GAAS,CAAE,MAAMA,CAAG,CACxC,EAAIJ,EAwCJ,OArCsC,SAAkBK,EAAmC,QAAAC,EAAA,sBACzF,GAAI,CACF,IAAMC,EAAO,MAAMF,EACnB,OAAQJ,EAAa,CACnB,KAAKH,EAAc,SAAU,MAAO,CAAC,KAAMS,CAAI,EAC/C,KAAKT,EAAc,WAAY,MAAO,GACtC,KAAKA,EAAc,QAAS,MAAO,GACnC,QAAS,OAAOS,CAClB,CACF,OAASC,EAAY,CACnB,IAAIC,EAAsB,GAC1B,OAAW,CAAE,OAAAC,EAAQ,KAAAC,CAAK,IAAKT,EAC7B,GAAIQ,EAAOF,CAAK,EAAG,CACjB,GAAI,CAAEG,EAAKH,CAAK,CAAG,OAASI,EAAM,CAAE,CACpCH,EAAsB,GACtB,KACF,CAGF,OAAQR,EAAa,CACnB,KAAKH,EAAc,SAAU,MAAO,CAACU,EAAO,IAAI,EAChD,KAAKV,EAAc,WAAY,MAAO,GACtC,KAAKA,EAAc,QAAS,MAAO,GACnC,KAAKA,EAAc,YACnB,KAAKA,EAAc,WACjB,GAAI,CAACW,EACH,GAAI,CAAEN,EAAeK,CAAK,CAAG,OAASI,EAAM,CAAE,CAEhD,OAAOX,IAAgBH,EAAc,YACvC,KAAKA,EAAc,YAAa,OAAOU,EACvC,QACE,GAAI,CAACC,EAAqB,OAAON,EAAeK,CAAK,EACrD,MAAMA,CACV,CACF,CACF,GAGF,CCtEA,IAAMK,EAAkBC,EAAmB,CACzC,YAAaC,EAAc,QAC7B,CAAC,EAKD,SAASC,EAAcC,EAA6BC,EAAyBC,EAAe,CAC1F,GAAKF,EACL,IAAI,OAAOA,GAAU,UAAY,OAAOA,EAAM,IAAO,WAAY,CAC/D,IAAMG,EAAS,MAAM,QAAQH,EAAM,MAAM,EAAIA,EAAM,OAAS,CAAC,EAC7DA,EAAM,GAAG,GAAGG,CAAM,EAClB,MACF,CACI,OAAOH,GAAU,UAAU,QAAQC,CAAM,EAAED,EAAOE,GAAW,EAAE,EACrE,CAEA,SAASE,EAAUC,EAA+BC,EAA2BJ,EAAe,CAC1F,GAAKG,EACL,IAAI,OAAOA,GAAW,SAAU,CAC1BC,IAAS,SAASP,EAAcM,EAAQ,QAASH,CAAO,EAC5D,MACF,CACII,IAAS,SAAWD,EAAO,MAAON,EAAcM,EAAO,MAAO,QAASH,CAAO,EACzEI,IAAS,WAAaD,EAAO,SAASN,EAAcM,EAAO,QAAS,KAAK,EACpF,CAKA,SAAsBE,EAAWC,EAAqBH,EAAwC,QAAAI,EAAA,sBAC5F,GAAM,CAACC,EAAKC,CAAI,EAAI,MAAMf,EAAmBY,CAAO,EACpD,OAAIE,GACFN,EAAUC,EAAQ,QAASK,CAAG,EACvB,KAETN,EAAUC,EAAQ,SAAS,EACpBM,EACT,GAKA,SAAsBC,EAAUJ,EAAuBH,EAAsC,QAAAI,EAAA,sBAC3F,GAAM,CAACC,CAAG,EAAI,MAAMd,EAAgBY,CAAO,EAC3C,OAAIE,GACFN,EAAUC,EAAQ,QAASK,CAAG,EACvB,KAETN,EAAUC,EAAQ,SAAS,EACpB,GACT,GAMA,SAAsBQ,EAAqBL,EAAqBH,EAAoF,QAAAI,EAAA,sBAClJ,GAAM,CAACC,EAAKC,CAAI,EAAI,MAAMf,EAAmBY,CAAO,EACpD,OAAIE,GACFN,EAAUC,EAAQ,QAASK,CAAG,EACvB,CAAE,QAAS,GAAO,KAAM,KAAM,MAAOA,CAAS,IAEvDN,EAAUC,EAAQ,SAAS,EACpB,CAAE,QAAS,GAAM,KAAMM,EAAW,MAAO,IAAK,EACvD,GF5CO,IAAMG,EAAY,CACvB,OAAQC,EACR,QAAAC,EACA,UAAAC,EACA,SAAAC,EACA,OAAQC,CACV","names":["src_exports","__export","RETURN_STYLES","WaitForMe","createAsyncHandler","isSuccess","toResult","valueOf","RETURN_STYLES","createAsyncHandler","config","returnStyle","conditionalHandlerChain","defaultHandler","e","promise","__async","data","error","executedConditional","ifTrue","doIt","hErr","internalHandler","createAsyncHandler","RETURN_STYLES","executeAction","entry","method","payload","params","handleLog","config","type","valueOf","promise","__async","err","data","isSuccess","toResult","WaitForMe","createAsyncHandler","valueOf","isSuccess","toResult","RETURN_STYLES"]}

package/dist/index.js

@@ -0,0 +1,2 @@
+var u=(r,n,e)=>new Promise((a,y)=>{var l=s=>{try{c(e.next(s))}catch(f){y(f)}},o=s=>{try{c(e.throw(s))}catch(f){y(f)}},c=s=>s.done?a(s.value):Promise.resolve(s.value).then(l,o);c((e=e.apply(r,n)).next())});var t={FALSE_STYLE:"false-style",TRUE_STYLE:"true-style",GO_STYLE:"goStyle",ERROR_STYLE:"errorStyle",ONLY_ERROR:"only-error",BOOLEAN:"boolean"};function E(r={}){let{returnStyle:n=t.GO_STYLE,conditionalHandlerChain:e=[],defaultHandler:a=l=>{throw l}}=r;return function(l){return u(this,null,function*(){try{let o=yield l;switch(n){case t.GO_STYLE:return[null,o];case t.ONLY_ERROR:return 0;case t.BOOLEAN:return!0;default:return o}}catch(o){let c=!1;for(let{ifTrue:s,doIt:f}of e)if(s(o)){try{f(o)}catch(p){}c=!0;break}switch(n){case t.GO_STYLE:return[o,null];case t.ONLY_ERROR:return 1;case t.BOOLEAN:return!1;case t.FALSE_STYLE:case t.TRUE_STYLE:if(!c)try{a(o)}catch(s){}return n!==t.FALSE_STYLE;case t.ERROR_STYLE:return o;default:if(!c)return a(o);throw o}}})}}var d=E({returnStyle:t.GO_STYLE});function T(r,n,e){if(r){if(typeof r=="object"&&typeof r.fn=="function"){let a=Array.isArray(r.params)?r.params:[];r.fn(...a);return}typeof r=="string"&&console[n](r,e||"")}}function i(r,n,e){if(r){if(typeof r=="string"){n==="error"&&T(r,"error",e);return}n==="error"&&r.error?T(r.error,"error",e):n==="success"&&r.success&&T(r.success,"log")}}function S(r,n){return u(this,null,function*(){let[e,a]=yield d(r);return e?(i(n,"error",e),!1):(i(n,"success"),a)})}function L(r,n){return u(this,null,function*(){let[e]=yield d(r);return e?(i(n,"error",e),!1):(i(n,"success"),!0)})}function R(r,n){return u(this,null,function*(){let[e,a]=yield d(r);return e?(i(n,"error",e),{success:!1,data:null,error:e}):(i(n,"success"),{success:!0,data:a,error:null})})}var N={create:E,valueOf:S,isSuccess:L,toResult:R,STYLES:t};export{t as RETURN_STYLES,t as STYLES,N as WaitForMe,E as createAsyncHandler,L as isSuccess,R as toResult,S as valueOf};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../await-me-ts/src/core.ts","../../await-me-ts/src/derivatives/index.ts","../src/index.ts"],"sourcesContent":["export const RETURN_STYLES = {\n  FALSE_STYLE: 'false-style',\n  TRUE_STYLE: 'true-style',\n  GO_STYLE: 'goStyle',\n  ERROR_STYLE: 'errorStyle',\n  ONLY_ERROR: 'only-error',\n  BOOLEAN: 'boolean',\n} as const;\n\nexport type ReturnStyle = typeof RETURN_STYLES[keyof typeof RETURN_STYLES];\n\n// New: Explicit interface to ensure the returned function is generic\nexport interface AsyncWrappedFunction {\n  <T>(promise: Promise<T>): Promise<any>;\n}\n\nexport interface ConditionalHandler<T = any, E = any> {\n  ifTrue: (error: E) => boolean;\n  doIt: (error: E) => void;\n}\n\nexport interface AsyncHandlerConfig<T = any, E = any> {\n  returnStyle?: ReturnStyle;\n  conditionalHandlerChain?: ConditionalHandler<T, E>[];\n  defaultHandler?: (error: E) => any;\n}\n\nexport function createAsyncHandler<E = any>(config: AsyncHandlerConfig<any, E> = {}): AsyncWrappedFunction {\n  const {\n    returnStyle = RETURN_STYLES.GO_STYLE,\n    conditionalHandlerChain = [],\n    defaultHandler = (e: E) => { throw e; }\n  } = config;\n\n  // The implementation now strictly follows the generic interface\n  const handler: AsyncWrappedFunction = async function<T>(promise: Promise<T>): Promise<any> {\n    try {\n      const data = await promise;\n      switch (returnStyle) {\n        case RETURN_STYLES.GO_STYLE: return [null, data];\n        case RETURN_STYLES.ONLY_ERROR: return 0;\n        case RETURN_STYLES.BOOLEAN: return true;\n        default: return data;\n      }\n    } catch (error: any) {\n      let executedConditional = false;\n      for (const { ifTrue, doIt } of conditionalHandlerChain) {\n        if (ifTrue(error)) {\n          try { doIt(error); } catch (hErr) { }\n          executedConditional = true;\n          break;\n        }\n      }\n\n      switch (returnStyle) {\n        case RETURN_STYLES.GO_STYLE: return [error, null];\n        case RETURN_STYLES.ONLY_ERROR: return 1;\n        case RETURN_STYLES.BOOLEAN: return false;\n        case RETURN_STYLES.FALSE_STYLE:\n        case RETURN_STYLES.TRUE_STYLE:\n          if (!executedConditional) {\n            try { defaultHandler(error); } catch (hErr) { }\n          }\n          return returnStyle === RETURN_STYLES.FALSE_STYLE ? false : true;\n        case RETURN_STYLES.ERROR_STYLE: return error;\n        default:\n          if (!executedConditional) return defaultHandler(error);\n          throw error;\n      }\n    }\n  };\n\n  return handler;\n}\n","import { createAsyncHandler, RETURN_STYLES } from '../core.ts';\n\n// Internal handler typed for Go-style [Error, Data]\nconst internalHandler = createAsyncHandler({\n  returnStyle: RETURN_STYLES.GO_STYLE,\n});\n\ntype LogEntry = string | { fn: (...args: any[]) => void; params?: any[] };\ntype LogConfig = string | { error?: LogEntry; success?: LogEntry };\n\nfunction executeAction(entry: LogEntry | undefined, method: 'error' | 'log', payload?: any) {\n  if (!entry) return;\n  if (typeof entry === 'object' && typeof entry.fn === 'function') {\n    const params = Array.isArray(entry.params) ? entry.params : [];\n    entry.fn(...params);\n    return;\n  }\n  if (typeof entry === 'string') console[method](entry, payload || '');\n}\n\nfunction handleLog(config: LogConfig | undefined, type: 'error' | 'success', payload?: any) {\n  if (!config) return;\n  if (typeof config === 'string') {\n    if (type === 'error') executeAction(config, 'error', payload);\n    return;\n  }\n  if (type === 'error' && config.error) executeAction(config.error, 'error', payload);\n  else if (type === 'success' && config.success) executeAction(config.success, 'log');\n}\n\n/**\n * Returns the data <T> or false on failure.\n */\nexport async function valueOf<T>(promise: Promise<T>, config?: LogConfig): Promise<T | false> {\n  const [err, data] = await internalHandler<T>(promise);\n  if (err) { \n    handleLog(config, 'error', err); \n    return false; \n  }\n  handleLog(config, 'success');\n  return data as T;\n}\n\n/**\n * Returns true if the operation succeeded, false otherwise.\n */\nexport async function isSuccess(promise: Promise<any>, config?: LogConfig): Promise<boolean> {\n  const [err] = await internalHandler(promise);\n  if (err) { \n    handleLog(config, 'error', err); \n    return false; \n  }\n  handleLog(config, 'success');\n  return true;\n}\n\n/**\n * Returns an object { success, data, error }.\n * Safe for APIs that might return literal 'false' or 'null' as valid data.\n */\nexport async function toResult<T, E = any>(promise: Promise<T>, config?: LogConfig): Promise<{ success: boolean; data: T | null; error: E | null }> {\n  const [err, data] = await internalHandler<T>(promise);\n  if (err) {\n    handleLog(config, 'error', err);\n    return { success: false, data: null, error: err as E };\n  }\n  handleLog(config, 'success');\n  return { success: true, data: data as T, error: null };\n}\n","import { \n  createAsyncHandler, \n  RETURN_STYLES, \n  valueOf, \n  isSuccess, \n  toResult \n} from 'await-me-ts';\n\n/**\n * Symmetric Reflection: \n * We export the exact functions from the core engine.\n */\nexport {\n  createAsyncHandler,\n  valueOf,\n  isSuccess,\n  toResult,\n  RETURN_STYLES as STYLES // Alias for convenience, while keeping core name\n};\n\n/**\n * Optional: The Barrel Namespace\n * Provides the same symmetry for those who prefer dot-notation.\n */\nexport const WaitForMe = {\n  create: createAsyncHandler,\n  valueOf,\n  isSuccess,\n  toResult,\n  STYLES: RETURN_STYLES\n} as const;\n\n// Re-export all types from core for full IDE support\nexport * from 'await-me-ts';\n"],"mappings":"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","names":["RETURN_STYLES","createAsyncHandler","config","returnStyle","conditionalHandlerChain","defaultHandler","e","promise","__async","data","error","executedConditional","ifTrue","doIt","hErr","internalHandler","createAsyncHandler","RETURN_STYLES","executeAction","entry","method","payload","params","handleLog","config","type","valueOf","promise","__async","err","data","isSuccess","toResult","WaitForMe","createAsyncHandler","valueOf","isSuccess","toResult","RETURN_STYLES"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "await-me",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Browser-compatible, ES2015 target distribution of await-me-ts. Supports Node.js 7+.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -10,6 +10,23 @@
   "engines": {
     "node": ">=7.0.0"
   },
+  "browserslist": [
+    "defaults and fully supports es6-module",
+    "maintained node versions",
+    "not dead"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "async",
+    "error-handling",
+    "browser",
+    "node",
+    "legacy-support",
+    "promises"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",

package/example.cjs

@@ -1,54 +0,0 @@
-const { WaitForMe } = require('./dist/index.cjs');
-
-// --- Mock Utilities ---
-const mockFetch = (shouldSucceed, data, errorCode) => 
-    new Promise((resolve, reject) => {
-        setTimeout(() => {
-            if (shouldSucceed) {
-                resolve(data);
-            } else {
-                const error = new Error("Request Failed");
-                error.code = errorCode || 500;
-                reject(error);
-            }
-        }, 50);
-    });
-
-async function runAdHocTest() {
-    console.log("🚀 Starting Ad-Hoc Test for await-me Bundle\n");
-
-    // 1. Test the Barrel Class Constants
-    console.log(`Checking STYLES: ${Object.keys(WaitForMe.STYLES).join(', ')}`);
-
-    // 2. Test the "Safe" Handler (FALSE_STYLE)
-    const safeFetcher = WaitForMe.create({
-        returnStyle: WaitForMe.STYLES.FALSE_STYLE,
-        defaultHandler: (e) => console.log(`[Shield] Caught expected error: ${e.message}`)
-    });
-
-    console.log("\nScenario A: Successful Data Fetch");
-    const data = await safeFetcher(mockFetch(true, { id: 42, name: "Gemini" }));
-    console.log(`Result: ${JSON.stringify(data)} (Success expected)`);
-
-    console.log("\nScenario B: Shielded Error (500)");
-    const failedResult = await safeFetcher(mockFetch(false));
-    console.log(`Result: ${failedResult} (Boolean 'false' expected)`);
-
-    // 3. Test the Derivative 'valueOf'
-    console.log("\nScenario C: Using valueOf Derivative");
-    const value = await WaitForMe.valueOf(mockFetch(true, "Direct Value"));
-    console.log(`Value: ${value}`);
-
-    // 4. Test Go-Style handling via Barrel
-    const goHandler = WaitForMe.create({ returnStyle: WaitForMe.STYLES.GO_STYLE });
-    const [err, result] = await goHandler(mockFetch(false, null, 401));
-    
-    if (err) {
-        console.log(`\nScenario D: Go-Style Error Check`);
-        console.log(`Error Code: ${err.code} - Handled successfully without try/catch.`);
-    }
-
-    console.log("\n✅ Ad-Hoc Test Completed.");
-}
-
-runAdHocTest().catch(console.error);

package/example.js

@@ -1,54 +0,0 @@
-import { WaitForMe } from './dist/index.js';
-
-// --- Mock Utilities ---
-const mockFetch = (shouldSucceed, data, errorCode) => 
-    new Promise((resolve, reject) => {
-        setTimeout(() => {
-            if (shouldSucceed) {
-                resolve(data);
-            } else {
-                const error = new Error("Request Failed");
-                error.code = errorCode || 500;
-                reject(error);
-            }
-        }, 50);
-    });
-
-async function runAdHocTest() {
-    console.log("🚀 Starting Ad-Hoc Test for await-me Bundle\n");
-
-    // 1. Test the Barrel Class Constants
-    console.log(`Checking STYLES: ${Object.keys(WaitForMe.STYLES).join(', ')}`);
-
-    // 2. Test the "Safe" Handler (FALSE_STYLE)
-    const safeFetcher = WaitForMe.create({
-        returnStyle: WaitForMe.STYLES.FALSE_STYLE,
-        defaultHandler: (e) => console.log(`[Shield] Caught expected error: ${e.message}`)
-    });
-
-    console.log("\nScenario A: Successful Data Fetch");
-    const data = await safeFetcher(mockFetch(true, { id: 42, name: "Gemini" }));
-    console.log(`Result: ${JSON.stringify(data)} (Success expected)`);
-
-    console.log("\nScenario B: Shielded Error (500)");
-    const failedResult = await safeFetcher(mockFetch(false));
-    console.log(`Result: ${failedResult} (Boolean 'false' expected)`);
-
-    // 3. Test the Derivative 'valueOf'
-    console.log("\nScenario C: Using valueOf Derivative");
-    const value = await WaitForMe.valueOf(mockFetch(true, "Direct Value"));
-    console.log(`Value: ${value}`);
-
-    // 4. Test Go-Style handling via Barrel
-    const goHandler = WaitForMe.create({ returnStyle: WaitForMe.STYLES.GO_STYLE });
-    const [err, result] = await goHandler(mockFetch(false, null, 401));
-    
-    if (err) {
-        console.log(`\nScenario D: Go-Style Error Check`);
-        console.log(`Error Code: ${err.code} - Handled successfully without try/catch.`);
-    }
-
-    console.log("\n✅ Ad-Hoc Test Completed.");
-}
-
-runAdHocTest().catch(console.error);

package/src/index.ts

@@ -1,34 +0,0 @@
-import { 
-  createAsyncHandler, 
-  RETURN_STYLES, 
-  valueOf, 
-  isSuccess, 
-  toResult 
-} from 'await-me-ts';
-
-/**
- * Symmetric Reflection: 
- * We export the exact functions from the core engine.
- */
-export {
-  createAsyncHandler,
-  valueOf,
-  isSuccess,
-  toResult,
-  RETURN_STYLES as STYLES // Alias for convenience, while keeping core name
-};
-
-/**
- * Optional: The Barrel Namespace
- * Provides the same symmetry for those who prefer dot-notation.
- */
-export const WaitForMe = {
-  create: createAsyncHandler,
-  valueOf,
-  isSuccess,
-  toResult,
-  STYLES: RETURN_STYLES
-} as const;
-
-// Re-export all types from core for full IDE support
-export * from 'await-me-ts';

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "outDir": "dist",
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": false,
-    "skipLibCheck": true,
-    "declaration": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist" ,"public"]
-}

package/tsup.config.ts

@@ -1,21 +0,0 @@
-import { defineConfig } from 'tsup';
-
-export default defineConfig({
-  entry: {
-    'index': 'src/index.ts'
-  },
-  // Added 'iife' for direct <script> tag support in browsers
-  format: ['cjs', 'esm', 'iife'], 
-  globalName: 'WaitForMeJS',
-  dts: true,
-  splitting: false,
-  sourcemap: true,
-  clean: true,
-  outDir: 'dist',
-  // Lowered target to ES2015 for maximum compatibility
-  target: 'es2015',
-  minify: true,
-  bundle: true,
-  noExternal: ['await-me-ts'], 
-  skipNodeModulesBundle: false, 
-});