which-url 0.0.7 → 0.0.9

package/README.md

@@ -20,7 +20,7 @@ Preview       https://myapp-git-feat.vercel.app     "preview"
 Production    https://myapp.com                     "production"
 ```
 
-Works across environments (local, preview, production), runtimes (server, client, edge), and [platforms](#platform-support).
+Works across environments (local, preview, production), browser bundles, Node/Bun servers, and edge runtimes that expose compatible env vars through `process.env` or build-time public env replacement.
 
 The default export gives you everything as an object:
 
@@ -85,7 +85,31 @@ Reads environment variables that hosting providers set automatically:
 3. `window.location.origin` (browser fallback)
 4. `http://localhost:${PORT || 3000}` (development fallback)
 
-If nothing is detected in production, the singleton logs a warning and returns empty strings. Call `createUrl()` directly if you want it to throw instead.
+When you call `createUrl({ env })`, the passed object replaces `process.env` as the source for steps 1–2.
+
+If nothing is detected in production, the default singleton returns empty URL strings so imports stay safe in tests, client bundles, and build tools. Call `createUrl()` directly when a missing URL should throw.
+
+## Strict mode with `createUrl()`
+
+Use the default export or named constants for convenience:
+
+```typescript
+import { origin } from 'which-url'
+```
+
+Use `createUrl()` for production-critical configuration like auth, CORS, emails, and webhooks:
+
+```typescript
+import { createUrl } from 'which-url'
+
+const appUrl = createUrl()
+
+auth({ baseURL: appUrl.origin })
+```
+
+`createUrl()` resolves fresh environment values when called. If no URL can be detected in production, it throws with instructions to set `APP_URL`.
+
+For runtimes that pass env as an argument (e.g. Cloudflare Workers), call `createUrl({ env })` and the passed object replaces `process.env` for that resolution. See [Cloudflare Workers](#cloudflare-workers) below.
 
 ## Override with `APP_URL`
 
@@ -172,14 +196,32 @@ APP_URL=https://abc123.ngrok-free.app npm run dev
 
 ### Cloudflare Workers
 
-Cloudflare Workers use runtime `env` bindings instead of `process.env`. Set `APP_URL` in `wrangler.toml`:
+Cloudflare Workers pass config through the `env` argument to `fetch`, not `process.env`. Pass it to `createUrl({ env })`:
+
+```typescript
+import { createUrl } from "which-url"
+
+export default {
+  async fetch(request: Request, env: Env) {
+    const appUrl = createUrl({ env })
+
+    return Response.json({ origin: appUrl.origin, env: appUrl.env })
+  },
+}
+```
 
 ```toml
+# wrangler.toml
 [vars]
-APP_URL = "https://myapp.workers.dev"
+APP_URL = "https://api.example.com"
+APP_ENV = "production"
 ```
 
-Modern wrangler polyfills `process.env` from `[vars]`, so `which-url` picks it up automatically.
+Non-string bindings (KV, Durable Objects, R2, service bindings) are ignored automatically — only string `[vars]` participate in URL detection.
+
+> ⚠️ The default singleton (`import appUrl from "which-url"`) and named exports (`origin`, `env`, etc.) resolve at **module load**, before your `fetch` handler runs. On Workers they will not see your `[vars]`. Use `createUrl({ env })` from inside your handler.
+
+If you're on `nodejs_compat` and prefer `process.env`, the default singleton works too — but `createUrl({ env })` is the runtime-native path and doesn't require the compat flag.
 
 ### Debugging
 
@@ -197,7 +239,11 @@ console.log(appUrl.debug)
 
 ### Default export
 
-An object with URL properties and environment helpers.
+An import-safe singleton object with URL properties and environment helpers. It resolves once when the package is imported.
+
+### `createUrl()`
+
+Strict resolver function. It resolves when called and throws if no URL can be detected.
 
 ### Named exports
 
@@ -212,11 +258,12 @@ An object with URL properties and environment helpers.
 | `env` | `AppEnv` | `"production"` \| `"preview"` \| `"local"` |
 | `platform` | `Platform` | `"vercel"` \| `"netlify"` \| ... \| `null` |
 | `debug`* | `string` | `"[provider:vercel] url=myapp.com \| env=production (vercel:production)"` |
-
-\* `debug` is non-enumerable — excluded from `JSON.stringify` to avoid React hydration mismatches. Access via `appUrl.debug`.
 | `isProduction` | `boolean` | |
 | `isPreview` | `boolean` | |
 | `isLocal` | `boolean` | |
+| `createUrl` | `(options?: { env?: object }) => WhichUrlWithDebug` | strict resolver |
+
+\* `debug` is non-enumerable on the default export and objects returned by `createUrl()` — excluded from `JSON.stringify` to avoid React hydration mismatches. It is also available as a named export.
 
 ## License
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import type { WhichUrlWithDebug, AppEnv, Platform } from "./types";
+import type { WhichUrlWithDebug, AppEnv, Platform, CreateUrlOptions } from "./types";
+export declare function createUrl(options?: CreateUrlOptions): WhichUrlWithDebug;
 declare let _resolved: WhichUrlWithDebug;
 /** Full URL including protocol — `"https://myapp.com"` */
 export declare const href: string;
@@ -16,6 +17,8 @@ export declare const port: string;
 export declare const env: AppEnv;
 /** Detected hosting platform — `"vercel"`, `"netlify"`, etc. or `null` */
 export declare const platform: Platform;
+/** Resolution debug string. */
+export declare const debug: string;
 /** `true` when running in production */
 export declare const isProduction: boolean;
 /** `true` when running in a preview/staging deployment */
@@ -36,5 +39,5 @@ export declare const isLocal: boolean;
  * ```
  */
 export default _resolved;
-export type { WhichUrl, WhichUrlWithDebug, AppEnv, Platform, PlatformName } from "./types";
+export type { WhichUrl, WhichUrlWithDebug, AppEnv, Platform, PlatformName, CreateUrlOptions } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,297 +1 @@
-// src/env-var.ts
-var ENV_VARS = [
-  "VERCEL_ENV",
-  "VERCEL_URL",
-  "VERCEL_BRANCH_URL",
-  "VERCEL_PROJECT_PRODUCTION_URL",
-  "APP_URL",
-  "APP_ENV"
-];
-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;
-    default:
-      return;
-  }
-}
-function getVar(env, name) {
-  if (typeof process !== "undefined" && process?.env && env === process.env) {
-    if (ENV_VARS.includes(name)) {
-      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 || !!getVar(env, "VERCEL_ENV"),
-    resolveUrl: (env) => {
-      const vercelEnv = getVar(env, "VERCEL_ENV");
-      if (vercelEnv === "production") {
-        return getVar(env, "VERCEL_PROJECT_PRODUCTION_URL") || getVar(env, "VERCEL_URL") || null;
-      }
-      return getVar(env, "VERCEL_BRANCH_URL") || getVar(env, "VERCEL_URL") || null;
-    },
-    resolveEnv: (env) => {
-      const vercelEnv = getVar(env, "VERCEL_ENV");
-      if (vercelEnv === "production")
-        return "production";
-      if (vercelEnv === "preview")
-        return "preview";
-      return "local";
-    }
-  },
-  {
-    name: "netlify",
-    detect: (env) => !!env.NETLIFY,
-    resolveUrl: (env) => {
-      if (env.CONTEXT === "production")
-        return env.URL || null;
-      return env.DEPLOY_PRIME_URL || env.DEPLOY_URL || null;
-    },
-    resolveEnv: (env) => {
-      if (env.CONTEXT === "production")
-        return "production";
-      if (env.CONTEXT === "deploy-preview" || env.CONTEXT === "branch-deploy")
-        return "preview";
-      return "local";
-    }
-  },
-  {
-    name: "cloudflare",
-    detect: (env) => !!env.CF_PAGES,
-    resolveUrl: (env) => env.CF_PAGES_URL || null,
-    resolveEnv: (env) => {
-      if (env.CF_PAGES_BRANCH === "main" || env.CF_PAGES_BRANCH === "master")
-        return "production";
-      return "preview";
-    }
-  },
-  {
-    name: "railway",
-    detect: (env) => !!env.RAILWAY_PUBLIC_DOMAIN,
-    resolveUrl: (env) => env.RAILWAY_PUBLIC_DOMAIN || null,
-    resolveEnv: (env) => {
-      if (env.RAILWAY_ENVIRONMENT === "production")
-        return "production";
-      return "production";
-    }
-  },
-  {
-    name: "fly",
-    detect: (env) => !!env.FLY_APP_NAME,
-    resolveUrl: (env) => env.FLY_APP_NAME ? `${env.FLY_APP_NAME}.fly.dev` : null,
-    resolveEnv: () => "production"
-  },
-  {
-    name: "render",
-    detect: (env) => !!env.RENDER,
-    resolveUrl: (env) => env.RENDER_EXTERNAL_URL || null,
-    resolveEnv: (env) => {
-      if (env.IS_PULL_REQUEST === "true")
-        return "preview";
-      return "production";
-    }
-  },
-  {
-    name: "digitalocean",
-    detect: (env) => !!env.DIGITALOCEAN_APP_PLATFORM,
-    resolveUrl: (env) => env.APP_URL || null,
-    resolveEnv: () => "production"
-  },
-  {
-    name: "heroku",
-    detect: (env) => !!env.HEROKU_APP_NAME,
-    resolveUrl: (env) => env.HEROKU_APP_NAME ? `${env.HEROKU_APP_NAME}.herokuapp.com` : null,
-    resolveEnv: () => "production"
-  }
-];
-
-// src/normalize.ts
-function normalizeUrl(raw) {
-  let url = raw.trim().replace(/\/+$/, "");
-  if (url.startsWith("http://") || url.startsWith("https://")) {
-    return url;
-  }
-  return `https://${url}`;
-}
-
-// src/resolve.ts
-function resolveUrl() {
-  const env = getEnv();
-  const override = getVar(env, "APP_URL");
-  if (override)
-    return { url: normalizeUrl(override), debugLabel: `[override] APP_URL=${override}` };
-  if (env.PORTLESS_TAILSCALE_URL) {
-    return { url: env.PORTLESS_TAILSCALE_URL, debugLabel: `[portless:tailscale] PORTLESS_TAILSCALE_URL=${env.PORTLESS_TAILSCALE_URL}` };
-  }
-  if (env.PORTLESS_URL) {
-    return { url: env.PORTLESS_URL, debugLabel: `[portless] PORTLESS_URL=${env.PORTLESS_URL}` };
-  }
-  for (const p of providers) {
-    if (p.detect(env)) {
-      const url = p.resolveUrl(env);
-      if (url)
-        return { url: normalizeUrl(url), debugLabel: `[provider:${p.name}] url=${url}` };
-    }
-  }
-  if (typeof window !== "undefined" && window.location) {
-    return { url: window.location.origin, debugLabel: `[browser] window.location.origin` };
-  }
-  const isProduction = env.NODE_ENV === "production";
-  if (!isProduction) {
-    const port = env.PORT || "3000";
-    return { url: `http://localhost:${port}`, debugLabel: `[fallback] PORT=${port}` };
-  }
-  throw new Error("which-url: Cannot detect app URL. Set APP_URL environment variable.");
-}
-function resolvePlatform() {
-  const env = getEnv();
-  for (const p of providers) {
-    if (p.detect(env)) {
-      return p.name;
-    }
-  }
-  return null;
-}
-
-// src/env.ts
-var validEnvs = ["production", "preview", "local"];
-function resolveEnv() {
-  const env = getEnv();
-  const appEnv = getVar(env, "APP_ENV");
-  if (appEnv && validEnvs.includes(appEnv)) {
-    return { env: appEnv, debugLabel: `APP_ENV=${appEnv}` };
-  }
-  if (env.NODE_ENV === "development")
-    return { env: "local", debugLabel: "NODE_ENV=development" };
-  for (const p of providers) {
-    if (p.detect(env)) {
-      const resolved = p.resolveEnv(env);
-      return { env: resolved, debugLabel: `${p.name}:${resolved}` };
-    }
-  }
-  if (env.NODE_ENV === "production")
-    return { env: "production", debugLabel: "NODE_ENV=production" };
-  return { env: "local", debugLabel: "default" };
-}
-
-// src/index.ts
-function resolve() {
-  const { url, debugLabel: urlDebug } = resolveUrl();
-  const parsed = new URL(url);
-  const { env, debugLabel: envDebug } = resolveEnv();
-  const platform = resolvePlatform();
-  const debug = `${urlDebug} | env=${env} (${envDebug})`;
-  const result = {
-    href: parsed.origin,
-    origin: parsed.origin,
-    hostname: parsed.hostname,
-    host: parsed.host,
-    protocol: parsed.protocol,
-    port: parsed.port,
-    env,
-    platform,
-    debug,
-    isProduction: env === "production",
-    isPreview: env === "preview",
-    isLocal: env === "local"
-  };
-  Object.defineProperty(result, "debug", {
-    value: debug,
-    enumerable: false,
-    configurable: false
-  });
-  return result;
-}
-var _resolved;
-try {
-  _resolved = resolve();
-} 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)`);
-  const fallback = {
-    href: "",
-    origin: "",
-    hostname: "",
-    host: "",
-    protocol: "",
-    port: "",
-    env: "local",
-    platform: null,
-    debug: "[error] resolution failed",
-    isProduction: false,
-    isPreview: false,
-    isLocal: true
-  };
-  Object.defineProperty(fallback, "debug", {
-    value: "[error] resolution failed",
-    enumerable: false,
-    configurable: false
-  });
-  _resolved = fallback;
-}
-var href = _resolved.href;
-var origin = _resolved.origin;
-var hostname = _resolved.hostname;
-var host = _resolved.host;
-var protocol = _resolved.protocol;
-var port = _resolved.port;
-var env = _resolved.env;
-var platform = _resolved.platform;
-var isProduction = _resolved.isProduction;
-var isPreview = _resolved.isPreview;
-var isLocal = _resolved.isLocal;
-var src_default = _resolved;
-export {
-  protocol,
-  port,
-  platform,
-  origin,
-  isProduction,
-  isPreview,
-  isLocal,
-  href,
-  hostname,
-  host,
-  env,
-  src_default as default
-};
+var F=["VERCEL_ENV","VERCEL_URL","VERCEL_BRANCH_URL","VERCEL_PROJECT_PRODUCTION_URL","APP_URL","APP_ENV"];function H(E){switch(E){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||void 0;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||void 0;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||void 0;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||void 0;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||void 0;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||void 0;default:return}}function C(E,R){if(typeof process<"u"&&process?.env&&E===process.env){if(F.includes(R)){let _=H(R);if(_)return _}}let A=["","NEXT_PUBLIC_","NUXT_ENV_","VITE_","PUBLIC_","REACT_APP_","GATSBY_","VUE_APP_","REDWOOD_ENV_","SANITY_STUDIO_"];for(let _ of A){let L=E[_+R];if(L)return L}return}function N(E){if(E!==void 0)return G(E);if(typeof process<"u"&&process?.env)return process.env;return{}}function G(E){let R={};for(let[A,_]of Object.entries(E))if(typeof _==="string")R[A]=_;return R}var T=[{name:"vercel",detect:(E)=>!!E.VERCEL||!!C(E,"VERCEL_ENV"),resolveUrl:(E)=>{if(C(E,"VERCEL_ENV")==="production")return C(E,"VERCEL_PROJECT_PRODUCTION_URL")||C(E,"VERCEL_URL")||null;return C(E,"VERCEL_BRANCH_URL")||C(E,"VERCEL_URL")||null},resolveEnv:(E)=>{let R=C(E,"VERCEL_ENV");if(R==="production")return"production";if(R==="preview")return"preview";return"local"}},{name:"netlify",detect:(E)=>!!E.NETLIFY,resolveUrl:(E)=>{if(E.CONTEXT==="production")return E.URL||null;return E.DEPLOY_PRIME_URL||E.DEPLOY_URL||null},resolveEnv:(E)=>{if(E.CONTEXT==="production")return"production";if(E.CONTEXT==="deploy-preview"||E.CONTEXT==="branch-deploy")return"preview";return"local"}},{name:"cloudflare",detect:(E)=>!!E.CF_PAGES,resolveUrl:(E)=>E.CF_PAGES_URL||null,resolveEnv:(E)=>{if(E.CF_PAGES_BRANCH==="main"||E.CF_PAGES_BRANCH==="master")return"production";return"preview"}},{name:"railway",detect:(E)=>!!E.RAILWAY_PUBLIC_DOMAIN,resolveUrl:(E)=>E.RAILWAY_PUBLIC_DOMAIN||null,resolveEnv:(E)=>{if(E.RAILWAY_ENVIRONMENT==="production")return"production";return"production"}},{name:"fly",detect:(E)=>!!E.FLY_APP_NAME,resolveUrl:(E)=>E.FLY_APP_NAME?`${E.FLY_APP_NAME}.fly.dev`:null,resolveEnv:()=>"production"},{name:"render",detect:(E)=>!!E.RENDER,resolveUrl:(E)=>E.RENDER_EXTERNAL_URL||null,resolveEnv:(E)=>{if(E.IS_PULL_REQUEST==="true")return"preview";return"production"}},{name:"digitalocean",detect:(E)=>!!E.DIGITALOCEAN_APP_PLATFORM,resolveUrl:(E)=>E.APP_URL||null,resolveEnv:()=>"production"},{name:"heroku",detect:(E)=>!!E.HEROKU_APP_NAME,resolveUrl:(E)=>E.HEROKU_APP_NAME?`${E.HEROKU_APP_NAME}.herokuapp.com`:null,resolveEnv:()=>"production"}];function U(E){let R=E.trim().replace(/\/+$/,"");if(R.startsWith("http://")||R.startsWith("https://"))return R;return`https://${R}`}function Y(E){let R=N(E),A=C(R,"APP_URL");if(A)return{url:U(A),debugLabel:`[override] APP_URL=${A}`};if(R.PORTLESS_TAILSCALE_URL)return{url:R.PORTLESS_TAILSCALE_URL,debugLabel:`[portless:tailscale] PORTLESS_TAILSCALE_URL=${R.PORTLESS_TAILSCALE_URL}`};if(R.PORTLESS_URL)return{url:R.PORTLESS_URL,debugLabel:`[portless] PORTLESS_URL=${R.PORTLESS_URL}`};for(let L of T)if(L.detect(R)){let t=L.resolveUrl(R);if(t)return{url:U(t),debugLabel:`[provider:${L.name}] url=${t}`}}if(typeof window<"u"&&window.location)return{url:window.location.origin,debugLabel:"[browser] window.location.origin"};if(R.NODE_ENV!=="production"){let L=R.PORT||"3000";return{url:`http://localhost:${L}`,debugLabel:`[fallback] PORT=${L}`}}throw Error("which-url: Cannot detect app URL. Set APP_URL environment variable.")}function I(E){let R=N(E);for(let A of T)if(A.detect(R))return A.name;return null}var W=["production","preview","local"];function M(E){let R=N(E),A=C(R,"APP_ENV");if(A&&W.includes(A))return{env:A,debugLabel:`APP_ENV=${A}`};if(R.NODE_ENV==="development")return{env:"local",debugLabel:"NODE_ENV=development"};for(let _ of T)if(_.detect(R)){let L=_.resolveEnv(R);return{env:L,debugLabel:`${_.name}:${L}`}}if(R.NODE_ENV==="production")return{env:"production",debugLabel:"NODE_ENV=production"};return{env:"local",debugLabel:"default"}}function c(E){return Object.defineProperty(E,"debug",{value:E.debug,enumerable:!1,configurable:!1}),E}function B(E){let R=E?.env,{url:A,debugLabel:_}=Y(R),L=new URL(A),{env:t,debugLabel:V}=M(R),u=I(R),O=`${_} | env=${t} (${V})`,f={href:L.origin,origin:L.origin,hostname:L.hostname,host:L.host,protocol:L.protocol,port:L.port,env:t,platform:u,debug:O,isProduction:t==="production",isPreview:t==="preview",isLocal:t==="local"};return c(f)}function X(E){let R=E instanceof Error?E.message:"resolution failed",A="local",_="default";try{let t=M();A=t.env,_=t.debugLabel}catch{}let L={href:"",origin:"",hostname:"",host:"",protocol:"",port:"",env:A,platform:I(),debug:`[error] ${R} | env=${A} (${_})`,isProduction:A==="production",isPreview:A==="preview",isLocal:A==="local"};return c(L)}var P;try{P=B()}catch(E){P=X(E)}var{href:z,origin:i,hostname:k,host:m,protocol:g,port:b,env:p,platform:l,debug:o,isProduction:n,isPreview:d,isLocal:s}=P,a=P;export{g as protocol,b as port,l as platform,i as origin,n as isProduction,d as isPreview,s as isLocal,z as href,k as hostname,m as host,p as env,a as default,o as debug,B as createUrl};

