@xuda.io/account_module 1.2.2271 → 1.2.2273

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xuda.io/account_module",
-  "version": "1.2.2271",
+  "version": "1.2.2273",
   "description": "Xuda Account Server Module",
   "main": "index.mjs",
   "dependencies": {

package/scripts/run_backfill.mjs

@@ -15,11 +15,7 @@
 import path from 'path';
 
 if (!global._conf) {
-  global._conf = (
-    await import(path.join(process.env.XUDA_HOME, process.env.XUDA_CONFIG), {
-      with: { type: 'json' },
-    })
-  ).default;
+  global._conf = (await import(path.join(process.env.XUDA_HOME, "common", "load_conf.mjs"))).loadConf();
 }
 
 const argv = process.argv.slice(2);

package/scripts/run_backfill.mjs.premerge.bak

@@ -0,0 +1,51 @@
+// One-shot backfill runner.
+//
+// Usage (from /var/xuda on dev/prod, with XUDA_HOME and XUDA_CONFIG set
+// the same way the cpi services have them):
+//
+//   node cpi/account_module/scripts/run_backfill.mjs           # full backfill
+//   node cpi/account_module/scripts/run_backfill.mjs --dry-run # compute, don't save
+//   node cpi/account_module/scripts/run_backfill.mjs --limit=5 # first 5 docs only
+//   node cpi/account_module/scripts/run_backfill.mjs --app-id=vps-abc123  # one doc
+//
+// Idempotent — safe to re-run if the first pass errored partway.
+// Each doc with a populated app_cost.last_billed_ts is silently
+// skipped on subsequent runs.
+
+import path from 'path';
+
+if (!global._conf) {
+  global._conf = (
+    await import(path.join(process.env.XUDA_HOME, process.env.XUDA_CONFIG), {
+      with: { type: 'json' },
+    })
+  ).default;
+}
+
+const argv = process.argv.slice(2);
+const opts = {};
+for (const a of argv) {
+  if (a === '--dry-run') opts.dry_run = true;
+  else if (a.startsWith('--limit=')) opts.limit = parseInt(a.split('=')[1], 10);
+  else if (a.startsWith('--app-id=')) opts.app_id = a.split('=')[1];
+  else console.warn(`Unknown arg: ${a}`);
+}
+
+const module_path = path.join(process.env.XUDA_HOME, 'cpi') + (!_conf.is_debug ? '/node_modules/@xuda.io' : '');
+const { backfill_app_costs } = await import(`${module_path}/account_module/index.mjs`);
+
+console.log('Running backfill with opts:', opts);
+const summary = await backfill_app_costs(opts);
+
+const { per_doc, ...headline } = summary;
+console.log('\n=== Backfill summary ===');
+console.log(JSON.stringify(headline, null, 2));
+
+if (per_doc?.length) {
+  const fs = await import('fs');
+  const out = path.join(process.env.XUDA_HOME || process.cwd(), `backfill_app_cost_log_${Date.now()}.json`);
+  fs.writeFileSync(out, JSON.stringify(per_doc, null, 2));
+  console.log(`\nPer-doc log written to: ${out}`);
+}
+
+process.exit(summary.errors?.length ? 1 : 0);

package/scripts/run_migrate_account.mjs

@@ -13,11 +13,7 @@
 import path from 'path';
 
 if (!global._conf) {
-  global._conf = (
-    await import(path.join(process.env.XUDA_HOME, process.env.XUDA_CONFIG), {
-      with: { type: 'json' },
-    })
-  ).default;
+  global._conf = (await import(path.join(process.env.XUDA_HOME, "common", "load_conf.mjs"))).loadConf();
 }
 
 const argv = process.argv.slice(2);

package/scripts/run_migrate_account.mjs.premerge.bak

@@ -0,0 +1,54 @@
+// Migrate a single account from legacy 3-subscription model to the
+// consolidated 1-subscription-with-3-items model.
+//
+// Usage (from /var/xuda on dev/prod, with XUDA_HOME and XUDA_CONFIG set):
+//
+//   node cpi/account_module/scripts/run_migrate_account.mjs --uid=<UID>
+//   node cpi/account_module/scripts/run_migrate_account.mjs --uid=<UID> --dry-run
+//
+// Idempotent — running on an already-consolidated account is a no-op.
+// Use --dry-run first to preview which subs would be cancelled and
+// when the new sub would start billing.
+
+import path from 'path';
+
+if (!global._conf) {
+  global._conf = (
+    await import(path.join(process.env.XUDA_HOME, process.env.XUDA_CONFIG), {
+      with: { type: 'json' },
+    })
+  ).default;
+}
+
+const argv = process.argv.slice(2);
+const opts = {};
+for (const a of argv) {
+  if (a === '--dry-run') opts.dry_run = true;
+  else if (a.startsWith('--uid=')) opts.uid = a.split('=')[1];
+  else console.warn(`Unknown arg: ${a}`);
+}
+
+if (!opts.uid) {
+  console.error('--uid=<UID> is required');
+  process.exit(1);
+}
+
+const module_path = path.join(process.env.XUDA_HOME, 'cpi') + (!_conf.is_debug ? '/node_modules/@xuda.io' : '');
+const { migrate_account_to_consolidated } = await import(`${module_path}/stripe_module/index.mjs`);
+
+console.log(`Migrating account ${opts.uid}${opts.dry_run ? ' (DRY RUN)' : ''}...`);
+const result = await migrate_account_to_consolidated(opts);
+console.log('\n=== Result ===');
+console.log(JSON.stringify(result, null, 2));
+
+if (result.code === 1) {
+  if (opts.dry_run) {
+    console.log('\nDry run complete. Re-run without --dry-run to actually migrate.');
+  } else {
+    console.log(`\n✓ Account ${opts.uid} migrated. New sub will start billing at unix ts ${result.data?.starts_billing_at_unix_ts}.`);
+  }
+  process.exit(0);
+} else {
+  console.error(`\n✗ Migration failed: ${result.data}`);
+  process.exit(1);
+}

package/scripts/run_migrate_all.mjs

@@ -19,11 +19,7 @@
 import path from 'path';
 
 if (!global._conf) {
-  global._conf = (
-    await import(path.join(process.env.XUDA_HOME, process.env.XUDA_CONFIG), {
-      with: { type: 'json' },
-    })
-  ).default;
+  global._conf = (await import(path.join(process.env.XUDA_HOME, "common", "load_conf.mjs"))).loadConf();
 }
 
 const argv = process.argv.slice(2);

package/scripts/run_migrate_all.mjs.premerge.bak

@@ -0,0 +1,109 @@
+// Bulk migrate EVERY account from the legacy 3-subscription model to
+// the consolidated 1-subscription-with-3-items model.
+//
+// Idempotent — accounts already on the consolidated model return
+// "already consolidated" and are skipped silently. Per-account errors
+// don't stop the loop; the summary at the end lists what failed.
+//
+// Usage (from /var/xuda on dev/prod, with XUDA_HOME and XUDA_CONFIG set):
+//
+//   node cpi/account_module/scripts/run_migrate_all.mjs --dry-run
+//   node cpi/account_module/scripts/run_migrate_all.mjs
+//   node cpi/account_module/scripts/run_migrate_all.mjs --limit=5  # canary first N
+//
+// On dev this is fine to run at any time. On prod, prefer the
+// per-account script (run_migrate_account.mjs) or the webhook-driven
+// gradual migration so each customer migrates at their natural
+// cycle boundary.
+
+import path from 'path';
+
+if (!global._conf) {
+  global._conf = (
+    await import(path.join(process.env.XUDA_HOME, process.env.XUDA_CONFIG), {
+      with: { type: 'json' },
+    })
+  ).default;
+}
+
+const argv = process.argv.slice(2);
+const opts = { dry_run: false, limit: null };
+for (const a of argv) {
+  if (a === '--dry-run') opts.dry_run = true;
+  else if (a.startsWith('--limit=')) opts.limit = parseInt(a.split('=')[1], 10);
+  else console.warn(`Unknown arg: ${a}`);
+}
+
+const module_path = path.join(process.env.XUDA_HOME, 'cpi') + (!_conf.is_debug ? '/node_modules/@xuda.io' : '');
+const db_module = await import(`${module_path}/db_module/index.mjs`);
+const { migrate_account_to_consolidated } = await import(`${module_path}/stripe_module/index.mjs`);
+
+console.log(`Bulk migration ${opts.dry_run ? '(DRY RUN)' : ''}${opts.limit ? ` limit=${opts.limit}` : ''}...`);
+
+const accounts_ret = await db_module.get_couch_view_raw('xuda_accounts', 'all_accounts', {});
+const accounts = (accounts_ret?.rows || []).map((r) => r.value).filter((a) => a?._id);
+
+console.log(`Found ${accounts.length} accounts.\n`);
+
+const summary = {
+  scanned: 0,
+  migrated: 0,
+  already: 0,
+  skipped_no_stripe: 0,
+  failed: 0,
+  errors: [],
+  per_account: [],
+};
+
+const todo = opts.limit ? accounts.slice(0, opts.limit) : accounts;
+
+for (const acct of todo) {
+  summary.scanned++;
+
+  // Skip accounts that don't have any Stripe presence yet (e.g.
+  // half-created test accounts) — there's nothing to migrate.
+  if (!acct.stripe_customer_id) {
+    summary.skipped_no_stripe++;
+    summary.per_account.push({ uid: acct._id, action: 'skipped', reason: 'no stripe_customer_id' });
+    continue;
+  }
+
+  try {
+    const result = await migrate_account_to_consolidated({ uid: acct._id, dry_run: opts.dry_run });
+    if (result.code === 1) {
+      const data = result.data || '';
+      const isAlready = typeof data === 'string' && (data.includes('already') || data.includes('reconciled'));
+      if (isAlready) {
+        summary.already++;
+        summary.per_account.push({ uid: acct._id, action: 'already', reason: data });
+      } else {
+        summary.migrated++;
+        summary.per_account.push({ uid: acct._id, action: opts.dry_run ? 'dry-run-ok' : 'migrated', reason: typeof data === 'object' ? `new_sub=${data.new_sub_id} starts=${data.starts_billing_at_unix_ts}` : data });
+      }
+    } else {
+      summary.failed++;
+      summary.errors.push({ uid: acct._id, reason: result.data });
+      summary.per_account.push({ uid: acct._id, action: 'failed', reason: result.data });
+    }
+  } catch (err) {
+    summary.failed++;
+    summary.errors.push({ uid: acct._id, reason: err.message });
+    summary.per_account.push({ uid: acct._id, action: 'errored', reason: err.message });
+  }
+
+  // Tiny gap between accounts so we don't hammer Stripe with bursts.
+  await new Promise((r) => setTimeout(r, 250));
+}
+
+const { per_account, ...headline } = summary;
+console.log('\n=== Bulk migration summary ===');
+console.log(JSON.stringify(headline, null, 2));
+
+if (per_account.length) {
+  const fs = await import('fs');
+  const out = path.join(process.env.XUDA_HOME || process.cwd(), `bulk_migrate_log_${Date.now()}.json`);
+  fs.writeFileSync(out, JSON.stringify(per_account, null, 2));
+  console.log(`\nPer-account log written to: ${out}`);
+}
+
+process.exit(summary.failed ? 1 : 0);