agentmail 0.1.6 → 0.1.7

package/dist/esm/core/logging/logger.d.mts

@@ -0,0 +1,126 @@
+export declare const LogLevel: {
+    readonly Debug: "debug";
+    readonly Info: "info";
+    readonly Warn: "warn";
+    readonly Error: "error";
+};
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+export interface ILogger {
+    /**
+     * Logs a debug message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an info message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Logs a warning message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an error message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Configuration for logger initialization.
+ */
+export interface LogConfig {
+    /**
+     * Minimum log level to output.
+     * @default LogLevel.Info
+     */
+    level?: LogLevel;
+    /**
+     * Logger implementation to use.
+     * @default new ConsoleLogger()
+     */
+    logger?: ILogger;
+    /**
+     * Whether logging should be silenced.
+     * @default true
+     */
+    silent?: boolean;
+}
+/**
+ * Default console-based logger implementation.
+ */
+export declare class ConsoleLogger implements ILogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export declare class Logger {
+    private readonly level;
+    private readonly logger;
+    private readonly silent;
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config: Required<LogConfig>);
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level: LogLevel): boolean;
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug(): boolean;
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo(): boolean;
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn(): boolean;
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError(): boolean;
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function createLogger(config?: LogConfig | Logger): Logger;

package/dist/esm/core/logging/logger.mjs

@@ -0,0 +1,138 @@
+export const LogLevel = {
+    Debug: "debug",
+    Info: "info",
+    Warn: "warn",
+    Error: "error",
+};
+const logLevelMap = {
+    [LogLevel.Debug]: 1,
+    [LogLevel.Info]: 2,
+    [LogLevel.Warn]: 3,
+    [LogLevel.Error]: 4,
+};
+/**
+ * Default console-based logger implementation.
+ */
+export class ConsoleLogger {
+    debug(message, ...args) {
+        console.debug(message, ...args);
+    }
+    info(message, ...args) {
+        console.info(message, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(message, ...args);
+    }
+    error(message, ...args) {
+        console.error(message, ...args);
+    }
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export class Logger {
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config) {
+        this.level = logLevelMap[config.level];
+        this.logger = config.logger;
+        this.silent = config.silent;
+    }
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level) {
+        return !this.silent && this.level <= logLevelMap[level];
+    }
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug() {
+        return this.shouldLog(LogLevel.Debug);
+    }
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message, ...args) {
+        if (this.isDebug()) {
+            this.logger.debug(message, ...args);
+        }
+    }
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo() {
+        return this.shouldLog(LogLevel.Info);
+    }
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message, ...args) {
+        if (this.isInfo()) {
+            this.logger.info(message, ...args);
+        }
+    }
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn() {
+        return this.shouldLog(LogLevel.Warn);
+    }
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message, ...args) {
+        if (this.isWarn()) {
+            this.logger.warn(message, ...args);
+        }
+    }
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError() {
+        return this.shouldLog(LogLevel.Error);
+    }
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message, ...args) {
+        if (this.isError()) {
+            this.logger.error(message, ...args);
+        }
+    }
+}
+export function createLogger(config) {
+    var _a, _b, _c;
+    if (config == null) {
+        return defaultLogger;
+    }
+    if (config instanceof Logger) {
+        return config;
+    }
+    config = config !== null && config !== void 0 ? config : {};
+    (_a = config.level) !== null && _a !== void 0 ? _a : (config.level = LogLevel.Info);
+    (_b = config.logger) !== null && _b !== void 0 ? _b : (config.logger = new ConsoleLogger());
+    (_c = config.silent) !== null && _c !== void 0 ? _c : (config.silent = true);
+    return new Logger(config);
+}
+const defaultLogger = new Logger({
+    level: LogLevel.Info,
+    logger: new ConsoleLogger(),
+    silent: true,
+});

package/dist/esm/core/schemas/Schema.d.mts

