@liveartx/authentication 1.0.0

package/README.md

@@ -0,0 +1,5 @@
+## Liveart authentication package
+
+#### Install package
+
+1. Provide env variable API_AUTH_SERVICE_URL

package/lib/api/authApiClient.d.ts

@@ -0,0 +1,13 @@
+declare class AuthApiClient {
+    private readonly apiAuthServiceUrl;
+    constructor();
+    loginOrSignUpByEmail(email: string): Promise<void>;
+    verifyCode(email: string, code: string): Promise<VerifyCodeResponse>;
+}
+interface VerifyCodeResponse {
+    access_token: string;
+    token_type: string;
+    user_id: string;
+    email: string;
+}
+export { AuthApiClient };

package/lib/api/authApiClient.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthApiClient = void 0;
+const assert_1 = require("~/utils/assert");
+const API_AUTH_SERVICE_URL = process.env.API_AUTH_SERVICE_URL;
+class AuthApiClient {
+    apiAuthServiceUrl;
+    constructor() {
+        (0, assert_1.assert)(!!API_AUTH_SERVICE_URL, 'API_AUTH_SERVICE_URL env is required');
+        this.apiAuthServiceUrl = API_AUTH_SERVICE_URL;
+    }
+    async loginOrSignUpByEmail(email) {
+        const response = await fetch(`${this.apiAuthServiceUrl}/auth/email/send-code`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ email }),
+        });
+        (0, assert_1.assert)(!!response.ok, 'Code sending failed');
+    }
+    async verifyCode(email, code) {
+        const response = await fetch(`${this.apiAuthServiceUrl}/auth/email/verify-code`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ email, code }),
+        });
+        (0, assert_1.assert)(!!response.ok, 'Code verification failed');
+        const data = await response.json();
+        return data;
+    }
+}
+exports.AuthApiClient = AuthApiClient;

package/lib/features/signInOrSignUp.d.ts

@@ -0,0 +1,20 @@
+import { AuthApiClient } from '~/api/authApiClient';
+interface AuthTokenData {
+    accessToken: string;
+    tokenType: string;
+    userId: string;
+    email: string;
+}
+interface SendCodeResult {
+    success: boolean;
+    error: string | null;
+}
+interface VerifyCodeResult {
+    success: boolean;
+    tokenData: AuthTokenData | null;
+    error: string | null;
+}
+declare function sendVerificationCode(email: string, authClient: AuthApiClient): Promise<SendCodeResult>;
+declare function verifyCodeAndSaveToken(email: string, code: string, authClient: AuthApiClient, cookieName?: string): Promise<VerifyCodeResult>;
+export { sendVerificationCode, verifyCodeAndSaveToken };
+export type { AuthTokenData, SendCodeResult, VerifyCodeResult };

package/lib/features/signInOrSignUp.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyCodeAndSaveToken = exports.sendVerificationCode = void 0;
+const cookieService_1 = require("~/services/cookieService");
+function validateEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+function validateCode(code) {
+    return code.length > 0;
+}
+function validateEmailInput(email) {
+    if (!validateEmail(email)) {
+        return { valid: false, error: 'Invalid email format' };
+    }
+    return { valid: true, error: null };
+}
+function validateVerifyInput(email, code) {
+    if (!validateEmail(email)) {
+        return { valid: false, error: 'Invalid email format' };
+    }
+    if (!validateCode(code)) {
+        return { valid: false, error: 'Code is required' };
+    }
+    return { valid: true, error: null };
+}
+function transformVerifyCodeResponse(response) {
+    return {
+        accessToken: response.access_token,
+        tokenType: response.token_type,
+        userId: response.user_id,
+        email: response.email,
+    };
+}
+function createCookieOptions() {
+    const maxAge = 60 * 60 * 24 * 30;
+    return {
+        maxAge,
+        path: '/',
+        secure: true,
+        sameSite: 'lax',
+    };
+}
+function saveAuthTokenToCookie(token, cookieName = 'auth_token') {
+    const options = createCookieOptions();
+    (0, cookieService_1.setCookie)(cookieName, token, options);
+}
+async function sendVerificationCode(email, authClient) {
+    const validation = validateEmailInput(email);
+    if (!validation.valid) {
+        return {
+            success: false,
+            error: validation.error,
+        };
+    }
+    try {
+        await authClient.loginOrSignUpByEmail(email);
+        return {
+            success: true,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Code sending failed',
+        };
+    }
+}
+exports.sendVerificationCode = sendVerificationCode;
+async function verifyCodeAndSaveToken(email, code, authClient, cookieName) {
+    const validation = validateVerifyInput(email, code);
+    if (!validation.valid) {
+        return {
+            success: false,
+            tokenData: null,
+            error: validation.error,
+        };
+    }
+    try {
+        const response = await authClient.verifyCode(email, code);
+        const tokenData = transformVerifyCodeResponse(response);
+        saveAuthTokenToCookie(tokenData.accessToken, cookieName);
+        return {
+            success: true,
+            tokenData,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            tokenData: null,
+            error: error instanceof Error ? error.message : 'Code verification failed',
+        };
+    }
+}
+exports.verifyCodeAndSaveToken = verifyCodeAndSaveToken;

