@qlover/create-app 0.1.14 → 0.1.16

package/templates/react-app/lib/bootstrap/plugins/InjectGlobal.ts

@@ -1,36 +0,0 @@
-import type { ExecutorContext } from '@qlover/fe-utils';
-import type {
-  BootstrapArgs,
-  BootstrapExecutorPlugin
-} from '../BootstrapExecutorPlugin';
-
-export class InjectGlobal implements BootstrapExecutorPlugin {
-  readonly pluginName = 'InjectGlobal';
-
-  constructor(
-    private sources: Record<string, unknown>,
-    private target?: string | Record<string, unknown>
-  ) {}
-
-  onBefore(context: ExecutorContext<BootstrapArgs>): void {
-    // if target is provided, inject globals to target
-    if (typeof this.target === 'string') {
-      Object.assign(context.parameters.root!, {
-        [this.target]: Object.freeze(Object.assign({}, this.sources))
-      });
-      return;
-    }
-
-    const target = this.target || context.parameters.root;
-
-    if (typeof target !== 'object' || target === null) {
-      throw new Error('target must be an object');
-    }
-
-    // inject globals to root
-    for (const key in this.sources) {
-      const element = this.sources[key];
-      Object.assign(target, { [key]: element });
-    }
-  }
-}

package/templates/react-app/lib/bootstrap/plugins/InjectIOC.ts

@@ -1,24 +0,0 @@
-import type { IOCRegisterInterface } from '../IOCContainerInterface';
-import type { IOCManagerInterface } from '../IOCManagerInterface';
-import type {
-  BootstrapContext,
-  BootstrapExecutorPlugin
-} from '../BootstrapExecutorPlugin';
-import { Container } from 'inversify';
-
-export class InjectIOC implements BootstrapExecutorPlugin {
-  readonly pluginName = 'InjectIOC';
-
-  constructor(
-    private IOC: IOCManagerInterface,
-    private registeres: IOCRegisterInterface<Container>[]
-  ) {}
-
-  onBefore(context: BootstrapContext): void {
-    const { ioc } = context.parameters;
-    this.IOC.implement(ioc);
-
-    // maybe runtimes configure
-    ioc.configure(this.registeres);
-  }
-}

package/templates/react-app/lib/env-config/injectPkgConfig.ts

@@ -1,11 +0,0 @@
-export function injectPkgConfig(
-  options: [string, string][],
-  envPrefix: string = ''
-) {
-  options.forEach(([key, value]) => {
-    const envKey = `${envPrefix}${key}`;
-    if (!process.env[envKey]) {
-      process.env[envKey] = value;
-    }
-  });
-}

package/templates/react-app/lib/fe-react-controller/FeController.ts

@@ -1,19 +0,0 @@
-import { SliceStore } from '@qlover/slice-store-react';
-
-export class FeController<T> extends SliceStore<T> {
-  constructor(private stateFactory: () => T) {
-    super(stateFactory);
-  }
-
-  getState(): T {
-    return this.state;
-  }
-
-  setState(state: Partial<T>): void {
-    this.emit({ ...this.state, ...state });
-  }
-
-  reset(): void {
-    this.emit(this.stateFactory());
-  }
-}

package/templates/react-app/lib/fe-react-controller/index.ts

@@ -1,2 +0,0 @@
-export * from './FeController';
-export * from './useController';

package/templates/react-app/lib/fe-react-controller/useController.ts

