@foxford/den-traces 0.1.0 → 2.0.0

package/README.mdx

@@ -41,9 +41,26 @@ export default defineAppConfig({
 3. Импорты меток и походов — из подпути `./timings` (без серверных зависимостей):
 
 ```typescript
-import { measure, trackFetch } from '@foxford/den-traces/timings'
+import { measure, startRequest } from '@foxford/den-traces/timings'
 ```
 
+`startRequest(name, url)` начинает поход наружу и отдаёт `RequestSpan`: `finish(status, bytes?)` —
+ответ получен, `fail(error)` — до ответа не дошли. Транспорта пакет не знает: кто ходил, тот и
+сообщает о походе — клиент `@foxford/services` через плагины ниже, всё остальное — этой парой
+вызовов вокруг своего запроса.
+
+4. Приложение, которое ходит в бэкенд клиентом `@foxford/services` (в том числе SDK
+`@foxford/sdk`), подключает плагины сбора из подпути `./services` — тогда каждый запрос
+клиента становится походом наружу без единой строки сбора в прикладном коде:
+
+```typescript
+import { createTracePlugins } from '@foxford/den-traces/services'
+
+const sdk = new Foxford({ api: { config: { headers: { cookie } }, plugins: createTracePlugins() } })
+```
+
+Имя похода — `traceName` в конфиге запроса, без него — метод и путь (`get /api/pages`).
+
 `installServerTrace` ставит `setTimingSink` / `setRequestSink`. Приёмник upstream-ошибок
 (`setUpstreamErrorSink`) цепляет `installServerSentry`.
 
@@ -52,4 +69,5 @@ import { measure, trackFetch } from '@foxford/den-traces/timings'
 | Путь | Содержимое |
 |---|---|
 | `@foxford/den-traces` | `installServerTrace`, `recordServerTiming`, `describeDeclarations`, sinks |
-| `@foxford/den-traces/timings` | `measure`, `trackFetch`, `setTimingSink`, `setRequestSink`, `setUpstreamErrorSink` |
+| `@foxford/den-traces/timings` | `measure`, `startRequest`, `setTimingSink`, `setRequestSink`, `setUpstreamErrorSink` |
+| `@foxford/den-traces/services` | `createTracePlugins`, `traceNameOf`, `traceUrlOf` — плагины клиента `@foxford/services` |

package/chunk-DAPDESIH.cjs

@@ -0,0 +1,64 @@
+"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);
+  }
+}
+function startRequest(name, url) {
+  const startedAt = performance.now();
+  let done = false;
+  return {
+    fail(error) {
+      if (done) return;
+      done = true;
+      const ms = performance.now() - startedAt;
+      _optionalChain([sink, 'optionalCall', _ => _(name, ms, startedAt)]);
+      _optionalChain([requestSink, 'optionalCall', _2 => _2({ bytes: null, error: String(error), ms, name, startedAt, status: null, url })]);
+      _optionalChain([upstreamErrorSink, 'optionalCall', _3 => _3({ name, reason: "network", status: null, url })]);
+    },
+    finish(status, bytes = null) {
+      if (done) return;
+      done = true;
+      const ms = performance.now() - startedAt;
+      _optionalChain([sink, 'optionalCall', _4 => _4(name, ms, startedAt)]);
+      _optionalChain([requestSink, 'optionalCall', _5 => _5({ bytes, ms, name, startedAt, status, url })]);
+      if (status < 200 || status >= 300) {
+        _optionalChain([upstreamErrorSink, 'optionalCall', _6 => _6({ name, reason: `http_${String(status)}`, status, url })]);
+      }
+    }
+  };
+}
+function contentLength(value) {
+  if (value === null || value === void 0 || value === "") {
+    return null;
+  }
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+
+
+
+
+
+
+
+
+exports.setTimingSink = setTimingSink; exports.setRequestSink = setRequestSink; exports.setUpstreamErrorSink = setUpstreamErrorSink; exports.measure = measure; exports.startRequest = startRequest; exports.contentLength = contentLength;

package/chunk-PMYUYUJQ.js

@@ -0,0 +1,64 @@
+// 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);
+  }
+}
+function startRequest(name, url) {
+  const startedAt = performance.now();
+  let done = false;
+  return {
+    fail(error) {
+      if (done) return;
+      done = true;
+      const ms = performance.now() - startedAt;
+      sink?.(name, ms, startedAt);
+      requestSink?.({ bytes: null, error: String(error), ms, name, startedAt, status: null, url });
+      upstreamErrorSink?.({ name, reason: "network", status: null, url });
+    },
+    finish(status, bytes = null) {
+      if (done) return;
+      done = true;
+      const ms = performance.now() - startedAt;
+      sink?.(name, ms, startedAt);
+      requestSink?.({ bytes, ms, name, startedAt, status, url });
+      if (status < 200 || status >= 300) {
+        upstreamErrorSink?.({ name, reason: `http_${String(status)}`, status, url });
+      }
+    }
+  };
+}
+function contentLength(value) {
+  if (value === null || value === void 0 || value === "") {
+    return null;
+  }
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+
+export {
+  setTimingSink,
+  setRequestSink,
+  setUpstreamErrorSink,
+  measure,
+  startRequest,
+  contentLength
+};

package/index.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunkF4ITEBDQcjs = require('./chunk-F4ITEBDQ.cjs');
+var _chunkDAPDESIHcjs = require('./chunk-DAPDESIH.cjs');
 
 // src/server/install.ts
 var _async_hooks = require('async_hooks');
@@ -61,8 +61,8 @@ 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)]));
+  _chunkDAPDESIHcjs.setTimingSink.call(void 0, recordServerTiming);
+  _chunkDAPDESIHcjs.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);
   });
