Function lintIntegrationsFile

packages/cli/src/commands/lint.ts:250–306

* Lint an integrations env yaml file directly (without a .deepnote notebook). * Validates the file structure, integration schemas, and env var references.

(filePath: string)

 * Validates the file structure, integration schemas, and env var references.
 */
async function lintIntegrationsFile(filePath: string): Promise<LintFileResult> {
  const absolutePath = resolve(process.cwd(), filePath)

  // Verify the file exists
  try {
    await fs.stat(absolutePath)
  } catch (error) {
    if (isErrnoENOENT(error)) {
      throw new FileResolutionError(`File not found: ${absolutePath}`)
    }
    throw error
  }

  const fileDir = dirname(absolutePath)

  // Loading `.env` mutates `process.env`; restore it afterwards so a lint run is idempotent and
  // doesn't clobber caller-provided env values (see withRestoredEnv).
  return withRestoredEnv(async () => {
    // Load .env file so env: references in integrations can be resolved
    dotenv.config({ path: join(fileDir, DEFAULT_ENV_FILE), quiet: true })

    debug(`Linting integrations file: ${absolutePath}`)
    const parsedIntegrations = await parseIntegrationsFile(absolutePath)

    debug(`Parsed ${parsedIntegrations.integrations.length} integrations, ${parsedIntegrations.issues.length} issues`)

    // Also run env var generation so schema-valid-but-impossible to generate integrations (e.g. invalid
    // BigQuery/Spanner service_account JSON) are caught here too, not just on the .deepnote path.
    const integrationsIssues = [...parsedIntegrations.issues]
    if (parsedIntegrations.integrations.length > 0) {
      const { issues } = generateIntegrationEnvVars(parsedIntegrations.integrations, fileDir)
      integrationsIssues.push(...issues)
    }

    const hasErrors = integrationsIssues.length > 0

    // Integration/config issues are hard errors (no severity field), so report them as errors in
    // `issueCount` (there are no notebook issues on this path) to keep it consistent with `success`
    // and `integrationsFile.issues`.
    return {
      path: absolutePath,
      success: !hasErrors,
      issueCount: { errors: integrationsIssues.length, warnings: 0, total: integrationsIssues.length },
      issues: [],
      // Emit empty integrations/inputs so the JSON shape matches the .deepnote path. There is no
      // notebook on this path, so both are always empty — but keeping the keys present saves machine
      // consumers from having to special-case the direct-YAML output.
      integrations: { configured: [], missing: [] },
      inputs: { total: 0, withValues: 0, needingValues: [] },
      integrationsFile: {
        path: absolutePath,
        integrationCount: parsedIntegrations.integrations.length,
        issues: integrationsIssues,
      },
    }
  })
}