which-url 0.0.9 → 0.0.11

package/README.md

@@ -2,6 +2,8 @@
 
 Auto-detect your app's URL across hosting providers. Zero config.
 
+This README documents `which-url@0.0.11`.
+
 ```bash
 npm install which-url
 ```
@@ -22,16 +24,20 @@ Production    https://myapp.com                     "production"
 
 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.
 
+For browser bundles, framework-prefixed env vars must be referenced statically so the bundler can inline them at build time. `which-url` includes literal references such as `process.env.NEXT_PUBLIC_APP_URL` and `process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL`; dynamic lookup like `process.env["NEXT_PUBLIC_" + name]` cannot be inlined by Next.js.
+
 The default export gives you everything as an object:
 
 ```typescript
 import appUrl from 'which-url'
 
 appUrl.origin       // "https://myapp.com"
+appUrl.productionOrigin // "https://myapp.com" or undefined
 appUrl.hostname     // "myapp.com"
 appUrl.protocol     // "https:"
 appUrl.env          // "production"
 appUrl.platform     // "vercel"
+appUrl.isResolved   // true
 appUrl.isProduction // true
 ```
 
@@ -87,7 +93,11 @@ Reads environment variables that hosting providers set automatically:
 
 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.
+If nothing is detected in production, the default singleton returns empty current-URL strings and `isResolved: false` so imports stay safe in tests, client bundles, and build tools. Call `createUrl()` directly when a missing current URL should throw.
+
+`origin` is the current environment origin. In a preview deployment, it should point at the preview. In production, it should point at production. Locally, it should point at local dev.
+
+`productionOrigin` is the canonical production origin when configured or detectable, otherwise `undefined`. Use it for things that should still point at the public production site from previews, such as canonical metadata, social cards, and "view live site" links. When you need a URL in all environments, use `productionOrigin ?? origin`.
 
 ## Strict mode with `createUrl()`
 
@@ -109,6 +119,18 @@ 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`.
 
+If you intentionally use the import-safe singleton in production code, branch on `isResolved` before trusting URL strings:
+
+```typescript
+import { isResolved, origin } from 'which-url'
+
+if (!isResolved) {
+  throw new Error('APP_URL is required in production')
+}
+
+auth({ baseURL: origin })
+```
+
 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`
@@ -122,7 +144,40 @@ APP_URL=https://myapp.com
 
 Works with or without protocol (`APP_URL=myapp.com` → `https://myapp.com`).
 
-**Client-side frameworks:** All framework prefixes are supported automatically — `NEXT_PUBLIC_APP_URL`, `VITE_APP_URL`, `PUBLIC_APP_URL`, `NUXT_ENV_APP_URL`, etc.
+**Client-side frameworks:** All framework prefixes are supported automatically — `NEXT_PUBLIC_APP_URL`, `VITE_APP_URL`, `PUBLIC_APP_URL`, `NUXT_ENV_APP_URL`, etc. These are build-time values in browser bundles.
+
+## Production URL
+
+Use `APP_PRODUCTION_URL` when the canonical production URL is different from the current environment URL:
+
+```bash
+APP_PRODUCTION_URL=https://myapp.com
+```
+
+```typescript
+import { origin, productionOrigin } from 'which-url'
+
+origin           // current environment origin
+productionOrigin // canonical production origin, or undefined
+```
+
+On Vercel, `productionOrigin` is detected from `VERCEL_PROJECT_PRODUCTION_URL`, even in preview deployments.
+
+In Next.js browser bundles on Vercel deployments, it is detected from `NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL`. Vercel adds these framework-prefixed vars for production and preview deployments based on the framework preset, but `vercel env pull` does not create the prefixed local versions automatically.
+
+**Client-side frameworks:** Framework prefixes are supported here too — `NEXT_PUBLIC_APP_PRODUCTION_URL`, `VITE_APP_PRODUCTION_URL`, `PUBLIC_APP_PRODUCTION_URL`, etc. These are build-time values in browser bundles.
+
+## Multi-tenant apps
+
+For subdomain-based tenants, `hostname` is often enough when the current app host is also the tenant suffix:
+
+```typescript
+import { hostname } from 'which-url'
+
+const tenantSuffix = hostname
+```
+
+If your app origin and tenant suffix differ — for example `app.foo.com` for the product UI and `*.foo.com` for tenants — keep that suffix in your own env var for now. `which-url` does not currently expose a separate tenant suffix.
 
 ## Platform support
 
@@ -255,9 +310,11 @@ Strict resolver function. It resolves when called and throws if no URL can be de
 | `href` | `string` | Same as `origin` |
 | `protocol` | `string` | `"https:"` |
 | `port` | `string` | `""` or `"3000"` |
+| `productionOrigin` | `string \| undefined` | `"https://myapp.com"` or `undefined` |
 | `env` | `AppEnv` | `"production"` \| `"preview"` \| `"local"` |
 | `platform` | `Platform` | `"vercel"` \| `"netlify"` \| ... \| `null` |
 | `debug`* | `string` | `"[provider:vercel] url=myapp.com \| env=production (vercel:production)"` |
