@objectstack/spec 0.1.0 → 0.1.1

package/dist/system/translation.zod.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslationBundleSchema = exports.LocaleSchema = exports.TranslationDataSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Translation Schema
+ * Supports i18n for labels, messages, and options.
+ * Example structure:
+ * {
+ *   "en": { "objects": { "account": { "label": "Account" } } },
+ *   "zh-CN": { "objects": { "account": { "label": "客户" } } }
+ * }
+ */
+exports.TranslationDataSchema = zod_1.z.object({
+    /** Object translations */
+    objects: zod_1.z.record(zod_1.z.object({
+        label: zod_1.z.string(),
+        pluralLabel: zod_1.z.string().optional(),
+        fields: zod_1.z.record(zod_1.z.object({
+            label: zod_1.z.string().optional(),
+            help: zod_1.z.string().optional(),
+            options: zod_1.z.record(zod_1.z.string()).optional(), // Option value -> Label map
+        })).optional(),
+    })).optional(),
+    /** App/Menu translations */
+    apps: zod_1.z.record(zod_1.z.object({
+        label: zod_1.z.string(),
+        description: zod_1.z.string().optional(),
+    })).optional(),
+    /** UI Messages */
+    messages: zod_1.z.record(zod_1.z.string()).optional(),
+});
+exports.LocaleSchema = zod_1.z.string().describe('BCP-47 Language Tag (e.g. en-US, zh-CN)');
+exports.TranslationBundleSchema = zod_1.z.record(exports.LocaleSchema, exports.TranslationDataSchema);

package/dist/system/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ObjectStack Plugin Runtime Interfaces
+ *
+ * This package defines the contract that every plugin must implement to be loaded by ObjectOS.
+ */
+export * from './plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/system/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/system/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC"}

package/dist/system/types/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * ObjectStack Plugin Runtime Interfaces
+ *
+ * This package defines the contract that every plugin must implement to be loaded by ObjectOS.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./plugin"), exports);

