@tacko/telemetry-core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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/dist/index.d.ts

@@ -0,0 +1,22 @@
+export type TelemetryConfig = {
+    ingestUrl: string;
+    app: string;
+    platform?: string;
+    environment?: string;
+    release?: string;
+    /** Flush interval in ms. Default 5000. Set 0 to disable batching. */
+    batchInterval?: number;
+    /** Max queue size before flush. Default 10. */
+    batchSize?: number;
+};
+export declare function init(c: TelemetryConfig): void;
+export declare function identify(id: string | null): void;
+export declare function trackEvent(name: string, properties?: Record<string, unknown>): void;
+export declare function trackError(error: Error | {
+    message: string;
+    stack?: string;
+}, context?: Record<string, unknown>): void;
+export declare function screen(name: string): void;
+export declare function getUserId(): string | null;
+export declare function getConfigOrNull(): TelemetryConfig | null;
+//# 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,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAiBF,wBAAgB,IAAI,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAQ7C;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEhD;AAwDD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAqBN;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAUN;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,eAAe,IAAI,eAAe,GAAG,IAAI,CAExD"}

package/dist/index.js

@@ -0,0 +1,116 @@
+let config = null;
+let userId = null;
+const DEFAULT_BATCH_INTERVAL = 5000;
+const DEFAULT_BATCH_SIZE = 10;
+const eventQueue = [];
+let flushTimer = null;
+export function init(c) {
+    config = { ...c };
+    const interval = c.batchInterval ?? DEFAULT_BATCH_INTERVAL;
+    if (interval > 0 && typeof setInterval !== "undefined") {
+        flushTimer = setInterval(flushEvents, interval);
+        const t = flushTimer;
+        if (typeof t.unref === "function")
+            t.unref();
+    }
+}
+export function identify(id) {
+    userId = id;
+}
+function getConfig() {
+    if (!config)
+        throw new Error("telemetry-core: init() must be called first");
+    return config;
+}
+function ensureUrl(url) {
+    const base = getConfig().ingestUrl.replace(/\/$/, "");
+    return `${base}${url}`;
+}
+async function send(path, body) {
+    const cfg = getConfig();
+    try {
+        const res = await fetch(ensureUrl(path), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                ...body,
+                app: cfg.app,
+                platform: cfg.platform ?? undefined,
+                environment: cfg.environment ?? undefined,
+                release: cfg.release ?? undefined,
+            }),
+        });
+        if (!res.ok) {
+            console.warn("[telemetry] ingest failed:", res.status, await res.text());
+        }
+    }
+    catch (e) {
+        console.warn("[telemetry] send error:", e);
+    }
+}
+function flushEvents() {
+    const cfg = getConfigOrNull();
+    if (!cfg || eventQueue.length === 0)
+        return;
+    const batch = eventQueue.splice(0, eventQueue.length);
+    const base = cfg.ingestUrl.replace(/\/$/, "");
+    const events = batch.map((e) => ({
+        app: cfg.app,
+        platform: cfg.platform,
+        environment: cfg.environment,
+        release: cfg.release,
+        name: e.name,
+        user_id: e.user_id ?? undefined,
+        session_id: e.session_id,
+        properties: e.properties,
+    }));
+    fetch(`${base}/ingest/batch`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ events }),
+    }).catch((e) => console.warn("[telemetry] batch send error:", e));
+}
+export function trackEvent(name, properties) {
+    const cfg = getConfigOrNull();
+    const interval = cfg?.batchInterval ?? DEFAULT_BATCH_INTERVAL;
+    const batchSize = cfg?.batchSize ?? DEFAULT_BATCH_SIZE;
+    const item = {
+        name,
+        user_id: userId,
+        session_id: undefined,
+        properties: properties ?? undefined,
+    };
+    if (interval > 0 && typeof setInterval !== "undefined") {
+        eventQueue.push(item);
+        if (eventQueue.length >= batchSize)
+            flushEvents();
+    }
+    else {
+        send("/ingest/event", {
+            name: item.name,
+            user_id: item.user_id ?? undefined,
+            session_id: item.session_id,
+            properties: item.properties,
+        }).catch(() => { });
+    }
+}
+export function trackError(error, context) {
+    const message = error instanceof Error ? error.message : error.message;
+    const stack = error instanceof Error ? error.stack : error.stack;
+    send("/ingest/error", {
+        message,
+        stack: stack ?? undefined,
+        context: context ?? undefined,
+        user_id: userId ?? undefined,
+        session_id: undefined,
+    }).catch(() => { });
+}
+export function screen(name) {
+    trackEvent("$screen", { name });
+}
+export function getUserId() {
+    return userId;
+}
+export function getConfigOrNull() {
+    return config;
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@tacko/telemetry-core",
+  "version": "1.0.0",
+  "description": "Lightweight telemetry client: events, errors, sessions. Framework-agnostic core.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unjica/telemetry-tracker.git",
+    "directory": "packages/telemetry-core"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "telemetry",
+    "analytics",
+    "events",
+    "errors",
+    "tracking"
+  ],
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}