@objectstack/spec 0.1.2 → 0.3.0

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

@@ -31,32 +31,52 @@ export declare const DriverDefinitionSchema: z.ZodObject<{
      * What this driver supports out-of-the-box.
      */
     capabilities: z.ZodOptional<z.ZodLazy<z.ZodObject<{
-        /** Can execute SQL-like joins natively? */
-        joins: z.ZodDefault<z.ZodBoolean>;
         /** Can handle ACID transactions? */
         transactions: z.ZodDefault<z.ZodBoolean>;
+        /** Can execute WHERE clause filters natively? */
+        queryFilters: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform aggregation (group by, sum, avg)? */
+        queryAggregations: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform ORDER BY sorting? */
+        querySorting: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform LIMIT/OFFSET pagination? */
+        queryPagination: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform window functions? */
+        queryWindowFunctions: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform subqueries? */
+        querySubqueries: z.ZodDefault<z.ZodBoolean>;
+        /** Can execute SQL-like joins natively? */
+        joins: z.ZodDefault<z.ZodBoolean>;
         /** Can perform full-text search? */
         fullTextSearch: z.ZodDefault<z.ZodBoolean>;
-        /** Can perform aggregation (group by, sum, avg)? */
-        aggregation: z.ZodDefault<z.ZodBoolean>;
-        /** Is scheme-less (needs schema inference)? */
-        dynamicSchema: z.ZodDefault<z.ZodBoolean>;
         /** Is read-only? */
         readOnly: z.ZodDefault<z.ZodBoolean>;
+        /** Is scheme-less (needs schema inference)? */
+        dynamicSchema: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
-        aggregation: boolean;
-        dynamicSchema: boolean;
         readOnly: boolean;
+        dynamicSchema: boolean;
     }, {
         joins?: boolean | undefined;
         transactions?: boolean | undefined;
+        queryFilters?: boolean | undefined;
+        queryAggregations?: boolean | undefined;
+        querySorting?: boolean | undefined;
+        queryPagination?: boolean | undefined;
+        queryWindowFunctions?: boolean | undefined;
+        querySubqueries?: boolean | undefined;
         fullTextSearch?: boolean | undefined;
-        aggregation?: boolean | undefined;
-        dynamicSchema?: boolean | undefined;
         readOnly?: boolean | undefined;
+        dynamicSchema?: boolean | undefined;
     }>>>;
 }, "strip", z.ZodTypeAny, {
     label: string;
@@ -67,10 +87,15 @@ export declare const DriverDefinitionSchema: z.ZodObject<{
     capabilities?: {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
-        aggregation: boolean;
-        dynamicSchema: boolean;
         readOnly: boolean;
+        dynamicSchema: boolean;
     } | undefined;
 }, {
     label: string;
@@ -81,10 +106,15 @@ export declare const DriverDefinitionSchema: z.ZodObject<{
     capabilities?: {
         joins?: boolean | undefined;
         transactions?: boolean | undefined;
+        queryFilters?: boolean | undefined;
+        queryAggregations?: boolean | undefined;
+        querySorting?: boolean | undefined;
+        queryPagination?: boolean | undefined;
+        queryWindowFunctions?: boolean | undefined;
+        querySubqueries?: boolean | undefined;
         fullTextSearch?: boolean | undefined;
-        aggregation?: boolean | undefined;
-        dynamicSchema?: boolean | undefined;
         readOnly?: boolean | undefined;
+        dynamicSchema?: boolean | undefined;
     } | undefined;
 }>;
 /**
@@ -94,32 +124,52 @@ export declare const DriverDefinitionSchema: z.ZodObject<{
  * and what to compute in memory.
  */
 export declare const DatasourceCapabilities: z.ZodObject<{
-    /** Can execute SQL-like joins natively? */
-    joins: z.ZodDefault<z.ZodBoolean>;
     /** Can handle ACID transactions? */
     transactions: z.ZodDefault<z.ZodBoolean>;
+    /** Can execute WHERE clause filters natively? */
+    queryFilters: z.ZodDefault<z.ZodBoolean>;
+    /** Can perform aggregation (group by, sum, avg)? */
+    queryAggregations: z.ZodDefault<z.ZodBoolean>;
+    /** Can perform ORDER BY sorting? */
+    querySorting: z.ZodDefault<z.ZodBoolean>;
+    /** Can perform LIMIT/OFFSET pagination? */
+    queryPagination: z.ZodDefault<z.ZodBoolean>;
+    /** Can perform window functions? */
+    queryWindowFunctions: z.ZodDefault<z.ZodBoolean>;
+    /** Can perform subqueries? */
+    querySubqueries: z.ZodDefault<z.ZodBoolean>;
+    /** Can execute SQL-like joins natively? */
+    joins: z.ZodDefault<z.ZodBoolean>;
     /** Can perform full-text search? */
     fullTextSearch: z.ZodDefault<z.ZodBoolean>;
-    /** Can perform aggregation (group by, sum, avg)? */
-    aggregation: z.ZodDefault<z.ZodBoolean>;
-    /** Is scheme-less (needs schema inference)? */
-    dynamicSchema: z.ZodDefault<z.ZodBoolean>;
     /** Is read-only? */
     readOnly: z.ZodDefault<z.ZodBoolean>;
+    /** Is scheme-less (needs schema inference)? */
+    dynamicSchema: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     joins: boolean;
     transactions: boolean;
+    queryFilters: boolean;
+    queryAggregations: boolean;
+    querySorting: boolean;
+    queryPagination: boolean;
+    queryWindowFunctions: boolean;
+    querySubqueries: boolean;
     fullTextSearch: boolean;
-    aggregation: boolean;
-    dynamicSchema: boolean;
     readOnly: boolean;
+    dynamicSchema: boolean;
 }, {
     joins?: boolean | undefined;
     transactions?: boolean | undefined;
+    queryFilters?: boolean | undefined;
+    queryAggregations?: boolean | undefined;
+    querySorting?: boolean | undefined;
+    queryPagination?: boolean | undefined;
+    queryWindowFunctions?: boolean | undefined;
+    querySubqueries?: boolean | undefined;
     fullTextSearch?: boolean | undefined;
-    aggregation?: boolean | undefined;
-    dynamicSchema?: boolean | undefined;
     readOnly?: boolean | undefined;
+    dynamicSchema?: boolean | undefined;
 }>;
 /**
  * Datasource Schema
@@ -143,32 +193,52 @@ export declare const DatasourceSchema: z.ZodObject<{
      * Manually override what the driver claims to support.
      */
     capabilities: z.ZodOptional<z.ZodObject<{
-        /** Can execute SQL-like joins natively? */
-        joins: z.ZodDefault<z.ZodBoolean>;
         /** Can handle ACID transactions? */
         transactions: z.ZodDefault<z.ZodBoolean>;
+        /** Can execute WHERE clause filters natively? */
+        queryFilters: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform aggregation (group by, sum, avg)? */
+        queryAggregations: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform ORDER BY sorting? */
+        querySorting: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform LIMIT/OFFSET pagination? */
+        queryPagination: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform window functions? */
+        queryWindowFunctions: z.ZodDefault<z.ZodBoolean>;
+        /** Can perform subqueries? */
+        querySubqueries: z.ZodDefault<z.ZodBoolean>;
+        /** Can execute SQL-like joins natively? */
+        joins: z.ZodDefault<z.ZodBoolean>;
         /** Can perform full-text search? */
         fullTextSearch: z.ZodDefault<z.ZodBoolean>;
-        /** Can perform aggregation (group by, sum, avg)? */
-        aggregation: z.ZodDefault<z.ZodBoolean>;
-        /** Is scheme-less (needs schema inference)? */
-        dynamicSchema: z.ZodDefault<z.ZodBoolean>;
         /** Is read-only? */
         readOnly: z.ZodDefault<z.ZodBoolean>;
+        /** Is scheme-less (needs schema inference)? */
+        dynamicSchema: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
-        aggregation: boolean;
-        dynamicSchema: boolean;
         readOnly: boolean;
+        dynamicSchema: boolean;
     }, {
         joins?: boolean | undefined;
         transactions?: boolean | undefined;
+        queryFilters?: boolean | undefined;
+        queryAggregations?: boolean | undefined;
+        querySorting?: boolean | undefined;
+        queryPagination?: boolean | undefined;
+        queryWindowFunctions?: boolean | undefined;
+        querySubqueries?: boolean | undefined;
         fullTextSearch?: boolean | undefined;
-        aggregation?: boolean | undefined;
-        dynamicSchema?: boolean | undefined;
         readOnly?: boolean | undefined;
+        dynamicSchema?: boolean | undefined;
     }>>;
     /** Description */
     description: z.ZodOptional<z.ZodString>;
@@ -184,10 +254,15 @@ export declare const DatasourceSchema: z.ZodObject<{
     capabilities?: {
         joins: boolean;
         transactions: boolean;
+        queryFilters: boolean;
+        queryAggregations: boolean;
+        querySorting: boolean;
+        queryPagination: boolean;
+        queryWindowFunctions: boolean;
+        querySubqueries: boolean;
         fullTextSearch: boolean;
-        aggregation: boolean;
-        dynamicSchema: boolean;
         readOnly: boolean;
+        dynamicSchema: boolean;
     } | undefined;
 }, {
     name: string;
@@ -199,10 +274,15 @@ export declare const DatasourceSchema: z.ZodObject<{
     capabilities?: {
         joins?: boolean | undefined;
         transactions?: boolean | undefined;
+        queryFilters?: boolean | undefined;
+        queryAggregations?: boolean | undefined;
+        querySorting?: boolean | undefined;
+        queryPagination?: boolean | undefined;
+        queryWindowFunctions?: boolean | undefined;
+        querySubqueries?: boolean | undefined;
         fullTextSearch?: boolean | undefined;
-        aggregation?: boolean | undefined;
-        dynamicSchema?: boolean | undefined;
         readOnly?: boolean | undefined;
+        dynamicSchema?: boolean | undefined;
     } | undefined;
 }>;
 export type Datasource = z.infer<typeof DatasourceSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"datasource.zod.d.ts","sourceRoot":"","sources":["../../src/system/datasource.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc,+KAMjB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,UAAU,aAAsD,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;IAMjC;;;;OAIG;;IAGH;;;OAGG;;QAWH,2CAA2C;;QAE3C,oCAAoC;;QAEpC,oCAAoC;;QAEpC,oDAAoD;;QAEpD,+CAA+C;;QAE/C,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAnBpB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IACjC,2CAA2C;;IAE3C,oCAAoC;;IAEpC,oCAAoC;;IAEpC,oDAAoD;;IAEpD,+CAA+C;;IAE/C,oBAAoB;;;;;;;;;;;;;;;;EAEpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,mBAAmB;;IAGnB,kBAAkB;;IAGlB,aAAa;;IAGb;;;;OAIG;;IAGH;;;OAGG;;QAtCH,2CAA2C;;QAE3C,oCAAoC;;QAEpC,oCAAoC;;QAEpC,oDAAoD;;QAEpD,+CAA+C;;QAE/C,oBAAoB;;;;;;;;;;;;;;;;;IA+BpB,kBAAkB;;IAGlB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"datasource.zod.d.ts","sourceRoot":"","sources":["../../src/system/datasource.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc,+KAMjB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,UAAU,aAAsD,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;IAMjC;;;;OAIG;;IAGH;;;OAGG;;QAeH,oCAAoC;;QAOpC,iDAAiD;;QAGjD,oDAAoD;;QAGpD,oCAAoC;;QAGpC,2CAA2C;;QAG3C,oCAAoC;;QAGpC,8BAA8B;;QAG9B,2CAA2C;;QAO3C,oCAAoC;;QAGpC,oBAAoB;;QAGpB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAnD/C,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IAKjC,oCAAoC;;IAOpC,iDAAiD;;IAGjD,oDAAoD;;IAGpD,oCAAoC;;IAGpC,2CAA2C;;IAG3C,oCAAoC;;IAGpC,8BAA8B;;IAG9B,2CAA2C;;IAO3C,oCAAoC;;IAGpC,oBAAoB;;IAGpB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,mBAAmB;;IAGnB,kBAAkB;;IAGlB,aAAa;;IAGb;;;;OAIG;;IAGH;;;OAGG;;QAlEH,oCAAoC;;QAOpC,iDAAiD;;QAGjD,oDAAoD;;QAGpD,oCAAoC;;QAGpC,2CAA2C;;QAG3C,oCAAoC;;QAGpC,8BAA8B;;QAG9B,2CAA2C;;QAO3C,oCAAoC;;QAGpC,oBAAoB;;QAGpB,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+B/C,kBAAkB;;IAGlB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

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

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())