@@ -1,71 +0,0 @@
-import { useSliceStore } from '@qlover/slice-store-react';
-import { FeController } from './FeController';
-import { useEffect, useRef, useState } from 'react';
-
-/**
- * Hook for managing controller instances and their state.
- * Change controller to UIController
- * @param createController Factory function that creates a controller instance or controller instance
- * @returns Controller instance with precise type inference
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function useController<C extends FeController<any>>(
-  createController: (() => C) | C
-): C {
-  const controllerRef = useRef<C | null>(null);
-  const [, forceUpdate] = useState(0);
-
-  if (!controllerRef.current) {
-    controllerRef.current =
-      typeof createController === 'function'
-        ? createController()
-        : createController;
-  }
-
-  useEffect(() => {
-    const controller = controllerRef.current!;
-
-    const unsubscribe = controller.observe(() => {
-      forceUpdate((prev) => prev + 1);
-    });
-
-    return () => {
-      unsubscribe();
-    };
-  }, []);
-
-  return controllerRef.current;
-}
-
-/**
- * Create a Controller instance and cache it to avoid repeated creation
- *
- * @see https://github.com/alibaba/hooks/blob/master/packages/hooks/src/useCreation/index.ts
- * @param Controller
- * @param args
- * @returns
- */
-export function useCreateController<
-  T,
-  Ctrl extends FeController<T>,
-  Args extends unknown[]
->(Controller: new (...args: Args) => Ctrl, ...args: Args): Ctrl {
-  const { current } = useRef({
-    target: undefined as undefined | Ctrl,
-    initialized: false
-  });
-
-  if (!current.initialized) {
-    current.target = new Controller(...args);
-    current.initialized = true;
-  }
-
-  return current.target as Ctrl;
-}
-
-export function useControllerState<T, S = T>(
-  controller: FeController<T>,
-  selector?: (state: T) => S
-): S {
-  return useSliceStore(controller, selector);
-}

package/templates/react-app/lib/fe-react-theme/ThemeController.ts

@@ -1,40 +0,0 @@
-import { FeController } from '@lib/fe-react-controller';
-import { ThemeControllerProps, ThemeControllerState } from './type';
-import { ThemeStateGetter } from './ThemeStateGetter';
-
-export class ThemeController extends FeController<ThemeControllerState> {
-  constructor(private props: ThemeControllerProps) {
-    super(() => ThemeStateGetter.create(props));
-
-    this.bindToTheme();
-  }
-
-  getSupportedThemes(): string[] {
-    return this.props.supportedThemes;
-  }
-
-  bindToTheme(): void {
-    const { theme } = this.getState();
-
-    const { domAttribute } = this.props;
-
-    if (domAttribute) {
-      document.documentElement.setAttribute(domAttribute, theme);
-    }
-  }
-
-  changeTheme(theme: string): void {
-    if (theme === ThemeStateGetter.SYSTEM_THEME) {
-      theme = ThemeStateGetter.getSystemTheme();
-    }
-
-    this.setState({ theme });
-
-    const { storage, storageKey } = this.props;
-    if (storage && storageKey) {
-      storage.setItem(storageKey, theme);
-    }
-
-    this.bindToTheme();
-  }
-}

package/templates/react-app/lib/fe-react-theme/ThemeStateGetter.ts

@@ -1,53 +0,0 @@
-import isString from 'lodash/isString';
-import { ThemeControllerProps, ThemeControllerState } from './type';
-
-export class ThemeStateGetter {
-  static SYSTEM_THEME = 'system';
-
-  static create(props: ThemeControllerProps): ThemeControllerState {
-    const theme = ThemeStateGetter.getDefaultTheme(props);
-
-    return {
-      theme
-    };
-  }
-
-  static getDefaultTheme(props: ThemeControllerProps): string {
-    const { storage, storageKey, defaultTheme } = props;
-
-    let theme;
-
-    // Trying to use local storage
-    if (storage && storageKey) {
-      theme = storage.getItem(storageKey);
-
-      if (isString(theme) && props.supportedThemes.includes(theme)) {
-        return theme;
-      }
-    }
-
-    if (theme === ThemeStateGetter.SYSTEM_THEME) {
-      return ThemeStateGetter.getSystemTheme();
-    }
-
-    // if local storage does not have theme, use system theme
-    if (defaultTheme) {
-      if (defaultTheme === ThemeStateGetter.SYSTEM_THEME) {
-        return ThemeStateGetter.getSystemTheme();
-      }
-
-      return defaultTheme;
-    }
-
-    return ThemeStateGetter.getSystemTheme();
-  }
-
-  static getSystemTheme(): 'dark' | 'light' {
-    // use window.matchMedia to detect prefers-color-scheme media query
-    const isDarkMode =
-      window.matchMedia &&
-      window.matchMedia('(prefers-color-scheme: dark)').matches;
-
-    return isDarkMode ? 'dark' : 'light';
-  }
-}

package/templates/react-app/lib/fe-react-theme/index.ts

