@speedkit/cli 4.25.2 → 4.26.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [4.26.0](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.25.2...v4.26.0) (2026-09-09)
+
+
+### Features
+
+* **revalidate:** default to REFRESH, and gate only a dropping job ([c280261](https://gitlab.orestes.info/baqend/speed-kit-cli/commit/c2802614138163b1e2474a8dce552535468fd854))
+
 ## [4.25.2](https://gitlab.orestes.info/baqend/speed-kit-cli/compare/v4.25.1...v4.25.2) (2026-09-09)
 
 

package/README.md

@@ -21,7 +21,7 @@ $ npm install -g @speedkit/cli
 $ sk COMMAND
 running command...
 $ sk (--version)
-@speedkit/cli/4.25.2 linux-x64 node-v22.23.2
+@speedkit/cli/4.26.0 linux-x64 node-v22.23.2
 $ sk --help [COMMAND]
 USAGE
   $ sk COMMAND
@@ -770,11 +770,13 @@ FLAGS
                             state it only to override that, or to purge a whole path without a pattern.
       --query=<value>       Raw MongoDB query on the asset fields, as JSON. An escape hatch for a rule --pattern cannot
                             express, such as a condition on another field. It replaces the query --pattern would build.
-      --type=<option>       [default: PURGE] PURGE drops the entries and does not rebuild them, which is what an
-                            out-of-scope URL needs.
+      --type=<option>       [default: REFRESH] REFRESH revalidates against origin and keeps serving the cached copy
+                            meanwhile. A URL that went out of scope needs PURGE instead: it drops the entries and does
+                            not rebuild them, which is the only type that stops serving for good.
                             <options: REFRESH|INSTANT|DEPLOYMENT|PURGE>
       --wait                Poll the job until it finishes.
-      --yes                 Skip the confirmation a job above 100 assets asks for. Required in a non-interactive shell.
+      --yes                 Skip the confirmation a dropping job above 100 assets asks for. Required in a
+                            non-interactive shell.
 
 DESCRIPTION
   Purge or refresh cached assets by prefix and query. Run it after a config that narrows scope goes live, so returning
@@ -785,7 +787,7 @@ EXAMPLES
 
   $ sk revalidate example-shop --pattern '^https://www\.example\.com/en/.*-c(?:1234|5678)(?:/|\?|$)' --dryRun
 
-  $ sk revalidate example-shop --pattern '^https://www\.example\.com/en/.*-c1234(?:/|\?|$)' --wait
+  $ sk revalidate example-shop --pattern '^https://www\.example\.com/en/.*-c1234(?:/|\?|$)' --type PURGE --wait
 
   $ sk revalidate example-shop --prefix https://www.example.com/en/ --dryRun
 ```

package/dist/commands/revalidate.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from "@oclif/core";
 import { CLIParameters, CLIParametersChar } from "../models/cli-parameters.js";
 import { isNonInteractive } from "../helpers/environment.js";
-import { CONFIRMATION_THRESHOLD, REVALIDATE_TYPES, RevalidateContext, RevalidateFactory, } from "../services/revalidate/index.js";
+import { CONFIRMATION_THRESHOLD, DROPPING_TYPES, REVALIDATE_TYPES, RevalidateContext, RevalidateFactory, } from "../services/revalidate/index.js";
 const SAMPLE_SIZE = 10;
 export default class Revalidate extends Command {
     static description = "Purge or refresh cached assets by prefix and query. Run it after a config that narrows scope goes live, so returning visitors stop receiving the cached HTML.";
@@ -26,8 +26,8 @@ export default class Revalidate extends Command {
         }),
         ["type"]: Flags.string({
             options: [...REVALIDATE_TYPES],
-            default: "PURGE",
-            description: "PURGE drops the entries and does not rebuild them, which is what an out-of-scope URL needs.",
+            default: "REFRESH",
+            description: "REFRESH revalidates against origin and keeps serving the cached copy meanwhile. A URL that went out of scope needs PURGE instead: it drops the entries and does not rebuild them, which is the only type that stops serving for good.",
         }),
         [CLIParameters.DryRun]: Flags.boolean({
             char: CLIParametersChar.DryRun,
@@ -40,7 +40,7 @@ export default class Revalidate extends Command {
         }),
         ["yes"]: Flags.boolean({
             default: false,
-            description: `Skip the confirmation a job above ${CONFIRMATION_THRESHOLD} assets asks for. Required in a non-interactive shell.`,
+            description: `Skip the confirmation a dropping job above ${CONFIRMATION_THRESHOLD} assets asks for. Required in a non-interactive shell.`,
         }),
         [CLIParameters.Quiet]: Flags.boolean({
             char: CLIParametersChar.Quiet,
@@ -51,7 +51,7 @@ export default class Revalidate extends Command {
     static examples = [
         `$ sk revalidate <${CLIParameters.AppName}> --pattern <regex> [--pattern <regex>] [--${CLIParameters.DryRun}] [--wait]`,
         `$ sk revalidate example-shop --pattern '^https://www\\.example\\.com/en/.*-c(?:1234|5678)(?:/|\\?|$)' --${CLIParameters.DryRun}`,
-        `$ sk revalidate example-shop --pattern '^https://www\\.example\\.com/en/.*-c1234(?:/|\\?|$)' --wait`,
+        `$ sk revalidate example-shop --pattern '^https://www\\.example\\.com/en/.*-c1234(?:/|\\?|$)' --type PURGE --wait`,
         `$ sk revalidate example-shop --prefix https://www.example.com/en/ --${CLIParameters.DryRun}`,
     ];
     async run() {
@@ -88,7 +88,9 @@ export default class Revalidate extends Command {
             return;
         }
         const type = flags["type"];
-        if (preview.count > CONFIRMATION_THRESHOLD && !flags["yes"]) {
+        if (DROPPING_TYPES.has(type) &&
+            preview.count > CONFIRMATION_THRESHOLD &&
+            !flags["yes"]) {
             if (isNonInteractive()) {
                 this.error(`${preview.count} assets exceed the ${CONFIRMATION_THRESHOLD}-asset threshold, and this shell cannot ask`, {
                     exit: 1,

package/dist/services/revalidate/revalidate-model.d.ts

@@ -6,11 +6,17 @@ export type RevalidateType = (typeof REVALIDATE_TYPES)[number];
  */
 export declare const ASSET_TABLE = "speedKit.Asset";
 /**
- * Above this many assets the command asks before it purges. A filter that takes
- * more than a page of assets is usually a filter mistake, and a purge cannot be
- * undone — the entries are gone until traffic caches them again.
+ * Above this many assets the command asks before it runs a job that drops
+ * entries. Such a job cannot be undone: the entries are gone until traffic
+ * caches them again.
  */
 export declare const CONFIRMATION_THRESHOLD = 100;
+/**
+ * The job types that stop serving the cached entry straight away, so a large one
+ * needs the confirmation. `REFRESH` and `INSTANT` keep serving while they
+ * revalidate, so they need none.
+ */
+export declare const DROPPING_TYPES: ReadonlySet<RevalidateType>;
 /**
  * Scope of a revalidation job.
  *

package/dist/services/revalidate/revalidate-model.js

@@ -10,11 +10,20 @@ export const REVALIDATE_TYPES = [
  */
 export const ASSET_TABLE = "speedKit.Asset";
 /**
- * Above this many assets the command asks before it purges. A filter that takes
- * more than a page of assets is usually a filter mistake, and a purge cannot be
- * undone — the entries are gone until traffic caches them again.
+ * Above this many assets the command asks before it runs a job that drops
+ * entries. Such a job cannot be undone: the entries are gone until traffic
+ * caches them again.
  */
 export const CONFIRMATION_THRESHOLD = 100;
+/**
+ * The job types that stop serving the cached entry straight away, so a large one
+ * needs the confirmation. `REFRESH` and `INSTANT` keep serving while they
+ * revalidate, so they need none.
+ */
+export const DROPPING_TYPES = new Set([
+    "PURGE",
+    "DEPLOYMENT",
+]);
 export class RevalidateContext {
     app;
     quiet;

package/oclif.manifest.json

@@ -884,7 +884,7 @@
       "examples": [
         "$ sk revalidate <app> --pattern <regex> [--pattern <regex>] [--dryRun] [--wait]",
         "$ sk revalidate example-shop --pattern '^https://www\\.example\\.com/en/.*-c(?:1234|5678)(?:/|\\?|$)' --dryRun",
-        "$ sk revalidate example-shop --pattern '^https://www\\.example\\.com/en/.*-c1234(?:/|\\?|$)' --wait",
+        "$ sk revalidate example-shop --pattern '^https://www\\.example\\.com/en/.*-c1234(?:/|\\?|$)' --type PURGE --wait",
         "$ sk revalidate example-shop --prefix https://www.example.com/en/ --dryRun"
       ],
       "flags": {
@@ -910,9 +910,9 @@
           "type": "option"
         },
         "type": {
-          "description": "PURGE drops the entries and does not rebuild them, which is what an out-of-scope URL needs.",
+          "description": "REFRESH revalidates against origin and keeps serving the cached copy meanwhile. A URL that went out of scope needs PURGE instead: it drops the entries and does not rebuild them, which is the only type that stops serving for good.",
           "name": "type",
-          "default": "PURGE",
+          "default": "REFRESH",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
@@ -937,7 +937,7 @@
           "type": "boolean"
         },
         "yes": {
-          "description": "Skip the confirmation a job above 100 assets asks for. Required in a non-interactive shell.",
+          "description": "Skip the confirmation a dropping job above 100 assets asks for. Required in a non-interactive shell.",
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -1314,5 +1314,5 @@
       ]
     }
   },
-  "version": "4.25.2"
+  "version": "4.26.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@speedkit/cli",
   "description": "Speed Kit CLI",
-  "version": "4.25.2",
+  "version": "4.26.0",
   "author": {
     "name": "Baqend.com",
     "email": "info@baqend.com"