@raclettejs/core 0.1.16 → 0.1.17

package/CHANGELOG.md

@@ -7,15 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.1.16] - 05.11.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.15...v0.1.16" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
+## [0.1.17] - 06.11.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.15...v0.1.17" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Fixed
 
 - Frontend: axios Delete handling
+- Frontend: retrieval of deleted compositions/interactionLinks during socket join
+- Frontend: notifications for delete events now show name
+-
 
 ### Added
 
 - Frontend: added i18n keys
+- Frontend: hard delete of core datatypes
 - Backend: getAll routes for core datatypes do now respect set filters
 
 ## [0.1.15] - 02.11.2025 <a href="https://gitlab.com/raclettejs/core/-/compare/v0.1.13...v0.1.15" target="_blank" rel="noopener"><b>Overview of all changes</b></a>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raclettejs/core",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "racletteJS core package",
   "repository": "https://gitlab.com/raclettejs/core",
   "author": "Pacifico Digital Explorations GmbH <info@raclettejs.com>",
@@ -69,7 +69,7 @@
   },
   "devDependencies": {
     "@eslint/js": "9.35.0",
-    "@raclettejs/types": "0.1.16",
+    "@raclettejs/types": "^0.1.17",
     "@types/fs-extra": "11.0.4",
     "@types/js-yaml": "4.0.9",
     "@types/node": "24.5.1",

package/services/backend/src/core/backgroundTasks/taskManager.ts

@@ -122,7 +122,7 @@ const setupTaskManager = (fastify: FastifyInstance) => {
 
       if (removed) {
         taskMetadata.delete(name)
-        fastify.log.info(`Cancelled task: ${name}`)
+        fastify.log.info(`Canceled task: ${name}`)
       } else {
         fastify.log.warn(`Task not found: ${name}`)
       }

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

@@ -93,6 +93,7 @@ const registerSocketEvents = (fastify: FastifyInstance): void => {
           "composition",
           "readAll",
           fastify,
+          { isDeleted: false },
         )
       }
 
@@ -103,6 +104,7 @@ const registerSocketEvents = (fastify: FastifyInstance): void => {
           "interactionLink",
           "readAll",
           fastify,
+          { isDeleted: false },
         )
       }
 

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

