@graphcommerce/next-config 9.0.0-canary.115 → 9.0.0-canary.116

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## 9.0.0-canary.116
+
+### Minor Changes
+
+- [#2452](https://github.com/graphcommerce-org/graphcommerce/pull/2452) [`aab290f`](https://github.com/graphcommerce-org/graphcommerce/commit/aab290f9c905be06e742cd8ad50d7d415930828a) - Migrated to next.config.ts ([@paales](https://github.com/paales))
+
 ## 9.0.0-canary.115
 
 ## 9.0.0-canary.114

package/__tests__/config/utils/__snapshots__/mergeEnvIntoConfig.ts.snap

@@ -46,6 +46,7 @@ exports[`traverses a schema and returns a list of env variables that match 1`] =
   "GC_DATA_LAYER",
   "GC_DATA_LAYER_CORE_WEB_VITALS",
   "GC_DEBUG",
+  "GC_DEBUG_CART",
   "GC_DEBUG_PLUGIN_STATUS",
   "GC_DEBUG_SESSIONS",
   "GC_DEBUG_WEBPACK_CIRCULAR_DEPENDENCY_PLUGIN",

package/__tests__/interceptors/findPlugins.ts

@@ -1,5 +1,6 @@
 import type { GraphCommerceConfig } from '../../src/generated/config'
 import { findPlugins } from '../../src/interceptors/findPlugins'
+
 const projectRoot = `${process.cwd()}/examples/magento-graphcms`
 it('finds plugins', () => {
   const fakeconfig = {
@@ -12,7 +13,8 @@ it('finds plugins', () => {
   const disabled = plugins.filter((p) => !p.enabled)
   const enabled = plugins.filter((p) => p.enabled)
   expect(errors).toMatchInlineSnapshot('[]')
-  expect(enabled).toMatchInlineSnapshot(`
+  expect(enabled).toMatchInlineSnapshot(
+    `
     [
       {
         "enabled": true,
@@ -282,17 +284,17 @@ it('finds plugins', () => {
       },
       {
         "enabled": true,
-        "sourceExport": "getInContextInput",
+        "sourceExport": "getPrivateQueryContext",
         "sourceModule": "@graphcommerce/algolia-personalization/plugins/InContextInputAlgoliaUserToken",
-        "targetExport": "getInContextInput",
+        "targetExport": "getPrivateQueryContext",
         "targetModule": "@graphcommerce/graphql",
         "type": "function",
       },
       {
         "enabled": true,
-        "sourceExport": "useInContextInput",
+        "sourceExport": "usePrivateQueryContext",
         "sourceModule": "@graphcommerce/algolia-personalization/plugins/InContextInputAlgoliaUserToken",
-        "targetExport": "useInContextInput",
+        "targetExport": "usePrivateQueryContext",
         "targetModule": "@graphcommerce/graphql",
         "type": "function",
       },
@@ -482,25 +484,17 @@ it('finds plugins', () => {
       },
       {
         "enabled": true,
-        "sourceExport": "graphqlConfig",
-        "sourceModule": "@graphcommerce/magento-customer/plugins/magentoCustomerRemoveInContextDirective",
-        "targetExport": "graphqlConfig",
-        "targetModule": "@graphcommerce/graphql",
-        "type": "function",
-      },
-      {
-        "enabled": true,
-        "sourceExport": "getInContextInput",
-        "sourceModule": "@graphcommerce/magento-customer/plugins/magentoCustomerGetInContext",
-        "targetExport": "getInContextInput",
+        "sourceExport": "getPrivateQueryContext",
+        "sourceModule": "@graphcommerce/magento-customer/plugins/magentoCustomerPrivateQueryContext",
+        "targetExport": "getPrivateQueryContext",
         "targetModule": "@graphcommerce/graphql",
         "type": "function",
       },
       {
         "enabled": true,
-        "sourceExport": "useInContextInput",
-        "sourceModule": "@graphcommerce/magento-customer/plugins/magentoCustomerGetInContext",
-        "targetExport": "useInContextInput",
+        "sourceExport": "usePrivateQueryContext",
+        "sourceModule": "@graphcommerce/magento-customer/plugins/magentoCustomerPrivateQueryContext",
+        "targetExport": "usePrivateQueryContext",
         "targetModule": "@graphcommerce/graphql",
         "type": "function",
       },
@@ -549,7 +543,8 @@ it('finds plugins', () => {
         "type": "function",
       },
     ]
-  `)
+  `,
+  )
   expect(disabled).toMatchInlineSnapshot(`
     [
       {
@@ -723,6 +718,15 @@ it('finds plugins', () => {
         "targetModule": "@graphcommerce/framer-next-pages",
         "type": "component",
       },
+      {
+        "enabled": false,
+        "ifConfig": "debug.cart",
+        "sourceExport": "FramerNextPages",
+        "sourceModule": "@graphcommerce/magento-cart/plugins/CartDebuggerPlugin",
+        "targetExport": "FramerNextPages",
+        "targetModule": "@graphcommerce/framer-next-pages",
+        "type": "component",
+      },
       {
         "enabled": false,
         "ifConfig": "debug.sessions",

package/__tests__/interceptors/generateInterceptors.ts

@@ -8,12 +8,7 @@ import { resolveDependency } from '../../src/utils/resolveDependency'
 const projectRoot = `${process.cwd()}/examples/magento-graphcms`
 const startLocation = '/** @see {@link file://'
 const expectImport = (value: string | undefined): jest.JestMatchers<string> =>
-  expect(
-    value
-      ?.slice(value.indexOf('import') - 1, value.indexOf(startLocation) - 1)
-
-      .trim(),
-  )
+  expect(value?.slice(value.indexOf('import') - 1, value.indexOf(startLocation) - 1).trim())
 const expectInterceptor = (value: string | undefined): jest.JestMatchers<string> => {
   const val = value?.slice(value.indexOf(SOURCE_END) + SOURCE_END.length).trim()
   return expect(val?.trim())
@@ -384,6 +379,7 @@ it('adds debug logging to interceptors for components', async () => {
     import type { ApolloLink, TypePolicies } from '@apollo/client'
     import type { SetRequired } from 'type-fest'
     import type { MigrateCache } from './components/GraphQLProvider/migrateCache'
+    import { RemovePrivateContextDirectivesLink } from './link/RemovePrivateContextDirectivesLink'
 
     export interface PreviewData {}
     export type PreviewConfig = {
@@ -404,7 +400,7 @@ it('adds debug logging to interceptors for components', async () => {
       const { storefront, links = [], policies = [], migrations = [], ...rest } = config
       return {
         storefront,
-        links,
+        links: [...links, new RemovePrivateContextDirectivesLink()],
         policies,
         migrations,
         ...rest,
@@ -704,8 +700,7 @@ it('Can correctly find exports that are default exports', async () => {
   `)
   expectOriginal(result).toContain('iconChevronLeftDisabled')
   expectOriginal(result).toContain('iconChevronRightDisabled')
-  expectInterceptor(result).toMatchInlineSnapshot(
-    `
+  expectInterceptor(result).toMatchInlineSnapshot(`
     "/**
      * Here you see the 'interceptor' that is applying all the configured plugins.
      *
@@ -727,6 +722,5 @@ it('Can correctly find exports that are default exports', async () => {
      * @see {iconChevronRightMyProjectIcon} for replacement of the original source (original source not used)
      */
     export const iconChevronRight = iconChevronRightMyProjectIcon"
-  `,
-  )
+  `)
 })

package/dist/config/demoConfig.js

@@ -4,8 +4,8 @@ exports.demoConfig = void 0;
 exports.demoConfig = {
     canonicalBaseUrl: 'https://graphcommerce.vercel.app',
     hygraphEndpoint: 'https://eu-central-1.cdn.hygraph.com/content/ckhx7xadya6xs01yxdujt8i80/master',
-    magentoEndpoint: 'https://backend.reachdigital.dev/graphql',
-    magentoVersion: 246,
+    magentoEndpoint: 'https://configurator.reachdigital.dev/graphql',
+    magentoVersion: 247,
     storefront: [
         { locale: 'en', magentoStoreCode: 'en_US', defaultLocale: true },
         {

package/dist/config/utils/mergeEnvIntoConfig.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterEnv = exports.dotNotation = exports.toEnvStr = void 0;
+exports.toEnvStr = void 0;
 exports.configToEnvSchema = configToEnvSchema;
 exports.mergeEnvIntoConfig = mergeEnvIntoConfig;
 exports.formatAppliedEnv = formatAppliedEnv;
@@ -23,7 +23,6 @@ const dotNotation = (pathParts) => pathParts
     return !Number.isNaN(idx) ? `[${idx}]` : v;
 })
     .join('.');
-exports.dotNotation = dotNotation;
 function isJSON(str) {
     if (!str)
         return true;
@@ -55,7 +54,7 @@ function configToEnvSchema(schema) {
                     .optional()
                     .refine(isJSON, { message: 'Invalid JSON' })
                     .transform((val) => (val ? JSON.parse(val) : val));
-                envToDot[(0, exports.toEnvStr)(path)] = (0, exports.dotNotation)(path);
+                envToDot[(0, exports.toEnvStr)(path)] = dotNotation(path);
             }
             const typeNode = node;
             Object.keys(typeNode.shape).forEach((key) => {
@@ -71,7 +70,7 @@ function configToEnvSchema(schema) {
                     .optional()
                     .refine(isJSON, { message: 'Invalid JSON' })
                     .transform((val) => (val ? JSON.parse(val) : val));
-                envToDot[(0, exports.toEnvStr)(path)] = (0, exports.dotNotation)(path);
+                envToDot[(0, exports.toEnvStr)(path)] = dotNotation(path);
             }
             arr.forEach((key) => {
                 walk(node.element, [...path, String(key)]);
@@ -80,12 +79,12 @@ function configToEnvSchema(schema) {
         }
         if (node instanceof zod_1.ZodNumber) {
             envSchema[(0, exports.toEnvStr)(path)] = zod_1.z.coerce.number().optional();
-            envToDot[(0, exports.toEnvStr)(path)] = (0, exports.dotNotation)(path);
+            envToDot[(0, exports.toEnvStr)(path)] = dotNotation(path);
             return;
         }
         if (node instanceof zod_1.ZodString || node instanceof zod_1.ZodEnum) {
             envSchema[(0, exports.toEnvStr)(path)] = node.optional();
-            envToDot[(0, exports.toEnvStr)(path)] = (0, exports.dotNotation)(path);
+            envToDot[(0, exports.toEnvStr)(path)] = dotNotation(path);
             return;
         }
         if (node instanceof zod_1.ZodBoolean) {
@@ -99,7 +98,7 @@ function configToEnvSchema(schema) {
                     return false;
                 return v;
             });
-            envToDot[(0, exports.toEnvStr)(path)] = (0, exports.dotNotation)(path);
+            envToDot[(0, exports.toEnvStr)(path)] = dotNotation(path);
             return;
         }
         throw Error(`[@graphcommerce/next-config] Unknown type in schema ${node.constructor.name}. This is probably a bug please create an issue.`);
@@ -108,9 +107,8 @@ function configToEnvSchema(schema) {
     return [zod_1.z.object(envSchema), envToDot];
 }
 const filterEnv = (env) => Object.fromEntries(Object.entries(env).filter(([key]) => key.startsWith('GC_')));
-exports.filterEnv = filterEnv;
 function mergeEnvIntoConfig(schema, config, env) {
-    const filteredEnv = (0, exports.filterEnv)(env);
+    const filteredEnv = filterEnv(env);
     const newConfig = (0, utilities_1.cloneDeep)(config);
     const [envSchema, envToDot] = configToEnvSchema(schema);
     const result = envSchema.safeParse(filteredEnv);

package/dist/generated/config.js

@@ -76,6 +76,7 @@ function GraphCommerceConfigSchema() {
 }
 function GraphCommerceDebugConfigSchema() {
     return zod_1.z.object({
+        cart: zod_1.z.boolean().nullish(),
         pluginStatus: zod_1.z.boolean().nullish(),
         sessions: zod_1.z.boolean().nullish(),
         webpackCircularDependencyPlugin: zod_1.z.boolean().nullish(),

package/dist/interceptors/InterceptorPlugin.js

@@ -47,6 +47,7 @@ class InterceptorPlugin {
         generating = false;
         return generatedInterceptors;
     };
+    /** @public */
     apply(compiler) {
         const logger = compiler.getInfrastructureLogger('InterceptorPlugin');
         // After the compilation has succeeded we watch all possible plugin locations.

package/dist/interceptors/Visitor.js

@@ -6,6 +6,7 @@ exports.Visitor = void 0;
 /* eslint-disable consistent-return */
 /**
  * @deprecated JavaScript API is deprecated. Please use Wasm plugin instead.
+ * @public
  */
 class Visitor {
     visitProgram(n) {
@@ -1411,4 +1412,3 @@ class Visitor {
     }
 }
 exports.Visitor = Visitor;
-exports.default = Visitor;

package/dist/interceptors/extractExports.js

@@ -1,11 +1,7 @@
 "use strict";
 /* eslint-disable @typescript-eslint/no-explicit-any */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RUNTIME_VALUE = exports.UnsupportedValueError = exports.NoSuchDeclarationError = void 0;
 exports.extractExports = extractExports;
-class NoSuchDeclarationError extends Error {
-}
-exports.NoSuchDeclarationError = NoSuchDeclarationError;
 function isIdentifier(node) {
     return node.type === 'Identifier';
 }
@@ -36,34 +32,7 @@ function isRegExpLiteral(node) {
 function isTemplateLiteral(node) {
     return node.type === 'TemplateLiteral';
 }
-class UnsupportedValueError extends Error {
-    /** @example `config.runtime[0].value` */
-    path;
-    constructor(message, paths) {
-        super(message);
-        // Generating "path" that looks like "config.runtime[0].value"
-        let codePath;
-        if (Array.isArray(paths)) {
-            codePath = '';
-            for (const path of paths) {
-                if (path[0] === '[') {
-                    // "array" + "[0]"
-                    codePath += path;
-                }
-                else if (codePath === '') {
-                    codePath = path;
-                }
-                else {
-                    // "object" + ".key"
-                    codePath += `.${path}`;
-                }
-            }
-        }
-        this.path = codePath;
-    }
-}
-exports.UnsupportedValueError = UnsupportedValueError;
-exports.RUNTIME_VALUE = Symbol('RUNTIME_VALUE');
+const RUNTIME_VALUE = Symbol('RUNTIME_VALUE');
 function extractValue(node, path, optional = false) {
     if (isNullLiteral(node)) {
         return null;
@@ -89,8 +58,7 @@ function extractValue(node, path, optional = false) {
             case 'undefined':
                 return undefined;
             default:
-                return exports.RUNTIME_VALUE;
-            // throw new UnsupportedValueError(`Unknown identifier "${node.value}"`, path)
+                return RUNTIME_VALUE;
         }
     }
     else if (isArrayExpression(node)) {
@@ -101,11 +69,7 @@ function extractValue(node, path, optional = false) {
             if (elem) {
                 if (elem.spread) {
                     // e.g. [ ...a ]
-                    return exports.RUNTIME_VALUE;
-                    // throw new UnsupportedValueError(
-                    //   'Unsupported spread operator in the Array Expression',
-                    //   path,
-                    // )
+                    return RUNTIME_VALUE;
                 }
                 arr.push(extractValue(elem.expression, path && [...path, `[${i}]`], optional));
             }
@@ -123,11 +87,7 @@ function extractValue(node, path, optional = false) {
         for (const prop of node.properties) {
             if (!isKeyValueProperty(prop)) {
                 // e.g. { ...a }
-                return exports.RUNTIME_VALUE;
-                // throw new UnsupportedValueError(
-                //   'Unsupported spread operator in the Object Expression',
-                //   path,
-                // )
+                return RUNTIME_VALUE;
             }
             let key;
             if (isIdentifier(prop.key)) {
@@ -139,11 +99,7 @@ function extractValue(node, path, optional = false) {
                 key = prop.key.value;
             }
             else {
-                return exports.RUNTIME_VALUE;
-                // throw new UnsupportedValueError(
-                //   `Unsupported key type "${prop.key.type}" in the Object Expression`,
-                //   path,
-                // )
+                return RUNTIME_VALUE;
             }
             obj[key] = extractValue(prop.value, path && [...path, key]);
         }
@@ -153,8 +109,7 @@ function extractValue(node, path, optional = false) {
         // e.g. `abc`
         if (node.expressions.length !== 0) {
             // TODO: should we add support for `${'e'}d${'g'}'e'`?
-            return exports.RUNTIME_VALUE;
-            // throw new UnsupportedValueError('Unsupported template literal with expressions', path)
+            return RUNTIME_VALUE;
         }
         // When TemplateLiteral has 0 expressions, the length of quasis is always 1.
         // Because when parsing TemplateLiteral, the parser yields the first quasi,
@@ -169,8 +124,7 @@ function extractValue(node, path, optional = false) {
         return cooked ?? raw;
     }
     else {
-        return exports.RUNTIME_VALUE;
-        // throw new UnsupportedValueError(`Unsupported node type "${node.type}"`, path)
+        return RUNTIME_VALUE;
     }
 }
 function extractExports(module) {
@@ -188,7 +142,7 @@ function extractExports(module) {
                 switch (moduleItem.declaration.type) {
                     case 'ClassDeclaration':
                     case 'FunctionDeclaration':
-                        exports[moduleItem.declaration.identifier.value] = exports.RUNTIME_VALUE;
+                        exports[moduleItem.declaration.identifier.value] = RUNTIME_VALUE;
                         // node.identifier.value
                         break;
                     case 'VariableDeclaration':

package/dist/interceptors/generateInterceptor.js

@@ -17,22 +17,26 @@ const prettier_config_pwa_1 = __importDefault(require("@graphcommerce/prettier-c
 const prettier_1 = __importDefault(require("prettier"));
 const RenameVisitor_1 = require("./RenameVisitor");
 const swc_1 = require("./swc");
+/** @public */
 function isPluginBaseConfig(plugin) {
     return (typeof plugin.type === 'string' &&
         typeof plugin.sourceModule === 'string' &&
         typeof plugin.enabled === 'boolean' &&
         typeof plugin.targetExport === 'string');
 }
+/** @public */
 function isReactPluginConfig(plugin) {
     if (!isPluginBaseConfig(plugin))
         return false;
     return plugin.type === 'component';
 }
+/** @public */
 function isMethodPluginConfig(plugin) {
     if (!isPluginBaseConfig(plugin))
         return false;
     return plugin.type === 'function';
 }
+/** @public */
 function isReplacePluginConfig(plugin) {
     if (!isPluginBaseConfig(plugin))
         return false;

package/dist/utils/TopologicalSort.js

@@ -14,12 +14,15 @@ class TopologicalSort {
         this.#nodes = new Map();
         this.addMultipleInternalNodes(nodes);
     }
+    /** @public */
     addNode(key, node) {
         return this.addInternalNode(key, node);
     }
+    /** @public */
     addNodes(nodes) {
         this.addMultipleInternalNodes(nodes);
     }
+    /** @public */
     addEdge(fromKey, toKey) {
         (0, assert_1.default)(this.#nodes.has(fromKey), `Source package with ${fromKey} key should exist`);
         (0, assert_1.default)(this.#nodes.has(toKey), `Target package with ${toKey} key should exist`);
@@ -30,6 +33,7 @@ class TopologicalSort {
         assert_1.default.strictEqual(sourceNode.children.has(toKey), false, `Source package ${fromKey} already has an edge to target node ${toKey}`);
         sourceNode.children.set(toKey, targetNode);
     }
+    /** @public */
     sort() {
         this.#visitedNodes = new Set();
         this.#sortedKeysStack = [];

package/package.json

@@ -2,7 +2,7 @@
   "name": "@graphcommerce/next-config",
   "homepage": "https://www.graphcommerce.org/",
   "repository": "github:graphcommerce-org/graphcommerce",
-  "version": "9.0.0-canary.115",
+  "version": "9.0.0-canary.116",
   "type": "commonjs",
   "main": "dist/index.js",
   "types": "src/index.ts",

package/src/config/demoConfig.ts

@@ -6,8 +6,8 @@ export const demoConfig: PartialDeep<GraphCommerceConfig, { recurseIntoArrays: t
   Record<string, unknown> & { storefront: PartialDeep<GraphCommerceStorefrontConfig>[] } = {
   canonicalBaseUrl: 'https://graphcommerce.vercel.app',
   hygraphEndpoint: 'https://eu-central-1.cdn.hygraph.com/content/ckhx7xadya6xs01yxdujt8i80/master',
-  magentoEndpoint: 'https://backend.reachdigital.dev/graphql',
-  magentoVersion: 246,
+  magentoEndpoint: 'https://configurator.reachdigital.dev/graphql',
+  magentoVersion: 247,
   storefront: [
     { locale: 'en', magentoStoreCode: 'en_US', defaultLocale: true },
     {

package/src/config/utils/mergeEnvIntoConfig.ts

@@ -21,7 +21,7 @@ import diff from './diff'
 
 const fmt = (s: string) => s.split(/(\d+)/).map(snakeCase).join('')
 export const toEnvStr = (path: string[]) => ['GC', ...path].map(fmt).join('_').toUpperCase()
-export const dotNotation = (pathParts: string[]) =>
+const dotNotation = (pathParts: string[]) =>
   pathParts
     .map((v) => {
       const idx = Number(v)
@@ -144,7 +144,7 @@ export type ApplyResultItem = {
 }
 export type ApplyResult = ApplyResultItem[]
 
-export const filterEnv = (env: Record<string, string | undefined>) =>
+const filterEnv = (env: Record<string, string | undefined>) =>
   Object.fromEntries(Object.entries(env).filter(([key]) => key.startsWith('GC_')))
 
 export function mergeEnvIntoConfig(

package/src/generated/config.ts

@@ -359,6 +359,8 @@ export type GraphCommerceConfig = {
 
 /** Debug configuration for GraphCommerce */
 export type GraphCommerceDebugConfig = {
+  /** Enable debugging interface to debug sessions */
+  cart?: InputMaybe<Scalars['Boolean']['input']>;
   /** Reports which plugins are enabled or disabled. */
   pluginStatus?: InputMaybe<Scalars['Boolean']['input']>;
   /** Enable debugging interface to debug sessions */
@@ -596,6 +598,7 @@ export function GraphCommerceConfigSchema(): z.ZodObject<Properties<GraphCommerc
 
 export function GraphCommerceDebugConfigSchema(): z.ZodObject<Properties<GraphCommerceDebugConfig>> {
   return z.object({
+    cart: z.boolean().nullish(),
     pluginStatus: z.boolean().nullish(),
     sessions: z.boolean().nullish(),
     webpackCircularDependencyPlugin: z.boolean().nullish(),

package/src/interceptors/InterceptorPlugin.ts

@@ -68,6 +68,7 @@ export class InterceptorPlugin {
     return generatedInterceptors
   }
 
+  /** @public */
   apply(compiler: Compiler): void {
     const logger = compiler.getInfrastructureLogger('InterceptorPlugin')
 

package/src/interceptors/Visitor.ts

@@ -47,9 +47,9 @@ import type {
   ExportNamedDeclaration,
   ExportNamespaceSpecifier,
   ExportSpecifier,
-  ExprOrSpread,
   Expression,
   ExpressionStatement,
+  ExprOrSpread,
   Fn,
   ForInStatement,
   ForOfStatement,
@@ -64,10 +64,10 @@ import type {
   ImportDefaultSpecifier,
   ImportNamespaceSpecifier,
   ImportSpecifier,
-  JSXAttrValue,
   JSXAttribute,
   JSXAttributeName,
   JSXAttributeOrSpread,
+  JSXAttrValue,
   JSXClosingElement,
   JSXClosingFragment,
   JSXElement,
@@ -187,6 +187,7 @@ import type {
 
 /**
  * @deprecated JavaScript API is deprecated. Please use Wasm plugin instead.
+ * @public
  */
 export class Visitor {
   visitProgram(n: Program): Program {
@@ -1839,5 +1840,3 @@ export class Visitor {
     return n
   }
 }
-
-export default Visitor

package/src/interceptors/extractExports.ts

@@ -18,8 +18,6 @@ import type {
   TemplateLiteral,
 } from '@swc/core'
 
-export class NoSuchDeclarationError extends Error {}
-
 function isIdentifier(node: Node): node is Identifier {
   return node.type === 'Identifier'
 }
@@ -60,35 +58,7 @@ function isTemplateLiteral(node: Node): node is TemplateLiteral {
   return node.type === 'TemplateLiteral'
 }
 
-export class UnsupportedValueError extends Error {
-  /** @example `config.runtime[0].value` */
-  path?: string
-
-  constructor(message: string, paths?: string[]) {
-    super(message)
-
-    // Generating "path" that looks like "config.runtime[0].value"
-    let codePath: string | undefined
-    if (Array.isArray(paths)) {
-      codePath = ''
-      for (const path of paths) {
-        if (path[0] === '[') {
-          // "array" + "[0]"
-          codePath += path
-        } else if (codePath === '') {
-          codePath = path
-        } else {
-          // "object" + ".key"
-          codePath += `.${path}`
-        }
-      }
-    }
-
-    this.path = codePath
-  }
-}
-
-export const RUNTIME_VALUE = Symbol('RUNTIME_VALUE')
+const RUNTIME_VALUE = Symbol('RUNTIME_VALUE')
 
 function extractValue(node: Node, path?: string[], optional: boolean = false): any {
   if (isNullLiteral(node)) {
@@ -116,7 +86,6 @@ function extractValue(node: Node, path?: string[], optional: boolean = false): a
         return undefined
       default:
         return RUNTIME_VALUE
-      // throw new UnsupportedValueError(`Unknown identifier "${node.value}"`, path)
     }
   } else if (isArrayExpression(node)) {
     // e.g. [1, 2, 3]
@@ -127,10 +96,6 @@ function extractValue(node: Node, path?: string[], optional: boolean = false): a
         if (elem.spread) {
           // e.g. [ ...a ]
           return RUNTIME_VALUE
-          // throw new UnsupportedValueError(
-          //   'Unsupported spread operator in the Array Expression',
-          //   path,
-          // )
         }
 
         arr.push(extractValue(elem.expression, path && [...path, `[${i}]`], optional))
@@ -148,10 +113,6 @@ function extractValue(node: Node, path?: string[], optional: boolean = false): a
       if (!isKeyValueProperty(prop)) {
         // e.g. { ...a }
         return RUNTIME_VALUE
-        // throw new UnsupportedValueError(
-        //   'Unsupported spread operator in the Object Expression',
-        //   path,
-        // )
       }
 
       let key
@@ -163,10 +124,6 @@ function extractValue(node: Node, path?: string[], optional: boolean = false): a
         key = prop.key.value
       } else {
         return RUNTIME_VALUE
-        // throw new UnsupportedValueError(
-        //   `Unsupported key type "${prop.key.type}" in the Object Expression`,
-        //   path,
-        // )
       }
 
       obj[key] = extractValue(prop.value, path && [...path, key])
@@ -178,7 +135,6 @@ function extractValue(node: Node, path?: string[], optional: boolean = false): a
     if (node.expressions.length !== 0) {
       // TODO: should we add support for `${'e'}d${'g'}'e'`?
       return RUNTIME_VALUE
-      // throw new UnsupportedValueError('Unsupported template literal with expressions', path)
     }
 
     // When TemplateLiteral has 0 expressions, the length of quasis is always 1.
@@ -195,7 +151,6 @@ function extractValue(node: Node, path?: string[], optional: boolean = false): a
     return cooked ?? raw
   } else {
     return RUNTIME_VALUE
-    // throw new UnsupportedValueError(`Unsupported node type "${node.type}"`, path)
   }
 }
 

package/src/interceptors/generateInterceptor.ts

@@ -18,6 +18,7 @@ type PluginBaseConfig = {
   ifConfig?: string | [string, any]
 }
 
+/** @public */
 export function isPluginBaseConfig(plugin: Partial<PluginBaseConfig>): plugin is PluginBaseConfig {
   return (
     typeof plugin.type === 'string' &&
@@ -31,6 +32,7 @@ type ReactPluginConfig = PluginBaseConfig & { type: 'component' }
 type MethodPluginConfig = PluginBaseConfig & { type: 'function' }
 type ReplacePluginConfig = PluginBaseConfig & { type: 'replace' }
 
+/** @public */
 export function isReactPluginConfig(
   plugin: Partial<PluginBaseConfig>,
 ): plugin is ReactPluginConfig {
@@ -38,6 +40,7 @@ export function isReactPluginConfig(
   return plugin.type === 'component'
 }
 
+/** @public */
 export function isMethodPluginConfig(
   plugin: Partial<PluginBaseConfig>,
 ): plugin is MethodPluginConfig {
@@ -45,6 +48,7 @@ export function isMethodPluginConfig(
   return plugin.type === 'function'
 }
 
+/** @public */
 export function isReplacePluginConfig(
   plugin: Partial<PluginBaseConfig>,
 ): plugin is ReactPluginConfig {

package/src/utils/TopologicalSort.ts

@@ -23,14 +23,17 @@ export class TopologicalSort<KeyType, ValueType> {
     this.addMultipleInternalNodes(nodes)
   }
 
+  /** @public */
   addNode(key: KeyType, node: ValueType) {
     return this.addInternalNode(key, node)
   }
 
+  /** @public */
   addNodes(nodes: Map<KeyType, ValueType>) {
     this.addMultipleInternalNodes(nodes)
   }
 
+  /** @public */
   addEdge(fromKey: KeyType, toKey: KeyType) {
     assert(this.#nodes.has(fromKey), `Source package with ${fromKey} key should exist`)
     assert(this.#nodes.has(toKey), `Target package with ${toKey} key should exist`)
@@ -58,6 +61,7 @@ export class TopologicalSort<KeyType, ValueType> {
     sourceNode!.children.set(toKey, targetNode!)
   }
 
+  /** @public */
   sort(): Map<KeyType, INodeWithChildren<KeyType, ValueType>> {
     this.#visitedNodes = new Set()
     this.#sortedKeysStack = []