@objectstack/spec 6.5.1 → 6.7.0

package/dist/automation/index.d.mts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { F as Flow, a as FlowEdge, b as FlowEdgeParsed, c as FlowEdgeSchema, d as FlowNode, e as FlowNodeAction, f as FlowNodeParsed, g as FlowNodeSchema, h as FlowParsed, i as FlowSchema, j as FlowVariableSchema, k as FlowVersionHistory, l as FlowVersionHistoryParsed, m as FlowVersionHistorySchema, n as defineFlow } from '../flow.zod-BFCtGdYw.mjs';
+export { F as Flow, a as FlowEdge, b as FlowEdgeParsed, c as FlowEdgeSchema, d as FlowNode, e as FlowNodeAction, f as FlowNodeParsed, g as FlowNodeSchema, h as FlowParsed, i as FlowSchema, j as FlowVariableSchema, k as FlowVersionHistory, l as FlowVersionHistoryParsed, m as FlowVersionHistorySchema, n as defineFlow } from '../flow.zod-LPphSOut.mjs';
 export { C as Checkpoint, a as CheckpointParsed, b as CheckpointSchema, c as ConcurrencyPolicy, d as ConcurrencyPolicyParsed, e as ConcurrencyPolicySchema, E as ExecutionError, f as ExecutionErrorParsed, g as ExecutionErrorSchema, h as ExecutionErrorSeverity, i as ExecutionLog, j as ExecutionLogParsed, k as ExecutionLogSchema, l as ExecutionStatus, m as ExecutionStepLog, n as ExecutionStepLogParsed, o as ExecutionStepLogSchema, S as ScheduleState, p as ScheduleStateParsed, q as ScheduleStateSchema } from '../execution.zod-DGGOFfcb.mjs';
 import { C as CronExpressionInput, E as Expression } from '../expression.zod-urRSkCql.mjs';
 export { A as ActionRef, a as ActionRefSchema, E as EventSchema, G as GuardRefSchema, S as StateMachineConfig, b as StateMachineSchema, c as StateNodeConfig, d as StateNodeSchema, T as Transition, e as TransitionSchema } from '../state-machine.zod-BNanU03M.mjs';

package/dist/automation/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { F as Flow, a as FlowEdge, b as FlowEdgeParsed, c as FlowEdgeSchema, d as FlowNode, e as FlowNodeAction, f as FlowNodeParsed, g as FlowNodeSchema, h as FlowParsed, i as FlowSchema, j as FlowVariableSchema, k as FlowVersionHistory, l as FlowVersionHistoryParsed, m as FlowVersionHistorySchema, n as defineFlow } from '../flow.zod-BFCtGdYw.js';
+export { F as Flow, a as FlowEdge, b as FlowEdgeParsed, c as FlowEdgeSchema, d as FlowNode, e as FlowNodeAction, f as FlowNodeParsed, g as FlowNodeSchema, h as FlowParsed, i as FlowSchema, j as FlowVariableSchema, k as FlowVersionHistory, l as FlowVersionHistoryParsed, m as FlowVersionHistorySchema, n as defineFlow } from '../flow.zod-LPphSOut.js';
 export { C as Checkpoint, a as CheckpointParsed, b as CheckpointSchema, c as ConcurrencyPolicy, d as ConcurrencyPolicyParsed, e as ConcurrencyPolicySchema, E as ExecutionError, f as ExecutionErrorParsed, g as ExecutionErrorSchema, h as ExecutionErrorSeverity, i as ExecutionLog, j as ExecutionLogParsed, k as ExecutionLogSchema, l as ExecutionStatus, m as ExecutionStepLog, n as ExecutionStepLogParsed, o as ExecutionStepLogSchema, S as ScheduleState, p as ScheduleStateParsed, q as ScheduleStateSchema } from '../execution.zod-DGGOFfcb.js';
 import { C as CronExpressionInput, E as Expression } from '../expression.zod-urRSkCql.js';
 export { A as ActionRef, a as ActionRefSchema, E as EventSchema, G as GuardRefSchema, S as StateMachineConfig, b as StateMachineSchema, c as StateNodeConfig, d as StateNodeSchema, T as Transition, e as TransitionSchema } from '../state-machine.zod-BNanU03M.js';

