@runlot/api 0.1.0-rc.163 → 0.1.0-rc.164

package/dist/index.js

@@ -16,6 +16,15 @@ function gitQuery(ref, path) {
         q.set("path", path);
     return q.size > 0 ? `?${q.toString()}` : "";
 }
+function obsProfileQS(q = {}) {
+    const p = new URLSearchParams();
+    for (const [k, v] of Object.entries(q)) {
+        if (v !== undefined && v !== "")
+            p.set(k, String(v));
+    }
+    const s = p.toString();
+    return s ? `?${s}` : "";
+}
 export const API_SCOPES = [
     "project:read",
     "deploy",
@@ -512,6 +521,100 @@ export class Client {
     getErrorAlertMail(org, name) { return this.json("GET", `${this.projectPath(org, name)}/error-alerts/mail`); }
     putErrorAlertMail(org, name, preference) { return this.json("PUT", `${this.projectPath(org, name)}/error-alerts/mail`, preference); }
     listErrorAlertDeliveries(org, name) { return this.json("GET", `${this.projectPath(org, name)}/error-alerts/deliveries`); }
+    // Monitors, downtimes and SLOs (docs/customer-observability.md §17.8, §17.9).
+    // Destinations are the error-alert destinations above, shared by both.
+    listMonitors(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/monitors`); }
+    exportMonitors(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/monitors/export`); }
+    getMonitor(org, name, id) { return this.json("GET", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}`); }
+    putMonitor(org, name, id, monitor) { return this.json("PUT", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}`, monitor); }
+    deleteMonitor(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}`); }
+    getMonitorHistory(org, name, id, limit) {
+        const q = limit ? `?limit=${encodeURIComponent(String(limit))}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}/history${q}`);
+    }
+    testMonitor(org, name, id) { return this.json("POST", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}/test`); }
+    listDowntimes(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/downtimes`); }
+    putDowntime(org, name, id, downtime) { return this.json("PUT", `${this.projectPath(org, name)}/observability/downtimes/${encodeURIComponent(id)}`, downtime); }
+    deleteDowntime(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/observability/downtimes/${encodeURIComponent(id)}`); }
+    listSLOs(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/slos`); }
+    getSLO(org, name, id) { return this.json("GET", `${this.projectPath(org, name)}/observability/slos/${encodeURIComponent(id)}`); }
+    putSLO(org, name, id, slo) { return this.json("PUT", `${this.projectPath(org, name)}/observability/slos/${encodeURIComponent(id)}`, slo); }
+    deleteSLO(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/observability/slos/${encodeURIComponent(id)}`); }
+    /**
+     * Observability access and governance (customer-observability.md §12, §16, §17.15):
+     * the caller's grants, per-project role overrides, the audit trail, the data page,
+     * caps, export destinations and rehydration.
+     */
+    getObservabilityPermissions(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/permissions`);
+    }
+    listObservabilityRoles(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/roles`);
+    }
+    putObservabilityRole(org, name, userId, grants) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/roles/${encodeURIComponent(userId)}`, { grants });
+    }
+    deleteObservabilityRole(org, name, userId) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/roles/${encodeURIComponent(userId)}`);
+    }
+    listObservabilityAudit(org, name, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        if (opts.before !== undefined)
+            q.set("before", opts.before);
+        const qs = q.size > 0 ? `?${q.toString()}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/observability/audit${qs}`);
+    }
+    getObservabilityData(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/data`);
+    }
+    getObservabilityCaps(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/caps`);
+    }
+    /** Named meters only: a number, -1 (no cap, Pro) or null (the plan's included amount). */
+    putObservabilityCaps(org, name, caps) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/caps`, caps);
+    }
+    listObservabilityExports(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/exports`);
+    }
+    getObservabilityExport(org, name, exportId) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/exports/${encodeURIComponent(exportId)}`);
+    }
+    createObservabilityExport(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/exports`, input);
+    }
+    updateObservabilityExport(org, name, exportId, input) {
+        return this.json("PATCH", `${this.projectPath(org, name)}/observability/exports/${encodeURIComponent(exportId)}`, input);
+    }
+    deleteObservabilityExport(org, name, exportId) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/exports/${encodeURIComponent(exportId)}`);
+    }
+    listObservabilityRehydrations(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rehydrations`);
+    }
+    getObservabilityRehydration(org, name, jobId) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rehydrations/${encodeURIComponent(jobId)}`);
+    }
+    /** Loads an archived range back for seven days; the answer is the queued job. */
+    createObservabilityRehydration(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/rehydrations`, input);
+    }
+    /** `runlot bug-report` (customer-observability.md §14): the CP snapshots what the references name. */
+    createBugReport(org, input) {
+        return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/bug-reports`, input);
+    }
+    listBugReports(org) {
+        return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/bug-reports`);
+    }
+    getBugReport(org, reportId, opts = {}) {
+        const qs = opts.snapshot === false ? "?snapshot=0" : "";
+        return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/bug-reports/${encodeURIComponent(reportId)}${qs}`);
+    }
+    deleteBugReport(org, reportId) {
+        return this.json("DELETE", `/v1/orgs/${encodeURIComponent(org)}/bug-reports/${encodeURIComponent(reportId)}`);
+    }
     /** Synthetic HTTP checks of the project's own addresses (customer-observability.md §17.11). */
     listUptimeChecks(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/uptime-checks`);
