@korajs/core 1.0.0-beta.11 → 1.0.0-beta.13

package/dist/operation-DbynlVcp.d.cts

@@ -1,164 +0,0 @@
-import { P as TimeSource, H as HLCTimestamp, x as OperationInput, f as Operation } from './events-BPbYUbrE.cjs';
-
-/**
- * Highest logical counter value that fits the 5-digit zero-padded slot in the
- * serialized timestamp form. The serialized string must sort lexicographically
- * in exactly the same order as {@link HybridLogicalClock.compare}; a 6-digit
- * logical value would shift the padding and silently break that invariant for
- * every stored `_version` column and operation timestamp. When the counter
- * would exceed this cap, the clock carries into wallTime instead
- * (wallTime + 1, logical = 0), which preserves both monotonicity and the
- * serialized ordering.
- */
-declare const MAX_LOGICAL = 99999;
-/**
- * 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 readonly onDriftError?;
-    private wallTime;
-    private logical;
-    private referenceOffsetMs;
-    constructor(nodeId: string, timeSource?: TimeSource, onDriftWarning?: ((driftMs: number) => void) | undefined, onDriftError?: ((driftMs: number) => void) | undefined);
-    /**
-     * Records the known offset between an external time reference (usually the
-     * sync server, learned at handshake) and this device's physical clock:
-     * `referenceTime - localPhysicalTime`. Once set, drift evaluation and remote
-     * timestamp validation are performed against reference-corrected time, so a
-     * device with a wrong local clock still validates remote timestamps correctly.
-     */
-    setReferenceOffset(offsetMs: number): void;
-    getReferenceOffset(): number | null;
-    /** Physical time corrected by the known reference offset, when available. */
-    private effectiveTime;
-    /**
-     * Generate a new timestamp for a local event.
-     * Guarantees monotonicity: each call returns a timestamp strictly greater than the previous.
-     *
-     * Never throws and never blocks a local write: if the physical clock has
-     * fallen behind the HLC (e.g. the user corrected a fast clock), the HLC
-     * freezes wallTime and advances the logical counter, and drift is reported
-     * through the onDriftWarning / onDriftError callbacks instead.
-     */
-    now(): HLCTimestamp;
-    /**
-     * Update clock on receiving a remote timestamp.
-     * Merges the remote clock state with the local state to maintain causal ordering.
-     *
-     * @throws {InvalidTimestampError} If the remote timestamp has non-integer or
-     * negative wallTime/logical, or logical beyond {@link MAX_LOGICAL}. Checked
-     * BEFORE any state change, so malformed input cannot corrupt this clock.
-     * @throws {RemoteClockDriftError} If the remote timestamp is more than 5 minutes
-     * ahead of reference-corrected local time. Validation happens BEFORE any state
-     * is adopted, so a rejected timestamp cannot poison this clock. When no
-     * reference offset is known and this clock is uninitialized (cold start with
-     * a possibly-wrong local clock), validation is skipped, matching the previous
-     * cold-start behavior but now without a corrupting failure mode afterward.
-     */
-    receive(remote: HLCTimestamp): HLCTimestamp;
-    /**
-     * Advance this clock to at least the given timestamp.
-     *
-     * Used after a timestamp rebase rewrites unsynced operations: future `now()`
-     * timestamps must sort after every rebased operation, otherwise a write issued
-     * immediately after the rebase could interleave with (or precede) rebased ops
-     * and break the log's total order. Never moves the clock backward — a
-     * timestamp at or before the current state is a no-op, preserving the
-     * monotonicity guarantee of `now()`.
-     *
-     * Inputs with logical > MAX_LOGICAL are normalized deterministically by
-     * carrying the excess into wallTime, so the adopted state always leaves room
-     * for the next increment inside the serializable range.
-     */
-    advanceTo(ts: HLCTimestamp): void;
-    /**
-     * Carry the logical counter into wallTime when an increment pushed it past
-     * MAX_LOGICAL. Bumping wallTime by 1ms keeps the timestamp strictly greater
-     * than everything issued before (monotonicity) while keeping the logical
-     * counter inside the 5-digit slot the serialized form depends on.
-     */
-    private carryLogicalOverflow;
-    /**
-     * 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
-     *
-     * @throws {InvalidTimestampError} If wallTime does not fit 15 digits or
-     * logical does not fit 5 digits (or either is negative/non-integer). Such a
-     * value would overflow its zero-padded slot and the serialized string would
-     * no longer sort in the same order as {@link HybridLogicalClock.compare} —
-     * silently corrupting every LWW comparison on stored `_version` columns.
-     * Internal clocks can no longer produce such values (the logical counter
-     * carries into wallTime); this guards against hand-built timestamps.
-     */
-    static serialize(ts: HLCTimestamp): string;
-    /**
-     * Deserialize an HLC timestamp from its serialized string form.
-     */
-    static deserialize(s: string): HLCTimestamp;
-    /**
-     * Reports drift between the HLC and (reference-corrected) physical time.
-     * Reporting only: local timestamp generation is never blocked, because the
-     * user's data always outranks the quality of its timestamps.
-     */
-    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;
-
-export { HybridLogicalClock as H, MAX_LOGICAL as M, validateOperationParams as a, createOperation as c, isValidOperation as i, verifyOperationIntegrity as v };

