@objectql/types 4.1.0 → 4.2.1

package/dist/logger.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * ObjectQL - Logger Type Definitions
+ * 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.
+ *
+ * Defines the canonical Logger interface for the ObjectQL ecosystem.
+ * All packages must use this interface instead of direct console.* calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullLogger = exports.ConsoleLogger = void 0;
+/**
+ * Console-based Logger implementation
+ *
+ * A zero-dependency reference implementation suitable for:
+ * - Unit tests (without mocking an external logger library)
+ * - Development environments
+ * - Packages that cannot depend on `@objectstack/core`
+ *
+ * For production use, prefer the structured logger from `@objectstack/core`.
+ */
+class ConsoleLogger {
+    constructor(config) {
+        var _a;
+        this.name = config.name;
+        this.level = (_a = config.level) !== null && _a !== void 0 ? _a : 'info';
+    }
+    shouldLog(level) {
+        return ConsoleLogger.LEVELS[level] >= ConsoleLogger.LEVELS[this.level];
+    }
+    format(level, message, data) {
+        const ts = new Date().toISOString();
+        const prefix = `${ts} [${level.toUpperCase().padEnd(5)}] [${this.name}]`;
+        if (data && Object.keys(data).length > 0) {
+            return `${prefix} ${message} ${JSON.stringify(data)}`;
+        }
+        return `${prefix} ${message}`;
+    }
+    trace(message, data) {
+        if (this.shouldLog('trace'))
+            console.debug(this.format('trace', message, data));
+    }
+    debug(message, data) {
+        if (this.shouldLog('debug'))
+            console.debug(this.format('debug', message, data));
+    }
+    info(message, data) {
+        if (this.shouldLog('info'))
+            console.log(this.format('info', message, data));
+    }
+    warn(message, data) {
+        if (this.shouldLog('warn'))
+            console.warn(this.format('warn', message, data));
+    }
+    error(message, error, data) {
+        if (this.shouldLog('error')) {
+            console.error(this.format('error', message, data));
+            if (error === null || error === void 0 ? void 0 : error.stack)
+                console.error(error.stack);
+        }
+    }
+    fatal(message, error, data) {
+        if (this.shouldLog('fatal')) {
+            console.error(this.format('fatal', message, data));
+            if (error === null || error === void 0 ? void 0 : error.stack)
+                console.error(error.stack);
+        }
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+ConsoleLogger.LEVELS = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+};
+/**
+ * No-op Logger implementation
+ *
+ * Useful for suppressing all log output (e.g., in benchmarks or silent tests).
+ */
+class NullLogger {
+    trace() { }
+    debug() { }
+    info() { }
+    warn() { }
+    error() { }
+    fatal() { }
+}
+exports.NullLogger = NullLogger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/object.d.ts

@@ -5,9 +5,25 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import { Data, Automation } from '@objectstack/spec';
+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.
+ */
+export type StateMachineConfig = z.infer<typeof Automation.StateMachineSchema>;
+export type StateNodeConfig = z.infer<typeof Automation.StateNodeSchema>;
+export type Transition = z.infer<typeof Automation.TransitionSchema>;
+export type ActionRef = z.infer<typeof Automation.ActionRefSchema>;
+export type ObjectOwnership = z.infer<typeof Data.ObjectOwnershipEnum>;
+export type ObjectExtension = z.infer<typeof Data.ObjectExtensionSchema>;
+export type ServiceObject = z.infer<typeof Data.ObjectSchema>;
+/** Re-export Zod schemas for validation */
+export { Data, Automation };
 /**
  * RUNTIME-SPECIFIC TYPES
  * The following types extend or complement the Protocol Constitution
@@ -104,6 +120,18 @@ export interface ObjectConfig {
     /**
      * RUNTIME EXTENSIONS BELOW
      */
+    /**
+     * State Machine definition for object lifecycle management.
+     * Follows the @objectstack/spec StateMachineConfig protocol.
+     * Enables declarative state transitions, guards, and entry/exit actions.
+     */
+    stateMachine?: StateMachineConfig;
+    /**
+     * Named state machines for multi-field lifecycle.
+     * Each key is a state machine identifier, useful when an object
+     * has multiple independent state fields.
+     */
+    stateMachines?: Record<string, StateMachineConfig>;
     /** AI capabilities configuration (RUNTIME ONLY) */
     ai?: ObjectAiConfig;
     /** Custom actions (RUNTIME ONLY) */
@@ -118,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.
@@ -128,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

@@ -7,4 +7,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Automation = exports.Data = void 0;
+const spec_1 = require("@objectstack/spec");
+Object.defineProperty(exports, "Data", { enumerable: true, get: function () { return spec_1.Data; } });
+Object.defineProperty(exports, "Automation", { enumerable: true, get: function () { return spec_1.Automation; } });
 //# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}
+{"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
@@ -78,6 +78,11 @@ export interface RuntimePlugin {
      * Example: '1.0.0', '2.1.3-beta'
      */
     version?: string;
+    /**
+     * Initialize the plugin
+     * Called when the plugin is loaded into the kernel
+     */
+    init?(ctx: RuntimeContext): Promise<void>;
     /**
      * Install hook - called during kernel initialization
      *

package/dist/query.d.ts

@@ -6,22 +6,27 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { Data } from '@objectstack/spec';
-type FilterCondition = Data.FilterCondition;
+import { z } from 'zod';
+export type Filter = z.infer<typeof Data.FilterCondition>;
+export type SortNode = z.infer<typeof Data.SortNodeSchema>;
+export type AggregationFunctionType = z.infer<typeof Data.AggregationFunction>;
+export type AggregationNode = z.infer<typeof Data.AggregationNodeSchema>;
 /**
- * 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 } }
+ * Unified Query Interface - Standard Protocol Format
  *
- * Note: $not operator is not supported. Use $ne for field-level negation.
+ * Uses @objectstack/spec QuerySchema inference directly.
+ * We make 'object' optional because in many contexts (like Repository.find),
+ * the object is implicit.
+ */
+type SpecQuery = z.infer<typeof Data.QuerySchema>;
+export interface UnifiedQuery extends Omit<SpecQuery, 'object'> {
+    object?: string;
+}
+/**
+ * Standard QueryAST definition.
+ * Aliased to UnifiedQuery for backward compatibility and consistency.
  */
-export type Filter = FilterCondition;
+export type QueryAST = UnifiedQuery;
 /** @deprecated Use AggregationFunctionType instead */
 export type AggregateFunction = AggregationFunctionType;
 /** @deprecated Use AggregationNode instead */
@@ -30,62 +35,4 @@ export interface AggregateOption {
     field: string;
     alias?: string;
 }
-/**
- * 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
- *
- * 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 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 (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

@@ -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":"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"}

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