@vestara-inc/node 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Ahsan Iqbal
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,187 @@
+# Vestara Node.js SDK
+
+Server-side Node.js SDK for Vestara crash reporting and remote logging.
+
+**Requires Node.js 16+** — zero external runtime dependencies.
+
+## Installation
+
+```bash
+npm install @vestara-inc/node
+```
+
+## Quick Start
+
+```typescript
+import Vestara from '@vestara-inc/node';
+
+Vestara.init({
+  token: 'your-project-token',
+  environment: 'production',
+  appVersion: '1.0.0',
+  targetCategory: 'web_backend',
+  serviceName: 'Node API',
+  appIdentifier: 'node-api',
+  // For background workers, use targetCategory: 'node_worker'
+});
+
+Vestara.log('info', 'Server started', { port: 3000 });
+Vestara.setUser({ id: 'user-123', email: 'user@example.com' });
+
+// Auto-captures uncaughtException and unhandledRejection
+```
+
+## Runtime target metadata
+
+You can provide metadata to identify this application in the dashboard:
+- `targetCategory`: The kind of target (e.g., `web_backend` for an API or `node_worker` for a queue processor).
+- `serviceName`: Human-readable name (e.g., `Node API`).
+- `appIdentifier`: Technical identifier (e.g., `node-api`).
+
+## API
+
+### `Vestara.init(options)`
+
+Initializes the SDK. Safe to call more than once — restarts session and clears queue.
+
+| Option | Type | Default |
+|--------|------|---------|
+| `token` | `string` | _(required)_ |
+| `apiUrl` | `string` | `https://api.vestara.dev` |
+| `environment` | `string` | `"production"` |
+| `appVersion` | `string` | `"unknown"` |
+| `targetCategory` | `string` | `"web_backend"` |
+| `serviceName` | `string` | `undefined` |
+| `appIdentifier` | `string` | `undefined` |
+| `beforeSend` | `(event) => event \| null` | `undefined` |
+
+### `beforeSend` hook
+
+The `beforeSend` option lets you inspect, modify, or drop events before they are queued:
+
+```typescript
+Vestara.init({
+  token: 'your-project-token',
+  beforeSend: (event) => {
+    // Redact sensitive data
+    if (event.payload.data?.apiKey) {
+      const modified = { ...event, payload: { ...event.payload } };
+      modified.payload.data = { ...event.payload.data, apiKey: '[REDACTED]' };
+      return modified;
+    }
+
+    // Drop noisy health checks
+    if (event.payload.message === 'health-check') {
+      return null;
+    }
+
+    return event;
+  },
+});
+```
+
+Behavior:
+- Return a modified event to send the modified version
+- Return `null` to drop the event
+- If the hook throws, the original event is sent (fail-open)
+
+Note: The Vestara backend also applies server-side redaction as a safety layer.
+
+### `Vestara.log(level, message, data?)`
+
+Queues a log event. Events are batched and sent every 10 seconds.
+
+```typescript
+Vestara.log('error', 'Database connection failed', { host: 'db.local' });
+```
+
+### `Vestara.captureError(error, context?)`
+
+Captures an error as a crash event with stack trace and breadcrumb snapshot. Triggers immediate flush.
+
+```typescript
+try {
+  riskyOperation();
+} catch (err) {
+  Vestara.captureError(err, { endpoint: '/api/users' });
+}
+```
+
+### `Vestara.setUser(context)`
+
+Attaches user context to subsequent events.
+
+```typescript
+Vestara.setUser({ id: 'user-123', email: 'user@example.com' });
+```
+
+## Custom API URL
+
+For local development, staging, or self-hosted deployments, pass `apiUrl`:
+
+```typescript
+Vestara.init({
+  token: 'your-project-token',
+  apiUrl: 'http://localhost:3000',
+  environment: 'development',
+});
+```
+
+Do not set `apiUrl` for normal Vestara SaaS usage.
+
+## Automatic Behavior
+
+### Crash Capture
+
+The SDK registers `process.on('uncaughtException')` and `process.on('unhandledRejection')` on first `init()`. Captured errors are sent with full stack traces and the current breadcrumb trail.
+
+- After capturing an uncaughtException, the process exits with code `1`
+- unhandledRejection errors are captured without crashing the process
+
+### Breadcrumbs
+
+Every `Vestara.log()` call adds a breadcrumb. The last 50 breadcrumbs are attached to crash payloads.
+
+### Shutdown Flush
+
+On `SIGTERM` or `SIGINT`, the SDK attempts a best-effort flush of remaining events (max 3 second wait). This is not guaranteed delivery.
+
+### Batching
+
+- Max queue: 500 events (in-memory)
+- Flush interval: 10 seconds
+- Batch size: 100 events per request
+- Crash events evict the oldest non-crash event when the queue is full
+- Crash events trigger an immediate flush
+
+## Event Shape
+
+All events include:
+
+```json
+{
+  "event_type": "log" | "crash",
+  "session_id": "uuid",
+  "device_id": "uuid",
+  "timestamp": "ISO8601",
+  "sdk_version": "0.1.0",
+  "app_version": "string",
+  "os_name": "node",
+  "os_version": "v20.x.x",
+  "device_model": "darwin server",
+  "environment": "production",
+  "payload": { ... }
+}
+```
+
+## No External Dependencies
+
+Uses only Node.js built-ins: `crypto`, `http`, `https`, `process`, `url`.
+
+## License
+
+This SDK is licensed under the Apache License 2.0.
+
+Copyright 2026 Ahsan Iqbal.
+
+Vestara, the Vestara name, logos, domain, and related branding are not granted under this license.

