@fabriktor/client 0.0.6

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 Fabriktor, Inc.
+
+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
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,29 @@
+# Client
+
+![Fabriktor Logo][fabriktor-logo]
+
+[![GitLab stars][stars-badge]][starrers-link]
+
+[![License][license-badge]][license-link]
+[![Pipeline Badge][pipeline-badge]][pipelines-link]
+
+---
+
+## Overview
+
+This package is designed exclusively for Fabriktor's frontend operational needs and is
+not intended for public usage.
+
+---
+
+## License
+
+This project is licensed under the [Apache License 2.0][license-link].
+
+[fabriktor-logo]: https://backend.fabriktor.com/filehub/img/gitlab/truck_yellow_filling.gif
+[stars-badge]: https://badgen.net/gitlab/stars/fabriktor/client?icon=gitlab&color=orange
+[license-badge]: https://badgen.net/badge/license/Apache-2.0/orange
+[pipeline-badge]: https://gitlab.com/fabriktor/client/badges/main/pipeline.svg
+[starrers-link]: https://gitlab.com/fabriktor/client/-/starrers
+[license-link]: https://gitlab.com/fabriktor/client/-/raw/main/LICENSE
+[pipelines-link]: https://gitlab.com/fabriktor/client/-/pipelines

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

@@ -0,0 +1,13 @@
+import type { HTTPErr, WrenchErr } from "@fabriktor/schema";
+export type ClientErrOptions = {
+    code: number;
+    msg: string;
+    app_err?: WrenchErr;
+};
+export declare class ClientErr extends Error {
+    code: number;
+    app_err?: WrenchErr;
+    constructor(opts: ClientErrOptions);
+}
+export declare function newClientErr(opts: ClientErrOptions): ClientErr;
+export declare function newClientErrFromHTTP(err: HTTPErr): ClientErr;

package/dist/src/core/err.js

@@ -0,0 +1,20 @@
+export class ClientErr extends Error {
+    code;
+    app_err;
+    constructor(opts) {
+        super(opts.msg);
+        this.name = new.target.name;
+        this.code = opts.code;
+        this.app_err = opts.app_err;
+    }
+}
+export function newClientErr(opts) {
+    return new ClientErr(opts);
+}
+export function newClientErrFromHTTP(err) {
+    return newClientErr({
+        code: err.code,
+        msg: err.msg,
+        app_err: err.app_err,
+    });
+}

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

@@ -0,0 +1,31 @@
+import { HTTPMethodDelete, HTTPMethodGet, HTTPMethodPatch, HTTPMethodPost } from "@fabriktor/schema";
+import type { OperationResult } from "@fabriktor/schema";
+export type Method = typeof HTTPMethodGet | typeof HTTPMethodPost | typeof HTTPMethodPatch | typeof HTTPMethodDelete;
+export type Op<T> = Omit<OperationResult, "value"> & {
+    value?: T;
+};
+export type HTTPOptions<T> = {
+    base_url: string;
+    path: string;
+    method: Method;
+    token?: string;
+    body?: T;
+};
+export interface Fetcher {
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+}
+export interface HTTPDoer {
+    do<T, R>(opts: HTTPOptions<T>): Promise<R>;
+}
+export type HTTPClientOptions = {
+    fetcher: Fetcher;
+};
+export declare class WebFetcher implements Fetcher {
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+}
+export declare class HTTPClient implements HTTPDoer {
+    private fetcher;
+    constructor(opts: HTTPClientOptions);
+    do<T, R>(opts: HTTPOptions<T>): Promise<R>;
+}
+export declare function newHTTPClient(opts?: Partial<HTTPClientOptions>): HTTPClient;

package/dist/src/core/http.js

