@aneuhold/core-ts-db-lib 4.0.4 → 4.1.0

package/lib/documents/workout/WorkoutEquipmentType.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { RequiredUserIdSchema } from '../../schemas/required-refs/RequiredUserId.js';
+import {
+  BaseDocumentWithTypeSchema,
+  BaseDocumentWithUpdatedAndCreatedDatesSchema
+} from '../BaseDocument.js';
+
+/**
+ * The docType value for WorkoutEquipmentType documents.
+ */
+export const WorkoutEquipmentType_docType = 'workoutEquipmentType';
+
+/**
+ * The schema for {@link WorkoutEquipmentType} documents.
+ */
+export const WorkoutEquipmentTypeSchema = z.object({
+  ...BaseDocumentWithTypeSchema.shape,
+  ...RequiredUserIdSchema.shape,
+  ...BaseDocumentWithUpdatedAndCreatedDatesSchema.shape,
+  docType: z.literal(WorkoutEquipmentType_docType).default(WorkoutEquipmentType_docType),
+  /**
+   * The title of the equipment type.
+   */
+  title: z.string(),
+  /**
+   * The available weight options for this equipment type.
+   *
+   * This is used to assist in algorithms where weight needs to be incremented
+   * or decremented for a schedule. For fixed weights like dumbbells, this would
+   * be a list of available weights. For adjustable equipment like barbells,
+   * this can be calculated based on minimum weight (e.g., the bar) and possible
+   * increments.
+   */
+  weightOptions: z.array(z.number().nonnegative()).nullish()
+});
+
+/**
+ * Represents a type of workout equipment with its available weight options.
+ */
+export type WorkoutEquipmentType = z.infer<typeof WorkoutEquipmentTypeSchema>;

package/lib/documents/workout/WorkoutExercise.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+/**
+ * The different types of exercise properties.
+ */
+export declare enum ExercisePropertyType {
+    Weight = "Weight",
+    Text = "Text",
+    YesNo = "Yes/No",
+    Number = "Number"
+}
+/**
+ * Zod schema for {@link ExerciseProperty}.
+ */
+export declare const ExercisePropertySchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<typeof ExercisePropertyType>;
+}, z.core.$strip>;
+/**
+ * Represents a custom property for an exercise.
+ */
+export type ExerciseProperty = z.infer<typeof ExercisePropertySchema>;
+/**
+ * The rep range for an exercise.
+ *
+ * - Heavy exercises: Normally done in the 5-15 rep range
+ * - Medium exercises: Normally done in the 10-20 rep range (This should be the most common)
+ * - Light exercises: Normally done in the 15-30 rep range
+ */
+export declare enum ExerciseRepRange {
+    Heavy = "Heavy",
+    Medium = "Medium",
+    Light = "Light"
+}
+/**
+ * The preferred progression type for an exercise.
+ *
+ * - Rep: Add 2 reps per week (default). When max reps exceeded, increase weight by smallest increment.
+ * - Load: Add smallest available increment each week (or 2% of current load, whichever is greater).
+ */
+export declare enum ExerciseProgressionType {
+    Rep = "Rep",
+    Load = "Load"
+}
+/**
+ * The docType value for WorkoutExercise documents.
+ */
+export declare const WorkoutExercise_docType = "workoutExercise";
+/**
+ * The schema for {@link WorkoutExercise} documents.
+ */
+export declare const WorkoutExerciseSchema: z.ZodObject<{
+    docType: z.ZodDefault<z.ZodLiteral<"workoutExercise">>;
+    exerciseName: z.ZodString;
+    workoutEquipmentTypeId: z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    restSeconds: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    customProperties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<typeof ExercisePropertyType>;
+    }, z.core.$strip>>>>;
+    repRange: z.ZodEnum<typeof ExerciseRepRange>;
+    preferredProgressionType: z.ZodDefault<z.ZodEnum<typeof ExerciseProgressionType>>;
+    primaryMuscleGroups: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>>>;
+    secondaryMuscleGroups: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>>>;
+    initialFatigueGuess: z.ZodObject<{
+        jointAndTissueDisruption: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        perceivedEffort: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        unusedMusclePerformance: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    }, z.core.$strip>;
+    createdDate: z.ZodDefault<z.ZodDate>;
+    lastUpdatedDate: z.ZodDefault<z.ZodDate>;
+    _id: z.ZodPipe<z.ZodDefault<z.ZodUUID>, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+    userId: z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+}, z.core.$strip>;
+/**
+ * Represents a specific variation of an exercise with all its details.
+ *
+ * This is intentionally very specific - each variation (different grip, tempo,
+ * equipment position, etc.) should be its own exercise for accurate tracking.
+ */
+export type WorkoutExercise = z.infer<typeof WorkoutExerciseSchema>;
+//# sourceMappingURL=WorkoutExercise.d.ts.map

