@endora-commerce/contracts 0.100.0

package/dist/transactional-emails.js

@@ -0,0 +1,212 @@
+// Transactional Emails — contract surface (feature 047).
+//
+// Source-of-truth Zod schemas + inferred types shared by backend (routes,
+// reconciler, sender port) and admin (API client). Content trees are opaque
+// Puck data; their email-safe component set is owned by @endora-commerce/email-components.
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Shared primitives
+// ---------------------------------------------------------------------------
+/** Opaque Puck data tree for one language. */
+export const puckDataTreeSchema = z.record(z.string(), z.unknown());
+export const transactionalEmailCodeRe = /^[a-z][a-z0-9_]*$/;
+/** A variable an email declares for substitution + preview sample data. */
+export const emailVariableDescriptorSchema = z.object({
+    key: z.string().min(1).max(160),
+    label: z.string().min(1).max(200),
+    sampleValue: z.string().max(2000).optional(),
+    description: z.string().max(500).optional(),
+});
+// ---------------------------------------------------------------------------
+// Manifest declaration (consumed by ModuleManifest.transactionalEmails)
+// ---------------------------------------------------------------------------
+export const transactionalEmailManifestEntrySchema = z.object({
+    code: z.string().regex(transactionalEmailCodeRe).max(160),
+    name: z.string().min(1).max(200),
+    description: z.string().max(2000).optional(),
+    group: z.string().max(64).optional(),
+    variables: z.array(emailVariableDescriptorSchema).default([]),
+});
+// ---------------------------------------------------------------------------
+// Definitions — list + detail
+// ---------------------------------------------------------------------------
+/**
+ * Whether an operator may switch this one email off, and why not (issue #89).
+ *
+ * Deliberately the same pair of field names `ModulePresenceSchema` uses for the
+ * module axis: the two refusals are the same statement at two granularities,
+ * and an admin that renders one can render the other without learning a second
+ * vocabulary. The reason is the owning module's own sentence, carried from the
+ * `EmailDefaultsRegistry` — no frontend holds a list of protected codes.
+ */
+export const transactionalEmailProtectionSchema = z.object({
+    deactivatable: z.boolean(),
+    nonDeactivatableReason: z.string().nullable(),
+});
+export const transactionalEmailSummarySchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    ownerModule: z.string(),
+    group: z.string().nullable(),
+    active: z.boolean(),
+    languages: z.array(z.string()),
+    hasGlobalOverride: z.boolean(),
+    hasChannelOverride: z.boolean(),
+}).extend(transactionalEmailProtectionSchema.shape);
+export const transactionalEmailListResponseSchema = z.object({
+    items: z.array(transactionalEmailSummarySchema),
+});
+export const resolvedEmailContentSchema = z.object({
+    subject: z.string(),
+    content: puckDataTreeSchema,
+    source: z.enum(['channel', 'global', 'default']),
+    version: z.number().int().nullable(),
+});
+export const transactionalEmailDetailSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+    ownerModule: z.string(),
+    group: z.string().nullable(),
+    description: z.string().nullable(),
+    active: z.boolean(),
+    languages: z.array(z.string()),
+    variables: z.array(emailVariableDescriptorSchema),
+    scope: z.object({ salesChannelId: z.string().nullable(), language: z.string() }),
+    effective: resolvedEmailContentSchema,
+    default: z.object({ subject: z.string(), content: puckDataTreeSchema }),
+    hasGlobalOverride: z.boolean(),
+    hasChannelOverride: z.boolean(),
+}).extend(transactionalEmailProtectionSchema.shape);
+export const transactionalEmailDetailQuerySchema = z.object({
+    salesChannelId: z.string().uuid().optional(),
+    language: z.string().min(2).max(12).optional(),
+});
+// ---------------------------------------------------------------------------
+// Save / reset content
+// ---------------------------------------------------------------------------
+export const putEmailContentQuerySchema = z.object({
+    salesChannelId: z.string().uuid().optional(),
+    language: z.string().min(2).max(12),
+});
+export const putEmailContentRequestSchema = z.object({
+    subject: z.string().min(1).max(500),
+    content: puckDataTreeSchema,
+    expectedVersion: z.number().int().optional(),
+});
+// ---------------------------------------------------------------------------
+// Per-email activation (issue #89)
+// ---------------------------------------------------------------------------
+/**
+ * The operator's per-email on/off switch.
+ *
+ * The module that owns this surface is non-deactivatable (issue #88), because
+ * the granularity the business wants is this one: an operator silences the
+ * back-in-stock notice without silencing account verification. The read side
+ * has honoured `active` since feature 047; this is the write side.
+ *
+ * Shaped like `ModuleActivationRequestSchema` — one boolean, stated rather than
+ * toggled, so a retry lands on the state the operator asked for instead of the
+ * opposite one.
+ */
+export const setTransactionalEmailActiveRequestSchema = z.object({ active: z.boolean() });
+/** The recomputed summary, so the list re-reads what the server resolved. */
+export const setTransactionalEmailActiveResponseSchema = transactionalEmailSummarySchema;
+// ---------------------------------------------------------------------------
+// Preview
+// ---------------------------------------------------------------------------
+export const previewEmailRequestSchema = z.object({
+    salesChannelId: z.string().uuid().optional(),
+    language: z.string().min(2).max(12).optional(),
+    draftSubject: z.string().max(500).optional(),
+    draftContent: puckDataTreeSchema.optional(),
+});
+export const previewEmailResponseSchema = z.object({
+    subject: z.string(),
+    html: z.string(),
+    text: z.string(),
+});
+// ---------------------------------------------------------------------------
+// Reusable blocks & templates
+// ---------------------------------------------------------------------------
+export const emailBlockSummarySchema = z.object({
+    id: z.string(),
+    code: z.string(),
+    name: z.string(),
+    active: z.boolean(),
+    isSystem: z.boolean(),
+    scope: z.enum(['global', 'channel']),
+    languages: z.array(z.string()),
+    version: z.number().int(),
+});
+export const emailBlockDetailSchema = emailBlockSummarySchema.extend({
+    description: z.string().nullable(),
+    content: z.record(z.string(), puckDataTreeSchema),
+    salesChannelIds: z.array(z.string()),
+});
+export const createEmailBlockRequestSchema = z.object({
+    code: z.string().min(1).max(180),
+    name: z.string().min(1).max(200),
+    description: z.string().max(2000).optional(),
+    active: z.boolean().optional(),
+    salesChannelIds: z.array(z.string().uuid()).optional(),
+    languages: z.array(z.string().min(2).max(12)).min(1),
+});
+export const patchEmailBlockRequestSchema = z
+    .object({
+    name: z.string().min(1).max(200).optional(),
+    description: z.string().max(2000).nullable().optional(),
+    active: z.boolean().optional(),
+    salesChannelIds: z.array(z.string().uuid()).optional(),
+    expectedVersion: z.number().int().optional(),
+})
+    .refine((v) => Object.keys(v).length > 0, { message: 'at least one field required' });
+export const putEmailBlockContentRequestSchema = z.object({
+    content: puckDataTreeSchema,
+    expectedVersion: z.number().int(),
+});
+// Templates reuse the block surface, minus the `active` flag.
+export const emailTemplateSummarySchema = emailBlockSummarySchema.omit({ active: true });
+export const emailTemplateDetailSchema = emailBlockDetailSchema.omit({ active: true });
+export const createEmailTemplateRequestSchema = createEmailBlockRequestSchema.omit({ active: true });
+export const patchEmailTemplateRequestSchema = z
+    .object({
+    name: z.string().min(1).max(200).optional(),
+    description: z.string().max(2000).nullable().optional(),
+    salesChannelIds: z.array(z.string().uuid()).optional(),
+    expectedVersion: z.number().int().optional(),
+})
+    .refine((v) => Object.keys(v).length > 0, { message: 'at least one field required' });
+// ---------------------------------------------------------------------------
+// Branding (per scope) — wraps Settings
+// ---------------------------------------------------------------------------
+export const emailBrandingSchema = z.object({
+    salesChannelId: z.string().nullable(),
+    logoAssetId: z.string(),
+    logoUrl: z.string(),
+    accentColor: z.string(),
+    headerBlockCode: z.string(),
+    footerBlockCode: z.string(),
+    source: z.enum(['channel', 'global', 'default']),
+});
+export const putEmailBrandingRequestSchema = z
+    .object({
+    logoAssetId: z.string().optional(),
+    accentColor: z.string().max(32).optional(),
+    headerBlockCode: z.string().max(180).optional(),
+    footerBlockCode: z.string().max(180).optional(),
+})
+    .refine((v) => Object.keys(v).length > 0, { message: 'at least one field required' });
+export const emailScopeQuerySchema = z.object({
+    salesChannelId: z.string().uuid().optional(),
+});
+// ---------------------------------------------------------------------------
+// Email page-builder descriptor (email-safe palette)
+// ---------------------------------------------------------------------------
+export const emailPageBuilderDescriptorSchema = z.object({
+    schemaVersion: z.number().int(),
+    components: z.array(z.object({
+        name: z.string(),
+        previewIcon: z.string().optional(),
+    })),
+});
+//# sourceMappingURL=transactional-emails.js.map

