@pfm-platform/shared 0.1.0

package/dist/index.js

@@ -0,0 +1,1311 @@
+import { createContext, useState, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+import { z } from 'zod';
+
+// src/contexts/AppModeContext.tsx
+var AppModeContext = createContext({
+  mode: "user",
+  setMode: () => {
+    console.warn("AppModeContext.setMode called outside of AppModeProvider");
+  }
+});
+function AppModeProvider({
+  children,
+  initialMode = "user"
+}) {
+  const [mode, setMode] = useState(initialMode);
+  return /* @__PURE__ */ jsx(AppModeContext.Provider, { value: { mode, setMode }, children });
+}
+function useAppMode() {
+  const context = useContext(AppModeContext);
+  if (!context) {
+    throw new Error("useAppMode must be used within AppModeProvider");
+  }
+  return context;
+}
+var AccountTypeSchema = z.enum([
+  "checking",
+  "savings",
+  "cards",
+  "student_loans",
+  "bill",
+  "autos",
+  "home",
+  "investment",
+  "loan",
+  "asset",
+  "cd",
+  "money_market",
+  "certificates",
+  "commercial",
+  "creditline"
+]);
+var AccountStateSchema = z.enum([
+  "active",
+  "closed",
+  "archived",
+  "pending_deletion"
+]);
+var AggregationTypeSchema = z.enum([
+  "finicity",
+  "cashedge",
+  "partner"
+]);
+var PreferredBalanceTypeSchema = z.enum([
+  "Available",
+  "Current",
+  "Outstanding"
+]);
+var FinancialInstitutionSchema = z.object({
+  id: z.number().int(),
+  name: z.string()
+}).nullable();
+var CashEdgeAccountTypeSchema = z.object({
+  name: z.string(),
+  acct_type: z.string(),
+  ext_type: z.string(),
+  group: z.string()
+}).nullable();
+var AccountErrorSchema = z.object({
+  message: z.string(),
+  code: z.string(),
+  actionable: z.boolean(),
+  description: z.string().optional()
+  // Finicity-specific field
+}).nullable();
+var OtherBalanceSchema = z.object({
+  balance_type: z.string(),
+  balance: z.string().regex(/^\d+\.\d+$/)
+});
+var AccountSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.number().int().positive(),
+  name: z.string().min(1),
+  // ========================================
+  // Balance Fields (STRINGS, not numbers!)
+  // ========================================
+  balance: z.string().regex(/^-?\d+\.\d{1,2}$/, {
+    message: 'Balance must be a string in format "1234.56" with 1-2 decimal places'
+  }),
+  locked_balance: z.string().regex(/^-?\d+\.\d+$/).nullable().optional(),
+  preferred_balance_type: PreferredBalanceTypeSchema.nullable().optional(),
+  // ========================================
+  // Type and State
+  // ========================================
+  account_type: AccountTypeSchema,
+  display_account_type: z.string().optional(),
+  state: AccountStateSchema,
+  // ========================================
+  // Aggregation Fields
+  // ========================================
+  aggregation_type: AggregationTypeSchema,
+  reference_id: z.string().optional(),
+  harvest_updated_at: z.string().datetime().nullable(),
+  // ========================================
+  // Include Flags (6 booleans)
+  // ========================================
+  include_in_expenses: z.boolean(),
+  include_in_budget: z.boolean(),
+  include_in_cashflow: z.boolean(),
+  include_in_dashboard: z.boolean(),
+  include_in_goals: z.boolean(),
+  include_in_networth: z.boolean(),
+  // ========================================
+  // Nested Objects
+  // ========================================
+  fi: FinancialInstitutionSchema,
+  cashedge_account_type: CashEdgeAccountTypeSchema,
+  error: AccountErrorSchema.optional(),
+  other_balances: z.array(OtherBalanceSchema).optional()
+});
+var AccountsResponseSchema = z.object({
+  accounts: z.array(AccountSchema)
+});
+var AccountCreateSchemaAdmin = z.object({
+  name: z.string().optional().default("Test Account"),
+  balance: z.string().optional().default("1000.00"),
+  account_type: AccountTypeSchema.optional().default("checking"),
+  state: AccountStateSchema.optional().default("active"),
+  aggregation_type: AggregationTypeSchema.optional().default("partner"),
+  // Include flags - all optional with defaults
+  include_in_expenses: z.boolean().optional().default(true),
+  include_in_budget: z.boolean().optional().default(true),
+  include_in_cashflow: z.boolean().optional().default(true),
+  include_in_dashboard: z.boolean().optional().default(true),
+  include_in_goals: z.boolean().optional().default(false),
+  include_in_networth: z.boolean().optional().default(true),
+  // Optional fields
+  locked_balance: z.string().regex(/^-?\d+\.\d+$/).nullable().optional(),
+  preferred_balance_type: PreferredBalanceTypeSchema.nullable().optional(),
+  display_account_type: z.string().optional(),
+  reference_id: z.string().optional(),
+  harvest_updated_at: z.string().datetime().nullable().optional(),
+  other_balances: z.array(OtherBalanceSchema).optional().default([]),
+  // Nested objects
+  fi: FinancialInstitutionSchema.optional(),
+  cashedge_account_type: CashEdgeAccountTypeSchema.optional(),
+  error: AccountErrorSchema.optional()
+}).strict();
+var AccountCreateSchemaUser = AccountSchema.omit({
+  id: true
+}).strict();
+var AccountCreateSchema = AccountCreateSchemaUser;
+var AccountUpdateSchema = AccountSchema.partial().required({
+  id: true
+});
+var AccountDeleteSchema = z.object({
+  id: z.number().int().positive()
+});
+var AccountArchiveSchema = z.object({
+  id: z.number().int().positive()
+});
+var PendingAccountSchema = z.object({
+  account_ids: z.array(z.number().int()),
+  institution_id: z.number().int()
+});
+var PendingAccountsResponseSchema = z.object({
+  pending_accounts: z.array(PendingAccountSchema)
+});
+var PendingAccountDeleteSchema = z.object({
+  accountId: z.number().int().positive()
+});
+var InvestmentHoldingSchema = z.object({
+  symbol: z.string(),
+  description: z.string().optional(),
+  quantity: z.number().finite(),
+  price: z.number().finite().positive(),
+  value: z.string().regex(/^\d+\.\d{2}$/),
+  // String format like other amounts
+  cost_basis: z.string().regex(/^\d+\.\d{2}$/).optional(),
+  unrealized_gain_loss: z.string().regex(/^-?\d+\.\d{2}$/).optional()
+});
+var InvestmentSchema = z.object({
+  account_id: z.number().int(),
+  holdings: z.array(InvestmentHoldingSchema),
+  total_value: z.string().regex(/^\d+\.\d{2}$/)
+});
+var InvestmentsResponseSchema = z.object({
+  investments: z.array(InvestmentSchema)
+});
+var TransactionTypeSchema = z.enum(["Debit", "Credit"]);
+var TransactionTagSchema = z.object({
+  name: z.string(),
+  balance: z.number().finite()
+});
+var TransactionLinksSchema = z.object({
+  account: z.number().int()
+});
+var TransactionSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.string().regex(/^\d{4}_\d{2}_\d{2}_\w+_\d+$/, {
+    message: "Transaction ID must be in format YYYY_MM_DD_referenceId_accountId"
+  }),
+  reference_id: z.string(),
+  // ========================================
+  // Transaction Details
+  // ========================================
+  transaction_type: TransactionTypeSchema,
+  memo: z.string().nullable().optional(),
+  balance: z.number().finite().positive(),
+  // NUMBER in legacy data, not string
+  // ========================================
+  // Timestamps
+  // ========================================
+  // Note: Legacy uses RFC 3339 format with offset (e.g., "2020-08-06T00:00:00.000+00:00")
+  // Zod's .datetime() is too strict (requires 'Z'), so we use string validation
+  posted_at: z.string(),
+  created_at: z.string(),
+  deleted_at: z.string().nullable().optional(),
+  // ========================================
+  // Names
+  // ========================================
+  nickname: z.string(),
+  original_name: z.string(),
+  // ========================================
+  // Optional Fields
+  // ========================================
+  check_number: z.string().nullable().optional(),
+  // ========================================
+  // Nested Objects
+  // ========================================
+  tags: z.array(TransactionTagSchema),
+  links: TransactionLinksSchema
+});
+var TransactionsResponseSchema = z.object({
+  transactions: z.array(TransactionSchema)
+});
+var TransactionCreateSchemaAdmin = z.object({
+  reference_id: z.string(),
+  transaction_type: TransactionTypeSchema,
+  balance: z.number().positive(),
+  posted_at: z.string(),
+  nickname: z.string().optional().default("Test Transaction"),
+  original_name: z.string().optional().default("Test Transaction"),
+  memo: z.string().nullable().optional(),
+  check_number: z.string().nullable().optional(),
+  deleted_at: z.string().nullable().optional(),
+  tags: z.array(TransactionTagSchema).optional().default([]),
+  links: TransactionLinksSchema
+}).strict();
+var TransactionCreateSchemaUser = TransactionSchema.omit({
+  id: true,
+  created_at: true
+}).strict();
+var TransactionCreateSchema = TransactionCreateSchemaUser;
+var TransactionUpdateSchema = TransactionSchema.pick({
+  id: true,
+  nickname: true,
+  tags: true
+}).strict();
+var TransactionTaggingRegularSchema = z.object({
+  type: z.literal("regular"),
+  repeat: z.boolean(),
+  // Apply to all future matching transactions
+  regular: z.array(z.string())
+  // Tag names
+});
+var TransactionTaggingSplitItemSchema = z.object({
+  name: z.string(),
+  // Tag name
+  value: z.number().finite().positive()
+  // Split amount
+});
+var TransactionTaggingSplitSchema = z.object({
+  type: z.literal("split"),
+  split: z.array(TransactionTaggingSplitItemSchema)
+});
+var TransactionTaggingSchema = z.discriminatedUnion("type", [
+  TransactionTaggingRegularSchema,
+  TransactionTaggingSplitSchema
+]);
+var TransactionSearchParamsSchema = z.object({
+  begin_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  // RFC 3339 date "2020-01-01"
+  end_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  // RFC 3339 date "2020-12-31"
+  q: z.string().optional(),
+  // Search query
+  untagged: z.enum(["0", "1"]).optional(),
+  // "0" = false, "1" = true
+  tags: z.array(z.string()).optional()
+  // Filter by tag names
+});
+var TransactionDeleteSchema = z.object({
+  id: z.string().regex(/^\d{4}_\d{2}_\d{2}_\w+_\d+$/, {
+    message: "Transaction ID must be in format YYYY_MM_DD_referenceId_accountId"
+  })
+});
+var CashflowEventTypeSchema = z.enum(["bill", "income"]);
+var RecurrenceFrequencySchema = z.enum([
+  "once",
+  "weekly",
+  "biweekly",
+  "monthly",
+  "quarterly",
+  "yearly"
+]);
+var CashflowEventSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.string().uuid(),
+  event_id: z.string(),
+  // Links to recurring series if applicable
+  // ========================================
+  // Event Details
+  // ========================================
+  name: z.string().min(1).max(255),
+  amount: z.number().finite().positive(),
+  memo: z.string().nullable().optional(),
+  // ========================================
+  // Scheduling
+  // ========================================
+  scheduled_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, {
+    message: "Scheduled date must be in format YYYY-MM-DD"
+  }),
+  // ========================================
+  // Type and Status
+  // ========================================
+  event_type: CashflowEventTypeSchema,
+  is_paid: z.boolean().default(false),
+  is_recurring: z.boolean().default(false),
+  recurrence_frequency: RecurrenceFrequencySchema.optional(),
+  // ========================================
+  // Metadata
+  // ========================================
+  created_at: z.string(),
+  updated_at: z.string(),
+  // ========================================
+  // Links
+  // ========================================
+  account_id: z.number().int().nullable().optional(),
+  transaction_id: z.string().nullable().optional()
+  // Links to actual transaction when paid
+});
+var CashflowEventCreateSchema = CashflowEventSchema.omit({
+  id: true,
+  created_at: true,
+  updated_at: true,
+  transaction_id: true
+  // Cannot link to transaction at creation
+}).strict();
+var CashflowEventUpdateSchema = CashflowEventSchema.pick({
+  id: true,
+  name: true,
+  amount: true,
+  memo: true,
+  scheduled_date: true,
+  is_paid: true
+}).strict();
+var CashflowEventFilterSchema = z.object({
+  start_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  end_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  event_type: z.enum(["all", "bill", "income"]).default("all"),
+  include_paid: z.boolean().default(false)
+});
+var CashflowEventsResponseSchema = z.object({
+  events: z.array(CashflowEventSchema)
+});
+var BudgetStateSchema = z.enum(["under", "risk", "over"]);
+var BudgetLinksSchema = z.object({
+  accounts: z.array(z.number().int()),
+  budget_histories: z.array(z.number().int())
+});
+var BudgetSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.number().int().positive(),
+  // ========================================
+  // Time Period
+  // ========================================
+  month: z.number().int().min(1).max(12),
+  year: z.number().int(),
+  // ========================================
+  // Budget Details
+  // ========================================
+  name: z.string().max(255),
+  state: BudgetStateSchema,
+  spent: z.number().finite(),
+  // NUMBER in legacy data, not string
+  budget_amount: z.number().finite().positive(),
+  // NUMBER in legacy data, not string
+  // ========================================
+  // Category Association
+  // ========================================
+  tag_names: z.array(z.string()),
+  // ========================================
+  // Related Resources
+  // ========================================
+  links: BudgetLinksSchema
+});
+var BudgetsResponseSchema = z.object({
+  budgets: z.array(BudgetSchema)
+});
+var BudgetCreateSchema = z.object({
+  name: z.string().max(255),
+  budget_amount: z.number().finite().positive(),
+  tag_names: z.array(z.string()),
+  account_list: z.array(z.number().int()).optional(),
+  // Becomes links.accounts in response
+  show_on_dashboard: z.boolean().optional(),
+  other: z.boolean().optional()
+}).strict();
+var BudgetUpdateSchema = z.object({
+  id: z.number().int().positive(),
+  name: z.string().max(255),
+  budget_amount: z.number().finite().positive(),
+  tag_names: z.array(z.string()),
+  account_list: z.array(z.number().int()).optional(),
+  show_on_dashboard: z.boolean().optional(),
+  other: z.boolean().optional()
+}).strict();
+var GoalStateSchema = z.enum(["active", "completed", "archived"]);
+var GoalStatusSchema = z.enum(["complete", "over", "risk", "under"]);
+var GoalLinksSchema = z.object({
+  accounts: z.array(z.number().int())
+});
+var BaseGoalSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.number().int().positive(),
+  // ========================================
+  // Goal Details
+  // ========================================
+  name: z.string().max(255),
+  state: GoalStateSchema,
+  status: GoalStatusSchema,
+  // ========================================
+  // Visual Elements
+  // ========================================
+  image_name: z.string(),
+  image_url: z.string(),
+  // ========================================
+  // Progress Tracking
+  // ========================================
+  percent_complete: z.number().int().min(0).max(100),
+  complete: z.boolean(),
+  // ========================================
+  // Monetary Values (STRINGS with decimal pattern)
+  // ========================================
+  initial_value: z.string().regex(/^\d+\.\d{2}$/),
+  current_value: z.string().regex(/^\d+\.\d{2}$/),
+  target_value: z.string().regex(/^\d+\.\d{2}$/),
+  monthly_contribution: z.string().regex(/^\d+\.\d{2}$/),
+  remaining_monthly_contribution: z.string().regex(/^\d+\.\d{2}$/),
+  // ========================================
+  // Optional Fields
+  // ========================================
+  current_progress: z.string().regex(/^\d+\.\d{2}$/).optional(),
+  target_contribution: z.string().regex(/^\d+\.\d{2}$/).optional(),
+  target_completion_on: z.string(),
+  // Date string YYYY-MM-DD
+  // ========================================
+  // Timestamps
+  // ========================================
+  // Note: Using string validation (not .datetime()) for legacy RFC 3339 format
+  created_at: z.string(),
+  updated_at: z.string(),
+  // ========================================
+  // Related Resources
+  // ========================================
+  links: GoalLinksSchema
+});
+var SavingsGoalSchema = BaseGoalSchema.extend({
+  // Savings goals may have weight for distributing account balance
+  weight: z.number().int().min(1).max(99).optional()
+});
+var PayoffGoalSchema = BaseGoalSchema;
+var GoalCreateSchema = z.object({
+  name: z.string().max(255),
+  state: GoalStateSchema.optional(),
+  image_name: z.string(),
+  target_value: z.string().regex(/^\d+\.\d{2}$/),
+  target_completion_on: z.string().optional(),
+  target_contribution: z.string().regex(/^\d+\.\d{2}$/).optional(),
+  account_ids: z.array(z.number().int()).optional()
+  // Becomes links.accounts in response
+}).strict();
+var GoalUpdateSchema = z.object({
+  id: z.number().int().positive(),
+  name: z.string().max(255),
+  state: GoalStateSchema.optional(),
+  image_name: z.string(),
+  target_value: z.string().regex(/^\d+\.\d{2}$/),
+  target_completion_on: z.string().optional(),
+  target_contribution: z.string().regex(/^\d+\.\d{2}$/).optional(),
+  account_ids: z.array(z.number().int()).optional()
+}).strict();
+var SavingsGoalsResponseSchema = z.object({
+  savings_goals: z.array(SavingsGoalSchema)
+});
+var PayoffGoalsResponseSchema = z.object({
+  payoff_goals: z.array(PayoffGoalSchema)
+});
+var GoalImagesResponseSchema = z.object({
+  images: z.array(
+    z.object({
+      id: z.number().int().positive(),
+      name: z.string(),
+      url: z.string()
+    })
+  )
+});
+var UserSexSchema = z.enum(["Male", "Female"]);
+var UserSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.string(),
+  // Partner customer ID (STRING, not integer)
+  login: z.string(),
+  email: z.string().email(),
+  // ========================================
+  // Login Tracking
+  // ========================================
+  login_count: z.number().int().nonnegative(),
+  last_login_at: z.string(),
+  // RFC 3339 datetime format
+  // ========================================
+  // Customization
+  // ========================================
+  custom_tags: z.array(z.string()),
+  custom_settings: z.object({}).passthrough(),
+  // Arbitrary key-value pairs
+  // ========================================
+  // Profile Information
+  // ========================================
+  first_name: z.string(),
+  last_name: z.string(),
+  postal_code: z.string(),
+  birth_year: z.number().int().min(1901),
+  sex: UserSexSchema,
+  // ========================================
+  // Optional Location Fields
+  // ========================================
+  // Note: city and state appear in OpenAPI but not in legacy mock data
+  city: z.string().optional(),
+  state: z.string().optional()
+});
+var UserCreateSchemaAdmin = z.object({
+  login: z.string(),
+  email: z.string(),
+  // Simple validation for test data
+  first_name: z.string().optional().default("Test"),
+  last_name: z.string().optional().default("User"),
+  postal_code: z.string().optional().default("00000"),
+  birth_year: z.number().int().min(1901).optional().default(1990),
+  sex: UserSexSchema.optional().default("Male"),
+  custom_tags: z.array(z.string()).optional().default([]),
+  custom_settings: z.object({}).passthrough().optional().default({}),
+  city: z.string().optional(),
+  state: z.string().optional()
+}).strict();
+var UserCreateSchemaUser = z.object({
+  login: z.string().min(3, "Login must be at least 3 characters"),
+  email: z.string().email("Valid email address required"),
+  first_name: z.string().min(1, "First name is required"),
+  last_name: z.string().min(1, "Last name is required"),
+  postal_code: z.string().min(5, "Valid postal code required"),
+  birth_year: z.number().int().min(1901).max((/* @__PURE__ */ new Date()).getFullYear() - 13, "Must be at least 13 years old"),
+  sex: UserSexSchema,
+  custom_tags: z.array(z.string()).optional(),
+  custom_settings: z.object({}).passthrough().optional(),
+  city: z.string().optional(),
+  state: z.string().optional()
+}).strict();
+var UserCreateSchema = UserCreateSchemaUser;
+var UserUpdateSchemaAdmin = z.object({
+  email: z.string().optional(),
+  first_name: z.string().optional(),
+  last_name: z.string().optional(),
+  postal_code: z.string().optional(),
+  birth_year: z.number().int().min(1901).optional(),
+  sex: UserSexSchema.optional(),
+  custom_tags: z.array(z.string()).optional(),
+  custom_settings: z.object({}).passthrough().optional(),
+  city: z.string().optional(),
+  state: z.string().optional()
+}).strict();
+var UserUpdateSchemaUser = z.object({
+  email: z.string().email("Valid email address required"),
+  first_name: z.string().min(1, "First name is required"),
+  last_name: z.string().min(1, "Last name is required"),
+  postal_code: z.string().min(5, "Valid postal code required"),
+  birth_year: z.number().int().min(1901).max((/* @__PURE__ */ new Date()).getFullYear() - 13, "Must be at least 13 years old"),
+  sex: UserSexSchema,
+  custom_tags: z.array(z.string()).optional(),
+  custom_settings: z.object({}).passthrough().optional(),
+  city: z.string().optional(),
+  state: z.string().optional()
+}).strict();
+var UserUpdateSchema = UserUpdateSchemaUser;
+var UserTagsSchema = z.object({
+  userTags: z.array(z.string())
+});
+var DefaultTagsSchema = z.object({
+  defaultTags: z.array(z.string())
+});
+var TagsResponseSchema = z.object({
+  userTags: z.array(z.string()),
+  defaultTags: z.array(z.string())
+});
+var TagsUpdateSchema = z.array(z.string()).min(0);
+var TagCreateSchemaAdmin = z.object({
+  name: z.string()
+});
+var TagCreateSchemaUser = z.object({
+  name: z.string().min(1, "Tag name is required").max(50, "Tag name must be 50 characters or less").regex(/^[a-zA-Z0-9\s\-_]+$/, "Tag name can only contain letters, numbers, spaces, hyphens, and underscores")
+});
+var TagDeleteSchema = z.object({
+  name: z.string().min(1)
+});
+var TagUsageStatSchema = z.object({
+  tag: z.string(),
+  count: z.number().int().nonnegative()
+});
+var TagUsageStatsSchema = z.object({
+  stats: z.array(TagUsageStatSchema)
+});
+var TagColorSchema = z.object({
+  color: z.string().regex(/^#[0-9A-Fa-f]{6}$/, "Color must be a valid hex code")
+});
+var TagUsageDataPointSchema = z.object({
+  date: z.string(),
+  // ISO date string
+  count: z.number().int().nonnegative()
+});
+var TagReportItemSchema = z.object({
+  tag: z.string(),
+  totalCount: z.number().int().nonnegative(),
+  dataPoints: z.array(TagUsageDataPointSchema)
+});
+var TagUsageReportSchema = z.object({
+  report: z.array(TagReportItemSchema),
+  startDate: z.string().optional(),
+  endDate: z.string().optional()
+});
+var AlertTypeSchema = z.enum([
+  "AccountThresholdAlert",
+  "GoalAlert",
+  "MerchantNameAlert",
+  "SpendingTargetAlert",
+  "TransactionLimitAlert",
+  "UpcomingBillAlert"
+]);
+var AlertSourceTypeSchema = z.enum([
+  "Account",
+  "Budget",
+  "CashflowTransaction",
+  "PayoffGoal",
+  "SavingsGoal"
+]).nullable();
+var AlertDestinationsSchema = z.object({
+  email_address: z.string().email().nullable(),
+  sms_number: z.string().regex(/^\d{10}$/).nullable(),
+  partner_sms_enabled: z.boolean()
+});
+var AlertSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.number().int().positive(),
+  type: AlertTypeSchema,
+  // ========================================
+  // Alert Configuration
+  // ========================================
+  options: z.object({}).passthrough(),
+  // Dynamic options per alert type
+  // ========================================
+  // Delivery Settings
+  // ========================================
+  email_delivery: z.boolean(),
+  sms_delivery: z.boolean(),
+  // ========================================
+  // Source Object Reference
+  // ========================================
+  source_type: AlertSourceTypeSchema,
+  source_id: z.union([z.string(), z.number().int()]).optional(),
+  // STRING in legacy ("41"), but can be int
+  // ========================================
+  // Full Source Object (Nested)
+  // ========================================
+  // Note: Source is fully nested Account, Goal, Budget, etc. object
+  // Using unknown for flexibility since it's a oneOf in OpenAPI
+  source: z.unknown().optional()
+});
+var AlertCreateSchema = z.object({
+  options: z.object({}).passthrough(),
+  email_delivery: z.boolean(),
+  sms_delivery: z.boolean(),
+  source_type: AlertSourceTypeSchema.optional(),
+  source_id: z.union([z.string(), z.number().int()]).optional()
+}).strict();
+var AlertUpdateSchema = z.object({
+  options: z.object({}).passthrough(),
+  email_delivery: z.boolean(),
+  sms_delivery: z.boolean(),
+  source_type: AlertSourceTypeSchema.optional(),
+  source_id: z.union([z.string(), z.number().int()]).optional()
+}).strict();
+var AlertDestinationsUpdateSchema = AlertDestinationsSchema;
+var AlertsResponseSchema = z.object({
+  alerts: z.array(AlertSchema)
+});
+var NotificationSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.number().int().positive(),
+  // User ID - links notification to specific user
+  user_id: z.string(),
+  // Alert ID - references the source alert that triggered this notification
+  alert_id: z.number().int().positive(),
+  // ========================================
+  // Notification Content
+  // ========================================
+  message: z.string(),
+  // ========================================
+  // Alert Reference
+  // ========================================
+  // Links to Alert domain - uses same AlertType enum
+  alert_type: AlertTypeSchema,
+  // ========================================
+  // Read Status
+  // ========================================
+  // Tracks whether user has read this notification
+  is_read: z.boolean().default(false),
+  // ========================================
+  // Timestamps
+  // ========================================
+  // RFC 3339 datetime string (e.g., "2018-01-01T16:54:15Z")
+  created_at: z.string()
+});
+var NotificationsResponseSchema = z.object({
+  notifications: z.array(NotificationSchema)
+});
+var NotificationCreateSchemaAdmin = z.object({
+  message: z.string(),
+  alert_type: AlertTypeSchema,
+  created_at: z.string().optional()
+  // Optional, defaults to now
+});
+var NotificationCreateSchemaUser = z.never();
+var NotificationUpdateSchemaAdmin = z.object({
+  message: z.string().optional(),
+  alert_type: AlertTypeSchema.optional()
+});
+var NotificationUpdateSchemaUser = z.object({
+  is_read: z.boolean().optional()
+});
+var NotificationFrequencySchema = z.enum(["realtime", "daily", "weekly"]);
+var NotificationPreferencesSchema = z.object({
+  emailNotifications: z.boolean(),
+  pushNotifications: z.boolean(),
+  frequency: NotificationFrequencySchema
+});
+var NotificationPreferencesUpdateSchema = z.object({
+  emailNotifications: z.boolean().optional(),
+  pushNotifications: z.boolean().optional(),
+  frequency: NotificationFrequencySchema.optional()
+});
+var PartnerSchema = z.object({
+  // ========================================
+  // Core Identifiers
+  // ========================================
+  id: z.number().int().positive(),
+  // ========================================
+  // Partner Configuration
+  // ========================================
+  domain: z.string(),
+  product_name: z.string(),
+  browser_title: z.string(),
+  // ========================================
+  // Feature Flags
+  // ========================================
+  partner_alerts_enabled: z.boolean(),
+  demo: z.boolean(),
+  // ========================================
+  // Dynamic Configuration Objects
+  // ========================================
+  // Modules contains partner-specific feature configuration
+  // Structure varies by partner (aggregation, mobile, etc.)
+  modules: z.object({}).passthrough(),
+  // Featured searches configuration array
+  featured_searches: z.array(z.unknown())
+});
+var PartnersResponseSchema = z.object({
+  partners: z.array(PartnerSchema)
+});
+var PartnerCreateSchemaAdmin = z.object({
+  domain: z.string(),
+  product_name: z.string(),
+  browser_title: z.string(),
+  partner_alerts_enabled: z.boolean().optional().default(false),
+  demo: z.boolean().optional().default(false),
+  modules: z.object({}).passthrough().optional().default({}),
+  featured_searches: z.array(z.unknown()).optional().default([])
+});
+var PartnerCreateSchemaUser = z.never();
+var PartnerUpdateSchemaAdmin = z.object({
+  domain: z.string().optional(),
+  product_name: z.string().optional(),
+  browser_title: z.string().optional(),
+  partner_alerts_enabled: z.boolean().optional(),
+  demo: z.boolean().optional(),
+  modules: z.object({}).passthrough().optional(),
+  featured_searches: z.array(z.unknown()).optional()
+});
+var PartnerUpdateSchemaUser = z.never();
+var PartnerDeleteSchema = z.object({
+  id: z.number().int().positive()
+});
+var ExpenseSchema = z.object({
+  // ========================================
+  // Tag Reference
+  // ========================================
+  // Transaction tag/category name
+  // Uses lowercase tag names (health, diningout, insurance, etc.)
+  tag: z.string(),
+  // ========================================
+  // Aggregated Amount
+  // ========================================
+  // Total expense amount for this tag in the period
+  // STRING with decimal format: "1.74", "102.19", "1219.83"
+  amount: z.string().regex(/^\d+\.\d{2}$/)
+});
+var ExpensesResponseSchema = z.object({
+  expenses: z.array(ExpenseSchema)
+});
+var ExpenseCreateSchemaAdmin = z.object({
+  tag: z.string(),
+  amount: z.string()
+  // Will be formatted to 2 decimal places
+});
+var ExpenseCreateSchemaUser = z.never();
+var ExpenseUpdateSchemaAdmin = z.object({
+  amount: z.string().optional()
+});
+var ExpenseUpdateSchemaUser = z.never();
+var ExpenseDeleteSchema = z.object({
+  tag: z.string()
+});
+var ExpenseSearchParamsSchema = z.object({
+  begin_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+  // RFC 3339 date "2020-01-01"
+  end_on: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+  // RFC 3339 date "2020-12-31"
+  threshold: z.number().int().positive().optional()
+  // Minimum amount filter
+}).refine(
+  (data) => {
+    const hasBeginOn = data.begin_on !== void 0;
+    const hasEndOn = data.end_on !== void 0;
+    return hasBeginOn === hasEndOn;
+  },
+  {
+    message: "Both begin_on and end_on must be provided together"
+  }
+);
+var NetWorthMetaSchema = z.object({
+  net_worth: z.string().regex(/^-?\d+\.\d{2}$/),
+  net_worth_change: z.string().regex(/^-?\d+\.\d{2}$/),
+  total_assets: z.string().regex(/^-?\d+\.\d{2}$/),
+  total_debts: z.string().regex(/^-?\d+\.\d{2}$/)
+});
+var NetWorthAssetSchema = z.object({
+  id: z.number().int(),
+  name: z.string(),
+  balance: z.string().regex(/^\d+\.\d{2}$/),
+  additional_networth_account: z.boolean()
+  // true = manual account, false = aggregated
+});
+var NetWorthDebtSchema = z.object({
+  id: z.number().int(),
+  name: z.string(),
+  balance: z.string().regex(/^\d+\.\d{2}$/),
+  additional_networth_account: z.boolean()
+  // true = manual account, false = aggregated
+});
+var NetWorthHistorySchema = z.object({
+  total: z.string().regex(/^-?\d+\.\d{2}$/),
+  // Net worth for month
+  total_asset: z.string().regex(/^\d+\.\d{2}$/),
+  total_debt: z.string().regex(/^\d+\.\d{2}$/),
+  month: z.string().regex(/^\d{2}$/),
+  // "04"
+  year: z.string().regex(/^\d{4}$/),
+  // "2019"
+  since_last_month: z.string().regex(/^-?\d+\.\d{2}$/)
+  // Change from previous month
+});
+var NetWorthSchema = z.object({
+  meta: NetWorthMetaSchema,
+  assets: z.array(NetWorthAssetSchema),
+  debts: z.array(NetWorthDebtSchema),
+  networth_histories: z.array(NetWorthHistorySchema)
+});
+var NetWorthResponseSchema = NetWorthSchema;
+var NetWorthAccountTypeSchema = z.enum(["asset", "debt"]);
+var NetWorthAccountCreateSchema = z.object({
+  networth_account: z.object({
+    account_type: NetWorthAccountTypeSchema,
+    balance: z.string(),
+    // Will be validated as decimal
+    name: z.string().min(1).max(255)
+  })
+});
+var NetWorthAccountUpdateSchema = z.object({
+  networth_account: z.object({
+    account_type: NetWorthAccountTypeSchema.optional(),
+    balance: z.string().optional(),
+    // Will be validated as decimal
+    name: z.string().min(1).max(255).optional()
+  })
+});
+var NetWorthAccountDeleteSchema = z.object({
+  id: z.number().int().positive()
+});
+var InstitutionLoginParameterSchema = z.object({
+  parameter_id: z.string(),
+  // e.g., "username", "password", "security_question"
+  label: z.string(),
+  // Display label: "User ID", "Password"
+  type: z.string()
+  // Input type: "text", "password", "select"
+});
+var InstitutionSearchMetaSchema = z.object({
+  page: z.number().int().positive(),
+  total_pages: z.number().int().nonnegative(),
+  total_results: z.number().int().nonnegative()
+});
+var InstitutionSchema = z.object({
+  id: z.number().int(),
+  name: z.string(),
+  home_url: z.string().url(),
+  ce_login_parameters: z.array(InstitutionLoginParameterSchema)
+});
+var InstitutionsResponseSchema = z.object({
+  ce_fis: z.array(InstitutionSchema),
+  meta: InstitutionSearchMetaSchema
+});
+var AuthenticateRequestSchema = z.object({
+  id: z.number().int(),
+  // Institution ID
+  credentials: z.object({
+    login_params: z.record(z.string(), z.string())
+    // Dynamic key-value pairs
+  })
+});
+var AuthenticateResponseSchema = z.object({
+  harvest_id: z.string(),
+  login_id: z.string(),
+  status: z.string()
+  // "pending", "success", "mfa_required", "error"
+});
+var MFARequestSchema = z.object({
+  harvest_id: z.string(),
+  login_id: z.string(),
+  session_key: z.string(),
+  mfa_responses: z.record(z.string(), z.string())
+  // Dynamic MFA responses
+});
+var MFAResponseSchema = z.object({
+  status: z.string(),
+  // "success", "error", "pending"
+  message: z.string().optional()
+});
+var UpdateCredentialsRequestSchema = z.object({
+  id: z.number().int(),
+  // Institution ID
+  credentials: z.object({
+    login_params: z.record(z.string(), z.string())
+    // Dynamic key-value pairs
+  })
+});
+var UpdateCredentialsResponseSchema = z.object({
+  status: z.string(),
+  // "success", "error"
+  message: z.string().optional()
+});
+var ClassifyAccountsRequestSchema = z.object({
+  accounts: z.record(
+    z.string(),
+    // Account ID as string key
+    z.object({
+      type_code: z.string()
+      // "DDA,DDA" or "SAV,SAV" or "ignore"
+    })
+  )
+});
+var CashEdgeLoginRequestSchema = z.object({
+  session_token: z.string().optional(),
+  context: z.record(z.string(), z.unknown()).optional()
+});
+var CashEdgeLoginResponseSchema = z.object({
+  session_id: z.string(),
+  session_token: z.string().optional(),
+  expires_at: z.string().optional(),
+  status: z.string().optional()
+});
+
+// src/utils/chartUtils.ts
+function formatCurrency(value) {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: 0,
+    maximumFractionDigits: 0
+  }).format(value);
+}
+function formatCurrencyAbbreviated(value) {
+  const absValue = Math.abs(value);
+  const sign = value < 0 ? "-" : "";
+  if (absValue >= 1e6) {
+    return `${sign}$${(absValue / 1e6).toFixed(1)}M`;
+  }
+  if (absValue >= 1e3) {
+    return `${sign}$${(absValue / 1e3).toFixed(1)}K`;
+  }
+  return formatCurrency(value);
+}
+function formatPercentage(value) {
+  return `${value.toFixed(1)}%`;
+}
+function getChartColors(theme) {
+  return [
+    theme.palette.primary.main,
+    theme.palette.secondary.main,
+    theme.palette.success.main,
+    theme.palette.warning.main,
+    theme.palette.error.main,
+    theme.palette.info.main,
+    theme.palette.primary.light,
+    theme.palette.secondary.light,
+    theme.palette.success.light,
+    theme.palette.warning.light
+  ];
+}
+function getColorByIndex(colors, index) {
+  if (colors.length === 0) {
+    return "#000000";
+  }
+  return colors[index % colors.length];
+}
+var CHART_DIMENSIONS = {
+  donut: {
+    width: 200,
+    height: 200,
+    innerRadius: 60,
+    outerRadius: 95
+  },
+  lineChart: {
+    width: 300,
+    height: 150,
+    margin: { top: 10, right: 20, bottom: 20, left: 50 }
+  },
+  barChart: {
+    width: 300,
+    height: 160,
+    margin: { top: 20, left: 50, bottom: 40, right: 20 }
+  }
+};
+function getChartThemeConfig(theme) {
+  return {
+    backgroundColor: theme.palette.background.paper,
+    textColor: theme.palette.text.primary,
+    gridColor: theme.palette.divider,
+    tooltipBackgroundColor: theme.palette.background.paper,
+    tooltipBorderColor: theme.palette.divider
+  };
+}
+
+// src/utils/animations.ts
+var ANIMATION_DURATIONS = {
+  /** Arc/pie slice transitions (D3: 1000ms) */
+  arc: 1e3,
+  /** Text transitions (D3: 200ms) */
+  text: 200,
+  /** Meter/progress bar (D3: 600ms) */
+  meter: 600,
+  /** Settings panel slide */
+  panel: 300,
+  /** Tooltip/hover states */
+  hover: 150
+};
+var ANIMATION_EASING = {
+  /** D3 easeInOut equivalent */
+  default: [0.4, 0, 0.2, 1],
+  /** D3 easeOut equivalent */
+  easeOut: [0, 0, 0.2, 1],
+  /** D3 easeIn equivalent */
+  easeIn: [0.4, 0, 1, 1],
+  /** D3 easeLinear equivalent */
+  linear: [0, 0, 1, 1]
+};
+var arcVariants = {
+  initial: {
+    opacity: 0,
+    scale: 0.8
+  },
+  enter: {
+    opacity: 1,
+    scale: 1,
+    transition: {
+      duration: ANIMATION_DURATIONS.arc / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  exit: {
+    opacity: 0,
+    scale: 0.8,
+    transition: {
+      duration: ANIMATION_DURATIONS.arc / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  hover: {
+    scale: 1.05,
+    transition: {
+      duration: ANIMATION_DURATIONS.hover / 1e3,
+      ease: ANIMATION_EASING.easeOut
+    }
+  },
+  selected: {
+    scale: 1.1,
+    transition: {
+      duration: ANIMATION_DURATIONS.hover / 1e3,
+      ease: ANIMATION_EASING.easeOut
+    }
+  }
+};
+var textVariants = {
+  initial: {
+    opacity: 0,
+    y: -10
+  },
+  enter: {
+    opacity: 1,
+    y: 0,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  exit: {
+    opacity: 0,
+    y: 10,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  selected: {
+    y: 5,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  deselected: {
+    y: -4,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  }
+};
+var panelVariants = {
+  initial: {
+    opacity: 0,
+    x: 20
+  },
+  enter: {
+    opacity: 1,
+    x: 0,
+    transition: {
+      duration: ANIMATION_DURATIONS.panel / 1e3,
+      ease: ANIMATION_EASING.easeOut
+    }
+  },
+  exit: {
+    opacity: 0,
+    x: 20,
+    transition: {
+      duration: ANIMATION_DURATIONS.panel / 1e3,
+      ease: ANIMATION_EASING.easeIn
+    }
+  }
+};
+var fadeVariants = {
+  initial: {
+    opacity: 0
+  },
+  enter: {
+    opacity: 1,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  exit: {
+    opacity: 0,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  }
+};
+var progressVariants = {
+  initial: {
+    scaleX: 0,
+    transformOrigin: "left"
+  },
+  enter: {
+    scaleX: 1,
+    transition: {
+      duration: ANIMATION_DURATIONS.meter / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  },
+  exit: {
+    scaleX: 0,
+    transition: {
+      duration: ANIMATION_DURATIONS.meter / 1e3,
+      ease: ANIMATION_EASING.default
+    }
+  }
+};
+var listContainerVariants = {
+  initial: {
+    opacity: 0
+  },
+  enter: {
+    opacity: 1,
+    transition: {
+      staggerChildren: 0.05,
+      delayChildren: 0.1
+    }
+  },
+  exit: {
+    opacity: 0,
+    transition: {
+      staggerChildren: 0.03,
+      staggerDirection: -1
+    }
+  }
+};
+var listItemVariants = {
+  initial: {
+    opacity: 0,
+    y: 10
+  },
+  enter: {
+    opacity: 1,
+    y: 0,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.easeOut
+    }
+  },
+  exit: {
+    opacity: 0,
+    y: -10,
+    transition: {
+      duration: ANIMATION_DURATIONS.text / 1e3,
+      ease: ANIMATION_EASING.easeIn
+    }
+  }
+};
+function createTransition(duration, ease = ANIMATION_EASING.default) {
+  return {
+    duration: duration / 1e3,
+    ease
+  };
+}
+var SPRING_CONFIG = {
+  default: {
+    type: "spring",
+    stiffness: 300,
+    damping: 30
+  },
+  bouncy: {
+    type: "spring",
+    stiffness: 400,
+    damping: 20
+  },
+  slow: {
+    type: "spring",
+    stiffness: 200,
+    damping: 40
+  }
+};
+
+export { ANIMATION_DURATIONS, ANIMATION_EASING, AccountArchiveSchema, AccountCreateSchema, AccountCreateSchemaAdmin, AccountCreateSchemaUser, AccountDeleteSchema, AccountErrorSchema, AccountSchema, AccountStateSchema, AccountTypeSchema, AccountUpdateSchema, AccountsResponseSchema, AggregationTypeSchema, AlertCreateSchema, AlertDestinationsSchema, AlertDestinationsUpdateSchema, AlertSchema, AlertSourceTypeSchema, AlertTypeSchema, AlertUpdateSchema, AlertsResponseSchema, AppModeContext, AppModeProvider, AuthenticateRequestSchema, AuthenticateResponseSchema, BudgetCreateSchema, BudgetLinksSchema, BudgetSchema, BudgetStateSchema, BudgetUpdateSchema, BudgetsResponseSchema, CHART_DIMENSIONS, CashEdgeAccountTypeSchema, CashEdgeLoginRequestSchema, CashEdgeLoginResponseSchema, CashflowEventCreateSchema, CashflowEventFilterSchema, CashflowEventSchema, CashflowEventTypeSchema, CashflowEventUpdateSchema, CashflowEventsResponseSchema, ClassifyAccountsRequestSchema, DefaultTagsSchema, ExpenseCreateSchemaAdmin, ExpenseCreateSchemaUser, ExpenseDeleteSchema, ExpenseSchema, ExpenseSearchParamsSchema, ExpenseUpdateSchemaAdmin, ExpenseUpdateSchemaUser, ExpensesResponseSchema, FinancialInstitutionSchema, GoalCreateSchema, GoalImagesResponseSchema, GoalLinksSchema, GoalStateSchema, GoalStatusSchema, GoalUpdateSchema, InstitutionLoginParameterSchema, InstitutionSchema, InstitutionSearchMetaSchema, InstitutionsResponseSchema, InvestmentHoldingSchema, InvestmentSchema, InvestmentsResponseSchema, MFARequestSchema, MFAResponseSchema, NetWorthAccountCreateSchema, NetWorthAccountDeleteSchema, NetWorthAccountTypeSchema, NetWorthAccountUpdateSchema, NetWorthAssetSchema, NetWorthDebtSchema, NetWorthHistorySchema, NetWorthMetaSchema, NetWorthResponseSchema, NetWorthSchema, NotificationCreateSchemaAdmin, NotificationCreateSchemaUser, NotificationFrequencySchema, NotificationPreferencesSchema, NotificationPreferencesUpdateSchema, NotificationSchema, NotificationUpdateSchemaAdmin, NotificationUpdateSchemaUser, NotificationsResponseSchema, OtherBalanceSchema, PartnerCreateSchemaAdmin, PartnerCreateSchemaUser, PartnerDeleteSchema, PartnerSchema, PartnerUpdateSchemaAdmin, PartnerUpdateSchemaUser, PartnersResponseSchema, PayoffGoalSchema, PayoffGoalsResponseSchema, PendingAccountDeleteSchema, PendingAccountSchema, PendingAccountsResponseSchema, PreferredBalanceTypeSchema, RecurrenceFrequencySchema, SPRING_CONFIG, SavingsGoalSchema, SavingsGoalsResponseSchema, TagColorSchema, TagCreateSchemaAdmin, TagCreateSchemaUser, TagDeleteSchema, TagReportItemSchema, TagUsageDataPointSchema, TagUsageReportSchema, TagUsageStatSchema, TagUsageStatsSchema, TagsResponseSchema, TagsUpdateSchema, TransactionCreateSchema, TransactionCreateSchemaAdmin, TransactionCreateSchemaUser, TransactionDeleteSchema, TransactionLinksSchema, TransactionSchema, TransactionSearchParamsSchema, TransactionTagSchema, TransactionTaggingRegularSchema, TransactionTaggingSchema, TransactionTaggingSplitItemSchema, TransactionTaggingSplitSchema, TransactionTypeSchema, TransactionUpdateSchema, TransactionsResponseSchema, UpdateCredentialsRequestSchema, UpdateCredentialsResponseSchema, UserCreateSchema, UserCreateSchemaAdmin, UserCreateSchemaUser, UserSchema, UserSexSchema, UserTagsSchema, UserUpdateSchema, UserUpdateSchemaAdmin, UserUpdateSchemaUser, arcVariants, createTransition, fadeVariants, formatCurrency, formatCurrencyAbbreviated, formatPercentage, getChartColors, getChartThemeConfig, getColorByIndex, listContainerVariants, listItemVariants, panelVariants, progressVariants, textVariants, useAppMode };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map