@voltro/plugin-progression 0.0.0-stage → 0.87.0

package/dist/rewardDelivery.server.js

@@ -0,0 +1,430 @@
+import { ProgressionError as e, progressionError as t } from "./errors.js";
+import { captureArguments as n, identifier as r, integer as i, list as a, object as o } from "./capture.js";
+import { captureReward as s } from "./reward.js";
+import { captureTutorialEvidence as c, captureTutorialState as l, defineTutorial as u, resolveTutorialSkip as d, resolveTutorialStep as f } from "./tutorial.js";
+import { capturePassState as p, defineSeasonPass as m } from "./pass.js";
+import { defineQuest as h } from "./quests.js";
+import { captureDailyState as g, defineLoginCalendar as _ } from "./daily.js";
+import { admitRewardDeliveryRecord as v } from "./rewardDeliveryRecord.js";
+import { progressionOperationsTable as y, progressionRewardsTable as b, progressionSubjectsTable as x } from "./tables.entity.js";
+import { questOperationsTable as S, questRewardsTable as C, questSubjectsTable as w, questsTable as T } from "./questTables.entity.js";
+import { questHash as E } from "./questStore.js";
+import { defineAchievement as D } from "./achievements.js";
+import { achievementDefinitionsTable as O, achievementOperationsTable as k, achievementRewardsTable as ee, achievementSubjectsTable as te, achievementUnlockLedgerTable as ne } from "./achievementTables.entity.js";
+import { dailyClaimsTable as re, dailyDefinitionsTable as ie, dailyOperationsTable as ae, dailyRewardsTable as oe, dailySubjectsTable as se } from "./dailyTables.entity.js";
+import { applyPassIntent as ce, capturePassIntent as le } from "./passRules.js";
+import { passDefinitionsTable as ue, passLedgerTable as de, passOperationsTable as fe, passRewardsTable as pe, passSubjectsTable as me } from "./passTables.entity.js";
+import { tutorialDefinitionsTable as he, tutorialLedgerTable as ge, tutorialOperationsTable as _e, tutorialRewardsTable as ve, tutorialSubjectsTable as ye } from "./tutorialTables.entity.js";
+import { rankOperationsTable as A, rankRewardsTable as j, rankSubjectsTable as M } from "./rankTables.entity.js";
+import { admitRankRewardParent as N } from "./rankRewardParent.server.js";
+import { Effect as P, Result as be, Schema as xe } from "effect";
+import { WorkflowRunHandleSchema as Se, systemSubject as Ce } from "@voltro/protocol";
+import { and as we, eq as F, gt as Te, queryFor as I } from "@voltro/database";
+//#region src/rewardDelivery.server.ts
+var L = [
+	"level",
+	"quest",
+	"achievement",
+	"daily",
+	"pass",
+	"tutorial",
+	"rank"
+], R = (e) => {
+	let i = o(e, [
+		"systemAccount",
+		"economy",
+		"inventory",
+		"progression",
+		"allowedServices",
+		"now",
+		"version",
+		"service"
+	]), a = (e, n) => {
+		if (e === void 0) return;
+		let r = o(e);
+		if (n.some((e) => typeof r[e] != "function")) throw t("invalid_input");
+		return Object.freeze(Object.fromEntries(n.map((e) => [e, r[e]])));
+	}, s = a(i.economy, [
+		"transfer",
+		"mine",
+		"auditWallet",
+		"rebuildWallet"
+	]), c = a(i.inventory, [
+		"grant",
+		"consume",
+		"mine",
+		"loadout",
+		"equip",
+		"expire",
+		"exportSubject",
+		"eraseSubject"
+	]), l = a(i.progression, [
+		"applyXp",
+		"applyStat",
+		"mine",
+		"stats",
+		"exportSubject",
+		"eraseSubject"
+	]), u = a(i.service, ["execute", "dispatch"]), d = i.now ?? Date.now, f = n(i.allowedServices ?? []);
+	if (!Array.isArray(f) || f.length > 256 || new Set(f).size !== f.length || typeof d != "function" || !u && !s && !c && !l) throw t("invalid_input");
+	return Object.freeze({
+		systemAccount: r(i.systemAccount),
+		version: r(i.version ?? "default.v1"),
+		economy: s,
+		inventory: c,
+		progression: l,
+		service: u,
+		allowedServices: Object.freeze(f.map(r)),
+		now: d
+	});
+}, z = (e, ...t) => e + E(t).slice(0, 56), B = (e) => {
+	let n = e instanceof Date ? e.getTime() : typeof e == "string" ? Date.parse(e) : NaN;
+	if (!Number.isSafeInteger(n) || n < 0 || n > 864e13) throw t("invalid_record");
+	return n;
+}, V = (n) => P.tryPromise({
+	try: n,
+	catch: (n) => n instanceof e ? n : t("unavailable")
+}), H = (e) => {
+	let n = o(e, ["kind", "rewardId"]);
+	if (!L.some((e) => e === n.kind)) throw t("invalid_input");
+	return Object.freeze({
+		kind: n.kind,
+		rewardId: r(n.rewardId)
+	});
+}, U = (U, Ee, De) => {
+	let W = R(Ee), G = Object.freeze(De.map((e) => {
+		if (!L.includes(e)) throw t("invalid_input");
+		return e;
+	})), K = new Set(W.allowedServices);
+	if (new Set(G).size !== G.length || G.length === 0) throw t("invalid_input");
+	let q = () => i(W.now(), 0, 864e13), J = Ce("progression.reward.delivery"), Y = (e) => {
+		if (e.type !== "system" && !(e.type === "service" && K.has(e.service))) throw t("forbidden");
+	}, X = (e) => {
+		if (!G.includes(e)) throw t("invalid_input");
+		return e === "level" ? {
+			rewards: b,
+			subjects: x,
+			operations: y,
+			prefix: "pgs_"
+		} : e === "quest" ? {
+			rewards: C,
+			subjects: w,
+			operations: S,
+			prefix: "qps_"
+		} : e === "achievement" ? {
+			rewards: ee,
+			subjects: te,
+			operations: k,
+			prefix: "pas_"
+		} : e === "daily" ? {
+			rewards: oe,
+			subjects: se,
+			operations: ae,
+			prefix: "pds_"
+		} : e === "pass" ? {
+			rewards: pe,
+			subjects: me,
+			operations: fe,
+			prefix: "pps_"
+		} : e === "tutorial" ? {
+			rewards: ve,
+			subjects: ye,
+			operations: _e,
+			prefix: "pts_"
+		} : {
+			rewards: j,
+			subjects: M,
+			operations: A,
+			prefix: "prs_"
+		};
+	}, Z = async (e, t) => (await e.query(I(X(t.kind).rewards).where(F("id", t.rewardId)).limit(1).descriptor))[0], Oe = (e, n) => {
+		let i = r(n.tenantId), a = r(n.ownerId), o = z(X(e).prefix, i, a);
+		if (n.ownerKey !== o) throw t("invalid_record");
+		return {
+			tenantId: i,
+			ownerId: a,
+			ownerKey: o
+		};
+	}, Q = async (e, n, v) => {
+		let y = Oe(n.kind, v), b = X(n.kind);
+		if (await e.updateMany(b.subjects.tableName, { admission: 0 }, { where: F("id", y.ownerKey) }) !== 1) throw t("invalid_record");
+		let x = (await e.query(I(b.subjects).where(F("id", y.ownerKey)).limit(1).descriptor))[0];
+		if (!x || x.tenantId !== y.tenantId || x.ownerId !== y.ownerId || x.erased !== !1) throw t(x?.erased === !0 ? "erased" : "invalid_record");
+		let S = (await e.query(I(b.operations).where(F("id", r(v.operationId))).limit(1).descriptor))[0];
+		if (!S || S.tenantId !== y.tenantId || S.ownerKey !== y.ownerKey || S.state !== "committed" || S.receipt === null) throw t("invalid_record");
+		let C = o(S.receipt), w = B(v.createdAt);
+		if (C.operationId !== S.id || C.at !== w) throw t("invalid_record");
+		if (n.kind === "level") {
+			let e = o(C.change), n = i(C.rewardsQueued, 1, 256);
+			if (e.kind !== "xp" || v.id === void 0 || !Array.from({ length: n }, (e, t) => z("pgr_", r(v.operationId), String(t))).includes(String(v.id))) throw t("invalid_record");
+			i(v.level, i(e.fromLevel, 1, 1e4) + 1, i(e.toLevel, 1, 1e4));
+		} else if (n.kind === "quest") {
+			let n = r(v.assignmentId), i = (await e.query(I(T).where(F("id", n)).limit(1).descriptor))[0];
+			if (C.kind !== "record" || !a(C.completedIds, 8).includes(n) || !i || i.tenantId !== y.tenantId || i.ownerId !== y.ownerId || i.state !== "completed" || B(i.completedAt) !== w) throw t("invalid_record");
+			let o = h(i.definition), c = o.reward.findIndex((e, t) => z("qpr_", n, String(t)) === v.id);
+			if (c < 0 || E(s(v.reward)) !== E(o.reward[c])) throw t("invalid_record");
+		} else if (n.kind === "achievement") {
+			let n = r(v.unlockId), o = (await e.query(I(ne).where(F("unlockId", n)).limit(1).descriptor))[0];
+			if (!a(C.unlockedIds, 256).includes(n) || !o || o.tenantId !== y.tenantId || o.ownerId !== y.ownerId || o.ownerKey !== y.ownerKey || o.operationId !== v.operationId) throw t("invalid_record");
+			let c = (await e.query(I(O).where(F("id", z("pad_", y.tenantId, r(o.achievementId), String(i(o.version, 1, 1e6))))).limit(1).descriptor))[0];
+			if (!c || c.tenantId !== y.tenantId || c.achievementId !== o.achievementId || c.version !== o.version) throw t("invalid_record");
+			let l = D(c.config).tiers.find((e) => e.id === o.tierId), u = l?.reward.findIndex((e, t) => z("par_", n, String(t)) === v.id) ?? -1;
+			if (!l || u < 0 || E(s(v.reward)) !== E(l.reward[u])) throw t("invalid_record");
+		} else if (n.kind === "daily") {
+			let n = r(v.claimId), a = (await e.query(I(re).where(F("id", n)).limit(1).descriptor))[0];
+			if (C.claimId !== n || !a || a.tenantId !== y.tenantId || a.ownerId !== y.ownerId || a.ownerKey !== y.ownerKey || a.operationId !== v.operationId || B(a.at) !== w) throw t("invalid_record");
+			let o = r(a.calendarId), c = i(a.version, 1, 1e6), l = (await e.query(I(ie).where(F("id", z("pdd_", y.tenantId, o, String(c)))).limit(1).descriptor))[0];
+			if (!l || l.tenantId !== y.tenantId || l.calendarId !== o || l.version !== c) throw t("invalid_record");
+			let u = _(l.config), d = g(a.after, u), f = u.days[d.dayIndex].findIndex((e, t) => z("pdr_", n, String(t)) === v.id);
+			if (n !== z("pdl_", y.tenantId, y.ownerId, o, String(c), String(d.dayOrdinal)) || a.dayOrdinal !== d.dayOrdinal || a.dayKey !== d.dayKey || C.dayKey !== d.dayKey || C.calendarId !== o || E(C.after) !== E(d) || f < 0 || E(s(v.reward)) !== E(u.days[d.dayIndex][f])) throw t("invalid_record");
+		} else if (n.kind === "pass") {
+			let n = r(v.passId), a = i(v.version, 1, 1e6), o = i(v.tier, 1, 256);
+			if (v.track !== "free" && v.track !== "premium") throw t("invalid_record");
+			let c = (await e.query(I(ue).where(F("id", z("ppd_", y.tenantId, n, String(a)))).limit(1).descriptor))[0], l = (await e.query(I(de).where(F("id", z("ppl_", r(v.operationId)))).limit(1).descriptor))[0];
+			if (!c || c.tenantId !== y.tenantId || c.passId !== n || c.version !== a || !l || l.tenantId !== y.tenantId || l.ownerId !== y.ownerId || l.ownerKey !== y.ownerKey || l.passId !== n || l.version !== a || l.operationId !== v.operationId || B(l.at) !== w) throw t("invalid_record");
+			let u = m(c.config), d = le(l.intent, u), f = ce(u, p(l.before, u), d, w);
+			if (C.kind !== d.kind || E(f.after) !== E(l.after) || E(f.after) !== E(C.after) || E(f.claims) !== E(C.claims)) throw t("invalid_record");
+			let h = f.claims.find((e) => e.track === v.track && e.tier === o), g = h?.rewards.findIndex((e, t) => z("ppr_", y.tenantId, y.ownerId, n, String(a), String(v.track), String(o), String(t)) === v.id) ?? -1;
+			if (!h || g < 0 || E(s(v.reward)) !== E(h.rewards[g])) throw t("invalid_record");
+		} else if (n.kind === "tutorial") {
+			let n = r(v.tutorialId), a = i(v.version, 1, 1e6), p = (await e.query(I(ge).where(F("id", z("ptl_", r(v.operationId)))).limit(1).descriptor))[0], m = (await e.query(I(he).where(F("id", z("ptd_", y.tenantId, n, String(a)))).limit(1).descriptor))[0];
+			if (!p || p.tenantId !== y.tenantId || p.ownerId !== y.ownerId || p.ownerKey !== y.ownerKey || p.operationId !== v.operationId || p.tutorialId !== n || p.version !== a || B(p.at) !== w || !m || m.tenantId !== y.tenantId || m.tutorialId !== n || m.version !== a) throw t("invalid_record");
+			let h = u(m.config), g = l(p.before, h), _ = o(p.intent, [
+				"tutorialId",
+				"version",
+				"kind",
+				"step",
+				"mode",
+				"source",
+				"originId",
+				"evidence"
+			]), b = o(S.intent, [
+				"tutorialId",
+				"version",
+				"kind",
+				"step",
+				"mode",
+				"source",
+				"originId"
+			]), { evidence: x, ...T } = _;
+			if (_.tutorialId !== n || _.version !== a || E(T) !== E(b) || C.kind !== _.kind || C.step !== _.step || _.mode !== "player" && _.mode !== "event" || _.mode === "player" && (_.source !== null || _.originId !== null) || _.kind === "skip" && (_.mode !== "player" || _.step !== null)) throw t("invalid_record");
+			if (_.kind === "step" && _.mode === "event") {
+				let e = c(x, w);
+				if (e.source !== _.source || e.originId !== _.originId || e.version !== "trusted.event.v1") throw t("invalid_record");
+			}
+			let D = _.kind === "step" ? f({
+				tutorial: h,
+				before: g,
+				step: r(_.step),
+				evidence: c(x, w),
+				at: w
+			}) : _.kind === "skip" && x === null ? d(h, g, w) : void 0, O = h.reward.findIndex((e, t) => z("ptr_", y.tenantId, y.ownerId, n, String(a), String(t)) === v.id);
+			if (!D || !D.completed || D.skipped && !h.rewardOnSkip || E(D) !== E(p.after) || E(D) !== E(C.after) || C.rewardsQueued !== h.reward.length || O < 0 || E(s(v.reward)) !== E(h.reward[O])) throw t("invalid_record");
+		} else await N(e, v, y, S, i(x.sequence, 1, 2147483647));
+		return y;
+	}, ke = (e, n) => {
+		let a = o(n.deliveryReceipt, [
+			"kind",
+			"rewardId",
+			"status",
+			"outputKind",
+			"externalOperationId",
+			"at"
+		]);
+		if (a.kind !== e.kind || a.rewardId !== e.rewardId || a.status !== "delivered" || a.outputKind !== "currency" && a.outputKind !== "item" && a.outputKind !== "xp" || a.at !== B(n.deliveredAt)) throw t("invalid_record");
+		return Object.freeze({
+			...e,
+			status: "delivered",
+			outputKind: a.outputKind,
+			externalOperationId: r(a.externalOperationId),
+			at: i(a.at, 0, 864e13)
+		});
+	}, Ae = (e) => Object.freeze({
+		...e,
+		status: "erased",
+		outputKind: null,
+		externalOperationId: null,
+		at: q()
+	}), $ = (e, n) => {
+		if (!n || n.id !== e.rewardId) throw t("invalid_input");
+		if (v(n, e.kind, E), n.state === "erased") {
+			if (n.ownerId !== null || n.ownerKey !== null || n.reward !== null || n.deliveryIntent != null || n.deliveryDigest != null || n.deliveryReceipt != null) throw t("invalid_record");
+			return Ae(e);
+		}
+		if (n.state === "delivered") return ke(e, n);
+		if (n.state !== "pending" || n.deliveredAt !== null || n.deliveryReceipt != null) throw t("invalid_record");
+	};
+	return Object.freeze({
+		execute: (c, l) => {
+			try {
+				let e = n(c);
+				Y(e);
+				let u = H(l);
+				return X(u.kind), V(async () => {
+					let e = await U.transactional(async (e) => {
+						let n = await Z(e, u), r = $(u, n);
+						if (r) return { receipt: r };
+						let i = await Q(e, u, n), a = await Z(e, u), o = $(u, a);
+						if (o) return { receipt: o };
+						if (!a || a.ownerId !== i.ownerId || a.tenantId !== i.tenantId || a.ownerKey !== i.ownerKey) throw t("invalid_record");
+						let c = s(a.reward);
+						if (c.kind === "currency" && !W.economy || c.kind === "item" && !W.inventory || c.kind === "xp" && !W.progression) throw t("unavailable");
+						let l = Object.freeze({
+							...i,
+							reward: c,
+							kind: u.kind,
+							rewardId: u.rewardId,
+							requestId: z("reward_", u.kind, u.rewardId),
+							sourceVersion: W.version,
+							systemAccount: W.systemAccount
+						}), d = E(l);
+						if (a.deliveryIntent != null || a.deliveryDigest != null) {
+							if (a.deliveryDigest !== d || E(a.deliveryIntent) !== d) throw t("conflict");
+						} else await e.update(X(u.kind).rewards.tableName, u.rewardId, {
+							deliveryIntent: l,
+							deliveryDigest: d
+						});
+						return {
+							intent: l,
+							digest: d
+						};
+					});
+					if ("receipt" in e) return e.receipt;
+					let { intent: n, digest: c } = e;
+					if (!n || !c) throw t("invalid_record");
+					let l = n.reward, d = async (e) => {
+						let n = await P.runPromise(P.result(e));
+						if (be.isFailure(n)) throw t("unavailable");
+						return o(n.success);
+					}, f;
+					if (l.kind === "currency") {
+						let e = await d(W.economy.transfer(J, {
+							tenantId: n.tenantId,
+							requestId: n.requestId,
+							currency: l.currency,
+							from: {
+								kind: "system",
+								id: n.systemAccount
+							},
+							to: {
+								kind: "wallet",
+								ownerId: n.ownerId,
+								ownerKind: "player"
+							},
+							amount: l.amount,
+							reason: "progression.reward",
+							ref: {
+								kind: "progression.reward",
+								id: n.rewardId
+							}
+						}));
+						if (e.currency !== l.currency || e.amount !== l.amount) throw t("invalid_record");
+						f = r(e.txId), i(e.at, 0, 864e13);
+					} else if (l.kind === "item") {
+						let e = await d(W.inventory.grant(J, {
+							tenantId: n.tenantId,
+							owner: {
+								ownerKind: "player",
+								ownerId: n.ownerId
+							},
+							requestId: n.requestId,
+							itemId: l.itemId,
+							qty: l.qty,
+							reason: "progression.reward",
+							ref: {
+								kind: "progression.reward",
+								id: n.rewardId
+							}
+						})), s = a(e.changes, 1e5);
+						if (e.kind !== "grant" || !Array.isArray(s) || s.length > 1e5 || s.reduce((e, t) => {
+							let n = o(t, ["instanceId", "delta"]);
+							return r(n.instanceId), e + i(n.delta, 1, 1e6);
+						}, 0) !== l.qty) throw t("invalid_record");
+						f = r(e.operationId), i(e.at, 0, 864e13);
+					} else {
+						let e = await d(W.progression.applyXp(J, {
+							tenantId: n.tenantId,
+							ownerId: n.ownerId,
+							trackId: l.trackId,
+							amount: l.amount,
+							requestId: n.requestId,
+							source: "progression.reward",
+							origin: n.rewardId
+						})), a = o(e.change, [
+							"kind",
+							"trackId",
+							"xp",
+							"delta",
+							"fromLevel",
+							"toLevel"
+						]);
+						if (a.kind !== "xp" || a.trackId !== l.trackId || a.delta !== l.amount) throw t("invalid_record");
+						f = r(e.operationId), i(e.at, 0, 864e13);
+					}
+					return U.transactional(async (e) => {
+						let n = await Z(e, u), r = $(u, n);
+						if (r) return r;
+						let i = await Q(e, u, n), a = await Z(e, u), o = $(u, a);
+						if (o) return o;
+						if (!a || a.tenantId !== i.tenantId || a.ownerId !== i.ownerId || a.deliveryDigest !== c || E(a.deliveryIntent) !== c) throw t("conflict");
+						let s = q(), d = Object.freeze({
+							...u,
+							status: "delivered",
+							outputKind: l.kind,
+							externalOperationId: f,
+							at: s
+						});
+						if (s < B(a.createdAt)) throw t("conflict");
+						return await e.update(X(u.kind).rewards.tableName, u.rewardId, {
+							state: "delivered",
+							deliveredAt: new Date(s),
+							deliveryReceipt: d
+						}), d;
+					});
+				});
+			} catch (n) {
+				return P.fail(n instanceof e ? n : t("invalid_input"));
+			}
+		},
+		dispatch: (r, a, s) => {
+			try {
+				let e = n(r);
+				Y(e);
+				let c = o(a, ["limit", "after"]), l = i(c.limit, 1, 1e3), u = c.after === void 0 ? void 0 : H(c.after);
+				if (typeof s != "function") throw t("invalid_input");
+				return V(async () => {
+					let e = [];
+					for (let t of G) {
+						if (u && L.indexOf(t) < L.indexOf(u.kind)) continue;
+						let n = u?.kind === t ? we(F("state", "pending"), Te("id", u.rewardId)) : F("state", "pending"), r = await U.query(I(X(t).rewards).where(n).orderBy("id", "asc").select("id").limit(l + 1).descriptor);
+						for (let n of r) e.push(H({
+							kind: t,
+							rewardId: n.id
+						}));
+						if (e.length > l) break;
+					}
+					let r = e.slice(0, l), i = [], a = [];
+					for (let e of r) try {
+						let r = xe.decodeUnknownSync(Se, { onExcessProperty: "error" })(n(await s(e)));
+						if (r.workflowName !== "progression.deliverReward") throw t("invalid_record");
+						i.push(Object.freeze({
+							request: e,
+							status: r.status
+						}));
+					} catch {
+						a.push(e);
+					}
+					return Object.freeze({
+						submitted: Object.freeze(i),
+						failed: Object.freeze(a),
+						next: e.length > l ? r.at(-1) : null
+					});
+				});
+			} catch (n) {
+				return P.fail(n instanceof e ? n : t("invalid_input"));
+			}
+		}
+	});
+};
+//#endregion
+export { U as dataStoreRewardDelivery, R as resolveRewardDeliveryOptions };

