@hedra/sdk 1.0.0

package/dist/esm/api/resources/logDrains/client/Client.d.mts

@@ -0,0 +1,149 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Hedra from "../../../index.mjs";
+export declare namespace LogDrainsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Stream signed job lifecycle logs to HTTPS destinations.
+ *
+ * **Why the last batch failed.** `last_error` is the same error envelope a failed job returns from `GET /jobs/{job_id}`, not a free-text diagnostic. It is null until a batch fails and is cleared again on the next success. Its `code` comes from the one error vocabulary this API uses, narrowed for drain delivery to this set:
+ *
+ * | `code` | Means |
+ * | --- | --- |
+ * | `DEADLINE_EXCEEDED` | Your destination did not respond before the delivery timeout. |
+ * | `UNAVAILABLE` | Your destination could not be reached (DNS, TLS, or connection failure) or answered `5xx` — or redirected, which is never followed. |
+ * | `RESOURCE_EXHAUSTED` | Your destination answered `429`. |
+ * | `UNAUTHORIZED` | Your destination answered `401`. |
+ * | `PERMISSION_DENIED` | Your destination answered `403`. |
+ * | `NOT_FOUND` | Your destination answered `404`. |
+ * | `INVALID_ARGUMENT` | Your destination answered some other `4xx`. |
+ * | `FAILED_PRECONDITION` | The URL is not a permitted log drain target — it resolves to a blocked address range. Fix the URL; retrying will not help. |
+ * | `INTERNAL` | Hedra could not prepare the batch. |
+ * | `UNKNOWN` | No classification is available, including for drains that last failed before this field became structured. |
+ *
+ * `retryable` describes the condition, not what Hedra did: every failed batch is requeued until the drain auto-disables, so it answers whether fixing the destination and re-enabling is likely to help. The `message` is a fixed summary — your destination's URL, headers, credentials, and response body are never echoed back, so treat your own logs, not this field, as the record of what your destination returned.
+ *
+ * `disabled_reason` answers a different question and stays its own small vocabulary: `consecutive_failures` when five batches in a row failed, `disabled_by_user` when you turned the drain off.
+ */
+export declare class LogDrainsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<LogDrainsClient.Options>;
+    constructor(options?: LogDrainsClient.Options);
+    /**
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.listLogDrains()
+     */
+    listLogDrains(requestOptions?: LogDrainsClient.RequestOptions): core.HttpResponsePromise<Hedra.LogDrainListResponse>;
+    private __listLogDrains;
+    /**
+     * @param {Hedra.LogDrainCreate} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.createLogDrain({
+     *         name: "name",
+     *         url: "url"
+     *     })
+     */
+    createLogDrain(request: Hedra.LogDrainCreate, requestOptions?: LogDrainsClient.RequestOptions): core.HttpResponsePromise<Hedra.LogDrainConfig>;
+    private __createLogDrain;
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainsGetLogDrainRequest} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.getLogDrain("drain_id")
+     */
+    getLogDrain(drain_id: string, request?: Hedra.LogDrainsGetLogDrainRequest, requestOptions?: LogDrainsClient.RequestOptions): core.HttpResponsePromise<Hedra.LogDrainConfig>;
+    private __getLogDrain;
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainsDeleteLogDrainRequest} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.deleteLogDrain("drain_id")
+     */
+    deleteLogDrain(drain_id: string, request?: Hedra.LogDrainsDeleteLogDrainRequest, requestOptions?: LogDrainsClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __deleteLogDrain;
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainUpdate} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.updateLogDrain("drain_id")
+     */
+    updateLogDrain(drain_id: string, request?: Hedra.LogDrainUpdate, requestOptions?: LogDrainsClient.RequestOptions): core.HttpResponsePromise<Hedra.LogDrainConfig>;
+    private __updateLogDrain;
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainsTestLogDrainRequest} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.testLogDrain("drain_id")
+     */
+    testLogDrain(drain_id: string, request?: Hedra.LogDrainsTestLogDrainRequest, requestOptions?: LogDrainsClient.RequestOptions): core.HttpResponsePromise<Hedra.LogDrainTestResponse>;
+    private __testLogDrain;
+}

package/dist/esm/api/resources/logDrains/client/Client.mjs

