@objectstack/spec 0.6.1 → 0.7.2

package/json-schema/ui/FieldWidgetProps.json

@@ -411,6 +411,440 @@
               "additionalProperties": false,
               "description": "Configuration for vector field type (AI/ML embeddings)"
             },
+            "fileAttachmentConfig": {
+              "type": "object",
+              "properties": {
+                "minSize": {
+                  "type": "number",
+                  "minimum": 0,
+                  "description": "Minimum file size in bytes"
+                },
+                "maxSize": {
+                  "type": "number",
+                  "minimum": 1,
+                  "description": "Maximum file size in bytes (e.g., 10485760 = 10MB)"
+                },
+                "allowedTypes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Allowed file extensions (e.g., [\".pdf\", \".docx\", \".jpg\"])"
+                },
+                "blockedTypes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Blocked file extensions (e.g., [\".exe\", \".bat\", \".sh\"])"
+                },
+                "allowedMimeTypes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Allowed MIME types (e.g., [\"image/jpeg\", \"application/pdf\"])"
+                },
+                "blockedMimeTypes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Blocked MIME types"
+                },
+                "virusScan": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Enable virus scanning for uploaded files"
+                },
+                "virusScanProvider": {
+                  "type": "string",
+                  "enum": [
+                    "clamav",
+                    "virustotal",
+                    "metadefender",
+                    "custom"
+                  ],
+                  "description": "Virus scanning service provider"
+                },
+                "virusScanOnUpload": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Scan files immediately on upload"
+                },
+                "quarantineOnThreat": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Quarantine files if threat detected"
+                },
+                "storageProvider": {
+                  "type": "string",
+                  "description": "Object storage provider name (references ObjectStorageConfig)"
+                },
+                "storageBucket": {
+                  "type": "string",
+                  "description": "Target bucket name"
+                },
+                "storagePrefix": {
+                  "type": "string",
+                  "description": "Storage path prefix (e.g., \"uploads/documents/\")"
+                },
+                "imageValidation": {
+                  "type": "object",
+                  "properties": {
+                    "minWidth": {
+                      "type": "number",
+                      "minimum": 1,
+                      "description": "Minimum image width in pixels"
+                    },
+                    "maxWidth": {
+                      "type": "number",
+                      "minimum": 1,
+                      "description": "Maximum image width in pixels"
+                    },
+                    "minHeight": {
+                      "type": "number",
+                      "minimum": 1,
+                      "description": "Minimum image height in pixels"
+                    },
+                    "maxHeight": {
+                      "type": "number",
+                      "minimum": 1,
+                      "description": "Maximum image height in pixels"
+                    },
+                    "aspectRatio": {
+                      "type": "string",
+                      "description": "Required aspect ratio (e.g., \"16:9\", \"1:1\")"
+                    },
+                    "generateThumbnails": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Auto-generate thumbnails"
+                    },
+                    "thumbnailSizes": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string",
+                            "description": "Thumbnail variant name (e.g., \"small\", \"medium\", \"large\")"
+                          },
+                          "width": {
+                            "type": "number",
+                            "minimum": 1,
+                            "description": "Thumbnail width in pixels"
+                          },
+                          "height": {
+                            "type": "number",
+                            "minimum": 1,
+                            "description": "Thumbnail height in pixels"
+                          },
+                          "crop": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "Crop to exact dimensions"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "width",
+                          "height"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "Thumbnail size configurations"
+                    },
+                    "preserveMetadata": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Preserve EXIF metadata"
+                    },
+                    "autoRotate": {
+                      "type": "boolean",
+                      "default": true,
+                      "description": "Auto-rotate based on EXIF orientation"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "description": "Image-specific validation rules"
+                },
+                "allowMultiple": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Allow multiple file uploads (overrides field.multiple)"
+                },
+                "allowReplace": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Allow replacing existing files"
+                },
+                "allowDelete": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Allow deleting uploaded files"
+                },
+                "requireUpload": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Require at least one file when field is required"
+                },
+                "extractMetadata": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Extract file metadata (name, size, type, etc.)"
+                },
+                "extractText": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Extract text content from documents (OCR/parsing)"
+                },
+                "versioningEnabled": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Keep previous versions of replaced files"
+                },
+                "maxVersions": {
+                  "type": "number",
+                  "minimum": 1,
+                  "description": "Maximum number of versions to retain"
+                },
+                "publicRead": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Allow public read access to uploaded files"
+                },
+                "presignedUrlExpiry": {
+                  "type": "number",
+                  "minimum": 60,
+                  "maximum": 604800,
+                  "default": 3600,
+                  "description": "Presigned URL expiration in seconds (default: 1 hour)"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Configuration for file and attachment field types"
+            },
+            "encryptionConfig": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "algorithm": {
+                  "type": "string",
+                  "enum": [
+                    "aes-256-gcm",
+                    "aes-256-cbc",
+                    "chacha20-poly1305"
+                  ],
+                  "default": "aes-256-gcm"
+                },
+                "keyManagement": {
+                  "type": "object",
+                  "properties": {
+                    "provider": {
+                      "type": "string",
+                      "enum": [
+                        "local",
+                        "aws-kms",
+                        "azure-key-vault",
+                        "gcp-kms",
+                        "hashicorp-vault"
+                      ]
+                    },
+                    "keyId": {
+                      "type": "string"
+                    },
+                    "rotationPolicy": {
+                      "type": "object",
+                      "properties": {
+                        "enabled": {
+                          "type": "boolean",
+                          "default": false
+                        },
+                        "frequencyDays": {
+                          "type": "number",
+                          "minimum": 1,
+                          "default": 90
+                        },
+                        "retainOldVersions": {
+                          "type": "number",
+                          "default": 3
+                        },
+                        "autoRotate": {
+                          "type": "boolean",
+                          "default": true
+                        }
+                      },
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "provider"
+                  ],
+                  "additionalProperties": false
+                },
+                "scope": {
+                  "type": "string",
+                  "enum": [
+                    "field",
+                    "record",
+                    "table",
+                    "database"
+                  ]
+                },
+                "deterministicEncryption": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Allows equality queries on encrypted data"
+                },
+                "searchableEncryption": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Allows search on encrypted data"
+                }
+              },
+              "required": [
+                "keyManagement",
+                "scope"
+              ],
+              "additionalProperties": false,
+              "description": "Field-level encryption configuration for sensitive data (GDPR/HIPAA/PCI-DSS)"
+            },
+            "maskingRule": {
+              "type": "object",
+              "properties": {
+                "field": {
+                  "type": "string"
+                },
+                "strategy": {
+                  "type": "string",
+                  "enum": [
+                    "redact",
+                    "partial",
+                    "hash",
+                    "tokenize",
+                    "randomize",
+                    "nullify",
+                    "substitute"
+                  ]
+                },
+                "pattern": {
+                  "type": "string",
+                  "description": "Regex pattern for partial masking"
+                },
+                "preserveFormat": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "preserveLength": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "roles": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Roles that see masked data"
+                },
+                "exemptRoles": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Roles that see unmasked data"
+                }
+              },
+              "required": [
+                "field",
+                "strategy"
+              ],
+              "additionalProperties": false,
+              "description": "Data masking rules for PII protection"
+            },
+            "auditTrail": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable detailed audit trail for this field (tracks all changes with user and timestamp)"
+            },
+            "dependencies": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of field names that this field depends on (for formulas, visibility rules, etc.)"
+            },
+            "cached": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "description": "Enable caching for computed field results"
+                },
+                "ttl": {
+                  "type": "number",
+                  "minimum": 0,
+                  "description": "Cache TTL in seconds (0 = no expiration)"
+                },
+                "invalidateOn": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Field paths that invalidate cache (e.g., [\"inventory.quantity\", \"pricing.base_price\"])"
+                }
+              },
+              "required": [
+                "enabled",
+                "ttl",
+                "invalidateOn"
+              ],
+              "additionalProperties": false,
+              "description": "Caching configuration for computed/formula fields"
+            },
+            "dataQuality": {
+              "type": "object",
+              "properties": {
+                "uniqueness": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Enforce unique values across all records"
+                },
+                "completeness": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1,
+                  "default": 0,
+                  "description": "Minimum ratio of non-null values (0-1, default: 0 = no requirement)"
+                },
+                "accuracy": {
+                  "type": "object",
+                  "properties": {
+                    "source": {
+                      "type": "string",
+                      "description": "Reference data source for validation (e.g., \"api.verify.com\", \"master_data\")"
+                    },
+                    "threshold": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1,
+                      "description": "Minimum accuracy threshold (0-1, e.g., 0.95 = 95% match required)"
+                    }
+                  },
+                  "required": [
+                    "source",
+                    "threshold"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Accuracy validation configuration"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Data quality validation and monitoring rules"
+            },
             "hidden": {
               "type": "boolean",
               "default": false,
@@ -424,7 +858,7 @@
             "encryption": {
               "type": "boolean",
               "default": false,
-              "description": "Encrypt at rest"
+              "description": "Deprecated: Use encryptionConfig for enhanced encryption features. Simple flag for backward compatibility."
             },
             "index": {
               "type": "boolean",

package/json-schema/ui/Page.json

@@ -102,7 +102,7 @@
                     "properties": {
                       "type": "object",
                       "additionalProperties": {},
-                      "description": "Component props passed to the widget. See block.zod.ts for schemas."
+                      "description": "Component props passed to the widget. See component.zod.ts for schemas."
                     },
                     "visibility": {
                       "type": "string",

package/json-schema/ui/PageComponent.json

@@ -48,7 +48,7 @@
         "properties": {
           "type": "object",
           "additionalProperties": {},
-          "description": "Component props passed to the widget. See block.zod.ts for schemas."
+          "description": "Component props passed to the widget. See component.zod.ts for schemas."
         },
         "visibility": {
           "type": "string",

package/json-schema/ui/PageRegion.json

@@ -66,7 +66,7 @@
               "properties": {
                 "type": "object",
                 "additionalProperties": {},
-                "description": "Component props passed to the widget. See block.zod.ts for schemas."
+                "description": "Component props passed to the widget. See component.zod.ts for schemas."
               },
               "visibility": {
                 "type": "string",

package/json-schema/ui/Report.json

@@ -166,21 +166,60 @@
               "type": "string",
               "enum": [
                 "bar",
+                "horizontal-bar",
                 "column",
+                "grouped-bar",
+                "stacked-bar",
                 "line",
+                "area",
+                "stacked-area",
+                "step-line",
                 "pie",
                 "donut",
+                "funnel",
                 "scatter",
-                "funnel"
-              ],
-              "description": "Chart type"
+                "bubble",
+                "treemap",
+                "sunburst",
+                "sankey",
+                "gauge",
+                "metric",
+                "kpi",
+                "choropleth",
+                "bubble-map",
+                "heatmap",
+                "radar",
+                "waterfall",
+                "box-plot",
+                "violin",
+                "table",
+                "pivot"
+              ]
             },
             "title": {
-              "type": "string"
+              "type": "string",
+              "description": "Chart title"
+            },
+            "description": {
+              "type": "string",
+              "description": "Chart description"
             },
             "showLegend": {
               "type": "boolean",
-              "default": true
+              "default": true,
+              "description": "Display legend"
+            },
+            "showDataLabels": {
+              "type": "boolean",
+              "default": false,
+              "description": "Display data labels on chart"
+            },
+            "colors": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Custom color palette"
             },
             "xAxis": {
               "type": "string",
@@ -189,6 +228,10 @@
             "yAxis": {
               "type": "string",
               "description": "Summary field for Y-Axis"
+            },
+            "groupBy": {
+              "type": "string",
+              "description": "Additional grouping field"
             }
           },
           "required": [

package/json-schema/ui/ReportChart.json

@@ -8,21 +8,60 @@
           "type": "string",
           "enum": [
             "bar",
+            "horizontal-bar",
             "column",
+            "grouped-bar",
+            "stacked-bar",
             "line",
+            "area",
+            "stacked-area",
+            "step-line",
             "pie",
             "donut",
+            "funnel",
             "scatter",
-            "funnel"
-          ],
-          "description": "Chart type"
+            "bubble",
+            "treemap",
+            "sunburst",
+            "sankey",
+            "gauge",
+            "metric",
+            "kpi",
+            "choropleth",
+            "bubble-map",
+            "heatmap",
+            "radar",
+            "waterfall",
+            "box-plot",
+            "violin",
+            "table",
+            "pivot"
+          ]
         },
         "title": {
-          "type": "string"
+          "type": "string",
+          "description": "Chart title"
+        },
+        "description": {
+          "type": "string",
+          "description": "Chart description"
         },
         "showLegend": {
           "type": "boolean",
-          "default": true
+          "default": true,
+          "description": "Display legend"
+        },
+        "showDataLabels": {
+          "type": "boolean",
+          "default": false,
+          "description": "Display data labels on chart"
+        },
+        "colors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Custom color palette"
         },
         "xAxis": {
           "type": "string",
@@ -31,6 +70,10 @@
         "yAxis": {
           "type": "string",
           "description": "Summary field for Y-Axis"
+        },
+        "groupBy": {
+          "type": "string",
+          "description": "Additional grouping field"
         }
       },
       "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/spec",
-  "version": "0.6.1",
+  "version": "0.7.2",
   "description": "ObjectStack Protocol & Specification - TypeScript Interfaces, JSON Schemas, and Convention Configurations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -48,6 +48,18 @@
     "./ui": {
       "types": "./dist/ui/index.d.ts",
       "default": "./dist/ui/index.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts/index.d.ts",
+      "default": "./dist/contracts/index.js"
+    },
+    "./integration": {
+      "types": "./dist/integration/index.d.ts",
+      "default": "./dist/integration/index.js"
+    },
+    "./permission": {
+      "types": "./dist/permission/index.d.ts",
+      "default": "./dist/permission/index.js"
     }
   },
   "files": [