bundle-shared.cjs

#!/usr/bin/env node
// Bundles workspace packages into self-contained ESM artifacts for CF deploy.
// Mirrors prebuild:parsers-bundle. @sap/* and other CF-provided packages are
// marked external and must be available in the CF runtime environment.
// Output is ESM (.mjs) with a createRequire banner for any CJS interop.
// NOTE: the banner uses the alias `__cjsBundleRequire` instead of the bare
// `createRequire` name to avoid a SyntaxError collision with esbuild's own
// automatic `import { createRequire } from "node:module"` injection (which
// esbuild emits when a bundled CJS dep needs it and uses the bare name
// `createRequire`/`createRequire2` internally). Using a distinct alias keeps
// the two top-level import bindings separate.
//
// .cjs handling (packages/content and packages/channels):
// CJS files are loaded at runtime via createRequire(import.meta.url) + require('./x.cjs').
// esbuild's ESM bundler cannot inline these as they are CJS singletons.
// They are marked external and copied alongside the bundle to 'srv/lib/_shared/'.

const esbuild = require('esbuild');
const path = require('node:path');
const fs = require('node:fs');
const { copyIslandManifestBeside } = require('./lib/copy-island-manifest.cjs');

const outDir = 'srv/lib/_shared';
fs.mkdirSync(outDir, { recursive: true });

// srv-mcp gets its own _shared/ with core + mcp bundles only
// (no content/kg/channels needed for the 7 MCP read/write tools).
const outDirMcp = 'srv-mcp/lib/_shared';
fs.mkdirSync(outDirMcp, { recursive: true });

// 7 .cjs files from packages/content that must be copied beside the bundle.
const CONTENT_CJS = [
  'attachment-ingest.cjs',
  'attachment-mime.cjs',
  'attachment-store.cjs',
  'image-ingest.cjs',
  'image-store.cjs',
  'img-cdn-fetch.cjs',
  'img-cdn-retry.cjs',
];

// 4 .cjs files from packages/channels that must be copied beside the bundle.
const CHANNELS_CJS = [
  'normalize.cjs',
  'promote-to-shelves.cjs',
  'seed-channel-topic-map.cjs',
  'seed-collections.cjs',
];

const targets = [
  {
    entry: require.resolve('@tutorials/core'),
    out: path.join(outDir, 'core.bundle.mjs'),
  },
  {
    entry: require.resolve('@tutorials/content'),
    out: path.join(outDir, 'content.bundle.mjs'),
    // Mark the 7 .cjs files as external so esbuild doesn't try to inline them.
    // They will be copied beside the bundle below.
    extraExternal: CONTENT_CJS.map(f => `./${f}`),
  },
  {
    entry: require.resolve('@tutorials/mcp'),
    out: path.join(outDir, 'mcp.bundle.mjs'),
  },
  {
    entry: require.resolve('@tutorials/kg'),
    out: path.join(outDir, 'kg.bundle.mjs'),
  },
  {
    entry: require.resolve('@tutorials/channels'),
    out: path.join(outDir, 'channels.bundle.mjs'),
    // Mark the 4 channels .cjs files as external (CJS singletons, ship alongside).
    extraExternal: CHANNELS_CJS.map(f => `./${f}`),
  },
];

for (const t of targets) {
  esbuild.buildSync({
    entryPoints: [t.entry],
    outfile: t.out,
    bundle: true,
    platform: 'node',
    format: 'esm',
    external: [
      '@sap/*',
      '@cap-js/*',
      '@sap-ai-sdk/*',
      'node:*',
      'hdb',
      '@sap/hana-client',
      'cheerio',
      ...(t.extraExternal || []),
    ],
    banner: {
      js: "import { createRequire as __cjsBundleRequire } from 'module'; const require = __cjsBundleRequire(import.meta.url);",
    },
  });
  console.log('bundled', t.out);
}

