@objectstack/spec 0.3.3 → 0.4.1

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

@@ -1 +1 @@
-{"version":3,"file":"field.zod.d.ts","sourceRoot":"","sources":["../../src/data/field.zod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"field.zod.d.ts","sourceRoot":"","sources":["../../src/data/field.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,SAAS,qdAqCpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,eAAe;;;;;;IAOf,2BAA2B;;;;;;IAO3B,8BAA8B;;;IAI9B,yBAAyB;;;;;IAMzB,wBAAwB;;;;;;;;;;;;;;;;;IAGxB,0BAA0B;;;;;IAM1B,kBAAkB;;;;;;;;;;;;;;;;IASlB,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyCzC,4BAA4B;;;;IAK5B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,KAAK;oBACD,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACb,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBACd,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACR,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBACR,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BACP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACd,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE7B;;;;;;;;;;;;;;;OAeG;8BACuB,YAAY,EAAE,GAAG,MAAM,EAAE,IAAG,UAAU,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAAA;KAAE,CAAA,WAAW,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuC1G,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAMpB,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAOjC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAKX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAKT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKX,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAM5B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAKN,MAAM,WAAc,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAM9B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKb,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAKN,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWhD,CAAC"}

package/dist/data/field.zod.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Field = exports.FieldSchema = exports.AddressSchema = exports.CurrencyValueSchema = exports.CurrencyConfigSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
+exports.Field = exports.FieldSchema = exports.VectorConfigSchema = exports.AddressSchema = exports.CurrencyValueSchema = exports.CurrencyConfigSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
 const zod_1 = require("zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 /**
  * Field Type Enum
  */
@@ -15,32 +16,55 @@ exports.FieldType = zod_1.z.enum([
     // Date & Time
     'date', 'datetime', 'time',
     // Logic
-    'boolean',
+    'boolean', 'toggle', // Toggle is a distinct UI from checkbox
     // Selection
-    'select', // Static options
+    'select', // Single select dropdown
+    'multiselect', // Multi select (often tags)
+    'radio', // Radio group
+    'checkboxes', // Checkbox group
     // Relational
-    'lookup', 'master_detail', // Dynamic reference to other objects
+    'lookup', 'master_detail', // Dynamic reference
+    'tree', // Hierarchical reference
     // Media
-    'image', 'file', 'avatar',
+    'image', 'file', 'avatar', 'video', 'audio',
     // Calculated / System
     'formula', 'summary', 'autonumber',
     // Enhanced Types
-    'location', // GPS coordinates (aka geolocation)
-    'geolocation', // Alternative name for location field
+    'location', // GPS coordinates
     'address', // Structured address
-    'code', // Code with syntax highlighting
+    'code', // Code editor (JSON/SQL/JS)
+    'json', // Structured JSON data
     'color', // Color picker
     'rating', // Star rating
     'slider', // Numeric slider
     'signature', // Digital signature
     'qrcode', // QR code / Barcode
+    'progress', // Progress bar
+    'tags', // Simple tag list
+    // AI/ML Types
+    'vector', // Vector embeddings for AI/ML (semantic search, RAG)
 ]);
 /**
  * Select Option Schema
+ *
+ * Defines option values for select/picklist fields.
+ *
+ * **CRITICAL RULE**: The `value` field is a machine identifier that gets stored in the database.
+ * It MUST be lowercase to avoid case-sensitivity issues in queries and comparisons.
+ *
+ * @example Good
+ * { label: 'New', value: 'new' }
+ * { label: 'In Progress', value: 'in_progress' }
+ * { label: 'Closed Won', value: 'closed_won' }
+ *
+ * @example Bad (will be rejected)
+ * { label: 'New', value: 'New' } // uppercase
+ * { label: 'In Progress', value: 'In Progress' } // spaces and uppercase
+ * { label: 'Closed Won', value: 'Closed_Won' } // mixed case
  */
 exports.SelectOptionSchema = zod_1.z.object({
-    label: zod_1.z.string().describe('Display label'),
-    value: zod_1.z.string().describe('Stored value'),
+    label: zod_1.z.string().describe('Display label (human-readable, any case allowed)'),
+    value: identifiers_zod_1.SystemIdentifierSchema.describe('Stored value (lowercase machine identifier)'),
     color: zod_1.z.string().optional().describe('Color code for badges/charts'),
     default: zod_1.z.boolean().optional().describe('Is default option'),
 });
@@ -93,6 +117,37 @@ exports.AddressSchema = zod_1.z.object({
     countryCode: zod_1.z.string().optional().describe('ISO country code (e.g., US, GB)'),
     formatted: zod_1.z.string().optional().describe('Formatted address string'),
 });
+/**
+ * Vector Configuration Schema
+ * Configuration for vector field type supporting AI/ML embeddings
+ *
+ * Vector fields store numerical embeddings for semantic search, similarity matching,
+ * and Retrieval-Augmented Generation (RAG) workflows.
+ *
+ * @example
+ * // Text embeddings for semantic search
+ * {
+ *   dimensions: 1536,  // OpenAI text-embedding-ada-002
+ *   distanceMetric: 'cosine',
+ *   indexed: true
+ * }
+ *
+ * @example
+ * // Image embeddings with normalization
+ * {
+ *   dimensions: 512,   // ResNet-50
+ *   distanceMetric: 'euclidean',
+ *   normalized: true,
+ *   indexed: true
+ * }
+ */
+exports.VectorConfigSchema = zod_1.z.object({
+    dimensions: zod_1.z.number().int().min(1).max(10000).describe('Vector dimensionality (e.g., 1536 for OpenAI embeddings)'),
+    distanceMetric: zod_1.z.enum(['cosine', 'euclidean', 'dotProduct', 'manhattan']).default('cosine').describe('Distance/similarity metric for vector search'),
+    normalized: zod_1.z.boolean().default(false).describe('Whether vectors are normalized (unit length)'),
+    indexed: zod_1.z.boolean().default(true).describe('Whether to create a vector index for fast similarity search'),
+    indexType: zod_1.z.enum(['hnsw', 'ivfflat', 'flat']).optional().describe('Vector index algorithm (HNSW for high accuracy, IVFFlat for large datasets)'),
+});
 /**
  * Field Schema - Best Practice Enterprise Pattern
  */
@@ -162,6 +217,8 @@ exports.FieldSchema = zod_1.z.object({
     allowScanning: zod_1.z.boolean().optional().describe('Enable camera scanning for barcode/QR code input'),
     // Currency field config
     currencyConfig: exports.CurrencyConfigSchema.optional().describe('Configuration for currency field type'),
+    // Vector field config
+    vectorConfig: exports.VectorConfigSchema.optional().describe('Configuration for vector field type (AI/ML embeddings)'),
     /** Security & Visibility */
     hidden: zod_1.z.boolean().default(false).describe('Hidden from default UI'),
     readonly: zod_1.z.boolean().default(false).describe('Read-only in UI'),
@@ -194,13 +251,27 @@ exports.Field = {
     /**
      * Select field helper with backward-compatible API
      *
-     * @example Old API (array first)
+     * Automatically converts option values to lowercase to enforce naming conventions.
+     *
+     * @example Old API (array first) - auto-converts to lowercase
      * Field.select(['High', 'Low'], { label: 'Priority' })
+     * // Results in: [{ label: 'High', value: 'high' }, { label: 'Low', value: 'low' }]
      *
-     * @example New API (config object)
+     * @example New API (config object) - enforces lowercase
      * Field.select({ options: [{label: 'High', value: 'high'}], label: 'Priority' })
+     *
+     * @example Multi-word values - converts to snake_case
+     * Field.select(['In Progress', 'Closed Won'], { label: 'Status' })
+     * // Results in: [{ label: 'In Progress', value: 'in_progress' }, { label: 'Closed Won', value: 'closed_won' }]
      */
     select: (optionsOrConfig, config) => {
+        // Helper function to convert string to lowercase snake_case
+        const toSnakeCase = (str) => {
+            return str
+                .toLowerCase()
+                .replace(/\s+/g, '_') // Replace spaces with underscores
+                .replace(/[^a-z0-9_]/g, ''); // Remove invalid characters (keeping underscores only)
+        };
         // Support both old and new signatures:
         // Old: Field.select(['a', 'b'], { label: 'X' })
         // New: Field.select({ options: [{label: 'A', value: 'a'}], label: 'X' })
@@ -208,12 +279,18 @@ exports.Field = {
         let finalConfig;
         if (Array.isArray(optionsOrConfig)) {
             // Old signature: array as first param
-            options = optionsOrConfig.map(o => typeof o === 'string' ? { label: o, value: o } : o);
+            options = optionsOrConfig.map(o => typeof o === 'string'
+                ? { label: o, value: toSnakeCase(o) } // Auto-convert string to snake_case
+                : { ...o, value: o.value.toLowerCase() } // Ensure value is lowercase
+            );
             finalConfig = config || {};
         }
         else {
             // New signature: config object with options
-            options = (optionsOrConfig.options || []).map(o => typeof o === 'string' ? { label: o, value: o } : o);
+            options = (optionsOrConfig.options || []).map(o => typeof o === 'string'
+                ? { label: o, value: toSnakeCase(o) } // Auto-convert string to snake_case
+                : { ...o, value: o.value.toLowerCase() } // Ensure value is lowercase
+            );
             // Remove options from config to avoid confusion
             const { options: _, ...restConfig } = optionsOrConfig;
             finalConfig = restConfig;
@@ -269,8 +346,15 @@ exports.Field = {
         type: 'qrcode',
         ...config
     }),
-    geolocation: (config = {}) => ({
-        type: 'geolocation',
+    vector: (dimensions, config = {}) => ({
+        type: 'vector',
+        vectorConfig: {
+            dimensions,
+            distanceMetric: 'cosine',
+            normalized: false,
+            indexed: true,
+            ...config.vectorConfig
+        },
         ...config
     }),
 };

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

@@ -43,7 +43,7 @@ export declare const FieldMappingSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     target: string | string[];
     source: string | string[];
-    transform: "join" | "map" | "lookup" | "none" | "javascript" | "constant" | "split";
+    transform: "join" | "map" | "lookup" | "none" | "split" | "javascript" | "constant";
     params?: {
         object?: string | undefined;
         value?: any;
@@ -65,11 +65,23 @@ export declare const FieldMappingSchema: z.ZodObject<{
         valueMap?: Record<string, any> | undefined;
         separator?: string | undefined;
     } | undefined;
-    transform?: "join" | "map" | "lookup" | "none" | "javascript" | "constant" | "split" | undefined;
+    transform?: "join" | "map" | "lookup" | "none" | "split" | "javascript" | "constant" | undefined;
 }>;
 /**
- * ETL Mapping Schema
- * Definition for importing/exporting data defined in `integration-etl.mdx`.
+ * Data Mapping Schema
+ * Defines a reusable data mapping configuration for ETL operations.
+ *
+ * **NAMING CONVENTION:**
+ * Mapping names are machine identifiers and must be lowercase snake_case.
+ *
+ * @example Good mapping names
+ * - 'salesforce_to_crm'
+ * - 'csv_import_contacts'
+ * - 'api_sync_orders'
+ *
+ * @example Bad mapping names (will be rejected)
+ * - 'SalesforceToCRM' (PascalCase)
+ * - 'CSV Import' (spaces)
  */
 export declare const MappingSchema: z.ZodObject<{
     /** Identity */
@@ -115,7 +127,7 @@ export declare const MappingSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         target: string | string[];
         source: string | string[];
-        transform: "join" | "map" | "lookup" | "none" | "javascript" | "constant" | "split";
+        transform: "join" | "map" | "lookup" | "none" | "split" | "javascript" | "constant";
         params?: {
             object?: string | undefined;
             value?: any;
@@ -137,7 +149,7 @@ export declare const MappingSchema: z.ZodObject<{
             valueMap?: Record<string, any> | undefined;
             separator?: string | undefined;
         } | undefined;
-        transform?: "join" | "map" | "lookup" | "none" | "javascript" | "constant" | "split" | undefined;
+        transform?: "join" | "map" | "lookup" | "none" | "split" | "javascript" | "constant" | undefined;
     }>, "many">;
     /** Upsert Logic */
     mode: z.ZodDefault<z.ZodEnum<["insert", "update", "upsert"]>>;
@@ -359,7 +371,7 @@ export declare const MappingSchema: z.ZodObject<{
     fieldMapping: {
         target: string | string[];
         source: string | string[];
-        transform: "join" | "map" | "lookup" | "none" | "javascript" | "constant" | "split";
+        transform: "join" | "map" | "lookup" | "none" | "split" | "javascript" | "constant";
         params?: {
             object?: string | undefined;
             value?: any;
@@ -370,7 +382,7 @@ export declare const MappingSchema: z.ZodObject<{
             separator?: string | undefined;
         } | undefined;
     }[];
-    errorPolicy: "abort" | "skip" | "retry";
+    errorPolicy: "abort" | "retry" | "skip";
     label?: string | undefined;
     upsertKey?: string[] | undefined;
     extractQuery?: {
@@ -428,7 +440,7 @@ export declare const MappingSchema: z.ZodObject<{
             valueMap?: Record<string, any> | undefined;
             separator?: string | undefined;
         } | undefined;
-        transform?: "join" | "map" | "lookup" | "none" | "javascript" | "constant" | "split" | undefined;
+        transform?: "join" | "map" | "lookup" | "none" | "split" | "javascript" | "constant" | undefined;
     }[];
     label?: string | undefined;
     mode?: "insert" | "update" | "upsert" | undefined;
@@ -475,7 +487,7 @@ export declare const MappingSchema: z.ZodObject<{
             field?: string | undefined;
         }[] | undefined;
     } | undefined;
-    errorPolicy?: "abort" | "skip" | "retry" | undefined;
+    errorPolicy?: "abort" | "retry" | "skip" | undefined;
 }>;
 export type Mapping = z.infer<typeof MappingSchema>;
 export type FieldMapping = z.infer<typeof FieldMappingSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"mapping.zod.d.ts","sourceRoot":"","sources":["../../src/data/mapping.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,aAAa,iFAQxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,oBAAoB;;IAGpB,mBAAmB;;IAGnB,qBAAqB;;IAGrB,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB,eAAe;;;IAIf,YAAY;;;IAIZ,sBAAsB;;QAzCtB,oBAAoB;;QAGpB,mBAAmB;;QAGnB,qBAAqB;;QAGrB,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmClC,mBAAmB;;;IAInB,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGjC,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGrB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"mapping.zod.d.ts","sourceRoot":"","sources":["../../src/data/mapping.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,aAAa,iFAQxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,oBAAoB;;IAGpB,mBAAmB;;IAGnB,qBAAqB;;IAGrB,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBlC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa;IACxB,eAAe;;;IAIf,YAAY;;;IAIZ,sBAAsB;;QArDtB,oBAAoB;;QAGpB,mBAAmB;;QAGnB,qBAAqB;;QAGrB,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+ClC,mBAAmB;;;IAInB,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGjC,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGrB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/data/mapping.zod.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MappingSchema = exports.FieldMappingSchema = exports.TransformType = void 0;
 const zod_1 = require("zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 const query_zod_1 = require("./query.zod");
 /**
  * Transformation Logic
@@ -42,12 +43,24 @@ exports.FieldMappingSchema = zod_1.z.object({
     }).optional()
 });
 /**
- * ETL Mapping Schema
- * Definition for importing/exporting data defined in `integration-etl.mdx`.
+ * Data Mapping Schema
+ * Defines a reusable data mapping configuration for ETL operations.
+ *
+ * **NAMING CONVENTION:**
+ * Mapping names are machine identifiers and must be lowercase snake_case.
+ *
+ * @example Good mapping names
+ * - 'salesforce_to_crm'
+ * - 'csv_import_contacts'
+ * - 'api_sync_orders'
+ *
+ * @example Bad mapping names (will be rejected)
+ * - 'SalesforceToCRM' (PascalCase)
+ * - 'CSV Import' (spaces)
  */
 exports.MappingSchema = zod_1.z.object({
     /** Identity */
-    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/),
+    name: identifiers_zod_1.SnakeCaseIdentifierSchema.describe('Mapping unique name (lowercase snake_case)'),
     label: zod_1.z.string().optional(),
     /** Scope */
     sourceFormat: zod_1.z.enum(['csv', 'json', 'xml', 'sql']).default('csv'),