@elevasis/core 0.7.0 → 0.8.0

package/src/platform/utils/currency.ts

@@ -1,96 +1,96 @@
-/**
- * Currency formatting utilities
- *
- * These utilities handle formatting of USD currency values for display.
- * Database stores values as NUMERIC (exact decimal precision), JavaScript
- * uses number (IEEE 754 floating point).
- */
-
-/**
- * Format USD amount for display
- *
- * @param amountUsd - Amount in USD (e.g., 1.375 = $1.38)
- * @param options - Formatting options
- * @returns Formatted string (e.g., "$1.38")
- *
- * @example
- * formatCurrency(1.375) // "$1.38"
- * formatCurrency(0.001) // "$0.00"
- * formatCurrency(1234.56) // "$1,234.56"
- * formatCurrency(1.5, { minimumFractionDigits: 4 }) // "$1.5000"
- */
-export function formatCurrency(
-  amountUsd: number,
-  options: {
-    minimumFractionDigits?: number
-    maximumFractionDigits?: number
-  } = {}
-): string {
-  const {
-    minimumFractionDigits = 2,
-    maximumFractionDigits = 2
-  } = options
-
-  return new Intl.NumberFormat('en-US', {
-    style: 'currency',
-    currency: 'USD',
-    minimumFractionDigits,
-    maximumFractionDigits
-  }).format(amountUsd)
-}
-
-/**
- * Format USD amount with high precision (for debugging/technical displays)
- *
- * @param amountUsd - Amount in USD
- * @returns Formatted string with 6 decimal places (e.g., "$0.001375")
- *
- * @example
- * formatCurrencyPrecise(0.001375) // "$0.001375"
- * formatCurrencyPrecise(1.5) // "$1.500000"
- */
-export function formatCurrencyPrecise(amountUsd: number): string {
-  return formatCurrency(amountUsd, {
-    minimumFractionDigits: 6,
-    maximumFractionDigits: 6
-  })
-}
-
-/**
- * Format USD amount as compact notation (for charts/dashboards)
- *
- * @param amountUsd - Amount in USD
- * @returns Compact formatted string (e.g., "$1.2K", "$3.5M")
- *
- * @example
- * formatCurrencyCompact(1234) // "$1.2K"
- * formatCurrencyCompact(1500000) // "$1.5M"
- * formatCurrencyCompact(5) // "$5"
- */
-export function formatCurrencyCompact(amountUsd: number): string {
-  return new Intl.NumberFormat('en-US', {
-    style: 'currency',
-    currency: 'USD',
-    notation: 'compact',
-    minimumFractionDigits: 0,
-    maximumFractionDigits: 1
-  }).format(amountUsd)
-}
-
-/**
- * Parse string USD amount to number (for form inputs)
- *
- * @param value - String value (e.g., "$1,234.56" or "1234.56")
- * @returns Parsed number or null if invalid
- *
- * @example
- * parseCurrency("$1,234.56") // 1234.56
- * parseCurrency("1234.56") // 1234.56
- * parseCurrency("invalid") // null
- */
-export function parseCurrency(value: string): number | null {
-  // Remove currency symbol and commas
-  const cleaned = value.replace(/[$,]/g, '').trim()
-  const parsed = parseFloat(cleaned)
-  return isNaN(parsed) ? null : parsed
-}
+/**
+ * Currency formatting utilities
+ *
+ * These utilities handle formatting of USD currency values for display.
+ * Database stores values as NUMERIC (exact decimal precision), JavaScript
+ * uses number (IEEE 754 floating point).
+ */
+
+/**
+ * Format USD amount for display
+ *
+ * @param amountUsd - Amount in USD (e.g., 1.375 = $1.38)
+ * @param options - Formatting options
+ * @returns Formatted string (e.g., "$1.38")
+ *
+ * @example
+ * formatCurrency(1.375) // "$1.38"
+ * formatCurrency(0.001) // "$0.00"
+ * formatCurrency(1234.56) // "$1,234.56"
+ * formatCurrency(1.5, { minimumFractionDigits: 4 }) // "$1.5000"
+ */
+export function formatCurrency(
+  amountUsd: number,
+  options: {
+    minimumFractionDigits?: number
+    maximumFractionDigits?: number
+  } = {}
+): string {
+  const {
+    minimumFractionDigits = 2,
+    maximumFractionDigits = 2
+  } = options
+
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+    minimumFractionDigits,
+    maximumFractionDigits
+  }).format(amountUsd)
+}
+
+/**
+ * Format USD amount with high precision (for debugging/technical displays)
+ *
+ * @param amountUsd - Amount in USD
+ * @returns Formatted string with 6 decimal places (e.g., "$0.001375")
+ *
+ * @example
+ * formatCurrencyPrecise(0.001375) // "$0.001375"
+ * formatCurrencyPrecise(1.5) // "$1.500000"
+ */
+export function formatCurrencyPrecise(amountUsd: number): string {
+  return formatCurrency(amountUsd, {
+    minimumFractionDigits: 6,
+    maximumFractionDigits: 6
+  })
+}
+
+/**
+ * Format USD amount as compact notation (for charts/dashboards)
+ *
+ * @param amountUsd - Amount in USD
+ * @returns Compact formatted string (e.g., "$1.2K", "$3.5M")
+ *
+ * @example
+ * formatCurrencyCompact(1234) // "$1.2K"
+ * formatCurrencyCompact(1500000) // "$1.5M"
+ * formatCurrencyCompact(5) // "$5"
+ */
+export function formatCurrencyCompact(amountUsd: number): string {
+  return new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+    notation: 'compact',
+    minimumFractionDigits: 0,
+    maximumFractionDigits: 1
+  }).format(amountUsd)
+}
+
+/**
+ * Parse string USD amount to number (for form inputs)
+ *
+ * @param value - String value (e.g., "$1,234.56" or "1234.56")
+ * @returns Parsed number or null if invalid
+ *
+ * @example
+ * parseCurrency("$1,234.56") // 1234.56
+ * parseCurrency("1234.56") // 1234.56
+ * parseCurrency("invalid") // null
+ */
+export function parseCurrency(value: string): number | null {
+  // Remove currency symbol and commas
+  const cleaned = value.replace(/[$,]/g, '').trim()
+  const parsed = parseFloat(cleaned)
+  return isNaN(parsed) ? null : parsed
+}

