@aibrains/shared-types 0.1.0

package/dist/schemas/identity/user.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.schema.d.ts","sourceRoot":"","sources":["../../../src/schemas/identity/user.schema.ts"],"names":[],"mappings":"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"}

package/dist/schemas/identity/user.schema.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * User Schemas - Identity Service
+ *
+ * Zod schemas for user management DTOs.
+ * Single source of truth for user data shapes used by both frontend and backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currentUserProfileSchema = exports.userAssignmentsResponseSchema = exports.schoolAssignmentSchema = exports.schoolRoleSchema = exports.userPreferencesResponseSchema = exports.updatePreferencesSchema = exports.weekStartSchema = exports.timeFormatSchema = exports.themeSchema = exports.flatNotificationsSchema = exports.notificationPreferencesSchema = exports.notificationCategoriesSchema = exports.notificationChannelsSchema = exports.smsChannelSchema = exports.pushChannelSchema = exports.emailChannelSchema = exports.digestFrequencySchema = exports.userListResponseSchema = exports.userResponseSchema = exports.updateUserSchema = exports.createUserSchema = exports.userAddressSchema = exports.userStatusUpdateSchema = exports.userStatusSchema = exports.globalRoleSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("../common");
+const staff_schema_1 = require("./staff.schema");
+// ============================================
+// Enums
+// ============================================
+exports.globalRoleSchema = zod_1.z.enum(['TenantAdmin', 'TenantUser']);
+exports.userStatusSchema = zod_1.z.enum(['active', 'inactive', 'pending', 'suspended', 'locked']);
+exports.userStatusUpdateSchema = zod_1.z.enum(['active', 'inactive', 'suspended']);
+// ============================================
+// Address Schema
+// ============================================
+exports.userAddressSchema = zod_1.z.object({
+    street: zod_1.z.string().max(100).optional(),
+    street2: zod_1.z.string().max(100).optional(),
+    city: zod_1.z.string().max(50).optional(),
+    state: zod_1.z.string().max(50).optional(),
+    postalCode: zod_1.z.string().max(20).optional(),
+    country: zod_1.z.string().max(50).optional(),
+});
+// ============================================
+// Create User Schema
+// ============================================
+exports.createUserSchema = zod_1.z.object({
+    email: common_1.emailSchema,
+    firstName: zod_1.z.string().min(2).max(50),
+    lastName: zod_1.z.string().min(2).max(50),
+    middleName: zod_1.z.string().max(50).optional(),
+    phone: zod_1.z.string().max(30).optional(),
+    globalRole: exports.globalRoleSchema.default('TenantUser').optional(),
+    temporaryPassword: zod_1.z.string().min(8).optional(),
+    // Staff bridge fields — when present, auto-creates a linked Staff record
+    schoolId: zod_1.z.string().uuid().optional(),
+    staffRole: staff_schema_1.staffRoleSchema.optional(),
+    department: zod_1.z.string().max(100).optional(),
+});
+// ============================================
+// Update User Schema
+// ============================================
+exports.updateUserSchema = zod_1.z.object({
+    firstName: zod_1.z.string().min(2).max(50).optional(),
+    lastName: zod_1.z.string().min(2).max(50).optional(),
+    middleName: zod_1.z.string().max(50).optional(),
+    displayName: zod_1.z.string().max(100).optional(),
+    phone: zod_1.z.string().max(30).optional(),
+    avatarUrl: common_1.urlSchema.optional(),
+    address: exports.userAddressSchema.optional(),
+    status: exports.userStatusUpdateSchema.optional(),
+});
+// ============================================
+// User Response Schema
+// ============================================
+exports.userResponseSchema = zod_1.z.object({
+    userId: zod_1.z.string(),
+    staffId: zod_1.z.string().uuid().optional(),
+    email: zod_1.z.string().email(),
+    firstName: zod_1.z.string(),
+    lastName: zod_1.z.string(),
+    middleName: zod_1.z.string().optional(),
+    displayName: zod_1.z.string().optional(),
+    phone: zod_1.z.string().optional(),
+    avatarUrl: zod_1.z.string().optional(),
+    address: exports.userAddressSchema.optional(),
+    globalRole: exports.globalRoleSchema,
+    status: exports.userStatusSchema,
+    lastLoginAt: common_1.isoDateSchema.optional(),
+    mfaEnabled: zod_1.z.boolean().optional(),
+    createdAt: common_1.isoDateSchema,
+    updatedAt: common_1.isoDateSchema,
+});
+// ============================================
+// User List Response Schema
+// ============================================
+exports.userListResponseSchema = (0, common_1.createPaginatedResponseSchema)(exports.userResponseSchema);
+// ============================================
+// Notification Schemas
+// ============================================
+exports.digestFrequencySchema = zod_1.z.enum(['immediate', 'daily', 'weekly', 'never']);
+exports.emailChannelSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(true).optional(),
+    digest: exports.digestFrequencySchema.default('immediate').optional(),
+});
+exports.pushChannelSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(true).optional(),
+});
+exports.smsChannelSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(false).optional(),
+    phone: zod_1.z.string().optional(),
+});
+exports.notificationChannelsSchema = zod_1.z.object({
+    email: exports.emailChannelSchema.optional(),
+    push: exports.pushChannelSchema.optional(),
+    sms: exports.smsChannelSchema.optional(),
+});
+exports.notificationCategoriesSchema = zod_1.z.object({
+    announcements: zod_1.z.boolean().default(true).optional(),
+    attendance: zod_1.z.boolean().default(true).optional(),
+    grades: zod_1.z.boolean().default(true).optional(),
+    messages: zod_1.z.boolean().default(true).optional(),
+    calendar: zod_1.z.boolean().default(true).optional(),
+    billing: zod_1.z.boolean().default(true).optional(),
+    security: zod_1.z.boolean().default(true).optional(), // Cannot be disabled
+});
+exports.notificationPreferencesSchema = zod_1.z.object({
+    channels: exports.notificationChannelsSchema.optional(),
+    categories: exports.notificationCategoriesSchema.optional(),
+});
+// Flat notification structure for updates (frontend-aligned)
+exports.flatNotificationsSchema = zod_1.z.object({
+    email: zod_1.z.boolean().optional(),
+    push: zod_1.z.boolean().optional(),
+    sms: zod_1.z.boolean().optional(),
+    digest: exports.digestFrequencySchema.optional(),
+});
+// ============================================
+// User Preferences Schemas
+// ============================================
+exports.themeSchema = zod_1.z.enum(['light', 'dark', 'system']);
+exports.timeFormatSchema = zod_1.z.enum(['12h', '24h']);
+exports.weekStartSchema = zod_1.z.enum(['sunday', 'monday']);
+exports.updatePreferencesSchema = zod_1.z.object({
+    theme: exports.themeSchema.default('system').optional(),
+    language: zod_1.z.string().default('en-US').optional(),
+    timezone: zod_1.z.string().default('America/New_York').optional(),
+    dateFormat: zod_1.z.string().default('MM/DD/YYYY').optional(),
+    timeFormat: exports.timeFormatSchema.default('12h').optional(),
+    weekStartsOn: exports.weekStartSchema.default('sunday').optional(),
+    notifications: exports.flatNotificationsSchema.optional(),
+    defaultSchoolId: zod_1.z.string().optional(),
+});
+exports.userPreferencesResponseSchema = zod_1.z.object({
+    tenantId: zod_1.z.string(),
+    userId: zod_1.z.string(),
+    theme: exports.themeSchema,
+    language: zod_1.z.string(),
+    timezone: zod_1.z.string(),
+    dateFormat: zod_1.z.string(),
+    timeFormat: exports.timeFormatSchema,
+    weekStartsOn: exports.weekStartSchema,
+    notifications: exports.flatNotificationsSchema,
+    defaultSchoolId: zod_1.z.string().optional(),
+    createdAt: common_1.isoDateSchema,
+    updatedAt: common_1.isoDateSchema,
+    version: zod_1.z.number().int().min(0),
+});
+// ============================================
+// School Assignment Schemas
+// ============================================
+exports.schoolRoleSchema = zod_1.z.enum([
+    'Principal',
+    'VicePrincipal',
+    'Teacher',
+    'Accountant',
+    'Staff',
+    'Counselor',
+    'Nurse',
+    'Student',
+    'Parent',
+]);
+exports.schoolAssignmentSchema = zod_1.z.object({
+    schoolId: zod_1.z.string(),
+    schoolName: zod_1.z.string(),
+    role: zod_1.z.string(), // Allow any string to support custom roles
+});
+exports.userAssignmentsResponseSchema = zod_1.z.object({
+    userId: zod_1.z.string(),
+    assignments: zod_1.z.array(exports.schoolAssignmentSchema),
+});
+// ============================================
+// Current User Profile Schema (GET /users/me)
+// ============================================
+exports.currentUserProfileSchema = zod_1.z.object({
+    userId: zod_1.z.string(),
+    email: zod_1.z.string().email(),
+    firstName: zod_1.z.string(),
+    lastName: zod_1.z.string(),
+    middleName: zod_1.z.string().optional(),
+    displayName: zod_1.z.string().optional(),
+    phone: zod_1.z.string().optional(),
+    avatarUrl: zod_1.z.string().optional(),
+    address: exports.userAddressSchema.optional(),
+    globalRole: exports.globalRoleSchema,
+    status: exports.userStatusSchema,
+    tenantId: zod_1.z.string(),
+    tenantName: zod_1.z.string().optional(),
+    assignments: zod_1.z.array(exports.schoolAssignmentSchema),
+    lastLoginAt: common_1.isoDateSchema.optional(),
+    mfaEnabled: zod_1.z.boolean().optional(),
+    createdAt: common_1.isoDateSchema,
+    updatedAt: common_1.isoDateSchema,
+});
+//# sourceMappingURL=user.schema.js.map

