which-url 0.0.1 → 0.0.3

package/README.md

@@ -7,16 +7,35 @@ npm install which-url
 ```
 
 ```typescript
-import whichUrl from 'which-url'
+import appUrl from 'which-url'
 
-whichUrl.href      // "https://myapp.vercel.app"
-whichUrl.hostname  // "myapp.vercel.app"
+auth({ baseURL: appUrl.href })  // just works — local, preview, production
 ```
 
 Works on Vercel, Netlify, Cloudflare Pages, Railway, Fly.io, Render, DigitalOcean, and Heroku — automatically.
 
 ## Usage
 
+### Default export (object with dot access)
+
+```typescript
+import appUrl from 'which-url'
+
+appUrl.href        // "https://myapp.vercel.app"
+appUrl.origin      // "https://myapp.vercel.app"
+appUrl.hostname    // "myapp.vercel.app"
+appUrl.host        // "myapp.vercel.app"
+appUrl.protocol    // "https:"
+appUrl.port        // ""
+
+appUrl.env           // "production" | "preview" | "local"
+appUrl.isProduction  // boolean
+appUrl.isPreview     // boolean
+appUrl.isLocal       // boolean
+```
+
+Property names follow the [WHATWG URL spec](https://url.spec.whatwg.org/) — nothing new to learn.
+
 ### Named exports (plain strings — zero type friction)
 
 ```typescript
@@ -32,26 +51,6 @@ if (isProduction) {
 }
 ```
 
-### Default export (object with dot access)
-
-```typescript
-import whichUrl from 'which-url'
-
-whichUrl.href        // "https://myapp.vercel.app"
-whichUrl.origin      // "https://myapp.vercel.app"
-whichUrl.hostname    // "myapp.vercel.app"
-whichUrl.host        // "myapp.vercel.app"
-whichUrl.protocol    // "https:"
-whichUrl.port        // ""
-
-whichUrl.env           // "production" | "preview" | "local"
-whichUrl.isProduction  // boolean
-whichUrl.isPreview     // boolean
-whichUrl.isLocal       // boolean
-```
-
-Property names follow the [WHATWG URL spec](https://url.spec.whatwg.org/) — nothing new to learn.
-
 ## How it works
 
 `which-url` reads environment variables that hosting providers set automatically. No configuration needed.
@@ -127,6 +126,12 @@ url.href // never throws
 
 In **development**, it always falls back to localhost.
 
+## Gotchas
+
+### Vercel: Redeploy after assigning a custom domain
+
+Framework-prefixed env vars like `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL` are inlined into the bundle at **build time** — the bundler replaces references with their literal values. If you assign a custom domain after deploying, the old deployment still has the previous URL baked in. Trigger a new deployment for the updated domain to take effect.
+
 ## Cloudflare Workers
 
 Cloudflare Workers use runtime `env` bindings instead of `process.env`. Set `APP_URL` in `wrangler.toml`:
@@ -143,11 +148,11 @@ Modern wrangler polyfills `process.env` from `[vars]`, so `which-url` picks it u
 ### Better Auth
 
 ```typescript
-import { href } from 'which-url'
+import appUrl from 'which-url'
 import { betterAuth } from 'better-auth'
 
 export const auth = betterAuth({
-  baseURL: href,
+  baseURL: appUrl.href,
   // ...
 })
 ```
@@ -155,14 +160,18 @@ export const auth = betterAuth({
 ### NextAuth / Auth.js
 
 ```typescript
-import { href } from 'which-url'
+import appUrl from 'which-url'
 
 // No need to set NEXTAUTH_URL manually
