@objectstack/spec 0.3.1 → 0.3.3

package/prompts/implement-objectui.md

@@ -0,0 +1,46 @@
+# ObjectUI Implementation Agent
+
+**Role:** You are the Lead Frontend Engineer building the `objectui` presentation layer.
+**Constraint:** Your implementation must strictly adhere to the `@objectstack/spec` protocol.
+
+## 1. Setup
+
+You are working in a repository that depends on `@objectstack/spec`.
+Your source of truth is `node_modules/@objectstack/spec`.
+
+## 2. Implementation Rules
+
+### Rule #1: Server-Driven UI (SDUI)
+Do not hardcode page layouts. The UI must render dynamically based on `PageSchema` and `ViewSchema` fetched from the metadata API.
+```typescript
+import { PageSchema, ViewSchema } from '@objectstack/spec/ui';
+// Fetch JSON -> Validate -> Render
+const pageLayout = PageSchema.parse(apiResponse);
+```
+
+### Rule #2: Metadata-Aware Components
+Components (Grid, Form, Kanban) must accept `ViewSchema` as props.
+- A `Grid` component takes a `ListView` definition (columns, sort, filter) and renders it.
+- A `Form` component takes an `ObjectSchema` and `FormView` definition to render fields.
+
+### Rule #3: Action Abstraction
+Buttons do not run arbitrary code. They execute `ActionSchema` definitions.
+- `type: 'api'`: Call an endpoint.
+- `type: 'flow'`: Trigger a server-side flow.
+- `type: 'navigate'`: Change the URL.
+
+### Rule #4: Global Theming
+Styles must be derived from `ThemeSchema` (tokens), not hardcoded CSS values.
+
+## 3. Workflow
+
+1.  **App Shell**: Implement the navigation frame using `AppSchema` (menus, branding).
+2.  **Page Router**: specific routes `/app/:object/:view` should load the corresponding `ViewSchema`.
+3.  **View Renderer**: Create a factory that maps `view.type` ('grid', 'kanban') to React/Vue components.
+
+## 4. Key Files to Watch
+
+- `ui/app.zod.ts`: The Navigation structure.
+- `ui/view.zod.ts`: The data visualization config.
+- `ui/action.zod.ts`: The interaction logic.
+- `ui/page.zod.ts`: The layout container.

package/prompts/instructions.md

