lark-billing 0.0.9 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/dist/cjs/Client.js +2 -2
  2. package/dist/cjs/api/resources/pricingMetrics/client/Client.d.ts +25 -6
  3. package/dist/cjs/api/resources/pricingMetrics/client/Client.js +72 -4
  4. package/dist/cjs/api/resources/pricingMetrics/client/requests/CreatePricingMetricRequest.d.ts +9 -5
  5. package/dist/cjs/api/resources/pricingMetrics/client/requests/CreatePricingMetricSummaryRequest.d.ts +20 -0
  6. package/dist/cjs/api/resources/pricingMetrics/client/requests/index.d.ts +1 -0
  7. package/dist/cjs/api/resources/pricingMetrics/types/PricingMetricAggregation.d.ts +13 -1
  8. package/dist/cjs/api/resources/rateCards/client/Client.d.ts +27 -1
  9. package/dist/cjs/api/resources/rateCards/client/Client.js +27 -1
  10. package/dist/cjs/api/resources/rateCards/client/requests/CreateRateCardRequest.d.ts +29 -1
  11. package/dist/cjs/api/resources/subjects/client/Client.d.ts +8 -1
  12. package/dist/cjs/api/resources/subjects/client/Client.js +8 -1
  13. package/dist/cjs/api/resources/subjects/client/requests/CreateSubjectRequest.d.ts +8 -1
  14. package/dist/cjs/api/resources/usageEvents/client/Client.d.ts +7 -23
  15. package/dist/cjs/api/resources/usageEvents/client/Client.js +7 -72
  16. package/dist/cjs/api/resources/usageEvents/client/requests/CreateUsageEventRequest.d.ts +8 -5
  17. package/dist/cjs/api/resources/usageEvents/client/requests/index.d.ts +0 -1
  18. package/dist/cjs/api/types/Aggregation.d.ts +10 -1
  19. package/dist/cjs/api/types/BillingStateResponse.d.ts +2 -0
  20. package/dist/cjs/api/types/CountAggregationPricingMetricInterface.d.ts +3 -0
  21. package/dist/cjs/api/types/CustomAggregationPricingMetricInterface.d.ts +10 -0
  22. package/dist/cjs/api/types/LastAggregationPricingMetricInterface.d.ts +10 -0
  23. package/dist/cjs/api/types/LastAggregationPricingMetricResource.d.ts +7 -0
  24. package/dist/cjs/api/types/LastAggregationPricingMetricResource.js +5 -0
  25. package/dist/cjs/api/types/MaxAggregationPricingMetricInterface.d.ts +10 -0
  26. package/dist/cjs/api/types/MaxAggregationPricingMetricInterface.js +5 -0
  27. package/dist/cjs/api/types/MaxAggregationPricingMetricResource.d.ts +7 -0
  28. package/dist/cjs/api/types/MaxAggregationPricingMetricResource.js +5 -0
  29. package/dist/cjs/api/types/PricingMetricResource.d.ts +5 -0
  30. package/dist/cjs/api/types/PricingMetricSummaryResource.d.ts +16 -0
  31. package/dist/cjs/api/types/PricingMetricSummaryResource.js +5 -0
  32. package/dist/cjs/api/types/SumAggregationPricingMetricInterface.d.ts +3 -0
  33. package/dist/cjs/api/types/SumAggregationPricingMetricResource.d.ts +1 -0
  34. package/dist/cjs/api/types/index.d.ts +7 -4
  35. package/dist/cjs/api/types/index.js +7 -4
  36. package/dist/cjs/version.d.ts +1 -1
  37. package/dist/cjs/version.js +1 -1
  38. package/dist/esm/Client.mjs +2 -2
  39. package/dist/esm/api/resources/pricingMetrics/client/Client.d.mts +25 -6
  40. package/dist/esm/api/resources/pricingMetrics/client/Client.mjs +72 -4
  41. package/dist/esm/api/resources/pricingMetrics/client/requests/CreatePricingMetricRequest.d.mts +9 -5
  42. package/dist/esm/api/resources/pricingMetrics/client/requests/CreatePricingMetricSummaryRequest.d.mts +20 -0
  43. package/dist/esm/api/resources/pricingMetrics/client/requests/index.d.mts +1 -0
  44. package/dist/esm/api/resources/pricingMetrics/types/PricingMetricAggregation.d.mts +13 -1
  45. package/dist/esm/api/resources/rateCards/client/Client.d.mts +27 -1
  46. package/dist/esm/api/resources/rateCards/client/Client.mjs +27 -1
  47. package/dist/esm/api/resources/rateCards/client/requests/CreateRateCardRequest.d.mts +29 -1
  48. package/dist/esm/api/resources/subjects/client/Client.d.mts +8 -1
  49. package/dist/esm/api/resources/subjects/client/Client.mjs +8 -1
  50. package/dist/esm/api/resources/subjects/client/requests/CreateSubjectRequest.d.mts +8 -1
  51. package/dist/esm/api/resources/usageEvents/client/Client.d.mts +7 -23
  52. package/dist/esm/api/resources/usageEvents/client/Client.mjs +7 -72
  53. package/dist/esm/api/resources/usageEvents/client/requests/CreateUsageEventRequest.d.mts +8 -5
  54. package/dist/esm/api/resources/usageEvents/client/requests/index.d.mts +0 -1
  55. package/dist/esm/api/types/Aggregation.d.mts +10 -1
  56. package/dist/esm/api/types/BillingStateResponse.d.mts +2 -0
  57. package/dist/esm/api/types/CountAggregationPricingMetricInterface.d.mts +3 -0
  58. package/dist/esm/api/types/CustomAggregationPricingMetricInterface.d.mts +10 -0
  59. package/dist/esm/api/types/LastAggregationPricingMetricInterface.d.mts +10 -0
  60. package/dist/esm/api/types/LastAggregationPricingMetricResource.d.mts +7 -0
  61. package/dist/esm/api/types/LastAggregationPricingMetricResource.mjs +4 -0
  62. package/dist/esm/api/types/MaxAggregationPricingMetricInterface.d.mts +10 -0
  63. package/dist/esm/api/types/MaxAggregationPricingMetricInterface.mjs +4 -0
  64. package/dist/esm/api/types/MaxAggregationPricingMetricResource.d.mts +7 -0
  65. package/dist/esm/api/types/MaxAggregationPricingMetricResource.mjs +4 -0
  66. package/dist/esm/api/types/PricingMetricResource.d.mts +5 -0
  67. package/dist/esm/api/types/PricingMetricSummaryResource.d.mts +16 -0
  68. package/dist/esm/api/types/PricingMetricSummaryResource.mjs +4 -0
  69. package/dist/esm/api/types/SumAggregationPricingMetricInterface.d.mts +3 -0
  70. package/dist/esm/api/types/SumAggregationPricingMetricResource.d.mts +1 -0
  71. package/dist/esm/api/types/index.d.mts +7 -4
  72. package/dist/esm/api/types/index.mjs +7 -4
  73. package/dist/esm/version.d.mts +1 -1
  74. package/dist/esm/version.mjs +1 -1
  75. package/package.json +1 -1
  76. package/reference.md +114 -67
  77. package/dist/cjs/api/resources/usageEvents/client/requests/CreateUsageEventSummaryRequest.d.ts +0 -30
  78. package/dist/cjs/api/resources/usageEvents/client/requests/CreateUsageEventSummaryRequest.js +0 -14
  79. package/dist/cjs/api/types/CreatePricingMetricResponse.d.ts +0 -11
  80. package/dist/cjs/api/types/CreateUsageEventSummaryResponse.d.ts +0 -10
  81. package/dist/cjs/api/types/GetPricingMetricResponse.d.ts +0 -11
  82. package/dist/esm/api/resources/usageEvents/client/requests/CreateUsageEventSummaryRequest.d.mts +0 -30
  83. package/dist/esm/api/resources/usageEvents/client/requests/CreateUsageEventSummaryRequest.mjs +0 -11
  84. package/dist/esm/api/types/CreatePricingMetricResponse.d.mts +0 -11
  85. package/dist/esm/api/types/CreateUsageEventSummaryResponse.d.mts +0 -10
  86. package/dist/esm/api/types/GetPricingMetricResponse.d.mts +0 -11
  87. /package/dist/cjs/api/{types/CreatePricingMetricResponse.js → resources/pricingMetrics/client/requests/CreatePricingMetricSummaryRequest.js} +0 -0
  88. /package/dist/cjs/api/types/{CreateUsageEventSummaryResponse.js → CustomAggregationPricingMetricInterface.js} +0 -0
  89. /package/dist/cjs/api/types/{GetPricingMetricResponse.js → LastAggregationPricingMetricInterface.js} +0 -0
  90. /package/dist/esm/api/{types/CreatePricingMetricResponse.mjs → resources/pricingMetrics/client/requests/CreatePricingMetricSummaryRequest.mjs} +0 -0
  91. /package/dist/esm/api/types/{CreateUsageEventSummaryResponse.mjs → CustomAggregationPricingMetricInterface.mjs} +0 -0
  92. /package/dist/esm/api/types/{GetPricingMetricResponse.mjs → LastAggregationPricingMetricInterface.mjs} +0 -0