package/lib/documents/workout/WorkoutExercise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutExercise.d.ts","sourceRoot":"","sources":["../../../src/documents/workout/WorkoutExercise.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,WAAW;IAChB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;iBASjC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED;;;;;GAKG;AACH,oBAAY,uBAAuB;IACjC,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAgEhC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/lib/documents/workout/WorkoutExercise.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { FatigueSchema } from '../../embedded-types/workout/Fatigue.js';
+import { RequiredUserIdSchema } from '../../schemas/required-refs/RequiredUserId.js';
+import { BaseDocumentWithTypeSchema, BaseDocumentWithUpdatedAndCreatedDatesSchema } from '../BaseDocument.js';
+/**
+ * The different types of exercise properties.
+ */
+export var ExercisePropertyType;
+(function (ExercisePropertyType) {
+    ExercisePropertyType["Weight"] = "Weight";
+    ExercisePropertyType["Text"] = "Text";
+    ExercisePropertyType["YesNo"] = "Yes/No";
+    ExercisePropertyType["Number"] = "Number";
+})(ExercisePropertyType || (ExercisePropertyType = {}));
+/**
+ * Zod schema for {@link ExerciseProperty}.
+ */
+export const ExercisePropertySchema = z.object({
+    /**
+     * The name of the custom property.
+     */
+    name: z.string(),
+    /**
+     * The type of the custom property. See {@link ExercisePropertyType} for details.
+     */
+    type: z.enum(ExercisePropertyType)
+});
+/**
+ * The rep range for an exercise.
+ *
+ * - Heavy exercises: Normally done in the 5-15 rep range
+ * - Medium exercises: Normally done in the 10-20 rep range (This should be the most common)
+ * - Light exercises: Normally done in the 15-30 rep range
+ */
+export var ExerciseRepRange;
+(function (ExerciseRepRange) {
+    ExerciseRepRange["Heavy"] = "Heavy";
+    ExerciseRepRange["Medium"] = "Medium";
+    ExerciseRepRange["Light"] = "Light";
+})(ExerciseRepRange || (ExerciseRepRange = {}));
+/**
+ * The preferred progression type for an exercise.
+ *
+ * - Rep: Add 2 reps per week (default). When max reps exceeded, increase weight by smallest increment.
+ * - Load: Add smallest available increment each week (or 2% of current load, whichever is greater).
+ */
+export var ExerciseProgressionType;
+(function (ExerciseProgressionType) {
+    ExerciseProgressionType["Rep"] = "Rep";
+    ExerciseProgressionType["Load"] = "Load";
+})(ExerciseProgressionType || (ExerciseProgressionType = {}));
+/**
+ * The docType value for WorkoutExercise documents.
+ */
+export const WorkoutExercise_docType = 'workoutExercise';
+/**
+ * The schema for {@link WorkoutExercise} documents.
+ */
+export const WorkoutExerciseSchema = z.object({
+    ...BaseDocumentWithTypeSchema.shape,
+    ...RequiredUserIdSchema.shape,
+    ...BaseDocumentWithUpdatedAndCreatedDatesSchema.shape,
+    docType: z.literal(WorkoutExercise_docType).default(WorkoutExercise_docType),
+    /**
+     * The name of the exercise.
+     *
+     * WorkoutExercise is meant to be specific to a particular way of doing an
+     * exercise. For example there should be separate exercises for:
+     * - Barbell Bench Press (Straight Sets)
+     * - Barbell Bench Press (Myoreps)
+     * - Dumbbell Bench Press (Straight Sets, Eccentric Focus, 3s Down, 1s Pause)
+     *
+     * It needs to be ultra specific, because even a different hand position will
+     * result in a different exercise and should be tracked separately.
+     */
+    exerciseName: z.string(),
+    /**
+     * The ID of the equipment type used for this exercise.
+     */
+    workoutEquipmentTypeId: z.uuidv7().transform((val) => val),
+    /**
+     * Optional notes about the exercise.
+     */
+    notes: z.string().nullish(),
+    /**
+     * The recommended rest time in seconds between sets.
+     *
+     * This is used for a timer that will be built into the app for each exercise.
+     * No tracking will be done of the timer, it will be purely client-side.
+     */
+    restSeconds: z.int().positive().nullish(),
+    /**
+     * Custom properties for this exercise.
+     *
+     * When customProperties are changed, they should be propagated to all
+     * existing WorkoutSet documents with this WorkoutExercise linked to it.
+     */
+    customProperties: z.array(ExercisePropertySchema).nullish(),
+    /**
+     * The recommended rep range for this exercise. See {@link ExerciseRepRange} for details.
+     */
+    repRange: z.enum(ExerciseRepRange),
+    /**
+     * The preferred progression type for this exercise.
+     *
+     * Defaults to Rep progression if not specified.
+     */
+    preferredProgressionType: z.enum(ExerciseProgressionType).default(ExerciseProgressionType.Rep),
+    /**
+     * The IDs of the primary muscle groups targeted by this exercise.
+     */
+    primaryMuscleGroups: z.array(z.uuidv7().transform((val) => val)).default([]),
+    /**
+     * The IDs of the secondary muscle groups targeted by this exercise.
+     */
+    secondaryMuscleGroups: z.array(z.uuidv7().transform((val) => val)).default([]),
+    /**
+     * An initial guess of the fatigue this exercise produces.
+     *
+     * This is needed for scheduling algorithms when empirical data isn't yet available.
+     */
+    initialFatigueGuess: FatigueSchema
+});
+//# sourceMappingURL=WorkoutExercise.js.map

