@stigg/typescript 0.1.0-beta.10 → 0.1.0-beta.13

package/src/resources/v1/customers/promotional-entitlements.ts

@@ -13,6 +13,38 @@ export class PromotionalEntitlements extends APIResource {
   /**
    * Grants promotional entitlements to a customer, providing feature access outside
    * their subscription. Entitlements can be time-limited or permanent.
+   *
+   * @example
+   * ```ts
+   * const promotionalEntitlement =
+   *   await client.v1.customers.promotionalEntitlements.create(
+   *     'x',
+   *     {
+   *       promotionalEntitlements: [
+   *         {
+   *           customEndDate: '2019-12-27T18:11:19.117Z',
+   *           enumValues: ['string'],
+   *           featureId: 'featureId',
+   *           hasSoftLimit: true,
+   *           hasUnlimitedUsage: true,
+   *           isVisible: true,
+   *           monthlyResetPeriodConfiguration: {
+   *             accordingTo: 'SubscriptionStart',
+   *           },
+   *           period: '1 week',
+   *           resetPeriod: 'YEAR',
+   *           usageLimit: -9007199254740991,
+   *           weeklyResetPeriodConfiguration: {
+   *             accordingTo: 'SubscriptionStart',
+   *           },
+   *           yearlyResetPeriodConfiguration: {
+   *             accordingTo: 'SubscriptionStart',
+   *           },
+   *         },
+   *       ],
+   *     },
+   *   );
+   * ```
    */
   create(
     id: string,
@@ -24,6 +56,16 @@ export class PromotionalEntitlements extends APIResource {
 
   /**
    * Retrieves a paginated list of a customer's promotional entitlements.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const promotionalEntitlementListResponse of client.v1.customers.promotionalEntitlements.list(
+   *   'x',
+   * )) {
+   *   // ...
+   * }
+   * ```
    */
   list(
     id: string,
@@ -40,6 +82,15 @@ export class PromotionalEntitlements extends APIResource {
   /**
    * Revokes a previously granted promotional entitlement from a customer for a
    * specific feature.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v1.customers.promotionalEntitlements.revoke(
+   *     'featureId',
+   *     { id: 'id' },
+   *   );
+   * ```
    */
   revoke(
     featureID: string,

package/src/resources/{v1-beta/v1-beta.ts → v1/events/beta/beta.ts}

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../core/resource';
+import { APIResource } from '../../../../core/resource';
 import * as EntityTypesAPI from './entity-types';
 import {
   EntityTypeListParams,
@@ -13,15 +13,15 @@ import {
 import * as CustomersAPI from './customers/customers';
 import { Customers } from './customers/customers';
 
-export class V1Beta extends APIResource {
+export class Beta extends APIResource {
   customers: CustomersAPI.Customers = new CustomersAPI.Customers(this._client);
   entityTypes: EntityTypesAPI.EntityTypes = new EntityTypesAPI.EntityTypes(this._client);
 }
 
-V1Beta.Customers = Customers;
-V1Beta.EntityTypes = EntityTypes;
+Beta.Customers = Customers;
+Beta.EntityTypes = EntityTypes;
 
-export declare namespace V1Beta {
+export declare namespace Beta {
   export { Customers as Customers };
 
   export {

package/src/resources/{v1-beta → v1/events/beta}/customers/assignments.ts

@@ -1,10 +1,10 @@
 // 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 { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
+import { APIResource } from '../../../../../core/resource';
+import { APIPromise } from '../../../../../core/api-promise';
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../../../core/pagination';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
 
 export class Assignments extends APIResource {
   /**
@@ -15,7 +15,7 @@ export class Assignments extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const assignmentListResponse of client.v1Beta.customers.assignments.list(
+   * for await (const assignmentListResponse of client.v1.events.beta.customers.assignments.list(
    *   'id',
    * )) {
    *   // ...
@@ -43,22 +43,25 @@ export class Assignments extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.v1Beta.customers.assignments.upsert('id', {
-   *     assignments: [
-   *       {
-   *         entityId: 'workspace-001',
-   *         capabilityId: 'compute-minutes',
-   *         usageLimit: 1000,
-   *         cadence: 'MONTH',
-   *       },
-   *       {
-   *         entityId: 'workspace-002',
-   *         capabilityId: 'compute-minutes',
-   *         usageLimit: 2000,
-   *         cadence: 'MONTH',
-   *       },
-   *     ],
-   *   });
+   *   await client.v1.events.beta.customers.assignments.upsert(
+   *     'id',
+   *     {
+   *       assignments: [
+   *         {
+   *           entityId: 'workspace-001',
+   *           capabilityId: 'compute-minutes',
+   *           usageLimit: 1000,
+   *           cadence: 'MONTH',
+   *         },
+   *         {
+   *           entityId: 'workspace-002',
+   *           capabilityId: 'compute-minutes',
+   *           usageLimit: 2000,
+   *           cadence: 'MONTH',
+   *         },
+   *       ],
+   *     },
+   *   );
    * ```
    */
   upsert(

package/src/resources/{v1-beta → v1/events/beta}/customers/customers.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../core/resource';
+import { APIResource } from '../../../../../core/resource';
 import * as AssignmentsAPI from './assignments';
 import {
   AssignmentListParams,
@@ -14,14 +14,14 @@ import * as EntitiesAPI from './entities';
 import {
   Entities,
   EntityArchiveParams,
-  EntityIDsActionResponseDto,
-  EntityIDsRequestDto,
+  EntityArchiveResponse,
   EntityListParams,
   EntityListResponse,
   EntityListResponsesMyCursorIDPage,
   EntityRetrieveParams,
   EntityRetrieveResponse,
   EntityUnarchiveParams,
+  EntityUnarchiveResponse,
   EntityUpsertParams,
   EntityUpsertResponse,
 } from './entities';
@@ -47,10 +47,10 @@ export declare namespace Customers {
 
   export {
     Entities as Entities,
-    type EntityIDsActionResponseDto as EntityIDsActionResponseDto,
-    type EntityIDsRequestDto as EntityIDsRequestDto,
     type EntityRetrieveResponse as EntityRetrieveResponse,
     type EntityListResponse as EntityListResponse,
+    type EntityArchiveResponse as EntityArchiveResponse,
+    type EntityUnarchiveResponse as EntityUnarchiveResponse,
     type EntityUpsertResponse as EntityUpsertResponse,
     type EntityListResponsesMyCursorIDPage as EntityListResponsesMyCursorIDPage,
     type EntityRetrieveParams as EntityRetrieveParams,

package/src/resources/{v1-beta → v1/events/beta}/customers/entities.ts

@@ -1,10 +1,10 @@
 // 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 { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
+import { APIResource } from '../../../../../core/resource';
+import { APIPromise } from '../../../../../core/api-promise';
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../../../core/pagination';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
 
 export class Entities extends APIResource {
   /**
@@ -13,9 +13,10 @@ export class Entities extends APIResource {
    * @example
    * ```ts
    * const entity =
-   *   await client.v1Beta.customers.entities.retrieve('x', {
-   *     id: 'id',
-   *   });
+   *   await client.v1.events.beta.customers.entities.retrieve(
+   *     'x',
+   *     { id: 'id' },
+   *   );
    * ```
    */
   retrieve(
@@ -33,7 +34,7 @@ export class Entities extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const entityListResponse of client.v1Beta.customers.entities.list(
+   * for await (const entityListResponse of client.v1.events.beta.customers.entities.list(
    *   'id',
    * )) {
    *   // ...
@@ -57,17 +58,18 @@ export class Entities extends APIResource {
    *
    * @example
    * ```ts
-   * const entityIDsActionResponseDto =
-   *   await client.v1Beta.customers.entities.archive('id', {
-   *     ids: ['user-7f3a0c1d', 'user-c4d1b2e9'],
-   *   });
+   * const response =
+   *   await client.v1.events.beta.customers.entities.archive(
+   *     'id',
+   *     { ids: ['user-7f3a0c1d', 'user-c4d1b2e9'] },
+   *   );
    * ```
    */
   archive(
     id: string,
     body: EntityArchiveParams,
     options?: RequestOptions,
-  ): APIPromise<EntityIDsActionResponseDto> {
+  ): APIPromise<EntityArchiveResponse> {
     return this._client.post(path`/api/v1-beta/customers/${id}/entities/archive`, { body, ...options });
   }
 
@@ -76,17 +78,18 @@ export class Entities extends APIResource {
    *
    * @example
    * ```ts
-   * const entityIDsActionResponseDto =
-   *   await client.v1Beta.customers.entities.unarchive('id', {
-   *     ids: ['user-7f3a0c1d', 'user-c4d1b2e9'],
-   *   });
+   * const response =
+   *   await client.v1.events.beta.customers.entities.unarchive(
+   *     'id',
+   *     { ids: ['user-7f3a0c1d', 'user-c4d1b2e9'] },
+   *   );
    * ```
    */
   unarchive(
     id: string,
     body: EntityUnarchiveParams,
     options?: RequestOptions,
-  ): APIPromise<EntityIDsActionResponseDto> {
+  ): APIPromise<EntityUnarchiveResponse> {
     return this._client.post(path`/api/v1-beta/customers/${id}/entities/unarchive`, { body, ...options });
   }
 
@@ -97,20 +100,26 @@ export class Entities extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.v1Beta.customers.entities.upsert('id', {
-   *     entities: [
-   *       {
-   *         id: 'user-7f3a0c1d',
-   *         typeRefId: 'user',
-   *         metadata: { email: 'jane@acme.com', role: 'admin' },
-   *       },
-   *       {
-   *         id: 'user-c4d1b2e9',
-   *         typeRefId: 'user',
-   *         metadata: { email: 'john@acme.com' },
-   *       },
-   *     ],
-   *   });
+   *   await client.v1.events.beta.customers.entities.upsert(
+   *     'id',
+   *     {
+   *       entities: [
+   *         {
+   *           id: 'user-7f3a0c1d',
+   *           typeRefId: 'user',
+   *           metadata: {
+   *             email: 'jane@acme.com',
+   *             role: 'admin',
+   *           },
+   *         },
+   *         {
+   *           id: 'user-c4d1b2e9',
+   *           typeRefId: 'user',
+   *           metadata: { email: 'john@acme.com' },
+   *         },
+   *       ],
+   *     },
+   *   );
    * ```
    */
   upsert(id: string, body: EntityUpsertParams, options?: RequestOptions): APIPromise<EntityUpsertResponse> {
@@ -120,38 +129,6 @@ export class Entities extends APIResource {
 
 export type EntityListResponsesMyCursorIDPage = MyCursorIDPage<EntityListResponse>;
 
-/**
- * Wrapped response echoing the ids that were acted on by an archive/unarchive call
- */
-export interface EntityIDsActionResponseDto {
-  /**
-   * List of entity identifiers that were acted on
-   */
-  data: EntityIDsActionResponseDto.Data;
-}
-
-export namespace EntityIDsActionResponseDto {
-  /**
-   * List of entity identifiers that were acted on
-   */
-  export interface Data {
-    /**
-     * Entity identifiers to act on
-     */
-    ids: Array<string>;
-  }
-}
-
-/**
- * List of entity identifiers to act on in bulk (1-100 entries)
- */
-export interface EntityIDsRequestDto {
-  /**
-   * Entity identifiers to act on
-   */
-  ids: Array<string>;
-}
-
 /**
  * Response object
  */
@@ -234,6 +211,50 @@ export interface EntityListResponse {
   updatedAt: string;
 }
 
+/**
+ * Wrapped response echoing the ids that were acted on by an archive/unarchive call
+ */
+export interface EntityArchiveResponse {
+  /**
+   * List of entity identifiers that were acted on
+   */
+  data: EntityArchiveResponse.Data;
+}
+
+export namespace EntityArchiveResponse {
+  /**
+   * List of entity identifiers that were acted on
+   */
+  export interface Data {
+    /**
+     * Entity identifiers to act on
+     */
+    ids: Array<string>;
+  }
+}
+
+/**
+ * Wrapped response echoing the ids that were acted on by an archive/unarchive call
+ */
+export interface EntityUnarchiveResponse {
+  /**
+   * List of entity identifiers that were acted on
+   */
+  data: EntityUnarchiveResponse.Data;
+}
+
+export namespace EntityUnarchiveResponse {
+  /**
+   * List of entity identifiers that were acted on
+   */
+  export interface Data {
+    /**
+     * Entity identifiers to act on
+     */
+    ids: Array<string>;
+  }
+}
+
 /**
  * List of entities created or updated by an upsert request
  */
@@ -345,10 +366,10 @@ export namespace EntityUpsertParams {
 
 export declare namespace Entities {
   export {
-    type EntityIDsActionResponseDto as EntityIDsActionResponseDto,
-    type EntityIDsRequestDto as EntityIDsRequestDto,
     type EntityRetrieveResponse as EntityRetrieveResponse,
     type EntityListResponse as EntityListResponse,
+    type EntityArchiveResponse as EntityArchiveResponse,
+    type EntityUnarchiveResponse as EntityUnarchiveResponse,
     type EntityUpsertResponse as EntityUpsertResponse,
     type EntityListResponsesMyCursorIDPage as EntityListResponsesMyCursorIDPage,
     type EntityRetrieveParams as EntityRetrieveParams,

package/src/resources/{v1-beta → v1/events/beta}/customers/entitlements.ts

@@ -1,9 +1,9 @@
 // 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 { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
+import { APIResource } from '../../../../../core/resource';
+import { APIPromise } from '../../../../../core/api-promise';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
 
 export class Entitlements extends APIResource {
   /**
@@ -14,7 +14,9 @@ export class Entitlements extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.v1Beta.customers.entitlements.check('x');
+   *   await client.v1.events.beta.customers.entitlements.check(
+   *     'x',
+   *   );
    * ```
    */
   check(

package/src/resources/{v1-beta → v1/events/beta}/customers/index.ts

@@ -11,10 +11,10 @@ export {
 export { Customers } from './customers';
 export {
   Entities,
-  type EntityIDsActionResponseDto,
-  type EntityIDsRequestDto,
   type EntityRetrieveResponse,
   type EntityListResponse,
+  type EntityArchiveResponse,
+  type EntityUnarchiveResponse,
   type EntityUpsertResponse,
   type EntityRetrieveParams,
   type EntityListParams,

package/src/resources/{v1-beta → v1/events/beta}/entity-types.ts

@@ -1,9 +1,9 @@
 // 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 { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../core/pagination';
-import { RequestOptions } from '../../internal/request-options';
+import { APIResource } from '../../../../core/resource';
+import { APIPromise } from '../../../../core/api-promise';
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../../core/pagination';
+import { RequestOptions } from '../../../../internal/request-options';
 
 export class EntityTypes extends APIResource {
   /**
@@ -14,7 +14,7 @@ export class EntityTypes extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const entityTypeListResponse of client.v1Beta.entityTypes.list()) {
+   * for await (const entityTypeListResponse of client.v1.events.beta.entityTypes.list()) {
    *   // ...
    * }
    * ```
@@ -36,20 +36,21 @@ export class EntityTypes extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.v1Beta.entityTypes.upsert({
-   *   types: [
-   *     {
-   *       id: 'org',
-   *       displayName: 'Organization',
-   *       attributionKeys: ['organizationId'],
-   *     },
-   *     {
-   *       id: 'team',
-   *       displayName: 'Team',
-   *       attributionKeys: ['teamId'],
-   *     },
-   *   ],
-   * });
+   * const response =
+   *   await client.v1.events.beta.entityTypes.upsert({
+   *     types: [
+   *       {
+   *         id: 'org',
+   *         displayName: 'Organization',
+   *         attributionKeys: ['organizationId'],
+   *       },
+   *       {
+   *         id: 'team',
+   *         displayName: 'Team',
+   *         attributionKeys: ['teamId'],
+   *       },
+   *     ],
+   *   });
    * ```
    */
   upsert(body: EntityTypeUpsertParams, options?: RequestOptions): APIPromise<EntityTypeUpsertResponse> {

package/src/resources/{v1-beta → v1/events/beta}/index.ts

@@ -1,5 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { Beta } from './beta';
 export { Customers } from './customers/index';
 export {
   EntityTypes,
@@ -9,4 +10,3 @@ export {
   type EntityTypeUpsertParams,
   type EntityTypeListResponsesMyCursorIDPage,
 } from './entity-types';
-export { V1Beta } from './v1-beta';

package/src/resources/{v1-beta.ts → v1/events/beta.ts}

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

package/src/resources/v1/events/events.ts

@@ -0,0 +1,98 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as BetaAPI from './beta/beta';
+import { Beta } from './beta/beta';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * Operations related to usage & metering
+ */
+export class Events extends APIResource {
+  beta: BetaAPI.Beta = new BetaAPI.Beta(this._client);
+
+  /**
+   * Reports raw usage events for event-based metering. Events are ingested
+   * asynchronously and aggregated into usage totals.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.events.report({
+   *   events: [
+   *     {
+   *       customerId: 'customerId',
+   *       eventName: 'x',
+   *       idempotencyKey: 'x',
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  report(body: EventReportParams, options?: RequestOptions): APIPromise<EventReportResponse> {
+    return this._client.post('/api/v1/events', { body, ...options });
+  }
+}
+
+/**
+ * Response object
+ */
+export interface EventReportResponse {
+  /**
+   * Empty success response confirming that events were successfully ingested and
+   * queued for processing by Stigg's metering system.
+   */
+  data: unknown;
+}
+
+export interface EventReportParams {
+  /**
+   * A list of usage events to report
+   */
+  events: Array<EventReportParams.Event>;
+}
+
+export namespace EventReportParams {
+  /**
+   * Raw usage event
+   */
+  export interface Event {
+    /**
+     * Customer id
+     */
+    customerId: string;
+
+    /**
+     * The name of the usage event
+     */
+    eventName: string;
+
+    /**
+     * Idempotency key
+     */
+    idempotencyKey: string;
+
+    /**
+     * Dimensions associated with the usage event
+     */
+    dimensions?: { [key: string]: string | number | boolean };
+
+    /**
+     * Resource id
+     */
+    resourceId?: string | null;
+
+    /**
+     * Timestamp
+     */
+    timestamp?: string;
+  }
+}
+
+Events.Beta = Beta;
+
+export declare namespace Events {
+  export { type EventReportResponse as EventReportResponse, type EventReportParams as EventReportParams };
+
+  export { Beta as Beta };
+}

package/src/resources/v1/events/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Beta } from './beta/index';
+export { Events, type EventReportResponse, type EventReportParams } from './events';