support f_ecom_ prefix (organization ID format) in sandbox lookup

Author: clavery

packages/b2c-tooling-sdk/src/operations/ods/sandbox-lookup.ts

@@ -23,6 +23,21 @@ const UUID_REGEX = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
  */
 const FRIENDLY_ID_REGEX = /^([a-z\d]{4})[-_]([a-z\d]+)$/i;
 
+/**
+ * Prefix used in organization ID format (e.g., f_ecom_zzpq_013).
+ */
+const ECOM_PREFIX = 'f_ecom_';
+
+/**
+ * Strips the f_ecom_ prefix if present.
+ */
+function normalizeIdentifier(value: string): string {
+  if (value.toLowerCase().startsWith(ECOM_PREFIX)) {
+    return value.slice(ECOM_PREFIX.length);
+  }
+  return value;
+}
+
 /**
  * Error thrown when a sandbox cannot be found by its friendly identifier.
  */
@@ -58,7 +73,7 @@ export function isUuid(value: string): boolean {
  * @returns true if the value matches the friendly format
  */
 export function isFriendlySandboxId(value: string): boolean {
-  return FRIENDLY_ID_REGEX.test(value);
+  return FRIENDLY_ID_REGEX.test(normalizeIdentifier(value));
 }
 
 /**
@@ -68,7 +83,8 @@ export function isFriendlySandboxId(value: string): boolean {
  * @returns Object with realm and instance, or null if not a valid friendly ID
  */
 export function parseFriendlySandboxId(value: string): {realm: string; instance: string} | null {
-  const match = value.match(FRIENDLY_ID_REGEX);
+  const normalized = normalizeIdentifier(value);
+  const match = normalized.match(FRIENDLY_ID_REGEX);
   if (!match) {
     return null;
   }

packages/b2c-tooling-sdk/test/operations/ods/sandbox-lookup.test.ts

@@ -55,6 +55,12 @@ describe('sandbox-lookup', () => {
       expect(isFriendlySandboxId('a1b2_c3d')).to.be.true;
     });
 
+    it('should return true for friendly IDs with f_ecom_ prefix', () => {
+      expect(isFriendlySandboxId('f_ecom_zzpq_013')).to.be.true;
+      expect(isFriendlySandboxId('f_ecom_abcd_123')).to.be.true;
+      expect(isFriendlySandboxId('F_ECOM_ZZZV_456')).to.be.true;
+    });
+
     it('should return false for invalid friendly IDs', () => {
       expect(isFriendlySandboxId('abc-123')).to.be.false; // realm too short
       expect(isFriendlySandboxId('abcde-123')).to.be.false; // realm too long
@@ -82,6 +88,12 @@ describe('sandbox-lookup', () => {
       expect(result).to.deep.equal({realm: 'abcd', instance: 'xyz'});
     });
 
+    it('should strip f_ecom_ prefix and parse', () => {
+      expect(parseFriendlySandboxId('f_ecom_zzpq_013')).to.deep.equal({realm: 'zzpq', instance: '013'});
+      expect(parseFriendlySandboxId('f_ecom_abcd_123')).to.deep.equal({realm: 'abcd', instance: '123'});
+      expect(parseFriendlySandboxId('F_ECOM_ZZZV_456')).to.deep.equal({realm: 'zzzv', instance: '456'});
+    });
+
     it('should return null for invalid formats', () => {
       expect(parseFriendlySandboxId('abc-123')).to.be.null;
       expect(parseFriendlySandboxId('abcde-123')).to.be.null;
@@ -173,6 +185,23 @@ describe('sandbox-lookup', () => {
       expect(result).to.equal(expectedUuid);
     });
 
+    it('should look up sandbox by friendly ID with f_ecom_ prefix', async () => {
+      const expectedUuid = 'found-uuid-1234-1234-abc123456789';
+
+      server.use(
+        http.get(`${BASE_URL}/sandboxes`, ({request}) => {
+          const url = new URL(request.url);
+          expect(url.searchParams.get('filter_params')).to.equal('realm=zzpq');
+          return HttpResponse.json({
+            data: [{id: expectedUuid, realm: 'zzpq', instance: '013', state: 'started'}],
+          });
+        }),
+      );
+
+      const result = await resolveSandboxId(odsClient, 'f_ecom_zzpq_013');
+      expect(result).to.equal(expectedUuid);
+    });
+
     it('should throw SandboxNotFoundError when sandbox not found', async () => {
       server.use(
         http.get(`${BASE_URL}/sandboxes`, () => {