scrabble-solver 2.18.3 → 2.18.5

package/lerna.json

@@ -6,6 +6,6 @@
     "access": "public"
   },
   "tagVersionPrefix": "",
-  "version": "2.18.3",
+  "version": "2.18.5",
   "$schema": "node_modules/lerna/schemas/lerna-schema.json"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrabble-solver",
-  "version": "2.18.3",
+  "version": "2.18.5",
   "description": "Scrabble Solver 2 - Free, open-source, cross-platform, multi-language analysis tool for Scrabble, Scrabble Duel, Super Scrabble, Letter League, Crossplay, Literaki, Kelimelik, and Wyrazy. Quickly find the top-scoring words using the given board and tiles.",
   "keywords": [
     "scrabble",
@@ -80,23 +80,23 @@
     "packages/scrabble-solver"
   ],
   "dependencies": {
-    "@scrabble-solver/scrabble-solver": "^2.18.3",
+    "@scrabble-solver/scrabble-solver": "^2.18.5",
     "open-cli": "^9.0.0",
-    "wait-on": "^9.1.0"
+    "wait-on": "^9.5.1"
   },
   "devDependencies": {
-    "@playwright/test": "^1.62.1",
-    "@types/bun": "^1.4.0",
-    "@types/node": "^26.2.0",
+    "@playwright/test": "^1.63.0",
+    "@types/bun": "^1.4.2",
+    "@types/node": "^26.6.4",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-playwright": "^2.11.0",
+    "eslint-plugin-playwright": "^2.12.1",
     "eslint-plugin-react": "^7.37.5",
     "lerna": "^10.0.1",
-    "np": "^12.0.1",
-    "oxfmt": "^0.64.0",
-    "oxlint": "^1.79.0",
-    "oxlint-tsgolint": "^7.0.2001",
+    "np": "^12.1.1",
+    "oxfmt": "^0.72.0",
+    "oxlint": "^1.87.0",
+    "oxlint-tsgolint": "^7.0.2003",
     "rimraf": "^6.1.3",
     "start-server-and-test": "^3.0.12",
     "typescript": "^7.0.2"

package/packages/configs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scrabble-solver/configs",
-  "version": "2.18.3",
+  "version": "2.18.5",
   "description": "Game and language configs for Scrabble Solver: board layouts, bonus squares, tile distributions, and points for 8 games and 9 locales.",
   "keywords": [
     "scrabble",
@@ -33,8 +33,8 @@
     "clean": "rimraf build/"
   },
   "dependencies": {
-    "@scrabble-solver/constants": "^2.18.3",
-    "@scrabble-solver/types": "^2.18.3"
+    "@scrabble-solver/constants": "^2.18.5",
+    "@scrabble-solver/types": "^2.18.5"
   },
   "gitHead": "1e2d1ad49a288d4a44196d8e3336740da132c637"
 }

package/packages/constants/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scrabble-solver/constants",
-  "version": "2.18.3",
+  "version": "2.18.5",
   "description": "Shared constants for Scrabble Solver (blank tile, bonus markers).",
   "keywords": [
     "scrabble",

package/packages/dictionaries/bin/update-dictionaries.js

@@ -7,11 +7,8 @@ const rootDirectory = path.resolve(__dirname, '..');
 const { dictionaries } = require(rootDirectory);
 
 const updateDictionaries = async () => {
-  try {
-    await dictionaries.update();
-  } catch (error) {
-    console.error(error);
-  }
+  const failedLocales = await dictionaries.update();
+  process.exitCode = failedLocales.length > 0 ? 1 : 0;
 };
 
 updateDictionaries();

package/packages/dictionaries/build/Dictionaries.d.ts

@@ -6,7 +6,7 @@ export declare class Dictionaries {
     constructor();
     get(locale: Locale): Promise<Gaddag>;
     remove(): void;
-    update(force?: boolean): Promise<void>;
+    update(force?: boolean): Promise<Locale[]>;
     private getLocalesToUpdate;
     private updateDictionary;
 }

package/packages/dictionaries/build/Dictionaries.js

@@ -21,7 +21,6 @@ class Dictionaries {
                 return gaddag;
             }
         }
