@objectstack/rest 14.8.0 → 15.0.0

package/dist/index.js

@@ -1068,7 +1068,7 @@ async function prepareImportRequest(body, opts) {
   const dryRun = body?.dryRun === true;
   let writeMode = body?.writeMode === "update" || body?.writeMode === "upsert" ? body.writeMode : "insert";
   let matchFields = Array.isArray(body?.matchFields) ? body.matchFields.filter((f) => typeof f === "string" && f.length > 0) : [];
-  const runAutomations = body?.runAutomations === true;
+  const runAutomations = body?.runAutomations !== false;
   const trimWhitespace = body?.trimWhitespace !== false;
   const nullValues = Array.isArray(body?.nullValues) ? body.nullValues.filter((v) => typeof v === "string") : void 0;
   const createMissingOptions = body?.createMissingOptions === true;
@@ -4859,12 +4859,15 @@ var RestServer = class _RestServer {
         const parsed = ExplainRequestSchema.safeParse({
           object: src.object,
           operation: src.operation ?? "read",
-          ...src.userId != null && src.userId !== "" ? { userId: src.userId } : {}
+          ...src.userId != null && src.userId !== "" ? { userId: src.userId } : {},
+          // [C2 / ADR-0095] Optional record id — explains ONE concrete
+          // row at record granularity; omitted stays object-level.
+          ...src.recordId != null && src.recordId !== "" ? { recordId: src.recordId } : {}
         });
         if (!parsed.success) {
           return res.status(400).json({
             code: "VALIDATION_FAILED",
-            message: "Invalid explain request \u2014 expected { object: string, operation: read|create|update|delete|transfer|restore|purge, userId?: string }.",
+            message: "Invalid explain request \u2014 expected { object: string, operation: read|create|update|delete|transfer|restore|purge, userId?: string, recordId?: string }.",
             detail: String(parsed.error?.message ?? "").slice(0, 1e3)
           });
         }