@quonfig/cli 0.0.52 → 0.0.54

package/oclif.manifest.json

@@ -2064,6 +2064,121 @@
         "sdk-key.js"
       ]
     },
+    "serve": {
+      "aliases": [],
+      "args": {},
+      "description": "Serve a local datadir over HTTP to browser/RN SDKs.\n\nReads configs from a local datadir and exposes them at\n`GET /api/v2/configs/eval-with-context/{base64url(ctx)}`. Point your\nbrowser SDK at the resulting URL (`http://localhost:6580` by default)\nand the same client code that talks to api-delivery in production will\nwork unmodified.\n\nTelemetry is intentionally not served — qfg serve has no Quonfig backend\nbehind it. Disable client-side telemetry with\n`collectEvaluationSummaries: false` (and `contextUploadMode: \"none\"`),\nor point the SDK's `telemetryUrl` at a real endpoint.\n\nThe server is bound to 127.0.0.1 by default; pass --allow-non-loopback\nto confirm a LAN-reachable bind.",
+      "examples": [
+        "<%= config.bin %> serve",
+        "<%= config.bin %> serve --datadir ./our-config --environment production",
+        "<%= config.bin %> serve --port 6581 --frontend-sdk-key PUBLIC_KEY"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Force interactive mode",
+          "helpGroup": "GLOBAL",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Do not colorize output",
+          "env": "NO_COLOR",
+          "helpGroup": "GLOBAL",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "datadir": {
+          "description": "Datadir to serve (defaults to ./our-config, then ./.quonfig, then errors). Honors QUONFIG_DIR.",
+          "name": "datadir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "description": "Which environment slug to evaluate. Honors QUONFIG_ENVIRONMENT.",
+          "name": "environment",
+          "default": "development",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "port": {
+          "description": "TCP port to listen on. Errors on collision; pass --port <n> to retry.",
+          "name": "port",
+          "default": 6580,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "host": {
+          "description": "Bind address. Loopback by default; non-loopback requires --allow-non-loopback.",
+          "name": "host",
+          "default": "127.0.0.1",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "frontend-sdk-key": {
+          "description": "If set, every request must present Authorization: Basic 1:<key>. If unset, the server is open (matches the \"datadir is the source of truth\" mental model).",
+          "name": "frontend-sdk-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cors-origin": {
+          "description": "Allowed CORS origin (repeatable). Default is *; required when binding to a non-loopback host.",
+          "name": "cors-origin",
+          "default": [
+            "*"
+          ],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "watch": {
+          "description": "Reload the envelope when the datadir changes. --no-watch disables.",
+          "name": "watch",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "allow-non-loopback": {
+          "description": "Confirm a LAN-reachable bind. Required when --host is not loopback.",
+          "name": "allow-non-loopback",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "serve",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "serve.js"
+      ]
+    },
     "set-default": {
       "aliases": [
         "toggle"
@@ -3143,14 +3258,13 @@
         "status.js"
       ]
     },
-    "workspace:bootstrap": {
+    "sdk-key:create": {
       "aliases": [],
       "args": {},
-      "description": "Push a local git repo to Gitea as this workspace's config repository",
+      "description": "Create a new SDK key",
       "examples": [
-        "<%= config.bin %> workspace bootstrap --dir ./our-config",
-        "<%= config.bin %> workspace bootstrap --dir ./launch-migrator/output",
-        "<%= config.bin %> workspace bootstrap --dir ./our-config --skip-validate"
+        "<%= config.bin %> <%= command.id %> --environment production --type server",
+        "<%= config.bin %> <%= command.id %> --environment staging --type browser"
       ],
       "flags": {
         "json": {
@@ -3182,30 +3296,53 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dir": {
-          "description": "Local directory to push (defaults to current directory)",
-          "name": "dir",
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "description": "Force push even if remote already has commits",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "skip-validate": {
-          "description": "Skip config validation before pushing",
-          "name": "skip-validate",
-          "allowNo": false,
-          "type": "boolean"
+        "environment": {
+          "char": "e",
+          "description": "Environment name (e.g. production, staging)",
+          "name": "environment",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "description": "Key type: server (backend) or browser (frontend)",
+          "name": "type",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "server",
+            "browser"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:bootstrap",
+      "id": "sdk-key:create",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3215,24 +3352,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "bootstrap.js"
+        "sdk-key",
+        "create.js"
       ]
     },
-    "workspace:create": {
+    "sdk-key:list": {
       "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Workspace slug (lowercase letters, numbers, hyphens)",
-          "name": "slug",
-          "required": true
-        }
-      },
-      "description": "Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.",
+      "args": {},
+      "description": "List SDK keys for your workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-team",
-        "<%= config.bin %> <%= command.id %> lt-21-smoke --name \"Load Test 21\"",
-        "<%= config.bin %> <%= command.id %> my-team --org 11111111-1111-1111-1111-111111111111"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --environment production"
       ],
       "flags": {
         "json": {
@@ -3264,17 +3394,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Human-readable display name (defaults to the slug)",
-          "name": "name",
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "org": {
-          "description": "Organization UUID or slug. Required when you belong to more than one organization; inferred otherwise.",
-          "name": "org",
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "char": "e",
+          "description": "Filter by environment name",
+          "name": "environment",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3283,7 +3427,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:create",
+      "id": "sdk-key:list",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3293,23 +3437,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "create.js"
+        "sdk-key",
+        "list.js"
       ]
     },
-    "workspace:switch": {
+    "sdk-key:revoke": {
       "aliases": [],
       "args": {
-        "slug": {
-          "description": "Workspace pin in `<org-slug>/<workspace-slug>` form. Omit for an interactive picker.",
-          "name": "slug",
-          "required": false
+        "keyId": {
+          "description": "ID of the SDK key to revoke",
+          "name": "keyId",
+          "required": true
         }
       },
-      "description": "Switch the saved default profile to a different (org, workspace) pair",
+      "description": "Revoke an SDK key by its ID",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> acme/production"
+        "<%= config.bin %> <%= command.id %> a1b2c3d4-e5f6-7890-abcd-ef1234567890"
       ],
       "flags": {
         "json": {
@@ -3340,11 +3483,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:switch",
+      "id": "sdk-key:revoke",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3354,17 +3518,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "switch.js"
+        "sdk-key",
+        "revoke.js"
       ]
     },
-    "sdk-key:create": {
+    "workspace:bootstrap": {
       "aliases": [],
       "args": {},
-      "description": "Create a new SDK key",
+      "description": "Push a local git repo to Gitea as this workspace's config repository",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --environment production --type server",
-        "<%= config.bin %> <%= command.id %> --environment staging --type browser"
+        "<%= config.bin %> workspace bootstrap --dir ./our-config",
+        "<%= config.bin %> workspace bootstrap --dir ./launch-migrator/output",
+        "<%= config.bin %> workspace bootstrap --dir ./our-config --skip-validate"
       ],
       "flags": {
         "json": {
@@ -3396,53 +3561,30 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "workspace": {
-          "char": "w",
-          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
-          "helpGroup": "GLOBAL",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "char": "p",
-          "description": "Deprecated: use --workspace instead",
-          "helpGroup": "GLOBAL",
-          "hidden": true,
-          "name": "profile",
+        "dir": {
+          "description": "Local directory to push (defaults to current directory)",
+          "name": "dir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "char": "e",
-          "description": "Environment name (e.g. production, staging)",
-          "name": "environment",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "force": {
+          "description": "Force push even if remote already has commits",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "type": {
-          "char": "t",
-          "description": "Key type: server (backend) or browser (frontend)",
-          "name": "type",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "server",
-            "browser"
-          ],
-          "type": "option"
+        "skip-validate": {
+          "description": "Skip config validation before pushing",
+          "name": "skip-validate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sdk-key:create",
+      "id": "workspace:bootstrap",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3452,17 +3594,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk-key",
-        "create.js"
+        "workspace",
+        "bootstrap.js"
       ]
     },
-    "sdk-key:list": {
+    "workspace:create": {
       "aliases": [],
-      "args": {},
-      "description": "List SDK keys for your workspace",
+      "args": {
+        "slug": {
+          "description": "Workspace slug (lowercase letters, numbers, hyphens)",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --environment production"
+        "<%= config.bin %> <%= command.id %> my-team",
+        "<%= config.bin %> <%= command.id %> lt-21-smoke --name \"Load Test 21\"",
+        "<%= config.bin %> <%= command.id %> my-team --org 11111111-1111-1111-1111-111111111111"
       ],
       "flags": {
         "json": {
@@ -3494,31 +3643,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "workspace": {
-          "char": "w",
-          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
-          "helpGroup": "GLOBAL",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "char": "p",
-          "description": "Deprecated: use --workspace instead",
-          "helpGroup": "GLOBAL",
-          "hidden": true,
-          "name": "profile",
+        "name": {
+          "description": "Human-readable display name (defaults to the slug)",
+          "name": "name",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "char": "e",
-          "description": "Filter by environment name",
-          "name": "environment",
+        "org": {
+          "description": "Organization UUID or slug. Required when you belong to more than one organization; inferred otherwise.",
+          "name": "org",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3527,7 +3662,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sdk-key:list",
+      "id": "workspace:create",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3537,22 +3672,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk-key",
-        "list.js"
+        "workspace",
+        "create.js"
       ]
     },
-    "sdk-key:revoke": {
+    "workspace:switch": {
       "aliases": [],
       "args": {
-        "keyId": {
-          "description": "ID of the SDK key to revoke",
-          "name": "keyId",
-          "required": true
+        "slug": {
+          "description": "Workspace pin in `<org-slug>/<workspace-slug>` form. Omit for an interactive picker.",
+          "name": "slug",
+          "required": false
         }
       },
-      "description": "Revoke an SDK key by its ID",
+      "description": "Switch the saved default profile to a different (org, workspace) pair",
       "examples": [
-        "<%= config.bin %> <%= command.id %> a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> acme/production"
       ],
       "flags": {
         "json": {
@@ -3583,32 +3719,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
-          "helpGroup": "GLOBAL",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "char": "p",
-          "description": "Deprecated: use --workspace instead",
-          "helpGroup": "GLOBAL",
-          "hidden": true,
-          "name": "profile",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sdk-key:revoke",
+      "id": "workspace:switch",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3618,10 +3733,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk-key",
-        "revoke.js"
+        "workspace",
+        "switch.js"
       ]
     }
   },
-  "version": "0.0.52"
+  "version": "0.0.54"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.0.52",
+  "version": "0.0.54",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },
@@ -21,7 +21,7 @@
     "@oclif/core": "^3.18.2",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^4",
-    "@quonfig/node": "^0.0.28",
+    "@quonfig/node": "^0.0.32",
     "acorn": "^8.10.0",
     "acorn-walk": "^8.3.5",
     "chalk": "^5.4.1",