which-url 0.0.1

package/README.md

@@ -0,0 +1,195 @@
+# which-url
+
+Auto-detect your app's URL across hosting providers. Zero config.
+
+```bash
+npm install which-url
+```
+
+```typescript
+import whichUrl from 'which-url'
+
+whichUrl.href      // "https://myapp.vercel.app"
+whichUrl.hostname  // "myapp.vercel.app"
+```
+
+Works on Vercel, Netlify, Cloudflare Pages, Railway, Fly.io, Render, DigitalOcean, and Heroku — automatically.
+
+## Usage
+
+### Named exports (plain strings — zero type friction)
+
+```typescript
+import { href, hostname, origin, isProduction } from 'which-url'
+
+// Pass directly to any function that expects a string
+process.env.BETTER_AUTH_URL = href
+fetch(`${href}/api/data`)
+cookie.domain = hostname
+
+if (isProduction) {
+  // production-only logic
+}
+```
+
+### 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.
+
+**Resolution priority:**
+
+1. `APP_URL` env var (your override — always wins)
+2. Provider auto-detection
+3. `window.location.origin` (browser)
+4. `http://localhost:${PORT || 3000}` (development)
+5. Throws in production if nothing detected
+
+## Provider support
+
+| Provider | Detection | URL source |
+|----------|-----------|------------|
+| **Vercel** | `VERCEL` | `VERCEL_PROJECT_PRODUCTION_URL` / `VERCEL_BRANCH_URL` / `VERCEL_URL` |
+| **Netlify** | `NETLIFY` | `URL` / `DEPLOY_PRIME_URL` / `DEPLOY_URL` |
+| **Cloudflare Pages** | `CF_PAGES` | `CF_PAGES_URL` |
+| **Railway** | `RAILWAY_PUBLIC_DOMAIN` | `RAILWAY_PUBLIC_DOMAIN` |
+| **Fly.io** | `FLY_APP_NAME` | `{app}.fly.dev` |
+| **Render** | `RENDER` | `RENDER_EXTERNAL_URL` |
+| **DigitalOcean** | `DIGITALOCEAN_APP_PLATFORM` | `APP_URL` |
+| **Heroku** | `HEROKU_APP_NAME` | `{app}.herokuapp.com` |
+
+## Override with `APP_URL`
+
+Set `APP_URL` to override auto-detection. Useful for custom domains, tunnels, or unsupported providers.
+
+```bash
+# .env.local
+APP_URL=https://myapp.com
+```
+
+`NEXT_PUBLIC_APP_URL` also works (for client-side access in Next.js).
+
+## Local development
+
+Zero config — auto-detects `http://localhost:3000` (or `PORT` if set).
+
+```bash
+# Custom port
+APP_URL=http://localhost:4000
+
+# Custom local domain
+APP_URL=http://myapp.local:3000
+
+# Local HTTPS (mkcert)
+APP_URL=https://localhost:3000
+
+# Tunnel
+APP_URL=https://abc123.ngrok-free.app
+```
+
+For tunnels with dynamic URLs:
+
+```bash
+APP_URL=$(curl -s localhost:4040/api/tunnels | jq -r '.tunnels[0].public_url') npm run dev
+```
+
+## Error handling
+
+In **production**, `which-url` throws if it can't detect the URL — preventing silent misconfiguration (broken OAuth, CORS, emails pointing to localhost).
+
+Use `createUrl` with a fallback to opt into lenient behavior:
+
+```typescript
+import { createUrl } from 'which-url'
+
+const url = createUrl({ fallback: 'https://fallback.example.com' })
+url.href // never throws
+```
+
+In **development**, it always falls back to localhost.
+
+## Cloudflare Workers
+
+Cloudflare Workers use runtime `env` bindings instead of `process.env`. Set `APP_URL` in `wrangler.toml`:
+
+```toml
+[vars]
+APP_URL = "https://myapp.workers.dev"
+```
+
+Modern wrangler polyfills `process.env` from `[vars]`, so `which-url` picks it up automatically. Cloudflare Pages build-time env vars also work.
+
+## Integrations
+
+### Better Auth
+
+```typescript
+import { href } from 'which-url'
+import { betterAuth } from 'better-auth'
+
+export const auth = betterAuth({
+  baseURL: href,
+  // ...
+})
+```
+
+### NextAuth / Auth.js
+
+```typescript
+import { href } from 'which-url'
+
+// No need to set NEXTAUTH_URL manually
+process.env.NEXTAUTH_URL = href
+```
+
+## API
+
+### Named exports
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `href` | `string` | Full URL (`https://myapp.vercel.app`) |
+| `origin` | `string` | Origin (`https://myapp.vercel.app`) |
+| `hostname` | `string` | Hostname (`myapp.vercel.app`) |
+| `host` | `string` | Host with port (`myapp.vercel.app`) |
+| `protocol` | `string` | Protocol (`https:`) |
+| `port` | `string` | Port (empty if default) |
+| `env` | `AppEnv` | `"production"` \| `"preview"` \| `"local"` |
+| `isProduction` | `boolean` | `true` if production |
+| `isPreview` | `boolean` | `true` if preview/staging |
+| `isLocal` | `boolean` | `true` if local development |
+| `createUrl(options?)` | `function` | Create a new instance with custom options |
+
+### `createUrl(options?)`
+
+```typescript
+createUrl({ fallback?: string }): WhichUrl
+```
+
+Re-resolves the URL from current environment. Use for:
+- Custom fallbacks (never throws)
+- Re-resolution in tests
+- Dynamic configuration
+
+## License
+
+MIT