package/lib/index.d.ts

@@ -0,0 +1 @@
+export * from './features/signInOrSignUp';

package/lib/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./features/signInOrSignUp"), exports);

package/lib/services/cookieService.d.ts

@@ -0,0 +1,14 @@
+interface CookieOptions {
+    expires?: Date;
+    maxAge?: number;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+declare function buildCookieString(name: string, value: string, options?: CookieOptions): string;
+declare function setCookie(name: string, value: string, options?: CookieOptions): void;
+declare function getCookie(name: string): string | null;
+declare function removeCookie(name: string, options?: Omit<CookieOptions, 'expires' | 'maxAge'>): void;
+export { buildCookieString, getCookie, removeCookie, setCookie };
+export type { CookieOptions };

package/lib/services/cookieService.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCookie = exports.removeCookie = exports.getCookie = exports.buildCookieString = void 0;
+function buildCookieString(name, value, options) {
+    const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];
+    if (options?.expires) {
+        parts.push(`expires=${options.expires.toUTCString()}`);
+    }
+    if (options?.maxAge != null) {
+        parts.push(`max-age=${options.maxAge}`);
+    }
+    if (options?.path) {
+        parts.push(`path=${options.path}`);
+    }
+    if (options?.domain) {
+        parts.push(`domain=${options.domain}`);
+    }
+    if (options?.secure) {
+        parts.push('secure');
+    }
+    if (options?.sameSite) {
+        parts.push(`samesite=${options.sameSite}`);
+    }
+    return parts.join('; ');
+}
+exports.buildCookieString = buildCookieString;
+function setCookie(name, value, options) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    document.cookie = buildCookieString(name, value, options);
+}
+exports.setCookie = setCookie;
+function getCookie(name) {
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const nameEQ = `${encodeURIComponent(name)}=`;
+    const cookies = document.cookie.split(';');
+    for (const cookie of cookies) {
+        const trimmed = cookie.trim();
+        if (trimmed.startsWith(nameEQ)) {
+            return decodeURIComponent(trimmed.substring(nameEQ.length));
+        }
+    }
+    return null;
+}
+exports.getCookie = getCookie;
+function removeCookie(name, options) {
+    setCookie(name, '', {
+        ...options,
+        expires: new Date(0),
+    });
+}
+exports.removeCookie = removeCookie;

package/lib/src/api/authApiClient.d.ts

@@ -0,0 +1,13 @@
+declare class AuthApiClient {
+    private readonly apiAuthServiceUrl;
+    constructor();
+    loginOrSignUpByEmail(email: string): Promise<void>;
+    verifyCode(email: string, code: string): Promise<VerifyCodeResponse>;
+}
+interface VerifyCodeResponse {
+    access_token: string;
+    token_type: string;
+    user_id: string;
+    email: string;
+}
+export { AuthApiClient };

