@maxim_mazurok/gapi.client.cloudbilling-v1beta 0.2.20260313 → 0.2.20260605

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://cloudbilling.googleapis.com/$discovery/rest?version=v1beta
-// Revision: 20260313
+// Revision: 20260605
 
 /// <reference types="gapi.client" />
 
@@ -28,10 +28,96 @@ declare namespace gapi.client {
   ): void;
 
   namespace cloudbilling {
+    interface AgenticQueryInfo {
+      /** The columns queried. */
+      columns?: string;
+      /** The filter applied to the query. */
+      filter?: string;
+      /** The group-by clause applied to the query. */
+      groupBy?: string;
+      /** The row limit applied to the query. */
+      limit?: number;
+      /** The order-by clause applied to the query. */
+      orderBy?: string;
+      /** The parents (e.g. projects, billing accounts) queried. */
+      parents?: string[];
+      /** The view queried. */
+      view?: string;
+    }
+    interface Array {
+      /** The elements of the array. */
+      element?: ValueProto[];
+    }
+    interface BillingData {
+      /** Information about columns. */
+      columnInfo?: ColumnInfo[];
+      /** Rows. */
+      rows?: Row[];
+    }
+    interface BillingDataResource {
+      /** Optional. If not provided the billing account currently associated with the resource will be used. */
+      billingAccount?: string;
+      /** Required. Resource name for an entitity that can be used for authorization to access billing data such as `projects/{project}` or `billingAccounts/{billing_account}` */
+      resource?: string;
+    }
+    interface ColumnInfo {
+      /** Name of the column. */
+      column?: string;
+    }
+    interface DataSet {
+      /** Output only. Actual billing data returned from the Data Mart. Uses the formal message from the Billing Data Service. */
+      billingData?: BillingData;
+      /** Output only. The query used to fetch this data. */
+      queryInfo?: AgenticQueryInfo;
+      /** Output only. A suggested chart for the data set, used for UI rendering. */
+      suggestedChart?: SuggestedChart;
+    }
+    interface Datetime {
+      /** Represents bit field encoding of year/month/day/hour/minute/second. See class DatetimeValue in civil_time.h for details of encoding. */
+      bitFieldDatetimeSeconds?: string;
+      /** Non-negative fractions of a second at nanosecond resolution. */
+      nanos?: number;
+    }
     interface Decimal {
       /** The decimal value, as a string. The string representation consists of an optional sign, `+` (`U+002B`) or `-` (`U+002D`), followed by a sequence of zero or more decimal digits ("the integer"), optionally followed by a fraction, optionally followed by an exponent. An empty string **should** be interpreted as `0`. The fraction consists of a decimal point followed by zero or more decimal digits. The string must contain at least one digit in either the integer or the fraction. The number formed by the sign, the integer and the fraction is referred to as the significand. The exponent consists of the character `e` (`U+0065`) or `E` (`U+0045`) followed by one or more decimal digits. Services **should** normalize decimal values before storing them by: - Removing an explicitly-provided `+` sign (`+2.5` -> `2.5`). - Replacing a zero-length integer value with `0` (`.5` -> `0.5`). - Coercing the exponent character to upper-case, with explicit sign (`2.5e8` -> `2.5E+8`). - Removing an explicitly-provided zero exponent (`2.5E0` -> `2.5`). Services **may** perform additional normalization based on its own needs and the internal decimal implementation selected, such as shifting the decimal point and exponent value together (example: `2.5E-1` <-> `0.25`). Additionally, services **may** preserve trailing zeroes in the fraction to indicate increased precision, but are not required to do so. Note that only the `.` character is supported to divide the integer and the fraction; `,` **should not** be supported regardless of locale. Additionally, thousand separators **should not** be supported. If a service does support them, values **must** be normalized. The ENBF grammar is: DecimalString = '' | [Sign] Significand [Exponent]; Sign = '+' | '-'; Significand = Digits '.' | [Digits] '.' Digits; Exponent = ('e' | 'E') [Sign] Digits; Digits = { '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' }; Services **should** clearly document the range of supported values, the maximum supported precision (total number of digits), and, if applicable, the scale (number of digits after the decimal point), as well as how it behaves when receiving out-of-bounds values. Services **may** choose to accept values passed as input even when the value has a higher precision or scale than the service supports, and **should** round the value to fit the supported scale. Alternatively, the service **may** error with `400 Bad Request` (`INVALID_ARGUMENT` in gRPC) if precision would be lost. Services **should** error with `400 Bad Request` (`INVALID_ARGUMENT` in gRPC) if the service receives a value outside of the supported range. */
       value?: string;
     }
+    interface FinalResult {
+      /** Output only. Data sets used to support the insights, suitable for UI rendering (tables/charts). */
+      dataSets?: DataSet[];
+      /** Output only. Contains the full natural language analysis, including thoughts, reasoning, and references. */
+      fullAnalysis?: string;
+      /** Output only. A list of discrete insights gleaned from the data. */
+      insights?: Insight[];
+      /** Output only. Links to interoperable tools (e.g., pre-filtered Cost Reports or BQE queries). */
+      interopLinks?: InteropLink[];
+      /** Output only. A list of suggested follow-up queries for the user. */
+      suggestedQueries?: SuggestedQuery[];
+      /** Output only. The full natural language summary (re-sent for consistency). */
+      summary?: string;
+    }
+    interface GenerateInsightsRequest {
+      /** Optional. Filters cost data by service id. Follows https://google.aip.dev/160 for the filter syntax. eg. filter: "service = 'C7E2-9256-1C43'" */
+      filter?: string;
+      /** Optional. Overrides the maximum iterations for any selected strategy. */
+      overriddenMaxIterationCounts?: number;
+      /** Optional. The billing account or projects to analyze. */
+      parents?: BillingDataResource[];
+      /** Required. The natural language prompt from the user. */
+      prompt?: string;
+      /** Optional. Additional context for personalization (e.g., user persona, role). */
+      userContext?: UserContext;
+    }
+    interface GenerateInsightsResponse {
+      /** Output only. The final structured results and metadata. Usually sent as the final message in the stream. */
+      finalResult?: FinalResult;
+      /** Output only. The request was rejected (e.g. out of scope). */
+      rejection?: Rejection;
+      /** Output only. A chunk of the natural language summary (customer-facing). The UI can append these chunks to provide a real-time "typing" effect. */
+      summaryChunk?: string;
+      /** Output only. A chunk of the agent's internal reasoning process. The UI can use this to render a "Thinking..." log or status. */
+      thoughtChunk?: string;
+    }
     interface GoogleCloudBillingBillingaccountpricesV1betaAggregationInfo {
       /** Interval at which usage is aggregated to compute cost. Example: "MONTHLY" interval indicates that usage is aggregated every month. */
       interval?: 'INTERVAL_UNSPECIFIED' | 'INTERVAL_MONTHLY' | 'INTERVAL_DAILY';
@@ -373,6 +459,36 @@ declare namespace gapi.client {
       /** Resource name for the SKU group. Example: "skuGroups/0e6403d1-4694-44d2-a696-7a78b1a69301". */
       name?: string;
     }
+    interface Insight {
+      /** Output only. The description of the insight. */
+      description?: string;
+      /** Output only. The severity of the insight, used for UI rendering (e.g., color-coding). */
+      severity?: 'SEVERITY_UNSPECIFIED' | 'INFO' | 'WARNING' | 'CRITICAL';
+      /** Output only. The title of the insight. */
+      title?: string;
+    }
+    interface InteropLink {
+      /** Output only. The label of the link, suitable for UI rendering. */
+      label?: string;
+      /** Output only. The type of the interop link, e.g., "COST_REPORT", "BQE_QUERY", etc. */
+      linkType?:
+        | 'LINK_TYPE_UNSPECIFIED'
+        | 'COST_REPORT'
+        | 'BQE_QUERY'
+        | 'FINOPS_HUB';
+      /** Output only. The URL of the link. */
+      url?: string;
+    }
+    interface Map {
+      /** Represents the map entries in the map. */
+      entry?: MapEntry[];
+    }
+    interface MapEntry {
+      /** Represents the serialized map key for the entry. */
+      key?: ValueProto;
+      /** Represents the serialized map value of the entry. */
+      value?: ValueProto;
+    }
     interface Money {
       /** The three-letter currency code defined in ISO 4217. */
       currencyCode?: string;
@@ -381,6 +497,115 @@ declare namespace gapi.client {
       /** The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. */
       units?: string;
     }
+    interface Range {
+      /** Represents the end of the range. */
+      end?: ValueProto;
+      /** Represents the start of the range. */
+      start?: ValueProto;
+    }
+    interface Rejection {
+      /** Output only. A user-facing message explaining the rejection. */
+      displayMessage?: string;
+      /** Output only. The reason for the rejection. */
+      reason?: 'REASON_UNSPECIFIED' | 'EXPLICIT_OUT_OF_SCOPE';
+    }
+    interface Row {
+      /** Values for a row in the column order. */
+      values?: ValueProto[];
+    }
+    interface Struct {
+      /** The fields in the struct */
+      field?: ValueProto[];
+    }
+    interface SuggestedChart {
+      /** The title of the chart. */
+      chartTitle?: string;
+      /** The type of the chart. */
+      chartType?:
+        | 'CHART_TYPE_UNSPECIFIED'
+        | 'BAR_CHART'
+        | 'UNCHARTABLE'
+        | 'LINE_CHART'
+        | 'AREA_CHART';
+      /** The field used for the series (e.g., color-coding). Optional, but recommended for time-series data. */
+      seriesField?: string;
+      /** The field used for the x-axis. */
+      xAxisField?: string;
+      /** The label of the x-axis. */
+      xAxisLabel?: string;
+      /** The field used for the y-axis. */
+      yAxisField?: string;
+      /** The label of the y-axis. */
+      yAxisLabel?: string;
+    }
+    interface SuggestedQuery {
+      /** The natural language query. */
+      query?: string;
+    }
+    interface UserContext {
+      /** Optional. The user's persona (e.g., FinOps Manager, Developer). */
+      persona?: 'PERSONA_UNSPECIFIED' | 'FINOPS_MANAGER' | 'DEVELOPER';
+      /** Optional. The user's role (e.g., Billing Admin, Project Owner, etc.). */
+      role?: string;
+    }
+    interface ValueProto {
+      /** An array of value */
+      arrayValue?: Array;
+      /** Encoded bignumeric value. For the encoding format see documentation for BigNumericValue::SerializeAsProtoBytes(). */
+      bignumericValue?: string;
+      /** Primitive for bool. */
+      boolValue?: boolean;
+      /** Primitive for bytes. */
+      bytesValue?: string;
+      /** primitive for datetime */
+      datetimeValue?: Datetime;
+      /** Primitive for date. */
+      dateValue?: number;
+      /** Primitive for double. */
+      doubleValue?: number;
+      /** Tag 11 was used for specifying micros timestamps as int64, now obsolete. */
+      enumValue?: number;
+      /** Primitive for float. */
+      floatValue?: number;
+      /** Geography encoded using ::stlib::STGeographyEncoder */
+      geographyValue?: string;
+      /** Primitive value for int32. */
+      int32Value?: number;
+      /** Primitive for int64. */
+      int64Value?: string;
+      /** Encoded interval value. For the encoding format see documentation for IntervalValue::SerializeAsBytes(). */
+      intervalValue?: string;
+      /** Tag 22 was used for json value as bytes, now obsolete. Json value represented as a string document. */
+      jsonValue?: string;
+      /** Encoded map value. See go/googlesql_map. */
+      mapValue?: Map;
+      /** Encoded numeric value. For the encoding format see documentation for NumericValue::SerializeAsProtoBytes(). */
+      numericValue?: string;
+      /** Stores a serialized protocol message. */
+      protoValue?: string;
+      /** Encoded range value. See go/googlesql_range. */
+      rangeValue?: Range;
+      /** Primitive for string. */
+      stringValue?: string;
+      /** A struct of values */
+      structValue?: Struct;
+      /** Encoded timestamp_pico value. For the encoding format see documentation for googlesql::TimestampPico::SerializeAsBytes(). */
+      timestampPicoValue?: string;
+      /** primitive for timestamp */
+      timestampValue?: string;
+      /** Bit field encoding of hour/minute/second/nanos. See TimeValue class for details. */
+      timeValue?: string;
+      /** Encoded tokenlist value. copybara:strip_begin(internal-comment) See //search/tokens:token_list. copybara:strip_end */
+      tokenlistValue?: string;
+      /** Primitive for uint32. */
+      uint32Value?: number;
+      /** Primitive for uint64. */
+      uint64Value?: string;
+      /** Encoded uuid value. For the encoding format see documentation for UuidValue::SerializeAsBytes(). */
+      uuidValue?: string;
+      /** User code that switches on this oneoff enum must have a default case so builds won't break when new fields are added. */
+      ValueProtoSwitchMustHaveADefault?: boolean;
+    }
     interface ServicesResource {
       /** Gets a Google Cloud service visible to a billing account. */
       get(request?: {
@@ -886,11 +1111,69 @@ declare namespace gapi.client {
       price: PriceResource;
       prices: PricesResource;
     }
+    interface V1betaResource {
+      /** Analyzes cost data for a billing account and/or specific projects. Returns a natural language summary and supporting datasets. */
+      generateInsights(request: {
+        /** V1 error format. */
+        '$.xgafv'?: '1' | '2';
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: 'json' | 'media' | 'proto';
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: GenerateInsightsRequest;
+      }): Request<GenerateInsightsResponse>;
+      generateInsights(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: '1' | '2';
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: 'json' | 'media' | 'proto';
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: GenerateInsightsRequest,
+      ): Request<GenerateInsightsResponse>;
+    }
 
     const billingAccounts: BillingAccountsResource;
 
     const skuGroups: SkuGroupsResource;
 
     const skus: SkusResource;
+
+    const v1beta: V1betaResource;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.cloudbilling-v1beta",
-  "version": "0.2.20260313",
+  "version": "0.2.20260605",
   "description": "TypeScript typings for Cloud Billing API v1beta",
   "repository": {
     "type": "git",

package/readme.md

@@ -11,6 +11,23 @@ Install typings for Cloud Billing API:
 npm install @types/gapi.client.cloudbilling-v1beta --save-dev
 ```
 
+## TypeScript 6.0+
+
+TypeScript 6.0 changed `types` to default to `[]`. You must now explicitly list type packages in `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "types": [
+      "gapi",
+      "gapi.auth2",
+      "gapi.client",
+      "gapi.client.cloudbilling-v1beta"
+    ]
+  }
+}
+```
+
 ## Usage
 
 You need to initialize Google API client in your code:
@@ -84,6 +101,11 @@ await gapi.client.cloudbilling.skuGroups.get({name: 'name'});
 Lists all publicly listed SKU groups.
 */
 await gapi.client.cloudbilling.skuGroups.list({});
+
+/*
+Analyzes cost data for a billing account and/or specific projects. Returns a natural language summary and supporting datasets.
+*/
+await gapi.client.cloudbilling.generateInsights({});
 ```
 
 For provenance information see [Provenance section on NPM](https://www.npmjs.com/package/@maxim_mazurok/gapi.client.cloudbilling-v1beta#Provenance:~:text=none-,Provenance,-Built%20and%20signed)