@apollo-deploy/signal-schemas 1.0.0

package/dist/definitions/projects/schemas.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Apollo Signal — Internal project schemas (projects module).
+ *
+ * Zod schemas for project create/update/list requests and project response.
+ * Internal only — MUST NOT be exported to shared packages.
+ *
+ * Design §5 ; Requirements §1
+ */
+import { z } from "zod";
+export declare const CreateProjectBodySchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+}, z.core.$strip>;
+export declare const UpdateProjectBodySchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ListProjectsQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProjectIdParamSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export declare const SetTrackingDomainBodySchema: z.ZodObject<{
+    domain: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const TrackingDomainResponseSchema: z.ZodObject<{
+    trackingDomain: z.ZodNullable<z.ZodString>;
+    trackingDomainStatus: z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        verified: "verified";
+        failed: "failed";
+    }>>;
+    cnameRecord: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ProjectResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    status: z.ZodEnum<{
+        deleted: "deleted";
+        active: "active";
+        suspended: "suspended";
+        disabled: "disabled";
+    }>;
+    suspensionReason: z.ZodNullable<z.ZodString>;
+    region: z.ZodString;
+    limits: z.ZodObject<{
+        dailySends: z.ZodNumber;
+        perSecondSends: z.ZodNumber;
+        maxRecipientsPerMessage: z.ZodNumber;
+        maxDomains: z.ZodNumber;
+        maxApiKeys: z.ZodNumber;
+        maxWebhooks: z.ZodNumber;
+    }, z.core.$strip>;
+    createdByUserId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deletedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProjectListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        organizationId: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        status: z.ZodEnum<{
+            deleted: "deleted";
+            active: "active";
+            suspended: "suspended";
+            disabled: "disabled";
+        }>;
+        suspensionReason: z.ZodNullable<z.ZodString>;
+        region: z.ZodString;
+        limits: z.ZodObject<{
+            dailySends: z.ZodNumber;
+            perSecondSends: z.ZodNumber;
+            maxRecipientsPerMessage: z.ZodNumber;
+            maxDomains: z.ZodNumber;
+            maxApiKeys: z.ZodNumber;
+            maxWebhooks: z.ZodNumber;
+        }, z.core.$strip>;
+        createdByUserId: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        deletedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** Alias for {@link ProjectIdParamSchema} — canonical name per T-7.1. */
+export declare const ProjectParamsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, z.core.$strip>;
+/** Alias for {@link ListProjectsQuerySchema} — canonical name per T-7.1. */
+export declare const ProjectListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateProjectBody = z.infer<typeof CreateProjectBodySchema>;
+export type UpdateProjectBody = z.infer<typeof UpdateProjectBodySchema>;
+export type ListProjectsQuery = z.infer<typeof ListProjectsQuerySchema>;
+export type ProjectIdParam = z.infer<typeof ProjectIdParamSchema>;
+export type ProjectParams = ProjectIdParam;
+export type ProjectListQuery = ListProjectsQuery;
+export type ProjectResponse = z.infer<typeof ProjectResponseSchema>;
+export type ProjectListResponse = z.infer<typeof ProjectListResponseSchema>;
+export type SetTrackingDomainBody = z.infer<typeof SetTrackingDomainBodySchema>;
+export type TrackingDomainResponse = z.infer<typeof TrackingDomainResponseSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/definitions/projects/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/definitions/projects/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;iBAWtC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;iBAKvC,CAAC;AAMH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;iBAahC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGpC,CAAC;AAMH,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;;iBAAuB,CAAC;AAExD,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB;;;iBAA0B,CAAC;AAM9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAC3C,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/definitions/projects/schemas.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Apollo Signal — Internal project schemas (projects module).
+ *
+ * Zod schemas for project create/update/list requests and project response.
+ * Internal only — MUST NOT be exported to shared packages.
+ *
+ * Design §5 ; Requirements §1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectListQuerySchema = exports.ProjectParamsSchema = exports.ProjectListResponseSchema = exports.ProjectResponseSchema = exports.TrackingDomainResponseSchema = exports.SetTrackingDomainBodySchema = exports.ProjectIdParamSchema = exports.ListProjectsQuerySchema = exports.UpdateProjectBodySchema = exports.CreateProjectBodySchema = void 0;
+var zod_1 = require("zod");
+// ---------------------------------------------------------------------------
+// Shared sub-schemas
+// ---------------------------------------------------------------------------
+var ProjectLimitsSchema = zod_1.z.object({
+    dailySends: zod_1.z.number().int().min(1),
+    perSecondSends: zod_1.z.number().int().min(1),
+    maxRecipientsPerMessage: zod_1.z.number().int().min(1),
+    maxDomains: zod_1.z.number().int().min(1),
+    maxApiKeys: zod_1.z.number().int().min(1),
+    maxWebhooks: zod_1.z.number().int().min(1),
+});
+// ---------------------------------------------------------------------------
+// Request schemas
+// ---------------------------------------------------------------------------
+exports.CreateProjectBodySchema = zod_1.z.object({
+    name: zod_1.z.string().min(1).max(255),
+    slug: zod_1.z.string().min(1).max(100).regex(/^[a-z0-9-]+$/, "Slug must be lowercase alphanumeric with hyphens"),
+});
+exports.UpdateProjectBodySchema = zod_1.z.object({
+    name: zod_1.z.string().min(1).max(255).optional(),
+    slug: zod_1.z.string().min(1).max(100).regex(/^[a-z0-9-]+$/).optional(),
+});
+exports.ListProjectsQuerySchema = zod_1.z.object({
+    limit: zod_1.z.coerce.number().int().min(1).max(100).default(25),
+    cursor: zod_1.z.string().optional(),
+});
+exports.ProjectIdParamSchema = zod_1.z.object({
+    projectId: zod_1.z.string().min(1),
+});
+exports.SetTrackingDomainBodySchema = zod_1.z.object({
+    /**
+     * Hostname only — no scheme or trailing slash (e.g. "track.acme.com").
+     * Pass null to remove the custom tracking domain.
+     */
+    domain: zod_1.z
+        .string()
+        .min(1)
+        .max(253)
+        .regex(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/, "Must be a valid hostname")
+        .nullable(),
+});
+exports.TrackingDomainResponseSchema = zod_1.z.object({
+    trackingDomain: zod_1.z.string().nullable(),
+    trackingDomainStatus: zod_1.z.enum(["pending", "verified", "failed"]).nullable(),
+    /** The CNAME record the user must publish to verify the domain. Null when no domain is set or no CNAME target is configured. */
+    cnameRecord: zod_1.z.object({ name: zod_1.z.string(), value: zod_1.z.string() }).nullable(),
+});
+// ---------------------------------------------------------------------------
+// Response schema
+// ---------------------------------------------------------------------------
+exports.ProjectResponseSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    organizationId: zod_1.z.string(),
+    name: zod_1.z.string(),
+    slug: zod_1.z.string(),
+    status: zod_1.z.enum(["active", "suspended", "disabled", "deleted"]),
+    suspensionReason: zod_1.z.string().nullable(),
+    region: zod_1.z.string(),
+    limits: ProjectLimitsSchema,
+    createdByUserId: zod_1.z.string(),
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+    deletedAt: zod_1.z.string().datetime().nullable(),
+});
+exports.ProjectListResponseSchema = zod_1.z.object({
+    data: zod_1.z.array(exports.ProjectResponseSchema),
+    nextCursor: zod_1.z.string().nullable(),
+});
+// ---------------------------------------------------------------------------
+// Aliases (task-spec canonical names)
+// ---------------------------------------------------------------------------
+/** Alias for {@link ProjectIdParamSchema} — canonical name per T-7.1. */
+exports.ProjectParamsSchema = exports.ProjectIdParamSchema;
+/** Alias for {@link ListProjectsQuerySchema} — canonical name per T-7.1. */
+exports.ProjectListQuerySchema = exports.ListProjectsQuerySchema;

