@kelviq/cli 0.1.1
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.
- package/README.md +313 -0
- package/dist/cli-ui/auth-hint.d.ts +6 -0
- package/dist/cli-ui/auth-hint.js +34 -0
- package/dist/cli-ui/auth-hint.js.map +1 -0
- package/dist/cli-ui/hints.d.ts +5 -0
- package/dist/cli-ui/hints.js +19 -0
- package/dist/cli-ui/hints.js.map +1 -0
- package/dist/cli-ui/spinner.d.ts +7 -0
- package/dist/cli-ui/spinner.js +61 -0
- package/dist/cli-ui/spinner.js.map +1 -0
- package/dist/cli-ui/style.d.ts +47 -0
- package/dist/cli-ui/style.js +71 -0
- package/dist/cli-ui/style.js.map +1 -0
- package/dist/cli-ui/tty.d.ts +1 -0
- package/dist/cli-ui/tty.js +13 -0
- package/dist/cli-ui/tty.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +51 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/env.d.ts +34 -0
- package/dist/commands/env.js +52 -0
- package/dist/commands/env.js.map +1 -0
- package/dist/commands/init.d.ts +15 -0
- package/dist/commands/init.js +70 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/login.d.ts +22 -0
- package/dist/commands/login.js +205 -0
- package/dist/commands/login.js.map +1 -0
- package/dist/commands/logout.d.ts +13 -0
- package/dist/commands/logout.js +39 -0
- package/dist/commands/logout.js.map +1 -0
- package/dist/commands/promote.d.ts +42 -0
- package/dist/commands/promote.js +243 -0
- package/dist/commands/promote.js.map +1 -0
- package/dist/commands/pull.d.ts +31 -0
- package/dist/commands/pull.js +108 -0
- package/dist/commands/pull.js.map +1 -0
- package/dist/commands/push-shared.d.ts +97 -0
- package/dist/commands/push-shared.js +283 -0
- package/dist/commands/push-shared.js.map +1 -0
- package/dist/commands/push.d.ts +42 -0
- package/dist/commands/push.js +268 -0
- package/dist/commands/push.js.map +1 -0
- package/dist/config-format/builders.d.ts +10 -0
- package/dist/config-format/builders.js +46 -0
- package/dist/config-format/builders.js.map +1 -0
- package/dist/config-format/index.d.ts +4 -0
- package/dist/config-format/index.js +9 -0
- package/dist/config-format/index.js.map +1 -0
- package/dist/config-format/load.d.ts +23 -0
- package/dist/config-format/load.js +82 -0
- package/dist/config-format/load.js.map +1 -0
- package/dist/config-format/schema.d.ts +423 -0
- package/dist/config-format/schema.js +105 -0
- package/dist/config-format/schema.js.map +1 -0
- package/dist/core/config.d.ts +48 -0
- package/dist/core/config.js +128 -0
- package/dist/core/config.js.map +1 -0
- package/dist/core/errors.d.ts +20 -0
- package/dist/core/errors.js +58 -0
- package/dist/core/errors.js.map +1 -0
- package/dist/core/http.d.ts +39 -0
- package/dist/core/http.js +104 -0
- package/dist/core/http.js.map +1 -0
- package/dist/core/version.d.ts +1 -0
- package/dist/core/version.js +14 -0
- package/dist/core/version.js.map +1 -0
- package/dist/generated/openapi.json +6635 -0
- package/dist/sync/apply.d.ts +38 -0
- package/dist/sync/apply.js +234 -0
- package/dist/sync/apply.js.map +1 -0
- package/dist/sync/diff.d.ts +186 -0
- package/dist/sync/diff.js +402 -0
- package/dist/sync/diff.js.map +1 -0
- package/dist/sync/fetch-catalog.d.ts +105 -0
- package/dist/sync/fetch-catalog.js +100 -0
- package/dist/sync/fetch-catalog.js.map +1 -0
- package/dist/sync/price-filter.d.ts +37 -0
- package/dist/sync/price-filter.js +195 -0
- package/dist/sync/price-filter.js.map +1 -0
- package/dist/sync/prune.d.ts +77 -0
- package/dist/sync/prune.js +112 -0
- package/dist/sync/prune.js.map +1 -0
- package/dist/sync/publish.d.ts +75 -0
- package/dist/sync/publish.js +126 -0
- package/dist/sync/publish.js.map +1 -0
- package/dist/sync/push-plan-json.d.ts +79 -0
- package/dist/sync/push-plan-json.js +70 -0
- package/dist/sync/push-plan-json.js.map +1 -0
- package/dist/sync/render-plan.d.ts +83 -0
- package/dist/sync/render-plan.js +358 -0
- package/dist/sync/render-plan.js.map +1 -0
- package/dist/sync/serialize.d.ts +18 -0
- package/dist/sync/serialize.js +108 -0
- package/dist/sync/serialize.js.map +1 -0
- package/dist/sync/to-config.d.ts +9 -0
- package/dist/sync/to-config.js +191 -0
- package/dist/sync/to-config.js.map +1 -0
- package/package.json +68 -0
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
import { authHintLine, messageCarriesAuthStatus } from '../cli-ui/auth-hint.js';
|
|
2
|
+
import { createSpinner } from '../cli-ui/spinner.js';
|
|
3
|
+
import { loadCliConfig, resolveEnv } from '../core/config.js';
|
|
4
|
+
import { KelviqHttpClient } from '../core/http.js';
|
|
5
|
+
import { applyPushPlan } from '../sync/apply.js';
|
|
6
|
+
import { buildPushPlan } from '../sync/diff.js';
|
|
7
|
+
import { fetchCatalog } from '../sync/fetch-catalog.js';
|
|
8
|
+
import { toConfigDefs } from '../sync/to-config.js';
|
|
9
|
+
import { isPushPlanEmpty, plural, renderPushPlan } from '../sync/render-plan.js';
|
|
10
|
+
import { publishRequestBody, publishSetFromPushPlan, validatePublishFlags } from '../sync/publish.js';
|
|
11
|
+
import { buildPushJsonDocument, buildPushJsonErrorDocument, validateJsonFlags, writeJsonDocument } from '../sync/push-plan-json.js';
|
|
12
|
+
import { computePrunePlan, pruneArchiveCount } from '../sync/prune.js';
|
|
13
|
+
import { closePrompt, confirm, featureDriftAbortLines, gateProdPrune, renderApplyReport, renderFeatureDriftAbort, runPublishStep, runPruneStep, } from './push-shared.js';
|
|
14
|
+
/** §10: "The renderer's environment label must make the direction unmistakable." */
|
|
15
|
+
const PROMOTE_ENV_LABEL = 'promote: sandbox → production';
|
|
16
|
+
/** The publish step always targets production for promote — never the composite direction label (publish only ever acts on what was just written to the target). */
|
|
17
|
+
const PUBLISH_ENV_LABEL = 'production';
|
|
18
|
+
/**
|
|
19
|
+
* Runs the full promote flow described in the module comment. Every
|
|
20
|
+
* failure — a missing key for either environment, a fetch failure —
|
|
21
|
+
* normalizes to a single `promote failed: <message>` line on stderr, same
|
|
22
|
+
* contract as push.ts/pull.ts. Feature-drift/error aborts, the dry-run stop,
|
|
23
|
+
* the empty-plan short-circuit, and the non-TTY-without-`--yes` refusal are
|
|
24
|
+
* NOT that catch block — they're expected, documented exits with their own
|
|
25
|
+
* messages.
|
|
26
|
+
*
|
|
27
|
+
* Reads no config file and writes none — `desired` is the freshly fetched
|
|
28
|
+
* SANDBOX catalog translated in-memory via `toConfigDefs`, never
|
|
29
|
+
* `loadConfigFile`.
|
|
30
|
+
*/
|
|
31
|
+
export async function runPromote(options, io) {
|
|
32
|
+
const write = (s) => io.stdout.write(s);
|
|
33
|
+
const writeErr = (s) => io.stderr.write(s);
|
|
34
|
+
// CLI plan 015: --json is checked alongside the other pre-I/O flag gates —
|
|
35
|
+
// it never mixes with prompts/writes, so a misuse (--json without
|
|
36
|
+
// --dry-run) is refused before either environment is even resolved.
|
|
37
|
+
const jsonFlagError = validateJsonFlags(options);
|
|
38
|
+
if (jsonFlagError) {
|
|
39
|
+
writeErr(`${jsonFlagError}\n`);
|
|
40
|
+
return 1;
|
|
41
|
+
}
|
|
42
|
+
const flagError = validatePublishFlags(options);
|
|
43
|
+
if (flagError) {
|
|
44
|
+
writeErr(`${flagError}\n`);
|
|
45
|
+
return 1;
|
|
46
|
+
}
|
|
47
|
+
try {
|
|
48
|
+
const cliConfig = loadCliConfig(io.env ?? process.env, io.configDir);
|
|
49
|
+
// §10: promote needs BOTH keys — sandbox to read, production to write.
|
|
50
|
+
// resolveEnv throws its standard MissingKeyError (naming the env var)
|
|
51
|
+
// for whichever is missing; sandbox is checked first since it's the
|
|
52
|
+
// source read that happens first.
|
|
53
|
+
const sandboxEnv = resolveEnv(cliConfig, false);
|
|
54
|
+
const prodEnv = resolveEnv(cliConfig, true);
|
|
55
|
+
const sandboxHttp = new KelviqHttpClient({
|
|
56
|
+
serverApiKey: sandboxEnv.key,
|
|
57
|
+
baseUrl: sandboxEnv.baseUrl,
|
|
58
|
+
edgeUrl: cliConfig.edgeUrl,
|
|
59
|
+
userAgent: cliConfig.userAgent,
|
|
60
|
+
});
|
|
61
|
+
const prodHttp = new KelviqHttpClient({
|
|
62
|
+
serverApiKey: prodEnv.key,
|
|
63
|
+
baseUrl: prodEnv.baseUrl,
|
|
64
|
+
edgeUrl: cliConfig.edgeUrl,
|
|
65
|
+
userAgent: cliConfig.userAgent,
|
|
66
|
+
});
|
|
67
|
+
let sandboxRaw;
|
|
68
|
+
if (options.json) {
|
|
69
|
+
// CLI plan 015: JSON mode forces the spinner off entirely (not just
|
|
70
|
+
// its animated frames) — stderr carries nothing but a fatal error.
|
|
71
|
+
sandboxRaw = await fetchCatalog(sandboxHttp);
|
|
72
|
+
}
|
|
73
|
+
else {
|
|
74
|
+
const sandboxSpinner = createSpinner(io.stderr);
|
|
75
|
+
sandboxSpinner.start('Fetching sandbox catalog...');
|
|
76
|
+
try {
|
|
77
|
+
sandboxRaw = await fetchCatalog(sandboxHttp);
|
|
78
|
+
}
|
|
79
|
+
catch (err) {
|
|
80
|
+
// No `.fail(...)` message: the catch block below already normalizes
|
|
81
|
+
// every failure to exactly one `promote failed: ...` line.
|
|
82
|
+
sandboxSpinner.stop();
|
|
83
|
+
throw err;
|
|
84
|
+
}
|
|
85
|
+
sandboxSpinner.succeed(`Fetched sandbox catalog (${plural(sandboxRaw.products.length, 'product')}, ${plural(sandboxRaw.features.length, 'feature')}, ${plural(sandboxRaw.plans.length, 'plan')})`);
|
|
86
|
+
}
|
|
87
|
+
const { products, features, plans, warnings: desiredWarnings } = toConfigDefs(sandboxRaw);
|
|
88
|
+
// CLI plan 015: JSON mode keeps stderr free of non-fatal narrative — these
|
|
89
|
+
// translation warnings aren't part of the `--json` contract (only
|
|
90
|
+
// `PushPlan.warnings` is; see push-plan-json.ts's module comment).
|
|
91
|
+
if (!options.json) {
|
|
92
|
+
for (const w of desiredWarnings)
|
|
93
|
+
writeErr(`warning: ${w}\n`);
|
|
94
|
+
}
|
|
95
|
+
const desired = { products, features, plans };
|
|
96
|
+
let prodRaw;
|
|
97
|
+
if (options.json) {
|
|
98
|
+
prodRaw = await fetchCatalog(prodHttp);
|
|
99
|
+
}
|
|
100
|
+
else {
|
|
101
|
+
const prodSpinner = createSpinner(io.stderr);
|
|
102
|
+
prodSpinner.start('Fetching production catalog...');
|
|
103
|
+
try {
|
|
104
|
+
prodRaw = await fetchCatalog(prodHttp);
|
|
105
|
+
}
|
|
106
|
+
catch (err) {
|
|
107
|
+
prodSpinner.stop();
|
|
108
|
+
throw err;
|
|
109
|
+
}
|
|
110
|
+
prodSpinner.succeed(`Fetched production catalog (${plural(prodRaw.products.length, 'product')}, ${plural(prodRaw.features.length, 'feature')}, ${plural(prodRaw.plans.length, 'plan')})`);
|
|
111
|
+
}
|
|
112
|
+
const plan = buildPushPlan(desired, prodRaw);
|
|
113
|
+
// DESIGN-push.md §3 (via §10, unchanged): feature drift is a hard error
|
|
114
|
+
// — same abort message push.ts uses, verbatim (push-shared.ts is the
|
|
115
|
+
// single source so the two commands can't drift in wording).
|
|
116
|
+
if (plan.featureDrift.length > 0 || plan.errors.length > 0) {
|
|
117
|
+
if (options.json) {
|
|
118
|
+
writeJsonDocument(io.stdout, buildPushJsonErrorDocument(featureDriftAbortLines(plan).join('\n'), plan.featureDrift));
|
|
119
|
+
}
|
|
120
|
+
else {
|
|
121
|
+
for (const line of renderFeatureDriftAbort(plan))
|
|
122
|
+
writeErr(`${line}\n`);
|
|
123
|
+
}
|
|
124
|
+
return 1;
|
|
125
|
+
}
|
|
126
|
+
// CLI plan 010: computed unconditionally (pure, cheap — no HTTP), same
|
|
127
|
+
// as push.ts.
|
|
128
|
+
const prunePlan = computePrunePlan(plan, prodRaw);
|
|
129
|
+
// Only rendered for an ACTUAL dry run — see push.ts's identical comment
|
|
130
|
+
// (same fix, same reason, caught live 2026-07-21).
|
|
131
|
+
const publishPreview = options.publish && options.dryRun
|
|
132
|
+
? { planIdentifiers: publishSetFromPushPlan(plan), ...publishRequestBody(options) }
|
|
133
|
+
: undefined;
|
|
134
|
+
const prunePreview = options.prune
|
|
135
|
+
? {
|
|
136
|
+
archivePlans: prunePlan.archive.plans.map((op) => op.identifier),
|
|
137
|
+
archiveFeatures: prunePlan.archive.features.map((op) => op.identifier),
|
|
138
|
+
skippedPlans: prunePlan.skipped.plans,
|
|
139
|
+
skippedFeatures: prunePlan.skipped.features,
|
|
140
|
+
}
|
|
141
|
+
: undefined;
|
|
142
|
+
if (options.json) {
|
|
143
|
+
// `--json` implies `--dry-run` (validated above) — render the public
|
|
144
|
+
// contract document and stop; never reaches confirm/apply/publish/
|
|
145
|
+
// prune below (json never mixes with prompts/writes). `direction` is
|
|
146
|
+
// always `promote` here — the composite "sandbox → production" label
|
|
147
|
+
// is a text-render-only concern (`PROMOTE_ENV_LABEL`); the JSON
|
|
148
|
+
// contract's `environment` field is always the target, `production`.
|
|
149
|
+
writeJsonDocument(io.stdout, buildPushJsonDocument({
|
|
150
|
+
envName: 'production',
|
|
151
|
+
direction: 'promote',
|
|
152
|
+
plan,
|
|
153
|
+
prunePlan,
|
|
154
|
+
prunePassed: Boolean(options.prune),
|
|
155
|
+
publishPreview,
|
|
156
|
+
}));
|
|
157
|
+
return 0;
|
|
158
|
+
}
|
|
159
|
+
write('\n' +
|
|
160
|
+
renderPushPlan(plan, { envName: PROMOTE_ENV_LABEL, directional: true, verbose: options.verbose, publishPreview, prune: prunePreview }) +
|
|
161
|
+
'\n');
|
|
162
|
+
if (options.dryRun) {
|
|
163
|
+
return 0;
|
|
164
|
+
}
|
|
165
|
+
const archiveCount = options.prune ? pruneArchiveCount(prunePlan) : 0;
|
|
166
|
+
if (isPushPlanEmpty(plan) && archiveCount === 0) {
|
|
167
|
+
return 0;
|
|
168
|
+
}
|
|
169
|
+
// CLI plan 010: promote always targets production, so `--prune` always
|
|
170
|
+
// crosses this gate (per DESIGN-push.md §5's note, quoted in this
|
|
171
|
+
// module's own header comment) — checked first, before the general
|
|
172
|
+
// confirmation, and never satisfied by `--yes` alone.
|
|
173
|
+
const prodGate = await gateProdPrune(true, archiveCount, options, io);
|
|
174
|
+
if (!prodGate.ok)
|
|
175
|
+
return 1;
|
|
176
|
+
if (!options.yes) {
|
|
177
|
+
if (!io.isTTY) {
|
|
178
|
+
writeErr('Refusing to apply changes without confirmation in a non-interactive session. Pass --yes to proceed.\n');
|
|
179
|
+
return 1;
|
|
180
|
+
}
|
|
181
|
+
const archiveSuffix = archiveCount > 0 ? ` (including ${archiveCount} archive${archiveCount === 1 ? '' : 's'})` : '';
|
|
182
|
+
const confirmed = await confirm(`\nApply these changes to ${PUBLISH_ENV_LABEL}${archiveSuffix}? [y/N] `, io);
|
|
183
|
+
if (!confirmed) {
|
|
184
|
+
write('Aborted; no changes were made.\n');
|
|
185
|
+
return 1;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
write('\n');
|
|
189
|
+
const result = await applyPushPlan(prodHttp, plan, { stdout: io.stdout });
|
|
190
|
+
write('\n' + renderApplyReport(result) + '\n');
|
|
191
|
+
if (!result.ok)
|
|
192
|
+
return 1;
|
|
193
|
+
const publishOutcome = await runPublishStep(prodHttp, result, options, PUBLISH_ENV_LABEL, io);
|
|
194
|
+
if (!publishOutcome.ok)
|
|
195
|
+
return 1;
|
|
196
|
+
// CLI plan 010: prune runs strictly LAST — after publish — against
|
|
197
|
+
// PRODUCTION (`prodHttp`), same ordering/gating contract as push.ts.
|
|
198
|
+
const pruneOutcome = await runPruneStep(prodHttp, prunePlan, options.prune, io);
|
|
199
|
+
return pruneOutcome.ok ? 0 : 1;
|
|
200
|
+
}
|
|
201
|
+
catch (err) {
|
|
202
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
203
|
+
const fullMessage = `promote failed: ${message}`;
|
|
204
|
+
if (options.json) {
|
|
205
|
+
writeJsonDocument(io.stdout, buildPushJsonErrorDocument(fullMessage));
|
|
206
|
+
}
|
|
207
|
+
else {
|
|
208
|
+
writeErr(`${fullMessage}\n`);
|
|
209
|
+
if (messageCarriesAuthStatus(message))
|
|
210
|
+
writeErr(`${authHintLine()}\n`);
|
|
211
|
+
}
|
|
212
|
+
return 1;
|
|
213
|
+
}
|
|
214
|
+
finally {
|
|
215
|
+
// Releases the shared readline interface (see push-shared.ts's
|
|
216
|
+
// `promptStreams`) if one was ever created this run.
|
|
217
|
+
closePrompt(io);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
export function registerPromoteCommand(program) {
|
|
221
|
+
program
|
|
222
|
+
.command('promote')
|
|
223
|
+
.description('Move sandbox changes to production: diff sandbox against prod, confirm, and apply drafts-only writes. Reads/writes no local config file.')
|
|
224
|
+
.option('--dry-run', 'Print the plan-of-record diff and exit without writing anything', false)
|
|
225
|
+
.option('--yes', 'Skip the interactive confirmation prompt(s) (required in non-interactive sessions)', false)
|
|
226
|
+
.option('--publish', 'Publish plans this run created, updated, or price-replaced (drafts otherwise) — requires its own confirmation', false)
|
|
227
|
+
.option('--migrate-features', 'With --publish: migrate existing customers to the published plan\'s feature entitlements', false)
|
|
228
|
+
.option('--migrate-pricing', 'With --publish: migrate existing customers to the published plan\'s pricing', false)
|
|
229
|
+
.option('--prune', 'Archive remote-only plans/features in production that carry the kelviq-cli managed-by marker (never products; runs after publish)', false)
|
|
230
|
+
.option('--allow-prod-prune', 'Required (in place of the interactive typed confirmation) to --prune in a non-interactive session — promote always targets production', false)
|
|
231
|
+
.option('--verbose', 'List every individual dropped price field instead of the aggregated per-plan summary', false)
|
|
232
|
+
.option('--json', 'Machine-readable output (the public --dry-run --json contract) — valid only together with --dry-run', false)
|
|
233
|
+
.action(async (opts) => {
|
|
234
|
+
const exitCode = await runPromote(opts, {
|
|
235
|
+
stdin: process.stdin,
|
|
236
|
+
stdout: process.stdout,
|
|
237
|
+
stderr: process.stderr,
|
|
238
|
+
isTTY: Boolean(process.stdin.isTTY),
|
|
239
|
+
});
|
|
240
|
+
process.exitCode = exitCode;
|
|
241
|
+
});
|
|
242
|
+
}
|
|
243
|
+
//# sourceMappingURL=promote.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../src/commands/promote.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { Command } from 'commander';
|
|
2
|
+
export interface PullOptions {
|
|
3
|
+
prod?: boolean;
|
|
4
|
+
output?: string;
|
|
5
|
+
force?: boolean;
|
|
6
|
+
}
|
|
7
|
+
export interface PullIO {
|
|
8
|
+
stdout: NodeJS.WritableStream;
|
|
9
|
+
stderr: NodeJS.WritableStream;
|
|
10
|
+
/** Injectable for tests; defaults to process.env. */
|
|
11
|
+
env?: NodeJS.ProcessEnv;
|
|
12
|
+
/** Injectable for tests; defaults to the real user config directory. */
|
|
13
|
+
configDir?: string;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Resolves the environment, fetches the remote catalog, translates it into
|
|
17
|
+
* config defs, serializes it, and writes it to `options.output` (default
|
|
18
|
+
* `kelviq.config.ts`). Returns a non-zero exit code (and writes nothing) if
|
|
19
|
+
* the target already exists without `--force`, if no API key is configured
|
|
20
|
+
* for the requested environment, or if anything else in the run fails.
|
|
21
|
+
*
|
|
22
|
+
* Everything from environment resolution through the file write is one try
|
|
23
|
+
* block: this is a user-facing CLI command, so no error — a MissingKeyError,
|
|
24
|
+
* a fetch failure, a translation bug surfacing as a builder validation
|
|
25
|
+
* throw, an fs error — is ever allowed to escape as a raw stack trace. Every
|
|
26
|
+
* failure is normalized to a single `pull failed: <message>` line on
|
|
27
|
+
* stderr; a MissingKeyError's own actionable message (env var name,
|
|
28
|
+
* dashboard URL) passes through unchanged as that `<message>`.
|
|
29
|
+
*/
|
|
30
|
+
export declare function runPull(options: PullOptions, io: PullIO): Promise<number>;
|
|
31
|
+
export declare function registerPullCommand(program: Command): void;
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
// `kelviq pull` — fetches the remote catalog (products, features, plans,
|
|
2
|
+
// plus per-plan prices/entitlements) and writes it to a `kelviq.config.ts`
|
|
3
|
+
// file. The on-ramp for pricing-as-code: point the CLI at an existing
|
|
4
|
+
// Kelviq org and get a config describing its catalog instead of
|
|
5
|
+
// hand-transcribing from the dashboard.
|
|
6
|
+
//
|
|
7
|
+
// No diff/merge: writing over an existing file requires `--force` (smart
|
|
8
|
+
// merge is a future release — see CLI plan 005 scope). Orchestration only —
|
|
9
|
+
// fetch/translate/serialize (src/sync/) stay pure and don't print; this
|
|
10
|
+
// command owns all stdout/stderr output.
|
|
11
|
+
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
|
12
|
+
import { dirname, resolve } from 'node:path';
|
|
13
|
+
import { authHintLine, messageCarriesAuthStatus } from '../cli-ui/auth-hint.js';
|
|
14
|
+
import { PULL_HINT, printHint } from '../cli-ui/hints.js';
|
|
15
|
+
import { createSpinner } from '../cli-ui/spinner.js';
|
|
16
|
+
import { loadCliConfig, resolveEnv } from '../core/config.js';
|
|
17
|
+
import { KelviqHttpClient } from '../core/http.js';
|
|
18
|
+
import { fetchCatalog } from '../sync/fetch-catalog.js';
|
|
19
|
+
import { plural } from '../sync/render-plan.js';
|
|
20
|
+
import { serializeConfig } from '../sync/serialize.js';
|
|
21
|
+
import { toConfigDefs } from '../sync/to-config.js';
|
|
22
|
+
const DEFAULT_OUTPUT = 'kelviq.config.ts';
|
|
23
|
+
/**
|
|
24
|
+
* Resolves the environment, fetches the remote catalog, translates it into
|
|
25
|
+
* config defs, serializes it, and writes it to `options.output` (default
|
|
26
|
+
* `kelviq.config.ts`). Returns a non-zero exit code (and writes nothing) if
|
|
27
|
+
* the target already exists without `--force`, if no API key is configured
|
|
28
|
+
* for the requested environment, or if anything else in the run fails.
|
|
29
|
+
*
|
|
30
|
+
* Everything from environment resolution through the file write is one try
|
|
31
|
+
* block: this is a user-facing CLI command, so no error — a MissingKeyError,
|
|
32
|
+
* a fetch failure, a translation bug surfacing as a builder validation
|
|
33
|
+
* throw, an fs error — is ever allowed to escape as a raw stack trace. Every
|
|
34
|
+
* failure is normalized to a single `pull failed: <message>` line on
|
|
35
|
+
* stderr; a MissingKeyError's own actionable message (env var name,
|
|
36
|
+
* dashboard URL) passes through unchanged as that `<message>`.
|
|
37
|
+
*/
|
|
38
|
+
export async function runPull(options, io) {
|
|
39
|
+
const write = (s) => io.stdout.write(s);
|
|
40
|
+
const writeErr = (s) => io.stderr.write(s);
|
|
41
|
+
const targetPath = resolve(options.output ?? DEFAULT_OUTPUT);
|
|
42
|
+
if (existsSync(targetPath) && !options.force) {
|
|
43
|
+
write(`${targetPath} already exists. Use --force to overwrite it ` +
|
|
44
|
+
`(smart merge with an existing config is planned for a future release).\n`);
|
|
45
|
+
return 1;
|
|
46
|
+
}
|
|
47
|
+
try {
|
|
48
|
+
const config = loadCliConfig(io.env ?? process.env, io.configDir);
|
|
49
|
+
const resolved = resolveEnv(config, Boolean(options.prod));
|
|
50
|
+
const http = new KelviqHttpClient({
|
|
51
|
+
serverApiKey: resolved.key,
|
|
52
|
+
baseUrl: resolved.baseUrl,
|
|
53
|
+
edgeUrl: config.edgeUrl,
|
|
54
|
+
userAgent: config.userAgent,
|
|
55
|
+
});
|
|
56
|
+
const spinner = createSpinner(io.stderr);
|
|
57
|
+
spinner.start(`Fetching ${resolved.envName} catalog...`);
|
|
58
|
+
let raw;
|
|
59
|
+
try {
|
|
60
|
+
raw = await fetchCatalog(http);
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
// No `spinner.fail(...)` message here: the catch block below already
|
|
64
|
+
// normalizes every failure to exactly one `pull failed: ...` line —
|
|
65
|
+
// an extra stderr line here would break that single-line contract
|
|
66
|
+
// (see this file's own "normalizes any internal failure" test).
|
|
67
|
+
spinner.stop();
|
|
68
|
+
throw err;
|
|
69
|
+
}
|
|
70
|
+
spinner.succeed(`Fetched ${resolved.envName} catalog (${plural(raw.products.length, 'product')}, ${plural(raw.features.length, 'feature')}, ${plural(raw.plans.length, 'plan')})`);
|
|
71
|
+
const { products, features, plans, warnings: translateWarnings } = toConfigDefs(raw);
|
|
72
|
+
const { code, warnings: serializeWarnings } = serializeConfig({ products, features, plans });
|
|
73
|
+
const warnings = [...translateWarnings, ...serializeWarnings];
|
|
74
|
+
mkdirSync(dirname(targetPath), { recursive: true });
|
|
75
|
+
writeFileSync(targetPath, code);
|
|
76
|
+
write(`Wrote ${targetPath}\n`);
|
|
77
|
+
write(` products: ${products.length}\n`);
|
|
78
|
+
write(` features: ${features.length}\n`);
|
|
79
|
+
write(` plans: ${plans.length}\n`);
|
|
80
|
+
if (warnings.length > 0) {
|
|
81
|
+
write(`\nWarnings (${warnings.length}):\n`);
|
|
82
|
+
for (const w of warnings)
|
|
83
|
+
write(` - ${w}\n`);
|
|
84
|
+
}
|
|
85
|
+
printHint(io.stdout, PULL_HINT);
|
|
86
|
+
return 0;
|
|
87
|
+
}
|
|
88
|
+
catch (err) {
|
|
89
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
90
|
+
writeErr(`pull failed: ${message}\n`);
|
|
91
|
+
if (messageCarriesAuthStatus(message))
|
|
92
|
+
writeErr(`${authHintLine()}\n`);
|
|
93
|
+
return 1;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
export function registerPullCommand(program) {
|
|
97
|
+
program
|
|
98
|
+
.command('pull')
|
|
99
|
+
.description('Fetch the remote catalog and write it to a kelviq.config.ts file.')
|
|
100
|
+
.option('--prod', 'Pull from the production environment instead of sandbox', false)
|
|
101
|
+
.option('-o, --output <path>', 'Path to write the config file', DEFAULT_OUTPUT)
|
|
102
|
+
.option('--force', 'Overwrite the output file if it already exists', false)
|
|
103
|
+
.action(async (opts) => {
|
|
104
|
+
const exitCode = await runPull(opts, { stdout: process.stdout, stderr: process.stderr });
|
|
105
|
+
process.exitCode = exitCode;
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
//# sourceMappingURL=pull.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import type { KelviqHttpClient } from '../core/http.js';
|
|
2
|
+
import type { ApplyResult } from '../sync/apply.js';
|
|
3
|
+
import type { PushPlan } from '../sync/diff.js';
|
|
4
|
+
import type { PublishFlagOptions, PublishResult } from '../sync/publish.js';
|
|
5
|
+
import type { PruneApplyResult, PrunePlan } from '../sync/prune.js';
|
|
6
|
+
export interface PromptIO {
|
|
7
|
+
stdin: NodeJS.ReadableStream;
|
|
8
|
+
stdout: NodeJS.WritableStream;
|
|
9
|
+
}
|
|
10
|
+
/** Reads one line from stdin, no echo suppression — a y/N answer isn't a secret, unlike login.ts's key prompt. Works identically for a real TTY (cooked-mode echo is the terminal driver's job, not readline's) and a piped/test stream. See `promptStreams`'s comment for why lines are queued rather than read via a fresh listener each call. */
|
|
11
|
+
export declare function promptLine(promptText: string, io: PromptIO): Promise<string>;
|
|
12
|
+
/** Default No: only an explicit y/yes (case-insensitive) counts as confirmation. */
|
|
13
|
+
export declare function confirm(promptText: string, io: PromptIO): Promise<boolean>;
|
|
14
|
+
/**
|
|
15
|
+
* Releases the shared readline interface for `io.stdin` (see
|
|
16
|
+
* `promptStreams`). Callers (`runPush`/`runPromote`) call this exactly once,
|
|
17
|
+
* unconditionally, at the very end of a run (success or failure) — a real
|
|
18
|
+
* TTY's readline interface otherwise keeps listening on stdin, which can
|
|
19
|
+
* keep the process's event loop alive instead of letting it exit. A no-op
|
|
20
|
+
* when no prompt was ever issued this run (nothing to release).
|
|
21
|
+
*/
|
|
22
|
+
export declare function closePrompt(io: PromptIO): void;
|
|
23
|
+
/**
|
|
24
|
+
* DESIGN-push.md §3: feature drift is a hard error, never an op — the raw
|
|
25
|
+
* (unstyled) lines push and promote both print, verbatim, before aborting
|
|
26
|
+
* (never a write). Exported separately from `renderFeatureDriftAbort` below
|
|
27
|
+
* (CLI plan 015) so the `--json` error document's single `error` string
|
|
28
|
+
* (src/sync/push-plan-json.ts) can reuse the exact same wording without ever
|
|
29
|
+
* routing through `style.err` — JSON mode must never risk an ANSI escape
|
|
30
|
+
* landing inside a JSON string value.
|
|
31
|
+
*/
|
|
32
|
+
export declare function featureDriftAbortLines(plan: PushPlan): string[];
|
|
33
|
+
/** Text-mode rendering of `featureDriftAbortLines` — styled red, one line per entry. */
|
|
34
|
+
export declare function renderFeatureDriftAbort(plan: PushPlan): string[];
|
|
35
|
+
export declare function renderApplyReport(result: ApplyResult): string;
|
|
36
|
+
export declare function renderPublishReport(result: PublishResult): string;
|
|
37
|
+
/** CLI plan 010: the `--prune` archive report — same applied/failed/not-attempted shape as `renderApplyReport`/`renderPublishReport`. */
|
|
38
|
+
export declare function renderPruneReport(result: PruneApplyResult): string;
|
|
39
|
+
export interface PublishStepIO {
|
|
40
|
+
stdin: NodeJS.ReadableStream;
|
|
41
|
+
stdout: NodeJS.WritableStream;
|
|
42
|
+
stderr: NodeJS.WritableStream;
|
|
43
|
+
isTTY: boolean;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* The `--publish` confirmation + write step (DESIGN-push.md §4, CLI plan 009
|
|
47
|
+
* Step 1), run strictly last and only after the caller has already confirmed
|
|
48
|
+
* `applyResult.ok` — a failed push/promote never reaches here. Returns
|
|
49
|
+
* `{ ok: true }` when there was nothing to publish (either `--publish` was
|
|
50
|
+
* never passed, or this run touched no plan) — the caller treats that the
|
|
51
|
+
* same as success. This is the ONE place either command asks about
|
|
52
|
+
* publishing, so the confirmation copy (safety-critical UX per plan 009's
|
|
53
|
+
* maintenance notes) can never drift between push and promote.
|
|
54
|
+
*/
|
|
55
|
+
export declare function runPublishStep(http: KelviqHttpClient, applyResult: ApplyResult, options: PublishFlagOptions & {
|
|
56
|
+
yes?: boolean;
|
|
57
|
+
}, envName: string, io: PublishStepIO): Promise<{
|
|
58
|
+
ok: boolean;
|
|
59
|
+
}>;
|
|
60
|
+
export interface ProdPruneGateOptions {
|
|
61
|
+
prune?: boolean;
|
|
62
|
+
allowProdPrune?: boolean;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* DESIGN-push.md §5 / CLI plan 010: the prod-prune gate. `--prune` against
|
|
66
|
+
* production requires ONE of:
|
|
67
|
+
* - the explicit `--allow-prod-prune` flag — deliberate, unambiguous
|
|
68
|
+
* consent, honored in both TTY and non-TTY sessions; or
|
|
69
|
+
* - (TTY only) typing the environment name at a DEDICATED prompt — never
|
|
70
|
+
* the y/N write-confirmation gate, which only mentions the archive count
|
|
71
|
+
* (see push.ts/promote.ts).
|
|
72
|
+
* Non-interactive without the flag is refused, naming it. `--yes` is never
|
|
73
|
+
* consulted here — `options` deliberately has no `yes` field — so there is
|
|
74
|
+
* no code path where `--yes` alone satisfies this gate, per DESIGN-push.md
|
|
75
|
+
* §5's explicit rule. A no-op (`{ ok: true }`) when `--prune` wasn't passed,
|
|
76
|
+
* the target isn't production, or there's nothing to archive this run — the
|
|
77
|
+
* gate only exists to guard an actual production archive.
|
|
78
|
+
*/
|
|
79
|
+
export declare function gateProdPrune(isProdTarget: boolean, archiveCount: number, options: ProdPruneGateOptions, io: PublishStepIO): Promise<{
|
|
80
|
+
ok: boolean;
|
|
81
|
+
}>;
|
|
82
|
+
export interface PruneStepIO {
|
|
83
|
+
stdout: NodeJS.WritableStream;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* The `--prune` archive step (DESIGN-push.md §5, CLI plan 010), run
|
|
87
|
+
* strictly LAST — after `applyPushPlan` and, when requested, the publish
|
|
88
|
+
* step have both already succeeded. All required confirmation (the general
|
|
89
|
+
* write confirmation, mentioning the archive count, plus `gateProdPrune`
|
|
90
|
+
* above when the target is production) has already happened by the time
|
|
91
|
+
* this runs; this function only applies and reports. Returns `{ ok: true }`
|
|
92
|
+
* when `--prune` wasn't requested, or the computed `PrunePlan` has nothing
|
|
93
|
+
* to archive.
|
|
94
|
+
*/
|
|
95
|
+
export declare function runPruneStep(http: KelviqHttpClient, prunePlan: PrunePlan, prune: boolean | undefined, io: PruneStepIO): Promise<{
|
|
96
|
+
ok: boolean;
|
|
97
|
+
}>;
|