@kasufinance/kasu-sdk 2.10.3 → 2.11.0

package/README.md

@@ -149,6 +149,7 @@ application formats them in its own design system and language.
 | Yields               | `weeklyInterest`, `dailyInterest`, `accruedInterest`, `projectedAnnualEarnings`, `weightedAverageApy`, `SECONDS_PER_WEEK` — NET of the performance fee                                               |
 | Batch proof          | `validateDepositBatchCalls`, `proveDepositInReceipt`, `DepositBatchMismatchError`, `ENTRY_POINT_V07`                                                                                                   |
 | Tranche display name | `getTrancheDisplayName`, `UPPER_MEZZANINE`                                                                                                                                                               |
+| Strategy summary     | `pickShortDescription` — the CMS short blurb as one line of plain text, or `undefined` (also on every `Strategy` as `summary`)                                                                            |
 | Requests             | `deriveRequestState`, `submissionEvents`, `countSubmissions`, `firstSubmissionTimestamp`, `isCycleClosed`                                                                                                |
 | Settlement           | `computeSettlementWindow`, `nextCycleBoundary`, `deriveCycleDates`, `CLEARING_WINDOW_SECONDS`                                                                                                            |
 | Loan contract        | `encodeDepositData`, `buildContractVersionType`, `buildLoanAgreementSignMessage`, `buildLegacyContractRequestMessage`, `buildFullNameRequestMessage`, `formatSignTimestampUtc`, `parseFormattedMessage`, `asContractType` |
@@ -169,6 +170,14 @@ Three rules worth knowing:
   wrong number when an input is out of domain. Render that as "no rate", never
   as zero, and never substitute a fee of `0` for one you have not loaded — a
   fee-less rate overstates what a lender earns.
+- **`Strategy.summary` is CMS editorial, cleaned, never authored.** It is
+  `liteDescription` when usable, else the first paragraph of `description`,
+  with inline markdown markers stripped and whitespace collapsed to one line.
+  The `"Not Available"` placeholder and a blank value count as missing, and an
+  absent blurb is `undefined`: what to show instead is the app's decision.
+  `liteDescription` and `description` stay the raw CMS values. It is NOT
+  sanitised: HTML tags and link syntax pass through unchanged, so render it
+  as text, never as HTML or markdown.
 - **The tranche rename is display-only.** `getTrancheDisplayName` maps the
   `Senior` tranche to "Upper Mezzanine" on Apxium strategies, because the true
   senior position is held by an institutional lender. Call it at the view
@@ -558,6 +567,14 @@ network problem cannot fail a pull request that did not touch the network.
 CI runs `build-tc`, `build`, `test:unit` and `rollup-build` on every pull
 request.
 
+`npm ci` also installs a **pre-push hook** (`.githooks/pre-push`) that runs the
+same steps locally before every `git push`: first a lockfile check
+(`npm ci --dry-run`, which fails when `package.json` and `package-lock.json`
+disagree), then `build-tc`, `build`, `test:unit` and `rollup-build`. It stops at
+the first failing step and names it. It checks the working tree, not the pushed
+commits, so commit first. `SKIP_PREPUSH=1 git push` skips it with a warning; CI
+is still the gate.
+
 ## Versioning & publishing
 
 The package follows semantic versioning. The published runtime entry is the

package/dist/bundle.cjs.js

@@ -27545,6 +27545,82 @@ function maxNetRateCeiling(pools, feePercent) {
     return rate;
 }
 
