@objectstack/spec 0.1.2 → 0.2.0

package/dist/system/datasource.zod.js

@@ -48,18 +48,37 @@ exports.DriverDefinitionSchema = zod_1.z.object({
  * and what to compute in memory.
  */
 exports.DatasourceCapabilities = zod_1.z.object({
-    /** Can execute SQL-like joins natively? */
-    joins: zod_1.z.boolean().default(false),
+    // ============================================================================
+    // Transaction & Connection Management
+    // ============================================================================
     /** Can handle ACID transactions? */
     transactions: zod_1.z.boolean().default(false),
+    // ============================================================================
+    // Query Operations
+    // ============================================================================
+    /** Can execute WHERE clause filters natively? */
+    queryFilters: zod_1.z.boolean().default(false),
+    /** Can perform aggregation (group by, sum, avg)? */
+    queryAggregations: zod_1.z.boolean().default(false),
+    /** Can perform ORDER BY sorting? */
+    querySorting: zod_1.z.boolean().default(false),
+    /** Can perform LIMIT/OFFSET pagination? */
+    queryPagination: zod_1.z.boolean().default(false),
+    /** Can perform window functions? */
+    queryWindowFunctions: zod_1.z.boolean().default(false),
+    /** Can perform subqueries? */
+    querySubqueries: zod_1.z.boolean().default(false),
+    /** Can execute SQL-like joins natively? */
+    joins: zod_1.z.boolean().default(false),
+    // ============================================================================
+    // Advanced Features
+    // ============================================================================
     /** Can perform full-text search? */
     fullTextSearch: zod_1.z.boolean().default(false),
-    /** Can perform aggregation (group by, sum, avg)? */
-    aggregation: zod_1.z.boolean().default(false),
-    /** Is scheme-less (needs schema inference)? */
-    dynamicSchema: zod_1.z.boolean().default(false),
     /** Is read-only? */
     readOnly: zod_1.z.boolean().default(false),
+    /** Is scheme-less (needs schema inference)? */
+    dynamicSchema: zod_1.z.boolean().default(false),
 });
 /**
  * Datasource Schema

package/dist/system/driver.zod.d.ts

@@ -38,6 +38,38 @@ export declare const DriverCapabilitiesSchema: z.ZodObject<{
      * If true, beginTransaction, commit, and rollback must be implemented.
      */
     transactions: z.ZodBoolean;
+    /**
+     * Whether the driver supports WHERE clause filters.
+     * If false, ObjectQL will fetch all records and filter in memory.
+     *
+     * Example: Memory driver might not support complex filter conditions.
+     */
+    queryFilters: z.ZodBoolean;
+    /**
+     * Whether the driver supports aggregation functions (COUNT, SUM, AVG, etc.).
+     * If false, ObjectQL will compute aggregations in memory.
+     */
+    queryAggregations: z.ZodBoolean;
+    /**
+     * Whether the driver supports ORDER BY sorting.
+     * If false, ObjectQL will sort results in memory.
+     */
+    querySorting: z.ZodBoolean;
+    /**
+     * Whether the driver supports LIMIT/OFFSET pagination.
+     * If false, ObjectQL will fetch all records and paginate in memory.
+     */
+    queryPagination: z.ZodBoolean;
+    /**
+     * Whether the driver supports window functions (ROW_NUMBER, RANK, LAG, LEAD, etc.).
+     * If false, ObjectQL will compute window functions in memory.
+     */
+    queryWindowFunctions: z.ZodBoolean;
+    /**
+     * Whether the driver supports subqueries (nested SELECT statements).
+     * If false, ObjectQL will execute queries separately and combine results.
+     */
+    querySubqueries: z.ZodBoolean;
     /**
      * Whether the driver supports SQL-style joins.
      * If false, ObjectQL will fetch related data separately and join in memory.
@@ -61,12 +93,24 @@ export declare const DriverCapabilitiesSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     joins: boolean;
     transactions: boolean;
+    queryFilters: boolean;
+    queryAggregations: boolean;
+    querySorting: boolean;
+    queryPagination: boolean;
+    queryWindowFunctions: boolean;
+    querySubqueries: boolean;
     fullTextSearch: boolean;
     jsonFields: boolean;
     arrayFields: boolean;
 }, {
     joins: boolean;
     transactions: boolean;
+    queryFilters: boolean;
+    queryAggregations: boolean;
+    querySorting: boolean;
+    queryPagination: boolean;
+    queryWindowFunctions: boolean;
+    querySubqueries: boolean;
     fullTextSearch: boolean;
     jsonFields: boolean;
     arrayFields: boolean;
@@ -95,6 +139,38 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
          * If true, beginTransaction, commit, and rollback must be implemented.
          */
         transactions: z.ZodBoolean;
+        /**
+         * Whether the driver supports WHERE clause filters.
+         * If false, ObjectQL will fetch all records and filter in memory.
+         *
+         * Example: Memory driver might not support complex filter conditions.
+         */
+        queryFilters: z.ZodBoolean;
+        /**
+         * Whether the driver supports aggregation functions (COUNT, SUM, AVG, etc.).
+         * If false, ObjectQL will compute aggregations in memory.
+         */
+        queryAggregations: z.ZodBoolean;
+        /**
+         * Whether the driver supports ORDER BY sorting.
+         * If false, ObjectQL will sort results in memory.
+         */
+        querySorting: z.ZodBoolean;
+        /**
+         * Whether the driver supports LIMIT/OFFSET pagination.
+         * If false, ObjectQL will fetch all records and paginate in memory.
+         */
+        queryPagination: z.ZodBoolean;
+        /**
+         * Whether the driver supports window functions (ROW_NUMBER, RANK, LAG, LEAD, etc.).
+         * If false, ObjectQL will compute window functions in memory.
+         */
+        queryWindowFunctions: z.ZodBoolean;
+        /**
+         * Whether the driver supports subqueries (nested SELECT statements).
+         * If false, ObjectQL will execute queries separately and combine results.
+         */
+        querySubqueries: z.ZodBoolean;
         /**
          * Whether the driver supports SQL-style joins.
          * If false, ObjectQL will fetch related data separately and join in memory.
@@ -118,12 +194,24 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
         jsonFields: boolean;
         arrayFields: boolean;
     }, {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
         jsonFields: boolean;
         arrayFields: boolean;
@@ -195,6 +283,8 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
      *   sort: [{ field: 'created_at', order: 'desc' }],
      *   top: 10
      * });
+     * @returns Array of records.
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     find: z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodObject<{
         object: z.ZodString;
@@ -421,6 +511,8 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
      * @param object - The name of the object.
      * @param query - QueryAST.
      * @param options - Driver options.
+     * @returns The record or null.
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     findOne: z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodObject<{
         object: z.ZodString;
@@ -647,6 +739,7 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
      * @param data - Key-value map of field data.
      * @param options - Driver options.
      * @returns The created record, including server-generated fields (id, created_at, etc.).
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     create: z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodOptional<z.ZodObject<{
         /**
@@ -679,6 +772,7 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
      * @param data - The fields to update.
      * @param options - Driver options.
      * @returns The updated record.
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     update: z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>, z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodOptional<z.ZodObject<{
         /**
@@ -1263,6 +1357,12 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
     supports: {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
         jsonFields: boolean;
         arrayFields: boolean;
@@ -1453,6 +1553,12 @@ export declare const DriverInterfaceSchema: z.ZodObject<{
     supports: {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
         jsonFields: boolean;
         arrayFields: boolean;

package/dist/system/driver.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.zod.d.ts","sourceRoot":"","sources":["../../src/system/driver.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;;;;;;;;;EAEH,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;IACnC;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;QAlDH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;;;;;;;;;;;;;IA8BH;;OAEG;;IAKH;;OAEG;;IAKH;;;OAGG;;IASH;;;;;;;;;;;;;;;OAeG;;QA1HH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAuHH;;;;;;;;;;;;;;;OAeG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAnJH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA4IH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAhKH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAyJH;;;;;;;OAOG;;QA7KH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAsKH;;;;;;;;OAQG;;QA3LH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAoLH;;;;;;;OAOG;;QAxMH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAiMH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QArNH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAkNH;;;;;;;OAOG;;QAtOH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA8NH;;;;;;OAMG;;;;;;;;;;;QAjPH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAyOH;;;;;OAKG;;QA3PH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAuPH;;;OAGG;;IAKH;;;OAGG;;IAMH;;;OAGG;;IAUH;;;;;;;;OAQG;;QA1SH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAmSH;;;;;OAKG;;QArTH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4SH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"driver.zod.d.ts","sourceRoot":"","sources":["../../src/system/driver.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;;;;;;;;;EAEH,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;IAKnC;;;OAGG;;IAOH;;;;;OAKG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAOH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;IAChC;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;QAhGH;;;WAGG;;QAOH;;;;;WAKG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAOH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BH;;OAEG;;IAKH;;OAEG;;IAKH;;;OAGG;;IASH;;;;;;;;;;;;;;;OAeG;;QA5KH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAyKH;;;;;;;;;;;;;;;;;OAiBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAvMH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAgMH;;;;;;;;;OASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAtNH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA+MH;;;;;;;;OAQG;;QApOH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA6NH;;;;;;;;;OASG;;QAnPH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA4OH;;;;;;;OAOG;;QAhQH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAyPH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA7QH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA0QH;;;;;;;OAOG;;QA9RH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAsRH;;;;;;OAMG;;;;;;;;;;;QAzSH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IAiSH;;;;;OAKG;;QAnTH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA+SH;;;OAGG;;IAKH;;;OAGG;;IAMH;;;OAGG;;IAUH;;;;;;;;OAQG;;QAlWH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;IA2VH;;;;;OAKG;;QA7WH;;;WAGG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoWH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/system/driver.zod.js

@@ -29,16 +29,57 @@ exports.DriverOptionsSchema = zod_1.z.object({
  * This allows ObjectQL to adapt its behavior based on underlying database capabilities.
  */
 exports.DriverCapabilitiesSchema = zod_1.z.object({
+    // ============================================================================
+    // Transaction & Connection Management
+    // ============================================================================
     /**
      * Whether the driver supports database transactions.
      * If true, beginTransaction, commit, and rollback must be implemented.
      */
     transactions: zod_1.z.boolean().describe('Supports transactions'),
+    // ============================================================================
+    // Query Operations
+    // ============================================================================
+    /**
+     * Whether the driver supports WHERE clause filters.
+     * If false, ObjectQL will fetch all records and filter in memory.
+     *
+     * Example: Memory driver might not support complex filter conditions.
+     */
+    queryFilters: zod_1.z.boolean().describe('Supports WHERE clause filtering'),
+    /**
+     * Whether the driver supports aggregation functions (COUNT, SUM, AVG, etc.).
+     * If false, ObjectQL will compute aggregations in memory.
+     */
+    queryAggregations: zod_1.z.boolean().describe('Supports GROUP BY and aggregation functions'),
+    /**
+     * Whether the driver supports ORDER BY sorting.
+     * If false, ObjectQL will sort results in memory.
+     */
+    querySorting: zod_1.z.boolean().describe('Supports ORDER BY sorting'),
+    /**
+     * Whether the driver supports LIMIT/OFFSET pagination.
+     * If false, ObjectQL will fetch all records and paginate in memory.
+     */
+    queryPagination: zod_1.z.boolean().describe('Supports LIMIT/OFFSET pagination'),
+    /**
+     * Whether the driver supports window functions (ROW_NUMBER, RANK, LAG, LEAD, etc.).
+     * If false, ObjectQL will compute window functions in memory.
+     */
+    queryWindowFunctions: zod_1.z.boolean().describe('Supports window functions with OVER clause'),
+    /**
+     * Whether the driver supports subqueries (nested SELECT statements).
+     * If false, ObjectQL will execute queries separately and combine results.
+     */
+    querySubqueries: zod_1.z.boolean().describe('Supports subqueries'),
     /**
      * Whether the driver supports SQL-style joins.
      * If false, ObjectQL will fetch related data separately and join in memory.
      */
     joins: zod_1.z.boolean().describe('Supports SQL joins'),
+    // ============================================================================
+    // Advanced Features
+    // ============================================================================
     /**
      * Whether the driver supports full-text search.
      * If true, text search queries can be pushed to the database.
@@ -137,6 +178,8 @@ exports.DriverInterfaceSchema = zod_1.z.object({
      *   sort: [{ field: 'created_at', order: 'desc' }],
      *   top: 10
      * });
+     * @returns Array of records.
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     find: zod_1.z.function()
         .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
@@ -149,6 +192,8 @@ exports.DriverInterfaceSchema = zod_1.z.object({
      * @param object - The name of the object.
      * @param query - QueryAST.
      * @param options - Driver options.
+     * @returns The record or null.
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     findOne: zod_1.z.function()
         .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
@@ -161,6 +206,7 @@ exports.DriverInterfaceSchema = zod_1.z.object({
      * @param data - Key-value map of field data.
      * @param options - Driver options.
      * @returns The created record, including server-generated fields (id, created_at, etc.).
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     create: zod_1.z.function()
         .args(zod_1.z.string(), zod_1.z.record(zod_1.z.any()), exports.DriverOptionsSchema.optional())
@@ -174,6 +220,7 @@ exports.DriverInterfaceSchema = zod_1.z.object({
      * @param data - The fields to update.
      * @param options - Driver options.
      * @returns The updated record.
+     *          MUST return `id` as string. MUST NOT return implementation details like `_id`.
      */
     update: zod_1.z.function()
         .args(zod_1.z.string(), zod_1.z.string().or(zod_1.z.number()), zod_1.z.record(zod_1.z.any()), exports.DriverOptionsSchema.optional())

package/dist/system/policy.zod.d.ts

@@ -161,16 +161,16 @@ export declare const PolicySchema: z.ZodObject<{
         expirationDays?: number | undefined;
     } | undefined;
     assignedProfiles?: string[] | undefined;
-    network?: {
-        trustedRanges: string[];
-        blockUnknown: boolean;
-        vpnRequired: boolean;
-    } | undefined;
     session?: {
         idleTimeout: number;
         absoluteTimeout: number;
         forceMfa: boolean;
     } | undefined;
+    network?: {
+        trustedRanges: string[];
+        blockUnknown: boolean;
+        vpnRequired: boolean;
+    } | undefined;
     audit?: {
         logRetentionDays: number;
         sensitiveFields: string[];
@@ -189,16 +189,16 @@ export declare const PolicySchema: z.ZodObject<{
     } | undefined;
     isDefault?: boolean | undefined;
     assignedProfiles?: string[] | undefined;
-    network?: {
-        trustedRanges: string[];
-        blockUnknown?: boolean | undefined;
-        vpnRequired?: boolean | undefined;
-    } | undefined;
     session?: {
         idleTimeout?: number | undefined;
         absoluteTimeout?: number | undefined;
         forceMfa?: boolean | undefined;
     } | undefined;
+    network?: {
+        trustedRanges: string[];
+        blockUnknown?: boolean | undefined;
+        vpnRequired?: boolean | undefined;
+    } | undefined;
     audit?: {
         sensitiveFields: string[];
         logRetentionDays?: number | undefined;

package/dist/ui/dashboard.zod.d.ts

@@ -14,8 +14,8 @@ export declare const DashboardWidgetSchema: z.ZodObject<{
     type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>>;
     /** Data Source Object */
     object: z.ZodOptional<z.ZodString>;
-    /** Data Filter (ObjectQL JSON) */
-    filter: z.ZodOptional<z.ZodAny>;
+    /** Data Filter (MongoDB-style FilterCondition) */
+    filter: z.ZodOptional<z.ZodType<import("../data/filter.zod").FilterCondition, z.ZodTypeDef, import("../data/filter.zod").FilterCondition>>;
     /** Category Field (X-Axis / Group By) */
     categoryField: z.ZodOptional<z.ZodString>;
     /** Value Field (Y-Axis) */
@@ -57,7 +57,7 @@ export declare const DashboardWidgetSchema: z.ZodObject<{
         h: number;
     };
     object?: string | undefined;
-    filter?: any;
+    filter?: import("../data/filter.zod").FilterCondition | undefined;
     options?: any;
     title?: string | undefined;
     categoryField?: string | undefined;
@@ -70,7 +70,7 @@ export declare const DashboardWidgetSchema: z.ZodObject<{
         h: number;
     };
     object?: string | undefined;
-    filter?: any;
+    filter?: import("../data/filter.zod").FilterCondition | undefined;
     options?: any;
     type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
     aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
@@ -97,8 +97,8 @@ export declare const DashboardSchema: z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<["metric", "bar", "line", "pie", "donut", "funnel", "table", "text"]>>;
         /** Data Source Object */
         object: z.ZodOptional<z.ZodString>;
-        /** Data Filter (ObjectQL JSON) */
-        filter: z.ZodOptional<z.ZodAny>;
+        /** Data Filter (MongoDB-style FilterCondition) */
+        filter: z.ZodOptional<z.ZodType<import("../data/filter.zod").FilterCondition, z.ZodTypeDef, import("../data/filter.zod").FilterCondition>>;
         /** Category Field (X-Axis / Group By) */
         categoryField: z.ZodOptional<z.ZodString>;
         /** Value Field (Y-Axis) */
@@ -140,7 +140,7 @@ export declare const DashboardSchema: z.ZodObject<{
             h: number;
         };
         object?: string | undefined;
-        filter?: any;
+        filter?: import("../data/filter.zod").FilterCondition | undefined;
         options?: any;
         title?: string | undefined;
         categoryField?: string | undefined;
@@ -153,7 +153,7 @@ export declare const DashboardSchema: z.ZodObject<{
             h: number;
         };
         object?: string | undefined;
-        filter?: any;
+        filter?: import("../data/filter.zod").FilterCondition | undefined;
         options?: any;
         type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
         aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;
@@ -174,7 +174,7 @@ export declare const DashboardSchema: z.ZodObject<{
             h: number;
         };
         object?: string | undefined;
-        filter?: any;
+        filter?: import("../data/filter.zod").FilterCondition | undefined;
         options?: any;
         title?: string | undefined;
         categoryField?: string | undefined;
@@ -192,7 +192,7 @@ export declare const DashboardSchema: z.ZodObject<{
             h: number;
         };
         object?: string | undefined;
-        filter?: any;
+        filter?: import("../data/filter.zod").FilterCondition | undefined;
         options?: any;
         type?: "text" | "metric" | "bar" | "line" | "pie" | "donut" | "funnel" | "table" | undefined;
         aggregate?: "min" | "max" | "count" | "sum" | "avg" | undefined;

package/dist/ui/dashboard.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.zod.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,SAAS,iFASpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,mBAAmB;;IAGnB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,kCAAkC;;IAGlC,yCAAyC;;IAGzC,2BAA2B;;IAG3B,0BAA0B;;IAG1B;;;;;;OAMG;;;;;;;;;;;;;;;;;IAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,mBAAmB;;IAGnB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,4BAA4B;;QArD5B,mBAAmB;;QAGnB,yBAAyB;;QAGzB,yBAAyB;;QAGzB,kCAAkC;;QAGlC,yCAAyC;;QAGzC,2BAA2B;;QAG3B,0BAA0B;;QAG1B;;;;;;WAMG;;;;;;;;;;;;;;;;;QAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrD,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,SAAS;8BACH,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,KAAG,SAAS;CACpD,CAAC"}
+{"version":3,"file":"dashboard.zod.d.ts","sourceRoot":"","sources":["../../src/ui/dashboard.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,SAAS,iFASpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,mBAAmB;;IAGnB,yBAAyB;;IAGzB,yBAAyB;;IAGzB,kDAAkD;;IAGlD,yCAAyC;;IAGzC,2BAA2B;;IAG3B,0BAA0B;;IAG1B;;;;;;OAMG;;;;;;;;;;;;;;;;;IAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,mBAAmB;;IAGnB,oBAAoB;;IAGpB,kBAAkB;;IAGlB,4BAA4B;;QArD5B,mBAAmB;;QAGnB,yBAAyB;;QAGzB,yBAAyB;;QAGzB,kDAAkD;;QAGlD,yCAAyC;;QAGzC,2BAA2B;;QAG3B,0BAA0B;;QAG1B;;;;;;WAMG;;;;;;;;;;;;;;;;;QAQH,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBrD,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,SAAS;8BACH,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,KAAG,SAAS;CACpD,CAAC"}

package/dist/ui/dashboard.zod.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Dashboard = exports.DashboardSchema = exports.DashboardWidgetSchema = exports.ChartType = void 0;
 const zod_1 = require("zod");
+const filter_zod_1 = require("../data/filter.zod");
 /**
  * Chart Type Enum
  */
@@ -26,8 +27,8 @@ exports.DashboardWidgetSchema = zod_1.z.object({
     type: exports.ChartType.default('metric').describe('Visualization type'),
     /** Data Source Object */
     object: zod_1.z.string().optional().describe('Data source object name'),
-    /** Data Filter (ObjectQL JSON) */
-    filter: zod_1.z.any().optional().describe('Data filter criteria'),
+    /** Data Filter (MongoDB-style FilterCondition) */
+    filter: filter_zod_1.FilterConditionSchema.optional().describe('Data filter criteria'),
     /** Category Field (X-Axis / Group By) */
     categoryField: zod_1.z.string().optional().describe('Field for grouping (X-Axis)'),
     /** Value Field (Y-Axis) */

package/dist/ui/report.zod.d.ts

@@ -111,24 +111,8 @@ export declare const ReportSchema: z.ZodObject<{
         sortOrder?: "asc" | "desc" | undefined;
         dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
     }>, "many">>;
-    /** Filtering */
-    filter: z.ZodOptional<z.ZodString>;
-    filterItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodNumber;
-        field: z.ZodString;
-        operator: z.ZodString;
-        value: z.ZodAny;
-    }, "strip", z.ZodTypeAny, {
-        field: string;
-        id: number;
-        operator: string;
-        value?: any;
-    }, {
-        field: string;
-        id: number;
-        operator: string;
-        value?: any;
-    }>, "many">>;
+    /** Filtering (MongoDB-style FilterCondition) */
+    filter: z.ZodOptional<z.ZodType<import("../data/filter.zod").FilterCondition, z.ZodTypeDef, import("../data/filter.zod").FilterCondition>>;
     /** Visualization */
     chart: z.ZodOptional<z.ZodObject<{
         type: z.ZodEnum<["bar", "column", "line", "pie", "donut", "scatter", "funnel"]>;
@@ -159,7 +143,7 @@ export declare const ReportSchema: z.ZodObject<{
         label?: string | undefined;
         aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
     }[];
-    filter?: string | undefined;
+    filter?: import("../data/filter.zod").FilterCondition | undefined;
     description?: string | undefined;
     groupingsDown?: {
         field: string;
@@ -171,12 +155,6 @@ export declare const ReportSchema: z.ZodObject<{
         sortOrder: "asc" | "desc";
         dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
     }[] | undefined;
-    filterItems?: {
-        field: string;
-        id: number;
-        operator: string;
-        value?: any;
-    }[] | undefined;
     chart?: {
         type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
         showLegend: boolean;
@@ -193,7 +171,7 @@ export declare const ReportSchema: z.ZodObject<{
         label?: string | undefined;
         aggregate?: "unique" | "min" | "max" | "count" | "sum" | "avg" | undefined;
     }[];
-    filter?: string | undefined;
+    filter?: import("../data/filter.zod").FilterCondition | undefined;
     type?: "summary" | "tabular" | "matrix" | "joined" | undefined;
     description?: string | undefined;
     groupingsDown?: {
@@ -206,12 +184,6 @@ export declare const ReportSchema: z.ZodObject<{
         sortOrder?: "asc" | "desc" | undefined;
         dateGranularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
     }[] | undefined;
-    filterItems?: {
-        field: string;
-        id: number;
-        operator: string;
-        value?: any;
-    }[] | undefined;
     chart?: {
         type: "bar" | "line" | "pie" | "donut" | "funnel" | "column" | "scatter";
         xAxis: string;

package/dist/ui/report.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.zod.d.ts","sourceRoot":"","sources":["../../src/ui/report.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,UAAU,uDAKrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,eAAe;;;;IAKf,kBAAkB;;IAGlB,2BAA2B;;;;;;;;;;;;;;;IAK3B,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIpC,gBAAgB;;;;;;;;;;;;;;;;;;IAShB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,MAAM;8BACA,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,KAAG,MAAM;CAC9C,CAAC"}
+{"version":3,"file":"report.zod.d.ts","sourceRoot":"","sources":["../../src/ui/report.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,UAAU,uDAKrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB,eAAe;;;;IAKf,kBAAkB;;IAGlB,2BAA2B;;;;;;;;;;;;;;;IAK3B,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIpC,gDAAgD;;IAGhD,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,MAAM;8BACA,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,KAAG,MAAM;CAC9C,CAAC"}

package/dist/ui/report.zod.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Report = exports.ReportSchema = exports.ReportChartSchema = exports.ReportGroupingSchema = exports.ReportColumnSchema = exports.ReportType = void 0;
 const zod_1 = require("zod");
+const filter_zod_1 = require("../data/filter.zod");
 /**
  * Report Type Enum
  */
@@ -55,14 +56,8 @@ exports.ReportSchema = zod_1.z.object({
     /** Grouping (for Summary/Matrix) */
     groupingsDown: zod_1.z.array(exports.ReportGroupingSchema).optional().describe('Row groupings'),
     groupingsAcross: zod_1.z.array(exports.ReportGroupingSchema).optional().describe('Column groupings (Matrix only)'),
-    /** Filtering */
-    filter: zod_1.z.string().optional().describe('Filter logic (e.g. "1 AND (2 OR 3)")'),
-    filterItems: zod_1.z.array(zod_1.z.object({
-        id: zod_1.z.number(),
-        field: zod_1.z.string(),
-        operator: zod_1.z.string(),
-        value: zod_1.z.any()
-    })).optional().describe('Filter criteria lines'),
+    /** Filtering (MongoDB-style FilterCondition) */
+    filter: filter_zod_1.FilterConditionSchema.optional().describe('Filter criteria'),
     /** Visualization */
     chart: exports.ReportChartSchema.optional().describe('Embedded chart configuration'),
 });

package/json-schema/AccountLinkingConfig.json

@@ -0,0 +1,27 @@
+{
+  "$ref": "#/definitions/AccountLinkingConfig",
+  "definitions": {
+    "AccountLinkingConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Allow account linking"
+        },
+        "autoLink": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically link accounts with same email"
+        },
+        "requireVerification": {
+          "type": "boolean",
+          "default": true,
+          "description": "Require email verification before linking"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}