@fonderie/client 1.3.0 → 1.5.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
@@ -239,6 +240,7 @@ interface ISetConfigInput {
     description?: string;
     active?: boolean;
     ifVersion?: number;
+    allowTypeChange?: boolean;
 }
 
 interface ISetSecretInput {
@@ -1601,10 +1603,14 @@ function castConfigValue(type: ConfigValueType, raw: string): CastResult
 
 function configKeyProblem(key: string): string | null
 
+function configValueLabel(value: unknown): string
+
 function configValueType(value: unknown): ConfigValueType
 
 function formatConfigValue(value: unknown, type?: ConfigValueType): string
 
+function inferConfigValue(raw: string): IInferredConfigValue
+
 type CastResult = {
     ok: true;
     value: unknown;
@@ -1614,4 +1620,24 @@ type CastResult = {
 };
 
 type ConfigValueType = 'string' | 'number' | 'boolean' | 'json';
+
+interface IInferredConfigValue {
+    type: ConfigValueType;
+    value: unknown;
+    label: string;
+    ambiguous: boolean;
+}
+
+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,
@@ -39,10 +40,12 @@ __export(index_exports, {
   WorkspacesClient: () => WorkspacesClient,
   castConfigValue: () => castConfigValue,
   configKeyProblem: () => configKeyProblem,
+  configValueLabel: () => configValueLabel,
   configValueType: () => configValueType,
   createMemoryCache: () => createMemoryCache,
   describeLocation: () => describeLocation,
   formatConfigValue: () => formatConfigValue,
+  inferConfigValue: () => inferConfigValue,
   isMfaRequired: () => isMfaRequired
 });
 module.exports = __toCommonJS(index_exports);
@@ -1145,6 +1148,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 +1540,8 @@ var FonderieClient = class {
   webhooks;
   customers;
   media;
+  /** Public remote config: flags and settings the server exposes to frontends. */
+  config;
   http;
   tokens;
   workspaceId;
@@ -1504,6 +1565,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
@@ -2170,6 +2232,35 @@ function configKeyProblem(key) {
   if (!key) return "Enter a key.";
   return CONFIG_KEY_PATTERN.test(key) ? null : 'Start with a letter; use letters, digits, ".", "_" or "-" (max 128).';
 }
+var PLAIN_NUMBER = /^-?(0|[1-9]\d*)(\.\d+)?$/;
+function configValueLabel(value) {
+  if (typeof value === "string") return "Text";
+  if (typeof value === "number") return "Number";
+  if (typeof value === "boolean") return "On/off";
+  if (Array.isArray(value)) return "List";
+  if (value === null) return "Empty";
+  return "Object";
+}
+function inferConfigValue(raw) {
+  const t = raw.trim();
+  if (t === "true" || t === "false") {
+    return { type: "boolean", value: t === "true", label: "On/off", ambiguous: true };
+  }
+  if (PLAIN_NUMBER.test(t)) {
+    const n = Number(t);
+    if (Number.isFinite(n) && String(n) === t) return { type: "number", value: n, label: "Number", ambiguous: true };
+  }
+  if (t.startsWith("{") || t.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(t);
+      if (parsed !== null && typeof parsed === "object") {
+        return { type: "json", value: parsed, label: Array.isArray(parsed) ? "List" : "Object", ambiguous: false };
+      }
+    } catch {
+    }
+  }
+  return { type: "string", value: raw, label: "Text", ambiguous: false };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdminClient,
@@ -2182,6 +2273,7 @@ function configKeyProblem(key) {
   CONFIG_KEY_PATTERN,
   CONFIG_VALUE_TYPES,
   ConfigAdminClient,
+  ConfigClient,
   CourierAdminClient,
   CustomersClient,
   FonderieApiError,
@@ -2191,10 +2283,12 @@ function configKeyProblem(key) {
   WorkspacesClient,
   castConfigValue,
   configKeyProblem,
+  configValueLabel,
   configValueType,
   createMemoryCache,
   describeLocation,
   formatConfigValue,
+  inferConfigValue,
   isMfaRequired
 });
 //# sourceMappingURL=index.cjs.map