@objectstack/spec 0.6.1 → 0.7.2

package/dist/system/worker.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.zod.d.ts","sourceRoot":"","sources":["../../src/system/worker.zod.ts"],"names":[],"mappings":"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"}

package/dist/system/worker.zod.js

@@ -0,0 +1,479 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchTask = exports.WorkerConfig = exports.QueueConfig = exports.Task = exports.WorkerStatsSchema = exports.WorkerConfigSchema = exports.BatchProgressSchema = exports.BatchTaskSchema = exports.QueueConfigSchema = exports.TaskExecutionResultSchema = exports.TaskSchema = exports.TaskRetryPolicySchema = exports.TaskStatus = exports.TASK_PRIORITY_VALUES = exports.TaskPriority = void 0;
+const zod_1 = require("zod");
+/**
+ * Worker System Protocol
+ *
+ * Background task processing system with queues, priorities, and retry logic.
+ * Provides a robust foundation for async task execution similar to:
+ * - Sidekiq (Ruby)
+ * - Celery (Python)
+ * - Bull/BullMQ (Node.js)
+ * - AWS SQS/Lambda
+ *
+ * Features:
+ * - Task queues with priorities
+ * - Task scheduling and retry logic
+ * - Batch processing
+ * - Dead letter queues
+ * - Task monitoring and logging
+ *
+ * @example Basic task
+ * ```typescript
+ * const task: Task = {
+ *   id: 'task-123',
+ *   type: 'send_email',
+ *   payload: { to: 'user@example.com', subject: 'Welcome' },
+ *   queue: 'notifications',
+ *   priority: 5
+ * };
+ * ```
+ */
+// ==========================================
+// Task Priority
+// ==========================================
+/**
+ * Task Priority Enum
+ * Lower numbers = higher priority
+ */
+exports.TaskPriority = zod_1.z.enum([
+    'critical', // 0 - Must execute immediately
+    'high', // 1 - Execute soon
+    'normal', // 2 - Default priority
+    'low', // 3 - Execute when resources available
+    'background', // 4 - Execute during low-traffic periods
+]);
+/**
+ * Task Priority Mapping
+ * Maps priority names to numeric values for sorting
+ */
+exports.TASK_PRIORITY_VALUES = {
+    critical: 0,
+    high: 1,
+    normal: 2,
+    low: 3,
+    background: 4,
+};
+// ==========================================
+// Task Status
+// ==========================================
+/**
+ * Task Status Enum
+ * Lifecycle states of a task
+ */
+exports.TaskStatus = zod_1.z.enum([
+    'pending', // Waiting to be processed
+    'queued', // In queue, ready for worker
+    'processing', // Currently being executed
+    'completed', // Successfully completed
+    'failed', // Failed (may retry)
+    'cancelled', // Manually cancelled
+    'timeout', // Exceeded execution timeout
+    'dead', // Moved to dead letter queue
+]);
+// ==========================================
+// Task Schema
+// ==========================================
+/**
+ * Task Retry Policy Schema
+ * Configuration for task retry behavior
+ */
+exports.TaskRetryPolicySchema = zod_1.z.object({
+    maxRetries: zod_1.z.number().int().min(0).default(3).describe('Maximum retry attempts'),
+    backoffStrategy: zod_1.z.enum(['fixed', 'linear', 'exponential']).default('exponential')
+        .describe('Backoff strategy between retries'),
+    initialDelayMs: zod_1.z.number().int().positive().default(1000).describe('Initial retry delay in milliseconds'),
+    maxDelayMs: zod_1.z.number().int().positive().default(60000).describe('Maximum retry delay in milliseconds'),
+    backoffMultiplier: zod_1.z.number().positive().default(2).describe('Multiplier for exponential backoff'),
+});
+/**
+ * Task Schema
+ * Represents a background task to be executed
+ *
+ * @example
+ * {
+ *   "id": "task-abc123",
+ *   "type": "send_email",
+ *   "payload": { "to": "user@example.com", "template": "welcome" },
+ *   "queue": "notifications",
+ *   "priority": "high",
+ *   "retryPolicy": {
+ *     "maxRetries": 3,
+ *     "backoffStrategy": "exponential"
+ *   }
+ * }
+ */
+exports.TaskSchema = zod_1.z.object({
+    /**
+     * Unique task identifier
+     */
+    id: zod_1.z.string().describe('Unique task identifier'),
+    /**
+     * Task type (handler identifier)
+     */
+    type: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Task type (snake_case)'),
+    /**
+     * Task payload data
+     */
+    payload: zod_1.z.any().describe('Task payload data'),
+    /**
+     * Queue name
+     */
+    queue: zod_1.z.string().default('default').describe('Queue name'),
+    /**
+     * Task priority
+     */
+    priority: exports.TaskPriority.default('normal').describe('Task priority level'),
+    /**
+     * Retry policy
+     */
+    retryPolicy: exports.TaskRetryPolicySchema.optional().describe('Retry policy configuration'),
+    /**
+     * Execution timeout in milliseconds
+     */
+    timeoutMs: zod_1.z.number().int().positive().optional().describe('Task timeout in milliseconds'),
+    /**
+     * Scheduled execution time
+     */
+    scheduledAt: zod_1.z.string().datetime().optional().describe('ISO 8601 datetime to execute task'),
+    /**
+     * Maximum execution attempts
+     */
+    attempts: zod_1.z.number().int().min(0).default(0).describe('Number of execution attempts'),
+    /**
+     * Task status
+     */
+    status: exports.TaskStatus.default('pending').describe('Current task status'),
+    /**
+     * Task metadata
+     */
+    metadata: zod_1.z.object({
+        createdAt: zod_1.z.string().datetime().optional().describe('When task was created'),
+        updatedAt: zod_1.z.string().datetime().optional().describe('Last update time'),
+        createdBy: zod_1.z.string().optional().describe('User who created task'),
+        tags: zod_1.z.array(zod_1.z.string()).optional().describe('Task tags for filtering'),
+    }).optional().describe('Task metadata'),
+});
+// ==========================================
+// Task Execution Result
+// ==========================================
+/**
+ * Task Execution Result Schema
+ * Result of a task execution attempt
+ */
+exports.TaskExecutionResultSchema = zod_1.z.object({
+    /**
+     * Task identifier
+     */
+    taskId: zod_1.z.string().describe('Task identifier'),
+    /**
+     * Execution status
+     */
+    status: exports.TaskStatus.describe('Execution status'),
+    /**
+     * Execution result data
+     */
+    result: zod_1.z.any().optional().describe('Execution result data'),
+    /**
+     * Error information
+     */
+    error: zod_1.z.object({
+        message: zod_1.z.string().describe('Error message'),
+        stack: zod_1.z.string().optional().describe('Error stack trace'),
+        code: zod_1.z.string().optional().describe('Error code'),
+    }).optional().describe('Error details if failed'),
+    /**
+     * Execution duration
+     */
+    durationMs: zod_1.z.number().int().optional().describe('Execution duration in milliseconds'),
+    /**
+     * Execution timestamps
+     */
+    startedAt: zod_1.z.string().datetime().describe('When execution started'),
+    completedAt: zod_1.z.string().datetime().optional().describe('When execution completed'),
+    /**
+     * Retry information
+     */
+    attempt: zod_1.z.number().int().min(1).describe('Attempt number (1-indexed)'),
+    willRetry: zod_1.z.boolean().describe('Whether task will be retried'),
+});
+// ==========================================
+// Queue Configuration
+// ==========================================
+/**
+ * Queue Configuration Schema
+ * Configuration for a task queue
+ *
+ * @example
+ * {
+ *   "name": "notifications",
+ *   "concurrency": 10,
+ *   "rateLimit": {
+ *     "max": 100,
+ *     "duration": 60000
+ *   }
+ * }
+ */
+exports.QueueConfigSchema = zod_1.z.object({
+    /**
+     * Queue name
+     */
+    name: zod_1.z.string().describe('Queue name (snake_case)'),
+    /**
+     * Maximum concurrent workers
+     */
+    concurrency: zod_1.z.number().int().min(1).default(5).describe('Max concurrent task executions'),
+    /**
+     * Rate limiting
+     */
+    rateLimit: zod_1.z.object({
+        max: zod_1.z.number().int().positive().describe('Maximum tasks per duration'),
+        duration: zod_1.z.number().int().positive().describe('Duration in milliseconds'),
+    }).optional().describe('Rate limit configuration'),
+    /**
+     * Default retry policy
+     */
+    defaultRetryPolicy: exports.TaskRetryPolicySchema.optional().describe('Default retry policy for tasks'),
+    /**
+     * Dead letter queue
+     */
+    deadLetterQueue: zod_1.z.string().optional().describe('Dead letter queue name'),
+    /**
+     * Queue priority
+     */
+    priority: zod_1.z.number().int().min(0).default(0).describe('Queue priority (lower = higher priority)'),
+    /**
+     * Auto-scaling configuration
+     */
+    autoScale: zod_1.z.object({
+        enabled: zod_1.z.boolean().default(false).describe('Enable auto-scaling'),
+        minWorkers: zod_1.z.number().int().min(1).default(1).describe('Minimum workers'),
+        maxWorkers: zod_1.z.number().int().min(1).default(10).describe('Maximum workers'),
+        scaleUpThreshold: zod_1.z.number().int().positive().default(100).describe('Queue size to scale up'),
+        scaleDownThreshold: zod_1.z.number().int().min(0).default(10).describe('Queue size to scale down'),
+    }).optional().describe('Auto-scaling configuration'),
+});
+// ==========================================
+// Batch Processing
+// ==========================================
+/**
+ * Batch Task Schema
+ * Configuration for batch processing multiple items
+ *
+ * @example
+ * {
+ *   "id": "batch-import-123",
+ *   "type": "import_records",
+ *   "items": [{ "name": "Item 1" }, { "name": "Item 2" }],
+ *   "batchSize": 100,
+ *   "queue": "batch_processing"
+ * }
+ */
+exports.BatchTaskSchema = zod_1.z.object({
+    /**
+     * Batch job identifier
+     */
+    id: zod_1.z.string().describe('Unique batch job identifier'),
+    /**
+     * Task type for processing each item
+     */
+    type: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Task type (snake_case)'),
+    /**
+     * Items to process
+     */
+    items: zod_1.z.array(zod_1.z.any()).describe('Array of items to process'),
+    /**
+     * Batch size (items per task)
+     */
+    batchSize: zod_1.z.number().int().min(1).default(100).describe('Number of items per batch'),
+    /**
+     * Queue name
+     */
+    queue: zod_1.z.string().default('batch').describe('Queue for batch tasks'),
+    /**
+     * Priority
+     */
+    priority: exports.TaskPriority.default('normal').describe('Batch task priority'),
+    /**
+     * Parallel processing
+     */
+    parallel: zod_1.z.boolean().default(true).describe('Process batches in parallel'),
+    /**
+     * Stop on error
+     */
+    stopOnError: zod_1.z.boolean().default(false).describe('Stop batch if any item fails'),
+    /**
+     * Progress callback
+     *
+     * Called after each batch completes to report progress.
+     * Invoked asynchronously and should not throw errors.
+     * If the callback throws, the error is logged but batch processing continues.
+     *
+     * @param progress - Object containing processed count, total count, and failed count
+     */
+    onProgress: zod_1.z.function()
+        .args(zod_1.z.object({
+        processed: zod_1.z.number(),
+        total: zod_1.z.number(),
+        failed: zod_1.z.number(),
+    }))
+        .returns(zod_1.z.void())
+        .optional()
+        .describe('Progress callback function (called after each batch)'),
+});
+/**
+ * Batch Progress Schema
+ * Tracks progress of a batch job
+ */
+exports.BatchProgressSchema = zod_1.z.object({
+    /**
+     * Batch job identifier
+     */
+    batchId: zod_1.z.string().describe('Batch job identifier'),
+    /**
+     * Total items
+     */
+    total: zod_1.z.number().int().min(0).describe('Total number of items'),
+    /**
+     * Processed items
+     */
+    processed: zod_1.z.number().int().min(0).default(0).describe('Items processed'),
+    /**
+     * Successful items
+     */
+    succeeded: zod_1.z.number().int().min(0).default(0).describe('Items succeeded'),
+    /**
+     * Failed items
+     */
+    failed: zod_1.z.number().int().min(0).default(0).describe('Items failed'),
+    /**
+     * Progress percentage
+     */
+    percentage: zod_1.z.number().min(0).max(100).describe('Progress percentage'),
+    /**
+     * Status
+     */
+    status: zod_1.z.enum(['pending', 'running', 'completed', 'failed', 'cancelled']).describe('Batch status'),
+    /**
+     * Timestamps
+     */
+    startedAt: zod_1.z.string().datetime().optional().describe('When batch started'),
+    completedAt: zod_1.z.string().datetime().optional().describe('When batch completed'),
+});
+// ==========================================
+// Worker Configuration
+// ==========================================
+/**
+ * Worker Configuration Schema
+ * Configuration for a worker instance
+ */
+exports.WorkerConfigSchema = zod_1.z.object({
+    /**
+     * Worker name
+     */
+    name: zod_1.z.string().describe('Worker name'),
+    /**
+     * Queues to process
+     */
+    queues: zod_1.z.array(zod_1.z.string()).min(1).describe('Queue names to process'),
+    /**
+     * Queue configurations
+     */
+    queueConfigs: zod_1.z.array(exports.QueueConfigSchema).optional().describe('Queue configurations'),
+    /**
+     * Polling interval
+     */
+    pollIntervalMs: zod_1.z.number().int().positive().default(1000).describe('Queue polling interval in milliseconds'),
+    /**
+     * Visibility timeout
+     */
+    visibilityTimeoutMs: zod_1.z.number().int().positive().default(30000)
+        .describe('How long a task is invisible after being claimed'),
+    /**
+     * Task timeout
+     */
+    defaultTimeoutMs: zod_1.z.number().int().positive().default(300000).describe('Default task timeout in milliseconds'),
+    /**
+     * Graceful shutdown timeout
+     */
+    shutdownTimeoutMs: zod_1.z.number().int().positive().default(30000)
+        .describe('Graceful shutdown timeout in milliseconds'),
+    /**
+     * Task handlers
+     */
+    handlers: zod_1.z.record(zod_1.z.string(), zod_1.z.function()).optional().describe('Task type handlers'),
+});
+// ==========================================
+// Worker Stats
+// ==========================================
+/**
+ * Worker Stats Schema
+ * Runtime statistics for a worker
+ */
+exports.WorkerStatsSchema = zod_1.z.object({
+    /**
+     * Worker name
+     */
+    workerName: zod_1.z.string().describe('Worker name'),
+    /**
+     * Total tasks processed
+     */
+    totalProcessed: zod_1.z.number().int().min(0).describe('Total tasks processed'),
+    /**
+     * Successful tasks
+     */
+    succeeded: zod_1.z.number().int().min(0).describe('Successful tasks'),
+    /**
+     * Failed tasks
+     */
+    failed: zod_1.z.number().int().min(0).describe('Failed tasks'),
+    /**
+     * Active tasks
+     */
+    active: zod_1.z.number().int().min(0).describe('Currently active tasks'),
+    /**
+     * Average execution time
+     */
+    avgExecutionMs: zod_1.z.number().min(0).optional().describe('Average execution time in milliseconds'),
+    /**
+     * Uptime
+     */
+    uptimeMs: zod_1.z.number().int().min(0).describe('Worker uptime in milliseconds'),
+    /**
+     * Queue stats
+     */
+    queues: zod_1.z.record(zod_1.z.string(), zod_1.z.object({
+        pending: zod_1.z.number().int().min(0).describe('Pending tasks'),
+        active: zod_1.z.number().int().min(0).describe('Active tasks'),
+        completed: zod_1.z.number().int().min(0).describe('Completed tasks'),
+        failed: zod_1.z.number().int().min(0).describe('Failed tasks'),
+    })).optional().describe('Per-queue statistics'),
+});
+// ==========================================
+// Helper Functions
+// ==========================================
+/**
+ * Helper to create a task
+ */
+exports.Task = Object.assign(exports.TaskSchema, {
+    create: (task) => task,
+});
+/**
+ * Helper to create a queue config
+ */
+exports.QueueConfig = Object.assign(exports.QueueConfigSchema, {
+    create: (config) => config,
+});
+/**
+ * Helper to create a worker config
+ */
+exports.WorkerConfig = Object.assign(exports.WorkerConfigSchema, {
+    create: (config) => config,
+});
+/**
+ * Helper to create a batch task
+ */
+exports.BatchTask = Object.assign(exports.BatchTaskSchema, {
+    create: (batch) => batch,
+});

