@takeshape/schema 12.7.0 → 12.9.0

package/dist/builtin-schema.js

@@ -178,6 +178,10 @@ const builtInShapes = {
                     type: 'string',
                     enum: ['none', 'all'],
                     description: "What to do if the analyzer removes all tokens. 'none' returns no results (default), 'all' matches all documents."
+                },
+                boost: {
+                    type: 'number',
+                    description: 'Boost factor to increase or decrease the relevance score of this query. Values greater than 1 increase relevance, values between 0 and 1 decrease it. Default is 1.0.'
                 }
             },
             required: ['query']
@@ -212,6 +216,10 @@ const builtInShapes = {
                     type: 'string',
                     enum: ['none', 'all'],
                     description: "What to do if the analyzer removes all tokens. 'none' returns no results (default), 'all' matches all documents."
+                },
+                boost: {
+                    type: 'number',
+                    description: 'Boost factor to increase or decrease the relevance score of this query. Values greater than 1 increase relevance, values between 0 and 1 decrease it. Default is 1.0.'
                 }
             },
             required: ['query']

package/dist/schema-util.js

@@ -223,6 +223,11 @@ export function getCommonBuiltInProperties(shape) {
             type: 'string',
             title: 'Shape Id',
             enum: [shape.id]
+        },
+        _score: {
+            type: 'number',
+            title: 'Score',
+            description: 'The relevance score for this result. Only populated in search contexts where scoring is applied (e.g., using "should" with boost).'
         }
     };
 }

package/dist/template-shapes/templates.js

@@ -27,7 +27,10 @@ export const DeleteResult = getMutationResultType(TemplateVerbs.Delete);
 export const TSSearchSortInput = createShape('TSSearchSortInput', {
     type: 'object',
     properties: {
-        field: { type: 'string' },
+        field: {
+            type: 'string',
+            description: 'The field to sort by. Use "_score" to sort by relevance (useful with boost).'
+        },
         order: {
             type: 'string',
             description: '"asc" for ascending or "desc" for descending'

package/dist/template-shapes/where.js

@@ -418,6 +418,10 @@ export function getWhereSearchArg(projectSchema, selectedShapes) {
             where: {
                 '@ref': `local:${shapeName}`,
                 description: 'The where clause uses the boolean AND, OR, and NOT parameters to construct complex filters based on the values of your fields. It applies an implicit AND to all the top-level keys. To avoid this, use a single OR or NOT key as the only top-level key.'
+            },
+            should: {
+                '@ref': `local:${shapeName}`,
+                description: 'The should clause is used for relevance scoring. Unlike "where" which filters in a non-scoring context, queries in "should" contribute to the relevance score. Use this with match_advanced and boost to influence result ranking. Sort by "_score" to see boosted results first.'
             }
         }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takeshape/schema",
-  "version": "12.7.0",
+  "version": "12.9.0",
   "description": "TakeShape Schema",
   "homepage": "https://www.takeshape.io",
   "repository": {
@@ -57,9 +57,9 @@
     "p-reduce": "3.0.0",
     "semver": "7.7.2",
     "tiny-invariant": "1.3.3",
-    "@takeshape/errors": "12.7.0",
-    "@takeshape/json-schema": "12.7.0",
-    "@takeshape/util": "12.7.0"
+    "@takeshape/errors": "12.9.0",
+    "@takeshape/json-schema": "12.9.0",
+    "@takeshape/util": "12.9.0"
   },
   "devDependencies": {
     "@takeshape/json-schema-to-typescript": "11.0.0",
@@ -76,8 +76,8 @@
     "glob": "11.0.1",
     "json-schema-to-ts": "3.1.1",
     "shortid": "2.2.16",
-    "@takeshape/logger": "12.7.0",
-    "@takeshape/infra": "12.7.0"
+    "@takeshape/infra": "12.9.0",
+    "@takeshape/logger": "12.9.0"
   },
   "engines": {
     "node": ">=24"