xypriss-swagger 1.0.12 → 1.0.14

package/README.md

@@ -16,17 +16,26 @@ This module is designed to be loaded natively by the XyPriss plugin manager. Ens
 {
     "$internal": {
         "xypriss-swagger": {
+            "type": "plugin",
             "__meta__": {
-                "path": "CWD://node_modules/xypriss-swagger"
+                "path": "ROOT://",
             },
             "__xfs__": {
-                "path": "CWD://."
-            }
-        }
-    }
+                "path": "CWD://",
+            },
+            "permissions": {
+                "allowedHooks": ["PLG.OPS.AUXILIARY_SERVER", "PLG.SECURITY.ACCESS_CONFIGS"],
+                "policy": "allow",
+            },
+        },
+    },
 }
+
 ```
 
+> [!NOTE]
+> For a deep dive into how XyPriss manages plugin isolation and filesystem access, see the [Workspace System Guide](../core/WORKSPACE_SYSTEM.md).
+
 ## Security & Permissions
 
 In order to properly analyze your project's codebase and generate accurate Swagger documentation, this plugin requires the `CWD://` (Current Working Directory) context permission.

package/dist/cjs/configs/meta.js

@@ -1,2 +1,2 @@
-"use strict";require("xypriss");const s=__sys__?.__root__||process.cwd(),_=__sys__.fs.readJsonSync(__sys__.fs.join(s,"package.json"));exports.meta=_,exports.toPascalCase=(s,_="-")=>s.split(_).map(s=>s[0].toUpperCase()+s.slice(1)).join(" ");
+"use strict";const s=__sys__.__root__,_=__sys__.fs.readJsonSync(__sys__.fs.join(s,"package.json"));exports.meta=_,exports.toPascalCase=(s,_="-")=>s.split(_).map(s=>s[0].toUpperCase()+s.slice(1)).join(" ");
 //# sourceMappingURL=meta.js.map

package/dist/cjs/configs/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sources":["../../../../../src/configs/meta.ts"],"sourcesContent":["import \"xypriss\";\nimport { ISwaggerJSONStructure } from \"../types\";\n\n// console.log(\"[PLUGIN:META] 🥸 la 'root' du plugin: \", __sys__?.__root__);\n\nconst root = __sys__?.__root__ || process.cwd();\n\nexport const meta = __sys__.fs.readJsonSync(\n    __sys__.fs.join(root, \"package.json\"),\n) as ISwaggerJSONStructure;\n\nexport const toPascalCase = (str: string, spliter = \"-\") =>\n    str\n        .split(spliter)\n        .map((n) => n[0].toUpperCase() + n.slice(1))\n        .join(\" \");\n"],"names":["root","__sys__","__root__","process","cwd","meta","fs","readJsonSync","join","str","spliter","split","map","n","toUpperCase","slice"],"mappings":"gCAKA,MAAMA,EAAOC,SAASC,UAAYC,QAAQC,MAE7BC,EAAOJ,QAAQK,GAAGC,aAC3BN,QAAQK,GAAGE,KAAKR,EAAM,qDAGE,CAACS,EAAaC,EAAU,MAChDD,EACKE,MAAMD,GACNE,IAAKC,GAAMA,EAAE,GAAGC,cAAgBD,EAAEE,MAAM,IACxCP,KAAK"}
+{"version":3,"file":"meta.js","sources":["../../../../../src/configs/meta.ts"],"sourcesContent":["import { ISwaggerJSONStructure } from \"../types\";\n\n// console.log(\"[PLUGIN:META] 🥸 la 'root' du plugin: \", __sys__?.__root__);\n\nconst root = __sys__.__root__;\n\nexport const meta = __sys__.fs.readJsonSync(\n    __sys__.fs.join(root, \"package.json\"),\n) as ISwaggerJSONStructure;\n\nexport const toPascalCase = (str: string, spliter = \"-\") =>\n    str\n        .split(spliter)\n        .map((n) => n[0].toUpperCase() + n.slice(1))\n        .join(\" \");\n\n"],"names":["root","__sys__","__root__","meta","fs","readJsonSync","join","str","spliter","split","map","n","toUpperCase","slice"],"mappings":"aAIA,MAAMA,EAAOC,QAAQC,SAERC,EAAOF,QAAQG,GAAGC,aAC3BJ,QAAQG,GAAGE,KAAKN,EAAM,qDAGE,CAACO,EAAaC,EAAU,MAChDD,EACKE,MAAMD,GACNE,IAAKC,GAAMA,EAAE,GAAGC,cAAgBD,EAAEE,MAAM,IACxCP,KAAK"}

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/index.ts"],"sourcesContent":["import { logger, Logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { SwaggerServer } from \"./server\";\nimport { SwaggerConfig } from \"./types\";\nimport { Plugin } from \"xypriss\";\n\n// console.log(\"[swagger] internal plugin sys\", __sys__.__root__);\n\nconst pluginName = toPascalCase(meta.name);\nexport function SwaggerPlugin(config: SwaggerConfig): any {\n    return Plugin.create(\n        {\n            name: meta.name,\n            version: meta.version,\n            description: meta.description,\n\n            onRegister(_error) {\n                const log = Logger.for(\"Bootstrap\");\n                log.info(\"Starting swagger plugin...\");\n                if (_error) {\n                    log.error(pluginName + \" plugin failed to start:\", _error);\n                }\n            },\n            onServerStart(server) {\n                logger.success(pluginName + \" plugin has started\");\n\n                server.app.get(\"/swagger\", (_req: any, res: any) => {\n                    res.redirect(`http://localhost:${config.port}`);\n                });\n            },\n            onAuxiliaryServerDeploy(ops, server) {\n                SwaggerServer(config, ops, server);\n            },\n        },\n        __sys__.__root__,\n    );\n}\n\n"],"names":["pluginName","toPascalCase","meta","name","config","Plugin","create","version","description","onRegister","_error","log","Logger","for","info","error","onServerStart","server","logger","success","app","get","_req","res","redirect","port","onAuxiliaryServerDeploy","ops","SwaggerServer","__sys__","__root__"],"mappings":"+HAQA,MAAMA,EAAaC,EAAAA,aAAaC,EAAAA,KAAKC,4BAC/B,SAAwBC,GAC1B,OAAOC,EAAAA,OAAOC,OACV,CACIH,KAAMD,EAAAA,KAAKC,KACXI,QAASL,EAAAA,KAAKK,QACdC,YAAaN,EAAAA,KAAKM,YAElB,UAAAC,CAAWC,GACP,MAAMC,EAAMC,EAAAA,OAAOC,IAAI,aACvBF,EAAIG,KAAK,8BACLJ,GACAC,EAAII,MAAMf,EAAa,2BAA4BU,EAE3D,EACA,aAAAM,CAAcC,GACVC,SAAOC,QAAQnB,EAAa,uBAE5BiB,EAAOG,IAAIC,IAAI,WAAY,CAACC,EAAWC,KACnCA,EAAIC,SAAS,oBAAoBpB,EAAOqB,SAEhD,EACA,uBAAAC,CAAwBC,EAAKV,GACzBW,EAAAA,cAAcxB,EAAQuB,EAC1B,GAEJE,QAAQC,SAEhB"}
+{"version":3,"file":"index.js","sources":["../../../../src/index.ts"],"sourcesContent":["import { logger, Logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { SwaggerServer } from \"./server\";\nimport { SwaggerConfig } from \"./types\";\nimport { Plugin } from \"xypriss\";\n\nconst pluginName = toPascalCase(meta.name);\nexport function SwaggerPlugin(config: SwaggerConfig) {\n    return Plugin.create(\n        {\n            name: meta.name,\n            version: meta.version,\n            description: meta.description,\n            onRegister(_error) {\n                const log = Logger.for(\"Bootstrap\");\n                log.info(\"Starting swagger plugin...\");\n                if (_error) {\n                    log.error(pluginName + \" plugin failed to start:\", _error);\n                }\n            },\n            onServerStart(server) {\n                logger.success(pluginName + \" plugin has started\");\n\n                server.app.get(\"/swagger\", (_req: any, res: any) => {\n                    res.redirect(`http://localhost:${config.port}`);\n                });\n            },\n            onAuxiliaryServerDeploy(ops, server) {\n                SwaggerServer(config, ops, server);\n            },\n        }, \n        __sys__.__root__,\n    );\n}\n\n"],"names":["pluginName","toPascalCase","meta","name","config","Plugin","create","version","description","onRegister","_error","log","Logger","for","info","error","onServerStart","server","logger","success","app","get","_req","res","redirect","port","onAuxiliaryServerDeploy","ops","SwaggerServer","__sys__","__root__"],"mappings":"+HAMA,MAAMA,EAAaC,EAAAA,aAAaC,EAAAA,KAAKC,4BAC/B,SAAwBC,GAC1B,OAAOC,EAAAA,OAAOC,OACV,CACIH,KAAMD,EAAAA,KAAKC,KACXI,QAASL,EAAAA,KAAKK,QACdC,YAAaN,EAAAA,KAAKM,YAClB,UAAAC,CAAWC,GACP,MAAMC,EAAMC,EAAAA,OAAOC,IAAI,aACvBF,EAAIG,KAAK,8BACLJ,GACAC,EAAII,MAAMf,EAAa,2BAA4BU,EAE3D,EACA,aAAAM,CAAcC,GACVC,SAAOC,QAAQnB,EAAa,uBAE5BiB,EAAOG,IAAIC,IAAI,WAAY,CAACC,EAAWC,KACnCA,EAAIC,SAAS,oBAAoBpB,EAAOqB,SAEhD,EACA,uBAAAC,CAAwBC,EAAKV,GACzBW,EAAAA,cAAcxB,EAAQuB,EAC1B,GAEJE,QAAQC,SAEhB"}