@@ -0,0 +1,435 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import { mergeAdditionalBodyParameters } from "../../../../core/requestBody.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as Hedra from "../../../index.mjs";
+/**
+ * Stream signed job lifecycle logs to HTTPS destinations.
+ *
+ * **Why the last batch failed.** `last_error` is the same error envelope a failed job returns from `GET /jobs/{job_id}`, not a free-text diagnostic. It is null until a batch fails and is cleared again on the next success. Its `code` comes from the one error vocabulary this API uses, narrowed for drain delivery to this set:
+ *
+ * | `code` | Means |
+ * | --- | --- |
+ * | `DEADLINE_EXCEEDED` | Your destination did not respond before the delivery timeout. |
+ * | `UNAVAILABLE` | Your destination could not be reached (DNS, TLS, or connection failure) or answered `5xx` — or redirected, which is never followed. |
+ * | `RESOURCE_EXHAUSTED` | Your destination answered `429`. |
+ * | `UNAUTHORIZED` | Your destination answered `401`. |
+ * | `PERMISSION_DENIED` | Your destination answered `403`. |
+ * | `NOT_FOUND` | Your destination answered `404`. |
+ * | `INVALID_ARGUMENT` | Your destination answered some other `4xx`. |
+ * | `FAILED_PRECONDITION` | The URL is not a permitted log drain target — it resolves to a blocked address range. Fix the URL; retrying will not help. |
+ * | `INTERNAL` | Hedra could not prepare the batch. |
+ * | `UNKNOWN` | No classification is available, including for drains that last failed before this field became structured. |
+ *
+ * `retryable` describes the condition, not what Hedra did: every failed batch is requeued until the drain auto-disables, so it answers whether fixing the destination and re-enabling is likely to help. The `message` is a fixed summary — your destination's URL, headers, credentials, and response body are never echoed back, so treat your own logs, not this field, as the record of what your destination returned.
+ *
+ * `disabled_reason` answers a different question and stays its own small vocabulary: `consecutive_failures` when five batches in a row failed, `disabled_by_user` when you turned the drain off.
+ */
+export class LogDrainsClient {
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.listLogDrains()
+     */
+    listLogDrains(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listLogDrains(requestOptions));
+    }
+    __listLogDrains(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Hedra-Spec-Version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.specVersion) !== null && _b !== void 0 ? _b : "3.2.2" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HedraEnvironment.Production, "log-drains"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Hedra.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Hedra.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Hedra.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Hedra.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Hedra.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Hedra.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.HedraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/log-drains");
+        });
+    }
+    /**
+     * @param {Hedra.LogDrainCreate} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.createLogDrain({
+     *         name: "name",
+     *         url: "url"
+     *     })
+     */
+    createLogDrain(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createLogDrain(request, requestOptions));
+    }
+    __createLogDrain(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Hedra-Spec-Version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.specVersion) !== null && _b !== void 0 ? _b : "3.2.2" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HedraEnvironment.Production, "log-drains"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(request, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Hedra.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Hedra.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Hedra.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Hedra.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Hedra.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Hedra.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.HedraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/log-drains");
+        });
+    }
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainsGetLogDrainRequest} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.getLogDrain("drain_id")
+     */
+    getLogDrain(drain_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getLogDrain(drain_id, request, requestOptions));
+    }
+    __getLogDrain(drain_id_1) {
+        return __awaiter(this, arguments, void 0, function* (drain_id, _request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Hedra-Spec-Version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.specVersion) !== null && _b !== void 0 ? _b : "3.2.2" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HedraEnvironment.Production, `log-drains/${core.url.encodePathParam(drain_id)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Hedra.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Hedra.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Hedra.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Hedra.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Hedra.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Hedra.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.HedraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/log-drains/{drain_id}");
+        });
+    }
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainsDeleteLogDrainRequest} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.deleteLogDrain("drain_id")
+     */
+    deleteLogDrain(drain_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteLogDrain(drain_id, request, requestOptions));
+    }
+    __deleteLogDrain(drain_id_1) {
+        return __awaiter(this, arguments, void 0, function* (drain_id, _request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Hedra-Spec-Version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.specVersion) !== null && _b !== void 0 ? _b : "3.2.2" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HedraEnvironment.Production, `log-drains/${core.url.encodePathParam(drain_id)}`),
+                method: "DELETE",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Hedra.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Hedra.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Hedra.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Hedra.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Hedra.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Hedra.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.HedraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/log-drains/{drain_id}");
+        });
+    }
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainUpdate} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.updateLogDrain("drain_id")
+     */
+    updateLogDrain(drain_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__updateLogDrain(drain_id, request, requestOptions));
+    }
+    __updateLogDrain(drain_id_1) {
+        return __awaiter(this, arguments, void 0, function* (drain_id, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Hedra-Spec-Version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.specVersion) !== null && _b !== void 0 ? _b : "3.2.2" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HedraEnvironment.Production, `log-drains/${core.url.encodePathParam(drain_id)}`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: mergeAdditionalBodyParameters(request, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Hedra.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Hedra.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Hedra.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Hedra.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Hedra.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Hedra.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.HedraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "PATCH", "/log-drains/{drain_id}");
+        });
+    }
+    /**
+     * @param {string} drain_id - The drain's id (`drain_<uuid>`).
+     * @param {Hedra.LogDrainsTestLogDrainRequest} request
+     * @param {LogDrainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Hedra.BadRequestError}
+     * @throws {@link Hedra.UnauthorizedError}
+     * @throws {@link Hedra.ForbiddenError}
+     * @throws {@link Hedra.NotFoundError}
+     * @throws {@link Hedra.TooManyRequestsError}
+     * @throws {@link Hedra.InternalServerError}
+     * @throws {@link errors.HedraError}
+     * @throws {@link errors.HedraTimeoutError}
+     *
+     * @example
+     *     await client.logDrains.testLogDrain("drain_id")
+     */
+    testLogDrain(drain_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__testLogDrain(drain_id, request, requestOptions));
+    }
+    __testLogDrain(drain_id_1) {
+        return __awaiter(this, arguments, void 0, function* (drain_id, _request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Hedra-Spec-Version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.specVersion) !== null && _b !== void 0 ? _b : "3.2.2" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.HedraEnvironment.Production, `log-drains/${core.url.encodePathParam(drain_id)}/test`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Hedra.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Hedra.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Hedra.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Hedra.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Hedra.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Hedra.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.HedraError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/log-drains/{drain_id}/test");
+        });
+    }
+}

package/dist/esm/api/resources/logDrains/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/logDrains/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/logDrains/client/requests/LogDrainCreate.d.mts

@@ -0,0 +1,23 @@
+import type * as Hedra from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         name: "name",
+ *         url: "url"
+ *     }
+ */
+export interface LogDrainCreate {
+    /** Human-readable label. */
+    name: string;
+    /** HTTPS endpoint job-log batches are posted to. */
+    url: string;
+    format?: Hedra.LogDrainFormat;
+    /** Signs every NDJSON post. Required when `format` is `ndjson` (the default); optional for `otlp` drains, whose receivers authenticate with `headers` instead. */
+    secret?: string | null;
+    /** Extra headers sent with every post — typically the receiver's authentication. Stored values are never echoed back; reads expose `header_names` only. */
+    headers?: Record<string, string | null> | null;
+    /** Whether the drain receives batches. */
+    enabled?: boolean;
+    /** Maximum log lines per post. */
+    batch_size?: number;
+}

package/dist/esm/api/resources/logDrains/client/requests/LogDrainCreate.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/logDrains/client/requests/LogDrainUpdate.d.mts

@@ -0,0 +1,21 @@
+import type * as Hedra from "../../../../index.mjs";
+/**
+ * @example
+ *     {}
+ */
+export interface LogDrainUpdate {
+    /** New label; omitted means unchanged. */
+    name?: string | null;
+    /** New destination; omitted means unchanged. */
+    url?: string | null;
+    /** New wire format; omitted means unchanged. */
+    format?: Hedra.LogDrainFormat | null;
+    /** Rotates the signing secret. No conditional applies here: the drain may already hold one. Switching `format` to `ndjson` on a drain with no stored secret requires supplying one in the same request. */
+    secret?: string | null;
+    /** Replaces the full header set; `{}` clears it. Omitted means unchanged. */
+    headers?: Record<string, string | null> | null;
+    /** Pause (false) or resume (true) the drain; omitted means unchanged. Re-enabling clears the auto-disable failure count. */
+    enabled?: boolean | null;
+    /** New maximum log lines per post; omitted means unchanged. */
+    batch_size?: number | null;
+}

package/dist/esm/api/resources/logDrains/client/requests/LogDrainUpdate.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/logDrains/client/requests/LogDrainsDeleteLogDrainRequest.d.mts

@@ -0,0 +1,5 @@
+/**
+ * @example
+ *     {}
+ */
+export type LogDrainsDeleteLogDrainRequest = {};