@fonderie/client 1.12.0 → 1.13.0

package/dist/index.d.cts

@@ -380,6 +380,47 @@ interface IAcceptInvitationResult {
 interface IWorkspaceSettingsResult {
     settings: IWorkspaceSettingsDTO;
 }
+interface ITemplateCatalog {
+    /** The system locale: the default (untagged) version is written in it. */
+    defaultLocale: string;
+    /** Per market or language, where its content comes from, before the system locale. */
+    fallbacks: Record<string, string[]>;
+    emails: ITemplateCatalogEntry[];
+}
+interface ITemplateCatalogEntry {
+    type: string;
+    /** Built-in email: its default version can be edited and rolled back, never deleted. */
+    system: boolean;
+    /** What Fonderie ships: the English default, and the other languages. */
+    builtIn: {
+        default: boolean;
+        languages: string[];
+    };
+    /** The app's saved versions (locale null = the default version). */
+    versions: Array<{
+        locale: string | null;
+        active: boolean;
+        version: number;
+        updatedAt: string;
+    }>;
+}
+interface IBuiltInTemplate {
+    type: string;
+    /** The language key it matched ('fr' for fr-CA), or the system locale for the English. */
+    locale: string;
+    subject: string | null;
+    html: string | null;
+    text: string;
+}
+interface ITemplateResolution {
+    requested: string;
+    /** Locales tried before the system locale, in order. */
+    chain: string[];
+    defaultLocale: string;
+    /** The version used: a saved tag, a built-in language, or the system locale. */
+    sent: string;
+    source: 'saved' | 'built-in';
+}
 interface ITemplateEntry {
     system?: boolean;
     type: string;
@@ -1722,6 +1763,9 @@ declare class CourierAdminClient {
     constructor(opts: ICourierAdminClientOptions);
     private rebase;
     listTemplates(): Promise<IApiResponse<ITemplateEntry[]>>;
+    getTemplateCatalog(): Promise<IApiResponse<ITemplateCatalog>>;
+    getBuiltInTemplate(type: string, locale?: string | null): Promise<IApiResponse<IBuiltInTemplate>>;
+    resolveTemplate(type: string, locale?: string | null): Promise<IApiResponse<ITemplateResolution>>;
     getTemplate(type: string, locale?: string | null): Promise<IApiResponse<ITemplateEntry>>;
     setTemplate(type: string, input: ISetTemplateInput, locale?: string | null): Promise<IApiResponse<ITemplateEntry>>;
     deleteTemplate(type: string, locale?: string | null): Promise<IApiResponse<undefined>>;
@@ -1748,6 +1792,32 @@ declare function groupTemplatesByType(rows: readonly ITemplateEntry[]): ITemplat
  * receipt is exactly the gap an operator is looking for.
  */
 declare function missingTemplateLocales(rows: readonly ITemplateEntry[], type: string): string[];
+/** One language an email exists in, as the console shows it. */
+interface ITemplateLanguage {
+    /** What to open: null is the default version. */
+    locale: string | null;
+    /** What to show: the default version is labelled with the system locale. */
+    label: string;
+    /** The app saved this version (else it is Fonderie's built-in copy, untouched). */
+    saved: boolean;
+    /** Fonderie ships this language. */
+    builtIn: boolean;
+    /** A saved version switched off is skipped when sending. Built-in copy is always on. */
+    active: boolean;
+}
+/**
+ * Every language one email exists in, sorted by label — the default version
+ * shown as the system locale ('en-US'), then e.g. 'es', 'fr', 'fr-CA'. A saved
+ * version and the built-in copy of the same language are one entry: the saved
+ * one is what sends.
+ */
+declare function templateLanguages(email: ITemplateCatalogEntry, defaultLocale: string): ITemplateLanguage[];
+/**
+ * What "Add locale" should suggest for `type`: locales the app already uses on
+ * other emails (saved or built-in) that this one lacks. Never the system locale
+ * — the default version already is that locale.
+ */
+declare function suggestTemplateLocales(catalog: ITemplateCatalog, type: string): string[];
 
 type ConfigValueType = 'string' | 'number' | 'boolean' | 'json';
 declare const CONFIG_VALUE_TYPES: readonly ConfigValueType[];
@@ -2389,6 +2459,8 @@ declare const en: {
             hint: string;
             loading: string;
             openLocale: string;
+            legend: string;
+            languages: string;
         };
         editor: {
             loading: string;
@@ -2412,6 +2484,16 @@ declare const en: {
             rollBack: string;
             confirmDelete: string;
             confirmDeleteLocale: string;
+            builtInCopy: string;
+            resetToBuiltIn: string;
+            confirmReset: string;
+            chain: string;
+            whoReceives: string;
+            whoPlaceholder: string;
+            check: string;
+            receives: string;
+            sourceSaved: string;
+            sourceBuiltIn: string;
         };
         create: {
             titleNew: string;
@@ -2431,6 +2513,7 @@ declare const en: {
             exists: string;
             existsLocale: string;
             untranslated: string;
+            errorDefaultLocale: string;
         };
     };
 };
@@ -2468,4 +2551,4 @@ type AdminT = ReturnType<typeof createAdminT>;
 /** Dates in the console's language: 'date', 'datetime' or 'time'. */
 declare function formatAdminDate(value: string | number | Date, locale?: AdminLocale | undefined, style?: 'date' | 'datetime' | 'time'): string;
 
-export { ADMIN_LOCALES, AdminClient, type AdminLocale, type AdminMessageKey, type AdminMessageParams, type AdminMessages, type AdminRouteGuard, type AdminScope, type AdminSessionState, type AdminT, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, DEFAULT_ADMIN_LOCALE, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminCreatedLink, type IAdminDoctorReport, type IAdminEnrollment, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminOperator, type IAdminOperatorLink, type IAdminOperatorsReport, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSecondFactor, type IAdminSession, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInferredConfigValue, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateGroup, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type LocaleMap, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, adminLocaleNames, adminLocaleTags, castConfigValue, configKeyProblem, configValueLabel, configValueType, createAdminT, createMemoryCache, describeLocation, detectAdminLocale, formatAdminDate, formatConfigValue, groupTemplatesByType, inferConfigValue, isAdminLocale, isMfaRequired, missingTemplateLocales };
+export { ADMIN_LOCALES, AdminClient, type AdminLocale, type AdminMessageKey, type AdminMessageParams, type AdminMessages, type AdminRouteGuard, type AdminScope, type AdminSessionState, type AdminT, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, DEFAULT_ADMIN_LOCALE, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminCreatedLink, type IAdminDoctorReport, type IAdminEnrollment, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminOperator, type IAdminOperatorLink, type IAdminOperatorsReport, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSecondFactor, type IAdminSession, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type IBuiltInTemplate, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInferredConfigValue, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateCatalog, type ITemplateCatalogEntry, type ITemplateEntry, type ITemplateGroup, type ITemplateLanguage, type ITemplateResolution, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type LocaleMap, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, adminLocaleNames, adminLocaleTags, castConfigValue, configKeyProblem, configValueLabel, configValueType, createAdminT, createMemoryCache, describeLocation, detectAdminLocale, formatAdminDate, formatConfigValue, groupTemplatesByType, inferConfigValue, isAdminLocale, isMfaRequired, missingTemplateLocales, suggestTemplateLocales, templateLanguages };

package/dist/index.d.ts

@@ -380,6 +380,47 @@ interface IAcceptInvitationResult {
 interface IWorkspaceSettingsResult {
     settings: IWorkspaceSettingsDTO;
 }
+interface ITemplateCatalog {
+    /** The system locale: the default (untagged) version is written in it. */
+    defaultLocale: string;
+    /** Per market or language, where its content comes from, before the system locale. */
+    fallbacks: Record<string, string[]>;
+    emails: ITemplateCatalogEntry[];
+}
+interface ITemplateCatalogEntry {
+    type: string;
+    /** Built-in email: its default version can be edited and rolled back, never deleted. */
+    system: boolean;
+    /** What Fonderie ships: the English default, and the other languages. */
+    builtIn: {
+        default: boolean;
+        languages: string[];
+    };
+    /** The app's saved versions (locale null = the default version). */
+    versions: Array<{
+        locale: string | null;
+        active: boolean;
+        version: number;
+        updatedAt: string;
+    }>;
+}
+interface IBuiltInTemplate {
+    type: string;
+    /** The language key it matched ('fr' for fr-CA), or the system locale for the English. */
+    locale: string;
+    subject: string | null;
+    html: string | null;
+    text: string;
+}
+interface ITemplateResolution {
+    requested: string;
+    /** Locales tried before the system locale, in order. */
+    chain: string[];
+    defaultLocale: string;
+    /** The version used: a saved tag, a built-in language, or the system locale. */
+    sent: string;
+    source: 'saved' | 'built-in';
+}
 interface ITemplateEntry {
     system?: boolean;
     type: string;
@@ -1722,6 +1763,9 @@ declare class CourierAdminClient {
     constructor(opts: ICourierAdminClientOptions);
     private rebase;
     listTemplates(): Promise<IApiResponse<ITemplateEntry[]>>;
+    getTemplateCatalog(): Promise<IApiResponse<ITemplateCatalog>>;
+    getBuiltInTemplate(type: string, locale?: string | null): Promise<IApiResponse<IBuiltInTemplate>>;
+    resolveTemplate(type: string, locale?: string | null): Promise<IApiResponse<ITemplateResolution>>;
     getTemplate(type: string, locale?: string | null): Promise<IApiResponse<ITemplateEntry>>;
     setTemplate(type: string, input: ISetTemplateInput, locale?: string | null): Promise<IApiResponse<ITemplateEntry>>;
     deleteTemplate(type: string, locale?: string | null): Promise<IApiResponse<undefined>>;
@@ -1748,6 +1792,32 @@ declare function groupTemplatesByType(rows: readonly ITemplateEntry[]): ITemplat
  * receipt is exactly the gap an operator is looking for.
  */
 declare function missingTemplateLocales(rows: readonly ITemplateEntry[], type: string): string[];
+/** One language an email exists in, as the console shows it. */
+interface ITemplateLanguage {
+    /** What to open: null is the default version. */
+    locale: string | null;
+    /** What to show: the default version is labelled with the system locale. */
+    label: string;
+    /** The app saved this version (else it is Fonderie's built-in copy, untouched). */
+    saved: boolean;
+    /** Fonderie ships this language. */
+    builtIn: boolean;
+    /** A saved version switched off is skipped when sending. Built-in copy is always on. */
+    active: boolean;
+}
+/**
+ * Every language one email exists in, sorted by label — the default version
+ * shown as the system locale ('en-US'), then e.g. 'es', 'fr', 'fr-CA'. A saved
+ * version and the built-in copy of the same language are one entry: the saved
+ * one is what sends.
+ */
+declare function templateLanguages(email: ITemplateCatalogEntry, defaultLocale: string): ITemplateLanguage[];
+/**
+ * What "Add locale" should suggest for `type`: locales the app already uses on
+ * other emails (saved or built-in) that this one lacks. Never the system locale
+ * — the default version already is that locale.
+ */
+declare function suggestTemplateLocales(catalog: ITemplateCatalog, type: string): string[];
 
 type ConfigValueType = 'string' | 'number' | 'boolean' | 'json';
 declare const CONFIG_VALUE_TYPES: readonly ConfigValueType[];
@@ -2389,6 +2459,8 @@ declare const en: {
             hint: string;
             loading: string;
             openLocale: string;
+            legend: string;
+            languages: string;
         };
         editor: {
             loading: string;
@@ -2412,6 +2484,16 @@ declare const en: {
             rollBack: string;
             confirmDelete: string;
             confirmDeleteLocale: string;
+            builtInCopy: string;
+            resetToBuiltIn: string;
+            confirmReset: string;
+            chain: string;
+            whoReceives: string;
+            whoPlaceholder: string;
+            check: string;
+            receives: string;
+            sourceSaved: string;
+            sourceBuiltIn: string;
         };
         create: {
             titleNew: string;
@@ -2431,6 +2513,7 @@ declare const en: {
             exists: string;
             existsLocale: string;
             untranslated: string;
+            errorDefaultLocale: string;
         };
     };
 };
@@ -2468,4 +2551,4 @@ type AdminT = ReturnType<typeof createAdminT>;
 /** Dates in the console's language: 'date', 'datetime' or 'time'. */
 declare function formatAdminDate(value: string | number | Date, locale?: AdminLocale | undefined, style?: 'date' | 'datetime' | 'time'): string;
 
-export { ADMIN_LOCALES, AdminClient, type AdminLocale, type AdminMessageKey, type AdminMessageParams, type AdminMessages, type AdminRouteGuard, type AdminScope, type AdminSessionState, type AdminT, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, DEFAULT_ADMIN_LOCALE, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminCreatedLink, type IAdminDoctorReport, type IAdminEnrollment, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminOperator, type IAdminOperatorLink, type IAdminOperatorsReport, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSecondFactor, type IAdminSession, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInferredConfigValue, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateGroup, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type LocaleMap, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, adminLocaleNames, adminLocaleTags, castConfigValue, configKeyProblem, configValueLabel, configValueType, createAdminT, createMemoryCache, describeLocation, detectAdminLocale, formatAdminDate, formatConfigValue, groupTemplatesByType, inferConfigValue, isAdminLocale, isMfaRequired, missingTemplateLocales };
+export { ADMIN_LOCALES, AdminClient, type AdminLocale, type AdminMessageKey, type AdminMessageParams, type AdminMessages, type AdminRouteGuard, type AdminScope, type AdminSessionState, type AdminT, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, DEFAULT_ADMIN_LOCALE, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminCreatedLink, type IAdminDoctorReport, type IAdminEnrollment, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminOperator, type IAdminOperatorLink, type IAdminOperatorsReport, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSecondFactor, type IAdminSession, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type IBuiltInTemplate, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInferredConfigValue, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateCatalog, type ITemplateCatalogEntry, type ITemplateEntry, type ITemplateGroup, type ITemplateLanguage, type ITemplateResolution, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, type LocaleMap, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, adminLocaleNames, adminLocaleTags, castConfigValue, configKeyProblem, configValueLabel, configValueType, createAdminT, createMemoryCache, describeLocation, detectAdminLocale, formatAdminDate, formatConfigValue, groupTemplatesByType, inferConfigValue, isAdminLocale, isMfaRequired, missingTemplateLocales, suggestTemplateLocales, templateLanguages };

package/dist/index.js

@@ -2125,6 +2125,41 @@ var CourierAdminClient = class {
       })
     );
   }
+  // Every email — saved or built-in only — with its languages and the app's
+  // locales. The flat listTemplates() only sees saved rows.
+  getTemplateCatalog() {
+    return this.http.request(
+      this.rebase({
+        method: "GET",
+        path: "/admin/template-catalog",
+        token: this.adminToken
+      })
+    );
+  }
+  // Fonderie's own copy in a language (omitted: the English default). 404 when
+  // none ships in that language.
+  getBuiltInTemplate(type, locale) {
+    const q = locale ? `?locale=${encodeURIComponent(locale)}` : "";
+    return this.http.request(
+      this.rebase({
+        method: "GET",
+        path: `/admin/templates/${encodeURIComponent(type)}/built-in${q}`,
+        token: this.adminToken
+      })
+    );
+  }
+  // Who receives what: decided server-side by the same function a real send
+  // runs, so the answer cannot drift from delivery.
+  resolveTemplate(type, locale) {
+    const q = locale ? `?locale=${encodeURIComponent(locale)}` : "";
+    return this.http.request(
+      this.rebase({
+        method: "GET",
+        path: `/admin/templates/${encodeURIComponent(type)}/resolve${q}`,
+        token: this.adminToken
+      })
+    );
+  }
   getTemplate(type, locale) {
     const q = locale ? `?locale=${encodeURIComponent(locale)}` : "";
     return this.http.request(
@@ -2218,6 +2253,40 @@ function missingTemplateLocales(rows, type) {
   const used = new Set(rows.map((r) => r.locale).filter((l) => l !== null && !has.has(l)));
   return [...used].sort();
 }
+function templateLanguages(email, defaultLocale) {
+  const out = /* @__PURE__ */ new Map();
+  const saved = new Map(email.versions.map((v) => [v.locale, v]));
+  const base = saved.get(null);
+  if (base || email.builtIn.default) {
+    out.set("", {
+      locale: null,
+      label: defaultLocale,
+      saved: Boolean(base),
+      builtIn: email.builtIn.default,
+      active: base ? base.active : true
+    });
+  }
+  for (const lang of email.builtIn.languages) {
+    const own = saved.get(lang);
+    out.set(lang, { locale: lang, label: lang, saved: Boolean(own), builtIn: true, active: own ? own.active : true });
+  }
+  for (const v of email.versions) {
+    if (v.locale === null || out.has(v.locale)) continue;
+    out.set(v.locale, { locale: v.locale, label: v.locale, saved: true, builtIn: false, active: v.active });
+  }
+  return [...out.values()].sort((a, b) => a.label.localeCompare(b.label));
+}
+function suggestTemplateLocales(catalog4, type) {
+  const email = catalog4.emails.find((e) => e.type === type);
+  const has = new Set(email ? templateLanguages(email, catalog4.defaultLocale).map((l) => l.label) : []);
+  const used = /* @__PURE__ */ new Set();
+  for (const e of catalog4.emails) {
+    for (const l of templateLanguages(e, catalog4.defaultLocale)) {
+      if (l.locale !== null && !has.has(l.label)) used.add(l.label);
+    }
+  }
+  return [...used].sort();
+}
 
 // src/types.ts
 function isMfaRequired(result) {
@@ -2946,7 +3015,9 @@ var templates = {
     newTemplate: "New template",
     hint: "Every email the app sends. Open one to edit its copy and preview it live.",
     loading: "Loading templates\u2026",
-    openLocale: "Open the {locale} version of {type}"
+    openLocale: "Open the {locale} version of {type}",
+    legend: "Solid: a version you saved. Dashed: Fonderie\u2019s built-in copy, not edited. Struck through: switched off.",
+    languages: "Languages"
   },
   editor: {
     loading: "Loading template\u2026",
@@ -2969,7 +3040,17 @@ var templates = {
     unknownActor: "unknown",
     rollBack: "Roll back",
     confirmDelete: 'Delete "{type}"?',
-    confirmDeleteLocale: 'Delete the {locale} version of "{type}"? People in that locale will receive the default version.'
+    confirmDeleteLocale: 'Delete the {locale} version of "{type}"? People in that locale will receive the default version.',
+    builtInCopy: "Fonderie\u2019s built-in copy. Saving creates your own version of it.",
+    resetToBuiltIn: "Reset to built-in",
+    confirmReset: "Replace your {locale} version with Fonderie\u2019s built-in copy?",
+    chain: "Fallback: {chain}",
+    whoReceives: "Who receives what",
+    whoPlaceholder: "A locale, e.g. fr-BE",
+    check: "Check",
+    receives: "A {requested} user receives the {sent} version.",
+    sourceSaved: "It is your saved version.",
+    sourceBuiltIn: "It is Fonderie\u2019s built-in copy."
   },
   create: {
     titleNew: "New template",
@@ -2988,7 +3069,8 @@ var templates = {
     errorText: "The plain-text body is required \u2014 it is what every email client can show.",
     exists: '"{type}" already exists \u2014 open it from the list to edit.',
     existsLocale: '"{type}" ({locale}) already exists \u2014 open it from the list to edit.',
-    untranslated: "Still the default copy: {fields}. Translate them before adding this locale."
+    untranslated: "Still the default copy: {fields}. Translate them before adding this locale.",
+    errorDefaultLocale: "{locale} is the default version of this email. Edit the default instead."
   }
 };
 var templates_default = templates;
@@ -3642,7 +3724,9 @@ var templates2 = {
     newTemplate: "Nueva plantilla",
     hint: "Cada correo que env\xEDa la aplicaci\xF3n. Abre uno para editar su contenido y ver la vista previa en directo.",
     loading: "Cargando plantillas\u2026",
-    openLocale: "Abrir la versi\xF3n {locale} de {type}"
+    openLocale: "Abrir la versi\xF3n {locale} de {type}",
+    legend: "S\xF3lido: una versi\xF3n que guardaste. Discontinuo: la versi\xF3n integrada de Fonderie, sin editar. Tachado: desactivada.",
+    languages: "Idiomas"
   },
   editor: {
     loading: "Cargando plantilla\u2026",
@@ -3665,7 +3749,17 @@ var templates2 = {
     unknownActor: "desconocido",
     rollBack: "Restaurar",
     confirmDelete: '\xBFEliminar "{type}"?',
-    confirmDeleteLocale: '\xBFEliminar la versi\xF3n {locale} de "{type}"? Las personas de ese idioma recibir\xE1n la versi\xF3n predeterminada.'
+    confirmDeleteLocale: '\xBFEliminar la versi\xF3n {locale} de "{type}"? Las personas de ese idioma recibir\xE1n la versi\xF3n predeterminada.',
+    builtInCopy: "Versi\xF3n integrada de Fonderie. Al guardarla se crea tu propia versi\xF3n.",
+    resetToBuiltIn: "Restablecer la versi\xF3n integrada",
+    confirmReset: "\xBFReemplazar tu versi\xF3n {locale} por la versi\xF3n integrada de Fonderie?",
+    chain: "Respaldo: {chain}",
+    whoReceives: "Qui\xE9n recibe qu\xE9",
+    whoPlaceholder: "Un idioma, p. ej. fr-BE",
+    check: "Comprobar",
+    receives: "Un usuario {requested} recibe la versi\xF3n {sent}.",
+    sourceSaved: "Es tu versi\xF3n guardada.",
+    sourceBuiltIn: "Es la versi\xF3n integrada de Fonderie."
   },
   create: {
     titleNew: "Nueva plantilla",
@@ -3684,7 +3778,8 @@ var templates2 = {
     errorText: "El cuerpo en texto plano es obligatorio \u2014 es lo que puede mostrar cualquier cliente de correo.",
     exists: '"{type}" ya existe \u2014 \xE1brela desde la lista para editarla.',
     existsLocale: '"{type}" ({locale}) ya existe \u2014 \xE1brela desde la lista para editarla.',
-    untranslated: "Todav\xEDa en la versi\xF3n predeterminada: {fields}. Trad\xFAcelos antes de a\xF1adir este idioma."
+    untranslated: "Todav\xEDa en la versi\xF3n predeterminada: {fields}. Trad\xFAcelos antes de a\xF1adir este idioma.",
+    errorDefaultLocale: "{locale} es la versi\xF3n predeterminada de este correo. Edita la predeterminada en su lugar."
   }
 };
 var templates_default2 = templates2;
@@ -4338,7 +4433,9 @@ var templates3 = {
     newTemplate: "Nouveau mod\xE8le",
     hint: "Chaque e-mail envoy\xE9 par l'application. Ouvrez-en un pour modifier son contenu et le pr\xE9visualiser en direct.",
     loading: "Chargement des mod\xE8les\u2026",
-    openLocale: "Ouvrir la version {locale} de {type}"
+    openLocale: "Ouvrir la version {locale} de {type}",
+    legend: "Plein : une version que vous avez enregistr\xE9e. Pointill\xE9s : la version int\xE9gr\xE9e de Fonderie, non modifi\xE9e. Barr\xE9 : d\xE9sactiv\xE9e.",
+    languages: "Langues"
   },
   editor: {
     loading: "Chargement du mod\xE8le\u2026",
@@ -4361,7 +4458,17 @@ var templates3 = {
     unknownActor: "inconnu",
     rollBack: "Restaurer",
     confirmDelete: "Supprimer \xAB {type} \xBB ?",
-    confirmDeleteLocale: "Supprimer la version {locale} de \xAB {type} \xBB ? Les personnes de cette langue recevront la version par d\xE9faut."
+    confirmDeleteLocale: "Supprimer la version {locale} de \xAB {type} \xBB ? Les personnes de cette langue recevront la version par d\xE9faut.",
+    builtInCopy: "Version int\xE9gr\xE9e de Fonderie. L\u2019enregistrer cr\xE9e votre propre version.",
+    resetToBuiltIn: "R\xE9tablir la version int\xE9gr\xE9e",
+    confirmReset: "Remplacer votre version {locale} par la version int\xE9gr\xE9e de Fonderie ?",
+    chain: "Repli : {chain}",
+    whoReceives: "Qui re\xE7oit quoi",
+    whoPlaceholder: "Une langue, p. ex. fr-BE",
+    check: "V\xE9rifier",
+    receives: "Un utilisateur {requested} re\xE7oit la version {sent}.",
+    sourceSaved: "C\u2019est votre version enregistr\xE9e.",
+    sourceBuiltIn: "C\u2019est la version int\xE9gr\xE9e de Fonderie."
   },
   create: {
     titleNew: "Nouveau mod\xE8le",
@@ -4380,7 +4487,8 @@ var templates3 = {
     errorText: "Le corps en texte brut est obligatoire \u2014 c\u2019est ce que tout client e-mail peut afficher.",
     exists: "\xAB {type} \xBB existe d\xE9j\xE0 \u2014 ouvrez-le depuis la liste pour le modifier.",
     existsLocale: "\xAB {type} \xBB ({locale}) existe d\xE9j\xE0 \u2014 ouvrez-le depuis la liste pour le modifier.",
-    untranslated: "Encore dans la version par d\xE9faut : {fields}. Traduisez-les avant d\u2019ajouter cette langue."
+    untranslated: "Encore dans la version par d\xE9faut : {fields}. Traduisez-les avant d\u2019ajouter cette langue.",
+    errorDefaultLocale: "{locale} est la version par d\xE9faut de cet e-mail. Modifiez plut\xF4t la version par d\xE9faut."
   }
 };
 var templates_default3 = templates3;
@@ -4468,6 +4576,8 @@ export {
   inferConfigValue,
   isAdminLocale,
   isMfaRequired,
-  missingTemplateLocales
+  missingTemplateLocales,
+  suggestTemplateLocales,
+  templateLanguages
 };
 //# sourceMappingURL=index.js.map