@wildo-ai/zod-decorators 1.0.0

package/dist/esm/zod-money.d.ts

@@ -0,0 +1,223 @@
+import { DecoratorInput, MoneySchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types.js";
+import { z } from "zod";
+import { CurrencySchema } from "./currencies.shared.schemas.js";
+/**
+ * Money value type - represents a monetary amount with bigint storage.
+ *
+ * The amount is stored as a bigint in the smallest unit (e.g., cents for USD).
+ * Using bigint ensures no precision loss for arbitrarily large amounts.
+ * The decimals field indicates how to convert to the display value:
+ * - displayValue = Number(amount) / (10 ** decimals)
+ *
+ * Example: { amount: 1999n, currency: 'USD', decimals: 2 } = $19.99
+ */
+export interface MoneyValue {
+    /** Amount in smallest unit (e.g., cents). BigInt to avoid precision issues with large amounts. */
+    amount: bigint;
+    /** ISO 4217 currency code (e.g., 'USD', 'EUR', 'BTC') */
+    currency: string;
+    /** Number of decimal places for display (e.g., 2 for USD, 8 for BTC) */
+    decimals: number;
+}
+/**
+ * Zod schema for MoneyValue.
+ */
+export declare const MoneyValueSchema: z.ZodObject<{
+    amount: z.ZodBigInt;
+    currency: typeof CurrencySchema;
+    decimals: z.ZodNumber;
+}>;
+/**
+ * z_money() - Creates money schemas for financial amounts.
+ *
+ * Money values are stored as integers to avoid floating-point precision issues.
+ * The schema creates an object with: { amount, currency, decimals }
+ *
+ * @example
+ * ```typescript
+ * import { z_money } from '@wildo-ai/zod-decorators';
+ *
+ * const price = z_money();
+ * const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });
+ * const usdPrice = z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } });
+ *
+ * // With decorators (chainable)
+ * z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } })
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR] }).isHidden({ edit: true })
+ * ```
+ */
+/**
+ * Creates a money schema with metadata for detection and form component rendering.
+ *
+ * @param options - Configuration options for money field
+ * @returns A Zod object schema with metadata for money detection
+ *
+ * @example
+ * ```typescript
+ * // Simple money (all currencies)
+ * const price = z_money();
+ * // Infers: { amount: bigint, currency: string, decimals: number }
+ *
+ * // Fiat only (no crypto)
+ * const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });
+ *
+ * // Fixed currency with amount constraints
+ * const usdPrice = z_money({
+ *   allowCurrencyChange: false,
+ *   minAmount: 0n,
+ *   maxAmount: 100000000n // $1,000,000.00 in cents
+ * }).moneyUI({ edit: { defaultCurrency: 'USD' } });
+ * ```
+ */
+export declare function createMoneySchema(options?: MoneySchemaOptions): DecoratedMoneySchema;
+/**
+ * Return type for money schemas - includes decorator methods.
+ * Note: IS_FOREIGN_KEY is not applicable to money objects.
+ * IS_DB_INDEXED will index internal fields (amount, currency) for query optimization.
+ *
+ * This type must list all decorators applicable to ZodObject (per ApplyableTypeAllTypes).
+ * Missing entries here cause TS errors when chaining decorators on z_money() fields.
+ */
+export type DecoratedMoneySchema = z.ZodObject<{
+    amount: z.ZodBigInt;
+    currency: typeof CurrencySchema;
+    decimals: z.ZodNumber;
+}> & {
+    [ZodDecorator.IS_DB_INDEXED](): DecoratedMoneySchema;
+    [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedMoneySchema;
+    [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedMoneySchema;
+    [ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedMoneySchema;
+    [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedMoneySchema;
+    [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedMoneySchema;
+    [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedMoneySchema;
+    addDecorators(decorators: DecoratorInput[]): DecoratedMoneySchema;
+};
+/**
+ * Creates a money schema for financial amounts with integer storage.
+ * Named z_money to indicate it's a Zod helper function exported standalone.
+ *
+ * Money values are stored as: { amount: int, currency: string, decimals: int }
+ * - amount: Value in smallest unit (e.g., cents for USD, satoshis for BTC)
+ * - currency: ISO 4217 code (e.g., 'USD', 'EUR', 'BTC')
+ * - decimals: Decimal places for display conversion (e.g., 2 for USD, 8 for BTC)
+ *
+ * @example
+ * ```typescript
+ * import { z_money } from '@wildo-ai/zod-decorators';
+ *
+ * // Simple usage
+ * z_money()  // All currencies
+ *
+ * // With options
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] })
+ * z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } })
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR], minAmount: 0n })
+ *
+ * // With decorators (chainable)
+ * z_money().moneyUI({ edit: { defaultCurrency: 'USD' } })
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).isHidden({ edit: true })
+ *
+ * // Usage example
+ * const price: MoneyValue = { amount: 1999n, currency: 'USD', decimals: 2 };
+ * // Represents $19.99
+ * ```
+ */
+export declare function z_money(options?: MoneySchemaOptions): DecoratedMoneySchema;
+/**
+ * Convert a decimal amount to bigint representation.
+ *
+ * **Precision caveat:** This uses floating-point arithmetic internally
+ * (`Math.round(decimalAmount * 10^decimals)`), which can produce rounding
+ * errors for certain values. Prefer `parseDecimalStringToAmount` when working
+ * with user input strings to avoid float precision issues entirely.
+ *
+ * @param decimalAmount - The decimal amount (e.g., 19.99)
+ * @param decimals - Number of decimal places (e.g., 2)
+ * @returns BigInt amount (e.g., 1999n)
+ */
+export declare function toMoneyAmount(decimalAmount: number, decimals: number): bigint;
+/**
+ * Convert a bigint amount to decimal representation.
+ * @param amount - The bigint amount (e.g., 1999n)
+ * @param decimals - Number of decimal places (e.g., 2)
+ * @returns Decimal amount (e.g., 19.99)
+ */
+export declare function fromMoneyAmount(amount: bigint, decimals: number): number;
+/**
+ * Convert a string or number to bigint safely.
+ * Useful for parsing user input or JSON values.
+ * @param value - String, number, or bigint to convert
+ * @returns BigInt amount
+ */
+export declare function toBigIntAmount(value: string | number | bigint): bigint;
+/**
+ * Parse a decimal string directly to a bigint amount, avoiding floating-point
+ * precision issues entirely.
+ *
+ * This is the preferred way to convert user input (e.g., from an HTML input
+ * element) to a money amount. It works by splitting the string at the decimal
+ * point and manipulating integer/fractional parts as strings, so no float
+ * arithmetic is ever involved.
+ *
+ * - Extra fractional digits beyond `decimals` are **truncated** (not rounded).
+ * - Missing fractional digits are **zero-padded**.
+ *
+ * @param input - A decimal string (e.g., "19.99", "5", ".50", "-12.345")
+ * @param decimals - Number of decimal places for the target currency
+ * @returns BigInt amount, or `null` if the input is not a valid decimal string
+ *
+ * **Note:** Scientific notation strings (e.g., `"1e+10"`) are rejected (returns
+ * `null`) since they are not valid monetary input. This is correct behavior when
+ * reading from `<input type="number">`, which may produce such strings for very
+ * large values — those inputs should be constrained via `min`/`max` attributes.
+ *
+ * @example
+ * ```typescript
+ * parseDecimalStringToAmount("19.99", 2)   // → 1999n
+ * parseDecimalStringToAmount("19.999", 2)  // → 1999n  (truncates, not rounds)
+ * parseDecimalStringToAmount("19.9", 2)    // → 1990n  (pads missing decimals)
+ * parseDecimalStringToAmount("5", 2)       // → 500n
+ * parseDecimalStringToAmount(".50", 2)     // → 50n
+ * parseDecimalStringToAmount("-12.34", 2)  // → -1234n
+ * parseDecimalStringToAmount("abc", 2)     // → null
+ * parseDecimalStringToAmount("1e+10", 2)   // → null   (scientific notation rejected)
+ * ```
+ */
+export declare function parseDecimalStringToAmount(input: string, decimals: number): bigint | null;
+/**
+ * Convert a money amount from one decimal precision to another using pure
+ * bigint arithmetic (no floating-point involved).
+ *
+ * Use this when changing a currency (which may have different decimal places)
+ * instead of the float roundtrip `fromMoneyAmount` → `toMoneyAmount`.
+ *
+ * - When increasing decimals (e.g., 2 → 8): multiplies by 10^(diff)
+ * - When decreasing decimals (e.g., 8 → 2): divides with half-away-from-zero rounding
+ *
+ * @param amount - The bigint amount in the source precision
+ * @param fromDecimals - Source decimal places
+ * @param toDecimals - Target decimal places
+ * @returns BigInt amount in the target precision
+ *
+ * @example
+ * ```typescript
+ * convertMoneyDecimals(1999n, 2, 2)  // → 1999n   (same decimals, no-op)
+ * convertMoneyDecimals(1999n, 2, 4)  // → 199900n (scale up)
+ * convertMoneyDecimals(199900n, 4, 2) // → 1999n  (scale down)
+ * convertMoneyDecimals(12345678n, 8, 2) // → 12n  (BTC satoshis to 2-decimal)
+ * ```
+ */
+export declare function convertMoneyDecimals(amount: bigint, fromDecimals: number, toDecimals: number): bigint;
+/**
+ * Format a money value for display.
+ * @param money - The money value
+ * @param options - Formatting options
+ * @returns Formatted string (e.g., "$19.99" or "19.99 USD")
+ */
+export declare function formatMoney(money: MoneyValue, options?: {
+    showSymbol?: boolean;
+    symbolPosition?: 'before' | 'after';
+    thousandsSeparator?: string;
+    decimalSeparator?: string;
+}): string;
+//# sourceMappingURL=zod-money.d.ts.map

package/dist/esm/zod-money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-money.d.ts","sourceRoot":"","sources":["../../src/zod-money.ts"],"names":[],"mappings":"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"}

package/dist/esm/zod-money.js

@@ -0,0 +1,293 @@
+// ============================================================================
+// MONEY SCHEMA HELPER
+// ============================================================================
+import { SCHEMA_METADATA, ZodDecorator } from "./zod-decorators.types.js";
+import { z } from "zod";
+import { addChainableMethods } from "./zod.module-override.js";
+import { CurrencySchema } from "./currencies.shared.schemas.js";
+/**
+ * Zod schema for MoneyValue.
+ */
+export const MoneyValueSchema = z.object({
+    amount: z.bigint(),
+    currency: CurrencySchema,
+    decimals: z.number().int().min(0).max(18),
+});
+/**
+ * z_money() - Creates money schemas for financial amounts.
+ *
+ * Money values are stored as integers to avoid floating-point precision issues.
+ * The schema creates an object with: { amount, currency, decimals }
+ *
+ * @example
+ * ```typescript
+ * import { z_money } from '@wildo-ai/zod-decorators';
+ *
+ * const price = z_money();
+ * const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });
+ * const usdPrice = z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } });
+ *
+ * // With decorators (chainable)
+ * z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } })
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR] }).isHidden({ edit: true })
+ * ```
+ */
+/**
+ * Creates a money schema with metadata for detection and form component rendering.
+ *
+ * @param options - Configuration options for money field
+ * @returns A Zod object schema with metadata for money detection
+ *
+ * @example
+ * ```typescript
+ * // Simple money (all currencies)
+ * const price = z_money();
+ * // Infers: { amount: bigint, currency: string, decimals: number }
+ *
+ * // Fiat only (no crypto)
+ * const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });
+ *
+ * // Fixed currency with amount constraints
+ * const usdPrice = z_money({
+ *   allowCurrencyChange: false,
+ *   minAmount: 0n,
+ *   maxAmount: 100000000n // $1,000,000.00 in cents
+ * }).moneyUI({ edit: { defaultCurrency: 'USD' } });
+ * ```
+ */
+export function createMoneySchema(options = {}) {
+    const { currenciesAllowed, appEnabledOnly = true, allowCurrencyChange = true, minAmount, maxAmount, } = options;
+    // Create the amount schema with optional min/max constraints
+    // Using bigint for amount to avoid precision issues with large financial amounts
+    let amountSchema = z.bigint();
+    if (minAmount !== undefined) {
+        amountSchema = amountSchema.min(minAmount);
+    }
+    if (maxAmount !== undefined) {
+        amountSchema = amountSchema.max(maxAmount);
+    }
+    // Create the money object schema
+    const moneySchema = z.object({
+        amount: amountSchema,
+        currency: CurrencySchema,
+        decimals: z.number().int().min(0).max(18),
+    });
+    const moneyMetadata = {
+        isMoney: true,
+        ...(currenciesAllowed && currenciesAllowed.length > 0 && { currenciesAllowed }),
+        appEnabledOnly,
+        allowCurrencyChange,
+        ...(minAmount !== undefined && { minAmount }),
+        ...(maxAmount !== undefined && { maxAmount }),
+    };
+    // Initialize or extend SCHEMA_METADATA with money config
+    const existingMetadata = moneySchema[SCHEMA_METADATA] || {};
+    moneySchema[SCHEMA_METADATA] = {
+        ...existingMetadata,
+        moneyConfig: moneyMetadata,
+    };
+    // Add chainable decorator methods to the money schema instance
+    // This allows: z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } }).isHidden()
+    addChainableMethods(moneySchema);
+    return moneySchema;
+}
+/**
+ * Creates a money schema for financial amounts with integer storage.
+ * Named z_money to indicate it's a Zod helper function exported standalone.
+ *
+ * Money values are stored as: { amount: int, currency: string, decimals: int }
+ * - amount: Value in smallest unit (e.g., cents for USD, satoshis for BTC)
+ * - currency: ISO 4217 code (e.g., 'USD', 'EUR', 'BTC')
+ * - decimals: Decimal places for display conversion (e.g., 2 for USD, 8 for BTC)
+ *
+ * @example
+ * ```typescript
+ * import { z_money } from '@wildo-ai/zod-decorators';
+ *
+ * // Simple usage
+ * z_money()  // All currencies
+ *
+ * // With options
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] })
+ * z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } })
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR], minAmount: 0n })
+ *
+ * // With decorators (chainable)
+ * z_money().moneyUI({ edit: { defaultCurrency: 'USD' } })
+ * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).isHidden({ edit: true })
+ *
+ * // Usage example
+ * const price: MoneyValue = { amount: 1999n, currency: 'USD', decimals: 2 };
+ * // Represents $19.99
+ * ```
+ */
+export function z_money(options) {
+    return createMoneySchema(options);
+}
+// ============================================================================
+// MONEY UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Convert a decimal amount to bigint representation.
+ *
+ * **Precision caveat:** This uses floating-point arithmetic internally
+ * (`Math.round(decimalAmount * 10^decimals)`), which can produce rounding
+ * errors for certain values. Prefer `parseDecimalStringToAmount` when working
+ * with user input strings to avoid float precision issues entirely.
+ *
+ * @param decimalAmount - The decimal amount (e.g., 19.99)
+ * @param decimals - Number of decimal places (e.g., 2)
+ * @returns BigInt amount (e.g., 1999n)
+ */
+export function toMoneyAmount(decimalAmount, decimals) {
+    return BigInt(Math.round(decimalAmount * Math.pow(10, decimals)));
+}
+/**
+ * Convert a bigint amount to decimal representation.
+ * @param amount - The bigint amount (e.g., 1999n)
+ * @param decimals - Number of decimal places (e.g., 2)
+ * @returns Decimal amount (e.g., 19.99)
+ */
+export function fromMoneyAmount(amount, decimals) {
+    return Number(amount) / Math.pow(10, decimals);
+}
+/**
+ * Convert a string or number to bigint safely.
+ * Useful for parsing user input or JSON values.
+ * @param value - String, number, or bigint to convert
+ * @returns BigInt amount
+ */
+export function toBigIntAmount(value) {
+    if (typeof value === 'bigint')
+        return value;
+    if (typeof value === 'number')
+        return BigInt(Math.round(value));
+    return BigInt(value);
+}
+/**
+ * Parse a decimal string directly to a bigint amount, avoiding floating-point
+ * precision issues entirely.
+ *
+ * This is the preferred way to convert user input (e.g., from an HTML input
+ * element) to a money amount. It works by splitting the string at the decimal
+ * point and manipulating integer/fractional parts as strings, so no float
+ * arithmetic is ever involved.
+ *
+ * - Extra fractional digits beyond `decimals` are **truncated** (not rounded).
+ * - Missing fractional digits are **zero-padded**.
+ *
+ * @param input - A decimal string (e.g., "19.99", "5", ".50", "-12.345")
+ * @param decimals - Number of decimal places for the target currency
+ * @returns BigInt amount, or `null` if the input is not a valid decimal string
+ *
+ * **Note:** Scientific notation strings (e.g., `"1e+10"`) are rejected (returns
+ * `null`) since they are not valid monetary input. This is correct behavior when
+ * reading from `<input type="number">`, which may produce such strings for very
+ * large values — those inputs should be constrained via `min`/`max` attributes.
+ *
+ * @example
+ * ```typescript
+ * parseDecimalStringToAmount("19.99", 2)   // → 1999n
+ * parseDecimalStringToAmount("19.999", 2)  // → 1999n  (truncates, not rounds)
+ * parseDecimalStringToAmount("19.9", 2)    // → 1990n  (pads missing decimals)
+ * parseDecimalStringToAmount("5", 2)       // → 500n
+ * parseDecimalStringToAmount(".50", 2)     // → 50n
+ * parseDecimalStringToAmount("-12.34", 2)  // → -1234n
+ * parseDecimalStringToAmount("abc", 2)     // → null
+ * parseDecimalStringToAmount("1e+10", 2)   // → null   (scientific notation rejected)
+ * ```
+ */
+export function parseDecimalStringToAmount(input, decimals) {
+    const trimmed = input.trim();
+    if (trimmed === '' || trimmed === '.' || trimmed === '-' || trimmed === '-.')
+        return null;
+    // Handle sign
+    const isNegative = trimmed.startsWith('-');
+    const unsigned = isNegative ? trimmed.slice(1) : trimmed;
+    // Validate: only digits and at most one decimal point
+    if (!/^\d*\.?\d*$/.test(unsigned))
+        return null;
+    const dotIndex = unsigned.indexOf('.');
+    const integerPart = dotIndex === -1 ? unsigned : (unsigned.slice(0, dotIndex) || '0');
+    const fractionalRaw = dotIndex === -1 ? '' : unsigned.slice(dotIndex + 1);
+    // Pad or truncate fractional part to exactly `decimals` digits
+    const fractionalPart = decimals === 0
+        ? ''
+        : fractionalRaw.padEnd(decimals, '0').slice(0, decimals);
+    // Build the combined string and convert to bigint
+    const combined = integerPart + fractionalPart;
+    // Guard against empty combined (shouldn't happen after validation, but be safe)
+    if (combined === '')
+        return 0n;
+    try {
+        const result = BigInt(combined);
+        return isNegative ? -result : result;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convert a money amount from one decimal precision to another using pure
+ * bigint arithmetic (no floating-point involved).
+ *
+ * Use this when changing a currency (which may have different decimal places)
+ * instead of the float roundtrip `fromMoneyAmount` → `toMoneyAmount`.
+ *
+ * - When increasing decimals (e.g., 2 → 8): multiplies by 10^(diff)
+ * - When decreasing decimals (e.g., 8 → 2): divides with half-away-from-zero rounding
+ *
+ * @param amount - The bigint amount in the source precision
+ * @param fromDecimals - Source decimal places
+ * @param toDecimals - Target decimal places
+ * @returns BigInt amount in the target precision
+ *
+ * @example
+ * ```typescript
+ * convertMoneyDecimals(1999n, 2, 2)  // → 1999n   (same decimals, no-op)
+ * convertMoneyDecimals(1999n, 2, 4)  // → 199900n (scale up)
+ * convertMoneyDecimals(199900n, 4, 2) // → 1999n  (scale down)
+ * convertMoneyDecimals(12345678n, 8, 2) // → 12n  (BTC satoshis to 2-decimal)
+ * ```
+ */
+export function convertMoneyDecimals(amount, fromDecimals, toDecimals) {
+    if (fromDecimals === toDecimals)
+        return amount;
+    const diff = toDecimals - fromDecimals;
+    if (diff > 0) {
+        // Scale up: multiply
+        return amount * (10n ** BigInt(diff));
+    }
+    // Scale down: divide with rounding (half-away-from-zero)
+    const divisor = 10n ** BigInt(-diff);
+    const isNegative = amount < 0n;
+    const absAmount = isNegative ? -amount : amount;
+    const rounded = (absAmount + divisor / 2n) / divisor;
+    return isNegative ? -rounded : rounded;
+}
+/**
+ * Format a money value for display.
+ * @param money - The money value
+ * @param options - Formatting options
+ * @returns Formatted string (e.g., "$19.99" or "19.99 USD")
+ */
+export function formatMoney(money, options = {}) {
+    const { showSymbol = true, symbolPosition = 'before', thousandsSeparator = ',', decimalSeparator = '.', } = options;
+    const decimalValue = fromMoneyAmount(money.amount, money.decimals);
+    // Format with proper decimal places
+    const [integerPart, decimalPart] = decimalValue.toFixed(money.decimals).split('.');
+    // Add thousands separator
+    const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, thousandsSeparator);
+    const formattedNumber = decimalPart
+        ? `${formattedInteger}${decimalSeparator}${decimalPart}`
+        : formattedInteger;
+    if (!showSymbol) {
+        return formattedNumber;
+    }
+    // For now, use currency code as symbol (can be enhanced with CURRENCY_INFO_MAP)
+    const symbol = money.currency;
+    return symbolPosition === 'before'
+        ? `${symbol} ${formattedNumber}`
+        : `${formattedNumber} ${symbol}`;
+}
+//# sourceMappingURL=zod-money.js.map

package/dist/esm/zod-money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-money.js","sourceRoot":"","sources":["../../src/zod-money.ts"],"names":[],"mappings":"AACA,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EAAkB,eAAe,EAAoF,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AAClM,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAqB7D;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiG,CAAC,CAAC,MAAM,CAAC;IACrI,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA8B,EAAE;IAEhC,MAAM,EACJ,iBAAiB,EACjB,cAAc,GAAG,IAAI,EACrB,mBAAmB,GAAG,IAAI,EAC1B,SAAS,EACT,SAAS,GACV,GAAG,OAAO,CAAC;IAEZ,6DAA6D;IAC7D,iFAAiF;IACjF,IAAI,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,iCAAiC;IACjC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;QAC3B,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAC;IAEH,MAAM,aAAa,GAAwB;QACzC,OAAO,EAAE,IAAI;QACb,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAC/E,cAAc;QACd,mBAAmB;QACnB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9C,CAAC;IAEF,yDAAyD;IACzD,MAAM,gBAAgB,GAAyB,WAAmB,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IACzF,WAAmB,CAAC,eAAe,CAAC,GAAG;QACtC,GAAG,gBAAgB;QACnB,WAAW,EAAE,aAAa;KAC3B,CAAC;IAEF,+DAA+D;IAC/D,kFAAkF;IAClF,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEjC,OAAO,WAAmC,CAAC;AAC7C,CAAC;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,OAAO,CACrB,OAA4B;IAE5B,OAAO,iBAAiB,CAAC,OAAO,CAAyB,CAAC;AAC5D,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,QAAgB;IACnE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,QAAgB;IAC9D,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAA+B;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAa,EAAE,QAAgB;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE1F,cAAc;IACd,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEzD,sDAAsD;IACtD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IACtF,MAAM,aAAa,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAE1E,+DAA+D;IAC/D,MAAM,cAAc,GAAG,QAAQ,KAAK,CAAC;QACnC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE3D,kDAAkD;IAClD,MAAM,QAAQ,GAAG,WAAW,GAAG,cAAc,CAAC;IAC9C,gFAAgF;IAChF,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,YAAoB,EAAE,UAAkB;IAC3F,IAAI,YAAY,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAE/C,MAAM,IAAI,GAAG,UAAU,GAAG,YAAY,CAAC;IAEvC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,qBAAqB;QACrB,OAAO,MAAM,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,yDAAyD;IACzD,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,GAAG,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,OAAO,GAAG,CAAC,SAAS,GAAG,OAAO,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;IACrD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,KAAiB,EACjB,UAKI,EAAE;IAEN,MAAM,EACJ,UAAU,GAAG,IAAI,EACjB,cAAc,GAAG,QAAQ,EACzB,kBAAkB,GAAG,GAAG,EACxB,gBAAgB,GAAG,GAAG,GACvB,GAAG,OAAO,CAAC;IAEZ,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnE,oCAAoC;IACpC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEnF,0BAA0B;IAC1B,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IAE1F,MAAM,eAAe,GAAG,WAAW;QACjC,CAAC,CAAC,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,WAAW,EAAE;QACxD,CAAC,CAAC,gBAAgB,CAAC;IAErB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,gFAAgF;IAChF,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC;IAE9B,OAAO,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,GAAG,MAAM,IAAI,eAAe,EAAE;QAChC,CAAC,CAAC,GAAG,eAAe,IAAI,MAAM,EAAE,CAAC;AACrC,CAAC"}

package/dist/esm/zod-phone.d.ts

@@ -0,0 +1,75 @@
+import type { DecoratorInput, PhoneSchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from './zod-decorators.types.js';
+import { z } from 'zod';
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
+/** Returns country codes (e.g. "US", "FR") for form components. */
+export declare function getCountries(): string[];
+/**
+ * Phone value type — E.164 string (e.g., "+33123456789").
+ * Use formatPhoneNumber() for display, parsePhoneNumber() for parsing.
+ */
+export type PhoneValue = string;
+/**
+ * Parse a phone string to PhoneNumber or undefined.
+ *
+ * @param value - Raw input (E.164, national, or partial)
+ * @param defaultCountry - Country code (e.g. "US", "FR") for numbers without +prefix
+ * @returns PhoneNumber or undefined if invalid
+ */
+export declare function parsePhone(value: string, defaultCountry?: string): ReturnType<typeof parsePhoneNumberFromString>;
+/**
+ * Validate a phone number string.
+ *
+ * @param value - Phone string to validate
+ * @param defaultCountry - Country code (e.g. "US", "FR") for numbers without +prefix
+ * @returns true if valid
+ */
+export declare function isValidPhone(value: string, defaultCountry?: string): boolean;
+/**
+ * Format a phone number for display.
+ *
+ * @param value - E.164 or parseable phone string
+ * @param defaultCountry - Country code (e.g. "US", "FR") for numbers without +prefix
+ * @param format - 'international' | 'national' (default: international)
+ * @returns Formatted string or original if unparseable
+ */
+export declare function formatPhoneNumber(value: string, defaultCountry?: string, format?: 'international' | 'national'): string;
+/**
+ * Get country calling code (e.g., "1" for US).
+ *
+ * @param country - Country code (e.g. "US", "FR")
+ */
+export declare function getPhoneCountryCode(country: string): string;
+/**
+ * Creates a phone schema with metadata for detection and form component rendering.
+ * Values are stored as E.164 strings. Empty string passes validation.
+ *
+ * @param options - Configuration options for phone field
+ * @returns A Zod string schema with metadata for phone detection
+ */
+export declare function createPhoneSchema(options?: PhoneSchemaOptions): DecoratedPhoneSchema;
+/**
+ * Return type for phone schemas - includes decorator methods.
+ */
+export type DecoratedPhoneSchema = z.ZodString & {
+    [ZodDecorator.IS_DB_INDEXED](): DecoratedPhoneSchema;
+    [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedPhoneSchema;
+    [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedPhoneSchema;
+    [ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedPhoneSchema;
+    [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPhoneSchema;
+    [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPhoneSchema;
+    [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPhoneSchema;
+    addDecorators(decorators: DecoratorInput[]): DecoratedPhoneSchema;
+};
+/**
+ * Creates a phone schema for E.164 phone numbers.
+ *
+ * @example
+ * ```typescript
+ * import { z_phone } from '@wildo-ai/zod-decorators';
+ *
+ * z_phone()
+ * z_phone({ defaultCountry: 'FR' })
+ * ```
+ */
+export declare function z_phone(options?: PhoneSchemaOptions): DecoratedPhoneSchema;
+//# sourceMappingURL=zod-phone.d.ts.map

package/dist/esm/zod-phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-phone.d.ts","sourceRoot":"","sources":["../../src/zod-phone.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAGd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,0BAA0B,EAK3B,MAAM,mBAAmB,CAAC;AAE3B,mEAAmE;AACnE,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAKhC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAMhH;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,GAAE,eAAe,GAAG,UAA4B,GACrD,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,oBAAoB,CA8BxF;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,GAAG;IAC/C,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC;IACrD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,oBAAoB,CAAC;IACzG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACnF,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC;CACnE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAE1E"}