feat: add typed sql parameter helpers

[ditadi]

Summary

Add sql.* helpers for type-safe SQL query parameters. Solves the problem of agents struggling to parameterize SQL and properly cast values.

Helpers

• sql.date() - Date objects or ISO strings → YYYY-MM-DD
• sql.timestamp() - Date, ISO string, or Unix timestamp
• sql.string() - String, number, or boolean
• sql.number() - Number or numeric string
• sql.boolean() - Boolean, string ("true"/"false"), or number (0/1)
• sql.binary() - Uint8Array, ArrayBuffer, or hex-encoded string

Usage

  import { sql } from "@databricks/app-kit-ui/js";

  const params = {
    startDate: sql.date(new Date()),
    endDate: sql.date("2024-12-31"),
    userId: sql.number(123),
    name: sql.string("John"),
    isActive: sql.boolean(true),
  };

Notes

• All helpers validate inputs and throw descriptive errors
• Exports SQLTypeMarker type and isSQLTypeMarker type guard for custom integrations
• SQL Helpers are exported from the app-kit for server and from app-kit-ui/js for the client.

[fjakobs]

Looks good. Let's just make sure that the encoding for binary parameters is correct.

[fjakobs]

Did you test sending binary data. Would like to have confidence that we are encoding the data properly.

[ditadi]

Improved the tests and added a new interactive demo showing the features + doing a real SQL test on the dev-playground.

Screen.Recording.2025-12-08.at.12.42.13.mov