package/dist/env.d.ts

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

package/dist/env.d.ts.map

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

package/dist/index.cjs

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

@@ -0,0 +1,16 @@
+import type { WhichUrl, AppEnv, CreateUrlOptions } from "./types";
+export declare function createUrl(options?: CreateUrlOptions): WhichUrl;
+declare const _resolved: WhichUrl;
+export declare const href: string;
+export declare const origin: string;
+export declare const hostname: string;
+export declare const host: string;
+export declare const protocol: string;
+export declare const port: string;
+export declare const env: AppEnv;
+export declare const isProduction: boolean;
+export declare const isPreview: boolean;
+export declare const isLocal: boolean;
+export default _resolved;
+export type { WhichUrl, AppEnv, CreateUrlOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,184 @@
+// src/providers.ts
+var providers = [
+  {
+    name: "vercel",
+    detect: (env) => !!env.VERCEL,
+    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,
+    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(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) {
+    return window.location.origin;
+  }
+  const isProduction = env.NODE_ENV === "production";
+  if (!isProduction) {
+    const port = env.PORT || "3000";
+    return `http://localhost:${port}`;
+  }
+  if (options?.fallback) {
+    return normalizeUrl(options.fallback);
+  }
+  throw new Error("which-url: Cannot detect app URL. Set APP_URL environment variable.");
+}
+
+// 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;
+  }
+  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;
+export {
+  protocol,
+  port,
+  origin,
+  isProduction,
+  isPreview,
+  isLocal,
+  href,
+  hostname,
+  host,
+  env,
+  src_default as default,
+  createUrl
+};

package/dist/normalize.d.ts

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

package/dist/normalize.d.ts.map

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

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

package/dist/providers.d.ts.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,3 @@
+import type { CreateUrlOptions } from "./types";
+export declare function resolveUrl(options?: CreateUrlOptions): string;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

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

package/dist/types.d.ts

@@ -0,0 +1,23 @@
+export type AppEnv = "production" | "preview" | "local";
+export interface WhichUrl {
+    href: string;
+    origin: string;
+    hostname: string;
+    host: string;
+    protocol: string;
+    port: string;
+    env: AppEnv;
+    isProduction: boolean;
+    isPreview: boolean;
+    isLocal: boolean;
+}
+export interface CreateUrlOptions {
+    fallback?: string;
+}
+export interface ProviderDetector {
+    name: string;
+    detect: (env: Record<string, string | undefined>) => boolean;
+    resolveUrl: (env: Record<string, string | undefined>) => string | null;
+    resolveEnv: (env: Record<string, string | undefined>) => AppEnv;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"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,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "which-url",
+  "version": "0.0.1",
+  "description": "Auto-detect your app's URL across hosting providers. Zero config.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "sideEffects": false,
+  "keywords": ["url", "base-url", "vercel", "netlify", "cloudflare", "railway", "hosting", "auto-detect", "which-url"],
+  "author": {
+    "name": "manishrc",
+    "url": "https://manishrc.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/manishrc/which-url"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --format esm && tsc --emitDeclarationOnly --outDir dist",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^5.8.0"
+  }
+}