@clyse/trace 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clyse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# @clyse/trace
+
+Tiny, zero-dependency client for shipping logs to a [Trace](https://github.com/Clyse-Devs/Trace)
+instance. Works in Node 18+ and modern browsers (uses the global `fetch`).
+
+- 📦 Zero dependencies, ESM + CJS + types
+- 🧵 Trace correlation (`withTrace`, `child`)
+- 🪣 Buffered + batched, flushes on interval, size, and process exit / page unload
+- 🛟 Never throws — transport errors go to `onError`, entries are dropped
+
+## Install
+
+```bash
+npm i @clyse/trace
+# or: bun add @clyse/trace
+```
+
+## Usage
+
+```ts
+import { createTrace } from '@clyse/trace';
+
+const trace = createTrace({
+  url: process.env.TRACE_URL!, // e.g. "https://trace.clyse.studio/api" or "http://localhost:4010"
+  key: process.env.TRACE_KEY!, // application API key (trc_…) from Trace settings
+  defaultMeta: { env: process.env.NODE_ENV }
+});
+
+trace.info('server started', { port: 3000 });
+trace.error('payment failed', { order_id: 42 });
+```
+
+The application name is bound to the API key server-side, so you don't send it.
+
+### Trace correlation
+
+Tag every log of one request with the same id — the dashboard groups them in a click.
+
+```ts
+function handler(reqId: string) {
+  const log = trace.withTrace(reqId); // adds meta.trace_id
+  log.info('request received');
+  log.warn('slow query', { ms: 820 });
+}
+```
+
+`child` merges arbitrary meta into every entry:
+
+```ts
+const dbLog = trace.child({ component: 'db' });
+dbLog.debug('pool acquired');
+```
+
+### Flushing
+
+Entries are buffered and flushed automatically (every `flushInterval` ms, when the
+buffer hits `batchSize`, and on exit/unload). Flush manually when you need to:
+
+```ts
+await trace.flush();   // send now
+await trace.close();   // flush and stop the timer (e.g. before a graceful shutdown)
+```
+
+## Options
+
+| Option         | Default  | Description                                                        |
+| -------------- | -------- | ------------------------------------------------------------------ |
+| `url`          | —        | Base URL of the Trace API (with or without a trailing `/ingest`).  |
+| `key`          | —        | Application API key (`trc_…`).                                     |
+| `flushInterval`| `2000`   | Max ms between automatic flushes.                                  |
+| `batchSize`    | `50`     | Flush as soon as the buffer reaches this many entries.             |
+| `maxBuffer`    | `1000`   | Hard cap on buffered entries; oldest dropped beyond it.            |
+| `defaultMeta`  | —        | Meta merged into every entry.                                      |
+| `console`      | `false`  | Also mirror entries to the local console.                          |
+| `onError`      | no-op    | Called on transport errors (never thrown).                        |
+| `fetch`        | global   | Custom fetch (tests, proxies, older runtimes).                    |
+| `flushOnExit`  | `true`   | Flush on process exit / page unload.                              |
+
+## Publishing
+
+Published to npm by the **Publish SDK** GitHub Action. To cut a release:
+
+```bash
+cd packages/trace
+npm version patch          # bumps package.json (use minor/major as needed)
+git commit -am "release sdk vX.Y.Z"
+git tag sdk-vX.Y.Z         # tag MUST match the new package.json version
+git push && git push --tags
+```
+
+The workflow tests, builds, checks the tag matches the version, and runs `npm publish`.
+Requires an `NPM_TOKEN` repository secret (npm **Automation** token for the `@clyse` org).
+The scope must match your npm org name — rename the package if your org isn't `clyse`.
+
+## License
+
+MIT
+

package/dist/index.cjs

@@ -0,0 +1,165 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createTrace: () => createTrace,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var LEVELS = ["debug", "info", "warn", "error"];
+function normalizeBase(url) {
+  const trimmed = url.replace(/\/+$/, "");
+  return trimmed.endsWith("/ingest") ? trimmed : `${trimmed}/ingest`;
+}
+function mergeMeta(a, b) {
+  if (!a && !b) return void 0;
+  const out = { ...a ?? {}, ...b ?? {} };
+  return Object.keys(out).length ? out : void 0;
+}
+var TraceCore = class {
+  endpoint;
+  key;
+  batchSize;
+  maxBuffer;
+  defaultMeta;
+  mirror;
+  onError;
+  fetchImpl;
+  buffer = [];
+  timer = null;
+  flushing = null;
+  closed = false;
+  constructor(opts) {
+    if (!opts.url) throw new Error("@clyse/trace: `url` is required");
+    if (!opts.key) throw new Error("@clyse/trace: `key` is required");
+    this.endpoint = normalizeBase(opts.url);
+    this.key = opts.key;
+    this.batchSize = opts.batchSize ?? 50;
+    this.maxBuffer = opts.maxBuffer ?? 1e3;
+    this.defaultMeta = opts.defaultMeta;
+    this.mirror = opts.console ?? false;
+    this.onError = opts.onError ?? (() => {
+    });
+    const f = opts.fetch ?? globalThis.fetch;
+    if (typeof f !== "function") {
+      throw new Error("@clyse/trace: no fetch available; pass options.fetch on older runtimes");
+    }
+    this.fetchImpl = f.bind(globalThis);
+    const interval = opts.flushInterval ?? 2e3;
+    this.timer = setInterval(() => void this.flush(), interval);
+    this.timer.unref?.();
+    if (opts.flushOnExit ?? true) this.registerExitHooks();
+  }
+  enqueue(level, message, meta) {
+    if (this.closed) return;
+    const lvl = LEVELS.includes(level) ? level : "info";
+    const entry = {
+      level: lvl,
+      message: typeof message === "string" ? message : String(message),
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      meta: mergeMeta(this.defaultMeta, meta)
+    };
+    if (this.mirror) this.mirrorToConsole(entry);
+    this.buffer.push(entry);
+    if (this.buffer.length > this.maxBuffer) {
+      this.buffer.splice(0, this.buffer.length - this.maxBuffer);
+    }
+    if (this.buffer.length >= this.batchSize) void this.flush();
+  }
+  async flush() {
+    if (this.flushing) return this.flushing;
+    if (this.buffer.length === 0) return;
+    const batch = this.buffer;
+    this.buffer = [];
+    this.flushing = this.send(batch).finally(() => {
+      this.flushing = null;
+    });
+    return this.flushing;
+  }
+  async close() {
+    this.closed = true;
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    await this.flush();
+  }
+  async send(batch) {
+    try {
+      const res = await this.fetchImpl(this.endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.key}`
+        },
+        body: JSON.stringify({ entries: batch }),
+        keepalive: true
+      });
+      if (!res.ok) {
+        throw new Error(`@clyse/trace: ingest failed with status ${res.status}`);
+      }
+    } catch (error) {
+      this.onError(error);
+    }
+  }
+  mirrorToConsole(entry) {
+    const fn = entry.level === "error" ? console.error : entry.level === "warn" ? console.warn : entry.level === "debug" ? console.debug : console.info;
+    fn(`[trace:${entry.level}] ${entry.message}`, entry.meta ?? "");
+  }
+  registerExitHooks() {
+    const proc = globalThis.process;
+    if (proc?.on) {
+      proc.on("beforeExit", () => void this.flush());
+      proc.on("SIGTERM", () => void this.flush());
+      proc.on("SIGINT", () => void this.flush());
+    }
+    const w = globalThis;
+    if (typeof w.addEventListener === "function") {
+      w.addEventListener("beforeunload", () => void this.flush());
+      w.addEventListener("visibilitychange", () => {
+        if (w.document?.visibilityState === "hidden") void this.flush();
+      });
+    }
+  }
+};
+function makeLogger(core, boundMeta) {
+  const log = (level, message, meta) => core.enqueue(level, message, mergeMeta(boundMeta, meta));
+  return {
+    debug: (m, meta) => log("debug", m, meta),
+    info: (m, meta) => log("info", m, meta),
+    warn: (m, meta) => log("warn", m, meta),
+    error: (m, meta) => log("error", m, meta),
+    log,
+    withTrace: (traceId) => makeLogger(core, mergeMeta(boundMeta, { trace_id: traceId })),
+    child: (meta) => makeLogger(core, mergeMeta(boundMeta, meta)),
+    flush: () => core.flush(),
+    close: () => core.close()
+  };
+}
+function createTrace(options) {
+  return makeLogger(new TraceCore(options));
+}
+var index_default = createTrace;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createTrace
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @clyse/trace — tiny client for shipping logs to a Trace instance.\n *\n * Zero dependencies, works in Node 18+ and modern browsers (uses global fetch).\n * Logging never throws: transport failures are routed to `onError` and dropped.\n */\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type Meta = Record<string, unknown>;\n\nexport interface TraceOptions {\n\t/** Base URL of the Trace API, e.g. \"https://trace.clyse.studio/api\" or \"http://localhost:4010\". */\n\turl: string;\n\t/** Application API key created in Trace settings (trc_…). */\n\tkey: string;\n\t/** Flush the buffer at most every N ms. Default 2000. */\n\tflushInterval?: number;\n\t/** Flush as soon as the buffer reaches this many entries. Default 50. */\n\tbatchSize?: number;\n\t/** Hard cap on buffered entries; oldest are dropped beyond it. Default 1000. */\n\tmaxBuffer?: number;\n\t/** Meta merged into every entry (e.g. { env, service_version }). */\n\tdefaultMeta?: Meta;\n\t/** Also mirror entries to the local console. Default false. */\n\tconsole?: boolean;\n\t/** Called on transport errors (entries are dropped, never thrown). */\n\tonError?: (error: unknown) => void;\n\t/** Inject a custom fetch (tests, proxies). Defaults to global fetch. */\n\tfetch?: typeof fetch;\n\t/** Flush automatically on process exit / page unload. Default true. */\n\tflushOnExit?: boolean;\n}\n\nexport interface Trace {\n\tdebug(message: string, meta?: Meta): void;\n\tinfo(message: string, meta?: Meta): void;\n\twarn(message: string, meta?: Meta): void;\n\terror(message: string, meta?: Meta): void;\n\tlog(level: TraceLevel, message: string, meta?: Meta): void;\n\t/** Returns a logger that tags every entry with this trace id (correlation). */\n\twithTrace(traceId: string): Trace;\n\t/** Returns a logger with extra meta merged into every entry. */\n\tchild(meta: Meta): Trace;\n\t/** Send any buffered entries now. */\n\tflush(): Promise<void>;\n\t/** Flush and stop the background timer. */\n\tclose(): Promise<void>;\n}\n\ninterface Entry {\n\tlevel: TraceLevel;\n\tmessage: string;\n\tts: string;\n\tmeta?: Meta;\n}\n\nconst LEVELS: TraceLevel[] = ['debug', 'info', 'warn', 'error'];\n\nfunction normalizeBase(url: string): string {\n\tconst trimmed = url.replace(/\\/+$/, '');\n\treturn trimmed.endsWith('/ingest') ? trimmed : `${trimmed}/ingest`;\n}\n\nfunction mergeMeta(a?: Meta, b?: Meta): Meta | undefined {\n\tif (!a && !b) return undefined;\n\tconst out = { ...(a ?? {}), ...(b ?? {}) };\n\treturn Object.keys(out).length ? out : undefined;\n}\n\nclass TraceCore {\n\tprivate readonly endpoint: string;\n\tprivate readonly key: string;\n\tprivate readonly batchSize: number;\n\tprivate readonly maxBuffer: number;\n\tprivate readonly defaultMeta?: Meta;\n\tprivate readonly mirror: boolean;\n\tprivate readonly onError: (error: unknown) => void;\n\tprivate readonly fetchImpl: typeof fetch;\n\n\tprivate buffer: Entry[] = [];\n\tprivate timer: ReturnType<typeof setInterval> | null = null;\n\tprivate flushing: Promise<void> | null = null;\n\tprivate closed = false;\n\n\tconstructor(opts: TraceOptions) {\n\t\tif (!opts.url) throw new Error('@clyse/trace: `url` is required');\n\t\tif (!opts.key) throw new Error('@clyse/trace: `key` is required');\n\n\t\tthis.endpoint = normalizeBase(opts.url);\n\t\tthis.key = opts.key;\n\t\tthis.batchSize = opts.batchSize ?? 50;\n\t\tthis.maxBuffer = opts.maxBuffer ?? 1000;\n\t\tthis.defaultMeta = opts.defaultMeta;\n\t\tthis.mirror = opts.console ?? false;\n\t\tthis.onError = opts.onError ?? (() => {});\n\n\t\tconst f = opts.fetch ?? globalThis.fetch;\n\t\tif (typeof f !== 'function') {\n\t\t\tthrow new Error('@clyse/trace: no fetch available; pass options.fetch on older runtimes');\n\t\t}\n\t\tthis.fetchImpl = f.bind(globalThis);\n\n\t\tconst interval = opts.flushInterval ?? 2000;\n\t\tthis.timer = setInterval(() => void this.flush(), interval);\n\t\t// Don't keep a Node process alive just for the flush timer.\n\t\t(this.timer as { unref?: () => void }).unref?.();\n\n\t\tif (opts.flushOnExit ?? true) this.registerExitHooks();\n\t}\n\n\tenqueue(level: TraceLevel, message: string, meta?: Meta): void {\n\t\tif (this.closed) return;\n\t\tconst lvl = LEVELS.includes(level) ? level : 'info';\n\t\tconst entry: Entry = {\n\t\t\tlevel: lvl,\n\t\t\tmessage: typeof message === 'string' ? message : String(message),\n\t\t\tts: new Date().toISOString(),\n\t\t\tmeta: mergeMeta(this.defaultMeta, meta)\n\t\t};\n\n\t\tif (this.mirror) this.mirrorToConsole(entry);\n\n\t\tthis.buffer.push(entry);\n\t\tif (this.buffer.length > this.maxBuffer) {\n\t\t\tthis.buffer.splice(0, this.buffer.length - this.maxBuffer);\n\t\t}\n\t\tif (this.buffer.length >= this.batchSize) void this.flush();\n\t}\n\n\tasync flush(): Promise<void> {\n\t\tif (this.flushing) return this.flushing;\n\t\tif (this.buffer.length === 0) return;\n\n\t\tconst batch = this.buffer;\n\t\tthis.buffer = [];\n\t\tthis.flushing = this.send(batch).finally(() => {\n\t\t\tthis.flushing = null;\n\t\t});\n\t\treturn this.flushing;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.closed = true;\n\t\tif (this.timer) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tawait this.flush();\n\t}\n\n\tprivate async send(batch: Entry[]): Promise<void> {\n\t\ttry {\n\t\t\tconst res = await this.fetchImpl(this.endpoint, {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: {\n\t\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t\tAuthorization: `Bearer ${this.key}`\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({ entries: batch }),\n\t\t\t\tkeepalive: true\n\t\t\t});\n\t\t\tif (!res.ok) {\n\t\t\t\tthrow new Error(`@clyse/trace: ingest failed with status ${res.status}`);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthis.onError(error);\n\t\t}\n\t}\n\n\tprivate mirrorToConsole(entry: Entry): void {\n\t\tconst fn =\n\t\t\tentry.level === 'error'\n\t\t\t\t? console.error\n\t\t\t\t: entry.level === 'warn'\n\t\t\t\t\t? console.warn\n\t\t\t\t\t: entry.level === 'debug'\n\t\t\t\t\t\t? console.debug\n\t\t\t\t\t\t: console.info;\n\t\tfn(`[trace:${entry.level}] ${entry.message}`, entry.meta ?? '');\n\t}\n\n\tprivate registerExitHooks(): void {\n\t\tconst proc = (globalThis as { process?: { on?: (event: string, cb: () => void) => void } }).process;\n\t\tif (proc?.on) {\n\t\t\tproc.on('beforeExit', () => void this.flush());\n\t\t\tproc.on('SIGTERM', () => void this.flush());\n\t\t\tproc.on('SIGINT', () => void this.flush());\n\t\t}\n\t\tconst w = globalThis as typeof globalThis & {\n\t\t\taddEventListener?: (type: string, cb: () => void) => void;\n\t\t\tdocument?: { visibilityState?: string };\n\t\t};\n\t\tif (typeof w.addEventListener === 'function') {\n\t\t\tw.addEventListener('beforeunload', () => void this.flush());\n\t\t\tw.addEventListener('visibilitychange', () => {\n\t\t\t\tif (w.document?.visibilityState === 'hidden') void this.flush();\n\t\t\t});\n\t\t}\n\t}\n}\n\nfunction makeLogger(core: TraceCore, boundMeta?: Meta): Trace {\n\tconst log = (level: TraceLevel, message: string, meta?: Meta) =>\n\t\tcore.enqueue(level, message, mergeMeta(boundMeta, meta));\n\treturn {\n\t\tdebug: (m, meta) => log('debug', m, meta),\n\t\tinfo: (m, meta) => log('info', m, meta),\n\t\twarn: (m, meta) => log('warn', m, meta),\n\t\terror: (m, meta) => log('error', m, meta),\n\t\tlog,\n\t\twithTrace: (traceId) => makeLogger(core, mergeMeta(boundMeta, { trace_id: traceId })),\n\t\tchild: (meta) => makeLogger(core, mergeMeta(boundMeta, meta)),\n\t\tflush: () => core.flush(),\n\t\tclose: () => core.close()\n\t};\n}\n\n/** Create a Trace logger bound to an application key. */\nexport function createTrace(options: TraceOptions): Trace {\n\treturn makeLogger(new TraceCore(options));\n}\n\nexport default createTrace;\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+/**
+ * @clyse/trace — tiny client for shipping logs to a Trace instance.
+ *
+ * Zero dependencies, works in Node 18+ and modern browsers (uses global fetch).
+ * Logging never throws: transport failures are routed to `onError` and dropped.
+ */
+type TraceLevel = 'debug' | 'info' | 'warn' | 'error';
+type Meta = Record<string, unknown>;
+interface TraceOptions {
+    /** Base URL of the Trace API, e.g. "https://trace.clyse.studio/api" or "http://localhost:4010". */
+    url: string;
+    /** Application API key created in Trace settings (trc_…). */
+    key: string;
+    /** Flush the buffer at most every N ms. Default 2000. */
+    flushInterval?: number;
+    /** Flush as soon as the buffer reaches this many entries. Default 50. */
+    batchSize?: number;
+    /** Hard cap on buffered entries; oldest are dropped beyond it. Default 1000. */
+    maxBuffer?: number;
+    /** Meta merged into every entry (e.g. { env, service_version }). */
+    defaultMeta?: Meta;
+    /** Also mirror entries to the local console. Default false. */
+    console?: boolean;
+    /** Called on transport errors (entries are dropped, never thrown). */
+    onError?: (error: unknown) => void;
+    /** Inject a custom fetch (tests, proxies). Defaults to global fetch. */
+    fetch?: typeof fetch;
+    /** Flush automatically on process exit / page unload. Default true. */
+    flushOnExit?: boolean;
+}
+interface Trace {
+    debug(message: string, meta?: Meta): void;
+    info(message: string, meta?: Meta): void;
+    warn(message: string, meta?: Meta): void;
+    error(message: string, meta?: Meta): void;
+    log(level: TraceLevel, message: string, meta?: Meta): void;
+    /** Returns a logger that tags every entry with this trace id (correlation). */
+    withTrace(traceId: string): Trace;
+    /** Returns a logger with extra meta merged into every entry. */
+    child(meta: Meta): Trace;
+    /** Send any buffered entries now. */
+    flush(): Promise<void>;
+    /** Flush and stop the background timer. */
+    close(): Promise<void>;
+}
+/** Create a Trace logger bound to an application key. */
+declare function createTrace(options: TraceOptions): Trace;
+
+export { type Meta, type Trace, type TraceLevel, type TraceOptions, createTrace, createTrace as default };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @clyse/trace — tiny client for shipping logs to a Trace instance.
+ *
+ * Zero dependencies, works in Node 18+ and modern browsers (uses global fetch).
+ * Logging never throws: transport failures are routed to `onError` and dropped.
+ */
+type TraceLevel = 'debug' | 'info' | 'warn' | 'error';
+type Meta = Record<string, unknown>;
+interface TraceOptions {
+    /** Base URL of the Trace API, e.g. "https://trace.clyse.studio/api" or "http://localhost:4010". */
+    url: string;
+    /** Application API key created in Trace settings (trc_…). */
+    key: string;
+    /** Flush the buffer at most every N ms. Default 2000. */
+    flushInterval?: number;
+    /** Flush as soon as the buffer reaches this many entries. Default 50. */
+    batchSize?: number;
+    /** Hard cap on buffered entries; oldest are dropped beyond it. Default 1000. */
+    maxBuffer?: number;
+    /** Meta merged into every entry (e.g. { env, service_version }). */
+    defaultMeta?: Meta;
+    /** Also mirror entries to the local console. Default false. */
+    console?: boolean;
+    /** Called on transport errors (entries are dropped, never thrown). */
+    onError?: (error: unknown) => void;
+    /** Inject a custom fetch (tests, proxies). Defaults to global fetch. */
+    fetch?: typeof fetch;
+    /** Flush automatically on process exit / page unload. Default true. */
+    flushOnExit?: boolean;
+}
+interface Trace {
+    debug(message: string, meta?: Meta): void;
+    info(message: string, meta?: Meta): void;
+    warn(message: string, meta?: Meta): void;
+    error(message: string, meta?: Meta): void;
+    log(level: TraceLevel, message: string, meta?: Meta): void;
+    /** Returns a logger that tags every entry with this trace id (correlation). */
+    withTrace(traceId: string): Trace;
+    /** Returns a logger with extra meta merged into every entry. */
+    child(meta: Meta): Trace;
+    /** Send any buffered entries now. */
+    flush(): Promise<void>;
+    /** Flush and stop the background timer. */
+    close(): Promise<void>;
+}
+/** Create a Trace logger bound to an application key. */
+declare function createTrace(options: TraceOptions): Trace;
+
+export { type Meta, type Trace, type TraceLevel, type TraceOptions, createTrace, createTrace as default };

package/dist/index.js

@@ -0,0 +1,140 @@
+// src/index.ts
+var LEVELS = ["debug", "info", "warn", "error"];
+function normalizeBase(url) {
+  const trimmed = url.replace(/\/+$/, "");
+  return trimmed.endsWith("/ingest") ? trimmed : `${trimmed}/ingest`;
+}
+function mergeMeta(a, b) {
+  if (!a && !b) return void 0;
+  const out = { ...a ?? {}, ...b ?? {} };
+  return Object.keys(out).length ? out : void 0;
+}
+var TraceCore = class {
+  endpoint;
+  key;
+  batchSize;
+  maxBuffer;
+  defaultMeta;
+  mirror;
+  onError;
+  fetchImpl;
+  buffer = [];
+  timer = null;
+  flushing = null;
+  closed = false;
+  constructor(opts) {
+    if (!opts.url) throw new Error("@clyse/trace: `url` is required");
+    if (!opts.key) throw new Error("@clyse/trace: `key` is required");
+    this.endpoint = normalizeBase(opts.url);
+    this.key = opts.key;
+    this.batchSize = opts.batchSize ?? 50;
+    this.maxBuffer = opts.maxBuffer ?? 1e3;
+    this.defaultMeta = opts.defaultMeta;
+    this.mirror = opts.console ?? false;
+    this.onError = opts.onError ?? (() => {
+    });
+    const f = opts.fetch ?? globalThis.fetch;
+    if (typeof f !== "function") {
+      throw new Error("@clyse/trace: no fetch available; pass options.fetch on older runtimes");
+    }
+    this.fetchImpl = f.bind(globalThis);
+    const interval = opts.flushInterval ?? 2e3;
+    this.timer = setInterval(() => void this.flush(), interval);
+    this.timer.unref?.();
+    if (opts.flushOnExit ?? true) this.registerExitHooks();
+  }
+  enqueue(level, message, meta) {
+    if (this.closed) return;
+    const lvl = LEVELS.includes(level) ? level : "info";
+    const entry = {
+      level: lvl,
+      message: typeof message === "string" ? message : String(message),
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      meta: mergeMeta(this.defaultMeta, meta)
+    };
+    if (this.mirror) this.mirrorToConsole(entry);
+    this.buffer.push(entry);
+    if (this.buffer.length > this.maxBuffer) {
+      this.buffer.splice(0, this.buffer.length - this.maxBuffer);
+    }
+    if (this.buffer.length >= this.batchSize) void this.flush();
+  }
+  async flush() {
+    if (this.flushing) return this.flushing;
+    if (this.buffer.length === 0) return;
+    const batch = this.buffer;
+    this.buffer = [];
+    this.flushing = this.send(batch).finally(() => {
+      this.flushing = null;
+    });
+    return this.flushing;
+  }
+  async close() {
+    this.closed = true;
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    await this.flush();
+  }
+  async send(batch) {
+    try {
+      const res = await this.fetchImpl(this.endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.key}`
+        },
+        body: JSON.stringify({ entries: batch }),
+        keepalive: true
+      });
+      if (!res.ok) {
+        throw new Error(`@clyse/trace: ingest failed with status ${res.status}`);
+      }
+    } catch (error) {
+      this.onError(error);
+    }
+  }
+  mirrorToConsole(entry) {
+    const fn = entry.level === "error" ? console.error : entry.level === "warn" ? console.warn : entry.level === "debug" ? console.debug : console.info;
+    fn(`[trace:${entry.level}] ${entry.message}`, entry.meta ?? "");
+  }
+  registerExitHooks() {
+    const proc = globalThis.process;
+    if (proc?.on) {
+      proc.on("beforeExit", () => void this.flush());
+      proc.on("SIGTERM", () => void this.flush());
+      proc.on("SIGINT", () => void this.flush());
+    }
+    const w = globalThis;
+    if (typeof w.addEventListener === "function") {
+      w.addEventListener("beforeunload", () => void this.flush());
+      w.addEventListener("visibilitychange", () => {
+        if (w.document?.visibilityState === "hidden") void this.flush();
+      });
+    }
+  }
+};
+function makeLogger(core, boundMeta) {
+  const log = (level, message, meta) => core.enqueue(level, message, mergeMeta(boundMeta, meta));
+  return {
+    debug: (m, meta) => log("debug", m, meta),
+    info: (m, meta) => log("info", m, meta),
+    warn: (m, meta) => log("warn", m, meta),
+    error: (m, meta) => log("error", m, meta),
+    log,
+    withTrace: (traceId) => makeLogger(core, mergeMeta(boundMeta, { trace_id: traceId })),
+    child: (meta) => makeLogger(core, mergeMeta(boundMeta, meta)),
+    flush: () => core.flush(),
+    close: () => core.close()
+  };
+}
+function createTrace(options) {
+  return makeLogger(new TraceCore(options));
+}
+var index_default = createTrace;
+export {
+  createTrace,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @clyse/trace — tiny client for shipping logs to a Trace instance.\n *\n * Zero dependencies, works in Node 18+ and modern browsers (uses global fetch).\n * Logging never throws: transport failures are routed to `onError` and dropped.\n */\n\nexport type TraceLevel = 'debug' | 'info' | 'warn' | 'error';\nexport type Meta = Record<string, unknown>;\n\nexport interface TraceOptions {\n\t/** Base URL of the Trace API, e.g. \"https://trace.clyse.studio/api\" or \"http://localhost:4010\". */\n\turl: string;\n\t/** Application API key created in Trace settings (trc_…). */\n\tkey: string;\n\t/** Flush the buffer at most every N ms. Default 2000. */\n\tflushInterval?: number;\n\t/** Flush as soon as the buffer reaches this many entries. Default 50. */\n\tbatchSize?: number;\n\t/** Hard cap on buffered entries; oldest are dropped beyond it. Default 1000. */\n\tmaxBuffer?: number;\n\t/** Meta merged into every entry (e.g. { env, service_version }). */\n\tdefaultMeta?: Meta;\n\t/** Also mirror entries to the local console. Default false. */\n\tconsole?: boolean;\n\t/** Called on transport errors (entries are dropped, never thrown). */\n\tonError?: (error: unknown) => void;\n\t/** Inject a custom fetch (tests, proxies). Defaults to global fetch. */\n\tfetch?: typeof fetch;\n\t/** Flush automatically on process exit / page unload. Default true. */\n\tflushOnExit?: boolean;\n}\n\nexport interface Trace {\n\tdebug(message: string, meta?: Meta): void;\n\tinfo(message: string, meta?: Meta): void;\n\twarn(message: string, meta?: Meta): void;\n\terror(message: string, meta?: Meta): void;\n\tlog(level: TraceLevel, message: string, meta?: Meta): void;\n\t/** Returns a logger that tags every entry with this trace id (correlation). */\n\twithTrace(traceId: string): Trace;\n\t/** Returns a logger with extra meta merged into every entry. */\n\tchild(meta: Meta): Trace;\n\t/** Send any buffered entries now. */\n\tflush(): Promise<void>;\n\t/** Flush and stop the background timer. */\n\tclose(): Promise<void>;\n}\n\ninterface Entry {\n\tlevel: TraceLevel;\n\tmessage: string;\n\tts: string;\n\tmeta?: Meta;\n}\n\nconst LEVELS: TraceLevel[] = ['debug', 'info', 'warn', 'error'];\n\nfunction normalizeBase(url: string): string {\n\tconst trimmed = url.replace(/\\/+$/, '');\n\treturn trimmed.endsWith('/ingest') ? trimmed : `${trimmed}/ingest`;\n}\n\nfunction mergeMeta(a?: Meta, b?: Meta): Meta | undefined {\n\tif (!a && !b) return undefined;\n\tconst out = { ...(a ?? {}), ...(b ?? {}) };\n\treturn Object.keys(out).length ? out : undefined;\n}\n\nclass TraceCore {\n\tprivate readonly endpoint: string;\n\tprivate readonly key: string;\n\tprivate readonly batchSize: number;\n\tprivate readonly maxBuffer: number;\n\tprivate readonly defaultMeta?: Meta;\n\tprivate readonly mirror: boolean;\n\tprivate readonly onError: (error: unknown) => void;\n\tprivate readonly fetchImpl: typeof fetch;\n\n\tprivate buffer: Entry[] = [];\n\tprivate timer: ReturnType<typeof setInterval> | null = null;\n\tprivate flushing: Promise<void> | null = null;\n\tprivate closed = false;\n\n\tconstructor(opts: TraceOptions) {\n\t\tif (!opts.url) throw new Error('@clyse/trace: `url` is required');\n\t\tif (!opts.key) throw new Error('@clyse/trace: `key` is required');\n\n\t\tthis.endpoint = normalizeBase(opts.url);\n\t\tthis.key = opts.key;\n\t\tthis.batchSize = opts.batchSize ?? 50;\n\t\tthis.maxBuffer = opts.maxBuffer ?? 1000;\n\t\tthis.defaultMeta = opts.defaultMeta;\n\t\tthis.mirror = opts.console ?? false;\n\t\tthis.onError = opts.onError ?? (() => {});\n\n\t\tconst f = opts.fetch ?? globalThis.fetch;\n\t\tif (typeof f !== 'function') {\n\t\t\tthrow new Error('@clyse/trace: no fetch available; pass options.fetch on older runtimes');\n\t\t}\n\t\tthis.fetchImpl = f.bind(globalThis);\n\n\t\tconst interval = opts.flushInterval ?? 2000;\n\t\tthis.timer = setInterval(() => void this.flush(), interval);\n\t\t// Don't keep a Node process alive just for the flush timer.\n\t\t(this.timer as { unref?: () => void }).unref?.();\n\n\t\tif (opts.flushOnExit ?? true) this.registerExitHooks();\n\t}\n\n\tenqueue(level: TraceLevel, message: string, meta?: Meta): void {\n\t\tif (this.closed) return;\n\t\tconst lvl = LEVELS.includes(level) ? level : 'info';\n\t\tconst entry: Entry = {\n\t\t\tlevel: lvl,\n\t\t\tmessage: typeof message === 'string' ? message : String(message),\n\t\t\tts: new Date().toISOString(),\n\t\t\tmeta: mergeMeta(this.defaultMeta, meta)\n\t\t};\n\n\t\tif (this.mirror) this.mirrorToConsole(entry);\n\n\t\tthis.buffer.push(entry);\n\t\tif (this.buffer.length > this.maxBuffer) {\n\t\t\tthis.buffer.splice(0, this.buffer.length - this.maxBuffer);\n\t\t}\n\t\tif (this.buffer.length >= this.batchSize) void this.flush();\n\t}\n\n\tasync flush(): Promise<void> {\n\t\tif (this.flushing) return this.flushing;\n\t\tif (this.buffer.length === 0) return;\n\n\t\tconst batch = this.buffer;\n\t\tthis.buffer = [];\n\t\tthis.flushing = this.send(batch).finally(() => {\n\t\t\tthis.flushing = null;\n\t\t});\n\t\treturn this.flushing;\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.closed = true;\n\t\tif (this.timer) {\n\t\t\tclearInterval(this.timer);\n\t\t\tthis.timer = null;\n\t\t}\n\t\tawait this.flush();\n\t}\n\n\tprivate async send(batch: Entry[]): Promise<void> {\n\t\ttry {\n\t\t\tconst res = await this.fetchImpl(this.endpoint, {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: {\n\t\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t\tAuthorization: `Bearer ${this.key}`\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({ entries: batch }),\n\t\t\t\tkeepalive: true\n\t\t\t});\n\t\t\tif (!res.ok) {\n\t\t\t\tthrow new Error(`@clyse/trace: ingest failed with status ${res.status}`);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tthis.onError(error);\n\t\t}\n\t}\n\n\tprivate mirrorToConsole(entry: Entry): void {\n\t\tconst fn =\n\t\t\tentry.level === 'error'\n\t\t\t\t? console.error\n\t\t\t\t: entry.level === 'warn'\n\t\t\t\t\t? console.warn\n\t\t\t\t\t: entry.level === 'debug'\n\t\t\t\t\t\t? console.debug\n\t\t\t\t\t\t: console.info;\n\t\tfn(`[trace:${entry.level}] ${entry.message}`, entry.meta ?? '');\n\t}\n\n\tprivate registerExitHooks(): void {\n\t\tconst proc = (globalThis as { process?: { on?: (event: string, cb: () => void) => void } }).process;\n\t\tif (proc?.on) {\n\t\t\tproc.on('beforeExit', () => void this.flush());\n\t\t\tproc.on('SIGTERM', () => void this.flush());\n\t\t\tproc.on('SIGINT', () => void this.flush());\n\t\t}\n\t\tconst w = globalThis as typeof globalThis & {\n\t\t\taddEventListener?: (type: string, cb: () => void) => void;\n\t\t\tdocument?: { visibilityState?: string };\n\t\t};\n\t\tif (typeof w.addEventListener === 'function') {\n\t\t\tw.addEventListener('beforeunload', () => void this.flush());\n\t\t\tw.addEventListener('visibilitychange', () => {\n\t\t\t\tif (w.document?.visibilityState === 'hidden') void this.flush();\n\t\t\t});\n\t\t}\n\t}\n}\n\nfunction makeLogger(core: TraceCore, boundMeta?: Meta): Trace {\n\tconst log = (level: TraceLevel, message: string, meta?: Meta) =>\n\t\tcore.enqueue(level, message, mergeMeta(boundMeta, meta));\n\treturn {\n\t\tdebug: (m, meta) => log('debug', m, meta),\n\t\tinfo: (m, meta) => log('info', m, meta),\n\t\twarn: (m, meta) => log('warn', m, meta),\n\t\terror: (m, meta) => log('error', m, meta),\n\t\tlog,\n\t\twithTrace: (traceId) => makeLogger(core, mergeMeta(boundMeta, { trace_id: traceId })),\n\t\tchild: (meta) => makeLogger(core, mergeMeta(boundMeta, meta)),\n\t\tflush: () => core.flush(),\n\t\tclose: () => core.close()\n\t};\n}\n\n/** Create a Trace logger bound to an application key. */\nexport function createTrace(options: TraceOptions): Trace {\n\treturn makeLogger(new TraceCore(options));\n}\n\nexport default createTrace;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@clyse/trace",
+	"version": "0.1.0",
+	"description": "Tiny zero-dependency client for shipping logs to a Trace instance.",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"sideEffects": false,
+	"scripts": {
+		"build": "tsup",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"trace",
+		"logging",
+		"logs",
+		"observability",
+		"clyse"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Clyse-Devs/Trace.git",
+		"directory": "packages/trace"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"devDependencies": {
+		"tsup": "^8.5.0",
+		"typescript": "^5.9.3"
+	}
+}