jamdesk 1.1.100 → 1.1.101

package/dist/__tests__/unit/banner-art-sync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=banner-art-sync.test.d.ts.map

package/dist/__tests__/unit/banner-art-sync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-art-sync.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/banner-art-sync.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/banner-art-sync.test.js

@@ -0,0 +1,56 @@
+/**
+ * Drift guard for the 3-place ASCII "Jamdesk" banner art.
+ *
+ * The same figlet art is emitted from three representations that cannot
+ * share a module — a raw text asset read by the npm postinstall, a bash
+ * here-string in the curl|bash bootstrap installer, and a PowerShell
+ * Write-Host block in the iwr|iex bootstrap installer:
+ *
+ *   - builder/cli/scripts/banner.txt              (npm postinstall asset)
+ *   - builder/cli/scripts/install.sh print_banner (bash, backslash/backtick-escaped)
+ *   - builder/cli/scripts/install.ps1 Write-Banner (PowerShell, backtick-escaped)
+ *
+ * Same rationale as the documented OpenAPI-patch trio (see
+ * openapi-schema-patch-sync.test.ts and builder/CLAUDE.md): comments alone
+ * don't stop drift, a test does. Edit the art in one place and forget the
+ * others and a user gets a different banner from `npm i -g` vs the curl
+ * installer.
+ *
+ * The snippets below are deliberately escaping-invariant: each contains no
+ * backslash, backtick, or quote, so it appears byte-identical in the raw
+ * asset, the bash-escaped string, and the PowerShell-escaped string. They
+ * are also interior substrings (not line-anchored), so per-line trailing
+ * whitespace and the `echo "`/`Write-Host "` prefixes don't matter — what
+ * is pinned is the art's shape, one fragment per line.
+ */
+import { describe, it, expect } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const scripts = path.join(here, '../../../scripts');
+const SITES = {
+    'npm asset (banner.txt)': path.join(scripts, 'banner.txt'),
+    'bash installer (install.sh)': path.join(scripts, 'install.sh'),
+    'powershell installer (install.ps1)': path.join(scripts, 'install.ps1'),
+};
+// One fragment per art line. No \ ` " ' so escaping in any representation
+// can't change them; internal whitespace IS the art and is preserved.
+const ART_LINES = [
+    '_                     _           _',
+    '| | __ _ _ __ ___   __| | ___  ___| | __',
+    '__| |/ /',
+    '(_| | | | | | | (_| |  __',
+    '___||___',
+];
+describe('Jamdesk banner art sync (3-place drift guard)', () => {
+    for (const [name, file] of Object.entries(SITES)) {
+        it(`${name} carries the full art`, async () => {
+            const src = await fs.readFile(file, 'utf-8');
+            for (const line of ART_LINES) {
+                expect(src, `${name} art drifted — missing line: ${line}`).toContain(line);
+            }
+        });
+    }
+});
+//# sourceMappingURL=banner-art-sync.test.js.map

package/dist/__tests__/unit/banner-art-sync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner-art-sync.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/banner-art-sync.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;AAEpD,MAAM,KAAK,GAAG;IACZ,wBAAwB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;IAC1D,6BAA6B,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/D,oCAAoC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;CACxE,CAAC;AAEF,0EAA0E;AAC1E,sEAAsE;AACtE,MAAM,SAAS,GAAG;IAChB,qCAAqC;IACrC,0CAA0C;IAC1C,UAAU;IACV,2BAA2B;IAC3B,UAAU;CACX,CAAC;AAEF,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,EAAE,CAAC,GAAG,IAAI,uBAAuB,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,gCAAgC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.100",
+  "version": "1.1.101",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",
@@ -60,6 +60,8 @@
     "bin/",
     "dist/",
     "scripts/patch-openapi-schemas.js",
+    "scripts/install-banner.js",
+    "scripts/banner.txt",
     "templates/",
     "vendored/components/",
     "vendored/contexts/",