package/src/platform/utils/debounce.ts

@@ -1,52 +1,52 @@
-/**
- * Debounce utility for delaying function execution
- *
- * Creates a debounced version of a function that delays invoking until
- * after `wait` milliseconds have elapsed since the last time it was invoked.
- */
-
-/**
- * Creates a debounced function that delays invoking `fn` until after `wait`
- * milliseconds have elapsed since the last time the debounced function was invoked.
- *
- * @param fn - The function to debounce
- * @param wait - The number of milliseconds to delay
- * @returns A debounced version of the function with a `cancel` method
- *
- * @example
- * const debouncedSearch = debounce((query: string) => {
- *   console.log('Searching for:', query)
- * }, 300)
- *
- * debouncedSearch('a')
- * debouncedSearch('ab')
- * debouncedSearch('abc') // Only this one executes after 300ms
- *
- * // Cancel pending execution
- * debouncedSearch.cancel()
- */
-export function debounce<T extends (...args: Parameters<T>) => void>(
-  fn: T,
-  wait: number
-): ((...args: Parameters<T>) => void) & { cancel: () => void } {
-  let timeoutId: ReturnType<typeof setTimeout> | null = null
-
-  const debounced = (...args: Parameters<T>) => {
-    if (timeoutId !== null) {
-      clearTimeout(timeoutId)
-    }
-    timeoutId = setTimeout(() => {
-      fn(...args)
-      timeoutId = null
-    }, wait)
-  }
-
-  debounced.cancel = () => {
-    if (timeoutId !== null) {
-      clearTimeout(timeoutId)
-      timeoutId = null
-    }
-  }
-
-  return debounced
-}
+/**
+ * Debounce utility for delaying function execution
+ *
+ * Creates a debounced version of a function that delays invoking until
+ * after `wait` milliseconds have elapsed since the last time it was invoked.
+ */
+
+/**
+ * Creates a debounced function that delays invoking `fn` until after `wait`
+ * milliseconds have elapsed since the last time the debounced function was invoked.
+ *
+ * @param fn - The function to debounce
+ * @param wait - The number of milliseconds to delay
+ * @returns A debounced version of the function with a `cancel` method
+ *
+ * @example
+ * const debouncedSearch = debounce((query: string) => {
+ *   console.log('Searching for:', query)
+ * }, 300)
+ *
+ * debouncedSearch('a')
+ * debouncedSearch('ab')
+ * debouncedSearch('abc') // Only this one executes after 300ms
+ *
+ * // Cancel pending execution
+ * debouncedSearch.cancel()
+ */
+export function debounce<T extends (...args: Parameters<T>) => void>(
+  fn: T,
+  wait: number
+): ((...args: Parameters<T>) => void) & { cancel: () => void } {
+  let timeoutId: ReturnType<typeof setTimeout> | null = null
+
+  const debounced = (...args: Parameters<T>) => {
+    if (timeoutId !== null) {
+      clearTimeout(timeoutId)
+    }
+    timeoutId = setTimeout(() => {
+      fn(...args)
+      timeoutId = null
+    }, wait)
+  }
+
+  debounced.cancel = () => {
+    if (timeoutId !== null) {
+      clearTimeout(timeoutId)
+      timeoutId = null
+    }
+  }
+
+  return debounced
+}