-        logger_1.logger.info('Dictionaries - cache miss', { locale });
         return this.updateDictionary(locale);
     }
     remove() {
@@ -30,14 +29,20 @@ class Dictionaries {
     }
     async update(force) {
         const locales = force ? Object.values(types_1.Locale) : this.getLocalesToUpdate();
-        logger_1.logger.info('Dictionaries - update', { force, locales });
-        await Promise.all(locales.map((locale) => this.updateDictionary(locale)));
+        const outcomes = await Promise.allSettled(locales.map((locale) => this.updateDictionary(locale)));
+        const failedLocales = [];
+        outcomes.forEach((outcome, index) => {
+            if (outcome.status === 'rejected') {
+                (0, logger_1.logError)('build', outcome.reason, { locale: locales[index] });
+                failedLocales.push(locales[index]);
+            }
+        });
+        return failedLocales;
     }
     getLocalesToUpdate() {
         return Object.values(types_1.Locale).filter((locale) => this.cache.isStale(locale) !== false);
     }
     async updateDictionary(locale) {
-        logger_1.logger.info('Dictionaries - updateDictionary', { locale });
         fs_1.default.mkdirSync(constants_1.OUTPUT_DIRECTORY, { recursive: true });
         const downloadDictionaryProxy = this.downloadDictionaryProxies[locale];
         const gaddag = await downloadDictionaryProxy();

package/packages/dictionaries/build/lib/DiskCache.js

@@ -28,7 +28,7 @@ class DiskCache {
             return gaddag_1.Gaddag.deserialize(new Uint8Array(serialized.buffer, serialized.byteOffset, serialized.byteLength));
         }
         catch (error) {
-            logger_1.logger.warn('DiskCache - incompatible or corrupted dictionary file, it will be rebuilt', { error, locale });
+            (0, logger_1.logError)('cache', error, { level: 'warn', locale });
             await fs_1.default.promises.rm(filepath, { force: true });
             return undefined;
         }

package/packages/dictionaries/build/lib/downloadDictionary.d.ts

@@ -1,3 +1,3 @@
 import { Gaddag } from '@kamilmielnik/gaddag';
 import { type Locale } from '@scrabble-solver/types';
-export declare const downloadDictionary: (locale: Locale) => Promise<Gaddag>;
+export declare function downloadDictionary(locale: Locale): Promise<Gaddag>;

package/packages/dictionaries/build/lib/downloadDictionary.js

@@ -1,15 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadDictionary = void 0;
+exports.downloadDictionary = downloadDictionary;
 const gaddag_1 = require("@kamilmielnik/gaddag");
 const logger_1 = require("@scrabble-solver/logger");
 const word_lists_1 = require("@scrabble-solver/word-lists");
-const downloadDictionary = async (locale) => {
-    logger_1.logger.info('downloadDictionary', { locale });
+async function downloadDictionary(locale) {
+    const downloadStartedAt = performance.now();
     const words = await (0, word_lists_1.getWordList)(locale);
-    logger_1.logger.info('downloadDictionary - success', { locale });
+    const buildStartedAt = performance.now();
     const gaddag = gaddag_1.Gaddag.fromArray(words);
-    logger_1.logger.info('downloadDictionary - gaddag built', { locale });
+    (0, logger_1.logEvent)({
+        type: 'build',
+        locale,
+        words: words.length,
+        download_ms: Math.round(buildStartedAt - downloadStartedAt),
+        build_ms: Math.round(performance.now() - buildStartedAt),
+    });
     return gaddag;
-};
-exports.downloadDictionary = downloadDictionary;
+}

package/packages/dictionaries/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scrabble-solver/dictionaries",
-  "version": "2.18.3",
+  "version": "2.18.5",
   "description": "Dictionary manager for Scrabble Solver: downloads per-locale word lists and serves them as GADDAG automata with layered disk/memory caching.",
   "keywords": [
     "scrabble",
@@ -37,10 +37,10 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@kamilmielnik/gaddag": "^2.0.0",
-    "@scrabble-solver/logger": "^2.18.3",
-    "@scrabble-solver/types": "^2.18.3",
-    "@scrabble-solver/word-lists": "^2.18.3"
+    "@kamilmielnik/gaddag": "^3.0.0",
+    "@scrabble-solver/logger": "^2.18.5",
+    "@scrabble-solver/types": "^2.18.5",
+    "@scrabble-solver/word-lists": "^2.18.5"
   },
   "gitHead": "1e2d1ad49a288d4a44196d8e3336740da132c637"
 }

package/packages/dictionaries/src/Dictionaries.ts

@@ -1,5 +1,5 @@
 import { type Gaddag } from '@kamilmielnik/gaddag';
-import { logger } from '@scrabble-solver/logger';
+import { logError } from '@scrabble-solver/logger';
 import { Locale } from '@scrabble-solver/types';
 import fs from 'fs';
 
@@ -28,7 +28,6 @@ export class Dictionaries {
       }
     }
 