package/lib/documents/workout/WorkoutExercise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutExercise.js","sourceRoot":"","sources":["../../../src/documents/workout/WorkoutExercise.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EACL,0BAA0B,EAC1B,4CAA4C,EAC7C,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,qCAAa,CAAA;IACb,wCAAgB,CAAA;IAChB,yCAAiB,CAAA;AACnB,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;CACnC,CAAC,CAAC;AAOH;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,mCAAe,CAAA;IACf,qCAAiB,CAAA;IACjB,mCAAe,CAAA;AACjB,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IACjC,sCAAW,CAAA;IACX,wCAAa,CAAA;AACf,CAAC,EAHW,uBAAuB,KAAvB,uBAAuB,QAGlC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,0BAA0B,CAAC,KAAK;IACnC,GAAG,oBAAoB,CAAC,KAAK;IAC7B,GAAG,4CAA4C,CAAC,KAAK;IACrD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IAC5E;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB;;OAEG;IACH,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAW,CAAC;IAClE;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3B;;;;;OAKG;IACH,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE;IACzC;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,OAAO,EAAE;IAC3D;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAClC;;;;OAIG;IACH,wBAAwB,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC;IAC9F;;OAEG;IACH,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpF;;OAEG;IACH,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtF;;;;OAIG;IACH,mBAAmB,EAAE,aAAa;CACnC,CAAC,CAAC"}

package/lib/documents/workout/WorkoutExercise.ts