package/dist/types.d.ts

@@ -29,6 +29,18 @@ export interface WhichUrlWithDebug extends WhichUrl {
     /** Resolution debug string (non-enumerable — excluded from JSON.stringify and object spread). */
     readonly debug: string;
 }
+export interface CreateUrlOptions {
+    /**
+     * Runtime environment source. Pass this when `process.env` isn't available
+     * or doesn't contain your config — e.g. on Cloudflare Workers, where the
+     * Worker `env` argument carries `[vars]` from `wrangler.toml`.
+     *
+     * When provided, `process.env` is ignored entirely. Only string-valued
+     * entries participate in URL detection — non-string Workers bindings
+     * (KV namespaces, Durable Objects, R2 buckets, service bindings) are dropped.
+     */
+    env?: object;
+}
 export interface ProviderDetector {
     name: PlatformName;
     detect: (env: Record<string, string | undefined>) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "which-url",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Auto-detect your app's URL across hosting providers. Zero config.",
   "type": "module",
   "exports": {
@@ -12,7 +12,11 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/types.d.ts"
+  ],
   "sideEffects": false,
   "keywords": ["url", "base-url", "vercel", "netlify", "cloudflare", "railway", "hosting", "auto-detect", "which-url"],
   "author": {
@@ -25,7 +29,7 @@
   },
   "license": "MIT",
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --format esm && tsc --emitDeclarationOnly --outDir dist",
+    "build": "bun build src/index.ts --outdir dist --format esm --minify && tsc --emitDeclarationOnly --outDir dist",
     "test": "bun test",
     "prepublishOnly": "bun run build"
   },

