@trainheroic-unofficial/js 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -69,8 +69,19 @@ declare const PARAM_RPE = 14;
 declare function coerceInt(value: unknown): number | null;
 declare function coerceNum(value: unknown): number | null;
 declare function unitLabel(paramType: unknown): string | null;
-/** Annotate a row with human-readable units for display. */
+/**
+ * Fixed measurement units for an exercise, ordered by entry slot (param 1, then param 2).
+ * Positional, not semantic: some exercises reverse the slots, so the array is not labelled
+ * by role. A null entry is an unset slot.
+ */
+declare function exerciseUnits(param1: unknown, param2: unknown): Array<string | null>;
+/** Present a row for display: drop the raw param-type codes, surface units positionally. */
 declare function withUnits(row: ExerciseRow): ExerciseView;
+/**
+ * Present a full raw exercise object for display: drop the raw param-type codes and add the
+ * positional `units` array. Keeps every other field of the raw object intact.
+ */
+declare function presentExercise(raw: Record<string, unknown>): Record<string, unknown>;
 declare function buildSearchText(title: string): string;
 /** Strip the {"success":1,"data":X} envelope some 2.0/coach endpoints use. */
 declare function unwrapEnvelope(body: unknown): unknown;
@@ -195,4 +206,4 @@ declare class ExerciseLibrary implements ExerciseIndex {
   stats(): Promise<Record<string, unknown>>;
 }
 //#endregion
-export { ApiBase, BuildOptions, ClientResult, ExerciseIndex, ExerciseLibrary, LEADERBOARD_LABEL, LEADERBOARD_TYPE, Leaderboard, LibraryCache, LibrarySnapshot, MemoryLibraryCache, PARAM_NONE, PARAM_PCT_MAX, PARAM_REPS, PARAM_RPE, PARAM_UNIT, PARAM_WEIGHT, RequestOptions, TrainHeroicAuthError, TrainHeroicClient, TrainHeroicSession, asExerciseList, buildBlockPayload, buildCommentPayload, buildSearchText, buildSession, checkResponse, chunk, coerceInt, coerceNum, collectAdvisories, deleteComment, fetchStreams, isRecord, loginTrainHeroic, makeExercise, publishSession, rankSearch, readLive, readSession, removeSession, repsList, resolveLeaderboard, sendComment, setSessionInstruction, unitAdvisory, unitLabel, unwrapEnvelope, withUnits };
+export { ApiBase, BuildOptions, ClientResult, ExerciseIndex, ExerciseLibrary, LEADERBOARD_LABEL, LEADERBOARD_TYPE, Leaderboard, LibraryCache, LibrarySnapshot, MemoryLibraryCache, PARAM_NONE, PARAM_PCT_MAX, PARAM_REPS, PARAM_RPE, PARAM_UNIT, PARAM_WEIGHT, RequestOptions, TrainHeroicAuthError, TrainHeroicClient, TrainHeroicSession, asExerciseList, buildBlockPayload, buildCommentPayload, buildSearchText, buildSession, checkResponse, chunk, coerceInt, coerceNum, collectAdvisories, deleteComment, exerciseUnits, fetchStreams, isRecord, loginTrainHeroic, makeExercise, presentExercise, publishSession, rankSearch, readLive, readSession, removeSession, repsList, resolveLeaderboard, sendComment, setSessionInstruction, unitAdvisory, unitLabel, unwrapEnvelope, withUnits };

package/dist/index.mjs

@@ -175,12 +175,31 @@ function unitLabel(paramType) {
 	if (t === null) return null;
 	return PARAM_UNIT[t] ?? null;
 }
-/** Annotate a row with human-readable units for display. */
+/**
+* Fixed measurement units for an exercise, ordered by entry slot (param 1, then param 2).
+* Positional, not semantic: some exercises reverse the slots, so the array is not labelled
+* by role. A null entry is an unset slot.
+*/
+function exerciseUnits(param1, param2) {
+	return [unitLabel(param1), unitLabel(param2)];
+}
+/** Present a row for display: drop the raw param-type codes, surface units positionally. */
 function withUnits(row) {
+	const { param_1_type, param_2_type, ...rest } = row;
+	return {
+		...rest,
+		units: exerciseUnits(param_1_type, param_2_type)
+	};
+}
+/**
+* Present a full raw exercise object for display: drop the raw param-type codes and add the
+* positional `units` array. Keeps every other field of the raw object intact.
+*/
+function presentExercise(raw) {
+	const { param_1_type, param_2_type, ...rest } = raw;
 	return {
-		...row,
-		param_1_unit: unitLabel(row.param_1_type),
-		param_2_unit: unitLabel(row.param_2_type)
+		...rest,
+		units: exerciseUnits(param_1_type, param_2_type)
 	};
 }
 function buildSearchText(title) {
@@ -741,10 +760,7 @@ var ExerciseLibrary = class {
 		await this.ensureFresh();
 		const s = this.#byId.get(id);
 		if (!s) return null;
-		const full = { ...s.raw };
-		full.param_1_unit = unitLabel(full.param_1_type);
-		full.param_2_unit = unitLabel(full.param_2_type);
-		return full;
+		return presentExercise(s.raw);
 	}
 	async defaults(id) {
 		const s = this.#byId.get(id);
@@ -824,4 +840,4 @@ var ExerciseLibrary = class {
 	}
 };
 //#endregion
-export { ExerciseLibrary, LEADERBOARD_LABEL, LEADERBOARD_TYPE, MemoryLibraryCache, PARAM_NONE, PARAM_PCT_MAX, PARAM_REPS, PARAM_RPE, PARAM_UNIT, PARAM_WEIGHT, TrainHeroicAuthError, TrainHeroicClient, asExerciseList, buildBlockPayload, buildCommentPayload, buildSearchText, buildSession, checkResponse, chunk, coerceInt, coerceNum, collectAdvisories, deleteComment, fetchStreams, isRecord, loginTrainHeroic, makeExercise, publishSession, rankSearch, readLive, readSession, removeSession, repsList, resolveLeaderboard, sendComment, setSessionInstruction, unitAdvisory, unitLabel, unwrapEnvelope, withUnits };
+export { ExerciseLibrary, LEADERBOARD_LABEL, LEADERBOARD_TYPE, MemoryLibraryCache, PARAM_NONE, PARAM_PCT_MAX, PARAM_REPS, PARAM_RPE, PARAM_UNIT, PARAM_WEIGHT, TrainHeroicAuthError, TrainHeroicClient, asExerciseList, buildBlockPayload, buildCommentPayload, buildSearchText, buildSession, checkResponse, chunk, coerceInt, coerceNum, collectAdvisories, deleteComment, exerciseUnits, fetchStreams, isRecord, loginTrainHeroic, makeExercise, presentExercise, publishSession, rankSearch, readLive, readSession, removeSession, repsList, resolveLeaderboard, sendComment, setSessionInstruction, unitAdvisory, unitLabel, unwrapEnvelope, withUnits };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trainheroic-unofficial/js",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "zod": "^4.4.3",
-    "@trainheroic-unofficial/dto": "0.2.0"
+    "@trainheroic-unofficial/dto": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",