@raclettejs/core 0.1.1 → 0.1.3

package/dist/cli.js

@@ -657,7 +657,7 @@ Log process ended with code ${a??0}`))}),s.on("error",a=>{console.error(f.red(`\
 Workbench log process ended with code ${i??0}`))}),o.on("error",i=>{console.error(f.red(`\u274C Error with workbench log process: ${i.message}`)),console.log(f.yellow("\u{1F4A1} Make sure the workbench package has the 'log' script in its package.json"))}),process.on("SIGINT",()=>{console.log(f.yellow(`
 \u{1F6D1} Stopping workbench log following...`)),o.kill("SIGTERM"),process.exit(0)}),t.follow?await new Promise(()=>{}):await new Promise(i=>{o.on("close",()=>i())})}catch(n){throw console.error(f.red(`\u274C Error calling workbench logs: ${n.message}`)),n}}import{spawn as zk}from"child_process";import V from"fs-extra";import H from"path";import{execSync as Mk}from"child_process";import B from"fs-extra";import U from"path";var Bs=async(e,t,r)=>{console.log(f.blue("\u{1F4E6} Creating production artifacts...")),await Vk(t,e,r);let n=U.join(t,"docker-compose.yml");return await Gk(e,t,n,r),await Uk(e,t,r),await Wk(t,r,e),console.log(f.green("\u2705 Production artifacts created")),n},Xd=async(e,t,r,n)=>{let{makeExecutable:o=!1,required:i=!1,logPrefix:s=""}=n||{};for(let a of e){let c=U.join(t,a),l=U.basename(a),u=U.join(r,l);if(await B.ensureDir(U.dirname(u)),await B.pathExists(c))await B.copy(c,u),o&&await B.chmod(u,493),console.log(f.gray(`${s}    \u2705 Copied ${a}`));else{let p=`${a} not found in ${t}`;if(i)throw new Error(`Required file ${p}`);console.log(f.gray(`${s}    \u26A0\uFE0F Skipped ${a} (not found)`))}}},Bk=async(e,t,r)=>Xd(e,process.cwd(),t,{...r,logPrefix:r?.logPrefix||"  "}),Hk=async(e,t,r,n)=>Xd(e,t,r,{...n,logPrefix:n?.logPrefix||"    "}),Vk=async(e,t,r)=>{let n=t.services.frontend?.port||8081,o=t.services.workbench?.frontendPort||8083,i=`
 FROM nginx:alpine
-COPY services/frontend /usr/share/nginx/html
+COPY service/frontend /usr/share/nginx/html
 COPY nginx.conf /etc/nginx/conf.d/default.conf
 COPY entrypoint.sh entrypoint.sh
 
@@ -681,14 +681,14 @@ WORKDIR /app
 RUN apk add --no-cache tini curl ${(t.services.backend?.installPackages||[]).join(" ")}
 
 # Copy package files first for better caching
-COPY services/backend/package*.json ./
-COPY services/backend/yarn.lock* ./
+COPY service/backend/package*.json ./
+COPY service/backend/yarn.lock* ./
 
 # Install only production dependencies
 RUN yarn install --production --frozen-lockfile --silent
 
 # Copy the built application (includes dist/ folder)
-COPY services/backend/ ./
+COPY service/backend/ ./
 
 # Create non-root user for security
 RUN addgroup -g 1001 -S nodejs && \\
@@ -1107,7 +1107,7 @@ ${n?`- Workbench: http://localhost:${i}`:""}
 - Ports ${o}${n?`, ${i}`:""} available
 
 Generated on: ${new Date().toISOString()}