@@ -0,0 +1,10 @@
1
+ /**
2
+ * This file was auto-generated by Fern from our API Definition.
3
+ */
4
+ /**
5
+ * Computes the max value of the `value_field` over all usage events with the specified `event_name`.
6
+ */
7
+ export interface MaxAggregationPricingMetricInterface {
8
+ /** Field to get the max value of. */
9
+ value_field: string;
10
+ }
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ /**
3
+ * This file was auto-generated by Fern from our API Definition.
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,7 @@
1
+ /**
2
+ * This file was auto-generated by Fern from our API Definition.
3
+ */
4
+ export interface MaxAggregationPricingMetricResource {
5
+ /** The field to get the max value of. */
6
+ value_field: string;
7
+ }
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ /**
3
+ * This file was auto-generated by Fern from our API Definition.
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -3,9 +3,14 @@
3
3
  */
4
4
  import * as Lark from "../index.js";
5
5
  export interface PricingMetricResource {
6
+ /** The ID of the pricing metric. */
6
7
  id: string;
8
+ /** The name of the pricing metric. */
7
9
  name: string;
10
+ /** The event name that the pricing metric is computed on. */
8
11
  event_name: string;
12
+ /** The aggregation function used to compute the value of the pricing metric. */
9
13
  aggregation: Lark.Aggregation;
14
+ /** The unit of the value computed by the pricing metric. */
10
15
  unit: string;
11
16
  }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * This file was auto-generated by Fern from our API Definition.