+| `isResolved` | `boolean` | `true` unless the import-safe fallback was used |
 | `isProduction` | `boolean` | |
 | `isPreview` | `boolean` | |
 | `isLocal` | `boolean` | |

package/dist/index.d.ts

@@ -13,12 +13,16 @@ export declare const host: string;
 export declare const protocol: string;
 /** Port string — `""` for default ports, `"3000"` for custom */
 export declare const port: string;
+/** Canonical production origin when configured or detectable, otherwise `undefined`. */
+export declare const productionOrigin: string | undefined;
 /** Current environment — `"production"`, `"preview"`, or `"local"` */
 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 the current URL resolved successfully; `false` only on the import-safe fallback. */
+export declare const isResolved: boolean;
 /** `true` when running in production */
 export declare const isProduction: boolean;
 /** `true` when running in a preview/staging deployment */
@@ -33,8 +37,10 @@ export declare const isLocal: boolean;
  * import appUrl from 'which-url'
  *
  * appUrl.origin      // "https://myapp.com"
+ * appUrl.productionOrigin // "https://myapp.com" or undefined
  * appUrl.env         // "production"
  * appUrl.platform    // "vercel"
+ * appUrl.isResolved  // true
  * appUrl.debug       // "[provider:vercel] url=myapp.com | env=production (vercel:production)"
  * ```
  */

package/dist/index.js

@@ -1 +1 @@
-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};
+var D=["VERCEL_ENV","VERCEL_URL","VERCEL_BRANCH_URL","VERCEL_PROJECT_PRODUCTION_URL","APP_URL","APP_PRODUCTION_URL","APP_ENV"];function G(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_PRODUCTION_URL":return process.env.APP_PRODUCTION_URL||process.env.NEXT_PUBLIC_APP_PRODUCTION_URL||process.env.NUXT_ENV_APP_PRODUCTION_URL||process.env.VITE_APP_PRODUCTION_URL||process.env.PUBLIC_APP_PRODUCTION_URL||process.env.REACT_APP_APP_PRODUCTION_URL||process.env.GATSBY_APP_PRODUCTION_URL||process.env.VUE_APP_APP_PRODUCTION_URL||process.env.REDWOOD_ENV_APP_PRODUCTION_URL||process.env.SANITY_STUDIO_APP_PRODUCTION_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,P){if(typeof process<"u"&&process?.env&&E===process.env){if(D.includes(P)){let _=G(P);if(_)return _}}let L=["","NEXT_PUBLIC_","NUXT_ENV_","VITE_","PUBLIC_","REACT_APP_","GATSBY_","VUE_APP_","REDWOOD_ENV_","SANITY_STUDIO_"];for(let _ of L){let A=E[_+P];if(A)return A}return}function I(E){if(E!==void 0)return K(E);if(typeof process<"u"&&process?.env)return process.env;return{}}function K(E){let P={};for(let[L,_]of Object.entries(E))if(typeof _==="string")P[L]=_;return P}var U=[{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},resolveProductionUrl:(E)=>C(E,"VERCEL_PROJECT_PRODUCTION_URL")||null,resolveEnv:(E)=>{let P=C(E,"VERCEL_ENV");if(P==="production")return"production";if(P==="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},resolveProductionUrl:(E)=>E.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,resolveProductionUrl:(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,resolveProductionUrl:(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,resolveProductionUrl:(E)=>E.IS_PULL_REQUEST==="true"?null: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,resolveProductionUrl:(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,resolveProductionUrl:(E)=>E.HEROKU_APP_NAME?`${E.HEROKU_APP_NAME}.herokuapp.com`:null,resolveEnv:()=>"production"}];function T(E){let P=E.trim().replace(/\/+$/,"");if(P.startsWith("http://")||P.startsWith("https://"))return P;return`https://${P}`}function F(E){let P=I(E),L=C(P,"APP_URL");if(L)return{url:T(L),debugLabel:`[override] APP_URL=${L}`};if(P.PORTLESS_TAILSCALE_URL)return{url:P.PORTLESS_TAILSCALE_URL,debugLabel:`[portless:tailscale] PORTLESS_TAILSCALE_URL=${P.PORTLESS_TAILSCALE_URL}`};if(P.PORTLESS_URL)return{url:P.PORTLESS_URL,debugLabel:`[portless] PORTLESS_URL=${P.PORTLESS_URL}`};for(let A of U)if(A.detect(P)){let R=A.resolveUrl(P);if(R)return{url:T(R),debugLabel:`[provider:${A.name}] url=${R}`}}if(typeof window<"u"&&window.location)return{url:window.location.origin,debugLabel:"[browser] window.location.origin"};if(P.NODE_ENV!=="production"){let A=P.PORT||"3000";return{url:`http://localhost:${A}`,debugLabel:`[fallback] PORT=${A}`}}throw Error("which-url: Cannot detect app URL. Set APP_URL environment variable.")}function H(E){let P=I(E),L=C(P,"APP_PRODUCTION_URL");if(L)return{url:T(L),debugLabel:`[production:override] APP_PRODUCTION_URL=${L}`};for(let A of U)if(A.detect(P)){let R=A.resolveProductionUrl?.(P);if(R)return{url:T(R),debugLabel:`[production:provider:${A.name}] url=${R}`}}for(let A of U)if(A.detect(P)&&A.resolveEnv(P)==="production"){let R=A.resolveUrl(P);if(R)return{url:T(R),debugLabel:`[production:current:${A.name}] url=${R}`}}let _=C(P,"APP_URL");if(_&&P.NODE_ENV==="production")return{url:T(_),debugLabel:`[production:current] APP_URL=${_}`};return null}function M(E){let P=I(E);for(let L of U)if(L.detect(P))return L.name;return null}var X=["production","preview","local"];function c(E){let P=I(E),L=C(P,"APP_ENV");if(L&&X.includes(L))return{env:L,debugLabel:`APP_ENV=${L}`};if(P.NODE_ENV==="development")return{env:"local",debugLabel:"NODE_ENV=development"};for(let _ of U)if(_.detect(P)){let A=_.resolveEnv(P);return{env:A,debugLabel:`${_.name}:${A}`}}if(P.NODE_ENV==="production")return{env:"production",debugLabel:"NODE_ENV=production"};return{env:"local",debugLabel:"default"}}function f(E){return Object.defineProperty(E,"debug",{value:E.debug,enumerable:!1,configurable:!1}),E}function S(E){let P=E?.env,{url:L,debugLabel:_}=F(P),A=new URL(L),{env:R,debugLabel:O}=c(P),V=M(P),t=H(P),Y=t?new URL(t.url).origin:void 0,B=t?` | production=${Y} (${t.debugLabel})`:" | production=unresolved",W=`${_} | env=${R} (${O})${B}`,$={href:A.origin,origin:A.origin,hostname:A.hostname,host:A.host,protocol:A.protocol,port:A.port,productionOrigin:Y,env:R,platform:V,debug:W,isResolved:!0,isProduction:R==="production",isPreview:R==="preview",isLocal:R==="local"};return f($)}function u(E){let P=E instanceof Error?E.message:"resolution failed",L="local",_="default";try{let R=c();L=R.env,_=R.debugLabel}catch{}let A={href:"",origin:"",hostname:"",host:"",protocol:"",port:"",productionOrigin:void 0,env:L,platform:M(),debug:`[error] ${P} | env=${L} (${_})`,isResolved:!1,isProduction:L==="production",isPreview:L==="preview",isLocal:L==="local"};return f(A)}var N;try{N=S()}catch(E){N=u(E)}var{href:l,origin:g,hostname:i,host:o,protocol:s,port:n,productionOrigin:d,env:a,platform:p,debug:r,isResolved:v,isProduction:e,isPreview:EE,isLocal:PE}=N,LE=N;export{s as protocol,d as productionOrigin,n as port,p as platform,g as origin,v as isResolved,e as isProduction,EE as isPreview,PE as isLocal,l as href,i as hostname,o as host,a as env,LE as default,r as debug,S as createUrl};