@@ -0,0 +1,91 @@
+# 📜 ObjectStack Protocol & Metamodel Architect
+
+**Role:** You are the **Chief Protocol Architect** for ObjectStack.
+**Context:** You are defining the "DNA" and "Constitution" of a metadata-driven low-code platform.
+**Location:** `packages/spec` repository.
+
+Mission: Build the "Post-SaaS Operating System" — an open-core, local-first ecosystem that virtualizes data (SQL/Redis/Excel) and unifies business logic.
+
+**PRIME DIRECTIVES:**
+
+1. **Zod First:** ALL definitions must start with a **Zod Schema**. We need runtime validation for the CLI and JSON Schema generation for the IDE.
+2. **Type Derivation:** TypeScript interfaces must be inferred from Zod (`z.infer<typeof X>`).
+3. **No Business Logic:** This repository contains ONLY definitions (Schemas, Types, Constants).
+4. **Naming Convention:**
+    *   **Configuration Keys (TS Props):** `camelCase` (e.g., `maxLength`, `referenceFilters`).
+    *   **Machine Names (Data Values):** `snake_case` (e.g., `name: 'first_name'`, `object: 'project_task'`).
+5. **Best Practice Mandate:**
+    *   **Ignore Status Quo:** Do not let current implementation limitations constrain the design.
+    *   **Benchmark:** Align with industry leaders (Salesforce, ServiceNow, Kubernetes) for structural decisions.
+    *   **Philosophy:** "Data as Code", Idempotency, and Immutable Infrastructure are the defaults.
+    *   **Style:** Enforce `camelCase` for all schema property keys (e.g. `maxLength`, `referenceFilters` NOT `max_length`, `reference_filters`).
+
+---
+
+## 📘 1. The Metamodel Standards (Knowledge Base)
+
+### **A. DATA PROTOCOL (`src/data/*.zod.ts`)**
+*Core Business Logic & Data Model*
+
+*   **Field (`src/data/field.zod.ts`)**:
+    *   **Type Enum**: `text`, `textarea`, `number`, `boolean`, `select`, `lookup`, `formula`, ...
+    *   **Props**: `name` (snake_case), `label`, `type`, `multiple` (Array support), `reference` (Target Object).
+*   **Object (`src/data/object.zod.ts`)**:
+    *   **Props**: `name` (snake_case), `label`, `fields` (Map), `enable` (Capabilities: `trackHistory`, `apiEnabled`).
+*   **Flow (`src/data/flow.zod.ts`)**: Visual Logic Orchestration (`autolaunched`, `screen`, `schedule`).
+*   **Logic**: `validation.zod.ts` (Rules), `permission.zod.ts` (ACL), `workflow.zod.ts` (State Machine).
+
+### **B. UI PROTOCOL (`src/ui/*.zod.ts`)**
+*Presentation & Interaction*
+
+*   **View (`src/ui/view.zod.ts`)**:
+    *   **ListView**: `grid`, `kanban`, `calendar`, `gantt`.
+    *   **FormView**: `simple`, `tabbed`, `wizard`.
+*   **App (`src/ui/app.zod.ts`)**:
+    *   **Navigation**: Structured Menu Tree (`ObjectNavItem`, `DashboardNavItem`).
+    *   **Branding**: Logo, Colors.
+*   **Dashboard (`src/ui/dashboard.zod.ts`)**: Grid layout widgets.
+*   **Report (`src/ui/report.zod.ts`)**: Analytics (`tabular`, `summary`, `matrix`, `chart`).
+*   **Action (`src/ui/action.zod.ts`)**: Buttons, URL jumps, Screen Flows.
+
+### **C. SYSTEM PROTOCOL (`src/system/*.zod.ts`)**
+*Runtime Configuration*
+
+*   **Manifest (`src/system/manifest.zod.ts`)**: Package definition (`objectstack.config.ts`).
+*   **Datasource (`src/system/datasource.zod.ts`)**: External Data Connections (SQL, NoSQL, SaaS).
+*   **API (`src/system/api.zod.ts`)**: REST/GraphQL Endpoint Definitions.
+*   **Translation (`src/system/translation.zod.ts`)**: Internationalization (i18n).
+
+---
+
+## 🛠️ 2. Coding Patterns
+
+### **Naming Convention Example**
+
+```typescript
+export const FieldSchema = z.object({
+  // CONFIGURATION KEY -> camelCase
+  maxLength: z.number().optional(),
+  defaultValue: z.any().optional(),
+
+  // SYSTEM IENTIFIER RULES -> snake_case
+  name: z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Machine name (snake_case)'),
+});
+```
+
+### **Directory Structure**
+
+*   `packages/spec/src/data/`: ObjectQL (Object, Query, Driver).
+*   `packages/spec/src/ai/`: ObjectQL (Agent, RAG, Orchestration).
+*   `packages/spec/src/ui/`: ObjectUI (App, View, Action).
+*   `packages/spec/src/system/`: ObjectOS (Manifest, Identity, Events).
+*   `packages/spec/src/api/`: ObjectOS (Contract, Endpoint, Realtime).
+
+---
+
+## 🤖 3. Interaction Shortcuts
+
+*   **"Create Field Protocol"** → Implement `src/data/field.zod.ts`.
+*   **"Create Object Protocol"** → Implement `src/data/object.zod.ts`.
+*   **"Create UI Protocol"** → Implement `src/ui/view.zod.ts`.
+*   **"Create App Protocol"** → Implement `src/ui/app.zod.ts`.

