@korajs/core 0.1.0

package/dist/internal.d.ts

@@ -0,0 +1,58 @@
+import { p as OperationInput, j as KoraEventEmitter, l as KoraEventType, k as KoraEventListener, i as KoraEventByType, d as Operation } from './events-D_kDPDC9.js';
+export { t as validateOperationParams } from './events-D_kDPDC9.js';
+
+/**
+ * Compute the content-addressed ID for an operation using SHA-256.
+ * The same operation content always produces the same hash, ensuring deduplication.
+ *
+ * @param input - The operation input (without id/timestamp, which are assigned separately)
+ * @param timestamp - The HLC timestamp serialized as a string
+ * @returns A hex-encoded SHA-256 hash
+ */
+declare function computeOperationId(input: OperationInput, timestamp: string): Promise<string>;
+/**
+ * Deterministic JSON serialization with sorted keys.
+ * Ensures identical objects always produce identical strings regardless of property insertion order.
+ *
+ * @param obj - The value to serialize
+ * @returns A deterministic JSON string
+ */
+declare function canonicalize(obj: unknown): string;
+
+/**
+ * Concrete implementation of KoraEventEmitter.
+ * Simple, synchronous event emitter for internal use across @kora packages.
+ *
+ * @example
+ * ```typescript
+ * const emitter = new SimpleEventEmitter()
+ * const unsub = emitter.on('operation:created', (event) => {
+ *   console.log(event.operation.id)
+ * })
+ * emitter.emit({ type: 'operation:created', operation: someOp })
+ * unsub() // unsubscribe
+ * ```
+ */
+declare class SimpleEventEmitter implements KoraEventEmitter {
+    private listeners;
+    on<T extends KoraEventType>(type: T, listener: KoraEventListener<T>): () => void;
+    off<T extends KoraEventType>(type: T, listener: KoraEventListener<T>): void;
+    emit<T extends KoraEventType>(event: KoraEventByType<T>): void;
+    /** Remove all listeners for all event types. */
+    clear(): void;
+    /** Get the number of listeners for a specific event type. */
+    listenerCount(type: KoraEventType): number;
+}
+
+/**
+ * Topological sort of operations based on their causal dependency DAG.
+ * Uses Kahn's algorithm with deterministic tie-breaking via HLC timestamp.
+ * Time complexity: O(V + E) where V = operations, E = causal dependency edges.
+ *
+ * @param operations - The operations to sort
+ * @returns Operations in causal order (dependencies before dependents)
+ * @throws {OperationError} If a cycle is detected in the dependency graph
+ */
+declare function topologicalSort(operations: Operation[]): Operation[];
+
+export { SimpleEventEmitter, canonicalize, computeOperationId, topologicalSort };

package/dist/internal.js

