@warlock.js/cascade 5.19.1 → 5.20.0

package/esm/transactions/after-commit.mjs

@@ -0,0 +1,47 @@
+import { databaseTransactionContext } from "../context/database-transaction-context.mjs";
+import { log } from "@warlock.js/logger";
+
+//#region ../cascade/src/transactions/after-commit.ts
+function reportFailure(error) {
+	log.error("database", "afterCommit", `[cascade] afterCommit callback failed: ${error}`);
+}
+/**
+* Run a callback only once the current transaction has COMMITTED.
+*
+* Model events (`saved`, `created`, `updated`, `deleted`) fire INSIDE the
+* transaction, before COMMIT. Anything that must observe committed data
+* (cache invalidation, sitemap regeneration, webhooks) belongs here.
+*
+* - Inside a transaction: queued, run after the outermost COMMIT, in order,
+*   awaited one by one. Discarded on rollback or a failed COMMIT.
+* - Outside a transaction: run on the next microtask (not awaited by the caller).
+* - A callback that throws is logged; it never affects the transaction result
+*   or the remaining callbacks.
+* - Callbacks run after the transaction context has exited, so any DB work
+*   they do is outside the finished transaction.
+*
+* @example
+* Product.events().onSaved(() => afterCommit(() => regenerateSitemap()));
+*/
+function afterCommit(fn) {
+	if (databaseTransactionContext.hasActiveTransaction()) {
+		databaseTransactionContext.addAfterCommit(fn);
+		return;
+	}
+	Promise.resolve().then(fn).catch(reportFailure);
+}
+/**
+* Run committed callbacks sequentially. Never throws.
+* Drivers call this after a successful COMMIT and after the context exited.
+*/
+async function flushAfterCommit(callbacks) {
+	for (const callback of callbacks) try {
+		await callback();
+	} catch (error) {
+		reportFailure(error);
+	}
+}
+
+//#endregion
+export { afterCommit, flushAfterCommit };
+//# sourceMappingURL=after-commit.mjs.map

package/esm/transactions/after-commit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-commit.mjs","names":[],"sources":["../../../../../../../cascade/src/transactions/after-commit.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\nimport { databaseTransactionContext } from \"../context/database-transaction-context\";\n\ntype AfterCommitCallback = () => void | Promise<void>;\n\nfunction reportFailure(error: unknown): void {\n  log.error(\"database\", \"afterCommit\", `[cascade] afterCommit callback failed: ${error}`);\n}\n\n/**\n * Run a callback only once the current transaction has COMMITTED.\n *\n * Model events (`saved`, `created`, `updated`, `deleted`) fire INSIDE the\n * transaction, before COMMIT. Anything that must observe committed data\n * (cache invalidation, sitemap regeneration, webhooks) belongs here.\n *\n * - Inside a transaction: queued, run after the outermost COMMIT, in order,\n *   awaited one by one. Discarded on rollback or a failed COMMIT.\n * - Outside a transaction: run on the next microtask (not awaited by the caller).\n * - A callback that throws is logged; it never affects the transaction result\n *   or the remaining callbacks.\n * - Callbacks run after the transaction context has exited, so any DB work\n *   they do is outside the finished transaction.\n *\n * @example\n * Product.events().onSaved(() => afterCommit(() => regenerateSitemap()));\n */\nexport function afterCommit(fn: AfterCommitCallback): void {\n  if (databaseTransactionContext.hasActiveTransaction()) {\n    databaseTransactionContext.addAfterCommit(fn);\n    return;\n  }\n\n  Promise.resolve().then(fn).catch(reportFailure);\n}\n\n/**\n * Run committed callbacks sequentially. Never throws.\n * Drivers call this after a successful COMMIT and after the context exited.\n */\nexport async function flushAfterCommit(callbacks: AfterCommitCallback[]): Promise<void> {\n  for (const callback of callbacks) {\n    try {\n      await callback();\n    } catch (error) {\n      reportFailure(error);\n    }\n  }\n}\n"],"mappings":";;;;AAKA,SAAS,cAAc,OAAsB;CAC3C,IAAI,MAAM,YAAY,eAAe,0CAA0C,OAAO;AACxF;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,YAAY,IAA+B;CACzD,IAAI,2BAA2B,qBAAqB,GAAG;EACrD,2BAA2B,eAAe,EAAE;EAC5C;CACF;CAEA,QAAQ,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,aAAa;AAChD;;;;;AAMA,eAAsB,iBAAiB,WAAiD;CACtF,KAAK,MAAM,YAAY,WACrB,IAAI;EACF,MAAM,SAAS;CACjB,SAAS,OAAO;EACd,cAAc,KAAK;CACrB;AAEJ"}