@logship/logger 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @logship/logger
+
+Logger SDK: send logs to the ingestion API with buffer, batch, and retry.
+
+## Install
+
+```bash
+npm install @logship/logger
+```
+
+## Usage
+
+```ts
+import { init } from '@logship/logger';
+
+const logger = init({
+  apiKey: process.env.LOGGER_API_KEY,
+  minLevel: 'info',
+  defaultMetadata: { service: 'api', version: '1.0' },
+});
+
+logger.info('User signed in', { userId: 123 });
+logger.error('Payment failed', { orderId: 'ord_abc' });
+```
+
+## Config
+
+- **apiKey** (required): API key from the dashboard.
+- **minLevel**: `'debug' | 'info' | 'warn' | 'error'` – events below are dropped. Default `'debug'`.
+- **minLevelByEnv**: e.g. `{ production: 'info' }` – overrides minLevel when `env` matches.
+- **sampleRate**: 0–1; 1 = keep all. Error/warn are always kept unless overridden by sampleRateByLevel.
+- **sampleRateByLevel**: e.g. `{ info: 0.1 }` – per-level sampling.
+- **defaultMetadata**: Merged into every log's metadata.
+- **env**: Environment name (e.g. `'production'`) for minLevelByEnv.
+
+## Other languages
+
+- **Go:** Use the same ingestion API (`POST /v1/logs` with `Authorization: Bearer <api_key>`). Request body: `{"events":[{...}]}`. See [LOGGER_GO_CLIENT.md](../../documentation/LOGGER_GO_CLIENT.md) in the repo for install (none for REST), request shape, and a minimal Go example. Published as **@logship/logger** on npm.
+
+## Sprint 1
+
+- No flush to API yet; events are buffered in memory. Flush will be wired in a later sprint.

package/dist/src/client.d.ts

@@ -0,0 +1,17 @@
+import { LEVEL_ORDER, type LogEvent, type LogLevel, type LoggerConfig } from './types';
+declare const LEVELS: LogLevel[];
+export interface LoggerInstance {
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    info(message: string, metadata?: Record<string, unknown>): void;
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    error(message: string, metadata?: Record<string, unknown>): void;
+    /** Flush buffer: send up to batchSize events to each transport. */
+    flush(): Promise<void>;
+}
+export declare function init(config: LoggerConfig): LoggerInstance;
+/** For tests: get current buffer (read-only). */
+export declare function getBuffer(): readonly LogEvent[];
+/** For tests: clear buffer and config; stop flush interval. */
+export declare function reset(): void;
+export { LEVEL_ORDER, LEVELS };
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvF,QAAA,MAAM,MAAM,EAAE,QAAQ,EAAuC,CAAC;AAgC9D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,mEAAmE;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAmCD,wBAAgB,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAqCzD;AA4BD,iDAAiD;AACjD,wBAAgB,SAAS,IAAI,SAAS,QAAQ,EAAE,CAE/C;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,IAAI,IAAI,CAO5B;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC"}

