@foxford/den-traces 0.1.0-beta-3355e5f3-20260907

package/README.mdx

@@ -0,0 +1,55 @@
+---
+title: Den Traces
+---
+
+# @foxford/den-traces
+
+Метки времени, походы наружу и дев-трасса для den-приложений.
+
+**Спека пакета — [SPEC.md](SPEC.md)** (обязательна при правках). Ниже — быстрый старт.
+
+## Подключение
+
+1. Зависимость в приложении:
+
+```json
+"@foxford/den-traces": "^0.1.0"
+```
+
+2. Вызов в `den.config.ts`:
+
+```typescript
+import { defineAppConfig } from '@foxford/den/build'
+import { describeDeclarations, installServerTrace } from '@foxford/den-traces'
+import { installServerSentry } from '@foxford/den-sentry'
+
+export default defineAppConfig({
+  server: {
+    configure: (instance) => {
+      installServerTrace(instance, {
+        describe: async () => {
+          const { declarations } = await import('./src/declarations')
+          return describeDeclarations(declarations)
+        },
+      })
+      installServerSentry(instance, { appName: 'my-app', dsn: process.env.SENTRY_DSN })
+    },
+  },
+})
+```
+
+3. Импорты меток и походов — из подпути `./timings` (без серверных зависимостей):
+
+```typescript
+import { measure, trackFetch } from '@foxford/den-traces/timings'
+```
+
+`installServerTrace` ставит `setTimingSink` / `setRequestSink`. Приёмник upstream-ошибок
+(`setUpstreamErrorSink`) цепляет `installServerSentry`.
+
+## Экспорты
+
+| Путь | Содержимое |
+|---|---|
+| `@foxford/den-traces` | `installServerTrace`, `recordServerTiming`, `describeDeclarations`, sinks |
+| `@foxford/den-traces/timings` | `measure`, `trackFetch`, `setTimingSink`, `setRequestSink`, `setUpstreamErrorSink` |

package/chunk-F4ITEBDQ.cjs

@@ -0,0 +1,73 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/timings/index.ts
+var sink = null;
+var requestSink = null;
+var upstreamErrorSink = null;
+function setTimingSink(next) {
+  sink = next;
+}
+function setRequestSink(next) {
+  requestSink = next;
+}
+function setUpstreamErrorSink(next) {
+  upstreamErrorSink = next;
+}
+async function measure(name, work) {
+  if (sink === null) {
+    return work();
+  }
+  const startedAt = performance.now();
+  try {
+    return await work();
+  } finally {
+    sink(name, performance.now() - startedAt, startedAt);
+  }
+}
+async function trackFetch(name, url, init) {
+  const startedAt = performance.now();
+  try {
+    const response = await measure(name, () => fetch(url, init));
+    const length = response.headers.get("content-length");
+    _optionalChain([requestSink, 'optionalCall', _ => _({
+      bytes: length === null ? null : Number(length),
+      ms: performance.now() - startedAt,
+      name,
+      startedAt,
+      status: response.status,
+      url
+    })]);
+    if (!response.ok) {
+      _optionalChain([upstreamErrorSink, 'optionalCall', _2 => _2({
+        name,
+        reason: `http_${String(response.status)}`,
+        status: response.status,
+        url
+      })]);
+    }
+    return response;
+  } catch (error) {
+    _optionalChain([requestSink, 'optionalCall', _3 => _3({
+      bytes: null,
+      error: String(error),
+      ms: performance.now() - startedAt,
+      name,
+      startedAt,
+      status: null,
+      url
+    })]);
+    _optionalChain([upstreamErrorSink, 'optionalCall', _4 => _4({
+      name,
+      reason: "network",
+      status: null,
+      url
+    })]);
+    throw error;
+  }
+}
+
+
+
+
+
+
+
+exports.setTimingSink = setTimingSink; exports.setRequestSink = setRequestSink; exports.setUpstreamErrorSink = setUpstreamErrorSink; exports.measure = measure; exports.trackFetch = trackFetch;

package/chunk-HN4BBSRG.js

