@objectql/types 4.2.0 → 4.2.1

package/dist/index.d.ts

@@ -35,3 +35,6 @@ export * from './plugin';
 export * from './gateway';
 export * from './logger';
 export * from './ai';
+export * from './sync';
+export * from './edge';
+export * from './kernel-service';

package/dist/index.js

@@ -51,4 +51,7 @@ __exportStar(require("./plugin"), exports);
 __exportStar(require("./gateway"), exports);
 __exportStar(require("./logger"), exports);
 __exportStar(require("./ai"), exports);
+__exportStar(require("./sync"), exports);
+__exportStar(require("./edge"), exports);
+__exportStar(require("./kernel-service"), 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,2CAAyB;AACzB,gDAA8B;AAC9B,8CAA4B;AAC5B,wCAAsB;AACtB,6CAA2B;AAC3B,4CAA0B;AAC1B,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,uCAAqB"}
+{"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;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,uCAAqB;AACrB,yCAAuB;AACvB,yCAAuB;AACvB,mDAAiC"}

package/dist/kernel-service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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.
+ */
+/**
+ * Kernel Service Types
+ *
+ * Defines the 17 kernel services specified by the ObjectStack protocol.
+ * Each service maps to a set of protocol methods governed by the ObjectStackProtocol interface.
+ *
+ * @see https://protocol.objectstack.ai/docs/guides/kernel-services
+ */
+/**
+ * The 17 kernel services registered via CoreServiceName.
+ * Each service maps to a set of protocol methods.
+ */
+export type CoreServiceName = 'metadata' | 'data' | 'analytics' | 'auth' | 'ui' | 'workflow' | 'automation' | 'realtime' | 'notification' | 'ai' | 'i18n' | 'file-storage' | 'search' | 'cache' | 'queue' | 'job' | 'graphql';
+/**
+ * Criticality levels for kernel services.
+ * - required: System cannot start without this service
+ * - core: Falls back to in-memory implementation with a warning if missing
+ * - optional: Feature disabled; API returns 501 Not Implemented if missing
+ */
+export type ServiceCriticality = 'required' | 'core' | 'optional';
+/**
+ * Service availability status reported via the discovery endpoint.
+ */
+export type ServiceStatusValue = 'available' | 'degraded' | 'unavailable';
+/**
+ * Per-service status entry in the discovery response.
+ */
+export interface ServiceStatus {
+    /** Whether the service is enabled */
+    readonly enabled: boolean;
+    /** Current operational status */
+    readonly status: ServiceStatusValue;
+    /** Route mount point (if available) */
+    readonly route?: string;
+    /** Provider name (e.g., 'kernel', plugin name) */
+    readonly provider?: string;
+    /** Human-readable status message */
+    readonly message?: string;
+}
+/**
+ * Service criticality mapping per the kernel-services specification.
+ */
+export declare const SERVICE_CRITICALITY: Readonly<Record<CoreServiceName, ServiceCriticality>>;
+/**
+ * Discovery response structure returned by getDiscovery.
+ * Clients use this to determine which services are available and adapt UI accordingly.
+ */
+export interface KernelDiscoveryResponse {
+    /** Engine name */
+    readonly name: string;
+    /** API name identifier for the spec discovery endpoint */
+    readonly apiName: string;
+    /** Engine version */
+    readonly version: string;
+    /** Supported protocol transports */
+    readonly protocols: readonly string[];
+    /** Per-service status map */
+    readonly services: Readonly<Record<CoreServiceName, ServiceStatus>>;
+    /** Optional capabilities flags */
+    readonly capabilities?: {
+        readonly search: boolean;
+        readonly files: boolean;
+        readonly graphql: boolean;
+        readonly notifications: boolean;
+        readonly analytics: boolean;
+        readonly ai: boolean;
+        readonly i18n: boolean;
+        readonly workflow: boolean;
+        readonly websockets: boolean;
+    };
+    /** Optional endpoint URLs */
+    readonly endpoints?: {
+        readonly rest?: string;
+        readonly graphql?: string;
+        readonly websocket?: string;
+    };
+}

package/dist/kernel-service.js

@@ -0,0 +1,33 @@
+"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.SERVICE_CRITICALITY = void 0;
+/**
+ * Service criticality mapping per the kernel-services specification.
+ */
+exports.SERVICE_CRITICALITY = {
+    metadata: 'required',
+    data: 'required',
+    analytics: 'optional',
+    auth: 'required',
+    ui: 'optional',
+    workflow: 'optional',
+    automation: 'optional',
+    realtime: 'optional',
+    notification: 'optional',
+    ai: 'optional',
+    i18n: 'optional',
+    'file-storage': 'optional',
+    search: 'optional',
+    cache: 'core',
+    queue: 'core',
+    job: 'core',
+    graphql: 'optional',
+};
+//# sourceMappingURL=kernel-service.js.map

package/dist/kernel-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-service.js","sourceRoot":"","sources":["../src/kernel-service.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA+DH;;GAEG;AACU,QAAA,mBAAmB,GAA0D;IACtF,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,UAAU;IACrB,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,UAAU;IACd,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU;IACtB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,UAAU;IACxB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,UAAU;IAChB,cAAc,EAAE,UAAU;IAC1B,MAAM,EAAE,UAAU;IAClB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,UAAU;CACtB,CAAC"}

package/dist/loader.d.ts

@@ -17,5 +17,5 @@ export interface LoaderPlugin {
     name: string;
     glob: string[];
     handler: LoaderHandler;
-    options?: any;
+    options?: Record<string, unknown>;
 }

package/dist/object.d.ts

@@ -10,6 +10,7 @@ import { z } from 'zod';
 import { FieldConfig } from './field';
 import { ActionConfig } from './action';
 import { AnyValidationRule } from './validation';
+import { SyncConfig } from './sync';
 /**
  * Re-export Protocol Types from @objectstack/spec 1.1.0
  * State Machine, Object Ownership, and Object Extension types.
@@ -145,6 +146,19 @@ export interface ObjectConfig {
             validation_strategy?: string;
         };
     };
+    /**
+     * Offline-First Sync configuration (RUNTIME ONLY).
+     * Opt-in per object. See {@link SyncConfig} for details.
+     *
+     * @example
+     * ```yaml
+     * sync:
+     *   enabled: true
+     *   strategy: last-write-wins
+     *   conflict_fields: [status]
+     * ```
+     */
+    sync?: SyncConfig;
 }
 /**
  * Base interface for all ObjectQL documents.
@@ -155,5 +169,5 @@ export interface ObjectDoc {
     _id?: string | number;
     created_at?: Date | string;
     updated_at?: Date | string;
-    [key: string]: any;
+    [key: string]: unknown;
 }

package/dist/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,4CAAqD;AAmB5C,qFAnBA,WAAI,OAmBA;AAAE,2FAnBA,iBAAU,OAmBA"}
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,4CAAqD;AAoB5C,qFApBA,WAAI,OAoBA;AAAE,2FApBA,iBAAU,OAoBA"}

package/dist/permission.d.ts

@@ -70,7 +70,7 @@ export interface SimpleCondition {
     /** Comparison operator */
     operator: PermissionOperator;
     /** Value to compare against (can include variables like $current_user.id) */
