LogTide JavaScript SDK

Official JavaScript SDKs for LogTide — self-hosted log management with distributed tracing, error capture, and breadcrumbs for every major framework.

---

Packages

Package	Version	Description
@logtide/types		Shared type definitions
@logtide/core		Core client, hub, transports, and utilities
@logtide/express		Express middleware
@logtide/fastify		Fastify plugin
@logtide/nextjs		Next.js integration (App Router & Pages)
@logtide/nuxt		Nuxt 3 module with Nitro hooks
@logtide/sveltekit		SvelteKit hooks integration
@logtide/hono		Hono middleware
@logtide/angular		Angular ErrorHandler, HTTP Interceptor
@logtide/elysia		Elysia plugin
@logtide/browser		Browser SDK — Web Vitals, breadcrumbs, offline transport
@logtide/cli		CLI — source maps upload and release management
@logtide/sdk-node		Legacy Node.js SDK (use @logtide/express or @logtide/fastify instead)

Quick Start

Every framework package follows the same pattern — pass your DSN and service name:

# Install for your framework
npm install @logtide/express   # Express
npm install @logtide/fastify   # Fastify
npm install @logtide/nextjs    # Next.js
npm install @logtide/nuxt      # Nuxt 3
npm install @logtide/sveltekit # SvelteKit
npm install @logtide/hono      # Hono
npm install @logtide/angular   # Angular
npm install @logtide/elysia    # Elysia

// Every integration follows the same pattern:
{
  dsn: 'https://lp_your_key@your-logtide-instance.com',
  service: 'my-app',
}

// Or use apiUrl + apiKey separately:
{
  apiUrl: 'https://your-logtide-instance.com',
  apiKey: 'lp_your_key',
  service: 'my-app',
}

See each package's README for framework-specific setup instructions.

CLI

The @logtide/cli package provides a command-line tool for managing source maps and releases.

# Install globally
npm install -g @logtide/cli

# Or use npx
npx @logtide/cli sourcemaps upload --api-url https://your-logtide-instance.com --api-key lp_your_key ./dist

Commands

Command	Description
logtide sourcemaps upload	Upload source maps to LogTide server for stack trace deobfuscation

---

Architecture

@logtide/types          ← Shared TypeScript interfaces
    ↓
@logtide/core           ← Client, Hub, Scope, Transports, Integrations
    ↓
├── @logtide/express    ← Express middleware
├── @logtide/fastify    ← Fastify plugin
├── @logtide/nextjs     ← Next.js (App Router + Pages)
├── @logtide/nuxt       ← Nuxt 3 (Nitro + Vue)
├── @logtide/sveltekit  ← SvelteKit (handle/handleError/handleFetch)
├── @logtide/hono       ← Hono middleware
├── @logtide/angular    ← Angular (ErrorHandler + HttpInterceptor)
├── @logtide/elysia     ← Elysia plugin
├── @logtide/browser    ← Browser SDK (Web Vitals, breadcrumbs, offline)
├── @logtide/cli        ← CLI (source maps upload)
└── @logtide/sdk-node   ← Legacy standalone Node.js SDK

All framework packages share @logtide/core for:

• Distributed tracing (W3C Trace Context / traceparent)
• Error serialization with structured stack traces
• Breadcrumbs for navigation, HTTP, console, and custom events
• Batched transport with retry logic and circuit breaker
• Scope isolation per request

---

Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run all tests
pnpm test

# TypeScript check
pnpm typecheck

# Set version across all packages
pnpm version:set 0.6.0

Branch Model

feature/* ──> develop ──> main ──> tag v*.*.* ──> npm publish
hotfix/*  ──> main (direct, for urgent fixes)

See .github/BRANCH_PROTECTION.md for full details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT License — see LICENSE for details.

Links

• LogTide Website
• Documentation
• GitHub Issues