@@ -0,0 +1,143 @@
+import type { UUID } from 'crypto';
+import { z } from 'zod';
+import { FatigueSchema } from '../../embedded-types/workout/Fatigue.js';
+import { RequiredUserIdSchema } from '../../schemas/required-refs/RequiredUserId.js';
+import {
+  BaseDocumentWithTypeSchema,
+  BaseDocumentWithUpdatedAndCreatedDatesSchema
+} from '../BaseDocument.js';
+
+/**
+ * The different types of exercise properties.
+ */
+export enum ExercisePropertyType {
+  Weight = 'Weight',
+  Text = 'Text',
+  YesNo = 'Yes/No',
+  Number = 'Number'
+}
+
+/**
+ * Zod schema for {@link ExerciseProperty}.
+ */
+export const ExercisePropertySchema = z.object({
+  /**
+   * The name of the custom property.
+   */
+  name: z.string(),
+  /**
+   * The type of the custom property. See {@link ExercisePropertyType} for details.
+   */
+  type: z.enum(ExercisePropertyType)
+});
+
+/**
+ * Represents a custom property for an exercise.
+ */
+export type ExerciseProperty = z.infer<typeof ExercisePropertySchema>;
+
+/**
+ * The rep range for an exercise.
+ *
+ * - Heavy exercises: Normally done in the 5-15 rep range
+ * - Medium exercises: Normally done in the 10-20 rep range (This should be the most common)
+ * - Light exercises: Normally done in the 15-30 rep range
+ */
+export enum ExerciseRepRange {
+  Heavy = 'Heavy',
+  Medium = 'Medium',
+  Light = 'Light'
+}
+
+/**
+ * The preferred progression type for an exercise.
+ *
+ * - Rep: Add 2 reps per week (default). When max reps exceeded, increase weight by smallest increment.
+ * - Load: Add smallest available increment each week (or 2% of current load, whichever is greater).
+ */
+export enum ExerciseProgressionType {
+  Rep = 'Rep',
+  Load = 'Load'
+}
+
+/**
+ * The docType value for WorkoutExercise documents.
+ */
+export const WorkoutExercise_docType = 'workoutExercise';
+
+/**
+ * The schema for {@link WorkoutExercise} documents.
+ */
+export const WorkoutExerciseSchema = z.object({
+  ...BaseDocumentWithTypeSchema.shape,
+  ...RequiredUserIdSchema.shape,
+  ...BaseDocumentWithUpdatedAndCreatedDatesSchema.shape,
+  docType: z.literal(WorkoutExercise_docType).default(WorkoutExercise_docType),
+  /**
+   * The name of the exercise.
+   *
+   * WorkoutExercise is meant to be specific to a particular way of doing an
+   * exercise. For example there should be separate exercises for:
+   * - Barbell Bench Press (Straight Sets)
+   * - Barbell Bench Press (Myoreps)
+   * - Dumbbell Bench Press (Straight Sets, Eccentric Focus, 3s Down, 1s Pause)
+   *
+   * It needs to be ultra specific, because even a different hand position will
+   * result in a different exercise and should be tracked separately.
+   */
+  exerciseName: z.string(),
+  /**
+   * The ID of the equipment type used for this exercise.
+   */
+  workoutEquipmentTypeId: z.uuidv7().transform((val) => val as UUID),
+  /**
+   * Optional notes about the exercise.
+   */
+  notes: z.string().nullish(),
+  /**
+   * The recommended rest time in seconds between sets.
+   *
+   * This is used for a timer that will be built into the app for each exercise.
+   * No tracking will be done of the timer, it will be purely client-side.
+   */
+  restSeconds: z.int().positive().nullish(),
+  /**
+   * Custom properties for this exercise.
+   *
+   * When customProperties are changed, they should be propagated to all
+   * existing WorkoutSet documents with this WorkoutExercise linked to it.
+   */
+  customProperties: z.array(ExercisePropertySchema).nullish(),
+  /**
+   * The recommended rep range for this exercise. See {@link ExerciseRepRange} for details.
+   */
+  repRange: z.enum(ExerciseRepRange),
+  /**
+   * The preferred progression type for this exercise.
+   *
+   * Defaults to Rep progression if not specified.
+   */
+  preferredProgressionType: z.enum(ExerciseProgressionType).default(ExerciseProgressionType.Rep),
+  /**
+   * The IDs of the primary muscle groups targeted by this exercise.
+   */
+  primaryMuscleGroups: z.array(z.uuidv7().transform((val) => val as UUID)).default([]),
+  /**
+   * The IDs of the secondary muscle groups targeted by this exercise.
+   */
+  secondaryMuscleGroups: z.array(z.uuidv7().transform((val) => val as UUID)).default([]),
+  /**
+   * An initial guess of the fatigue this exercise produces.
+   *
+   * This is needed for scheduling algorithms when empirical data isn't yet available.
+   */
+  initialFatigueGuess: FatigueSchema
+});
+
+/**
+ * Represents a specific variation of an exercise with all its details.
+ *
+ * This is intentionally very specific - each variation (different grip, tempo,
+ * equipment position, etc.) should be its own exercise for accurate tracking.
+ */
+export type WorkoutExercise = z.infer<typeof WorkoutExerciseSchema>;