package/dist/ui/action.zod.d.ts

@@ -19,7 +19,7 @@ export declare const ActionParamSchema: z.ZodObject<{
         label: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+    type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
     required: boolean;
     label: string;
     name: string;
@@ -28,7 +28,7 @@ export declare const ActionParamSchema: z.ZodObject<{
         label: string;
     }[] | undefined;
 }, {
-    type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+    type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
     label: string;
     name: string;
     options?: {
@@ -96,7 +96,7 @@ export declare const ActionSchema: z.ZodObject<{
             label: string;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+        type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         required: boolean;
         label: string;
         name: string;
@@ -105,7 +105,7 @@ export declare const ActionSchema: z.ZodObject<{
             label: string;
         }[] | undefined;
     }, {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+        type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         label: string;
         name: string;
         options?: {
@@ -126,7 +126,7 @@ export declare const ActionSchema: z.ZodObject<{
     name: string;
     refreshAfter: boolean;
     params?: {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+        type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         required: boolean;
         label: string;
         name: string;
@@ -135,20 +135,20 @@ export declare const ActionSchema: z.ZodObject<{
             label: string;
         }[] | undefined;
     }[] | undefined;
+    target?: string | undefined;
     location?: any;
     icon?: string | undefined;
+    execute?: string | undefined;
     visible?: string | undefined;
-    target?: string | undefined;
     locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
     component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
-    execute?: string | undefined;
     confirmText?: string | undefined;
     successMessage?: string | undefined;
 }, {
     label: string;
     name: string;
     params?: {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
+        type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         label: string;
         name: string;
         options?: {
@@ -158,13 +158,13 @@ export declare const ActionSchema: z.ZodObject<{
         required?: boolean | undefined;
     }[] | undefined;
     type?: "url" | "script" | "api" | "modal" | "flow" | undefined;
+    target?: string | undefined;
     location?: any;
     icon?: string | undefined;
+    execute?: string | undefined;
     visible?: string | undefined;
-    target?: string | undefined;
     locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
     component?: "action:button" | "action:icon" | "action:menu" | "action:group" | undefined;
-    execute?: string | undefined;
     confirmText?: string | undefined;
     successMessage?: string | undefined;
     refreshAfter?: boolean | undefined;

package/dist/ui/app.zod.d.ts

@@ -133,10 +133,10 @@ export declare const UrlNavItemSchema: z.ZodObject<{
     target: z.ZodDefault<z.ZodEnum<["_self", "_blank"]>>;
 }, "strip", z.ZodTypeAny, {
     type: "url";
+    target: "_self" | "_blank";
     url: string;
     label: string;
     id: string;
-    target: "_self" | "_blank";
     icon?: string | undefined;
     visible?: string | undefined;
 }, {
@@ -144,9 +144,9 @@ export declare const UrlNavItemSchema: z.ZodObject<{
     url: string;
     label: string;
     id: string;
+    target?: "_self" | "_blank" | undefined;
     icon?: string | undefined;
     visible?: string | undefined;
-    target?: "_self" | "_blank" | undefined;
 }>;
 /**
  * 5. Group Navigation Item
@@ -284,9 +284,9 @@ export declare const AppSchema: z.ZodObject<{
     active: boolean;
     isDefault: boolean;
     description?: string | undefined;
+    version?: string | undefined;
     icon?: string | undefined;
     objects?: any[] | undefined;
-    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;
@@ -301,9 +301,9 @@ export declare const AppSchema: z.ZodObject<{
     name: string;
     description?: string | undefined;
     active?: boolean | undefined;
+    version?: string | undefined;
     icon?: string | undefined;
     objects?: any[] | undefined;
-    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;
@@ -374,9 +374,9 @@ export declare const App: z.ZodObject<{
     active: boolean;
     isDefault: boolean;
     description?: string | undefined;
+    version?: string | undefined;
     icon?: string | undefined;
     objects?: any[] | undefined;
-    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;
@@ -391,9 +391,9 @@ export declare const App: z.ZodObject<{
     name: string;
     description?: string | undefined;
     active?: boolean | undefined;
+    version?: string | undefined;
     icon?: string | undefined;
     objects?: any[] | undefined;
-    version?: string | undefined;
     branding?: {
         primaryColor?: string | undefined;
         logo?: string | undefined;