@sylphx/contract 0.2.0

package/dist/endpoints/email-admin.d.ts

@@ -0,0 +1,415 @@
+/**
+ * Email Admin endpoints — Console-plane per-project template management,
+ * transactional send, scheduling, logs, suppressions, settings, and a handful
+ * of super-admin cross-project operations. Mirrors
+ * `apps/api/src/server/platform/routes/email/*`.
+ *
+ * Production mount: `/email/*` (see `apps/api/src/server/platform/app.ts`).
+ * Project-scoped routes accept a project ID or slug via `{id}`; send/schedule
+ * additionally accept a `projectId` body/query where the path doesn't carry
+ * one (not needed here — all sub-routes live under `/projects/:id`).
+ *
+ * Plane: `'management'` — distinct from BaaS `emailEndpoints` (plane:
+ * `'baas'`) which are served by the runtime for customer apps.
+ */
+import { Schema } from 'effect';
+export declare const emailAdminEndpoints: {
+    readonly listTemplates: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/templates", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        templates: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            key: typeof Schema.String;
+            name: typeof Schema.String;
+            description: Schema.NullOr<typeof Schema.String>;
+            type: typeof Schema.String;
+            subject: typeof Schema.String;
+            isActive: typeof Schema.Boolean;
+            createdAt: typeof Schema.String;
+            updatedAt: typeof Schema.String;
+        }>>;
+        total: typeof Schema.Number;
+    }>>;
+    readonly createTemplate: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/templates", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        key: typeof Schema.String;
+        name: typeof Schema.String;
+        description: Schema.optional<typeof Schema.String>;
+        type: Schema.optional<Schema.Literal<["transactional", "newsletter"]>>;
+        subject: typeof Schema.String;
+        htmlBody: typeof Schema.String;
+        textBody: Schema.optional<typeof Schema.String>;
+        variables: Schema.optional<Schema.Array$<typeof Schema.String>>;
+        fromEmail: Schema.optional<typeof Schema.String>;
+        fromName: Schema.optional<typeof Schema.String>;
+        replyTo: Schema.optional<typeof Schema.String>;
+        isActive: Schema.optional<typeof Schema.Boolean>;
+    }>, Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+        name: typeof Schema.String;
+        description: Schema.NullOr<typeof Schema.String>;
+        type: typeof Schema.String;
+        subject: typeof Schema.String;
+        htmlBody: typeof Schema.String;
+        textBody: Schema.NullOr<typeof Schema.String>;
+        variables: Schema.NullOr<Schema.Array$<typeof Schema.String>>;
+        fromName: Schema.NullOr<typeof Schema.String>;
+        fromEmail: Schema.NullOr<typeof Schema.String>;
+        replyTo: Schema.NullOr<typeof Schema.String>;
+        isActive: typeof Schema.Boolean;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>;
+    readonly getTemplate: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/templates/:key", Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+        name: typeof Schema.String;
+        description: Schema.NullOr<typeof Schema.String>;
+        type: typeof Schema.String;
+        subject: typeof Schema.String;
+        htmlBody: typeof Schema.String;
+        textBody: Schema.NullOr<typeof Schema.String>;
+        variables: Schema.NullOr<Schema.Array$<typeof Schema.String>>;
+        fromName: Schema.NullOr<typeof Schema.String>;
+        fromEmail: Schema.NullOr<typeof Schema.String>;
+        replyTo: Schema.NullOr<typeof Schema.String>;
+        isActive: typeof Schema.Boolean;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>;
+    readonly updateTemplate: import("../endpoint.js").Endpoint<"PATCH", "/email/projects/:id/templates/:key", Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        name: Schema.optional<typeof Schema.String>;
+        description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        type: Schema.optional<Schema.Literal<["transactional", "newsletter"]>>;
+        subject: Schema.optional<typeof Schema.String>;
+        htmlBody: Schema.optional<typeof Schema.String>;
+        textBody: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        variables: Schema.optional<Schema.NullOr<Schema.Array$<typeof Schema.String>>>;
+        fromEmail: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        fromName: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        replyTo: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        isActive: Schema.optional<typeof Schema.Boolean>;
+    }>, Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+        name: typeof Schema.String;
+        description: Schema.NullOr<typeof Schema.String>;
+        type: typeof Schema.String;
+        subject: typeof Schema.String;
+        htmlBody: typeof Schema.String;
+        textBody: Schema.NullOr<typeof Schema.String>;
+        variables: Schema.NullOr<Schema.Array$<typeof Schema.String>>;
+        fromName: Schema.NullOr<typeof Schema.String>;
+        fromEmail: Schema.NullOr<typeof Schema.String>;
+        replyTo: Schema.NullOr<typeof Schema.String>;
+        isActive: typeof Schema.Boolean;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>;
+    readonly deleteTemplate: import("../endpoint.js").Endpoint<"DELETE", "/email/projects/:id/templates/:key", Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+        name: typeof Schema.String;
+        description: Schema.NullOr<typeof Schema.String>;
+        type: typeof Schema.String;
+        subject: typeof Schema.String;
+        htmlBody: typeof Schema.String;
+        textBody: Schema.NullOr<typeof Schema.String>;
+        variables: Schema.NullOr<Schema.Array$<typeof Schema.String>>;
+        fromName: Schema.NullOr<typeof Schema.String>;
+        fromEmail: Schema.NullOr<typeof Schema.String>;
+        replyTo: Schema.NullOr<typeof Schema.String>;
+        isActive: typeof Schema.Boolean;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>;
+    readonly sendEmail: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/send", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        to: typeof Schema.String;
+        subject: typeof Schema.String;
+        html: typeof Schema.String;
+        text: Schema.optional<typeof Schema.String>;
+        replyTo: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        success: typeof Schema.Boolean;
+        id: Schema.optional<typeof Schema.String>;
+    }>>;
+    readonly sendTemplated: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/send-templated", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        template: Schema.Literal<["welcome", "verification", "password_reset", "security_alert"]>;
+        to: typeof Schema.String;
+        data: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    }>, Schema.Struct<{
+        success: typeof Schema.Boolean;
+        template: typeof Schema.String;
+    }>>;
+    readonly sendToUser: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/send-to-user", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        userId: typeof Schema.String;
+        subject: typeof Schema.String;
+        html: typeof Schema.String;
+        text: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        success: typeof Schema.Boolean;
+        id: Schema.optional<typeof Schema.String>;
+    }>>;
+    readonly scheduleEmail: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/schedule", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        to: typeof Schema.String;
+        toName: Schema.optional<typeof Schema.String>;
+        subject: typeof Schema.String;
+        html: Schema.optional<typeof Schema.String>;
+        text: Schema.optional<typeof Schema.String>;
+        replyTo: Schema.optional<typeof Schema.String>;
+        fromEmail: Schema.optional<typeof Schema.String>;
+        fromName: Schema.optional<typeof Schema.String>;
+        scheduledFor: typeof Schema.String;
+        templateKey: Schema.optional<typeof Schema.String>;
+        templateData: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        idempotencyKey: Schema.optional<typeof Schema.String>;
+        metadata: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    }>, Schema.Struct<{
+        id: typeof Schema.String;
+        status: typeof Schema.String;
+        scheduledFor: typeof Schema.String;
+        qstashMessageId: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    readonly listScheduled: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/scheduled", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Struct<{
+        status: Schema.optional<typeof Schema.String>;
+        search: Schema.optional<typeof Schema.String>;
+        from: Schema.optional<typeof Schema.String>;
+        to: Schema.optional<typeof Schema.String>;
+        limit: Schema.optional<typeof Schema.String>;
+        offset: Schema.optional<typeof Schema.String>;
+        environmentId: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        emails: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            toEmail: typeof Schema.String;
+            toName: Schema.NullOr<typeof Schema.String>;
+            subject: typeof Schema.String;
+            status: typeof Schema.String;
+            scheduledFor: typeof Schema.String;
+            templateKey: Schema.NullOr<typeof Schema.String>;
+            sentAt: Schema.NullOr<typeof Schema.String>;
+            cancelledAt: Schema.NullOr<typeof Schema.String>;
+            error: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+        }>>;
+        total: typeof Schema.Number;
+        limit: typeof Schema.Number;
+        offset: typeof Schema.Number;
+    }>>;
+    readonly scheduledStats: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/scheduled/stats", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Struct<{
+        from: Schema.optional<typeof Schema.String>;
+        to: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        total: typeof Schema.Number;
+        pending: typeof Schema.Number;
+        queued: typeof Schema.Number;
+        sent: typeof Schema.Number;
+        cancelled: typeof Schema.Number;
+        failed: typeof Schema.Number;
+    }>>;
+    readonly getScheduled: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/scheduled/:emailId", Schema.Struct<{
+        id: typeof Schema.String;
+        emailId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        toEmail: typeof Schema.String;
+        toName: Schema.NullOr<typeof Schema.String>;
+        subject: typeof Schema.String;
+        status: typeof Schema.String;
+        scheduledFor: typeof Schema.String;
+        templateKey: Schema.NullOr<typeof Schema.String>;
+        templateData: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        metadata: Schema.NullOr<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        sentAt: Schema.NullOr<typeof Schema.String>;
+        cancelledAt: Schema.NullOr<typeof Schema.String>;
+        error: Schema.NullOr<typeof Schema.String>;
+        providerMessageId: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>>;
+    readonly cancelScheduled: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/scheduled/:emailId/cancel", Schema.Struct<{
+        id: typeof Schema.String;
+        emailId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        status: typeof Schema.String;
+        cancelledAt: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    readonly rescheduleEmail: import("../endpoint.js").Endpoint<"PATCH", "/email/projects/:id/scheduled/:emailId/reschedule", Schema.Struct<{
+        id: typeof Schema.String;
+        emailId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        scheduledFor: typeof Schema.String;
+    }>, Schema.Struct<{
+        id: typeof Schema.String;
+        status: typeof Schema.String;
+        scheduledFor: typeof Schema.String;
+        qstashMessageId: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    readonly listLogs: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/logs", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Struct<{
+        cursor: Schema.optional<typeof Schema.String>;
+        limit: Schema.optional<typeof Schema.String>;
+        status: Schema.optional<Schema.Literal<["queued", "sent", "delivered", "bounced", "complained", "failed"]>>;
+        email: Schema.optional<typeof Schema.String>;
+        from: Schema.optional<typeof Schema.String>;
+        to: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        data: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            object: Schema.Literal<["email"]>;
+            to: Schema.Array$<typeof Schema.String>;
+            from: typeof Schema.String;
+            subject: typeof Schema.String;
+            status: typeof Schema.String;
+            created_at: typeof Schema.String;
+            last_event: Schema.NullOr<typeof Schema.String>;
+        }>>;
+        nextCursor: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    readonly getLog: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/logs/:logId", Schema.Struct<{
+        id: typeof Schema.String;
+        logId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        object: Schema.Literal<["email"]>;
+        to: Schema.Array$<typeof Schema.String>;
+        from: typeof Schema.String;
+        subject: typeof Schema.String;
+        status: typeof Schema.String;
+        created_at: typeof Schema.String;
+        last_event: Schema.NullOr<typeof Schema.String>;
+        reply_to: Schema.NullOr<typeof Schema.String>;
+        bcc: Schema.NullOr<Schema.Array$<typeof Schema.String>>;
+        cc: Schema.NullOr<Schema.Array$<typeof Schema.String>>;
+        delivered_at: Schema.NullOr<typeof Schema.String>;
+        bounced_at: Schema.NullOr<typeof Schema.String>;
+        complained_at: Schema.NullOr<typeof Schema.String>;
+        opened_at: Schema.NullOr<typeof Schema.String>;
+        clicked_at: Schema.NullOr<typeof Schema.String>;
+        bounce_type: Schema.NullOr<typeof Schema.String>;
+        error: Schema.NullOr<typeof Schema.String>;
+        events: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            type: typeof Schema.String;
+            created_at: typeof Schema.String;
+        }>>;
+    }>>;
+    readonly listSuppressions: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/suppressions", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Struct<{
+        cursor: Schema.optional<typeof Schema.String>;
+        limit: Schema.optional<typeof Schema.String>;
+        reason: Schema.optional<Schema.Literal<["hard_bounce", "complaint", "manual"]>>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        data: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            email: typeof Schema.String;
+            reason: Schema.Literal<["hard_bounce", "complaint", "manual"]>;
+            can_unsuppress: typeof Schema.Boolean;
+            suppressed_at: typeof Schema.String;
+            unsuppressed_at: Schema.NullOr<typeof Schema.String>;
+            created_at: typeof Schema.String;
+        }>>;
+        nextCursor: Schema.NullOr<typeof Schema.String>;
+    }>>;
+    readonly addSuppression: import("../endpoint.js").Endpoint<"POST", "/email/projects/:id/suppressions", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        email: typeof Schema.String;
+        reason: Schema.optional<Schema.Literal<["manual"]>>;
+    }>, Schema.Struct<{
+        id: typeof Schema.String;
+        email: typeof Schema.String;
+        reason: Schema.Literal<["hard_bounce", "complaint", "manual"]>;
+        can_unsuppress: typeof Schema.Boolean;
+        suppressed_at: typeof Schema.String;
+        unsuppressed_at: Schema.NullOr<typeof Schema.String>;
+        created_at: typeof Schema.String;
+    }>>;
+    readonly deleteSuppression: import("../endpoint.js").Endpoint<"DELETE", "/email/projects/:id/suppressions/:email", Schema.Struct<{
+        id: typeof Schema.String;
+        email: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        email: typeof Schema.String;
+        reason: Schema.Literal<["hard_bounce", "complaint", "manual"]>;
+        can_unsuppress: typeof Schema.Boolean;
+        suppressed_at: typeof Schema.String;
+        unsuppressed_at: Schema.NullOr<typeof Schema.String>;
+        created_at: typeof Schema.String;
+    }>>;
+    readonly getSettings: import("../endpoint.js").Endpoint<"GET", "/email/projects/:id/email-settings", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+        defaultFromName: Schema.NullOr<typeof Schema.String>;
+        webhookUrl: Schema.NullOr<typeof Schema.String>;
+        webhookSecretPrefix: Schema.NullOr<typeof Schema.String>;
+        trackOpens: typeof Schema.Boolean;
+        trackClicks: typeof Schema.Boolean;
+    }>>;
+    readonly updateSettings: import("../endpoint.js").Endpoint<"PATCH", "/email/projects/:id/email-settings", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        defaultFromEmail: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        defaultFromName: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        webhookUrl: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        rotateWebhookSecret: Schema.optional<typeof Schema.Boolean>;
+        trackOpens: Schema.optional<typeof Schema.Boolean>;
+        trackClicks: Schema.optional<typeof Schema.Boolean>;
+    }>, Schema.Struct<{
+        defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+        defaultFromName: Schema.NullOr<typeof Schema.String>;
+        webhookUrl: Schema.NullOr<typeof Schema.String>;
+        webhookSecretPrefix: Schema.NullOr<typeof Schema.String>;
+        trackOpens: typeof Schema.Boolean;
+        trackClicks: typeof Schema.Boolean;
+    }>>;
+    readonly adminSend: import("../endpoint.js").Endpoint<"POST", "/email/admin/send", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        to: Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.String>]>;
+        subject: typeof Schema.String;
+        html: typeof Schema.String;
+        text: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        success: typeof Schema.Boolean;
+        id: Schema.optional<typeof Schema.String>;
+        sentTo: typeof Schema.Number;
+    }>>;
+    readonly adminStats: import("../endpoint.js").Endpoint<"GET", "/email/admin/stats", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        period: Schema.Struct<{
+            days: typeof Schema.Number;
+            since: typeof Schema.String;
+        }>;
+        emails: Schema.Struct<{
+            total: typeof Schema.Number;
+            successful: typeof Schema.Number;
+            failed: typeof Schema.Number;
+            successRate: typeof Schema.Number;
+        }>;
+    }>>;
+};
+//# sourceMappingURL=email-admin.d.ts.map