package/dist/schemas/identity/user.schema.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Schemas Index
+ *
+ * Re-exports all Zod schemas and their inferred types
+ */
+export * from './common';
+export * from './identity';
+export * from './academics';
+export * from './enrollment';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Schemas Index
+ *
+ * Re-exports all Zod schemas and their inferred types
+ */
+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("./common"), exports);
+__exportStar(require("./identity"), exports);
+__exportStar(require("./academics"), exports);
+__exportStar(require("./enrollment"), exports);
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B"}

package/dist/validators/academic-year.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Academic Year Validators
+ *
+ * Status transitions and business rule validators for academic years.
+ */
+import { z } from 'zod';
+import { type AcademicYearStatus } from '../schemas/identity/academic-year.schema';
+export { academicYearStatusSchema } from '../schemas/identity/academic-year.schema';
+export declare const ACADEMIC_YEAR_STATUSES: readonly ["planning", "active", "completed", "archived"];
+export type AcademicYearStatusType = AcademicYearStatus;
+/**
+ * Status display names
+ */
+export declare const ACADEMIC_YEAR_STATUS_NAMES: Record<AcademicYearStatusType, string>;
+/**
+ * Status descriptions
+ */
+export declare const ACADEMIC_YEAR_STATUS_DESCRIPTIONS: Record<AcademicYearStatusType, string>;
+/**
+ * Check if a status transition is valid
+ */
+export declare function isValidStatusTransition(from: AcademicYearStatusType, to: AcademicYearStatusType): boolean;
+/**
+ * Get the list of valid next statuses from current status
+ */
+export declare function getNextValidStatuses(current: AcademicYearStatusType): AcademicYearStatusType[];
+/**
+ * Check if settings can be modified in the given status
+ */
+export declare function canModifySettings(status: AcademicYearStatusType): boolean;
+/**
+ * Check if the academic year is currently active (data is being recorded)
+ */
+export declare function isYearActive(status: AcademicYearStatusType): boolean;
+/**
+ * Check if the academic year is finalized (completed or archived)
+ */
+export declare function isYearFinalized(status: AcademicYearStatusType): boolean;
+/**
+ * Get the display name for a status
+ */
+export declare function getStatusDisplayName(status: AcademicYearStatusType): string;
+/**
+ * Get the description for a status
+ */
+export declare function getStatusDescription(status: AcademicYearStatusType): string;
+/**
+ * Settings that are locked when academic year is active or completed
+ */
+export declare const LOCKED_SETTINGS_WHEN_ACTIVE: readonly ["startDate", "endDate", "gradingPeriods", "calendarType"];
+/**
+ * Settings that are always modifiable (even when active)
+ */
+export declare const ALWAYS_MODIFIABLE_SETTINGS: readonly ["name", "description", "holidays"];
+export type LockedSetting = typeof LOCKED_SETTINGS_WHEN_ACTIVE[number];
+export type ModifiableSetting = typeof ALWAYS_MODIFIABLE_SETTINGS[number];
+/**
+ * Check if a specific setting can be modified given the current status
+ */
+export declare function canModifySetting(setting: string, status: AcademicYearStatusType): boolean;
+/**
+ * Generate a standard academic year name (e.g., "2024-2025")
+ */
+export declare function generateAcademicYearName(startYear: number): string;
+/**
+ * Parse an academic year name to get the start year
+ */
+export declare function parseAcademicYearName(name: string): number | null;
+/**
+ * Validate an academic year name format
+ */
+export declare function isValidAcademicYearName(name: string): boolean;
+export declare const statusTransitionSchema: z.ZodEffects<z.ZodObject<{
+    currentStatus: z.ZodEnum<["planning", "active", "completed", "archived"]>;
+    newStatus: z.ZodEnum<["planning", "active", "completed", "archived"]>;
+}, "strip", z.ZodTypeAny, {
+    currentStatus: "active" | "archived" | "planning" | "completed";
+    newStatus: "active" | "archived" | "planning" | "completed";
+}, {
+    currentStatus: "active" | "archived" | "planning" | "completed";
+    newStatus: "active" | "archived" | "planning" | "completed";
+}>, {
+    currentStatus: "active" | "archived" | "planning" | "completed";
+    newStatus: "active" | "archived" | "planning" | "completed";
+}, {
+    currentStatus: "active" | "archived" | "planning" | "completed";
+    newStatus: "active" | "archived" | "planning" | "completed";
+}>;
+export type StatusTransition = z.infer<typeof statusTransitionSchema>;
+//# sourceMappingURL=academic-year.d.ts.map

