@objectstack/spec 0.2.0 → 0.3.0

package/dist/data/validation.zod.js

@@ -2,8 +2,54 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConditionalValidationSchema = exports.ValidationRuleSchema = exports.CustomValidatorSchema = exports.AsyncValidationSchema = exports.CrossFieldValidationSchema = exports.FormatValidationSchema = exports.StateMachineValidationSchema = exports.UniquenessValidationSchema = exports.ScriptValidationSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * # ObjectStack Validation Protocol
+ *
+ * This module defines the validation schema protocol for ObjectStack, providing a comprehensive
+ * type-safe validation system similar to Salesforce's validation rules but with enhanced capabilities.
+ *
+ * ## Overview
+ *
+ * Validation rules are applied at the data layer to ensure data integrity and enforce business logic.
+ * The system supports multiple validation types:
+ *
+ * 1. **Script Validation**: Formula-based validation using expressions
+ * 2. **Uniqueness Validation**: Enforce unique constraints across fields
+ * 3. **State Machine Validation**: Control allowed state transitions
+ * 4. **Format Validation**: Validate field formats (email, URL, regex, etc.)
+ * 5. **Cross-Field Validation**: Validate relationships between multiple fields
+ * 6. **Async Validation**: Remote validation via API calls
+ * 7. **Custom Validation**: User-defined validation functions
+ * 8. **Conditional Validation**: Apply validations based on conditions
+ *
+ * ## Salesforce Comparison
+ *
+ * ObjectStack validation rules are inspired by Salesforce validation rules but enhanced:
+ * - Salesforce: Formula-based validation with `Error Condition Formula`
+ * - ObjectStack: Multiple validation types with composable rules
+ *
+ * Example Salesforce validation rule:
+ * ```
+ * Rule Name: Discount_Cannot_Exceed_40_Percent
+ * Error Condition Formula: Discount_Percent__c > 0.40
+ * Error Message: Discount cannot exceed 40%.
+ * ```
+ *
+ * Equivalent ObjectStack rule:
+ * ```typescript
+ * {
+ *   type: 'script',
+ *   name: 'discount_cannot_exceed_40_percent',
+ *   condition: 'discount_percent > 0.40',
+ *   message: 'Discount cannot exceed 40%',
+ *   severity: 'error'
+ * }
+ * ```
+ */
 /**
  * Base Validation Rule
+ *
+ * All validation rules extend from this base schema with common properties.
  */
 const BaseValidationSchema = zod_1.z.object({
     name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Unique rule name'),
@@ -51,6 +97,65 @@ exports.FormatValidationSchema = BaseValidationSchema.extend({
 /**
  * 5. Cross-Field Validation
  * Validates relationships between multiple fields.
+ *
+ * ## Use Cases
+ * - Date range validations (end_date > start_date)
+ * - Amount comparisons (discount < total)
+ * - Complex business rules involving multiple fields
+ *
+ * ## Salesforce Examples
+ *
+ * ### Example 1: Close Date Must Be In Current or Future Month
+ * **Salesforce Formula:**
+ * ```
+ * MONTH(CloseDate) < MONTH(TODAY()) ||
+ * YEAR(CloseDate) < YEAR(TODAY())
+ * ```
+ *
+ * **ObjectStack Equivalent:**
+ * ```typescript
+ * {
+ *   type: 'cross_field',
+ *   name: 'close_date_future',
+ *   condition: 'MONTH(close_date) >= MONTH(TODAY()) AND YEAR(close_date) >= YEAR(TODAY())',
+ *   fields: ['close_date'],
+ *   message: 'Close Date must be in the current or a future month'
+ * }
+ * ```
+ *
+ * ### Example 2: Discount Validation
+ * **Salesforce Formula:**
+ * ```
+ * Discount__c > (Amount__c * 0.40)
+ * ```
+ *
+ * **ObjectStack Equivalent:**
+ * ```typescript
+ * {
+ *   type: 'cross_field',
+ *   name: 'discount_limit',
+ *   condition: 'discount > (amount * 0.40)',
+ *   fields: ['discount', 'amount'],
+ *   message: 'Discount cannot exceed 40% of the amount'
+ * }
+ * ```
+ *
+ * ### Example 3: Opportunity Must Have Products
+ * **Salesforce Formula:**
+ * ```
+ * ISBLANK(Products__c) && ISPICKVAL(StageName, "Closed Won")
+ * ```
+ *
+ * **ObjectStack Equivalent:**
+ * ```typescript
+ * {
+ *   type: 'cross_field',
+ *   name: 'products_required_for_won',
+ *   condition: 'products = null AND stage = "closed_won"',
+ *   fields: ['products', 'stage'],
+ *   message: 'Opportunity must have products to be marked as Closed Won'
+ * }
+ * ```
  */
 exports.CrossFieldValidationSchema = BaseValidationSchema.extend({
     type: zod_1.z.literal('cross_field'),
@@ -60,6 +165,124 @@ exports.CrossFieldValidationSchema = BaseValidationSchema.extend({
 /**
  * 6. Async Validation
  * Remote validation via API call or database query.
+ *
+ * ## Use Cases
+ *
+ * ### 1. Email Uniqueness Check
+ * Check if an email address is already registered in the system.
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'unique_email',
+ *   field: 'email',
+ *   validatorUrl: '/api/users/check-email',
+ *   message: 'This email address is already registered',
+ *   debounce: 500,  // Wait 500ms after user stops typing
+ *   timeout: 3000
+ * }
+ * ```
+ *
+ * ### 2. Username Availability
+ * Verify username is available before form submission.
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'username_available',
+ *   field: 'username',
+ *   validatorUrl: '/api/users/check-username',
+ *   message: 'This username is already taken',
+ *   debounce: 300,
+ *   timeout: 2000
+ * }
+ * ```
+ *
+ * ### 3. Tax ID Validation
+ * Validate tax ID with government API (e.g., IRS, HMRC).
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'validate_tax_id',
+ *   field: 'tax_id',
+ *   validatorFunction: 'validateTaxIdWithIRS',
+ *   message: 'Invalid Tax ID number',
+ *   timeout: 10000,  // Government APIs may be slow
+ *   params: { country: 'US', format: 'EIN' }
+ * }
+ * ```
+ *
+ * ### 4. Credit Card Validation
+ * Verify credit card with payment gateway without charging.
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'validate_card',
+ *   field: 'card_number',
+ *   validatorUrl: 'https://api.stripe.com/v1/tokens/validate',
+ *   message: 'Invalid credit card number',
+ *   timeout: 5000,
+ *   params: {
+ *     mode: 'validate_only',
+ *     checkFunds: false
+ *   }
+ * }
+ * ```
+ *
+ * ### 5. Address Validation
+ * Validate and standardize addresses using geocoding services.
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'validate_address',
+ *   field: 'street_address',
+ *   validatorFunction: 'validateAddressWithGoogleMaps',
+ *   message: 'Unable to verify address',
+ *   timeout: 4000,
+ *   params: {
+ *     includeFields: ['city', 'state', 'zip'],
+ *     strictMode: true,
+ *     country: 'US'
+ *   }
+ * }
+ * ```
+ *
+ * ### 6. Domain Name Availability
+ * Check if domain name is available for registration.
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'domain_available',
+ *   field: 'domain_name',
+ *   validatorUrl: '/api/domains/check-availability',
+ *   message: 'This domain is already taken or reserved',
+ *   debounce: 500,
+ *   timeout: 2000
+ * }
+ * ```
+ *
+ * ### 7. Coupon Code Validation
+ * Verify coupon code is valid and not expired.
+ * ```typescript
+ * {
+ *   type: 'async',
+ *   name: 'validate_coupon',
+ *   field: 'coupon_code',
+ *   validatorUrl: '/api/coupons/validate',
+ *   message: 'Invalid or expired coupon code',
+ *   timeout: 2000,
+ *   params: {
+ *     checkExpiration: true,
+ *     checkUsageLimit: true,
+ *     userId: '{{current_user_id}}'
+ *   }
+ * }
+ * ```
+ *
+ * ## Best Practices
+ * - Always set a reasonable `timeout` (default is 5000ms)
+ * - Use `debounce` for fields that are typed (300-500ms recommended)
+ * - Implement proper error handling on the server side
+ * - Cache validation results when appropriate
+ * - Consider rate limiting for external API calls
  */
 exports.AsyncValidationSchema = BaseValidationSchema.extend({
     type: zod_1.z.literal('async'),
@@ -96,6 +319,178 @@ exports.ValidationRuleSchema = zod_1.z.lazy(() => zod_1.z.discriminatedUnion('ty
 /**
  * 8. Conditional Validation
  * Validation that only applies when a condition is met.
+ *
+ * ## Overview
+ * Conditional validations follow the pattern: "Validate X only if Y is true"
+ * This allows for context-aware validation rules that adapt to different scenarios.
+ *
+ * ## Use Cases
+ *
+ * ### 1. Validate Based on Record Type
+ * Apply different validation rules based on the type of record.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'enterprise_approval_required',
+ *   when: 'account_type = "enterprise"',
+ *   message: 'Enterprise validation',
+ *   then: {
+ *     type: 'script',
+ *     name: 'require_approval',
+ *     message: 'Enterprise accounts require manager approval',
+ *     condition: 'approval_status = null'
+ *   }
+ * }
+ * ```
+ *
+ * ### 2. Conditional Field Requirements
+ * Require certain fields only when specific conditions are met.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'shipping_address_when_required',
+ *   when: 'requires_shipping = true',
+ *   message: 'Shipping validation',
+ *   then: {
+ *     type: 'script',
+ *     name: 'shipping_address_required',
+ *     message: 'Shipping address is required for physical products',
+ *     condition: 'shipping_address = null OR shipping_address = ""'
+ *   }
+ * }
+ * ```
+ *
+ * ### 3. Amount-Based Validation
+ * Apply different rules based on transaction amount.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'high_value_approval',
+ *   when: 'order_total > 10000',
+ *   message: 'High value order validation',
+ *   then: {
+ *     type: 'script',
+ *     name: 'manager_approval_required',
+ *     message: 'Orders over $10,000 require manager approval',
+ *     condition: 'manager_approval_id = null'
+ *   },
+ *   otherwise: {
+ *     type: 'script',
+ *     name: 'standard_validation',
+ *     message: 'Payment method is required',
+ *     condition: 'payment_method = null'
+ *   }
+ * }
+ * ```
+ *
+ * ### 4. Regional Compliance
+ * Apply region-specific validation rules.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'regional_compliance',
+ *   when: 'region = "EU"',
+ *   message: 'EU compliance validation',
+ *   then: {
+ *     type: 'script',
+ *     name: 'gdpr_consent',
+ *     message: 'GDPR consent is required for EU customers',
+ *     condition: 'gdpr_consent_given = false'
+ *   },
+ *   otherwise: {
+ *     type: 'script',
+ *     name: 'tos_acceptance',
+ *     message: 'Terms of Service acceptance required',
+ *     condition: 'tos_accepted = false'
+ *   }
+ * }
+ * ```
+ *
+ * ### 5. Nested Conditional Validation
+ * Create complex validation logic with nested conditions.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'country_state_validation',
+ *   when: 'country = "US"',
+ *   message: 'US-specific validation',
+ *   then: {
+ *     type: 'conditional',
+ *     name: 'california_validation',
+ *     when: 'state = "CA"',
+ *     message: 'California-specific validation',
+ *     then: {
+ *       type: 'script',
+ *       name: 'ca_tax_id_required',
+ *       message: 'California requires a valid tax ID',
+ *       condition: 'tax_id = null OR NOT(REGEX(tax_id, "^\\d{2}-\\d{7}$"))'
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * ### 6. Tax Validation for Taxable Items
+ * Only validate tax fields when the item is taxable.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'tax_field_validation',
+ *   when: 'is_taxable = true',
+ *   message: 'Tax validation',
+ *   then: {
+ *     type: 'script',
+ *     name: 'tax_code_required',
+ *     message: 'Tax code is required for taxable items',
+ *     condition: 'tax_code = null OR tax_code = ""'
+ *   }
+ * }
+ * ```
+ *
+ * ### 7. Role-Based Validation
+ * Apply validation based on user role.
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'role_based_approval_limit',
+ *   when: 'user_role = "manager"',
+ *   message: 'Manager approval limits',
+ *   then: {
+ *     type: 'script',
+ *     name: 'manager_limit',
+ *     message: 'Managers can approve up to $50,000',
+ *     condition: 'approval_amount > 50000'
+ *   }
+ * }
+ * ```
+ *
+ * ## Salesforce Pattern Comparison
+ *
+ * Salesforce doesn't have explicit "conditional validation" rules but achieves similar
+ * behavior using formula logic. ObjectStack makes this pattern explicit and composable.
+ *
+ * **Salesforce Approach:**
+ * ```
+ * IF(
+ *   ISPICKVAL(Type, "Enterprise"),
+ *   AND(Amount > 100000, ISBLANK(Approval__c)),
+ *   FALSE
+ * )
+ * ```
+ *
+ * **ObjectStack Approach:**
+ * ```typescript
+ * {
+ *   type: 'conditional',
+ *   name: 'enterprise_high_value',
+ *   when: 'type = "enterprise"',
+ *   then: {
+ *     type: 'cross_field',
+ *     name: 'amount_approval',
+ *     condition: 'amount > 100000 AND approval = null',
+ *     fields: ['amount', 'approval']
+ *   }
+ * }
+ * ```
  */
 exports.ConditionalValidationSchema = BaseValidationSchema.extend({
     type: zod_1.z.literal('conditional'),

package/dist/index.d.ts

@@ -3,46 +3,41 @@
  *
  * ObjectStack Protocol & Specification
  *
- * This package contains the core interfaces, schemas, and conventions for the ObjectStack ecosystem.
- * All types and schemas are centralized here.
+ * This package does NOT export types at the root level to prevent naming conflicts.
+ * Please use namespaced imports or subpath imports.
+ *
+ * ## Import Styles
+ *
+ * ### Style 1: Namespace Imports from Root
+ * ```typescript
+ * import { Data, UI, System, AI, API } from '@objectstack/spec';
+ *
+ * const field: Data.Field = { name: 'task_name', type: 'text' };
+ * const user: System.User = { id: 'u1', email: 'user@example.com' };
+ * ```
+ *
+ * ### Style 2: Namespace Imports via Subpath
+ * ```typescript
+ * import * as Data from '@objectstack/spec/data';
+ * import * as UI from '@objectstack/spec/ui';
+ * import * as System from '@objectstack/spec/system';
+ *
+ * const field: Data.Field = { name: 'task_name', type: 'text' };
+ * const user: System.User = { id: 'u1', email: 'user@example.com' };
+ * ```
+ *
+ * ### Style 3: Direct Subpath Imports
+ * ```typescript
+ * import { Field, FieldType } from '@objectstack/spec/data';
+ * import { User, Session } from '@objectstack/spec/system';
+ *
+ * const field: Field = { name: 'task_name', type: 'text' };
+ * const user: User = { id: 'u1', email: 'user@example.com' };
+ * ```
  */
-export * from './data/field.zod';
-export * from './data/object.zod';
-export * from './data/validation.zod';
-export * from './data/permission.zod';
-export * from './data/sharing.zod';
-export * from './data/workflow.zod';
-export * from './data/flow.zod';
-export * from './data/dataset.zod';
-export * from './data/query.zod';
-export * from './data/filter.zod';
-export * from './data/mapping.zod';
-export * from './data/trigger.zod';
-export * from './api/contract.zod';
-export * from './ai/agent.zod';
-export * from './ui/app.zod';
-export * from './ui/view.zod';
-export * from './ui/dashboard.zod';
-export * from './ui/report.zod';
-export * from './ui/action.zod';
-export * from './ui/page.zod';
-export * from './ui/widget.zod';
-export * from './ui/theme.zod';
-export * from './system/manifest.zod';
-export * from './system/datasource.zod';
-export * from './system/api.zod';
-export * from './system/identity.zod';
-export * from './system/auth.zod';
-export * from './system/policy.zod';
-export * from './system/role.zod';
-export * from './system/territory.zod';
-export * from './system/license.zod';
-export * from './system/webhook.zod';
-export * from './system/translation.zod';
-export * from './system/driver.zod';
-export * from './system/constants';
-export * from './system/types';
-export * from './system/discovery.zod';
-export * from './system/plugin.zod';
-export * from './system/driver.zod';
+export * as Data from './data';
+export * as UI from './ui';
+export * as System from './system';
+export * as AI from './ai';
+export * as API from './api';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAQH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC"}

package/dist/index.js

@@ -4,8 +4,37 @@
  *
  * ObjectStack Protocol & Specification
  *
- * This package contains the core interfaces, schemas, and conventions for the ObjectStack ecosystem.
- * All types and schemas are centralized here.
+ * This package does NOT export types at the root level to prevent naming conflicts.
+ * Please use namespaced imports or subpath imports.
+ *
+ * ## Import Styles
+ *
+ * ### Style 1: Namespace Imports from Root
+ * ```typescript
+ * import { Data, UI, System, AI, API } from '@objectstack/spec';
+ *
+ * const field: Data.Field = { name: 'task_name', type: 'text' };
+ * const user: System.User = { id: 'u1', email: 'user@example.com' };
+ * ```
+ *
+ * ### Style 2: Namespace Imports via Subpath
+ * ```typescript
+ * import * as Data from '@objectstack/spec/data';
+ * import * as UI from '@objectstack/spec/ui';
+ * import * as System from '@objectstack/spec/system';
+ *
+ * const field: Data.Field = { name: 'task_name', type: 'text' };
+ * const user: System.User = { id: 'u1', email: 'user@example.com' };
+ * ```
+ *
+ * ### Style 3: Direct Subpath Imports
+ * ```typescript
+ * import { Field, FieldType } from '@objectstack/spec/data';
+ * import { User, Session } from '@objectstack/spec/system';
+ *
+ * const field: Field = { name: 'task_name', type: 'text' };
+ * const user: User = { id: 'u1', email: 'user@example.com' };
+ * ```
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -18,51 +47,37 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     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);
-};
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-// Data Protocol (Schema, Validation, Logic)
-__exportStar(require("./data/field.zod"), exports);
-__exportStar(require("./data/object.zod"), exports);
-__exportStar(require("./data/validation.zod"), exports);
-__exportStar(require("./data/permission.zod"), exports);
-__exportStar(require("./data/sharing.zod"), exports);
-__exportStar(require("./data/workflow.zod"), exports);
-__exportStar(require("./data/flow.zod"), exports);
-__exportStar(require("./data/dataset.zod"), exports);
-__exportStar(require("./data/query.zod"), exports);
-__exportStar(require("./data/filter.zod"), exports); // Unified Query DSL
-__exportStar(require("./data/mapping.zod"), exports);
-__exportStar(require("./data/trigger.zod"), exports);
-// API Protocol (Envelopes, Contracts)
-__exportStar(require("./api/contract.zod"), exports);
-// AI Protocol (Agent, RAG)
-__exportStar(require("./ai/agent.zod"), exports);
-// UI Protocol (Layout, Navigation, Interaction)
-__exportStar(require("./ui/app.zod"), exports);
-__exportStar(require("./ui/view.zod"), exports);
-__exportStar(require("./ui/dashboard.zod"), exports);
-__exportStar(require("./ui/report.zod"), exports);
-__exportStar(require("./ui/action.zod"), exports);
-__exportStar(require("./ui/page.zod"), exports);
-__exportStar(require("./ui/widget.zod"), exports);
-__exportStar(require("./ui/theme.zod"), exports);
-// System Protocol (Manifest, Runtime, Constants)
-__exportStar(require("./system/manifest.zod"), exports);
-__exportStar(require("./system/datasource.zod"), exports);
-__exportStar(require("./system/api.zod"), exports);
-__exportStar(require("./system/identity.zod"), exports);
-__exportStar(require("./system/auth.zod"), exports);
-__exportStar(require("./system/policy.zod"), exports);
-__exportStar(require("./system/role.zod"), exports);
-__exportStar(require("./system/territory.zod"), exports);
-__exportStar(require("./system/license.zod"), exports);
-__exportStar(require("./system/webhook.zod"), exports);
-__exportStar(require("./system/translation.zod"), exports);
-__exportStar(require("./system/driver.zod"), exports); // Export Driver Protocol
-__exportStar(require("./system/constants"), exports);
-__exportStar(require("./system/types"), exports);
-__exportStar(require("./system/discovery.zod"), exports);
-__exportStar(require("./system/plugin.zod"), exports);
-__exportStar(require("./system/driver.zod"), exports);
+exports.API = exports.AI = exports.System = exports.UI = exports.Data = void 0;
+// ============================================================================
+// NAMESPACE EXPORTS
+// ============================================================================
+// Export protocol domains as namespaces to prevent naming conflicts
+// and establish clear boundaries between different protocol layers.
+exports.Data = __importStar(require("./data"));
+exports.UI = __importStar(require("./ui"));
+exports.System = __importStar(require("./system"));
+exports.AI = __importStar(require("./ai"));
+exports.API = __importStar(require("./api"));