@@ -526,6 +629,224 @@ export class Client {
         const qs = limit !== undefined ? `?limit=${encodeURIComponent(String(limit))}` : "";
         return this.json("GET", `${this.projectPath(org, name)}/uptime-checks/${encodeURIComponent(id)}/runs${qs}`);
     }
+    /** Dashboards (customer-observability.md §17.7). A built-in's id is `builtin:<key>`. */
+    listDashboards(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboards`);
+    }
+    createDashboard(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/dashboards`, input);
+    }
+    getDashboard(org, name, id) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}`);
+    }
+    putDashboard(org, name, id, input) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}`, input);
+    }
+    deleteDashboard(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}`);
+    }
+    /** The `.runlot/dashboards/<key>.json` form of a dashboard. */
+    exportDashboard(org, name, id) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/export`);
+    }
+    /** Make (or rotate) the public link; the token is shown once. */
+    shareDashboard(org, name, id, isPublic = true) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/share`, { public: isPublic });
+    }
+    unshareDashboard(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/share`);
+    }
+    getDashboardWidgetData(org, name, id, widgetId, req = {}) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/widgets/${encodeURIComponent(widgetId)}/data`, req);
+    }
+    getDashboardSettings(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboard-settings`);
+    }
+    putDashboardSettings(org, name, settings) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/dashboard-settings`, settings);
+    }
+    /** Deploy and OOM markers for every time series. */
+    getObservabilityMarkers(org, name, range = {}) {
+        const q = new URLSearchParams();
+        if (range.from)
+            q.set("from", range.from);
+        if (range.to)
+            q.set("to", range.to);
+        const qs = q.toString();
+        return this.json("GET", `${this.projectPath(org, name)}/observability/markers${qs ? `?${qs}` : ""}`);
+    }
+    /** Watchdog insights (§17.10). Free: deploy regressions only. */
+    listInsights(org, name, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.state)
+            q.set("state", opts.state);
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        const qs = q.toString();
+        return this.json("GET", `${this.projectPath(org, name)}/observability/insights${qs ? `?${qs}` : ""}`);
+    }
+    resolveInsight(org, name, id) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/insights/${encodeURIComponent(id)}/resolve`);
+    }
+    /** Synthetic checks (§17.11): the uptime checks, including multi-step API checks. */
+    listSynthetics(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/synthetics`);
+    }
+    putSynthetic(org, name, id, input) {
+        return this.json("PUT", `${this.projectPath(org, name)}/synthetics/${encodeURIComponent(id)}`, input);
+    }
+    deleteSynthetic(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/synthetics/${encodeURIComponent(id)}`);
+    }
+    listSyntheticRuns(org, name, id, limit) {
+        const qs = limit !== undefined ? `?limit=${encodeURIComponent(String(limit))}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/synthetics/${encodeURIComponent(id)}/runs${qs}`);
+    }
+    /** A public dashboard link. Needs no credential. */
+    getSharedDashboard(token) {
+        return this.json("GET", `/v1/shared/dashboards/${encodeURIComponent(token)}`);
+    }
+    getSharedDashboardWidgetData(token, widgetId, req = {}) {
+        return this.json("POST", `/v1/shared/dashboards/${encodeURIComponent(token)}/widgets/${encodeURIComponent(widgetId)}/data`, req);
+    }
+    // Customer observability, APM read side (docs/customer-observability.md §8, §17.2–§17.4,
+    // §17.6). Range options are RFC 3339 times; `step` is seconds or a duration ("5m").
+    obsApmPath(org, name, sub, q) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(q ?? {}))
+            if (v !== undefined && v !== "")
+                qs.set(k, String(v));
+        const tail = qs.size > 0 ? `?${qs}` : "";
+        return `${this.projectPath(org, name)}/observability/${sub}${tail}`;
+    }
+    getObsMetricsOverview(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/overview", opts));
+    }
+    getObsMetricsMemory(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/memory", opts));
+    }
+    getObsMetricsInfrastructure(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/infrastructure", opts));
+    }
+    getObsMetricsCustom(org, name, opts) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/custom", opts));
+    }
+    getObsMetricsCustomNames(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/custom/names"));
+    }
+    listObsRoutes(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "routes"));
+    }
+    putObsRoute(org, name, input) {
+        return this.json("PUT", this.obsApmPath(org, name, "routes"), input);
+    }
+    getObsAPMRoutes(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/routes", opts));
+    }
+    getObsAPMBreakdown(org, name, route, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, `apm/routes/${encodeURIComponent(route)}/breakdown`, opts));
+    }
+    getObsAPMServiceMap(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/service-map", opts));
+    }
+    getObsAPMCompare(org, name, a, b, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/compare", { ...opts, a, b }));
+    }
+    listObsAPMTraces(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/traces", opts));
+    }
+    getObsAPMTrace(org, name, traceId) {
+        return this.json("GET", this.obsApmPath(org, name, `apm/traces/${encodeURIComponent(traceId)}`));
+    }
+    listObsTraceFilters(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "trace-filters"));
+    }
+    createObsTraceFilter(org, name, input) {
+        return this.json("POST", this.obsApmPath(org, name, "trace-filters"), input);
+    }
+    updateObsTraceFilter(org, name, id, input) {
+        return this.json("PUT", this.obsApmPath(org, name, `trace-filters/${encodeURIComponent(id)}`), input);
+    }
+    deleteObsTraceFilter(org, name, id) {
+        return this.json("DELETE", this.obsApmPath(org, name, `trace-filters/${encodeURIComponent(id)}`));
+    }
+    listObsDBQueries(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "database/queries", opts));
+    }
+    getObsDBQuery(org, name, fingerprint, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, `database/queries/${encodeURIComponent(fingerprint)}`, opts));
+    }
+    getObsDBHealth(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "database/health"));
+    }
+    /** The continuous profiler's switch (customer-observability.md §17.13). */
+    getObsProfilerSettings(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiler`);
+    }
+    /** On, off, or null for the default. Applies from the next deployment or restart. Admin. */
+    putObsProfilerSettings(org, name, enabled) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/profiler`, { enabled });
+    }
+    /** The logs/traces sampling override; a null field is the manifest's. */
+    getObsSampling(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/sampling`);
+    }
+    /** Replaces the override (null = the manifest's). Admin. */
+    putObsSampling(org, name, body) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/sampling`, body);
+    }
+    listObsProfiles(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles${obsProfileQS({ ...q })}`);
+    }
+    /** The windows within a minute of `ts` — the profile of a slow trace's minute. */
+    nearObsProfiles(org, name, ts) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/near${obsProfileQS({ ts })}`);
+    }
+    getObsFlamegraph(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/flamegraph${obsProfileQS({ ...q })}`);
+    }
+    getObsProfileTop(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/top${obsProfileQS({ ...q })}`);
+    }
+    /** Self-time share per function, version a against version b. */
+    compareObsProfiles(org, name, a, b, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/compare${obsProfileQS({ a, b, ...q })}`);
+    }
+    /** RUM: page views, sessions and p75 vitals over time (Pro). */
+    getObsRUMOverview(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/overview${obsProfileQS({ ...q })}`);
+    }
+    /** RUM by page template, with vitals, long tasks and resource/fetch timings (Pro). */
+    listObsRUMPages(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/pages${obsProfileQS({ ...q })}`);
+    }
+    /** RUM by device class (Pro). */
+    listObsRUMDevices(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/devices${obsProfileQS({ ...q })}`);
+    }
+    /** RUM page views, newest (or slowest LCP) first (Pro). */
+    listObsRUMViews(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/views${obsProfileQS({ ...q })}`);
+    }
+    /** One page view and the server requests it caused (Pro). */
+    getObsRUMView(org, name, viewId) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/views/${encodeURIComponent(viewId)}`);
+    }
+    /** Starts one heap snapshot (Pro, admin; pauses the app while taken). Poll the list. */
+    createObsHeapSnapshot(org, name) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/heap-snapshots`, {});
+    }
+    listObsHeapSnapshots(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/heap-snapshots`);
+    }
+    /** The download URL of a ready snapshot (a `.heapsnapshot` file). */
+    obsHeapSnapshotURL(org, name, snapshotId) {
+        return new URL(`${this.projectPath(org, name)}/observability/heap-snapshots/${encodeURIComponent(snapshotId)}`, this.opts.baseUrl).toString();
+    }
+    /** A ready snapshot's text (Chrome DevTools heap snapshot JSON). */
+    downloadObsHeapSnapshot(org, name, snapshotId) {
+        return this.text("GET", `${this.projectPath(org, name)}/observability/heap-snapshots/${encodeURIComponent(snapshotId)}`);
+    }
     getErrorOwnership(org, name) {
         return this.json("GET", `${this.projectPath(org, name)}/errors-ownership`);
     }