+/**
+ * A strategy's SHORT blurb, as plain text: the CMS `liteDescription` first,
+ * else the first paragraph of the long `description`, else nothing.
+ *
+ * Lifted from kasu-ui (`pickShortDescription`, its deposit dialog and landing
+ * strategy card) so every app shows the same line, and pinned to its output
+ * for every live CMS row. The rules are facts about how the CMS is authored,
+ * not formatting preferences:
+ *
+ *   - `liteDescription` IS THE SHORT ONE. `description` is the credit
+ *     originator's several-paragraph profile; on a card it is a wall.
+ *   - `"Not Available"` IS A PLACEHOLDER, not editorial. Several rows carry it
+ *     verbatim, and it must read as missing, not print. Matched on the whole
+ *     trimmed value, case-insensitively. It applies to `liteDescription` only.
+ *   - EMPTY OR BLANK IS MISSING. The service maps a pool with no CMS record to
+ *     `''`.
+ *   - THE FIELDS HOLD MARKDOWN. `liteDescription` can open with a `**bold**`
+ *     lead, and the surfaces this feeds render plain text, so the markers are
+ *     stripped (bold, then italic, then inline code).
+ *   - AND HARD NEWLINES. Every run of whitespace becomes one space, so a
+ *     paragraph break inside the value is not a gap in a one-line slot.
+ *   - NOT SANITISED. "Plain text" means text to render AS text. HTML tags,
+ *     entities and link syntax (`<script>`, `&lt;`, `[a](javascript:…)`) pass
+ *     through unchanged, and removing markers can join fragments into a tag
+ *     (`<scr**i**pt>` becomes `<script>`). Render it as a text node, never as
+ *     HTML or markdown.
+ *
+ * Two refinements over the kasu-ui original, neither reachable by any live
+ * row: the cleaned text is trimmed (a CRLF value no longer ends in a space),
+ * and a `liteDescription` that cleans to nothing (`** **`) counts as missing,
+ * so the result is never a blank string.
+ *
+ * This authors no string of its own. It selects and cleans editorial the CMS
+ * already holds, and an absent blurb is `undefined`, never a fallback sentence:
+ * what "no blurb" means is the render site's decision.
+ *
+ * Pure. A value that is not a string reads as missing.
+ */
+function pickShortDescription(source) {
+    var _a;
+    const lite = asTrimmed(source.liteDescription);
+    if (lite && !NOT_AVAILABLE.test(lite)) {
+        const summary = toOneLine(lite);
+        if (summary)
+            return summary;
+    }
+    const long = asTrimmed(source.description);
+    if (long) {
+        const firstParagraph = (_a = long.split(PARAGRAPH_BREAK, 1)[0]) !== null && _a !== void 0 ? _a : long;
+        return toOneLine(firstParagraph) || undefined;
+    }
+    return undefined;
+}
+const NOT_AVAILABLE = /^not available$/i;
+const PARAGRAPH_BREAK = /\n\s*\n/;
+function asTrimmed(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/** Markers off, whitespace runs to one space, ends trimmed. `''` when nothing is left. */
+function toOneLine(text) {
+    return stripInlineMarkdown(text).replace(/\s+/gu, ' ').trim();
+}
+/**
+ * Inline markdown markers off, in the order bold → italic → code. The bold
+ * passes consume every `**` / `__` pair first, so the italic patterns can match
+ * a lone `*` / `_` without lookarounds.
+ */
+function stripInlineMarkdown(input) {
+    return input
+        .replace(/\*\*(.+?)\*\*/g, '$1')
+        .replace(/__(.+?)__/g, '$1')
+        .replace(/\*(.+?)\*/g, '$1')
+        .replace(/_(.+?)_/g, '$1')
+        .replace(/`([^`]+)`/g, '$1');
+}
+
 /**
  * High-level facade for browsing Kasu lending strategies (pools).
  *
@@ -27731,6 +27807,7 @@ class StrategiesFacade {
             subheading: nonEmptyOrUndefined(pool.subheading),
             description: pool.description,
             liteDescription: nonEmptyOrUndefined(pool.liteDescription),
+            summary: pickShortDescription(pool),
             isActive: pool.isActive,
             apy: pool.apy,
             tvl: pool.totalValueLocked,
@@ -29203,6 +29280,7 @@ exports.parseMinorUnits = parseMinorUnits;
 exports.parseTrancheBound = parseTrancheBound;
 exports.pickDefaultTrancheId = pickDefaultTrancheId;
 exports.pickHighestYieldTranche = pickHighestYieldTranche;
+exports.pickShortDescription = pickShortDescription;
 exports.poolAllTranchesFull = poolAllTranchesFull;
 exports.poolMaxApy = poolMaxApy;
 exports.projectedAnnualEarnings = projectedAnnualEarnings;

package/dist/bundle.esm.js

@@ -27543,6 +27543,82 @@ function maxNetRateCeiling(pools, feePercent) {
     return rate;
 }
 
+/**
+ * A strategy's SHORT blurb, as plain text: the CMS `liteDescription` first,
+ * else the first paragraph of the long `description`, else nothing.
+ *
+ * Lifted from kasu-ui (`pickShortDescription`, its deposit dialog and landing
+ * strategy card) so every app shows the same line, and pinned to its output
+ * for every live CMS row. The rules are facts about how the CMS is authored,
+ * not formatting preferences:
+ *
+ *   - `liteDescription` IS THE SHORT ONE. `description` is the credit
+ *     originator's several-paragraph profile; on a card it is a wall.
+ *   - `"Not Available"` IS A PLACEHOLDER, not editorial. Several rows carry it
+ *     verbatim, and it must read as missing, not print. Matched on the whole
+ *     trimmed value, case-insensitively. It applies to `liteDescription` only.
+ *   - EMPTY OR BLANK IS MISSING. The service maps a pool with no CMS record to
+ *     `''`.
+ *   - THE FIELDS HOLD MARKDOWN. `liteDescription` can open with a `**bold**`
+ *     lead, and the surfaces this feeds render plain text, so the markers are
+ *     stripped (bold, then italic, then inline code).
+ *   - AND HARD NEWLINES. Every run of whitespace becomes one space, so a
+ *     paragraph break inside the value is not a gap in a one-line slot.
+ *   - NOT SANITISED. "Plain text" means text to render AS text. HTML tags,
+ *     entities and link syntax (`<script>`, `&lt;`, `[a](javascript:…)`) pass
+ *     through unchanged, and removing markers can join fragments into a tag
+ *     (`<scr**i**pt>` becomes `<script>`). Render it as a text node, never as
+ *     HTML or markdown.
+ *
+ * Two refinements over the kasu-ui original, neither reachable by any live
+ * row: the cleaned text is trimmed (a CRLF value no longer ends in a space),
+ * and a `liteDescription` that cleans to nothing (`** **`) counts as missing,
+ * so the result is never a blank string.
+ *
+ * This authors no string of its own. It selects and cleans editorial the CMS
+ * already holds, and an absent blurb is `undefined`, never a fallback sentence:
+ * what "no blurb" means is the render site's decision.
+ *
+ * Pure. A value that is not a string reads as missing.
+ */
+function pickShortDescription(source) {
+    var _a;
+    const lite = asTrimmed(source.liteDescription);
+    if (lite && !NOT_AVAILABLE.test(lite)) {
+        const summary = toOneLine(lite);
+        if (summary)
+            return summary;
+    }
+    const long = asTrimmed(source.description);
+    if (long) {
+        const firstParagraph = (_a = long.split(PARAGRAPH_BREAK, 1)[0]) !== null && _a !== void 0 ? _a : long;
+        return toOneLine(firstParagraph) || undefined;
+    }
+    return undefined;
+}
+const NOT_AVAILABLE = /^not available$/i;
+const PARAGRAPH_BREAK = /\n\s*\n/;
+function asTrimmed(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/** Markers off, whitespace runs to one space, ends trimmed. `''` when nothing is left. */
+function toOneLine(text) {
+    return stripInlineMarkdown(text).replace(/\s+/gu, ' ').trim();
+}
+/**
+ * Inline markdown markers off, in the order bold → italic → code. The bold
+ * passes consume every `**` / `__` pair first, so the italic patterns can match
+ * a lone `*` / `_` without lookarounds.
+ */
+function stripInlineMarkdown(input) {
+    return input
+        .replace(/\*\*(.+?)\*\*/g, '$1')
+        .replace(/__(.+?)__/g, '$1')
+        .replace(/\*(.+?)\*/g, '$1')
+        .replace(/_(.+?)_/g, '$1')
+        .replace(/`([^`]+)`/g, '$1');
+}
+
 /**
  * High-level facade for browsing Kasu lending strategies (pools).
  *
@@ -27729,6 +27805,7 @@ class StrategiesFacade {
             subheading: nonEmptyOrUndefined(pool.subheading),
             description: pool.description,
             liteDescription: nonEmptyOrUndefined(pool.liteDescription),
+            summary: pickShortDescription(pool),
             isActive: pool.isActive,
             apy: pool.apy,
             tvl: pool.totalValueLocked,
@@ -29093,4 +29170,4 @@ function weightedAverageApy(slices) {
     return weighted / totalBalance;
 }
 
-export { APXIUM, AU_ALPHA3, AU_MIN_CUMULATIVE_BY_STABLE, BatchPendingError, BatchRevertedError, BatchSubmissionError, CHAIN_CONFIGS, CLEARING_WINDOW_SECONDS, CONTRACT_TTL_MS, CallsFacade, DAYS_PER_EPOCH, DAYS_PER_MONTH, DEFAULT_BATCH_POLLING_POLICY, DepositBatchMismatchError, DepositFlow, DepositsFacade, ENTRY_POINT_V07, EPOCHS_IN_YEAR, Flow, FlowStore, FlowsFacade, INVALID_ACCEPTANCE_SIGNATURE_MESSAGE, INVALID_AUTH_SIGNATURE_MESSAGE, INVOICEMATE, Kasu, KasuSdk, MAX_LENDING_AMOUNT_FALLBACK, MIN_DAYS_FOR_MONTHS, MIN_LENDING_AMOUNT_FALLBACK, MIN_TRANCHE_CAPACITY, NOT_A_WITHDRAWAL_CALL_MESSAGE, NO_DIRECTUS_URL_MESSAGE, NO_KYC_PARAMS_MESSAGE, NO_SPENDER_MESSAGE, NO_WITHDRAWAL_ENCODER_MESSAGE, PortfolioFacade, READ_ONLY_MESSAGE, RIXON_CAPITAL, SECONDS_PER_WEEK, SPONSORED_CALL_KINDS, SPONSORED_CALL_SELECTORS, SdkConfig, SponsoredCallInputError, StrategiesFacade, UPPER_MEZZANINE, WithdrawFlow, accruedInterest, apyToEpochRate, asContractType, auMinimumRemaining, auThresholdFor, availableFixedTermConfigs, batchOutcomeOf, buildContractVersionType, buildFullNameRequestMessage, buildLegacyContractRequestMessage, buildLoanAgreementSignMessage, cancelDeadline, ceilToCents, checkBatchOutcome, checkSponsoredCallOutcome, classifyWalletFailure, compareTrancheSeniority, computeSettlementWindow, countSubmissions, dailyInterest, decodeRevert, deriveCycleDates, derivePoolStatus, deriveRequestState, encodeCancelDepositCall, encodeCancelWithdrawalCall, encodeDepositData, encodeRequestWithdrawalCall, encodeStableTransfer, encodeWithdrawAtExpiryCall, epochRateToApy, explorerAddressUrl, explorerTxUrl, extractRevertData, fetchUnusedPoolIds, firstSubmissionTimestamp, floorToCents, formatSignTimestampUtc, getCreditOriginator, getInstitutionalLender, getStrategyRegion, getTrancheDisplayName, isAuMinimumExempt, isAustralianKyc, isBelowMinimumCapacity, isCycleClosed, isDefinitivelyNotSubmitted, isFixedTermConfigId, isUnpredictableGas, isUserRejected, lastEventTimestamp, lockDurationDays, lockDurationMonths, maxNetRateCeiling, netEffectiveApy, netTrancheApyBounds, nextCycleBoundary, parseFormattedMessage, parseMinorUnits, parseTrancheBound, pickDefaultTrancheId, pickHighestYieldTranche, poolAllTranchesFull, poolMaxApy, projectedAnnualEarnings, proveDepositInReceipt, proveUserOperationInReceipt, resolveBoundShortcuts, resolveDepositBounds, selectVisiblePools, submissionEvents, submitBatch, submitSponsoredCall, trancheApyBounds, trancheHasCapacity, trancheRiskRank, validateDepositBatchCalls, weeklyInterest, weightedAverageApy };
+export { APXIUM, AU_ALPHA3, AU_MIN_CUMULATIVE_BY_STABLE, BatchPendingError, BatchRevertedError, BatchSubmissionError, CHAIN_CONFIGS, CLEARING_WINDOW_SECONDS, CONTRACT_TTL_MS, CallsFacade, DAYS_PER_EPOCH, DAYS_PER_MONTH, DEFAULT_BATCH_POLLING_POLICY, DepositBatchMismatchError, DepositFlow, DepositsFacade, ENTRY_POINT_V07, EPOCHS_IN_YEAR, Flow, FlowStore, FlowsFacade, INVALID_ACCEPTANCE_SIGNATURE_MESSAGE, INVALID_AUTH_SIGNATURE_MESSAGE, INVOICEMATE, Kasu, KasuSdk, MAX_LENDING_AMOUNT_FALLBACK, MIN_DAYS_FOR_MONTHS, MIN_LENDING_AMOUNT_FALLBACK, MIN_TRANCHE_CAPACITY, NOT_A_WITHDRAWAL_CALL_MESSAGE, NO_DIRECTUS_URL_MESSAGE, NO_KYC_PARAMS_MESSAGE, NO_SPENDER_MESSAGE, NO_WITHDRAWAL_ENCODER_MESSAGE, PortfolioFacade, READ_ONLY_MESSAGE, RIXON_CAPITAL, SECONDS_PER_WEEK, SPONSORED_CALL_KINDS, SPONSORED_CALL_SELECTORS, SdkConfig, SponsoredCallInputError, StrategiesFacade, UPPER_MEZZANINE, WithdrawFlow, accruedInterest, apyToEpochRate, asContractType, auMinimumRemaining, auThresholdFor, availableFixedTermConfigs, batchOutcomeOf, buildContractVersionType, buildFullNameRequestMessage, buildLegacyContractRequestMessage, buildLoanAgreementSignMessage, cancelDeadline, ceilToCents, checkBatchOutcome, checkSponsoredCallOutcome, classifyWalletFailure, compareTrancheSeniority, computeSettlementWindow, countSubmissions, dailyInterest, decodeRevert, deriveCycleDates, derivePoolStatus, deriveRequestState, encodeCancelDepositCall, encodeCancelWithdrawalCall, encodeDepositData, encodeRequestWithdrawalCall, encodeStableTransfer, encodeWithdrawAtExpiryCall, epochRateToApy, explorerAddressUrl, explorerTxUrl, extractRevertData, fetchUnusedPoolIds, firstSubmissionTimestamp, floorToCents, formatSignTimestampUtc, getCreditOriginator, getInstitutionalLender, getStrategyRegion, getTrancheDisplayName, isAuMinimumExempt, isAustralianKyc, isBelowMinimumCapacity, isCycleClosed, isDefinitivelyNotSubmitted, isFixedTermConfigId, isUnpredictableGas, isUserRejected, lastEventTimestamp, lockDurationDays, lockDurationMonths, maxNetRateCeiling, netEffectiveApy, netTrancheApyBounds, nextCycleBoundary, parseFormattedMessage, parseMinorUnits, parseTrancheBound, pickDefaultTrancheId, pickHighestYieldTranche, pickShortDescription, poolAllTranchesFull, poolMaxApy, projectedAnnualEarnings, proveDepositInReceipt, proveUserOperationInReceipt, resolveBoundShortcuts, resolveDepositBounds, selectVisiblePools, submissionEvents, submitBatch, submitSponsoredCall, trancheApyBounds, trancheHasCapacity, trancheRiskRank, validateDepositBatchCalls, weeklyInterest, weightedAverageApy };

package/dist/domain/index.d.ts

@@ -16,6 +16,10 @@
  *    reconstructs byte-for-byte to verify a lender's signature. Those are not
  *    copy: nobody may reword them, in any language, without a matching backend
  *    change, which is exactly why they belong in one place.
+ *
+ *    `pickShortDescription` returns a string but AUTHORS none: it selects and
+ *    cleans editorial the CMS already holds, and an absent blurb is
+ *    `undefined`, never a sentence of its own.
  * 2. **Pure.** No network, no clock, no environment. Anything with I/O belongs
  *    in `facade/` (see `fetchUnusedPoolIds`).
  */
@@ -44,6 +48,8 @@ export { CLEARING_WINDOW_SECONDS, computeSettlementWindow, deriveCycleDates, nex
 export type { CycleDates, SettlementWindowInput, SettlementWindowState, } from './settlement';
 export { encodeCancelDepositCall, encodeCancelWithdrawalCall, encodeRequestWithdrawalCall, encodeStableTransfer, encodeWithdrawAtExpiryCall, SPONSORED_CALL_KINDS, SPONSORED_CALL_SELECTORS, SponsoredCallInputError, } from './sponsored-calls';
 export type { SponsoredCall, SponsoredCallKind } from './sponsored-calls';
+export { pickShortDescription } from './strategy-summary';
+export type { ShortDescriptionSource } from './strategy-summary';
 export { getTrancheDisplayName, UPPER_MEZZANINE } from './tranche-display-name';
 export { compareTrancheSeniority, derivePoolStatus, MIN_TRANCHE_CAPACITY, netTrancheApyBounds, pickDefaultTrancheId, poolAllTranchesFull, trancheApyBounds, trancheHasCapacity, trancheRiskRank, } from './tranches';
 export type { ApyBounds, PoolStatus, TrancheCapacitySignal, } from './tranches';

package/dist/domain/index.js

@@ -16,6 +16,10 @@
  *    reconstructs byte-for-byte to verify a lender's signature. Those are not
  *    copy: nobody may reword them, in any language, without a matching backend
  *    change, which is exactly why they belong in one place.
+ *
+ *    `pickShortDescription` returns a string but AUTHORS none: it selects and
+ *    cleans editorial the CMS already holds, and an absent blurb is
+ *    `undefined`, never a sentence of its own.
  * 2. **Pure.** No network, no clock, no environment. Anything with I/O belongs
  *    in `facade/` (see `fetchUnusedPoolIds`).
  */
@@ -32,6 +36,7 @@ export { cancelDeadline, countSubmissions, deriveRequestState, firstSubmissionTi
 export { decodeRevert, extractRevertData } from './revert-errors';
 export { CLEARING_WINDOW_SECONDS, computeSettlementWindow, deriveCycleDates, nextCycleBoundary, } from './settlement';
 export { encodeCancelDepositCall, encodeCancelWithdrawalCall, encodeRequestWithdrawalCall, encodeStableTransfer, encodeWithdrawAtExpiryCall, SPONSORED_CALL_KINDS, SPONSORED_CALL_SELECTORS, SponsoredCallInputError, } from './sponsored-calls';
+export { pickShortDescription } from './strategy-summary';
 export { getTrancheDisplayName, UPPER_MEZZANINE } from './tranche-display-name';
 export { compareTrancheSeniority, derivePoolStatus, MIN_TRANCHE_CAPACITY, netTrancheApyBounds, pickDefaultTrancheId, poolAllTranchesFull, trancheApyBounds, trancheHasCapacity, trancheRiskRank, } from './tranches';
 export { classifyWalletFailure, isUnpredictableGas, isUserRejected, } from './wallet-errors';

package/dist/domain/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACH,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACH,SAAS,EACT,2BAA2B,EAC3B,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,yBAAyB,EACzB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,GAC5B,MAAM,eAAe,CAAC;AAavB,OAAO,EACH,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACH,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACX,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,iCAAiC,EACjC,6BAA6B,EAC7B,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACH,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EACH,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAClB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACH,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACH,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GACrB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EACH,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACH,SAAS,EACT,2BAA2B,EAC3B,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,yBAAyB,EACzB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,GAC5B,MAAM,eAAe,CAAC;AAavB,OAAO,EACH,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACH,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACX,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,iCAAiC,EACjC,6BAA6B,EAC7B,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACH,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EACH,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAClB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACH,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACH,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GACrB,MAAM,UAAU,CAAC"}

package/dist/domain/strategy-summary.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A strategy's SHORT blurb, as plain text: the CMS `liteDescription` first,
+ * else the first paragraph of the long `description`, else nothing.
+ *
+ * Lifted from kasu-ui (`pickShortDescription`, its deposit dialog and landing
+ * strategy card) so every app shows the same line, and pinned to its output
+ * for every live CMS row. The rules are facts about how the CMS is authored,
+ * not formatting preferences:
+ *
+ *   - `liteDescription` IS THE SHORT ONE. `description` is the credit
+ *     originator's several-paragraph profile; on a card it is a wall.
+ *   - `"Not Available"` IS A PLACEHOLDER, not editorial. Several rows carry it
+ *     verbatim, and it must read as missing, not print. Matched on the whole
+ *     trimmed value, case-insensitively. It applies to `liteDescription` only.
+ *   - EMPTY OR BLANK IS MISSING. The service maps a pool with no CMS record to
+ *     `''`.
+ *   - THE FIELDS HOLD MARKDOWN. `liteDescription` can open with a `**bold**`
+ *     lead, and the surfaces this feeds render plain text, so the markers are
+ *     stripped (bold, then italic, then inline code).
+ *   - AND HARD NEWLINES. Every run of whitespace becomes one space, so a
+ *     paragraph break inside the value is not a gap in a one-line slot.
+ *   - NOT SANITISED. "Plain text" means text to render AS text. HTML tags,
+ *     entities and link syntax (`<script>`, `&lt;`, `[a](javascript:…)`) pass
+ *     through unchanged, and removing markers can join fragments into a tag
+ *     (`<scr**i**pt>` becomes `<script>`). Render it as a text node, never as
+ *     HTML or markdown.
+ *
+ * Two refinements over the kasu-ui original, neither reachable by any live
+ * row: the cleaned text is trimmed (a CRLF value no longer ends in a space),
+ * and a `liteDescription` that cleans to nothing (`** **`) counts as missing,
+ * so the result is never a blank string.
+ *
+ * This authors no string of its own. It selects and cleans editorial the CMS
+ * already holds, and an absent blurb is `undefined`, never a fallback sentence:
+ * what "no blurb" means is the render site's decision.
+ *
+ * Pure. A value that is not a string reads as missing.
+ */
+export declare function pickShortDescription(source: ShortDescriptionSource): string | undefined;
+/**
+ * The two CMS fields `pickShortDescription` reads. A `PoolOverview` and a
+ * facade `Strategy` both satisfy it.
+ */
+export interface ShortDescriptionSource {
+    liteDescription?: string | null;
+    description?: string | null;
+}

package/dist/domain/strategy-summary.js

@@ -0,0 +1,76 @@
+/**
+ * A strategy's SHORT blurb, as plain text: the CMS `liteDescription` first,
+ * else the first paragraph of the long `description`, else nothing.
+ *
+ * Lifted from kasu-ui (`pickShortDescription`, its deposit dialog and landing
+ * strategy card) so every app shows the same line, and pinned to its output
+ * for every live CMS row. The rules are facts about how the CMS is authored,
+ * not formatting preferences:
+ *
+ *   - `liteDescription` IS THE SHORT ONE. `description` is the credit
+ *     originator's several-paragraph profile; on a card it is a wall.
+ *   - `"Not Available"` IS A PLACEHOLDER, not editorial. Several rows carry it
+ *     verbatim, and it must read as missing, not print. Matched on the whole
+ *     trimmed value, case-insensitively. It applies to `liteDescription` only.
+ *   - EMPTY OR BLANK IS MISSING. The service maps a pool with no CMS record to
+ *     `''`.
+ *   - THE FIELDS HOLD MARKDOWN. `liteDescription` can open with a `**bold**`
+ *     lead, and the surfaces this feeds render plain text, so the markers are
+ *     stripped (bold, then italic, then inline code).
+ *   - AND HARD NEWLINES. Every run of whitespace becomes one space, so a
+ *     paragraph break inside the value is not a gap in a one-line slot.
+ *   - NOT SANITISED. "Plain text" means text to render AS text. HTML tags,
+ *     entities and link syntax (`<script>`, `&lt;`, `[a](javascript:…)`) pass
+ *     through unchanged, and removing markers can join fragments into a tag
+ *     (`<scr**i**pt>` becomes `<script>`). Render it as a text node, never as
+ *     HTML or markdown.
+ *
+ * Two refinements over the kasu-ui original, neither reachable by any live
+ * row: the cleaned text is trimmed (a CRLF value no longer ends in a space),
+ * and a `liteDescription` that cleans to nothing (`** **`) counts as missing,
+ * so the result is never a blank string.
+ *
+ * This authors no string of its own. It selects and cleans editorial the CMS
+ * already holds, and an absent blurb is `undefined`, never a fallback sentence:
+ * what "no blurb" means is the render site's decision.
+ *
+ * Pure. A value that is not a string reads as missing.
+ */
+export function pickShortDescription(source) {
+    var _a;
+    const lite = asTrimmed(source.liteDescription);
+    if (lite && !NOT_AVAILABLE.test(lite)) {
+        const summary = toOneLine(lite);
+        if (summary)
+            return summary;
+    }
+    const long = asTrimmed(source.description);
+    if (long) {
+        const firstParagraph = (_a = long.split(PARAGRAPH_BREAK, 1)[0]) !== null && _a !== void 0 ? _a : long;
+        return toOneLine(firstParagraph) || undefined;
+    }
+    return undefined;
+}
+const NOT_AVAILABLE = /^not available$/i;
+const PARAGRAPH_BREAK = /\n\s*\n/;
+function asTrimmed(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/** Markers off, whitespace runs to one space, ends trimmed. `''` when nothing is left. */
+function toOneLine(text) {
+    return stripInlineMarkdown(text).replace(/\s+/gu, ' ').trim();
+}
+/**
+ * Inline markdown markers off, in the order bold → italic → code. The bold
+ * passes consume every `**` / `__` pair first, so the italic patterns can match
+ * a lone `*` / `_` without lookarounds.
+ */
+function stripInlineMarkdown(input) {
+    return input
+        .replace(/\*\*(.+?)\*\*/g, '$1')
+        .replace(/__(.+?)__/g, '$1')
+        .replace(/\*(.+?)\*/g, '$1')
+        .replace(/_(.+?)_/g, '$1')
+        .replace(/`([^`]+)`/g, '$1');
+}
+//# sourceMappingURL=strategy-summary.js.map

package/dist/domain/strategy-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-summary.js","sourceRoot":"","sources":["../../src/domain/strategy-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,oBAAoB,CAChC,MAA8B;;IAE9B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,IAAI,EAAE,CAAC;QACP,MAAM,cAAc,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAC;QACjE,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;IAClD,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAWD,MAAM,aAAa,GAAG,kBAAkB,CAAC;AACzC,MAAM,eAAe,GAAG,SAAS,CAAC;AAElC,SAAS,SAAS,CAAC,KAAc;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,0FAA0F;AAC1F,SAAS,SAAS,CAAC,IAAY;IAC3B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACtC,OAAO,KAAK;SACP,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;SAC/B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;SACzB,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/facade/strategies.js

@@ -8,6 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { selectVisiblePools } from '../domain/pools';
+import { pickShortDescription } from '../domain/strategy-summary';
 /**
  * High-level facade for browsing Kasu lending strategies (pools).
  *
@@ -194,6 +195,7 @@ export class StrategiesFacade {
             subheading: nonEmptyOrUndefined(pool.subheading),
             description: pool.description,
             liteDescription: nonEmptyOrUndefined(pool.liteDescription),
+            summary: pickShortDescription(pool),
             isActive: pool.isActive,
             apy: pool.apy,
             tvl: pool.totalValueLocked,

package/dist/facade/strategies.js.map

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

package/dist/facade/types.d.ts

@@ -98,6 +98,19 @@ export interface Strategy {
      * Absent when the record has none, or an empty one.
      */
     liteDescription?: string;
+    /**
+     * The strategy's short blurb as ONE line of plain text, for cards and
+     * compact surfaces: `liteDescription` when it is usable, else the first
+     * paragraph of `description`, with inline markdown markers stripped and
+     * every run of whitespace collapsed to one space. The `"Not Available"`
+     * placeholder, an empty or blank value, and a missing one all count as
+     * absent. `undefined` when neither field yields a blurb; the SDK never
+     * substitutes a sentence of its own. See `pickShortDescription`.
+     *
+     * Not sanitised: HTML tags and link syntax pass through unchanged. Render
+     * it as text, never as HTML or markdown.
+     */
+    summary?: string;
     isActive: boolean;
     /** Weighted-average APY across tranches (decimal, e.g. 0.08 = 8 %). */
     apy: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kasufinance/kasu-sdk",
-    "version": "2.10.3",
+    "version": "2.11.0",
     "description": "TypeScript SDK for the Kasu Finance protocol — pool data, portfolio analytics, and KYC-gated deposits and withdrawals on Base and XDC",
     "keywords": [
         "kasu",
@@ -48,6 +48,7 @@
         "build-tc": "typechain --target ethers-v5 --out-dir src/contracts './abis/*.json'",
         "build": "eslint . && tsc --build --force tsconfig.json",
         "prepublishOnly": "npm run build && npm run rollup-build",
+        "prepare": "node .githooks/install.cjs",
         "build:watch": "npx tsc -b --force --watch",
         "rollup-build": "rollup -c",
         "lint": "eslint . --fix"

package/src/domain/index.ts

@@ -16,6 +16,10 @@
  *    reconstructs byte-for-byte to verify a lender's signature. Those are not
  *    copy: nobody may reword them, in any language, without a matching backend
  *    change, which is exactly why they belong in one place.
+ *
+ *    `pickShortDescription` returns a string but AUTHORS none: it selects and
+ *    cleans editorial the CMS already holds, and an absent blurb is
+ *    `undefined`, never a sentence of its own.
  * 2. **Pure.** No network, no clock, no environment. Anything with I/O belongs
  *    in `facade/` (see `fetchUnusedPoolIds`).
  */
@@ -163,6 +167,9 @@ export {
 } from './sponsored-calls';
 export type { SponsoredCall, SponsoredCallKind } from './sponsored-calls';
 
+export { pickShortDescription } from './strategy-summary';
+export type { ShortDescriptionSource } from './strategy-summary';
+
 export { getTrancheDisplayName, UPPER_MEZZANINE } from './tranche-display-name';
 
 export {

package/src/domain/strategy-summary.ts

@@ -0,0 +1,88 @@
+/**
+ * A strategy's SHORT blurb, as plain text: the CMS `liteDescription` first,
+ * else the first paragraph of the long `description`, else nothing.
+ *
+ * Lifted from kasu-ui (`pickShortDescription`, its deposit dialog and landing
+ * strategy card) so every app shows the same line, and pinned to its output
+ * for every live CMS row. The rules are facts about how the CMS is authored,
+ * not formatting preferences:
+ *
+ *   - `liteDescription` IS THE SHORT ONE. `description` is the credit
+ *     originator's several-paragraph profile; on a card it is a wall.
+ *   - `"Not Available"` IS A PLACEHOLDER, not editorial. Several rows carry it
+ *     verbatim, and it must read as missing, not print. Matched on the whole
+ *     trimmed value, case-insensitively. It applies to `liteDescription` only.
+ *   - EMPTY OR BLANK IS MISSING. The service maps a pool with no CMS record to
+ *     `''`.
+ *   - THE FIELDS HOLD MARKDOWN. `liteDescription` can open with a `**bold**`
+ *     lead, and the surfaces this feeds render plain text, so the markers are
+ *     stripped (bold, then italic, then inline code).
+ *   - AND HARD NEWLINES. Every run of whitespace becomes one space, so a
+ *     paragraph break inside the value is not a gap in a one-line slot.
+ *   - NOT SANITISED. "Plain text" means text to render AS text. HTML tags,
+ *     entities and link syntax (`<script>`, `&lt;`, `[a](javascript:…)`) pass
+ *     through unchanged, and removing markers can join fragments into a tag
+ *     (`<scr**i**pt>` becomes `<script>`). Render it as a text node, never as
+ *     HTML or markdown.
+ *
+ * Two refinements over the kasu-ui original, neither reachable by any live
+ * row: the cleaned text is trimmed (a CRLF value no longer ends in a space),
+ * and a `liteDescription` that cleans to nothing (`** **`) counts as missing,
+ * so the result is never a blank string.
+ *
+ * This authors no string of its own. It selects and cleans editorial the CMS
+ * already holds, and an absent blurb is `undefined`, never a fallback sentence:
+ * what "no blurb" means is the render site's decision.
+ *
+ * Pure. A value that is not a string reads as missing.
+ */
+export function pickShortDescription(
+    source: ShortDescriptionSource,
+): string | undefined {
+    const lite = asTrimmed(source.liteDescription);
+    if (lite && !NOT_AVAILABLE.test(lite)) {
+        const summary = toOneLine(lite);
+        if (summary) return summary;
+    }
+    const long = asTrimmed(source.description);
+    if (long) {
+        const firstParagraph = long.split(PARAGRAPH_BREAK, 1)[0] ?? long;
+        return toOneLine(firstParagraph) || undefined;
+    }
+    return undefined;
+}
+
+/**
+ * The two CMS fields `pickShortDescription` reads. A `PoolOverview` and a
+ * facade `Strategy` both satisfy it.
+ */
+export interface ShortDescriptionSource {
+    liteDescription?: string | null;
+    description?: string | null;
+}
+
+const NOT_AVAILABLE = /^not available$/i;
+const PARAGRAPH_BREAK = /\n\s*\n/;
+
+function asTrimmed(value: unknown): string {
+    return typeof value === 'string' ? value.trim() : '';
+}
+
+/** Markers off, whitespace runs to one space, ends trimmed. `''` when nothing is left. */
+function toOneLine(text: string): string {
+    return stripInlineMarkdown(text).replace(/\s+/gu, ' ').trim();
+}
+
+/**
+ * Inline markdown markers off, in the order bold → italic → code. The bold
+ * passes consume every `**` / `__` pair first, so the italic patterns can match
+ * a lone `*` / `_` without lookarounds.
+ */
+function stripInlineMarkdown(input: string): string {
+    return input
+        .replace(/\*\*(.+?)\*\*/g, '$1')
+        .replace(/__(.+?)__/g, '$1')
+        .replace(/\*(.+?)\*/g, '$1')
+        .replace(/_(.+?)_/g, '$1')
+        .replace(/`([^`]+)`/g, '$1');
+}

package/src/facade/strategies.ts

@@ -1,4 +1,5 @@
 import { selectVisiblePools } from '../domain/pools';
+import { pickShortDescription } from '../domain/strategy-summary';
 import { DataService } from '../services/DataService/data-service';
 import {
     PoolDelegateProfileAndHistory,
@@ -218,6 +219,7 @@ export class StrategiesFacade {
             subheading: nonEmptyOrUndefined(pool.subheading),
             description: pool.description,
             liteDescription: nonEmptyOrUndefined(pool.liteDescription),
+            summary: pickShortDescription(pool),
             isActive: pool.isActive,
             apy: pool.apy,
             tvl: pool.totalValueLocked,

package/src/facade/types.ts

@@ -121,6 +121,19 @@ export interface Strategy {
      * Absent when the record has none, or an empty one.
      */
     liteDescription?: string;
+    /**
+     * The strategy's short blurb as ONE line of plain text, for cards and
+     * compact surfaces: `liteDescription` when it is usable, else the first
+     * paragraph of `description`, with inline markdown markers stripped and
+     * every run of whitespace collapsed to one space. The `"Not Available"`
+     * placeholder, an empty or blank value, and a missing one all count as
+     * absent. `undefined` when neither field yields a blurb; the SDK never
+     * substitutes a sentence of its own. See `pickShortDescription`.
+     *
+     * Not sanitised: HTML tags and link syntax pass through unchanged. Render
+     * it as text, never as HTML or markdown.
+     */
+    summary?: string;
     isActive: boolean;
     /** Weighted-average APY across tranches (decimal, e.g. 0.08 = 8 %). */
     apy: number;