@objectstack/spec 0.6.1 → 0.7.2

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

@@ -1 +1 @@
-{"version":3,"file":"object.zod.d.ts","sourceRoot":"","sources":["../../src/data/object.zod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"object.zod.d.ts","sourceRoot":"","sources":["../../src/data/object.zod.ts"],"names":[],"mappings":"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"}

package/dist/data/object.zod.js

@@ -1,9 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectSchema = exports.SearchConfigSchema = exports.IndexSchema = exports.ObjectCapabilities = void 0;
+exports.ObjectSchema = exports.CDCConfigSchema = exports.PartitioningConfigSchema = exports.VersioningConfigSchema = exports.SoftDeleteConfigSchema = exports.TenancyConfigSchema = exports.SearchConfigSchema = exports.IndexSchema = exports.ObjectCapabilities = exports.ApiMethod = void 0;
 const zod_1 = require("zod");
 const field_zod_1 = require("./field.zod");
 const validation_zod_1 = require("./validation.zod");
+/**
+ * API Operations Enum
+ */
+exports.ApiMethod = zod_1.z.enum([
+    'get', 'list', // Read
+    'create', 'update', 'delete', // Write
+    'upsert', // Idempotent Write
+    'bulk', // Batch operations
+    'aggregate', // Analytics (count, sum)
+    'history', // Audit access
+    'search', // Search access
+    'restore', 'purge', // Trash management
+    'import', 'export', // Data portability
+]);
 /**
  * Capability Flags
  * Defines what system features are enabled for this object.
@@ -25,17 +39,7 @@ exports.ObjectCapabilities = zod_1.z.object({
      * API Supported Operations
      * Granular control over API exposure.
      */
-    apiMethods: zod_1.z.array(zod_1.z.enum([
-        'get', 'list', // Read
-        'create', 'update', 'delete', // Write
-        'upsert', // Idempotent Write
-        'bulk', // Batch operations
-        'aggregate', // Analytics (count, sum)
-        'history', // Audit access
-        'search', // Search access
-        'restore', 'purge', // Trash management
-        'import', 'export', // Data portability
-    ])).optional().describe('Whitelist of allowed API operations'),
+    apiMethods: zod_1.z.array(exports.ApiMethod).optional().describe('Whitelist of allowed API operations'),
     /** Enable standard attachments/files engine */
     files: zod_1.z.boolean().default(false).describe('Enable file attachments and document management'),
     /** Enable social collaboration (Comments, Mentions, Feeds) */
@@ -51,12 +55,14 @@ exports.ObjectCapabilities = zod_1.z.object({
 });
 /**
  * Schema for database indexes.
+ * Enhanced with additional index types and configuration options
  */
 exports.IndexSchema = zod_1.z.object({
-    name: zod_1.z.string().optional().describe('Index name'),
+    name: zod_1.z.string().optional().describe('Index name (auto-generated if not provided)'),
     fields: zod_1.z.array(zod_1.z.string()).describe('Fields included in the index'),
-    unique: zod_1.z.boolean().optional().describe('Whether the index is unique'),
-    type: zod_1.z.enum(['btree', 'hash', 'gin', 'gist']).optional().describe('Index type (default: btree)'),
+    type: zod_1.z.enum(['btree', 'hash', 'gin', 'gist', 'fulltext']).optional().default('btree').describe('Index algorithm type'),
+    unique: zod_1.z.boolean().optional().default(false).describe('Whether the index enforces uniqueness'),
+    partial: zod_1.z.string().optional().describe('Partial index condition (SQL WHERE clause for conditional indexes)'),
 });
 /**
  * Search Configuration
@@ -67,6 +73,100 @@ exports.SearchConfigSchema = zod_1.z.object({
     displayFields: zod_1.z.array(zod_1.z.string()).optional().describe('Fields to display in search result cards'),
     filters: zod_1.z.array(zod_1.z.string()).optional().describe('Default filters for search results'),
 });
+/**
+ * Multi-Tenancy Configuration Schema
+ * Configures tenant isolation strategy for SaaS applications
+ *
+ * @example Shared database with tenant_id isolation
+ * {
+ *   enabled: true,
+ *   strategy: 'shared',
+ *   tenantField: 'tenant_id',
+ *   crossTenantAccess: false
+ * }
+ */
+exports.TenancyConfigSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().describe('Enable multi-tenancy for this object'),
+    strategy: zod_1.z.enum(['shared', 'isolated', 'hybrid']).describe('Tenant isolation strategy: shared (single DB, row-level), isolated (separate DB per tenant), hybrid (mix)'),
+    tenantField: zod_1.z.string().default('tenant_id').describe('Field name for tenant identifier'),
+    crossTenantAccess: zod_1.z.boolean().default(false).describe('Allow cross-tenant data access (with explicit permission)'),
+});
+/**
+ * Soft Delete Configuration Schema
+ * Implements recycle bin / trash functionality
+ *
+ * @example Standard soft delete with cascade
+ * {
+ *   enabled: true,
+ *   field: 'deleted_at',
+ *   cascadeDelete: true
+ * }
+ */
+exports.SoftDeleteConfigSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().describe('Enable soft delete (trash/recycle bin)'),
+    field: zod_1.z.string().default('deleted_at').describe('Field name for soft delete timestamp'),
+    cascadeDelete: zod_1.z.boolean().default(false).describe('Cascade soft delete to related records'),
+});
+/**
+ * Versioning Configuration Schema
+ * Implements record versioning and history tracking
+ *
+ * @example Snapshot versioning with 90-day retention
+ * {
+ *   enabled: true,
+ *   strategy: 'snapshot',
+ *   retentionDays: 90,
+ *   versionField: 'version'
+ * }
+ */
+exports.VersioningConfigSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().describe('Enable record versioning'),
+    strategy: zod_1.z.enum(['snapshot', 'delta', 'event-sourcing']).describe('Versioning strategy: snapshot (full copy), delta (changes only), event-sourcing (event log)'),
+    retentionDays: zod_1.z.number().min(1).optional().describe('Number of days to retain old versions (undefined = infinite)'),
+    versionField: zod_1.z.string().default('version').describe('Field name for version number/timestamp'),
+});
+/**
+ * Partitioning Strategy Schema
+ * Configures table partitioning for performance at scale
+ *
+ * @example Range partitioning by date (monthly)
+ * {
+ *   enabled: true,
+ *   strategy: 'range',
+ *   key: 'created_at',
+ *   interval: '1 month'
+ * }
+ */
+exports.PartitioningConfigSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().describe('Enable table partitioning'),
+    strategy: zod_1.z.enum(['range', 'hash', 'list']).describe('Partitioning strategy: range (date ranges), hash (consistent hashing), list (predefined values)'),
+    key: zod_1.z.string().describe('Field name to partition by'),
+    interval: zod_1.z.string().optional().describe('Partition interval for range strategy (e.g., "1 month", "1 year")'),
+}).refine((data) => {
+    // If strategy is 'range', interval must be provided
+    if (data.strategy === 'range' && !data.interval) {
+        return false;
+    }
+    return true;
+}, {
+    message: 'interval is required when strategy is "range"',
+});
+/**
+ * Change Data Capture (CDC) Configuration Schema
+ * Enables real-time data streaming to external systems
+ *
+ * @example Stream all changes to Kafka
+ * {
+ *   enabled: true,
+ *   events: ['insert', 'update', 'delete'],
+ *   destination: 'kafka://events.objectstack'
+ * }
+ */
+exports.CDCConfigSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().describe('Enable Change Data Capture'),
+    events: zod_1.z.array(zod_1.z.enum(['insert', 'update', 'delete'])).describe('Event types to capture'),
+    destination: zod_1.z.string().describe('Destination endpoint (e.g., "kafka://topic", "webhook://url")'),
+});
 /**
  * Base Object Schema Definition
  *
@@ -97,8 +197,23 @@ const ObjectSchemaBase = zod_1.z.object({
     /**
      * Data Model
      */
