@aibrains/shared-types 0.1.0

package/dist/mappers/edfi/staff.mapper.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Staff Ed-Fi Mapper
+ *
+ * Converts EdForge Staff data to Ed-Fi Data Standard format for compliance export.
+ * Ed-Fi Data Standard v6.0: https://docs.ed-fi.org/reference/data-exchange/data-standard/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toEdFiStaff = toEdFiStaff;
+exports.toEdFiStaffAssignment = toEdFiStaffAssignment;
+exports.toEdFiStaffBatch = toEdFiStaffBatch;
+/**
+ * Map gender to Ed-Fi sexDescriptor
+ */
+function mapGenderToEdFi(gender) {
+    const genderMap = {
+        'male': 'uri://ed-fi.org/SexDescriptor#Male',
+        'female': 'uri://ed-fi.org/SexDescriptor#Female',
+        'non_binary': 'uri://ed-fi.org/SexDescriptor#Not Selected',
+        'prefer_not_to_say': 'uri://ed-fi.org/SexDescriptor#Not Selected',
+    };
+    return gender ? genderMap[gender] : undefined;
+}
+/**
+ * Map EdForge staff role to Ed-Fi staffClassificationDescriptor
+ */
+function mapRoleToEdFi(role) {
+    const roleMap = {
+        'teacher': 'uri://ed-fi.org/StaffClassificationDescriptor#Teacher',
+        'principal': 'uri://ed-fi.org/StaffClassificationDescriptor#Principal',
+        'vice_principal': 'uri://ed-fi.org/StaffClassificationDescriptor#Assistant Principal',
+        'counselor': 'uri://ed-fi.org/StaffClassificationDescriptor#Counselor',
+        'librarian': 'uri://ed-fi.org/StaffClassificationDescriptor#Librarians/Media Specialist',
+        'nurse': 'uri://ed-fi.org/StaffClassificationDescriptor#School Nurse',
+        'admin_staff': 'uri://ed-fi.org/StaffClassificationDescriptor#School Administrative Support Staff',
+        'support_staff': 'uri://ed-fi.org/StaffClassificationDescriptor#Support Services Staff',
+        'it_staff': 'uri://ed-fi.org/StaffClassificationDescriptor#Support Services Staff',
+        'substitute': 'uri://ed-fi.org/StaffClassificationDescriptor#Substitute Teacher',
+        'contractor': 'uri://ed-fi.org/StaffClassificationDescriptor#Other',
+    };
+    return roleMap[role] || 'uri://ed-fi.org/StaffClassificationDescriptor#Other';
+}
+/**
+ * Map EdForge employment status to Ed-Fi employmentStatusDescriptor
+ */
+function mapEmploymentStatusToEdFi(status) {
+    const statusMap = {
+        'active': 'uri://ed-fi.org/EmploymentStatusDescriptor#Employed or affiliated with organization',
+        'on_leave': 'uri://ed-fi.org/EmploymentStatusDescriptor#On leave',
+        'suspended': 'uri://ed-fi.org/EmploymentStatusDescriptor#On leave',
+        'terminated': 'uri://ed-fi.org/EmploymentStatusDescriptor#Separated',
+        'retired': 'uri://ed-fi.org/EmploymentStatusDescriptor#Separated',
+        'resigned': 'uri://ed-fi.org/EmploymentStatusDescriptor#Separated',
+    };
+    return statusMap[status] || 'uri://ed-fi.org/EmploymentStatusDescriptor#Other';
+}
+/**
+ * Convert EdForge Staff to Ed-Fi Staff format
+ */
+function toEdFiStaff(staff) {
+    const edfiStaff = {
+        staffUniqueId: staff.staffUniqueId,
+        firstName: staff.firstName,
+        lastSurname: staff.lastSurname,
+        middleName: staff.middleName,
+        generationCodeSuffix: staff.generationCodeSuffix,
+        birthDate: staff.birthDate,
+        hispanicLatinoEthnicity: staff.hispanicLatinoEthnicity,
+        highlyQualifiedTeacher: staff.highlyQualifiedTeacher,
+        yearsOfPriorTeachingExperience: staff.yearsOfPriorTeachingExperience,
+        sexDescriptor: mapGenderToEdFi(staff.gender),
+    };
+    // Map addresses
+    if (staff.addresses && staff.addresses.length > 0) {
+        edfiStaff.addresses = staff.addresses.map(addr => ({
+            addressTypeDescriptor: `uri://ed-fi.org/AddressTypeDescriptor#${addr.addressTypeDescriptor || 'Home'}`,
+            streetNumberName: addr.streetNumberName,
+            apartmentRoomSuiteNumber: addr.apartmentRoomSuiteNumber,
+            city: addr.city || '',
+            stateAbbreviationDescriptor: `uri://ed-fi.org/StateAbbreviationDescriptor#${addr.stateAbbreviationDescriptor || 'XX'}`,
+            postalCode: addr.postalCode || '',
+        }));
+    }
+    // Map email
+    if (staff.email) {
+        edfiStaff.electronicMails = [{
+                electronicMailAddress: staff.email,
+                electronicMailTypeDescriptor: 'uri://ed-fi.org/ElectronicMailTypeDescriptor#Work',
+                primaryEmailAddressIndicator: true,
+            }];
+    }
+    // Map phone
+    if (staff.phone) {
+        edfiStaff.telephones = [{
+                telephoneNumber: staff.phone,
+                telephoneNumberTypeDescriptor: 'uri://ed-fi.org/TelephoneNumberTypeDescriptor#Work',
+                orderOfPriority: 1,
+            }];
+    }
+    // EdForge extension data (for round-trip preservation)
+    edfiStaff._ext = {
+        edforge_staffId: staff.staffId,
+        edforge_tenantId: staff.tenantId,
+        edforge_role: staff.role,
+        edforge_employmentType: staff.employmentType,
+        edforge_employmentStatus: staff.employmentStatus,
+        edforge_hireDate: staff.hireDate,
+        edforge_primarySchoolId: staff.primarySchoolId,
+    };
+    return edfiStaff;
+}
+/**
+ * Convert EdForge Staff School Assignment to Ed-Fi StaffEducationOrganizationAssignmentAssociation
+ */
+function toEdFiStaffAssignment(staff, assignment, schoolEdFiId) {
+    return {
+        staffReference: {
+            staffUniqueId: staff.staffUniqueId,
+        },
+        educationOrganizationReference: {
+            educationOrganizationId: schoolEdFiId,
+        },
+        beginDate: assignment.beginDate,
+        endDate: assignment.endDate,
+        positionTitle: assignment.positionTitle,
+        staffClassificationDescriptor: mapRoleToEdFi(assignment.role),
+        orderOfAssignment: assignment.isPrimary ? 1 : 2,
+        employmentStatusDescriptor: mapEmploymentStatusToEdFi(staff.employmentStatus),
+        fullTimeEquivalency: assignment.fullTimeEquivalency,
+    };
+}
+/**
+ * Batch convert EdForge Staff list to Ed-Fi format
+ */
+function toEdFiStaffBatch(staffList) {
+    return staffList.map(toEdFiStaff);
+}
+//# sourceMappingURL=staff.mapper.js.map

package/dist/mappers/edfi/staff.mapper.js.map

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

package/dist/mappers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mappers Module
+ *
+ * Data transformation utilities for EdForge.
+ */
+export * from './edfi';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mappers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,QAAQ,CAAC"}

package/dist/mappers/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Mappers Module
+ *
+ * Data transformation utilities for EdForge.
+ */
+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("./edfi"), exports);
+//# sourceMappingURL=index.js.map

package/dist/mappers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mappers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,yCAAuB"}