@adriangalilea/utils 0.4.1 → 0.5.0

package/README.md

@@ -107,12 +107,14 @@ format.percentage(123.456)  // "123%"
 
 ### Offensive Programming
 
-Fail loud, fail fast. All primitives throw `Panic` — an uncaught `Panic` crashes the process with a full stack trace. Zero dependencies, works identically in Node, Deno, Bun, and browsers.
+Fail loud, fail fast. Zero dependencies, works in Node, Deno, Bun, and browsers.
+
+Two kinds of errors, kept separate: **`Panic`** (bugs in us — crash the process) and **`SourcedError`** (boundary failures — handle per-source).
 
 ```typescript
-import { assert, panic, must, unwrap, Panic } from '@adriangalilea/utils'
+import { assert, panic, assertNever, must, unwrap, Panic, SourcedError, isSourcedError } from '@adriangalilea/utils'
 
-// Assert invariants — narrows types
+// Assert invariants — narrows types via `asserts condition`
 assert(port > 0 && port < 65536, 'invalid port:', port)
 
 // Impossible state
@@ -121,33 +123,66 @@ switch (state) {
   default: panic('impossible state:', state)
 }
 
+// Exhaustiveness check — TS compile error if you miss a case
+type Event = { kind: 'click' } | { kind: 'hover' } | { kind: 'scroll' }
+function handle(e: Event) {
+  switch (e.kind) {
+    case 'click': return handleClick()
+    case 'hover': return handleHover()
+    // forgot 'scroll' → TS error: Argument of type '{ kind: "scroll" }' not assignable to 'never'
+    default: return assertNever(e)
+  }
+}
+// Add a new variant to Event → every assertNever site lights up at compile time.
+
 // Unwrap operations that shouldn't fail (sync + async)
 const data = must(() => JSON.parse(staticJsonString))
 const file = must(() => readFileSync(path))
 const resp = await must(() => fetch(url))
 
-// Unwrap nullable values — type narrows T | null | undefined → T in one expression
-// (assert needs two statements, unwrap does it inline)
+// Unwrap nullable values — T | null | undefined → T in one expression
 const user = unwrap(db.findUser(id), 'user not found:', id)
 const el = unwrap(document.getElementById('app'))
+```
+
+#### Typed boundary errors — `SourcedError`
+
+Every external system call should wear its source. When it fails, carry forensics:
 
-// must() replaces try/catch boilerplate:
-//   try { return readFileSync(path, 'utf-8') }
-//   catch (err) { check(err) }
-// becomes:
-return must(() => readFileSync(path, 'utf-8'))
-
-// Panic is a distinct error class — distinguishes bugs from runtime errors
-// In a server: let Panics crash, handle everything else
-app.use((err, req, res, next) => {
-  if (err instanceof Panic) throw err  // bug, re-throw, let it crash
-  res.status(500).json({ error: 'internal error' })
-})
-
-// In tests: assert that code panics
-expect(() => assert(false, 'boom')).toThrow(Panic)
+```typescript
+import { SourcedError, isSourcedError, Panic } from '@adriangalilea/utils'
+
+try {
+  return await stripe.charges.create({ customer, amount })
+} catch (e) {
+  throw new SourcedError({
+    source: 'stripe',
+    operation: 'charge_customer',
+    message: e instanceof Error ? e.message : String(e),
+    status: (e as any)?.statusCode,
+    cause: e,
+    context: { customer, amount },
+  })
+}
+
+// At catch boundaries — keep Panics and SourcedErrors separate:
+try { await doWork() }
+catch (e) {
+  if (e instanceof Panic) throw e                            // bug in us — crash
+  if (isSourcedError(e, 'stripe') && e.status === 402) {
+    // TS knows e.source === 'stripe' here (generic narrows)
+    return { error: 'card declined' }
+  }
+  if (isSourcedError(e)) {
+    logger.error(`[${e.source}:${e.operation}]`, e.toJSON())  // structured forensics
+    throw e
+  }
+  throw e                                                     // unknown — re-throw
+}
 ```
 
+Every `SourcedError` carries `source`, `operation`, `status`, `context`, and the original exception via `cause`. Call `.toJSON()` for serialization across process boundaries.
+
 ## Features
 
 - **Logger**: Next.js-style colored console output with symbols
@@ -158,7 +193,7 @@ expect(() => assert(false, 'boom')).toThrow(Panic)
   - Percentage and basis point utilities
   - Fiat and stablecoin detection
 - **Format**: Number and currency formatting with compact notation
