@dyrected/core 2.6.2 → 2.6.4

package/dist/utils/hooks.js

@@ -0,0 +1,177 @@
+import { getConfigLogger } from "../observability.js";
+/**
+ * Run a list of hook functions sequentially.
+ *
+ * Each hook receives the output of the previous hook merged back into the
+ * original `args`. When a hook returns a non-undefined value it becomes the
+ * `data` / `doc` for the next hook in the chain.
+ *
+ * Pass `{ isolated: true }` for hooks that run **after** a DB write has already
+ * been committed (`afterChange`, `afterDelete`). In isolated mode each hook is
+ * wrapped in a try/catch so a failing side-effect (email, webhook, etc.) never
+ * surfaces as an HTTP 500 to the caller — the write already succeeded.
+ */
+export async function runCollectionHooks(hooks, args, options = {}) {
+    if (!hooks || hooks.length === 0) {
+        return args.data ?? args.doc ?? undefined;
+    }
+    let currentPayload = args.data ?? args.doc ?? undefined;
+    for (const hook of hooks) {
+        try {
+            const result = await hook({
+                ...args,
+                data: args.data !== undefined ? currentPayload : undefined,
+                doc: args.doc !== undefined ? currentPayload : undefined,
+            });
+            if (result !== undefined) {
+                currentPayload = result;
+            }
+        }
+        catch (err) {
+            if (options.isolated) {
+                getConfigLogger(undefined, "hooks").error({
+                    err,
+                    msg: "Side-effect hook failed after a successful write",
+                });
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return currentPayload;
+}
+/**
+ * Execute field-level `beforeChange` hooks recursively on a data payload.
+ *
+ * Traverses `array`, `object`, and `blocks` fields depth-first so that nested
+ * field hooks fire on every item automatically.
+ */
+export async function executeFieldBeforeChange(fields, data, originalDoc, user, db) {
+    if (!data || typeof data !== "object")
+        return data;
+    const result = { ...data };
+    for (const field of fields) {
+        if (!field.name)
+            continue;
+        const value = result[field.name];
+        const origValue = originalDoc?.[field.name];
+        let updatedValue = value;
+        if (field.hooks?.beforeChange) {
+            for (const hook of field.hooks.beforeChange) {
+                const typedHook = hook;
+                const hookArgs = {
+                    value: updatedValue,
+                    originalDoc: originalDoc ?? undefined,
+                    data: result,
+                    user: user,
+                    db: db,
+                };
+                updatedValue = await typedHook(hookArgs);
+            }
+            result[field.name] = updatedValue;
+        }
+        // Recurse into nested structures
+        if (updatedValue !== undefined && updatedValue !== null) {
+            if (field.type === "object" && field.fields) {
+                result[field.name] = await executeFieldBeforeChange(field.fields, updatedValue, origValue, user, db);
+            }
+            else if (field.type === "array" &&
+                field.fields &&
+                Array.isArray(updatedValue)) {
+                const arrayResult = [];
+                for (let i = 0; i < updatedValue.length; i++) {
+                    const item = updatedValue[i];
+                    const origItem = Array.isArray(origValue)
+                        ? origValue[i]
+                        : null;
+                    arrayResult.push(await executeFieldBeforeChange(field.fields, item, origItem, user, db));
+                }
+                result[field.name] = arrayResult;
+            }
+            else if (field.type === "blocks" &&
+                field.blocks &&
+                Array.isArray(updatedValue)) {
+                const blocksResult = [];
+                for (let i = 0; i < updatedValue.length; i++) {
+                    const blockData = updatedValue[i];
+                    const origBlock = Array.isArray(origValue)
+                        ? origValue[i]
+                        : null;
+                    const blockConfig = field.blocks.find((b) => b.slug === blockData.blockType);
+                    if (blockConfig) {
+                        blocksResult.push(await executeFieldBeforeChange(blockConfig.fields, blockData, origBlock, user, db));
+                    }
+                    else {
+                        blocksResult.push(blockData);
+                    }
+                }
+                result[field.name] = blocksResult;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Execute field-level `afterRead` hooks recursively on a document.
+ *
+ * Traverses `array`, `object`, and `blocks` fields depth-first so that nested
+ * field hooks fire on every item automatically.
+ */
+export async function executeFieldAfterRead(fields, doc, user, db) {
+    if (!doc || typeof doc !== "object")
+        return doc;
+    const result = { ...doc };
+    for (const field of fields) {
+        if (!field.name)
+            continue;
+        const value = result[field.name];
+        let updatedValue = value;
+        if (field.hooks?.afterRead) {
+            for (const hook of field.hooks.afterRead) {
+                const typedHook = hook;
+                const hookArgs = {
+                    value: updatedValue,
+                    doc: result,
+                    user: user,
+                    db: db,
+                };
+                updatedValue = await typedHook(hookArgs);
+            }
+            result[field.name] = updatedValue;
+        }
+        // Recurse into nested structures
+        if (updatedValue !== undefined && updatedValue !== null) {
+            if (field.type === "object" && field.fields) {
+                result[field.name] = await executeFieldAfterRead(field.fields, updatedValue, user, db);
+            }
+            else if (field.type === "array" &&
+                field.fields &&
+                Array.isArray(updatedValue)) {
+                const arrayResult = [];
+                for (const item of updatedValue) {
+                    arrayResult.push(await executeFieldAfterRead(field.fields, item, user, db));
+                }
+                result[field.name] = arrayResult;
+            }
+            else if (field.type === "blocks" &&
+                field.blocks &&
+                Array.isArray(updatedValue)) {
+                const blocksResult = [];
+                for (const blockData of updatedValue) {
+                    const typedBlock = blockData;
+                    const blockConfig = field.blocks.find((b) => b.slug === typedBlock.blockType);
+                    if (blockConfig) {
+                        blocksResult.push(await executeFieldAfterRead(blockConfig.fields, typedBlock, user, db));
+                    }
+                    else {
+                        blocksResult.push(blockData);
+                    }
+                }
+                result[field.name] = blocksResult;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/utils/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/utils/hooks.ts"],"names":[],"mappings":"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"}

package/dist/utils/openapi.d.ts

@@ -0,0 +1,6 @@
+import type { DyrectedConfig } from "../types/index.js";
+/**
+ * Generate an OpenAPI 3.0 specification based on the Dyrected configuration.
+ */
+export declare function generateOpenApi(config: DyrectedConfig): any;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/utils/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/utils/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAgB3B;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,OA2zBrD"}