Rebuild of admin console

.buildkite/build.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+#
+# Copyright [ 2020 - 2024 ] [Matthew Buckton]
+# Copyright [ 2024 - 2026 ] [Maps Messaging B.V.]
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+set -euo pipefail
+
+corepack enable
+
+pnpm install
+# TODO - Fetch latest api spec
+pnpm run gen-api
+pnpm run build
+
+if [ ! -d dist ]; then
+  echo "Build failed: 'dist' directory not found."
+  exit 1
+fi
+tar --create --verbose --gzip --file=webAdminClient.tgz dist/*

.buildkite/pipeline.yml

@@ -0,0 +1,29 @@
+agents:
+  queue: "java_build_queue"
+
+steps:
+  - key: "build"
+    label: ":npm: Build and package web client"
+    command: "./.buildkite/build.sh"
+    artifact_paths:
+      - "webAdminClient.tgz"
+    plugins:
+      - docker-compose#v5.13.0:
+          config: docker-compose.yaml
+          run: node
+          propagate-uid-gid: true
+  - key: "test"
+    label: ":npm: test web client"
+    command: "./.buildkite/test.sh"
+    plugins:
+      - docker-compose#v5.13.0:
+          config: docker-compose.yaml
+          run: node
+          propagate-uid-gid: true
+
+  - key: "publish"
+    label: ":github: Publish release"
+    command: "./.buildkite/publish.sh"
+    depends_on:
+      - "build"
+    if: build.branch == "main" || build.branch == "development"

.buildkite/publish.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+#
+# Copyright [ 2020 - 2024 ] [Matthew Buckton]
+# Copyright [ 2024 - 2026 ] [Maps Messaging B.V.]
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+set -euo pipefail
+
+buildkite-agent artifact download webAdminClient.tgz .
+
+GITHUB_TOKEN="$(buildkite-agent secret get GIT_HUB_TOKEN)"
+export GITHUB_TOKEN
+VERSION=$(jq -r .version package.json)
+GITHUB_REPO="Maps-Messaging/web-admin-client"
+
+if [ "$BUILDKITE_BRANCH" == "main" ]; then
+    echo "Detected Main branch. Preparing production release..."
+    VERSION_NAME="maps_web_client_${VERSION}"
+    TARGET_BRANCH="main"
+elif [ "$BUILDKITE_BRANCH" == "development" ]; then
+    echo "Detected Development branch. Preparing dev release..."
+    VERSION_NAME="maps_web_client_dev"
+    TARGET_BRANCH="development"
+else
+    echo "Branch $BUILDKITE_BRANCH is not main or development. Skipping GitHub release."
+    exit 0
+fi
+
+
+echo "Deleting existing release '${VERSION_NAME}' from GitHub if it exists..."
+gh release delete "${VERSION_NAME}" --repo "${GITHUB_REPO}" --yes || true
+sleep 5
+
+echo "Creating a new release for ${TARGET_BRANCH}..."
+gh release create "${VERSION_NAME}" \
+    --repo "${GITHUB_REPO}" \
+    --title "${VERSION_NAME}" \
+    --notes "Automated release ${VERSION_NAME} from branch ${BUILDKITE_BRANCH}" \
+    --target "${TARGET_BRANCH}" \
+    --draft
+
+sleep 5
+
+echo "Uploading webAdminClient.tgz to GitHub..."
+gh release upload "${VERSION_NAME}" webAdminClient.tgz --repo "${GITHUB_REPO}" --clobber
+
+echo "Publishing release..."
+gh release edit "${VERSION_NAME}" --repo "${GITHUB_REPO}" --draft=false
+
+echo "Release process complete!"

.buildkite/test.sh

@@ -0,0 +1,31 @@
+#
+# Copyright [ 2020 - 2024 ] [Matthew Buckton]
+# Copyright [ 2024 - 2026 ] [Maps Messaging B.V.]
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+
+corepack enable
+
+pnpm install
+
+pnpm run test
+
+sonar-scanner \
+        -Dsonar.projectKey=web-admin-client \
+        -Dsonar.organization=maps-messaging \
+        -Dsonar.sources=src \
+        -Dsonar.typescript.lcov.reportPaths=coverage/lcov.info \
+        -Dsonar.host.url=https://sonarcloud.io \
+        -Dsonar.login="$(buildkite-agent secret get SONAR_TOKEN)"

.gitignore

@@ -1,30 +1,15 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-
-# testing
-/coverage
-
-# production
-/build
-admin
-.next
-
-# misc
+node_modules
 .DS_Store
-.eslintcache
+dist
+webAdminClient.tgz
+dist-ssr
+*.local
+count.txt
+.env
 .idea
-/.env
-/.env.local
-/.env.development.local
-/.env.test.local
-/.env.production.local
-
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
+.vscode
+.nitro
+.tanstack
+.wrangler
+.pnpm-store
 
-/src/generated

.prettierignore

@@ -0,0 +1,4 @@
+# Ignore artifacts:
+build
+coverage
+pnpm-lock.yaml

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "files.watcherExclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "search.exclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "files.readonlyInclude": {
+    "**/routeTree.gen.ts": true
+  }
+}

