Janady13/thatdeveloperguy-website / scripts/stage-approved-assets.ts

1/** 2 * creative-source → public/ + app/experience/scenes/<id>/scene.json. 3 * Posters are the approved room masters as-is. A room .riv ships only from a verified export (`exportedBy: rive-cli | editor-ui`). 4 * Hotspots carry the site's page ids and sections straight from the package; door hotspots get their Rive trigger. 5 */ 6import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, unlinkSync, writeFileSync } from 'node:fs'; 7import { createHash } from 'node:crypto'; 8import { resolve } from 'node:path'; 9import type { SceneHotspot, SceneRecord } from '../src/contracts/scene.ts'; 10 11const root = resolve(import.meta.dirname, '..'); 12const publicAnimation = resolve(root, 'public/animation'); 13const posterDirectory = resolve(root, 'public/images/posters'); 14 15// This script owns the public animation boundary. Recreate it so removed or 16// authoring-only files can never linger into a later release. 17rmSync(publicAnimation, { recursive: true, force: true }); 18rmSync(posterDirectory, { recursive: true, force: true }); 19mkdirSync(publicAnimation, { recursive: true }); 20mkdirSync(posterDirectory, { recursive: true }); 21 22const itLayerSource = resolve(root, 'creative-source/runtime/it-services/layers'); 23const itLayerOutput = resolve(publicAnimation, 'it-services/layers'); 24mkdirSync(itLayerOutput, { recursive: true }); 25for (const file of readdirSync(itLayerSource)) { 26 if (file.endsWith('.svg')) copyFileSync(resolve(itLayerSource, file), resolve(itLayerOutput, file)); 27} 28const ROOMS: Record<string, { posterAlt: string; captionRest: string }> = { 29 lobby: { posterAlt: 'The lobby: reception desk, three doors — IT Services, Government Solutions, Cybersecurity — and a lounge by the window', captionRest: 'Three doors. Pick the room you need.' }, 30 'it-services': { posterAlt: 'The IT Services room: status board, service desk, workstations, server racks and a tool cart', captionRest: 'Every object in the room is a section of this page.' }, 31 government: { posterAlt: 'The Government Solutions room: presentation display, project and review boards, contract files and a conference table', captionRest: 'Every object in the room is a section of this page.' }, 32 cybersecurity: { posterAlt: 'The Cybersecurity room: network visibility, review scope and security operations displays, consoles, racks and a secure door', captionRest: 'Every object in the room is a section of this page.' }, 33}; 34const ROOM_CAPTIONS: Record<string, Record<string, string>> = { 35 lobby: { 36 'door-IT': 'IT Services — support, endpoints, infrastructure and deployment.', 37 'door-Gov': 'Government Solutions — planning, requirements, contracting and delivery.', 38 'door-Cyber': 'Cyber Security — monitoring, review, response and infrastructure protection.', 39 reception: 'Reception — request a briefing.', 40 lounge: 'The lounge — who we are.', 41 }, 42 'it-services': { 43 status: 'Systems health, service status, deployments and continuity at a glance.', 44 helpdesk: 'IT support desk, service requests and day-to-day user help.', 45 deployment: 'Planned deployment and maintenance with rollback discipline.', 46 toolcart: 'Plan, configure, deploy, maintain and improve.', 47 workstations: 'Support desk, endpoints, accounts and workstation management.', 48 racks: 'Network, infrastructure, servers and cloud foundations.', 49 }, 50 government: {}, 51 cybersecurity: {}, 52}; 53 54const roomAnimationDir = resolve(root, 'public/animation/rooms'); 55mkdirSync(roomAnimationDir, { recursive: true }); 56for (const [sceneId, meta] of Object.entries(ROOMS)) { 57 const refined = resolve(root, 'creative-source/refined', sceneId); 58 const manifest = JSON.parse(readFileSync(resolve(refined, 'manifest.json'), 'utf8')); 59 const rivePath = resolve(root, 'creative-source/rive', sceneId, 'rive-manifest.json'); 60 let riveManifest: any = null; 61 if (existsSync(rivePath)) riveManifest = JSON.parse(readFileSync(rivePath, 'utf8')); 62 const canvas = riveManifest?.canvas ?? manifest.canvas; 63 const hotspotScale = { x: canvas.width / manifest.canvas.width, y: canvas.height / manifest.canvas.height }; 64 const rasterPoster = resolve(root, 'creative-source/rive', sceneId, 'poster.webp'); 65 const posterExt = existsSync(rasterPoster) ? 'webp' : 'svg'; 66 if (sceneId === 'lobby') { 67 const vectorSource = resolve(refined, 'scene.svg'); 68 const vectorBytes = readFileSync(vectorSource); 69 const sourceHash = createHash('sha256').update(vectorBytes).digest('hex'); 70 if (sourceHash !== manifest.source.sha256) throw new Error(`lobby kit hash mismatch: ${sourceHash}`); 71 } 72 if (posterExt === 'webp') copyFileSync(rasterPoster, resolve(root, `public/images/posters/${sceneId}.webp`)); 73 else copyFileSync(resolve(refined, 'poster.svg'), resolve(root, `public/images/posters/${sceneId}.svg`)); 74 if (sceneId === 'cybersecurity') { 75 const kitMetadata = JSON.parse(readFileSync(resolve(refined, 'kit-source.json'), 'utf8')); 76 const vectorSource = resolve(refined, 'animation-scene.svg'); 77 const vectorHash = createHash('sha256').update(readFileSync(vectorSource)).digest('hex'); 78 if (vectorHash !== kitMetadata.productionVector.sha256) throw new Error(`cybersecurity kit hash mismatch: ${vectorHash}`); 79 const vectorOutput = resolve(root, 'public/animation/cybersecurity'); 80 mkdirSync(vectorOutput, { recursive: true }); 81 copyFileSync(vectorSource, resolve(vectorOutput, 'cybersecurity-scene.svg')); 82 for (const pass of kitMetadata.depthPasses ?? []) { 83 const passSource = resolve(root, pass.repoSource); 84 const passHash = createHash('sha256').update(readFileSync(passSource)).digest('hex'); 85 if (passHash !== pass.sha256) throw new Error(`cybersecurity ${pass.id} depth-pass hash mismatch: ${passHash}`); 86 copyFileSync(passSource, resolve(vectorOutput, `${pass.id}.svg`)); 87 } 88 } 89 // Referenced plates for the native room (contentless ImageAssets in the .riv; the runtime asset loader fetches these by DPR). 90 for (const set of ['2x', '4x']) { 91 const src = resolve(root, 'creative-source/plates', sceneId, set); 92 if (!existsSync(src)) continue; 93 const dst = resolve(roomAnimationDir, `${sceneId}-plates`, set); mkdirSync(dst, { recursive: true }); 94 for (const file of readdirSync(src)) if (file.endsWith('.webp')) copyFileSync(resolve(src, file), resolve(dst, file)); 95 } 96 let rive: SceneRecord['rive'] = null; let triggers: Record<string, string> = {}; let focusValues: Record<string, string> = {}; 97 if (riveManifest) { 98 const rm = riveManifest; 99 const rmlSourcePath = rm.source?.kind === 'rive-rml-project' && typeof rm.source?.path === 'string' ? resolve(root, rm.source.path) : null; 100 const rmlSourceMatches = Boolean(rmlSourcePath && existsSync(rmlSourcePath) && createHash('sha256').update(readFileSync(rmlSourcePath)).digest('hex') === rm.source.sha256); 101 const sourceMatches = rm.source?.sha256 === manifest.source.sha256 || rmlSourceMatches; 102 const lobbyNativeOverride = sceneId === 'lobby' && (rm.source?.kind === 'production-layer-stack' || rm.source?.kind === 'optimized-production-layer-stack') && rm.sha256 && rm.file; 103 if ((rm.exportedBy === 'rive-cli' || rm.exportedBy === 'editor-ui') && (sourceMatches || lobbyNativeOverride)) { 104 const sourceRive = resolve(root, 'creative-source/rive', sceneId, rm.file); 105 const bytes = readFileSync(sourceRive); 106 const hash = createHash('sha256').update(bytes).digest('hex'); 107 if (hash !== rm.sha256) throw new Error(`${sceneId}: compiled Rive hash mismatch: ${hash}`); 108 const shortHash = hash.slice(0, 12); 109 const riveFileName = `${sceneId}.${shortHash}.riv`; 110 for (const file of readdirSync(roomAnimationDir)) if (file === `${sceneId}.riv` || file.startsWith(`${sceneId}.`) && file.endsWith('.riv')) unlinkSync(resolve(roomAnimationDir, file)); 111 copyFileSync(sourceRive, resolve(roomAnimationDir, riveFileName)); 112 const variants: NonNullable<SceneRecord['rive']>['variants'] = {}; 113 for (const [density, variant] of Object.entries(rm.variants ?? {}) as Array<['2x' | '4x', { file: string; sha256: string }]>) { 114 const variantSource = resolve(root, 'creative-source/rive', sceneId, variant.file); 115 const variantBytes = readFileSync(variantSource); 116 const variantHash = createHash('sha256').update(variantBytes).digest('hex'); 117 if (variantHash !== variant.sha256) throw new Error(`${sceneId}: ${density} Rive hash mismatch: ${variantHash}`); 118 const variantName = `${sceneId}-${density}.${variantHash.slice(0, 12)}.riv`; 119 copyFileSync(variantSource, resolve(roomAnimationDir, variantName)); 120 variants[density] = { file: `/animation/rooms/${variantName}`, sha256: variantHash }; 121 } 122 rive = { file: `/animation/rooms/${riveFileName}`, artboard: rm.artboard, stateMachine: rm.stateMachine, viewModel: rm.viewModel, sha256: hash, ...(Object.keys(variants).length ? { variants } : {}), ...(rm.viewModelOptional ? { viewModelOptional: true } : {}), ...(rm.nativeInputs ? { nativeInputs: rm.nativeInputs } : {}) }; 123 for (const h of rm.hotspots ?? []) { if (h.trigger) triggers[h.id] = h.trigger; if (h.focusValue) focusValues[h.id] = h.focusValue; } 124 } else if (sceneId === 'lobby') throw new Error('lobby: verified RML source and compiled Rive are required'); 125 else console.warn(`${sceneId}: rive-manifest present but not a verified export of the current master; not staged`); 126 } 127 const hotspots: SceneHotspot[] = manifest.hotspots.map((h: any) => ({ id: h.id, label: h.label, hit: { x: h.rect[0] * hotspotScale.x, y: h.rect[1] * hotspotScale.y, width: h.rect[2] * hotspotScale.x, height: h.rect[3] * hotspotScale.y }, target: h.section ? { kind: 'anchor' as const, anchor: h.section.replace(/^#/, ''), pageId: h.pageId } : { kind: 'page' as const, pageId: h.pageId }, focusValue: focusValues[h.id] ?? (rive ? 'none' : h.id), ...(triggers[h.id] ? { trigger: triggers[h.id] } : {}) })); 128 if (sceneId === 'lobby' && !rive) throw new Error('lobby: animation cannot be disabled or replaced by a fallback implementation'); 129 const scene: SceneRecord = { id: sceneId, canvas, poster: `/images/posters/${sceneId}.${posterExt}`, posterAlt: meta.posterAlt, rive, hotspots, captionRest: meta.captionRest, captions: ROOM_CAPTIONS[sceneId] ?? {} }; 130 const out = resolve(root, 'app/experience/scenes', sceneId); mkdirSync(out, { recursive: true }); 131 writeFileSync(resolve(out, 'scene.json'), JSON.stringify(scene, null, 2) + '\n'); 132 console.log(`${sceneId}: poster ${(manifest.source.bytes / 1024).toFixed(0)} KB, ${hotspots.length} hotspots, rive ${rive ? 'staged' : 'not staged'}`); 133} 134