veryfront 0.1.911 → 0.1.913

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.911",
+    "version": "0.1.913",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/metrics/index.d.ts

@@ -26,6 +26,7 @@ export declare const metrics: {
     counter: typeof counter;
     histogram: typeof histogram;
     gauge: typeof gauge;
+    __flushForTests(): Promise<void>;
     __resetForTests(): void;
 };
 //# sourceMappingURL=index.d.ts.map

package/esm/src/metrics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,yBAAyB,CAAC;AAYjC,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0FD,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CASN;AAED,eAAO,MAAM,OAAO;;;;uBAIC,IAAI;CAKxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,yBAAyB,CAAC;AAcjC,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAuWD,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAON;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAON;AAED,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAaN;AAED,eAAO,MAAM,OAAO;;;;uBAIO,OAAO,CAAC,IAAI,CAAC;uBAGnB,IAAI;CAWxB,CAAC"}

package/esm/src/metrics/index.js

@@ -13,11 +13,18 @@
  * ```
  */
 import "../../_dnt.polyfills.js";
+import * as dntShim from "../../_dnt.shims.js";
 import { getGlobalMetricsAPI, } from "../observability/tracing/api-shim.js";
 import { getCurrentRequestContext } from "../platform/adapters/fs/veryfront/request-context.js";
 const counters = new Map();
 const histograms = new Map();
 const gauges = new Map();
+const directQueue = [];
+const directCounterTotals = new Map();
+let directFlushTimer = null;
+const DIRECT_FLUSH_DELAY_MS = 1_000;
+const DIRECT_MAX_BATCH_SIZE = 100;
+const HISTOGRAM_BOUNDS = [0, 10, 50, 100, 250, 500, 1_000, 2_500, 5_000, 10_000];
 function getMeter() {
     return getGlobalMetricsAPI()?.getMeter("veryfront.project.metrics");
 }
@@ -88,14 +95,259 @@ function getGauge(name, options) {
     gauges.set(name, gauge);
     return gauge;
 }
+function readEnv(name) {
+    try {
+        return dntShim.Deno.env.get(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveOtlpMetricsUrl() {
+    if (readEnv("OTEL_METRICS_ENABLED") !== "true")
+        return null;
+    const endpoint = readEnv("OTEL_EXPORTER_OTLP_METRICS_ENDPOINT") ??
+        readEnv("OTEL_EXPORTER_OTLP_ENDPOINT");
+    if (!endpoint)
+        return null;
+    const trimmed = endpoint.replace(/\/$/, "");
+    return trimmed.endsWith("/v1/metrics") ? trimmed : `${trimmed}/v1/metrics`;
+}
+function resolveInternalMetricsUrl() {
+    if (readEnv("OTEL_METRICS_ENABLED") !== "true")
+        return null;
+    const apiBaseUrl = readEnv("VERYFRONT_API_BASE_URL") ?? readEnv("VERYFRONT_API_URL");
+    const username = readEnv("VERYFRONT_API_INTERNAL_USER");
+    const password = readEnv("VERYFRONT_API_INTERNAL_PASS");
+    if (!apiBaseUrl || !username || !password)
+        return null;
+    return `${apiBaseUrl.replace(/\/$/, "")}/internal/metrics/otlp/v1/metrics`;
+}
+function buildBasicAuth(username, password) {
+    const credentials = `${username}:${password}`;
+    return `Basic ${globalThis.btoa(credentials)}`;
+}
+function parseHeaders(headerInput) {
+    if (!headerInput)
+        return {};
+    if (headerInput.startsWith("Basic "))
+        return { Authorization: headerInput };
+    if (headerInput.startsWith("Authorization=")) {
+        return { Authorization: headerInput.slice("Authorization=".length) };
+    }
+    const result = {};
+    for (const part of headerInput.split(",")) {
+        const [key, ...valueParts] = part.split("=");
+        if (key && valueParts.length > 0) {
+            result[key.trim()] = valueParts.join("=").trim();
+        }
+    }
+    return result;
+}
+function resolveDirectMetricsTarget() {
+    const internalUrl = resolveInternalMetricsUrl();
+    if (internalUrl) {
+        return {
+            url: internalUrl,
+            headers: {
+                Authorization: buildBasicAuth(readEnv("VERYFRONT_API_INTERNAL_USER") ?? "", readEnv("VERYFRONT_API_INTERNAL_PASS") ?? ""),
+            },
+        };
+    }
+    const otlpUrl = resolveOtlpMetricsUrl();
+    if (!otlpUrl)
+        return null;
+    return {
+        url: otlpUrl,
+        headers: parseHeaders(readEnv("OTEL_EXPORTER_OTLP_HEADERS")),
+    };
+}
+function toOtlpValue(value) {
+    if (typeof value === "boolean")
+        return { boolValue: value };
+    if (typeof value === "number")
+        return { doubleValue: value };
+    return { stringValue: String(value) };
+}
+function toOtlpAttributes(attributes) {
+    return Object.entries(attributes).map(([key, value]) => ({
+        key,
+        value: toOtlpValue(value),
+    }));
+}
+function getUnixNanoTimestamp() {
+    return String(BigInt(Date.now()) * 1000000n);
+}
+function buildHistogramBuckets(value) {
+    const counts = new Array(HISTOGRAM_BOUNDS.length + 1).fill(0);
+    const bucketIndex = HISTOGRAM_BOUNDS.findIndex((bound) => value <= bound);
+    counts[bucketIndex === -1 ? counts.length - 1 : bucketIndex] = 1;
+    return counts;
+}
+function buildDirectMetric(sample) {
+    const attributes = toOtlpAttributes(sample.attributes);
+    if (sample.kind === "counter") {
+        const key = `${sample.name}:${attributesKey(sample.attributes)}`;
+        const total = directCounterTotals.get(key) ?? {
+            value: 0,
+            startTimeUnixNano: sample.timestampUnixNano,
+        };
+        total.value += sample.value;
+        directCounterTotals.set(key, total);
+        return {
+            name: sample.name,
+            sum: {
+                dataPoints: [{
+                        attributes,
+                        startTimeUnixNano: total.startTimeUnixNano,
+                        timeUnixNano: sample.timestampUnixNano,
+                        asDouble: total.value,
+                    }],
+                aggregationTemporality: 2,
+                isMonotonic: true,
+            },
+        };
+    }
+    if (sample.kind === "histogram") {
+        return {
+            name: sample.name,
+            histogram: {
+                dataPoints: [{
+                        attributes,
+                        startTimeUnixNano: sample.timestampUnixNano,
+                        timeUnixNano: sample.timestampUnixNano,
+                        count: 1,
+                        sum: sample.value,
+                        explicitBounds: HISTOGRAM_BOUNDS,
+                        bucketCounts: buildHistogramBuckets(sample.value),
+                    }],
+                aggregationTemporality: 1,
+            },
+        };
+    }
+    return {
+        name: sample.name,
+        gauge: {
+            dataPoints: [{
+                    attributes,
+                    timeUnixNano: sample.timestampUnixNano,
+                    asDouble: sample.value,
+                }],
+        },
+    };
+}
+function buildDirectOtlpBody(samples) {
+    return {
+        resourceMetrics: [{
+                resource: {
+                    attributes: toOtlpAttributes({
+                        "service.name": readEnv("OTEL_SERVICE_NAME") ?? "veryfront",
+                        "service.version": readEnv("VERYFRONT_VERSION") ??
+                            readEnv("RELEASE_VERSION") ??
+                            "unknown",
+                    }),
+                },
+                scopeMetrics: [{
+                        scope: {
+                            name: "veryfront.project.metrics",
+                        },
+                        metrics: samples.map(buildDirectMetric),
+                    }],
+            }],
+    };
+}
+function logDirectExportFailure(error) {
+    if (readEnv("VERYFRONT_DEBUG") !== "1")
+        return;
+    console.warn("[metrics] direct OTLP export failed", error);
+}
+async function flushDirectMetrics() {
+    if (directFlushTimer) {
+        clearTimeout(directFlushTimer);
+        directFlushTimer = null;
+    }
+    const target = resolveDirectMetricsTarget();
+    if (!target || directQueue.length === 0) {
+        directQueue.length = 0;
+        return;
+    }
+    const batch = directQueue.splice(0, DIRECT_MAX_BATCH_SIZE);
+    try {
+        const response = await fetch(target.url, {
+            method: "POST",
+            headers: {
+                ...target.headers,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(buildDirectOtlpBody(batch)),
+        });
+        if (!response.ok) {
+            logDirectExportFailure(`HTTP ${response.status}`);
+        }
+    }
+    catch (error) {
+        logDirectExportFailure(error);
+    }
+    if (directQueue.length > 0) {
+        scheduleDirectFlush();
+    }
+}
+function scheduleDirectFlush() {
+    if (directFlushTimer || resolveDirectMetricsTarget() === null)
+        return;
+    directFlushTimer = dntShim.setTimeout(() => {
+        void flushDirectMetrics();
+    }, DIRECT_FLUSH_DELAY_MS);
+    try {
+        if (typeof directFlushTimer === "number") {
+            dntShim.Deno.unrefTimer(directFlushTimer);
+        }
+        else {
+            directFlushTimer.unref?.();
+        }
+    }
+    catch {
+        // Some runtimes do not expose unref support; exporting still works there.
+    }
+}
+function enqueueDirectMetric(kind, name, value, attributes) {
+    if (resolveDirectMetricsTarget() === null)
+        return;
+    directQueue.push({
+        kind,
+        name,
+        value,
+        attributes,
+        timestampUnixNano: getUnixNanoTimestamp(),
+    });
+    if (directQueue.length >= DIRECT_MAX_BATCH_SIZE) {
+        void flushDirectMetrics();
+        return;
+    }
+    scheduleDirectFlush();
+}
 export function counter(name, value = 1, attributes, options) {
-    getCounter(name, options)?.add(value, normalizeAttributes(attributes));
+    const normalizedAttributes = normalizeAttributes(attributes);
+    if (resolveDirectMetricsTarget() === null) {
+        getCounter(name, options)?.add(value, normalizedAttributes);
+        return;
+    }
+    enqueueDirectMetric("counter", name, value, normalizedAttributes);
 }
 export function histogram(name, value, attributes, options) {
-    getHistogram(name, options)?.record(value, normalizeAttributes(attributes));
+    const normalizedAttributes = normalizeAttributes(attributes);
+    if (resolveDirectMetricsTarget() === null) {
+        getHistogram(name, options)?.record(value, normalizedAttributes);
+        return;
+    }
+    enqueueDirectMetric("histogram", name, value, normalizedAttributes);
 }
 export function gauge(name, value, attributes, options) {
     const normalizedAttributes = normalizeAttributes(attributes);
+    if (resolveDirectMetricsTarget() !== null) {
+        enqueueDirectMetric("gauge", name, value, normalizedAttributes);
+        return;
+    }
     const target = getGauge(name, options);
     if (!target)
         return;
@@ -108,9 +360,18 @@ export const metrics = {
     counter,
     histogram,
     gauge,
+    async __flushForTests() {
+        await flushDirectMetrics();
+    },
     __resetForTests() {
         counters.clear();
         histograms.clear();
         gauges.clear();
+        directQueue.length = 0;
+        directCounterTotals.clear();
+        if (directFlushTimer) {
+            clearTimeout(directFlushTimer);
+            directFlushTimer = null;
+        }
     },
 };

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.911";
+export declare const VERSION = "0.1.913";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.911";
+export const VERSION = "0.1.913";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.911",
+  "version": "0.1.913",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",