package/lib/documents/workout/WorkoutExerciseCalibration.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { WorkoutExercise } from './WorkoutExercise.js';
+/**
+ * The docType value for WorkoutExerciseCalibration documents.
+ */
+export declare const WorkoutExerciseCalibration_docType = "workoutExerciseCalibration";
+/**
+ * The schema for {@link WorkoutExerciseCalibration} documents.
+ */
+export declare const WorkoutExerciseCalibrationSchema: z.ZodObject<{
+    docType: z.ZodDefault<z.ZodLiteral<"workoutExerciseCalibration">>;
+    workoutExerciseId: z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+    exerciseProperties: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    reps: z.ZodInt;
+    weight: z.ZodNumber;
+    dateRecorded: z.ZodDefault<z.ZodDate>;
+    createdDate: z.ZodDefault<z.ZodDate>;
+    lastUpdatedDate: z.ZodDefault<z.ZodDate>;
+    _id: z.ZodPipe<z.ZodDefault<z.ZodUUID>, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+    userId: z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+}, z.core.$strip>;
+/**
+ * Represents a calibration point for an exercise, used to calculate 1RM and
+ * track strength progression.
+ *
+ * These documents store the lowest amount of reps the person can do for an
+ * exercise with the highest amount of weight they can handle. This is used
+ * for 1RM calculations using the NASM formula:
+ * 1RM = (Weight Lifted x Reps / 30.48) + Weight Lifted
+ *
+ * WorkoutMesocycle documents reference these to lock in which calibration was
+ * used, ensuring historical 1RM values remain accurate even if calibrations
+ * are updated later.
+ */
+export type WorkoutExerciseCalibration = z.infer<typeof WorkoutExerciseCalibrationSchema>;
+/**
+ * Represents a calibration paired with its associated exercise definition.
+ */
+export type CalibrationExercisePair = {
+    calibration: WorkoutExerciseCalibration;
+    exercise: WorkoutExercise;
+};
+//# sourceMappingURL=WorkoutExerciseCalibration.d.ts.map

package/lib/documents/workout/WorkoutExerciseCalibration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutExerciseCalibration.d.ts","sourceRoot":"","sources":["../../../src/documents/workout/WorkoutExerciseCalibration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;iBAiC3C,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,0BAA0B,CAAC;IACxC,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC"}