// Copy the 7 .cjs files from packages/content beside the content bundle
// so the createRequire('./x.cjs') calls in image-source-handler /
// attachment-source-handler resolve at CF runtime.
const contentPkgDir = path.dirname(require.resolve('@tutorials/content'));
for (const cjsFile of CONTENT_CJS) {
  const src = path.join(contentPkgDir, cjsFile);
  const dst = path.join(outDir, cjsFile);
  fs.copyFileSync(src, dst);
  console.log('copied', dst);
}

// Copy the 4 .cjs files from packages/channels beside the channels bundle.
const channelsPkgDir = path.dirname(require.resolve('@tutorials/channels'));
for (const cjsFile of CHANNELS_CJS) {
  const src = path.join(channelsPkgDir, cjsFile);
  const dst = path.join(outDir, cjsFile);
  fs.copyFileSync(src, dst);
  console.log('copied', dst);
}

// srv-qa/lib/_shared/ — core + content only (srv-qa closure = content-store + secret-resolver).
const outDirQa = 'srv-qa/lib/_shared';
fs.mkdirSync(outDirQa, { recursive: true });

const qaTargets = [
  {
    entry: require.resolve('@tutorials/core'),
    out: path.join(outDirQa, 'core.bundle.mjs'),
  },
  {
    entry: require.resolve('@tutorials/content'),
    out: path.join(outDirQa, 'content.bundle.mjs'),
    extraExternal: CONTENT_CJS.map(f => `./${f}`),
  },
];

for (const t of qaTargets) {
  esbuild.buildSync({
    entryPoints: [t.entry],
    outfile: t.out,
    bundle: true,
    platform: 'node',
    format: 'esm',
    external: [
      '@sap/*',
      '@cap-js/*',
      '@sap-ai-sdk/*',
      'node:*',
      'hdb',
      '@sap/hana-client',
      'cheerio',
      ...(t.extraExternal || []),
    ],
    banner: {
      js: "import { createRequire as __cjsBundleRequire } from 'module'; const require = __cjsBundleRequire(import.meta.url);",
    },
  });
  console.log('bundled', t.out);
}

// Copy the 7 .cjs files from packages/content beside the srv-qa content bundle.
for (const cjsFile of CONTENT_CJS) {
  const src = path.join(contentPkgDir, cjsFile);
  const dst = path.join(outDirQa, cjsFile);
  fs.copyFileSync(src, dst);
  console.log('copied', dst);
}

// #2733 — the content bundle's catalog/concept/puzzle/topic SSR renderers call
// islandSrc(), which reads `island-manifest.json` relative to the bundle's own
// dir. Seed it beside EACH content bundle (srv/lib/_shared, srv-qa/lib/_shared)
// AND into packages/content/ so local `cds watch` + unit tests resolve the same
// hashed paths. Source = srv/lib/island-manifest.json, written by
// scripts/build-island-manifest.cjs (build:all). Fail-open when absent (the CI
// deploy.yml path builds islands out of band — nothing to copy there); fail
// LOUD when present-but-empty. srv-mcp has no content bundle, so it is excluded.
const ISLAND_MANIFEST_SRC = path.resolve(__dirname, '..', 'srv', 'lib', 'island-manifest.json');
copyIslandManifestBeside([outDir, outDirQa, contentPkgDir], ISLAND_MANIFEST_SRC);

// srv-mcp/lib/_shared/ — core + mcp only (7 MCP tools don't need content/kg/channels).
const mcpTargets = [
  {
    entry: require.resolve('@tutorials/core'),
    out: path.join(outDirMcp, 'core.bundle.mjs'),
  },
  {
    entry: require.resolve('@tutorials/mcp'),
    out: path.join(outDirMcp, 'mcp.bundle.mjs'),
  },
];

for (const t of mcpTargets) {
  esbuild.buildSync({
    entryPoints: [t.entry],
    outfile: t.out,
    bundle: true,
    platform: 'node',
    format: 'esm',
    external: [
      '@sap/*',
      '@cap-js/*',
      '@sap-ai-sdk/*',
      'node:*',
      'hdb',
      '@sap/hana-client',
      'cheerio',
    ],
    banner: {
      js: "import { createRequire as __cjsBundleRequire } from 'module'; const require = __cjsBundleRequire(import.meta.url);",
    },
  });
  console.log('bundled', t.out);
}