@revoengine/cli 1.0.10 → 1.0.12

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 (104) hide show
  1. package/README.md +314 -239
  2. package/dist/src/cli.js +126 -9
  3. package/dist/src/client.d.ts +373 -6
  4. package/dist/src/client.js +1005 -53
  5. package/dist/src/commands/auth.js +4 -2
  6. package/dist/src/commands/component.d.ts +67 -0
  7. package/dist/src/commands/component.js +555 -164
  8. package/dist/src/commands/database-tables.d.ts +2 -0
  9. package/dist/src/commands/database-tables.js +169 -0
  10. package/dist/src/commands/database-views.d.ts +2 -0
  11. package/dist/src/commands/database-views.js +126 -0
  12. package/dist/src/commands/endpoints.js +124 -0
  13. package/dist/src/commands/env.js +44 -24
  14. package/dist/src/commands/events.d.ts +2 -0
  15. package/dist/src/commands/events.js +144 -0
  16. package/dist/src/commands/groups.d.ts +2 -0
  17. package/dist/src/commands/groups.js +160 -0
  18. package/dist/src/commands/index.d.ts +9 -0
  19. package/dist/src/commands/index.js +9 -0
  20. package/dist/src/commands/job-templates.d.ts +2 -0
  21. package/dist/src/commands/job-templates.js +107 -0
  22. package/dist/src/commands/metadata.js +75 -10
  23. package/dist/src/commands/migrate.d.ts +6 -0
  24. package/dist/src/commands/migrate.js +658 -0
  25. package/dist/src/commands/project.js +10 -3
  26. package/dist/src/commands/role-groups.d.ts +2 -0
  27. package/dist/src/commands/role-groups.js +141 -0
  28. package/dist/src/commands/schedules.d.ts +2 -0
  29. package/dist/src/commands/schedules.js +140 -0
  30. package/dist/src/commands/terminal-browser.d.ts +16 -0
  31. package/dist/src/commands/terminal-browser.js +92 -0
  32. package/dist/src/commands/terminal-image.d.ts +7 -0
  33. package/dist/src/commands/terminal-image.js +40 -0
  34. package/dist/src/commands/terminal-patch-worker.d.ts +1 -0
  35. package/dist/src/commands/terminal-patch-worker.js +24 -0
  36. package/dist/src/commands/terminal-patch.d.ts +2 -0
  37. package/dist/src/commands/terminal-patch.js +156 -0
  38. package/dist/src/commands/terminal-sandbox.d.ts +8 -0
  39. package/dist/src/commands/terminal-sandbox.js +87 -0
  40. package/dist/src/commands/terminal-service.d.ts +38 -0
  41. package/dist/src/commands/terminal-service.js +210 -0
  42. package/dist/src/commands/terminal.d.ts +49 -0
  43. package/dist/src/commands/terminal.js +826 -0
  44. package/dist/src/component-lock.d.ts +111 -3
  45. package/dist/src/component-lock.js +363 -15
  46. package/dist/src/config.d.ts +10 -2
  47. package/dist/src/config.js +49 -14
  48. package/dist/src/database-table-artifacts.d.ts +7 -0
  49. package/dist/src/database-table-artifacts.js +8 -0
  50. package/dist/src/diff-details.d.ts +8 -0
  51. package/dist/src/diff-details.js +152 -0
  52. package/dist/src/env-sync.d.ts +0 -3
  53. package/dist/src/env-sync.js +11 -25
  54. package/dist/src/http-trace.d.ts +94 -0
  55. package/dist/src/http-trace.js +226 -0
  56. package/dist/src/metadata-backfill.d.ts +18 -7
  57. package/dist/src/metadata-backfill.js +1002 -27
  58. package/dist/src/migration.d.ts +141 -0
  59. package/dist/src/migration.js +1632 -0
  60. package/dist/src/project.d.ts +2 -0
  61. package/dist/src/project.js +4 -17
  62. package/dist/src/prompt.js +10 -18
  63. package/dist/src/resource-inventory.d.ts +28 -0
  64. package/dist/src/resource-inventory.js +85 -0
  65. package/dist/src/resource-metadata.d.ts +1 -0
  66. package/dist/src/resource-metadata.js +3 -0
  67. package/dist/src/resource-syncs/database-table-sync.d.ts +127 -0
  68. package/dist/src/resource-syncs/database-table-sync.js +2374 -0
  69. package/dist/src/resource-syncs/database-view-sync.d.ts +146 -0
  70. package/dist/src/resource-syncs/database-view-sync.js +1405 -0
  71. package/dist/src/resource-syncs/endpoint-sync.d.ts +123 -0
  72. package/dist/src/resource-syncs/endpoint-sync.js +1563 -0
  73. package/dist/src/resource-syncs/event-sync.d.ts +126 -0
  74. package/dist/src/resource-syncs/event-sync.js +1046 -0
  75. package/dist/src/resource-syncs/group-sync.d.ts +93 -0
  76. package/dist/src/resource-syncs/group-sync.js +928 -0
  77. package/dist/src/resource-syncs/job-template-sync.d.ts +106 -0
  78. package/dist/src/resource-syncs/job-template-sync.js +843 -0
  79. package/dist/src/resource-syncs/role-group-sync.d.ts +90 -0
  80. package/dist/src/resource-syncs/role-group-sync.js +635 -0
  81. package/dist/src/resource-syncs/schedule-sync.d.ts +140 -0
  82. package/dist/src/resource-syncs/schedule-sync.js +1396 -0
  83. package/dist/src/resource-syncs/util.d.ts +22 -0
  84. package/dist/src/resource-syncs/util.js +118 -0
  85. package/dist/src/resource-target.d.ts +11 -0
  86. package/dist/src/resource-target.js +48 -0
  87. package/dist/src/runtime-view.d.ts +1 -0
  88. package/dist/src/runtime-view.js +6 -1
  89. package/dist/src/sync-output.d.ts +66 -0
  90. package/dist/src/sync-output.js +268 -0
  91. package/dist/src/tracked-resources.d.ts +1 -1
  92. package/dist/src/tracked-resources.js +28 -2
  93. package/dist/src/types.d.ts +227 -0
  94. package/dist/src/ui.d.ts +3 -0
  95. package/dist/src/ui.js +76 -18
  96. package/dist/src/utils.d.ts +4 -0
  97. package/dist/src/utils.js +81 -0
  98. package/dist/src/workspace-component.d.ts +2 -0
  99. package/dist/src/workspace-component.js +34 -0
  100. package/dist/src/workspace-diff.d.ts +25 -0
  101. package/dist/src/workspace-diff.js +75 -0
  102. package/dist/src/workspace-resource.d.ts +2 -0
  103. package/dist/src/workspace-resource.js +52 -0
  104. package/package.json +12 -4
