casedev 0.41.0 → 0.42.0

package/src/resources/usage/v1/subscriptions.ts

@@ -0,0 +1,108 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Usage reporting and webhook subscriptions
+ */
+export class Subscriptions extends APIResource {
+  /**
+   * Creates a webhook subscription for usage, balance, and billing events.
+   */
+  create(body: SubscriptionCreateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/usage/v1/subscriptions', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Updates callback URL, event filters, active state, or signing secret.
+   */
+  update(
+    subscriptionID: string,
+    body: SubscriptionUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.patch(path`/usage/v1/subscriptions/${subscriptionID}`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Lists webhook subscriptions configured for usage and billing events.
+   */
+  list(options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/usage/v1/subscriptions', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Deactivates a usage webhook subscription.
+   */
+  delete(subscriptionID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/usage/v1/subscriptions/${subscriptionID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Delivers a test event to a single usage webhook subscription using the same
+   * payload shape and signing behavior as production delivery.
+   */
+  test(
+    subscriptionID: string,
+    body: SubscriptionTestParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.post(path`/usage/v1/subscriptions/${subscriptionID}/test`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface SubscriptionCreateParams {
+  callbackUrl: string;
+
+  eventTypes?: Array<string>;
+
+  signingSecret?: string;
+}
+
+export interface SubscriptionUpdateParams {
+  callbackUrl?: string;
+
+  clearSigningSecret?: boolean;
+
+  eventTypes?: Array<string>;
+
+  isActive?: boolean;
+
+  signingSecret?: string;
+}
+
+export interface SubscriptionTestParams {
+  eventType?: string;
+
+  payload?: { [key: string]: unknown };
+}
+
+export declare namespace Subscriptions {
+  export {
+    type SubscriptionCreateParams as SubscriptionCreateParams,
+    type SubscriptionUpdateParams as SubscriptionUpdateParams,
+    type SubscriptionTestParams as SubscriptionTestParams,
+  };
+}

package/src/resources/usage/v1/v1.ts

@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as SubscriptionsAPI from './subscriptions';
+import {
+  SubscriptionCreateParams,
+  SubscriptionTestParams,
+  SubscriptionUpdateParams,
+  Subscriptions,
+} from './subscriptions';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * Usage reporting and webhook subscriptions
+ */
+export class V1 extends APIResource {
+  subscriptions: SubscriptionsAPI.Subscriptions = new SubscriptionsAPI.Subscriptions(this._client);
+
+  /**
+   * Returns customer-facing usage metrics and costs for the requested period.
+   * Supports summary totals and daily buckets for timestamped usage sources. Vault
+   * storage is intentionally omitted from totals because it is not yet periodized
+   * for arbitrary windows.
+   */
+  retrieve(query: V1RetrieveParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    return this._client.get('/usage/v1', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface V1RetrieveParams {
+  /**
+   * Whether to return period totals only or include daily buckets.
+   */
+  granularity?: 'summary' | 'daily';
+
+  /**
+   * Period end date. Defaults to now.
+   */
+  periodEnd?: string;
+
+  /**
+   * Period start date. Defaults to the start of the current calendar month.
+   */
+  periodStart?: string;
+}
+
+V1.Subscriptions = Subscriptions;
+
+export declare namespace V1 {
+  export { type V1RetrieveParams as V1RetrieveParams };
+
+  export {
+    Subscriptions as Subscriptions,
+    type SubscriptionCreateParams as SubscriptionCreateParams,
+    type SubscriptionUpdateParams as SubscriptionUpdateParams,
+    type SubscriptionTestParams as SubscriptionTestParams,
+  };
+}

package/src/resources/usage/v1.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './v1/index';

package/src/resources/usage.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './usage/index';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.41.0'; // x-release-please-version
+export const VERSION = '0.42.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.41.0";
+export declare const VERSION = "0.42.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.41.0";
+export declare const VERSION = "0.42.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.41.0'; // x-release-please-version
+exports.VERSION = '0.42.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.41.0'; // x-release-please-version
+export const VERSION = '0.42.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map