@@ -541,6 +862,79 @@ export class Client {
     putErrorCapturePolicy(org, name, policy, acknowledgePII = false) {
         return this.json("PUT", `${this.projectPath(org, name)}/errors-capture-policy`, { policy, acknowledgePII });
     }
+    // ---- Observability (docs/customer-observability.md §7, §17.5) ----
+    obsPath(org, name) {
+        return `${this.projectPath(org, name)}/observability`;
+    }
+    getObservabilityCapabilities(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/capabilities`);
+    }
+    /** Runs a query; `{ available: false }` where there is no event store. */
+    queryObservability(org, name, query) {
+        return this.json("POST", `${this.obsPath(org, name)}/query`, query);
+    }
+    listObservabilityKeys(org, name, opts = {}) {
+        return this.json("GET", `${this.obsPath(org, name)}/keys${obsQS(opts)}`);
+    }
+    listObservabilityValues(org, name, key, opts = {}) {
+        return this.json("GET", `${this.obsPath(org, name)}/values${obsQS({ ...opts, key })}`);
+    }
+    listObservabilityPatterns(org, name, opts = {}) {
+        return this.json("GET", `${this.obsPath(org, name)}/patterns${obsQS(opts)}`);
+    }
+    getObservabilityRequest(org, name, requestId) {
+        return this.json("GET", `${this.obsPath(org, name)}/requests/${encodeURIComponent(requestId)}`);
+    }
+    listSavedQueries(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/saved-queries`);
+    }
+    getSavedQuery(org, name, queryId) {
+        return this.json("GET", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}`);
+    }
+    createSavedQuery(org, name, input) {
+        return this.json("POST", `${this.obsPath(org, name)}/saved-queries`, input);
+    }
+    updateSavedQuery(org, name, queryId, input) {
+        return this.json("PUT", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}`, input);
+    }
+    deleteSavedQuery(org, name, queryId) {
+        return this.json("DELETE", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}`);
+    }
+    starSavedQuery(org, name, queryId) {
+        return this.json("PUT", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}/star`);
+    }
+    unstarSavedQuery(org, name, queryId) {
+        return this.json("DELETE", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}/star`);
+    }
+    getObservabilityPipeline(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/pipeline`);
+    }
+    putObservabilityPipeline(org, name, processors) {
+        return this.json("PUT", `${this.obsPath(org, name)}/pipeline`, { processors });
+    }
+    getObservabilityScanner(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/scanner`);
+    }
+    putObservabilityScanner(org, name, scanner) {
+        return this.json("PUT", `${this.obsPath(org, name)}/scanner`, scanner);
+    }
+    /** Runs a scanner (the project's, or `scanner`) over a sample; nothing is stored. */
+    testObservabilityScanner(org, name, text, scanner) {
+        return this.json("POST", `${this.obsPath(org, name)}/scanner/test`, scanner ? { text, scanner } : { text });
+    }
+    /** The whole ingest configuration, shaped as `.runlot/logs.json`. */
+    exportObservabilityLogsConfig(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/logs-config`);
+    }
+    listObservabilityLogMetrics(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/log-metrics`);
+    }
+    putObservabilityLogMetric(org, name, metric, def) {
+        return this.json("PUT", `${this.obsPath(org, name)}/log-metrics/${encodeURIComponent(metric)}`, def);
+    }
+    deleteObservabilityLogMetric(org, name, metric) {
+        return this.json("DELETE", `${this.obsPath(org, name)}/log-metrics/${encodeURIComponent(metric)}`);
+    }
     getErrorEventPII(org, name, issueId, eventId) {
         return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/events/${encodeURIComponent(eventId)}?includePII=true`);
     }
