@steve31415/log-logger-ts 1.0.0

package/README.md

@@ -0,0 +1,128 @@
+# @steve31415/log-logger-ts
+
+Lightweight logging library for Cloudflare Workers and browsers with automatic batching and dual logging (console + backend).
+
+## Installation
+
+```bash
+npm install @steve31415/log-logger-ts
+```
+
+## Features
+
+- **Dual logging**: Logs to console immediately and batches for backend delivery
+- **Automatic batching**: Flushes on 10 events, 1 second timeout, or any ERROR (whichever first)
+- **Timeout-based flush**: `flushWithTimeout(ms)` for Workers with `ctx.waitUntil`
+- **Best-effort delivery**: `flushSync()` uses `sendBeacon` for browser page unload
+
+## Usage
+
+### Cloudflare Workers (fetch handler)
+
+```typescript
+import { Logger, FetchDeliveryAdapter } from '@steve31415/log-logger-ts';
+
+const INGEST_ENDPOINT = 'https://log-ingest.example.com/v1/logs:ingest';
+
+export default {
+  async fetch(request, env, ctx) {
+    const logger = new Logger(
+      { app: 'my-app', context: 'worker_http' },
+      new FetchDeliveryAdapter(INGEST_ENDPOINT)
+    );
+
+    try {
+      logger.info('Request received', { url: request.url });
+      // ... handle request
+      return new Response('OK');
+    } finally {
+      ctx.waitUntil(logger.flushWithTimeout(3000));
+    }
+  }
+}
+```
+
+### Cloudflare Workers (cron/queue)
+
+```typescript
+import { Logger, FetchDeliveryAdapter } from '@steve31415/log-logger-ts';
+
+const INGEST_ENDPOINT = 'https://log-ingest.example.com/v1/logs:ingest';
+
+async scheduled(event, env, ctx) {
+  const logger = new Logger(
+    { app: 'my-app', context: 'worker_cron', runId: crypto.randomUUID() },
+    new FetchDeliveryAdapter(INGEST_ENDPOINT)
+  );
+
+  try {
+    logger.info('Cron started');
+    // ... do work
+    logger.info('Cron completed');
+  } finally {
+    await logger.flushWithTimeout(3000);
+  }
+}
+```
+
+### Browser
+
+```typescript
+import { Logger, BrowserDeliveryAdapter } from '@steve31415/log-logger-ts';
+
+const logger = new Logger(
+  { app: 'my-app', context: 'web_frontend' },
+  new BrowserDeliveryAdapter('/api/logs')
+);
+
+// Flush on page visibility change (uses sendBeacon for reliability)
+document.addEventListener('visibilitychange', () => {
+  if (document.visibilityState === 'hidden') {
+    logger.flushSync();
+  }
+});
+```
+
+## API
+
+### Logger Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `app` | string | required | Application name |
+| `context` | string | required | Execution context (e.g., `worker_http`, `web_frontend`) |
+| `runId` | string | optional | Correlation ID for invocation/session |
+| `logger` | string | optional | Module/subsystem name |
+| `batchSize` | number | 10 | Max events before flush |
+| `batchTimeoutMs` | number | 1000 | Max time before flush (ms) |
+| `consoleLog` | boolean | true | Enable console logging |
+| `minLevel` | LogLevel | 'DEBUG' | Minimum level to log |
+
+### Log Levels
+
+- `logger.debug(message, meta?)` - DEBUG level
+- `logger.info(message, meta?)` - INFO level
+- `logger.warn(message, meta?)` - WARN level
+- `logger.error(message, meta?)` - ERROR level (triggers immediate flush)
+
+### Child Loggers
+
+```typescript
+const logger = new Logger({ app: 'my-app', context: 'worker_http' }, adapter);
+const dbLogger = logger.child('database');
+const authLogger = logger.child('auth');
+
+dbLogger.info('Query executed');  // Logs as [my-app:database]
+authLogger.warn('Token expired'); // Logs as [my-app:auth]
+```
+
+### Flush Methods
+
+- `flush()` - Async flush of buffered events
+- `flushWithTimeout(ms)` - Flush with timeout, falls back to `sendBeacon` if available
+- `flushSync()` - Synchronous best-effort flush using `sendBeacon` (for page unload)
+- `close()` - Flush and prevent further logging
+
+## License
+
+MIT