@@ -6,7 +6,7 @@ import type {
 import type { PluginFastifyInstance } from "types"
 import { v4 as uuidv4, validate } from "uuid"
 import { createAccountPayload } from "./helpers/payload"
-import { Model } from "mongoose"
+import type { Model } from "mongoose"
 
 export type AccountBody = Partial<Omit<AccountType, "_id">> & {
   _id?: string
@@ -277,9 +277,13 @@ export class AccountService {
         )
       }
 
-      await this.accountModel.deleteOne({ _id: id })
+      const res = await account.deleteOne()
 
-      return account.toObject ? account.toObject() : account
+      if (res?.deletedCount === 1) {
+        return account.toObject ? account.toObject() : account
+      }
+
+      throw new Error(`Deletion of Account with ID ${id} was not successful.`)
     } catch (error: any) {
       fastify.log.error(error.message)
       throw error

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/account/routes/route.account.hardDelete.ts

@@ -2,6 +2,7 @@ import type { Static } from "@sinclair/typebox"
 import type { FastifyReply, FastifyRequest } from "fastify"
 import type { PluginFastifyInstance } from "types"
 import { Type } from "@sinclair/typebox"
+import { ForbiddenError } from "@/utils/errors"
 
 const ParamsSchema = Type.Object({
   _id: Type.String(),
@@ -17,19 +18,23 @@ export default (fastify: PluginFastifyInstance) => {
     }>,
     reply: FastifyReply,
   ) => {
-    try {
-      const { _id } = req.params
+    if (req.user.isAdmin) {
+      try {
+        const { _id } = req.params
 
-      const payload = await accountService.hardDeleteAccount(
-        fastify,
-        req.requestParams,
-        _id,
-      )
+        const payload = await accountService.hardDeleteAccount(
+          fastify,
+          req.requestParams,
+          _id,
+        )
 
-      return payload
-    } catch (error: any) {
-      fastify.log.error(error.message)
-      return reply.internalServerError(error.message)
+        return payload
+      } catch (error: any) {
+        fastify.log.error(error.message)
+        return reply.internalServerError(error.message)
+      }
+    } else {
+      throw new ForbiddenError("Only admins can hard delete this core datatype")
     }
   }
 

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

@@ -292,7 +292,7 @@ export class CompositionService {
   ): Promise<CompositionType> {
     try {
       const composition = await this.compositionModel.findOne({
-        id,
+        _id: id,
         isDeleted: true,
       })
 
@@ -302,9 +302,15 @@ export class CompositionService {
         )
       }
 
-      await this.compositionModel.deleteOne({ _id: id })
+      const res = await composition.deleteOne()
 
-      return composition.toObject ? composition.toObject() : composition
+      if (res?.deletedCount === 1) {
+        return composition.toObject ? composition.toObject() : composition
+      }
+
+      throw new Error(
+        `Deletion of Composition with ID ${id} was not successful.`,
+      )
     } catch (error: any) {
       fastify.log.error(error.message)
       throw error

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/composition/routes/route.composition.hardDelete.ts

@@ -2,6 +2,7 @@ import type { Static } from "@sinclair/typebox"
 import type { FastifyReply, FastifyRequest } from "fastify"
 import type { PluginFastifyInstance } from "types"
 import { Type } from "@sinclair/typebox"
+import { ForbiddenError } from "@/utils/errors"
 
 const ParamsSchema = Type.Object({
   _id: Type.String(),
@@ -17,19 +18,23 @@ export default (fastify: PluginFastifyInstance) => {
     }>,
     reply: FastifyReply,
   ) => {
-    try {
-      const { _id } = req.params
+    if (req.user.isAdmin) {
+      try {
+        const { _id } = req.params
 
-      const payload = await compositionService.hardDeleteComposition(
-        fastify,
-        req.requestParams,
-        _id,
-      )
+        const payload = await compositionService.hardDeleteComposition(
+          fastify,
+          req.requestParams,
+          _id,
+        )
 
-      return payload
-    } catch (error: any) {
-      fastify.log.error(error.message)
-      return reply.internalServerError(error.message)
+        return payload
+      } catch (error: any) {
+        fastify.log.error(error.message)
+        return reply.internalServerError(error.message)
+      }
+    } else {
+      throw new ForbiddenError("Only admins can hard delete this core datatype")
     }
   }
 

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

@@ -5,8 +5,8 @@ import type {
 } from "@c/payload/payloadTypes"
 import { v4 as uuidv4, validate } from "uuid"
 import { createInteractionLinkPayload } from "./helpers/payload"
-import { PluginFastifyInstance } from "types"
-import { Model } from "mongoose"
+import type { PluginFastifyInstance } from "types"
+import type { Model } from "mongoose"
 
 export type InteractionLinkBody = Partial<Omit<InteractionLinkType, "_id">> & {
   _id?: string
@@ -352,11 +352,17 @@ export class InteractionLinkService {
         )
       }
 
-      await this.interactionLinkModel.deleteOne({ id })
+      const res = await interactionLink.deleteOne()
 
-      return interactionLink.toObject
-        ? interactionLink.toObject()
-        : interactionLink
+      if (res?.deletedCount === 1) {
+        return interactionLink.toObject
+          ? interactionLink.toObject()
+          : interactionLink
+      }
+
+      throw new Error(
+        `Deletion of InteractionLink with ID ${id} was not successful.`,
+      )
     } catch (error: any) {
       fastify.log.error(error.message)
       throw error

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/interactionLink/routes/route.interactionLink.hardDelete.ts

@@ -2,6 +2,7 @@ import type { Static } from "@sinclair/typebox"
 import type { FastifyReply, FastifyRequest } from "fastify"
 import { PluginFastifyInstance } from "types"
 import { Type } from "@sinclair/typebox"
+import { ForbiddenError } from "@/utils/errors"
 
 const ParamsSchema = Type.Object({
   _id: Type.String(),
@@ -18,15 +19,21 @@ export default (fastify: PluginFastifyInstance) => {
     reply: FastifyReply,
   ) => {
     try {
-      const { _id } = req.params
+      if (req.user.isAdmin) {
+        const { _id } = req.params
 
-      const payload = await interactionLinkService.hardDeleteInteractionLink(
-        fastify,
-        req.requestParams,
-        _id,
-      )
+        const payload = await interactionLinkService.hardDeleteInteractionLink(
+          fastify,
+          req.requestParams,
+          _id,
+        )
 
-      return payload
+        return payload
+      } else {
+        throw new ForbiddenError(
+          "Only admins can hard delete this core datatype",
+        )
+      }
     } catch (error: any) {
       fastify.log.error(error.message)
       return reply.internalServerError(error.message)

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

@@ -10,8 +10,8 @@ import type {
 import type { QueryOptions } from "@m/database/providers/mongodb/service"
 import { v4 as uuidv4, validate } from "uuid"
 import { createProjectPayload } from "./helpers/payload"
-import { Model } from "mongoose"
-import { PluginFastifyInstance } from "types"
+import type { Model } from "mongoose"
+import type { PluginFastifyInstance } from "types"
 
 export type ProjectBody = Partial<Omit<ProjectType, "_id">> & { _id?: string }
 
@@ -316,9 +316,13 @@ export class ProjectService {
         )
       }
 
-      await this.projectModel.deleteOne({ _id: id })
+      const res = await project.deleteOne()
 
-      return project.toObject ? project.toObject() : project
+      if (res?.deletedCount === 1) {
+        return project.toObject ? project.toObject() : project
+      }
+
+      throw new Error(`Deletion of Project with ID ${id} was not successful.`)
     } catch (error: any) {
       fastify.log.error(error.message)
       throw error

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/tag/routes/route.tag.hardDelete.ts

@@ -2,6 +2,7 @@ import type { Static } from "@sinclair/typebox"
 import type { FastifyReply, FastifyRequest } from "fastify"
 import { PluginFastifyInstance } from "types"
 import { Type } from "@sinclair/typebox"
+import { ForbiddenError } from "@/utils/errors"
 
 const ParamsSchema = Type.Object({
   _id: Type.String(),
@@ -16,15 +17,21 @@ export default (fastify: PluginFastifyInstance) => {
     reply: FastifyReply,
   ) => {
     try {
-      const { _id } = req.params
+      if (req.user.isAdmin) {
+        const { _id } = req.params
 
-      const payloadWithTag = await tagService.hardDeleteTag(
-        fastify,
-        req.requestParams,
-        _id,
-      )
+        const payloadWithTag = await tagService.hardDeleteTag(
+          fastify,
+          req.requestParams,
+          _id,
+        )
 
-      return payloadWithTag
+        return payloadWithTag
+      } else {
+        throw new ForbiddenError(
+          "Only admins can hard delete this core datatype",
+        )
+      }
     } catch (error: any) {
       fastify.log.error(error.message)
       return reply.internalServerError(error.message)

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

@@ -318,7 +318,10 @@ export class TagService {
     id: string,
   ): Promise<TagType> {
     try {
-      const tag = await this.tagModel.findOne({ _id: id, isDeleted: true })
+      const tag = await this.tagModel.findOne({
+        _id: id,
+        isDeleted: true,
+      })
 
       if (!tag) {
         throw new Error(
@@ -326,9 +329,13 @@ export class TagService {
         )
       }
 
-      await this.tagModel.deleteOne({ _id: id })
+      const res = await tag.deleteOne()
 
-      return tag.toObject ? tag.toObject() : tag
+      if (res?.deletedCount === 1) {
+        return tag.toObject ? tag.toObject() : tag
+      }
+
+      throw new Error(`Deletion of Tag with ID ${id} was not successful.`)
     } catch (error: any) {
       fastify.log.error(error.message)
       throw error

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/user/routes/index.ts

@@ -5,6 +5,7 @@ import patch from "./route.user.patch"
 import patchLastProject from "./route.user.patchLastProject"
 import post from "./route.user.post"
 import remove from "./route.user.remove"
+import hardDelete from "./route.user.hardDelete"
 
 const registerRoutes = async (fastify: PluginFastifyInstance) => {
   await fastify.get("/user/all", getAll(fastify))
@@ -12,6 +13,7 @@ const registerRoutes = async (fastify: PluginFastifyInstance) => {
   await fastify.patch("/user/:_id", patch(fastify))
   await fastify.post("/user", post(fastify))
   await fastify.delete("/user/:_id", remove(fastify))
+  await fastify.delete("/user/:_id/hard", hardDelete(fastify))
   await fastify.patch(
     "/user/last-project/:projectId",
     patchLastProject(fastify),

package/services/backend/src/corePlugins/raclette__core/backend/datatypes/user/routes/route.user.hardDelete.ts

@@ -0,0 +1,55 @@
+import type { Static } from "@sinclair/typebox"
+import type { FastifyReply, FastifyRequest } from "fastify"
+import { PluginFastifyInstance } from "types"
+import { Type } from "@sinclair/typebox"
+import { ForbiddenError } from "@/utils/errors"
+
+const ParamsSchema = Type.Object({
+  _id: Type.String(),
+})
+type Params = Static<typeof ParamsSchema>
+
+export default (fastify: PluginFastifyInstance) => {
+  const userService = fastify.custom.userService
+
+  const handler = async (
+    req: FastifyRequest<{ Params: Params }>,
+    reply: FastifyReply,
+  ) => {
+    try {
+      if (req.user.isAdmin) {
+        const { _id } = req.params
+
+        const payloadWithUser = await userService.hardDeleteUser(
+          fastify,
+          req.requestParams,
+          _id,
+        )
+
+        return payloadWithUser
+      } else {
+        throw new ForbiddenError(
+          "Only admins can hard delete this core datatype",
+        )
+      }
+    } catch (error: any) {
+      fastify.log.error(error.message)
+      return reply.internalServerError(error.message)
+    }
+  }
+
+  return {
+    handler,
+    onRequest: [fastify.authenticate],
+    config: {
+      type: "dataHardDeleted",
+      broadcastChannels: ["userHardDeleted"],
+    },
+    schema: {
+      summary: "Permanently delete a user by id",
+      description: "Hard delete a user",
+      tags: ["core/user"],
+      params: ParamsSchema,
+    },
+  }
+}

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

@@ -287,6 +287,38 @@ export class UserService {
     return payload
   }
 
+  /**
+   * Core function to hard delete an interaction link (returns raw data)
+   */
+  async _hardDeleteUser(
+    fastify: PluginFastifyInstance,
+    id: string,
+  ): Promise<UserType> {
+    try {
+      const user = await this.userModel.findOne({
+        _id: id,
+        isDeleted: true,
+      })
+
+      if (!user) {
+        throw new Error(
+          `User with ID ${id} not found or not marked for deletion`,
+        )
+      }
+
+      const res = await user.deleteOne()
+
+      if (res?.deletedCount === 1) {
+        return user.toObject ? user.toObject() : user
+      }
+
+      throw new Error(`Deletion of User with ID ${id} was not successful.`)
+    } catch (error: any) {
+      fastify.log.error(error.message)
+      throw error
+    }
+  }
+
   /**
    * Core function to update user's last accessed project (returns raw data)
    */

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

@@ -164,11 +164,11 @@ const cacheOperations = {
   },
 }
 
-const finishRemoteQuery = (actionIdentifier, result, params, options) => {
+const finishRemoteQuery = (actionIdentifier, result = {}, params, options) => {
   const { actionId, cacheKey } = actionIdentifier
   log.api("finishRemoteQuery", { actionId, params, result })
 
-  if (!result.data) {
+  if (!result?.data) {
     return
   }
   let resultBody = structuredClone(result.data.body)
@@ -238,18 +238,26 @@ const handleRemoteRequest = async (
     const response =
       method === "GET"
         ? await $api.axios.get(target, config).catch((e) => {
-            $eventbus.emit("ui/addToSnackbar", {
-              message: e.response.data.message,
-              color: "error",
-            })
-            throw e
+            if (e.name !== "CanceledError") {
+              $eventbus.emit("ui/addToSnackbar", {
+                message: e.response?.data?.message || "error",
+                color: "error",
+              })
+              throw e
+            }
+            log.api("axios/get/error", e)
+            return {}
           })
         : await $api.axios.post(target, params, config).catch((e) => {
-            $eventbus.emit("ui/addToSnackbar", {
-              message: e.response.data.message,
-              color: "error",
-            })
-            throw e
+            if (e.name !== "CanceledError") {
+              $eventbus.emit("ui/addToSnackbar", {
+                message: e.response?.data?.message || "error",
+                color: "error",
+              })
+              throw e
+            }
+            log.api("axios/post/error", e)
+            return {}
           })
 
     return {
@@ -258,7 +266,7 @@ const handleRemoteRequest = async (
     }
   } catch (e) {
     if (e.name === "AbortError" || e.name === "CanceledError") {
-      log.api(`${method} request was cancelled for actionId:`, actionIdentifier)
+      log.api(`${method} request was canceled for actionId:`, actionIdentifier)
       throw e
     }
 
@@ -442,7 +450,7 @@ const executeRoute = async (actionIdentifier, validTarget, params, options) => {
 
         if (error.name === "AbortError" || error.name === "CanceledError") {
           log.api(
-            "HTTP request was cancelled for actionId:",
+            "HTTP request was canceled for actionId:",
             actionIdentifier.actionId,
           )
           throw error

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

@@ -162,7 +162,7 @@ const handler = {
       requestId,
       data,
     })
-    const deleted = data.deleted || []
+    const deleted = data.items || []
     $store.dispatch({ type: "data/hardDelete", payload: deleted })
     if (notify) {
       userNotifier.dataDelete(isOwnRequest, isSystemAction, deleted)

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

@@ -129,7 +129,7 @@ const userConfigUpdate = (isAnswerToOwnRequest, isSystemAction, items) =>
     color: "info",
   })
 
-const dataDelete = (isAnswerToOwnRequest, isSystemAction, deletedItems) =>
+const dataDelete = (isAnswerToOwnRequest, isSystemAction, deletedItems) => {
   deletedItems.forEach((item) => {
     if (isAnswerToOwnRequest) {
       $eventbus.emit("ui/addToSnackbar", {
@@ -153,6 +153,7 @@ const dataDelete = (isAnswerToOwnRequest, isSystemAction, deletedItems) =>
       })
     }
   })
+}
 
 const dataMove = (isAnswerToOwnRequest, isSystemAction, items) => {
   items.forEach((item) => {

package/yarn.lock

@@ -295,10 +295,10 @@
   resolved "https://registry.yarnpkg.com/@pkgr/core/-/core-0.2.9.tgz#d229a7b7f9dac167a156992ef23c7f023653f53b"
   integrity sha512-QNqXyfVS2wm9hweSYD2O7F0G06uurj9kZ96TRQE5Y9hU7+tgdZwIkbAKc5Ocy1HxEY2kuDQa6cQ1WRs/O5LFKA==
 
-"@raclettejs/types@^0.1.16":
-  version "0.1.16"
-  resolved "https://registry.yarnpkg.com/@raclettejs/types/-/types-0.1.16.tgz#9b8e6122c831b98822ec35bf90430dfb9a482aa6"
-  integrity sha512-HUkh4CP5yny3IwgYIHSh3zbpzakJgzmuRO3obtutVADO8tmRi9SAnQQMXK5X+3A51ZicdB9VPuhmw1r/Iv1SZA==
+"@raclettejs/types@^0.1.17":
+  version "0.1.17"
+  resolved "https://registry.yarnpkg.com/@raclettejs/types/-/types-0.1.17.tgz#ced377e5fa8879a5790b1c0c838f621917032690"
+  integrity sha512-WBhi6Nf/XJPlisF1stEB0KGo5TWw+EMaTuYt39fJKc+Vtyf/SFmZqP2D3BKlssE5N/8bo2DFgf2qUeKowo0onA==
   dependencies:
     "@types/node" "24.5.2"
     fastify "5.6.0"