package/dist/definitions/signal-email/domain.schema.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Apollo Signal — Email Domain Schema Definitions
+ *
+ * Stable wire contracts for the Apollo Signal transactional email service.
+ * These types cross the backend-to-client boundary and are consumed by the
+ * TypeScript SDK and the web client.
+ *
+ * Scope: only the public /v1/emails* surface and the outbound webhook
+ * delivery payload. Dashboard-only types (/signal/*) are backend-private
+ * and live in apps/signal/src/modules/<module>/contracts/internal/.
+ */
+import { z } from 'zod';
+import { NullableIsoDateStringSchema } from '../common.js';
+/**
+ * Lifecycle status of a transactional email.
+ *
+ * queued     - accepted, pending SES submission
+ * scheduled  - deferred send, waiting for scheduled delivery time
+ * cancelled  - scheduled send cancelled before delivery
+ * sent       - submitted to SES successfully
+ * delivered  - SES confirmed delivery to the recipient MTA
+ * bounced    - permanent or transient bounce received from SES
+ * complained - spam complaint received from SES
+ * failed     - SES submission failed (non-retryable)
+ * rejected   - rejected before SES (suppressed recipient, reserved domain, etc.)
+ * suppressed - blocked by the project suppression list
+ * test       - sent in test mode; no SES call was made
+ */
+export declare const SignalEmailStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    queued: "queued";
+    scheduled: "scheduled";
+    cancelled: "cancelled";
+    sent: "sent";
+    delivered: "delivered";
+    bounced: "bounced";
+    complained: "complained";
+    rejected: "rejected";
+    suppressed: "suppressed";
+    test: "test";
+}>;
+/**
+ * Types of events that can appear on an email's timeline and in webhook
+ * delivery payloads.
+ */
+export declare const SignalEmailEventTypeSchema: z.ZodEnum<{
+    "email.queued": "email.queued";
+    "email.sent": "email.sent";
+    "email.delivered": "email.delivered";
+    "email.bounced": "email.bounced";
+    "email.complained": "email.complained";
+    "email.opened": "email.opened";
+    "email.clicked": "email.clicked";
+    "email.failed": "email.failed";
+    "email.rejected": "email.rejected";
+    "email.delivery_delayed": "email.delivery_delayed";
+    "email.suppressed": "email.suppressed";
+    "email.test": "email.test";
+}>;
+/**
+ * All event types that can be delivered to a webhook endpoint.
+ * Includes "webhook.test" for the test-delivery endpoint.
+ */
+export declare const SignalWebhookEventTypeSchema: z.ZodEnum<{
+    "email.queued": "email.queued";
+    "email.sent": "email.sent";
+    "email.delivered": "email.delivered";
+    "email.bounced": "email.bounced";
+    "email.complained": "email.complained";
+    "email.opened": "email.opened";
+    "email.clicked": "email.clicked";
+    "email.failed": "email.failed";
+    "email.rejected": "email.rejected";
+    "email.delivery_delayed": "email.delivery_delayed";
+    "email.suppressed": "email.suppressed";
+    "email.test": "email.test";
+    "webhook.test": "webhook.test";
+}>;
+/**
+ * The canonical payload shape delivered to customer webhook endpoints.
+ *
+ * Signed with HMAC-SHA-256; the signature is in the
+ * X-Apollo-Signal-Signature header (v1=<hex>).
+ */
+export declare const SignalWebhookDeliveryPayloadSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        "email.queued": "email.queued";
+        "email.sent": "email.sent";
+        "email.delivered": "email.delivered";
+        "email.bounced": "email.bounced";
+        "email.complained": "email.complained";
+        "email.opened": "email.opened";
+        "email.clicked": "email.clicked";
+        "email.failed": "email.failed";
+        "email.rejected": "email.rejected";
+        "email.delivery_delayed": "email.delivery_delayed";
+        "email.suppressed": "email.suppressed";
+        "email.test": "email.test";
+        "webhook.test": "webhook.test";
+    }>;
+    createdAt: z.ZodString;
+    data: z.ZodObject<{
+        emailId: z.ZodString;
+        messageId: z.ZodNullable<z.ZodString>;
+        from: z.ZodString;
+        to: z.ZodArray<z.ZodString>;
+        subject: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            scheduled: "scheduled";
+            cancelled: "cancelled";
+            sent: "sent";
+            delivered: "delivered";
+            bounced: "bounced";
+            complained: "complained";
+            rejected: "rejected";
+            suppressed: "suppressed";
+            test: "test";
+        }>;
+        metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SignalEmailStatus = z.infer<typeof SignalEmailStatusSchema>;
+export type SignalEmailEventType = z.infer<typeof SignalEmailEventTypeSchema>;
+export type SignalWebhookEventType = z.infer<typeof SignalWebhookEventTypeSchema>;
+export type SignalWebhookDeliveryPayload = z.infer<typeof SignalWebhookDeliveryPayloadSchema>;
+/**
+ * The data sub-object of a webhook delivery payload.
+ * Consumers can derive this type without re-importing the parent schema.
+ */
+export type SignalWebhookDeliveryPayloadData = SignalWebhookDeliveryPayload['data'];
+export { NullableIsoDateStringSchema as SignalNullableIsoDateStringSchema };
+//# sourceMappingURL=domain.schema.d.ts.map

