agentmail 0.0.46 → 0.0.49

package/dist/esm/api/resources/inboxes/resources/metrics/client/Client.mjs

@@ -0,0 +1,105 @@
+/**
+ * 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 * as environments from "../../../../../../environments.mjs";
+import * as core from "../../../../../../core/index.mjs";
+import * as AgentMail from "../../../../../index.mjs";
+import { toJson } from "../../../../../../core/json.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../../../core/headers.mjs";
+import * as errors from "../../../../../../errors/index.mjs";
+export class Metrics {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * @param {AgentMail.inboxes.InboxId} inboxId
+     * @param {AgentMail.inboxes.ListInboxMetricsRequest} request
+     * @param {Metrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.metrics.get("inbox_id", {
+     *         start_timestamp: "2024-01-15T09:30:00Z",
+     *         end_timestamp: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    get(inboxId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__get(inboxId, request, requestOptions));
+    }
+    __get(inboxId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const { event_types: eventTypes, start_timestamp: startTimestamp, end_timestamp: endTimestamp } = request;
+            const _queryParams = {};
+            if (eventTypes != null) {
+                _queryParams["event_types"] = toJson(eventTypes);
+            }
+            _queryParams["start_timestamp"] = startTimestamp;
+            _queryParams["end_timestamp"] = endTimestamp;
+            const _response = yield core.fetcher({
+                url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Production).http, `/v0/inboxes/${encodeURIComponent(inboxId)}/metrics`),
+                method: "GET",
+                headers: mergeHeaders((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                queryParameters: _queryParams,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AgentMail.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 400:
+                        throw new AgentMail.ValidationError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AgentMailError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AgentMailTimeoutError("Timeout exceeded when calling GET /v0/inboxes/{inbox_id}/metrics.");
+                case "unknown":
+                    throw new errors.AgentMailError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const bearer = (_a = (yield core.Supplier.get(this._options.apiKey))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["AGENTMAIL_API_KEY"];
+            if (bearer == null) {
+                throw new errors.AgentMailError({
+                    message: "Please specify a bearer by either passing it in to the constructor or initializing a AGENTMAIL_API_KEY environment variable",
+                });
+            }
+            return `Bearer ${bearer}`;
+        });
+    }
+}

package/dist/esm/api/resources/inboxes/resources/metrics/client/index.d.mts

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

package/dist/esm/api/resources/inboxes/resources/metrics/client/index.mjs

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

package/dist/esm/api/resources/inboxes/resources/metrics/client/requests/ListInboxMetricsRequest.d.mts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         start_timestamp: "2024-01-15T09:30:00Z",
+ *         end_timestamp: "2024-01-15T09:30:00Z"
+ *     }
+ */
+export interface ListInboxMetricsRequest {
+    event_types?: AgentMail.MetricEventTypes;
+    start_timestamp: AgentMail.MetricStartTimestamp;
+    end_timestamp: AgentMail.MetricEndTimestamp;
+}

package/dist/esm/api/resources/inboxes/resources/metrics/client/requests/ListInboxMetricsRequest.mjs

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

package/dist/esm/api/resources/inboxes/resources/metrics/client/requests/index.d.mts

@@ -0,0 +1 @@
+export { type ListInboxMetricsRequest } from "./ListInboxMetricsRequest.mjs";

package/dist/esm/api/resources/inboxes/resources/metrics/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/inboxes/resources/metrics/index.d.mts

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

package/dist/esm/api/resources/inboxes/resources/metrics/index.mjs

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

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

@@ -8,6 +8,8 @@ export * as drafts from "./drafts/index.mjs";
 export * from "./drafts/types/index.mjs";
 export * as messages from "./messages/index.mjs";
 export * from "./messages/types/index.mjs";
+export * as metrics from "./metrics/index.mjs";
+export * from "./metrics/types/index.mjs";
 export * as threads from "./threads/index.mjs";
 export * from "./threads/types/index.mjs";
 export * as websockets from "./websockets/index.mjs";
@@ -15,4 +17,5 @@ export * from "./websockets/types/index.mjs";
 export * from "./messages/errors/index.mjs";
 export * from "./domains/client/requests/index.mjs";
 export * from "./drafts/client/requests/index.mjs";
+export * from "./metrics/client/requests/index.mjs";
 export * from "./threads/client/requests/index.mjs";

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