package/lib/documents/workout/WorkoutExerciseCalibration.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { RequiredUserIdSchema } from '../../schemas/required-refs/RequiredUserId.js';
+import { BaseDocumentWithTypeSchema, BaseDocumentWithUpdatedAndCreatedDatesSchema } from '../BaseDocument.js';
+/**
+ * The docType value for WorkoutExerciseCalibration documents.
+ */
+export const WorkoutExerciseCalibration_docType = 'workoutExerciseCalibration';
+/**
+ * The schema for {@link WorkoutExerciseCalibration} documents.
+ */
+export const WorkoutExerciseCalibrationSchema = z.object({
+    ...BaseDocumentWithTypeSchema.shape,
+    ...RequiredUserIdSchema.shape,
+    ...BaseDocumentWithUpdatedAndCreatedDatesSchema.shape,
+    docType: z
+        .literal(WorkoutExerciseCalibration_docType)
+        .default(WorkoutExerciseCalibration_docType),
+    /**
+     * The ID of the exercise this calibration is for.
+     */
+    workoutExerciseId: z.uuidv7().transform((val) => val),
+    /**
+     * Custom exercise properties at the time of calibration.
+     *
+     * This is populated from WorkoutExercise.customProperties at creation time
+     * to preserve historical context.
+     */
+    exerciseProperties: z.record(z.string(), z.unknown()).nullish(),
+    /**
+     * The number of reps performed at the calibration weight.
+     *
+     * This should be the lowest amount of reps the person can do with the highest
+     * amount of weight they can handle for this exercise.
+     */
+    reps: z.int().positive(),
+    /**
+     * The weight used for this calibration.
+     */
+    weight: z.number(),
+    /**
+     * The date this calibration was recorded.
+     */
+    dateRecorded: z.date().default(() => new Date())
+});
+//# sourceMappingURL=WorkoutExerciseCalibration.js.map

package/lib/documents/workout/WorkoutExerciseCalibration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutExerciseCalibration.js","sourceRoot":"","sources":["../../../src/documents/workout/WorkoutExerciseCalibration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,EACL,0BAA0B,EAC1B,4CAA4C,EAC7C,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,4BAA4B,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,GAAG,0BAA0B,CAAC,KAAK;IACnC,GAAG,oBAAoB,CAAC,KAAK;IAC7B,GAAG,4CAA4C,CAAC,KAAK;IACrD,OAAO,EAAE,CAAC;SACP,OAAO,CAAC,kCAAkC,CAAC;SAC3C,OAAO,CAAC,kCAAkC,CAAC;IAC9C;;OAEG;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAW,CAAC;IAC7D;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/D;;;;;OAKG;IACH,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACxB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB;;OAEG;IACH,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;CACjD,CAAC,CAAC"}

package/lib/documents/workout/WorkoutExerciseCalibration.ts

@@ -0,0 +1,74 @@
+import type { UUID } from 'crypto';
+import { z } from 'zod';
+import { RequiredUserIdSchema } from '../../schemas/required-refs/RequiredUserId.js';
+import {
+  BaseDocumentWithTypeSchema,
+  BaseDocumentWithUpdatedAndCreatedDatesSchema
+} from '../BaseDocument.js';
+import type { WorkoutExercise } from './WorkoutExercise.js';
+
+/**
+ * The docType value for WorkoutExerciseCalibration documents.
+ */
+export const WorkoutExerciseCalibration_docType = 'workoutExerciseCalibration';
+
+/**
+ * The schema for {@link WorkoutExerciseCalibration} documents.
+ */
+export const WorkoutExerciseCalibrationSchema = z.object({
+  ...BaseDocumentWithTypeSchema.shape,
+  ...RequiredUserIdSchema.shape,
+  ...BaseDocumentWithUpdatedAndCreatedDatesSchema.shape,
+  docType: z
+    .literal(WorkoutExerciseCalibration_docType)
+    .default(WorkoutExerciseCalibration_docType),
+  /**
+   * The ID of the exercise this calibration is for.
+   */
+  workoutExerciseId: z.uuidv7().transform((val) => val as UUID),
+  /**
+   * Custom exercise properties at the time of calibration.
+   *
+   * This is populated from WorkoutExercise.customProperties at creation time
+   * to preserve historical context.
+   */
+  exerciseProperties: z.record(z.string(), z.unknown()).nullish(),
+  /**
+   * The number of reps performed at the calibration weight.
+   *
+   * This should be the lowest amount of reps the person can do with the highest
+   * amount of weight they can handle for this exercise.
+   */
+  reps: z.int().positive(),
+  /**
+   * The weight used for this calibration.
+   */
+  weight: z.number(),
+  /**
+   * The date this calibration was recorded.
+   */
+  dateRecorded: z.date().default(() => new Date())
+});
+
+/**
+ * Represents a calibration point for an exercise, used to calculate 1RM and
+ * track strength progression.
+ *
+ * These documents store the lowest amount of reps the person can do for an
+ * exercise with the highest amount of weight they can handle. This is used
+ * for 1RM calculations using the NASM formula:
+ * 1RM = (Weight Lifted x Reps / 30.48) + Weight Lifted
+ *
+ * WorkoutMesocycle documents reference these to lock in which calibration was
+ * used, ensuring historical 1RM values remain accurate even if calibrations
+ * are updated later.
+ */
+export type WorkoutExerciseCalibration = z.infer<typeof WorkoutExerciseCalibrationSchema>;
+
+/**
+ * Represents a calibration paired with its associated exercise definition.
+ */
+export type CalibrationExercisePair = {
+  calibration: WorkoutExerciseCalibration;
+  exercise: WorkoutExercise;
+};

