🔄 synced file(s) with circlefin/modularwallets-web-sdk-internal (#18)

synced local file(s) with
[circlefin/modularwallets-web-sdk-internal](https://github.com/circlefin/modularwallets-web-sdk-internal).



<details>
<summary>Changed files</summary>
<ul>
<li>synced local directory <code>packages/</code> with remote directory
<code>packages/</code></li>
</ul>
</details>

---

This PR was created automatically by the
[repo-file-sync-action](https://github.com/BetaHuhn/repo-file-sync-action)
workflow run
[#16598764014](https://github.com/circlefin/modularwallets-web-sdk-internal/actions/runs/16598764014)

Author: circle-github-action-bot

packages/w3s-web-core-sdk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@circle-fin/modular-wallets-core",
   "description": "Serverless Typescript SDK",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",

packages/w3s-web-core-sdk/src/__tests__/utils/rpc/fetchFromApi.test.ts

@@ -21,11 +21,16 @@ import { EIP1193ProviderRpcError } from 'viem'
 import { ResponseError } from 'web3'
 
 import { fetchFromApi } from '../../../utils'
+import { isChromeExtension } from '../../../utils/rpc/isChromeExtension'
 
 jest.mock('uuid', () => ({
   v4: jest.fn().mockReturnValue('mocked-uuid'),
 }))
 
+jest.mock('../../../utils/rpc/isChromeExtension', () => ({
+  isChromeExtension: jest.fn(),
+}))
+
 beforeAll(() => {
   fetchMock.enableMocks()
 })
@@ -133,4 +138,85 @@ describe('Utils > rpc > fetchFromApi', () => {
 
     jest.restoreAllMocks()
   })
+
+  describe('Chrome extension support', () => {
+    const mockIsChromeExtension = isChromeExtension as jest.MockedFunction<
+      typeof isChromeExtension
+    >
+    const originalWindow = global.window
+
+    beforeEach(() => {
+      Object.defineProperty(global, 'window', {
+        value: {
+          location: {
+            hostname: 'test-extension-id',
+          },
+        },
+        writable: true,
+      })
+    })
+
+    afterEach(() => {
+      global.window = originalWindow
+      mockIsChromeExtension.mockReset()
+    })
+
+    it('should use chrome-extension URI format when in Chrome extension context', async () => {
+      mockIsChromeExtension.mockReturnValue(true)
+
+      const mockResponse = { jsonrpc: '2.0', id: 1, result: '0x1' }
+      fetchMock.mockResponseOnce(JSON.stringify(mockResponse), { status: 200 })
+
+      await fetchFromApi(mockClientUrl, mockClientKey, mockPayload)
+
+      const callArgs = fetchMock.mock.calls[0]
+      const requestOptions = callArgs?.[1]
+      const headers = requestOptions?.headers as Record<string, string>
+
+      expect(headers['X-AppInfo']).toContain(
+        'chrome-extension://test-extension-id',
+      )
+    })
+
+    it('should use regular hostname when not in Chrome extension context', async () => {
+      mockIsChromeExtension.mockReturnValue(false)
+
+      const mockResponse = { jsonrpc: '2.0', id: 1, result: '0x1' }
+      fetchMock.mockResponseOnce(JSON.stringify(mockResponse), { status: 200 })
+
+      await fetchFromApi(mockClientUrl, mockClientKey, mockPayload)
+
+      const callArgs = fetchMock.mock.calls[0]
+      const requestOptions = callArgs?.[1]
+      const headers = requestOptions?.headers as Record<string, string>
+      const appInfo = headers['X-AppInfo']
+
+      expect(appInfo).toContain('uri=test-extension-id')
+      expect(appInfo).not.toContain('chrome-extension://')
+    })
+
+    it('should handle unknown hostname gracefully', async () => {
+      mockIsChromeExtension.mockReturnValue(false)
+
+      Object.defineProperty(global, 'window', {
+        value: {
+          location: {
+            hostname: undefined,
+          },
+        },
+        writable: true,
+      })
+
+      const mockResponse = { jsonrpc: '2.0', id: 1, result: '0x1' }
+      fetchMock.mockResponseOnce(JSON.stringify(mockResponse), { status: 200 })
+
+      await fetchFromApi(mockClientUrl, mockClientKey, mockPayload)
+
+      const callArgs = fetchMock.mock.calls[0]
+      const requestOptions = callArgs?.[1]
+      const headers = requestOptions?.headers as Record<string, string>
+
+      expect(headers['X-AppInfo']).toContain('uri=unknown')
+    })
+  })
 })

packages/w3s-web-core-sdk/src/__tests__/utils/rpc/isChromeExtension.test.ts

@@ -0,0 +1,97 @@
+/**
+ * Copyright 2025 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0.
+ *
+ * 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.
+ */
+
+import { isChromeExtension } from '../../../utils'
+
+describe('Utils > rpc > isChromeExtension', () => {
+  const originalWindow = global.window
+  const originalLocation = global.location
+
+  afterEach(() => {
+    global.window = originalWindow
+    global.location = originalLocation
+  })
+
+  it('should return true when in Chrome extension context', () => {
+    Object.defineProperty(global, 'window', {
+      value: {
+        location: {
+          protocol: 'chrome-extension:',
+        },
+      },
+      writable: true,
+    })
+
+    expect(isChromeExtension()).toBe(true)
+  })
+
+  it('should return false when in regular web context', () => {
+    Object.defineProperty(global, 'window', {
+      value: {
+        location: {
+          protocol: 'https:',
+        },
+      },
+      writable: true,
+    })
+
+    expect(isChromeExtension()).toBe(false)
+  })
+
+  it('should return false when in http context', () => {
+    Object.defineProperty(global, 'window', {
+      value: {
+        location: {
+          protocol: 'http:',
+        },
+      },
+      writable: true,
+    })
+
+    expect(isChromeExtension()).toBe(false)
+  })
+
+  it('should return false when window is undefined', () => {
+    Object.defineProperty(global, 'window', {
+      value: undefined,
+      writable: true,
+    })
+
+    expect(isChromeExtension()).toBe(false)
+  })
+
+  it('should return false when window.location is undefined', () => {
+    Object.defineProperty(global, 'window', {
+      value: {},
+      writable: true,
+    })
+
+    expect(isChromeExtension()).toBe(false)
+  })
+
+  it('should return false when protocol is undefined', () => {
+    Object.defineProperty(global, 'window', {
+      value: {
+        location: {},
+      },
+      writable: true,
+    })
+
+    expect(isChromeExtension()).toBe(false)
+  })
+})

packages/w3s-web-core-sdk/src/__tests__/utils/rpc/webAuthnHelpers.test.ts

@@ -0,0 +1,157 @@
+/**
+ * Copyright 2025 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0.
+ *
+ * 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.
+ */
+
+import {
+  adaptCredentialCreationOptions,
+  adaptCredentialRequestOptions,
+} from '../../../utils'
+import { isChromeExtension } from '../../../utils/rpc/isChromeExtension'
+
+jest.mock('../../../utils/rpc/isChromeExtension', () => ({
+  isChromeExtension: jest.fn(),
+}))
+
+describe('Utils > rpc > webAuthnHelpers', () => {
+  const mockIsChromeExtension = isChromeExtension as jest.MockedFunction<
+    typeof isChromeExtension
+  >
+
+  afterEach(() => {
+    mockIsChromeExtension.mockReset()
+  })
+
+  describe('adaptCredentialCreationOptions', () => {
+    const mockCreationOptions: PublicKeyCredentialCreationOptions = {
+      challenge: new Uint8Array([1, 2, 3]),
+      rp: {
+        id: 'example.com',
+        name: 'Example Corp',
+      },
+      user: {
+        id: new Uint8Array([4, 5, 6]),
+        name: 'user@example.com',
+        displayName: 'John Doe',
+      },
+      pubKeyCredParams: [{ alg: -7, type: 'public-key' }],
+      timeout: 60000,
+      attestation: 'direct',
+    }
+
+    it('should return original options when not in Chrome extension', () => {
+      mockIsChromeExtension.mockReturnValue(false)
+
+      const result = adaptCredentialCreationOptions(mockCreationOptions)
+
+      expect(result).toEqual(mockCreationOptions)
+      expect(result.rp.id).toBe('example.com')
+    })
+
+    it('should remove rp.id when in Chrome extension context', () => {
+      mockIsChromeExtension.mockReturnValue(true)
+
+      const result = adaptCredentialCreationOptions(mockCreationOptions)
+
+      expect(result.rp).toEqual({
+        name: 'Example Corp',
+      })
+      expect(result.rp).not.toHaveProperty('id')
+      expect(result.challenge).toEqual(mockCreationOptions.challenge)
+      expect(result.user).toEqual(mockCreationOptions.user)
+    })
+
+    it('should preserve all other properties when removing rp.id', () => {
+      mockIsChromeExtension.mockReturnValue(true)
+
+      const result = adaptCredentialCreationOptions(mockCreationOptions)
+
+      expect(result.challenge).toEqual(mockCreationOptions.challenge)
+      expect(result.user).toEqual(mockCreationOptions.user)
+      expect(result.pubKeyCredParams).toEqual(
+        mockCreationOptions.pubKeyCredParams,
+      )
+      expect(result.timeout).toEqual(mockCreationOptions.timeout)
+      expect(result.attestation).toEqual(mockCreationOptions.attestation)
+    })
+  })
+
+  describe('adaptCredentialRequestOptions', () => {
+    const mockRequestOptions: PublicKeyCredentialRequestOptions = {
+      challenge: new Uint8Array([7, 8, 9]),
+      rpId: 'example.com',
+      allowCredentials: [
+        {
+          id: new Uint8Array([10, 11, 12]),
+          type: 'public-key',
+          transports: ['usb', 'nfc'],
+        },
+      ],
+      timeout: 60000,
+      userVerification: 'preferred',
+    }
+
+    it('should return original options when not in Chrome extension', () => {
+      mockIsChromeExtension.mockReturnValue(false)
+
+      const result = adaptCredentialRequestOptions(mockRequestOptions)
+
+      expect(result).toEqual(mockRequestOptions)
+      expect(result.rpId).toBe('example.com')
+    })
+
+    it('should remove rpId when in Chrome extension context', () => {
+      mockIsChromeExtension.mockReturnValue(true)
+
+      const result = adaptCredentialRequestOptions(mockRequestOptions)
+
+      expect(result).not.toHaveProperty('rpId')
+      expect(result.challenge).toEqual(mockRequestOptions.challenge)
+      expect(result.allowCredentials).toEqual(
+        mockRequestOptions.allowCredentials,
+      )
+    })
+
+    it('should preserve all other properties when removing rpId', () => {
+      mockIsChromeExtension.mockReturnValue(true)
+
+      const result = adaptCredentialRequestOptions(mockRequestOptions)
+
+      expect(result.challenge).toEqual(mockRequestOptions.challenge)
+      expect(result.allowCredentials).toEqual(
+        mockRequestOptions.allowCredentials,
+      )
+      expect(result.timeout).toEqual(mockRequestOptions.timeout)
+      expect(result.userVerification).toEqual(
+        mockRequestOptions.userVerification,
+      )
+    })
+
+    it('should handle options without rpId gracefully', () => {
+      mockIsChromeExtension.mockReturnValue(true)
+
+      const optionsWithoutRpId = {
+        challenge: new Uint8Array([7, 8, 9]),
+        timeout: 60000,
+      } as PublicKeyCredentialRequestOptions
+
+      const result = adaptCredentialRequestOptions(optionsWithoutRpId)
+
+      expect(result).toEqual(optionsWithoutRpId)
+      expect(result).not.toHaveProperty('rpId')
+    })
+  })
+})