package/dist/env-var.d.ts

@@ -1,11 +0,0 @@
-/**
- * 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

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

package/dist/env.d.ts

@@ -1,7 +0,0 @@
-import type { AppEnv } from "./types";
-export interface EnvResult {
-    env: AppEnv;
-    debugLabel: string;
-}
-export declare function resolveEnv(): EnvResult;
-//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAIrC,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,IAAI,SAAS,CAyBtC"}

package/dist/index.cjs

@@ -1,224 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-
-// src/index.ts
-var exports_src = {};
-__export(exports_src, {
-  protocol: () => protocol,
-  port: () => port,
-  origin: () => origin,
-  isProduction: () => isProduction,
-  isPreview: () => isPreview,
-  isLocal: () => isLocal,
-  href: () => href,
-  hostname: () => hostname,
-  host: () => host,
-  env: () => env,
-  default: () => src_default,
-  createUrl: () => createUrl
-});
-module.exports = __toCommonJS(exports_src);
-
-// src/providers.ts
-var providers = [
-  {
-    name: "vercel",
-    detect: (env) => env.VERCEL === "1",
-    resolveUrl: (env) => {
-      if (env.VERCEL_ENV === "production") {
-        return env.VERCEL_PROJECT_PRODUCTION_URL ?? env.VERCEL_URL ?? null;
-      }
-      return env.VERCEL_BRANCH_URL ?? env.VERCEL_URL ?? null;
-    },
-    resolveEnv: (env) => {
-      if (env.VERCEL_ENV === "production")
-        return "production";
-      if (env.VERCEL_ENV === "preview")
-        return "preview";
-      return "local";
-    }
-  },
-  {
-    name: "netlify",
-    detect: (env) => env.NETLIFY === "true",
-    resolveUrl: (env) => {
-      if (env.CONTEXT === "production")
-        return env.URL ?? null;
-      return env.DEPLOY_PRIME_URL ?? env.DEPLOY_URL ?? null;
-    },
-    resolveEnv: (env) => {
-      if (env.CONTEXT === "production")
-        return "production";
-      if (env.CONTEXT === "deploy-preview" || env.CONTEXT === "branch-deploy")
-        return "preview";
-      return "local";
-    }
-  },
-  {
-    name: "cloudflare",
-    detect: (env) => env.CF_PAGES === "1",
-    resolveUrl: (env) => env.CF_PAGES_URL ?? null,
-    resolveEnv: (env) => {
-      if (env.CF_PAGES_BRANCH === "main" || env.CF_PAGES_BRANCH === "master")
-        return "production";
-      return "preview";
-    }
-  },
-  {
-    name: "railway",
-    detect: (env) => !!env.RAILWAY_PUBLIC_DOMAIN,
-    resolveUrl: (env) => env.RAILWAY_PUBLIC_DOMAIN ?? null,
-    resolveEnv: (env) => {
-      if (env.RAILWAY_ENVIRONMENT === "production")
-        return "production";
-      return "preview";
-    }
-  },
-  {
-    name: "render",
-    detect: (env) => env.RENDER === "true",
-    resolveUrl: (env) => env.RENDER_EXTERNAL_URL ?? null,
-    resolveEnv: (env) => {
-      if (env.IS_PULL_REQUEST === "true")
-        return "preview";
-      return "production";
-    }
-  },
-  {
-    name: "fly",
-    detect: (env) => !!env.FLY_APP_NAME,
-    resolveUrl: (env) => {
-      const name = env.FLY_APP_NAME;
-      return name ? `${name}.fly.dev` : null;
-    },
-    resolveEnv: () => "production"
-  },
-  {
-    name: "digitalocean",
-    detect: (env) => !!env.DIGITALOCEAN_APP_PLATFORM,
-    resolveUrl: (env) => env.APP_URL ?? null,
-    resolveEnv: () => "production"
-  },
-  {
-    name: "heroku",
-    detect: (env) => !!env.HEROKU_APP_NAME,
-    resolveUrl: (env) => {
-      const name = env.HEROKU_APP_NAME;
-      return name ? `${name}.herokuapp.com` : null;
-    },
-    resolveEnv: () => "production"
-  }
-];
-
-// src/normalize.ts
-function normalizeUrl(raw, protocol = "https") {
-  let url = raw.trim();
-  url = url.replace(/\/+$/, "");
-  if (url.startsWith("http://") || url.startsWith("https://")) {
-    return url;
-  }
-  url = url.replace(/^\/+/, "");
-  return `${protocol}://${url}`;
-}
-
-// src/resolve.ts
-function resolveUrl(options) {
-  const env = typeof process !== "undefined" ? process.env : {};
-  const override = env.APP_URL ?? env.NEXT_PUBLIC_APP_URL;
-  if (override)
-    return normalizeUrl(override);
-  for (const p of providers) {
-    if (p.detect(env)) {
-      const url = p.resolveUrl(env);
-      if (url)
-        return normalizeUrl(url);
-    }
-  }
-  if (typeof window !== "undefined" && window.location?.origin) {
-    return window.location.origin;
-  }
-  if (options?.fallback)
-    return normalizeUrl(options.fallback);
-  const isProduction = env.NODE_ENV === "production";
-  if (isProduction) {
-    throw new Error(`thisapp: Cannot detect app URL. Set APP_URL environment variable.
-` + "See: https://github.com/manishrc/thisapp#configuration");
-  }
-  const port = env.PORT ?? "3000";
-  return `http://localhost:${port}`;
-}
-
-// src/env.ts
-function resolveEnv() {
-  const env = typeof process !== "undefined" ? process.env : {};
-  const override = env.APP_ENV;
-  if (override === "production" || override === "preview" || override === "local") {
-    return override;
-  }
-  if (env.NODE_ENV === "development")
-    return "local";
-  for (const p of providers) {
-    if (p.detect(env)) {
-      return p.resolveEnv(env);
-    }
-  }
-  if (env.NODE_ENV === "production")
-    return "production";
-  return "local";
-}
-
-// src/index.ts
-function createUrl(options) {
-  const resolved = resolveUrl(options);
-  const parsed = new URL(resolved);
-  const env = resolveEnv();
-  return {
-    href: parsed.origin,
-    origin: parsed.origin,
-    hostname: parsed.hostname,
-    host: parsed.host,
-    protocol: parsed.protocol,
-    port: parsed.port,
-    env,
-    isProduction: env === "production",
-    isPreview: env === "preview",
-    isLocal: env === "local"
-  };
-}
-var _resolved = createUrl();
-var href = _resolved.href;
-var origin = _resolved.origin;
-var hostname = _resolved.hostname;
-var host = _resolved.host;
-var protocol = _resolved.protocol;
-var port = _resolved.port;
-var env = _resolved.env;
-var isProduction = _resolved.isProduction;
-var isPreview = _resolved.isPreview;
-var isLocal = _resolved.isLocal;
-var src_default = _resolved;

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAqClE,QAAA,IAAI,SAAS,EAAE,iBAAiB,CAAA;AA6BhC,0DAA0D;AAC1D,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,yDAAyD;AACzD,eAAO,MAAM,MAAM,EAAE,MAAyB,CAAA;AAC9C,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,EAAE,MAA2B,CAAA;AAClD,+DAA+D;AAC/D,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,oDAAoD;AACpD,eAAO,MAAM,QAAQ,EAAE,MAA2B,CAAA;AAClD,gEAAgE;AAChE,eAAO,MAAM,IAAI,EAAE,MAAuB,CAAA;AAC1C,sEAAsE;AACtE,eAAO,MAAM,GAAG,EAAE,MAAsB,CAAA;AACxC,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,EAAE,QAA6B,CAAA;AACpD,wCAAwC;AACxC,eAAO,MAAM,YAAY,EAAE,OAAgC,CAAA;AAC3D,0DAA0D;AAC1D,eAAO,MAAM,SAAS,EAAE,OAA6B,CAAA;AACrD,gDAAgD;AAChD,eAAO,MAAM,OAAO,EAAE,OAA2B,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,eAAe,SAAS,CAAA;AAExB,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA"}

package/dist/normalize.d.ts

@@ -1,2 +0,0 @@
-export declare function normalizeUrl(raw: string): string;
-//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/providers.d.ts

@@ -1,3 +0,0 @@
-import type { ProviderDetector } from "./types";
-export declare const providers: ProviderDetector[];
-//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-import type { Platform } from "./types";
-export interface ResolveResult {
-    url: string;
-    debugLabel: string;
-}
-export declare function resolveUrl(): ResolveResult;
-export declare function resolvePlatform(): Platform;
-//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,IAAI,aAAa,CAuC1C;AAED,wBAAgB,eAAe,IAAI,QAAQ,CAQ1C"}

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAEvD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,SAAS,GACT,KAAK,GACL,QAAQ,GACR,cAAc,GACd,QAAQ,CAAA;AAEZ,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,IAAI,CAAA;AAE1C,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,OAAO,CAAA;IAC5D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,MAAM,GAAG,IAAI,CAAA;IACtE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,MAAM,CAAA;CAChE"}