@kar-mi/spirit-vale-tools-logging 0.10.0 → 0.10.1

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { JsonLinesLogger, activateLogSession, createLogSession, readCurrentLogStream, writeCurrentLogStreamPointer, } from "./logger.ts";
 export { encodeLogRecord, encodeLogStreamHeader, isLogStreamHeader, parseLogRecord, parseLogStreamHeader, } from "./record-codec.ts";
+export { decoderForText, LogRecordLineDecoder, readTextLines } from "./record-reader.ts";
+export type { DecodedLogLine } from "./record-reader.ts";
 export type { CreateLogSessionOptions, JsonLinesLoggerOptions, JsonLinesLoggerStats, LoggerTuning, LogWriteFailure, } from "./logger.ts";
 export { sanitizeCombatData } from "./combat-sanitizer.ts";
 export { defaultLogDirectory, currentStreamPointerPath, streamCategoryDirectory, streamSessionPath, } from "./paths.ts";
@@ -13,4 +15,5 @@ export type { LiveLogLineConsumer, LiveLogSessionFollowerOptions } from "./sessi
 export { DEFAULT_STREAM_BATCH_BYTES, DEFAULT_STREAM_DEBOUNCE_MS, DEFAULT_STREAM_FALLBACK_POLL_MS, subscribeToLogStream, } from "./stream-source.ts";
 export type { LogStreamRead, LogStreamSourceOptions, LogStreamSubscription } from "./stream-source.ts";
 export type { CurrentLogStream, JsonData, JsonObject, LogRecord, LogSession, ListedLogSession, LogStream, LogStreamHeader, } from "./types.ts";
+export { compact, count, warnings } from "./text-format.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvG,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzF,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvG,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -103,7 +103,7 @@ function isIsoDate(value) {
   return isNonEmptyString(value) && Number.isFinite(Date.parse(value));
 }
 function isLogStream(value) {
-  return value === "capture" || value === "combat" || value === "rewards" || value === "other";
+  return value === "capture" || value === "combat" || value === "market" || value === "rewards" || value === "other";
 }
 
 // src/combat-sanitizer.ts
@@ -422,6 +422,61 @@ function isIsoDate2(value) {
 function toError(error) {
   return error instanceof Error ? error : new Error(String(error));
 }
+// src/record-reader.ts
+class LogRecordLineDecoder {
+  header;
+  decode(line) {
+    if (!line.trim())
+      return { kind: "empty" };
+    let value;
+    try {
+      value = JSON.parse(line);
+    } catch {
+      return { kind: "invalid" };
+    }
+    if (isRecord(value) && value["schemaVersion"] === 2) {
+      const header = parseLogStreamHeader(value);
+      if (!header)
+        return { kind: "invalid" };
+      this.header = header;
+      return { kind: "header", header };
+    }
+    const record = parseLogRecord(value, this.header);
+    return record ? { kind: "record", record } : { kind: "invalid" };
+  }
+  reset() {
+    this.header = undefined;
+  }
+}
+async function* readTextLines(stream) {
+  const reader = stream.getReader();
+  let decoder;
+  let pending = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      decoder ??= decoderForText(value);
+      pending += decoder.decode(value, { stream: true });
+      const lines = pending.split(/\r?\n/);
+      pending = lines.pop() ?? "";
+      yield* lines;
+    }
+    pending += decoder?.decode() ?? "";
+    if (pending)
+      yield pending;
+  } finally {
+    reader.releaseLock();
+  }
+}
+function decoderForText(firstChunk) {
+  if (firstChunk[0] === 255 && firstChunk[1] === 254)
+    return new TextDecoder("utf-16le");
+  if (firstChunk[0] === 254 && firstChunk[1] === 255)
+    return new TextDecoder("utf-16be");
+  return new TextDecoder("utf-8");
+}
 // src/sessions.ts
 import { lstat, open as open2, readFile as readFile2, readdir } from "fs/promises";
 import path3 from "path";
@@ -954,6 +1009,16 @@ class LiveLogSessionFollower {
     return { ...merged, path: read.current.path, sessionId: read.current.sessionId };
   }
 }
+// src/text-format.ts
+function count(value, label) {
+  return `${value} ${label}${value === 1 ? "" : "s"}`;
+}
+function compact(value) {
+  return new Intl.NumberFormat(undefined, { notation: "compact", maximumFractionDigits: 1 }).format(value);
+}
+function warnings(value) {
+  return value === 0 ? "" : ` \xB7 ${value} skipped`;
+}
 export {
   DEFAULT_STREAM_BATCH_BYTES,
   DEFAULT_STREAM_DEBOUNCE_MS,
@@ -961,10 +1026,14 @@ export {
   JsonLinesLogger,
   JsonlTailReader,
   LiveLogSessionFollower,
+  LogRecordLineDecoder,
   activateLogSession,
+  compact,
+  count,
   createLogSession,
   currentStreamPointerPath,
   decimal,
+  decoderForText,
   defaultLogDirectory,
   encodeLogRecord,
   encodeLogStreamHeader,
@@ -976,9 +1045,11 @@ export {
   parseLogRecord,
   parseLogStreamHeader,
   readCurrentLogStream,
+  readTextLines,
   sanitizeCombatData,
   streamCategoryDirectory,
   streamSessionPath,
   subscribeToLogStream,
+  warnings,
   writeCurrentLogStreamPointer
 };

package/dist/record-reader.d.ts

@@ -0,0 +1,23 @@
+import type { LogRecord, LogStreamHeader } from "./types.ts";
+export type DecodedLogLine = {
+    kind: "empty";
+} | {
+    kind: "header";
+    header: LogStreamHeader;
+} | {
+    kind: "record";
+    record: LogRecord;
+} | {
+    kind: "invalid";
+};
+/** Stateful JSONL decoder that keeps v2 stream metadata while accepting legacy v1 records. */
+export declare class LogRecordLineDecoder {
+    private header?;
+    decode(line: string): DecodedLogLine;
+    reset(): void;
+}
+/** Splits a byte stream into lines, recognizing the Unicode BOMs supported by live combat logs. */
+export declare function readTextLines(stream: ReadableStream<Uint8Array>): AsyncGenerator<string>;
+/** Decoder selection shared by incremental readers that need the same BOM behavior. */
+export declare function decoderForText(firstChunk: Uint8Array): TextDecoder;
+//# sourceMappingURL=record-reader.d.ts.map

package/dist/record-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-reader.d.ts","sourceRoot":"","sources":["../src/record-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,8FAA8F;AAC9F,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAkB;IAEjC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAoBnC;IAED,KAAK,IAAI,IAAI,CAEZ;CACF;AAED,mGAAmG;AACnG,wBAAuB,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAmB/F;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAIlE"}

package/dist/text-format.d.ts

@@ -0,0 +1,4 @@
+export declare function count(value: number, label: string): string;
+export declare function compact(value: number | bigint): string;
+export declare function warnings(value: number): string;
+//# sourceMappingURL=text-format.d.ts.map

package/dist/text-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-format.d.ts","sourceRoot":"","sources":["../src/text-format.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kar-mi/spirit-vale-tools-logging",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Session-oriented logging utilities for Spirit Vale tools.",
   "license": "AGPL-3.0-only",
   "repository": {