@fabriktor/client 0.0.20 → 0.0.22

package/dist/src/core/col.d.ts

@@ -0,0 +1,15 @@
+export type QueryValue = string | number | boolean | undefined | null;
+export type QueryOptions = Record<string, QueryValue | QueryValue[]>;
+export type CollectionPathOptions = {
+    svc: string;
+    col: string;
+};
+export type IDPathOptions = CollectionPathOptions & {
+    id: string;
+};
+export type BuildQueryOptions = {
+    query?: QueryOptions;
+};
+export declare function collectionPath(opts: CollectionPathOptions): string;
+export declare function idPath(opts: IDPathOptions): string;
+export declare function withQuery(path: string, opts?: BuildQueryOptions): string;

package/dist/src/core/col.js

@@ -0,0 +1,46 @@
+// 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 { buildPath } from "./path.js";
+export function collectionPath(opts) {
+    return buildPath({
+        svc: opts.svc,
+        col: opts.col,
+    });
+}
+export function idPath(opts) {
+    return buildPath({
+        svc: opts.svc,
+        col: opts.col,
+        id: opts.id,
+    });
+}
+export function withQuery(path, opts) {
+    const query = opts?.query;
+    if (!query) {
+        return path;
+    }
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null) {
+                    continue;
+                }
+                params.append(key, String(item));
+            }
+            continue;
+        }
+        params.set(key, String(value));
+    }
+    const raw = params.toString();
+    if (raw === "") {
+        return path;
+    }
+    return `${path}?${raw}`;
+}

package/dist/src/core/crud.d.ts