package/dist/cjs/server.js

@@ -1,2 +1,2 @@
-"use strict";var e=require("./configs/Logger.js"),t=require("./configs/meta.js"),r=require("./openapi.js"),o=require("./ui.js");exports.SwaggerServer=function(s,a,n){const g=s.path||"/docs",i=`${g}/swagger.json`,c=__sys__.plugins.get(t.meta.name);if(!c)throw new Error(t.toPascalCase(t.meta.name,"-")+" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add ");const p=s.port||7070,u=a.createAuxiliaryServer({server:{port:p},security:{enabled:!1}});u.get(i,(t,o)=>{try{let e=[];a.getRouteRegistry&&(e=a.getRouteRegistry());const t=r.generateOpenAPI(e,s);o.json(t)}catch(t){e.logger.error("Error generating OpenAPI spec:",t),o.status(500).json({error:"Failed to generate documentation"})}}),u.get(g,(e,t)=>{const r=s.title||c?.vars?.__name__||"API Documentation",a=o.getSwaggerUIStream(i,r);t.setHeader("Content-Type","text/html"),a.pipe(t)}),u.redirect("/",g,301);const l=`http://localhost:${p}${g}`;u.start(()=>{e.logger.swagger(`${t.toPascalCase(t.meta.name)} Server isolated on port ${p}`),e.logger.http(`GET ${l}`)})};
+"use strict";var e=require("./configs/Logger.js"),o=require("./configs/meta.js"),t=require("./openapi.js"),r=require("./ui.js");exports.SwaggerServer=function(s,n,i){const a=s.path||"/docs",_=`${a}/swagger.json`;console.log("plugin root path: ",__sys__.__root__),console.log("😇 env de HELLO depuis le plugin: ",__sys__.__env__.get("HELLO")),console.log("🤧 env de COMMON_VAR du root du project (devrait être undefined): ",__sys__.__env__.get("COMMON_VAR")),console.log("🤠 env from root using __sys__ (devrait être strictement undefined vue que ici, sys.__root__ devrait conduire vers '/home/idevo/Documents/projects/XyPriss/mods/swagger') pourtant le .env de cette root n'a pas de name: ",__sys__.__env__.get("NAME"));const g=__sys__.plugins.get(o.meta.name);if(!g)throw new Error(o.toPascalCase(o.meta.name,"-")+" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add ");console.log("🤠 env from root using workspaceSYS (devrait être undefined selon la config de l'utilisateur: en mode ROOT:// ça devrait conduire vers _sys__.root ('/home/idevo/Documents/projects/XyPriss/mods/swagger') et CWD:// devrait envoyer process.cwd() ('/home/idevo/Documents/projects/XyPriss' (vue qu'on excute la cmd ici))): ",g.__env__.get("NAME")),console.log("😝 root path: ",g.__root__),console.log("😅 listing directory path: ",g.fs.ls("."));const c=s.port||7070,d=n.createAuxiliaryServer({server:{port:c},security:{enabled:!1}});d.get(_,(o,r)=>{try{let e=[];n.getRouteRegistry&&(e=n.getRouteRegistry());const o=t.generateOpenAPI(e,s);r.json(o)}catch(o){e.logger.error("Error generating OpenAPI spec:",o),r.status(500).json({error:"Failed to generate documentation"})}}),d.get(a,(e,o)=>{const t=s.title||g?.vars?.__name__||"API Documentation",n=r.getSwaggerUIStream(_,t);o.setHeader("Content-Type","text/html"),n.pipe(o)}),d.redirect("/",a,301);const l=`http://localhost:${c}${a}`;d.start(()=>{e.logger.swagger(`${o.toPascalCase(o.meta.name)} Server isolated on port ${c}`),e.logger.http(`GET ${l}`)})};
 //# sourceMappingURL=server.js.map

