@tbs-fitness/contract 0.5.0 → 0.6.0

package/README.md

@@ -15,6 +15,7 @@ It is published as `@tbs-fitness/contract`. The package holds definitions only:
 | `@tbs-fitness/contract/coach`         | Coach sign-up, one-time code verification and resend, coach sign-in and profile, password recovery                               |
 | `@tbs-fitness/contract/audit`         | The audit log query and response                                                                                                 |
 | `@tbs-fitness/contract/feature-flags` | Feature flag requests and responses                                                                                              |
+| `@tbs-fitness/contract/food`          | Food library, metadata, CSV/XLSX import, client food suggestions and their review, and the shared nutrition helpers              |
 
 Each domain has its own entry point, so names only need to be unique within a domain. `auditLogResponseSchema`, for example, exists in both `/audit` and `/feature-flags`.
 
@@ -42,6 +43,20 @@ const result = createFlagSchema.safeParse(input); // The same rules as the API.
 
 Requests have two types. Clients use `*Input`, where fields with a default are optional. The backend uses `*Body`, which is the result after validation. List queries come from the URL as strings, so they have no `*Input`: use `Partial<PaginationQuery>` or `Partial<AuditLogQuery>`.
 
+## Version 0.6.0
+
+The food library. Additive; consumers install `^0.6.0` explicitly.
+
+- `/enums`: `FOOD_SOURCES`, `SERVING_UNITS` (`g`, `ml`), `PORTION_UNITS`, `NUTRITION_BASES`, `FOOD_SUGGESTION_STATUSES`, `FOOD_SUGGESTION_RESOLUTIONS`, `FOOD_IMPORT_MODES`, `FOOD_IMPORT_STATUSES`, `FOOD_IMPORT_ROW_STATUSES`, `FOOD_IMPORT_FILE_TYPES`, `FOOD_IMPORT_ISSUE_SEVERITIES`, `FOOD_METADATA_SELECTIONS`, `FOOD_SORT_FIELDS` and `SORT_ORDERS`.
+- New `/food`:
+  - Library: `createFoodSchema`, `updateFoodSchema` (with `version`), `foodListQuerySchema`, `foodResponseSchema` (values per 100 and per serving, plus `formulaCalories`), `similarFoodResponseSchema`, `foodStatsResponseSchema`.
+  - Metadata: `metadataTypeResponseSchema`, `metadataValueResponseSchema`, `createMetadataValueSchema`, `updateMetadataValueSchema`.
+  - Import: `foodImportRowSchema` (one spreadsheet row, shared by the API and the preview), `commitFoodImportSchema`, `foodImportBatchResponseSchema`, `foodImportRowResponseSchema`, `FOOD_IMPORT_LIMITS`.
+  - Suggestions: `submitFoodSuggestionSchema`, `suggestionPhotoUploadSchema`, `presignedUploadResponseSchema`, `approveFoodSuggestionSchema` (one shape per resolution), `rejectFoodSuggestionSchema`, `foodSuggestionResponseSchema` (coach view), `clientFoodSuggestionResponseSchema` (client view), `FOOD_SUGGESTION_LIMITS`.
+  - Client search: `clientFoodSearchQuerySchema`, `clientFoodResponseSchema`.
+  - Helpers: `toPer100`, `perServing`, `formulaCalories` (Biki's formula, (protein + carbs) × 4 + fat × 9), `nutritionIssues`, `normalizeFoodName`, `slugifyMetadataKey`, `parseServingLabel`, `roundNutrient`.
+- Library nutrients are per 100 of the serving unit: per 100 g, or per 100 ml for a serving in ml. Values have at most 2 decimals.
+
 ## Version 0.5.0 (breaking)
 
 - `ROLES` is now `ADMIN`, `COACH` and `CLIENT`: `CUSTOMER` is renamed to `CLIENT`. The backend migrates stored roles in step.

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

@@ -44,3 +44,41 @@ export type DeliveryStatus = (typeof DELIVERY_STATUSES)[number];
 /** Only one version of a template per message type and channel is active. */
 export declare const TEMPLATE_STATUSES: readonly ["draft", "active", "archived"];
 export type TemplateStatus = (typeof TEMPLATE_STATUSES)[number];
+/** Who put a food into the library. */
+export declare const FOOD_SOURCES: readonly ["ADMIN", "COACH", "CLIENT_SUGGESTION", "IMPORT"];
+export type FoodSource = (typeof FOOD_SOURCES)[number];
+/**
+ * The unit a library serving is measured in. Nutrients are stored per 100 of
+ * this unit, so a food in `ml` holds values per 100 ml.
+ */
+export declare const SERVING_UNITS: readonly ["g", "ml"];
+export type ServingUnit = (typeof SERVING_UNITS)[number];
+/** The portion units a client can pick when logging a food. */
+export declare const PORTION_UNITS: readonly ["BOWL", "GRAM", "PIECE", "CUP"];
+export type PortionUnit = (typeof PORTION_UNITS)[number];
+/** Whether submitted nutrient values are per 100 units or per serving. */
+export declare const NUTRITION_BASES: readonly ["PER_100", "PER_SERVING"];
+export type NutritionBasis = (typeof NUTRITION_BASES)[number];
+export declare const FOOD_SUGGESTION_STATUSES: readonly ["pending", "approved", "rejected", "withdrawn"];
+export type FoodSuggestionStatus = (typeof FOOD_SUGGESTION_STATUSES)[number];
+/** How an approved suggestion was resolved. */
+export declare const FOOD_SUGGESTION_RESOLUTIONS: readonly ["ADDED_TO_LIBRARY", "LINKED_TO_EXISTING", "APPROVED_WITHOUT_LIBRARY"];
+export type FoodSuggestionResolution = (typeof FOOD_SUGGESTION_RESOLUTIONS)[number];
+/** What a bulk import does with a row whose food is already in the library. */
+export declare const FOOD_IMPORT_MODES: readonly ["SKIP_DUPLICATES", "UPDATE_EXISTING"];
+export type FoodImportMode = (typeof FOOD_IMPORT_MODES)[number];
+export declare const FOOD_IMPORT_STATUSES: readonly ["previewed", "completed", "expired"];
+export type FoodImportStatus = (typeof FOOD_IMPORT_STATUSES)[number];
+export declare const FOOD_IMPORT_ROW_STATUSES: readonly ["valid", "invalid", "duplicate_in_file", "duplicate_existing"];
+export type FoodImportRowStatus = (typeof FOOD_IMPORT_ROW_STATUSES)[number];
+export declare const FOOD_IMPORT_FILE_TYPES: readonly ["csv", "xlsx"];
+export type FoodImportFileType = (typeof FOOD_IMPORT_FILE_TYPES)[number];
+export declare const FOOD_IMPORT_ISSUE_SEVERITIES: readonly ["error", "warning"];
+export type FoodImportIssueSeverity = (typeof FOOD_IMPORT_ISSUE_SEVERITIES)[number];
+/** Whether a food takes one value of a metadata type or several. */
+export declare const FOOD_METADATA_SELECTIONS: readonly ["single", "multiple"];
+export type FoodMetadataSelection = (typeof FOOD_METADATA_SELECTIONS)[number];
+export declare const FOOD_SORT_FIELDS: readonly ["name", "updatedAt", "calories", "protein"];
+export type FoodSortField = (typeof FOOD_SORT_FIELDS)[number];
+export declare const SORT_ORDERS: readonly ["asc", "desc"];
+export type SortOrder = (typeof SORT_ORDERS)[number];

package/dist/cjs/enums/index.js

@@ -2,7 +2,7 @@
 // These values are stored in the database and sent over the API. Renaming or
 // removing one is a breaking change, so it needs a major version.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEMPLATE_STATUSES = exports.DELIVERY_STATUSES = exports.MESSAGE_TYPES = exports.COMMUNICATION_CHANNELS = exports.FEATURE_FLAG_RULE_TYPES = exports.AUDIT_OUTCOMES = exports.TOKEN_TRANSPORTS = exports.TIMEZONE_SOURCES = exports.ADMIN_SETTABLE_ACCOUNT_STATUSES = exports.ACCOUNT_STATUSES = exports.ROLES = exports.APP_ENVIRONMENTS = void 0;
+exports.SORT_ORDERS = exports.FOOD_SORT_FIELDS = exports.FOOD_METADATA_SELECTIONS = exports.FOOD_IMPORT_ISSUE_SEVERITIES = exports.FOOD_IMPORT_FILE_TYPES = exports.FOOD_IMPORT_ROW_STATUSES = exports.FOOD_IMPORT_STATUSES = exports.FOOD_IMPORT_MODES = exports.FOOD_SUGGESTION_RESOLUTIONS = exports.FOOD_SUGGESTION_STATUSES = exports.NUTRITION_BASES = exports.PORTION_UNITS = exports.SERVING_UNITS = exports.FOOD_SOURCES = exports.TEMPLATE_STATUSES = exports.DELIVERY_STATUSES = exports.MESSAGE_TYPES = exports.COMMUNICATION_CHANNELS = exports.FEATURE_FLAG_RULE_TYPES = exports.AUDIT_OUTCOMES = exports.TOKEN_TRANSPORTS = exports.TIMEZONE_SOURCES = exports.ADMIN_SETTABLE_ACCOUNT_STATUSES = exports.ACCOUNT_STATUSES = exports.ROLES = exports.APP_ENVIRONMENTS = void 0;
 exports.APP_ENVIRONMENTS = [
     'development',
     'staging',
@@ -60,3 +60,58 @@ exports.DELIVERY_STATUSES = [
 ];
 /** Only one version of a template per message type and channel is active. */
 exports.TEMPLATE_STATUSES = ['draft', 'active', 'archived'];
+/** Who put a food into the library. */
+exports.FOOD_SOURCES = [
+    'ADMIN',
+    'COACH',
+    'CLIENT_SUGGESTION',
+    'IMPORT',
+];
+/**
+ * The unit a library serving is measured in. Nutrients are stored per 100 of
+ * this unit, so a food in `ml` holds values per 100 ml.
+ */
+exports.SERVING_UNITS = ['g', 'ml'];
+/** The portion units a client can pick when logging a food. */
+exports.PORTION_UNITS = ['BOWL', 'GRAM', 'PIECE', 'CUP'];
+/** Whether submitted nutrient values are per 100 units or per serving. */
+exports.NUTRITION_BASES = ['PER_100', 'PER_SERVING'];
+exports.FOOD_SUGGESTION_STATUSES = [
+    'pending',
+    'approved',
+    'rejected',
+    'withdrawn',
+];
+/** How an approved suggestion was resolved. */
+exports.FOOD_SUGGESTION_RESOLUTIONS = [
+    'ADDED_TO_LIBRARY',
+    'LINKED_TO_EXISTING',
+    'APPROVED_WITHOUT_LIBRARY',
+];
+/** What a bulk import does with a row whose food is already in the library. */
+exports.FOOD_IMPORT_MODES = [
+    'SKIP_DUPLICATES',
+    'UPDATE_EXISTING',
+];
+exports.FOOD_IMPORT_STATUSES = [
+    'previewed',
+    'completed',
+    'expired',
+];
+exports.FOOD_IMPORT_ROW_STATUSES = [
+    'valid',
+    'invalid',
+    'duplicate_in_file',
+    'duplicate_existing',
+];
+exports.FOOD_IMPORT_FILE_TYPES = ['csv', 'xlsx'];
+exports.FOOD_IMPORT_ISSUE_SEVERITIES = ['error', 'warning'];
+/** Whether a food takes one value of a metadata type or several. */
+exports.FOOD_METADATA_SELECTIONS = ['single', 'multiple'];
+exports.FOOD_SORT_FIELDS = [
+    'name',
+    'updatedAt',
+    'calories',
+    'protein',
+];
+exports.SORT_ORDERS = ['asc', 'desc'];

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

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export declare const MIN_CLIENT_FOOD_SEARCH_LENGTH = 2;
+export declare const clientFoodSearchQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodString;
+}, z.core.$strip>;
+export type ClientFoodSearchQuery = z.output<typeof clientFoodSearchQuerySchema>;
+/** A library food as a client sees it: what they need to log it, and nothing about who added it. */
+export declare const clientFoodResponseSchema: 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>;
+    tags: z.ZodArray<z.ZodObject<{
+        typeKey: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ClientFoodResponse = z.output<typeof clientFoodResponseSchema>;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientFoodResponseSchema = exports.clientFoodSearchQuerySchema = exports.MIN_CLIENT_FOOD_SEARCH_LENGTH = void 0;
+const zod_1 = require("zod");
+const pagination_schema_js_1 = require("../common/pagination.schema.js");
+const food_dto_js_1 = require("./food.dto.js");
+exports.MIN_CLIENT_FOOD_SEARCH_LENGTH = 2;
+exports.clientFoodSearchQuerySchema = pagination_schema_js_1.paginationQuerySchema.extend({
+    search: zod_1.z
+        .string()
+        .trim()
+        .min(exports.MIN_CLIENT_FOOD_SEARCH_LENGTH)
+        .max(food_dto_js_1.MAX_FOOD_SEARCH_LENGTH),
+});
+/** A library food as a client sees it: what they need to log it, and nothing about who added it. */
+exports.clientFoodResponseSchema = 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: food_dto_js_1.servingResponseSchema,
+    per100: food_dto_js_1.nutrientValuesResponseSchema,
+    perServing: food_dto_js_1.nutrientValuesResponseSchema,
+    tags: zod_1.z.array(zod_1.z.object({ typeKey: zod_1.z.string(), label: zod_1.z.string() })),
+});

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

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+/** The file limits the API enforces, shared so the upload screen can say them up front. */
+export declare const FOOD_IMPORT_LIMITS: {
+    readonly maxFileBytes: number;
+    readonly maxRows: 5000;
+    readonly extensions: readonly [".csv", ".xlsx"];
+};
+export declare const importIdParamSchema: z.ZodUUID;
+/**
+ * One spreadsheet row after its cells are read. Values per 100 g (or per 100 ml
+ * for a serving in ml). Metadata are keys such as `protein` or `high-protein`,
+ * matched to the library's values. Has no defaults, so it also serves as the
+ * preview response.
+ */
+export declare const foodImportRowSchema: z.ZodObject<{
+    name: z.ZodString;
+    nameHi: z.ZodNullable<z.ZodString>;
+    namePa: z.ZodNullable<z.ZodString>;
+    englishAlias: z.ZodNullable<z.ZodString>;
+    category: z.ZodString;
+    subcategory: z.ZodNullable<z.ZodString>;
+    servingLabel: z.ZodString;
+    servingQuantity: z.ZodNumber;
+    servingUnit: z.ZodEnum<{
+        g: "g";
+        ml: "ml";
+    }>;
+    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>;
+    tags: z.ZodArray<z.ZodString>;
+    mealTimings: z.ZodArray<z.ZodString>;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type FoodImportRow = z.output<typeof foodImportRowSchema>;
+export declare const commitFoodImportSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        SKIP_DUPLICATES: "SKIP_DUPLICATES";
+        UPDATE_EXISTING: "UPDATE_EXISTING";
+    }>>;
+    createMissingMetadata: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type CommitFoodImportInput = z.input<typeof commitFoodImportSchema>;
+export type CommitFoodImportBody = z.output<typeof commitFoodImportSchema>;
+export declare const foodImportListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const foodImportRowsQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        valid: "valid";
+        invalid: "invalid";
+        duplicate_in_file: "duplicate_in_file";
+        duplicate_existing: "duplicate_existing";
+    }>>;
+}, z.core.$strip>;
+export type FoodImportRowsQuery = z.output<typeof foodImportRowsQuerySchema>;
+export declare const foodImportIssueSchema: z.ZodObject<{
+    column: z.ZodNullable<z.ZodString>;
+    code: z.ZodString;
+    message: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+}, z.core.$strip>;
+export type FoodImportIssue = z.output<typeof foodImportIssueSchema>;
+export declare const foodImportBatchResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    fileName: z.ZodString;
+    fileType: z.ZodEnum<{
+        csv: "csv";
+        xlsx: "xlsx";
+    }>;
+    sheetName: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        previewed: "previewed";
+        completed: "completed";
+        expired: "expired";
+    }>;
+    mode: z.ZodNullable<z.ZodEnum<{
+        SKIP_DUPLICATES: "SKIP_DUPLICATES";
+        UPDATE_EXISTING: "UPDATE_EXISTING";
+    }>>;
+    createMissingMetadata: z.ZodBoolean;
+    totalRows: z.ZodNumber;
+    validRows: z.ZodNumber;
+    invalidRows: z.ZodNumber;
+    duplicateRows: z.ZodNumber;
+    emptyRows: z.ZodNumber;
+    createdCount: z.ZodNumber;
+    updatedCount: z.ZodNumber;
+    skippedCount: z.ZodNumber;
+    unknownMetadata: z.ZodArray<z.ZodObject<{
+        typeKey: z.ZodString;
+        values: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    ignoredColumns: z.ZodArray<z.ZodString>;
+    ignoredSheets: z.ZodArray<z.ZodString>;
+    uploadedBy: z.ZodUUID;
+    expiresAt: z.ZodISODateTime;
+    committedAt: z.ZodNullable<z.ZodISODateTime>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type FoodImportBatchResponse = z.output<typeof foodImportBatchResponseSchema>;
+export declare const foodImportRowResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    rowNumber: z.ZodNumber;
+    status: z.ZodEnum<{
+        valid: "valid";
+        invalid: "invalid";
+        duplicate_in_file: "duplicate_in_file";
+        duplicate_existing: "duplicate_existing";
+    }>;
+    raw: z.ZodRecord<z.ZodString, z.ZodString>;
+    parsed: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        nameHi: z.ZodNullable<z.ZodString>;
+        namePa: z.ZodNullable<z.ZodString>;
+        englishAlias: z.ZodNullable<z.ZodString>;
+        category: z.ZodString;
+        subcategory: z.ZodNullable<z.ZodString>;
+        servingLabel: z.ZodString;
+        servingQuantity: z.ZodNumber;
+        servingUnit: z.ZodEnum<{
+            g: "g";
+            ml: "ml";
+        }>;
+        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>;
+        tags: z.ZodArray<z.ZodString>;
+        mealTimings: z.ZodArray<z.ZodString>;
+        notes: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    issues: z.ZodArray<z.ZodObject<{
+        column: z.ZodNullable<z.ZodString>;
+        code: z.ZodString;
+        message: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+    }, z.core.$strip>>;
+    matchedFoodId: z.ZodNullable<z.ZodUUID>;
+    resultFoodId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;
+export type FoodImportRowResponse = z.output<typeof foodImportRowResponseSchema>;

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

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foodImportRowResponseSchema = exports.foodImportBatchResponseSchema = exports.foodImportIssueSchema = exports.foodImportRowsQuerySchema = exports.foodImportListQuerySchema = exports.commitFoodImportSchema = exports.foodImportRowSchema = exports.importIdParamSchema = exports.FOOD_IMPORT_LIMITS = 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 food_dto_js_1 = require("./food.dto.js");
+const nutrition_js_1 = require("./nutrition.js");
+/** The file limits the API enforces, shared so the upload screen can say them up front. */
+exports.FOOD_IMPORT_LIMITS = {
+    maxFileBytes: 2 * 1024 * 1024,
+    maxRows: 5000,
+    extensions: ['.csv', '.xlsx'],
+};
+exports.importIdParamSchema = zod_1.z.uuid();
+const metadataKeyListSchema = zod_1.z.array(zod_1.z.string().min(1).max(60)).max(50);
+/**
+ * One spreadsheet row after its cells are read. Values per 100 g (or per 100 ml
+ * for a serving in ml). Metadata are keys such as `protein` or `high-protein`,
+ * matched to the library's values. Has no defaults, so it also serves as the
+ * preview response.
+ */
+exports.foodImportRowSchema = zod_1.z
+    .strictObject({
+    name: (0, safe_text_schema_js_1.safeTextSchema)(food_dto_js_1.MAX_FOOD_NAME_LENGTH),
+    nameHi: (0, safe_text_schema_js_1.safeTextSchema)(food_dto_js_1.MAX_FOOD_NAME_LENGTH).nullable(),
+    namePa: (0, safe_text_schema_js_1.safeTextSchema)(food_dto_js_1.MAX_FOOD_NAME_LENGTH).nullable(),
+    englishAlias: (0, safe_text_schema_js_1.safeTextSchema)(200).nullable(),
+    category: zod_1.z.string().min(1).max(60),
+    subcategory: zod_1.z.string().min(1).max(60).nullable(),
+    servingLabel: (0, safe_text_schema_js_1.safeTextSchema)(food_dto_js_1.MAX_FOOD_NAME_LENGTH),
+    servingQuantity: (0, nutrition_js_1.quantitySchema)(),
+    servingUnit: zod_1.z.enum(index_js_1.SERVING_UNITS),
+    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(),
+    fiber: (0, nutrition_js_1.nutrientAmountSchema)().nullable(),
+    solubleFiber: (0, nutrition_js_1.nutrientAmountSchema)().nullable(),
+    insolubleFiber: (0, nutrition_js_1.nutrientAmountSchema)().nullable(),
+    tags: metadataKeyListSchema,
+    mealTimings: metadataKeyListSchema,
+    notes: (0, safe_text_schema_js_1.safeTextSchema)(food_dto_js_1.MAX_FOOD_NOTES_LENGTH).nullable(),
+})
+    .superRefine((row, ctx) => {
+    for (const issue of (0, nutrition_js_1.nutritionIssues)(row)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: issue.message,
+            path: [issue.path],
+        });
+    }
+});
+exports.commitFoodImportSchema = zod_1.z.strictObject({
+    mode: zod_1.z.enum(index_js_1.FOOD_IMPORT_MODES).default('SKIP_DUPLICATES'),
+    /** Create categories, tags and other values the file uses but the library lacks. */
+    createMissingMetadata: zod_1.z.boolean().default(false),
+});
+exports.foodImportListQuerySchema = pagination_schema_js_1.paginationQuerySchema;
+exports.foodImportRowsQuerySchema = pagination_schema_js_1.paginationQuerySchema.extend({
+    status: zod_1.z.enum(index_js_1.FOOD_IMPORT_ROW_STATUSES).optional(),
+});
+// Responses
+exports.foodImportIssueSchema = zod_1.z.object({
+    /** The spreadsheet column, or null for a problem with the whole row. */
+    column: zod_1.z.string().nullable(),
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    severity: zod_1.z.enum(index_js_1.FOOD_IMPORT_ISSUE_SEVERITIES),
+});
+exports.foodImportBatchResponseSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    fileName: zod_1.z.string(),
+    fileType: zod_1.z.enum(index_js_1.FOOD_IMPORT_FILE_TYPES),
+    sheetName: zod_1.z.string().nullable(),
+    status: zod_1.z.enum(index_js_1.FOOD_IMPORT_STATUSES),
+    mode: zod_1.z.enum(index_js_1.FOOD_IMPORT_MODES).nullable(),
+    createMissingMetadata: zod_1.z.boolean(),
+    totalRows: zod_1.z.number().int(),
+    validRows: zod_1.z.number().int(),
+    invalidRows: zod_1.z.number().int(),
+    duplicateRows: zod_1.z.number().int(),
+    emptyRows: zod_1.z.number().int(),
+    createdCount: zod_1.z.number().int(),
+    updatedCount: zod_1.z.number().int(),
+    skippedCount: zod_1.z.number().int(),
+    /** Values the file uses that the library does not have yet, by type key. */
+    unknownMetadata: zod_1.z.array(zod_1.z.object({ typeKey: zod_1.z.string(), values: zod_1.z.array(zod_1.z.string()) })),
+    ignoredColumns: zod_1.z.array(zod_1.z.string()),
+    ignoredSheets: zod_1.z.array(zod_1.z.string()),
+    uploadedBy: zod_1.z.uuid(),
+    expiresAt: date_time_schema_js_1.utcTimestampSchema,
+    committedAt: date_time_schema_js_1.utcTimestampSchema.nullable(),
+    createdAt: date_time_schema_js_1.utcTimestampSchema,
+});
+exports.foodImportRowResponseSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    /** The row number as the spreadsheet shows it, counting the header as row 1. */
+    rowNumber: zod_1.z.number().int(),
+    status: zod_1.z.enum(index_js_1.FOOD_IMPORT_ROW_STATUSES),
+    /** The cells as read, by header. */
+    raw: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+    parsed: exports.foodImportRowSchema.nullable(),
+    issues: zod_1.z.array(exports.foodImportIssueSchema),
+    matchedFoodId: zod_1.z.uuid().nullable(),
+    resultFoodId: zod_1.z.uuid().nullable(),
+});