convex 1.46.0 → 1.48.0-alpha.0

package/dist/cjs/cli/lib/checkForLargeIndexBackfill.js

@@ -0,0 +1,113 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var checkForLargeIndexBackfill_exports = {};
+__export(checkForLargeIndexBackfill_exports, {
+  blockingIndexesFromSchemaEvaluation: () => blockingIndexesFromSchemaEvaluation,
+  checkForLargeIndexBackfill: () => checkForLargeIndexBackfill
+});
+module.exports = __toCommonJS(checkForLargeIndexBackfill_exports);
+var import_chalk = require("chalk");
+var import_log = require("../../bundler/log.js");
+var import_indexes = require("./indexes.js");
+var import_prompts = require("./utils/prompts.js");
+var import_utils = require("./utils/utils.js");
+const MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING = 1e5;
+async function checkForLargeIndexBackfill({
+  ctx,
+  span,
+  schemaEvaluation,
+  options,
+  mode
+}) {
+  (0, import_log.changeSpinner)("Verifying that the push isn\u2019t creating large indexes...");
+  const response = await schemaEvaluation(span);
+  if (response === null) {
+    return;
+  }
+  const blockingIndexes = blockingIndexesFromSchemaEvaluation(
+    response,
+    minDocumentsForIndexBackfillWarning()
+  );
+  if (blockingIndexes.length === 0) {
+    return;
+  }
+  const plural = blockingIndexes.length !== 1;
+  (0, import_log.logMessage)(`\u26A0\uFE0F  This push will ${import_chalk.chalkStderr.bold("create")} the following ${plural ? "indexes on large tables" : "index on a large table"}
+in your deployment (${options.url}). The deploy will block until ${plural ? "they finish" : "it finishes"} backfilling:
+
+${blockingIndexes.map(formatBlockingIndex).join("\n")}
+
+Tip: stage the index (e.g. \`.index("by_field", { fields: ["field"], staged: true })\`) to backfill
+it in the background without blocking the deploy, then remove \`staged\` in a later push once it\u2019s ready.
+Learn more at https://docs.convex.dev/database/reading-data/indexes#staged-indexes
+`);
+  if (mode === "warn") {
+    return;
+  }
+  if (mode === "has confirmation") {
+    (0, import_log.logFinishedStep)(
+      "Proceeding with push since --skip-large-indexes-check is set"
+    );
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    return ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `To confirm the push:
+\u2022 run the deploy command in an ${import_chalk.chalkStderr.bold("interactive terminal")}
+\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--skip-large-indexes-check")} flag`
+    });
+  }
+  (0, import_log.stopSpinner)();
+  if (!await (0, import_prompts.promptYesNo)(ctx, {
+    message: `Create ${plural ? "these indexes" : "this index"} now?`,
+    default: false
+  })) {
+    return ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `Canceling push`
+    });
+  }
+  (0, import_log.logFinishedStep)("Proceeding with push.");
+}
+function blockingIndexesFromSchemaEvaluation(response, minDocuments) {
+  return Object.entries(response.componentSchemaEvaluations).flatMap(
+    ([componentPath, prediction]) => prediction.indexes.filter(
+      (index) => index.needsBackfill && !index.staged && (index.change === "added" || index.change === "enabled") && index.numDocs >= minDocuments
+    ).map((index) => ({ componentPath, index }))
+  );
+}
+function formatBlockingIndex({ componentPath, index }) {
+  const componentNameFormatted = componentPath !== "" ? `${import_chalk.chalkStderr.gray(componentPath)}:` : "";
+  const documentsCountFormatted = import_chalk.chalkStderr.yellowBright(
+    `\u26A0\uFE0F  ${index.numDocs.toLocaleString()} documents`
+  );
+  const enabledNote = index.change === "enabled" ? `
+   ${import_chalk.chalkStderr.gray("enabled before its staged backfill finished")}` : "";
+  return "\u26D4 " + componentNameFormatted + (0, import_indexes.formatIndex)(index) + "  " + documentsCountFormatted + enabledNote;
+}
+function minDocumentsForIndexBackfillWarning() {
+  return (0, import_utils.integerFromEnv)(
+    "CONVEX_MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING",
+    MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING
+  );
+}
+//# sourceMappingURL=checkForLargeIndexBackfill.js.map

