@cyberismo/backend 0.0.14 → 0.0.16

package/dist/public/assets/index-DnK7MBer.css

@@ -0,0 +1 @@
+@media(max-width:800px){.breadcrumbs{display:none}}[role=treeitem][aria-selected=false]:hover{.treenode{background-color:#dedede}}[role=treeitem][aria-selected=true]{outline:none}.resizeHandle{width:2px}.resizeHandle:hover,.resizeHandle:active{background-color:#0b6bcb}.cyberismo-svg-wrapper svg{max-height:100vh}.doc .MuiButton-root{margin-top:12px}.doc table.tableblock{border-collapse:collapse}.doc{color:#333;font-size:inherit;-ms-hyphens:auto;hyphens:auto;line-height:1.6;margin:0;padding:0}@media screen and (min-width:1024px){.doc{-webkit-box-flex:1;-ms-flex:auto;flex:auto;font-size:.94444rem;margin:0;min-width:0}}.doc h1,.doc h2,.doc h3,.doc h4,.doc h5,.doc h6{color:#191919;font-weight:400;-ms-hyphens:none;hyphens:none;line-height:1.3;margin:1rem 0 0}.doc>h1.page:first-child{font-size:2rem;margin:1.5rem 0}@media screen and (min-width:769px){.doc>h1.page:first-child{margin-top:2.5rem}}.doc>h1.page:first-child+aside.toc.embedded{margin-top:-.5rem}.doc>h2#name+.sectionbody{margin-top:1rem}#preamble+.sect1,.doc .sect1+.sect1{margin-top:2rem}.doc h1.sect0{background:#f0f0f0;font-size:1.8em;margin:1.5rem -1rem 0;padding:.5rem 1rem}.doc h2:not(.discrete){border-bottom:1px solid #e1e1e1;margin-left:-1rem;margin-right:-1rem;padding:.4rem 1rem .1rem}.doc h3:not(.discrete),.doc h4:not(.discrete){font-weight:600}.doc h1 .anchor,.doc h2 .anchor,.doc h3 .anchor,.doc h4 .anchor,.doc h5 .anchor,.doc h6 .anchor{position:absolute;text-decoration:none;width:1.75ex;margin-left:-1.5ex;visibility:hidden;font-size:.8em;font-weight:400;padding-top:.05em}.doc h1 .anchor:before,.doc h2 .anchor:before,.doc h3 .anchor:before,.doc h4 .anchor:before,.doc h5 .anchor:before,.doc h6 .anchor:before{content:"§"}.doc h1:hover .anchor,.doc h2:hover .anchor,.doc h3:hover .anchor,.doc h4:hover .anchor,.doc h5:hover .anchor,.doc h6:hover .anchor{visibility:visible}.doc dl,.doc p{margin:0}.doc a{color:#1565c0}.doc a:hover{color:#104d92}.doc a.bare{-ms-hyphens:none;hyphens:none}.doc a.unresolved{color:#d32f2f}.doc i.fa{-ms-hyphens:none;hyphens:none;font-style:normal}.doc .colist>table code,.doc p code,.doc thead code{color:#222;background:#fafafa;border-radius:.25em;font-size:.95em;padding:.125em .25em}.doc code,.doc pre{-ms-hyphens:none;hyphens:none}.doc pre{font-size:.88889rem;line-height:1.5;margin:0}.doc blockquote{margin:0}.doc .paragraph.lead>p{font-size:1rem}.doc .right{float:right}.doc .left{float:left}.doc .float-gap.right{margin:0 1rem 1rem 0}.doc .float-gap.left{margin:0 0 1rem 1rem}.doc .float-group:after{content:"";display:table;clear:both}.doc .text-left{text-align:left}.doc .text-center{text-align:center}.doc .text-right{text-align:right}.doc .text-justify{text-align:justify}.doc .stretch{width:100%}.doc .big{font-size:larger}.doc .small{font-size:smaller}.doc .underline{text-decoration:underline}.doc .line-through{text-decoration:line-through}.doc .dlist,.doc .exampleblock,.doc .hdlist,.doc .imageblock,.doc .listingblock,.doc .literalblock,.doc .olist,.doc .paragraph,.doc .partintro,.doc .quoteblock,.doc .sidebarblock,.doc .tabs,.doc .ulist,.doc .verseblock,.doc .videoblock,.doc details,.doc hr{margin:1rem 0 0}.doc .tablecontainer,.doc .tablecontainer+*,.doc :not(.tablecontainer)>table.tableblock,.doc :not(.tablecontainer)>table.tableblock+*,.doc>table.tableblock,.doc>table.tableblock+*{margin-top:1.5rem}.doc table.tableblock{font-size:.83333rem}.doc p.tableblock+p.tableblock{margin-top:.5rem}.doc table.tableblock pre{font-size:inherit}.doc td.tableblock>.content{word-wrap:anywhere}.doc td.tableblock>.content>:first-child{margin-top:0}.doc table.tableblock td{padding:.5rem}.doc table.tableblock th{padding:.5rem;background:#fbfcfe}.doc table.tableblock,.doc table.tableblock>*>tr>*{border:0 solid #e1e1e1}.doc table.grid-all>*>tr>*{border-width:1px}.doc table.grid-cols>*>tr>*{border-width:0 1px}.doc table.grid-rows>*>tr>*{border-width:1px 0}.doc table.grid-all>thead th,.doc table.grid-rows>thead th{border-bottom-width:2.5px}.doc table.frame-all{border-width:1px}.doc table.frame-ends{border-width:1px 0}.doc table.frame-sides{border-width:0 1px}.doc table.frame-none>colgroup+*>:first-child>*,.doc table.frame-sides>colgroup+*>:first-child>*{border-top-width:0}.doc table.frame-sides>:last-child>:last-child>*{border-bottom-width:0}.doc table.frame-ends>*>tr>:first-child,.doc table.frame-none>*>tr>:first-child{border-left-width:0}.doc table.frame-ends>*>tr>:last-child,.doc table.frame-none>*>tr>:last-child{border-right-width:0}.doc table.stripes-all>tbody>tr,.doc table.stripes-even>tbody>tr:nth-of-type(2n),.doc table.stripes-hover>tbody>tr:hover,.doc table.stripes-odd>tbody>tr:nth-of-type(odd){background:#fafafa}.doc table.tableblock>tfoot{background:-webkit-gradient(linear,left top,left bottom,from(#f0f0f0),to(#fff));background:linear-gradient(180deg,#f0f0f0 0,#fff)}.doc .halign-left{text-align:left}.doc .halign-right{text-align:right}.doc .halign-center{text-align:center}.doc .valign-top{vertical-align:top}.doc .valign-bottom{vertical-align:bottom}.doc .valign-middle{vertical-align:middle}.doc .admonitionblock{margin:1.4rem 0 0}.doc .admonitionblock p,.doc .admonitionblock td.content{font-size:.88889rem}.doc .admonitionblock td.content>.title+*,.doc .admonitionblock td.content>:not(.title):first-child{margin-top:0}.doc .admonitionblock td.content pre{font-size:.83333rem}.doc .admonitionblock>table{table-layout:fixed;position:relative;width:100%}.doc .admonitionblock td.content{padding:1rem 1rem .75rem;background:#fafafa;width:100%;word-wrap:anywhere}.doc .admonitionblock td.icon{font-size:.83333rem;left:0;line-height:1;padding:0;position:absolute;top:0;-webkit-transform:translate(-.5rem,-50%);transform:translate(-.5rem,-50%)}.doc .admonitionblock td.icon i{-webkit-box-align:center;-ms-flex-align:center;align-items:center;border-radius:.45rem;display:-webkit-inline-box;display:-ms-inline-flexbox;display:inline-flex;-webkit-filter:initial;filter:none;height:1.25rem;padding:0 .5rem;vertical-align:initial;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.doc .admonitionblock td.icon i:after{content:attr(title);font-weight:600;font-style:normal;text-transform:uppercase}.doc .admonitionblock td.icon i.icon-caution{background-color:#a0439c;color:#fff}.doc .admonitionblock td.icon i.icon-important{background-color:#d32f2f;color:#fff}.doc .admonitionblock td.icon i.icon-note{background-color:#217ee7;color:#fff}.doc .admonitionblock td.icon i.icon-tip{background-color:#41af46;color:#fff}.doc .admonitionblock td.icon i.icon-warning{background-color:#e18114;color:#fff}.doc .imageblock,.doc .videoblock{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;-webkit-box-align:center;-ms-flex-align:center;align-items:center}.doc .imageblock .content{-ms-flex-item-align:stretch;align-self:stretch;text-align:center}.doc .imageblock.text-left,.doc .videoblock.text-left{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.doc .imageblock.text-left .content{text-align:left}.doc .imageblock.text-right,.doc .videoblock.text-right{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.doc .imageblock.text-right .content{text-align:right}.doc .image>img,.doc .image>object,.doc .image>svg,.doc .imageblock img,.doc .imageblock object,.doc .imageblock svg{display:inline-block;max-height:75vh;max-width:100%;vertical-align:middle}.doc .image:not(.left):not(.right)>img{margin-top:-.2em}.doc .videoblock iframe,.doc .videoblock video{max-width:100%;vertical-align:middle}#preamble .abstract blockquote{background:#f0f0f0;border-left:5px solid #e1e1e1;color:#4a4a4a;font-size:.88889rem;padding:.75em 1em}.doc .quoteblock,.doc .verseblock{background:#fafafa;border-left:5px solid #5d5d5d;color:#5d5d5d}.doc .quoteblock{padding:.25rem 2rem 1.25rem}.doc .quoteblock .attribution{color:#8e8e8e;font-size:.83333rem;margin-top:.75rem}.doc .quoteblock blockquote{margin-top:1rem}.doc .quoteblock .paragraph{font-style:italic}.doc .quoteblock cite{padding-left:1em}.doc .verseblock{font-size:1.15em;padding:1rem 2rem}.doc .verseblock pre{font-family:inherit;font-size:inherit}.doc ol,.doc ul{margin:0;padding:0 0 0 2rem}.doc ol.none,.doc ol.unnumbered,.doc ol.unstyled,.doc ul.checklist,.doc ul.no-bullet,.doc ul.none,.doc ul.unstyled{list-style-type:none}.doc ol.unnumbered,.doc ul.no-bullet{padding-left:1.25rem}.doc ol.unstyled,.doc ul.unstyled{padding-left:0}.doc ul.circle{list-style-type:circle}.doc ul.disc{list-style-type:disc}.doc ul.square{list-style-type:square}.doc ul.circle ul:not([class]),.doc ul.disc ul:not([class]),.doc ul.square ul:not([class]){list-style:inherit}.doc ol.arabic{list-style-type:decimal}.doc ol.decimal{list-style-type:decimal-leading-zero}.doc ol.loweralpha{list-style-type:lower-alpha}.doc ol.upperalpha{list-style-type:upper-alpha}.doc ol.lowerroman{list-style-type:lower-roman}.doc ol.upperroman{list-style-type:upper-roman}.doc ol.lowergreek{list-style-type:lower-greek}.doc ul.checklist{padding-left:1.75rem}.doc ul.checklist p>i.fa-check-square-o:first-child,.doc ul.checklist p>i.fa-square-o:first-child{display:-webkit-inline-box;display:-ms-inline-flexbox;display:inline-flex;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;width:1.25rem;margin-left:-1.25rem}.doc ul.checklist i.fa-check-square-o:before{content:"✓"}.doc ul.checklist i.fa-square-o:before{content:"❏"}.doc .dlist .dlist,.doc .dlist .olist,.doc .dlist .ulist,.doc .olist .dlist,.doc .olist .olist,.doc .olist .ulist,.doc .olist li+li,.doc .ulist .dlist,.doc .ulist .olist,.doc .ulist .ulist,.doc .ulist li+li{margin-top:.5rem}.doc .admonitionblock .listingblock,.doc .olist .listingblock,.doc .ulist .listingblock{padding:0}.doc .admonitionblock .title,.doc .exampleblock .title,.doc .imageblock .title,.doc .listingblock .title,.doc .literalblock .title,.doc .openblock .title,.doc .videoblock .title,.doc table.tableblock caption{color:#5d5d5d;font-size:.88889rem;font-style:italic;font-weight:600;-ms-hyphens:none;hyphens:none;letter-spacing:.01em;padding-bottom:.075rem}.doc table.tableblock caption{text-align:left}.doc .olist .title,.doc .ulist .title{font-style:italic;font-weight:600;margin-bottom:.25rem}.doc .imageblock .title,.doc .videoblock .title{margin-top:.5rem;padding-bottom:0}.doc details{margin-left:1rem}.doc details>summary{display:block;position:relative;line-height:1.6;margin-bottom:.5rem}.doc details>summary::-webkit-details-marker{display:none}.doc details>summary:before{content:"";border:solid transparent;border-left:solid;border-width:.3em 0 .3em .5em;position:absolute;top:.5em;left:-1rem;-webkit-transform:translateX(15%);transform:translate(15%)}.doc details[open]>summary:before{border-color:currentColor transparent transparent;border-width:.5rem .3rem 0;-webkit-transform:translateY(15%);transform:translateY(15%)}.doc details>summary:after{content:"";width:1rem;height:1em;position:absolute;top:.3em;left:-1rem}.doc details.result{margin-top:.25rem}.doc details.result>summary{color:#5d5d5d;font-style:italic;margin-bottom:0}.doc details.result>.content{margin-left:-1rem}.doc .exampleblock>.content,.doc details.result>.content{background:#fff;border:.25rem solid #5d5d5d;border-radius:.5rem;padding:.75rem}.doc .exampleblock>.content:after,.doc details.result>.content:after{content:"";display:table;clear:both}.doc .exampleblock>.content>:first-child,.doc details>.content>:first-child{margin-top:0}.doc .sidebarblock{background:#e1e1e1;border-radius:.75rem;padding:.75rem 1.5rem}.doc .sidebarblock>.content>.title{font-size:1.25rem;font-weight:600;line-height:1.3;margin-bottom:.5rem;text-align:center}.doc .sidebarblock>.content>.title+*,.doc .sidebarblock>.content>:not(.title):first-child{margin-top:0}.doc .listingblock.wrap pre,.doc table.tableblock pre{white-space:pre-wrap}.doc .listingblock pre:not(.highlight),.doc .literalblock pre,.doc pre.highlight>code{background:#fafafa;-webkit-box-shadow:inset 0 0 1.75px #e1e1e1;box-shadow:inset 0 0 1.75px #e1e1e1;display:block;overflow-x:auto;padding:.875em}.doc .listingblock>.content{position:relative}.doc .source-toolbox{display:-webkit-box;display:-ms-flexbox;display:flex;visibility:hidden;position:absolute;top:.25rem;right:.5rem;color:gray;font-family:Roboto,sans-serif;font-size:.72222rem;line-height:1;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;white-space:nowrap;z-index:1}.doc .listingblock:hover .source-toolbox{visibility:visible}.doc .source-toolbox .source-lang{text-transform:uppercase;letter-spacing:.075em}.doc .source-toolbox>:not(:last-child):after{content:"|";letter-spacing:0;padding:0 1ch}.doc .source-toolbox .copy-button{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;-webkit-box-align:center;-ms-flex-align:center;align-items:center;background:none;border:none;color:inherit;outline:none;padding:0;font-size:inherit;line-height:inherit;width:1em;height:1em}.doc .source-toolbox .copy-icon{-webkit-box-flex:0;-ms-flex:none;flex:none;width:inherit;height:inherit}.doc .source-toolbox img.copy-icon{-webkit-filter:invert(50.2%);filter:invert(50.2%)}.doc .source-toolbox svg.copy-icon{fill:currentColor}.doc .source-toolbox .copy-toast{-webkit-box-flex:0;-ms-flex:none;flex:none;position:relative;display:-webkit-inline-box;display:-ms-inline-flexbox;display:inline-flex;-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;margin-top:1em;background-color:#333;border-radius:.25em;padding:.5em;color:#fff;cursor:auto;opacity:0;-webkit-transition:opacity .5s ease .5s;transition:opacity .5s ease .5s}.doc .source-toolbox .copy-toast:after{content:"";position:absolute;top:0;width:1em;height:1em;border:.55em solid transparent;border-left-color:#333;-webkit-transform:rotate(-90deg) translateX(50%) translateY(50%);transform:rotate(-90deg) translate(50%) translateY(50%);-webkit-transform-origin:left;transform-origin:left}.doc .source-toolbox .copy-button.clicked .copy-toast{opacity:1;-webkit-transition:none;transition:none}.doc .language-console .hljs-meta{-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.doc .dlist dt{font-style:italic}.doc .dlist dd{margin:0 0 0 1.5rem}.doc .dlist dd+dt,.doc .dlist dd>p:first-child{margin-top:.5rem}.doc td.hdlist1,.doc td.hdlist2{padding:.5rem 0 0;vertical-align:top}.doc tr:first-child>.hdlist1,.doc tr:first-child>.hdlist2{padding-top:0}.doc td.hdlist1{font-weight:600;padding-right:.25rem}.doc td.hdlist2{padding-left:.25rem}.doc .colist{font-size:.88889rem;margin:.25rem 0 -.25rem}.doc .colist>table>tbody>tr>:first-child,.doc .colist>table>tr>:first-child{padding:.25em .5rem 0;vertical-align:top}.doc .colist>table>tbody>tr>:last-child,.doc .colist>table>tr>:last-child{padding:.25rem 0}.doc .conum[data-value]{border:1px solid;border-radius:100%;display:inline-block;font-family:Roboto,sans-serif;font-size:.75rem;font-style:normal;line-height:1.2;text-align:center;width:1.25em;height:1.25em;letter-spacing:-.25ex;text-indent:-.25ex}.doc .conum[data-value]:after{content:attr(data-value)}.doc .conum[data-value]+b{display:none}.doc hr{border:solid #e1e1e1;border-width:2px 0 0;height:0}.doc b.button{white-space:nowrap}.doc b.button:before{content:"[";padding-right:.25em}.doc b.button:after{content:"]";padding-left:.25em}.doc kbd{display:inline-block;font-size:.66667rem;background:#fafafa;border:1px solid #c1c1c1;border-radius:.25em;-webkit-box-shadow:0 1px 0 #c1c1c1,0 0 0 .1em #fff inset;box-shadow:0 1px #c1c1c1,inset 0 0 0 .1em #fff;padding:.25em .5em;vertical-align:text-bottom;white-space:nowrap}.doc .keyseq,.doc kbd{line-height:1}.doc .keyseq{font-size:.88889rem}.doc .keyseq kbd{margin:0 .125em}.doc .keyseq kbd:first-child{margin-left:0}.doc .keyseq kbd:last-child{margin-right:0}.doc .menuseq,.doc .path{-ms-hyphens:none;hyphens:none}.doc .menuseq i.caret:before{content:"›";font-size:1.1em;font-weight:600;line-height:.90909}.doc :not(pre).nowrap{white-space:nowrap}.doc .nobreak{-ms-hyphens:none;hyphens:none;word-wrap:normal}.doc :not(pre).pre-wrap{white-space:pre-wrap}#footnotes{font-size:.85em;line-height:1.5;margin:2rem -.5rem 0}.doc td.tableblock>.content #footnotes{margin:2rem 0 0}#footnotes hr{border-top-width:1px;margin-top:0;width:20%}#footnotes .footnote{margin:.5em 0 0 1em}#footnotes .footnote+.footnote{margin-top:.25em}#footnotes .footnote>a:first-of-type{display:inline-block;margin-left:-2em;text-align:right;width:1.5em}.toc-menu{color:#5d5d5d}.toc.sidebar .toc-menu{margin-right:.75rem;position:sticky;top:6rem}.toc .toc-menu h3{color:#333;font-size:.88889rem;font-weight:600;line-height:1.3;margin:0 -.5px;padding-bottom:.25rem}.toc.sidebar .toc-menu h3{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;height:2.5rem;-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end}.toc .toc-menu ul{font-size:.83333rem;line-height:1.2;list-style:none;margin:0;padding:0}.toc.sidebar .toc-menu ul{max-height:calc(100vh - 8.5rem);overflow-y:auto;-ms-scroll-chaining:none;overscroll-behavior:none}@supports (scrollbar-width: none){.toc.sidebar .toc-menu ul{scrollbar-width:none}}.toc .toc-menu ul::-webkit-scrollbar{width:0;height:0}@media screen and (min-width:1024px){.toc .toc-menu h3{font-size:.83333rem}.toc .toc-menu ul{font-size:.75rem}}.toc .toc-menu li{margin:0}.toc .toc-menu li[data-level="2"] a{padding-left:1.25rem}.toc .toc-menu li[data-level="3"] a{padding-left:2rem}.toc .toc-menu a{color:inherit;border-left:2px solid #e1e1e1;display:inline-block;padding:.25rem 0 .25rem .5rem;text-decoration:none}.sidebar.toc .toc-menu a{display:block;outline:none}.toc .toc-menu a:hover{color:#1565c0}.toc .toc-menu a.is-active{border-left-color:#2a7ee4;color:#2a7ee4}.sidebar.toc .toc-menu a:focus{background:#fafafa}.toc .toc-menu .is-hidden-toc{display:none!important}.contentSidebar{min-width:160px}.doc .videoblock .content{position:relative;width:100%;max-width:100%}.doc .videoblock .content:before{content:"";display:block;padding-top:56.25%}.doc .videoblock .content>iframe,.doc .videoblock .content>video{position:absolute;inset:0;width:100%!important;height:100%!important;border:0;background:#000;display:block}

package/dist/public/index.html

@@ -11,8 +11,8 @@
       name="msapplication-TileImage"
       content="/cropped-favicon-270x270.png"
     />
-    <script type="module" crossorigin src="/assets/index-OjHhVGiV.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DA46eVkH.css">
+    <script type="module" crossorigin src="/assets/index-D410yunq.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DnK7MBer.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2025
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  details. You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+import type { Context } from 'hono';
+export interface ResourceFileContentResponse {
+    content: string;
+}
+export interface ResourceValidationResponse {
+    errors: string[];
+}
+export interface TreeOptions {
+    recursive?: boolean;
+    cardKey?: string;
+}
+export interface AppVars {
+    tree?: TreeOptions;
+}
+export type AppContext = Context<{
+    Variables: AppVars;
+}>;

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The relative path to the static frontend directory.
+ */
+export declare const staticFrontendDirRelative: string;
+/**
+ * Finds a free port.
+ * @param port - The port to start looking for.
+ * @param maxAttempts - The maximum number of attempts to find a free port.
+ * @returns The free port.
+ */
+export declare function findFreePort(minPort: number, maxPort: number): Promise<number>;

package/dist/utils.js

@@ -12,38 +12,6 @@
 */
 import path from 'node:path';
 import { createServer } from 'node:net';
-/**
- * Runs promises in parallel, but only maxConcurrent at a time.
- * @param promises - Array of promises to run in parallel
- * @param maxConcurrent - Maximum number of promises to run at a time
- * @returns - Promise that resolves when all promises have resolved
- */
-export async function runInParallel(promises, maxConcurrent = 2) {
-    const waitingPromises = [];
-    const wrappedPromises = promises.map((fn) => async () => {
-        await fn();
-        const next = waitingPromises.shift();
-        if (next) {
-            await next();
-        }
-    });
-    const runningPromises = wrappedPromises.slice(0, maxConcurrent);
-    waitingPromises.push(...wrappedPromises.slice(maxConcurrent));
-    return Promise.all(runningPromises.map((p) => p()));
-}
-/**
- * Runs a callback and returns the result or undefined if it throws.
- * @param cb - The callback to run.
- * @returns The result of the callback or undefined if it throws.
- */
-export async function runCbSafely(cb) {
-    try {
-        return await cb();
-    }
-    catch {
-        // All exceptions are ignored.
-    }
-}
 /**
  * The relative path to the static frontend directory.
  */

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AACF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAoC,EACpC,gBAAwB,CAAC;IAEzB,MAAM,eAAe,GAA+B,EAAE,CAAC;IACvD,MAAM,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE;QACtD,MAAM,EAAE,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;QACrC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAChE,eAAe,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IAE9D,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AACD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAwB;IAExB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,QAAQ,CACpD,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,OAAe;IAEf,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAC7D,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AACF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,QAAQ,CACpD,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,OAAe;IAEf,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAC7D,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyberismo/backend",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "Express backend for Cyberismo",
   "main": "dist/index.js",
   "keywords": [],
@@ -9,13 +9,13 @@
   "dependencies": {
     "@asciidoctor/core": "^3.0.4",
     "@hono/node-server": "^1.19.2",
-    "@hono/zod-validator": "^0.7.2",
+    "@hono/zod-validator": "^0.7.5",
     "@types/mime-types": "^3.0.1",
-    "dotenv": "^17.2.2",
-    "hono": "^4.9.7",
-    "mime-types": "^3.0.1",
-    "zod": "^4.1.8",
-    "@cyberismo/data-handler": "0.0.14"
+    "dotenv": "^17.2.3",
+    "hono": "^4.10.6",
+    "mime-types": "^3.0.2",
+    "zod": "^4.1.12",
+    "@cyberismo/data-handler": "0.0.16"
   },
   "devDependencies": {
     "@cyberismo/app": "0.0.2"
@@ -36,7 +36,7 @@
     "debug": "tsx --inspect-brk src/main.ts",
     "export": "pnpm build && node dist/main.js --export",
     "build": "tsc -p tsconfig.build.json && shx rm -rf ./dist/public && shx cp -r ../app/dist ./dist/public",
-    "test": "vitest run",
+    "test": "vitest run --silent",
     "lint": "eslint ."
   }
 }

package/src/app.ts

@@ -26,18 +26,21 @@ import reportsRouter from './domain/reports/index.js';
 import templatesRouter from './domain/templates/index.js';
 import treeRouter from './domain/tree/index.js';
 import workflowsRouter from './domain/workflows/index.js';
+import labelsRouter from './domain/labels/index.js';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
-import { isSSGContext } from './export.js';
 import resourcesRouter from './domain/resources/index.js';
 import logicProgramsRouter from './domain/logicPrograms/index.js';
+import { isSSGContext } from 'hono/ssg';
+import type { AppVars, TreeOptions } from './types.js';
+import treeMiddleware from './middleware/tree.js';
 
 /**
  * Create the Hono app for the backend
  * @param projectPath - Path to the project
  */
-export function createApp(projectPath?: string) {
-  const app = new Hono();
+export function createApp(projectPath?: string, opts?: TreeOptions) {
+  const app = new Hono<{ Variables: AppVars }>();
 
   app.use('/api', cors());
 
@@ -48,6 +51,7 @@ export function createApp(projectPath?: string) {
     }),
   );
 
+  app.use(treeMiddleware(opts));
   // Attach CommandManager to all requests
   app.use(attachCommandManager(projectPath));
 
@@ -65,6 +69,7 @@ export function createApp(projectPath?: string) {
   app.route('/api/workflows', workflowsRouter);
   app.route('/api/resources', resourcesRouter);
   app.route('/api/logicPrograms', logicProgramsRouter);
+  app.route('/api/labels', labelsRouter);
 
   // serve index.html for all other routes
   app.notFound(async (c) => {
@@ -79,7 +84,9 @@ export function createApp(projectPath?: string) {
   // Error handling
   app.onError((err, c) => {
     if (!isSSGContext(c)) {
-      console.error(err.stack);
+      if (process.env.NODE_ENV !== 'test') {
+        console.error(err.stack);
+      }
     }
     return c.json(
       {

package/src/domain/calculations/index.ts

@@ -13,11 +13,7 @@
 
 import { Hono } from 'hono';
 import * as calculationService from './service.js';
-import {
-  createCalculationSchema,
-  updateCalculationParamsSchema,
-  updateCalculationBodySchema,
-} from './schema.js';
+import { createCalculationSchema } from './schema.js';
 import { zValidator } from '../../middleware/zvalidator.js';
 
 const router = new Hono();
@@ -56,66 +52,3 @@ router.post('/', zValidator('json', createCalculationSchema), async (c) => {
 });
 
 export default router;
-/**
- * @swagger
- * /api/calculations/{prefix}/{identifier}:
- *   put:
- *     summary: Update a calculation content
- *     description: Updates the content of a calculation file
- *     parameters:
- *       - in: path
- *         name: prefix
- *         required: true
- *         schema:
- *           type: string
- *         description: Prefix of the calculation
- *       - in: path
- *         name: type
- *         required: true
- *         schema:
- *           type: string
- *         description: Resource type (must be 'calculations')
- *       - in: path
- *         name: identifier
- *         required: true
- *         schema:
- *           type: string
- *         description: Identifier of the calculation
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             properties:
- *               content:
- *                 type: string
- *                 description: New content for the calculation
- *     responses:
- *       200:
- *         description: Calculation updated successfully
- *       400:
- *         description: Invalid request
- *       404:
- *         description: Calculation not found
- *       500:
- *         description: Server error
- */
-router.put(
-  '/:prefix/:type/:identifier',
-  zValidator('param', updateCalculationParamsSchema),
-  zValidator('json', updateCalculationBodySchema),
-  async (c) => {
-    const commands = c.get('commands');
-    const { prefix, identifier } = c.req.valid('param');
-    const { content } = c.req.valid('json');
-
-    await calculationService.updateCalculation(
-      commands,
-      prefix,
-      identifier,
-      content,
-    );
-    return c.json({ message: 'Calculation updated successfully' });
-  },
-);

package/src/domain/calculations/schema.ts

@@ -12,16 +12,7 @@
 */
 
 import { z } from 'zod';
-import { resourceParamsSchema } from '../../common/validationSchemas.js';
 
 export const createCalculationSchema = z.object({
   fileName: z.string().min(1),
 });
-
-export const updateCalculationBodySchema = z.object({
-  content: z.string(),
-});
-
-export const updateCalculationParamsSchema = resourceParamsSchema.extend({
-  type: z.literal('calculations'),
-});

package/src/domain/calculations/service.ts

@@ -12,7 +12,6 @@
 */
 
 import type { CommandManager } from '@cyberismo/data-handler';
-import { resourceName } from '@cyberismo/data-handler';
 
 export async function createCalculation(
   commands: CommandManager,
@@ -20,13 +19,3 @@ export async function createCalculation(
 ) {
   await commands.createCmd.createCalculation(fileName);
 }
-
-export async function updateCalculation(
-  commands: CommandManager,
-  prefix: string,
-  identifier: string,
-  content: string,
-) {
-  const name = resourceName(`${prefix}/calculations/${identifier}`, true);
-  await commands.editCmd.editCalculation(name, content);
-}

package/src/domain/cards/index.ts

@@ -13,9 +13,10 @@
 
 import { type Context, Hono } from 'hono';
 import type { ContentfulStatusCode } from 'hono/utils/http-status';
-import { ssgParams, isSSGContext } from '../../export.js';
 import { getCardDetails } from './lib.js';
 import * as cardService from './service.js';
+import { isSSGContext, ssgParams } from 'hono/ssg';
+import type { AppContext } from '../../types.js';
 
 const router = new Hono();
 
@@ -58,6 +59,12 @@ router.get('/', async (c) => {
  *         in: path
  *         required: true
  *         description: Card key (string)
+ *       - name: raw
+ *         in: query
+ *         required: false
+ *         schema:
+ *           type: boolean
+ *         description: When true, returns the raw card data without triggering calculations
  *     responses:
  *       200:
  *         description: Object containing card details. See lib/api/types.ts/CardResponse for the structure.
@@ -68,10 +75,11 @@ router.get('/', async (c) => {
  */
 router.get(
   '/:key',
-  ssgParams(async (c: Context) => {
+  ssgParams(async (c: AppContext) => {
     const commands = c.get('commands');
-    const cards = await cardService.getAllCards(commands);
-    return cards.map((key) => ({ key }));
+    const opts = c.get('tree');
+    const cards = await cardService.findAllCards(commands, opts);
+    return cards.map((card) => ({ key: card.key }));
   }),
   async (c) => {
     const key = c.req.param('key');
@@ -79,10 +87,13 @@ router.get(
       return c.text('No search key', 400);
     }
 
+    const raw = c.req.query('raw');
+
     const result = await getCardDetails(
       c.get('commands'),
       key,
       isSSGContext(c),
+      raw?.toLowerCase() === 'true' ? true : false,
     );
     if (result.status === 200) {
       return c.json(result.data);
@@ -117,6 +128,12 @@ router.get(
  *         type: object
  *         required: false
  *         description: New metadata for the card. Must be an object with key-value pairs.
+ *       - name: raw
+ *         in: query
+ *         required: false
+ *         schema:
+ *           type: boolean
+ *         description: When true, returns the raw card data without triggering calculations
  *     responses:
  *       200:
  *         description: Object containing card details, same as GET. See definitions.ts/CardDetails for the structure.
@@ -134,10 +151,18 @@ router.patch('/:key', async (c) => {
     return c.text('No search key', 400);
   }
 
+  const raw = c.req.query('raw');
+
   const body = await c.req.json();
 
   try {
-    const result = await cardService.updateCard(commands, key, body);
+    await cardService.updateCard(commands, key, body);
+    const result = await getCardDetails(
+      c.get('commands'),
+      key,
+      isSSGContext(c),
+      raw?.toLowerCase() === 'true' ? true : false,
+    );
     if (result.status === 200) {
       return c.json(result.data);
     } else {
@@ -587,9 +612,9 @@ router.get(
   '/:key/a/:attachment',
   ssgParams(async (c: Context) => {
     const commands = c.get('commands');
-    return await cardService.getAllAttachments(commands);
+    return await cardService.findRelevantAttachments(commands, c.get('tree'));
   }),
-  async (c) => {
+  (c) => {
     const commands = c.get('commands');
     const { key, attachment } = c.req.param();
     const filename = decodeURI(attachment);
@@ -599,7 +624,7 @@ router.get(
     }
 
     try {
-      const attachmentResponse = await cardService.getAttachment(
+      const attachmentResponse = cardService.getAttachment(
         commands,
         key,
         filename,

package/src/domain/cards/lib.ts

@@ -12,13 +12,11 @@
 */
 
 import Processor from '@asciidoctor/core';
-import {
-  type Card,
-  CardLocation,
-  type ProjectFetchCardDetails,
-} from '@cyberismo/data-handler/interfaces/project-interfaces';
+import type { Card } from '@cyberismo/data-handler/interfaces/project-interfaces';
 import { type CommandManager, evaluateMacros } from '@cyberismo/data-handler';
 import { getCardQueryResult } from '../../export.js';
+import type { TreeOptions } from '../../types.js';
+import type { QueryResult } from '@cyberismo/data-handler/types/queries';
 
 interface result {
   status: number;
@@ -29,24 +27,12 @@ interface result {
 export async function getCardDetails(
   commands: CommandManager,
   key: string,
-  staticMode?: boolean,
+  staticMode: boolean,
+  raw: boolean,
 ): Promise<result> {
-  const fetchCardDetails: ProjectFetchCardDetails = {
-    attachments: true,
-    children: false,
-    content: true,
-    contentType: 'adoc',
-    metadata: false,
-    parent: false,
-    location: CardLocation.all,
-  };
-
-  let cardDetailsResponse: Card | undefined;
+  let cardDetailsResponse: Card;
   try {
-    cardDetailsResponse = await commands.showCmd.showCardDetails(
-      fetchCardDetails,
-      key,
-    );
+    cardDetailsResponse = commands.showCmd.showCardDetails(key);
   } catch {
     return { status: 400, message: `Card ${key} not found from project` };
   }
@@ -56,7 +42,7 @@ export async function getCardDetails(
   }
 
   // always parse for now if not in export mode
-  if (!staticMode) {
+  if (!staticMode && !raw) {
     await commands.calculateCmd.generate();
   }
 
@@ -82,6 +68,66 @@ export async function getCardDetails(
     })
     .toString();
 
+  if (raw) {
+    if (!cardDetailsResponse.metadata) {
+      throw new Error('Card has no metadata');
+    }
+    const cardType = await commands.showCmd.showResource(
+      cardDetailsResponse.metadata.cardType,
+      'cardTypes',
+    );
+
+    const fields = [];
+    let i = 0;
+    for (const customField of cardType.customFields) {
+      const fieldType = await commands.showCmd.showResource(
+        customField.name,
+        'fieldTypes',
+      );
+      fields.push({
+        key: customField.name,
+        visibility: 'always',
+        index: i++,
+        fieldDisplayName: fieldType.displayName,
+        fieldDescription: fieldType.description,
+        dataType: fieldType.dataType,
+        isCalculated: customField.isCalculated,
+        value: cardDetailsResponse.metadata[customField.name],
+        enumValues: fieldType.enumValues ?? [],
+      });
+    }
+    return {
+      status: 200,
+      data: {
+        key: cardDetailsResponse.key,
+        rank: cardDetailsResponse.metadata?.rank,
+        title: cardDetailsResponse.metadata?.title || '',
+        cardType: cardDetailsResponse.metadata?.cardType || '',
+        cardTypeDisplayName: cardDetailsResponse.metadata.cardType,
+        workflowState: '',
+        lastUpdated: cardDetailsResponse.metadata.lastUpdated,
+        fields,
+        labels: cardDetailsResponse.metadata?.labels || [],
+        links: [],
+        notifications: [],
+        policyChecks: {
+          successes: [],
+          failures: [],
+        },
+        deniedOperations: {
+          transition: [],
+          move: [],
+          delete: [],
+          editField: [],
+          editContent: [],
+        },
+        rawContent: cardDetailsResponse.content || '',
+        parsedContent: htmlContent,
+        attachments: cardDetailsResponse.attachments,
+      },
+    };
+  }
+
   const card = staticMode
     ? await getCardQueryResult(commands.project.basePath, key)
     : await commands.calculateCmd.runQuery('card', 'localApp', {
@@ -101,3 +147,30 @@ export async function getCardDetails(
     },
   };
 }
+/**
+ * Returns all cards from a tree query, flattened.
+ * @param commands the command manager used for the query
+ * @param options optional tree query options
+ * @returns a promise that resolves to an array of all cards
+ */
+export async function allCards(
+  commands: CommandManager,
+  options?: TreeOptions,
+): Promise<QueryResult<'tree'>[]> {
+  const fetchedCards = await commands.calculateCmd.runQuery(
+    'tree',
+    'exportedSite',
+    options || {},
+  );
+
+  function flattenCards(cards: QueryResult<'tree'>[]): QueryResult<'tree'>[] {
+    return cards.reduce<QueryResult<'tree'>[]>((acc, curr) => {
+      acc.push(curr);
+      if (curr.children && curr.children.length > 0) {
+        acc.push(...flattenCards(curr.children));
+      }
+      return acc;
+    }, []);
+  }
+  return flattenCards(fetchedCards);
+}