package/dist/cloud/index.d.mts

@@ -8876,6 +8876,12 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                             left: "left";
                             right: "right";
                         }>>;
+                        variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                            primary: "primary";
+                            comparison: "comparison";
+                        }>>>;
+                        dashArray: z.ZodOptional<z.ZodString>;
+                        opacity: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>>;
                     colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     height: z.ZodOptional<z.ZodNumber>;
@@ -8935,7 +8941,17 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                 actionIcon: z.ZodOptional<z.ZodString>;
                 object: z.ZodOptional<z.ZodString>;
                 filter: z.ZodOptional<z.ZodType<FilterCondition, unknown, z.core.$ZodTypeInternals<FilterCondition, unknown>>>;
+                compareTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"previousPeriod">, z.ZodLiteral<"previousYear">, z.ZodObject<{
+                    offset: z.ZodString;
+                }, z.core.$strip>]>>;
                 categoryField: z.ZodOptional<z.ZodString>;
+                categoryGranularity: z.ZodOptional<z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    quarter: "quarter";
+                    year: "year";
+                }>>;
                 valueField: z.ZodOptional<z.ZodString>;
                 aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                     count: "count";
@@ -9255,6 +9271,12 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                         left: "left";
                         right: "right";
                     }>>;
+                    variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                        primary: "primary";
+                        comparison: "comparison";
+                    }>>>;
+                    dashArray: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 height: z.ZodOptional<z.ZodNumber>;
@@ -10256,11 +10278,11 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                 type: z.ZodEnum<{
                     decision: "decision";
                     script: "script";
-                    connector_action: "connector_action";
+                    loop: "loop";
                     start: "start";
                     end: "end";
+                    connector_action: "connector_action";
                     assignment: "assignment";
-                    loop: "loop";
                     create_record: "create_record";
                     update_record: "update_record";
                     delete_record: "delete_record";

package/dist/cloud/index.d.ts

@@ -8876,6 +8876,12 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                             left: "left";
                             right: "right";
                         }>>;
+                        variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                            primary: "primary";
+                            comparison: "comparison";
+                        }>>>;
+                        dashArray: z.ZodOptional<z.ZodString>;
+                        opacity: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>>;
                     colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     height: z.ZodOptional<z.ZodNumber>;
@@ -8935,7 +8941,17 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                 actionIcon: z.ZodOptional<z.ZodString>;
                 object: z.ZodOptional<z.ZodString>;
                 filter: z.ZodOptional<z.ZodType<FilterCondition, unknown, z.core.$ZodTypeInternals<FilterCondition, unknown>>>;
+                compareTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"previousPeriod">, z.ZodLiteral<"previousYear">, z.ZodObject<{
+                    offset: z.ZodString;
+                }, z.core.$strip>]>>;
                 categoryField: z.ZodOptional<z.ZodString>;
+                categoryGranularity: z.ZodOptional<z.ZodEnum<{
+                    day: "day";
+                    week: "week";
+                    month: "month";
+                    quarter: "quarter";
+                    year: "year";
+                }>>;
                 valueField: z.ZodOptional<z.ZodString>;
                 aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                     count: "count";
@@ -9255,6 +9271,12 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                         left: "left";
                         right: "right";
                     }>>;
