@tearleads/client-sdk 0.1.69 → 0.1.71

package/internal/api-client/ApiClient.d.ts

@@ -173,6 +173,11 @@ export declare class ApiClient {
                     targets: Record<string, unknown>[];
                 };
                 id: string;
+                initialSync?: {
+                    commitLsn: string | null;
+                    commitLsnMode: "tracked" | "untracked";
+                    acceptedOutgoingUpdateIds: string[];
+                } | undefined;
             };
         };
         organizationMetadataContainerId: string;
@@ -214,6 +219,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
         rootMetadataDocumentId: string;
         systemContainers: {
@@ -312,6 +322,11 @@ export declare class ApiClient {
                     targets: Record<string, unknown>[];
                 };
                 id: string;
+                initialSync?: {
+                    commitLsn: string | null;
+                    commitLsnMode: "tracked" | "untracked";
+                    acceptedOutgoingUpdateIds: string[];
+                } | undefined;
             };
         }[];
         userId: string;
@@ -350,6 +365,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         } | undefined;
         organizationProfileDocumentId?: string | undefined;
         rosterProfileContainer?: {
@@ -448,6 +468,11 @@ export declare class ApiClient {
                     targets: Record<string, unknown>[];
                 };
                 id: string;
+                initialSync?: {
+                    commitLsn: string | null;
+                    commitLsnMode: "tracked" | "untracked";
+                    acceptedOutgoingUpdateIds: string[];
+                } | undefined;
             };
         } | undefined;
         rosterProfileContainerId?: string | undefined;
@@ -486,6 +511,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         } | undefined;
         rosterProfileDocumentId?: string | undefined;
     } | null>;
@@ -603,6 +633,11 @@ export declare class ApiClient {
                     targets: Record<string, unknown>[];
                 };
                 id: string;
+                initialSync?: {
+                    commitLsn: string | null;
+                    commitLsnMode: "tracked" | "untracked";
+                    acceptedOutgoingUpdateIds: string[];
+                } | undefined;
             };
         };
         organizationMetadataContainerId: string;
@@ -644,6 +679,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
         rootMetadataDocumentId: string;
         systemContainers: {
@@ -742,6 +782,11 @@ export declare class ApiClient {
                     targets: Record<string, unknown>[];
                 };
                 id: string;
+                initialSync?: {
+                    commitLsn: string | null;
+                    commitLsnMode: "tracked" | "untracked";
+                    acceptedOutgoingUpdateIds: string[];
+                } | undefined;
             };
         }[];
         userId: string;
@@ -780,6 +825,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         } | undefined;
         organizationProfileDocumentId?: string | undefined;
         rosterProfileContainer?: {
@@ -878,6 +928,11 @@ export declare class ApiClient {
                     targets: Record<string, unknown>[];
                 };
                 id: string;
+                initialSync?: {
+                    commitLsn: string | null;
+                    commitLsnMode: "tracked" | "untracked";
+                    acceptedOutgoingUpdateIds: string[];
+                } | undefined;
             };
         } | undefined;
         rosterProfileContainerId?: string | undefined;
@@ -916,6 +971,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         } | undefined;
         rosterProfileDocumentId?: string | undefined;
     } | null>;
@@ -2608,6 +2668,11 @@ export declare class ApiClient {
             targets: Record<string, unknown>[];
         };
         id: string;
+        initialSync?: {
+            commitLsn: string | null;
+            commitLsnMode: "tracked" | "untracked";
+            acceptedOutgoingUpdateIds: string[];
+        } | undefined;
     } | null>;
     createDocumentResult(input: DocumentCreateRequest, options?: RequestResultOptions): Promise<RequestResult<DocumentCreateResponse>>;
     getContainerWriterProjection(containerId: string): Promise<{
@@ -2900,6 +2965,11 @@ export declare class ApiClient {
                 targets: Record<string, unknown>[];
             };
             id: string;
+            initialSync?: {
+                commitLsn: string | null;
+                commitLsnMode: "tracked" | "untracked";
+                acceptedOutgoingUpdateIds: string[];
+            } | undefined;
         };
     } | null>;
     createContainerWithMetadataDocumentResult(input: ContainerCreateWithMetadataDocumentRequest, options?: RequestResultOptions): Promise<RequestResult<ContainerCreateWithMetadataDocumentResponse>>;
