@catalyst-cloud/sdk 0.2.0 → 0.3.0

package/dist/otel.js

@@ -0,0 +1,249 @@
+// @catalyst-cloud/sdk — guarded, zero-hard-dep OpenTelemetry seam (CTC-138).
+//
+// `@opentelemetry/api` is an OPTIONAL peer dependency. This module is the ONE place the SDK touches
+// it, and it does so through a guarded **dynamic** import resolved once during the async `start()`
+// path — never a static top-level `import`. That distinction is load-bearing:
+//
+//   • A static `import { trace, metrics } from "@opentelemetry/api"` fails MODULE RESOLUTION when a
+//     consumer hasn't installed the package → a hard dependency in practice. The api package's
+//     built-in no-op tracer/meter only save you AFTER it has been resolved (i.e. when it's installed
+//     but no provider is registered); they do nothing for "not installed at all".
+//   • The guarded `await import("@opentelemetry/api")` here catches the resolution failure and falls
+//     back to hand-rolled no-op stubs, so the SDK imports + runs with the package entirely ABSENT.
+//
+// When the package IS present and the consumer has registered a global TracerProvider/MeterProvider,
+// spans + metrics route through `trace.getTracer()` / `metrics.getMeter()` — so the consumer's
+// Resource (service.name, etc.) flows through automatically. When present but with NO provider, the
+// api's own no-ops apply and every call is harmless.
+//
+// Kept free of any node-only import so the browser bundle stays clean; the public surfaces below are
+// declared STRUCTURALLY (no `@opentelemetry/api` type import) so no OTel type leaks into the package's
+// generated `.d.ts`, and the whole seam tree-shakes away (package.json `sideEffects:false`) when
+// telemetry is off.
+/** The shared `catalyst.*` semconv attribute keys emitted across spans + metrics. */
+export const CATALYST_ATTR = {
+    /** The tenant id (= mirror/account name). */
+    tenant: "catalyst.tenant",
+    /** The upstream system a row originates from: `"linear"` | `"github"`. */
+    source: "catalyst.source",
+    /** The durable change-feed cursor (last applied seq). */
+    cursor: "catalyst.replica.cursor",
+    /** head_seq − cursor (mirror lag in seqs), when head_seq is known. */
+    lagSeq: "catalyst.replica.lag_seq",
+    /** The connection lifecycle status string. */
+    status: "catalyst.replica.status",
+    /** Rows applied during a seed. */
+    rowCount: "catalyst.replica.row_count",
+    /** Rows in one seed apply-batch. */
+    batchRows: "catalyst.replica.batch_rows",
+};
+/** Metric instrument names (OTel metric stream names). */
+export const REPLICA_METRIC = {
+    cursor: "catalyst.replica.cursor",
+    lagSeq: "catalyst.replica.lag_seq",
+    freshnessMs: "catalyst.replica.freshness_ms",
+    status: "catalyst.replica.status",
+    applied: "catalyst.replica.applied",
+    applyBatchRows: "catalyst.replica.apply_batch_rows",
+};
+/** Span names. */
+export const REPLICA_SPAN = {
+    seed: "catalyst.replica.seed",
+    applyBatch: "catalyst.replica.apply_batch",
+    resync: "catalyst.replica.resync",
+    reconnect: "catalyst.replica.reconnect",
+};
+/** `LiveSyncStatus` → a numeric gauge code (the `catalyst.replica.status` gauge value). */
+export const REPLICA_STATUS_CODE = {
+    connecting: 0,
+    live: 1,
+    reconnecting: 2,
+    resyncing: 3,
+    error: 4,
+    stopped: 5,
+};
+/** The default instrumentation-scope name for both the tracer and the meter. */
+export const DEFAULT_SCOPE_NAME = "@catalyst-cloud/sdk";
+/** The mirror entities sourced from GitHub (the rest are Linear) — drives the `catalyst.source` attr. */
+const GITHUB_ENTITIES = new Set([
+    "pull_requests",
+    "check_runs",
+    "commit_statuses",
+    "reviews",
+]);
+/** Map a change-feed `entity` (table name) to its upstream source system, for `catalyst.source`. */
+export function entitySource(entity) {
+    return GITHUB_ENTITIES.has(entity) ? "github" : "linear";
+}
+// ── No-op implementation (used when telemetry is OFF or `@opentelemetry/api` is absent). ───────────
+const NOOP_SPAN_HANDLE = { setAttribute() { } };
+const NOOP_MANUAL_SPAN = { setAttribute() { }, end() { } };
+const NOOP_REGISTRATION = { remove() { } };
+const NOOP_COUNTER = { add() { } };
+const NOOP_HISTOGRAM = { record() { } };
+/** A telemetry that does nothing but still threads the callback's return value through `withActiveSpan*`. */
+export const NOOP_TELEMETRY = {
+    enabled: false,
+    withActiveSpan: (_name, _attributes, fn) => fn(NOOP_SPAN_HANDLE),
+    withActiveSpanSync: (_name, _attributes, fn) => fn(NOOP_SPAN_HANDLE),
+    startSpan: () => NOOP_MANUAL_SPAN,
+    observableGauge: () => NOOP_REGISTRATION,
+    counter: () => NOOP_COUNTER,
+    histogram: () => NOOP_HISTOGRAM,
+};
+/** Drop `undefined`-valued attributes (OTel rejects them) → a clean attribute record. */
+function cleanAttrs(attributes) {
+    const out = {};
+    if (!attributes)
+        return out;
+    for (const [k, v] of Object.entries(attributes)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+/**
+ * Build a REAL telemetry facade over a resolved `@opentelemetry/api` surface (or the NO-OP when
+ * `api` is null — the "package absent" branch). Exported (but NOT re-exported from the package
+ * entrypoints) so it can be unit-tested directly with `null` for the absent case.
+ */
+export function buildTelemetry(api, names) {
+    if (!api)
+        return NOOP_TELEMETRY;
+    const tracer = api.trace.getTracer(names.tracerName);
+    const meter = api.metrics.getMeter(names.meterName);
+    const OK = api.SpanStatusCode.OK;
+    const ERROR = api.SpanStatusCode.ERROR;
+    const endSpan = (span, error) => {
+        if (error !== undefined) {
+            span.recordException(error);
+            span.setStatus({ code: ERROR, message: error instanceof Error ? error.message : String(error) });
+        }
+        else {
+            span.setStatus({ code: OK });
+        }
+        span.end();
+    };
+    const handleFor = (span) => ({
+        setAttribute: (k, v) => {
+            span.setAttribute(k, v);
+        },
+    });
+    return {
+        enabled: true,
+        withActiveSpan(name, attributes, fn) {
+            return tracer.startActiveSpan(name, { attributes: cleanAttrs(attributes) }, async (span) => {
+                try {
+                    const result = await fn(handleFor(span));
+                    endSpan(span);
+                    return result;
+                }
+                catch (err) {
+                    endSpan(span, err);
+                    throw err;
+                }
+            });
+        },
+        withActiveSpanSync(name, attributes, fn) {
+            return tracer.startActiveSpan(name, { attributes: cleanAttrs(attributes) }, (span) => {
+                try {
+                    const result = fn(handleFor(span));
+                    endSpan(span);
+                    return result;
+                }
+                catch (err) {
+                    endSpan(span, err);
+                    throw err;
+                }
+            });
+        },
+        startSpan(name, attributes) {
+            const span = tracer.startSpan(name, { attributes: cleanAttrs(attributes) });
+            return {
+                setAttribute: (k, v) => {
+                    span.setAttribute(k, v);
+                },
+                end: (error) => endSpan(span, error),
+            };
+        },
+        observableGauge(name, options, callback) {
+            const gauge = meter.createObservableGauge(name, options);
+            const cb = (result) => {
+                callback({ observe: (value, attrs) => result.observe(value, cleanAttrs(attrs)) });
+            };
+            gauge.addCallback(cb);
+            return { remove: () => gauge.removeCallback(cb) };
+        },
+        counter(name, options) {
+            const instrument = meter.createCounter(name, options);
+            return { add: (value, attrs) => instrument.add(value, cleanAttrs(attrs)) };
+        },
+        histogram(name, options) {
+            const instrument = meter.createHistogram(name, options);
+            return { record: (value, attrs) => instrument.record(value, cleanAttrs(attrs)) };
+        },
+    };
+}
+// ── The guarded one-time dynamic import. ──────────────────────────────────────────────────────────
+let apiPromise;
+let warnedAbsent = false;
+/** Dynamic-import `@opentelemetry/api` ONCE (cached). Resolves to its surface, or `null` if the
+ *  package isn't installed — the catch is what makes it a TRUE optional peer dependency. */
+async function loadOtelApi() {
+    if (apiPromise === undefined) {
+        apiPromise = import("@opentelemetry/api").then((mod) => {
+            // The named exports (trace/metrics/SpanStatusCode) may sit on the module namespace OR on
+            // `default`, depending on the CJS/ESM interop (node vs a bundler/test runner). Pick whichever
+            // object actually carries them rather than guessing `default ?? mod`.
+            const hasApi = (o) => typeof o === "object" &&
+                o !== null &&
+                "trace" in o &&
+                "metrics" in o &&
+                "SpanStatusCode" in o;
+            const ns = mod;
+            if (hasApi(mod))
+                return mod;
+            if (hasApi(ns.default))
+                return ns.default;
+            return null;
+        }, () => null);
+    }
+    return apiPromise;
+}
+/** True iff `value` is an already-resolved {@link Telemetry} (internal pass-through, e.g. a replica
+ *  sharing its instance with the transport) rather than a {@link TelemetryConfig}. */
+function isTelemetry(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.withActiveSpan === "function");
+}
+/**
+ * Resolve the opt-in `telemetry` option into a {@link Telemetry}. Defaults to {@link NOOP_TELEMETRY}
+ * (no dynamic import attempted) when undefined/false so the off path is truly zero-overhead. When ON,
+ * guard-imports `@opentelemetry/api`; if absent, warns once and falls back to no-op (never throws). An
+ * already-resolved `Telemetry` is returned as-is so a replica + its transport share ONE instance.
+ */
+export async function createTelemetry(config, defaults) {
+    if (isTelemetry(config))
+        return config;
+    if (config === undefined || config === false)
+        return NOOP_TELEMETRY;
+    const names = config === true
+        ? defaults
+        : {
+            tracerName: config.tracerName ?? defaults.tracerName,
+            meterName: config.meterName ?? defaults.meterName,
+        };
+    const api = await loadOtelApi();
+    if (!api) {
+        if (!warnedAbsent) {
+            warnedAbsent = true;
+            // eslint-disable-next-line no-console
+            console.warn("[catalyst-sdk:otel] telemetry was enabled but the optional peer '@opentelemetry/api' is not " +
+                "installed — running with no-op telemetry. Install '@opentelemetry/api' to emit spans/metrics.");
+        }
+        return NOOP_TELEMETRY;
+    }
+    return buildTelemetry(api, names);
+}
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"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"}

