flags 4.0.2 → 4.0.3

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 CHANGED
@@ -1,5 +1,13 @@
1
1
  # @vercel/flags
2
2
 
3
+ ## 4.0.3
4
+
5
+ ### Patch Changes
6
+
7
+ - 795dfd4: Throw on declaration if flag is missing decide function.
8
+
9
+ When a feature flag is declared without a decide function, or with an adapter that is missing a decide function we will now throw an error at declaration time.
10
+
3
11
  ## 4.0.2
4
12
 
5
13
  ### Patch Changes
package/README.md CHANGED
@@ -7,7 +7,7 @@ The feature flags toolkit for Next.js and SvelteKit.
7
7
  From the creators of Next.js, the Flags SDK is a free open-source library that gives you the tools you need to use feature flags in Next.js and SvelteKit applications.
8
8
 
9
9
  - Works with any flag provider, custom setups or no flag provider at all
10
- - Compatible with App Router, Pages Router, and Edge Middleware
10
+ - Compatible with App Router, Pages Router, and Routing Middleware
11
11
  - Built for feature flags and experimentation
12
12
 
13
13
  See [flags-sdk.dev](https://flags-sdk.dev/) for full docs and examples.
@@ -62,7 +62,7 @@ export default async function Page() {
62
62
  }
63
63
  ```
64
64
 
65
- Feature Flags can also be called in Edge Middleware and API Routes.
65
+ Feature Flags can also be called in Routing Middleware and API Routes.
66
66
 
67
67
  ## Adapters
68
68
 
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/analytics.ts"],"names":[],"mappings":";AAGO,IAAM,cAAc,CACzB,YACS;AAAC","sourcesContent":["/**\n * @deprecated It is no longer necessary to call this function. Web Analytics now automatically detects flags present in the DOM.\n */\nexport const injectFlags = (\n _params: { keys?: string[] } | undefined,\n): void => {};\n"]}
1
+ {"version":3,"sources":["/home/runner/work/flags/flags/packages/flags/dist/analytics.cjs","../src/analytics.ts"],"names":[],"mappings":"AAAA;ACGO,IAAM,YAAA,EAAc,CACzB,OAAA,EAAA,GACS;AAAC,CAAA;ADFZ;AACE;AACF,kCAAC","file":"/home/runner/work/flags/flags/packages/flags/dist/analytics.cjs","sourcesContent":[null,"/**\n * @deprecated It is no longer necessary to call this function. Web Analytics now automatically detects flags present in the DOM.\n */\nexport const injectFlags = (\n _params: { keys?: string[] } | undefined,\n): void => {};\n"]}
@@ -1,6 +1,6 @@
1
1
  // package.json
2
2
  var name = "flags";
3
- var version = "4.0.2";
3
+ var version = "4.0.3";
4
4
 
5
5
  // src/lib/crypto.ts
6
6
  import { base64url, EncryptJWT, jwtDecrypt } from "jose";
@@ -17,8 +17,7 @@ async function encryptJwe(payload, secret, expirationTime) {
17
17
  return new EncryptJWT(payload).setExpirationTime(expirationTime).setProtectedHeader({ alg: "dir", enc: "A256GCM" }).encrypt(encodedSecret);
18
18
  }
19
19
  async function decryptJwe(text, verify, secret) {
20
- if (typeof text !== "string")
21
- return;
20
+ if (typeof text !== "string") return;
22
21
  const encodedSecret = base64url.decode(secret);
23
22
  if (encodedSecret.length !== 32) {
24
23
  throw new Error(
@@ -34,13 +33,11 @@ async function decryptJwe(text, verify, secret) {
34
33
  }
35
34
  }
36
35
  async function encryptOverrides(overrides, secret = process?.env?.FLAGS_SECRET, expirationTime = "1y") {
37
- if (!secret)
38
- throw new Error("flags: Missing FLAGS_SECRET");
36
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
39
37
  return encryptJwe({ o: overrides, pur: "overrides" }, secret, expirationTime);
40
38
  }
41
39
  async function decryptOverrides(encryptedData, secret = process?.env?.FLAGS_SECRET) {
42
- if (!secret)
43
- throw new Error("flags: Missing FLAGS_SECRET");
40
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
44
41
  const contents = await decryptJwe(
45
42
  encryptedData,
46
43
  (data) => hasPurpose(data.pur, "overrides") && Object.hasOwn(data, "o"),
@@ -49,13 +46,11 @@ async function decryptOverrides(encryptedData, secret = process?.env?.FLAGS_SECR
49
46
  return contents?.o;
50
47
  }
51
48
  async function encryptFlagValues(flagValues, secret = process?.env?.FLAGS_SECRET, expirationTime = "1y") {
52
- if (!secret)
53
- throw new Error("flags: Missing FLAGS_SECRET");
49
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
54
50
  return encryptJwe({ v: flagValues, pur: "values" }, secret, expirationTime);
55
51
  }
56
52
  async function decryptFlagValues(encryptedData, secret = process?.env?.FLAGS_SECRET) {
57
- if (!secret)
58
- throw new Error("flags: Missing FLAGS_SECRET");
53
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
59
54
  const contents = await decryptJwe(
60
55
  encryptedData,
61
56
  (data) => hasPurpose(data.pur, "values") && Object.hasOwn(data, "v"),
@@ -64,8 +59,7 @@ async function decryptFlagValues(encryptedData, secret = process?.env?.FLAGS_SEC
64
59
  return contents?.v;
65
60
  }
66
61
  async function encryptFlagDefinitions(flagDefinitions, secret = process?.env?.FLAGS_SECRET, expirationTime = "1y") {
67
- if (!secret)
68
- throw new Error("flags: Missing FLAGS_SECRET");
62
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
69
63
  return encryptJwe(
70
64
  { d: flagDefinitions, pur: "definitions" },
71
65
  secret,
@@ -73,8 +67,7 @@ async function encryptFlagDefinitions(flagDefinitions, secret = process?.env?.FL
73
67
  );
74
68
  }
75
69
  async function decryptFlagDefinitions(encryptedData, secret = process?.env?.FLAGS_SECRET) {
76
- if (!secret)
77
- throw new Error("flags: Missing FLAGS_SECRET");
70
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
78
71
  const contents = await decryptJwe(
79
72
  encryptedData,
80
73
  (data) => data.pur === "definitions" && Object.hasOwn(data, "d"),
@@ -83,13 +76,11 @@ async function decryptFlagDefinitions(encryptedData, secret = process?.env?.FLAG
83
76
  return contents?.d;
84
77
  }
85
78
  async function createAccessProof(secret = process?.env?.FLAGS_SECRET, expirationTime = "1y") {
86
- if (!secret)
87
- throw new Error("flags: Missing FLAGS_SECRET");
79
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
88
80
  return encryptJwe({ pur: "proof" }, secret, expirationTime);
89
81
  }
90
82
  async function verifyAccessProof(encryptedData, secret = process?.env?.FLAGS_SECRET) {
91
- if (!secret)
92
- throw new Error("flags: Missing FLAGS_SECRET");
83
+ if (!secret) throw new Error("flags: Missing FLAGS_SECRET");
93
84
  const contents = await decryptJwe(encryptedData, (data) => hasPurpose(data.pur, "proof"), secret);
94
85
  return Boolean(contents);
95
86
  }
@@ -102,12 +93,10 @@ async function mergeProviderData(itemsPromises) {
102
93
  return items.filter((item) => Boolean(item)).reduce(
103
94
  (acc, item) => {
104
95
  Object.entries(item.definitions).forEach(([key, definition]) => {
105
- if (!acc.definitions[key])
106
- acc.definitions[key] = {};
96
+ if (!acc.definitions[key]) acc.definitions[key] = {};
107
97
  Object.assign(acc.definitions[key], definition);
108
98
  });
109
- if (Array.isArray(item.hints))
110
- acc.hints.push(...item.hints);
99
+ if (Array.isArray(item.hints)) acc.hints.push(...item.hints);
111
100
  return acc;
112
101
  },
113
102
  { definitions: {}, hints: [] }
@@ -116,14 +105,14 @@ async function mergeProviderData(itemsPromises) {
116
105
 
117
106
  // src/lib/report-value.ts
118
107
  function reportValue(key, value) {
119
- const symbol = Symbol.for("@vercel/request-context");
108
+ const symbol = /* @__PURE__ */ Symbol.for("@vercel/request-context");
120
109
  const ctx = Reflect.get(globalThis, symbol)?.get();
121
110
  ctx?.flags?.reportValue(key, value, {
122
111
  sdkVersion: version
123
112
  });
124
113
  }
125
114
  function internalReportValue(key, value, data) {
126
- const symbol = Symbol.for("@vercel/request-context");
115
+ const symbol = /* @__PURE__ */ Symbol.for("@vercel/request-context");
127
116
  const ctx = Reflect.get(globalThis, symbol)?.get();
128
117
  ctx?.flags?.reportValue(key, value, {
129
118
  sdkVersion: version,
@@ -133,7 +122,7 @@ function internalReportValue(key, value, data) {
133
122
 
134
123
  // src/lib/tracing.ts
135
124
  import { AsyncLocalStorage } from "async_hooks";
136
- var vercelFlagsTraceSymbol = Symbol.for("flags:global-trace");
125
+ var vercelFlagsTraceSymbol = /* @__PURE__ */ Symbol.for("flags:global-trace");
137
126
  function setTracerProvider(tracer) {
138
127
  Reflect.set(globalThis, vercelFlagsTraceSymbol, tracer);
139
128
  }
@@ -153,16 +142,13 @@ function trace(fn, options = {
153
142
  }) {
154
143
  const traced = function(...args) {
155
144
  const tracer = getTracer();
156
- if (!tracer)
157
- return fn.apply(this, args);
145
+ if (!tracer) return fn.apply(this, args);
158
146
  const shouldTrace = process.env.VERCEL_FLAGS_TRACE_VERBOSE === "true" || options.isVerboseTrace === false;
159
- if (!shouldTrace)
160
- return fn.apply(this, args);
147
+ if (!shouldTrace) return fn.apply(this, args);
161
148
  return spanContext.run(
162
149
  /* @__PURE__ */ new Map(),
163
150
  () => tracer.startActiveSpan(options.name, (span) => {
164
- if (options.attributes)
165
- span.setAttributes(options.attributes);
151
+ if (options.attributes) span.setAttributes(options.attributes);
166
152
  try {
167
153
  const result = fn.apply(this, args);
168
154
  if (isPromise(result)) {
@@ -228,8 +214,7 @@ function trace(fn, options = {
228
214
  // src/lib/verify-access.ts
229
215
  var verifyAccess = trace(
230
216
  async function verifyAccess2(authHeader, secret = process?.env?.FLAGS_SECRET) {
231
- if (!authHeader)
232
- return false;
217
+ if (!authHeader) return false;
233
218
  if (!secret)
234
219
  throw new Error(
235
220
  "flags: verifyAccess was called without a secret. Please set FLAGS_SECRET environment variable."
@@ -289,8 +274,7 @@ var HeadersAdapter = class _HeadersAdapter extends Headers {
289
274
  const original = Object.keys(headers).find(
290
275
  (o) => o.toLowerCase() === lowercased
291
276
  );
292
- if (typeof original === "undefined")
293
- return;
277
+ if (typeof original === "undefined") return;
294
278
  return ReflectAdapter.get(target, original, receiver);
295
279
  },
296
280
  set(target, prop, value, receiver) {
@@ -304,14 +288,12 @@ var HeadersAdapter = class _HeadersAdapter extends Headers {
304
288
  return ReflectAdapter.set(target, original ?? prop, value, receiver);
305
289
  },
306
290
  has(target, prop) {
307
- if (typeof prop === "symbol")
308
- return ReflectAdapter.has(target, prop);
291
+ if (typeof prop === "symbol") return ReflectAdapter.has(target, prop);
309
292
  const lowercased = prop.toLowerCase();
310
293
  const original = Object.keys(headers).find(
311
294
  (o) => o.toLowerCase() === lowercased
312
295
  );
313
- if (typeof original === "undefined")
314
- return false;
296
+ if (typeof original === "undefined") return false;
315
297
  return ReflectAdapter.has(target, original);
316
298
  },
317
299
  deleteProperty(target, prop) {
@@ -321,8 +303,7 @@ var HeadersAdapter = class _HeadersAdapter extends Headers {
321
303
  const original = Object.keys(headers).find(
322
304
  (o) => o.toLowerCase() === lowercased
323
305
  );
324
- if (typeof original === "undefined")
325
- return true;
306
+ if (typeof original === "undefined") return true;
326
307
  return ReflectAdapter.deleteProperty(target, original);
327
308
  }
328
309
  });
@@ -353,8 +334,7 @@ var HeadersAdapter = class _HeadersAdapter extends Headers {
353
334
  * @returns a merged header value (a string)
354
335
  */
355
336
  merge(value) {
356
- if (Array.isArray(value))
357
- return value.join(", ");
337
+ if (Array.isArray(value)) return value.join(", ");
358
338
  return value;
359
339
  }
360
340
  /**
@@ -364,8 +344,7 @@ var HeadersAdapter = class _HeadersAdapter extends Headers {
364
344
  * @returns a headers instance
365
345
  */
366
346
  static from(headers) {
367
- if (headers instanceof Headers)
368
- return headers;
347
+ if (headers instanceof Headers) return headers;
369
348
  return new _HeadersAdapter(headers);
370
349
  }
371
350
  append(name2, value) {
@@ -383,8 +362,7 @@ var HeadersAdapter = class _HeadersAdapter extends Headers {
383
362
  }
384
363
  get(name2) {
385
364
  const value = this.headers[name2];
386
- if (typeof value !== "undefined")
387
- return this.merge(value);
365
+ if (typeof value !== "undefined") return this.merge(value);
388
366
  return null;
389
367
  }
390
368
  has(name2) {
@@ -449,7 +427,6 @@ var RequestCookiesAdapter = class {
449
427
  });
450
428
  }
451
429
  };
452
- var SYMBOL_MODIFY_COOKIE_VALUES = Symbol.for("next.mutated.cookies");
453
430
 
454
431
  export {
455
432
  version,
@@ -471,4 +448,4 @@ export {
471
448
  HeadersAdapter,
472
449
  RequestCookiesAdapter
473
450
  };
474
- //# sourceMappingURL=chunk-SLBSERE6.js.map
451
+ //# sourceMappingURL=chunk-IDKF4YJL.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../package.json","../src/lib/crypto.ts","../src/lib/merge-provider-data.ts","../src/lib/report-value.ts","../src/lib/tracing.ts","../src/lib/verify-access.ts","../src/spec-extension/adapters/reflect.ts","../src/spec-extension/adapters/headers.ts","../src/spec-extension/adapters/request-cookies.ts"],"sourcesContent":["{\n \"name\": \"flags\",\n \"version\": \"4.0.3\",\n \"description\": \"Flags SDK by Vercel - The feature flags toolkit for Next.js and SvelteKit\",\n \"keywords\": [\n \"feature flags\",\n \"Next.js\",\n \"react\",\n \"toolbar\",\n \"overrides\",\n \"SvelteKit\"\n ],\n \"homepage\": \"https://flags-sdk.dev\",\n \"bugs\": {\n \"url\": \"https://github.com/vercel/flags/issues\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/vercel/flags.git\"\n },\n \"license\": \"MIT\",\n \"sideEffects\": false,\n \"type\": \"module\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.js\",\n \"require\": \"./dist/index.cjs\"\n },\n \"./next\": {\n \"import\": \"./dist/next.js\",\n \"require\": \"./dist/next.cjs\"\n },\n \"./analytics\": {\n \"import\": \"./dist/analytics.js\",\n \"require\": \"./dist/analytics.cjs\"\n },\n \"./react\": {\n \"import\": \"./dist/react.js\",\n \"require\": \"./dist/react.cjs\"\n },\n \"./sveltekit\": {\n \"svelte\": \"./dist/sveltekit.js\",\n \"import\": \"./dist/sveltekit.js\",\n \"require\": \"./dist/sveltekit.cjs\"\n }\n },\n \"typesVersions\": {\n \"*\": {\n \"*\": [\n \"dist/*.d.ts\",\n \"dist/*.d.cts\"\n ],\n \"next\": [\n \"dist/next.d.ts\",\n \"dist/next.d.cts\"\n ],\n \"react\": [\n \"dist/react.d.ts\",\n \"dist/react.d.cts\"\n ],\n \"sveltekit\": [\n \"dist/sveltekit.d.ts\",\n \"dist/sveltekit.d.cts\"\n ]\n }\n },\n \"files\": [\n \"dist\",\n \"CHANGELOG.md\"\n ],\n \"scripts\": {\n \"attw\": \"attw --pack .\",\n \"build\": \"tsup\",\n \"dev\": \"tsup --watch --clean=false\",\n \"check\": \"biome check\",\n \"test\": \"vitest --run\",\n \"test:watch\": \"vitest\",\n \"type-check\": \"tsc --noEmit\"\n },\n \"dependencies\": {\n \"@edge-runtime/cookies\": \"^5.0.2\",\n \"jose\": \"^5.2.1\"\n },\n \"devDependencies\": {\n \"@arethetypeswrong/cli\": \"0.18.2\",\n \"@types/node\": \"20.11.17\",\n \"@types/react\": \"18.2.55\",\n \"@vitejs/plugin-react\": \"4.2.1\",\n \"msw\": \"2.6.4\",\n \"next\": \"16.1.5\",\n \"react\": \"canary\",\n \"tsup\": \"8.5.1\",\n \"typescript\": \"5.6.3\",\n \"vite\": \"5.4.21\",\n \"vitest\": \"1.6.1\"\n },\n \"peerDependencies\": {\n \"@opentelemetry/api\": \"^1.7.0\",\n \"@sveltejs/kit\": \"*\",\n \"next\": \"*\",\n \"react\": \"*\",\n \"react-dom\": \"*\"\n },\n \"peerDependenciesMeta\": {\n \"@opentelemetry/api\": {\n \"optional\": true\n },\n \"@sveltejs/kit\": {\n \"optional\": true\n },\n \"next\": {\n \"optional\": true\n },\n \"react\": {\n \"optional\": true\n },\n \"react-dom\": {\n \"optional\": true\n }\n },\n \"publishConfig\": {\n \"access\": \"public\"\n }\n}\n","/**\n * All JWEs created by crypto functions will typically use the same secret.\n *\n * It is vital that each decrypt function ensures the JWE was created for that\n * specific purpose, as the output of one encrypt function could otherwise be\n * used as the input to another decrypt function.\n */\nimport { base64url, EncryptJWT, jwtDecrypt } from 'jose';\nimport type {\n FlagDefinitionsType,\n FlagOverridesType,\n FlagValuesType,\n} from '../types';\n\ntype ExpirationTime = string | number | Date;\ntype PurposeClaim = 'overrides' | 'values' | 'definitions' | 'proof';\ntype Purpose = string | string[];\n\n/**\n * Checks if a purpose claim matches the expected purpose.\n *\n * @param pur - The purpose claim to check, can be a string or array of strings\n * @param expectedPurpose - The expected purpose to match against\n * @returns True if the purpose matches the expected purpose, false otherwise\n */\nconst hasPurpose = (pur: Purpose, expectedPurpose: PurposeClaim): boolean => {\n return Array.isArray(pur)\n ? pur.includes(expectedPurpose)\n : pur === expectedPurpose;\n};\n\n/**\n * Encrypts data into a JSON Web Encryption (JWE) token.\n *\n * @param payload - The data to encrypt\n * @param secret - The encryption secret (must be a 256-bit key)\n * @param expirationTime - When the encrypted data should expire\n * @returns A promise resolving to the encrypted JWE string\n * @throws Error if the secret is invalid\n */\nasync function encryptJwe<T extends object = Record<string, unknown>>(\n payload: T,\n secret: string,\n expirationTime: ExpirationTime,\n): Promise<string> {\n const encodedSecret = base64url.decode(secret);\n\n if (encodedSecret.length !== 32) {\n throw new Error(\n 'flags: Invalid secret, it must be a 256-bit key (32 bytes)',\n );\n }\n\n return new EncryptJWT(payload as Record<string, unknown>)\n .setExpirationTime(expirationTime)\n .setProtectedHeader({ alg: 'dir', enc: 'A256GCM' })\n .encrypt(encodedSecret);\n}\n\n/**\n * Decrypts a JWE token and verifies its contents.\n *\n * @param text - The encrypted JWE token string\n * @param verify - A function to verify the decrypted payload is valid\n * @param secret - The decryption secret (must be a 256-bit key)\n * @returns A promise resolving to the decrypted data or undefined if invalid\n * @throws Error if the secret is invalid\n */\nasync function decryptJwe<T extends string | object = Record<string, unknown>>(\n text: string,\n verify: (payload: T) => boolean,\n secret: string,\n): Promise<T | undefined> {\n if (typeof text !== 'string') return;\n\n const encodedSecret = base64url.decode(secret);\n\n if (encodedSecret.length !== 32) {\n throw new Error(\n 'flags: Invalid secret, it must be a 256-bit key (32 bytes)',\n );\n }\n\n try {\n const { payload } = await jwtDecrypt(text, encodedSecret);\n const decoded = payload as T;\n return verify(decoded) ? decoded : undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Encrypts flag overrides data.\n *\n * @param overrides - The flag overrides to encrypt\n * @param secret - The encryption secret (defaults to FLAGS_SECRET env var)\n * @param expirationTime - When the encrypted data should expire (defaults to 1 year)\n * @returns A promise resolving to the encrypted JWE string\n * @throws Error if the secret is missing or invalid\n */\nexport async function encryptOverrides(\n overrides: FlagOverridesType,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n expirationTime: ExpirationTime = '1y',\n) {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n return encryptJwe({ o: overrides, pur: 'overrides' }, secret, expirationTime);\n}\n\n/**\n * Decrypts and validates flag overrides data.\n *\n * @param encryptedData - The encrypted JWE token string\n * @param secret - The decryption secret (defaults to FLAGS_SECRET env var)\n * @returns A promise resolving to the decrypted flag overrides or undefined if invalid\n * @throws Error if the secret is missing or invalid\n */\nexport async function decryptOverrides(\n encryptedData: string,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n): Promise<FlagOverridesType | undefined> {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n const contents = await decryptJwe<{\n o: FlagOverridesType;\n pur: Purpose;\n }>(\n encryptedData,\n (data) => hasPurpose(data.pur, 'overrides') && Object.hasOwn(data, 'o'),\n secret,\n );\n return contents?.o;\n}\n\n/**\n * Encrypts flag values data.\n *\n * @param flagValues - The flag values to encrypt\n * @param secret - The encryption secret (defaults to FLAGS_SECRET env var)\n * @param expirationTime - When the encrypted data should expire (defaults to 1 year)\n * @returns A promise resolving to the encrypted JWE string\n * @throws Error if the secret is missing or invalid\n */\nexport async function encryptFlagValues(\n flagValues: FlagValuesType,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n expirationTime: ExpirationTime = '1y',\n) {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n return encryptJwe({ v: flagValues, pur: 'values' }, secret, expirationTime);\n}\n\n/**\n * Decrypts and validates flag values data.\n *\n * @param encryptedData - The encrypted JWE token string\n * @param secret - The decryption secret (defaults to FLAGS_SECRET env var)\n * @returns A promise resolving to the decrypted flag values or undefined if invalid\n * @throws Error if the secret is missing or invalid\n */\nexport async function decryptFlagValues(\n encryptedData: string,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n): Promise<FlagValuesType | undefined> {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n const contents = await decryptJwe<{\n v: FlagValuesType;\n pur: Purpose;\n }>(\n encryptedData,\n (data) => hasPurpose(data.pur, 'values') && Object.hasOwn(data, 'v'),\n secret,\n );\n return contents?.v;\n}\n\n/**\n * Encrypts flag definitions data.\n *\n * @param flagDefinitions - The flag definitions to encrypt\n * @param secret - The encryption secret (defaults to FLAGS_SECRET env var)\n * @param expirationTime - When the encrypted data should expire (defaults to 1 year)\n * @returns A promise resolving to the encrypted JWE string\n * @throws Error if the secret is missing or invalid\n */\nexport async function encryptFlagDefinitions(\n flagDefinitions: FlagDefinitionsType,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n expirationTime: ExpirationTime = '1y',\n) {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n return encryptJwe(\n { d: flagDefinitions, pur: 'definitions' },\n secret,\n expirationTime,\n );\n}\n\n/**\n * Decrypts and validates flag definitions data.\n *\n * @param encryptedData - The encrypted JWE token string\n * @param secret - The decryption secret (defaults to FLAGS_SECRET env var)\n * @returns A promise resolving to the decrypted flag definitions or undefined if invalid\n * @throws Error if the secret is missing or invalid\n */\nexport async function decryptFlagDefinitions(\n encryptedData: string,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n): Promise<FlagDefinitionsType | undefined> {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n const contents = await decryptJwe<{\n d: FlagDefinitionsType;\n pur: string;\n }>(\n encryptedData,\n (data) => data.pur === 'definitions' && Object.hasOwn(data, 'd'),\n secret,\n );\n return contents?.d;\n}\n\n/**\n * Creates an access proof token.\n *\n * @param secret - The encryption secret (defaults to FLAGS_SECRET env var)\n * @param expirationTime - When the token should expire (defaults to 1 year)\n * @returns A promise resolving to the encrypted access proof token\n * @throws Error if the secret is missing or invalid\n */\nexport async function createAccessProof(\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n expirationTime: ExpirationTime = '1y',\n) {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n return encryptJwe({ pur: 'proof' }, secret, expirationTime);\n}\n\n/**\n * Verifies an access proof token is valid.\n *\n * @param encryptedData - The encrypted access proof token\n * @param secret - The decryption secret (defaults to FLAGS_SECRET env var)\n * @returns A promise resolving to a boolean indicating if the token is valid\n * @throws Error if the secret is missing or invalid\n */\nexport async function verifyAccessProof(\n encryptedData: string,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n) {\n if (!secret) throw new Error('flags: Missing FLAGS_SECRET');\n const contents = await decryptJwe<{\n pur: string;\n }>(encryptedData, (data) => hasPurpose(data.pur, 'proof'), secret);\n\n return Boolean(contents);\n}\n","import type { ProviderData } from '../types';\n\nexport async function mergeProviderData(\n itemsPromises: (Promise<ProviderData> | ProviderData)[],\n): Promise<ProviderData> {\n const items = await Promise.all(\n itemsPromises.map((p) => Promise.resolve(p).catch(() => null)),\n );\n\n return items\n .filter((item): item is ProviderData => Boolean(item))\n .reduce<ProviderData>(\n (acc, item) => {\n Object.entries(item.definitions).forEach(([key, definition]) => {\n if (!acc.definitions[key]) acc.definitions[key] = {};\n Object.assign(acc.definitions[key], definition);\n });\n\n if (Array.isArray(item.hints)) acc.hints.push(...item.hints);\n\n return acc;\n },\n { definitions: {}, hints: [] },\n );\n}\n","import { version } from '../../package.json';\n\n/**\n * This function lets you report the value of a resolved flag, which will make it available when viewing Monitoring, Logs, Analytics and Speed Insights on Vercel.\n * It's important to note that this only has effects when running on Vercel in a preview or production environments, but not during local development.\n *\n * @example Using `reportValue` to report a flag value.\n * ```\n * import { type NextRequest, NextResponse } from \"next/server\";\n * import { reportValue } from 'flags';\n *\n * export async function GET(request: NextRequest) {\n * reportValue('my-flag', true);\n * return NextResponse.json({});\n * }\n * ```\n *\n * @param key the name of the flag\n * @param value the resolved value of the flag\n */\nexport function reportValue(key: string, value: unknown) {\n const symbol = Symbol.for('@vercel/request-context');\n const ctx = Reflect.get(globalThis, symbol)?.get();\n ctx?.flags?.reportValue(key, value, {\n sdkVersion: version,\n });\n}\n\n/**\n * Only used interally for now.\n */\nexport function internalReportValue(\n key: string,\n value: unknown,\n data: {\n originProjectId?: string;\n originProvider?: 'vercel';\n reason?: 'override';\n },\n) {\n const symbol = Symbol.for('@vercel/request-context');\n const ctx = Reflect.get(globalThis, symbol)?.get();\n ctx?.flags?.reportValue(key, value, {\n sdkVersion: version,\n ...data,\n });\n}\n","import type {\n Attributes,\n AttributeValue,\n Tracer,\n TracerProvider,\n} from '@opentelemetry/api';\nimport { AsyncLocalStorage } from 'async_hooks';\nimport { name as pkgName, version } from '../../package.json';\n\n// Use a symbol to avoid having global variable that is scoped to this file,\n// as it can lead to issues with cjs and mjs being used at the same time.\nconst vercelFlagsTraceSymbol = Symbol.for('flags:global-trace');\n\n/**\n * Allows setting the `@opentelemetry/api` tracer provider to generate traces\n * for `flags` operations.\n */\nexport function setTracerProvider(tracer: TracerProvider): void {\n Reflect.set(globalThis, vercelFlagsTraceSymbol, tracer);\n}\n\nfunction getTracer(): Tracer | undefined {\n const maybeTraceApi = Reflect.get(globalThis, vercelFlagsTraceSymbol) as\n | undefined\n | TracerProvider;\n return maybeTraceApi?.getTracer(pkgName, version);\n}\n\nfunction isPromise<T>(p: unknown): p is Promise<T> {\n return (\n p !== null &&\n typeof p === 'object' &&\n 'then' in p &&\n typeof p.then === 'function'\n );\n}\n\nconst spanContext = new AsyncLocalStorage<Map<string, AttributeValue>>();\n\nexport function setSpanAttribute(name: string, value: AttributeValue) {\n spanContext.getStore()?.set(name, value);\n}\n\nexport function trace<F extends (...args: any) => any>(\n fn: F,\n options: {\n name: string;\n /** Defaults to `true`. If set to `false`, it'll trace regardless of `VERCEL_FLAGS_TRACE_VERBOSE`. */\n isVerboseTrace?: boolean;\n attributes?: Attributes;\n attributesSuccess?: (\n result: ReturnType<F> extends PromiseLike<infer U> ? U : ReturnType<F>,\n ) => Attributes;\n attributesError?: (error: Error) => Attributes;\n } = {\n name: fn.name,\n },\n): F {\n const traced = function (this: unknown, ...args: unknown[]): unknown {\n const tracer = getTracer();\n if (!tracer) return fn.apply(this, args);\n\n const shouldTrace =\n process.env.VERCEL_FLAGS_TRACE_VERBOSE === 'true' ||\n options.isVerboseTrace === false;\n if (!shouldTrace) return fn.apply(this, args);\n\n return spanContext.run(new Map(), () =>\n tracer.startActiveSpan(options.name, (span) => {\n if (options.attributes) span.setAttributes(options.attributes);\n\n try {\n const result = fn.apply(this, args);\n\n if (isPromise(result)) {\n result\n .then((value) => {\n if (options.attributesSuccess) {\n span.setAttributes(\n options.attributesSuccess(\n value as ReturnType<F> extends PromiseLike<infer U>\n ? U\n : ReturnType<F>,\n ),\n );\n }\n\n spanContext.getStore()?.forEach((value, key) => {\n span.setAttribute(key, value);\n });\n\n span.setStatus({ code: 1 }); // 1 = Ok\n span.end();\n })\n .catch((error) => {\n if (options.attributesError) {\n span.setAttributes(options.attributesError(error));\n }\n\n span.setStatus({\n code: 2, // 2 = Error\n message: error instanceof Error ? error.message : undefined,\n });\n\n spanContext.getStore()?.forEach((value, key) => {\n span.setAttribute(key, value);\n });\n\n span.end();\n });\n } else {\n if (options.attributesSuccess) {\n span.setAttributes(options.attributesSuccess(result));\n }\n\n spanContext.getStore()?.forEach((value, key) => {\n span.setAttribute(key, value);\n });\n\n span.setStatus({ code: 1 }); // 1 = Ok\n span.end();\n }\n\n return result as unknown;\n } catch (error: any) {\n if (options.attributesError) {\n span.setAttributes(options.attributesError(error as Error));\n }\n\n span.setStatus({\n code: 2, // 2 = Error\n message: error instanceof Error ? error.message : undefined,\n });\n\n spanContext.getStore()?.forEach((value, key) => {\n span.setAttribute(key, value);\n });\n\n span.end();\n\n throw error;\n }\n }),\n );\n };\n\n return traced as unknown as F;\n}\n","import { verifyAccessProof } from './crypto';\nimport { trace } from './tracing';\n\n/**\n * This function lets you verify whether a request to your application's .well-known/vercel/flags endpoint was made by the toolbar.\n * You can use verifyAccess to keep this endpoint private, to avoid public access of your feature flag definitions through that endpoint.\n *\n * @example Using verifyAccess in .well-known/vercel/flags to verify access and respond with unencrypted data.\n * ```\n * import { type NextRequest, NextResponse } from \"next/server\";\n * import { verifyAccess } from \"flags\";\n *\n * export async function GET(request: NextRequest) {\n * const access = await verifyAccess(request.headers.get(\"Authorization\"));\n * if (!access) return NextResponse.json(null, { status: 401 });\n *\n * return NextResponse.json({ definitions: {} })\n * }\n * ```\n * @param authHeader the Authorization header to check\n * @param secret the FLAGS_SECRET\n * @returns True when the authorization header was valid\n */\nexport const verifyAccess = trace(\n async function verifyAccess(\n // App Router returns null when a header is not defined\n // Pages Router returns undefined when a header is not defined\n // We support both so the API is slim in both cases\n authHeader: string | null | undefined,\n secret: string | undefined = process?.env?.FLAGS_SECRET,\n ) {\n if (!authHeader) return false;\n if (!secret)\n throw new Error(\n 'flags: verifyAccess was called without a secret. Please set FLAGS_SECRET environment variable.',\n );\n\n const valid = await verifyAccessProof(\n authHeader.replace(/^Bearer /i, ''),\n secret,\n );\n\n return valid;\n },\n {\n isVerboseTrace: false,\n name: 'verifyAccess',\n },\n);\n","// copied from Next.js, and reduced\n// https://github.com/vercel/next.js/tree/canary/packages/next/src/server/web/spec-extension\n// biome-ignore lint/complexity/noStaticOnlyClass: Copied over from Next.js\nexport class ReflectAdapter {\n static get<T extends object>(\n target: T,\n prop: string | symbol,\n receiver: unknown,\n ): any {\n const value = Reflect.get(target, prop, receiver);\n if (typeof value === 'function') {\n return value.bind(target);\n }\n\n return value;\n }\n\n static set<T extends object>(\n target: T,\n prop: string | symbol,\n value: any,\n receiver: any,\n ): boolean {\n return Reflect.set(target, prop, value, receiver);\n }\n\n static has<T extends object>(target: T, prop: string | symbol): boolean {\n return Reflect.has(target, prop);\n }\n\n static deleteProperty<T extends object>(\n target: T,\n prop: string | symbol,\n ): boolean {\n return Reflect.deleteProperty(target, prop);\n }\n}\n","// copied from Next.js, and reduced\n// https://github.com/vercel/next.js/tree/canary/packages/next/src/server/web/spec-extension\nimport type { IncomingHttpHeaders } from 'http';\n\nimport { ReflectAdapter } from './reflect';\n\n/**\n * @internal\n */\nclass ReadonlyHeadersError extends Error {\n constructor() {\n super(\n 'Headers cannot be modified. Read more: https://nextjs.org/docs/app/api-reference/functions/headers',\n );\n }\n\n public static callable() {\n throw new ReadonlyHeadersError();\n }\n}\n\nexport type ReadonlyHeaders = Headers & {\n /** @deprecated Method unavailable on `ReadonlyHeaders`. Read more: https://nextjs.org/docs/app/api-reference/functions/headers */\n append(...args: any[]): void;\n /** @deprecated Method unavailable on `ReadonlyHeaders`. Read more: https://nextjs.org/docs/app/api-reference/functions/headers */\n set(...args: any[]): void;\n /** @deprecated Method unavailable on `ReadonlyHeaders`. Read more: https://nextjs.org/docs/app/api-reference/functions/headers */\n delete(...args: any[]): void;\n};\nexport class HeadersAdapter extends Headers {\n private readonly headers: IncomingHttpHeaders;\n\n constructor(headers: IncomingHttpHeaders) {\n // We've already overridden the methods that would be called, so we're just\n // calling the super constructor to ensure that the instanceof check works.\n super();\n\n this.headers = new Proxy(headers, {\n get(target, prop, receiver) {\n // Because this is just an object, we expect that all \"get\" operations\n // are for properties. If it's a \"get\" for a symbol, we'll just return\n // the symbol.\n if (typeof prop === 'symbol') {\n return ReflectAdapter.get(target, prop, receiver);\n }\n\n const lowercased = prop.toLowerCase();\n\n // Let's find the original casing of the key. This assumes that there is\n // no mixed case keys (e.g. \"Content-Type\" and \"content-type\") in the\n // headers object.\n const original = Object.keys(headers).find(\n (o) => o.toLowerCase() === lowercased,\n );\n\n // If the original casing doesn't exist, return undefined.\n if (typeof original === 'undefined') return;\n\n // If the original casing exists, return the value.\n return ReflectAdapter.get(target, original, receiver);\n },\n set(target, prop, value, receiver) {\n if (typeof prop === 'symbol') {\n return ReflectAdapter.set(target, prop, value, receiver);\n }\n\n const lowercased = prop.toLowerCase();\n\n // Let's find the original casing of the key. This assumes that there is\n // no mixed case keys (e.g. \"Content-Type\" and \"content-type\") in the\n // headers object.\n const original = Object.keys(headers).find(\n (o) => o.toLowerCase() === lowercased,\n );\n\n // If the original casing doesn't exist, use the prop as the key.\n return ReflectAdapter.set(target, original ?? prop, value, receiver);\n },\n has(target, prop) {\n if (typeof prop === 'symbol') return ReflectAdapter.has(target, prop);\n\n const lowercased = prop.toLowerCase();\n\n // Let's find the original casing of the key. This assumes that there is\n // no mixed case keys (e.g. \"Content-Type\" and \"content-type\") in the\n // headers object.\n const original = Object.keys(headers).find(\n (o) => o.toLowerCase() === lowercased,\n );\n\n // If the original casing doesn't exist, return false.\n if (typeof original === 'undefined') return false;\n\n // If the original casing exists, return true.\n return ReflectAdapter.has(target, original);\n },\n deleteProperty(target, prop) {\n if (typeof prop === 'symbol')\n return ReflectAdapter.deleteProperty(target, prop);\n\n const lowercased = prop.toLowerCase();\n\n // Let's find the original casing of the key. This assumes that there is\n // no mixed case keys (e.g. \"Content-Type\" and \"content-type\") in the\n // headers object.\n const original = Object.keys(headers).find(\n (o) => o.toLowerCase() === lowercased,\n );\n\n // If the original casing doesn't exist, return true.\n if (typeof original === 'undefined') return true;\n\n // If the original casing exists, delete the property.\n return ReflectAdapter.deleteProperty(target, original);\n },\n });\n }\n\n /**\n * Seals a Headers instance to prevent modification by throwing an error when\n * any mutating method is called.\n */\n public static seal(headers: Headers): ReadonlyHeaders {\n return new Proxy<ReadonlyHeaders>(headers, {\n get(target, prop, receiver) {\n switch (prop) {\n case 'append':\n case 'delete':\n case 'set':\n return ReadonlyHeadersError.callable;\n default:\n return ReflectAdapter.get(target, prop, receiver);\n }\n },\n });\n }\n\n /**\n * Merges a header value into a string. This stores multiple values as an\n * array, so we need to merge them into a string.\n *\n * @param value a header value\n * @returns a merged header value (a string)\n */\n private merge(value: string | string[]): string {\n if (Array.isArray(value)) return value.join(', ');\n\n return value;\n }\n\n /**\n * Creates a Headers instance from a plain object or a Headers instance.\n *\n * @param headers a plain object or a Headers instance\n * @returns a headers instance\n */\n public static from(headers: IncomingHttpHeaders | Headers): Headers {\n if (headers instanceof Headers) return headers;\n\n return new HeadersAdapter(headers);\n }\n\n public append(name: string, value: string): void {\n const existing = this.headers[name];\n if (typeof existing === 'string') {\n this.headers[name] = [existing, value];\n } else if (Array.isArray(existing)) {\n existing.push(value);\n } else {\n this.headers[name] = value;\n }\n }\n\n public delete(name: string): void {\n delete this.headers[name];\n }\n\n public get(name: string): string | null {\n const value = this.headers[name];\n if (typeof value !== 'undefined') return this.merge(value);\n\n return null;\n }\n\n public has(name: string): boolean {\n return typeof this.headers[name] !== 'undefined';\n }\n\n public set(name: string, value: string): void {\n this.headers[name] = value;\n }\n\n public forEach(\n callbackfn: (value: string, name: string, parent: Headers) => void,\n thisArg?: any,\n ): void {\n for (const [name, value] of this.entries()) {\n callbackfn.call(thisArg, value, name, this);\n }\n }\n\n public *entries(): HeadersIterator<[string, string]> {\n for (const key of Object.keys(this.headers)) {\n const name = key.toLowerCase();\n // We assert here that this is a string because we got it from the\n // Object.keys() call above.\n const value = this.get(name) as string;\n\n yield [name, value] as [string, string];\n }\n }\n\n public *keys(): HeadersIterator<string> {\n for (const key of Object.keys(this.headers)) {\n const name = key.toLowerCase();\n yield name;\n }\n }\n\n public *values(): HeadersIterator<string> {\n for (const key of Object.keys(this.headers)) {\n // We assert here that this is a string because we got it from the\n // Object.keys() call above.\n const value = this.get(key) as string;\n\n yield value;\n }\n }\n\n public [Symbol.iterator](): HeadersIterator<[string, string]> {\n return this.entries();\n }\n}\n","// copied from Next.js, and reduced\n// https://github.com/vercel/next.js/tree/canary/packages/next/src/server/web/spec-extension\nimport { type RequestCookies, ResponseCookies } from '../cookies';\nimport { ReflectAdapter } from './reflect';\n\n/**\n * @internal\n */\nexport class ReadonlyRequestCookiesError extends Error {\n constructor() {\n super(\n 'Cookies can only be modified in a Server Action or Route Handler. Read more: https://nextjs.org/docs/app/api-reference/functions/cookies#options',\n );\n }\n\n public static callable() {\n throw new ReadonlyRequestCookiesError();\n }\n}\n\n// We use this to type some APIs but we don't construct instances directly\nexport type { ResponseCookies };\n\n// The `cookies()` API is a mix of request and response cookies. For `.get()` methods,\n// we want to return the request cookie if it exists. For mutative methods like `.set()`,\n// we want to return the response cookie.\nexport type ReadonlyRequestCookies = Omit<\n RequestCookies,\n 'set' | 'clear' | 'delete'\n> &\n Pick<ResponseCookies, 'set' | 'delete'>;\n\n// biome-ignore lint/complexity/noStaticOnlyClass: copied from Next.js\nexport class RequestCookiesAdapter {\n public static seal(cookies: RequestCookies): ReadonlyRequestCookies {\n return new Proxy(cookies as any, {\n get(target, prop, receiver) {\n switch (prop) {\n case 'clear':\n case 'delete':\n case 'set':\n return ReadonlyRequestCookiesError.callable;\n default:\n return ReflectAdapter.get(target, prop, receiver);\n }\n },\n });\n }\n}\n\nconst SYMBOL_MODIFY_COOKIE_VALUES = Symbol.for('next.mutated.cookies');\n\nexport function getModifiedCookieValues(\n cookies: ResponseCookies,\n): ResponseCookie[] {\n const modified: ResponseCookie[] | undefined = (cookies as unknown as any)[\n SYMBOL_MODIFY_COOKIE_VALUES\n ];\n if (!modified || !Array.isArray(modified) || modified.length === 0) {\n return [];\n }\n\n return modified;\n}\n\nexport function appendMutableCookies(\n headers: Headers,\n mutableCookies: ResponseCookies,\n): boolean {\n const modifiedCookieValues = getModifiedCookieValues(mutableCookies);\n if (modifiedCookieValues.length === 0) {\n return false;\n }\n\n // Return a new response that extends the response with\n // the modified cookies as fallbacks. `res` cookies\n // will still take precedence.\n const resCookies = new ResponseCookies(headers);\n const returnedCookies = resCookies.getAll();\n\n // Set the modified cookies as fallbacks.\n for (const cookie of modifiedCookieValues) {\n resCookies.set(cookie);\n }\n\n // Set the original cookies as the final values.\n for (const cookie of returnedCookies) {\n resCookies.set(cookie);\n }\n\n return true;\n}\n\ntype ResponseCookie = NonNullable<\n ReturnType<InstanceType<typeof ResponseCookies>['get']>\n>;\n"],"mappings":"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","names":["name","value","verifyAccess","name"]}
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/safe-json-stringify.ts"],"names":[],"mappings":";AA+BO,SAAS,kBACd,OACA,UACA,OACQ;AACR,SAAO,KAAK,UAAU,OAAO,UAAU,KAAK,EAAE,QAAQ,MAAM,SAAS;AACvE","sourcesContent":["/**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n *\n * This function is just like JSON.stringify but also escapes the resulting string to prevent XSS.\n *\n * @see https://pragmaticwebsecurity.com/articles/spasecurity/json-stringify-xss\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer A function that transforms the results.\n * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\nexport function safeJsonStringify(\n value: any,\n replacer?: (this: any, key: string, value: any) => any,\n space?: string | number,\n): string;\n/**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n *\n * This function is just like JSON.stringify but also escapes the resulting string to prevent XSS.\n *\n * @see https://pragmaticwebsecurity.com/articles/spasecurity/json-stringify-xss\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer An array of strings and numbers that acts as an approved list for selecting the object properties that will be stringified.\n * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\nexport function safeJsonStringify(\n value: any,\n replacer?: (number | string)[] | null,\n space?: string | number,\n): string;\n\nexport function safeJsonStringify(\n value: any,\n replacer: any,\n space: any,\n): string {\n return JSON.stringify(value, replacer, space).replace(/</g, '\\\\u003c');\n}\n"]}
1
+ {"version":3,"sources":["/home/runner/work/flags/flags/packages/flags/dist/chunk-MEG7RDX7.cjs","../src/lib/safe-json-stringify.ts"],"names":[],"mappings":"AAAA;AC+BO,SAAS,iBAAA,CACd,KAAA,EACA,QAAA,EACA,KAAA,EACQ;AACR,EAAA,OAAO,IAAA,CAAK,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,KAAK,CAAA,CAAE,OAAA,CAAQ,IAAA,EAAM,SAAS,CAAA;AACvE;ADjCA;AACA;AACE;AACF,8CAAC","file":"/home/runner/work/flags/flags/packages/flags/dist/chunk-MEG7RDX7.cjs","sourcesContent":[null,"/**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n *\n * This function is just like JSON.stringify but also escapes the resulting string to prevent XSS.\n *\n * @see https://pragmaticwebsecurity.com/articles/spasecurity/json-stringify-xss\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer A function that transforms the results.\n * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\nexport function safeJsonStringify(\n value: any,\n replacer?: (this: any, key: string, value: any) => any,\n space?: string | number,\n): string;\n/**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n *\n * This function is just like JSON.stringify but also escapes the resulting string to prevent XSS.\n *\n * @see https://pragmaticwebsecurity.com/articles/spasecurity/json-stringify-xss\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer An array of strings and numbers that acts as an approved list for selecting the object properties that will be stringified.\n * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\nexport function safeJsonStringify(\n value: any,\n replacer?: (number | string)[] | null,\n space?: string | number,\n): string;\n\nexport function safeJsonStringify(\n value: any,\n replacer: any,\n space: any,\n): string {\n return JSON.stringify(value, replacer, space).replace(/</g, '\\\\u003c');\n}\n"]}
@@ -1,16 +1,11 @@
1
1
  // src/lib/normalize-options.ts
2
2
  function normalizeOptions(flagOptions) {
3
- if (!Array.isArray(flagOptions))
4
- return flagOptions;
3
+ if (!Array.isArray(flagOptions)) return flagOptions;
5
4
  return flagOptions.map((option) => {
6
- if (typeof option === "boolean")
7
- return { value: option };
8
- if (typeof option === "number")
9
- return { value: option };
10
- if (typeof option === "string")
11
- return { value: option };
12
- if (option === null)
13
- return { value: option };
5
+ if (typeof option === "boolean") return { value: option };
6
+ if (typeof option === "number") return { value: option };
7
+ if (typeof option === "string") return { value: option };
8
+ if (option === null) return { value: option };
14
9
  return option;
15
10
  });
16
11
  }
@@ -21,8 +16,7 @@ function memoizeOne(fn, isEqual, { cachePromiseRejection = false } = {}) {
21
16
  let oldArgs;
22
17
  let lastResult;
23
18
  function memoized(...newArgs) {
24
- if (calledOnce && isEqual(newArgs, oldArgs))
25
- return lastResult;
19
+ if (calledOnce && isEqual(newArgs, oldArgs)) return lastResult;
26
20
  lastResult = fn.apply(this, newArgs);
27
21
  if (!cachePromiseRejection && lastResult.catch) {
28
22
  lastResult.catch(() => {
@@ -135,8 +129,7 @@ async function serialize(flagSet, flags, secret) {
135
129
  return 254 /* BOOLEAN_TRUE */;