package/dist/cjs/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sources":["../../../../src/server.ts"],"sourcesContent":["import { logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { generateOpenAPI } from \"./openapi\";\nimport { SwaggerConfig } from \"./types\";\nimport { getSwaggerUIStream } from \"./ui\";\nimport { Plugin } from \"xypriss\";\n \ntype auxis = NonNullable<\n    ReturnType<typeof Plugin.create>[\"onAuxiliaryServerDeploy\"]\n>;\nexport type OpsServerManager = Parameters<auxis>[\"0\"] & {\n    getRouteRegistry?: () => any[];\n};\n\nexport type XyPrissServer = Parameters<auxis>[\"1\"];\n\nexport function SwaggerServer(\n    config: SwaggerConfig,\n    ops: OpsServerManager,\n    _XServer: XyPrissServer,\n) {\n    const docPath = config.path || \"/docs\";\n    const specPath = `${docPath}/swagger.json`;\n    const workspaceSYS = __sys__.plugins.get(meta.name);\n\n    if (!workspaceSYS) {\n        throw new Error(\n            toPascalCase(meta.name, \"-\") +\n                \" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add \",\n        );\n    }\n    const port = config.port || 7070;\n    const server = ops.createAuxiliaryServer({\n        server: { port },\n        security: {\n            enabled: false,\n        },\n    });\n\n    // Serve the raw OpenAPI JSON specification\n    server.get(specPath, (_req, res) => {\n        try {\n            let registry: any[] = [];\n\n            if (ops.getRouteRegistry) {\n                registry = ops.getRouteRegistry();\n            }\n\n            const spec = generateOpenAPI(registry, config);\n            res.json(spec);\n        } catch (error) {\n            logger.error(\"Error generating OpenAPI spec:\", error);\n            res.status(500).json({\n                error: \"Failed to generate documentation\",\n            });\n        }\n    });\n\n    // Serve the Swagger HTML Viewer\n    server.get(docPath, (_req, res) => {\n        const title =\n            config.title || workspaceSYS?.vars?.__name__ || \"API Documentation\";\n        const stream = getSwaggerUIStream(specPath, title);\n\n        res.setHeader(\"Content-Type\", \"text/html\");\n        stream.pipe(res);\n    });\n\n    // Redirect root path of the sub-server to docPath\n    server.redirect(\"/\", docPath, 301);\n\n    // Boot the auxiliary server immediately\n    const url = `http://localhost:${port}${docPath}`;\n    server.start(() => {\n        logger.swagger(\n            `${toPascalCase(meta.name)} Server isolated on port ${port}`,\n        );\n        logger.http(`GET ${url}`);\n    });\n}"],"names":["config","ops","_XServer","docPath","path","specPath","workspaceSYS","__sys__","plugins","get","meta","name","Error","toPascalCase","port","server","createAuxiliaryServer","security","enabled","_req","res","registry","getRouteRegistry","spec","generateOpenAPI","json","error","logger","status","title","vars","__name__","stream","getSwaggerUIStream","setHeader","pipe","redirect","url","start","swagger","http"],"mappings":"+JAiBIA,EACAC,EACAC,GAEA,MAAMC,EAAUH,EAAOI,MAAQ,QACzBC,EAAW,GAAGF,iBACdG,EAAeC,QAAQC,QAAQC,IAAIC,EAAAA,KAAKC,MAE9C,IAAKL,EACD,MAAM,IAAIM,MACNC,EAAAA,aAAaH,EAAAA,KAAKC,KAAM,KACpB,uFAGZ,MAAMG,EAAOd,EAAOc,MAAQ,KACtBC,EAASd,EAAIe,sBAAsB,CACrCD,OAAQ,CAAED,QACVG,SAAU,CACNC,SAAS,KAKjBH,EAAON,IAAIJ,EAAU,CAACc,EAAMC,KACxB,IACI,IAAIC,EAAkB,GAElBpB,EAAIqB,mBACJD,EAAWpB,EAAIqB,oBAGnB,MAAMC,EAAOC,EAAAA,gBAAgBH,EAAUrB,GACvCoB,EAAIK,KAAKF,EACb,CAAE,MAAOG,GACLC,SAAOD,MAAM,iCAAkCA,GAC/CN,EAAIQ,OAAO,KAAKH,KAAK,CACjBC,MAAO,oCAEf,IAIJX,EAAON,IAAIN,EAAS,CAACgB,EAAMC,KACvB,MAAMS,EACF7B,EAAO6B,OAASvB,GAAcwB,MAAMC,UAAY,oBAC9CC,EAASC,EAAAA,mBAAmB5B,EAAUwB,GAE5CT,EAAIc,UAAU,eAAgB,aAC9BF,EAAOG,KAAKf,KAIhBL,EAAOqB,SAAS,IAAKjC,EAAS,KAG9B,MAAMkC,EAAM,oBAAoBvB,IAAOX,IACvCY,EAAOuB,MAAM,KACTX,SAAOY,QACH,GAAG1B,eAAaH,EAAAA,KAAKC,iCAAiCG,KAE1Da,EAAAA,OAAOa,KAAK,OAAOH,MAE3B"}
+{"version":3,"file":"server.js","sources":["../../../../src/server.ts"],"sourcesContent":["import { logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { generateOpenAPI } from \"./openapi\";\nimport { SwaggerConfig } from \"./types\";\nimport { getSwaggerUIStream } from \"./ui\";\nimport { Plugin } from \"xypriss\";\n\ntype auxis = NonNullable<\n    ReturnType<typeof Plugin.create>[\"onAuxiliaryServerDeploy\"]\n>;\nexport type OpsServerManager = Parameters<auxis>[\"0\"] & {\n    getRouteRegistry?: () => any[];\n};\n\nexport type XyPrissServer = Parameters<auxis>[\"1\"];\n\nexport function SwaggerServer(\n    config: SwaggerConfig,\n    ops: OpsServerManager,\n    _XServer: XyPrissServer,\n) {\n    const docPath = config.path || \"/docs\";\n    const specPath = `${docPath}/swagger.json`;\n    console.log(\"plugin root path: \", __sys__.__root__);\n\n    console.log(\n        \"😇 env de HELLO depuis le plugin: \",\n        __sys__.__env__.get(\"HELLO\"),\n    );\n    console.log(\n        \"🤧 env de COMMON_VAR du root du project (devrait être undefined): \",\n        __sys__.__env__.get(\"COMMON_VAR\"),\n    );\n\n    console.log(\n        \"🤠 env from root using __sys__ (devrait être strictement undefined vue que ici, sys.__root__ devrait conduire vers '/home/idevo/Documents/projects/XyPriss/mods/swagger') pourtant le .env de cette root n'a pas de name: \",\n        __sys__.__env__.get(\"NAME\"),\n    );\n\n    const workspaceSYS = __sys__.plugins.get(meta.name);\n\n    // console.log(\"workspaceFS: \", workspaceFS);\n\n    if (!workspaceSYS) {\n        throw new Error(\n            toPascalCase(meta.name, \"-\") +\n                \" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add \",\n        );\n    }\n    console.log(\n        \"🤠 env from root using workspaceSYS (devrait être undefined selon la config de l'utilisateur: en mode ROOT:// ça devrait conduire vers _sys__.root ('/home/idevo/Documents/projects/XyPriss/mods/swagger') et CWD:// devrait envoyer process.cwd() ('/home/idevo/Documents/projects/XyPriss' (vue qu'on excute la cmd ici))): \",\n        workspaceSYS.__env__.get(\"NAME\"),\n    );\n    console.log(\"😝 root path: \", workspaceSYS.__root__);\n    console.log(\"😅 listing directory path: \", workspaceSYS.fs.ls(\".\"));\n\n    const port = config.port || 7070;\n    const server = ops.createAuxiliaryServer({\n        server: { port },\n        security: {\n            enabled: false,\n        },\n    });\n\n    // Serve the raw OpenAPI JSON specification\n    server.get(specPath, (_req, res) => {\n        try {\n            let registry: any[] = [];\n\n            if (ops.getRouteRegistry) {\n                registry = ops.getRouteRegistry();\n            }\n\n            const spec = generateOpenAPI(registry, config);\n            res.json(spec);\n        } catch (error) {\n            logger.error(\"Error generating OpenAPI spec:\", error);\n            res.status(500).json({\n                error: \"Failed to generate documentation\",\n            });\n        }\n    });\n\n    // Serve the Swagger HTML Viewer\n    server.get(docPath, (_req, res) => {\n        const title =\n            config.title || workspaceSYS?.vars?.__name__ || \"API Documentation\";\n        const stream = getSwaggerUIStream(specPath, title);\n\n        res.setHeader(\"Content-Type\", \"text/html\");\n        stream.pipe(res);\n    });\n\n    // Redirect root path of the sub-server to docPath\n    server.redirect(\"/\", docPath, 301);\n\n    // Boot the auxiliary server immediately\n    const url = `http://localhost:${port}${docPath}`;\n    server.start(() => {\n        logger.swagger(\n            `${toPascalCase(meta.name)} Server isolated on port ${port}`,\n        );\n        logger.http(`GET ${url}`);\n    });\n}\n"],"names":["config","ops","_XServer","docPath","path","specPath","console","log","__sys__","__root__","__env__","get","workspaceSYS","plugins","meta","name","Error","toPascalCase","fs","ls","port","server","createAuxiliaryServer","security","enabled","_req","res","registry","getRouteRegistry","spec","generateOpenAPI","json","error","logger","status","title","vars","__name__","stream","getSwaggerUIStream","setHeader","pipe","redirect","url","start","swagger","http"],"mappings":"+JAiBIA,EACAC,EACAC,GAEA,MAAMC,EAAUH,EAAOI,MAAQ,QACzBC,EAAW,GAAGF,iBACpBG,QAAQC,IAAI,qBAAsBC,QAAQC,UAE1CH,QAAQC,IACJ,qCACAC,QAAQE,QAAQC,IAAI,UAExBL,QAAQC,IACJ,qEACAC,QAAQE,QAAQC,IAAI,eAGxBL,QAAQC,IACJ,6NACAC,QAAQE,QAAQC,IAAI,SAGxB,MAAMC,EAAeJ,QAAQK,QAAQF,IAAIG,EAAAA,KAAKC,MAI9C,IAAKH,EACD,MAAM,IAAII,MACNC,EAAAA,aAAaH,EAAAA,KAAKC,KAAM,KACpB,uFAGZT,QAAQC,IACJ,iUACAK,EAAaF,QAAQC,IAAI,SAE7BL,QAAQC,IAAI,iBAAkBK,EAAaH,UAC3CH,QAAQC,IAAI,8BAA+BK,EAAaM,GAAGC,GAAG,MAE9D,MAAMC,EAAOpB,EAAOoB,MAAQ,KACtBC,EAASpB,EAAIqB,sBAAsB,CACrCD,OAAQ,CAAED,QACVG,SAAU,CACNC,SAAS,KAKjBH,EAAOV,IAAIN,EAAU,CAACoB,EAAMC,KACxB,IACI,IAAIC,EAAkB,GAElB1B,EAAI2B,mBACJD,EAAW1B,EAAI2B,oBAGnB,MAAMC,EAAOC,EAAAA,gBAAgBH,EAAU3B,GACvC0B,EAAIK,KAAKF,EACb,CAAE,MAAOG,GACLC,SAAOD,MAAM,iCAAkCA,GAC/CN,EAAIQ,OAAO,KAAKH,KAAK,CACjBC,MAAO,oCAEf,IAIJX,EAAOV,IAAIR,EAAS,CAACsB,EAAMC,KACvB,MAAMS,EACFnC,EAAOmC,OAASvB,GAAcwB,MAAMC,UAAY,oBAC9CC,EAASC,EAAAA,mBAAmBlC,EAAU8B,GAE5CT,EAAIc,UAAU,eAAgB,aAC9BF,EAAOG,KAAKf,KAIhBL,EAAOqB,SAAS,IAAKvC,EAAS,KAG9B,MAAMwC,EAAM,oBAAoBvB,IAAOjB,IACvCkB,EAAOuB,MAAM,KACTX,SAAOY,QACH,GAAG5B,eAAaH,EAAAA,KAAKC,iCAAiCK,KAE1Da,EAAAA,OAAOa,KAAK,OAAOH,MAE3B"}