3
+ */
4
+ import * as Lark from "../index.js";
5
+ export interface PricingMetricSummaryResource {
6
+ /** The ID of the pricing metric summary. */
7
+ id: string;
8
+ /** The ID of the pricing metric that the summary is for. */
9
+ pricing_metric_id: string;
10
+ /** The ID of the subject that the summary is for. */
11
+ subject_id: string;
12
+ /** The period that the summary is computed over. */
13
+ period: Lark.Period;
14
+ /** The computed value of the pricing metric for the period. If the pricing metric does not have any usage events for the period, this will be `null`. */
15
+ value?: string;
16
+ }
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ /**
3
+ * This file was auto-generated by Fern from our API Definition.
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,6 +1,9 @@
1
1
  /**
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
+ /**
5
+ * Computes the sum of the `value_field` over all usage events with the specified `event_name`.
6
+ */
4
7
  export interface SumAggregationPricingMetricInterface {
5
8
  /** Field to sum over. */
6
9
  value_field: string;
@@ -2,5 +2,6 @@
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
4
  export interface SumAggregationPricingMetricResource {
5
+ /** The field to sum over. */
5
6
  value_field: string;
6
7
  }
@@ -5,27 +5,30 @@ export * from "./CountAggregationPricingMetricResource.js";
5
5
  export * from "./CreateCustomerPortalSessionResponse.js";
6
6
  export * from "./Price.js";
7
7
  export * from "./CreateFixedRateRequest.js";
8
- export * from "./Aggregation.js";
9
- export * from "./CreatePricingMetricResponse.js";
10
8
  export * from "./CreateSimpleUsageBasedRateRequest.js";
11
9
  export * from "./CreateSubjectResponse.js";
12
10
  export * from "./CreateSubscriptionCheckoutSessionResponse.js";
13
- export * from "./CreateUsageEventSummaryResponse.js";
11
+ export * from "./CustomAggregationPricingMetricInterface.js";
14
12
  export * from "./FixedRateInterface.js";
15
13
  export * from "./FlatPrice.js";
16
- export * from "./GetPricingMetricResponse.js";
17
14
  export * from "./HttpValidationError.js";
18
15
  export * from "./InvoiceLineItemResource.js";
19
16
  export * from "./InvoiceResource.js";
17
+ export * from "./LastAggregationPricingMetricInterface.js";
18
+ export * from "./LastAggregationPricingMetricResource.js";
20
19
  export * from "./ListInvoicesResponse.js";
21
20
  export * from "./ListPricingMetricsResponse.js";
22
21
  export * from "./ListRateCardsResponse.js";
23
22
  export * from "./ListSubjectsResponse.js";
24
23
  export * from "./ListSubscriptionsResponse.js";
24
+ export * from "./MaxAggregationPricingMetricInterface.js";
25
+ export * from "./MaxAggregationPricingMetricResource.js";
25
26
  export * from "./PackagePrice.js";
26
27
  export * from "./Period.js";
27
28
  export * from "./PeriodResource.js";
29
+ export * from "./Aggregation.js";
28
30
  export * from "./PricingMetricResource.js";
31
+ export * from "./PricingMetricSummaryResource.js";
29
32
  export * from "./RateCardResourceUsageBasedRatesItem.js";
30
33
  export * from "./RateCardResource.js";
31
34
  export * from "./SimpleUsageBasedRateInterface.js";
@@ -21,27 +21,30 @@ __exportStar(require("./CountAggregationPricingMetricResource.js"), exports);
21
21
  __exportStar(require("./CreateCustomerPortalSessionResponse.js"), exports);
22
22
  __exportStar(require("./Price.js"), exports);
23
23
  __exportStar(require("./CreateFixedRateRequest.js"), exports);
24
- __exportStar(require("./Aggregation.js"), exports);
25
- __exportStar(require("./CreatePricingMetricResponse.js"), exports);
26
24
  __exportStar(require("./CreateSimpleUsageBasedRateRequest.js"), exports);
27
25
  __exportStar(require("./CreateSubjectResponse.js"), exports);
28
26
  __exportStar(require("./CreateSubscriptionCheckoutSessionResponse.js"), exports);
29
- __exportStar(require("./CreateUsageEventSummaryResponse.js"), exports);
27
+ __exportStar(require("./CustomAggregationPricingMetricInterface.js"), exports);
30
28
  __exportStar(require("./FixedRateInterface.js"), exports);
31
29
  __exportStar(require("./FlatPrice.js"), exports);
32
- __exportStar(require("./GetPricingMetricResponse.js"), exports);
33
30
  __exportStar(require("./HttpValidationError.js"), exports);
34
31
  __exportStar(require("./InvoiceLineItemResource.js"), exports);
35
32
  __exportStar(require("./InvoiceResource.js"), exports);
33
+ __exportStar(require("./LastAggregationPricingMetricInterface.js"), exports);
34
+ __exportStar(require("./LastAggregationPricingMetricResource.js"), exports);
36
35
  __exportStar(require("./ListInvoicesResponse.js"), exports);
37
36
  __exportStar(require("./ListPricingMetricsResponse.js"), exports);
38
37
  __exportStar(require("./ListRateCardsResponse.js"), exports);
39
38
  __exportStar(require("./ListSubjectsResponse.js"), exports);
40
39
  __exportStar(require("./ListSubscriptionsResponse.js"), exports);
40
+ __exportStar(require("./MaxAggregationPricingMetricInterface.js"), exports);
41
+ __exportStar(require("./MaxAggregationPricingMetricResource.js"), exports);
41
42
  __exportStar(require("./PackagePrice.js"), exports);
42
43
  __exportStar(require("./Period.js"), exports);
43
44
  __exportStar(require("./PeriodResource.js"), exports);
45
+ __exportStar(require("./Aggregation.js"), exports);
44
46
  __exportStar(require("./PricingMetricResource.js"), exports);
47
+ __exportStar(require("./PricingMetricSummaryResource.js"), exports);
45
48
  __exportStar(require("./RateCardResourceUsageBasedRatesItem.js"), exports);
46
49
  __exportStar(require("./RateCardResource.js"), exports);
47
50
  __exportStar(require("./SimpleUsageBasedRateInterface.js"), exports);
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "0.0.9";
1
+ export declare const SDK_VERSION = "0.1.0";
@@ -1,4 +1,4 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SDK_VERSION = void 0;
4
- exports.SDK_VERSION = "0.0.9";
4
+ exports.SDK_VERSION = "0.1.0";
@@ -17,8 +17,8 @@ export class LarkClient {
17
17
  this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
18
18
  "X-Fern-Language": "JavaScript",
19
19
  "X-Fern-SDK-Name": "lark-billing",
20
- "X-Fern-SDK-Version": "0.0.9",
21
- "User-Agent": "lark-billing/0.0.9",
20
+ "X-Fern-SDK-Version": "0.1.0",
21
+ "User-Agent": "lark-billing/0.1.0",
22
22
  "X-Fern-Runtime": core.RUNTIME.type,
23
23
  "X-Fern-Runtime-Version": core.RUNTIME.version,
24
24
  }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -50,15 +50,16 @@ export declare class PricingMetrics {
50
50
  *
51
51
  * @example
52
52
  * await client.pricingMetrics.createPricingMetric({
53
- * name: "name",
54
- * event_name: "event_name",
53
+ * name: "Compute Hours",
54
+ * event_name: "job_completed",
55
55
  * aggregation: {
56
- * aggregation_type: "count"
56
+ * aggregation_type: "sum",
57
+ * value_field: "value_field"
57
58
  * },
58
- * unit: "unit"
59
+ * unit: "hours"
59
60
  * })
60
61
  */
61
- createPricingMetric(request: Lark.CreatePricingMetricRequest, requestOptions?: PricingMetrics.RequestOptions): core.HttpResponsePromise<Lark.CreatePricingMetricResponse>;
62
+ createPricingMetric(request: Lark.CreatePricingMetricRequest, requestOptions?: PricingMetrics.RequestOptions): core.HttpResponsePromise<Lark.PricingMetricResource>;
62
63
  private __createPricingMetric;
63
64
  /**
64
65
  * @param {string} pricingMetricId
@@ -69,8 +70,26 @@ export declare class PricingMetrics {
69
70
  * @example
70
71
  * await client.pricingMetrics.getPricingMetric("pricing_metric_id")
71
72
  */
72
- getPricingMetric(pricingMetricId: string, requestOptions?: PricingMetrics.RequestOptions): core.HttpResponsePromise<Lark.GetPricingMetricResponse>;
73
+ getPricingMetric(pricingMetricId: string, requestOptions?: PricingMetrics.RequestOptions): core.HttpResponsePromise<Lark.PricingMetricResource>;
73
74
  private __getPricingMetric;
75
+ /**
76
+ * @param {string} pricingMetricId
77
+ * @param {Lark.CreatePricingMetricSummaryRequest} request
78
+ * @param {PricingMetrics.RequestOptions} requestOptions - Request-specific configuration.
79
+ *
80
+ * @throws {@link Lark.UnprocessableEntityError}
81
+ *
82
+ * @example
83
+ * await client.pricingMetrics.createPricingMetricSummary("pricing_metric_id", {
84
+ * subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
85
+ * period: {
86
+ * start: "2025-10-01T00:00:00Z",
87
+ * end: "2025-11-01T00:00:00Z"
88
+ * }
89
+ * })
90
+ */
91
+ createPricingMetricSummary(pricingMetricId: string, request: Lark.CreatePricingMetricSummaryRequest, requestOptions?: PricingMetrics.RequestOptions): core.HttpResponsePromise<Lark.PricingMetricSummaryResource>;
92
+ private __createPricingMetricSummary;
74
93
  protected _getCustomAuthorizationHeaders(): Promise<{
75
94
  "X-API-Key": string;
76
95
  }>;
@@ -91,12 +91,13 @@ export class PricingMetrics {
91
91
  *
92
92
  * @example
93
93
  * await client.pricingMetrics.createPricingMetric({
94
- * name: "name",
95
- * event_name: "event_name",
94
+ * name: "Compute Hours",
95
+ * event_name: "job_completed",
96
96
  * aggregation: {
97
- * aggregation_type: "count"
97
+ * aggregation_type: "sum",
98
+ * value_field: "value_field"
98
99
  * },
99
- * unit: "unit"
100
+ * unit: "hours"
100
101
  * })
101
102
  */
102
103
  createPricingMetric(request, requestOptions) {
@@ -207,6 +208,73 @@ export class PricingMetrics {
207
208
  }
208
209
  });
209
210
  }
211
+ /**
212
+ * @param {string} pricingMetricId
213
+ * @param {Lark.CreatePricingMetricSummaryRequest} request
214
+ * @param {PricingMetrics.RequestOptions} requestOptions - Request-specific configuration.
215
+ *
216
+ * @throws {@link Lark.UnprocessableEntityError}
217
+ *
218
+ * @example
219
+ * await client.pricingMetrics.createPricingMetricSummary("pricing_metric_id", {
220
+ * subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
221
+ * period: {
222
+ * start: "2025-10-01T00:00:00Z",
223
+ * end: "2025-11-01T00:00:00Z"
224
+ * }
225
+ * })
226
+ */
227
+ createPricingMetricSummary(pricingMetricId, request, requestOptions) {
228
+ return core.HttpResponsePromise.fromPromise(this.__createPricingMetricSummary(pricingMetricId, request, requestOptions));
229
+ }
230
+ __createPricingMetricSummary(pricingMetricId, request, requestOptions) {
231
+ return __awaiter(this, void 0, void 0, function* () {
232
+ var _a, _b, _c;
233
+ let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
234
+ const _response = yield core.fetcher({
235
+ url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LarkEnvironment.Default, `pricing-metrics/${encodeURIComponent(pricingMetricId)}/summary`),
236
+ method: "POST",
237
+ headers: _headers,
238
+ contentType: "application/json",
239
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
240
+ requestType: "json",
241
+ body: request,
242
+ timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
243
+ maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
244
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
245
+ });
246
+ if (_response.ok) {
247
+ return { data: _response.body, rawResponse: _response.rawResponse };
248
+ }
249
+ if (_response.error.reason === "status-code") {
250
+ switch (_response.error.statusCode) {
251
+ case 422:
252
+ throw new Lark.UnprocessableEntityError(_response.error.body, _response.rawResponse);
253
+ default:
254
+ throw new errors.LarkError({
255
+ statusCode: _response.error.statusCode,
256
+ body: _response.error.body,
257
+ rawResponse: _response.rawResponse,
258
+ });
259
+ }
260
+ }
261
+ switch (_response.error.reason) {
262
+ case "non-json":
263
+ throw new errors.LarkError({
264
+ statusCode: _response.error.statusCode,
265
+ body: _response.error.rawBody,
266
+ rawResponse: _response.rawResponse,
267
+ });
268
+ case "timeout":
269
+ throw new errors.LarkTimeoutError("Timeout exceeded when calling POST /pricing-metrics/{pricing_metric_id}/summary.");
270
+ case "unknown":
271
+ throw new errors.LarkError({
272
+ message: _response.error.errorMessage,
273
+ rawResponse: _response.rawResponse,
274
+ });
275
+ }
276
+ });
277
+ }
210
278
  _getCustomAuthorizationHeaders() {
211
279
  return __awaiter(this, void 0, void 0, function* () {
212
280
  const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
@@ -5,18 +5,22 @@ import * as Lark from "../../../../index.mjs";
5
5
  /**
6
6
  * @example
7
7
  * {
8
- * name: "name",
9
- * event_name: "event_name",
8
+ * name: "Compute Hours",
9
+ * event_name: "job_completed",
10
10
  * aggregation: {
11
- * aggregation_type: "count"
11
+ * aggregation_type: "sum",
12
+ * value_field: "value_field"
12
13
  * },
13
- * unit: "unit"
14
+ * unit: "hours"
14
15
  * }
15
16
  */
16
17
  export interface CreatePricingMetricRequest {
18
+ /** The name of the pricing metric. */
17
19
  name: string;
20
+ /** The name of the event that the pricing metric is computed on. */
18
21
  event_name: string;
22
+ /** The aggregation function used to compute the value of the pricing metric. */
19
23
  aggregation: Lark.PricingMetricAggregation;
20
- /** Unit of measurement for the pricing metric */
24
+ /** Unit of measurement for the pricing metric. */
21
25
  unit: string;
22
26
  }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * This file was auto-generated by Fern from our API Definition.
3
+ */
4
+ import * as Lark from "../../../../index.mjs";
5
+ /**
6
+ * @example
7
+ * {
8
+ * subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
9
+ * period: {
10
+ * start: "2025-10-01T00:00:00Z",
11
+ * end: "2025-11-01T00:00:00Z"
12
+ * }
13
+ * }
14
+ */
15
+ export interface CreatePricingMetricSummaryRequest {
16
+ /** The ID of the subject that the summary should be computed for. */
17
+ subject_id: string;
18
+ /** The period that the summary should be computed over. */
19
+ period: Lark.Period;
20
+ }
@@ -1,2 +1,3 @@
1
1
  export { type ListPricingMetricsPricingMetricsGetRequest } from "./ListPricingMetricsPricingMetricsGetRequest.mjs";
2
2
  export { type CreatePricingMetricRequest } from "./CreatePricingMetricRequest.mjs";
3
+ export { type CreatePricingMetricSummaryRequest } from "./CreatePricingMetricSummaryRequest.mjs";
@@ -2,11 +2,23 @@
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
4
  import * as Lark from "../../../index.mjs";
5
- export type PricingMetricAggregation = Lark.PricingMetricAggregation.Count | Lark.PricingMetricAggregation.Sum;
5
+ /**
6
+ * The aggregation function used to compute the value of the pricing metric.
7
+ */
8
+ export type PricingMetricAggregation = Lark.PricingMetricAggregation.Count | Lark.PricingMetricAggregation.Custom | Lark.PricingMetricAggregation.Last | Lark.PricingMetricAggregation.Max | Lark.PricingMetricAggregation.Sum;
6
9
  export declare namespace PricingMetricAggregation {
7
10
  interface Count extends Lark.CountAggregationPricingMetricInterface {
8
11
  aggregation_type: "count";
9
12
  }
13
+ interface Custom extends Lark.CustomAggregationPricingMetricInterface {
14
+ aggregation_type: "custom";
15
+ }
16
+ interface Last extends Lark.LastAggregationPricingMetricInterface {
17
+ aggregation_type: "last";
18
+ }
19
+ interface Max extends Lark.MaxAggregationPricingMetricInterface {
20
+ aggregation_type: "max";
21
+ }
10
22
  interface Sum extends Lark.SumAggregationPricingMetricInterface {
11
23
  aggregation_type: "sum";
12
24
  }
@@ -51,7 +51,33 @@ export declare class RateCards {
51
51
  * @example
52
52
  * await client.rateCards.createRateCard({
53
53
  * name: "Pro Plan",
54
- * billing_interval: "monthly"
54
+ * description: "For production applications with moderate usage.",
55
+ * billing_interval: "monthly",
56
+ * fixed_rates: [{
57
+ * name: "Base Rate",
58
+ * price: {
59
+ * price_type: "flat",
60
+ * amount: {
61
+ * value: "2500",
62
+ * currency_code: "usd"
63
+ * }
64
+ * }
65
+ * }],
66
+ * usage_based_rates: [{
67
+ * usage_based_rate_type: "simple",
68
+ * name: "name",
69
+ * price: {
70
+ * price_type: "flat",
71
+ * amount: {
72
+ * value: "2500",
73
+ * currency_code: "usd"
74
+ * }
75
+ * },
76
+ * pricing_metric_id: "pricing_metric_id"
77
+ * }],
78
+ * metadata: {
79
+ * "key": "value"
80
+ * }
55
81
  * })
56
82
  */
57
83
  createRateCard(request: Lark.CreateRateCardRequest, requestOptions?: RateCards.RequestOptions): core.HttpResponsePromise<Lark.RateCardResource>;
@@ -92,7 +92,33 @@ export class RateCards {
92
92
  * @example
93
93
  * await client.rateCards.createRateCard({
94
94
  * name: "Pro Plan",
95
- * billing_interval: "monthly"
95
+ * description: "For production applications with moderate usage.",
96
+ * billing_interval: "monthly",
97
+ * fixed_rates: [{
98
+ * name: "Base Rate",
99
+ * price: {
100
+ * price_type: "flat",
101
+ * amount: {
102
+ * value: "2500",
103
+ * currency_code: "usd"
104
+ * }
105
+ * }
106
+ * }],
107
+ * usage_based_rates: [{
108
+ * usage_based_rate_type: "simple",
109
+ * name: "name",
110
+ * price: {
111
+ * price_type: "flat",
112
+ * amount: {
113
+ * value: "2500",
114
+ * currency_code: "usd"
115
+ * }
116
+ * },
117
+ * pricing_metric_id: "pricing_metric_id"
118
+ * }],
119
+ * metadata: {
120
+ * "key": "value"
121
+ * }
96
122
  * })
97
123
  */
98
124
  createRateCard(request, requestOptions) {
@@ -6,7 +6,33 @@ import * as Lark from "../../../../index.mjs";
6
6
  * @example
7
7
  * {
8
8
  * name: "Pro Plan",
9
- * billing_interval: "monthly"
9
+ * description: "For production applications with moderate usage.",
10
+ * billing_interval: "monthly",
11
+ * fixed_rates: [{
12
+ * name: "Base Rate",
13
+ * price: {
14
+ * price_type: "flat",
15
+ * amount: {
16
+ * value: "2500",
17
+ * currency_code: "usd"
18
+ * }
19
+ * }
20
+ * }],
21
+ * usage_based_rates: [{
22
+ * usage_based_rate_type: "simple",
23
+ * name: "name",
24
+ * price: {
25
+ * price_type: "flat",
26
+ * amount: {
27
+ * value: "2500",
28
+ * currency_code: "usd"
29
+ * }
30
+ * },
31
+ * pricing_metric_id: "pricing_metric_id"
32
+ * }],
33
+ * metadata: {
34
+ * "key": "value"
35
+ * }
10
36
  * }
11
37
  */
12
38
  export interface CreateRateCardRequest {
@@ -16,7 +42,9 @@ export interface CreateRateCardRequest {
16
42
  description?: string;
17
43
  /** How often the customer will be billed for this rate card. */
18
44
  billing_interval: CreateRateCardRequest.BillingInterval;
45
+ /** The fixed rates of the rate card. These are billed at the start of each billing cycle. */
19
46
  fixed_rates?: Lark.CreateFixedRateRequest[];
47
+ /** The usage based rates of the rate card. These are billed at the end of each billing cycle. */
20
48
  usage_based_rates?: Lark.CreateRateCardRequestUsageBasedRatesItem[];
21
49
  metadata?: Record<string, string>;
22
50
  }
@@ -50,7 +50,14 @@ export declare class Subjects {
50
50
  * @throws {@link Lark.UnprocessableEntityError}
51
51
  *
52
52
  * @example
53
- * await client.subjects.createSubject()
53
+ * await client.subjects.createSubject({
54
+ * external_id: "user_1234567890",
55
+ * name: "John Doe",
56
+ * email: "john.doe@example.com",
57
+ * metadata: {
58
+ * "key": "value"
59
+ * }
60
+ * })
54
61
  */
55
62
  createSubject(request?: Lark.CreateSubjectRequest, requestOptions?: Subjects.RequestOptions): core.HttpResponsePromise<Lark.CreateSubjectResponse>;
56
63
  private __createSubject;
@@ -94,7 +94,14 @@ export class Subjects {
94
94
  * @throws {@link Lark.UnprocessableEntityError}
95
95
  *
96
96
  * @example
97
- * await client.subjects.createSubject()
97
+ * await client.subjects.createSubject({
98
+ * external_id: "user_1234567890",
99
+ * name: "John Doe",
100
+ * email: "john.doe@example.com",
101
+ * metadata: {
102
+ * "key": "value"
103
+ * }
104
+ * })
98
105
  */
99
106
  createSubject(request = {}, requestOptions) {
100
107
  return core.HttpResponsePromise.fromPromise(this.__createSubject(request, requestOptions));
@@ -3,7 +3,14 @@
3
3
  */
4
4
  /**
5
5
  * @example
6
- * {}
6
+ * {
7
+ * external_id: "user_1234567890",
8
+ * name: "John Doe",
9
+ * email: "john.doe@example.com",
10
+ * metadata: {
11
+ * "key": "value"
12
+ * }
13
+ * }
7
14
  */
8
15
  export interface CreateSubjectRequest {
9
16
  /** The ID of the subject in your system. If provided, you may use pass it to the API in place of the subject ID. Must be unique. */
@@ -37,35 +37,19 @@ export declare class UsageEvents {
37
37
  *
38
38
  * @example
39
39
  * await client.usageEvents.createUsageEvent({
40
- * idempotency_key: "idempotency_key",
41
- * event_name: "event_name",
42
- * subject_id: "subject_id",
40
+ * idempotency_key: "6b4ef298-4566-427d-b2ca-cd8fbe38ec60",
41
+ * event_name: "compute_hours",
42
+ * subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
43
+ * timestamp: "2025-10-31T20:29:47Z",
43
44
  * data: {
44
- * "key": "value"
45
+ * "compute_hours": 100,
46
+ * "instance_type": "t2.micro",
47
+ * "region": "us-east-1"
45
48
  * }
46
49
  * })
47
50
  */
48
51
  createUsageEvent(request: Lark.CreateUsageEventRequest, requestOptions?: UsageEvents.RequestOptions): core.HttpResponsePromise<unknown>;
49
52
  private __createUsageEvent;
50
- /**
51
- * @param {Lark.CreateUsageEventSummaryRequest} request
52
- * @param {UsageEvents.RequestOptions} requestOptions - Request-specific configuration.
53
- *
54
- * @throws {@link Lark.UnprocessableEntityError}
55
- *
56
- * @example
57
- * await client.usageEvents.createUsageEventSummary({
58
- * event_name: "event_name",
59
- * subject_id: "subject_id",
60
- * period: {
61
- * start: "2024-01-15T09:30:00Z",
62
- * end: "2024-01-15T09:30:00Z"
63
- * },
64
- * aggregation_type: "sum"
65
- * })
66
- */
67
- createUsageEventSummary(request: Lark.CreateUsageEventSummaryRequest, requestOptions?: UsageEvents.RequestOptions): core.HttpResponsePromise<Lark.CreateUsageEventSummaryResponse>;
68
- private __createUsageEventSummary;
69
53
  protected _getCustomAuthorizationHeaders(): Promise<{
70
54
  "X-API-Key": string;
71
55
  }>;