@objectql/types 3.0.1 → 4.0.1

package/dist/field.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=field.js.map

package/dist/field.js.map

@@ -1 +1 @@
-{"version":3,"file":"field.js","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":""}
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/form.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 /**
  * Form Metadata Definition
  *

package/dist/form.js

@@ -1,12 +1,10 @@
 "use strict";
 /**
- * Form Metadata Definition
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
  *
- * Defines the structure for forms, layouts, and field arrangements in ObjectQL.
- * Forms control how data is entered, edited, and displayed to users with
- * sections, tabs, columns, and conditional visibility.
- *
- * Based on patterns from Salesforce Page Layouts, Dynamics Forms, and similar platforms.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=form.js.map

package/dist/form.js.map

@@ -1 +1 @@
-{"version":3,"file":"form.js","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/formula.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 /**
  * Formula Engine Types
  *

package/dist/formula.js

@@ -1,4 +1,13 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormulaError = exports.FormulaErrorType = void 0;
 /**
  * Formula Engine Types
  *
@@ -8,8 +17,6 @@
  *
  * @see docs/spec/formula.md for complete specification
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FormulaError = exports.FormulaErrorType = void 0;
 const api_1 = require("./api");
 /**
  * Error types that can occur during formula evaluation

package/dist/formula.js.map

@@ -1 +1 @@
-{"version":3,"file":"formula.js","sourceRoot":"","sources":["../src/formula.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+BAAoD;AA0OpD;;GAEG;AACH,IAAY,gBAwBX;AAxBD,WAAY,gBAAgB;IACxB,qCAAqC;IACrC,iDAA6B,CAAA;IAE7B,sCAAsC;IACtC,uDAAmC,CAAA;IAEnC,iCAAiC;IACjC,6CAAyB,CAAA;IAEzB,uBAAuB;IACvB,yDAAqC,CAAA;IAErC,2CAA2C;IAC3C,qDAAiC,CAAA;IAEjC,yBAAyB;IACzB,uCAAmB,CAAA;IAEnB,gDAAgD;IAChD,6DAAyC,CAAA;IAEzC,4BAA4B;IAC5B,mDAA+B,CAAA;AACnC,CAAC,EAxBW,gBAAgB,gCAAhB,gBAAgB,QAwB3B;AAmBD;;;GAGG;AACH,MAAa,YAAa,SAAQ,mBAAa;IAK3C,YACI,IAAsB,EACtB,OAAe,EACf,UAAmB,EACnB,OAA6B;QAE7B,KAAK,CAAC;YACF,IAAI,EAAE,IAAc;YACpB,OAAO;YACP,OAAO,EAAE;gBACL,kBAAkB,EAAE,IAAI;gBACxB,UAAU;gBACV,GAAG,OAAO;aACb;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAChC,CAAC;CACJ;AAzBD,oCAyBC"}
+{"version":3,"file":"formula.js","sourceRoot":"","sources":["../src/formula.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;GAQG;AAEH,+BAAoD;AA0OpD;;GAEG;AACH,IAAY,gBAwBX;AAxBD,WAAY,gBAAgB;IACxB,qCAAqC;IACrC,iDAA6B,CAAA;IAE7B,sCAAsC;IACtC,uDAAmC,CAAA;IAEnC,iCAAiC;IACjC,6CAAyB,CAAA;IAEzB,uBAAuB;IACvB,yDAAqC,CAAA;IAErC,2CAA2C;IAC3C,qDAAiC,CAAA;IAEjC,yBAAyB;IACzB,uCAAmB,CAAA;IAEnB,gDAAgD;IAChD,6DAAyC,CAAA;IAEzC,4BAA4B;IAC5B,mDAA+B,CAAA;AACnC,CAAC,EAxBW,gBAAgB,gCAAhB,gBAAgB,QAwB3B;AAmBD;;;GAGG;AACH,MAAa,YAAa,SAAQ,mBAAa;IAK3C,YACI,IAAsB,EACtB,OAAe,EACf,UAAmB,EACnB,OAA6B;QAE7B,KAAK,CAAC;YACF,IAAI,EAAE,IAAc;YACpB,OAAO;YACP,OAAO,EAAE;gBACL,kBAAkB,EAAE,IAAI;gBACxB,UAAU;gBACV,GAAG,OAAO;aACb;SACJ,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAChC,CAAC;CACJ;AAzBD,oCAyBC"}

package/dist/hook.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 /**
  * Standard CRUD operations supported by hooks.
  */

package/dist/hook.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=hook.js.map

package/dist/hook.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":""}
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/index.d.ts

@@ -1,3 +1,17 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Export our runtime types.
+ *
+ * These modules import and extend types from @objectstack/spec where needed.
+ * Users of @objectql/types should import from here to get both protocol types
+ * and runtime extensions.
+ */
 export * from './field';
 export * from './object';
 export * from './driver';
@@ -7,7 +21,6 @@ export * from './hook';
 export * from './action';
 export * from './repository';
 export * from './app';
-export * from './plugin';
 export * from './config';
 export * from './context';
 export * from './validation';

package/dist/index.js