package/dist/esm/configs/meta.js

@@ -1,2 +1,2 @@
-import"xypriss";const s=__sys__?.__root__||process.cwd(),_=__sys__.fs.readJsonSync(__sys__.fs.join(s,"package.json")),o=(s,_="-")=>s.split(_).map(s=>s[0].toUpperCase()+s.slice(1)).join(" ");export{_ as meta,o as toPascalCase};
+const _=__sys__.__root__,s=__sys__.fs.readJsonSync(__sys__.fs.join(_,"package.json")),o=(_,s="-")=>_.split(s).map(_=>_[0].toUpperCase()+_.slice(1)).join(" ");export{s as meta,o as toPascalCase};
 //# sourceMappingURL=meta.js.map

package/dist/esm/configs/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sources":["../../../../../src/configs/meta.ts"],"sourcesContent":["import \"xypriss\";\nimport { ISwaggerJSONStructure } from \"../types\";\n\n// console.log(\"[PLUGIN:META] 🥸 la 'root' du plugin: \", __sys__?.__root__);\n\nconst root = __sys__?.__root__ || process.cwd();\n\nexport const meta = __sys__.fs.readJsonSync(\n    __sys__.fs.join(root, \"package.json\"),\n) as ISwaggerJSONStructure;\n\nexport const toPascalCase = (str: string, spliter = \"-\") =>\n    str\n        .split(spliter)\n        .map((n) => n[0].toUpperCase() + n.slice(1))\n        .join(\" \");\n"],"names":["root","__sys__","__root__","process","cwd","meta","fs","readJsonSync","join","toPascalCase","str","spliter","split","map","n","toUpperCase","slice"],"mappings":"gBAKA,MAAMA,EAAOC,SAASC,UAAYC,QAAQC,MAE7BC,EAAOJ,QAAQK,GAAGC,aAC3BN,QAAQK,GAAGE,KAAKR,EAAM,iBAGbS,EAAe,CAACC,EAAaC,EAAU,MAChDD,EACKE,MAAMD,GACNE,IAAKC,GAAMA,EAAE,GAAGC,cAAgBD,EAAEE,MAAM,IACxCR,KAAK"}
+{"version":3,"file":"meta.js","sources":["../../../../../src/configs/meta.ts"],"sourcesContent":["import { ISwaggerJSONStructure } from \"../types\";\n\n// console.log(\"[PLUGIN:META] 🥸 la 'root' du plugin: \", __sys__?.__root__);\n\nconst root = __sys__.__root__;\n\nexport const meta = __sys__.fs.readJsonSync(\n    __sys__.fs.join(root, \"package.json\"),\n) as ISwaggerJSONStructure;\n\nexport const toPascalCase = (str: string, spliter = \"-\") =>\n    str\n        .split(spliter)\n        .map((n) => n[0].toUpperCase() + n.slice(1))\n        .join(\" \");\n\n"],"names":["root","__sys__","__root__","meta","fs","readJsonSync","join","toPascalCase","str","spliter","split","map","n","toUpperCase","slice"],"mappings":"AAIA,MAAMA,EAAOC,QAAQC,SAERC,EAAOF,QAAQG,GAAGC,aAC3BJ,QAAQG,GAAGE,KAAKN,EAAM,iBAGbO,EAAe,CAACC,EAAaC,EAAU,MAChDD,EACKE,MAAMD,GACNE,IAAKC,GAAMA,EAAE,GAAGC,cAAgBD,EAAEE,MAAM,IACxCR,KAAK"}

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/index.ts"],"sourcesContent":["import { logger, Logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { SwaggerServer } from \"./server\";\nimport { SwaggerConfig } from \"./types\";\nimport { Plugin } from \"xypriss\";\n\n// console.log(\"[swagger] internal plugin sys\", __sys__.__root__);\n\nconst pluginName = toPascalCase(meta.name);\nexport function SwaggerPlugin(config: SwaggerConfig): any {\n    return Plugin.create(\n        {\n            name: meta.name,\n            version: meta.version,\n            description: meta.description,\n\n            onRegister(_error) {\n                const log = Logger.for(\"Bootstrap\");\n                log.info(\"Starting swagger plugin...\");\n                if (_error) {\n                    log.error(pluginName + \" plugin failed to start:\", _error);\n                }\n            },\n            onServerStart(server) {\n                logger.success(pluginName + \" plugin has started\");\n\n                server.app.get(\"/swagger\", (_req: any, res: any) => {\n                    res.redirect(`http://localhost:${config.port}`);\n                });\n            },\n            onAuxiliaryServerDeploy(ops, server) {\n                SwaggerServer(config, ops, server);\n            },\n        },\n        __sys__.__root__,\n    );\n}\n\n"],"names":["pluginName","toPascalCase","meta","name","SwaggerPlugin","config","Plugin","create","version","description","onRegister","_error","log","Logger","for","info","error","onServerStart","server","logger","success","app","get","_req","res","redirect","port","onAuxiliaryServerDeploy","ops","SwaggerServer","__sys__","__root__"],"mappings":"iMAQA,MAAMA,EAAaC,EAAaC,EAAKC,MAC/B,SAAUC,EAAcC,GAC1B,OAAOC,EAAOC,OACV,CACIJ,KAAMD,EAAKC,KACXK,QAASN,EAAKM,QACdC,YAAaP,EAAKO,YAElB,UAAAC,CAAWC,GACP,MAAMC,EAAMC,EAAOC,IAAI,aACvBF,EAAIG,KAAK,8BACLJ,GACAC,EAAII,MAAMhB,EAAa,2BAA4BW,EAE3D,EACA,aAAAM,CAAcC,GACVC,EAAOC,QAAQpB,EAAa,uBAE5BkB,EAAOG,IAAIC,IAAI,WAAY,CAACC,EAAWC,KACnCA,EAAIC,SAAS,oBAAoBpB,EAAOqB,SAEhD,EACA,uBAAAC,CAAwBC,EAAKV,GACzBW,EAAcxB,EAAQuB,EAC1B,GAEJE,QAAQC,SAEhB"}
+{"version":3,"file":"index.js","sources":["../../../../src/index.ts"],"sourcesContent":["import { logger, Logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { SwaggerServer } from \"./server\";\nimport { SwaggerConfig } from \"./types\";\nimport { Plugin } from \"xypriss\";\n\nconst pluginName = toPascalCase(meta.name);\nexport function SwaggerPlugin(config: SwaggerConfig) {\n    return Plugin.create(\n        {\n            name: meta.name,\n            version: meta.version,\n            description: meta.description,\n            onRegister(_error) {\n                const log = Logger.for(\"Bootstrap\");\n                log.info(\"Starting swagger plugin...\");\n                if (_error) {\n                    log.error(pluginName + \" plugin failed to start:\", _error);\n                }\n            },\n            onServerStart(server) {\n                logger.success(pluginName + \" plugin has started\");\n\n                server.app.get(\"/swagger\", (_req: any, res: any) => {\n                    res.redirect(`http://localhost:${config.port}`);\n                });\n            },\n            onAuxiliaryServerDeploy(ops, server) {\n                SwaggerServer(config, ops, server);\n            },\n        }, \n        __sys__.__root__,\n    );\n}\n\n"],"names":["pluginName","toPascalCase","meta","name","SwaggerPlugin","config","Plugin","create","version","description","onRegister","_error","log","Logger","for","info","error","onServerStart","server","logger","success","app","get","_req","res","redirect","port","onAuxiliaryServerDeploy","ops","SwaggerServer","__sys__","__root__"],"mappings":"iMAMA,MAAMA,EAAaC,EAAaC,EAAKC,MAC/B,SAAUC,EAAcC,GAC1B,OAAOC,EAAOC,OACV,CACIJ,KAAMD,EAAKC,KACXK,QAASN,EAAKM,QACdC,YAAaP,EAAKO,YAClB,UAAAC,CAAWC,GACP,MAAMC,EAAMC,EAAOC,IAAI,aACvBF,EAAIG,KAAK,8BACLJ,GACAC,EAAII,MAAMhB,EAAa,2BAA4BW,EAE3D,EACA,aAAAM,CAAcC,GACVC,EAAOC,QAAQpB,EAAa,uBAE5BkB,EAAOG,IAAIC,IAAI,WAAY,CAACC,EAAWC,KACnCA,EAAIC,SAAS,oBAAoBpB,EAAOqB,SAEhD,EACA,uBAAAC,CAAwBC,EAAKV,GACzBW,EAAcxB,EAAQuB,EAC1B,GAEJE,QAAQC,SAEhB"}