package/dist/ai/workflow-automation.zod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-automation.zod.d.ts","sourceRoot":"","sources":["../../src/ai/workflow-automation.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,6GAQlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+JAW3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,oBAAoB;;;;IAKpB,0BAA0B;;;IAI1B,0BAA0B;;;IAI1B,2BAA2B;;;IAI3B,sCAAsC;;;IAItC,kCAAkC;;IAGlC,kCAAkC;;;IAIlC,qBAAqB;;;IAIrB,4BAA4B;;IAG5B,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAIvC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAQjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IACrC,eAAe;;;;IAKf,oBAAoB;;IAGpB,4BAA4B;;IAG5B,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQrC,qBAAqB;;IAGrB,eAAe;;QAtGf,oBAAoB;;;;QAKpB,0BAA0B;;;QAI1B,0BAA0B;;;QAI1B,2BAA2B;;;QAI3B,sCAAsC;;;QAItC,kCAAkC;;QAGlC,kCAAkC;;;QAIlC,qBAAqB;;;QAIrB,4BAA4B;;QAG5B,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEpB,sBAAsB;;;;;;;;;;;;;;;;;IAGtB,wBAAwB;;;IAIxB,2BAA2B;;;IAI3B,2BAA2B;;;;IAK3B,aAAa;;;IAIb,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMf,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;EAMzC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1C,CAAC;AAGH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/data/flow.zod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow.zod.d.ts","sourceRoot":"","sources":["../../src/data/flow.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc,6KAczB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,oDAAoD;;IAGpD,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;IAKzB,+DAA+D;;;;;;;;;;;;;;;EAI/D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB,eAAe;;;;IAKf,mBAAmB;;IAGnB,8BAA8B;;;;;;;;;;;;;;;;;IAG9B,uBAAuB;;;;;QAtCvB,oDAAoD;;QAGpD,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAanC,+DAA+D;;;;;;;;;;;;;;;;IA0B/D,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGvB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/data/permission.zod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"permission.zod.d.ts","sourceRoot":"","sources":["../../src/data/permission.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IACjC,gBAAgB;;IAEhB,gDAAgD;;IAEhD,gDAAgD;;IAEhD,kDAAkD;;IAGlD;;;;OAIG;;IAGH;;;;OAIG;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,yBAAyB;;IAEzB,0BAA0B;;;;;;;;EAE1B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;IAC9B,iCAAiC;;IAGjC,oBAAoB;;IAGpB,+CAA+C;;IAG/C,2DAA2D;;QArD3D,gBAAgB;;QAEhB,gDAAgD;;QAEhD,gDAAgD;;QAEhD,kDAAkD;;QAGlD;;;;WAIG;;QAGH;;;;WAIG;;;;;;;;;;;;;;;;;IAoCH,uEAAuE;;QA5BvE,yBAAyB;;QAEzB,0BAA0B;;;;;;;;;IA6B1B,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhD,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/data/sharing.zod.d.ts

@@ -1,63 +0,0 @@
-import { z } from 'zod';
-/**
- * Sharing Rule Type
- * How is the data shared?
- */
-export declare const SharingRuleType: z.ZodEnum<["owner", "criteria", "manual", "guest"]>;
-/**
- * Sharing Level
- * What access is granted?
- */
-export declare const SharingLevel: z.ZodEnum<["read", "edit"]>;
-/**
- * Sharing Rule Schema
- * Defines AUTOMATIC access grants based on logic.
- * The core engine of the governance layer.
- */
-export declare const SharingRuleSchema: z.ZodObject<{
-    name: z.ZodString;
-    label: z.ZodOptional<z.ZodString>;
-    active: z.ZodDefault<z.ZodBoolean>;
-    /** Target Object */
-    object: z.ZodString;
-    /** Grant Logic */
-    type: z.ZodDefault<z.ZodEnum<["owner", "criteria", "manual", "guest"]>>;
-    /**
-     * Criteria (for type='criteria')
-     * SQL-like condition: "department = 'Sales' AND amount > 10000"
-     */
-    criteria: z.ZodOptional<z.ZodString>;
-    /** Access Level */
-    accessLevel: z.ZodDefault<z.ZodEnum<["read", "edit"]>>;
-    /**
-     * Target Audience (Whom to share with)
-     * ID of a Group, Role, or User.
-     */
-    sharedWith: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    object: string;
-    type: "owner" | "criteria" | "manual" | "guest";
-    name: string;
-    active: boolean;
-    accessLevel: "read" | "edit";
-    sharedWith: string;
-    label?: string | undefined;
-    criteria?: string | undefined;
-}, {
-    object: string;
-    name: string;
-    sharedWith: string;
-    type?: "owner" | "criteria" | "manual" | "guest" | undefined;
-    label?: string | undefined;
-    active?: boolean | undefined;
-    criteria?: string | undefined;
-    accessLevel?: "read" | "edit" | undefined;
-}>;
-/**
- * Organization-Wide Defaults (OWD)
- * The baseline security posture for an object.
- */
-export declare const OWDModel: z.ZodEnum<["private", "public_read", "public_read_write"]>;
-export type SharingRule = z.infer<typeof SharingRuleSchema>;
-export type SharingRuleType = z.infer<typeof SharingRuleType>;
-//# sourceMappingURL=sharing.zod.d.ts.map

package/dist/data/sharing.zod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sharing.zod.d.ts","sourceRoot":"","sources":["../../src/data/sharing.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,eAAe,qDAK1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,6BAGvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;IAK5B,oBAAoB;;IAGpB,kBAAkB;;IAGlB;;;OAGG;;IAGH,mBAAmB;;IAGnB;;;OAGG;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ,4DAInB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/data/sharing.zod.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OWDModel = exports.SharingRuleSchema = exports.SharingLevel = exports.SharingRuleType = void 0;
-const zod_1 = require("zod");
-/**
- * Sharing Rule Type
- * How is the data shared?
- */
-exports.SharingRuleType = zod_1.z.enum([
-    'owner', // Based on record ownership (Role Hierarchy)
-    'criteria', // Based on field values (e.g. Status = 'Open')
-    'manual', // Ad-hoc sharing (User specific)
-    'guest' // Public access
-]);
-/**
- * Sharing Level
- * What access is granted?
- */
-exports.SharingLevel = zod_1.z.enum([
-    'read', // Read Only
-    'edit' // Read / Write
-]);
-/**
- * Sharing Rule Schema
- * Defines AUTOMATIC access grants based on logic.
- * The core engine of the governance layer.
- */
-exports.SharingRuleSchema = zod_1.z.object({
-    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Unique rule name'),
-    label: zod_1.z.string().optional(),
-    active: zod_1.z.boolean().default(true),
-    /** Target Object */
-    object: zod_1.z.string().describe('Object to share'),
-    /** Grant Logic */
-    type: exports.SharingRuleType.default('criteria'),
-    /**
-     * Criteria (for type='criteria')
-     * SQL-like condition: "department = 'Sales' AND amount > 10000"
-     */
-    criteria: zod_1.z.string().optional(),
-    /** Access Level */
-    accessLevel: exports.SharingLevel.default('read'),
-    /**
-     * Target Audience (Whom to share with)
-     * ID of a Group, Role, or User.
-     */
-    sharedWith: zod_1.z.string().describe('Group/Role ID to share records with'),
-});
-/**
- * Organization-Wide Defaults (OWD)
- * The baseline security posture for an object.
- */
-exports.OWDModel = zod_1.z.enum([
-    'private', // Only owner can see
-    'public_read', // Everyone can see, owner can edit
-    'public_read_write' // Everyone can see and edit
-]);

package/dist/data/trigger.zod.d.ts

@@ -1,354 +0,0 @@
-import { z } from 'zod';
-/**
- * Trigger Action Enum
- *
- * Defines the database operation that triggered the execution.
- */
-export declare const TriggerAction: z.ZodEnum<["insert", "update", "delete"]>;
-/**
- * Trigger Timing Enum
- *
- * Defines when the trigger executes relative to the database operation.
- */
-export declare const TriggerTiming: z.ZodEnum<["before", "after"]>;
-/**
- * Trigger Context Schema
- *
- * This defines the runtime context available to trigger code during execution.
- * Standardizes how trigger code is written and enables AI code generation.
- *
- * Triggers are business logic hooks that execute before or after database operations.
- * They can validate data, set defaults, update related records, or prevent operations.
- *
- * @example Before Insert Trigger
- * export default {
- *   timing: 'before',
- *   action: 'insert',
- *   execute: async (context: TriggerContext) => {
- *     // Set default values
- *     if (!context.doc.status) {
- *       context.doc.status = 'active';
- *     }
- *
- *     // Validation
- *     if (!context.doc.email) {
- *       context.addError('Email is required');
- *     }
- *   }
- * };
- *
- * @example After Update Trigger
- * export default {
- *   timing: 'after',
- *   action: 'update',
- *   execute: async (context: TriggerContext) => {
- *     // Update related records
- *     if (context.getOldValue('status') !== context.doc.status) {
- *       await context.ql.object('activity_log').create({
- *         record_id: context.doc.id,
- *         message: `Status changed from ${context.getOldValue('status')} to ${context.doc.status}`,
- *         user_id: context.userId,
- *       });
- *     }
- *   }
- * };
- */
-export declare const TriggerContextSchema: z.ZodObject<{
-    /**
-     * The database operation that triggered execution.
-     * One of: 'insert', 'update', 'delete'
-     */
-    action: z.ZodEnum<["insert", "update", "delete"]>;
-    /**
-     * When the trigger executes relative to the operation.
-     * - 'before': Execute before database operation (can modify doc, prevent operation)
-     * - 'after': Execute after database operation (can trigger side effects)
-     */
-    timing: z.ZodEnum<["before", "after"]>;
-    /**
-     * The current document/record being operated on.
-     *
-     * For 'before' triggers: Can be modified to change what gets saved.
-     * For 'after' triggers: Contains the final saved state (read-only).
-     * For 'delete' triggers: Contains the record being deleted.
-     */
-    doc: z.ZodRecord<z.ZodString, z.ZodAny>;
-    /**
-     * The document state before the current operation.
-     *
-     * Only available for 'update' and 'delete' operations.
-     * Null for 'insert' operations.
-     *
-     * Use this to detect what changed in an update trigger.
-     */
-    previousDoc: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    /**
-     * ID of the user performing the operation.
-     */
-    userId: z.ZodString;
-    /**
-     * Complete user record of the user performing the operation.
-     * Contains fields like name, email, roles, etc.
-     */
-    user: z.ZodRecord<z.ZodString, z.ZodAny>;
-    /**
-     * ObjectQL data access API.
-     * Use this to query or modify other records.
-     *
-     * @example
-     * await context.ql.object('account').findOne(context.doc.account_id);
-     * await context.ql.object('activity').create({ ... });
-     */
-    ql: z.ZodAny;
-    /**
-     * Logging interface.
-     * Use this for debugging and auditing.
-     *
-     * @example
-     * context.logger.info('Trigger executed', { recordId: context.doc.id });
-     * context.logger.error('Validation failed', { error });
-     */
-    logger: z.ZodAny;
-    /**
-     * Add a validation error.
-     * For 'before' triggers only - prevents the operation from completing.
-     *
-     * @param message - Error message to display
-     * @param field - Optional field name the error relates to
-     *
-     * @example
-     * if (context.doc.amount < 0) {
-     *   context.addError('Amount must be positive', 'amount');
-     * }
-     */
-    addError: z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodOptional<z.ZodString>], z.ZodUnknown>, z.ZodVoid>;
-    /**
-     * Get the old value of a field.
-     * Helper function for 'update' triggers to easily compare old vs new values.
-     *
-     * @param fieldName - Name of the field
-     * @returns Previous value of the field, or undefined if not available
-     *
-     * @example
-     * if (context.getOldValue('status') !== context.doc.status) {
-     *   // Status changed
-     * }
-     */
-    getOldValue: z.ZodFunction<z.ZodTuple<[z.ZodString], z.ZodUnknown>, z.ZodAny>;
-}, "strip", z.ZodTypeAny, {
-    user: Record<string, any>;
-    action: "update" | "delete" | "insert";
-    timing: "before" | "after";
-    doc: Record<string, any>;
-    userId: string;
-    addError: (args_0: string, args_1: string | undefined, ...args: unknown[]) => void;
-    getOldValue: (args_0: string, ...args: unknown[]) => any;
-    previousDoc?: Record<string, any> | undefined;
-    ql?: any;
-    logger?: any;
-}, {
-    user: Record<string, any>;
-    action: "update" | "delete" | "insert";
-    timing: "before" | "after";
-    doc: Record<string, any>;
-    userId: string;
-    addError: (args_0: string, args_1: string | undefined, ...args: unknown[]) => void;
-    getOldValue: (args_0: string, ...args: unknown[]) => any;
-    previousDoc?: Record<string, any> | undefined;
-    ql?: any;
-    logger?: any;
-}>;
-/**
- * Trigger Definition Schema
- *
- * Complete definition of a trigger including metadata and execution function.
- */
-export declare const TriggerSchema: z.ZodObject<{
-    /**
-     * Unique trigger name.
-     */
-    name: z.ZodString;
-    /**
-     * Object this trigger is attached to.
-     */
-    object: z.ZodString;
-    /**
-     * Trigger timing.
-     */
-    timing: z.ZodEnum<["before", "after"]>;
-    /**
-     * Trigger action(s).
-     * Can be a single action or array of actions.
-     */
-    action: z.ZodUnion<[z.ZodEnum<["insert", "update", "delete"]>, z.ZodArray<z.ZodEnum<["insert", "update", "delete"]>, "many">]>;
-    /**
-     * Trigger execution function.
-     * Receives TriggerContext and performs the business logic.
-     */
-    execute: z.ZodFunction<z.ZodTuple<[z.ZodObject<{
-        /**
-         * The database operation that triggered execution.
-         * One of: 'insert', 'update', 'delete'
-         */
-        action: z.ZodEnum<["insert", "update", "delete"]>;
-        /**
-         * When the trigger executes relative to the operation.
-         * - 'before': Execute before database operation (can modify doc, prevent operation)
-         * - 'after': Execute after database operation (can trigger side effects)
-         */
-        timing: z.ZodEnum<["before", "after"]>;
-        /**
-         * The current document/record being operated on.
-         *
-         * For 'before' triggers: Can be modified to change what gets saved.
-         * For 'after' triggers: Contains the final saved state (read-only).
-         * For 'delete' triggers: Contains the record being deleted.
-         */
-        doc: z.ZodRecord<z.ZodString, z.ZodAny>;
-        /**
-         * The document state before the current operation.
-         *
-         * Only available for 'update' and 'delete' operations.
-         * Null for 'insert' operations.
-         *
-         * Use this to detect what changed in an update trigger.
-         */
-        previousDoc: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        /**
-         * ID of the user performing the operation.
-         */
-        userId: z.ZodString;
-        /**
-         * Complete user record of the user performing the operation.
-         * Contains fields like name, email, roles, etc.
-         */
-        user: z.ZodRecord<z.ZodString, z.ZodAny>;
-        /**
-         * ObjectQL data access API.
-         * Use this to query or modify other records.
-         *
-         * @example
-         * await context.ql.object('account').findOne(context.doc.account_id);
-         * await context.ql.object('activity').create({ ... });
-         */
-        ql: z.ZodAny;
-        /**
-         * Logging interface.
-         * Use this for debugging and auditing.
-         *
-         * @example
-         * context.logger.info('Trigger executed', { recordId: context.doc.id });
-         * context.logger.error('Validation failed', { error });
-         */
-        logger: z.ZodAny;
-        /**
-         * Add a validation error.
-         * For 'before' triggers only - prevents the operation from completing.
-         *
-         * @param message - Error message to display
-         * @param field - Optional field name the error relates to
-         *
-         * @example
-         * if (context.doc.amount < 0) {
-         *   context.addError('Amount must be positive', 'amount');
-         * }
-         */
-        addError: z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodOptional<z.ZodString>], z.ZodUnknown>, z.ZodVoid>;
-        /**
-         * Get the old value of a field.
-         * Helper function for 'update' triggers to easily compare old vs new values.
-         *
-         * @param fieldName - Name of the field
-         * @returns Previous value of the field, or undefined if not available
-         *
-         * @example
-         * if (context.getOldValue('status') !== context.doc.status) {
-         *   // Status changed
-         * }
-         */
-        getOldValue: z.ZodFunction<z.ZodTuple<[z.ZodString], z.ZodUnknown>, z.ZodAny>;
-    }, "strip", z.ZodTypeAny, {
-        user: Record<string, any>;
-        action: "update" | "delete" | "insert";
-        timing: "before" | "after";
-        doc: Record<string, any>;
-        userId: string;
-        addError: (args_0: string, args_1: string | undefined, ...args: unknown[]) => void;
-        getOldValue: (args_0: string, ...args: unknown[]) => any;
-        previousDoc?: Record<string, any> | undefined;
-        ql?: any;
-        logger?: any;
-    }, {
-        user: Record<string, any>;
-        action: "update" | "delete" | "insert";
-        timing: "before" | "after";
-        doc: Record<string, any>;
-        userId: string;
-        addError: (args_0: string, args_1: string | undefined, ...args: unknown[]) => void;
-        getOldValue: (args_0: string, ...args: unknown[]) => any;
-        previousDoc?: Record<string, any> | undefined;
-        ql?: any;
-        logger?: any;
-    }>], z.ZodUnknown>, z.ZodPromise<z.ZodVoid>>;
-    /**
-     * Optional description of what the trigger does.
-     */
-    description: z.ZodOptional<z.ZodString>;
-    /**
-     * Whether the trigger is active.
-     */
-    active: z.ZodDefault<z.ZodBoolean>;
-    /**
-     * Execution order when multiple triggers are defined.
-     * Lower numbers execute first.
-     */
-    order: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    object: string;
-    name: string;
-    active: boolean;
-    order: number;
-    action: "update" | "delete" | "insert" | ("update" | "delete" | "insert")[];
-    timing: "before" | "after";
-    execute: (args_0: {
-        user: Record<string, any>;
-        action: "update" | "delete" | "insert";
-        timing: "before" | "after";
-        doc: Record<string, any>;
-        userId: string;
-        addError: (args_0: string, args_1: string | undefined, ...args: unknown[]) => void;
-        getOldValue: (args_0: string, ...args: unknown[]) => any;
-        previousDoc?: Record<string, any> | undefined;
-        ql?: any;
-        logger?: any;
-    }, ...args: unknown[]) => Promise<void>;
-    description?: string | undefined;
-}, {
-    object: string;
-    name: string;
-    action: "update" | "delete" | "insert" | ("update" | "delete" | "insert")[];
-    timing: "before" | "after";
-    execute: (args_0: {
-        user: Record<string, any>;
-        action: "update" | "delete" | "insert";
-        timing: "before" | "after";
-        doc: Record<string, any>;
-        userId: string;
-        addError: (args_0: string, args_1: string | undefined, ...args: unknown[]) => void;
-        getOldValue: (args_0: string, ...args: unknown[]) => any;
-        previousDoc?: Record<string, any> | undefined;
-        ql?: any;
-        logger?: any;
-    }, ...args: unknown[]) => Promise<void>;
-    description?: string | undefined;
-    active?: boolean | undefined;
-    order?: number | undefined;
-}>;
-/**
- * TypeScript types
- */
-export type TriggerAction = z.infer<typeof TriggerAction>;
-export type TriggerTiming = z.infer<typeof TriggerTiming>;
-export type TriggerContext = z.infer<typeof TriggerContextSchema>;
-export type Trigger = z.infer<typeof TriggerSchema>;
-//# sourceMappingURL=trigger.zod.d.ts.map

package/dist/data/trigger.zod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trigger.zod.d.ts","sourceRoot":"","sources":["../../src/data/trigger.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,aAAa,2CAAyC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,aAAa,gCAA8B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;OAOG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;;;;OAWG;;IAMH;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;;;;;;;;;EAKH,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAMH;;;OAGG;;QAnIH;;;WAGG;;QAGH;;;;WAIG;;QAGH;;;;;;WAMG;;QAGH;;;;;;;WAOG;;QAGH;;WAEG;;QAGH;;;WAGG;;QAGH;;;;;;;WAOG;;QAGH;;;;;;;WAOG;;QAGH;;;;;;;;;;;WAWG;;QAMH;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;;;;;;IA8CH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}