weflayr 0.22.1 → 0.23.0

package/dist/api/generated/types.gen.d.ts

@@ -31,6 +31,37 @@ export type ApiErrorOutput = {
      */
     error: string;
 };
+/**
+ * CustomerMarginRow
+ *
+ * One customer's gross margin for a period.
+ */
+export type CustomerMarginRow = {
+    /**
+     * Customer Name
+     */
+    customer_name: string;
+    /**
+     * Revenue
+     */
+    revenue: number;
+    /**
+     * Cost
+     */
+    cost: number;
+    /**
+     * Margin
+     */
+    margin: number;
+    /**
+     * Margin Pct
+     */
+    margin_pct: number | null;
+    /**
+     * Profitability Status
+     */
+    profitability_status: 'healthy' | 'watch' | 'at_risk' | 'unprofitable' | 'unknown';
+};
 /**
  * CustomerTags
  *
@@ -138,11 +169,11 @@ export type KeyMetricOutput = {
  */
 export type KeyMetricRow = {
     /**
-     * User Defined Id
+     * Metric Id
      *
      * Your own id for this value. Omit it to book a new value; reuse a previous one to update it (needs "upsert": true, see the "upsert" field).
      */
-    user_defined_id?: string | null;
+    metric_id?: string | null;
     /**
      * User Name
      */
@@ -154,7 +185,7 @@ export type KeyMetricRow = {
     /**
      * Amount
      */
-    amount: number | string;
+    amount: number;
     /**
      * Month
      */
@@ -174,10 +205,6 @@ export type KeyMetricRow = {
  * One booked key-metric value.
  */
 export type KeyMetricRowOutput = {
-    /**
-     * User Defined Id
-     */
-    user_defined_id: string;
     /**
      * Metric Name
      */
@@ -189,16 +216,40 @@ export type KeyMetricRowOutput = {
     /**
      * Amount
      */
-    amount: string;
+    amount: number;
     /**
      * Source
      */
     source: string;
+    /**
+     * Metric Id
+     */
+    metric_id: string;
     /**
      * User Name
      */
     user_name: string;
 };
+/**
+ * MarginListOutput
+ *
+ * Margin GET response: one row per customer with booked revenue, sorted by
+ * customer_name ascending.
+ */
+export type MarginListOutput = {
+    /**
+     * Rows
+     */
+    rows: Array<CustomerMarginRow>;
+    /**
+     * Next Cursor
+     */
+    next_cursor: string | null;
+    /**
+     * Has More
+     */
+    has_more: boolean;
+};
 /**
  * RevenueOrKeyMetricDeletedRowOutput
  *
@@ -256,11 +307,11 @@ export type RevenueOutput = {
  */
 export type RevenueRow = {
     /**
-     * User Defined Id
+     * Revenue Id
      *
      * Your own id for this value. Omit it to book a new value; reuse a previous one to update it (needs "upsert": true, see the "upsert" field).
      */
-    user_defined_id?: string | null;
+    revenue_id?: string | null;
     /**
      * Customer Name
      */
@@ -268,7 +319,7 @@ export type RevenueRow = {
     /**
      * Amount
      */
-    amount: number | string;
+    amount: number;
     /**
      * Month
      */
@@ -288,10 +339,6 @@ export type RevenueRow = {
  * One booked revenue value.
  */
 export type RevenueRowOutput = {
-    /**
-     * User Defined Id
-     */
-    user_defined_id: string;
     /**
      * Metric Name
      */
@@ -303,11 +350,15 @@ export type RevenueRowOutput = {
     /**
      * Amount
      */
-    amount: string;
+    amount: number;
     /**
      * Source
      */
     source: string;
+    /**
+     * Revenue Id
+     */
+    revenue_id: string;
     /**
      * Customer Name
      */
@@ -335,7 +386,7 @@ export type SetCustomerTagsInput = {
  *
  * The key-metric values posted to the public API. A user may have
  * several lines of the same metric in the same month; rows are only ever
- * matched against each other by user_defined_id, never by (user, metric,
+ * matched against each other by metric_id, never by (user, metric,
  * month).
  */
 export type SetKeyMetricsInput = {
@@ -346,7 +397,7 @@ export type SetKeyMetricsInput = {
     /**
      * Upsert
      *
-     * If a row's user_defined_id already exists, overwrite it instead of rejecting the request.
+     * If a row's metric_id already exists, overwrite it instead of rejecting the request.
      */
     upsert?: boolean;
 };
@@ -355,7 +406,7 @@ export type SetKeyMetricsInput = {
  *
  * The revenue values posted to the public API. A customer may have several
  * revenue lines in the same month (e.g. one per product or contract); rows
- * are only ever matched against each other by user_defined_id, never by
+ * are only ever matched against each other by revenue_id, never by
  * (customer, month).
  */
 export type SetRevenueInput = {
@@ -366,7 +417,7 @@ export type SetRevenueInput = {
     /**
      * Upsert
      *
-     * If a row's user_defined_id already exists, overwrite it instead of rejecting the request.
+     * If a row's revenue_id already exists, overwrite it instead of rejecting the request.
      */
     upsert?: boolean;
 };
@@ -385,39 +436,72 @@ export type TagsDeletedOutput = {
      */
     tags_deleted: number;
 };
-export type GetAllRevenueData = {
+export type GetMarginData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Return only these customers' margin. Omit to return every customer's.
+         */
+        customer_names?: Array<string>;
         /**
          * Opaque cursor from a previous page's next_cursor.
          */
         cursor?: string;
         limit?: number;
+        /**
+         * Start of the period (inclusive), YYYY-MM-DD. Defaults to 30 days ago.
+         */
+        date_from?: string;
+        /**
+         * End of the period (inclusive), YYYY-MM-DD. Defaults to today.
+         */
+        date_to?: string;
+        /**
+         * Apply free-credit discounts to cost. Defaults to false.
+         */
+        apply_credits?: boolean;
     };
-    url: '/revenue/';
+    url: '/margin/';
 };
-export type GetAllRevenueErrors = {
+export type GetMarginErrors = {
+    /**
+     * Invalid request for this project type.
+     */
+    400: ApiErrorOutput;
     /**
      * Missing or invalid API key.
      */
     401: ApiErrorOutput;
 };
-export type GetAllRevenueError = GetAllRevenueErrors[keyof GetAllRevenueErrors];
-export type GetAllRevenueResponses = {
+export type GetMarginError = GetMarginErrors[keyof GetMarginErrors];
+export type GetMarginResponses = {
     /**
      * Success.
      */
-    200: RevenueOutput;
+    200: MarginListOutput;
 };
-export type GetAllRevenueResponse = GetAllRevenueResponses[keyof GetAllRevenueResponses];
-export type SetRevenueData = {
-    body: SetRevenueInput;
+export type GetMarginResponse = GetMarginResponses[keyof GetMarginResponses];
+export type DeleteRevenueData = {
+    body?: never;
     path?: never;
-    query?: never;
+    query: {
+        /**
+         * Delete these customers' API-booked revenue (repeat the param for several).
+         */
+        customer_names: Array<string>;
+        /**
+         * First month to delete (inclusive). Omit both bounds to delete every matching API-booked value.
+         */
+        month_start?: string;
+        /**
+         * Last month to delete (inclusive).
+         */
+        month_end?: string;
+    };
     url: '/revenue/';
 };
-export type SetRevenueErrors = {
+export type DeleteRevenueErrors = {
     /**
      * Missing or invalid API key.
      */
@@ -427,32 +511,51 @@ export type SetRevenueErrors = {
      */
     422: InvalidPayloadOutput;
 };
-export type SetRevenueError = SetRevenueErrors[keyof SetRevenueErrors];
-export type SetRevenueResponses = {
+export type DeleteRevenueError = DeleteRevenueErrors[keyof DeleteRevenueErrors];
+export type DeleteRevenueResponses = {
     /**
      * Success.
      */
-    200: RevenueOrKeyMetricImportedRowOutput;
+    200: RevenueOrKeyMetricDeletedRowOutput;
 };
-export type SetRevenueResponse = SetRevenueResponses[keyof SetRevenueResponses];
-export type DeleteCustomerRevenueData = {
+export type DeleteRevenueResponse = DeleteRevenueResponses[keyof DeleteRevenueResponses];
+export type GetRevenueData = {
     body?: never;
-    path: {
-        customer_name: string;
-    };
+    path?: never;
     query?: {
         /**
-         * First month to delete (inclusive). Omit both bounds to delete every matching API-booked value.
+         * Return only these customers' revenue. Omit to return every customer's.
          */
-        month_start?: string;
+        customer_names?: Array<string>;
         /**
-         * Last month to delete (inclusive).
+         * Opaque cursor from a previous page's next_cursor.
          */
-        month_end?: string;
+        cursor?: string;
+        limit?: number;
     };
-    url: '/revenue/{customer_name}/';
+    url: '/revenue/';
+};
+export type GetRevenueErrors = {
+    /**
+     * Missing or invalid API key.
+     */
+    401: ApiErrorOutput;
+};
+export type GetRevenueError = GetRevenueErrors[keyof GetRevenueErrors];
+export type GetRevenueResponses = {
+    /**
+     * Success.
+     */
+    200: RevenueOutput;
+};
+export type GetRevenueResponse = GetRevenueResponses[keyof GetRevenueResponses];
+export type SetRevenueData = {
+    body: SetRevenueInput;
+    path?: never;
+    query?: never;
+    url: '/revenue/';
 };
-export type DeleteCustomerRevenueErrors = {
+export type SetRevenueErrors = {
     /**
      * Missing or invalid API key.
      */
@@ -462,44 +565,59 @@ export type DeleteCustomerRevenueErrors = {
      */
     422: InvalidPayloadOutput;
 };
-export type DeleteCustomerRevenueError = DeleteCustomerRevenueErrors[keyof DeleteCustomerRevenueErrors];
-export type DeleteCustomerRevenueResponses = {
+export type SetRevenueError = SetRevenueErrors[keyof SetRevenueErrors];
+export type SetRevenueResponses = {
     /**
      * Success.
      */
-    200: RevenueOrKeyMetricDeletedRowOutput;
+    200: RevenueOrKeyMetricImportedRowOutput;
 };
-export type DeleteCustomerRevenueResponse = DeleteCustomerRevenueResponses[keyof DeleteCustomerRevenueResponses];
-export type GetCustomerRevenueData = {
+export type SetRevenueResponse = SetRevenueResponses[keyof SetRevenueResponses];
+export type DeleteKeyMetricsData = {
     body?: never;
-    path: {
-        customer_name: string;
+    path?: never;
+    query: {
+        /**
+         * Delete these users' API-booked key metrics (repeat the param for several).
+         */
+        user_names: Array<string>;
+        /**
+         * First month to delete (inclusive). Omit both bounds to delete every matching API-booked value.
+         */
+        month_start?: string;
+        /**
+         * Last month to delete (inclusive).
+         */
+        month_end?: string;
     };
-    query?: never;
-    url: '/revenue/{customer_name}/';
+    url: '/key-metrics/';
 };
-export type GetCustomerRevenueErrors = {
+export type DeleteKeyMetricsErrors = {
     /**
      * Missing or invalid API key.
      */
     401: ApiErrorOutput;
     /**
-     * Nothing exists for this customer.
+     * Invalid payload: every offending field is listed and nothing was written.
      */
-    404: ApiErrorOutput;
+    422: InvalidPayloadOutput;
 };
-export type GetCustomerRevenueError = GetCustomerRevenueErrors[keyof GetCustomerRevenueErrors];
-export type GetCustomerRevenueResponses = {
+export type DeleteKeyMetricsError = DeleteKeyMetricsErrors[keyof DeleteKeyMetricsErrors];
+export type DeleteKeyMetricsResponses = {
     /**
      * Success.
      */
-    200: RevenueOutput;
+    200: RevenueOrKeyMetricDeletedRowOutput;
 };
-export type GetCustomerRevenueResponse = GetCustomerRevenueResponses[keyof GetCustomerRevenueResponses];
-export type GetAllKeyMetricsData = {
+export type DeleteKeyMetricsResponse = DeleteKeyMetricsResponses[keyof DeleteKeyMetricsResponses];
+export type GetKeyMetricsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Return only these users' key metrics. Omit to return every user's.
+         */
+        user_names?: Array<string>;
         /**
          * Opaque cursor from a previous page's next_cursor.
          */
@@ -508,20 +626,20 @@ export type GetAllKeyMetricsData = {
     };
     url: '/key-metrics/';
 };
-export type GetAllKeyMetricsErrors = {
+export type GetKeyMetricsErrors = {
     /**
      * Missing or invalid API key.
      */
     401: ApiErrorOutput;
 };
-export type GetAllKeyMetricsError = GetAllKeyMetricsErrors[keyof GetAllKeyMetricsErrors];
-export type GetAllKeyMetricsResponses = {
+export type GetKeyMetricsError = GetKeyMetricsErrors[keyof GetKeyMetricsErrors];
+export type GetKeyMetricsResponses = {
     /**
      * Success.
      */
     200: KeyMetricOutput;
 };
-export type GetAllKeyMetricsResponse = GetAllKeyMetricsResponses[keyof GetAllKeyMetricsResponses];
+export type GetKeyMetricsResponse = GetKeyMetricsResponses[keyof GetKeyMetricsResponses];
 export type SetKeyMetricsData = {
     body: SetKeyMetricsInput;
     path?: never;
@@ -546,24 +664,18 @@ export type SetKeyMetricsResponses = {
     200: RevenueOrKeyMetricImportedRowOutput;
 };
 export type SetKeyMetricsResponse = SetKeyMetricsResponses[keyof SetKeyMetricsResponses];
-export type DeleteUserKeyMetricsData = {
+export type DeleteCustomersTagsData = {
     body?: never;
-    path: {
-        user_name: string;
-    };
-    query?: {
-        /**
-         * First month to delete (inclusive). Omit both bounds to delete every matching API-booked value.
-         */
-        month_start?: string;
+    path?: never;
+    query: {
         /**
-         * Last month to delete (inclusive).
+         * Delete every tag of these customers.
          */
-        month_end?: string;
+        customer_names: Array<string>;
     };
-    url: '/key-metrics/{user_name}/';
+    url: '/customer-tags/';
 };
-export type DeleteUserKeyMetricsErrors = {
+export type DeleteCustomersTagsErrors = {
     /**
      * Missing or invalid API key.
      */
@@ -573,44 +685,22 @@ export type DeleteUserKeyMetricsErrors = {
      */
     422: InvalidPayloadOutput;
 };
-export type DeleteUserKeyMetricsError = DeleteUserKeyMetricsErrors[keyof DeleteUserKeyMetricsErrors];
-export type DeleteUserKeyMetricsResponses = {
+export type DeleteCustomersTagsError = DeleteCustomersTagsErrors[keyof DeleteCustomersTagsErrors];
+export type DeleteCustomersTagsResponses = {
     /**
      * Success.
      */
-    200: RevenueOrKeyMetricDeletedRowOutput;
-};
-export type DeleteUserKeyMetricsResponse = DeleteUserKeyMetricsResponses[keyof DeleteUserKeyMetricsResponses];
-export type GetUserKeyMetricsData = {
-    body?: never;
-    path: {
-        user_name: string;
-    };
-    query?: never;
-    url: '/key-metrics/{user_name}/';
-};
-export type GetUserKeyMetricsErrors = {
-    /**
-     * Missing or invalid API key.
-     */
-    401: ApiErrorOutput;
-    /**
-     * Nothing exists for this customer.
-     */
-    404: ApiErrorOutput;
-};
-export type GetUserKeyMetricsError = GetUserKeyMetricsErrors[keyof GetUserKeyMetricsErrors];
-export type GetUserKeyMetricsResponses = {
-    /**
-     * Success.
-     */
-    200: KeyMetricOutput;
+    200: TagsDeletedOutput;
 };
-export type GetUserKeyMetricsResponse = GetUserKeyMetricsResponses[keyof GetUserKeyMetricsResponses];
-export type GetAllCustomersTagsData = {
+export type DeleteCustomersTagsResponse = DeleteCustomersTagsResponses[keyof DeleteCustomersTagsResponses];
+export type GetCustomersTagsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Return only these customers' tags. Omit to return every customer's.
+         */
+        customer_names?: Array<string>;
         /**
          * Opaque cursor from a previous page's next_cursor.
          */
@@ -619,20 +709,20 @@ export type GetAllCustomersTagsData = {
     };
     url: '/customer-tags/';
 };
-export type GetAllCustomersTagsErrors = {
+export type GetCustomersTagsErrors = {
     /**
      * Missing or invalid API key.
      */
     401: ApiErrorOutput;
 };
-export type GetAllCustomersTagsError = GetAllCustomersTagsErrors[keyof GetAllCustomersTagsErrors];
-export type GetAllCustomersTagsResponses = {
+export type GetCustomersTagsError = GetCustomersTagsErrors[keyof GetCustomersTagsErrors];
+export type GetCustomersTagsResponses = {
     /**
      * Success.
      */
     200: AllCustomerTagsOutput;
 };
-export type GetAllCustomersTagsResponse = GetAllCustomersTagsResponses[keyof GetAllCustomersTagsResponses];
+export type GetCustomersTagsResponse = GetCustomersTagsResponses[keyof GetCustomersTagsResponses];
 export type SetCustomersTagsData = {
     body: SetCustomerTagsInput;
     path?: never;
@@ -657,55 +747,3 @@ export type SetCustomersTagsResponses = {
     200: CustomersUpdatedOutput;
 };
 export type SetCustomersTagsResponse = SetCustomersTagsResponses[keyof SetCustomersTagsResponses];
-export type DeleteCustomerTagsData = {
-    body?: never;
-    path: {
-        customer_name: string;
-    };
-    query?: never;
-    url: '/customer-tags/{customer_name}/';
-};
-export type DeleteCustomerTagsErrors = {
-    /**
-     * Missing or invalid API key.
-     */
-    401: ApiErrorOutput;
-    /**
-     * Nothing exists for this customer.
-     */
-    404: ApiErrorOutput;
-};
-export type DeleteCustomerTagsError = DeleteCustomerTagsErrors[keyof DeleteCustomerTagsErrors];
-export type DeleteCustomerTagsResponses = {
-    /**
-     * Success.
-     */
-    200: TagsDeletedOutput;
-};
-export type DeleteCustomerTagsResponse = DeleteCustomerTagsResponses[keyof DeleteCustomerTagsResponses];
-export type GetCustomerTagsData = {
-    body?: never;
-    path: {
-        customer_name: string;
-    };
-    query?: never;
-    url: '/customer-tags/{customer_name}/';
-};
-export type GetCustomerTagsErrors = {
-    /**
-     * Missing or invalid API key.
-     */
-    401: ApiErrorOutput;
-    /**
-     * Nothing exists for this customer.
-     */
-    404: ApiErrorOutput;
-};
-export type GetCustomerTagsError = GetCustomerTagsErrors[keyof GetCustomerTagsErrors];
-export type GetCustomerTagsResponses = {
-    /**
-     * Success.
-     */
-    200: CustomerTagsOutput;
-};
-export type GetCustomerTagsResponse = GetCustomerTagsResponses[keyof GetCustomerTagsResponses];

package/dist/api/index.d.ts

@@ -12,7 +12,7 @@
  *     const weflayr = require('weflayr');
  *
  *     const apiClient = weflayr.client({ apiKey: 'wf-...' });
- *     const { data } = await weflayr.api.getAllRevenue({ client: apiClient, throwOnError: true });
+ *     const { data } = await weflayr.api.getRevenue({ client: apiClient, throwOnError: true });
  */
 import { type Client } from './generated/client';
 export declare const DEFAULT_BASE_URL = "https://app.weflayr.com/api";

package/dist/api/index.js

@@ -13,7 +13,7 @@
  *     const weflayr = require('weflayr');
  *
  *     const apiClient = weflayr.client({ apiKey: 'wf-...' });
- *     const { data } = await weflayr.api.getAllRevenue({ client: apiClient, throwOnError: true });
+ *     const { data } = await weflayr.api.getRevenue({ client: apiClient, throwOnError: true });
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weflayr",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "Weflayr Node.js SDK — instrument any LLM client via JS Proxy",
   "main": "src/index.js",
   "types": "index.d.ts",

package/scripts/generate_facade.mjs

@@ -10,8 +10,8 @@
 // overwritten on every run.
 //
 // @hey-api/openapi-ts names an operation's request/response types after its
-// PascalCase operation name (e.g. operation `getAllRevenue` gets types
-// `GetAllRevenueData`, `GetAllRevenueResponse`, `GetAllRevenueError`), so the
+// PascalCase operation name (e.g. operation `getRevenue` gets types
+// `GetRevenueData`, `GetRevenueResponse`, `GetRevenueError`), so the
 // only thing this script needs from the generated source is the list of
 // operation names - the type names, and the per-endpoint camelCase/snake_case
 // conversion, follow mechanically from there.