@raclettejs/core 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -7,13 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.1.8] - 11.09.2025
+## [0.1.10] - 12.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.9...v0.1.10" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
+
+### Changed
+
+- added "Overview of all changes" link to all previous versions
+
+### Refactor
+
+- changed response structure of queries execute. Will now always return {result:any, response:any} -> see docs for further information
+  - https://docs.raclettejs.com/docs/examples/recipes/creatingDataInTheBackend
+  - https://docs.raclettejs.com/docs/examples/recipes/readingDataFromTheBackend
+- queries now always return dataArr
+
+### Fix
+
+- fixed missing "raclette" string in welcome page
+- fixed missing "new" i18n key in user Notifier
+- fixed min-width in userNotifier
+- Add `<button>` cursor styles from vuetify's reset css (which is disabled), to fix missing `cursor: pointer` css rule.
+
+## [0.1.9] - 11.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.8...v0.1.9" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
+
+### Feat
+
+- language preference is now properly respected in all components
+
+## [0.1.8] - 11.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.7...v0.1.8" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Changed
 
 - language and theme toggle in user menu now always store preference in localstorage, not just in dev mode
 
-## [0.1.7] - 11.09.2025
+## [0.1.7] - 11.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.6...v0.1.7" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Style
 
@@ -23,25 +49,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - fixed query handler id suffixing
 
-## [0.1.6] - 11.09.2025
+## [0.1.6] - 11.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.5...v0.1.6" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 - version updates
 
-## [0.1.5] - 11.09.2025
+## [0.1.5] - 11.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.4...v0.1.5" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Fixed
 
 - "refresh all queries" functionallity in user menu now works as expected
   - issue was introduced during query api update in v0.1.3
 
-## [0.1.4] - 10.09.2025
+## [0.1.4] - 10.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.3...v0.1.4" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Fixed
 
 - aliases "@app", "@raclettejs/core/frontend" & "@raclettejs/core/backend" are now resolved properly in the IDE
 - fixed unspecific locale fallback
 
-## [0.1.3] - 10.09.2025
+## [0.1.3] - 10.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.2...v0.1.3" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Fixed
 
@@ -51,14 +77,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - renamed all Types and core internal imports from Client* to Frontend*
   - this was forgotten in a former refactoring step and resolves build issues encountered after going Live
 
-## [0.1.2] - 04.09.2025
+## [0.1.2] - 04.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.1...v0.1.2" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Changed
 
 - cache TTL can now be configured via raclette.config.js -> if none is set will default to -1 which implies indefinite ttl
   - -> make sure to set ttl explicitly during cache.cache() if important for businesslogic!
 
-## [0.1.1] - 03.09.2025
+## [0.1.1] - 03.09.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.0...v0.1.1" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Added
 

package/package.json

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

package/services/frontend/src/core/lib/data/dataApi.ts

@@ -19,21 +19,21 @@ const $writeDataApi = (
   const isLoadingSubject$ = new BehaviorSubject<boolean>(false)
   const dataSubject$ = new BehaviorSubject([])
   const errorSubject$ = new BehaviorSubject(null)
-  const resultSubject$ = new BehaviorSubject({})
+  const responseSubject$ = new BehaviorSubject({})
   const writeApi = {
     isLoading$: isLoadingSubject$.asObservable(),
     data$: dataSubject$.asObservable(),
     error$: errorSubject$.asObservable(),
-    result$: resultSubject$.asObservable(),
+    response$: responseSubject$.asObservable(),
     execute: async (executeParams = {}) => {
       const _executeParams = clone(executeParams)
       errorSubject$.next(null)
-      resultSubject$.next({})
-      isLoadingSubject$.next(true)
+      responseSubject$.next({})
       const queryParams = mergeDeepRight(_params, _executeParams)
       if (options.responseType === "stream") {
         return writeData(actionId, operationDefinition, queryParams, options)
       }
+      isLoadingSubject$.next(true)
       const resultData = await writeData(
         actionId,
         operationDefinition,
@@ -44,14 +44,16 @@ const $writeDataApi = (
         errorSubject$.next(errorObj)
         isLoadingSubject$.next(false)
       })
-      resultSubject$.next(resultData)
+      responseSubject$.next(resultData?.response)
 
       // Update both boolean and observable on success
       isLoadingSubject$.next(false)
 
       // Update data if resultData is available
-      if (resultData) {
-        const dataArray = Array.isArray(resultData) ? resultData : [resultData]
+      if (resultData?.result) {
+        const dataArray = Array.isArray(resultData.result)
+          ? resultData.result
+          : [resultData.result]
         dataSubject$.next(dataArray)
       }
 

package/services/frontend/src/core/lib/data/fetchDataHandler.ts

@@ -183,7 +183,10 @@ const finishRemoteQuery = (actionIdentifier, result, params, options) => {
         actionId: actionId,
       },
     })
-    return result.data
+    return {
+      result: resultObj,
+      response: result.data,
+    }
   }
 
   return itemDispatcher(actionIdentifier, resultObj, true)
@@ -225,7 +228,10 @@ const handleRemoteRequest = async (
         ? await $api.axios.get(target, config)
         : await $api.axios.post(target, params, config)
 
-    return finishRemoteQuery(actionIdentifier, response, params, options)
+    return {
+      response,
+      result: finishRemoteQuery(actionIdentifier, response, params, options),
+    }
   } catch (e) {
     if (e.name === "AbortError" || e.name === "CanceledError") {
       log.api(`${method} request was cancelled for actionId:`, actionIdentifier)
@@ -239,12 +245,15 @@ const handleRemoteRequest = async (
       e,
     })
 
-    return finishRemoteQuery(
-      actionIdentifier,
-      { data: [], error: e?.response?.data || e },
-      params,
-      options,
-    )
+    return {
+      response: e,
+      result: finishRemoteQuery(
+        actionIdentifier,
+        { data: [], error: e?.response?.data || e },
+        params,
+        options,
+      ),
+    }
   }
 }
 