-    value: any;
+    value: unknown;
 }
 /**
  * Simple condition element (inline form for complex expressions)
@@ -78,7 +78,7 @@ export interface SimpleCondition {
 export interface ConditionElement {
     field: string;
     operator: PermissionOperator;
-    value: any;
+    value: unknown;
 }
 /**
  * Expression element in complex conditions
@@ -208,7 +208,7 @@ export interface ActionCondition {
     /** Comparison operator */
     operator: PermissionOperator;
     /** Value to compare */
-    value: any;
+    value: unknown;
 }
 /**
  * Rate limiting configuration for actions
@@ -372,7 +372,7 @@ export interface PermissionCheckContext {
         roles?: string[];
         department_id?: string;
         team_id?: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     /** Object name */
     object: string;
@@ -383,7 +383,7 @@ export interface PermissionCheckContext {
     /** Field name (for field-level checks) */
     field?: string;
     /** Record data (for condition evaluation) */
-    record?: any;
+    record?: Record<string, unknown>;
 }
 /**
  * Result of a permission check

package/dist/plugin.d.ts

@@ -21,12 +21,12 @@ export interface RuntimeContext {
      * - action manager
      * - CRUD operations
      */
-    engine: any;
+    engine: unknown;
     /**
      * Get the kernel instance (alternative accessor)
      * Some implementations may use getKernel() instead of engine
      */