136
130
  }
137
131
  const matchedIndex = matchIndex(options, value);
138
- if (matchedIndex > -1)
139
- return matchedIndex;
132
+ if (matchedIndex > -1) return matchedIndex;
140
133
  unlistedValues.push(value);
141
134
  return 255 /* UNLISTED_VALUE */;
142
135
  })
@@ -161,4 +154,4 @@ export {
161
154
  deserialize,
162
155
  serialize
163
156
  };
164
- //# sourceMappingURL=chunk-CIQRIQPS.js.map
157
+ //# sourceMappingURL=chunk-R6WEBDKN.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/normalize-options.ts","../src/lib/async-memoize-one.ts","../src/lib/serialization.ts"],"sourcesContent":["import type { FlagOption, GenerousOption } from '../types';\n\nexport function normalizeOptions<T>(\n flagOptions: GenerousOption<T>[] | undefined,\n): FlagOption<T>[] | undefined {\n if (!Array.isArray(flagOptions)) return flagOptions;\n\n return flagOptions.map((option) => {\n if (typeof option === 'boolean') return { value: option };\n if (typeof option === 'number') return { value: option };\n if (typeof option === 'string') return { value: option };\n if (option === null) return { value: option };\n\n return option;\n }) as FlagOption<T>[];\n}\n","// adapted from https://github.com/microlinkhq/async-memoize-one\n// and https://github.com/alexreardon/memoize-one\n\ntype MemoizeOneOptions = {\n cachePromiseRejection?: boolean;\n};\n\ntype MemoizedFn<TFunc extends (this: any, ...args: any[]) => any> = (\n this: ThisParameterType<TFunc>,\n ...args: Parameters<TFunc>\n) => ReturnType<TFunc>;\n\n/**\n * Memoizes an async function, but only keeps the latest result\n */\nexport function memoizeOne<TFunc extends (this: any, ...newArgs: any[]) => any>(\n fn: TFunc,\n isEqual: (a: Parameters<TFunc>, b: Parameters<TFunc>) => boolean,\n { cachePromiseRejection = false }: MemoizeOneOptions = {},\n): MemoizedFn<TFunc> {\n let calledOnce = false;\n let oldArgs: Parameters<TFunc>;\n let lastResult: any;\n\n function memoized(\n this: ThisParameterType<TFunc>,\n ...newArgs: Parameters<TFunc>\n ) {\n if (calledOnce && isEqual(newArgs, oldArgs)) return lastResult;\n\n lastResult = fn.apply(this, newArgs);\n\n if (!cachePromiseRejection && lastResult.catch) {\n lastResult.catch(() => {\n calledOnce = false;\n });\n }\n\n calledOnce = true;\n oldArgs = newArgs;\n\n return lastResult;\n }\n\n return memoized;\n}\n","import { base64url, CompactSign, compactVerify } from 'jose';\nimport type { JsonValue } from '..';\nimport type { FlagOption } from '../types';\nimport { memoizeOne } from './async-memoize-one';\n\n// 252 max options length allows storing index 0 to 251,\n// so 252 is the first SPECIAL_INTEGER\nexport const MAX_OPTION_LENGTH = 252;\n\nenum SPECIAL_INTEGERS {\n /** Signals that the returned value is not listed in the flag's options */\n NULL = 252,\n BOOLEAN_FALSE = 253,\n BOOLEAN_TRUE = 254,\n UNLISTED_VALUE = 255,\n}\n\nconst memoizedVerify = memoizeOne(\n (code: string, secret: string) =>\n compactVerify(code, base64url.decode(secret), {\n algorithms: ['HS256'],\n }),\n (a, b) => a[0] === b[0] && a[1] === b[1], // only first two args matter\n { cachePromiseRejection: true },\n);\n\nconst memoizedSign = memoizeOne(\n (uint8Array: Uint8Array, secret) =>\n new CompactSign(uint8Array)\n .setProtectedHeader({ alg: 'HS256' })\n .sign(base64url.decode(secret)),\n (a, b) =>\n // matchedIndices array must be equal\n a[0].length === b[0].length &&\n a[0].every((v, i) => b[0][i] === v) &&\n // secrets must be equal\n a[1] === b[1],\n { cachePromiseRejection: true },\n);\n\nfunction splitUint8Array(\n array: Uint8Array,\n index: number,\n): [Uint8Array, Uint8Array] {\n const firstHalf = array.slice(0, index);\n const secondHalf = array.slice(index);\n return [firstHalf, secondHalf];\n}\n\n/**\n * Common subset of the flag type used in here\n */\ntype Flag = {\n key: string;\n options?: FlagOption<any>[];\n};\n\nexport async function deserialize(\n code: string,\n flags: readonly Flag[],\n secret: string,\n): Promise<Record<string, JsonValue>> {\n // TODO what happens when verification fails?\n const { payload } = await memoizedVerify(code, secret);\n\n const [matchedIndicesArray, valuesUint8Array] =\n payload.length === flags.length\n ? [payload]\n : splitUint8Array(payload, flags.length);\n\n const valuesArray = valuesUint8Array\n ? // re-add opening and closing brackets since we remove them when serializing\n JSON.parse(`[${new TextDecoder().decode(valuesUint8Array)}]`)\n : null;\n\n let spilled = 0;\n return matchedIndicesArray.reduce<Record<string, JsonValue>>(\n (acc, valueIndex, index) => {\n const flag = flags[index];\n\n if (!flag) {\n throw new Error(`flags: No flag at index ${index}`);\n }\n\n switch (valueIndex) {\n case SPECIAL_INTEGERS.BOOLEAN_FALSE:\n acc[flag.key] = false;\n break;\n case SPECIAL_INTEGERS.BOOLEAN_TRUE:\n acc[flag.key] = true;\n break;\n case SPECIAL_INTEGERS.UNLISTED_VALUE:\n acc[flag.key] = valuesArray[spilled++];\n break;\n case SPECIAL_INTEGERS.NULL:\n acc[flag.key] = null;\n break;\n default:\n acc[flag.key] = flag.options?.[valueIndex]?.value as JsonValue;\n }\n\n return acc;\n },\n {},\n );\n}\n\n/**\n * When serializing flags we find the matching option index for each evaluated value.\n *\n * This means we potentially need to iterate through all options of all flags.\n *\n * When the value we're trying to match is a literal (bool, string, number)\n * we look for it using referntial equality.\n *\n * When the value is an array or object we stringify the value and we stringify\n * the options of each flag and then we search for it by string comparison.\n *\n * This is faster than doing a deep equality check and also allows us not to\n * use any external library.\n *\n * We also cache the result of stringifying all options so in a Map so we only\n * ever need to stringify them once.\n */\nconst matchIndex = (() => {\n const stringifiedOptionsCache = new Map<FlagOption<any>[], string[]>();\n return function matchIndex(options: FlagOption<any>[], value: JsonValue) {\n const t = typeof value;\n\n // we're looking for a literal value, so we can check using referntial equality\n if (value === null || t === 'boolean' || t === 'string' || t === 'number') {\n return options.findIndex((v) => v.value === value);\n }\n\n // we're looking for an array or object, so we should check stringified\n const stringifiedValue = JSON.stringify(value);\n let stringifiedOptions = stringifiedOptionsCache.get(options);\n if (!stringifiedOptions) {\n stringifiedOptions = options.map((o) => JSON.stringify(o.value));\n stringifiedOptionsCache.set(options, stringifiedOptions);\n }\n\n return stringifiedOptions.indexOf(stringifiedValue);\n };\n})();\n\nfunction joinUint8Arrays(array1: Uint8Array, array2: Uint8Array): Uint8Array {\n const combined = new Uint8Array(array1.length + array2.length);\n combined.set(array1);\n combined.set(array2, array1.length);\n return combined;\n}\nexport async function serialize(\n flagSet: Record<Flag['key'], JsonValue>,\n flags: readonly Flag[],\n secret: string,\n) {\n const unlistedValues: JsonValue[] = [];\n\n const matchedIndices = new Uint8Array(\n flags.map((flag) => {\n const options = Array.isArray(flag.options) ? flag.options : [];\n\n const value = flagSet[flag.key];\n if (!Object.hasOwn(flagSet, flag.key) || value === undefined) {\n throw new Error(`flags: Missing value for flag \"${flag.key}\"`);\n }\n\n // avoid searching for common values\n // and ensure they can always be compressed, even if not listed in options\n switch (value) {\n case null:\n return SPECIAL_INTEGERS.NULL;\n case false:\n return SPECIAL_INTEGERS.BOOLEAN_FALSE;\n case true:\n return SPECIAL_INTEGERS.BOOLEAN_TRUE;\n }\n\n const matchedIndex = matchIndex(options, value);\n if (matchedIndex > -1) return matchedIndex;\n\n // value was not listed in options, so we need to\n // transport it using JSON.stringify(). we return 255 to\n // indicate this value is stringified.\n // stringified values will be placed at the end of the\n // indices array\n unlistedValues.push(value);\n return SPECIAL_INTEGERS.UNLISTED_VALUE;\n }),\n );\n\n let joined: Uint8Array;\n // there were unlisted values, so we need to join arrays\n if (unlistedValues.length > 0) {\n const jsonArray = new TextEncoder().encode(\n // slicing removes opening and closing array brackets as they'll always be\n // there and we can re-add them when deserializing\n JSON.stringify(unlistedValues).slice(1, -1),\n );\n joined = joinUint8Arrays(matchedIndices, jsonArray);\n } else {\n joined = matchedIndices;\n }\n\n return memoizedSign(joined, secret);\n}\n"],"mappings":";AAEO,SAAS,iBACd,aAC6B;AAC7B,MAAI,CAAC,MAAM,QAAQ,WAAW;AAAG,WAAO;AAExC,SAAO,YAAY,IAAI,CAAC,WAAW;AACjC,QAAI,OAAO,WAAW;AAAW,aAAO,EAAE,OAAO,OAAO;AACxD,QAAI,OAAO,WAAW;AAAU,aAAO,EAAE,OAAO,OAAO;AACvD,QAAI,OAAO,WAAW;AAAU,aAAO,EAAE,OAAO,OAAO;AACvD,QAAI,WAAW;AAAM,aAAO,EAAE,OAAO,OAAO;AAE5C,WAAO;AAAA,EACT,CAAC;AACH;;;ACAO,SAAS,WACd,IACA,SACA,EAAE,wBAAwB,MAAM,IAAuB,CAAC,GACrC;AACnB,MAAI,aAAa;AACjB,MAAI;AACJ,MAAI;AAEJ,WAAS,YAEJ,SACH;AACA,QAAI,cAAc,QAAQ,SAAS,OAAO;AAAG,aAAO;AAEpD,iBAAa,GAAG,MAAM,MAAM,OAAO;AAEnC,QAAI,CAAC,yBAAyB,WAAW,OAAO;AAC9C,iBAAW,MAAM,MAAM;AACrB,qBAAa;AAAA,MACf,CAAC;AAAA,IACH;AAEA,iBAAa;AACb,cAAU;AAEV,WAAO;AAAA,EACT;AAEA,SAAO;AACT;;;AC7CA,SAAS,WAAW,aAAa,qBAAqB;AAiBtD,IAAM,iBAAiB;AAAA,EACrB,CAAC,MAAc,WACb,cAAc,MAAM,UAAU,OAAO,MAAM,GAAG;AAAA,IAC5C,YAAY,CAAC,OAAO;AAAA,EACtB,CAAC;AAAA,EACH,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC;AAAA;AAAA,EACvC,EAAE,uBAAuB,KAAK;AAChC;AAEA,IAAM,eAAe;AAAA,EACnB,CAAC,YAAwB,WACvB,IAAI,YAAY,UAAU,EACvB,mBAAmB,EAAE,KAAK,QAAQ,CAAC,EACnC,KAAK,UAAU,OAAO,MAAM,CAAC;AAAA,EAClC,CAAC,GAAG;AAAA;AAAA,IAEF,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,UACrB,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC;AAAA,IAElC,EAAE,CAAC,MAAM,EAAE,CAAC;AAAA;AAAA,EACd,EAAE,uBAAuB,KAAK;AAChC;AAEA,SAAS,gBACP,OACA,OAC0B;AAC1B,QAAM,YAAY,MAAM,MAAM,GAAG,KAAK;AACtC,QAAM,aAAa,MAAM,MAAM,KAAK;AACpC,SAAO,CAAC,WAAW,UAAU;AAC/B;AAUA,eAAsB,YACpB,MACA,OACA,QACoC;AAEpC,QAAM,EAAE,QAAQ,IAAI,MAAM,eAAe,MAAM,MAAM;AAErD,QAAM,CAAC,qBAAqB,gBAAgB,IAC1C,QAAQ,WAAW,MAAM,SACrB,CAAC,OAAO,IACR,gBAAgB,SAAS,MAAM,MAAM;AAE3C,QAAM,cAAc;AAAA;AAAA,IAEhB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,OAAO,gBAAgB,CAAC,GAAG;AAAA,MAC5D;AAEJ,MAAI,UAAU;AACd,SAAO,oBAAoB;AAAA,IACzB,CAAC,KAAK,YAAY,UAAU;AAC1B,YAAM,OAAO,MAAM,KAAK;AAExB,UAAI,CAAC,MAAM;AACT,cAAM,IAAI,MAAM,2BAA2B,KAAK,EAAE;AAAA,MACpD;AAEA,cAAQ,YAAY;AAAA,QAClB,KAAK;AACH,cAAI,KAAK,GAAG,IAAI;AAChB;AAAA,QACF,KAAK;AACH,cAAI,KAAK,GAAG,IAAI;AAChB;AAAA,QACF,KAAK;AACH,cAAI,KAAK,GAAG,IAAI,YAAY,SAAS;AACrC;AAAA,QACF,KAAK;AACH,cAAI,KAAK,GAAG,IAAI;AAChB;AAAA,QACF;AACE,cAAI,KAAK,GAAG,IAAI,KAAK,UAAU,UAAU,GAAG;AAAA,MAChD;AAEA,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;AAmBA,IAAM,aAAc,uBAAM;AACxB,QAAM,0BAA0B,oBAAI,IAAiC;AACrE,SAAO,SAASA,YAAW,SAA4B,OAAkB;AACvE,UAAM,IAAI,OAAO;AAGjB,QAAI,UAAU,QAAQ,MAAM,aAAa,MAAM,YAAY,MAAM,UAAU;AACzE,aAAO,QAAQ,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK;AAAA,IACnD;AAGA,UAAM,mBAAmB,KAAK,UAAU,KAAK;AAC7C,QAAI,qBAAqB,wBAAwB,IAAI,OAAO;AAC5D,QAAI,CAAC,oBAAoB;AACvB,2BAAqB,QAAQ,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,KAAK,CAAC;AAC/D,8BAAwB,IAAI,SAAS,kBAAkB;AAAA,IACzD;AAEA,WAAO,mBAAmB,QAAQ,gBAAgB;AAAA,EACpD;AACF,GAAG;AAEH,SAAS,gBAAgB,QAAoB,QAAgC;AAC3E,QAAM,WAAW,IAAI,WAAW,OAAO,SAAS,OAAO,MAAM;AAC7D,WAAS,IAAI,MAAM;AACnB,WAAS,IAAI,QAAQ,OAAO,MAAM;AAClC,SAAO;AACT;AACA,eAAsB,UACpB,SACA,OACA,QACA;AACA,QAAM,iBAA8B,CAAC;AAErC,QAAM,iBAAiB,IAAI;AAAA,IACzB,MAAM,IAAI,CAAC,SAAS;AAClB,YAAM,UAAU,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAK,UAAU,CAAC;AAE9D,YAAM,QAAQ,QAAQ,KAAK,GAAG;AAC9B,UAAI,CAAC,OAAO,OAAO,SAAS,KAAK,GAAG,KAAK,UAAU,QAAW;AAC5D,cAAM,IAAI,MAAM,kCAAkC,KAAK,GAAG,GAAG;AAAA,MAC/D;AAIA,cAAQ,OAAO;AAAA,QACb,KAAK;AACH,iBAAO;AAAA,QACT,KAAK;AACH,iBAAO;AAAA,QACT,KAAK;AACH,iBAAO;AAAA,MACX;AAEA,YAAM,eAAe,WAAW,SAAS,KAAK;AAC9C,UAAI,eAAe;AAAI,eAAO;AAO9B,qBAAe,KAAK,KAAK;AACzB,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,MAAI;AAEJ,MAAI,eAAe,SAAS,GAAG;AAC7B,UAAM,YAAY,IAAI,YAAY,EAAE;AAAA;AAAA;AAAA,MAGlC,KAAK,UAAU,cAAc,EAAE,MAAM,GAAG,EAAE;AAAA,IAC5C;AACA,aAAS,gBAAgB,gBAAgB,SAAS;AAAA,EACpD,OAAO;AACL,aAAS;AAAA,EACX;AAEA,SAAO,aAAa,QAAQ,MAAM;AACpC;","names":["matchIndex"]}
1
+ {"version":3,"sources":["../src/lib/normalize-options.ts","../src/lib/async-memoize-one.ts","../src/lib/serialization.ts"],"sourcesContent":["import type { FlagOption, GenerousOption } from '../types';\n\nexport function normalizeOptions<T>(\n flagOptions: GenerousOption<T>[] | undefined,\n): FlagOption<T>[] | undefined {\n if (!Array.isArray(flagOptions)) return flagOptions;\n\n return flagOptions.map((option) => {\n if (typeof option === 'boolean') return { value: option };\n if (typeof option === 'number') return { value: option };\n if (typeof option === 'string') return { value: option };\n if (option === null) return { value: option };\n\n return option;\n }) as FlagOption<T>[];\n}\n","// adapted from https://github.com/microlinkhq/async-memoize-one\n// and https://github.com/alexreardon/memoize-one\n\ntype MemoizeOneOptions = {\n cachePromiseRejection?: boolean;\n};\n\ntype MemoizedFn<TFunc extends (this: any, ...args: any[]) => any> = (\n this: ThisParameterType<TFunc>,\n ...args: Parameters<TFunc>\n) => ReturnType<TFunc>;\n\n/**\n * Memoizes an async function, but only keeps the latest result\n */\nexport function memoizeOne<TFunc extends (this: any, ...newArgs: any[]) => any>(\n fn: TFunc,\n isEqual: (a: Parameters<TFunc>, b: Parameters<TFunc>) => boolean,\n { cachePromiseRejection = false }: MemoizeOneOptions = {},\n): MemoizedFn<TFunc> {\n let calledOnce = false;\n let oldArgs: Parameters<TFunc>;\n let lastResult: any;\n\n function memoized(\n this: ThisParameterType<TFunc>,\n ...newArgs: Parameters<TFunc>\n ) {\n if (calledOnce && isEqual(newArgs, oldArgs)) return lastResult;\n\n lastResult = fn.apply(this, newArgs);\n\n if (!cachePromiseRejection && lastResult.catch) {\n lastResult.catch(() => {\n calledOnce = false;\n });\n }\n\n calledOnce = true;\n oldArgs = newArgs;\n\n return lastResult;\n }\n\n return memoized;\n}\n","import { base64url, CompactSign, compactVerify } from 'jose';\nimport type { JsonValue } from '..';\nimport type { FlagOption } from '../types';\nimport { memoizeOne } from './async-memoize-one';\n\n// 252 max options length allows storing index 0 to 251,\n// so 252 is the first SPECIAL_INTEGER\nexport const MAX_OPTION_LENGTH = 252;\n\nenum SPECIAL_INTEGERS {\n /** Signals that the returned value is not listed in the flag's options */\n NULL = 252,\n BOOLEAN_FALSE = 253,\n BOOLEAN_TRUE = 254,\n UNLISTED_VALUE = 255,\n}\n\nconst memoizedVerify = memoizeOne(\n (code: string, secret: string) =>\n compactVerify(code, base64url.decode(secret), {\n algorithms: ['HS256'],\n }),\n (a, b) => a[0] === b[0] && a[1] === b[1], // only first two args matter\n { cachePromiseRejection: true },\n);\n\nconst memoizedSign = memoizeOne(\n (uint8Array: Uint8Array, secret) =>\n new CompactSign(uint8Array)\n .setProtectedHeader({ alg: 'HS256' })\n .sign(base64url.decode(secret)),\n (a, b) =>\n // matchedIndices array must be equal\n a[0].length === b[0].length &&\n a[0].every((v, i) => b[0][i] === v) &&\n // secrets must be equal\n a[1] === b[1],\n { cachePromiseRejection: true },\n);\n\nfunction splitUint8Array(\n array: Uint8Array,\n index: number,\n): [Uint8Array, Uint8Array] {\n const firstHalf = array.slice(0, index);\n const secondHalf = array.slice(index);\n return [firstHalf, secondHalf];\n}\n\n/**\n * Common subset of the flag type used in here\n */\ntype Flag = {\n key: string;\n options?: FlagOption<any>[];\n};\n\nexport async function deserialize(\n code: string,\n flags: readonly Flag[],\n secret: string,\n): Promise<Record<string, JsonValue>> {\n // TODO what happens when verification fails?\n const { payload } = await memoizedVerify(code, secret);\n\n const [matchedIndicesArray, valuesUint8Array] =\n payload.length === flags.length\n ? [payload]\n : splitUint8Array(payload, flags.length);\n\n const valuesArray = valuesUint8Array\n ? // re-add opening and closing brackets since we remove them when serializing\n JSON.parse(`[${new TextDecoder().decode(valuesUint8Array)}]`)\n : null;\n\n let spilled = 0;\n return matchedIndicesArray.reduce<Record<string, JsonValue>>(\n (acc, valueIndex, index) => {\n const flag = flags[index];\n\n if (!flag) {\n throw new Error(`flags: No flag at index ${index}`);\n }\n\n switch (valueIndex) {\n case SPECIAL_INTEGERS.BOOLEAN_FALSE:\n acc[flag.key] = false;\n break;\n case SPECIAL_INTEGERS.BOOLEAN_TRUE:\n acc[flag.key] = true;\n break;\n case SPECIAL_INTEGERS.UNLISTED_VALUE:\n acc[flag.key] = valuesArray[spilled++];\n break;\n case SPECIAL_INTEGERS.NULL:\n acc[flag.key] = null;\n break;\n default:\n acc[flag.key] = flag.options?.[valueIndex]?.value as JsonValue;\n }\n\n return acc;\n },\n {},\n );\n}\n\n/**\n * When serializing flags we find the matching option index for each evaluated value.\n *\n * This means we potentially need to iterate through all options of all flags.\n *\n * When the value we're trying to match is a literal (bool, string, number)\n * we look for it using referntial equality.\n *\n * When the value is an array or object we stringify the value and we stringify\n * the options of each flag and then we search for it by string comparison.\n *\n * This is faster than doing a deep equality check and also allows us not to\n * use any external library.\n *\n * We also cache the result of stringifying all options so in a Map so we only\n * ever need to stringify them once.\n */\nconst matchIndex = (() => {\n const stringifiedOptionsCache = new Map<FlagOption<any>[], string[]>();\n return function matchIndex(options: FlagOption<any>[], value: JsonValue) {\n const t = typeof value;\n\n // we're looking for a literal value, so we can check using referntial equality\n if (value === null || t === 'boolean' || t === 'string' || t === 'number') {\n return options.findIndex((v) => v.value === value);\n }\n\n // we're looking for an array or object, so we should check stringified\n const stringifiedValue = JSON.stringify(value);\n let stringifiedOptions = stringifiedOptionsCache.get(options);\n if (!stringifiedOptions) {\n stringifiedOptions = options.map((o) => JSON.stringify(o.value));\n stringifiedOptionsCache.set(options, stringifiedOptions);\n }\n\n return stringifiedOptions.indexOf(stringifiedValue);\n };\n})();\n\nfunction joinUint8Arrays(array1: Uint8Array, array2: Uint8Array): Uint8Array {\n const combined = new Uint8Array(array1.length + array2.length);\n combined.set(array1);\n combined.set(array2, array1.length);\n return combined;\n}\nexport async function serialize(\n flagSet: Record<Flag['key'], JsonValue>,\n flags: readonly Flag[],\n secret: string,\n) {\n const unlistedValues: JsonValue[] = [];\n\n const matchedIndices = new Uint8Array(\n flags.map((flag) => {\n const options = Array.isArray(flag.options) ? flag.options : [];\n\n const value = flagSet[flag.key];\n if (!Object.hasOwn(flagSet, flag.key) || value === undefined) {\n throw new Error(`flags: Missing value for flag \"${flag.key}\"`);\n }\n\n // avoid searching for common values\n // and ensure they can always be compressed, even if not listed in options\n switch (value) {\n case null:\n return SPECIAL_INTEGERS.NULL;\n case false:\n return SPECIAL_INTEGERS.BOOLEAN_FALSE;\n case true:\n return SPECIAL_INTEGERS.BOOLEAN_TRUE;\n }\n\n const matchedIndex = matchIndex(options, value);\n if (matchedIndex > -1) return matchedIndex;\n\n // value was not listed in options, so we need to\n // transport it using JSON.stringify(). we return 255 to\n // indicate this value is stringified.\n // stringified values will be placed at the end of the\n // indices array\n unlistedValues.push(value);\n return SPECIAL_INTEGERS.UNLISTED_VALUE;\n }),\n );\n\n let joined: Uint8Array;\n // there were unlisted values, so we need to join arrays\n if (unlistedValues.length > 0) {\n const jsonArray = new TextEncoder().encode(\n // slicing removes opening and closing array brackets as they'll always be\n // there and we can re-add them when deserializing\n JSON.stringify(unlistedValues).slice(1, -1),\n );\n joined = joinUint8Arrays(matchedIndices, jsonArray);\n } else {\n joined = matchedIndices;\n }\n\n return memoizedSign(joined, secret);\n}\n"],"mappings":"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","names":["matchIndex"]}
@@ -1,16 +1,11 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/lib/normalize-options.ts
2
2
  function normalizeOptions(flagOptions) {
3
- if (!Array.isArray(flagOptions))
4
- return flagOptions;
3
+ if (!Array.isArray(flagOptions)) return flagOptions;
5
4
  return flagOptions.map((option) => {
6
- if (typeof option === "boolean")
7
- return { value: option };
8
- if (typeof option === "number")
9
- return { value: option };
10
- if (typeof option === "string")
11
- return { value: option };
12
- if (option === null)
13
- return { value: option };
5
+ if (typeof option === "boolean") return { value: option };
6
+ if (typeof option === "number") return { value: option };
7
+ if (typeof option === "string") return { value: option };
8
+ if (option === null) return { value: option };
14
9
  return option;
15
10
  });
16
11
  }