@@ -8,6 +8,8 @@ export * as drafts from "./drafts/index.mjs";
 export * from "./drafts/types/index.mjs";
 export * as messages from "./messages/index.mjs";
 export * from "./messages/types/index.mjs";
+export * as metrics from "./metrics/index.mjs";
+export * from "./metrics/types/index.mjs";
 export * as threads from "./threads/index.mjs";
 export * from "./threads/types/index.mjs";
 export * as websockets from "./websockets/index.mjs";
@@ -15,4 +17,5 @@ export * from "./websockets/types/index.mjs";
 export * from "./messages/errors/index.mjs";
 export * from "./domains/client/requests/index.mjs";
 export * from "./drafts/client/requests/index.mjs";
+export * from "./metrics/client/requests/index.mjs";
 export * from "./threads/client/requests/index.mjs";

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

@@ -0,0 +1,45 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as AgentMail from "../../../index.mjs";
+export declare namespace Metrics {
+    interface Options {
+        environment?: core.Supplier<environments.AgentMailEnvironment | environments.AgentMailEnvironmentUrls>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey?: core.Supplier<core.BearerToken | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class Metrics {
+    protected readonly _options: Metrics.Options;
+    constructor(_options?: Metrics.Options);
+    /**
+     * @param {AgentMail.ListMetricsRequest} request
+     * @param {Metrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.metrics.list({
+     *         start_timestamp: "2024-01-15T09:30:00Z",
+     *         end_timestamp: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    list(request: AgentMail.ListMetricsRequest, requestOptions?: Metrics.RequestOptions): core.HttpResponsePromise<AgentMail.ListMetricsResponse>;
+    private __list;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

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

@@ -0,0 +1,101 @@
+/**
+ * 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 * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as AgentMail from "../../../index.mjs";
+import { toJson } from "../../../../core/json.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as errors from "../../../../errors/index.mjs";
+export class Metrics {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * @param {AgentMail.ListMetricsRequest} request
+     * @param {Metrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.metrics.list({
+     *         start_timestamp: "2024-01-15T09:30:00Z",
+     *         end_timestamp: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    list(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    __list(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const { event_types: eventTypes, start_timestamp: startTimestamp, end_timestamp: endTimestamp } = request;
+            const _queryParams = {};
+            if (eventTypes != null) {
+                _queryParams["event_types"] = toJson(eventTypes);
+            }
+            _queryParams["start_timestamp"] = startTimestamp;
+            _queryParams["end_timestamp"] = endTimestamp;
+            const _response = yield core.fetcher({
+                url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Production).http, "/v0/metrics"),
+                method: "GET",
+                headers: mergeHeaders((_c = this._options) === null || _c === void 0 ? void 0 : _c.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                queryParameters: _queryParams,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AgentMail.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AgentMailError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AgentMailTimeoutError("Timeout exceeded when calling GET /v0/metrics.");
+                case "unknown":
+                    throw new errors.AgentMailError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const bearer = (_a = (yield core.Supplier.get(this._options.apiKey))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["AGENTMAIL_API_KEY"];
+            if (bearer == null) {
+                throw new errors.AgentMailError({
+                    message: "Please specify a bearer by either passing it in to the constructor or initializing a AGENTMAIL_API_KEY environment variable",
+                });
+            }
+            return `Bearer ${bearer}`;
+        });
+    }
+}

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

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

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

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

package/dist/esm/api/resources/metrics/client/requests/ListMetricsRequest.d.mts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         start_timestamp: "2024-01-15T09:30:00Z",
+ *         end_timestamp: "2024-01-15T09:30:00Z"
+ *     }
+ */
+export interface ListMetricsRequest {
+    event_types?: AgentMail.MetricEventTypes;
+    start_timestamp: AgentMail.MetricStartTimestamp;
+    end_timestamp: AgentMail.MetricEndTimestamp;
+}

package/dist/esm/api/resources/metrics/client/requests/ListMetricsRequest.mjs

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

package/dist/esm/api/resources/metrics/client/requests/index.d.mts

@@ -0,0 +1 @@
+export { type ListMetricsRequest } from "./ListMetricsRequest.mjs";

package/dist/esm/api/resources/metrics/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/metrics/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/metrics/index.mjs

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/metrics/types/ListMetricsResponse.d.mts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../../../index.mjs";
+export interface ListMetricsResponse {
+    /** Message metrics grouped by event type. */
+    message?: AgentMail.MessageMetrics;
+}

package/dist/esm/api/resources/metrics/types/ListMetricsResponse.mjs

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

package/dist/esm/api/resources/metrics/types/MessageMetrics.d.mts

@@ -0,0 +1,20 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../../../index.mjs";
+export interface MessageMetrics {
+    /** Timestamps when messages were sent. */
+    sent?: AgentMail.MetricTimestamp[];
+    /** Timestamps when messages were delivered. */
+    delivered?: AgentMail.MetricTimestamp[];
+    /** Timestamps when messages bounced. */
+    bounced?: AgentMail.MetricTimestamp[];
+    /** Timestamps when messages were delayed. */
+    delayed?: AgentMail.MetricTimestamp[];
+    /** Timestamps when messages were rejected. */
+    rejected?: AgentMail.MetricTimestamp[];
+    /** Timestamps when messages received complaints. */
+    complained?: AgentMail.MetricTimestamp[];
+    /** Timestamps when messages were received. */
+    received?: AgentMail.MetricTimestamp[];
+}

package/dist/esm/api/resources/metrics/types/MessageMetrics.mjs

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

package/dist/esm/api/resources/metrics/types/MetricEndTimestamp.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * End timestamp for the metrics query range.
+ */
+export type MetricEndTimestamp = string;

package/dist/esm/api/resources/metrics/types/MetricEndTimestamp.mjs

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

package/dist/esm/api/resources/metrics/types/MetricEventType.d.mts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Type of metric event.
+ */
+export type MetricEventType = "message.sent" | "message.delivered" | "message.bounced" | "message.delayed" | "message.rejected" | "message.complained" | "message.received";
+export declare const MetricEventType: {
+    readonly MessageSent: "message.sent";
+    readonly MessageDelivered: "message.delivered";
+    readonly MessageBounced: "message.bounced";
+    readonly MessageDelayed: "message.delayed";
+    readonly MessageRejected: "message.rejected";
+    readonly MessageComplained: "message.complained";
+    readonly MessageReceived: "message.received";
+};

package/dist/esm/api/resources/metrics/types/MetricEventType.mjs

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const MetricEventType = {
+    MessageSent: "message.sent",
+    MessageDelivered: "message.delivered",
+    MessageBounced: "message.bounced",
+    MessageDelayed: "message.delayed",
+    MessageRejected: "message.rejected",
+    MessageComplained: "message.complained",
+    MessageReceived: "message.received",
+};

package/dist/esm/api/resources/metrics/types/MetricEventTypes.d.mts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../../../index.mjs";
+/**
+ * List of metric event types to filter by.
+ */
+export type MetricEventTypes = AgentMail.MetricEventType[];

package/dist/esm/api/resources/metrics/types/MetricEventTypes.mjs

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

package/dist/esm/api/resources/metrics/types/MetricStartTimestamp.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Start timestamp for the metrics query range.
+ */
+export type MetricStartTimestamp = string;

package/dist/esm/api/resources/metrics/types/MetricStartTimestamp.mjs

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

package/dist/esm/api/resources/metrics/types/MetricTimestamp.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Timestamp when the metric event occurred.
+ */
+export type MetricTimestamp = string;

package/dist/esm/api/resources/metrics/types/MetricTimestamp.mjs

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

package/dist/esm/api/resources/metrics/types/index.d.mts

@@ -0,0 +1,7 @@
+export * from "./MetricEventType.mjs";
+export * from "./MetricTimestamp.mjs";
+export * from "./MetricEventTypes.mjs";
+export * from "./MetricStartTimestamp.mjs";
+export * from "./MetricEndTimestamp.mjs";
+export * from "./MessageMetrics.mjs";
+export * from "./ListMetricsResponse.mjs";

package/dist/esm/api/resources/metrics/types/index.mjs

@@ -0,0 +1,7 @@
+export * from "./MetricEventType.mjs";
+export * from "./MetricTimestamp.mjs";
+export * from "./MetricEventTypes.mjs";
+export * from "./MetricStartTimestamp.mjs";
+export * from "./MetricEndTimestamp.mjs";
+export * from "./MessageMetrics.mjs";
+export * from "./ListMetricsResponse.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.0.46";
+export declare const SDK_VERSION = "0.0.49";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.0.46";
+export const SDK_VERSION = "0.0.49";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.0.46",
+    "version": "0.0.49",
     "private": false,
     "repository": "github:agentmail-to/agentmail-node",
     "type": "commonjs",