@@ -1,3 +0,0 @@
-export * from './ThemeController';
-export * from './ThemeStateGetter';
-export * from './type';

package/templates/react-app/lib/fe-react-theme/type.ts

@@ -1,21 +0,0 @@
-import { JSONStorage } from '@qlover/fe-utils';
-
-export type ThemeControllerState = {
-  theme: string;
-};
-
-export type ThemeConfig = {
-  domAttribute: string;
-  defaultTheme: string;
-  target: string;
-  supportedThemes: string[];
-  storageKey: string;
-  styleThemeKeyTemplate: string;
-  styleKeyTemplate: string;
-  colorsValueTemplate: string;
-  colors: Record<string, unknown>;
-};
-
-export interface ThemeControllerProps extends ThemeConfig {
-  storage?: JSONStorage;
-}

package/templates/react-app/lib/openAiApi/OpenAIAuthPlugin.ts

@@ -1,29 +0,0 @@
-import {
-  ExecutorContext,
-  ExecutorPlugin,
-  RequestAdapterFetchConfig,
-  RequestAdapterResponse
-} from '@qlover/fe-utils';
-import { StreamProcessor } from './StreamProcessor';
-
-export class OpenAIAuthPlugin
-  implements ExecutorPlugin<RequestAdapterFetchConfig>
-{
-  readonly pluginName = 'OpenAIAuthPlugin';
-
-  async onSuccess(
-    context: ExecutorContext<RequestAdapterFetchConfig>
-  ): Promise<void> {
-    const adapterResponse = context.returnValue as RequestAdapterResponse<
-      Request,
-      Response
-    >;
-
-    if (adapterResponse.data.body instanceof ReadableStream) {
-      const processer = new StreamProcessor();
-      const data = await processer.processStream(adapterResponse.data.body);
-      // overried response data
-      context.returnValue = data;
-    }
-  }
-}

package/templates/react-app/lib/openAiApi/OpenAIClient.ts

@@ -1,51 +0,0 @@
-import {
-  RequestScheduler,
-  RequestAdapterConfig,
-  RequestAdapterFetch,
-  RequestAdapterFetchConfig,
-  FetchURLPlugin,
-  RequestAdapterResponse
-} from '@qlover/fe-utils';
-import { StreamResultType } from './StreamProcessor';
-import { OpenAIAuthPlugin } from './OpenAIAuthPlugin';
-import {
-  RequestCommonPlugin,
-  RequestCommonPluginConfig
-} from '@lib/request-common-plugin';
-export interface ApiMessage {
-  content: string;
-  role: 'user' | 'system' | 'assistant';
-}
-
-export interface OpenAIChatParmas {
-  model?: string;
-  messages: ApiMessage[];
-  stream?: boolean;
-}
-
-export type OpenAIAargs = {
-  commonPluginConfig: RequestCommonPluginConfig;
-  models: string[];
-};
-
-export type OpenAIClientConfig = Partial<RequestAdapterFetchConfig> &
-  OpenAIAargs;
-
-export class OpenAIClient extends RequestScheduler<RequestAdapterConfig> {
-  constructor(config: OpenAIClientConfig) {
-    const { commonPluginConfig, ...rest } = config;
-    super(new RequestAdapterFetch(rest));
-
-    this.usePlugin(new FetchURLPlugin());
-    this.usePlugin(new RequestCommonPlugin(commonPluginConfig));
-    this.usePlugin(new OpenAIAuthPlugin());
-  }
-
-  async completion(
-    params: OpenAIChatParmas
-  ): Promise<RequestAdapterResponse<StreamResultType>> {
-    return this.post('/chat/completions', {
-      data: params
-    });
-  }
-}

package/templates/react-app/lib/openAiApi/StreamProcessor.ts