package/lib/documents/workout/WorkoutMesocycle.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+/**
+ * The type of mesocycle.
+ *
+ * - MuscleGain: Automatic recommendations will be made for muscle gain
+ * - Resensitization: Automatic recommendations for MV training (maintenance)
+ * - Cut: Automatic recommendations for fat loss while maintaining muscle
+ * - FreeForm: No automatic recommendations, user has full control
+ */
+export declare enum CycleType {
+    MuscleGain = "MuscleGain",
+    Resensitization = "Resensitization",
+    Cut = "Cut",
+    FreeForm = "FreeForm"
+}
+/**
+ * The docType value for WorkoutMesocycle documents.
+ */
+export declare const WorkoutMesocycle_docType = "workoutMesocycle";
+/**
+ * The schema for {@link WorkoutMesocycle} documents.
+ */
+export declare const WorkoutMesocycleSchema: z.ZodObject<{
+    docType: z.ZodDefault<z.ZodLiteral<"workoutMesocycle">>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    calibratedExercises: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>>>;
+    cycleType: z.ZodEnum<typeof CycleType>;
+    plannedSessionCountPerMicrocycle: z.ZodInt;
+    plannedMicrocycleLengthInDays: z.ZodInt;
+    plannedMicrocycleRestDays: z.ZodDefault<z.ZodArray<z.ZodInt>>;
+    plannedMicrocycleCount: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    completedDate: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    createdDate: z.ZodDefault<z.ZodDate>;
+    lastUpdatedDate: z.ZodDefault<z.ZodDate>;
+    _id: z.ZodPipe<z.ZodDefault<z.ZodUUID>, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+    userId: z.ZodPipe<z.ZodUUID, z.ZodTransform<`${string}-${string}-${string}-${string}-${string}`, string>>;
+}, z.core.$strip>;
+/**
+ * Represents a mesocycle - an organized sequence of microcycles ordered to
+ * elicit a set of distinct training adaptations.
+ *
+ * A typical mesocycle is composed of two distinct phases:
+ * 1. Accumulation phase: Progress from MEV towards MRV
+ * 2. Deload phase: Shorter recovery period
+ *
+ * The accumulation phase should last 4-8 weeks, followed by a deload phase.
+ */
+export type WorkoutMesocycle = z.infer<typeof WorkoutMesocycleSchema>;
+//# sourceMappingURL=WorkoutMesocycle.d.ts.map

package/lib/documents/workout/WorkoutMesocycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkoutMesocycle.d.ts","sourceRoot":"","sources":["../../../src/documents/workout/WorkoutMesocycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;GAOG;AACH,oBAAY,SAAS;IACnB,UAAU,eAAe;IACzB,eAAe,oBAAoB;IACnC,GAAG,QAAQ;IACX,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBA0D/B,CAAC;AAEL;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}