package/dist/definitions/signal-email/domain.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.schema.d.ts","sourceRoot":"","sources":["../../../src/definitions/signal-email/domain.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAuB,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAMhF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAYlC,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;EAarC,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;EAcvC,CAAC;AAMH;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgC7C,CAAC;AAMH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAGpF,OAAO,EAAE,2BAA2B,IAAI,iCAAiC,EAAE,CAAC"}

package/dist/definitions/signal-email/domain.schema.js

@@ -0,0 +1,130 @@
+/**
+ * Apollo Signal — Email Domain Schema Definitions
+ *
+ * Stable wire contracts for the Apollo Signal transactional email service.
+ * These types cross the backend-to-client boundary and are consumed by the
+ * TypeScript SDK and the web client.
+ *
+ * Scope: only the public /v1/emails* surface and the outbound webhook
+ * delivery payload. Dashboard-only types (/signal/*) are backend-private
+ * and live in apps/signal/src/modules/<module>/contracts/internal/.
+ */
+import { z } from 'zod';
+import { IsoDateStringSchema, NullableIsoDateStringSchema } from '../common.js';
+// ---------------------------------------------------------------------------
+// Email status
+// ---------------------------------------------------------------------------
+/**
+ * Lifecycle status of a transactional email.
+ *
+ * queued     - accepted, pending SES submission
+ * scheduled  - deferred send, waiting for scheduled delivery time
+ * cancelled  - scheduled send cancelled before delivery
+ * sent       - submitted to SES successfully
+ * delivered  - SES confirmed delivery to the recipient MTA
+ * bounced    - permanent or transient bounce received from SES
+ * complained - spam complaint received from SES
+ * failed     - SES submission failed (non-retryable)
+ * rejected   - rejected before SES (suppressed recipient, reserved domain, etc.)
+ * suppressed - blocked by the project suppression list
+ * test       - sent in test mode; no SES call was made
+ */
+export const SignalEmailStatusSchema = z.enum([
+    'queued',
+    'scheduled',
+    'cancelled',
+    'sent',
+    'delivered',
+    'bounced',
+    'complained',
+    'failed',
+    'rejected',
+    'suppressed',
+    'test',
+]);
+// ---------------------------------------------------------------------------
+// Email event type
+// ---------------------------------------------------------------------------
+/**
+ * Types of events that can appear on an email's timeline and in webhook
+ * delivery payloads.
+ */
+export const SignalEmailEventTypeSchema = z.enum([
+    'email.queued',
+    'email.sent',
+    'email.delivered',
+    'email.bounced',
+    'email.complained',
+    'email.opened',
+    'email.clicked',
+    'email.failed',
+    'email.rejected',
+    'email.delivery_delayed',
+    'email.suppressed',
+    'email.test',
+]);
+// ---------------------------------------------------------------------------
+// Webhook event type (superset of email event types)
+// ---------------------------------------------------------------------------
+/**
+ * All event types that can be delivered to a webhook endpoint.
+ * Includes "webhook.test" for the test-delivery endpoint.
+ */
+export const SignalWebhookEventTypeSchema = z.enum([
+    'email.queued',
+    'email.sent',
+    'email.delivered',
+    'email.bounced',
+    'email.complained',
+    'email.opened',
+    'email.clicked',
+    'email.failed',
+    'email.rejected',
+    'email.delivery_delayed',
+    'email.suppressed',
+    'email.test',
+    'webhook.test',
+]);
+// ---------------------------------------------------------------------------
+// Webhook delivery payload
+// ---------------------------------------------------------------------------
+/**
+ * The canonical payload shape delivered to customer webhook endpoints.
+ *
+ * Signed with HMAC-SHA-256; the signature is in the
+ * X-Apollo-Signal-Signature header (v1=<hex>).
+ */
+export const SignalWebhookDeliveryPayloadSchema = z.object({
+    /** Stable event ID (evt_<crockford-base32>). */
+    id: z.string(),
+    /** Event type that triggered this delivery. */
+    type: SignalWebhookEventTypeSchema,
+    /** ISO 8601 timestamp when the event was recorded. */
+    createdAt: IsoDateStringSchema,
+    data: z.object({
+        /** Email ID (email_<crockford-base32>). */
+        emailId: z.string(),
+        /** SES message ID, present after successful submission. */
+        messageId: z.string().nullable(),
+        /** Sender address as supplied in the send request. */
+        from: z.string(),
+        /** Primary recipient addresses. */
+        to: z.array(z.string()),
+        /** Email subject line. */
+        subject: z.string(),
+        /** Final email status at the time of this event. */
+        status: SignalEmailStatusSchema,
+        /** Caller-supplied metadata from the original send request. */
+        metadata: z.record(z.string(), z.string()).nullable(),
+    }),
+});
+// Re-exported for consumers that need nullable datetime fields in derived schemas.
+export { NullableIsoDateStringSchema as SignalNullableIsoDateStringSchema };
+// ---------------------------------------------------------------------------
+// Schema registry — promotes types to OpenAPI components/schemas
+// ---------------------------------------------------------------------------
+z.globalRegistry.add(SignalEmailStatusSchema, { id: 'SignalEmailStatus' });
+z.globalRegistry.add(SignalEmailEventTypeSchema, { id: 'SignalEmailEventType' });
+z.globalRegistry.add(SignalWebhookEventTypeSchema, { id: 'SignalWebhookEventType' });
+z.globalRegistry.add(SignalWebhookDeliveryPayloadSchema, { id: 'SignalWebhookDeliveryPayload' });
+//# sourceMappingURL=domain.schema.js.map

