@kelviq/cli 0.3.0 → 0.4.0

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.
@@ -0,0 +1,250 @@
1
+ import { authHintLine, messageCarriesAuthStatus } from '../cli-ui/auth-hint.js';
2
+ import { style } from '../cli-ui/style.js';
3
+ import { loadCliConfig, resolveEnv } from '../core/config.js';
4
+ import { upsertEnvFileVariable } from '../core/env-file.js';
5
+ import { KelviqHttpClient } from '../core/http.js';
6
+ import { fetchAllPages } from '../sync/fetch-catalog.js';
7
+ import { closePrompt, confirm } from './push-shared.js';
8
+ // Sourced from src/generated/openapi.json:
9
+ // components.schemas.WebhookEndpoint.properties.events.items.enum
10
+ // Unknown values are passed through to the API (open enum, like the config
11
+ // format), which validates them — a warning is printed, never a refusal.
12
+ export const KNOWN_WEBHOOK_EVENTS = [
13
+ 'checkout.completed',
14
+ 'customer.created',
15
+ 'customer.updated',
16
+ 'order.created',
17
+ 'order.updated',
18
+ 'order.refunded',
19
+ 'subscription.created',
20
+ 'subscription.updated',
21
+ 'subscription.cancelled',
22
+ 'subscription.plan_changed',
23
+ 'subscription.trial_will_end',
24
+ 'invoice.created',
25
+ 'invoice.paid',
26
+ 'invoice.payment_failed',
27
+ 'refund.created',
28
+ 'refund.updated',
29
+ 'feature.usage_alert',
30
+ 'payment_method.created',
31
+ 'payment_method.updated',
32
+ 'payment_method.deleted',
33
+ ];
34
+ export const DEFAULT_SECRET_VARIABLE = 'KELVIQ_WEBHOOK_SECRET';
35
+ const HIDDEN = '[hidden]';
36
+ function client(io, prod) {
37
+ const config = loadCliConfig(io.env ?? process.env, io.configDir);
38
+ const resolved = resolveEnv(config, prod);
39
+ const http = new KelviqHttpClient({
40
+ serverApiKey: resolved.key,
41
+ baseUrl: resolved.baseUrl,
42
+ edgeUrl: resolved.edgeUrl,
43
+ userAgent: config.userAgent,
44
+ });
45
+ return { http, envName: resolved.envName };
46
+ }
47
+ function withoutSecret(endpoint) {
48
+ return { ...endpoint, ...(endpoint.secret !== undefined ? { secret: HIDDEN } : {}) };
49
+ }
50
+ function failure(command, err, options, io) {
51
+ const message = err instanceof Error ? err.message : String(err);
52
+ if (options.json) {
53
+ io.stdout.write(`${JSON.stringify({ error: `${command} failed: ${message}` })}\n`);
54
+ }
55
+ else {
56
+ io.stderr.write(`${command} failed: ${message}\n`);
57
+ if (messageCarriesAuthStatus(message))
58
+ io.stderr.write(`${authHintLine()}\n`);
59
+ }
60
+ return 1;
61
+ }
62
+ export async function runWebhookList(options, io) {
63
+ try {
64
+ const { http, envName } = client(io, Boolean(options.prod));
65
+ const endpoints = (await fetchAllPages(http, { path: '/webhook/endpoints/', query: { page_size: 100 }, label: 'webhook endpoints' })).map(withoutSecret);
66
+ if (options.json) {
67
+ io.stdout.write(`${JSON.stringify({ environment: envName, endpoints })}\n`);
68
+ return 0;
69
+ }
70
+ io.stdout.write(`Environment : ${envName}\n`);
71
+ if (endpoints.length === 0) {
72
+ io.stdout.write('No webhook endpoints registered.\n');
73
+ return 0;
74
+ }
75
+ for (const endpoint of endpoints) {
76
+ const state = endpoint.enabled === false ? style.fail('disabled') : style.ok('enabled');
77
+ io.stdout.write(`${endpoint.url} ${state} id ${endpoint.id}\n events: ${(endpoint.events ?? []).join(', ') || '(none)'}\n`);
78
+ }
79
+ return 0;
80
+ }
81
+ catch (err) {
82
+ return failure('webhook list', err, options, io);
83
+ }
84
+ }
85
+ export function parseEvents(raw) {
86
+ const events = [...new Set((raw ?? '').split(',').map((e) => e.trim()).filter((e) => e.length > 0))];
87
+ return { events, unknown: events.filter((e) => !KNOWN_WEBHOOK_EVENTS.includes(e)) };
88
+ }
89
+ export async function runWebhookAdd(url, options, io) {
90
+ const write = (s) => io.stdout.write(s);
91
+ const writeErr = (s) => io.stderr.write(s);
92
+ const variable = options.variable ?? DEFAULT_SECRET_VARIABLE;
93
+ const { events, unknown } = parseEvents(options.events);
94
+ if (events.length === 0) {
95
+ writeErr('webhook add failed: pass --events with at least one event, e.g. --events checkout.completed,subscription.created\n');
96
+ return 1;
97
+ }
98
+ let parsedUrl;
99
+ try {
100
+ parsedUrl = new URL(url);
101
+ }
102
+ catch {
103
+ writeErr(`webhook add failed: "${url}" is not a valid URL.\n`);
104
+ return 1;
105
+ }
106
+ if (parsedUrl.protocol !== 'https:' && parsedUrl.protocol !== 'http:') {
107
+ writeErr(`webhook add failed: "${url}" must be an http(s) URL.\n`);
108
+ return 1;
109
+ }
110
+ try {
111
+ const { http, envName } = client(io, Boolean(options.prod));
112
+ if (!options.json && unknown.length > 0) {
113
+ writeErr(`warning: ${unknown.join(', ')} ${unknown.length === 1 ? 'is not an event this CLI knows' : 'are not events this CLI knows'} — sent as-is for the API to validate.\n`);
114
+ }
115
+ const existing = (await fetchAllPages(http, { path: '/webhook/endpoints/', query: { page_size: 100 }, label: 'webhook endpoints' })).find((e) => e.url === url);
116
+ const missingEvents = existing ? events.filter((e) => !(existing.events ?? []).includes(e)) : events;
117
+ const needsWrite = !existing || missingEvents.length > 0;
118
+ if (needsWrite) {
119
+ const summary = existing
120
+ ? `Add ${missingEvents.join(', ')} to the existing ${envName} webhook endpoint ${url}`
121
+ : `Register ${url} as a ${envName} webhook endpoint for ${events.join(', ')}`;
122
+ if (!options.yes) {
123
+ if (!io.isTTY) {
124
+ writeErr(`${summary}.\nRefusing to write without confirmation in a non-interactive session. Pass --yes to proceed.\n`);
125
+ return 1;
126
+ }
127
+ const ok = await confirm(`${summary}? [y/N] `, io);
128
+ if (!ok) {
129
+ write('Aborted; nothing was registered.\n');
130
+ return 1;
131
+ }
132
+ }
133
+ }
134
+ let endpoint;
135
+ let reused = false;
136
+ if (!existing) {
137
+ const created = await http.request({
138
+ method: 'POST',
139
+ path: '/webhook/endpoints/',
140
+ body: { url, events, enabled: true },
141
+ auth: 'server',
142
+ });
143
+ if (!created.ok)
144
+ throw new Error(`${created.error.message} (${created.error.status})`);
145
+ endpoint = created.data;
146
+ }
147
+ else {
148
+ reused = true;
149
+ if (missingEvents.length > 0) {
150
+ const patched = await http.request({
151
+ method: 'PATCH',
152
+ path: `/webhook/endpoints/${encodeURIComponent(existing.id)}/`,
153
+ body: { events: [...(existing.events ?? []), ...missingEvents] },
154
+ auth: 'server',
155
+ });
156
+ if (!patched.ok)
157
+ throw new Error(`${patched.error.message} (${patched.error.status})`);
158
+ endpoint = patched.data;
159
+ }
160
+ else {
161
+ endpoint = existing;
162
+ }
163
+ if (!endpoint.secret) {
164
+ const fetched = await http.request({
165
+ method: 'GET',
166
+ path: `/webhook/endpoints/${encodeURIComponent(existing.id)}/`,
167
+ auth: 'server',
168
+ });
169
+ if (fetched.ok && fetched.data.secret)
170
+ endpoint = { ...endpoint, secret: fetched.data.secret };
171
+ }
172
+ }
173
+ let secretWrittenTo = null;
174
+ if (endpoint.secret && options.writeSecret) {
175
+ upsertEnvFileVariable(options.writeSecret, variable, endpoint.secret);
176
+ secretWrittenTo = options.writeSecret;
177
+ }
178
+ if (options.json) {
179
+ write(`${JSON.stringify({
180
+ environment: envName,
181
+ endpoint: withoutSecret(endpoint),
182
+ reused,
183
+ eventsAdded: reused ? missingEvents : events,
184
+ secretWrittenTo,
185
+ variable,
186
+ ...(options.printSecret && endpoint.secret ? { secret: endpoint.secret } : {}),
187
+ })}\n`);
188
+ return 0;
189
+ }
190
+ write(`${reused ? 'Reusing' : 'Registered'} ${envName} webhook endpoint ${endpoint.url} (id ${endpoint.id})\n`);
191
+ write(` events: ${(endpoint.events ?? events).join(', ')}\n`);
192
+ if (reused && missingEvents.length > 0)
193
+ write(` added: ${missingEvents.join(', ')}\n`);
194
+ if (!endpoint.secret) {
195
+ write(` ${style.fail('No signing secret in the response')} — copy it from the dashboard's Webhooks page.\n`);
196
+ }
197
+ else if (secretWrittenTo) {
198
+ write(` signing secret written to ${secretWrittenTo} as ${variable} (not shown)\n`);
199
+ }
200
+ else if (options.printSecret) {
201
+ write(` signing secret: ${endpoint.secret}\n`);
202
+ }
203
+ else {
204
+ write(` signing secret not shown — rerun with --write-secret <env file> to store it as ${variable}, or --print-secret.\n`);
205
+ }
206
+ return 0;
207
+ }
208
+ catch (err) {
209
+ return failure('webhook add', err, options, io);
210
+ }
211
+ finally {
212
+ closePrompt(io);
213
+ }
214
+ }
215
+ export function registerWebhookCommand(program) {
216
+ const webhook = program.command('webhook').description('Manage webhook endpoints: list them, or register one and store its signing secret in an env file.');
217
+ webhook
218
+ .command('list')
219
+ .description('List webhook endpoints with their URLs, events and state. Signing secrets are never shown.')
220
+ .option('--prod', 'Read the production environment instead of sandbox', false)
221
+ .option('--json', 'Machine-readable output', false)
222
+ .action(async (opts) => {
223
+ process.exitCode = await runWebhookList(opts, {
224
+ stdin: process.stdin,
225
+ stdout: process.stdout,
226
+ stderr: process.stderr,
227
+ isTTY: Boolean(process.stdin.isTTY),
228
+ });
229
+ });
230
+ webhook
231
+ .command('add')
232
+ .description('Register a public URL for webhook events (reusing an endpoint that already has that URL) and optionally write its signing secret into an env file.')
233
+ .argument('<url>', 'Public https URL that receives events')
234
+ .requiredOption('--events <list>', 'Comma-separated event types, e.g. checkout.completed,subscription.created')
235
+ .option('--write-secret <file>', `Write the signing secret into this dotenv file (as ${DEFAULT_SECRET_VARIABLE} unless --variable is given) without printing it`)
236
+ .option('--variable <name>', 'Variable name to write the secret under', DEFAULT_SECRET_VARIABLE)
237
+ .option('--print-secret', 'Print the signing secret to stdout (off by default)', false)
238
+ .option('--prod', 'Target the production environment instead of sandbox', false)
239
+ .option('--yes', 'Skip the confirmation prompt (required in non-interactive sessions)', false)
240
+ .option('--json', 'Machine-readable output', false)
241
+ .action(async (url, opts) => {
242
+ process.exitCode = await runWebhookAdd(url, opts, {
243
+ stdin: process.stdin,
244
+ stdout: process.stdout,
245
+ stderr: process.stderr,
246
+ isTTY: Boolean(process.stdin.isTTY),
247
+ });
248
+ });
249
+ }
250
+ //# sourceMappingURL=webhook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/commands/webhook.ts"],"names":[],"mappings":"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"}
@@ -34,17 +34,17 @@ export declare const featureDefSchema: z.ZodObject<{
34
34
  meter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
35
35
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
36
36
  }, "strip", z.ZodTypeAny, {
37
- name: string;
38
37
  type: string;
39
38
  identifier: string;
39
+ name: string;
40
40
  description?: string | undefined;
41
41
  featureDetails?: Record<string, unknown> | undefined;
42
42
  meter?: Record<string, unknown> | undefined;
43
43
  metadata?: Record<string, unknown> | undefined;
44
44
  }, {
45
- name: string;
46
45
  type: string;
47
46
  identifier: string;
47
+ name: string;
48
48
  description?: string | undefined;
49
49
  featureDetails?: Record<string, unknown> | undefined;
50
50
  meter?: Record<string, unknown> | undefined;
@@ -272,8 +272,8 @@ export declare const planDefSchema: z.ZodObject<{
272
272
  }, z.ZodTypeAny, "passthrough">>, "many">>;
273
273
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
274
274
  }, "strip", z.ZodTypeAny, {
275
- name: string;
276
275
  identifier: string;
276
+ name: string;
277
277
  product: string;
278
278
  description?: string | undefined;
279
279
  metadata?: Record<string, unknown> | undefined;
@@ -303,8 +303,8 @@ export declare const planDefSchema: z.ZodObject<{
303
303
  chargeCatalogPrice: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
304
304
  }, z.ZodTypeAny, "passthrough">[] | undefined;
305
305
  }, {
306
- name: string;
307
306
  identifier: string;
307
+ name: string;
308
308
  product: string;
309
309
  description?: string | undefined;
310
310
  metadata?: Record<string, unknown> | undefined;
@@ -345,13 +345,13 @@ export declare const productDefSchema: z.ZodObject<{
345
345
  taxCode: z.ZodUnion<[z.ZodEnum<["saas", "saas_business", "software", "videocontent", "informationservice", "ebook", "digitalgraphic", "videogame", "eservice", "training"]>, z.ZodString]>;
346
346
  description: z.ZodOptional<z.ZodString>;
347
347
  }, "strip", z.ZodTypeAny, {
348
- name: string;
349
348
  identifier: string;
349
+ name: string;
350
350
  taxCode: string;
351
351
  description?: string | undefined;
352
352
  }, {
353
- name: string;
354
353
  identifier: string;
354
+ name: string;
355
355
  taxCode: string;
356
356
  description?: string | undefined;
357
357
  }>;
@@ -365,13 +365,13 @@ export declare const kelviqConfigSchema: z.ZodObject<{
365
365
  taxCode: z.ZodUnion<[z.ZodEnum<["saas", "saas_business", "software", "videocontent", "informationservice", "ebook", "digitalgraphic", "videogame", "eservice", "training"]>, z.ZodString]>;
366
366
  description: z.ZodOptional<z.ZodString>;
367
367
  }, "strip", z.ZodTypeAny, {
368
- name: string;
369
368
  identifier: string;
369
+ name: string;
370
370
  taxCode: string;
371
371
  description?: string | undefined;
372
372
  }, {
373
- name: string;
374
373
  identifier: string;
374
+ name: string;
375
375
  taxCode: string;
376
376
  description?: string | undefined;
377
377
  }>, "many">;
@@ -384,17 +384,17 @@ export declare const kelviqConfigSchema: z.ZodObject<{
384
384
  meter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
385
385
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
386
386
  }, "strip", z.ZodTypeAny, {
387
- name: string;
388
387
  type: string;
389
388
  identifier: string;
389
+ name: string;
390
390
  description?: string | undefined;
391
391
  featureDetails?: Record<string, unknown> | undefined;
392
392
  meter?: Record<string, unknown> | undefined;
393
393
  metadata?: Record<string, unknown> | undefined;
394
394
  }, {
395
- name: string;
396
395
  type: string;
397
396
  identifier: string;
397
+ name: string;
398
398
  description?: string | undefined;
399
399
  featureDetails?: Record<string, unknown> | undefined;
400
400
  meter?: Record<string, unknown> | undefined;
@@ -474,8 +474,8 @@ export declare const kelviqConfigSchema: z.ZodObject<{
474
474
  }, z.ZodTypeAny, "passthrough">>, "many">>;
475
475
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
476
476
  }, "strip", z.ZodTypeAny, {
477
- name: string;
478
477
  identifier: string;
478
+ name: string;
479
479
  product: string;
480
480
  description?: string | undefined;
481
481
  metadata?: Record<string, unknown> | undefined;
@@ -505,8 +505,8 @@ export declare const kelviqConfigSchema: z.ZodObject<{
505
505
  chargeCatalogPrice: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
506
506
  }, z.ZodTypeAny, "passthrough">[] | undefined;
507
507
  }, {
508
- name: string;
509
508
  identifier: string;
509
+ name: string;
510
510
  product: string;
511
511
  description?: string | undefined;
512
512
  metadata?: Record<string, unknown> | undefined;
@@ -538,23 +538,23 @@ export declare const kelviqConfigSchema: z.ZodObject<{
538
538
  }>, "many">;
539
539
  }, "strip", z.ZodTypeAny, {
540
540
  products: {
541
- name: string;
542
541
  identifier: string;
542
+ name: string;
543
543
  taxCode: string;
544
544
  description?: string | undefined;
545
545
  }[];
546
546
  features: {
547
- name: string;
548
547
  type: string;
549
548
  identifier: string;
549
+ name: string;
550
550
  description?: string | undefined;
551
551
  featureDetails?: Record<string, unknown> | undefined;
552
552
  meter?: Record<string, unknown> | undefined;
553
553
  metadata?: Record<string, unknown> | undefined;
554
554
  }[];
555
555
  plans: {
556
- name: string;
557
556
  identifier: string;
557
+ name: string;
558
558
  product: string;
559
559
  description?: string | undefined;
560
560
  metadata?: Record<string, unknown> | undefined;
@@ -586,23 +586,23 @@ export declare const kelviqConfigSchema: z.ZodObject<{
586
586
  }[];
587
587
  }, {
588
588
  products: {
589
- name: string;
590
589
  identifier: string;
590
+ name: string;
591
591
  taxCode: string;
592
592
  description?: string | undefined;
593
593
  }[];
594
594
  features: {
595
- name: string;
596
595
  type: string;
597
596
  identifier: string;
597
+ name: string;
598
598
  description?: string | undefined;
599
599
  featureDetails?: Record<string, unknown> | undefined;
600
600
  meter?: Record<string, unknown> | undefined;
601
601
  metadata?: Record<string, unknown> | undefined;
602
602
  }[];
603
603
  plans: {
604
- name: string;
605
604
  identifier: string;
605
+ name: string;
606
606
  product: string;
607
607
  description?: string | undefined;
608
608
  metadata?: Record<string, unknown> | undefined;
@@ -0,0 +1,29 @@
1
+ export declare const DEFAULT_ENV_FILES: readonly string[];
2
+ /** Parses dotenv text: `KEY=value`, optional `export ` prefix, `#` comments, single/double quotes, `\n` escapes inside double quotes. */
3
+ export declare function parseEnvFile(text: string): Record<string, string>;
4
+ export interface EnvFileLoadResult {
5
+ /** Absolute paths of the files that were read, in order. */
6
+ loaded: string[];
7
+ /** Variable names taken from those files (not already set in the environment). */
8
+ applied: string[];
9
+ }
10
+ export interface ApplyEnvFilesOptions {
11
+ cwd: string;
12
+ /** `--env-file` paths. When given, the default pair is not consulted. */
13
+ explicit?: string[];
14
+ /** Overrides the default pair; tests only. */
15
+ defaults?: readonly string[];
16
+ }
17
+ /** What the most recent `applyEnvFiles` call did — `kelviq env` reports it. */
18
+ export declare function lastEnvFileLoad(): EnvFileLoadResult;
19
+ /**
20
+ * Applies `KELVIQ_*` pairs from the env files into `env`, never overriding a
21
+ * variable that is already set. Throws when an explicit file is missing.
22
+ */
23
+ export declare function applyEnvFiles(env: NodeJS.ProcessEnv, options: ApplyEnvFilesOptions): EnvFileLoadResult;
24
+ /**
25
+ * Sets `VAR=value` in a dotenv file: replaces an existing `VAR=` line in
26
+ * place, or appends one. Creates the file when missing. The value is written
27
+ * verbatim and never returned or logged — callers use this for secrets.
28
+ */
29
+ export declare function upsertEnvFileVariable(path: string, name: string, value: string): void;
@@ -0,0 +1,107 @@
1
+ // Loads `KELVIQ_*` variables from dotenv-style files so a project's
2
+ // `.env.local` / `.env` works without `set -a; . ./.env.local; set +a`.
3
+ //
4
+ // Rules: variables already present in the environment always win (a file
5
+ // never overrides the shell); only `KELVIQ_*` keys are applied, since those
6
+ // are the only ones the CLI reads; `.env.local` is read before `.env` so the
7
+ // local override file wins, matching the convention of the frameworks that
8
+ // use that pair. Explicit `--env-file` paths must exist; the default pair is
9
+ // skipped silently when absent. Nothing is ever printed from a file.
10
+ import { existsSync, readFileSync } from 'node:fs';
11
+ import { resolve } from 'node:path';
12
+ export const DEFAULT_ENV_FILES = ['.env.local', '.env'];
13
+ const KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
14
+ /** Parses dotenv text: `KEY=value`, optional `export ` prefix, `#` comments, single/double quotes, `\n` escapes inside double quotes. */
15
+ export function parseEnvFile(text) {
16
+ const out = {};
17
+ for (const rawLine of text.split(/\r?\n/)) {
18
+ let line = rawLine.trim();
19
+ if (line === '' || line.startsWith('#'))
20
+ continue;
21
+ if (line.startsWith('export '))
22
+ line = line.slice('export '.length).trim();
23
+ const eq = line.indexOf('=');
24
+ if (eq <= 0)
25
+ continue;
26
+ const key = line.slice(0, eq).trim();
27
+ if (!KEY_PATTERN.test(key))
28
+ continue;
29
+ let value = line.slice(eq + 1).trim();
30
+ if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
31
+ value = value.slice(1, -1).replace(/\\n/g, '\n').replace(/\\"/g, '"');
32
+ }
33
+ else if (value.length >= 2 && value.startsWith("'") && value.endsWith("'")) {
34
+ value = value.slice(1, -1);
35
+ }
36
+ else {
37
+ const comment = value.indexOf(' #');
38
+ if (comment >= 0)
39
+ value = value.slice(0, comment).trim();
40
+ }
41
+ out[key] = value;
42
+ }
43
+ return out;
44
+ }
45
+ let lastLoad = { loaded: [], applied: [] };
46
+ /** What the most recent `applyEnvFiles` call did — `kelviq env` reports it. */
47
+ export function lastEnvFileLoad() {
48
+ return lastLoad;
49
+ }
50
+ /**
51
+ * Applies `KELVIQ_*` pairs from the env files into `env`, never overriding a
52
+ * variable that is already set. Throws when an explicit file is missing.
53
+ */
54
+ export function applyEnvFiles(env, options) {
55
+ const explicit = options.explicit ?? [];
56
+ const candidates = explicit.length > 0
57
+ ? explicit.map((p) => ({ path: resolve(options.cwd, p), required: true }))
58
+ : (options.defaults ?? DEFAULT_ENV_FILES).map((p) => ({ path: resolve(options.cwd, p), required: false }));
59
+ const result = { loaded: [], applied: [] };
60
+ for (const candidate of candidates) {
61
+ if (!existsSync(candidate.path)) {
62
+ if (candidate.required)
63
+ throw new Error(`Env file not found: ${candidate.path}`);
64
+ continue;
65
+ }
66
+ const parsed = parseEnvFile(readFileSync(candidate.path, 'utf8'));
67
+ result.loaded.push(candidate.path);
68
+ for (const [key, value] of Object.entries(parsed)) {
69
+ if (!key.startsWith('KELVIQ_'))
70
+ continue;
71
+ const existing = env[key];
72
+ if (existing !== undefined && existing.trim() !== '')
73
+ continue;
74
+ env[key] = value;
75
+ result.applied.push(key);
76
+ }
77
+ }
78
+ lastLoad = result;
79
+ return result;
80
+ }
81
+ /**
82
+ * Sets `VAR=value` in a dotenv file: replaces an existing `VAR=` line in
83
+ * place, or appends one. Creates the file when missing. The value is written
84
+ * verbatim and never returned or logged — callers use this for secrets.
85
+ */
86
+ export function upsertEnvFileVariable(path, name, value) {
87
+ if (!KEY_PATTERN.test(name))
88
+ throw new Error(`Invalid variable name "${name}".`);
89
+ const absolute = resolve(path);
90
+ const current = existsSync(absolute) ? readFileSync(absolute, 'utf8') : '';
91
+ const line = `${name}=${value}`;
92
+ const pattern = new RegExp(`^(?:export\\s+)?${name}\\s*=.*$`, 'm');
93
+ let next;
94
+ if (pattern.test(current)) {
95
+ next = current.replace(pattern, line);
96
+ }
97
+ else {
98
+ next = current.length === 0 || current.endsWith('\n') ? `${current}${line}\n` : `${current}\n${line}\n`;
99
+ }
100
+ // Written via the fs module directly so the value never passes through a shell.
101
+ writeFileSyncStrict(absolute, next);
102
+ }
103
+ import { writeFileSync } from 'node:fs';
104
+ function writeFileSyncStrict(path, content) {
105
+ writeFileSync(path, content, { encoding: 'utf8' });
106
+ }
107
+ //# sourceMappingURL=env-file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-file.js","sourceRoot":"","sources":["../../src/core/env-file.ts"],"names":[],"mappings":"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"}
@@ -187,4 +187,6 @@ export interface PushPlan {
187
187
  /** Unresolvable charge features, dangling product/feature references — never silently dropped. */
188
188
  errors: string[];
189
189
  }
190
+ /** True when `details` carries what the API requires of a METER feature: a `featureSubType` and `units.singular`/`units.plural`. */
191
+ export declare function hasMeterDetails(details: Record<string, unknown> | undefined): boolean;
190
192
  export declare function buildPushPlan(desired: KelviqConfig, remote: RawCatalog): PushPlan;