@trainheroic-unofficial/cli 3.2.0 → 3.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/cli.mjs +360 -7
  2. package/package.json +4 -4
package/dist/cli.mjs CHANGED
@@ -32,7 +32,8 @@ z.looseObject({
32
32
  roles: z.array(z.string()).optional(),
33
33
  org_id: intLikeOrNull$1.optional()
34
34
  });
35
- z.looseObject({
35
+ /** `/v5/athleteProfile/summary` — lifetime training totals. Needs `use_metric` in the query. */
36
+ const athleteProfileSummarySchema = z.looseObject({
36
37
  reps_sum: z.number().optional(),
37
38
  volume_sum: z.number().optional(),
38
39
  sessions_count: z.number().optional(),
@@ -40,7 +41,8 @@ z.looseObject({
40
41
  last_logged_date: z.string().optional(),
41
42
  duration_hours: z.number().optional()
42
43
  });
43
- z.looseObject({
44
+ /** `/v5/users/{id}` — the detailed athlete profile (only the fields we surface). */
45
+ const athleteUserSchema = z.looseObject({
44
46
  id: intLike$1,
45
47
  email: z.string().optional(),
46
48
  name_first: z.string().optional(),
@@ -110,7 +112,8 @@ const liftPRSchema = z.looseObject({
110
112
  isMetric: z.boolean().optional(),
111
113
  description: z.string().optional()
112
114
  });
113
- z.looseObject({
115
+ /** `/v5/exercises/{id}/history` — the per-exercise PRs + session history. */
116
+ const exerciseHistoryDetailSchema = z.looseObject({
114
117
  liftPRs: z.array(liftPRSchema).optional(),
115
118
  singleParamPRs: z.array(z.unknown()).optional(),
116
119
  history: z.array(historyEntrySchema).optional()
@@ -147,7 +150,7 @@ const programWorkoutSchema = z.looseObject({
147
150
  team_title: z.string().optional(),
148
151
  summarizedSavedWorkout: z.unknown().optional()
149
152
  });
150
- z.array(programWorkoutSchema);
153
+ const programWorkoutListSchema = z.array(programWorkoutSchema);
151
154
  /** A `YYYY-MM-DD` date argument. The single definition reused across athlete tool inputs. */
152
155
  const dateString = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, "expected YYYY-MM-DD");
153
156
  z.object({
@@ -263,8 +266,161 @@ const athleteSessionRemoveArgsSchema = z.object({
263
266
  programWorkoutId: idArgSchema,
264
267
  date: dateString
265
268
  });
269
+ const presentedNullNumber = z.number().nullable();
270
+ const presentedNullString = z.string().nullable();
271
+ /** Flattened exercise within a presented workout: prescriptions, logged results, units. */
272
+ const athleteWorkoutExerciseSchema = z.object({
273
+ exerciseId: presentedNullNumber,
274
+ title: z.string(),
275
+ instruction: presentedNullString,
276
+ units: z.array(presentedNullString),
277
+ prescribed: z.array(z.string()),
278
+ performed: z.array(z.string())
279
+ });
280
+ const athleteWorkoutBlockSchema = z.object({
281
+ order: z.number(),
282
+ title: presentedNullString,
283
+ instruction: presentedNullString,
284
+ isTest: z.boolean(),
285
+ exercises: z.array(athleteWorkoutExerciseSchema)
286
+ });
287
+ const athleteWorkoutViewSchema = z.object({
288
+ id: presentedNullNumber,
289
+ date: z.string(),
290
+ title: z.string(),
291
+ program: presentedNullString,
292
+ team: presentedNullString,
293
+ instruction: presentedNullString,
294
+ logged: z.boolean(),
295
+ personal: z.boolean(),
296
+ blocks: z.array(athleteWorkoutBlockSchema)
297
+ });
298
+ const athleteWorkoutSummarySchema = z.object({
299
+ id: presentedNullNumber,
300
+ date: z.string(),
301
+ title: z.string(),
302
+ program: presentedNullString,
303
+ team: presentedNullString,
304
+ logged: z.boolean(),
305
+ personal: z.boolean(),
306
+ exerciseCount: z.number().int().nonnegative(),
307
+ performedCount: z.number().int().nonnegative()
308
+ });
309
+ z.union([
310
+ z.array(athleteWorkoutSummarySchema),
311
+ z.array(athleteWorkoutViewSchema),
312
+ programWorkoutListSchema
313
+ ]);
314
+ z.looseObject({
315
+ summary: athleteProfileSummarySchema,
316
+ user: athleteUserSchema
317
+ });
318
+ z.array(z.object({
319
+ id: z.union([z.number(), z.string()]),
320
+ title: z.string(),
321
+ isCircuit: z.boolean(),
322
+ units: z.array(presentedNullString)
323
+ }));
324
+ const coachAthleteExerciseSchema = z.object({
325
+ exerciseId: presentedNullNumber,
326
+ title: z.string(),
327
+ summary: presentedNullString,
328
+ completed: z.boolean()
329
+ });
330
+ const coachAthleteSessionSchema = z.object({
331
+ workoutId: presentedNullNumber,
332
+ savedWorkoutId: presentedNullNumber,
333
+ title: z.string(),
334
+ logged: z.boolean(),
335
+ completed: z.boolean(),
336
+ rpe: presentedNullNumber,
337
+ durationMin: presentedNullNumber,
338
+ notes: presentedNullString,
339
+ exercises: z.array(coachAthleteExerciseSchema)
340
+ });
341
+ z.object({
342
+ athleteId: presentedNullNumber,
343
+ athleteName: presentedNullString,
344
+ year: z.number().int(),
345
+ month: z.number().int(),
346
+ sessions: z.array(coachAthleteSessionSchema)
347
+ });
348
+ const rosterActivityRowSchema = z.object({
349
+ athleteId: z.number(),
350
+ sessionsCount: presentedNullNumber,
351
+ firstLoggedDate: presentedNullString,
352
+ lastLoggedDate: presentedNullString,
353
+ totalReps: presentedNullNumber,
354
+ totalVolume: presentedNullNumber
355
+ });
356
+ const teamVolumeAthleteSchema = z.object({
357
+ athleteId: z.number(),
358
+ name: presentedNullString,
359
+ sessions: z.number(),
360
+ reps: z.number(),
361
+ volume: z.number(),
362
+ firstLoggedDate: presentedNullString,
363
+ lastLoggedDate: presentedNullString
364
+ });
365
+ z.object({
366
+ window: z.object({
367
+ start: z.string(),
368
+ end: z.string()
369
+ }),
370
+ athletes: z.array(teamVolumeAthleteSchema),
371
+ totals: z.object({
372
+ athletes: z.number(),
373
+ sessions: z.number(),
374
+ reps: z.number(),
375
+ volume: z.number()
376
+ })
377
+ });
378
+ z.array(rosterActivityRowSchema);
379
+ const presentedExerciseSessionSchema = z.object({
380
+ date: z.string(),
381
+ abr: presentedNullString,
382
+ estimated1RM: presentedNullNumber,
383
+ sets: z.array(z.object({
384
+ setNumber: z.number(),
385
+ value: presentedNullString
386
+ }))
387
+ });
388
+ const presentedExerciseHistorySchema = z.object({
389
+ liftPRs: z.array(z.object({
390
+ description: presentedNullString,
391
+ reps: presentedNullNumber,
392
+ weight: presentedNullNumber,
393
+ units: presentedNullString,
394
+ date: presentedNullString
395
+ })),
396
+ sessions: z.array(presentedExerciseSessionSchema)
397
+ });
398
+ z.union([presentedExerciseHistorySchema, exerciseHistoryDetailSchema]);
266
399
  //#endregion
267
400
  //#region ../dto/src/exercise.ts
401
+ /**
402
+ * A row presented for display. The raw param-type codes are dropped and the fixed
403
+ * measurement units are surfaced positionally in `units`, ordered by entry slot
404
+ * (param 1, then param 2). Positional, not semantic: param 2 is not always the load
405
+ * — some exercises reverse the slots — so the units are not labelled by role.
406
+ */
407
+ const exerciseViewSchema = z.object({
408
+ id: z.number(),
409
+ title: z.string(),
410
+ can_edit: z.number(),
411
+ user_id: z.number().nullable(),
412
+ use_count: z.number(),
413
+ units: z.array(z.string().nullable())
414
+ });
415
+ z.looseObject({
416
+ id: idSchema,
417
+ title: z.string(),
418
+ units: z.array(z.string().nullable())
419
+ });
420
+ z.object({
421
+ match: exerciseViewSchema.nullable(),
422
+ candidates: z.array(exerciseViewSchema)
423
+ });
268
424
  /** Body for creating a custom exercise; extra fields the API accepts are preserved. */
269
425
  const exerciseCreateSchema = z.looseObject({
270
426
  title: z.string().min(1),
@@ -324,6 +480,197 @@ const teamPublishPatchSchema = z.object({
324
480
  pub_timezone: z.string().optional()
325
481
  }).refine((v) => v.pub_enabled !== void 0 || v.pub_days !== void 0 || v.pub_time !== void 0 || v.pub_timezone !== void 0, { message: "Provide at least one pub_* field" });
326
482
  //#endregion
483
+ //#region ../dto/src/tool-output.ts
484
+ const nullableNumber = z.number().nullable();
485
+ const nullableString = z.string().nullable();
486
+ const truncationMarkerSchema = z.looseObject({
487
+ field: z.string().optional(),
488
+ returned: z.number().int().nonnegative().optional(),
489
+ total: z.number().int().nonnegative(),
490
+ omitted: z.number().int().nonnegative(),
491
+ hint: z.string()
492
+ });
493
+ /** Dedicated budget-fallback envelope. Never the natural tool shape. */
494
+ const truncatedOutputSchema = z.looseObject({
495
+ preview: z.string().optional(),
496
+ items: z.array(z.json()).optional(),
497
+ __truncated: truncationMarkerSchema
498
+ });
499
+ /**
500
+ * Add the shared size-budget fallback to a tool's natural result shape.
501
+ * Truncation is a dedicated `{ items|preview, __truncated }` envelope, so it cannot
502
+ * validate as the natural object and drop the marker.
503
+ */
504
+ function toolOutputSchema(schema) {
505
+ return z.union([truncatedOutputSchema, schema]);
506
+ }
507
+ toolOutputSchema(z.json());
508
+ const logSetTargetOutputSchema = z.object({
509
+ date: z.string(),
510
+ workoutTitle: z.string(),
511
+ program: nullableString,
512
+ programId: nullableNumber,
513
+ team: nullableString,
514
+ teamId: nullableNumber,
515
+ savedWorkoutSetId: z.number(),
516
+ setTitle: nullableString,
517
+ exercises: z.array(z.object({
518
+ savedWorkoutSetExerciseId: z.number(),
519
+ title: z.string(),
520
+ units: z.array(nullableString),
521
+ prescribed: z.array(z.string()),
522
+ performed: z.array(z.string())
523
+ }))
524
+ });
525
+ z.union([z.array(logSetTargetOutputSchema), programWorkoutListSchema]);
526
+ z.object({
527
+ draft: z.literal(true),
528
+ note: z.string(),
529
+ would_POST: z.string(),
530
+ payload: z.json()
531
+ });
532
+ z.looseObject({
533
+ status: z.enum(["sent", "logged"]),
534
+ reference: z.string().optional(),
535
+ note: z.string()
536
+ });
537
+ z.looseObject({ removed: z.union([z.boolean(), z.number()]) });
538
+ z.object({
539
+ removed: z.literal(true),
540
+ programWorkoutId: z.number(),
541
+ date: z.string()
542
+ });
543
+ z.object({
544
+ invited: z.literal(true),
545
+ teamId: z.number(),
546
+ result: z.json().optional()
547
+ });
548
+ z.object({
549
+ savedWorkoutSetId: z.number(),
550
+ exercisesLogged: z.number().int().nonnegative(),
551
+ setCompleted: z.boolean()
552
+ });
553
+ z.object({
554
+ savedWorkoutSetId: z.number(),
555
+ exercisesPrescribed: z.number().int().nonnegative()
556
+ });
557
+ z.object({
558
+ savedWorkoutSetExerciseId: z.number(),
559
+ athleteId: nullableNumber,
560
+ newExerciseId: z.number(),
561
+ newExerciseTitle: nullableString,
562
+ originalTeamExerciseId: nullableNumber
563
+ });
564
+ const sessionLogSetOutputSchema = z.object({
565
+ savedWorkoutSetId: z.number(),
566
+ exercisesLogged: z.number().int().nonnegative()
567
+ });
568
+ z.object({
569
+ date: z.string(),
570
+ created: z.boolean(),
571
+ sets: z.array(sessionLogSetOutputSchema),
572
+ scheduledAlternatives: z.array(z.object({
573
+ exerciseId: z.number(),
574
+ title: z.string(),
575
+ program: nullableString,
576
+ workoutTitle: z.string(),
577
+ savedWorkoutSetId: z.number(),
578
+ savedWorkoutSetExerciseId: z.number()
579
+ })).optional()
580
+ });
581
+ z.object({
582
+ programWorkoutId: z.number(),
583
+ workoutId: z.number(),
584
+ savedWorkoutId: z.number(),
585
+ groupId: z.number(),
586
+ date: z.string()
587
+ });
588
+ const workoutReadExerciseOutputSchema = z.object({
589
+ order: z.number(),
590
+ title: z.string(),
591
+ reps: z.array(z.string()),
592
+ primaryUnit: nullableString,
593
+ load: z.array(z.string()),
594
+ loadUnit: nullableString,
595
+ instruction: z.string()
596
+ });
597
+ const workoutReadBlockOutputSchema = z.object({
598
+ order: z.number(),
599
+ title: z.string(),
600
+ instruction: z.string(),
601
+ leaderboard: nullableString,
602
+ exercises: z.array(workoutReadExerciseOutputSchema)
603
+ });
604
+ const workoutReadOutputSchema = z.object({
605
+ pwId: z.number(),
606
+ date: z.string(),
607
+ published: z.json().optional(),
608
+ instruction: z.string(),
609
+ blocks: z.array(workoutReadBlockOutputSchema)
610
+ });
611
+ z.object({
612
+ pwId: z.number(),
613
+ workoutId: z.number(),
614
+ programId: z.number(),
615
+ published: z.literal(false),
616
+ advisories: z.object({
617
+ notes: z.array(z.string()),
618
+ warnings: z.array(z.string())
619
+ }),
620
+ readback: workoutReadOutputSchema.nullable(),
621
+ note: z.string()
622
+ });
623
+ z.object({
624
+ published: z.number(),
625
+ readback: workoutReadOutputSchema,
626
+ note: z.string()
627
+ });
628
+ z.object({
629
+ sent: z.literal(true),
630
+ comment: z.json()
631
+ });
632
+ z.object({
633
+ deleted: z.literal(true),
634
+ response: z.json().optional()
635
+ });
636
+ z.object({ deleted: z.number() });
637
+ z.object({ forgotten: z.number() });
638
+ z.looseObject({ id: z.union([z.number(), z.string()]) });
639
+ const mainLiftPrOutputSchema = z.object({
640
+ family: z.enum([
641
+ "cleanjerk",
642
+ "snatch",
643
+ "deadlift",
644
+ "squat",
645
+ "bench",
646
+ "overhead"
647
+ ]),
648
+ label: z.string(),
649
+ exerciseId: nullableNumber,
650
+ title: nullableString,
651
+ weight: nullableNumber,
652
+ reps: nullableNumber,
653
+ units: nullableString,
654
+ date: nullableString
655
+ });
656
+ z.object({
657
+ athleteId: z.number(),
658
+ athleteName: nullableString,
659
+ prs: z.array(mainLiftPrOutputSchema)
660
+ });
661
+ z.object({
662
+ containerId: z.number(),
663
+ programId: z.number(),
664
+ title: z.string(),
665
+ kind: z.enum(["calendar", "fixed"]),
666
+ requestedName: z.string(),
667
+ nameApplied: z.boolean()
668
+ });
669
+ z.object({
670
+ programId: z.number(),
671
+ containerId: nullableNumber
672
+ });
673
+ //#endregion
327
674
  //#region ../dto/src/workout.ts
328
675
  /** A single exercise prescription inside a block. */
329
676
  const exerciseSpecSchema = z.object({
@@ -3592,6 +3939,10 @@ var JsonFileLibraryCache = class {
3592
3939
  function looksLikeJson(s) {
3593
3940
  return /^\s*[[{]/u.test(s);
3594
3941
  }
3942
+ /** Fail closed before changing the live calendar assigned to a team. */
3943
+ function requireTeamCalendarReassignmentConfirmation(teamId, groupProgram, confirmed) {
3944
+ if (groupProgram !== void 0 && !confirmed) throw new Error(`reassigning team ${teamId}'s calendar changes live athlete programming; add --yes.`);
3945
+ }
3595
3946
  //#endregion
3596
3947
  //#region src/session-cache.ts
3597
3948
  const TTL_MS = 216e5;
@@ -3679,7 +4030,7 @@ Coach — manage a roster (needs a coach account):
3679
4030
  coach program-create --kind calendar|fixed --name "..."
3680
4031
  coach program-delete --program <id> --yes
3681
4032
  coach team-create --title "..."
3682
- coach team-update --team <id> [--title "..."] [--group-program <id>]
4033
+ coach team-update --team <id> [--title "..."] [--group-program <id> --yes]
3683
4034
  coach team-publish-settings (--team <id> | --program <id>) [--pub-enabled 0|1] --yes
3684
4035
  coach team-delete --team <id> --yes
3685
4036
  coach team-code-create --team <id> [--type N]
@@ -4575,16 +4926,18 @@ async function cmdCoachProgramDelete(client, a) {
4575
4926
  return out(await deleteProgram(client, programId));
4576
4927
  }
4577
4928
  async function cmdCoachTeamUpdate(client, a) {
4578
- const usage = "coach team-update --team <id> [--title \"...\"] [--group-program <id>] (at least one of --title / --group-program)";
4929
+ const usage = "coach team-update --team <id> [--title \"...\"] [--group-program <id> --yes] (at least one of --title / --group-program)";
4579
4930
  const { values } = parse(a, {
4580
4931
  team: { type: "string" },
4581
4932
  title: { type: "string" },
4582
- "group-program": { type: "string" }
4933
+ "group-program": { type: "string" },
4934
+ yes: { type: "boolean" }
4583
4935
  });
4584
4936
  const teamId = toInt(need(values.team, usage), "--team");
4585
4937
  const title = values.title;
4586
4938
  const groupProgramRaw = values["group-program"];
4587
4939
  if (title === void 0 && groupProgramRaw === void 0) fail(usage);
4940
+ requireTeamCalendarReassignmentConfirmation(teamId, groupProgramRaw, values.yes === true);
4588
4941
  const args = { teamId };
4589
4942
  if (title !== void 0) args.title = title;
4590
4943
  if (groupProgramRaw !== void 0) args.groupProgram = toInt(groupProgramRaw, "--group-program");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trainheroic-unofficial/cli",
3
- "version": "3.2.0",
3
+ "version": "3.3.1",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -21,13 +21,13 @@
21
21
  ],
22
22
  "dependencies": {
23
23
  "zod": "^4.4.3",
24
- "@trainheroic-unofficial/dto": "3.2.0",
25
- "@trainheroic-unofficial/js": "3.2.0"
24
+ "@trainheroic-unofficial/dto": "3.3.1",
25
+ "@trainheroic-unofficial/js": "3.3.1"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@types/node": "^26.2.0",
29
29
  "tsdown": "^0.22.14",
30
- "tsx": "^4.23.11",
30
+ "tsx": "^4.23.12",
31
31
  "typescript": "^7.0.2",
32
32
  "vitest": "^4.1.10"
33
33
  },