package/dist/definitions/signal-email/domain.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.schema.js","sourceRoot":"","sources":["../../../src/definitions/signal-email/domain.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC5C,QAAQ;IACR,WAAW;IACX,WAAW;IACX,MAAM;IACN,WAAW;IACX,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,MAAM;CACP,CAAC,CAAC;AAEH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/C,cAAc;IACd,YAAY;IACZ,iBAAiB;IACjB,eAAe;IACf,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,wBAAwB;IACxB,kBAAkB;IAClB,YAAY;CACb,CAAC,CAAC;AAEH,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,IAAI,CAAC;IACjD,cAAc;IACd,YAAY;IACZ,iBAAiB;IACjB,eAAe;IACf,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,wBAAwB;IACxB,kBAAkB;IAClB,YAAY;IACZ,cAAc;CACf,CAAC,CAAC;AAEH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,gDAAgD;IAChD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAEd,+CAA+C;IAC/C,IAAI,EAAE,4BAA4B;IAElC,sDAAsD;IACtD,SAAS,EAAE,mBAAmB;IAE9B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,2CAA2C;QAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QAEnB,2DAA2D;QAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAEhC,sDAAsD;QACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAEhB,mCAAmC;QACnC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAEvB,0BAA0B;QAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QAEnB,oDAAoD;QACpD,MAAM,EAAE,uBAAuB;QAE/B,+DAA+D;QAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACtD,CAAC;CACH,CAAC,CAAC;AAiBH,mFAAmF;AACnF,OAAO,EAAE,2BAA2B,IAAI,iCAAiC,EAAE,CAAC;AAE5E,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAC3E,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,0BAA0B,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;AACjF,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,4BAA4B,EAAE,EAAE,EAAE,EAAE,wBAAwB,EAAE,CAAC,CAAC;AACrF,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,EAAE,EAAE,8BAA8B,EAAE,CAAC,CAAC","sourcesContent":["/**\n * Apollo Signal — Email Domain Schema Definitions\n *\n * Stable wire contracts for the Apollo Signal transactional email service.\n * These types cross the backend-to-client boundary and are consumed by the\n * TypeScript SDK and the web client.\n *\n * Scope: only the public /v1/emails* surface and the outbound webhook\n * delivery payload. Dashboard-only types (/signal/*) are backend-private\n * and live in apps/signal/src/modules/<module>/contracts/internal/.\n */\n\nimport { z } from 'zod';\n\nimport { IsoDateStringSchema, NullableIsoDateStringSchema } from '../common.js';\n\n// ---------------------------------------------------------------------------\n// Email status\n// ---------------------------------------------------------------------------\n\n/**\n * Lifecycle status of a transactional email.\n *\n * queued     - accepted, pending SES submission\n * scheduled  - deferred send, waiting for scheduled delivery time\n * cancelled  - scheduled send cancelled before delivery\n * sent       - submitted to SES successfully\n * delivered  - SES confirmed delivery to the recipient MTA\n * bounced    - permanent or transient bounce received from SES\n * complained - spam complaint received from SES\n * failed     - SES submission failed (non-retryable)\n * rejected   - rejected before SES (suppressed recipient, reserved domain, etc.)\n * suppressed - blocked by the project suppression list\n * test       - sent in test mode; no SES call was made\n */\nexport const SignalEmailStatusSchema = z.enum([\n  'queued',\n  'scheduled',\n  'cancelled',\n  'sent',\n  'delivered',\n  'bounced',\n  'complained',\n  'failed',\n  'rejected',\n  'suppressed',\n  'test',\n]);\n\n// ---------------------------------------------------------------------------\n// Email event type\n// ---------------------------------------------------------------------------\n\n/**\n * Types of events that can appear on an email's timeline and in webhook\n * delivery payloads.\n */\nexport const SignalEmailEventTypeSchema = z.enum([\n  'email.queued',\n  'email.sent',\n  'email.delivered',\n  'email.bounced',\n  'email.complained',\n  'email.opened',\n  'email.clicked',\n  'email.failed',\n  'email.rejected',\n  'email.delivery_delayed',\n  'email.suppressed',\n  'email.test',\n]);\n\n// ---------------------------------------------------------------------------\n// Webhook event type (superset of email event types)\n// ---------------------------------------------------------------------------\n\n/**\n * All event types that can be delivered to a webhook endpoint.\n * Includes \"webhook.test\" for the test-delivery endpoint.\n */\nexport const SignalWebhookEventTypeSchema = z.enum([\n  'email.queued',\n  'email.sent',\n  'email.delivered',\n  'email.bounced',\n  'email.complained',\n  'email.opened',\n  'email.clicked',\n  'email.failed',\n  'email.rejected',\n  'email.delivery_delayed',\n  'email.suppressed',\n  'email.test',\n  'webhook.test',\n]);\n\n// ---------------------------------------------------------------------------\n// Webhook delivery payload\n// ---------------------------------------------------------------------------\n\n/**\n * The canonical payload shape delivered to customer webhook endpoints.\n *\n * Signed with HMAC-SHA-256; the signature is in the\n * X-Apollo-Signal-Signature header (v1=<hex>).\n */\nexport const SignalWebhookDeliveryPayloadSchema = z.object({\n  /** Stable event ID (evt_<crockford-base32>). */\n  id: z.string(),\n\n  /** Event type that triggered this delivery. */\n  type: SignalWebhookEventTypeSchema,\n\n  /** ISO 8601 timestamp when the event was recorded. */\n  createdAt: IsoDateStringSchema,\n\n  data: z.object({\n    /** Email ID (email_<crockford-base32>). */\n    emailId: z.string(),\n\n    /** SES message ID, present after successful submission. */\n    messageId: z.string().nullable(),\n\n    /** Sender address as supplied in the send request. */\n    from: z.string(),\n\n    /** Primary recipient addresses. */\n    to: z.array(z.string()),\n\n    /** Email subject line. */\n    subject: z.string(),\n\n    /** Final email status at the time of this event. */\n    status: SignalEmailStatusSchema,\n\n    /** Caller-supplied metadata from the original send request. */\n    metadata: z.record(z.string(), z.string()).nullable(),\n  }),\n});\n\n// ---------------------------------------------------------------------------\n// Inferred TypeScript types\n// ---------------------------------------------------------------------------\n\nexport type SignalEmailStatus = z.infer<typeof SignalEmailStatusSchema>;\nexport type SignalEmailEventType = z.infer<typeof SignalEmailEventTypeSchema>;\nexport type SignalWebhookEventType = z.infer<typeof SignalWebhookEventTypeSchema>;\nexport type SignalWebhookDeliveryPayload = z.infer<typeof SignalWebhookDeliveryPayloadSchema>;\n\n/**\n * The data sub-object of a webhook delivery payload.\n * Consumers can derive this type without re-importing the parent schema.\n */\nexport type SignalWebhookDeliveryPayloadData = SignalWebhookDeliveryPayload['data'];\n\n// Re-exported for consumers that need nullable datetime fields in derived schemas.\nexport { NullableIsoDateStringSchema as SignalNullableIsoDateStringSchema };\n\n// ---------------------------------------------------------------------------\n// Schema registry — promotes types to OpenAPI components/schemas\n// ---------------------------------------------------------------------------\n\nz.globalRegistry.add(SignalEmailStatusSchema, { id: 'SignalEmailStatus' });\nz.globalRegistry.add(SignalEmailEventTypeSchema, { id: 'SignalEmailEventType' });\nz.globalRegistry.add(SignalWebhookEventTypeSchema, { id: 'SignalWebhookEventType' });\nz.globalRegistry.add(SignalWebhookDeliveryPayloadSchema, { id: 'SignalWebhookDeliveryPayload' });\n"]}