package/dist/types.d.ts

@@ -14,10 +14,14 @@ export interface WhichUrl {
     readonly protocol: string;
     /** Port string — `""` for default ports, `"3000"` for custom */
     readonly port: string;
+    /** Canonical production origin when configured or detectable, otherwise `undefined`. */
+    readonly productionOrigin: string | undefined;
     /** Current environment — `"production"`, `"preview"`, or `"local"` */
     readonly env: AppEnv;
     /** Detected hosting platform — `"vercel"`, `"netlify"`, etc. or `null` */
     readonly platform: Platform;
+    /** `true` when the current URL resolved successfully; `false` only on the import-safe fallback. */
+    readonly isResolved: boolean;
     /** `true` when running in production */
     readonly isProduction: boolean;
     /** `true` when running in a preview/staging deployment */
@@ -45,6 +49,7 @@ export interface ProviderDetector {
     name: PlatformName;
     detect: (env: Record<string, string | undefined>) => boolean;
     resolveUrl: (env: Record<string, string | undefined>) => string | null;
+    resolveProductionUrl?: (env: Record<string, string | undefined>) => string | null;
     resolveEnv: (env: Record<string, string | undefined>) => AppEnv;
 }
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "which-url",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Auto-detect your app's URL across hosting providers. Zero config.",
   "type": "module",
   "exports": {
@@ -31,6 +31,8 @@
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --format esm --minify && tsc --emitDeclarationOnly --outDir dist",
     "test": "bun test",
+    "release:check": "bun test && bun run build && git diff --quiet && git diff --cached --quiet && node -e \"const { execSync } = require('node:child_process'); const version = require('./package.json').version; const tag = execSync('git describe --tags --exact-match', { encoding: 'utf8' }).trim(); const expected = 'v' + version; if (tag !== expected) throw new Error('package.json version ' + version + ' must match checked-out tag ' + tag)\"",
+    "release:publish": "bun run release:check && git push && git push --tags && npm publish",
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {