@abeedoo/radish-schemas 1.7.7 → 1.9.0

package/index.js

@@ -31,7 +31,7 @@ export {
  * @property {string} minCliVersion - Minimum radish-cli version compatible with this package
  */
 export const VERSIONING = {
-  packageVersion: '1.7.7',
+  packageVersion: '1.9.0',
   currentSpecVersion: 1,
   supportedSpecVersions: [1],
   minCliVersion: '0.1.0'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abeedoo/radish-schemas",
-  "version": "1.7.7",
+  "version": "1.9.0",
   "description": "Shared JSON schemas, validators, and prompts for Radish CLI ecosystem",
   "main": "index.js",
   "type": "module",

package/prompts/radish-types-generation.md

@@ -163,7 +163,12 @@ The following entities are already provided by the system. DO NOT recreate them
           "engine": "typesense",
           "indexName": "products",
           "fields": {
-            "searchable": ["name", "description", "brand"],
+            "searchable": [
+              { "field": "name", "stem": true },
+              { "field": "description", "stem": true },
+              "sku",
+              "brand"
+            ],
             "filterable": ["brand", "price", "categories"],
             "sortable": ["price", "name", "createdAt"],
             "facetable": ["brand", "categories"]
@@ -182,8 +187,29 @@ The following entities are already provided by the system. DO NOT recreate them
     - **indexName**: Custom index name (defaults to entity plural)
     - **sync**: `inline` (immediate) or `background` (via jobs)
     - **vector**: Enable vector/embedding search with `sourceFields` to generate embeddings from
+    - **searchable**: Each entry is either a plain field name or `{ "field": "name", "stem": true }`. Stemming reduces terms to their word stems at index time (`computers` → `computer`), so a plural query matches singular text as an exact match rather than relying on typo correction. Set `stem: true` only on prose fields (name, description, summary, body). Never stem identifiers (`sku`, `slug`, `code`), brand or category values, anything listed under `filterable`/`facetable`, or non-string fields — stemming a facet value breaks the filter that reads it.
 
-13. **Automatic Fields** (DO NOT add these manually):
+13. **Expiration / TTL** (optional): For entities whose records should be purged automatically (sessions, tokens, logs, temporary uploads), use the entity-level `ttl` shorthand:
+    ```json
+    {
+      "Session": {
+        "plural": "sessions",
+        "ttl": { "field": "createdAt", "days": 90 },
+        "fields": { ... }
+      }
+    }
+    ```
+    - **field**: date field the expiration is measured from
+    - **days**: whole days (minimum 1) after that field's value before a record expires
+
+    For precise control, set `expireAfterSeconds` on an index instead. Use `0` when the field already holds the exact expiration timestamp:
+    ```json
+    "indexes": [
+      { "fields": ["expiresAt"], "expireAfterSeconds": 0 }
+    ]
+    ```
+
+14. **Automatic Fields** (DO NOT add these manually):
     - When `"defaults": { "timestamps": true }` is set, `createdAt` and `updatedAt` are added automatically
     - When `"defaults": { "owned": true }` is set, `ownerId` is added automatically
     - Adding these fields manually causes duplication

package/schemas/types.schema.json

@@ -114,8 +114,27 @@
                   "properties": {
                     "searchable": {
                       "type": "array",
-                      "items": { "type": "string" },
-                      "description": "Fields included in full-text search queries"
+                      "items": {
+                        "oneOf": [
+                          { "type": "string" },
+                          {
+                            "type": "object",
+                            "required": ["field"],
+                            "additionalProperties": false,
+                            "properties": {
+                              "field": {
+                                "type": "string",
+                                "description": "Field name"
+                              },
+                              "stem": {
+                                "type": "boolean",
+                                "description": "Reduce terms to their word stems at index time so plural queries match singular text. Prose fields only — never identifiers, facets, or non-string fields, since stemming a facet value breaks the filter that reads it."
+                              }
+                            }
+                          }
+                        ]
+                      },
+                      "description": "Fields included in full-text search queries. Either a field name, or an object with per-field options such as stemming."
                     },
                     "filterable": {
                       "type": "array",
@@ -208,6 +227,26 @@
                 }
               }
             },
+            "ttl": {
+              "type": "object",
+              "description": "Automatic document expiration. Generates a MongoDB TTL index on the given date field.",
+              "required": [
+                "field",
+                "days"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "field": {
+                  "type": "string",
+                  "description": "Date field documents expire relative to (e.g., 'createdAt')"
+                },
+                "days": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "Number of days after the field value before a document expires"
+                }
+              }
+            },
             "fields": {
               "type": "object",
               "minProperties": 1,
@@ -530,6 +569,11 @@
                   },
                   "name": {
                     "type": "string"
+                  },
+                  "expireAfterSeconds": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "TTL index: seconds after the indexed date field before a document expires"
                   }
                 }
               }