@@ -932,11 +1326,31 @@ export class Client {
      * (4xx/5xx) is the same `ApiError` as in every other method.
      */
     async *tailLogs(org, name, opts = {}) {
+        yield* this.tailStream(org, name, opts, undefined);
+    }
+    /**
+     * The live tail as `LogRecord`s — the stored event's shape (`--format json`).
+     * Pings and the end event still arrive as `LogEvent`s.
+     */
+    async *tailLogRecords(org, name, opts = {}) {
+        yield* this.tailStream(org, name, opts, "json");
+    }
+    async *tailStream(org, name, opts, format) {
         const q = new URLSearchParams();
         if (opts.tail !== undefined)
             q.set("tail", String(opts.tail));
         if (opts.follow !== undefined)
             q.set("follow", String(opts.follow));
+        if (opts.level)
+            q.set("level", opts.level);
+        if (opts.source)
+            q.set("source", opts.source);
+        if (opts.q)
+            q.set("q", opts.q);
+        if (opts.requestId)
+            q.set("requestId", opts.requestId);
+        if (format)
+            q.set("format", format);
         const path = `${this.projectPath(org, name)}/logs${q.size ? `?${q}` : ""}`;
         const res = await fetch(new URL(path, this.opts.baseUrl), {
             method: "GET",
@@ -1645,4 +2059,12 @@ export class Client {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/rollback`, { version });
     }
 }
+/** A query string from the defined, non-empty options. */
+function obsQS(opts) {
+    const q = new URLSearchParams();
+    for (const [k, v] of Object.entries(opts))
+        if (v)
+            q.set(k, v);
+    return q.size ? `?${q}` : "";
+}
 //# sourceMappingURL=index.js.map