@@ -0,0 +1,73 @@
+// src/timings/index.ts
+var sink = null;
+var requestSink = null;
+var upstreamErrorSink = null;
+function setTimingSink(next) {
+  sink = next;
+}
+function setRequestSink(next) {
+  requestSink = next;
+}
+function setUpstreamErrorSink(next) {
+  upstreamErrorSink = next;
+}
+async function measure(name, work) {
+  if (sink === null) {
+    return work();
+  }
+  const startedAt = performance.now();
+  try {
+    return await work();
+  } finally {
+    sink(name, performance.now() - startedAt, startedAt);
+  }
+}
+async function trackFetch(name, url, init) {
+  const startedAt = performance.now();
+  try {
+    const response = await measure(name, () => fetch(url, init));
+    const length = response.headers.get("content-length");
+    requestSink?.({
+      bytes: length === null ? null : Number(length),
+      ms: performance.now() - startedAt,
+      name,
+      startedAt,
+      status: response.status,
+      url
+    });
+    if (!response.ok) {
+      upstreamErrorSink?.({
+        name,
+        reason: `http_${String(response.status)}`,
+        status: response.status,
+        url
+      });
+    }
+    return response;
+  } catch (error) {
+    requestSink?.({
+      bytes: null,
+      error: String(error),
+      ms: performance.now() - startedAt,
+      name,
+      startedAt,
+      status: null,
+      url
+    });
+    upstreamErrorSink?.({
+      name,
+      reason: "network",
+      status: null,
+      url
+    });
+    throw error;
+  }
+}
+
+export {
+  setTimingSink,
+  setRequestSink,
+  setUpstreamErrorSink,
+  measure,
+  trackFetch
+};

package/index.cjs

@@ -0,0 +1,97 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+var _chunkF4ITEBDQcjs = require('./chunk-F4ITEBDQ.cjs');
+
+// src/server/install.ts
+var _async_hooks = require('async_hooks');
+
+// src/server/trace.ts
+function nameOf(named) {
+  return _nullishCoalesce(named.token.description, () => ( "?"));
+}
+function describeDeclarations(app) {
+  return {
+    guards: (_nullishCoalesce(app.guards, () => ( []))).map(nameOf),
+    mountsInto: app.mountsInto,
+    name: app.name,
+    provides: (_nullishCoalesce(app.provides, () => ( []))).map(nameOf),
+    requires: (_nullishCoalesce(app.requires, () => ( []))).map((token) => token.description),
+    routes: (_nullishCoalesce(app.routes, () => ( []))).map(
+      (route) => typeof route === "string" ? { guards: [], source: route } : { guards: (_nullishCoalesce(route.guards, () => ( []))).map(nameOf), source: route.source }
+    ),
+    slots: Object.keys(_nullishCoalesce(app.slots, () => ( {}))),
+    units: (_nullishCoalesce(app.units, () => ( []))).map(nameOf),
+    viewModels: (_nullishCoalesce(app.viewModels, () => ( []))).map(nameOf)
+  };
+}
+var TRACE_LIMIT_BYTES = 8192;
+function traceHeader(requests, startedAt) {
+  const shift = (request) => ({
+    bytes: request.bytes,
+    ms: Number(request.ms.toFixed(1)),
+    name: request.name,
+    startMs: Number((request.startedAt - startedAt).toFixed(1)),
+    status: request.status,
+    url: request.url
+  });
+  let kept = requests.map(shift);
+  let encoded = Buffer.from(JSON.stringify({ requests: kept })).toString("base64");
+  while (encoded.length > TRACE_LIMIT_BYTES && kept.length > 0) {
+    kept = kept.slice(1);
+    encoded = Buffer.from(JSON.stringify({ requests: kept, truncated: true })).toString("base64");
+  }
+  return encoded;
+}
+function serverTimingHeader(marks) {
+  return marks.map(({ name, ms, startMs }) => `${name};dur=${ms.toFixed(1)};desc="@${startMs.toFixed(1)}"`).join(", ");
+}
+
+// src/server/install.ts
+var TRACE_HEADER = "x-den-trace";
+var storage = new (0, _async_hooks.AsyncLocalStorage)();
+function recordServerTiming(name, ms, startedAt) {
+  const timings = storage.getStore();
+  _optionalChain([timings, 'optionalAccess', _ => _.marks, 'access', _2 => _2.push, 'call', _3 => _3({ ms, name, startMs: (_nullishCoalesce(startedAt, () => ( performance.now() - ms))) - timings.startedAt })]);
+}
+function asked(headers) {
+  return headers[TRACE_HEADER] !== void 0;
+}
+function installServerTrace(instance, options = {}) {
+  _chunkF4ITEBDQcjs.setTimingSink.call(void 0, recordServerTiming);
+  _chunkF4ITEBDQcjs.setRequestSink.call(void 0, (request) => _optionalChain([storage, 'access', _4 => _4.getStore, 'call', _5 => _5(), 'optionalAccess', _6 => _6.requests, 'access', _7 => _7.push, 'call', _8 => _8(request)]));
+  instance.addHook("onRequest", (_request, _reply, done) => {
+    storage.run({ marks: [], requests: [], startedAt: performance.now() }, done);
+  });
+  instance.addHook("onSend", (request, reply, payload, done) => {
+    const timings = storage.getStore();
+    if (timings !== void 0 && timings.marks.length > 0) {
+      reply.header("server-timing", serverTimingHeader(timings.marks));
+    }
+    if (timings !== void 0 && asked(request.headers)) {
+      reply.header(TRACE_HEADER, traceHeader(timings.requests, timings.startedAt));
+    }
+    done(null, payload);
+  });
+  if (options.describe !== void 0 && instance.get !== void 0) {
+    const describe = options.describe;
+    instance.get(
+      "/_describe",
+      async (request, reply) => asked(request.headers) ? reply.code(200).send(await describe()) : reply.code(404).send()
+    );
+  }
+}
+
+
+
+
+
+
+
+
+
+
+exports.describeDeclarations = describeDeclarations; exports.installServerTrace = installServerTrace; exports.measure = _chunkF4ITEBDQcjs.measure; exports.recordServerTiming = recordServerTiming; exports.setRequestSink = _chunkF4ITEBDQcjs.setRequestSink; exports.setTimingSink = _chunkF4ITEBDQcjs.setTimingSink; exports.setUpstreamErrorSink = _chunkF4ITEBDQcjs.setUpstreamErrorSink; exports.traceHeader = traceHeader; exports.trackFetch = _chunkF4ITEBDQcjs.trackFetch;