-process.env.NEXTAUTH_URL = href
+process.env.NEXTAUTH_URL = appUrl.href
 ```
 
 ## API
 
+### Default export
+
+An object with URL properties and environment helpers.
+
 ### Named exports
 
 | Export | Type | Description |

package/dist/env-var.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Read an env var, checking all framework-prefixed versions.
+ * On the server, unprefixed wins (it's always set).
+ * On the client, the bundler inlines the prefixed version.
+ *
+ * When called with an `env` object (e.g. from provider detection),
+ * falls back to dynamic lookup for test/server compatibility.
+ */
+export declare function getVar(env: Record<string, string | undefined>, name: string): string | undefined;
+export declare function getEnv(): Record<string, string | undefined>;
+//# sourceMappingURL=env-var.d.ts.map

package/dist/env-var.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-var.d.ts","sourceRoot":"","sources":["../src/env-var.ts"],"names":[],"mappings":"AAgGA;;;;;;;GAOG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CA0BpB;AAED,wBAAgB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAK3D"}

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAIrC,wBAAgB,UAAU,IAAI,MAAM,CAuBnC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAIrC,wBAAgB,UAAU,IAAI,MAAM,CAwBnC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { WhichUrl, AppEnv, CreateUrlOptions } from "./types";
 export declare function createUrl(options?: CreateUrlOptions): WhichUrl;
-declare const _resolved: WhichUrl;
+declare let _resolved: WhichUrl;
 export declare const href: string;
 export declare const origin: string;
 export declare const hostname: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CAgB9D;AAGD,QAAA,MAAM,SAAS,UAAc,CAAA;AAG7B,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,eAAO,MAAM,MAAM,EAAE,MAAyB,CAAA;AAC9C,eAAO,MAAM,QAAQ,EAAE,MAA2B,CAAA;AAClD,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,eAAO,MAAM,QAAQ,EAAE,MAA2B,CAAA;AAClD,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,eAAO,MAAM,GAAG,EAAE,MAAsB,CAAA;AACxC,eAAO,MAAM,YAAY,EAAE,OAAgC,CAAA;AAC3D,eAAO,MAAM,SAAS,EAAE,OAA6B,CAAA;AACrD,eAAO,MAAM,OAAO,EAAE,OAA2B,CAAA;AAGjD,eAAe,SAAS,CAAA;AAExB,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CAgB9D;AAGD,QAAA,IAAI,SAAS,EAAE,QAAQ,CAAA;AAsBvB,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,eAAO,MAAM,MAAM,EAAE,MAAyB,CAAA;AAC9C,eAAO,MAAM,QAAQ,EAAE,MAA2B,CAAA;AAClD,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,eAAO,MAAM,QAAQ,EAAE,MAA2B,CAAA;AAClD,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,eAAO,MAAM,GAAG,EAAE,MAAsB,CAAA;AACxC,eAAO,MAAM,YAAY,EAAE,OAAgC,CAAA;AAC3D,eAAO,MAAM,SAAS,EAAE,OAA6B,CAAA;AACrD,eAAO,MAAM,OAAO,EAAE,OAA2B,CAAA;AAGjD,eAAe,SAAS,CAAA;AAExB,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/index.js

@@ -1,18 +1,69 @@
+// src/env-var.ts
+function readStatic(name) {
+  switch (name) {
+    case "VERCEL_ENV":
+      return process.env.VERCEL_ENV || process.env.NEXT_PUBLIC_VERCEL_ENV || process.env.NUXT_ENV_VERCEL_ENV || process.env.VITE_VERCEL_ENV || process.env.PUBLIC_VERCEL_ENV || process.env.REACT_APP_VERCEL_ENV || process.env.GATSBY_VERCEL_ENV || process.env.VUE_APP_VERCEL_ENV || process.env.REDWOOD_ENV_VERCEL_ENV || process.env.SANITY_STUDIO_VERCEL_ENV || undefined;
+    case "VERCEL_URL":
+      return process.env.VERCEL_URL || process.env.NEXT_PUBLIC_VERCEL_URL || process.env.NUXT_ENV_VERCEL_URL || process.env.VITE_VERCEL_URL || process.env.PUBLIC_VERCEL_URL || process.env.REACT_APP_VERCEL_URL || process.env.GATSBY_VERCEL_URL || process.env.VUE_APP_VERCEL_URL || process.env.REDWOOD_ENV_VERCEL_URL || process.env.SANITY_STUDIO_VERCEL_URL || undefined;
+    case "VERCEL_BRANCH_URL":
+      return process.env.VERCEL_BRANCH_URL || process.env.NEXT_PUBLIC_VERCEL_BRANCH_URL || process.env.NUXT_ENV_VERCEL_BRANCH_URL || process.env.VITE_VERCEL_BRANCH_URL || process.env.PUBLIC_VERCEL_BRANCH_URL || process.env.REACT_APP_VERCEL_BRANCH_URL || process.env.GATSBY_VERCEL_BRANCH_URL || process.env.VUE_APP_VERCEL_BRANCH_URL || process.env.REDWOOD_ENV_VERCEL_BRANCH_URL || process.env.SANITY_STUDIO_VERCEL_BRANCH_URL || undefined;
+    case "VERCEL_PROJECT_PRODUCTION_URL":
+      return process.env.VERCEL_PROJECT_PRODUCTION_URL || process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL || process.env.NUXT_ENV_VERCEL_PROJECT_PRODUCTION_URL || process.env.VITE_VERCEL_PROJECT_PRODUCTION_URL || process.env.PUBLIC_VERCEL_PROJECT_PRODUCTION_URL || process.env.REACT_APP_VERCEL_PROJECT_PRODUCTION_URL || process.env.GATSBY_VERCEL_PROJECT_PRODUCTION_URL || process.env.VUE_APP_VERCEL_PROJECT_PRODUCTION_URL || process.env.REDWOOD_ENV_VERCEL_PROJECT_PRODUCTION_URL || process.env.SANITY_STUDIO_VERCEL_PROJECT_PRODUCTION_URL || undefined;
+    case "APP_URL":
+      return process.env.APP_URL || process.env.NEXT_PUBLIC_APP_URL || process.env.NUXT_ENV_APP_URL || process.env.VITE_APP_URL || process.env.PUBLIC_APP_URL || process.env.REACT_APP_APP_URL || process.env.GATSBY_APP_URL || process.env.VUE_APP_APP_URL || process.env.REDWOOD_ENV_APP_URL || process.env.SANITY_STUDIO_APP_URL || undefined;
+    case "APP_ENV":
+      return process.env.APP_ENV || process.env.NEXT_PUBLIC_APP_ENV || process.env.NUXT_ENV_APP_ENV || process.env.VITE_APP_ENV || process.env.PUBLIC_APP_ENV || process.env.REACT_APP_APP_ENV || process.env.GATSBY_APP_ENV || process.env.VUE_APP_APP_ENV || process.env.REDWOOD_ENV_APP_ENV || process.env.SANITY_STUDIO_APP_ENV || undefined;
+  }
+}
+function getVar(env, name) {
+  if (typeof process !== "undefined" && process?.env && env === process.env) {
+    const val = readStatic(name);
+    if (val)
+      return val;
+  }
+  const PREFIXES = [
+    "",
+    "NEXT_PUBLIC_",
+    "NUXT_ENV_",
+    "VITE_",
+    "PUBLIC_",
+    "REACT_APP_",
+    "GATSBY_",
+    "VUE_APP_",
+    "REDWOOD_ENV_",
+    "SANITY_STUDIO_"
+  ];
+  for (const prefix of PREFIXES) {
+    const val = env[prefix + name];
+    if (val)
+      return val;
+  }
+  return;
+}
+function getEnv() {
+  if (typeof process !== "undefined" && process?.env) {
+    return process.env;
+  }
+  return {};
+}
+
 // src/providers.ts
 var providers = [
   {
     name: "vercel",
-    detect: (env) => !!env.VERCEL,
+    detect: (env) => !!env.VERCEL || !!getVar(env, "VERCEL_ENV"),
     resolveUrl: (env) => {
-      if (env.VERCEL_ENV === "production") {
-        return env.VERCEL_PROJECT_PRODUCTION_URL || env.VERCEL_URL || null;
+      const vercelEnv = getVar(env, "VERCEL_ENV");
+      if (vercelEnv === "production") {
+        return getVar(env, "VERCEL_PROJECT_PRODUCTION_URL") || getVar(env, "VERCEL_URL") || null;
       }
-      return env.VERCEL_BRANCH_URL || env.VERCEL_URL || null;
+      return getVar(env, "VERCEL_BRANCH_URL") || getVar(env, "VERCEL_URL") || null;
     },
     resolveEnv: (env) => {
-      if (env.VERCEL_ENV === "production")
+      const vercelEnv = getVar(env, "VERCEL_ENV");
+      if (vercelEnv === "production")
         return "production";
-      if (env.VERCEL_ENV === "preview")
+      if (vercelEnv === "preview")
         return "preview";
       return "local";
     }
@@ -94,8 +145,8 @@ function normalizeUrl(raw) {
 
 // src/resolve.ts
 function resolveUrl(options) {
-  const env = typeof process !== "undefined" ? process.env : {};
-  const override = env.APP_URL || env.NEXT_PUBLIC_APP_URL;
+  const env = getEnv();
+  const override = getVar(env, "APP_URL");
   if (override)
     return normalizeUrl(override);
   for (const p of providers) {
@@ -122,9 +173,10 @@ function resolveUrl(options) {
 // src/env.ts
 var validEnvs = ["production", "preview", "local"];
 function resolveEnv() {
-  const env = typeof process !== "undefined" ? process.env : {};
-  if (env.APP_ENV && validEnvs.includes(env.APP_ENV)) {
-    return env.APP_ENV;
+  const env = getEnv();
+  const appEnv = getVar(env, "APP_ENV");
+  if (appEnv && validEnvs.includes(appEnv)) {
+    return appEnv;
   }
   if (env.NODE_ENV === "development")
     return "local";
@@ -156,7 +208,24 @@ function createUrl(options) {
     isLocal: env === "local"
   };
 }
-var _resolved = createUrl();
+var _resolved;
+try {
+  _resolved = createUrl();
+} catch (e) {
+  console.warn(`[which-url] Could not detect app URL. Set APP_URL (e.g. APP_URL=https://myapp.com or APP_URL=myapp.com)`);
+  _resolved = {
+    href: "",
+    origin: "",
+    hostname: "",
+    host: "",
+    protocol: "",
+    port: "",
+    env: "local",
+    isProduction: false,
+    isPreview: false,
+    isLocal: true
+  };
+}
 var href = _resolved.href;
 var origin = _resolved.origin;
 var hostname = _resolved.hostname;

package/dist/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,eAAO,MAAM,SAAS,EAAE,gBAAgB,EA8EvC,CAAA"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/C,eAAO,MAAM,SAAS,EAAE,gBAAgB,EAgFvC,CAAA"}

package/dist/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAoC7D"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAoC7D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "which-url",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Auto-detect your app's URL across hosting providers. Zero config.",
   "type": "module",
   "exports": {