@parsrun/core 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# @parsrun/core
+
+> Core utilities and types for the Pars framework - Edge compatible.
+
+## Features
+
+- **Logger** - Structured logging with child loggers
+- **Errors** - Standardized error classes with codes
+- **Runtime Detection** - Detect Node, Cloudflare, Deno, Bun
+- **Environment** - Type-safe environment variable access
+- **Utilities** - Common helpers (ID generation, crypto, etc.)
+
+## Installation
+
+```bash
+pnpm add @parsrun/core
+```
+
+## Usage
+
+### Logger
+
+```typescript
+import { createLogger } from "@parsrun/core/logger";
+
+const logger = createLogger({ name: "my-service" });
+
+logger.info("User logged in", { userId: "123" });
+logger.error("Failed to process", new Error("timeout"), { requestId: "abc" });
+
+// Child logger
+const childLogger = logger.child({ module: "auth" });
+childLogger.debug("Token validated");
+```
+
+### Errors
+
+```typescript
+import { ParsError, createError, isRetryable } from "@parsrun/core/errors";
+
+// Create error
+throw new ParsError("User not found", "USER_NOT_FOUND", 404, {
+  userId: "123",
+});
+
+// Check if error is retryable
+if (isRetryable(error)) {
+  await retry();
+}
+```
+
+### Runtime Detection
+
+```typescript
+import { detectRuntime, isEdgeRuntime } from "@parsrun/core/runtime";
+
+const runtime = detectRuntime(); // "node" | "cloudflare" | "deno" | "bun"
+
+if (isEdgeRuntime()) {
+  // Edge-specific code
+}
+```
+
+### Environment
+
+```typescript
+import { getEnv, requireEnv, EnvSchema } from "@parsrun/core/env";
+
+// Get with fallback
+const port = getEnv("PORT", "3000");
+
+// Required (throws if missing)
+const secret = requireEnv("AUTH_SECRET");
+
+// Typed schema
+const env = EnvSchema.parse({
+  DATABASE_URL: requireEnv("DATABASE_URL"),
+  REDIS_URL: getEnv("REDIS_URL"),
+});
+```
+
+### Utilities
+
+```typescript
+import { generateId, sleep, retry } from "@parsrun/core";
+
+// Generate unique ID
+const id = generateId(); // "abc123xyz..."
+
+// Sleep
+await sleep(1000);
+
+// Retry with backoff
+const result = await retry(
+  async () => fetchData(),
+  { attempts: 3, delay: 100 }
+);
+```
+
+## Sub-path Imports
+
+```typescript
+import { createLogger } from "@parsrun/core/logger";
+import { ParsError } from "@parsrun/core/errors";
+import { detectRuntime } from "@parsrun/core/runtime";
+import { getEnv } from "@parsrun/core/env";
+import { Decimal } from "@parsrun/core/decimal";
+import { ERROR_CODES } from "@parsrun/core/error-codes";
+```
+
+## License
+
+MIT

package/dist/decimal.d.ts

