@read-frog/api-contract 0.16.0 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@read-frog/api-contract",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@orpc/contract": "^1.14.6",
     "zod": "^4.5.4",
-    "@read-frog/definitions": "0.5.1"
+    "@read-frog/definitions": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.0",

package/src/contracts/notebase-row.ts

@@ -13,10 +13,14 @@ import {
   NotebaseRowCreateManyOutputSchema,
   NotebaseRowCreateOutputSchema,
   NotebaseRowDeleteInputSchema,
+  NotebaseRowDeleteManyInputSchema,
+  NotebaseRowDeleteManyOutputSchema,
   NotebaseRowDeleteOutputSchema,
   NotebaseRowReorderInputSchema,
   NotebaseRowReorderOutputSchema,
   NotebaseRowUpdateInputSchema,
+  NotebaseRowUpdateManyInputSchema,
+  NotebaseRowUpdateManyOutputSchema,
   NotebaseRowUpdateOutputSchema,
 } from "#/schemas/notebase-row";
 
@@ -96,6 +100,21 @@ export const notebaseRowContract = {
     .input(NotebaseRowUpdateInputSchema)
     .output(NotebaseRowUpdateOutputSchema),
 
+  updateMany: defineAgentProcedure({
+    method: "PATCH",
+    path: "/notebase-rows/batch",
+    summary: "Update notes",
+    description:
+      "Update 1–50 notes atomically in one owned notebase. Each row supplies its ID and fields to merge; omitted fields are preserved and null clears a field. Supply each note's expectedUpdatedAt to guard against stale edits. A missing row, invalid field or modification conflict rolls back the whole batch. Items are returned in input order.",
+    tags: ["Notebase Rows"],
+  })
+    .errors(
+      pickPublicErrorMap("NOTEBASE_NOT_FOUND", "NOTEBASE_ROW_NOT_FOUND", "CELL_VALIDATION_FAILED"),
+    )
+    .errors(pickPublicErrorMap("RESOURCE_UPDATE_CONFLICT"))
+    .input(NotebaseRowUpdateManyInputSchema)
+    .output(NotebaseRowUpdateManyOutputSchema),
+
   delete: defineAgentProcedure({
     method: "DELETE",
     path: "/notebase-rows/{notebaseRowId}",
@@ -108,6 +127,18 @@ export const notebaseRowContract = {
     .input(NotebaseRowDeleteInputSchema)
     .output(NotebaseRowDeleteOutputSchema),
 
+  deleteMany: defineAgentProcedure({
+    method: "POST",
+    path: "/notebase-rows/batch/delete",
+    summary: "Delete notes",
+    description:
+      "Permanently delete 1–50 owned notes atomically, including their derived cards and review records. Notes may belong to different notebases. If any ID is missing or inaccessible, nothing is deleted. Return deleted IDs in input order.",
+    tags: ["Notebase Rows"],
+  })
+    .errors(pickPublicErrorMap("NOTEBASE_ROW_NOT_FOUND", "CONCURRENT_POSITION_CONFLICT"))
+    .input(NotebaseRowDeleteManyInputSchema)
+    .output(NotebaseRowDeleteManyOutputSchema),
+
   reorder: oc
     .errors(pickPublicErrorMap("NOTEBASE_NOT_FOUND", "CONCURRENT_POSITION_CONFLICT"))
     .route({

package/src/public-errors.ts

@@ -32,7 +32,7 @@ export const CellValidationFailedDataSchema = z
     notebaseColumnId: z.string(),
     details: CellValidationFailureDetailsSchema,
     reason: CellValidationFailureReasonSchema,
-    /** Index of the failing row within a batch input (createMany / initialRows). */
+    /** Index of the failing row within a batch input (createMany / updateMany / initialRows). */
     rowIndex: z.number().int().min(0).optional(),
   })
   .strict();

package/src/schemas/notebase-row.ts

@@ -94,6 +94,42 @@ export const NotebaseRowUpdateOutputSchema = z.object({
 });
 export type NotebaseRowUpdateOutput = z.infer<typeof NotebaseRowUpdateOutputSchema>;
 
+export const NOTEBASE_ROW_UPDATE_MANY_MAX_ROWS = 50;
+
+export const NotebaseRowUpdateManyInputSchema = z
+  .object({
+    notebaseId: z.uuid(),
+    rows: z
+      .array(
+        z.object({
+          id: z.uuid(),
+          data: notebaseRowUpdateDataSchema,
+        }),
+      )
+      .min(1)
+      .max(NOTEBASE_ROW_UPDATE_MANY_MAX_ROWS),
+  })
+  .superRefine((input, ctx) => {
+    const seenIds = new Set<string>();
+    input.rows.forEach((row, index) => {
+      if (seenIds.has(row.id)) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Duplicate row id "${row.id}".`,
+          path: ["rows", index, "id"],
+        });
+      }
+      seenIds.add(row.id);
+    });
+  });
+export type NotebaseRowUpdateManyInput = z.infer<typeof NotebaseRowUpdateManyInputSchema>;
+
+export const NotebaseRowUpdateManyOutputSchema = z.object({
+  items: z.array(notebaseRowSchema),
+  txid: z.number(),
+});
+export type NotebaseRowUpdateManyOutput = z.infer<typeof NotebaseRowUpdateManyOutputSchema>;
+
 export const NotebaseRowDeleteInputSchema = z.object({
   notebaseRowId: z.uuid(),
 });
@@ -102,6 +138,30 @@ export type NotebaseRowDeleteInput = z.infer<typeof NotebaseRowDeleteInputSchema
 export const NotebaseRowDeleteOutputSchema = deletionResultSchema;
 export type NotebaseRowDeleteOutput = z.infer<typeof NotebaseRowDeleteOutputSchema>;
 
+export const NOTEBASE_ROW_DELETE_MANY_MAX_ROWS = 50;
+
+export const NotebaseRowDeleteManyInputSchema = z
+  .object({
+    ids: z.array(z.uuid()).min(1).max(NOTEBASE_ROW_DELETE_MANY_MAX_ROWS),
+  })
+  .superRefine((input, ctx) => {
+    const seenIds = new Set<string>();
+    input.ids.forEach((id, index) => {
+      if (seenIds.has(id)) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Duplicate row id "${id}".`,
+          path: ["ids", index],
+        });
+      }
+      seenIds.add(id);
+    });
+  });
+export type NotebaseRowDeleteManyInput = z.infer<typeof NotebaseRowDeleteManyInputSchema>;
+
+export const NotebaseRowDeleteManyOutputSchema = z.object({ ids: z.array(z.uuid()) });
+export type NotebaseRowDeleteManyOutput = z.infer<typeof NotebaseRowDeleteManyOutputSchema>;
+
 export const NotebaseRowReorderInputSchema = z.object({
   notebaseId: z.uuid(),
   ids: z.array(z.uuid()),