@robbeverhelst/do 1.392.0 → 1.393.0

package/dist/do.js

@@ -14420,7 +14420,7 @@ var configError = (message) => new CliError("config", message, EXIT.CONFIG);
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.392.0";
+var VERSION = "1.393.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -20801,6 +20801,49 @@ var animalHandoverNotes = pgTable("animal_handover_notes", {
   photoFileId: text("photo_file_id").references(() => files.id, { onDelete: "set null" }),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [index("animal_handover_notes_period_idx").on(t.tenantId, t.periodId)]);
+var animalMedicineEveryUnit = pgEnum("animal_medicine_every_unit", [
+  "day",
+  "week",
+  "month"
+]);
+var animalMedicines = pgTable("animal_medicines", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  title: text("title").notNull(),
+  dose: text("dose"),
+  everyCount: integer2("every_count").notNull().default(1),
+  everyUnit: animalMedicineEveryUnit("every_unit").notNull().default("day"),
+  timeOfDay: text("time_of_day"),
+  startsOn: date5("starts_on", { mode: "string" }),
+  endsOn: date5("ends_on", { mode: "string" }),
+  nextOn: date5("next_on", { mode: "string" }),
+  stock: doublePrecision("stock"),
+  unit: text("unit"),
+  perDose: doublePrecision("per_dose").notNull().default(1),
+  lowAt: doublePrecision("low_at"),
+  note: text("note"),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [index("animal_medicines_tenant_idx").on(t.tenantId)]);
+var animalMedicineAnimals = pgTable("animal_medicine_animals", {
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  medicineId: text("medicine_id").notNull().references(() => animalMedicines.id, { onDelete: "cascade" }),
+  animalId: text("animal_id").notNull().references(() => animals.id, { onDelete: "cascade" })
+}, (t) => [
+  primaryKey({ columns: [t.medicineId, t.animalId] }),
+  index("animal_medicine_animals_animal_idx").on(t.tenantId, t.animalId)
+]);
+var animalMedicineDoses = pgTable("animal_medicine_doses", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  medicineId: text("medicine_id").notNull().references(() => animalMedicines.id, { onDelete: "cascade" }),
+  day: date5("day", { mode: "string" }).notNull(),
+  givenAt: timestamp("given_at", { withTimezone: true }).notNull().defaultNow(),
+  givenByUserId: text("given_by_user_id").references(() => users.id, { onDelete: "set null" }),
+  took: doublePrecision("took").notNull().default(0),
+  nextWas: date5("next_was", { mode: "string" }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [unique("animal_medicine_doses_day_uniq").on(t.medicineId, t.day)]);
 
 // ../../packages/schema/src/db/documents.ts
 var documentKind = pgEnum("document_kind", [
@@ -21712,6 +21755,61 @@ var animalArrivedInputSchema = object({
   on: keyDateDaySchema.optional(),
   quarantineMonths: number2().int().min(0).max(12).optional()
 }).strict();
+var animalMedicineEveryUnitSchema = _enum2(animalMedicineEveryUnit.enumValues);
+var animalMedicineViewSchema = object({
+  id: ulidSchema,
+  title: string2(),
+  dose: string2().nullable(),
+  everyCount: number2().int(),
+  everyUnit: animalMedicineEveryUnitSchema,
+  timeOfDay: string2().nullable(),
+  startsOn: string2().nullable(),
+  endsOn: string2().nullable(),
+  nextOn: string2().nullable(),
+  stock: number2().nullable(),
+  unit: string2().nullable(),
+  perDose: number2(),
+  lowAt: number2().nullable(),
+  note: string2().nullable(),
+  animals: array(nodeRefSchema),
+  daily: boolean2(),
+  low: boolean2(),
+  ended: boolean2(),
+  course: object({ day: number2().int(), of: number2().int() }).nullable(),
+  dueToday: boolean2(),
+  doneToday: boolean2(),
+  lastGivenOn: string2().nullable(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var medicineText = (max) => string2().trim().min(1).max(max);
+var animalMedicineFields = object({
+  id: ulidSchema,
+  title: medicineText(120),
+  animalIds: array(ulidSchema).min(1).max(20),
+  dose: medicineText(120).nullish(),
+  everyCount: number2().int().min(1).max(366).optional(),
+  everyUnit: animalMedicineEveryUnitSchema.optional(),
+  timeOfDay: string2().regex(/^(morning|midday|afternoon|evening|night|([01][0-9]|2[0-3]):[0-5][0-9])$/).nullish(),
+  startsOn: keyDateDaySchema.nullish(),
+  endsOn: keyDateDaySchema.nullish(),
+  nextOn: keyDateDaySchema.nullish(),
+  stock: number2().min(0).max(1e5).nullish(),
+  unit: medicineText(30).nullish(),
+  perDose: number2().positive().max(1e4).optional(),
+  lowAt: number2().min(0).max(1e5).nullish(),
+  note: medicineText(300).nullish()
+}).strict();
+var endsAfterStart2 = (v) => !v.startsOn || !v.endsOn || v.endsOn >= v.startsOn;
+var endsMessage = { message: "endsOn is before startsOn", path: ["endsOn"] };
+var createAnimalMedicineInputSchema = animalMedicineFields.refine(endsAfterStart2, endsMessage);
+var updateAnimalMedicineInputSchema = animalMedicineFields.omit({ id: true }).partial().strict().refine(endsAfterStart2, endsMessage);
+var animalMedicinesQuerySchema = object({
+  animalId: ulidSchema.optional(),
+  day: keyDateDaySchema.optional(),
+  includeEnded: _enum2(["true", "false"]).transform((v) => v === "true").optional()
+});
+var animalMedicineDoseInputSchema = object({ day: keyDateDaySchema.optional() }).strict();
 
 // ../../packages/schema/src/operations/crud.ts
 var DELETE_REASON_QUERY = [
@@ -21795,6 +21893,7 @@ function crudOperations(r) {
 var READ = ["animals:read"];
 var WRITE = ["animals:write"];
 var visit = { visitId: "The vet visit's ULID." };
+var medicine = { medicineId: "The medicine's ULID." };
 var animalOperations = defineOperations({
   ...crudOperations({
     segment: "animals",
@@ -21883,6 +21982,96 @@ var animalOperations = defineOperations({
     response: { description: "The species profile." },
     errors: { 400: true }
   },
+  listMedicines: {
+    method: "get",
+    path: "/animals/medicines",
+    scopes: READ,
+    tag: "Animals",
+    summary: "List the animals' medicines",
+    description: "By title: each medicine with the `animals` it's for, its `dose`, how often (`everyCount` `everyUnit`; `daily` when every 1 day), `timeOfDay`, a course's `startsOn`/`endsOn` and its `course` day N of M, the `nextOn` day of one that isn't daily, the counted `stock` (`unit`, `perDose`, `low` at `lowAt`), the `note`, and on `day` (UTC today by default) whether it's `dueToday` and `doneToday`, with `lastGivenOn`. Ended courses only with `includeEnded`.",
+    query: [
+      { name: "animalId", description: "Only this animal's (an animal's ULID)." },
+      { name: "day", description: "The reader's day, `YYYY-MM-DD`; UTC today when left out." },
+      { name: "includeEnded", description: "`true`: ended courses too." }
+    ],
+    querySchema: animalMedicinesQuerySchema,
+    status: 200,
+    response: { description: "The medicines." }
+  },
+  createMedicine: {
+    method: "post",
+    path: "/animals/medicines",
+    scopes: WRITE,
+    tag: "Animals",
+    summary: "Add a medicine for one animal or a few",
+    description: "A daily one (the default, every 1 day), a course (`startsOn` to `endsOn`) or one that comes round (`everyCount` `everyUnit`, with its `nextOn`). Count the `stock` to have each dose take `perDose` (default 1) from it and say low at `lowAt`. Every animal must be one in this Space (400).",
+    body: createAnimalMedicineInputSchema,
+    status: 201,
+    response: { description: "The medicine." },
+    errors: { 400: true }
+  },
+  getMedicine: {
+    method: "get",
+    path: "/animals/medicines/{medicineId}",
+    pathParams: medicine,
+    scopes: READ,
+    tag: "Animals",
+    summary: "A medicine, as it stands today",
+    description: "The same shape as a row of the list, on UTC today.",
+    status: 200,
+    response: { description: "The medicine." },
+    errors: { 404: true }
+  },
+  updateMedicine: {
+    method: "patch",
+    path: "/animals/medicines/{medicineId}",
+    pathParams: medicine,
+    scopes: WRITE,
+    tag: "Animals",
+    summary: "Change a medicine",
+    description: "A field left out stays; `null` clears it; `animalIds` replaces who it's for. Set `stock` when a new box comes in.",
+    body: updateAnimalMedicineInputSchema,
+    status: 200,
+    response: { description: "The medicine." },
+    errors: { 400: true, 404: true }
+  },
+  removeMedicine: {
+    method: "delete",
+    path: "/animals/medicines/{medicineId}",
+    pathParams: medicine,
+    scopes: WRITE,
+    tag: "Animals",
+    summary: "Remove a medicine",
+    description: "With the doses given; to stop a course and keep it, set its `endsOn` instead.",
+    status: 204,
+    response: { description: "Removed." },
+    errors: { 404: true }
+  },
+  giveMedicineDose: {
+    method: "post",
+    path: "/animals/medicines/{medicineId}/doses",
+    pathParams: medicine,
+    scopes: WRITE,
+    tag: "Animals",
+    summary: "Give a medicine's dose",
+    description: "The dose for `day` (UTC today by default): it takes `perDose` from a counted stock (never below 0) and moves the next day of one that isn't daily on from that day. Again that day changes nothing.",
+    body: animalMedicineDoseInputSchema,
+    status: 200,
+    response: { description: "The medicine, on that day." },
+    errors: { 400: true, 404: true }
+  },
+  undoMedicineDose: {
+    method: "delete",
+    path: "/animals/medicines/{medicineId}/doses/{day}",
+    pathParams: { ...medicine, day: "The day it was given for, `YYYY-MM-DD`." },
+    scopes: WRITE,
+    tag: "Animals",
+    summary: "Take a medicine's dose back",
+    description: "The stock and the next day go back to before it; 404 when none was given that day.",
+    status: 200,
+    response: { description: "The medicine, on that day." },
+    errors: { 400: "`day` isn't a `YYYY-MM-DD` day.", 404: true }
+  },
   vetVisit: {
     method: "get",
     path: "/animals/vet-visits/{visitId}",
@@ -31543,9 +31732,9 @@ var eventFields = {
   note: eventTextSchema(1000).nullish(),
   sort: number2().int().min(0).max(1e4).optional()
 };
-var endsAfterStart2 = (e) => !e.startsAt || !e.endsAt || e.endsAt >= e.startsAt;
-var createGuestListEventInputSchema = object({ id: ulidSchema, guestListId: ulidSchema, key: guestEventKeySchema, ...eventFields }).strict().refine(endsAfterStart2, { message: "endsAt is before startsAt", path: ["endsAt"] });
-var updateGuestListEventInputSchema = object(eventFields).partial().strict().refine(endsAfterStart2, { message: "endsAt is before startsAt", path: ["endsAt"] });
+var endsAfterStart3 = (e) => !e.startsAt || !e.endsAt || e.endsAt >= e.startsAt;
+var createGuestListEventInputSchema = object({ id: ulidSchema, guestListId: ulidSchema, key: guestEventKeySchema, ...eventFields }).strict().refine(endsAfterStart3, { message: "endsAt is before startsAt", path: ["endsAt"] });
+var updateGuestListEventInputSchema = object(eventFields).partial().strict().refine(endsAfterStart3, { message: "endsAt is before startsAt", path: ["endsAt"] });
 var guestListEventsQuerySchema = object({ guestListId: ulidSchema });
 var guestTableSchema = createSelectSchema(guestTables, {
   createdAt: exports_coerce.date(),
@@ -46298,6 +46487,172 @@ var commands2 = [
       return { data: { ok: true, animalId: id }, render: renderRecord };
     }
   },
+  {
+    spec: {
+      path: ["animals", "medicines"],
+      summary: "List the animals' medicines and where each stands today.",
+      args: [],
+      flags: [
+        { name: "animal", type: "string", description: "Only this animal's (ULID)." },
+        {
+          name: "day",
+          type: "string",
+          description: "The day to read for, YYYY-MM-DD (default UTC today)."
+        },
+        { name: "include-ended", type: "boolean", description: "Ended courses too." }
+      ],
+      scopes: [...animalOperations.listMedicines.scopes],
+      returns: "AnimalMedicineView[]",
+      notes: `${routeOf(animalOperations.listMedicines)}. Each with its animals, dose, how often, the course's day N of M, the next day, the stock (low or not), and dueToday / doneToday.`
+    },
+    run: async ({ flags, requireClient }) => {
+      const raw = {};
+      const animal = flagString(flags, "animal");
+      const day = flagString(flags, "day");
+      if (animal)
+        raw.animalId = animal;
+      if (day)
+        raw.day = day;
+      if (flagBool(flags, "include-ended"))
+        raw.includeEnded = "true";
+      parseInput(animalMedicinesQuerySchema, raw);
+      return {
+        data: await requireClient().getPage(pathOf(animalOperations.listMedicines), { query: raw }),
+        render: renderList
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["animals", "medicine"],
+      summary: "One medicine, as it stands today.",
+      args: [{ name: "id", required: true, description: "Medicine ULID." }],
+      flags: [],
+      scopes: [...animalOperations.getMedicine.scopes],
+      returns: "AnimalMedicineView",
+      notes: `${routeOf(animalOperations.getMedicine)}.`
+    },
+    run: readOperation(animalOperations.getMedicine, renderRecord, { medicineId: "medicine id" })
+  },
+  {
+    spec: {
+      path: ["animals", "medicine-add"],
+      summary: "Add a medicine for one animal or a few: daily, a course, or one that comes round.",
+      args: [],
+      flags: [
+        {
+          name: "data",
+          type: "string",
+          description: 'JSON: `{ "title": "Joint tablet", "animalIds": ["\u2026"], "dose": "1 tablet with breakfast", "timeOfDay": "morning", "stock": 22, "unit": "tablets", "lowAt": 5 }`; a course adds `startsOn`/`endsOn`, one that comes round `everyCount`/`everyUnit` (`day`, `week`, `month`) and `nextOn`. The id is minted.'
+        }
+      ],
+      scopes: [...animalOperations.createMedicine.scopes],
+      returns: "AnimalMedicineView",
+      notes: `${routeOf(animalOperations.createMedicine)}. Daily unless said; each dose takes \`perDose\` (default 1) from a counted stock.`
+    },
+    run: async ({ flags, requireClient }) => {
+      const body = parseInput(createAnimalMedicineInputSchema, {
+        id: ulid3(),
+        ...readDataFlag(flags)
+      });
+      return {
+        data: await requireClient().post(pathOf(animalOperations.createMedicine), body),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["animals", "medicine-update"],
+      summary: "Change a medicine (a new box: set its stock).",
+      args: [{ name: "id", required: true, description: "Medicine ULID." }],
+      flags: [
+        {
+          name: "data",
+          type: "string",
+          description: "UpdateAnimalMedicineInput JSON; null clears a field."
+        }
+      ],
+      scopes: [...animalOperations.updateMedicine.scopes],
+      returns: "AnimalMedicineView",
+      notes: `${routeOf(animalOperations.updateMedicine)}. \`animalIds\` replaces who it's for.`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const medicineId = requireArg(args, 0, "medicine id");
+      const body = parseInput(updateAnimalMedicineInputSchema, readDataFlag(flags));
+      return {
+        data: await requireClient().patch(pathOf(animalOperations.updateMedicine, { medicineId }), body),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["animals", "medicine-remove"],
+      summary: "Remove a medicine, with the doses given.",
+      args: [{ name: "id", required: true, description: "Medicine ULID." }],
+      flags: [],
+      scopes: [...animalOperations.removeMedicine.scopes],
+      returns: "void",
+      notes: `${routeOf(animalOperations.removeMedicine)}. Destructive: the doses go too, so it needs --allow-destructive; to stop a course and keep it, set its endsOn.`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const medicineId = requireArg(args, 0, "medicine id");
+      assertDestructiveAllowed(flags, `remove medicine ${medicineId} and its doses`);
+      await requireClient().delete(pathOf(animalOperations.removeMedicine, { medicineId }));
+      return { data: { ok: true, medicineId }, render: renderRecord };
+    }
+  },
+  {
+    spec: {
+      path: ["animals", "medicine-dose"],
+      summary: "Give a medicine's dose (today, or --day).",
+      args: [{ name: "id", required: true, description: "Medicine ULID." }],
+      flags: [
+        {
+          name: "day",
+          type: "string",
+          description: "The day it's for, YYYY-MM-DD (default UTC today)."
+        }
+      ],
+      scopes: [...animalOperations.giveMedicineDose.scopes],
+      returns: "AnimalMedicineView",
+      notes: `${routeOf(animalOperations.giveMedicineDose)}. Takes \`perDose\` from a counted stock and moves the next day on; again that day changes nothing.`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const medicineId = requireArg(args, 0, "medicine id");
+      const day = flagString(flags, "day");
+      const body = parseInput(animalMedicineDoseInputSchema, day ? { day } : {});
+      return {
+        data: await requireClient().post(pathOf(animalOperations.giveMedicineDose, { medicineId }), body),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["animals", "medicine-undose"],
+      summary: "Take a medicine's dose back.",
+      args: [
+        { name: "id", required: true, description: "Medicine ULID." },
+        { name: "day", required: true, description: "The day it was given for, YYYY-MM-DD." }
+      ],
+      flags: [],
+      scopes: [...animalOperations.undoMedicineDose.scopes],
+      returns: "AnimalMedicineView",
+      notes: `${routeOf(animalOperations.undoMedicineDose)}. The stock and the next day go back to before it.`
+    },
+    run: async ({ args, requireClient }) => {
+      const medicineId = requireArg(args, 0, "medicine id");
+      const { day } = parseInput(animalMedicineDoseInputSchema, {
+        day: requireArg(args, 1, "day")
+      });
+      return {
+        data: await requireClient().delete(pathOf(animalOperations.undoMedicineDose, { medicineId, day })),
+        render: renderRecord
+      };
+    }
+  },
   {
     spec: {
       path: ["animals", "acquisition"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.392.0",
+  "version": "1.393.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",