Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -1,9 +1,10 @@
import type { EnvVariableDefinition, RuntimeTarget } from "./types.js";
const allTargets = ["shared", "web", "api", "worker"] as const satisfies readonly RuntimeTarget[];
const allTargets = ["shared", "web", "api", "mcp", "worker"] as const satisfies readonly RuntimeTarget[];
const webApiTargets = ["web", "api"] as const satisfies readonly RuntimeTarget[];
const apiWorkerTargets = ["api", "worker"] as const satisfies readonly RuntimeTarget[];
const webApiWorkerTargets = ["web", "api", "worker"] as const satisfies readonly RuntimeTarget[];
const webApiMcpWorkerTargets = ["web", "api", "mcp", "worker"] as const satisfies readonly RuntimeTarget[];
export const envVariableDefinitions = [
{
@@ -136,12 +137,81 @@ export const envVariableDefinitions = [
name: "API_KEY_LEGACY_PLAINTEXT_FALLBACK",
description: "Temporary cutover switch for legacy plaintext API-key lookup after hash metadata backfill.",
classification: "production-only",
targets: webApiTargets,
targets: ["web", "api", "mcp"],
kind: "string",
source: "code-and-example",
defaultValue: "false",
notes: "Set to true only for a bounded migration window while validating pre-backfill API keys.",
},
{
name: "API_KEY_HASH_SECRET",
description: "Optional HMAC secret used to hash legacy API keys during lookup and migration.",
classification: "production-only",
targets: ["web", "api", "mcp"],
kind: "secret",
source: "code-and-example",
notes: "When unset, legacy lookup falls back to the built-in v1 key namespace; set this during the API-key hash backfill and keep it stable afterward.",
},
{
name: "LAGO_API_URL",
description: "Base URL for the self-hosted Lago API used by HiveGrid billing sync.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "url",
source: "code-and-example",
notes: "Staging uses the Lago API service reachable from the deployment network or SSH tunnel. Do not include /api/v1; the Lago gateway appends it.",
},
{
name: "LAGO_API_KEY",
description: "Bearer token for the Lago API.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "secret",
source: "code-and-example",
},
{
name: "LAGO_WEBHOOK_SECRET",
description: "Shared secret used to validate Lago webhook delivery once BILL-05 enables inbound sync.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "secret",
source: "code-and-example",
},
{
name: "LAGO_TIMEOUT_MS",
description: "HTTP timeout for Lago API calls.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "string",
source: "code-and-example",
defaultValue: "10000",
},
{
name: "MOLLIE_API_KEY",
description: "Mollie API key used for payment checkout and webhook verification.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "secret",
source: "code-and-example",
notes: "Use a Mollie testmode key in staging. Webhooks and admin manual sync are verified by refetching the payment through Mollie with this key.",
},
{
name: "MOLLIE_PROFILE_ID",
description: "Optional Mollie website profile id used when creating payments.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "string",
source: "code-and-example",
},
{
name: "MOLLIE_TIMEOUT_MS",
description: "HTTP timeout for Mollie API calls.",
classification: "optional-provider",
targets: webApiWorkerTargets,
kind: "string",
source: "code-and-example",
defaultValue: "10000",
},
{
name: "NODE_ENV",
description: "Runtime mode supplied by Node, React Router or deployment platform.",
@@ -177,6 +247,75 @@ export const envVariableDefinitions = [
source: "runtime",
defaultValue: "3001",
},
{
name: "MCP_HOST",
description: "HTTP listen host for the standalone MCP runtime.",
classification: "production-only",
targets: ["mcp"],
kind: "string",
source: "code-and-example",
defaultValue: "0.0.0.0",
},
{
name: "MCP_PORT",
description: "HTTP listen port for the standalone MCP runtime.",
classification: "production-only",
targets: ["mcp"],
kind: "string",
source: "code-and-example",
defaultValue: "8080",
},
{
name: "MCP_ALLOWED_HOSTS",
description: "Comma-separated host allowlist for Streamable HTTP DNS rebinding protection.",
classification: "required-per-app",
targets: ["mcp"],
kind: "string",
source: "code-and-example",
requiredInProduction: true,
defaultValue: "mcp.hivegrid.de,staging-mcp.hivegrid.de,localhost,127.0.0.1,::1",
},
{
name: "MCP_ALLOWED_ORIGINS",
description: "Comma-separated Origin allowlist for Streamable HTTP DNS rebinding protection.",
classification: "required-per-app",
targets: ["mcp"],
kind: "string",
source: "code-and-example",
requiredInProduction: true,
defaultValue: "https://mcp.hivegrid.de,https://staging-mcp.hivegrid.de,http://localhost,http://127.0.0.1",
},
{
name: "MCP_RESOURCE_URL",
description: "Public OAuth protected-resource origin for the standalone MCP runtime.",
classification: "required-per-app",
targets: ["web", "mcp"],
kind: "url",
source: "code-and-example",
requiredInProduction: true,
defaultValue: "https://mcp.hivegrid.de",
notes: "Use https://staging-mcp.hivegrid.de in staging. MCP is host-root only; do not append /mcp.",
},
{
name: "MCP_AUTHORIZATION_SERVER_URL",
description: "Public OAuth authorization-server origin for MCP client onboarding.",
classification: "required-per-app",
targets: ["web", "mcp"],
kind: "url",
source: "code-and-example",
requiredInProduction: true,
defaultValue: "https://app.hivegrid.de",
notes: "Use https://staging-app.hivegrid.de in staging.",
},
{
name: "MCP_OAUTH_TOKEN_HASH_SECRET",
description: "Optional HMAC secret for hash-only MCP OAuth authorization codes and bearer tokens.",
classification: "production-only",
targets: ["web", "mcp"],
kind: "secret",
source: "code-and-example",
notes: "When unset, MCP OAuth reuses API_KEY_HASH_SECRET so web and mcp can validate the same token hashes.",
},
{
name: "WEB_ORIGIN",
description: "Optional explicit web application origin allowed by API CORS and used as a worker workflow bridge fallback.",
@@ -251,7 +390,7 @@ export const envVariableDefinitions = [
name: "STORAGE_PROVIDER",
description: "Primary storage provider for runtime uploads.",
classification: "optional-provider",
targets: webApiWorkerTargets,
targets: webApiMcpWorkerTargets,
kind: "string",
source: "code-and-example",
notes: "Use s3 in production. Local is intended for explicit development or staging fallback only.",
@@ -344,32 +483,6 @@ export const envVariableDefinitions = [
kind: "url",
source: "code-and-example",
},
{
name: "STRIPE_SK",
description: "Stripe secret key for billing and portal integrations.",
classification: "optional-provider",
targets: webApiTargets,
kind: "secret",
source: "code-and-example",
},
{
name: "STRIPE_WEBHOOK_SIGNING_SECRET",
description: "Stripe webhook signature secret.",
classification: "optional-provider",
targets: webApiTargets,
kind: "secret",
source: "code-and-example",
},
{
name: "STRIPE_ACCOUNT_COUNTRY",
description: "Expected Stripe account country for billing operations.",
classification: "production-only",
targets: webApiTargets,
kind: "string",
source: "example",
defaultValue: "US",
notes: "Set this to the country configured for the production Stripe account.",
},
{
name: "MAILJET_WEBHOOK_SECRET",
description: "Shared secret for Basic-Auth authentication of inbound Mailjet event webhook attempts.",
@@ -478,6 +591,79 @@ export const envVariableDefinitions = [
kind: "string",
source: "code-and-example",
},
{
name: "CAPTCHA_PROVIDER",
description: "Self-hosted captcha provider. Defaults to mcaptcha; set to cap to use Cap Standalone.",
classification: "optional-provider",
targets: ["web"],
kind: "string",
source: "code-and-example",
defaultValue: "mcaptcha",
},
{
name: "CAP_INSTANCE_URL",
description: "Base URL of the self-hosted Cap Standalone instance (e.g. https://captcha.hivegrid.de).",
classification: "optional-provider",
targets: ["web"],
kind: "string",
source: "code-and-example",
},
{
name: "CAP_SITE_SECRET",
description: "Fallback Cap site secret for server-side siteverify when per-surface secrets are not set.",
classification: "optional-provider",
targets: ["web"],
kind: "secret",
source: "code-and-example",
},
{
name: "CAP_SITE_SECRET_LOGIN",
description: "Cap site secret for the login surface.",
classification: "optional-provider",
targets: ["web"],
kind: "secret",
source: "code-and-example",
},
{
name: "CAP_SITE_SECRET_FORMS",
description: "Cap site secret for public form submissions.",
classification: "optional-provider",
targets: ["web"],
kind: "secret",
source: "code-and-example",
},
{
name: "CAP_SITE_SECRET_BOOKING",
description: "Cap site secret for public booking pages.",
classification: "optional-provider",
targets: ["web"],
kind: "secret",
source: "code-and-example",
},
{
name: "CAP_SITEKEY_LOGIN",
description: "Cap public sitekey for the login surface.",
classification: "optional-provider",
targets: ["web"],
kind: "string",
source: "code-and-example",
},
{
name: "CAP_SITEKEY_FORMS",
description: "Cap public sitekey for public form submissions.",
classification: "optional-provider",
targets: ["web"],
kind: "string",
source: "code-and-example",
},
{
name: "CAP_SITEKEY_BOOKING",
description: "Cap public sitekey for public booking pages.",
classification: "optional-provider",
targets: ["web"],
kind: "string",
source: "code-and-example",
},
{
name: "MCAPTCHA_INSTANCE_URL",
description: "Base URL of the self-hosted mCaptcha instance (e.g. https://captcha.tool-ctrl.de).",
@@ -642,7 +828,7 @@ export const envVariableDefinitions = [
targets: ["worker"],
kind: "string",
source: "code",
defaultValue: "toolctrl.email",
defaultValue: "hivegrid.email",
notes: "Leave unset unless the worker and enqueue side are intentionally deployed with a non-default queue name.",
},
{
@@ -652,7 +838,7 @@ export const envVariableDefinitions = [
targets: ["worker"],
kind: "string",
source: "code",
defaultValue: "toolctrl.workflows",
defaultValue: "hivegrid.workflows",
notes: "Leave unset unless the worker and enqueue side are intentionally deployed with a non-default queue name.",
},
{
@@ -741,7 +927,7 @@ export const envVariableDefinitions = [
kind: "string",
source: "code-and-example",
defaultValue: "false",
notes: "Set to exactly true only with IMPORT_QUEUE_ENABLED=true after the worker runtime can process toolctrl.imports/toolctrl.exports end to end.",
notes: "Set to exactly true only with IMPORT_QUEUE_ENABLED=true after the worker runtime can process hivegrid.imports/hivegrid.exports end to end.",
},
{
name: "OUTBOX_DISPATCHER_ENABLED",
@@ -845,12 +1031,12 @@ export const envVariableDefinitions = [
},
{
name: "REDIS_URL",
description: "Fallback Redis connection URL for queue-backed web/API enqueue and worker processing.",
description: "Fallback Redis connection URL for queue-backed web/API enqueue, MCP rate limits and worker processing.",
classification: "optional-provider",
targets: webApiWorkerTargets,
targets: webApiMcpWorkerTargets,
kind: "url",
source: "code",
notes: "Used only when BULLMQ_REDIS_URL is absent; supports deployment platforms that already provide REDIS_URL.",
notes: "Used when BULLMQ_REDIS_URL is absent for queue code and directly by shared-store runtimes such as MCP rate limiting.",
},
{
name: "CACHE_INVALIDATION_ENABLED",
@@ -907,7 +1093,7 @@ export const envVariableDefinitions = [
source: "code-and-example",
},
{
name: "TOOLCTRL_API_MAINTENANCE_MODE",
name: "HIVEGRID_API_MAINTENANCE_MODE",
description: "API maintenance-mode switch; set to 1 to return a maintenance response from non-health API routes.",
classification: "production-only",
targets: ["api"],
@@ -916,7 +1102,7 @@ export const envVariableDefinitions = [
defaultValue: "0",
},
{
name: "TOOLCTRL_API_MAINTENANCE_RETRY_AFTER_SECONDS",
name: "HIVEGRID_API_MAINTENANCE_RETRY_AFTER_SECONDS",
description: "Optional Retry-After value for API maintenance responses.",
classification: "production-only",
targets: ["api"],
@@ -1151,7 +1337,7 @@ export const envVariableDefinitions = [
},
{
name: "SENTRY_DSN_API",
description: "Optional Sentry DSN dedicated to the API process (boilerplate-api project).",
description: "Optional Sentry DSN dedicated to the API process (hivegrid-api project).",
classification: "optional-provider",
targets: ["api"],
kind: "secret",
@@ -1160,7 +1346,7 @@ export const envVariableDefinitions = [
},
{
name: "SENTRY_DSN_WORKER",
description: "Optional Sentry DSN dedicated to the BullMQ worker process (boilerplate-worker project).",
description: "Optional Sentry DSN dedicated to the BullMQ worker process (hivegrid-worker project).",
classification: "optional-provider",
targets: ["worker"],
kind: "secret",
@@ -1329,7 +1515,7 @@ export const envVariableDefinitions = [
targets: ["web"],
kind: "string",
source: "code-and-example",
notes: "Defaults to boilerplate-web when omitted.",
notes: "Defaults to hivegrid-web when omitted.",
},
{
name: "SENTRY_DSN_WEB",
@@ -1360,7 +1546,7 @@ export const envVariableDefinitions = [
},
{
name: "SENTRY_PROJECT",
description: "Sentry project slug for the web app (default: boilerplate-web).",
description: "Sentry project slug for the web app (default: hivegrid-web).",
classification: "optional-provider",
targets: ["web"],
kind: "string",
@@ -1475,7 +1661,7 @@ export const envVariableDefinitions = [
targets: ["shared"],
kind: "url",
source: "code-and-example",
notes: "Consumed by @toolctrl/cli only.",
notes: "Consumed by @hivegrid/cli only.",
},
{
name: "BACKUP_S3_REGION",
@@ -1487,7 +1673,7 @@ export const envVariableDefinitions = [
},
{
name: "BACKUP_S3_BUCKET",
description: "Destination bucket for @toolctrl/cli backup archives.",
description: "Destination bucket for @hivegrid/cli backup archives.",
classification: "optional-provider",
targets: ["shared"],
kind: "string",
@@ -1496,7 +1682,7 @@ export const envVariableDefinitions = [
},
{
name: "BACKUP_S3_ACCESS_KEY_ID",
description: "S3 access key id used by @toolctrl/cli (separate from the app STORAGE_* credentials).",
description: "S3 access key id used by @hivegrid/cli (separate from the app STORAGE_* credentials).",
classification: "optional-provider",
targets: ["shared"],
kind: "secret",
@@ -1504,7 +1690,7 @@ export const envVariableDefinitions = [
},
{
name: "BACKUP_S3_SECRET_ACCESS_KEY",
description: "S3 secret access key used by @toolctrl/cli.",
description: "S3 secret access key used by @hivegrid/cli.",
classification: "optional-provider",
targets: ["shared"],
kind: "secret",
@@ -1563,7 +1749,7 @@ export const envVariableDefinitions = [
},
{
name: "BACKUP_RETENTION_DAILY",
description: "Number of daily backups @toolctrl/cli backup:rotate keeps (default 7).",
description: "Number of daily backups @hivegrid/cli backup:rotate keeps (default 7).",
classification: "optional-provider",
targets: ["shared"],
kind: "string",
@@ -1637,7 +1823,7 @@ export const envVariableDefinitions = [
targets: webApiWorkerTargets,
kind: "secret",
source: "code-and-example",
notes: "Never expose to browsers. Scoped to the SaaS index prefix (e.g. boilerplate-*), minted from the master key per infra STANDARDS §4. Local docker-compose may use the documented dev key.",
notes: "Never expose to browsers. Scoped to the SaaS index prefix (e.g. hivegrid-*), minted from the master key per infra STANDARDS §4. Local docker-compose may use the documented dev key.",
},
{
name: "MEILI_ENV",
@@ -1972,13 +2158,13 @@ export const envVariableDefinitions = [
// ------------------------------------------------------------------
{
name: "AUTHENTIK_ISSUER_URL",
description: "OIDC issuer URL published by the Authentik `toolctrl-admin-panel` provider (Phase 09 #82).",
description: "OIDC issuer URL published by the Authentik `hivegrid-admin-panel` provider (Phase 09 #82).",
classification: "optional-provider",
targets: ["web"],
kind: "url",
source: "code-and-example",
notes:
"Typically https://auth.<base-domain>/application/o/toolctrl-admin-panel/. Must match the `iss` claim in Authentik ID-tokens; openid-client uses it for Issuer.discover().",
"Typically https://auth.<base-domain>/application/o/hivegrid-admin-panel/. Must match the `iss` claim in Authentik ID-tokens; openid-client uses it for Issuer.discover().",
},
{
name: "AUTHENTIK_ADMIN_CLIENT_ID",
@@ -1987,7 +2173,7 @@ export const envVariableDefinitions = [
targets: ["web"],
kind: "string",
source: "code-and-example",
notes: "Matches the blueprint client_id (defaults to `toolctrl-admin-panel`).",
notes: "Matches the blueprint client_id (defaults to `hivegrid-admin-panel`).",
},
{
name: "AUTHENTIK_ADMIN_CLIENT_SECRET",
@@ -2014,7 +2200,7 @@ export const envVariableDefinitions = [
targets: ["web"],
kind: "url",
source: "code-and-example",
notes: "Typically https://admin.<base-domain>/admin/login?logged_out=1 — must be allowlisted in Authentik's post_logout_redirect_uris.",
notes: "Typically https://admin.<base-domain>/login?logged_out=1 — must be allowlisted in Authentik's post_logout_redirect_uris.",
},
{
name: "ADMIN_FALLBACK_LOGIN_ENABLED",
@@ -2035,58 +2221,6 @@ export const envVariableDefinitions = [
source: "code-and-example",
notes: "Keep this short (1-2 bootstrap accounts max). Every fallback success/failure emits an admin.login.fallback.* audit event tagged severity=warn.",
},
{
name: "FCM_SERVICE_ACCOUNT_JSON",
description: "Firebase Cloud Messaging service-account credentials used by the worker push job to dispatch Android notifications (Phase 08 #65).",
classification: "optional-provider",
targets: ["worker"],
kind: "secret",
source: "code-and-example",
notes: "Accepted formats: raw JSON or base64-encoded JSON. Generated via Firebase console → Project settings → Service accounts. Never commit; grants full FCM send rights for the project.",
},
{
name: "APNS_KEY",
description: "Apple Push Notification Service signing key (PEM contents of the .p8 file). Used by the worker push job for iOS notifications (Phase 08 #65).",
classification: "optional-provider",
targets: ["worker"],
kind: "secret",
source: "code-and-example",
notes: "Standard PKCS#8 PEM block (full contents of the downloaded .p8). Rotate every 12 months — Apple does not auto-expire .p8 keys but rotation contains compromise blast-radius.",
},
{
name: "APNS_KEY_ID",
description: "10-character Apple key id displayed alongside the .p8 file in the Apple Developer console (Phase 08 #65).",
classification: "optional-provider",
targets: ["worker"],
kind: "string",
source: "code-and-example",
},
{
name: "APNS_TEAM_ID",
description: "10-character Apple Developer team id used as the APNs JWT issuer claim (Phase 08 #65).",
classification: "optional-provider",
targets: ["worker"],
kind: "string",
source: "code-and-example",
},
{
name: "APNS_BUNDLE_ID",
description: "iOS bundle id passed as the APNs topic. Defaults to de.toolctrl.app — override only when shipping a re-branded fork (Phase 08 #65).",
classification: "optional-provider",
targets: ["worker"],
kind: "string",
source: "code-and-example",
defaultValue: "de.toolctrl.app",
},
{
name: "MOBILE_LIVE_RELOAD_URL",
description: "Dev-only: when set, apps/mobile/capacitor.config.ts emits `server.url` so the native shell loads from this URL instead of the bundled webDir (Phase 08 #65).",
classification: "optional-provider",
targets: ["worker"],
kind: "url",
source: "code-and-example",
notes: "Leave empty in production builds. Typical dev value: `http://192.168.x.x:3000` (the host machine's LAN IP running `pnpm --filter @toolctrl/web dev`).",
},
] as const satisfies readonly EnvVariableDefinition[];
export type KnownEnvVariableName = (typeof envVariableDefinitions)[number]["name"];