Update pipeline to Node 24. Update Lerna. Update Vitepress to Beta. Replace...

.gitlab-ci.yml

@@ -1,4 +1,4 @@
-image: node:22
+image: node:24
 
 # We use stages for clarity of intent, and "needs" for dependencies and sequencing.
 # "needs" should work in parallel where acceptable, and get any artifacts directly from the source step.

package.json

@@ -54,25 +54,26 @@
   "devDependencies": {
     "@eslint/js": "^9.10.0",
     "@types/eslint__js": "^8.42.3",
-    "@typescript-eslint/eslint-plugin": "^8.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.66.0",
-    "@typescript-eslint/parser": "^8.5.0",
+    "@typescript-eslint/parser": "^8.66.0",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.10.0",
     "eslint-config-prettier": "^8.10.0",
     "eslint-plugin-prettier": "^5.2.1",
-    "lerna": "^9.0.3",
+    "lerna": "^10.0.0",
     "madge": "^8.0.0",
     "prettier": "^3.3.3",
-    "typescript": "5.7.2",
+    "typescript": "5.9.3",
-    "typescript-eslint": "^8.6.0",
+    "typescript-eslint": "^8.66.0",
     "vitest": "^3.2.4"
   },
   "overrides": {
-    "vitepress": {
+    "nx": {
-      "vite": "^7.1.10"
+      "brace-expansion": "5.0.9"
     },
-    "vitepress-plugin-mermaid": {
+    "lerna": {
-      "vite": "^7.1.10"
+      "js-yaml": "4.3.1",
+      "tar": "7.5.22"
     }
   }
 }

packages/docs/package.json

@@ -17,13 +17,13 @@
     "@monaco-editor/loader": "^1.5.0",
     "@xocash/primitives": "*",
     "@xocash/stack": "*",
-    "monaco-editor": "^0.52.2"
+    "monaco-editor": "^0.52.2",
+    "vitepress-mermaid-renderer": "^1.2.0"
   },
   "devDependencies": {
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.3.2",
     "typedoc-vitepress-theme": "^1.1.1",
-    "vitepress": "^1.6.4",
+    "vitepress": "2.0.0-alpha.18"
-    "vitepress-plugin-mermaid": "^2.0.17"
   }
 }

packages/docs/src/.vitepress/config.ts

@@ -1,5 +1,4 @@
 import { defineConfig } from 'vitepress';
-import { withMermaid } from 'vitepress-plugin-mermaid';
 import typedocSidebar from '../api/typedoc-sidebar.json';
 
 // Node imports for auto blog sidebar (works at docs/src/.vitepress)
