Merge pull request #172 from thomaxxl/feat/docker-fastapi-demo-github-client

demo: fetch safrs-jsonapi-client from github by default

Author: thomaxxl

examples/docker_fastapi_demo/README.md

@@ -7,7 +7,7 @@ This directory packages the current Northwind validation app as a self-contained
 - `reference/` contains the shipped `admin.yaml`
 - `site/` contains the simple landing page served by nginx at `/`
 - `vendor/safrs/` is a vendored copy of the current SAFRS source used by the backend image
-- `vendor/safrs-jsonapi-client/` is a vendored client package used by the frontend
+- `vendor/safrs-jsonapi-client/` is an optional local fallback for the frontend client package
 
 The container runs multiple processes:
 
@@ -100,6 +100,18 @@ Container paths:
 - default baked-in frontend: `/app/frontend`
 - dev-mounted frontend: `/demo/frontend`
 
+## Client dependency source
+
+By default, the frontend installs `safrs-jsonapi-client` from:
+
+- `https://codeload.github.com/thomaxxl/safrs-jsonapi-client/tar.gz/refs/heads/main`
+
+To force local vendored fallback instead, set:
+
+```bash
+USE_LOCAL_SAFRS_JSONAPI_CLIENT=1 docker compose up --build
+```
+
 ## Notes
 
 - The runtime SQLite database is stored in the `northwind_demo_data` Docker volume.

examples/docker_fastapi_demo/entrypoint.sh

@@ -56,6 +56,21 @@ export VITE_DEV_PORT="5173"
 export VITE_HMR_CLIENT_PORT="${DEMO_EXTERNAL_PORT:-8000}"
 export VITE_HMR_PATH="/admin-app/__vite_hmr"
 
+SAFRS_JSONAPI_CLIENT_SPEC="https://codeload.github.com/thomaxxl/safrs-jsonapi-client/tar.gz/refs/heads/main"
+if is_true "${USE_LOCAL_SAFRS_JSONAPI_CLIENT:-0}"; then
+  LOCAL_CLIENT_DIR="$SOURCE_ROOT/vendor/safrs-jsonapi-client"
+  if [ ! -f "$LOCAL_CLIENT_DIR/package.json" ]; then
+    echo "USE_LOCAL_SAFRS_JSONAPI_CLIENT is set, but $LOCAL_CLIENT_DIR is missing" >&2
+    exit 1
+  fi
+  SAFRS_JSONAPI_CLIENT_SPEC="file:$LOCAL_CLIENT_DIR"
+fi
+
+(
+  cd "$SOURCE_ROOT/frontend"
+  npm pkg set "dependencies.safrs-jsonapi-client=$SAFRS_JSONAPI_CLIENT_SPEC"
+)
+
 if [ "$SOURCE_ROOT" = "/demo" ]; then
   (cd /demo/frontend && npm install --no-audit --no-fund --package-lock=false)
 elif [ ! -x /app/frontend/node_modules/.bin/vite ]; then

examples/docker_fastapi_demo/frontend/package-lock.json

@@ -17,7 +17,7 @@
     "react": "^18.3.1",
     "react-admin": "^5.3.2",
     "react-dom": "^18.3.1",
-    "safrs-jsonapi-client": "file:../vendor/safrs-jsonapi-client"
+    "safrs-jsonapi-client": "https://codeload.github.com/thomaxxl/safrs-jsonapi-client/tar.gz/refs/heads/main"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",