@grow-codes/better-stack-logs - v0.1.1
    Preparing search index...

    @grow-codes/better-stack-logs - v0.1.1

    @grow-codes/better-stack-logs

    TypeScript SDK for Better Stack Logs by Grow Codes. Node.js 22.12 or newer, ESM and CommonJS, full type definitions.

    npm install @grow-codes/better-stack-logs
    
    import { BetterStackClient } from "@grow-codes/better-stack-logs";

    // Ingest: BETTERSTACK_INGESTING_HOST + BETTERSTACK_SOURCE_TOKEN (or GROW_BETTER_STACK_LOGS_URL /
    // _SOURCE_TOKEN). SQL query: BETTERSTACK_QUERY_HOST, _QUERY_USERNAME, _QUERY_PASSWORD, _SOURCE_TABLE.
    const client = BetterStackClient.fromEnv();
    try {
    const logs = client.logClient({ resource: { "service.name": "checkout" } });
    logs.logger().info("order placed", { orderId: 42 }); // batched, gzipped, redacted
    await logs.flush();

    const found = await client.query().waitForLog("order placed", { timeoutMs: 60_000 });
    console.log(found.timestamp, found.body, found.attributes);
    } finally {
    await client.close(); // flushes every log client
    }
    Area API
    Client BetterStackClient (fromEnv, health, ping, serverVersion → UNSUPPORTED, close)
    Ingest logClient({ protocol: "http" | "otlp" }) → BetterStackLogClient, exporter (BetterStackLogExporter: JSON / NDJSON / MessagePack, gzip, 10 MiB splitting, sendEvents), otlpExporter (OTLP/HTTP /v1/logs, protobuf or JSON)
    Query query() → BetterStackQuery: query(sql, params), queryRaw, searchLogs({ source, contains, start, end, limit, order, cursor }), search, waitForLog, tail (polling), listStreams
    Logging Logger, BatchProcessor, RedactionProcessor, pino / winston transports

    Every error is a BetterStackError subclass with a canonical code (NOT_FOUND, AUTHENTICATION, RATE_LIMITED, …), httpStatus, requestId and retryable. Credentials never appear in messages, logs, hook data or toString() output.

    Test helpers (in-memory fakes and the conformance runner) live in @grow-codes/better-stack-logs/testing.

    Documentation: https://grow-codes-packages.github.io/better-stack-logs/ · Licence: Apache-2.0. Better Stack Logs is a trademark of Better Stack, Inc.; this package is not affiliated with or endorsed by it.