package/dist/esm/server.js

@@ -1,2 +1,2 @@
-import{logger as t}from"./configs/Logger.js";import{meta as e,toPascalCase as r}from"./configs/meta.js";import{generateOpenAPI as o}from"./openapi.js";import{getSwaggerUIStream as s}from"./ui.js";function n(n,i,a){const c=n.path||"/docs",g=`${c}/swagger.json`,p=__sys__.plugins.get(e.name);if(!p)throw new Error(r(e.name,"-")+" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add ");const m=n.port||7070,u=i.createAuxiliaryServer({server:{port:m},security:{enabled:!1}});u.get(g,(e,r)=>{try{let t=[];i.getRouteRegistry&&(t=i.getRouteRegistry());const e=o(t,n);r.json(e)}catch(e){t.error("Error generating OpenAPI spec:",e),r.status(500).json({error:"Failed to generate documentation"})}}),u.get(c,(t,e)=>{const r=n.title||p?.vars?.__name__||"API Documentation",o=s(g,r);e.setHeader("Content-Type","text/html"),o.pipe(e)}),u.redirect("/",c,301);const l=`http://localhost:${m}${c}`;u.start(()=>{t.swagger(`${r(e.name)} Server isolated on port ${m}`),t.http(`GET ${l}`)})}export{n as SwaggerServer};
+import{logger as e}from"./configs/Logger.js";import{meta as o,toPascalCase as t}from"./configs/meta.js";import{generateOpenAPI as r}from"./openapi.js";import{getSwaggerUIStream as s}from"./ui.js";function n(n,i,_){const c=n.path||"/docs",a=`${c}/swagger.json`;console.log("plugin root path: ",__sys__.__root__),console.log("😇 env de HELLO depuis le plugin: ",__sys__.__env__.get("HELLO")),console.log("🤧 env de COMMON_VAR du root du project (devrait être undefined): ",__sys__.__env__.get("COMMON_VAR")),console.log("🤠 env from root using __sys__ (devrait être strictement undefined vue que ici, sys.__root__ devrait conduire vers '/home/idevo/Documents/projects/XyPriss/mods/swagger') pourtant le .env de cette root n'a pas de name: ",__sys__.__env__.get("NAME"));const g=__sys__.plugins.get(o.name);if(!g)throw new Error(t(o.name,"-")+" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add ");console.log("🤠 env from root using workspaceSYS (devrait être undefined selon la config de l'utilisateur: en mode ROOT:// ça devrait conduire vers _sys__.root ('/home/idevo/Documents/projects/XyPriss/mods/swagger') et CWD:// devrait envoyer process.cwd() ('/home/idevo/Documents/projects/XyPriss' (vue qu'on excute la cmd ici))): ",g.__env__.get("NAME")),console.log("😝 root path: ",g.__root__),console.log("😅 listing directory path: ",g.fs.ls("."));const d=n.port||7070,l=i.createAuxiliaryServer({server:{port:d},security:{enabled:!1}});l.get(a,(o,t)=>{try{let e=[];i.getRouteRegistry&&(e=i.getRouteRegistry());const o=r(e,n);t.json(o)}catch(o){e.error("Error generating OpenAPI spec:",o),t.status(500).json({error:"Failed to generate documentation"})}}),l.get(c,(e,o)=>{const t=n.title||g?.vars?.__name__||"API Documentation",r=s(a,t);o.setHeader("Content-Type","text/html"),r.pipe(o)}),l.redirect("/",c,301);const p=`http://localhost:${d}${c}`;l.start(()=>{e.swagger(`${t(o.name)} Server isolated on port ${d}`),e.http(`GET ${p}`)})}export{n as SwaggerServer};
 //# sourceMappingURL=server.js.map

