Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
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"];
|
||||
Reference in new issue
Block a user