Support Cloudflare Workers

.github/workflows/deploy-cf-worker.yml

@@ -0,0 +1,104 @@
+name: Build Cloudflare Workers
+
+on:
+  workflow_dispatch:
+    inputs:
+      deploy:
+        description: 'Deploy to production (true) or dry run (false)'
+        required: true
+        type: boolean
+        default: false
+      site_url:
+        description: 'Deployment URL'
+        required: true
+        type: string
+        default: 'https://jamtools.app'
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+env:
+  NODE_VERSION: '20'
+
+jobs:
+  determine-mode:
+    runs-on: ubuntu-latest
+    outputs:
+      mode: ${{ steps.deploy-mode.outputs.mode }}
+      job-name: ${{ steps.deploy-mode.outputs.job-name }}
+    steps:
+      - name: Determine deployment mode
+        id: deploy-mode
+        run: |
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            if [[ "${{ github.event.inputs.deploy }}" == "true" ]]; then
+              echo "mode=deploy" >> $GITHUB_OUTPUT
+              echo "job-name=Build and Deploy" >> $GITHUB_OUTPUT
+            else
+              echo "mode=dry-run" >> $GITHUB_OUTPUT
+              echo "job-name=Build (dry run)" >> $GITHUB_OUTPUT
+            fi
+          elif [[ "${{ github.event_name }}" == "pull_request" ]]; then
+            echo "mode=deploy" >> $GITHUB_OUTPUT
+            echo "job-name=Build and Deploy" >> $GITHUB_OUTPUT
+          elif [[ "${{ github.event_name }}" == "push" && "${{ github.ref }}" == "refs/heads/main" ]]; then
+            echo "mode=deploy" >> $GITHUB_OUTPUT
+            echo "job-name=Build and Deploy" >> $GITHUB_OUTPUT
+          fi
+
+  build-and-deploy:
+    needs: determine-mode
+    runs-on: ubuntu-latest
+    name: ${{ needs.determine-mode.outputs.job-name }}
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9.13.2
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+      - name: Install modules
+        run: pnpm i
+
+      - name: Build application
+        run: |
+          export PUBLIC_SITE_URL="${{ secrets.CLOUDFLARE_DEPLOYMENT_URL }}"
+          npx tsx packages/springboard/cli/src/cli.ts build ./apps/jamtools/modules/index.ts --platforms cf-workers
+        env:
+          PUBLIC_SITE_URL: ${{ secrets.CLOUDFLARE_DEPLOYMENT_URL }}
+
+      - name: Setup Wrangler
+        if: needs.determine-mode.outputs.mode != ''
+        run: npm install -g wrangler
+
+      - name: Deploy (Dry Run)
+        if: needs.determine-mode.outputs.mode == 'dry-run'
+        run: |
+          cd dist/cf-workers
+          npx wrangler deploy --dry-run
+
+      - name: Deploy (Production)
+        if: needs.determine-mode.outputs.mode == 'deploy'
+        run: |
+          cd dist/cf-workers
+          npx wrangler deploy
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          CLOUDFLARE_ZONE_ID: ${{ secrets.CLOUDFLARE_ZONE_ID }}
+
+      - name: Upload build artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: cf-workers-build-${{ github.sha }}
+          path: |
+            dist/cf-workers/
+            !dist/cf-workers/node_modules
+          retention-days: 7

.gitignore

@@ -13,3 +13,5 @@ esbuild_meta.json
 stats.html
 games
 platform-examples
+
+.claude/settings.local.json

apps/jamtools/.gitignore

@@ -0,0 +1 @@
+.wrangler

apps/jamtools/package.json

@@ -2,21 +2,26 @@
   "name": "jamtools",
   "version": "1.0.0",
   "main": "index.js",
