@fabriktor/fx 0.0.66 → 0.0.67

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,6 +36,27 @@ 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;
 };
@@ -54,10 +75,16 @@ export interface 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>;
@@ -82,10 +109,16 @@ 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>;
@@ -99,6 +132,9 @@ 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;

package/dist/src/preferences/preferences.js

@@ -57,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);
@@ -66,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);
@@ -75,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);
@@ -148,14 +193,14 @@ export class PreferencesFX {
         return await this.findPrefTutorial(opts.id);
     }
     async ensurePrefLanguage(opts) {
-        const pref = await this.queryPrefLanguage(opts.owner_id);
+        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,
             });
@@ -174,6 +219,24 @@ 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),

package/package.json

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