moqtail 0.8.0 → 0.9.0

package/dist/util.cjs

@@ -0,0 +1,102 @@
+'use strict';
+
+// src/util/telemetry.ts
+var NetworkTelemetry = class {
+  events = [];
+  windowMs;
+  constructor(windowMs = 1e3) {
+    this.windowMs = windowMs;
+  }
+  push({ latency, size }) {
+    const now = Date.now();
+    this.events.push({ timestamp: now, latency, size });
+  }
+  clean() {
+    const cutoff = Date.now() - this.windowMs;
+    while (this.events.length && this.events[0] && this.events[0].timestamp < cutoff) {
+      this.events.shift();
+    }
+  }
+  get throughput() {
+    this.clean();
+    const totalBytes = this.events.reduce((sum, e) => sum + e.size, 0);
+    return totalBytes / (this.windowMs / 1e3);
+  }
+  get latency() {
+    this.clean();
+    if (!this.events.length) return 0;
+    return this.events.reduce((sum, e) => sum + e.latency, 0) / this.events.length;
+  }
+};
+
+// src/util/clock_normalizer.ts
+var DEFAULT_SAMPLE_SIZE = 5;
+var DEFAULT_TIME_SERVER = "https://time.akamai.com/?ms";
+var ClockNormalizer = class _ClockNormalizer {
+  offset;
+  timeServerUrl;
+  numSamples;
+  constructor(timeServerUrl, offset, numSamples) {
+    this.timeServerUrl = timeServerUrl;
+    this.offset = offset;
+    this.numSamples = numSamples;
+  }
+  static async create(timeServerUrl, numberOfSamples) {
+    const url = timeServerUrl ? timeServerUrl : DEFAULT_TIME_SERVER;
+    const numSamples = numberOfSamples ? numberOfSamples : DEFAULT_SAMPLE_SIZE;
+    const offset = await _ClockNormalizer.calculateSkew(url, numSamples);
+    return new _ClockNormalizer(url, offset, numSamples);
+  }
+  getSkew() {
+    return this.offset;
+  }
+  now() {
+    return Date.now() - this.offset;
+  }
+  async recalibrate() {
+    this.offset = await _ClockNormalizer.calculateSkew(this.timeServerUrl, this.numSamples);
+    return this.offset;
+  }
+  static async calculateSkew(timeServerUrl, numSamples) {
+    const samples = [];
+    for (let i = 0; i < numSamples; i++) {
+      const sample = await _ClockNormalizer.takeSingleSample(timeServerUrl);
+      if (sample !== null) {
+        samples.push(sample);
+      }
+      if (i < numSamples - 1) {
+        await new Promise((resolve) => setTimeout(resolve, 20));
+      }
+    }
+    if (samples.length === 0) {
+      throw new Error("Failed to get any valid samples");
+    }
+    const offsets = samples.map((s) => s.offset);
+    const average = offsets.reduce((sum, offset) => sum + offset, 0) / offsets.length;
+    return Math.round(average);
+  }
+  static async takeSingleSample(timeServerUrl) {
+    const separator = timeServerUrl.includes("?") ? "&" : "?";
+    const url = `${timeServerUrl}${separator}_=${Date.now()}`;
+    const t0 = performance.now();
+    const localTimeBeforeRequest = Date.now();
+    const response = await fetch(url, { cache: "no-store" });
+    const serverTimeText = await response.text();
+    const t1 = performance.now();
+    const localTimeAfterRequest = Date.now();
+    const serverTime = parseFloat(serverTimeText);
+    if (isNaN(serverTime)) {
+      return null;
+    }
+    const serverTimeMs = serverTime * 1e3;
+    const rtt = t1 - t0;
+    const oneWayDelay = rtt / 2;
+    const avgLocalTime = (localTimeBeforeRequest + localTimeAfterRequest) / 2;
+    const localTimeAtServer = avgLocalTime - oneWayDelay;
+    const offset = localTimeAtServer - serverTimeMs;
+    return { offset, rtt };
+  }
+};
+
+exports.ClockNormalizer = ClockNormalizer;
+exports.NetworkTelemetry = NetworkTelemetry;

package/dist/util.d.cts

@@ -0,0 +1,57 @@
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare class NetworkTelemetry {
+    private events;
+    private windowMs;
+    constructor(windowMs?: number);
+    push({ latency, size }: {
+        latency: number;
+        size: number;
+    }): void;
+    private clean;
+    get throughput(): number;
+    get latency(): number;
+}
+
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare class ClockNormalizer {
+    private offset;
+    private timeServerUrl;
+    private numSamples;
+    private constructor();
+    static create(timeServerUrl?: string, numberOfSamples?: number): Promise<ClockNormalizer>;
+    getSkew(): number;
+    now(): number;
+    recalibrate(): Promise<number>;
+    private static calculateSkew;
+    private static takeSingleSample;
+}
+
+export { ClockNormalizer, NetworkTelemetry };