package/dist/adapters/browser.d.ts

@@ -0,0 +1,14 @@
+import type { DeliveryAdapter, IngestPayload } from '../types';
+/**
+ * Browser-based delivery adapter with sendBeacon fallback
+ */
+export declare class BrowserDeliveryAdapter implements DeliveryAdapter {
+    private endpoint;
+    constructor(endpoint: string);
+    deliver(payload: IngestPayload): Promise<boolean>;
+    /**
+     * Best-effort delivery using sendBeacon for page unload scenarios
+     */
+    deliverBestEffort(payload: IngestPayload): boolean;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/adapters/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AAE/E;;GAEG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAChD,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE9B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BvD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;CAanD"}

package/dist/adapters/browser.js

@@ -0,0 +1,52 @@
+/**
+ * Browser-based delivery adapter with sendBeacon fallback
+ */
+export class BrowserDeliveryAdapter {
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+    }
+    async deliver(payload) {
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+                // keepalive allows the request to outlive the page
+                keepalive: true,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                console.error(`[Logger] Delivery failed: ${response.status} ${text}`);
+                return false;
+            }
+            const result = await response.json();
+            if (result.rejected > 0) {
+                console.warn(`[Logger] ${result.rejected} events rejected:`, result.errors);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('[Logger] Delivery error:', error);
+            return false;
+        }
+    }
+    /**
+     * Best-effort delivery using sendBeacon for page unload scenarios
+     */
+    deliverBestEffort(payload) {
+        if (typeof navigator !== 'undefined' && navigator.sendBeacon) {
+            const blob = new Blob([JSON.stringify(payload)], {
+                type: 'application/json',
+            });
+            const success = navigator.sendBeacon(this.endpoint, blob);
+            if (!success) {
+                console.error('[Logger] sendBeacon failed');
+            }
+            return success;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/adapters/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,mDAAmD;gBACnD,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,MAAM,GAAmB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,QAAQ,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9E,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAsB;QACtC,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE;gBAC/C,IAAI,EAAE,kBAAkB;aACzB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/adapters/fetch.d.ts

@@ -0,0 +1,10 @@
+import type { DeliveryAdapter, IngestPayload } from '../types';
+/**
+ * Fetch-based delivery adapter for Cloudflare Workers and Node.js environments
+ */
+export declare class FetchDeliveryAdapter implements DeliveryAdapter {
+    private endpoint;
+    constructor(endpoint: string);
+    deliver(payload: IngestPayload): Promise<boolean>;
+}
+//# sourceMappingURL=fetch.d.ts.map

package/dist/adapters/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/adapters/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AAE/E;;GAEG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAC9C,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE9B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CA0BxD"}

package/dist/adapters/fetch.js

@@ -0,0 +1,34 @@
+/**
+ * Fetch-based delivery adapter for Cloudflare Workers and Node.js environments
+ */
+export class FetchDeliveryAdapter {
+    constructor(endpoint) {
+        this.endpoint = endpoint;
+    }
+    async deliver(payload) {
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                console.error(`[Logger] Delivery failed: ${response.status} ${text}`);
+                return false;
+            }
+            const result = await response.json();
+            if (result.rejected > 0) {
+                console.warn(`[Logger] ${result.rejected} events rejected:`, result.errors);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('[Logger] Delivery error:', error);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/adapters/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/adapters/fetch.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,MAAM,GAAmB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,QAAQ,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9E,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export { FetchDeliveryAdapter } from './fetch';
+export { BrowserDeliveryAdapter } from './browser';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,3 @@
+export { FetchDeliveryAdapter } from './fetch';
+export { BrowserDeliveryAdapter } from './browser';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @steve31415/log-logger-ts - Lightweight logging library for Cloudflare Workers and browsers
+ *
+ * Features:
+ * - Dual logging: console + backend delivery
+ * - Automatic batching (10 events, 1 second, or on ERROR)
+ * - Timeout-based flush for Workers
+ * - Best-effort sendBeacon for browser page unload
+ *
+ * @example Workers fetch handler
+ * ```typescript
+ * import { Logger, FetchDeliveryAdapter } from '@steve31415/log-logger-ts';
+ *
+ * const INGEST_ENDPOINT = 'https://log-ingest.example.com/v1/logs:ingest';
+ *
+ * export default {
+ *   async fetch(request, env, ctx) {
+ *     const logger = new Logger(
+ *       { app: 'my-app', context: 'worker_http' },
+ *       new FetchDeliveryAdapter(INGEST_ENDPOINT)
+ *     );
+ *     try {
+ *       logger.info('Request received', { url: request.url });
+ *       // ... handle request
+ *       return new Response('OK');
+ *     } finally {
+ *       ctx.waitUntil(logger.flushWithTimeout(3000));
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example Browser
+ * ```typescript
+ * import { Logger, BrowserDeliveryAdapter } from '@steve31415/log-logger-ts';
+ *
+ * const logger = new Logger(
+ *   { app: 'my-app', context: 'web_frontend' },
+ *   new BrowserDeliveryAdapter('/api/logs')
+ * );
+ *
+ * // Flush on page unload
+ * document.addEventListener('visibilitychange', () => {
+ *   if (document.visibilityState === 'hidden') {
+ *     logger.flushSync();
+ *   }
+ * });
+ * ```
+ */
+export { Logger } from './logger';
+export { FetchDeliveryAdapter, BrowserDeliveryAdapter } from './adapters';
+export type { LogLevel, LogEvent, LoggerConfig, DeliveryAdapter, ConsoleAdapter, IngestPayload, IngestResponse, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+/**
+ * @steve31415/log-logger-ts - Lightweight logging library for Cloudflare Workers and browsers
+ *
+ * Features:
+ * - Dual logging: console + backend delivery
+ * - Automatic batching (10 events, 1 second, or on ERROR)
+ * - Timeout-based flush for Workers
+ * - Best-effort sendBeacon for browser page unload
+ *
+ * @example Workers fetch handler
+ * ```typescript
+ * import { Logger, FetchDeliveryAdapter } from '@steve31415/log-logger-ts';
+ *
+ * const INGEST_ENDPOINT = 'https://log-ingest.example.com/v1/logs:ingest';
+ *
+ * export default {
+ *   async fetch(request, env, ctx) {
+ *     const logger = new Logger(
+ *       { app: 'my-app', context: 'worker_http' },
+ *       new FetchDeliveryAdapter(INGEST_ENDPOINT)
+ *     );
+ *     try {
+ *       logger.info('Request received', { url: request.url });
+ *       // ... handle request
+ *       return new Response('OK');
+ *     } finally {
+ *       ctx.waitUntil(logger.flushWithTimeout(3000));
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example Browser
+ * ```typescript
+ * import { Logger, BrowserDeliveryAdapter } from '@steve31415/log-logger-ts';
+ *
+ * const logger = new Logger(
+ *   { app: 'my-app', context: 'web_frontend' },
+ *   new BrowserDeliveryAdapter('/api/logs')
+ * );
+ *
+ * // Flush on page unload
+ * document.addEventListener('visibilitychange', () => {
+ *   if (document.visibilityState === 'hidden') {
+ *     logger.flushSync();
+ *   }
+ * });
+ * ```
+ */
+export { Logger } from './logger';
+export { FetchDeliveryAdapter, BrowserDeliveryAdapter } from './adapters';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,72 @@
+import type { LogLevel, LoggerConfig, DeliveryAdapter, ConsoleAdapter } from './types';
+/**
+ * Logger class with batching and multi-environment support
+ */
+export declare class Logger {
+    private config;
+    private adapter;
+    private console;
+    private buffer;
+    private flushTimer;
+    private firstEventTime;
+    private closed;
+    private flushPromise;
+    private inFlightPayload;
+    constructor(config: LoggerConfig, adapter: DeliveryAdapter, consoleAdapter?: ConsoleAdapter);
+    /**
+     * Create a child logger with a different logger name
+     */
+    child(loggerName: string): Logger;
+    /**
+     * Log at DEBUG level
+     */
+    debug(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log at INFO level
+     */
+    info(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log at WARN level
+     */
+    warn(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log at ERROR level
+     */
+    error(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Log at a specific level
+     */
+    log(level: LogLevel, message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Schedule a flush after the batch timeout
+     */
+    private scheduleFlush;
+    /**
+     * Clear the scheduled flush timer
+     */
+    private clearFlushTimer;
+    /**
+     * Flush buffered events to the backend
+     */
+    flush(): Promise<void>;
+    /**
+     * Deliver payload with a single retry on failure
+     */
+    private deliverWithRetry;
+    /**
+     * Flush with a timeout - useful for Workers and end-of-task scenarios
+     * @param timeoutMs Maximum time to wait for flush to complete
+     * @returns Promise that resolves when flush completes or times out
+     */
+    flushWithTimeout(timeoutMs: number): Promise<void>;
+    /**
+     * Close the logger - flushes remaining events and prevents further logging
+     */
+    close(): Promise<void>;
+    /**
+     * Best-effort flush using sendBeacon (for page unload scenarios)
+     * Call this from visibilitychange or pagehide event handlers
+     */
+    flushSync(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAER,YAAY,EACZ,eAAe,EACf,cAAc,EAEf,MAAM,SAAS,CAAC;AAqBjB;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAyG;IACvH,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAiB;IAEhC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,eAAe,CAA8B;gBAGnD,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,EACxB,cAAc,GAAE,cAAwB;IAgB1C;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAQjC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkD3E;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;OAEG;YACW,gBAAgB;IAe9B;;;;OAIG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BxD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;OAGG;IACH,SAAS,IAAI,IAAI;CAmBlB"}

package/dist/logger.js

@@ -0,0 +1,251 @@
+const LEVEL_PRIORITY = {
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+};
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_BATCH_TIMEOUT_MS = 1000;
+/**
+ * Generate a simple unique ID for log events
+ */
+function generateId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 10);
+    return `${timestamp}-${random}`;
+}
+/**
+ * Logger class with batching and multi-environment support
+ */
+export class Logger {
+    constructor(config, adapter, consoleAdapter = console) {
+        this.buffer = [];
+        this.flushTimer = null;
+        this.firstEventTime = null;
+        this.closed = false;
+        this.flushPromise = null;
+        this.inFlightPayload = null;
+        this.config = {
+            app: config.app,
+            context: config.context,
+            runId: config.runId,
+            logger: config.logger,
+            batchSize: config.batchSize ?? DEFAULT_BATCH_SIZE,
+            batchTimeoutMs: config.batchTimeoutMs ?? DEFAULT_BATCH_TIMEOUT_MS,
+            consoleLog: config.consoleLog ?? true,
+            minLevel: config.minLevel ?? 'DEBUG',
+        };
+        this.adapter = adapter;
+        this.console = consoleAdapter;
+    }
+    /**
+     * Create a child logger with a different logger name
+     */
+    child(loggerName) {
+        return new Logger({ ...this.config, logger: loggerName }, this.adapter, this.console);
+    }
+    /**
+     * Log at DEBUG level
+     */
+    debug(message, meta) {
+        this.log('DEBUG', message, meta);
+    }
+    /**
+     * Log at INFO level
+     */
+    info(message, meta) {
+        this.log('INFO', message, meta);
+    }
+    /**
+     * Log at WARN level
+     */
+    warn(message, meta) {
+        this.log('WARN', message, meta);
+    }
+    /**
+     * Log at ERROR level
+     */
+    error(message, meta) {
+        this.log('ERROR', message, meta);
+    }
+    /**
+     * Log at a specific level
+     */
+    log(level, message, meta) {
+        if (this.closed) {
+            this.console.warn('[Logger] Attempted to log after close');
+            return;
+        }
+        // Check minimum level
+        if (LEVEL_PRIORITY[level] < LEVEL_PRIORITY[this.config.minLevel]) {
+            return;
+        }
+        const timestamp = Date.now();
+        // Log to native console immediately
+        if (this.config.consoleLog) {
+            const prefix = this.config.logger
+                ? `[${this.config.app}:${this.config.logger}]`
+                : `[${this.config.app}]`;
+            const consoleFn = this.console[level.toLowerCase()];
+            if (meta && Object.keys(meta).length > 0) {
+                consoleFn(`${prefix} ${message}`, meta);
+            }
+            else {
+                consoleFn(`${prefix} ${message}`);
+            }
+        }
+        // Create event for batching
+        const event = {
+            id: generateId(),
+            level,
+            message,
+            time_generated_client_ms: timestamp,
+            logger: this.config.logger,
+            meta,
+        };
+        this.buffer.push(event);
+        // Track first event time for batch timeout
+        if (this.firstEventTime === null) {
+            this.firstEventTime = timestamp;
+            this.scheduleFlush();
+        }
+        // Flush immediately on ERROR or when batch size reached
+        if (level === 'ERROR' || this.buffer.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    /**
+     * Schedule a flush after the batch timeout
+     */
+    scheduleFlush() {
+        if (this.flushTimer !== null) {
+            return;
+        }
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            this.flush();
+        }, this.config.batchTimeoutMs);
+    }
+    /**
+     * Clear the scheduled flush timer
+     */
+    clearFlushTimer() {
+        if (this.flushTimer !== null) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    /**
+     * Flush buffered events to the backend
+     */
+    async flush() {
+        // If already flushing, wait for it
+        if (this.flushPromise) {
+            await this.flushPromise;
+            return;
+        }
+        this.clearFlushTimer();
+        if (this.buffer.length === 0) {
+            return;
+        }
+        // Take current buffer
+        const events = this.buffer;
+        this.buffer = [];
+        this.firstEventTime = null;
+        const payload = {
+            app: this.config.app,
+            context: this.config.context,
+            run_id: this.config.runId,
+            events,
+        };
+        this.inFlightPayload = payload;
+        this.flushPromise = this.deliverWithRetry(payload);
+        try {
+            await this.flushPromise;
+        }
+        finally {
+            this.flushPromise = null;
+            this.inFlightPayload = null;
+        }
+    }
+    /**
+     * Deliver payload with a single retry on failure
+     */
+    async deliverWithRetry(payload) {
+        let success = await this.adapter.deliver(payload);
+        if (!success) {
+            // Single retry
+            this.console.warn('[Logger] Retrying delivery...');
+            success = await this.adapter.deliver(payload);
+            if (!success) {
+                this.console.error(`[Logger] CRITICAL: Failed to deliver ${payload.events.length} log events after retry`);
+                // Events are lost at this point - we don't re-queue to avoid memory growth
+            }
+        }
+    }
+    /**
+     * Flush with a timeout - useful for Workers and end-of-task scenarios
+     * @param timeoutMs Maximum time to wait for flush to complete
+     * @returns Promise that resolves when flush completes or times out
+     */
+    async flushWithTimeout(timeoutMs) {
+        const flushPromise = this.flush();
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Flush timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+        try {
+            await Promise.race([flushPromise, timeoutPromise]);
+        }
+        catch (error) {
+            this.console.error('[Logger] Flush timeout:', error);
+            // Attempt best-effort delivery if adapter supports it
+            // Use in-flight payload if flush took the buffer, otherwise use current buffer
+            const payload = this.inFlightPayload ?? (this.buffer.length > 0 ? {
+                app: this.config.app,
+                context: this.config.context,
+                run_id: this.config.runId,
+                events: this.buffer,
+            } : null);
+            if (payload && this.adapter.deliverBestEffort) {
+                this.adapter.deliverBestEffort(payload);
+                this.buffer = [];
+            }
+        }
+    }
+    /**
+     * Close the logger - flushes remaining events and prevents further logging
+     */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.clearFlushTimer();
+        await this.flush();
+    }
+    /**
+     * Best-effort flush using sendBeacon (for page unload scenarios)
+     * Call this from visibilitychange or pagehide event handlers
+     */
+    flushSync() {
+        if (this.buffer.length === 0) {
+            return;
+        }
+        if (this.adapter.deliverBestEffort) {
+            const payload = {
+                app: this.config.app,
+                context: this.config.context,
+                run_id: this.config.runId,
+                events: this.buffer,
+            };
+            const success = this.adapter.deliverBestEffort(payload);
+            if (success) {
+                this.buffer = [];
+                this.firstEventTime = null;
+            }
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Log level types
+ */
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+/**
+ * A single log event to be delivered to the backend
+ */
+export interface LogEvent {
+    id: string;
+    level: LogLevel;
+    message: string;
+    time_generated_client_ms: number;
+    logger?: string;
+    meta?: Record<string, unknown>;
+}
+/**
+ * The payload sent to the ingest API
+ */
+export interface IngestPayload {
+    app: string;
+    context: string;
+    run_id?: string;
+    events: LogEvent[];
+}
+/**
+ * Response from the ingest API
+ */
+export interface IngestResponse {
+    accepted: number;
+    rejected: number;
+    errors?: string[];
+}
+/**
+ * Configuration for the logger
+ */
+export interface LoggerConfig {
+    /** Application name (required) */
+    app: string;
+    /** Execution context: web_frontend, worker_http, worker_cron, etc. */
+    context: string;
+    /** @deprecated Endpoint is now specified in the DeliveryAdapter constructor */
+    endpoint?: string;
+    /** Optional run/session ID for correlation */
+    runId?: string;
+    /** Optional default logger name (subsystem) */
+    logger?: string;
+    /** Batch size threshold (default: 10) */
+    batchSize?: number;
+    /** Batch time threshold in ms (default: 1000) */
+    batchTimeoutMs?: number;
+    /** Whether to log to console in addition to backend (default: true) */
+    consoleLog?: boolean;
+    /** Minimum level to log (default: DEBUG) */
+    minLevel?: LogLevel;
+}
+/**
+ * Delivery adapter interface for different environments
+ */
+export interface DeliveryAdapter {
+    /**
+     * Send a batch of events to the backend
+     * @returns true if delivery succeeded, false otherwise
+     */
+    deliver(payload: IngestPayload): Promise<boolean>;
+    /**
+     * Attempt to deliver using best-effort methods (e.g., sendBeacon)
+     * Used during page unload or service worker termination
+     */
+    deliverBestEffort?(payload: IngestPayload): boolean;
+}
+/**
+ * Native console interface for logging
+ */
+export interface ConsoleAdapter {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB,EAAE,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IAEZ,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAEhB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD;;;OAGG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@steve31415/log-logger-ts",
+  "version": "1.0.0",
+  "description": "Lightweight logging library for Cloudflare Workers and browsers",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest"
+  },
+  "keywords": [
+    "logging",
+    "cloudflare",
+    "workers",
+    "browser"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/plasticine-apps/log.git",
+    "directory": "libs/logger-ts"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vitest": "^2.1.9"
+  }
+}