package/dist/rewardDeliveryRecord.js

@@ -0,0 +1,48 @@
+import { progressionError as e } from "./errors.js";
+import { identifier as t, integer as n, object as r } from "./capture.js";
+import { captureReward as i } from "./reward.js";
+//#region src/rewardDeliveryRecord.ts
+var a = (a, o, s) => {
+	let c = (e) => {
+		let t = e instanceof Date ? e.getTime() : typeof e == "string" ? Date.parse(e) : NaN;
+		return n(t, 0, 864e13);
+	};
+	if (a.state === "erased") {
+		if (a.ownerId !== null || a.ownerKey !== null || a.reward !== null || a.deliveryIntent != null || a.deliveryDigest != null || a.deliveryReceipt != null || a.deliveredAt !== null) throw e("invalid_record");
+		return;
+	}
+	if (a.state !== "pending" && a.state !== "delivered") throw e("invalid_record");
+	let l = c(a.createdAt), u = i(a.reward);
+	if (a.deliveryIntent == null) {
+		if (a.deliveryDigest != null || a.deliveryReceipt != null || a.deliveredAt !== null || a.state !== "pending") throw e("invalid_record");
+		return;
+	}
+	let d = r(a.deliveryIntent, [
+		"tenantId",
+		"ownerId",
+		"ownerKey",
+		"reward",
+		"kind",
+		"rewardId",
+		"requestId",
+		"sourceVersion",
+		"systemAccount"
+	]), f = o === "level" ? "pgs_" : o === "quest" ? "qps_" : o === "achievement" ? "pas_" : o === "daily" ? "pds_" : o === "pass" ? "pps_" : o === "rank" ? "prs_" : "pts_";
+	if (d.tenantId !== t(a.tenantId) || d.ownerId !== t(a.ownerId) || d.ownerKey !== a.ownerKey || d.ownerKey !== f + s([d.tenantId, d.ownerId]).slice(0, 56) || d.kind !== o || d.rewardId !== t(a.id) || d.requestId !== "reward_" + s([o, a.id]).slice(0, 56) || s(i(d.reward)) !== s(u) || s(d) !== a.deliveryDigest) throw e("invalid_record");
+	if (t(d.sourceVersion), t(d.systemAccount), a.state === "pending") {
+		if (a.deliveryReceipt != null || a.deliveredAt !== null) throw e("invalid_record");
+		return;
+	}
+	let p = r(a.deliveryReceipt, [
+		"kind",
+		"rewardId",
+		"status",
+		"outputKind",
+		"externalOperationId",
+		"at"
+	]);
+	if (p.kind !== o || p.rewardId !== a.id || p.status !== "delivered" || p.outputKind !== u.kind || p.at !== c(a.deliveredAt) || Number(p.at) < l) throw e("invalid_record");
+	t(p.externalOperationId);
+};
+//#endregion
+export { a as admitRewardDeliveryRecord };