@@ -1,81 +0,0 @@
-export type StreamResultType = {
-  content: string;
-};
-
-export class StreamProcessor {
-  private decoder = new TextDecoder('utf-8');
-  private buffer = '';
-
-  async processStream(
-    readableStream: ReadableStream<Uint8Array>
-  ): Promise<StreamResultType> {
-    let fullContent = '';
-
-    const reader = readableStream.getReader();
-
-    const shouldStop = (result: ReadableStreamReadResult<any>): boolean => {
-      return result.done;
-    };
-
-    try {
-      while (true) {
-        const readResult = await reader.read();
-        if (shouldStop(readResult)) break;
-
-        const decodedChunk = this.decoder.decode(readResult.value, {
-          stream: true
-        });
-
-        const processLineResult = await this.processChunk(decodedChunk);
-
-        fullContent += processLineResult.value;
-
-        if (processLineResult.done) break;
-      }
-    } finally {
-      reader.releaseLock();
-    }
-
-    return {
-      content: fullContent
-    };
-  }
-
-  processLine(line: string) {
-    const data = line.startsWith('data:') ? line.slice(6).trim() : '';
-
-    if (data === '[DONE]') {
-      return { done: true, value: '' };
-    }
-
-    const value = data ? JSON.parse(data).choices[0]?.delta?.content : '';
-
-    return { done: false, value: value };
-  }
-
-  async processChunk(chunk: string) {
-    let processedContent = '';
-    this.buffer += chunk;
-    const lines = this.buffer.split('\n');
-    this.buffer = lines.pop() || '';
-    for (const line of lines) {
-      try {
-        const lineResult = this.processLine(line);
-
-        if (lineResult.done) {
-          return { value: processedContent, done: true };
-        }
-
-        if (!lineResult.value) {
-          continue;
-        }
-
-        processedContent += lineResult.value;
-      } catch (error) {
-        console.error('Parsing error:', error);
-        this.buffer = line + '\n' + this.buffer;
-      }
-    }
-    return { value: processedContent, done: false };
-  }
-}

package/templates/react-app/lib/openAiApi/index.ts

@@ -1,3 +0,0 @@
-export * from './OpenAIClient';
-export * from './OpenAIAuthPlugin';
-export * from './StreamProcessor';

package/templates/react-app/lib/request-common-plugin/index.ts

@@ -1,169 +0,0 @@
-import { get, isUndefined, set } from 'lodash';
-import {
-  ExecutorPlugin,
-  RequestAdapterConfig,
-  ExecutorContext,
-  RequestAdapterResponse
-} from '@qlover/fe-utils';
-
-export type RequestCommonPluginConfig = {
-  token?: string | (() => string | null);
-
-  /**
-   * token prefix.
-   *
-   * eg. `Bearer xxx`, `Token xxx`
-   */
-  tokenPrefix?: string;
-
-  /**
-   * @default `Authorization`
-   */
-  authKey?: string;
-
-  /**
-   * default request headers
-   */
-  defaultHeaders?: Record<string, string>;
-
-  /**
-   * Whether the token is required.
-   *
-   * if not token provided, throw error.
-   *
-   * @default `false`
-   */
-  requiredToken?: boolean;
-
-  /**
-   * defualt request data
-   */
-  defaultRequestData?: Record<string, unknown>;
-
-  /**
-   * transform request data before sending.
-   *
-   * @param data - request data
-   * @param context - executor context
-   * @returns - request data
-   */
-  requestDataSerializer?: (
-    data: unknown,
-    context: ExecutorContext<RequestAdapterConfig>
-  ) => unknown;
-};
-
-/**
- * Represents a plugin for handling common request configurations and behaviors.
- *
- * The RequestCommonPlugin is designed to manage request headers, token handling,
- * and data serialization before sending requests. It ensures that the necessary
- * configurations are applied to each request, enhancing the flexibility and
- * reusability of request handling in the application.
- *
- * Main functions include:
- * - Appending default headers and token to requests.
- * - Merging default request data with provided parameters.
- * - Serializing request data before sending.
- *
- * @example
- * const plugin = new RequestCommonPlugin({
- *   token: 'your-token',
- *   tokenPrefix: 'Bearer',
- *   defaultHeaders: { 'Custom-Header': 'value' },
- *   requiredToken: true,
- * });
- */
-export class RequestCommonPlugin
-  implements ExecutorPlugin<RequestAdapterConfig>
-{
-  readonly pluginName = 'RequestCommonPlugin';
-
-  constructor(readonly config: RequestCommonPluginConfig = {}) {
-    if (config.requiredToken && !config.token) {
-      throw new Error('Token is required!');
-    }
-  }
-
-  onBefore(context: ExecutorContext<RequestAdapterConfig>): void {
-    const {
-      tokenPrefix,
-      defaultHeaders,
-      authKey = 'Authorization',
-      defaultRequestData,
-      requestDataSerializer
-    } = this.config;
-    const { parameters } = context;
-
-    // append default headers
-    parameters.headers = {
-      ...defaultHeaders,
-      ...parameters.headers
-    };
-
-    // append content type header
-    if (
-      !parameters.headers['Content-Type'] &&
-      parameters.responseType === 'json'
-    ) {
-      parameters.headers['Content-Type'] = 'application/json';
-    }
-
-    // append token
-    if (authKey && !parameters.headers[authKey]) {
-      const authToken = this.getAuthToken();
-      const authValue = tokenPrefix ? `${tokenPrefix} ${authToken}` : authToken;
-      if (authValue) {
-        parameters.headers[authKey] = authValue;
-      }
-    }
-
-    // merge defaults request data
-    if (defaultRequestData) {
-      Object.entries(defaultRequestData).forEach(([key, value]) => {
-        const prevValue = get(parameters.data, key);
-        if (isUndefined(prevValue)) {
-          set(parameters.data as Record<string, unknown>, key, value);
-        }
-      });
-    }
-
-    // serialize request data
-    if (requestDataSerializer && parameters.data) {
-      parameters.data = requestDataSerializer(parameters.data, context);
-    }
-  }
-
-  async onSuccess(
-    context: ExecutorContext<RequestAdapterConfig>
-  ): Promise<void> {
-    const { parameters, returnValue } = context;
-    const response = (returnValue as RequestAdapterResponse<unknown, Response>)
-      .data;
-
-    if (response instanceof Response) {
-      switch (parameters.responseType) {
-        case 'json':
-          context.returnValue = await response.json();
-          break;
-        case 'text':
-          context.returnValue = await response.text();
-          break;
-        case 'blob':
-          context.returnValue = await response.blob();
-          break;
-        // FIXME: adapter support `arraybuffer`
-        // @ts-expect-error
-        case 'arrayBuffer':
-        case 'arraybuffer':
-          context.returnValue = await response.arrayBuffer();
-          break;
-      }
-    }
-  }
-
-  getAuthToken(): string {
-    const { token } = this.config;
-    return typeof token === 'function' ? (token() ?? '') : (token ?? '');
-  }
-}