@@ -96,7 +98,7 @@
     "test:local": "node scripts/test-local.js",
     "lint": "eslint src/",
     "dev": "tsc --watch",
-    "postinstall": "node scripts/patch-openapi-schemas.js"
+    "postinstall": "node scripts/patch-openapi-schemas.js && node scripts/install-banner.js"
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",

package/scripts/banner.txt

@@ -0,0 +1,5 @@
+     _                     _           _
+    | | __ _ _ __ ___   __| | ___  ___| | __
+ _  | |/ _` | '_ ` _ \ / _` |/ _ \/ __| |/ /
+| |_| | (_| | | | | | | (_| |  __/\__ \   <
+ \___/ \__,_|_| |_| |_|\__,_|\___||___/_|\_\

package/scripts/install-banner.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Postinstall banner for `npm install -g jamdesk`.
+ *
+ * Shows the same ASCII "Jamdesk" art the curl/iwr bootstrap installer prints,
+ * so a plain `npm i -g jamdesk` gets the same first-run experience.
+ *
+ * This is cosmetic and must NEVER fail an install: every branch is guarded
+ * and the process always exits 0, even on a read error.
+ *
+ * Zero-dependency by design: a postinstall runs before the package's own
+ * node_modules is guaranteed resolvable, so this inlines ANSI/TTY/version
+ * logic instead of importing from src/ (chalk/ora). Same constraint and
+ * precedent as the sibling scripts/patch-openapi-schemas.js — do not "DRY"
+ * this against src/lib/output.ts; it would break `npm install`.
+ *
+ * It deliberately stays quiet unless this is an interactive, global install:
+ *  - JAMDESK_INSTALLER set  → the bootstrap installer already showed a banner
+ *  - not a global install   → don't spam dependency installs / `npm ci`
+ *  - CI / non-TTY / quiet   → no banner in pipelines, Docker layers, logs
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+// npm's default loglevel is `notice`; these are the only levels quieter than
+// it (silent < error < warn < notice). A user on default still sees the
+// banner; `npm i -g --quiet` (→ warn) or `--silent` suppresses it.
+const QUIET_LOGLEVELS = ['silent', 'error', 'warn'];
+
+function shouldShow() {
+  if (process.env.JAMDESK_INSTALLER) return false;
+  // npm sets npm_config_global=true for `npm install -g`.
+  if (process.env.npm_config_global !== 'true') return false;
+  if (process.env.CI) return false;
+  if (QUIET_LOGLEVELS.includes(process.env.npm_config_loglevel)) return false;
+  if (!process.stdout.isTTY) return false;
+  return true;
+}
+
+try {
+  if (shouldShow()) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const art = readFileSync(join(here, 'banner.txt'), 'utf8').replace(/\n$/, '');
+    const { version } = JSON.parse(
+      readFileSync(join(here, '..', 'package.json'), 'utf8'),
+    );
+
+    const color = !process.env.NO_COLOR;
+    const blue = color ? '\x1b[34m' : '';
+    const green = color ? '\x1b[32m' : '';
+    const reset = color ? '\x1b[0m' : '';
+
+    process.stdout.write(
+      `\n${blue}${art}${reset}\n\n` +
+        `${green}[OK]${reset} Jamdesk CLI installed: ${version}\n\n` +
+        'Get started:\n' +
+        '  jamdesk init      # Create new docs project\n' +
+        '  jamdesk dev       # Start dev server\n' +
+        '  jamdesk --help    # See all commands\n\n',
+    );
+  }
+} catch {
+  // Intentionally fully silent — unlike the sibling patch-openapi-schemas.js,
+  // which console.warn's on failure because a failed schema patch has
+  // functional consequences the user must know about. A missing decorative
+  // banner has none, so a `[jamdesk] …` warning here would be pure noise
+  // during install. Never worth failing (or even cluttering) `npm install`.
+}