@@ -0,0 +1,55 @@
+import {
+  canonicalize,
+  computeOperationId,
+  topologicalSort,
+  validateOperationParams
+} from "./chunk-ZMUY7AVV.js";
+
+// src/events/event-emitter.ts
+var SimpleEventEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(type, listener) {
+    let set = this.listeners.get(type);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(type, set);
+    }
+    set.add(listener);
+    return () => {
+      this.off(type, listener);
+    };
+  }
+  off(type, listener) {
+    const set = this.listeners.get(type);
+    if (set) {
+      set.delete(listener);
+      if (set.size === 0) {
+        this.listeners.delete(type);
+      }
+    }
+  }
+  emit(event) {
+    const set = this.listeners.get(event.type);
+    if (!set) return;
+    for (const listener of set) {
+      ;
+      listener(event);
+    }
+  }
+  /** Remove all listeners for all event types. */
+  clear() {
+    this.listeners.clear();
+  }
+  /** Get the number of listeners for a specific event type. */
+  listenerCount(type) {
+    return this.listeners.get(type)?.size ?? 0;
+  }
+};
+export {
+  SimpleEventEmitter,
+  canonicalize,
+  computeOperationId,
+  topologicalSort,
+  validateOperationParams
+};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/events/event-emitter.ts"],"sourcesContent":["import type { KoraEventByType, KoraEventEmitter, KoraEventListener, KoraEventType } from './events'\n\ntype AnyListener = (event: never) => void\n\n/**\n * Concrete implementation of KoraEventEmitter.\n * Simple, synchronous event emitter for internal use across @kora packages.\n *\n * @example\n * ```typescript\n * const emitter = new SimpleEventEmitter()\n * const unsub = emitter.on('operation:created', (event) => {\n *   console.log(event.operation.id)\n * })\n * emitter.emit({ type: 'operation:created', operation: someOp })\n * unsub() // unsubscribe\n * ```\n */\nexport class SimpleEventEmitter implements KoraEventEmitter {\n\tprivate listeners = new Map<string, Set<AnyListener>>()\n\n\ton<T extends KoraEventType>(type: T, listener: KoraEventListener<T>): () => void {\n\t\tlet set = this.listeners.get(type)\n\t\tif (!set) {\n\t\t\tset = new Set()\n\t\t\tthis.listeners.set(type, set)\n\t\t}\n\t\tset.add(listener as AnyListener)\n\n\t\treturn () => {\n\t\t\tthis.off(type, listener)\n\t\t}\n\t}\n\n\toff<T extends KoraEventType>(type: T, listener: KoraEventListener<T>): void {\n\t\tconst set = this.listeners.get(type)\n\t\tif (set) {\n\t\t\tset.delete(listener as AnyListener)\n\t\t\tif (set.size === 0) {\n\t\t\t\tthis.listeners.delete(type)\n\t\t\t}\n\t\t}\n\t}\n\n\temit<T extends KoraEventType>(event: KoraEventByType<T>): void {\n\t\tconst set = this.listeners.get(event.type)\n\t\tif (!set) return\n\t\tfor (const listener of set) {\n\t\t\t;(listener as (event: KoraEventByType<T>) => void)(event)\n\t\t}\n\t}\n\n\t/** Remove all listeners for all event types. */\n\tclear(): void {\n\t\tthis.listeners.clear()\n\t}\n\n\t/** Get the number of listeners for a specific event type. */\n\tlistenerCount(type: KoraEventType): number {\n\t\treturn this.listeners.get(type)?.size ?? 0\n\t}\n}\n"],"mappings":";;;;;;;;AAkBO,IAAM,qBAAN,MAAqD;AAAA,EACnD,YAAY,oBAAI,IAA8B;AAAA,EAEtD,GAA4B,MAAS,UAA4C;AAChF,QAAI,MAAM,KAAK,UAAU,IAAI,IAAI;AACjC,QAAI,CAAC,KAAK;AACT,YAAM,oBAAI,IAAI;AACd,WAAK,UAAU,IAAI,MAAM,GAAG;AAAA,IAC7B;AACA,QAAI,IAAI,QAAuB;AAE/B,WAAO,MAAM;AACZ,WAAK,IAAI,MAAM,QAAQ;AAAA,IACxB;AAAA,EACD;AAAA,EAEA,IAA6B,MAAS,UAAsC;AAC3E,UAAM,MAAM,KAAK,UAAU,IAAI,IAAI;AACnC,QAAI,KAAK;AACR,UAAI,OAAO,QAAuB;AAClC,UAAI,IAAI,SAAS,GAAG;AACnB,aAAK,UAAU,OAAO,IAAI;AAAA,MAC3B;AAAA,IACD;AAAA,EACD;AAAA,EAEA,KAA8B,OAAiC;AAC9D,UAAM,MAAM,KAAK,UAAU,IAAI,MAAM,IAAI;AACzC,QAAI,CAAC,IAAK;AACV,eAAW,YAAY,KAAK;AAC3B;AAAC,MAAC,SAAiD,KAAK;AAAA,IACzD;AAAA,EACD;AAAA;AAAA,EAGA,QAAc;AACb,SAAK,UAAU,MAAM;AAAA,EACtB;AAAA;AAAA,EAGA,cAAc,MAA6B;AAC1C,WAAO,KAAK,UAAU,IAAI,IAAI,GAAG,QAAQ;AAAA,EAC1C;AACD;","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@korajs/core",
+  "version": "0.1.0",
+  "description": "Kora.js core package",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./internal": {
+      "import": {
+        "types": "./dist/internal.d.ts",
+        "default": "./dist/internal.js"
+      },
+      "require": {
+        "types": "./dist/internal.d.cts",
+        "default": "./dist/internal.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "fast-check": "^4.6.0",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo coverage"
+  }
+}