@fabriktor/client 0.0.28 → 0.0.31

package/dist/src/storage/storage.d.ts

@@ -0,0 +1,124 @@
+import { type Object as StorageObject, type OperationResult, type PLStorageDownload, type RPStorageUpload } from "@fabriktor/schema";
+import type { TokenProvider } from "../core/auth.js";
+import type { DeleteManyOptionsCRUD, DeleteOneOptionsCRUD, OperationResultOf } from "../core/crud.js";
+import type { HTTPDoer } from "../core/http.js";
+import { type MultipartDoer } from "../core/multipart.js";
+export declare const storageCollections: readonly ["calls", "chat", "contacts", "jobs", "locations", "memos", "qr", "reports", "tickets", "users"];
+export type StorageCollection = (typeof storageCollections)[number];
+export type StorageUploadFile = File | {
+    blob: Blob;
+    filename: string;
+};
+export type UploadStorageOptions = {
+    owner_id: string;
+    uploader_id?: string;
+    full_quality?: boolean;
+    files: StorageUploadFile[];
+};
+export type DownloadStorageOptions = PLStorageDownload;
+export type StorageClientOptions = {
+    http: HTTPDoer;
+    base_url: string;
+    get_token?: TokenProvider;
+    multipart?: MultipartDoer;
+};
+export interface StorageOperator {
+    upload(col: StorageCollection, opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    download(col: StorageCollection, opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOne(col: StorageCollection, opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteMany(col: StorageCollection, opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadCalls(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadCalls(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneCallObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyCallObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadChat(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadChat(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneChatObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyChatObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadContacts(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadContacts(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneContactObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyContactObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadJobs(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadJobs(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneJobObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyJobObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadLocations(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadLocations(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneLocationObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyLocationObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadMemos(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadMemos(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneMemoObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyMemoObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadQR(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadQR(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneQRObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyQRObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadReports(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadReports(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneReportObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyReportObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadTickets(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadTickets(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneTicketObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyTicketObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadUsers(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadUsers(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneUserObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyUserObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+}
+export declare class StorageClient implements StorageOperator {
+    private objects;
+    private http;
+    private multipart;
+    private base_url;
+    private get_token?;
+    constructor(opts: StorageClientOptions);
+    upload(col: StorageCollection, opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    download(col: StorageCollection, opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOne(col: StorageCollection, opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteMany(col: StorageCollection, opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadCalls(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadCalls(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneCallObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyCallObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadChat(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadChat(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneChatObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyChatObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadContacts(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadContacts(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneContactObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyContactObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadJobs(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadJobs(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneJobObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyJobObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadLocations(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadLocations(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneLocationObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyLocationObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadMemos(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadMemos(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneMemoObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyMemoObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadQR(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadQR(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneQRObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyQRObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadReports(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadReports(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneReportObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyReportObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadTickets(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadTickets(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneTicketObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyTicketObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    uploadUsers(opts: UploadStorageOptions): Promise<OperationResultOf<RPStorageUpload>>;
+    downloadUsers(opts: DownloadStorageOptions): Promise<OperationResultOf<StorageObject[]>>;
+    deleteOneUserObject(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyUserObjects(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    private object;
+}
+export declare function newStorageClient(opts: StorageClientOptions): StorageClient;

package/dist/src/storage/storage.js

@@ -0,0 +1,242 @@
+// 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 { ColStorageCalls, ColStorageChat, ColStorageContacts, ColStorageJobs, ColStorageLocations, ColStorageMemos, ColStorageQR, ColStorageReports, ColStorageTickets, ColStorageUsers, HTTPMethodPost, PathStorageDownload, PathStorageUpload, SvcStorage, } from "@fabriktor/schema";
+import { requiredToken } from "../core/auth.js";
+import { withQuery } from "../core/col.js";
+import { newCRUDClient } from "../core/crud.js";
+import { newMultipartClient } from "../core/multipart.js";
+import { buildPath } from "../core/path.js";
+const queryOwnerID = "owner_id";
+const queryUploaderID = "uploader_id";
+const queryFullQuality = "full_quality";
+const fileFieldName = "file";
+export const storageCollections = [
+    ColStorageCalls,
+    ColStorageChat,
+    ColStorageContacts,
+    ColStorageJobs,
+    ColStorageLocations,
+    ColStorageMemos,
+    ColStorageQR,
+    ColStorageReports,
+    ColStorageTickets,
+    ColStorageUsers,
+];
+export class StorageClient {
+    objects;
+    http;
+    multipart;
+    base_url;
+    get_token;
+    constructor(opts) {
+        this.objects = new Map(storageCollections.map((col) => [
+            col,
+            newCRUDClient({
+                http: opts.http,
+                base_url: opts.base_url,
+                svc: SvcStorage,
+                col,
+                get_token: opts.get_token,
+            }),
+        ]));
+        this.http = opts.http;
+        this.multipart = opts.multipart ?? newMultipartClient();
+        this.base_url = opts.base_url;
+        this.get_token = opts.get_token;
+    }
+    async upload(col, opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.multipart.do({
+            base_url: this.base_url,
+            path: uploadPath(col, opts),
+            method: HTTPMethodPost,
+            token,
+            form: uploadForm(opts),
+        });
+    }
+    async download(col, opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: storagePath(col, PathStorageDownload),
+            method: HTTPMethodPost,
+            token,
+            body: opts,
+        });
+    }
+    async deleteOne(col, opts) {
+        return await this.object(col).deleteOne(opts);
+    }
+    async deleteMany(col, opts) {
+        return await this.object(col).deleteMany(opts);
+    }
+    async uploadCalls(opts) {
+        return await this.upload(ColStorageCalls, opts);
+    }
+    async downloadCalls(opts) {
+        return await this.download(ColStorageCalls, opts);
+    }
+    async deleteOneCallObject(opts) {
+        return await this.deleteOne(ColStorageCalls, opts);
+    }
+    async deleteManyCallObjects(opts) {
+        return await this.deleteMany(ColStorageCalls, opts);
+    }
+    async uploadChat(opts) {
+        return await this.upload(ColStorageChat, opts);
+    }
+    async downloadChat(opts) {
+        return await this.download(ColStorageChat, opts);
+    }
+    async deleteOneChatObject(opts) {
+        return await this.deleteOne(ColStorageChat, opts);
+    }
+    async deleteManyChatObjects(opts) {
+        return await this.deleteMany(ColStorageChat, opts);
+    }
+    async uploadContacts(opts) {
+        return await this.upload(ColStorageContacts, opts);
+    }
+    async downloadContacts(opts) {
+        return await this.download(ColStorageContacts, opts);
+    }
+    async deleteOneContactObject(opts) {
+        return await this.deleteOne(ColStorageContacts, opts);
+    }
+    async deleteManyContactObjects(opts) {
+        return await this.deleteMany(ColStorageContacts, opts);
+    }
+    async uploadJobs(opts) {
+        return await this.upload(ColStorageJobs, opts);
+    }
+    async downloadJobs(opts) {
+        return await this.download(ColStorageJobs, opts);
+    }
+    async deleteOneJobObject(opts) {
+        return await this.deleteOne(ColStorageJobs, opts);
+    }
+    async deleteManyJobObjects(opts) {
+        return await this.deleteMany(ColStorageJobs, opts);
+    }
+    async uploadLocations(opts) {
+        return await this.upload(ColStorageLocations, opts);
+    }
+    async downloadLocations(opts) {
+        return await this.download(ColStorageLocations, opts);
+    }
+    async deleteOneLocationObject(opts) {
+        return await this.deleteOne(ColStorageLocations, opts);
+    }
+    async deleteManyLocationObjects(opts) {
+        return await this.deleteMany(ColStorageLocations, opts);
+    }
+    async uploadMemos(opts) {
+        return await this.upload(ColStorageMemos, opts);
+    }
+    async downloadMemos(opts) {
+        return await this.download(ColStorageMemos, opts);
+    }
+    async deleteOneMemoObject(opts) {
+        return await this.deleteOne(ColStorageMemos, opts);
+    }
+    async deleteManyMemoObjects(opts) {
+        return await this.deleteMany(ColStorageMemos, opts);
+    }
+    async uploadQR(opts) {
+        return await this.upload(ColStorageQR, opts);
+    }
+    async downloadQR(opts) {
+        return await this.download(ColStorageQR, opts);
+    }
+    async deleteOneQRObject(opts) {
+        return await this.deleteOne(ColStorageQR, opts);
+    }
+    async deleteManyQRObjects(opts) {
+        return await this.deleteMany(ColStorageQR, opts);
+    }
+    async uploadReports(opts) {
+        return await this.upload(ColStorageReports, opts);
+    }
+    async downloadReports(opts) {
+        return await this.download(ColStorageReports, opts);
+    }
+    async deleteOneReportObject(opts) {
+        return await this.deleteOne(ColStorageReports, opts);
+    }
+    async deleteManyReportObjects(opts) {
+        return await this.deleteMany(ColStorageReports, opts);
+    }
+    async uploadTickets(opts) {
+        return await this.upload(ColStorageTickets, opts);
+    }
+    async downloadTickets(opts) {
+        return await this.download(ColStorageTickets, opts);
+    }
+    async deleteOneTicketObject(opts) {
+        return await this.deleteOne(ColStorageTickets, opts);
+    }
+    async deleteManyTicketObjects(opts) {
+        return await this.deleteMany(ColStorageTickets, opts);
+    }
+    async uploadUsers(opts) {
+        return await this.upload(ColStorageUsers, opts);
+    }
+    async downloadUsers(opts) {
+        return await this.download(ColStorageUsers, opts);
+    }
+    async deleteOneUserObject(opts) {
+        return await this.deleteOne(ColStorageUsers, opts);
+    }
+    async deleteManyUserObjects(opts) {
+        return await this.deleteMany(ColStorageUsers, opts);
+    }
+    object(col) {
+        const c = this.objects.get(col);
+        if (c === undefined) {
+            throw new Error(`unknown storage collection: ${col}`);
+        }
+        return c;
+    }
+}
+export function newStorageClient(opts) {
+    return new StorageClient(opts);
+}
+function uploadPath(col, opts) {
+    return withQuery(storagePath(col, PathStorageUpload), {
+        query: {
+            [queryOwnerID]: opts.owner_id,
+            [queryUploaderID]: opts.uploader_id,
+            [queryFullQuality]: opts.full_quality,
+        },
+    });
+}
+function storagePath(col, action) {
+    return buildPath({
+        svc: SvcStorage,
+        col,
+        action,
+    });
+}
+function uploadForm(opts) {
+    if (opts.files.length === 0) {
+        throw new Error("upload requires at least one file");
+    }
+    const form = new FormData();
+    for (const f of opts.files) {
+        appendFile(form, f);
+    }
+    return form;
+}
+function appendFile(form, f) {
+    if (isFile(f)) {
+        form.append(fileFieldName, f, f.name);
+        return;
+    }
+    form.append(fileFieldName, f.blob, f.filename);
+}
+function isFile(f) {
+    return typeof File !== "undefined" && f instanceof File;
+}

package/dist/src/timesheets/timesheets.d.ts

@@ -0,0 +1,49 @@
+import { type InSummary, type InWeekSheet, type OperationResult, type PLTimesheetsApprove, type PLTimesheetsSync, type Punch, type Summary, type WeekSheet } from "@fabriktor/schema";
+import type { TokenProvider } from "../core/auth.js";
+import type { DeleteManyOptionsCRUD, DeleteOneOptionsCRUD, FindOneOptionsCRUD, OperationResultOf, QueryOptionsCRUD, ReplaceOneOptionsCRUD } from "../core/crud.js";
+import type { HTTPDoer } from "../core/http.js";
+export type ApproveTimesheetsOptions = PLTimesheetsApprove;
+export type SyncTimesheetsOptions = PLTimesheetsSync;
+export type PunchTimesheetOptions = Punch;
+export type TimesheetsClientOptions = {
+    http: HTTPDoer;
+    base_url: string;
+    get_token?: TokenProvider;
+};
+export interface TimesheetsOperator {
+    queryWeekSheets(opts?: QueryOptionsCRUD): Promise<OperationResultOf<WeekSheet[]>>;
+    findOneWeekSheet(opts: FindOneOptionsCRUD): Promise<OperationResultOf<WeekSheet>>;
+    replaceOneWeekSheet(opts: ReplaceOneOptionsCRUD<InWeekSheet>): Promise<OperationResult>;
+    deleteOneWeekSheet(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyWeekSheets(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    querySummaries(opts?: QueryOptionsCRUD): Promise<OperationResultOf<Summary[]>>;
+    findOneSummary(opts: FindOneOptionsCRUD): Promise<OperationResultOf<Summary>>;
+    replaceOneSummary(opts: ReplaceOneOptionsCRUD<InSummary>): Promise<OperationResult>;
+    deleteOneSummary(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManySummaries(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    approve(opts: ApproveTimesheetsOptions): Promise<void>;
+    sync(opts: SyncTimesheetsOptions): Promise<void>;
+    punch(opts: PunchTimesheetOptions): Promise<OperationResult>;
+}
+export declare class TimesheetsClient implements TimesheetsOperator {
+    private weeksheets;
+    private summaries;
+    private http;
+    private base_url;
+    private get_token?;
+    constructor(opts: TimesheetsClientOptions);
+    queryWeekSheets(opts?: QueryOptionsCRUD): Promise<OperationResultOf<WeekSheet[]>>;
+    findOneWeekSheet(opts: FindOneOptionsCRUD): Promise<OperationResultOf<WeekSheet>>;
+    replaceOneWeekSheet(opts: ReplaceOneOptionsCRUD<InWeekSheet>): Promise<OperationResult>;
+    deleteOneWeekSheet(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManyWeekSheets(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    querySummaries(opts?: QueryOptionsCRUD): Promise<OperationResultOf<Summary[]>>;
+    findOneSummary(opts: FindOneOptionsCRUD): Promise<OperationResultOf<Summary>>;
+    replaceOneSummary(opts: ReplaceOneOptionsCRUD<InSummary>): Promise<OperationResult>;
+    deleteOneSummary(opts: DeleteOneOptionsCRUD): Promise<OperationResult>;
+    deleteManySummaries(opts?: DeleteManyOptionsCRUD): Promise<OperationResultOf<number>>;
+    approve(opts: ApproveTimesheetsOptions): Promise<void>;
+    sync(opts: SyncTimesheetsOptions): Promise<void>;
+    punch(opts: PunchTimesheetOptions): Promise<OperationResult>;
+}
+export declare function newTimesheetsClient(opts: TimesheetsClientOptions): TimesheetsClient;

package/dist/src/timesheets/timesheets.js

@@ -0,0 +1,105 @@
+// 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 { ColTimesheetsSummaries, ColTimesheetsWeekSheets, HTTPMethodPost, PathTimesheetsApprove, PathTimesheetsPunch, PathTimesheetsSync, SvcTimesheets, } from "@fabriktor/schema";
+import { requiredToken } from "../core/auth.js";
+import { newCRUDClient } from "../core/crud.js";
+import { buildPath } from "../core/path.js";
+export class TimesheetsClient {
+    weeksheets;
+    summaries;
+    http;
+    base_url;
+    get_token;
+    constructor(opts) {
+        this.weeksheets = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcTimesheets,
+            col: ColTimesheetsWeekSheets,
+            get_token: opts.get_token,
+        });
+        this.summaries = newCRUDClient({
+            http: opts.http,
+            base_url: opts.base_url,
+            svc: SvcTimesheets,
+            col: ColTimesheetsSummaries,
+            get_token: opts.get_token,
+        });
+        this.http = opts.http;
+        this.base_url = opts.base_url;
+        this.get_token = opts.get_token;
+    }
+    async queryWeekSheets(opts) {
+        return await this.weeksheets.query(opts);
+    }
+    async findOneWeekSheet(opts) {
+        return await this.weeksheets.findOne(opts);
+    }
+    async replaceOneWeekSheet(opts) {
+        return await this.weeksheets.replaceOne(opts);
+    }
+    async deleteOneWeekSheet(opts) {
+        return await this.weeksheets.deleteOne(opts);
+    }
+    async deleteManyWeekSheets(opts) {
+        return await this.weeksheets.deleteMany(opts);
+    }
+    async querySummaries(opts) {
+        return await this.summaries.query(opts);
+    }
+    async findOneSummary(opts) {
+        return await this.summaries.findOne(opts);
+    }
+    async replaceOneSummary(opts) {
+        return await this.summaries.replaceOne(opts);
+    }
+    async deleteOneSummary(opts) {
+        return await this.summaries.deleteOne(opts);
+    }
+    async deleteManySummaries(opts) {
+        return await this.summaries.deleteMany(opts);
+    }
+    async approve(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: weekSheetPath(PathTimesheetsApprove),
+            method: HTTPMethodPost,
+            token,
+            body: opts,
+        });
+    }
+    async sync(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: weekSheetPath(PathTimesheetsSync),
+            method: HTTPMethodPost,
+            token,
+            body: opts,
+        });
+    }
+    async punch(opts) {
+        const token = await requiredToken(this.get_token);
+        return await this.http.do({
+            base_url: this.base_url,
+            path: weekSheetPath(PathTimesheetsPunch),
+            method: HTTPMethodPost,
+            token,
+            body: opts,
+        });
+    }
+}
+export function newTimesheetsClient(opts) {
+    return new TimesheetsClient(opts);
+}
+function weekSheetPath(action) {
+    return buildPath({
+        svc: SvcTimesheets,
+        col: ColTimesheetsWeekSheets,
+        action,
+    });
+}

package/dist/src/users/tmp_phones.d.ts

@@ -1,4 +1,4 @@
-import type { PLUsersSendCode, PLUsersVerifyCode } from "@fabriktor/schema";
+import { type PLUsersSendCode, type PLUsersVerifyCode } from "@fabriktor/schema";
 import type { TokenProvider } from "../core/auth.js";
 import type { HTTPDoer } from "../core/http.js";
 export type SendPhoneVerificationOptions = PLUsersSendCode;

package/dist/src/users/tmp_usernames.d.ts

@@ -1,10 +1,11 @@
-import type { PLUsersUsername } from "@fabriktor/schema";
+import { type PLUsersUsername } from "@fabriktor/schema";
 import type { TokenProvider } from "../core/auth.js";
-import type { HTTPDoer, Op } from "../core/http.js";
+import type { OperationResultOf } from "../core/crud.js";
+import type { HTTPDoer } from "../core/http.js";
 export type VerifyUsernameOptions = PLUsersUsername;
 export type UsernameVerification = string[];
 export interface TmpUsernamesOperator {
-    verify(opts: VerifyUsernameOptions): Promise<Op<UsernameVerification>>;
+    verify(opts: VerifyUsernameOptions): Promise<OperationResultOf<UsernameVerification>>;
 }
 export type TmpUsernamesClientOptions = {
     http: HTTPDoer;
@@ -16,6 +17,6 @@ export declare class TmpUsernamesClient implements TmpUsernamesOperator {
     private base_url;
     private get_token?;
     constructor(opts: TmpUsernamesClientOptions);
-    verify(opts: VerifyUsernameOptions): Promise<Op<UsernameVerification>>;
+    verify(opts: VerifyUsernameOptions): Promise<OperationResultOf<UsernameVerification>>;
 }
 export declare function newTmpUsernamesClient(opts: TmpUsernamesClientOptions): TmpUsernamesClient;

package/dist/src/users/users.d.ts

@@ -1,6 +1,7 @@
-import type { InUser, OperationResult, PLUsersContactList, PLUsersForgotPassword, PLUsersResolveUsername, PLUsersVerifyEmail, PLUsersSignInLink, UpsertResult, User } from "@fabriktor/schema";
+import { type InUser, type OperationResult, type PLUsersContactList, type PLUsersForgotPassword, type PLUsersResolveUsername, type PLUsersSignInLink, type PLUsersVerifyEmail, type UpsertResult, type User } from "@fabriktor/schema";
 import type { TokenProvider } from "../core/auth.js";
-import type { HTTPDoer, Op } from "../core/http.js";
+import type { OperationResultOf } from "../core/crud.js";
+import type { HTTPDoer } from "../core/http.js";
 export type BootstrapOptions = {
     in: InUser;
 };
@@ -17,15 +18,15 @@ export type GetByUIDOptions = {
     uid: string;
 };
 export interface UsersOperator {
-    bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
+    bootstrap(opts: BootstrapOptions): Promise<OperationResultOf<UpsertResult>>;
     sync(): Promise<OperationResult>;
     sendEmailVerification(opts: SendEmailVerificationOptions): Promise<void>;
     forgotPassword(opts: ForgotPasswordOptions): Promise<void>;
     sendSignInLink(opts: SendSignInLinkOptions): Promise<void>;
-    resolveUsername(opts: ResolveUsernameOptions): Promise<Op<string>>;
-    match(opts: MatchOptions): Promise<Op<User[]>>;
-    search(opts: SearchOptions): Promise<Op<User[]>>;
-    getByUID(opts: GetByUIDOptions): Promise<Op<User[]>>;
+    resolveUsername(opts: ResolveUsernameOptions): Promise<OperationResultOf<string>>;
+    match(opts: MatchOptions): Promise<OperationResultOf<User[]>>;
+    search(opts: SearchOptions): Promise<OperationResultOf<User[]>>;
+    getByUID(opts: GetByUIDOptions): Promise<OperationResultOf<User[]>>;
 }
 export type UsersClientOptions = {
     http: HTTPDoer;
@@ -37,14 +38,14 @@ export declare class UsersClient implements UsersOperator {
     private base_url;
     private get_token?;
     constructor(opts: UsersClientOptions);
-    bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
+    bootstrap(opts: BootstrapOptions): Promise<OperationResultOf<UpsertResult>>;
     sync(): Promise<OperationResult>;
     sendEmailVerification(opts: SendEmailVerificationOptions): Promise<void>;
     forgotPassword(opts: ForgotPasswordOptions): Promise<void>;
     sendSignInLink(opts: SendSignInLinkOptions): Promise<void>;
-    resolveUsername(opts: ResolveUsernameOptions): Promise<Op<string>>;
-    match(opts: MatchOptions): Promise<Op<User[]>>;
-    search(opts: SearchOptions): Promise<Op<User[]>>;
-    getByUID(opts: GetByUIDOptions): Promise<Op<User[]>>;
+    resolveUsername(opts: ResolveUsernameOptions): Promise<OperationResultOf<string>>;
+    match(opts: MatchOptions): Promise<OperationResultOf<User[]>>;
+    search(opts: SearchOptions): Promise<OperationResultOf<User[]>>;
+    getByUID(opts: GetByUIDOptions): Promise<OperationResultOf<User[]>>;
 }
 export declare function newUsersClient(opts: UsersClientOptions): UsersClient;

package/dist/src/users/users.js

@@ -5,6 +5,7 @@
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
 import { ColUsersUsers, HTTPMethodGet, HTTPMethodPost, PathSearch, PathUsersBootstrap, PathUsersForgotPassword, PathUsersMatch, PathUsersResolveUsername, PathUsersSendEmailVerification, PathUsersSendSignInLink, PathUsersSync, SvcUsers, } from "@fabriktor/schema";
 import { requiredToken } from "../core/auth.js";
+import { queryParam, withQuery } from "../core/col.js";
 import { buildPath } from "../core/path.js";
 export class UsersClient {
     http;
@@ -105,7 +106,9 @@ export class UsersClient {
         const token = await requiredToken(this.get_token);
         return await this.http.do({
             base_url: this.base_url,
-            path: `${collectionPath()}?uid=${encodeURIComponent(opts.uid)}`,
+            path: withQuery(collectionPath(), {
+                query: queryParam("uid", opts.uid),
+            }),
             method: HTTPMethodGet,
             token,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabriktor/client",
-  "version": "0.0.28",
+  "version": "0.0.31",
   "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
   "type": "module",
   "exports": {
@@ -17,6 +17,7 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@fabriktor/schema": "^0.0.21"
+    "@fabriktor/client": "0.0.25",
+    "@fabriktor/schema": "0.0.27"
   }
 }