-    logger.info('Dictionaries - cache miss', { locale });
     return this.updateDictionary(locale);
   }
 
@@ -37,10 +36,19 @@ export class Dictionaries {
     fs.rmdirSync(OUTPUT_DIRECTORY, { recursive: true });
   }
 
-  public async update(force?: boolean): Promise<void> {
+  public async update(force?: boolean): Promise<Locale[]> {
     const locales = force ? Object.values(Locale) : this.getLocalesToUpdate();
-    logger.info('Dictionaries - update', { force, locales });
-    await Promise.all(locales.map((locale) => this.updateDictionary(locale)));
+    const outcomes = await Promise.allSettled(locales.map((locale) => this.updateDictionary(locale)));
+    const failedLocales: Locale[] = [];
+
+    outcomes.forEach((outcome, index) => {
+      if (outcome.status === 'rejected') {
+        logError('build', outcome.reason, { locale: locales[index] });
+        failedLocales.push(locales[index]);
+      }
+    });
+
+    return failedLocales;
   }
 
   private getLocalesToUpdate(): Locale[] {
@@ -48,7 +56,6 @@ export class Dictionaries {
   }
 
   private async updateDictionary(locale: Locale): Promise<Gaddag> {
-    logger.info('Dictionaries - updateDictionary', { locale });
     fs.mkdirSync(OUTPUT_DIRECTORY, { recursive: true });
     const downloadDictionaryProxy = this.downloadDictionaryProxies[locale];
     const gaddag = await downloadDictionaryProxy();

package/packages/dictionaries/src/lib/DiskCache.ts

@@ -1,5 +1,5 @@
 import { Gaddag } from '@kamilmielnik/gaddag';
-import { logger } from '@scrabble-solver/logger';
+import { logError } from '@scrabble-solver/logger';
 import { type Locale } from '@scrabble-solver/types';
 import fs from 'fs';
 
@@ -31,7 +31,7 @@ export class DiskCache implements Cache<Locale, Gaddag> {
       const serialized = await fs.promises.readFile(filepath);
       return Gaddag.deserialize(new Uint8Array(serialized.buffer, serialized.byteOffset, serialized.byteLength));
     } catch (error) {
-      logger.warn('DiskCache - incompatible or corrupted dictionary file, it will be rebuilt', { error, locale });
+      logError('cache', error, { level: 'warn', locale });
       await fs.promises.rm(filepath, { force: true });
       return undefined;
     }

package/packages/dictionaries/src/lib/downloadDictionary.ts

@@ -1,13 +1,21 @@
 import { Gaddag } from '@kamilmielnik/gaddag';
-import { logger } from '@scrabble-solver/logger';
+import { logEvent } from '@scrabble-solver/logger';
 import { type Locale } from '@scrabble-solver/types';
 import { getWordList } from '@scrabble-solver/word-lists';
 
-export const downloadDictionary = async (locale: Locale): Promise<Gaddag> => {
-  logger.info('downloadDictionary', { locale });
+export async function downloadDictionary(locale: Locale): Promise<Gaddag> {
+  const downloadStartedAt = performance.now();
   const words = await getWordList(locale);
-  logger.info('downloadDictionary - success', { locale });
+  const buildStartedAt = performance.now();
   const gaddag = Gaddag.fromArray(words);
-  logger.info('downloadDictionary - gaddag built', { locale });
+
+  logEvent({
+    type: 'build',
+    locale,
+    words: words.length,
+    download_ms: Math.round(buildStartedAt - downloadStartedAt),
+    build_ms: Math.round(performance.now() - buildStartedAt),
+  });
+
   return gaddag;
-};
+}

package/packages/logger/README.md

@@ -1,3 +1,21 @@
 # @scrabble-solver/logger
 
 Logger used server-side.
+
+```
+$HOME/.scrabble-solver/logs/events.txt
+```
+
+## Export to CSV
+
+```shell
+bun run --filter @scrabble-solver/logger export        # every year
+bun run --filter @scrabble-solver/logger export 2026   # one year
+```
+
+writes one file per event type and year to `$HOME/.scrabble-solver/csv/<type>-YYYY.csv`, e.g. `visit-2026.csv`.
+
+## Previous format
+
+Before August 2026 the package wrote output to `all.log` and `error.log` in the same directory.
+Those files are neither read nor written anymore and can be deleted.

package/packages/logger/build/constants.d.ts

@@ -1 +1,4 @@
 export declare const OUTPUT_DIRECTORY: string;
+export declare const EVENTS_FILEPATH: string;
+export declare const CSV_DIRECTORY: string;
+export declare const IS_TEST_RUN: boolean;

package/packages/logger/build/constants.js

@@ -3,7 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OUTPUT_DIRECTORY = void 0;
+exports.IS_TEST_RUN = exports.CSV_DIRECTORY = exports.EVENTS_FILEPATH = exports.OUTPUT_DIRECTORY = void 0;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 exports.OUTPUT_DIRECTORY = path_1.default.resolve(os_1.default.homedir(), '.scrabble-solver', 'logs');
+exports.EVENTS_FILEPATH = path_1.default.resolve(exports.OUTPUT_DIRECTORY, 'events.txt');
+exports.CSV_DIRECTORY = path_1.default.resolve(os_1.default.homedir(), '.scrabble-solver', 'csv');
+exports.IS_TEST_RUN = process.env.NODE_ENV === 'test' || typeof describe === 'function';

package/packages/logger/build/describeError.d.ts

@@ -0,0 +1,5 @@
+export interface ErrorDescription {
+    message: string;
+    stack: string | undefined;
+}
+export declare function describeError(error: unknown): ErrorDescription;

package/packages/logger/build/describeError.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeError = describeError;
+function describeError(error) {
+    return { message: formatError(error), stack: error instanceof Error ? error.stack : undefined };
+}
+function formatError(error) {
+    if (!(error instanceof Error)) {
+        return String(error);
+    }
+    const heading = `${error.name}${formatCode(error)}: ${error.message}`.trimEnd();
+    const nested = getNestedErrors(error);
+    return nested.length === 0 ? heading : `${heading} (${nested.map(formatError).join('; ')})`;
+}
+function formatCode(error) {
+    return 'code' in error && typeof error.code === 'string' ? ` [${error.code}]` : '';
+}
+function getNestedErrors(error) {
+    if (error instanceof AggregateError) {
+        return error.errors;
+    }
+    return error.cause === undefined ? [] : [error.cause];
+}

package/packages/logger/build/events.d.ts

@@ -0,0 +1,92 @@
+export type Event = VisitEvent | SolveEvent | VerifyEvent | DownloadEvent | DefinitionEvent | BuildEvent | ErrorEvent;
+export type EventType = Event['type'];
+export type EventOf<T extends EventType> = Extract<Event, {
+    type: T;
+}>;
+export type EventValue = string | number | boolean | undefined;
+export type LoggedEvent = Event & {
+    timestamp: string;
+};
+export type Operation = 'visit' | 'solve' | 'verify' | 'download' | 'definition' | 'build' | 'cache';
+type VisitEvent = {
+    type: 'visit';
+    ip?: string;
+    ua?: string;
+    referrer?: string;
+    locale?: string;
+    game?: string;
+    url?: string;
+};
+type SolveEvent = {
+    type: 'solve';
+    ip?: string;
+    ms: number;
+    locale: string;
+    game: string;
+    tiles: number;
+    blanks: number;
+    rack: string;
+    results: number;
+};
+type VerifyEvent = {
+    type: 'verify';
+    ip?: string;
+    ms: number;
+    locale: string;
+    game: string;
+    tiles: number;
+    blanks: number;
+    valid: number;
+    invalid: number;
+};
+type DownloadEvent = {
+    type: 'download';
+    ip?: string;
+    ms: number;
+    locale: string;
+    status: number;
+    encoding: 'gzip' | 'identity';
+    bytes: number;
+};
+type DefinitionEvent = {
+    type: 'definition';
+    ip?: string;
+    ms: number;
+    locale: string;
+    words: string;
+    found: number;
+};
+type BuildEvent = {
+    type: 'build';
+    locale: string;
+    words: number;
+    download_ms: number;
+    build_ms: number;
+};
+type ErrorEvent = {
+    type: 'error';
+    level: 'error' | 'warn';
+    operation: Operation;
+    locale?: string;
+    ip?: string;
+    ua?: string;
+    message: string;
+    stack?: string;
+    input?: string;
+};
+type FieldsOf<T extends EventType> = Exclude<keyof EventOf<T>, 'type'>;
+export declare const EVENT_FIELDS: {
+    readonly visit: readonly ["ip", "ua", "referrer", "locale", "game", "url"];
+    readonly solve: readonly ["ip", "ms", "locale", "game", "tiles", "blanks", "rack", "results"];
+    readonly verify: readonly ["ip", "ms", "locale", "game", "tiles", "blanks", "valid", "invalid"];
+    readonly download: readonly ["ip", "ms", "locale", "status", "encoding", "bytes"];
+    readonly definition: readonly ["ip", "ms", "locale", "words", "found"];
+    readonly build: readonly ["locale", "words", "download_ms", "build_ms"];
+    readonly error: readonly ["level", "operation", "locale", "ip", "ua", "message", "stack", "input"];
+};
+type UnlistedFields = {
+    [T in EventType]: Exclude<FieldsOf<T>, (typeof EVENT_FIELDS)[T][number]>;
+}[EventType];
+type Assert<T extends never> = T;
+export type EveryFieldIsListed = Assert<UnlistedFields>;
+export {};

package/packages/logger/build/events.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_FIELDS = void 0;
+// Field order is the column order of the exported CSV files - append only, never reorder.
+exports.EVENT_FIELDS = {
+    visit: ['ip', 'ua', 'referrer', 'locale', 'game', 'url'],
+    solve: ['ip', 'ms', 'locale', 'game', 'tiles', 'blanks', 'rack', 'results'],
+    verify: ['ip', 'ms', 'locale', 'game', 'tiles', 'blanks', 'valid', 'invalid'],
+    download: ['ip', 'ms', 'locale', 'status', 'encoding', 'bytes'],
+    definition: ['ip', 'ms', 'locale', 'words', 'found'],
+    build: ['locale', 'words', 'download_ms', 'build_ms'],
+    error: ['level', 'operation', 'locale', 'ip', 'ua', 'message', 'stack', 'input'],
+};

package/packages/logger/build/formatCsvRow.d.ts

@@ -0,0 +1,2 @@
+import { type EventValue } from './events';
+export declare function formatCsvRow(values: EventValue[]): string;

package/packages/logger/build/formatCsvRow.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCsvRow = formatCsvRow;
+const FORMULA_PREFIX = /^[=+\-@\t\r]/;
+function formatCsvRow(values) {
+    return `${values.map(formatCsvField).join(',')}\n`;
+}
+function formatCsvField(value) {
+    if (typeof value === 'undefined') {
+        return '';
+    }
+    const text = typeof value === 'string' ? escapeFormula(value) : String(value);
+    return needsQuoting(text) ? `"${text.replaceAll('"', '""')}"` : text;
+}
+function escapeFormula(text) {
+    return FORMULA_PREFIX.test(text) ? `'${text}` : text;
+}
+function needsQuoting(text) {
+    return /[",\n\r]/.test(text) || text !== text.trim();
+}

package/packages/logger/build/index.d.ts

@@ -1 +1,5 @@
-export { logger } from './logger';
+export { CSV_DIRECTORY, EVENTS_FILEPATH, OUTPUT_DIRECTORY } from './constants';
+export { EVENT_FIELDS, type Event, type EventOf, type EventType, type EventValue, type LoggedEvent, type Operation, } from './events';
+export { formatCsvRow } from './formatCsvRow';
+export { logError } from './logError';
+export { logEvent } from './logEvent';

package/packages/logger/build/index.js

@@ -1,5 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = void 0;
-var logger_1 = require("./logger");
-Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+exports.logEvent = exports.logError = exports.formatCsvRow = exports.EVENT_FIELDS = exports.OUTPUT_DIRECTORY = exports.EVENTS_FILEPATH = exports.CSV_DIRECTORY = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "CSV_DIRECTORY", { enumerable: true, get: function () { return constants_1.CSV_DIRECTORY; } });
+Object.defineProperty(exports, "EVENTS_FILEPATH", { enumerable: true, get: function () { return constants_1.EVENTS_FILEPATH; } });
+Object.defineProperty(exports, "OUTPUT_DIRECTORY", { enumerable: true, get: function () { return constants_1.OUTPUT_DIRECTORY; } });
+var events_1 = require("./events");
+Object.defineProperty(exports, "EVENT_FIELDS", { enumerable: true, get: function () { return events_1.EVENT_FIELDS; } });
+var formatCsvRow_1 = require("./formatCsvRow");
+Object.defineProperty(exports, "formatCsvRow", { enumerable: true, get: function () { return formatCsvRow_1.formatCsvRow; } });
+var logError_1 = require("./logError");
+Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return logError_1.logError; } });
+var logEvent_1 = require("./logEvent");
+Object.defineProperty(exports, "logEvent", { enumerable: true, get: function () { return logEvent_1.logEvent; } });

