@unchainedshop/core-enrollments 4.8.17 → 4.8.19

package/lib/migrations/20260625120100-normalize-contact-phone.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationRepository } from '@unchainedshop/mongodb';
+export default function normalizeContactPhone(repository: MigrationRepository): void;

package/lib/migrations/20260625120100-normalize-contact-phone.js

@@ -0,0 +1,27 @@
+import { normalizePhoneNumber } from '@unchainedshop/utils';
+import { EnrollmentsCollection } from "../db/EnrollmentsCollection.js";
+export default function normalizeContactPhone(repository) {
+    repository?.register({
+        id: 20260625120100,
+        name: 'Normalize enrollment.contact.telNumber to E.164 format',
+        up: async ({ logger }) => {
+            const Enrollments = await EnrollmentsCollection(repository.db);
+            const enrollments = await Enrollments.find({ 'contact.telNumber': { $exists: true, $nin: [null, ''] } }, { projection: { _id: true, contact: true, billingAddress: true, countryCode: true } }).toArray();
+            let changed = 0;
+            let skipped = 0;
+            for (const enrollment of enrollments) {
+                const current = enrollment.contact?.telNumber;
+                const defaultCountry = enrollment.billingAddress?.countryCode || enrollment.countryCode;
+                const normalized = normalizePhoneNumber(current, defaultCountry);
+                if (!normalized || normalized === current) {
+                    if (!normalized)
+                        skipped += 1;
+                    continue;
+                }
+                await Enrollments.updateOne({ _id: enrollment._id }, { $set: { 'contact.telNumber': normalized } });
+                changed += 1;
+            }
+            logger?.info(`Normalize enrollment.contact.telNumber: ${changed} updated, ${skipped} left unchanged (unparseable)`);
+        },
+    });
+}

package/lib/module/configureEnrollmentsModule.d.ts

@@ -8,7 +8,7 @@ export interface EnrollmentQuery {
     queryString?: string;
 }
 export declare const buildFindSelector: ({ queryString, status, userId }: EnrollmentQuery) => mongodb.Filter<Enrollment>;
-export declare const configureEnrollmentsModule: ({ db, options: enrollmentOptions, }: ModuleInput<EnrollmentsSettingsOptions>) => Promise<{
+export declare const configureEnrollmentsModule: ({ db, migrationRepository, options: enrollmentOptions, }: ModuleInput<EnrollmentsSettingsOptions>) => Promise<{
     count: (query: EnrollmentQuery) => Promise<number>;
     openEnrollmentWithProduct: ({ productId }: {
         productId: string;
@@ -35,7 +35,7 @@ export declare const configureEnrollmentsModule: ({ db, options: enrollmentOptio
     delete: (enrollmentId: string) => Promise<number>;
     removeEnrollmentPeriodByOrderId: (enrollmentId: string, orderId: string) => Promise<mongodb.WithId<Enrollment> | null>;
     updateBillingAddress: (enrollmentId: string, fieldValue: Address) => Promise<mongodb.WithId<Enrollment> | null>;
-    updateContact: (enrollmentId: string, fieldValue: Contact) => Promise<mongodb.WithId<Enrollment> | null>;
+    updateContact: (enrollmentId: string, contact: Contact) => Promise<mongodb.WithId<Enrollment> | null>;
     updateContext: (enrollmentId: string, fieldValue: any) => Promise<mongodb.WithId<Enrollment> | null>;
     updateDelivery: (enrollmentId: string, fieldValue: {
         deliveryProviderId?: string;

package/lib/module/configureEnrollmentsModule.js

@@ -1,15 +1,24 @@
-import { SortDirection } from '@unchainedshop/utils';
+import { SortDirection, normalizePhoneNumber } from '@unchainedshop/utils';
 import { EnrollmentStatus, } from "../db/EnrollmentsCollection.js";
 import { emit, registerEvents } from '@unchainedshop/events';
 import { generateDbFilterById, buildSortOptions, mongodb, generateDbObjectId, } from '@unchainedshop/mongodb';
 import { EnrollmentsCollection } from "../db/EnrollmentsCollection.js";
 import { enrollmentsSettings } from "../enrollments-settings.js";
+import normalizeContactPhoneMigration from "../migrations/20260625120100-normalize-contact-phone.js";
 const ENROLLMENT_EVENTS = [
     'ENROLLMENT_ADD_PERIOD',
     'ENROLLMENT_CREATE',
     'ENROLLMENT_REMOVE',
     'ENROLLMENT_UPDATE',
 ];
+const normalizeContactPhone = (contact, defaultCountry) => {
+    if (!contact?.telNumber)
+        return contact;
+    return {
+        ...contact,
+        telNumber: normalizePhoneNumber(contact.telNumber, defaultCountry) || contact.telNumber,
+    };
+};
 export const buildFindSelector = ({ queryString, status, userId }) => {
     const selector = {
         deleted: null,
@@ -23,7 +32,8 @@ export const buildFindSelector = ({ queryString, status, userId }) => {
     }
     return selector;
 };
-export const configureEnrollmentsModule = async ({ db, options: enrollmentOptions = {}, }) => {
+export const configureEnrollmentsModule = async ({ db, migrationRepository, options: enrollmentOptions = {}, }) => {
+    normalizeContactPhoneMigration(migrationRepository);
     registerEvents(ENROLLMENT_EVENTS);
     enrollmentsSettings.configureSettings(enrollmentOptions);
     const Enrollments = await EnrollmentsCollection(db);
@@ -153,6 +163,7 @@ export const configureEnrollmentsModule = async ({ db, options: enrollmentOption
                 periods: [],
                 currencyCode,
                 countryCode,
+                contact: normalizeContactPhone(enrollmentData.contact, enrollmentData.billingAddress?.countryCode || countryCode),
                 configuration: enrollmentData.configuration || [],
                 log: [],
             });
@@ -183,7 +194,13 @@ export const configureEnrollmentsModule = async ({ db, options: enrollmentOption
             }, { returnDocument: 'after' });
         },
         updateBillingAddress: updateEnrollmentField('billingAddress'),
-        updateContact: updateEnrollmentField('contact'),
+        updateContact: async (enrollmentId, contact) => {
+            const existing = await Enrollments.findOne(generateDbFilterById(enrollmentId), {
+                projection: { billingAddress: true, countryCode: true },
+            });
+            const defaultCountry = existing?.billingAddress?.countryCode || existing?.countryCode;
+            return updateEnrollmentField('contact')(enrollmentId, normalizeContactPhone(contact, defaultCountry));
+        },
         updateContext: updateEnrollmentField('meta'),
         updateDelivery: updateEnrollmentField('delivery'),
         updatePayment: updateEnrollmentField('payment'),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unchainedshop/core-enrollments",
   "description": "Subscription and recurring billing module for the Unchained Engine",
-  "version": "4.8.17",
+  "version": "4.8.19",
   "main": "lib/enrollments-index.js",
   "types": "lib/enrollments-index.d.ts",
   "type": "module",
@@ -40,7 +40,7 @@
     "@unchainedshop/utils": "^4.8.12"
   },
   "devDependencies": {
-    "@types/node": "^25.0.0",
+    "@types/node": "^26.2.0",
     "typescript": "^5.8.3"
   }
 }