@raclettejs/workbench 0.1.36-canary.1 → 0.1.36

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.36] - 2026-06-22 <a href="https://gitlab.com/raclettejs/core-dev/-/compare/v0.1.35...v0.1.36" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
+
+
+### Changed
+
+- Improved UX of workbenchs "create composition" flow
+- feat: Enhanced basedatatable to provide group by and footer slot abilities
+- WidgetLayout: removed icon as fallback option after image -> only render image or fallback block, never icon in WidgetRenderer
+- feat: added a workbench plugin which let's admins see all valkey entries in a datatable
+- Adjusted package.json to improve monorepo handling
+- Greatly imporoved the docs structure, hardened the code snipped interpolation logic
+
+### Updated
+
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @raclettejs/core@0.1.36
+
 ### Fixed
 
 - WidgetLayout: removed icon as fallback option after image -> only render image or fallback block, never icon in WidgetRenderer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raclettejs/workbench",
-  "version": "0.1.36-canary.1",
+  "version": "0.1.36",
   "license": "MIT",
   "description": "racletteJS Workbench - used to configure your application, for dev and prod",
   "repository": "https://gitlab.com/raclettejs/workbench",
@@ -33,7 +33,7 @@
     ".": "./index.ts"
   },
   "dependencies": {
-    "@raclettejs/core": "0.1.36-canary.1",
+    "@raclettejs/core": "0.1.36",
     "@vueuse/integrations": "14.2.1",
     "fuse.js": "7.1.0",
     "three": "0.183.2",
@@ -43,7 +43,7 @@
     "@emnapi/core": "1.9.2",
     "@emnapi/runtime": "1.9.2",
     "@eslint/js": "9.35.0",
-    "@raclettejs/types": "0.1.36-canary.1",
+    "@raclettejs/types": "0.1.36",
     "@sinclair/typebox": "0.34.48",
     "@types/ramda": "0.31.1",
     "@vueuse/core": "14.2.1",

package/plugins/raclette__cache/backend/helpers/cacheEntryBuilder.ts

@@ -11,6 +11,8 @@ export type CacheEntrySource = {
   valuePreview?: string
   truncated: boolean
   valueParsed?: unknown
+  /** True when `valueParsed` was built from the full stored value (not the transport slice). */
+  valueParsedFromFullValue?: boolean
   ttl: number
   ttlLabel: string
 }
@@ -51,6 +53,7 @@ export const buildCacheEntrySource = (
   const sanitized = sanitizeCacheEntryFields(truncatedFields)
 
   let valueParsed = sanitized.valueParsed
+  let valueParsedFromFullValue = false
 
   if (attachFullParsed && truncatedFields.truncated) {
     const fullSanitized = sanitizeCacheEntryFields({
@@ -59,6 +62,7 @@ export const buildCacheEntrySource = (
     })
     if (fullSanitized.valueParsed !== undefined) {
       valueParsed = fullSanitized.valueParsed
+      valueParsedFromFullValue = true
     }
   }
 
@@ -69,6 +73,7 @@ export const buildCacheEntrySource = (
     valuePreview: sanitized.valuePreview,
     truncated: sanitized.truncated,
     valueParsed,
+    valueParsedFromFullValue: valueParsedFromFullValue || undefined,
     ttl,
     ttlLabel: formatTtlLabel(ttl),
   }

package/plugins/raclette__cache/frontend/utils/formatCacheEntryDisplay.ts

@@ -0,0 +1,191 @@
+/** Injected into repaired JSON so viewers know the payload is incomplete. */
+export const TRUNCATION_MARKER = "__raclette_truncated__"
+
+const TRUNCATION_NOTICE =
+  "Value was cut for transport; remainder omitted. Do not treat as complete source of truth."
+
+type CacheEntryDisplaySource = {
+  value: string
+  truncated: boolean
+  valueParsed?: unknown
+  valueParsedFromFullValue?: boolean
+}
+
+const prettyJson = (value: unknown): string => JSON.stringify(value, null, 2)
+
+const appendTruncationNotice = (body: string): string =>
+  `${body}\n\n/* ${TRUNCATION_NOTICE} */`
+
+/**
+ * Close open strings/arrays/objects after an abrupt cut so JSON.parse may succeed
+ * on a prefix of the original document.
+ */
+export const repairTruncatedJson = (raw: string): string => {
+  const text = raw.trimEnd()
+  if (!text.length) {
+    return text
+  }
+
+  try {
+    JSON.parse(text)
+    return text
+  } catch {
+    // continue with repair
+  }
+
+  const stack: ("{" | "[")[] = []
+  let inString = false
+  let escaped = false
+  let lastCompleteTopLevel = 0
+
+  for (let i = 0; i < text.length; i++) {
+    const char = text[i]
+
+    if (inString) {
+      if (escaped) {
+        escaped = false
+      } else if (char === "\\") {
+        escaped = true
+      } else if (char === '"') {
+        inString = false
+      }
+      continue
+    }
+
+    if (char === '"') {
+      inString = true
+      continue
+    }
+
+    if (char === "{") {
+      stack.push("{")
+      continue
+    }
+
+    if (char === "[") {
+      stack.push("[")
+      continue
+    }
+
+    if (char === "}") {
+      if (stack.at(-1) === "{") {
+        stack.pop()
+        if (stack.length === 0) {
+          lastCompleteTopLevel = i + 1
+        }
+      }
+      continue
+    }
+
+    if (char === "]") {
+      if (stack.at(-1) === "[") {
+        stack.pop()
+        if (stack.length === 0) {
+          lastCompleteTopLevel = i + 1
+        }
+      }
+    }
+  }
+
+  let candidate = text
+  if (inString || stack.length > 0) {
+    if (lastCompleteTopLevel > 0) {
+      candidate = text.slice(0, lastCompleteTopLevel)
+    }
+  }
+
+  candidate = candidate.replace(/,\s*$/, "")
+
+  const openStack: ("{" | "[")[] = []
+  inString = false
+  escaped = false
+
+  for (let i = 0; i < candidate.length; i++) {
+    const char = candidate[i]
+    if (inString) {
+      if (escaped) escaped = false
+      else if (char === "\\") escaped = true
+      else if (char === '"') inString = false
+      continue
+    }
+    if (char === '"') {
+      inString = true
+      continue
+    }
+    if (char === "{") openStack.push("{")
+    else if (char === "[") openStack.push("[")
+    else if (char === "}" && openStack.at(-1) === "{") openStack.pop()
+    else if (char === "]" && openStack.at(-1) === "[") openStack.pop()
+  }
+
+  if (inString) {
+    const lastQuote = candidate.lastIndexOf('"')
+    candidate = lastQuote > 0 ? candidate.slice(0, lastQuote) : candidate
+    candidate = candidate.replace(/,\s*"[^"]*$/, "")
+    candidate = candidate.replace(/:\s*$/, "")
+  }
+
+  while (openStack.length > 0) {
+    const open = openStack.pop()
+    candidate += open === "{" ? "}" : "]"
+  }
+
+  candidate = candidate.replace(/,\s*([}\]])/g, "$1")
+
+  return candidate
+}
+
+const withTruncationMarker = (parsed: unknown): unknown => {
+  if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+    return {
+      ...parsed,
+      [TRUNCATION_MARKER]: TRUNCATION_NOTICE,
+    }
+  }
+
+  return {
+    [TRUNCATION_MARKER]: TRUNCATION_NOTICE,
+    value: parsed,
+  }
+}
+
+/**
+ * Pretty-print a cache entry for <pre> display.
+ * Recovers structure from truncated JSON when possible and always signals truncation.
+ */
+export const formatCacheEntryDisplay = (entry: CacheEntryDisplaySource): string => {
+  if (!entry.truncated) {
+    if (entry.valueParsed !== undefined) {
+      return prettyJson(entry.valueParsed)
+    }
+    try {
+      return prettyJson(JSON.parse(entry.value))
+    } catch {
+      return entry.value
+    }
+  }
+
+  if (
+    entry.valueParsed !== undefined &&
+    entry.valueParsedFromFullValue
+  ) {
+    return prettyJson(entry.valueParsed)
+  }
+
+  if (entry.valueParsed !== undefined) {
+    return appendTruncationNotice(prettyJson(entry.valueParsed))
+  }
+
+  try {
+    return appendTruncationNotice(prettyJson(JSON.parse(entry.value)))
+  } catch {
+    const repaired = repairTruncatedJson(entry.value)
+    try {
+      return appendTruncationNotice(
+        prettyJson(withTruncationMarker(JSON.parse(repaired))),
+      )
+    } catch {
+      return `${entry.value}\n\n… [${TRUNCATION_NOTICE}]`
+    }
+  }
+}

