@objectql/types 4.0.1 → 4.0.3

package/README.md

@@ -1,7 +1,11 @@
 # @objectql/types
 
+> **Implementation Status**: ✅ **Complete** - All type definitions available. See [Implementation Status](https://github.com/objectstack-ai/objectql/blob/main/IMPLEMENTATION_STATUS.md) for runtime implementation details.
+
 Type definitions for the ObjectQL system, including object schemas, field configurations, validation rules, queries, hooks, and actions.
 
+> **Note**: This package defines the type system. Some types (like permissions and workflows) are defined but require application-layer implementation. See the implementation status document for details.
+
 ## Features
 
 - **Object & Field Types**: Define data models with `ObjectConfig` and `FieldConfig`

package/dist/api.d.ts

@@ -96,16 +96,22 @@ export interface DataApiListResponse<T = unknown> extends DataApiResponse<T> {
 }
 /**
  * Response for single item operations (findOne, create, update)
+ * Single item operations wrap the data in a 'data' field
  */
 export interface DataApiItemResponse<T = unknown> extends DataApiResponse<T> {
-    /** The item ID */
-    _id?: string | number;
-    /** Object type identifier */
-    '@type'?: string;
-    /** Timestamp when created */
-    created_at?: string | Date;
-    /** Timestamp when last updated */
-    updated_at?: string | Date;
+    /** The returned item data */
+    data?: T & {
+        /** The item ID */
+        _id?: string | number;
+        /** Object type identifier */
+        '@type'?: string;
+        /** Timestamp when created */
+        created_at?: string | Date;
+        /** Timestamp when last updated */
+        updated_at?: string | Date;
+        /** Additional item fields */
+        [key: string]: unknown;
+    };
 }
 /**
  * Query parameters for GET /api/data/:object (list records)

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAujBH,4CASC;AAljBD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,IAAY,YAUX;AAVD,WAAY,YAAY;IACpB,mDAAmC,CAAA;IACnC,qDAAqC,CAAA;IACrC,6CAA6B,CAAA;IAC7B,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;IACrB,iDAAiC,CAAA;IACjC,iDAAiC,CAAA;IACjC,2DAA2C,CAAA;AAC/C,CAAC,EAVW,YAAY,4BAAZ,YAAY,QAUvB;AAwBD;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IAIpC,YAAY,KAAkF;QAC1F,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE7B,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,KAA2F,CAAC;QACrH,IAAI,OAAO,gBAAgB,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC3D,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;CACJ;AAhBD,sCAgBC;AA+dD;;GAEG;AACU,QAAA,kBAAkB,GAA2B;IACtD,GAAG,EAAE,eAAe;IACpB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;CACtB,CAAC;AAEF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,MAAuB;;IACpD,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAEzF,OAAO;QACH,GAAG,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,0BAAkB,CAAC,GAAG,CAAC;QACzD,IAAI,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,mCAAI,0BAAkB,CAAC,IAAI,CAAC;QAC5D,QAAQ,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,mCAAI,0BAAkB,CAAC,QAAQ,CAAC;QACxE,KAAK,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,mCAAI,0BAAkB,CAAC,KAAK,CAAC;KAClE,CAAC;AACN,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA6jBH,4CASC;AAxjBD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,IAAY,YAUX;AAVD,WAAY,YAAY;IACpB,mDAAmC,CAAA;IACnC,qDAAqC,CAAA;IACrC,6CAA6B,CAAA;IAC7B,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;IACvB,qCAAqB,CAAA;IACrB,iDAAiC,CAAA;IACjC,iDAAiC,CAAA;IACjC,2DAA2C,CAAA;AAC/C,CAAC,EAVW,YAAY,4BAAZ,YAAY,QAUvB;AAwBD;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IAIpC,YAAY,KAAkF;QAC1F,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE7B,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,KAA2F,CAAC;QACrH,IAAI,OAAO,gBAAgB,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC3D,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;CACJ;AAhBD,sCAgBC;AAqeD;;GAEG;AACU,QAAA,kBAAkB,GAA2B;IACtD,GAAG,EAAE,eAAe;IACpB,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,YAAY;CACtB,CAAC;AAEF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,MAAuB;;IACpD,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAEzF,OAAO;QACH,GAAG,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,0BAAkB,CAAC,GAAG,CAAC;QACzD,IAAI,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,mCAAI,0BAAkB,CAAC,IAAI,CAAC;QAC5D,QAAQ,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,mCAAI,0BAAkB,CAAC,QAAQ,CAAC;QACxE,KAAK,EAAE,aAAa,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,mCAAI,0BAAkB,CAAC,KAAK,CAAC;KAClE,CAAC;AACN,CAAC"}

package/dist/app.d.ts

@@ -24,8 +24,8 @@ export interface IObjectQL {
     registerAction(objectName: string, actionName: string, handler: ActionHandler): void;
     executeAction(objectName: string, actionName: string, ctx: ActionContext): Promise<any>;
     /**
-     * Get the underlying ObjectStackKernel instance
-     * @returns The ObjectStackKernel instance
+     * Get the underlying ObjectKernel instance
+     * @returns The ObjectKernel instance
      */
     getKernel(): any;
 }

