fix ci typecheck and add windows nsis installer prep scaffolding

Agent-Logs-Url: https://github.com/crazyrob425/KDP-E-Book-Generator/sessions/aae21f70-8b76-4e1c-89fd-59c0c3dad1a7

Co-authored-by: crazyrob425 <247058665+crazyrob425@users.noreply.github.com>

Author: Copilot

.github/workflows/release.yml

@@ -39,6 +39,12 @@ jobs:
       - name: Install frontend dependencies
         run: npm ci
 
+      - name: Prepare NSIS branding assets
+        run: npm run brand:nsis
+
+      - name: Generate release update scaffold
+        run: npm run release:scaffold-update
+
       # ── Rust ──────────────────────────────────────────────────────────────
       - name: Set up Rust
         uses: dtolnay/rust-toolchain@stable
@@ -71,6 +77,8 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           VITE_GOOGLE_API_KEY: ${{ secrets.VITE_GOOGLE_API_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
         with:
           tagName: ${{ github.ref_name }}
           releaseName: "KDP E-Book Generator ${{ github.ref_name }}"

README.md

@@ -176,6 +176,17 @@ If using the standalone backend mode, follow `/server/README.md`.
   npx tsc -p server/tsconfig.json --noEmit
   ```
 
+## 🧩 Windows Installer Prep (NSIS)
+
+- Build NSIS branding assets:
+  ```bash
+  npm run brand:nsis
+  ```
+- Generate release update metadata scaffold:
+  ```bash
+  npm run release:scaffold-update
+  ```
+
 ## 🛠️ Troubleshooting
 
 - **`vite: not found`**

docs/DEPLOYMENT_ROADMAP.md

@@ -121,6 +121,15 @@ Installers land in `src-tauri/target/release/bundle/`:
 
 The `.github/workflows/release.yml` workflow builds installers for all platforms and publishes them as a GitHub Release automatically.
 
+### Windows installer prep stack (NSIS)
+
+- `npm run brand:nsis` generates:
+  - `src-tauri/installer-assets/nsis-header.bmp`
+  - `src-tauri/installer-assets/nsis-sidebar.bmp`
+- `src-tauri/installer/nsis-hooks.nsh` enforces a legal confirmation gate before install.
+- `src-tauri/installer/EULA.txt` is bundled as the installer license file.
+- `npm run release:scaffold-update` generates `release/updates/latest.json.template` for updater metadata handoff.
+
 **To cut a release:**
 
 ```bash

package-lock.json

@@ -7,6 +7,8 @@
     "dev": "vite",
     "build": "vite build",
     "preview": "vite preview",
+    "brand:nsis": "node scripts/branding/build-nsis-assets.mjs",
+    "release:scaffold-update": "node scripts/release/generate-update-scaffold.mjs",
     "tauri:dev": "concurrently -k \"cd server && npm run start\" \"tauri dev\"",
     "tauri:build": "tauri build"
   },
@@ -61,6 +63,7 @@
   "devDependencies": {
     "@tauri-apps/api": "^2.9.1",
     "@tauri-apps/cli": "^2.9.6",
+    "@types/express": "^5.0.6",
     "@types/node": "^22.14.0",
     "@vitejs/plugin-react": "^5.0.0",
     "concurrently": "^8.2.2",

package.json

@@ -0,0 +1,23 @@
+{
+  "version": "2.1.0",
+  "notes": "Draft update metadata scaffold for v2.1.0.",
+  "pub_date": "2026-04-15T03:21:44.738Z",
+  "platforms": {
+    "windows-x86_64": {
+      "signature": "<replace-with-signature>",
+      "url": "<replace-with-release-asset-url>"
+    },
+    "darwin-aarch64": {
+      "signature": "<replace-with-signature>",
+      "url": "<replace-with-release-asset-url>"
+    },
+    "darwin-x86_64": {
+      "signature": "<replace-with-signature>",
+      "url": "<replace-with-release-asset-url>"
+    },
+    "linux-x86_64": {
+      "signature": "<replace-with-signature>",
+      "url": "<replace-with-release-asset-url>"
+    }
+  }
+}

release/updates/latest.json.template

@@ -0,0 +1,68 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import sharp from 'sharp';
+
+const root = process.cwd();
+const source = path.join(root, 'src-tauri', 'icons', 'icon.png');
+const outDir = path.join(root, 'src-tauri', 'installer-assets');
+const sidebarImage = path.join(outDir, 'nsis-sidebar.bmp');
+const headerImage = path.join(outDir, 'nsis-header.bmp');
+const installerIcon = path.join(root, 'src-tauri', 'icons', 'icon.ico');
+
+await fs.mkdir(outDir, { recursive: true });
+
+const toBmp24 = async (inputPath, width, height, outputPath) => {
+  const { data, info } = await sharp(inputPath)
+    .resize(width, height, { fit: 'cover' })
+    .flatten({ background: '#111827' })
+    .ensureAlpha()
+    .raw()
+    .toBuffer({ resolveWithObject: true });
+
+  const bytesPerPixel = 3;
+  const rowStride = info.width * bytesPerPixel;
+  const paddedRowStride = Math.ceil(rowStride / 4) * 4;
+  const pixelDataSize = paddedRowStride * info.height;
+  const fileHeaderSize = 14;
+  const dibHeaderSize = 40;
+  const pixelDataOffset = fileHeaderSize + dibHeaderSize;
+  const fileSize = pixelDataOffset + pixelDataSize;
+  const bmp = Buffer.alloc(fileSize);
+
+  bmp.write('BM', 0, 2, 'ascii');
+  bmp.writeUInt32LE(fileSize, 2);
+  bmp.writeUInt32LE(pixelDataOffset, 10);
+  bmp.writeUInt32LE(dibHeaderSize, 14);
+  bmp.writeInt32LE(info.width, 18);
+  bmp.writeInt32LE(info.height, 22);
+  bmp.writeUInt16LE(1, 26);
+  bmp.writeUInt16LE(24, 28);
+  bmp.writeUInt32LE(0, 30);
+  bmp.writeUInt32LE(pixelDataSize, 34);
+
+  let outOffset = pixelDataOffset;
+  for (let y = info.height - 1; y >= 0; y--) {
+    for (let x = 0; x < info.width; x++) {
+      const inOffset = (y * info.width + x) * info.channels;
+      const r = data[inOffset];
+      const g = data[inOffset + 1];
+      const b = data[inOffset + 2];
+      bmp[outOffset++] = b;
+      bmp[outOffset++] = g;
+      bmp[outOffset++] = r;
+    }
+    while ((outOffset - pixelDataOffset) % paddedRowStride !== 0) {
+      bmp[outOffset++] = 0x00;
+    }
+  }
+
+  await fs.writeFile(outputPath, bmp);
+};
+
+await toBmp24(source, 164, 314, sidebarImage);
+await toBmp24(source, 150, 57, headerImage);
+
+console.log('NSIS branding assets prepared:');
+console.log(`- ${headerImage}`);
+console.log(`- ${sidebarImage}`);
+console.log(`- ${installerIcon}`);

scripts/branding/build-nsis-assets.mjs

@@ -0,0 +1,39 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+const root = process.cwd();
+const packageJsonPath = path.join(root, 'package.json');
+const outDir = path.join(root, 'release', 'updates');
+const outPath = path.join(outDir, 'latest.json.template');
+
+const pkg = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
+const version = pkg.version;
+
+const scaffold = {
+  version,
+  notes: `Draft update metadata scaffold for v${version}.`,
+  pub_date: new Date().toISOString(),
+  platforms: {
+    'windows-x86_64': {
+      signature: '<replace-with-signature>',
+      url: '<replace-with-release-asset-url>'
+    },
+    'darwin-aarch64': {
+      signature: '<replace-with-signature>',
+      url: '<replace-with-release-asset-url>'
+    },
+    'darwin-x86_64': {
+      signature: '<replace-with-signature>',
+      url: '<replace-with-release-asset-url>'
+    },
+    'linux-x86_64': {
+      signature: '<replace-with-signature>',
+      url: '<replace-with-release-asset-url>'
+    }
+  }
+};
+
+await fs.mkdir(outDir, { recursive: true });
+await fs.writeFile(outPath, `${JSON.stringify(scaffold, null, 2)}\n`, 'utf8');
+
+console.log(`Update scaffold generated at ${outPath}`);

scripts/release/generate-update-scaffold.mjs

@@ -0,0 +1,4 @@
+declare module 'google-trends-api' {
+  const googleTrends: any;
+  export default googleTrends;
+}

server/declarations.d.ts

@@ -2,11 +2,16 @@
   "compilerOptions": {
     "target": "ES2020",
     "module": "commonjs",
-    "rootDir": "./",
+    "rootDir": "../",
     "outDir": "./dist",
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,
     "skipLibCheck": true
-  }
+  },
+  "include": [
+    "./**/*.ts",
+    "./**/*.d.ts",
+    "../types.ts"
+  ]
 }