weflayr 0.28.0 → 0.29.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "weflayr",
-    "version": "0.28.0",
+    "version": "0.29.0",
     "description": "Weflayr JS/TS SDK — instrument any LLM client",
     "main": "dist/src/index.js",
     "types": "dist/src/index.d.ts",
@@ -39,7 +39,7 @@
         "async-retry": "^1.3.3"
     },
     "overrides": {
-        "js-yaml": "^4.3.1"
+        "js-yaml": "^4.3.2"
     },
     "devDependencies": {
         "@hey-api/openapi-ts": "^0.99.0",

package/dist/src/auto-instrument.js

@@ -14,7 +14,7 @@ exports.AiSdk = Object.freeze({
     ELEVENLABS: 'elevenlabs',
     MISTRAL: 'mistral',
 });
-// Allowed values for `propagateMetadata({ providerNameOverride })`: the actual AI
+// Allowed values for `propagateMetadata({ providerNameOverrideIfTelemetryInstrumentation })`: the actual AI
 // providers a call can be attributed to. Unlike AiSdk this names providers,
 // not SDKs — google-genai is an SDK whose calls are labeled google or vertex,
 // and mistral can also be reached through the OpenAI SDK (OpenAI-compatible

package/dist/src/otel/propagation.d.ts

@@ -10,14 +10,14 @@ declare const EXTRA_TAG_PREFIX = "weflayr.tag.";
 export interface PropagateMetadataOptions {
     /** Product-side feature triggering the LLM call (e.g. `"onboarding-summary"`). */
     featureName: string;
-    /** Name of the end-user / tenant customer the call is made for. */
-    customerName: string;
     /**
-     * Override for the provider seen on the wire. Set this only if it differs
-     * from the SDK auto-detected by OpenTelemetry, e.g. Mistral calls made
-     * through the OpenAI SDK, which should be reported as `mistral`.
+     * Name of the end-user / tenant customer the call is made for. When
+     * omitted, the calls are recorded with no customer. A call sent through the
+     * Weflayr AI gateway can name its customer in the request body instead,
+     * e.g. `{ ..., weflayr: { customer_name: 'Acme' } }`, which suits a
+     * customer known only where the call is made.
      */
-    providerNameOverride?: AIProviderName;
+    customerName?: string;
     /**
      * Arbitrary scalar key/value pairs to attach. Values must be `string`,
      * `number`, or `boolean` so they survive the ClickHouse `Map(String,
@@ -32,6 +32,15 @@ export interface PropagateMetadataOptions {
      * hexadecimal characters. When omitted, each invocation creates its own.
      */
     featureRunUuid?: string;
+    /**
+     * Override for the provider seen on the wire, for a call the SDK's telemetry
+     * instrumentation records. Set this only if it differs from the SDK
+     * auto-detected by OpenTelemetry, e.g. Mistral calls made through the OpenAI
+     * SDK, which should be reported as `mistral`. Ignored, with a warning, for a
+     * call sent through the Weflayr AI gateway, which reports the provider it
+     * called itself.
+     */
+    providerNameOverrideIfTelemetryInstrumentation?: AIProviderName;
 }
 export declare function getMergedMetadataFromContext(parentContext?: Context): Record<string, unknown>;
 /**

package/dist/src/otel/propagation.js

@@ -7,7 +7,8 @@
 // This file has been modified from its original form:
 //   - Translated from TypeScript to JavaScript
 //   - Replaced Langfuse's fixed schema with Weflayr's structured metadata
-//     (featureName, customerName, providerNameOverride, extraTags) plus an
+//     (featureName, customerName, extraTags,
+//     providerNameOverrideIfTelemetryInstrumentation) plus an
 //     auto-generated per-call uuid
 //   - Added `setCallName`, a nested scope naming one LLM call
 //   - Removed asBaggage cross-process propagation (not needed yet)
@@ -45,17 +46,20 @@ function getMergedMetadataFromContext(parentContext) {
     const existing = ctx.getValue(WEFLAYR_METADATA_CONTEXT_KEY);
     return existing && typeof existing === 'object' ? { ...existing } : {};
 }
-function _buildAttributes({ featureName, customerName, providerNameOverride, extraTags, spanUuid, }) {
+function _buildAttributes({ featureName, customerName, extraTags, spanUuid, providerNameOverrideIfTelemetryInstrumentation, }) {
     const attributes = {
         [FEATURE_NAME_ATTR]: featureName,
-        [CUSTOMER_NAME_ATTR]: customerName,
         [UUID_ATTR]: spanUuid,
     };
     for (const [key, value] of Object.entries(extraTags)) {
         attributes[`${EXTRA_TAG_PREFIX}${key}`] = value;
     }
-    if (providerNameOverride !== undefined && providerNameOverride !== null) {
-        attributes[BILLING_PROVIDER_ATTR] = providerNameOverride;
+    if (customerName !== undefined && customerName !== null) {
+        attributes[CUSTOMER_NAME_ATTR] = customerName;
+    }
+    if (providerNameOverrideIfTelemetryInstrumentation !== undefined &&
+        providerNameOverrideIfTelemetryInstrumentation !== null) {
+        attributes[BILLING_PROVIDER_ATTR] = providerNameOverrideIfTelemetryInstrumentation;
     }
     return attributes;
 }
@@ -74,9 +78,8 @@ function createFeatureRunUuid() {
     return (0, node_crypto_1.randomUUID)().replace(/-/g, '');
 }
 function propagateMetadata(options, fn) {
-    const { featureName, customerName } = options ?? {};
-    if (featureName == null || customerName == null) {
-        throw new Error('propagateMetadata: `featureName` and `customerName` are required');
+    if (options?.featureName == null) {
+        throw new Error('propagateMetadata: `featureName` is required');
     }
     if (options.featureRunUuid !== undefined &&
         !FEATURE_RUN_UUID_PATTERN.test(options.featureRunUuid)) {
@@ -103,13 +106,13 @@ function propagateMetadata(options, fn) {
     };
 }
 function _runWithMetadata(options, fn) {
-    const { featureName, customerName, providerNameOverride, extraTags, featureRunUuid } = options;
+    const { featureName, customerName, extraTags, featureRunUuid, providerNameOverrideIfTelemetryInstrumentation, } = options;
     return _runWithAttributes(_buildAttributes({
         featureName,
         customerName,
-        providerNameOverride,
         extraTags: extraTags ?? {},
         spanUuid: featureRunUuid ?? createFeatureRunUuid(),
+        providerNameOverrideIfTelemetryInstrumentation,
     }), fn);
 }
 function _runWithAttributes(attributes, fn) {

package/dist/src/propagate-metadata-to-gateway.js

@@ -63,7 +63,7 @@ function escapeNonAscii(json) {
 function buildMetadataHeaderValue() {
     const metadata = (0, propagation_1.getMergedMetadataFromContext)();
     if (propagation_1.BILLING_PROVIDER_ATTR in metadata) {
-        process.emitWarning('propagateMetadata: `providerNameOverride` is ignored for a call sent to the ' +
+        process.emitWarning('propagateMetadata: `providerNameOverrideIfTelemetryInstrumentation` is ignored for a call sent to the ' +
             'Weflayr AI gateway, which reports the provider it called itself');
     }
     const payload = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weflayr",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Weflayr JS/TS SDK — instrument any LLM client",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -39,7 +39,7 @@
     "async-retry": "^1.3.3"
   },
   "overrides": {
-    "js-yaml": "^4.3.1"
+    "js-yaml": "^4.3.2"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.99.0",