+                    variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                        primary: "primary";
+                        comparison: "comparison";
+                    }>>>;
+                    dashArray: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 height: z.ZodOptional<z.ZodNumber>;
@@ -10256,11 +10278,11 @@ declare const EnvironmentArtifactSchema: z.ZodObject<{
                 type: z.ZodEnum<{
                     decision: "decision";
                     script: "script";
-                    connector_action: "connector_action";
+                    loop: "loop";
                     start: "start";
                     end: "end";
+                    connector_action: "connector_action";
                     assignment: "assignment";
-                    loop: "loop";
                     create_record: "create_record";
                     update_record: "update_record";
                     delete_record: "delete_record";

package/dist/cloud/index.js

@@ -6243,6 +6243,136 @@ var PageSchema = lazySchema(() => zod.z.object({
     });
   }
 }));
+var SortNodeSchema = lazySchema(() => zod.z.object({
+  field: zod.z.string(),
+  order: zod.z.enum(["asc", "desc"]).default("asc")
+}));
+var AggregationFunction = zod.z.enum([
+  "count",
+  "sum",
+  "avg",
+  "min",
+  "max",
+  "count_distinct",
+  "array_agg",
+  "string_agg"
+]);
+var DateGranularity = zod.z.enum(["day", "week", "month", "quarter", "year"]);
+var GroupByNodeSchema = lazySchema(() => zod.z.union([
+  zod.z.string(),
+  zod.z.object({
+    field: zod.z.string().describe("Field to group by"),
+    dateGranularity: DateGranularity.optional().describe("Bucket date values into uniform periods (day/week/month/quarter/year)"),
+    /** Optional alias for the projected group value (defaults to `field`). */
+    alias: zod.z.string().optional().describe("Alias for the projected group value")
+  })
+]));
+var AggregationNodeSchema = lazySchema(() => zod.z.object({
+  function: AggregationFunction.describe("Aggregation function"),
+  field: zod.z.string().optional().describe("Field to aggregate (optional for COUNT(*))"),
+  alias: zod.z.string().describe("Result column alias"),
+  distinct: zod.z.boolean().optional().describe("Apply DISTINCT before aggregation"),
+  filter: FilterConditionSchema.optional().describe("Filter/Condition to apply to the aggregation (FILTER WHERE clause)")
+}));
+var JoinType = zod.z.enum(["inner", "left", "right", "full"]);
+var JoinStrategy = zod.z.enum(["auto", "database", "hash", "loop"]);
+var JoinNodeSchema = zod.z.lazy(
+  () => zod.z.object({
+    type: JoinType.describe("Join type"),
+    strategy: JoinStrategy.optional().describe("Execution strategy hint"),
+    object: zod.z.string().describe("Object/table to join"),
+    alias: zod.z.string().optional().describe("Table alias"),
+    on: FilterConditionSchema.describe("Join condition"),
+    subquery: zod.z.lazy(() => QuerySchema).optional().describe("Subquery instead of object")
+  })
+);
+var WindowFunction = zod.z.enum([
+  "row_number",
+  "rank",
+  "dense_rank",
+  "percent_rank",
+  "lag",
+  "lead",
+  "first_value",
+  "last_value",
+  "sum",
+  "avg",
+  "count",
+  "min",
+  "max"
+]);
+var WindowSpecSchema = lazySchema(() => zod.z.object({
+  partitionBy: zod.z.array(zod.z.string()).optional().describe("PARTITION BY fields"),
+  orderBy: zod.z.array(SortNodeSchema).optional().describe("ORDER BY specification"),
+  frame: zod.z.object({
+    type: zod.z.enum(["rows", "range"]).optional(),
+    start: zod.z.string().optional().describe('Frame start (e.g., "UNBOUNDED PRECEDING", "1 PRECEDING")'),
+    end: zod.z.string().optional().describe('Frame end (e.g., "CURRENT ROW", "1 FOLLOWING")')
+  }).optional().describe("Window frame specification")
+}));
+var WindowFunctionNodeSchema = lazySchema(() => zod.z.object({
+  function: WindowFunction.describe("Window function name"),
+  field: zod.z.string().optional().describe("Field to operate on (for aggregate window functions)"),
+  alias: zod.z.string().describe("Result column alias"),
+  over: WindowSpecSchema.describe("Window specification (OVER clause)")
+}));
+var FieldNodeSchema = zod.z.lazy(
+  () => zod.z.union([
+    zod.z.string(),
+    // Primitive field: "name"
+    zod.z.object({
+      field: zod.z.string(),
+      // Relationship field: "owner"
+      fields: zod.z.array(FieldNodeSchema).optional(),
+      // Nested select: ["name", "email"]
+      alias: zod.z.string().optional()
+    })
+  ])
+);
+var FullTextSearchSchema = lazySchema(() => zod.z.object({
+  query: zod.z.string().describe("Search query text"),
+  fields: zod.z.array(zod.z.string()).optional().describe("Fields to search in (if not specified, searches all text fields)"),
+  fuzzy: zod.z.boolean().optional().default(false).describe("Enable fuzzy matching (tolerates typos)"),
+  operator: zod.z.enum(["and", "or"]).optional().default("or").describe("Logical operator between terms"),
+  boost: zod.z.record(zod.z.string(), zod.z.number()).optional().describe("Field-specific relevance boosting (field name -> boost factor)"),
+  minScore: zod.z.number().optional().describe("Minimum relevance score threshold"),
+  language: zod.z.string().optional().describe('Language for text analysis (e.g., "en", "zh", "es")'),
+  highlight: zod.z.boolean().optional().default(false).describe("Enable search result highlighting")
+}));
+var BaseQuerySchema = zod.z.object({
+  /** Target Entity */
+  object: zod.z.string().describe("Object name (e.g. account)"),
+  /** Select Clause */
+  fields: zod.z.array(FieldNodeSchema).optional().describe("Fields to retrieve"),
+  /** Where Clause (Filtering) */
+  where: FilterConditionSchema.optional().describe("Filtering criteria (WHERE)"),
+  /** Full-Text Search */
+  search: FullTextSearchSchema.optional().describe("Full-text search configuration ($search parameter)"),
+  /** Order By Clause (Sorting) */
+  orderBy: zod.z.array(SortNodeSchema).optional().describe("Sorting instructions (ORDER BY)"),
+  /** Pagination */
+  limit: zod.z.number().optional().describe("Max records to return (LIMIT)"),
+  offset: zod.z.number().optional().describe("Records to skip (OFFSET)"),
+  top: zod.z.number().optional().describe("Alias for limit (OData compatibility)"),
+  cursor: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Cursor for keyset pagination"),
+  /** Joins */
+  joins: zod.z.array(JoinNodeSchema).optional().describe("Explicit Table Joins"),
+  /** Aggregations */
+  aggregations: zod.z.array(AggregationNodeSchema).optional().describe("Aggregation functions"),
+  /** Group By Clause */
+  groupBy: zod.z.array(GroupByNodeSchema).optional().describe("GROUP BY targets (strings or `{field, dateGranularity?}` objects for date bucketing)"),
+  /** Having Clause */
+  having: FilterConditionSchema.optional().describe("HAVING clause for aggregation filtering"),
+  /** Window Functions */
+  windowFunctions: zod.z.array(WindowFunctionNodeSchema).optional().describe("Window functions with OVER clause"),
+  /** Subquery flag */
+  distinct: zod.z.boolean().optional().describe("SELECT DISTINCT flag")
+});
+var QuerySchema = lazySchema(() => BaseQuerySchema.extend({
+  expand: zod.z.lazy(() => zod.z.record(zod.z.string(), QuerySchema)).optional().describe(
+    "Recursive relation loading map. Keys are lookup/master_detail field names; values are nested QueryAST objects that control select, filter, sort, and further expansion on the related object. The engine resolves expand via batch $in queries (driver-agnostic) with a default max depth of 3."
+  )
+}));
 var ChartTypeSchema = lazySchema(() => zod.z.enum([
   // Comparison
   "bar",
@@ -6321,7 +6451,22 @@ var ChartSeriesSchema = lazySchema(() => zod.z.object({
   /** Stacking group */
   stack: zod.z.string().optional().describe("Stack identifier to group series"),
   /** Axis binding */
-  yAxis: zod.z.enum(["left", "right"]).default("left").describe("Bind to specific Y-Axis")
+  yAxis: zod.z.enum(["left", "right"]).default("left").describe("Bind to specific Y-Axis"),
+  /**
+   * Series role.
+   *
+   * - `'primary'` (default) — normal styling using the chart palette.
+   * - `'comparison'` — secondary period-over-period overlay; renderers
+   *   render it muted (lower opacity, dashed stroke for line/area,
+   *   lighter fill for bars) so it visually backgrounds against the
+   *   primary series. Pair with `DashboardWidget.compareTo` on data-
+   *   bound charts; for hand-authored series, set it directly.
+   */
+  variant: zod.z.enum(["primary", "comparison"]).default("primary").optional().describe("Series visual role"),
+  /** Override stroke dash pattern (e.g. "4 4" for dashed lines). */
+  dashArray: zod.z.string().optional().describe("SVG stroke-dasharray override"),
+  /** Override series opacity (0–1). */
+  opacity: zod.z.number().min(0).max(1).optional().describe("Series opacity override")
 }));
 var ChartAnnotationSchema = lazySchema(() => zod.z.object({
   type: zod.z.enum(["line", "region"]).default("line"),
@@ -6452,8 +6597,46 @@ var DashboardWidgetSchema = lazySchema(() => zod.z.object({
   object: zod.z.string().optional().describe("Data source object name"),
   /** Data Filter (MongoDB-style FilterCondition) */
   filter: FilterConditionSchema.optional().describe("Data filter criteria"),
+  /**
+   * Period-over-period comparison primitive.
+   *
+   * When set, the renderer runs a second query against a shifted time
+   * window and surfaces the delta (metric widgets show a secondary
+   * value + arrow; chart widgets render a muted/dashed overlay series).
+   *
+   * - `'previousPeriod'` — auto-detect the comparison window from the
+   *   widget's `filter` date macros (e.g. `{current_month_start}` →
+   *   `{last_month_start}`). Falls back to no comparison when the
+   *   filter contains no resolvable date range.
+   * - `'previousYear'` — shift the resolved filter window back by one
+   *   calendar year.
+   * - `{ offset: '7d' | '1M' | '1y' }` — shift by an explicit
+   *   ISO-8601-like duration. Units: `d` (days), `w` (weeks),
+   *   `M` (months), `y` (years).
+   */
+  compareTo: zod.z.union([
+    zod.z.literal("previousPeriod"),
+    zod.z.literal("previousYear"),
+    zod.z.object({
+      offset: zod.z.string().regex(/^\d+[dwMy]$/, 'Offset must match <N>(d|w|M|y), e.g. "7d", "1M", "1y"')
+    })
+  ]).optional().describe("Period-over-period comparison window"),
   /** Category Field (X-Axis / Group By) */
   categoryField: zod.z.string().optional().describe("Field for grouping (X-Axis)"),
+  /**
+   * Date Bucketing Granularity for `categoryField`
+   *
+   * When set and `categoryField` references a date/datetime field, the engine
+   * buckets values into uniform `day` / `week` / `month` / `quarter` / `year`
+   * periods server-side (PostgreSQL `date_trunc`, MySQL `date_format`, SQLite
+   * `strftime`, MongoDB `$dateTrunc`; falls back to in-memory ISO-8601
+   * bucketing otherwise). Without this, raw timestamps are grouped verbatim
+   * which typically yields one bucket per row — making time-series charts
+   * appear flat.
+   *
+   * Mirrors the `dateGranularity` shape of {@link GroupByNodeSchema}.
+   */
+  categoryGranularity: DateGranularity.optional().describe("Bucket categoryField date values into day/week/month/quarter/year periods"),
   /** Value Field (Y-Axis) */
   valueField: zod.z.string().optional().describe("Field for values (Y-Axis)"),
   /** Aggregate operation */
@@ -8200,138 +8383,6 @@ lazySchema(() => zod.z.object({
     email: zod.z.string().optional()
   }).optional().describe("Current user info shortcut")
 }));
-var SortNodeSchema = lazySchema(() => zod.z.object({
-  field: zod.z.string(),
-  order: zod.z.enum(["asc", "desc"]).default("asc")
-}));
-var AggregationFunction = zod.z.enum([
-  "count",
-  "sum",
-  "avg",
-  "min",
-  "max",
-  "count_distinct",
-  "array_agg",
-  "string_agg"
-]);
-var DateGranularity = zod.z.enum(["day", "week", "month", "quarter", "year"]);
-var GroupByNodeSchema = lazySchema(() => zod.z.union([
-  zod.z.string(),
-  zod.z.object({
-    field: zod.z.string().describe("Field to group by"),
-    dateGranularity: DateGranularity.optional().describe("Bucket date values into uniform periods (day/week/month/quarter/year)"),
-    /** Optional alias for the projected group value (defaults to `field`). */
-    alias: zod.z.string().optional().describe("Alias for the projected group value")
-  })
-]));
-var AggregationNodeSchema = lazySchema(() => zod.z.object({
-  function: AggregationFunction.describe("Aggregation function"),
-  field: zod.z.string().optional().describe("Field to aggregate (optional for COUNT(*))"),
-  alias: zod.z.string().describe("Result column alias"),
-  distinct: zod.z.boolean().optional().describe("Apply DISTINCT before aggregation"),
-  filter: FilterConditionSchema.optional().describe("Filter/Condition to apply to the aggregation (FILTER WHERE clause)")
-}));
-var JoinType = zod.z.enum(["inner", "left", "right", "full"]);
-var JoinStrategy = zod.z.enum(["auto", "database", "hash", "loop"]);
-var JoinNodeSchema = zod.z.lazy(
-  () => zod.z.object({
-    type: JoinType.describe("Join type"),
-    strategy: JoinStrategy.optional().describe("Execution strategy hint"),
-    object: zod.z.string().describe("Object/table to join"),
-    alias: zod.z.string().optional().describe("Table alias"),
-    on: FilterConditionSchema.describe("Join condition"),
-    subquery: zod.z.lazy(() => QuerySchema).optional().describe("Subquery instead of object")
-  })
-);
-var WindowFunction = zod.z.enum([
-  "row_number",
-  "rank",
-  "dense_rank",
-  "percent_rank",
-  "lag",
-  "lead",
-  "first_value",
-  "last_value",
-  "sum",
-  "avg",
-  "count",
-  "min",
-  "max"
-]);
-var WindowSpecSchema = lazySchema(() => zod.z.object({
-  partitionBy: zod.z.array(zod.z.string()).optional().describe("PARTITION BY fields"),
-  orderBy: zod.z.array(SortNodeSchema).optional().describe("ORDER BY specification"),
-  frame: zod.z.object({
-    type: zod.z.enum(["rows", "range"]).optional(),
-    start: zod.z.string().optional().describe('Frame start (e.g., "UNBOUNDED PRECEDING", "1 PRECEDING")'),
-    end: zod.z.string().optional().describe('Frame end (e.g., "CURRENT ROW", "1 FOLLOWING")')
-  }).optional().describe("Window frame specification")
-}));
-var WindowFunctionNodeSchema = lazySchema(() => zod.z.object({
-  function: WindowFunction.describe("Window function name"),
-  field: zod.z.string().optional().describe("Field to operate on (for aggregate window functions)"),
-  alias: zod.z.string().describe("Result column alias"),
-  over: WindowSpecSchema.describe("Window specification (OVER clause)")
-}));
-var FieldNodeSchema = zod.z.lazy(
-  () => zod.z.union([
-    zod.z.string(),
-    // Primitive field: "name"
-    zod.z.object({
-      field: zod.z.string(),
-      // Relationship field: "owner"
-      fields: zod.z.array(FieldNodeSchema).optional(),
-      // Nested select: ["name", "email"]
-      alias: zod.z.string().optional()
-    })
-  ])
-);
-var FullTextSearchSchema = lazySchema(() => zod.z.object({
-  query: zod.z.string().describe("Search query text"),
-  fields: zod.z.array(zod.z.string()).optional().describe("Fields to search in (if not specified, searches all text fields)"),
-  fuzzy: zod.z.boolean().optional().default(false).describe("Enable fuzzy matching (tolerates typos)"),
-  operator: zod.z.enum(["and", "or"]).optional().default("or").describe("Logical operator between terms"),
-  boost: zod.z.record(zod.z.string(), zod.z.number()).optional().describe("Field-specific relevance boosting (field name -> boost factor)"),
-  minScore: zod.z.number().optional().describe("Minimum relevance score threshold"),
-  language: zod.z.string().optional().describe('Language for text analysis (e.g., "en", "zh", "es")'),
-  highlight: zod.z.boolean().optional().default(false).describe("Enable search result highlighting")
-}));
-var BaseQuerySchema = zod.z.object({
-  /** Target Entity */
-  object: zod.z.string().describe("Object name (e.g. account)"),
-  /** Select Clause */
-  fields: zod.z.array(FieldNodeSchema).optional().describe("Fields to retrieve"),
-  /** Where Clause (Filtering) */
-  where: FilterConditionSchema.optional().describe("Filtering criteria (WHERE)"),
-  /** Full-Text Search */
-  search: FullTextSearchSchema.optional().describe("Full-text search configuration ($search parameter)"),
-  /** Order By Clause (Sorting) */
-  orderBy: zod.z.array(SortNodeSchema).optional().describe("Sorting instructions (ORDER BY)"),
-  /** Pagination */
-  limit: zod.z.number().optional().describe("Max records to return (LIMIT)"),
-  offset: zod.z.number().optional().describe("Records to skip (OFFSET)"),
-  top: zod.z.number().optional().describe("Alias for limit (OData compatibility)"),
-  cursor: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Cursor for keyset pagination"),
-  /** Joins */
-  joins: zod.z.array(JoinNodeSchema).optional().describe("Explicit Table Joins"),
-  /** Aggregations */
-  aggregations: zod.z.array(AggregationNodeSchema).optional().describe("Aggregation functions"),
-  /** Group By Clause */
-  groupBy: zod.z.array(GroupByNodeSchema).optional().describe("GROUP BY targets (strings or `{field, dateGranularity?}` objects for date bucketing)"),
-  /** Having Clause */
-  having: FilterConditionSchema.optional().describe("HAVING clause for aggregation filtering"),
-  /** Window Functions */
-  windowFunctions: zod.z.array(WindowFunctionNodeSchema).optional().describe("Window functions with OVER clause"),
-  /** Subquery flag */
-  distinct: zod.z.boolean().optional().describe("SELECT DISTINCT flag")
-});
-var QuerySchema = lazySchema(() => BaseQuerySchema.extend({
-  expand: zod.z.lazy(() => zod.z.record(zod.z.string(), QuerySchema)).optional().describe(
-    "Recursive relation loading map. Keys are lookup/master_detail field names; values are nested QueryAST objects that control select, filter, sort, and further expansion on the related object. The engine resolves expand via batch $in queries (driver-agnostic) with a default max depth of 3."
-  )
-}));
-
-// src/data/mapping.zod.ts
 var TransformType = zod.z.enum([
   "none",
   // Direct copy