@@ -359,22 +368,28 @@ const routeHandlers = {
   "search/query": async (actionIdentifier, target, params, options, signal) => {
     if (params.search?.q === "@showall") {
       const dataState = $store.getState("data")
-      return itemDispatcher(
+      return {
+        response: "dataStore",
+        result: itemDispatcher(
+          actionIdentifier,
+          {
+            result: Object.values(dataState),
+          },
+          true,
+        ),
+      }
+    }
+
+    return {
+      response: "dataStore",
+      result: itemDispatcher(
         actionIdentifier,
         {
-          result: Object.values(dataState),
+          result: [],
         },
         true,
-      )
+      ),
     }
-
-    return itemDispatcher(
-      actionIdentifier,
-      {
-        result: [],
-      },
-      true,
-    )
   },
 }
 
@@ -438,7 +453,10 @@ const getData = async (actionId, target, params, options) => {
       actionIdentifier,
     )
     if (cacheResult !== null) {
-      return cacheResult
+      return {
+        response: "cached_" + cachedQuery.hash,
+        result: cacheResult,
+      }
     }
   }
   // Execute route

package/services/frontend/src/core/lib/data/queryApi.ts

@@ -19,7 +19,7 @@ export const $queryApi = (
     return queryApis[actionId]
   }
   const errorSubject$ = new BehaviorSubject(null)
-  const resultSubject$ = new BehaviorSubject({})
+  const responseSubject$ = new BehaviorSubject({})
   const cleanedParams = fixQueryParamTypes(params)
   // check if we have a query fullfilling the needs of the one requested
   // here. If not we will update the one with this actionId