package/dist/operation-Dt0AtT8u.d.ts

@@ -1,164 +0,0 @@
-import { P as TimeSource, H as HLCTimestamp, x as OperationInput, f as Operation } from './events-BPbYUbrE.js';
-
-/**
- * Highest logical counter value that fits the 5-digit zero-padded slot in the
- * serialized timestamp form. The serialized string must sort lexicographically
- * in exactly the same order as {@link HybridLogicalClock.compare}; a 6-digit
- * logical value would shift the padding and silently break that invariant for
- * every stored `_version` column and operation timestamp. When the counter
- * would exceed this cap, the clock carries into wallTime instead
- * (wallTime + 1, logical = 0), which preserves both monotonicity and the
- * serialized ordering.
- */
-declare const MAX_LOGICAL = 99999;
-/**
- * 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 readonly onDriftError?;
-    private wallTime;
-    private logical;
-    private referenceOffsetMs;
-    constructor(nodeId: string, timeSource?: TimeSource, onDriftWarning?: ((driftMs: number) => void) | undefined, onDriftError?: ((driftMs: number) => void) | undefined);
-    /**
-     * Records the known offset between an external time reference (usually the
-     * sync server, learned at handshake) and this device's physical clock:
-     * `referenceTime - localPhysicalTime`. Once set, drift evaluation and remote
-     * timestamp validation are performed against reference-corrected time, so a
-     * device with a wrong local clock still validates remote timestamps correctly.
-     */
-    setReferenceOffset(offsetMs: number): void;
-    getReferenceOffset(): number | null;
-    /** Physical time corrected by the known reference offset, when available. */
-    private effectiveTime;
-    /**
-     * Generate a new timestamp for a local event.
-     * Guarantees monotonicity: each call returns a timestamp strictly greater than the previous.
-     *
-     * Never throws and never blocks a local write: if the physical clock has
-     * fallen behind the HLC (e.g. the user corrected a fast clock), the HLC
-     * freezes wallTime and advances the logical counter, and drift is reported
-     * through the onDriftWarning / onDriftError callbacks instead.
-     */
-    now(): HLCTimestamp;
-    /**
-     * Update clock on receiving a remote timestamp.
-     * Merges the remote clock state with the local state to maintain causal ordering.
-     *
-     * @throws {InvalidTimestampError} If the remote timestamp has non-integer or
-     * negative wallTime/logical, or logical beyond {@link MAX_LOGICAL}. Checked
-     * BEFORE any state change, so malformed input cannot corrupt this clock.
-     * @throws {RemoteClockDriftError} If the remote timestamp is more than 5 minutes
-     * ahead of reference-corrected local time. Validation happens BEFORE any state
-     * is adopted, so a rejected timestamp cannot poison this clock. When no
-     * reference offset is known and this clock is uninitialized (cold start with
-     * a possibly-wrong local clock), validation is skipped, matching the previous
-     * cold-start behavior but now without a corrupting failure mode afterward.
-     */
-    receive(remote: HLCTimestamp): HLCTimestamp;
-    /**
-     * Advance this clock to at least the given timestamp.
-     *
-     * Used after a timestamp rebase rewrites unsynced operations: future `now()`
-     * timestamps must sort after every rebased operation, otherwise a write issued
-     * immediately after the rebase could interleave with (or precede) rebased ops
-     * and break the log's total order. Never moves the clock backward — a
-     * timestamp at or before the current state is a no-op, preserving the
-     * monotonicity guarantee of `now()`.
-     *
-     * Inputs with logical > MAX_LOGICAL are normalized deterministically by
-     * carrying the excess into wallTime, so the adopted state always leaves room
-     * for the next increment inside the serializable range.
-     */
-    advanceTo(ts: HLCTimestamp): void;
-    /**
-     * Carry the logical counter into wallTime when an increment pushed it past
-     * MAX_LOGICAL. Bumping wallTime by 1ms keeps the timestamp strictly greater
-     * than everything issued before (monotonicity) while keeping the logical
-     * counter inside the 5-digit slot the serialized form depends on.
-     */
-    private carryLogicalOverflow;
-    /**
-     * 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
-     *
-     * @throws {InvalidTimestampError} If wallTime does not fit 15 digits or
-     * logical does not fit 5 digits (or either is negative/non-integer). Such a
-     * value would overflow its zero-padded slot and the serialized string would
-     * no longer sort in the same order as {@link HybridLogicalClock.compare} —
-     * silently corrupting every LWW comparison on stored `_version` columns.
-     * Internal clocks can no longer produce such values (the logical counter
-     * carries into wallTime); this guards against hand-built timestamps.
-     */
-    static serialize(ts: HLCTimestamp): string;
-    /**
-     * Deserialize an HLC timestamp from its serialized string form.
-     */
-    static deserialize(s: string): HLCTimestamp;
-    /**
-     * Reports drift between the HLC and (reference-corrected) physical time.
-     * Reporting only: local timestamp generation is never blocked, because the
-     * user's data always outranks the quality of its timestamps.
-     */
-    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;
-
-export { HybridLogicalClock as H, MAX_LOGICAL as M, validateOperationParams as a, createOperation as c, isValidOperation as i, verifyOperationIntegrity as v };