@nestjs/workflows 0.0.2 → 0.0.4

package/dist/utils/storable-text.util.js

@@ -0,0 +1,96 @@
+/** `'U+0000'` when `text` holds it (PostgreSQL keeps it in neither `text` nor `jsonb`), else `undefined`. */
+export function nulIn(text) {
+    return text.includes('\u0000') ? 'U+0000' : undefined;
+}
+/** `'a lone UTF-16 surrogate'` when `text` holds one (PostgreSQL and MySQL refuse it in JSON), else `undefined`. */
+export function loneSurrogateIn(text) {
+    return text.isWellFormed() ? undefined : 'a lone UTF-16 surrogate';
+}
+/**
+ * The first string of a JSON value (what `JSON.parse()` returns), a value or an object's key, that `check` refuses,
+ * with its path (`$.lines[0].note`), or `undefined`. Walks with a stack of its own, so a value as deep as
+ * `JSON.stringify()` takes can't overflow the call stack; the path is built only for what it finds.
+ */
+export function findUnstorableText(value, check) {
+    const pending = [{ value, parent: undefined, at: undefined }];
+    for (let step = pending.pop(); step; step = pending.pop()) {
+        if (step.keyProblem) {
+            return { path: `${pathOf(step)} (its key)`, problem: step.keyProblem };
+        }
+        const current = step.value;
+        if (typeof current === 'string') {
+            const problem = check(current);
+            if (problem) {
+                return { path: pathOf(step), problem };
+            }
+        }
+        else if (Array.isArray(current)) {
+            // Last first, so the first is checked first. Numbers, booleans and null hold no text.
+            for (let i = current.length - 1; i >= 0; i--) {
+                if (holdsText(current[i])) {
+                    pending.push({ value: current[i], parent: step, at: i });
+                }
+            }
+        }
+        else if (current !== null && typeof current === 'object') {
+            const keys = Object.keys(current);
+            for (let i = keys.length - 1; i >= 0; i--) {
+                const key = keys[i];
+                const child = current[key];
+                const keyProblem = check(key);
+                if (keyProblem || holdsText(child)) {
+                    pending.push({ value: child, parent: step, at: key, keyProblem });
+                }
+            }
+        }
+    }
+    return undefined;
+}
+/** Throws a `TypeError` that names `what` when `check` refuses `text`. */
+export function assertStorableText(what, text, check) {
+    const problem = check && typeof text === 'string' ? check(text) : undefined;
+    if (problem) {
+        throw unstorable(what, problem);
+    }
+}
+/** The same for a JSON value (what `normalize()` returns), naming where in `what` the text sits. */
+export function assertStorableJson(what, value, check) {
+    const refused = unstorableJson(what, value, check);
+    if (refused) {
+        throw refused;
+    }
+}
+/** `assertStorableJson()`'s error, for a caller that reports it in its own way, or `undefined`. */
+export function unstorableJson(what, value, check) {
+    const found = check && findUnstorableText(value, check);
+    return found ? unstorable(`${what} at ${found.path}`, found.problem) : undefined;
+}
+/**
+ * `text`, with U+0000 and lone surrogates replaced with U+FFFD when `check` refuses it: for an error's text, which is
+ * recorded whatever it holds.
+ */
+export function storableText(text, check) {
+    return check?.(text) === undefined ? text : text.replaceAll('\u0000', '�').toWellFormed();
+}
+function unstorable(where, problem) {
+    return new TypeError(`${where} holds ${problem}, which the workflow store can't keep.`);
+}
+function holdsText(value) {
+    return typeof value === 'string' || (value !== null && typeof value === 'object');
+}
+function pathOf(step) {
+    let path = '';
+    for (let at = step; at; at = at.parent) {
+        path = segment(at.at) + path;
+    }
+    return path;
+}
+function segment(at) {
+    if (at === undefined) {
+        return '$';
+    }
+    if (typeof at === 'number') {
+        return `[${at}]`;
+    }
+    return /^[A-Za-z_$][\w$]*$/.test(at) ? `.${at}` : `[${JSON.stringify(at)}]`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/workflows",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Nest - modern, fast, powerful node.js web framework (@workflows)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -51,6 +51,7 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "format": "prettier --write \"**/*.ts\"",
     "lint": "oxlint lib/",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
     "generate:prisma": "prisma generate --config tests/fixtures/prisma/prisma.config.ts && prisma generate --config tests/fixtures/prisma-mysql/prisma.config.ts",
     "prepublish:npm": "npm run build",
     "publish:npm": "npm publish --access public",
@@ -66,40 +67,40 @@
     "@nestjs/store-kit": "^0.1.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "21.2.3",
-    "@commitlint/config-angular": "21.2.3",
-    "@electric-sql/pglite": "0.5.8",
-    "@nestjs/common": "12.1.2",
-    "@nestjs/core": "12.1.2",
-    "@nestjs/cqrs": "12.1.0",
-    "@nestjs/drizzle": "0.0.1",
-    "@nestjs/locks": "0.0.1",
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-angular": "21.2.4",
+    "@electric-sql/pglite": "0.5.12",
+    "@nestjs/common": "12.2.0",
+    "@nestjs/core": "12.2.0",
+    "@nestjs/cqrs": "12.1.1",
+    "@nestjs/drizzle": "0.0.2",
+    "@nestjs/locks": "0.0.4",
     "@nestjs/mail": "0.0.1",
-    "@nestjs/outbox": "0.1.0",
-    "@nestjs/platform-express": "12.1.2",
-    "@nestjs/platform-fastify": "12.1.2",
-    "@nestjs/testing": "12.1.2",
-    "@prisma/adapter-mariadb": "7.10.0",
-    "@prisma/adapter-pg": "7.10.0",
-    "@prisma/client": "7.10.0",
-    "@types/node": "24.19.1",
+    "@nestjs/outbox": "0.1.3",
+    "@nestjs/platform-express": "12.2.0",
+    "@nestjs/platform-fastify": "12.2.0",
+    "@nestjs/testing": "12.2.0",
+    "@prisma/adapter-mariadb": "7.10.1",
+    "@prisma/adapter-pg": "7.10.1",
+    "@prisma/client": "7.10.1",
+    "@types/node": "24.19.2",
     "@types/pg": "8.23.1",
-    "drizzle-orm": "0.45.3",
+    "drizzle-orm": "0.45.4",
     "husky": "9.1.7",
-    "kysely": "0.29.6",
+    "kysely": "0.29.7",
     "lint-staged": "17.6.0",
-    "mysql2": "3.24.5",
-    "oxlint": "1.87.0",
+    "mysql2": "3.24.6",
+    "oxlint": "1.89.0",
     "pg": "8.23.1",
-    "prettier": "3.9.9",
-    "prisma": "7.10.0",
+    "prettier": "3.9.10",
+    "prisma": "7.10.1",
     "reflect-metadata": "0.2.2",
     "release-it": "21.1.1",
     "rxjs": "7.8.2",
-    "typeorm": "1.1.1",
+    "typeorm": "1.1.2",
     "typescript": "7.0.2",
-    "vite": "8.3.3",
-    "vitest": "5.0.3"
+    "vite": "8.3.5",
+    "vitest": "5.0.5"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0 || ^12.0.0",