@velocitycareerlabs/vcl-react-native 2.9.0 → 2.10.0-rc

package/lib/typescript/src/api/entities/error/VCLError.d.ts

@@ -4,12 +4,33 @@
  * Copyright 2022 Velocity Career Labs inc.
  * 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 declare class VCLError extends Error {
     payload?: string;
     error?: string;
     errorCode?: string;
     requestId?: string;
     statusCode?: number;
-    constructor(error: any);
+    diagnostics?: VCLDiagnostics;
+    constructor(error?: VCLErrorInit);
 }
 //# sourceMappingURL=VCLError.d.ts.map

package/lib/typescript/src/api/entities/error/VCLError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VCLError.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/error/VCLError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,KAAK,EAAE,GAAG;CAcvB"}
+{"version":3,"file":"VCLError.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/error/VCLError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B,CAAC;AAEF,qBAAa,QAAS,SAAQ,KAAK;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,cAAc,CAAC;gBAEjB,KAAK,GAAE,YAAiB;CAUrC"}

package/lib/typescript/src/api/entities/error/VCLErrorCode.d.ts

@@ -5,6 +5,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 export declare enum VCLErrorCode {
+    RemoteServicesUrlsNotFound = "remote_services_urls_not_found",
+    InjectedServicesNotFound = "injected_services_not_found",
     CredentialTypeNotRegistered = "credential_type_not_registered",
     IssuerRequiresIdentityPermission = "issuer_requires_identity_permission",
     IssuerRequiresNotaryPermission = "issuer_requires_notary_permission",
@@ -16,6 +18,19 @@ export declare enum VCLErrorCode {
     MismatchedOfferIssuerDid = "mismatched_offer_issuer_did",
     MismatchedCredentialIssuerDid = "mismatched_credential_issuer_did",
     MismatchedPresentationRequestInspectorDid = "mismatched_presentation_request_inspector_did",
+    InvalidLink = "invalid_link",
+    ConnectivityFailure = "connectivity_failure",
+    ClientRequestUnauthorized = "client_request_unauthorized",
+    ClientRequestRejected = "client_request_rejected",
+    IssuerDidUnresolvable = "issuer_did_unresolvable",
+    VerifierDidUnresolvable = "verifier_did_unresolvable",
+    RegistrationCheckInconclusive = "registration_check_inconclusive",
+    IssuerNotRegistered = "issuer_not_registered",
+    VerifierNotRegistered = "verifier_not_registered",
+    IssuerRequestInvalid = "issuer_request_invalid",
+    VerifierRequestInvalid = "verifier_request_invalid",
+    IssuerRequestUnauthorized = "issuer_request_unauthorized",
+    VerifierRequestUnauthorized = "verifier_request_unauthorized",
     SdkError = "sdk_error"
 }
 //# sourceMappingURL=VCLErrorCode.d.ts.map

package/lib/typescript/src/api/entities/error/VCLErrorCode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VCLErrorCode.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/error/VCLErrorCode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,YAAY;IAEtB,2BAA2B,mCAAmC;IAC9D,gCAAgC,wCAAwC;IACxE,8BAA8B,sCAAsC;IACpE,+BAA+B,uCAAuC;IACtE,4BAA4B,oCAAoC;IAChE,+BAA+B,uCAAuC;IACtE,iCAAiC,yCAAyC;IAE1E,0BAA0B,kCAAkC;IAC5D,wBAAwB,gCAAgC;IACxD,6BAA6B,qCAAqC;IAClE,yCAAyC,kDAAkD;IAE3F,QAAQ,cAAc;CACvB"}
+{"version":3,"file":"VCLErrorCode.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/error/VCLErrorCode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,YAAY;IAEtB,0BAA0B,mCAAmC;IAC7D,wBAAwB,gCAAgC;IAGxD,2BAA2B,mCAAmC;IAC9D,gCAAgC,wCAAwC;IACxE,8BAA8B,sCAAsC;IACpE,+BAA+B,uCAAuC;IACtE,4BAA4B,oCAAoC;IAChE,+BAA+B,uCAAuC;IACtE,iCAAiC,yCAAyC;IAE1E,0BAA0B,kCAAkC;IAC5D,wBAAwB,gCAAgC;IACxD,6BAA6B,qCAAqC;IAClE,yCAAyC,kDAAkD;IAE3F,WAAW,iBAAiB;IAC5B,mBAAmB,yBAAyB;IAC5C,yBAAyB,gCAAgC;IACzD,qBAAqB,4BAA4B;IACjD,qBAAqB,4BAA4B;IACjD,uBAAuB,8BAA8B;IACrD,6BAA6B,oCAAoC;IACjE,mBAAmB,0BAA0B;IAC7C,qBAAqB,4BAA4B;IACjD,oBAAoB,2BAA2B;IAC/C,sBAAsB,6BAA6B;IACnD,yBAAyB,gCAAgC;IACzD,2BAA2B,kCAAkC;IAE7D,QAAQ,cAAc;CACvB"}

package/lib/typescript/src/api/entities/error/VCLErrorDeserializer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Created by Michael Avoyan.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { VCLError } from './VCLError';
+export declare const BRIDGED_VCL_ERROR_CODE = "VCL_BRIDGED_ERROR_V1";
+export declare class VCLErrorDeserializer {
+    static fromJsonString(jsonString: string): VCLError;
+    private static isSerializedVCLError;
+    private static parseStatusCode;
+    private static parseDiagnostics;
+    private static parseNativeCause;
+    private static parseNativePlatform;
+    private static parseString;
+    private static parseStringArray;
+}
+//# sourceMappingURL=VCLErrorDeserializer.d.ts.map

package/lib/typescript/src/api/entities/error/VCLErrorDeserializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VCLErrorDeserializer.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/error/VCLErrorDeserializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EAGT,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAY7D,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAuBnD,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAMnC,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAqC/B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAwB/B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAUlC,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAWhC"}

package/lib/typescript/src/api/entities/initialization/VCLErrorCodeCompatibilityMode.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Created by Michael Avoyan.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum VCLErrorCodeCompatibilityMode {
+    Taxonomy = "taxonomy",
+    Legacy = "legacy"
+}
+//# sourceMappingURL=VCLErrorCodeCompatibilityMode.d.ts.map

package/lib/typescript/src/api/entities/initialization/VCLErrorCodeCompatibilityMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VCLErrorCodeCompatibilityMode.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/initialization/VCLErrorCodeCompatibilityMode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,6BAA6B;IACvC,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB"}

package/lib/typescript/src/api/entities/initialization/VCLInitializationDescriptor.d.ts

@@ -6,6 +6,7 @@
  */
 import type { VCLEnvironment } from '../../VCLEnvironment';
 import type { VCLCryptoServicesDescriptor } from './VCLCryptoServicesDescriptor';
+import type { VCLErrorCodeCompatibilityMode } from './VCLErrorCodeCompatibilityMode';
 import type { VCLXVnfProtocolVersion } from '../../VCLXVnfProtocolVersion';
 export interface VCLInitializationDescriptor {
     environment?: VCLEnvironment;
@@ -14,5 +15,16 @@ export interface VCLInitializationDescriptor {
     isDebugOn?: boolean;
     cryptoServicesDescriptor?: VCLCryptoServicesDescriptor;
     isDirectIssuerCheckOn?: boolean;
+    /**
+     * Controls whether native SDK errors use the new taxonomy codes or legacy
+     * backward-compatible mappings. Native SDKs default to taxonomy mode.
+     */
+    errorCodeCompatibilityMode?: VCLErrorCodeCompatibilityMode;
+    /**
+     * 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;
 }
 //# sourceMappingURL=VCLInitializationDescriptor.d.ts.map

package/lib/typescript/src/api/entities/initialization/VCLInitializationDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VCLInitializationDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/initialization/VCLInitializationDescriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;IACvD,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC"}
+{"version":3,"file":"VCLInitializationDescriptor.d.ts","sourceRoot":"","sources":["../../../../../../src/api/entities/initialization/VCLInitializationDescriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;IACvD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,0BAA0B,CAAC,EAAE,6BAA6B,CAAC;IAC3D;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC"}

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

@@ -9,6 +9,7 @@ import { VCLEnvironment } from './api/VCLEnvironment';
 import { VCLXVnfProtocolVersion } from './api/VCLXVnfProtocolVersion';
 import { VCLCryptoServiceType } from './api/VCLCryptoServiceType';
 import { VCLSignatureAlgorithm } from './api/VCLSignatureAlgorithm';
+import { VCLErrorCodeCompatibilityMode } from './api/entities/initialization/VCLErrorCodeCompatibilityMode';
 import type { VCLCryptoServicesDescriptor } from './api/entities/initialization/VCLCryptoServicesDescriptor';
 import type { VCLJwtServiceUrls } from './api/entities/initialization/VCLJwtServiceUrls';
 import type { VCLKeyServiceUrls } from './api/entities/initialization/VCLKeyServiceUrls';
@@ -67,7 +68,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 { VCLEnvironment, VCLCryptoServiceType, VCLSignatureAlgorithm, VCLXVnfProtocolVersion, VCLCountryCodes, VCLServiceType, VCLIssuingType, VCLError, VCLStatusCode, VCLErrorCode, VCLErrorCodeCompatibilityMode, };
+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.9.0",
+  "version": "2.10.0-rc",
   "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/VCLErrorCode.ts

@@ -6,6 +6,10 @@
  */
 
 export enum VCLErrorCode {
+  // Initialization
+  RemoteServicesUrlsNotFound = 'remote_services_urls_not_found',
+  InjectedServicesNotFound = 'injected_services_not_found',
+
   // Credential issuer verification error codes:
   CredentialTypeNotRegistered = 'credential_type_not_registered',
   IssuerRequiresIdentityPermission = 'issuer_requires_identity_permission',
@@ -19,6 +23,20 @@ export enum VCLErrorCode {
   MismatchedOfferIssuerDid = 'mismatched_offer_issuer_did',
   MismatchedCredentialIssuerDid = 'mismatched_credential_issuer_did',
   MismatchedPresentationRequestInspectorDid = 'mismatched_presentation_request_inspector_did',
+  // Error taxonomy
+  InvalidLink = 'invalid_link',
+  ConnectivityFailure = 'connectivity_failure',
+  ClientRequestUnauthorized = 'client_request_unauthorized',
+  ClientRequestRejected = 'client_request_rejected',
+  IssuerDidUnresolvable = 'issuer_did_unresolvable',
+  VerifierDidUnresolvable = 'verifier_did_unresolvable',
+  RegistrationCheckInconclusive = 'registration_check_inconclusive',
+  IssuerNotRegistered = 'issuer_not_registered',
+  VerifierNotRegistered = 'verifier_not_registered',
+  IssuerRequestInvalid = 'issuer_request_invalid',
+  VerifierRequestInvalid = 'verifier_request_invalid',
+  IssuerRequestUnauthorized = 'issuer_request_unauthorized',
+  VerifierRequestUnauthorized = 'verifier_request_unauthorized',
   // General error
   SdkError = 'sdk_error',
 }

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/VCLErrorCodeCompatibilityMode.ts

@@ -0,0 +1,11 @@
+/**
+ * Created by Michael Avoyan.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export enum VCLErrorCodeCompatibilityMode {
+  Taxonomy = 'taxonomy',
+  Legacy = 'legacy',
+}