@fabriktor/fx 0.0.65 → 0.0.66

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/preferences/preferences.d.ts

@@ -36,12 +36,19 @@ export type CreatePrefEmailOptions = PrefEmailInsertOptions;
 export type ReplacePrefEmailOptions = PrefEmailReplaceOptions;
 export type CreatePrefTutorialOptions = PrefTutorialInsertOptions;
 export type ReplacePrefTutorialOptions = PrefTutorialReplaceOptions;
+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>;
@@ -55,6 +62,8 @@ export interface PreferencesFXOperator {
     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>;
@@ -81,6 +90,8 @@ export declare class PreferencesFX implements PreferencesFXOperator {
     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 +99,7 @@ export declare class PreferencesFX implements PreferencesFXOperator {
     createPrefTutorial(opts: CreatePrefTutorialOptions): Promise<PrefTutorial>;
     replacePrefTutorial(opts: ReplacePrefTutorialOptions): Promise<PrefTutorial>;
     ensurePrefLanguage(opts: EnsurePrefLanguageOptions): Promise<OperationResult>;
+    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";
@@ -92,6 +93,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,11 +148,7 @@ 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.queryPrefLanguage(opts.owner_id);
         const input = {
             is_default: false,
             language: opts.language,
@@ -150,6 +174,12 @@ export class PreferencesFX {
             in: input,
         });
     }
+    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.66",
   "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
   "type": "module",
   "exports": {