@fabriktor/fx 0.0.65 → 0.0.67

package/dist/src/fx.d.ts

@@ -1,4 +1,4 @@
-import type { BillableOperator, CallsOperator, ChatOperator, ConnectionsOperator, ContactsOperator, FeedOperator, FulfillmentsOperator, JobsOperator, MarketplaceOperator, MemosOperator, NotificationsOperator, PaymentsOperator, PayrollsOperator, PreferencesOperator, PrivacyOperator, RoutesOperator, StorageOperator, TimesheetsOperator, TmpPhonesOperator, TmpUsernamesOperator, UsersOperator } from "@fabriktor/client";
+import type { BillableOperator, CallsOperator, ChatOperator, ConnectionsOperator, ContactsOperator, FeedOperator, FulfillmentsOperator, JobsOperator, MarketplaceOperator, MemosOperator, NotificationsOperator, PaymentsOperator, PayrollsOperator, PreferencesOperator, PrivacyOperator, ProcessesOperator, RoutesOperator, StorageOperator, TimesheetsOperator, TmpPhonesOperator, TmpUsernamesOperator, UsersOperator } from "@fabriktor/client";
 import type { AuthOperator } from "./auth/auth.js";
 import type { BillableFX, BillableFXOperator } from "./billable/billable.js";
 import type { CallsFX, CallsFXOperator } from "./calls/calls.js";
@@ -14,6 +14,7 @@ import type { PaymentsFX, PaymentsFXOperator } from "./payments/payments.js";
 import type { PayrollsFX, PayrollsFXOperator } from "./payrolls/payrolls.js";
 import type { PreferencesFX, PreferencesFXOperator } from "./preferences/preferences.js";
 import type { PrivacyFX, PrivacyFXOperator } from "./privacy/privacy.js";
+import type { ProcessesFX, ProcessesFXOperator } from "./processes/processes.js";
 import type { RoutesFX, RoutesFXOperator } from "./routes/routes.js";
 import type { SessionFX, SessionFXOperator } from "./session/session.js";
 import type { StorageFX, StorageFXOperator } from "./storage/storage.js";