-`;await B.writeFile(U.join(e,"README.md"),s)},Jd=async(e,t,r,n,o)=>{console.log(f.blue("\u{1F4E6} Packaging images for distribution..."));let i=U.join(t,"..","package"),s=`${e.name}-deployment-${n}`,a=U.join(i,`${s}.tar.gz`);await B.ensureDir(i),await B.emptyDir(i);let c=U.join(i,s);await B.ensureDir(c);try{console.log(f.gray("  \u{1F4BE} Exporting Docker images..."));let l=U.join(c,"images");await B.ensureDir(l);for(let p of r){let d=`${p.replace(/[:/]/g,"_")}.tar`,g=U.join(l,d);console.log(f.gray(`    \u{1F4E6} Exporting ${p}...`)),ce(["save","-o",g,p],{stdio:"pipe"});let m=await B.stat(g);if(m.size===0)throw new Error(`Failed to export image ${p}`);console.log(f.gray(`    \u2705 Exported ${p} (${(m.size/1024/1024).toFixed(1)}MB)`))}console.log(f.gray("  \u{1F4C4} Copying deployment files..."));let u=["docker-compose.yml",".env.example","deploy.sh","nginx.conf"];return o&&u.push("nginx.workbench.conf"),await Hk(u,t,c,{required:!1,logPrefix:"    "}),await qk(c,r,o,e),await Yk(c,r),await Kk(c,e,r,o),console.log(f.gray("  \u{1F5DC}\uFE0F  Creating deployment package...")),await Xk(c,a),await B.remove(c),console.log(f.green(`  \u2705 Deployment package created: ${s}.tar.gz`)),{packagePath:a,imageNames:r}}catch(l){throw await B.remove(c).catch(()=>{}),l}},Xk=async(e,t)=>{let r=U.dirname(e),n=U.basename(e);Mk(`tar -czf "${t}" -C "${r}" "${n}"`,{stdio:"pipe"});let o=await B.stat(t);console.log(f.gray(`    \u{1F4E6} Package size: ${(o.size/1024/1024).toFixed(1)}MB`))};var Zd=async(e,t,r={})=>{let n=Date.now(),o=Qk(r);console.log(f.blue(`\u{1F9C0} Starting Raclette ${o} build...`)),Vr();let i=H.join(process.cwd(),".raclette"),s=H.resolve(r.outputDir||H.join(i,".build"));await V.ensureDir(s),await V.emptyDir(s);try{await ix(e,t,i),await sx(e,t,i);let a={mode:o,buildDir:s,artifacts:{}};switch(o){case"artifacts":a=await Jk(e,i,s,r);break;case"images":a=await ef(e,i,s,r);break;case"package":a=await Zk(e,i,s,r);break}let c=(Date.now()-n)/1e3;return h.success(` ${o} build completed in ${c}s`),ox(a,e),a}catch(a){throw h.error(`${o} build failed: ${a.message}`),a}},Qk=e=>e.mode?e.mode:e.packageImages?"package":e.buildImages?"images":(e.buildOnly,"artifacts"),Jk=async(e,t,r,n)=>{if(n.buildOnly){console.log(f.blue("\u{1F4C1} Building application files only...")),await Vs(e,t,r,n);let i=await Gs(e,r,n);return console.log(f.green("\u2705 Build files ready")),{mode:"artifacts",buildDir:r,artifacts:{}}}else{console.log(f.blue("\u{1F4C1} Building local deployment artifacts..."));let i=H.join(r,"app");await Vs(e,t,i,n);let s=await Gs(e,r,n),a=await Bs(e,r,s),c=await nx(e,r,s);return console.log(f.green("\u2705 Local deployment artifacts ready")),{mode:"artifacts",buildDir:r,artifacts:{composeFile:a,deployScript:H.join(r,"deploy.sh"),readmeFile:c,envExampleFile:H.join(r,".env.example")}}}},ef=async(e,t,r,n)=>{console.log(f.blue("\u{1F433} Building Docker images for CI/CD..."));let o=H.join(r,"app");await Vs(e,t,o,n);let i=await Gs(e,r,n);await Bs(e,r,i);let s=await ex(e,r,i,n);return console.log(f.green("\u2705 Docker images ready for registry push")),{mode:"images",buildDir:r,images:s,artifacts:{}}},Zk=async(e,t,r,n)=>{console.log(f.blue("\u{1F4E6} Building offline deployment package..."));let o=await ef(e,t,r,n),i=tf(),s=await Jd(e,r,o.images.names,i,o.images.names.some(a=>a.includes("workbench")));return console.log(f.green("\u2705 Offline deployment package ready")),{...o,mode:"package",deploymentPackage:s.packagePath}},ex=async(e,t,r,n)=>{let o=n.imagePrefix||e.name,i=n.imageTag||tf(),s=n.platforms||"linux/amd64,linux/arm64",a=n.buildx||!1,c=[],l=[i];if(n.generateLatest&&!l.includes("latest")&&l.push("latest"),a)try{await tx(),console.log(f.blue(`\u{1F3D7}\uFE0F  Building multi-architecture images for: ${s}`))}catch(u){console.warn(f.yellow("\u26A0\uFE0F  Buildx not available, falling back to single-architecture builds")),console.warn(f.yellow(`   ${u.message}`)),a=!1}if(a){let u=["frontend","backend"];r&&u.push("workbench-frontend","workbench-backend");for(let p of u){let d=`${o}/${p}`,g=H.join(t,`Dockerfile.${p}`);if(!await V.pathExists(g))throw new Error(`Dockerfile not found: ${g}`);let m=l.map(y=>`${d}:${y}`);c.push(...m),await rx({context:t,dockerfile:g,tags:m,platforms:s,push:!1,noCache:n.noCache,verbose:n.verbose}),console.log(f.gray(`    \u2705 Built ${p} for ${s}`)),m.forEach(y=>{console.log(f.gray(`       ${y}`))})}}else{console.log(f.gray("  \u{1F528} Building single-architecture images..."));let p=["-f",H.join(t,"docker-compose.yml"),"build"];n.noCache&&p.push("--no-cache"),ye(p,{stdio:n.verbose?"inherit":"pipe",cwd:t});let d=["frontend","backend"];r&&d.push("workbench-frontend","workbench-backend");for(let g of d){let m=`${H.basename(t)}-${g}`.replace(/\./,""),y=`${o}/${g}`;l.forEach(k=>{let R=`${y}:${k}`;ce(["tag",m,R],{stdio:"pipe"}),c.push(R)}),console.log(f.gray(`    \u2705 Tagged ${g}`))}}return console.log(f.green("  \u2705 Docker images built and tagged")),{names:c,tags:l}},tx=async()=>{try{ce(["buildx","version"],{stdio:"pipe"}),console.log(f.gray("  \u{1F4E6} Setting up QEMU for cross-platform emulation...")),ce(["run","--rm","--privileged","multiarch/qemu-user-static","--reset","-p","yes"],{stdio:"pipe"}),console.log(f.gray("  \u{1F4E6} Creating buildx builder...")),ce(["buildx","create","--name","multiarch","--use"],{stdio:"pipe"}),ce(["buildx","inspect","--bootstrap"],{stdio:"pipe"}),console.log(f.gray("  \u2705 Buildx builder ready with QEMU emulation"))}catch(e){throw console.warn(f.yellow("  \u26A0\uFE0F  Buildx setup failed, falling back to single-architecture builds")),console.warn(f.yellow(`     ${e.message}`)),new Error("Buildx not available - use single-architecture builds instead")}},rx=async e=>{let t=["buildx","build","--platform",e.platforms,"--file",e.dockerfile];e.tags.forEach(n=>{t.push("--tag",n)});let r=e.platforms.split(",").length;e.push?t.push("--push"):r===1?t.push("--load"):(console.log(f.yellow("    \u26A0\uFE0F  Multi-platform images cannot be loaded locally")),console.log(f.yellow("    \u2139\uFE0F  Images built but not loaded to local Docker"))),e.noCache&&t.push("--no-cache"),t.push(e.context);try{ce(t,{stdio:e.verbose?"inherit":"pipe",cwd:e.context})}catch(n){throw new Error(`Failed to build multi-architecture image: ${n}`)}},nx=async(e,t,r)=>{let n=H.join(t,"README.md"),o=e.services.frontend?.port||8081,i=e.services.workbench?.frontendPort||8083,s=`# ${e.name} - Local Deployment
+`;await B.writeFile(U.join(e,"README.md"),s)},Jd=async(e,t,r,n,o)=>{console.log(f.blue("\u{1F4E6} Packaging images for distribution..."));let i=U.join(t,"..","package"),s=`${e.name}-deployment-${n}`,a=U.join(i,`${s}.tar.gz`);await B.ensureDir(i),await B.emptyDir(i);let c=U.join(i,s);await B.ensureDir(c);try{console.log(f.gray("  \u{1F4BE} Exporting Docker images..."));let l=U.join(c,"images");await B.ensureDir(l);for(let p of r){let d=`${p.replace(/[:/]/g,"_")}.tar`,g=U.join(l,d);console.log(f.gray(`    \u{1F4E6} Exporting ${p}...`)),ce(["save","-o",g,p],{stdio:"pipe"});let m=await B.stat(g);if(m.size===0)throw new Error(`Failed to export image ${p}`);console.log(f.gray(`    \u2705 Exported ${p} (${(m.size/1024/1024).toFixed(1)}MB)`))}console.log(f.gray("  \u{1F4C4} Copying deployment files..."));let u=["docker-compose.yml",".env.example","deploy.sh","nginx.conf"];return o&&u.push("nginx.workbench.conf"),await Hk(u,t,c,{required:!1,logPrefix:"    "}),await qk(c,r,o,e),await Yk(c,r),await Kk(c,e,r,o),console.log(f.gray("  \u{1F5DC}\uFE0F  Creating deployment package...")),await Xk(c,a),await B.remove(c),console.log(f.green(`  \u2705 Deployment package created: ${s}.tar.gz`)),{packagePath:a,imageNames:r}}catch(l){throw await B.remove(c).catch(()=>{}),l}},Xk=async(e,t)=>{let r=U.dirname(e),n=U.basename(e);Mk(`tar -czf "${t}" -C "${r}" "${n}"`,{stdio:"pipe"});let o=await B.stat(t);console.log(f.gray(`    \u{1F4E6} Package size: ${(o.size/1024/1024).toFixed(1)}MB`))};var Zd=async(e,t,r={})=>{let n=Date.now(),o=Qk(r);console.log(f.blue(`\u{1F9C0} Starting Raclette ${o} build...`)),Vr();let i=H.join(process.cwd(),".raclette"),s=H.resolve(r.outputDir||H.join(i,".build"));await V.ensureDir(s),await V.emptyDir(s);try{await ix(e,t,i),await sx(e,t,i);let a={mode:o,buildDir:s,artifacts:{}};switch(o){case"artifacts":a=await Jk(e,i,s,r);break;case"images":a=await ef(e,i,s,r);break;case"package":a=await Zk(e,i,s,r);break}let c=(Date.now()-n)/1e3;return h.success(` ${o} build completed in ${c}s`),ox(a,e),a}catch(a){throw h.error(`${o} build failed: ${a.message}`),a}},Qk=e=>e.mode?e.mode:e.packageImages?"package":e.buildImages?"images":(e.buildOnly,"artifacts"),Jk=async(e,t,r,n)=>{if(n.buildOnly){console.log(f.blue("\u{1F4C1} Building application files only...")),await Vs(e,t,r,n);let i=await Gs(e,r,n);return console.log(f.green("\u2705 Build files ready")),{mode:"artifacts",buildDir:r,artifacts:{}}}else{console.log(f.blue("\u{1F4C1} Building local deployment artifacts..."));let i=H.join(r,"service");await Vs(e,t,i,n);let s=await Gs(e,r,n),a=await Bs(e,r,s),c=await nx(e,r,s);return console.log(f.green("\u2705 Local deployment artifacts ready")),{mode:"artifacts",buildDir:r,artifacts:{composeFile:a,deployScript:H.join(r,"deploy.sh"),readmeFile:c,envExampleFile:H.join(r,".env.example")}}}},ef=async(e,t,r,n)=>{console.log(f.blue("\u{1F433} Building Docker images for CI/CD..."));let o=H.join(r,"service");await Vs(e,t,o,n);let i=await Gs(e,r,n);await Bs(e,r,i);let s=await ex(e,r,i,n);return console.log(f.green("\u2705 Docker images ready for registry push")),{mode:"images",buildDir:r,images:s,artifacts:{}}},Zk=async(e,t,r,n)=>{console.log(f.blue("\u{1F4E6} Building offline deployment package..."));let o=await ef(e,t,r,n),i=tf(),s=await Jd(e,r,o.images.names,i,o.images.names.some(a=>a.includes("workbench")));return console.log(f.green("\u2705 Offline deployment package ready")),{...o,mode:"package",deploymentPackage:s.packagePath}},ex=async(e,t,r,n)=>{let o=n.imagePrefix||e.name,i=n.imageTag||tf(),s=n.platforms||"linux/amd64,linux/arm64",a=n.buildx||!1,c=[],l=[i];if(n.generateLatest&&!l.includes("latest")&&l.push("latest"),a)try{await tx(),console.log(f.blue(`\u{1F3D7}\uFE0F  Building multi-architecture images for: ${s}`))}catch(u){console.warn(f.yellow("\u26A0\uFE0F  Buildx not available, falling back to single-architecture builds")),console.warn(f.yellow(`   ${u.message}`)),a=!1}if(a){let u=["frontend","backend"];r&&u.push("workbench-frontend","workbench-backend");for(let p of u){let d=`${o}/${p}`,g=H.join(t,`Dockerfile.${p}`);if(!await V.pathExists(g))throw new Error(`Dockerfile not found: ${g}`);let m=l.map(y=>`${d}:${y}`);c.push(...m),await rx({context:t,dockerfile:g,tags:m,platforms:s,push:!1,noCache:n.noCache,verbose:n.verbose}),console.log(f.gray(`    \u2705 Built ${p} for ${s}`)),m.forEach(y=>{console.log(f.gray(`       ${y}`))})}}else{console.log(f.gray("  \u{1F528} Building single-architecture images..."));let p=["-f",H.join(t,"docker-compose.yml"),"build"];n.noCache&&p.push("--no-cache"),ye(p,{stdio:n.verbose?"inherit":"pipe",cwd:t});let d=["frontend","backend"];r&&d.push("workbench-frontend","workbench-backend");for(let g of d){let m=`${H.basename(t)}-${g}`.replace(/\./,""),y=`${o}/${g}`;l.forEach(k=>{let R=`${y}:${k}`;ce(["tag",m,R],{stdio:"pipe"}),c.push(R)}),console.log(f.gray(`    \u2705 Tagged ${g}`))}}return console.log(f.green("  \u2705 Docker images built and tagged")),{names:c,tags:l}},tx=async()=>{try{ce(["buildx","version"],{stdio:"pipe"}),console.log(f.gray("  \u{1F4E6} Setting up QEMU for cross-platform emulation...")),ce(["run","--rm","--privileged","multiarch/qemu-user-static","--reset","-p","yes"],{stdio:"pipe"}),console.log(f.gray("  \u{1F4E6} Creating buildx builder...")),ce(["buildx","create","--name","multiarch","--use"],{stdio:"pipe"}),ce(["buildx","inspect","--bootstrap"],{stdio:"pipe"}),console.log(f.gray("  \u2705 Buildx builder ready with QEMU emulation"))}catch(e){throw console.warn(f.yellow("  \u26A0\uFE0F  Buildx setup failed, falling back to single-architecture builds")),console.warn(f.yellow(`     ${e.message}`)),new Error("Buildx not available - use single-architecture builds instead")}},rx=async e=>{let t=["buildx","build","--platform",e.platforms,"--file",e.dockerfile];e.tags.forEach(n=>{t.push("--tag",n)});let r=e.platforms.split(",").length;e.push?t.push("--push"):r===1?t.push("--load"):(console.log(f.yellow("    \u26A0\uFE0F  Multi-platform images cannot be loaded locally")),console.log(f.yellow("    \u2139\uFE0F  Images built but not loaded to local Docker"))),e.noCache&&t.push("--no-cache"),t.push(e.context);try{ce(t,{stdio:e.verbose?"inherit":"pipe",cwd:e.context})}catch(n){throw new Error(`Failed to build multi-architecture image: ${n}`)}},nx=async(e,t,r)=>{let n=H.join(t,"README.md"),o=e.services.frontend?.port||8081,i=e.services.workbench?.frontendPort||8083,s=`# ${e.name} - Local Deployment
 
 This build contains everything needed to deploy ${e.name} locally using Docker.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raclettejs/core",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "racletteJS core package",
   "repository": "https://gitlab.com/raclettejs/core",
   "author": "Pacifico Digital Explorations GmbH <info@raclettejs.com>",

