@objectstack/spec 0.3.3 → 0.4.1

package/dist/ui/widget.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget.zod.d.ts","sourceRoot":"","sources":["../../src/ui/widget.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;OAGG;;IAGH;;;;;OAKG;;IAMH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"widget.zod.d.ts","sourceRoot":"","sources":["../../src/ui/widget.zod.ts"],"names":[],"mappings":"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"}

package/dist/ui/widget.zod.js

@@ -1,8 +1,301 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FieldWidgetPropsSchema = void 0;
+exports.FieldWidgetPropsSchema = exports.WidgetManifestSchema = exports.WidgetPropertySchema = exports.WidgetEventSchema = exports.WidgetLifecycleSchema = void 0;
 const zod_1 = require("zod");
 const field_zod_1 = require("../data/field.zod");
+/**
+ * Widget Lifecycle Hooks Schema
+ *
+ * Defines lifecycle callbacks for custom widgets inspired by Web Components and React.
+ * These hooks allow widgets to perform initialization, cleanup, and respond to changes.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_components
+ * @see https://react.dev/reference/react/Component#component-lifecycle
+ *
+ * @example
+ * ```typescript
+ * const widget = {
+ *   lifecycle: {
+ *     onMount: "console.log('Widget mounted')",
+ *     onUpdate: "if (prevProps.value !== props.value) { updateUI() }",
+ *     onUnmount: "cleanup()",
+ *     onValidate: "return value.length > 0 ? null : 'Required field'"
+ *   }
+ * }
+ * ```
+ */
+exports.WidgetLifecycleSchema = zod_1.z.object({
+    /**
+     * Called when widget is mounted/rendered for the first time
+     * Use for initialization, setting up event listeners, loading data, etc.
+     *
+     * @example "initializeDatePicker(); loadOptions();"
+     */
+    onMount: zod_1.z.string().optional().describe('Initialization code when widget mounts'),
+    /**
+     * Called when widget props change
+     * Receives previous props for comparison
+     *
+     * @example "if (prevProps.value !== props.value) { updateDisplay() }"
+     */
+    onUpdate: zod_1.z.string().optional().describe('Code to run when props change'),
+    /**
+     * Called when widget is about to be removed from DOM
+     * Use for cleanup, removing event listeners, canceling timers, etc.
+     *
+     * @example "destroyDatePicker(); cancelPendingRequests();"
+     */
+    onUnmount: zod_1.z.string().optional().describe('Cleanup code when widget unmounts'),
+    /**
+     * Custom validation logic for this widget
+     * Should return error message string if invalid, null/undefined if valid
+     *
+     * @example "return value && value.length >= 10 ? null : 'Minimum 10 characters'"
+     */
+    onValidate: zod_1.z.string().optional().describe('Custom validation logic'),
+    /**
+     * Called when widget receives focus
+     *
+     * @example "highlightField(); logFocusEvent();"
+     */
+    onFocus: zod_1.z.string().optional().describe('Code to run on focus'),
+    /**
+     * Called when widget loses focus
+     *
+     * @example "validateField(); saveFieldState();"
+     */
+    onBlur: zod_1.z.string().optional().describe('Code to run on blur'),
+    /**
+     * Called on any error in the widget
+     *
+     * @example "logError(error); showErrorNotification();"
+     */
+    onError: zod_1.z.string().optional().describe('Error handling code'),
+});
+/**
+ * Widget Event Schema
+ *
+ * Defines custom events that widgets can emit, inspired by DOM Events and Lightning Web Components.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/Events/Creating_and_triggering_events
+ * @see https://developer.salesforce.com/docs/component-library/documentation/en/lwc/lwc.events
+ *
+ * @example
+ * ```typescript
+ * const searchEvent = {
+ *   name: 'search',
+ *   bubbles: true,
+ *   cancelable: false,
+ *   payload: {
+ *     query: 'string',
+ *     filters: 'object'
+ *   }
+ * }
+ * ```
+ */
+exports.WidgetEventSchema = zod_1.z.object({
+    /**
+     * Event name
+     * Should be lowercase, dash-separated for consistency
+     *
+     * @example "value-change", "item-selected", "search-complete"
+     */
+    name: zod_1.z.string().describe('Event name'),
+    /**
+     * Event label for documentation
+     */
+    label: zod_1.z.string().optional().describe('Human-readable event label'),
+    /**
+     * Event description
+     */
+    description: zod_1.z.string().optional().describe('Event description and usage'),
+    /**
+     * Whether event bubbles up through the DOM hierarchy
+     *
+     * @default false
+     */
+    bubbles: zod_1.z.boolean().default(false).describe('Whether event bubbles'),
+    /**
+     * Whether event can be cancelled
+     *
+     * @default false
+     */
+    cancelable: zod_1.z.boolean().default(false).describe('Whether event is cancelable'),
+    /**
+     * Event payload schema
+     * Defines the data structure sent with the event
+     *
+     * @example { userId: 'string', timestamp: 'number' }
+     */
+    payload: zod_1.z.record(zod_1.z.any()).optional().describe('Event payload schema'),
+});
+/**
+ * Widget Property Definition Schema
+ *
+ * Defines the contract for widget configuration properties.
+ * Inspired by React PropTypes and Web Component attributes.
+ *
+ * @see https://react.dev/reference/react/Component#static-proptypes
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements
+ *
+ * @example
+ * ```typescript
+ * const widgetProps = {
+ *   maxLength: {
+ *     type: 'number',
+ *     required: false,
+ *     default: 100,
+ *     description: 'Maximum input length'
+ *   }
+ * }
+ * ```
+ */
+exports.WidgetPropertySchema = zod_1.z.object({
+    /**
+     * Property name
+     * Should be camelCase following ObjectStack conventions
+     */
+    name: zod_1.z.string().describe('Property name (camelCase)'),
+    /**
+     * Property label for UI
+     */
+    label: zod_1.z.string().optional().describe('Human-readable label'),
+    /**
+     * Property data type
+     *
+     * @example "string", "number", "boolean", "array", "object", "function"
+     */
+    type: zod_1.z.enum(['string', 'number', 'boolean', 'array', 'object', 'function', 'any'])
+        .describe('TypeScript type'),
+    /**
+     * Whether property is required
+     *
+     * @default false
+     */
+    required: zod_1.z.boolean().default(false).describe('Whether property is required'),
+    /**
+     * Default value for the property
+     */
+    default: zod_1.z.any().optional().describe('Default value'),
+    /**
+     * Property description
+     */
+    description: zod_1.z.string().optional().describe('Property description'),
+    /**
+     * Property validation schema
+     * Can include min/max, regex, enum values, etc.
+     */
+    validation: zod_1.z.record(zod_1.z.any()).optional().describe('Validation rules'),
+    /**
+     * Property category for grouping in UI
+     */
+    category: zod_1.z.string().optional().describe('Property category'),
+});
+/**
+ * Widget Manifest Schema
+ *
+ * Complete definition for a custom widget including metadata, lifecycle, events, and props.
+ * This is used for widget registration and discovery.
+ *
+ * @example
+ * ```typescript
+ * const customWidget = {
+ *   name: 'custom_date_picker',
+ *   label: 'Custom Date Picker',
+ *   version: '1.0.0',
+ *   author: 'Company Name',
+ *   fieldTypes: ['date', 'datetime'],
+ *   lifecycle: { ... },
+ *   events: [ ... ],
+ *   properties: [ ... ]
+ * }
+ * ```
+ */
+exports.WidgetManifestSchema = zod_1.z.object({
+    /**
+     * Widget identifier (snake_case)
+     */
+    name: zod_1.z.string()
+        .regex(/^[a-z_][a-z0-9_]*$/)
+        .describe('Widget identifier (snake_case)'),
+    /**
+     * Human-readable widget name
+     */
+    label: zod_1.z.string().describe('Widget display name'),
+    /**
+     * Widget description
+     */
+    description: zod_1.z.string().optional().describe('Widget description'),
+    /**
+     * Widget version (semver)
+     */
+    version: zod_1.z.string().optional().describe('Widget version (semver)'),
+    /**
+     * Widget author/organization
+     */
+    author: zod_1.z.string().optional().describe('Widget author'),
+    /**
+     * Icon name or URL
+     */
+    icon: zod_1.z.string().optional().describe('Widget icon'),
+    /**
+     * Field types this widget supports
+     *
+     * @example ["text", "email", "url"]
+     */
+    fieldTypes: zod_1.z.array(zod_1.z.string()).optional().describe('Supported field types'),
+    /**
+     * Widget category for organization
+     */
+    category: zod_1.z.enum(['input', 'display', 'picker', 'editor', 'custom'])
+        .default('custom')
+        .describe('Widget category'),
+    /**
+     * Widget lifecycle hooks
+     */
+    lifecycle: exports.WidgetLifecycleSchema.optional().describe('Lifecycle hooks'),
+    /**
+     * Custom events this widget emits
+     */
+    events: zod_1.z.array(exports.WidgetEventSchema).optional().describe('Custom events'),
+    /**
+     * Widget configuration properties
+     */
+    properties: zod_1.z.array(exports.WidgetPropertySchema).optional().describe('Configuration properties'),
+    /**
+     * Widget implementation
+     * URL to component or inline code
+     */
+    implementation: zod_1.z.object({
+        type: zod_1.z.enum(['url', 'inline', 'module']).describe('Implementation type'),
+        source: zod_1.z.string().describe('Source URL, inline code, or module path'),
+    }).optional().describe('Widget implementation'),
+    /**
+     * Widget dependencies
+     * External libraries or scripts needed
+     */
+    dependencies: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        version: zod_1.z.string().optional(),
+        url: zod_1.z.string().url().optional(),
+    })).optional().describe('Widget dependencies'),
+    /**
+     * Widget screenshots for showcase
+     */
+    screenshots: zod_1.z.array(zod_1.z.string().url()).optional().describe('Screenshot URLs'),
+    /**
+     * Widget documentation URL
+     */
+    documentation: zod_1.z.string().url().optional().describe('Documentation URL'),
+    /**
+     * License information
+     */
+    license: zod_1.z.string().optional().describe('License (SPDX identifier)'),
+    /**
+     * Tags for discovery
+     */
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Tags for categorization'),
+});
 /**
  * Field Widget Props Schema
  *

package/json-schema/api/ODataError.json

@@ -0,0 +1,65 @@
+{
+  "$ref": "#/definitions/ODataError",
+  "definitions": {
+    "ODataError": {
+      "type": "object",
+      "properties": {
+        "error": {
+          "type": "object",
+          "properties": {
+            "code": {
+              "type": "string",
+              "description": "Error code"
+            },
+            "message": {
+              "type": "string",
+              "description": "Error message"
+            },
+            "target": {
+              "type": "string",
+              "description": "Error target"
+            },
+            "details": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "code": {
+                    "type": "string"
+                  },
+                  "message": {
+                    "type": "string"
+                  },
+                  "target": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "code",
+                  "message"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Error details"
+            },
+            "innererror": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Inner error details"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "error"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/api/ODataFilterFunction.json

@@ -0,0 +1,39 @@
+{
+  "$ref": "#/definitions/ODataFilterFunction",
+  "definitions": {
+    "ODataFilterFunction": {
+      "type": "string",
+      "enum": [
+        "contains",
+        "startswith",
+        "endswith",
+        "length",
+        "indexof",
+        "substring",
+        "tolower",
+        "toupper",
+        "trim",
+        "concat",
+        "year",
+        "month",
+        "day",
+        "hour",
+        "minute",
+        "second",
+        "date",
+        "time",
+        "now",
+        "maxdatetime",
+        "mindatetime",
+        "round",
+        "floor",
+        "ceiling",
+        "cast",
+        "isof",
+        "any",
+        "all"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/api/ODataFilterOperator.json

@@ -0,0 +1,24 @@
+{
+  "$ref": "#/definitions/ODataFilterOperator",
+  "definitions": {
+    "ODataFilterOperator": {
+      "type": "string",
+      "enum": [
+        "eq",
+        "ne",
+        "lt",
+        "le",
+        "gt",
+        "ge",
+        "and",
+        "or",
+        "not",
+        "(",
+        ")",
+        "in",
+        "has"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/api/ODataMetadata.json

@@ -0,0 +1,115 @@
+{
+  "$ref": "#/definitions/ODataMetadata",
+  "definitions": {
+    "ODataMetadata": {
+      "type": "object",
+      "properties": {
+        "namespace": {
+          "type": "string",
+          "description": "Service namespace"
+        },
+        "entityTypes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Entity type name"
+              },
+              "key": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Key fields"
+              },
+              "properties": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "OData type (Edm.String, Edm.Int32, etc.)"
+                    },
+                    "nullable": {
+                      "type": "boolean",
+                      "default": true
+                    }
+                  },
+                  "required": [
+                    "name",
+                    "type"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "navigationProperties": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    },
+                    "partner": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "name",
+                    "type"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "name",
+              "key",
+              "properties"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Entity types"
+        },
+        "entitySets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Entity set name"
+              },
+              "entityType": {
+                "type": "string",
+                "description": "Entity type"
+              }
+            },
+            "required": [
+              "name",
+              "entityType"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Entity sets"
+        }
+      },
+      "required": [
+        "namespace",
+        "entityTypes",
+        "entitySets"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/api/ODataQuery.json

@@ -0,0 +1,89 @@
+{
+  "$ref": "#/definitions/ODataQuery",
+  "definitions": {
+    "ODataQuery": {
+      "type": "object",
+      "properties": {
+        "$select": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Fields to select"
+        },
+        "$filter": {
+          "type": "string",
+          "description": "Filter expression (OData filter syntax)"
+        },
+        "$orderby": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Sort order"
+        },
+        "$top": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Max results to return"
+        },
+        "$skip": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Results to skip"
+        },
+        "$expand": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Navigation properties to expand"
+        },
+        "$count": {
+          "type": "boolean",
+          "description": "Include total count"
+        },
+        "$search": {
+          "type": "string",
+          "description": "Search expression"
+        },
+        "$format": {
+          "type": "string",
+          "enum": [
+            "json",
+            "xml",
+            "atom"
+          ],
+          "description": "Response format"
+        },
+        "$apply": {
+          "type": "string",
+          "description": "Aggregation expression"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/api/ODataResponse.json

@@ -0,0 +1,37 @@
+{
+  "$ref": "#/definitions/ODataResponse",
+  "definitions": {
+    "ODataResponse": {
+      "type": "object",
+      "properties": {
+        "@odata.context": {
+          "type": "string",
+          "format": "uri",
+          "description": "Metadata context URL"
+        },
+        "@odata.count": {
+          "type": "integer",
+          "description": "Total results count"
+        },
+        "@odata.nextLink": {
+          "type": "string",
+          "format": "uri",
+          "description": "Next page URL"
+        },
+        "value": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": {}
+          },
+          "description": "Results array"
+        }
+      },
+      "required": [
+        "value"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/auth/Role.json

@@ -6,8 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$",
-          "description": "Unique role name"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique role name (lowercase snake_case)"
         },
         "label": {
           "type": "string",