@aibrains/shared-types 0.1.0

package/dist/validators/date-range.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Date Range Validators
+ *
+ * Zod schemas and utilities for date validation.
+ */
+import { z } from 'zod';
+export { dateSchema } from '../schemas/common';
+/**
+ * ISO 8601 datetime string (re-export from common as alias)
+ */
+export declare const datetimeSchema: z.ZodString;
+export declare const dateRangeSchema: z.ZodEffects<z.ZodObject<{
+    startDate: z.ZodEffects<z.ZodString, string, string>;
+    endDate: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>;
+export type DateRange = z.infer<typeof dateRangeSchema>;
+/**
+ * Academic year must be between 120 and 365 days
+ */
+export declare const academicYearDateRangeSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    startDate: z.ZodEffects<z.ZodString, string, string>;
+    endDate: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>;
+export type AcademicYearDateRange = z.infer<typeof academicYearDateRangeSchema>;
+/**
+ * Grading period must be between 7 and 180 days
+ */
+export declare const gradingPeriodDateRangeSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    startDate: z.ZodEffects<z.ZodString, string, string>;
+    endDate: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>, {
+    startDate: string;
+    endDate: string;
+}, {
+    startDate: string;
+    endDate: string;
+}>;
+export type GradingPeriodDateRange = z.infer<typeof gradingPeriodDateRangeSchema>;
+/**
+ * Parse a YYYY-MM-DD string to a Date object
+ */
+export declare function parseDate(dateString: string): Date;
+/**
+ * Format a Date object to YYYY-MM-DD string
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Calculate the number of days between two dates
+ */
+export declare function daysBetween(startDate: string, endDate: string): number;
+/**
+ * Check if a date falls within a date range (inclusive)
+ */
+export declare function isDateInRange(date: string, range: {
+    startDate: string;
+    endDate: string;
+}): boolean;
+/**
+ * Check if two date ranges overlap
+ */
+export declare function doRangesOverlap(range1: {
+    startDate: string;
+    endDate: string;
+}, range2: {
+    startDate: string;
+    endDate: string;
+}): boolean;
+/**
+ * Get today's date in YYYY-MM-DD format
+ */
+export declare function getTodayString(): string;
+/**
+ * Check if a date is in the past
+ */
+export declare function isDateInPast(dateString: string): boolean;
+/**
+ * Check if a date is in the future
+ */
+export declare function isDateInFuture(dateString: string): boolean;
+/**
+ * Add days to a date string
+ */
+export declare function addDays(dateString: string, days: number): string;
+/**
+ * Get the start and end dates for an academic year given a start month and year
+ */
+export declare function getAcademicYearDates(startYear: number, startMonth?: number, // August by default
+durationMonths?: number): {
+    startDate: string;
+    endDate: string;
+};
+/**
+ * Generate grading period dates for an academic year
+ */
+export declare function generateGradingPeriods(academicYearStart: string, academicYearEnd: string, periodsCount: number): Array<{
+    startDate: string;
+    endDate: string;
+    periodNumber: number;
+}>;
+//# sourceMappingURL=date-range.d.ts.map

package/dist/validators/date-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.d.ts","sourceRoot":"","sources":["../../src/validators/date-range.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,cAAc,aAAgB,CAAC;AAM5C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAM3B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAQvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAMhF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;EAQxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAMlF;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAItE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9C,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAU,EAAE,oBAAoB;AAC5C,cAAc,GAAE,MAAW,GAC1B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,MAAM,EACzB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBrE"}

package/dist/validators/date-range.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Date Range Validators
+ *
+ * Zod schemas and utilities for date validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gradingPeriodDateRangeSchema = exports.academicYearDateRangeSchema = exports.dateRangeSchema = exports.datetimeSchema = exports.dateSchema = void 0;
+exports.parseDate = parseDate;
+exports.formatDate = formatDate;
+exports.daysBetween = daysBetween;
+exports.isDateInRange = isDateInRange;
+exports.doRangesOverlap = doRangesOverlap;
+exports.getTodayString = getTodayString;
+exports.isDateInPast = isDateInPast;
+exports.isDateInFuture = isDateInFuture;
+exports.addDays = addDays;
+exports.getAcademicYearDates = getAcademicYearDates;
+exports.generateGradingPeriods = generateGradingPeriods;
+const zod_1 = require("zod");
+const common_1 = require("../schemas/common");
+// Re-export dateSchema from common for convenience
+var common_2 = require("../schemas/common");
+Object.defineProperty(exports, "dateSchema", { enumerable: true, get: function () { return common_2.dateSchema; } });
+/**
+ * ISO 8601 datetime string (re-export from common as alias)
+ */
+exports.datetimeSchema = common_1.isoDateSchema;
+// ============================================
+// Date Range Schema
+// ============================================
+exports.dateRangeSchema = zod_1.z.object({
+    startDate: common_1.dateSchema,
+    endDate: common_1.dateSchema,
+}).refine(data => new Date(data.endDate) >= new Date(data.startDate), { message: 'End date must be on or after start date' });
+// ============================================
+// Academic Year Date Range Schema
+// ============================================
+/**
+ * Academic year must be between 120 and 365 days
+ */
+exports.academicYearDateRangeSchema = exports.dateRangeSchema.refine(data => {
+    const start = new Date(data.startDate);
+    const end = new Date(data.endDate);
+    const days = Math.round((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+    return days >= 120 && days <= 365;
+}, { message: 'Academic year must be between 120 and 365 days' });
+// ============================================
+// Grading Period Date Range Schema
+// ============================================
+/**
+ * Grading period must be between 7 and 180 days
+ */
+exports.gradingPeriodDateRangeSchema = exports.dateRangeSchema.refine(data => {
+    const start = new Date(data.startDate);
+    const end = new Date(data.endDate);
+    const days = Math.round((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+    return days >= 7 && days <= 180;
+}, { message: 'Grading period must be between 7 and 180 days' });
+// ============================================
+// Utility Functions
+// ============================================
+/**
+ * Parse a YYYY-MM-DD string to a Date object
+ */
+function parseDate(dateString) {
+    return new Date(dateString + 'T00:00:00.000Z');
+}
+/**
+ * Format a Date object to YYYY-MM-DD string
+ */
+function formatDate(date) {
+    return date.toISOString().split('T')[0];
+}
+/**
+ * Calculate the number of days between two dates
+ */
+function daysBetween(startDate, endDate) {
+    const start = parseDate(startDate);
+    const end = parseDate(endDate);
+    return Math.round((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24));
+}
+/**
+ * Check if a date falls within a date range (inclusive)
+ */
+function isDateInRange(date, range) {
+    const checkDate = parseDate(date);
+    const start = parseDate(range.startDate);
+    const end = parseDate(range.endDate);
+    return checkDate >= start && checkDate <= end;
+}
+/**
+ * Check if two date ranges overlap
+ */
+function doRangesOverlap(range1, range2) {
+    const start1 = parseDate(range1.startDate);
+    const end1 = parseDate(range1.endDate);
+    const start2 = parseDate(range2.startDate);
+    const end2 = parseDate(range2.endDate);
+    return start1 <= end2 && end1 >= start2;
+}
+/**
+ * Get today's date in YYYY-MM-DD format
+ */
+function getTodayString() {
+    return formatDate(new Date());
+}
+/**
+ * Check if a date is in the past
+ */
+function isDateInPast(dateString) {
+    const date = parseDate(dateString);
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+    return date < today;
+}
+/**
+ * Check if a date is in the future
+ */
+function isDateInFuture(dateString) {
+    const date = parseDate(dateString);
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+    return date > today;
+}
+/**
+ * Add days to a date string
+ */
+function addDays(dateString, days) {
+    const date = parseDate(dateString);
+    date.setDate(date.getDate() + days);
+    return formatDate(date);
+}
+/**
+ * Get the start and end dates for an academic year given a start month and year
+ */
+function getAcademicYearDates(startYear, startMonth = 8, // August by default
+durationMonths = 10) {
+    const startDate = new Date(startYear, startMonth - 1, 1);
+    const endDate = new Date(startYear, startMonth - 1 + durationMonths, 0);
+    return {
+        startDate: formatDate(startDate),
+        endDate: formatDate(endDate),
+    };
+}
+/**
+ * Generate grading period dates for an academic year
+ */
+function generateGradingPeriods(academicYearStart, academicYearEnd, periodsCount) {
+    const totalDays = daysBetween(academicYearStart, academicYearEnd);
+    const daysPerPeriod = Math.floor(totalDays / periodsCount);
+    const periods = [];
+    let currentStart = academicYearStart;
+    for (let i = 0; i < periodsCount; i++) {
+        const isLastPeriod = i === periodsCount - 1;
+        const endDate = isLastPeriod
+            ? academicYearEnd
+            : addDays(currentStart, daysPerPeriod - 1);
+        periods.push({
+            startDate: currentStart,
+            endDate: endDate,
+            periodNumber: i + 1,
+        });
+        if (!isLastPeriod) {
+            currentStart = addDays(endDate, 1);
+        }
+    }
+    return periods;
+}
+//# sourceMappingURL=date-range.js.map

package/dist/validators/date-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range.js","sourceRoot":"","sources":["../../src/validators/date-range.ts"],"names":[],"mappings":"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"}

package/dist/validators/grade-level.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Grade Level Validators
+ *
+ * Constants and validation utilities for grade levels.
+ */
+import { z } from 'zod';
+export declare const GRADE_LEVELS: readonly ["PK", "K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"];
+export type GradeLevel = typeof GRADE_LEVELS[number];
+export declare const GRADE_LEVEL_NAMES: Record<GradeLevel, string>;
+export declare const ELEMENTARY_GRADES: GradeLevel[];
+export declare const MIDDLE_GRADES: GradeLevel[];
+export declare const HIGH_GRADES: GradeLevel[];
+export type GradeLevelGroup = 'elementary' | 'middle' | 'high';
+/**
+ * Grade level enum schema (PK, K, 1-12)
+ * Note: Named with Enum suffix to avoid conflict with identity/department's gradeLevelConfigSchema
+ */
+export declare const gradeLevelEnumSchema: z.ZodEnum<["PK", "K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"]>;
+/**
+ * Grade level range validator schema
+ * Used to validate that start grade is before or equal to end grade
+ */
+export declare const gradeLevelRangeValidatorSchema: z.ZodEffects<z.ZodObject<{
+    start: z.ZodEnum<["PK", "K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"]>;
+    end: z.ZodEnum<["PK", "K", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"]>;
+}, "strip", z.ZodTypeAny, {
+    start: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+    end: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+}, {
+    start: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+    end: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+}>, {
+    start: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+    end: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+}, {
+    start: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+    end: "PK" | "K" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12";
+}>;
+export type GradeLevelRange = z.infer<typeof gradeLevelRangeValidatorSchema>;
+/**
+ * Get the numeric index of a grade level for comparison
+ */
+export declare function getGradeLevelIndex(grade: GradeLevel): number;
+/**
+ * Check if a string is a valid grade level
+ */
+export declare function isValidGradeLevel(grade: string): grade is GradeLevel;
+/**
+ * Get the display name for a grade level
+ */
+export declare function getGradeLevelDisplayName(grade: GradeLevel): string;
+/**
+ * Get the grade level group (elementary, middle, high)
+ */
+export declare function getGradeLevelGroup(grade: GradeLevel): GradeLevelGroup;
+/**
+ * Compare two grade levels
+ * Returns negative if a < b, positive if a > b, 0 if equal
+ */
+export declare function compareGradeLevels(a: GradeLevel, b: GradeLevel): number;
+/**
+ * Get all grade levels within a range (inclusive)
+ */
+export declare function getGradeLevelsInRange(start: GradeLevel, end: GradeLevel): GradeLevel[];
+/**
+ * Check if a grade is within a range
+ */
+export declare function isGradeInRange(grade: GradeLevel, range: {
+    start: GradeLevel;
+    end: GradeLevel;
+}): boolean;
+/**
+ * Get the next grade level, or null if already at 12th grade
+ */
+export declare function getNextGradeLevel(grade: GradeLevel): GradeLevel | null;
+/**
+ * Get the previous grade level, or null if already at PK
+ */
+export declare function getPreviousGradeLevel(grade: GradeLevel): GradeLevel | null;
+//# sourceMappingURL=grade-level.d.ts.map

package/dist/validators/grade-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-level.d.ts","sourceRoot":"","sources":["../../src/validators/grade-level.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,YAAY,qFAef,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAMrD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAexD,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAAyC,CAAC;AACpF,eAAO,MAAM,aAAa,EAAE,UAAU,EAAoB,CAAC;AAC3D,eAAO,MAAM,WAAW,EAAE,UAAU,EAA4B,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAM/D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,uFAAuB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAM1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAM7E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAEpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAIrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,CAStF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,GAC5C,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAM1E"}

package/dist/validators/grade-level.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Grade Level Validators
+ *
+ * Constants and validation utilities for grade levels.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gradeLevelRangeValidatorSchema = exports.gradeLevelEnumSchema = exports.HIGH_GRADES = exports.MIDDLE_GRADES = exports.ELEMENTARY_GRADES = exports.GRADE_LEVEL_NAMES = exports.GRADE_LEVELS = void 0;
+exports.getGradeLevelIndex = getGradeLevelIndex;
+exports.isValidGradeLevel = isValidGradeLevel;
+exports.getGradeLevelDisplayName = getGradeLevelDisplayName;
+exports.getGradeLevelGroup = getGradeLevelGroup;
+exports.compareGradeLevels = compareGradeLevels;
+exports.getGradeLevelsInRange = getGradeLevelsInRange;
+exports.isGradeInRange = isGradeInRange;
+exports.getNextGradeLevel = getNextGradeLevel;
+exports.getPreviousGradeLevel = getPreviousGradeLevel;
+const zod_1 = require("zod");
+// ============================================
+// Grade Level Constants
+// ============================================
+exports.GRADE_LEVELS = [
+    'PK', // Pre-Kindergarten
+    'K', // Kindergarten
+    '1',
+    '2',
+    '3',
+    '4',
+    '5',
+    '6',
+    '7',
+    '8',
+    '9',
+    '10',
+    '11',
+    '12',
+];
+// ============================================
+// Grade Level Display Names
+// ============================================
+exports.GRADE_LEVEL_NAMES = {
+    'PK': 'Pre-Kindergarten',
+    'K': 'Kindergarten',
+    '1': '1st Grade',
+    '2': '2nd Grade',
+    '3': '3rd Grade',
+    '4': '4th Grade',
+    '5': '5th Grade',
+    '6': '6th Grade',
+    '7': '7th Grade',
+    '8': '8th Grade',
+    '9': '9th Grade (Freshman)',
+    '10': '10th Grade (Sophomore)',
+    '11': '11th Grade (Junior)',
+    '12': '12th Grade (Senior)',
+};
+// ============================================
+// Grade Level Groups
+// ============================================
+exports.ELEMENTARY_GRADES = ['PK', 'K', '1', '2', '3', '4', '5'];
+exports.MIDDLE_GRADES = ['6', '7', '8'];
+exports.HIGH_GRADES = ['9', '10', '11', '12'];
+// ============================================
+// Zod Schemas
+// ============================================
+/**
+ * Grade level enum schema (PK, K, 1-12)
+ * Note: Named with Enum suffix to avoid conflict with identity/department's gradeLevelConfigSchema
+ */
+exports.gradeLevelEnumSchema = zod_1.z.enum(exports.GRADE_LEVELS);
+/**
+ * Grade level range validator schema
+ * Used to validate that start grade is before or equal to end grade
+ */
+exports.gradeLevelRangeValidatorSchema = zod_1.z.object({
+    start: exports.gradeLevelEnumSchema,
+    end: exports.gradeLevelEnumSchema,
+}).refine(data => getGradeLevelIndex(data.start) <= getGradeLevelIndex(data.end), { message: 'Start grade must be at or before end grade' });
+// ============================================
+// Utility Functions
+// ============================================
+/**
+ * Get the numeric index of a grade level for comparison
+ */
+function getGradeLevelIndex(grade) {
+    return exports.GRADE_LEVELS.indexOf(grade);
+}
+/**
+ * Check if a string is a valid grade level
+ */
+function isValidGradeLevel(grade) {
+    return exports.GRADE_LEVELS.includes(grade);
+}
+/**
+ * Get the display name for a grade level
+ */
+function getGradeLevelDisplayName(grade) {
+    return exports.GRADE_LEVEL_NAMES[grade];
+}
+/**
+ * Get the grade level group (elementary, middle, high)
+ */
+function getGradeLevelGroup(grade) {
+    if (exports.ELEMENTARY_GRADES.includes(grade))
+        return 'elementary';
+    if (exports.MIDDLE_GRADES.includes(grade))
+        return 'middle';
+    return 'high';
+}
+/**
+ * Compare two grade levels
+ * Returns negative if a < b, positive if a > b, 0 if equal
+ */
+function compareGradeLevels(a, b) {
+    return getGradeLevelIndex(a) - getGradeLevelIndex(b);
+}
+/**
+ * Get all grade levels within a range (inclusive)
+ */
+function getGradeLevelsInRange(start, end) {
+    const startIndex = getGradeLevelIndex(start);
+    const endIndex = getGradeLevelIndex(end);
+    if (startIndex > endIndex) {
+        return [];
+    }
+    return exports.GRADE_LEVELS.slice(startIndex, endIndex + 1);
+}
+/**
+ * Check if a grade is within a range
+ */
+function isGradeInRange(grade, range) {
+    const gradeIndex = getGradeLevelIndex(grade);
+    const startIndex = getGradeLevelIndex(range.start);
+    const endIndex = getGradeLevelIndex(range.end);
+    return gradeIndex >= startIndex && gradeIndex <= endIndex;
+}
+/**
+ * Get the next grade level, or null if already at 12th grade
+ */
+function getNextGradeLevel(grade) {
+    const index = getGradeLevelIndex(grade);
+    if (index >= exports.GRADE_LEVELS.length - 1) {
+        return null;
+    }
+    return exports.GRADE_LEVELS[index + 1];
+}
+/**
+ * Get the previous grade level, or null if already at PK
+ */
+function getPreviousGradeLevel(grade) {
+    const index = getGradeLevelIndex(grade);
+    if (index <= 0) {
+        return null;
+    }
+    return exports.GRADE_LEVELS[index - 1];
+}
+//# sourceMappingURL=grade-level.js.map

package/dist/validators/grade-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade-level.js","sourceRoot":"","sources":["../../src/validators/grade-level.ts"],"names":[],"mappings":"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"}

package/dist/validators/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validators
+ *
+ * Reusable validation utilities and schemas
+ */
+export * from './password';
+export * from './grade-level';
+export * from './date-range';
+export * from './academic-year';
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/validators/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Validators
+ *
+ * Reusable validation utilities and schemas
+ */
+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("./password"), exports);
+__exportStar(require("./grade-level"), exports);
+__exportStar(require("./date-range"), exports);
+__exportStar(require("./academic-year"), exports);
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,gDAA8B;AAC9B,+CAA6B;AAC7B,kDAAgC"}