Update SDK pages

Author: tailor-docs-bot[bot]

docs/sdk/generator/builtin.md

@@ -57,6 +57,42 @@ body: async (input, { env }) => {
 };
 ```
 
+### Raw SQL
+
+For queries that the Kysely query builder can't express, use the `sql` tag re-exported from `@tailor-platform/sdk/kysely`. Plain value substitutions (`${...}`) are sent as bound parameters, so user-supplied values are parameterized safely. SQL fragments produced by Kysely helpers (for example `sql.raw(...)`, identifiers, refs) are inlined into the generated SQL string by design — do not pass untrusted input through those.
+
+```typescript
+import { sql } from "@tailor-platform/sdk/kysely";
+import { getDB } from "./generated/tailordb";
+
+createResolver({
+  name: "supplierCountByState",
+  operation: "query",
+  input: { country: t.string() },
+  output: t.object({
+    rows: t.array(t.object({ state: t.string(), count: t.int() })),
+  }),
+  body: async ({ input }) => {
+    const db = getDB("tailordb");
+    const { rows } = await sql<{ state: string; count: number }>`
+      SELECT state, COUNT(*) AS count
+        FROM "Supplier"
+       WHERE country = ${input.country}
+    GROUP BY state
+    `.execute(db);
+    return { rows };
+  },
+});
+```
+
+The same `sql` tag works inside `db.transaction().execute(async (trx) => ...)` by passing `trx` to `.execute()`:
+
+```typescript
+await db.transaction().execute(async (trx) => {
+  await sql`UPDATE "Supplier" SET state = ${state} WHERE id = ${id}`.execute(trx);
+});
+```
+
 ## @tailor-platform/enum-constants
 
 Extracts enum constants from TailorDB type definitions.