@@ -0,0 +1,70 @@
+import { OperationResultValueKey, SearchResultResultsKey, type OperationResult, type SearchResult, type UpsertResult } from "@fabriktor/schema";
+import type { TokenProvider } from "./auth.js";
+import type { HTTPDoer } from "./http.js";
+import { type QueryOptions } from "./col.js";
+export type OperationResultOf<T> = Omit<OperationResult, typeof OperationResultValueKey> & {
+    [OperationResultValueKey]?: T;
+};
+export type SearchResultOf<T> = Omit<SearchResult, typeof SearchResultResultsKey> & {
+    [SearchResultResultsKey]?: T[];
+};
+export type CRUDClientOptions = {
+    http: HTTPDoer;
+    base_url: string;
+    svc: string;
+    col: string;
+    get_token?: TokenProvider;
+};
+export type QueryOptionsCRUD = {
+    query?: QueryOptions;
+};
+export type InsertOneOptionsCRUD<In> = {
+    in: In;
+};
+export type UpsertOneOptionsCRUD<In> = {
+    in: In;
+    query?: QueryOptions;
+};
+export type FindOneOptionsCRUD = {
+    id: string;
+};
+export type ReplaceOneOptionsCRUD<In> = {
+    id: string;
+    in: In;
+};
+export type DeleteOneOptionsCRUD = {
+    id: string;
+};
+export type DeleteManyOptionsCRUD = {
+    query?: QueryOptions;
+};
+export type SearchManyOptionsCRUD = {
+    query?: QueryOptions;
+};
+export interface CRUDOperator<In, Out> {
+    query(opts?: QueryOptionsCRUD): Promise<OperationResultOf<Out[]>>;
+    insertOne(opts: InsertOneOptionsCRUD<In>): Promise<OperationResult>;
+    upsertOne(opts: UpsertOneOptionsCRUD<In>): Promise<OperationResultOf<UpsertResult>>;
+    findOne(opts: FindOneOptionsCRUD): Promise<OperationResultOf<Out>>;
+    replaceOne(opts: ReplaceOneOptionsCRUD<In>): Promise<OperationResult>;
+    deleteOne(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteMany(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    searchMany(opts?: SearchManyOptionsCRUD): Promise<OperationResultOf<SearchResultOf<Out>>>;
+}
+export declare class CRUDClient<In, Out> implements CRUDOperator<In, Out> {
+    private http;
+    private base_url;
+    private svc;
+    private col;
+    private get_token?;
+    constructor(opts: CRUDClientOptions);
+    query(opts?: QueryOptionsCRUD): Promise<OperationResultOf<Out[]>>;
+    insertOne(opts: InsertOneOptionsCRUD<In>): Promise<OperationResult>;
+    upsertOne(opts: UpsertOneOptionsCRUD<In>): Promise<OperationResultOf<UpsertResult>>;
+    findOne(opts: FindOneOptionsCRUD): Promise<OperationResultOf<Out>>;
+    replaceOne(opts: ReplaceOneOptionsCRUD<In>): Promise<OperationResult>;
+    deleteOne(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteMany(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    searchMany(opts?: SearchManyOptionsCRUD): Promise<OperationResultOf<SearchResultOf<Out>>>;
+}
+export declare function newCRUDClient<In, Out>(opts: CRUDClientOptions): CRUDClient<In, Out>;

package/dist/src/core/crud.js

@@ -0,0 +1,137 @@
+// 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 { HTTPMethodDelete, HTTPMethodGet, HTTPMethodPatch, HTTPMethodPost, PathSearch, OperationResultValueKey, SearchResultResultsKey, } from "@fabriktor/schema";
+import { requiredToken } from "./auth.js";
+import { collectionPath, idPath, withQuery } from "./col.js";
+import { buildPath } from "./path.js";
+export class CRUDClient {
+    http;
+    base_url;
+    svc;
+    col;
+    get_token;
+    constructor(opts) {
+        this.http = opts.http;
+        this.base_url = opts.base_url;
+        this.svc = opts.svc;
+        this.col = opts.col;
+        this.get_token = opts.get_token;
+    }
+    async query(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: withQuery(collectionPath({
+                svc: this.svc,
+                col: this.col,
+            }), {
+                query: opts?.query,
+            }),
+            method: HTTPMethodGet,
+            token,
+        });
+    }
+    async insertOne(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: collectionPath({
+                svc: this.svc,
+                col: this.col,
+            }),
+            method: HTTPMethodPost,
+            token,
+            body: opts.in,
+        });
+    }
+    async upsertOne(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: withQuery(collectionPath({
+                svc: this.svc,
+                col: this.col,
+            }), {
+                query: opts.query,
+            }),
+            method: HTTPMethodPost,
+            token,
+            body: opts.in,
+        });
+    }
+    async findOne(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: idPath({
+                svc: this.svc,
+                col: this.col,
+                id: opts.id,
+            }),
+            method: HTTPMethodGet,
+            token,
+        });
+    }
+    async replaceOne(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: idPath({
+                svc: this.svc,
+                col: this.col,
+                id: opts.id,
+            }),
+            method: HTTPMethodPatch,
+            token,
+            body: opts.in,
+        });
+    }
+    async deleteOne(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: idPath({
+                svc: this.svc,
+                col: this.col,
+                id: opts.id,
+            }),
+            method: HTTPMethodDelete,
+            token,
+        });
+    }
+    async deleteMany(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: withQuery(collectionPath({
+                svc: this.svc,
+                col: this.col,
+            }), {
+                query: opts?.query,
+            }),
+            method: HTTPMethodDelete,
+            token,
+        });
+    }
+    async searchMany(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: withQuery(buildPath({
+                svc: this.svc,
+                col: this.col,
+                action: PathSearch,
+            }), {
+                query: opts?.query,
+            }),
+            method: HTTPMethodGet,
+            token,
+        });
+    }
+}
+export function newCRUDClient(opts) {
+    return new CRUDClient(opts);
+}

package/dist/src/core/path.d.ts

@@ -2,6 +2,7 @@ export type PathOptions = {
     svc: string;
     col: string;
     id?: string;
+    id_key?: string;
     action?: string;
 };
 export declare function buildPath(opts: PathOptions): string;

