@xano/cli 0.0.95-beta.1 → 0.0.95-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +20 -8
  2. package/dist/base-command.d.ts +24 -0
  3. package/dist/base-command.js +37 -0
  4. package/dist/commands/release/deploy/index.d.ts +17 -0
  5. package/dist/commands/release/deploy/index.js +107 -0
  6. package/dist/commands/{ephemeral → sandbox}/env/delete/index.d.ts +1 -4
  7. package/dist/commands/{ephemeral → sandbox}/env/delete/index.js +17 -33
  8. package/dist/commands/{ephemeral → sandbox}/env/get/index.d.ts +1 -4
  9. package/dist/commands/{ephemeral → sandbox}/env/get/index.js +13 -29
  10. package/dist/commands/{ephemeral → sandbox}/env/get_all/index.d.ts +1 -4
  11. package/dist/commands/{ephemeral → sandbox}/env/get_all/index.js +16 -32
  12. package/dist/commands/{ephemeral → sandbox}/env/list/index.d.ts +1 -4
  13. package/dist/commands/sandbox/env/list/index.js +67 -0
  14. package/dist/commands/{ephemeral → sandbox}/env/set/index.d.ts +1 -4
  15. package/dist/commands/{ephemeral → sandbox}/env/set/index.js +14 -30
  16. package/dist/commands/{ephemeral → sandbox}/env/set_all/index.d.ts +1 -4
  17. package/dist/commands/{ephemeral → sandbox}/env/set_all/index.js +16 -32
  18. package/dist/commands/{ephemeral → sandbox}/get/index.d.ts +1 -4
  19. package/dist/commands/sandbox/get/index.js +48 -0
  20. package/dist/commands/sandbox/impersonate/index.d.ts +5 -0
  21. package/dist/commands/sandbox/impersonate/index.js +5 -0
  22. package/dist/commands/{ephemeral → sandbox}/license/get/index.d.ts +1 -4
  23. package/dist/commands/{ephemeral → sandbox}/license/get/index.js +16 -32
  24. package/dist/commands/{ephemeral → sandbox}/license/set/index.d.ts +1 -4
  25. package/dist/commands/{ephemeral → sandbox}/license/set/index.js +17 -33
  26. package/dist/commands/{ephemeral → sandbox}/pull/index.d.ts +1 -2
  27. package/dist/commands/{ephemeral → sandbox}/pull/index.js +11 -26
  28. package/dist/commands/{ephemeral → sandbox}/push/index.d.ts +1 -2
  29. package/dist/commands/{ephemeral → sandbox}/push/index.js +13 -28
  30. package/dist/commands/{ephemeral/delete → sandbox/reset}/index.d.ts +1 -5
  31. package/dist/commands/sandbox/reset/index.js +71 -0
  32. package/dist/commands/{ephemeral/impersonate → sandbox/review}/index.d.ts +1 -4
  33. package/dist/commands/{ephemeral/impersonate → sandbox/review}/index.js +15 -31
  34. package/dist/commands/{ephemeral/unit_test/run_all → sandbox/unit_test/list}/index.d.ts +1 -2
  35. package/dist/commands/{ephemeral → sandbox}/unit_test/list/index.js +10 -24
  36. package/dist/commands/{ephemeral → sandbox}/unit_test/run/index.d.ts +1 -2
  37. package/dist/commands/{ephemeral → sandbox}/unit_test/run/index.js +9 -23
  38. package/dist/commands/{ephemeral/unit_test/list → sandbox/unit_test/run_all}/index.d.ts +1 -2
  39. package/dist/commands/{ephemeral → sandbox}/unit_test/run_all/index.js +9 -23
  40. package/dist/commands/{ephemeral/workflow_test/get → sandbox/workflow_test/delete}/index.d.ts +1 -2
  41. package/dist/commands/{ephemeral → sandbox}/workflow_test/delete/index.js +9 -23
  42. package/dist/commands/{ephemeral/workflow_test/run → sandbox/workflow_test/get}/index.d.ts +1 -2
  43. package/dist/commands/{ephemeral → sandbox}/workflow_test/get/index.js +8 -25
  44. package/dist/commands/{ephemeral/workflow_test/run_all → sandbox/workflow_test/list}/index.d.ts +1 -2
  45. package/dist/commands/{ephemeral → sandbox}/workflow_test/list/index.js +11 -25
  46. package/dist/commands/{ephemeral/workflow_test/delete → sandbox/workflow_test/run}/index.d.ts +1 -2
  47. package/dist/commands/{ephemeral → sandbox}/workflow_test/run/index.js +9 -23
  48. package/dist/commands/{ephemeral/workflow_test/list → sandbox/workflow_test/run_all}/index.d.ts +1 -2
  49. package/dist/commands/{ephemeral → sandbox}/workflow_test/run_all/index.js +9 -23
  50. package/dist/commands/tenant/get/index.js +2 -2
  51. package/dist/commands/tenant/list/index.js +2 -2
  52. package/dist/commands/tenant/push/index.js +0 -34
  53. package/dist/commands/workspace/push/index.js +26 -0
  54. package/oclif.manifest.json +2266 -2658
  55. package/package.json +7 -7
  56. package/dist/commands/ephemeral/access/index.d.ts +0 -15
  57. package/dist/commands/ephemeral/access/index.js +0 -78
  58. package/dist/commands/ephemeral/create/index.d.ts +0 -17
  59. package/dist/commands/ephemeral/create/index.js +0 -102
  60. package/dist/commands/ephemeral/delete/index.js +0 -99
  61. package/dist/commands/ephemeral/env/list/index.js +0 -83
  62. package/dist/commands/ephemeral/get/index.js +0 -102
  63. package/dist/commands/ephemeral/list/index.d.ts +0 -15
  64. package/dist/commands/ephemeral/list/index.js +0 -109
  65. package/dist/commands/ephemeral/shared/index.d.ts +0 -15
  66. package/dist/commands/ephemeral/shared/index.js +0 -108
