neonctl 2.36.0 → 2.36.1

package/README.md

@@ -578,7 +578,7 @@ neon snapshots delete snap-1234
 # Automatic snapshot (backup) schedule of a branch
 neon snapshots schedule get --branch main
 neon snapshots schedule set --branch main --frequency daily --hour 3 --retention 604800
-neon snapshots schedule set --branch main --schedule '[{"frequency":"hourly"},{"frequency":"daily","hour":3}]'
+neon snapshots schedule set --branch main --schedule '[{"frequency":"weekly","day":1,"hour":2},{"frequency":"daily","hour":3}]'
 ```
 
 All sub-commands honor the [global options](#global-options), including `--output json|yaml|table`.

package/dist/commands/snapshots.js

@@ -23,13 +23,17 @@ const OPERATION_FIELDS = [
     "action",
     "status",
 ];
+// The values the Neon API accepts for a backup-schedule entry's `frequency`
+// (per the OpenAPI `BackupScheduleItem` description). `satisfies` fails the
+// build if a value listed here leaves the SDK's `SnapshotFrequency` union, so
+// the CLI can never offer a frequency the API rejects.
 const SNAPSHOT_FREQUENCIES = [
-    "hourly",
     "daily",
     "weekly",
     "monthly",
-    "yearly",
 ];
+/** Narrow an arbitrary string to a supported {@link SnapshotFrequency}. */
+const isSnapshotFrequency = (value) => SNAPSHOT_FREQUENCIES.some((frequency) => frequency === value);
 export const command = "snapshots";
 export const describe = "Manage snapshots";
 export const aliases = ["snapshot"];
@@ -188,7 +192,7 @@ export const builder = (argv) => argv
         "A daily 03:00 snapshot kept for 7 days",
     ],
     [
-        '$0 snapshots schedule set --branch main --schedule \'[{"frequency":"hourly"},{"frequency":"daily","hour":3}]\'',
+        '$0 snapshots schedule set --branch main --schedule \'[{"frequency":"weekly","day":1,"hour":2},{"frequency":"daily","hour":3}]\'',
         "A multi-entry schedule via JSON",
     ],
 ]), (args) => scheduleSet(args))
@@ -395,6 +399,9 @@ const parseScheduleJson = (raw) => {
         if (typeof frequency !== "string") {
             throw new Error(`--schedule entry ${index} is missing a string "frequency".`);
         }
+        if (!isSnapshotFrequency(frequency)) {
+            throw new Error(`--schedule entry ${index} has an unsupported "frequency": "${frequency}". Use one of: ${SNAPSHOT_FREQUENCIES.join(", ")}.`);
+        }
         const item = { frequency };
         for (const key of [
             "hour",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neonctl",
-  "version": "2.36.0",
+  "version": "2.36.1",
   "description": "CLI tool for Neon Serverless Postgres",
   "keywords": [
     "neon",
@@ -51,10 +51,10 @@
     "which": "3.0.1",
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
-    "@neon/sdk": "1.2.0",
-    "@neon/config": "0.9.5",
-    "@neon/config-runtime": "0.9.6",
-    "@neon/env": "0.11.5"
+    "@neon/sdk": "1.3.0",
+    "@neon/config": "0.9.6",
+    "@neon/env": "0.11.6",
+    "@neon/config-runtime": "0.9.7"
   },
   "optionalDependencies": {
     "esbuild": "0.28.1"