-- **Offensive Programming**: assert, panic, must, unwrap — all throw `Panic` with full stack traces
+- **Offensive Programming**: assert, panic, assertNever, must, unwrap (throw `Panic`) + SourcedError for typed boundary failures
 - **File Operations**: Read, write with automatic path resolution
 - **Directory Operations**: Create, list, walk directories
 - **KEV**: Redis-style environment variable management with monorepo support

package/dist/offensive.d.ts

@@ -1,29 +1,31 @@
 /**
- * OFFENSIVE PROGRAMMING PRIMITIVES
+ * Offensive programming primitives + typed boundary errors.
  *
- * "A confused program SHOULD scream" - John Carmack
+ * "A confused program SHOULD scream." — John Carmack
  *
  * Throw, always. An uncaught Panic crashes the process with a full stack trace.
  * Zero dependencies. Works identically in Node, Deno, Bun, and browsers.
  *
- * Four primitives:
- *   assert(cond, ...msg)   - invariant checking, narrows types
- *   panic(...msg)          - impossible state reached
- *   must(() => expr)       - unwrap-or-die for operations (sync + async)
- *   unwrap(value, ...msg)  - unwrap nullable values
+ * Fail-fast primitives (throw Panic — bugs in us):
+ *   assert(cond, ...msg)          invariant checking, narrows types via `asserts`
+ *   panic(...msg)                 impossible state reached
+ *   assertNever(value, ...msg)    exhaustiveness check — compile error on missed cases
+ *   must(() => expr)              unwrap-or-die for operations (sync + async)
+ *   unwrap(value, ...msg)         unwrap nullable T | null | undefined → T
  *
- * must() replaces the old try/catch/check pattern:
+ * Typed boundary errors (throw SourcedError — the external system failed):
+ *   SourcedError                  typed error with source/operation/status/context
+ *   isSourcedError(e, source?)    type guard for catch-site narrowing
  *
- *   // before: 5 lines
- *   try {
- *     const data = readFileSync(path, 'utf-8')
- *     return data
- *   } catch (err) {
- *     check(err)
- *   }
+ * Panics are bugs. SourcedErrors are boundary failures. Keep them separate at
+ * catch boundaries:
  *
- *   // after: 1 line
- *   return must(() => readFileSync(path, 'utf-8'))
+ *   try { await doWork() }
+ *   catch (e) {
+ *     if (e instanceof Panic) throw e            // bug in us — crash
+ *     if (isSourcedError(e, 'stripe')) { ... }   // stripe failed — handle
+ *     throw e                                    // unknown — re-throw
+ *   }
  */
 /**
  * Distinct error class for offensive programming failures.
@@ -61,6 +63,23 @@ export declare function assert(condition: boolean, ...msg: any[]): asserts condi
  * }
  */
 export declare function panic(...msg: any[]): never;
+/**
+ * Exhaustiveness check — compile error if a switch/if misses a case.
+ * The `never` type means TS won't let you call this if all cases are handled.
+ * Add a new variant to a union → every assertNever site lights up at compile time.
+ *
+ * @example
+ * type Event = { kind: 'click' } | { kind: 'hover' } | { kind: 'scroll' }
+ * function handle(e: Event) {
+ *   switch (e.kind) {
+ *     case 'click': return handleClick()
+ *     case 'hover': return handleHover()
+ *     // forgot 'scroll' → TS error: Argument of type '{ kind: "scroll" }' not assignable to 'never'
+ *     default: assertNever(e)
+ *   }
+ * }
+ */
+export declare function assertNever(value: never, ...msg: any[]): never;
 /**
  * Must unwraps an operation that should never fail. Handles sync and async.
  *
@@ -85,11 +104,64 @@ export declare function must<T>(fn: () => T): T;
  * const el = unwrap(document.getElementById('app'))
  */
 export declare function unwrap<T>(value: T | null | undefined, ...msg: any[]): T;