package/dist/rewardDeliveryWorkflow.d.ts

@@ -0,0 +1,36 @@
+import { Literals } from 'effect/Schema';
+import { NullOr } from 'effect/Schema';
+import { Number as Number_2 } from 'effect/Schema';
+import { Schema } from 'effect';
+import { String as String_2 } from 'effect/Schema';
+import { Struct } from 'effect/Schema';
+import { Workflow } from 'effect/workflow/Workflow';
+import { WorkflowMessagesCarrier } from '@voltro/workflow';
+import { YieldableError } from 'effect/Cause';
+
+declare class ProgressionError extends ProgressionError_base {
+}
+
+declare const ProgressionError_base: Schema.Class<ProgressionError, Schema.TaggedStruct<"ProgressionError", {
+    readonly code: Schema.Literals<readonly ["invalid_input", "invalid_record", "invalid_curve", "invalid_reward", "invalid_track", "invalid_stat", "overflow", "insufficient_resource", "forbidden", "conflict", "erased", "not_found", "limit_exceeded", "unavailable"]>;
+}>, YieldableError>;
+
+/** The durable journal carries opaque reward identity and redacted receipt, never owner/intent bodies. */
+export declare const ProgressionRewardDelivery: Workflow<"progression.deliverReward", Struct<{
+    readonly kind: Literals<readonly ["level", "quest", "achievement", "daily", "pass", "tutorial", "rank"]>;
+    readonly rewardId: String_2;
+}>, Struct<{
+    readonly kind: Literals<readonly ["level", "quest", "achievement", "daily", "pass", "tutorial", "rank"]>;
+    readonly rewardId: String_2;
+    readonly status: Literals<readonly ["delivered", "erased"]>;
+    readonly outputKind: NullOr<Literals<readonly ["currency", "item", "xp"]>>;
+    readonly externalOperationId: NullOr<String_2>;
+    readonly at: Number_2;
+}>, typeof ProgressionError> & {
+    readonly name: "progression.deliverReward";
+} & WorkflowMessagesCarrier<{
+    readonly signals: {};
+    readonly updates: {};
+}>;
+
+export { }

package/dist/rewardDeliveryWorkflow.js

@@ -0,0 +1,16 @@
+import { ProgressionError as e } from "./errors.js";
+import { RewardDeliveryReceiptSchema as t, RewardDeliveryRequestSchema as n } from "./rewardDelivery.js";
+import { workflow as r } from "@voltro/workflow/define";
+//#region src/rewardDeliveryWorkflow.ts
+var i = r({
+	name: "progression.deliverReward",
+	payload: n,
+	success: t,
+	error: e,
+	idempotencyKey: ({ kind: e, rewardId: t }) => `progression.reward:${e}:${t}`,
+	concurrency: { limit: 4 },
+	suspendOnFailure: !0,
+	internal: !0
+});
+//#endregion
+export { i as ProgressionRewardDelivery };