package/dist/esm/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sources":["../../../../src/server.ts"],"sourcesContent":["import { logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { generateOpenAPI } from \"./openapi\";\nimport { SwaggerConfig } from \"./types\";\nimport { getSwaggerUIStream } from \"./ui\";\nimport { Plugin } from \"xypriss\";\n \ntype auxis = NonNullable<\n    ReturnType<typeof Plugin.create>[\"onAuxiliaryServerDeploy\"]\n>;\nexport type OpsServerManager = Parameters<auxis>[\"0\"] & {\n    getRouteRegistry?: () => any[];\n};\n\nexport type XyPrissServer = Parameters<auxis>[\"1\"];\n\nexport function SwaggerServer(\n    config: SwaggerConfig,\n    ops: OpsServerManager,\n    _XServer: XyPrissServer,\n) {\n    const docPath = config.path || \"/docs\";\n    const specPath = `${docPath}/swagger.json`;\n    const workspaceSYS = __sys__.plugins.get(meta.name);\n\n    if (!workspaceSYS) {\n        throw new Error(\n            toPascalCase(meta.name, \"-\") +\n                \" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add \",\n        );\n    }\n    const port = config.port || 7070;\n    const server = ops.createAuxiliaryServer({\n        server: { port },\n        security: {\n            enabled: false,\n        },\n    });\n\n    // Serve the raw OpenAPI JSON specification\n    server.get(specPath, (_req, res) => {\n        try {\n            let registry: any[] = [];\n\n            if (ops.getRouteRegistry) {\n                registry = ops.getRouteRegistry();\n            }\n\n            const spec = generateOpenAPI(registry, config);\n            res.json(spec);\n        } catch (error) {\n            logger.error(\"Error generating OpenAPI spec:\", error);\n            res.status(500).json({\n                error: \"Failed to generate documentation\",\n            });\n        }\n    });\n\n    // Serve the Swagger HTML Viewer\n    server.get(docPath, (_req, res) => {\n        const title =\n            config.title || workspaceSYS?.vars?.__name__ || \"API Documentation\";\n        const stream = getSwaggerUIStream(specPath, title);\n\n        res.setHeader(\"Content-Type\", \"text/html\");\n        stream.pipe(res);\n    });\n\n    // Redirect root path of the sub-server to docPath\n    server.redirect(\"/\", docPath, 301);\n\n    // Boot the auxiliary server immediately\n    const url = `http://localhost:${port}${docPath}`;\n    server.start(() => {\n        logger.swagger(\n            `${toPascalCase(meta.name)} Server isolated on port ${port}`,\n        );\n        logger.http(`GET ${url}`);\n    });\n}"],"names":["SwaggerServer","config","ops","_XServer","docPath","path","specPath","workspaceSYS","__sys__","plugins","get","meta","name","Error","toPascalCase","port","server","createAuxiliaryServer","security","enabled","_req","res","registry","getRouteRegistry","spec","generateOpenAPI","json","error","logger","status","title","vars","__name__","stream","getSwaggerUIStream","setHeader","pipe","redirect","url","start","swagger","http"],"mappings":"6MAgBgBA,EACZC,EACAC,EACAC,GAEA,MAAMC,EAAUH,EAAOI,MAAQ,QACzBC,EAAW,GAAGF,iBACdG,EAAeC,QAAQC,QAAQC,IAAIC,EAAKC,MAE9C,IAAKL,EACD,MAAM,IAAIM,MACNC,EAAaH,EAAKC,KAAM,KACpB,uFAGZ,MAAMG,EAAOd,EAAOc,MAAQ,KACtBC,EAASd,EAAIe,sBAAsB,CACrCD,OAAQ,CAAED,QACVG,SAAU,CACNC,SAAS,KAKjBH,EAAON,IAAIJ,EAAU,CAACc,EAAMC,KACxB,IACI,IAAIC,EAAkB,GAElBpB,EAAIqB,mBACJD,EAAWpB,EAAIqB,oBAGnB,MAAMC,EAAOC,EAAgBH,EAAUrB,GACvCoB,EAAIK,KAAKF,EACb,CAAE,MAAOG,GACLC,EAAOD,MAAM,iCAAkCA,GAC/CN,EAAIQ,OAAO,KAAKH,KAAK,CACjBC,MAAO,oCAEf,IAIJX,EAAON,IAAIN,EAAS,CAACgB,EAAMC,KACvB,MAAMS,EACF7B,EAAO6B,OAASvB,GAAcwB,MAAMC,UAAY,oBAC9CC,EAASC,EAAmB5B,EAAUwB,GAE5CT,EAAIc,UAAU,eAAgB,aAC9BF,EAAOG,KAAKf,KAIhBL,EAAOqB,SAAS,IAAKjC,EAAS,KAG9B,MAAMkC,EAAM,oBAAoBvB,IAAOX,IACvCY,EAAOuB,MAAM,KACTX,EAAOY,QACH,GAAG1B,EAAaH,EAAKC,iCAAiCG,KAE1Da,EAAOa,KAAK,OAAOH,MAE3B"}
+{"version":3,"file":"server.js","sources":["../../../../src/server.ts"],"sourcesContent":["import { logger } from \"./configs/Logger\";\nimport { meta, toPascalCase } from \"./configs/meta\";\nimport { generateOpenAPI } from \"./openapi\";\nimport { SwaggerConfig } from \"./types\";\nimport { getSwaggerUIStream } from \"./ui\";\nimport { Plugin } from \"xypriss\";\n\ntype auxis = NonNullable<\n    ReturnType<typeof Plugin.create>[\"onAuxiliaryServerDeploy\"]\n>;\nexport type OpsServerManager = Parameters<auxis>[\"0\"] & {\n    getRouteRegistry?: () => any[];\n};\n\nexport type XyPrissServer = Parameters<auxis>[\"1\"];\n\nexport function SwaggerServer(\n    config: SwaggerConfig,\n    ops: OpsServerManager,\n    _XServer: XyPrissServer,\n) {\n    const docPath = config.path || \"/docs\";\n    const specPath = `${docPath}/swagger.json`;\n    console.log(\"plugin root path: \", __sys__.__root__);\n\n    console.log(\n        \"😇 env de HELLO depuis le plugin: \",\n        __sys__.__env__.get(\"HELLO\"),\n    );\n    console.log(\n        \"🤧 env de COMMON_VAR du root du project (devrait être undefined): \",\n        __sys__.__env__.get(\"COMMON_VAR\"),\n    );\n\n    console.log(\n        \"🤠 env from root using __sys__ (devrait être strictement undefined vue que ici, sys.__root__ devrait conduire vers '/home/idevo/Documents/projects/XyPriss/mods/swagger') pourtant le .env de cette root n'a pas de name: \",\n        __sys__.__env__.get(\"NAME\"),\n    );\n\n    const workspaceSYS = __sys__.plugins.get(meta.name);\n\n    // console.log(\"workspaceFS: \", workspaceFS);\n\n    if (!workspaceSYS) {\n        throw new Error(\n            toPascalCase(meta.name, \"-\") +\n                \" is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add \",\n        );\n    }\n    console.log(\n        \"🤠 env from root using workspaceSYS (devrait être undefined selon la config de l'utilisateur: en mode ROOT:// ça devrait conduire vers _sys__.root ('/home/idevo/Documents/projects/XyPriss/mods/swagger') et CWD:// devrait envoyer process.cwd() ('/home/idevo/Documents/projects/XyPriss' (vue qu'on excute la cmd ici))): \",\n        workspaceSYS.__env__.get(\"NAME\"),\n    );\n    console.log(\"😝 root path: \", workspaceSYS.__root__);\n    console.log(\"😅 listing directory path: \", workspaceSYS.fs.ls(\".\"));\n\n    const port = config.port || 7070;\n    const server = ops.createAuxiliaryServer({\n        server: { port },\n        security: {\n            enabled: false,\n        },\n    });\n\n    // Serve the raw OpenAPI JSON specification\n    server.get(specPath, (_req, res) => {\n        try {\n            let registry: any[] = [];\n\n            if (ops.getRouteRegistry) {\n                registry = ops.getRouteRegistry();\n            }\n\n            const spec = generateOpenAPI(registry, config);\n            res.json(spec);\n        } catch (error) {\n            logger.error(\"Error generating OpenAPI spec:\", error);\n            res.status(500).json({\n                error: \"Failed to generate documentation\",\n            });\n        }\n    });\n\n    // Serve the Swagger HTML Viewer\n    server.get(docPath, (_req, res) => {\n        const title =\n            config.title || workspaceSYS?.vars?.__name__ || \"API Documentation\";\n        const stream = getSwaggerUIStream(specPath, title);\n\n        res.setHeader(\"Content-Type\", \"text/html\");\n        stream.pipe(res);\n    });\n\n    // Redirect root path of the sub-server to docPath\n    server.redirect(\"/\", docPath, 301);\n\n    // Boot the auxiliary server immediately\n    const url = `http://localhost:${port}${docPath}`;\n    server.start(() => {\n        logger.swagger(\n            `${toPascalCase(meta.name)} Server isolated on port ${port}`,\n        );\n        logger.http(`GET ${url}`);\n    });\n}\n"],"names":["SwaggerServer","config","ops","_XServer","docPath","path","specPath","console","log","__sys__","__root__","__env__","get","workspaceSYS","plugins","meta","name","Error","toPascalCase","fs","ls","port","server","createAuxiliaryServer","security","enabled","_req","res","registry","getRouteRegistry","spec","generateOpenAPI","json","error","logger","status","title","vars","__name__","stream","getSwaggerUIStream","setHeader","pipe","redirect","url","start","swagger","http"],"mappings":"6MAgBgBA,EACZC,EACAC,EACAC,GAEA,MAAMC,EAAUH,EAAOI,MAAQ,QACzBC,EAAW,GAAGF,iBACpBG,QAAQC,IAAI,qBAAsBC,QAAQC,UAE1CH,QAAQC,IACJ,qCACAC,QAAQE,QAAQC,IAAI,UAExBL,QAAQC,IACJ,qEACAC,QAAQE,QAAQC,IAAI,eAGxBL,QAAQC,IACJ,6NACAC,QAAQE,QAAQC,IAAI,SAGxB,MAAMC,EAAeJ,QAAQK,QAAQF,IAAIG,EAAKC,MAI9C,IAAKH,EACD,MAAM,IAAII,MACNC,EAAaH,EAAKC,KAAM,KACpB,uFAGZT,QAAQC,IACJ,iUACAK,EAAaF,QAAQC,IAAI,SAE7BL,QAAQC,IAAI,iBAAkBK,EAAaH,UAC3CH,QAAQC,IAAI,8BAA+BK,EAAaM,GAAGC,GAAG,MAE9D,MAAMC,EAAOpB,EAAOoB,MAAQ,KACtBC,EAASpB,EAAIqB,sBAAsB,CACrCD,OAAQ,CAAED,QACVG,SAAU,CACNC,SAAS,KAKjBH,EAAOV,IAAIN,EAAU,CAACoB,EAAMC,KACxB,IACI,IAAIC,EAAkB,GAElB1B,EAAI2B,mBACJD,EAAW1B,EAAI2B,oBAGnB,MAAMC,EAAOC,EAAgBH,EAAU3B,GACvC0B,EAAIK,KAAKF,EACb,CAAE,MAAOG,GACLC,EAAOD,MAAM,iCAAkCA,GAC/CN,EAAIQ,OAAO,KAAKH,KAAK,CACjBC,MAAO,oCAEf,IAIJX,EAAOV,IAAIR,EAAS,CAACsB,EAAMC,KACvB,MAAMS,EACFnC,EAAOmC,OAASvB,GAAcwB,MAAMC,UAAY,oBAC9CC,EAASC,EAAmBlC,EAAU8B,GAE5CT,EAAIc,UAAU,eAAgB,aAC9BF,EAAOG,KAAKf,KAIhBL,EAAOqB,SAAS,IAAKvC,EAAS,KAG9B,MAAMwC,EAAM,oBAAoBvB,IAAOjB,IACvCkB,EAAOuB,MAAM,KACTX,EAAOY,QACH,GAAG5B,EAAaH,EAAKC,iCAAiCK,KAE1Da,EAAOa,KAAK,OAAOH,MAE3B"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import * as xypriss from 'xypriss';
+
 interface SwaggerConfig {
     /**
      * The path where the UI will be served.
@@ -14,6 +16,6 @@ interface SwaggerConfig {
     port?: number;
 }
 
-declare function SwaggerPlugin(config: SwaggerConfig): any;
+declare function SwaggerPlugin(config: SwaggerConfig): xypriss.XyPrissPlugin;
 
 export { SwaggerPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xypriss-swagger",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Auto-documentation plugin for XyPriss Router V2",
   "type": "module",
   "main": "dist/cjs/index.js",
@@ -20,8 +20,9 @@
   },
   "dependencies": {
     "nehoid": "^2.1.4",
-    "xypriss": "9.6.48-xnb14",
-    "xypriss-security": "^2.1.13"
+    "xypriss-security": "^2.1.13",
+    "xypriss": "9.6.80"
+
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.2",
@@ -34,5 +35,7 @@
     "rollup-plugin-dts": "^6.4.1",
     "tslib": "^2.8.1",
     "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
   }
 }

package/src/configs/meta.ts

@@ -1,9 +1,8 @@
-import "xypriss";
 import { ISwaggerJSONStructure } from "../types";
 
 // console.log("[PLUGIN:META] 🥸 la 'root' du plugin: ", __sys__?.__root__);
 
-const root = __sys__?.__root__ || process.cwd();
+const root = __sys__.__root__;
 
 export const meta = __sys__.fs.readJsonSync(
     __sys__.fs.join(root, "package.json"),
@@ -14,3 +13,4 @@ export const toPascalCase = (str: string, spliter = "-") =>
         .split(spliter)
         .map((n) => n[0].toUpperCase() + n.slice(1))
         .join(" ");
+

package/src/index.ts

@@ -4,16 +4,13 @@ import { SwaggerServer } from "./server";
 import { SwaggerConfig } from "./types";
 import { Plugin } from "xypriss";
 
-// console.log("[swagger] internal plugin sys", __sys__.__root__);
-
 const pluginName = toPascalCase(meta.name);
-export function SwaggerPlugin(config: SwaggerConfig): any {
+export function SwaggerPlugin(config: SwaggerConfig) {
     return Plugin.create(
         {
             name: meta.name,
             version: meta.version,
             description: meta.description,
-
             onRegister(_error) {
                 const log = Logger.for("Bootstrap");
                 log.info("Starting swagger plugin...");
@@ -31,7 +28,7 @@ export function SwaggerPlugin(config: SwaggerConfig): any {
             onAuxiliaryServerDeploy(ops, server) {
                 SwaggerServer(config, ops, server);
             },
-        },
+        }, 
         __sys__.__root__,
     );
 }

package/src/server.ts

@@ -4,7 +4,7 @@ import { generateOpenAPI } from "./openapi";
 import { SwaggerConfig } from "./types";
 import { getSwaggerUIStream } from "./ui";
 import { Plugin } from "xypriss";
- 
+
 type auxis = NonNullable<
     ReturnType<typeof Plugin.create>["onAuxiliaryServerDeploy"]
 >;
@@ -21,14 +21,39 @@ export function SwaggerServer(
 ) {
     const docPath = config.path || "/docs";
     const specPath = `${docPath}/swagger.json`;
+    console.log("plugin root path: ", __sys__.__root__);
+
+    console.log(
+        "😇 env de HELLO depuis le plugin: ",
+        __sys__.__env__.get("HELLO"),
+    );
+    console.log(
+        "🤧 env de COMMON_VAR du root du project (devrait être undefined): ",
+        __sys__.__env__.get("COMMON_VAR"),
+    );
+
+    console.log(
+        "🤠 env from root using __sys__ (devrait être strictement undefined vue que ici, sys.__root__ devrait conduire vers '/home/idevo/Documents/projects/XyPriss/mods/swagger') pourtant le .env de cette root n'a pas de name: ",
+        __sys__.__env__.get("NAME"),
+    );
+
     const workspaceSYS = __sys__.plugins.get(meta.name);
 
+    // console.log("workspaceFS: ", workspaceFS);
+
     if (!workspaceSYS) {
         throw new Error(
             toPascalCase(meta.name, "-") +
                 " is not authorized in your xypriss.config.jsonc or xypriss.config.json. Please add ",
         );
     }
+    console.log(
+        "🤠 env from root using workspaceSYS (devrait être undefined selon la config de l'utilisateur: en mode ROOT:// ça devrait conduire vers _sys__.root ('/home/idevo/Documents/projects/XyPriss/mods/swagger') et CWD:// devrait envoyer process.cwd() ('/home/idevo/Documents/projects/XyPriss' (vue qu'on excute la cmd ici))): ",
+        workspaceSYS.__env__.get("NAME"),
+    );
+    console.log("😝 root path: ", workspaceSYS.__root__);
+    console.log("😅 listing directory path: ", workspaceSYS.fs.ls("."));
+
     const port = config.port || 7070;
     const server = ops.createAuxiliaryServer({
         server: { port },
@@ -77,4 +102,4 @@ export function SwaggerServer(
         );
         logger.http(`GET ${url}`);
     });
-}
+}

package/tsconfig.json

@@ -12,7 +12,7 @@
         "skipLibCheck": true,
         "forceConsistentCasingInFileNames": true,
         "paths": {
-            // "xypriss": ["../../src/index.ts"] // for local dev purpose
+            "xypriss": ["../../src/index.ts"] // for local dev purpose
         }
     },
     "include": ["src/**/*"]