package/lib/src/api/authApiClient.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthApiClient = void 0;
+const assert_1 = require("../utils/assert");
+const API_AUTH_SERVICE_URL = process.env.API_AUTH_SERVICE_URL;
+class AuthApiClient {
+    apiAuthServiceUrl;
+    constructor() {
+        (0, assert_1.assert)(!!API_AUTH_SERVICE_URL, 'API_AUTH_SERVICE_URL env is required');
+        this.apiAuthServiceUrl = API_AUTH_SERVICE_URL;
+    }
+    async loginOrSignUpByEmail(email) {
+        const response = await fetch(`${this.apiAuthServiceUrl}/auth/email/send-code`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ email }),
+        });
+        (0, assert_1.assert)(!!response.ok, 'Code sending failed');
+    }
+    async verifyCode(email, code) {
+        const response = await fetch(`${this.apiAuthServiceUrl}/auth/email/verify-code`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ email, code }),
+        });
+        (0, assert_1.assert)(!!response.ok, 'Code verification failed');
+        const data = await response.json();
+        return data;
+    }
+}
+exports.AuthApiClient = AuthApiClient;

package/lib/src/features/signInOrSignUp.d.ts

@@ -0,0 +1,20 @@
+import { AuthApiClient } from '../api/authApiClient';
+interface AuthTokenData {
+    accessToken: string;
+    tokenType: string;
+    userId: string;
+    email: string;
+}
+interface SendCodeResult {
+    success: boolean;
+    error: string | null;
+}
+interface VerifyCodeResult {
+    success: boolean;
+    tokenData: AuthTokenData | null;
+    error: string | null;
+}
+declare function sendVerificationCode(email: string, authClient: AuthApiClient): Promise<SendCodeResult>;
+declare function verifyCodeAndSaveToken(email: string, code: string, authClient: AuthApiClient, cookieName?: string): Promise<VerifyCodeResult>;
+export { sendVerificationCode, verifyCodeAndSaveToken };
+export type { AuthTokenData, SendCodeResult, VerifyCodeResult };

package/lib/src/features/signInOrSignUp.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyCodeAndSaveToken = exports.sendVerificationCode = void 0;
+const cookieService_1 = require("../services/cookieService");
+function validateEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+function validateCode(code) {
+    return code.length > 0;
+}
+function validateEmailInput(email) {
+    if (!validateEmail(email)) {
+        return { valid: false, error: 'Invalid email format' };
+    }
+    return { valid: true, error: null };
+}
+function validateVerifyInput(email, code) {
+    if (!validateEmail(email)) {
+        return { valid: false, error: 'Invalid email format' };
+    }
+    if (!validateCode(code)) {
+        return { valid: false, error: 'Code is required' };
+    }
+    return { valid: true, error: null };
+}
+function transformVerifyCodeResponse(response) {
+    return {
+        accessToken: response.access_token,
+        tokenType: response.token_type,
+        userId: response.user_id,
+        email: response.email,
+    };
+}
+function createCookieOptions() {
+    const maxAge = 60 * 60 * 24 * 30;
+    return {
+        maxAge,
+        path: '/',
+        secure: true,
+        sameSite: 'lax',
+    };
+}
+function saveAuthTokenToCookie(token, cookieName = 'auth_token') {
+    const options = createCookieOptions();
+    (0, cookieService_1.setCookie)(cookieName, token, options);
+}
+async function sendVerificationCode(email, authClient) {
+    const validation = validateEmailInput(email);
+    if (!validation.valid) {
+        return {
+            success: false,
+            error: validation.error,
+        };
+    }
+    try {
+        await authClient.loginOrSignUpByEmail(email);
+        return {
+            success: true,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Code sending failed',
+        };
+    }
+}
+exports.sendVerificationCode = sendVerificationCode;
+async function verifyCodeAndSaveToken(email, code, authClient, cookieName) {
+    const validation = validateVerifyInput(email, code);
+    if (!validation.valid) {
+        return {
+            success: false,
+            tokenData: null,
+            error: validation.error,
+        };
+    }
+    try {
+        const response = await authClient.verifyCode(email, code);
+        const tokenData = transformVerifyCodeResponse(response);
+        saveAuthTokenToCookie(tokenData.accessToken, cookieName);
+        return {
+            success: true,
+            tokenData,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            tokenData: null,
+            error: error instanceof Error ? error.message : 'Code verification failed',
+        };
+    }
+}
+exports.verifyCodeAndSaveToken = verifyCodeAndSaveToken;

package/lib/src/index.d.ts