@@ -39,8 +38,8 @@ function toPascalCase(str: string) {
     .map((word) => {
       if (word.length === 0) return '';
 
-      if (SPECIAL_CASES[word]) {
+      if (word in SPECIAL_CASES) {
-        return SPECIAL_CASES[word];
+        return SPECIAL_CASES[word as keyof typeof SPECIAL_CASES];
       }
 
       // Capitalize first letter, lowercase rest
@@ -114,8 +113,7 @@ function blogSidebar() {
 }
 
 // https://vitepress.dev/reference/site-config
-export default withMermaid(
+export default defineConfig({
-  defineConfig({
   outDir: '../dist',
   title: 'XO Stack',
   description:
@@ -319,5 +317,4 @@ export default withMermaid(
       },
     },
   },
-  }),
+});
-);

packages/docs/src/.vitepress/theme/index.ts

@@ -1,15 +1,61 @@
-// https://vitepress.dev/guide/custom-theme
+import { h, nextTick, watch } from 'vue';
 import type { Theme } from 'vitepress';
+import { useData } from 'vitepress';
 import DefaultTheme from 'vitepress/theme';
 import Layout from './Layout.vue';
+
 import './style.css';
 import './custom.css';
 import './tools.css';
 import './mermaid-overrides.css';
-import './mermaid-lightbox.client';
+
+import { createMermaidRenderer } from 'vitepress-mermaid-renderer';
 
 export default {
   extends: DefaultTheme,
-  Layout,
+
-  enhanceApp({ _app, _router, _siteData }) {},
+  Layout: () => {
+    const { isDark, localeIndex } = useData();
+
+    const initMermaid = () => {
+      const mermaidRenderer = createMermaidRenderer({
+        theme: isDark.value ? 'dark' : 'forest',
+      });
+
+      mermaidRenderer.setToolbar({
+        showLanguageLabel: false,
+        downloadFormat: 'svg',
+        fullscreenMode: 'browser',
+        desktop: {
+          copyCode: 'enabled',
+          toggleFullscreen: 'enabled',
+          resetView: 'enabled',
+          zoomOut: 'enabled',
+          zoomIn: 'enabled',
+          zoomLevel: 'enabled',
+          download: 'enabled',
+        },
+        fullscreen: {
+          copyCode: 'disabled',
+          toggleFullscreen: 'enabled',
+          resetView: 'disabled',
+          zoomLevel: 'disabled',
+          download: 'enabled',
+        },
+      });
+    };
+
+    nextTick(initMermaid);
+
+    watch(
+      () => [isDark.value, localeIndex.value] as const,
+      () => {
+        initMermaid();
+      },
+    );
+
+    return h(Layout);
+  },
+
+  enhanceApp() {},
 } satisfies Theme;

packages/primitives/src/encrypter.ts

@@ -36,20 +36,26 @@ export class Encrypter {
       ...opts,
     };
 
+    // Something about the browser crypto API. It needs a "clean" Uint8Array, where TS could see the construction or something
+    const cleanKey = new Uint8Array(key);
+
     // Create a key derivation key
     const keyMaterialBase = await crypto.subtle.importKey(
       'raw',
-      key,
+      cleanKey,
       'PBKDF2',
       false,
       ['deriveBits', 'deriveKey'],
     );
 
+    // Something about the browser crypto API. It needs a "clean" Uint8Array, where TS could see the construction or something
+    const cleanSalt = new Uint8Array(encryptionOpts.salt);
+
     // Derive the actual encryption key
     const derivedKey = await crypto.subtle.deriveKey(
       {
         name: 'PBKDF2',
-        salt: encryptionOpts.salt,
+        salt: cleanSalt,
         iterations: encryptionOpts.iterations,
         hash: 'SHA-256',
       },
@@ -87,6 +93,9 @@ export class Encrypter {
     // Generate random IV
     const iv = crypto.getRandomValues(new Uint8Array(this.opts.ivLength));
 
+    // Something about the browser crypto API. It needs a "clean" Uint8Array, where TS could see the construction or something
+    const cleanData = new Uint8Array(data);
+
     // Encrypt the data
     const encryptedData = await crypto.subtle.encrypt(
       {
@@ -94,7 +103,7 @@ export class Encrypter {
         iv,
       },
       this.key,
-      data,
+      cleanData,
     );
 
     // Combine IV and encrypted data

packages/stack/package.json

@@ -41,7 +41,7 @@
     "@generalprotocols/oracle-client": "^0.0.1-development.11878773826",
     "@xocash/primitives": "*",
     "async-mutex": "^0.5.0",
-    "better-sqlite3": "^11.8.1",
+    "better-sqlite3": "^13.0.3",
     "idb": "8.0.3",
     "json-to-graphql-query": "^2.3.0",
     "msgpackr": "^1.11.2",

packages/stack/src/storage/store-remote-http.ts

@@ -297,10 +297,16 @@ export class StoreRemoteHTTP<T = unknown> extends BaseStore<
       'X-Timestamp': timestamp.toString(),
     };
 
-    const requestOptions = {
+    const body = payload ? pack(payload) : pack({});
+    const bodyBuffer = new Uint8Array(body.buffer);
+
+    const requestOptions: RequestInit = {
       method: 'POST',
       headers,
-      body: payload ? pack(payload) : pack({}),
+      // Because we support the DOM types, it doesnt register this UInt8Array as an acceptable BodyInit, so we need to cast it to unknown.
+      // Could be fixed in a later version of typescript, but there are build issues atm.
+      // TODO: (not really, unless we intend to use this code) Remove the type cast.
+      body: bodyBuffer as unknown as BodyInit,
     };
 
     // Use the URL class to compile the full path.

packages/stack/tests/blockchain/blockchain-e2e.spec.ts

@@ -4,19 +4,18 @@
 //       However, Chaingraph backend is currently broken for many queries, so let's not do this yet.
 
 import { beforeAll, describe, it, expect } from 'vitest';
-import {
+import { BaseBlockchain, BlockchainElectrum } from '../../src/index.js';
-  BaseBlockchain,
-  BlockchainChaingraph,
-  BlockchainElectrum,
-} from '../../src/index.js';
 
 const adapters: Record<
   string,
   () => Promise<BaseBlockchain<unknown, unknown>>
 > = {
-  chaingraph: async () => {
+  // Commenting out since the chaingraph endopoints we are hitting are currently broken.
-    return await BlockchainChaingraph.from();
+  // demo won't allow non-browser clients
-  },
+  // Pat's server isn't responding to block height requests correctly (or we are using an old version, which the demo server is also running).
+  // chaingraph: async () => {
+  //   return await BlockchainChaingraph.from();
+  // },
   electrum: async () => {
     return await BlockchainElectrum.from();
   },
@@ -59,7 +58,7 @@ describe.each(Object.entries(adapters))('%s Adapter', (name, createAdapter) => {
   });
 
   it(`${name}.fetchBlockHeader() `, async () => {
-    const result = await blockchain.fetchBlockHeader(testBlockHeight);
+    const result = await blockchain.fetchBlockHeader(1);
 
     expect(result).toBeDefined();
     expect(result.toHex()).toBeTypeOf('string');

packages/stack/tests/utils/graphql-client.spec.ts

@@ -6,7 +6,7 @@ import {
   monitorSyncTipsSchema,
 } from '../../src/blockchain/blockchain-chaingraph-helpers.js';
 
-const chaingraphServer = 'https://demo.chaingraph.cash/v1/graphql';
+const chaingraphServer = 'https://gql.chaingraph.pat.mn/v1/graphql';
 
 describe('GraphQLClient', () => {
   const graphQLClient = new GraphQLClient(chaingraphServer);