package/dist/transactional-emails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-emails.js","sourceRoot":"","sources":["../src/transactional-emails.ts"],"names":[],"mappings":"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"}

package/dist/webhooks.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+/**
+ * Webhook + WebhookDelivery contracts (US7 / FR-121).
+ */
+export declare const webhookStatusSchema: z.ZodEnum<{
+    active: "active";
+    paused: "paused";
+}>;
+export type WebhookStatus = z.infer<typeof webhookStatusSchema>;
+export declare const webhookSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    url: z.ZodString;
+    eventTypes: z.ZodArray<z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        paused: "paused";
+    }>;
+    organizationId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Webhook = z.infer<typeof webhookSchema>;
+export declare const createWebhookRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+    eventTypes: z.ZodArray<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CreateWebhookRequest = z.infer<typeof createWebhookRequestSchema>;
+export declare const updateWebhookRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    eventTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    organizationId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        paused: "paused";
+    }>>;
+}, z.core.$strip>;
+export declare const webhookDeliveryStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    failed: "failed";
+    succeeded: "succeeded";
+    in_flight: "in_flight";
+    dead_lettered: "dead_lettered";
+}>;
+export declare const webhookDeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    webhookId: z.ZodString;
+    eventId: z.ZodString;
+    eventType: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        succeeded: "succeeded";
+        in_flight: "in_flight";
+        dead_lettered: "dead_lettered";
+    }>;
+    attemptCount: z.ZodNumber;
+    dispatchedAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    deadLetteredAt: z.ZodNullable<z.ZodString>;
+    lastResponseStatus: z.ZodNullable<z.ZodNumber>;
+    lastError: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type WebhookDelivery = z.infer<typeof webhookDeliverySchema>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AAEH,eAAO,MAAM,mBAAmB;;;EAA+B,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAcxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,0BAA0B;;;;;iBAMrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,0BAA0B;;;;;;;;;iBAErC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;EAMtC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;iBAahC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/webhooks.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { isoDateTimeSchema, uuidSchema } from './common.js';
+/**
+ * Webhook + WebhookDelivery contracts (US7 / FR-121).
+ */
+export const webhookStatusSchema = z.enum(['active', 'paused']);
+export const webhookSchema = z.object({
+    id: uuidSchema,
+    name: z.string(),
+    url: z.string().url(),
+    eventTypes: z.array(z.string()),
+    status: webhookStatusSchema,
+    /**
+     * Feature 062 — org-scoped delivery (additive). `null` = platform-wide
+     * subscription (legacy semantics); a value restricts delivery to events
+     * whose payload `organizationId` matches.
+     */
+    organizationId: uuidSchema.nullable(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const createWebhookRequestSchema = z.object({
+    name: z.string().min(1).max(160),
+    url: z.string().url(),
+    eventTypes: z.array(z.string().min(1)).min(1),
+    /** Feature 062 — optional organization binding (additive; omitted/null = platform-wide). */
+    organizationId: uuidSchema.nullable().optional(),
+});
+export const updateWebhookRequestSchema = createWebhookRequestSchema.partial().extend({
+    status: webhookStatusSchema.optional(),
+});
+export const webhookDeliveryStatusSchema = z.enum([
+    'pending',
+    'in_flight',
+    'succeeded',
+    'failed',
+    'dead_lettered',
+]);
+export const webhookDeliverySchema = z.object({
+    id: uuidSchema,
+    webhookId: uuidSchema,
+    eventId: z.string(),
+    eventType: z.string(),
+    status: webhookDeliveryStatusSchema,
+    attemptCount: z.number().int().nonnegative(),
+    dispatchedAt: isoDateTimeSchema.nullable(),
+    completedAt: isoDateTimeSchema.nullable(),
+    deadLetteredAt: isoDateTimeSchema.nullable(),
+    lastResponseStatus: z.number().int().nullable(),
+    lastError: z.string().nullable(),
+    createdAt: isoDateTimeSchema,
+});
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D;;GAEG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGhE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,mBAAmB;IAC3B;;;;OAIG;IACH,cAAc,EAAE,UAAU,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,iBAAiB;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,4FAA4F;IAC5F,cAAc,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,0BAA0B,GAAG,0BAA0B,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;IACpF,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC;IAChD,SAAS;IACT,WAAW;IACX,WAAW;IACX,QAAQ;IACR,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,UAAU;IACd,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,2BAA2B;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,cAAc,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC5C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,iBAAiB;CAC7B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@endora-commerce/contracts",
+  "version": "0.100.0",
+  "type": "module",
+  "description": "Source-of-truth Zod schemas shared across backend, storefront, admin (Principle V). The backend regenerates its live OpenAPI document from these at startup.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/contracts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "dependencies": {
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}