@emeryld/rrroutes-export 1.0.3 → 1.0.5

package/dist/serializeLeafContract.d.ts

@@ -0,0 +1,31 @@
+import { type AnyLeafLowProfile, type FileField } from '@emeryld/rrroutes-contract';
+import { type IntrospectSchemaOptions, type SerializableSchema } from './schemaIntrospection';
+export type ContractLeafSchemas = {
+    body?: SerializableSchema;
+    query?: SerializableSchema;
+    params?: SerializableSchema;
+    output?: SerializableSchema;
+    outputMeta?: SerializableSchema;
+    queryExtension?: SerializableSchema;
+};
+export type SerializedLeafContract = {
+    key: string;
+    method: AnyLeafLowProfile['method'];
+    path: string;
+    cfg: {
+        description?: string;
+        summary?: string;
+        docsGroup?: string;
+        tags?: string[];
+        deprecated?: boolean;
+        stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';
+        docsHidden?: boolean;
+        docsMeta?: Record<string, unknown>;
+        feed?: boolean;
+        bodyFiles?: FileField[];
+        schemas: ContractLeafSchemas;
+    };
+};
+export type SerializeLeafContractOptions = IntrospectSchemaOptions;
+export declare function serializeLeafContract(leaf: AnyLeafLowProfile, options?: SerializeLeafContractOptions): SerializedLeafContract;
+export declare function serializeLeavesContract(leaves: readonly AnyLeafLowProfile[], options?: SerializeLeafContractOptions): SerializedLeafContract[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emeryld/rrroutes-export",
   "description": "Finalized leaves export helpers and CLI for RRRoutes",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -15,12 +15,14 @@
     }
   },
   "bin": {
-    "rrroutes-export-finalized-leaves": "./bin/rrroutes-export-finalized-leaves.mjs"
+    "rrroutes-export-finalized-leaves": "./bin/rrroutes-export-finalized-leaves.mjs",
+    "rrroutes-export-changelog": "./bin/rrroutes-export-changelog.mjs"
   },
   "files": [
     "dist",
     "tools/finalized-leaves-viewer.html",
-    "bin/rrroutes-export-finalized-leaves.mjs"
+    "bin/rrroutes-export-finalized-leaves.mjs",
+    "bin/rrroutes-export-changelog.mjs"
   ],
   "dependencies": {
     "@emeryld/rrroutes-contract": "^2.8.0",
@@ -36,10 +38,13 @@
   },
   "scripts": {
     "clean": "rimraf dist && rimraf node_modules",
-    "build": "pnpm run clean && pnpm install && pnpm run build:js",
+    "build": "pnpm run clean && pnpm install && pnpm run build:js && pnpm run build:types",
     "build:js": "tsup --config tsup.config.ts",
+    "build:types": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --config ../../jest.base.config.js --watchman=false --runInBand",
-    "export:finalized-leaves": "TS_NODE_PROJECT=tsconfig.tools.json TS_NODE_TRANSPILE_ONLY=1 node --experimental-specifier-resolution=node --loader ts-node/esm ./scripts/export-finalized-leaves.ts"
+    "export:finalized-leaves": "TS_NODE_PROJECT=tsconfig.tools.json TS_NODE_TRANSPILE_ONLY=1 node --experimental-specifier-resolution=node --loader ts-node/esm ./scripts/export-finalized-leaves.ts",
+    "export:changelog": "TS_NODE_PROJECT=tsconfig.tools.json TS_NODE_TRANSPILE_ONLY=1 node --experimental-specifier-resolution=node --loader ts-node/esm ./scripts/export-finalized-leaves-changelog.ts",
+    "export:bundle": "TS_NODE_PROJECT=tsconfig.tools.json TS_NODE_TRANSPILE_ONLY=1 node --experimental-specifier-resolution=node --loader ts-node/esm ./scripts/export-release-bundle.ts"
   }
 }

package/tools/finalized-leaves-viewer.html

@@ -648,6 +648,7 @@
       const state = {
         payload: null,
         leaves: [],
+        mode: 'snapshot',
         selectedFieldIds: new Set(SEARCH_FIELDS.map((field) => field.id)),
       }
 
@@ -667,6 +668,7 @@
       const resetFiltersBtn = document.getElementById('resetFilters')
       const statusEl = document.getElementById('status')
       const resultsEl = document.getElementById('results')
+      const controlsEl = document.querySelector('.controls')
 
       const URL_PARAM_KEY = 'filters'
       let isHydratingFromUrl = false
@@ -1306,7 +1308,115 @@
         return details
       }
 
