@fonderie/client 1.3.0 → 1.4.0

package/brain/signatures.md

@@ -49,6 +49,7 @@ new FonderieClient(opts: IFonderieClientOptions): FonderieClient
   .webhooks: WebhooksClient
   .customers: CustomersClient
   .media: MediaClient
+  .config: ConfigClient
   .setAccessToken(token: string | undefined): void
   .clearCache(): void
   .setWorkspaceId(workspaceId: string | undefined): void
@@ -1614,4 +1615,17 @@ type CastResult = {
 };
 
 type ConfigValueType = 'string' | 'number' | 'boolean' | 'json';
+
+new ConfigClient(http: HttpClient, tokens: TokenStore): ConfigClient
+  .load(): Promise<IRemoteConfigState>
+  .get<T>(key: string, fallback: T): T
+  .snapshot(): IRemoteConfigState
+  .subscribe(listener: Listener): () => void
+
+interface IRemoteConfigState {
+    values: Readonly<Record<string, unknown>>;
+    loadedAt: Date | null;
+    isLoading: boolean;
+    error: unknown;
+}
 ```

package/dist/index.cjs

@@ -30,6 +30,7 @@ __export(index_exports, {
   CONFIG_KEY_PATTERN: () => CONFIG_KEY_PATTERN,
   CONFIG_VALUE_TYPES: () => CONFIG_VALUE_TYPES,
   ConfigAdminClient: () => ConfigAdminClient,
+  ConfigClient: () => ConfigClient,
   CourierAdminClient: () => CourierAdminClient,
   CustomersClient: () => CustomersClient,
   FonderieApiError: () => FonderieApiError,
@@ -1145,6 +1146,62 @@ var MediaClient = class {
   }
 };
 
+// src/modules/config.ts
+var ConfigClient = class {
+  constructor(http, tokens) {
+    this.http = http;
+    this.tokens = tokens;
+  }
+  http;
+  tokens;
+  state = { values: {}, loadedAt: null, isLoading: false, error: null };
+  listeners = /* @__PURE__ */ new Set();
+  inFlight = null;
+  // GET /config/public — fetch the public values into the shared snapshot.
+  // Concurrent calls share one request. A failure keeps the previous values
+  // (a flag that was on does not flicker off because one refresh failed) and
+  // is reported in `error`; before any success, reads fall back to defaults.
+  load() {
+    if (this.inFlight) return this.inFlight;
+    this.set({ isLoading: true });
+    this.inFlight = this.http.request({
+      method: "GET",
+      path: "/config/public",
+      // Sent when signed in, so per-user values can be served later
+      // without a client change; the route itself is public.
+      token: this.tokens.get()
+    }).then(
+      (res) => this.set({ values: res.result?.values ?? {}, loadedAt: /* @__PURE__ */ new Date(), isLoading: false, error: null }),
+      (error) => this.set({ isLoading: false, error })
+    ).finally(() => {
+      this.inFlight = null;
+    });
+    return this.inFlight;
+  }
+  // One value, with the fallback used when the key is absent — before the
+  // first load, when it failed, or when the server does not expose the key.
+  // Pick the SAFE fallback (feature off), not the optimistic one.
+  get(key, fallback) {
+    return Object.hasOwn(this.state.values, key) ? this.state.values[key] : fallback;
+  }
+  // The whole current state (values, loadedAt, isLoading, error).
+  snapshot() {
+    return this.state;
+  }
+  // Called with the new state after every change; returns an unsubscribe.
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  set(patch) {
+    this.state = { ...this.state, ...patch };
+    for (const listener of this.listeners) listener(this.state);
+    return this.state;
+  }
+};
+
 // src/modules/webhooks.ts
 var WebhooksClient = class {
   constructor(http, tokens) {
@@ -1481,6 +1538,8 @@ var FonderieClient = class {
   webhooks;
   customers;
   media;
+  /** Public remote config: flags and settings the server exposes to frontends. */
+  config;
   http;
   tokens;
   workspaceId;
@@ -1504,6 +1563,7 @@ var FonderieClient = class {
     this.webhooks = new WebhooksClient(this.http, this.tokens);
     this.customers = new CustomersClient(this.http, this.tokens);
     this.media = new MediaClient(this.http, this.tokens);
+    this.config = new ConfigClient(this.http, this.tokens);
     if (opts.workspaceId !== void 0) this.setWorkspaceId(opts.workspaceId);
   }
   // Single-flight refresh: POST /auth/refresh with the app-supplied refresh
@@ -2182,6 +2242,7 @@ function configKeyProblem(key) {
   CONFIG_KEY_PATTERN,
   CONFIG_VALUE_TYPES,
   ConfigAdminClient,
+  ConfigClient,
   CourierAdminClient,
   CustomersClient,
   FonderieApiError,