feat!: Add sql template and loader method

[wschurman]

Why

This is the first new feature afforded by the changes in #407.

It adds a feature that is fairly common amongst typescript ORMs: sql via tagged templates for safe value interpolation into SQL statements.

How

Quite a lot of ORMs have this:

• https://github.com/drizzle-team/drizzle-orm
• https://github.com/mikro-orm/mikro-orm
• https://github.com/blakeembrey/sql-template-tag
• https://github.com/andywer/squid
• https://github.com/Seb-C/kiss-orm

This adds support for it to entity knex.

See tests for examples, especially PostgresEntityIntegration-test.ts.

The idea is that this will replace loadManyByRawWhereClauseAsync over the course of a few versions.

Test Plan

Full test coverage.

[wschurman]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat!: Add sql template and loader method #414 👈 (View in Graphite)
• feat: add codemod for upcoming v0.55.0-v0.56.0 #413
• feat: add entity-database-adapter-knex-testing-utils containing StubPostgresDatabaseAdapter #412
• chore: add CLAUDE.md and disallow test.skip #411
• feat!: move knex loaders into entity-database-adapter-knex package #410
• chore: move knex-specific loader logic out of EntityDataManager #408 : 1 other dependent PR (#409 )
• feat!: Move knex-specific loader methods to knexLoader #407
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (39f26e6) to head (cbd366a).

Additional details and impacted files

@@                                       Coverage Diff                                        @@
##           wschurman/02-01-feat_add_codemod_for_upcoming_v0.55.0-v0.56.0      #414    +/-   ##
================================================================================================
  Coverage                                                         100.00%   100.00%            
================================================================================================
  Files                                                                106       108     +2     
  Lines                                                              13941     14785   +844     
  Branches                                                            1205      1302    +97     
================================================================================================
+ Hits                                                               13941     14785   +844     

Flag	Coverage Δ
integration	22.00% <91.24%> (+4.45%)	⬆️
unittest	96.50% <81.42%> (-0.92%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[ide]

Comments