package/README.md CHANGED
@@ -235,6 +235,11 @@ xano release pull ./my-release -r v1.0 --env --records
235
235
  xano release push ./my-release -n "v2.0"
236
236
  xano release push ./my-release -n "v2.0" --hotfix -d "Critical fix"
237
237
  xano release push ./my-release -n "v2.0" --no-records --no-env
238
+
239
+ # Deploy a release to its workspace as a new branch
240
+ xano release deploy "v1.0"
241
+ xano release deploy "v1.0" --branch "restore-v1" --no-set_live
242
+ xano release deploy "v1.0" -w 40 -o json
238
243
  ```
239
244
 
240
245
  ### Platforms
@@ -440,18 +445,25 @@ xano tenant cluster license set <cluster_id>
440
445
  xano tenant cluster license set <cluster_id> --file ./kubeconfig.yaml
441
446
  ```
442
447
 
443
- ### Ephemeral
448
+ ### Sandbox
444
449
 
445
- Manage ephemeral tenants. Ephemeral tenants are workspace-agnostic (tier1 only) and do not run background tasks.
450
+ Manage your sandbox tenant. Each user has a single sandbox tenant that is auto-provisioned on first use.
446
451
 
447
452
  ```bash
448
- # Create an ephemeral tenant
449
- xano ephemeral create "My Ephemeral"
450
- xano ephemeral create "CI Tenant" -d "For CI/CD" -o json
453
+ # Get your sandbox tenant (creates if needed)
454
+ xano sandbox get
455
+ xano sandbox get -o json
456
+
457
+ # Push/pull workspace data
458
+ xano sandbox push ./my-workspace
459
+ xano sandbox pull ./my-tenant
460
+
461
+ # Impersonate (open in browser)
462
+ xano sandbox impersonate
451
463
 
452
- # Get ephemeral tenant details
453
- xano ephemeral get <tenant_name>
454
- xano ephemeral get <tenant_name> -o json
464
+ # Reset all workspace data
465
+ xano sandbox reset
466
+ xano sandbox reset --force
455
467
  ```
456
468
 
457
469
  ### Static Hosts
@@ -14,6 +14,16 @@ export interface CredentialsFile {
14
14
  };