-    fields: zod_1.z.record(field_zod_1.FieldSchema).describe('Field definitions map'),
+    fields: zod_1.z.record(zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/, {
+        message: 'Field names must be lowercase snake_case (e.g., "first_name", "company", "annual_revenue")',
+    }), field_zod_1.FieldSchema).describe('Field definitions map. Keys must be snake_case identifiers.'),
     indexes: zod_1.z.array(exports.IndexSchema).optional().describe('Database performance indexes'),
+    /**
+     * Advanced Data Management
+     */
+    // Multi-tenancy configuration
+    tenancy: exports.TenancyConfigSchema.optional().describe('Multi-tenancy configuration for SaaS applications'),
+    // Soft delete configuration
+    softDelete: exports.SoftDeleteConfigSchema.optional().describe('Soft delete (trash/recycle bin) configuration'),
+    // Versioning configuration
+    versioning: exports.VersioningConfigSchema.optional().describe('Record versioning and history tracking configuration'),
+    // Partitioning strategy
+    partitioning: exports.PartitioningConfigSchema.optional().describe('Table partitioning configuration for performance'),
+    // Change Data Capture
+    cdc: exports.CDCConfigSchema.optional().describe('Change Data Capture (CDC) configuration for real-time data streaming'),
     /**
      * Logic & Validation (Co-located)
      * Best Practice: Define rules close to data.

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

@@ -494,6 +494,53 @@ export declare const WindowFunctionNodeSchema: z.ZodObject<{
  * Represents "Select" attributes, including joins.
  */
 export declare const FieldNodeSchema: z.ZodType<any>;
