proteum 1.0.0-1

package/server/utils/slug.ts

@@ -0,0 +1,79 @@
+/*----------------------------------
+- DEPENDANCES
+----------------------------------*/
+
+// Npm
+import escapeStringRegexp from 'escape-regexp';
+import slugify from 'slugify';
+import { removeStopwords, eng } from 'stopword';
+
+// Core
+import type SQL from "@server/services/database";
+
+/*----------------------------------
+- TYPES
+----------------------------------*/
+
+/*----------------------------------
+- SERVICE
+----------------------------------*/
+export class Slug {
+
+    public async generate( label: string );
+    public async generate( label: string, SQL: SQL, table: string, column: string );
+    public async generate( label: string, SQL?: SQL, table?: string, column?: string ) {
+
+        // Generate slug
+        let slug = slugify(label, {
+            replacement: '-',  // replace spaces with replacement character, defaults to `-`
+            remove: /[^a-z\s]/ig, // remove characters that match regex, defaults to `undefined`
+            lower: true,      // convert to lower case, defaults to `false`
+            strict: true,     // strip special characters except replacement, defaults to `false`
+            locale: 'vi',       // language code of the locale to use
+            trim: true         // trim leading and trailing replacement chars, defaults to `true`
+        });
+
+        slug = removeStopwords( slug.split('-'), eng).join('-');
+
+        // Check if already existing
+        if (SQL !== undefined) {
+            slug = await this.Correct(slug, SQL, table, column);
+        }
+
+        return slug;
+    }
+
+    public async Correct( 
+        slug: string, 
+        SQL: SQL, 
+        table: string, 
+        column: string 
+    ) {
+        
+        const escapedSlug = escapeStringRegexp(slug);
+
+        const duplicates = await SQL.selectVal<number>(`
+            SELECT 
+                IF( ${column} LIKE ${SQL.esc(slug)},
+                    1,
+                    CAST(SUBSTRING_INDEX(slug, '-', -1) AS UNSIGNED)
+                ) AS duplicates
+            FROM ${table} 
+            WHERE 
+                ${column} LIKE ${SQL.esc(slug)}
+                OR
+                ${column} REGEXP '^${escapedSlug}-[0-9]+$'
+            ORDER BY duplicates DESC
+            LIMIT 1
+        `);
+
+        if (duplicates && duplicates > 0)
+            slug += `-${duplicates + 1}`;
+
+        return slug;
+
+    }
+
+}
+
+export default new Slug;

package/tsconfig.common.json

@@ -0,0 +1,45 @@
+/*
+    Condiguration de base pour l'app ET le framework
+*/
+{
+    "compilerOptions": {
+
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "allowJs": true,
+        "strict": false,
+        "downlevelIteration": true,
+        // Force case sensitive import filenames on Window and Mac
+        // https://briandesousa.net/?p=870 
+        "forceConsistentCasingInFileNames": true,
+
+        // Equivalent webpack: resolve.symblinks = false
+        "preserveSymlinks": true,
+        // Décorateurs
+        "experimentalDecorators": true,
+
+        "inlineSourceMap": true,
+
+        // React
+        "jsx": "react-jsx",
+        "jsxImportSource": "preact",
+
+        "strictPropertyInitialization": true,
+        "strictNullChecks": true,
+        
+        "rootDir": "./",
+        "baseUrl": "./",
+        "paths": {
+            
+            "@client/*": ["./client/*"],
+            "@common/*": ["./common/*"],
+            "@server/*": ["./server/*"],
+
+            "react": ["preact/compat"],
+            "react-dom": ["preact/compat"],
+            "react/jsx-runtime": ["preact/jsx-runtime"]
+        },
+    },
+    "include": ["."],
+    "exclude": ["cli"]
+}

package/tsconfig.json

@@ -0,0 +1,3 @@
+{
+    "extends": "./tsconfig.common.json"
+}

package/types/aliases.d.ts

@@ -0,0 +1,54 @@
+declare module "@/client/pages/\*\*/_layout/index.tsx" {
+    const Layout: import("../common/router/layouts").ImportedLayouts;
+    export = LayoutsList
+}
+
+declare module "@/client/pages/\*.tsx" {
+    const value: import("../client/services/router").TRoutesLoaders;
+    export = value;
+}
+
+declare module "@/server/services/auth" {
+    const UserAuthService: import("../../server/services/auth/base").default;
+    export = UserAuthService;
+}
+
+declare module "@/server" {
+    const ServerApplicationClass: import("../server/app").default;
+    export = InstanceType<ServerApplicationClass>;
+}
+
+declare module "@/client" {
+    const ClientApplicationClass: import("../client/app").default;
+    export = InstanceType<ClientApplicationClass>;
+}
+
+declare module "@/client/context" {
+
+    const Test: true;
+
+    const ClientRouter: import('../client/services/router').default;
+    const ServerRouter: import('../server/services/router').default;
+
+    type TServerRouterRequestContext = import('../server/services/router/response').TRouterContext;
+    type TClientRouterRequestContext = import('../client/services/router/response').TRouterContext;
+
+    export type ClientContext = (
+        // TO Fix: TClientRouterRequestContext is unable to get the right type of CrossPathClient["router"]
+        //    (it gets ClientApplication instead of CrossPathClient)
+        TClientRouterRequestContext<ClientRouter, ClientRouter["app"]>
+        | 
+        TServerRouterRequestContext<ServerRouter>
+    )
+
+    export const ReactClientContext: preact.Context<ClientContext>;
+
+    const useContext: () => ClientContext;
+
+    export default useContext;
+}
+
+declare module "@app" {
+    const ServerApplicationClass: import("../server/app").default;
+    export = ServerApplicationClass;
+}

