proteum 1.0.2 → 2.0.0-1

package/server/utils/slug.ts

@@ -7,73 +7,67 @@ import escapeStringRegexp from 'escape-regexp';
 import slugify from 'slugify';
 import { removeStopwords, eng } from 'stopword';
 
-// Core
-import type SQL from "@server/services/database";
-
 /*----------------------------------
 - TYPES
 ----------------------------------*/
 
+type TSlugSqlClient = {
+    esc?: (value: unknown) => string;
+    selectVal?: <TValue = number>(query: string) => Promise<TValue | null>;
+};
+
 /*----------------------------------
 - 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
+    public async generate(label: string): Promise<string>;
+    public async generate(label: string, sql: TSlugSqlClient, table: string, column: string): Promise<string>;
+    public async generate(
+        label: string,
+        sql?: TSlugSqlClient,
+        table?: string,
+        column?: string,
+    ): Promise<string> {
         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`
+            replacement: '-',
+            remove: /[^a-z\s]/gi,
+            lower: true,
+            strict: true,
+            locale: 'vi',
+            trim: true,
         });
 
-        slug = removeStopwords( slug.split('-'), eng).join('-');
+        slug = removeStopwords(slug.split('-'), eng).join('-');
 
-        // Check if already existing
-        if (SQL !== undefined) {
-            slug = await this.Correct(slug, SQL, table, column);
-        }
+        if (sql && table && column) slug = await this.Correct(slug, sql, table, column);
 
         return slug;
     }
 
-    public async Correct( 
-        slug: string, 
-        SQL: SQL, 
-        table: string, 
-        column: string 
-    ) {
-        
+    public async Correct(slug: string, sql: TSlugSqlClient, table: string, column: string): Promise<string> {
+        if (!sql.esc || !sql.selectVal) return slug;
+
         const escapedSlug = escapeStringRegexp(slug);
 
-        const duplicates = await SQL.selectVal<number>(`
+        const duplicates = await sql.selectVal<number>(`
             SELECT 
-                IF( ${column} LIKE ${SQL.esc(slug)},
+                IF( ${column} LIKE ${sql.esc(slug)},
                     1,
                     CAST(SUBSTRING_INDEX(slug, '-', -1) AS UNSIGNED)
                 ) AS duplicates
             FROM ${table} 
             WHERE 
-                ${column} LIKE ${SQL.esc(slug)}
+                ${column} LIKE ${sql.esc(slug)}
                 OR
                 ${column} REGEXP '^${escapedSlug}-[0-9]+$'
             ORDER BY duplicates DESC
             LIMIT 1
         `);
 
-        if (duplicates && duplicates > 0)
-            slug += `-${duplicates + 1}`;
+        if (duplicates && duplicates > 0) slug += `-${duplicates + 1}`;
 
         return slug;
-
     }
-
 }
 
-export default new Slug;
+export default new Slug();

package/skills/clean-project-code/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: clean-project-code
+description: Conservative codebase cleanup for existing projects. Use when Codex is asked to remove dead code, run Prettier, and align touched files with repository style rules without changing behavior or public APIs. Trigger for requests such as "clean this repo", "remove unused code", "format touched files", "apply CODING_STYLE.md", or "do a safe cleanup pass".
+---
+
+# Clean Project Code
+
+Read the repository instructions first. Prefer `AGENTS.md`, the nearest relevant `CODING_STYLE.md`, and the active Prettier config before making changes.
+
+Keep the cleanup conservative. Delete only code that is clearly unused and safe to remove. When safety is ambiguous, leave the code in place and report it as a cleanup candidate.
+
+## Workflow
+
+1. Read repo rules.
+Locate and read `AGENTS.md`, `CODING_STYLE.md`, and `prettier.config.*` or `.prettierrc*` before editing. If the user names an exact path, use that file as the source of truth.
+
+2. Define safe scope.
+Do not change behavior or public APIs. Do not rewrite large areas only for style. Do not edit generated files unless you also update the source that generates them.
+
+3. Identify provably safe cleanup targets.
+Prefer removing:
+- unused imports
+- unused local variables and private helpers
+- unused types and interfaces
+- unreachable branches
+- obsolete files that are provably unreferenced
+- compatibility shims or dead helpers that have no live call sites
+
+4. Prove before deleting.
+Use fast search tools such as `rg` to verify references. Check exports, dynamic imports, generated references, route registration, configuration wiring, and framework conventions before deleting a file or symbol.
+
+5. Keep uncertain cases.
+If code looks unused but safety is not clear, keep it and report it separately. Favor false negatives over unsafe deletions.
+
+6. Apply style only on touched files.
+Follow the repository coding style for files you change. Run Prettier with the repo config, preferably on touched files only unless the user explicitly asks for repo-wide formatting.
+
+7. Verify.
+Run the smallest relevant verification available after edits. Prefer project-native checks. If no suitable automated verification exists, say so explicitly.
+
+## Deletion Rules
+
+- Delete only when the code is clearly unused and the removal does not alter runtime behavior.
+- Treat public exports, framework entrypoints, reflective loading, glob-based discovery, and generated references as high-risk unless you can prove they are inactive.
+- Avoid opportunistic refactors. Keep the diff reviewable.
+- If a cleanup requires structural redesign to become safe, stop at reporting the issue unless the user explicitly asked for refactoring.
+
+## Final Report
+
+Always report:
+- what was removed
+- what was intentionally left unchanged because it was uncertain
+- what verification was run
+- what could not be verified automatically
+
+## Default Response Shape
+
+When the user provides a cleanup brief, turn it into an execution checklist before editing:
+- instructions read
+- safe deletion targets identified
+- risky candidates deferred
+- formatting scope confirmed
+- verification plan chosen

package/skills/clean-project-code/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Clean Project Code"
+  short_description: "Conservative repo cleanup workflow"
+  default_prompt: "Use $clean-project-code to clean this project conservatively without changing behavior."

package/tsconfig.common.json

@@ -8,6 +8,10 @@
         "skipLibCheck": true,
         "allowJs": true,
         "strict": false,
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictBindCallApply": true,
+        "useUnknownInCatchVariables": true,
         "downlevelIteration": true,
         // Force case sensitive import filenames on Window and Mac
         // https://briandesousa.net/?p=870 
@@ -15,9 +19,6 @@
 
         // Equivalent webpack: resolve.symblinks = false
         "preserveSymlinks": true,
-        // Décorateurs
-        "experimentalDecorators": true,
-
         "inlineSourceMap": true,
 
         // React

package/tsconfig.json

@@ -1,3 +1,6 @@
 {
-    "extends": "./tsconfig.common.json"
+    "extends": "./tsconfig.common.json",
+    "compilerOptions": {
+        "noEmit": true
+    }
 }

package/types/aliases.d.ts

@@ -1,30 +1,29 @@
-declare module "@/client/pages/\*\*/_layout/index.tsx" {
-    const Layout: import("../common/router/layouts").ImportedLayouts;
-    export = LayoutsList
+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;
+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;
+declare module '@/server/services/auth' {
+    const UserAuthService: import('../../server/services/auth/base').default;
     export = UserAuthService;
 }
 