+/**
+ * Full-Text Search Configuration
+ * Defines full-text search parameters for text queries.
+ *
+ * Supports:
+ * - Multi-field search
+ * - Relevance scoring
+ * - Fuzzy matching
+ * - Language-specific analyzers
+ *
+ * @example
+ * {
+ *   query: "John Smith",
+ *   fields: ["name", "email", "description"],
+ *   fuzzy: true,
+ *   boost: { "name": 2.0, "email": 1.5 }
+ * }
+ */
+export declare const FullTextSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    fuzzy: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<["and", "or"]>>>;
+    boost: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    minScore: z.ZodOptional<z.ZodNumber>;
+    language: z.ZodOptional<z.ZodString>;
+    highlight: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    fuzzy: boolean;
+    operator: "and" | "or";
+    highlight: boolean;
+    fields?: string[] | undefined;
+    boost?: Record<string, number> | undefined;
+    minScore?: number | undefined;
+    language?: string | undefined;
+}, {
+    query: string;
+    fields?: string[] | undefined;
+    fuzzy?: boolean | undefined;
+    operator?: "and" | "or" | undefined;
+    boost?: Record<string, number> | undefined;
+    minScore?: number | undefined;
+    language?: string | undefined;
+    highlight?: boolean | undefined;
+}>;
+export type FullTextSearch = z.infer<typeof FullTextSearchSchema>;
 /**
  * Query AST Schema
  * The universal data retrieval contract defined in `ast-structure.mdx`.
@@ -507,6 +554,9 @@ export declare const FieldNodeSchema: z.ZodType<any>;
  * - Renamed `top`/`skip` to `limit`/`offset`
  * - Unified filtering syntax with `FilterConditionSchema`
  *
+ * Updates (v3):
+ * - Added `search` parameter for full-text search (P2 requirement)
+ *
  * @example
  * // Simple query: SELECT name, email FROM account WHERE status = 'active'
  * {
@@ -524,6 +574,19 @@ export declare const FieldNodeSchema: z.ZodType<any>;
  *   limit: 20,
  *   offset: 40
  * }
+ *
+ * @example
+ * // Full-text search
+ * {
+ *   object: 'article',
+ *   search: {
+ *     query: "machine learning",
+ *     fields: ["title", "content"],
+ *     fuzzy: true,
+ *     boost: { "title": 2.0 }
+ *   },
+ *   limit: 10
+ * }
  */
 export declare const QuerySchema: z.ZodObject<{
     /** Target Entity */
@@ -532,6 +595,35 @@ export declare const QuerySchema: z.ZodObject<{
     fields: z.ZodOptional<z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">>;
     /** Where Clause (Filtering) */
     where: z.ZodOptional<z.ZodType<import("./filter.zod").FilterCondition, z.ZodTypeDef, import("./filter.zod").FilterCondition>>;
+    /** Full-Text Search */
+    search: z.ZodOptional<z.ZodObject<{
+        query: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        fuzzy: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<["and", "or"]>>>;
+        boost: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        minScore: z.ZodOptional<z.ZodNumber>;
+        language: z.ZodOptional<z.ZodString>;
+        highlight: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        fuzzy: boolean;
+        operator: "and" | "or";
+        highlight: boolean;
+        fields?: string[] | undefined;
+        boost?: Record<string, number> | undefined;
+        minScore?: number | undefined;
+        language?: string | undefined;
+    }, {
+        query: string;
+        fields?: string[] | undefined;
+        fuzzy?: boolean | undefined;
+        operator?: "and" | "or" | undefined;
+        boost?: Record<string, number> | undefined;
+        minScore?: number | undefined;
+        language?: string | undefined;
+        highlight?: boolean | undefined;
+    }>>;
     /** Order By Clause (Sorting) */
     orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodString;
@@ -666,6 +758,16 @@ export declare const QuerySchema: z.ZodObject<{
     where?: import("./filter.zod").FilterCondition | undefined;
     distinct?: boolean | undefined;
     fields?: any[] | undefined;
+    search?: {
+        query: string;
+        fuzzy: boolean;
+        operator: "and" | "or";
+        highlight: boolean;
+        fields?: string[] | undefined;
+        boost?: Record<string, number> | undefined;
+        minScore?: number | undefined;
+        language?: string | undefined;
+    } | undefined;
     orderBy?: {
         field: string;
         order: "asc" | "desc";
@@ -705,6 +807,16 @@ export declare const QuerySchema: z.ZodObject<{
     where?: import("./filter.zod").FilterCondition | undefined;
     distinct?: boolean | undefined;
     fields?: any[] | undefined;
+    search?: {
+        query: string;
+        fields?: string[] | undefined;
+        fuzzy?: boolean | undefined;
+        operator?: "and" | "or" | undefined;
+        boost?: Record<string, number> | undefined;
+        minScore?: number | undefined;
+        language?: string | undefined;
+        highlight?: boolean | undefined;
+    } | undefined;
     orderBy?: {
         field: string;
         order?: "asc" | "desc" | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"query.zod.d.ts","sourceRoot":"","sources":["../../src/data/query.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,mBAAmB,+FAG9B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,QAAQ,+CAA6C,CAAC;AAEnE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,iDAA+C,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CASzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,cAAc,kJAIzB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAS1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,WAAW;IACtB,oBAAoB;;IAGpB,oBAAoB;;IAGpB,+BAA+B;;IAG/B,gCAAgC;;;;;;;;;;;IAGhC,iBAAiB;;;;IAKjB,YAAY;;IAGZ,mBAAmB;;;;;;;;;;;;;;;;;;;;IAGnB,sBAAsB;;IAGtB,oBAAoB;;IAGpB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGvB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"query.zod.d.ts","sourceRoot":"","sources":["../../src/data/query.zod.ts"],"names":[],"mappings":"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"}

package/dist/data/query.zod.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QuerySchema = exports.FieldNodeSchema = exports.WindowFunctionNodeSchema = exports.WindowSpecSchema = exports.WindowFunction = exports.JoinNodeSchema = exports.JoinStrategy = exports.JoinType = exports.AggregationNodeSchema = exports.AggregationFunction = exports.SortNodeSchema = void 0;
+exports.QuerySchema = exports.FullTextSearchSchema = exports.FieldNodeSchema = exports.WindowFunctionNodeSchema = exports.WindowSpecSchema = exports.WindowFunction = exports.JoinNodeSchema = exports.JoinStrategy = exports.JoinType = exports.AggregationNodeSchema = exports.AggregationFunction = exports.SortNodeSchema = void 0;
 const zod_1 = require("zod");
 const filter_zod_1 = require("./filter.zod");
 /**
@@ -383,6 +383,34 @@ exports.FieldNodeSchema = zod_1.z.lazy(() => zod_1.z.union([
         alias: zod_1.z.string().optional()
     })
 ]));
+/**
+ * Full-Text Search Configuration
+ * Defines full-text search parameters for text queries.
+ *
+ * Supports:
+ * - Multi-field search
+ * - Relevance scoring
+ * - Fuzzy matching
+ * - Language-specific analyzers
+ *
+ * @example
+ * {
+ *   query: "John Smith",
+ *   fields: ["name", "email", "description"],
+ *   fuzzy: true,
+ *   boost: { "name": 2.0, "email": 1.5 }
+ * }
+ */
+exports.FullTextSearchSchema = zod_1.z.object({
+    query: zod_1.z.string().describe('Search query text'),
+    fields: zod_1.z.array(zod_1.z.string()).optional().describe('Fields to search in (if not specified, searches all text fields)'),
+    fuzzy: zod_1.z.boolean().optional().default(false).describe('Enable fuzzy matching (tolerates typos)'),
+    operator: zod_1.z.enum(['and', 'or']).optional().default('or').describe('Logical operator between terms'),
+    boost: zod_1.z.record(zod_1.z.number()).optional().describe('Field-specific relevance boosting (field name -> boost factor)'),
+    minScore: zod_1.z.number().optional().describe('Minimum relevance score threshold'),
+    language: zod_1.z.string().optional().describe('Language for text analysis (e.g., "en", "zh", "es")'),
+    highlight: zod_1.z.boolean().optional().default(false).describe('Enable search result highlighting'),
+});
 /**
  * Query AST Schema
  * The universal data retrieval contract defined in `ast-structure.mdx`.
@@ -396,6 +424,9 @@ exports.FieldNodeSchema = zod_1.z.lazy(() => zod_1.z.union([
  * - Renamed `top`/`skip` to `limit`/`offset`
  * - Unified filtering syntax with `FilterConditionSchema`
  *
+ * Updates (v3):
+ * - Added `search` parameter for full-text search (P2 requirement)
+ *
  * @example
  * // Simple query: SELECT name, email FROM account WHERE status = 'active'
  * {
@@ -413,6 +444,19 @@ exports.FieldNodeSchema = zod_1.z.lazy(() => zod_1.z.union([
  *   limit: 20,
  *   offset: 40
  * }
+ *
+ * @example
+ * // Full-text search
+ * {
+ *   object: 'article',
+ *   search: {
+ *     query: "machine learning",
+ *     fields: ["title", "content"],
+ *     fuzzy: true,
+ *     boost: { "title": 2.0 }
+ *   },
+ *   limit: 10
+ * }
  */
 exports.QuerySchema = zod_1.z.object({
     /** Target Entity */
@@ -421,6 +465,8 @@ exports.QuerySchema = zod_1.z.object({
     fields: zod_1.z.array(exports.FieldNodeSchema).optional().describe('Fields to retrieve'),
     /** Where Clause (Filtering) */
     where: filter_zod_1.FilterConditionSchema.optional().describe('Filtering criteria (WHERE)'),
+    /** Full-Text Search */
+    search: exports.FullTextSearchSchema.optional().describe('Full-text search configuration ($search parameter)'),
     /** Order By Clause (Sorting) */
     orderBy: zod_1.z.array(exports.SortNodeSchema).optional().describe('Sorting instructions (ORDER BY)'),
     /** Pagination */

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

@@ -65,22 +65,22 @@ export declare const UniquenessValidationSchema: z.ZodObject<{
     events: ("insert" | "update" | "delete")[];
     severity: "error" | "warning" | "info";
     caseSensitive: boolean;
+    scope?: string | undefined;
     tags?: string[] | undefined;
     label?: string | undefined;
     description?: string | undefined;
-    scope?: string | undefined;
 }, {
     message: string;
     type: "unique";
     fields: string[];
     name: string;
+    scope?: string | undefined;
     tags?: string[] | undefined;
     label?: string | undefined;
     description?: string | undefined;
     active?: boolean | undefined;
     events?: ("insert" | "update" | "delete")[] | undefined;
     severity?: "error" | "warning" | "info" | undefined;
-    scope?: string | undefined;
     caseSensitive?: boolean | undefined;
 }>;
 /**