package/src/platform/utils/error.ts

@@ -1,42 +1,42 @@
-/**
- * Error utility functions
- */
-
-import { ZodError } from 'zod'
-
-/**
- * Convert unknown error to string message
- * Handles Error objects and other types safely
- * Includes special handling for Zod validation errors
- */
-export function errorToString(error: unknown): string {
-  if (error instanceof ZodError) {
-    // Format Zod validation errors with field path and details
-    return JSON.stringify(error.issues, null, 2)
-  }
-  return error instanceof Error ? error.message : String(error)
-}
-
-/**
- * Extract structured error details for logging
- * Includes validation errors, stack traces, and context
- */
-export function getErrorDetails(error: unknown): Record<string, unknown> {
-  const details: Record<string, unknown> = {
-    message: errorToString(error),
-    type: error instanceof Error ? error.constructor.name : typeof error
-  }
-
-  // Add Zod validation details
-  if (error instanceof ZodError) {
-    details.validationErrors = error.issues
-    details.isValidationError = true
-  }
-
-  // Add stack trace for Error objects
-  if (error instanceof Error && error.stack) {
-    details.stack = error.stack
-  }
-
-  return details
+/**
+ * Error utility functions
+ */
+
+import { ZodError } from 'zod'
+
+/**
+ * Convert unknown error to string message
+ * Handles Error objects and other types safely
+ * Includes special handling for Zod validation errors
+ */
+export function errorToString(error: unknown): string {
+  if (error instanceof ZodError) {
+    // Format Zod validation errors with field path and details
+    return JSON.stringify(error.issues, null, 2)
+  }
+  return error instanceof Error ? error.message : String(error)
+}
+
+/**
+ * Extract structured error details for logging
+ * Includes validation errors, stack traces, and context
+ */
+export function getErrorDetails(error: unknown): Record<string, unknown> {
+  const details: Record<string, unknown> = {
+    message: errorToString(error),
+    type: error instanceof Error ? error.constructor.name : typeof error
+  }
+
+  // Add Zod validation details
+  if (error instanceof ZodError) {
+    details.validationErrors = error.issues
+    details.isValidationError = true
+  }
+
+  // Add stack trace for Error objects
+  if (error instanceof Error && error.stack) {
+    details.stack = error.stack
+  }
+
+  return details
 }

package/src/platform/utils/hmac.test.ts

@@ -1,97 +1,97 @@
-import { describe, it, expect } from 'vitest'
-import { generateHmacToken, verifyHmacToken, generateBrochureUrl } from './server/hmac'
-
-describe('HMAC Token Utilities', () => {
-  const TEST_SECRET = 'test-secret-key-12345'
-  const TEST_CONTACT_ID = '550e8400-e29b-41d4-a716-446655440000'
-
-  describe('generateHmacToken', () => {
-    it('returns 16-character hex token', () => {
-      const token = generateHmacToken('test-data', TEST_SECRET)
-      expect(token).toHaveLength(16)
-      expect(token).toMatch(/^[0-9a-f]{16}$/)
-    })
-
-    it('produces consistent tokens for same input', () => {
-      const token1 = generateHmacToken('test@example.com', TEST_SECRET)
-      const token2 = generateHmacToken('test@example.com', TEST_SECRET)
-      expect(token1).toBe(token2)
-    })
-
-    it('normalizes input (lowercase and trim)', () => {
-      const token1 = generateHmacToken('TEST@EXAMPLE.COM', TEST_SECRET)
-      const token2 = generateHmacToken('  test@example.com  ', TEST_SECRET)
-      const token3 = generateHmacToken('test@example.com', TEST_SECRET)
-      expect(token1).toBe(token2)
-      expect(token2).toBe(token3)
-    })
-
-    it('produces different tokens for different secrets', () => {
-      const token1 = generateHmacToken('data', 'secret1')
-      const token2 = generateHmacToken('data', 'secret2')
-      expect(token1).not.toBe(token2)
-    })
-
-    it('produces different tokens for different data', () => {
-      const token1 = generateHmacToken('data1', TEST_SECRET)
-      const token2 = generateHmacToken('data2', TEST_SECRET)
-      expect(token1).not.toBe(token2)
-    })
-  })
-
-  describe('verifyHmacToken', () => {
-    it('returns true for valid token', () => {
-      const token = generateHmacToken(TEST_CONTACT_ID, TEST_SECRET)
-      const isValid = verifyHmacToken(TEST_CONTACT_ID, token, TEST_SECRET)
-      expect(isValid).toBe(true)
-    })
-
-    it('returns false for invalid token', () => {
-      const isValid = verifyHmacToken(TEST_CONTACT_ID, 'invalid-token-00', TEST_SECRET)
-      expect(isValid).toBe(false)
-    })
-
-    it('returns false for wrong length token', () => {
-      const isValid = verifyHmacToken(TEST_CONTACT_ID, 'short', TEST_SECRET)
-      expect(isValid).toBe(false)
-    })
-
-    it('returns false for wrong secret', () => {
-      const token = generateHmacToken(TEST_CONTACT_ID, TEST_SECRET)
-      const isValid = verifyHmacToken(TEST_CONTACT_ID, token, 'wrong-secret')
-      expect(isValid).toBe(false)
-    })
-
-    it('verifies with normalized input', () => {
-      const token = generateHmacToken('test@example.com', TEST_SECRET)
-      const isValid = verifyHmacToken('  TEST@EXAMPLE.COM  ', token, TEST_SECRET)
-      expect(isValid).toBe(true)
-    })
-  })
-
-  describe('generateBrochureUrl', () => {
-    it('generates URL with default base', () => {
-      const url = generateBrochureUrl(TEST_CONTACT_ID, TEST_SECRET)
-      expect(url).toMatch(/^https:\/\/brochure\.elevasis\.io\//)
-      expect(url).toContain(TEST_CONTACT_ID)
-      expect(url).toMatch(/\?t=[0-9a-f]{16}$/)
-    })
-
-    it('generates URL with custom base', () => {
-      const customBase = 'https://custom.example.com/brochure'
-      const url = generateBrochureUrl(TEST_CONTACT_ID, TEST_SECRET, customBase)
-      expect(url).toMatch(/^https:\/\/custom\.example\.com\/brochure\//)
-      expect(url).toContain(TEST_CONTACT_ID)
-    })
-
-    it('generates verifiable token in URL', () => {
-      const url = generateBrochureUrl(TEST_CONTACT_ID, TEST_SECRET)
-      const tokenMatch = url.match(/\?t=([0-9a-f]{16})$/)
-      expect(tokenMatch).not.toBeNull()
-
-      const extractedToken = tokenMatch![1]
-      const isValid = verifyHmacToken(TEST_CONTACT_ID, extractedToken, TEST_SECRET)
-      expect(isValid).toBe(true)
-    })
-  })
-})
+import { describe, it, expect } from 'vitest'
+import { generateHmacToken, verifyHmacToken, generateBrochureUrl } from './server/hmac'
+
+describe('HMAC Token Utilities', () => {
+  const TEST_SECRET = 'test-secret-key-12345'
+  const TEST_CONTACT_ID = '550e8400-e29b-41d4-a716-446655440000'
+
+  describe('generateHmacToken', () => {
+    it('returns 16-character hex token', () => {
+      const token = generateHmacToken('test-data', TEST_SECRET)
+      expect(token).toHaveLength(16)
+      expect(token).toMatch(/^[0-9a-f]{16}$/)
+    })
+
+    it('produces consistent tokens for same input', () => {
+      const token1 = generateHmacToken('test@example.com', TEST_SECRET)
+      const token2 = generateHmacToken('test@example.com', TEST_SECRET)
+      expect(token1).toBe(token2)
+    })
+
+    it('normalizes input (lowercase and trim)', () => {
+      const token1 = generateHmacToken('TEST@EXAMPLE.COM', TEST_SECRET)
+      const token2 = generateHmacToken('  test@example.com  ', TEST_SECRET)
+      const token3 = generateHmacToken('test@example.com', TEST_SECRET)
+      expect(token1).toBe(token2)
+      expect(token2).toBe(token3)
+    })
+
+    it('produces different tokens for different secrets', () => {
+      const token1 = generateHmacToken('data', 'secret1')
+      const token2 = generateHmacToken('data', 'secret2')
+      expect(token1).not.toBe(token2)
+    })
+
+    it('produces different tokens for different data', () => {
+      const token1 = generateHmacToken('data1', TEST_SECRET)
+      const token2 = generateHmacToken('data2', TEST_SECRET)
+      expect(token1).not.toBe(token2)
+    })
+  })
+
+  describe('verifyHmacToken', () => {
+    it('returns true for valid token', () => {
+      const token = generateHmacToken(TEST_CONTACT_ID, TEST_SECRET)
+      const isValid = verifyHmacToken(TEST_CONTACT_ID, token, TEST_SECRET)
+      expect(isValid).toBe(true)
+    })
+
+    it('returns false for invalid token', () => {
+      const isValid = verifyHmacToken(TEST_CONTACT_ID, 'invalid-token-00', TEST_SECRET)
+      expect(isValid).toBe(false)
+    })
+
+    it('returns false for wrong length token', () => {
+      const isValid = verifyHmacToken(TEST_CONTACT_ID, 'short', TEST_SECRET)
+      expect(isValid).toBe(false)
+    })
+
+    it('returns false for wrong secret', () => {
+      const token = generateHmacToken(TEST_CONTACT_ID, TEST_SECRET)
+      const isValid = verifyHmacToken(TEST_CONTACT_ID, token, 'wrong-secret')
+      expect(isValid).toBe(false)
+    })
+
+    it('verifies with normalized input', () => {
+      const token = generateHmacToken('test@example.com', TEST_SECRET)
+      const isValid = verifyHmacToken('  TEST@EXAMPLE.COM  ', token, TEST_SECRET)
+      expect(isValid).toBe(true)
+    })
+  })
+
+  describe('generateBrochureUrl', () => {
+    it('generates URL with default base', () => {
+      const url = generateBrochureUrl(TEST_CONTACT_ID, TEST_SECRET)
+      expect(url).toMatch(/^https:\/\/brochure\.elevasis\.io\//)
+      expect(url).toContain(TEST_CONTACT_ID)
+      expect(url).toMatch(/\?t=[0-9a-f]{16}$/)
+    })
+
+    it('generates URL with custom base', () => {
+      const customBase = 'https://custom.example.com/brochure'
+      const url = generateBrochureUrl(TEST_CONTACT_ID, TEST_SECRET, customBase)
+      expect(url).toMatch(/^https:\/\/custom\.example\.com\/brochure\//)
+      expect(url).toContain(TEST_CONTACT_ID)
+    })
+
+    it('generates verifiable token in URL', () => {
+      const url = generateBrochureUrl(TEST_CONTACT_ID, TEST_SECRET)
+      const tokenMatch = url.match(/\?t=([0-9a-f]{16})$/)
+      expect(tokenMatch).not.toBeNull()
+
+      const extractedToken = tokenMatch![1]
+      const isValid = verifyHmacToken(TEST_CONTACT_ID, extractedToken, TEST_SECRET)
+      expect(isValid).toBe(true)
+    })
+  })
+})

package/src/platform/utils/index.ts

@@ -1,32 +1,32 @@
-/**
- * Core utility functions
- */
-
-export { debounce } from './debounce'
-export { errorToString, getErrorDetails } from './error'
-export { formatCurrency, formatCurrencyPrecise, formatCurrencyCompact, parseCurrency } from './currency'
-export { estimateTokens, validateTokenLimit, TOKEN_LIMITS } from './token-counter'
-export type { TokenCountResult, TokenLimits } from './token-counter'
-export {
-  UuidSchema,
-  NonEmptyStringSchema,
-  EmailSchema,
-  UrlSchema,
-  PaginationSchema,
-  TimestampSchema,
-  DateRangeSchema,
-  ResourceTypeSchema,
-  OriginResourceTypeSchema,
-  CredentialNameSchema,
-  OrganizationIdSchema,
-  OAuthProviderSchema,
-  OAuthCodeSchema,
-  OAuthStateParamSchema,
-  SanitizedStringSchema,
-  createEnumSchema,
-  createStringSchema,
-  createArraySchema,
-  createPayloadSizeValidator,
-  formatZodValidationError
-} from './validation'
-export type { PaginationParams, DateRange, ValidationErrorResponse, PaginatedResponse } from './validation'
+/**
+ * Core utility functions
+ */
+
+export { debounce } from './debounce'
+export { errorToString, getErrorDetails } from './error'
+export { formatCurrency, formatCurrencyPrecise, formatCurrencyCompact, parseCurrency } from './currency'
+export { estimateTokens, validateTokenLimit, TOKEN_LIMITS } from './token-counter'
+export type { TokenCountResult, TokenLimits } from './token-counter'
+export {
+  UuidSchema,
+  NonEmptyStringSchema,
+  EmailSchema,
+  UrlSchema,
+  PaginationSchema,
+  TimestampSchema,
+  DateRangeSchema,
+  ResourceTypeSchema,
+  OriginResourceTypeSchema,
+  CredentialNameSchema,
+  OrganizationIdSchema,
+  OAuthProviderSchema,
+  OAuthCodeSchema,
+  OAuthStateParamSchema,
+  SanitizedStringSchema,
+  createEnumSchema,
+  createStringSchema,
+  createArraySchema,
+  createPayloadSizeValidator,
+  formatZodValidationError
+} from './validation'
+export type { PaginationParams, DateRange, ValidationErrorResponse, PaginatedResponse } from './validation'