feat: implement framework-agnostic services for authentication, storage, themes, encryption, file handling, global settings, Google Pay, and translation

Smilefounder · Smilefounder · commit 9a8c321192ca · 2025-07-31T09:22:28.000+07:00
diff --git a/packages/apis/src/auth-services.test.ts b/packages/apis/src/auth-services.test.ts
@@ -0,0 +1,40 @@
+import { AuthService, AuthServiceConfig } from './auth-services';
+
+describe('AuthService', () => {
+  const config: AuthServiceConfig = {
+    apiBaseUrl: 'https://mixcore.net',
+    encryptAES: (data) => data, // mock encryption
+    updateAuthData: jest.fn(),
+    fillAuthData: jest.fn(async () => ({ info: { userRoles: [{ description: 'Admin', isActived: true }] } })),
+    initAllSettings: jest.fn(async () => {}),
+    getApiResult: jest.fn(async (req) => ({ isSucceed: true, data: {} })),
+    getRestApiResult: jest.fn(async (req) => ({ isSucceed: true, data: {} })),
+    localStorage: { removeItem: jest.fn() } as any,
+  };
+  const service = new AuthService(config);
+
+  it('should call saveRegistration', async () => {
+    await service.saveRegistration({});
+    expect(config.getApiResult).toHaveBeenCalled();
+  });
+
+  it('should call forgotPassword', async () => {
+    await service.forgotPassword({});
+    expect(config.getRestApiResult).toHaveBeenCalled();
+  });
+
+  it('should call login and updateAuthData', async () => {
+    await service.login({ username: 'user', password: 'pass' });
+    expect(config.updateAuthData).toHaveBeenCalled();
+  });
+
+  it('should call logOut and removeItem', async () => {
+    await service.logOut();
+    expect(config.localStorage?.removeItem).toHaveBeenCalledWith('authorizationData');
+  });
+
+  it('should call isInRole', async () => {
+    await service.fillAuthData();
+    expect(service.isInRole('Admin')).toBe(true);
+  });
+});
diff --git a/packages/apis/src/auth-services.ts b/packages/apis/src/auth-services.ts
@@ -0,0 +1,127 @@
+/**
+ * AuthService
+ * Framework-agnostic, TypeScript-native authentication API client for Mixcore
+ *
+ * @remarks
+ * Refactored from legacy AngularJS service. All SPA dependencies removed.
+ * Configuration is injected via constructor.
+ */
+export interface AuthServiceConfig {
+  apiBaseUrl: string;
+  apiKey?: string;
+  encryptAES: (data: string) => string;
+  updateAuthData: (data: any) => void;
+  fillAuthData: () => Promise<any>;
+  initAllSettings: () => Promise<void>;
+  getApiResult: (req: any) => Promise<any>;
+  getRestApiResult: (req: any, ...args: any[]) => Promise<any>;
+  localStorage?: Storage;
+}
+
+export class AuthService {
+  private config: AuthServiceConfig;
+  public authentication: any = null;
+
+  constructor(config: AuthServiceConfig) {
+    this.config = config;
+  }
+
+  async saveRegistration(registration: any): Promise<any> {
+    return this.config.getApiResult({
+      method: 'POST',
+      url: '/account/register',
+      data: registration,
+    });
+  }
+
+  async forgotPassword(data: any): Promise<any> {
+    return this.config.getRestApiResult({
+      method: 'POST',
+      url: '/account/forgot-password',
+      data: JSON.stringify(data),
+    });
+  }
+
+  async resetPassword(data: any): Promise<any> {
+    return this.config.getRestApiResult({
+      method: 'POST',
+      url: '/account/reset-password',
+      data: JSON.stringify(data),
+    });
+  }
+
+  async login(loginData: { username: string; password: string; rememberMe?: boolean }): Promise<any> {
+    const data = {
+      UserName: loginData.username,
+      Password: loginData.password,
+      RememberMe: loginData.rememberMe,
+      Email: '',
+      ReturnUrl: '',
+    };
+    const message = this.config.encryptAES(JSON.stringify(data));
+    const req = {
+      method: 'POST',
+      url: '/account/login',
+      data: JSON.stringify({ message }),
+    };
+    const resp = await this.config.getRestApiResult(req, true);
+    if (resp.isSucceed) {
+      this.config.updateAuthData(resp.data);
+      await this.config.initAllSettings();
+    }
+    return resp;
+  }
+
+  async externalLogin(loginData: any, provider: string): Promise<any> {
+    const data = {
+      provider,
+      username: loginData.username,
+      email: loginData.email,
+      externalAccessToken: loginData.accessToken,
+    };
+    const message = this.config.encryptAES(JSON.stringify(data));
+    const req = {
+      method: 'POST',
+      url: '/account/external-login',
+      data: JSON.stringify({ message }),
+    };
+    const resp = await this.config.getRestApiResult(req, true);
+    if (resp.isSucceed) {
+      this.config.updateAuthData(resp.data);
+      await this.config.initAllSettings();
+    }
+    return resp;
+  }
+
+  async logOut(): Promise<void> {
+    if (this.config.localStorage) {
+      this.config.localStorage.removeItem('authorizationData');
+    }
+    // Optionally, call /account/logout endpoint if needed
+  }
+
+  async fillAuthData(): Promise<void> {
+    this.authentication = await this.config.fillAuthData();
+  }
+
+  async refreshToken(id: string, accessToken: string): Promise<any> {
+    if (!id) return this.logOut();
+    const req = {
+      method: 'POST',
+      url: '/account/refresh-token',
+      data: JSON.stringify({ refreshToken: id, accessToken }),
+    };
+    const resp = await this.config.getApiResult(req);
+    if (resp.isSucceed) {
+      return this.config.updateAuthData(resp.data);
+    } else {
+      return this.logOut();
+    }
+  }
+
+  isInRole(roleName: string): boolean {
+    if (!this.authentication || !this.authentication.info) return false;
+    const roles = this.authentication.info.userRoles || [];
+    return roles.some((m: any) => m.description === roleName && m.isActived);
+  }
+}
diff --git a/packages/apis/src/store-services.ts b/packages/apis/src/store-services.ts
@@ -0,0 +1,44 @@
+/**
+ * StoreService
+ * Framework-agnostic, TypeScript-native store API client for Mixcore
+ *
+ * @remarks
+ * Refactored from legacy AngularJS service. All SPA dependencies removed.
+ * Configuration is injected via constructor.
+ */
+export interface StoreServiceConfig {
+  apiBaseUrl: string;
+  apiKey?: string;
+  getRestApiResult: (req: any) => Promise<any>;
+}
+
+export class StoreService {
+  private config: StoreServiceConfig;
+  private serviceBase = 'https://store.mixcore.org';
+
+  constructor(config: StoreServiceConfig) {
+    this.config = config;
+  }
+
+  async getThemes(objData?: Record<string, any>): Promise<any> {
+    const params = objData ? this.parseQuery(objData) : '';
+    let url = '/rest/en-us/post/client';
+    if (params) url += '?' + params;
+    const req = { serviceBase: this.serviceBase, method: 'GET', url };
+    return this.config.getRestApiResult(req);
+  }
+
+  async getCategories(objData?: Record<string, any>): Promise<any> {
+    const params = objData ? this.parseQuery(objData) : '';
+    let url = '/rest/en-us/mix-database-data/client';
+    if (params) url += '?' + params;
+    const req = { serviceBase: this.serviceBase, method: 'GET', url };
+    return this.config.getRestApiResult(req);
+  }
+
+  private parseQuery(obj: Record<string, any>): string {
+    return Object.entries(obj)
+      .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+      .join('&');
+  }
+}
diff --git a/packages/apis/src/theme-services.ts b/packages/apis/src/theme-services.ts
@@ -0,0 +1,46 @@
+/**
+ * ThemeService
+ * Framework-agnostic, TypeScript-native theme API client for Mixcore
+ *
+ * @remarks
+ * Refactored from legacy AngularJS service. All SPA dependencies removed.
+ * Configuration is injected via constructor.
+ */
+export interface ThemeServiceConfig {
+  apiBaseUrl: string;
+  apiKey?: string;
+  getRestApiResult: (req: any) => Promise<any>;
+}
+
+export class ThemeService {
+  private config: ThemeServiceConfig;
+  private prefixUrl = 'theme/portal';
+
+  constructor(config: ThemeServiceConfig) {
+    this.config = config;
+  }
+
+  async syncTemplates(id: string): Promise<any> {
+    const url = `${this.prefixUrl}/sync/${id}`;
+    const req = { method: 'GET', url };
+    return this.config.getRestApiResult(req);
+  }
+
+  async install(objData: any): Promise<any> {
+    const url = `${this.prefixUrl}/install`;
+    const req = { method: 'POST', url, data: JSON.stringify(objData) };
+    return this.config.getRestApiResult(req);
+  }
+
+  async export(id: string, objData: any): Promise<any> {
+    const url = `${this.prefixUrl}/export/${id}`;
+    const req = { method: 'POST', url, data: JSON.stringify(objData) };
+    return this.config.getRestApiResult(req);
+  }
+
+  async getExportData(id: string): Promise<any> {
+    const url = `${this.prefixUrl}/export/${id}`;
+    const req = { method: 'GET', url };
+    return this.config.getRestApiResult(req);
+  }
+}
diff --git a/packages/shared/src/crypto-services.ts b/packages/shared/src/crypto-services.ts
@@ -0,0 +1,69 @@
+/**
+ * CryptoService
+ * Framework-agnostic AES encryption/decryption utility for Mixcore SDK
+ *
+ * @remarks
+ * Refactored from legacy AngularJS service. All SPA dependencies removed.
+ * Uses CryptoJS (must be provided by consumer).
+ */
+export interface CryptoServiceConfig {
+  apiEncryptKey: string;
+  CryptoJS: any;
+}
+
+export class CryptoService {
+  private config: CryptoServiceConfig;
+  private size = 256;
+
+  constructor(config: CryptoServiceConfig) {
+    this.config = config;
+  }
+
+  encryptAES(message: string, iCompleteEncodedKey?: string): string {
+    const { key, iv } = this.parseKeys(iCompleteEncodedKey || this.config.apiEncryptKey);
+    return this.encryptMessage(message, key, iv);
+  }
+
+  decryptAES(ciphertext: string, iCompleteEncodedKey?: string): string {
+    const { key, iv } = this.parseKeys(iCompleteEncodedKey || this.config.apiEncryptKey);
+    return this.decryptMessage(ciphertext, key, iv);
+  }
+
+  private encryptMessage(message: string, key: any, iv: any): string {
+    const { CryptoJS } = this.config;
+    const options = {
+      iv,
+      keySize: this.size / 8,
+      mode: CryptoJS.mode.CBC,
+      padding: CryptoJS.pad.Pkcs7,
+    };
+    const encrypted = CryptoJS.AES.encrypt(message, key, options);
+    return encrypted.ciphertext.toString(CryptoJS.enc.Base64);
+  }
+
+  private decryptMessage(ciphertext: string, key: any, iv: any): string {
+    const { CryptoJS } = this.config;
+    const cipherParams = CryptoJS.lib.CipherParams.create({
+      ciphertext: CryptoJS.enc.Base64.parse(ciphertext),
+    });
+    const options = {
+      iv,
+      keySize: this.size / 8,
+      mode: CryptoJS.mode.CBC,
+      padding: CryptoJS.pad.Pkcs7,
+    };
+    const decrypted = CryptoJS.AES.decrypt(cipherParams, key, options);
+    return decrypted.toString(CryptoJS.enc.Utf8);
+  }
+
+  private parseKeys(iCompleteEncodedKey: string) {
+    const { CryptoJS } = this.config;
+    const keyStrings = CryptoJS.enc.Utf8.stringify(
+      CryptoJS.enc.Base64.parse(iCompleteEncodedKey)
+    ).split(",");
+    return {
+      iv: CryptoJS.enc.Base64.parse(keyStrings[0]),
+      key: CryptoJS.enc.Base64.parse(keyStrings[1]),
+    };
+  }
+}
diff --git a/packages/shared/src/file-services.ts b/packages/shared/src/file-services.ts
@@ -0,0 +1,23 @@
+/**
+ * FileService
+ * Framework-agnostic file utility for Mixcore SDK
+ *
+ * @remarks
+ * Refactored from legacy AngularJS service. All SPA dependencies removed.
+ * Extends base service pattern.
+ */
+export interface FileServiceConfig {
+  apiBaseUrl: string;
+  apiKey?: string;
+}
+
+export class FileService {
+  private config: FileServiceConfig;
+  private prefixUrl = 'file';
+
+  constructor(config: FileServiceConfig) {
+    this.config = config;
+  }
+
+  // Add file-related methods as needed
+}
diff --git a/packages/shared/src/global-settings-services.ts b/packages/shared/src/global-settings-services.ts
diff --git a/packages/shared/src/gpay-services.ts b/packages/shared/src/gpay-services.ts
diff --git a/packages/shared/src/translator-services.ts b/packages/shared/src/translator-services.ts
