@tracewayapp/core 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# @tracewayapp/core
+
+Shared types and utilities for all Traceway JavaScript SDKs. Zero runtime dependencies.
+
+## Types
+
+| Type | Description |
+|------|-------------|
+| `ExceptionStackTrace` | Exception/message record matching the Traceway protocol |
+| `MetricRecord` | Metric data point (`name`, `value`, `recordedAt`) |
+| `Span` | Sub-operation span within a trace |
+| `Trace` | Endpoint or task trace |
+| `CollectionFrame` | Batch of stack traces, metrics, and traces |
+| `ReportRequest` | Top-level request payload sent to `/api/report` |
+| `TracewayOptions` | Configuration options for SDK initialization |
+
+## Utilities
+
+| Function | Description |
+|----------|-------------|
+| `generateUUID()` | Generate a UUID v4 string |
+| `parseConnectionString(str)` | Split `{token}@{apiUrl}` into `{ token, apiUrl }` |
+| `nowISO()` | Current time as ISO 8601 string |
+| `msToNanoseconds(ms)` | Convert milliseconds to nanoseconds (integer) |
+
+## Constants
+
+| Constant | Value |
+|----------|-------|
+| `METRIC_MEM_USED` | `"mem.used"` |
+| `METRIC_MEM_TOTAL` | `"mem.total"` |
+| `METRIC_CPU_USED_PCNT` | `"cpu.used_pcnt"` |

package/dist/index.d.mts

@@ -0,0 +1,67 @@
+interface ExceptionStackTrace {
+    traceId: string | null;
+    isTask?: boolean;
+    stackTrace: string;
+    recordedAt: string;
+    attributes?: Record<string, string>;
+    isMessage: boolean;
+}
+interface MetricRecord {
+    name: string;
+    value: number;
+    recordedAt: string;
+}
+interface Span {
+    id: string;
+    name: string;
+    startTime: string;
+    duration: number;
+}
+interface Trace {
+    id: string;
+    endpoint: string;
+    duration: number;
+    recordedAt: string;
+    statusCode: number;
+    bodySize: number;
+    clientIP: string;
+    attributes?: Record<string, string>;
+    spans?: Span[];
+    isTask?: boolean;
+}
+interface CollectionFrame {
+    stackTraces: ExceptionStackTrace[];
+    metrics: MetricRecord[];
+    traces: Trace[];
+}
+interface ReportRequest {
+    collectionFrames: CollectionFrame[];
+    appVersion: string;
+    serverName: string;
+}
+interface TracewayOptions {
+    debug?: boolean;
+    maxCollectionFrames?: number;
+    collectionInterval?: number;
+    uploadThrottle?: number;
+    metricsInterval?: number;
+    version?: string;
+    serverName?: string;
+    sampleRate?: number;
+    errorSampleRate?: number;
+}
+
+declare function generateUUID(): string;
+interface ParsedConnectionString {
+    token: string;
+    apiUrl: string;
+}
+declare function parseConnectionString(connectionString: string): ParsedConnectionString;
+declare function nowISO(): string;
+declare function msToNanoseconds(ms: number): number;
+
+declare const METRIC_MEM_USED = "mem.used";
+declare const METRIC_MEM_TOTAL = "mem.total";
+declare const METRIC_CPU_USED_PCNT = "cpu.used_pcnt";
+
+export { type CollectionFrame, type ExceptionStackTrace, METRIC_CPU_USED_PCNT, METRIC_MEM_TOTAL, METRIC_MEM_USED, type MetricRecord, type ParsedConnectionString, type ReportRequest, type Span, type Trace, type TracewayOptions, generateUUID, msToNanoseconds, nowISO, parseConnectionString };

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+interface ExceptionStackTrace {
+    traceId: string | null;
+    isTask?: boolean;
+    stackTrace: string;
+    recordedAt: string;
+    attributes?: Record<string, string>;
+    isMessage: boolean;
+}
+interface MetricRecord {
+    name: string;
+    value: number;
+    recordedAt: string;
+}
+interface Span {
+    id: string;
+    name: string;
+    startTime: string;
+    duration: number;
+}
+interface Trace {
+    id: string;
+    endpoint: string;
+    duration: number;
+    recordedAt: string;
+    statusCode: number;
+    bodySize: number;
+    clientIP: string;
+    attributes?: Record<string, string>;
+    spans?: Span[];
+    isTask?: boolean;
+}
+interface CollectionFrame {
+    stackTraces: ExceptionStackTrace[];
+    metrics: MetricRecord[];
+    traces: Trace[];
+}
+interface ReportRequest {
+    collectionFrames: CollectionFrame[];
+    appVersion: string;
+    serverName: string;
+}
+interface TracewayOptions {
+    debug?: boolean;
+    maxCollectionFrames?: number;
+    collectionInterval?: number;
+    uploadThrottle?: number;
+    metricsInterval?: number;
+    version?: string;
+    serverName?: string;
+    sampleRate?: number;
+    errorSampleRate?: number;
+}
+
+declare function generateUUID(): string;
+interface ParsedConnectionString {
+    token: string;
+    apiUrl: string;
+}
+declare function parseConnectionString(connectionString: string): ParsedConnectionString;
+declare function nowISO(): string;
+declare function msToNanoseconds(ms: number): number;
+
+declare const METRIC_MEM_USED = "mem.used";
+declare const METRIC_MEM_TOTAL = "mem.total";
+declare const METRIC_CPU_USED_PCNT = "cpu.used_pcnt";
+
+export { type CollectionFrame, type ExceptionStackTrace, METRIC_CPU_USED_PCNT, METRIC_MEM_TOTAL, METRIC_MEM_USED, type MetricRecord, type ParsedConnectionString, type ReportRequest, type Span, type Trace, type TracewayOptions, generateUUID, msToNanoseconds, nowISO, parseConnectionString };