package/dist/definitions/signal-email/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Apollo Signal — Email Schemas
+ *
+ * Public wire contracts for the Apollo Signal transactional email service.
+ *
+ * Subpath: @apollo-deploy/signal-schemas/signal-email
+ *
+ * Scope: only the public /v1/emails* API surface and the outbound webhook
+ * delivery payload. Dashboard-only types (/signal/*) are backend-private
+ * and live in apps/signal/src/modules/<module>/contracts/internal/.
+ *
+ * @example
+ * import {
+ *   SignalSendEmailBodySchema,
+ *   SignalEmailResourceSchema,
+ *   type SignalSendEmailBody,
+ *   type SignalEmailResource,
+ * } from '@apollo-deploy/signal-schemas/signal-email';
+ */
+export { SignalEmailStatusSchema, SignalEmailEventTypeSchema, SignalWebhookEventTypeSchema, SignalWebhookDeliveryPayloadSchema, SignalNullableIsoDateStringSchema, type SignalEmailStatus, type SignalEmailEventType, type SignalWebhookEventType, type SignalWebhookDeliveryPayload, type SignalWebhookDeliveryPayloadData, } from './domain.schema.js';
+export { SignalSendEmailBodySchema, SignalGetEmailParamsSchema, SignalBatchSendEmailBodySchema, type SignalSendEmailBody, type SignalGetEmailParams, type SignalBatchSendEmailBody, } from './request.schema.js';
+export { SignalSendEmailResponseSchema, SignalEmailResourceSchema, type SignalSendEmailResponse, type SignalEmailResource, } from './response.schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/definitions/signal-email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/definitions/signal-email/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,kCAAkC,EAClC,iCAAiC,EACjC,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,GACtC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/definitions/signal-email/index.js

@@ -0,0 +1,26 @@
+/**
+ * Apollo Signal — Email Schemas
+ *
+ * Public wire contracts for the Apollo Signal transactional email service.
+ *
+ * Subpath: @apollo-deploy/signal-schemas/signal-email
+ *
+ * Scope: only the public /v1/emails* API surface and the outbound webhook
+ * delivery payload. Dashboard-only types (/signal/*) are backend-private
+ * and live in apps/signal/src/modules/<module>/contracts/internal/.
+ *
+ * @example
+ * import {
+ *   SignalSendEmailBodySchema,
+ *   SignalEmailResourceSchema,
+ *   type SignalSendEmailBody,
+ *   type SignalEmailResource,
+ * } from '@apollo-deploy/signal-schemas/signal-email';
+ */
+// Domain schemas and types
+export { SignalEmailStatusSchema, SignalEmailEventTypeSchema, SignalWebhookEventTypeSchema, SignalWebhookDeliveryPayloadSchema, SignalNullableIsoDateStringSchema, } from './domain.schema.js';
+// Request schemas and types
+export { SignalSendEmailBodySchema, SignalGetEmailParamsSchema, SignalBatchSendEmailBodySchema, } from './request.schema.js';
+// Response schemas and types
+export { SignalSendEmailResponseSchema, SignalEmailResourceSchema, } from './response.schema.js';
+//# sourceMappingURL=index.js.map

package/dist/definitions/signal-email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/definitions/signal-email/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,2BAA2B;AAC3B,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,kCAAkC,EAClC,iCAAiC,GAMlC,MAAM,oBAAoB,CAAC;AAE5B,4BAA4B;AAC5B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,GAI/B,MAAM,qBAAqB,CAAC;AAE7B,6BAA6B;AAC7B,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,GAG1B,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * Apollo Signal — Email Schemas\n *\n * Public wire contracts for the Apollo Signal transactional email service.\n *\n * Subpath: @apollo-deploy/signal-schemas/signal-email\n *\n * Scope: only the public /v1/emails* API surface and the outbound webhook\n * delivery payload. Dashboard-only types (/signal/*) are backend-private\n * and live in apps/signal/src/modules/<module>/contracts/internal/.\n *\n * @example\n * import {\n *   SignalSendEmailBodySchema,\n *   SignalEmailResourceSchema,\n *   type SignalSendEmailBody,\n *   type SignalEmailResource,\n * } from '@apollo-deploy/signal-schemas/signal-email';\n */\n\n// Domain schemas and types\nexport {\n  SignalEmailStatusSchema,\n  SignalEmailEventTypeSchema,\n  SignalWebhookEventTypeSchema,\n  SignalWebhookDeliveryPayloadSchema,\n  SignalNullableIsoDateStringSchema,\n  type SignalEmailStatus,\n  type SignalEmailEventType,\n  type SignalWebhookEventType,\n  type SignalWebhookDeliveryPayload,\n  type SignalWebhookDeliveryPayloadData,\n} from './domain.schema.js';\n\n// Request schemas and types\nexport {\n  SignalSendEmailBodySchema,\n  SignalGetEmailParamsSchema,\n  SignalBatchSendEmailBodySchema,\n  type SignalSendEmailBody,\n  type SignalGetEmailParams,\n  type SignalBatchSendEmailBody,\n} from './request.schema.js';\n\n// Response schemas and types\nexport {\n  SignalSendEmailResponseSchema,\n  SignalEmailResourceSchema,\n  type SignalSendEmailResponse,\n  type SignalEmailResource,\n} from './response.schema.js';\n"]}