package/dist/breadcrumbs.d.ts

@@ -0,0 +1,12 @@
+export interface Breadcrumb {
+    timestamp: string;
+    category: string;
+    message: string;
+    level: string;
+    data?: Record<string, unknown>;
+}
+export declare function addBreadcrumb(category: string, message: string, level: string, data?: Record<string, unknown>): void;
+export declare function getBreadcrumbs(): Breadcrumb[];
+export declare function clearBreadcrumbs(): void;
+export declare function getBreadcrumbSnapshot(): Breadcrumb[];
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAcN;AAED,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,qBAAqB,IAAI,UAAU,EAAE,CAEpD"}

package/dist/breadcrumbs.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addBreadcrumb = addBreadcrumb;
+exports.getBreadcrumbs = getBreadcrumbs;
+exports.clearBreadcrumbs = clearBreadcrumbs;
+exports.getBreadcrumbSnapshot = getBreadcrumbSnapshot;
+const BREADCRUMB_LIMIT = 50;
+const buffer = [];
+function addBreadcrumb(category, message, level, data) {
+    const breadcrumb = {
+        timestamp: new Date().toISOString(),
+        category,
+        message: message.slice(0, 200),
+        level,
+        data,
+    };
+    if (buffer.length >= BREADCRUMB_LIMIT) {
+        buffer.shift();
+    }
+    buffer.push(breadcrumb);
+}
+function getBreadcrumbs() {
+    return buffer.slice();
+}
+function clearBreadcrumbs() {
+    buffer.length = 0;
+}
+function getBreadcrumbSnapshot() {
+    return buffer.slice();
+}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import * as queue from "./queue.js";
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+export type RuntimeTargetCategory = "ios_app" | "android_app" | "web_frontend" | "web_backend" | "react_native_app" | "flutter_app" | "python_worker" | "node_worker" | "desktop_app";
+export interface InitOptions {
+    token: string;
+    apiUrl?: string;
+    environment?: string;
+    appVersion?: string;
+    targetCategory?: RuntimeTargetCategory;
+    serviceName?: string;
+    appIdentifier?: string;
+    beforeSend?: (event: queue.SDKEvent) => queue.SDKEvent | null;
+}
+export interface UserContext {
+    id: string;
+    email?: string;
+}
+export declare const Vestara: {
+    init(options: InitOptions): void;
+    log(level: LogLevel, message: string, data?: Record<string, unknown>): void;
+    captureError(error: unknown, context?: Record<string, unknown>): void;
+    setUser(context: UserContext): void;
+    setSession(): void;
+    __testonly__processUncaughtException(error: unknown): void;
+    __testonly__processUnhandledRejection(reason: unknown): void;
+};
+export default Vestara;
+//# 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":"AAIA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAGpC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,aAAa,GACb,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmVD,eAAO,MAAM,OAAO;kBACJ,WAAW,GAAG,IAAI;eA8CrB,QAAQ,WAAW,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;wBAiCvD,OAAO,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;qBA0CpD,WAAW,GAAG,IAAI;kBAOrB,IAAI;gDAQ0B,OAAO,GAAG,IAAI;kDAIZ,OAAO,GAAG,IAAI;CAG7D,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,442 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Vestara = void 0;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+const metadata = __importStar(require("./metadata.js"));
+const breadcrumbs = __importStar(require("./breadcrumbs.js"));
+const queue = __importStar(require("./queue.js"));
+const uploader = __importStar(require("./uploader.js"));
+const DEFAULT_API_URL = "https://api.vestara.dev";
+const DEFAULT_ENVIRONMENT = "production";
+const DEVICE_SETTINGS_POLL_INTERVAL = 60000;
+let config = null;
+let initialized = false;
+let user = null;
+let handlersRegistered = false;
+let shutdownRegistered = false;
+let loggingEnabled = true;
+let deviceSettingsTimer = null;
+function makeEvent(eventType, payload) {
+    const base = metadata.getMetadata({
+        appVersion: config?.appVersion,
+        environment: config?.environment || DEFAULT_ENVIRONMENT,
+    });
+    return {
+        event_type: eventType,
+        session_id: base.session_id,
+        device_id: base.device_id,
+        timestamp: metadata.timestamp(),
+        sdk_version: base.sdk_version,
+        app_version: base.app_version,
+        os_name: base.os_name,
+        os_version: base.os_version,
+        device_model: base.device_model,
+        environment: base.environment,
+        target_category: config?.targetCategory || "web_backend",
+        ...(config?.serviceName ? { service_name: config.serviceName } : {}),
+        ...(config?.appIdentifier ? { app_identifier: config.appIdentifier } : {}),
+        payload,
+    };
+}
+function parseStack(stack) {
+    if (!stack) {
+        return [];
+    }
+    const lines = stack.split("\n");
+    const frames = [];
+    for (let i = 0; i < lines.length && frames.length < 30; i++) {
+        const raw = lines[i].trim();
+        if (!raw || raw === "Error") {
+            continue;
+        }
+        let match = null;
+        match = raw.match(/^\s*at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)$/);
+        if (match) {
+            frames.push({
+                function: match[1] || "(anonymous)",
+                file: match[2] || "unknown",
+                line: toNumber(match[3]),
+                column: toNumber(match[4]),
+            });
+            continue;
+        }
+        match = raw.match(/^\s*at\s+(.+?):(\d+):(\d+)$/);
+        if (match) {
+            frames.push({
+                function: "(anonymous)",
+                file: match[1] || "unknown",
+                line: toNumber(match[2]),
+                column: toNumber(match[3]),
+            });
+            continue;
+        }
+        match = raw.match(/^\s*at\s+(.+?)\s+\((.+?):(\d+)\)$/);
+        if (match) {
+            frames.push({
+                function: "(anonymous)",
+                file: match[2] || "unknown",
+                line: toNumber(match[3]),
+            });
+            continue;
+        }
+        match = raw.match(/^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/);
+        if (match) {
+            frames.push({
+                function: match[1] || "(anonymous)",
+                file: match[2] || "unknown",
+                line: toNumber(match[3]),
+                column: toNumber(match[4]),
+            });
+        }
+    }
+    return frames;
+}
+function toNumber(value) {
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? 0 : parsed;
+}
+function normalizeValue(value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (value instanceof Error) {
+        return value.message || String(value);
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function normalizeData(data) {
+    if (!data || typeof data !== "object") {
+        return undefined;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const normalized = normalizeValue(value);
+        if (normalized !== undefined) {
+            result[key] = normalized;
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+async function pollDeviceSettings() {
+    if (!config) {
+        return;
+    }
+    const deviceId = metadata.getDeviceId();
+    if (!deviceId) {
+        return;
+    }
+    try {
+        const parsed = new URL(config.apiUrl + "/v1/sdk/device-settings?device_id=" + encodeURIComponent(deviceId));
+        const isHttps = parsed.protocol === "https:";
+        const transport = isHttps ? https : http;
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port || (isHttps ? 443 : 80),
+            path: parsed.pathname + parsed.search,
+            method: "GET",
+            headers: {
+                "X-SDK-Token": config.token,
+            },
+        };
+        const response = await new Promise((resolve, reject) => {
+            const req = transport.request(options, resolve);
+            req.on("error", reject);
+            req.end();
+        });
+        if (response.statusCode === 200) {
+            const body = await new Promise((resolve) => {
+                let data = "";
+                response.on("data", (chunk) => { data += chunk; });
+                response.on("end", () => { resolve(data); });
+            });
+            const settings = JSON.parse(body);
+            if (typeof settings.logging_enabled === "boolean") {
+                loggingEnabled = settings.logging_enabled;
+            }
+        }
+    }
+    catch {
+        // fail open: continue with current loggingEnabled setting
+    }
+}
+function startDeviceSettingsPolling() {
+    if (deviceSettingsTimer) {
+        clearInterval(deviceSettingsTimer);
+    }
+    void pollDeviceSettings();
+    deviceSettingsTimer = setInterval(() => {
+        void pollDeviceSettings();
+    }, DEVICE_SETTINGS_POLL_INTERVAL);
+}
+function stopDeviceSettingsPolling() {
+    if (deviceSettingsTimer) {
+        clearInterval(deviceSettingsTimer);
+        deviceSettingsTimer = null;
+    }
+}
+function buildUserPayload() {
+    if (!user || !user.id) {
+        return undefined;
+    }
+    const payload = { id: user.id };
+    if (user.email) {
+        payload.email = user.email;
+    }
+    return payload;
+}
+function applyBeforeSend(event) {
+    if (!config?.beforeSend) {
+        return event;
+    }
+    try {
+        return config.beforeSend(event) ?? null;
+    }
+    catch {
+        return event;
+    }
+}
+function handleProcessError(error, contextType) {
+    if (!config)
+        return;
+    try {
+        const safeError = error instanceof Error ? error : new Error(String(error ?? "Unknown error"));
+        const stackTrace = parseStack(safeError.stack || "");
+        breadcrumbs.addBreadcrumb("process", `unhandled ${contextType}`, "error", {
+            message: safeError.message,
+        });
+        const payload = {
+            message: safeError.message || "Unknown error",
+            name: safeError.name || "Error",
+            stack: safeError.stack || "",
+            stack_trace: stackTrace,
+            context: { type: contextType },
+        };
+        const userPayload = buildUserPayload();
+        if (userPayload) {
+            payload.user = userPayload;
+        }
+        const snapshot = breadcrumbs.getBreadcrumbSnapshot();
+        if (snapshot.length > 0) {
+            payload.breadcrumbs = snapshot;
+        }
+        const event = makeEvent("crash", payload);
+        const finalEvent = applyBeforeSend(event);
+        if (finalEvent) {
+            queue.enqueue(finalEvent, true);
+            void uploader.flush(true).then(() => {
+                if (contextType === "uncaughtException") {
+                    proc.exit(1);
+                }
+            });
+        }
+        else {
+            if (contextType === "uncaughtException") {
+                proc.exit(1);
+            }
+        }
+    }
+    catch {
+        // best-effort: re-throw if we can't capture
+        if (contextType === "uncaughtException") {
+            proc.exit(1);
+        }
+    }
+}
+const proc = typeof process !== "undefined" ? process : globalThis.process;
+function registerHandlers() {
+    if (handlersRegistered) {
+        return;
+    }
+    handlersRegistered = true;
+    proc.on("unhandledRejection", (reason) => {
+        handleProcessError(reason, "unhandledRejection");
+    });
+    proc.on("uncaughtException", (error) => {
+        handleProcessError(error, "uncaughtException");
+    });
+}
+async function gracefulShutdown(signal) {
+    if (!config) {
+        return;
+    }
+    proc.removeAllListeners("SIGTERM");
+    proc.removeAllListeners("SIGINT");
+    stopDeviceSettingsPolling();
+    try {
+        await Promise.race([
+            uploader.flush(true),
+            new Promise((resolve) => setTimeout(resolve, 3000)),
+        ]);
+    }
+    catch {
+        // best-effort
+    }
+    if (signal === "SIGTERM") {
+        proc.kill(proc.pid, "SIGTERM");
+    }
+    else {
+        proc.exit(0);
+    }
+}
+exports.Vestara = {
+    init(options) {
+        if (!options || !options.token) {
+            return;
+        }
+        const wasInitialized = initialized;
+        config = {
+            token: options.token,
+            apiUrl: options.apiUrl || DEFAULT_API_URL,
+            environment: options.environment || DEFAULT_ENVIRONMENT,
+            appVersion: options.appVersion,
+            targetCategory: options.targetCategory || "web_backend",
+            serviceName: options.serviceName,
+            appIdentifier: options.appIdentifier,
+            beforeSend: options.beforeSend,
+        };
+        if (wasInitialized) {
+            uploader.stopUploader();
+        }
+        else {
+            registerHandlers();
+        }
+        if (!shutdownRegistered) {
+            shutdownRegistered = true;
+            proc.on("SIGTERM", () => { void gracefulShutdown("SIGTERM"); });
+            proc.on("SIGINT", () => { void gracefulShutdown("SIGINT"); });
+        }
+        uploader.initUploader({
+            apiUrl: config.apiUrl,
+            token: config.token,
+        });
+        if (wasInitialized) {
+            stopDeviceSettingsPolling();
+        }
+        startDeviceSettingsPolling();
+        breadcrumbs.clearBreadcrumbs();
+        queue.clear();
+        metadata.resetSessionId();
+        initialized = true;
+    },
+    log(level, message, data) {
+        if (!config || !message) {
+            return;
+        }
+        if (!loggingEnabled) {
+            return;
+        }
+        breadcrumbs.addBreadcrumb("log", message, level, data);
+        const payload = {
+            level,
+            message,
+        };
+        const normalized = normalizeData(data);
+        if (normalized) {
+            payload.data = normalized;
+        }
+        const userPayload = buildUserPayload();
+        if (userPayload) {
+            payload.user = userPayload;
+        }
+        const event = makeEvent("log", payload);
+        const finalEvent = applyBeforeSend(event);
+        if (finalEvent) {
+            queue.enqueue(finalEvent);
+        }
+    },
+    captureError(error, context) {
+        if (!config) {
+            return;
+        }
+        const safeError = error instanceof Error ? error : new Error(String(error ?? "Unknown error"));
+        const stackTrace = parseStack(safeError.stack || "");
+        breadcrumbs.addBreadcrumb("error", safeError.message, "error");
+        const payload = {
+            message: safeError.message || "Unknown error",
+            name: safeError.name || "Error",
+            stack: safeError.stack || "",
+        };
+        if (stackTrace.length > 0) {
+            payload.stack_trace = stackTrace;
+        }
+        if (context) {
+            payload.context = normalizeData(context);
+        }
+        const userPayload = buildUserPayload();
+        if (userPayload) {
+            payload.user = userPayload;
+        }
+        const snapshot = breadcrumbs.getBreadcrumbSnapshot();
+        if (snapshot.length > 0) {
+            payload.breadcrumbs = snapshot;
+        }
+        const event = makeEvent("crash", payload);
+        const finalEvent = applyBeforeSend(event);
+        if (finalEvent) {
+            queue.enqueue(finalEvent, true);
+        }
+        void uploader.flush(true);
+    },
+    setUser(context) {
+        if (!context || !context.id) {
+            return;
+        }
+        user = { id: context.id, email: context.email };
+    },
+    setSession() {
+        if (!config) {
+            return;
+        }
+        metadata.resetSessionId();
+        breadcrumbs.clearBreadcrumbs();
+    },
+    __testonly__processUncaughtException(error) {
+        handleProcessError(error, "uncaughtException");
+    },
+    __testonly__processUnhandledRejection(reason) {
+        handleProcessError(reason, "unhandledRejection");
+    },
+};
+exports.default = exports.Vestara;

package/dist/metadata.d.ts

@@ -0,0 +1,20 @@
+export declare const SDK_VERSION = "0.1.0";
+export declare function generateUUID(): string;
+export declare function getDeviceId(): string;
+export declare function getSessionId(): string;
+export declare function resetSessionId(): void;
+export declare function getMetadata(config: {
+    appVersion?: string;
+    environment: string;
+}): {
+    device_id: string;
+    session_id: string;
+    sdk_version: string;
+    app_version: string;
+    os_name: string;
+    os_version: string;
+    device_model: string;
+    environment: string;
+};
+export declare function timestamp(): string;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,UAAU,CAAC;AAKnC,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAWA;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/metadata.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = void 0;
+exports.generateUUID = generateUUID;
+exports.getDeviceId = getDeviceId;
+exports.getSessionId = getSessionId;
+exports.resetSessionId = resetSessionId;
+exports.getMetadata = getMetadata;
+exports.timestamp = timestamp;
+const crypto = __importStar(require("crypto"));
+const process = __importStar(require("process"));
+exports.SDK_VERSION = "0.1.0";
+let _deviceId = null;
+let _sessionId = null;
+function generateUUID() {
+    const bytes = crypto.randomBytes(16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString("hex");
+    return (hex.slice(0, 8) + "-" +
+        hex.slice(8, 12) + "-" +
+        hex.slice(12, 16) + "-" +
+        hex.slice(16, 20) + "-" +
+        hex.slice(20));
+}
+function getDeviceId() {
+    if (!_deviceId) {
+        _deviceId = generateUUID();
+    }
+    return _deviceId;
+}
+function getSessionId() {
+    if (!_sessionId) {
+        _sessionId = generateUUID();
+    }
+    return _sessionId;
+}
+function resetSessionId() {
+    _sessionId = generateUUID();
+}
+function getMetadata(config) {
+    return {
+        device_id: getDeviceId(),
+        session_id: getSessionId(),
+        sdk_version: exports.SDK_VERSION,
+        app_version: config.appVersion || "unknown",
+        os_name: "node",
+        os_version: process.version,
+        device_model: process.platform + " server",
+        environment: config.environment,
+    };
+}
+function timestamp() {
+    return new Date().toISOString();
+}

package/dist/queue.d.ts

@@ -0,0 +1,23 @@
+export interface SDKEvent {
+    event_type: string;
+    session_id: string;
+    device_id: string;
+    timestamp: string;
+    sdk_version: string;
+    app_version: string;
+    os_name: string;
+    os_version: string;
+    device_model: string;
+    environment: string;
+    target_category: string;
+    service_name?: string;
+    app_identifier?: string;
+    payload: Record<string, unknown>;
+}
+export declare function enqueue(event: SDKEvent, _immediate?: boolean): void;
+export declare function peek(limit: number): SDKEvent[];
+export declare function removeFirst(count: number): void;
+export declare function count(): number;
+export declare function getAll(): SDKEvent[];
+export declare function clear(): void;
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CA0BnE;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAE9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,MAAM,IAAI,QAAQ,EAAE,CAEnC;AAED,wBAAgB,KAAK,IAAI,IAAI,CAE5B"}

package/dist/queue.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enqueue = enqueue;
+exports.peek = peek;
+exports.removeFirst = removeFirst;
+exports.count = count;
+exports.getAll = getAll;
+exports.clear = clear;
+const QUEUE_LIMIT = 500;
+const queue = [];
+function enqueue(event, _immediate) {
+    if (event.event_type === "crash") {
+        if (queue.length < QUEUE_LIMIT) {
+            queue.push(event);
+            return;
+        }
+        const nonCrashIndex = queue.findIndex((e) => e.event_type !== "crash");
+        if (nonCrashIndex >= 0) {
+            queue.splice(nonCrashIndex, 1);
+        }
+        else {
+            queue.shift();
+        }
+        queue.push(event);
+        return;
+    }
+    if (queue.length >= QUEUE_LIMIT) {
+        const nonCrashIndex = queue.findIndex((e) => e.event_type !== "crash");
+        if (nonCrashIndex >= 0) {
+            queue.splice(nonCrashIndex, 1);
+        }
+        else {
+            return;
+        }
+    }
+    queue.push(event);
+}
+function peek(limit) {
+    return queue.slice(0, limit);
+}
+function removeFirst(count) {
+    queue.splice(0, count);
+}
+function count() {
+    return queue.length;
+}
+function getAll() {
+    return queue.slice();
+}
+function clear() {
+    queue.length = 0;
+}

package/dist/uploader.d.ts

@@ -0,0 +1,10 @@
+interface UploaderConfig {
+    apiUrl: string;
+    token: string;
+}
+export declare function initUploader(cfg: UploaderConfig): void;
+export declare function stopUploader(): void;
+export declare function flush(_immediate: boolean): Promise<void>;
+export declare function isUploading(): boolean;
+export {};
+//# sourceMappingURL=uploader.d.ts.map

package/dist/uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../src/uploader.ts"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGtD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAkBD,wBAAsB,KAAK,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC9D;AAiDD,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/uploader.js

@@ -0,0 +1,143 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initUploader = initUploader;
+exports.stopUploader = stopUploader;
+exports.flush = flush;
+exports.isUploading = isUploading;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+const url_1 = require("url");
+const queue = __importStar(require("./queue.js"));
+let config = null;
+let flushInterval = null;
+let uploading = false;
+function initUploader(cfg) {
+    config = cfg;
+    startFlushTimer();
+}
+function stopUploader() {
+    stopFlushTimer();
+}
+function startFlushTimer() {
+    if (flushInterval) {
+        clearInterval(flushInterval);
+    }
+    flushInterval = setInterval(() => {
+        void flush(false);
+    }, 10000);
+}
+function stopFlushTimer() {
+    if (flushInterval) {
+        clearInterval(flushInterval);
+        flushInterval = null;
+    }
+}
+async function flush(_immediate) {
+    if (!config) {
+        return;
+    }
+    if (uploading) {
+        return;
+    }
+    if (queue.count() === 0) {
+        return;
+    }
+    uploading = true;
+    try {
+        while (true) {
+            const batch = queue.peek(100);
+            if (batch.length === 0) {
+                break;
+            }
+            try {
+                await uploadBatch(config, batch);
+            }
+            catch {
+                break;
+            }
+            queue.removeFirst(batch.length);
+            if (queue.count() === 0) {
+                break;
+            }
+        }
+    }
+    finally {
+        uploading = false;
+    }
+}
+async function uploadBatch(cfg, events) {
+    return new Promise((resolve, reject) => {
+        let parsed;
+        try {
+            parsed = new url_1.URL(cfg.apiUrl + "/v1/ingest");
+        }
+        catch {
+            reject(new Error("Invalid API URL"));
+            return;
+        }
+        const isHttps = parsed.protocol === "https:";
+        const transport = isHttps ? https : http;
+        const body = JSON.stringify({ events });
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port || (isHttps ? 443 : 80),
+            path: parsed.pathname + parsed.search,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-SDK-Token": cfg.token,
+                "Content-Length": Buffer.byteLength(body),
+            },
+        };
+        const req = transport.request(options, (res) => {
+            if (res.statusCode === undefined || res.statusCode < 200 || res.statusCode >= 300) {
+                res.resume();
+                reject(new Error(`HTTP ${res.statusCode ?? "unknown"}`));
+                return;
+            }
+            res.resume();
+            resolve();
+        });
+        req.on("error", (err) => {
+            reject(err);
+        });
+        req.write(body);
+        req.end();
+    });
+}
+function isUploading() {
+    return uploading;
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@vestara-inc/node",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Server-side Node.js SDK for Vestara",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --testTimeout=30000"
+  },
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.0.0"
+  }
+}