package/packages/logger/build/logError.d.ts

@@ -0,0 +1,4 @@
+import { type EventOf, type Operation } from './events';
+type ErrorContext = Partial<Pick<EventOf<'error'>, 'level' | 'input' | 'ip' | 'locale' | 'ua'>>;
+export declare function logError(operation: Operation, error: unknown, { level, ...context }?: ErrorContext): void;
+export {};

package/packages/logger/build/logError.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logError = logError;
+const constants_1 = require("./constants");
+const describeError_1 = require("./describeError");
+const logEvent_1 = require("./logEvent");
+function logError(operation, error, { level = 'error', ...context } = {}) {
+    const description = (0, describeError_1.describeError)(error);
+    (0, logEvent_1.logEvent)({ type: 'error', level, operation, ...description, ...context });
+    if (level === 'error' && !constants_1.IS_TEST_RUN) {
+        process.stderr.write(formatStderrEntry(operation, description));
+    }
+}
+function formatStderrEntry(operation, { message, stack }) {
+    const frames = stack?.split('\n').filter((line) => line.startsWith('    at ')) ?? [];
+    return `${[`${operation}: ${message}`, ...frames].join('\n')}\n`;
+}

package/packages/logger/build/logEvent.d.ts

@@ -0,0 +1,3 @@
+import { type Event } from './events';
+export declare function logEvent(event: Event): void;
+export declare function formatEventLine(event: Event, now: Date): string;

