netlify-cli 10.15.0 → 10.17.1

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "netlify-cli",
   "description": "Netlify command line tool",
-  "version": "10.15.0",
+  "version": "10.17.1",
   "author": "Netlify Inc.",
   "contributors": [
+    "@whitep4nth3r (https://twitter.com/whitep4nth3r)",
     "Abraham Schilling <AbrahamSchilling@gmail.com> (https://gitlab.com/n4bb12)",
     "Alberto De Agostini (https://twitter.com/albertodeago88)",
     "Alejandro Ñáñez Ortiz <git@alejandro.dev> (https://twitter.com/alejandronanez)",
@@ -222,11 +223,11 @@
   "dependencies": {
     "@netlify/build": "^27.8.1",
     "@netlify/config": "^18.1.2",
-    "@netlify/edge-bundler": "^1.8.0",
-    "@netlify/framework-info": "^9.1.1",
+    "@netlify/edge-bundler": "^1.12.1",
+    "@netlify/framework-info": "^9.2.0",
     "@netlify/local-functions-proxy": "^1.1.1",
-    "@netlify/plugins-list": "^6.36.0",
-    "@netlify/zip-it-and-ship-it": "^5.13.3",
+    "@netlify/plugins-list": "^6.38.0",
+    "@netlify/zip-it-and-ship-it": "^5.13.4",
     "@octokit/rest": "^18.0.0",
     "@sindresorhus/slugify": "^1.1.0",
     "ansi-escapes": "^5.0.0",
@@ -291,7 +292,7 @@
     "multiparty": "^4.2.1",
     "netlify": "^12.0.0",
     "netlify-headers-parser": "^6.0.2",
-    "netlify-onegraph-internal": "0.4.2",
+    "netlify-onegraph-internal": "0.8.4",
     "netlify-redirect-parser": "^13.0.5",
     "netlify-redirector": "^0.2.1",
     "node-fetch": "^2.6.0",

package/src/commands/dev/dev.js

@@ -38,6 +38,7 @@ const {
   error,
   exit,
   generateNetlifyGraphJWT,
+  getEnvelopeEnv,
   getSiteInformation,
   getToken,
   injectEnvVariables,
@@ -233,6 +234,7 @@ const FRAMEWORK_PORT_TIMEOUT = 6e5
  * @param {object} params
  * @param {*} params.addonsUrls
  * @param {import('../base-command').NetlifyOptions["config"]} params.config
+ * @param {import('../base-command').NetlifyOptions["cachedConfig"]['env']} params.env
  * @param {InspectSettings} params.inspectSettings
  * @param {() => Promise<object>} params.getUpdatedConfig
  * @param {string} params.geolocationMode
@@ -247,6 +249,7 @@ const FRAMEWORK_PORT_TIMEOUT = 6e5
 const startProxyServer = async ({
   addonsUrls,
   config,
+  env,
   geoCountry,
   geolocationMode,
   getUpdatedConfig,
@@ -261,6 +264,7 @@ const startProxyServer = async ({
     addonsUrls,
     config,
     configPath: site.configPath,
+    env,
     geolocationMode,
     geoCountry,
     getUpdatedConfig,
@@ -425,7 +429,12 @@ const dev = async (options, command) => {
     ...options,
   }
 
-  await injectEnvVariables({ devConfig, env: command.netlify.cachedConfig.env, site })
+  let { env } = command.netlify.cachedConfig
+  if (siteInfo.use_envelope) {
+    env = await getEnvelopeEnv({ api, context: options.context, env, siteInfo })
+  }
+
+  await injectEnvVariables({ devConfig, env, site })
   await promptEditorHelper({ chalk, config, log, NETLIFYDEVLOG, repositoryRoot, state })
 
   const { addonsUrls, capabilities, siteUrl, timeouts } = await getSiteInformation({
@@ -479,6 +488,7 @@ const dev = async (options, command) => {
   let url = await startProxyServer({
     addonsUrls,
     config,
+    env: command.netlify.cachedConfig.env,
     geolocationMode: options.geo,
     geoCountry: options.country,
     getUpdatedConfig,
@@ -514,6 +524,9 @@ const dev = async (options, command) => {
 
     let stopWatchingCLISessions
 
+    let liveConfig = { ...config }
+    let isRestartingSession = false
+
     const createOrResumeSession = async function () {
       const netlifyGraphConfig = await getNetlifyGraphConfig({ command, options, settings })
 
@@ -524,6 +537,7 @@ const dev = async (options, command) => {
       }
 
       stopWatchingCLISessions = await startOneGraphCLISession({
+        config: liveConfig,
         netlifyGraphConfig,
         netlifyToken,
         site,
@@ -535,6 +549,7 @@ const dev = async (options, command) => {
       const oneGraphSessionId = loadCLISession(state)
 
       await persistNewOperationsDocForSession({
+        config: liveConfig,
         netlifyGraphConfig,
         netlifyToken,
         oneGraphSessionId,
@@ -570,10 +585,16 @@ const dev = async (options, command) => {
     }
 
     // Set up a handler for config changes.
-    configWatcher.on('change', (newConfig) => {
+    configWatcher.on('change', async (newConfig) => {
       command.netlify.config = newConfig
-      stopWatchingCLISessions()
-      createOrResumeSession()
+      liveConfig = newConfig
+      if (isRestartingSession) {
+        return
+      }
+      stopWatchingCLISessions && stopWatchingCLISessions()
+      isRestartingSession = true
+      await createOrResumeSession()
+      isRestartingSession = false
     })
 
     const oneGraphSessionId = await createOrResumeSession()
@@ -606,6 +627,11 @@ const createDevCommand = (program) => {
       `Local dev server\nThe dev command will run a local dev server with Netlify's proxy and redirect rules`,
     )
     .option('-c ,--command <command>', 'command to run')
+    .addOption(
+      new Option('--context <context>', 'Specify a deploy context for environment variables')
+        .choices(['production', 'deploy-preview', 'branch-deploy', 'dev'])
+        .default('dev'),
+    )
     .option('-p ,--port <port>', 'port of netlify dev', (value) => Number.parseInt(value))
     .option('--targetPort <port>', 'port of target app server', (value) => Number.parseInt(value))
     .option('--framework <name>', 'framework to use. Defaults to #auto which automatically detects a framework')
@@ -655,6 +681,7 @@ const createDevCommand = (program) => {
       'netlify dev',
       'netlify dev -d public',
       'netlify dev -c "hugo server -w" --targetPort 1313',
+      'netlify dev --context production',
       'netlify dev --graph',
       'netlify dev --edgeInspect',
       'netlify dev --edgeInspect=127.0.0.1:9229',

package/src/commands/env/env-get.js

@@ -1,5 +1,7 @@
 // @ts-check
-const { log, logJson } = require('../../utils')
+const { Option } = require('commander')
+
+const { chalk, error, getEnvelopeEnv, log, logJson } = require('../../utils')
 
 /**
  * The env:get command
@@ -8,6 +10,7 @@ const { log, logJson } = require('../../utils')
  * @param {import('../base-command').BaseCommand} command
  */
 const envGet = async (name, options, command) => {
+  const { context, scope } = options
   const { api, cachedConfig, site } = command.netlify
   const siteId = site.id
 
@@ -16,9 +19,21 @@ const envGet = async (name, options, command) => {
     return false
   }
 
-  const siteData = await api.getSite({ siteId })
+  const { siteInfo } = cachedConfig
+  let { env } = cachedConfig
+
+  if (siteInfo.use_envelope) {
+    env = await getEnvelopeEnv({ api, context, env, key: name, scope, siteInfo })
+  } else if (context !== 'dev' || scope !== 'any') {
+    error(
+      `To specify a context or scope, please run ${chalk.yellowBright(
+        'netlify open:admin',
+      )} to open the Netlify UI and opt in to the new environment variables experience from Site settings`,
+    )
+    return false
+  }
 
-  const { value } = cachedConfig.env[name] || {}
+  const { value } = env[name] || {}
 
   // Return json response for piping commands
   if (options.json) {
@@ -27,7 +42,9 @@ const envGet = async (name, options, command) => {
   }
 
   if (!value) {
-    log(`Environment variable ${name} not set for site ${siteData.name}`)
+    const withContext = `in the ${chalk.magentaBright(context)} context`
+    const withScope = scope === 'any' ? '' : ` in the ${chalk.magentaBright(context)} scope`
+    log(`No value set ${withContext}${withScope} for environment variable ${chalk.yellowBright(name)}`)
     return false
   }
 
@@ -43,6 +60,16 @@ const createEnvGetCommand = (program) =>
   program
     .command('env:get')
     .argument('<name>', 'Environment variable name')
+    .addOption(
+      new Option('-c, --context <context>', 'Specify a deploy context')
+        .choices(['production', 'deploy-preview', 'branch-deploy', 'dev'])
+        .default('dev'),
+    )
+    .addOption(
+      new Option('-s, --scope <scope>', 'Specify a scope')
+        .choices(['builds', 'functions', 'post_processing', 'runtime', 'any'])
+        .default('any'),
+    )
     .description('Get resolved value of specified environment variable (includes netlify.toml)')
     .action(async (name, options, command) => {
       await envGet(name, options, command)

package/src/commands/env/env-list.js

@@ -1,20 +1,33 @@
 // @ts-check
 const AsciiTable = require('ascii-table')
 const { isCI } = require('ci-info')
+const { Option } = require('commander')
 const inquirer = require('inquirer')
 const isEmpty = require('lodash/isEmpty')
 
-const { chalk, log, logJson } = require('../../utils')
+const { chalk, error, getEnvelopeEnv, getHumanReadableScopes, log, logJson } = require('../../utils')
 
 const [logUpdatePromise, ansiEscapesPromise] = [import('log-update'), import('ansi-escapes')]
 
 const MASK_LENGTH = 50
 const MASK = '*'.repeat(MASK_LENGTH)
 
-const getTable = ({ environment, hideValues }) => {
+const getTable = ({ environment, hideValues, scopesColumn }) => {
   const table = new AsciiTable(`Environment variables`)
-  table.setHeading('Key', 'Value')
-  table.addRowMatrix(Object.entries(environment).map(([key, value]) => [key, hideValues ? MASK : value]))
+  const headings = ['Key', 'Value', scopesColumn && 'Scope'].filter(Boolean)
+  table.setHeading(...headings)
+  table.addRowMatrix(
+    Object.entries(environment).map(([key, variable]) =>
+      [
+        // Key
+        key,
+        // Value
+        hideValues ? MASK : variable.value,
+        // Scope
+        scopesColumn && getHumanReadableScopes(variable.scopes),
+      ].filter(Boolean),
+    ),
+  )
   return table.toString()
 }
 
@@ -25,6 +38,7 @@ const getTable = ({ environment, hideValues }) => {
  * @returns {Promise<boolean>}
  */
 const envList = async (options, command) => {
+  const { context, scope } = options
   const { api, cachedConfig, site } = command.netlify
   const siteId = site.id
 
@@ -33,36 +47,55 @@ const envList = async (options, command) => {
     return false
   }
 
-  const siteData = await api.getSite({ siteId })
-  const environment = Object.fromEntries(
-    Object.entries(cachedConfig.env)
-      // Omitting general variables to reduce noise.
-      .filter(([, variable]) => variable.sources[0] !== 'general')
-      .map(([key, variable]) => [key, variable.value]),
+  const { env, siteInfo } = cachedConfig
+  const isUsingEnvelope = siteInfo.use_envelope
+  let environment = env
+
+  if (isUsingEnvelope) {
+    environment = await getEnvelopeEnv({ api, context, env, scope, siteInfo })
+  } else if (context !== 'dev' || scope !== 'any') {
+    error(
+      `To specify a context or scope, please run ${chalk.yellowBright(
+        'netlify open:admin',
+      )} to open the Netlify UI and opt in to the new environment variables experience from Site settings`,
+    )
+    return false
+  }
+
+  // filter out general sources
+  environment = Object.fromEntries(
+    Object.entries(environment).filter(([, variable]) => variable.sources[0] !== 'general'),
   )
 
   // Return json response for piping commands
   if (options.json) {
-    logJson(environment)
+    const envDictionary = Object.fromEntries(
+      Object.entries(environment).map(([key, variable]) => [key, variable.value]),
+    )
+    logJson(envDictionary)
     return false
   }
 
+  const forSite = `for site ${chalk.greenBright(siteInfo.name)}`
+  const withContext = isUsingEnvelope ? `in the ${chalk.magentaBright(options.context)} context` : ''
+  const withScope = isUsingEnvelope && scope !== 'any' ? `and ${chalk.yellowBright(options.scope)} scope` : ''
   if (isEmpty(environment)) {
-    log(`No environment variables set for site ${chalk.greenBright(siteData.name)}`)
+    log(`No environment variables set ${forSite} ${withContext} ${withScope}`)
     return false
   }
 
   // List environment in a table
-  log(`Listing environment variables for site: ${chalk.greenBright(siteData.name)}`)
+  const count = Object.keys(environment).length
+  log(`${count} environment variable${count === 1 ? '' : 's'} ${forSite} ${withContext} ${withScope}`)
 
   if (isCI) {
-    log(getTable({ environment, hideValues: false }))
+    log(getTable({ environment, hideValues: false, scopesColumn: isUsingEnvelope }))
     return false
   }
 
   const { default: logUpdate } = await logUpdatePromise
 
-  logUpdate(getTable({ environment, hideValues: true }))
+  logUpdate(getTable({ environment, hideValues: true, scopesColumn: isUsingEnvelope }))
   const { showValues } = await inquirer.prompt([
     {
       type: 'confirm',
@@ -76,7 +109,7 @@ const envList = async (options, command) => {
     const { default: ansiEscapes } = await ansiEscapesPromise
     // since inquirer adds a prompt, we need to account for it when printing the table again
     log(ansiEscapes.eraseLines(3))
-    logUpdate(getTable({ environment, hideValues: false }))
+    logUpdate(getTable({ environment, hideValues: false, scopesColumn: isUsingEnvelope }))
     log(`${chalk.cyan('?')} Show values? ${chalk.cyan('Yes')}`)
   }
 }
@@ -89,6 +122,16 @@ const envList = async (options, command) => {
 const createEnvListCommand = (program) =>
   program
     .command('env:list')
+    .addOption(
+      new Option('-c, --context <context>', 'Specify a deploy context')
+        .choices(['production', 'deploy-preview', 'branch-deploy', 'dev'])
+        .default('dev'),
+    )
+    .addOption(
+      new Option('-s, --scope <scope>', 'Specify a scope')
+        .choices(['builds', 'functions', 'post_processing', 'runtime', 'any'])
+        .default('any'),
+    )
     .description('Lists resolved environment variables for site (includes netlify.toml)')
     .action(async (options, command) => {
       await envList(options, command)

package/src/commands/graph/graph-edit.js

@@ -21,7 +21,7 @@ const { ensureAppForSite, executeCreatePersistedQueryMutation } = OneGraphCliCli
  * @returns
  */
 const graphEdit = async (options, command) => {
-  const { site, state } = command.netlify
+  const { config, site, state } = command.netlify
   const siteId = site.id
 
   if (!site.id) {
@@ -44,6 +44,7 @@ const graphEdit = async (options, command) => {
   await ensureAppForSite(netlifyToken, siteId)
 
   const oneGraphSessionId = await ensureCLISession({
+    config,
     metadata: {},
     netlifyToken,
     site,
@@ -77,7 +78,7 @@ const graphEdit = async (options, command) => {
 
   const { jwt } = await OneGraphClient.getGraphJwtForSite({ siteId, nfToken: netlifyToken })
   await upsertMergeCLISessionMetadata({
-    netlifyGraphConfig,
+    config,
     jwt,
     siteId,
     siteRoot: site.root,

package/src/commands/graph/graph-handler.js

@@ -1,29 +1,27 @@
+/* eslint-disable eslint-comments/disable-enable-pair */
 // @ts-check
-const inquirer = require('inquirer')
-const { GraphQL } = require('netlify-onegraph-internal')
 
 const {
+  autocompleteCodegenModules,
+  autocompleteOperationNames,
   buildSchema,
-  defaultExampleOperationsDoc,
-  extractFunctionsFromOperationDoc,
   generateHandlerByOperationName,
+  getCodegenFunctionById,
+  getCodegenModule,
   getNetlifyGraphConfig,
-  readGraphQLOperationsSourceFile,
   readGraphQLSchemaFile,
 } = require('../../lib/one-graph/cli-netlify-graph')
 const { error, log } = require('../../utils')
 
-const { parse } = GraphQL
-
 /**
  * Creates the `netlify graph:handler` command
- * @param {string} userOperationName
  * @param {import('commander').OptionValues} options
  * @param {import('../base-command').BaseCommand} command
  * @returns
  */
-const graphHandler = async (userOperationName, options, command) => {
+const graphHandler = async (args, options, command) => {
   const netlifyGraphConfig = await getNetlifyGraphConfig({ command, options })
+  const { config } = command.netlify
 
   const schemaString = readGraphQLSchemaFile(netlifyGraphConfig)
 
@@ -35,69 +33,48 @@ const graphHandler = async (userOperationName, options, command) => {
     error(`Error parsing schema: ${buildSchemaError}`)
   }
 
-  if (!schema) {
-    error(`Failed to parse Netlify GraphQL schema`)
-  }
+  const userOperationName = args.operationName
+  const userCodegenId = options.codegen
 
   let operationName = userOperationName
   if (!operationName) {
-    try {
-      let currentOperationsDoc = readGraphQLOperationsSourceFile(netlifyGraphConfig)
-      if (currentOperationsDoc.trim().length === 0) {
-        currentOperationsDoc = defaultExampleOperationsDoc
-      }
-
-      const parsedDoc = parse(currentOperationsDoc)
-      const { functions } = extractFunctionsFromOperationDoc(parsedDoc)
-
-      const sorted = Object.values(functions).sort((aItem, bItem) =>
-        aItem.operationName.localeCompare(bItem.operationName),
-      )
-
-      const perPage = 50
-
-      const allOperationChoices = sorted.map((operation) => ({
-        name: `${operation.operationName} (${operation.kind})`,
-        value: operation.operationName,
-      }))
-
-      const filterOperationNames = (operationChoices, input) =>
-        operationChoices.filter((operation) => operation.value.toLowerCase().match(input.toLowerCase()))
-
-      // eslint-disable-next-line n/global-require
-      const inquirerAutocompletePrompt = require('inquirer-autocomplete-prompt')
-      /** multiple matching detectors, make the user choose */
-      inquirer.registerPrompt('autocomplete', inquirerAutocompletePrompt)
+    operationName = await autocompleteOperationNames({ netlifyGraphConfig })
+  }
 
-      const { selectedOperationName } = await inquirer.prompt({
-        name: 'selectedOperationName',
-        message: `For which operation would you like to generate a handler?`,
-        type: 'autocomplete',
-        pageSize: perPage,
-        source(_, input) {
-          if (!input || input === '') {
-            return allOperationChoices
-          }
+  if (!operationName) {
+    error(`No operation name provided`)
+  }
 
-          const filteredChoices = filterOperationNames(allOperationChoices, input)
-          // only show filtered results
-          return filteredChoices
-        },
-      })
+  const codegenModule = await getCodegenModule({ config })
+  if (!codegenModule) {
+    error(
+      `No Netlify Graph codegen module specified in netlify.toml under the [graph] header. Please specify 'codeGenerator' field and try again.`,
+    )
+    return
+  }
 
-      if (selectedOperationName) {
-        operationName = selectedOperationName
-      }
-    } catch (parseError) {
-      parseError(`Error parsing operations library: ${parseError}`)
-    }
+  let codeGenerator = userCodegenId ? await getCodegenFunctionById({ config, id: userCodegenId }) : null
+  if (!codeGenerator) {
+    codeGenerator = await autocompleteCodegenModules({ config })
   }
 
-  if (!operationName) {
-    error(`No operation name provided`)
+  if (!codeGenerator) {
+    error(`Unable to select appropriate Netlify Graph code generator`)
+    return
   }
 
-  generateHandlerByOperationName({ logger: log, netlifyGraphConfig, schema, operationName, handlerOptions: {} })
+  if (schema) {
+    generateHandlerByOperationName({
+      generate: codeGenerator.generateHandler,
+      logger: log,
+      netlifyGraphConfig,
+      schema,
+      operationName,
+      handlerOptions: {},
+    })
+  } else {
+    error(`Failed to parse Netlify GraphQL schema`)
+  }
 }
 
 /**
@@ -109,11 +86,12 @@ const createGraphHandlerCommand = (program) =>
   program
     .command('graph:handler')
     .argument('[name]', 'Operation name')
+    .option('-c, --codegen <id>', 'The id of the specific code generator to use')
     .description(
       'Generate a handler for a Graph operation given its name. See `graph:operations` for a list of operations.',
     )
     .action(async (operationName, options, command) => {
-      await graphHandler(operationName, options, command)
+      await graphHandler({ operationName }, options, command)
     })
 
 module.exports = { createGraphHandlerCommand }

package/src/commands/graph/graph-init.js

@@ -18,7 +18,7 @@ const { ensureAppForSite, executeCreateApiTokenMutation } = OneGraphCliClient
  * @returns
  */
 const graphInit = async (options, command) => {
-  const { api, site, state } = command.netlify
+  const { api, config, site, state } = command.netlify
   const siteId = site.id
 
   if (!siteId) {
@@ -66,6 +66,7 @@ const graphInit = async (options, command) => {
 
   const netlifyGraphConfig = await getNetlifyGraphConfig({ command, options })
   await ensureCLISession({
+    config,
     metadata: {},
     netlifyToken,
     site,

package/src/commands/graph/graph-library.js

@@ -1,4 +1,6 @@
 // @ts-check
+const { GraphQL } = require('netlify-onegraph-internal')
+
 const { readLockfile } = require('../../lib/one-graph/cli-client')
 const {
   buildSchema,
@@ -19,10 +21,19 @@ const { NETLIFYDEVERR, chalk, error, log } = require('../../utils')
  * @returns
  */
 const graphLibrary = async (options, command) => {
+  const { config } = command.netlify
   const netlifyGraphConfig = await getNetlifyGraphConfig({ command, options })
 
   const schemaString = readGraphQLSchemaFile(netlifyGraphConfig)
 
+  let currentOperationsDoc = readGraphQLOperationsSourceFile(netlifyGraphConfig)
+  if (currentOperationsDoc.trim().length === 0) {
+    currentOperationsDoc = defaultExampleOperationsDoc
+  }
+
+  const parsedDoc = parse(currentOperationsDoc)
+  const { fragments, functions } = extractFunctionsFromOperationDoc(GraphQL, parsedDoc)
+
   let schema
 
   try {
@@ -33,29 +44,24 @@ const graphLibrary = async (options, command) => {
 
   if (!schema) {
     error(`Failed to parse Netlify GraphQL schema`)
+    return
   }
 
-  let currentOperationsDoc = readGraphQLOperationsSourceFile(netlifyGraphConfig)
-  if (currentOperationsDoc.trim().length === 0) {
-    currentOperationsDoc = defaultExampleOperationsDoc
-  }
-
-  const parsedDoc = parse(currentOperationsDoc)
-  const { fragments, functions } = extractFunctionsFromOperationDoc(parsedDoc)
-
   const lockfile = readLockfile({ siteRoot: command.netlify.site.root })
 
-  if (lockfile == null) {
+  if (lockfile === undefined) {
     error(
       `${NETLIFYDEVERR} Error: no lockfile found, unable to run \`netlify graph:library\`. To pull a remote schema (and create a lockfile), run ${chalk.yellow(
         'netlify graph:pull',
       )} `,
     )
+    return
   }
 
-  const schemaId = lockfile && lockfile.locked.schemaId
+  const { schemaId } = lockfile.locked
 
-  generateFunctionsFile({
+  const payload = {
+    config,
     logger: log,
     netlifyGraphConfig,
     schema,
@@ -63,7 +69,9 @@ const graphLibrary = async (options, command) => {
     operationsDoc: currentOperationsDoc,
     functions,
     fragments,
-  })
+  }
+
+  generateFunctionsFile(payload)
 }
 
 /**

package/src/commands/graph/graph-operations.js

@@ -26,13 +26,18 @@ const graphOperations = async (options, command) => {
     }
 
     const parsedDoc = parse(currentOperationsDoc)
-    const { fragments, functions } = extractFunctionsFromOperationDoc(parsedDoc)
+    const { fragments, functions } = extractFunctionsFromOperationDoc(GraphQL, parsedDoc)
 
     const sorted = {
+      /** @type {import('netlify-onegraph-internal/dist/netlifyGraph').ExtractedFunction[]} */
       queries: [],
+      /** @type {import('netlify-onegraph-internal/dist/netlifyGraph').ExtractedFunction[]} */
       mutations: [],
+      /** @type {import('netlify-onegraph-internal/dist/netlifyGraph').ExtractedFunction[]} */
       subscriptions: [],
+      /** @type {import('netlify-onegraph-internal/dist/netlifyGraph').ExtractedFragment[]} */
       fragments: [],
+      /** @type {any[]} */
       other: [],
     }