@robbeverhelst/do 1.302.0 → 1.303.0

package/dist/do.js

@@ -5174,6 +5174,8 @@ var guestLists = pgTable("guest_lists", {
   finalInfoKeyDateId: text("final_info_key_date_id").references(() => keyDates.id, {
     onDelete: "set null"
   }),
+  siteUrl: text("site_url"),
+  sitePassword: text("site_password"),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [uniqueIndex("guest_lists_project_uniq").on(t.tenantId, t.projectId)]);
@@ -19912,6 +19914,12 @@ var linkGoogleInputSchema = object({
   state: string2().min(1)
 });
 
+// ../../packages/schema/src/contracts/pagination.ts
+var paginationQuerySchema = object({
+  limit: exports_coerce.number().int().positive().optional(),
+  cursor: string2().min(1).optional()
+});
+
 // ../../packages/schema/src/contracts/changes.ts
 var changeOpSchema = _enum2(["created", "updated", "deleted"]);
 var CHANGE_ENTITY_SCOPES = {
@@ -20770,7 +20778,8 @@ var metricSourceSchema = _enum2([
   "agent",
   "google_fit",
   "google_health",
-  "health_connect"
+  "health_connect",
+  "withings"
 ]);
 var loggedMetricSourceSchema = _enum2(["manual", "device", "agent"]);
 var metricPointSchema = object({
@@ -27700,6 +27709,7 @@ var guestListViewSchema = guestListSchema.extend({
   finalInfoFrom: keyDateDaySchema.nullable().default(null),
   projectDay: keyDateDaySchema.nullable().default(null)
 });
+var siteUrlSchema = string2().trim().max(200).regex(/^https:\/\/[^\s/?#]+(\/[^\s?#]*)?$/, "expected an https:// address without ? or #").transform((u) => u.replace(/\/+$/, ""));
 var createGuestListInputSchema = object({
   id: ulidSchema,
   projectId: ulidSchema,
@@ -27707,7 +27717,9 @@ var createGuestListInputSchema = object({
   caps: capsSchema.optional(),
   sides: array(sideSchema).max(4).optional(),
   rsvpBy: keyDateDaySchema.nullish(),
-  finalInfoFrom: keyDateDaySchema.nullish()
+  finalInfoFrom: keyDateDaySchema.nullish(),
+  siteUrl: siteUrlSchema.nullish(),
+  sitePassword: string2().trim().min(1).max(64).nullish()
 }).strict();
 var updateGuestListInputSchema = createGuestListInputSchema.omit({ id: true, projectId: true }).partial().strict();
 var guestListsQuerySchema = object({ projectId: ulidSchema.optional() });
@@ -27859,6 +27871,23 @@ var publicRsvpEventSchema = object({
   dressCode: object({ nl: string2().optional(), pt: string2().optional() }).nullable(),
   note: object({ nl: string2().optional(), pt: string2().optional() }).nullable()
 }).strict();
+var publicTextSchema = object({ nl: string2().optional(), pt: string2().optional() });
+var publicRsvpQuestionSchema = object({
+  id: ulidSchema,
+  kind: rsvpQuestionKindSchema,
+  label: publicTextSchema,
+  options: array(object({ key: string2(), label: publicTextSchema }).strict()),
+  scope: rsvpQuestionScopeSchema,
+  eventKey: string2().nullable(),
+  required: boolean3(),
+  showIf: array(rsvpShowIfConditionSchema),
+  preset: rsvpQuestionPresetSchema.nullable()
+}).strict();
+var publicRsvpAnswerSchema = object({
+  questionId: ulidSchema,
+  guestId: ulidSchema.nullable(),
+  value: rsvpAnswerValueSchema
+}).strict();
 var publicRsvpViewSchema = object({
   mode: rsvpLinkModeSchema,
   language: rsvpLanguageSchema,
@@ -27868,6 +27897,8 @@ var publicRsvpViewSchema = object({
   finalInfoFrom: keyDateDaySchema.nullable().default(null),
   tiers: array(guestTierSchema),
   events: array(publicRsvpEventSchema).default([]),
+  questions: array(publicRsvpQuestionSchema).default([]),
+  answers: array(publicRsvpAnswerSchema).default([]),
   guests: array(publicRsvpGuestSchema),
   address: householdAddressSchema.nullable(),
   answeredAt: exports_coerce.date().nullable()
@@ -27953,7 +27984,14 @@ var createSeatingProposalInputSchema = object({
   return new Set(ids).size === ids.length;
 }, { message: "a guest can sit at one table only", path: ["tables"] });
 var seatingProposalsQuerySchema = object({ guestListId: ulidSchema });
-var GUEST_EXPORT_KINDS = ["caterer", "venue", "floor-plan", "church", "answers"];
+var GUEST_EXPORT_KINDS = [
+  "caterer",
+  "venue",
+  "floor-plan",
+  "church",
+  "answers",
+  "invitations"
+];
 var guestExportKindSchema = _enum2(GUEST_EXPORT_KINDS);
 var thankYouGiftSchema = object({
   momentId: ulidSchema,
@@ -29586,6 +29624,77 @@ function toCollectionTypeSummary(config) {
 }
 var COLLECTION_TYPE_SUMMARIES = COLLECTION_TYPE_LIST.map(toCollectionTypeSummary);
 
+// ../../packages/schema/src/operations/crud.ts
+function crudOperations(r) {
+  const base = `/${r.segment}`;
+  const one = `/${r.segment}/{id}`;
+  const event = r.eventBase ?? r.noun.replace(/ /g, ".");
+  return {
+    list: {
+      method: "get",
+      path: base,
+      scopes: [r.read],
+      tag: r.tag,
+      summary: `List ${r.noun}s`,
+      description: `Every ${r.noun} in the key's Space${r.paginated ? ", newest first" : ""}.`,
+      query: r.listQuery,
+      querySchema: r.listQuerySchema,
+      paginated: r.paginated,
+      status: 200,
+      response: { description: `The Space's ${r.noun}s.`, list: true, view: r.view }
+    },
+    get: {
+      method: "get",
+      path: one,
+      scopes: [r.read],
+      tag: r.tag,
+      summary: `Get a ${r.noun}`,
+      description: `Fetch one ${r.noun} by id.`,
+      status: 200,
+      response: { description: `The ${r.noun}.`, view: r.view },
+      errors: { 404: true }
+    },
+    create: {
+      method: "post",
+      path: base,
+      scopes: [r.write],
+      tag: r.tag,
+      summary: `Create a ${r.noun}`,
+      description: `Create a ${r.noun}; fires the \`${event}.created\` webhook.`,
+      body: r.create,
+      status: 201,
+      response: { description: `The created ${r.noun}.`, view: r.view },
+      errors: { 400: true, 409: true },
+      webhook: `${event}.created`
+    },
+    update: {
+      method: "patch",
+      path: one,
+      scopes: [r.write],
+      tag: r.tag,
+      summary: `Update a ${r.noun}`,
+      description: `Patch a ${r.noun}; fires the \`${event}.updated\` webhook.`,
+      body: r.update,
+      status: 200,
+      response: { description: `The updated ${r.noun}.`, view: r.view },
+      errors: { 400: true, 404: true, 409: true },
+      webhook: `${event}.updated`
+    },
+    remove: {
+      method: "delete",
+      path: one,
+      scopes: [r.write],
+      tag: r.tag,
+      summary: `Delete a ${r.noun}`,
+      description: `Delete a ${r.noun}; fires the \`${event}.deleted\` webhook.`,
+      status: 204,
+      response: { description: "Deleted." },
+      errors: { 404: true },
+      webhook: `${event}.deleted`
+    }
+  };
+}
+
 // ../../packages/schema/src/operations/define.ts
 function defineOperations(table) {
   return table;
@@ -29603,6 +29712,74 @@ function routeOf(op) {
   return `${op.method.toUpperCase()} ${PUBLIC_API_PREFIX}${op.path}`;
 }
 
+// ../../packages/schema/src/operations/inventory-items.ts
+var inventoryItemOperations = defineOperations({
+  ...crudOperations({
+    segment: "inventory-items",
+    tag: "Inventory",
+    noun: "inventory item",
+    read: "inventory:read",
+    write: "inventory:write",
+    create: createInventoryItemInputSchema,
+    update: updateInventoryItemInputSchema,
+    paginated: true,
+    listQuerySchema: paginationQuerySchema
+  })
+});
+
+// ../../packages/schema/src/operations/meal-plans.ts
+var mealPlanOperations = defineOperations({
+  ...crudOperations({
+    segment: "meal-plans",
+    tag: "Meals",
+    noun: "meal plan",
+    read: "meals:read",
+    write: "meals:write",
+    create: createMealPlanInputSchema,
+    update: updateMealPlanInputSchema
+  })
+});
+
+// ../../packages/schema/src/operations/periods.ts
+var periodOperations = defineOperations({
+  ...crudOperations({
+    segment: "periods",
+    tag: "Periods",
+    noun: "period",
+    read: "periods:read",
+    write: "periods:write",
+    create: createPeriodInputSchema,
+    update: updatePeriodInputSchema,
+    listQuery: [
+      { name: "nodeId", description: "Only the periods on this node." },
+      {
+        name: "kind",
+        description: "Only this kind (`hibernation`, `quarantine`, `away`, `treatment_course`, `withdrawal`, \u2026)."
+      },
+      {
+        name: "active",
+        description: "`true`: only running periods; `false`: only ended or not yet started."
+      }
+    ],
+    listQuerySchema: periodsQuerySchema
+  })
+});
+
+// ../../packages/schema/src/operations/shopping-lists.ts
+var shoppingListOperations = defineOperations({
+  ...crudOperations({
+    segment: "shopping-lists",
+    tag: "Shopping",
+    noun: "shopping list",
+    read: "shopping:read",
+    write: "shopping:write",
+    create: createShoppingListInputSchema,
+    update: updateShoppingListInputSchema,
+    paginated: true,
+    listQuerySchema: paginationQuerySchema
+  })
+});
+
 // ../../packages/schema/src/operations/tap-tags.ts
 var READ = ["habits:read", "routines:read"];
 var WRITE = ["habits:write", "routines:write"];
@@ -29934,7 +30111,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.302.0";
+var VERSION = "1.303.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -30843,12 +31020,9 @@ var ENTITIES = [
       canDelete: true
     }
   },
-  {
+  entityFromOperations(periodOperations, {
     name: "periods",
-    path: "/periods",
-    readScopes: ["periods:read"],
     returns: "PeriodView",
-    canGet: true,
     listFlags: [
       { name: "node", description: "only the periods on this node id", query: "nodeId" },
       {
@@ -30862,15 +31036,9 @@ var ENTITIES = [
         query: "active"
       }
     ],
-    write: {
-      scopes: ["periods:write"],
-      createSchema: createPeriodInputSchema,
-      createInput: "CreatePeriodInput",
-      updateSchema: updatePeriodInputSchema,
-      updateInput: "UpdatePeriodInput",
-      canDelete: true
-    }
-  },
+    createInput: "CreatePeriodInput",
+    updateInput: "UpdatePeriodInput"
+  }),
   entityFromOperations(tapTagOperations, {
     name: "tap-tags",
     returns: "TapTagView",
@@ -30932,38 +31100,20 @@ var ENTITIES = [
       canDelete: true
     }
   },
-  {
+  entityFromOperations(shoppingListOperations, {
     name: "shopping-lists",
-    path: "/shopping-lists",
-    readScopes: ["shopping:read"],
     returns: "ShoppingList",
-    canGet: true,
     listFlags: [],
-    write: {
-      scopes: ["shopping:write"],
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
-  {
+    createInput: "CreateShoppingListInput",
+    updateInput: "UpdateShoppingListInput"
+  }),
+  entityFromOperations(inventoryItemOperations, {
     name: "inventory-items",
-    path: "/inventory-items",
-    readScopes: ["inventory:read"],
     returns: "InventoryItem",
-    canGet: true,
     listFlags: [],
-    write: {
-      scopes: ["inventory:write"],
-      createSchema: createInventoryItemInputSchema,
-      createInput: "CreateInventoryItemInput",
-      updateSchema: updateInventoryItemInputSchema,
-      updateInput: "UpdateInventoryItemInput",
-      canDelete: true
-    }
-  },
+    createInput: "CreateInventoryItemInput",
+    updateInput: "UpdateInventoryItemInput"
+  }),
   {
     name: "recipes",
     path: "/recipes",
@@ -30980,22 +31130,13 @@ var ENTITIES = [
       canDelete: true
     }
   },
-  {
+  entityFromOperations(mealPlanOperations, {
     name: "meal-plans",
-    path: "/meal-plans",
-    readScopes: ["meals:read"],
     returns: "MealPlan",
-    canGet: true,
     listFlags: [],
-    write: {
-      scopes: ["meals:write"],
-      createSchema: createMealPlanInputSchema,
-      createInput: "CreateMealPlanInput",
-      updateSchema: updateMealPlanInputSchema,
-      updateInput: "UpdateMealPlanInput",
-      canDelete: true
-    }
-  },
+    createInput: "CreateMealPlanInput",
+    updateInput: "UpdateMealPlanInput"
+  }),
   {
     name: "occurrences",
     path: "/occurrences",
@@ -31500,6 +31641,24 @@ var HEALTH_COMMAND_SPECS = [
     returns: "GoogleHealthSyncResult",
     notes: "POST /api/v1/health/google-health/sync. Written and skipped per resource, and the status after it; a sync that stops answers 200 with `status.failure`. 409 before Google Health is connected, 403 while the server has it switched off."
   },
+  {
+    path: ["health", "withings", "status"],
+    summary: "Whether your Withings scale is connected, the last sync, and what stops it.",
+    args: [],
+    flags: [],
+    scopes: READ2,
+    returns: "WithingsStatus",
+    notes: "GET /api/v1/health/withings. Connecting needs Withings' consent in a browser: Settings \u2192 Health in do. `failure` (reauth, unavailable, other) says what stops the sync, with a title and a hint."
+  },
+  {
+    path: ["health", "withings", "sync"],
+    summary: "Sync your Withings weigh-ins now, as the morning sync does.",
+    args: [],
+    flags: [],
+    scopes: WRITE3,
+    returns: "WithingsSyncResult",
+    notes: "POST /api/v1/health/withings/sync. Written and skipped, and the status after it; a sync that stops answers 200 with `status.failure`. 409 before Withings is connected, 403 while the server has it switched off."
+  },
   {
     path: ["health", "analyte"],
     summary: "One analyte's trend across draws (do health analyte vitamin_d).",
@@ -36030,23 +36189,23 @@ var COMMAND_SPECS = [
   },
   {
     path: ["guest-lists", "export"],
-    summary: "Export for the caterer, the venue, the church or the RSVP answers (CSV) to stdout, or save the floor plan (PDF) to a file.",
+    summary: "Export for the caterer, the venue, the church or the RSVP answers (CSV) to stdout, or save the floor plan or the paper invitations (PDF) to a file.",
     args: [{ name: "id", required: true, description: "The guest list's id." }],
     flags: [
       {
         name: "kind",
         type: "string",
-        description: "caterer (meals and diets per table), venue (who sits where), church (who comes to the ceremony), answers (every RSVP answer, a row per guest) or floor-plan (PDF)."
+        description: "caterer (meals and diets per table), venue (who sits where), church (who comes to the ceremony), answers (every RSVP answer, a row per guest), floor-plan (PDF) or invitations (PDF: a card per household with a live RSVP link, its QR and code)."
       },
       {
         name: "out",
         type: "string",
-        description: "Where to save the floor plan (default: the name the API gives it)."
+        description: "Where to save a PDF (default: the name the API gives it)."
       }
     ],
     scopes: ["contacts:read"],
     returns: "string",
-    notes: "A CSV goes to stdout (`> tables.csv`); the floor plan is saved: `do guest-lists export <id> --kind floor-plan --out plan.pdf`."
+    notes: "A CSV goes to stdout (`> tables.csv`); a PDF is saved: `do guest-lists export <id> --kind invitations --out invitations.pdf`. Mint the links first (`do rsvp-links create`); the QR opens the list's `siteUrl` + /i/<token>, and its `sitePassword` is printed only when set."
   },
   {
     path: ["rsvp-links", "list"],
@@ -41192,6 +41351,14 @@ var HANDLERS = {
     data: await requireClient().delete(`/health/shares/${requireArg(args, 0, "id")}`),
     render: renderRecord
   }),
+  "health withings status": async ({ requireClient }) => ({
+    data: await requireClient().get("/health/withings"),
+    render: renderRecord
+  }),
+  "health withings sync": async ({ requireClient }) => ({
+    data: await requireClient().post("/health/withings/sync", {}),
+    render: renderRecord
+  }),
   "health google status": async ({ requireClient }) => ({
     data: await requireClient().get("/health/google-health"),
     render: renderRecord
@@ -41683,9 +41850,9 @@ var HANDLERS = {
     const id = requireArg(args, 0, "guest list id");
     const kind = parseInput(guestExportKindSchema, flagString(flags, "kind") ?? "venue");
     const path = `/guest-lists/${id}/exports/${kind}`;
-    if (kind === "floor-plan") {
+    if (kind === "floor-plan" || kind === "invitations") {
       const file = await requireClient().getBytes(path);
-      const out = flagString(flags, "out") ?? basename2(file.name ?? "floor-plan.pdf");
+      const out = flagString(flags, "out") ?? basename2(file.name ?? `${kind}.pdf`);
       writeFileSync2(out, file.bytes);
       return {
         data: { id, kind, saved: out, size: file.bytes.byteLength, type: file.contentType },

package/package.json

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