@paid-ai/paid-node 1.0.0 → 1.0.1-alpha1

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 (196) hide show
  1. package/dist/cjs/BaseClient.d.ts +4 -17
  2. package/dist/cjs/BaseClient.js +0 -59
  3. package/dist/cjs/Client.d.ts +28 -28
  4. package/dist/cjs/Client.js +52 -11
  5. package/dist/cjs/api/errors/BadRequestError.js +1 -5
  6. package/dist/cjs/api/errors/ForbiddenError.js +1 -5
  7. package/dist/cjs/api/errors/InternalServerError.js +1 -5
  8. package/dist/cjs/api/errors/NotFoundError.js +1 -5
  9. package/dist/cjs/api/resources/agents/client/Client.d.ts +23 -22
  10. package/dist/cjs/api/resources/agents/client/Client.js +158 -55
  11. package/dist/cjs/api/resources/contacts/client/Client.d.ts +19 -18
  12. package/dist/cjs/api/resources/contacts/client/Client.js +122 -43
  13. package/dist/cjs/api/resources/customers/client/Client.d.ts +37 -36
  14. package/dist/cjs/api/resources/customers/client/Client.js +315 -113
  15. package/dist/cjs/api/resources/orders/client/Client.d.ts +28 -27
  16. package/dist/cjs/api/resources/orders/client/Client.js +177 -62
  17. package/dist/cjs/api/resources/orders/resources/lines/client/Client.d.ts +9 -8
  18. package/dist/cjs/api/resources/orders/resources/lines/client/Client.js +32 -13
  19. package/dist/cjs/api/resources/plans/client/Client.d.ts +25 -12
  20. package/dist/cjs/api/resources/plans/client/Client.js +143 -33
  21. package/dist/cjs/api/resources/products/client/Client.d.ts +23 -22
  22. package/dist/cjs/api/resources/products/client/Client.js +158 -55
  23. package/dist/cjs/api/resources/products/client/requests/index.d.ts +1 -1
  24. package/dist/cjs/api/resources/products/client/requests/index.js +0 -3
  25. package/dist/cjs/api/resources/traces/client/Client.d.ts +9 -8
  26. package/dist/cjs/api/resources/traces/client/Client.js +57 -23
  27. package/dist/cjs/api/resources/usage/client/Client.d.ts +16 -15
  28. package/dist/cjs/api/resources/usage/client/Client.js +71 -28
  29. package/dist/cjs/api/resources/usage/client/requests/UsageRecordBulkV2Request.d.ts +3 -3
  30. package/dist/cjs/api/types/PlanWithFeatures.d.ts +34 -0
  31. package/dist/cjs/api/types/PlanWithFeatures.js +3 -0
  32. package/dist/cjs/api/types/SignalV2.d.ts +5 -5
  33. package/dist/cjs/api/types/index.d.ts +1 -0
  34. package/dist/cjs/api/types/index.js +1 -0
  35. package/dist/cjs/core/auth/AuthProvider.d.ts +1 -4
  36. package/dist/cjs/core/auth/BearerToken.d.ts +1 -3
  37. package/dist/cjs/core/auth/BearerToken.js +6 -7
  38. package/dist/cjs/core/auth/index.d.ts +0 -1
  39. package/dist/cjs/core/auth/index.js +1 -3
  40. package/dist/cjs/core/fetcher/BinaryResponse.d.ts +7 -6
  41. package/dist/cjs/core/fetcher/EndpointSupplier.d.ts +2 -2
  42. package/dist/cjs/core/fetcher/Fetcher.d.ts +4 -10
  43. package/dist/cjs/core/fetcher/Fetcher.js +10 -204
  44. package/dist/cjs/core/fetcher/ResponseWithBody.d.ts +4 -0
  45. package/dist/cjs/core/fetcher/ResponseWithBody.js +6 -0
  46. package/dist/cjs/core/fetcher/getRequestBody.d.ts +1 -1
  47. package/dist/cjs/core/fetcher/getRequestBody.js +0 -4
  48. package/dist/cjs/core/fetcher/getResponseBody.js +4 -18
  49. package/dist/cjs/core/fetcher/makeRequest.d.ts +1 -1
  50. package/dist/cjs/core/fetcher/makeRequest.js +2 -0
  51. package/dist/cjs/core/fetcher/requestWithRetries.js +9 -0
  52. package/dist/cjs/core/fetcher/signals.d.ts +7 -1
  53. package/dist/cjs/core/fetcher/signals.js +12 -0
  54. package/dist/cjs/core/headers.d.ts +2 -2
  55. package/dist/cjs/core/headers.js +4 -6
  56. package/dist/cjs/core/index.d.ts +0 -1
  57. package/dist/cjs/core/index.js +1 -2
  58. package/dist/cjs/core/runtime/runtime.js +10 -11
  59. package/dist/cjs/core/url/join.js +1 -0
  60. package/dist/cjs/errors/PaidError.js +1 -5
  61. package/dist/cjs/errors/PaidTimeoutError.js +1 -5
  62. package/dist/cjs/index.d.ts +0 -1
  63. package/dist/cjs/index.js +0 -4
  64. package/dist/cjs/integrations/adapters/expressjs/index.d.ts +2 -2
  65. package/dist/cjs/integrations/adapters/expressjs/index.js +2 -1
  66. package/dist/cjs/integrations/adapters/expressjs/routes.d.ts +16 -0
  67. package/dist/cjs/integrations/adapters/expressjs/routes.js +28 -0
  68. package/dist/cjs/integrations/adapters/nextjs/index.d.ts +1 -1
  69. package/dist/cjs/integrations/adapters/nextjs/index.js +2 -1
  70. package/dist/cjs/integrations/adapters/nextjs/routes.d.ts +15 -0
  71. package/dist/cjs/integrations/adapters/nextjs/routes.js +21 -0
  72. package/dist/cjs/integrations/controllers/index.d.ts +1 -0
  73. package/dist/cjs/integrations/controllers/index.js +3 -1
  74. package/dist/cjs/integrations/controllers/orders.js +52 -17
  75. package/dist/cjs/integrations/controllers/plans.d.ts +50 -0
  76. package/dist/cjs/integrations/controllers/plans.js +88 -0
  77. package/dist/cjs/integrations/types.d.ts +5 -2
  78. package/dist/cjs/version.d.ts +1 -1
  79. package/dist/cjs/version.js +1 -1
  80. package/dist/esm/BaseClient.d.mts +4 -17
  81. package/dist/esm/BaseClient.mjs +1 -24
  82. package/dist/esm/Client.d.mts +28 -28
  83. package/dist/esm/Client.mjs +27 -19
  84. package/dist/esm/api/errors/BadRequestError.mjs +1 -5
  85. package/dist/esm/api/errors/ForbiddenError.mjs +1 -5
  86. package/dist/esm/api/errors/InternalServerError.mjs +1 -5
  87. package/dist/esm/api/errors/NotFoundError.mjs +1 -5
  88. package/dist/esm/api/resources/agents/client/Client.d.mts +23 -22
  89. package/dist/esm/api/resources/agents/client/Client.mjs +157 -54
  90. package/dist/esm/api/resources/contacts/client/Client.d.mts +19 -18
  91. package/dist/esm/api/resources/contacts/client/Client.mjs +121 -42
  92. package/dist/esm/api/resources/customers/client/Client.d.mts +37 -36
  93. package/dist/esm/api/resources/customers/client/Client.mjs +314 -112
  94. package/dist/esm/api/resources/orders/client/Client.d.mts +28 -27
  95. package/dist/esm/api/resources/orders/client/Client.mjs +177 -62
  96. package/dist/esm/api/resources/orders/resources/lines/client/Client.d.mts +9 -8
  97. package/dist/esm/api/resources/orders/resources/lines/client/Client.mjs +31 -12
  98. package/dist/esm/api/resources/plans/client/Client.d.mts +25 -12
  99. package/dist/esm/api/resources/plans/client/Client.mjs +142 -32
  100. package/dist/esm/api/resources/products/client/Client.d.mts +23 -22
  101. package/dist/esm/api/resources/products/client/Client.mjs +157 -54
  102. package/dist/esm/api/resources/products/client/requests/index.d.mts +1 -1
  103. package/dist/esm/api/resources/products/client/requests/index.mjs +1 -1
  104. package/dist/esm/api/resources/traces/client/Client.d.mts +9 -8
  105. package/dist/esm/api/resources/traces/client/Client.mjs +56 -22
  106. package/dist/esm/api/resources/usage/client/Client.d.mts +16 -15
  107. package/dist/esm/api/resources/usage/client/Client.mjs +70 -27
  108. package/dist/esm/api/resources/usage/client/requests/UsageRecordBulkV2Request.d.mts +3 -3
  109. package/dist/esm/api/types/PlanWithFeatures.d.mts +34 -0
  110. package/dist/esm/api/types/PlanWithFeatures.mjs +2 -0
  111. package/dist/esm/api/types/SignalV2.d.mts +5 -5
  112. package/dist/esm/api/types/index.d.mts +1 -0
  113. package/dist/esm/api/types/index.mjs +1 -0
  114. package/dist/esm/core/auth/AuthProvider.d.mts +1 -4
  115. package/dist/esm/core/auth/BearerToken.d.mts +1 -3
  116. package/dist/esm/core/auth/BearerToken.mjs +6 -7
  117. package/dist/esm/core/auth/index.d.mts +0 -1
  118. package/dist/esm/core/auth/index.mjs +0 -1
  119. package/dist/esm/core/fetcher/BinaryResponse.d.mts +7 -6
  120. package/dist/esm/core/fetcher/EndpointSupplier.d.mts +2 -2
  121. package/dist/esm/core/fetcher/Fetcher.d.mts +4 -10
  122. package/dist/esm/core/fetcher/Fetcher.mjs +10 -204
  123. package/dist/esm/core/fetcher/ResponseWithBody.d.mts +4 -0
  124. package/dist/esm/core/fetcher/ResponseWithBody.mjs +3 -0
  125. package/dist/esm/core/fetcher/getRequestBody.d.mts +1 -1
  126. package/dist/esm/core/fetcher/getRequestBody.mjs +0 -4
  127. package/dist/esm/core/fetcher/getResponseBody.mjs +4 -18
  128. package/dist/esm/core/fetcher/makeRequest.d.mts +1 -1
  129. package/dist/esm/core/fetcher/makeRequest.mjs +2 -0
  130. package/dist/esm/core/fetcher/requestWithRetries.mjs +9 -0
  131. package/dist/esm/core/fetcher/signals.d.mts +7 -1
  132. package/dist/esm/core/fetcher/signals.mjs +12 -0
  133. package/dist/esm/core/headers.d.mts +2 -2
  134. package/dist/esm/core/headers.mjs +4 -6
  135. package/dist/esm/core/index.d.mts +0 -1
  136. package/dist/esm/core/index.mjs +0 -1
  137. package/dist/esm/core/runtime/runtime.mjs +10 -11
  138. package/dist/esm/core/url/join.mjs +1 -0
  139. package/dist/esm/errors/PaidError.mjs +1 -5
  140. package/dist/esm/errors/PaidTimeoutError.mjs +1 -5
  141. package/dist/esm/index.d.mts +0 -1
  142. package/dist/esm/index.mjs +0 -1
  143. package/dist/esm/integrations/adapters/expressjs/index.d.mts +2 -2
  144. package/dist/esm/integrations/adapters/expressjs/index.mjs +2 -2
  145. package/dist/esm/integrations/adapters/expressjs/routes.d.mts +16 -0
  146. package/dist/esm/integrations/adapters/expressjs/routes.mjs +27 -0
  147. package/dist/esm/integrations/adapters/nextjs/index.d.mts +1 -1
  148. package/dist/esm/integrations/adapters/nextjs/index.mjs +1 -1
  149. package/dist/esm/integrations/adapters/nextjs/routes.d.mts +15 -0
  150. package/dist/esm/integrations/adapters/nextjs/routes.mjs +20 -0
  151. package/dist/esm/integrations/controllers/index.d.mts +1 -0
  152. package/dist/esm/integrations/controllers/index.mjs +1 -0
  153. package/dist/esm/integrations/controllers/orders.mjs +52 -17
  154. package/dist/esm/integrations/controllers/plans.d.mts +50 -0
  155. package/dist/esm/integrations/controllers/plans.mjs +84 -0
  156. package/dist/esm/integrations/types.d.mts +5 -2
  157. package/dist/esm/version.d.mts +1 -1
  158. package/dist/esm/version.mjs +1 -1
  159. package/package.json +38 -7
  160. package/reference.md +106 -57
  161. package/dist/cjs/auth/BearerAuthProvider.d.ts +0 -20
  162. package/dist/cjs/auth/BearerAuthProvider.js +0 -79
  163. package/dist/cjs/auth/index.d.ts +0 -1
  164. package/dist/cjs/auth/index.js +0 -5
  165. package/dist/cjs/core/auth/NoOpAuthProvider.d.ts +0 -5
  166. package/dist/cjs/core/auth/NoOpAuthProvider.js +0 -9
  167. package/dist/cjs/core/exports.d.ts +0 -1
  168. package/dist/cjs/core/exports.js +0 -17
  169. package/dist/cjs/core/logging/exports.d.ts +0 -18
  170. package/dist/cjs/core/logging/exports.js +0 -45
  171. package/dist/cjs/core/logging/index.d.ts +0 -1
  172. package/dist/cjs/core/logging/index.js +0 -17
  173. package/dist/cjs/core/logging/logger.d.ts +0 -126
  174. package/dist/cjs/core/logging/logger.js +0 -144
  175. package/dist/cjs/errors/handleNonStatusCodeError.d.ts +0 -2
  176. package/dist/cjs/errors/handleNonStatusCodeError.js +0 -65
  177. package/dist/cjs/exports.d.ts +0 -1
  178. package/dist/cjs/exports.js +0 -17
  179. package/dist/esm/auth/BearerAuthProvider.d.mts +0 -20
  180. package/dist/esm/auth/BearerAuthProvider.mjs +0 -42
  181. package/dist/esm/auth/index.d.mts +0 -1
  182. package/dist/esm/auth/index.mjs +0 -1
  183. package/dist/esm/core/auth/NoOpAuthProvider.d.mts +0 -5
  184. package/dist/esm/core/auth/NoOpAuthProvider.mjs +0 -5
  185. package/dist/esm/core/exports.d.mts +0 -1
  186. package/dist/esm/core/exports.mjs +0 -1
  187. package/dist/esm/core/logging/exports.d.mts +0 -18
  188. package/dist/esm/core/logging/exports.mjs +0 -9
  189. package/dist/esm/core/logging/index.d.mts +0 -1
  190. package/dist/esm/core/logging/index.mjs +0 -1
  191. package/dist/esm/core/logging/logger.d.mts +0 -126
  192. package/dist/esm/core/logging/logger.mjs +0 -138
  193. package/dist/esm/errors/handleNonStatusCodeError.d.mts +0 -2
  194. package/dist/esm/errors/handleNonStatusCodeError.mjs +0 -29
  195. package/dist/esm/exports.d.mts +0 -1
  196. package/dist/esm/exports.mjs +0 -1