package/plugins/raclette__cache/frontend/widgets/CacheListWidget.vue

@@ -257,7 +257,11 @@
         </v-card-subtitle>
         <v-card-text>
           <v-alert
-            v-if="selectedEntry.truncated"
+            v-if="
+              selectedEntry.truncated &&
+              !selectedEntry.valueParsedFromFullValue &&
+              selectedEntry.valueParsed === undefined
+            "
             type="warning"
             density="compact"
             class="tw:mb-3"
@@ -294,6 +298,7 @@ import {
   isScalarFallbackResult,
   type ValueTableHeader,
 } from "../utils/cacheValueTableRows"
+import { formatCacheEntryDisplay } from "../utils/formatCacheEntryDisplay"
 import { computed, onMounted, ref } from "vue"
 import { useI18n } from "vue-i18n"
 
@@ -305,6 +310,7 @@ type CacheEntry = {
   valuePreview?: string
   truncated: boolean
   valueParsed?: unknown
+  valueParsedFromFullValue?: boolean
   ttl: number
   ttlLabel: string
 }
@@ -440,7 +446,7 @@ const showValueTruncatedWarning = computed(() => {
   if (!isValueView.value || !entry?.truncated) {
     return false
   }
-  return entry.valueParsed === undefined
+  return !entry.valueParsedFromFullValue && entry.valueParsed === undefined
 })
 
 const valueTableDataName = computed(() => {
@@ -530,6 +536,7 @@ const toTableRow = (entry: Partial<CacheEntry> & { key?: string }): CacheEntry =
     valuePreview: entry.valuePreview,
     truncated: entry.truncated ?? false,
     valueParsed: entry.valueParsed,
+    valueParsedFromFullValue: entry.valueParsedFromFullValue,
     ttl: entry.ttl ?? -2,
     ttlLabel: entry.ttlLabel ?? "",
   }
@@ -638,12 +645,7 @@ const displayValue = (item: CacheEntry) => {
   return item.value
 }
 
-const formatDetailValue = (item: CacheEntry) => {
-  if (item.valueParsed !== undefined) {
-    return JSON.stringify(item.valueParsed, null, 2)
-  }
-  return item.value
-}
+const formatDetailValue = (item: CacheEntry) => formatCacheEntryDisplay(item)
 
 const formatValueTableCell = (value: string | undefined) => value ?? ""