@@ -0,0 +1,190 @@
+/**
+ * @parsrun/core - Decimal Utilities
+ * Precise decimal calculations for financial and quantity operations
+ * Edge-compatible - no external dependencies
+ */
+/**
+ * Decimal class for precise arithmetic
+ * Uses string-based arithmetic to avoid floating point issues
+ */
+declare class Decimal {
+    private value;
+    constructor(value: number | string | Decimal);
+    private normalizeNumber;
+    private normalizeString;
+    /**
+     * Add two decimals
+     */
+    add(other: number | string | Decimal): Decimal;
+    /**
+     * Subtract
+     */
+    sub(other: number | string | Decimal): Decimal;
+    /**
+     * Multiply
+     */
+    mul(other: number | string | Decimal): Decimal;
+    /**
+     * Divide
+     */
+    div(other: number | string | Decimal): Decimal;
+    /**
+     * Modulo
+     */
+    mod(other: number | string | Decimal): Decimal;
+    /**
+     * Power
+     */
+    pow(exp: number): Decimal;
+    /**
+     * Square root
+     */
+    sqrt(): Decimal;
+    /**
+     * Absolute value
+     */
+    abs(): Decimal;
+    /**
+     * Negate
+     */
+    neg(): Decimal;
+    /**
+     * Round to decimal places
+     */
+    round(decimals?: number): Decimal;
+    /**
+     * Floor to decimal places
+     */
+    floor(decimals?: number): Decimal;
+    /**
+     * Ceiling to decimal places
+     */
+    ceil(decimals?: number): Decimal;
+    /**
+     * Compare: returns -1, 0, or 1
+     */
+    cmp(other: number | string | Decimal): -1 | 0 | 1;
+    /**
+     * Equality check
+     */
+    eq(other: number | string | Decimal): boolean;
+    /**
+     * Greater than
+     */
+    gt(other: number | string | Decimal): boolean;
+    /**
+     * Greater than or equal
+     */
+    gte(other: number | string | Decimal): boolean;
+    /**
+     * Less than
+     */
+    lt(other: number | string | Decimal): boolean;
+    /**
+     * Less than or equal
+     */
+    lte(other: number | string | Decimal): boolean;
+    /**
+     * Check if zero
+     */
+    isZero(): boolean;
+    /**
+     * Check if positive
+     */
+    isPositive(): boolean;
+    /**
+     * Check if negative
+     */
+    isNegative(): boolean;
+    /**
+     * Convert to number
+     */
+    toNumber(): number;
+    /**
+     * Convert to string
+     */
+    toString(): string;
+    /**
+     * Format with fixed decimal places
+     */
+    toFixed(decimals?: number): string;
+    /**
+     * Convert to JSON (string representation)
+     */
+    toJSON(): string;
+    /**
+     * Static: Create from value
+     */
+    static from(value: number | string | Decimal): Decimal;
+    /**
+     * Static: Sum array of values
+     */
+    static sum(values: (number | string | Decimal)[]): Decimal;
+    /**
+     * Static: Average of array
+     */
+    static avg(values: (number | string | Decimal)[]): Decimal;
+    /**
+     * Static: Min of array
+     */
+    static min(...values: (number | string | Decimal)[]): Decimal;
+    /**
+     * Static: Max of array
+     */
+    static max(...values: (number | string | Decimal)[]): Decimal;
+}
+/**
+ * Decimal utilities for database operations
+ */
+declare const DecimalUtils: {
+    /**
+     * Convert number to database decimal string
+     */
+    toDecimalString(value: number | string | null | undefined): string | null;
+    /**
+     * Convert database decimal string to number
+     */
+    fromDecimalString(value: string | null | undefined): number;
+    /**
+     * Perform precise decimal multiplication
+     */
+    multiply(a: number | string, b: number | string): string;
+    /**
+     * Perform precise decimal addition
+     */
+    add(a: number | string, b: number | string): string;
+    /**
+     * Perform precise decimal subtraction
+     */
+    subtract(a: number | string, b: number | string): string;
+    /**
+     * Perform precise decimal division
+     */
+    divide(a: number | string, b: number | string): string;
+    /**
+     * Format decimal for display
+     */
+    format(value: string | number, decimalPlaces?: number): string;
+    /**
+     * Format as currency
+     */
+    formatCurrency(value: string | number, options?: {
+        currency?: string;
+        locale?: string;
+        decimals?: number;
+    }): string;
+    /**
+     * Convert object with decimal fields for database insert/update
+     */
+    prepareForDatabase<T extends Record<string, unknown>>(data: T, decimalFields: string[]): T;
+    /**
+     * Convert object with decimal fields from database
+     */
+    parseFromDatabase<T extends Record<string, unknown>>(data: T, decimalFields: string[]): T;
+};
+/**
+ * Shorthand for creating Decimal
+ */
+declare function decimal(value: number | string): Decimal;
+
+export { Decimal, DecimalUtils, decimal };

package/dist/decimal.js

