weflayr 0.24.0 → 0.26.1

package/README.md

@@ -1,6 +1,6 @@
-# Weflayr Node.js SDK
+# Weflayr JS/TS SDK
 
-Observability for Node.js — instrument any LLM client or function with one line.
+Observability for JS/TS — instrument any LLM client or function with one line.
 
 ## Install
 

package/dist/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "weflayr",
+    "version": "0.26.1",
+    "description": "Weflayr JS/TS SDK — instrument any LLM client",
+    "main": "dist/src/index.js",
+    "types": "dist/src/index.d.ts",
+    "files": [
+        "dist/src",
+        "dist/package.json"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "generate-api": "openapi-ts && node scripts/generate_facade.mjs",
+        "pretest": "npm run build",
+        "prepublishOnly": "npm run build",
+        "test": "node --test",
+        "lint": "eslint src tests",
+        "lint:fix": "eslint src tests --fix",
+        "format": "prettier --write src tests",
+        "format:check": "prettier --check src tests"
+    },
+    "keywords": [
+        "llm",
+        "observability",
+        "weflayr"
+    ],
+    "author": "Weflayr <contact@weflayr.com>",
+    "license": "Elastic-2.0",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "dependencies": {
+        "@opentelemetry/api": "^1.9.1",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
+        "@opentelemetry/instrumentation": "^0.219.0",
+        "@opentelemetry/resources": "^2.8.0",
+        "@opentelemetry/sdk-trace-base": "^2.8.0",
+        "@opentelemetry/sdk-trace-node": "^2.8.0",
+        "async-retry": "^1.3.3"
+    },
+    "devDependencies": {
+        "@hey-api/openapi-ts": "^0.99.0",
+        "@opentelemetry/context-async-hooks": "^2.8.0",
+        "@types/async-retry": "^1.4.9",
+        "@types/node": "^26.1.1",
+        "eslint": "^9.18.0",
+        "prettier": "^3.4.2",
+        "typescript": "^6.0.3",
+        "typescript-eslint": "^8.65.0"
+    }
+}

package/dist/{api → src/api}/generated/facade.gen.d.ts

@@ -1,30 +1,70 @@
 import type { CamelCaseDeep } from '../caseConversion.js';
 import type * as generatedTypes from './types.gen.js';