15
15
  }
16
16
  export declare function buildUserAgent(version: string): string;
17
+ export interface SandboxTenant {
18
+ created_at?: string;
19
+ description?: string;
20
+ display?: string;
21
+ ephemeral?: boolean;
22
+ id: number;
23
+ name: string;
24
+ state?: string;
25
+ xano_domain?: string;
26
+ }
17
27
  export default abstract class BaseCommand extends Command {
18
28
  static baseFlags: {
19
29
  profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -38,6 +48,20 @@ export default abstract class BaseCommand extends Command {
38
48
  * Load and parse the credentials file. Returns null if the file doesn't exist.
39
49
  */
40
50
  protected loadCredentialsFile(): CredentialsFile | null;
51
+ /**
52
+ * Get or create the singleton sandbox environment for the authenticated user.
53
+ * Returns the sandbox object (existing or newly created).
54
+ */
55
+ protected getOrCreateSandbox(profile: ProfileConfig, verbose: boolean): Promise<SandboxTenant>;
56
+ /**
57
+ * Resolve profile from flags, validating instance_origin and access_token exist.
58
+ */
59
+ protected resolveProfile(flags: {
60
+ profile?: string;
61
+ }): {
62
+ profile: ProfileConfig;
63
+ profileName: string;
64
+ };
41
65
  /**
42
66
  * Make an HTTP request with optional verbose logging.
43
67
  * Use this for all Metadata API calls to support the --verbose flag.
@@ -103,6 +103,43 @@ export default class BaseCommand extends Command {
103
103
  }
104
104
  return null;
105
105
  }
106
+ /**
107
+ * Get or create the singleton sandbox environment for the authenticated user.
108
+ * Returns the sandbox object (existing or newly created).
109
+ */
110
+ async getOrCreateSandbox(profile, verbose) {
111
+ const apiUrl = `${profile.instance_origin}/api:meta/sandbox/me`;
112
+ const response = await this.verboseFetch(apiUrl, {
113
+ headers: {
114
+ accept: 'application/json',
115
+ Authorization: `Bearer ${profile.access_token}`,
116
+ },
117
+ method: 'GET',
118
+ }, verbose, profile.access_token);
119
+ if (!response.ok) {
120
+ const errorText = await response.text();
121
+ this.error(`Failed to get sandbox environment: ${response.status} ${response.statusText}\n${errorText}`);
122
+ }
123
+ return (await response.json());
124
+ }
125
+ /**
126
+ * Resolve profile from flags, validating instance_origin and access_token exist.
127
+ */
128
+ resolveProfile(flags) {
129
+ const profileName = flags.profile || this.getDefaultProfile();
130
+ const credentials = this.loadCredentialsFile();
131
+ if (!credentials || !(profileName in credentials.profiles)) {
132
+ this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
133
+ }
134
+ const profile = credentials.profiles[profileName];
135
+ if (!profile.instance_origin) {
136
+ this.error(`Profile '${profileName}' is missing instance_origin`);
137
+ }
138
+ if (!profile.access_token) {
139
+ this.error(`Profile '${profileName}' is missing access_token`);
140
+ }
141
+ return { profile, profileName };
142
+ }
106
143
  /**
107
144
  * Make an HTTP request with optional verbose logging.
108
145
  * Use this for all Metadata API calls to support the --verbose flag.
@@ -0,0 +1,17 @@
1
+ import BaseCommand from '../../../base-command.js';
2
+ export default class ReleaseDeploy extends BaseCommand {
3
+ static args: {
4
+ release_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
+ };
6
+ static description: string;
7
+ static examples: string[];
8
+ static flags: {
9
+ branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
10
+ output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
11
+ set_live: import("@oclif/core/interfaces").BooleanFlag<boolean>;
12
+ workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
13
+ profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
14
+ verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
15
+ };
16
+ run(): Promise<void>;
17
+ }
@@ -0,0 +1,107 @@
1
+ import { Args, Flags } from '@oclif/core';
2
+ import BaseCommand from '../../../base-command.js';
3
+ export default class ReleaseDeploy extends BaseCommand {
4
+ static args = {
5
+ release_name: Args.string({
6
+ description: 'Name of the release to deploy',
7
+ required: true,
8
+ }),
9
+ };
10
+ static description = 'Deploy a release to its workspace as a new branch';
11
+ static examples = [
12
+ `$ xano release deploy "v1.0"
13
+ Deployed release "v1.0" to workspace 40 (branch: v1.0, set live)
14
+ `,
15
+ `$ xano release deploy "v1.0" --branch "restore-v1" --no-set_live`,
16
+ `$ xano release deploy "v1.0" -w 40 -o json`,
17
+ ];
18
+ static flags = {
19
+ ...BaseCommand.baseFlags,
20
+ branch: Flags.string({
21
+ char: 'b',
22
+ description: 'Branch label for the new branch (defaults to release branch name)',
23
+ required: false,
24
+ }),
25
+ output: Flags.string({
26
+ char: 'o',
27
+ default: 'summary',
28
+ description: 'Output format',
29
+ options: ['summary', 'json'],
30
+ required: false,
31
+ }),
32
+ set_live: Flags.boolean({
33
+ default: false,
34
+ description: 'Set the new branch as live',
35
+ required: false,
36
+ }),
37
+ workspace: Flags.string({
38
+ char: 'w',
39
+ description: 'Workspace ID (uses profile workspace if not provided)',
40
+ required: false,
41
+ }),
42
+ };
43
+ async run() {
44
+ const { args, flags } = await this.parse(ReleaseDeploy);
45
+ const profileName = flags.profile || this.getDefaultProfile();
46
+ const credentials = this.loadCredentialsFile();
47
+ if (!credentials || !(profileName in credentials.profiles)) {
48
+ this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
49
+ }
50
+ const profile = credentials.profiles[profileName];
51
+ if (!profile.instance_origin) {
52
+ this.error(`Profile '${profileName}' is missing instance_origin`);
53
+ }
54
+ if (!profile.access_token) {
55
+ this.error(`Profile '${profileName}' is missing access_token`);
56
+ }
57
+ const workspaceId = flags.workspace || profile.workspace;
58
+ if (!workspaceId) {
59
+ this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
60
+ }
61
+ const releaseName = encodeURIComponent(args.release_name);
62
+ const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/release/${releaseName}/deploy`;
63
+ const body = {
64
+ set_live: flags.set_live,
65
+ };
66
+ if (flags.branch)
67
+ body.branch = flags.branch;
68
+ this.warn('This may take a few minutes. Please be patient.');
69
+ const startTime = Date.now();
70
+ try {
71
+ const response = await this.verboseFetch(apiUrl, {
72
+ body: JSON.stringify(body),
73
+ headers: {
74
+ accept: 'application/json',
75
+ Authorization: `Bearer ${profile.access_token}`,
76
+ 'Content-Type': 'application/json',
77
+ },
78
+ method: 'POST',
79
+ }, flags.verbose, profile.access_token);
80
+ if (!response.ok) {
81
+ const errorText = await response.text();
82
+ this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
83
+ }
84
+ const release = (await response.json());
85
+ if (flags.output === 'json') {
86
+ this.log(JSON.stringify(release, null, 2));
87
+ }
88
+ else {
89
+ const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
90
+ const branchLabel = flags.branch || release.branch || 'default';
91
+ const liveStatus = flags.set_live ? ', set live' : '';
92
+ this.log(`Deployed release "${release.name}" to workspace ${workspaceId} (branch: ${branchLabel}${liveStatus})`);
93
+ if (release.description)
94
+ this.log(` Description: ${release.description}`);
95
+ this.log(` Time: ${elapsed}s`);
96
+ }
97
+ }
98
+ catch (error) {
99
+ if (error instanceof Error) {
100
+ this.error(`Failed to deploy release: ${error.message}`);
101
+ }
102
+ else {
103
+ this.error(`Failed to deploy release: ${String(error)}`);
104
+ }
105
+ }
106
+ }
107
+ }
@@ -1,8 +1,5 @@
1
1
  import BaseCommand from '../../../../base-command.js';
2
- export default class EphemeralEnvDelete extends BaseCommand {
3
- static args: {
4
- tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
- };
2
+ export default class SandboxEnvDelete extends BaseCommand {
6
3
  static description: string;
7
4
  static examples: string[];
8
5
  static flags: {
@@ -1,20 +1,14 @@
1
- import { Args, Flags } from '@oclif/core';
1
+ import { Flags } from '@oclif/core';
2
2
  import BaseCommand from '../../../../base-command.js';
3
- export default class EphemeralEnvDelete extends BaseCommand {
4
- static args = {
5
- tenant_name: Args.string({
6
- description: 'Ephemeral tenant name',
7
- required: true,
8
- }),
9
- };
10
- static description = 'Delete an environment variable from an ephemeral tenant';
3
+ export default class SandboxEnvDelete extends BaseCommand {
4
+ static description = 'Delete an environment variable from a sandbox environment';
11
5
  static examples = [
12
- `$ xano ephemeral env delete my-tenant --name DATABASE_URL
13
- Are you sure you want to delete environment variable 'DATABASE_URL' from ephemeral tenant my-tenant? (y/N) y
14
- Environment variable 'DATABASE_URL' deleted from ephemeral tenant my-tenant
6
+ `$ xano sandbox env delete --name DATABASE_URL
7
+ Are you sure you want to delete environment variable 'DATABASE_URL'? (y/N) y
8
+ Environment variable 'DATABASE_URL' deleted
15
9
  `,
16
- `$ xano ephemeral env delete my-tenant --name DATABASE_URL --force`,
17
- `$ xano ephemeral env delete my-tenant --name DATABASE_URL -f -o json`,
10
+ `$ xano sandbox env delete --name DATABASE_URL --force`,
11
+ `$ xano sandbox env delete --name DATABASE_URL -f -o json`,
18
12
  ];
19
13
  static flags = {
20
14
  ...BaseCommand.baseFlags,
@@ -38,29 +32,19 @@ Environment variable 'DATABASE_URL' deleted from ephemeral tenant my-tenant
38
32
  }),
39
33
  };
40
34
  async run() {
41
- const { args, flags } = await this.parse(EphemeralEnvDelete);
42
- const profileName = flags.profile || this.getDefaultProfile();
43
- const credentials = this.loadCredentialsFile();
44
- if (!credentials || !(profileName in credentials.profiles)) {
45
- this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
46
- }
47
- const profile = credentials.profiles[profileName];
48
- if (!profile.instance_origin) {
49
- this.error(`Profile '${profileName}' is missing instance_origin`);
50
- }
51
- if (!profile.access_token) {
52
- this.error(`Profile '${profileName}' is missing access_token`);
53
- }
54
- const tenantName = args.tenant_name;
35
+ const { flags } = await this.parse(SandboxEnvDelete);
36
+ const { profile } = this.resolveProfile(flags);
37
+ const tenant = await this.getOrCreateSandbox(profile, flags.verbose);
38
+ const tenantName = tenant.name;
55
39
  const envName = flags.name;
56
40
  if (!flags.force) {
57
- const confirmed = await this.confirm(`Are you sure you want to delete environment variable '${envName}' from ephemeral tenant ${tenantName}?`);
41
+ const confirmed = await this.confirm(`Are you sure you want to delete environment variable '${envName}' from sandbox environment ${tenantName}?`);
58
42
  if (!confirmed) {
59
43
  this.log('Deletion cancelled.');
60
44
  return;
61
45
  }
62
46
  }
63
- const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/env/${envName}`;
47
+ const apiUrl = `${profile.instance_origin}/api:meta/sandbox/tenant/${tenantName}/env/${envName}`;
64
48
  try {
65
49
  const response = await this.verboseFetch(apiUrl, {
66
50
  headers: {
@@ -77,15 +61,15 @@ Environment variable 'DATABASE_URL' deleted from ephemeral tenant my-tenant
77
61
  this.log(JSON.stringify({ deleted: true, env_name: envName, tenant_name: tenantName }, null, 2));
78
62
  }
79
63
  else {
80
- this.log(`Environment variable '${envName}' deleted from ephemeral tenant ${tenantName}`);
64
+ this.log(`Environment variable '${envName}' deleted from sandbox environment ${tenantName}`);
81
65
  }
82
66
  }
83
67
  catch (error) {
84
68
  if (error instanceof Error) {
85
- this.error(`Failed to delete ephemeral tenant environment variable: ${error.message}`);
69
+ this.error(`Failed to delete sandbox environment variable: ${error.message}`);
86
70
  }
87
71
  else {
88
- this.error(`Failed to delete ephemeral tenant environment variable: ${String(error)}`);
72
+ this.error(`Failed to delete sandbox environment variable: ${String(error)}`);
89
73
  }
90
74
  }
91
75
  }
@@ -1,8 +1,5 @@
1
1
  import BaseCommand from '../../../../base-command.js';
2
- export default class EphemeralEnvGet extends BaseCommand {
3
- static args: {
4
- tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
- };
2
+ export default class SandboxEnvGet extends BaseCommand {
6
3
  static description: string;
7
4
  static examples: string[];
8
5
  static flags: {
@@ -1,18 +1,12 @@
1
- import { Args, Flags } from '@oclif/core';
1
+ import { Flags } from '@oclif/core';
2
2
  import BaseCommand from '../../../../base-command.js';
3
- export default class EphemeralEnvGet extends BaseCommand {
4
- static args = {
5
- tenant_name: Args.string({
6
- description: 'Ephemeral tenant name',
7
- required: true,
8
- }),
9
- };
10
- static description = 'Get a single environment variable for an ephemeral tenant';
3
+ export default class SandboxEnvGet extends BaseCommand {
4
+ static description = 'Get a single environment variable for a sandbox environment';
11
5
  static examples = [
12
- `$ xano ephemeral env get my-tenant --name DATABASE_URL
6
+ `$ xano sandbox env get --name DATABASE_URL
13
7
  postgres://localhost:5432/mydb
14
8
  `,
15
- `$ xano ephemeral env get my-tenant --name DATABASE_URL -o json`,
9
+ `$ xano sandbox env get --name DATABASE_URL -o json`,
16
10
  ];
17
11
  static flags = {
18
12
  ...BaseCommand.baseFlags,
@@ -30,22 +24,12 @@ postgres://localhost:5432/mydb
30
24
  }),
31
25
  };
32
26
  async run() {
33
- const { args, flags } = await this.parse(EphemeralEnvGet);
34
- const profileName = flags.profile || this.getDefaultProfile();
35
- const credentials = this.loadCredentialsFile();
36
- if (!credentials || !(profileName in credentials.profiles)) {
37
- this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
38
- }
39
- const profile = credentials.profiles[profileName];
40
- if (!profile.instance_origin) {
41
- this.error(`Profile '${profileName}' is missing instance_origin`);
42
- }
43
- if (!profile.access_token) {
44
- this.error(`Profile '${profileName}' is missing access_token`);
45
- }
46
- const tenantName = args.tenant_name;
27
+ const { flags } = await this.parse(SandboxEnvGet);
28
+ const { profile } = this.resolveProfile(flags);
29
+ const tenant = await this.getOrCreateSandbox(profile, flags.verbose);
30
+ const tenantName = tenant.name;
47
31
  const envName = flags.name;
48
- const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/env/${envName}`;
32
+ const apiUrl = `${profile.instance_origin}/api:meta/sandbox/tenant/${tenantName}/env/${envName}`;
49
33
  try {
50
34
  const response = await this.verboseFetch(apiUrl, {
51
35
  headers: {
@@ -66,15 +50,15 @@ postgres://localhost:5432/mydb
66
50
  this.log(envVar.value);
67
51
  }
68
52
  else {
69
- this.log(`Environment variable '${envName}' not found for ephemeral tenant ${tenantName}`);
53
+ this.log(`Environment variable '${envName}' not found for sandbox environment ${tenantName}`);
70
54
  }
71
55
  }
72
56
  catch (error) {
73
57
  if (error instanceof Error) {
74
- this.error(`Failed to get ephemeral tenant environment variable: ${error.message}`);
58
+ this.error(`Failed to get sandbox environment variable: ${error.message}`);
75
59
  }
76
60
  else {
77
- this.error(`Failed to get ephemeral tenant environment variable: ${String(error)}`);
61
+ this.error(`Failed to get sandbox environment variable: ${String(error)}`);
78
62
  }
79
63
  }
80
64
  }
@@ -1,8 +1,5 @@
1
1
  import BaseCommand from '../../../../base-command.js';
2
- export default class EphemeralEnvGetAll extends BaseCommand {
3
- static args: {
4
- tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
- };
2
+ export default class SandboxEnvGetAll extends BaseCommand {
6
3
  static description: string;
7
4
  static examples: string[];
8
5
  static flags: {
@@ -1,29 +1,23 @@
1
- import { Args, Flags } from '@oclif/core';
1
+ import { Flags } from '@oclif/core';
2
2
  import * as yaml from 'js-yaml';
3
3
  import * as fs from 'node:fs';
4
4
  import * as path from 'node:path';
5
5
  import BaseCommand from '../../../../base-command.js';
6
- export default class EphemeralEnvGetAll extends BaseCommand {
7
- static args = {
8
- tenant_name: Args.string({
9
- description: 'Ephemeral tenant name',
10
- required: true,
11
- }),
12
- };
13
- static description = 'Get all environment variables for an ephemeral tenant and save to a YAML file';
6
+ export default class SandboxEnvGetAll extends BaseCommand {
7
+ static description = 'Get all environment variables for a sandbox environment and save to a YAML file';
14
8
  static examples = [
15
- `$ xano ephemeral env get_all my-tenant
16
- Environment variables saved to env_my-tenant.yaml
9
+ `$ xano sandbox env get_all
10
+ Environment variables saved to env_<tenant>.yaml
17
11
  `,
18
- `$ xano ephemeral env get_all my-tenant --file ./my-env.yaml`,
19
- `$ xano ephemeral env get_all my-tenant --view`,
20
- `$ xano ephemeral env get_all my-tenant -o json`,
12
+ `$ xano sandbox env get_all --file ./my-env.yaml`,
13
+ `$ xano sandbox env get_all --view`,
14
+ `$ xano sandbox env get_all -o json`,
21
15
  ];
22
16
  static flags = {
23
17
  ...BaseCommand.baseFlags,
24
18
  file: Flags.string({
25
19
  char: 'f',
26
- description: 'Output file path (default: env_<tenant_name>.yaml)',
20
+ description: 'Output file path (default: env_<sandbox_name>.yaml)',
27
21
  required: false,
28
22
  }),
29
23
  output: Flags.string({
@@ -40,21 +34,11 @@ Environment variables saved to env_my-tenant.yaml
40
34
  }),
41
35
  };
42
36
  async run() {
43
- const { args, flags } = await this.parse(EphemeralEnvGetAll);
44
- const profileName = flags.profile || this.getDefaultProfile();
45
- const credentials = this.loadCredentialsFile();
46
- if (!credentials || !(profileName in credentials.profiles)) {
47
- this.error(`Profile '${profileName}' not found.\n` + `Create a profile using 'xano profile create'`);
48
- }
49
- const profile = credentials.profiles[profileName];
50
- if (!profile.instance_origin) {
51
- this.error(`Profile '${profileName}' is missing instance_origin`);
52
- }
53
- if (!profile.access_token) {
54
- this.error(`Profile '${profileName}' is missing access_token`);
55
- }
56
- const tenantName = args.tenant_name;
57
- const apiUrl = `${profile.instance_origin}/api:meta/ephemeral/tenant/${tenantName}/env_all`;
37
+ const { flags } = await this.parse(SandboxEnvGetAll);
38
+ const { profile } = this.resolveProfile(flags);
39
+ const tenant = await this.getOrCreateSandbox(profile, flags.verbose);
40
+ const tenantName = tenant.name;
41
+ const apiUrl = `${profile.instance_origin}/api:meta/sandbox/tenant/${tenantName}/env_all`;
58
42
  try {
59
43
  const response = await this.verboseFetch(apiUrl, {
60
44
  headers: {
@@ -84,10 +68,10 @@ Environment variables saved to env_my-tenant.yaml
84
68
  }
85
69
  catch (error) {
86
70
  if (error instanceof Error) {
87
- this.error(`Failed to get ephemeral tenant environment variables: ${error.message}`);
71
+ this.error(`Failed to get sandbox environment variables: ${error.message}`);
88
72
  }
89
73
  else {
90
- this.error(`Failed to get ephemeral tenant environment variables: ${String(error)}`);
74
+ this.error(`Failed to get sandbox environment variables: ${String(error)}`);
91
75
  }
92
76
  }
93
77
  }
@@ -1,8 +1,5 @@
1
1
  import BaseCommand from '../../../../base-command.js';
2
- export default class EphemeralEnvList extends BaseCommand {
3
- static args: {
4
- tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
- };
2
+ export default class SandboxEnvList extends BaseCommand {
6
3
  static description: string;
7
4
  static examples: string[];
8
5
  static flags: {
@@ -0,0 +1,67 @@
1
+ import { Flags } from '@oclif/core';
2
+ import BaseCommand from '../../../../base-command.js';
3
+ export default class SandboxEnvList extends BaseCommand {
4
+ static description = 'List environment variable keys for a sandbox environment';
5
+ static examples = [
6
+ `$ xano sandbox env list
7
+ Environment variables for sandbox environment:
8
+ - DATABASE_URL
9
+ - API_KEY
10
+ `,
11
+ `$ xano sandbox env list -o json`,
12
+ ];
13
+ static flags = {
14
+ ...BaseCommand.baseFlags,
15
+ output: Flags.string({
16
+ char: 'o',
17
+ default: 'summary',
18
+ description: 'Output format',
19
+ options: ['summary', 'json'],
20
+ required: false,
21
+ }),
22
+ };
23
+ async run() {
24
+ const { flags } = await this.parse(SandboxEnvList);
25
+ const { profile } = this.resolveProfile(flags);
26
+ const tenant = await this.getOrCreateSandbox(profile, flags.verbose);
27
+ const tenantName = tenant.name;
28
+ const apiUrl = `${profile.instance_origin}/api:meta/sandbox/tenant/${tenantName}/env_key`;
29
+ try {
30
+ const response = await this.verboseFetch(apiUrl, {
31
+ headers: {
32
+ accept: 'application/json',
33
+ Authorization: `Bearer ${profile.access_token}`,
34
+ },
35
+ method: 'GET',
36
+ }, flags.verbose, profile.access_token);
37
+ if (!response.ok) {
38
+ const errorText = await response.text();
39
+ this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
40
+ }
41
+ const data = (await response.json());
42
+ if (flags.output === 'json') {
43
+ this.log(JSON.stringify(data, null, 2));
44
+ }
45
+ else {
46
+ const envVars = data.env || [];
47
+ if (envVars.length === 0) {
48
+ this.log(`No environment variables found for sandbox environment ${tenantName}`);
49
+ }
50
+ else {
51
+ this.log(`Environment variables for sandbox environment ${tenantName}:`);
52
+ for (const envVar of envVars) {
53
+ this.log(` - ${envVar.name}`);
54
+ }
55
+ }
56
+ }
57
+ }
58
+ catch (error) {
59
+ if (error instanceof Error) {
60
+ this.error(`Failed to list sandbox environment variables: ${error.message}`);
61
+ }
62
+ else {
63
+ this.error(`Failed to list sandbox environment variables: ${String(error)}`);
64
+ }
65
+ }
66
+ }
67
+ }
@@ -1,8 +1,5 @@
1
1
  import BaseCommand from '../../../../base-command.js';
2
- export default class EphemeralEnvSet extends BaseCommand {
3
- static args: {
4
- tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
5
- };
2
+ export default class SandboxEnvSet extends BaseCommand {
6
3
  static description: string;
7
4
  static examples: string[];
8
5
  static flags: {