feat(tables): add currency column type on a new column-type registry

Adds a `currency` column type, and consolidates the per-type knowledge it
would otherwise have been scattered across.

**Currency.** Stores a plain number and carries an ISO 4217 `currencyCode`
as display metadata. That split is what keeps it cheap: filtering, sorting,
uniqueness and CSV export all reuse the numeric paths unchanged, changing a
column's currency rewrites no rows, and the public row output stays a number
rather than a locale-formatted string consumers would have to reparse.
Input accepts the shapes an amount actually arrives in — `$1,234.56`,
`1 234,56 €`, `(12.00)` — so pastes, CSV imports and tool writes land as
numbers instead of being nulled.

**The registry.** Adding this type initially required edits in ~40 places:
32 switch arms under `lib/table`, ~26 UI branches, two hand-maintained icon
maps, and a coercion implementation duplicated four times. Every one of those
failed silently when missed — a missing `jsonbCastForType` arm compares
numbers as text; a missing compatibility arm blocks all conversions.

`lib/table/column-types/` now holds one file per type carrying its label,
icon, badge colour, storage cast, filter operators, coercion, validation,
compatibility and formatting. `Record<ColumnType, …>` on both registries is
the completeness gate: adding a type to the union is a compile error naming
exactly the two files to fill in, and the interface then requires every
field. The 32 switch arms are down to 3.

Two duplicates collapse as a consequence:

- The client no longer mirrors the server's select id-resolution. Those
  helpers lived in `validation.ts`, which imports drizzle, so anything
  reaching them became server-only and the grid hand-rolled its own copy.
  Extracting them to `select-options.ts` lets both sides share one
  implementation, so the optimistic cache can no longer disagree with what
  gets persisted.
- The two icon maps become one registry read.

It also fixes a live inconsistency it surfaced: currency got a numeric
keypad in the grid's inline editor but a plain text field in the row modal.

Behaviour-neutral by construction: all 1046 tests in the touched areas pass
unchanged, with no test edits.

Author: waleedlatif1

apps/docs/content/docs/en/tables/index.mdx

@@ -22,12 +22,16 @@ Every column has a type, which decides how its values are stored and validated.
 | --- | --- | --- |
 | **Text** | A free-form string | `"Acme Corp"` |
 | **Number** | A numeric value | `42` |
+| **Currency** | An amount in a currency you pick per column | `$1,234.56` |
 | **Boolean** | `true` or `false` | `true` |
 | **Date** | A date | `2026-03-16` |
 | **JSON** | An object or array | `{ "tier": "pro" }` |
+| **Select** | One of a fixed set of options, or several | `Pro` |
 
 Types are enforced as you enter values, so a Number column only takes numbers.
 
+A Currency column stores a plain number and renders it in the currency you choose for that column, so filters, sorts, and exports all see the amount itself. Changing a column's currency relabels it — it does not convert the amounts.
+
 ## Editing a table
 
 Open the **Tables** section in the sidebar and click **New table** to create one. Add columns from the column header, type into a cell to edit it, and paste rows from a spreadsheet to bulk-load. Filter and sort from the toolbar without changing the underlying data. The editor has full keyboard support; see [keyboard shortcuts](/keyboard-shortcuts).

apps/sim/app/api/table/[tableId]/columns/route.ts

@@ -15,6 +15,7 @@ import {
   deleteColumn,
   renameColumn,
   updateColumnConstraints,
+  updateColumnCurrency,
   updateColumnOptions,
   updateColumnType,
 } from '@/lib/table'
@@ -154,12 +155,25 @@ export const PATCH = withRouteHandler(async (request: NextRequest, context: Colu
           newType: updates.type as NonNullable<typeof updates.type>,
           ...(updates.options !== undefined ? { options: updates.options } : {}),
           ...(updates.multiple !== undefined ? { multiple: updates.multiple } : {}),
+          ...(updates.currencyCode !== undefined ? { currencyCode: updates.currencyCode } : {}),
           // Forwarded so the conversion validates against the constraint this
           // same request is about to set, not the column's current one.
           ...(updates.required !== undefined ? { required: updates.required } : {}),
         },
         requestId
       )