package/dist/cjs/cli/lib/checkForLargeIndexBackfill.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/lib/checkForLargeIndexBackfill.ts"],
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../../bundler/context.js\";\nimport {\n  changeSpinner,\n  logFinishedStep,\n  logMessage,\n  stopSpinner,\n} from \"../../bundler/log.js\";\nimport { formatIndex } from \"./indexes.js\";\nimport { promptYesNo } from \"./utils/prompts.js\";\nimport { Span } from \"./tracing.js\";\nimport {\n  EvaluateSchemaResponse,\n  IndexPrediction,\n} from \"./deployApi/evaluateSchema.js\";\nimport { SchemaEvaluation } from \"./schemaEvaluation.js\";\nimport { integerFromEnv } from \"./utils/utils.js\";\n\n// Same size as the large index deletion check, so both index guards fire at\n// the same table size. Separate env override so tests can trigger one\n// without the other.\nconst MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING = 100_000;\n\nexport type LargeIndexBackfillCheck =\n  // Don\u2019t check whether the push creates indexes on large tables\n  | \"no verification\"\n  // If it does, ask for confirmation (and fail in non-interactive envs)\n  | \"ask for confirmation\"\n  // If it does, proceed (the user has used --skip-large-indexes-check)\n  | \"has confirmation\";\n\ntype BlockingIndex = {\n  // The component instance path (\"\" for the root component), matching the\n  // keys of `componentSchemaEvaluations`.\n  componentPath: string;\n  index: IndexPrediction;\n};\n\n/**\n * Warn \u2014 and on a real deploy require confirmation \u2014 when a push creates or\n * enables a non-staged index on a large table. `wait_for_schema` blocks the\n * deploy until every such index is backfilled, which can take a long time on\n * large tables; staging the index instead backfills it in the background.\n *\n * Skipped silently when the deployment doesn't support `evaluate_schema`:\n * the check protects the developer's time, not correctness.\n */\nexport async function checkForLargeIndexBackfill({\n  ctx,\n  span,\n  schemaEvaluation,\n  options,\n  mode,\n}: {\n  ctx: Context;\n  span: Span;\n  schemaEvaluation: SchemaEvaluation;\n  options: { url: string };\n  // \"warn\" prints the warning without prompting, for dry runs.\n  mode: \"warn\" | \"ask for confirmation\" | \"has confirmation\";\n}): Promise<void> {\n  changeSpinner(\"Verifying that the push isn\u2019t creating large indexes...\");\n  const response = await schemaEvaluation(span);\n  if (response === null) {\n    return;\n  }\n\n  const blockingIndexes = blockingIndexesFromSchemaEvaluation(\n    response,\n    minDocumentsForIndexBackfillWarning(),\n  );\n  if (blockingIndexes.length === 0) {\n    return;\n  }\n\n  const plural = blockingIndexes.length !== 1;\n  logMessage(`\u26A0\uFE0F  This push will ${chalkStderr.bold(\"create\")} the following ${plural ? \"indexes on large tables\" : \"index on a large table\"}\nin your deployment (${options.url}). The deploy will block until ${plural ? \"they finish\" : \"it finishes\"} backfilling:\n\n${blockingIndexes.map(formatBlockingIndex).join(\"\\n\")}\n\nTip: stage the index (e.g. \\`.index(\"by_field\", { fields: [\"field\"], staged: true })\\`) to backfill\nit in the background without blocking the deploy, then remove \\`staged\\` in a later push once it\u2019s ready.\nLearn more at https://docs.convex.dev/database/reading-data/indexes#staged-indexes\n`);\n\n  if (mode === \"warn\") {\n    return;\n  }\n\n  if (mode === \"has confirmation\") {\n    logFinishedStep(\n      \"Proceeding with push since --skip-large-indexes-check is set\",\n    );\n    return;\n  }\n\n  if (!process.stdin.isTTY) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `To confirm the push:\n\u2022 run the deploy command in an ${chalkStderr.bold(\"interactive terminal\")}\n\u2022 or run the deploy command with the ${chalkStderr.bold(\"--skip-large-indexes-check\")} flag`,\n    });\n  }\n\n  stopSpinner();\n  if (\n    !(await promptYesNo(ctx, {\n      message: `Create ${plural ? \"these indexes\" : \"this index\"} now?`,\n      default: false,\n    }))\n  ) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Canceling push`,\n    });\n  }\n\n  logFinishedStep(\"Proceeding with push.\");\n}\n\n// An index blocks the deploy when this push starts (`added`) or waits on\n// (`enabled` before its staged backfill finished) a backfill that isn't\n// staged. Added staged indexes report `needsBackfill` too but never block,\n// and an in-progress backfill an earlier push started (`identical`) isn't\n// this push's doing.\nexport function blockingIndexesFromSchemaEvaluation(\n  response: EvaluateSchemaResponse,\n  minDocuments: number,\n): BlockingIndex[] {\n  return Object.entries(response.componentSchemaEvaluations).flatMap(\n    ([componentPath, prediction]) =>\n      prediction.indexes\n        .filter(\n          (index) =>\n            index.needsBackfill &&\n            !index.staged &&\n            (index.change === \"added\" || index.change === \"enabled\") &&\n            index.numDocs >= minDocuments,\n        )\n        .map((index) => ({ componentPath, index })),\n  );\n}\n\nfunction formatBlockingIndex({ componentPath, index }: BlockingIndex) {\n  const componentNameFormatted =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}:` : \"\";\n  const documentsCountFormatted = chalkStderr.yellowBright(\n    `\u26A0\uFE0F  ${index.numDocs.toLocaleString()} documents`,\n  );\n  const enabledNote =\n    index.change === \"enabled\"\n      ? `\\n   ${chalkStderr.gray(\"enabled before its staged backfill finished\")}`\n      : \"\";\n  return (\n    \"\u26D4 \" +\n    componentNameFormatted +\n    formatIndex(index) +\n    \"  \" +\n    documentsCountFormatted +\n    enabledNote\n  );\n}\n\nfunction minDocumentsForIndexBackfillWarning(): number {\n  return integerFromEnv(\n    \"CONVEX_MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING\",\n    MIN_DOCUMENTS_FOR_INDEX_BACKFILL_WARNING,\n  );\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4B;AAE5B,iBAKO;AACP,qBAA4B;AAC5B,qBAA4B;AAO5B,mBAA+B;AAK/B,MAAM,2CAA2C;AA0BjD,eAAsB,2BAA2B;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOkB;AAChB,gCAAc,8DAAyD;AACvE,QAAM,WAAW,MAAM,iBAAiB,IAAI;AAC5C,MAAI,aAAa,MAAM;AACrB;AAAA,EACF;AAEA,QAAM,kBAAkB;AAAA,IACtB;AAAA,IACA,oCAAoC;AAAA,EACtC;AACA,MAAI,gBAAgB,WAAW,GAAG;AAChC;AAAA,EACF;AAEA,QAAM,SAAS,gBAAgB,WAAW;AAC1C,6BAAW,gCAAsB,yBAAY,KAAK,QAAQ,CAAC,kBAAkB,SAAS,4BAA4B,wBAAwB;AAAA,sBACtH,QAAQ,GAAG,kCAAkC,SAAS,gBAAgB,aAAa;AAAA;AAAA,EAEvG,gBAAgB,IAAI,mBAAmB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,CAKpD;AAEC,MAAI,SAAS,QAAQ;AACnB;AAAA,EACF;AAEA,MAAI,SAAS,oBAAoB;AAC/B;AAAA,MACE;AAAA,IACF;AACA;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,MAAM,OAAO;AACxB,WAAO,IAAI,MAAM;AAAA,MACf,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBAAgB;AAAA,sCACW,yBAAY,KAAK,sBAAsB,CAAC;AAAA,4CAClC,yBAAY,KAAK,4BAA4B,CAAC;AAAA,IACjF,CAAC;AAAA,EACH;AAEA,8BAAY;AACZ,MACE,CAAE,UAAM,4BAAY,KAAK;AAAA,IACvB,SAAS,UAAU,SAAS,kBAAkB,YAAY;AAAA,IAC1D,SAAS;AAAA,EACX,CAAC,GACD;AACA,WAAO,IAAI,MAAM;AAAA,MACf,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,kCAAgB,uBAAuB;AACzC;AAOO,SAAS,oCACd,UACA,cACiB;AACjB,SAAO,OAAO,QAAQ,SAAS,0BAA0B,EAAE;AAAA,IACzD,CAAC,CAAC,eAAe,UAAU,MACzB,WAAW,QACR;AAAA,MACC,CAAC,UACC,MAAM,iBACN,CAAC,MAAM,WACN,MAAM,WAAW,WAAW,MAAM,WAAW,cAC9C,MAAM,WAAW;AAAA,IACrB,EACC,IAAI,CAAC,WAAW,EAAE,eAAe,MAAM,EAAE;AAAA,EAChD;AACF;AAEA,SAAS,oBAAoB,EAAE,eAAe,MAAM,GAAkB;AACpE,QAAM,yBACJ,kBAAkB,KAAK,GAAG,yBAAY,KAAK,aAAa,CAAC,MAAM;AACjE,QAAM,0BAA0B,yBAAY;AAAA,IAC1C,iBAAO,MAAM,QAAQ,eAAe,CAAC;AAAA,EACvC;AACA,QAAM,cACJ,MAAM,WAAW,YACb;AAAA,KAAQ,yBAAY,KAAK,6CAA6C,CAAC,KACvE;AACN,SACE,YACA,6BACA,4BAAY,KAAK,IACjB,OACA,0BACA;AAEJ;AAEA,SAAS,sCAA8C;AACrD,aAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/cjs/cli/lib/checkForLargeIndexDeletion.js

@@ -29,21 +29,34 @@ var import_indexes = require("./indexes.js");
 var import_prompts = require("./utils/prompts.js");
 var import_deploy2 = require("./deploy2.js");
 var import_run = require("./run.js");
+var import_utils = require("./utils/utils.js");
 const MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING = 1e5;
 async function checkForLargeIndexDeletion({
   ctx,
   span,
   request,
   options,
+  schemaEvaluation,
   askForConfirmation
 }) {
   (0, import_log.changeSpinner)("Verifying that the push isn\u2019t deleting large indexes...");
-  const deletedIndexes = await deletedIndexesFromSchemaEvaluation({
-    ctx,
-    span,
-    request,
-    options
-  }) ?? await deletedIndexesFromTableSizes({ ctx, span, request, options });
+  const schemaEvaluationResponse = await schemaEvaluation(span);
+  let deletedIndexes;
+  if (schemaEvaluationResponse !== null) {
+    deletedIndexes = deletedIndexesFromSchemaEvaluation(
+      schemaEvaluationResponse
+    );
+  } else {
+    (0, import_log.logVerbose)(
+      "Schema evaluation unavailable, sizing deleted indexes per table"
+    );
+    deletedIndexes = await deletedIndexesFromTableSizes({
+      ctx,
+      span,
+      request,
+      options
+    });
+  }
   if (deletedIndexes.length === 0) {
     (0, import_log.logFinishedStep)("No indexes are deleted by this push");
     return;
@@ -67,7 +80,7 @@ to be backfilled again if you want to restore it later.
 `);
   if (!askForConfirmation) {
     (0, import_log.logFinishedStep)(
-      "Proceeding with push since --allow-deleting-large-indexes is set"
+      "Proceeding with push since deleting large indexes was allowed by flag"
     );
     return;
   }
@@ -77,7 +90,7 @@ to be backfilled again if you want to restore it later.
       errorType: "fatal",
       printedMessage: `To confirm the push:
 \u2022 run the deploy command in an ${import_chalk.chalkStderr.bold("interactive terminal")}
-\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--allow-deleting-large-indexes")} flag`
+\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--skip-large-indexes-check")} flag`
     });
   }
   (0, import_log.stopSpinner)();