package/index.d.cts

@@ -0,0 +1,90 @@
+import { TrackedRequest } from './timings/index.cjs';
+export { RequestSink, TimingSink, UpstreamErrorContext, UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch } from './timings/index.cjs';
+
+/**
+ * Хуки инстанса, которыми пользуется `@foxford/den`.
+ *
+ * Форма минимальная, а не `FastifyInstance`: сервер приложению даёт den, и fastify в
+ * зависимостях пакета не нужен.
+ */
+interface DenHookHost {
+    addHook(name: 'onRequest', hook: (request: unknown, reply: unknown, done: () => void) => void): unknown;
+    addHook(name: 'onSend', hook: (request: {
+        headers: Record<string, string | string[] | undefined>;
+    }, reply: {
+        header: (name: string, value: string) => unknown;
+    }, payload: unknown, done: (error: null, payload?: unknown) => void) => void): unknown;
+    get?(path: string, handler: (request: {
+        headers: Record<string, string | string[] | undefined>;
+    }, reply: {
+        code: (status: number) => {
+            send: (body?: unknown) => unknown;
+        };
+    }) => unknown): unknown;
+}
+interface InstallServerTraceOptions {
+    /** Ленивая отдача деклараций для `/_describe`; без неё ручка не регистрируется. */
+    describe?: () => Promise<Record<string, unknown>>;
+}
+
+/** Именованная штука дескриптора: единица, VM, возможность, guard — все различаются токеном. */
+interface Named {
+    token: {
+        description?: string;
+    };
+}
+/**
+ * Часть дескриптора, которую пересказывает ручка деклараций.
+ *
+ * Форма структурная, а не `AppDescriptor`: тип дескриптора параметризован узлом view-фреймворка,
+ * и, сославшись на него, серверный модуль потащил бы за собой рендерер. Пересказываются только
+ * ОБЪЯВЛЕНИЯ — ни одного поля с поведением здесь нет, и это же граница того, что вправе уехать
+ * наружу.
+ */
+interface Declarations {
+    name: string;
+    mountsInto?: string;
+    routes?: ReadonlyArray<string | {
+        source: string;
+        guards?: ReadonlyArray<Named>;
+    }>;
+    slots?: Record<string, unknown>;
+    units?: ReadonlyArray<Named>;
+    viewModels?: ReadonlyArray<Named>;
+    requires?: ReadonlyArray<{
+        description?: string;
+    }>;
+    provides?: ReadonlyArray<Named>;
+    guards?: ReadonlyArray<Named>;
+}
+/**
+ * Декларации дескриптора данными — то, чего у хоста нет и быть не может.
+ *
+ * @param app - Дескриптор приложения
+ */
+declare function describeDeclarations(app: Declarations): Record<string, unknown>;
+/**
+ * Дев-трасса запроса для заголовка: base64 от JSON.
+ *
+ * @param requests - Походы приложения за время запроса
+ * @param startedAt - Начало запроса по часам процесса
+ */
+declare function traceHeader(requests: readonly TrackedRequest[], startedAt: number): string;
+
+/**
+ * Записывает метку синхронной работы — рендера и всего, что меряется чужими часами.
+ *
+ * @param name - Имя метки
+ * @param ms - Длительность
+ * @param startedAt - Момент начала по часам процесса; по умолчанию — конец измеряемого куска
+ */
+declare function recordServerTiming(name: string, ms: number, startedAt?: number): void;
+/**
+ * Заводит сбор на инстансе приложения: метки, походы наружу и ручку деклараций.
+ *
+ * @param instance - Инстанс, на котором подняты ручки приложения
+ * @param options - Ленивая отдача деклараций для `/_describe`
+ */
+declare function installServerTrace(instance: DenHookHost, options?: InstallServerTraceOptions): void;
+
+export { type Declarations, type DenHookHost, type InstallServerTraceOptions, TrackedRequest, describeDeclarations, installServerTrace, recordServerTiming, traceHeader };

