@revoengine/cli 1.0.29 → 1.0.31

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 (69) hide show
  1. package/README.md +156 -3
  2. package/dist/src/automation-contract.generated.d.ts +742 -0
  3. package/dist/src/automation-contract.generated.js +1021 -0
  4. package/dist/src/cli.js +9 -1
  5. package/dist/src/client.d.ts +24 -0
  6. package/dist/src/client.js +60 -0
  7. package/dist/src/commands/component.js +56 -23
  8. package/dist/src/commands/env.js +1 -1
  9. package/dist/src/commands/index.d.ts +2 -0
  10. package/dist/src/commands/index.js +2 -0
  11. package/dist/src/commands/studio.d.ts +3 -0
  12. package/dist/src/commands/studio.js +114 -0
  13. package/dist/src/commands/terminal-browser-human-input.d.ts +11 -0
  14. package/dist/src/commands/terminal-browser-human-input.js +44 -0
  15. package/dist/src/commands/terminal-browser-interaction.d.ts +25 -0
  16. package/dist/src/commands/terminal-browser-interaction.js +56 -0
  17. package/dist/src/commands/terminal-browser-live-protocol.d.ts +151 -0
  18. package/dist/src/commands/terminal-browser-live-protocol.js +177 -0
  19. package/dist/src/commands/terminal-browser-live-transport.d.ts +41 -0
  20. package/dist/src/commands/terminal-browser-live-transport.js +206 -0
  21. package/dist/src/commands/terminal-browser-live.d.ts +114 -0
  22. package/dist/src/commands/terminal-browser-live.js +455 -0
  23. package/dist/src/commands/terminal-browser-observation.d.ts +10 -0
  24. package/dist/src/commands/terminal-browser-observation.js +27 -0
  25. package/dist/src/commands/terminal-browser-page-input.d.ts +8 -0
  26. package/dist/src/commands/terminal-browser-page-input.js +94 -0
  27. package/dist/src/commands/terminal-browser-profile-preferences.d.ts +37 -0
  28. package/dist/src/commands/terminal-browser-profile-preferences.js +136 -0
  29. package/dist/src/commands/terminal-browser-profile.d.ts +52 -0
  30. package/dist/src/commands/terminal-browser-profile.js +447 -0
  31. package/dist/src/commands/terminal-browser.d.ts +28 -1
  32. package/dist/src/commands/terminal-browser.js +401 -55
  33. package/dist/src/commands/terminal-policy.js +2 -0
  34. package/dist/src/commands/terminal-public-web-proxy.d.ts +14 -0
  35. package/dist/src/commands/terminal-public-web-proxy.js +141 -0
  36. package/dist/src/commands/terminal-public-web.d.ts +11 -0
  37. package/dist/src/commands/terminal-public-web.js +99 -0
  38. package/dist/src/commands/terminal.d.ts +1 -0
  39. package/dist/src/commands/terminal.js +92 -9
  40. package/dist/src/commands/tests.d.ts +3 -0
  41. package/dist/src/commands/tests.js +236 -0
  42. package/dist/src/component-element-validation.d.ts +8 -0
  43. package/dist/src/component-element-validation.js +79 -0
  44. package/dist/src/component-lifecycle.d.ts +3 -0
  45. package/dist/src/component-lifecycle.js +17 -0
  46. package/dist/src/component-lock.d.ts +17 -12
  47. package/dist/src/component-lock.js +57 -6
  48. package/dist/src/component-manifests.js +3 -0
  49. package/dist/src/component-source-validation.d.ts +5 -0
  50. package/dist/src/component-source-validation.js +27 -0
  51. package/dist/src/env-sync.js +67 -9
  52. package/dist/src/native-tests.d.ts +61 -0
  53. package/dist/src/native-tests.js +20 -0
  54. package/dist/src/request-contract.d.ts +39 -0
  55. package/dist/src/request-contract.js +138 -0
  56. package/dist/src/resource-syncs/agent-sync.js +47 -7
  57. package/dist/src/resource-syncs/database-table-sync.js +8 -8
  58. package/dist/src/resource-syncs/endpoint-sync.js +20 -14
  59. package/dist/src/resource-syncs/group-sync.js +8 -3
  60. package/dist/src/resource-syncs/job-template-sync.js +75 -28
  61. package/dist/src/resource-syncs/role-group-sync.js +8 -0
  62. package/dist/src/resource-syncs/runtime-definition-validation.d.ts +14 -0
  63. package/dist/src/resource-syncs/runtime-definition-validation.js +153 -0
  64. package/dist/src/test-workspace.d.ts +33 -0
  65. package/dist/src/test-workspace.js +156 -0
  66. package/dist/src/types.d.ts +1 -0
  67. package/dist/src/ui.js +12 -0
  68. package/dist/src/update-notifier.d.ts +1 -1
  69. package/package.json +5 -3
