refactor(audience): trim redundant comments on CDN bundle files

- Drops narrative module headers from cdn.ts, cdn.test.ts, tsup.cdn.js.
- Keeps one-line WHY comments only, matching tsup.config.js and pixel/tsup.config.ts density.

Refs SDK-115

Author: ImmutableJeffrey

packages/audience/sdk/src/cdn.test.ts

@@ -1,12 +1,3 @@
-/**
- * Smoke test for the CDN entry point. Verifies that importing `./cdn`
- * attaches { Audience, AudienceError, IdentityType, version } to
- * window.ImmutableAudience.
- *
- * This tests the contract of cdn.ts — not the tsup build output. The bundle
- * itself is exercised by running `pnpm build` and loading the built file in
- * a browser.
- */
 import type { ImmutableAudienceGlobal } from './cdn';
 
 describe('cdn entry point', () => {
@@ -33,7 +24,6 @@ describe('cdn entry point', () => {
     expect(typeof g!.version).toBe('string');
     expect(g!.version.length).toBeGreaterThan(0);
 
-    // AudienceError should be constructable and extend Error
     const err = new g!.AudienceError({
       code: 'NETWORK_ERROR',
       message: 'test',

packages/audience/sdk/src/cdn.ts

@@ -1,46 +1,23 @@
-/**
- * CDN bundle entry point.
- *
- * Side-effect module: importing this file attaches Audience, AudienceError,
- * and IdentityType to `window.ImmutableAudience` so the SDK can be consumed
- * via a <script> tag.
- *
- * DO NOT import this from application code — use `import { Audience } from
- * '@imtbl/audience'` instead. This file exists solely as the entry point
- * for the CDN build (packages/audience/sdk/tsup.cdn.js).
- */
-
 import { AudienceError, IdentityType } from '@imtbl/audience-core';
 
 import { Audience } from './sdk';
 import { LIBRARY_VERSION } from './config';
 
-/**
- * The shape of `window.ImmutableAudience` attached by the CDN bundle.
- * Type-only export — importing this module otherwise has runtime side effects,
- * which is why the file's `DO NOT import this` warning above only applies to
- * value imports. The CDN smoke test imports this type to keep its assertions
- * in lockstep with the real surface, eliminating the need for a duplicate
- * definition.
- */
 export type ImmutableAudienceGlobal = {
   Audience: typeof Audience;
   AudienceError: typeof AudienceError;
   IdentityType: typeof IdentityType;
   version: string;
 };
 
-// globalThis is ES2020; tsup targets es2018, so provide a runtime fallback
-// to `window` for browsers that predate globalThis (Safari < 12.1).
+// Fallback for es2018 targets that predate globalThis (Safari < 12.1).
 const globalObj = (
   typeof globalThis !== 'undefined' ? globalThis : window
 ) as unknown as { ImmutableAudience?: ImmutableAudienceGlobal };
 
 if (globalObj.ImmutableAudience) {
   // eslint-disable-next-line no-console
-  console.warn(
-    '[@imtbl/audience] CDN bundle loaded twice; keeping the first instance.',
-  );
+  console.warn('[@imtbl/audience] CDN bundle loaded twice; keeping the first instance.');
 } else {
   globalObj.ImmutableAudience = {
     Audience,

packages/audience/sdk/tsup.cdn.js

@@ -3,32 +3,8 @@ import { defineConfig } from 'tsup';
 import { replace } from 'esbuild-plugin-replace';
 import pkg from './package.json' with { type: 'json' };
 
-/**
- * CDN bundle config for @imtbl/audience.
- *
- * Produces a single-file IIFE at dist/cdn/imtbl-audience.global.js that
- * studios load via <script>. Bundles audience-core directly (no runtime
- * dependency resolution), attaches globals via the src/cdn.ts side-effect
- * entry point, and minifies for size.
- *
- * Runs alongside the main ESM build configured in tsup.config.js — they
- * share the dist/ directory so `clean: false` is required to avoid wiping
- * the ESM output. The package.json build script runs transpile (ESM/CJS)
- * first, then transpile:cdn, then typegen, so the order-dependent dist/
- * state is well-defined.
- *
- * The esbuild replace plugin substitutes '__SDK_VERSION__' with the
- * actual package version at build time. Both @imtbl/audience and
- * @imtbl/audience-core use '__SDK_VERSION__' as a placeholder in their
- * source (config.ts / context.ts) so the real version gets stamped
- * into context.libraryVersion on every message. Without this replacement
- * the CDN bundle ships the literal placeholder and the backend 400s.
- *
- * Local dev builds have pkg.version === '0.0.0' because the real version
- * is only written by `pnpm nx release version` in the publish workflow.
- * We substitute '0.0.0-local' in that case so a hand-carried local build
- * shows up as obviously non-production in context.libraryVersion logs.
- */
+// IIFE bundle of @imtbl/audience for <script>-tag loading. Runs after the
+// ESM/CJS build in tsup.config.js — `clean: false` preserves that output.
 export default defineConfig({
   entry: { 'imtbl-audience': 'src/cdn.ts' },
   format: ['iife'],
@@ -40,14 +16,9 @@ export default defineConfig({
   target: 'es2018',
   platform: 'browser',
   dts: false,
-  // IIFE has no runtime module resolution, so every dep (including third-party
-  // npm deps) must be inlined. Can't reuse BUNDLED_WORKSPACE_DEPS from the sibling
-  // tsup.config.js — that list is workspace-only and would leave third-party deps
-  // as externals, breaking the <script>-tag use case.
+  // IIFE has no runtime module resolution — inline everything, including npm deps.
   noExternal: [/.*/],
   esbuildPlugins: [
-    replace({
-      __SDK_VERSION__: pkg.version === '0.0.0' ? '0.0.0-local' : pkg.version,
-    }),
+    replace({ __SDK_VERSION__: pkg.version === '0.0.0' ? '0.0.0-local' : pkg.version }),
   ],
 });