@@ -21,8 +16,7 @@ function memoizeOne(fn, isEqual, { cachePromiseRejection = false } = {}) {
21
16
  let oldArgs;
22
17
  let lastResult;
23
18
  function memoized(...newArgs) {
24
- if (calledOnce && isEqual(newArgs, oldArgs))
25
- return lastResult;
19
+ if (calledOnce && isEqual(newArgs, oldArgs)) return lastResult;
26
20
  lastResult = fn.apply(this, newArgs);
27
21
  if (!cachePromiseRejection && lastResult.catch) {
28
22
  lastResult.catch(() => {
@@ -135,8 +129,7 @@ async function serialize(flagSet, flags, secret) {
135
129
  return 254 /* BOOLEAN_TRUE */;
136
130
  }
137
131
  const matchedIndex = matchIndex(options, value);
138
- if (matchedIndex > -1)
139
- return matchedIndex;
132
+ if (matchedIndex > -1) return matchedIndex;
140
133
  unlistedValues.push(value);
141
134
  return 255 /* UNLISTED_VALUE */;
142
135
  })
@@ -161,4 +154,4 @@ async function serialize(flagSet, flags, secret) {
161
154
 
162
155
 
163
156
  exports.normalizeOptions = normalizeOptions; exports.memoizeOne = memoizeOne; exports.deserialize = deserialize; exports.serialize = serialize;
164
- //# sourceMappingURL=chunk-RGAQJSYN.cjs.map
157
+ //# sourceMappingURL=chunk-WECCP5XG.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/home/runner/work/flags/flags/packages/flags/dist/chunk-WECCP5XG.cjs","../src/lib/normalize-options.ts","../src/lib/async-memoize-one.ts","../src/lib/serialization.ts"],"names":[],"mappings":"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","file":"/home/runner/work/flags/flags/packages/flags/dist/chunk-WECCP5XG.cjs","sourcesContent":[null,"import type { FlagOption, GenerousOption } from '../types';\n\nexport function normalizeOptions<T>(\n flagOptions: GenerousOption<T>[] | undefined,\n): FlagOption<T>[] | undefined {\n if (!Array.isArray(flagOptions)) return flagOptions;\n\n return flagOptions.map((option) => {\n if (typeof option === 'boolean') return { value: option };\n if (typeof option === 'number') return { value: option };\n if (typeof option === 'string') return { value: option };\n if (option === null) return { value: option };\n\n return option;\n }) as FlagOption<T>[];\n}\n","// adapted from https://github.com/microlinkhq/async-memoize-one\n// and https://github.com/alexreardon/memoize-one\n\ntype MemoizeOneOptions = {\n cachePromiseRejection?: boolean;\n};\n\ntype MemoizedFn<TFunc extends (this: any, ...args: any[]) => any> = (\n this: ThisParameterType<TFunc>,\n ...args: Parameters<TFunc>\n) => ReturnType<TFunc>;\n\n/**\n * Memoizes an async function, but only keeps the latest result\n */\nexport function memoizeOne<TFunc extends (this: any, ...newArgs: any[]) => any>(\n fn: TFunc,\n isEqual: (a: Parameters<TFunc>, b: Parameters<TFunc>) => boolean,\n { cachePromiseRejection = false }: MemoizeOneOptions = {},\n): MemoizedFn<TFunc> {\n let calledOnce = false;\n let oldArgs: Parameters<TFunc>;\n let lastResult: any;\n\n function memoized(\n this: ThisParameterType<TFunc>,\n ...newArgs: Parameters<TFunc>\n ) {\n if (calledOnce && isEqual(newArgs, oldArgs)) return lastResult;\n\n lastResult = fn.apply(this, newArgs);\n\n if (!cachePromiseRejection && lastResult.catch) {\n lastResult.catch(() => {\n calledOnce = false;\n });\n }\n\n calledOnce = true;\n oldArgs = newArgs;\n\n return lastResult;\n }\n\n return memoized;\n}\n","import { base64url, CompactSign, compactVerify } from 'jose';\nimport type { JsonValue } from '..';\nimport type { FlagOption } from '../types';\nimport { memoizeOne } from './async-memoize-one';\n\n// 252 max options length allows storing index 0 to 251,\n// so 252 is the first SPECIAL_INTEGER\nexport const MAX_OPTION_LENGTH = 252;\n\nenum SPECIAL_INTEGERS {\n /** Signals that the returned value is not listed in the flag's options */\n NULL = 252,\n BOOLEAN_FALSE = 253,\n BOOLEAN_TRUE = 254,\n UNLISTED_VALUE = 255,\n}\n\nconst memoizedVerify = memoizeOne(\n (code: string, secret: string) =>\n compactVerify(code, base64url.decode(secret), {\n algorithms: ['HS256'],\n }),\n (a, b) => a[0] === b[0] && a[1] === b[1], // only first two args matter\n { cachePromiseRejection: true },\n);\n\nconst memoizedSign = memoizeOne(\n (uint8Array: Uint8Array, secret) =>\n new CompactSign(uint8Array)\n .setProtectedHeader({ alg: 'HS256' })\n .sign(base64url.decode(secret)),\n (a, b) =>\n // matchedIndices array must be equal\n a[0].length === b[0].length &&\n a[0].every((v, i) => b[0][i] === v) &&\n // secrets must be equal\n a[1] === b[1],\n { cachePromiseRejection: true },\n);\n\nfunction splitUint8Array(\n array: Uint8Array,\n index: number,\n): [Uint8Array, Uint8Array] {\n const firstHalf = array.slice(0, index);\n const secondHalf = array.slice(index);\n return [firstHalf, secondHalf];\n}\n\n/**\n * Common subset of the flag type used in here\n */\ntype Flag = {\n key: string;\n options?: FlagOption<any>[];\n};\n\nexport async function deserialize(\n code: string,\n flags: readonly Flag[],\n secret: string,\n): Promise<Record<string, JsonValue>> {\n // TODO what happens when verification fails?\n const { payload } = await memoizedVerify(code, secret);\n\n const [matchedIndicesArray, valuesUint8Array] =\n payload.length === flags.length\n ? [payload]\n : splitUint8Array(payload, flags.length);\n\n const valuesArray = valuesUint8Array\n ? // re-add opening and closing brackets since we remove them when serializing\n JSON.parse(`[${new TextDecoder().decode(valuesUint8Array)}]`)\n : null;\n\n let spilled = 0;\n return matchedIndicesArray.reduce<Record<string, JsonValue>>(\n (acc, valueIndex, index) => {\n const flag = flags[index];\n\n if (!flag) {\n throw new Error(`flags: No flag at index ${index}`);\n }\n\n switch (valueIndex) {\n case SPECIAL_INTEGERS.BOOLEAN_FALSE:\n acc[flag.key] = false;\n break;\n case SPECIAL_INTEGERS.BOOLEAN_TRUE:\n acc[flag.key] = true;\n break;\n case SPECIAL_INTEGERS.UNLISTED_VALUE:\n acc[flag.key] = valuesArray[spilled++];\n break;\n case SPECIAL_INTEGERS.NULL:\n acc[flag.key] = null;\n break;\n default:\n acc[flag.key] = flag.options?.[valueIndex]?.value as JsonValue;\n }\n\n return acc;\n },\n {},\n );\n}\n\n/**\n * When serializing flags we find the matching option index for each evaluated value.\n *\n * This means we potentially need to iterate through all options of all flags.\n *\n * When the value we're trying to match is a literal (bool, string, number)\n * we look for it using referntial equality.\n *\n * When the value is an array or object we stringify the value and we stringify\n * the options of each flag and then we search for it by string comparison.\n *\n * This is faster than doing a deep equality check and also allows us not to\n * use any external library.\n *\n * We also cache the result of stringifying all options so in a Map so we only\n * ever need to stringify them once.\n */\nconst matchIndex = (() => {\n const stringifiedOptionsCache = new Map<FlagOption<any>[], string[]>();\n return function matchIndex(options: FlagOption<any>[], value: JsonValue) {\n const t = typeof value;\n\n // we're looking for a literal value, so we can check using referntial equality\n if (value === null || t === 'boolean' || t === 'string' || t === 'number') {\n return options.findIndex((v) => v.value === value);\n }\n\n // we're looking for an array or object, so we should check stringified\n const stringifiedValue = JSON.stringify(value);\n let stringifiedOptions = stringifiedOptionsCache.get(options);\n if (!stringifiedOptions) {\n stringifiedOptions = options.map((o) => JSON.stringify(o.value));\n stringifiedOptionsCache.set(options, stringifiedOptions);\n }\n\n return stringifiedOptions.indexOf(stringifiedValue);\n };\n})();\n\nfunction joinUint8Arrays(array1: Uint8Array, array2: Uint8Array): Uint8Array {\n const combined = new Uint8Array(array1.length + array2.length);\n combined.set(array1);\n combined.set(array2, array1.length);\n return combined;\n}\nexport async function serialize(\n flagSet: Record<Flag['key'], JsonValue>,\n flags: readonly Flag[],\n secret: string,\n) {\n const unlistedValues: JsonValue[] = [];\n\n const matchedIndices = new Uint8Array(\n flags.map((flag) => {\n const options = Array.isArray(flag.options) ? flag.options : [];\n\n const value = flagSet[flag.key];\n if (!Object.hasOwn(flagSet, flag.key) || value === undefined) {\n throw new Error(`flags: Missing value for flag \"${flag.key}\"`);\n }\n\n // avoid searching for common values\n // and ensure they can always be compressed, even if not listed in options\n switch (value) {\n case null:\n return SPECIAL_INTEGERS.NULL;\n case false:\n return SPECIAL_INTEGERS.BOOLEAN_FALSE;\n case true:\n return SPECIAL_INTEGERS.BOOLEAN_TRUE;\n }\n\n const matchedIndex = matchIndex(options, value);\n if (matchedIndex > -1) return matchedIndex;\n\n // value was not listed in options, so we need to\n // transport it using JSON.stringify(). we return 255 to\n // indicate this value is stringified.\n // stringified values will be placed at the end of the\n // indices array\n unlistedValues.push(value);\n return SPECIAL_INTEGERS.UNLISTED_VALUE;\n }),\n );\n\n let joined: Uint8Array;\n // there were unlisted values, so we need to join arrays\n if (unlistedValues.length > 0) {\n const jsonArray = new TextEncoder().encode(\n // slicing removes opening and closing array brackets as they'll always be\n // there and we can re-add them when deserializing\n JSON.stringify(unlistedValues).slice(1, -1),\n );\n joined = joinUint8Arrays(matchedIndices, jsonArray);\n } else {\n joined = matchedIndices;\n }\n\n return memoizedSign(joined, secret);\n}\n"]}