@velocitycareerlabs/vcl-react-native 2.8.2 → 2.9.1

package/lib/typescript/src/index.d.ts

@@ -67,7 +67,8 @@ import { VCLStatusCode } from './api/entities/error/VCLStatusCode';
 import { VCLErrorCode } from './api/entities/error/VCLErrorCode';
 import type { VCLAuthToken } from './api/entities/VCLAuthToken';
 import type { VCLAuthTokenDescriptor } from './api/entities/VCLAuthTokenDescriptor';
+import type { VCLDiagnostics, VCLNativeCauseDiagnostics, VCLErrorInit } from './api/entities/error/VCLError';
 export default VclApi;
 export { VCLEnvironment, VCLCryptoServiceType, VCLSignatureAlgorithm, VCLXVnfProtocolVersion, VCLCountryCodes, VCLServiceType, VCLIssuingType, VCLError, VCLStatusCode, VCLErrorCode, };
-export type { Dictionary, VCLCountry, VCLCountries, VCLRegion, VCLRegions, VCLCredentialManifest, VCLCredentialManifestDescriptor, VCLCredentialManifestDescriptorByDeepLink, VCLCredentialManifestDescriptorByService, VCLCredentialType, VCLCredentialTypes, VCLCredentialTypeSchema, VCLCredentialTypeSchemas, VCLCredentialTypesUIFormSchema, VCLCredentialTypesUIFormSchemaDescriptor, VCLCredentialManifestDescriptorRefresh, VCLDeepLink, VCLExchange, VCLExchangeDescriptor, VCLFilter, VCLFinalizeOffersDescriptor, VCLGenerateOffersDescriptor, VCLJwt, VCLJwtVerifiableCredentials, VCLOffers, VCLOffer, VCLOrganization, VCLOrganizations, VCLOrganizationsSearchDescriptor, VCLPage, VCLPresentationRequest, VCLPresentationSubmission, VCLPublicJwk, VCLPushDelegate, VCLService, VCLServiceTypes, VCLSubmissionResult, VCLToken, VCLVerifiableCredential, VCLVerifiedProfile, VCLVerifiedProfileDescriptor, VCLInitializationDescriptor, VCLPresentationRequestDescriptor, VCLJwtDescriptor, VCLDidJwkDescriptor, VCLDidJwk, VCLCryptoServicesDescriptor, VCLJwtServiceUrls, VCLKeyServiceUrls, VCLRemoteCryptoServicesUrlsDescriptor, VCLAuthToken, VCLAuthTokenDescriptor, };
+export type { Dictionary, VCLCountry, VCLCountries, VCLRegion, VCLRegions, VCLCredentialManifest, VCLCredentialManifestDescriptor, VCLCredentialManifestDescriptorByDeepLink, VCLCredentialManifestDescriptorByService, VCLCredentialType, VCLCredentialTypes, VCLCredentialTypeSchema, VCLCredentialTypeSchemas, VCLCredentialTypesUIFormSchema, VCLCredentialTypesUIFormSchemaDescriptor, VCLCredentialManifestDescriptorRefresh, VCLDeepLink, VCLExchange, VCLExchangeDescriptor, VCLFilter, VCLFinalizeOffersDescriptor, VCLGenerateOffersDescriptor, VCLJwt, VCLJwtVerifiableCredentials, VCLOffers, VCLOffer, VCLOrganization, VCLOrganizations, VCLOrganizationsSearchDescriptor, VCLPage, VCLPresentationRequest, VCLPresentationSubmission, VCLPublicJwk, VCLPushDelegate, VCLService, VCLServiceTypes, VCLSubmissionResult, VCLToken, VCLVerifiableCredential, VCLVerifiedProfile, VCLVerifiedProfileDescriptor, VCLInitializationDescriptor, VCLPresentationRequestDescriptor, VCLJwtDescriptor, VCLDidJwkDescriptor, VCLDidJwk, VCLCryptoServicesDescriptor, VCLJwtServiceUrls, VCLKeyServiceUrls, VCLRemoteCryptoServicesUrlsDescriptor, VCLAuthToken, VCLAuthTokenDescriptor, VCLDiagnostics, VCLNativeCauseDiagnostics, VCLErrorInit, };
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velocitycareerlabs/vcl-react-native",
-  "version": "2.8.2",
+  "version": "2.9.1",
   "description": "Velocity Career Labs React Native SDK",
   "license": "Apache-2.0",
   "publishConfig": {

package/src/api/VCLApi.ts

@@ -39,6 +39,10 @@ import {
   type VCLDidJwkDescriptor,
   VCLError,
 } from '@velocitycareerlabs/vcl-react-native';
+import {
+  BRIDGED_VCL_ERROR_CODE,
+  VCLErrorDeserializer,
+} from './entities/error/VCLErrorDeserializer';
 
 const { VclReactNative } = NativeModules;
 
@@ -49,7 +53,7 @@ export const VclApi = {
     try {
       return await VclReactNative.initialize(initializationDescriptor);
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -57,7 +61,7 @@ export const VclApi = {
     try {
       return await VclReactNative.getCountries();
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -65,7 +69,7 @@ export const VclApi = {
     try {
       return await VclReactNative.getCredentialTypes();
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -73,7 +77,7 @@ export const VclApi = {
     try {
       return await VclReactNative.getCredentialTypeSchemas();
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -85,7 +89,7 @@ export const VclApi = {
         presentationRequestDescriptor
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -99,7 +103,7 @@ export const VclApi = {
         authToken
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -109,7 +113,7 @@ export const VclApi = {
     try {
       return await VclReactNative.getExchangeProgress(exchangeDescriptor);
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -121,7 +125,7 @@ export const VclApi = {
         organizationsSearchDescriptor
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -133,7 +137,7 @@ export const VclApi = {
         credentialManifestDescriptor
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -143,7 +147,7 @@ export const VclApi = {
     try {
       return await VclReactNative.generateOffers(generateOffersDescriptor);
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -157,7 +161,7 @@ export const VclApi = {
         sessionToken
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -171,7 +175,7 @@ export const VclApi = {
         sessionToken
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -181,7 +185,7 @@ export const VclApi = {
     try {
       return await VclReactNative.getAuthToken(authTokenDescriptor);
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -193,7 +197,7 @@ export const VclApi = {
         credentialTypesUIFormSchemaDescriptor
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -203,7 +207,7 @@ export const VclApi = {
     try {
       return await VclReactNative.getVerifiedProfile(verifiedProfileDescriptor);
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -219,7 +223,7 @@ export const VclApi = {
         remoteCryptoServicesToken
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -235,7 +239,7 @@ export const VclApi = {
         remoteCryptoServicesToken
       );
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 
@@ -245,7 +249,43 @@ export const VclApi = {
     try {
       return await VclReactNative.generateDidJwk(didJwkDescriptor);
     } catch (e) {
-      throw new VCLError(e);
+      throw toVCLError(e);
     }
   },
 };
+
+const toVCLError = (error: unknown): VCLError => {
+  if (error instanceof VCLError) {
+    return error;
+  }
+
+  if (isBridgedVCLError(error)) {
+    return VCLErrorDeserializer.fromJsonString(error.message);
+  }
+
+  return new VCLError({ message: toErrorMessage(error) });
+};
+
+const isBridgedVCLError = (
+  error: unknown
+): error is { code: typeof BRIDGED_VCL_ERROR_CODE; message: string } =>
+  typeof error === 'object' &&
+  error != null &&
+  (error as { code?: unknown }).code === BRIDGED_VCL_ERROR_CODE &&
+  typeof (error as { message?: unknown }).message === 'string';
+
+const toErrorMessage = (error: unknown): string => {
+  if (error instanceof Error) {
+    return error.message;
+  }
+
+  if (typeof error === 'string') {
+    return error;
+  }
+
+  try {
+    return JSON.stringify(error) ?? String(error);
+  } catch (_stringifyError) {
+    return String(error);
+  }
+};

package/src/api/entities/error/VCLError.ts

@@ -5,25 +5,45 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+export type VCLNativeCauseDiagnostics = {
+  type?: string;
+  message?: string;
+  stackFrames?: string[];
+};
+
+export type VCLDiagnostics = {
+  nativePlatform?: 'ios' | 'android';
+  nativeType?: string;
+  nativeStackFrames?: string[];
+  nativeCause?: VCLNativeCauseDiagnostics;
+};
+
+export type VCLErrorInit = {
+  payload?: string;
+  error?: string;
+  errorCode?: string;
+  requestId?: string;
+  message?: string;
+  statusCode?: number;
+  diagnostics?: VCLDiagnostics;
+};
+
 export class VCLError extends Error {
   payload?: string;
   error?: string;
   errorCode?: string;
   requestId?: string;
   statusCode?: number;
+  diagnostics?: VCLDiagnostics;
 
-  constructor(error: any) {
-    super(error);
-    try {
-      const errorJson = JSON.parse(error.message);
-      this.payload = errorJson.payload;
-      this.error = errorJson.error;
-      this.errorCode = errorJson.errorCode;
-      this.requestId = errorJson.requestId;
-      this.message = errorJson.message;
-      this.statusCode = parseInt(errorJson.statusCode, 10);
-    } catch (e) {
-      this.message = JSON.stringify(error);
-    }
+  constructor(error: VCLErrorInit = {}) {
+    super(error.message);
+    this.name = 'VCLError';
+    this.payload = error.payload;
+    this.error = error.error;
+    this.errorCode = error.errorCode;
+    this.requestId = error.requestId;
+    this.statusCode = error.statusCode;
+    this.diagnostics = error.diagnostics;
   }
 }

package/src/api/entities/error/VCLErrorDeserializer.ts

@@ -0,0 +1,151 @@
+/**
+ * Created by Michael Avoyan.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {
+  VCLError,
+  type VCLDiagnostics,
+  type VCLNativeCauseDiagnostics,
+} from './VCLError';
+
+export const BRIDGED_VCL_ERROR_CODE = 'VCL_BRIDGED_ERROR_V1';
+
+type SerializedVCLError = {
+  payload?: string;
+  error?: string;
+  errorCode?: string;
+  requestId?: string;
+  message?: string;
+  statusCode?: unknown;
+  diagnostics?: unknown;
+};
+
+export class VCLErrorDeserializer {
+  static fromJsonString(jsonString: string): VCLError {
+    try {
+      const parsedError = JSON.parse(jsonString);
+
+      if (!VCLErrorDeserializer.isSerializedVCLError(parsedError)) {
+        return new VCLError({ message: jsonString });
+      }
+
+      const error = parsedError as SerializedVCLError;
+      return new VCLError({
+        payload: error.payload,
+        error: error.error,
+        errorCode: error.errorCode,
+        requestId: error.requestId,
+        message: error.message,
+        statusCode: VCLErrorDeserializer.parseStatusCode(error.statusCode),
+        diagnostics: VCLErrorDeserializer.parseDiagnostics(error.diagnostics),
+      });
+    } catch (_parseError) {
+      return new VCLError({ message: jsonString });
+    }
+  }
+
+  private static isSerializedVCLError(
+    value: unknown
+  ): value is SerializedVCLError {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+  }
+
+  private static parseStatusCode(statusCode: unknown): number | undefined {
+    if (statusCode == null) {
+      return undefined;
+    }
+
+    const parsedStatusCode = parseInt(String(statusCode), 10);
+    return Number.isNaN(parsedStatusCode) ? undefined : parsedStatusCode;
+  }
+
+  private static parseDiagnostics(
+    diagnostics: unknown
+  ): VCLDiagnostics | undefined {
+    if (typeof diagnostics !== 'object' || diagnostics == null) {
+      return undefined;
+    }
+
+    const nativePlatform = VCLErrorDeserializer.parseNativePlatform(
+      (diagnostics as { nativePlatform?: unknown }).nativePlatform
+    );
+    const nativeType = VCLErrorDeserializer.parseString(
+      (diagnostics as { nativeType?: unknown }).nativeType
+    );
+    const nativeStackFrames = VCLErrorDeserializer.parseStringArray(
+      (diagnostics as { nativeStackFrames?: unknown }).nativeStackFrames
+    );
+    const nativeCause = VCLErrorDeserializer.parseNativeCause(
+      (diagnostics as { nativeCause?: unknown }).nativeCause
+    );
+
+    if (
+      nativePlatform == null &&
+      nativeType == null &&
+      nativeStackFrames == null &&
+      nativeCause == null
+    ) {
+      return undefined;
+    }
+
+    return {
+      nativePlatform,
+      nativeType,
+      nativeStackFrames,
+      nativeCause,
+    };
+  }
+
+  private static parseNativeCause(
+    nativeCause: unknown
+  ): VCLNativeCauseDiagnostics | undefined {
+    if (typeof nativeCause !== 'object' || nativeCause == null) {
+      return undefined;
+    }
+
+    const type = VCLErrorDeserializer.parseString(
+      (nativeCause as { type?: unknown }).type
+    );
+    const message = VCLErrorDeserializer.parseString(
+      (nativeCause as { message?: unknown }).message
+    );
+    const stackFrames = VCLErrorDeserializer.parseStringArray(
+      (nativeCause as { stackFrames?: unknown }).stackFrames
+    );
+
+    if (type == null && message == null && stackFrames == null) {
+      return undefined;
+    }
+
+    return { type, message, stackFrames };
+  }
+
+  private static parseNativePlatform(
+    nativePlatform: unknown
+  ): VCLDiagnostics['nativePlatform'] {
+    if (nativePlatform === 'ios' || nativePlatform === 'android') {
+      return nativePlatform;
+    }
+
+    return undefined;
+  }
+
+  private static parseString(value: unknown): string | undefined {
+    return typeof value === 'string' ? value : undefined;
+  }
+
+  private static parseStringArray(value: unknown): string[] | undefined {
+    if (!Array.isArray(value)) {
+      return undefined;
+    }
+
+    const stackFrames = value.filter(
+      (stackFrame): stackFrame is string => typeof stackFrame === 'string'
+    );
+
+    return stackFrames.length > 0 ? stackFrames : undefined;
+  }
+}

package/src/api/entities/initialization/VCLInitializationDescriptor.ts

@@ -16,4 +16,10 @@ export interface VCLInitializationDescriptor {
   isDebugOn?: boolean;
   cryptoServicesDescriptor?: VCLCryptoServicesDescriptor;
   isDirectIssuerCheckOn?: boolean;
+  /**
+   * Maximum number of native stack frames to include in bridged error diagnostics.
+   * Native implementations clamp values to the range `0..20`.
+   * Use `0` to disable native stack frames.
+   */
+  nativeErrorStackFrameLimit?: number;
 }

package/src/index.tsx

@@ -68,6 +68,11 @@ import { VCLStatusCode } from './api/entities/error/VCLStatusCode';
 import { VCLErrorCode } from './api/entities/error/VCLErrorCode';
 import type { VCLAuthToken } from './api/entities/VCLAuthToken';
 import type { VCLAuthTokenDescriptor } from './api/entities/VCLAuthTokenDescriptor';
+import type {
+  VCLDiagnostics,
+  VCLNativeCauseDiagnostics,
+  VCLErrorInit,
+} from './api/entities/error/VCLError';
 
 export default VclApi;
 export {
@@ -135,4 +140,7 @@ export type {
   VCLRemoteCryptoServicesUrlsDescriptor,
   VCLAuthToken,
   VCLAuthTokenDescriptor,
+  VCLDiagnostics,
+  VCLNativeCauseDiagnostics,
+  VCLErrorInit,
 };