@palbase/web 1.10.0 → 2.0.1

package/README.md

@@ -34,8 +34,9 @@ wires `import './palbe.gen';` into your app entry, and adds a `predev`/`prebuild
 hook that keeps the types in sync. **Commit `palbe.gen.ts`** — it's the typed
 client your app imports, not a build artifact.
 
-The generated file calls `__configure(...)` with your project's URL and anon API
-key at module load, so importing it once at startup is all the setup there is.
+The generated file calls `__configure(...)` with your project's URL, app ID, and
+anon API key at module load, so importing it once at startup is all the setup
+there is.
 If you forget to import it, every `pb` call throws a guided `BackendError`
 (`kind: 'notConfigured'`).
 

package/dist/{analytics-facade-B7vujhPJ.d.cts → analytics-facade-ChlBRcLZ.d.cts}

@@ -1,6 +1,6 @@
 import { Room, ExternalE2EEKeyProvider } from 'livekit-client';
 import { S as SessionStorageAdapter } from './storage-BPaeSG8K.cjs';
-import { F } from './pooled-flags-Bwq4usn0.js';
+import { F } from './pooled-flags-4GtDtsiu.js';
 
 declare class PalbaseError$1 extends Error {
     readonly code: string;
@@ -620,18 +620,19 @@ interface PalbeOAuthConfig {
 interface PalbeConfig {
     url: string;
     apiKey: string;
-    /** Informational — url+apiKey are already branch-specific (endpointRef embeds the branch slug); gen bakes all three consistently. */
-    branch?: string;
+    /** Registered app identity persisted by `palbase web link`. */
+    appId: string;
     /**
-     * F2 app-registration: the registered app `identifier` from
-     * `palbase-config.json` — for web this is the declared ORIGIN (e.g.
-     * `https://app.example.com`). When non-empty, `configure` REFUSES to build the
-     * runtime if `window.location.origin` does not match (SDK-REFUSES), and the
-     * value rides on `X-Palbase-Bundle` on EVERY request so the Kong gate can match
-     * it (the IDENTICAL header + value the iOS SDK sends). Empty/absent → legacy /
-     * tooling: no guard, no header.
+     * The ENVIRONMENT this config targets — informational only.
+     *
+     * `url` and `apiKey` ALREADY identify the environment (the ref is the host
+     * label and is embedded in the key), so nothing at runtime reads this: it is
+     * here so a developer looking at the generated file can see WHICH runtime it
+     * points at. It replaces the old `branch` field — the Palbase branch is gone
+     * as a resource, and a second, drift-prone name for the same runtime is
+     * exactly how a build ends up talking to production from a staging checkout.
      */
-    identifier?: string;
+    environmentRef?: string;
     oauth?: PalbeOAuthConfig;
     /** Refresh-token persistence. Default: endpoint-scoped localStorage in browsers, memory elsewhere. */
     storage?: SessionStorageAdapter;