@@ -0,0 +1 @@
+export * from './features/signInOrSignUp';

package/lib/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./features/signInOrSignUp"), exports);

package/lib/src/services/cookieService.d.ts

@@ -0,0 +1,14 @@
+interface CookieOptions {
+    expires?: Date;
+    maxAge?: number;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+declare function buildCookieString(name: string, value: string, options?: CookieOptions): string;
+declare function setCookie(name: string, value: string, options?: CookieOptions): void;
+declare function getCookie(name: string): string | null;
+declare function removeCookie(name: string, options?: Omit<CookieOptions, 'expires' | 'maxAge'>): void;
+export { buildCookieString, getCookie, removeCookie, setCookie };
+export type { CookieOptions };

package/lib/src/services/cookieService.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCookie = exports.removeCookie = exports.getCookie = exports.buildCookieString = void 0;
+function buildCookieString(name, value, options) {
+    const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];
+    if (options?.expires) {
+        parts.push(`expires=${options.expires.toUTCString()}`);
+    }
+    if (options?.maxAge != null) {
+        parts.push(`max-age=${options.maxAge}`);
+    }
+    if (options?.path) {
+        parts.push(`path=${options.path}`);
+    }
+    if (options?.domain) {
+        parts.push(`domain=${options.domain}`);
+    }
+    if (options?.secure) {
+        parts.push('secure');
+    }
+    if (options?.sameSite) {
+        parts.push(`samesite=${options.sameSite}`);
+    }
+    return parts.join('; ');
+}
+exports.buildCookieString = buildCookieString;
+function setCookie(name, value, options) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    document.cookie = buildCookieString(name, value, options);
+}
+exports.setCookie = setCookie;
+function getCookie(name) {
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const nameEQ = `${encodeURIComponent(name)}=`;
+    const cookies = document.cookie.split(';');
+    for (const cookie of cookies) {
+        const trimmed = cookie.trim();
+        if (trimmed.startsWith(nameEQ)) {
+            return decodeURIComponent(trimmed.substring(nameEQ.length));
+        }
+    }
+    return null;
+}
+exports.getCookie = getCookie;
+function removeCookie(name, options) {
+    setCookie(name, '', {
+        ...options,
+        expires: new Date(0),
+    });
+}
+exports.removeCookie = removeCookie;

package/lib/src/utils/assert.d.ts

@@ -0,0 +1,2 @@
+declare function assert(condition: boolean, message: string): asserts condition;
+export { assert };

package/lib/src/utils/assert.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assert = void 0;
+function assert(condition, message) {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+exports.assert = assert;

package/lib/utils/assert.d.ts

@@ -0,0 +1,2 @@
+declare function assert(condition: boolean, message: string): asserts condition;
+export { assert };

package/lib/utils/assert.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assert = void 0;
+function assert(condition, message) {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+exports.assert = assert;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@liveartx/authentication",
+  "version": "1.0.0",
+  "description": "LiveArt authentication package",
+  "files": [
+    "lib/**/*"
+  ],
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "build": "npx tsc --project tsconfig.json && npx tscpaths -p tsconfig.json -s ./src -o ./lib/src",
+    "format": "prettier --write \"index.ts\" \"src/**/*.ts\"",
+    "lint": "eslint src/ --ext .js,.jsx,.ts,.tsx --max-warnings=0 --fix",
+    "check:types": "tsc -p ./tsconfig.json --pretty --noEmit",
+    "prepare": "husky install"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/live-art-project/liveartx-auth.git"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "5.31.0",
+    "@typescript-eslint/parser": "5.31.0",
+    "eslint": "7.32.0",
+    "eslint-config-prettier": "8.5.0",
+    "eslint-plugin-import": "2.24.1",
+    "eslint-plugin-prettier": "3.4.1",
+    "eslint-plugin-simple-import-sort": "7.0.0",
+    "husky": "8.0.1",
+    "prettier": "2.7.1",
+    "ts-node": "10.9.2",
+    "tscpaths": "0.0.9",
+    "typescript": "4.7.4"
+  },
+  "lint-staged": {
+    "**/*.{ts,tsx}": [
+      "prettier --write",
+      "eslint --fix"
+    ]
+  }
+}