@@ -20,6 +20,7 @@ export declare const SchemaType: {
     readonly NUMBER: "number";
     readonly STRING: "string";
     readonly UNKNOWN: "unknown";
+    readonly NEVER: "never";
     readonly RECORD: "record";
     readonly SET: "set";
     readonly UNION: "union";

package/dist/esm/core/schemas/Schema.mjs

@@ -11,6 +11,7 @@ export const SchemaType = {
     NUMBER: "number",
     STRING: "string",
     UNKNOWN: "unknown",
+    NEVER: "never",
     RECORD: "record",
     SET: "set",
     UNION: "union",

package/dist/esm/core/schemas/builders/primitives/index.d.mts

@@ -1,5 +1,6 @@
 export { any } from "./any.mjs";
 export { boolean } from "./boolean.mjs";
+export { never } from "./never.mjs";
 export { number } from "./number.mjs";
 export { string } from "./string.mjs";
 export { unknown } from "./unknown.mjs";

package/dist/esm/core/schemas/builders/primitives/index.mjs

@@ -1,5 +1,6 @@
 export { any } from "./any.mjs";
 export { boolean } from "./boolean.mjs";
+export { never } from "./never.mjs";
 export { number } from "./number.mjs";
 export { string } from "./string.mjs";
 export { unknown } from "./unknown.mjs";

package/dist/esm/core/schemas/builders/primitives/never.d.mts

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.mjs";
+export declare const never: () => Schema<never, never>;

package/dist/esm/core/schemas/builders/primitives/never.mjs

@@ -0,0 +1,11 @@
+import { SchemaType } from "../../Schema.mjs";
+import { createIdentitySchemaCreator } from "../../utils/createIdentitySchemaCreator.mjs";
+export const never = createIdentitySchemaCreator(SchemaType.NEVER, (_value, { breadcrumbsPrefix = [] } = {}) => ({
+    ok: false,
+    errors: [
+        {
+            path: breadcrumbsPrefix,
+            message: "Expected never",
+        },
+    ],
+}));

package/dist/esm/core/url/join.mjs

@@ -11,7 +11,6 @@ export function join(base, ...segments) {
             url = new URL(base);
         }
         catch (_a) {
-            // Fallback to path joining if URL is malformed
             return joinPath(base, ...segments);
         }
         const lastSegment = segments[segments.length - 1];

package/dist/esm/serialization/resources/events/types/DomainVerifiedEvent.d.mts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { Domain } from "../../domains/types/Domain.mjs";
+import { EventId } from "./EventId.mjs";
+export declare const DomainVerifiedEvent: core.serialization.ObjectSchema<serializers.DomainVerifiedEvent.Raw, AgentMail.DomainVerifiedEvent>;
+export declare namespace DomainVerifiedEvent {
+    interface Raw {
+        type: "event";
+        event_type: "domain.verified";
+        event_id: EventId.Raw;
+        domain: Domain.Raw;
+    }
+}

package/dist/esm/serialization/resources/events/types/DomainVerifiedEvent.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { Domain } from "../../domains/types/Domain.mjs";
+import { EventId } from "./EventId.mjs";
+export const DomainVerifiedEvent = core.serialization.object({
+    type: core.serialization.stringLiteral("event"),
+    eventType: core.serialization.property("event_type", core.serialization.stringLiteral("domain.verified")),
+    eventId: core.serialization.property("event_id", EventId),
+    domain: Domain,
+});

package/dist/esm/serialization/resources/{webhooks → events}/types/EventType.d.mts

@@ -1,7 +1,7 @@
 import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
-export declare const EventType: core.serialization.Schema<serializers.webhooks.EventType.Raw, AgentMail.webhooks.EventType>;
+export declare const EventType: core.serialization.Schema<serializers.EventType.Raw, AgentMail.EventType>;
 export declare namespace EventType {
-    type Raw = "message.received" | "message.sent" | "message.delivered" | "message.bounced" | "message.complained" | "message.rejected";
+    type Raw = "message.received" | "message.sent" | "message.delivered" | "message.bounced" | "message.complained" | "message.rejected" | "domain.verified";
 }

package/dist/esm/serialization/resources/{webhooks → events}/types/EventType.mjs

@@ -7,4 +7,5 @@ export const EventType = core.serialization.enum_([
     "message.bounced",
     "message.complained",
     "message.rejected",
+    "domain.verified",
 ]);

package/dist/esm/serialization/resources/{webhooks → events}/types/EventTypes.d.mts

@@ -2,7 +2,7 @@ import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
 import { EventType } from "./EventType.mjs";
-export declare const EventTypes: core.serialization.Schema<serializers.webhooks.EventTypes.Raw, AgentMail.webhooks.EventTypes>;
+export declare const EventTypes: core.serialization.Schema<serializers.EventTypes.Raw, AgentMail.EventTypes>;
 export declare namespace EventTypes {
     type Raw = EventType.Raw[];
 }

package/dist/esm/serialization/resources/events/types/index.d.mts

@@ -1,7 +1,10 @@
 export * from "./Bounce.mjs";
 export * from "./Complaint.mjs";
 export * from "./Delivery.mjs";
+export * from "./DomainVerifiedEvent.mjs";
 export * from "./EventId.mjs";
+export * from "./EventType.mjs";
+export * from "./EventTypes.mjs";
 export * from "./MessageBouncedEvent.mjs";
 export * from "./MessageComplainedEvent.mjs";
 export * from "./MessageDeliveredEvent.mjs";

package/dist/esm/serialization/resources/events/types/index.mjs

@@ -1,7 +1,10 @@
 export * from "./Bounce.mjs";
 export * from "./Complaint.mjs";
 export * from "./Delivery.mjs";
+export * from "./DomainVerifiedEvent.mjs";
 export * from "./EventId.mjs";
+export * from "./EventType.mjs";
+export * from "./EventTypes.mjs";
 export * from "./MessageBouncedEvent.mjs";
 export * from "./MessageComplainedEvent.mjs";
 export * from "./MessageDeliveredEvent.mjs";

package/dist/esm/serialization/resources/webhooks/types/CreateWebhookRequest.d.mts

@@ -1,8 +1,8 @@
 import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 import { ClientId } from "./ClientId.mjs";
-import { EventTypes } from "./EventTypes.mjs";
 import { InboxIds } from "./InboxIds.mjs";
 import { Url } from "./Url.mjs";
 export declare const CreateWebhookRequest: core.serialization.ObjectSchema<serializers.webhooks.CreateWebhookRequest.Raw, AgentMail.webhooks.CreateWebhookRequest>;

package/dist/esm/serialization/resources/webhooks/types/CreateWebhookRequest.mjs

@@ -1,7 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 import { ClientId } from "./ClientId.mjs";
-import { EventTypes } from "./EventTypes.mjs";
 import { InboxIds } from "./InboxIds.mjs";
 import { Url } from "./Url.mjs";
 export const CreateWebhookRequest = core.serialization.object({

package/dist/esm/serialization/resources/webhooks/types/Webhook.d.mts

@@ -1,8 +1,8 @@
 import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 import { ClientId } from "./ClientId.mjs";
-import { EventTypes } from "./EventTypes.mjs";
 import { InboxIds } from "./InboxIds.mjs";
 import { Url } from "./Url.mjs";
 import { WebhookId } from "./WebhookId.mjs";

package/dist/esm/serialization/resources/webhooks/types/Webhook.mjs

@@ -1,7 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 import { ClientId } from "./ClientId.mjs";
-import { EventTypes } from "./EventTypes.mjs";
 import { InboxIds } from "./InboxIds.mjs";
 import { Url } from "./Url.mjs";
 import { WebhookId } from "./WebhookId.mjs";

package/dist/esm/serialization/resources/webhooks/types/index.d.mts

@@ -1,7 +1,5 @@
 export * from "./ClientId.mjs";
 export * from "./CreateWebhookRequest.mjs";
-export * from "./EventType.mjs";
-export * from "./EventTypes.mjs";
 export * from "./InboxIds.mjs";
 export * from "./ListWebhooksResponse.mjs";
 export * from "./Url.mjs";

package/dist/esm/serialization/resources/webhooks/types/index.mjs

@@ -1,7 +1,5 @@
 export * from "./ClientId.mjs";
 export * from "./CreateWebhookRequest.mjs";
-export * from "./EventType.mjs";
-export * from "./EventTypes.mjs";
 export * from "./InboxIds.mjs";
 export * from "./ListWebhooksResponse.mjs";
 export * from "./Url.mjs";

package/dist/esm/serialization/resources/websockets/client/socket/WebsocketsSocketResponse.d.mts

@@ -1,6 +1,7 @@
 import type * as AgentMail from "../../../../../api/index.mjs";
 import * as core from "../../../../../core/index.mjs";
 import type * as serializers from "../../../../index.mjs";
+import { DomainVerifiedEvent } from "../../../events/types/DomainVerifiedEvent.mjs";
 import { MessageBouncedEvent } from "../../../events/types/MessageBouncedEvent.mjs";
 import { MessageComplainedEvent } from "../../../events/types/MessageComplainedEvent.mjs";
 import { MessageDeliveredEvent } from "../../../events/types/MessageDeliveredEvent.mjs";
@@ -8,7 +9,7 @@ import { MessageReceivedEvent } from "../../../events/types/MessageReceivedEvent
 import { MessageRejectedEvent } from "../../../events/types/MessageRejectedEvent.mjs";
 import { MessageSentEvent } from "../../../events/types/MessageSentEvent.mjs";
 import { Subscribed } from "../../types/Subscribed.mjs";
-export declare const WebsocketsSocketResponse: core.serialization.Schema<serializers.WebsocketsSocketResponse.Raw, AgentMail.Subscribed | AgentMail.MessageReceivedEvent | AgentMail.MessageSentEvent | AgentMail.MessageDeliveredEvent | AgentMail.MessageBouncedEvent | AgentMail.MessageComplainedEvent | AgentMail.MessageRejectedEvent>;
+export declare const WebsocketsSocketResponse: core.serialization.Schema<serializers.WebsocketsSocketResponse.Raw, AgentMail.Subscribed | AgentMail.MessageReceivedEvent | AgentMail.MessageSentEvent | AgentMail.MessageDeliveredEvent | AgentMail.MessageBouncedEvent | AgentMail.MessageComplainedEvent | AgentMail.MessageRejectedEvent | AgentMail.DomainVerifiedEvent>;
 export declare namespace WebsocketsSocketResponse {
-    type Raw = Subscribed.Raw | MessageReceivedEvent.Raw | MessageSentEvent.Raw | MessageDeliveredEvent.Raw | MessageBouncedEvent.Raw | MessageComplainedEvent.Raw | MessageRejectedEvent.Raw;
+    type Raw = Subscribed.Raw | MessageReceivedEvent.Raw | MessageSentEvent.Raw | MessageDeliveredEvent.Raw | MessageBouncedEvent.Raw | MessageComplainedEvent.Raw | MessageRejectedEvent.Raw | DomainVerifiedEvent.Raw;
 }

package/dist/esm/serialization/resources/websockets/client/socket/WebsocketsSocketResponse.mjs

@@ -1,5 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../../core/index.mjs";
+import { DomainVerifiedEvent } from "../../../events/types/DomainVerifiedEvent.mjs";
 import { MessageBouncedEvent } from "../../../events/types/MessageBouncedEvent.mjs";
 import { MessageComplainedEvent } from "../../../events/types/MessageComplainedEvent.mjs";
 import { MessageDeliveredEvent } from "../../../events/types/MessageDeliveredEvent.mjs";
@@ -15,4 +16,5 @@ export const WebsocketsSocketResponse = core.serialization.undiscriminatedUnion(
     MessageBouncedEvent,
     MessageComplainedEvent,
     MessageRejectedEvent,
+    DomainVerifiedEvent,
 ]);

package/dist/esm/serialization/resources/websockets/types/Subscribe.d.mts

@@ -1,10 +1,13 @@
 import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 export declare const Subscribe: core.serialization.ObjectSchema<serializers.Subscribe.Raw, AgentMail.Subscribe>;
 export declare namespace Subscribe {
     interface Raw {
         type: "subscribe";
-        inbox_ids: string[];
+        event_types?: EventTypes.Raw | null;
+        inbox_ids?: string[] | null;
+        pod_ids?: string[] | null;
     }
 }

package/dist/esm/serialization/resources/websockets/types/Subscribe.mjs

@@ -1,6 +1,9 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 export const Subscribe = core.serialization.object({
     type: core.serialization.stringLiteral("subscribe"),
-    inboxIds: core.serialization.property("inbox_ids", core.serialization.list(core.serialization.string())),
+    eventTypes: core.serialization.property("event_types", EventTypes.optional()),
+    inboxIds: core.serialization.property("inbox_ids", core.serialization.list(core.serialization.string()).optional()),
+    podIds: core.serialization.property("pod_ids", core.serialization.list(core.serialization.string()).optional()),
 });

package/dist/esm/serialization/resources/websockets/types/Subscribed.d.mts

@@ -1,10 +1,13 @@
 import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 export declare const Subscribed: core.serialization.ObjectSchema<serializers.Subscribed.Raw, AgentMail.Subscribed>;
 export declare namespace Subscribed {
     interface Raw {
         type: "subscribed";
-        inbox_ids: string[];
+        event_types?: EventTypes.Raw | null;
+        inbox_ids?: string[] | null;
+        pod_ids?: string[] | null;
     }
 }

package/dist/esm/serialization/resources/websockets/types/Subscribed.mjs

@@ -1,6 +1,9 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 export const Subscribed = core.serialization.object({
     type: core.serialization.stringLiteral("subscribed"),
-    inboxIds: core.serialization.property("inbox_ids", core.serialization.list(core.serialization.string())),
+    eventTypes: core.serialization.property("event_types", EventTypes.optional()),
+    inboxIds: core.serialization.property("inbox_ids", core.serialization.list(core.serialization.string()).optional()),
+    podIds: core.serialization.property("pod_ids", core.serialization.list(core.serialization.string()).optional()),
 });

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.6";
+export declare const SDK_VERSION = "0.1.7";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.6";
+export const SDK_VERSION = "0.1.7";