@alumbwe/anvil 1.0.41 → 1.0.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alumbwe/anvil",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "private": false,
   "type": "module",
   "bin": {

package/src/entry.ts

@@ -1,5 +1,10 @@
 #!/usr/bin/env bun
 
+// MUST be first: applies production defaults for NEXT_PUBLIC_* before any
+// module in the import graph evaluates `@anvil/common/env`, which validates
+// the client env at import time and throws on machines without an env file.
+import './pre-init/client-env'
+
 import {
   isTerminalCommandBrokerInvocation,
   serveTerminalCommandBroker,

package/src/pre-init/client-env.ts

@@ -0,0 +1,17 @@
+// Apply production defaults for NEXT_PUBLIC_* vars BEFORE anything that
+// imports `@anvil/common/env`, which validates the client env at import time
+// and throws on a machine without an env file (any global npm install).
+//
+// Must be imported before `./index` in `entry.ts`, mirroring the tree-sitter
+// pre-init: both prepare runtime state the eagerly-evaluated import graph
+// needs at module-evaluation time.
+//
+// Gap-filling only: real values already in process.env (from ~/.env.local,
+// the shell, or --define flags baked into compiled binaries) always win.
+import { CLIENT_ENV_DEFAULTS } from '../utils/client-env-defaults'
+
+for (const [key, value] of Object.entries(CLIENT_ENV_DEFAULTS)) {
+  if (process.env[key] === undefined) {
+    process.env[key] = value
+  }
+}

package/src/utils/client-env-defaults.ts

@@ -0,0 +1,28 @@
+/**
+ * Production defaults for the NEXT_PUBLIC_* client env vars.
+ *
+ * `@anvil/common/env` validates all NEXT_PUBLIC_* vars at *import time*, so a
+ * global npm install (no .env.local anywhere on the machine) dies before any
+ * of our code runs. These defaults — all public-by-design values, the same
+ * set `cli/scripts/build-binary.ts` bakes into compiled binaries — are applied
+ * to `process.env` at pre-init so the CLI boots on any machine, cmd or
+ * PowerShell, with or without an env file.
+ *
+ * IMPORTANT: the pre-init loader (`cli/src/pre-init/client-env.ts`) imports
+ * this table, and `build-binary.ts` reads it at build time. Keep the two in
+ * sync through this module — never duplicate the values.
+ *
+ * User-set values always win: the loader only fills gaps, it never overwrites
+ * anything already in process.env (including values Bun loads from
+ * .env.local in dev, and the --define flags baked into binaries).
+ */
+export const CLIENT_ENV_DEFAULTS: Readonly<Record<string, string>> = {
+  NEXT_PUBLIC_CB_ENVIRONMENT: 'prod',
+  NEXT_PUBLIC_ANVIL_APP_URL: 'https://anvil.dev',
+  NEXT_PUBLIC_SUPPORT_EMAIL: 'support@anvil.dev',
+  NEXT_PUBLIC_POSTHOG_API_KEY: 'phc_placeholder',
+  NEXT_PUBLIC_POSTHOG_HOST_URL: 'https://us.i.posthog.com',
+  NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: 'pk_placeholder',
+  NEXT_PUBLIC_STRIPE_CUSTOMER_PORTAL: 'https://billing.stripe.com/portal',
+  NEXT_PUBLIC_WEB_PORT: '3000',
+}