package/dist/src/core/path.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 { PathActions } from "@fabriktor/schema";
+import { IDKey, PathActions } from "@fabriktor/schema";
 const pathSep = "/";
 function clean(v) {
     return v.replace(/^\/+|\/+$/g, "");
@@ -11,7 +11,7 @@ function clean(v) {
 export function buildPath(opts) {
     const out = [opts.svc, opts.col].map(clean);
     if (opts.id !== undefined) {
-        out.push(encodeURIComponent(opts.id));
+        out.push(clean(opts.id_key ?? IDKey), encodeURIComponent(opts.id));
     }
     if (opts.action !== undefined) {
         out.push(PathActions, clean(opts.action));

package/dist/src/index.d.ts

@@ -1,7 +1,10 @@
 export * from "./core/auth.js";
+export * from "./core/col.js";
+export * from "./core/crud.js";
 export * from "./core/err.js";
 export * from "./core/http.js";
 export * from "./core/path.js";
+export * from "./preferences/preferences.js";
 export * from "./users/tmp_phones.js";
 export * from "./users/tmp_usernames.js";
 export * from "./users/users.js";

package/dist/src/index.js

@@ -1,7 +1,10 @@
 export * from "./core/auth.js";
+export * from "./core/col.js";
+export * from "./core/crud.js";
 export * from "./core/err.js";
 export * from "./core/http.js";
 export * from "./core/path.js";
+export * from "./preferences/preferences.js";
 export * from "./users/tmp_phones.js";
 export * from "./users/tmp_usernames.js";
 export * from "./users/users.js";

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

@@ -0,0 +1,132 @@
+import { type InPrefClient, type InPrefCompany, type InPrefEmail, type InPrefEmployee, type InPrefLanguage, type InPrefNotif, type InPrefPayment, type InPrefTutorial, type InPrefVisibility, type OperationResult, type PrefClient, type PrefCompany, type PrefEmail, type PrefEmployee, type PrefLanguage, type PrefNotif, type PrefPayment, type PrefTutorial, type PrefVisibility } from "@fabriktor/schema";
+import type { TokenProvider } from "../core/auth.js";
+import type { DeleteManyOptionsCRUD, DeleteOneOptionsCRUD, FindOneOptionsCRUD, InsertOneOptionsCRUD, OperationResultOf, QueryOptionsCRUD, ReplaceOneOptionsCRUD } from "../core/crud.js";
+import type { HTTPDoer } from "../core/http.js";
+export type PreferencesClientOptions = {
+    http: HTTPDoer;
+    base_url: string;
+    get_token?: TokenProvider;
+};
+export interface PreferencesOperator {
+    queryPrefPayments(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefPayment[]>>;
+    insertOnePrefPayment(opts: InsertOneOptionsCRUD<InPrefPayment>): Promise<OperationResult>;
+    findOnePrefPayment(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefPayment>>;
+    replaceOnePrefPayment(opts: ReplaceOneOptionsCRUD<InPrefPayment>): Promise<OperationResult>;
+    deleteOnePrefPayment(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefPayments(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefClients(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefClient[]>>;
+    insertOnePrefClient(opts: InsertOneOptionsCRUD<InPrefClient>): Promise<OperationResult>;
+    findOnePrefClient(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefClient>>;
+    replaceOnePrefClient(opts: ReplaceOneOptionsCRUD<InPrefClient>): Promise<OperationResult>;
+    deleteOnePrefClient(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefClients(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefEmployees(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefEmployee[]>>;
+    insertOnePrefEmployee(opts: InsertOneOptionsCRUD<InPrefEmployee>): Promise<OperationResult>;
+    findOnePrefEmployee(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefEmployee>>;
+    replaceOnePrefEmployee(opts: ReplaceOneOptionsCRUD<InPrefEmployee>): Promise<OperationResult>;
+    deleteOnePrefEmployee(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefEmployees(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefCompanies(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefCompany[]>>;
+    insertOnePrefCompany(opts: InsertOneOptionsCRUD<InPrefCompany>): Promise<OperationResult>;
+    findOnePrefCompany(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefCompany>>;
+    replaceOnePrefCompany(opts: ReplaceOneOptionsCRUD<InPrefCompany>): Promise<OperationResult>;
+    deleteOnePrefCompany(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefCompanies(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefVisibilities(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefVisibility[]>>;
+    insertOnePrefVisibility(opts: InsertOneOptionsCRUD<InPrefVisibility>): Promise<OperationResult>;
+    findOnePrefVisibility(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefVisibility>>;
+    replaceOnePrefVisibility(opts: ReplaceOneOptionsCRUD<InPrefVisibility>): Promise<OperationResult>;
+    deleteOnePrefVisibility(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefVisibilities(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefLanguages(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefLanguage[]>>;
+    insertOnePrefLanguage(opts: InsertOneOptionsCRUD<InPrefLanguage>): Promise<OperationResult>;
+    findOnePrefLanguage(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefLanguage>>;
+    replaceOnePrefLanguage(opts: ReplaceOneOptionsCRUD<InPrefLanguage>): Promise<OperationResult>;
+    deleteOnePrefLanguage(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefLanguages(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefNotif(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefNotif[]>>;
+    insertOnePrefNotif(opts: InsertOneOptionsCRUD<InPrefNotif>): Promise<OperationResult>;
+    findOnePrefNotif(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefNotif>>;
+    replaceOnePrefNotif(opts: ReplaceOneOptionsCRUD<InPrefNotif>): Promise<OperationResult>;
+    deleteOnePrefNotif(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefNotif(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefEmails(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefEmail[]>>;
+    insertOnePrefEmail(opts: InsertOneOptionsCRUD<InPrefEmail>): Promise<OperationResult>;
+    findOnePrefEmail(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefEmail>>;
+    replaceOnePrefEmail(opts: ReplaceOneOptionsCRUD<InPrefEmail>): Promise<OperationResult>;
+    deleteOnePrefEmail(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefEmails(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefTutorials(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefTutorial[]>>;
+    insertOnePrefTutorial(opts: InsertOneOptionsCRUD<InPrefTutorial>): Promise<OperationResult>;
+    findOnePrefTutorial(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefTutorial>>;
+    replaceOnePrefTutorial(opts: ReplaceOneOptionsCRUD<InPrefTutorial>): Promise<OperationResult>;
+    deleteOnePrefTutorial(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefTutorials(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+}
+export declare class PreferencesClient implements PreferencesOperator {
+    private pref_payments;
+    private pref_clients;
+    private pref_employees;
+    private pref_companies;
+    private pref_visibilities;
+    private pref_languages;
+    private pref_notif;
+    private pref_emails;
+    private pref_tutorials;
+    constructor(opts: PreferencesClientOptions);
+    queryPrefPayments(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefPayment[]>>;
+    insertOnePrefPayment(opts: InsertOneOptionsCRUD<InPrefPayment>): Promise<OperationResult>;
+    findOnePrefPayment(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefPayment>>;
+    replaceOnePrefPayment(opts: ReplaceOneOptionsCRUD<InPrefPayment>): Promise<OperationResult>;
+    deleteOnePrefPayment(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefPayments(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefClients(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefClient[]>>;
+    insertOnePrefClient(opts: InsertOneOptionsCRUD<InPrefClient>): Promise<OperationResult>;
+    findOnePrefClient(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefClient>>;
+    replaceOnePrefClient(opts: ReplaceOneOptionsCRUD<InPrefClient>): Promise<OperationResult>;
+    deleteOnePrefClient(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefClients(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefEmployees(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefEmployee[]>>;
+    insertOnePrefEmployee(opts: InsertOneOptionsCRUD<InPrefEmployee>): Promise<OperationResult>;
+    findOnePrefEmployee(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefEmployee>>;
+    replaceOnePrefEmployee(opts: ReplaceOneOptionsCRUD<InPrefEmployee>): Promise<OperationResult>;
+    deleteOnePrefEmployee(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefEmployees(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefCompanies(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefCompany[]>>;
+    insertOnePrefCompany(opts: InsertOneOptionsCRUD<InPrefCompany>): Promise<OperationResult>;
+    findOnePrefCompany(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefCompany>>;
+    replaceOnePrefCompany(opts: ReplaceOneOptionsCRUD<InPrefCompany>): Promise<OperationResult>;
+    deleteOnePrefCompany(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefCompanies(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefVisibilities(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefVisibility[]>>;
+    insertOnePrefVisibility(opts: InsertOneOptionsCRUD<InPrefVisibility>): Promise<OperationResult>;
+    findOnePrefVisibility(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefVisibility>>;
+    replaceOnePrefVisibility(opts: ReplaceOneOptionsCRUD<InPrefVisibility>): Promise<OperationResult>;
+    deleteOnePrefVisibility(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefVisibilities(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefLanguages(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefLanguage[]>>;
+    insertOnePrefLanguage(opts: InsertOneOptionsCRUD<InPrefLanguage>): Promise<OperationResult>;
+    findOnePrefLanguage(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefLanguage>>;
+    replaceOnePrefLanguage(opts: ReplaceOneOptionsCRUD<InPrefLanguage>): Promise<OperationResult>;
+    deleteOnePrefLanguage(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefLanguages(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefNotif(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefNotif[]>>;
+    insertOnePrefNotif(opts: InsertOneOptionsCRUD<InPrefNotif>): Promise<OperationResult>;
+    findOnePrefNotif(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefNotif>>;
+    replaceOnePrefNotif(opts: ReplaceOneOptionsCRUD<InPrefNotif>): Promise<OperationResult>;
+    deleteOnePrefNotif(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefNotif(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefEmails(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefEmail[]>>;
+    insertOnePrefEmail(opts: InsertOneOptionsCRUD<InPrefEmail>): Promise<OperationResult>;
+    findOnePrefEmail(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefEmail>>;
+    replaceOnePrefEmail(opts: ReplaceOneOptionsCRUD<InPrefEmail>): Promise<OperationResult>;
+    deleteOnePrefEmail(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefEmails(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    queryPrefTutorials(opts?: QueryOptionsCRUD): Promise<OperationResultOf<PrefTutorial[]>>;
+    insertOnePrefTutorial(opts: InsertOneOptionsCRUD<InPrefTutorial>): Promise<OperationResult>;
+    findOnePrefTutorial(opts: FindOneOptionsCRUD): Promise<OperationResultOf<PrefTutorial>>;
+    replaceOnePrefTutorial(opts: ReplaceOneOptionsCRUD<InPrefTutorial>): Promise<OperationResult>;
+    deleteOnePrefTutorial(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyPrefTutorials(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+}
+export declare function newPreferencesClient(opts: PreferencesClientOptions): PreferencesClient;

package/dist/src/preferences/preferences.js

@@ -0,0 +1,248 @@
+// 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 { ColPreferencesClients, ColPreferencesCompanies, ColPreferencesEmails, ColPreferencesEmployees, ColPreferencesLanguages, ColPreferencesNotif, ColPreferencesPayments, ColPreferencesTutorials, ColPreferencesVisibilities, SvcPreferences, } from "@fabriktor/schema";
+import { newCRUDClient } from "../core/crud.js";
+export class PreferencesClient {
+    pref_payments;
+    pref_clients;
+    pref_employees;
+    pref_companies;
+    pref_visibilities;
+    pref_languages;
+    pref_notif;
+    pref_emails;
+    pref_tutorials;
+    constructor(opts) {
+        this.pref_payments = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesPayments,
+            get_token: opts.get_token,
+        });
+        this.pref_clients = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesClients,
+            get_token: opts.get_token,
+        });
+        this.pref_employees = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesEmployees,
+            get_token: opts.get_token,
+        });
+        this.pref_companies = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesCompanies,
+            get_token: opts.get_token,
+        });
+        this.pref_visibilities = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesVisibilities,
+            get_token: opts.get_token,
+        });
+        this.pref_languages = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesLanguages,
+            get_token: opts.get_token,
+        });
+        this.pref_notif = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesNotif,
+            get_token: opts.get_token,
+        });
+        this.pref_emails = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesEmails,
+            get_token: opts.get_token,
+        });
+        this.pref_tutorials = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcPreferences,
+            col: ColPreferencesTutorials,
+            get_token: opts.get_token,
+        });
+    }
+    async queryPrefPayments(opts) {
+        return await this.pref_payments.query(opts);
+    }
+    async insertOnePrefPayment(opts) {
+        return await this.pref_payments.insertOne(opts);
+    }
+    async findOnePrefPayment(opts) {
+        return await this.pref_payments.findOne(opts);
+    }
+    async replaceOnePrefPayment(opts) {
+        return await this.pref_payments.replaceOne(opts);
+    }
+    async deleteOnePrefPayment(opts) {
+        return await this.pref_payments.deleteOne(opts);
+    }
+    async deleteManyPrefPayments(opts) {
+        return await this.pref_payments.deleteMany(opts);
+    }
+    async queryPrefClients(opts) {
+        return await this.pref_clients.query(opts);
+    }
+    async insertOnePrefClient(opts) {
+        return await this.pref_clients.insertOne(opts);
+    }
+    async findOnePrefClient(opts) {
+        return await this.pref_clients.findOne(opts);
+    }
+    async replaceOnePrefClient(opts) {
+        return await this.pref_clients.replaceOne(opts);
+    }
+    async deleteOnePrefClient(opts) {
+        return await this.pref_clients.deleteOne(opts);
+    }
+    async deleteManyPrefClients(opts) {
+        return await this.pref_clients.deleteMany(opts);
+    }
+    async queryPrefEmployees(opts) {
+        return await this.pref_employees.query(opts);
+    }
+    async insertOnePrefEmployee(opts) {
+        return await this.pref_employees.insertOne(opts);
+    }
+    async findOnePrefEmployee(opts) {
+        return await this.pref_employees.findOne(opts);
+    }
+    async replaceOnePrefEmployee(opts) {
+        return await this.pref_employees.replaceOne(opts);
+    }
+    async deleteOnePrefEmployee(opts) {
+        return await this.pref_employees.deleteOne(opts);
+    }
+    async deleteManyPrefEmployees(opts) {
+        return await this.pref_employees.deleteMany(opts);
+    }
+    async queryPrefCompanies(opts) {
+        return await this.pref_companies.query(opts);
+    }
+    async insertOnePrefCompany(opts) {
+        return await this.pref_companies.insertOne(opts);
+    }
+    async findOnePrefCompany(opts) {
+        return await this.pref_companies.findOne(opts);
+    }
+    async replaceOnePrefCompany(opts) {
+        return await this.pref_companies.replaceOne(opts);
+    }
+    async deleteOnePrefCompany(opts) {
+        return await this.pref_companies.deleteOne(opts);
+    }
+    async deleteManyPrefCompanies(opts) {
+        return await this.pref_companies.deleteMany(opts);
+    }
+    async queryPrefVisibilities(opts) {
+        return await this.pref_visibilities.query(opts);
+    }
+    async insertOnePrefVisibility(opts) {
+        return await this.pref_visibilities.insertOne(opts);
+    }
+    async findOnePrefVisibility(opts) {
+        return await this.pref_visibilities.findOne(opts);
+    }
+    async replaceOnePrefVisibility(opts) {
+        return await this.pref_visibilities.replaceOne(opts);
+    }
+    async deleteOnePrefVisibility(opts) {
+        return await this.pref_visibilities.deleteOne(opts);
+    }
+    async deleteManyPrefVisibilities(opts) {
+        return await this.pref_visibilities.deleteMany(opts);
+    }
+    async queryPrefLanguages(opts) {
+        return await this.pref_languages.query(opts);
+    }
+    async insertOnePrefLanguage(opts) {
+        return await this.pref_languages.insertOne(opts);
+    }
+    async findOnePrefLanguage(opts) {
+        return await this.pref_languages.findOne(opts);
+    }
+    async replaceOnePrefLanguage(opts) {
+        return await this.pref_languages.replaceOne(opts);
+    }
+    async deleteOnePrefLanguage(opts) {
+        return await this.pref_languages.deleteOne(opts);
+    }
+    async deleteManyPrefLanguages(opts) {
+        return await this.pref_languages.deleteMany(opts);
+    }
+    async queryPrefNotif(opts) {
+        return await this.pref_notif.query(opts);
+    }
+    async insertOnePrefNotif(opts) {
+        return await this.pref_notif.insertOne(opts);
+    }
+    async findOnePrefNotif(opts) {
+        return await this.pref_notif.findOne(opts);
+    }
+    async replaceOnePrefNotif(opts) {
+        return await this.pref_notif.replaceOne(opts);
+    }
+    async deleteOnePrefNotif(opts) {
+        return await this.pref_notif.deleteOne(opts);
+    }
+    async deleteManyPrefNotif(opts) {
+        return await this.pref_notif.deleteMany(opts);
+    }
+    async queryPrefEmails(opts) {
+        return await this.pref_emails.query(opts);
+    }
+    async insertOnePrefEmail(opts) {
+        return await this.pref_emails.insertOne(opts);
+    }
+    async findOnePrefEmail(opts) {
+        return await this.pref_emails.findOne(opts);
+    }
+    async replaceOnePrefEmail(opts) {
+        return await this.pref_emails.replaceOne(opts);
+    }
+    async deleteOnePrefEmail(opts) {
+        return await this.pref_emails.deleteOne(opts);
+    }
+    async deleteManyPrefEmails(opts) {
+        return await this.pref_emails.deleteMany(opts);
+    }
+    async queryPrefTutorials(opts) {
+        return await this.pref_tutorials.query(opts);
+    }
+    async insertOnePrefTutorial(opts) {
+        return await this.pref_tutorials.insertOne(opts);
+    }
+    async findOnePrefTutorial(opts) {
+        return await this.pref_tutorials.findOne(opts);
+    }
+    async replaceOnePrefTutorial(opts) {
+        return await this.pref_tutorials.replaceOne(opts);
+    }
+    async deleteOnePrefTutorial(opts) {
+        return await this.pref_tutorials.deleteOne(opts);
+    }
+    async deleteManyPrefTutorials(opts) {
+        return await this.pref_tutorials.deleteMany(opts);
+    }
+}
+export function newPreferencesClient(opts) {
+    return new PreferencesClient(opts);
+}

package/dist/src/users/users.js

@@ -63,15 +63,34 @@ export class UsersClient {
             },
         });
     }
+    // public async resolveUsername(
+    //   opts: ResolveUsernameOptions,
+    // ): Promise<Op<string>> {
+    //   return await this.http.do<PLUsersResolveUsername, Op<string>>({
+    //     base_url: this.base_url,
+    //     path: userPath(PathUsersResolveUsername),
+    //     method: HTTPMethodPost,
+    //     body: {
+    //       username: opts.username,
+    //     },
+    //   });
+    // }
     async resolveUsername(opts) {
-        return await this.http.do({
+        const body = {
+            username: opts.username,
+        };
+        console.log("[client/users.resolveUsername] request", {
+            path: userPath(PathUsersResolveUsername),
+            body,
+        });
+        const out = await this.http.do({
             base_url: this.base_url,
             path: userPath(PathUsersResolveUsername),
             method: HTTPMethodPost,
-            body: {
-                username: opts.username,
-            },
+            body,
         });
+        console.log("[client/users.resolveUsername] response", out);
+        return out;
     }
     async match(opts) {
         const token = await requiredToken(this.get_token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabriktor/client",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
   "type": "module",
   "exports": {
@@ -17,6 +17,6 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@fabriktor/schema": "^0.0.14"
+    "@fabriktor/schema": "^0.0.15"
   }
 }