package/dist/system/types/plugin.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Runtime interfaces for ObjectStack plugins.
+ * These define the contract that every plugin must implement to be loaded by ObjectOS.
+ */
+/**
+ * Logger interface provided to plugins for structured logging.
+ */
+export interface PluginLogger {
+    /** Log an informational message */
+    info(message: string, meta?: Record<string, any>): void;
+    /** Log a warning message */
+    warn(message: string, meta?: Record<string, any>): void;
+    /** Log an error message */
+    error(message: string, error?: Error, meta?: Record<string, any>): void;
+    /** Log a debug message */
+    debug(message: string, meta?: Record<string, any>): void;
+}
+/**
+ * ObjectQL Client interface for database operations.
+ * Provides a GraphQL-like query interface to the ObjectStack data layer.
+ */
+export interface ObjectQLClient {
+    /**
+     * Execute a query against the ObjectQL engine.
+     * @param query - The ObjectQL query string
+     * @param variables - Optional variables for the query
+     * @returns Promise resolving to query results
+     */
+    query<T = any>(query: string, variables?: Record<string, any>): Promise<T>;
+    /**
+     * Execute a mutation against the ObjectQL engine.
+     * @param mutation - The ObjectQL mutation string
+     * @param variables - Optional variables for the mutation
+     * @returns Promise resolving to mutation results
+     */
+    mutate<T = any>(mutation: string, variables?: Record<string, any>): Promise<T>;
+}
+/**
+ * ObjectOS Kernel interface.
+ * Provides access to core operating system services.
+ */
+export interface ObjectOSKernel {
+    /**
+     * Get a reference to another installed plugin by its ID.
+     * @param pluginId - The unique identifier of the plugin
+     * @returns The plugin instance or null if not found
+     */
+    getPlugin(pluginId: string): any | null;
+    /**
+     * Emit an event to the system event bus.
+     * @param event - The event name
+     * @param data - The event payload
+     */
+    emit(event: string, data?: any): void;
+    /**
+     * Subscribe to system events.
+     * @param event - The event name to listen for
+     * @param handler - Callback function to handle the event
+     * @returns Unsubscribe function
+     */
+    on(event: string, handler: (data: any) => void): () => void;
+}
+/**
+ * Plugin Context provided to plugin lifecycle methods.
+ * This context gives plugins access to the ObjectStack runtime environment.
+ */
+export interface PluginContext {
+    /**
+     * ObjectQL client for database operations.
+     * Use this to query and mutate data in the ObjectStack data layer.
+     */
+    ql: ObjectQLClient;
+    /**
+     * ObjectOS kernel for system-level operations.
+     * Use this to interact with other plugins and system services.
+     */
+    os: ObjectOSKernel;
+    /**
+     * Logger instance for structured logging.
+     * All logs are automatically tagged with the plugin ID.
+     */
+    logger: PluginLogger;
+    /**
+     * The unique identifier of this plugin.
+     */
+    pluginId: string;
+    /**
+     * Plugin configuration values (from manifest or runtime config).
+     */
+    config: Record<string, any>;
+}
+/**
+ * Plugin Lifecycle Interface.
+ * Every ObjectStack plugin must default export an object implementing this interface.
+ */
+export interface ObjectStackPlugin {
+    /**
+     * Called when the plugin is installed for the first time.
+     * Use this to run one-time setup tasks (e.g. creating database tables).
+     */
+    onInstall?: (context: PluginContext) => Promise<void>;
+    /**
+     * Called when the plugin is enabled (at startup or manually).
+     * Use this to register event listeners, start background tasks, etc.
+     */
+    onEnable?: (context: PluginContext) => Promise<void>;
+    /**
+     * Called when the plugin is disabled (at shutdown or manually).
+     * Use this to cleanup resources, stop tasks, remove listeners.
+     */
+    onDisable?: (context: PluginContext) => Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/system/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/system/types/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACxD,4BAA4B;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACxD,2BAA2B;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACxE,0BAA0B;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAEtC;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,EAAE,EAAE,cAAc,CAAC;IAEnB;;;OAGG;IACH,EAAE,EAAE,cAAc,CAAC;IAEnB;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/system/types/plugin.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Runtime interfaces for ObjectStack plugins.
+ * These define the contract that every plugin must implement to be loaded by ObjectOS.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/system/webhook.zod.d.ts

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+/**
+ * Webhook Trigger Event
+ * When should this webhook fire?
+ */
+export declare const WebhookTriggerType: z.ZodEnum<["create", "update", "delete", "undelete", "api"]>;
+/**
+ * Webhook Schema
+ * outbound Integration: Push data to external URL when events happen.
+ */
+export declare const WebhookSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    /** Scope */
+    object: z.ZodString;
+    triggers: z.ZodArray<z.ZodEnum<["create", "update", "delete", "undelete", "api"]>, "many">;
+    /** Target */
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<["POST", "PUT", "GET"]>>;
+    /** Security */
+    secret: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Payload Configuration */
+    payloadFields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    includeSession: z.ZodDefault<z.ZodBoolean>;
+    /** Reliability */
+    retryCount: z.ZodDefault<z.ZodNumber>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    object: string;
+    url: string;
+    name: string;
+    method: "GET" | "POST" | "PUT";
+    triggers: ("api" | "update" | "create" | "delete" | "undelete")[];
+    includeSession: boolean;
+    retryCount: number;
+    isActive: boolean;
+    label?: string | undefined;
+    secret?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    payloadFields?: string[] | undefined;
+}, {
+    object: string;
+    url: string;
+    name: string;
+    triggers: ("api" | "update" | "create" | "delete" | "undelete")[];
+    label?: string | undefined;
+    method?: "GET" | "POST" | "PUT" | undefined;
+    secret?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    payloadFields?: string[] | undefined;
+    includeSession?: boolean | undefined;
+    retryCount?: number | undefined;
+    isActive?: boolean | undefined;
+}>;
+/**
+ * Webhook Receiver Schema (Inbound)
+ * Handling incoming HTTP hooks from Stripe, Slack, etc.
+ */
+export declare const WebhookReceiverSchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    /** Verification */
+    verificationType: z.ZodDefault<z.ZodEnum<["none", "header_token", "hmac", "ip_whitelist"]>>;
+    verificationParams: z.ZodOptional<z.ZodObject<{
+        header: z.ZodOptional<z.ZodString>;
+        secret: z.ZodOptional<z.ZodString>;
+        ips: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        secret?: string | undefined;
+        header?: string | undefined;
+        ips?: string[] | undefined;
+    }, {
+        secret?: string | undefined;
+        header?: string | undefined;
+        ips?: string[] | undefined;
+    }>>;
+    /** Action */
+    action: z.ZodDefault<z.ZodEnum<["trigger_flow", "script", "upsert_record"]>>;
+    target: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    name: string;
+    target: string;
+    action: "script" | "trigger_flow" | "upsert_record";
+    verificationType: "none" | "header_token" | "hmac" | "ip_whitelist";
+    verificationParams?: {
+        secret?: string | undefined;
+        header?: string | undefined;
+        ips?: string[] | undefined;
+    } | undefined;
+}, {
+    path: string;
+    name: string;
+    target: string;
+    action?: "script" | "trigger_flow" | "upsert_record" | undefined;
+    verificationType?: "none" | "header_token" | "hmac" | "ip_whitelist" | undefined;
+    verificationParams?: {
+        secret?: string | undefined;
+        header?: string | undefined;
+        ips?: string[] | undefined;
+    } | undefined;
+}>;
+export type Webhook = z.infer<typeof WebhookSchema>;
+export type WebhookReceiver = z.infer<typeof WebhookReceiverSchema>;
+//# sourceMappingURL=webhook.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.zod.d.ts","sourceRoot":"","sources":["../../src/system/webhook.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8DAM7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;IAIxB,YAAY;;;IAIZ,aAAa;;;IAIb,eAAe;;;IAIf,4BAA4B;;;IAI5B,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGlB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;IAIhC,mBAAmB;;;;;;;;;;;;;;;IAQnB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;EAGb,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/system/webhook.zod.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookReceiverSchema = exports.WebhookSchema = exports.WebhookTriggerType = void 0;
+const zod_1 = require("zod");
+/**
+ * Webhook Trigger Event
+ * When should this webhook fire?
+ */
+exports.WebhookTriggerType = zod_1.z.enum([
+    'create',
+    'update',
+    'delete',
+    'undelete',
+    'api' // Manually triggered
+]);
+/**
+ * Webhook Schema
+ * outbound Integration: Push data to external URL when events happen.
+ */
+exports.WebhookSchema = zod_1.z.object({
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/),
+    label: zod_1.z.string().optional(),
+    /** Scope */
+    object: zod_1.z.string().describe('Object to listen to'),
+    triggers: zod_1.z.array(exports.WebhookTriggerType).describe('Events that trigger execution'),
+    /** Target */
+    url: zod_1.z.string().url().describe('External URL payload'),
+    method: zod_1.z.enum(['POST', 'PUT', 'GET']).default('POST'),
+    /** Security */
+    secret: zod_1.z.string().optional().describe('Signing secret (HMAC)'),
+    headers: zod_1.z.record(zod_1.z.string()).optional().describe('Custom headers (Auth)'),
+    /** Payload Configuration */
+    payloadFields: zod_1.z.array(zod_1.z.string()).optional().describe('Fields to include. Empty = All'),
+    includeSession: zod_1.z.boolean().default(false).describe('Include user session info'),
+    /** Reliability */
+    retryCount: zod_1.z.number().default(3),
+    isActive: zod_1.z.boolean().default(true)
+});
+/**
+ * Webhook Receiver Schema (Inbound)
+ * Handling incoming HTTP hooks from Stripe, Slack, etc.
+ */
+exports.WebhookReceiverSchema = zod_1.z.object({
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/),
+    path: zod_1.z.string().describe('URL Path (e.g. /webhooks/stripe)'),
+    /** Verification */
+    verificationType: zod_1.z.enum(['none', 'header_token', 'hmac', 'ip_whitelist']).default('none'),
+    verificationParams: zod_1.z.object({
+        header: zod_1.z.string().optional(),
+        secret: zod_1.z.string().optional(),
+        ips: zod_1.z.array(zod_1.z.string()).optional()
+    }).optional(),
+    /** Action */
+    action: zod_1.z.enum(['trigger_flow', 'script', 'upsert_record']).default('trigger_flow'),
+    target: zod_1.z.string().describe('Flow ID or Script name'),
+});

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

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+/**
+ * Action Parameter Schema
+ * Defines inputs required before executing an action.
+ */
+export declare const ActionParamSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "number", "currency", "percent", "date", "datetime", "time", "boolean", "select", "multiselect", "lookup", "master_detail", "image", "file", "avatar", "formula", "summary", "autonumber"]>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "multiselect" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber";
+    label: string;
+    name: string;
+    required: boolean;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+}, {
+    type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "multiselect" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber";
+    label: string;
+    name: string;
+    options?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+    required?: boolean | undefined;
+}>;
+/**
+ * Action Schema
+ */
+export declare const ActionSchema: z.ZodObject<{
+    /** Machine name of the action */
+    name: z.ZodString;
+    /** Display label */
+    label: z.ZodString;
+    /** Icon name (Lucide) */
+    icon: z.ZodOptional<z.ZodString>;
+    /** Where does this action appear? */
+    locations: z.ZodOptional<z.ZodArray<z.ZodEnum<["list_toolbar", "list_item", "record_header", "record_more", "record_related", "global_nav"]>, "many">>;
+    /** Legacy location support */
+    location: z.ZodOptional<z.ZodAny>;
+    /** What type of interaction? */
+    type: z.ZodDefault<z.ZodEnum<["script", "url", "modal", "flow", "api"]>>;
+    /** Payload / Target */
+    target: z.ZodOptional<z.ZodString>;
+    execute: z.ZodOptional<z.ZodString>;
+    /** User Input Requirements */
+    params: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "number", "currency", "percent", "date", "datetime", "time", "boolean", "select", "multiselect", "lookup", "master_detail", "image", "file", "avatar", "formula", "summary", "autonumber"]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "multiselect" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber";
+        label: string;
+        name: string;
+        required: boolean;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "multiselect" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber";
+        label: string;
+        name: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+    /** UX Behavior */
+    confirmText: z.ZodOptional<z.ZodString>;
+    successMessage: z.ZodOptional<z.ZodString>;
+    refreshAfter: z.ZodDefault<z.ZodBoolean>;
+    /** Access */
+    visible: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "url" | "script" | "api" | "flow" | "modal";
+    label: string;
+    name: string;
+    refreshAfter: boolean;
+    params?: {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "multiselect" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber";
+        label: string;
+        name: string;
+        required: boolean;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    }[] | undefined;
+    icon?: string | undefined;
+    target?: string | undefined;
+    visible?: string | undefined;
+    locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
+    location?: any;
+    execute?: string | undefined;
+    confirmText?: string | undefined;
+    successMessage?: string | undefined;
+}, {
+    label: string;
+    name: string;
+    params?: {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "multiselect" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber";
+        label: string;
+        name: string;
+        options?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+    type?: "url" | "script" | "api" | "flow" | "modal" | undefined;
+    icon?: string | undefined;
+    target?: string | undefined;
+    visible?: string | undefined;
+    locations?: ("list_toolbar" | "list_item" | "record_header" | "record_more" | "record_related" | "global_nav")[] | undefined;
+    location?: any;
+    execute?: string | undefined;
+    confirmText?: string | undefined;
+    successMessage?: string | undefined;
+    refreshAfter?: boolean | undefined;
+}>;
+export type Action = z.infer<typeof ActionSchema>;
+//# sourceMappingURL=action.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.zod.d.ts","sourceRoot":"","sources":["../../src/ui/action.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,iCAAiC;;IAGjC,oBAAoB;;IAGpB,yBAAyB;;IAGzB,qCAAqC;;IAOrC,8BAA8B;;IAG9B,gCAAgC;;IAGhC,uBAAuB;;;IAIvB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG9B,kBAAkB;;;;IAKlB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEb,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/ui/action.zod.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionSchema = exports.ActionParamSchema = void 0;
+const zod_1 = require("zod");
+const field_zod_1 = require("../data/field.zod");
+/**
+ * Action Parameter Schema
+ * Defines inputs required before executing an action.
+ */
+exports.ActionParamSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    label: zod_1.z.string(),
+    type: field_zod_1.FieldType,
+    required: zod_1.z.boolean().default(false),
+    options: zod_1.z.array(zod_1.z.object({ label: zod_1.z.string(), value: zod_1.z.string() })).optional(),
+});
+/**
+ * Action Schema
+ */
+exports.ActionSchema = zod_1.z.object({
+    /** Machine name of the action */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Machine name (snake_case)'),
+    /** Display label */
+    label: zod_1.z.string().describe('Display label'),
+    /** Icon name (Lucide) */
+    icon: zod_1.z.string().optional().describe('Icon name'),
+    /** Where does this action appear? */
+    locations: zod_1.z.array(zod_1.z.enum([
+        'list_toolbar', 'list_item',
+        'record_header', 'record_more', 'record_related',
+        'global_nav'
+    ])).optional().describe('Locations where this action is visible'),
+    /** Legacy location support */
+    location: zod_1.z.any().optional(),
+    /** What type of interaction? */
+    type: zod_1.z.enum(['script', 'url', 'modal', 'flow', 'api']).default('script').describe('Action functionality type'),
+    /** Payload / Target */
+    target: zod_1.z.string().optional().describe('URL, Script Name, Flow ID, or API Endpoint'), // For URL/Flow types
+    execute: zod_1.z.string().optional().describe('Legacy execution logic'),
+    /** User Input Requirements */
+    params: zod_1.z.array(exports.ActionParamSchema).optional().describe('Input parameters required from user'),
+    /** UX Behavior */
+    confirmText: zod_1.z.string().optional().describe('Confirmation message before execution'),
+    successMessage: zod_1.z.string().optional().describe('Success message to show after execution'),
+    refreshAfter: zod_1.z.boolean().default(false).describe('Refresh view after execution'),
+    /** Access */
+    visible: zod_1.z.string().optional().describe('Formula returning boolean'),
+});