@@ -0,0 +1,226 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { AsyncLocalStorage } from 'node:async_hooks';
4
+ import { REVO_PROJECT_DIR } from "./project.js";
5
+ import { writeJsonFile } from "./utils.js";
6
+ const HTTP_TRACE_DIRECTORY = path.join(REVO_PROJECT_DIR, 'logs', 'http-trace');
7
+ const SAFE_PATH_SEGMENTS = new Set([
8
+ 'api', 'v1', 'activity', 'automation', 'event', 'schedule', 'template',
9
+ 'component', 'databases', 'stats', 'views', 'preview', 'endpoints',
10
+ 'groups', 'me', 'role-groups', 'roles', 'search',
11
+ ]);
12
+ const SAFE_ERROR_NAMES = new Set(['Error', 'TypeError', 'SyntaxError', 'AbortError', 'TimeoutError']);
13
+ const SAFE_HTTP_METHODS = new Set(['GET', 'HEAD', 'OPTIONS', 'POST', 'PUT', 'PATCH', 'DELETE']);
14
+ const SAFE_TRACE_COMMANDS = new Set([
15
+ 'auth', 'component', 'database-tables', 'database-views', 'deploy', 'diff',
16
+ 'endpoints', 'env', 'events', 'groups', 'help', 'info', 'job-templates',
17
+ 'metadata', 'migrate', 'plan', 'project', 'pull', 'request', 'role-groups',
18
+ 'schedules', 'search', 'version', 'overview',
19
+ ]);
20
+ const traceStorage = new AsyncLocalStorage();
21
+ function traceFileName(startedAt, suffix = 1) {
22
+ const timestamp = startedAt.toISOString().replace(/[:.]/g, '-');
23
+ return suffix === 1 ? `${timestamp}.json` : `${timestamp}-${suffix}.json`;
24
+ }
25
+ function reserveTraceFile(projectRoot, startedAt) {
26
+ const directory = path.join(projectRoot, HTTP_TRACE_DIRECTORY);
27
+ fs.mkdirSync(directory, { recursive: true });
28
+ for (let suffix = 1;; suffix += 1) {
29
+ const filePath = path.join(directory, traceFileName(startedAt, suffix));
30
+ try {
31
+ fs.closeSync(fs.openSync(filePath, 'wx', 0o600));
32
+ return filePath;
33
+ }
34
+ catch (error) {
35
+ if (error.code !== 'EEXIST') {
36
+ throw error;
37
+ }
38
+ }
39
+ }
40
+ }
41
+ export function createHttpTraceSession(projectRoot, metadata) {
42
+ const startedAt = new Date();
43
+ return {
44
+ projectRoot,
45
+ filePath: reserveTraceFile(projectRoot, startedAt),
46
+ startedAt: startedAt.toISOString(),
47
+ startedAtMs: startedAt.getTime(),
48
+ metadata: {
49
+ command: SAFE_TRACE_COMMANDS.has(metadata.command) ? metadata.command : 'unknown',
50
+ ...(metadata.dryRun === true ? { dryRun: true } : {}),
51
+ },
52
+ requests: [],
53
+ nextSequence: 1,
54
+ activeRequests: new Map(),
55
+ idleWaiters: new Set(),
56
+ };
57
+ }
58
+ export function withHttpTraceSession(session, operation) {
59
+ return traceStorage.run({ session, context: {} }, operation);
60
+ }
61
+ export function withHttpTraceContext(context, operation) {
62
+ const active = traceStorage.getStore();
63
+ if (!active) {
64
+ return operation();
65
+ }
66
+ return traceStorage.run({
67
+ session: active.session,
68
+ context: { ...active.context, ...context },
69
+ }, operation);
70
+ }
71
+ function safeRequestPath(url) {
72
+ return url.pathname.split('/').map((segment) => (segment === '' || SAFE_PATH_SEGMENTS.has(segment) ? segment : '[REDACTED]')).join('/');
73
+ }
74
+ function summarizeRequestBody(body) {
75
+ if (body === undefined || body === null) {
76
+ return undefined;
77
+ }
78
+ return {
79
+ bytes: Buffer.byteLength(typeof body === 'string' ? body : String(body)),
80
+ };
81
+ }
82
+ function sanitizedError(error) {
83
+ const name = error instanceof Error ? error.name : 'Error';
84
+ return {
85
+ name: SAFE_ERROR_NAMES.has(name) ? name : 'Error',
86
+ };
87
+ }
88
+ export function beginHttpTraceRequest(input) {
89
+ const active = traceStorage.getStore();
90
+ if (!active) {
91
+ return undefined;
92
+ }
93
+ const requestPath = safeRequestPath(input.url);
94
+ const sequence = active.session.nextSequence;
95
+ active.session.nextSequence += 1;
96
+ const startedAtMs = Date.now();
97
+ const requestBody = summarizeRequestBody(input.body);
98
+ const handle = {
99
+ session: active.session,
100
+ sequence,
101
+ startedAt: new Date(startedAtMs).toISOString(),
102
+ startedAtMs,
103
+ method: SAFE_HTTP_METHODS.has(input.method.toUpperCase()) ? input.method.toUpperCase() : 'UNKNOWN',
104
+ path: requestPath,
105
+ context: {
106
+ stage: input.context?.stage ?? active.context.stage,
107
+ resource: input.context?.resource ?? active.context.resource,
108
+ dependency: input.context?.dependency ?? active.context.dependency,
109
+ operation: input.context?.operation ?? active.context.operation,
110
+ },
111
+ completed: false,
112
+ ...(requestBody ? { requestBody } : {}),
113
+ };
114
+ active.session.activeRequests.set(sequence, handle);
115
+ return handle;
116
+ }
117
+ export function completeHttpTraceRequest(handle, completion) {
118
+ if (!handle || handle.completed) {
119
+ return;
120
+ }
121
+ handle.completed = true;
122
+ handle.session.activeRequests.delete(handle.sequence);
123
+ const finishedAtMs = Date.now();
124
+ handle.session.requests.push({
125
+ sequence: handle.sequence,
126
+ startedAt: handle.startedAt,
127
+ finishedAt: new Date(finishedAtMs).toISOString(),
128
+ durationMs: Math.max(0, finishedAtMs - handle.startedAtMs),
129
+ method: handle.method,
130
+ path: handle.path,
131
+ ...handle.context,
132
+ ok: completion.ok,
133
+ ...(completion.status === undefined ? {} : { status: completion.status }),
134
+ ...(handle.requestBody ? { requestBody: handle.requestBody } : {}),
135
+ ...(completion.responseBytes === undefined ? {} : { responseBytes: completion.responseBytes }),
136
+ ...(completion.error ? { error: sanitizedError(completion.error) } : {}),
137
+ });
138
+ if (handle.session.activeRequests.size === 0) {
139
+ for (const resolve of handle.session.idleWaiters) {
140
+ resolve();
141
+ }
142
+ handle.session.idleWaiters.clear();
143
+ }
144
+ }
145
+ export function responseSize(data, headers) {
146
+ const contentLength = headers?.get('content-length');
147
+ if (contentLength && /^\d+$/.test(contentLength)) {
148
+ return Number(contentLength);
149
+ }
150
+ if (data === undefined || data === null) {
151
+ return 0;
152
+ }
153
+ const serialized = typeof data === 'string' ? data : JSON.stringify(data);
154
+ return Buffer.byteLength(serialized);
155
+ }
156
+ function waitForImmediate() {
157
+ return new Promise((resolve) => setImmediate(resolve));
158
+ }
159
+ function waitUntilIdleOrTimeout(session, timeoutMs) {
160
+ return new Promise((resolve) => {
161
+ let timeout;
162
+ const onIdle = () => {
163
+ clearTimeout(timeout);
164
+ session.idleWaiters.delete(onIdle);
165
+ resolve();
166
+ };
167
+ timeout = setTimeout(() => {
168
+ session.idleWaiters.delete(onIdle);
169
+ resolve();
170
+ }, timeoutMs);
171
+ session.idleWaiters.add(onIdle);
172
+ if (session.activeRequests.size === 0) {
173
+ onIdle();
174
+ }
175
+ });
176
+ }
177
+ async function waitForActiveRequests(session) {
178
+ const deadline = Date.now() + 5_000;
179
+ while (Date.now() < deadline) {
180
+ if (session.activeRequests.size > 0) {
181
+ const remaining = deadline - Date.now();
182
+ await waitUntilIdleOrTimeout(session, remaining);
183
+ }
184
+ await waitForImmediate();
185
+ if (session.activeRequests.size === 0) {
186
+ await waitForImmediate();
187
+ if (session.activeRequests.size === 0) {
188
+ return;
189
+ }
190
+ }
191
+ }
192
+ }
193
+ function recordIncompleteRequests(session) {
194
+ for (const handle of session.activeRequests.values()) {
195
+ completeHttpTraceRequest(handle, {
196
+ ok: false,
197
+ error: new Error('Request was still in flight when the CLI invocation finished.'),
198
+ });
199
+ }
200
+ }
201
+ export async function finalizeHttpTraceSession(session, status, error) {
202
+ await waitForActiveRequests(session);
203
+ recordIncompleteRequests(session);
204
+ const finishedAtMs = Date.now();
205
+ const requests = [...session.requests].sort((left, right) => left.sequence - right.sequence);
206
+ const successful = requests.filter((request) => request.ok).length;
207
+ writeJsonFile(session.filePath, {
208
+ schemaVersion: 1,
209
+ run: {
210
+ ...session.metadata,
211
+ startedAt: session.startedAt,
212
+ finishedAt: new Date(finishedAtMs).toISOString(),
213
+ durationMs: Math.max(0, finishedAtMs - session.startedAtMs),
214
+ status,
215
+ ...(error ? { error: sanitizedError(error) } : {}),
216
+ },
217
+ summary: {
218
+ requests: requests.length,
219
+ successful,
220
+ failed: requests.length - successful,
221
+ },
222
+ requests,
223
+ });
224
+ return session.filePath;
225
+ }
226
+ export { HTTP_TRACE_DIRECTORY };
@@ -1,16 +1,21 @@
1
+ import { type ResourceRecord as MetadataResourceRecord } from './resource-inventory.ts';
1
2
  import type { RevoClient } from './client.ts';
