All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
[0.2.0] — 2026-07-27
Added
- Nullability inference for schema-qualified tables, scalar subqueries in select lists, and expression-derived columns (see Writing Queries guide).
- Structured errors for
--inferconnection failures and timeouts (CannotConnectToPostgres,PostgresConnectionTimeout) with actionable hints forPG*env vars, CLI flags, and metadata-file fallback.
Changed
- Documented composite-type policy as reject-with-hints (aligned with Gleam
Squirrel and flat Elixir row maps). Inference now attaches actionable hints for
composites (
kind: "c") and geometricpointvalues. - Finalized unsupported-type policy for Postgres ranges/multiranges and remaining
built-ins (
interval, geometric, network,money, and related types): inference rejects them with actionable hints, and the Types guide documents workarounds.
[0.1.0] — 2026-07-24
Added
- First public release of Squirrelix (Hex package
squirr_elix): typed Elixir query modules from plain.sqlfiles via Postgres inference or metadata. - Mix tasks
mix squirrelix.genandmix squirrelix.check. - Guides for getting started, writing queries, types, and configuration.
- GitHub Actions CI (format, compile, Credo, tests with Postgres 16) and Hex publish
on
v*tags.
Changed
- Public Elixir modules and Mix tasks use the Squirrelix name (package/app remain
squirr_elix). Repository:scripthungry/squirrelix.
Security
- Generated SQL and
@docstrings are embedded withinspect/2so#{}in.sqlfiles cannot become Elixir interpolation in generated modules. - EXPLAIN nullability rejects multi-statement SQL before using the simple query
protocol (required for
$n+generic_plan). - Plan JSON decoding uses stdlib
JSON(no undeclared Jason dependency). - Overwrite protection trusts the generation marker only in the file header.