@objectql/types 4.2.0 → 4.2.2

package/dist/action.d.ts

@@ -36,7 +36,7 @@ export type ActionInputDefinition = Record<string, FieldConfig>;
  *
  * RUNTIME TYPE: Used during action execution.
  */
-export interface ActionContext<BaseT = any, InputT = any> {
+export interface ActionContext<_BaseT = Record<string, unknown>, InputT = Record<string, unknown>> {
     /** The object this action belongs to. */
     objectName: string;
     /** The name of the action being executed. */
@@ -59,7 +59,7 @@ export interface ActionContext<BaseT = any, InputT = any> {
      */
     user?: {
         id: string | number;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 /**
@@ -101,10 +101,10 @@ export interface ActionConfig {
  *
  * RUNTIME TYPE: Includes the handler function for execution.
  */
-export interface ActionDefinition<BaseT = any, InputT = any, ReturnT = any> extends ActionConfig {
+export interface ActionDefinition<BaseT = Record<string, unknown>, InputT = Record<string, unknown>, ReturnT = unknown> extends ActionConfig {
     /**
      * The business logic implementation.
      */
     handler: (ctx: ActionContext<BaseT, InputT>) => Promise<ReturnT>;
 }
-export type ActionHandler<BaseT = any, InputT = any, ReturnT = any> = (ctx: ActionContext<BaseT, InputT>) => Promise<ReturnT>;
+export type ActionHandler<BaseT = Record<string, unknown>, InputT = Record<string, unknown>, ReturnT = unknown> = (ctx: ActionContext<BaseT, InputT>) => Promise<ReturnT>;

package/dist/api.d.ts

@@ -27,7 +27,23 @@ export declare enum ApiErrorCode {
     CONFLICT = "CONFLICT",
     INTERNAL_ERROR = "INTERNAL_ERROR",
     DATABASE_ERROR = "DATABASE_ERROR",
-    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED"
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    DRIVER_ERROR = "DRIVER_ERROR",
+    DRIVER_CONNECTION_FAILED = "DRIVER_CONNECTION_FAILED",
+    DRIVER_QUERY_FAILED = "DRIVER_QUERY_FAILED",
+    DRIVER_TRANSACTION_FAILED = "DRIVER_TRANSACTION_FAILED",
+    DRIVER_UNSUPPORTED_OPERATION = "DRIVER_UNSUPPORTED_OPERATION",
+    PROTOCOL_ERROR = "PROTOCOL_ERROR",
+    PROTOCOL_INVALID_REQUEST = "PROTOCOL_INVALID_REQUEST",
+    PROTOCOL_METHOD_NOT_FOUND = "PROTOCOL_METHOD_NOT_FOUND",
+    PROTOCOL_BATCH_ERROR = "PROTOCOL_BATCH_ERROR",
+    TENANT_ISOLATION_VIOLATION = "TENANT_ISOLATION_VIOLATION",
+    TENANT_NOT_FOUND = "TENANT_NOT_FOUND",
+    WORKFLOW_TRANSITION_DENIED = "WORKFLOW_TRANSITION_DENIED",
+    FORMULA_EVALUATION_ERROR = "FORMULA_EVALUATION_ERROR",
+    CONFIG_ERROR = "CONFIG_ERROR",
+    SCAFFOLD_ERROR = "SCAFFOLD_ERROR",
+    MIGRATION_ERROR = "MIGRATION_ERROR"
 }
 /**
  * Error details structure with optional field-specific information
@@ -79,7 +95,7 @@ export interface PaginationMeta {
 /**
  * Base response structure for Data API operations
  */
-export interface DataApiResponse<T = unknown> {
+export interface DataApiResponse<_T = unknown> {
     /** Error information if the operation failed */
     error?: ApiError;
     /** Additional response fields for successful operations */
@@ -185,7 +201,7 @@ export interface DataApiDeleteResponse extends DataApiResponse {
 /**
  * Base response structure for Metadata API operations
  */
-export interface MetadataApiResponse<T = unknown> {
+export interface MetadataApiResponse<_T = unknown> {
     /** Error information if the operation failed */
     error?: ApiError;
     /** Additional response fields */

package/dist/api.js

@@ -26,6 +26,26 @@ var ApiErrorCode;
     ApiErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
     ApiErrorCode["DATABASE_ERROR"] = "DATABASE_ERROR";
     ApiErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    // Driver error codes
+    ApiErrorCode["DRIVER_ERROR"] = "DRIVER_ERROR";
+    ApiErrorCode["DRIVER_CONNECTION_FAILED"] = "DRIVER_CONNECTION_FAILED";
+    ApiErrorCode["DRIVER_QUERY_FAILED"] = "DRIVER_QUERY_FAILED";
+    ApiErrorCode["DRIVER_TRANSACTION_FAILED"] = "DRIVER_TRANSACTION_FAILED";
+    ApiErrorCode["DRIVER_UNSUPPORTED_OPERATION"] = "DRIVER_UNSUPPORTED_OPERATION";
+    // Protocol error codes
+    ApiErrorCode["PROTOCOL_ERROR"] = "PROTOCOL_ERROR";
+    ApiErrorCode["PROTOCOL_INVALID_REQUEST"] = "PROTOCOL_INVALID_REQUEST";
+    ApiErrorCode["PROTOCOL_METHOD_NOT_FOUND"] = "PROTOCOL_METHOD_NOT_FOUND";
+    ApiErrorCode["PROTOCOL_BATCH_ERROR"] = "PROTOCOL_BATCH_ERROR";
+    // Plugin error codes
+    ApiErrorCode["TENANT_ISOLATION_VIOLATION"] = "TENANT_ISOLATION_VIOLATION";
+    ApiErrorCode["TENANT_NOT_FOUND"] = "TENANT_NOT_FOUND";
+    ApiErrorCode["WORKFLOW_TRANSITION_DENIED"] = "WORKFLOW_TRANSITION_DENIED";
+    ApiErrorCode["FORMULA_EVALUATION_ERROR"] = "FORMULA_EVALUATION_ERROR";
+    // CLI/Tool error codes
+    ApiErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
+    ApiErrorCode["SCAFFOLD_ERROR"] = "SCAFFOLD_ERROR";
+    ApiErrorCode["MIGRATION_ERROR"] = "MIGRATION_ERROR";
 })(ApiErrorCode || (exports.ApiErrorCode = ApiErrorCode = {}));
 /**
  * ObjectQL Error class for throwing structured errors

package/dist/api.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAqlBH,4CASC;AAhlBD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,IAAY,YAkCX;AAlCD,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;IAE3C,qBAAqB;IACrB,6CAA6B,CAAA;IAC7B,qEAAqD,CAAA;IACrD,2DAA2C,CAAA;IAC3C,uEAAuD,CAAA;IACvD,6EAA6D,CAAA;IAE7D,uBAAuB;IACvB,iDAAiC,CAAA;IACjC,qEAAqD,CAAA;IACrD,uEAAuD,CAAA;IACvD,6DAA6C,CAAA;IAE7C,qBAAqB;IACrB,yEAAyD,CAAA;IACzD,qDAAqC,CAAA;IACrC,yEAAyD,CAAA;IACzD,qEAAqD,CAAA;IAErD,uBAAuB;IACvB,6CAA6B,CAAA;IAC7B,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;AACvC,CAAC,EAlCW,YAAY,4BAAZ,YAAY,QAkCvB;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,KAA8G,CAAC;QACxI,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

@@ -22,10 +22,10 @@ export interface IObjectQL {
     on(event: HookName, objectName: string, handler: HookHandler): void;
     triggerHook(event: HookName, objectName: string, ctx: HookContext): Promise<void>;
     registerAction(objectName: string, actionName: string, handler: ActionHandler): void;
-    executeAction(objectName: string, actionName: string, ctx: ActionContext): Promise<any>;
+    executeAction(objectName: string, actionName: string, ctx: ActionContext): Promise<unknown>;
     /**
      * Get the underlying ObjectKernel instance
      * @returns The ObjectKernel instance
      */
-    getKernel(): any;
+    getKernel(): unknown;
 }

package/dist/application.d.ts

@@ -41,5 +41,5 @@ export interface AppConfig {
     /**
      * Custom metadata/settings
      */
-    [key: string]: any;
+    [key: string]: unknown;
 }

package/dist/context.d.ts

@@ -23,7 +23,7 @@ export interface ObjectQLContext {
      * Execute a function within a transaction.
      * The callback receives a new context 'trxCtx' which inherits userId, spaceId from this context.
      */
-    transaction(callback: (trxCtx: ObjectQLContext) => Promise<any>): Promise<any>;
+    transaction(callback: (trxCtx: ObjectQLContext) => Promise<unknown>): Promise<unknown>;
     /**
      * Returns a new context with system privileges (isSystem: true).
      * It shares the same transaction scope as the current context.
@@ -32,7 +32,7 @@ export interface ObjectQLContext {
     /**
      * Internal: Driver-specific transaction handle.
      */
-    transactionHandle?: any;
+    transactionHandle?: unknown;
 }
 export interface ObjectQLContextOptions {
     userId?: string;

package/dist/driver.d.ts

@@ -16,7 +16,7 @@ export interface IntrospectedColumn {
     /** Whether the column is nullable */
     nullable: boolean;
     /** Default value if any */
-    defaultValue?: any;
+    defaultValue?: unknown;
     /** Whether this is a primary key */
     isPrimary?: boolean;
     /** Whether this column has a unique constraint */
@@ -59,8 +59,10 @@ export interface IntrospectedSchema {
 }
 /**
  * Transaction isolation levels supported by the driver.
+ *
+ * Aligned with @objectstack/spec DriverCapabilitiesSchema — uses snake_case per protocol convention.
  */
-export type IsolationLevel = 'read-uncommitted' | 'read-committed' | 'repeatable-read' | 'serializable';
+export type IsolationLevel = 'read_uncommitted' | 'read_committed' | 'repeatable_read' | 'serializable' | 'snapshot';
 /**
  * Driver Capabilities
  *
@@ -104,6 +106,21 @@ export interface DriverCapabilities {
     readonly preparedStatements?: boolean;
     readonly queryCache?: boolean;
 }
+/**
+ * Runtime Driver Capabilities (extends spec with sync-specific properties)
+ *
+ * These properties are NOT part of the @objectstack/spec DriverCapabilitiesSchema
+ * (which sets additionalProperties: false). They are runtime-only extensions
+ * used by the Offline-First Sync Protocol (Q3).
+ *
+ * Use this interface for drivers that need sync capabilities.
+ */
+export interface RuntimeDriverCapabilities extends DriverCapabilities {
+    /** Driver can record mutations to an append-only log for offline sync */
+    readonly mutationLog?: boolean;
+    /** Driver supports checkpoint-based change tracking */
+    readonly changeTracking?: boolean;
+}
 /**
  * Driver type discriminator — aligned with @objectstack/spec DriverConfigSchema.
  */
@@ -116,6 +133,15 @@ export interface BaseDriverConfig {
     /** Driver type discriminator */
     readonly type?: DriverType;
 }
+/**
+ * Database driver interface. All storage backends implement this contract.
+ *
+ * Type strategy:
+ * - `Record<string, unknown>` for data payloads (plain field-value maps)
+ * - `object` for query/filter/command parameters that may receive named interfaces
+ *   (e.g., UnifiedQuery, Filter) which lack implicit index signatures
+ * - `unknown` for opaque values (transaction handles, heterogeneous returns)
+ */
 export interface Driver {
     /** Driver identifier (e.g., 'memory', 'sql', 'mongo') */
     readonly name?: string;
@@ -123,59 +149,122 @@ export interface Driver {
     readonly version?: string;
     /** Capabilities declaration — what this driver supports */
     readonly supports?: DriverCapabilities;
-    find(objectName: string, query: any, options?: any): Promise<any[]>;
-    findOne(objectName: string, id: string | number, query?: any, options?: any): Promise<any>;
-    create(objectName: string, data: any, options?: any): Promise<any>;
-    update(objectName: string, id: string | number, data: any, options?: any): Promise<any>;
-    delete(objectName: string, id: string | number, options?: any): Promise<any>;
-    count(objectName: string, filters: any, options?: any): Promise<number>;
+    find(objectName: string, query: object, options?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    findOne(objectName: string, id: string | number, query?: object, options?: Record<string, unknown>): Promise<Record<string, unknown> | null>;
+    create(objectName: string, data: Record<string, unknown>, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update(objectName: string, id: string | number, data: Record<string, unknown>, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    delete(objectName: string, id: string | number, options?: Record<string, unknown>): Promise<unknown>;
+    count(objectName: string, filters: object, options?: Record<string, unknown>): Promise<number>;
     connect?(): Promise<void>;
     disconnect?(): Promise<void>;
     checkHealth?(): Promise<boolean>;
-    execute?(command: any, parameters?: any[], options?: any): Promise<any>;
-    bulkCreate?(objectName: string, data: any[], options?: any): Promise<any>;
+    execute?(command: object, parameters?: unknown[], options?: Record<string, unknown>): Promise<unknown>;
+    bulkCreate?(objectName: string, data: Record<string, unknown>[], options?: Record<string, unknown>): Promise<unknown>;
     bulkUpdate?(objectName: string, updates: Array<{
         id: string | number;
-        data: any;
-    }>, options?: any): Promise<any>;
-    bulkDelete?(objectName: string, ids: Array<string | number>, options?: any): Promise<any>;
-    distinct?(objectName: string, field: string, filters?: any, options?: any): Promise<any[]>;
-    aggregate?(objectName: string, query: any, options?: any): Promise<any[]>;
-    beginTransaction?(): Promise<any>;
-    commitTransaction?(transaction: any): Promise<void>;
-    rollbackTransaction?(transaction: any): Promise<void>;
-    init?(objects: any[]): Promise<void>;
+        data: Record<string, unknown>;
+    }>, options?: Record<string, unknown>): Promise<unknown>;
+    bulkDelete?(objectName: string, ids: Array<string | number>, options?: Record<string, unknown>): Promise<unknown>;
+    distinct?(objectName: string, field: string, filters?: object, options?: Record<string, unknown>): Promise<unknown[]>;
+    aggregate?(objectName: string, query: object, options?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    beginTransaction?(): Promise<unknown>;
+    /** @deprecated Use `commit` — aligned with @objectstack/spec DriverInterfaceSchema. Will be removed in v5.0. */
+    commitTransaction?(transaction: unknown): Promise<void>;
+    /** @deprecated Use `rollback` — aligned with @objectstack/spec DriverInterfaceSchema. Will be removed in v5.0. */
+    rollbackTransaction?(transaction: unknown): Promise<void>;
+    /** Commit a transaction (spec-aligned name) */
+    commit?(transaction: unknown): Promise<void>;
+    /** Rollback a transaction (spec-aligned name) */
+    rollback?(transaction: unknown): Promise<void>;
+    init?(objects: object[]): Promise<void>;
     /**
      * Introspect the database schema to discover existing tables, columns, and relationships.
      * @returns Complete schema information including tables, columns, and foreign keys
      */
     introspectSchema?(): Promise<IntrospectedSchema>;
-    createMany?(objectName: string, data: any[], options?: any): Promise<any>;
-    updateMany?(objectName: string, filters: any, data: any, options?: any): Promise<any>;
-    deleteMany?(objectName: string, filters: any, options?: any): Promise<any>;
-    findOneAndUpdate?(objectName: string, filters: any, update: any, options?: any): Promise<any>;
+    createMany?(objectName: string, data: Record<string, unknown>[], options?: Record<string, unknown>): Promise<unknown>;
+    updateMany?(objectName: string, filters: object, data: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
+    deleteMany?(objectName: string, filters: object, options?: Record<string, unknown>): Promise<unknown>;
+    findOneAndUpdate?(objectName: string, filters: object, update: Record<string, unknown>, options?: Record<string, unknown>): Promise<Record<string, unknown> | null>;
     /**
      * Execute a query using QueryAST format (DriverInterface v4.0)
      */
-    executeQuery?(ast: any, options?: any): Promise<{
-        value: any[];
+    executeQuery?(ast: object, options?: Record<string, unknown>): Promise<{
+        value: Record<string, unknown>[];
         count?: number;
     }>;
     /**
      * Execute a command using Command format (DriverInterface v4.0)
      */
-    executeCommand?(command: any, options?: any): Promise<{
+    executeCommand?(command: object, options?: Record<string, unknown>): Promise<{
         success: boolean;
-        data?: any;
+        data?: unknown;
         affected: number;
     }>;
     /**
      * Alternative method name for findOne (some drivers use 'get')
      */
-    get?(objectName: string, id: string, options?: any): Promise<any>;
+    get?(objectName: string, id: string, options?: Record<string, unknown>): Promise<Record<string, unknown> | null>;
     /**
      * Direct query execution (legacy)
      */
-    directQuery?(sql: string, params?: any[]): Promise<any[]>;
-    query?(sql: string, params?: any[]): Promise<any[]>;
+    directQuery?(sql: string, params?: unknown[]): Promise<Record<string, unknown>[]>;
+    query?(sql: string, params?: unknown[]): Promise<Record<string, unknown>[]>;
+    /**
+     * Upsert (create or update) a record.
+     * If the record exists (matched by ID or unique key), update it; otherwise, create it.
+     *
+     * @param objectName - The object name.
+     * @param data - Key-value map of field data (must include ID or unique key).
+     * @param options - Driver options.
+     * @returns The upserted record.
+     */
+    upsert?(objectName: string, data: Record<string, unknown>, options?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Stream records matching the structured query.
+     * Optimized for large datasets to avoid memory overflow.
+     *
+     * @param objectName - The name of the object.
+     * @param query - The structured QueryAST.
+     * @param options - Driver options.
+     * @returns AsyncIterable/ReadableStream of records.
+     */
+    findStream?(objectName: string, query: object, options?: Record<string, unknown>): AsyncIterable<Record<string, unknown>> | unknown;
+    /**
+     * Get connection pool statistics.
+     * Useful for monitoring database load.
+     *
+     * @returns Pool stats object, or undefined if pooling is not supported by the driver.
+     */
+    getPoolStats?(): {
+        total: number;
+        idle: number;
+        active: number;
+        waiting: number;
+    } | undefined;
+    /**
+     * Synchronize the schema for one or more objects.
+     * Creates or alters tables/collections to match the object definitions.
+     *
+     * @param objects - Object definitions to synchronize.
+     * @param options - Driver options.
+     */
+    syncSchema?(objects: object[], options?: Record<string, unknown>): Promise<void>;
+    /**
+     * Drop a table/collection by name.
+     *
+     * @param objectName - The name of the object/table to drop.
+     * @param options - Driver options.
+     */
+    dropTable?(objectName: string, options?: Record<string, unknown>): Promise<void>;
+    /**
+     * Explain the execution plan for a query.
+     * Useful for debugging and performance optimization.
+     *
+     * @param objectName - The name of the object.
+     * @param query - The structured QueryAST.
+     * @param options - Driver options.
+     * @returns Execution plan details.
+     */
+    explain?(objectName: string, query: object, options?: Record<string, unknown>): Promise<unknown>;
 }

package/dist/edge.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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.
+ */
+/**
+ * Supported edge runtime environments.
+ */
+export type EdgeRuntime = 'cloudflare-workers' | 'deno-deploy' | 'vercel-edge' | 'bun' | 'node';
+/**
+ * Edge-specific driver binding.
+ *
+ * Maps an ObjectQL driver to an edge-platform-native storage primitive.
+ * For example, Cloudflare Workers binds `driver-sqlite-wasm` to D1.
+ */
+export interface EdgeDriverBinding {
+    /**
+     * The ObjectQL driver package name.
+     * e.g., `'@objectql/driver-memory'`, `'@objectql/driver-sqlite-wasm'`
+     */
+    readonly driver: string;
+    /**
+     * Edge-platform binding name (environment variable or resource identifier).
+     * e.g., `'D1_DATABASE'` for Cloudflare D1, `'POSTGRES_URL'` for Deno Postgres.
+     */
+    readonly binding?: string;
+    /**
+     * Driver-specific configuration overrides for the edge environment.
+     */
+    readonly config?: Record<string, unknown>;
+}
+/**
+ * Edge runtime adapter configuration.
+ *
+ * Declares how ObjectQL should adapt to a specific edge runtime.
+ * Used by the edge adapter packages (e.g., `@objectql/adapter-cloudflare`).
+ */
+export interface EdgeAdapterConfig {
+    /** Target edge runtime */
+    readonly runtime: EdgeRuntime;
+    /**
+     * Driver bindings for this edge environment.
+     * Maps datasource names to edge-specific driver bindings.
+     */
+    readonly bindings?: Record<string, EdgeDriverBinding>;
+    /**
+     * Maximum execution time in milliseconds.
+     * Edge runtimes impose strict CPU time limits.
+     * Default varies by runtime (e.g., 30000 for Cloudflare Workers).
+     */
+    readonly maxExecutionTime?: number;
+    /**
+     * Enable request-scoped driver connections.
+     * Edge runtimes are stateless; connections are created per-request.
+     * Default: true
+     */
+    readonly requestScoped?: boolean;
+}
+/**
+ * Edge runtime environment capabilities.
+ *
+ * Declares what platform APIs are available in the target edge runtime.
+ * Used by ObjectQL to select compatible code paths.
+ */
+export interface EdgeCapabilities {
+    /** WebAssembly support */
+    readonly wasm: boolean;
+    /** Persistent storage available (OPFS, KV, D1, etc.) */
+    readonly persistentStorage: boolean;
+    /** WebSocket support for real-time sync */
+    readonly webSocket: boolean;
+    /** Cron/scheduled trigger support */
+    readonly scheduledTriggers: boolean;
+    /** Maximum request body size in bytes */
+    readonly maxRequestBodySize?: number;
+    /** Maximum execution time in milliseconds */
+    readonly maxExecutionTime?: number;
+    /** Available storage primitives */
+    readonly storagePrimitives: readonly string[];
+}
+/**
+ * Predefined edge capability profiles for known runtimes.
+ */
+export declare const EDGE_CAPABILITIES: Readonly<Record<EdgeRuntime, EdgeCapabilities>>;

package/dist/edge.js

@@ -0,0 +1,61 @@
+"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.EDGE_CAPABILITIES = void 0;
+/**
+ * Predefined edge capability profiles for known runtimes.
+ */
+exports.EDGE_CAPABILITIES = {
+    'cloudflare-workers': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: true,
+        maxRequestBodySize: 100 * 1024 * 1024, // 100MB
+        maxExecutionTime: 30000,
+        storagePrimitives: ['D1', 'KV', 'R2', 'Durable Objects'],
+    },
+    'deno-deploy': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: true,
+        maxRequestBodySize: 512 * 1024, // 512KB
+        maxExecutionTime: 50000,
+        storagePrimitives: ['Deno KV', 'Deno Postgres'],
+    },
+    'vercel-edge': {
+        wasm: true,
+        persistentStorage: false,
+        webSocket: false,
+        scheduledTriggers: false,
+        maxRequestBodySize: 4 * 1024 * 1024, // 4MB
+        maxExecutionTime: 25000,
+        storagePrimitives: ['KV (via Vercel KV)', 'Postgres (via Vercel Postgres)'],
+    },
+    'bun': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: false,
+        maxRequestBodySize: Infinity,
+        maxExecutionTime: Infinity,
+        storagePrimitives: ['SQLite (bun:sqlite)', 'File System'],
+    },
+    'node': {
+        wasm: true,
+        persistentStorage: true,
+        webSocket: true,
+        scheduledTriggers: false,
+        maxRequestBodySize: Infinity,
+        maxExecutionTime: Infinity,
+        storagePrimitives: ['All drivers'],
+    },
+};
+//# sourceMappingURL=edge.js.map

package/dist/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAqGH;;GAEG;AACU,QAAA,iBAAiB,GAAoD;IAC9E,oBAAoB,EAAE;QAClB,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;QAC/C,gBAAgB,EAAE,KAAM;QACxB,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC;KAC3D;IACD,aAAa,EAAE;QACX,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,GAAG,GAAG,IAAI,EAAE,QAAQ;QACxC,gBAAgB,EAAE,KAAM;QACxB,iBAAiB,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;KAClD;IACD,aAAa,EAAE;QACX,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,KAAK;QACxB,SAAS,EAAE,KAAK;QAChB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,MAAM;QAC3C,gBAAgB,EAAE,KAAM;QACxB,iBAAiB,EAAE,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;KAC9E;IACD,KAAK,EAAE;QACH,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,QAAQ;QAC5B,gBAAgB,EAAE,QAAQ;QAC1B,iBAAiB,EAAE,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5D;IACD,MAAM,EAAE;QACJ,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,QAAQ;QAC5B,gBAAgB,EAAE,QAAQ;QAC1B,iBAAiB,EAAE,CAAC,aAAa,CAAC;KACrC;CACJ,CAAC"}

package/dist/field.d.ts

@@ -70,10 +70,10 @@ export interface ImageAttachmentData extends AttachmentData {
  * Runtime Field Type
  *
  * Extends the Protocol FieldType with runtime-specific types.
- * The Protocol Constitution defines the core field types.
- * We add runtime-specific types like 'vector', 'grid', 'location', 'object' here.
+ * The Protocol Constitution defines the core field types (including 'location' and 'vector').
+ * We add runtime-specific types like 'grid' and 'object' here.
  */
-export type FieldType = ProtocolFieldType | 'location' | 'object' | 'vector' | 'grid';
+export type FieldType = ProtocolFieldType | 'object' | 'grid';
 /**
  * Runtime Field Option
  *

package/dist/formula.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"formula.js","sourceRoot":"","sources":["../src/formula.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;GAQG;AAEH,+BAAsC;AA0OtC;;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/gateway.d.ts

@@ -10,14 +10,14 @@ export interface ApiRequest {
     path: string;
     method: ApiMethod;
     headers: Record<string, string | string[] | undefined>;
-    query: Record<string, any>;
-    body?: any;
+    query: Record<string, unknown>;
+    body?: unknown;
     protocol?: string;
 }
 export interface ApiResponse {
     status: number;
     headers?: Record<string, string | string[]>;
-    body: any;
+    body: unknown;
 }
 export interface GatewayProtocol {
     name: string;

package/dist/hook.d.ts

@@ -17,17 +17,17 @@ export type HookTiming = 'before' | 'after';
  * Minimal API surface exposed to hooks for performing side-effects or checks.
  */
 export interface HookAPI {
-    find(objectName: string, query?: any): Promise<any[]>;
-    findOne(objectName: string, id: string | number): Promise<any>;
-    count(objectName: string, query?: any): Promise<number>;
-    create(objectName: string, data: any): Promise<any>;
-    update(objectName: string, id: string | number, data: any): Promise<any>;
-    delete(objectName: string, id: string | number): Promise<any>;
+    find(objectName: string, query?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    findOne(objectName: string, id: string | number): Promise<Record<string, unknown> | null>;
+    count(objectName: string, query?: Record<string, unknown>): Promise<number>;
+    create(objectName: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update(objectName: string, id: string | number, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    delete(objectName: string, id: string | number): Promise<Record<string, unknown>>;
 }
 /**
  * Base context available in all hooks.
  */
-export interface BaseHookContext<T = any> {
+export interface BaseHookContext<_T = Record<string, unknown>> {
     /** The name of the object (entity) being acted upon. */
     objectName: string;
     /** The triggering operation. */
@@ -37,28 +37,32 @@ export interface BaseHookContext<T = any> {
     /** User/Session context (Authentication info). */
     user?: {
         id: string | number;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     /**
      * Shared state for passing data between matching 'before' and 'after' hooks.
      * e.g. Calculate a diff in 'beforeUpdate' and read it in 'afterUpdate'.
      */
-    state: Record<string, any>;
+    state: Record<string, unknown>;
 }
 /**
  * Context for Retrieval operations (Find, Count).
  */
-export interface RetrievalHookContext<T = any> extends BaseHookContext<T> {
+export interface RetrievalHookContext<T = Record<string, unknown>> extends BaseHookContext<T> {
     operation: 'find' | 'count';
-    /** The query criteria being executed. Modifiable in 'before' hooks. */
-    query: any;
+    /**
+     * The query criteria being executed. Modifiable in 'before' hooks.
+     * Typed as `object` (not `Record<string, unknown>`) because named interfaces
+     * like UnifiedQuery lack index signatures and aren't assignable to Record types.
+     */
+    query: object;
     /** The result of the query. Only available in 'after' hooks. */
     result?: T[] | number;
 }
 /**
  * Context for Modification operations (Create, Update, Delete).
  */
-export interface MutationHookContext<T = any> extends BaseHookContext<T> {
+export interface MutationHookContext<T = Record<string, unknown>> extends BaseHookContext<T> {
     operation: 'create' | 'update' | 'delete';
     /** The record ID. Undefined for 'create'. */
     id?: string | number;
@@ -83,7 +87,7 @@ export interface MutationHookContext<T = any> extends BaseHookContext<T> {
 /**
  * Specialized context for Updates, including change tracking.
  */
-export interface UpdateHookContext<T = any> extends MutationHookContext<T> {
+export interface UpdateHookContext<T = Record<string, unknown>> extends MutationHookContext<T> {
     operation: 'update';
     /**
      * Helper to check if a specific field is being modified.
@@ -94,7 +98,7 @@ export interface UpdateHookContext<T = any> extends MutationHookContext<T> {
 /**
  * Definition interface for a set of hooks for a specific object.
  */
-export interface ObjectHookDefinition<T = any> {
+export interface ObjectHookDefinition<T = Record<string, unknown>> {
     beforeFind?: (ctx: RetrievalHookContext<T>) => Promise<void> | void;
     afterFind?: (ctx: RetrievalHookContext<T>) => Promise<void> | void;
     beforeCount?: (ctx: RetrievalHookContext<T>) => Promise<void> | void;
@@ -107,5 +111,5 @@ export interface ObjectHookDefinition<T = any> {
     afterUpdate?: (ctx: UpdateHookContext<T>) => Promise<void> | void;
 }
 export type HookName = keyof ObjectHookDefinition;
-export type HookContext<T = any> = RetrievalHookContext<T> | MutationHookContext<T> | UpdateHookContext<T>;
-export type HookHandler<T = any> = (ctx: HookContext<T>) => Promise<void> | void;
+export type HookContext<T = Record<string, unknown>> = RetrievalHookContext<T> | MutationHookContext<T> | UpdateHookContext<T>;
+export type HookHandler<T = Record<string, unknown>> = (ctx: HookContext<T>) => Promise<void> | void;