@@ -1,31 +1,31 @@
1
1
  import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
2
- import { type NormalizedClientOptions } from "../../../../BaseClient.js";
3
2
  import * as core from "../../../../core/index.js";
4
3
  import * as Paid from "../../../index.js";
5
- export declare namespace UsageClient {
6
- type Options = BaseClientOptions;
4
+ export declare namespace Usage {
5
+ interface Options extends BaseClientOptions {
6
+ }
7
7
  interface RequestOptions extends BaseRequestOptions {
8
8
  }
9
9
  }
10
- export declare class UsageClient {
11
- protected readonly _options: NormalizedClientOptions<UsageClient.Options>;
12
- constructor(options?: UsageClient.Options);
10
+ export declare class Usage {
11
+ protected readonly _options: Usage.Options;
12
+ constructor(_options?: Usage.Options);
13
13
  /**
14
14
  * DEPRECATED: Use POST /usage/v2/signals/bulk instead for cleaner field names.
15
15
  *
16
16
  * @param {Paid.UsageRecordBulkRequest} request
17
- * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
17
+ * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
18
18
  *
19
19
  * @example
20
20
  * await client.usage.recordBulk({
21
21
  * signals: [{}, {}, {}]
22
22
  * })
23
23
  */
24
- recordBulk(request?: Paid.UsageRecordBulkRequest, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<void>;
24
+ recordBulk(request?: Paid.UsageRecordBulkRequest, requestOptions?: Usage.RequestOptions): core.HttpResponsePromise<void>;
25
25
  private __recordBulk;
26
26
  /**
27
27
  * @param {Paid.UsageRecordBulkV2Request} request
28
- * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
28
+ * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
29
29
  *
30
30
  * @throws {@link Paid.BadRequestError}
31
31
  *
@@ -33,15 +33,15 @@ export declare class UsageClient {
33
33
  * await client.usage.usageRecordBulkV2({
34
34
  * signals: [{
35
35
  * event_name: "emails_sent",
36
- * product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
37
- * customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d"
36
+ * product_id: "prod_abc123def",
37
+ * customer_id: "cus_xyz789ghi"
38
38
  * }, {
39
39
  * event_name: "emails_sent",
40
40
  * external_product_id: "acme-product",
41
41
  * external_customer_id: "acme-inc"
42
42
  * }, {
43
43
  * event_name: "meeting_booked",
44
- * product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
44
+ * product_id: "prod_abc123def",
45
45
  * external_customer_id: "acme-inc",
46
46
  * data: {
47
47
  * "meeting_duration": 30,
@@ -50,11 +50,11 @@ export declare class UsageClient {
50
50
  * }]
51
51
  * })
52
52
  */
53
- usageRecordBulkV2(request?: Paid.UsageRecordBulkV2Request, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<void>;
53
+ usageRecordBulkV2(request?: Paid.UsageRecordBulkV2Request, requestOptions?: Usage.RequestOptions): core.HttpResponsePromise<void>;
54
54
  private __usageRecordBulkV2;
55
55
  /**
56
56
  * @param {Paid.UsageCheckUsageRequest} request
57
- * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
57
+ * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
58
58
  *
59
59
  * @throws {@link Paid.BadRequestError}
60
60
  * @throws {@link Paid.NotFoundError}
@@ -66,6 +66,7 @@ export declare class UsageClient {
66
66
  * externalProductId: "acme-agent"
67
67
  * })
68
68
  */
69
- checkUsage(request: Paid.UsageCheckUsageRequest, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<Paid.UsageCheckUsageResponse>;
69
+ checkUsage(request: Paid.UsageCheckUsageRequest, requestOptions?: Usage.RequestOptions): core.HttpResponsePromise<Paid.UsageCheckUsageResponse>;
70
70
  private __checkUsage;
71
+ protected _getAuthorizationHeader(): Promise<string | undefined>;
71
72
  }
@@ -43,23 +43,21 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
43
43
  });
44
44
  };
45
45
  Object.defineProperty(exports, "__esModule", { value: true });
46
- exports.UsageClient = void 0;
47
- const BaseClient_js_1 = require("../../../../BaseClient.js");
46
+ exports.Usage = void 0;
48
47
  const headers_js_1 = require("../../../../core/headers.js");
49
48
  const core = __importStar(require("../../../../core/index.js"));
50
49
  const environments = __importStar(require("../../../../environments.js"));
51
- const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
52
50
  const errors = __importStar(require("../../../../errors/index.js"));
53
51
  const Paid = __importStar(require("../../../index.js"));
54
- class UsageClient {
55
- constructor(options = {}) {
56
- this._options = (0, BaseClient_js_1.normalizeClientOptions)(options);
52
+ class Usage {
53
+ constructor(_options = {}) {
54
+ this._options = _options;
57
55
  }
58
56
  /**
59
57
  * DEPRECATED: Use POST /usage/v2/signals/bulk instead for cleaner field names.
60
58
  *
61
59
  * @param {Paid.UsageRecordBulkRequest} request
62
- * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
60
+ * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
63
61
  *
64
62
  * @example
65
63
  * await client.usage.recordBulk({
@@ -71,8 +69,8 @@ class UsageClient {
71
69
  }
72
70
  __recordBulk() {
73
71
  return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
74
- var _a, _b, _c, _d, _e, _f, _g, _h, _j;
75
- const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
72
+ var _a, _b, _c, _d, _e, _f, _g, _h;
73
+ const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
76
74
  const _response = yield core.fetcher({
77
75
  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.PaidEnvironment.Production, "usage/signals/bulk"),
78
76
  method: "POST",
@@ -84,8 +82,6 @@ class UsageClient {
84
82
  timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
85
83
  maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
86
84
  abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
87
- fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
88
- logging: this._options.logging,
89
85
  });
90
86
  if (_response.ok) {
91
87
  return { data: undefined, rawResponse: _response.rawResponse };
@@ -97,12 +93,26 @@ class UsageClient {
97
93
  rawResponse: _response.rawResponse,
98
94
  });
99
95
  }
100
- return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/usage/signals/bulk");
96
+ switch (_response.error.reason) {
97
+ case "non-json":
98
+ throw new errors.PaidError({
99
+ statusCode: _response.error.statusCode,
100
+ body: _response.error.rawBody,
101
+ rawResponse: _response.rawResponse,
102
+ });
103
+ case "timeout":
104
+ throw new errors.PaidTimeoutError("Timeout exceeded when calling POST /usage/signals/bulk.");
105
+ case "unknown":
106
+ throw new errors.PaidError({
107
+ message: _response.error.errorMessage,
108
+ rawResponse: _response.rawResponse,
109
+ });
110
+ }
101
111
  });
102
112
  }
103
113
  /**
104
114
  * @param {Paid.UsageRecordBulkV2Request} request
105
- * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
115
+ * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
106
116
  *
107
117
  * @throws {@link Paid.BadRequestError}
108
118
  *
@@ -110,15 +120,15 @@ class UsageClient {
110
120
  * await client.usage.usageRecordBulkV2({
111
121
  * signals: [{
112
122
  * event_name: "emails_sent",
113
- * product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
114
- * customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d"
123
+ * product_id: "prod_abc123def",
124
+ * customer_id: "cus_xyz789ghi"
115
125
  * }, {
116
126
  * event_name: "emails_sent",
117
127
  * external_product_id: "acme-product",
118
128
  * external_customer_id: "acme-inc"
119
129
  * }, {
120
130
  * event_name: "meeting_booked",
121
- * product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
131
+ * product_id: "prod_abc123def",
122
132
  * external_customer_id: "acme-inc",
123
133
  * data: {
124
134
  * "meeting_duration": 30,
@@ -132,8 +142,8 @@ class UsageClient {
132
142
  }
133
143
  __usageRecordBulkV2() {
134
144
  return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
135
- var _a, _b, _c, _d, _e, _f, _g, _h, _j;
136
- const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
145
+ var _a, _b, _c, _d, _e, _f, _g, _h;
146
+ const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
137
147
  const _response = yield core.fetcher({
138
148
  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.PaidEnvironment.Production, "usage/v2/signals/bulk"),
139
149
  method: "POST",
@@ -145,8 +155,6 @@ class UsageClient {
145
155
  timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
146
156
  maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
147
157
  abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
148
- fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
149
- logging: this._options.logging,
150
158
  });
151
159
  if (_response.ok) {
152
160
  return { data: undefined, rawResponse: _response.rawResponse };
@@ -163,12 +171,26 @@ class UsageClient {
163
171
  });
164
172
  }
165
173
  }
166
- return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/usage/v2/signals/bulk");
174
+ switch (_response.error.reason) {
175
+ case "non-json":
176
+ throw new errors.PaidError({
177
+ statusCode: _response.error.statusCode,
178
+ body: _response.error.rawBody,
179
+ rawResponse: _response.rawResponse,
180
+ });
181
+ case "timeout":
182
+ throw new errors.PaidTimeoutError("Timeout exceeded when calling POST /usage/v2/signals/bulk.");
183
+ case "unknown":
184
+ throw new errors.PaidError({
185
+ message: _response.error.errorMessage,
186
+ rawResponse: _response.rawResponse,
187
+ });
188
+ }
167
189
  });
168
190
  }
169
191
  /**
170
192
  * @param {Paid.UsageCheckUsageRequest} request
171
- * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
193
+ * @param {Usage.RequestOptions} requestOptions - Request-specific configuration.
172
194
  *
173
195
  * @throws {@link Paid.BadRequestError}
174
196
  * @throws {@link Paid.NotFoundError}
@@ -185,8 +207,8 @@ class UsageClient {
185
207
  }
186
208
  __checkUsage(request, requestOptions) {
187
209
  return __awaiter(this, void 0, void 0, function* () {
188
- var _a, _b, _c, _d, _e, _f, _g, _h, _j;
189
- const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
210
+ var _a, _b, _c, _d, _e, _f, _g, _h;
211
+ const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
190
212
  const _response = yield core.fetcher({
191
213
  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.PaidEnvironment.Production, "usage/check-usage"),
192
214
  method: "POST",
@@ -198,8 +220,6 @@ class UsageClient {
198
220
  timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
199
221
  maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
200
222
  abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
201
- fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
202
- logging: this._options.logging,
203
223
  });
204
224
  if (_response.ok) {
205
225
  return { data: _response.body, rawResponse: _response.rawResponse };
@@ -220,8 +240,31 @@ class UsageClient {
220
240
  });
221
241
  }
222
242
  }
223
- return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/usage/check-usage");
243
+ switch (_response.error.reason) {
244
+ case "non-json":
245
+ throw new errors.PaidError({
246
+ statusCode: _response.error.statusCode,
247
+ body: _response.error.rawBody,
248
+ rawResponse: _response.rawResponse,
249
+ });
250
+ case "timeout":
251
+ throw new errors.PaidTimeoutError("Timeout exceeded when calling POST /usage/check-usage.");
252
+ case "unknown":
253
+ throw new errors.PaidError({
254
+ message: _response.error.errorMessage,
255
+ rawResponse: _response.rawResponse,
256
+ });
257
+ }
258
+ });
259
+ }
260
+ _getAuthorizationHeader() {
261
+ return __awaiter(this, void 0, void 0, function* () {
262
+ const bearer = yield core.Supplier.get(this._options.token);
263
+ if (bearer != null) {
264
+ return `Bearer ${bearer}`;
265
+ }
266
+ return undefined;
224
267
  });
225
268
  }
226
269
  }
227
- exports.UsageClient = UsageClient;
270
+ exports.Usage = Usage;
@@ -4,15 +4,15 @@ import type * as Paid from "../../../../index.js";
4
4
  * {
5
5
  * signals: [{
6
6
  * event_name: "emails_sent",
7
- * product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
8
- * customer_id: "7d0b6fce-d82a-433d-8315-c994f8f1d68d"
7
+ * product_id: "prod_abc123def",
8
+ * customer_id: "cus_xyz789ghi"
9
9
  * }, {
10
10
  * event_name: "emails_sent",
11
11
  * external_product_id: "acme-product",
12
12
  * external_customer_id: "acme-inc"
13
13
  * }, {
14
14
  * event_name: "meeting_booked",
15
- * product_id: "63fd642c-569d-44f9-8d67-5cf4944a16cc",
15
+ * product_id: "prod_abc123def",
16
16
  * external_customer_id: "acme-inc",
17
17
  * data: {
18
18
  * "meeting_duration": 30,
@@ -0,0 +1,34 @@
1
+ /**
2
+ * A plan with its features (product-attribute pairs) for display
3
+ */
4
+ export interface PlanWithFeatures {
5
+ /** The unique identifier of the plan */
6
+ id: string;
7
+ /** The name of the plan */
8
+ name: string;
9
+ /** The description of the plan */
10
+ description?: string;
11
+ /** When the plan was created */
12
+ createdAt: string;
13
+ /** When the plan was last updated */
14
+ updatedAt: string;
15
+ /** The ID of the next plan in the sequence */
16
+ nextPlanId?: string;
17
+ /** The ID of the previous plan in the sequence */
18
+ prevPlanId?: string;
19
+ /** The features (product-attribute pairs) included in this plan */
20
+ features: PlanWithFeatures.Features.Item[];
21
+ }
22
+ export declare namespace PlanWithFeatures {
23
+ type Features = Features.Item[];
24
+ namespace Features {
25
+ interface Item {
26
+ /** The name of the product */
27
+ productName: string;
28
+ /** The name of the product attribute */
29
+ attributeName: string;
30
+ /** The pricing configuration for this feature */
31
+ pricing: Record<string, unknown>;
32
+ }
33
+ }
34
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,16 +1,16 @@
1
1
  /**
2
- * V2 signal schema with clean field names. Use either internal IDs (product_id, customer_id) or external IDs (external_product_id, external_customer_id).
2
+ * V2 signal schema with clean field names. IMPORTANT: Exactly one customer ID field (customer_id OR external_customer_id) and exactly one product ID field (product_id OR external_product_id) must be provided per signal.
3
3
  */
4
4
  export interface SignalV2 {
5
5
  /** The name of the event being tracked */
6
6
  event_name: string;
7
- /** Paid's internal product ID. Use either this OR external_product_id. */
7
+ /** Paid's display ID for the product (e.g., prod_abc123). Cannot be used with external_product_id. Either this or external_product_id is required. */
8
8
  product_id?: string;
9
- /** Your system's product ID. Use either this OR product_id. */
9
+ /** Your system's product ID. Cannot be used with product_id. Either this or product_id is required. */
10
10
  external_product_id?: string;
11
- /** Paid's internal customer ID. Use either this OR external_customer_id. */
11
+ /** Paid's display ID for the customer (e.g., cus_xyz789). Cannot be used with external_customer_id. Either this or external_customer_id is required. */
12
12
  customer_id?: string;
13
- /** Your system's customer ID. Use either this OR customer_id. */
13
+ /** Your system's customer ID. Cannot be used with customer_id. Either this or customer_id is required. */
14
14
  external_customer_id?: string;
15
15
  /** Optional additional data/metadata for the signal */
16
16
  data?: Record<string, unknown>;
@@ -30,6 +30,7 @@ export * from "./PaginationMeta.js";
30
30
  export * from "./PaymentMethod.js";
31
31
  export * from "./Plan.js";
32
32
  export * from "./PlanGroup.js";
33
+ export * from "./PlanWithFeatures.js";
33
34
  export * from "./PricePoint.js";
34
35
  export * from "./Pricing.js";
35
36
  export * from "./PricingModelType.js";
@@ -46,6 +46,7 @@ __exportStar(require("./PaginationMeta.js"), exports);
46
46
  __exportStar(require("./PaymentMethod.js"), exports);
47
47
  __exportStar(require("./Plan.js"), exports);
48
48
  __exportStar(require("./PlanGroup.js"), exports);
49
+ __exportStar(require("./PlanWithFeatures.js"), exports);
49
50
  __exportStar(require("./PricePoint.js"), exports);
50
51
  __exportStar(require("./Pricing.js"), exports);
51
52
  __exportStar(require("./PricingModelType.js"), exports);
@@ -1,7 +1,4 @@
1
- import type { EndpointMetadata } from "../fetcher/EndpointMetadata.js";
2
1
  import type { AuthRequest } from "./AuthRequest.js";
3
2
  export interface AuthProvider {
4
- getAuthRequest(arg?: {
5
- endpointMetadata?: EndpointMetadata;
6
- }): Promise<AuthRequest>;
3
+ getAuthRequest(): Promise<AuthRequest>;
7
4
  }
@@ -1,7 +1,5 @@
1
1
  export type BearerToken = string;
2
- declare function toAuthorizationHeader(token: string | undefined): string | undefined;
3
2
  export declare const BearerToken: {
4
- toAuthorizationHeader: typeof toAuthorizationHeader;
3
+ toAuthorizationHeader: (token: BearerToken | undefined) => string | undefined;
5
4
  fromAuthorizationHeader: (header: string) => BearerToken;
6
5
  };
7
- export {};
@@ -2,14 +2,13 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.BearerToken = void 0;
4
4
  const BEARER_AUTH_HEADER_PREFIX = /^Bearer /i;
5
- function toAuthorizationHeader(token) {
6
- if (token == null) {
7
- return undefined;
8
- }
9
- return `Bearer ${token}`;
10
- }
11
5
  exports.BearerToken = {
12
- toAuthorizationHeader: toAuthorizationHeader,
6
+ toAuthorizationHeader: (token) => {
7
+ if (token == null) {
8
+ return undefined;
9
+ }
10
+ return `Bearer ${token}`;
11
+ },
13
12
  fromAuthorizationHeader: (header) => {
14
13
  return header.replace(BEARER_AUTH_HEADER_PREFIX, "").trim();
15
14
  },
@@ -2,4 +2,3 @@ export type { AuthProvider } from "./AuthProvider.js";
2
2
  export type { AuthRequest } from "./AuthRequest.js";
3
3
  export { BasicAuth } from "./BasicAuth.js";
4
4
  export { BearerToken } from "./BearerToken.js";
5
- export { NoOpAuthProvider } from "./NoOpAuthProvider.js";
@@ -1,9 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.NoOpAuthProvider = exports.BearerToken = exports.BasicAuth = void 0;
3
+ exports.BearerToken = exports.BasicAuth = void 0;
4
4
  var BasicAuth_js_1 = require("./BasicAuth.js");
5
5
  Object.defineProperty(exports, "BasicAuth", { enumerable: true, get: function () { return BasicAuth_js_1.BasicAuth; } });
6
6
  var BearerToken_js_1 = require("./BearerToken.js");
7
7
  Object.defineProperty(exports, "BearerToken", { enumerable: true, get: function () { return BearerToken_js_1.BearerToken; } });
8
- var NoOpAuthProvider_js_1 = require("./NoOpAuthProvider.js");
9
- Object.defineProperty(exports, "NoOpAuthProvider", { enumerable: true, get: function () { return NoOpAuthProvider_js_1.NoOpAuthProvider; } });
@@ -1,19 +1,20 @@
1
+ import type { ResponseWithBody } from "./ResponseWithBody.js";
1
2
  export type BinaryResponse = {
2
3
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */
3
- bodyUsed: Response["bodyUsed"];
4
+ bodyUsed: boolean;
4
5
  /**
5
6
  * Returns a ReadableStream of the response body.
6
7
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body)
7
8
  */
8
- stream: () => Response["body"];
9
+ stream: () => ReadableStream<Uint8Array>;
9
10
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */
10
- arrayBuffer: () => ReturnType<Response["arrayBuffer"]>;
11
+ arrayBuffer: () => Promise<ArrayBuffer>;
11
12
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */
12
- blob: () => ReturnType<Response["blob"]>;
13
+ blob: () => Promise<Blob>;
13
14
  /**
14
15
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes)
15
16
  * Some versions of the Fetch API may not support this method.
16
17
  */
17
- bytes?(): ReturnType<Response["bytes"]>;
18
+ bytes?(): Promise<Uint8Array>;
18
19
  };
19
- export declare function getBinaryResponse(response: Response): BinaryResponse;
20
+ export declare function getBinaryResponse(response: ResponseWithBody): BinaryResponse;
@@ -1,12 +1,12 @@
1
1
  import type { EndpointMetadata } from "./EndpointMetadata.js";
2
2
  import type { Supplier } from "./Supplier.js";
3
3
  type EndpointSupplierFn<T> = (arg: {
4
- endpointMetadata?: EndpointMetadata;
4
+ endpointMetadata: EndpointMetadata;
5
5
  }) => T | Promise<T>;
6
6
  export type EndpointSupplier<T> = Supplier<T> | EndpointSupplierFn<T>;
7
7
  export declare const EndpointSupplier: {
8
8
  get: <T>(supplier: EndpointSupplier<T>, arg: {
9
- endpointMetadata?: EndpointMetadata;
9
+ endpointMetadata: EndpointMetadata;
10
10
  }) => Promise<T>;
11
11
  };
12
12
  export {};
@@ -1,27 +1,25 @@
1
- import { type LogConfig, type Logger } from "../logging/logger.js";
2
1
  import type { APIResponse } from "./APIResponse.js";
3
2
  import type { EndpointMetadata } from "./EndpointMetadata.js";
3
+ import { EndpointSupplier } from "./EndpointSupplier.js";
4
4
  export type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
5
5
  export declare namespace Fetcher {
6
6
  interface Args {
7
7
  url: string;
8
8
  method: string;
9
9
  contentType?: string;
10
- headers?: Record<string, unknown>;
10
+ headers?: Record<string, string | EndpointSupplier<string | null | undefined> | null | undefined>;
11
11
  queryParameters?: Record<string, unknown>;
12
12
  body?: unknown;
13
13
  timeoutMs?: number;
14
14
  maxRetries?: number;
15
15
  withCredentials?: boolean;
16
16
  abortSignal?: AbortSignal;
17
- requestType?: "json" | "file" | "bytes" | "form" | "other";
17
+ requestType?: "json" | "file" | "bytes";
18
18
  responseType?: "json" | "blob" | "sse" | "streaming" | "text" | "arrayBuffer" | "binary-response";
19
19
  duplex?: "half";
20
20
  endpointMetadata?: EndpointMetadata;
21
- fetchFn?: typeof fetch;
22
- logging?: LogConfig | Logger;
23
21
  }
24
- type Error = FailedStatusCodeError | NonJsonError | BodyIsNullError | TimeoutError | UnknownError;
22
+ type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;
25
23
  interface FailedStatusCodeError {
26
24
  reason: "status-code";
27
25
  statusCode: number;
@@ -32,10 +30,6 @@ export declare namespace Fetcher {
32
30
  statusCode: number;
33
31
  rawBody: string;
34
32
  }
35
- interface BodyIsNullError {
36
- reason: "body-is-null";
37
- statusCode: number;
38
- }
39
33
  interface TimeoutError {
40
34
  reason: "timeout";
41
35
  }