@korajs/core 0.5.0 → 0.6.0

package/dist/{events-BeIEDJBW.d.cts → events-D-FWfFg8.d.cts}

@@ -639,97 +639,6 @@ interface SequenceConfig {
     startAt?: number;
 }
 
-/**
- * Hybrid Logical Clock implementation based on Kulkarni et al.
- *
- * Provides a total order that respects causality without requiring synchronized clocks.
- * Each call to now() returns a timestamp strictly greater than the previous one.
- *
- * @example
- * ```typescript
- * const clock = new HybridLogicalClock('node-1')
- * const ts1 = clock.now()
- * const ts2 = clock.now()
- * // HybridLogicalClock.compare(ts1, ts2) < 0 (ts1 is earlier)
- * ```
- */
-declare class HybridLogicalClock {
-    private readonly nodeId;
-    private readonly timeSource;
-    private readonly onDriftWarning?;
-    private wallTime;
-    private logical;
-    constructor(nodeId: string, timeSource?: TimeSource, onDriftWarning?: ((driftMs: number) => void) | undefined);
-    /**
-     * Generate a new timestamp for a local event.
-     * Guarantees monotonicity: each call returns a timestamp strictly greater than the previous.
-     *
-     * @throws {ClockDriftError} If physical time is more than 5 minutes behind the HLC wallTime
-     */
-    now(): HLCTimestamp;
-    /**
-     * Update clock on receiving a remote timestamp.
-     * Merges the remote clock state with the local state to maintain causal ordering.
-     *
-     * @throws {ClockDriftError} If physical time is more than 5 minutes behind the resulting wallTime
-     */
-    receive(remote: HLCTimestamp): HLCTimestamp;
-    /**
-     * Compare two timestamps. Returns negative if a < b, positive if a > b, zero if equal.
-     * Total order: wallTime first, then logical, then nodeId (lexicographic).
-     */
-    static compare(a: HLCTimestamp, b: HLCTimestamp): number;
-    /**
-     * Serialize an HLC timestamp to a string that sorts lexicographically.
-     * Format: zero-padded wallTime:logical:nodeId
-     */
-    static serialize(ts: HLCTimestamp): string;
-    /**
-     * Deserialize an HLC timestamp from its serialized string form.
-     */
-    static deserialize(s: string): HLCTimestamp;
-    private checkDrift;
-}
-
-/**
- * Creates an immutable, content-addressed Operation from the given parameters.
- * The operation is deep-frozen after creation — it cannot be modified.
- *
- * @param input - The operation parameters (without id, which is computed)
- * @param clock - The HLC clock to generate the timestamp
- * @returns A frozen Operation with a content-addressed id
- *
- * @example
- * ```typescript
- * const op = await createOperation({
- *   nodeId: 'device-1',
- *   type: 'insert',
- *   collection: 'todos',
- *   recordId: 'rec-1',
- *   data: { title: 'Ship it' },
- *   previousData: null,
- *   sequenceNumber: 1,
- *   causalDeps: [],
- *   schemaVersion: 1,
- * }, clock)
- * ```
- */
-declare function createOperation(input: OperationInput, clock: HybridLogicalClock): Promise<Operation>;
-/**
- * Validates operation input parameters. Throws OperationError with
- * contextual information on validation failure.
- */
-declare function validateOperationParams(input: OperationInput): void;
-/**
- * Verify the integrity of an operation by recomputing its content hash.
- * Returns true if the id matches the recomputed hash.
- */
-declare function verifyOperationIntegrity(op: Operation): Promise<boolean>;
-/**
- * Type guard for Operation interface.
- */
-declare function isValidOperation(value: unknown): value is Operation;
-
 /**
  * Trace of a merge decision. Records all inputs and outputs for debugging and DevTools.
  */
@@ -884,4 +793,4 @@ interface KoraEventEmitter {
     emit<T extends KoraEventType>(event: KoraEventByType<T>): void;
 }
 