+      function isChangelogPayload(value) {
+        return (
+          value &&
+          value.kind === 'finalized-leaves-changelog' &&
+          Array.isArray(value.commits)
+        )
+      }
+
+      function renderChangelogPayload(payload) {
+        state.mode = 'changelog'
+        state.payload = payload
+        state.leaves = []
+
+        if (controlsEl) {
+          controlsEl.style.display = 'none'
+        }
+
+        const commitBySha = new Map(
+          (payload.commits || []).map((commit) => [commit.sha, commit]),
+        )
+        const routeEntries = Object.entries(payload.byRoute || {}).sort(
+          ([a], [b]) => a.localeCompare(b),
+        )
+        const sourceEntries = Object.entries(payload.bySourceObject || {}).sort(
+          ([a], [b]) => a.localeCompare(b),
+        )
+
+        statusEl.textContent = `Loaded changelog payload with ${payload.commits.length} commits.`
+        resultsEl.innerHTML = ''
+
+        const tabs = el('div', 'chips')
+        const byRouteBtn = el('button', 'chip chip-btn', 'By Route')
+        const bySourceBtn = el('button', 'chip chip-btn', 'By Source Object')
+        byRouteBtn.type = 'button'
+        bySourceBtn.type = 'button'
+        tabs.appendChild(byRouteBtn)
+        tabs.appendChild(bySourceBtn)
+        resultsEl.appendChild(tabs)
+
+        const view = el('div')
+        resultsEl.appendChild(view)
+
+        const renderEventDetails = (event) => {
+          const card = el('div', 'leaf-content')
+          const commit = commitBySha.get(event.commitSha)
+          card.appendChild(
+            el(
+              'div',
+              'meta',
+              `${event.commitSha.slice(0, 12)}${commit?.subject ? ` - ${commit.subject}` : ''}`,
+            ),
+          )
+          card.appendChild(el('div', 'mono', event.type))
+          if (Array.isArray(event.schemaDiff) && event.schemaDiff.length > 0) {
+            card.appendChild(el('div', 'meta', `schema changes: ${event.schemaDiff.length}`))
+          }
+          if (Array.isArray(event.cfgDiff) && event.cfgDiff.length > 0) {
+            card.appendChild(el('div', 'meta', `cfg changes: ${event.cfgDiff.length}`))
+          }
+          if (Array.isArray(event.impactedRoutes) && event.impactedRoutes.length > 0) {
+            card.appendChild(
+              el('div', 'meta', `impacted routes: ${event.impactedRoutes.length}`),
+            )
+          }
+          return card
+        }
+
+        const renderByRoute = () => {
+          view.innerHTML = ''
+          if (routeEntries.length === 0) {
+            view.appendChild(el('div', 'empty', 'No route changes found in this range.'))
+            return
+          }
+
+          routeEntries.forEach(([routeKey, events]) => {
+            const details = el('details', 'leaf')
+            details.appendChild(el('summary', '', `${routeKey} (${events.length})`))
+            events.forEach((event) => details.appendChild(renderEventDetails(event)))
+            view.appendChild(details)
+          })
+        }
+
+        const renderBySource = () => {
+          view.innerHTML = ''
+          if (sourceEntries.length === 0) {
+            view.appendChild(
+              el('div', 'empty', 'No source-object changes found in this range.'),
+            )
+            return
+          }
+
+          sourceEntries.forEach(([sourceId, events]) => {
+            const details = el('details', 'leaf')
+            const display = events[0]?.displayName || sourceId
+            details.appendChild(el('summary', '', `${display} (${events.length})`))
+            events.forEach((event) => details.appendChild(renderEventDetails(event)))
+            view.appendChild(details)
+          })
+        }
+
+        byRouteBtn.addEventListener('click', renderByRoute)
+        bySourceBtn.addEventListener('click', renderBySource)
+        renderByRoute()
+      }
+
       function renderResults() {
+        if (state.mode === 'changelog') {
+          return
+        }
         const engine = createSearchEngine(searchInput.value.trim(), {
           caseSensitive: isPressed(caseSensitiveToggle),
           regex: isPressed(regexSearchToggle),
@@ -1529,10 +1639,20 @@
       async function handleFile(file) {
         const text = await file.text()
         const parsed = JSON.parse(text)
+        if (isChangelogPayload(parsed)) {
+          renderChangelogPayload(parsed)
+          return
+        }
         if (!parsed || !Array.isArray(parsed.leaves)) {
-          throw new Error('Invalid export file: expected top-level "leaves" array.')
+          throw new Error(
+            'Invalid export file: expected top-level "leaves" array or changelog payload.',
+          )
         }
 
+        state.mode = 'snapshot'
+        if (controlsEl) {
+          controlsEl.style.display = ''
+        }
         state.payload = parsed
         state.leaves = parsed.leaves
         renderResults()
@@ -1540,8 +1660,16 @@
 
       function initializeFromBakedPayload() {
         const baked = window.__FINALIZED_LEAVES_PAYLOAD
+        if (isChangelogPayload(baked)) {
+          renderChangelogPayload(baked)
+          return
+        }
         if (!baked || !Array.isArray(baked.leaves)) return
 
+        state.mode = 'snapshot'
+        if (controlsEl) {
+          controlsEl.style.display = ''
+        }
         state.payload = baked
         state.leaves = baked.leaves
         statusEl.textContent = `Loaded baked payload with ${state.leaves.length} routes.`