-declare module "@/server" {
-    const ServerApplicationClass: import("../server/app").default;
+declare module '@/server' {
+    const ServerApplicationClass: import('../server/app').default;
     export = InstanceType<ServerApplicationClass>;
 }
 
-declare module "@/client" {
-    const ClientApplicationClass: import("../client/app").default;
+declare module '@/client' {
+    const ClientApplicationClass: import('../client/app').default;
     export = InstanceType<ClientApplicationClass>;
 }
 
-declare module "@/client/context" {
-
+declare module '@/client/context' {
     const Test: true;
 
     const ClientRouter: import('../client/services/router').default;
@@ -33,13 +32,10 @@ declare module "@/client/context" {
     type TServerRouterRequestContext = import('../server/services/router/response').TRouterContext;
     type TClientRouterRequestContext = import('../client/services/router/response').TRouterContext;
 
-    export type ClientContext = (
+    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>
-    )
+        TClientRouterRequestContext<ClientRouter, ClientRouter['app']> | TServerRouterRequestContext<ServerRouter>;
 
     export const ReactClientContext: preact.Context<ClientContext>;
 
@@ -48,7 +44,7 @@ declare module "@/client/context" {
     export default useContext;
 }
 
-declare module "@app" {
-    const ServerApplicationClass: import("../server/app").default;
+declare module '@app' {
+    const ServerApplicationClass: import('../server/app').default;
     export = ServerApplicationClass;
-}
+}

package/types/controller-input.test.ts

@@ -0,0 +1,48 @@
+import Controller, { schema } from '@server/app/controller';
+
+type Assert<T extends true> = T;
+
+type Equals<TLeft, TRight> = (<T>() => T extends TLeft ? 1 : 2) extends <T>() => T extends TRight ? 1 : 2
+    ? (<T>() => T extends TRight ? 1 : 2) extends <T>() => T extends TLeft ? 1 : 2
+        ? true
+        : false
+    : false;
+
+class InputInferenceController extends Controller {
+    public fromShape() {
+        return this.input({
+            name: schema.string(),
+            age: schema.number().optional(),
+        });
+    }
+
+    public fromSchema() {
+        return this.input(
+            schema.object({
+                slug: schema.string(),
+            }),
+        );
+    }
+}
+
+type TFromShape = ReturnType<InputInferenceController['fromShape']>;
+type TFromSchema = ReturnType<InputInferenceController['fromSchema']>;
+
+type _AssertShapeInference = Assert<
+    Equals<
+        TFromShape,
+        {
+            name: string;
+            age?: number | undefined;
+        }
+    >
+>;
+
+type _AssertSchemaInference = Assert<
+    Equals<
+        TFromSchema,
+        {
+            slug: string;
+        }
+    >
+>;

package/types/express-extra.d.ts

@@ -0,0 +1,6 @@
+declare namespace Express {
+    interface Request {
+        rawBody?: Buffer;
+        files?: Record<string, any>;
+    }
+}

package/types/global/constants.d.ts

@@ -0,0 +1,13 @@
+declare const __DEV__: boolean;
+declare const SERVER: boolean;
+
+declare const CORE_VERSION: string;
+declare const CORE_PATH: string;
+
+declare const BUILD_DATE: string;
+declare const BUILD_ID: number;
+
+declare const APP_PATH: string;
+declare const APP_NAME: string;
+declare const APP_OUTPUT_DIR: string;
+declare const PROTEUM_DEV_EVENT_PORT: number | null;

package/types/global/express-extra.d.ts

@@ -0,0 +1,6 @@
+declare namespace Express {
+    interface Request {
+        rawBody?: Buffer;
+        files?: Record<string, any>;
+    }
+}

package/types/global/modules.d.ts

@@ -3,16 +3,13 @@
 ----------------------------------*/
 
 // Contenu brut + métadonnées
-declare module "*.sql" {
-    const value: String & { 
-        id: string,
-        sourcefile: string
-    };
+declare module '*.sql' {
+    const value: String & { id: string; sourcefile: string };
     export = value;
 }
 
 // Contenu brut + métadonnées
-declare module "*.json" {
+declare module '*.json' {
     const value: any;
     export = value;
 }
@@ -22,7 +19,7 @@ declare module "*.json" {
 ----------------------------------*/
 
 // Contenu brut
-declare module "*.md" {
+declare module '*.md' {
     const value: string;
     export = value;
 }
@@ -31,19 +28,19 @@ declare module "*.md" {
 - ASSETS: CHEMIN PUBLIC
 ----------------------------------*/
 
-declare module "*.svg" {
+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 '*.png';
+declare module '*.jpg';
+declare module '*.jpeg';
+declare module '*.webp';
+declare module '*.gif';
+declare module '*.bmp';
 
-declare module "*.mp3" {
+declare module '*.mp3' {
     const value: string;
     export = value;
-}
+}

package/types/global/utils.d.ts

@@ -1,47 +1,30 @@
-declare type TObjetDonnees = {[cle: string]: any}
+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]>;
-};
+    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 ThenArg<T> = T extends PromiseLike<infer U> ? U : T;
 
-declare type TPagination<TElement> = {
-    list: TElement[],
-    page: number,
-    pages: number,
-    total: number
-}
+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 ClassType<T> = abstract new (...args: any[]) => T;
 
-declare type TPagination<T> = {
-    docs: Array<T>;
-    pages: number;
-    total: number;
-}
+declare type TPagination<T> = { docs: Array<T>; pages: number; total: number };
 
-declare type TStats<T> = {
-    [time: number]: T
-}
+declare type TStats<T> = { [time: number]: T };
 
 /*declare namespace JSX {
     interface IntrinsicElements {
@@ -49,13 +32,7 @@ declare type TStats<T> = {
     }
 }*/
 
-declare type Routes = {
-    [path: string]: {
-        params: {
-            [param: string]: any
-        }
-    }
-}
+declare type Routes = { [path: string]: { params: { [param: string]: any } } };
 
 declare type PrimitiveValue = string | number | boolean;
 
@@ -87,17 +64,8 @@ declare type PrimitiveValue = string | number | boolean;
     },
 }*/
 
-type TServiceSetup = {
-    id: string,
-    name: string,
-    config: {},
-    subservices: TServiceSubservices
-}
+type TServiceSetup = { id: string; name: string; config: {}; subservices: TServiceSubservices };
 
-type TServiceRef = {
-    refTo: string
-}
+type TServiceRef = { refTo: string };
 
-type TServiceSubservices = {
-    [key: string]: TServiceSetup | TServiceRef
-}
+type TServiceSubservices = { [key: string]: TServiceSetup | TServiceRef };

package/types/global/vendors.d.ts

@@ -0,0 +1,62 @@
+declare module 'accepts' {
+    const accepts: any;
+    export default accepts;
+}
+
+declare module 'bytes' {
+    const bytes: (value: string | number) => number;
+    export default bytes;
+}
+
+declare module 'compression' {
+    const compression: any;
+    export default compression;
+}
+
+declare module 'cookie-parser' {
+    const cookieParser: any;
+    export default cookieParser;
+}
+
+declare module 'cors' {
+    export type CorsOptions = any;
+    const cors: any;
+    export default cors;
+}
+
+declare module 'escape-html' {
+    export default function escapeHtml(value: string): string;
+}
+
+declare module 'escape-regexp' {
+    export default function escapeRegexp(value: string): string;
+}
+
+declare module 'express-fileupload' {
+    const fileUpload: any;
+    export default fileUpload;
+}
+
+declare module 'hpp' {
+    const hpp: any;
+    export default hpp;
+}
+
+declare module 'jsonwebtoken' {
+    const jwt: any;
+    export default jwt;
+}
+
+declare module 'md5' {
+    export default function md5(value: string): string;
+}
+
+declare module 'morgan' {
+    const morgan: any;
+    export default morgan;
+}
+
+declare module 'stopword' {
+    export const eng: string[];
+    export function removeStopwords(words: string[], stopwords?: string[]): string[];
+}

package/types/icons.d.ts

@@ -1 +1,65 @@
-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"
+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';

package/types/uuid.d.ts

@@ -0,0 +1,3 @@
+declare module 'uuid' {
+    export function v4(): string;
+}