screenshot for date-input crash fix

2026-07-07 08:56:39 +02:00
commit cfe7bf889e
1160 changed files with 291466 additions and 0 deletions
@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# Local-only API docs sync. Generates docs/openapi.{json,yaml} from
+# the @openapi JSDoc blocks in backend/src/routes/v1/*, then copies the
+# result into the picpeak-docs Nextra site at /Users/paul/Development/picpeak-docs/app/api/.
+#
+# Writes only — never commits or pushes the docs repo. Review the diff
+# in picpeak-docs and commit there manually when ready.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DOCS_REPO="${PICPEAK_DOCS_REPO:-/Users/paul/Development/picpeak-docs}"
+SRC_DIR="$REPO_ROOT/docs"
+TARGET_DIR="$DOCS_REPO/app/api"
+
+cd "$REPO_ROOT/backend"
+
+# 1. Generate fresh spec from JSDoc.
+echo "▶ Generating OpenAPI spec from src/routes/v1/*"
+node scripts/generate-openapi.js
+
+# 2. Verify docs repo is reachable. Soft-fail so this doesn't block a
+#    push when the docs repo isn't on this machine.
+if [ ! -d "$DOCS_REPO" ]; then
+  echo "▶ Docs repo not found at $DOCS_REPO — skipping sync."
+  echo "  (Set PICPEAK_DOCS_REPO to override, or create the path to enable sync.)"
+  exit 0
+fi
+if [ ! -d "$TARGET_DIR" ]; then
+  echo "▶ Target dir $TARGET_DIR doesn't exist — creating."
+  mkdir -p "$TARGET_DIR"
+fi
+
+# 3. Copy spec files into the docs repo. We do NOT git-add or commit
+#    here — the user reviews and commits picpeak-docs manually.
+cp "$SRC_DIR/openapi.json" "$TARGET_DIR/openapi.json"
+cp "$SRC_DIR/openapi.yaml" "$TARGET_DIR/openapi.yaml"
+echo "▶ Wrote openapi.{json,yaml} to $TARGET_DIR"
+
+# 4. Brief drop-in MDX page that references the spec, so the Nextra
+#    nav has a stable target. Won't overwrite a hand-edited file —
+#    only writes if missing.
+REF_MDX="$TARGET_DIR/reference.mdx"
+if [ ! -f "$REF_MDX" ]; then
+  cat > "$REF_MDX" <<'EOF'
+---
+title: API Reference
+---
+
+# API Reference
+
+The PicPeak v1 REST API is documented as an OpenAPI 3 spec.
+
+- [Download `openapi.yaml`](./openapi.yaml)
+- [Download `openapi.json`](./openapi.json)
+- A live, browseable Swagger UI is served by every PicPeak instance at
+  `/api/docs` (admin login required).
+
+This page is auto-generated from JSDoc annotations on the v1 route files.
+Do not hand-edit. The narrative pages (auth, recipes) live alongside.
+EOF
+  echo "▶ Created $REF_MDX (placeholder — replace with your preferred renderer)"
+fi
+
+echo "✓ API docs synced. Review changes in $DOCS_REPO before committing."