package/packages/logger/build/logEvent.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logEvent = logEvent;
+exports.formatEventLine = formatEventLine;
+const fs_1 = __importDefault(require("fs"));
+const constants_1 = require("./constants");
+const events_1 = require("./events");
+function logEvent(event) {
+    if (constants_1.IS_TEST_RUN) {
+        return;
+    }
+    try {
+        fs_1.default.mkdirSync(constants_1.OUTPUT_DIRECTORY, { recursive: true });
+        fs_1.default.appendFileSync(constants_1.EVENTS_FILEPATH, formatEventLine(event, new Date()));
+    }
+    catch (error) {
+        process.stderr.write(`Could not append to ${constants_1.EVENTS_FILEPATH}: ${String(error)}\n`);
+    }
+}
+function formatEventLine(event, now) {
+    const line = { timestamp: formatTimestamp(now), ...event };
+    return `${JSON.stringify(line, ['timestamp', 'type', ...events_1.EVENT_FIELDS[event.type]])}\n`;
+}
+function formatTimestamp(date) {
+    return `${date.toISOString().slice(0, 19)}Z`;
+}

package/packages/logger/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@scrabble-solver/logger",
-  "version": "2.18.3",
-  "description": "Winston-based JSON file logger for Scrabble Solver.",
+  "version": "2.18.5",
+  "description": "JSON-lines event log for Scrabble Solver, with CSV export.",
   "keywords": [
     "logger",
-    "winston",
+    "events",
+    "csv",
     "scrabble"
   ],
   "main": "build/index.js",
@@ -24,12 +25,10 @@
   },
   "homepage": "https://scrabble-solver.org",
   "scripts": {
-    "build": "tsc --project .",
+    "build": "tsc --project . && tsc --project scripts",
     "clean": "rimraf build/",
-    "stats": "node scripts/stats.js"
-  },
-  "dependencies": {
-    "winston": "^3.19.0"
+    "export": "bun scripts/export-csv.ts",
+    "test": "bun test src"
   },
   "gitHead": "1e2d1ad49a288d4a44196d8e3336740da132c637"
 }