@praxium/sdk 0.3.31 → 0.3.42

package/dist/index.d.ts

@@ -180,20 +180,37 @@ type SocialLinks = {
  */
 type TeamMembers = Array<PublicTeamMember>;
 /**
- * Custom field exposed on the public team API
+ * Custom field with server-resolved label (specific locale requested).
+ * When locale is 'nl' or 'en', the server resolves labels and values
+ * to that locale — label is a plain string, values are resolved strings.
  */
 type CustomField = {
     /** Field identifier (snake_case) */
     identifier: string;
     /** Custom field type (e.g., STRING, LONG_TEXT, SEARCHABLE_LIST) */
     type: string;
-    /** Localized field label */
-    label: LocalizedText;
+    /** Server-resolved field label for the requested locale */
+    label: string;
     /** Resolved field value (type depends on field.type) */
     value: unknown;
 };
 /**
- * Public team member profile
+ * Custom field with multilingual label (locale='*' requested).
+ * When locale is '*', the server returns all translations — label
+ * is a MultilingualText object, values are multilingual objects.
+ */
+type MultilingualCustomField = {
+    /** Field identifier (snake_case) */
+    identifier: string;
+    /** Custom field type (e.g., STRING, LONG_TEXT, SEARCHABLE_LIST) */
+    type: string;
+    /** Multilingual field label (all available locales) */
+    label: MultilingualText;
+    /** Multilingual field value (type depends on field.type) */
+    value: unknown;
+};
+/**
+ * Public team member profile with server-resolved custom fields
  */
 type PublicTeamMember = {
     /**
@@ -209,10 +226,33 @@ type PublicTeamMember = {
      */
     publicImage: string;
     /**
-     * Custom fields assigned to the public-team API access profile
+     * Custom fields with server-resolved labels and values
      */
     customFields: Array<CustomField>;
 };
+/**
+ * Public team member profile with multilingual custom fields (locale='*')
+ */
+type MultilingualTeamMember = {
+    /**
+     * Staff member UUID
+     */
+    id: string;
+    /**
+     * Public display name
+     */
+    publicName: string;
+    /**
+     * Public profile image URL (Supabase CDN)
+     */
+    publicImage: string;
+    /**
+     * Custom fields with multilingual labels and values
+     */
+    customFields: Array<MultilingualCustomField>;
+};
+/** Text in multiple languages. Keys are locale codes (e.g., 'nl', 'en'). */
+type MultilingualText = Record<string, string>;
 /**
  * Bilingual text with Dutch (nl) and English (en) translations
  */
@@ -226,8 +266,6 @@ type BilingualText = {
      */
     en: string;
 };
-/** Text with locale-specific values. Keys are locale codes (e.g., 'nl', 'en'). */
-type LocalizedText = Record<string, string>;
 /**
  * FAQs grouped by category, ordered by category.order then faq.order
  */
@@ -611,6 +649,17 @@ type SubmitContactFormData = {
     url: '/api/public/{tenantSlug}/contact';
 };
 
+/**
+ * Supported locale codes for server-side content resolution.
+ * Adding a new language requires an SDK release.
+ */
+type SupportedLocale = 'nl' | 'en';
+/**
+ * Locale parameter for client creation.
+ * - Specific locale (`'nl'`, `'en'`) — server resolves labels/values
+ * - `'*'` — server returns all translations (multilingual mode)
+ */
+type ClientLocale = SupportedLocale | '*';
 interface TenantClientConfig {
     /** Platform base URL (e.g., 'https://platform.praxium.nl') */
     baseUrl: string;
@@ -618,18 +667,16 @@ interface TenantClientConfig {
     apiKey: string;
     /** Tenant identifier slug (must match the slug in the API key) */
     tenantSlug: string;
-    /** Accept-Language header for locale-aware responses (e.g., 'nl', 'en') */
-    locale: string;
+    /** Locale for server-side content resolution */
+    locale: ClientLocale;
 }
-declare function createTenantClient(config: TenantClientConfig): {
-    /** Resolve a LocalizedText to a string using the client's configured locale. */
-    localize: (text: LocalizedText | null | undefined) => string;
+/** Shared methods available on both client types */
+interface TenantClientBase {
     getOpeningHours: () => Promise<OpeningHours>;
     getContactDetails: () => Promise<ContactDetails>;
     getLocation: () => Promise<Location>;
     getBusinessName: () => Promise<BusinessName>;
     getSocialLinks: () => Promise<SocialLinks>;
-    getTeamMembers: () => Promise<TeamMembers>;
     getFaq: () => Promise<FaqContent>;
     getServiceVariants: () => Promise<PricingVariants>;
     getInsuranceInfo: () => Promise<InsuranceList>;
@@ -637,10 +684,22 @@ declare function createTenantClient(config: TenantClientConfig): {
     getPaymentMethods: () => Promise<PaymentMethodList>;
     getPolicyInfo: () => Promise<PolicyList>;
     getBookableServices: () => Promise<BookableServices>;
-    submitContactForm: (body: SubmitContactFormData["body"]) => Promise<ContactFormResult>;
-};
-/** Return type of createTenantClient for type inference */
-type TenantClient = ReturnType<typeof createTenantClient>;
+    submitContactForm: (body: SubmitContactFormData['body']) => Promise<ContactFormResult>;
+}
+/** Client for locale-specific responses (locale='nl', 'en', etc.) */
+interface TenantClient extends TenantClientBase {
+    getTeamMembers: () => Promise<TeamMembers>;
+}
+/** Client for multilingual responses (locale='*') */
+interface MultilingualTenantClient extends TenantClientBase {
+    getTeamMembers: () => Promise<MultilingualTeamMember[]>;
+}
+/** Multilingual mode: returns MultilingualTeamMember[] (use localizeText() helper for resolution) */
+declare function createTenantClient(config: TenantClientConfig & {
+    locale: '*';
+}): MultilingualTenantClient;
+/** Locale-specific mode: returns PublicTeamMember[] with resolved labels/values */
+declare function createTenantClient(config: TenantClientConfig): TenantClient;
 
 /**
  * Typed error hierarchy for the Praxium SDK.
@@ -707,39 +766,69 @@ declare class PraxiumRateLimitError extends PraxiumError {
 /**
  * Get a custom field value by identifier from a team member's custom fields.
  *
+ * Works with both resolved (locale-specific) and multilingual (locale='*') members.
+ *
  * **Type safety warning:** The generic `T` is a cast (`as T`) — the caller is
  * responsible for ensuring `T` matches the actual runtime value shape for the
  * given field type. No runtime validation is performed.
  *
- * Runtime value shapes by custom field type:
+ * Runtime value shapes by custom field type (locale-specific):
  * - `STRING`           → `string`
  * - `LONG_TEXT`        → `string`
  * - `NUMBER`           → `number`
  * - `BOOLEAN`          → `boolean`
- * - `SINGLE_SELECT`    → `BilingualText` (`{ nl: string; en: string }`)
- * - `MULTI_SELECT`     → `BilingualText[]`
- * - `SEARCHABLE_LIST`  → `BilingualText[]`
+ * - `SINGLE_SELECT`    → `string`
+ * - `MULTI_SELECT`     → `string[]`
+ * - `SEARCHABLE_LIST`  → `string[]`
  * - `DATE`             → `string` (ISO 8601 date)
  *
+ * Runtime value shapes by custom field type (locale='*'):
+ * - `SINGLE_SELECT`    → `MultilingualText`
+ * - `MULTI_SELECT`     → `MultilingualText[]`
+ * - `SEARCHABLE_LIST`  → `MultilingualText[]`
+ * - Others: same as locale-specific
+ *
  * @example
  * ```ts
- * // Caller must match T to the field's actual type:
- * const specs = getCustomFieldValue<BilingualText[]>(member, 'specializations')
+ * // Locale-specific client (values are resolved strings):
+ * const specs = getCustomFieldValue<string[]>(member, 'specializations')
  * const bigNr = getCustomFieldValue<string>(member, 'big_number')
+ *
+ * // Multilingual client (locale='*'):
+ * const specs = getCustomFieldValue<MultilingualText[]>(member, 'specializations')
  * ```
  *
- * @param member - Public team member
+ * @param member - Public team member (resolved or multilingual)
  * @param identifier - Field identifier to look up
  * @returns The field value cast to `T`, or `null` if no field with that identifier exists
  */
-declare function getCustomFieldValue<T = unknown>(member: PublicTeamMember, identifier: string): T | null;
+declare function getCustomFieldValue<T = unknown>(member: PublicTeamMember | MultilingualTeamMember, identifier: string): T | null;
 /**
  * Get a custom field by identifier.
  *
- * @param member - Public team member
+ * @param member - Public team member (resolved or multilingual)
  * @param identifier - Field identifier to look up
  * @returns The full custom field, or undefined if not found
  */
 declare function getCustomField(member: PublicTeamMember, identifier: string): CustomField | undefined;
+declare function getCustomField(member: MultilingualTeamMember, identifier: string): MultilingualCustomField | undefined;
+/**
+ * Resolve a MultilingualText object to a single string for the given locale.
+ *
+ * Fallback chain: requested locale → 'en' (fallback) → first available value → ''
+ *
+ * @param text - Multilingual text object with locale keys
+ * @param locale - Desired locale code (e.g., 'nl', 'en', 'de')
+ * @returns The resolved text string, or empty string if no value available
+ *
+ * @example
+ * ```typescript
+ * const label = { nl: 'Specialisaties', en: 'Specializations' }
+ * localizeText(label, 'nl') // 'Specialisaties'
+ * localizeText(label, 'de') // 'Specializations' (falls back to 'en')
+ * localizeText({}, 'nl')    // ''
+ * ```
+ */
+declare function localizeText(text: MultilingualText | null | undefined, locale: SupportedLocale): string;
 
-export { type ApiError, type BilingualText, type BookableService, type BookableServices, type BookableVariantInfo, type BusinessName, type ContactDetails, type ContactFormResult, type CustomField, type FaqCategory, type FaqContent, type FaqGroup, type FaqItem, type FeatureItem, type FeatureList, type InsuranceInfo, type InsuranceList, type LocalizedText, type Location, type OpeningHours, type PaymentMethod, type PaymentMethodList, type PolicyInfo, type PolicyList, PraxiumAuthError, PraxiumError, PraxiumForbiddenError, PraxiumNotFoundError, PraxiumRateLimitError, PraxiumValidationError, type PricingVariant, type PricingVariants, type PublicDaySchedule, type PublicTeamMember, type ServiceCategoryInfo, type SocialLinks, type TeamMembers, type TenantClient, type TenantClientConfig, type ValidationDetail, createTenantClient, getCustomField, getCustomFieldValue };
+export { type ApiError, type BilingualText, type BookableService, type BookableServices, type BookableVariantInfo, type BusinessName, type ClientLocale, type ContactDetails, type ContactFormResult, type CustomField, type FaqCategory, type FaqContent, type FaqGroup, type FaqItem, type FeatureItem, type FeatureList, type InsuranceInfo, type InsuranceList, type Location, type MultilingualCustomField, type MultilingualTeamMember, type MultilingualTenantClient, type MultilingualText, type OpeningHours, type PaymentMethod, type PaymentMethodList, type PolicyInfo, type PolicyList, PraxiumAuthError, PraxiumError, PraxiumForbiddenError, PraxiumNotFoundError, PraxiumRateLimitError, PraxiumValidationError, type PricingVariant, type PricingVariants, type PublicDaySchedule, type PublicTeamMember, type ServiceCategoryInfo, type SocialLinks, type SupportedLocale, type TeamMembers, type TenantClient, type TenantClientConfig, type ValidationDetail, createTenantClient, getCustomField, getCustomFieldValue, localizeText };

package/dist/index.js

@@ -928,19 +928,6 @@ var STATUS_ERROR_MAP = {
   429: PraxiumRateLimitError
 };
 
-// src/helpers.ts
-function getCustomFieldValue(member, identifier) {
-  const field = member.customFields.find((f) => f.identifier === identifier);
-  return field ? field.value : null;
-}
-function getCustomField(member, identifier) {
-  return member.customFields.find((f) => f.identifier === identifier);
-}
-function getLocalizedText(text, locale) {
-  if (!text) return "";
-  return text[locale] || text["en"] || Object.values(text)[0] || "";
-}
-
 // src/tenant-client.ts
 function unwrapOrThrow(result) {
   if (result.data !== void 0 && result.error === void 0) {
@@ -969,10 +956,7 @@ function createTenantClient(config) {
     return request;
   });
   const path = { tenantSlug: config.tenantSlug };
-  return {
-    // ─── Locale Helper ───
-    /** Resolve a LocalizedText to a string using the client's configured locale. */
-    localize: (text) => getLocalizedText(text, config.locale),
+  const baseMethods = {
     // ─── Layout Endpoints ───
     getOpeningHours: () => getOpeningHours({ client: clientInstance, path }).then(unwrapOrThrow),
     getContactDetails: () => getContactDetails({ client: clientInstance, path }).then(unwrapOrThrow),
@@ -980,7 +964,6 @@ function createTenantClient(config) {
     getBusinessName: () => getBusinessName({ client: clientInstance, path }).then(unwrapOrThrow),
     getSocialLinks: () => getSocialLinks({ client: clientInstance, path }).then(unwrapOrThrow),
     // ─── Content Endpoints ───
-    getTeamMembers: () => getTeamMembers({ client: clientInstance, path }).then(unwrapOrThrow),
     getFaq: () => getFaq({ client: clientInstance, path }).then(unwrapOrThrow),
     getServiceVariants: () => getServiceVariants({ client: clientInstance, path }).then(unwrapOrThrow),
     getInsuranceInfo: () => getInsuranceInfo({ client: clientInstance, path }).then(unwrapOrThrow),
@@ -991,6 +974,29 @@ function createTenantClient(config) {
     // ─── Contact Form ───
     submitContactForm: (body) => submitContactForm({ client: clientInstance, path, body }).then(unwrapOrThrow)
   };
+  if (config.locale === "*") {
+    return {
+      ...baseMethods,
+      getTeamMembers: () => getTeamMembers({ client: clientInstance, path }).then(unwrapOrThrow)
+    };
+  }
+  return {
+    ...baseMethods,
+    getTeamMembers: () => getTeamMembers({ client: clientInstance, path }).then(unwrapOrThrow)
+  };
+}
+
+// src/helpers.ts
+function getCustomFieldValue(member, identifier) {
+  const field = member.customFields.find((f) => f.identifier === identifier);
+  return field ? field.value : null;
+}
+function getCustomField(member, identifier) {
+  return member.customFields.find((f) => f.identifier === identifier);
+}
+function localizeText(text, locale) {
+  if (!text) return "";
+  return text[locale] || text["en"] || Object.values(text)[0] || "";
 }
 export {
   PraxiumAuthError,
@@ -1001,5 +1007,6 @@ export {
   PraxiumValidationError,
   createTenantClient,
   getCustomField,
-  getCustomFieldValue
+  getCustomFieldValue,
+  localizeText
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxium/sdk",
-  "version": "0.3.31",
+  "version": "0.3.42",
   "description": "Official TypeScript SDK for the Praxium platform API",
   "type": "module",
   "exports": {