package/dist/validators/academic-year.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"academic-year.d.ts","sourceRoot":"","sources":["../../src/validators/academic-year.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAMpF,eAAO,MAAM,sBAAsB,0DAA2D,CAAC;AAC/F,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAiBxD;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAK7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAKpF,CAAC;AAMF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,sBAAsB,EAC5B,EAAE,EAAE,sBAAsB,GACzB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAE9F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAE3E;AAMD;;GAEG;AACH,eAAO,MAAM,2BAA2B,qEAK9B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,0BAA0B,8CAI7B,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAuBT;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ7D;AAMD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAQlC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/validators/academic-year.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Academic Year Validators
+ *
+ * Status transitions and business rule validators for academic years.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusTransitionSchema = exports.ALWAYS_MODIFIABLE_SETTINGS = exports.LOCKED_SETTINGS_WHEN_ACTIVE = exports.ACADEMIC_YEAR_STATUS_DESCRIPTIONS = exports.ACADEMIC_YEAR_STATUS_NAMES = exports.ACADEMIC_YEAR_STATUSES = exports.academicYearStatusSchema = void 0;
+exports.isValidStatusTransition = isValidStatusTransition;
+exports.getNextValidStatuses = getNextValidStatuses;
+exports.canModifySettings = canModifySettings;
+exports.isYearActive = isYearActive;
+exports.isYearFinalized = isYearFinalized;
+exports.getStatusDisplayName = getStatusDisplayName;
+exports.getStatusDescription = getStatusDescription;
+exports.canModifySetting = canModifySetting;
+exports.generateAcademicYearName = generateAcademicYearName;
+exports.parseAcademicYearName = parseAcademicYearName;
+exports.isValidAcademicYearName = isValidAcademicYearName;
+const zod_1 = require("zod");
+const academic_year_schema_1 = require("../schemas/identity/academic-year.schema");
+// Re-export the canonical schema from identity for convenience
+var academic_year_schema_2 = require("../schemas/identity/academic-year.schema");
+Object.defineProperty(exports, "academicYearStatusSchema", { enumerable: true, get: function () { return academic_year_schema_2.academicYearStatusSchema; } });
+// ============================================
+// Academic Year Status
+// ============================================
+exports.ACADEMIC_YEAR_STATUSES = ['planning', 'active', 'completed', 'archived'];
+// ============================================
+// Status Transitions
+// ============================================
+/**
+ * Valid status transitions for academic years
+ * Key: current status, Value: array of valid next statuses
+ */
+const VALID_STATUS_TRANSITIONS = {
+    planning: ['active'],
+    active: ['completed'],
+    completed: ['archived'],
+    archived: [],
+};
+/**
+ * Status display names
+ */
+exports.ACADEMIC_YEAR_STATUS_NAMES = {
+    planning: 'Planning',
+    active: 'Active',
+    completed: 'Completed',
+    archived: 'Archived',
+};
+/**
+ * Status descriptions
+ */
+exports.ACADEMIC_YEAR_STATUS_DESCRIPTIONS = {
+    planning: 'Academic year is being configured. Settings can be freely modified.',
+    active: 'Academic year is in progress. Some settings are locked.',
+    completed: 'Academic year has ended. Data is read-only.',
+    archived: 'Academic year is archived. May be hidden from default views.',
+};
+// ============================================
+// Utility Functions
+// ============================================
+/**
+ * Check if a status transition is valid
+ */
+function isValidStatusTransition(from, to) {
+    var _a, _b;
+    return (_b = (_a = VALID_STATUS_TRANSITIONS[from]) === null || _a === void 0 ? void 0 : _a.includes(to)) !== null && _b !== void 0 ? _b : false;
+}
+/**
+ * Get the list of valid next statuses from current status
+ */
+function getNextValidStatuses(current) {
+    var _a;
+    return (_a = VALID_STATUS_TRANSITIONS[current]) !== null && _a !== void 0 ? _a : [];
+}
+/**
+ * Check if settings can be modified in the given status
+ */
+function canModifySettings(status) {
+    return status === 'planning';
+}
+/**
+ * Check if the academic year is currently active (data is being recorded)
+ */
+function isYearActive(status) {
+    return status === 'active';
+}
+/**
+ * Check if the academic year is finalized (completed or archived)
+ */
+function isYearFinalized(status) {
+    return status === 'completed' || status === 'archived';
+}
+/**
+ * Get the display name for a status
+ */
+function getStatusDisplayName(status) {
+    return exports.ACADEMIC_YEAR_STATUS_NAMES[status];
+}
+/**
+ * Get the description for a status
+ */
+function getStatusDescription(status) {
+    return exports.ACADEMIC_YEAR_STATUS_DESCRIPTIONS[status];
+}
+// ============================================
+// Temporal Lock Constraint
+// ============================================
+/**
+ * Settings that are locked when academic year is active or completed
+ */
+exports.LOCKED_SETTINGS_WHEN_ACTIVE = [
+    'startDate',
+    'endDate',
+    'gradingPeriods',
+    'calendarType',
+];
+/**
+ * Settings that are always modifiable (even when active)
+ */
+exports.ALWAYS_MODIFIABLE_SETTINGS = [
+    'name',
+    'description',
+    'holidays',
+];
+/**
+ * Check if a specific setting can be modified given the current status
+ */
+function canModifySetting(setting, status) {
+    // Archived years cannot be modified at all
+    if (status === 'archived') {
+        return false;
+    }
+    // Completed years are mostly read-only
+    if (status === 'completed') {
+        return false;
+    }
+    // Planning status allows all modifications
+    if (status === 'planning') {
+        return true;
+    }
+    // Active status - check if setting is always modifiable
+    if (exports.ALWAYS_MODIFIABLE_SETTINGS.includes(setting)) {
+        return true;
+    }
+    // Active status - check if setting is locked
+    return !exports.LOCKED_SETTINGS_WHEN_ACTIVE.includes(setting);
+}
+// ============================================
+// Academic Year Naming
+// ============================================
+/**
+ * Generate a standard academic year name (e.g., "2024-2025")
+ */
+function generateAcademicYearName(startYear) {
+    return `${startYear}-${startYear + 1}`;
+}
+/**
+ * Parse an academic year name to get the start year
+ */
+function parseAcademicYearName(name) {
+    const match = name.match(/^(\d{4})-(\d{4})$/);
+    if (!match) {
+        return null;
+    }
+    return parseInt(match[1], 10);
+}
+/**
+ * Validate an academic year name format
+ */
+function isValidAcademicYearName(name) {
+    const match = name.match(/^(\d{4})-(\d{4})$/);
+    if (!match) {
+        return false;
+    }
+    const startYear = parseInt(match[1], 10);
+    const endYear = parseInt(match[2], 10);
+    return endYear === startYear + 1;
+}
+// ============================================
+// Zod Schema with Status Transition Validation
+// ============================================
+exports.statusTransitionSchema = zod_1.z.object({
+    currentStatus: academic_year_schema_1.academicYearStatusSchema,
+    newStatus: academic_year_schema_1.academicYearStatusSchema,
+}).refine(data => isValidStatusTransition(data.currentStatus, data.newStatus), data => ({
+    message: `Invalid status transition from "${data.currentStatus}" to "${data.newStatus}". Valid transitions from "${data.currentStatus}": ${getNextValidStatuses(data.currentStatus).join(', ') || 'none'}`,
+}));
+//# sourceMappingURL=academic-year.js.map

package/dist/validators/academic-year.js.map

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