-export { type AtomicOpType as A, RollbackBuilder as B, type CustomResolver as C, type SequenceConfig as D, EnumFieldBuilder as E, FieldBuilder as F, type StateMachineDefinition as G, type HLCTimestamp as H, type SyncDiagnosticsSnapshot as I, type SyncRuleDefinition as J, type KoraEvent as K, type TimeSource as L, type MigrationDefinition as M, createOperation as N, type OperationType as O, isValidOperation as P, migrate as Q, type RandomSource as R, type SchemaDefinition as S, type TransitionMap as T, t as U, type VersionVector as V, verifyOperationIntegrity as W, validateOperationParams as X, type AtomicOp as a, type CollectionDefinition as b, type RelationDefinition as c, ArrayFieldBuilder as d, type FieldKind as e, type Operation as f, type MigrationStep as g, type StateMachineConstraint as h, type TransitionValidationResult as i, CONNECTION_QUALITIES as j, type ConnectionQuality as k, type Constraint as l, type FieldDescriptor as m, type FieldMergeStrategy as n, HybridLogicalClock as o, type KoraEventByType as p, type KoraEventEmitter as q, type KoraEventListener as r, type KoraEventType as s, MERGE_STRATEGIES as t, type MergeStrategy as u, type MergeTrace as v, MigrationBuilder as w, type OnDeleteAction as x, type OperationInput as y, type RelationType as z };
+export { type AtomicOpType as A, type SequenceConfig as B, type CustomResolver as C, type StateMachineDefinition as D, EnumFieldBuilder as E, FieldBuilder as F, type SyncDiagnosticsSnapshot as G, type HLCTimestamp as H, type SyncRuleDefinition as I, type TimeSource as J, type KoraEvent as K, migrate as L, type MigrationDefinition as M, t as N, type OperationType as O, type RandomSource as R, type SchemaDefinition as S, type TransitionMap as T, type VersionVector as V, type AtomicOp as a, type CollectionDefinition as b, type RelationDefinition as c, ArrayFieldBuilder as d, type FieldKind as e, type Operation as f, type MigrationStep as g, type StateMachineConstraint as h, type TransitionValidationResult as i, CONNECTION_QUALITIES as j, type ConnectionQuality as k, type Constraint as l, type FieldDescriptor as m, type FieldMergeStrategy as n, type KoraEventByType as o, type KoraEventEmitter as p, type KoraEventListener as q, type KoraEventType as r, MERGE_STRATEGIES as s, type MergeStrategy as t, type MergeTrace as u, MigrationBuilder as v, type OnDeleteAction as w, type OperationInput as x, type RelationType as y, RollbackBuilder as z };

package/dist/{events-BeIEDJBW.d.ts → events-D-FWfFg8.d.ts}

@@ -639,97 +639,6 @@ interface SequenceConfig {
     startAt?: number;
 }
 
-/**
- * Hybrid Logical Clock implementation based on Kulkarni et al.
- *
- * Provides a total order that respects causality without requiring synchronized clocks.
- * Each call to now() returns a timestamp strictly greater than the previous one.
- *
- * @example
- * ```typescript
- * const clock = new HybridLogicalClock('node-1')
- * const ts1 = clock.now()
- * const ts2 = clock.now()
- * // HybridLogicalClock.compare(ts1, ts2) < 0 (ts1 is earlier)
- * ```
- */
-declare class HybridLogicalClock {
-    private readonly nodeId;
-    private readonly timeSource;
-    private readonly onDriftWarning?;
-    private wallTime;
-    private logical;
-    constructor(nodeId: string, timeSource?: TimeSource, onDriftWarning?: ((driftMs: number) => void) | undefined);
-    /**
-     * Generate a new timestamp for a local event.
-     * Guarantees monotonicity: each call returns a timestamp strictly greater than the previous.
-     *
-     * @throws {ClockDriftError} If physical time is more than 5 minutes behind the HLC wallTime
-     */
-    now(): HLCTimestamp;
-    /**
-     * Update clock on receiving a remote timestamp.
-     * Merges the remote clock state with the local state to maintain causal ordering.
-     *
-     * @throws {ClockDriftError} If physical time is more than 5 minutes behind the resulting wallTime
-     */
-    receive(remote: HLCTimestamp): HLCTimestamp;
-    /**
-     * Compare two timestamps. Returns negative if a < b, positive if a > b, zero if equal.
-     * Total order: wallTime first, then logical, then nodeId (lexicographic).
-     */
-    static compare(a: HLCTimestamp, b: HLCTimestamp): number;
-    /**
-     * Serialize an HLC timestamp to a string that sorts lexicographically.
-     * Format: zero-padded wallTime:logical:nodeId
-     */
-    static serialize(ts: HLCTimestamp): string;
-    /**
-     * Deserialize an HLC timestamp from its serialized string form.
-     */
-    static deserialize(s: string): HLCTimestamp;
-    private checkDrift;
-}
-
-/**
- * Creates an immutable, content-addressed Operation from the given parameters.
- * The operation is deep-frozen after creation — it cannot be modified.
- *
- * @param input - The operation parameters (without id, which is computed)
- * @param clock - The HLC clock to generate the timestamp
- * @returns A frozen Operation with a content-addressed id
- *
- * @example
- * ```typescript
- * const op = await createOperation({
- *   nodeId: 'device-1',
- *   type: 'insert',
- *   collection: 'todos',
- *   recordId: 'rec-1',
- *   data: { title: 'Ship it' },
- *   previousData: null,
- *   sequenceNumber: 1,
- *   causalDeps: [],
- *   schemaVersion: 1,
- * }, clock)
- * ```
- */
-declare function createOperation(input: OperationInput, clock: HybridLogicalClock): Promise<Operation>;
-/**
- * Validates operation input parameters. Throws OperationError with
- * contextual information on validation failure.
- */
-declare function validateOperationParams(input: OperationInput): void;
-/**
- * Verify the integrity of an operation by recomputing its content hash.
- * Returns true if the id matches the recomputed hash.
- */
-declare function verifyOperationIntegrity(op: Operation): Promise<boolean>;
-/**
- * Type guard for Operation interface.
- */
-declare function isValidOperation(value: unknown): value is Operation;
-
 /**
  * Trace of a merge decision. Records all inputs and outputs for debugging and DevTools.
  */
