flags 0.2.2 → 3.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +428 -0
- package/LICENSE.md +21 -0
- package/README.md +44 -93
- package/dist/analytics.cjs +7 -0
- package/dist/analytics.cjs.map +1 -0
- package/dist/analytics.d.cts +8 -0
- package/dist/analytics.d.ts +8 -0
- package/dist/analytics.js +7 -0
- package/dist/analytics.js.map +1 -0
- package/dist/chunk-2UDLZC33.js +9 -0
- package/dist/chunk-2UDLZC33.js.map +1 -0
- package/dist/chunk-AVMIIWOF.cjs +21 -0
- package/dist/chunk-AVMIIWOF.cjs.map +1 -0
- package/dist/chunk-D2GBVCQQ.cjs +406 -0
- package/dist/chunk-D2GBVCQQ.cjs.map +1 -0
- package/dist/chunk-MEG7RDX7.cjs +9 -0
- package/dist/chunk-MEG7RDX7.cjs.map +1 -0
- package/dist/chunk-OQHOV3IB.js +406 -0
- package/dist/chunk-OQHOV3IB.js.map +1 -0
- package/dist/chunk-ZNKTXALY.js +21 -0
- package/dist/chunk-ZNKTXALY.js.map +1 -0
- package/dist/index.cjs +25 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +89 -0
- package/dist/index.d.ts +89 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/next.cjs +611 -0
- package/dist/next.cjs.map +1 -0
- package/dist/next.d.cts +191 -0
- package/dist/next.d.ts +191 -0
- package/dist/next.js +611 -0
- package/dist/next.js.map +1 -0
- package/dist/react.cjs +39 -0
- package/dist/react.cjs.map +1 -0
- package/dist/react.d.cts +20 -0
- package/dist/react.d.ts +20 -0
- package/dist/react.js +39 -0
- package/dist/react.js.map +1 -0
- package/dist/sveltekit.cjs +171 -0
- package/dist/sveltekit.cjs.map +1 -0
- package/dist/sveltekit.d.cts +42 -0
- package/dist/sveltekit.d.ts +42 -0
- package/dist/sveltekit.js +171 -0
- package/dist/sveltekit.js.map +1 -0
- package/dist/types-swW0-Ony.d.cts +236 -0
- package/dist/types-swW0-Ony.d.ts +236 -0
- package/package.json +112 -28
- package/LICENSE +0 -9
- package/dist/flags.cjs +0 -366
- package/dist/flags.cjs.map +0 -1
- package/dist/flags.d.cts +0 -84
- package/dist/flags.d.ts +0 -84
- package/dist/flags.js +0 -330
- package/dist/flags.js.map +0 -1
package/package.json
CHANGED
|
@@ -1,42 +1,126 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "flags",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "
|
|
5
|
-
"type": "module",
|
|
6
|
-
"main": "dist/flags.js",
|
|
7
|
-
"types": "dist/flags.d.ts",
|
|
8
|
-
"files": [
|
|
9
|
-
"/dist"
|
|
10
|
-
],
|
|
3
|
+
"version": "3.1.1",
|
|
4
|
+
"description": "Flags SDK by Vercel - The feature flags toolkit for Next.js and SvelteKit",
|
|
11
5
|
"keywords": [
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"
|
|
6
|
+
"feature flags",
|
|
7
|
+
"Next.js",
|
|
8
|
+
"react",
|
|
9
|
+
"toolbar",
|
|
10
|
+
"overrides",
|
|
11
|
+
"SvelteKit"
|
|
15
12
|
],
|
|
13
|
+
"homepage": "https://flags-sdk.dev",
|
|
14
|
+
"bugs": {
|
|
15
|
+
"url": "https://github.com/vercel/flags/issues"
|
|
16
|
+
},
|
|
16
17
|
"repository": {
|
|
17
18
|
"type": "git",
|
|
18
|
-
"url": "
|
|
19
|
+
"url": "git+https://github.com/vercel/flags.git"
|
|
20
|
+
},
|
|
21
|
+
"license": "MIT",
|
|
22
|
+
"sideEffects": false,
|
|
23
|
+
"type": "module",
|
|
24
|
+
"exports": {
|
|
25
|
+
".": {
|
|
26
|
+
"import": "./dist/index.js",
|
|
27
|
+
"require": "./dist/index.cjs"
|
|
28
|
+
},
|
|
29
|
+
"./next": {
|
|
30
|
+
"import": "./dist/next.js",
|
|
31
|
+
"require": "./dist/next.cjs"
|
|
32
|
+
},
|
|
33
|
+
"./analytics": {
|
|
34
|
+
"import": "./dist/analytics.js",
|
|
35
|
+
"require": "./dist/analytics.cjs"
|
|
36
|
+
},
|
|
37
|
+
"./react": {
|
|
38
|
+
"import": "./dist/react.js",
|
|
39
|
+
"require": "./dist/react.cjs"
|
|
40
|
+
},
|
|
41
|
+
"./sveltekit": {
|
|
42
|
+
"import": "./dist/sveltekit.js",
|
|
43
|
+
"require": "./dist/sveltekit.cjs"
|
|
44
|
+
}
|
|
19
45
|
},
|
|
20
|
-
"
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
46
|
+
"typesVersions": {
|
|
47
|
+
"*": {
|
|
48
|
+
"*": [
|
|
49
|
+
"dist/*.d.ts",
|
|
50
|
+
"dist/*.d.cts"
|
|
51
|
+
],
|
|
52
|
+
"next": [
|
|
53
|
+
"dist/next.d.ts",
|
|
54
|
+
"dist/next.d.cts"
|
|
55
|
+
],
|
|
56
|
+
"react": [
|
|
57
|
+
"dist/react.d.ts",
|
|
58
|
+
"dist/react.d.cts"
|
|
59
|
+
],
|
|
60
|
+
"sveltekit": [
|
|
61
|
+
"dist/sveltekit.d.ts",
|
|
62
|
+
"dist/sveltekit.d.cts"
|
|
63
|
+
]
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"files": [
|
|
67
|
+
"dist",
|
|
68
|
+
"CHANGELOG.md"
|
|
69
|
+
],
|
|
70
|
+
"dependencies": {
|
|
71
|
+
"@edge-runtime/cookies": "^5.0.2",
|
|
72
|
+
"jose": "^5.2.1"
|
|
25
73
|
},
|
|
26
74
|
"devDependencies": {
|
|
27
|
-
"@
|
|
28
|
-
"@types/
|
|
29
|
-
"@
|
|
30
|
-
"
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"
|
|
34
|
-
"
|
|
35
|
-
"typescript
|
|
75
|
+
"@arethetypeswrong/cli": "0.17.3",
|
|
76
|
+
"@types/node": "20.11.17",
|
|
77
|
+
"@types/react": "18.2.55",
|
|
78
|
+
"@vitejs/plugin-react": "4.2.1",
|
|
79
|
+
"msw": "2.6.4",
|
|
80
|
+
"next": "15.1.4",
|
|
81
|
+
"react": "canary",
|
|
82
|
+
"tsup": "8.0.1",
|
|
83
|
+
"typescript": "5.6.3",
|
|
84
|
+
"vite": "5.1.1",
|
|
85
|
+
"vitest": "1.4.0",
|
|
86
|
+
"eslint-config-custom": "0.0.0",
|
|
87
|
+
"tsconfig": "0.0.0"
|
|
88
|
+
},
|
|
89
|
+
"peerDependencies": {
|
|
90
|
+
"@opentelemetry/api": "^1.7.0",
|
|
91
|
+
"@sveltejs/kit": "*",
|
|
92
|
+
"next": "*",
|
|
93
|
+
"react": "*",
|
|
94
|
+
"react-dom": "*"
|
|
95
|
+
},
|
|
96
|
+
"peerDependenciesMeta": {
|
|
97
|
+
"@opentelemetry/api": {
|
|
98
|
+
"optional": true
|
|
99
|
+
},
|
|
100
|
+
"@sveltejs/kit": {
|
|
101
|
+
"optional": true
|
|
102
|
+
},
|
|
103
|
+
"next": {
|
|
104
|
+
"optional": true
|
|
105
|
+
},
|
|
106
|
+
"react": {
|
|
107
|
+
"optional": true
|
|
108
|
+
},
|
|
109
|
+
"react-dom": {
|
|
110
|
+
"optional": true
|
|
111
|
+
}
|
|
112
|
+
},
|
|
113
|
+
"publishConfig": {
|
|
114
|
+
"access": "public"
|
|
36
115
|
},
|
|
37
116
|
"scripts": {
|
|
117
|
+
"attw": "attw --pack .",
|
|
38
118
|
"build": "tsup",
|
|
39
|
-
"
|
|
40
|
-
"
|
|
119
|
+
"dev": "tsup --watch --clean=false",
|
|
120
|
+
"eslint": "eslint-runner",
|
|
121
|
+
"eslint:fix": "eslint-runner --fix",
|
|
122
|
+
"test": "vitest --run",
|
|
123
|
+
"test:watch": "vitest",
|
|
124
|
+
"type-check": "tsc --noEmit"
|
|
41
125
|
}
|
|
42
126
|
}
|
package/LICENSE
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
The MIT License (MIT)
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2011 Daniel Pupius
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
|
6
|
-
|
|
7
|
-
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
|
8
|
-
|
|
9
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
package/dist/flags.cjs
DELETED
|
@@ -1,366 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __defProp = Object.defineProperty;
|
|
3
|
-
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
-
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
-
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
-
var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
|
|
7
|
-
var __export = (target, all) => {
|
|
8
|
-
for (var name in all)
|
|
9
|
-
__defProp(target, name, { get: all[name], enumerable: true });
|
|
10
|
-
};
|
|
11
|
-
var __copyProps = (to, from, except, desc) => {
|
|
12
|
-
if (from && typeof from === "object" || typeof from === "function") {
|
|
13
|
-
for (let key of __getOwnPropNames(from))
|
|
14
|
-
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
15
|
-
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
16
|
-
}
|
|
17
|
-
return to;
|
|
18
|
-
};
|
|
19
|
-
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
20
|
-
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
21
|
-
|
|
22
|
-
// src/flags.ts
|
|
23
|
-
var flags_exports = {};
|
|
24
|
-
__export(flags_exports, {
|
|
25
|
-
FLAGS: () => FLAGS,
|
|
26
|
-
defineBoolean: () => defineBoolean,
|
|
27
|
-
defineInteger: () => defineInteger,
|
|
28
|
-
defineMultiString: () => defineMultiString,
|
|
29
|
-
defineNumber: () => defineNumber,
|
|
30
|
-
defineString: () => defineString,
|
|
31
|
-
defineStringList: () => defineStringList,
|
|
32
|
-
get: () => get,
|
|
33
|
-
help: () => help,
|
|
34
|
-
isSet: () => isSet,
|
|
35
|
-
parse: () => parse,
|
|
36
|
-
reset: () => reset,
|
|
37
|
-
setExitOnError: () => setExitOnError,
|
|
38
|
-
setUsageInfo: () => setUsageInfo
|
|
39
|
-
});
|
|
40
|
-
module.exports = __toCommonJS(flags_exports);
|
|
41
|
-
if (typeof global.GLOBAL_FLAGS === "undefined") {
|
|
42
|
-
global.GLOBAL_FLAGS = {};
|
|
43
|
-
}
|
|
44
|
-
var FLAGS = global.GLOBAL_FLAGS;
|
|
45
|
-
var exitOnError = true;
|
|
46
|
-
var usageInfo = "Usage: node " + (process.argv[1] || "").split("/").pop() + " [options]";
|
|
47
|
-
function setExitOnError(value) {
|
|
48
|
-
exitOnError = value;
|
|
49
|
-
}
|
|
50
|
-
function setUsageInfo(value) {
|
|
51
|
-
usageInfo = value;
|
|
52
|
-
}
|
|
53
|
-
function defineString(name, defaultValue, description) {
|
|
54
|
-
return addFlag(name, new StringFlag(name, defaultValue, description));
|
|
55
|
-
}
|
|
56
|
-
function defineBoolean(name, defaultValue, description) {
|
|
57
|
-
return addFlag(name, new BooleanFlag(name, defaultValue, description));
|
|
58
|
-
}
|
|
59
|
-
function defineInteger(name, defaultValue, description) {
|
|
60
|
-
return addFlag(name, new IntegerFlag(name, defaultValue, description));
|
|
61
|
-
}
|
|
62
|
-
function defineNumber(name, defaultValue, description) {
|
|
63
|
-
return addFlag(name, new NumberFlag(name, defaultValue, description));
|
|
64
|
-
}
|
|
65
|
-
function defineStringList(name, defaultValue, description) {
|
|
66
|
-
return addFlag(name, new StringListFlag(name, defaultValue, description));
|
|
67
|
-
}
|
|
68
|
-
function defineMultiString(name, defaultValue, description) {
|
|
69
|
-
return addFlag(name, new MultiStringFlag(name, defaultValue, description));
|
|
70
|
-
}
|
|
71
|
-
function help() {
|
|
72
|
-
if (usageInfo) {
|
|
73
|
-
console.log(usageInfo + "\n");
|
|
74
|
-
}
|
|
75
|
-
console.log("Options:");
|
|
76
|
-
for (const flag in FLAGS) {
|
|
77
|
-
if (!FLAGS[flag].isSecret) {
|
|
78
|
-
console.log(FLAGS[flag].toHelpString());
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
function reset() {
|
|
83
|
-
parseCalled = false;
|
|
84
|
-
Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);
|
|
85
|
-
registerInternalFlags();
|
|
86
|
-
}
|
|
87
|
-
function get(name) {
|
|
88
|
-
if (!FLAGS[name]) throw Error('Unknown flag "' + name + '"');
|
|
89
|
-
return FLAGS[name].get();
|
|
90
|
-
}
|
|
91
|
-
function isSet(name) {
|
|
92
|
-
if (!FLAGS[name]) throw Error('Unknown flag "' + name + '"');
|
|
93
|
-
return FLAGS[name].isSet;
|
|
94
|
-
}
|
|
95
|
-
function parse(args = process.argv.slice(2), ignoreUnrecognized) {
|
|
96
|
-
if (parseCalled) return [];
|
|
97
|
-
for (let i = 0; i < args.length; i++) {
|
|
98
|
-
const arg = args[i];
|
|
99
|
-
if (arg == "--") {
|
|
100
|
-
return args.slice(i + 1);
|
|
101
|
-
} else if (arg.startsWith("--")) {
|
|
102
|
-
let flag = arg.slice(2);
|
|
103
|
-
let value = null;
|
|
104
|
-
if (flag.indexOf("=") > -1) {
|
|
105
|
-
const parts = flag.split("=");
|
|
106
|
-
flag = parts[0];
|
|
107
|
-
value = parts.slice(1).join("=");
|
|
108
|
-
}
|
|
109
|
-
if (value == null && args[i + 1] && !args[i + 1].startsWith("--")) {
|
|
110
|
-
args[i] = args[i] + " " + args[i + 1];
|
|
111
|
-
value = args[i + 1];
|
|
112
|
-
args.splice(i + 1, 1);
|
|
113
|
-
}
|
|
114
|
-
if (!FLAGS[flag] && value == null && flag.startsWith("no")) {
|
|
115
|
-
flag = flag.slice(2);
|
|
116
|
-
value = "0";
|
|
117
|
-
}
|
|
118
|
-
if (FLAGS[flag]) {
|
|
119
|
-
try {
|
|
120
|
-
FLAGS[flag].set(value);
|
|
121
|
-
} catch (e) {
|
|
122
|
-
throwFlagParseError(args, i, e.message);
|
|
123
|
-
}
|
|
124
|
-
} else if (!ignoreUnrecognized) {
|
|
125
|
-
throwFlagParseError(args, i, 'Unrecognized flag name "' + arg + '"');
|
|
126
|
-
}
|
|
127
|
-
} else {
|
|
128
|
-
throwFlagParseError(args, i, 'Invalid argument "' + arg + '"');
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
parseCalled = true;
|
|
132
|
-
if (FLAGS.help.get()) {
|
|
133
|
-
help();
|
|
134
|
-
process.exit(0);
|
|
135
|
-
}
|
|
136
|
-
Object.keys(FLAGS).forEach((key) => {
|
|
137
|
-
if (FLAGS[key].isRequired && !FLAGS[key].isSet) {
|
|
138
|
-
throwFlagParseError(args, -1, 'Missing required flag "--' + key + '"');
|
|
139
|
-
}
|
|
140
|
-
});
|
|
141
|
-
return [];
|
|
142
|
-
}
|
|
143
|
-
var parseCalled = false;
|
|
144
|
-
function throwFlagParseError(args, i, msg) {
|
|
145
|
-
let errorMsg = "FLAG PARSING ERROR: " + msg;
|
|
146
|
-
if (i > -1) {
|
|
147
|
-
errorMsg += "\n " + args.join(" ") + "\n " + new Array(args.slice(0, i).join(" ").length + 2).join(" ") + new Array(args[i].length + 1).join("^");
|
|
148
|
-
}
|
|
149
|
-
if (exitOnError) {
|
|
150
|
-
console.error(errorMsg);
|
|
151
|
-
process.exit(1);
|
|
152
|
-
} else {
|
|
153
|
-
throw Error(errorMsg);
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
function addFlag(name, flag) {
|
|
157
|
-
if (parseCalled) throw Error("Can not register new flags after parse()");
|
|
158
|
-
if (FLAGS[name]) throw Error('Flag already defined: "' + name + '"');
|
|
159
|
-
FLAGS[name] = flag;
|
|
160
|
-
return flag;
|
|
161
|
-
}
|
|
162
|
-
function wrapText(text, maxLen) {
|
|
163
|
-
const lines = text.split("\n");
|
|
164
|
-
const out = [];
|
|
165
|
-
lines.forEach((line) => {
|
|
166
|
-
const maxLenx = maxLen + (out.length == 0 ? 4 : 0);
|
|
167
|
-
if (line.length < maxLenx) {
|
|
168
|
-
out.push(line);
|
|
169
|
-
} else {
|
|
170
|
-
const current = wrapLine(line, " ", maxLenx, out);
|
|
171
|
-
if (current != "") {
|
|
172
|
-
out.push(current);
|
|
173
|
-
}
|
|
174
|
-
}
|
|
175
|
-
});
|
|
176
|
-
return out.join("\n ");
|
|
177
|
-
}
|
|
178
|
-
function wrapLine(line, delimiter, maxLen, out) {
|
|
179
|
-
const parts = line.split(delimiter);
|
|
180
|
-
let current = "";
|
|
181
|
-
parts.forEach((part) => {
|
|
182
|
-
const next = current + part + delimiter;
|
|
183
|
-
if (next.length > maxLen) {
|
|
184
|
-
out.push(current);
|
|
185
|
-
current = part + delimiter;
|
|
186
|
-
} else {
|
|
187
|
-
current = next;
|
|
188
|
-
}
|
|
189
|
-
});
|
|
190
|
-
return current;
|
|
191
|
-
}
|
|
192
|
-
var Flag = class {
|
|
193
|
-
constructor(name, defaultValue, description) {
|
|
194
|
-
__publicField(this, "name");
|
|
195
|
-
__publicField(this, "defaultValue");
|
|
196
|
-
__publicField(this, "description");
|
|
197
|
-
__publicField(this, "currentValue");
|
|
198
|
-
__publicField(this, "validator");
|
|
199
|
-
__publicField(this, "isSecret");
|
|
200
|
-
__publicField(this, "isSet");
|
|
201
|
-
__publicField(this, "isRequired");
|
|
202
|
-
this.name = name;
|
|
203
|
-
this.defaultValue = defaultValue;
|
|
204
|
-
this.description = description;
|
|
205
|
-
this.currentValue = null;
|
|
206
|
-
this.isSecret = false;
|
|
207
|
-
this.isSet = false;
|
|
208
|
-
this.isRequired = false;
|
|
209
|
-
}
|
|
210
|
-
/** Set a default value. */
|
|
211
|
-
setDefault(defaultValue) {
|
|
212
|
-
this.defaultValue = defaultValue;
|
|
213
|
-
return this;
|
|
214
|
-
}
|
|
215
|
-
/** Set whether this flag is required. */
|
|
216
|
-
setRequired(isRequired) {
|
|
217
|
-
this.isRequired = isRequired;
|
|
218
|
-
return this;
|
|
219
|
-
}
|
|
220
|
-
/** Set a description for use in the help message. */
|
|
221
|
-
setDescription(description) {
|
|
222
|
-
this.description = description;
|
|
223
|
-
return this;
|
|
224
|
-
}
|
|
225
|
-
/** Set a custom validator. */
|
|
226
|
-
setValidator(validator) {
|
|
227
|
-
this.validator = validator;
|
|
228
|
-
return this;
|
|
229
|
-
}
|
|
230
|
-
/** Hide this flag from the help message. */
|
|
231
|
-
setSecret(isSecret) {
|
|
232
|
-
this.isSecret = isSecret;
|
|
233
|
-
return this;
|
|
234
|
-
}
|
|
235
|
-
set(input) {
|
|
236
|
-
if (this.isSet) {
|
|
237
|
-
throw Error("Flag already set");
|
|
238
|
-
}
|
|
239
|
-
if (typeof input === "string") {
|
|
240
|
-
this.currentValue = this.parseInput(input);
|
|
241
|
-
} else if (input === null) {
|
|
242
|
-
this.currentValue = this.parseInput(null);
|
|
243
|
-
} else {
|
|
244
|
-
this.currentValue = input;
|
|
245
|
-
}
|
|
246
|
-
if (this.validator) this.validator(this.currentValue);
|
|
247
|
-
this.isSet = true;
|
|
248
|
-
}
|
|
249
|
-
get() {
|
|
250
|
-
return this.isSet ? this.currentValue : this.defaultValue;
|
|
251
|
-
}
|
|
252
|
-
parseInput(_inp) {
|
|
253
|
-
throw Error("Not implemented");
|
|
254
|
-
}
|
|
255
|
-
toHelpString() {
|
|
256
|
-
return wrapText(" --" + this.name + ": " + this.description, 70) + "\n (default: " + JSON.stringify(this.defaultValue) + ")";
|
|
257
|
-
}
|
|
258
|
-
};
|
|
259
|
-
var BooleanFlag = class extends Flag {
|
|
260
|
-
constructor(name, defaultValue, description) {
|
|
261
|
-
super(name, defaultValue ?? false, description);
|
|
262
|
-
}
|
|
263
|
-
parseInput(inp) {
|
|
264
|
-
if (inp === null) {
|
|
265
|
-
return true;
|
|
266
|
-
}
|
|
267
|
-
inp = inp.toLowerCase();
|
|
268
|
-
if (inp === "1" || inp === "true" || inp == "t") {
|
|
269
|
-
return true;
|
|
270
|
-
} else if (inp === "0" || inp === "false" || inp == "f") {
|
|
271
|
-
return false;
|
|
272
|
-
} else {
|
|
273
|
-
throw Error('Invalid Boolean flag "' + inp + '"');
|
|
274
|
-
}
|
|
275
|
-
}
|
|
276
|
-
get() {
|
|
277
|
-
return !!super.get();
|
|
278
|
-
}
|
|
279
|
-
toHelpString() {
|
|
280
|
-
return wrapText(" --[no]" + this.name + ": " + this.description, 70) + "\n (default: " + JSON.stringify(this.defaultValue) + ")";
|
|
281
|
-
}
|
|
282
|
-
};
|
|
283
|
-
var IntegerFlag = class extends Flag {
|
|
284
|
-
constructor(name, defaultValue, description) {
|
|
285
|
-
super(name, defaultValue ?? 0, description);
|
|
286
|
-
}
|
|
287
|
-
parseInput(inp) {
|
|
288
|
-
if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {
|
|
289
|
-
throw Error('Invalid Integer flag "' + inp + '"');
|
|
290
|
-
}
|
|
291
|
-
return Number(inp);
|
|
292
|
-
}
|
|
293
|
-
toHelpString() {
|
|
294
|
-
return super.toHelpString() + "\n (an integer)";
|
|
295
|
-
}
|
|
296
|
-
};
|
|
297
|
-
var NumberFlag = class extends Flag {
|
|
298
|
-
constructor(name, defaultValue, description) {
|
|
299
|
-
super(name, defaultValue ?? 0, description);
|
|
300
|
-
}
|
|
301
|
-
parseInput(inp) {
|
|
302
|
-
if (isNaN(Number(inp))) {
|
|
303
|
-
throw Error('Invalid Number flag "' + inp + '"');
|
|
304
|
-
}
|
|
305
|
-
return Number(inp);
|
|
306
|
-
}
|
|
307
|
-
toHelpString() {
|
|
308
|
-
return super.toHelpString() + "\n (a number)";
|
|
309
|
-
}
|
|
310
|
-
};
|
|
311
|
-
var StringFlag = class extends Flag {
|
|
312
|
-
constructor(name, defaultValue, description) {
|
|
313
|
-
super(name, defaultValue ?? "", description);
|
|
314
|
-
}
|
|
315
|
-
parseInput(inp) {
|
|
316
|
-
if (inp === null) {
|
|
317
|
-
throw Error('Invalid String flag "' + inp + '"');
|
|
318
|
-
}
|
|
319
|
-
return inp;
|
|
320
|
-
}
|
|
321
|
-
toHelpString() {
|
|
322
|
-
return super.toHelpString() + "\n (a string)";
|
|
323
|
-
}
|
|
324
|
-
};
|
|
325
|
-
var StringListFlag = class extends Flag {
|
|
326
|
-
constructor(name, defaultValue, description) {
|
|
327
|
-
super(name, defaultValue ?? [], description);
|
|
328
|
-
}
|
|
329
|
-
parseInput(inp) {
|
|
330
|
-
if (inp === null) return [];
|
|
331
|
-
else return inp.split(",");
|
|
332
|
-
}
|
|
333
|
-
};
|
|
334
|
-
var MultiStringFlag = class extends Flag {
|
|
335
|
-
constructor(name, defaultValue, description) {
|
|
336
|
-
super(name, defaultValue ?? [], description);
|
|
337
|
-
}
|
|
338
|
-
set(input) {
|
|
339
|
-
if (this.validator) this.validator(input);
|
|
340
|
-
if (!this.currentValue) this.currentValue = [];
|
|
341
|
-
this.currentValue.push(...input);
|
|
342
|
-
this.isSet = true;
|
|
343
|
-
}
|
|
344
|
-
};
|
|
345
|
-
function registerInternalFlags() {
|
|
346
|
-
defineBoolean("help").setDescription("Shows this help text.").setSecret(true);
|
|
347
|
-
}
|
|
348
|
-
registerInternalFlags();
|
|
349
|
-
// Annotate the CommonJS export names for ESM import in node:
|
|
350
|
-
0 && (module.exports = {
|
|
351
|
-
FLAGS,
|
|
352
|
-
defineBoolean,
|
|
353
|
-
defineInteger,
|
|
354
|
-
defineMultiString,
|
|
355
|
-
defineNumber,
|
|
356
|
-
defineString,
|
|
357
|
-
defineStringList,
|
|
358
|
-
get,
|
|
359
|
-
help,
|
|
360
|
-
isSet,
|
|
361
|
-
parse,
|
|
362
|
-
reset,
|
|
363
|
-
setExitOnError,
|
|
364
|
-
setUsageInfo
|
|
365
|
-
});
|
|
366
|
-
//# sourceMappingURL=flags.cjs.map
|
package/dist/flags.cjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/flags.ts"],"sourcesContent":["// Define interfaces for our flag types\ninterface IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n isRequired: boolean;\n setDefault(defaultValue: T): this;\n setRequired(required: boolean): this;\n setDescription(description: string): this;\n setValidator(validator: (input: T | null) => boolean): this;\n setSecret(isSecret: boolean): this;\n set(input: T): void;\n get(): T | null;\n parseInput(inp: string): T | null;\n toHelpString(): string;\n}\n\n// Define the global flags object\ndeclare global {\n var GLOBAL_FLAGS: { [key: string]: IFlag<any> };\n}\n\nif (typeof global.GLOBAL_FLAGS === \"undefined\") {\n global.GLOBAL_FLAGS = {};\n}\n\nconst FLAGS: { [key: string]: IFlag<any> } = global.GLOBAL_FLAGS;\n\n/**\n * An object containing a map of flag objects. If different modules are\n * importing different versions of the library we want them to use the same\n * FLAGS object. This does mean that the flags library needs to be backwards\n * compatible.\n */\nexport { FLAGS };\n\nlet exitOnError = true;\n\nlet usageInfo =\n \"Usage: node \" + (process.argv[1] || \"\").split(\"/\").pop() + \" [options]\";\n\n/**\n * If true, then the process will be nicely exit on a parse error. If false,\n * an Error will be thrown. Set to false in tests.\n */\nexport function setExitOnError(value: boolean) {\n exitOnError = value;\n}\n\n/**\n * Allows an app to add extra usage information that will be shown in the help\n * message, above the flags.\n */\nexport function setUsageInfo(value: string) {\n usageInfo = value;\n}\n\n/**\n * Defines a string flag. e.g. --servername=bob\n */\nexport function defineString(\n name: string,\n defaultValue?: string,\n description?: string\n): IFlag<string> {\n return addFlag(name, new StringFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a boolean flag. e.g. --turnonlights\n */\nexport function defineBoolean(\n name: string,\n defaultValue?: boolean,\n description?: string\n): IFlag<boolean> {\n return addFlag(name, new BooleanFlag(name, defaultValue, description));\n}\n\n/**\n * Defines an integer flag. e.g. --age=12\n */\nexport function defineInteger(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new IntegerFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a number flag. e.g. --number=1.345\n */\nexport function defineNumber(\n name: string,\n defaultValue?: number,\n description?: string\n): IFlag<number> {\n return addFlag(name, new NumberFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a string list flag. e.g. --animal=frog,bat,chicken\n */\nexport function defineStringList(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new StringListFlag(name, defaultValue, description));\n}\n\n/**\n * Defines a multi string flag. e.g. --allowedip=127.0.0.1 --allowedip=127.0.0.2\n */\nexport function defineMultiString(\n name: string,\n defaultValue?: string[],\n description?: string\n): IFlag<string[]> {\n return addFlag(name, new MultiStringFlag(name, defaultValue, description));\n}\n\n/**\n * Dumps the help text to the console.\n */\nexport function help(): void {\n if (usageInfo) {\n console.log(usageInfo + \"\\n\");\n }\n console.log(\"Options:\");\n for (const flag in FLAGS) {\n if (!FLAGS[flag].isSecret) {\n console.log(FLAGS[flag].toHelpString());\n }\n }\n}\n\n/**\n * Resets the flag values.\n */\nexport function reset(): void {\n parseCalled = false;\n Object.keys(FLAGS).forEach((key) => delete FLAGS[key]);\n registerInternalFlags();\n}\n\n/**\n * Gets the current value of the given flag.\n */\nexport function get(name: string): unknown {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].get();\n}\n\n/**\n * Gets whether or not the flag was set.\n */\nexport function isSet(name: string): boolean {\n if (!FLAGS[name]) throw Error('Unknown flag \"' + name + '\"');\n return FLAGS[name].isSet;\n}\n\n/**\n * Parses process.argv for flags. Idempotent if called multiple times.\n */\nexport function parse(\n args: string[] = process.argv.slice(2),\n ignoreUnrecognized?: boolean\n): string[] {\n if (parseCalled) return [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i];\n\n if (arg == \"--\") {\n return args.slice(i + 1);\n } else if (arg.startsWith(\"--\")) {\n let flag = arg.slice(2);\n let value: string | null = null;\n if (flag.indexOf(\"=\") > -1) {\n const parts = flag.split(\"=\");\n flag = parts[0];\n value = parts.slice(1).join(\"=\");\n }\n\n if (value == null && args[i + 1] && !args[i + 1].startsWith(\"--\")) {\n args[i] = args[i] + \" \" + args[i + 1];\n value = args[i + 1];\n args.splice(i + 1, 1);\n }\n\n if (!FLAGS[flag] && value == null && flag.startsWith(\"no\")) {\n flag = flag.slice(2);\n value = \"0\";\n }\n\n if (FLAGS[flag]) {\n try {\n FLAGS[flag].set(value);\n } catch (e) {\n throwFlagParseError(args, i, (e as Error).message);\n }\n } else if (!ignoreUnrecognized) {\n throwFlagParseError(args, i, 'Unrecognized flag name \"' + arg + '\"');\n }\n } else {\n throwFlagParseError(args, i, 'Invalid argument \"' + arg + '\"');\n }\n }\n\n parseCalled = true;\n\n if (FLAGS.help.get()) {\n help();\n process.exit(0);\n }\n\n Object.keys(FLAGS).forEach((key) => {\n if (FLAGS[key].isRequired && !FLAGS[key].isSet) {\n throwFlagParseError(args, -1, 'Missing required flag \"--' + key + '\"');\n }\n });\n\n return [];\n}\n\n// Private helpers\nlet parseCalled = false;\n\nfunction throwFlagParseError(args: string[], i: number, msg: string): void {\n let errorMsg = \"FLAG PARSING ERROR: \" + msg;\n if (i > -1) {\n errorMsg +=\n \"\\n \" +\n args.join(\" \") +\n \"\\n \" +\n new Array(args.slice(0, i).join(\" \").length + 2).join(\" \") +\n new Array(args[i].length + 1).join(\"^\");\n }\n\n if (exitOnError) {\n console.error(errorMsg);\n process.exit(1);\n } else {\n throw Error(errorMsg);\n }\n}\n\nfunction addFlag<T>(name: string, flag: IFlag<T>): IFlag<T> {\n if (parseCalled) throw Error(\"Can not register new flags after parse()\");\n if (FLAGS[name]) throw Error('Flag already defined: \"' + name + '\"');\n FLAGS[name] = flag;\n return flag;\n}\n\nfunction wrapText(text: string, maxLen: number): string {\n const lines = text.split(\"\\n\");\n const out: string[] = [];\n lines.forEach((line) => {\n const maxLenx = maxLen + (out.length == 0 ? 4 : 0);\n if (line.length < maxLenx) {\n out.push(line);\n } else {\n const current = wrapLine(line, \" \", maxLenx, out);\n if (current != \"\") {\n out.push(current);\n }\n }\n });\n return out.join(\"\\n \");\n}\n\nfunction wrapLine(\n line: string,\n delimiter: string,\n maxLen: number,\n out: string[]\n): string {\n const parts = line.split(delimiter);\n let current = \"\";\n parts.forEach((part) => {\n const next = current + part + delimiter;\n if (next.length > maxLen) {\n out.push(current);\n current = part + delimiter;\n } else {\n current = next;\n }\n });\n return current;\n}\n\nclass Flag<T> implements IFlag<T> {\n name: string;\n defaultValue: T;\n description?: string;\n currentValue: T | null;\n validator?: (input: T | null) => boolean;\n isSecret: boolean;\n isSet: boolean;\n isRequired: boolean;\n\n constructor(name: string, defaultValue: T, description?: string) {\n this.name = name;\n this.defaultValue = defaultValue;\n this.description = description;\n this.currentValue = null;\n this.isSecret = false;\n this.isSet = false;\n this.isRequired = false;\n }\n\n /** Set a default value. */\n setDefault(defaultValue: T): this {\n this.defaultValue = defaultValue;\n return this;\n }\n\n /** Set whether this flag is required. */\n setRequired(isRequired: boolean): this {\n this.isRequired = isRequired;\n return this;\n }\n\n /** Set a description for use in the help message. */\n setDescription(description: string): this {\n this.description = description;\n return this;\n }\n\n /** Set a custom validator. */\n setValidator(validator: (input: T | null) => boolean): this {\n this.validator = validator;\n return this;\n }\n\n /** Hide this flag from the help message. */\n setSecret(isSecret: boolean): this {\n this.isSecret = isSecret;\n return this;\n }\n\n set(input: T | string): void {\n if (this.isSet) {\n throw Error(\"Flag already set\");\n }\n if (typeof input === \"string\") {\n this.currentValue = this.parseInput(input);\n } else if (input === null) {\n this.currentValue = this.parseInput(null);\n } else {\n this.currentValue = input;\n }\n if (this.validator) this.validator(this.currentValue);\n this.isSet = true;\n }\n\n get(): T | null {\n return this.isSet ? this.currentValue : this.defaultValue;\n }\n\n parseInput(_inp: string | null): T | null {\n throw Error(\"Not implemented\");\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass BooleanFlag extends Flag<boolean> implements IFlag<boolean> {\n constructor(name: string, defaultValue?: boolean, description?: string) {\n super(name, defaultValue ?? false, description);\n }\n\n parseInput(inp: string | null): boolean {\n if (inp === null) {\n // Empty flag value means true for a boolean flag.\n return true;\n }\n inp = inp.toLowerCase();\n if (inp === \"1\" || inp === \"true\" || inp == \"t\") {\n return true;\n } else if (inp === \"0\" || inp === \"false\" || inp == \"f\") {\n return false;\n } else {\n throw Error('Invalid Boolean flag \"' + inp + '\"');\n }\n }\n\n get(): boolean {\n return !!super.get();\n }\n\n toHelpString(): string {\n return (\n wrapText(\" --[no]\" + this.name + \": \" + this.description, 70) +\n \"\\n\" +\n \" (default: \" +\n JSON.stringify(this.defaultValue) +\n \")\"\n );\n }\n}\n\nclass IntegerFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string): number {\n if (isNaN(Number(inp)) || parseInt(inp, 10) !== Number(inp)) {\n throw Error('Invalid Integer flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (an integer)\";\n }\n}\n\nclass NumberFlag extends Flag<number> implements IFlag<number> {\n constructor(name: string, defaultValue?: number, description?: string) {\n super(name, defaultValue ?? 0, description);\n }\n\n parseInput(inp: string | null): number {\n if (isNaN(Number(inp))) {\n throw Error('Invalid Number flag \"' + inp + '\"');\n }\n return Number(inp);\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a number)\";\n }\n}\n\nclass StringFlag extends Flag<string> implements IFlag<string> {\n constructor(name: string, defaultValue?: string, description?: string) {\n super(name, defaultValue ?? \"\", description);\n }\n\n parseInput(inp: string | null): string {\n if (inp === null) {\n throw Error('Invalid String flag \"' + inp + '\"');\n }\n return inp;\n }\n\n toHelpString(): string {\n return super.toHelpString() + \"\\n (a string)\";\n }\n}\n\nclass StringListFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n parseInput(inp: string | null): string[] {\n if (inp === null) return [];\n else return inp.split(\",\");\n }\n}\n\nclass MultiStringFlag extends Flag<string[]> implements IFlag<string[]> {\n constructor(name: string, defaultValue?: string[], description?: string) {\n super(name, defaultValue ?? [], description);\n }\n\n set(input: string[]): void {\n if (this.validator) this.validator(input);\n if (!this.currentValue) this.currentValue = [];\n this.currentValue.push(...input);\n this.isSet = true;\n }\n}\n\n// Internal flags\nfunction registerInternalFlags(): void {\n defineBoolean(\"help\").setDescription(\"Shows this help text.\").setSecret(true);\n // TODO: --flagsfile\n}\n\nregisterInternalFlags();\n"],"mappings":"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","names":[]}
|
package/dist/flags.d.cts
DELETED
|
@@ -1,84 +0,0 @@
|
|
|
1
|
-
interface IFlag<T> {
|
|
2
|
-
name: string;
|
|
3
|
-
defaultValue: T;
|
|
4
|
-
description?: string;
|
|
5
|
-
currentValue: T | null;
|
|
6
|
-
validator?: (input: T | null) => boolean;
|
|
7
|
-
isSecret: boolean;
|
|
8
|
-
isSet: boolean;
|
|
9
|
-
isRequired: boolean;
|
|
10
|
-
setDefault(defaultValue: T): this;
|
|
11
|
-
setRequired(required: boolean): this;
|
|
12
|
-
setDescription(description: string): this;
|
|
13
|
-
setValidator(validator: (input: T | null) => boolean): this;
|
|
14
|
-
setSecret(isSecret: boolean): this;
|
|
15
|
-
set(input: T): void;
|
|
16
|
-
get(): T | null;
|
|
17
|
-
parseInput(inp: string): T | null;
|
|
18
|
-
toHelpString(): string;
|
|
19
|
-
}
|
|
20
|
-
declare global {
|
|
21
|
-
var GLOBAL_FLAGS: {
|
|
22
|
-
[key: string]: IFlag<any>;
|
|
23
|
-
};
|
|
24
|
-
}
|
|
25
|
-
declare const FLAGS: {
|
|
26
|
-
[key: string]: IFlag<any>;
|
|
27
|
-
};
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* If true, then the process will be nicely exit on a parse error. If false,
|
|
31
|
-
* an Error will be thrown. Set to false in tests.
|
|
32
|
-
*/
|
|
33
|
-
declare function setExitOnError(value: boolean): void;
|
|
34
|
-
/**
|
|
35
|
-
* Allows an app to add extra usage information that will be shown in the help
|
|
36
|
-
* message, above the flags.
|
|
37
|
-
*/
|
|
38
|
-
declare function setUsageInfo(value: string): void;
|
|
39
|
-
/**
|
|
40
|
-
* Defines a string flag. e.g. --servername=bob
|
|
41
|
-
*/
|
|
42
|
-
declare function defineString(name: string, defaultValue?: string, description?: string): IFlag<string>;
|
|
43
|
-
/**
|
|
44
|
-
* Defines a boolean flag. e.g. --turnonlights
|
|
45
|
-
*/
|
|
46
|
-
declare function defineBoolean(name: string, defaultValue?: boolean, description?: string): IFlag<boolean>;
|
|
47
|
-
/**
|
|
48
|
-
* Defines an integer flag. e.g. --age=12
|
|
49
|
-
*/
|
|
50
|
-
declare function defineInteger(name: string, defaultValue?: number, description?: string): IFlag<number>;
|
|
51
|
-
/**
|
|
52
|
-
* Defines a number flag. e.g. --number=1.345
|
|
53
|
-
*/
|
|
54
|
-
declare function defineNumber(name: string, defaultValue?: number, description?: string): IFlag<number>;
|
|
55
|
-
/**
|
|
56
|
-
* Defines a string list flag. e.g. --animal=frog,bat,chicken
|
|
57
|
-
*/
|
|
58
|
-
declare function defineStringList(name: string, defaultValue?: string[], description?: string): IFlag<string[]>;
|
|
59
|
-
/**
|
|
60
|
-
* Defines a multi string flag. e.g. --allowedip=127.0.0.1 --allowedip=127.0.0.2
|
|
61
|
-
*/
|
|
62
|
-
declare function defineMultiString(name: string, defaultValue?: string[], description?: string): IFlag<string[]>;
|
|
63
|
-
/**
|
|
64
|
-
* Dumps the help text to the console.
|
|
65
|
-
*/
|
|
66
|
-
declare function help(): void;
|
|
67
|
-
/**
|
|
68
|
-
* Resets the flag values.
|
|
69
|
-
*/
|
|
70
|
-
declare function reset(): void;
|
|
71
|
-
/**
|
|
72
|
-
* Gets the current value of the given flag.
|
|
73
|
-
*/
|
|
74
|
-
declare function get(name: string): unknown;
|
|
75
|
-
/**
|
|
76
|
-
* Gets whether or not the flag was set.
|
|
77
|
-
*/
|
|
78
|
-
declare function isSet(name: string): boolean;
|
|
79
|
-
/**
|
|
80
|
-
* Parses process.argv for flags. Idempotent if called multiple times.
|
|
81
|
-
*/
|
|
82
|
-
declare function parse(args?: string[], ignoreUnrecognized?: boolean): string[];
|
|
83
|
-
|
|
84
|
-
export { FLAGS, defineBoolean, defineInteger, defineMultiString, defineNumber, defineString, defineStringList, get, help, isSet, parse, reset, setExitOnError, setUsageInfo };
|