@@ -3970,9 +4040,6 @@ export declare class ApiClient {
         };
     } | null>;
     syncDocument(documentId: string, input: DocumentSyncRequest, options?: RequestResultOptions): Promise<{
-        acceptedOutgoingUpdateIds: string[];
-        commitLsn: string | null;
-        commitLsnMode: "tracked" | "untracked";
         contentKeyBundle: {
             contentKeyEpoch: number;
             documentId: string;
@@ -4035,6 +4102,9 @@ export declare class ApiClient {
             checkpointPayloadKind?: "full_history_snapshot" | undefined;
             sourceVersionVector?: string | undefined;
         }[];
+        commitLsn: string | null;
+        commitLsnMode: "tracked" | "untracked";
+        acceptedOutgoingUpdateIds: string[];
     } | null>;
     syncDocumentResult(documentId: string, input: DocumentSyncRequest, options?: RequestResultOptions): Promise<RequestResult<DocumentSyncResponse>>;
     initiateMultipartBlobStage(input: InitiateMultipartBlobStageRequest): Promise<{

package/internal/api-client/apiRequestMetrics.d.ts

@@ -1,4 +1,6 @@
 import type { HttpOperation } from "../validators/operation/index.js";
+import { type ApiRequestDurationSummary } from "./durationSampleWindow.js";
+import type { ApiServerTiming } from "./serverTiming.js";
 export interface ApiRequestCounts {
     readonly total: number;
     readonly inFlight: number;
@@ -9,6 +11,12 @@ export interface ApiRequestCounts {
 export interface ApiRequestEndpointCounts extends ApiRequestCounts {
     readonly method: string;
     readonly path: string;
+    /** Dispatch until response headers, a connection failure, or cancellation. */
+    readonly duration: ApiRequestDurationSummary | null;
+    /** The API's Server-Timing `total`; null until a response reports it. */
+    readonly serverDuration: ApiRequestDurationSummary | null;
+    /** The API's Server-Timing `db`; null until a response reports it. */
+    readonly databaseDuration: ApiRequestDurationSummary | null;
 }
 export interface ApiRequestMetricsSnapshot extends ApiRequestCounts {
     readonly startedAt: string;
@@ -20,18 +28,24 @@ export interface ApiRequestInstrumentation {
 }
 type Outcome = "succeeded" | "failed" | "cancelled";
 /**
- * In-memory HTTP attempt counts, partitioned by identity at dispatch time.
- * Only operation templates are retained: no URLs, queries, bodies or tokens.
- * Hosts may reuse this store across client lifetimes until a page reload.
+ * In-memory HTTP attempt counts and durations, partitioned by identity at
+ * dispatch time. Only operation templates are retained: no URLs, queries,
+ * bodies or tokens. Hosts may reuse this store across client lifetimes until a
+ * page reload.
  */
 export declare class ApiRequestMetrics {
+    private readonly now;
     private readonly scopes;
+    private readonly durations;
     private readonly listeners;
     private readonly generations;
+    /** `now` must be monotonic; tests inject a fake clock. */
+    constructor(now?: () => number);
     getSnapshot: (identity: string | null) => ApiRequestMetricsSnapshot;
     subscribe: (listener: () => void) => (() => void);
     reset(identity: string | null): void;
-    begin(identity: string | null, operation: HttpOperation): (outcome: Outcome) => void;
+    begin(identity: string | null, operation: HttpOperation): (outcome: Outcome, serverTiming?: ApiServerTiming | null) => void;
+    private recordDurations;
     private update;
     private notify;
 }

package/internal/api-client/apiRequestMetrics.js

@@ -1,3 +1,4 @@
+import { DurationSampleWindow, } from "./durationSampleWindow.js";
 const emptyCounts = {
     total: 0,
     inFlight: 0,
@@ -5,18 +6,33 @@ const emptyCounts = {
     failed: 0,
     cancelled: 0,
 };
+const emptyDurations = {
+    duration: null,
+    serverDuration: null,
+    databaseDuration: null,
+};
 function emptySnapshot() {
     return { ...emptyCounts, startedAt: new Date().toISOString(), endpoints: [] };
 }
+function endpointKey(row) {
+    return `${row.method} ${row.path}`;
+}
 /**
- * In-memory HTTP attempt counts, partitioned by identity at dispatch time.
- * Only operation templates are retained: no URLs, queries, bodies or tokens.
- * Hosts may reuse this store across client lifetimes until a page reload.
+ * In-memory HTTP attempt counts and durations, partitioned by identity at
+ * dispatch time. Only operation templates are retained: no URLs, queries,
+ * bodies or tokens. Hosts may reuse this store across client lifetimes until a
+ * page reload.
  */
 export class ApiRequestMetrics {
+    now;
     scopes = new Map();
+    durations = new Map();
     listeners = new Set();
     generations = new Map();
+    /** `now` must be monotonic; tests inject a fake clock. */
+    constructor(now = () => performance.now()) {
+        this.now = now;
+    }
     getSnapshot = (identity) => {
         let snapshot = this.scopes.get(identity);
         if (!snapshot) {
@@ -32,13 +48,16 @@ export class ApiRequestMetrics {
     reset(identity) {
         this.generations.set(identity, (this.generations.get(identity) ?? 0) + 1);
         this.scopes.set(identity, emptySnapshot());
+        this.durations.delete(identity);
         this.notify();
     }
     begin(identity, operation) {
         const generation = this.generations.get(identity) ?? 0;
+        const startedAt = this.now();
         const previous = this.getSnapshot(identity);
         const existing = previous.endpoints.find((row) => row.method === operation.method && row.path === operation.path);
         let row = {
+            ...emptyDurations,
             ...(existing ?? emptyCounts),
             method: operation.method,
             path: operation.path,
@@ -52,7 +71,7 @@ export class ApiRequestMetrics {
         // Reset replaces the scope's endpoints. Capture a generation independently
         // of snapshots, which are replaced for every concurrent request update.
         let completed = false;
-        return (outcome) => {
+        return (outcome, serverTiming) => {
             if (completed)
                 return;
             completed = true;
@@ -64,6 +83,7 @@ export class ApiRequestMetrics {
                 return;
             row = {
                 ...endpoint,
+                ...this.recordDurations(identity, endpoint, this.now() - startedAt, serverTiming),
                 inFlight: endpoint.inFlight - 1,
                 [outcome]: endpoint[outcome] + 1,
             };
@@ -73,12 +93,42 @@ export class ApiRequestMetrics {
             });
         };
     }
+    recordDurations(identity, endpoint, elapsedMs, serverTiming) {
+        let byEndpoint = this.durations.get(identity);
+        if (!byEndpoint) {
+            byEndpoint = new Map();
+            this.durations.set(identity, byEndpoint);
+        }
+        const key = endpointKey(endpoint);
+        let windows = byEndpoint.get(key);
+        if (!windows) {
+            windows = {
+                duration: new DurationSampleWindow(),
+                serverDuration: new DurationSampleWindow(),
+                databaseDuration: new DurationSampleWindow(),
+            };
+            byEndpoint.set(key, windows);
+        }
+        windows.duration.record(elapsedMs);
+        const serverMs = serverTiming?.totalMs;
+        if (typeof serverMs === "number")
+            windows.serverDuration.record(serverMs);
+        const databaseMs = serverTiming?.databaseMs;
+        if (typeof databaseMs === "number") {
+            windows.databaseDuration.record(databaseMs);
+        }
+        return {
+            duration: windows.duration.summarize(),
+            serverDuration: windows.serverDuration.summarize(),
+            databaseDuration: windows.databaseDuration.summarize(),
+        };
+    }
     update(identity, previous, existing, row, counts) {
         const endpoints = existing
             ? previous.endpoints.map((candidate) => candidate === existing ? row : candidate)
             : [...previous.endpoints, row];
         endpoints.sort((left, right) => right.total - left.total ||
-            `${left.method} ${left.path}`.localeCompare(`${right.method} ${right.path}`, "en"));
+            endpointKey(left).localeCompare(endpointKey(right), "en"));
         this.scopes.set(identity, { ...previous, ...counts, endpoints });
         this.notify();
     }

package/internal/api-client/apiRequestMetrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiRequestMetrics.js","sourceRoot":"","sources":["apiRequestMetrics.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HttpOperation } from \"@tearleads/validators/operation\";\n\nexport interface ApiRequestCounts {\n  readonly total: number;\n  readonly inFlight: number;\n  readonly succeeded: number;\n  readonly failed: number;\n  readonly cancelled: number;\n}\n\nexport interface ApiRequestEndpointCounts extends ApiRequestCounts {\n  readonly method: string;\n  readonly path: string;\n}\n\nexport interface ApiRequestMetricsSnapshot extends ApiRequestCounts {\n  readonly startedAt: string;\n  readonly endpoints: readonly ApiRequestEndpointCounts[];\n}\n\nexport interface ApiRequestInstrumentation {\n  readonly metrics: ApiRequestMetrics;\n  readonly getIdentity: () => string | null;\n}\n\ntype Outcome = \"succeeded\" | \"failed\" | \"cancelled\";\n\nconst emptyCounts: ApiRequestCounts = {\n  total: 0,\n  inFlight: 0,\n  succeeded: 0,\n  failed: 0,\n  cancelled: 0,\n};\n\nfunction emptySnapshot(): ApiRequestMetricsSnapshot {\n  return { ...emptyCounts, startedAt: new Date().toISOString(), endpoints: [] };\n}\n\n/**\n * In-memory HTTP attempt counts, partitioned by identity at dispatch time.\n * Only operation templates are retained: no URLs, queries, bodies or tokens.\n * Hosts may reuse this store across client lifetimes until a page reload.\n */\nexport class ApiRequestMetrics {\n  private readonly scopes = new Map<string | null, ApiRequestMetricsSnapshot>();\n  private readonly listeners = new Set<() => void>();\n  private readonly generations = new Map<string | null, number>();\n\n  getSnapshot = (identity: string | null): ApiRequestMetricsSnapshot => {\n    let snapshot = this.scopes.get(identity);\n    if (!snapshot) {\n      snapshot = emptySnapshot();\n      this.scopes.set(identity, snapshot);\n    }\n    return snapshot;\n  };\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  };\n\n  reset(identity: string | null): void {\n    this.generations.set(identity, (this.generations.get(identity) ?? 0) + 1);\n    this.scopes.set(identity, emptySnapshot());\n    this.notify();\n  }\n\n  begin(\n    identity: string | null,\n    operation: HttpOperation,\n  ): (outcome: Outcome) => void {\n    const generation = this.generations.get(identity) ?? 0;\n    const previous = this.getSnapshot(identity);\n    const existing = previous.endpoints.find(\n      (row) => row.method === operation.method && row.path === operation.path,\n    );\n    let row: ApiRequestEndpointCounts = {\n      ...(existing ?? emptyCounts),\n      method: operation.method,\n      path: operation.path,\n      total: (existing?.total ?? 0) + 1,\n      inFlight: (existing?.inFlight ?? 0) + 1,\n    };\n    this.update(identity, previous, existing, row, {\n      total: previous.total + 1,\n      inFlight: previous.inFlight + 1,\n    });\n    // Reset replaces the scope's endpoints. Capture a generation independently\n    // of snapshots, which are replaced for every concurrent request update.\n    let completed = false;\n    return (outcome) => {\n      if (completed) return;\n      completed = true;\n      if ((this.generations.get(identity) ?? 0) !== generation) return;\n      const current = this.getSnapshot(identity);\n      const endpoint = current.endpoints.find(\n        (candidate) =>\n          candidate.method === row.method && candidate.path === row.path,\n      );\n      if (!endpoint) return;\n      row = {\n        ...endpoint,\n        inFlight: endpoint.inFlight - 1,\n        [outcome]: endpoint[outcome] + 1,\n      };\n      this.update(identity, current, endpoint, row, {\n        inFlight: current.inFlight - 1,\n        [outcome]: current[outcome] + 1,\n      });\n    };\n  }\n\n  private update(\n    identity: string | null,\n    previous: ApiRequestMetricsSnapshot,\n    existing: ApiRequestEndpointCounts | undefined,\n    row: ApiRequestEndpointCounts,\n    counts: Partial<ApiRequestCounts>,\n  ): void {\n    const endpoints = existing\n      ? previous.endpoints.map((candidate) =>\n          candidate === existing ? row : candidate,\n        )\n      : [...previous.endpoints, row];\n    endpoints.sort(\n      (left, right) =>\n        right.total - left.total ||\n        `${left.method} ${left.path}`.localeCompare(\n          `${right.method} ${right.path}`,\n          \"en\",\n        ),\n    );\n    this.scopes.set(identity, { ...previous, ...counts, endpoints });\n    this.notify();\n  }\n\n  private notify(): void {\n    for (const listener of this.listeners) {\n      // Instrumentation must never change a request's outcome.\n      try {\n        listener();\n      } catch {\n        /* A broken observer cannot block HTTP. */\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"apiRequestMetrics.js","sourceRoot":"","sources":["apiRequestMetrics.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HttpOperation } from \"@tearleads/validators/operation\";\nimport {\n  type ApiRequestDurationSummary,\n  DurationSampleWindow,\n} from \"./durationSampleWindow\";\nimport type { ApiServerTiming } from \"./serverTiming\";\n\nexport interface ApiRequestCounts {\n  readonly total: number;\n  readonly inFlight: number;\n  readonly succeeded: number;\n  readonly failed: number;\n  readonly cancelled: number;\n}\n\nexport interface ApiRequestEndpointCounts extends ApiRequestCounts {\n  readonly method: string;\n  readonly path: string;\n  /** Dispatch until response headers, a connection failure, or cancellation. */\n  readonly duration: ApiRequestDurationSummary | null;\n  /** The API's Server-Timing `total`; null until a response reports it. */\n  readonly serverDuration: ApiRequestDurationSummary | null;\n  /** The API's Server-Timing `db`; null until a response reports it. */\n  readonly databaseDuration: ApiRequestDurationSummary | null;\n}\n\nexport interface ApiRequestMetricsSnapshot extends ApiRequestCounts {\n  readonly startedAt: string;\n  readonly endpoints: readonly ApiRequestEndpointCounts[];\n}\n\nexport interface ApiRequestInstrumentation {\n  readonly metrics: ApiRequestMetrics;\n  readonly getIdentity: () => string | null;\n}\n\ntype Outcome = \"succeeded\" | \"failed\" | \"cancelled\";\n\ninterface EndpointDurations {\n  readonly duration: DurationSampleWindow;\n  readonly serverDuration: DurationSampleWindow;\n  readonly databaseDuration: DurationSampleWindow;\n}\n\nconst emptyCounts: ApiRequestCounts = {\n  total: 0,\n  inFlight: 0,\n  succeeded: 0,\n  failed: 0,\n  cancelled: 0,\n};\n\ntype EndpointDurationSummaries = Pick<\n  ApiRequestEndpointCounts,\n  \"duration\" | \"serverDuration\" | \"databaseDuration\"\n>;\n\nconst emptyDurations: EndpointDurationSummaries = {\n  duration: null,\n  serverDuration: null,\n  databaseDuration: null,\n};\n\nfunction emptySnapshot(): ApiRequestMetricsSnapshot {\n  return { ...emptyCounts, startedAt: new Date().toISOString(), endpoints: [] };\n}\n\nfunction endpointKey(row: { readonly method: string; readonly path: string }) {\n  return `${row.method} ${row.path}`;\n}\n\n/**\n * In-memory HTTP attempt counts and durations, partitioned by identity at\n * dispatch time. Only operation templates are retained: no URLs, queries,\n * bodies or tokens. Hosts may reuse this store across client lifetimes until a\n * page reload.\n */\nexport class ApiRequestMetrics {\n  private readonly scopes = new Map<string | null, ApiRequestMetricsSnapshot>();\n  private readonly durations = new Map<\n    string | null,\n    Map<string, EndpointDurations>\n  >();\n  private readonly listeners = new Set<() => void>();\n  private readonly generations = new Map<string | null, number>();\n\n  /** `now` must be monotonic; tests inject a fake clock. */\n  constructor(private readonly now: () => number = () => performance.now()) {}\n\n  getSnapshot = (identity: string | null): ApiRequestMetricsSnapshot => {\n    let snapshot = this.scopes.get(identity);\n    if (!snapshot) {\n      snapshot = emptySnapshot();\n      this.scopes.set(identity, snapshot);\n    }\n    return snapshot;\n  };\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  };\n\n  reset(identity: string | null): void {\n    this.generations.set(identity, (this.generations.get(identity) ?? 0) + 1);\n    this.scopes.set(identity, emptySnapshot());\n    this.durations.delete(identity);\n    this.notify();\n  }\n\n  begin(\n    identity: string | null,\n    operation: HttpOperation,\n  ): (outcome: Outcome, serverTiming?: ApiServerTiming | null) => void {\n    const generation = this.generations.get(identity) ?? 0;\n    const startedAt = this.now();\n    const previous = this.getSnapshot(identity);\n    const existing = previous.endpoints.find(\n      (row) => row.method === operation.method && row.path === operation.path,\n    );\n    let row: ApiRequestEndpointCounts = {\n      ...emptyDurations,\n      ...(existing ?? emptyCounts),\n      method: operation.method,\n      path: operation.path,\n      total: (existing?.total ?? 0) + 1,\n      inFlight: (existing?.inFlight ?? 0) + 1,\n    };\n    this.update(identity, previous, existing, row, {\n      total: previous.total + 1,\n      inFlight: previous.inFlight + 1,\n    });\n    // Reset replaces the scope's endpoints. Capture a generation independently\n    // of snapshots, which are replaced for every concurrent request update.\n    let completed = false;\n    return (outcome, serverTiming) => {\n      if (completed) return;\n      completed = true;\n      if ((this.generations.get(identity) ?? 0) !== generation) return;\n      const current = this.getSnapshot(identity);\n      const endpoint = current.endpoints.find(\n        (candidate) =>\n          candidate.method === row.method && candidate.path === row.path,\n      );\n      if (!endpoint) return;\n      row = {\n        ...endpoint,\n        ...this.recordDurations(\n          identity,\n          endpoint,\n          this.now() - startedAt,\n          serverTiming,\n        ),\n        inFlight: endpoint.inFlight - 1,\n        [outcome]: endpoint[outcome] + 1,\n      };\n      this.update(identity, current, endpoint, row, {\n        inFlight: current.inFlight - 1,\n        [outcome]: current[outcome] + 1,\n      });\n    };\n  }\n\n  private recordDurations(\n    identity: string | null,\n    endpoint: ApiRequestEndpointCounts,\n    elapsedMs: number,\n    serverTiming: ApiServerTiming | null | undefined,\n  ): EndpointDurationSummaries {\n    let byEndpoint = this.durations.get(identity);\n    if (!byEndpoint) {\n      byEndpoint = new Map();\n      this.durations.set(identity, byEndpoint);\n    }\n    const key = endpointKey(endpoint);\n    let windows = byEndpoint.get(key);\n    if (!windows) {\n      windows = {\n        duration: new DurationSampleWindow(),\n        serverDuration: new DurationSampleWindow(),\n        databaseDuration: new DurationSampleWindow(),\n      };\n      byEndpoint.set(key, windows);\n    }\n    windows.duration.record(elapsedMs);\n    const serverMs = serverTiming?.totalMs;\n    if (typeof serverMs === \"number\") windows.serverDuration.record(serverMs);\n    const databaseMs = serverTiming?.databaseMs;\n    if (typeof databaseMs === \"number\") {\n      windows.databaseDuration.record(databaseMs);\n    }\n    return {\n      duration: windows.duration.summarize(),\n      serverDuration: windows.serverDuration.summarize(),\n      databaseDuration: windows.databaseDuration.summarize(),\n    };\n  }\n\n  private update(\n    identity: string | null,\n    previous: ApiRequestMetricsSnapshot,\n    existing: ApiRequestEndpointCounts | undefined,\n    row: ApiRequestEndpointCounts,\n    counts: Partial<ApiRequestCounts>,\n  ): void {\n    const endpoints = existing\n      ? previous.endpoints.map((candidate) =>\n          candidate === existing ? row : candidate,\n        )\n      : [...previous.endpoints, row];\n    endpoints.sort(\n      (left, right) =>\n        right.total - left.total ||\n        endpointKey(left).localeCompare(endpointKey(right), \"en\"),\n    );\n    this.scopes.set(identity, { ...previous, ...counts, endpoints });\n    this.notify();\n  }\n\n  private notify(): void {\n    for (const listener of this.listeners) {\n      // Instrumentation must never change a request's outcome.\n      try {\n        listener();\n      } catch {\n        /* A broken observer cannot block HTTP. */\n      }\n    }\n  }\n}\n"]}

package/internal/api-client/durationSampleWindow.d.ts

@@ -0,0 +1,26 @@
+/** Recent percentiles plus all-time totals for one endpoint's durations. */
+export interface ApiRequestDurationSummary {
+    /** Durations recorded since reset. */
+    readonly samples: number;
+    /** Sum of every recorded duration since reset. */
+    readonly totalMs: number;
+    /** Nearest-rank percentiles over the most recent samples only. */
+    readonly p50Ms: number;
+    readonly p95Ms: number;
+    /** Largest duration since reset, including samples outside the window. */
+    readonly maxMs: number;
+}
+export declare const DURATION_SAMPLE_WINDOW_SIZE = 256;
+/**
+ * A fixed-size ring of recent durations, so a long session keeps bounded
+ * memory and sorts at most DURATION_SAMPLE_WINDOW_SIZE values per update.
+ */
+export declare class DurationSampleWindow {
+    private readonly recent;
+    private nextSlot;
+    private samples;
+    private totalMs;
+    private maxMs;
+    record(durationMs: number): void;
+    summarize(): ApiRequestDurationSummary | null;
+}

package/internal/api-client/durationSampleWindow.js

@@ -0,0 +1,42 @@
+export const DURATION_SAMPLE_WINDOW_SIZE = 256;
+function nearestRank(sorted, percentile) {
+    const rank = Math.ceil(percentile * sorted.length);
+    return sorted[Math.max(0, rank - 1)] ?? 0;
+}
+/**
+ * A fixed-size ring of recent durations, so a long session keeps bounded
+ * memory and sorts at most DURATION_SAMPLE_WINDOW_SIZE values per update.
+ */
+export class DurationSampleWindow {
+    recent = [];
+    nextSlot = 0;
+    samples = 0;
+    totalMs = 0;
+    maxMs = 0;
+    record(durationMs) {
+        const sample = Math.max(0, durationMs);
+        if (this.recent.length < DURATION_SAMPLE_WINDOW_SIZE) {
+            this.recent.push(sample);
+        }
+        else {
+            this.recent[this.nextSlot] = sample;
+            this.nextSlot = (this.nextSlot + 1) % DURATION_SAMPLE_WINDOW_SIZE;
+        }
+        this.samples += 1;
+        this.totalMs += sample;
+        this.maxMs = Math.max(this.maxMs, sample);
+    }
+    summarize() {
+        if (this.samples === 0)
+            return null;
+        const sorted = [...this.recent].sort((left, right) => left - right);
+        return {
+            samples: this.samples,
+            totalMs: this.totalMs,
+            p50Ms: nearestRank(sorted, 0.5),
+            p95Ms: nearestRank(sorted, 0.95),
+            maxMs: this.maxMs,
+        };
+    }
+}
+//# sourceMappingURL=durationSampleWindow.js.map

package/internal/api-client/durationSampleWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durationSampleWindow.js","sourceRoot":"","sources":["durationSampleWindow.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C,SAAS,WAAW,CAAC,MAAyB,EAAE,UAAkB;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,MAAM,GAAa,EAAE,CAAC;IAC/B,QAAQ,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC,CAAC;IACZ,KAAK,GAAG,CAAC,CAAC;IAElB,MAAM,CAAC,UAAkB;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;YACpC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,2BAA2B,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC;YAC/B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF","sourcesContent":["/** Recent percentiles plus all-time totals for one endpoint's durations. */\nexport interface ApiRequestDurationSummary {\n  /** Durations recorded since reset. */\n  readonly samples: number;\n  /** Sum of every recorded duration since reset. */\n  readonly totalMs: number;\n  /** Nearest-rank percentiles over the most recent samples only. */\n  readonly p50Ms: number;\n  readonly p95Ms: number;\n  /** Largest duration since reset, including samples outside the window. */\n  readonly maxMs: number;\n}\n\nexport const DURATION_SAMPLE_WINDOW_SIZE = 256;\n\nfunction nearestRank(sorted: readonly number[], percentile: number): number {\n  const rank = Math.ceil(percentile * sorted.length);\n  return sorted[Math.max(0, rank - 1)] ?? 0;\n}\n\n/**\n * A fixed-size ring of recent durations, so a long session keeps bounded\n * memory and sorts at most DURATION_SAMPLE_WINDOW_SIZE values per update.\n */\nexport class DurationSampleWindow {\n  private readonly recent: number[] = [];\n  private nextSlot = 0;\n  private samples = 0;\n  private totalMs = 0;\n  private maxMs = 0;\n\n  record(durationMs: number): void {\n    const sample = Math.max(0, durationMs);\n    if (this.recent.length < DURATION_SAMPLE_WINDOW_SIZE) {\n      this.recent.push(sample);\n    } else {\n      this.recent[this.nextSlot] = sample;\n      this.nextSlot = (this.nextSlot + 1) % DURATION_SAMPLE_WINDOW_SIZE;\n    }\n    this.samples += 1;\n    this.totalMs += sample;\n    this.maxMs = Math.max(this.maxMs, sample);\n  }\n\n  summarize(): ApiRequestDurationSummary | null {\n    if (this.samples === 0) return null;\n    const sorted = [...this.recent].sort((left, right) => left - right);\n    return {\n      samples: this.samples,\n      totalMs: this.totalMs,\n      p50Ms: nearestRank(sorted, 0.5),\n      p95Ms: nearestRank(sorted, 0.95),\n      maxMs: this.maxMs,\n    };\n  }\n}\n"]}

package/internal/api-client/measureApiRequest.js

@@ -1,3 +1,4 @@
+import { parseServerTiming, serverTimingHeaderName } from "./serverTiming.js";
 function beginMeasurement(instrumentation, operation) {
     let finish;
     try {
@@ -6,21 +7,25 @@ function beginMeasurement(instrumentation, operation) {
     catch {
         // Optional host instrumentation must not prevent HTTP dispatch.
     }
-    return (outcome) => {
+    return (outcome, response) => {
         try {
-            finish?.(outcome);
+            finish?.(outcome, response &&
+                parseServerTiming(response.headers.get(serverTimingHeaderName)));
         }
         catch {
             // Nor may a recording failure replace the transport's result.
         }
     };
 }
-/** Counts each fetch, including automatic retries, without consuming bodies. */
+/**
+ * Counts and times each fetch, including automatic retries, without consuming
+ * bodies: an attempt ends when its response headers arrive or it fails.
+ */
 export async function measureApiRequest(instrumentation, operation, fetchResponse, signal) {
     const finish = beginMeasurement(instrumentation, operation);
     try {
         const response = await fetchResponse();
-        finish(response.status >= 200 && response.status < 400 ? "succeeded" : "failed");
+        finish(response.status >= 200 && response.status < 400 ? "succeeded" : "failed", response);
         return response;
     }
     catch (error) {

package/internal/api-client/measureApiRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"measureApiRequest.js","sourceRoot":"","sources":["measureApiRequest.ts"],"names":[],"mappings":"AAOA,SAAS,gBAAgB,CACvB,eAAsD,EACtD,SAAwB;IAExB,IAAI,MAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,EAAE,OAAO,CAAC,KAAK,CACrC,eAAe,CAAC,WAAW,EAAE,EAC7B,SAAS,CACV,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IACD,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,eAAsD,EACtD,SAAwB,EACxB,aAAsC,EACtC,MAA+B;IAE/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;QACvC,MAAM,CACJ,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CACzE,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import type { HttpOperation } from \"@tearleads/validators/operation\";\nimport type { ApiRequestInstrumentation } from \"./apiRequestMetrics\";\n\ntype FinishMeasurement = ReturnType<\n  ApiRequestInstrumentation[\"metrics\"][\"begin\"]\n>;\n\nfunction beginMeasurement(\n  instrumentation: ApiRequestInstrumentation | undefined,\n  operation: HttpOperation,\n): FinishMeasurement {\n  let finish: FinishMeasurement | undefined;\n  try {\n    finish = instrumentation?.metrics.begin(\n      instrumentation.getIdentity(),\n      operation,\n    );\n  } catch {\n    // Optional host instrumentation must not prevent HTTP dispatch.\n  }\n  return (outcome) => {\n    try {\n      finish?.(outcome);\n    } catch {\n      // Nor may a recording failure replace the transport's result.\n    }\n  };\n}\n\n/** Counts each fetch, including automatic retries, without consuming bodies. */\nexport async function measureApiRequest(\n  instrumentation: ApiRequestInstrumentation | undefined,\n  operation: HttpOperation,\n  fetchResponse: () => Promise<Response>,\n  signal: AbortSignal | undefined,\n): Promise<Response> {\n  const finish = beginMeasurement(instrumentation, operation);\n  try {\n    const response = await fetchResponse();\n    finish(\n      response.status >= 200 && response.status < 400 ? \"succeeded\" : \"failed\",\n    );\n    return response;\n  } catch (error) {\n    finish(signal?.aborted ? \"cancelled\" : \"failed\");\n    throw error;\n  }\n}\n"]}
+{"version":3,"file":"measureApiRequest.js","sourceRoot":"","sources":["measureApiRequest.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAO3E,SAAS,gBAAgB,CACvB,eAAsD,EACtD,SAAwB;IAExB,IAAI,MAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,eAAe,EAAE,OAAO,CAAC,KAAK,CACrC,eAAe,CAAC,WAAW,EAAE,EAC7B,SAAS,CACV,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IACD,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,CACN,OAAO,EACP,QAAQ;gBACN,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAClE,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;QAChE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,eAAsD,EACtD,SAAwB,EACxB,aAAsC,EACtC,MAA+B;IAE/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;QACvC,MAAM,CACJ,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EACxE,QAAQ,CACT,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import type { HttpOperation } from \"@tearleads/validators/operation\";\nimport type { ApiRequestInstrumentation } from \"./apiRequestMetrics\";\nimport { parseServerTiming, serverTimingHeaderName } from \"./serverTiming\";\n\ntype FinishMeasurement = ReturnType<\n  ApiRequestInstrumentation[\"metrics\"][\"begin\"]\n>;\ntype Outcome = Parameters<FinishMeasurement>[0];\n\nfunction beginMeasurement(\n  instrumentation: ApiRequestInstrumentation | undefined,\n  operation: HttpOperation,\n): (outcome: Outcome, response?: Response) => void {\n  let finish: FinishMeasurement | undefined;\n  try {\n    finish = instrumentation?.metrics.begin(\n      instrumentation.getIdentity(),\n      operation,\n    );\n  } catch {\n    // Optional host instrumentation must not prevent HTTP dispatch.\n  }\n  return (outcome, response) => {\n    try {\n      finish?.(\n        outcome,\n        response &&\n          parseServerTiming(response.headers.get(serverTimingHeaderName)),\n      );\n    } catch {\n      // Nor may a recording failure replace the transport's result.\n    }\n  };\n}\n\n/**\n * Counts and times each fetch, including automatic retries, without consuming\n * bodies: an attempt ends when its response headers arrive or it fails.\n */\nexport async function measureApiRequest(\n  instrumentation: ApiRequestInstrumentation | undefined,\n  operation: HttpOperation,\n  fetchResponse: () => Promise<Response>,\n  signal: AbortSignal | undefined,\n): Promise<Response> {\n  const finish = beginMeasurement(instrumentation, operation);\n  try {\n    const response = await fetchResponse();\n    finish(\n      response.status >= 200 && response.status < 400 ? \"succeeded\" : \"failed\",\n      response,\n    );\n    return response;\n  } catch (error) {\n    finish(signal?.aborted ? \"cancelled\" : \"failed\");\n    throw error;\n  }\n}\n"]}

package/internal/api-client/serverTiming.d.ts

@@ -0,0 +1,12 @@
+export declare const serverTimingHeaderName = "Server-Timing";
+/** The API's own `total` and `db` Server-Timing durations, when reported. */
+export interface ApiServerTiming {
+    readonly totalMs: number | null;
+    readonly databaseMs: number | null;
+}
+/**
+ * Reads `total;dur=<ms>, db;dur=<ms>` in any order. Unknown metrics, missing
+ * metrics and malformed durations are ignored; the first entry of a metric
+ * wins. Returns null when neither metric is present.
+ */
+export declare function parseServerTiming(header: string | null): ApiServerTiming | null;

package/internal/api-client/serverTiming.js

@@ -0,0 +1,49 @@
+export const serverTimingHeaderName = "Server-Timing";
+function readDuration(parameters) {
+    for (const parameter of parameters) {
+        const separator = parameter.indexOf("=");
+        if (separator < 0)
+            continue;
+        if (parameter.slice(0, separator).trim().toLowerCase() !== "dur")
+            continue;
+        const value = parameter
+            .slice(separator + 1)
+            .trim()
+            .replace(/^"(.*)"$/, "$1");
+        // Only the first `dur` counts; a malformed one leaves the metric unset.
+        if (!/^\d+(\.\d+)?$/.test(value))
+            return null;
+        return Number(value);
+    }
+    return null;
+}
+/**
+ * Reads `total;dur=<ms>, db;dur=<ms>` in any order. Unknown metrics, missing
+ * metrics and malformed durations are ignored; the first entry of a metric
+ * wins. Returns null when neither metric is present.
+ */
+export function parseServerTiming(header) {
+    if (header === null)
+        return null;
+    let totalMs = null;
+    let databaseMs = null;
+    const seen = new Set();
+    for (const entry of header.split(",")) {
+        const [name = "", ...parameters] = entry.split(";");
+        const metric = name.trim().toLowerCase();
+        if (metric !== "total" && metric !== "db")
+            continue;
+        if (seen.has(metric))
+            continue;
+        seen.add(metric);
+        const duration = readDuration(parameters);
+        if (metric === "total")
+            totalMs = duration;
+        else
+            databaseMs = duration;
+    }
+    return totalMs === null && databaseMs === null
+        ? null
+        : { totalMs, databaseMs };
+}
+//# sourceMappingURL=serverTiming.js.map

package/internal/api-client/serverTiming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverTiming.js","sourceRoot":"","sources":["serverTiming.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAQtD,SAAS,YAAY,CAAC,UAA6B;IACjD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,SAAS;QAC3E,MAAM,KAAK,GAAG,SAAS;aACpB,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;aACpB,IAAI,EAAE;aACN,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7B,wEAAwE;QACxE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAqB;IAErB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QAC/B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,GAAG,QAAQ,CAAC;;YACtC,UAAU,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,KAAK,IAAI,IAAI,UAAU,KAAK,IAAI;QAC5C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["export const serverTimingHeaderName = \"Server-Timing\";\n\n/** The API's own `total` and `db` Server-Timing durations, when reported. */\nexport interface ApiServerTiming {\n  readonly totalMs: number | null;\n  readonly databaseMs: number | null;\n}\n\nfunction readDuration(parameters: readonly string[]): number | null {\n  for (const parameter of parameters) {\n    const separator = parameter.indexOf(\"=\");\n    if (separator < 0) continue;\n    if (parameter.slice(0, separator).trim().toLowerCase() !== \"dur\") continue;\n    const value = parameter\n      .slice(separator + 1)\n      .trim()\n      .replace(/^\"(.*)\"$/, \"$1\");\n    // Only the first `dur` counts; a malformed one leaves the metric unset.\n    if (!/^\\d+(\\.\\d+)?$/.test(value)) return null;\n    return Number(value);\n  }\n  return null;\n}\n\n/**\n * Reads `total;dur=<ms>, db;dur=<ms>` in any order. Unknown metrics, missing\n * metrics and malformed durations are ignored; the first entry of a metric\n * wins. Returns null when neither metric is present.\n */\nexport function parseServerTiming(\n  header: string | null,\n): ApiServerTiming | null {\n  if (header === null) return null;\n  let totalMs: number | null = null;\n  let databaseMs: number | null = null;\n  const seen = new Set<string>();\n  for (const entry of header.split(\",\")) {\n    const [name = \"\", ...parameters] = entry.split(\";\");\n    const metric = name.trim().toLowerCase();\n    if (metric !== \"total\" && metric !== \"db\") continue;\n    if (seen.has(metric)) continue;\n    seen.add(metric);\n    const duration = readDuration(parameters);\n    if (metric === \"total\") totalMs = duration;\n    else databaseMs = duration;\n  }\n  return totalMs === null && databaseMs === null\n    ? null\n    : { totalMs, databaseMs };\n}\n"]}

package/internal/validators/documentCreateSeedRefinements.js

@@ -0,0 +1,9 @@
+export const documentCreateSeedRefinement = {
+    description: "a document create seed must contain exactly one outgoing update and no container rekeys, and serialize within the document sync request limit",
+    id: "request.document-create-seed",
+};
+export const containerCreateMetadataSeedRefinement = {
+    description: "a container create metadata seed must contain exactly one outgoing update and no container rekeys, and serialize within the document sync request limit",
+    id: "request.container-create-metadata-seed",
+};
+//# sourceMappingURL=documentCreateSeedRefinements.js.map

package/internal/validators/documentCreateSeedRefinements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentCreateSeedRefinements.js","sourceRoot":"","sources":["documentCreateSeedRefinements.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,WAAW,EACT,+IAA+I;IACjJ,EAAE,EAAE,8BAA8B;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,WAAW,EACT,yJAAyJ;IAC3J,EAAE,EAAE,wCAAwC;CACpC,CAAC","sourcesContent":["export const documentCreateSeedRefinement = {\n  description:\n    \"a document create seed must contain exactly one outgoing update and no container rekeys, and serialize within the document sync request limit\",\n  id: \"request.document-create-seed\",\n} as const;\n\nexport const containerCreateMetadataSeedRefinement = {\n  description:\n    \"a container create metadata seed must contain exactly one outgoing update and no container rekeys, and serialize within the document sync request limit\",\n  id: \"request.container-create-metadata-seed\",\n} as const;\n"]}