scrabble-solver 2.18.2 → 2.18.4

package/packages/logger/src/formatCsvRow.ts

@@ -0,0 +1,24 @@
+import { type EventValue } from './events';
+
+const FORMULA_PREFIX = /^[=+\-@\t\r]/;
+
+export function formatCsvRow(values: EventValue[]): string {
+  return `${values.map(formatCsvField).join(',')}\n`;
+}
+
+function formatCsvField(value: EventValue): string {
+  if (typeof value === 'undefined') {
+    return '';
+  }
+
+  const text = typeof value === 'string' ? escapeFormula(value) : String(value);
+  return needsQuoting(text) ? `"${text.replaceAll('"', '""')}"` : text;
+}
+
+function escapeFormula(text: string): string {
+  return FORMULA_PREFIX.test(text) ? `'${text}` : text;
+}
+
+function needsQuoting(text: string): boolean {
+  return /[",\n\r]/.test(text) || text !== text.trim();
+}

package/packages/logger/src/index.ts

@@ -1 +1,13 @@
-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/src/logError.ts

@@ -0,0 +1,24 @@
+import { IS_TEST_RUN } from './constants';
+import { describeError, type ErrorDescription } from './describeError';
+import { type EventOf, type Operation } from './events';
+import { logEvent } from './logEvent';
+
+type ErrorContext = Partial<Pick<EventOf<'error'>, 'level' | 'input' | 'ip' | 'locale' | 'ua'>>;
+
+export function logError(
+  operation: Operation,
+  error: unknown,
+  { level = 'error', ...context }: ErrorContext = {},
+): void {
+  const description = describeError(error);
+  logEvent({ type: 'error', level, operation, ...description, ...context });
+
+  if (level === 'error' && !IS_TEST_RUN) {
+    process.stderr.write(formatStderrEntry(operation, description));
+  }
+}
+
+function formatStderrEntry(operation: Operation, { message, stack }: ErrorDescription): string {
+  const frames = stack?.split('\n').filter((line) => line.startsWith('    at ')) ?? [];
+  return `${[`${operation}: ${message}`, ...frames].join('\n')}\n`;
+}

package/packages/logger/src/logEvent.test.ts

@@ -0,0 +1,59 @@
+import { formatEventLine } from './logEvent';
+
+const NOW = new Date('2026-08-23T02:09:02.123Z');
+
+describe('formatEventLine', () => {
+  it('orders keys as timestamp, type, then the declared fields', () => {
+    const line = formatEventLine(
+      {
+        type: 'solve',
+        results: 312,
+        rack: 'p,z, ,c,v,m,t',
+        blanks: 4,
+        tiles: 61,
+        game: 'scrabble',
+        locale: 'en-US',
+        ms: 14,
+        ip: '203.0.113.7',
+      },
+      NOW,
+    );
+
+    expect(Object.keys(JSON.parse(line) as Record<string, unknown>)).toEqual([
+      'timestamp',
+      'type',
+      'ip',
+      'ms',
+      'locale',
+      'game',
+      'tiles',
+      'blanks',
+      'rack',
+      'results',
+    ]);
+  });
+
+  it('formats the timestamp in UTC with seconds precision', () => {
+    const line = formatEventLine({ type: 'build', locale: 'pl-PL', words: 3, download_ms: 1, build_ms: 2 }, NOW);
+
+    expect(line).toBe(
+      '{"timestamp":"2026-08-23T02:09:02Z","type":"build","locale":"pl-PL","words":3,"download_ms":1,"build_ms":2}\n',
+    );
+  });
+
+  it('omits undefined fields', () => {
+    const line = formatEventLine({ type: 'visit', ip: '::1', referrer: undefined }, NOW);
+
+    expect(line).toBe('{"timestamp":"2026-08-23T02:09:02Z","type":"visit","ip":"::1"}\n');
+  });
+
+  it('keeps multi-line values on a single line', () => {
+    const line = formatEventLine(
+      { type: 'error', level: 'error', operation: 'solve', message: 'Error: boom', stack: 'Error: boom\n    at solve' },
+      NOW,
+    );
+
+    expect(line.endsWith('\n')).toBe(true);
+    expect(line.slice(0, -1)).not.toContain('\n');
+  });
+});

package/packages/logger/src/logEvent.ts

@@ -0,0 +1,26 @@
+import fs from 'fs';
+
+import { EVENTS_FILEPATH, IS_TEST_RUN, OUTPUT_DIRECTORY } from './constants';
+import { EVENT_FIELDS, type Event } from './events';
+
+export function logEvent(event: Event): void {
+  if (IS_TEST_RUN) {
+    return;
+  }
+
+  try {
+    fs.mkdirSync(OUTPUT_DIRECTORY, { recursive: true });
+    fs.appendFileSync(EVENTS_FILEPATH, formatEventLine(event, new Date()));
+  } catch (error) {
+    process.stderr.write(`Could not append to ${EVENTS_FILEPATH}: ${String(error)}\n`);
+  }
+}
+
+export function formatEventLine(event: Event, now: Date): string {
+  const line = { timestamp: formatTimestamp(now), ...event };
+  return `${JSON.stringify(line, ['timestamp', 'type', ...EVENT_FIELDS[event.type]])}\n`;
+}
+
+function formatTimestamp(date: Date): string {
+  return `${date.toISOString().slice(0, 19)}Z`;
+}

package/packages/scrabble-solver/.next/BUILD_ID

@@ -1 +1 @@
-nvGZh1gPuX98L07YmxlYD
+TAqjh9l5VJQOfJ4SzgPk2

package/packages/scrabble-solver/.next/build-manifest.json

@@ -4,37 +4,37 @@
   ],
   "devFiles": [],
   "lowPriorityFiles": [
-    "static/nvGZh1gPuX98L07YmxlYD/_buildManifest.js",
-    "static/nvGZh1gPuX98L07YmxlYD/_ssgManifest.js"
+    "static/TAqjh9l5VJQOfJ4SzgPk2/_buildManifest.js",
+    "static/TAqjh9l5VJQOfJ4SzgPk2/_ssgManifest.js"
   ],
   "rootMainFiles": [],
   "rootMainFilesTree": {},
   "pages": {
     "/": [
-      "static/chunks/webpack-9f5c9d275348829b.js",
+      "static/chunks/webpack-d73aa4aae49cd800.js",
       "static/chunks/framework-626cbd48ac5aca57.js",
-      "static/chunks/main-7e52da35a4beea0b.js",
-      "static/chunks/101-829ab8a8d310e7a0.js",
-      "static/css/a691348b788f8bc0.css",
-      "static/chunks/pages/index-b5bf018100015277.js"
+      "static/chunks/main-6e9ac37e28d2b899.js",
+      "static/chunks/101-f341f70c10d71212.js",
+      "static/css/8b8087461767360a.css",
+      "static/chunks/pages/index-ea21d96a88f25000.js"
     ],
     "/_app": [
-      "static/chunks/webpack-9f5c9d275348829b.js",
+      "static/chunks/webpack-d73aa4aae49cd800.js",
       "static/chunks/framework-626cbd48ac5aca57.js",
-      "static/chunks/main-7e52da35a4beea0b.js",
-      "static/css/92f85ce358a0a468.css",
-      "static/chunks/pages/_app-f9ec81278ffa7b1a.js"
+      "static/chunks/main-6e9ac37e28d2b899.js",
+      "static/css/4dbcacc1122ac6b9.css",
+      "static/chunks/pages/_app-9340d51f5a6787fc.js"
     ],
     "/_error": [
-      "static/chunks/webpack-9f5c9d275348829b.js",
+      "static/chunks/webpack-d73aa4aae49cd800.js",
       "static/chunks/framework-626cbd48ac5aca57.js",
-      "static/chunks/main-7e52da35a4beea0b.js",
+      "static/chunks/main-6e9ac37e28d2b899.js",
       "static/chunks/pages/_error-f0290a98eb3ed0ec.js"
     ],
     "/not-found": [
-      "static/chunks/webpack-9f5c9d275348829b.js",
+      "static/chunks/webpack-d73aa4aae49cd800.js",
       "static/chunks/framework-626cbd48ac5aca57.js",
-      "static/chunks/main-7e52da35a4beea0b.js",
+      "static/chunks/main-6e9ac37e28d2b899.js",
       "static/css/dee878eb64099d92.css",
       "static/chunks/pages/not-found-a59f9deeeff63d17.js"
     ]

package/packages/scrabble-solver/.next/cache/.previewinfo

@@ -1 +1 @@
-{"previewModeId":"a0d7e48d2f751f641ae8d4e15ae2a9dc","previewModeSigningKey":"80604c8e4164b32e142703706235bffd675c80348fdfef7f93e5d13ef7760c2a","previewModeEncryptionKey":"356a31690fd9d3054c9de7112f4dee3c0d25d77d322ea00b9f7e8c673ddd0a88","expireAt":1788642382928}
+{"previewModeId":"e5170c92693187cbcaea7f0870f1dee9","previewModeSigningKey":"0c5a68123049e96214b96449ac2369512c92f037cbaa7ba1fcbbb5cc88a9f616","previewModeEncryptionKey":"f221cca83515401e7209f83f08b599624beae995a831fce2f0cad7b3ad0717c4","expireAt":1789073653209}

package/packages/scrabble-solver/.next/cache/.rscinfo

@@ -1 +1 @@
-{"encryption.key":"uC1/GoeGHlLbV2czZ46EDoCC+XobPQZuP42mkVQI9ws=","encryption.expire_at":1788642382925}
+{"encryption.key":"J2cfMTok6hqjBhYuQZFGtnkvM8aA3sSVCNwugUSwtMc=","encryption.expire_at":1789073653206}