AGENTS.md

@@ -0,0 +1,50 @@
+# AI Agents & Developers
+
+This document provides guidelines for AI agents (e.g., Claude, GitHub Copilot) and human developers working on this codebase to ensure consistency and efficiency.
+
+## Context & Navigation
+
+### 1. Codebase Structure
+
+- `src/api/`: Contains the type-safe API client definitions generated from OpenAPI.
+- `src/components/ui/`: Low-level, reusable UI primitives (Radix + Tailwind).
+- `src/components/[feature]/`: Feature-specific components.
+- `src/hooks/`: Custom React hooks (e.g., `useAuth`, `use-debounced-value`).
+- `src/lib/`: Core utilities and singleton services (e.g., `authService`, `utils.ts`).
+- `src/routes/`: The application's routing tree, organized by filesystem.
+- `resources/`: Contains the source of truth for the API (`openapi.json`).
+
+### 2. Key Files for Reference
+
+- **API Types**: `src/api/spec.d.ts` (Generated). Always refer to this for request/response shapes.
+- **Authentication Logic**: `src/lib/auth.ts` and `src/hooks/useAuth.ts`.
+- **Routing Configuration**: `src/routes/__root.tsx` and `src/routeTree.gen.ts`.
+
+## Development Workflow
+
+### 1. API Changes
+
+If the backend API changes:
+
+1. Update `resources/openapi.json`.
+2. Run `pnpm gen-api` to regenerate TypeScript types.
+3. Verify that the changes haven't broken existing components via TypeScript errors.
+
+### 2. Adding New Features
+
+1. **Define Data Requirements**: Determine if new API endpoints are needed in the OpenAPI spec.
+2. **Create Routes**: Add new files in `src/routes/`. Use `_authenticated` prefix for protected routes.
+3. **Build Components**: Utilize existing components in `src/components/ui` to maintain design consistency.
+4. **Mocking (Optional)**: If the backend endpoint is not yet available, update the MSW handlers in `src/mocks/config.ts` or `src/mocks/schema.ts`.
+
+### 3. Testing
+
+- Use **Vitest** for all new logic.
+- Ensure that any new network-dependent code is covered by **MSW** mocks to keep tests hermetic and fast.
+
+## Coding Standards
+
+- **TypeScript**: Strict typing is mandatory. Avoid `any` at all costs.
+- **Immutability**: Prefer immutable patterns, especially when updating state in the `AuthService`.
+- **Styling**: Use Tailwind utility classes. For complex components, use the `cn()` utility from `src/lib/utils.ts`.
+- **No Manual Route Edits**: Never manually edit `src/routeTree.gen.ts`; it is an auto-generated file.