@feelflow/ffid-sdk 0.1.0 → 0.3.0

package/dist/agency/index.d.ts

@@ -0,0 +1,321 @@
+export { D as DEFAULT_API_BASE_URL } from '../constants-BeWMWOOd.js';
+
+/**
+ * FFID Agency SDK Type Definitions
+ *
+ * Types for the FeelFlow ID Agency Management SDK.
+ * Used for managing agencies, members, organizations, branding,
+ * domain, email settings, billing, and hierarchy.
+ */
+/**
+ * Configuration for the FFID Agency Client
+ */
+interface FFIDAgencyClientConfig {
+    /** FFID API base URL (defaults to DEFAULT_API_BASE_URL) */
+    apiBaseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom logger */
+    logger?: FFIDAgencyLogger;
+}
+/**
+ * Logger interface for Agency SDK
+ */
+interface FFIDAgencyLogger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+type FFIDAgencyStatus = 'active' | 'suspended' | 'inactive';
+type FFIDAgencyBillingType = 'direct' | 'consolidated' | 'markup';
+type FFIDAgencyMemberRole = 'owner' | 'admin' | 'sales' | 'support';
+type FFIDAgencyMemberStatus = 'active' | 'invited' | 'suspended';
+type FFIDAgencyBillingOverride = 'default' | 'direct' | 'exempt';
+type FFIDSslStatus = 'pending' | 'active' | 'failed';
+interface FFIDAgency {
+    id: string;
+    name: string;
+    slug: string;
+    isPlatformOwner: boolean;
+    parentAgencyId: string | null;
+    status: FFIDAgencyStatus;
+    settings: FFIDAgencySettings;
+    billingType: FFIDAgencyBillingType;
+    contactEmail: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface FFIDAgencySettings {
+    branding?: FFIDAgencyBrandingSettings;
+    domain?: FFIDAgencyDomainSettings;
+    email?: FFIDAgencyEmailSettings;
+}
+interface FFIDAgencyBrandingSettings {
+    logoUrl?: string;
+    faviconUrl?: string;
+    primaryColor?: string;
+    secondaryColor?: string;
+    companyName?: string;
+}
+interface FFIDAgencyDnsRecord {
+    type: string;
+    name: string;
+    value: string;
+}
+interface FFIDAgencyDomainSettings {
+    customDomain?: string;
+    sslStatus?: FFIDSslStatus;
+    verifiedAt?: string;
+    dnsRecords?: FFIDAgencyDnsRecord[];
+}
+interface FFIDAgencyEmailSettings {
+    fromName?: string;
+    fromEmail?: string;
+    replyTo?: string;
+}
+interface FFIDAgencyMember {
+    userId: string;
+    email: string;
+    displayName: string | null;
+    avatarUrl: string | null;
+    role: FFIDAgencyMemberRole;
+    status: FFIDAgencyMemberStatus;
+    joinedAt: string | null;
+    invitedAt: string | null;
+}
+interface FFIDAddAgencyMemberRequest {
+    email: string;
+    role?: FFIDAgencyMemberRole;
+}
+interface FFIDUpdateAgencyMemberRequest {
+    role: FFIDAgencyMemberRole;
+}
+interface FFIDAgencyOrganization {
+    id: string;
+    agencyId: string;
+    organizationId: string;
+    organizationName: string;
+    organizationSlug: string;
+    billingOverride: FFIDAgencyBillingOverride;
+    commissionRate: number | null;
+    markupRate: number | null;
+    markupFixed: number | null;
+    notes: string | null;
+    createdAt: string;
+}
+interface FFIDLinkOrganizationRequest {
+    organizationId: string;
+    billingOverride?: FFIDAgencyBillingOverride;
+    commissionRate?: number;
+    notes?: string;
+}
+interface FFIDCreateSubAgencyRequest {
+    name: string;
+    contactEmail?: string;
+    settings?: FFIDAgencySettings;
+}
+interface FFIDAgencyHierarchyNode {
+    agency: FFIDAgency;
+    children: FFIDAgencyHierarchyNode[];
+    level: number;
+}
+interface FFIDAgencyHierarchyResponse {
+    root: FFIDAgencyHierarchyNode;
+    totalLevels: number;
+    totalAgencies: number;
+}
+type FFIDAgencyAssetType = 'logo' | 'favicon';
+interface FFIDAgencyBillingConfig {
+    billingType: FFIDAgencyBillingType;
+    stripeCustomerId: string | null;
+    invoiceEmail: string | null;
+    paymentTerms: number | null;
+    defaultMarkupRate: number | null;
+    defaultMarkupFixed: number | null;
+}
+interface FFIDUpdateAgencyBillingRequest {
+    billingType?: FFIDAgencyBillingType;
+    invoiceEmail?: string;
+    paymentTerms?: number;
+    defaultMarkupRate?: number;
+    defaultMarkupFixed?: number;
+}
+interface FFIDAgencyBillingSummary {
+    agencyId: string;
+    totalOrganizations: number;
+    totalRevenue: number;
+    period: string;
+}
+type FFIDAgencyInvoiceStatus = 'draft' | 'open' | 'paid' | 'void' | 'uncollectible';
+interface FFIDAgencyInvoice {
+    id: string;
+    amount: number;
+    currency: string;
+    status: FFIDAgencyInvoiceStatus;
+    periodStart: string;
+    periodEnd: string;
+    createdAt: string;
+}
+interface FFIDAgencyRevenue {
+    agencyId: string;
+    totalRevenue: number;
+    breakdown: Record<string, number>;
+    period: string;
+}
+interface FFIDSetupDomainRequest {
+    customDomain: string;
+}
+interface FFIDUpdateEmailSettingsRequest {
+    fromName?: string;
+    fromEmail?: string;
+    replyTo?: string;
+}
+interface FFIDUpdateAgencyRequest {
+    name?: string;
+    contactEmail?: string;
+    settings?: FFIDAgencySettings;
+}
+/**
+ * Public interface for the FFID Agency API client.
+ * Obtain an instance via `createFFIDAgencyClient()`.
+ */
+interface FFIDAgencyClient {
+    getAgencies(): Promise<FFIDAgencyApiResponse<{
+        agencies: FFIDAgency[];
+        count: number;
+    }>>;
+    getAgency(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        agency: FFIDAgency;
+    }>>;
+    updateAgency(agencyId: string, data: FFIDUpdateAgencyRequest): Promise<FFIDAgencyApiResponse<{
+        agency: FFIDAgency;
+    }>>;
+    getMembers(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        members: FFIDAgencyMember[];
+        count: number;
+    }>>;
+    addMember(agencyId: string, data: FFIDAddAgencyMemberRequest): Promise<FFIDAgencyApiResponse<{
+        member: FFIDAgencyMember;
+    }>>;
+    updateMember(agencyId: string, userId: string, data: FFIDUpdateAgencyMemberRequest): Promise<FFIDAgencyApiResponse<{
+        member: FFIDAgencyMember;
+    }>>;
+    removeMember(agencyId: string, userId: string): Promise<FFIDAgencyApiResponse<{
+        message: string;
+    }>>;
+    getOrganizations(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        organizations: FFIDAgencyOrganization[];
+        count: number;
+    }>>;
+    linkOrganization(agencyId: string, data: FFIDLinkOrganizationRequest): Promise<FFIDAgencyApiResponse<{
+        organization: FFIDAgencyOrganization;
+    }>>;
+    unlinkOrganization(agencyId: string, orgId: string): Promise<FFIDAgencyApiResponse<{
+        message: string;
+    }>>;
+    getSubAgencies(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        agencies: FFIDAgency[];
+        count: number;
+    }>>;
+    createSubAgency(agencyId: string, data: FFIDCreateSubAgencyRequest): Promise<FFIDAgencyApiResponse<{
+        agency: FFIDAgency;
+    }>>;
+    getHierarchy(agencyId: string): Promise<FFIDAgencyApiResponse<FFIDAgencyHierarchyResponse>>;
+    getBranding(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        branding: FFIDAgencyBrandingSettings;
+    }>>;
+    updateBranding(agencyId: string, data: FFIDAgencyBrandingSettings): Promise<FFIDAgencyApiResponse<{
+        branding: FFIDAgencyBrandingSettings;
+    }>>;
+    uploadAsset(agencyId: string, file: File, type: FFIDAgencyAssetType): Promise<FFIDAgencyApiResponse<{
+        url: string;
+    }>>;
+    getDomain(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        domain: FFIDAgencyDomainSettings;
+    }>>;
+    setupDomain(agencyId: string, data: FFIDSetupDomainRequest): Promise<FFIDAgencyApiResponse<{
+        domain: FFIDAgencyDomainSettings;
+    }>>;
+    removeDomain(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        message: string;
+    }>>;
+    verifyDomain(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        domain: FFIDAgencyDomainSettings;
+    }>>;
+    getEmailSettings(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        emailSettings: FFIDAgencyEmailSettings;
+    }>>;
+    updateEmailSettings(agencyId: string, data: FFIDUpdateEmailSettingsRequest): Promise<FFIDAgencyApiResponse<{
+        emailSettings: FFIDAgencyEmailSettings;
+    }>>;
+    getBilling(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        billing: FFIDAgencyBillingConfig;
+    }>>;
+    updateBilling(agencyId: string, data: FFIDUpdateAgencyBillingRequest): Promise<FFIDAgencyApiResponse<{
+        billing: FFIDAgencyBillingConfig;
+    }>>;
+    getBillingSummary(agencyId: string): Promise<FFIDAgencyApiResponse<FFIDAgencyBillingSummary>>;
+    getInvoices(agencyId: string): Promise<FFIDAgencyApiResponse<{
+        invoices: FFIDAgencyInvoice[];
+        count: number;
+    }>>;
+    getRevenue(agencyId: string): Promise<FFIDAgencyApiResponse<FFIDAgencyRevenue>>;
+}
+type FFIDAgencySdkErrorCode = 'NETWORK_ERROR' | 'PARSE_ERROR' | 'UNKNOWN_ERROR' | 'VALIDATION_ERROR';
+type FFIDAgencyServerErrorCode = 'UNAUTHORIZED' | 'FORBIDDEN' | 'NOT_FOUND' | 'VALIDATION_ERROR' | 'INTERNAL_ERROR' | 'CONFLICT';
+type FFIDAgencyErrorCode = FFIDAgencySdkErrorCode | FFIDAgencyServerErrorCode;
+interface FFIDAgencyServerError {
+    code: FFIDAgencyErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type FFIDAgencyServerResponse<T> = {
+    success: true;
+    data: T;
+    error?: undefined;
+} | {
+    success: false;
+    data?: undefined;
+    error: FFIDAgencyServerError;
+};
+interface FFIDAgencyError {
+    code: FFIDAgencyErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type FFIDAgencyApiResponse<T> = {
+    data: T;
+    error?: undefined;
+} | {
+    data?: undefined;
+    error: FFIDAgencyError;
+};
+
+/**
+ * FFID Agency API Client
+ *
+ * Handles API communication for agency management operations.
+ * Uses Cookie-based authentication (credentials: 'include')
+ * for browser-based communication.
+ *
+ * @example
+ * ```typescript
+ * import { createFFIDAgencyClient } from '@feelflow/ffid-sdk/agency'
+ *
+ * const agency = createFFIDAgencyClient()
+ *
+ * // Get agency details
+ * const { data, error } = await agency.getAgency('agency-id')
+ * ```
+ */
+
+declare const FFID_AGENCY_ERROR_CODES: {
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+};
+declare function createFFIDAgencyClient(config?: FFIDAgencyClientConfig): FFIDAgencyClient;
+
+export { type FFIDAddAgencyMemberRequest, type FFIDAgency, type FFIDAgencyApiResponse, type FFIDAgencyAssetType, type FFIDAgencyBillingConfig, type FFIDAgencyBillingOverride, type FFIDAgencyBillingSummary, type FFIDAgencyBillingType, type FFIDAgencyBrandingSettings, type FFIDAgencyClient, type FFIDAgencyClientConfig, type FFIDAgencyDnsRecord, type FFIDAgencyDomainSettings, type FFIDAgencyEmailSettings, type FFIDAgencyError, type FFIDAgencyErrorCode, type FFIDAgencyHierarchyNode, type FFIDAgencyHierarchyResponse, type FFIDAgencyInvoice, type FFIDAgencyInvoiceStatus, type FFIDAgencyLogger, type FFIDAgencyMember, type FFIDAgencyMemberRole, type FFIDAgencyMemberStatus, type FFIDAgencyOrganization, type FFIDAgencyRevenue, type FFIDAgencySdkErrorCode, type FFIDAgencyServerError, type FFIDAgencyServerErrorCode, type FFIDAgencyServerResponse, type FFIDAgencySettings, type FFIDAgencyStatus, type FFIDCreateSubAgencyRequest, type FFIDLinkOrganizationRequest, type FFIDSetupDomainRequest, type FFIDSslStatus, type FFIDUpdateAgencyBillingRequest, type FFIDUpdateAgencyMemberRequest, type FFIDUpdateAgencyRequest, type FFIDUpdateEmailSettingsRequest, FFID_AGENCY_ERROR_CODES, createFFIDAgencyClient };

package/dist/agency/index.js

@@ -0,0 +1,316 @@
+import { DEFAULT_API_BASE_URL } from '../chunk-P4MLCG4T.js';
+export { DEFAULT_API_BASE_URL } from '../chunk-P4MLCG4T.js';
+
+// src/agency/ffid-agency-client.ts
+var API_PREFIX = "/api/v1/agencies";
+var SDK_LOG_PREFIX = "[FFID Agency SDK]";
+var FFID_AGENCY_ERROR_CODES = {
+  NETWORK_ERROR: "NETWORK_ERROR",
+  PARSE_ERROR: "PARSE_ERROR",
+  UNKNOWN_ERROR: "UNKNOWN_ERROR",
+  VALIDATION_ERROR: "VALIDATION_ERROR"
+};
+var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: (...args) => console.warn(SDK_LOG_PREFIX, ...args),
+  error: (...args) => console.error(SDK_LOG_PREFIX, ...args)
+};
+var consoleLogger = {
+  debug: (...args) => console.debug(SDK_LOG_PREFIX, ...args),
+  info: (...args) => console.info(SDK_LOG_PREFIX, ...args),
+  warn: (...args) => console.warn(SDK_LOG_PREFIX, ...args),
+  error: (...args) => console.error(SDK_LOG_PREFIX, ...args)
+};
+function createFFIDAgencyClient(config = {}) {
+  const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+  const logger = config.logger ?? (config.debug ? consoleLogger : noopLogger);
+  function validateIds(...pairs) {
+    for (const [value, name] of pairs) {
+      if (!value) {
+        return {
+          error: {
+            code: FFID_AGENCY_ERROR_CODES.VALIDATION_ERROR,
+            message: `${name} is required`
+          }
+        };
+      }
+    }
+    return null;
+  }
+  async function fetchWithCredentials(endpoint, options = {}) {
+    const url = `${baseUrl}${API_PREFIX}${endpoint}`;
+    logger.debug("Fetching:", url);
+    let response;
+    try {
+      response = await fetch(url, {
+        ...options,
+        credentials: "include",
+        headers: {
+          // FormData: let browser set Content-Type with multipart boundary automatically
+          ...options.body instanceof FormData ? {} : { "Content-Type": "application/json" },
+          ...options.headers
+        }
+      });
+    } catch (error) {
+      logger.error("Network error:", { url, error });
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.NETWORK_ERROR,
+          message: error instanceof Error ? error.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+        }
+      };
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch (parseError) {
+      logger.error("Parse error:", { url, status: response.status, parseError });
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.PARSE_ERROR,
+          message: `\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u4E0D\u6B63\u306A\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u53D7\u4FE1\u3057\u307E\u3057\u305F (status: ${response.status})`
+        }
+      };
+    }
+    logger.debug("Response:", response.status, data);
+    if (!response.ok || !data.success) {
+      return {
+        error: data.error ?? {
+          code: FFID_AGENCY_ERROR_CODES.UNKNOWN_ERROR,
+          message: "\u4E0D\u660E\u306A\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+        }
+      };
+    }
+    if (data.data === void 0) {
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.UNKNOWN_ERROR,
+          message: "\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u30C7\u30FC\u30BF\u304C\u8FD4\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F"
+        }
+      };
+    }
+    return { data: data.data };
+  }
+  async function getAgencies() {
+    return fetchWithCredentials("");
+  }
+  async function getAgency(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}`);
+  }
+  async function updateAgency(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async function getMembers(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/members`);
+  }
+  async function addMember(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/members`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async function updateMember(agencyId, userId, data) {
+    const err = validateIds([agencyId, "agencyId"], [userId, "userId"]);
+    if (err) return err;
+    return fetchWithCredentials(
+      `/${encodeURIComponent(agencyId)}/members/${encodeURIComponent(userId)}`,
+      { method: "PUT", body: JSON.stringify(data) }
+    );
+  }
+  async function removeMember(agencyId, userId) {
+    const err = validateIds([agencyId, "agencyId"], [userId, "userId"]);
+    if (err) return err;
+    return fetchWithCredentials(
+      `/${encodeURIComponent(agencyId)}/members/${encodeURIComponent(userId)}`,
+      { method: "DELETE" }
+    );
+  }
+  async function getOrganizations(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/organizations`);
+  }
+  async function linkOrganization(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/organizations`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async function unlinkOrganization(agencyId, orgId) {
+    const err = validateIds([agencyId, "agencyId"], [orgId, "orgId"]);
+    if (err) return err;
+    return fetchWithCredentials(
+      `/${encodeURIComponent(agencyId)}/organizations/${encodeURIComponent(orgId)}`,
+      { method: "DELETE" }
+    );
+  }
+  async function getSubAgencies(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/sub-agencies`);
+  }
+  async function createSubAgency(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/sub-agencies`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async function getHierarchy(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/hierarchy`);
+  }
+  async function getBranding(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/branding`);
+  }
+  async function updateBranding(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/branding`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async function uploadAsset(agencyId, file, type) {
+    const validationErr = validateIds([agencyId, "agencyId"]);
+    if (validationErr) return validationErr;
+    const formData = new FormData();
+    formData.append("file", file);
+    formData.append("type", type);
+    return fetchWithCredentials(
+      `/${encodeURIComponent(agencyId)}/branding/upload`,
+      {
+        method: "POST",
+        body: formData
+      }
+    );
+  }
+  async function getDomain(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/domain`);
+  }
+  async function setupDomain(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/domain`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async function removeDomain(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/domain`, {
+      method: "DELETE"
+    });
+  }
+  async function verifyDomain(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/domain/verify`, {
+      method: "POST"
+    });
+  }
+  async function getEmailSettings(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/email-settings`);
+  }
+  async function updateEmailSettings(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/email-settings`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async function getBilling(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/billing`);
+  }
+  async function updateBilling(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/billing`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+  }
+  async function getBillingSummary(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/billing-summary`);
+  }
+  async function getInvoices(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/invoices`);
+  }
+  async function getRevenue(agencyId) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/revenue`);
+  }
+  return {
+    // Agency CRUD
+    getAgencies,
+    getAgency,
+    updateAgency,
+    // Members
+    getMembers,
+    addMember,
+    updateMember,
+    removeMember,
+    // Organizations
+    getOrganizations,
+    linkOrganization,
+    unlinkOrganization,
+    // Sub-Agencies
+    getSubAgencies,
+    createSubAgency,
+    // Hierarchy
+    getHierarchy,
+    // Branding
+    getBranding,
+    updateBranding,
+    uploadAsset,
+    // Domain
+    getDomain,
+    setupDomain,
+    removeDomain,
+    verifyDomain,
+    // Email Settings
+    getEmailSettings,
+    updateEmailSettings,
+    // Billing
+    getBilling,
+    updateBilling,
+    getBillingSummary,
+    getInvoices,
+    getRevenue
+  };
+}
+
+export { FFID_AGENCY_ERROR_CODES, createFFIDAgencyClient };