package/dist/index.js

@@ -0,0 +1,81 @@
+"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, {
+  METRIC_CPU_USED_PCNT: () => METRIC_CPU_USED_PCNT,
+  METRIC_MEM_TOTAL: () => METRIC_MEM_TOTAL,
+  METRIC_MEM_USED: () => METRIC_MEM_USED,
+  generateUUID: () => generateUUID,
+  msToNanoseconds: () => msToNanoseconds,
+  nowISO: () => nowISO,
+  parseConnectionString: () => parseConnectionString
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils.ts
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function parseConnectionString(connectionString) {
+  const atIndex = connectionString.indexOf("@");
+  if (atIndex === -1) {
+    throw new Error(
+      "Invalid connection string: must be in format {token}@{apiUrl}"
+    );
+  }
+  const token = connectionString.slice(0, atIndex);
+  const apiUrl = connectionString.slice(atIndex + 1);
+  if (!token || !apiUrl) {
+    throw new Error(
+      "Invalid connection string: token and apiUrl must not be empty"
+    );
+  }
+  return { token, apiUrl };
+}
+function nowISO() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function msToNanoseconds(ms) {
+  return Math.round(ms * 1e6);
+}
+
+// src/constants.ts
+var METRIC_MEM_USED = "mem.used";
+var METRIC_MEM_TOTAL = "mem.total";
+var METRIC_CPU_USED_PCNT = "cpu.used_pcnt";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  METRIC_CPU_USED_PCNT,
+  METRIC_MEM_TOTAL,
+  METRIC_MEM_USED,
+  generateUUID,
+  msToNanoseconds,
+  nowISO,
+  parseConnectionString
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils.ts","../src/constants.ts"],"sourcesContent":["export type {\n  ExceptionStackTrace,\n  MetricRecord,\n  Span,\n  Trace,\n  CollectionFrame,\n  ReportRequest,\n  TracewayOptions,\n} from \"./types.js\";\n\nexport {\n  generateUUID,\n  parseConnectionString,\n  nowISO,\n  msToNanoseconds,\n} from \"./utils.js\";\nexport type { ParsedConnectionString } from \"./utils.js\";\n\nexport {\n  METRIC_MEM_USED,\n  METRIC_MEM_TOTAL,\n  METRIC_CPU_USED_PCNT,\n} from \"./constants.js\";\n","export function generateUUID(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport interface ParsedConnectionString {\n  token: string;\n  apiUrl: string;\n}\n\nexport function parseConnectionString(\n  connectionString: string,\n): ParsedConnectionString {\n  const atIndex = connectionString.indexOf(\"@\");\n  if (atIndex === -1) {\n    throw new Error(\n      \"Invalid connection string: must be in format {token}@{apiUrl}\",\n    );\n  }\n  const token = connectionString.slice(0, atIndex);\n  const apiUrl = connectionString.slice(atIndex + 1);\n  if (!token || !apiUrl) {\n    throw new Error(\n      \"Invalid connection string: token and apiUrl must not be empty\",\n    );\n  }\n  return { token, apiUrl };\n}\n\nexport function nowISO(): string {\n  return new Date().toISOString();\n}\n\nexport function msToNanoseconds(ms: number): number {\n  return Math.round(ms * 1_000_000);\n}\n","export const METRIC_MEM_USED = \"mem.used\";\nexport const METRIC_MEM_TOTAL = \"mem.total\";\nexport const METRIC_CPU_USED_PCNT = \"cpu.used_pcnt\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,SAAS,eAAuB;AACrC,MACE,OAAO,WAAW,eAClB,OAAO,OAAO,eAAe,YAC7B;AACA,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAOO,SAAS,sBACd,kBACwB;AACxB,QAAM,UAAU,iBAAiB,QAAQ,GAAG;AAC5C,MAAI,YAAY,IAAI;AAClB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,QAAQ,iBAAiB,MAAM,GAAG,OAAO;AAC/C,QAAM,SAAS,iBAAiB,MAAM,UAAU,CAAC;AACjD,MAAI,CAAC,SAAS,CAAC,QAAQ;AACrB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,OAAO,OAAO;AACzB;AAEO,SAAS,SAAiB;AAC/B,UAAO,oBAAI,KAAK,GAAE,YAAY;AAChC;AAEO,SAAS,gBAAgB,IAAoB;AAClD,SAAO,KAAK,MAAM,KAAK,GAAS;AAClC;;;AC5CO,IAAM,kBAAkB;AACxB,IAAM,mBAAmB;AACzB,IAAM,uBAAuB;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,48 @@
+// src/utils.ts
+function generateUUID() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function parseConnectionString(connectionString) {
+  const atIndex = connectionString.indexOf("@");
+  if (atIndex === -1) {
+    throw new Error(
+      "Invalid connection string: must be in format {token}@{apiUrl}"
+    );
+  }
+  const token = connectionString.slice(0, atIndex);
+  const apiUrl = connectionString.slice(atIndex + 1);
+  if (!token || !apiUrl) {
+    throw new Error(
+      "Invalid connection string: token and apiUrl must not be empty"
+    );
+  }
+  return { token, apiUrl };
+}
+function nowISO() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function msToNanoseconds(ms) {
+  return Math.round(ms * 1e6);
+}
+
+// src/constants.ts
+var METRIC_MEM_USED = "mem.used";
+var METRIC_MEM_TOTAL = "mem.total";
+var METRIC_CPU_USED_PCNT = "cpu.used_pcnt";
+export {
+  METRIC_CPU_USED_PCNT,
+  METRIC_MEM_TOTAL,
+  METRIC_MEM_USED,
+  generateUUID,
+  msToNanoseconds,
+  nowISO,
+  parseConnectionString
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/constants.ts"],"sourcesContent":["export function generateUUID(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return crypto.randomUUID();\n  }\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport interface ParsedConnectionString {\n  token: string;\n  apiUrl: string;\n}\n\nexport function parseConnectionString(\n  connectionString: string,\n): ParsedConnectionString {\n  const atIndex = connectionString.indexOf(\"@\");\n  if (atIndex === -1) {\n    throw new Error(\n      \"Invalid connection string: must be in format {token}@{apiUrl}\",\n    );\n  }\n  const token = connectionString.slice(0, atIndex);\n  const apiUrl = connectionString.slice(atIndex + 1);\n  if (!token || !apiUrl) {\n    throw new Error(\n      \"Invalid connection string: token and apiUrl must not be empty\",\n    );\n  }\n  return { token, apiUrl };\n}\n\nexport function nowISO(): string {\n  return new Date().toISOString();\n}\n\nexport function msToNanoseconds(ms: number): number {\n  return Math.round(ms * 1_000_000);\n}\n","export const METRIC_MEM_USED = \"mem.used\";\nexport const METRIC_MEM_TOTAL = \"mem.total\";\nexport const METRIC_CPU_USED_PCNT = \"cpu.used_pcnt\";\n"],"mappings":";AAAO,SAAS,eAAuB;AACrC,MACE,OAAO,WAAW,eAClB,OAAO,OAAO,eAAe,YAC7B;AACA,WAAO,OAAO,WAAW;AAAA,EAC3B;AACA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAOO,SAAS,sBACd,kBACwB;AACxB,QAAM,UAAU,iBAAiB,QAAQ,GAAG;AAC5C,MAAI,YAAY,IAAI;AAClB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,QAAQ,iBAAiB,MAAM,GAAG,OAAO;AAC/C,QAAM,SAAS,iBAAiB,MAAM,UAAU,CAAC;AACjD,MAAI,CAAC,SAAS,CAAC,QAAQ;AACrB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,OAAO,OAAO;AACzB;AAEO,SAAS,SAAiB;AAC/B,UAAO,oBAAI,KAAK,GAAE,YAAY;AAChC;AAEO,SAAS,gBAAgB,IAAoB;AAClD,SAAO,KAAK,MAAM,KAAK,GAAS;AAClC;;;AC5CO,IAAM,kBAAkB;AACxB,IAAM,mBAAmB;AACzB,IAAM,uBAAuB;","names":[]}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@tracewayapp/core",
+  "version": "0.1.0",
+  "description": "Shared types and utilities for Traceway SDKs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}