@robbeverhelst/do 1.284.0 → 1.286.0

package/dist/do.js

@@ -5096,6 +5096,67 @@ var seatingProposals = pgTable("seating_proposals", {
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [index("seating_proposals_list_idx").on(t.guestListId)]);
 
+// ../../packages/schema/src/db/mail.ts
+var mailCampaignStatus = pgEnum("mail_campaign_status", [
+  "draft",
+  "sending",
+  "sent",
+  "cancelled"
+]);
+var mailDeliveryStatus = pgEnum("mail_delivery_status", [
+  "queued",
+  "sending",
+  "sent",
+  "delivered",
+  "bounced",
+  "failed",
+  "skipped"
+]);
+var mailCampaigns = pgTable("mail_campaigns", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  guestListId: text("guest_list_id").references(() => guestLists.id, { onDelete: "cascade" }),
+  kind: text("kind").notNull().default("message"),
+  template: text("template").notNull(),
+  data: jsonb("data").$type().notNull().default({}),
+  replyTo: text("reply_to"),
+  status: mailCampaignStatus("status").notNull().default("draft"),
+  createdByUserId: text("created_by_user_id").references(() => users.id),
+  testSentAt: timestamp("test_sent_at", { withTimezone: true }),
+  startedAt: timestamp("started_at", { withTimezone: true }),
+  finishedAt: timestamp("finished_at", { withTimezone: true }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  index("mail_campaigns_tenant_idx").on(t.tenantId),
+  index("mail_campaigns_status_idx").on(t.status)
+]);
+var mailDeliveries = pgTable("mail_deliveries", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  campaignId: text("campaign_id").notNull().references(() => mailCampaigns.id, { onDelete: "cascade" }),
+  contactId: text("contact_id").references(() => contacts.id),
+  householdId: text("household_id").references(() => households.id),
+  toEmail: text("to_email").notNull(),
+  language: text("language").notNull().default("nl"),
+  data: jsonb("data").$type().notNull().default({}),
+  status: mailDeliveryStatus("status").notNull().default("queued"),
+  transport: text("transport"),
+  providerMessageId: text("provider_message_id"),
+  attempts: integer("attempts").notNull().default(0),
+  error: text("error"),
+  sentAt: timestamp("sent_at", { withTimezone: true }),
+  deliveredAt: timestamp("delivered_at", { withTimezone: true }),
+  bouncedAt: timestamp("bounced_at", { withTimezone: true }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  index("mail_deliveries_campaign_status_idx").on(t.campaignId, t.status),
+  index("mail_deliveries_sent_at_idx").on(t.sentAt),
+  index("mail_deliveries_household_idx").on(t.householdId),
+  uniqueIndex("mail_deliveries_provider_message_uniq").on(t.providerMessageId),
+  uniqueIndex("mail_deliveries_campaign_email_uniq").on(t.campaignId, t.toEmail)
+]);
+
 // ../../packages/schema/src/db/calendar.ts
 var calendarLinkPurpose = pgEnum("calendar_link_purpose", ["block", "deadline"]);
 var calendarEventLinks = pgTable("calendar_event_links", {
@@ -25324,7 +25385,8 @@ var runQuestSchema = object({
 }).strict();
 var runNextStepsSchema = object({
   items: array(shortText.pipe(string2().min(1))).max(3),
-  pinned: boolean3().default(false)
+  pinned: boolean3().default(false),
+  note: text5.nullish()
 }).strict();
 var runChoiceSchema = object({
   ref: ref.nullish(),
@@ -26008,10 +26070,78 @@ var animalLogInputSchema = discriminatedUnion("kind", [
     occurredAt: occurredAtSchema
   }).strict()
 ]);
+var animalVetVisitSourceSchema = _enum2(["sticker", "photo", "said"]);
+var visitTextSchema = string2().trim().min(1).max(120);
+var visitCostSchema = object({
+  amount: number2().positive().max(1e5),
+  currency: string2().trim().length(3).default("EUR")
+}).strict();
+var animalVetVisitInputSchema = object({
+  id: ulidSchema,
+  at: exports_coerce.date().optional(),
+  vetContactId: ulidSchema.optional(),
+  clinician: visitTextSchema.optional(),
+  reason: visitTextSchema.optional(),
+  vaccine: object({ name: visitTextSchema, source: animalVetVisitSourceSchema.optional() }).strict().optional(),
+  dewormer: visitTextSchema.optional(),
+  weight: object({
+    value: number2().positive().max(200000),
+    unit: _enum2(["g", "kg"]).default("kg")
+  }).strict().optional(),
+  nextDates: array(object({
+    id: ulidSchema,
+    label: visitTextSchema,
+    date: string2().regex(/^\d{4}-\d{2}-\d{2}$/, "expected YYYY-MM-DD")
+  }).strict()).max(5).default([]),
+  files: array(object({ id: ulidSchema, name: visitTextSchema.optional() }).strict()).max(5).default([]),
+  cost: visitCostSchema.optional()
+}).strict();
+var animalVetVisitPatchSchema = object({
+  vetContactId: ulidSchema.nullable().optional(),
+  clinician: visitTextSchema.nullable().optional(),
+  reason: visitTextSchema.nullable().optional(),
+  vaccine: object({ name: visitTextSchema, source: animalVetVisitSourceSchema.optional() }).strict().nullable().optional(),
+  dewormer: visitTextSchema.nullable().optional(),
+  cost: visitCostSchema.nullable().optional()
+}).strict().refine((v) => Object.keys(v).length > 0, { message: "Change at least one field." });
+var animalVetVisitSchema = object({
+  id: ulidSchema,
+  animal: object({
+    id: ulidSchema,
+    title: string2(),
+    speciesKey: string2().nullable(),
+    speciesClass: animalClassSchema.nullable()
+  }),
+  at: exports_coerce.date(),
+  vet: nodeRefSchema.nullable(),
+  clinician: string2().nullable(),
+  reason: string2().nullable(),
+  vaccine: object({ name: string2(), source: animalVetVisitSourceSchema.nullable() }).nullable(),
+  dewormer: string2().nullable(),
+  weight: object({
+    grams: number2(),
+    deltaGrams: number2().nullable(),
+    since: string2().nullable()
+  }).nullable(),
+  keyDates: array(object({ id: string2(), label: string2(), date: string2() })),
+  files: array(object({ id: string2(), name: string2() })),
+  cost: object({ amount: number2(), currency: string2() }).nullable(),
+  byAgent: boolean3(),
+  undone: boolean3()
+});
 var animalTimelineEntrySchema = object({
   id: string2(),
   at: exports_coerce.date(),
-  kind: _enum2(["weight", "length", "eggs", "note", "period_started", "period_ended", "key_date"]),
+  kind: _enum2([
+    "weight",
+    "length",
+    "eggs",
+    "note",
+    "vet_visit",
+    "period_started",
+    "period_ended",
+    "key_date"
+  ]),
   animalId: ulidSchema,
   animalTitle: string2(),
   value: number2().nullable(),
@@ -26670,6 +26800,124 @@ var thankYouViewSchema = object({
   thanked: array(thankYouGiftSchema)
 });
 
+// ../../packages/schema/src/contracts/mail.ts
+var MAIL_LANGUAGES = ["nl", "pt"];
+var mailLanguageSchema = _enum2(MAIL_LANGUAGES);
+var MAIL_CAMPAIGN_STATUSES = ["draft", "sending", "sent", "cancelled"];
+var mailCampaignStatusSchema = _enum2(MAIL_CAMPAIGN_STATUSES);
+var MAIL_DELIVERY_STATUSES = [
+  "queued",
+  "sending",
+  "sent",
+  "delivered",
+  "bounced",
+  "failed",
+  "skipped"
+];
+var mailDeliveryStatusSchema = _enum2(MAIL_DELIVERY_STATUSES);
+var mailCampaignSchema = createSelectSchema(mailCampaigns, {
+  data: record(string2(), unknown()),
+  testSentAt: exports_coerce.date().nullable().default(null),
+  startedAt: exports_coerce.date().nullable(),
+  finishedAt: exports_coerce.date().nullable(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var mailDeliverySchema = createSelectSchema(mailDeliveries, {
+  data: record(string2(), unknown()),
+  sentAt: exports_coerce.date().nullable(),
+  deliveredAt: exports_coerce.date().nullable(),
+  bouncedAt: exports_coerce.date().nullable(),
+  createdAt: exports_coerce.date()
+});
+var mailFooterSchema = object({
+  deleteBy: keyDateDaySchema.optional(),
+  contact: email2().max(320).optional()
+}).strict();
+var lineSchema = string2().trim().min(1).max(2000);
+var mailMessageCopySchema = object({
+  subject: string2().trim().min(1).max(200),
+  heading: string2().trim().min(1).max(200),
+  paragraphs: array(lineSchema).max(20).default([]),
+  button: object({ label: string2().trim().min(1).max(80), url: url() }).strict().nullish()
+}).strict();
+var mailMessageDataSchema = object({
+  nl: mailMessageCopySchema,
+  pt: mailMessageCopySchema.optional(),
+  footer: mailFooterSchema.optional()
+}).strict();
+var mailProviderEventSchema = looseObject({
+  type: string2().min(1),
+  created_at: string2().optional(),
+  data: looseObject({
+    email_id: string2().min(1),
+    to: array(string2()).optional(),
+    bounce: looseObject({
+      type: string2().optional(),
+      message: string2().optional()
+    }).optional()
+  })
+});
+var MAIL_CAMPAIGN_KINDS = ["message", "save_the_date", "invitation"];
+var mailCampaignKindSchema = _enum2(MAIL_CAMPAIGN_KINDS);
+var MAIL_TEMPLATES = ["message"];
+var mailTemplateSchema = _enum2(MAIL_TEMPLATES);
+var mailTemplateDataSchemas = {
+  message: mailMessageDataSchema
+};
+function mailTemplateDataError(template, data) {
+  const parsed = mailTemplateDataSchemas[template].safeParse(data);
+  return parsed.success ? null : parsed.error.issues[0]?.message ?? "invalid data";
+}
+var replyToSchema = email2().max(320);
+var createMailCampaignInputSchema = object({
+  id: ulidSchema,
+  guestListId: ulidSchema,
+  kind: mailCampaignKindSchema.default("message"),
+  template: mailTemplateSchema.default("message"),
+  data: record(string2(), unknown()),
+  replyTo: replyToSchema.nullish()
+}).strict().superRefine((input, ctx) => {
+  const error = mailTemplateDataError(input.template, input.data);
+  if (error)
+    ctx.addIssue({ code: "custom", path: ["data"], message: error });
+});
+var updateMailCampaignInputSchema = object({
+  kind: mailCampaignKindSchema.optional(),
+  data: record(string2(), unknown()).optional(),
+  replyTo: replyToSchema.nullish()
+}).strict();
+var mailCampaignsQuerySchema = object({ guestListId: ulidSchema }).strict();
+var mailPreviewQuerySchema = object({ language: mailLanguageSchema.default("nl") }).strict();
+var mailPreviewSchema = object({
+  language: mailLanguageSchema,
+  subject: string2(),
+  html: string2(),
+  text: string2()
+});
+var mailTestResultSchema = object({ to: array(string2()) });
+var sendMailCampaignInputSchema = object({ households: number2().int().positive() }).strict();
+var householdMailStatusSchema = _enum2([
+  "queued",
+  "sent",
+  "delivered",
+  "bounced",
+  "failed",
+  "skipped"
+]);
+var mailRecipientHouseholdSchema = object({
+  householdId: string2().nullable(),
+  name: string2(),
+  language: mailLanguageSchema,
+  addresses: number2().int().nonnegative(),
+  status: householdMailStatusSchema.nullable()
+});
+var mailCampaignViewSchema = mailCampaignSchema.extend({
+  households: array(mailRecipientHouseholdSchema),
+  counts: partialRecord(mailDeliveryStatusSchema, number2().int().nonnegative()),
+  readyToSend: boolean3()
+});
+
 // ../../packages/schema/src/contracts/calendar.ts
 var calendarEventLinkSchema = createSelectSchema(calendarEventLinks, {
   createdAt: exports_coerce.date(),
@@ -28370,7 +28618,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.284.0";
+var VERSION = "1.286.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -33379,6 +33627,54 @@ var COMMAND_SPECS = [
     returns: "AnimalTimelineEntry",
     notes: 'POST /api/v1/animals/{id}/log (`animal_log`). `do animals log <hens> eggs 2`, `do animals log <dog> weight 37.8 --unit kg`, `do animals log <hen> note "eating again"`. Eggs are the day\'s count: logging again that day replaces it.'
   },
+  {
+    path: ["animals", "vet-visit"],
+    summary: "Log a vet visit in one call: where, the vaccine, the dewormer, the weight, the next dates, the photos, the cost.",
+    args: [{ name: "id", required: true, description: "Animal ULID." }],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: "JSON: { vetContactId?, clinician?, reason?, vaccine?: { name, source? }, dewormer?, weight?: { value, unit? }, nextDates?: [{ label, date }], files?: [{ id, name? }], cost?: { amount, currency? }, at? }. The visit's and each date's ids are minted."
+      }
+    ],
+    scopes: ["animals:write"],
+    returns: "AnimalVetVisit",
+    notes: 'POST /api/v1/animals/{id}/vet-visits (`animal_vet_visit`, mockup 03). The visit is the receipt: post it with `receipt: { nodeId: <visit id> }`. `do animals vet-visit <dog> --data \'{"reason":"booster","vaccine":{"name":"DHPPi + L4","source":"sticker"},"weight":{"value":37.8}}\'`.'
+  },
+  {
+    path: ["animals", "vet-visit-get"],
+    summary: "Read a vet visit as its receipt reads.",
+    args: [{ name: "visitId", required: true, description: "Vet visit ULID." }],
+    flags: [],
+    scopes: ["animals:read"],
+    returns: "AnimalVetVisit",
+    notes: "GET /api/v1/animals/vet-visits/{visitId}."
+  },
+  {
+    path: ["animals", "vet-visit-edit"],
+    summary: "Put a vet visit's fields right (the receipt's Edit).",
+    args: [{ name: "visitId", required: true, description: "Vet visit ULID." }],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: "JSON: any of vetContactId, clinician, reason, vaccine, dewormer, cost (null clears one)."
+      }
+    ],
+    scopes: ["animals:write"],
+    returns: "AnimalVetVisit",
+    notes: "PATCH /api/v1/animals/vet-visits/{visitId}. The newest version wins."
+  },
+  {
+    path: ["animals", "vet-visit-undo"],
+    summary: "Take a vet visit back (the receipt's Undo).",
+    args: [{ name: "visitId", required: true, description: "Vet visit ULID." }],
+    flags: [],
+    scopes: ["animals:write"],
+    returns: "AnimalVetVisit",
+    notes: "POST /api/v1/animals/vet-visits/{visitId}/undo. The visit, its weight, its key dates and the filed photos all go back."
+  },
   {
     path: ["runs", "change"],
     summary: "Apply a chat update to a run: its changes, with a receipt and Undo.",
@@ -33711,6 +34007,61 @@ var COMMAND_SPECS = [
     scopes: ["contacts:write"],
     returns: "SeatingProposal"
   },
+  {
+    path: ["mail-campaigns", "list"],
+    summary: "A guest list's mail campaigns (save-the-dates, invitations), newest first.",
+    args: [],
+    flags: [{ name: "list", type: "string", description: "The guest list's id (required)." }],
+    scopes: ["contacts:read"],
+    returns: "MailCampaignView",
+    notes: "Each campaign carries the households it reaches (a draft: who it would go to) with their status, its mails by status, and readyToSend."
+  },
+  {
+    path: ["mail-campaigns", "get"],
+    summary: "One mail campaign, with its households and how far it got.",
+    args: [{ name: "id", required: true, description: "The campaign's id." }],
+    flags: [],
+    scopes: ["contacts:read"],
+    returns: "MailCampaignView"
+  },
+  {
+    path: ["mail-campaigns", "create"],
+    summary: "Draft a mail campaign for a guest list; nothing is sent.",
+    args: [],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: 'JSON CreateMailCampaignInput, e.g. {"guestListId":"01\u2026","kind":"save_the_date","template":"message","data":{"nl":{"subject":"\u2026","heading":"\u2026","paragraphs":["\u2026"]},"pt":{\u2026},"footer":{"deleteBy":"2027-12-31"}},"replyTo":"hallo@example.com"}'
+      }
+    ],
+    scopes: ["contacts:write"],
+    returns: "MailCampaignView",
+    notes: "Drafting only: a member previews it, sends a test to the Space's members and sends it from the Mail tab. An agent can never test or send."
+  },
+  {
+    path: ["mail-campaigns", "update"],
+    summary: "Edit a draft campaign (its copy, kind or reply address).",
+    args: [{ name: "id", required: true, description: "The campaign's id." }],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: 'JSON UpdateMailCampaignInput, e.g. {"data":{"nl":{\u2026}}}'
+      }
+    ],
+    scopes: ["contacts:write"],
+    returns: "MailCampaignView",
+    notes: "Only a draft changes (409 otherwise); an edit makes the last test stale."
+  },
+  {
+    path: ["mail-campaigns", "preview"],
+    summary: "Draw a campaign's mail as its first household would get it.",
+    args: [{ name: "id", required: true, description: "The campaign's id." }],
+    flags: [{ name: "language", type: "string", description: "nl (default) or pt." }],
+    scopes: ["contacts:read"],
+    returns: "MailPreview"
+  },
   {
     path: ["guest-lists", "thank-you"],
     summary: "The gifts for the event: the cards still to send, then the ones sent.",
@@ -38339,6 +38690,35 @@ var HANDLERS = {
     const body = parseInput(animalLogInputSchema, { ...fact, ...at ? { occurredAt: at } : {} });
     return { data: await requireClient().post(`/animals/${id}/log`, body), render: renderRecord };
   },
+  "animals vet-visit": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "animal id");
+    const raw = readDataFlag(flags);
+    const body = parseInput(animalVetVisitInputSchema, {
+      id: ulid3(),
+      ...raw,
+      nextDates: (raw.nextDates ?? []).map((d) => ({ id: ulid3(), ...d }))
+    });
+    return {
+      data: await requireClient().post(`/animals/${id}/vet-visits`, body),
+      render: renderRecord
+    };
+  },
+  "animals vet-visit-get": async ({ args, requireClient }) => ({
+    data: await requireClient().get(`/animals/vet-visits/${requireArg(args, 0, "visit id")}`),
+    render: renderRecord
+  }),
+  "animals vet-visit-edit": async ({ args, flags, requireClient }) => {
+    const visitId = requireArg(args, 0, "visit id");
+    const body = parseInput(animalVetVisitPatchSchema, readDataFlag(flags));
+    return {
+      data: await requireClient().patch(`/animals/vet-visits/${visitId}`, body),
+      render: renderRecord
+    };
+  },
+  "animals vet-visit-undo": async ({ args, requireClient }) => ({
+    data: await requireClient().post(`/animals/vet-visits/${requireArg(args, 0, "visit id")}/undo`, {}),
+    render: renderRecord
+  }),
   "runs change": async ({ args, flags, requireClient }) => {
     const id = requireArg(args, 0, "run id");
     const body = { ...readDataFlag(flags) };
@@ -38860,6 +39240,42 @@ var HANDLERS = {
       render: renderRecord
     };
   },
+  "mail-campaigns list": async ({ flags, requireClient }) => {
+    const list = flagString(flags, "list");
+    if (!list)
+      throw usageError("mail-campaigns list needs --list <guest list id>");
+    parseInput(mailCampaignsQuerySchema, { guestListId: list });
+    return {
+      data: await requireClient().get("/mail-campaigns", { query: { guestListId: list } }),
+      render: renderRecord
+    };
+  },
+  "mail-campaigns get": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "campaign id");
+    return { data: await requireClient().get(`/mail-campaigns/${id}`), render: renderRecord };
+  },
+  "mail-campaigns create": async ({ flags, requireClient }) => {
+    const body = parseInput(createMailCampaignInputSchema, { id: ulid3(), ...readDataFlag(flags) });
+    return { data: await requireClient().post("/mail-campaigns", body), render: renderRecord };
+  },
+  "mail-campaigns update": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "campaign id");
+    const body = parseInput(updateMailCampaignInputSchema, readDataFlag(flags));
+    return {
+      data: await requireClient().patch(`/mail-campaigns/${id}`, body),
+      render: renderRecord
+    };
+  },
+  "mail-campaigns preview": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "campaign id");
+    const query = parseInput(mailPreviewQuerySchema, {
+      language: flagString(flags, "language") ?? "nl"
+    });
+    return {
+      data: await requireClient().get(`/mail-campaigns/${id}/preview`, { query }),
+      render: renderRecord
+    };
+  },
   "guest-lists thank-you": async ({ args, requireClient }) => {
     const id = requireArg(args, 0, "guest list id");
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.284.0",
+  "version": "1.286.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",