package/index.d.ts

@@ -0,0 +1,90 @@
+import { TrackedRequest } from './timings/index.js';
+export { RequestSink, TimingSink, UpstreamErrorContext, UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch } from './timings/index.js';
+
+/**
+ * Хуки инстанса, которыми пользуется `@foxford/den`.
+ *
+ * Форма минимальная, а не `FastifyInstance`: сервер приложению даёт den, и fastify в
+ * зависимостях пакета не нужен.
+ */
+interface DenHookHost {
+    addHook(name: 'onRequest', hook: (request: unknown, reply: unknown, done: () => void) => void): unknown;
+    addHook(name: 'onSend', hook: (request: {
+        headers: Record<string, string | string[] | undefined>;
+    }, reply: {
+        header: (name: string, value: string) => unknown;
+    }, payload: unknown, done: (error: null, payload?: unknown) => void) => void): unknown;
+    get?(path: string, handler: (request: {
+        headers: Record<string, string | string[] | undefined>;
+    }, reply: {
+        code: (status: number) => {
+            send: (body?: unknown) => unknown;
+        };
+    }) => unknown): unknown;
+}
+interface InstallServerTraceOptions {
+    /** Ленивая отдача деклараций для `/_describe`; без неё ручка не регистрируется. */
+    describe?: () => Promise<Record<string, unknown>>;
+}
+
+/** Именованная штука дескриптора: единица, VM, возможность, guard — все различаются токеном. */
+interface Named {
+    token: {
+        description?: string;
+    };
+}
+/**
+ * Часть дескриптора, которую пересказывает ручка деклараций.
+ *
+ * Форма структурная, а не `AppDescriptor`: тип дескриптора параметризован узлом view-фреймворка,
+ * и, сославшись на него, серверный модуль потащил бы за собой рендерер. Пересказываются только
+ * ОБЪЯВЛЕНИЯ — ни одного поля с поведением здесь нет, и это же граница того, что вправе уехать
+ * наружу.
+ */
+interface Declarations {
+    name: string;
+    mountsInto?: string;
+    routes?: ReadonlyArray<string | {
+        source: string;
+        guards?: ReadonlyArray<Named>;
+    }>;
+    slots?: Record<string, unknown>;
+    units?: ReadonlyArray<Named>;
+    viewModels?: ReadonlyArray<Named>;
+    requires?: ReadonlyArray<{
+        description?: string;
+    }>;
+    provides?: ReadonlyArray<Named>;
+    guards?: ReadonlyArray<Named>;
+}
+/**
+ * Декларации дескриптора данными — то, чего у хоста нет и быть не может.
+ *
+ * @param app - Дескриптор приложения
+ */
+declare function describeDeclarations(app: Declarations): Record<string, unknown>;
+/**
+ * Дев-трасса запроса для заголовка: base64 от JSON.
+ *
+ * @param requests - Походы приложения за время запроса
+ * @param startedAt - Начало запроса по часам процесса
+ */
+declare function traceHeader(requests: readonly TrackedRequest[], startedAt: number): string;
+
+/**
+ * Записывает метку синхронной работы — рендера и всего, что меряется чужими часами.
+ *
+ * @param name - Имя метки
+ * @param ms - Длительность
+ * @param startedAt - Момент начала по часам процесса; по умолчанию — конец измеряемого куска
+ */
+declare function recordServerTiming(name: string, ms: number, startedAt?: number): void;
+/**
+ * Заводит сбор на инстансе приложения: метки, походы наружу и ручку деклараций.
+ *
+ * @param instance - Инстанс, на котором подняты ручки приложения
+ * @param options - Ленивая отдача деклараций для `/_describe`
+ */
+declare function installServerTrace(instance: DenHookHost, options?: InstallServerTraceOptions): void;
+
+export { type Declarations, type DenHookHost, type InstallServerTraceOptions, TrackedRequest, describeDeclarations, installServerTrace, recordServerTiming, traceHeader };

