@gearbox-protocol/sdk 15.1.0-next.1 → 15.1.0-next.10

package/dist/cjs/model/charts.schema.js

@@ -0,0 +1,240 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_charts = require("./charts.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
+let zod_v4 = require("zod/v4");
+//#region src/model/charts.schema.ts
+/**
+* Runtime schemas for {@link ./charts.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+*
+* Metric schemas are shared with the backend, while
+* {@link chartBundleSchemaFor} builds the response schema for one concrete
+* request. Component schemas remain available for consumers that validate
+* model fragments.
+**/
+/**
+* {@link ChartRange}
+**/
+const chartRangeSchema = zod_v4.z.enum(require_model_charts.CHART_RANGES);
+/**
+* {@link PoolOpportunityChartMetric}
+**/
+const poolOpportunityChartMetricSchema = zod_v4.z.enum(require_model_charts.POOL_OPPORTUNITY_CHART_METRICS);
+/**
+* {@link StrategyOpportunityChartMetric}
+**/
+const strategyOpportunityChartMetricSchema = zod_v4.z.enum(require_model_charts.STRATEGY_OPPORTUNITY_CHART_METRICS);
+/**
+* {@link PoolPositionChartMetric}
+**/
+const poolPositionChartMetricSchema = zod_v4.z.enum(require_model_charts.POOL_POSITION_CHART_METRICS);
+/**
+* {@link StrategyPositionChartMetric}
+**/
+const strategyPositionChartMetricSchema = zod_v4.z.enum(require_model_charts.STRATEGY_POSITION_CHART_METRICS);
+/**
+* {@link ChartMetric}, every metric either kind of subject can chart.
+**/
+const chartMetricSchema = zod_v4.z.union([
+	poolOpportunityChartMetricSchema,
+	strategyOpportunityChartMetricSchema,
+	poolPositionChartMetricSchema,
+	strategyPositionChartMetricSchema
+]);
+/**
+* {@link ChartQuery}
+**/
+const chartQuerySchema = zod_v4.z.object({
+	metrics: zod_v4.z.array(chartMetricSchema).readonly().refine((metrics) => metrics.length > 0, { error: "a chart read needs at least one metric" }).refine((metrics) => new Set(metrics).size === metrics.length, { error: "a chart read needs distinct metrics" }),
+	range: chartRangeSchema
+});
+/**
+* {@link ChartQuery} as a URL can carry it: the metrics comma-joined, since
+* repeated `?metrics=` entries would order differently between clients and give
+* one request two cache keys.
+**/
+const chartQueryParamsSchema = zod_v4.z.object({
+	metrics: zod_v4.z.string().regex(/^\w+(,\w+)*$/),
+	range: chartRangeSchema
+});
+/**
+* Codec for {@link ChartQuery} to encode/decode to/from url query parameters.
+*
+* The one place the wire form of a chart request is decided. The SDK encodes
+* with it, the backend decodes with it, and the checks that a read names at
+* least one metric and names none of them twice ride along in both directions —
+* so a bad request fails before it is issued, not after a round trip.
+**/
+const chartQueryCodec = zod_v4.z.codec(chartQueryParamsSchema, chartQuerySchema, {
+	decode: (params) => ({
+		metrics: params.metrics.split(","),
+		range: params.range
+	}),
+	encode: (query) => ({
+		metrics: query.metrics.join(","),
+		range: query.range
+	})
+});
+/**
+* {@link ChartDenomination}
+**/
+const chartDenominationSchema = zod_v4.z.discriminatedUnion("unit", [
+	zod_v4.z.object({ unit: zod_v4.z.literal("bps") }),
+	zod_v4.z.object({ unit: zod_v4.z.literal("usd") }),
+	zod_v4.z.object({ unit: zod_v4.z.literal("scalar") }),
+	zod_v4.z.object({
+		unit: zod_v4.z.literal("token"),
+		base: require_model_primitives_schema.tokenSchema
+	}),
+	zod_v4.z.object({
+		unit: zod_v4.z.literal("ratio"),
+		base: require_model_primitives_schema.tokenSchema,
+		quote: require_model_primitives_schema.tokenSchema
+	})
+]);
+/**
+* {@link ChartValue}. `null` is a gap, never a zero.
+**/
+const chartValueSchema = zod_v4.z.number().nullable();
+/**
+* {@link ChartSeries}
+**/
+const chartSeriesSchema = zod_v4.z.union([zod_v4.z.intersection(zod_v4.z.object({
+	status: zod_v4.z.literal("ok"),
+	values: zod_v4.z.array(chartValueSchema)
+}), chartDenominationSchema), zod_v4.z.object({
+	status: zod_v4.z.literal("unavailable"),
+	reason: zod_v4.z.object({
+		code: zod_v4.z.enum(require_model_charts.CHART_UNAVAILABLE_CODES),
+		message: zod_v4.z.string().optional()
+	})
+})]);
+/**
+* {@link ChartWindow}
+**/
+const chartWindowSchema = zod_v4.z.object({
+	range: chartRangeSchema,
+	from: require_model_primitives_schema.timestampSchema,
+	to: require_model_primitives_schema.timestampSchema
+});
+const gridSamplingSchema = zod_v4.z.object({
+	kind: zod_v4.z.literal("grid"),
+	intervalSeconds: zod_v4.z.number().int().positive()
+});
+/**
+* A bundle whose series are keyed by `keys`.
+*
+* `z.record` over a literal union is what enforces the metric set: a key that
+* was not asked for is rejected, and one that was but is missing fails as an
+* absent value. Exactly-once therefore needs no counting — an object cannot
+* hold the same key twice.
+**/
+function chartBundleSchemaWith(keys, expectedRange) {
+	return zod_v4.z.object({
+		window: chartWindowSchema,
+		sampling: gridSamplingSchema,
+		timestamps: zod_v4.z.array(require_model_primitives_schema.timestampSchema),
+		series: zod_v4.z.record(keys, chartSeriesSchema)
+	}).superRefine((bundle, ctx) => checkChartBundle(bundle, ctx, expectedRange));
+}
+/**
+* The invariants a bundle upholds beyond its shape, checked on every read so a
+* backend that breaks one is rejected rather than plotted:
+*
+* - each available series holds exactly one value per timestamp, which is what
+*   makes two series of a bundle comparable at an index;
+* - a series' unit is the one {@link CHART_METRIC_UNITS} gives the metric it is
+*   keyed by, so a consumer can format from either without them disagreeing;
+* - the window's bounds are the axis' own, so a chart drawn from `window` and a
+*   chart drawn from `timestamps` cover the same span;
+* - timestamps lie on the declared grid and are exactly one interval apart;
+* - when validating a read, the response names the range that was requested.
+**/
+function checkChartBundle(bundle, ctx, expectedRange) {
+	const { sampling, timestamps, window, series } = bundle;
+	const entries = Object.entries(series);
+	for (const [metric, chart] of entries) {
+		if (chart.status !== "ok") continue;
+		if (chart.values.length !== timestamps.length) ctx.addIssue({
+			code: "custom",
+			path: [
+				"series",
+				metric,
+				"values"
+			],
+			message: `series "${metric}" holds ${chart.values.length} values for ${timestamps.length} timestamps`
+		});
+		if (require_model_charts.CHART_METRIC_UNITS[metric] !== chart.unit) ctx.addIssue({
+			code: "custom",
+			path: [
+				"series",
+				metric,
+				"unit"
+			],
+			message: `metric "${metric}" is ${require_model_charts.CHART_METRIC_UNITS[metric]}, not ${chart.unit}`
+		});
+	}
+	const first = timestamps.at(0);
+	const last = timestamps.at(-1);
+	if (first !== void 0 && first !== window.from) ctx.addIssue({
+		code: "custom",
+		path: ["window", "from"],
+		message: `window starts at ${window.from} but the axis starts at ${first}`
+	});
+	if (last !== void 0 && last !== window.to) ctx.addIssue({
+		code: "custom",
+		path: ["window", "to"],
+		message: `window ends at ${window.to} but the axis ends at ${last}`
+	});
+	if (expectedRange !== void 0 && window.range !== expectedRange) ctx.addIssue({
+		code: "custom",
+		path: ["window", "range"],
+		message: `requested range ${expectedRange}, received ${window.range}`
+	});
+	for (let i = 0; i < timestamps.length; i += 1) {
+		const timestamp = timestamps[i];
+		if (timestamp % sampling.intervalSeconds !== 0) ctx.addIssue({
+			code: "custom",
+			path: ["timestamps", i],
+			message: `timestamp ${timestamp} is not on the ${sampling.intervalSeconds}-second grid`
+		});
+		const previous = timestamps[i - 1];
+		if (previous !== void 0 && timestamp - previous !== sampling.intervalSeconds) ctx.addIssue({
+			code: "custom",
+			path: ["timestamps", i],
+			message: `timestamps are not ${sampling.intervalSeconds} seconds apart`
+		});
+	}
+}
+/**
+* The schema one chart read is decoded with: a {@link ChartBundle} keyed by the
+* requested distinct metrics, all of them and nothing else, for the requested
+* range.
+*
+* Pinning the metrics is what upholds the `ChartBundle<Metrics>` a caller gets
+* back — a response that answers a different question fails validation rather
+* than being cast into the requested shape. The declared return type is the one
+* the key schema actually enforces, which the compiler cannot see through a
+* schema built from a runtime list.
+**/
+function chartBundleSchemaFor(metrics, range) {
+	if (metrics.length === 0) throw new RangeError("a chart read needs at least one metric");
+	if (new Set(metrics).size !== metrics.length) throw new RangeError("a chart read needs distinct metrics");
+	const literals = metrics.map((metric) => zod_v4.z.literal(metric));
+	return chartBundleSchemaWith(zod_v4.z.union(literals), range);
+}
+//#endregion
+exports.chartBundleSchemaFor = chartBundleSchemaFor;
+exports.chartDenominationSchema = chartDenominationSchema;
+exports.chartMetricSchema = chartMetricSchema;
+exports.chartQueryCodec = chartQueryCodec;
+exports.chartQueryParamsSchema = chartQueryParamsSchema;
+exports.chartQuerySchema = chartQuerySchema;
+exports.chartRangeSchema = chartRangeSchema;
+exports.chartSeriesSchema = chartSeriesSchema;
+exports.chartValueSchema = chartValueSchema;
+exports.chartWindowSchema = chartWindowSchema;
+exports.poolOpportunityChartMetricSchema = poolOpportunityChartMetricSchema;
+exports.poolPositionChartMetricSchema = poolPositionChartMetricSchema;
+exports.strategyOpportunityChartMetricSchema = strategyOpportunityChartMetricSchema;
+exports.strategyPositionChartMetricSchema = strategyPositionChartMetricSchema;

package/dist/cjs/model/index.js

@@ -1,34 +1,50 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_charts = require("./charts.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_charts_schema = require("./charts.schema.js");
 require("./curators.js");
 const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_history = require("./history.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
-const require_model_opportunities_schema = require("./opportunities.schema.js");
-const require_model_liquidations_schema = require("./liquidations.schema.js");
-const require_model_positions_schema = require("./positions.schema.js");
-const require_model_history_schema = require("./history.schema.js");
 const require_model_liquidations = require("./liquidations.js");
+const require_model_liquidations_schema = require("./liquidations.schema.js");
+require("./notices.js");
+const require_model_notices_schema = require("./notices.schema.js");
 const require_model_opportunities = require("./opportunities.js");
+const require_model_opportunities_schema = require("./opportunities.schema.js");
 const require_model_positions = require("./positions.js");
+const require_model_positions_schema = require("./positions.schema.js");
 require("./primitives.js");
 require("./response.js");
 const require_model_response_schema = require("./response.schema.js");
+exports.CHART_METRIC_UNITS = require_model_charts.CHART_METRIC_UNITS;
+exports.CHART_RANGES = require_model_charts.CHART_RANGES;
+exports.CHART_UNAVAILABLE_CODES = require_model_charts.CHART_UNAVAILABLE_CODES;
 exports.FILTER_ALL = require_model_filters.FILTER_ALL;
-exports.POOL_HISTORY_METRICS = require_model_history.POOL_HISTORY_METRICS;
-exports.POOL_POSITION_HISTORY_METRICS = require_model_history.POOL_POSITION_HISTORY_METRICS;
-exports.STRATEGY_HISTORY_METRICS = require_model_history.STRATEGY_HISTORY_METRICS;
-exports.STRATEGY_POSITION_HISTORY_METRICS = require_model_history.STRATEGY_POSITION_HISTORY_METRICS;
+exports.POOL_OPPORTUNITY_CHART_METRICS = require_model_charts.POOL_OPPORTUNITY_CHART_METRICS;
+exports.POOL_POSITION_CHART_METRICS = require_model_charts.POOL_POSITION_CHART_METRICS;
+exports.STRATEGY_OPPORTUNITY_CHART_METRICS = require_model_charts.STRATEGY_OPPORTUNITY_CHART_METRICS;
+exports.STRATEGY_POSITION_CHART_METRICS = require_model_charts.STRATEGY_POSITION_CHART_METRICS;
 exports.amountSchema = require_model_primitives_schema.amountSchema;
 exports.apyBreakdownSchema = require_model_opportunities_schema.apyBreakdownSchema;
 exports.assetTypeSchema = require_model_primitives_schema.assetTypeSchema;
 exports.booleanParamSchema = require_model_filters_schema.booleanParamSchema;
+exports.borrowRateBreakdownSchema = require_model_positions_schema.borrowRateBreakdownSchema;
 exports.bpsSchema = require_model_primitives_schema.bpsSchema;
 exports.chainFailedSchema = require_model_response_schema.chainFailedSchema;
 exports.chainIdSchema = require_model_primitives_schema.chainIdSchema;
 exports.chainMetadataSchema = require_model_response_schema.chainMetadataSchema;
 exports.chainSucceededSchema = require_model_response_schema.chainSucceededSchema;
+exports.chartBundleSchemaFor = require_model_charts_schema.chartBundleSchemaFor;
+exports.chartDenominationSchema = require_model_charts_schema.chartDenominationSchema;
+exports.chartMetricSchema = require_model_charts_schema.chartMetricSchema;
+exports.chartQueryCodec = require_model_charts_schema.chartQueryCodec;
+exports.chartQueryParamsSchema = require_model_charts_schema.chartQueryParamsSchema;
+exports.chartQuerySchema = require_model_charts_schema.chartQuerySchema;
+exports.chartRangeSchema = require_model_charts_schema.chartRangeSchema;
+exports.chartSeriesSchema = require_model_charts_schema.chartSeriesSchema;
+exports.chartValueSchema = require_model_charts_schema.chartValueSchema;
+exports.chartWindowSchema = require_model_charts_schema.chartWindowSchema;
 exports.curatorNameSchema = require_model_curators_schema.curatorNameSchema;
 exports.curatorSchema = require_model_curators_schema.curatorSchema;
 exports.dataSourceSchema = require_model_response_schema.dataSourceSchema;
@@ -36,11 +52,6 @@ exports.delayedReceivedAssetSchema = require_model_liquidations_schema.delayedRe
 exports.encodeFlag = require_model_filters_schema.encodeFlag;
 exports.filterAllSchema = require_model_filters_schema.filterAllSchema;
 exports.filterable = require_model_filters_schema.filterable;
-exports.historyChartMetadataSchema = require_model_history_schema.historyChartMetadataSchema;
-exports.historyMetricSchema = require_model_history_schema.historyMetricSchema;
-exports.historyPointSchema = require_model_history_schema.historyPointSchema;
-exports.historyRangeSchema = require_model_history_schema.historyRangeSchema;
-exports.historySeriesSchema = require_model_history_schema.historySeriesSchema;
 exports.instantReceivedAssetSchema = require_model_liquidations_schema.instantReceivedAssetSchema;
 exports.isFilterSet = require_model_filters.isFilterSet;
 exports.leverageSchema = require_model_primitives_schema.leverageSchema;
@@ -53,12 +64,13 @@ exports.liquidationPositionSchema = require_model_liquidations_schema.liquidatio
 exports.matchesLiquidatableAccountFilter = require_model_liquidations.matchesLiquidatableAccountFilter;
 exports.matchesOpportunityFilter = require_model_opportunities.matchesOpportunityFilter;
 exports.matchesPositionFilter = require_model_positions.matchesPositionFilter;
+exports.noticeKindSchema = require_model_notices_schema.noticeKindSchema;
+exports.noticeSchema = require_model_notices_schema.noticeSchema;
 exports.opportunityBaseSchema = require_model_opportunities_schema.opportunityBaseSchema;
 exports.opportunityDetailSchema = require_model_opportunities_schema.opportunityDetailSchema;
 exports.opportunityFilterQueryParamsSchema = require_model_opportunities_schema.opportunityFilterQueryParamsSchema;
 exports.opportunityFilterQuerySchema = require_model_opportunities_schema.opportunityFilterQuerySchema;
 exports.opportunityFilterSchema = require_model_opportunities_schema.opportunityFilterSchema;
-exports.opportunityHistoryQuerySchema = require_model_history_schema.opportunityHistoryQuerySchema;
 exports.opportunityId = require_model_opportunities.opportunityId;
 exports.opportunityKeySchema = require_model_opportunities_schema.opportunityKeySchema;
 exports.opportunityKindSchema = require_model_opportunities_schema.opportunityKindSchema;
@@ -68,12 +80,12 @@ exports.pointRewardsSchema = require_model_opportunities_schema.pointRewardsSche
 exports.pointsProgramPnLSchema = require_model_positions_schema.pointsProgramPnLSchema;
 exports.pointsProgramSchema = require_model_opportunities_schema.pointsProgramSchema;
 exports.pointsRewardsPnLSchema = require_model_positions_schema.pointsRewardsPnLSchema;
-exports.poolHistoryMetricSchema = require_model_history_schema.poolHistoryMetricSchema;
+exports.poolOpportunityChartMetricSchema = require_model_charts_schema.poolOpportunityChartMetricSchema;
 exports.poolOpportunityDetailSchema = require_model_opportunities_schema.poolOpportunityDetailSchema;
 exports.poolOpportunityId = require_model_opportunities.poolOpportunityId;
 exports.poolOpportunityKeySchema = require_model_opportunities_schema.poolOpportunityKeySchema;
 exports.poolOpportunitySchema = require_model_opportunities_schema.poolOpportunitySchema;
-exports.poolPositionHistoryMetricSchema = require_model_history_schema.poolPositionHistoryMetricSchema;
+exports.poolPositionChartMetricSchema = require_model_charts_schema.poolPositionChartMetricSchema;
 exports.poolPositionId = require_model_positions.poolPositionId;
 exports.poolPositionKeySchema = require_model_positions_schema.poolPositionKeySchema;
 exports.poolPositionSchema = require_model_positions_schema.poolPositionSchema;
@@ -81,12 +93,13 @@ exports.positionCollateralSchema = require_model_positions_schema.positionCollat
 exports.positionFilterQueryParamsSchema = require_model_positions_schema.positionFilterQueryParamsSchema;
 exports.positionFilterQuerySchema = require_model_positions_schema.positionFilterQuerySchema;
 exports.positionFilterSchema = require_model_positions_schema.positionFilterSchema;
-exports.positionHistoryMetricSchema = require_model_history_schema.positionHistoryMetricSchema;
-exports.positionHistoryQuerySchema = require_model_history_schema.positionHistoryQuerySchema;
 exports.positionId = require_model_positions.positionId;
 exports.positionKeySchema = require_model_positions_schema.positionKeySchema;
 exports.positionKindSchema = require_model_positions_schema.positionKindSchema;
 exports.positionSchema = require_model_positions_schema.positionSchema;
+exports.positionTransactionKindSchema = require_model_positions_schema.positionTransactionKindSchema;
+exports.positionTransactionSchema = require_model_positions_schema.positionTransactionSchema;
+exports.positionsTotalsSchema = require_model_positions_schema.positionsTotalsSchema;
 exports.priceFeedDataSchema = require_model_opportunities_schema.priceFeedDataSchema;
 exports.priceFeedSummarySchema = require_model_opportunities_schema.priceFeedSummarySchema;
 exports.quotaAssetSchema = require_model_opportunities_schema.quotaAssetSchema;
@@ -97,12 +110,12 @@ exports.responseMetadataSchema = require_model_response_schema.responseMetadataS
 exports.responseSchema = require_model_response_schema.responseSchema;
 exports.rewardsPnLSchema = require_model_positions_schema.rewardsPnLSchema;
 exports.rewardsSchema = require_model_opportunities_schema.rewardsSchema;
-exports.strategyHistoryMetricSchema = require_model_history_schema.strategyHistoryMetricSchema;
+exports.strategyOpportunityChartMetricSchema = require_model_charts_schema.strategyOpportunityChartMetricSchema;
 exports.strategyOpportunityDetailSchema = require_model_opportunities_schema.strategyOpportunityDetailSchema;
 exports.strategyOpportunityId = require_model_opportunities.strategyOpportunityId;
 exports.strategyOpportunityKeySchema = require_model_opportunities_schema.strategyOpportunityKeySchema;
 exports.strategyOpportunitySchema = require_model_opportunities_schema.strategyOpportunitySchema;
-exports.strategyPositionHistoryMetricSchema = require_model_history_schema.strategyPositionHistoryMetricSchema;
+exports.strategyPositionChartMetricSchema = require_model_charts_schema.strategyPositionChartMetricSchema;
 exports.strategyPositionId = require_model_positions.strategyPositionId;
 exports.strategyPositionKeySchema = require_model_positions_schema.strategyPositionKeySchema;
 exports.strategyPositionSchema = require_model_positions_schema.strategyPositionSchema;

package/dist/cjs/model/liquidations.schema.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
-const require_model_filters_schema = require("./filters.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_filters_schema = require("./filters.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/liquidations.schema.ts
 /**

package/dist/cjs/model/notices.schema.js

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_primitives_schema = require("./primitives.schema.js");
+let zod_v4 = require("zod/v4");
+//#region src/model/notices.schema.ts
+/**
+* {@link NoticeKind}
+**/
+const noticeKindSchema = zod_v4.z.union([
+	zod_v4.z.literal("expired"),
+	zod_v4.z.literal("externalRewards"),
+	zod_v4.z.literal("extraApy"),
+	zod_v4.z.literal("warning"),
+	zod_v4.z.literal("disclaimer")
+]);
+/**
+* {@link Notice}
+**/
+const noticeSchema = zod_v4.z.object({
+	kind: noticeKindSchema,
+	message: zod_v4.z.string(),
+	token: require_model_primitives_schema.tokenSchema.optional()
+});
+//#endregion
+exports.noticeKindSchema = noticeKindSchema;
+exports.noticeSchema = noticeSchema;

package/dist/cjs/model/opportunities.schema.js

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/opportunities.schema.ts
 /**

package/dist/cjs/model/positions.schema.js

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_utils_zod = require("../sdk/utils/zod.js");
+const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_primitives_schema = require("./primitives.schema.js");
-const require_model_opportunities_schema = require("./opportunities.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
+const require_model_opportunities_schema = require("./opportunities.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/positions.schema.ts
 /**
@@ -73,6 +73,15 @@ const poolPositionSchema = zod_v4.z.object({
 	pnl: pnlBreakdownSchema.optional()
 });
 /**
+* {@link BorrowRateBreakdown}
+**/
+const borrowRateBreakdownSchema = zod_v4.z.object({
+	total: require_model_primitives_schema.bpsSchema,
+	totalOnDebt: require_model_primitives_schema.bpsSchema,
+	base: require_model_primitives_schema.bpsSchema,
+	quotas: zod_v4.z.record(require_sdk_utils_zod.ZodAddress(), require_model_primitives_schema.bpsSchema)
+});
+/**
 * {@link StrategyPosition}
 **/
 const strategyPositionSchema = zod_v4.z.object({
@@ -88,6 +97,9 @@ const strategyPositionSchema = zod_v4.z.object({
 	totalDebt: require_model_primitives_schema.tokenAmountSchema,
 	totalValue: require_model_primitives_schema.tokenAmountSchema,
 	healthFactor: require_model_primitives_schema.bpsSchema,
+	borrowRate: borrowRateBreakdownSchema.optional(),
+	timeToLiquidation: require_sdk_utils_zod.ZodBigInt().nullable().optional(),
+	liquidationPrice: require_sdk_utils_zod.ZodBigInt().nullable().optional(),
 	pnl: pnlBreakdownSchema.optional(),
 	collaterals: zod_v4.z.array(positionCollateralSchema)
 });
@@ -162,7 +174,38 @@ const positionKeySchema = zod_v4.z.discriminatedUnion("kind", [zod_v4.z.object({
 	kind: zod_v4.z.literal("strategy"),
 	...strategyPositionKeySchema.shape
 })]);
+/**
+* {@link PositionsTotals}
+**/
+const positionsTotalsSchema = zod_v4.z.object({
+	currentYield: require_model_opportunities_schema.apyBreakdownSchema.nullable(),
+	pnl: pnlBreakdownSchema.nullable(),
+	netValueUsd: zod_v4.z.number().nullable(),
+	claimableUsd: zod_v4.z.number().nullable()
+});
+/**
+* {@link PositionTransactionKind}
+**/
+const positionTransactionKindSchema = zod_v4.z.union([
+	zod_v4.z.literal("open"),
+	zod_v4.z.literal("deposit"),
+	zod_v4.z.literal("withdraw"),
+	zod_v4.z.literal("adjustLeverage"),
+	zod_v4.z.literal("addCollateral"),
+	zod_v4.z.literal("withdrawCollateral"),
+	zod_v4.z.literal("liquidation")
+]);
+/**
+* {@link PositionTransaction}
+**/
+const positionTransactionSchema = zod_v4.z.object({
+	txHash: require_sdk_utils_zod.ZodHex(),
+	timestamp: require_model_primitives_schema.timestampSchema,
+	kind: positionTransactionKindSchema,
+	assets: zod_v4.z.array(require_model_primitives_schema.tokenAmountSchema)
+});
 //#endregion
+exports.borrowRateBreakdownSchema = borrowRateBreakdownSchema;
 exports.pnlBreakdownSchema = pnlBreakdownSchema;
 exports.pointsProgramPnLSchema = pointsProgramPnLSchema;
 exports.pointsRewardsPnLSchema = pointsRewardsPnLSchema;
@@ -175,6 +218,9 @@ exports.positionFilterSchema = positionFilterSchema;
 exports.positionKeySchema = positionKeySchema;
 exports.positionKindSchema = positionKindSchema;
 exports.positionSchema = positionSchema;
+exports.positionTransactionKindSchema = positionTransactionKindSchema;
+exports.positionTransactionSchema = positionTransactionSchema;
+exports.positionsTotalsSchema = positionsTotalsSchema;
 exports.rewardsPnLSchema = rewardsPnLSchema;
 exports.strategyPositionKeySchema = strategyPositionKeySchema;
 exports.strategyPositionSchema = strategyPositionSchema;

package/dist/cjs/new-sdk/AbstractNamespace.js

@@ -18,23 +18,34 @@ var AbstractNamespace = class {
 	**/
 	maxOffchainLagSeconds;
 	logger;
+	/**
+	* The SDK's loading policy, awaited before every on-chain leg: attached, and
+	* the touched chains no older than the SDK allows.
+	**/
+	ensureFresh;
 	#name;
 	#onchain;
 	#offchain;
+	/** {@link onchain}, built once: the source's methods behind the loading policy. */
+	#onchainView;
 	constructor(name, onchain, offchain, options) {
 		this.#name = name;
 		this.#onchain = onchain;
 		this.#offchain = offchain;
 		this.maxOffchainLagSeconds = options.maxOffchainLagSeconds;
+		this.ensureFresh = options.ensureFresh;
 		this.logger = options.logger?.child?.({ name }) ?? options.logger;
+		this.#onchainView = onchain && options.ensureFresh ? behindLoadingPolicy(onchain, options.ensureFresh) : onchain;
 	}
 	/**
-	* The on-chain source namespace on its own. Throws
+	* The on-chain source namespace on its own — every read of it attaches and
+	* revalidates like a merged read does, so a consumer showing the two sources
+	* separately still gets the SDK's loading policy. Throws
 	* {@link SourceUnavailableError} in `offchain` mode.
 	**/
 	get onchain() {
-		if (!this.#onchain) throw new require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError(this.#name, "onchain");
-		return this.#onchain;
+		if (!this.#onchainView) throw new require_new_sdk_errors_SourceUnavailableError.SourceUnavailableError(this.#name, "onchain");
+		return this.#onchainView;
 	}
 	/**
 	* The backend source namespace on its own. Throws
@@ -51,7 +62,10 @@ var AbstractNamespace = class {
 	async merged(action, query) {
 		const onchain = this.#onchain;
 		const offchain = this.#offchain;
-		const [fromChain, fromBackend] = await Promise.all([this.#ask(action, "onchain", onchain, query.fromChain), this.#ask(action, "offchain", offchain, query.fromBackend)]);
+		const [fromChain, fromBackend] = await Promise.all([this.#ask(action, "onchain", onchain, async (source) => {
+			await this.ensureFresh?.(query.chainIds);
+			return query.fromChain(source);
+		}), this.#ask(action, "offchain", offchain, query.fromBackend)]);
 		const merged = query.merge(fromChain.response, fromBackend.response);
 		if (merged && !require_new_sdk_errors_everyChainFailed.everyChainFailed(merged.meta)) return merged;
 		const sole = onchain && offchain ? void 0 : fromChain.error ?? fromBackend.error;
@@ -72,5 +86,21 @@ var AbstractNamespace = class {
 		}
 	}
 };
+/**
+* The source's every method, awaiting the loading policy first. The policy is
+* asked for every chain — an escape hatch does not tell which chains a call
+* touches (the merged reads do, and scope it); the object identity differs
+* from the source's, its type does not.
+**/
+function behindLoadingPolicy(source, ensureFresh) {
+	return new Proxy(source, { get(target, property, receiver) {
+		const value = Reflect.get(target, property, receiver);
+		if (typeof value !== "function") return value;
+		return async (...args) => {
+			await ensureFresh();
+			return Reflect.apply(value, target, args);
+		};
+	} });
+}
 //#endregion
 exports.AbstractNamespace = AbstractNamespace;