@@ -35,7 +35,7 @@ export const $queryApi = (
   })
   const queryApi = {
     error$: errorSubject$.asObservable(),
-    result$: resultSubject$.asObservable(),
+    response$: responseSubject$.asObservable(),
     query$: $store.select((state) => state.queries[actionId]),
     uuids$: $store.select((state) => state.queries[actionId].uuids),
     remove: () => {
@@ -48,7 +48,7 @@ export const $queryApi = (
     execute: async (executeParams = {}) => {
       const _executeParams = clone(executeParams)
       errorSubject$.next(null)
-      resultSubject$.next({})
+      responseSubject$.next({})
       const queryParams = mergeDeepRight(cleanedParams, _executeParams)
       $store.dispatch({
         type: "queries/update",
@@ -68,10 +68,13 @@ export const $queryApi = (
         const errorObj = e
         errorSubject$.next(errorObj)
       })
-      resultSubject$.next(resultData)
+      responseSubject$.next(resultData?.response)
       if (options.cb && typeof options.cb === "function") {
         options.cb(resultData)
       }
+      if (resultData.result) {
+        resultData.result = await resultData.result
+      }
       return resultData
     },
     onDeleted: (callback) => {

package/services/frontend/src/core/lib/data/writeDataHandler.ts

@@ -117,13 +117,24 @@ const writeData = async (actionId, operationDefinition, item, options) => {
       cleanItem,
       config,
     )
+      .then((res) => {
+        return {
+          response: res,
+        }
+      })
+      .catch((e) => reportError(e))
   } else {
     return await $api.axios[operationDefinition.method](
       validTarget,
       cleanItem,
       config,
     )
-      .then((res) => handleServerItem(res.data, notify, true))
+      .then((res) => {
+        return {
+          response: res,
+          result: handleServerItem(res.data, notify, true),
+        }
+      })
       .catch((e) => reportError(e))
   }
 }

package/services/frontend/src/core/lib/easteregg.ts

@@ -1,6 +1,7 @@
 import snow from "./eggs/snow"
 import asteroids from "./eggs/asteroids/index"
 import smoke from "./eggs/smoke"
+import { $eventbus } from "@racletteCore/main"
 
 const eggs = {
   asteroids: asteroids,
@@ -12,7 +13,12 @@ const eggMe = (egg) => {
     return
   }
 
-  return eggs[egg]()
+  return eggs[egg](() => {
+    $eventbus.emit("ui_addToSnackBar", {
+      i18n: "core.eggcontrols." + egg,
+      color: "info",
+    })
+  })
 }
 
 const debounceHelper = (count, time = 800) => {

package/services/frontend/src/core/lib/eggs/asteroids/index.ts

@@ -519,7 +519,7 @@ function isTouchOnly() {
   return isTouchOnly
 }
 // Export function to create and start the game with SSR safety
-export default (): ModernAsteroids | null => {
+export default (notifyUser): ModernAsteroids | null => {
   if (
     typeof window === "undefined" ||
     typeof document === "undefined" ||
@@ -528,6 +528,6 @@ export default (): ModernAsteroids | null => {
     console.warn("Racleroids game can only run in browser environment")
     return null
   }
-
+  notifyUser()
   return new ModernAsteroids()
 }

package/services/frontend/src/core/lib/projectDataHelper.ts

@@ -9,7 +9,6 @@ const setupSpace = async (
   interactionLinks: InteractionLink[],
   projectConfig: ProjectConfiguration,
 ) => {
-  const userLanguage = useLocalStorage<string>("user-language", null)
   const userTheme = useLocalStorage<string>("user-theme", null)
   let sessionTheme = userTheme.value
   // set compositions
@@ -48,7 +47,7 @@ const setupSpace = async (
   }
   await $store.dispatch({
     type: "ui/update",
-    payload: { theme: sessionTheme},
+    payload: { theme: sessionTheme },
   })
 }
 

package/services/frontend/src/core/setup/plugin-system/api/plugin-data.ts

@@ -82,7 +82,7 @@ export const handlePluginOperations =
             params = {},
             options = {},
           }: CustomStoreActionsPayload = {}) => {
-            if (id) handlerId = id
+            if (id?.length) handlerId = id
             const instanceActionId =
               getInstanceActionId(
                 prefixedPluginName,
@@ -118,7 +118,7 @@ export const handlePluginOperations =
             params = {},
             options = {},
           }: CustomStoreActionsPayload = {}) => {
-            if (id) handlerId = id
+            if (id?.length) handlerId = id
             const instanceActionId =
               getInstanceActionId(
                 prefixedPluginName,

package/services/frontend/src/orchestrator/assets/styles/main.scss

@@ -5,9 +5,11 @@
 .ASTEROIDSYEAH {
   @apply tw:overflow-hidden;
 }
+
 .klingon * {
   font-family: "Klingon";
 }
+
 .raclette {
   font-family: "Quicksand" !important;
   font-weight: 700;

package/services/frontend/src/orchestrator/assets/styles/vuetifyStyles.scss

@@ -3,3 +3,25 @@
   $reset: false
 );
 @use "@mdi/font/css/materialdesignicons.css";
+
+// The styles below are picked from vuetify's reset css (which is disabled)
+
+/* Apply cursor pointer to button elements */
+button,
+[type="button"],
+[type="reset"],
+[type="submit"],
+[role="button"] {
+  cursor: pointer;
+  color: inherit;
+}
+
+/* Specify the pointer cursor of trigger elements */
+[aria-controls] {
+  cursor: pointer;
+}
+
+/* Specify the unstyled cursor of disabled, not-editable, or otherwise inoperable elements */
+[aria-disabled="true"] {
+  cursor: default;
+}

package/services/frontend/src/orchestrator/components/menu/UserNotifications.vue

@@ -32,10 +32,12 @@
       </v-btn>
     </template>
 
-    <v-card left class="tw:w-[450px]">
+    <v-card left>
       <v-expansion-panels v-model="panel">
         <v-expansion-panel>
-          <v-expansion-panel-title>Neu</v-expansion-panel-title>
+          <v-expansion-panel-title>{{
+            $t("core.new")
+          }}</v-expansion-panel-title>
           <v-expansion-panel-text>
             <v-list density="compact">
               <v-list-item

package/services/frontend/src/orchestrator/components/welcomeScreen/AdminWelcomeScreen.vue

@@ -5,6 +5,7 @@
         <v-card-title class="tw:text-3xl tw:font-bold tw:pb-2">
           🧀
           {{ $t("core.welcomeScreen.title") }}
+          <span class="raclette">raclette</span>
         </v-card-title>
         <v-card-subtitle class="tw:text-lg tw:opacity-90">
           {{ $t("core.welcomeScreen.subtitle") }}

package/services/frontend/src/orchestrator/components/welcomeScreen/UserWelcomeScreen.vue

@@ -5,6 +5,7 @@
         <v-card-title class="tw:text-3xl tw:font-bold tw:pb-2">
           🧀
           {{ $t("core.welcomeScreen.title") }}
+          <span class="raclette">raclette</span>
         </v-card-title>
         <v-card-subtitle class="tw:text-lg tw:opacity-90">
           {{ $t("core.welcomeScreen.subtitleUser") }}

package/services/frontend/src/orchestrator/composables/useVueQueryObservableHelper.ts

@@ -41,7 +41,7 @@ export const useVueQueryObservableHelper = (
   subscriber$[instanceActionId] = coreQuery
   const queryRef = useObservable<QueryApiQuery>(coreQuery.query$)
   const errorObservable = useObservable(coreQuery.error$)
-  const resultRef = useObservable<QueryApiQuery>(coreQuery.result$)
+  const responseRef = useObservable<QueryApiQuery>(coreQuery.response$)
   if (options.useStore !== false) {
     watch(queryRef, (value, oldValue) => {
       const newUUIDS = value?.uuids || []
@@ -73,7 +73,10 @@ export const useVueQueryObservableHelper = (
       return queryRef.value?.loading
     }),
     data,
-    response: resultRef,
+    dataArr: computed(() => {
+      return data.value ? Object.values(data.value) : []
+    }),
+    response: responseRef,
     execute: coreQuery.execute,
     uuids: coreQuery.uuids$,
     error: computed(() => {

package/services/frontend/src/orchestrator/composables/useVueWriteOperationHelper.ts

@@ -45,7 +45,7 @@ export const useVueWriteOperationHelper = (
   const isLoadingObservable = useObservable(writeOperation.isLoading$)
   const dataObservable = useObservable(writeOperation.data$)
   const errorObservable = useObservable(writeOperation.error$)
-  const resultRef = useObservable(writeOperation.result$)
+  const responseRef = useObservable(writeOperation.response$)
   if (options.useStore !== false) {
     watch(dataObservable, (value, oldValue) => {
       const uuids = []
@@ -80,7 +80,10 @@ export const useVueWriteOperationHelper = (
       return isLoadingObservable.value
     }),
     data,
-    response: resultRef,
+    dataArr: computed(() => {
+      return data.value ? Object.values(data.value) : []
+    }),
+    response: responseRef,
     execute: writeOperation.execute,
     error: computed(() => {
       return errorObservable.value

package/services/frontend/src/orchestrator/i18n/de-DE.json

@@ -85,6 +85,7 @@
       "return_to_home": "Zur Startseite",
       "noConnectionToServer": "Es kann keine Verbindung zum Server hergestellt werden"
     },
+    "new": "Neu",
     "lastSocketUpdateReceivedAt": "Letzte Servernachricht erhalten am",
     "logout": "Abmelden",
     "refreshAllQueries": "Alle Suchen aktualisieren",
@@ -105,6 +106,9 @@
     "reloadPageHint": "Bitte laden Sie diese Seite in ihren Browser neu, um die Änderungen zu aktivieren.",
     "color": "Farbe",
     "versionUpdate": "Eine neue Version ist verfügbar. Laden Sie die Seite neu, um alle neuen Features zu nutzen.",
+    "eggcontrols": {
+      "asteroids": "Nutzen sie die Pfeiltasten zum Navigieren und die Leertaste zum Schießen. Viel Spaß!"
+    },
     "languages": {
       "tl-TL": "Klingonisch",
       "de-DE": "Deutsch (Deutschland)",

package/services/frontend/src/orchestrator/i18n/en-EU.json

@@ -85,6 +85,7 @@
       "return_to_home": "Go to home page",
       "noConnectionToServer": "Cannot connect to the server"
     },
+    "new": "New",
     "lastSocketUpdateReceivedAt": "Last server message received at",
     "logout": "Log out",
     "refreshAllQueries": "Refresh all queries",
@@ -105,6 +106,9 @@
     "reloadPageHint": "Please reload this page in your browser to activate the changes.",
     "color": "Color",
     "versionUpdate": "A new version is available. Reload the page to use all new features.",
+    "eggcontrols": {
+      "asteroids": "Use the arrow keys to navigate and the spacebar to shoot. Have fun!"
+    },
     "languages": {
       "tl-TL": "Klingon",
       "de-DE": "German (Germany)",

package/services/frontend/src/orchestrator/i18n/sk.json

@@ -85,6 +85,7 @@
       "return_to_home": "Prejsť na domovskú stránku",
       "noConnectionToServer": "Nepodarilo sa pripojiť k serveru"
     },
+    "new": "nové",
     "lastSocketUpdateReceivedAt": "Posledná správa zo servera prijatá o",
     "logout": "Odhlásiť sa",
     "refreshAllQueries": "Obnoviť všetky dopyty",
@@ -105,6 +106,9 @@
     "reloadPageHint": "Obnovte túto stránku vo svojom prehliadači, aby sa zmeny prejavili.",
     "color": "Farba",
     "versionUpdate": "Je dostupná nová verzia. Obnovte stránku pre použitie všetkých nových funkcií.",
+    "eggcontrols": {
+      "asteroids": "Použite šípky na navigáciu a medzerník na streľbu. Bavte sa!"
+    },
     "languages": {
       "tl-TL": "Klingončina",
       "de-DE": "Nemčina (Nemecko)",

package/services/frontend/src/orchestrator/i18n/tl-TL.json

@@ -85,6 +85,7 @@
       "return_to_home": "vav paqDaq yIja’",
       "noConnectionToServer": "tlhej QunDaq ‘ej tobogh log tapbe’"
     },
+    "new": "qchu'",
     "lastSocketUpdateReceivedAt": "Qun QaptaH neghtaH rep",
     "logout": "Qel",
     "refreshAllQueries": "bochmey Qap yItlhutlh",
@@ -104,6 +105,9 @@
     "batch$CountSynced": "{count} ghItlhmey serverDaq QaptaH law’",
     "reloadPageHint": "paqvam loDnI'pu' Daq laD chel — ngeD choH!",
     "color": "ngem",
-    "versionUpdate": "veS wov ’oH. paq reload chel pagh SoH Hoch tlhab!"
+    "versionUpdate": "veS wov ’oH. paq reload chel pagh SoH Hoch tlhab!",
+    "eggcontrols": {
+      "asteroids": "QuQ navmey Dalo'nIS, 'ej bachmeH patlh yIlo'. yIchep!"
+    }
   }
 }

package/services/frontend/src/orchestrator/setup/i18n.ts

@@ -410,7 +410,8 @@ class I18nOrchestrator {
   private async determineInitialLocale(
     availableLocales: string[],
   ): Promise<string> {
-    const browserLocale = navigator.language
+    const userLanguage = localStorage.getItem("user-language")
+    const browserLocale = userLanguage || navigator.language
     let initialLocale = this.fallbackLocale
 
     // Use the same fallback logic as message loading

package/services/frontend/src/orchestrator/setup/loginApp.ts

@@ -1,3 +1,4 @@
+// TODO: check if this file can be deleted
 export const createLoginApp = async (
   el: string,
   loginMethod: Function,

package/services/frontend/src/orchestrator/types/PluginApi.ts

@@ -16,7 +16,10 @@ export type PluginMethod = (payload?: CustomStoreActionsPayload) => {
   response: Ref<unknown>
   error: Ref<unknown>
   data: ComputedRef<unknown>
-  execute: (params?: Record<string, any>) => void
+  dataArr: Array<ComputedRef<unknown>>
+  execute: (
+    params?: Record<string, any>,
+  ) => Promise<{ response: any; result: any }>
   // query and uuids only provided from queryObservableHelper
   query?: ComputedRef<Query>
   uuids?: Array<string>