package/index.js

@@ -0,0 +1,97 @@
+import {
+  measure,
+  setRequestSink,
+  setTimingSink,
+  setUpstreamErrorSink,
+  trackFetch
+} from "./chunk-HN4BBSRG.js";
+
+// src/server/install.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/server/trace.ts
+function nameOf(named) {
+  return named.token.description ?? "?";
+}
+function describeDeclarations(app) {
+  return {
+    guards: (app.guards ?? []).map(nameOf),
+    mountsInto: app.mountsInto,
+    name: app.name,
+    provides: (app.provides ?? []).map(nameOf),
+    requires: (app.requires ?? []).map((token) => token.description),
+    routes: (app.routes ?? []).map(
+      (route) => typeof route === "string" ? { guards: [], source: route } : { guards: (route.guards ?? []).map(nameOf), source: route.source }
+    ),
+    slots: Object.keys(app.slots ?? {}),
+    units: (app.units ?? []).map(nameOf),
+    viewModels: (app.viewModels ?? []).map(nameOf)
+  };
+}
+var TRACE_LIMIT_BYTES = 8192;
+function traceHeader(requests, startedAt) {
+  const shift = (request) => ({
+    bytes: request.bytes,
+    ms: Number(request.ms.toFixed(1)),
+    name: request.name,
+    startMs: Number((request.startedAt - startedAt).toFixed(1)),
+    status: request.status,
+    url: request.url
+  });
+  let kept = requests.map(shift);
+  let encoded = Buffer.from(JSON.stringify({ requests: kept })).toString("base64");
+  while (encoded.length > TRACE_LIMIT_BYTES && kept.length > 0) {
+    kept = kept.slice(1);
+    encoded = Buffer.from(JSON.stringify({ requests: kept, truncated: true })).toString("base64");
+  }
+  return encoded;
+}
+function serverTimingHeader(marks) {
+  return marks.map(({ name, ms, startMs }) => `${name};dur=${ms.toFixed(1)};desc="@${startMs.toFixed(1)}"`).join(", ");
+}
+
+// src/server/install.ts
+var TRACE_HEADER = "x-den-trace";
+var storage = new AsyncLocalStorage();
+function recordServerTiming(name, ms, startedAt) {
+  const timings = storage.getStore();
+  timings?.marks.push({ ms, name, startMs: (startedAt ?? performance.now() - ms) - timings.startedAt });
+}
+function asked(headers) {
+  return headers[TRACE_HEADER] !== void 0;
+}
+function installServerTrace(instance, options = {}) {
+  setTimingSink(recordServerTiming);
+  setRequestSink((request) => storage.getStore()?.requests.push(request));
+  instance.addHook("onRequest", (_request, _reply, done) => {
+    storage.run({ marks: [], requests: [], startedAt: performance.now() }, done);
+  });
+  instance.addHook("onSend", (request, reply, payload, done) => {
+    const timings = storage.getStore();
+    if (timings !== void 0 && timings.marks.length > 0) {
+      reply.header("server-timing", serverTimingHeader(timings.marks));
+    }
+    if (timings !== void 0 && asked(request.headers)) {
+      reply.header(TRACE_HEADER, traceHeader(timings.requests, timings.startedAt));
+    }
+    done(null, payload);
+  });
+  if (options.describe !== void 0 && instance.get !== void 0) {
+    const describe = options.describe;
+    instance.get(
+      "/_describe",
+      async (request, reply) => asked(request.headers) ? reply.code(200).send(await describe()) : reply.code(404).send()
+    );
+  }
+}
+export {
+  describeDeclarations,
+  installServerTrace,
+  measure,
+  recordServerTiming,
+  setRequestSink,
+  setTimingSink,
+  setUpstreamErrorSink,
+  traceHeader,
+  trackFetch
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@foxford/den-traces",
+  "version": "0.1.0-beta-3355e5f3-20260907",
+  "description": "Метки времени, походы наружу и дев-трасса для den-приложений",
+  "keywords": [
+    "foxford",
+    "den",
+    "traces",
+    "server-timing",
+    "observability"
+  ],
+  "homepage": "https://github.com/foxford/frontend-platform",
+  "bugs": "https://github.com/foxford/frontend-platform/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/foxford/frontend-platform.git",
+    "directory": "packages/den-traces"
+  },
+  "license": "MIT",
+  "author": "Foxford Co",
+  "maintainers": [
+    {
+      "name": "Denis Riabov",
+      "email": "d.a.riabov@foxford.ru",
+      "team": "core-frontend"
+    },
+    {
+      "name": "Roman Olin",
+      "email": "r.v.olin@foxford.ru",
+      "team": "core-frontend"
+    }
+  ],
+  "type": "module",
+  "peerDependencies": {
+    "@foxford/den": "^3.3.0"
+  },
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
+    },
+    "./timings": {
+      "import": "./timings/index.js",
+      "require": "./timings/index.cjs",
+      "types": "./timings/index.d.ts"
+    }
+  },
+  "files": [
+    "README.mdx",
+    "chunk-F4ITEBDQ.cjs",
+    "chunk-HN4BBSRG.js",
+    "index.cjs",
+    "index.d.cts",
+    "index.d.ts",
+    "index.js",
+    "package.json",
+    "timings"
+  ],
+  "sha": "3355e5f3",
+  "scripts": {}
+}

