@hasna/shortlinks 0.1.7 → 0.1.9

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/dist/cli/index.js DELETED
@@ -1,3944 +0,0 @@
1
- #!/usr/bin/env bun
2
- // @bun
3
- var __create = Object.create;
4
- var __getProtoOf = Object.getPrototypeOf;
5
- var __defProp = Object.defineProperty;
6
- var __getOwnPropNames = Object.getOwnPropertyNames;
7
- var __hasOwnProp = Object.prototype.hasOwnProperty;
8
- var __toESM = (mod, isNodeMode, target) => {
9
- target = mod != null ? __create(__getProtoOf(mod)) : {};
10
- const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
11
- for (let key of __getOwnPropNames(mod))
12
- if (!__hasOwnProp.call(to, key))
13
- __defProp(to, key, {
14
- get: () => mod[key],
15
- enumerable: true
16
- });
17
- return to;
18
- };
19
- var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
20
- var __require = import.meta.require;
21
-
22
- // node_modules/commander/lib/error.js
23
- var require_error = __commonJS((exports) => {
24
- class CommanderError extends Error {
25
- constructor(exitCode, code, message) {
26
- super(message);
27
- Error.captureStackTrace(this, this.constructor);
28
- this.name = this.constructor.name;
29
- this.code = code;
30
- this.exitCode = exitCode;
31
- this.nestedError = undefined;
32
- }
33
- }
34
-
35
- class InvalidArgumentError extends CommanderError {
36
- constructor(message) {
37
- super(1, "commander.invalidArgument", message);
38
- Error.captureStackTrace(this, this.constructor);
39
- this.name = this.constructor.name;
40
- }
41
- }
42
- exports.CommanderError = CommanderError;
43
- exports.InvalidArgumentError = InvalidArgumentError;
44
- });
45
-
46
- // node_modules/commander/lib/argument.js
47
- var require_argument = __commonJS((exports) => {
48
- var { InvalidArgumentError } = require_error();
49
-
50
- class Argument {
51
- constructor(name, description) {
52
- this.description = description || "";
53
- this.variadic = false;
54
- this.parseArg = undefined;
55
- this.defaultValue = undefined;
56
- this.defaultValueDescription = undefined;
57
- this.argChoices = undefined;
58
- switch (name[0]) {
59
- case "<":
60
- this.required = true;
61
- this._name = name.slice(1, -1);
62
- break;
63
- case "[":
64
- this.required = false;
65
- this._name = name.slice(1, -1);
66
- break;
67
- default:
68
- this.required = true;
69
- this._name = name;
70
- break;
71
- }
72
- if (this._name.length > 3 && this._name.slice(-3) === "...") {
73
- this.variadic = true;
74
- this._name = this._name.slice(0, -3);
75
- }
76
- }
77
- name() {
78
- return this._name;
79
- }
80
- _concatValue(value, previous) {
81
- if (previous === this.defaultValue || !Array.isArray(previous)) {
82
- return [value];
83
- }
84
- return previous.concat(value);
85
- }
86
- default(value, description) {
87
- this.defaultValue = value;
88
- this.defaultValueDescription = description;
89
- return this;
90
- }
91
- argParser(fn) {
92
- this.parseArg = fn;
93
- return this;
94
- }
95
- choices(values) {
96
- this.argChoices = values.slice();
97
- this.parseArg = (arg, previous) => {
98
- if (!this.argChoices.includes(arg)) {
99
- throw new InvalidArgumentError(`Allowed choices are ${this.argChoices.join(", ")}.`);
100
- }
101
- if (this.variadic) {
102
- return this._concatValue(arg, previous);
103
- }
104
- return arg;
105
- };
106
- return this;
107
- }
108
- argRequired() {
109
- this.required = true;
110
- return this;
111
- }
112
- argOptional() {
113
- this.required = false;
114
- return this;
115
- }
116
- }
117
- function humanReadableArgName(arg) {
118
- const nameOutput = arg.name() + (arg.variadic === true ? "..." : "");
119
- return arg.required ? "<" + nameOutput + ">" : "[" + nameOutput + "]";
120
- }
121
- exports.Argument = Argument;
122
- exports.humanReadableArgName = humanReadableArgName;
123
- });
124
-
125
- // node_modules/commander/lib/help.js
126
- var require_help = __commonJS((exports) => {
127
- var { humanReadableArgName } = require_argument();
128
-
129
- class Help {
130
- constructor() {
131
- this.helpWidth = undefined;
132
- this.minWidthToWrap = 40;
133
- this.sortSubcommands = false;
134
- this.sortOptions = false;
135
- this.showGlobalOptions = false;
136
- }
137
- prepareContext(contextOptions) {
138
- this.helpWidth = this.helpWidth ?? contextOptions.helpWidth ?? 80;
139
- }
140
- visibleCommands(cmd) {
141
- const visibleCommands = cmd.commands.filter((cmd2) => !cmd2._hidden);
142
- const helpCommand = cmd._getHelpCommand();
143
- if (helpCommand && !helpCommand._hidden) {
144
- visibleCommands.push(helpCommand);
145
- }
146
- if (this.sortSubcommands) {
147
- visibleCommands.sort((a, b) => {
148
- return a.name().localeCompare(b.name());
149
- });
150
- }
151
- return visibleCommands;
152
- }
153
- compareOptions(a, b) {
154
- const getSortKey = (option) => {
155
- return option.short ? option.short.replace(/^-/, "") : option.long.replace(/^--/, "");
156
- };
157
- return getSortKey(a).localeCompare(getSortKey(b));
158
- }
159
- visibleOptions(cmd) {
160
- const visibleOptions = cmd.options.filter((option) => !option.hidden);
161
- const helpOption = cmd._getHelpOption();
162
- if (helpOption && !helpOption.hidden) {
163
- const removeShort = helpOption.short && cmd._findOption(helpOption.short);
164
- const removeLong = helpOption.long && cmd._findOption(helpOption.long);
165
- if (!removeShort && !removeLong) {
166
- visibleOptions.push(helpOption);
167
- } else if (helpOption.long && !removeLong) {
168
- visibleOptions.push(cmd.createOption(helpOption.long, helpOption.description));
169
- } else if (helpOption.short && !removeShort) {
170
- visibleOptions.push(cmd.createOption(helpOption.short, helpOption.description));
171
- }
172
- }
173
- if (this.sortOptions) {
174
- visibleOptions.sort(this.compareOptions);
175
- }
176
- return visibleOptions;
177
- }
178
- visibleGlobalOptions(cmd) {
179
- if (!this.showGlobalOptions)
180
- return [];
181
- const globalOptions = [];
182
- for (let ancestorCmd = cmd.parent;ancestorCmd; ancestorCmd = ancestorCmd.parent) {
183
- const visibleOptions = ancestorCmd.options.filter((option) => !option.hidden);
184
- globalOptions.push(...visibleOptions);
185
- }
186
- if (this.sortOptions) {
187
- globalOptions.sort(this.compareOptions);
188
- }
189
- return globalOptions;
190
- }
191
- visibleArguments(cmd) {
192
- if (cmd._argsDescription) {
193
- cmd.registeredArguments.forEach((argument) => {
194
- argument.description = argument.description || cmd._argsDescription[argument.name()] || "";
195
- });
196
- }
197
- if (cmd.registeredArguments.find((argument) => argument.description)) {
198
- return cmd.registeredArguments;
199
- }
200
- return [];
201
- }
202
- subcommandTerm(cmd) {
203
- const args = cmd.registeredArguments.map((arg) => humanReadableArgName(arg)).join(" ");
204
- return cmd._name + (cmd._aliases[0] ? "|" + cmd._aliases[0] : "") + (cmd.options.length ? " [options]" : "") + (args ? " " + args : "");
205
- }
206
- optionTerm(option) {
207
- return option.flags;
208
- }
209
- argumentTerm(argument) {
210
- return argument.name();
211
- }
212
- longestSubcommandTermLength(cmd, helper) {
213
- return helper.visibleCommands(cmd).reduce((max, command) => {
214
- return Math.max(max, this.displayWidth(helper.styleSubcommandTerm(helper.subcommandTerm(command))));
215
- }, 0);
216
- }
217
- longestOptionTermLength(cmd, helper) {
218
- return helper.visibleOptions(cmd).reduce((max, option) => {
219
- return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
220
- }, 0);
221
- }
222
- longestGlobalOptionTermLength(cmd, helper) {
223
- return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
224
- return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
225
- }, 0);
226
- }
227
- longestArgumentTermLength(cmd, helper) {
228
- return helper.visibleArguments(cmd).reduce((max, argument) => {
229
- return Math.max(max, this.displayWidth(helper.styleArgumentTerm(helper.argumentTerm(argument))));
230
- }, 0);
231
- }
232
- commandUsage(cmd) {
233
- let cmdName = cmd._name;
234
- if (cmd._aliases[0]) {
235
- cmdName = cmdName + "|" + cmd._aliases[0];
236
- }
237
- let ancestorCmdNames = "";
238
- for (let ancestorCmd = cmd.parent;ancestorCmd; ancestorCmd = ancestorCmd.parent) {
239
- ancestorCmdNames = ancestorCmd.name() + " " + ancestorCmdNames;
240
- }
241
- return ancestorCmdNames + cmdName + " " + cmd.usage();
242
- }
243
- commandDescription(cmd) {
244
- return cmd.description();
245
- }
246
- subcommandDescription(cmd) {
247
- return cmd.summary() || cmd.description();
248
- }
249
- optionDescription(option) {
250
- const extraInfo = [];
251
- if (option.argChoices) {
252
- extraInfo.push(`choices: ${option.argChoices.map((choice) => JSON.stringify(choice)).join(", ")}`);
253
- }
254
- if (option.defaultValue !== undefined) {
255
- const showDefault = option.required || option.optional || option.isBoolean() && typeof option.defaultValue === "boolean";
256
- if (showDefault) {
257
- extraInfo.push(`default: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`);
258
- }
259
- }
260
- if (option.presetArg !== undefined && option.optional) {
261
- extraInfo.push(`preset: ${JSON.stringify(option.presetArg)}`);
262
- }
263
- if (option.envVar !== undefined) {
264
- extraInfo.push(`env: ${option.envVar}`);
265
- }
266
- if (extraInfo.length > 0) {
267
- return `${option.description} (${extraInfo.join(", ")})`;
268
- }
269
- return option.description;
270
- }
271
- argumentDescription(argument) {
272
- const extraInfo = [];
273
- if (argument.argChoices) {
274
- extraInfo.push(`choices: ${argument.argChoices.map((choice) => JSON.stringify(choice)).join(", ")}`);
275
- }
276
- if (argument.defaultValue !== undefined) {
277
- extraInfo.push(`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`);
278
- }
279
- if (extraInfo.length > 0) {
280
- const extraDescription = `(${extraInfo.join(", ")})`;
281
- if (argument.description) {
282
- return `${argument.description} ${extraDescription}`;
283
- }
284
- return extraDescription;
285
- }
286
- return argument.description;
287
- }
288
- formatHelp(cmd, helper) {
289
- const termWidth = helper.padWidth(cmd, helper);
290
- const helpWidth = helper.helpWidth ?? 80;
291
- function callFormatItem(term, description) {
292
- return helper.formatItem(term, termWidth, description, helper);
293
- }
294
- let output = [
295
- `${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`,
296
- ""
297
- ];
298
- const commandDescription = helper.commandDescription(cmd);
299
- if (commandDescription.length > 0) {
300
- output = output.concat([
301
- helper.boxWrap(helper.styleCommandDescription(commandDescription), helpWidth),
302
- ""
303
- ]);
304
- }
305
- const argumentList = helper.visibleArguments(cmd).map((argument) => {
306
- return callFormatItem(helper.styleArgumentTerm(helper.argumentTerm(argument)), helper.styleArgumentDescription(helper.argumentDescription(argument)));
307
- });
308
- if (argumentList.length > 0) {
309
- output = output.concat([
310
- helper.styleTitle("Arguments:"),
311
- ...argumentList,
312
- ""
313
- ]);
314
- }
315
- const optionList = helper.visibleOptions(cmd).map((option) => {
316
- return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
317
- });
318
- if (optionList.length > 0) {
319
- output = output.concat([
320
- helper.styleTitle("Options:"),
321
- ...optionList,
322
- ""
323
- ]);
324
- }
325
- if (helper.showGlobalOptions) {
326
- const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
327
- return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
328
- });
329
- if (globalOptionList.length > 0) {
330
- output = output.concat([
331
- helper.styleTitle("Global Options:"),
332
- ...globalOptionList,
333
- ""
334
- ]);
335
- }
336
- }
337
- const commandList = helper.visibleCommands(cmd).map((cmd2) => {
338
- return callFormatItem(helper.styleSubcommandTerm(helper.subcommandTerm(cmd2)), helper.styleSubcommandDescription(helper.subcommandDescription(cmd2)));
339
- });
340
- if (commandList.length > 0) {
341
- output = output.concat([
342
- helper.styleTitle("Commands:"),
343
- ...commandList,
344
- ""
345
- ]);
346
- }
347
- return output.join(`
348
- `);
349
- }
350
- displayWidth(str) {
351
- return stripColor(str).length;
352
- }
353
- styleTitle(str) {
354
- return str;
355
- }
356
- styleUsage(str) {
357
- return str.split(" ").map((word) => {
358
- if (word === "[options]")
359
- return this.styleOptionText(word);
360
- if (word === "[command]")
361
- return this.styleSubcommandText(word);
362
- if (word[0] === "[" || word[0] === "<")
363
- return this.styleArgumentText(word);
364
- return this.styleCommandText(word);
365
- }).join(" ");
366
- }
367
- styleCommandDescription(str) {
368
- return this.styleDescriptionText(str);
369
- }
370
- styleOptionDescription(str) {
371
- return this.styleDescriptionText(str);
372
- }
373
- styleSubcommandDescription(str) {
374
- return this.styleDescriptionText(str);
375
- }
376
- styleArgumentDescription(str) {
377
- return this.styleDescriptionText(str);
378
- }
379
- styleDescriptionText(str) {
380
- return str;
381
- }
382
- styleOptionTerm(str) {
383
- return this.styleOptionText(str);
384
- }
385
- styleSubcommandTerm(str) {
386
- return str.split(" ").map((word) => {
387
- if (word === "[options]")
388
- return this.styleOptionText(word);
389
- if (word[0] === "[" || word[0] === "<")
390
- return this.styleArgumentText(word);
391
- return this.styleSubcommandText(word);
392
- }).join(" ");
393
- }
394
- styleArgumentTerm(str) {
395
- return this.styleArgumentText(str);
396
- }
397
- styleOptionText(str) {
398
- return str;
399
- }
400
- styleArgumentText(str) {
401
- return str;
402
- }
403
- styleSubcommandText(str) {
404
- return str;
405
- }
406
- styleCommandText(str) {
407
- return str;
408
- }
409
- padWidth(cmd, helper) {
410
- return Math.max(helper.longestOptionTermLength(cmd, helper), helper.longestGlobalOptionTermLength(cmd, helper), helper.longestSubcommandTermLength(cmd, helper), helper.longestArgumentTermLength(cmd, helper));
411
- }
412
- preformatted(str) {
413
- return /\n[^\S\r\n]/.test(str);
414
- }
415
- formatItem(term, termWidth, description, helper) {
416
- const itemIndent = 2;
417
- const itemIndentStr = " ".repeat(itemIndent);
418
- if (!description)
419
- return itemIndentStr + term;
420
- const paddedTerm = term.padEnd(termWidth + term.length - helper.displayWidth(term));
421
- const spacerWidth = 2;
422
- const helpWidth = this.helpWidth ?? 80;
423
- const remainingWidth = helpWidth - termWidth - spacerWidth - itemIndent;
424
- let formattedDescription;
425
- if (remainingWidth < this.minWidthToWrap || helper.preformatted(description)) {
426
- formattedDescription = description;
427
- } else {
428
- const wrappedDescription = helper.boxWrap(description, remainingWidth);
429
- formattedDescription = wrappedDescription.replace(/\n/g, `
430
- ` + " ".repeat(termWidth + spacerWidth));
431
- }
432
- return itemIndentStr + paddedTerm + " ".repeat(spacerWidth) + formattedDescription.replace(/\n/g, `
433
- ${itemIndentStr}`);
434
- }
435
- boxWrap(str, width) {
436
- if (width < this.minWidthToWrap)
437
- return str;
438
- const rawLines = str.split(/\r\n|\n/);
439
- const chunkPattern = /[\s]*[^\s]+/g;
440
- const wrappedLines = [];
441
- rawLines.forEach((line) => {
442
- const chunks = line.match(chunkPattern);
443
- if (chunks === null) {
444
- wrappedLines.push("");
445
- return;
446
- }
447
- let sumChunks = [chunks.shift()];
448
- let sumWidth = this.displayWidth(sumChunks[0]);
449
- chunks.forEach((chunk) => {
450
- const visibleWidth = this.displayWidth(chunk);
451
- if (sumWidth + visibleWidth <= width) {
452
- sumChunks.push(chunk);
453
- sumWidth += visibleWidth;
454
- return;
455
- }
456
- wrappedLines.push(sumChunks.join(""));
457
- const nextChunk = chunk.trimStart();
458
- sumChunks = [nextChunk];
459
- sumWidth = this.displayWidth(nextChunk);
460
- });
461
- wrappedLines.push(sumChunks.join(""));
462
- });
463
- return wrappedLines.join(`
464
- `);
465
- }
466
- }
467
- function stripColor(str) {
468
- const sgrPattern = /\x1b\[\d*(;\d*)*m/g;
469
- return str.replace(sgrPattern, "");
470
- }
471
- exports.Help = Help;
472
- exports.stripColor = stripColor;
473
- });
474
-
475
- // node_modules/commander/lib/option.js
476
- var require_option = __commonJS((exports) => {
477
- var { InvalidArgumentError } = require_error();
478
-
479
- class Option {
480
- constructor(flags, description) {
481
- this.flags = flags;
482
- this.description = description || "";
483
- this.required = flags.includes("<");
484
- this.optional = flags.includes("[");
485
- this.variadic = /\w\.\.\.[>\]]$/.test(flags);
486
- this.mandatory = false;
487
- const optionFlags = splitOptionFlags(flags);
488
- this.short = optionFlags.shortFlag;
489
- this.long = optionFlags.longFlag;
490
- this.negate = false;
491
- if (this.long) {
492
- this.negate = this.long.startsWith("--no-");
493
- }
494
- this.defaultValue = undefined;
495
- this.defaultValueDescription = undefined;
496
- this.presetArg = undefined;
497
- this.envVar = undefined;
498
- this.parseArg = undefined;
499
- this.hidden = false;
500
- this.argChoices = undefined;
501
- this.conflictsWith = [];
502
- this.implied = undefined;
503
- }
504
- default(value, description) {
505
- this.defaultValue = value;
506
- this.defaultValueDescription = description;
507
- return this;
508
- }
509
- preset(arg) {
510
- this.presetArg = arg;
511
- return this;
512
- }
513
- conflicts(names) {
514
- this.conflictsWith = this.conflictsWith.concat(names);
515
- return this;
516
- }
517
- implies(impliedOptionValues) {
518
- let newImplied = impliedOptionValues;
519
- if (typeof impliedOptionValues === "string") {
520
- newImplied = { [impliedOptionValues]: true };
521
- }
522
- this.implied = Object.assign(this.implied || {}, newImplied);
523
- return this;
524
- }
525
- env(name) {
526
- this.envVar = name;
527
- return this;
528
- }
529
- argParser(fn) {
530
- this.parseArg = fn;
531
- return this;
532
- }
533
- makeOptionMandatory(mandatory = true) {
534
- this.mandatory = !!mandatory;
535
- return this;
536
- }
537
- hideHelp(hide = true) {
538
- this.hidden = !!hide;
539
- return this;
540
- }
541
- _concatValue(value, previous) {
542
- if (previous === this.defaultValue || !Array.isArray(previous)) {
543
- return [value];
544
- }
545
- return previous.concat(value);
546
- }
547
- choices(values) {
548
- this.argChoices = values.slice();
549
- this.parseArg = (arg, previous) => {
550
- if (!this.argChoices.includes(arg)) {
551
- throw new InvalidArgumentError(`Allowed choices are ${this.argChoices.join(", ")}.`);
552
- }
553
- if (this.variadic) {
554
- return this._concatValue(arg, previous);
555
- }
556
- return arg;
557
- };
558
- return this;
559
- }
560
- name() {
561
- if (this.long) {
562
- return this.long.replace(/^--/, "");
563
- }
564
- return this.short.replace(/^-/, "");
565
- }
566
- attributeName() {
567
- if (this.negate) {
568
- return camelcase(this.name().replace(/^no-/, ""));
569
- }
570
- return camelcase(this.name());
571
- }
572
- is(arg) {
573
- return this.short === arg || this.long === arg;
574
- }
575
- isBoolean() {
576
- return !this.required && !this.optional && !this.negate;
577
- }
578
- }
579
-
580
- class DualOptions {
581
- constructor(options) {
582
- this.positiveOptions = new Map;
583
- this.negativeOptions = new Map;
584
- this.dualOptions = new Set;
585
- options.forEach((option) => {
586
- if (option.negate) {
587
- this.negativeOptions.set(option.attributeName(), option);
588
- } else {
589
- this.positiveOptions.set(option.attributeName(), option);
590
- }
591
- });
592
- this.negativeOptions.forEach((value, key) => {
593
- if (this.positiveOptions.has(key)) {
594
- this.dualOptions.add(key);
595
- }
596
- });
597
- }
598
- valueFromOption(value, option) {
599
- const optionKey = option.attributeName();
600
- if (!this.dualOptions.has(optionKey))
601
- return true;
602
- const preset = this.negativeOptions.get(optionKey).presetArg;
603
- const negativeValue = preset !== undefined ? preset : false;
604
- return option.negate === (negativeValue === value);
605
- }
606
- }
607
- function camelcase(str) {
608
- return str.split("-").reduce((str2, word) => {
609
- return str2 + word[0].toUpperCase() + word.slice(1);
610
- });
611
- }
612
- function splitOptionFlags(flags) {
613
- let shortFlag;
614
- let longFlag;
615
- const shortFlagExp = /^-[^-]$/;
616
- const longFlagExp = /^--[^-]/;
617
- const flagParts = flags.split(/[ |,]+/).concat("guard");
618
- if (shortFlagExp.test(flagParts[0]))
619
- shortFlag = flagParts.shift();
620
- if (longFlagExp.test(flagParts[0]))
621
- longFlag = flagParts.shift();
622
- if (!shortFlag && shortFlagExp.test(flagParts[0]))
623
- shortFlag = flagParts.shift();
624
- if (!shortFlag && longFlagExp.test(flagParts[0])) {
625
- shortFlag = longFlag;
626
- longFlag = flagParts.shift();
627
- }
628
- if (flagParts[0].startsWith("-")) {
629
- const unsupportedFlag = flagParts[0];
630
- const baseError = `option creation failed due to '${unsupportedFlag}' in option flags '${flags}'`;
631
- if (/^-[^-][^-]/.test(unsupportedFlag))
632
- throw new Error(`${baseError}
633
- - a short flag is a single dash and a single character
634
- - either use a single dash and a single character (for a short flag)
635
- - or use a double dash for a long option (and can have two, like '--ws, --workspace')`);
636
- if (shortFlagExp.test(unsupportedFlag))
637
- throw new Error(`${baseError}
638
- - too many short flags`);
639
- if (longFlagExp.test(unsupportedFlag))
640
- throw new Error(`${baseError}
641
- - too many long flags`);
642
- throw new Error(`${baseError}
643
- - unrecognised flag format`);
644
- }
645
- if (shortFlag === undefined && longFlag === undefined)
646
- throw new Error(`option creation failed due to no flags found in '${flags}'.`);
647
- return { shortFlag, longFlag };
648
- }
649
- exports.Option = Option;
650
- exports.DualOptions = DualOptions;
651
- });
652
-
653
- // node_modules/commander/lib/suggestSimilar.js
654
- var require_suggestSimilar = __commonJS((exports) => {
655
- var maxDistance = 3;
656
- function editDistance(a, b) {
657
- if (Math.abs(a.length - b.length) > maxDistance)
658
- return Math.max(a.length, b.length);
659
- const d = [];
660
- for (let i = 0;i <= a.length; i++) {
661
- d[i] = [i];
662
- }
663
- for (let j = 0;j <= b.length; j++) {
664
- d[0][j] = j;
665
- }
666
- for (let j = 1;j <= b.length; j++) {
667
- for (let i = 1;i <= a.length; i++) {
668
- let cost = 1;
669
- if (a[i - 1] === b[j - 1]) {
670
- cost = 0;
671
- } else {
672
- cost = 1;
673
- }
674
- d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
675
- if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
676
- d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
677
- }
678
- }
679
- }
680
- return d[a.length][b.length];
681
- }
682
- function suggestSimilar(word, candidates) {
683
- if (!candidates || candidates.length === 0)
684
- return "";
685
- candidates = Array.from(new Set(candidates));
686
- const searchingOptions = word.startsWith("--");
687
- if (searchingOptions) {
688
- word = word.slice(2);
689
- candidates = candidates.map((candidate) => candidate.slice(2));
690
- }
691
- let similar = [];
692
- let bestDistance = maxDistance;
693
- const minSimilarity = 0.4;
694
- candidates.forEach((candidate) => {
695
- if (candidate.length <= 1)
696
- return;
697
- const distance = editDistance(word, candidate);
698
- const length = Math.max(word.length, candidate.length);
699
- const similarity = (length - distance) / length;
700
- if (similarity > minSimilarity) {
701
- if (distance < bestDistance) {
702
- bestDistance = distance;
703
- similar = [candidate];
704
- } else if (distance === bestDistance) {
705
- similar.push(candidate);
706
- }
707
- }
708
- });
709
- similar.sort((a, b) => a.localeCompare(b));
710
- if (searchingOptions) {
711
- similar = similar.map((candidate) => `--${candidate}`);
712
- }
713
- if (similar.length > 1) {
714
- return `
715
- (Did you mean one of ${similar.join(", ")}?)`;
716
- }
717
- if (similar.length === 1) {
718
- return `
719
- (Did you mean ${similar[0]}?)`;
720
- }
721
- return "";
722
- }
723
- exports.suggestSimilar = suggestSimilar;
724
- });
725
-
726
- // node_modules/commander/lib/command.js
727
- var require_command = __commonJS((exports) => {
728
- var EventEmitter = __require("events").EventEmitter;
729
- var childProcess = __require("child_process");
730
- var path = __require("path");
731
- var fs = __require("fs");
732
- var process2 = __require("process");
733
- var { Argument, humanReadableArgName } = require_argument();
734
- var { CommanderError } = require_error();
735
- var { Help, stripColor } = require_help();
736
- var { Option, DualOptions } = require_option();
737
- var { suggestSimilar } = require_suggestSimilar();
738
-
739
- class Command extends EventEmitter {
740
- constructor(name) {
741
- super();
742
- this.commands = [];
743
- this.options = [];
744
- this.parent = null;
745
- this._allowUnknownOption = false;
746
- this._allowExcessArguments = false;
747
- this.registeredArguments = [];
748
- this._args = this.registeredArguments;
749
- this.args = [];
750
- this.rawArgs = [];
751
- this.processedArgs = [];
752
- this._scriptPath = null;
753
- this._name = name || "";
754
- this._optionValues = {};
755
- this._optionValueSources = {};
756
- this._storeOptionsAsProperties = false;
757
- this._actionHandler = null;
758
- this._executableHandler = false;
759
- this._executableFile = null;
760
- this._executableDir = null;
761
- this._defaultCommandName = null;
762
- this._exitCallback = null;
763
- this._aliases = [];
764
- this._combineFlagAndOptionalValue = true;
765
- this._description = "";
766
- this._summary = "";
767
- this._argsDescription = undefined;
768
- this._enablePositionalOptions = false;
769
- this._passThroughOptions = false;
770
- this._lifeCycleHooks = {};
771
- this._showHelpAfterError = false;
772
- this._showSuggestionAfterError = true;
773
- this._savedState = null;
774
- this._outputConfiguration = {
775
- writeOut: (str) => process2.stdout.write(str),
776
- writeErr: (str) => process2.stderr.write(str),
777
- outputError: (str, write) => write(str),
778
- getOutHelpWidth: () => process2.stdout.isTTY ? process2.stdout.columns : undefined,
779
- getErrHelpWidth: () => process2.stderr.isTTY ? process2.stderr.columns : undefined,
780
- getOutHasColors: () => useColor() ?? (process2.stdout.isTTY && process2.stdout.hasColors?.()),
781
- getErrHasColors: () => useColor() ?? (process2.stderr.isTTY && process2.stderr.hasColors?.()),
782
- stripColor: (str) => stripColor(str)
783
- };
784
- this._hidden = false;
785
- this._helpOption = undefined;
786
- this._addImplicitHelpCommand = undefined;
787
- this._helpCommand = undefined;
788
- this._helpConfiguration = {};
789
- }
790
- copyInheritedSettings(sourceCommand) {
791
- this._outputConfiguration = sourceCommand._outputConfiguration;
792
- this._helpOption = sourceCommand._helpOption;
793
- this._helpCommand = sourceCommand._helpCommand;
794
- this._helpConfiguration = sourceCommand._helpConfiguration;
795
- this._exitCallback = sourceCommand._exitCallback;
796
- this._storeOptionsAsProperties = sourceCommand._storeOptionsAsProperties;
797
- this._combineFlagAndOptionalValue = sourceCommand._combineFlagAndOptionalValue;
798
- this._allowExcessArguments = sourceCommand._allowExcessArguments;
799
- this._enablePositionalOptions = sourceCommand._enablePositionalOptions;
800
- this._showHelpAfterError = sourceCommand._showHelpAfterError;
801
- this._showSuggestionAfterError = sourceCommand._showSuggestionAfterError;
802
- return this;
803
- }
804
- _getCommandAndAncestors() {
805
- const result = [];
806
- for (let command = this;command; command = command.parent) {
807
- result.push(command);
808
- }
809
- return result;
810
- }
811
- command(nameAndArgs, actionOptsOrExecDesc, execOpts) {
812
- let desc = actionOptsOrExecDesc;
813
- let opts = execOpts;
814
- if (typeof desc === "object" && desc !== null) {
815
- opts = desc;
816
- desc = null;
817
- }
818
- opts = opts || {};
819
- const [, name, args] = nameAndArgs.match(/([^ ]+) *(.*)/);
820
- const cmd = this.createCommand(name);
821
- if (desc) {
822
- cmd.description(desc);
823
- cmd._executableHandler = true;
824
- }
825
- if (opts.isDefault)
826
- this._defaultCommandName = cmd._name;
827
- cmd._hidden = !!(opts.noHelp || opts.hidden);
828
- cmd._executableFile = opts.executableFile || null;
829
- if (args)
830
- cmd.arguments(args);
831
- this._registerCommand(cmd);
832
- cmd.parent = this;
833
- cmd.copyInheritedSettings(this);
834
- if (desc)
835
- return this;
836
- return cmd;
837
- }
838
- createCommand(name) {
839
- return new Command(name);
840
- }
841
- createHelp() {
842
- return Object.assign(new Help, this.configureHelp());
843
- }
844
- configureHelp(configuration) {
845
- if (configuration === undefined)
846
- return this._helpConfiguration;
847
- this._helpConfiguration = configuration;
848
- return this;
849
- }
850
- configureOutput(configuration) {
851
- if (configuration === undefined)
852
- return this._outputConfiguration;
853
- Object.assign(this._outputConfiguration, configuration);
854
- return this;
855
- }
856
- showHelpAfterError(displayHelp = true) {
857
- if (typeof displayHelp !== "string")
858
- displayHelp = !!displayHelp;
859
- this._showHelpAfterError = displayHelp;
860
- return this;
861
- }
862
- showSuggestionAfterError(displaySuggestion = true) {
863
- this._showSuggestionAfterError = !!displaySuggestion;
864
- return this;
865
- }
866
- addCommand(cmd, opts) {
867
- if (!cmd._name) {
868
- throw new Error(`Command passed to .addCommand() must have a name
869
- - specify the name in Command constructor or using .name()`);
870
- }
871
- opts = opts || {};
872
- if (opts.isDefault)
873
- this._defaultCommandName = cmd._name;
874
- if (opts.noHelp || opts.hidden)
875
- cmd._hidden = true;
876
- this._registerCommand(cmd);
877
- cmd.parent = this;
878
- cmd._checkForBrokenPassThrough();
879
- return this;
880
- }
881
- createArgument(name, description) {
882
- return new Argument(name, description);
883
- }
884
- argument(name, description, fn, defaultValue) {
885
- const argument = this.createArgument(name, description);
886
- if (typeof fn === "function") {
887
- argument.default(defaultValue).argParser(fn);
888
- } else {
889
- argument.default(fn);
890
- }
891
- this.addArgument(argument);
892
- return this;
893
- }
894
- arguments(names) {
895
- names.trim().split(/ +/).forEach((detail) => {
896
- this.argument(detail);
897
- });
898
- return this;
899
- }
900
- addArgument(argument) {
901
- const previousArgument = this.registeredArguments.slice(-1)[0];
902
- if (previousArgument && previousArgument.variadic) {
903
- throw new Error(`only the last argument can be variadic '${previousArgument.name()}'`);
904
- }
905
- if (argument.required && argument.defaultValue !== undefined && argument.parseArg === undefined) {
906
- throw new Error(`a default value for a required argument is never used: '${argument.name()}'`);
907
- }
908
- this.registeredArguments.push(argument);
909
- return this;
910
- }
911
- helpCommand(enableOrNameAndArgs, description) {
912
- if (typeof enableOrNameAndArgs === "boolean") {
913
- this._addImplicitHelpCommand = enableOrNameAndArgs;
914
- return this;
915
- }
916
- enableOrNameAndArgs = enableOrNameAndArgs ?? "help [command]";
917
- const [, helpName, helpArgs] = enableOrNameAndArgs.match(/([^ ]+) *(.*)/);
918
- const helpDescription = description ?? "display help for command";
919
- const helpCommand = this.createCommand(helpName);
920
- helpCommand.helpOption(false);
921
- if (helpArgs)
922
- helpCommand.arguments(helpArgs);
923
- if (helpDescription)
924
- helpCommand.description(helpDescription);
925
- this._addImplicitHelpCommand = true;
926
- this._helpCommand = helpCommand;
927
- return this;
928
- }
929
- addHelpCommand(helpCommand, deprecatedDescription) {
930
- if (typeof helpCommand !== "object") {
931
- this.helpCommand(helpCommand, deprecatedDescription);
932
- return this;
933
- }
934
- this._addImplicitHelpCommand = true;
935
- this._helpCommand = helpCommand;
936
- return this;
937
- }
938
- _getHelpCommand() {
939
- const hasImplicitHelpCommand = this._addImplicitHelpCommand ?? (this.commands.length && !this._actionHandler && !this._findCommand("help"));
940
- if (hasImplicitHelpCommand) {
941
- if (this._helpCommand === undefined) {
942
- this.helpCommand(undefined, undefined);
943
- }
944
- return this._helpCommand;
945
- }
946
- return null;
947
- }
948
- hook(event, listener) {
949
- const allowedValues = ["preSubcommand", "preAction", "postAction"];
950
- if (!allowedValues.includes(event)) {
951
- throw new Error(`Unexpected value for event passed to hook : '${event}'.
952
- Expecting one of '${allowedValues.join("', '")}'`);
953
- }
954
- if (this._lifeCycleHooks[event]) {
955
- this._lifeCycleHooks[event].push(listener);
956
- } else {
957
- this._lifeCycleHooks[event] = [listener];
958
- }
959
- return this;
960
- }
961
- exitOverride(fn) {
962
- if (fn) {
963
- this._exitCallback = fn;
964
- } else {
965
- this._exitCallback = (err) => {
966
- if (err.code !== "commander.executeSubCommandAsync") {
967
- throw err;
968
- } else {}
969
- };
970
- }
971
- return this;
972
- }
973
- _exit(exitCode, code, message) {
974
- if (this._exitCallback) {
975
- this._exitCallback(new CommanderError(exitCode, code, message));
976
- }
977
- process2.exit(exitCode);
978
- }
979
- action(fn) {
980
- const listener = (args) => {
981
- const expectedArgsCount = this.registeredArguments.length;
982
- const actionArgs = args.slice(0, expectedArgsCount);
983
- if (this._storeOptionsAsProperties) {
984
- actionArgs[expectedArgsCount] = this;
985
- } else {
986
- actionArgs[expectedArgsCount] = this.opts();
987
- }
988
- actionArgs.push(this);
989
- return fn.apply(this, actionArgs);
990
- };
991
- this._actionHandler = listener;
992
- return this;
993
- }
994
- createOption(flags, description) {
995
- return new Option(flags, description);
996
- }
997
- _callParseArg(target, value, previous, invalidArgumentMessage) {
998
- try {
999
- return target.parseArg(value, previous);
1000
- } catch (err) {
1001
- if (err.code === "commander.invalidArgument") {
1002
- const message = `${invalidArgumentMessage} ${err.message}`;
1003
- this.error(message, { exitCode: err.exitCode, code: err.code });
1004
- }
1005
- throw err;
1006
- }
1007
- }
1008
- _registerOption(option) {
1009
- const matchingOption = option.short && this._findOption(option.short) || option.long && this._findOption(option.long);
1010
- if (matchingOption) {
1011
- const matchingFlag = option.long && this._findOption(option.long) ? option.long : option.short;
1012
- throw new Error(`Cannot add option '${option.flags}'${this._name && ` to command '${this._name}'`} due to conflicting flag '${matchingFlag}'
1013
- - already used by option '${matchingOption.flags}'`);
1014
- }
1015
- this.options.push(option);
1016
- }
1017
- _registerCommand(command) {
1018
- const knownBy = (cmd) => {
1019
- return [cmd.name()].concat(cmd.aliases());
1020
- };
1021
- const alreadyUsed = knownBy(command).find((name) => this._findCommand(name));
1022
- if (alreadyUsed) {
1023
- const existingCmd = knownBy(this._findCommand(alreadyUsed)).join("|");
1024
- const newCmd = knownBy(command).join("|");
1025
- throw new Error(`cannot add command '${newCmd}' as already have command '${existingCmd}'`);
1026
- }
1027
- this.commands.push(command);
1028
- }
1029
- addOption(option) {
1030
- this._registerOption(option);
1031
- const oname = option.name();
1032
- const name = option.attributeName();
1033
- if (option.negate) {
1034
- const positiveLongFlag = option.long.replace(/^--no-/, "--");
1035
- if (!this._findOption(positiveLongFlag)) {
1036
- this.setOptionValueWithSource(name, option.defaultValue === undefined ? true : option.defaultValue, "default");
1037
- }
1038
- } else if (option.defaultValue !== undefined) {
1039
- this.setOptionValueWithSource(name, option.defaultValue, "default");
1040
- }
1041
- const handleOptionValue = (val, invalidValueMessage, valueSource) => {
1042
- if (val == null && option.presetArg !== undefined) {
1043
- val = option.presetArg;
1044
- }
1045
- const oldValue = this.getOptionValue(name);
1046
- if (val !== null && option.parseArg) {
1047
- val = this._callParseArg(option, val, oldValue, invalidValueMessage);
1048
- } else if (val !== null && option.variadic) {
1049
- val = option._concatValue(val, oldValue);
1050
- }
1051
- if (val == null) {
1052
- if (option.negate) {
1053
- val = false;
1054
- } else if (option.isBoolean() || option.optional) {
1055
- val = true;
1056
- } else {
1057
- val = "";
1058
- }
1059
- }
1060
- this.setOptionValueWithSource(name, val, valueSource);
1061
- };
1062
- this.on("option:" + oname, (val) => {
1063
- const invalidValueMessage = `error: option '${option.flags}' argument '${val}' is invalid.`;
1064
- handleOptionValue(val, invalidValueMessage, "cli");
1065
- });
1066
- if (option.envVar) {
1067
- this.on("optionEnv:" + oname, (val) => {
1068
- const invalidValueMessage = `error: option '${option.flags}' value '${val}' from env '${option.envVar}' is invalid.`;
1069
- handleOptionValue(val, invalidValueMessage, "env");
1070
- });
1071
- }
1072
- return this;
1073
- }
1074
- _optionEx(config, flags, description, fn, defaultValue) {
1075
- if (typeof flags === "object" && flags instanceof Option) {
1076
- throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");
1077
- }
1078
- const option = this.createOption(flags, description);
1079
- option.makeOptionMandatory(!!config.mandatory);
1080
- if (typeof fn === "function") {
1081
- option.default(defaultValue).argParser(fn);
1082
- } else if (fn instanceof RegExp) {
1083
- const regex = fn;
1084
- fn = (val, def) => {
1085
- const m = regex.exec(val);
1086
- return m ? m[0] : def;
1087
- };
1088
- option.default(defaultValue).argParser(fn);
1089
- } else {
1090
- option.default(fn);
1091
- }
1092
- return this.addOption(option);
1093
- }
1094
- option(flags, description, parseArg, defaultValue) {
1095
- return this._optionEx({}, flags, description, parseArg, defaultValue);
1096
- }
1097
- requiredOption(flags, description, parseArg, defaultValue) {
1098
- return this._optionEx({ mandatory: true }, flags, description, parseArg, defaultValue);
1099
- }
1100
- combineFlagAndOptionalValue(combine = true) {
1101
- this._combineFlagAndOptionalValue = !!combine;
1102
- return this;
1103
- }
1104
- allowUnknownOption(allowUnknown = true) {
1105
- this._allowUnknownOption = !!allowUnknown;
1106
- return this;
1107
- }
1108
- allowExcessArguments(allowExcess = true) {
1109
- this._allowExcessArguments = !!allowExcess;
1110
- return this;
1111
- }
1112
- enablePositionalOptions(positional = true) {
1113
- this._enablePositionalOptions = !!positional;
1114
- return this;
1115
- }
1116
- passThroughOptions(passThrough = true) {
1117
- this._passThroughOptions = !!passThrough;
1118
- this._checkForBrokenPassThrough();
1119
- return this;
1120
- }
1121
- _checkForBrokenPassThrough() {
1122
- if (this.parent && this._passThroughOptions && !this.parent._enablePositionalOptions) {
1123
- throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`);
1124
- }
1125
- }
1126
- storeOptionsAsProperties(storeAsProperties = true) {
1127
- if (this.options.length) {
1128
- throw new Error("call .storeOptionsAsProperties() before adding options");
1129
- }
1130
- if (Object.keys(this._optionValues).length) {
1131
- throw new Error("call .storeOptionsAsProperties() before setting option values");
1132
- }
1133
- this._storeOptionsAsProperties = !!storeAsProperties;
1134
- return this;
1135
- }
1136
- getOptionValue(key) {
1137
- if (this._storeOptionsAsProperties) {
1138
- return this[key];
1139
- }
1140
- return this._optionValues[key];
1141
- }
1142
- setOptionValue(key, value) {
1143
- return this.setOptionValueWithSource(key, value, undefined);
1144
- }
1145
- setOptionValueWithSource(key, value, source) {
1146
- if (this._storeOptionsAsProperties) {
1147
- this[key] = value;
1148
- } else {
1149
- this._optionValues[key] = value;
1150
- }
1151
- this._optionValueSources[key] = source;
1152
- return this;
1153
- }
1154
- getOptionValueSource(key) {
1155
- return this._optionValueSources[key];
1156
- }
1157
- getOptionValueSourceWithGlobals(key) {
1158
- let source;
1159
- this._getCommandAndAncestors().forEach((cmd) => {
1160
- if (cmd.getOptionValueSource(key) !== undefined) {
1161
- source = cmd.getOptionValueSource(key);
1162
- }
1163
- });
1164
- return source;
1165
- }
1166
- _prepareUserArgs(argv, parseOptions) {
1167
- if (argv !== undefined && !Array.isArray(argv)) {
1168
- throw new Error("first parameter to parse must be array or undefined");
1169
- }
1170
- parseOptions = parseOptions || {};
1171
- if (argv === undefined && parseOptions.from === undefined) {
1172
- if (process2.versions?.electron) {
1173
- parseOptions.from = "electron";
1174
- }
1175
- const execArgv = process2.execArgv ?? [];
1176
- if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
1177
- parseOptions.from = "eval";
1178
- }
1179
- }
1180
- if (argv === undefined) {
1181
- argv = process2.argv;
1182
- }
1183
- this.rawArgs = argv.slice();
1184
- let userArgs;
1185
- switch (parseOptions.from) {
1186
- case undefined:
1187
- case "node":
1188
- this._scriptPath = argv[1];
1189
- userArgs = argv.slice(2);
1190
- break;
1191
- case "electron":
1192
- if (process2.defaultApp) {
1193
- this._scriptPath = argv[1];
1194
- userArgs = argv.slice(2);
1195
- } else {
1196
- userArgs = argv.slice(1);
1197
- }
1198
- break;
1199
- case "user":
1200
- userArgs = argv.slice(0);
1201
- break;
1202
- case "eval":
1203
- userArgs = argv.slice(1);
1204
- break;
1205
- default:
1206
- throw new Error(`unexpected parse option { from: '${parseOptions.from}' }`);
1207
- }
1208
- if (!this._name && this._scriptPath)
1209
- this.nameFromFilename(this._scriptPath);
1210
- this._name = this._name || "program";
1211
- return userArgs;
1212
- }
1213
- parse(argv, parseOptions) {
1214
- this._prepareForParse();
1215
- const userArgs = this._prepareUserArgs(argv, parseOptions);
1216
- this._parseCommand([], userArgs);
1217
- return this;
1218
- }
1219
- async parseAsync(argv, parseOptions) {
1220
- this._prepareForParse();
1221
- const userArgs = this._prepareUserArgs(argv, parseOptions);
1222
- await this._parseCommand([], userArgs);
1223
- return this;
1224
- }
1225
- _prepareForParse() {
1226
- if (this._savedState === null) {
1227
- this.saveStateBeforeParse();
1228
- } else {
1229
- this.restoreStateBeforeParse();
1230
- }
1231
- }
1232
- saveStateBeforeParse() {
1233
- this._savedState = {
1234
- _name: this._name,
1235
- _optionValues: { ...this._optionValues },
1236
- _optionValueSources: { ...this._optionValueSources }
1237
- };
1238
- }
1239
- restoreStateBeforeParse() {
1240
- if (this._storeOptionsAsProperties)
1241
- throw new Error(`Can not call parse again when storeOptionsAsProperties is true.
1242
- - either make a new Command for each call to parse, or stop storing options as properties`);
1243
- this._name = this._savedState._name;
1244
- this._scriptPath = null;
1245
- this.rawArgs = [];
1246
- this._optionValues = { ...this._savedState._optionValues };
1247
- this._optionValueSources = { ...this._savedState._optionValueSources };
1248
- this.args = [];
1249
- this.processedArgs = [];
1250
- }
1251
- _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
1252
- if (fs.existsSync(executableFile))
1253
- return;
1254
- const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
1255
- const executableMissing = `'${executableFile}' does not exist
1256
- - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
1257
- - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
1258
- - ${executableDirMessage}`;
1259
- throw new Error(executableMissing);
1260
- }
1261
- _executeSubCommand(subcommand, args) {
1262
- args = args.slice();
1263
- let launchWithNode = false;
1264
- const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
1265
- function findFile(baseDir, baseName) {
1266
- const localBin = path.resolve(baseDir, baseName);
1267
- if (fs.existsSync(localBin))
1268
- return localBin;
1269
- if (sourceExt.includes(path.extname(baseName)))
1270
- return;
1271
- const foundExt = sourceExt.find((ext) => fs.existsSync(`${localBin}${ext}`));
1272
- if (foundExt)
1273
- return `${localBin}${foundExt}`;
1274
- return;
1275
- }
1276
- this._checkForMissingMandatoryOptions();
1277
- this._checkForConflictingOptions();
1278
- let executableFile = subcommand._executableFile || `${this._name}-${subcommand._name}`;
1279
- let executableDir = this._executableDir || "";
1280
- if (this._scriptPath) {
1281
- let resolvedScriptPath;
1282
- try {
1283
- resolvedScriptPath = fs.realpathSync(this._scriptPath);
1284
- } catch {
1285
- resolvedScriptPath = this._scriptPath;
1286
- }
1287
- executableDir = path.resolve(path.dirname(resolvedScriptPath), executableDir);
1288
- }
1289
- if (executableDir) {
1290
- let localFile = findFile(executableDir, executableFile);
1291
- if (!localFile && !subcommand._executableFile && this._scriptPath) {
1292
- const legacyName = path.basename(this._scriptPath, path.extname(this._scriptPath));
1293
- if (legacyName !== this._name) {
1294
- localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
1295
- }
1296
- }
1297
- executableFile = localFile || executableFile;
1298
- }
1299
- launchWithNode = sourceExt.includes(path.extname(executableFile));
1300
- let proc;
1301
- if (process2.platform !== "win32") {
1302
- if (launchWithNode) {
1303
- args.unshift(executableFile);
1304
- args = incrementNodeInspectorPort(process2.execArgv).concat(args);
1305
- proc = childProcess.spawn(process2.argv[0], args, { stdio: "inherit" });
1306
- } else {
1307
- proc = childProcess.spawn(executableFile, args, { stdio: "inherit" });
1308
- }
1309
- } else {
1310
- this._checkForMissingExecutable(executableFile, executableDir, subcommand._name);
1311
- args.unshift(executableFile);
1312
- args = incrementNodeInspectorPort(process2.execArgv).concat(args);
1313
- proc = childProcess.spawn(process2.execPath, args, { stdio: "inherit" });
1314
- }
1315
- if (!proc.killed) {
1316
- const signals = ["SIGUSR1", "SIGUSR2", "SIGTERM", "SIGINT", "SIGHUP"];
1317
- signals.forEach((signal) => {
1318
- process2.on(signal, () => {
1319
- if (proc.killed === false && proc.exitCode === null) {
1320
- proc.kill(signal);
1321
- }
1322
- });
1323
- });
1324
- }
1325
- const exitCallback = this._exitCallback;
1326
- proc.on("close", (code) => {
1327
- code = code ?? 1;
1328
- if (!exitCallback) {
1329
- process2.exit(code);
1330
- } else {
1331
- exitCallback(new CommanderError(code, "commander.executeSubCommandAsync", "(close)"));
1332
- }
1333
- });
1334
- proc.on("error", (err) => {
1335
- if (err.code === "ENOENT") {
1336
- this._checkForMissingExecutable(executableFile, executableDir, subcommand._name);
1337
- } else if (err.code === "EACCES") {
1338
- throw new Error(`'${executableFile}' not executable`);
1339
- }
1340
- if (!exitCallback) {
1341
- process2.exit(1);
1342
- } else {
1343
- const wrappedError = new CommanderError(1, "commander.executeSubCommandAsync", "(error)");
1344
- wrappedError.nestedError = err;
1345
- exitCallback(wrappedError);
1346
- }
1347
- });
1348
- this.runningCommand = proc;
1349
- }
1350
- _dispatchSubcommand(commandName, operands, unknown) {
1351
- const subCommand = this._findCommand(commandName);
1352
- if (!subCommand)
1353
- this.help({ error: true });
1354
- subCommand._prepareForParse();
1355
- let promiseChain;
1356
- promiseChain = this._chainOrCallSubCommandHook(promiseChain, subCommand, "preSubcommand");
1357
- promiseChain = this._chainOrCall(promiseChain, () => {
1358
- if (subCommand._executableHandler) {
1359
- this._executeSubCommand(subCommand, operands.concat(unknown));
1360
- } else {
1361
- return subCommand._parseCommand(operands, unknown);
1362
- }
1363
- });
1364
- return promiseChain;
1365
- }
1366
- _dispatchHelpCommand(subcommandName) {
1367
- if (!subcommandName) {
1368
- this.help();
1369
- }
1370
- const subCommand = this._findCommand(subcommandName);
1371
- if (subCommand && !subCommand._executableHandler) {
1372
- subCommand.help();
1373
- }
1374
- return this._dispatchSubcommand(subcommandName, [], [this._getHelpOption()?.long ?? this._getHelpOption()?.short ?? "--help"]);
1375
- }
1376
- _checkNumberOfArguments() {
1377
- this.registeredArguments.forEach((arg, i) => {
1378
- if (arg.required && this.args[i] == null) {
1379
- this.missingArgument(arg.name());
1380
- }
1381
- });
1382
- if (this.registeredArguments.length > 0 && this.registeredArguments[this.registeredArguments.length - 1].variadic) {
1383
- return;
1384
- }
1385
- if (this.args.length > this.registeredArguments.length) {
1386
- this._excessArguments(this.args);
1387
- }
1388
- }
1389
- _processArguments() {
1390
- const myParseArg = (argument, value, previous) => {
1391
- let parsedValue = value;
1392
- if (value !== null && argument.parseArg) {
1393
- const invalidValueMessage = `error: command-argument value '${value}' is invalid for argument '${argument.name()}'.`;
1394
- parsedValue = this._callParseArg(argument, value, previous, invalidValueMessage);
1395
- }
1396
- return parsedValue;
1397
- };
1398
- this._checkNumberOfArguments();
1399
- const processedArgs = [];
1400
- this.registeredArguments.forEach((declaredArg, index) => {
1401
- let value = declaredArg.defaultValue;
1402
- if (declaredArg.variadic) {
1403
- if (index < this.args.length) {
1404
- value = this.args.slice(index);
1405
- if (declaredArg.parseArg) {
1406
- value = value.reduce((processed, v) => {
1407
- return myParseArg(declaredArg, v, processed);
1408
- }, declaredArg.defaultValue);
1409
- }
1410
- } else if (value === undefined) {
1411
- value = [];
1412
- }
1413
- } else if (index < this.args.length) {
1414
- value = this.args[index];
1415
- if (declaredArg.parseArg) {
1416
- value = myParseArg(declaredArg, value, declaredArg.defaultValue);
1417
- }
1418
- }
1419
- processedArgs[index] = value;
1420
- });
1421
- this.processedArgs = processedArgs;
1422
- }
1423
- _chainOrCall(promise, fn) {
1424
- if (promise && promise.then && typeof promise.then === "function") {
1425
- return promise.then(() => fn());
1426
- }
1427
- return fn();
1428
- }
1429
- _chainOrCallHooks(promise, event) {
1430
- let result = promise;
1431
- const hooks = [];
1432
- this._getCommandAndAncestors().reverse().filter((cmd) => cmd._lifeCycleHooks[event] !== undefined).forEach((hookedCommand) => {
1433
- hookedCommand._lifeCycleHooks[event].forEach((callback) => {
1434
- hooks.push({ hookedCommand, callback });
1435
- });
1436
- });
1437
- if (event === "postAction") {
1438
- hooks.reverse();
1439
- }
1440
- hooks.forEach((hookDetail) => {
1441
- result = this._chainOrCall(result, () => {
1442
- return hookDetail.callback(hookDetail.hookedCommand, this);
1443
- });
1444
- });
1445
- return result;
1446
- }
1447
- _chainOrCallSubCommandHook(promise, subCommand, event) {
1448
- let result = promise;
1449
- if (this._lifeCycleHooks[event] !== undefined) {
1450
- this._lifeCycleHooks[event].forEach((hook) => {
1451
- result = this._chainOrCall(result, () => {
1452
- return hook(this, subCommand);
1453
- });
1454
- });
1455
- }
1456
- return result;
1457
- }
1458
- _parseCommand(operands, unknown) {
1459
- const parsed = this.parseOptions(unknown);
1460
- this._parseOptionsEnv();
1461
- this._parseOptionsImplied();
1462
- operands = operands.concat(parsed.operands);
1463
- unknown = parsed.unknown;
1464
- this.args = operands.concat(unknown);
1465
- if (operands && this._findCommand(operands[0])) {
1466
- return this._dispatchSubcommand(operands[0], operands.slice(1), unknown);
1467
- }
1468
- if (this._getHelpCommand() && operands[0] === this._getHelpCommand().name()) {
1469
- return this._dispatchHelpCommand(operands[1]);
1470
- }
1471
- if (this._defaultCommandName) {
1472
- this._outputHelpIfRequested(unknown);
1473
- return this._dispatchSubcommand(this._defaultCommandName, operands, unknown);
1474
- }
1475
- if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
1476
- this.help({ error: true });
1477
- }
1478
- this._outputHelpIfRequested(parsed.unknown);
1479
- this._checkForMissingMandatoryOptions();
1480
- this._checkForConflictingOptions();
1481
- const checkForUnknownOptions = () => {
1482
- if (parsed.unknown.length > 0) {
1483
- this.unknownOption(parsed.unknown[0]);
1484
- }
1485
- };
1486
- const commandEvent = `command:${this.name()}`;
1487
- if (this._actionHandler) {
1488
- checkForUnknownOptions();
1489
- this._processArguments();
1490
- let promiseChain;
1491
- promiseChain = this._chainOrCallHooks(promiseChain, "preAction");
1492
- promiseChain = this._chainOrCall(promiseChain, () => this._actionHandler(this.processedArgs));
1493
- if (this.parent) {
1494
- promiseChain = this._chainOrCall(promiseChain, () => {
1495
- this.parent.emit(commandEvent, operands, unknown);
1496
- });
1497
- }
1498
- promiseChain = this._chainOrCallHooks(promiseChain, "postAction");
1499
- return promiseChain;
1500
- }
1501
- if (this.parent && this.parent.listenerCount(commandEvent)) {
1502
- checkForUnknownOptions();
1503
- this._processArguments();
1504
- this.parent.emit(commandEvent, operands, unknown);
1505
- } else if (operands.length) {
1506
- if (this._findCommand("*")) {
1507
- return this._dispatchSubcommand("*", operands, unknown);
1508
- }
1509
- if (this.listenerCount("command:*")) {
1510
- this.emit("command:*", operands, unknown);
1511
- } else if (this.commands.length) {
1512
- this.unknownCommand();
1513
- } else {
1514
- checkForUnknownOptions();
1515
- this._processArguments();
1516
- }
1517
- } else if (this.commands.length) {
1518
- checkForUnknownOptions();
1519
- this.help({ error: true });
1520
- } else {
1521
- checkForUnknownOptions();
1522
- this._processArguments();
1523
- }
1524
- }
1525
- _findCommand(name) {
1526
- if (!name)
1527
- return;
1528
- return this.commands.find((cmd) => cmd._name === name || cmd._aliases.includes(name));
1529
- }
1530
- _findOption(arg) {
1531
- return this.options.find((option) => option.is(arg));
1532
- }
1533
- _checkForMissingMandatoryOptions() {
1534
- this._getCommandAndAncestors().forEach((cmd) => {
1535
- cmd.options.forEach((anOption) => {
1536
- if (anOption.mandatory && cmd.getOptionValue(anOption.attributeName()) === undefined) {
1537
- cmd.missingMandatoryOptionValue(anOption);
1538
- }
1539
- });
1540
- });
1541
- }
1542
- _checkForConflictingLocalOptions() {
1543
- const definedNonDefaultOptions = this.options.filter((option) => {
1544
- const optionKey = option.attributeName();
1545
- if (this.getOptionValue(optionKey) === undefined) {
1546
- return false;
1547
- }
1548
- return this.getOptionValueSource(optionKey) !== "default";
1549
- });
1550
- const optionsWithConflicting = definedNonDefaultOptions.filter((option) => option.conflictsWith.length > 0);
1551
- optionsWithConflicting.forEach((option) => {
1552
- const conflictingAndDefined = definedNonDefaultOptions.find((defined) => option.conflictsWith.includes(defined.attributeName()));
1553
- if (conflictingAndDefined) {
1554
- this._conflictingOption(option, conflictingAndDefined);
1555
- }
1556
- });
1557
- }
1558
- _checkForConflictingOptions() {
1559
- this._getCommandAndAncestors().forEach((cmd) => {
1560
- cmd._checkForConflictingLocalOptions();
1561
- });
1562
- }
1563
- parseOptions(argv) {
1564
- const operands = [];
1565
- const unknown = [];
1566
- let dest = operands;
1567
- const args = argv.slice();
1568
- function maybeOption(arg) {
1569
- return arg.length > 1 && arg[0] === "-";
1570
- }
1571
- let activeVariadicOption = null;
1572
- while (args.length) {
1573
- const arg = args.shift();
1574
- if (arg === "--") {
1575
- if (dest === unknown)
1576
- dest.push(arg);
1577
- dest.push(...args);
1578
- break;
1579
- }
1580
- if (activeVariadicOption && !maybeOption(arg)) {
1581
- this.emit(`option:${activeVariadicOption.name()}`, arg);
1582
- continue;
1583
- }
1584
- activeVariadicOption = null;
1585
- if (maybeOption(arg)) {
1586
- const option = this._findOption(arg);
1587
- if (option) {
1588
- if (option.required) {
1589
- const value = args.shift();
1590
- if (value === undefined)
1591
- this.optionMissingArgument(option);
1592
- this.emit(`option:${option.name()}`, value);
1593
- } else if (option.optional) {
1594
- let value = null;
1595
- if (args.length > 0 && !maybeOption(args[0])) {
1596
- value = args.shift();
1597
- }
1598
- this.emit(`option:${option.name()}`, value);
1599
- } else {
1600
- this.emit(`option:${option.name()}`);
1601
- }
1602
- activeVariadicOption = option.variadic ? option : null;
1603
- continue;
1604
- }
1605
- }
1606
- if (arg.length > 2 && arg[0] === "-" && arg[1] !== "-") {
1607
- const option = this._findOption(`-${arg[1]}`);
1608
- if (option) {
1609
- if (option.required || option.optional && this._combineFlagAndOptionalValue) {
1610
- this.emit(`option:${option.name()}`, arg.slice(2));
1611
- } else {
1612
- this.emit(`option:${option.name()}`);
1613
- args.unshift(`-${arg.slice(2)}`);
1614
- }
1615
- continue;
1616
- }
1617
- }
1618
- if (/^--[^=]+=/.test(arg)) {
1619
- const index = arg.indexOf("=");
1620
- const option = this._findOption(arg.slice(0, index));
1621
- if (option && (option.required || option.optional)) {
1622
- this.emit(`option:${option.name()}`, arg.slice(index + 1));
1623
- continue;
1624
- }
1625
- }
1626
- if (maybeOption(arg)) {
1627
- dest = unknown;
1628
- }
1629
- if ((this._enablePositionalOptions || this._passThroughOptions) && operands.length === 0 && unknown.length === 0) {
1630
- if (this._findCommand(arg)) {
1631
- operands.push(arg);
1632
- if (args.length > 0)
1633
- unknown.push(...args);
1634
- break;
1635
- } else if (this._getHelpCommand() && arg === this._getHelpCommand().name()) {
1636
- operands.push(arg);
1637
- if (args.length > 0)
1638
- operands.push(...args);
1639
- break;
1640
- } else if (this._defaultCommandName) {
1641
- unknown.push(arg);
1642
- if (args.length > 0)
1643
- unknown.push(...args);
1644
- break;
1645
- }
1646
- }
1647
- if (this._passThroughOptions) {
1648
- dest.push(arg);
1649
- if (args.length > 0)
1650
- dest.push(...args);
1651
- break;
1652
- }
1653
- dest.push(arg);
1654
- }
1655
- return { operands, unknown };
1656
- }
1657
- opts() {
1658
- if (this._storeOptionsAsProperties) {
1659
- const result = {};
1660
- const len = this.options.length;
1661
- for (let i = 0;i < len; i++) {
1662
- const key = this.options[i].attributeName();
1663
- result[key] = key === this._versionOptionName ? this._version : this[key];
1664
- }
1665
- return result;
1666
- }
1667
- return this._optionValues;
1668
- }
1669
- optsWithGlobals() {
1670
- return this._getCommandAndAncestors().reduce((combinedOptions, cmd) => Object.assign(combinedOptions, cmd.opts()), {});
1671
- }
1672
- error(message, errorOptions) {
1673
- this._outputConfiguration.outputError(`${message}
1674
- `, this._outputConfiguration.writeErr);
1675
- if (typeof this._showHelpAfterError === "string") {
1676
- this._outputConfiguration.writeErr(`${this._showHelpAfterError}
1677
- `);
1678
- } else if (this._showHelpAfterError) {
1679
- this._outputConfiguration.writeErr(`
1680
- `);
1681
- this.outputHelp({ error: true });
1682
- }
1683
- const config = errorOptions || {};
1684
- const exitCode = config.exitCode || 1;
1685
- const code = config.code || "commander.error";
1686
- this._exit(exitCode, code, message);
1687
- }
1688
- _parseOptionsEnv() {
1689
- this.options.forEach((option) => {
1690
- if (option.envVar && option.envVar in process2.env) {
1691
- const optionKey = option.attributeName();
1692
- if (this.getOptionValue(optionKey) === undefined || ["default", "config", "env"].includes(this.getOptionValueSource(optionKey))) {
1693
- if (option.required || option.optional) {
1694
- this.emit(`optionEnv:${option.name()}`, process2.env[option.envVar]);
1695
- } else {
1696
- this.emit(`optionEnv:${option.name()}`);
1697
- }
1698
- }
1699
- }
1700
- });
1701
- }
1702
- _parseOptionsImplied() {
1703
- const dualHelper = new DualOptions(this.options);
1704
- const hasCustomOptionValue = (optionKey) => {
1705
- return this.getOptionValue(optionKey) !== undefined && !["default", "implied"].includes(this.getOptionValueSource(optionKey));
1706
- };
1707
- this.options.filter((option) => option.implied !== undefined && hasCustomOptionValue(option.attributeName()) && dualHelper.valueFromOption(this.getOptionValue(option.attributeName()), option)).forEach((option) => {
1708
- Object.keys(option.implied).filter((impliedKey) => !hasCustomOptionValue(impliedKey)).forEach((impliedKey) => {
1709
- this.setOptionValueWithSource(impliedKey, option.implied[impliedKey], "implied");
1710
- });
1711
- });
1712
- }
1713
- missingArgument(name) {
1714
- const message = `error: missing required argument '${name}'`;
1715
- this.error(message, { code: "commander.missingArgument" });
1716
- }
1717
- optionMissingArgument(option) {
1718
- const message = `error: option '${option.flags}' argument missing`;
1719
- this.error(message, { code: "commander.optionMissingArgument" });
1720
- }
1721
- missingMandatoryOptionValue(option) {
1722
- const message = `error: required option '${option.flags}' not specified`;
1723
- this.error(message, { code: "commander.missingMandatoryOptionValue" });
1724
- }
1725
- _conflictingOption(option, conflictingOption) {
1726
- const findBestOptionFromValue = (option2) => {
1727
- const optionKey = option2.attributeName();
1728
- const optionValue = this.getOptionValue(optionKey);
1729
- const negativeOption = this.options.find((target) => target.negate && optionKey === target.attributeName());
1730
- const positiveOption = this.options.find((target) => !target.negate && optionKey === target.attributeName());
1731
- if (negativeOption && (negativeOption.presetArg === undefined && optionValue === false || negativeOption.presetArg !== undefined && optionValue === negativeOption.presetArg)) {
1732
- return negativeOption;
1733
- }
1734
- return positiveOption || option2;
1735
- };
1736
- const getErrorMessage = (option2) => {
1737
- const bestOption = findBestOptionFromValue(option2);
1738
- const optionKey = bestOption.attributeName();
1739
- const source = this.getOptionValueSource(optionKey);
1740
- if (source === "env") {
1741
- return `environment variable '${bestOption.envVar}'`;
1742
- }
1743
- return `option '${bestOption.flags}'`;
1744
- };
1745
- const message = `error: ${getErrorMessage(option)} cannot be used with ${getErrorMessage(conflictingOption)}`;
1746
- this.error(message, { code: "commander.conflictingOption" });
1747
- }
1748
- unknownOption(flag) {
1749
- if (this._allowUnknownOption)
1750
- return;
1751
- let suggestion = "";
1752
- if (flag.startsWith("--") && this._showSuggestionAfterError) {
1753
- let candidateFlags = [];
1754
- let command = this;
1755
- do {
1756
- const moreFlags = command.createHelp().visibleOptions(command).filter((option) => option.long).map((option) => option.long);
1757
- candidateFlags = candidateFlags.concat(moreFlags);
1758
- command = command.parent;
1759
- } while (command && !command._enablePositionalOptions);
1760
- suggestion = suggestSimilar(flag, candidateFlags);
1761
- }
1762
- const message = `error: unknown option '${flag}'${suggestion}`;
1763
- this.error(message, { code: "commander.unknownOption" });
1764
- }
1765
- _excessArguments(receivedArgs) {
1766
- if (this._allowExcessArguments)
1767
- return;
1768
- const expected = this.registeredArguments.length;
1769
- const s = expected === 1 ? "" : "s";
1770
- const forSubcommand = this.parent ? ` for '${this.name()}'` : "";
1771
- const message = `error: too many arguments${forSubcommand}. Expected ${expected} argument${s} but got ${receivedArgs.length}.`;
1772
- this.error(message, { code: "commander.excessArguments" });
1773
- }
1774
- unknownCommand() {
1775
- const unknownName = this.args[0];
1776
- let suggestion = "";
1777
- if (this._showSuggestionAfterError) {
1778
- const candidateNames = [];
1779
- this.createHelp().visibleCommands(this).forEach((command) => {
1780
- candidateNames.push(command.name());
1781
- if (command.alias())
1782
- candidateNames.push(command.alias());
1783
- });
1784
- suggestion = suggestSimilar(unknownName, candidateNames);
1785
- }
1786
- const message = `error: unknown command '${unknownName}'${suggestion}`;
1787
- this.error(message, { code: "commander.unknownCommand" });
1788
- }
1789
- version(str, flags, description) {
1790
- if (str === undefined)
1791
- return this._version;
1792
- this._version = str;
1793
- flags = flags || "-V, --version";
1794
- description = description || "output the version number";
1795
- const versionOption = this.createOption(flags, description);
1796
- this._versionOptionName = versionOption.attributeName();
1797
- this._registerOption(versionOption);
1798
- this.on("option:" + versionOption.name(), () => {
1799
- this._outputConfiguration.writeOut(`${str}
1800
- `);
1801
- this._exit(0, "commander.version", str);
1802
- });
1803
- return this;
1804
- }
1805
- description(str, argsDescription) {
1806
- if (str === undefined && argsDescription === undefined)
1807
- return this._description;
1808
- this._description = str;
1809
- if (argsDescription) {
1810
- this._argsDescription = argsDescription;
1811
- }
1812
- return this;
1813
- }
1814
- summary(str) {
1815
- if (str === undefined)
1816
- return this._summary;
1817
- this._summary = str;
1818
- return this;
1819
- }
1820
- alias(alias) {
1821
- if (alias === undefined)
1822
- return this._aliases[0];
1823
- let command = this;
1824
- if (this.commands.length !== 0 && this.commands[this.commands.length - 1]._executableHandler) {
1825
- command = this.commands[this.commands.length - 1];
1826
- }
1827
- if (alias === command._name)
1828
- throw new Error("Command alias can't be the same as its name");
1829
- const matchingCommand = this.parent?._findCommand(alias);
1830
- if (matchingCommand) {
1831
- const existingCmd = [matchingCommand.name()].concat(matchingCommand.aliases()).join("|");
1832
- throw new Error(`cannot add alias '${alias}' to command '${this.name()}' as already have command '${existingCmd}'`);
1833
- }
1834
- command._aliases.push(alias);
1835
- return this;
1836
- }
1837
- aliases(aliases) {
1838
- if (aliases === undefined)
1839
- return this._aliases;
1840
- aliases.forEach((alias) => this.alias(alias));
1841
- return this;
1842
- }
1843
- usage(str) {
1844
- if (str === undefined) {
1845
- if (this._usage)
1846
- return this._usage;
1847
- const args = this.registeredArguments.map((arg) => {
1848
- return humanReadableArgName(arg);
1849
- });
1850
- return [].concat(this.options.length || this._helpOption !== null ? "[options]" : [], this.commands.length ? "[command]" : [], this.registeredArguments.length ? args : []).join(" ");
1851
- }
1852
- this._usage = str;
1853
- return this;
1854
- }
1855
- name(str) {
1856
- if (str === undefined)
1857
- return this._name;
1858
- this._name = str;
1859
- return this;
1860
- }
1861
- nameFromFilename(filename) {
1862
- this._name = path.basename(filename, path.extname(filename));
1863
- return this;
1864
- }
1865
- executableDir(path2) {
1866
- if (path2 === undefined)
1867
- return this._executableDir;
1868
- this._executableDir = path2;
1869
- return this;
1870
- }
1871
- helpInformation(contextOptions) {
1872
- const helper = this.createHelp();
1873
- const context = this._getOutputContext(contextOptions);
1874
- helper.prepareContext({
1875
- error: context.error,
1876
- helpWidth: context.helpWidth,
1877
- outputHasColors: context.hasColors
1878
- });
1879
- const text = helper.formatHelp(this, helper);
1880
- if (context.hasColors)
1881
- return text;
1882
- return this._outputConfiguration.stripColor(text);
1883
- }
1884
- _getOutputContext(contextOptions) {
1885
- contextOptions = contextOptions || {};
1886
- const error = !!contextOptions.error;
1887
- let baseWrite;
1888
- let hasColors;
1889
- let helpWidth;
1890
- if (error) {
1891
- baseWrite = (str) => this._outputConfiguration.writeErr(str);
1892
- hasColors = this._outputConfiguration.getErrHasColors();
1893
- helpWidth = this._outputConfiguration.getErrHelpWidth();
1894
- } else {
1895
- baseWrite = (str) => this._outputConfiguration.writeOut(str);
1896
- hasColors = this._outputConfiguration.getOutHasColors();
1897
- helpWidth = this._outputConfiguration.getOutHelpWidth();
1898
- }
1899
- const write = (str) => {
1900
- if (!hasColors)
1901
- str = this._outputConfiguration.stripColor(str);
1902
- return baseWrite(str);
1903
- };
1904
- return { error, write, hasColors, helpWidth };
1905
- }
1906
- outputHelp(contextOptions) {
1907
- let deprecatedCallback;
1908
- if (typeof contextOptions === "function") {
1909
- deprecatedCallback = contextOptions;
1910
- contextOptions = undefined;
1911
- }
1912
- const outputContext = this._getOutputContext(contextOptions);
1913
- const eventContext = {
1914
- error: outputContext.error,
1915
- write: outputContext.write,
1916
- command: this
1917
- };
1918
- this._getCommandAndAncestors().reverse().forEach((command) => command.emit("beforeAllHelp", eventContext));
1919
- this.emit("beforeHelp", eventContext);
1920
- let helpInformation = this.helpInformation({ error: outputContext.error });
1921
- if (deprecatedCallback) {
1922
- helpInformation = deprecatedCallback(helpInformation);
1923
- if (typeof helpInformation !== "string" && !Buffer.isBuffer(helpInformation)) {
1924
- throw new Error("outputHelp callback must return a string or a Buffer");
1925
- }
1926
- }
1927
- outputContext.write(helpInformation);
1928
- if (this._getHelpOption()?.long) {
1929
- this.emit(this._getHelpOption().long);
1930
- }
1931
- this.emit("afterHelp", eventContext);
1932
- this._getCommandAndAncestors().forEach((command) => command.emit("afterAllHelp", eventContext));
1933
- }
1934
- helpOption(flags, description) {
1935
- if (typeof flags === "boolean") {
1936
- if (flags) {
1937
- this._helpOption = this._helpOption ?? undefined;
1938
- } else {
1939
- this._helpOption = null;
1940
- }
1941
- return this;
1942
- }
1943
- flags = flags ?? "-h, --help";
1944
- description = description ?? "display help for command";
1945
- this._helpOption = this.createOption(flags, description);
1946
- return this;
1947
- }
1948
- _getHelpOption() {
1949
- if (this._helpOption === undefined) {
1950
- this.helpOption(undefined, undefined);
1951
- }
1952
- return this._helpOption;
1953
- }
1954
- addHelpOption(option) {
1955
- this._helpOption = option;
1956
- return this;
1957
- }
1958
- help(contextOptions) {
1959
- this.outputHelp(contextOptions);
1960
- let exitCode = Number(process2.exitCode ?? 0);
1961
- if (exitCode === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
1962
- exitCode = 1;
1963
- }
1964
- this._exit(exitCode, "commander.help", "(outputHelp)");
1965
- }
1966
- addHelpText(position, text) {
1967
- const allowedValues = ["beforeAll", "before", "after", "afterAll"];
1968
- if (!allowedValues.includes(position)) {
1969
- throw new Error(`Unexpected value for position to addHelpText.
1970
- Expecting one of '${allowedValues.join("', '")}'`);
1971
- }
1972
- const helpEvent = `${position}Help`;
1973
- this.on(helpEvent, (context) => {
1974
- let helpStr;
1975
- if (typeof text === "function") {
1976
- helpStr = text({ error: context.error, command: context.command });
1977
- } else {
1978
- helpStr = text;
1979
- }
1980
- if (helpStr) {
1981
- context.write(`${helpStr}
1982
- `);
1983
- }
1984
- });
1985
- return this;
1986
- }
1987
- _outputHelpIfRequested(args) {
1988
- const helpOption = this._getHelpOption();
1989
- const helpRequested = helpOption && args.find((arg) => helpOption.is(arg));
1990
- if (helpRequested) {
1991
- this.outputHelp();
1992
- this._exit(0, "commander.helpDisplayed", "(outputHelp)");
1993
- }
1994
- }
1995
- }
1996
- function incrementNodeInspectorPort(args) {
1997
- return args.map((arg) => {
1998
- if (!arg.startsWith("--inspect")) {
1999
- return arg;
2000
- }
2001
- let debugOption;
2002
- let debugHost = "127.0.0.1";
2003
- let debugPort = "9229";
2004
- let match;
2005
- if ((match = arg.match(/^(--inspect(-brk)?)$/)) !== null) {
2006
- debugOption = match[1];
2007
- } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+)$/)) !== null) {
2008
- debugOption = match[1];
2009
- if (/^\d+$/.test(match[3])) {
2010
- debugPort = match[3];
2011
- } else {
2012
- debugHost = match[3];
2013
- }
2014
- } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/)) !== null) {
2015
- debugOption = match[1];
2016
- debugHost = match[3];
2017
- debugPort = match[4];
2018
- }
2019
- if (debugOption && debugPort !== "0") {
2020
- return `${debugOption}=${debugHost}:${parseInt(debugPort) + 1}`;
2021
- }
2022
- return arg;
2023
- });
2024
- }
2025
- function useColor() {
2026
- if (process2.env.NO_COLOR || process2.env.FORCE_COLOR === "0" || process2.env.FORCE_COLOR === "false")
2027
- return false;
2028
- if (process2.env.FORCE_COLOR || process2.env.CLICOLOR_FORCE !== undefined)
2029
- return true;
2030
- return;
2031
- }
2032
- exports.Command = Command;
2033
- exports.useColor = useColor;
2034
- });
2035
-
2036
- // node_modules/commander/index.js
2037
- var require_commander = __commonJS((exports) => {
2038
- var { Argument } = require_argument();
2039
- var { Command } = require_command();
2040
- var { CommanderError, InvalidArgumentError } = require_error();
2041
- var { Help } = require_help();
2042
- var { Option } = require_option();
2043
- exports.program = new Command;
2044
- exports.createCommand = (name) => new Command(name);
2045
- exports.createOption = (flags, description) => new Option(flags, description);
2046
- exports.createArgument = (name, description) => new Argument(name, description);
2047
- exports.Command = Command;
2048
- exports.Option = Option;
2049
- exports.Argument = Argument;
2050
- exports.Help = Help;
2051
- exports.CommanderError = CommanderError;
2052
- exports.InvalidArgumentError = InvalidArgumentError;
2053
- exports.InvalidOptionArgumentError = InvalidArgumentError;
2054
- });
2055
-
2056
- // node_modules/commander/esm.mjs
2057
- var import__ = __toESM(require_commander(), 1);
2058
- var {
2059
- program,
2060
- createCommand,
2061
- createArgument,
2062
- createOption,
2063
- CommanderError,
2064
- InvalidArgumentError,
2065
- InvalidOptionArgumentError,
2066
- Command,
2067
- Argument,
2068
- Option,
2069
- Help
2070
- } = import__.default;
2071
-
2072
- // node_modules/chalk/source/vendor/ansi-styles/index.js
2073
- var ANSI_BACKGROUND_OFFSET = 10;
2074
- var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
2075
- var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
2076
- var wrapAnsi16m = (offset = 0) => (red, green, blue) => `\x1B[${38 + offset};2;${red};${green};${blue}m`;
2077
- var styles = {
2078
- modifier: {
2079
- reset: [0, 0],
2080
- bold: [1, 22],
2081
- dim: [2, 22],
2082
- italic: [3, 23],
2083
- underline: [4, 24],
2084
- overline: [53, 55],
2085
- inverse: [7, 27],
2086
- hidden: [8, 28],
2087
- strikethrough: [9, 29]
2088
- },
2089
- color: {
2090
- black: [30, 39],
2091
- red: [31, 39],
2092
- green: [32, 39],
2093
- yellow: [33, 39],
2094
- blue: [34, 39],
2095
- magenta: [35, 39],
2096
- cyan: [36, 39],
2097
- white: [37, 39],
2098
- blackBright: [90, 39],
2099
- gray: [90, 39],
2100
- grey: [90, 39],
2101
- redBright: [91, 39],
2102
- greenBright: [92, 39],
2103
- yellowBright: [93, 39],
2104
- blueBright: [94, 39],
2105
- magentaBright: [95, 39],
2106
- cyanBright: [96, 39],
2107
- whiteBright: [97, 39]
2108
- },
2109
- bgColor: {
2110
- bgBlack: [40, 49],
2111
- bgRed: [41, 49],
2112
- bgGreen: [42, 49],
2113
- bgYellow: [43, 49],
2114
- bgBlue: [44, 49],
2115
- bgMagenta: [45, 49],
2116
- bgCyan: [46, 49],
2117
- bgWhite: [47, 49],
2118
- bgBlackBright: [100, 49],
2119
- bgGray: [100, 49],
2120
- bgGrey: [100, 49],
2121
- bgRedBright: [101, 49],
2122
- bgGreenBright: [102, 49],
2123
- bgYellowBright: [103, 49],
2124
- bgBlueBright: [104, 49],
2125
- bgMagentaBright: [105, 49],
2126
- bgCyanBright: [106, 49],
2127
- bgWhiteBright: [107, 49]
2128
- }
2129
- };
2130
- var modifierNames = Object.keys(styles.modifier);
2131
- var foregroundColorNames = Object.keys(styles.color);
2132
- var backgroundColorNames = Object.keys(styles.bgColor);
2133
- var colorNames = [...foregroundColorNames, ...backgroundColorNames];
2134
- function assembleStyles() {
2135
- const codes = new Map;
2136
- for (const [groupName, group] of Object.entries(styles)) {
2137
- for (const [styleName, style] of Object.entries(group)) {
2138
- styles[styleName] = {
2139
- open: `\x1B[${style[0]}m`,
2140
- close: `\x1B[${style[1]}m`
2141
- };
2142
- group[styleName] = styles[styleName];
2143
- codes.set(style[0], style[1]);
2144
- }
2145
- Object.defineProperty(styles, groupName, {
2146
- value: group,
2147
- enumerable: false
2148
- });
2149
- }
2150
- Object.defineProperty(styles, "codes", {
2151
- value: codes,
2152
- enumerable: false
2153
- });
2154
- styles.color.close = "\x1B[39m";
2155
- styles.bgColor.close = "\x1B[49m";
2156
- styles.color.ansi = wrapAnsi16();
2157
- styles.color.ansi256 = wrapAnsi256();
2158
- styles.color.ansi16m = wrapAnsi16m();
2159
- styles.bgColor.ansi = wrapAnsi16(ANSI_BACKGROUND_OFFSET);
2160
- styles.bgColor.ansi256 = wrapAnsi256(ANSI_BACKGROUND_OFFSET);
2161
- styles.bgColor.ansi16m = wrapAnsi16m(ANSI_BACKGROUND_OFFSET);
2162
- Object.defineProperties(styles, {
2163
- rgbToAnsi256: {
2164
- value(red, green, blue) {
2165
- if (red === green && green === blue) {
2166
- if (red < 8) {
2167
- return 16;
2168
- }
2169
- if (red > 248) {
2170
- return 231;
2171
- }
2172
- return Math.round((red - 8) / 247 * 24) + 232;
2173
- }
2174
- return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green / 255 * 5) + Math.round(blue / 255 * 5);
2175
- },
2176
- enumerable: false
2177
- },
2178
- hexToRgb: {
2179
- value(hex) {
2180
- const matches = /[a-f\d]{6}|[a-f\d]{3}/i.exec(hex.toString(16));
2181
- if (!matches) {
2182
- return [0, 0, 0];
2183
- }
2184
- let [colorString] = matches;
2185
- if (colorString.length === 3) {
2186
- colorString = [...colorString].map((character) => character + character).join("");
2187
- }
2188
- const integer = Number.parseInt(colorString, 16);
2189
- return [
2190
- integer >> 16 & 255,
2191
- integer >> 8 & 255,
2192
- integer & 255
2193
- ];
2194
- },
2195
- enumerable: false
2196
- },
2197
- hexToAnsi256: {
2198
- value: (hex) => styles.rgbToAnsi256(...styles.hexToRgb(hex)),
2199
- enumerable: false
2200
- },
2201
- ansi256ToAnsi: {
2202
- value(code) {
2203
- if (code < 8) {
2204
- return 30 + code;
2205
- }
2206
- if (code < 16) {
2207
- return 90 + (code - 8);
2208
- }
2209
- let red;
2210
- let green;
2211
- let blue;
2212
- if (code >= 232) {
2213
- red = ((code - 232) * 10 + 8) / 255;
2214
- green = red;
2215
- blue = red;
2216
- } else {
2217
- code -= 16;
2218
- const remainder = code % 36;
2219
- red = Math.floor(code / 36) / 5;
2220
- green = Math.floor(remainder / 6) / 5;
2221
- blue = remainder % 6 / 5;
2222
- }
2223
- const value = Math.max(red, green, blue) * 2;
2224
- if (value === 0) {
2225
- return 30;
2226
- }
2227
- let result = 30 + (Math.round(blue) << 2 | Math.round(green) << 1 | Math.round(red));
2228
- if (value === 2) {
2229
- result += 60;
2230
- }
2231
- return result;
2232
- },
2233
- enumerable: false
2234
- },
2235
- rgbToAnsi: {
2236
- value: (red, green, blue) => styles.ansi256ToAnsi(styles.rgbToAnsi256(red, green, blue)),
2237
- enumerable: false
2238
- },
2239
- hexToAnsi: {
2240
- value: (hex) => styles.ansi256ToAnsi(styles.hexToAnsi256(hex)),
2241
- enumerable: false
2242
- }
2243
- });
2244
- return styles;
2245
- }
2246
- var ansiStyles = assembleStyles();
2247
- var ansi_styles_default = ansiStyles;
2248
-
2249
- // node_modules/chalk/source/vendor/supports-color/index.js
2250
- import process2 from "process";
2251
- import os from "os";
2252
- import tty from "tty";
2253
- function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process2.argv) {
2254
- const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
2255
- const position = argv.indexOf(prefix + flag);
2256
- const terminatorPosition = argv.indexOf("--");
2257
- return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
2258
- }
2259
- var { env } = process2;
2260
- var flagForceColor;
2261
- if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
2262
- flagForceColor = 0;
2263
- } else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
2264
- flagForceColor = 1;
2265
- }
2266
- function envForceColor() {
2267
- if ("FORCE_COLOR" in env) {
2268
- if (env.FORCE_COLOR === "true") {
2269
- return 1;
2270
- }
2271
- if (env.FORCE_COLOR === "false") {
2272
- return 0;
2273
- }
2274
- return env.FORCE_COLOR.length === 0 ? 1 : Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
2275
- }
2276
- }
2277
- function translateLevel(level) {
2278
- if (level === 0) {
2279
- return false;
2280
- }
2281
- return {
2282
- level,
2283
- hasBasic: true,
2284
- has256: level >= 2,
2285
- has16m: level >= 3
2286
- };
2287
- }
2288
- function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
2289
- const noFlagForceColor = envForceColor();
2290
- if (noFlagForceColor !== undefined) {
2291
- flagForceColor = noFlagForceColor;
2292
- }
2293
- const forceColor = sniffFlags ? flagForceColor : noFlagForceColor;
2294
- if (forceColor === 0) {
2295
- return 0;
2296
- }
2297
- if (sniffFlags) {
2298
- if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
2299
- return 3;
2300
- }
2301
- if (hasFlag("color=256")) {
2302
- return 2;
2303
- }
2304
- }
2305
- if ("TF_BUILD" in env && "AGENT_NAME" in env) {
2306
- return 1;
2307
- }
2308
- if (haveStream && !streamIsTTY && forceColor === undefined) {
2309
- return 0;
2310
- }
2311
- const min = forceColor || 0;
2312
- if (env.TERM === "dumb") {
2313
- return min;
2314
- }
2315
- if (process2.platform === "win32") {
2316
- const osRelease = os.release().split(".");
2317
- if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
2318
- return Number(osRelease[2]) >= 14931 ? 3 : 2;
2319
- }
2320
- return 1;
2321
- }
2322
- if ("CI" in env) {
2323
- if (["GITHUB_ACTIONS", "GITEA_ACTIONS", "CIRCLECI"].some((key) => (key in env))) {
2324
- return 3;
2325
- }
2326
- if (["TRAVIS", "APPVEYOR", "GITLAB_CI", "BUILDKITE", "DRONE"].some((sign) => (sign in env)) || env.CI_NAME === "codeship") {
2327
- return 1;
2328
- }
2329
- return min;
2330
- }
2331
- if ("TEAMCITY_VERSION" in env) {
2332
- return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
2333
- }
2334
- if (env.COLORTERM === "truecolor") {
2335
- return 3;
2336
- }
2337
- if (env.TERM === "xterm-kitty") {
2338
- return 3;
2339
- }
2340
- if (env.TERM === "xterm-ghostty") {
2341
- return 3;
2342
- }
2343
- if (env.TERM === "wezterm") {
2344
- return 3;
2345
- }
2346
- if ("TERM_PROGRAM" in env) {
2347
- const version = Number.parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
2348
- switch (env.TERM_PROGRAM) {
2349
- case "iTerm.app": {
2350
- return version >= 3 ? 3 : 2;
2351
- }
2352
- case "Apple_Terminal": {
2353
- return 2;
2354
- }
2355
- }
2356
- }
2357
- if (/-256(color)?$/i.test(env.TERM)) {
2358
- return 2;
2359
- }
2360
- if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
2361
- return 1;
2362
- }
2363
- if ("COLORTERM" in env) {
2364
- return 1;
2365
- }
2366
- return min;
2367
- }
2368
- function createSupportsColor(stream, options = {}) {
2369
- const level = _supportsColor(stream, {
2370
- streamIsTTY: stream && stream.isTTY,
2371
- ...options
2372
- });
2373
- return translateLevel(level);
2374
- }
2375
- var supportsColor = {
2376
- stdout: createSupportsColor({ isTTY: tty.isatty(1) }),
2377
- stderr: createSupportsColor({ isTTY: tty.isatty(2) })
2378
- };
2379
- var supports_color_default = supportsColor;
2380
-
2381
- // node_modules/chalk/source/utilities.js
2382
- function stringReplaceAll(string, substring, replacer) {
2383
- let index = string.indexOf(substring);
2384
- if (index === -1) {
2385
- return string;
2386
- }
2387
- const substringLength = substring.length;
2388
- let endIndex = 0;
2389
- let returnValue = "";
2390
- do {
2391
- returnValue += string.slice(endIndex, index) + substring + replacer;
2392
- endIndex = index + substringLength;
2393
- index = string.indexOf(substring, endIndex);
2394
- } while (index !== -1);
2395
- returnValue += string.slice(endIndex);
2396
- return returnValue;
2397
- }
2398
- function stringEncaseCRLFWithFirstIndex(string, prefix, postfix, index) {
2399
- let endIndex = 0;
2400
- let returnValue = "";
2401
- do {
2402
- const gotCR = string[index - 1] === "\r";
2403
- returnValue += string.slice(endIndex, gotCR ? index - 1 : index) + prefix + (gotCR ? `\r
2404
- ` : `
2405
- `) + postfix;
2406
- endIndex = index + 1;
2407
- index = string.indexOf(`
2408
- `, endIndex);
2409
- } while (index !== -1);
2410
- returnValue += string.slice(endIndex);
2411
- return returnValue;
2412
- }
2413
-
2414
- // node_modules/chalk/source/index.js
2415
- var { stdout: stdoutColor, stderr: stderrColor } = supports_color_default;
2416
- var GENERATOR = Symbol("GENERATOR");
2417
- var STYLER = Symbol("STYLER");
2418
- var IS_EMPTY = Symbol("IS_EMPTY");
2419
- var levelMapping = [
2420
- "ansi",
2421
- "ansi",
2422
- "ansi256",
2423
- "ansi16m"
2424
- ];
2425
- var styles2 = Object.create(null);
2426
- var applyOptions = (object, options = {}) => {
2427
- if (options.level && !(Number.isInteger(options.level) && options.level >= 0 && options.level <= 3)) {
2428
- throw new Error("The `level` option should be an integer from 0 to 3");
2429
- }
2430
- const colorLevel = stdoutColor ? stdoutColor.level : 0;
2431
- object.level = options.level === undefined ? colorLevel : options.level;
2432
- };
2433
- var chalkFactory = (options) => {
2434
- const chalk = (...strings) => strings.join(" ");
2435
- applyOptions(chalk, options);
2436
- Object.setPrototypeOf(chalk, createChalk.prototype);
2437
- return chalk;
2438
- };
2439
- function createChalk(options) {
2440
- return chalkFactory(options);
2441
- }
2442
- Object.setPrototypeOf(createChalk.prototype, Function.prototype);
2443
- for (const [styleName, style] of Object.entries(ansi_styles_default)) {
2444
- styles2[styleName] = {
2445
- get() {
2446
- const builder = createBuilder(this, createStyler(style.open, style.close, this[STYLER]), this[IS_EMPTY]);
2447
- Object.defineProperty(this, styleName, { value: builder });
2448
- return builder;
2449
- }
2450
- };
2451
- }
2452
- styles2.visible = {
2453
- get() {
2454
- const builder = createBuilder(this, this[STYLER], true);
2455
- Object.defineProperty(this, "visible", { value: builder });
2456
- return builder;
2457
- }
2458
- };
2459
- var getModelAnsi = (model, level, type, ...arguments_) => {
2460
- if (model === "rgb") {
2461
- if (level === "ansi16m") {
2462
- return ansi_styles_default[type].ansi16m(...arguments_);
2463
- }
2464
- if (level === "ansi256") {
2465
- return ansi_styles_default[type].ansi256(ansi_styles_default.rgbToAnsi256(...arguments_));
2466
- }
2467
- return ansi_styles_default[type].ansi(ansi_styles_default.rgbToAnsi(...arguments_));
2468
- }
2469
- if (model === "hex") {
2470
- return getModelAnsi("rgb", level, type, ...ansi_styles_default.hexToRgb(...arguments_));
2471
- }
2472
- return ansi_styles_default[type][model](...arguments_);
2473
- };
2474
- var usedModels = ["rgb", "hex", "ansi256"];
2475
- for (const model of usedModels) {
2476
- styles2[model] = {
2477
- get() {
2478
- const { level } = this;
2479
- return function(...arguments_) {
2480
- const styler = createStyler(getModelAnsi(model, levelMapping[level], "color", ...arguments_), ansi_styles_default.color.close, this[STYLER]);
2481
- return createBuilder(this, styler, this[IS_EMPTY]);
2482
- };
2483
- }
2484
- };
2485
- const bgModel = "bg" + model[0].toUpperCase() + model.slice(1);
2486
- styles2[bgModel] = {
2487
- get() {
2488
- const { level } = this;
2489
- return function(...arguments_) {
2490
- const styler = createStyler(getModelAnsi(model, levelMapping[level], "bgColor", ...arguments_), ansi_styles_default.bgColor.close, this[STYLER]);
2491
- return createBuilder(this, styler, this[IS_EMPTY]);
2492
- };
2493
- }
2494
- };
2495
- }
2496
- var proto = Object.defineProperties(() => {}, {
2497
- ...styles2,
2498
- level: {
2499
- enumerable: true,
2500
- get() {
2501
- return this[GENERATOR].level;
2502
- },
2503
- set(level) {
2504
- this[GENERATOR].level = level;
2505
- }
2506
- }
2507
- });
2508
- var createStyler = (open, close, parent) => {
2509
- let openAll;
2510
- let closeAll;
2511
- if (parent === undefined) {
2512
- openAll = open;
2513
- closeAll = close;
2514
- } else {
2515
- openAll = parent.openAll + open;
2516
- closeAll = close + parent.closeAll;
2517
- }
2518
- return {
2519
- open,
2520
- close,
2521
- openAll,
2522
- closeAll,
2523
- parent
2524
- };
2525
- };
2526
- var createBuilder = (self, _styler, _isEmpty) => {
2527
- const builder = (...arguments_) => applyStyle(builder, arguments_.length === 1 ? "" + arguments_[0] : arguments_.join(" "));
2528
- Object.setPrototypeOf(builder, proto);
2529
- builder[GENERATOR] = self;
2530
- builder[STYLER] = _styler;
2531
- builder[IS_EMPTY] = _isEmpty;
2532
- return builder;
2533
- };
2534
- var applyStyle = (self, string) => {
2535
- if (self.level <= 0 || !string) {
2536
- return self[IS_EMPTY] ? "" : string;
2537
- }
2538
- let styler = self[STYLER];
2539
- if (styler === undefined) {
2540
- return string;
2541
- }
2542
- const { openAll, closeAll } = styler;
2543
- if (string.includes("\x1B")) {
2544
- while (styler !== undefined) {
2545
- string = stringReplaceAll(string, styler.close, styler.open);
2546
- styler = styler.parent;
2547
- }
2548
- }
2549
- const lfIndex = string.indexOf(`
2550
- `);
2551
- if (lfIndex !== -1) {
2552
- string = stringEncaseCRLFWithFirstIndex(string, closeAll, openAll, lfIndex);
2553
- }
2554
- return openAll + string + closeAll;
2555
- };
2556
- Object.defineProperties(createChalk.prototype, styles2);
2557
- var chalk = createChalk();
2558
- var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
2559
- var source_default = chalk;
2560
-
2561
- // src/cli/index.ts
2562
- import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
2563
- import { dirname as dirname3, join as join5 } from "path";
2564
- import { fileURLToPath } from "url";
2565
- import { spawnSync as spawnSync3 } from "child_process";
2566
-
2567
- // src/store.ts
2568
- import { createHash } from "crypto";
2569
-
2570
- // src/database.ts
2571
- import { Database } from "bun:sqlite";
2572
- import { mkdirSync as mkdirSync2 } from "fs";
2573
- import { dirname as dirname2 } from "path";
2574
-
2575
- // src/config.ts
2576
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
2577
- import { homedir } from "os";
2578
- import { dirname, join, resolve } from "path";
2579
- var SERVICE_NAME = "shortlinks";
2580
- var DEFAULT_DATA_DIR = join(homedir(), ".hasna", SERVICE_NAME);
2581
- function getDataDir() {
2582
- return resolve(process.env.SHORTLINKS_HOME || DEFAULT_DATA_DIR);
2583
- }
2584
- function ensureDataDir() {
2585
- const dir = getDataDir();
2586
- mkdirSync(dir, { recursive: true });
2587
- return dir;
2588
- }
2589
- function getConfigPath() {
2590
- return join(ensureDataDir(), "config.json");
2591
- }
2592
- function getDatabasePath(explicitPath) {
2593
- if (explicitPath)
2594
- return resolve(explicitPath);
2595
- if (process.env.SHORTLINKS_DB)
2596
- return resolve(process.env.SHORTLINKS_DB);
2597
- return join(ensureDataDir(), `${SERVICE_NAME}.db`);
2598
- }
2599
- function loadConfig() {
2600
- const path = getConfigPath();
2601
- if (!existsSync(path))
2602
- return {};
2603
- try {
2604
- const parsed = JSON.parse(readFileSync(path, "utf-8"));
2605
- return parsed && typeof parsed === "object" ? parsed : {};
2606
- } catch {
2607
- return {};
2608
- }
2609
- }
2610
- function saveConfig(config) {
2611
- const path = getConfigPath();
2612
- mkdirSync(dirname(path), { recursive: true });
2613
- writeFileSync(path, `${JSON.stringify(config, null, 2)}
2614
- `);
2615
- }
2616
- function updateConfig(patch) {
2617
- const next = {
2618
- ...loadConfig(),
2619
- ...patch,
2620
- cloudflare: {
2621
- ...loadConfig().cloudflare,
2622
- ...patch.cloudflare
2623
- }
2624
- };
2625
- saveConfig(next);
2626
- return next;
2627
- }
2628
- function normalizeHostname(input) {
2629
- const raw = input.trim().toLowerCase();
2630
- if (!raw)
2631
- throw new Error("Domain is required.");
2632
- const withProtocol = raw.includes("://") ? raw : `https://${raw}`;
2633
- let hostname;
2634
- try {
2635
- hostname = new URL(withProtocol).hostname;
2636
- } catch {
2637
- throw new Error(`Invalid domain: ${input}`);
2638
- }
2639
- hostname = hostname.replace(/\.$/, "");
2640
- if (!/^[a-z0-9.-]+$/.test(hostname) || hostname.includes("..")) {
2641
- throw new Error(`Invalid domain: ${input}`);
2642
- }
2643
- return hostname;
2644
- }
2645
- function formatShortUrl(hostname, slug, publicBaseUrl) {
2646
- if (publicBaseUrl) {
2647
- const base = publicBaseUrl.endsWith("/") ? publicBaseUrl : `${publicBaseUrl}/`;
2648
- return new URL(slug, base).toString();
2649
- }
2650
- return `https://${hostname}/${slug}`;
2651
- }
2652
-
2653
- // src/database.ts
2654
- function now() {
2655
- return new Date().toISOString();
2656
- }
2657
- function makeId(prefix) {
2658
- const bytes = crypto.getRandomValues(new Uint8Array(12));
2659
- const hex = [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
2660
- return `${prefix}_${hex}`;
2661
- }
2662
- var SQLITE_MIGRATIONS = [
2663
- `
2664
- CREATE TABLE IF NOT EXISTS domains (
2665
- id TEXT PRIMARY KEY,
2666
- hostname TEXT NOT NULL UNIQUE,
2667
- provider TEXT NOT NULL DEFAULT 'manual',
2668
- default_domain INTEGER NOT NULL DEFAULT 0,
2669
- cloudflare_zone_id TEXT,
2670
- cloudflare_account_id TEXT,
2671
- cloudflare_worker_name TEXT,
2672
- origin_url TEXT,
2673
- notes TEXT,
2674
- metadata TEXT NOT NULL DEFAULT '{}',
2675
- machine_id TEXT,
2676
- synced_at TEXT,
2677
- created_at TEXT NOT NULL,
2678
- updated_at TEXT NOT NULL
2679
- );
2680
-
2681
- CREATE TABLE IF NOT EXISTS links (
2682
- id TEXT PRIMARY KEY,
2683
- domain_id TEXT NOT NULL REFERENCES domains(id) ON DELETE CASCADE,
2684
- slug TEXT NOT NULL,
2685
- destination_url TEXT NOT NULL,
2686
- title TEXT,
2687
- active INTEGER NOT NULL DEFAULT 1,
2688
- expires_at TEXT,
2689
- metadata TEXT NOT NULL DEFAULT '{}',
2690
- machine_id TEXT,
2691
- synced_at TEXT,
2692
- created_at TEXT NOT NULL,
2693
- updated_at TEXT NOT NULL,
2694
- UNIQUE(domain_id, slug)
2695
- );
2696
-
2697
- CREATE TABLE IF NOT EXISTS clicks (
2698
- id TEXT PRIMARY KEY,
2699
- link_id TEXT NOT NULL REFERENCES links(id) ON DELETE CASCADE,
2700
- domain_id TEXT NOT NULL REFERENCES domains(id) ON DELETE CASCADE,
2701
- slug TEXT NOT NULL,
2702
- clicked_at TEXT NOT NULL,
2703
- ip_hash TEXT,
2704
- user_agent TEXT,
2705
- referer TEXT,
2706
- country TEXT,
2707
- city TEXT,
2708
- metadata TEXT NOT NULL DEFAULT '{}',
2709
- machine_id TEXT,
2710
- synced_at TEXT,
2711
- created_at TEXT NOT NULL,
2712
- updated_at TEXT NOT NULL
2713
- );
2714
-
2715
- CREATE INDEX IF NOT EXISTS idx_domains_hostname ON domains(hostname);
2716
- CREATE INDEX IF NOT EXISTS idx_domains_default ON domains(default_domain);
2717
- CREATE INDEX IF NOT EXISTS idx_links_domain_slug ON links(domain_id, slug);
2718
- CREATE INDEX IF NOT EXISTS idx_links_active ON links(active);
2719
- CREATE INDEX IF NOT EXISTS idx_links_updated ON links(updated_at);
2720
- CREATE INDEX IF NOT EXISTS idx_clicks_link ON clicks(link_id);
2721
- CREATE INDEX IF NOT EXISTS idx_clicks_domain ON clicks(domain_id);
2722
- CREATE INDEX IF NOT EXISTS idx_clicks_clicked_at ON clicks(clicked_at);
2723
- CREATE INDEX IF NOT EXISTS idx_clicks_updated ON clicks(updated_at);
2724
- `
2725
- ];
2726
-
2727
- class ShortlinksDatabase {
2728
- db;
2729
- path;
2730
- constructor(path) {
2731
- this.path = getDatabasePath(path);
2732
- mkdirSync2(dirname2(this.path), { recursive: true });
2733
- this.db = new Database(this.path);
2734
- this.db.exec("PRAGMA foreign_keys = ON;");
2735
- this.applyMigrations();
2736
- }
2737
- close() {
2738
- this.db.close();
2739
- }
2740
- applyMigrations() {
2741
- this.db.exec(`
2742
- CREATE TABLE IF NOT EXISTS _migrations (
2743
- id INTEGER PRIMARY KEY,
2744
- applied_at TEXT NOT NULL
2745
- );
2746
- `);
2747
- for (let i = 0;i < SQLITE_MIGRATIONS.length; i += 1) {
2748
- const id = i + 1;
2749
- const applied = this.db.query("SELECT id FROM _migrations WHERE id = ?").get(id);
2750
- if (applied)
2751
- continue;
2752
- const migration = SQLITE_MIGRATIONS[i];
2753
- const apply = this.db.transaction(() => {
2754
- this.db.exec(migration);
2755
- this.db.query("INSERT INTO _migrations (id, applied_at) VALUES (?, ?)").run(id, now());
2756
- });
2757
- apply();
2758
- }
2759
- }
2760
- }
2761
-
2762
- // src/machine.ts
2763
- import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
2764
- import { hostname } from "os";
2765
- import { join as join2 } from "path";
2766
-
2767
- // src/slug.ts
2768
- import { randomBytes } from "crypto";
2769
- var SLUG_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
2770
- var DEFAULT_SLUG_LENGTH = 7;
2771
- function randomToken(length = DEFAULT_SLUG_LENGTH) {
2772
- if (length < 1 || length > 128)
2773
- throw new Error("Token length must be between 1 and 128.");
2774
- const bytes = randomBytes(length);
2775
- let out = "";
2776
- for (let i = 0;i < length; i += 1) {
2777
- out += SLUG_ALPHABET[bytes[i] % SLUG_ALPHABET.length];
2778
- }
2779
- return out;
2780
- }
2781
- function normalizeSlug(slug) {
2782
- const normalized = slug.trim().replace(/^\/+/, "").replace(/\/+$/, "");
2783
- if (!normalized)
2784
- throw new Error("Slug is required.");
2785
- if (!/^[A-Za-z0-9_-]{1,96}$/.test(normalized)) {
2786
- throw new Error("Slug can only contain letters, numbers, underscores, and dashes.");
2787
- }
2788
- return normalized;
2789
- }
2790
-
2791
- // src/machine.ts
2792
- function getMachineId() {
2793
- const path = join2(ensureDataDir(), "machine-id");
2794
- if (existsSync2(path)) {
2795
- const existing = readFileSync2(path, "utf-8").trim();
2796
- if (existing)
2797
- return existing;
2798
- }
2799
- const safeHost = hostname().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
2800
- const id = `${safeHost || "machine"}-${randomToken(8).toLowerCase()}`;
2801
- writeFileSync2(path, `${id}
2802
- `);
2803
- return id;
2804
- }
2805
-
2806
- // src/store.ts
2807
- function parseJsonObject(value) {
2808
- if (!value)
2809
- return {};
2810
- try {
2811
- const parsed = JSON.parse(value);
2812
- return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
2813
- } catch {
2814
- return {};
2815
- }
2816
- }
2817
- function domainFromRow(row) {
2818
- return {
2819
- ...row,
2820
- default_domain: Boolean(row.default_domain),
2821
- metadata: parseJsonObject(row.metadata)
2822
- };
2823
- }
2824
- function linkFromRow(row) {
2825
- const config = loadConfig();
2826
- const publicBaseUrl = config.defaultDomain === row.hostname ? config.publicBaseUrl : undefined;
2827
- return {
2828
- ...row,
2829
- active: Boolean(row.active),
2830
- metadata: parseJsonObject(row.metadata),
2831
- short_url: formatShortUrl(row.hostname, row.slug, publicBaseUrl)
2832
- };
2833
- }
2834
- function clickFromRow(row) {
2835
- return {
2836
- ...row,
2837
- metadata: parseJsonObject(row.metadata)
2838
- };
2839
- }
2840
- function validateDestinationUrl(url) {
2841
- let parsed;
2842
- try {
2843
- parsed = new URL(url);
2844
- } catch {
2845
- throw new Error(`Invalid destination URL: ${url}`);
2846
- }
2847
- if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
2848
- throw new Error("Destination URL must start with http:// or https://.");
2849
- }
2850
- return parsed.toString();
2851
- }
2852
- function isoOrNull(input) {
2853
- if (!input)
2854
- return null;
2855
- const date = new Date(input);
2856
- if (Number.isNaN(date.getTime()))
2857
- throw new Error(`Invalid date: ${input}`);
2858
- return date.toISOString();
2859
- }
2860
-
2861
- class ShortlinksStore {
2862
- database;
2863
- constructor(dbPath) {
2864
- this.database = new ShortlinksDatabase(dbPath);
2865
- }
2866
- close() {
2867
- this.database.close();
2868
- }
2869
- addDomain(input) {
2870
- const hostname2 = normalizeHostname(input.hostname);
2871
- const timestamp = now();
2872
- const machineId = getMachineId();
2873
- const existing = this.getDomain(hostname2);
2874
- const id = existing?.id || makeId("dom");
2875
- if (input.defaultDomain) {
2876
- this.database.db.query("UPDATE domains SET default_domain = 0, updated_at = ?, synced_at = NULL").run(timestamp);
2877
- updateConfig({ defaultDomain: hostname2, publicBaseUrl: `https://${hostname2}` });
2878
- }
2879
- this.database.db.query(`
2880
- INSERT INTO domains (
2881
- id, hostname, provider, default_domain, cloudflare_zone_id, cloudflare_account_id,
2882
- cloudflare_worker_name, origin_url, notes, metadata, machine_id, synced_at, created_at, updated_at
2883
- )
2884
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, ?)
2885
- ON CONFLICT(hostname) DO UPDATE SET
2886
- provider = excluded.provider,
2887
- default_domain = excluded.default_domain,
2888
- cloudflare_zone_id = COALESCE(excluded.cloudflare_zone_id, domains.cloudflare_zone_id),
2889
- cloudflare_account_id = COALESCE(excluded.cloudflare_account_id, domains.cloudflare_account_id),
2890
- cloudflare_worker_name = COALESCE(excluded.cloudflare_worker_name, domains.cloudflare_worker_name),
2891
- origin_url = COALESCE(excluded.origin_url, domains.origin_url),
2892
- notes = COALESCE(excluded.notes, domains.notes),
2893
- metadata = excluded.metadata,
2894
- machine_id = excluded.machine_id,
2895
- synced_at = NULL,
2896
- updated_at = excluded.updated_at
2897
- `).run(id, hostname2, input.provider || existing?.provider || "manual", input.defaultDomain ?? existing?.default_domain ? 1 : 0, input.cloudflareZoneId || existing?.cloudflare_zone_id || null, input.cloudflareAccountId || existing?.cloudflare_account_id || null, input.cloudflareWorkerName || existing?.cloudflare_worker_name || null, input.originUrl || existing?.origin_url || null, input.notes || existing?.notes || null, JSON.stringify(input.metadata || existing?.metadata || {}), machineId, existing?.created_at || timestamp, timestamp);
2898
- return this.getDomain(hostname2);
2899
- }
2900
- listDomains() {
2901
- const rows = this.database.db.query(`
2902
- SELECT * FROM domains
2903
- ORDER BY default_domain DESC, hostname ASC
2904
- `).all();
2905
- return rows.map(domainFromRow);
2906
- }
2907
- getDomain(hostnameOrId) {
2908
- const normalized = hostnameOrId.includes(".") || hostnameOrId.includes("://") ? normalizeHostname(hostnameOrId) : hostnameOrId;
2909
- const row = this.database.db.query(`
2910
- SELECT * FROM domains WHERE hostname = ? OR id = ? LIMIT 1
2911
- `).get(normalized, hostnameOrId);
2912
- return row ? domainFromRow(row) : null;
2913
- }
2914
- getDefaultDomain() {
2915
- const config = loadConfig();
2916
- if (config.defaultDomain) {
2917
- const configured = this.getDomain(config.defaultDomain);
2918
- if (configured)
2919
- return configured;
2920
- }
2921
- const row = this.database.db.query(`
2922
- SELECT * FROM domains ORDER BY default_domain DESC, created_at ASC LIMIT 1
2923
- `).get();
2924
- return row ? domainFromRow(row) : null;
2925
- }
2926
- createLink(input) {
2927
- const domain = input.domain ? this.getDomain(input.domain) : this.getDefaultDomain();
2928
- if (!domain) {
2929
- throw new Error("No domain configured. Run `shortlinks domain add <domain> --default` first.");
2930
- }
2931
- const destinationUrl = validateDestinationUrl(input.destinationUrl);
2932
- const timestamp = now();
2933
- const machineId = getMachineId();
2934
- const expiresAt = isoOrNull(input.expiresAt);
2935
- const slug = input.slug ? normalizeSlug(input.slug) : this.generateAvailableSlug(domain.id, input.slugLength || DEFAULT_SLUG_LENGTH);
2936
- try {
2937
- this.database.db.query(`
2938
- INSERT INTO links (
2939
- id, domain_id, slug, destination_url, title, active, expires_at, metadata,
2940
- machine_id, synced_at, created_at, updated_at
2941
- )
2942
- VALUES (?, ?, ?, ?, ?, 1, ?, ?, ?, NULL, ?, ?)
2943
- `).run(makeId("lnk"), domain.id, slug, destinationUrl, input.title || null, expiresAt, JSON.stringify(input.metadata || {}), machineId, timestamp, timestamp);
2944
- } catch (error) {
2945
- const message = error instanceof Error ? error.message : String(error);
2946
- if (message.includes("UNIQUE")) {
2947
- throw new Error(`Slug already exists for ${domain.hostname}: ${slug}`);
2948
- }
2949
- throw error;
2950
- }
2951
- return this.getLink(domain.hostname, slug);
2952
- }
2953
- listLinks(options = {}) {
2954
- const params = [];
2955
- let where = "WHERE 1 = 1";
2956
- if (options.domain) {
2957
- where += " AND d.hostname = ?";
2958
- params.push(normalizeHostname(options.domain));
2959
- }
2960
- if (options.activeOnly) {
2961
- where += " AND l.active = 1";
2962
- }
2963
- params.push(options.limit || 100);
2964
- const rows = this.database.db.query(`
2965
- SELECT l.*, d.hostname
2966
- FROM links l
2967
- JOIN domains d ON d.id = l.domain_id
2968
- ${where}
2969
- ORDER BY l.created_at DESC
2970
- LIMIT ?
2971
- `).all(...params);
2972
- return rows.map(linkFromRow);
2973
- }
2974
- getLink(domainOrSlug, maybeSlug) {
2975
- const slug = normalizeSlug(maybeSlug || domainOrSlug);
2976
- const params = [slug];
2977
- let domainClause = "";
2978
- if (maybeSlug) {
2979
- domainClause = "AND d.hostname = ?";
2980
- params.push(normalizeHostname(domainOrSlug));
2981
- }
2982
- const row = this.database.db.query(`
2983
- SELECT l.*, d.hostname
2984
- FROM links l
2985
- JOIN domains d ON d.id = l.domain_id
2986
- WHERE l.slug = ? ${domainClause}
2987
- ORDER BY d.default_domain DESC, l.created_at ASC
2988
- LIMIT 1
2989
- `).get(...params);
2990
- return row ? linkFromRow(row) : null;
2991
- }
2992
- resolve(hostname2, slug) {
2993
- const normalizedSlug = normalizeSlug(slug);
2994
- const normalizedHost = normalizeHostname(hostname2);
2995
- const row = this.database.db.query(`
2996
- SELECT l.*, d.hostname
2997
- FROM links l
2998
- JOIN domains d ON d.id = l.domain_id
2999
- WHERE d.hostname = ? AND l.slug = ?
3000
- LIMIT 1
3001
- `).get(normalizedHost, normalizedSlug);
3002
- if (row)
3003
- return linkFromRow(row);
3004
- const fallback = this.getDefaultDomain();
3005
- if (!fallback || fallback.hostname === normalizedHost)
3006
- return null;
3007
- return this.getLink(fallback.hostname, normalizedSlug);
3008
- }
3009
- setLinkActive(domainOrSlug, maybeSlugOrActive, maybeActive) {
3010
- const active = typeof maybeSlugOrActive === "boolean" ? maybeSlugOrActive : Boolean(maybeActive);
3011
- const link = typeof maybeSlugOrActive === "boolean" ? this.getLink(domainOrSlug) : this.getLink(domainOrSlug, maybeSlugOrActive);
3012
- if (!link)
3013
- throw new Error("Link not found.");
3014
- const timestamp = now();
3015
- this.database.db.query(`
3016
- UPDATE links SET active = ?, updated_at = ?, synced_at = NULL WHERE id = ?
3017
- `).run(active ? 1 : 0, timestamp, link.id);
3018
- return this.getLink(link.hostname, link.slug);
3019
- }
3020
- deleteLink(domainOrSlug, maybeSlug) {
3021
- const link = maybeSlug ? this.getLink(domainOrSlug, maybeSlug) : this.getLink(domainOrSlug);
3022
- if (!link)
3023
- throw new Error("Link not found.");
3024
- this.database.db.query("DELETE FROM links WHERE id = ?").run(link.id);
3025
- return link;
3026
- }
3027
- recordClick(link, input = {}) {
3028
- const timestamp = now();
3029
- const machineId = getMachineId();
3030
- const ipHash = input.ip ? this.hashIp(input.ip) : null;
3031
- const id = makeId("clk");
3032
- this.database.db.query(`
3033
- INSERT INTO clicks (
3034
- id, link_id, domain_id, slug, clicked_at, ip_hash, user_agent, referer,
3035
- country, city, metadata, machine_id, synced_at, created_at, updated_at
3036
- )
3037
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, ?)
3038
- `).run(id, link.id, link.domain_id, link.slug, timestamp, ipHash, input.userAgent || null, input.referer || null, input.country || null, input.city || null, JSON.stringify(input.metadata || {}), machineId, timestamp, timestamp);
3039
- const row = this.database.db.query("SELECT * FROM clicks WHERE id = ?").get(id);
3040
- return clickFromRow(row);
3041
- }
3042
- getStats(domainOrSlug, maybeSlug) {
3043
- const link = maybeSlug ? this.getLink(domainOrSlug, maybeSlug) : this.getLink(domainOrSlug);
3044
- if (!link)
3045
- throw new Error("Link not found.");
3046
- const summary = this.database.db.query(`
3047
- SELECT COUNT(*) AS clicks, MAX(clicked_at) AS last_clicked_at FROM clicks WHERE link_id = ?
3048
- `).get(link.id);
3049
- const topReferrers = this.database.db.query(`
3050
- SELECT referer, COUNT(*) AS clicks
3051
- FROM clicks
3052
- WHERE link_id = ?
3053
- GROUP BY referer
3054
- ORDER BY clicks DESC
3055
- LIMIT 10
3056
- `).all(link.id);
3057
- const topUserAgents = this.database.db.query(`
3058
- SELECT user_agent, COUNT(*) AS clicks
3059
- FROM clicks
3060
- WHERE link_id = ?
3061
- GROUP BY user_agent
3062
- ORDER BY clicks DESC
3063
- LIMIT 10
3064
- `).all(link.id);
3065
- return {
3066
- link,
3067
- clicks: summary.clicks,
3068
- last_clicked_at: summary.last_clicked_at,
3069
- top_referrers: topReferrers,
3070
- top_user_agents: topUserAgents
3071
- };
3072
- }
3073
- totalStats() {
3074
- const row = this.database.db.query(`
3075
- SELECT
3076
- (SELECT COUNT(*) FROM domains) AS domains,
3077
- (SELECT COUNT(*) FROM links) AS links,
3078
- (SELECT COUNT(*) FROM clicks) AS clicks
3079
- `).get();
3080
- return row;
3081
- }
3082
- generateAvailableSlug(domainId, length) {
3083
- for (let attempt = 0;attempt < 32; attempt += 1) {
3084
- const slug = randomToken(length);
3085
- const exists = this.database.db.query(`
3086
- SELECT 1 FROM links WHERE domain_id = ? AND slug = ? LIMIT 1
3087
- `).get(domainId, slug);
3088
- if (!exists)
3089
- return slug;
3090
- }
3091
- throw new Error("Could not generate an unused slug after 32 attempts.");
3092
- }
3093
- hashIp(ip) {
3094
- const salt = process.env.SHORTLINKS_CLICK_SALT || "shortlinks-local";
3095
- return createHash("sha256").update(`${salt}:${ip}`).digest("hex");
3096
- }
3097
- }
3098
-
3099
- // src/server.ts
3100
- function json(data, status = 200) {
3101
- return new Response(JSON.stringify(data, null, 2), {
3102
- status,
3103
- headers: { "content-type": "application/json; charset=utf-8" }
3104
- });
3105
- }
3106
- function getHost(request, fallback) {
3107
- const forwarded = request.headers.get("x-forwarded-host");
3108
- const host = forwarded || request.headers.get("host") || fallback || "";
3109
- return host.split(",")[0].trim().split(":")[0];
3110
- }
3111
- function getClientIp(request) {
3112
- const forwarded = request.headers.get("x-forwarded-for");
3113
- if (forwarded)
3114
- return forwarded.split(",")[0].trim();
3115
- return request.headers.get("cf-connecting-ip") || request.headers.get("x-real-ip");
3116
- }
3117
- function isExpired(link) {
3118
- return Boolean(link.expires_at && new Date(link.expires_at).getTime() <= Date.now());
3119
- }
3120
- function createShortlinksHandler(options = {}) {
3121
- const store = options.store || new ShortlinksStore(options.dbPath);
3122
- const redirectStatus = options.redirectStatus || 302;
3123
- return async (request) => {
3124
- const url = new URL(request.url);
3125
- if (url.pathname === "/healthz") {
3126
- return json({ ok: true, service: "shortlinks", stats: store.totalStats() });
3127
- }
3128
- if (url.pathname === "/" || url.pathname === "") {
3129
- return json({ service: "shortlinks", ok: true });
3130
- }
3131
- let slug = "";
3132
- try {
3133
- slug = decodeURIComponent(url.pathname.replace(/^\/+/, "").split("/")[0] || "");
3134
- } catch {
3135
- return json({ error: "Invalid slug." }, 400);
3136
- }
3137
- if (!slug)
3138
- return json({ error: "Missing slug." }, 404);
3139
- const host = getHost(request, options.defaultHost);
3140
- if (!host)
3141
- return json({ error: "Missing Host header." }, 400);
3142
- let link = null;
3143
- try {
3144
- link = store.resolve(host, slug);
3145
- } catch {
3146
- return json({ error: "Shortlink not found.", slug, host }, 404);
3147
- }
3148
- if (!link)
3149
- return json({ error: "Shortlink not found.", slug, host }, 404);
3150
- if (!link.active)
3151
- return json({ error: "Shortlink is disabled.", slug, host }, 410);
3152
- if (isExpired(link))
3153
- return json({ error: "Shortlink is expired.", slug, host }, 410);
3154
- store.recordClick(link, {
3155
- ip: getClientIp(request),
3156
- userAgent: request.headers.get("user-agent"),
3157
- referer: request.headers.get("referer"),
3158
- country: request.headers.get("cf-ipcountry"),
3159
- metadata: {
3160
- path: url.pathname,
3161
- query: url.search
3162
- }
3163
- });
3164
- return Response.redirect(link.destination_url, redirectStatus);
3165
- };
3166
- }
3167
- function serveShortlinks(options = {}) {
3168
- const host = options.host || "127.0.0.1";
3169
- const port = options.port || 8787;
3170
- const fetch2 = createShortlinksHandler(options);
3171
- return Bun.serve({ hostname: host, port, fetch: fetch2 });
3172
- }
3173
-
3174
- // src/cloudflare.ts
3175
- import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
3176
- import { join as join3 } from "path";
3177
- function createCloudflarePlan(input) {
3178
- const hostname2 = normalizeHostname(input.hostname);
3179
- const target = normalizeHostname(input.target);
3180
- const workerName = input.workerName || "shortlinks";
3181
- const proxied = input.proxied ?? true;
3182
- return {
3183
- hostname: hostname2,
3184
- target,
3185
- proxied,
3186
- workerName,
3187
- origin: input.origin,
3188
- dnsRecord: {
3189
- type: "CNAME",
3190
- name: hostname2,
3191
- content: target,
3192
- proxied
3193
- },
3194
- wranglerCommand: `wrangler deploy cloudflare/${workerName}.js --name ${workerName}`
3195
- };
3196
- }
3197
- function generateWorkerScript() {
3198
- return `export default {
3199
- async fetch(request, env) {
3200
- const origin = env.SHORTLINKS_ORIGIN;
3201
- if (!origin) {
3202
- return new Response("SHORTLINKS_ORIGIN is not configured", { status: 500 });
3203
- }
3204
-
3205
- const incoming = new URL(request.url);
3206
- const upstream = new URL(incoming.pathname + incoming.search, origin);
3207
- const headers = new Headers(request.headers);
3208
- headers.set("x-forwarded-host", incoming.host);
3209
- headers.set("x-shortlinks-worker", "cloudflare");
3210
-
3211
- return fetch(upstream.toString(), {
3212
- method: request.method,
3213
- headers,
3214
- body: request.method === "GET" || request.method === "HEAD" ? undefined : request.body,
3215
- redirect: "manual"
3216
- });
3217
- }
3218
- };
3219
- `;
3220
- }
3221
- function writeWorkerFiles(options = {}) {
3222
- const outDir = options.outDir || "cloudflare";
3223
- const workerName = options.workerName || "shortlinks";
3224
- mkdirSync3(outDir, { recursive: true });
3225
- const workerPath = join3(outDir, `${workerName}.js`);
3226
- const wranglerPath = join3(outDir, "wrangler.example.toml");
3227
- writeFileSync3(workerPath, generateWorkerScript());
3228
- writeFileSync3(wranglerPath, `name = "${workerName}"
3229
- main = "${workerName}.js"
3230
- compatibility_date = "2026-05-01"
3231
-
3232
- [vars]
3233
- SHORTLINKS_ORIGIN = "${options.origin || "https://shortlinks.example.com"}"
3234
- `);
3235
- return { workerPath, wranglerPath };
3236
- }
3237
- function cloudflareAuthHeaders(token) {
3238
- const apiToken = token || process.env.CLOUDFLARE_API_TOKEN;
3239
- if (apiToken)
3240
- return { authorization: `Bearer ${apiToken}` };
3241
- const apiKey = process.env.CLOUDFLARE_API_KEY;
3242
- const email = process.env.CLOUDFLARE_EMAIL;
3243
- if (apiKey && email) {
3244
- return {
3245
- "x-auth-key": apiKey,
3246
- "x-auth-email": email
3247
- };
3248
- }
3249
- throw new Error("Cloudflare auth is required: set CLOUDFLARE_API_TOKEN, or CLOUDFLARE_API_KEY plus CLOUDFLARE_EMAIL.");
3250
- }
3251
- async function cloudflareRequest(token, path, init = {}) {
3252
- const response = await fetch(`https://api.cloudflare.com/client/v4${path}`, {
3253
- ...init,
3254
- headers: {
3255
- ...cloudflareAuthHeaders(token),
3256
- "content-type": "application/json",
3257
- ...init.headers || {}
3258
- }
3259
- });
3260
- const body = await response.json();
3261
- if (!response.ok || body.success === false) {
3262
- const message = body.errors?.map((e) => e.message).join("; ") || response.statusText;
3263
- throw new Error(`Cloudflare API failed: ${message}`);
3264
- }
3265
- return body.result;
3266
- }
3267
- function candidateZones(hostname2) {
3268
- const parts = normalizeHostname(hostname2).split(".");
3269
- const candidates = [];
3270
- for (let i = 0;i < parts.length - 1; i += 1) {
3271
- candidates.push(parts.slice(i).join("."));
3272
- }
3273
- return candidates;
3274
- }
3275
- async function findCloudflareZoneId(hostname2, token) {
3276
- for (const zone of candidateZones(hostname2)) {
3277
- const result = await cloudflareRequest(token, `/zones?name=${encodeURIComponent(zone)}`);
3278
- if (result[0]?.id)
3279
- return result[0].id;
3280
- }
3281
- throw new Error(`Could not find a Cloudflare zone for ${hostname2}. Pass --zone-id explicitly.`);
3282
- }
3283
- async function upsertCloudflareDnsRecord(options) {
3284
- const token = options.token || process.env.CLOUDFLARE_API_TOKEN;
3285
- const plan = createCloudflarePlan({
3286
- hostname: options.hostname,
3287
- target: options.target,
3288
- origin: process.env.SHORTLINKS_ORIGIN || "https://shortlinks.example.com",
3289
- proxied: options.proxied
3290
- });
3291
- if (options.dryRun)
3292
- return plan;
3293
- const zoneId = options.zoneId || await findCloudflareZoneId(plan.hostname, token);
3294
- const existing = await cloudflareRequest(token, `/zones/${zoneId}/dns_records?type=CNAME&name=${encodeURIComponent(plan.hostname)}`);
3295
- const payload = JSON.stringify(plan.dnsRecord);
3296
- if (existing[0]?.id) {
3297
- const updated = await cloudflareRequest(token, `/zones/${zoneId}/dns_records/${existing[0].id}`, {
3298
- method: "PUT",
3299
- body: payload
3300
- });
3301
- return { id: updated.id, action: "updated" };
3302
- }
3303
- const created = await cloudflareRequest(token, `/zones/${zoneId}/dns_records`, {
3304
- method: "POST",
3305
- body: payload
3306
- });
3307
- return { id: created.id, action: "created" };
3308
- }
3309
-
3310
- // src/domains-cli.ts
3311
- import { spawnSync } from "child_process";
3312
- function buildDomainsArgs(action, domain) {
3313
- switch (action) {
3314
- case "check":
3315
- return ["domain", "check", domain];
3316
- case "buy":
3317
- return ["domain", "buy", domain];
3318
- case "setup":
3319
- return ["domain", "setup", domain];
3320
- }
3321
- }
3322
- function runDomains(action, domain, options = {}) {
3323
- const args = buildDomainsArgs(action, domain);
3324
- const command = `domains ${args.join(" ")}`;
3325
- if (options.dryRun) {
3326
- return { command, status: 0, stdout: command, stderr: "" };
3327
- }
3328
- const result = spawnSync("domains", args, { encoding: "utf-8" });
3329
- return {
3330
- command,
3331
- status: result.status,
3332
- stdout: result.stdout || "",
3333
- stderr: result.stderr || ""
3334
- };
3335
- }
3336
-
3337
- // src/local.ts
3338
- import { spawnSync as spawnSync2 } from "child_process";
3339
- import { homedir as homedir2 } from "os";
3340
- import { join as join4 } from "path";
3341
- function createLocalSetupPlan(input) {
3342
- const domain = normalizeHostname(input.domain);
3343
- const targetHost = input.targetHost || "127.0.0.1";
3344
- const port = input.port || 8787;
3345
- const certDir = input.certDir || join4(homedir2(), ".hasna", "machines", "certs");
3346
- const certPath = join4(certDir, `${domain}.pem`);
3347
- const keyPath = join4(certDir, `${domain}-key.pem`);
3348
- return {
3349
- domain,
3350
- targetHost,
3351
- port,
3352
- hostsEntry: `${targetHost} ${domain}`,
3353
- caddySnippet: `${domain} {
3354
- reverse_proxy ${targetHost}:${port}
3355
- tls ${certPath} ${keyPath}
3356
- }`,
3357
- certPath,
3358
- keyPath,
3359
- machinesCommand: `machines dns add --domain ${domain} --target-host ${targetHost} --port ${port} --json`,
3360
- sudoRequired: true
3361
- };
3362
- }
3363
- function registerMachinesDns(input) {
3364
- const plan = createLocalSetupPlan(input);
3365
- const args = [
3366
- "dns",
3367
- "add",
3368
- "--domain",
3369
- plan.domain,
3370
- "--target-host",
3371
- plan.targetHost,
3372
- "--port",
3373
- String(plan.port),
3374
- "--json"
3375
- ];
3376
- const result = spawnSync2("machines", args, { encoding: "utf-8" });
3377
- return {
3378
- command: `machines ${args.join(" ")}`,
3379
- status: result.status,
3380
- stdout: result.stdout || "",
3381
- stderr: result.stderr || ""
3382
- };
3383
- }
3384
-
3385
- // src/pg-migrations.ts
3386
- var PG_MIGRATIONS = [
3387
- `
3388
- CREATE TABLE IF NOT EXISTS domains (
3389
- id TEXT PRIMARY KEY,
3390
- hostname TEXT NOT NULL UNIQUE,
3391
- provider TEXT NOT NULL DEFAULT 'manual',
3392
- default_domain INTEGER NOT NULL DEFAULT 0,
3393
- cloudflare_zone_id TEXT,
3394
- cloudflare_account_id TEXT,
3395
- cloudflare_worker_name TEXT,
3396
- origin_url TEXT,
3397
- notes TEXT,
3398
- metadata TEXT NOT NULL DEFAULT '{}',
3399
- machine_id TEXT,
3400
- synced_at TIMESTAMPTZ,
3401
- created_at TIMESTAMPTZ NOT NULL,
3402
- updated_at TIMESTAMPTZ NOT NULL
3403
- );
3404
-
3405
- CREATE TABLE IF NOT EXISTS links (
3406
- id TEXT PRIMARY KEY,
3407
- domain_id TEXT NOT NULL REFERENCES domains(id) ON DELETE CASCADE,
3408
- slug TEXT NOT NULL,
3409
- destination_url TEXT NOT NULL,
3410
- title TEXT,
3411
- active INTEGER NOT NULL DEFAULT 1,
3412
- expires_at TIMESTAMPTZ,
3413
- metadata TEXT NOT NULL DEFAULT '{}',
3414
- machine_id TEXT,
3415
- synced_at TIMESTAMPTZ,
3416
- created_at TIMESTAMPTZ NOT NULL,
3417
- updated_at TIMESTAMPTZ NOT NULL,
3418
- UNIQUE(domain_id, slug)
3419
- );
3420
-
3421
- CREATE TABLE IF NOT EXISTS clicks (
3422
- id TEXT PRIMARY KEY,
3423
- link_id TEXT NOT NULL REFERENCES links(id) ON DELETE CASCADE,
3424
- domain_id TEXT NOT NULL REFERENCES domains(id) ON DELETE CASCADE,
3425
- slug TEXT NOT NULL,
3426
- clicked_at TIMESTAMPTZ NOT NULL,
3427
- ip_hash TEXT,
3428
- user_agent TEXT,
3429
- referer TEXT,
3430
- country TEXT,
3431
- city TEXT,
3432
- metadata TEXT NOT NULL DEFAULT '{}',
3433
- machine_id TEXT,
3434
- synced_at TIMESTAMPTZ,
3435
- created_at TIMESTAMPTZ NOT NULL,
3436
- updated_at TIMESTAMPTZ NOT NULL
3437
- );
3438
-
3439
- CREATE INDEX IF NOT EXISTS idx_domains_hostname ON domains(hostname);
3440
- CREATE INDEX IF NOT EXISTS idx_domains_default ON domains(default_domain);
3441
- CREATE INDEX IF NOT EXISTS idx_links_domain_slug ON links(domain_id, slug);
3442
- CREATE INDEX IF NOT EXISTS idx_links_active ON links(active);
3443
- CREATE INDEX IF NOT EXISTS idx_links_updated ON links(updated_at);
3444
- CREATE INDEX IF NOT EXISTS idx_clicks_link ON clicks(link_id);
3445
- CREATE INDEX IF NOT EXISTS idx_clicks_domain ON clicks(domain_id);
3446
- CREATE INDEX IF NOT EXISTS idx_clicks_clicked_at ON clicks(clicked_at);
3447
- CREATE INDEX IF NOT EXISTS idx_clicks_updated ON clicks(updated_at);
3448
- `
3449
- ];
3450
-
3451
- // src/cli/index.ts
3452
- function getPackageVersion() {
3453
- try {
3454
- const pkgPath = join5(dirname3(fileURLToPath(import.meta.url)), "..", "..", "package.json");
3455
- return JSON.parse(readFileSync3(pkgPath, "utf-8")).version || "0.0.0";
3456
- } catch {
3457
- return "0.0.0";
3458
- }
3459
- }
3460
- var program2 = new Command;
3461
- function useJson(localOpts) {
3462
- return Boolean(localOpts?.json || program2.opts().json);
3463
- }
3464
- function print(data, localOpts, human) {
3465
- if (useJson(localOpts)) {
3466
- console.log(JSON.stringify(data, null, 2));
3467
- return;
3468
- }
3469
- if (human)
3470
- human();
3471
- }
3472
- function handleError(error) {
3473
- const message = error instanceof Error ? error.message : String(error);
3474
- if (useJson()) {
3475
- console.log(JSON.stringify({ error: message }));
3476
- } else {
3477
- console.error(source_default.red(message));
3478
- }
3479
- process.exit(1);
3480
- }
3481
- function withStore(fn) {
3482
- const store = new ShortlinksStore(program2.opts().db);
3483
- try {
3484
- return fn(store);
3485
- } finally {
3486
- store.close();
3487
- }
3488
- }
3489
- async function withStoreAsync(fn) {
3490
- const store = new ShortlinksStore(program2.opts().db);
3491
- try {
3492
- return await fn(store);
3493
- } finally {
3494
- store.close();
3495
- }
3496
- }
3497
- function formatLink(link) {
3498
- return `${source_default.green(link.short_url || `${link.hostname}/${link.slug}`)} ${source_default.dim("->")} ${link.destination_url}`;
3499
- }
3500
- function commandExists(command) {
3501
- const result = spawnSync3("which", [command], { encoding: "utf-8" });
3502
- return result.status === 0;
3503
- }
3504
- program2.name("shortlinks").description("CLI-only shortlink manager with custom domains, click tracking, Cloudflare helpers, and cloud sync").version(getPackageVersion()).option("--db <path>", "SQLite database path").option("-j, --json", "Output JSON for agents and scripts");
3505
- program2.command("init").description("Initialize local shortlinks storage").option("--domain <hostname>", "Add a default shortlink domain").option("--public-base-url <url>", "Public URL base for generated links").option("-j, --json", "Output JSON").action((opts) => {
3506
- try {
3507
- const result = withStore((store) => {
3508
- const config = loadConfig();
3509
- if (opts.publicBaseUrl)
3510
- config.publicBaseUrl = opts.publicBaseUrl;
3511
- if (opts.domain) {
3512
- const domain = store.addDomain({
3513
- hostname: opts.domain,
3514
- provider: "manual",
3515
- defaultDomain: true
3516
- });
3517
- config.defaultDomain = domain.hostname;
3518
- config.publicBaseUrl = opts.publicBaseUrl || `https://${domain.hostname}`;
3519
- }
3520
- saveConfig(config);
3521
- return {
3522
- data_dir: getDataDir(),
3523
- config_path: getConfigPath(),
3524
- db_path: getDatabasePath(program2.opts().db),
3525
- config,
3526
- stats: store.totalStats()
3527
- };
3528
- });
3529
- print(result, opts, () => {
3530
- console.log(source_default.green("shortlinks initialized"));
3531
- console.log(` Data: ${result.data_dir}`);
3532
- console.log(` DB: ${result.db_path}`);
3533
- if (result.config.defaultDomain)
3534
- console.log(` Default domain: ${result.config.defaultDomain}`);
3535
- });
3536
- } catch (error) {
3537
- handleError(error);
3538
- }
3539
- });
3540
- var configCmd = program2.command("config").description("View and update local config");
3541
- configCmd.command("show").description("Show local config").option("-j, --json", "Output JSON").action((opts) => {
3542
- const data = { path: getConfigPath(), config: loadConfig() };
3543
- print(data, opts, () => console.log(JSON.stringify(data, null, 2)));
3544
- });
3545
- configCmd.command("set <key> <value>").description("Set config value: default-domain, public-base-url, cloudflare-account-id, cloudflare-worker-name, cloudflare-origin").option("-j, --json", "Output JSON").action((key, value, opts) => {
3546
- try {
3547
- let config = loadConfig();
3548
- switch (key) {
3549
- case "default-domain":
3550
- config = updateConfig({ defaultDomain: value, publicBaseUrl: config.publicBaseUrl || `https://${value}` });
3551
- break;
3552
- case "public-base-url":
3553
- config = updateConfig({ publicBaseUrl: value });
3554
- break;
3555
- case "cloudflare-account-id":
3556
- config = updateConfig({ cloudflare: { accountId: value } });
3557
- break;
3558
- case "cloudflare-worker-name":
3559
- config = updateConfig({ cloudflare: { workerName: value } });
3560
- break;
3561
- case "cloudflare-origin":
3562
- config = updateConfig({ cloudflare: { origin: value } });
3563
- break;
3564
- default:
3565
- throw new Error(`Unknown config key: ${key}`);
3566
- }
3567
- print({ path: getConfigPath(), config }, opts, () => console.log(source_default.green(`Set ${key}.`)));
3568
- } catch (error) {
3569
- handleError(error);
3570
- }
3571
- });
3572
- var domainCmd = program2.command("domain").alias("domains").description("Manage custom shortlink domains");
3573
- domainCmd.command("add <hostname>").description("Add or update a custom domain").option("--provider <provider>", "Provider label", "manual").option("--default", "Make this the default domain").option("--cloudflare-zone-id <id>", "Cloudflare zone ID").option("--cloudflare-account-id <id>", "Cloudflare account ID").option("--cloudflare-worker-name <name>", "Cloudflare Worker name").option("--origin <url>", "Origin redirect server URL").option("--notes <text>", "Notes").option("-j, --json", "Output JSON").action((hostname2, opts) => {
3574
- try {
3575
- const domain = withStore((store) => store.addDomain({
3576
- hostname: hostname2,
3577
- provider: opts.provider,
3578
- defaultDomain: opts.default,
3579
- cloudflareZoneId: opts.cloudflareZoneId,
3580
- cloudflareAccountId: opts.cloudflareAccountId,
3581
- cloudflareWorkerName: opts.cloudflareWorkerName,
3582
- originUrl: opts.origin,
3583
- notes: opts.notes
3584
- }));
3585
- print(domain, opts, () => {
3586
- console.log(source_default.green(`Domain ready: ${domain.hostname}`));
3587
- if (domain.default_domain)
3588
- console.log(source_default.dim("Default domain updated."));
3589
- });
3590
- } catch (error) {
3591
- handleError(error);
3592
- }
3593
- });
3594
- domainCmd.command("list").description("List configured domains").option("-j, --json", "Output JSON").action((opts) => {
3595
- try {
3596
- const domains = withStore((store) => store.listDomains());
3597
- print(domains, opts, () => {
3598
- if (domains.length === 0) {
3599
- console.log(source_default.dim("No domains configured."));
3600
- return;
3601
- }
3602
- for (const domain of domains) {
3603
- const marker = domain.default_domain ? source_default.green("*") : " ";
3604
- console.log(`${marker} ${domain.hostname} ${source_default.dim(domain.provider)}`);
3605
- }
3606
- });
3607
- } catch (error) {
3608
- handleError(error);
3609
- }
3610
- });
3611
- domainCmd.command("get <hostname>").description("Show a configured domain").option("-j, --json", "Output JSON").action((hostname2, opts) => {
3612
- try {
3613
- const domain = withStore((store) => store.getDomain(hostname2));
3614
- if (!domain)
3615
- throw new Error("Domain not found.");
3616
- print(domain, opts, () => console.log(JSON.stringify(domain, null, 2)));
3617
- } catch (error) {
3618
- handleError(error);
3619
- }
3620
- });
3621
- domainCmd.command("setup <hostname>").description("Add a domain locally and optionally prepare Cloudflare DNS").option("--default", "Make this the default domain").option("--origin <url>", "Origin redirect server URL").option("--cloudflare", "Upsert Cloudflare CNAME record").option("--target <hostname>", "CNAME target for Cloudflare DNS").option("--zone-id <id>", "Cloudflare zone ID").option("--dry-run", "Show the Cloudflare plan without changing DNS").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
3622
- try {
3623
- const result = await withStoreAsync(async (store) => {
3624
- const domain = store.addDomain({
3625
- hostname: hostname2,
3626
- provider: opts.cloudflare ? "cloudflare" : "manual",
3627
- defaultDomain: opts.default,
3628
- originUrl: opts.origin
3629
- });
3630
- const cloudflare = opts.cloudflare ? await upsertCloudflareDnsRecord({
3631
- hostname: hostname2,
3632
- target: opts.target || hostname2,
3633
- zoneId: opts.zoneId,
3634
- dryRun: opts.dryRun
3635
- }) : null;
3636
- return { domain, cloudflare };
3637
- });
3638
- print(result, opts, () => {
3639
- console.log(source_default.green(`Domain ready: ${result.domain.hostname}`));
3640
- if (result.cloudflare)
3641
- console.log(JSON.stringify(result.cloudflare, null, 2));
3642
- });
3643
- } catch (error) {
3644
- handleError(error);
3645
- }
3646
- });
3647
- domainCmd.command("check <hostname>").description("Check domain availability through @hasna/domains").option("--dry-run", "Print the command without running it").option("-j, --json", "Output JSON").action((hostname2, opts) => {
3648
- const result = runDomains("check", hostname2, { dryRun: opts.dryRun });
3649
- print(result, opts, () => {
3650
- if (result.stdout.trim())
3651
- console.log(result.stdout.trim());
3652
- if (result.stderr.trim())
3653
- console.error(result.stderr.trim());
3654
- if (result.status !== 0)
3655
- process.exit(result.status || 1);
3656
- });
3657
- });
3658
- domainCmd.command("buy <hostname>").description("Buy a domain through @hasna/domains / Route 53").option("--dry-run", "Print the command without running it").option("-j, --json", "Output JSON").action((hostname2, opts) => {
3659
- const result = runDomains("buy", hostname2, { dryRun: opts.dryRun });
3660
- print(result, opts, () => {
3661
- if (result.stdout.trim())
3662
- console.log(result.stdout.trim());
3663
- if (result.stderr.trim())
3664
- console.error(result.stderr.trim());
3665
- if (result.status !== 0)
3666
- process.exit(result.status || 1);
3667
- });
3668
- });
3669
- var linkCmd = program2.command("link").alias("links").description("Manage shortlinks");
3670
- function createLinkAction(url, opts) {
3671
- try {
3672
- const link = withStore((store) => store.createLink({
3673
- destinationUrl: url,
3674
- domain: opts.domain,
3675
- slug: opts.slug,
3676
- title: opts.title,
3677
- expiresAt: opts.expires,
3678
- slugLength: opts.length ? Number(opts.length) : undefined
3679
- }));
3680
- print(link, opts, () => console.log(formatLink(link)));
3681
- } catch (error) {
3682
- handleError(error);
3683
- }
3684
- }
3685
- linkCmd.command("create <url>").description("Create a shortlink").option("--domain <hostname>", "Domain to use").option("--slug <slug>", "Custom slug").option("--title <title>", "Human title").option("--expires <date>", "Expiration date").option("--length <n>", "Generated slug length", "7").option("-j, --json", "Output JSON").action(createLinkAction);
3686
- program2.command("create <url>").description("Create a shortlink").option("--domain <hostname>", "Domain to use").option("--slug <slug>", "Custom slug").option("--title <title>", "Human title").option("--expires <date>", "Expiration date").option("--length <n>", "Generated slug length", "7").option("-j, --json", "Output JSON").action(createLinkAction);
3687
- linkCmd.command("list").description("List shortlinks").option("--domain <hostname>", "Filter by domain").option("--active", "Only active links").option("--limit <n>", "Maximum rows", "100").option("-j, --json", "Output JSON").action((opts) => {
3688
- try {
3689
- const links = withStore((store) => store.listLinks({
3690
- domain: opts.domain,
3691
- activeOnly: opts.active,
3692
- limit: Number(opts.limit)
3693
- }));
3694
- print(links, opts, () => {
3695
- if (links.length === 0) {
3696
- console.log(source_default.dim("No links yet."));
3697
- return;
3698
- }
3699
- for (const link of links)
3700
- console.log(formatLink(link));
3701
- });
3702
- } catch (error) {
3703
- handleError(error);
3704
- }
3705
- });
3706
- linkCmd.command("get <slug>").description("Show a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action((slug, opts) => {
3707
- try {
3708
- const link = withStore((store) => opts.domain ? store.getLink(opts.domain, slug) : store.getLink(slug));
3709
- if (!link)
3710
- throw new Error("Link not found.");
3711
- print(link, opts, () => console.log(JSON.stringify(link, null, 2)));
3712
- } catch (error) {
3713
- handleError(error);
3714
- }
3715
- });
3716
- linkCmd.command("disable <slug>").description("Disable a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action((slug, opts) => {
3717
- try {
3718
- const link = withStore((store) => opts.domain ? store.setLinkActive(opts.domain, slug, false) : store.setLinkActive(slug, false));
3719
- print(link, opts, () => console.log(source_default.green(`Disabled ${link.short_url}`)));
3720
- } catch (error) {
3721
- handleError(error);
3722
- }
3723
- });
3724
- linkCmd.command("enable <slug>").description("Enable a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action((slug, opts) => {
3725
- try {
3726
- const link = withStore((store) => opts.domain ? store.setLinkActive(opts.domain, slug, true) : store.setLinkActive(slug, true));
3727
- print(link, opts, () => console.log(source_default.green(`Enabled ${link.short_url}`)));
3728
- } catch (error) {
3729
- handleError(error);
3730
- }
3731
- });
3732
- linkCmd.command("delete <slug>").description("Delete a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action((slug, opts) => {
3733
- try {
3734
- const link = withStore((store) => opts.domain ? store.deleteLink(opts.domain, slug) : store.deleteLink(slug));
3735
- print(link, opts, () => console.log(source_default.green(`Deleted ${link.short_url}`)));
3736
- } catch (error) {
3737
- handleError(error);
3738
- }
3739
- });
3740
- program2.command("resolve <slug>").description("Resolve a slug to its destination without recording a click").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action((slug, opts) => {
3741
- try {
3742
- const link = withStore((store) => opts.domain ? store.getLink(opts.domain, slug) : store.getLink(slug));
3743
- if (!link)
3744
- throw new Error("Link not found.");
3745
- print(link, opts, () => console.log(link.destination_url));
3746
- } catch (error) {
3747
- handleError(error);
3748
- }
3749
- });
3750
- program2.command("stats [slug]").description("Show overall stats or stats for a shortlink").option("--domain <hostname>", "Domain to use").option("-j, --json", "Output JSON").action((slug, opts) => {
3751
- try {
3752
- const result = withStore((store) => {
3753
- if (slug)
3754
- return opts.domain ? store.getStats(opts.domain, slug) : store.getStats(slug);
3755
- return store.totalStats();
3756
- });
3757
- print(result, opts, () => console.log(JSON.stringify(result, null, 2)));
3758
- } catch (error) {
3759
- handleError(error);
3760
- }
3761
- });
3762
- program2.command("serve").description("Run the redirect server that records clicks").option("--host <host>", "Bind host", "127.0.0.1").option("--port <port>", "Port", "8787").option("--default-host <hostname>", "Fallback host if the request has no Host header").action((opts) => {
3763
- try {
3764
- const server = serveShortlinks({
3765
- dbPath: program2.opts().db,
3766
- host: opts.host,
3767
- port: Number(opts.port),
3768
- defaultHost: opts.defaultHost
3769
- });
3770
- console.log(source_default.green(`shortlinks redirect server listening on http://${server.hostname}:${server.port}`));
3771
- } catch (error) {
3772
- handleError(error);
3773
- }
3774
- });
3775
- var cfCmd = program2.command("cloudflare").description("Cloudflare DNS and Worker helpers");
3776
- cfCmd.command("plan <hostname>").description("Print the Cloudflare setup plan").requiredOption("--target <hostname>", "CNAME target").option("--origin <url>", "Origin redirect server URL", process.env.SHORTLINKS_ORIGIN || "https://shortlinks.example.com").option("--worker <name>", "Worker name", "shortlinks").option("--no-proxied", "Create unproxied DNS record").option("-j, --json", "Output JSON").action((hostname2, opts) => {
3777
- try {
3778
- const plan = createCloudflarePlan({
3779
- hostname: hostname2,
3780
- target: opts.target,
3781
- origin: opts.origin,
3782
- workerName: opts.worker,
3783
- proxied: opts.proxied
3784
- });
3785
- print(plan, opts, () => console.log(JSON.stringify(plan, null, 2)));
3786
- } catch (error) {
3787
- handleError(error);
3788
- }
3789
- });
3790
- cfCmd.command("worker").description("Write Cloudflare Worker files").option("--out-dir <dir>", "Output directory", "cloudflare").option("--worker <name>", "Worker name", "shortlinks").option("--origin <url>", "Origin redirect server URL", process.env.SHORTLINKS_ORIGIN || "https://shortlinks.example.com").option("-j, --json", "Output JSON").action((opts) => {
3791
- try {
3792
- const result = writeWorkerFiles({ outDir: opts.outDir, workerName: opts.worker, origin: opts.origin });
3793
- print(result, opts, () => {
3794
- console.log(source_default.green(`Wrote ${result.workerPath}`));
3795
- console.log(source_default.green(`Wrote ${result.wranglerPath}`));
3796
- });
3797
- } catch (error) {
3798
- handleError(error);
3799
- }
3800
- });
3801
- cfCmd.command("dns <hostname>").description("Create or update the Cloudflare CNAME record").requiredOption("--target <hostname>", "CNAME target").option("--zone-id <id>", "Cloudflare zone ID").option("--dry-run", "Show plan without changing DNS").option("--no-proxied", "Create unproxied DNS record").option("-j, --json", "Output JSON").action(async (hostname2, opts) => {
3802
- try {
3803
- const result = await upsertCloudflareDnsRecord({
3804
- hostname: hostname2,
3805
- target: opts.target,
3806
- zoneId: opts.zoneId,
3807
- dryRun: opts.dryRun,
3808
- proxied: opts.proxied
3809
- });
3810
- print(result, opts, () => console.log(JSON.stringify(result, null, 2)));
3811
- } catch (error) {
3812
- handleError(error);
3813
- }
3814
- });
3815
- var cloudCmd = program2.command("cloud").description("@hasna/cloud sync helpers");
3816
- cloudCmd.command("migrate").description("Apply shortlinks PostgreSQL migrations").option("--connection-string <url>", "PostgreSQL connection string").option("-j, --json", "Output JSON").action(async (opts) => {
3817
- try {
3818
- const { getConnectionString, applyPgMigrations } = await import("@hasna/cloud");
3819
- const conn = opts.connectionString || getConnectionString("shortlinks");
3820
- const result = await applyPgMigrations(conn, PG_MIGRATIONS, "shortlinks");
3821
- print(result, opts, () => console.log(JSON.stringify(result, null, 2)));
3822
- } catch (error) {
3823
- handleError(error);
3824
- }
3825
- });
3826
- async function syncCloud(direction, opts) {
3827
- const {
3828
- getCloudConfig,
3829
- getConnectionString,
3830
- SqliteAdapter,
3831
- PgAdapterAsync,
3832
- listSqliteTables,
3833
- listPgTables,
3834
- syncPush,
3835
- syncPull
3836
- } = await import("@hasna/cloud");
3837
- const config = getCloudConfig();
3838
- if (config.mode === "local")
3839
- throw new Error("Cloud mode is local. Run `cloud setup` first.");
3840
- const local = new SqliteAdapter(getDatabasePath(program2.opts().db));
3841
- const remote = new PgAdapterAsync(getConnectionString("shortlinks"));
3842
- try {
3843
- const requestedTables = opts.tables ? opts.tables.split(",").map((t) => t.trim()).filter(Boolean) : null;
3844
- const localTables = requestedTables || listSqliteTables(local).filter((t) => !t.startsWith("_"));
3845
- const remoteTables = requestedTables || await listPgTables(remote).catch(() => localTables);
3846
- const tables = [...new Set(direction === "pull" ? remoteTables : direction === "push" ? localTables : [...localTables, ...remoteTables])];
3847
- const results = [];
3848
- if (direction === "pull" || direction === "sync") {
3849
- results.push({ direction: "pull", tables: await syncPull(remote, local, { tables }) });
3850
- }
3851
- if (direction === "push" || direction === "sync") {
3852
- results.push({ direction: "push", tables: await syncPush(local, remote, { tables }) });
3853
- }
3854
- print({ service: "shortlinks", results }, opts, () => console.log(JSON.stringify({ service: "shortlinks", results }, null, 2)));
3855
- } finally {
3856
- local.close?.();
3857
- await remote.close?.();
3858
- }
3859
- }
3860
- for (const direction of ["push", "pull", "sync"]) {
3861
- cloudCmd.command(direction).description(`${direction === "sync" ? "Bidirectionally sync" : direction === "push" ? "Push" : "Pull"} shortlinks data ${direction === "pull" ? "from" : "to"} PostgreSQL`).option("--tables <tables>", "Comma-separated table names").option("-j, --json", "Output JSON").action((opts) => syncCloud(direction, opts).catch(handleError));
3862
- }
3863
- cloudCmd.command("status").description("Show local and cloud configuration health").option("-j, --json", "Output JSON").action(async (opts) => {
3864
- try {
3865
- const { getCloudConfig } = await import("@hasna/cloud");
3866
- const stats = withStore((store) => store.totalStats());
3867
- const config = getCloudConfig();
3868
- const data = {
3869
- service: "shortlinks",
3870
- db_path: getDatabasePath(program2.opts().db),
3871
- local: stats,
3872
- cloud_mode: config.mode,
3873
- rds_host: config.rds?.host || null
3874
- };
3875
- print(data, opts, () => console.log(JSON.stringify(data, null, 2)));
3876
- } catch (error) {
3877
- handleError(error);
3878
- }
3879
- });
3880
- var localCmd = program2.command("local").description("Local domain setup helpers");
3881
- localCmd.command("plan <domain>").description("Render hosts and reverse-proxy setup for a local shortlink domain").option("--port <port>", "Local redirect server port", "8787").option("--target-host <host>", "Local target host", "127.0.0.1").option("-j, --json", "Output JSON").action((domain, opts) => {
3882
- try {
3883
- const plan = createLocalSetupPlan({
3884
- domain,
3885
- port: Number(opts.port),
3886
- targetHost: opts.targetHost
3887
- });
3888
- print(plan, opts, () => console.log(JSON.stringify(plan, null, 2)));
3889
- } catch (error) {
3890
- handleError(error);
3891
- }
3892
- });
3893
- localCmd.command("setup <domain>").description("Record local domain mapping with machines and print remaining sudo-only setup").option("--port <port>", "Local redirect server port", "8787").option("--target-host <host>", "Local target host", "127.0.0.1").option("--skip-machines", "Do not call machines dns add").option("-j, --json", "Output JSON").action((domain, opts) => {
3894
- try {
3895
- const plan = createLocalSetupPlan({
3896
- domain,
3897
- port: Number(opts.port),
3898
- targetHost: opts.targetHost
3899
- });
3900
- const machines = opts.skipMachines ? null : registerMachinesDns({
3901
- domain,
3902
- port: Number(opts.port),
3903
- targetHost: opts.targetHost
3904
- });
3905
- const result = { plan, machines };
3906
- print(result, opts, () => {
3907
- if (machines && machines.status !== 0) {
3908
- console.error(source_default.yellow(machines.stderr.trim() || "machines dns add failed"));
3909
- }
3910
- console.log(JSON.stringify(result, null, 2));
3911
- });
3912
- } catch (error) {
3913
- handleError(error);
3914
- }
3915
- });
3916
- program2.command("doctor").description("Check local shortlinks tooling and integration readiness").option("-j, --json", "Output JSON").action((opts) => {
3917
- try {
3918
- const stats = withStore((store) => store.totalStats());
3919
- const data = {
3920
- service: "shortlinks",
3921
- data_dir: getDataDir(),
3922
- config_path: getConfigPath(),
3923
- db_path: getDatabasePath(program2.opts().db),
3924
- db_exists: existsSync3(getDatabasePath(program2.opts().db)),
3925
- stats,
3926
- commands: {
3927
- domains: commandExists("domains"),
3928
- cloud: commandExists("cloud"),
3929
- wrangler: commandExists("wrangler"),
3930
- secrets: commandExists("secrets")
3931
- },
3932
- environment: {
3933
- cloudflare_api_token_present: Boolean(process.env.CLOUDFLARE_API_TOKEN),
3934
- cloudflare_api_key_present: Boolean(process.env.CLOUDFLARE_API_KEY),
3935
- cloudflare_email_present: Boolean(process.env.CLOUDFLARE_EMAIL),
3936
- shortlinks_origin_present: Boolean(process.env.SHORTLINKS_ORIGIN)
3937
- }
3938
- };
3939
- print(data, opts, () => console.log(JSON.stringify(data, null, 2)));
3940
- } catch (error) {
3941
- handleError(error);
3942
- }
3943
- });
3944
- program2.parseAsync(process.argv).catch(handleError);