-    getKernel?: () => any;
+    getKernel?: () => unknown;
 }
 /**
  * RuntimePlugin Interface

package/dist/registry.d.ts

@@ -16,11 +16,11 @@ 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[];
+    register(type: string, nameOrConfig: string | Record<string, unknown>, config?: Record<string, unknown>): void;
+    get<T = unknown>(type: string, name: string): T;
+    list<T = unknown>(type: string): T[];
     getTypes(): string[];
-    getEntry<T = any>(type: string, name: string): T;
+    getEntry<T = unknown>(type: string, name: string): T;
     unregister(type: string, name: string): void;
     /**
      * Optimized package unregistration with O(k) complexity
@@ -31,7 +31,7 @@ export declare class MetadataRegistry {
      */
     unregisterPackage(packageName: string): void;
 }
-export type MetadataItem = any;
+export type MetadataItem = Record<string, unknown>;
 /**
  * Legacy Metadata interface - kept for backward compatibility
  * @deprecated Use MetadataItem from @objectstack/runtime instead

package/dist/registry.js

@@ -33,12 +33,12 @@ class MetadataRegistry {
         }
         else {
             item = nameOrConfig;
-            name = item.name || item.id;
+            name = (item.name || item.id);
         }
         if (name) {
             this.items[type][name] = item;
             // Update package index
-            const packageName = item.package || item._package || item.packageName;
+            const packageName = (item.package || item._package || item.packageName);
             if (packageName) {
                 if (!this.packageIndex.has(packageName)) {
                     this.packageIndex.set(packageName, new Set());
@@ -77,7 +77,7 @@ class MetadataRegistry {
         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;
+            const packageName = (item.package || item._package || item.packageName);
             if (packageName) {
                 const refs = this.packageIndex.get(packageName);
                 if (refs) {

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAUH;;;;;;GAMG;AACH,MAAa,gBAAgB;IAMzB;QALQ,UAAK,GAA4D,EAAE,CAAC;QAE5E,+DAA+D;QACvD,iBAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE5C,CAAC;IAEhB,QAAQ,CAAC,IAAY,EAAE,YAA8C,EAAE,MAAgC;QACnG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,IAAY,CAAC;QACjB,IAAI,IAA6B,CAAC;QAElC,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,GAAG,YAAsB,CAAC;YAC9B,IAAI,GAAG,MAAM,CAAC;QAClB,CAAC;aAAM,CAAC;YACJ,IAAI,GAAG,YAAuC,CAAC;YAC/C,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAW,CAAC;QAC5C,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAE9B,uBAAuB;YACvB,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAuB,CAAC;YAC9F,IAAI,WAAW,EAAE,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;oBACtC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBAClD,CAAC;gBACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;IACL,CAAC;IAED,GAAG,CAAc,IAAY,EAAE,IAAY;;QACvC,MAAM,IAAI,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,0CAAG,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,OAAY,CAAC;QAC7B,CAAC;QACD,OAAO,IAAS,CAAC;IACrB,CAAC;IAED,IAAI,CAAc,IAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAA6B,EAAE,EAAE;YACzE,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC,OAAO,CAAC;YACxB,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC,CAAQ,CAAC;IACd,CAAC;IAED,QAAQ;QACJ,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAc,IAAY,EAAE,IAAY;;QAC5C,OAAO,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,0CAAG,IAAI,CAAM,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,IAAY;;QACjC,MAAM,IAAI,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,0CAAG,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,EAAE,CAAC;YACP,uBAAuB;YACvB,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAuB,CAAC;YAC9F,IAAI,WAAW,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAChD,IAAI,IAAI,EAAE,CAAC;oBACP,iCAAiC;oBACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACrB,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;4BACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;4BACjB,MAAM;wBACV,CAAC;oBACL,CAAC;oBACD,iCAAiC;oBACjC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;wBAClB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBAC1C,CAAC;gBACL,CAAC;YACL,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,WAAmB;;QACjC,sCAAsC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,IAAI,EAAE,CAAC;YACP,8CAA8C;YAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,MAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,0CAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;YACD,4BAA4B;YAC5B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;CACJ;AA9GD,4CA8GC"}

package/dist/repository.d.ts

@@ -5,19 +5,28 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { UnifiedQuery } from "./query";
-export interface IObjectRepository {
-    find(query?: UnifiedQuery): Promise<any[]>;
-    findOne(idOrQuery: string | number | UnifiedQuery): Promise<any>;
-    count(filters: any): Promise<number>;
-    create(doc: any): Promise<any>;
-    update(id: string | number, doc: any, options?: any): Promise<any>;
-    delete(id: string | number): Promise<any>;
-    aggregate(query: any): Promise<any>;
-    distinct(field: string, filters?: any): Promise<any[]>;
-    findOneAndUpdate?(filters: any, update: any, options?: any): Promise<any>;
-    createMany(data: any[]): Promise<any>;
-    updateMany(filters: any, data: any): Promise<any>;
-    deleteMany(filters: any): Promise<any>;
-    execute(actionName: string, id: string | number | undefined, params: any): Promise<any>;
+import { UnifiedQuery, Filter } from "./query";
+/**
+ * Repository interface for CRUD operations on a single object type.
+ *
+ * Note: `object` is used for filter/query parameters instead of `Record<string, unknown>`
+ * because named TypeScript interfaces (e.g., UnifiedQuery, Filter) lack implicit index
+ * signatures and are not assignable to `Record<string, unknown>`.
+ *
+ * @typeParam T - The document shape returned by queries. Defaults to `Record<string, unknown>`.
+ */
+export interface IObjectRepository<T = Record<string, unknown>> {
+    find(query?: UnifiedQuery): Promise<T[]>;
+    findOne(idOrQuery: string | number | UnifiedQuery): Promise<T | null>;
+    count(filters: Filter | object): Promise<number>;
+    create(doc: Record<string, unknown>): Promise<T>;
+    update(id: string | number, doc: Record<string, unknown>, options?: Record<string, unknown>): Promise<T>;
+    delete(id: string | number): Promise<T>;
+    aggregate(query: object): Promise<unknown[]>;
+    distinct(field: string, filters?: Filter | object): Promise<unknown[]>;
+    findOneAndUpdate?(filters: Filter | object, update: Record<string, unknown>, options?: Record<string, unknown>): Promise<T | null>;
+    createMany(data: Record<string, unknown>[]): Promise<T[]>;
+    updateMany(filters: Filter | object, data: Record<string, unknown>): Promise<unknown>;
+    deleteMany(filters: Filter | object): Promise<unknown>;
+    execute(actionName: string, id: string | number | undefined, params: Record<string, unknown>): Promise<unknown>;
 }