@@ -0,0 +1,65 @@
+import { MimeJSON, } from "@fabriktor/schema";
+import { newClientErrFromHTTP } from "./err";
+const headerAuthorization = "authorization";
+const headerContentType = "content-type";
+const prefixBearer = "Bearer";
+export class WebFetcher {
+    async fetch(input, init) {
+        return await fetch(input, init);
+    }
+}
+export class HTTPClient {
+    fetcher;
+    constructor(opts) {
+        this.fetcher = opts.fetcher;
+    }
+    async do(opts) {
+        const res = await this.fetcher.fetch(url(opts.base_url, opts.path), {
+            method: opts.method,
+            headers: headers(opts),
+            body: body(opts.body),
+        });
+        if (!res.ok) {
+            return await fail(res);
+        }
+        if (res.body === null) {
+            return undefined;
+        }
+        return (await res.json());
+    }
+}
+export function newHTTPClient(opts) {
+    return new HTTPClient({
+        fetcher: opts?.fetcher ?? new WebFetcher(),
+    });
+}
+function url(base, path) {
+    return `${base.replace(/\/+$/g, "")}/${path.replace(/^\/+/g, "")}`;
+}
+function headers(opts) {
+    const h = new Headers();
+    if (opts.body !== undefined) {
+        h.set(headerContentType, MimeJSON);
+    }
+    if (opts.token !== undefined) {
+        h.set(headerAuthorization, `${prefixBearer} ${opts.token}`);
+    }
+    return h;
+}
+function body(v) {
+    return v === undefined ? undefined : JSON.stringify(v);
+}
+async function fail(res) {
+    const txt = await res.text();
+    let out;
+    try {
+        out = JSON.parse(txt);
+    }
+    catch {
+        out = {
+            code: res.status,
+            msg: txt || res.statusText || res.status.toString(),
+        };
+    }
+    throw newClientErrFromHTTP(out);
+}

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

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

package/dist/src/core/path.js

@@ -0,0 +1,15 @@
+import { PathActions } from "@fabriktor/schema";
+const pathSep = "/";
+function clean(v) {
+    return v.replace(/^\/+|\/+$/g, "");
+}
+export function buildPath(opts) {
+    const out = [opts.svc, opts.col].map(clean);
+    if (opts.id !== undefined) {
+        out.push(encodeURIComponent(opts.id));
+    }
+    if (opts.action !== undefined) {
+        out.push(PathActions, clean(opts.action));
+    }
+    return `${pathSep}${out.join(pathSep)}`;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./core/err";
+export * from "./core/http";
+export * from "./core/path";
+export * from "./users/users";

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export * from "./core/err";
+export * from "./core/http";
+export * from "./core/path";
+export * from "./users/users";

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

@@ -0,0 +1,25 @@
+import type { InUser, OperationResult, UpsertResult } from "@fabriktor/schema";
+import type { HTTPDoer, Op } from "../core/http";
+export type AuthOptions = {
+    base_url: string;
+    token: string;
+};
+export type BootstrapOptions = AuthOptions & {
+    in: InUser;
+};
+export interface UsersOperator {
+    bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
+    sync(opts: AuthOptions): Promise<OperationResult>;
+    sendEmailVerification(opts: AuthOptions): Promise<void>;
+}
+export type UsersClientOptions = {
+    http: HTTPDoer;
+};
+export declare class UsersClient implements UsersOperator {
+    private http;
+    constructor(opts: UsersClientOptions);
+    bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
+    sync(opts: AuthOptions): Promise<OperationResult>;
+    sendEmailVerification(opts: AuthOptions): Promise<void>;
+}
+export declare function newUsersClient(opts: UsersClientOptions): UsersClient;

package/dist/src/users/users.js

@@ -0,0 +1,43 @@
+import { ColUsersUsers, HTTPMethodPost, PathUsersBootstrap, PathUsersSendEmailVerification, PathUsersSync, SvcUsers, } from "@fabriktor/schema";
+import { buildPath } from "../core/path";
+export class UsersClient {
+    http;
+    constructor(opts) {
+        this.http = opts.http;
+    }
+    async bootstrap(opts) {
+        return await this.http.do({
+            base_url: opts.base_url,
+            path: userPath(PathUsersBootstrap),
+            method: HTTPMethodPost,
+            token: opts.token,
+            body: opts.in,
+        });
+    }
+    async sync(opts) {
+        return await this.http.do({
+            base_url: opts.base_url,
+            path: userPath(PathUsersSync),
+            method: HTTPMethodPost,
+            token: opts.token,
+        });
+    }
+    async sendEmailVerification(opts) {
+        return await this.http.do({
+            base_url: opts.base_url,
+            path: userPath(PathUsersSendEmailVerification),
+            method: HTTPMethodPost,
+            token: opts.token,
+        });
+    }
+}
+export function newUsersClient(opts) {
+    return new UsersClient(opts);
+}
+function userPath(action) {
+    return buildPath({
+        svc: SvcUsers,
+        col: ColUsersUsers,
+        action,
+    });
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@fabriktor/client",
+  "version": "0.0.6",
+  "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
+  "type": "module",
+  "exports": {
+    ".": "./dist/src/index.js"
+  },
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@fabriktor/schema": "^0.0.10"
+  }
+}