Compare commits
1
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e04d904eb7 |
No files matched your search
@@ -2,8 +2,10 @@
|
||||
description: Cloud edition implementation details, PostgreSQL Row-Level Security (RLS) isolation, cross-subdomain auth, and cryptographic license keys.
|
||||
paths:
|
||||
- "src/lib/auth*"
|
||||
- "src/lib/auth/**/*"
|
||||
- "src/app/api/auth/**/*"
|
||||
- "src/core/auth.ts"
|
||||
- "src/core/storage.ts"
|
||||
- "src/core/tenant.ts"
|
||||
---
|
||||
|
||||
> **SUPERSEDED by ADR-003** (`docs/architecture/decisions/adr-0003-shared-identity-and-ecosystem-auth-host.md`).
|
||||
@@ -175,15 +177,13 @@ DATABASE_URL=postgresql://...
|
||||
|
||||
## Edition Adapters
|
||||
|
||||
Three thin adapter modules provide all edition-specific behaviour -- everything else is edition-unaware:
|
||||
Three thin files are all that differs between editions — everything else is edition-unaware:
|
||||
|
||||
| Adapter | Local | Cloud | Demo |
|
||||
|---|---|---|---|
|
||||
| `src/lib/auth.ts` | Auth.js `Credentials` (bcrypt + PostgreSQL) | Auth.js `@auth/supabase-adapter` | Disabled |
|
||||
| Storage adapter (planned) | `fs.writeFile()` to `data/` | Supabase Storage SDK | Read-only |
|
||||
| Tenant adapter (planned) | No-op (single tenant) | Sets `app.tenant_id` for RLS | No-op |
|
||||
|
||||
> The storage and tenant adapters listed above are planned for the Cloud edition build-out and are not yet implemented as separate files. Auth is fully implemented in `src/lib/auth.ts` and `src/lib/auth.config.ts`.
|
||||
| `src/core/auth.ts` | Auth.js `Credentials` (bcrypt + PostgreSQL) | Auth.js `@auth/supabase-adapter` | Disabled |
|
||||
| `src/core/storage.ts` | `fs.writeFile()` to `data/` | Supabase Storage SDK | Read-only |
|
||||
| `src/core/tenant.ts` | No-op (single tenant) | Sets `app.tenant_id` for RLS | No-op |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -206,10 +206,18 @@ Hard refresh: `Ctrl+Shift+R`
|
||||
|
||||
## Creating Static OSM Plugins
|
||||
|
||||
Use the `plugin-new` skill (`.agents/skills/plugin-new/SKILL.md`) to scaffold new plugins, including OSM-based static data plugins. The old `scaffold-osm-plugin.mjs` script and `osm-static-plugin-creation.md` skill were removed; static OSM plugins are now built as standard `bundle` format plugins via the wwv-cli:
|
||||
See full guide: `.agents/skills/osm-static-plugin-creation.md`
|
||||
|
||||
**Quick start:**
|
||||
```bash
|
||||
node packages/wwv-cli/dist/index.js create <name> --local
|
||||
node scripts/scaffold-osm-plugin.mjs '{
|
||||
"name": "volcanoes",
|
||||
"displayName": "Volcanoes",
|
||||
"osmTag": "natural=volcano",
|
||||
"icon": "Mountain",
|
||||
"color": "#ef4444",
|
||||
"category": "Natural Disaster"
|
||||
}'
|
||||
```
|
||||
|
||||
**Manual Overpass API query (PowerShell):**
|
||||
@@ -219,29 +227,26 @@ $body = "data=[out:json][timeout:300];(node[$tag];way[$tag];relation[$tag];);out
|
||||
Invoke-RestMethod -Uri 'https://overpass-api.de/api/interpreter' -Method Post -Body $body -OutFile 'tmp/raw_data.json'
|
||||
```
|
||||
|
||||
**Note:** OSM data is licensed under **ODbL** - include attribution in plugin READMEs.
|
||||
**Note:** OSM data is licensed under **ODbL** — include attribution in plugin READMEs.
|
||||
|
||||
---
|
||||
|
||||
## npm Plugin Publishing
|
||||
|
||||
The `npm-plugin-publishing.md` skill was removed. Use the wwv-cli publish command:
|
||||
See full guide: `.agents/skills/version-control/npm-plugin-publishing.md`
|
||||
|
||||
```bash
|
||||
# Publish a local plugin
|
||||
node packages/wwv-cli/dist/index.js publish <name> [--org <your-org>]
|
||||
|
||||
# Or publish directly via pnpm (for packages/ workspace members)
|
||||
# First-time publish
|
||||
pnpm publish --workspace=packages/wwv-plugin-<name> --access public
|
||||
|
||||
# Future versions via Trusted Publishing (GitHub Actions CI/CD)
|
||||
# Future versions — via Trusted Publishing (GitHub Actions CI/CD)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Git / Version Control
|
||||
|
||||
The `git-version-control.md` skill was removed. See `.agents/skills/using-git-worktrees/SKILL.md` for worktree workflows and `.agents/skills/branch-cleanup/SKILL.md` for the post-merge teardown flow.
|
||||
See full guide: `.agents/skills/version-control/git-version-control.md`
|
||||
|
||||
**Commit convention:** `feat:`, `fix:`, `chore:`, `docs:` prefixes.
|
||||
**Commit when:** A new feature is completed (per project rules).
|
||||
@@ -250,7 +255,7 @@ The `git-version-control.md` skill was removed. See `.agents/skills/using-git-wo
|
||||
|
||||
## Security Checks
|
||||
|
||||
The `security-check.md` skill was removed. Security reviews are handled by the `security-reviewer` agent (`.agents/agents/security-reviewer.md`). Trigger it after any change touching auth routes, API routes, plugin loading, or marketplace flows.
|
||||
See full guide: `.agents/skills/security/security-check.md`
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -237,7 +237,7 @@ GET marketplace.worldwideview.dev/api/registry
|
||||
- Trust is **always stamped server-side** — no client-side trust claims accepted
|
||||
- Registry response cached for **5 minutes** (in-memory on each WWV instance)
|
||||
- If registry unreachable, last cached result used; new unknowns default to `unverified`
|
||||
- **Managing:** Use the marketplace admin API (`/api/admin/registry`) to manage the signed plugin registry. The old `src/data/verifiedPlugins.ts` static file was replaced by database-driven registry management.
|
||||
- **Managing:** Edit `src/data/verifiedPlugins.ts` in marketplace repo and redeploy
|
||||
- **Revoking:** Remove plugin ID and redeploy — WWV instances drop trust on next cache refresh
|
||||
|
||||
### Unverified Plugin Warning
|
||||
@@ -437,7 +437,7 @@ This queries Overpass API, converts to GeoJSON, scaffolds the package, and print
|
||||
| Power plants | `power=plant` | 15k |
|
||||
| Wind farms | `generator:source=wind` | 50k |
|
||||
|
||||
The `osm-static-plugin-creation.md` skill was removed. Use `node packages/wwv-cli/dist/index.js create <name> --local` to scaffold a new plugin, then populate it with OSM data fetched via the Overpass API.
|
||||
See skill: `.agents/skills/osm-static-plugin-creation.md`
|
||||
|
||||
---
|
||||
|
||||
@@ -462,7 +462,7 @@ To solve this friction and make third-party plugin hosting highly intuitive, the
|
||||
2. **Backend SDK:** They write simple `.ts` fetch scripts returning `GeoEntity[]` and drop them into a mounted `/seeders` volume.
|
||||
3. **Zero Configuration:** The Docker engine hot-reloads these seeders, handles the Redis caching, and exposes standardized REST or WebSocket endpoints automatically. The developer focuses only on fetching data, avoiding all backend infrastructure setup.
|
||||
|
||||
The `data-engine-seeder-creation.md` skill was removed. Seeder implementation rules are documented inline in `.agents/rules/data-engine-architecture.md`. Seeders live in `local-seeders/community/` or `local-seeders/private/` (separate git clones).
|
||||
See skill: `.agents/skills/data-engine-seeder-creation.md`
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,49 +0,0 @@
|
||||
# /triage-issue
|
||||
|
||||
Triage a single GitHub issue in `silvertakana/worldwideview` per the project's [TRIAGE.md](../../TRIAGE.md) intake rules. Classifies the issue, recommends a disposition, and executes it after explicit user confirmation.
|
||||
|
||||
**Usage:** `/triage-issue <issue-number>`
|
||||
|
||||
`$ARGUMENTS` = the issue number to triage.
|
||||
|
||||
## Procedure
|
||||
|
||||
### 1. Fetch the issue
|
||||
|
||||
```bash
|
||||
gh issue view $ARGUMENTS --repo silvertakana/worldwideview --json number,title,body,labels,comments,author
|
||||
```
|
||||
|
||||
### 2. Classify
|
||||
|
||||
Determine the type from the title prefix and body:
|
||||
|
||||
| Signal | Type |
|
||||
|---|---|
|
||||
| `[PLUGIN]`, "data source", "show X on the globe" | **plugin-request** |
|
||||
| `[FEATURE]`, "feature request", capability not tied to a data source | **enhancement** |
|
||||
| `[BUG]`, error, stack trace, "doesn't work" | **bug** |
|
||||
| Open-ended question, no actionable ask | **question** |
|
||||
|
||||
### 3. Apply the TRIAGE.md rule
|
||||
|
||||
- **plugin-request:** vet the API first (dispatch the `plugin-researcher` agent if the source is unknown). Then apply the build/do-not-build rule (free API + renders something meaningful + fits the demo).
|
||||
- Viable -> propose: add a checklist line to #4, label `plugin-request` + `good first issue` + `help wanted`, close standalone with "Tracked in #4."
|
||||
- Not viable -> propose: close with the specific reason.
|
||||
- **enhancement:** propose: label `enhancement`, add a one-line ROADMAP backlog entry, keep open.
|
||||
- **bug:** propose: label `bug`, reproduce, then fix inline or route to the `debugger` agent.
|
||||
- **question:** draft a reply; propose answer-then-close.
|
||||
|
||||
### 4. Confirm before any state change
|
||||
|
||||
Present the classification and proposed actions as a short summary. **Do not** comment, label, pin, close, or edit anything until the user explicitly approves (per the project's "explicit user authorization before any state-changing action" rule). Comments are posted from the owner account, so they read as owner triage notes - keep them accurate and neutral.
|
||||
|
||||
### 5. Execute
|
||||
|
||||
On approval, run the `gh` commands for the approved actions only. Report each result with its URL.
|
||||
|
||||
## Notes
|
||||
|
||||
- Issue #4 (Plugin Wishlist) is the canonical pinned funnel for plugin ideas - never create a competing wishlist.
|
||||
- Never promise dates on `enhancement` issues.
|
||||
- See [TRIAGE.md](../../TRIAGE.md) for the full rationale and the build/do-not-build test.
|
||||
@@ -61,7 +61,6 @@ jobs:
|
||||
images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
|
||||
tags: |
|
||||
type=raw,value=latest,enable={{is_default_branch}}
|
||||
type=raw,value=ci,enable={{is_default_branch}}
|
||||
type=ref,event=branch
|
||||
type=sha,format=short
|
||||
|
||||
|
||||
@@ -1,122 +0,0 @@
|
||||
---
|
||||
phase: 17-instance-picker-ui-overhaul
|
||||
plan: "01"
|
||||
subsystem: marketplace-instance-data-layer
|
||||
tags: [api, tdd, validation, prisma, auth]
|
||||
dependency_graph:
|
||||
requires: []
|
||||
provides: [SavedInstance-lastUsedAt, GET-me-instances-fixed, validateInstanceUrl, POST-instances-link, DELETE-PATCH-instances-id]
|
||||
affects: [InstancePicker, InstanceHydrator, InstanceCapture, InstanceConfig]
|
||||
tech_stack:
|
||||
added: []
|
||||
patterns: [discriminated-union, idempotent-upsert, ownership-check-404, tdd-red-green]
|
||||
key_files:
|
||||
created:
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/lib/instanceValidation.ts
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/lib/instanceValidation.spec.ts
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/app/api/instances/link/route.ts
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/app/api/instances/[id]/route.ts
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/app/api/instances/link/route.test.ts
|
||||
modified:
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/lib/instanceStore.ts
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/app/api/me/instances/route.ts
|
||||
- C:/dev/wwv/worldwideview-marketplace/src/app/api/me/instances/route.test.ts
|
||||
decisions:
|
||||
- "GET /api/me/instances kept at current URL - not renamed to /api/instances"
|
||||
- "Anon callers still receive 200 + empty array - no 401 switch"
|
||||
- "SavedInstance gets lastUsedAt only - createdAt deliberately excluded per plan"
|
||||
- "Route test mocks updated to reflect getOrCreateMarketplaceUser addition (Rule 1 fix)"
|
||||
metrics:
|
||||
duration: "~25 minutes"
|
||||
completed: "2026-05-30"
|
||||
tasks_completed: 3
|
||||
files_changed: 8
|
||||
---
|
||||
|
||||
# Phase 17 Plan 01: Instance Data Layer Summary
|
||||
|
||||
**One-liner:** Server-side instance sync data layer with idempotent upsert, URL validation discriminated union, and ownership-checked CRUD routes.
|
||||
|
||||
## Tasks Completed
|
||||
|
||||
| Task | Name | Commit | Files |
|
||||
|------|------|--------|-------|
|
||||
| 1 | Add lastUsedAt to SavedInstance + fix GET | 421a5b8 | instanceStore.ts, me/instances/route.ts |
|
||||
| 2 (RED) | validateInstanceUrl failing tests | 269cad1 | instanceValidation.spec.ts |
|
||||
| 2 (GREEN) | validateInstanceUrl implementation | 9a3fcb7 | instanceValidation.ts |
|
||||
| 3 (RED) | link route failing tests | 20c7ea0 | instances/link/route.test.ts |
|
||||
| 3 (GREEN) | link + [id] routes implementation | e69ebca | instances/link/route.ts, instances/[id]/route.ts, route.test.ts fix |
|
||||
|
||||
## What Was Built
|
||||
|
||||
**Task 1** fixed two issues in the existing GET route:
|
||||
- `SavedInstance` interface now includes `lastUsedAt: string` (no `createdAt` per plan)
|
||||
- GET route now calls `getOrCreateMarketplaceUser` to resolve the marketplace cuid before querying `LinkedInstance.userId`. The previous bug queried with the raw Supabase user id, so rows written by `/api/install/start` (which use the marketplace cuid) were never returned.
|
||||
- `lastUsedAt` added to the SELECT
|
||||
- Anonymous callers still receive `200 + { instances: [] }` - no auth-contract regression
|
||||
|
||||
**Task 2** ported `instanceValidation.ts` with full TDD:
|
||||
- `InstanceValidationResult` discriminated union: `{ ok: true; url: string } | { ok: false; reason: string }`
|
||||
- `validateInstanceUrl(raw, marketplaceOrigin)` normalises to `parsed.origin`, rejects non-http(s), self-loops, unparseable, empty/null
|
||||
- 8 Vitest cases (split null/undefined case and empty-string into separate `it` blocks)
|
||||
- RED commit preceded GREEN commit
|
||||
|
||||
**Task 3** ported both write routes with TDD:
|
||||
- `POST /api/instances/link`: idempotent upsert via `userId_url` compound key, bumps `lastUsedAt` on repeat
|
||||
- `DELETE /api/instances/[id]`: ownership check via `findFirst { id, userId }`; returns 404 (never 403)
|
||||
- `PATCH /api/instances/[id]`: nickname trimmed to 80 chars, null clears field; 404 for non-owned
|
||||
- Link route unit tests: 401 for anon + upsert called with correct `userId_url`
|
||||
- RED commit preceded GREEN commit
|
||||
|
||||
## Deviations from Plan
|
||||
|
||||
### Auto-fixed Issues
|
||||
|
||||
**1. [Rule 1 - Bug] Existing route.test.ts for GET /api/me/instances broken by Task 1**
|
||||
- **Found during:** Task 3 full test run
|
||||
- **Issue:** The existing `src/app/api/me/instances/route.test.ts` mocked `prisma` without `user.findUnique` and did not mock `getOrCreateMarketplaceUser`. After Task 1 added `getOrCreateMarketplaceUser` to the route, the test threw `TypeError: Cannot read properties of undefined (reading 'findUnique')`.
|
||||
- **Fix:** Updated the test to mock `getOrCreateMarketplaceUser`, updated prisma mock (no longer needs `user` table), and adjusted assertions to use marketplace user id (`mkt-456`) instead of raw supabase id.
|
||||
- **Files modified:** `src/app/api/me/instances/route.test.ts`
|
||||
- **Commit:** e69ebca (bundled with Task 3 GREEN)
|
||||
|
||||
### Pre-existing Failures (Out of Scope)
|
||||
|
||||
- `src/app/oauth/authorize/actions.spec.ts` has 1 failing test that existed before this plan. Verified by stash-and-test. Not caused by any change in this plan. Logged for deferred attention.
|
||||
|
||||
## TDD Gate Compliance
|
||||
|
||||
| Gate | Commit | Status |
|
||||
|------|--------|--------|
|
||||
| Task 2 RED | 269cad1 | test(17-01): add failing tests for validateInstanceUrl (RED) |
|
||||
| Task 2 GREEN | 9a3fcb7 | feat(17-01): implement validateInstanceUrl (GREEN) |
|
||||
| Task 3 RED | 20c7ea0 | test(17-01): add failing tests for POST /api/instances/link (RED) |
|
||||
| Task 3 GREEN | e69ebca | feat(17-01): create POST /api/instances/link + DELETE/PATCH /api/instances/[id] (GREEN) |
|
||||
|
||||
Both TDD cycles satisfied: RED commit preceded GREEN commit for Tasks 2 and 3.
|
||||
|
||||
## Known Stubs
|
||||
|
||||
None. All routes are fully implemented and wired to live Prisma queries.
|
||||
|
||||
## Threat Surface Scan
|
||||
|
||||
All mitigations from the plan's threat model are present:
|
||||
- T-17-01: `validateInstanceUrl` rejects non-http(s), unparseable, marketplace self-origin; only `parsed.origin` stored
|
||||
- T-17-02: DELETE/PATCH use `findFirst { id, userId }` ownership check; return 404 (not 403)
|
||||
- T-17-03: GET uses `getOrCreateMarketplaceUser` scoped to caller's marketplace cuid
|
||||
- T-17-04: PATCH trims nickname to 80 chars before persist
|
||||
|
||||
No new security surface introduced beyond what the threat model covers.
|
||||
|
||||
## Self-Check: PASSED
|
||||
|
||||
- `src/lib/instanceStore.ts` - FOUND, contains `lastUsedAt: string`
|
||||
- `src/app/api/me/instances/route.ts` - FOUND, uses `getOrCreateMarketplaceUser`
|
||||
- `src/lib/instanceValidation.ts` - FOUND, exports `validateInstanceUrl`
|
||||
- `src/lib/instanceValidation.spec.ts` - FOUND, 8 `it(` blocks
|
||||
- `src/app/api/instances/link/route.ts` - FOUND, exports `POST`
|
||||
- `src/app/api/instances/[id]/route.ts` - FOUND, exports `DELETE` and `PATCH`
|
||||
- `src/app/api/instances/link/route.test.ts` - FOUND, 2 tests pass
|
||||
- Commits 421a5b8, 269cad1, 9a3fcb7, 20c7ea0, e69ebca - all present in git log
|
||||
- `npx tsc --noEmit` - no errors
|
||||
- `pnpm test` - 75 passed, 1 pre-existing failure (oauth, out of scope)
|
||||
@@ -132,7 +132,6 @@ See `.agents/context/INDEX.md` for the full navigation table. Key files:
|
||||
| `/five` | Five Whys root cause analysis | `.agents/workflows/five.md` |
|
||||
| `/stitch-to-nextjs` | Generate UI with Stitch MCP, port into Next.js | `.agents/workflows/stitch-to-nextjs.md` |
|
||||
| `/branch-cleanup` | **Post-merge teardown** — commit leftovers, delete plan file, remove worktree via worktree-manager | `.agents/skills/branch-cleanup/SKILL.md` |
|
||||
| `/triage-issue` | Triage a single issue (plugin/feature/bug/question) per `TRIAGE.md`; confirm before any state change | `.agents/workflows/triage-issue.md` |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,50 +0,0 @@
|
||||
# Issue Triage Guide
|
||||
|
||||
How incoming **plugin requests** and **feature requests** are handled in `silvertakana/worldwideview`. The goal is a consistent, low-effort intake so nothing rots and contributors always know where their idea stands.
|
||||
|
||||
Run `/triage-issue <number>` to apply this guide to a specific issue.
|
||||
|
||||
## 1. Intake types and labels
|
||||
|
||||
Every non-bug request is one of two types:
|
||||
|
||||
| Type | What it is | Label | Examples |
|
||||
|---|---|---|---|
|
||||
| **Plugin request** | A new data source to render on the globe | `plugin-request` | BirdNET (#148), ISS tracker, AIS ships |
|
||||
| **Feature request** | A platform capability, not a data source | `enhancement` | GeoJSON editor (#84), ontology layer (#138) |
|
||||
|
||||
Community-buildable plugin requests also get `good first issue` + `help wanted`.
|
||||
|
||||
## 2. Plugin requests funnel into #4
|
||||
|
||||
[Issue #4 - Plugin Wishlist](https://github.com/silvertakana/worldwideview/issues/4) is the **single pinned funnel** for plugin ideas. When a `[PLUGIN]` issue arrives:
|
||||
|
||||
1. **Vet the data source.** Is there a free, public API? Check rate limits and CORS. The `plugin-researcher` agent does this in about a minute.
|
||||
2. **If viable:** add it as a checklist line in #4, label the standalone `plugin-request` + `good first issue` + `help wanted`, then close the standalone with a note: "Tracked in the Plugin Wishlist #4." This keeps one canonical list instead of scattered duplicates.
|
||||
3. **If not viable** (no free API, paywalled, or geofenced - e.g. aviation/OpenSky in #149): close with the reason stated, so nobody re-opens the same dead end.
|
||||
|
||||
## 3. Feature requests stay open as tracking threads
|
||||
|
||||
1. Label `enhancement`.
|
||||
2. Add a one-line entry to the `.planning` ROADMAP backlog (shared root, see `WWV_SHARED_PLANNING`).
|
||||
3. Leave the issue **open** as the canonical tracking thread. Reply with status, but **promise no dates**.
|
||||
|
||||
## 4. The build / do-not-build rule
|
||||
|
||||
Only build a plugin yourself (or kick off the `/plugin-new` pipeline) when **all three** hold:
|
||||
|
||||
1. **Free API exists** - no paywall, usable rate limits.
|
||||
2. **Renders something meaningful** - points, paths, or regions on the globe, not just a number.
|
||||
3. **Fits the demo** - relevant to the live `demo` edition, not a niche one-off.
|
||||
|
||||
If any one fails, it lives in the wishlist (#4) for community contributors. The same three-part test is why aviation was pulled from the demo (#149): the only free API was unreliable.
|
||||
|
||||
## 5. Quick reference
|
||||
|
||||
```
|
||||
[PLUGIN] issue -> vet API -> viable? yes: add to #4, label, close standalone
|
||||
no: close with reason
|
||||
[FEATURE] issue -> label enhancement -> add to ROADMAP backlog -> keep open
|
||||
bug -> reproduce -> label bug -> fix or route to debugger agent
|
||||
question -> answer -> close
|
||||
```
|
||||
@@ -1,103 +0,0 @@
|
||||
# Reusable compose for plugin smoke CI (consumed by wwv-plugins repo).
|
||||
#
|
||||
# Boots a full stack with a STUB seeder that emits known-good GeoEntity[]
|
||||
# data under the plugin-under-test's id. This isolates "is the frontend
|
||||
# wiring correct" from "is the real backend healthy" — a broken real seeder
|
||||
# cannot fail plugin CI.
|
||||
#
|
||||
# ─── Scope boundary (what THIS compose does vs what the workflow does) ───
|
||||
#
|
||||
# This compose only boots services. The consuming workflow's Playwright
|
||||
# `globalSetup` is responsible for:
|
||||
# 1. Inserting the test user into `users` (for NextAuth credentials login)
|
||||
# 2. Inserting the `InstalledPlugin` row with the plugin's manifest JSON
|
||||
# (entry URL → http://localhost:3000/plugins-local/<PLUGIN_ID>/frontend.mjs)
|
||||
# 3. UI login → save storageState.json
|
||||
# 4. Running the smoke spec
|
||||
#
|
||||
# Reuse the pattern from worldwideview/tests/global.setup.ts. DB migrations
|
||||
# are handled automatically by the wwv-app entrypoint at container start.
|
||||
#
|
||||
# ─── Known foundation gap (deferred) ───
|
||||
#
|
||||
# The stub-seeder is mounted via `./stub-seeder:/app/seeders/community/stub-seeder`
|
||||
# below — a path RELATIVE to this compose file. When a consumer repo downloads
|
||||
# only this YAML, that path resolves to nothing. The clean fix is to bake the
|
||||
# stub-seeder into the `wwv-data-engine:ci` image at /app/seeders/community/__ci-stub__/
|
||||
# so the compose only needs to set STUB_PLUGIN_ID. That requires a coordinated
|
||||
# Dockerfile change in the wwv-data-engine repo — tracked as the next session's
|
||||
# first task.
|
||||
#
|
||||
# Until then, this compose only works when the worldwideview source tree
|
||||
# (with docker/ci/stub-seeder/) is the working directory.
|
||||
#
|
||||
# Expected env vars from consuming workflow:
|
||||
# PLUGIN_ID — kebab-case id of the plugin under test (e.g. "aviation")
|
||||
# PLUGIN_BUNDLE_DIR — host path to the plugin's compiled dist/ (mounted into wwv-app)
|
||||
# CI_IMAGE_TAG — image tag to pull (default: ci)
|
||||
|
||||
services:
|
||||
db:
|
||||
image: postgres:15-alpine
|
||||
environment:
|
||||
POSTGRES_USER: postgres
|
||||
POSTGRES_PASSWORD: postgres
|
||||
POSTGRES_DB: worldwideview
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -U postgres -d worldwideview"]
|
||||
interval: 3s
|
||||
timeout: 3s
|
||||
retries: 20
|
||||
|
||||
wwv-redis:
|
||||
image: redis:7-alpine
|
||||
healthcheck:
|
||||
test: ["CMD", "redis-cli", "ping"]
|
||||
interval: 3s
|
||||
timeout: 3s
|
||||
retries: 10
|
||||
|
||||
wwv-data-engine:
|
||||
image: ghcr.io/silvertakana/wwv-data-engine:${CI_IMAGE_TAG:-ci}
|
||||
command: ["node", "dist/server.js"]
|
||||
ports:
|
||||
- "5000:5000"
|
||||
environment:
|
||||
PORT: 5000
|
||||
REDIS_URL: redis://wwv-redis:6379
|
||||
SEEDERS_DIR: /app/seeders
|
||||
DB_PATH: /tmp/engine.db
|
||||
# Stub seeder reads the target plugin id from this env var
|
||||
STUB_PLUGIN_ID: ${PLUGIN_ID}
|
||||
WWV_SKIP_WS_AUTH: "true"
|
||||
NODE_ENV: ci
|
||||
volumes:
|
||||
# Mount only the stub seeder — no other seeders to avoid contamination
|
||||
- ./stub-seeder:/app/seeders/community/stub-seeder:ro
|
||||
depends_on:
|
||||
wwv-redis:
|
||||
condition: service_healthy
|
||||
|
||||
wwv-app:
|
||||
image: ghcr.io/silvertakana/worldwideview:${CI_IMAGE_TAG:-ci}
|
||||
ports:
|
||||
- "3000:3000"
|
||||
environment:
|
||||
AUTH_SECRET: ci-placeholder-secret-not-used-in-tests
|
||||
DATABASE_URL: postgresql://postgres:postgres@db:5432/worldwideview?schema=public
|
||||
NEXT_PUBLIC_WWV_EDITION: local
|
||||
NEXT_PUBLIC_WWV_PLUGIN_DATA_ENGINE_URL: http://localhost:5000
|
||||
volumes:
|
||||
# Mount the plugin's compiled bundle so the app can load it locally
|
||||
- ${PLUGIN_BUNDLE_DIR}:/app/public/plugins-local/${PLUGIN_ID}:ro
|
||||
depends_on:
|
||||
db:
|
||||
condition: service_healthy
|
||||
wwv-data-engine:
|
||||
condition: service_started
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "wget --no-verbose --tries=1 --spider http://localhost:3000/api/health || exit 1"]
|
||||
interval: 5s
|
||||
timeout: 5s
|
||||
retries: 30
|
||||
start_period: 30s
|
||||
@@ -1,64 +0,0 @@
|
||||
# Reusable compose for seeder smoke CI (consumed by wwv-seeders-* repos).
|
||||
#
|
||||
# Runs the REAL seeder against a MOCK upstream HTTP server. This isolates
|
||||
# "is the seeder code correct" from "is the upstream provider up" — a
|
||||
# NASA FIRMS / OpenSky / Overpass outage cannot fail seeder CI.
|
||||
#
|
||||
# Expected env vars from consuming workflow:
|
||||
# SEEDER_NAME — kebab-case name of the seeder under test
|
||||
# SEEDER_DIST_DIR — host path to the seeder's compiled dist/ + package.json
|
||||
# FIXTURE_DIR — host path to the seeder's __fixtures__ directory
|
||||
# CI_IMAGE_TAG — image tag to pull (default: ci)
|
||||
#
|
||||
# Plus any seeder-specific upstream env vars (e.g. OPENSKY_API_BASE)
|
||||
# already exported in the workflow shell, all pointing at http://mock-upstream:8080
|
||||
|
||||
services:
|
||||
wwv-redis:
|
||||
image: redis:7-alpine
|
||||
ports:
|
||||
- "6379:6379"
|
||||
healthcheck:
|
||||
test: ["CMD", "redis-cli", "ping"]
|
||||
interval: 3s
|
||||
timeout: 3s
|
||||
retries: 10
|
||||
|
||||
mock-upstream:
|
||||
build:
|
||||
context: ./mock-upstream
|
||||
volumes:
|
||||
- ${FIXTURE_DIR}:/fixtures:ro
|
||||
environment:
|
||||
FIXTURE_DIR: /fixtures
|
||||
PORT: 8080
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "wget -q -O- http://localhost:8080/__health || exit 1"]
|
||||
interval: 5s
|
||||
timeout: 3s
|
||||
retries: 5
|
||||
|
||||
wwv-data-engine:
|
||||
image: ghcr.io/silvertakana/wwv-data-engine:${CI_IMAGE_TAG:-ci}
|
||||
command: ["node", "dist/server.js"]
|
||||
ports:
|
||||
- "5000:5000"
|
||||
volumes:
|
||||
# Mount ONLY this seeder under /app/seeders/community/<name> — isolates
|
||||
# the test from any cross-seeder dependencies or collisions.
|
||||
- ${SEEDER_DIST_DIR}:/app/seeders/community/${SEEDER_NAME}:ro
|
||||
environment:
|
||||
PORT: 5000
|
||||
REDIS_URL: redis://wwv-redis:6379
|
||||
SEEDERS_DIR: /app/seeders
|
||||
DB_PATH: /tmp/engine.db
|
||||
# Seeder-specific upstream env vars are injected by the consuming
|
||||
# workflow via `environment:` overrides or `env_file:`.
|
||||
env_file:
|
||||
- path: ./.seeder.env
|
||||
required: false
|
||||
depends_on:
|
||||
wwv-redis:
|
||||
condition: service_healthy
|
||||
mock-upstream:
|
||||
condition: service_healthy
|
||||
@@ -1,5 +0,0 @@
|
||||
FROM node:22-alpine
|
||||
WORKDIR /mock
|
||||
COPY server.mjs ./
|
||||
EXPOSE 8080
|
||||
CMD ["node", "/mock/server.mjs"]
|
||||
@@ -1,48 +0,0 @@
|
||||
# mock-upstream
|
||||
|
||||
Tiny HTTP server used in CI to stand in for upstream data APIs (OpenSky, NASA FIRMS, Overpass, etc.) so seeder CI can run hermetically without real API keys or network flakiness.
|
||||
|
||||
## How it works
|
||||
|
||||
Mount a fixture directory at `/fixtures`. The directory must contain a `routes.json` mapping request paths → fixture filenames:
|
||||
|
||||
```json
|
||||
{
|
||||
"/api/states/all": "opensky-states.json",
|
||||
"/api/v2/flights": "flights.json"
|
||||
}
|
||||
```
|
||||
|
||||
When the server receives `GET /api/states/all`, it serves the contents of `/fixtures/opensky-states.json`.
|
||||
|
||||
## Env vars
|
||||
|
||||
| Var | Default | Purpose |
|
||||
|---|---|---|
|
||||
| `FIXTURE_DIR` | `/fixtures` | Directory mounted from the seeder repo |
|
||||
| `ROUTES_FILE` | `${FIXTURE_DIR}/routes.json` | Override the routes manifest path |
|
||||
| `PORT` | `8080` | Listen port |
|
||||
|
||||
## Per-seeder convention
|
||||
|
||||
Each seeder ships its own `__fixtures__/` folder next to `src/`:
|
||||
|
||||
```
|
||||
wwv-seeders-community/aviation/
|
||||
├── src/index.ts
|
||||
└── __fixtures__/
|
||||
├── routes.json
|
||||
└── opensky-states.json
|
||||
```
|
||||
|
||||
In CI compose, that folder is mounted into the mock-upstream container at `/fixtures` for the duration of the seeder smoke test.
|
||||
|
||||
## Architectural contract
|
||||
|
||||
Seeders MUST read upstream URLs from documented env vars with the production URL as the default, e.g.:
|
||||
|
||||
```ts
|
||||
const UPSTREAM = process.env.OPENSKY_API_BASE ?? "https://opensky-network.org";
|
||||
```
|
||||
|
||||
The CI compose then overrides `OPENSKY_API_BASE=http://mock-upstream:8080`. Without this convention, CI mocking is impossible — hardcoded URLs cannot be intercepted.
|
||||
@@ -1,61 +0,0 @@
|
||||
import { createServer } from "node:http";
|
||||
import { readFileSync, existsSync } from "node:fs";
|
||||
import { resolve, join } from "node:path";
|
||||
|
||||
const FIXTURE_DIR = process.env.FIXTURE_DIR ?? "/fixtures";
|
||||
const PORT = Number(process.env.PORT ?? 8080);
|
||||
const ROUTES_FILE = process.env.ROUTES_FILE ?? join(FIXTURE_DIR, "routes.json");
|
||||
|
||||
if (!existsSync(ROUTES_FILE)) {
|
||||
console.error(`[mock-upstream] no routes file at ${ROUTES_FILE}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
let routes;
|
||||
try {
|
||||
routes = JSON.parse(readFileSync(ROUTES_FILE, "utf8"));
|
||||
} catch (err) {
|
||||
console.error(`[mock-upstream] failed to parse ${ROUTES_FILE}:`, err);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log(`[mock-upstream] loaded ${Object.keys(routes).length} routes from ${ROUTES_FILE}`);
|
||||
|
||||
createServer((req, res) => {
|
||||
const path = req.url?.split("?")[0] ?? "/";
|
||||
if (path === "/__health") {
|
||||
res.statusCode = 200;
|
||||
res.setHeader("content-type", "application/json");
|
||||
res.end(JSON.stringify({ status: "ok" }));
|
||||
return;
|
||||
}
|
||||
const file = routes[path];
|
||||
if (!file) {
|
||||
console.warn(`[mock-upstream] 404 ${req.method} ${path}`);
|
||||
res.statusCode = 404;
|
||||
res.setHeader("content-type", "application/json");
|
||||
res.end(JSON.stringify({ error: "no fixture", path }));
|
||||
return;
|
||||
}
|
||||
|
||||
const filePath = resolve(FIXTURE_DIR, file);
|
||||
if (!filePath.startsWith(resolve(FIXTURE_DIR))) {
|
||||
res.statusCode = 400;
|
||||
res.end("bad fixture path");
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
const body = readFileSync(filePath);
|
||||
res.statusCode = 200;
|
||||
res.setHeader("content-type", file.endsWith(".json") ? "application/json" : "text/plain");
|
||||
res.end(body);
|
||||
console.log(`[mock-upstream] 200 ${req.method} ${path} -> ${file}`);
|
||||
} catch (err) {
|
||||
console.error(`[mock-upstream] 500 ${req.method} ${path}:`, err);
|
||||
res.statusCode = 500;
|
||||
res.end("fixture read failed");
|
||||
}
|
||||
}).listen(PORT, () => {
|
||||
console.log(`[mock-upstream] listening on :${PORT}`);
|
||||
});
|
||||
Vendored
-50
@@ -1,50 +0,0 @@
|
||||
// CI-only stub seeder. Emits a known-good GeoEntity[] payload under the
|
||||
// plugin id provided via STUB_PLUGIN_ID. Used by plugin-CI to isolate
|
||||
// frontend wiring from real backend health.
|
||||
//
|
||||
// NOTE: This bypasses ADR-0002's compile-time name rule on purpose — the
|
||||
// data engine reads `name` once at load time, so an env-driven name is
|
||||
// fine in CI. Do NOT copy this pattern into real seeders.
|
||||
|
||||
const pluginId = process.env.STUB_PLUGIN_ID;
|
||||
// When unconfigured (e.g. seeder-CI, where this stub is baked into the shared
|
||||
// :ci image but unused), export a nameless module so the seeder-loader skips
|
||||
// it instead of crashing the engine.
|
||||
|
||||
function makeEntities() {
|
||||
const now = new Date().toISOString();
|
||||
return [
|
||||
{
|
||||
id: `${pluginId}-stub-1`,
|
||||
pluginId,
|
||||
latitude: 0,
|
||||
longitude: 0,
|
||||
altitude: 0,
|
||||
timestamp: now,
|
||||
label: "Stub entity 1",
|
||||
properties: { source: "ci-stub" },
|
||||
},
|
||||
{
|
||||
id: `${pluginId}-stub-2`,
|
||||
pluginId,
|
||||
latitude: 10,
|
||||
longitude: 10,
|
||||
altitude: 0,
|
||||
timestamp: now,
|
||||
label: "Stub entity 2",
|
||||
properties: { source: "ci-stub" },
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
export default pluginId
|
||||
? {
|
||||
name: pluginId,
|
||||
cron: "*/10 * * * * *",
|
||||
fn: async (ctx) => {
|
||||
const entities = makeEntities();
|
||||
await ctx.setLiveSnapshot(pluginId, entities, 300);
|
||||
console.log(`[stub-seeder] emitted ${entities.length} entities for ${pluginId}`);
|
||||
},
|
||||
}
|
||||
: {};
|
||||
@@ -1,7 +0,0 @@
|
||||
{
|
||||
"name": "stub-seeder",
|
||||
"version": "0.1.0",
|
||||
"type": "module",
|
||||
"main": "dist/index.mjs",
|
||||
"private": true
|
||||
}
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "worldwideview",
|
||||
"version": "2.48.20",
|
||||
"version": "2.48.15",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"packageManager": "[email protected]",
|
||||
@@ -82,7 +82,7 @@
|
||||
"@typescript-eslint/parser": "^8.60.1",
|
||||
"@vitejs/plugin-react": "^6.0.2",
|
||||
"@vitest/coverage-v8": "4.1.8",
|
||||
"concurrently": "^10.0.3",
|
||||
"concurrently": "^9.2.1",
|
||||
"copy-webpack-plugin": "^14.0.0",
|
||||
"eslint": "^9",
|
||||
"eslint-config-airbnb": "^19.0.4",
|
||||
|
||||
@@ -1,55 +0,0 @@
|
||||
# @worldwideview/wwv-ci-probe
|
||||
|
||||
CI probe — asserts plugin/seeder integration health for the WorldWideView ecosystem.
|
||||
|
||||
Used by the smoke-test workflows in [`wwv-plugins`](https://github.com/silvertakana/wwv-plugins), [`wwv-seeders-community`](https://github.com/silvertakana/wwv-seeders-community), and [`wwv-seeders-private`](https://github.com/silvertakana/wwv-seeders-private).
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
# Via npx (recommended in CI)
|
||||
npx --yes @worldwideview/wwv-ci-probe <subcommand>
|
||||
|
||||
# Or as a dev dependency
|
||||
pnpm add -D @worldwideview/wwv-ci-probe
|
||||
```
|
||||
|
||||
## Subcommands
|
||||
|
||||
### `seeder <name>`
|
||||
|
||||
Polls Redis for `data:<name>:live` and validates the payload shape. Accepts `GeoEntity[]`, `{ items: [...] }`, or `{ <key>: [...] }`. Use this in seeder CI after booting the data engine against a mock upstream.
|
||||
|
||||
```bash
|
||||
wwv-probe seeder aviation --redis redis://localhost:6379 --timeout 60000
|
||||
```
|
||||
|
||||
### `ws <name>`
|
||||
|
||||
Connects to the data engine's `/stream` WebSocket and waits for a `data` message matching the given `pluginId`. Validates the same payload shapes as `seeder`. Use this when you want to assert the engine is broadcasting (not just persisting).
|
||||
|
||||
```bash
|
||||
wwv-probe ws aviation --url ws://localhost:5000/stream --timeout 30000
|
||||
```
|
||||
|
||||
### `id-contract <seederDist>`
|
||||
|
||||
Statically validates that a compiled seeder exports a kebab-case `name` (ADR-0002). Optionally checks the name matches an expected id.
|
||||
|
||||
```bash
|
||||
wwv-probe id-contract ./dist/index.mjs --expect aviation
|
||||
```
|
||||
|
||||
## Plugin smoke testing — not in this probe
|
||||
|
||||
The probe deliberately does **not** include a `plugin` subcommand. Plugin smoke tests need to exercise the full Next.js + Cesium frontend (plugin bundle loading, `mapWebsocketPayload`, DataBus wiring), which requires a real browser via Playwright.
|
||||
|
||||
The `wwv-plugins` repo writes its own Playwright spec for that — it reuses the auth bootstrap pattern from `worldwideview/tests/global.setup.ts` (insert test user + `InstalledPlugin` row, UI login to capture `storageState.json`, then run the plugin-toggle smoke).
|
||||
|
||||
Keeping that logic inside `wwv-plugins` avoids coupling this probe to `@playwright/test` and to the specific UI structure of the Next.js frontend.
|
||||
|
||||
## Exit codes
|
||||
|
||||
- `0` — assertion passed within the timeout
|
||||
- `1` — assertion failed (timeout exceeded, invalid payload shape, or contract violation)
|
||||
- `2` — fatal probe error (unhandled exception)
|
||||
@@ -1,30 +0,0 @@
|
||||
{
|
||||
"name": "@worldwideview/wwv-ci-probe",
|
||||
"version": "0.1.0",
|
||||
"type": "module",
|
||||
"description": "CI probe — asserts plugin/seeder integration health (ADR-0002, WS payload contract, Redis snapshots)",
|
||||
"main": "dist/index.js",
|
||||
"bin": {
|
||||
"wwv-probe": "dist/index.js"
|
||||
},
|
||||
"files": [
|
||||
"dist",
|
||||
"README.md"
|
||||
],
|
||||
"scripts": {
|
||||
"build": "tsc",
|
||||
"dev": "tsc --watch",
|
||||
"clean": "rm -rf dist",
|
||||
"prepublishOnly": "tsc"
|
||||
},
|
||||
"dependencies": {
|
||||
"commander": "^14.0.3",
|
||||
"ioredis": "^5.4.1",
|
||||
"ws": "^8.18.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^25.9.1",
|
||||
"@types/ws": "^8.5.13",
|
||||
"typescript": "^5.0.0"
|
||||
}
|
||||
}
|
||||
@@ -1,51 +0,0 @@
|
||||
import { pathToFileURL } from "node:url";
|
||||
import { resolve } from "node:path";
|
||||
|
||||
const KEBAB_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
|
||||
|
||||
/**
|
||||
* Validates ADR-0002: a seeder's exported `name` field must be kebab-case
|
||||
* and (optionally) match an expected plugin id.
|
||||
*
|
||||
* @returns true if the contract holds; false (with stderr explanation) otherwise.
|
||||
*/
|
||||
export async function probeIdContract(opts: {
|
||||
seederDist: string;
|
||||
expectId?: string;
|
||||
}): Promise<boolean> {
|
||||
const absPath = resolve(opts.seederDist);
|
||||
let mod: any;
|
||||
try {
|
||||
mod = await import(pathToFileURL(absPath).href);
|
||||
} catch (err) {
|
||||
console.error(`[id-contract] failed to import ${absPath}:`, err);
|
||||
return false;
|
||||
}
|
||||
|
||||
const seeder = mod.default ?? mod;
|
||||
if (!seeder || typeof seeder !== "object") {
|
||||
console.error(`[id-contract] ${absPath} has no default export (or export is not an object)`);
|
||||
return false;
|
||||
}
|
||||
|
||||
const name = seeder.name;
|
||||
if (typeof name !== "string" || name.length === 0) {
|
||||
console.error(`[id-contract] seeder default export missing required string field 'name'`);
|
||||
return false;
|
||||
}
|
||||
|
||||
if (!KEBAB_RE.test(name)) {
|
||||
console.error(`[id-contract] seeder name "${name}" is not valid kebab-case (must match ${KEBAB_RE})`);
|
||||
return false;
|
||||
}
|
||||
|
||||
if (opts.expectId && opts.expectId !== name) {
|
||||
console.error(
|
||||
`[id-contract] seeder name "${name}" does not match expected plugin id "${opts.expectId}" (ADR-0002 violation)`,
|
||||
);
|
||||
return false;
|
||||
}
|
||||
|
||||
console.log(`[id-contract] OK — seeder name "${name}"${opts.expectId ? ` matches expected id` : ""}`);
|
||||
return true;
|
||||
}
|
||||
@@ -1,60 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
import { Command } from "commander";
|
||||
import { probeSeeder } from "./seeder.js";
|
||||
import { probeWs } from "./ws.js";
|
||||
import { probeIdContract } from "./id-contract.js";
|
||||
|
||||
const program = new Command();
|
||||
|
||||
program
|
||||
.name("wwv-probe")
|
||||
.description("WorldWideView CI probe — asserts plugin/seeder integration health")
|
||||
.version("0.1.0");
|
||||
|
||||
program
|
||||
.command("seeder")
|
||||
.description("Wait for Redis key data:<name>:live to be populated and validate payload shape")
|
||||
.argument("<name>", "Canonical plugin id (kebab-case)")
|
||||
.option("--redis <url>", "Redis URL", "redis://localhost:6379")
|
||||
.option("--timeout <ms>", "Timeout in milliseconds", "60000")
|
||||
.action(async (name: string, opts: { redis: string; timeout: string }) => {
|
||||
const ok = await probeSeeder({
|
||||
name,
|
||||
redisUrl: opts.redis,
|
||||
timeoutMs: Number(opts.timeout),
|
||||
});
|
||||
process.exit(ok ? 0 : 1);
|
||||
});
|
||||
|
||||
program
|
||||
.command("ws")
|
||||
.description("Connect to engine /stream and wait for a data payload for the given pluginId")
|
||||
.argument("<name>", "Canonical plugin id (kebab-case)")
|
||||
.option("--url <url>", "WebSocket URL", "ws://localhost:5000/stream")
|
||||
.option("--timeout <ms>", "Timeout in milliseconds", "30000")
|
||||
.action(async (name: string, opts: { url: string; timeout: string }) => {
|
||||
const ok = await probeWs({
|
||||
name,
|
||||
wsUrl: opts.url,
|
||||
timeoutMs: Number(opts.timeout),
|
||||
});
|
||||
process.exit(ok ? 0 : 1);
|
||||
});
|
||||
|
||||
program
|
||||
.command("id-contract")
|
||||
.description("Verify seeder dist exports a kebab-case name matching the expected plugin id (ADR-0002)")
|
||||
.argument("<seederDist>", "Path to compiled seeder dist/index.mjs")
|
||||
.option("--expect <id>", "Expected plugin id (if omitted, only validates kebab-case)")
|
||||
.action(async (seederDist: string, opts: { expect?: string }) => {
|
||||
const ok = await probeIdContract({
|
||||
seederDist,
|
||||
expectId: opts.expect,
|
||||
});
|
||||
process.exit(ok ? 0 : 1);
|
||||
});
|
||||
|
||||
program.parseAsync().catch((err) => {
|
||||
console.error("[wwv-probe] fatal:", err);
|
||||
process.exit(2);
|
||||
});
|
||||
@@ -1,38 +0,0 @@
|
||||
import { describe, it, expect } from "vitest";
|
||||
import { validatePayloadValue, validatePayloadString } from "./payloadShape.js";
|
||||
|
||||
describe("validatePayloadValue", () => {
|
||||
it("accepts a non-empty GeoEntity array", () => {
|
||||
expect(validatePayloadValue([{ id: "a" }])).toEqual({ ok: true, shape: "geo-entity-array" });
|
||||
});
|
||||
it("rejects an empty array", () => {
|
||||
expect(validatePayloadValue([])).toEqual({ ok: false, reason: "GeoEntity[] is empty" });
|
||||
});
|
||||
it("accepts a non-empty items object", () => {
|
||||
expect(validatePayloadValue({ items: [1] })).toEqual({ ok: true, shape: "items-object" });
|
||||
});
|
||||
it("rejects an empty items array", () => {
|
||||
expect(validatePayloadValue({ items: [] })).toEqual({ ok: false, reason: "items[] is empty" });
|
||||
});
|
||||
it("accepts a single named collection", () => {
|
||||
expect(validatePayloadValue({ quakes: [1, 2] })).toEqual({ ok: true, shape: "named-collection" });
|
||||
});
|
||||
it("rejects an object with no array field", () => {
|
||||
const r = validatePayloadValue({ a: 1, b: 2 });
|
||||
expect(r.ok).toBe(false);
|
||||
});
|
||||
it("rejects a non-object, non-array value", () => {
|
||||
const r = validatePayloadValue(42);
|
||||
expect(r.ok).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe("validatePayloadString", () => {
|
||||
it("parses then validates", () => {
|
||||
expect(validatePayloadString('[{"id":"x"}]')).toEqual({ ok: true, shape: "geo-entity-array" });
|
||||
});
|
||||
it("rejects invalid JSON", () => {
|
||||
const r = validatePayloadString("{not json");
|
||||
expect(r.ok).toBe(false);
|
||||
});
|
||||
});
|
||||
@@ -1,59 +0,0 @@
|
||||
/**
|
||||
* Shared payload-shape validator for the WWV data contract (data-engine-architecture.md §7).
|
||||
* A valid live payload is one of three non-empty shapes:
|
||||
* - geo-entity-array: a top-level non-empty array
|
||||
* - items-object: an object with a non-empty `items` array
|
||||
* - named-collection: an object whose single array-valued key is non-empty
|
||||
*/
|
||||
export type PayloadShape = "geo-entity-array" | "items-object" | "named-collection";
|
||||
|
||||
export type PayloadValidation =
|
||||
| { ok: true; shape: PayloadShape }
|
||||
| { ok: false; reason: string };
|
||||
|
||||
/**
|
||||
* Validate an already-parsed payload value.
|
||||
* @param p - parsed JSON value
|
||||
* @returns ok with the detected shape, or a reason for rejection
|
||||
*/
|
||||
export function validatePayloadValue(p: unknown): PayloadValidation {
|
||||
if (Array.isArray(p)) {
|
||||
return p.length > 0
|
||||
? { ok: true, shape: "geo-entity-array" }
|
||||
: { ok: false, reason: "GeoEntity[] is empty" };
|
||||
}
|
||||
if (p && typeof p === "object") {
|
||||
const obj = p as Record<string, unknown>;
|
||||
if (Array.isArray(obj.items)) {
|
||||
return obj.items.length > 0
|
||||
? { ok: true, shape: "items-object" }
|
||||
: { ok: false, reason: "items[] is empty" };
|
||||
}
|
||||
const arrayKeys = Object.keys(obj).filter((k) => Array.isArray(obj[k]));
|
||||
if (arrayKeys.length === 1) {
|
||||
const arr = obj[arrayKeys[0]] as unknown[];
|
||||
return arr.length > 0
|
||||
? { ok: true, shape: "named-collection" }
|
||||
: { ok: false, reason: `${arrayKeys[0]}[] is empty` };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
reason: `payload object has no recognizable array field (keys: ${Object.keys(obj).join(", ")})`,
|
||||
};
|
||||
}
|
||||
return { ok: false, reason: `payload is neither array nor object (typeof=${typeof p})` };
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse a raw JSON string, then validate the resulting value's shape.
|
||||
* @param raw - raw JSON string from Redis
|
||||
*/
|
||||
export function validatePayloadString(raw: string): PayloadValidation {
|
||||
let parsed: unknown;
|
||||
try {
|
||||
parsed = JSON.parse(raw);
|
||||
} catch (err) {
|
||||
return { ok: false, reason: `not valid JSON (${(err as Error).message})` };
|
||||
}
|
||||
return validatePayloadValue(parsed);
|
||||
}
|
||||
@@ -1,52 +0,0 @@
|
||||
import { Redis } from "ioredis";
|
||||
import { validatePayloadString } from "./payloadShape.js";
|
||||
|
||||
/**
|
||||
* Polls Redis for `data:<name>:live` and validates that the seeder produced a
|
||||
* non-empty payload in one of the three accepted shapes (see
|
||||
* data-engine-architecture.md §7).
|
||||
*
|
||||
* @returns true if a valid payload arrived within the timeout; false otherwise.
|
||||
*/
|
||||
export async function probeSeeder(opts: {
|
||||
name: string;
|
||||
redisUrl: string;
|
||||
timeoutMs: number;
|
||||
}): Promise<boolean> {
|
||||
const redis = new Redis(opts.redisUrl, { lazyConnect: true, maxRetriesPerRequest: 1 });
|
||||
const key = `data:${opts.name}:live`;
|
||||
const deadline = Date.now() + opts.timeoutMs;
|
||||
const pollIntervalMs = 1000;
|
||||
|
||||
try {
|
||||
await redis.connect();
|
||||
} catch (err) {
|
||||
console.error(`[seeder] cannot connect to Redis at ${opts.redisUrl}:`, err);
|
||||
return false;
|
||||
}
|
||||
|
||||
console.log(`[seeder] waiting for ${key} (timeout ${opts.timeoutMs}ms)`);
|
||||
|
||||
while (Date.now() < deadline) {
|
||||
const raw = await redis.get(key);
|
||||
if (raw && raw.length > 0) {
|
||||
const validation = validatePayloadString(raw);
|
||||
await redis.quit();
|
||||
if (!validation.ok) {
|
||||
console.error(`[seeder] payload present but invalid: ${validation.reason}`);
|
||||
return false;
|
||||
}
|
||||
console.log(`[seeder] OK — ${key} populated (shape: ${validation.shape}, bytes: ${raw.length})`);
|
||||
return true;
|
||||
}
|
||||
await sleep(pollIntervalMs);
|
||||
}
|
||||
|
||||
await redis.quit();
|
||||
console.error(`[seeder] timed out — ${key} never populated within ${opts.timeoutMs}ms`);
|
||||
return false;
|
||||
}
|
||||
|
||||
function sleep(ms: number): Promise<void> {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
@@ -1,36 +0,0 @@
|
||||
import { describe, it, expect, afterEach } from "vitest";
|
||||
import { WebSocketServer } from "ws";
|
||||
import { probeWs } from "./ws.js";
|
||||
|
||||
let server: WebSocketServer | undefined;
|
||||
afterEach(() => { server?.close(); server = undefined; });
|
||||
|
||||
function startEngine(opts: { pluginId: string; requireSubscribe: boolean }) {
|
||||
server = new WebSocketServer({ port: 0 });
|
||||
server.on("connection", (sock) => {
|
||||
sock.send(JSON.stringify({ type: "welcome", engine: "test", plugins: [opts.pluginId] }));
|
||||
const send = () =>
|
||||
sock.send(JSON.stringify({ type: "data", pluginId: opts.pluginId, payload: [{ id: "x" }] }));
|
||||
if (!opts.requireSubscribe) { setInterval(send, 20); return; }
|
||||
sock.on("message", (raw) => {
|
||||
const msg = JSON.parse(raw.toString());
|
||||
if (msg.action === "subscribe" && msg.pluginId === opts.pluginId) send();
|
||||
});
|
||||
});
|
||||
const addr = server.address();
|
||||
const port = typeof addr === "object" && addr ? addr.port : 0;
|
||||
return `ws://127.0.0.1:${port}/stream`;
|
||||
}
|
||||
|
||||
describe("probeWs", () => {
|
||||
it("receives data from a subscribe-required engine (sends subscribe frame)", async () => {
|
||||
const url = startEngine({ pluginId: "stub", requireSubscribe: true });
|
||||
const ok = await probeWs({ name: "stub", wsUrl: url, timeoutMs: 3000 });
|
||||
expect(ok).toBe(true);
|
||||
});
|
||||
it("times out (false) when the plugin never produces data", async () => {
|
||||
const url = startEngine({ pluginId: "other", requireSubscribe: true });
|
||||
const ok = await probeWs({ name: "stub", wsUrl: url, timeoutMs: 800 });
|
||||
expect(ok).toBe(false);
|
||||
});
|
||||
});
|
||||
@@ -1,74 +0,0 @@
|
||||
import WebSocket from "ws";
|
||||
import { validatePayloadValue } from "./payloadShape.js";
|
||||
|
||||
/**
|
||||
* Connects to the data-engine's /stream WebSocket and resolves when a
|
||||
* `{ type: "data", pluginId: <name>, payload: ... }` message arrives for the
|
||||
* given plugin id (see data-engine-architecture.md §7).
|
||||
*
|
||||
* Rejects with exit code 1 if no matching payload arrives within the timeout
|
||||
* — which is the signature of an ADR-0002 id mismatch or a silently-dropped
|
||||
* object payload.
|
||||
*/
|
||||
export async function probeWs(opts: {
|
||||
name: string;
|
||||
wsUrl: string;
|
||||
timeoutMs: number;
|
||||
}): Promise<boolean> {
|
||||
return new Promise((resolve) => {
|
||||
const ws = new WebSocket(opts.wsUrl);
|
||||
let settled = false;
|
||||
|
||||
const timer = setTimeout(() => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
console.error(
|
||||
`[ws] timed out — no data message with pluginId="${opts.name}" in ${opts.timeoutMs}ms ` +
|
||||
`(check ADR-0002 seeder.name vs plugin id, and that the seeder is producing data)`,
|
||||
);
|
||||
ws.terminate();
|
||||
resolve(false);
|
||||
}, opts.timeoutMs);
|
||||
|
||||
ws.on("open", () => {
|
||||
// The engine is subscribe-required: it only broadcasts a plugin's data to
|
||||
// connections that have subscribed to it (websocket.ts broadcastPluginData).
|
||||
// Auth is bypassed in CI via WWV_SKIP_WS_AUTH=true, so no auth frame is sent.
|
||||
ws.send(JSON.stringify({ action: "subscribe", pluginId: opts.name }));
|
||||
console.log(`[ws] connected to ${opts.wsUrl}, subscribed to pluginId="${opts.name}"`);
|
||||
});
|
||||
|
||||
ws.on("message", (raw) => {
|
||||
let msg: any;
|
||||
try {
|
||||
msg = JSON.parse(raw.toString());
|
||||
} catch {
|
||||
return;
|
||||
}
|
||||
if (msg?.type !== "data" || msg.pluginId !== opts.name) return;
|
||||
if (settled) return;
|
||||
|
||||
const payload = msg.payload;
|
||||
const valid = validatePayloadValue(payload);
|
||||
if (!valid.ok) {
|
||||
console.error(`[ws] received message for "${opts.name}" but payload invalid: ${valid.reason}`);
|
||||
// Keep waiting — a later message might be valid.
|
||||
return;
|
||||
}
|
||||
|
||||
settled = true;
|
||||
clearTimeout(timer);
|
||||
console.log(`[ws] OK — received valid payload for "${opts.name}" (shape: ${valid.shape})`);
|
||||
ws.close();
|
||||
resolve(true);
|
||||
});
|
||||
|
||||
ws.on("error", (err) => {
|
||||
if (settled) return;
|
||||
settled = true;
|
||||
clearTimeout(timer);
|
||||
console.error(`[ws] connection error:`, err);
|
||||
resolve(false);
|
||||
});
|
||||
});
|
||||
}
|
||||
@@ -1,16 +0,0 @@
|
||||
{
|
||||
"extends": "../../tsconfig.base.json",
|
||||
"compilerOptions": {
|
||||
"target": "ES2022",
|
||||
"module": "NodeNext",
|
||||
"moduleResolution": "NodeNext",
|
||||
"outDir": "./dist",
|
||||
"rootDir": "./src",
|
||||
"strict": true,
|
||||
"esModuleInterop": true,
|
||||
"skipLibCheck": true,
|
||||
"forceConsistentCasingInFileNames": true,
|
||||
"noEmit": false
|
||||
},
|
||||
"include": ["src/**/*"]
|
||||
}
|
||||
@@ -14,7 +14,7 @@
|
||||
"test": "node --test \"test/**/*.test.mjs\""
|
||||
},
|
||||
"dependencies": {
|
||||
"commander": "^15.0.0",
|
||||
"commander": "^14.0.3",
|
||||
"prompts": "^2.4.2"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
||||
Generated
+69
-452
@@ -180,8 +180,8 @@ importers:
|
||||
specifier: 4.1.8
|
||||
version: 4.1.8([email protected])
|
||||
concurrently:
|
||||
specifier: ^10.0.3
|
||||
version: 10.0.3
|
||||
specifier: ^9.2.1
|
||||
version: 9.2.1
|
||||
copy-webpack-plugin:
|
||||
specifier: ^14.0.0
|
||||
version: 14.0.0([email protected]([email protected]))
|
||||
@@ -234,281 +234,11 @@ importers:
|
||||
specifier: ^4.1.7
|
||||
version: 4.1.8(@opentelemetry/[email protected])(@types/[email protected])(@vitest/[email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
|
||||
local-plugins/wwv-plugin-air-defense:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
devDependencies:
|
||||
'@types/node':
|
||||
specifier: ^22.0.0
|
||||
version: 22.19.19
|
||||
'@types/react':
|
||||
specifier: ^19.0.0
|
||||
version: 19.2.16
|
||||
typescript:
|
||||
specifier: ^5.0.0
|
||||
version: 5.9.3
|
||||
|
||||
local-plugins/wwv-plugin-airports:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
|
||||
local-plugins/wwv-plugin-aviation:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-lib-aviation':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-lib-aviation
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
lucide-react:
|
||||
specifier: '>=0.576.0'
|
||||
version: 1.17.0([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-borders:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
|
||||
local-plugins/wwv-plugin-camera:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
lucide-react:
|
||||
specifier: '>=0.576.0'
|
||||
version: 1.17.0([email protected])
|
||||
react:
|
||||
specifier: '>=18'
|
||||
version: 19.2.7
|
||||
|
||||
local-plugins/wwv-plugin-civil-unrest:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
cesium:
|
||||
specifier: ^1.139.0
|
||||
version: 1.142.0
|
||||
lucide-react:
|
||||
specifier: ^0.477.0
|
||||
version: 0.477.0([email protected])
|
||||
react:
|
||||
specifier: ^19.0.0
|
||||
version: 19.2.7
|
||||
resium:
|
||||
specifier: 1.19.4
|
||||
version: 1.19.4([email protected])([email protected]([email protected]))([email protected])
|
||||
devDependencies:
|
||||
'@vitejs/plugin-react':
|
||||
specifier: ^6.0.1
|
||||
version: 6.0.2([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
vite:
|
||||
specifier: ^8.0.8
|
||||
version: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-conflict-events:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-lib-incidents':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-lib-incidents
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
cesium:
|
||||
specifier: ^1.139.0
|
||||
version: 1.142.0
|
||||
lucide-react:
|
||||
specifier: ^0.477.0
|
||||
version: 0.477.0([email protected])
|
||||
react:
|
||||
specifier: ^19.0.0
|
||||
version: 19.2.7
|
||||
resium:
|
||||
specifier: 1.19.4
|
||||
version: 1.19.4([email protected])([email protected]([email protected]))([email protected])
|
||||
devDependencies:
|
||||
'@vitejs/plugin-react':
|
||||
specifier: ^6.0.1
|
||||
version: 6.0.2([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
vite:
|
||||
specifier: ^8.0.8
|
||||
version: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-cyber-attacks:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
lucide-react:
|
||||
specifier: ^1.14.0
|
||||
version: 1.17.0([email protected])
|
||||
devDependencies:
|
||||
'@vitejs/plugin-react':
|
||||
specifier: ^6.0.1
|
||||
version: 6.0.2([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
vite:
|
||||
specifier: ^8.0.8
|
||||
version: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-earthquakes:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-lib-incidents':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-lib-incidents
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: ^1.4.10
|
||||
version: 1.5.0([email protected])
|
||||
lucide-react:
|
||||
specifier: ^1.14.0
|
||||
version: 1.17.0([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-fortiguard:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
devDependencies:
|
||||
typescript:
|
||||
specifier: ^5.0.0
|
||||
version: 5.9.3
|
||||
|
||||
local-plugins/wwv-plugin-gps-jamming:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
cesium:
|
||||
specifier: ^1.139.0
|
||||
version: 1.142.0
|
||||
h3-js:
|
||||
specifier: ^4.4.0
|
||||
version: 4.4.0
|
||||
lucide-react:
|
||||
specifier: ^0.477.0
|
||||
version: 0.477.0([email protected])
|
||||
react:
|
||||
specifier: ^19.0.0
|
||||
version: 19.2.7
|
||||
resium:
|
||||
specifier: 1.19.4
|
||||
version: 1.19.4([email protected])([email protected]([email protected]))([email protected])
|
||||
devDependencies:
|
||||
'@vitejs/plugin-react':
|
||||
specifier: ^6.0.1
|
||||
version: 6.0.2([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
vite:
|
||||
specifier: ^8.0.8
|
||||
version: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-international-sanctions:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
lucide-react:
|
||||
specifier: ^1.14.0
|
||||
version: 1.17.0([email protected])
|
||||
devDependencies:
|
||||
'@vitejs/plugin-react':
|
||||
specifier: ^6.0.1
|
||||
version: 6.0.2([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
vite:
|
||||
specifier: ^8.0.8
|
||||
version: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-iranwarlive:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-lib-incidents':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-lib-incidents
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: ^1.4.10
|
||||
version: 1.5.0([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-maritime:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
lucide-react:
|
||||
specifier: '>=0.576.0'
|
||||
version: 1.17.0([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-military-aviation:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-lib-aviation':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-lib-aviation
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: ^1.4.10
|
||||
version: 1.5.0([email protected])
|
||||
lucide-react:
|
||||
specifier: '>=0.576.0'
|
||||
version: 1.17.0([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-nz-traffic-cameras:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
devDependencies:
|
||||
'@types/node':
|
||||
specifier: ^20.0.0
|
||||
version: 20.19.41
|
||||
typescript:
|
||||
specifier: ^5.0.0
|
||||
version: 5.9.3
|
||||
vitest:
|
||||
specifier: ^4.1.8
|
||||
version: 4.1.8(@opentelemetry/[email protected])(@types/[email protected])(@vitest/[email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
|
||||
local-plugins/wwv-plugin-satellite:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: ^1.4.10
|
||||
version: 1.5.0([email protected])
|
||||
|
||||
local-plugins/wwv-plugin-wildfire:
|
||||
dependencies:
|
||||
'@worldwideview/wwv-plugin-sdk':
|
||||
specifier: workspace:*
|
||||
version: link:../../packages/wwv-plugin-sdk
|
||||
lucide-react:
|
||||
specifier: '>=0.576.0'
|
||||
version: 1.17.0([email protected])
|
||||
|
||||
packages/wwv-ci-probe:
|
||||
packages/wwv-cli:
|
||||
dependencies:
|
||||
commander:
|
||||
specifier: ^14.0.3
|
||||
version: 14.0.3
|
||||
ioredis:
|
||||
specifier: ^5.4.1
|
||||
version: 5.11.0
|
||||
ws:
|
||||
specifier: ^8.18.0
|
||||
version: 8.21.0
|
||||
devDependencies:
|
||||
'@types/node':
|
||||
specifier: ^25.9.1
|
||||
version: 25.9.1
|
||||
'@types/ws':
|
||||
specifier: ^8.5.13
|
||||
version: 8.18.1
|
||||
typescript:
|
||||
specifier: ^5.0.0
|
||||
version: 5.9.3
|
||||
|
||||
packages/wwv-cli:
|
||||
dependencies:
|
||||
commander:
|
||||
specifier: ^15.0.0
|
||||
version: 15.0.0
|
||||
prompts:
|
||||
specifier: ^2.4.2
|
||||
version: 2.4.2
|
||||
@@ -2326,12 +2056,6 @@ packages:
|
||||
'@types/[email protected]':
|
||||
resolution: {integrity: sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==}
|
||||
|
||||
'@types/[email protected]':
|
||||
resolution: {integrity: sha512-ECymXOukMnOoVkC2bb1Vc/w/836DXncOg5m8Xj1RH7xSHZJWNYY6Zh7EH477vcnD5egKNNfy2RpNOmuChhFPgQ==}
|
||||
|
||||
'@types/[email protected]':
|
||||
resolution: {integrity: sha512-dyh/xO2Fh5bYrfWaaqGrRQQGkNdmYw6AmaAUvYeUMNTWQtvb796ikLdmTchRmOlOiIJ1TDXfWgVx1QkUlQ6Hew==}
|
||||
|
||||
'@types/[email protected]':
|
||||
resolution: {integrity: sha512-xfrlY7UD5rMJk3ZVJP8BNzS28J36YJg+xp+LPXV1TdWxr8uMH5A860QNxYDGQe/ylDSgjxE52Q9VnO7p75tJxg==}
|
||||
|
||||
@@ -2709,10 +2433,6 @@ packages:
|
||||
resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
|
||||
engines: {node: '>=8'}
|
||||
@@ -2721,10 +2441,6 @@ packages:
|
||||
resolution: {integrity: sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==}
|
||||
engines: {node: '>=10'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
|
||||
|
||||
@@ -2994,9 +2710,9 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==}
|
||||
|
||||
cliui@9.0.1:
|
||||
resolution: {integrity: sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==}
|
||||
engines: {node: '>=20'}
|
||||
cliui@8.0.1:
|
||||
resolution: {integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-zj9gjJa6xW8MNrfc4oKuwgGS0njRLpOlQjdifbuNxvy8k4Y3pKCyKCMG2XIsjd2iQGhgjS57b1P5VWdJlxcXBw==}
|
||||
@@ -3023,10 +2739,6 @@ packages:
|
||||
resolution: {integrity: sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==}
|
||||
engines: {node: '>=20'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==}
|
||||
engines: {node: '>=22.12.0'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==}
|
||||
|
||||
@@ -3036,9 +2748,9 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==}
|
||||
|
||||
concurrently@10.0.3:
|
||||
resolution: {integrity: sha512-hc3LH4UaKWd/bbyDK/IGVa4RB6PtQ3CUYwtrkzqHn+wIG3Hr5fhpRlk0L/gCa8ZE1L/Ufj50Zho69cI5w8SQBA==}
|
||||
engines: {node: '>=22'}
|
||||
concurrently@9.2.1:
|
||||
resolution: {integrity: sha512-fsfrO0MxV64Znoy8/l1vVIjjHa29SZyyqPgQBwhiDcaW8wJc2W3XWVOGx4M3oJBnv/zdUZIIp1gDeS98GzP8Ng==}
|
||||
engines: {node: '>=18'}
|
||||
hasBin: true
|
||||
|
||||
[email protected]:
|
||||
@@ -3275,6 +2987,9 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==}
|
||||
|
||||
@@ -3705,10 +3420,6 @@ packages:
|
||||
resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
|
||||
engines: {node: 6.* || 8.* || >= 10.*}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==}
|
||||
engines: {node: '>=18'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==}
|
||||
engines: {node: '>= 0.4'}
|
||||
@@ -3784,10 +3495,6 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-5ykVn/EXM1hF0XCaWh05VbYvEiOL2lY1kBxZtaYsyvjp7cmWOU1XsAdfQBwClraEofXDT197lFbXOEVMHpvQOg==}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-DvJh07MhGgY2KcC4OeZc8SSyA+ZXpdvoh6uCzGpoKvWtZxJB+g6VXXC1+eWYkaMIsLz7J/ErhOalHCpcs1KYog==}
|
||||
engines: {node: '>=4', npm: '>=3', yarn: '>=1.3.0'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-Oqluz6zhGX8cyRaTQlFMPw80bSJVG2x/cFb8ZPhUILGgHka9SsokCCOQgpveePerqidZOrT14ipqfJb7ILcW5Q==}
|
||||
engines: {node: '>=4'}
|
||||
@@ -3998,6 +3705,10 @@ packages:
|
||||
resolution: {integrity: sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==}
|
||||
engines: {node: '>= 0.4'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-upqt1SkGkODW9tsGNG5mtXTXtECizwtS2kA161M+gJPc1xdb/Ax629af6YrTwcOeQHbewrPNlE5Dx7kzvXTizA==}
|
||||
engines: {node: '>= 0.4'}
|
||||
@@ -4341,11 +4052,6 @@ packages:
|
||||
resolution: {integrity: sha512-DqC6n3QQ77zdFpCMASA1a3Jlb64Hv2N2DciFGkO/4L9+q/IpIAuRlKOvCXabtRW6cQf8usbmM6BE/TOPysCdIA==}
|
||||
engines: {bun: '>=1.0.0', deno: '>=1.30.0', node: '>=8.0.0'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-yCf7aYxerFZAbd8jHJxjwe1j7jEMPptjnaOqdYeirFnEy85cNR3/L+o0I875CYFYya+eEVzZSbNuRk8BZPDpVw==}
|
||||
peerDependencies:
|
||||
react: ^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-9FA9evdox/JQL5PT57fdA1x/yg8T7knJ98+zjTL3UfKza6pflQUUh3XtaQIHKvnsJw1lmsEyHVlt5jchYxOQ5w==}
|
||||
peerDependencies:
|
||||
@@ -4989,6 +4695,10 @@ packages:
|
||||
engines: {node: '>= 6'}
|
||||
deprecated: request has been deprecated, see https://github.com/request/request/issues/3142
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
@@ -4997,14 +4707,6 @@ packages:
|
||||
resolution: {integrity: sha512-QT7FVMXfWOYFbeRBF6nu+I6tr2Tf3u0q8RIEjNob/heKY/nh7drD/k7eeMFmSQgnTtCzLDcCu/XEnpW2wk4xCQ==}
|
||||
engines: {node: '>=9.3.0 || >=8.10.0 <9.0.0'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-RW0ffHlQUbgqbc0jDaF2Dnor/GKbiz5s5AKdamEKxMJfxiwQNgtgfaKK7UvafFpX25Y2J4DZP1MclTlEQ/5YUw==}
|
||||
engines: {node: '>=20.19.0'}
|
||||
peerDependencies:
|
||||
cesium: 1.x
|
||||
react: '>=18.2.0'
|
||||
react-dom: '>=18.2.0'
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-pR+ySBudmCstgYOBFY+qcPQt0+xPmsdhSkD3u7JBfaiHcx/pxyuigjYoL0ET7Ak2a2uZ7jEu47cdZKThZx8A5w==}
|
||||
engines: {node: '>=20.19.0'}
|
||||
@@ -5159,8 +4861,8 @@ packages:
|
||||
resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
[email protected].4:
|
||||
resolution: {integrity: sha512-VsC6n6vz1ihYYyZZwX7YZSF5l5x36ca17OC+a69h94YqB7X6XLwf+5MOgynYir2SLFUbl8gIYvBo8K8RoNQ6bQ==}
|
||||
[email protected].3:
|
||||
resolution: {integrity: sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw==}
|
||||
engines: {node: '>= 0.4'}
|
||||
|
||||
[email protected]:
|
||||
@@ -5256,9 +4958,9 @@ packages:
|
||||
resolution: {integrity: sha512-eLoXW/DHyl62zxY4SCaIgnRhuMr6ri4juEYARS8E6sCEqzKpOiE521Ucofdx+KnDZl5xmvGYaaKCk5FEOxJCoQ==}
|
||||
engines: {node: '>= 0.4'}
|
||||
|
||||
string-width@7.2.0:
|
||||
resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==}
|
||||
engines: {node: '>=18'}
|
||||
string-width@4.2.3:
|
||||
resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-o7+c9bW6zpAdJHTtujeePODAhkuicdAryFsfVKwA+wGw89wJ4GTY484WTucM9hLtDEOpOvI+aHnzqnC5lHp4Rg==}
|
||||
@@ -5286,9 +4988,9 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
|
||||
|
||||
strip-ansi@7.2.0:
|
||||
resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==}
|
||||
engines: {node: '>=12'}
|
||||
strip-ansi@6.0.1:
|
||||
resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==}
|
||||
@@ -5331,10 +5033,6 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-9pP/CVNp4NF2MNlRzLwQkjiTgKKe9WYXrLh9+8QokWmMxz+zt2mf1utkWLco26IuA3AfVcTb//qtlTIjY3VHxA==}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==}
|
||||
engines: {node: '>=18'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
|
||||
engines: {node: '>=8'}
|
||||
@@ -5558,9 +5256,6 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-DXtD3ZtEQzc7M8m4cXotyHR+FAS18C64asBYY5vqZexfYryNNnDc02W4hKg3rdQuqOYas1jkseX0+nZXjTXnvQ==}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==}
|
||||
|
||||
@@ -5800,9 +5495,9 @@ packages:
|
||||
resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
|
||||
wrap-ansi@9.0.2:
|
||||
resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==}
|
||||
engines: {node: '>=18'}
|
||||
wrap-ansi@7.0.0:
|
||||
resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
|
||||
engines: {node: '>=10'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
|
||||
@@ -5837,13 +5532,13 @@ packages:
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}
|
||||
|
||||
yargs-parser@22.0.0:
|
||||
resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==}
|
||||
engines: {node: ^20.19.0 || ^22.12.0 || >=23}
|
||||
yargs-parser@21.1.1:
|
||||
resolution: {integrity: sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
yargs@18.0.0:
|
||||
resolution: {integrity: sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==}
|
||||
engines: {node: ^20.19.0 || ^22.12.0 || >=23}
|
||||
yargs@17.7.2:
|
||||
resolution: {integrity: sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
[email protected]:
|
||||
resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
|
||||
@@ -7620,14 +7315,6 @@ snapshots:
|
||||
|
||||
'@types/[email protected]': {}
|
||||
|
||||
'@types/[email protected]':
|
||||
dependencies:
|
||||
undici-types: 6.21.0
|
||||
|
||||
'@types/[email protected]':
|
||||
dependencies:
|
||||
undici-types: 6.21.0
|
||||
|
||||
'@types/[email protected]':
|
||||
dependencies:
|
||||
undici-types: 7.24.6
|
||||
@@ -7852,14 +7539,6 @@ snapshots:
|
||||
chai: 6.2.2
|
||||
tinyrainbow: 3.1.0
|
||||
|
||||
'@vitest/[email protected]([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))':
|
||||
dependencies:
|
||||
'@vitest/spy': 4.1.8
|
||||
estree-walker: 3.0.3
|
||||
magic-string: 0.30.21
|
||||
optionalDependencies:
|
||||
vite: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
|
||||
'@vitest/[email protected]([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))':
|
||||
dependencies:
|
||||
'@vitest/spy': 4.1.8
|
||||
@@ -8043,16 +7722,12 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
dependencies:
|
||||
color-convert: 2.0.1
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
@@ -8381,11 +8056,11 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
cliui@9.0.1:
|
||||
cliui@8.0.1:
|
||||
dependencies:
|
||||
string-width: 7.2.0
|
||||
strip-ansi: 7.2.0
|
||||
wrap-ansi: 9.0.2
|
||||
string-width: 4.2.3
|
||||
strip-ansi: 6.0.1
|
||||
wrap-ansi: 7.0.0
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
@@ -8405,22 +8080,20 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
concurrently@10.0.3:
|
||||
concurrently@9.2.1:
|
||||
dependencies:
|
||||
chalk: 5.6.2
|
||||
chalk: 4.1.2
|
||||
rxjs: 7.8.2
|
||||
shell-quote: 1.8.4
|
||||
supports-color: 10.2.2
|
||||
shell-quote: 1.8.3
|
||||
supports-color: 8.1.1
|
||||
tree-kill: 1.2.2
|
||||
yargs: 18.0.0
|
||||
yargs: 17.7.2
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
@@ -8667,6 +8340,8 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
@@ -9291,8 +8966,6 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
dependencies:
|
||||
call-bind-apply-helpers: 1.0.2
|
||||
@@ -9372,8 +9045,6 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
@@ -9603,6 +9274,8 @@ snapshots:
|
||||
dependencies:
|
||||
call-bound: 1.0.4
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
dependencies:
|
||||
call-bound: 1.0.4
|
||||
@@ -9912,10 +9585,6 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]([email protected]):
|
||||
dependencies:
|
||||
react: 19.2.7
|
||||
|
||||
[email protected]([email protected]):
|
||||
dependencies:
|
||||
react: 19.2.7
|
||||
@@ -10578,6 +10247,8 @@ snapshots:
|
||||
tunnel-agent: 0.6.0
|
||||
uuid: 3.4.0
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
@@ -10587,12 +10258,6 @@ snapshots:
|
||||
transitivePeerDependencies:
|
||||
- supports-color
|
||||
|
||||
[email protected]([email protected])([email protected]([email protected]))([email protected]):
|
||||
dependencies:
|
||||
cesium: 1.142.0
|
||||
react: 19.2.7
|
||||
react-dom: 19.2.7([email protected])
|
||||
|
||||
[email protected]([email protected])([email protected]([email protected]))([email protected]):
|
||||
dependencies:
|
||||
cesium: 1.142.0
|
||||
@@ -10842,7 +10507,7 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected].4: {}
|
||||
[email protected].3: {}
|
||||
|
||||
[email protected]:
|
||||
dependencies:
|
||||
@@ -10940,11 +10605,11 @@ snapshots:
|
||||
es-errors: 1.3.0
|
||||
internal-slot: 1.1.0
|
||||
|
||||
string-width@7.2.0:
|
||||
string-width@4.2.3:
|
||||
dependencies:
|
||||
emoji-regex: 10.6.0
|
||||
get-east-asian-width: 1.6.0
|
||||
strip-ansi: 7.2.0
|
||||
emoji-regex: 8.0.0
|
||||
is-fullwidth-code-point: 3.0.0
|
||||
strip-ansi: 6.0.1
|
||||
|
||||
[email protected]:
|
||||
dependencies:
|
||||
@@ -11001,9 +10666,9 @@ snapshots:
|
||||
safe-buffer: 5.2.1
|
||||
optional: true
|
||||
|
||||
strip-ansi@7.2.0:
|
||||
strip-ansi@6.0.1:
|
||||
dependencies:
|
||||
ansi-regex: 6.2.2
|
||||
ansi-regex: 5.0.1
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
@@ -11027,8 +10692,6 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]:
|
||||
dependencies:
|
||||
has-flag: 4.0.0
|
||||
@@ -11236,8 +10899,6 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
[email protected]: {}
|
||||
@@ -11320,21 +10981,6 @@ snapshots:
|
||||
'@vimeo/player': 2.29.0
|
||||
media-played-ranges-mixin: 0.1.0
|
||||
|
||||
[email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]):
|
||||
dependencies:
|
||||
lightningcss: 1.32.0
|
||||
picomatch: 4.0.4
|
||||
postcss: 8.5.15
|
||||
rolldown: 1.0.3
|
||||
tinyglobby: 0.2.17
|
||||
optionalDependencies:
|
||||
'@types/node': 20.19.41
|
||||
esbuild: 0.28.0
|
||||
fsevents: 2.3.3
|
||||
jiti: 2.7.0
|
||||
terser: 5.48.0
|
||||
tsx: 4.22.4
|
||||
|
||||
[email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]):
|
||||
dependencies:
|
||||
lightningcss: 1.32.0
|
||||
@@ -11350,36 +10996,6 @@ snapshots:
|
||||
terser: 5.48.0
|
||||
tsx: 4.22.4
|
||||
|
||||
[email protected](@opentelemetry/[email protected])(@types/[email protected])(@vitest/[email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected])):
|
||||
dependencies:
|
||||
'@vitest/expect': 4.1.8
|
||||
'@vitest/mocker': 4.1.8([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected]))
|
||||
'@vitest/pretty-format': 4.1.8
|
||||
'@vitest/runner': 4.1.8
|
||||
'@vitest/snapshot': 4.1.8
|
||||
'@vitest/spy': 4.1.8
|
||||
'@vitest/utils': 4.1.8
|
||||
es-module-lexer: 2.1.0
|
||||
expect-type: 1.3.0
|
||||
magic-string: 0.30.21
|
||||
obug: 2.1.1
|
||||
pathe: 2.0.3
|
||||
picomatch: 4.0.4
|
||||
std-env: 4.1.0
|
||||
tinybench: 2.9.0
|
||||
tinyexec: 1.2.4
|
||||
tinyglobby: 0.2.17
|
||||
tinyrainbow: 3.1.0
|
||||
vite: 8.0.16(@types/[email protected])([email protected])([email protected])([email protected])([email protected])
|
||||
why-is-node-running: 2.3.0
|
||||
optionalDependencies:
|
||||
'@opentelemetry/api': 1.9.1
|
||||
'@types/node': 20.19.41
|
||||
'@vitest/coverage-v8': 4.1.8([email protected])
|
||||
jsdom: 28.1.0
|
||||
transitivePeerDependencies:
|
||||
- msw
|
||||
|
||||
[email protected](@opentelemetry/[email protected])(@types/[email protected])(@vitest/[email protected])([email protected])([email protected](@types/[email protected])([email protected])([email protected])([email protected])([email protected])):
|
||||
dependencies:
|
||||
'@vitest/expect': 4.1.8
|
||||
@@ -11547,11 +11163,11 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
wrap-ansi@9.0.2:
|
||||
wrap-ansi@7.0.0:
|
||||
dependencies:
|
||||
ansi-styles: 6.2.3
|
||||
string-width: 7.2.0
|
||||
strip-ansi: 7.2.0
|
||||
ansi-styles: 4.3.0
|
||||
string-width: 4.2.3
|
||||
strip-ansi: 6.0.1
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
@@ -11567,16 +11183,17 @@ snapshots:
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
yargs-parser@22.0.0: {}
|
||||
yargs-parser@21.1.1: {}
|
||||
|
||||
yargs@18.0.0:
|
||||
yargs@17.7.2:
|
||||
dependencies:
|
||||
cliui: 9.0.1
|
||||
cliui: 8.0.1
|
||||
escalade: 3.2.0
|
||||
get-caller-file: 2.0.5
|
||||
string-width: 7.2.0
|
||||
require-directory: 2.1.1
|
||||
string-width: 4.2.3
|
||||
y18n: 5.0.8
|
||||
yargs-parser: 22.0.0
|
||||
yargs-parser: 21.1.1
|
||||
|
||||
[email protected]: {}
|
||||
|
||||
|
||||
+7
-40
@@ -148,9 +148,6 @@ const ANTI_PATTERNS = [
|
||||
tier: 'A',
|
||||
globs: ['*.ts', '*.tsx'],
|
||||
pattern: '@ts-ignore',
|
||||
// Only flag the actual suppression directive form (// @ts-ignore or /* @ts-ignore),
|
||||
// not the token appearing in JSDoc prose (e.g. "No @ts-ignore used here").
|
||||
directiveOnly: true,
|
||||
desc: '@ts-ignore suppresses real type errors — remove and fix the underlying type',
|
||||
},
|
||||
{
|
||||
@@ -158,7 +155,6 @@ const ANTI_PATTERNS = [
|
||||
tier: 'A',
|
||||
globs: ['*.ts', '*.tsx'],
|
||||
pattern: '@ts-nocheck',
|
||||
directiveOnly: true,
|
||||
desc: '@ts-nocheck disables all type checking for the file — remove and fix types',
|
||||
},
|
||||
{
|
||||
@@ -179,7 +175,7 @@ const ANTI_PATTERNS = [
|
||||
];
|
||||
|
||||
function detectAntiPatterns() {
|
||||
for (const { id, tier, globs, pattern, desc, excludePrefix, directiveOnly } of ANTI_PATTERNS) {
|
||||
for (const { id, tier, globs, pattern, desc, excludePrefix } of ANTI_PATTERNS) {
|
||||
const globArgs = globs.map(g => `"${g}"`).join(' ');
|
||||
const raw = run(`git grep -En "${pattern}" -- ${globArgs}`);
|
||||
if (!raw) continue;
|
||||
@@ -193,19 +189,13 @@ function detectAntiPatterns() {
|
||||
const m = line.match(/^([^:]+):(\d+):(.*)/);
|
||||
if (!m) continue;
|
||||
if (m[1].startsWith('node_modules/') || m[1].includes('public/cesium')) continue;
|
||||
const content = m[3].trim();
|
||||
// For directive-only patterns (e.g. @ts-ignore), skip lines where the token
|
||||
// appears in prose rather than as a comment suppression directive.
|
||||
// A real directive has @ts-ignore/@ts-nocheck immediately after the // or /*
|
||||
// comment opener — not buried mid-sentence in a comment that mentions it.
|
||||
if (directiveOnly && !/^\s*\/[/*]\s*@ts-(ignore|nocheck)/.test(m[3])) continue;
|
||||
add({
|
||||
type: 'anti-pattern',
|
||||
patternId: id,
|
||||
tier,
|
||||
file: m[1],
|
||||
line: parseInt(m[2], 10),
|
||||
content: content.slice(0, 200),
|
||||
content: m[3].trim().slice(0, 200),
|
||||
description: desc,
|
||||
});
|
||||
}
|
||||
@@ -316,36 +306,13 @@ function detectOutdatedDeps() {
|
||||
if (!existsSync(join(ROOT, 'package.json'))) return;
|
||||
const raw = run('pnpm outdated --no-color 2>/dev/null || true');
|
||||
if (!raw) return;
|
||||
// pnpm outdated renders a Unicode box-drawing table. Data rows start with │ and
|
||||
// contain pipe-separated columns; separator/border rows contain ─ or ┼ characters.
|
||||
// We extract data rows by splitting on │ and discarding header/separator lines.
|
||||
const SEPARATOR_CHARS = /[┌┐└┘├┤─]/;
|
||||
const tableDataRows = raw
|
||||
const dataLines = raw
|
||||
.split('\n')
|
||||
.filter(l => l.startsWith('│') && !SEPARATOR_CHARS.test(l));
|
||||
// Fall back to plain whitespace-separated output (older pnpm / --no-color plain format)
|
||||
const plainDataLines = !tableDataRows.length
|
||||
? raw.split('\n').filter(l => l.trim() && !l.startsWith('Package') && !l.startsWith('Legend') && !l.startsWith(' '))
|
||||
: [];
|
||||
|
||||
const dataLines = tableDataRows.length ? tableDataRows : plainDataLines;
|
||||
|
||||
.filter(l => l.trim() && !l.startsWith('Package') && !l.startsWith('Legend') && !l.startsWith(' '));
|
||||
for (const line of dataLines.slice(0, 12)) {
|
||||
let pkg, current, latest;
|
||||
if (tableDataRows.length) {
|
||||
// Parse │ col1 │ col2 │ col3 │ format
|
||||
const cols = line.split('│').map(c => c.trim()).filter(Boolean);
|
||||
if (cols.length < 3) continue;
|
||||
// Header row: first column is literally "Package"
|
||||
if (cols[0] === 'Package') continue;
|
||||
[pkg, current, latest] = cols;
|
||||
// current may be "1.2.3 (wanted 1.2.4)" — extract just the installed version
|
||||
current = current.split(' ')[0];
|
||||
} else {
|
||||
const cols = line.trim().split(/\s+/);
|
||||
if (cols.length < 3) continue;
|
||||
[pkg, current, latest] = cols;
|
||||
}
|
||||
const cols = line.trim().split(/\s+/);
|
||||
if (cols.length < 3) continue;
|
||||
const [pkg, current, latest] = cols;
|
||||
if (!pkg || !current || !latest || current === latest) continue;
|
||||
const isMajor = current.replace(/^[^0-9]*/, '').split('.')[0] !== latest.replace(/^[^0-9]*/, '').split('.')[0];
|
||||
add({
|
||||
|
||||
@@ -375,53 +375,3 @@ describe("validateManifest no execution field required (MAN-04)", () => {
|
||||
expect(hasExecutionError).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// SEC-URL: entry URL allowlist must host-match the PARSED hostname.
|
||||
// Substring checks (includes / startsWith on the raw string) are bypassable
|
||||
// and would allow an attacker-controlled origin to serve the imported bundle.
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
describe("validateManifest entry URL allowlist (security)", () => {
|
||||
const ERR =
|
||||
"entry URL must be a relative path, CDN, localhost, or worldwideview.dev domain";
|
||||
|
||||
const accepts = (entry: string) => {
|
||||
const result = validateManifest(baseManifest({ entry }));
|
||||
expect(result.errors, `expected "${entry}" to be accepted`).not.toContain(ERR);
|
||||
};
|
||||
const rejects = (entry: string) => {
|
||||
const result = validateManifest(baseManifest({ entry }));
|
||||
expect(result.errors, `expected "${entry}" to be rejected`).toContain(ERR);
|
||||
};
|
||||
|
||||
it("accepts relative and exact known-host absolute entries", () => {
|
||||
accepts("/plugins/test/frontend.mjs");
|
||||
accepts("./frontend.mjs");
|
||||
accepts("https://unpkg.com/@wwv/plugin/frontend.mjs");
|
||||
accepts("https://cdn.jsdelivr.net/npm/@wwv/plugin/frontend.mjs");
|
||||
accepts("https://marketplace.worldwideview.dev/p/frontend.mjs");
|
||||
accepts("https://worldwideview.dev/p/frontend.mjs");
|
||||
accepts("http://localhost:3000/plugins/x/frontend.mjs");
|
||||
accepts("http://127.0.0.1:5000/plugins/x/frontend.mjs");
|
||||
accepts("http://[::1]:5000/plugins/x/frontend.mjs");
|
||||
});
|
||||
|
||||
it("rejects substring-bypass hostnames the old check allowed", () => {
|
||||
rejects("https://unpkg.com.evil.com/frontend.mjs");
|
||||
rejects("https://cdn.jsdelivr.net.evil.com/frontend.mjs");
|
||||
rejects("https://sub.worldwideview.dev.evil.com/frontend.mjs");
|
||||
rejects("https://evil.com/#.worldwideview.dev");
|
||||
rejects("https://evil.com/?x=.worldwideview.dev");
|
||||
rejects("http://localhost.evil.com/frontend.mjs");
|
||||
rejects("https://hacker.com/malicious.js");
|
||||
});
|
||||
|
||||
it("rejects protocol-relative, slash-backslash, userinfo and non-http(s) scheme tricks", () => {
|
||||
rejects("//evil.com/frontend.mjs");
|
||||
rejects("/\\evil.com/frontend.mjs");
|
||||
rejects("https://[email protected]/frontend.mjs");
|
||||
rejects("javascript:alert(1)");
|
||||
rejects("data:text/javascript,alert(1)");
|
||||
});
|
||||
});
|
||||
@@ -86,41 +86,25 @@ export function validateManifest(
|
||||
errors.push("Missing required field: entry");
|
||||
} else {
|
||||
const entry = manifest.entry.trim();
|
||||
// A relative path starts with "/" or "./". Reject protocol-relative
|
||||
// ("//host") and slash-backslash ("/\\host") forms: they start with "/"
|
||||
// but resolve to an EXTERNAL origin when import()-ed.
|
||||
const isRelative =
|
||||
entry.startsWith("./") ||
|
||||
(entry.startsWith("/") && entry[1] !== "/" && entry[1] !== "\\");
|
||||
const isRelative = entry.startsWith("/") || entry.startsWith("./");
|
||||
const isLocal = entry.startsWith("http://localhost") || entry.startsWith("http://127.0.0.1");
|
||||
const isWWV = entry.includes(".worldwideview.dev");
|
||||
const isCDN = entry.startsWith("https://cdn.jsdelivr.net") || entry.startsWith("https://unpkg.com");
|
||||
|
||||
// Absolute entry URLs are host-matched against an allowlist using the
|
||||
// PARSED hostname. Substring checks on the raw string (includes /
|
||||
// startsWith) are bypassable, e.g. "https://unpkg.com.evil.com/x.mjs"
|
||||
// or "https://sub.worldwideview.dev.evil.com/x.mjs", which would let an
|
||||
// attacker-controlled origin serve the dynamically imported bundle (RCE).
|
||||
let isAllowedHost = false;
|
||||
if (!isRelative) {
|
||||
// Accept bundles served from a configured marketplace/instance host
|
||||
// (e.g. marketplace.wwv.local) derived from env, so custom deployment
|
||||
// hostnames work without being hardcoded.
|
||||
let isConfiguredHost = false;
|
||||
if (ENV_ALLOWED_ENTRY_HOSTS.size > 0) {
|
||||
try {
|
||||
const url = new URL(entry);
|
||||
const host = url.hostname;
|
||||
const isSecure = url.protocol === "https:";
|
||||
const isLocalhost =
|
||||
(url.protocol === "http:" || isSecure) &&
|
||||
(host === "localhost" || host === "127.0.0.1" || host === "[::1]");
|
||||
const isWWV =
|
||||
isSecure &&
|
||||
(host === "worldwideview.dev" || host.endsWith(".worldwideview.dev"));
|
||||
const isCDN = isSecure && (host === "cdn.jsdelivr.net" || host === "unpkg.com");
|
||||
// Operator-configured hosts (from NEXT_PUBLIC_*MARKETPLACE_URL) are an
|
||||
// explicit deployment opt-in, so their protocol is trusted as set.
|
||||
const isConfiguredHost = ENV_ALLOWED_ENTRY_HOSTS.has(host);
|
||||
isAllowedHost = isLocalhost || isWWV || isCDN || isConfiguredHost;
|
||||
isConfiguredHost = ENV_ALLOWED_ENTRY_HOSTS.has(new URL(entry).hostname);
|
||||
} catch {
|
||||
// Not a parseable absolute URL and not relative: rejected below.
|
||||
// Relative paths and other non-absolute entries aren't parseable
|
||||
// as full URLs — they're already covered by `isRelative`.
|
||||
}
|
||||
}
|
||||
|
||||
if (!isRelative && !isAllowedHost) {
|
||||
if (!isRelative && !isLocal && !isWWV && !isCDN && !isConfiguredHost) {
|
||||
errors.push("entry URL must be a relative path, CDN, localhost, or worldwideview.dev domain");
|
||||
}
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user