@ttt-productions/ttt-core 0.79.69 → 0.79.70

package/dist/utils/pledge-totals.d.ts

@@ -6,9 +6,22 @@ export declare const PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS: readonly ["amount", "n
 export type PledgePaymentAmountSums = Pick<PledgePayment, (typeof PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS)[number]>;
 /**
  * The counters from the summed pledge amounts. `totalRefunded` is money that left the platform:
- * refunds plus funds withdrawn by a lost dispute. The formula is linear, so it gives the whole
- * ledger's totals from the ledger's sums, and one pledge's contribution — the webhook's increment
- * is its contribution after an event minus its contribution before (with `pledgeCount` 1 each).
+ * refunds plus funds withdrawn by a lost dispute. `pledgeCount` is the number of those pledges that
+ * still count (`isPledgePaymentCounted`) — a sum cannot say how many pledges kept money, so the
+ * caller counts them. The money formula is linear, so it gives the whole ledger's totals from the
+ * ledger's sums; one pledge's share is `pledgePaymentContributionOf`.
  */
 export declare function pledgePaymentTotalsOf(sums: PledgePaymentAmountSums, pledgeCount: number): PledgePaymentTotals;
+/**
+ * A pledge counts — in the pledge count and toward the Supporter badge — while it still holds money:
+ * a full refund or a lost dispute that leaves its net at 0 stops it counting, and a refund that
+ * fails restores it.
+ */
+export declare function isPledgePaymentCounted(pledge: Pick<PledgePayment, 'netAmount'>): boolean;
+/**
+ * One pledge's contribution to the totals: its amounts, and 1 toward `pledgeCount` while it counts.
+ * The webhook's increment for an event is the pledge's contribution after it minus its contribution
+ * before, so a refund that ends the pledge's money also takes it out of the count.
+ */
+export declare function pledgePaymentContributionOf(pledge: PledgePaymentAmountSums): PledgePaymentTotals;
 //# sourceMappingURL=pledge-totals.d.ts.map

package/dist/utils/pledge-totals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pledge-totals.d.ts","sourceRoot":"","sources":["../../src/utils/pledge-totals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,yEAKK,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAO7G"}
+{"version":3,"file":"pledge-totals.d.ts","sourceRoot":"","sources":["../../src/utils/pledge-totals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,yEAKK,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,mCAAmC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAO7G;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,OAAO,CAExF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,uBAAuB,GAAG,mBAAmB,CAEhG"}

package/dist/utils/pledge-totals.js

@@ -10,9 +10,10 @@ export const PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS = [
 ];
 /**
  * The counters from the summed pledge amounts. `totalRefunded` is money that left the platform:
- * refunds plus funds withdrawn by a lost dispute. The formula is linear, so it gives the whole
- * ledger's totals from the ledger's sums, and one pledge's contribution — the webhook's increment
- * is its contribution after an event minus its contribution before (with `pledgeCount` 1 each).
+ * refunds plus funds withdrawn by a lost dispute. `pledgeCount` is the number of those pledges that
+ * still count (`isPledgePaymentCounted`) — a sum cannot say how many pledges kept money, so the
+ * caller counts them. The money formula is linear, so it gives the whole ledger's totals from the
+ * ledger's sums; one pledge's share is `pledgePaymentContributionOf`.
  */
 export function pledgePaymentTotalsOf(sums, pledgeCount) {
     return {
@@ -22,4 +23,20 @@ export function pledgePaymentTotalsOf(sums, pledgeCount) {
         pledgeCount,
     };
 }
+/**
+ * A pledge counts — in the pledge count and toward the Supporter badge — while it still holds money:
+ * a full refund or a lost dispute that leaves its net at 0 stops it counting, and a refund that
+ * fails restores it.
+ */
+export function isPledgePaymentCounted(pledge) {
+    return pledge.netAmount > 0;
+}
+/**
+ * One pledge's contribution to the totals: its amounts, and 1 toward `pledgeCount` while it counts.
+ * The webhook's increment for an event is the pledge's contribution after it minus its contribution
+ * before, so a refund that ends the pledge's money also takes it out of the count.
+ */
+export function pledgePaymentContributionOf(pledge) {
+    return pledgePaymentTotalsOf(pledge, isPledgePaymentCounted(pledge) ? 1 : 0);
+}
 //# sourceMappingURL=pledge-totals.js.map

package/dist/utils/pledge-totals.js.map

@@ -1 +1 @@
-{"version":3,"file":"pledge-totals.js","sourceRoot":"","sources":["../../src/utils/pledge-totals.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,6FAA6F;AAC7F,oFAAoF;AAKpF,iFAAiF;AACjF,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,QAAQ;IACR,WAAW;IACX,gBAAgB;IAChB,mBAAmB;CACgC,CAAC;AAKtD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA6B,EAAE,WAAmB;IACtF,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,aAAa,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,iBAAiB;QAC3D,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["// The ONE formula for the pledge-totals counters (`pledgePaymentTotals/summary` and the Ops\n// snapshot's `pledge`). The webhook's increments, the repair script's recompute, and the Ops\n// aggregate all derive from it, so the three can never count a counter differently.\n\nimport type { PledgePayment } from '../doc-schemas/payments.js';\nimport type { PledgePaymentTotals } from '../types/payments.js';\n\n/** The pledge fields the totals are built from — each summed over the ledger. */\nexport const PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS = [\n  'amount',\n  'netAmount',\n  'refundedAmount',\n  'disputeLostAmount',\n] as const satisfies readonly (keyof PledgePayment)[];\n\n/** Those fields' values for one pledge, or their sums over many (cents). */\nexport type PledgePaymentAmountSums = Pick<PledgePayment, (typeof PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS)[number]>;\n\n/**\n * The counters from the summed pledge amounts. `totalRefunded` is money that left the platform:\n * refunds plus funds withdrawn by a lost dispute. The formula is linear, so it gives the whole\n * ledger's totals from the ledger's sums, and one pledge's contribution — the webhook's increment\n * is its contribution after an event minus its contribution before (with `pledgeCount` 1 each).\n */\nexport function pledgePaymentTotalsOf(sums: PledgePaymentAmountSums, pledgeCount: number): PledgePaymentTotals {\n  return {\n    netRaised: sums.netAmount,\n    grossRaised: sums.amount,\n    totalRefunded: sums.refundedAmount + sums.disputeLostAmount,\n    pledgeCount,\n  };\n}\n"]}
+{"version":3,"file":"pledge-totals.js","sourceRoot":"","sources":["../../src/utils/pledge-totals.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,6FAA6F;AAC7F,oFAAoF;AAKpF,iFAAiF;AACjF,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,QAAQ;IACR,WAAW;IACX,gBAAgB;IAChB,mBAAmB;CACgC,CAAC;AAKtD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA6B,EAAE,WAAmB;IACtF,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,aAAa,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,iBAAiB;QAC3D,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAwC;IAC7E,OAAO,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAA+B;IACzE,OAAO,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["// The ONE formula for the pledge-totals counters (`pledgePaymentTotals/summary` and the Ops\n// snapshot's `pledge`). The webhook's increments, the repair script's recompute, and the Ops\n// aggregate all derive from it, so the three can never count a counter differently.\n\nimport type { PledgePayment } from '../doc-schemas/payments.js';\nimport type { PledgePaymentTotals } from '../types/payments.js';\n\n/** The pledge fields the totals are built from — each summed over the ledger. */\nexport const PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS = [\n  'amount',\n  'netAmount',\n  'refundedAmount',\n  'disputeLostAmount',\n] as const satisfies readonly (keyof PledgePayment)[];\n\n/** Those fields' values for one pledge, or their sums over many (cents). */\nexport type PledgePaymentAmountSums = Pick<PledgePayment, (typeof PLEDGE_PAYMENT_SUMMED_AMOUNT_FIELDS)[number]>;\n\n/**\n * The counters from the summed pledge amounts. `totalRefunded` is money that left the platform:\n * refunds plus funds withdrawn by a lost dispute. `pledgeCount` is the number of those pledges that\n * still count (`isPledgePaymentCounted`) — a sum cannot say how many pledges kept money, so the\n * caller counts them. The money formula is linear, so it gives the whole ledger's totals from the\n * ledger's sums; one pledge's share is `pledgePaymentContributionOf`.\n */\nexport function pledgePaymentTotalsOf(sums: PledgePaymentAmountSums, pledgeCount: number): PledgePaymentTotals {\n  return {\n    netRaised: sums.netAmount,\n    grossRaised: sums.amount,\n    totalRefunded: sums.refundedAmount + sums.disputeLostAmount,\n    pledgeCount,\n  };\n}\n\n/**\n * A pledge counts — in the pledge count and toward the Supporter badge — while it still holds money:\n * a full refund or a lost dispute that leaves its net at 0 stops it counting, and a refund that\n * fails restores it.\n */\nexport function isPledgePaymentCounted(pledge: Pick<PledgePayment, 'netAmount'>): boolean {\n  return pledge.netAmount > 0;\n}\n\n/**\n * One pledge's contribution to the totals: its amounts, and 1 toward `pledgeCount` while it counts.\n * The webhook's increment for an event is the pledge's contribution after it minus its contribution\n * before, so a refund that ends the pledge's money also takes it out of the count.\n */\nexport function pledgePaymentContributionOf(pledge: PledgePaymentAmountSums): PledgePaymentTotals {\n  return pledgePaymentTotalsOf(pledge, isPledgePaymentCounted(pledge) ? 1 : 0);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/ttt-core",
-  "version": "0.79.69",
+  "version": "0.79.70",
   "description": "Core types, Firestore path constants, and shared constants for TTT Productions",
   "repository": {
     "type": "git",
@@ -117,7 +117,7 @@
     "@ttt-productions/chat-schemas": "^0.10.5",
     "@ttt-productions/edge-protocol-core": "^0.1.12",
     "@ttt-productions/input-format-core": "^0.1.1",
-    "@ttt-productions/media-schemas": "^0.14.8",
+    "@ttt-productions/media-schemas": "^0.14.9",
     "@ttt-productions/notification-core": "^0.15.9",
     "@ttt-productions/report-core": "^0.16.14",
     "zod": "^4.4.3"