package/dist/config.d.ts

@@ -8,7 +8,7 @@
 import { MetadataRegistry } from "./registry";
 import { Driver } from "./driver";
 import { ObjectConfig } from "./object";
-import type { RuntimePlugin } from "../../../objectstack/runtime/dist";
+import type { RuntimePlugin } from "./plugin";
 export interface ObjectQLConfig {
     registry?: MetadataRegistry;
     datasources?: Record<string, Driver>;
@@ -37,7 +37,7 @@ export interface ObjectQLConfig {
     modules?: string[];
     /**
      * List of plugins to load.
-     * Must implement the RuntimePlugin interface from @objectql/runtime.
+     * Must implement the RuntimePlugin interface.
      * String plugins (package names) are not supported in core.
      */
     plugins?: (RuntimePlugin | string)[];

package/dist/field.d.ts

@@ -104,9 +104,9 @@ export interface FieldOption {
  * - `deleteBehavior`: Made optional with protocol-compatible enum values
  *
  * All other protocol properties (description, defaultValue, maxLength, minLength, precision, scale, min, max,
- * reference, referenceFilters, writeRequiresMasterRead, expression, formula, summaryOperations) are inherited as-is.
+ * reference, referenceFilters, writeRequiresMasterRead, expression, summaryOperations) are inherited as-is.
  */
-export interface FieldConfig extends Omit<Field, 'name' | 'label' | 'type' | 'options' | 'required' | 'multiple' | 'unique' | 'deleteBehavior' | 'hidden' | 'readonly' | 'encryption' | 'index' | 'externalId' | 'searchable'> {
+export interface FieldConfig extends Omit<Field, 'name' | 'label' | 'type' | 'options' | 'required' | 'multiple' | 'unique' | 'deleteBehavior' | 'hidden' | 'readonly' | 'encryption' | 'index' | 'externalId' | 'searchable' | 'auditTrail'> {
     /** Field name (inferred from Record key when used in ObjectConfig.fields) */
     name?: string;
     /** Display label (derived from name if not provided) */

package/dist/index.d.ts

@@ -25,14 +25,10 @@ export * from './config';
 export * from './context';
 export * from './validation';
 export * from './permission';
-export * from './page';
 export * from './loader';
 export * from './application';
-export * from './menu';
 export * from './migration';
 export * from './api';
-export * from './view';
 export * from './workflow';
-export * from './report';
-export * from './form';
 export * from './formula';
+export * from './plugin';

package/dist/index.js

@@ -41,15 +41,11 @@ __exportStar(require("./config"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./validation"), exports);
 __exportStar(require("./permission"), exports);
-__exportStar(require("./page"), exports);
 __exportStar(require("./loader"), exports);
 __exportStar(require("./application"), exports);
-__exportStar(require("./menu"), exports);
 __exportStar(require("./migration"), exports);
 __exportStar(require("./api"), exports);
-__exportStar(require("./view"), exports);
 __exportStar(require("./workflow"), exports);
-__exportStar(require("./report"), exports);
-__exportStar(require("./form"), exports);
 __exportStar(require("./formula"), exports);
+__exportStar(require("./plugin"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"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"}
+{"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,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,wCAAsB;AACtB,6CAA2B;AAC3B,4CAA0B;AAC1B,2CAAyB"}

package/dist/object.d.ts

@@ -5,18 +5,9 @@
  * 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
@@ -63,7 +54,7 @@ export interface ObjectAiConfig {
  * Runtime Object Configuration
  *
  * Extends the Protocol ServiceObject with runtime-specific properties.
- * The Protocol Constitution (SpecObject) defines the core object schema.
+ * The Protocol Constitution defines the core object schema.
  * This adds runtime conveniences like actions, AI config, and validation rules.
  */
 export interface ObjectConfig {

package/dist/plugin.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ObjectQL Plugin System
+ * 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.
+ */
+/**
+ * Runtime context passed to plugin lifecycle hooks
+ *
+ * This context provides access to the kernel/engine instance
+ * and allows plugins to interact with the ObjectStack runtime.
+ */
+export interface RuntimeContext {
+    /**
+     * The ObjectStack kernel/engine instance
+     *
+     * This provides access to:
+     * - metadata registry
+     * - hook manager
+     * - action manager
+     * - CRUD operations
+     */
+    engine: any;
+    /**
+     * Get the kernel instance (alternative accessor)
+     * Some implementations may use getKernel() instead of engine
+     */
+    getKernel?: () => any;
+}
+/**
+ * RuntimePlugin Interface
+ *
+ * Defines the standard plugin contract for ObjectStack/ObjectQL ecosystem.
+ * All plugins (protocol adapters, data drivers, feature extensions) should
+ * implement this interface to ensure consistent lifecycle management.
+ *
+ * Lifecycle Order:
+ * 1. install() - Called during kernel initialization
+ * 2. onStart() - Called when kernel starts
+ * 3. onStop() - Called when kernel stops/shuts down
+ *
+ * @example
+ * ```typescript
+ * export class MyPlugin implements RuntimePlugin {
+ *   name = '@myorg/my-plugin';
+ *   version = '1.0.0';
+ *
+ *   async install(ctx: RuntimeContext): Promise<void> {
+ *     // Register hooks, load configuration
+ *     console.log('Plugin installed');
+ *   }
+ *
+ *   async onStart(ctx: RuntimeContext): Promise<void> {
+ *     // Start servers, connect to services
+ *     console.log('Plugin started');
+ *   }
+ *
+ *   async onStop(ctx: RuntimeContext): Promise<void> {
+ *     // Cleanup resources, disconnect
+ *     console.log('Plugin stopped');
+ *   }
+ * }
+ * ```
+ */
+export interface RuntimePlugin {
+    /**
+     * Unique plugin identifier
+     *
+     * Should follow npm package naming convention
+     * Examples: '@objectql/plugin-security', '@myorg/my-plugin'
+     */
+    name: string;
+    /**
+     * Plugin version (semantic versioning)
+     *
+     * Optional but recommended for debugging and compatibility tracking
+     * Example: '1.0.0', '2.1.3-beta'
+     */
+    version?: string;
+    /**
+     * Install hook - called during kernel initialization
+     *
+     * Use this phase to:
+     * - Register hooks and event handlers
+     * - Initialize plugin state
+     * - Load configuration
+     * - Register metadata (objects, fields, actions)
+     * - Validate dependencies
+     *
+     * This is called BEFORE the kernel starts, so services may not be available yet.
+     *
+     * @param ctx - Runtime context with access to kernel/engine
+     */
+    install?(ctx: RuntimeContext): void | Promise<void>;
+    /**
+     * Start hook - called when kernel starts
+     *
+     * Use this phase to:
+     * - Start background processes (servers, workers, schedulers)
+     * - Connect to external services (databases, APIs, message queues)
+     * - Initialize runtime resources
+     * - Perform health checks
+     *
+     * This is called AFTER install() and AFTER all plugins are installed.
+     *
+     * @param ctx - Runtime context with access to kernel/engine
+     */
+    onStart?(ctx: RuntimeContext): void | Promise<void>;
+    /**
+     * Stop hook - called when kernel stops/shuts down
+     *
+     * Use this phase to:
+     * - Stop background processes
+     * - Disconnect from external services
+     * - Cleanup resources (file handles, connections, timers)
+     * - Flush pending operations
+     * - Save state if needed
+     *
+     * This is called during graceful shutdown. Ensure cleanup completes quickly.
+     *
+     * @param ctx - Runtime context with access to kernel/engine
+     */
+    onStop?(ctx: RuntimeContext): void | Promise<void>;
+}

package/dist/{menu.js → plugin.js}

@@ -1,10 +1,10 @@
 "use strict";
 /**
- * ObjectQL
+ * ObjectQL Plugin System
  * 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
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/query.d.ts

@@ -22,33 +22,70 @@ type FilterCondition = Data.FilterCondition;
  * Note: $not operator is not supported. Use $ne for field-level negation.
  */
 export type Filter = FilterCondition;
-export type AggregateFunction = 'count' | 'sum' | 'avg' | 'min' | 'max';
+/** @deprecated Use AggregationFunctionType instead */
+export type AggregateFunction = AggregationFunctionType;
+/** @deprecated Use AggregationNode instead */
 export interface AggregateOption {
     func: AggregateFunction;
     field: string;
     alias?: string;
 }
 /**
- * Unified Query Interface
+ * Sort Node - Standard Protocol Format
+ * Represents an "Order By" clause.
+ */
+export interface SortNode {
+    /** Field name to sort by */
+    field: string;
+    /** Sort direction - defaults to 'asc' */
+    order: 'asc' | 'desc';
+}
+/**
+ * Aggregation Function - Standard Protocol Format
+ */
+export type AggregationFunctionType = 'count' | 'sum' | 'avg' | 'min' | 'max' | 'count_distinct' | 'array_agg' | 'string_agg';
+/**
+ * Aggregation Node - Standard Protocol Format
+ * Represents an aggregated field with function.
+ */
+export interface AggregationNode {
+    /** Aggregation function to apply */
+    function: AggregationFunctionType;
+    /** Field to aggregate (optional for count) */
+    field?: string;
+    /** Alias for the result field */
+    alias: string;
+    /** Apply DISTINCT to the field before aggregation */
+    distinct?: boolean;
+    /** Optional filter condition for this aggregation */
+    filter?: Filter;
+}
+/**
+ * Unified Query Interface - Standard Protocol Format
  *
- * Provides a consistent query API across all ObjectQL drivers.
+ * Uses @objectstack/spec QueryAST format directly.
+ * This is the single source of truth for query structure.
  */
 export interface UnifiedQuery {
     /** Field selection - specify which fields to return */
     fields?: string[];
-    /** 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;
+    /** Filter conditions using standard FilterCondition syntax (was: filters) */
+    where?: Filter;
+    /** Sort order - array of SortNode objects (was: sort as tuples) */
+    orderBy?: SortNode[];
+    /** Pagination - number of records to skip (was: skip) */
+    offset?: 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[];
+    /** Aggregation - aggregate functions to apply (was: aggregate with func) */
+    aggregations?: AggregationNode[];
+    /** Filter for aggregated results (HAVING clause) */
+    having?: Filter;
+    /** Enable distinct results */
+    distinct?: boolean;
 }
 export {};

package/dist/registry.d.ts

@@ -6,15 +6,35 @@
  * LICENSE file in the root directory of this source tree.
  */
 /**
- * Re-export MetadataRegistry and MetadataItem from @objectql/runtime
+ * Optimized Metadata Registry with O(k) package uninstall complexity
  *
- * As of Week 3 refactoring, metadata management has been moved to the
- * @objectql/runtime package to enable sharing across the ecosystem.
+ * Uses secondary indexes to achieve O(k) complexity for unregisterPackage
+ * operation (where k is the number of items in the package) instead of
+ * O(n*m) (where n is types and m is items per type).
  */
-export { MetadataRegistry, MetadataItem } from '../../../objectstack/runtime/dist';
+export declare class MetadataRegistry {
+    private items;
+    private packageIndex;
+    constructor();
+    register(type: string, nameOrConfig: any, config?: any): void;
+    get<T = any>(type: string, name: string): T;
+    list<T = any>(type: string): T[];
+    getTypes(): string[];
+    getEntry<T = any>(type: string, name: string): T;
+    unregister(type: string, name: string): void;
+    /**
+     * Optimized package unregistration with O(k) complexity
+     * where k is the number of items in the package.
+     *
+     * Previous complexity: O(n*m) - iterate all types and all items
+     * New complexity: O(k) - direct lookup via secondary index
+     */
+    unregisterPackage(packageName: string): void;
+}
+export type MetadataItem = any;
 /**
  * Legacy Metadata interface - kept for backward compatibility
- * @deprecated Use MetadataItem from @objectql/runtime instead
+ * @deprecated Use MetadataItem from @objectstack/runtime instead
  */
 export interface Metadata {
     type: string;

package/dist/registry.js

@@ -9,11 +9,116 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetadataRegistry = void 0;
 /**
- * Re-export MetadataRegistry and MetadataItem from @objectql/runtime
+ * Optimized Metadata Registry with O(k) package uninstall complexity
  *
- * As of Week 3 refactoring, metadata management has been moved to the
- * @objectql/runtime package to enable sharing across the ecosystem.
+ * Uses secondary indexes to achieve O(k) complexity for unregisterPackage
+ * operation (where k is the number of items in the package) instead of
+ * O(n*m) (where n is types and m is items per type).
  */
-var dist_1 = require("../../../objectstack/runtime/dist");
-Object.defineProperty(exports, "MetadataRegistry", { enumerable: true, get: function () { return dist_1.MetadataRegistry; } });
+class MetadataRegistry {
+    constructor() {
+        this.items = {};
+        // Secondary index: package name -> list of metadata references
+        this.packageIndex = new Map();
+    }
+    register(type, nameOrConfig, config) {
+        if (!this.items[type]) {
+            this.items[type] = {};
+        }
+        let name;
+        let item;
+        if (config) {
+            name = nameOrConfig;
+            item = config;
+        }
+        else {
+            item = nameOrConfig;
+            name = item.name || item.id;
+        }
+        if (name) {
+            this.items[type][name] = item;
+            // Update package index
+            const packageName = item.package || item._package || item.packageName;
+            if (packageName) {
+                if (!this.packageIndex.has(packageName)) {
+                    this.packageIndex.set(packageName, new Set());
+                }
+                this.packageIndex.get(packageName).add({ type, name });
+            }
+        }
+    }
+    get(type, name) {
+        var _a;
+        const item = (_a = this.items[type]) === null || _a === void 0 ? void 0 : _a[name];
+        if (item && item.content) {
+            return item.content;
+        }
+        return item;
+    }
+    list(type) {
+        if (!this.items[type])
+            return [];
+        return Object.values(this.items[type]).map((item) => {
+            if (item && item.content) {
+                return item.content;
+            }
+            return item;
+        });
+    }
+    getTypes() {
+        return Object.keys(this.items);
+    }
+    getEntry(type, name) {
+        var _a;
+        return (_a = this.items[type]) === null || _a === void 0 ? void 0 : _a[name];
+    }
+    unregister(type, name) {
+        var _a;
+        const item = (_a = this.items[type]) === null || _a === void 0 ? void 0 : _a[name];
+        if (item) {
+            // Update package index
+            const packageName = item.package || item._package || item.packageName;
+            if (packageName) {
+                const refs = this.packageIndex.get(packageName);
+                if (refs) {
+                    // Remove this specific reference
+                    for (const ref of refs) {
+                        if (ref.type === type && ref.name === name) {
+                            refs.delete(ref);
+                            break;
+                        }
+                    }
+                    // Clean up empty package entries
+                    if (refs.size === 0) {
+                        this.packageIndex.delete(packageName);
+                    }
+                }
+            }
+            delete this.items[type][name];
+        }
+    }
+    /**
+     * Optimized package unregistration with O(k) complexity
+     * where k is the number of items in the package.
+     *
+     * Previous complexity: O(n*m) - iterate all types and all items
+     * New complexity: O(k) - direct lookup via secondary index
+     */
+    unregisterPackage(packageName) {
+        var _a;
+        // Direct lookup via secondary index ✅
+        const refs = this.packageIndex.get(packageName);
+        if (refs) {
+            // Delete each item referenced by this package
+            for (const ref of refs) {
+                if ((_a = this.items[ref.type]) === null || _a === void 0 ? void 0 : _a[ref.name]) {
+                    delete this.items[ref.type][ref.name];
+                }
+            }
+            // Remove package from index
+            this.packageIndex.delete(packageName);
+        }
+    }
+}
+exports.MetadataRegistry = MetadataRegistry;
 //# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;GAKG;AACH,0DAAmF;AAA1E,wGAAA,gBAAgB,OAAA"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -109,12 +109,26 @@ export interface BusinessRuleConstraint {
     expression?: string;
     /** Relationships needed for the rule */
     relationships?: Record<string, ValidationRelationship>;
-    /** Logical AND conditions */
-    all_of?: ValidationCondition[];
-    /** Logical OR conditions */
-    any_of?: ValidationCondition[];
-    /** Required field condition */
-    then_require?: ValidationCondition[];
+    /**
+     * Logical AND conditions (all must be true).
+     * Can be an array of field names (checks if fields are present and non-empty)
+     * or ValidationCondition objects for more complex validations.
+     */
+    all_of?: (string | ValidationCondition)[];
+    /**
+     * Logical OR conditions (at least one must be true).
+     * Can be an array of field names (checks if at least one field is present and non-empty)
+     * or ValidationCondition objects for more complex validations.
+     */
+    any_of?: (string | ValidationCondition)[];
+    /** Conditional field check - if this field is truthy, then_require fields must be present */
+    if_field?: string;
+    /**
+     * Required fields when if_field condition is met.
+     * Can be an array of field names (checks if fields are present and non-empty)
+     * or ValidationCondition objects for more complex validations.
+     */
+    then_require?: (string | ValidationCondition)[];
 }
 /**
  * Field validation configuration (built into FieldConfig).
@@ -172,11 +186,22 @@ export interface ValidationRule {
 }
 /**
  * Cross-field validation rule.
+ * Supports two formats:
+ * 1. Using the 'rule' property with a ValidationCondition object
+ * 2. Shorthand format with field, operator, and value/compare_to properties directly on the rule
  */
 export interface CrossFieldValidationRule extends ValidationRule {
     type: 'cross_field';
     /** The validation rule to apply */
     rule?: ValidationCondition;
+    /** Shorthand: Field to check (alternative to using rule property) */
+    field?: string;
+    /** Shorthand: Comparison operator (alternative to using rule property) */
+    operator?: ValidationOperator;
+    /** Shorthand: Value to compare against (mutually exclusive with compare_to) */
+    value?: any;
+    /** Shorthand: Field name to compare against for cross-field validation (mutually exclusive with value) */
+    compare_to?: string;
 }
 /**
  * Business rule validation.

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA2XH;;GAEG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACtC,YACI,OAAe,EACR,OAA+B,EAC/B,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,YAAO,GAAP,OAAO,CAAwB;QAC/B,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AATD,0CASC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAoZH;;GAEG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACtC,YACI,OAAe,EACR,OAA+B,EAC/B,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,YAAO,GAAP,OAAO,CAAwB;QAC/B,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AATD,0CASC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectql/types",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "description": "Pure TypeScript type definitions and interfaces for the ObjectQL protocol - The Contract",
   "keywords": [
     "objectql",
@@ -26,13 +26,13 @@
     "generate:schemas": "node scripts/generate-schemas.js",
     "test": "jest --passWithNoTests"
   },
-  "peerDependencies": {
-    "@objectstack/spec": "^0.3.1",
-    "@objectql/runtime": "^0.2.0"
+  "peerDependencies": {},
+  "dependencies": {
+    "@objectstack/spec": "^0.8.0",
+    "@objectstack/objectql": "^0.8.0"
   },
   "devDependencies": {
-    "@objectstack/spec": "^0.3.1",
-    "@objectql/runtime": "workspace:*",
-    "ts-json-schema-generator": "^2.4.0"
+    "ts-json-schema-generator": "^2.4.0",
+    "zod": "^3.23.8"
   }
 }