-export declare const getMargin: (options: import("../makeEndpoint.js").ClientOption & {
-    query?: {
-        customerNames?: string[] | undefined;
-        cursor?: string | undefined;
+export declare const getCosts: (options: import("../makeEndpoint.js").ClientOption & {
+    query?: undefined;
+    body: {
+        dateFrom: string;
+        dateTo?: string | undefined;
+        applyCredits?: boolean | undefined;
+        aggregate?: "day" | "week" | "month" | "quarter" | "year" | "all" | undefined;
+        groupBy?: "customer" | "feature" | "model" | "provider" | null | undefined;
+        customers?: string[] | undefined;
+        features?: string[] | undefined;
+        models?: string[] | undefined;
+        providers?: string[] | undefined;
+        cursor?: string | null | undefined;
         limit?: number | undefined;
-        dateFrom?: string | undefined;
+        customerTags?: {
+            [x: string]: string[];
+        } | undefined;
+        runTags?: {
+            [x: string]: string[];
+        } | undefined;
+    };
+    path?: undefined;
+}) => Promise<import("../makeEndpoint.js").CallResult<{
+    rows: {
+        dateFrom: string;
+        dateTo: string;
+        customer?: string | null | undefined;
+        feature?: string | null | undefined;
+        model?: string | null | undefined;
+        provider?: string | null | undefined;
+        cost: number;
+        avgFeatureRunCost: number;
+        maxFeatureRunCost: number;
+    }[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}, CamelCaseDeep<generatedTypes.GetCostsError>>>;
+export declare const getMargin: (options: import("../makeEndpoint.js").ClientOption & {
+    query?: undefined;
+    body: {
+        dateFrom: string;
         dateTo?: string | undefined;
         applyCredits?: boolean | undefined;
-    } | undefined;
-    body?: undefined;
+        aggregate?: "day" | "week" | "month" | "quarter" | "year" | "all" | undefined;
+        groupBy?: "customer" | null | undefined;
+        customers?: string[] | undefined;
+        filterCustomersBasedOnFeatures?: string[] | undefined;
+        cursor?: string | null | undefined;
+        limit?: number | undefined;
+    };
     path?: undefined;
 }) => Promise<import("../makeEndpoint.js").CallResult<{
     rows: {
-        customerName: string;
+        dateFrom: string;
+        dateTo: string;
+        customer?: string | null | undefined;
         revenue: number;
         cost: number;
         margin: number;
         marginPct: number | null;
-        profitabilityStatus: "healthy" | "watch" | "at_risk" | "unprofitable" | "unknown";
+        riskStatus: "healthy" | "watch" | "at_risk" | "unprofitable" | "unknown";
     }[];
     nextCursor: string | null;
     hasMore: boolean;
-}, {
-    error: string;
-}>>;
+}, CamelCaseDeep<generatedTypes.GetMarginError>>>;
 export declare const deleteRevenue: (options: import("../makeEndpoint.js").ClientOption & {
     query: {
         customerNames: string[];
@@ -253,3 +293,37 @@ export declare const getFeatures: (options: import("../makeEndpoint.js").ClientO
 }, {
     error: string;
 }>>;
+export declare const getPerformance: (options: import("../makeEndpoint.js").ClientOption & {
+    query?: undefined;
+    body: {
+        dateFrom: string;
+        dateTo?: string | undefined;
+        applyCredits?: boolean | undefined;
+        aggregate?: "day" | "week" | "month" | "quarter" | "year" | "all" | undefined;
+        groupBy?: "user" | null | undefined;
+        users?: string[] | undefined;
+        filterUsersBasedOnFeatures?: string[] | undefined;
+        cursor?: string | null | undefined;
+        limit?: number | undefined;
+        userTags?: {
+            [x: string]: string[];
+        } | undefined;
+    };
+    path?: undefined;
+}) => Promise<import("../makeEndpoint.js").CallResult<{
+    rows: {
+        dateFrom: string;
+        dateTo: string;
+        user?: string | null | undefined;
+        cost: number;
+        keyMetrics: {
+            [x: string]: {
+                value: number;
+                totalCost: number;
+                costPerUnit: number;
+            };
+        };
+    }[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}, CamelCaseDeep<generatedTypes.GetPerformanceError>>>;

package/dist/{api → src/api}/generated/facade.gen.js

@@ -1,5 +1,5 @@
 "use strict";
-// Generated by services/sdk_node_js/scripts/generate_facade.mjs from
+// Generated by services/sdk_ts/scripts/generate_facade.mjs from
 // sdk.gen.ts. Do not edit by hand.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -35,9 +35,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFeatures = exports.getCustomers = exports.getProviders = exports.getModels = exports.getTags = exports.getProject = exports.setCustomersTags = exports.getCustomersTags = exports.deleteCustomersTags = exports.setKeyMetrics = exports.getKeyMetrics = exports.deleteKeyMetrics = exports.setRevenue = exports.getRevenue = exports.deleteRevenue = exports.getMargin = void 0;
+exports.getPerformance = exports.getFeatures = exports.getCustomers = exports.getProviders = exports.getModels = exports.getTags = exports.getProject = exports.setCustomersTags = exports.getCustomersTags = exports.deleteCustomersTags = exports.setKeyMetrics = exports.getKeyMetrics = exports.deleteKeyMetrics = exports.setRevenue = exports.getRevenue = exports.deleteRevenue = exports.getMargin = exports.getCosts = void 0;
 const makeEndpoint_js_1 = require("../makeEndpoint.js");
 const generated = __importStar(require("./sdk.gen.js"));
+exports.getCosts = (0, makeEndpoint_js_1.makeEndpoint)(generated.getCosts);
 exports.getMargin = (0, makeEndpoint_js_1.makeEndpoint)(generated.getMargin);
 exports.deleteRevenue = (0, makeEndpoint_js_1.makeEndpoint)(generated.deleteRevenue);
 exports.getRevenue = (0, makeEndpoint_js_1.makeEndpoint)(generated.getRevenue);
@@ -54,3 +55,4 @@ exports.getModels = (0, makeEndpoint_js_1.makeEndpoint)(generated.getModels);
 exports.getProviders = (0, makeEndpoint_js_1.makeEndpoint)(generated.getProviders);
 exports.getCustomers = (0, makeEndpoint_js_1.makeEndpoint)(generated.getCustomers);
 exports.getFeatures = (0, makeEndpoint_js_1.makeEndpoint)(generated.getFeatures);
+exports.getPerformance = (0, makeEndpoint_js_1.makeEndpoint)(generated.getPerformance);

package/dist/src/api/generated/index.d.ts

@@ -0,0 +1,2 @@
+export { deleteCustomersTags, deleteKeyMetrics, deleteRevenue, getCosts, getCustomers, getCustomersTags, getFeatures, getKeyMetrics, getMargin, getModels, getPerformance, getProject, getProviders, getRevenue, getTags, type Options, setCustomersTags, setKeyMetrics, setRevenue } from './sdk.gen.js';
+export type { AllCustomerTagsOutput, ApiErrorOutput, ClientOptions, CostRow, CostsInput, CostsOutput, CustomerOutput, CustomersOutput, CustomersUpdatedOutput, CustomerTags, CustomerTagsOutput, DeleteCustomersTagsData, DeleteCustomersTagsError, DeleteCustomersTagsErrors, DeleteCustomersTagsResponse, DeleteCustomersTagsResponses, DeleteKeyMetricsData, DeleteKeyMetricsError, DeleteKeyMetricsErrors, DeleteKeyMetricsResponse, DeleteKeyMetricsResponses, DeleteRevenueData, DeleteRevenueError, DeleteRevenueErrors, DeleteRevenueResponse, DeleteRevenueResponses, FeaturesOutput, GetCostsData, GetCostsError, GetCostsErrors, GetCostsResponse, GetCostsResponses, GetCustomersData, GetCustomersError, GetCustomersErrors, GetCustomersResponse, GetCustomersResponses, GetCustomersTagsData, GetCustomersTagsError, GetCustomersTagsErrors, GetCustomersTagsResponse, GetCustomersTagsResponses, GetFeaturesData, GetFeaturesError, GetFeaturesErrors, GetFeaturesResponse, GetFeaturesResponses, GetKeyMetricsData, GetKeyMetricsError, GetKeyMetricsErrors, GetKeyMetricsResponse, GetKeyMetricsResponses, GetMarginData, GetMarginError, GetMarginErrors, GetMarginResponse, GetMarginResponses, GetModelsData, GetModelsError, GetModelsErrors, GetModelsResponse, GetModelsResponses, GetPerformanceData, GetPerformanceError, GetPerformanceErrors, GetPerformanceResponse, GetPerformanceResponses, GetProjectData, GetProjectError, GetProjectErrors, GetProjectResponse, GetProjectResponses, GetProvidersData, GetProvidersError, GetProvidersErrors, GetProvidersResponse, GetProvidersResponses, GetRevenueData, GetRevenueError, GetRevenueErrors, GetRevenueResponse, GetRevenueResponses, GetTagsData, GetTagsError, GetTagsErrors, GetTagsResponse, GetTagsResponses, InvalidFieldDetail, InvalidPayloadOutput, KeyMetricOutput, KeyMetricRow, KeyMetricRowOutput, KeyMetricValue, MarginInput, MarginOutput, MarginRow, ModelsOutput, PerformanceInput, PerformanceOutput, PerformanceRow, ProjectOutput, ProvidersOutput, RevenueOrKeyMetricDeletedRowOutput, RevenueOrKeyMetricImportedRowOutput, RevenueOutput, RevenueRow, RevenueRowOutput, SetCustomersTagsData, SetCustomersTagsError, SetCustomersTagsErrors, SetCustomersTagsResponse, SetCustomersTagsResponses, SetCustomerTagsInput, SetKeyMetricsData, SetKeyMetricsError, SetKeyMetricsErrors, SetKeyMetricsInput, SetKeyMetricsResponse, SetKeyMetricsResponses, SetRevenueData, SetRevenueError, SetRevenueErrors, SetRevenueInput, SetRevenueResponse, SetRevenueResponses, TagsDeletedOutput, TagsOutput } from './types.gen.js';

package/dist/{api → src/api}/generated/index.js

@@ -1,17 +1,19 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setRevenue = exports.setKeyMetrics = exports.setCustomersTags = exports.getTags = exports.getRevenue = exports.getProviders = exports.getProject = exports.getModels = exports.getMargin = exports.getKeyMetrics = exports.getFeatures = exports.getCustomersTags = exports.getCustomers = exports.deleteRevenue = exports.deleteKeyMetrics = exports.deleteCustomersTags = void 0;
+exports.setRevenue = exports.setKeyMetrics = exports.setCustomersTags = exports.getTags = exports.getRevenue = exports.getProviders = exports.getProject = exports.getPerformance = exports.getModels = exports.getMargin = exports.getKeyMetrics = exports.getFeatures = exports.getCustomersTags = exports.getCustomers = exports.getCosts = exports.deleteRevenue = exports.deleteKeyMetrics = exports.deleteCustomersTags = void 0;
 var sdk_gen_js_1 = require("./sdk.gen.js");
 Object.defineProperty(exports, "deleteCustomersTags", { enumerable: true, get: function () { return sdk_gen_js_1.deleteCustomersTags; } });
 Object.defineProperty(exports, "deleteKeyMetrics", { enumerable: true, get: function () { return sdk_gen_js_1.deleteKeyMetrics; } });
 Object.defineProperty(exports, "deleteRevenue", { enumerable: true, get: function () { return sdk_gen_js_1.deleteRevenue; } });
+Object.defineProperty(exports, "getCosts", { enumerable: true, get: function () { return sdk_gen_js_1.getCosts; } });
 Object.defineProperty(exports, "getCustomers", { enumerable: true, get: function () { return sdk_gen_js_1.getCustomers; } });
 Object.defineProperty(exports, "getCustomersTags", { enumerable: true, get: function () { return sdk_gen_js_1.getCustomersTags; } });
 Object.defineProperty(exports, "getFeatures", { enumerable: true, get: function () { return sdk_gen_js_1.getFeatures; } });
 Object.defineProperty(exports, "getKeyMetrics", { enumerable: true, get: function () { return sdk_gen_js_1.getKeyMetrics; } });
 Object.defineProperty(exports, "getMargin", { enumerable: true, get: function () { return sdk_gen_js_1.getMargin; } });
 Object.defineProperty(exports, "getModels", { enumerable: true, get: function () { return sdk_gen_js_1.getModels; } });
+Object.defineProperty(exports, "getPerformance", { enumerable: true, get: function () { return sdk_gen_js_1.getPerformance; } });
 Object.defineProperty(exports, "getProject", { enumerable: true, get: function () { return sdk_gen_js_1.getProject; } });
 Object.defineProperty(exports, "getProviders", { enumerable: true, get: function () { return sdk_gen_js_1.getProviders; } });
 Object.defineProperty(exports, "getRevenue", { enumerable: true, get: function () { return sdk_gen_js_1.getRevenue; } });

package/dist/{api → src/api}/generated/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import type { Client, ClientMeta, Options as Options2, RequestResult, TDataShape } from './client/index.js';
-import type { DeleteCustomersTagsData, DeleteCustomersTagsErrors, DeleteCustomersTagsResponses, DeleteKeyMetricsData, DeleteKeyMetricsErrors, DeleteKeyMetricsResponses, DeleteRevenueData, DeleteRevenueErrors, DeleteRevenueResponses, GetCustomersData, GetCustomersErrors, GetCustomersResponses, GetCustomersTagsData, GetCustomersTagsErrors, GetCustomersTagsResponses, GetFeaturesData, GetFeaturesErrors, GetFeaturesResponses, GetKeyMetricsData, GetKeyMetricsErrors, GetKeyMetricsResponses, GetMarginData, GetMarginErrors, GetMarginResponses, GetModelsData, GetModelsErrors, GetModelsResponses, GetProjectData, GetProjectErrors, GetProjectResponses, GetProvidersData, GetProvidersErrors, GetProvidersResponses, GetRevenueData, GetRevenueErrors, GetRevenueResponses, GetTagsData, GetTagsErrors, GetTagsResponses, SetCustomersTagsData, SetCustomersTagsErrors, SetCustomersTagsResponses, SetKeyMetricsData, SetKeyMetricsErrors, SetKeyMetricsResponses, SetRevenueData, SetRevenueErrors, SetRevenueResponses } from './types.gen.js';
+import type { DeleteCustomersTagsData, DeleteCustomersTagsErrors, DeleteCustomersTagsResponses, DeleteKeyMetricsData, DeleteKeyMetricsErrors, DeleteKeyMetricsResponses, DeleteRevenueData, DeleteRevenueErrors, DeleteRevenueResponses, GetCostsData, GetCostsErrors, GetCostsResponses, GetCustomersData, GetCustomersErrors, GetCustomersResponses, GetCustomersTagsData, GetCustomersTagsErrors, GetCustomersTagsResponses, GetFeaturesData, GetFeaturesErrors, GetFeaturesResponses, GetKeyMetricsData, GetKeyMetricsErrors, GetKeyMetricsResponses, GetMarginData, GetMarginErrors, GetMarginResponses, GetModelsData, GetModelsErrors, GetModelsResponses, GetPerformanceData, GetPerformanceErrors, GetPerformanceResponses, GetProjectData, GetProjectErrors, GetProjectResponses, GetProvidersData, GetProvidersErrors, GetProvidersResponses, GetRevenueData, GetRevenueErrors, GetRevenueResponses, GetTagsData, GetTagsErrors, GetTagsResponses, SetCustomersTagsData, SetCustomersTagsErrors, SetCustomersTagsResponses, SetKeyMetricsData, SetKeyMetricsErrors, SetKeyMetricsResponses, SetRevenueData, SetRevenueErrors, SetRevenueResponses } from './types.gen.js';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -14,9 +14,13 @@ export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends
     meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;
 };
 /**
- * Per-customer gross margin, sorted by customer_name ascending; pass customer_names to narrow to specific customers, omit it for every customer's.
+ * Cost bucketed by aggregate and optionally grouped by one dimension (customer/feature/model/provider), with customer_tags/run_tags filters.
  */
-export declare const getMargin: <ThrowOnError extends boolean = false>(options?: Options<GetMarginData, ThrowOnError>) => RequestResult<GetMarginResponses, GetMarginErrors, ThrowOnError>;
+export declare const getCosts: <ThrowOnError extends boolean = false>(options: Options<GetCostsData, ThrowOnError>) => RequestResult<GetCostsResponses, GetCostsErrors, ThrowOnError>;
+/**
+ * Cost and revenue bucketed by aggregate and optionally grouped by customer, alongside the resulting margin and risk status.
+ */
+export declare const getMargin: <ThrowOnError extends boolean = false>(options: Options<GetMarginData, ThrowOnError>) => RequestResult<GetMarginResponses, GetMarginErrors, ThrowOnError>;
 /**
  * Delete the given customers' API-uploaded revenue values.
  */
@@ -77,3 +81,7 @@ export declare const getCustomers: <ThrowOnError extends boolean = false>(option
  * Every distinct feature tag seen for the project.
  */
 export declare const getFeatures: <ThrowOnError extends boolean = false>(options?: Options<GetFeaturesData, ThrowOnError>) => RequestResult<GetFeaturesResponses, GetFeaturesErrors, ThrowOnError>;
+/**
+ * Cost bucketed by aggregate and optionally grouped by user, alongside each key metric's value and cost-per-unit for the same period. Only available for internal-metric projects.
+ */
+export declare const getPerformance: <ThrowOnError extends boolean = false>(options: Options<GetPerformanceData, ThrowOnError>) => RequestResult<GetPerformanceResponses, GetPerformanceErrors, ThrowOnError>;

package/dist/{api → src/api}/generated/sdk.gen.js

@@ -1,15 +1,32 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFeatures = exports.getCustomers = exports.getProviders = exports.getModels = exports.getTags = exports.getProject = exports.setCustomersTags = exports.getCustomersTags = exports.deleteCustomersTags = exports.setKeyMetrics = exports.getKeyMetrics = exports.deleteKeyMetrics = exports.setRevenue = exports.getRevenue = exports.deleteRevenue = exports.getMargin = void 0;
+exports.getPerformance = exports.getFeatures = exports.getCustomers = exports.getProviders = exports.getModels = exports.getTags = exports.getProject = exports.setCustomersTags = exports.getCustomersTags = exports.deleteCustomersTags = exports.setKeyMetrics = exports.getKeyMetrics = exports.deleteKeyMetrics = exports.setRevenue = exports.getRevenue = exports.deleteRevenue = exports.getMargin = exports.getCosts = void 0;
 const client_gen_js_1 = require("./client.gen.js");
 /**
- * Per-customer gross margin, sorted by customer_name ascending; pass customer_names to narrow to specific customers, omit it for every customer's.
+ * Cost bucketed by aggregate and optionally grouped by one dimension (customer/feature/model/provider), with customer_tags/run_tags filters.
  */
-const getMargin = (options) => (options?.client ?? client_gen_js_1.client).get({
+const getCosts = (options) => (options.client ?? client_gen_js_1.client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/costs/',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+exports.getCosts = getCosts;
+/**
+ * Cost and revenue bucketed by aggregate and optionally grouped by customer, alongside the resulting margin and risk status.
+ */
+const getMargin = (options) => (options.client ?? client_gen_js_1.client).post({
     security: [{ scheme: 'bearer', type: 'http' }],
     url: '/margin/',
-    ...options
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
 });
 exports.getMargin = getMargin;
 /**
@@ -159,3 +176,16 @@ const getFeatures = (options) => (options?.client ?? client_gen_js_1.client).get
     ...options
 });
 exports.getFeatures = getFeatures;
+/**
+ * Cost bucketed by aggregate and optionally grouped by user, alongside each key metric's value and cost-per-unit for the same period. Only available for internal-metric projects.
+ */
+const getPerformance = (options) => (options.client ?? client_gen_js_1.client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/performance/',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+exports.getPerformance = getPerformance;