@verii/fineract-client 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verii/fineract-client",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Package containing the functions that interact with the fineract system",
   "repository": "https://github.com/LFDT-Verii/core",
   "main": "index.js",
@@ -11,7 +11,7 @@
   "dependencies": {
     "http-errors": "^2.0.1",
     "lodash": "^4.18.1",
-    "@verii/common-functions": "1.2.0"
+    "@verii/common-functions": "1.2.1"
   },
   "devDependencies": {
     "date-fns": "^4.4.0",
@@ -27,8 +27,8 @@
     "globals": "17.7.0",
     "nock": "15.0.0-beta.14",
     "prettier": "3.9.6",
-    "@verii/http-client": "1.2.0",
-    "@verii/test-regexes": "1.2.0"
+    "@verii/http-client": "1.2.1",
+    "@verii/test-regexes": "1.2.1"
   },
   "nx": {
     "tags": [

package/src/build-fineract-external-id.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright 2026 Velocity Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Fineract clients and accounts provisioned before the registrar switched to
+// Mongo organization IDs carry the organization DID as their external ID,
+// with the same "#escrow-account" / "#stakes-account" suffixes.
+const REGISTRAR_ORGANIZATION_PREFIX = 'registrar:org:';
+
+const FINERACT_EXTERNAL_ID_MAX_LENGTH = 100;
+
+const buildFineractExternalId = (organizationId, relativeId = '') => {
+  if (organizationId == null || organizationId === '') {
+    throw new Error(
+      'organizationId is required to build a Fineract external ID',
+    );
+  }
+  const externalId = `${REGISTRAR_ORGANIZATION_PREFIX}${organizationId}${relativeId}`;
+  if (externalId.length > FINERACT_EXTERNAL_ID_MAX_LENGTH) {
+    throw new Error(
+      `Fineract external ID exceeds ${FINERACT_EXTERNAL_ID_MAX_LENGTH} characters: ${externalId}`,
+    );
+  }
+  return externalId;
+};
+
+module.exports = { FINERACT_EXTERNAL_ID_MAX_LENGTH, buildFineractExternalId };

package/src/create-fineract-account.js

@@ -16,13 +16,14 @@
 
 const { createCreditsAccount } = require('./fetchers');
 const { ProductIds } = require('./constants');
+const { buildFineractExternalId } = require('./build-fineract-external-id');
 
 const initCreateFineractAccount =
-  (productId, relativeId) => async (clientId, did, context) => {
+  (productId, relativeId) => async (clientId, organizationId, context) => {
     const { tokenAccountId } = await createCreditsAccount(
       {
         clientId,
-        externalId: `${did}${relativeId}`,
+        externalId: buildFineractExternalId(organizationId, relativeId),
         submittedOnDate: new Date(),
         productId,
       },

package/src/create-fineract-client.js

@@ -19,9 +19,10 @@ const {
   createStakesAccount,
   createEscrowAccount,
 } = require('./create-fineract-account');
+const { buildFineractExternalId } = require('./build-fineract-external-id');
 
 const createFineractClient = async (
-  { profile, didDoc },
+  { _id: organizationId, profile },
   isStakingAccountRequired,
   context,
 ) => {
@@ -37,7 +38,7 @@ const createFineractClient = async (
         {
           fullName: profile.name,
           mobileNumber: '',
-          externalId: didDoc.id,
+          externalId: buildFineractExternalId(organizationId),
           activationDate: now,
           submittedOnDate: now,
         },
@@ -48,14 +49,14 @@ const createFineractClient = async (
 
   const escrowAccountId = await createEscrowAccount(
     clientId,
-    didDoc.id,
+    organizationId,
     context,
   );
 
   if (isStakingAccountRequired) {
     const stakesAccountId = await createStakesAccount(
       clientId,
-      didDoc.id,
+      organizationId,
       context,
     );