@@ -884,4 +793,4 @@ interface KoraEventEmitter {
     emit<T extends KoraEventType>(event: KoraEventByType<T>): void;
 }
 
-export { type AtomicOpType as A, RollbackBuilder as B, type CustomResolver as C, type SequenceConfig as D, EnumFieldBuilder as E, FieldBuilder as F, type StateMachineDefinition as G, type HLCTimestamp as H, type SyncDiagnosticsSnapshot as I, type SyncRuleDefinition as J, type KoraEvent as K, type TimeSource as L, type MigrationDefinition as M, createOperation as N, type OperationType as O, isValidOperation as P, migrate as Q, type RandomSource as R, type SchemaDefinition as S, type TransitionMap as T, t as U, type VersionVector as V, verifyOperationIntegrity as W, validateOperationParams as X, type AtomicOp as a, type CollectionDefinition as b, type RelationDefinition as c, ArrayFieldBuilder as d, type FieldKind as e, type Operation as f, type MigrationStep as g, type StateMachineConstraint as h, type TransitionValidationResult as i, CONNECTION_QUALITIES as j, type ConnectionQuality as k, type Constraint as l, type FieldDescriptor as m, type FieldMergeStrategy as n, HybridLogicalClock as o, type KoraEventByType as p, type KoraEventEmitter as q, type KoraEventListener as r, type KoraEventType as s, MERGE_STRATEGIES as t, type MergeStrategy as u, type MergeTrace as v, MigrationBuilder as w, type OnDeleteAction as x, type OperationInput as y, type RelationType as z };
+export { type AtomicOpType as A, type SequenceConfig as B, type CustomResolver as C, type StateMachineDefinition as D, EnumFieldBuilder as E, FieldBuilder as F, type SyncDiagnosticsSnapshot as G, type HLCTimestamp as H, type SyncRuleDefinition as I, type TimeSource as J, type KoraEvent as K, migrate as L, type MigrationDefinition as M, t as N, type OperationType as O, type RandomSource as R, type SchemaDefinition as S, type TransitionMap as T, type VersionVector as V, type AtomicOp as a, type CollectionDefinition as b, type RelationDefinition as c, ArrayFieldBuilder as d, type FieldKind as e, type Operation as f, type MigrationStep as g, type StateMachineConstraint as h, type TransitionValidationResult as i, CONNECTION_QUALITIES as j, type ConnectionQuality as k, type Constraint as l, type FieldDescriptor as m, type FieldMergeStrategy as n, type KoraEventByType as o, type KoraEventEmitter as p, type KoraEventListener as q, type KoraEventType as r, MERGE_STRATEGIES as s, type MergeStrategy as t, type MergeTrace as u, MigrationBuilder as v, type OnDeleteAction as w, type OperationInput as x, type RelationType as y, RollbackBuilder as z };

package/dist/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   APPLY_FAILURE_CODES: () => APPLY_FAILURE_CODES,
   APPLY_RESULTS: () => APPLY_RESULTS,
+  AppNotReadyError: () => AppNotReadyError,
   ArrayFieldBuilder: () => ArrayFieldBuilder,
   CONNECTION_QUALITIES: () => CONNECTION_QUALITIES,
   CausalTracker: () => CausalTracker,
@@ -177,6 +178,14 @@ var StorageError = class extends KoraError {
     this.name = "StorageError";
   }
 };
+var AppNotReadyError = class extends KoraError {
+  constructor(detail) {
+    super(detail, "APP_NOT_READY", {
+      fix: "Await app.ready, or wrap your UI in <KoraProvider app={app}> before calling useQuery()."
+    });
+    this.name = "AppNotReadyError";
+  }
+};
 var ClockDriftError = class extends KoraError {
   constructor(currentHlcTime, physicalTime) {
     const driftSeconds = Math.round((currentHlcTime - physicalTime) / 1e3);
@@ -2462,6 +2471,7 @@ function generateProtoDefinitions(schema) {
 0 && (module.exports = {
   APPLY_FAILURE_CODES,
   APPLY_RESULTS,
+  AppNotReadyError,
   ArrayFieldBuilder,
   CONNECTION_QUALITIES,
   CausalTracker,