@@ -687,7 +688,7 @@ declare class PalbeFlags {
      *
      * DEVIATION from iOS sync-cache parity: the platform does not propagate
      * variant metadata into the user-flags snapshot/delta cache, so this is an
-     * ASYNC transport read (`GET /v1/flags/{key}/variant`), not a cache lookup.
+     * ASYNC transport read (derived from `GET /v1/user-flags`), not a cache lookup.
      */
     getVariant(key: string): Promise<string | null>;
     /** Subscribe to any change in the cached flag set. */
@@ -1690,14 +1691,6 @@ declare class PalbeRealtime {
 
 interface PalbeRuntime {
     config: PalbeConfig;
-    /**
-     * F2 app-registration: the registered app `identifier` (web ORIGIN) stashed at
-     * configure. Rides on `X-Palbase-Bundle` on EVERY request (request.ts) so the
-     * Kong gate can match it. Empty string when the binding is unconfigured/tooling
-     * (no header is sent). Origin-match is enforced in `buildRuntime` BEFORE this
-     * runtime is returned — a mismatch throws there and no runtime is built.
-     */
-    appIdentifier: string;
     http: HttpClient$1;
     tokenManager: TokenManager$1;
     authClient: AuthClient;

package/dist/{analytics-facade-CHh5EGC2.d.ts → analytics-facade-G0il4NrT.d.ts}

@@ -1,6 +1,6 @@
 import { Room, ExternalE2EEKeyProvider } from 'livekit-client';
 import { S as SessionStorageAdapter } from './storage-BPaeSG8K.js';
-import { F } from './pooled-flags-Bwq4usn0.js';
+import { F } from './pooled-flags-4GtDtsiu.js';
 
 declare class PalbaseError$1 extends Error {
     readonly code: string;
@@ -620,18 +620,19 @@ interface PalbeOAuthConfig {
 interface PalbeConfig {
     url: string;
     apiKey: string;
-    /** Informational — url+apiKey are already branch-specific (endpointRef embeds the branch slug); gen bakes all three consistently. */
-    branch?: string;
+    /** Registered app identity persisted by `palbase web link`. */
+    appId: string;
     /**
-     * F2 app-registration: the registered app `identifier` from
-     * `palbase-config.json` — for web this is the declared ORIGIN (e.g.
-     * `https://app.example.com`). When non-empty, `configure` REFUSES to build the
-     * runtime if `window.location.origin` does not match (SDK-REFUSES), and the
-     * value rides on `X-Palbase-Bundle` on EVERY request so the Kong gate can match
-     * it (the IDENTICAL header + value the iOS SDK sends). Empty/absent → legacy /
-     * tooling: no guard, no header.
+     * The ENVIRONMENT this config targets — informational only.
+     *
+     * `url` and `apiKey` ALREADY identify the environment (the ref is the host
+     * label and is embedded in the key), so nothing at runtime reads this: it is
+     * here so a developer looking at the generated file can see WHICH runtime it
+     * points at. It replaces the old `branch` field — the Palbase branch is gone
+     * as a resource, and a second, drift-prone name for the same runtime is
+     * exactly how a build ends up talking to production from a staging checkout.
      */
-    identifier?: string;
+    environmentRef?: string;
     oauth?: PalbeOAuthConfig;
     /** Refresh-token persistence. Default: endpoint-scoped localStorage in browsers, memory elsewhere. */
     storage?: SessionStorageAdapter;
@@ -687,7 +688,7 @@ declare class PalbeFlags {
      *
      * DEVIATION from iOS sync-cache parity: the platform does not propagate
      * variant metadata into the user-flags snapshot/delta cache, so this is an
-     * ASYNC transport read (`GET /v1/flags/{key}/variant`), not a cache lookup.
+     * ASYNC transport read (derived from `GET /v1/user-flags`), not a cache lookup.
      */
     getVariant(key: string): Promise<string | null>;
     /** Subscribe to any change in the cached flag set. */
@@ -1690,14 +1691,6 @@ declare class PalbeRealtime {
 
 interface PalbeRuntime {
     config: PalbeConfig;
-    /**
-     * F2 app-registration: the registered app `identifier` (web ORIGIN) stashed at
-     * configure. Rides on `X-Palbase-Bundle` on EVERY request (request.ts) so the
-     * Kong gate can match it. Empty string when the binding is unconfigured/tooling
-     * (no header is sent). Origin-match is enforced in `buildRuntime` BEFORE this
-     * runtime is returned — a mismatch throws there and no runtime is built.
-     */
-    appIdentifier: string;
     http: HttpClient$1;
     tokenManager: TokenManager$1;
     authClient: AuthClient;

package/dist/{chunk-4ZJHHXD3.js → chunk-AIPUO4QX.js}

@@ -420,12 +420,6 @@ async function palbeRequest(rt, method, path, spec = {}) {
   if (MUTATING.has(method) && !callerHasKey) {
     headers["Idempotency-Key"] = crypto.randomUUID();
   }
-  if (rt.appIdentifier !== "") {
-    const callerHasBundle = Object.keys(headers).some(
-      (k) => k.toLowerCase() === "x-palbase-bundle"
-    );
-    if (!callerHasBundle) headers["X-Palbase-Bundle"] = rt.appIdentifier;
-  }
   const attempt = async () => {
     try {
       return await rt.http.request(method, path, {
@@ -1409,23 +1403,6 @@ var PalbeAnalytics = class {
   }
 };
 
-// src/app-config.ts
-function loadAppConfig(raw) {
-  if (typeof raw !== "object" || raw === null) {
-    throw new Error("app_config_invalid: expected a JSON object");
-  }
-  const r = raw;
-  const str = (k) => typeof r[k] === "string" ? r[k] : "";
-  return { appId: str("app_id"), identifier: str("identifier"), envPreset: str("env_preset") };
-}
-function assertOriginMatches(cfg, runtimeOrigin) {
-  if (cfg.identifier === "") return;
-  if (runtimeOrigin === "") return;
-  if (runtimeOrigin !== cfg.identifier) {
-    throw new Error(`app_config_mismatch: expected origin ${cfg.identifier}, got ${runtimeOrigin}`);
-  }
-}
-
 // src/auth-wire.ts
 function asWireAuthResult(raw) {
   if (typeof raw !== "object" || raw === null) return null;
@@ -1992,6 +1969,19 @@ var PalbeCalls = class {
 
 // ../modules/flags/dist/index.js
 var FLAG_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+function flagEnabled(value) {
+  if (typeof value === "boolean") return value;
+  return value != null && value !== 0 && value !== "";
+}
+function flagVariant(value) {
+  return typeof value === "string" ? { name: value } : null;
+}
+function mapResponse(res, fn) {
+  if (res.error || res.data == null) {
+    return { ...res, data: null };
+  }
+  return { ...res, data: fn(res.data) };
+}
 var FlagsClient = class {
   httpClient;
   getCurrentUserId;
@@ -2011,10 +2001,11 @@ var FlagsClient = class {
         `Invalid flag name: "${flagName}". Flag names must match ${FLAG_NAME_RE.source}`
       );
     }
-    const params = this.buildContextParams(context);
-    const query = params.toString();
-    const path = `/v1/flags/${flagName}/enabled${query ? `?${query}` : ""}`;
-    return this.httpClient.request("GET", path);
+    const res = await this.httpClient.request(
+      "GET",
+      this.mergedPath(context)
+    );
+    return mapResponse(res, (snap) => flagEnabled(snap.values?.[flagName]));
   }
   async getVariant(flagName, context) {
     if (!FLAG_NAME_RE.test(flagName)) {
@@ -2022,16 +2013,29 @@ var FlagsClient = class {
         `Invalid flag name: "${flagName}". Flag names must match ${FLAG_NAME_RE.source}`
       );
     }
-    const params = this.buildContextParams(context);
-    const query = params.toString();
-    const path = `/v1/flags/${flagName}/variant${query ? `?${query}` : ""}`;
-    return this.httpClient.request("GET", path);
+    const res = await this.httpClient.request(
+      "GET",
+      this.mergedPath(context)
+    );
+    if (res.error || res.data == null) {
+      return { ...res, data: null };
+    }
+    return { ...res, data: flagVariant(res.data.values?.[flagName]) };
   }
   async getAll(context) {
-    const params = this.buildContextParams(context);
-    const query = params.toString();
-    const path = `/v1/flags${query ? `?${query}` : ""}`;
-    return this.httpClient.request("GET", path);
+    const res = await this.httpClient.request(
+      "GET",
+      this.mergedPath(context)
+    );
+    return mapResponse(res, (snap) => {
+      const values = snap.values ?? {};
+      return Object.keys(values).map((name) => {
+        const value = values[name];
+        const flag = { name, enabled: flagEnabled(value) };
+        if (typeof value === "string") flag.variant = { name: value };
+        return flag;
+      });
+    });
   }
   /**
    * Cold-start read: the full merged flag set for the current auth identity.
@@ -2130,15 +2134,16 @@ var FlagsClient = class {
       }
     };
   }
-  buildContextParams(context) {
-    const params = new URLSearchParams();
-    if (context?.userId) {
-      params.set("userId", context.userId);
-    }
-    if (context?.properties) {
-      params.set("properties", JSON.stringify(context.properties));
-    }
-    return params;
+  /**
+   * Resolve the merged-read path for a context. With `context.userId` present the
+   * read targets that specific user's merged view (`/v1/user-flags/users/{id}`, a
+   * privileged cross-user read); otherwise the current auth user's view
+   * (`/v1/user-flags`). `context.properties` has no server-side targeting support
+   * in the user-flags module and is ignored.
+   */
+  mergedPath(context) {
+    const uid = context?.userId;
+    return uid ? `/v1/user-flags/users/${encodeURIComponent(uid)}` : "/v1/user-flags";
   }
 };
 var DEFAULT_POLL_MS = 3e4;
@@ -2600,7 +2605,7 @@ var PalbeFlags = class {
    *
    * DEVIATION from iOS sync-cache parity: the platform does not propagate
    * variant metadata into the user-flags snapshot/delta cache, so this is an
-   * ASYNC transport read (`GET /v1/flags/{key}/variant`), not a cache lookup.
+   * ASYNC transport read (derived from `GET /v1/user-flags`), not a cache lookup.
    */
   async getVariant(key) {
     let res;
@@ -8239,6 +8244,14 @@ function observeWebVitals(record) {
   };
 }
 
+// src/runtime-metadata.ts
+var APP_METADATA_HEADER = "X-Palbase-Bundle";
+function applyBrowserOriginHeader(headers) {
+  if (Object.keys(headers).some((key) => key.toLowerCase() === "x-palbase-bundle")) return;
+  const origin = typeof window !== "undefined" && typeof window.location !== "undefined" ? window.location.origin : "";
+  if (origin !== "") headers[APP_METADATA_HEADER] = origin;
+}
+
 // src/realtime/anon-token.ts
 var REFRESH_SKEW_MS = 6e4;
 var AnonTokenProvider = class {
@@ -8281,11 +8294,16 @@ var AnonTokenProvider = class {
    */
   async mint() {
     const base = this.rt.config.url.replace(/\/+$/, "");
+    const headers = {
+      apikey: this.rt.config.apiKey,
+      ...this.rt.config.headers
+    };
+    applyBrowserOriginHeader(headers);
     let response;
     try {
       response = await fetch(`${base}/auth/anonymous`, {
         method: "POST",
-        headers: { apikey: this.rt.config.apiKey }
+        headers
       });
     } catch (e) {
       throw new BackendError("network", {
@@ -8926,17 +8944,15 @@ function defaultSessionStorage(key) {
 }
 
 // src/version.ts
-var VERSION = "1.10.0";
+var VERSION = "2.0.1";
 
 // src/runtime.ts
 function buildRuntime(config) {
-  const appIdentifier = config.identifier ?? "";
-  const runtimeOrigin = typeof window !== "undefined" && typeof window.location !== "undefined" ? window.location.origin : "";
-  assertOriginMatches(loadAppConfig({ identifier: appIdentifier }), runtimeOrigin);
   const http = new HttpClient(config.apiKey, {
     url: config.url,
     headers: { "X-Client-Info": `palbe-web/${VERSION}`, ...config.headers }
   });
+  http.addInterceptor(({ headers }) => applyBrowserOriginHeader(headers));
   const tokenManager = new TokenManager();
   http.tokenManager = tokenManager;
   const authClient = new AuthClient(http, tokenManager);
@@ -8985,7 +9001,6 @@ function buildRuntime(config) {
   let perf;
   const rt = {
     config,
-    appIdentifier,
     http,
     tokenManager,
     authClient,
@@ -9144,7 +9159,9 @@ async function buildHeaders(rt, extra) {
   if (token) headers.Authorization = `Bearer ${token}`;
   const callerHasKey = Object.keys(extra ?? {}).some((k) => k.toLowerCase() === "idempotency-key");
   if (!callerHasKey) headers["Idempotency-Key"] = crypto.randomUUID();
-  return { ...headers, ...extra };
+  const merged = { ...headers, ...extra };
+  applyBrowserOriginHeader(merged);
+  return merged;
 }
 function buildForm(options) {
   const form = new FormData();
@@ -9340,4 +9357,4 @@ export {
   pb,
   createBoundClient
 };
-//# sourceMappingURL=chunk-4ZJHHXD3.js.map
+//# sourceMappingURL=chunk-AIPUO4QX.js.map