package/dist/util.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare class NetworkTelemetry {
+    private events;
+    private windowMs;
+    constructor(windowMs?: number);
+    push({ latency, size }: {
+        latency: number;
+        size: number;
+    }): void;
+    private clean;
+    get throughput(): number;
+    get latency(): number;
+}
+
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare class ClockNormalizer {
+    private offset;
+    private timeServerUrl;
+    private numSamples;
+    private constructor();
+    static create(timeServerUrl?: string, numberOfSamples?: number): Promise<ClockNormalizer>;
+    getSkew(): number;
+    now(): number;
+    recalibrate(): Promise<number>;
+    private static calculateSkew;
+    private static takeSingleSample;
+}
+
+export { ClockNormalizer, NetworkTelemetry };

package/dist/util.js

@@ -0,0 +1,99 @@
+// src/util/telemetry.ts
+var NetworkTelemetry = class {
+  events = [];
+  windowMs;
+  constructor(windowMs = 1e3) {
+    this.windowMs = windowMs;
+  }
+  push({ latency, size }) {
+    const now = Date.now();
+    this.events.push({ timestamp: now, latency, size });
+  }
+  clean() {
+    const cutoff = Date.now() - this.windowMs;
+    while (this.events.length && this.events[0] && this.events[0].timestamp < cutoff) {
+      this.events.shift();
+    }
+  }
+  get throughput() {
+    this.clean();
+    const totalBytes = this.events.reduce((sum, e) => sum + e.size, 0);
+    return totalBytes / (this.windowMs / 1e3);
+  }
+  get latency() {
+    this.clean();
+    if (!this.events.length) return 0;
+    return this.events.reduce((sum, e) => sum + e.latency, 0) / this.events.length;
+  }
+};
+
+// src/util/clock_normalizer.ts
+var DEFAULT_SAMPLE_SIZE = 5;
+var DEFAULT_TIME_SERVER = "https://time.akamai.com/?ms";
+var ClockNormalizer = class _ClockNormalizer {
+  offset;
+  timeServerUrl;
+  numSamples;
+  constructor(timeServerUrl, offset, numSamples) {
+    this.timeServerUrl = timeServerUrl;
+    this.offset = offset;
+    this.numSamples = numSamples;
+  }
+  static async create(timeServerUrl, numberOfSamples) {
+    const url = timeServerUrl ? timeServerUrl : DEFAULT_TIME_SERVER;
+    const numSamples = numberOfSamples ? numberOfSamples : DEFAULT_SAMPLE_SIZE;
+    const offset = await _ClockNormalizer.calculateSkew(url, numSamples);
+    return new _ClockNormalizer(url, offset, numSamples);
+  }
+  getSkew() {
+    return this.offset;
+  }
+  now() {
+    return Date.now() - this.offset;
+  }
+  async recalibrate() {
+    this.offset = await _ClockNormalizer.calculateSkew(this.timeServerUrl, this.numSamples);
+    return this.offset;
+  }
+  static async calculateSkew(timeServerUrl, numSamples) {
+    const samples = [];
+    for (let i = 0; i < numSamples; i++) {
+      const sample = await _ClockNormalizer.takeSingleSample(timeServerUrl);
+      if (sample !== null) {
+        samples.push(sample);
+      }
+      if (i < numSamples - 1) {
+        await new Promise((resolve) => setTimeout(resolve, 20));
+      }
+    }
+    if (samples.length === 0) {
+      throw new Error("Failed to get any valid samples");
+    }
+    const offsets = samples.map((s) => s.offset);
+    const average = offsets.reduce((sum, offset) => sum + offset, 0) / offsets.length;
+    return Math.round(average);
+  }
+  static async takeSingleSample(timeServerUrl) {
+    const separator = timeServerUrl.includes("?") ? "&" : "?";
+    const url = `${timeServerUrl}${separator}_=${Date.now()}`;
+    const t0 = performance.now();
+    const localTimeBeforeRequest = Date.now();
+    const response = await fetch(url, { cache: "no-store" });
+    const serverTimeText = await response.text();
+    const t1 = performance.now();
+    const localTimeAfterRequest = Date.now();
+    const serverTime = parseFloat(serverTimeText);
+    if (isNaN(serverTime)) {
+      return null;
+    }
+    const serverTimeMs = serverTime * 1e3;
+    const rtt = t1 - t0;
+    const oneWayDelay = rtt / 2;
+    const avgLocalTime = (localTimeBeforeRequest + localTimeAfterRequest) / 2;
+    const localTimeAtServer = avgLocalTime - oneWayDelay;
+    const offset = localTimeAtServer - serverTimeMs;
+    return { offset, rtt };
+  }
+};
+
+export { ClockNormalizer, NetworkTelemetry };