+/**
+ * Typed error from a named external source with structured context.
+ *
+ * Raise at boundaries with the messy world (HTTP APIs, databases, external
+ * processes). Every SourcedError carries enough context to reconstruct the
+ * failure without a debugger.
+ *
+ * @example
+ * try {
+ *   return await stripe.charges.create({ customer, amount })
+ * } catch (e) {
+ *   throw new SourcedError({
+ *     source: 'stripe',
+ *     operation: 'charge_customer',
+ *     message: e instanceof Error ? e.message : String(e),
+ *     status: (e as any)?.statusCode,
+ *     cause: e,
+ *     context: { customer, amount },
+ *   })
+ * }
+ */
+export declare class SourcedError<S extends string = string> extends Error {
+    readonly source: S;
+    readonly operation: string;
+    readonly status?: number;
+    readonly context: Record<string, unknown>;
+    constructor(args: {
+        source: S;
+        operation: string;
+        message: string;
+        status?: number;
+        cause?: unknown;
+        context?: Record<string, unknown>;
+    });
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Type guard for SourcedError. Optionally narrows to a specific source.
+ *
+ * @example
+ * try { await charge(customer, amount) }
+ * catch (e) {
+ *   if (isSourcedError(e, 'stripe') && e.status === 402) {
+ *     // TS knows e.source === 'stripe' here
+ *     return 'card declined'
+ *   }
+ *   throw e
+ * }
+ */
+export declare function isSourcedError<S extends string>(e: unknown, source?: S): e is SourcedError<S>;
 export declare const offensive: {
     Panic: typeof Panic;
     assert: typeof assert;
     panic: typeof panic;
+    assertNever: typeof assertNever;
     must: typeof must;
     unwrap: typeof unwrap;
+    SourcedError: typeof SourcedError;
+    isSourcedError: typeof isSourcedError;
 };
 //# sourceMappingURL=offensive.d.ts.map

package/dist/offensive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offensive.d.ts","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,SAAQ,KAAK;gBAClB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;AAevC;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAGvE;AAED,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAA"}
+{"version":3,"file":"offensive.d.ts","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,SAAQ,KAAK;gBAClB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACzD,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;AAevC;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAGvE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE7B,IAAI,EAAE;QAChB,MAAM,EAAE,CAAC,CAAA;QACT,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC;IAUD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAE7F;AAED,eAAO,MAAM,SAAS;;;;;;;;;CASrB,CAAA"}

package/dist/offensive.js

@@ -1,29 +1,31 @@
 /**
- * OFFENSIVE PROGRAMMING PRIMITIVES
+ * Offensive programming primitives + typed boundary errors.
  *
- * "A confused program SHOULD scream" - John Carmack
+ * "A confused program SHOULD scream." — John Carmack
  *
  * Throw, always. An uncaught Panic crashes the process with a full stack trace.
  * Zero dependencies. Works identically in Node, Deno, Bun, and browsers.
  *
- * Four primitives:
- *   assert(cond, ...msg)   - invariant checking, narrows types
- *   panic(...msg)          - impossible state reached
- *   must(() => expr)       - unwrap-or-die for operations (sync + async)
- *   unwrap(value, ...msg)  - unwrap nullable values
+ * Fail-fast primitives (throw Panic — bugs in us):
+ *   assert(cond, ...msg)          invariant checking, narrows types via `asserts`
+ *   panic(...msg)                 impossible state reached
+ *   assertNever(value, ...msg)    exhaustiveness check — compile error on missed cases
+ *   must(() => expr)              unwrap-or-die for operations (sync + async)
+ *   unwrap(value, ...msg)         unwrap nullable T | null | undefined → T
  *
- * must() replaces the old try/catch/check pattern:
+ * Typed boundary errors (throw SourcedError — the external system failed):
+ *   SourcedError                  typed error with source/operation/status/context
+ *   isSourcedError(e, source?)    type guard for catch-site narrowing
  *
- *   // before: 5 lines
- *   try {
- *     const data = readFileSync(path, 'utf-8')
- *     return data
- *   } catch (err) {
- *     check(err)
- *   }
+ * Panics are bugs. SourcedErrors are boundary failures. Keep them separate at
+ * catch boundaries:
  *
- *   // after: 1 line
- *   return must(() => readFileSync(path, 'utf-8'))
+ *   try { await doWork() }
+ *   catch (e) {
+ *     if (e instanceof Panic) throw e            // bug in us — crash
+ *     if (isSourcedError(e, 'stripe')) { ... }   // stripe failed — handle
+ *     throw e                                    // unknown — re-throw
+ *   }
  */
 /**
  * Distinct error class for offensive programming failures.
@@ -69,6 +71,25 @@ export function assert(condition, ...msg) {
 export function panic(...msg) {
     throw new Panic(msg.join(' ') || 'panic');
 }
+/**
+ * Exhaustiveness check — compile error if a switch/if misses a case.
+ * The `never` type means TS won't let you call this if all cases are handled.
+ * Add a new variant to a union → every assertNever site lights up at compile time.
+ *
+ * @example
+ * type Event = { kind: 'click' } | { kind: 'hover' } | { kind: 'scroll' }
+ * function handle(e: Event) {
+ *   switch (e.kind) {
+ *     case 'click': return handleClick()
+ *     case 'hover': return handleHover()
+ *     // forgot 'scroll' → TS error: Argument of type '{ kind: "scroll" }' not assignable to 'never'
+ *     default: assertNever(e)
+ *   }
+ * }
+ */
+export function assertNever(value, ...msg) {
+    throw new Panic(msg.join(' ') || `assertNever: unexpected value: ${JSON.stringify(value)}`);
+}
 export function must(fn) {
     try {
         const result = fn();
@@ -101,11 +122,76 @@ export function unwrap(value, ...msg) {
         throw new Panic(msg.join(' ') || `unwrap: got ${value}`);
     return value;
 }
+/**
+ * Typed error from a named external source with structured context.
+ *
+ * Raise at boundaries with the messy world (HTTP APIs, databases, external
+ * processes). Every SourcedError carries enough context to reconstruct the
+ * failure without a debugger.
+ *
+ * @example
+ * try {
+ *   return await stripe.charges.create({ customer, amount })
+ * } catch (e) {
+ *   throw new SourcedError({
+ *     source: 'stripe',
+ *     operation: 'charge_customer',
+ *     message: e instanceof Error ? e.message : String(e),
+ *     status: (e as any)?.statusCode,
+ *     cause: e,
+ *     context: { customer, amount },
+ *   })
+ * }
+ */
+export class SourcedError extends Error {
+    source;
+    operation;
+    status;
+    context;
+    constructor(args) {
+        const status = args.status != null ? ` status=${args.status}` : '';
+        super(`[${args.source}:${args.operation}${status}] ${args.message}`, { cause: args.cause });
+        this.name = 'SourcedError';
+        this.source = args.source;
+        this.operation = args.operation;
+        this.status = args.status;
+        this.context = args.context ?? {};
+    }
+    toJSON() {
+        return {
+            source: this.source,
+            operation: this.operation,
+            status: this.status,
+            message: this.message,
+            context: this.context,
+            cause: this.cause instanceof Error ? this.cause.message : this.cause != null ? String(this.cause) : null,
+        };
+    }
+}
+/**
+ * Type guard for SourcedError. Optionally narrows to a specific source.
+ *
+ * @example
+ * try { await charge(customer, amount) }
+ * catch (e) {
+ *   if (isSourcedError(e, 'stripe') && e.status === 402) {
+ *     // TS knows e.source === 'stripe' here
+ *     return 'card declined'
+ *   }
+ *   throw e
+ * }
+ */
+export function isSourcedError(e, source) {
+    return e instanceof SourcedError && (source === undefined || e.source === source);
+}
 export const offensive = {
     Panic,
     assert,
     panic,
+    assertNever,
     must,
     unwrap,
+    SourcedError,
+    isSourcedError,
 };
 //# sourceMappingURL=offensive.js.map

package/dist/offensive.js.map

@@ -1 +1 @@
-{"version":3,"file":"offensive.js","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAM,SAAQ,KAAK;IAC9B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,OAAO,CAAA;IACrB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,GAAG,GAAU;IACtD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,GAAG,GAAU;IACjC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAA;AAC3C,CAAC;AAYD,MAAM,UAAU,IAAI,CAAI,EAAwB;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAA;QACnB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACtB,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAI,KAA2B,EAAE,GAAG,GAAU;IAClE,IAAI,KAAK,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,KAAK,EAAE,CAAC,CAAA;IAC3E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK;IACL,MAAM;IACN,KAAK;IACL,IAAI;IACJ,MAAM;CACP,CAAA"}
+{"version":3,"file":"offensive.js","sourceRoot":"","sources":["../src/offensive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,KAAM,SAAQ,KAAK;IAC9B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,OAAO,CAAA;IACrB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,GAAG,GAAU;IACtD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAA;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,KAAK,CAAC,GAAG,GAAU;IACjC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAA;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,GAAG,GAAU;IACrD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kCAAkC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAC7F,CAAC;AAYD,MAAM,UAAU,IAAI,CAAI,EAAwB;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAA;QACnB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACtB,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7D,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAI,KAA2B,EAAE,GAAG,GAAU;IAClE,IAAI,KAAK,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,KAAK,EAAE,CAAC,CAAA;IAC3E,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,YAAwC,SAAQ,KAAK;IACvD,MAAM,CAAG;IACT,SAAS,CAAQ;IACjB,MAAM,CAAS;IACf,OAAO,CAAyB;IAEzC,YAAY,IAOX;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAClE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAC3F,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;IACnC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;SACzG,CAAA;IACH,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAmB,CAAU,EAAE,MAAU;IACrE,OAAO,CAAC,YAAY,YAAY,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;AACnF,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK;IACL,MAAM;IACN,KAAK;IACL,WAAW;IACX,IAAI;IACJ,MAAM;IACN,YAAY;IACZ,cAAc;CACf,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adriangalilea/utils",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "TypeScript utilities - logger, currency, formatter, and more",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",