2
- import { type TrackedResource } from './tracked-resources.ts';
3
- import type { ComponentRecord } from './types.ts';
4
- export type MetadataBackfillAction = 'update' | 'skip' | 'failed';
3
+ import { type TrackableResourceType, type TrackedResource } from './tracked-resources.ts';
4
+ export type MetadataBackfillAction = 'update' | 'skip' | 'blocked' | 'failed';
5
+ type MetadataBackfillResourceType = TrackableResourceType;
5
6
  export type MetadataBackfillPlanItem = {
6
- resourceType: 'component';
7
+ resourceType: MetadataBackfillResourceType;
8
+ resourceKind?: 'resource' | 'database-partition' | 'database-column';
7
9
  resourceId: string;
8
10
  name: string;
9
11
  category: string | null;
12
+ parentName?: string;
10
13
  action: Exclude<MetadataBackfillAction, 'failed'>;
11
- metadataField: 'metadata';
14
+ metadataField: 'metadata' | 'definition[].metadata';
12
15
  stableKeyName: string;
13
16
  stableKey?: string;
17
+ columnName?: string;
18
+ columnDefinitionId?: string;
14
19
  reason: string;
15
20
  };
16
21
  export type MetadataBackfillPlan = {
@@ -21,26 +26,32 @@ export type MetadataBackfillPlan = {
21
26
  instance: string;
22
27
  stableKeyName: string;
23
28
  trackedResources: TrackedResource[];
29
+ force: boolean;
30
+ skipPartitions?: boolean;
24
31
  counts: Record<Exclude<MetadataBackfillAction, 'failed'>, number>;
32
+ blockers: string[];
25
33
  items: MetadataBackfillPlanItem[];
26
34
  };
27
35
  export type MetadataBackfillResult = {
28
- resourceType: 'component';
36
+ resourceType: MetadataBackfillResourceType;
29
37
  resourceId: string;
30
38
  stableKey?: string;
39
+ columnName?: string;
31
40
  action: MetadataBackfillAction;
32
41
  error?: string;
33
42
  };
34
43
  export declare function generateStableKeySuffix(bytes?: number): string;
35
- export declare function buildGeneratedStableKey(component: ComponentRecord): string;
44
+ export declare function buildGeneratedStableKey(resource: MetadataResourceRecord): string;
36
45
  export declare function buildMetadataBackfillPlan(input: {
37
46
  client: RevoClient;
38
47
  envName: string;
39
48
  stableKeyName: string;
40
49
  trackedResources: TrackedResource[];
41
50
  force?: boolean;
51
+ skipPartitions?: boolean;
42
52
  }): Promise<MetadataBackfillPlan>;
43
53
  export declare function applyMetadataBackfillPlan(input: {
44
54
  client: RevoClient;
45
55
  plan: MetadataBackfillPlan;
46
56
  }): Promise<MetadataBackfillResult[]>;
57
+ export {};