@prisma/orm-postgres 8.0.0-rc.17-dev.21 → 8.0.0-rc.17-dev.22

package/dist/relational-core__functions.d.mts

@@ -0,0 +1 @@
+export * from "@prisma/orm-family-sql/relational-core/functions";

package/dist/relational-core__functions.mjs

@@ -0,0 +1,2 @@
+export * from "@prisma/orm-family-sql/relational-core/functions";
+export {};

package/dist/relational-core__index-reference.d.mts

@@ -0,0 +1 @@
+export * from "@prisma/orm-family-sql/relational-core/index-reference";

package/dist/relational-core__index-reference.mjs

@@ -0,0 +1,2 @@
+export * from "@prisma/orm-family-sql/relational-core/index-reference";
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/orm-postgres",
-  "version": "8.0.0-rc.17-dev.21",
+  "version": "8.0.0-rc.17-dev.22",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
@@ -10,10 +10,10 @@
     "skills"
   ],
   "dependencies": {
-    "@prisma/orm-family-sql": "8.0.0-rc.17-dev.21",
-    "@prisma/orm-framework": "8.0.0-rc.17-dev.21",
-    "@prisma/orm-target-postgres": "8.0.0-rc.17-dev.21",
-    "@prisma/orm-toolchain": "8.0.0-rc.17-dev.21",
+    "@prisma/orm-family-sql": "8.0.0-rc.17-dev.22",
+    "@prisma/orm-framework": "8.0.0-rc.17-dev.22",
+    "@prisma/orm-target-postgres": "8.0.0-rc.17-dev.22",
+    "@prisma/orm-toolchain": "8.0.0-rc.17-dev.22",
     "@types/node": "26.1.2",
     "@types/pg": "8.20.4",
     "arktype": "^2.2.2",
@@ -22,9 +22,9 @@
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
-    "@internal/postgres": "8.0.0-rc.17-dev.21",
-    "@repo/tsconfig": "8.0.0-rc.17-dev.21",
-    "@repo/tsdown": "8.0.0-rc.17-dev.21",
+    "@internal/postgres": "8.0.0-rc.17-dev.22",
+    "@repo/tsconfig": "8.0.0-rc.17-dev.22",
+    "@repo/tsdown": "8.0.0-rc.17-dev.22",
     "tsdown": "0.22.14",
     "typescript": "5.9.3"
   },
@@ -121,6 +121,8 @@
     "./relational-core/codec-descriptor-registry": "./dist/relational-core__codec-descriptor-registry.mjs",
     "./relational-core/contract-free": "./dist/relational-core__contract-free.mjs",
     "./relational-core/expression": "./dist/relational-core__expression.mjs",
+    "./relational-core/functions": "./dist/relational-core__functions.mjs",
+    "./relational-core/index-reference": "./dist/relational-core__index-reference.mjs",
     "./relational-core/middleware": "./dist/relational-core__middleware.mjs",
     "./relational-core/plan": "./dist/relational-core__plan.mjs",
     "./relational-core/query-lane-context": "./dist/relational-core__query-lane-context.mjs",

package/skills/prisma-8/SKILL.md

@@ -15,7 +15,7 @@ description: >-
   ORM 7 or earlier (schema.prisma + @prisma/client).
 metadata:
   library: '@prisma/orm-postgres'
-  library_version: '8.0.0-rc.17-dev.21'
+  library_version: '8.0.0-rc.17-dev.22'
   version: '2026-09-12'
 ---
 

package/skills/prisma-8/references/queries-postgres.md

@@ -123,10 +123,25 @@ model('Message', { fields: { id, text } }).sql(({ cols }) => ({
 @@fullTextIndex([[title, subtitle], body], name: "post_search")
 ```
 
-**Searching an index from the SQL builder.** A table's `indexes` holds each of its indexes under the name the contract gave it, `name:` or `map:`. Pass the full-text index to `fns.fullTextMatches` and `fns.fullTextRank` in place of a column: the operation searches the document the index was built over, with the index's weight groups and language, so the query always matches the index and a title match ranks above a body match. The index states its language, so passing `language` with one is a type error. An index of another type is a type error too.
+**Searching an index: name it.** Name the full-text index and pass it to `fns.fullTextMatches` and `fns.fullTextRank` in place of a column. The operation searches the document the index was built over, with the index's weight groups and language, so the query always matches the index, Postgres uses it, and a title match ranks above a body match. The index states its language, so passing `language` with one is a type error. An index of another type, or a name the model's table does not have, is a type error too.
+
+In the ORM, every `where` and `orderBy` callback receives a second argument `{ fns, indexes }`: `fns` is the SQL builder's functions, and `indexes` holds the indexes of the model's table under the name the contract gave each, `name:` or `map:`. A value from `fns`, such as a rank, has `.asc()` and `.desc()`:
 
 ```typescript
 const q = websearchToTsquery(query);
+const posts = await db.orm.public.Post
+  .select('id', 'title')
+  .where((_p, { fns, indexes }) => fns.fullTextMatches(indexes.post_search, q))
+  .orderBy((_p, { fns, indexes }) => fns.fullTextRank(indexes.post_search, q).desc())
+  .limit(20)
+  .all();
+```
+
+The same argument reaches the callbacks inside an include refinement, a fragment and a relation filter (`some`, `every`, `none`), where the index's columns follow the alias the ORM gives the related table. A condition from `fns` combines with the ORM's `and`, `or` and `not`. The body of a fragment for any model (`db.orm.fragment(fields, body)`) gets `fns` but no indexes.
+
+In the SQL builder, a table's `indexes` holds the same references:
+
+```typescript
 const post = db.sql.public.post;
 const posts = post
   .select('id', 'title')