+    } else if (updates.currencyCode !== undefined) {
+      // Re-denominating an existing currency column: schema-only, no cell
+      // rewrite. Reached only when the type is unchanged — a conversion INTO
+      // currency carries the code through `updateColumnType` above.
+      updatedTable = await updateColumnCurrency(
+        {
+          tableId,
+          columnName: updates.name ?? validated.columnName,
+          currencyCode: updates.currencyCode,
+        },
+        requestId
+      )
     } else if (updates.options !== undefined || updates.multiple !== undefined) {
       updatedTable = await updateColumnOptions(
         {
@@ -217,7 +231,8 @@ export const PATCH = withRouteHandler(async (request: NextRequest, context: Colu
       msg.includes('exceeds maximum') ||
       msg.includes('incompatible') ||
       msg.includes('duplicate') ||
-      msg.includes('option')
+      msg.includes('option') ||
+      msg.includes('currency')
     ) {
       return NextResponse.json({ error: msg }, { status: 400 })
     }

apps/sim/app/api/table/utils.ts

@@ -341,5 +341,6 @@ export function normalizeColumn(col: ColumnDefinition): ColumnDefinition {
     ...(col.workflowGroupId ? { workflowGroupId: col.workflowGroupId } : {}),
     ...(col.options ? { options: col.options } : {}),
     ...(col.multiple ? { multiple: true } : {}),
+    ...(col.currencyCode ? { currencyCode: col.currencyCode } : {}),
   }
 }

apps/sim/app/api/v1/tables/[tableId]/columns/route.ts

@@ -14,6 +14,7 @@ import {
   deleteColumn,
   renameColumn,
   updateColumnConstraints,
+  updateColumnCurrency,
   updateColumnOptions,
   updateColumnType,
 } from '@/lib/table'
@@ -188,12 +189,25 @@ export const PATCH = withRouteHandler(async (request: NextRequest, context: Colu
           newType: updates.type as NonNullable<typeof updates.type>,
           ...(updates.options !== undefined ? { options: updates.options } : {}),
           ...(updates.multiple !== undefined ? { multiple: updates.multiple } : {}),
+          ...(updates.currencyCode !== undefined ? { currencyCode: updates.currencyCode } : {}),
           // Forwarded so the conversion validates against the constraint this
           // same request is about to set, not the column's current one.
           ...(updates.required !== undefined ? { required: updates.required } : {}),
         },
         requestId
       )
+    } else if (updates.currencyCode !== undefined) {
+      // Re-denominating an existing currency column: schema-only, no cell
+      // rewrite. Reached only when the type is unchanged — a conversion INTO
+      // currency carries the code through `updateColumnType` above.
+      updatedTable = await updateColumnCurrency(
+        {
+          tableId,
+          columnName: updates.name ?? validated.columnName,
+          currencyCode: updates.currencyCode,
+        },
+        requestId
+      )
     } else if (updates.options !== undefined || updates.multiple !== undefined) {
       updatedTable = await updateColumnOptions(
         {
@@ -262,7 +276,8 @@ export const PATCH = withRouteHandler(async (request: NextRequest, context: Colu
         msg.includes('exceeds maximum') ||
         msg.includes('incompatible') ||
         msg.includes('duplicate') ||
-        msg.includes('option')
+        msg.includes('option') ||
+        msg.includes('currency')
       ) {
         return NextResponse.json({ error: msg }, { status: 400 })
       }

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/column-config-sidebar/column-config-sidebar.tsx

@@ -6,6 +6,7 @@ import { X } from '@sim/emcn/icons'
 import { toError } from '@sim/utils/errors'
 import { findValidationIssue, isValidationError } from '@/lib/api/client/errors'
 import type { ColumnDefinition, SelectOption } from '@/lib/table'
+import { CURRENCY_OPTIONS, DEFAULT_CURRENCY_CODE, resolveCurrencyCode } from '@/lib/table/currency'
 import {
   FieldError,
   RequiredLabel,
@@ -19,6 +20,15 @@ function isSelectType(type: ColumnDefinition['type']): boolean {
   return type === 'select'
 }
 
+/**
+ * Picker entries, built once at module load: the option list is derived from the
+ * runtime's currency data and never varies per column.
+ */
+const CURRENCY_COMBOBOX_OPTIONS = CURRENCY_OPTIONS.map((c) => ({
+  value: c.code,
+  label: `${c.code} · ${c.name}`,
+}))
+
 function optionsEqual(a: SelectOption[], b: SelectOption[]): boolean {
   return JSON.stringify(a) === JSON.stringify(b)
 }
@@ -110,13 +120,19 @@ function ColumnConfigBody({
   const [multipleInput, setMultipleInput] = useState<boolean>(() =>
     config.mode === 'edit' ? !!existingColumn?.multiple : false
   )
+  const [currencyInput, setCurrencyInput] = useState<string>(() =>
+    config.mode === 'edit'
+      ? resolveCurrencyCode(existingColumn?.currencyCode)
+      : DEFAULT_CURRENCY_CODE
+  )
   const [showValidation, setShowValidation] = useState(false)
   const [nameError, setNameError] = useState<string | null>(null)
   const [optionsError, setOptionsError] = useState<string | null>(null)
 
   const saveDisabled = updateColumn.isPending || addColumn.isPending
   const trimmedName = nameInput.trim()
   const wantsOptions = isSelectType(typeInput)
+  const wantsCurrency = typeInput === 'currency'
   const trimmedOptions = optionsInput.map((o) => ({ ...o, name: o.name.trim() }))
 
   /** Client-side option validation mirroring the server rules; returns an error message or null. */
@@ -150,6 +166,7 @@ function ColumnConfigBody({
           ...(!wantsOptions && uniqueInput ? { unique: true } : {}),
           ...(wantsOptions ? { options: trimmedOptions } : {}),
           ...(wantsOptions && multipleInput ? { multiple: true } : {}),
+          ...(wantsCurrency ? { currencyCode: currencyInput } : {}),
         })
         toast.success(`Added "${trimmedName}"`)
         onClose()
@@ -168,20 +185,26 @@ function ColumnConfigBody({
       const optionsChanged =
         wantsOptions && !optionsEqual(existingColumn?.options ?? [], trimmedOptions)
       const multipleChanged = wantsOptions && !!existingColumn?.multiple !== multipleInput
+      const currencyChanged =
+        wantsCurrency && resolveCurrencyCode(existingColumn?.currencyCode) !== currencyInput
 
       const updates: {
         name?: string
         type?: ColumnDefinition['type']
         unique?: boolean
         options?: SelectOption[]
         multiple?: boolean
+        currencyCode?: string
       } = {
         ...(renamed ? { name: trimmedName } : {}),
         ...(typeChanged ? { type: typeInput } : {}),
         ...(uniqueChanged ? { unique: uniqueInput } : {}),
         ...(uniqueCleared ? { unique: false } : {}),
         ...(wantsOptions && (typeChanged || optionsChanged) ? { options: trimmedOptions } : {}),
         ...(wantsOptions && (typeChanged || multipleChanged) ? { multiple: multipleInput } : {}),
+        ...(wantsCurrency && (typeChanged || currencyChanged)
+          ? { currencyCode: currencyInput }
+          : {}),
       }
       if (Object.keys(updates).length === 0) {
         onClose()
@@ -261,6 +284,24 @@ function ColumnConfigBody({
           </>
         )}
 
+        {wantsCurrency && (
+          <>
+            <FieldDivider />
+            <div className='flex flex-col gap-[9.5px]'>
+              <RequiredLabel>Currency</RequiredLabel>
+              <ChipCombobox
+                options={CURRENCY_COMBOBOX_OPTIONS}
+                value={currencyInput}
+                onChange={setCurrencyInput}
+                placeholder='Select currency'
+                searchable
+                searchPlaceholder='Search currencies'
+                maxHeight={260}
+              />
+            </div>
+          </>
+        )}
+
         {wantsOptions && (
           <>
             <FieldDivider />

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/column-config-sidebar/column-types.ts

@@ -1,14 +1,7 @@
 import type React from 'react'
-import {
-  Calendar as CalendarIcon,
-  PlayOutline,
-  TagIcon,
-  TypeBoolean,
-  TypeJson,
-  TypeNumber,
-  TypeText,
-} from '@sim/emcn/icons'
+import { PlayOutline } from '@sim/emcn/icons'
 import type { ColumnDefinition } from '@/lib/table'
+import { ALL_COLUMN_TYPES } from '@/lib/table/column-types'
 
 /**
  * UI-only column type. `'workflow'` is the virtual entry users pick from the
@@ -23,13 +16,17 @@ export interface ColumnTypeOption {
   icon: React.ComponentType<{ className?: string }>
 }
 
+/**
+ * Real column types come from the registry — adding one there makes it appear
+ * in every picker automatically. `workflow` is appended because it is a UI
+ * affordance, not a storable type.
+ */
 export const COLUMN_TYPE_OPTIONS: ColumnTypeOption[] = [
-  { type: 'string', label: 'Text', icon: TypeText },
-  { type: 'number', label: 'Number', icon: TypeNumber },
-  { type: 'boolean', label: 'Boolean', icon: TypeBoolean },
-  { type: 'date', label: 'Date', icon: CalendarIcon },
-  { type: 'json', label: 'JSON', icon: TypeJson },
-  { type: 'select', label: 'Select', icon: TagIcon },
+  ...ALL_COLUMN_TYPES.map((definition) => ({
+    type: definition.id,
+    label: definition.label,
+    icon: definition.icon,
+  })),
   { type: 'workflow', label: 'Workflow', icon: PlayOutline },
 ]
 

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/row-modal/row-modal.tsx

@@ -18,6 +18,8 @@ import { createLogger } from '@sim/logger'
 import { getErrorMessage } from '@sim/utils/errors'
 import { useParams } from 'next/navigation'
 import type { ColumnDefinition, TableInfo, TableRow } from '@/lib/table'
+import { columnTypeOf } from '@/lib/table/column-types'
+import { resolveCurrencyCode } from '@/lib/table/currency'
 import { useTimezone } from '@/hooks/queries/general-settings'
 import { useDeleteTableRow, useDeleteTableRows, useUpdateTableRow } from '@/hooks/queries/tables'
 import {
@@ -209,7 +211,14 @@ function ColumnField({ column, value, onChange }: ColumnFieldProps) {
       )}
     </>
   )
-  const hint = `Type: ${column.type}${column.required ? '' : ' (optional)'}`
+  // Currency names its code — the modal edits the bare amount, so without it
+  // there is nothing on screen saying which currency the number is in.
+  const typeLabel =
+    column.type === 'currency'
+      ? `currency (${resolveCurrencyCode(column.currencyCode)})`
+      : column.type
+  const hint = `Type: ${typeLabel}${column.required ? '' : ' (optional)'}`
+  const definition = columnTypeOf(column)
 
   if (column.type === 'boolean') {
     return (
@@ -290,7 +299,9 @@ function ColumnField({ column, value, onChange }: ColumnFieldProps) {
       title={title}
       required={column.required}
       hint={hint}
-      inputType={column.type === 'number' ? 'number' : 'text'}
+      // Registry-driven, so a numeric type can't get the numeric keypad in the
+      // grid's inline editor but a plain text field here (currency did).
+      inputType={definition.inputMode === 'decimal' ? 'number' : 'text'}
       value={formatValueForInput(value, column.type)}
       onChange={onChange}
       placeholder={`Enter ${column.name}`}

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/table-grid/cells/cell-render.tsx

@@ -6,6 +6,7 @@ import { Badge, Checkbox, cn, Tooltip } from '@sim/emcn'
 import { parse } from 'tldts'
 import { faviconUrl } from '@/lib/core/utils/favicon'
 import type { RowExecutionMetadata, SelectOption } from '@/lib/table'
+import { columnTypeOf } from '@/lib/table/column-types'
 import { StatusBadge } from '@/app/workspace/[workspaceId]/logs/utils'
 import { storageToDisplay } from '../../../utils'
 import { resolveSelectOptions, SelectPill } from '../../select-field'
@@ -128,6 +129,13 @@ export function resolveCellRender({
     return { kind: 'select', options: resolveSelectOptions(column, value) }
   }
   if (isNull) return { kind: 'empty' }
+  // Formatted here rather than in a render branch because the symbol and
+  // fraction digits come from the COLUMN's currency, which the render switch
+  // (keyed on kind alone) no longer has. Renders as plain text — a currency
+  // cell is a number cell with a symbol, so it stays left-aligned like one.
+  if (column.type === 'currency') {
+    return { kind: 'text', text: columnTypeOf(column).formatForDisplay(value, column) }
+  }
   if (column.type === 'json') return { kind: 'json', text: JSON.stringify(value) }
   if (column.type === 'date') return { kind: 'date', text: String(value) }
   if (column.type === 'string') {

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/table-grid/cells/expanded-cell-popover.tsx

@@ -4,6 +4,7 @@ import type React from 'react'
 import { useEffect, useEffectEvent, useLayoutEffect, useMemo, useRef, useState } from 'react'
 import { Button } from '@sim/emcn'
 import type { TableRow as TableRowType } from '@/lib/table'
+import { columnTypeOf } from '@/lib/table/column-types'
 import { useTimezone } from '@/hooks/queries/general-settings'
 import type { EditingCell, SaveReason } from '../../../types'
 import {
@@ -74,6 +75,9 @@ export function ExpandedCellPopover({
     if (target.column.type === 'date' && typeof value === 'string') {
       return storageToDisplay(value, { seconds: true })
     }
+    if (target.column.type === 'currency') {
+      return columnTypeOf(target.column).formatForDisplay(value, target.column)
+    }
     if (typeof value === 'string') return value
     return JSON.stringify(value, null, 2)
   }, [target])
@@ -231,14 +235,12 @@ function ExpandedCellEditor({
       setParseError('Invalid JSON')
       return
     }
-    /** `cleanCellValue` nulls unparseable dates/numbers instead of throwing — reject rather than silently clear. */
-    if (
-      cleaned === null &&
-      draftValue.trim() !== '' &&
-      (column.type === 'date' || column.type === 'number')
-    ) {
-      setParseError(column.type === 'date' ? 'Invalid date' : 'Invalid number')
-      return
+    if (cleaned === null && draftValue.trim() !== '') {
+      const message = columnTypeOf(column).parseErrorMessage
+      if (message) {
+        setParseError(message)
+        return
+      }
     }
     onSave(rowId, column.key, cleaned, 'blur')
     onClose()