tango-app-api-payment-subscription 3.5.4 → 3.5.6

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tango-app-api-payment-subscription",
-    "version": "3.5.4",
+    "version": "3.5.6",
     "description": "paymentSubscription",
     "main": "index.js",
     "type": "module",
@@ -29,7 +29,7 @@
         "nodemon": "^3.1.0",
         "puppeteer": "^24.41.0",
         "swagger-ui-express": "^5.0.0",
-        "tango-api-schema": "^2.5.77",
+        "tango-api-schema": "^2.6.25",
         "tango-app-api-middleware": "^3.6.18",
         "winston": "^3.12.0",
         "winston-daily-rotate-file": "^5.0.0",

package/scripts/migrate-billing-prorata-pricing.js

@@ -0,0 +1,66 @@
+// One-shot migration: replaces the legacy billing-group proRata values
+// 'before15' → 'flat' and 'after15' → 'prorate'. Idempotent — safe to
+// re-run; rows already on the new values are skipped.
+//
+// Usage:
+//   MONGO_URI="mongodb://..." node scripts/migrate-billing-prorata-pricing.js
+//
+// Sequencing: MUST run BEFORE deploying the tightened schema enum
+// ['prorate','flat'] in tango-api-schema, otherwise updateBillingGroup
+// calls on unmigrated rows will fail Mongoose ValidationError.
+
+import mongoose from 'mongoose';
+import 'dotenv/config';
+
+const NEW_VALUES = [ 'prorate', 'flat' ];
+
+async function run() {
+  const uri = process.env.MONGO_URI;
+  if ( !uri ) {
+    console.error( 'MONGO_URI env var is required' );
+    process.exit( 1 );
+  }
+
+  await mongoose.connect( uri );
+  // strict:false so we don't pin to a specific tango-api-schema version.
+  const Billing = mongoose.model(
+      '_migrateBilling',
+      new mongoose.Schema( {}, { strict: false } ),
+      'billings',
+  );
+
+  // before15 (legacy "full-month for stores active most of the month") → flat
+  const flatResult = await Billing.updateMany(
+      { proRata: 'before15' },
+      { $set: { proRata: 'flat' } },
+  );
+  console.log( `Migrated ${flatResult.modifiedCount} billing group(s) from 'before15' → 'flat'` );
+
+  // after15 (legacy "always actual working days") → prorate
+  const prorateResult = await Billing.updateMany(
+      { proRata: 'after15' },
+      { $set: { proRata: 'prorate' } },
+  );
+  console.log( `Migrated ${prorateResult.modifiedCount} billing group(s) from 'after15' → 'prorate'` );
+
+  // Surface any rows whose proRata is something unexpected (manual review).
+  const stray = await Billing.find(
+      { proRata: { $exists: true, $nin: [ ...NEW_VALUES, null, '' ] } },
+      { _id: 1, clientId: 1, groupName: 1, proRata: 1 },
+  ).limit( 50 ).lean();
+
+  if ( stray.length ) {
+    console.warn( `Found ${stray.length} row(s) with unexpected proRata values:` );
+    stray.forEach( ( s ) => console.warn( '  -', s._id.toString(), s.clientId, s.groupName, '=>', s.proRata ) );
+    console.warn( 'Review these manually before tightening the schema enum.' );
+  } else {
+    console.log( 'No stray proRata values found. Safe to tighten the schema.' );
+  }
+
+  await mongoose.disconnect();
+}
+
+run().catch( ( err ) => {
+  console.error( err );
+  process.exit( 1 );
+} );