package/timings/index.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkF4ITEBDQcjs = require('../chunk-F4ITEBDQ.cjs');
+
+
+
+
+
+
+exports.measure = _chunkF4ITEBDQcjs.measure; exports.setRequestSink = _chunkF4ITEBDQcjs.setRequestSink; exports.setTimingSink = _chunkF4ITEBDQcjs.setTimingSink; exports.setUpstreamErrorSink = _chunkF4ITEBDQcjs.setUpstreamErrorSink; exports.trackFetch = _chunkF4ITEBDQcjs.trackFetch;

package/timings/index.d.cts

@@ -0,0 +1,48 @@
+/** Контекст сбоя upstream для приёмника ошибок. */
+interface UpstreamErrorContext {
+    name: string;
+    reason: string;
+    status?: number | null;
+    url: string;
+}
+/**
+ * Куда уходят метки: имя куска работы, его длительность и момент начала.
+ *
+ * Начало нужно потому, что куски вложены друг в друга и идут внахлёст: по одним длительностям
+ * «ручка страницы 80 мс» и «ручка меню 187 мс» читаются как 267 мс работы, тогда как второй
+ * запрос эти 80 мс просто ждал своей очереди.
+ */
+type TimingSink = (name: string, ms: number, startedAt: number) => void;
+/** Поход приложения наружу: куда ходили и чем кончилось. */
+interface TrackedRequest {
+    /** Имя куска работы — то же, что у метки времени. */
+    name: string;
+    url: string;
+    status: number | null;
+    ms: number;
+    startedAt: number;
+    /** Размер ответа по `content-length`; `null` — бэкенд его не прислал. */
+    bytes: number | null;
+    error?: string;
+}
+/**
+ * Куда уходят походы наружу.
+ *
+ * Отдельно от меток, хотя момент один: метка отвечает «сколько заняло», поход — «куда ходили
+ * и что ответили». Первое уезжает хосту заголовком `Server-Timing` всегда, второе — только
+ * когда хост попросил, и только в разработке.
+ */
+type RequestSink = (request: TrackedRequest) => void;
+type UpstreamErrorSink = (context: UpstreamErrorContext) => void;
+/** Ставит приёмник меток; `null` — снимает. */
+declare function setTimingSink(next: TimingSink | null): void;
+/** Ставит приёмник походов наружу; `null` — снимает. */
+declare function setRequestSink(next: RequestSink | null): void;
+/** Ставит приёмник upstream-ошибок; `null` — снимает. */
+declare function setUpstreamErrorSink(next: UpstreamErrorSink | null): void;
+/** Измеряет работу и отдаёт её длительность приёмнику. */
+declare function measure<T>(name: string, work: () => Promise<T>): Promise<T>;
+/** Ходит в ручку и рассказывает о походе: длительность — меткой, адрес и исход — приёмнику. */
+declare function trackFetch(name: string, url: string, init?: RequestInit): Promise<Response>;
+
+export { type RequestSink, type TimingSink, type TrackedRequest, type UpstreamErrorContext, type UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch };

package/timings/index.d.ts

@@ -0,0 +1,48 @@
+/** Контекст сбоя upstream для приёмника ошибок. */
+interface UpstreamErrorContext {
+    name: string;
+    reason: string;
+    status?: number | null;
+    url: string;
+}
+/**
+ * Куда уходят метки: имя куска работы, его длительность и момент начала.
+ *
+ * Начало нужно потому, что куски вложены друг в друга и идут внахлёст: по одним длительностям
+ * «ручка страницы 80 мс» и «ручка меню 187 мс» читаются как 267 мс работы, тогда как второй
+ * запрос эти 80 мс просто ждал своей очереди.
+ */
+type TimingSink = (name: string, ms: number, startedAt: number) => void;
+/** Поход приложения наружу: куда ходили и чем кончилось. */
+interface TrackedRequest {
+    /** Имя куска работы — то же, что у метки времени. */
+    name: string;
+    url: string;
+    status: number | null;
+    ms: number;
+    startedAt: number;
+    /** Размер ответа по `content-length`; `null` — бэкенд его не прислал. */
+    bytes: number | null;
+    error?: string;
+}
+/**
+ * Куда уходят походы наружу.
+ *
+ * Отдельно от меток, хотя момент один: метка отвечает «сколько заняло», поход — «куда ходили
+ * и что ответили». Первое уезжает хосту заголовком `Server-Timing` всегда, второе — только
+ * когда хост попросил, и только в разработке.
+ */
+type RequestSink = (request: TrackedRequest) => void;
+type UpstreamErrorSink = (context: UpstreamErrorContext) => void;
+/** Ставит приёмник меток; `null` — снимает. */
+declare function setTimingSink(next: TimingSink | null): void;
+/** Ставит приёмник походов наружу; `null` — снимает. */
+declare function setRequestSink(next: RequestSink | null): void;
+/** Ставит приёмник upstream-ошибок; `null` — снимает. */
+declare function setUpstreamErrorSink(next: UpstreamErrorSink | null): void;
+/** Измеряет работу и отдаёт её длительность приёмнику. */
+declare function measure<T>(name: string, work: () => Promise<T>): Promise<T>;
+/** Ходит в ручку и рассказывает о походе: длительность — меткой, адрес и исход — приёмнику. */
+declare function trackFetch(name: string, url: string, init?: RequestInit): Promise<Response>;
+
+export { type RequestSink, type TimingSink, type TrackedRequest, type UpstreamErrorContext, type UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch };

package/timings/index.js

@@ -0,0 +1,14 @@
+import {
+  measure,
+  setRequestSink,
+  setTimingSink,
+  setUpstreamErrorSink,
+  trackFetch
+} from "../chunk-HN4BBSRG.js";
+export {
+  measure,
+  setRequestSink,
+  setTimingSink,
+  setUpstreamErrorSink,
+  trackFetch
+};