@@ -1,4 +1,11 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,6 +21,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Export our runtime types.
+ *
+ * These modules import and extend types from @objectstack/spec where needed.
+ * Users of @objectql/types should import from here to get both protocol types
+ * and runtime extensions.
+ */
 __exportStar(require("./field"), exports);
 __exportStar(require("./object"), exports);
 __exportStar(require("./driver"), exports);
@@ -23,7 +37,6 @@ __exportStar(require("./hook"), exports);
 __exportStar(require("./action"), exports);
 __exportStar(require("./repository"), exports);
 __exportStar(require("./app"), exports);
-__exportStar(require("./plugin"), exports);
 __exportStar(require("./config"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./validation"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,yCAAuB;AACvB,8CAA4B;AAC5B,wCAAsB;AACtB,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH;;;;;;GAMG;AACH,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,+CAA6B;AAC7B,wCAAsB;AACtB,2CAAyB;AACzB,4CAA0B;AAC1B,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,2CAAyB;AACzB,gDAA8B;AAC9B,yCAAuB;AACvB,8CAA4B;AAC5B,wCAAsB;AACtB,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,4CAA0B"}

package/dist/loader.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 import { MetadataRegistry } from './registry';
 export interface LoaderHandlerContext {
     file: string;

package/dist/loader.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":""}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/menu.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 export type MenuType = 'sidebar' | 'topnav' | 'context' | 'mobile' | 'admin';
 export type MenuItemType = 'page' | 'section' | 'url' | 'folder' | 'object' | 'action';
 export interface MenuItem {

package/dist/menu.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=menu.js.map

package/dist/menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":""}
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/migration.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 import { FieldConfig } from './field';
 /**
  * Represents the type of schema change operation.

package/dist/migration.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=migration.js.map

package/dist/migration.js.map

@@ -1 +1 @@
-{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":""}
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/object.d.ts

@@ -1,12 +1,45 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Data } from '@objectstack/spec';
+type ServiceObject = Data.ServiceObject;
+type IndexSchema = NonNullable<ServiceObject['indexes']>[number];
 import { FieldConfig } from './field';
 import { ActionConfig } from './action';
 import { AnyValidationRule } from './validation';
+/**
+ * Re-export Protocol Types from the Constitution
+ *
+ * @deprecated Import directly from @objectstack/spec instead
+ */
+export type { ServiceObject as SpecObject, IndexSchema };
+/**
+ * RUNTIME-SPECIFIC TYPES
+ * The following types extend or complement the Protocol Constitution
+ */
+/**
+ * Index Configuration (compatible with Protocol)
+ *
+ * The Protocol defines IndexSchema. We provide a simpler alias for runtime convenience.
+ */
 export interface IndexConfig {
+    /** Index name (optional, auto-generated if not provided) */
+    name?: string;
     /** List of fields involved in the index */
     fields: string[];
     /** Whether the index enforces uniqueness */
     unique?: boolean;
 }
+/**
+ * AI Search Configuration
+ *
+ * RUNTIME EXTENSION: Not part of the wire protocol.
+ * Defines semantic search capabilities for the runtime engine.
+ */
 export interface AiSearchConfig {
     /** Enable semantic search for this object */
     enabled: boolean;
@@ -17,22 +50,74 @@ export interface AiSearchConfig {
     /** Optional: Target vector field name if manually defined */
     target_field?: string;
 }
+/**
+ * Object AI Configuration
+ *
+ * RUNTIME EXTENSION: Not part of the wire protocol.
+ */
 export interface ObjectAiConfig {
     /** Configuration for semantic search / RAG */
     search?: AiSearchConfig;
 }
+/**
+ * Runtime Object Configuration
+ *
+ * Extends the Protocol ServiceObject with runtime-specific properties.
+ * The Protocol Constitution (SpecObject) defines the core object schema.
+ * This adds runtime conveniences like actions, AI config, and validation rules.
+ */
 export interface ObjectConfig {
+    /** Object name (required by Protocol) */
     name: string;
-    datasource?: string;
+    /** Display label */
     label?: string;
-    icon?: string;
+    /** Plural label */
+    pluralLabel?: string;
+    /** Description */
     description?: string;
+    /** Icon identifier */
+    icon?: string;
+    /** Datasource name (defaults to 'default') */
+    datasource?: string;
+    /** Custom table name (defaults to object name) */
+    tableName?: string;
+    /** Whether this is a system object */
+    isSystem?: boolean;
+    /**
+     * Field definitions
+     * Maps field names to their configurations
+     */
     fields: Record<string, FieldConfig>;
+    /**
+     * Index definitions
+     * Maps index names to their configurations
+     */
     indexes?: Record<string, IndexConfig>;
-    /** AI capabilities configuration */
+    /** Primary display field */
+    nameField?: string;
+    /** Object capabilities (from Protocol) */
+    enable?: {
+        /** Enable history tracking (Audit Trail) */
+        trackHistory?: boolean;
+        /** Enable global search indexing */
+        searchable?: boolean;
+        /** Enable REST/GraphQL API access */
+        apiEnabled?: boolean;
+        /** Enable attachments/files */
+        files?: boolean;
+        /** Enable discussions/chatter */
+        feedEnabled?: boolean;
+        /** Enable Recycle Bin mechanics */
+        trash?: boolean;
+    };
+    /**
+     * RUNTIME EXTENSIONS BELOW
+     */
+    /** AI capabilities configuration (RUNTIME ONLY) */
     ai?: ObjectAiConfig;
+    /** Custom actions (RUNTIME ONLY) */
     actions?: Record<string, ActionConfig>;
-    /** Validation rules for this object */
+    /** Validation rules for this object (RUNTIME ONLY) */
     validation?: {
         /** Validation rules */
         rules?: AnyValidationRule[];
@@ -45,6 +130,8 @@ export interface ObjectConfig {
 }
 /**
  * Base interface for all ObjectQL documents.
+ *
+ * RUNTIME TYPE: Represents a document instance in the database.
  */
 export interface ObjectDoc {
     _id?: string | number;

package/dist/object.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":""}
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/page.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 /**
  * Page Metadata Definition
  *

package/dist/page.js

@@ -1,12 +1,10 @@
 "use strict";
 /**
- * Page Metadata Definition
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
  *
- * Defines the structure for pages in ObjectQL applications.
- * Inspired by low-code platforms like Airtable, Retool, Appsmith, and Salesforce Lightning.
- *
- * Pages are composable UI containers that can render data from objects,
- * display custom components, and orchestrate user interactions.
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=page.js.map

package/dist/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","sourceRoot":"","sources":["../src/page.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../src/page.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/permission.d.ts

@@ -1,3 +1,10 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 /**
  * Permission and Security Metadata Types
  *

package/dist/permission.js

@@ -1,12 +1,10 @@
 "use strict";
 /**
- * Permission and Security Metadata Types
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
  *
- * This module defines the TypeScript interfaces for ObjectQL's permission system,
- * implementing role-based access control (RBAC), field-level security, and
- * record-level rules.
- *
- * Based on specification: docs/spec/permission.md
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=permission.js.map

package/dist/permission.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission.js","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/query.d.ts

@@ -1,18 +1,54 @@
-export type FilterCriterion = [string, string, any];
-export type FilterExpression = FilterCriterion | 'and' | 'or' | FilterExpression[];
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Data } from '@objectstack/spec';
+type FilterCondition = Data.FilterCondition;
+/**
+ * Modern Query Filter using @objectstack/spec FilterCondition
+ *
+ * Supports MongoDB/Prisma-style object-based syntax:
+ * - Implicit equality: { field: value }
+ * - Explicit operators: { field: { $eq: value, $gt: 10 } }
+ * - Logical operators: { $and: [...], $or: [...] }
+ * - String operators: { name: { $contains: "text" } }
+ * - Range operators: { age: { $gte: 18, $lte: 65 } }
+ * - Set operators: { status: { $in: ["active", "pending"] } }
+ * - Null checks: { field: { $null: true } }
+ *
+ * Note: $not operator is not supported. Use $ne for field-level negation.
+ */
+export type Filter = FilterCondition;
 export type AggregateFunction = 'count' | 'sum' | 'avg' | 'min' | 'max';
 export interface AggregateOption {
     func: AggregateFunction;
     field: string;
     alias?: string;
 }
+/**
+ * Unified Query Interface
+ *
+ * Provides a consistent query API across all ObjectQL drivers.
+ */
 export interface UnifiedQuery {
+    /** Field selection - specify which fields to return */
     fields?: string[];
-    filters?: FilterExpression[];
+    /** Filter conditions using modern FilterCondition syntax */
+    filters?: Filter;
+    /** Sort order - array of [field, direction] tuples */
     sort?: [string, 'asc' | 'desc'][];
+    /** Pagination - number of records to skip */
     skip?: number;
+    /** Pagination - maximum number of records to return */
     limit?: number;
+    /** Relation expansion - load related records */
     expand?: Record<string, UnifiedQuery>;
+    /** Aggregation - group by fields */
     groupBy?: string[];
+    /** Aggregation - aggregate functions to apply */
     aggregate?: AggregateOption[];
 }
+export {};

package/dist/query.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":""}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/registry.d.ts

@@ -1,16 +1,25 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Re-export MetadataRegistry and MetadataItem from @objectql/runtime
+ *
+ * As of Week 3 refactoring, metadata management has been moved to the
+ * @objectql/runtime package to enable sharing across the ecosystem.
+ */
+export { MetadataRegistry, MetadataItem } from '../../../objectstack/runtime/dist';
+/**
+ * Legacy Metadata interface - kept for backward compatibility
+ * @deprecated Use MetadataItem from @objectql/runtime instead
+ */
 export interface Metadata {
     type: string;
     id: string;
     path?: string;
     package?: string;
-    content: any;
-}
-export declare class MetadataRegistry {
-    private store;
-    register(type: string, metadata: Metadata): void;
-    unregister(type: string, id: string): void;
-    unregisterPackage(packageName: string): void;
-    get<T = any>(type: string, id: string): T | undefined;
-    list<T = any>(type: string): T[];
-    getEntry(type: string, id: string): Metadata | undefined;
+    content: unknown;
 }