@@ -0,0 +1,347 @@
+// src/decimal.ts
+var PRECISION = 20;
+var Decimal = class _Decimal {
+  value;
+  constructor(value) {
+    if (value instanceof _Decimal) {
+      this.value = value.value;
+    } else if (typeof value === "number") {
+      this.value = this.normalizeNumber(value);
+    } else {
+      this.value = this.normalizeString(value);
+    }
+  }
+  normalizeNumber(n) {
+    if (!isFinite(n)) {
+      throw new Error(`Invalid number: ${n}`);
+    }
+    return n.toFixed(PRECISION).replace(/\.?0+$/, "") || "0";
+  }
+  normalizeString(s) {
+    const trimmed = s.trim();
+    if (!/^-?\d*\.?\d+$/.test(trimmed)) {
+      throw new Error(`Invalid decimal string: ${s}`);
+    }
+    return trimmed.replace(/^(-?)0+(?=\d)/, "$1").replace(/\.?0+$/, "") || "0";
+  }
+  /**
+   * Add two decimals
+   */
+  add(other) {
+    const a = parseFloat(this.value);
+    const b = parseFloat(other instanceof _Decimal ? other.value : String(other));
+    return new _Decimal(a + b);
+  }
+  /**
+   * Subtract
+   */
+  sub(other) {
+    const a = parseFloat(this.value);
+    const b = parseFloat(other instanceof _Decimal ? other.value : String(other));
+    return new _Decimal(a - b);
+  }
+  /**
+   * Multiply
+   */
+  mul(other) {
+    const a = parseFloat(this.value);
+    const b = parseFloat(other instanceof _Decimal ? other.value : String(other));
+    return new _Decimal(a * b);
+  }
+  /**
+   * Divide
+   */
+  div(other) {
+    const a = parseFloat(this.value);
+    const b = parseFloat(other instanceof _Decimal ? other.value : String(other));
+    if (b === 0) {
+      throw new Error("Division by zero");
+    }
+    return new _Decimal(a / b);
+  }
+  /**
+   * Modulo
+   */
+  mod(other) {
+    const a = parseFloat(this.value);
+    const b = parseFloat(other instanceof _Decimal ? other.value : String(other));
+    return new _Decimal(a % b);
+  }
+  /**
+   * Power
+   */
+  pow(exp) {
+    const a = parseFloat(this.value);
+    return new _Decimal(Math.pow(a, exp));
+  }
+  /**
+   * Square root
+   */
+  sqrt() {
+    const a = parseFloat(this.value);
+    if (a < 0) {
+      throw new Error("Square root of negative number");
+    }
+    return new _Decimal(Math.sqrt(a));
+  }
+  /**
+   * Absolute value
+   */
+  abs() {
+    const a = parseFloat(this.value);
+    return new _Decimal(Math.abs(a));
+  }
+  /**
+   * Negate
+   */
+  neg() {
+    const a = parseFloat(this.value);
+    return new _Decimal(-a);
+  }
+  /**
+   * Round to decimal places
+   */
+  round(decimals = 0) {
+    const a = parseFloat(this.value);
+    const factor = Math.pow(10, decimals);
+    return new _Decimal(Math.round(a * factor) / factor);
+  }
+  /**
+   * Floor to decimal places
+   */
+  floor(decimals = 0) {
+    const a = parseFloat(this.value);
+    const factor = Math.pow(10, decimals);
+    return new _Decimal(Math.floor(a * factor) / factor);
+  }
+  /**
+   * Ceiling to decimal places
+   */
+  ceil(decimals = 0) {
+    const a = parseFloat(this.value);
+    const factor = Math.pow(10, decimals);
+    return new _Decimal(Math.ceil(a * factor) / factor);
+  }
+  /**
+   * Compare: returns -1, 0, or 1
+   */
+  cmp(other) {
+    const a = parseFloat(this.value);
+    const b = parseFloat(other instanceof _Decimal ? other.value : String(other));
+    if (a < b) return -1;
+    if (a > b) return 1;
+    return 0;
+  }
+  /**
+   * Equality check
+   */
+  eq(other) {
+    return this.cmp(other) === 0;
+  }
+  /**
+   * Greater than
+   */
+  gt(other) {
+    return this.cmp(other) === 1;
+  }
+  /**
+   * Greater than or equal
+   */
+  gte(other) {
+    return this.cmp(other) >= 0;
+  }
+  /**
+   * Less than
+   */
+  lt(other) {
+    return this.cmp(other) === -1;
+  }
+  /**
+   * Less than or equal
+   */
+  lte(other) {
+    return this.cmp(other) <= 0;
+  }
+  /**
+   * Check if zero
+   */
+  isZero() {
+    return parseFloat(this.value) === 0;
+  }
+  /**
+   * Check if positive
+   */
+  isPositive() {
+    return parseFloat(this.value) > 0;
+  }
+  /**
+   * Check if negative
+   */
+  isNegative() {
+    return parseFloat(this.value) < 0;
+  }
+  /**
+   * Convert to number
+   */
+  toNumber() {
+    return parseFloat(this.value);
+  }
+  /**
+   * Convert to string
+   */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Format with fixed decimal places
+   */
+  toFixed(decimals = 2) {
+    return parseFloat(this.value).toFixed(decimals);
+  }
+  /**
+   * Convert to JSON (string representation)
+   */
+  toJSON() {
+    return this.value;
+  }
+  /**
+   * Static: Create from value
+   */
+  static from(value) {
+    return new _Decimal(value);
+  }
+  /**
+   * Static: Sum array of values
+   */
+  static sum(values) {
+    return values.reduce(
+      (acc, val) => acc.add(val),
+      new _Decimal(0)
+    );
+  }
+  /**
+   * Static: Average of array
+   */
+  static avg(values) {
+    if (values.length === 0) return new _Decimal(0);
+    return _Decimal.sum(values).div(values.length);
+  }
+  /**
+   * Static: Min of array
+   */
+  static min(...values) {
+    if (values.length === 0) throw new Error("No values provided");
+    return values.reduce((min, val) => {
+      const d = new _Decimal(val);
+      return d.lt(min) ? d : min;
+    }, new _Decimal(values[0]));
+  }
+  /**
+   * Static: Max of array
+   */
+  static max(...values) {
+    if (values.length === 0) throw new Error("No values provided");
+    return values.reduce((max, val) => {
+      const d = new _Decimal(val);
+      return d.gt(max) ? d : max;
+    }, new _Decimal(values[0]));
+  }
+};
+var DecimalUtils = {
+  /**
+   * Convert number to database decimal string
+   */
+  toDecimalString(value) {
+    if (value === null || value === void 0) return null;
+    return new Decimal(value).toString();
+  },
+  /**
+   * Convert database decimal string to number
+   */
+  fromDecimalString(value) {
+    if (!value) return 0;
+    return new Decimal(value).toNumber();
+  },
+  /**
+   * Perform precise decimal multiplication
+   */
+  multiply(a, b) {
+    return new Decimal(a).mul(b).toString();
+  },
+  /**
+   * Perform precise decimal addition
+   */
+  add(a, b) {
+    return new Decimal(a).add(b).toString();
+  },
+  /**
+   * Perform precise decimal subtraction
+   */
+  subtract(a, b) {
+    return new Decimal(a).sub(b).toString();
+  },
+  /**
+   * Perform precise decimal division
+   */
+  divide(a, b) {
+    return new Decimal(a).div(b).toString();
+  },
+  /**
+   * Format decimal for display
+   */
+  format(value, decimalPlaces = 2) {
+    return new Decimal(value).toFixed(decimalPlaces);
+  },
+  /**
+   * Format as currency
+   */
+  formatCurrency(value, options = {}) {
+    const { currency = "USD", locale = "en-US", decimals = 2 } = options;
+    const num = new Decimal(value).toNumber();
+    return new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency,
+      minimumFractionDigits: decimals,
+      maximumFractionDigits: decimals
+    }).format(num);
+  },
+  /**
+   * Convert object with decimal fields for database insert/update
+   */
+  prepareForDatabase(data, decimalFields) {
+    const result = { ...data };
+    for (const field of decimalFields) {
+      if (field in result && result[field] !== void 0 && result[field] !== null) {
+        const value = result[field];
+        if (typeof value === "number") {
+          result[field] = DecimalUtils.toDecimalString(value);
+        }
+      }
+    }
+    return result;
+  },
+  /**
+   * Convert object with decimal fields from database
+   */
+  parseFromDatabase(data, decimalFields) {
+    const result = { ...data };
+    for (const field of decimalFields) {
+      if (field in result && result[field] !== void 0 && result[field] !== null) {
+        const value = result[field];
+        if (typeof value === "string") {
+          result[field] = DecimalUtils.fromDecimalString(value);
+        }
+      }
+    }
+    return result;
+  }
+};
+function decimal(value) {
+  return new Decimal(value);
+}
+export {
+  Decimal,
+  DecimalUtils,
+  decimal
+};
+//# sourceMappingURL=decimal.js.map