package/dist/endpoints/email-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/email-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AA0C/B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6OtB,CAAA"}

package/dist/endpoints/email-admin.js

@@ -0,0 +1,253 @@
+/**
+ * Email Admin endpoints — Console-plane per-project template management,
+ * transactional send, scheduling, logs, suppressions, settings, and a handful
+ * of super-admin cross-project operations. Mirrors
+ * `apps/api/src/server/platform/routes/email/*`.
+ *
+ * Production mount: `/email/*` (see `apps/api/src/server/platform/app.ts`).
+ * Project-scoped routes accept a project ID or slug via `{id}`; send/schedule
+ * additionally accept a `projectId` body/query where the path doesn't carry
+ * one (not needed here — all sub-routes live under `/projects/:id`).
+ *
+ * Plane: `'management'` — distinct from BaaS `emailEndpoints` (plane:
+ * `'baas'`) which are served by the runtime for customer apps.
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { AddSuppressionInput, AdminEmailStatsResult, AdminSendEmailInput, AdminSendEmailResult, CancelScheduledEmailResult, CreateTemplateInput, EmailLogDetail, EmailSettings, EmailTemplateDetail, ListEmailLogsQuery, ListEmailLogsResult, ListScheduledEmailsQuery, ListScheduledEmailsResult, ListSuppressionsQuery, ListSuppressionsResult, ListTemplatesResult, RescheduleEmailInput, RescheduleEmailResult, ScheduledEmailDetail, ScheduledEmailStatsQuery, ScheduledEmailStatsResult, ScheduleEmailInput, ScheduleEmailResult, SendEmailAdminInput, SendEmailAdminResult, SendTemplatedEmailAdminInput, SendTemplatedEmailAdminResult, SendToUserInput, SuppressionItem, UpdateEmailSettingsInput, UpdateTemplateInput, } from '../schemas/email-admin.js';
+const ProjectPath = Schema.Struct({ id: Schema.String });
+const ProjectAndKeyPath = Schema.Struct({ id: Schema.String, key: Schema.String });
+const ProjectAndEmailPath = Schema.Struct({ id: Schema.String, email: Schema.String });
+const ProjectAndEmailIdPath = Schema.Struct({ id: Schema.String, emailId: Schema.String });
+const LogPath = Schema.Struct({ id: Schema.String, logId: Schema.String });
+export const emailAdminEndpoints = {
+    // Note: `GET /email/configured` is served by the BaaS `emailEndpoints.isConfigured`
+    // (same path, same route handler — the Console UI probes the same endpoint). No
+    // admin-only `isConfigured` entry is needed here.
+    // ── Templates ──────────────────────────────────────────────────────────
+    listTemplates: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/templates',
+        params: ProjectPath,
+        response: ListTemplatesResult,
+        plane: 'management',
+        summary: 'List email templates for a project',
+        tags: ['email-admin'],
+    }),
+    createTemplate: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/templates',
+        params: ProjectPath,
+        body: CreateTemplateInput,
+        response: EmailTemplateDetail,
+        plane: 'management',
+        summary: 'Create a new email template',
+        tags: ['email-admin'],
+    }),
+    getTemplate: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/templates/:key',
+        params: ProjectAndKeyPath,
+        response: EmailTemplateDetail,
+        plane: 'management',
+        summary: 'Get a single email template by key',
+        tags: ['email-admin'],
+    }),
+    updateTemplate: defineEndpoint({
+        method: 'PATCH',
+        path: '/email/projects/:id/templates/:key',
+        params: ProjectAndKeyPath,
+        body: UpdateTemplateInput,
+        response: EmailTemplateDetail,
+        plane: 'management',
+        summary: 'Update an email template',
+        tags: ['email-admin'],
+    }),
+    deleteTemplate: defineEndpoint({
+        method: 'DELETE',
+        path: '/email/projects/:id/templates/:key',
+        params: ProjectAndKeyPath,
+        response: EmailTemplateDetail,
+        plane: 'management',
+        summary: 'Delete an email template',
+        tags: ['email-admin'],
+    }),
+    // ── Send ───────────────────────────────────────────────────────────────
+    sendEmail: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/send',
+        params: ProjectPath,
+        body: SendEmailAdminInput,
+        response: SendEmailAdminResult,
+        plane: 'management',
+        summary: 'Send a custom email (Console)',
+        tags: ['email-admin'],
+    }),
+    sendTemplated: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/send-templated',
+        params: ProjectPath,
+        body: SendTemplatedEmailAdminInput,
+        response: SendTemplatedEmailAdminResult,
+        plane: 'management',
+        summary: 'Send a pre-defined templated email (Console)',
+        tags: ['email-admin'],
+    }),
+    sendToUser: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/send-to-user',
+        params: ProjectPath,
+        body: SendToUserInput,
+        response: SendEmailAdminResult,
+        plane: 'management',
+        summary: 'Send an email to a user by ID (Console)',
+        tags: ['email-admin'],
+    }),
+    // ── Scheduling ─────────────────────────────────────────────────────────
+    scheduleEmail: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/schedule',
+        params: ProjectPath,
+        body: ScheduleEmailInput,
+        response: ScheduleEmailResult,
+        plane: 'management',
+        summary: 'Schedule an email for future delivery',
+        tags: ['email-admin'],
+    }),
+    listScheduled: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/scheduled',
+        params: ProjectPath,
+        query: ListScheduledEmailsQuery,
+        response: ListScheduledEmailsResult,
+        plane: 'management',
+        summary: 'List scheduled emails',
+        tags: ['email-admin'],
+    }),
+    scheduledStats: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/scheduled/stats',
+        params: ProjectPath,
+        query: ScheduledEmailStatsQuery,
+        response: ScheduledEmailStatsResult,
+        plane: 'management',
+        summary: 'Get scheduled email statistics',
+        tags: ['email-admin'],
+    }),
+    getScheduled: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/scheduled/:emailId',
+        params: ProjectAndEmailIdPath,
+        response: ScheduledEmailDetail,
+        plane: 'management',
+        summary: 'Get a scheduled email by ID',
+        tags: ['email-admin'],
+    }),
+    cancelScheduled: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/scheduled/:emailId/cancel',
+        params: ProjectAndEmailIdPath,
+        response: CancelScheduledEmailResult,
+        plane: 'management',
+        summary: 'Cancel a pending scheduled email',
+        tags: ['email-admin'],
+    }),
+    rescheduleEmail: defineEndpoint({
+        method: 'PATCH',
+        path: '/email/projects/:id/scheduled/:emailId/reschedule',
+        params: ProjectAndEmailIdPath,
+        body: RescheduleEmailInput,
+        response: RescheduleEmailResult,
+        plane: 'management',
+        summary: 'Reschedule a pending scheduled email',
+        tags: ['email-admin'],
+    }),
+    // ── Logs ───────────────────────────────────────────────────────────────
+    listLogs: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/logs',
+        params: ProjectPath,
+        query: ListEmailLogsQuery,
+        response: ListEmailLogsResult,
+        plane: 'management',
+        summary: 'List email delivery logs for a project',
+        tags: ['email-admin'],
+    }),
+    getLog: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/logs/:logId',
+        params: LogPath,
+        response: EmailLogDetail,
+        plane: 'management',
+        summary: 'Get a single email log entry with events',
+        tags: ['email-admin'],
+    }),
+    // ── Suppressions ───────────────────────────────────────────────────────
+    listSuppressions: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/suppressions',
+        params: ProjectPath,
+        query: ListSuppressionsQuery,
+        response: ListSuppressionsResult,
+        plane: 'management',
+        summary: 'List email suppression entries for a project',
+        tags: ['email-admin'],
+    }),
+    addSuppression: defineEndpoint({
+        method: 'POST',
+        path: '/email/projects/:id/suppressions',
+        params: ProjectPath,
+        body: AddSuppressionInput,
+        response: SuppressionItem,
+        plane: 'management',
+        summary: 'Manually add an email to the suppression list',
+        tags: ['email-admin'],
+    }),
+    deleteSuppression: defineEndpoint({
+        method: 'DELETE',
+        path: '/email/projects/:id/suppressions/:email',
+        params: ProjectAndEmailPath,
+        response: SuppressionItem,
+        plane: 'management',
+        summary: 'Remove an email from the suppression list',
+        tags: ['email-admin'],
+    }),
+    // ── Settings ───────────────────────────────────────────────────────────
+    getSettings: defineEndpoint({
+        method: 'GET',
+        path: '/email/projects/:id/email-settings',
+        params: ProjectPath,
+        response: EmailSettings,
+        plane: 'management',
+        summary: 'Get per-project email settings',
+        tags: ['email-admin'],
+    }),
+    updateSettings: defineEndpoint({
+        method: 'PATCH',
+        path: '/email/projects/:id/email-settings',
+        params: ProjectPath,
+        body: UpdateEmailSettingsInput,
+        response: EmailSettings,
+        plane: 'management',
+        summary: 'Update per-project email settings',
+        tags: ['email-admin'],
+    }),
+    // ── Super-admin operations ─────────────────────────────────────────────
+    adminSend: defineEndpoint({
+        method: 'POST',
+        path: '/email/admin/send',
+        body: AdminSendEmailInput,
+        response: AdminSendEmailResult,
+        plane: 'admin',
+        summary: 'Admin send email to any address (super-admin only)',
+        tags: ['email-admin'],
+    }),
+    adminStats: defineEndpoint({
+        method: 'GET',
+        path: '/email/admin/stats',
+        response: AdminEmailStatsResult,
+        plane: 'admin',
+        summary: 'Admin email service statistics (super-admin only)',
+        tags: ['email-admin'],
+    }),
+};