@@ -0,0 +1,94 @@
1
+ import { validBrowserInteraction } from "./terminal-browser-interaction.js";
2
+ const NON_TYPING_KEYS = new Set(['Enter', 'Tab', 'Escape', 'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight',
3
+ 'PageUp', 'PageDown', 'Home', 'End']);
4
+ /** CAPTCHA answers are model-solvable; explicit password/MFA controls remain private. */
5
+ export function secretControlAttributes(attributes) {
6
+ const text = attributes.filter(Boolean).join(' ');
7
+ if (attributes[0]?.toLowerCase() === 'password' || /one-time-code/iu.test(attributes[3] || ''))
8
+ return true;
9
+ if (/captcha/iu.test(text) && !/passw(or)?d|secret|api.?key|\botp\b|2fa|mfa/iu.test(text))
10
+ return false;
11
+ return /passw(or)?d|secret|api.?key|token|one.?time|verification.?code|auth.?code|passcode|\botp\b|2fa|mfa/iu.test(text);
12
+ }
13
+ export async function pageHasSecretFocus(page) {
14
+ for (const frame of page.frames()) {
15
+ const attributes = await frame.evaluate(() => {
16
+ let active = document.activeElement;
17
+ while (active?.shadowRoot?.activeElement)
18
+ active = active.shadowRoot.activeElement;
19
+ return active ? ['type', 'id', 'name', 'autocomplete', 'aria-label', 'placeholder']
20
+ .map(name => active.getAttribute(name)) : null;
21
+ }).catch(() => ['password']);
22
+ if (attributes && secretControlAttributes(attributes))
23
+ return true;
24
+ }
25
+ return false;
26
+ }
27
+ export async function clearSecretInputs(page) {
28
+ for (const frame of page.frames())
29
+ await frame.evaluate(() => {
30
+ const elements = (root) => [...root.querySelectorAll('*')].flatMap(element => [element, ...(element.shadowRoot ? elements(element.shadowRoot) : [])]);
31
+ for (const element of elements(document)) {
32
+ if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement))
33
+ continue;
34
+ const attrs = ['type', 'id', 'name', 'autocomplete', 'aria-label', 'placeholder'].map(name => element.getAttribute(name));
35
+ const text = attrs.filter(Boolean).join(' ');
36
+ const explicit = attrs[0]?.toLowerCase() === 'password' || /one-time-code/iu.test(attrs[3] || '');
37
+ const captcha = /captcha/iu.test(text) && !/passw(or)?d|secret|api.?key|\botp\b|2fa|mfa/iu.test(text);
38
+ if (explicit || !captcha && /passw(or)?d|secret|api.?key|token|one.?time|verification.?code|auth.?code|passcode|\botp\b|2fa|mfa/iu.test(text)) {
39
+ element.value = '';
40
+ element.blur();
41
+ element.dispatchEvent(new Event('input', { bubbles: true }));
42
+ element.dispatchEvent(new Event('change', { bubbles: true }));
43
+ }
44
+ }
45
+ }).catch(() => undefined);
46
+ }
47
+ export async function releasePageInput(page) {
48
+ for (const button of ['left', 'right', 'middle'])
49
+ await page.mouse.up({ button }).catch(() => undefined);
50
+ for (const key of ['Alt', 'Control', 'Meta', 'Shift'])
51
+ await page.keyboard.up(key).catch(() => undefined);
52
+ }
53
+ export async function applyPageInteraction(page, interaction, observation, human = false, onAttempt) {
54
+ if (!validBrowserInteraction(interaction))
55
+ throw new Error('invalid_browser_interaction');
56
+ for (const [x, y] of [[interaction.x, interaction.y], [interaction.toX, interaction.toY]])
57
+ if (x !== undefined && (x >= observation.width || y >= observation.height))
58
+ throw new Error('browser_interaction_outside_viewport');
59
+ if (!human && (interaction.kind === 'text' || interaction.kind === 'key'
60
+ && (!NON_TYPING_KEYS.has(interaction.key) || interaction.modifiers?.length)) && await pageHasSecretFocus(page))
61
+ throw new Error('browser_secret_input_requires_secure_reference');
62
+ onAttempt?.();
63
+ const modifiers = [...(interaction.modifiers || [])];
64
+ try {
65
+ for (const key of modifiers)
66
+ await page.keyboard.down(key);
67
+ if (interaction.kind === 'click')
68
+ await page.mouse.click(interaction.x, interaction.y, {
69
+ button: interaction.button, clickCount: interaction.clickCount
70
+ });
71
+ else if (interaction.kind === 'move')
72
+ await page.mouse.move(interaction.x, interaction.y);
73
+ else if (interaction.kind === 'drag') {
74
+ await page.mouse.move(interaction.x, interaction.y);
75
+ await page.mouse.down({ button: interaction.button });
76
+ try {
77
+ await page.mouse.move(interaction.toX, interaction.toY, { steps: 8 });
78
+ }
79
+ finally {
80
+ await page.mouse.up({ button: interaction.button }).catch(() => undefined);
81
+ }
82
+ }
83
+ else if (interaction.kind === 'scroll')
84
+ await page.mouse.wheel(interaction.deltaX ?? 0, interaction.deltaY ?? 0);
85
+ else if (interaction.kind === 'key')
86
+ await page.keyboard.press(interaction.key === 'Space' ? ' ' : interaction.key);
87
+ else
88
+ await page.keyboard.insertText(interaction.text);
89
+ }
90
+ finally {
91
+ for (const key of modifiers.reverse())
92
+ await page.keyboard.up(key).catch(() => undefined);
93
+ }
94
+ }
@@ -0,0 +1,37 @@
1
+ import { BrowserAuthProfileStore, type BrowserProfileScope } from './terminal-browser-profile.ts';
2
+ export type BrowserProfileOwner = Omit<BrowserProfileScope, 'name'>;
3
+ export type BrowserProfileChoice = {
4
+ id: string;
5
+ name: string;
6
+ persistent: boolean;
7
+ default: boolean;
8
+ };
9
+ export type BrowserProfileChoicesOptions = {
10
+ selectedName?: string;
11
+ };
12
+ /** Profile names and the default are encrypted too; a fresh installation remains ephemeral. */
13
+ export declare class BrowserProfilePreferences {
14
+ private readonly store;
15
+ constructor(store: BrowserAuthProfileStore);
16
+ private scope;
17
+ private parse;
18
+ private read;
19
+ private readAsync;
20
+ remove(owner: BrowserProfileOwner, name: string): void;
21
+ validName(name: string): string;
22
+ private resolved;
23
+ resolve(owner: BrowserProfileOwner, explicit?: string): ReturnType<BrowserProfilePreferences['resolved']>;
24
+ resolveAsync(owner: BrowserProfileOwner, explicit?: string): Promise<ReturnType<BrowserProfilePreferences['resolved']>>;
25
+ private choicesFrom;
26
+ private liveChoicesFrom;
27
+ choices(owner: BrowserProfileOwner, options?: BrowserProfileChoicesOptions): BrowserProfileChoice[];
28
+ choicesAsync(owner: BrowserProfileOwner, options?: BrowserProfileChoicesOptions): Promise<BrowserProfileChoice[]>;
29
+ allChoices(owner: BrowserProfileOwner): BrowserProfileChoice[];
30
+ allChoicesAsync(owner: BrowserProfileOwner): Promise<BrowserProfileChoice[]>;
31
+ private selectedFrom;
32
+ selected(owner: BrowserProfileOwner, name?: string): BrowserProfileChoice;
33
+ selectedAsync(owner: BrowserProfileOwner, name?: string): Promise<BrowserProfileChoice>;
34
+ private saveChoice;
35
+ remember(owner: BrowserProfileOwner, name: string | undefined, makeDefault: boolean): void;
36
+ rememberAsync(owner: BrowserProfileOwner, name: string | undefined, makeDefault: boolean): Promise<void>;
37
+ }
@@ -0,0 +1,136 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { browserProfileScopeId, validateBrowserProfileName } from "./terminal-browser-profile.js";
3
+ const INDEX_NAME = 'Revo internal profile preferences';
4
+ const MAX_LIVE_PROFILE_CHOICES = 32;
5
+ /** Profile names and the default are encrypted too; a fresh installation remains ephemeral. */
6
+ export class BrowserProfilePreferences {
7
+ store;
8
+ constructor(store) { this.store = store; }
9
+ scope(owner) { return { ...owner, name: INDEX_NAME }; }
10
+ parse(lease) {
11
+ const value = lease.state?.profileCatalog;
12
+ if (!value)
13
+ return { names: [] };
14
+ if (!Array.isArray(value.names) || value.names.length > 128 || new Set(value.names).size !== value.names.length
15
+ || value.names.some(name => !this.validName(name)) || value.defaultName !== undefined && !value.names.includes(value.defaultName))
16
+ throw new Error('browser_profile_catalog_corrupt');
17
+ return { names: [...value.names], ...(value.defaultName ? { defaultName: value.defaultName } : {}) };
18
+ }
19
+ read(owner) {
20
+ if (!this.store.has(this.scope(owner)))
21
+ return { names: [] };
22
+ const lease = this.store.open(this.scope(owner));
23
+ try {
24
+ return this.parse(lease);
25
+ }
26
+ finally {
27
+ lease.release();
28
+ }
29
+ }
30
+ async readAsync(owner) {
31
+ if (!this.store.has(this.scope(owner)))
32
+ return { names: [] };
33
+ const lease = await this.store.openAsync(this.scope(owner));
34
+ try {
35
+ return this.parse(lease);
36
+ }
37
+ finally {
38
+ lease.release();
39
+ }
40
+ }
41
+ remove(owner, name) {
42
+ this.validName(name);
43
+ if (!this.store.has(this.scope(owner)))
44
+ return;
45
+ const lease = this.store.open(this.scope(owner));
46
+ try {
47
+ const previous = this.parse(lease);
48
+ const profileCatalog = { names: previous.names.filter(value => value !== name),
49
+ ...(previous.defaultName && previous.defaultName !== name ? { defaultName: previous.defaultName } : {}) };
50
+ const state = { cookies: [], origins: [], profileCatalog };
51
+ lease.save(state);
52
+ }
53
+ finally {
54
+ lease.release();
55
+ }
56
+ }
57
+ validName(name) {
58
+ if (name === INDEX_NAME)
59
+ throw new Error('browser_profile_name_invalid');
60
+ return validateBrowserProfileName(name);
61
+ }
62
+ resolved(owner, name) {
63
+ return name ? { store: this.store, scope: { ...owner, name: this.validName(name) } } : undefined;
64
+ }
65
+ resolve(owner, explicit) {
66
+ return this.resolved(owner, explicit || this.read(owner).defaultName);
67
+ }
68
+ async resolveAsync(owner, explicit) {
69
+ return this.resolved(owner, explicit || (await this.readAsync(owner)).defaultName);
70
+ }
71
+ choicesFrom(owner, prefs, names = prefs.names) {
72
+ return [{ id: createHash('sha256').update('ephemeral:' + browserProfileScopeId(this.scope(owner))).digest('hex'),
73
+ name: 'Ephemeral', persistent: false, default: !prefs.defaultName },
74
+ ...names.map(name => ({ id: browserProfileScopeId({ ...owner, name }), name,
75
+ persistent: true, default: prefs.defaultName === name }))];
76
+ }
77
+ liveChoicesFrom(owner, prefs, options) {
78
+ const selected = options.selectedName === undefined ? undefined : this.validName(options.selectedName);
79
+ // The wire limit includes Ephemeral. Keep the selected and default profiles visible
80
+ // without truncating, rewriting or invalidating the full encrypted catalog.
81
+ const names = [...new Set([selected, prefs.defaultName, ...prefs.names].filter((name) => name !== undefined))]
82
+ .slice(0, MAX_LIVE_PROFILE_CHOICES - 1);
83
+ return this.choicesFrom(owner, prefs, names);
84
+ }
85
+ choices(owner, options = {}) {
86
+ return this.liveChoicesFrom(owner, this.read(owner), options);
87
+ }
88
+ async choicesAsync(owner, options = {}) {
89
+ return this.liveChoicesFrom(owner, await this.readAsync(owner), options);
90
+ }
91
+ allChoices(owner) { return this.choicesFrom(owner, this.read(owner)); }
92
+ async allChoicesAsync(owner) { return this.choicesFrom(owner, await this.readAsync(owner)); }
93
+ selectedFrom(owner, choices, name) {
94
+ return name ? choices.find(choice => choice.persistent && choice.name === name)
95
+ || { id: browserProfileScopeId({ ...owner, name }), name, persistent: true, default: false } : choices[0];
96
+ }
97
+ selected(owner, name) { return this.selectedFrom(owner, this.choices(owner, { selectedName: name }), name); }
98
+ async selectedAsync(owner, name) {
99
+ return this.selectedFrom(owner, await this.choicesAsync(owner, { selectedName: name }), name);
100
+ }
101
+ saveChoice(lease, name, makeDefault) {
102
+ const prefs = this.parse(lease);
103
+ if (name && !prefs.names.includes(name)) {
104
+ if (prefs.names.length >= 128)
105
+ throw new Error('browser_profile_limit');
106
+ prefs.names.push(name);
107
+ }
108
+ if (makeDefault)
109
+ prefs.defaultName = name;
110
+ const state = { cookies: [], origins: [], profileCatalog: prefs };
111
+ lease.save(state);
112
+ }
113
+ remember(owner, name, makeDefault) {
114
+ if (name)
115
+ this.validName(name);
116
+ const lease = this.store.open(this.scope(owner));
117
+ try {
118
+ this.saveChoice(lease, name, makeDefault);
119
+ }
120
+ finally {
121
+ lease.release();
122
+ }
123
+ }
124
+ async rememberAsync(owner, name, makeDefault) {
125
+ if (name)
126
+ this.validName(name);
127
+ // The writer lease covers the complete async read/modify/write; no cross-process lost updates.
128
+ const lease = await this.store.openAsync(this.scope(owner));
129
+ try {
130
+ this.saveChoice(lease, name, makeDefault);
131
+ }
132
+ finally {
133
+ lease.release();
134
+ }
135
+ }
136
+ }
@@ -0,0 +1,52 @@
1
+ import { spawn, spawnSync } from 'node:child_process';
2
+ import type { BrowserContext } from 'playwright-core';
3
+ export type BrowserProfileState = Awaited<ReturnType<BrowserContext['storageState']>>;
4
+ export type BrowserProfileScope = {
5
+ name: string;
6
+ baseUrl: string;
7
+ instanceId: string;
8
+ actorUserId: string;
9
+ terminalId: string;
10
+ workspace: string;
11
+ };
12
+ export type BrowserProfileKeyStore = {
13
+ get(account: string): Buffer | null;
14
+ create(account: string, key: Buffer): void;
15
+ remove(account: string): void;
16
+ getAsync?(account: string): Promise<Buffer | null>;
17
+ createAsync?(account: string, key: Buffer): Promise<void>;
18
+ removeAsync?(account: string): Promise<void>;
19
+ };
20
+ export declare function validateBrowserProfileName(value: string): string;
21
+ export declare function browserProfileScopeId(scope: BrowserProfileScope): string;
22
+ type KeychainExec = typeof spawnSync;
23
+ /** Password material is passed on stdin, never in process argv or a plaintext file. */
24
+ export declare function macOSBrowserProfileKeyStore(platform?: NodeJS.Platform, execute?: KeychainExec, executeAsync?: typeof spawn): BrowserProfileKeyStore;
25
+ export declare class BrowserProfileLease {
26
+ private released;
27
+ readonly state: BrowserProfileState | undefined;
28
+ private revision;
29
+ private readonly file;
30
+ private readonly scopeId;
31
+ private readonly key;
32
+ private readonly releaseLock;
33
+ private readonly assertLock;
34
+ constructor(file: string, scopeId: string, key: Buffer, releaseLock: () => void, assertLock: () => void);
35
+ private aad;
36
+ private read;
37
+ save(state: BrowserProfileState): void;
38
+ release(): void;
39
+ }
40
+ export declare class BrowserAuthProfileStore {
41
+ private directory;
42
+ private readonly keys;
43
+ constructor(directory: string, keys: BrowserProfileKeyStore);
44
+ private prepare;
45
+ private lock;
46
+ open(scope: BrowserProfileScope): BrowserProfileLease;
47
+ openAsync(scope: BrowserProfileScope): Promise<BrowserProfileLease>;
48
+ forgetAsync(scope: BrowserProfileScope): Promise<void>;
49
+ has(scope: BrowserProfileScope): boolean;
50
+ forget(scope: BrowserProfileScope): void;
51
+ }
52
+ export {};