package/dist/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/decimal.ts"],"sourcesContent":["/**\n * @parsrun/core - Decimal Utilities\n * Precise decimal calculations for financial and quantity operations\n * Edge-compatible - no external dependencies\n */\n\n/**\n * Internal precision for calculations\n */\nconst PRECISION = 20;\n\n/**\n * Decimal class for precise arithmetic\n * Uses string-based arithmetic to avoid floating point issues\n */\nexport class Decimal {\n  private value: string;\n\n  constructor(value: number | string | Decimal) {\n    if (value instanceof Decimal) {\n      this.value = value.value;\n    } else if (typeof value === \"number\") {\n      this.value = this.normalizeNumber(value);\n    } else {\n      this.value = this.normalizeString(value);\n    }\n  }\n\n  private normalizeNumber(n: number): string {\n    if (!isFinite(n)) {\n      throw new Error(`Invalid number: ${n}`);\n    }\n    return n.toFixed(PRECISION).replace(/\\.?0+$/, \"\") || \"0\";\n  }\n\n  private normalizeString(s: string): string {\n    const trimmed = s.trim();\n    if (!/^-?\\d*\\.?\\d+$/.test(trimmed)) {\n      throw new Error(`Invalid decimal string: ${s}`);\n    }\n    return trimmed.replace(/^(-?)0+(?=\\d)/, \"$1\").replace(/\\.?0+$/, \"\") || \"0\";\n  }\n\n  /**\n   * Add two decimals\n   */\n  add(other: number | string | Decimal): Decimal {\n    const a = parseFloat(this.value);\n    const b = parseFloat(other instanceof Decimal ? other.value : String(other));\n    return new Decimal(a + b);\n  }\n\n  /**\n   * Subtract\n   */\n  sub(other: number | string | Decimal): Decimal {\n    const a = parseFloat(this.value);\n    const b = parseFloat(other instanceof Decimal ? other.value : String(other));\n    return new Decimal(a - b);\n  }\n\n  /**\n   * Multiply\n   */\n  mul(other: number | string | Decimal): Decimal {\n    const a = parseFloat(this.value);\n    const b = parseFloat(other instanceof Decimal ? other.value : String(other));\n    return new Decimal(a * b);\n  }\n\n  /**\n   * Divide\n   */\n  div(other: number | string | Decimal): Decimal {\n    const a = parseFloat(this.value);\n    const b = parseFloat(other instanceof Decimal ? other.value : String(other));\n    if (b === 0) {\n      throw new Error(\"Division by zero\");\n    }\n    return new Decimal(a / b);\n  }\n\n  /**\n   * Modulo\n   */\n  mod(other: number | string | Decimal): Decimal {\n    const a = parseFloat(this.value);\n    const b = parseFloat(other instanceof Decimal ? other.value : String(other));\n    return new Decimal(a % b);\n  }\n\n  /**\n   * Power\n   */\n  pow(exp: number): Decimal {\n    const a = parseFloat(this.value);\n    return new Decimal(Math.pow(a, exp));\n  }\n\n  /**\n   * Square root\n   */\n  sqrt(): Decimal {\n    const a = parseFloat(this.value);\n    if (a < 0) {\n      throw new Error(\"Square root of negative number\");\n    }\n    return new Decimal(Math.sqrt(a));\n  }\n\n  /**\n   * Absolute value\n   */\n  abs(): Decimal {\n    const a = parseFloat(this.value);\n    return new Decimal(Math.abs(a));\n  }\n\n  /**\n   * Negate\n   */\n  neg(): Decimal {\n    const a = parseFloat(this.value);\n    return new Decimal(-a);\n  }\n\n  /**\n   * Round to decimal places\n   */\n  round(decimals: number = 0): Decimal {\n    const a = parseFloat(this.value);\n    const factor = Math.pow(10, decimals);\n    return new Decimal(Math.round(a * factor) / factor);\n  }\n\n  /**\n   * Floor to decimal places\n   */\n  floor(decimals: number = 0): Decimal {\n    const a = parseFloat(this.value);\n    const factor = Math.pow(10, decimals);\n    return new Decimal(Math.floor(a * factor) / factor);\n  }\n\n  /**\n   * Ceiling to decimal places\n   */\n  ceil(decimals: number = 0): Decimal {\n    const a = parseFloat(this.value);\n    const factor = Math.pow(10, decimals);\n    return new Decimal(Math.ceil(a * factor) / factor);\n  }\n\n  /**\n   * Compare: returns -1, 0, or 1\n   */\n  cmp(other: number | string | Decimal): -1 | 0 | 1 {\n    const a = parseFloat(this.value);\n    const b = parseFloat(other instanceof Decimal ? other.value : String(other));\n    if (a < b) return -1;\n    if (a > b) return 1;\n    return 0;\n  }\n\n  /**\n   * Equality check\n   */\n  eq(other: number | string | Decimal): boolean {\n    return this.cmp(other) === 0;\n  }\n\n  /**\n   * Greater than\n   */\n  gt(other: number | string | Decimal): boolean {\n    return this.cmp(other) === 1;\n  }\n\n  /**\n   * Greater than or equal\n   */\n  gte(other: number | string | Decimal): boolean {\n    return this.cmp(other) >= 0;\n  }\n\n  /**\n   * Less than\n   */\n  lt(other: number | string | Decimal): boolean {\n    return this.cmp(other) === -1;\n  }\n\n  /**\n   * Less than or equal\n   */\n  lte(other: number | string | Decimal): boolean {\n    return this.cmp(other) <= 0;\n  }\n\n  /**\n   * Check if zero\n   */\n  isZero(): boolean {\n    return parseFloat(this.value) === 0;\n  }\n\n  /**\n   * Check if positive\n   */\n  isPositive(): boolean {\n    return parseFloat(this.value) > 0;\n  }\n\n  /**\n   * Check if negative\n   */\n  isNegative(): boolean {\n    return parseFloat(this.value) < 0;\n  }\n\n  /**\n   * Convert to number\n   */\n  toNumber(): number {\n    return parseFloat(this.value);\n  }\n\n  /**\n   * Convert to string\n   */\n  toString(): string {\n    return this.value;\n  }\n\n  /**\n   * Format with fixed decimal places\n   */\n  toFixed(decimals: number = 2): string {\n    return parseFloat(this.value).toFixed(decimals);\n  }\n\n  /**\n   * Convert to JSON (string representation)\n   */\n  toJSON(): string {\n    return this.value;\n  }\n\n  /**\n   * Static: Create from value\n   */\n  static from(value: number | string | Decimal): Decimal {\n    return new Decimal(value);\n  }\n\n  /**\n   * Static: Sum array of values\n   */\n  static sum(values: (number | string | Decimal)[]): Decimal {\n    return values.reduce<Decimal>(\n      (acc, val) => acc.add(val),\n      new Decimal(0)\n    );\n  }\n\n  /**\n   * Static: Average of array\n   */\n  static avg(values: (number | string | Decimal)[]): Decimal {\n    if (values.length === 0) return new Decimal(0);\n    return Decimal.sum(values).div(values.length);\n  }\n\n  /**\n   * Static: Min of array\n   */\n  static min(...values: (number | string | Decimal)[]): Decimal {\n    if (values.length === 0) throw new Error(\"No values provided\");\n    return values.reduce<Decimal>((min, val) => {\n      const d = new Decimal(val);\n      return d.lt(min) ? d : min;\n    }, new Decimal(values[0]!));\n  }\n\n  /**\n   * Static: Max of array\n   */\n  static max(...values: (number | string | Decimal)[]): Decimal {\n    if (values.length === 0) throw new Error(\"No values provided\");\n    return values.reduce<Decimal>((max, val) => {\n      const d = new Decimal(val);\n      return d.gt(max) ? d : max;\n    }, new Decimal(values[0]!));\n  }\n}\n\n/**\n * Decimal utilities for database operations\n */\nexport const DecimalUtils = {\n  /**\n   * Convert number to database decimal string\n   */\n  toDecimalString(value: number | string | null | undefined): string | null {\n    if (value === null || value === undefined) return null;\n    return new Decimal(value).toString();\n  },\n\n  /**\n   * Convert database decimal string to number\n   */\n  fromDecimalString(value: string | null | undefined): number {\n    if (!value) return 0;\n    return new Decimal(value).toNumber();\n  },\n\n  /**\n   * Perform precise decimal multiplication\n   */\n  multiply(a: number | string, b: number | string): string {\n    return new Decimal(a).mul(b).toString();\n  },\n\n  /**\n   * Perform precise decimal addition\n   */\n  add(a: number | string, b: number | string): string {\n    return new Decimal(a).add(b).toString();\n  },\n\n  /**\n   * Perform precise decimal subtraction\n   */\n  subtract(a: number | string, b: number | string): string {\n    return new Decimal(a).sub(b).toString();\n  },\n\n  /**\n   * Perform precise decimal division\n   */\n  divide(a: number | string, b: number | string): string {\n    return new Decimal(a).div(b).toString();\n  },\n\n  /**\n   * Format decimal for display\n   */\n  format(value: string | number, decimalPlaces: number = 2): string {\n    return new Decimal(value).toFixed(decimalPlaces);\n  },\n\n  /**\n   * Format as currency\n   */\n  formatCurrency(\n    value: string | number,\n    options: {\n      currency?: string;\n      locale?: string;\n      decimals?: number;\n    } = {}\n  ): string {\n    const { currency = \"USD\", locale = \"en-US\", decimals = 2 } = options;\n    const num = new Decimal(value).toNumber();\n    return new Intl.NumberFormat(locale, {\n      style: \"currency\",\n      currency,\n      minimumFractionDigits: decimals,\n      maximumFractionDigits: decimals,\n    }).format(num);\n  },\n\n  /**\n   * Convert object with decimal fields for database insert/update\n   */\n  prepareForDatabase<T extends Record<string, unknown>>(\n    data: T,\n    decimalFields: string[]\n  ): T {\n    const result = { ...data };\n    for (const field of decimalFields) {\n      if (field in result && result[field] !== undefined && result[field] !== null) {\n        const value = result[field];\n        if (typeof value === \"number\") {\n          (result as Record<string, unknown>)[field] = DecimalUtils.toDecimalString(value);\n        }\n      }\n    }\n    return result;\n  },\n\n  /**\n   * Convert object with decimal fields from database\n   */\n  parseFromDatabase<T extends Record<string, unknown>>(\n    data: T,\n    decimalFields: string[]\n  ): T {\n    const result = { ...data };\n    for (const field of decimalFields) {\n      if (field in result && result[field] !== undefined && result[field] !== null) {\n        const value = result[field];\n        if (typeof value === \"string\") {\n          (result as Record<string, unknown>)[field] = DecimalUtils.fromDecimalString(value);\n        }\n      }\n    }\n    return result;\n  },\n};\n\n/**\n * Shorthand for creating Decimal\n */\nexport function decimal(value: number | string): Decimal {\n  return new Decimal(value);\n}\n"],"mappings":"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","names":[]}