@happyvertical/smrt-sales 0.40.19 → 0.40.21

package/dist/chunks/{__smrt-register__-ck7DyZQk.js.map → __smrt-register__-BG5Ze6GV.js.map}

@@ -1 +1 @@
-{"version":3,"file":"__smrt-register__-ck7DyZQk.js","names":[],"sources":["../../src/__smrt-register__.ts"],"sourcesContent":["import { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n"],"mappings":""}
+{"version":3,"file":"__smrt-register__-BG5Ze6GV.js","names":[],"sources":["../../src/__smrt-register__.ts"],"sourcesContent":["import { ObjectRegistry } from '@happyvertical/smrt-core';\n\nObjectRegistry.registerPackageManifest(\n  new URL('./manifest.json', import.meta.url),\n);\n"],"mappings":""}

package/dist/chunks/{referrals-CeS9N5PI.js → referrals-BzTlbjJH.js}

@@ -1632,6 +1632,23 @@ var ReferralClickValidationError = class extends Error {
 	details;
 	code = "REFERRAL_CLICK_VALIDATION_ERROR";
 };
+function isTransactionHandle(db) {
+	return typeof db.commit === "function" && typeof db.rollback === "function" && typeof db.isActive === "function";
+}
+function isTransactionScopedDatabase(db) {
+	const capable = db;
+	if (isTransactionHandle(capable)) return true;
+	return typeof capable.transaction === "function" && typeof capable.beginTransaction !== "function" && typeof capable.acquireSession !== "function" && typeof capable.close !== "function";
+}
+function assertParticipatableTransaction(tx) {
+	const candidate = tx;
+	if (candidate === null || typeof candidate !== "object" || typeof candidate.query !== "function") throw new ReferralClickValidationError("invalid_transaction", "Referral click transaction must be an open transaction database — the callback argument of db.transaction() or an active beginTransaction() handle");
+	if (isTransactionHandle(candidate)) {
+		if (candidate.isActive() !== true) throw new ReferralClickValidationError("invalid_transaction", "Referral click transaction has already been committed or rolled back");
+		return;
+	}
+	if (typeof candidate.beginTransaction === "function" || typeof candidate.acquireSession === "function" || typeof candidate.close === "function") throw new ReferralClickValidationError("invalid_transaction", "Referral click transaction received a pool-level database; pass the transaction-scoped database your db.transaction() callback received so the click joins your transaction instead of running untransacted");
+}
 var ReferralLinkCollection = class ReferralLinkCollection extends SmrtCollection {
 	static _itemClass = ReferralLink;
 	/** All links for a referrer, newest first. */
@@ -1689,6 +1706,23 @@ var ReferralLinkCollection = class ReferralLinkCollection extends SmrtCollection
 	* returns the original touch without another increment; changed immutable
 	* intent raises {@link ReferralClickReplayConflictError}.
 	*
+	* Transactions: by default (collection bound to a pool-level database)
+	* the click opens and commits its own transaction, and the returned
+	* models are re-read on the collection's database after commit. To record
+	* a click inside YOUR transaction — required whenever your transaction
+	* holds locks the click needs (above all the `referral_links` row it
+	* increments) or created the link it resolves — either pass the
+	* transaction database as {@link RecordClickInput.transaction} or call
+	* `recordClick` on a collection bound to it
+	* (`ReferralLinkCollection.create({ db: tx, _reuseInitializedDb: true,
+	* _deferRuntimeInitialization: true })`). Both participate in the caller
+	* transaction instead of nesting (a nested adapter `transaction()` takes
+	* an independent pooled connection: it deadlocks undetectably on locks
+	* your transaction holds and cannot see your uncommitted rows —
+	* happyvertical/sdk#1108) and return models bound to it: commit/rollback
+	* and durability belong to you, and refusals/replays reflect your
+	* transaction's view.
+	*
 	* Evidence is canonicalized, Sales-owned `code`/`linkId`/`targetUrl` fields
 	* are applied, and the UTF-8 bytes of that exact persisted JSON are checked
 	* before any write. The default bound is
@@ -1702,18 +1736,40 @@ var ReferralLinkCollection = class ReferralLinkCollection extends SmrtCollection
 	*/
 	async recordClick(input) {
 		const request = canonicalizeClickRequest(input);
+		if (input.transaction !== void 0) {
+			assertParticipatableTransaction(input.transaction);
+			return await this.recordClickInTransaction(await ReferralLinkCollection.createClickCollections(input.transaction), request);
+		}
 		const db = this.db;
+		if (isTransactionScopedDatabase(db)) return await this.recordClickInTransaction(await ReferralLinkCollection.createClickCollections(db), request);
 		if (typeof db.transaction !== "function") throw new ReferralClickValidationError("transaction_unavailable", "Referral click recording requires a transaction-capable database adapter");
 		const transactionResult = await db.transaction(async (tx) => {
-			const deps = {
-				links: await ReferralLinkCollection.create({ db: tx }),
-				touches: await ReferralTouchCollection.create({ db: tx }),
-				operations: await ReferralClickOperationCollection.create({ db: tx })
-			};
-			return await this.recordClickInTransaction(deps, request);
+			return await this.recordClickInTransaction(await ReferralLinkCollection.createClickCollections(tx), request);
 		});
 		return await this.rehydrateRecordClickResult(transactionResult);
 	}
+	/**
+	* Bind the click's working collections to one transaction database. The
+	* transaction is the same initialized database on a pinned connection, so
+	* the lightweight-binding flags are requested (mirrors
+	* `CommissionPayoutService.txOptions`). Note `SmrtCollection.create()`
+	* currently forwards only whitelisted options — the two internal flags
+	* are dropped there today, and it is the same-URL system-table cache that
+	* keeps bootstrap DDL out of the transaction in practice; the flags make
+	* the intent explicit and take effect when core forwards them.
+	*/
+	static async createClickCollections(txDb) {
+		const options = {
+			db: txDb,
+			_reuseInitializedDb: true,
+			_deferRuntimeInitialization: true
+		};
+		return {
+			links: await ReferralLinkCollection.create(options),
+			touches: await ReferralTouchCollection.create(options),
+			operations: await ReferralClickOperationCollection.create(options)
+		};
+	}
 	/** Rebind public result models to the caller's database after commit. */
 	async rehydrateRecordClickResult(result) {
 		let link = null;
@@ -3355,4 +3411,4 @@ var ReferralQualificationService = class ReferralQualificationService {
 //#endregion
 export { ReferralClickOperation as A, ATTRIBUTION_RESOLUTION_MODES as B, ReferralTouchCollection as C, ReferralCollection as D, assertHttpTargetUrl as E, validateAttributionPolicyTerms as F, REFERRAL_STATUSES as G, REFERRAL_AGREEMENT_STATUSES as H, ATTRIBUTION_CONFLICT_BEHAVIORS as I, AttributionExceptionCollection as J, REFERRAL_TOUCH_KINDS as K, ATTRIBUTION_CREDIT_MODES as L, ReferralAgreement as M, AttributionPolicyCollection as N, Referral as O, AttributionPolicy as P, ATTRIBUTION_EXCEPTION_STATUSES as R, generateReferralCode as S, ReferralLink as T, REFERRAL_LINK_STATUSES as U, REFERRAL_AGREEMENT_APPROVAL_MODES as V, REFERRAL_PROGRAM_STATUSES as W, AttributionException as Y, REFERRAL_CODE_ALPHABET as _, ReferralAgreementExecutionService as a, ReferralClickValidationError as b, ReferrerCollection as c, ReferralTermSnapshot as d, ReferralProgramCollection as f, MAX_REFERRAL_CLICK_IDEMPOTENCY_KEY_BYTES as g, MAX_CODE_GENERATION_ATTEMPTS as h, REFERRAL_AGREEMENT_SOURCE_KIND as i, ReferralAgreementCollection as j, ReferralClickOperationCollection as k, Referrer as l, DEFAULT_REFERRAL_CLICK_EVIDENCE_MAX_BYTES as m, REFERRAL_TERMS_SNAPSHOT_KIND as n, AttributionService as o, ReferralProgram as p, REFERRER_STATUSES as q, ReferralCommissionService as r, QualifiedReferralOverrideError as s, ReferralQualificationService as t, ReferralTermSnapshotCollection as u, REFERRAL_CODE_LENGTH as v, ReferralTouch as w, ReferralLinkCollection as x, ReferralClickReplayConflictError as y, ATTRIBUTION_POLICY_STATUSES as z };
 
-//# sourceMappingURL=referrals-CeS9N5PI.js.map
+//# sourceMappingURL=referrals-BzTlbjJH.js.map