package/services/backend/src/core/crud/crudTypes.ts

@@ -1,22 +1,22 @@
-import type { ClientPayloadRequestData } from "../payload/payloadTypes"
+import type { FrontendPayloadRequestData } from "../payload/payloadTypes"
 import type { FastifyInstance } from "fastify"
 
 export interface CrudHandlers<T> {
   create: (
     fastify: FastifyInstance,
-    requestParams: ClientPayloadRequestData,
+    requestParams: FrontendPayloadRequestData,
     data: Partial<T>,
     userId: string,
     broadcast?: boolean,
   ) => Promise<any>
   read: (
     fastify: FastifyInstance,
-    requestParams: ClientPayloadRequestData,
+    requestParams: FrontendPayloadRequestData,
     id: string,
   ) => Promise<any>
   update: (
     fastify: FastifyInstance,
-    requestParams: ClientPayloadRequestData,
+    requestParams: FrontendPayloadRequestData,
     id: string,
     data: Partial<T>,
     userId: string,
@@ -24,7 +24,7 @@ export interface CrudHandlers<T> {
   ) => Promise<any>
   delete: (
     fastify: FastifyInstance,
-    requestParams: ClientPayloadRequestData,
+    requestParams: FrontendPayloadRequestData,
     id: string,
     userId: string,
     broadcast?: boolean,

package/services/backend/src/core/payload/payloadRegistrar.ts

@@ -1,7 +1,7 @@
 import type {
-  ClientPayloadRequestData,
-  ClientPayload,
-  ClientPayloadBody,
+  FrontendPayloadRequestData,
+  FrontendPayload,
+  FrontendPayloadBody,
 } from "@c/payload/payloadTypes"
 
 // Required fields that must exist on payload item
@@ -49,7 +49,7 @@ interface PayloadHandlerConfig<T extends object, TMeta = any> {
   sanitize?: (item: T) => Partial<T>
   fields?: (
     item: T,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
   ) => RequiredMappings<T> & OptionalPayloadFields
   createMeta?: (item: T) => Promise<TMeta> | TMeta
   beforePayload?: (item: T) => Promise<T> | T
@@ -94,9 +94,9 @@ export const registerPayloadHandler = <T extends object, TMeta = any>(
 export const createPayloadBody = async <T extends object>(
   type: string,
   item: DataItem<T>,
-  requestData: ClientPayloadRequestData,
+  requestData: FrontendPayloadRequestData,
   scope = "core",
-): Promise<ClientPayloadBody<T>> => {
+): Promise<FrontendPayloadBody<T>> => {
   // Check if the scope exists
   if (!handlers[scope]) {
     throw new Error(`No scope registered with name "${scope}"`)
@@ -124,7 +124,7 @@ export const createPayloadBody = async <T extends object>(
     plainItem = await handler.beforePayload(plainItem)
   }
 
-  const basePayload: Partial<ClientPayloadBody<T>> = {
+  const basePayload: Partial<FrontendPayloadBody<T>> = {
     _id: fields._id ?? (plainItem as any)._id ?? "",
     _type: handler.type,
     _offline: 0,
@@ -141,16 +141,16 @@ export const createPayloadBody = async <T extends object>(
     _meta: meta,
   }
 
-  return basePayload as ClientPayloadBody<T>
+  return basePayload as FrontendPayloadBody<T>
 }
 
 // New function to process multiple items of the same type
 export const createPayloadBodies = async <T extends object>(
   type: string,
   items: DataItem<T>[],
-  requestData: ClientPayloadRequestData,
+  requestData: FrontendPayloadRequestData,
   scope = "core",
-): Promise<ClientPayloadBody<T>[]> => {
+): Promise<FrontendPayloadBody<T>[]> => {
   return await Promise.all(
     items.map((item) => createPayloadBody(type, item, requestData, scope)),
   )
@@ -160,9 +160,9 @@ export const createPayloadBodies = async <T extends object>(
 export const createPayload = async <T extends object>(
   type: string,
   items: DataItem<T> | DataItem<T>[],
-  requestData: ClientPayloadRequestData,
+  requestData: FrontendPayloadRequestData,
   scope = "core",
-): Promise<ClientPayload<T[]>> => {
+): Promise<FrontendPayload<T[]>> => {
   // Convert single item to array if needed
   const itemsArray = Array.isArray(items) ? items : [items]
 
@@ -188,9 +188,9 @@ export const createMultiTypePayload = async <T extends object>(
     items: DataItem<T> | DataItem<T>[]
     scope?: string
   }[],
-  requestData: ClientPayloadRequestData,
-): Promise<ClientPayload<T>> => {
-  const allItems: ClientPayloadBody<T>[] = []
+  requestData: FrontendPayloadRequestData,
+): Promise<FrontendPayload<T>> => {
+  const allItems: FrontendPayloadBody<T>[] = []
 
   // Process each type group
   await Promise.all(

package/services/backend/src/core/payload/payloadTypes.ts

@@ -1,4 +1,4 @@
-export type ClientPayloadRequestData = {
+export type FrontendPayloadRequestData = {
   appSessionId: string
   requestId: string
   appRequestCode: string
@@ -10,7 +10,7 @@ export type ClientPayloadRequestData = {
   userId?: string
 }
 
-export type ClientPayloadBody<T> = {
+export type FrontendPayloadBody<T> = {
   _id: string
   _type: string
   _offline: number
@@ -29,7 +29,7 @@ export type ClientPayloadBody<T> = {
 export type FileType = File | { [x: string]: any }
 
 export type BodyContent<T> = {
-  items: ClientPayloadBody<T>[]
+  items: FrontendPayloadBody<T>[]
   hits?: any
   prevVersion?: any
   deleted?: string[]
@@ -39,6 +39,6 @@ export type BodyContent<T> = {
   oldParent?: T
 }
 
-export type ClientPayload<T> = ClientPayloadRequestData & {
+export type FrontendPayload<T> = FrontendPayloadRequestData & {
   body: BodyContent<T>
 }

package/services/backend/src/core/pluginSystem/pluginFastifyInstance.ts

@@ -1,8 +1,8 @@
 import type { FastifyInstance } from "fastify"
 import type { Schema, Model, Document } from "mongoose"
 import type {
-  ClientPayload,
-  ClientPayloadRequestData,
+  FrontendPayload,
+  FrontendPayloadRequestData,
   HttpService,
   PluginSchemaDefinition,
   IntervalTaskOptions,
@@ -20,6 +20,7 @@ import { registerPluginForFrontendGeneration } from "@c/pluginSystem/configGener
 import { registerSchemaDefinition } from "@c/validation/schemaGenerator"
 import type { PluginContract } from "@c/contracting/contractTypes"
 import { registerPluginContract } from "@c/contracting/contractRegistrar"
+import configService from "@c/config/configService"
 
 const EVENT_WHITELIST = [
   "broadcastDataUpdated",
@@ -42,7 +43,9 @@ export const createPluginFastifyInstance = (
 
   const pluginCacheService = createCacheService(fastify.cache, {
     prefix: pluginOptions.key,
-    defaultTtl: 3600, // Default 60 minutes TTL for plugins -> TODO: should be a raclette.config option
+    // Default 60 minutes TTL for plugins -> TODO: should be a raclette.config option
+    // do we want this per-plugin? probably not, global is ok
+    defaultTtl: configService.getConfig()?.backend?.cacheTTL ?? -1,
   })
 
   const instance: PluginFastifyInstance = {
@@ -166,9 +169,9 @@ export const createPluginFastifyInstance = (
     createPayload: <T extends object>(
       name: string,
       item: T,
-      requestData: ClientPayloadRequestData,
+      requestData: FrontendPayloadRequestData,
       scope?: string,
-    ): Promise<ClientPayload<T[]>> => {
+    ): Promise<FrontendPayload<T[]>> => {
       const prefixedName = `${pluginOptions.key}--${name}`
 
       return createPayload<T>(

package/services/backend/src/core/pluginSystem/pluginTypes.ts

@@ -7,8 +7,8 @@ import type {
   HttpService,
   IntervalTaskOptions,
   CrudHandlers,
-  ClientPayloadRequestData,
-  ClientPayload,
+  FrontendPayloadRequestData,
+  FrontendPayload,
   CacheService,
 } from "@/types"
 import type { EventEmitter } from "stream"
@@ -65,8 +65,8 @@ export type PluginFastifyInstance = {
   createPayload: <T extends object>(
     name: string,
     item: T,
-    requestData: ClientPayloadRequestData,
-  ) => Promise<ClientPayload<T>>
+    requestData: FrontendPayloadRequestData,
+  ) => Promise<FrontendPayload<T>>
   /* CONNECTION */
   registerSocket: (eventName: string, handler: Listener) => void
   emit: (eventName: string, data: unknown) => void

package/services/backend/src/core/sockets/createSystemEventHandlers.ts

@@ -1,11 +1,11 @@
 import type { Project, Tag, Composition, InteractionLink } from "@/shared/types"
-import type { ClientPayload } from "@/types"
+import type { FrontendPayload } from "@/types"
 import type { FastifyInstance } from "fastify"
 
 export const createSystemEventHandlers = (fastify: FastifyInstance) => {
   const { wss } = fastify
 
-  const sendToChannel = (payload: ClientPayload<unknown>, key: string) => {
+  const sendToChannel = (payload: FrontendPayload<unknown>, key: string) => {
     // TODO rework this to handle spaces instead of project and in the future document rooms -> y.js?
     if (payload.project) {
       wss.in(payload.project).emit(key, payload)
@@ -15,20 +15,20 @@ export const createSystemEventHandlers = (fastify: FastifyInstance) => {
   }
 
   return {
-    broadcastDataUpdatedHandler: (payload: ClientPayload<unknown>): void => {
+    broadcastDataUpdatedHandler: (payload: FrontendPayload<unknown>): void => {
       fastify.log.info(`[Socket] Push onData: ${payload.appSessionId}`)
       sendToChannel(payload, "data")
     },
-    broadcastDataCreatedHandler: (payload: ClientPayload<unknown>): void => {
+    broadcastDataCreatedHandler: (payload: FrontendPayload<unknown>): void => {
       fastify.log.info(`[Socket] Push onCreate: ${payload.appSessionId}`)
       sendToChannel(payload, "dataCreated")
     },
-    broadcastDataDeletedHandler: (payload: ClientPayload<unknown>): void => {
+    broadcastDataDeletedHandler: (payload: FrontendPayload<unknown>): void => {
       fastify.log.info(`[Socket] Push onDelete: ${payload.appSessionId}`)
       sendToChannel(payload, "dataDeleted")
     },
     broadcastCompositionCreated: (
-      payload: ClientPayload<Composition>,
+      payload: FrontendPayload<Composition>,
     ): void => {
       fastify.log.info(
         `[Socket] Push CompositionCreated: ${payload.appSessionId}`,
@@ -37,7 +37,7 @@ export const createSystemEventHandlers = (fastify: FastifyInstance) => {
     },
 
     broadcastCompositionDeleted: (
-      payload: ClientPayload<Composition>,
+      payload: FrontendPayload<Composition>,
     ): void => {
       fastify.log.info(
         `[Socket] Push CompositionDeleted: ${payload.appSessionId}`,
@@ -45,7 +45,7 @@ export const createSystemEventHandlers = (fastify: FastifyInstance) => {
       sendToChannel(payload, "compositionDeleted")
     },
     broadcastInteractionLinkCreated: (
-      payload: ClientPayload<InteractionLink>,
+      payload: FrontendPayload<InteractionLink>,
     ): void => {
       fastify.log.info(
         `[Socket] Push InteractionLinkCreated: ${payload.appSessionId}`,
@@ -54,44 +54,46 @@ export const createSystemEventHandlers = (fastify: FastifyInstance) => {
     },
 
     broadcastInteractionLinkDeleted: (
-      payload: ClientPayload<InteractionLink>,
+      payload: FrontendPayload<InteractionLink>,
     ): void => {
       fastify.log.info(
         `[Socket] Push InteractionLinkDeleted: ${payload.appSessionId}`,
       )
       sendToChannel(payload, "interactionLinkDeleted")
     },
-    broadcastTagCreated: (payload: ClientPayload<Tag>): void => {
+    broadcastTagCreated: (payload: FrontendPayload<Tag>): void => {
       fastify.log.info(`[Socket] Push tagCreated: ${payload.appSessionId}`)
       sendToChannel(payload, "tagCreated")
     },
 
-    broadcastTagDeleted: (payload: ClientPayload<Tag>): void => {
+    broadcastTagDeleted: (payload: FrontendPayload<Tag>): void => {
       fastify.log.info(`[Socket] Push tagDeleted: ${payload.appSessionId}`)
       sendToChannel(payload, "tagDeleted")
     },
 
-    broadcastUserCreated: (payload: ClientPayload<Tag>): void => {
+    broadcastUserCreated: (payload: FrontendPayload<Tag>): void => {
       fastify.log.info(`[Socket] Push userCreated: ${payload.appSessionId}`)
       sendToChannel(payload, "userCreated")
     },
 
-    broadcastUserDeleted: (payload: ClientPayload<Tag>): void => {
+    broadcastUserDeleted: (payload: FrontendPayload<Tag>): void => {
       fastify.log.info(`[Socket] Push userDeleted: ${payload.appSessionId}`)
       sendToChannel(payload, "userDeleted")
     },
 
-    broadcastProjectCreated: (payload: ClientPayload<Project>): void => {
+    broadcastProjectCreated: (payload: FrontendPayload<Project>): void => {
       fastify.log.info(`[Socket] Push projectCreated: ${payload.appSessionId}`)
       sendToChannel(payload, "projectCreated")
     },
 
-    broadcastProjectUpdated: (payload: ClientPayload<Project>): void => {
+    broadcastProjectUpdated: (payload: FrontendPayload<Project>): void => {
       fastify.log.info(`[Socket] Push projectUpdated: ${payload.appSessionId}`)
       sendToChannel(payload, "projectUpdated")
     },
 
-    broadcastProjectConfigUpdated: (payload: ClientPayload<Project>): void => {
+    broadcastProjectConfigUpdated: (
+      payload: FrontendPayload<Project>,
+    ): void => {
       fastify.log.info(`[Socket] Push projectDeleted: ${payload.appSessionId}`)
       sendToChannel(payload, "projectDeleted")
     },

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/account/account.service.ts

@@ -1,7 +1,7 @@
 import type { Account as AccountType } from "./account.schema"
 import type {
-  ClientPayload,
-  ClientPayloadRequestData,
+  FrontendPayload,
+  FrontendPayloadRequestData,
 } from "@c/payload/payloadTypes"
 import type { PluginFastifyInstance } from "types"
 import { v4 as uuidv4, validate } from "uuid"
@@ -65,10 +65,10 @@ export class AccountService {
    */
   async createAccount(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     accountBody: AccountBody,
     userId: string,
-  ): Promise<ClientPayload<AccountType[]>> {
+  ): Promise<FrontendPayload<AccountType[]>> {
     const account = await this._createAccount(fastify, accountBody, userId)
 
     const payload = await createAccountPayload(fastify, [account], requestData)
@@ -97,8 +97,8 @@ export class AccountService {
    */
   async readAccounts(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
-  ): Promise<ClientPayload<AccountType[]>> {
+    requestData: FrontendPayloadRequestData,
+  ): Promise<FrontendPayload<AccountType[]>> {
     const accounts = await this._readAccounts(fastify)
 
     return createAccountPayload(fastify, accounts, requestData)
@@ -130,9 +130,9 @@ export class AccountService {
    */
   async readAccount(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
-  ): Promise<ClientPayload<AccountType[]>> {
+  ): Promise<FrontendPayload<AccountType[]>> {
     const account = await this._readAccount(fastify, id)
 
     return createAccountPayload(fastify, [account], requestData)
@@ -191,11 +191,11 @@ export class AccountService {
    */
   async updateAccount(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
     accountBody: AccountBody,
     userId: string,
-  ): Promise<ClientPayload<AccountType[]>> {
+  ): Promise<FrontendPayload<AccountType[]>> {
     const { updated, original } = await this._updateAccount(
       fastify,
       id,
@@ -242,9 +242,9 @@ export class AccountService {
    */
   async removeAccount(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
-  ): Promise<ClientPayload<AccountType[]>> {
+  ): Promise<FrontendPayload<AccountType[]>> {
     const account = await this._removeAccount(fastify, id)
 
     const payload = await createAccountPayload(fastify, [account], {
@@ -291,9 +291,9 @@ export class AccountService {
    */
   async hardDeleteAccount(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
-  ): Promise<ClientPayload<AccountType[]>> {
+  ): Promise<FrontendPayload<AccountType[]>> {
     const account = await this._hardDeleteAccount(fastify, id)
 
     const payload = await createAccountPayload(fastify, [account], {
@@ -355,11 +355,11 @@ export class AccountService {
    */
   async toggleBlockAccount(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
     blocked: boolean,
     userId: string,
-  ): Promise<ClientPayload<AccountType[]>> {
+  ): Promise<FrontendPayload<AccountType[]>> {
     const { updated, original } = await this._toggleBlockAccount(
       fastify,
       id,

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/account/events/index.ts

@@ -1,12 +1,12 @@
 import { type FastifyInstance } from "fastify"
 import { type AnyAccount } from "../account.schema"
-import { type ClientPayload } from "@c/payload/payloadTypes"
+import { type FrontendPayload } from "@c/payload/payloadTypes"
 
 const registerEvents = (fastify: FastifyInstance) => {
   /**
    * Account created
    */
-  const created = (payload: ClientPayload<AnyAccount>) => {
+  const created = (payload: FrontendPayload<AnyAccount>) => {
     fastify.eventbus.emit("broadcastDataUpdated", payload)
     fastify.eventbus.emit("broadcastAccountCreated", payload)
     fastify.log.info(
@@ -17,7 +17,7 @@ const registerEvents = (fastify: FastifyInstance) => {
   /**
    * Account updated
    */
-  const updated = (payload: ClientPayload<AnyAccount>) => {
+  const updated = (payload: FrontendPayload<AnyAccount>) => {
     fastify.eventbus.emit("broadcastDataUpdated", payload)
     fastify.log.info(
       `[eventbus] account broadcast updated ${payload.appSessionId}`,
@@ -27,7 +27,7 @@ const registerEvents = (fastify: FastifyInstance) => {
   /**
    * Account deleted
    */
-  const deleted = (payload: ClientPayload<AnyAccount>) => {
+  const deleted = (payload: FrontendPayload<AnyAccount>) => {
     fastify.eventbus.emit("broadcastAccountDeleted", payload)
     fastify.log.info(
       `[eventbus] account broadcast deleted ${payload.appSessionId}`,

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/account/helpers/payload.ts

@@ -1,5 +1,5 @@
 import type { Account } from "../account.schema"
-import type { ClientPayloadRequestData, PluginFastifyInstance } from "@/types"
+import type { FrontendPayloadRequestData, PluginFastifyInstance } from "@/types"
 
 export const registerPayload = (fastify: PluginFastifyInstance) => {
   fastify.registerPayloadHandler<Account>("account", {
@@ -17,5 +17,5 @@ export const registerPayload = (fastify: PluginFastifyInstance) => {
 export const createAccountPayload = async (
   fastify: PluginFastifyInstance,
   items: Account[],
-  requestData: ClientPayloadRequestData,
+  requestData: FrontendPayloadRequestData,
 ) => await fastify.createPayload("account", items, requestData)

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/composition/composition.service.ts

@@ -1,7 +1,7 @@
 import type { Composition as CompositionType } from "./composition.schema"
 import type {
-  ClientPayload,
-  ClientPayloadRequestData,
+  FrontendPayload,
+  FrontendPayloadRequestData,
 } from "@c/payload/payloadTypes"
 import type { PluginFastifyInstance } from "types"
 import { v4 as uuidv4, validate } from "uuid"
@@ -68,10 +68,10 @@ export class CompositionService {
    */
   async createComposition(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     compositionBody: CompositionBody,
     userId: string,
-  ): Promise<ClientPayload<CompositionType[]>> {
+  ): Promise<FrontendPayload<CompositionType[]>> {
     const composition = await this._createComposition(
       fastify,
       compositionBody,
@@ -112,8 +112,8 @@ export class CompositionService {
    */
   async getAllCompositions(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
-  ): Promise<ClientPayload<CompositionType[]>> {
+    requestData: FrontendPayloadRequestData,
+  ): Promise<FrontendPayload<CompositionType[]>> {
     const compositions = await this._readAllCompositions(fastify)
 
     return createCompositionPayload(fastify, compositions, requestData)
@@ -147,9 +147,9 @@ export class CompositionService {
    */
   async readComposition(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
-  ): Promise<ClientPayload<CompositionType[]>> {
+  ): Promise<FrontendPayload<CompositionType[]>> {
     const composition = await this._readComposition(fastify, id)
 
     return createCompositionPayload(fastify, [composition], requestData)
@@ -210,11 +210,11 @@ export class CompositionService {
    */
   async updateComposition(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
     compositionBody: CompositionBody,
     userId: string,
-  ): Promise<ClientPayload<CompositionType[]>> {
+  ): Promise<FrontendPayload<CompositionType[]>> {
     const { updated, original } = await this._updateComposition(
       fastify,
       id,
@@ -265,9 +265,9 @@ export class CompositionService {
    */
   async removeComposition(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
-  ): Promise<ClientPayload<CompositionType[]>> {
+  ): Promise<FrontendPayload<CompositionType[]>> {
     const composition = await this._removeComposition(fastify, id)
 
     const payload = await createCompositionPayload(fastify, [composition], {
@@ -314,9 +314,9 @@ export class CompositionService {
    */
   async hardDeleteComposition(
     fastify: PluginFastifyInstance,
-    requestData: ClientPayloadRequestData,
+    requestData: FrontendPayloadRequestData,
     id: string,
-  ): Promise<ClientPayload<CompositionType[]>> {
+  ): Promise<FrontendPayload<CompositionType[]>> {
     const composition = await this._hardDeleteComposition(fastify, id)
 
     const payload = await createCompositionPayload(fastify, [composition], {

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/composition/events/index.ts

@@ -1,12 +1,12 @@
 import type { AnyComposition } from "../composition.schema"
-import type { ClientPayload } from "@c/payload/payloadTypes"
+import type { FrontendPayload } from "@c/payload/payloadTypes"
 import type { PluginFastifyInstance } from "types"
 
 export const registerEvents = (fastify: PluginFastifyInstance) => {
   /*
    * composition created and created
    */
-  const created = async (payload: ClientPayload<AnyComposition>) => {
+  const created = async (payload: FrontendPayload<AnyComposition>) => {
     fastify.eventbus.emit("broadcastCompositionCreated", payload)
     fastify.log.info(
       `[eventbus] composition broadcast created ${payload.body.items}`,
@@ -16,7 +16,7 @@ export const registerEvents = (fastify: PluginFastifyInstance) => {
   /*
    * composition deleted
    */
-  const deleted = async (payload: ClientPayload<AnyComposition>) => {
+  const deleted = async (payload: FrontendPayload<AnyComposition>) => {
     fastify.eventbus.emit("broadcastCompositionDeleted", payload)
     fastify.log.info(
       `[eventbus] composition broadcast deleted ${payload.body.items}`,