package/dist/replica/catalyst-replica.d.ts

@@ -2,6 +2,7 @@ import { type SqlExecutor, type IssueView, type IssueDetailView, type PullView,
 import { type AuthStrategy, type LiveSyncStatus, type LogLevel, type WebSocketFactory } from "../live-sync-client.js";
 import { type EngineFactory, type ReplicaEngine } from "./engine.js";
 import { type WriterGuardOptions } from "./writer-lock.js";
+import { type TelemetryConfig } from "../otel.js";
 export interface CatalystReplicaOptions {
     /** http(s) origin incl. any path prefix (…/api/v1); the scheme is swapped to ws(s) for /connect. */
     baseUrl: string;
@@ -37,6 +38,28 @@ export interface CatalystReplicaOptions {
      * `:memory:`. Default: enabled. Set `{ disabled: true }` to skip, `{ override: true }` to steal.
      */
     writerGuard?: WriterGuardOptions;
+    /**
+     * If set, `start()` rejects with a clear error if it doesn't reach `live` within this many ms (e.g.
+     * a wedged cold /snapshot), AFTER cleaning up — so a supervisor can fail-fast/restart instead of
+     * hanging. Off by default.
+     */
+    startTimeoutMs?: number;
+    /**
+     * Opt-in OpenTelemetry (CTC-138). `false`/absent = OFF (strictly zero overhead; no
+     * `@opentelemetry/api` import is even attempted). `true` = ON with the default `@catalyst-cloud/sdk`
+     * instrumentation scope; an object overrides the tracer/meter name. When ON the replica emits:
+     *   • SPANS  — `catalyst.replica.seed` (snapshot pull+apply), `catalyst.replica.apply_batch` (per
+     *     seed batch), plus the transport's `catalyst.replica.resync` + `catalyst.replica.reconnect`.
+     *   • METRICS — observable gauges `catalyst.replica.cursor`, `catalyst.replica.lag_seq` (only when
+     *     the mirror head_seq is known from the `x-catalyst-head-seq` /snapshot response header),
+     *     `catalyst.replica.freshness_ms`, `catalyst.replica.status`; a `catalyst.replica.applied`
+     *     counter (per live frame) and a `catalyst.replica.apply_batch_rows` histogram.
+     * All carry `catalyst.tenant` (+ `catalyst.source` where a single entity is involved). `@opentelemetry/api`
+     * is an OPTIONAL peer dep: enabling this without it installed logs once and runs no-op (never throws).
+     * Spans/metrics route through the consumer's GLOBAL TracerProvider/MeterProvider so their Resource
+     * (service.name) flows through.
+     */
+    telemetry?: TelemetryConfig;
 }
 /**
  * Options for a READ-ONLY reader ({@link CatalystReplica.openReadOnly}). A reader needs only the file
@@ -76,6 +99,19 @@ export declare class CatalystReplica {
      *  an initial seed failure. */
     private liveResolve;
     private liveReject;
+    /** Resolved once in start(); the no-op until then so any early metric/span call is safe. */
+    private telemetry;
+    /** Observable-gauge unregister handles, torn down in close() so a closed replica stops being scraped. */
+    private metricRegs;
+    /** Per-live-frame applied counter + per-seed-batch row histogram (no-op until telemetry is wired). */
+    private appliedCounter;
+    private applyBatchHistogram;
+    /** Last mirror head_seq + server clock observed from the `x-catalyst-head-seq` /snapshot headers
+     *  (CTC-137), or null until seen. Drives the `lag_seq` gauge (emitted ONLY when non-null). */
+    private lastHeadSeq;
+    private lastServerTimeMs;
+    /** Wall-clock ms of the last applied delta (live frame or seed), or null. Drives `freshness_ms`. */
+    private lastAppliedAtMs;
     constructor(opts: CatalystReplicaOptions);
     /**
      * Open a CatalystReplica as a READ-ONLY READER over a file another process owns as the WRITER
@@ -128,6 +164,15 @@ export declare class CatalystReplica {
     get status(): LiveSyncStatus;
     /** The raw driver Database the SDK owns — for `drizzle(replica.handle, { schema: mirrorSchema })`. */
     get handle(): unknown;
+    /** Ms since the last applied delta (live frame or seed), or null before the first apply. The basis
+     *  of the `catalyst.replica.freshness_ms` gauge — "how stale is the local copy right now". */
+    get freshnessMs(): number | null;
+    /** The last mirror head_seq read from the `x-catalyst-head-seq` /snapshot response header (CTC-137),
+     *  or null if the header has never been observed. `headSeq − cursor` is the replica's lag in seqs. */
+    get headSeq(): number | null;
+    /** The mirror server clock (ms) read from the `x-catalyst-server-time-ms` /snapshot response header
+     *  (CTC-137), or null if never observed — for a consumer that wants to estimate clock skew. */
+    get serverTimeMs(): number | null;
     private resolveEngine;
     /**
      * Open the read-only engine and wire ONLY the read ports — no migrations, no `sync_meta` DDL, no
@@ -138,6 +183,13 @@ export declare class CatalystReplica {
     private openReadOnlyInternal;
     private handleStatus;
     private clearLiveDeferred;
+    /**
+     * Register the four `catalyst.replica.*` observable gauges (whose async callbacks read live instance
+     * state) + create the per-frame counter and per-batch histogram. A no-op telemetry returns no-op
+     * instruments + empty registrations, so this is safe (and free) when telemetry is OFF. Idempotent
+     * per start(); the registrations are torn down in close().
+     */
+    private registerMetrics;
     /** Land one delta + advance the durable cursor atomically (a crash can't skip a seq), then signal. */
     private applyFrame;
     /**
@@ -148,6 +200,9 @@ export declare class CatalystReplica {
      * atomic truncate+apply+setCursor safety without holding one giant transaction.
      */
     private seedFromSnapshot;
+    /** Read CTC-137's `x-catalyst-head-seq` (+ `x-catalyst-server-time-ms`) off the /snapshot response,
+     *  if present. Guarded so a header-less test fetch stand-in is a no-op. */
+    private readHeadSeqHeaders;
     private feedHeaders;
 }
 //# sourceMappingURL=catalyst-replica.d.ts.map

package/dist/replica/catalyst-replica.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalyst-replica.d.ts","sourceRoot":"","sources":["../../src/replica/catalyst-replica.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalyst-replica.d.ts","sourceRoot":"","sources":["../../src/replica/catalyst-replica.ts"],"names":[],"mappings":"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"}