package/types/global/modules.d.ts

@@ -0,0 +1,49 @@
+/*----------------------------------
+- CONTENU TRANSFORMÉ
+----------------------------------*/
+
+// Contenu brut + métadonnées
+declare module "*.sql" {
+    const value: String & { 
+        id: string,
+        sourcefile: string
+    };
+    export = value;
+}
+
+// Contenu brut + métadonnées
+declare module "*.json" {
+    const value: any;
+    export = value;
+}
+
+/*----------------------------------
+- CONTENU BRUT
+----------------------------------*/
+
+// Contenu brut
+declare module "*.md" {
+    const value: string;
+    export = value;
+}
+
+/*----------------------------------
+- ASSETS: CHEMIN PUBLIC
+----------------------------------*/
+
+declare module "*.svg" {
+    const value: string;
+    export = value;
+}
+
+declare module "*.png";
+declare module "*.jpg";
+declare module "*.jpeg";
+declare module "*.webp";
+declare module "*.gif";
+declare module "*.bmp";
+
+declare module "*.mp3" {
+    const value: string;
+    export = value;
+}

package/types/global/utils.d.ts

@@ -0,0 +1,103 @@
+declare type TObjetDonnees = {[cle: string]: any}
+
+// Rend certaines clés d'un objet obligatoires
+declare type With<
+    TObject,
+    TRequired extends (keyof TObject) | {[key in keyof TObject]?: any},
+    TAdditionnal extends {[key: string]: any} = {}
+> = (
+    Omit<TObject, TRequired extends (keyof TObject) ? TRequired : keyof TRequired> 
+    & 
+    (TRequired extends (keyof TObject) ? Required<Pick<TObject, TRequired>> : TRequired)
+    &
+    TAdditionnal
+)
+
+declare type NonNullFields<T, K extends keyof T> = Omit<T, K> & {
+    [P in K]: NonNullable<T[P]>;
+};
+
+declare type ValueOf<T> = T[keyof T];
+
+// Extrait la valeur de retour d'une promise
+// https://stackoverflow.com/questions/48011353/how-to-unwrap-type-of-a-promise
+declare type ThenArg<T> = T extends PromiseLike<infer U> ? U : T
+
+declare type TPagination<TElement> = {
+    list: TElement[],
+    page: number,
+    pages: number,
+    total: number
+}
+
+// https://stackoverflow.com/questions/39392853/is-there-a-type-for-class-in-typescript-and-does-any-include-it
+declare interface ClassType<T> extends Function { new(): T; }
+
+declare type TPagination<T> = {
+    docs: Array<T>;
+    pages: number;
+    total: number;
+}
+
+declare type TStats<T> = {
+    [time: number]: T
+}
+
+/*declare namespace JSX {
+    interface IntrinsicElements {
+        i: { src: TIcons } & React.HTMLAttributes<HTMLElement>;
+    }
+}*/
+
+declare type Routes = {
+    [path: string]: {
+        params: {
+            [param: string]: any
+        }
+    }
+}
+
+declare type PrimitiveValue = string | number | boolean;
+
+/*----------------------------------
+- COPY FROM CLI/APP/INDEX.TS
+----------------------------------*/
+
+/*type TEnvConfig = {
+    name: 'local' | 'server',
+    profile: 'dev' | 'testing' | 'prod',
+    
+    router: {
+        port: number,
+        domains: TDomainsList
+    },
+    database: {
+        name: string,
+        databases: string[],
+        host: string,
+        port: number,
+        login: string,
+        password: string,
+    },
+    console: {
+        enable: boolean,
+        debug: boolean,
+        bufferLimit: number,
+        level: TLogProfile,
+    },
+}*/
+
+type TServiceSetup = {
+    id: string,
+    name: string,
+    config: {},
+    subservices: TServiceSubservices
+}
+
+type TServiceRef = {
+    refTo: string
+}
+
+type TServiceSubservices = {
+    [key: string]: TServiceSetup | TServiceRef
+}

package/types/icons.d.ts

@@ -0,0 +1 @@
+export type TIcones = "solid/spinner-third"|"info-circle"|"check-circle"|"exclamation-circle"|"times-circle"|"times"|"clock"|"stars"|"crosshairs"|"radar"|"chart-line"|"home"|"search"|"user"|"chart-bar"|"columns"|"globe"|"bookmark"|"tag"|"angle-down"|"check"|"meh-rolling-eyes"|"arrow-left"|"arrow-right"|"eye"|"trash"|"sparkles"|"unlink"|"pen"|"link"|"file"|"bold"|"italic"|"underline"|"strikethrough"|"subscript"|"superscript"|"code"|"plus"|"font"|"empty-set"|"plus-circle"|"horizontal-rule"|"page-break"|"image"|"table"|"poll"|"sticky-note"|"caret-right"|"list-ul"|"check-square"|"h1"|"h2"|"h3"|"h4"|"list-ol"|"paragraph"|"quote-left"|"align-left"|"align-center"|"align-right"|"align-justify"|"indent"|"outdent"