package/dist/sync.d.ts

@@ -0,0 +1,184 @@
+/**
+ * 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.
+ */
+/**
+ * Sync conflict resolution strategy.
+ *
+ * - `last-write-wins`: Server accepts the most recent mutation based on timestamp.
+ * - `crdt`: Conflict-free Replicated Data Type — field-level merge without conflicts.
+ * - `manual`: Conflicts are flagged for manual resolution via a callback.
+ */
+export type SyncStrategy = 'last-write-wins' | 'crdt' | 'manual';
+/**
+ * Per-object sync configuration.
+ *
+ * Declared in `*.object.yml` under the `sync` key. Opt-in per object.
+ *
+ * @example
+ * ```yaml
+ * name: story
+ * sync:
+ *   enabled: true
+ *   strategy: last-write-wins
+ *   conflict_fields: [status]
+ * ```
+ */
+export interface SyncConfig {
+    /** Enable offline sync for this object. Default: false */
+    readonly enabled: boolean;
+    /** Conflict resolution strategy. Default: 'last-write-wins' */
+    readonly strategy?: SyncStrategy;
+    /**
+     * Fields requiring manual merge when strategy is 'last-write-wins'.
+     * Changes to these fields during concurrent edits trigger a conflict.
+     */
+    readonly conflict_fields?: readonly string[];
+    /**
+     * Sync direction.
+     * - `bidirectional`: Client ↔ Server (default)
+     * - `push-only`: Client → Server
+     * - `pull-only`: Server → Client
+     */
+    readonly direction?: 'bidirectional' | 'push-only' | 'pull-only';
+    /**
+     * Debounce interval in milliseconds before syncing mutations.
+     * Batches rapid mutations into a single sync request.
+     * Default: 1000
+     */
+    readonly debounce_ms?: number;
+    /**
+     * Maximum number of mutations to batch in a single sync request.
+     * Default: 50
+     */
+    readonly batch_size?: number;
+}
+/**
+ * Mutation operation type recorded in the client-side mutation log.
+ */
+export type MutationOperation = 'create' | 'update' | 'delete';
+/**
+ * A single entry in the client-side append-only mutation log.
+ *
+ * Recorded by WASM drivers when offline. Replayed to the server
+ * during sync to achieve eventual consistency.
+ */
+export interface MutationLogEntry {
+    /** Unique mutation identifier (UUID v7 for time-ordered sorting) */
+    readonly id: string;
+    /** Object name this mutation applies to */
+    readonly objectName: string;
+    /** Record identifier */
+    readonly recordId: string | number;
+    /** Type of mutation */
+    readonly operation: MutationOperation;
+    /**
+     * The mutation payload.
+     * - `create`: Full record data.
+     * - `update`: Partial field updates (only changed fields).
+     * - `delete`: undefined.
+     */
+    readonly data?: Record<string, unknown>;
+    /** ISO 8601 timestamp when the mutation was recorded on the client */
+    readonly timestamp: string;
+    /** Client device identifier for multi-device conflict resolution */
+    readonly clientId: string;
+    /** Monotonically increasing sequence number per client */
+    readonly sequence: number;
+    /**
+     * Server-assigned version of the record at the time of mutation.
+     * Used for optimistic concurrency during sync.
+     * `null` for new records created offline.
+     */
+    readonly baseVersion: number | null;
+}
+/**
+ * Conflict descriptor returned when the server detects a merge conflict.
+ */
+export interface SyncConflict {
+    /** Object name */
+    readonly objectName: string;
+    /** Record identifier */
+    readonly recordId: string | number;
+    /** The client's mutation that caused the conflict */
+    readonly clientMutation: MutationLogEntry;
+    /** Current server-side record state */
+    readonly serverRecord: Record<string, unknown>;
+    /** Fields that are in conflict */
+    readonly conflictingFields: readonly string[];
+    /** Suggested resolution (server-computed) */
+    readonly suggestedResolution?: Record<string, unknown>;
+}
+/**
+ * Outcome of a single mutation during sync.
+ */
+export type SyncMutationResult = {
+    readonly status: 'applied';
+    readonly serverVersion: number;
+} | {
+    readonly status: 'conflict';
+    readonly conflict: SyncConflict;
+} | {
+    readonly status: 'rejected';
+    readonly reason: string;
+};
+/**
+ * Client → Server sync request payload.
+ */
+export interface SyncPushRequest {
+    /** Client device identifier */
+    readonly clientId: string;
+    /** Mutations to push, ordered by sequence number */
+    readonly mutations: readonly MutationLogEntry[];
+    /**
+     * Last server checkpoint the client has seen.
+     * The server uses this to determine what changes to send back.
+     */
+    readonly lastCheckpoint: string | null;
+}
+/**
+ * Server → Client sync response payload.
+ */
+export interface SyncPushResponse {
+    /** Results for each pushed mutation (same order as request) */
+    readonly results: readonly SyncMutationResult[];
+    /** Server changes since the client's lastCheckpoint */
+    readonly serverChanges: readonly SyncServerChange[];
+    /** New checkpoint for the client to store */
+    readonly checkpoint: string;
+}
+/**
+ * A server-side change to be applied on the client.
+ */
+export interface SyncServerChange {
+    /** Object name */
+    readonly objectName: string;
+    /** Record identifier */
+    readonly recordId: string | number;
+    /** Operation that occurred on the server */
+    readonly operation: MutationOperation;
+    /** Record data (full for create, partial for update, undefined for delete) */
+    readonly data?: Record<string, unknown>;
+    /** Server version after this change */
+    readonly serverVersion: number;
+    /** ISO 8601 timestamp of the server change */
+    readonly timestamp: string;
+}
+/**
+ * Sync endpoint configuration for the server-side sync service.
+ */
+export interface SyncEndpointConfig {
+    /** Enable the sync endpoint. Default: false */
+    readonly enabled: boolean;
+    /** URL path for the sync endpoint. Default: '/api/sync' */
+    readonly path?: string;
+    /** Maximum mutations per push request. Default: 100 */
+    readonly maxMutationsPerRequest?: number;
+    /** Maximum age (in days) for server-side change log retention. Default: 30 */
+    readonly changeLogRetentionDays?: number;
+    /** Enable WebSocket for real-time push from server. Default: false */
+    readonly realtime?: boolean;
+}

