@abeedoo/radish-schemas 1.7.7 → 1.8.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.8.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.8.0",
   "description": "Shared JSON schemas, validators, and prompts for Radish CLI ecosystem",
   "main": "index.js",
   "type": "module",

package/prompts/radish-types-generation.md

@@ -183,7 +183,27 @@ The following entities are already provided by the system. DO NOT recreate them
     - **sync**: `inline` (immediate) or `background` (via jobs)
     - **vector**: Enable vector/embedding search with `sourceFields` to generate embeddings from
 
-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

@@ -208,6 +208,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 +550,11 @@
                   },
                   "name": {
                     "type": "string"
+                  },
+                  "expireAfterSeconds": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "TTL index: seconds after the indexed date field before a document expires"
                   }
                 }
               }