which-url 0.0.4 → 0.0.5

package/README.md

@@ -167,15 +167,13 @@ APP_URL = "https://myapp.workers.dev"
 
 Modern wrangler polyfills `process.env` from `[vars]`, so `which-url` picks it up automatically.
 
-### `createUrl(options?)`
-
-Re-resolves the URL from the current environment. Unlike the singleton (which catches errors), `createUrl()` throws in production if no URL is detected.
+### Debugging
 
 ```typescript
-import { createUrl } from 'which-url'
+import { debug } from 'which-url'
 
-const url = createUrl({ fallback: 'https://fallback.example.com' })
-url.origin // never throws
+console.log(debug)
+// "platform=vercel | source=provider | url=https://myapp.com | env=production"
 ```
 
 ## API
@@ -196,6 +194,8 @@ An object with URL properties and environment helpers.
 | `port` | `string` | `""` or `"3000"` |
 | `env` | `AppEnv` | `"production"` \| `"preview"` \| `"local"` |
 | `platform` | `Platform` | `"vercel"` \| `"netlify"` \| ... \| `null` |
+| `source` | `Source` | `"override"` \| `"provider"` \| `"browser"` \| `"fallback"` \| `null` |
+| `debug` | `string` | `"platform=vercel \| source=provider \| url=https://myapp.com \| env=production"` |
 | `isProduction` | `boolean` | |
 | `isPreview` | `boolean` | |
 | `isLocal` | `boolean` | |

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import type { WhichUrl, AppEnv, Platform, CreateUrlOptions } from "./types";
-export declare function createUrl(options?: CreateUrlOptions): WhichUrl;
+import type { WhichUrl, AppEnv, Platform, Source } from "./types";
 declare let _resolved: WhichUrl;
 export declare const href: string;
 export declare const origin: string;
@@ -9,9 +8,11 @@ export declare const protocol: string;
 export declare const port: string;
 export declare const env: AppEnv;
 export declare const platform: Platform;
+export declare const source: Source;
+export declare const debug: string;
 export declare const isProduction: boolean;
 export declare const isPreview: boolean;
 export declare const isLocal: boolean;
 export default _resolved;
-export type { WhichUrl, AppEnv, Platform, CreateUrlOptions };
+export type { WhichUrl, AppEnv, Platform, Source };
 //# sourceMappingURL=index.d.ts.map

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,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE3E,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CAkB9D;AAGD,QAAA,IAAI,SAAS,EAAE,QAAQ,CAAA;AAuBvB,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,QAAQ,EAAE,QAA6B,CAAA;AACpD,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,QAAQ,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,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AA0BjE,QAAA,IAAI,SAAS,EAAE,QAAQ,CAAA;AAyBvB,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,QAAQ,EAAE,QAA6B,CAAA;AACpD,eAAO,MAAM,MAAM,EAAE,MAAyB,CAAA;AAC9C,eAAO,MAAM,KAAK,EAAE,MAAwB,CAAA;AAC5C,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,QAAQ,EAAE,MAAM,EAAE,CAAA"}

package/dist/index.js

@@ -144,28 +144,25 @@ function normalizeUrl(raw) {
 }
 
 // src/resolve.ts
-function resolveUrl(options) {
+function resolveUrl() {
   const env = getEnv();
   const override = getVar(env, "APP_URL");
   if (override)
-    return normalizeUrl(override);
+    return { url: normalizeUrl(override), source: "override" };
   for (const p of providers) {
     if (p.detect(env)) {
       const url = p.resolveUrl(env);
       if (url)
-        return normalizeUrl(url);
+        return { url: normalizeUrl(url), source: "provider" };
     }
   }
   if (typeof window !== "undefined" && window.location) {
-    return window.location.origin;
+    return { url: window.location.origin, source: "browser" };
   }
   const isProduction = env.NODE_ENV === "production";
   if (!isProduction) {
     const port = env.PORT || "3000";
-    return `http://localhost:${port}`;
-  }
-  if (options?.fallback) {
-    return normalizeUrl(options.fallback);
+    return { url: `http://localhost:${port}`, source: "fallback" };
   }
   throw new Error("which-url: Cannot detect app URL. Set APP_URL environment variable.");
 }
@@ -200,11 +197,12 @@ function resolveEnv() {
 }
 
 // src/index.ts
-function createUrl(options) {
-  const resolved = resolveUrl(options);
-  const parsed = new URL(resolved);
+function resolve() {
+  const { url, source } = resolveUrl();
+  const parsed = new URL(url);
   const env = resolveEnv();
   const platform = resolvePlatform();
+  const debug = `platform=${platform ?? "none"} | source=${source} | url=${parsed.origin} | env=${env}`;
   return {
     href: parsed.origin,
     origin: parsed.origin,
@@ -214,6 +212,8 @@ function createUrl(options) {
     port: parsed.port,
     env,
     platform,
+    source,
+    debug,
     isProduction: env === "production",
     isPreview: env === "preview",
     isLocal: env === "local"
@@ -221,7 +221,7 @@ function createUrl(options) {
 }
 var _resolved;
 try {
-  _resolved = createUrl();
+  _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)`);
   _resolved = {
@@ -233,6 +233,8 @@ try {
     port: "",
     env: "local",
     platform: null,
+    source: null,
+    debug: "platform=none | source=none | url=none | env=local",
     isProduction: false,
     isPreview: false,
     isLocal: true
@@ -246,11 +248,14 @@ var protocol = _resolved.protocol;
 var port = _resolved.port;
 var env = _resolved.env;
 var platform = _resolved.platform;
+var source = _resolved.source;
+var debug = _resolved.debug;
 var isProduction = _resolved.isProduction;
 var isPreview = _resolved.isPreview;
 var isLocal = _resolved.isLocal;
 var src_default = _resolved;
 export {
+  source,
   protocol,
   port,
   platform,
@@ -263,5 +268,5 @@ export {
   host,
   env,
   src_default as default,
-  createUrl
+  debug
 };

package/dist/resolve.d.ts

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

package/dist/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEzD,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAoC7D;AAED,wBAAgB,eAAe,IAAI,QAAQ,CAQ1C"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,UAAU,IAAI,aAAa,CA+B1C;AAED,wBAAgB,eAAe,IAAI,QAAQ,CAQ1C"}

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 export type AppEnv = "production" | "preview" | "local";
 export type Platform = "vercel" | "netlify" | "cloudflare" | "railway" | "fly" | "render" | "digitalocean" | "heroku" | null;
+export type Source = "override" | "provider" | "browser" | "fallback" | null;
 export interface WhichUrl {
     href: string;
     origin: string;
@@ -9,13 +10,12 @@ export interface WhichUrl {
     port: string;
     env: AppEnv;
     platform: Platform;
+    source: Source;
+    debug: string;
     isProduction: boolean;
     isPreview: boolean;
     isLocal: boolean;
 }
-export interface CreateUrlOptions {
-    fallback?: string;
-}
 export interface ProviderDetector {
     name: string;
     detect: (env: Record<string, string | undefined>) => boolean;

package/dist/types.d.ts.map

@@ -1 +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,MAAM,QAAQ,GAChB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,SAAS,GACT,KAAK,GACL,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,IAAI,CAAA;AAER,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,QAAQ,EAAE,QAAQ,CAAA;IAClB,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"}
+{"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,QAAQ,GAChB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,SAAS,GACT,KAAK,GACL,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,IAAI,CAAA;AAER,MAAM,MAAM,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAAA;AAE5E,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,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;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

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