@@ -94,4 +94,4 @@ function installServerTrace(instance, options = {}) {
 
 
 
-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;
+exports.describeDeclarations = describeDeclarations; exports.installServerTrace = installServerTrace; exports.measure = _chunkDAPDESIHcjs.measure; exports.recordServerTiming = recordServerTiming; exports.setRequestSink = _chunkDAPDESIHcjs.setRequestSink; exports.setTimingSink = _chunkDAPDESIHcjs.setTimingSink; exports.setUpstreamErrorSink = _chunkDAPDESIHcjs.setUpstreamErrorSink; exports.startRequest = _chunkDAPDESIHcjs.startRequest; exports.traceHeader = traceHeader;

package/index.d.cts

@@ -1,5 +1,5 @@
 import { TrackedRequest } from './timings/index.cjs';
-export { RequestSink, TimingSink, UpstreamErrorContext, UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch } from './timings/index.cjs';
+export { RequestSink, RequestSpan, TimingSink, UpstreamErrorContext, UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, startRequest } from './timings/index.cjs';
 
 /**
  * Хуки инстанса, которыми пользуется `@foxford/den`.

package/index.d.ts

@@ -1,5 +1,5 @@
 import { TrackedRequest } from './timings/index.js';
-export { RequestSink, TimingSink, UpstreamErrorContext, UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch } from './timings/index.js';
+export { RequestSink, RequestSpan, TimingSink, UpstreamErrorContext, UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, startRequest } from './timings/index.js';
 
 /**
  * Хуки инстанса, которыми пользуется `@foxford/den`.

package/index.js

@@ -3,8 +3,8 @@ import {
   setRequestSink,
   setTimingSink,
   setUpstreamErrorSink,
-  trackFetch
-} from "./chunk-HN4BBSRG.js";
+  startRequest
+} from "./chunk-PMYUYUJQ.js";
 
 // src/server/install.ts
 import { AsyncLocalStorage } from "async_hooks";
@@ -92,6 +92,6 @@ export {
   setRequestSink,
   setTimingSink,
   setUpstreamErrorSink,
-  traceHeader,
-  trackFetch
+  startRequest,
+  traceHeader
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxford/den-traces",
-  "version": "0.1.0",
+  "version": "2.0.0",
   "description": "Метки времени, походы наружу и дев-трасса для den-приложений",
   "keywords": [
     "foxford",
@@ -32,7 +32,7 @@
   ],
   "type": "module",
   "peerDependencies": {
-    "@foxford/den": "^3.3.0"
+    "@foxford/den": "^3.5.0"
   },
   "main": "./index.cjs",
   "module": "./index.js",
@@ -42,6 +42,11 @@
       "require": "./index.cjs",
       "types": "./index.d.ts"
     },
+    "./services": {
+      "import": "./services/index.js",
+      "require": "./services/index.cjs",
+      "types": "./services/index.d.ts"
+    },
     "./timings": {
       "import": "./timings/index.js",
       "require": "./timings/index.cjs",
@@ -50,15 +55,16 @@
   },
   "files": [
     "README.mdx",
-    "chunk-F4ITEBDQ.cjs",
-    "chunk-HN4BBSRG.js",
+    "chunk-DAPDESIH.cjs",
+    "chunk-PMYUYUJQ.js",
     "index.cjs",
     "index.d.cts",
     "index.d.ts",
     "index.js",
     "package.json",
+    "services",
     "timings"
   ],
-  "sha": "5638b60",
+  "sha": "a0e9213",
   "scripts": {}
 }

package/services/index.cjs

@@ -0,0 +1,70 @@
+"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 _chunkDAPDESIHcjs = require('../chunk-DAPDESIH.cjs');
+
+// src/services/index.ts
+var SPAN = /* @__PURE__ */ Symbol("den-traces:span");
+function traceNameOf(config) {
+  if (typeof config.traceName === "string" && config.traceName !== "") {
+    return config.traceName;
+  }
+  const path = _nullishCoalesce((_nullishCoalesce(config.url, () => ( ""))).split("?")[0], () => ( ""));
+  return `${(_nullishCoalesce(config.method, () => ( "get"))).toLowerCase()} ${path}`;
+}
+function traceUrlOf(config) {
+  const url = _nullishCoalesce(config.url, () => ( ""));
+  if (/^https?:\/\//.test(url) || !config.baseURL) {
+    return url;
+  }
+  return `${config.baseURL.replace(/\/$/, "")}/${url.replace(/^\//, "")}`;
+}
+function spanOf(config) {
+  const span = _optionalChain([config, 'optionalAccess', _ => _[SPAN]]);
+  return typeof span === "object" && span !== null ? span : void 0;
+}
+function lengthOf(headers) {
+  const value = _optionalChain([headers, 'optionalAccess', _2 => _2["content-length"]]);
+  return _chunkDAPDESIHcjs.contentLength.call(void 0, typeof value === "string" ? value : typeof value === "number" ? String(value) : null);
+}
+function createTracePlugins() {
+  return [
+    {
+      execute: (config) => {
+        config[SPAN] = _chunkDAPDESIHcjs.startRequest.call(void 0, traceNameOf(config), traceUrlOf(config));
+        return Promise.resolve(config);
+      },
+      isApplicable: () => true,
+      pluginName: "den-traces:request",
+      pluginType: "request"
+    },
+    {
+      execute: (response) => {
+        _optionalChain([spanOf, 'call', _3 => _3(response.config), 'optionalAccess', _4 => _4.finish, 'call', _5 => _5(response.status, lengthOf(response.headers))]);
+        return Promise.resolve(response);
+      },
+      isApplicable: () => true,
+      pluginName: "den-traces:response",
+      pluginType: "responseSuccess"
+    },
+    {
+      execute: (error) => {
+        const span = spanOf(error.config);
+        if (error.response) {
+          _optionalChain([span, 'optionalAccess', _6 => _6.finish, 'call', _7 => _7(error.response.status, lengthOf(error.response.headers))]);
+        } else {
+          _optionalChain([span, 'optionalAccess', _8 => _8.fail, 'call', _9 => _9(error)]);
+        }
+        return Promise.resolve(error);
+      },
+      isApplicable: () => true,
+      pluginName: "den-traces:fail",
+      pluginType: "responseFail"
+    }
+  ];
+}
+
+
+
+
+exports.createTracePlugins = createTracePlugins; exports.traceNameOf = traceNameOf; exports.traceUrlOf = traceUrlOf;

package/services/index.d.cts

@@ -0,0 +1,59 @@
+/** Часть конфига запроса клиента, которую читают плагины. */
+interface TracedRequestConfig {
+    url?: string;
+    baseURL?: string;
+    method?: string;
+    /** Имя куска работы для меток; без него — метод и путь. */
+    traceName?: string;
+    [key: string | symbol]: unknown;
+}
+/** Часть ответа клиента, которую читают плагины. */
+interface TracedResponse {
+    status: number;
+    headers?: Record<string, unknown>;
+    config: TracedRequestConfig;
+    [key: string]: unknown;
+}
+/** Часть ошибки клиента, которую читают плагины. */
+interface TracedError {
+    config?: TracedRequestConfig;
+    response?: {
+        status: number;
+        headers?: Record<string, unknown>;
+    };
+    [key: string]: unknown;
+}
+/** Плагин запроса — форма `RequestPluginInterface` из `@foxford/services`. */
+interface TraceRequestPlugin {
+    pluginType: 'request';
+    pluginName: string;
+    isApplicable(config: TracedRequestConfig): boolean;
+    execute(config: TracedRequestConfig): Promise<TracedRequestConfig>;
+}
+/** Плагин успешного ответа — форма `ResponseSuccessPluginInterface`. */
+interface TraceResponsePlugin {
+    pluginType: 'responseSuccess';
+    pluginName: string;
+    isApplicable(response: TracedResponse): boolean;
+    execute(response: TracedResponse): Promise<TracedResponse>;
+}
+/** Плагин ошибки — форма `ResponseFailPluginInterface`: ошибку возвращает как есть. */
+interface TraceFailPlugin {
+    pluginType: 'responseFail';
+    pluginName: string;
+    isApplicable(error: TracedError): boolean;
+    execute(error: TracedError): Promise<TracedError>;
+}
+/** Имя куска работы: явное из конфига либо метод и путь без строки запроса. */
+declare function traceNameOf(config: TracedRequestConfig): string;
+/** Полный адрес похода: база клиента плюс путь, если путь относительный. */
+declare function traceUrlOf(config: TracedRequestConfig): string;
+/**
+ * Плагины сбора походов для клиента `@foxford/services`: подключаются в `plugins`
+ * при создании инстанса (`createFoxApiInstance`) либо в `api.plugins` конфига SDK.
+ *
+ * @returns Тройка плагинов: начать поход, закончить ответом, закончить ошибкой
+ */
+declare function createTracePlugins(): [TraceRequestPlugin, TraceResponsePlugin, TraceFailPlugin];
+
+export { type TraceFailPlugin, type TraceRequestPlugin, type TraceResponsePlugin, type TracedError, type TracedRequestConfig, type TracedResponse, createTracePlugins, traceNameOf, traceUrlOf };

package/services/index.d.ts

@@ -0,0 +1,59 @@
+/** Часть конфига запроса клиента, которую читают плагины. */
+interface TracedRequestConfig {
+    url?: string;
+    baseURL?: string;
+    method?: string;
+    /** Имя куска работы для меток; без него — метод и путь. */
+    traceName?: string;
+    [key: string | symbol]: unknown;
+}
+/** Часть ответа клиента, которую читают плагины. */
+interface TracedResponse {
+    status: number;
+    headers?: Record<string, unknown>;
+    config: TracedRequestConfig;
+    [key: string]: unknown;
+}
+/** Часть ошибки клиента, которую читают плагины. */
+interface TracedError {
+    config?: TracedRequestConfig;
+    response?: {
+        status: number;
+        headers?: Record<string, unknown>;
+    };
+    [key: string]: unknown;
+}
+/** Плагин запроса — форма `RequestPluginInterface` из `@foxford/services`. */
+interface TraceRequestPlugin {
+    pluginType: 'request';
+    pluginName: string;
+    isApplicable(config: TracedRequestConfig): boolean;
+    execute(config: TracedRequestConfig): Promise<TracedRequestConfig>;
+}
+/** Плагин успешного ответа — форма `ResponseSuccessPluginInterface`. */
+interface TraceResponsePlugin {
+    pluginType: 'responseSuccess';
+    pluginName: string;
+    isApplicable(response: TracedResponse): boolean;
+    execute(response: TracedResponse): Promise<TracedResponse>;
+}
+/** Плагин ошибки — форма `ResponseFailPluginInterface`: ошибку возвращает как есть. */
+interface TraceFailPlugin {
+    pluginType: 'responseFail';
+    pluginName: string;
+    isApplicable(error: TracedError): boolean;
+    execute(error: TracedError): Promise<TracedError>;
+}
+/** Имя куска работы: явное из конфига либо метод и путь без строки запроса. */
+declare function traceNameOf(config: TracedRequestConfig): string;
+/** Полный адрес похода: база клиента плюс путь, если путь относительный. */
+declare function traceUrlOf(config: TracedRequestConfig): string;
+/**
+ * Плагины сбора походов для клиента `@foxford/services`: подключаются в `plugins`
+ * при создании инстанса (`createFoxApiInstance`) либо в `api.plugins` конфига SDK.
+ *
+ * @returns Тройка плагинов: начать поход, закончить ответом, закончить ошибкой
+ */
+declare function createTracePlugins(): [TraceRequestPlugin, TraceResponsePlugin, TraceFailPlugin];
+
+export { type TraceFailPlugin, type TraceRequestPlugin, type TraceResponsePlugin, type TracedError, type TracedRequestConfig, type TracedResponse, createTracePlugins, traceNameOf, traceUrlOf };

package/services/index.js

@@ -0,0 +1,70 @@
+import {
+  contentLength,
+  startRequest
+} from "../chunk-PMYUYUJQ.js";
+
+// src/services/index.ts
+var SPAN = /* @__PURE__ */ Symbol("den-traces:span");
+function traceNameOf(config) {
+  if (typeof config.traceName === "string" && config.traceName !== "") {
+    return config.traceName;
+  }
+  const path = (config.url ?? "").split("?")[0] ?? "";
+  return `${(config.method ?? "get").toLowerCase()} ${path}`;
+}
+function traceUrlOf(config) {
+  const url = config.url ?? "";
+  if (/^https?:\/\//.test(url) || !config.baseURL) {
+    return url;
+  }
+  return `${config.baseURL.replace(/\/$/, "")}/${url.replace(/^\//, "")}`;
+}
+function spanOf(config) {
+  const span = config?.[SPAN];
+  return typeof span === "object" && span !== null ? span : void 0;
+}
+function lengthOf(headers) {
+  const value = headers?.["content-length"];
+  return contentLength(typeof value === "string" ? value : typeof value === "number" ? String(value) : null);
+}
+function createTracePlugins() {
+  return [
+    {
+      execute: (config) => {
+        config[SPAN] = startRequest(traceNameOf(config), traceUrlOf(config));
+        return Promise.resolve(config);
+      },
+      isApplicable: () => true,
+      pluginName: "den-traces:request",
+      pluginType: "request"
+    },
+    {
+      execute: (response) => {
+        spanOf(response.config)?.finish(response.status, lengthOf(response.headers));
+        return Promise.resolve(response);
+      },
+      isApplicable: () => true,
+      pluginName: "den-traces:response",
+      pluginType: "responseSuccess"
+    },
+    {
+      execute: (error) => {
+        const span = spanOf(error.config);
+        if (error.response) {
+          span?.finish(error.response.status, lengthOf(error.response.headers));
+        } else {
+          span?.fail(error);
+        }
+        return Promise.resolve(error);
+      },
+      isApplicable: () => true,
+      pluginName: "den-traces:fail",
+      pluginType: "responseFail"
+    }
+  ];
+}
+export {
+  createTracePlugins,
+  traceNameOf,
+  traceUrlOf
+};

package/timings/index.cjs

@@ -4,11 +4,13 @@
 
 
 
-var _chunkF4ITEBDQcjs = require('../chunk-F4ITEBDQ.cjs');
 
+var _chunkDAPDESIHcjs = require('../chunk-DAPDESIH.cjs');
 
 
 
 
 
-exports.measure = _chunkF4ITEBDQcjs.measure; exports.setRequestSink = _chunkF4ITEBDQcjs.setRequestSink; exports.setTimingSink = _chunkF4ITEBDQcjs.setTimingSink; exports.setUpstreamErrorSink = _chunkF4ITEBDQcjs.setUpstreamErrorSink; exports.trackFetch = _chunkF4ITEBDQcjs.trackFetch;
+
+
+exports.contentLength = _chunkDAPDESIHcjs.contentLength; exports.measure = _chunkDAPDESIHcjs.measure; exports.setRequestSink = _chunkDAPDESIHcjs.setRequestSink; exports.setTimingSink = _chunkDAPDESIHcjs.setTimingSink; exports.setUpstreamErrorSink = _chunkDAPDESIHcjs.setUpstreamErrorSink; exports.startRequest = _chunkDAPDESIHcjs.startRequest;

package/timings/index.d.cts

@@ -42,7 +42,26 @@ declare function setRequestSink(next: RequestSink | null): void;
 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>;
+/**
+ * Начатый поход наружу: чем он кончился, сообщает тот, кто его вёл.
+ *
+ * Так сбор отделён от транспорта: `fetch`, axios из SDK или что угодно ещё сообщают о походе
+ * одной формой, а приёмники (`Server-Timing`, дев-трасса, Sentry) не знают, кто ходил.
+ */
+interface RequestSpan {
+    /** Ответ получен; не-OK статус уходит и приёмнику upstream-ошибок. */
+    finish(status: number, bytes?: number | null): void;
+    /** До ответа не дошли: сеть, таймаут, отмена. */
+    fail(error: unknown): void;
+}
+/**
+ * Начинает поход наружу: метка времени и запись о походе появятся, когда он кончится.
+ *
+ * @param name - Имя куска работы — то же, что у метки времени
+ * @param url - Адрес, куда ходили
+ */
+declare function startRequest(name: string, url: string): RequestSpan;
+/** Размер ответа по `content-length`; `null` — бэкенд его не прислал. */
+declare function contentLength(value: string | null | undefined): number | null;
 
-export { type RequestSink, type TimingSink, type TrackedRequest, type UpstreamErrorContext, type UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch };
+export { type RequestSink, type RequestSpan, type TimingSink, type TrackedRequest, type UpstreamErrorContext, type UpstreamErrorSink, contentLength, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, startRequest };

package/timings/index.d.ts

@@ -42,7 +42,26 @@ declare function setRequestSink(next: RequestSink | null): void;
 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>;
+/**
+ * Начатый поход наружу: чем он кончился, сообщает тот, кто его вёл.
+ *
+ * Так сбор отделён от транспорта: `fetch`, axios из SDK или что угодно ещё сообщают о походе
+ * одной формой, а приёмники (`Server-Timing`, дев-трасса, Sentry) не знают, кто ходил.
+ */
+interface RequestSpan {
+    /** Ответ получен; не-OK статус уходит и приёмнику upstream-ошибок. */
+    finish(status: number, bytes?: number | null): void;
+    /** До ответа не дошли: сеть, таймаут, отмена. */
+    fail(error: unknown): void;
+}
+/**
+ * Начинает поход наружу: метка времени и запись о походе появятся, когда он кончится.
+ *
+ * @param name - Имя куска работы — то же, что у метки времени
+ * @param url - Адрес, куда ходили
+ */
+declare function startRequest(name: string, url: string): RequestSpan;
+/** Размер ответа по `content-length`; `null` — бэкенд его не прислал. */
+declare function contentLength(value: string | null | undefined): number | null;
 
-export { type RequestSink, type TimingSink, type TrackedRequest, type UpstreamErrorContext, type UpstreamErrorSink, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, trackFetch };
+export { type RequestSink, type RequestSpan, type TimingSink, type TrackedRequest, type UpstreamErrorContext, type UpstreamErrorSink, contentLength, measure, setRequestSink, setTimingSink, setUpstreamErrorSink, startRequest };

package/timings/index.js

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

package/chunk-F4ITEBDQ.cjs

@@ -1,73 +0,0 @@
-"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

@@ -1,73 +0,0 @@
-// 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
-};