-  "scripts": {},
+  "scripts": {
+    "build-cf": "rm -rf dist && PUBLIC_USE_WEBSOCKETS_FOR_RPC=true npx tsx ../../packages/springboard/cli/src/cli.ts build ./modules/index.ts --platforms cf-workers,main",
+    "deploy-cf": "npm run build-cf && npx wrangler deploy"
+  },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "description": "",
   "dependencies": {
-    "react-router-dom": "catalog:",
-    "springboard": "workspace:*",
     "@jamtools/core": "workspace:*",
     "@jamtools/features": "workspace:*",
     "@springboardjs/platforms-browser": "workspace:*",
     "@springboardjs/platforms-node": "workspace:*",
-    "@springboardjs/shoelace": "workspace:*"
+    "@springboardjs/shoelace": "workspace:*",
+    "react-router-dom": "catalog:",
+    "springboard": "workspace:*"
   },
   "devDependencies": {
-    "springboard-cli": "workspace:*"
+    "@types/node": "catalog:",
+    "springboard-cli": "workspace:*",
+    "wrangler": "4.10.0"
   }
 }

apps/small_apps/package.json

@@ -3,22 +3,26 @@
   "version": "0.0.1-autogenerated",
   "main": "index.js",
   "scripts": {
+    "dev": "sb dev ./tic_tac_toe/tic_tac_toe.tsx",
+    "check-types": "tsc --noEmit"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "description": "",
   "dependencies": {
-    "springboard": "workspace:*",
     "@jamtools/core": "workspace:*",
     "@jamtools/features": "workspace:*",
     "@springboardjs/platforms-browser": "workspace:*",
     "@springboardjs/platforms-node": "workspace:*",
+    "hono": "catalog:",
     "react": "catalog:",
     "react-dom": "catalog:",
+    "springboard": "workspace:*",
     "springboard-cli": "workspace:*"
   },
   "devDependencies": {
+    "@types/node": "catalog:",
     "@types/react": "catalog:",
     "@types/react-dom": "catalog:"
   }

apps/small_apps/tic_tac_toe/tic_tac_toe.tsx

@@ -3,6 +3,38 @@ import React from 'react';
 import springboard from 'springboard';
 
 import './tic_tac_toe.css';
+import serverRegistry from 'springboard-server';
+
+type MiddlewareValue = {
+    user_id: string;
+}
+
+declare module 'springboard/engine/module_api' {
+    interface RpcMiddlewareResults {
+        user_id: string;
+    }
+}
+
+// @platform "node"
+serverRegistry.registerServerModule(async (api) => {
+    const {setCookie, getCookie} = await import('hono/cookie');
+
+    api.hooks.registerRpcMiddleware(async (c): Promise<MiddlewareValue> => {
+        const cookie = getCookie(c);
+        if (cookie.user_id) {
+            return {
+                user_id: cookie.user_id,
+            };
+        }
+
+        const newUserId = Math.random().toString().substring(2);
+        setCookie(c, 'user_id', newUserId);
+        return {
+            user_id: newUserId,
+        };
+    });
+});
+// @platform end
 
 type Cell = 'X' | 'O' | null;
 type Board = Cell[][];
@@ -58,7 +90,9 @@ springboard.registerModule('TicTacToe', {}, async (moduleAPI) => {
     const scoreState = await moduleAPI.statesAPI.createPersistentState<Score>('score', {X: 0, O: 0, stalemate: 0});
 
     const actions = moduleAPI.createActions({
-        clickedCell: async (args: {row: number, column: number}) => {
+        clickedCell: async (args: {row: number, column: number}, c) => {
+            console.log('in action', c);
+            console.log(c?.user_id.length);
             if (winnerState.getState()) {
                 return;
             }

apps/small_apps/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "paths": {
+      // "~/*": ["../../packages/jamtools/*"],
+    },
+    "baseUrl": "."
+  }
+}

package.json

@@ -21,18 +21,20 @@
     "fix": "TURBO_NO_UPDATE_NOTIFIER=true turbo run fix",
     "ci": "NODE_MODULES_PARENT_FOLDER=$PWD TURBO_NO_UPDATE_NOTIFIER=true turbo run lint check-types build test",
     "heroku-postbuild": "NODE_ENV=production npm run build-saas",
+    "splash-screen-app": "npx tsx packages/springboard/cli/src/cli.ts dev ./apps/small_apps/app_with_splash_screen/app_with_splash_screen.tsx",
+    "jamtools": "npx tsx packages/springboard/cli/src/cli.ts dev ./apps/jamtools/modules/index.ts",
+    "jamtools-cf": "npx tsx packages/springboard/cli/src/cli.ts build ./apps/jamtools/modules/index.ts --platforms cf-workers",
     "build-desktop": "RUN_SIDECAR_FROM_WEBVIEW=true npx tsx packages/springboard/cli/src/cli.ts build ./apps/jamtools/modules/index.ts --platforms desktop",
-    "build-all": "RUN_SIDECAR_FROM_WEBVIEW=true npx tsx packages/springboard/cli/src/cli.ts build ./apps/small_apps/empty_app/index.ts --platforms all",
-    "splash-screen-app": "npx tsx packages/springboard/cli/src/cli.ts dev ./apps/small_apps/app_with_splash_screen/app_with_splash_screen.tsx"
+    "build-all": "RUN_SIDECAR_FROM_WEBVIEW=true npx tsx packages/springboard/cli/src/cli.ts build ./apps/small_apps/empty_app/index.ts --platforms all"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "devDependencies": {
     "@jamtools/core": "workspace:*",
     "@springboardjs/platforms-browser": "workspace:*",
+    "@springboardjs/platforms-cf-workers": "workspace:*",
     "@springboardjs/platforms-node": "workspace:*",
-    "@springboardjs/platforms-partykit": "workspace:*",
     "@springboardjs/platforms-tauri": "workspace:*",
     "@springboardjs/plugin-svelte": "workspace:*",
     "@testing-library/jest-dom": "^6.4.6",

packages/jamtools/core/modules/macro_module/macro_module.tsx

@@ -124,7 +124,7 @@ export class MacroModule implements Module<MacroConfigState> {
 
     initialize = async () => {
         const registeredMacroCallbacks = (macroTypeRegistry.registerMacroType as unknown as {calls: CapturedRegisterMacroTypeCall[]}).calls || [];
-        macroTypeRegistry.registerMacroType = this.registerMacroType;
+        // macroTypeRegistry.registerMacroType = this.registerMacroType;
 
         for (const macroType of registeredMacroCallbacks) {
             this.registerMacroType(...macroType);

packages/jamtools/features/components/QRCode.tsx

@@ -1,6 +1,8 @@
 import React from 'react';
 
+// @platform "browser"
 import QRCodeLibrary from 'qrcode';
+// @platform end
 
 type Props = {
     url: string;

packages/jamtools/features/modules/ultimate_guitar/components/ultimate_guitar_qr_code.tsx

@@ -1,6 +1,8 @@
 import React from 'react';
 
+// @platform "browser"
 import QRCode from 'qrcode';
+// @platform end
 
 export const UltimateGuitarQRCode = () => {
     React.useEffect(() => {

packages/springboard/cli/package.json

@@ -23,7 +23,6 @@
     "build-empty-jamtools-app": "npx tsx src/cli.ts build ../../../apps/small_apps/empty_jamtools_app/index.ts --platforms browser_offline",
     "build-empty-jamtools-app-desktop": "npx tsx src/cli.ts build ../../../apps/small_apps/empty_jamtools_app/index.ts --platforms desktop",
     "build-empty-jamtools-app-all": "npx tsx src/cli.ts build ../../../apps/small_apps/empty_jamtools_app/index.ts --platforms all",
-    "build-partykit": "ESBUILD_OUT_DIR=../platforms/partykit/dist npx tsx src/cli.ts build ../../../apps/small_apps/handraiser/index.ts --platforms partykit",
     "dev": "npm run build -- --watch",
     "dev-dev": "npx tsx src/cli.ts dev ../../../apps/small_apps/handraiser/index.ts",
     "clean": "rm -rf dist",