@tbs-fitness/contract 0.4.0 → 0.6.0

package/dist/cjs/food/food.dto.d.ts

@@ -0,0 +1,339 @@
+import { z } from 'zod';
+export declare const MAX_FOOD_NAME_LENGTH = 120;
+export declare const MAX_FOOD_NOTES_LENGTH = 1000;
+export declare const MAX_FOOD_METADATA_VALUES = 50;
+export declare const MAX_FOOD_SEARCH_LENGTH = 100;
+export declare const foodIdParamSchema: z.ZodUUID;
+export declare const metadataTypeIdParamSchema: z.ZodUUID;
+export declare const metadataValueIdParamSchema: z.ZodUUID;
+export declare const servingSchema: z.ZodObject<{
+    label: z.ZodString;
+    quantity: z.ZodNumber;
+    unit: z.ZodEnum<{
+        g: "g";
+        ml: "ml";
+    }>;
+}, z.core.$strict>;
+export type ServingInput = z.input<typeof servingSchema>;
+/**
+ * Nutrient values as entered. `basis` says whether they are per 100 units of
+ * the serving unit or for one serving; the API stores them per 100.
+ */
+export declare const nutritionInputSchema: z.ZodObject<{
+    basis: z.ZodDefault<z.ZodEnum<{
+        PER_100: "PER_100";
+        PER_SERVING: "PER_SERVING";
+    }>>;
+    calories: z.ZodNumber;
+    protein: z.ZodNumber;
+    carbs: z.ZodNumber;
+    fat: z.ZodNumber;
+    sugar: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    solubleFiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    insolubleFiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type NutritionInput = z.input<typeof nutritionInputSchema>;
+export type NutritionBody = z.output<typeof nutritionInputSchema>;
+export declare const createFoodSchema: z.ZodObject<{
+    name: z.ZodString;
+    nameHi: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    namePa: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    englishAlias: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    serving: z.ZodObject<{
+        label: z.ZodString;
+        quantity: z.ZodNumber;
+        unit: z.ZodEnum<{
+            g: "g";
+            ml: "ml";
+        }>;
+    }, z.core.$strict>;
+    nutrition: z.ZodObject<{
+        basis: z.ZodDefault<z.ZodEnum<{
+            PER_100: "PER_100";
+            PER_SERVING: "PER_SERVING";
+        }>>;
+        calories: z.ZodNumber;
+        protein: z.ZodNumber;
+        carbs: z.ZodNumber;
+        fat: z.ZodNumber;
+        sugar: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        solubleFiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        insolubleFiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>;
+    metadataValueIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CreateFoodInput = z.input<typeof createFoodSchema>;
+export type CreateFoodBody = z.output<typeof createFoodSchema>;
+export declare const updateFoodSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    nameHi: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    namePa: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    englishAlias: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    serving: z.ZodOptional<z.ZodObject<{
+        label: z.ZodString;
+        quantity: z.ZodNumber;
+        unit: z.ZodEnum<{
+            g: "g";
+            ml: "ml";
+        }>;
+    }, z.core.$strict>>;
+    nutrition: z.ZodOptional<z.ZodObject<{
+        basis: z.ZodDefault<z.ZodEnum<{
+            PER_100: "PER_100";
+            PER_SERVING: "PER_SERVING";
+        }>>;
+        calories: z.ZodNumber;
+        protein: z.ZodNumber;
+        carbs: z.ZodNumber;
+        fat: z.ZodNumber;
+        sugar: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        solubleFiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        insolubleFiber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strict>>;
+    metadataValueIds: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type UpdateFoodInput = z.input<typeof updateFoodSchema>;
+export type UpdateFoodBody = z.output<typeof updateFoodSchema>;
+/**
+ * `metadata` filters by value ids: a food matches when it has at least one of
+ * the listed values of each type that appears in the list.
+ */
+export declare const foodListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodUUID>>, unknown>;
+    source: z.ZodOptional<z.ZodEnum<{
+        ADMIN: "ADMIN";
+        COACH: "COACH";
+        CLIENT_SUGGESTION: "CLIENT_SUGGESTION";
+        IMPORT: "IMPORT";
+    }>>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        name: "name";
+        updatedAt: "updatedAt";
+        calories: "calories";
+        protein: "protein";
+    }>>;
+    order: z.ZodDefault<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+}, z.core.$strip>;
+export type FoodListQuery = z.output<typeof foodListQuerySchema>;
+export declare const similarFoodQuerySchema: z.ZodObject<{
+    name: z.ZodString;
+}, z.core.$strip>;
+export type SimilarFoodQuery = z.output<typeof similarFoodQuerySchema>;
+export declare const nutrientValuesResponseSchema: z.ZodObject<{
+    calories: z.ZodNumber;
+    protein: z.ZodNumber;
+    carbs: z.ZodNumber;
+    fat: z.ZodNumber;
+    sugar: z.ZodNullable<z.ZodNumber>;
+    fiber: z.ZodNullable<z.ZodNumber>;
+    solubleFiber: z.ZodNullable<z.ZodNumber>;
+    insolubleFiber: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type NutrientValuesResponse = z.output<typeof nutrientValuesResponseSchema>;
+export declare const servingResponseSchema: z.ZodObject<{
+    label: z.ZodString;
+    quantity: z.ZodNumber;
+    unit: z.ZodEnum<{
+        g: "g";
+        ml: "ml";
+    }>;
+}, z.core.$strip>;
+export type ServingResponse = z.output<typeof servingResponseSchema>;
+/** A metadata value as attached to a food. */
+export declare const foodMetadataRefSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    typeKey: z.ZodString;
+    key: z.ZodString;
+    label: z.ZodString;
+    isActive: z.ZodBoolean;
+}, z.core.$strip>;
+export type FoodMetadataRef = z.output<typeof foodMetadataRefSchema>;
+export declare const userRefSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    fullName: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type UserRef = z.output<typeof userRefSchema>;
+export declare const foodResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodString;
+    nameHi: z.ZodNullable<z.ZodString>;
+    namePa: z.ZodNullable<z.ZodString>;
+    englishAlias: z.ZodNullable<z.ZodString>;
+    serving: z.ZodObject<{
+        label: z.ZodString;
+        quantity: z.ZodNumber;
+        unit: z.ZodEnum<{
+            g: "g";
+            ml: "ml";
+        }>;
+    }, z.core.$strip>;
+    per100: z.ZodObject<{
+        calories: z.ZodNumber;
+        protein: z.ZodNumber;
+        carbs: z.ZodNumber;
+        fat: z.ZodNumber;
+        sugar: z.ZodNullable<z.ZodNumber>;
+        fiber: z.ZodNullable<z.ZodNumber>;
+        solubleFiber: z.ZodNullable<z.ZodNumber>;
+        insolubleFiber: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    perServing: z.ZodObject<{
+        calories: z.ZodNumber;
+        protein: z.ZodNumber;
+        carbs: z.ZodNumber;
+        fat: z.ZodNumber;
+        sugar: z.ZodNullable<z.ZodNumber>;
+        fiber: z.ZodNullable<z.ZodNumber>;
+        solubleFiber: z.ZodNullable<z.ZodNumber>;
+        insolubleFiber: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    formulaCalories: z.ZodNumber;
+    metadata: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        typeKey: z.ZodString;
+        key: z.ZodString;
+        label: z.ZodString;
+        isActive: z.ZodBoolean;
+    }, z.core.$strip>>;
+    notes: z.ZodNullable<z.ZodString>;
+    source: z.ZodEnum<{
+        ADMIN: "ADMIN";
+        COACH: "COACH";
+        CLIENT_SUGGESTION: "CLIENT_SUGGESTION";
+        IMPORT: "IMPORT";
+    }>;
+    createdBy: z.ZodObject<{
+        id: z.ZodUUID;
+        fullName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    suggestionId: z.ZodNullable<z.ZodUUID>;
+    importBatchId: z.ZodNullable<z.ZodUUID>;
+    version: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type FoodResponse = z.output<typeof foodResponseSchema>;
+export declare const similarFoodResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodString;
+    serving: z.ZodObject<{
+        label: z.ZodString;
+        quantity: z.ZodNumber;
+        unit: z.ZodEnum<{
+            g: "g";
+            ml: "ml";
+        }>;
+    }, z.core.$strip>;
+    per100: z.ZodObject<{
+        calories: z.ZodNumber;
+        protein: z.ZodNumber;
+        carbs: z.ZodNumber;
+        fat: z.ZodNumber;
+        sugar: z.ZodNullable<z.ZodNumber>;
+        fiber: z.ZodNullable<z.ZodNumber>;
+        solubleFiber: z.ZodNullable<z.ZodNumber>;
+        insolubleFiber: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    similarity: z.ZodNumber;
+}, z.core.$strip>;
+export type SimilarFoodResponse = z.output<typeof similarFoodResponseSchema>;
+export declare const foodStatsResponseSchema: z.ZodObject<{
+    totalFoods: z.ZodNumber;
+    categories: z.ZodArray<z.ZodObject<{
+        valueId: z.ZodUUID;
+        key: z.ZodString;
+        label: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    pendingSuggestions: z.ZodNumber;
+}, z.core.$strip>;
+export type FoodStatsResponse = z.output<typeof foodStatsResponseSchema>;
+export declare const MAX_METADATA_LABEL_LENGTH = 60;
+export declare const metadataTypeResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    key: z.ZodString;
+    label: z.ZodString;
+    selection: z.ZodEnum<{
+        single: "single";
+        multiple: "multiple";
+    }>;
+    parentTypeId: z.ZodNullable<z.ZodUUID>;
+    isRequired: z.ZodBoolean;
+    isSystem: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+}, z.core.$strip>;
+export type MetadataTypeResponse = z.output<typeof metadataTypeResponseSchema>;
+export declare const metadataTypeListResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    key: z.ZodString;
+    label: z.ZodString;
+    selection: z.ZodEnum<{
+        single: "single";
+        multiple: "multiple";
+    }>;
+    parentTypeId: z.ZodNullable<z.ZodUUID>;
+    isRequired: z.ZodBoolean;
+    isSystem: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const metadataValueResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    typeId: z.ZodUUID;
+    key: z.ZodString;
+    label: z.ZodString;
+    parentValueId: z.ZodNullable<z.ZodUUID>;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type MetadataValueResponse = z.output<typeof metadataValueResponseSchema>;
+export declare const metadataValueListResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    typeId: z.ZodUUID;
+    key: z.ZodString;
+    label: z.ZodString;
+    parentValueId: z.ZodNullable<z.ZodUUID>;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>>;
+export declare const metadataValueListQuerySchema: z.ZodObject<{
+    includeInactive: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>>;
+}, z.core.$strip>;
+export type MetadataValueListQuery = z.output<typeof metadataValueListQuerySchema>;
+/** The key is made from the label, so "High Protein" is stored as `high-protein`. */
+export declare const createMetadataValueSchema: z.ZodObject<{
+    label: z.ZodString;
+    parentValueId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    sortOrder: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type CreateMetadataValueInput = z.input<typeof createMetadataValueSchema>;
+export type CreateMetadataValueBody = z.output<typeof createMetadataValueSchema>;
+/** The key never changes, so renaming a value keeps every link to it. */
+export declare const updateMetadataValueSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    parentValueId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type UpdateMetadataValueInput = z.input<typeof updateMetadataValueSchema>;
+export type UpdateMetadataValueBody = z.output<typeof updateMetadataValueSchema>;

package/dist/cjs/food/food.dto.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateMetadataValueSchema = exports.createMetadataValueSchema = exports.metadataValueListQuerySchema = exports.metadataValueListResponseSchema = exports.metadataValueResponseSchema = exports.metadataTypeListResponseSchema = exports.metadataTypeResponseSchema = exports.MAX_METADATA_LABEL_LENGTH = exports.foodStatsResponseSchema = exports.similarFoodResponseSchema = exports.foodResponseSchema = exports.userRefSchema = exports.foodMetadataRefSchema = exports.servingResponseSchema = exports.nutrientValuesResponseSchema = exports.similarFoodQuerySchema = exports.foodListQuerySchema = exports.updateFoodSchema = exports.createFoodSchema = exports.nutritionInputSchema = exports.servingSchema = exports.metadataValueIdParamSchema = exports.metadataTypeIdParamSchema = exports.foodIdParamSchema = exports.MAX_FOOD_SEARCH_LENGTH = exports.MAX_FOOD_METADATA_VALUES = exports.MAX_FOOD_NOTES_LENGTH = exports.MAX_FOOD_NAME_LENGTH = void 0;
+const zod_1 = require("zod");
+const date_time_schema_js_1 = require("../common/date-time.schema.js");
+const pagination_schema_js_1 = require("../common/pagination.schema.js");
+const safe_text_schema_js_1 = require("../common/safe-text.schema.js");
+const index_js_1 = require("../enums/index.js");
+const nutrition_js_1 = require("./nutrition.js");
+// Each request has two types. `*Input` is what a client sends, where fields with
+// a default are optional. `*Body` is what the API receives after validation.
+exports.MAX_FOOD_NAME_LENGTH = 120;
+exports.MAX_FOOD_NOTES_LENGTH = 1000;
+exports.MAX_FOOD_METADATA_VALUES = 50;
+exports.MAX_FOOD_SEARCH_LENGTH = 100;
+exports.foodIdParamSchema = zod_1.z.uuid();
+exports.metadataTypeIdParamSchema = zod_1.z.uuid();
+exports.metadataValueIdParamSchema = zod_1.z.uuid();
+const foodNameSchema = (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_FOOD_NAME_LENGTH);
+const optionalNameSchema = (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_FOOD_NAME_LENGTH)
+    .nullable()
+    .optional();
+exports.servingSchema = zod_1.z.strictObject({
+    /** As people say it, e.g. "1 cup (200g)". */
+    label: (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_FOOD_NAME_LENGTH),
+    /** The weight or volume of one serving in `unit`, e.g. 200. */
+    quantity: (0, nutrition_js_1.quantitySchema)(),
+    unit: zod_1.z.enum(index_js_1.SERVING_UNITS),
+});
+/**
+ * Nutrient values as entered. `basis` says whether they are per 100 units of
+ * the serving unit or for one serving; the API stores them per 100.
+ */
+exports.nutritionInputSchema = zod_1.z.strictObject({
+    basis: zod_1.z.enum(index_js_1.NUTRITION_BASES).default('PER_100'),
+    calories: (0, nutrition_js_1.nutrientAmountSchema)(),
+    protein: (0, nutrition_js_1.nutrientAmountSchema)(),
+    carbs: (0, nutrition_js_1.nutrientAmountSchema)(),
+    fat: (0, nutrition_js_1.nutrientAmountSchema)(),
+    sugar: (0, nutrition_js_1.nutrientAmountSchema)().nullable().optional(),
+    fiber: (0, nutrition_js_1.nutrientAmountSchema)().nullable().optional(),
+    solubleFiber: (0, nutrition_js_1.nutrientAmountSchema)().nullable().optional(),
+    insolubleFiber: (0, nutrition_js_1.nutrientAmountSchema)().nullable().optional(),
+});
+const uniqueIds = (ids) => new Set(ids).size === ids.length;
+const metadataValueIdsSchema = zod_1.z
+    .array(zod_1.z.uuid())
+    .max(exports.MAX_FOOD_METADATA_VALUES)
+    .refine(uniqueIds, { error: 'Each value may be listed once' });
+/** Adds an issue for every nutrition rule the values break, measured per 100. */
+function checkNutrition(nutrition, servingQuantity, ctx) {
+    if (nutrition.basis === 'PER_SERVING' && servingQuantity === undefined) {
+        // An update that changes values per serving without a serving uses the
+        // stored serving, so the API checks it.
+        return;
+    }
+    const per100 = nutrition.basis === 'PER_SERVING' && servingQuantity !== undefined
+        ? (0, nutrition_js_1.toPer100)(nutrition, servingQuantity)
+        : nutrition;
+    for (const issue of (0, nutrition_js_1.nutritionIssues)(per100)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: issue.message,
+            path: ['nutrition', issue.path],
+        });
+    }
+}
+const foodFields = {
+    name: foodNameSchema,
+    nameHi: optionalNameSchema,
+    namePa: optionalNameSchema,
+    englishAlias: (0, safe_text_schema_js_1.safeTextSchema)(200).nullable().optional(),
+    serving: exports.servingSchema,
+    nutrition: exports.nutritionInputSchema,
+    /** Category, subcategory, tags and other labels, by value id. */
+    metadataValueIds: metadataValueIdsSchema.default([]),
+    notes: (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_FOOD_NOTES_LENGTH).nullable().optional(),
+};
+// Strict objects reject unknown fields, so an attempt to set `source` or
+// `createdBy` through the API fails loudly.
+exports.createFoodSchema = zod_1.z
+    .strictObject(foodFields)
+    .superRefine((food, ctx) => checkNutrition(food.nutrition, food.serving.quantity, ctx));
+exports.updateFoodSchema = zod_1.z
+    .strictObject({
+    // The version last read, so that a stale edit is refused rather than lost.
+    version: zod_1.z.number().int().min(1),
+    name: foodNameSchema.optional(),
+    nameHi: optionalNameSchema,
+    namePa: optionalNameSchema,
+    englishAlias: (0, safe_text_schema_js_1.safeTextSchema)(200).nullable().optional(),
+    serving: exports.servingSchema.optional(),
+    /** Replaces every nutrient value; omitted nutrients become unknown. */
+    nutrition: exports.nutritionInputSchema.optional(),
+    /** Replaces every metadata value. */
+    metadataValueIds: metadataValueIdsSchema.optional(),
+    notes: (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_FOOD_NOTES_LENGTH).nullable().optional(),
+})
+    .superRefine((food, ctx) => {
+    if (food.nutrition) {
+        checkNutrition(food.nutrition, food.serving?.quantity, ctx);
+    }
+})
+    .refine(({ version: _version, ...changes }) => Object.values(changes).some((value) => value !== undefined), { error: 'Provide at least one field to change' });
+const MAX_FILTER_VALUES = 50;
+/** Accepts `a,b` or a repeated parameter, as query strings carry either. */
+const idListQuerySchema = zod_1.z.preprocess((value) => {
+    if (typeof value === 'string') {
+        return value === ''
+            ? undefined
+            : value
+                .split(',')
+                .map((part) => part.trim())
+                .filter(Boolean);
+    }
+    // Anything other than a string or a list of strings is left for the schema
+    // to reject.
+    return value;
+}, zod_1.z.array(zod_1.z.uuid()).max(MAX_FILTER_VALUES).optional());
+const searchQuerySchema = zod_1.z
+    .string()
+    .trim()
+    .min(1)
+    .max(exports.MAX_FOOD_SEARCH_LENGTH)
+    .optional();
+/**
+ * `metadata` filters by value ids: a food matches when it has at least one of
+ * the listed values of each type that appears in the list.
+ */
+exports.foodListQuerySchema = pagination_schema_js_1.paginationQuerySchema.extend({
+    search: searchQuerySchema,
+    metadata: idListQuerySchema,
+    source: zod_1.z.enum(index_js_1.FOOD_SOURCES).optional(),
+    sort: zod_1.z.enum(index_js_1.FOOD_SORT_FIELDS).default('name'),
+    order: zod_1.z.enum(index_js_1.SORT_ORDERS).default('asc'),
+});
+exports.similarFoodQuerySchema = zod_1.z.object({
+    name: (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_FOOD_NAME_LENGTH),
+});
+// Responses
+exports.nutrientValuesResponseSchema = zod_1.z.object({
+    calories: zod_1.z.number(),
+    protein: zod_1.z.number(),
+    carbs: zod_1.z.number(),
+    fat: zod_1.z.number(),
+    sugar: zod_1.z.number().nullable(),
+    fiber: zod_1.z.number().nullable(),
+    solubleFiber: zod_1.z.number().nullable(),
+    insolubleFiber: zod_1.z.number().nullable(),
+});
+exports.servingResponseSchema = zod_1.z.object({
+    label: zod_1.z.string(),
+    quantity: zod_1.z.number(),
+    unit: zod_1.z.enum(index_js_1.SERVING_UNITS),
+});
+/** A metadata value as attached to a food. */
+exports.foodMetadataRefSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    typeKey: zod_1.z.string(),
+    key: zod_1.z.string(),
+    label: zod_1.z.string(),
+    isActive: zod_1.z.boolean(),
+});
+exports.userRefSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    fullName: zod_1.z.string().nullable(),
+});
+exports.foodResponseSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    name: zod_1.z.string(),
+    nameHi: zod_1.z.string().nullable(),
+    namePa: zod_1.z.string().nullable(),
+    englishAlias: zod_1.z.string().nullable(),
+    serving: exports.servingResponseSchema,
+    /** Per 100 g, or per 100 ml for a serving in ml. */
+    per100: exports.nutrientValuesResponseSchema,
+    perServing: exports.nutrientValuesResponseSchema,
+    /** Calories from the macros per 100 units: (protein + carbs) × 4 + fat × 9. */
+    formulaCalories: zod_1.z.number(),
+    metadata: zod_1.z.array(exports.foodMetadataRefSchema),
+    notes: zod_1.z.string().nullable(),
+    source: zod_1.z.enum(index_js_1.FOOD_SOURCES),
+    createdBy: exports.userRefSchema,
+    suggestionId: zod_1.z.uuid().nullable(),
+    importBatchId: zod_1.z.uuid().nullable(),
+    version: zod_1.z.number().int(),
+    createdAt: date_time_schema_js_1.utcTimestampSchema,
+    updatedAt: date_time_schema_js_1.utcTimestampSchema,
+});
+exports.similarFoodResponseSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    name: zod_1.z.string(),
+    serving: exports.servingResponseSchema,
+    per100: exports.nutrientValuesResponseSchema,
+    /** 0 to 1; 1 is the same name. */
+    similarity: zod_1.z.number(),
+});
+exports.foodStatsResponseSchema = zod_1.z.object({
+    totalFoods: zod_1.z.number().int(),
+    categories: zod_1.z.array(zod_1.z.object({
+        valueId: zod_1.z.uuid(),
+        key: zod_1.z.string(),
+        label: zod_1.z.string(),
+        count: zod_1.z.number().int(),
+    })),
+    pendingSuggestions: zod_1.z.number().int(),
+});
+// Metadata
+exports.MAX_METADATA_LABEL_LENGTH = 60;
+exports.metadataTypeResponseSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    key: zod_1.z.string(),
+    label: zod_1.z.string(),
+    selection: zod_1.z.enum(index_js_1.FOOD_METADATA_SELECTIONS),
+    parentTypeId: zod_1.z.uuid().nullable(),
+    isRequired: zod_1.z.boolean(),
+    isSystem: zod_1.z.boolean(),
+    isActive: zod_1.z.boolean(),
+    sortOrder: zod_1.z.number().int(),
+});
+exports.metadataTypeListResponseSchema = zod_1.z.array(exports.metadataTypeResponseSchema);
+exports.metadataValueResponseSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    typeId: zod_1.z.uuid(),
+    key: zod_1.z.string(),
+    label: zod_1.z.string(),
+    parentValueId: zod_1.z.uuid().nullable(),
+    isActive: zod_1.z.boolean(),
+    sortOrder: zod_1.z.number().int(),
+    createdAt: date_time_schema_js_1.utcTimestampSchema,
+    updatedAt: date_time_schema_js_1.utcTimestampSchema,
+});
+exports.metadataValueListResponseSchema = zod_1.z.array(exports.metadataValueResponseSchema);
+exports.metadataValueListQuerySchema = zod_1.z.object({
+    includeInactive: zod_1.z
+        .enum(['true', 'false'])
+        .transform((value) => value === 'true')
+        .optional(),
+});
+const sortOrderSchema = zod_1.z.number().int().min(0).max(10000);
+/** The key is made from the label, so "High Protein" is stored as `high-protein`. */
+exports.createMetadataValueSchema = zod_1.z.strictObject({
+    label: (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_METADATA_LABEL_LENGTH),
+    /** Required for a type with a parent, such as a subcategory's category. */
+    parentValueId: zod_1.z.uuid().nullable().optional(),
+    sortOrder: sortOrderSchema.default(0),
+});
+/** The key never changes, so renaming a value keeps every link to it. */
+exports.updateMetadataValueSchema = zod_1.z
+    .strictObject({
+    label: (0, safe_text_schema_js_1.safeTextSchema)(exports.MAX_METADATA_LABEL_LENGTH).optional(),
+    parentValueId: zod_1.z.uuid().nullable().optional(),
+    sortOrder: sortOrderSchema.optional(),
+    isActive: zod_1.z.boolean().optional(),
+})
+    .refine((changes) => Object.values(changes).some((value) => value !== undefined), { error: 'Provide at least one field to change' });

package/dist/cjs/food/index.d.ts

@@ -0,0 +1,5 @@
+export * from './client-food.dto.js';
+export * from './food.dto.js';
+export * from './food-import.dto.js';
+export * from './food-suggestion.dto.js';
+export * from './nutrition.js';

package/dist/cjs/food/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client-food.dto.js"), exports);
+__exportStar(require("./food.dto.js"), exports);
+__exportStar(require("./food-import.dto.js"), exports);
+__exportStar(require("./food-suggestion.dto.js"), exports);
+__exportStar(require("./nutrition.js"), exports);