@fabriktor/fx 0.0.5

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 @@
+# Fx
+
+![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/fx?icon=gitlab&color=orange
+[license-badge]: https://badgen.net/badge/license/Apache-2.0/orange
+[pipeline-badge]: https://gitlab.com/fabriktor/fx/badges/main/pipeline.svg
+[starrers-link]: https://gitlab.com/fabriktor/fx/-/starrers
+[license-link]: https://gitlab.com/fabriktor/fx/-/raw/main/LICENSE
+[pipelines-link]: https://gitlab.com/fabriktor/fx/-/pipelines

package/dist/src/auth/auth.d.ts

@@ -0,0 +1,13 @@
+export type AuthEmailOptions = {
+    email: string;
+    password: string;
+};
+export type AuthSession = {
+    token: string;
+};
+export interface AuthOperator {
+    signUp(opts: AuthEmailOptions): Promise<AuthSession>;
+    signIn(opts: AuthEmailOptions): Promise<AuthSession>;
+    getToken(): Promise<string>;
+    signOut(): Promise<void>;
+}

package/dist/src/auth/auth.js

@@ -0,0 +1,6 @@
+// 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
+export {};

package/dist/src/fx.d.ts

@@ -0,0 +1,19 @@
+import type { UsersOperator } from "@fabriktor/client";
+import type { AuthOperator } from "./auth/auth";
+import type { SessionFX, SessionFXOperator } from "./session/session";
+import type { UsersFX, UsersFXOperator } from "./users/users";
+export type FXOptions = {
+    base_url: string;
+    auth: AuthOperator;
+    users: UsersOperator;
+};
+export interface FXOperator {
+    users: UsersFXOperator;
+    session: SessionFXOperator;
+}
+export declare class FX implements FXOperator {
+    users: UsersFX;
+    session: SessionFX;
+    constructor(opts: FXOptions);
+}
+export declare function newFX(opts: FXOptions): FX;

package/dist/src/fx.js

@@ -0,0 +1,25 @@
+// 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 { newSessionFX } from "./session/session";
+import { newUsersFX } from "./users/users";
+export class FX {
+    users;
+    session;
+    constructor(opts) {
+        this.users = newUsersFX({
+            base_url: opts.base_url,
+            auth: opts.auth,
+            users: opts.users,
+        });
+        this.session = newSessionFX({
+            auth: opts.auth,
+            users: this.users,
+        });
+    }
+}
+export function newFX(opts) {
+    return new FX(opts);
+}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./auth/auth";
+export * from "./fx";
+export * from "./session/session";
+export * from "./users/users";

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export * from "./auth/auth";
+export * from "./fx";
+export * from "./session/session";
+export * from "./users/users";

package/dist/src/session/session.d.ts

@@ -0,0 +1,25 @@
+import type { InUser, UpsertResult } from "@fabriktor/schema";
+import type { Op } from "@fabriktor/client";
+import type { AuthEmailOptions, AuthOperator } from "../auth/auth";
+import type { UsersFXOperator } from "../users/users";
+export type SignUpAndBootstrapOptions = AuthEmailOptions & {
+    in: InUser;
+};
+export type SessionFXOptions = {
+    auth: AuthOperator;
+    users: UsersFXOperator;
+};
+export interface SessionFXOperator {
+    signUpAndBootstrap(opts: SignUpAndBootstrapOptions): Promise<Op<UpsertResult>>;
+    signIn(opts: AuthEmailOptions): Promise<void>;
+    signOut(): Promise<void>;
+}
+export declare class SessionFX implements SessionFXOperator {
+    private auth;
+    private users;
+    constructor(opts: SessionFXOptions);
+    signUpAndBootstrap(opts: SignUpAndBootstrapOptions): Promise<Op<UpsertResult>>;
+    signIn(opts: AuthEmailOptions): Promise<void>;
+    signOut(): Promise<void>;
+}
+export declare function newSessionFX(opts: SessionFXOptions): SessionFX;

package/dist/src/session/session.js

@@ -0,0 +1,32 @@
+// 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
+export class SessionFX {
+    auth;
+    users;
+    constructor(opts) {
+        this.auth = opts.auth;
+        this.users = opts.users;
+    }
+    async signUpAndBootstrap(opts) {
+        await this.auth.signUp({
+            email: opts.email,
+            password: opts.password,
+        });
+        return await this.users.bootstrap({
+            in: opts.in,
+        });
+    }
+    async signIn(opts) {
+        await this.auth.signIn(opts);
+        await this.users.sync();
+    }
+    async signOut() {
+        await this.auth.signOut();
+    }
+}
+export function newSessionFX(opts) {
+    return new SessionFX(opts);
+}

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

@@ -0,0 +1,26 @@
+import type { InUser, OperationResult, UpsertResult } from "@fabriktor/schema";
+import type { Op, UsersOperator } from "@fabriktor/client";
+import type { AuthOperator } from "../auth/auth";
+export type UsersFXOptions = {
+    base_url: string;
+    auth: AuthOperator;
+    users: UsersOperator;
+};
+export type BootstrapOptions = {
+    in: InUser;
+};
+export interface UsersFXOperator {
+    bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
+    sync(): Promise<OperationResult>;
+    sendEmailVerification(): Promise<void>;
+}
+export declare class UsersFX implements UsersFXOperator {
+    private base_url;
+    private auth;
+    private users;
+    constructor(opts: UsersFXOptions);
+    bootstrap(opts: BootstrapOptions): Promise<Op<UpsertResult>>;
+    sync(): Promise<OperationResult>;
+    sendEmailVerification(): Promise<void>;
+}
+export declare function newUsersFX(opts: UsersFXOptions): UsersFX;

package/dist/src/users/users.js

@@ -0,0 +1,40 @@
+// 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
+export class UsersFX {
+    base_url;
+    auth;
+    users;
+    constructor(opts) {
+        this.base_url = opts.base_url;
+        this.auth = opts.auth;
+        this.users = opts.users;
+    }
+    async bootstrap(opts) {
+        const token = await this.auth.getToken();
+        return await this.users.bootstrap({
+            base_url: this.base_url,
+            token,
+            in: opts.in,
+        });
+    }
+    async sync() {
+        const token = await this.auth.getToken();
+        return await this.users.sync({
+            base_url: this.base_url,
+            token,
+        });
+    }
+    async sendEmailVerification() {
+        const token = await this.auth.getToken();
+        return await this.users.sendEmailVerification({
+            base_url: this.base_url,
+            token,
+        });
+    }
+}
+export function newUsersFX(opts) {
+    return new UsersFX(opts);
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@fabriktor/fx",
+  "version": "0.0.5",
+  "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/client": "^0.0.6",
+    "@fabriktor/schema": "^0.0.10"
+  }
+}