package/templates/react-app/lib/router-loader/Page.ts

@@ -1,68 +0,0 @@
-import { LazyExoticComponent, PropsWithChildren } from 'react';
-import { RouteObject } from 'react-router-dom';
-
-import { TFunction } from 'i18next';
-import { UseTranslationResponse } from 'react-i18next';
-
-export interface BasePageProvider {
-  meta: RouteMeta;
-  i18n: UseTranslationResponse<string, string>;
-  t: TFunction<string, string>;
-}
-
-export type RouteCategory = 'main' | 'auth' | 'common';
-
-export interface RouteMeta {
-  category?: RouteCategory;
-  /**
-   * from app.router.json
-   */
-  title?: string;
-  icon?: string;
-  /**
-   * from app.router.json
-   *
-   * @default 'common'
-   */
-  localNamespace?: string;
-}
-
-export type RouteType = RouteObject & {
-  meta?: RouteMeta;
-};
-
-export type RouteConfig = {
-  routes: RouteType[];
-};
-
-export type PagesMaps = Record<
-  string,
-  | (() => LazyExoticComponent<React.ComponentType<unknown>>)
-  | (() => React.ComponentType<unknown>)
->;
-
-export type LoadProps = {
-  pagesMaps: PagesMaps;
-  componentPath: string;
-  route: RouteType;
-  Provider?: React.ComponentType<PropsWithChildren<RouteMeta>>;
-};
-
-type ComponentValue =
-  | React.ComponentType<unknown>
-  | LazyExoticComponent<React.ComponentType<unknown>>;
-
-export type ComponentMaps = {
-  /**
-   * key: ./xxx/bbb.(jsx,js,tsx,ts)
-   */
-  [key: string]:
-    | ComponentValue
-    | (() => Promise<ComponentValue>)
-    | (() => ComponentValue);
-};
-
-// new RouterManager({
-//   routes: [],
-//   componentMaps:
-// });