@@ -36,6 +37,7 @@ export type FXOptions = {
     payrolls: PayrollsOperator;
     preferences: PreferencesOperator;
     privacy: PrivacyOperator;
+    processes: ProcessesOperator;
     routes: RoutesOperator;
     storage: StorageOperator;
     timesheets: TimesheetsOperator;
@@ -68,6 +70,7 @@ export interface FXOperator {
     payrolls: PayrollsFXOperator;
     preferences: PreferencesFXOperator;
     privacy: PrivacyFXOperator;
+    processes: ProcessesFXOperator;
     routes: RoutesFXOperator;
     session: SessionFXOperator;
     storage: StorageFXOperator;
@@ -89,6 +92,7 @@ export declare class FX implements FXOperator {
     payrolls: PayrollsFX;
     preferences: PreferencesFX;
     privacy: PrivacyFX;
+    processes: ProcessesFX;
     routes: RoutesFX;
     session: SessionFX;
     storage: StorageFX;

package/dist/src/fx.js

@@ -3,7 +3,7 @@
 // Licensed under the Apache License, Version 2.0 (the "License"); you may
 // not use this file except in compliance with the License. You may obtain
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
-import { newBillableClient, newCallsClient, newChatClient, newConnectionsClient, newContactsClient, newFeedClient, newFulfillmentsClient, newHTTPClient, newJobsClient, newMarketplaceClient, newMemosClient, newNotificationsClient, newPaymentsClient, newPayrollsClient, newPreferencesClient, newPrivacyClient, newRoutesClient, newStorageClient, newTimesheetsClient, newTmpPhonesClient, newTmpUsernamesClient, newUsersClient, } from "@fabriktor/client";
+import { newBillableClient, newCallsClient, newChatClient, newConnectionsClient, newContactsClient, newFeedClient, newFulfillmentsClient, newHTTPClient, newJobsClient, newMarketplaceClient, newMemosClient, newNotificationsClient, newPaymentsClient, newPayrollsClient, newPreferencesClient, newPrivacyClient, newProcessesClient, newRoutesClient, newStorageClient, newTimesheetsClient, newTmpPhonesClient, newTmpUsernamesClient, newUsersClient, } from "@fabriktor/client";
 import { newBillableFX } from "./billable/billable.js";
 import { newCallsFX } from "./calls/calls.js";
 import { newChatFX } from "./chat/chat.js";
@@ -18,6 +18,7 @@ import { newPaymentsFX } from "./payments/payments.js";
 import { newPayrollsFX } from "./payrolls/payrolls.js";
 import { newPreferencesFX } from "./preferences/preferences.js";
 import { newPrivacyFX } from "./privacy/privacy.js";
+import { newProcessesFX } from "./processes/processes.js";
 import { newRoutesFX } from "./routes/routes.js";
 import { newSessionFX } from "./session/session.js";
 import { newStorageFX } from "./storage/storage.js";
@@ -38,6 +39,7 @@ export class FX {
     payrolls;
     preferences;
     privacy;
+    processes;
     routes;
     session;
     storage;
@@ -83,6 +85,10 @@ export class FX {
         this.privacy = newPrivacyFX({
             privacy: opts.privacy,
         });
+        this.processes = newProcessesFX({
+            processes: opts.processes,
+            preferences_fx: this.preferences,
+        });
         this.routes = newRoutesFX({
             routes: opts.routes,
         });
@@ -197,6 +203,11 @@ export function newDefaultFX(opts) {
             base_url: opts.base_url,
             get_token,
         }),
+        processes: newProcessesClient({
+            http,
+            base_url: opts.base_url,
+            get_token,
+        }),
         routes: newRoutesClient({
             http,
             base_url: opts.base_url,

package/dist/src/index.d.ts

@@ -18,6 +18,7 @@ export * from "./payments/payments.js";
 export * from "./payrolls/payrolls.js";
 export * from "./preferences/preferences.js";
 export * from "./privacy/privacy.js";
+export * from "./processes/processes.js";
 export * from "./routes/routes.js";
 export * from "./session/session.js";
 export * from "./storage/storage.js";

package/dist/src/index.js

@@ -18,6 +18,7 @@ export * from "./payments/payments.js";
 export * from "./payrolls/payrolls.js";
 export * from "./preferences/preferences.js";
 export * from "./privacy/privacy.js";
+export * from "./processes/processes.js";
 export * from "./routes/routes.js";
 export * from "./session/session.js";
 export * from "./storage/storage.js";

package/dist/src/payments/payments.d.ts

@@ -61,6 +61,24 @@ export type CreateCreditLedgerEntryOptions = CreditLedgerEntryInsertOptions;
 export type ReplaceCreditLedgerEntryOptions = CreditLedgerEntryReplaceOptions;
 export type SearchCreditLedgerOptions = SearchPaymentRecordsOptions;
 export type SearchCreditLedgerPage = SearchPage<CreditLedgerEntry>;
+export declare const PmtAccountAccessStatus: {
+    readonly Missing: "missing";
+    readonly OnboardingRequired: "onboarding_required";
+    readonly RequirementsDue: "requirements_due";
+    readonly Ready: "ready";
+};
+export type PmtAccountAccessStatus = (typeof PmtAccountAccessStatus)[keyof typeof PmtAccountAccessStatus];
+export type PmtAccountAccess = {
+    account: PmtAccount | null;
+    status: PmtAccountAccessStatus;
+    ready: boolean;
+};
+export type GetPmtAccountAccessOptions = {
+    owner_id: string;
+};
+export declare function isPmtAccountReady(account: PmtAccount | null): boolean;
+export declare function currentPmtAccount(accounts: readonly PmtAccount[]): PmtAccount | null;
+export declare function pmtAccountAccess(account: PmtAccount | null): PmtAccountAccess;
 export declare const PublicPaymentSessionStatus: {
     readonly NotFound: "not_found";
     readonly Ready: "ready";
@@ -99,6 +117,7 @@ export interface PaymentsFXOperator {
     continuePmtAccountOnboarding(opts: ContinuePmtAccountOnboardingOptions): Promise<ContinuePmtAccountOnboardingResult>;
     replacePmtAccount(opts: ReplacePmtAccountOptions): Promise<PmtAccount>;
     searchPmtAccounts(opts: SearchPmtAccountsOptions): Promise<SearchPmtAccountsPage>;
+    getPmtAccountAccess(opts: GetPmtAccountAccessOptions): Promise<PmtAccountAccess>;
     createPmtBankAccount(opts: CreatePmtBankAccountOptions): Promise<PmtBankAccount>;
     replacePmtBankAccount(opts: ReplacePmtBankAccountOptions): Promise<PmtBankAccount>;
     searchPmtBankAccounts(opts: SearchPmtBankAccountsOptions): Promise<SearchPmtBankAccountsPage>;
@@ -136,6 +155,7 @@ export declare class PaymentsFX implements PaymentsFXOperator {
     continuePmtAccountOnboarding(opts: ContinuePmtAccountOnboardingOptions): Promise<ContinuePmtAccountOnboardingResult>;
     replacePmtAccount(opts: ReplacePmtAccountOptions): Promise<PmtAccount>;
     searchPmtAccounts(opts: SearchPmtAccountsOptions): Promise<SearchPmtAccountsPage>;
+    getPmtAccountAccess(opts: GetPmtAccountAccessOptions): Promise<PmtAccountAccess>;
     createPmtBankAccount(opts: CreatePmtBankAccountOptions): Promise<PmtBankAccount>;
     replacePmtBankAccount(opts: ReplacePmtBankAccountOptions): Promise<PmtBankAccount>;
     searchPmtBankAccounts(opts: SearchPmtBankAccountsOptions): Promise<SearchPmtBankAccountsPage>;

package/dist/src/payments/payments.js

@@ -46,6 +46,47 @@ const msgPublicSessionConsumed = "Public payment session has already been consum
 const msgPublicAmountInvalid = "Public payment amount must be a positive integer.";
 const msgPublicBalanceInvalid = "Public payment session balance is invalid.";
 const msgPublicAmountExceedsBalance = "Public payment amount cannot exceed the session balance.";
+export const PmtAccountAccessStatus = {
+    Missing: "missing",
+    OnboardingRequired: "onboarding_required",
+    RequirementsDue: "requirements_due",
+    Ready: "ready",
+};
+export function isPmtAccountReady(account) {
+    return (account !== null &&
+        !account.psp_deactivate &&
+        account.psp_id.trim() !== "" &&
+        account.psp_id !== ZeroID &&
+        account.is_onboarded &&
+        !account.is_currently_due &&
+        !account.is_external_account_due);
+}
+export function currentPmtAccount(accounts) {
+    return (accounts.find(isPmtAccountReady) ??
+        accounts.find((account) => !account.psp_deactivate) ??
+        null);
+}
+export function pmtAccountAccess(account) {
+    if (account === null) {
+        return { account, status: PmtAccountAccessStatus.Missing, ready: false };
+    }
+    if (account.is_currently_due ||
+        account.is_external_account_due) {
+        return {
+            account,
+            status: PmtAccountAccessStatus.RequirementsDue,
+            ready: false,
+        };
+    }
+    if (!isPmtAccountReady(account)) {
+        return {
+            account,
+            status: PmtAccountAccessStatus.OnboardingRequired,
+            ready: false,
+        };
+    }
+    return { account, status: PmtAccountAccessStatus.Ready, ready: true };
+}
 export const PublicPaymentSessionStatus = {
     NotFound: "not_found",
     Ready: "ready",
@@ -119,6 +160,22 @@ export class PaymentsFX {
             per_page: opts.per_page,
         });
     }
+    async getPmtAccountAccess(opts) {
+        const accounts = [];
+        let page = 1;
+        while (true) {
+            const out = await this.searchPmtAccounts({
+                owner_id: opts.owner_id,
+                page,
+            });
+            accounts.push(...out.results);
+            const account = currentPmtAccount(accounts);
+            if (isPmtAccountReady(account) || out.done) {
+                return pmtAccountAccess(account);
+            }
+            page = out.next_page;
+        }
+    }
     async createPmtBankAccount(opts) {
         const out = await this.payments.insertOnePmtBankAccount(opts);
         const id = requiredOperationID(out, msgCreatedPmtBankAccountIDMissing);

package/dist/src/preferences/preferences.d.ts

@@ -1,5 +1,5 @@
 import type { PreferencesOperator } from "@fabriktor/client";
-import { type OperationResult, type PrefPayment, type PrefClient, type PrefEmployee, type PrefCompany, type PrefVisibility, type PrefLanguage, type PrefNotif, type PrefEmail, type PrefTutorial } from "@fabriktor/schema";
+import { type InPrefClient, type InPrefCompany, type InPrefEmployee, type OperationResult, type PrefPayment, type PrefClient, type PrefEmployee, type PrefCompany, type PrefVisibility, type PrefLanguage, type PrefNotif, type PrefEmail, type PrefTutorial } from "@fabriktor/schema";
 type PrefPaymentInsertOptions = Parameters<PreferencesOperator["insertOnePrefPayment"]>[0];
 type PrefPaymentReplaceOptions = Parameters<PreferencesOperator["replaceOnePrefPayment"]>[0];
 type PrefClientInsertOptions = Parameters<PreferencesOperator["insertOnePrefClient"]>[0];
@@ -36,25 +36,61 @@ export type CreatePrefEmailOptions = PrefEmailInsertOptions;
 export type ReplacePrefEmailOptions = PrefEmailReplaceOptions;
 export type CreatePrefTutorialOptions = PrefTutorialInsertOptions;
 export type ReplacePrefTutorialOptions = PrefTutorialReplaceOptions;
+export type GetPrefClientOptions = {
+    owner_id: string;
+};
+export type GetPrefEmployeeOptions = {
+    owner_id: string;
+};
+export type GetPrefCompanyOptions = {
+    owner_id: string;
+};
+export type SavePrefClientOptions = {
+    current: PrefClient;
+    in: InPrefClient;
+};
+export type SavePrefEmployeeOptions = {
+    current: PrefEmployee;
+    in: InPrefEmployee;
+};
+export type SavePrefCompanyOptions = {
+    current: PrefCompany;
+    in: InPrefCompany;
+};
+export type GetPrefLanguageOptions = {
+    owner_id: string;
+};
 export type EnsurePrefLanguageOptions = {
     owner_id: string;
     language: string;
     country: string;
     speech_to_text_source_language?: string;
 };
+export type SaveSpeechToTextSourceLanguageOptions = {
+    owner_id: string;
+    speech_to_text_source_language: string;
+};
 export interface PreferencesFXOperator {
     createPrefPayment(opts: CreatePrefPaymentOptions): Promise<PrefPayment>;
     replacePrefPayment(opts: ReplacePrefPaymentOptions): Promise<PrefPayment>;
     createPrefClient(opts: CreatePrefClientOptions): Promise<PrefClient>;
     replacePrefClient(opts: ReplacePrefClientOptions): Promise<PrefClient>;
+    getPrefClient(opts: GetPrefClientOptions): Promise<PrefClient>;
+    savePrefClient(opts: SavePrefClientOptions): Promise<PrefClient>;
     createPrefEmployee(opts: CreatePrefEmployeeOptions): Promise<PrefEmployee>;
     replacePrefEmployee(opts: ReplacePrefEmployeeOptions): Promise<PrefEmployee>;
+    getPrefEmployee(opts: GetPrefEmployeeOptions): Promise<PrefEmployee>;
+    savePrefEmployee(opts: SavePrefEmployeeOptions): Promise<PrefEmployee>;
     createPrefCompany(opts: CreatePrefCompanyOptions): Promise<PrefCompany>;
     replacePrefCompany(opts: ReplacePrefCompanyOptions): Promise<PrefCompany>;
+    getPrefCompany(opts: GetPrefCompanyOptions): Promise<PrefCompany>;
+    savePrefCompany(opts: SavePrefCompanyOptions): Promise<PrefCompany>;
     createPrefVisibility(opts: CreatePrefVisibilityOptions): Promise<PrefVisibility>;
     replacePrefVisibility(opts: ReplacePrefVisibilityOptions): Promise<PrefVisibility>;
     createPrefLanguage(opts: CreatePrefLanguageOptions): Promise<PrefLanguage>;
     replacePrefLanguage(opts: ReplacePrefLanguageOptions): Promise<PrefLanguage>;
+    getPrefLanguage(opts: GetPrefLanguageOptions): Promise<PrefLanguage>;
+    saveSpeechToTextSourceLanguage(opts: SaveSpeechToTextSourceLanguageOptions): Promise<PrefLanguage>;
     createPrefNotif(opts: CreatePrefNotifOptions): Promise<PrefNotif>;
     replacePrefNotif(opts: ReplacePrefNotifOptions): Promise<PrefNotif>;
     createPrefEmail(opts: CreatePrefEmailOptions): Promise<PrefEmail>;
@@ -73,14 +109,22 @@ export declare class PreferencesFX implements PreferencesFXOperator {
     replacePrefPayment(opts: ReplacePrefPaymentOptions): Promise<PrefPayment>;
     createPrefClient(opts: CreatePrefClientOptions): Promise<PrefClient>;
     replacePrefClient(opts: ReplacePrefClientOptions): Promise<PrefClient>;
+    getPrefClient(opts: GetPrefClientOptions): Promise<PrefClient>;
+    savePrefClient(opts: SavePrefClientOptions): Promise<PrefClient>;
     createPrefEmployee(opts: CreatePrefEmployeeOptions): Promise<PrefEmployee>;
     replacePrefEmployee(opts: ReplacePrefEmployeeOptions): Promise<PrefEmployee>;
+    getPrefEmployee(opts: GetPrefEmployeeOptions): Promise<PrefEmployee>;
+    savePrefEmployee(opts: SavePrefEmployeeOptions): Promise<PrefEmployee>;
     createPrefCompany(opts: CreatePrefCompanyOptions): Promise<PrefCompany>;
     replacePrefCompany(opts: ReplacePrefCompanyOptions): Promise<PrefCompany>;
+    getPrefCompany(opts: GetPrefCompanyOptions): Promise<PrefCompany>;
+    savePrefCompany(opts: SavePrefCompanyOptions): Promise<PrefCompany>;
     createPrefVisibility(opts: CreatePrefVisibilityOptions): Promise<PrefVisibility>;
     replacePrefVisibility(opts: ReplacePrefVisibilityOptions): Promise<PrefVisibility>;
     createPrefLanguage(opts: CreatePrefLanguageOptions): Promise<PrefLanguage>;
     replacePrefLanguage(opts: ReplacePrefLanguageOptions): Promise<PrefLanguage>;
+    getPrefLanguage(opts: GetPrefLanguageOptions): Promise<PrefLanguage>;
+    saveSpeechToTextSourceLanguage(opts: SaveSpeechToTextSourceLanguageOptions): Promise<PrefLanguage>;
     createPrefNotif(opts: CreatePrefNotifOptions): Promise<PrefNotif>;
     replacePrefNotif(opts: ReplacePrefNotifOptions): Promise<PrefNotif>;
     createPrefEmail(opts: CreatePrefEmailOptions): Promise<PrefEmail>;
@@ -88,6 +132,10 @@ export declare class PreferencesFX implements PreferencesFXOperator {
     createPrefTutorial(opts: CreatePrefTutorialOptions): Promise<PrefTutorial>;
     replacePrefTutorial(opts: ReplacePrefTutorialOptions): Promise<PrefTutorial>;
     ensurePrefLanguage(opts: EnsurePrefLanguageOptions): Promise<OperationResult>;
+    private queryPrefClient;
+    private queryPrefEmployee;
+    private queryPrefCompany;
+    private queryPrefLanguage;
     private findPrefPayment;
     private findPrefClient;
     private findPrefEmployee;

package/dist/src/preferences/preferences.js

@@ -4,6 +4,7 @@
 // not use this file except in compliance with the License. You may obtain
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
 import { queryParam } from "@fabriktor/client";
+import { OwnerIDKey, } from "@fabriktor/schema";
 import { errResolveFailed } from "../core/err.js";
 import { requiredOperationID } from "../core/id.js";
 const resourcePrefPayment = "pref_payment";
@@ -56,6 +57,19 @@ export class PreferencesFX {
         await this.preferences.replaceOnePrefClient(opts);
         return await this.findPrefClient(opts.id);
     }
+    async getPrefClient(opts) {
+        const pref = await this.queryPrefClient(opts.owner_id);
+        if (pref === undefined) {
+            throw errResolveFailed({ resource: resourcePrefClient, msg: msgPrefClientMissing });
+        }
+        return pref;
+    }
+    async savePrefClient(opts) {
+        const input = { ...opts.in, is_default: false };
+        return opts.current.is_default
+            ? await this.createPrefClient({ in: input })
+            : await this.replacePrefClient({ id: opts.current.id, in: input });
+    }
     async createPrefEmployee(opts) {
         const out = await this.preferences.insertOnePrefEmployee(opts);
         const id = requiredOperationID(out, msgCreatedPrefEmployeeIDMissing);
@@ -65,6 +79,22 @@ export class PreferencesFX {
         await this.preferences.replaceOnePrefEmployee(opts);
         return await this.findPrefEmployee(opts.id);
     }
+    async getPrefEmployee(opts) {
+        const pref = await this.queryPrefEmployee(opts.owner_id);
+        if (pref === undefined) {
+            throw errResolveFailed({
+                resource: resourcePrefEmployee,
+                msg: msgPrefEmployeeMissing,
+            });
+        }
+        return pref;
+    }
+    async savePrefEmployee(opts) {
+        const input = { ...opts.in, is_default: false };
+        return opts.current.is_default
+            ? await this.createPrefEmployee({ in: input })
+            : await this.replacePrefEmployee({ id: opts.current.id, in: input });
+    }
     async createPrefCompany(opts) {
         const out = await this.preferences.insertOnePrefCompany(opts);
         const id = requiredOperationID(out, msgCreatedPrefCompanyIDMissing);
@@ -74,6 +104,22 @@ export class PreferencesFX {
         await this.preferences.replaceOnePrefCompany(opts);
         return await this.findPrefCompany(opts.id);
     }
+    async getPrefCompany(opts) {
+        const pref = await this.queryPrefCompany(opts.owner_id);
+        if (pref === undefined) {
+            throw errResolveFailed({
+                resource: resourcePrefCompany,
+                msg: msgPrefCompanyMissing,
+            });
+        }
+        return pref;
+    }
+    async savePrefCompany(opts) {
+        const input = { ...opts.in, is_default: false };
+        return opts.current.is_default
+            ? await this.createPrefCompany({ in: input })
+            : await this.replacePrefCompany({ id: opts.current.id, in: input });
+    }
     async createPrefVisibility(opts) {
         const out = await this.preferences.insertOnePrefVisibility(opts);
         const id = requiredOperationID(out, msgCreatedPrefVisibilityIDMissing);
@@ -92,6 +138,33 @@ export class PreferencesFX {
         await this.preferences.replaceOnePrefLanguage(opts);
         return await this.findPrefLanguage(opts.id);
     }
+    async getPrefLanguage(opts) {
+        const pref_language = await this.queryPrefLanguage(opts.owner_id);
+        if (pref_language === undefined) {
+            throw errResolveFailed({
+                resource: resourcePrefLanguage,
+                msg: msgPrefLanguageMissing,
+            });
+        }
+        return pref_language;
+    }
+    async saveSpeechToTextSourceLanguage(opts) {
+        const pref = await this.getPrefLanguage({ owner_id: opts.owner_id });
+        if (!pref.is_default &&
+            pref.speech_to_text_source_language === opts.speech_to_text_source_language) {
+            return pref;
+        }
+        const input = {
+            is_default: false,
+            country: pref.country,
+            language: pref.language,
+            speech_to_text_source_language: opts.speech_to_text_source_language,
+        };
+        if (pref.is_default) {
+            return await this.createPrefLanguage({ in: input });
+        }
+        return await this.replacePrefLanguage({ id: pref.id, in: input });
+    }
     async createPrefNotif(opts) {
         const out = await this.preferences.insertOnePrefNotif(opts);
         const id = requiredOperationID(out, msgCreatedPrefNotifIDMissing);
@@ -120,18 +193,14 @@ export class PreferencesFX {
         return await this.findPrefTutorial(opts.id);
     }
     async ensurePrefLanguage(opts) {
-        const out = await this.preferences.queryPrefLanguages({
-            query: queryParam("owner_id", opts.owner_id),
-        });
-        const prefs = out.value ?? [];
-        const pref = prefs[0];
+        const pref = await this.getPrefLanguage({ owner_id: opts.owner_id });
         const input = {
             is_default: false,
             language: opts.language,
             country: opts.country,
-            speech_to_text_source_language: opts.speech_to_text_source_language ?? opts.language,
+            speech_to_text_source_language: opts.speech_to_text_source_language ?? pref.speech_to_text_source_language,
         };
-        if (!pref || pref.is_default) {
+        if (pref.is_default) {
             return await this.preferences.insertOnePrefLanguage({
                 in: input,
             });
@@ -150,6 +219,30 @@ export class PreferencesFX {
             in: input,
         });
     }
+    async queryPrefClient(owner_id) {
+        const out = await this.preferences.queryPrefClients({
+            query: queryParam(OwnerIDKey, owner_id),
+        });
+        return out.value?.[0];
+    }
+    async queryPrefEmployee(owner_id) {
+        const out = await this.preferences.queryPrefEmployees({
+            query: queryParam(OwnerIDKey, owner_id),
+        });
+        return out.value?.[0];
+    }
+    async queryPrefCompany(owner_id) {
+        const out = await this.preferences.queryPrefCompanies({
+            query: queryParam(OwnerIDKey, owner_id),
+        });
+        return out.value?.[0];
+    }
+    async queryPrefLanguage(owner_id) {
+        const out = await this.preferences.queryPrefLanguages({
+            query: queryParam(OwnerIDKey, owner_id),
+        });
+        return out.value?.[0];
+    }
     async findPrefPayment(id) {
         const out = await this.preferences.findOnePrefPayment({
             id,

package/dist/src/processes/processes.d.ts

@@ -0,0 +1,27 @@
+import type { ProcessesOperator, SpeechToTextOptions } from "@fabriktor/client";
+import type { PrefLanguage } from "@fabriktor/schema";
+import type { PreferencesFXOperator } from "../preferences/preferences.js";
+export type SpeechToTextAndSaveSourceLanguageOptions = {
+    owner_id: string;
+    speech_to_text: SpeechToTextOptions;
+};
+export type SpeechToTextAndSaveSourceLanguageResult = {
+    transcription: string;
+    preference: PrefLanguage;
+};
+export type ProcessesFXOptions = {
+    processes: ProcessesOperator;
+    preferences_fx: PreferencesFXOperator;
+};
+export interface ProcessesFXOperator {
+    speechToText(opts: SpeechToTextOptions): Promise<string>;
+    speechToTextAndSaveSourceLanguage(opts: SpeechToTextAndSaveSourceLanguageOptions): Promise<SpeechToTextAndSaveSourceLanguageResult>;
+}
+export declare class ProcessesFX implements ProcessesFXOperator {
+    private processes;
+    private preferences_fx;
+    constructor(opts: ProcessesFXOptions);
+    speechToText(opts: SpeechToTextOptions): Promise<string>;
+    speechToTextAndSaveSourceLanguage(opts: SpeechToTextAndSaveSourceLanguageOptions): Promise<SpeechToTextAndSaveSourceLanguageResult>;
+}
+export declare function newProcessesFX(opts: ProcessesFXOptions): ProcessesFX;

package/dist/src/processes/processes.js

@@ -0,0 +1,38 @@
+// Copyright (C) Fabriktor, Inc. 2025-present.
+//
+// Licensed under the Apache License, Version 2.0 (the "License"); you may
+// not use this file except in compliance with the License. You may obtain
+// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+import { errResolveFailed } from "../core/err.js";
+const resourceSpeechToTextTranscription = "speech_to_text_transcription";
+const msgSpeechToTextTranscriptionMissing = "Speech-to-text response did not include a transcription.";
+export class ProcessesFX {
+    processes;
+    preferences_fx;
+    constructor(opts) {
+        this.processes = opts.processes;
+        this.preferences_fx = opts.preferences_fx;
+    }
+    async speechToText(opts) {
+        const out = await this.processes.speechToText(opts);
+        const transcription = out.value?.transcriptions.at(0)?.text.trim() ?? "";
+        if (transcription === "") {
+            throw errResolveFailed({
+                resource: resourceSpeechToTextTranscription,
+                msg: msgSpeechToTextTranscriptionMissing,
+            });
+        }
+        return transcription;
+    }
+    async speechToTextAndSaveSourceLanguage(opts) {
+        const preference = await this.preferences_fx.saveSpeechToTextSourceLanguage({
+            owner_id: opts.owner_id,
+            speech_to_text_source_language: opts.speech_to_text.audio_locale,
+        });
+        const transcription = await this.speechToText(opts.speech_to_text);
+        return { transcription, preference };
+    }
+}
+export function newProcessesFX(opts) {
+    return new ProcessesFX(opts);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabriktor/fx",
-  "version": "0.0.65",
+  "version": "0.0.67",
   "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
   "type": "module",
   "exports": {