@xano/cli 1.0.6-beta.15 → 1.0.6-beta.16

package/README.md

@@ -323,6 +323,7 @@ xano function run <name> --data email=jo@x.com --data age:=30 --data active:=tru
 xano function run <name> --json @payload.json --data env=staging   # base payload + override
 echo '{"email":"jo@x.com"}' | xano function run <name> --stdin -o json | jq .result
 xano function run <name> --branch dev --logs            # run on a branch, show execution logs
+xano function run <name> --datasource test              # run against the 'test' data source
 ```
 
 Input flexibility for `function run` (assembled into one JSON `input` object):
@@ -335,6 +336,11 @@ Input flexibility for `function run` (assembled into one JSON `input` object):
 | `--json '<inline>'` / `--json @file.json` / `--json -` | a base JSON object (stdin with `-`) |
 | `--stdin` | read the JSON object from stdin (same as `--json -`) |
 
+`--datasource <label>` runs the function against a non-live data source by sending the
+`X-Data-Source` header, so table reads and writes hit that data source's tables. Omit it
+to run against `live`; an unknown label is rejected by the server with
+`Invalid data source.`
+
 Merge order is JSON base first, then `--data` overrides. Missing required inputs are
 prompted for on an interactive terminal; in a non-TTY (CI) context the command fails
 listing them. Output defaults to the raw `result` (`-o json`); the exit code is non-zero

package/dist/commands/function/run/index.d.ts

@@ -8,6 +8,7 @@ export default class FunctionRun extends BaseCommand {
     static flags: {
         branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         data: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        datasource: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         json: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         logs: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/function/run/index.js

@@ -17,6 +17,8 @@ export default class FunctionRun extends BaseCommand {
         `$ xano function:run calcScore --json @payload.json --data env=staging`,
         `$ echo '{"email":"jo@x.com"}' | xano function:run calcScore --stdin -o json | jq .result`,
         `$ xano function:run calcScore --branch dev --logs`,
+        `$ xano function:run calcScore --datasource test
+# Runs against the 'test' data source instead of 'live'`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
@@ -30,6 +32,10 @@ export default class FunctionRun extends BaseCommand {
             multiple: true,
             required: false,
         }),
+        datasource: Flags.string({
+            description: 'Data source to run against, e.g. test (defaults to live)',
+            required: false,
+        }),
         json: Flags.string({
             description: "Input as a JSON object: inline, @file.json, or '-' for stdin",
             exclusive: ['stdin'],
@@ -106,13 +112,21 @@ export default class FunctionRun extends BaseCommand {
         const body = { input, name: functionName };
         if (branch)
             body.branch = branch;
+        const headers = {
+            'accept': 'application/json',
+            'Authorization': `Bearer ${profile.access_token}`,
+            'Content-Type': 'application/json',
+        };
+        // The Metadata API resolves the workspace's tables against the data source
+        // named by X-Data-Source (defaulting to `live`), so the run reads and writes
+        // the same tables a request carrying that header would. An unknown label is
+        // rejected server-side with "Invalid data source."
+        const dataSource = flags.datasource?.trim();
+        if (dataSource)
+            headers['X-Data-Source'] = dataSource;
         const response = await this.verboseFetch(apiUrl, {
             body: JSON.stringify(body),
-            headers: {
-                'accept': 'application/json',
-                'Authorization': `Bearer ${profile.access_token}`,
-                'Content-Type': 'application/json',
-            },
+            headers,
             method: 'POST',
         }, flags.verbose, profile.access_token);
         if (!response.ok) {