package/dist/sync.js

@@ -0,0 +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=sync.js.map

package/dist/sync.js.map

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

package/dist/validation.d.ts

@@ -43,8 +43,8 @@ export interface ValidationAiContext {
     external_dependency?: string;
     /** Examples of valid/invalid data */
     examples?: {
-        valid?: any[];
-        invalid?: any[];
+        valid?: unknown[];
+        invalid?: unknown[];
     };
     /** Algorithm description for complex validation */
     algorithm?: string;
@@ -66,7 +66,7 @@ export interface ValidationCondition {
     /** Comparison operator */
     operator?: ValidationOperator;
     /** Value to compare against */
-    value?: any;
+    value?: unknown;
     /** Field name to compare against (for cross-field validation) */
     compare_to?: string;
     /** Expression to evaluate */
@@ -199,7 +199,7 @@ export interface CrossFieldValidationRule extends ValidationRule {
     /** Shorthand: Comparison operator (alternative to using rule property) */
     operator?: ValidationOperator;
     /** Shorthand: Value to compare against (mutually exclusive with compare_to) */
-    value?: any;
+    value?: unknown;
     /** Shorthand: Field name to compare against for cross-field validation (mutually exclusive with value) */
     compare_to?: string;
 }
@@ -223,7 +223,7 @@ export interface StateMachineValidationRule extends ValidationRule {
     /** Initial states */
     initial_states?: string[];
     /** Transition conditions */
-    transition_conditions?: Record<string, any>;
+    transition_conditions?: Record<string, unknown>;
 }
 /**
  * Uniqueness validation rule.
@@ -266,7 +266,7 @@ export interface CustomValidationRule extends ValidationRule {
     /** Error message template */
     error_message_template?: string;
     /** Message parameters */
-    message_params?: Record<string, any>;
+    message_params?: Record<string, unknown>;
 }
 /**
  * Union type for all validation rules.
@@ -313,18 +313,18 @@ export interface ValidationContext {
     /** Previous record data (for updates) */
     previousRecord?: ObjectDoc;
     /** Current user */
-    user?: any;
+    user?: unknown;
     /** API access for queries */
-    api?: any;
+    api?: unknown;
     /** HTTP client for external calls */
-    http?: any;
+    http?: unknown;
     /** Operation type */
     operation: ValidationTrigger;
     /** Additional metadata */
     metadata?: {
         objectName: string;
         ruleName: string;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     /** Changed fields (for updates) */
     changedFields?: string[];
@@ -346,7 +346,7 @@ export interface ValidationRuleResult {
     /** Field(s) that failed validation */
     fields?: string[];
     /** Additional context */
-    context?: any;
+    context?: unknown;
 }
 /**
  * Overall validation result for a record.