package/dist/src/client.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEVELS = exports.LEVEL_ORDER = void 0;
+exports.init = init;
+exports.getBuffer = getBuffer;
+exports.reset = reset;
+const types_1 = require("./types");
+Object.defineProperty(exports, "LEVEL_ORDER", { enumerable: true, get: function () { return types_1.LEVEL_ORDER; } });
+const noop_1 = require("./transports/noop");
+const LEVELS = ['debug', 'info', 'warn', 'error'];
+exports.LEVELS = LEVELS;
+const DEFAULT_BATCH_SIZE = 50;
+const DEFAULT_FLUSH_INTERVAL_MS = 5000;
+function randomId() {
+    return 'evt_' + Math.random().toString(36).slice(2) + Date.now().toString(36);
+}
+function effectiveMinLevel(config) {
+    const env = config.env ?? (typeof process !== 'undefined' ? process.env?.NODE_ENV ?? '' : '');
+    const envKey = typeof env === 'string' ? env : '';
+    const byEnv = config.minLevelByEnv?.[envKey];
+    const level = byEnv ?? config.minLevel ?? 'debug';
+    return types_1.LEVEL_ORDER[level] ?? types_1.LEVEL_ORDER.debug;
+}
+function effectiveSampleRate(level, config) {
+    const byLevel = config.sampleRateByLevel;
+    if (byLevel && level in byLevel)
+        return byLevel[level];
+    if (level === 'error' || level === 'warn')
+        return 1;
+    return config.sampleRate ?? 1;
+}
+function mergeMetadata(defaultMetadata, metadata) {
+    if (!defaultMetadata && !metadata)
+        return undefined;
+    return { ...defaultMetadata, ...metadata };
+}
+let globalConfig = null;
+const buffer = [];
+let flushIntervalId = null;
+function getEffectiveTransports(config) {
+    const t = config.transports;
+    if (t && t.length > 0)
+        return t;
+    return [noop_1.noopTransport];
+}
+function getBatchSize(config) {
+    const n = config.batchSize ?? DEFAULT_BATCH_SIZE;
+    return n > 0 ? n : DEFAULT_BATCH_SIZE;
+}
+async function doFlush() {
+    const config = globalConfig;
+    if (!config)
+        return;
+    const batchSize = getBatchSize(config);
+    const batch = buffer.splice(0, batchSize);
+    if (batch.length === 0)
+        return;
+    const transports = getEffectiveTransports(config);
+    await Promise.all(transports.map(async (t) => {
+        try {
+            await t.send([...batch]);
+        }
+        catch (_err) {
+            // best-effort: one transport failure does not block others
+        }
+    }));
+}
+function init(config) {
+    if (!config?.apiKey || String(config.apiKey).trim() === '') {
+        throw new Error('Logger.init: apiKey is required');
+    }
+    if (flushIntervalId) {
+        clearInterval(flushIntervalId);
+        flushIntervalId = null;
+    }
+    globalConfig = {
+        ...config,
+        batchSize: config.batchSize ?? DEFAULT_BATCH_SIZE,
+        flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,
+    };
+    const intervalMs = globalConfig.flushIntervalMs ?? 0;
+    if (intervalMs > 0) {
+        flushIntervalId = setInterval(() => {
+            doFlush().catch(() => { });
+        }, intervalMs);
+    }
+    return {
+        debug(msg, meta) {
+            enqueue('debug', msg, meta);
+        },
+        info(msg, meta) {
+            enqueue('info', msg, meta);
+        },
+        warn(msg, meta) {
+            enqueue('warn', msg, meta);
+        },
+        error(msg, meta) {
+            enqueue('error', msg, meta);
+        },
+        async flush() {
+            await doFlush();
+        },
+    };
+}
+function enqueue(level, message, metadata) {
+    const config = globalConfig;
+    if (!config)
+        return;
+    const minOrder = effectiveMinLevel(config);
+    if (types_1.LEVEL_ORDER[level] < minOrder)
+        return;
+    const rate = effectiveSampleRate(level, config);
+    if (rate < 1 && Math.random() >= rate)
+        return;
+    const merged = mergeMetadata(config.defaultMetadata, metadata);
+    const event = {
+        id: randomId(),
+        level,
+        message,
+        metadata: Object.keys(merged ?? {}).length ? merged : undefined,
+        timestamp: new Date().toISOString(),
+        env: config.env,
+    };
+    buffer.push(event);
+    const batchSize = getBatchSize(config);
+    if (buffer.length >= batchSize) {
+        setImmediate(() => doFlush().catch(() => { }));
+    }
+}
+/** For tests: get current buffer (read-only). */
+function getBuffer() {
+    return buffer;
+}
+/** For tests: clear buffer and config; stop flush interval. */
+function reset() {
+    if (flushIntervalId) {
+        clearInterval(flushIntervalId);
+        flushIntervalId = null;
+    }
+    buffer.length = 0;
+    globalConfig = null;
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { init, getBuffer, reset, LEVEL_ORDER, LEVELS, type LoggerInstance } from './client';
+export type { LogEvent, LogLevel, LoggerConfig, Transport } from './types';
+export { noopTransport } from './transports/noop';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC5F,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopTransport = exports.LEVELS = exports.LEVEL_ORDER = exports.reset = exports.getBuffer = exports.init = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return client_1.init; } });
+Object.defineProperty(exports, "getBuffer", { enumerable: true, get: function () { return client_1.getBuffer; } });
+Object.defineProperty(exports, "reset", { enumerable: true, get: function () { return client_1.reset; } });
+Object.defineProperty(exports, "LEVEL_ORDER", { enumerable: true, get: function () { return client_1.LEVEL_ORDER; } });
+Object.defineProperty(exports, "LEVELS", { enumerable: true, get: function () { return client_1.LEVELS; } });
+var noop_1 = require("./transports/noop");
+Object.defineProperty(exports, "noopTransport", { enumerable: true, get: function () { return noop_1.noopTransport; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA4F;AAAnF,8FAAA,IAAI,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,+FAAA,KAAK,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,gGAAA,MAAM,OAAA;AAEpD,0CAAkD;AAAzC,qGAAA,aAAa,OAAA"}

package/dist/src/transports/noop.d.ts

@@ -0,0 +1,4 @@
+import type { Transport } from '../types';
+/** Built-in transport that drops all events (no-op). */
+export declare const noopTransport: Transport;
+//# sourceMappingURL=noop.d.ts.map

package/dist/src/transports/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../src/transports/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,aAAa,EAAE,SAK3B,CAAC"}

package/dist/src/transports/noop.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopTransport = void 0;
+/** Built-in transport that drops all events (no-op). */
+exports.noopTransport = {
+    name: 'noop',
+    async send(_events) {
+        // no-op
+    },
+};
+//# sourceMappingURL=noop.js.map

package/dist/src/transports/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../src/transports/noop.ts"],"names":[],"mappings":";;;AAEA,wDAAwD;AAC3C,QAAA,aAAa,GAAc;IACtC,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,IAAI,CAAC,OAAmB;QAC5B,QAAQ;IACV,CAAC;CACF,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Log levels: debug < info < warn < error
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare const LEVEL_ORDER: Record<LogLevel, number>;
+export interface LogEvent {
+    id: string;
+    level: LogLevel;
+    message: string;
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+    env?: string;
+    source?: string;
+}
+/** Transport: receives batches of events on flush. */
+export interface Transport {
+    name: string;
+    send(events: LogEvent[]): Promise<void>;
+}
+export interface LoggerConfig {
+    apiKey: string;
+    /** Minimum level to send; events below are dropped. Default 'debug' */
+    minLevel?: LogLevel;
+    /** Per-environment min level, e.g. { production: 'info' } */
+    minLevelByEnv?: Record<string, LogLevel>;
+    /** Global sampling rate 0–1; 1 = keep all. Default 1 */
+    sampleRate?: number;
+    /** Per-level sampling; error/warn default to 1 if not set */
+    sampleRateByLevel?: Partial<Record<LogLevel, number>>;
+    /** Merged into every log's metadata */
+    defaultMetadata?: Record<string, unknown>;
+    /** Environment name (e.g. 'production'); used for minLevelByEnv */
+    env?: string;
+    /** Max events per batch when flushing. Default 50 */
+    batchSize?: number;
+    /** Max ms before auto-flush even if batch not full. Default 5000; 0 = no interval */
+    flushIntervalMs?: number;
+    /** Transports to send batches to on flush. Default [noopTransport] */
+    transports?: Transport[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/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,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAKhD,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzC,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B"}

package/dist/src/types.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEVEL_ORDER = void 0;
+exports.LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAKa,QAAA,WAAW,GAA6B;IACnD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@logship/logger",
+  "version": "0.1.0",
+  "description": "Logger SDK: send logs to ingestion API with buffer, batch, retry",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test dist/__tests__/*.test.js",
+    "test:run": "npm run build && node --test dist/__tests__/*.test.js",
+    "lint": "echo 'Lint placeholder'"
+  },
+  "files": [
+    "dist/src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "logger",
+    "logging",
+    "sdk"
+  ],
+  "author": "",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}