@@ -93,37 +106,17 @@ to be backfilled again if you want to restore it later.
   }
   (0, import_log.logFinishedStep)("Proceeding with push.");
 }
-async function deletedIndexesFromSchemaEvaluation({
-  ctx,
-  span,
-  request,
-  options
-}) {
-  try {
-    const response = await (0, import_deploy2.evaluateSchema)(
-      ctx,
-      span,
-      request,
-      options,
-      /* bestEffort */
-      true
-    );
-    return Object.entries(response.componentSchemaEvaluations).flatMap(
-      ([componentPath, prediction]) => prediction.indexes.filter((index) => index.change === "dropped").map((index) => ({
-        componentPath,
-        index,
-        documentsCount: index.numDocs,
-        replacedBy: prediction.indexes.find(
-          (other) => other.change === "added" && other.name === index.name
-        ) ?? null
-      }))
-    );
-  } catch (error) {
-    (0, import_log.logVerbose)(
-      `Schema evaluation unavailable, sizing deleted indexes per table: ${error instanceof Error ? error.message : String(error)}`
-    );
-    return null;
-  }
+function deletedIndexesFromSchemaEvaluation(response) {
+  return Object.entries(response.componentSchemaEvaluations).flatMap(
+    ([componentPath, prediction]) => prediction.indexes.filter((index) => index.change === "dropped").map((index) => ({
+      componentPath,
+      index,
+      documentsCount: index.numDocs,
+      replacedBy: prediction.indexes.find(
+        (other) => other.change === "added" && other.name === index.name
+      ) ?? null
+    }))
+  );
 }
 async function deletedIndexesFromTableSizes({
   ctx,
@@ -194,13 +187,9 @@ function getTableName(index) {
   return tableName;
 }
 function minDocumentsForIndexDeleteWarning() {
-  const envValue = process.env.CONVEX_MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING;
-  if (envValue !== void 0) {
-    const parsed = parseInt(envValue, 10);
-    if (!isNaN(parsed)) {
-      return parsed;
-    }
-  }
-  return MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING;
+  return (0, import_utils.integerFromEnv)(
+    "CONVEX_MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING",
+    MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING
+  );
 }
 //# sourceMappingURL=checkForLargeIndexDeletion.js.map

package/dist/cjs/cli/lib/checkForLargeIndexDeletion.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/checkForLargeIndexDeletion.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../../bundler/context.js\";\nimport {\n  changeSpinner,\n  logFinishedStep,\n  logMessage,\n  logVerbose,\n  stopSpinner,\n} from \"../../bundler/log.js\";\nimport { formatIndex } from \"./indexes.js\";\nimport { promptYesNo } from \"./utils/prompts.js\";\nimport { Span } from \"./tracing.js\";\nimport { StartPushRequest } from \"./deployApi/startPush.js\";\nimport { evaluatePush, evaluateSchema } from \"./deploy2.js\";\nimport { DeveloperIndexConfig } from \"./deployApi/finishPush.js\";\nimport { runSystemQuery } from \"./run.js\";\n\nconst MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING = 100_000;\n\ntype CheckOptions = {\n  url: string;\n  deploymentName: string | null;\n  adminKey: string;\n};\n\ntype DeletedIndex = {\n  // The component instance path (\"\" for the root component), matching the\n  // keys of both `componentSchemaEvaluations` and `indexDiffs`.\n  componentPath: string;\n  index: DeveloperIndexConfig;\n  documentsCount: number;\n  replacedBy: DeveloperIndexConfig | null;\n};\n\nexport async function checkForLargeIndexDeletion({\n  ctx,\n  span,\n  request,\n  options,\n  askForConfirmation,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: CheckOptions;\n  askForConfirmation: boolean;\n}): Promise<void> {\n  changeSpinner(\"Verifying that the push isn\u2019t deleting large indexes...\");\n\n  const deletedIndexes =\n    (await deletedIndexesFromSchemaEvaluation({\n      ctx,\n      span,\n      request,\n      options,\n    })) ??\n    (await deletedIndexesFromTableSizes({ ctx, span, request, options }));\n\n  if (deletedIndexes.length === 0) {\n    logFinishedStep(\"No indexes are deleted by this push\");\n    return;\n  }\n\n  const minDocumentsForWarning = minDocumentsForIndexDeleteWarning();\n  if (\n    !deletedIndexes.some(\n      ({ documentsCount }) => documentsCount >= minDocumentsForWarning,\n    )\n  ) {\n    logFinishedStep(\"No large indexes are deleted by this push\");\n    return;\n  }\n\n  logMessage(`\u26A0\uFE0F  This code push will ${chalkStderr.bold(\"delete\")} the following ${deletedIndexes.length === 1 ? \"index\" : \"indexes\"}\nfrom your production deployment (${options.url}):\n\n${deletedIndexes\n  .map((deletedIndex) =>\n    formatDeletedIndex({ ...deletedIndex, minDocumentsForWarning }),\n  )\n  .join(\"\\n\")}\n\nThe documents that are in the index won\u2019t be deleted, but the index will need\nto be backfilled again if you want to restore it later.\n`);\n\n  if (!askForConfirmation) {\n    logFinishedStep(\n      \"Proceeding with push since --allow-deleting-large-indexes is set\",\n    );\n    return;\n  }\n\n  if (!process.stdin.isTTY) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `To confirm the push:\n\u2022 run the deploy command in an ${chalkStderr.bold(\"interactive terminal\")}\n\u2022 or run the deploy command with the ${chalkStderr.bold(\"--allow-deleting-large-indexes\")} flag`,\n    });\n  }\n\n  stopSpinner();\n  if (\n    !(await promptYesNo(ctx, {\n      message: `Delete ${deletedIndexes.length === 1 ? \"this index\" : \"these indexes\"}?`,\n      default: false,\n    }))\n  ) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Canceling push`,\n    });\n  }\n\n  logFinishedStep(\"Proceeding with push.\");\n}\n\n// Preferred source: one schema evaluation reports every dropped index\n// together with its table's document count, requiring only the\n// `deployment:deploy` permission the push itself needs. Returns null when the\n// deployment doesn't support the endpoint, in which case the caller falls\n// back to sizing tables one system query at a time.\nexport async function deletedIndexesFromSchemaEvaluation({\n  ctx,\n  span,\n  request,\n  options,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: CheckOptions;\n}): Promise<DeletedIndex[] | null> {\n  try {\n    const response = await evaluateSchema(\n      ctx,\n      span,\n      request,\n      options,\n      /* bestEffort */ true,\n    );\n    return Object.entries(response.componentSchemaEvaluations).flatMap(\n      ([componentPath, prediction]) =>\n        prediction.indexes\n          .filter((index) => index.change === \"dropped\")\n          .map((index) => ({\n            componentPath,\n            index,\n            documentsCount: index.numDocs,\n            replacedBy:\n              prediction.indexes.find(\n                (other) =>\n                  other.change === \"added\" && other.name === index.name,\n              ) ?? null,\n          })),\n    );\n  } catch (error: unknown) {\n    logVerbose(\n      `Schema evaluation unavailable, sizing deleted indexes per table: ${error instanceof Error ? error.message : String(error)}`,\n    );\n    return null;\n  }\n}\n\n// Fallback for deployments without `evaluate_schema`: diff indexes with\n// `evaluate_push`, then size each affected table with a system query. The\n// system query needs the `deployment:data:view` permission, which a\n// deploy-scoped key may lack.\nexport async function deletedIndexesFromTableSizes({\n  ctx,\n  span,\n  request,\n  options,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: CheckOptions;\n}): Promise<DeletedIndex[]> {\n  const { schemaChange } = await evaluatePush(ctx, span, request, options);\n\n  const indexDiffs = schemaChange.indexDiffs ?? {};\n  const deletedIndexes = Object.entries(indexDiffs).flatMap(\n    ([componentPath, indexDiff]) =>\n      indexDiff.removed_indexes.map((index) => ({\n        componentPath,\n        index,\n        replacedBy:\n          indexDiff.added_indexes.find((other) => other.name === index.name) ??\n          null,\n      })),\n  );\n\n  if (deletedIndexes.length === 0) {\n    return [];\n  }\n\n  const tablesWithDeletedIndexes = [\n    ...new Set(\n      deletedIndexes.map(\n        ({ componentPath, index }) => `${componentPath}:${getTableName(index)}`,\n      ),\n    ),\n  ].map((str) => {\n    const [componentPath, table] = str.split(\":\");\n    return { componentPath, table };\n  });\n  changeSpinner(\"Checking whether the deleted indexes are on large tables...\");\n  const documentCounts = await Promise.all(\n    tablesWithDeletedIndexes.map(async ({ componentPath, table }) => ({\n      componentPath,\n      table,\n      count: (await runSystemQuery(ctx, {\n        deploymentUrl: options.url,\n        adminKey: options.adminKey,\n        functionName: \"_system/cli/tableSize:default\",\n        componentPath,\n        args: { tableName: table },\n      })) as number,\n    })),\n  );\n  return deletedIndexes.map(({ componentPath, index, replacedBy }) => ({\n    componentPath,\n    index,\n    replacedBy,\n    documentsCount: documentCounts.find(\n      (count) =>\n        count.table === getTableName(index) &&\n        count.componentPath === componentPath,\n    )!.count,\n  }));\n}\n\nfunction formatDeletedIndex({\n  componentPath,\n  index,\n  documentsCount,\n  replacedBy,\n  minDocumentsForWarning,\n}: DeletedIndex & { minDocumentsForWarning: number }) {\n  const componentNameFormatted =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}:` : \"\";\n\n  const documentsCountFormatted =\n    documentsCount >= minDocumentsForWarning\n      ? `  ${chalkStderr.yellowBright(`\u26A0\uFE0F  ${documentsCount.toLocaleString()} documents`)}`\n      : `  ${documentsCount.toLocaleString()} ${documentsCount === 1 ? \"document\" : \"documents\"}`;\n\n  const replacedByFormatted = replacedBy\n    ? `\\n   ${chalkStderr.green(\"\u2192 replaced by:\")} ${formatIndex(replacedBy)}`\n    : \"\";\n\n  return (\n    \"\u26D4 \" +\n    componentNameFormatted +\n    formatIndex(index) +\n    documentsCountFormatted +\n    replacedByFormatted\n  );\n}\n\nfunction getTableName(index: DeveloperIndexConfig) {\n  const [tableName, _indexName] = index.name.split(\".\");\n  return tableName;\n}\n\nfunction minDocumentsForIndexDeleteWarning(): number {\n  const envValue = process.env.CONVEX_MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING;\n  if (envValue !== undefined) {\n    const parsed = parseInt(envValue, 10);\n    if (!isNaN(parsed)) {\n      return parsed;\n    }\n  }\n  return MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../../bundler/context.js\";\nimport {\n  changeSpinner,\n  logFinishedStep,\n  logMessage,\n  logVerbose,\n  stopSpinner,\n} from \"../../bundler/log.js\";\nimport { formatIndex } from \"./indexes.js\";\nimport { promptYesNo } from \"./utils/prompts.js\";\nimport { Span } from \"./tracing.js\";\nimport { StartPushRequest } from \"./deployApi/startPush.js\";\nimport { evaluatePush } from \"./deploy2.js\";\nimport { DeveloperIndexConfig } from \"./deployApi/finishPush.js\";\nimport { EvaluateSchemaResponse } from \"./deployApi/evaluateSchema.js\";\nimport { runSystemQuery } from \"./run.js\";\nimport { SchemaEvaluation } from \"./schemaEvaluation.js\";\nimport { integerFromEnv } from \"./utils/utils.js\";\n\nconst MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING = 100_000;\n\ntype CheckOptions = {\n  url: string;\n  deploymentName: string | null;\n  adminKey: string;\n};\n\ntype DeletedIndex = {\n  // The component instance path (\"\" for the root component), matching the\n  // keys of both `componentSchemaEvaluations` and `indexDiffs`.\n  componentPath: string;\n  index: DeveloperIndexConfig;\n  documentsCount: number;\n  replacedBy: DeveloperIndexConfig | null;\n};\n\nexport async function checkForLargeIndexDeletion({\n  ctx,\n  span,\n  request,\n  options,\n  schemaEvaluation,\n  askForConfirmation,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: CheckOptions;\n  schemaEvaluation: SchemaEvaluation;\n  askForConfirmation: boolean;\n}): Promise<void> {\n  changeSpinner(\"Verifying that the push isn\u2019t deleting large indexes...\");\n\n  const schemaEvaluationResponse = await schemaEvaluation(span);\n  let deletedIndexes: DeletedIndex[];\n  if (schemaEvaluationResponse !== null) {\n    deletedIndexes = deletedIndexesFromSchemaEvaluation(\n      schemaEvaluationResponse,\n    );\n  } else {\n    logVerbose(\n      \"Schema evaluation unavailable, sizing deleted indexes per table\",\n    );\n    deletedIndexes = await deletedIndexesFromTableSizes({\n      ctx,\n      span,\n      request,\n      options,\n    });\n  }\n\n  if (deletedIndexes.length === 0) {\n    logFinishedStep(\"No indexes are deleted by this push\");\n    return;\n  }\n\n  const minDocumentsForWarning = minDocumentsForIndexDeleteWarning();\n  if (\n    !deletedIndexes.some(\n      ({ documentsCount }) => documentsCount >= minDocumentsForWarning,\n    )\n  ) {\n    logFinishedStep(\"No large indexes are deleted by this push\");\n    return;\n  }\n\n  logMessage(`\u26A0\uFE0F  This code push will ${chalkStderr.bold(\"delete\")} the following ${deletedIndexes.length === 1 ? \"index\" : \"indexes\"}\nfrom your production deployment (${options.url}):\n\n${deletedIndexes\n  .map((deletedIndex) =>\n    formatDeletedIndex({ ...deletedIndex, minDocumentsForWarning }),\n  )\n  .join(\"\\n\")}\n\nThe documents that are in the index won\u2019t be deleted, but the index will need\nto be backfilled again if you want to restore it later.\n`);\n\n  // Either --skip-large-indexes-check or its deletion-only predecessor\n  // --allow-deleting-large-indexes gets here, so name neither.\n  if (!askForConfirmation) {\n    logFinishedStep(\n      \"Proceeding with push since deleting large indexes was allowed by flag\",\n    );\n    return;\n  }\n\n  if (!process.stdin.isTTY) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `To confirm the push:\n\u2022 run the deploy command in an ${chalkStderr.bold(\"interactive terminal\")}\n\u2022 or run the deploy command with the ${chalkStderr.bold(\"--skip-large-indexes-check\")} flag`,\n    });\n  }\n\n  stopSpinner();\n  if (\n    !(await promptYesNo(ctx, {\n      message: `Delete ${deletedIndexes.length === 1 ? \"this index\" : \"these indexes\"}?`,\n      default: false,\n    }))\n  ) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Canceling push`,\n    });\n  }\n\n  logFinishedStep(\"Proceeding with push.\");\n}\n\n// Preferred source: one schema evaluation reports every dropped index\n// together with its table's document count, requiring only the\n// `deployment:deploy` permission the push itself needs.\nexport function deletedIndexesFromSchemaEvaluation(\n  response: EvaluateSchemaResponse,\n): DeletedIndex[] {\n  return Object.entries(response.componentSchemaEvaluations).flatMap(\n    ([componentPath, prediction]) =>\n      prediction.indexes\n        .filter((index) => index.change === \"dropped\")\n        .map((index) => ({\n          componentPath,\n          index,\n          documentsCount: index.numDocs,\n          replacedBy:\n            prediction.indexes.find(\n              (other) => other.change === \"added\" && other.name === index.name,\n            ) ?? null,\n        })),\n  );\n}\n\n// Fallback for deployments without `evaluate_schema`: diff indexes with\n// `evaluate_push`, then size each affected table with a system query. The\n// system query needs the `deployment:data:view` permission, which a\n// deploy-scoped key may lack.\nexport async function deletedIndexesFromTableSizes({\n  ctx,\n  span,\n  request,\n  options,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: CheckOptions;\n}): Promise<DeletedIndex[]> {\n  const { schemaChange } = await evaluatePush(ctx, span, request, options);\n\n  const indexDiffs = schemaChange.indexDiffs ?? {};\n  const deletedIndexes = Object.entries(indexDiffs).flatMap(\n    ([componentPath, indexDiff]) =>\n      indexDiff.removed_indexes.map((index) => ({\n        componentPath,\n        index,\n        replacedBy:\n          indexDiff.added_indexes.find((other) => other.name === index.name) ??\n          null,\n      })),\n  );\n\n  if (deletedIndexes.length === 0) {\n    return [];\n  }\n\n  const tablesWithDeletedIndexes = [\n    ...new Set(\n      deletedIndexes.map(\n        ({ componentPath, index }) => `${componentPath}:${getTableName(index)}`,\n      ),\n    ),\n  ].map((str) => {\n    const [componentPath, table] = str.split(\":\");\n    return { componentPath, table };\n  });\n  changeSpinner(\"Checking whether the deleted indexes are on large tables...\");\n  const documentCounts = await Promise.all(\n    tablesWithDeletedIndexes.map(async ({ componentPath, table }) => ({\n      componentPath,\n      table,\n      count: (await runSystemQuery(ctx, {\n        deploymentUrl: options.url,\n        adminKey: options.adminKey,\n        functionName: \"_system/cli/tableSize:default\",\n        componentPath,\n        args: { tableName: table },\n      })) as number,\n    })),\n  );\n  return deletedIndexes.map(({ componentPath, index, replacedBy }) => ({\n    componentPath,\n    index,\n    replacedBy,\n    documentsCount: documentCounts.find(\n      (count) =>\n        count.table === getTableName(index) &&\n        count.componentPath === componentPath,\n    )!.count,\n  }));\n}\n\nfunction formatDeletedIndex({\n  componentPath,\n  index,\n  documentsCount,\n  replacedBy,\n  minDocumentsForWarning,\n}: DeletedIndex & { minDocumentsForWarning: number }) {\n  const componentNameFormatted =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}:` : \"\";\n\n  const documentsCountFormatted =\n    documentsCount >= minDocumentsForWarning\n      ? `  ${chalkStderr.yellowBright(`\u26A0\uFE0F  ${documentsCount.toLocaleString()} documents`)}`\n      : `  ${documentsCount.toLocaleString()} ${documentsCount === 1 ? \"document\" : \"documents\"}`;\n\n  const replacedByFormatted = replacedBy\n    ? `\\n   ${chalkStderr.green(\"\u2192 replaced by:\")} ${formatIndex(replacedBy)}`\n    : \"\";\n\n  return (\n    \"\u26D4 \" +\n    componentNameFormatted +\n    formatIndex(index) +\n    documentsCountFormatted +\n    replacedByFormatted\n  );\n}\n\nfunction getTableName(index: DeveloperIndexConfig) {\n  const [tableName, _indexName] = index.name.split(\".\");\n  return tableName;\n}\n\nfunction minDocumentsForIndexDeleteWarning(): number {\n  return integerFromEnv(\n    \"CONVEX_MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING\",\n    MIN_DOCUMENTS_FOR_INDEX_DELETE_WARNING,\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/cli/lib/checkForSlowSchemaValidation.js

@@ -23,24 +23,22 @@ __export(checkForSlowSchemaValidation_exports, {
 module.exports = __toCommonJS(checkForSlowSchemaValidation_exports);
 var import_chalk = require("chalk");
 var import_log = require("../../bundler/log.js");
-var import_deploy2 = require("./deploy2.js");
 var import_utils = require("./utils/utils.js");
+var import_formatValidationProgress = require("./formatValidationProgress.js");
 const MIN_BYTES_FOR_SCHEMA_WALK_WARNING = 1 << 27;
 async function checkForSlowSchemaValidation({
-  ctx,
   span,
-  request,
-  options
+  schemaEvaluation,
+  dryRun
 }) {
-  const response = await evaluateSchemaBestEffort({
-    ctx,
-    span,
-    request,
-    options
-  });
+  const response = await schemaEvaluation(span);
   if (response === null) {
     return;
   }
+  reportStagedValidators(response);
+  if (!dryRun) {
+    return;
+  }
   const walkedTables = Object.entries(
     response.componentSchemaEvaluations
   ).flatMap(
@@ -56,34 +54,55 @@ async function checkForSlowSchemaValidation({
   if (totalBytes < minBytesForSchemaWalkWarning()) {
     return;
   }
+  const shouldSuggestStaging = walkedTables.some(
+    ({ table }) => !table.canSkipAfterStagedValidation
+  );
   (0, import_log.logMessage)(`\u26A0\uFE0F  This schema change requires checking every document in the following ${walkedTables.length === 1 ? "table" : "tables"} against your new schema, totaling ${import_chalk.chalkStderr.yellowBright((0, import_utils.formatSize)(totalBytes))}. This deploy may take a while:
 
 ${walkedTables.map(
     ({ componentPath, table }) => formatWalkedTable({ componentPath, table })
   ).join("\n")}
-`);
+${shouldSuggestStaging ? `
+Tip: stage the new validator (\`defineTable({...}).staged({...})\`) to validate it in the background without blocking deploys.` : ""}`);
 }
-async function evaluateSchemaBestEffort({
-  ctx,
-  span,
-  request,
-  options
-}) {
-  try {
-    return await (0, import_deploy2.evaluateSchema)(
-      ctx,
-      span,
-      request,
-      options,
-      /* bestEffort */
-      true
-    );
-  } catch (error) {
-    (0, import_log.logVerbose)(
-      `Skipping slow schema validation check: ${error instanceof Error ? error.message : String(error)}`
+function reportStagedValidators(response) {
+  const stagedTables = Object.entries(
+    response.componentSchemaEvaluations
+  ).flatMap(([componentPath, prediction]) => {
+    const discarded = new Map(
+      (prediction.discardedStagedValidators ?? []).map((validator) => [
+        validator.tableName,
+        validator
+      ])
     );
-    return null;
+    return prediction.tables.filter((table) => table.staged !== void 0).map((table) => ({
+      componentPath,
+      table,
+      discarded: discarded.get(table.name)
+    }));
+  });
+  if (stagedTables.length === 0) {
+    return;
   }
+  const lines = stagedTables.map(({ componentPath, table, discarded }) => {
+    const componentPrefix = componentPath !== "" ? `${import_chalk.chalkStderr.gray(componentPath)}: ` : "";
+    if (discarded !== void 0) {
+      return `  ${componentPrefix}${table.name}: ${(0, import_formatValidationProgress.formatDiscardedStagedValidator)(discarded)}`;
+    }
+    const staged = table.staged;
+    switch (staged.state) {
+      case "pending": {
+        return `  ${componentPrefix}${table.name}: validating in the background (${(0, import_formatValidationProgress.formatValidationProgress)(staged)})`;
+      }
+      case "valid":
+        return table.outcome === "supersetOfStagedValidated" ? `  ${componentPrefix}${table.name}: ${import_chalk.chalkStderr.green("validated")}. This deploy applies the staged schema without scanning the table.` : `  ${componentPrefix}${table.name}: ${import_chalk.chalkStderr.green("validated")}. Safe to apply the staged schema changes and deploy.`;
+      case "failed":
+        return `  ${componentPrefix}${table.name}: ${import_chalk.chalkStderr.red("failed")}: ${staged.error}${import_chalk.chalkStderr.gray(" (fix the offending documents and redeploy to revalidate)")}`;
+    }
+  });
+  (0, import_log.logMessage)(`Staged schema validation status:
+${lines.join("\n")}
+`);
 }
 function formatWalkedTable({
   componentPath,
@@ -92,16 +111,16 @@ function formatWalkedTable({
   const componentPrefix = componentPath !== "" ? `${import_chalk.chalkStderr.gray(componentPath)}: ` : "";
   const docsFormatted = `${table.numDocs.toLocaleString()} documents, `;
   const sizeFormatted = (0, import_utils.formatSize)(table.sizeBytes);
-  return `  ${componentPrefix}${table.name} (${docsFormatted}${sizeFormatted})`;
+  let stagedNote = "";
+  if (table.staged?.state === "pending" && table.canSkipAfterStagedValidation) {
+    stagedNote = `. Staged schema validation in progress. Wait for validation to complete before deploying with the staged changes. Deploying now will block on a full table revalidation scan.`;
+  }
+  return `  ${componentPrefix}${table.name} (${docsFormatted}${sizeFormatted})${stagedNote}`;
 }
 function minBytesForSchemaWalkWarning() {
-  const envValue = process.env.CONVEX_MIN_BYTES_FOR_SCHEMA_WALK_WARNING;
-  if (envValue !== void 0) {
-    const parsed = parseInt(envValue, 10);
-    if (!isNaN(parsed)) {
-      return parsed;
-    }
-  }
-  return MIN_BYTES_FOR_SCHEMA_WALK_WARNING;
+  return (0, import_utils.integerFromEnv)(
+    "CONVEX_MIN_BYTES_FOR_SCHEMA_WALK_WARNING",
+    MIN_BYTES_FOR_SCHEMA_WALK_WARNING
+  );
 }
 //# sourceMappingURL=checkForSlowSchemaValidation.js.map

package/dist/cjs/cli/lib/checkForSlowSchemaValidation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/cli/lib/checkForSlowSchemaValidation.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../../bundler/context.js\";\nimport { logMessage, logVerbose } from \"../../bundler/log.js\";\nimport { Span } from \"./tracing.js\";\nimport { StartPushRequest } from \"./deployApi/startPush.js\";\nimport {\n  EvaluateSchemaResponse,\n  TablePrediction,\n} from \"./deployApi/evaluateSchema.js\";\nimport { evaluateSchema } from \"./deploy2.js\";\nimport { formatSize } from \"./utils/utils.js\";\n\nconst MIN_BYTES_FOR_SCHEMA_WALK_WARNING = 1 << 27; // 128 MiB\n\nexport async function checkForSlowSchemaValidation({\n  ctx,\n  span,\n  request,\n  options,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: {\n    url: string;\n    deploymentName: string | null;\n    adminKey: string;\n  };\n}): Promise<void> {\n  const response = await evaluateSchemaBestEffort({\n    ctx,\n    span,\n    request,\n    options,\n  });\n  if (response === null) {\n    return;\n  }\n\n  const walkedTables = Object.entries(\n    response.componentSchemaEvaluations,\n  ).flatMap(([componentPath, prediction]) =>\n    prediction.tables\n      .filter((table) => table.outcome === \"mustWalk\")\n      .map((table) => ({ componentPath, table })),\n  );\n  if (walkedTables.length === 0) {\n    return;\n  }\n\n  const totalBytes = walkedTables.reduce(\n    (sum, { table }) => sum + table.sizeBytes,\n    0,\n  );\n  if (totalBytes < minBytesForSchemaWalkWarning()) {\n    return;\n  }\n\n  logMessage(`\u26A0\uFE0F  This schema change requires checking every document in the following ${walkedTables.length === 1 ? \"table\" : \"tables\"} against your new schema, totaling ${chalkStderr.yellowBright(formatSize(totalBytes))}. This deploy may take a while:\n\n${walkedTables\n  .map(({ componentPath, table }) =>\n    formatWalkedTable({ componentPath, table }),\n  )\n  .join(\"\\n\")}\n`);\n}\n\n// This warning is advisory: if evaluation fails, fall back to skipping it\n// rather than aborting the push over a check that isn't required for\n// correctness. Plausibly transient failures \u2014 network errors and 5xx\n// responses (e.g. table summaries still bootstrapping) \u2014 are retried with\n// backoff by the shared fetch wrapper (see `pushCode`); anything else is\n// deterministic, including a 2xx whose shape the CLI doesn't recognize, so\n// it skips the check immediately.\nasync function evaluateSchemaBestEffort({\n  ctx,\n  span,\n  request,\n  options,\n}: {\n  ctx: Context;\n  span: Span;\n  request: StartPushRequest;\n  options: {\n    url: string;\n    deploymentName: string | null;\n    adminKey: string;\n  };\n}): Promise<EvaluateSchemaResponse | null> {\n  try {\n    return await evaluateSchema(\n      ctx,\n      span,\n      request,\n      options,\n      /* bestEffort */ true,\n    );\n  } catch (error: unknown) {\n    logVerbose(\n      `Skipping slow schema validation check: ${error instanceof Error ? error.message : String(error)}`,\n    );\n    return null;\n  }\n}\n\nfunction formatWalkedTable({\n  componentPath,\n  table,\n}: {\n  componentPath: string;\n  table: TablePrediction;\n}) {\n  const componentPrefix =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}: ` : \"\";\n  const docsFormatted = `${table.numDocs.toLocaleString()} documents, `;\n  const sizeFormatted = formatSize(table.sizeBytes);\n  return `  ${componentPrefix}${table.name} (${docsFormatted}${sizeFormatted})`;\n}\n\nfunction minBytesForSchemaWalkWarning(): number {\n  const envValue = process.env.CONVEX_MIN_BYTES_FOR_SCHEMA_WALK_WARNING;\n  if (envValue !== undefined) {\n    const parsed = parseInt(envValue, 10);\n    if (!isNaN(parsed)) {\n      return parsed;\n    }\n  }\n  return MIN_BYTES_FOR_SCHEMA_WALK_WARNING;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4B;AAE5B,iBAAuC;AAOvC,qBAA+B;AAC/B,mBAA2B;AAE3B,MAAM,oCAAoC,KAAK;AAE/C,eAAsB,6BAA6B;AAAA,EACjD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GASkB;AAChB,QAAM,WAAW,MAAM,yBAAyB;AAAA,IAC9C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,MAAI,aAAa,MAAM;AACrB;AAAA,EACF;AAEA,QAAM,eAAe,OAAO;AAAA,IAC1B,SAAS;AAAA,EACX,EAAE;AAAA,IAAQ,CAAC,CAAC,eAAe,UAAU,MACnC,WAAW,OACR,OAAO,CAAC,UAAU,MAAM,YAAY,UAAU,EAC9C,IAAI,CAAC,WAAW,EAAE,eAAe,MAAM,EAAE;AAAA,EAC9C;AACA,MAAI,aAAa,WAAW,GAAG;AAC7B;AAAA,EACF;AAEA,QAAM,aAAa,aAAa;AAAA,IAC9B,CAAC,KAAK,EAAE,MAAM,MAAM,MAAM,MAAM;AAAA,IAChC;AAAA,EACF;AACA,MAAI,aAAa,6BAA6B,GAAG;AAC/C;AAAA,EACF;AAEA,6BAAW,sFAA4E,aAAa,WAAW,IAAI,UAAU,QAAQ,sCAAsC,yBAAY,iBAAa,yBAAW,UAAU,CAAC,CAAC;AAAA;AAAA,EAE3N,aACC;AAAA,IAAI,CAAC,EAAE,eAAe,MAAM,MAC3B,kBAAkB,EAAE,eAAe,MAAM,CAAC;AAAA,EAC5C,EACC,KAAK,IAAI,CAAC;AAAA,CACZ;AACD;AASA,eAAe,yBAAyB;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAS2C;AACzC,MAAI;AACF,WAAO,UAAM;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,MACiB;AAAA,IACnB;AAAA,EACF,SAAS,OAAgB;AACvB;AAAA,MACE,0CAA0C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IAClG;AACA,WAAO;AAAA,EACT;AACF;AAEA,SAAS,kBAAkB;AAAA,EACzB;AAAA,EACA;AACF,GAGG;AACD,QAAM,kBACJ,kBAAkB,KAAK,GAAG,yBAAY,KAAK,aAAa,CAAC,OAAO;AAClE,QAAM,gBAAgB,GAAG,MAAM,QAAQ,eAAe,CAAC;AACvD,QAAM,oBAAgB,yBAAW,MAAM,SAAS;AAChD,SAAO,KAAK,eAAe,GAAG,MAAM,IAAI,KAAK,aAAa,GAAG,aAAa;AAC5E;AAEA,SAAS,+BAAuC;AAC9C,QAAM,WAAW,QAAQ,IAAI;AAC7B,MAAI,aAAa,QAAW;AAC1B,UAAM,SAAS,SAAS,UAAU,EAAE;AACpC,QAAI,CAAC,MAAM,MAAM,GAAG;AAClB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;",
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../bundler/log.js\";\nimport { Span } from \"./tracing.js\";\nimport {\n  EvaluateSchemaResponse,\n  TablePrediction,\n} from \"./deployApi/evaluateSchema.js\";\nimport { SchemaEvaluation } from \"./schemaEvaluation.js\";\nimport { formatSize, integerFromEnv } from \"./utils/utils.js\";\nimport {\n  formatDiscardedStagedValidator,\n  formatValidationProgress,\n} from \"./formatValidationProgress.js\";\n\nconst MIN_BYTES_FOR_SCHEMA_WALK_WARNING = 1 << 27; // 128 MiB\n\nexport async function checkForSlowSchemaValidation({\n  span,\n  schemaEvaluation,\n  dryRun,\n}: {\n  span: Span;\n  schemaEvaluation: SchemaEvaluation;\n  dryRun: boolean;\n}): Promise<void> {\n  const response = await schemaEvaluation(span);\n  if (response === null) {\n    return;\n  }\n  reportStagedValidators(response);\n  if (!dryRun) {\n    return;\n  }\n\n  const walkedTables = Object.entries(\n    response.componentSchemaEvaluations,\n  ).flatMap(([componentPath, prediction]) =>\n    prediction.tables\n      .filter((table) => table.outcome === \"mustWalk\")\n      .map((table) => ({ componentPath, table })),\n  );\n  if (walkedTables.length === 0) {\n    return;\n  }\n\n  const totalBytes = walkedTables.reduce(\n    (sum, { table }) => sum + table.sizeBytes,\n    0,\n  );\n  if (totalBytes < minBytesForSchemaWalkWarning()) {\n    return;\n  }\n\n  const shouldSuggestStaging = walkedTables.some(\n    ({ table }) => !table.canSkipAfterStagedValidation,\n  );\n  logMessage(`\u26A0\uFE0F  This schema change requires checking every document in the following ${walkedTables.length === 1 ? \"table\" : \"tables\"} against your new schema, totaling ${chalkStderr.yellowBright(formatSize(totalBytes))}. This deploy may take a while:\n\n${walkedTables\n  .map(({ componentPath, table }) =>\n    formatWalkedTable({ componentPath, table }),\n  )\n  .join(\"\\n\")}\n${\n  shouldSuggestStaging\n    ? `\\nTip: stage the new validator (\\`defineTable({...}).staged({...})\\`) to validate it in the background without blocking deploys.`\n    : \"\"\n}`);\n}\n\n// The prediction includes staged validators from active and in-flight schemas.\nfunction reportStagedValidators(response: EvaluateSchemaResponse) {\n  const stagedTables = Object.entries(\n    response.componentSchemaEvaluations,\n  ).flatMap(([componentPath, prediction]) => {\n    const discarded = new Map(\n      (prediction.discardedStagedValidators ?? []).map((validator) => [\n        validator.tableName,\n        validator,\n      ]),\n    );\n    return prediction.tables\n      .filter((table) => table.staged !== undefined)\n      .map((table) => ({\n        componentPath,\n        table,\n        discarded: discarded.get(table.name),\n      }));\n  });\n  if (stagedTables.length === 0) {\n    return;\n  }\n  const lines = stagedTables.map(({ componentPath, table, discarded }) => {\n    const componentPrefix =\n      componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}: ` : \"\";\n    // The state describes the validator this push discards, so advertising\n    // it as ready to promote would contradict the unstaging warning.\n    if (discarded !== undefined) {\n      return `  ${componentPrefix}${table.name}: ${formatDiscardedStagedValidator(discarded)}`;\n    }\n    const staged = table.staged!;\n    switch (staged.state) {\n      case \"pending\": {\n        return `  ${componentPrefix}${table.name}: validating in the background (${formatValidationProgress(staged)})`;\n      }\n      case \"valid\":\n        // `supersetOfStagedValidated` means this push already promotes it.\n        return table.outcome === \"supersetOfStagedValidated\"\n          ? `  ${componentPrefix}${table.name}: ${chalkStderr.green(\"validated\")}. This deploy applies the staged schema without scanning the table.`\n          : `  ${componentPrefix}${table.name}: ${chalkStderr.green(\"validated\")}. Safe to apply the staged schema changes and deploy.`;\n      case \"failed\":\n        return `  ${componentPrefix}${table.name}: ${chalkStderr.red(\"failed\")}: ${staged.error}${chalkStderr.gray(\" (fix the offending documents and redeploy to revalidate)\")}`;\n    }\n  });\n  logMessage(`Staged schema validation status:\\n${lines.join(\"\\n\")}\\n`);\n}\n\nfunction formatWalkedTable({\n  componentPath,\n  table,\n}: {\n  componentPath: string;\n  table: TablePrediction;\n}) {\n  const componentPrefix =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}: ` : \"\";\n  const docsFormatted = `${table.numDocs.toLocaleString()} documents, `;\n  const sizeFormatted = formatSize(table.sizeBytes);\n  let stagedNote = \"\";\n  if (table.staged?.state === \"pending\" && table.canSkipAfterStagedValidation) {\n    stagedNote = `. Staged schema validation in progress. Wait for validation to complete before deploying with the staged changes. Deploying now will block on a full table revalidation scan.`;\n  }\n  return `  ${componentPrefix}${table.name} (${docsFormatted}${sizeFormatted})${stagedNote}`;\n}\n\nfunction minBytesForSchemaWalkWarning(): number {\n  return integerFromEnv(\n    \"CONVEX_MIN_BYTES_FOR_SCHEMA_WALK_WARNING\",\n    MIN_BYTES_FOR_SCHEMA_WALK_WARNING,\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/cli/lib/checkForStagedValidatorDeletion.js

@@ -0,0 +1,90 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var checkForStagedValidatorDeletion_exports = {};
+__export(checkForStagedValidatorDeletion_exports, {
+  checkForStagedValidatorDeletion: () => checkForStagedValidatorDeletion
+});
+module.exports = __toCommonJS(checkForStagedValidatorDeletion_exports);
+var import_chalk = require("chalk");
+var import_log = require("../../bundler/log.js");
+var import_prompts = require("./utils/prompts.js");
+var import_formatValidationProgress = require("./formatValidationProgress.js");
+async function checkForStagedValidatorDeletion({
+  ctx,
+  response,
+  askForConfirmation,
+  dryRun = false
+}) {
+  if (response === null) {
+    return;
+  }
+  const discarded = Object.entries(response.componentSchemaEvaluations).flatMap(
+    ([componentPath, prediction]) => (prediction.discardedStagedValidators ?? []).map((validator) => ({
+      componentPath,
+      validator
+    }))
+  );
+  if (discarded.length === 0) {
+    return;
+  }
+  (0, import_log.logMessage)(`\u26A0\uFE0F  This push ${import_chalk.chalkStderr.bold(dryRun ? "would discard" : "discards")} staged schema validation for the following ${discarded.length === 1 ? "table" : "tables"}:
+
+${discarded.map(formatDiscarded).join("\n")}
+
+A discarded staged validator restarts validation from zero if staged again.
+`);
+  if (dryRun) {
+    return;
+  }
+  if (!askForConfirmation) {
+    (0, import_log.logFinishedStep)(
+      "Proceeding with push since --allow-unstaging-schema is set"
+    );
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    return ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `To confirm the push:
+\u2022 run the deploy command in an ${import_chalk.chalkStderr.bold("interactive terminal")}
+\u2022 or run the deploy command with the ${import_chalk.chalkStderr.bold("--allow-unstaging-schema")} flag`
+    });
+  }
+  (0, import_log.stopSpinner)();
+  if (!await (0, import_prompts.promptYesNo)(ctx, {
+    message: `Discard staged validation for ${discarded.length === 1 ? "this table" : "these tables"}?`,
+    default: false
+  })) {
+    return ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: `Canceling push`
+    });
+  }
+  (0, import_log.logFinishedStep)("Proceeding with push.");
+}
+function formatDiscarded({
+  componentPath,
+  validator
+}) {
+  const componentPrefix = componentPath !== "" ? `${import_chalk.chalkStderr.gray(componentPath)}:` : "";
+  return `\u26D4 ${componentPrefix}${validator.tableName}: ${(0, import_formatValidationProgress.formatDiscardedStagedValidator)(validator)}`;
+}
+//# sourceMappingURL=checkForStagedValidatorDeletion.js.map

package/dist/cjs/cli/lib/checkForStagedValidatorDeletion.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/lib/checkForStagedValidatorDeletion.ts"],
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../../bundler/context.js\";\nimport { logFinishedStep, logMessage, stopSpinner } from \"../../bundler/log.js\";\nimport { promptYesNo } from \"./utils/prompts.js\";\nimport {\n  DiscardedStagedValidator,\n  EvaluateSchemaResponse,\n} from \"./deployApi/evaluateSchema.js\";\nimport { formatDiscardedStagedValidator } from \"./formatValidationProgress.js\";\n\nexport type StagedValidatorDeletionCheck =\n  | \"ask for confirmation\"\n  | \"has confirmation\"\n  | \"no verification\";\n\n/**\n * Confirm before discarding pending or successful staged validation. Unstaging\n * stops write-time checks, so restaging requires a fresh scan.\n *\n * A dry run only reports what the push would discard, so `--dry-run` previews\n * the confirmation the real push will ask for.\n */\nexport async function checkForStagedValidatorDeletion({\n  ctx,\n  response,\n  askForConfirmation,\n  dryRun = false,\n}: {\n  ctx: Context;\n  response: EvaluateSchemaResponse | null;\n  askForConfirmation: boolean;\n  dryRun?: boolean;\n}): Promise<void> {\n  // `sharedSchemaEvaluation` has already logged why evaluation failed.\n  if (response === null) {\n    return;\n  }\n  const discarded = Object.entries(response.componentSchemaEvaluations).flatMap(\n    ([componentPath, prediction]) =>\n      (prediction.discardedStagedValidators ?? []).map((validator) => ({\n        componentPath,\n        validator,\n      })),\n  );\n  if (discarded.length === 0) {\n    return;\n  }\n\n  logMessage(`\\u26a0\\ufe0f  This push ${chalkStderr.bold(dryRun ? \"would discard\" : \"discards\")} staged schema validation for the following ${discarded.length === 1 ? \"table\" : \"tables\"}:\n\n${discarded.map(formatDiscarded).join(\"\\n\")}\n\nA discarded staged validator restarts validation from zero if staged again.\n`);\n\n  if (dryRun) {\n    return;\n  }\n\n  if (!askForConfirmation) {\n    logFinishedStep(\n      \"Proceeding with push since --allow-unstaging-schema is set\",\n    );\n    return;\n  }\n\n  if (!process.stdin.isTTY) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `To confirm the push:\n\\u2022 run the deploy command in an ${chalkStderr.bold(\"interactive terminal\")}\n\\u2022 or run the deploy command with the ${chalkStderr.bold(\"--allow-unstaging-schema\")} flag`,\n    });\n  }\n\n  stopSpinner();\n  if (\n    !(await promptYesNo(ctx, {\n      message: `Discard staged validation for ${discarded.length === 1 ? \"this table\" : \"these tables\"}?`,\n      default: false,\n    }))\n  ) {\n    return ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: `Canceling push`,\n    });\n  }\n\n  logFinishedStep(\"Proceeding with push.\");\n}\n\nfunction formatDiscarded({\n  componentPath,\n  validator,\n}: {\n  componentPath: string;\n  validator: DiscardedStagedValidator;\n}): string {\n  const componentPrefix =\n    componentPath !== \"\" ? `${chalkStderr.gray(componentPath)}:` : \"\";\n  return `\\u26d4 ${componentPrefix}${validator.tableName}: ${formatDiscardedStagedValidator(validator)}`;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA4B;AAE5B,iBAAyD;AACzD,qBAA4B;AAK5B,sCAA+C;AAc/C,eAAsB,gCAAgC;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AACX,GAKkB;AAEhB,MAAI,aAAa,MAAM;AACrB;AAAA,EACF;AACA,QAAM,YAAY,OAAO,QAAQ,SAAS,0BAA0B,EAAE;AAAA,IACpE,CAAC,CAAC,eAAe,UAAU,OACxB,WAAW,6BAA6B,CAAC,GAAG,IAAI,CAAC,eAAe;AAAA,MAC/D;AAAA,MACA;AAAA,IACF,EAAE;AAAA,EACN;AACA,MAAI,UAAU,WAAW,GAAG;AAC1B;AAAA,EACF;AAEA,6BAAW,2BAA2B,yBAAY,KAAK,SAAS,kBAAkB,UAAU,CAAC,+CAA+C,UAAU,WAAW,IAAI,UAAU,QAAQ;AAAA;AAAA,EAEvL,UAAU,IAAI,eAAe,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA,CAG1C;AAEC,MAAI,QAAQ;AACV;AAAA,EACF;AAEA,MAAI,CAAC,oBAAoB;AACvB;AAAA,MACE;AAAA,IACF;AACA;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,MAAM,OAAO;AACxB,WAAO,IAAI,MAAM;AAAA,MACf,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBAAgB;AAAA,sCACgB,yBAAY,KAAK,sBAAsB,CAAC;AAAA,4CAClC,yBAAY,KAAK,0BAA0B,CAAC;AAAA,IACpF,CAAC;AAAA,EACH;AAEA,8BAAY;AACZ,MACE,CAAE,UAAM,4BAAY,KAAK;AAAA,IACvB,SAAS,iCAAiC,UAAU,WAAW,IAAI,eAAe,cAAc;AAAA,IAChG,SAAS;AAAA,EACX,CAAC,GACD;AACA,WAAO,IAAI,MAAM;AAAA,MACf,UAAU;AAAA,MACV,WAAW;AAAA,MACX,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,kCAAgB,uBAAuB;AACzC;AAEA,SAAS,gBAAgB;AAAA,EACvB;AAAA,EACA;AACF,GAGW;AACT,QAAM,kBACJ,kBAAkB,KAAK,GAAG,yBAAY,KAAK,aAAa,CAAC,MAAM;AACjE,SAAO,UAAU,eAAe,GAAG,UAAU,SAAS,SAAK,gEAA+B,SAAS,CAAC;AACtG;",
+  "names": []
+}