tsdown.config.base.ts

import type { UserConfig, OutExtensionContext } from 'tsdown';

// Turbo task execution triggers a tsdown ATTW tarball path bug for scoped packages.
// Keep ATTW for direct package builds, but disable it for workspace builds.
const isTurboTask = Boolean(process.env.TURBO_HASH);

/**
 * tsdown config with shared defaults.
 * Package-specific options (e.g., entry, outDir, outExtensions) can be overridden by the caller.
 * Paths are relative to the closest `tsdown.config.ts` file that imports this config.
 */
export const baseConfig = {
  /**
   * Entry points for the build.
   */
  entry: ['src/index.ts'],

  /**
   * Output directory for the build.
   */
  outDir: 'dist',
  outExtensions: (ctx) => ({
    js: isESM(ctx)
      ? '.mjs'
      : '.cjs',
    dts: isESM(ctx)
      ? '.d.mts'
      : '.d.cts',
  }),

  /**
   * Configures the output formats for the build.
   * - 'esm' generates ESM (ECMAScript Module) output
   * - 'cjs' generates lecayse CommonJS output
   */
  format: ['esm', 'cjs' /* legacy */],

  /**
   * Generates TypeScript declaration files (.d.mts, .d.ts)
   */
  dts: true,

  /**
   * Clean `outDir` before each build.
   */
  clean: true,

  /**
   * Compress code to reduce bundle size.
   */
  minify: false,

  /**
   * Target ECMAScript version for the output.
   */
  target: 'es2022',

  /**
   * Callback function to execute after a successful build.
   */
  onSuccess() {
    console.info('🙏 Build succeeded!');
  },

  /**
   * External dependencies that should not be bundled, but provided by the consumer.
   */
  external: ['zod', '@composio/core', /^node:/],

  /**
   * Control how Node.js built-in module imports are handled.
   * When true, imports like `fs` are transformed to `node:fs`.
   */
  nodeProtocol: true,

  /**
   * Configuration for @arethetypeswrong/cli.
   * Uses '.' entrypoint to check the package root via the exports field,
   * since src/index.ts is only used during development and not exported.
   * Uses 'node16' profile since packages support both ESM and CJS.
   */
  attw: {
    entrypoints: ['.'],
    enabled: !isTurboTask,
    level: 'error',
    profile: 'node16',
    ignoreRules: [/* Node.js 10 only, attw doesn't automatically exclude it despite the selected profile */ 'internal-resolution-error'],
  },

  /**
   * Configuration for publint.
   */
  publint: {
    enabled: true,
    level: 'error',
    pack: 'pnpm',
  },
} satisfies UserConfig

function isESM(ctx: OutExtensionContext) {
  return ctx.format === 'es'
}