Greenatomy SDK

Lightweight Node.js SDK for the Greenatomy logs and stats APIs.

Install

npm install greenatomy-sdk

For local development from this repository:

npm install ./greenatomy-sdk

If you are working inside the SDK folder directly:

npm install

Usage

const GreenatomyClient = require("greenatomy-sdk");

const client = new GreenatomyClient({
  baseUrl: "https://greenatomy-1.onrender.com",
  apiKey: "ga_live_your_project_key",
  timeout: 8000,
});

For your production deployment, use the backend URL on Render: https://greenatomy-1.onrender.com.

You can authenticate with either:

• apiKey (x-api-key): Recommended for project-specific telemetry ingestion from production/staging/development apps
• token (Authorization: Bearer <token>): Recommended for authenticated dashboard, user, and project management routesreads

You can also override the default request timeout of 5000 ms with timeout.

Current SDK scope:

• getLogs()
• createLog()
• getStats()
• getSummary()
• greenatomyMiddleware()

API

getLogs(params?)

Fetches log entries from GET /logs.

const logs = await client.getLogs({
  page: 1,
  limit: 20,
});

createLog(payload)

Creates a telemetry log via POST /logs.

const createdLog = await client.createLog({
  method: "GET",
  path: "/api/users",
  statusCode: 200,
  durationMs: 142,
  cpuUsedMs: 38.5,
});

Common payload fields:

• method (required)
• path (required)
• statusCode (optional)
• durationMs (required)
• cpuUsedMs (optional, defaults to 0)
• createdAt (optional)

energyKwh, cost, and cpuUtil are calculated by the backend collector and returned in the stored log.

greenatomyMiddleware(options)

Express-style middleware for automatic inbound request telemetry.

const express = require("express");
const GreenatomyClient = require("greenatomy-sdk");
const { greenatomyMiddleware } = GreenatomyClient;

const app = express();

app.use(
  greenatomyMiddleware({
    baseUrl: "https://greenatomy-1.onrender.com",
    apiKey: "ga_live_project_environment_key",
    environment: "production",
  });
);

By default the middleware:

• tracks every inbound request except OPTIONS
• measures wall-clock request duration
• sends method, path, statusCode, durationMs, and createdAt
• never blocks the user request if telemetry submission fails
• associates logs with the issuing project API key
• tags logs by environment (development, staging, production)

Optional middleware options:

• shouldTrack(req, res) to selectively skip requests
• onError(error, req, res) to observe telemetry transport failures
• timeout to override the default request timeout

getStats(params?)

Fetches aggregated log stats from GET /logs/stats.

const stats = await client.getStats();

getSummary(params?)

Fetches a lightweight deployment-ready overview from GET /logs/summary.

const summary = await client.getSummary({ range: "24h" });

Error Handling

The SDK throws GreenatomySdkError for HTTP, timeout, and network failures.

const GreenatomyClient = require("greenatomy-sdk");
const { GreenatomySdkError } = GreenatomyClient;

try {
  const logs = await client.getLogs();
  console.log(logs);
} catch (error) {
  if (error instanceof GreenatomySdkError) {
    console.error(error.message);
    console.error(error.statusCode);
    console.error(error.code);
  } else {
    throw error;
  }
}

Possible error.code values:

• UNAUTHORIZED
• RATE_LIMITED
• HTTP_ERROR
• TIMEOUT
• NETWORK_ERROR

Notes

• baseUrl is required.
• Either token or apiKey is required.
• API keys are project-scoped and generated from the dashboard.
• Raw API keys are shown only once during creation.
• Separate API keys can be used per environment for safer production isolation.
• timeout is optional and defaults to 5000 ms.
• The client removes trailing slashes from baseUrl.
• The SDK currently supports logs, telemetry creation, stats, and summary endpoints.
• The SDK now also includes Express-style middleware for inbound request tracking.
• token is ideal for authenticated dashboard/user access.
• apiKey is ideal for project-level telemetry ingestion.

Recommended Onboarding

1. Register in the hosted dashboard.
2. Create a project.
3. Generate an API key for that project.
4. Save the raw API key when it is shown. It is only displayed once.
5. Configure the SDK with that API key and your hosted baseUrl.