@objectstack/spec 0.1.0 → 0.1.2

package/dist/system/territory.zod.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerritorySchema = exports.TerritoryModelSchema = exports.TerritoryType = void 0;
+const zod_1 = require("zod");
+/**
+ * Territory Management Protocol
+ * Defines a matrix reporting structure that exists parallel to the Role Hierarchy.
+ *
+ * USE CASE:
+ * - Enterprise Sales Teams (Geo-based: "EMEA", "APAC")
+ * - Industry Verticals (Industry-based: "Healthcare", "Financial")
+ * - Strategic Accounts (Account-based: "Strategic Accounts")
+ *
+ * DIFFERENCE FROM ROLE:
+ * - Role: Hierarchy of PEOPLE (Who reports to whom). Stable. HR-driven.
+ * - Territory: Hierarchy of ACCOUNTS/REVENUE (Who owns which market). Flexible. Sales-driven.
+ * - One User can be assigned to MANY Territories (Matrix).
+ * - One User has only ONE Role (Tree).
+ */
+exports.TerritoryType = zod_1.z.enum([
+    'geography', // Region/Country/City
+    'industry', // Vertical
+    'named_account', // Key Accounts
+    'product_line' // Product Specialty
+]);
+/**
+ * Territory Model Schema
+ * A container for a version of territory planning.
+ * (e.g. "Fiscal Year 2024 Planning" vs "Fiscal Year 2025 Planning")
+ */
+exports.TerritoryModelSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Model Name (e.g. FY24 Planning)'),
+    state: zod_1.z.enum(['planning', 'active', 'archived']).default('planning'),
+    startDate: zod_1.z.string().optional(),
+    endDate: zod_1.z.string().optional(),
+});
+/**
+ * Territory Node Schema
+ * A single node in the territory tree.
+ */
+exports.TerritorySchema = zod_1.z.object({
+    /** Identity */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/),
+    label: zod_1.z.string().describe('Territory Label (e.g. "West Coast")'),
+    /** Structure */
+    modelId: zod_1.z.string().describe('Belongs to which Territory Model'),
+    parent: zod_1.z.string().optional().describe('Parent Territory'),
+    type: exports.TerritoryType.default('geography'),
+    /**
+     * Assignment Rules (The "Magic")
+     * How do accounts automatically fall into this territory?
+     * e.g. "BillingCountry = 'US' AND BillingState = 'CA'"
+     */
+    assignmentRule: zod_1.z.string().optional().describe('Criteria based assignment rule'),
+    /**
+     * User Assignment
+     * Users assigned to work this territory.
+     */
+    assignedUsers: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Access Level */
+    accountAccess: zod_1.z.enum(['read', 'edit']).default('read'),
+    opportunityAccess: zod_1.z.enum(['read', 'edit']).default('read'),
+    caseAccess: zod_1.z.enum(['read', 'edit']).default('read'),
+});

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

@@ -0,0 +1,171 @@
+import { z } from 'zod';
+/**
+ * Translation Schema
+ * Supports i18n for labels, messages, and options.
+ * Example structure:
+ * {
+ *   "en": { "objects": { "account": { "label": "Account" } } },
+ *   "zh-CN": { "objects": { "account": { "label": "客户" } } }
+ * }
+ */
+export declare const TranslationDataSchema: z.ZodObject<{
+    /** Object translations */
+    objects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        label: z.ZodString;
+        pluralLabel: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            help: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }>>>;
+    /** App/Menu translations */
+    apps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description?: string | undefined;
+    }, {
+        label: string;
+        description?: string | undefined;
+    }>>>;
+    /** UI Messages */
+    messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    objects?: Record<string, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }> | undefined;
+    apps?: Record<string, {
+        label: string;
+        description?: string | undefined;
+    }> | undefined;
+    messages?: Record<string, string> | undefined;
+}, {
+    objects?: Record<string, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }> | undefined;
+    apps?: Record<string, {
+        label: string;
+        description?: string | undefined;
+    }> | undefined;
+    messages?: Record<string, string> | undefined;
+}>;
+export declare const LocaleSchema: z.ZodString;
+export declare const TranslationBundleSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    /** Object translations */
+    objects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        label: z.ZodString;
+        pluralLabel: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            help: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }>>>;
+    /** App/Menu translations */
+    apps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description?: string | undefined;
+    }, {
+        label: string;
+        description?: string | undefined;
+    }>>>;
+    /** UI Messages */
+    messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    objects?: Record<string, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }> | undefined;
+    apps?: Record<string, {
+        label: string;
+        description?: string | undefined;
+    }> | undefined;
+    messages?: Record<string, string> | undefined;
+}, {
+    objects?: Record<string, {
+        label: string;
+        fields?: Record<string, {
+            options?: Record<string, string> | undefined;
+            label?: string | undefined;
+            help?: string | undefined;
+        }> | undefined;
+        pluralLabel?: string | undefined;
+    }> | undefined;
+    apps?: Record<string, {
+        label: string;
+        description?: string | undefined;
+    }> | undefined;
+    messages?: Record<string, string> | undefined;
+}>>;
+export type TranslationBundle = z.infer<typeof TranslationBundleSchema>;
+//# sourceMappingURL=translation.zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translation.zod.d.ts","sourceRoot":"","sources":["../../src/system/translation.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;IAChC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAW1B,4BAA4B;;;;;;;;;;;IAM5B,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElB,CAAC;AAEH,eAAO,MAAM,YAAY,aAAiE,CAAC;AAE3F,eAAO,MAAM,uBAAuB;IAvBlC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAW1B,4BAA4B;;;;;;;;;;;IAM5B,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAMgE,CAAC;AAErF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

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: ("create" | "update" | "delete" | "api" | "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: ("create" | "update" | "delete" | "api" | "undelete")[];
+    label?: string | undefined;
+    secret?: string | undefined;
+    method?: "GET" | "POST" | "PUT" | 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'),
+});