@velocitycareerlabs/server-webwallet 1.25.0-dev-build.12642c864

package/src/controllers/credentials/controller.js

@@ -0,0 +1,92 @@
+const newError = require('http-errors');
+const { loadAdditionalRenderInfo } = require('../../entities');
+const { getCredentialCategories } = require('../../fetchers');
+
+const credentialsController = async (fastify) => {
+  fastify.get(
+    '/',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        response: {
+          200: {
+            $ref: 'https://velocitycareerlabs.io/webwallet-credentials-response.schema.json',
+          },
+        },
+      }),
+    },
+    async (req) => {
+      const { repos } = req;
+
+      const credentials = await repos.credentials.find({
+        filter: { auth0UserId: req.user.sub },
+      });
+
+      const additionalRenderInfo = await loadAdditionalRenderInfo(
+        credentials,
+        req
+      );
+
+      return { credentials, ...additionalRenderInfo };
+    }
+  );
+
+  fastify.delete(
+    '/:credentialId',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        params: {
+          type: 'object',
+          properties: {
+            credentialId: { type: 'string' },
+          },
+        },
+        response: {
+          204: { type: 'null' },
+        },
+      }),
+    },
+    async (
+      { repos: { credentials: credentialsRepo }, params, user },
+      reply
+    ) => {
+      const credential = await credentialsRepo.findOne({
+        filter: { _id: params.credentialId, auth0UserId: user.sub },
+      });
+
+      if (!credential) {
+        throw newError.NotFound(`Credential ${params.credentialId} not found`);
+      }
+
+      await credentialsRepo.update(params.credentialId, {
+        deletedAt: new Date(),
+      });
+
+      reply.code(204);
+    }
+  );
+
+  fastify.get(
+    '/categories',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        response: {
+          200: {
+            $ref: 'https://velocitycareerlabs.io/webwallet-credential-categories-response.schema.json',
+          },
+        },
+      }),
+    },
+    async (req) => {
+      const credentialCategories = await getCredentialCategories(req);
+
+      return credentialCategories;
+    }
+  );
+};
+
+module.exports = credentialsController;

package/src/controllers/credentials/schemas/index.js

@@ -0,0 +1,4 @@
+module.exports = {
+  ...require('./webwallet-credentials-response.schema'),
+  ...require('./webwallet-credential-categories-response.schema'),
+};

package/src/controllers/credentials/schemas/webwallet-credential-categories-response.schema.js

@@ -0,0 +1,21 @@
+const webWalletCredentialCategoriesResponseSchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-credential-categories-response.schema.json',
+  title: 'webwallet-credential-categories-response',
+  description:
+    'the body of response for webwallet get credential categories endpoint',
+  type: 'array',
+  items: {
+    type: 'object',
+    properties: {
+      title: { type: 'string' },
+      icon: { type: 'string' },
+      color: { type: 'string' },
+      types: { type: 'array', items: { type: 'string' } },
+      iconSize: { type: 'integer' },
+      isIdentity: { type: 'boolean' },
+    },
+    required: ['title', 'icon', 'color', 'types', 'iconSize'],
+  },
+};
+
+module.exports = { webWalletCredentialCategoriesResponseSchema };

package/src/controllers/credentials/schemas/webwallet-credentials-response.schema.js

@@ -0,0 +1,29 @@
+const webWalletCredentialsResponseSchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-credentials-response.schema.json',
+  title: 'webwallet-credentials-response',
+  description: 'the body of response for webwallet get credentials endpoint',
+  type: 'object',
+  properties: {
+    credentials: {
+      type: 'array',
+      items: {
+        $ref: 'https://velocitycareerlabs.io/webwallet-credential-response.schema.json',
+      },
+    },
+    issuers: {
+      type: 'object',
+      additionalProperties: {
+        $ref: 'organization-profile',
+      },
+    },
+    displayDescriptors: {
+      type: 'object',
+      additionalProperties: {
+        $ref: 'https://velocitycareerlabs.io/webwallet-display-descriptor-response.schema.json',
+      },
+    },
+  },
+  required: ['credentials'],
+};
+
+module.exports = { webWalletCredentialsResponseSchema };

package/src/controllers/disclosures/autohooks.js

@@ -0,0 +1,21 @@
+const { values, forEach } = require('lodash/fp');
+const { oauthPlugin } = require('@velocitycareerlabs/auth');
+
+const controllerSchemas = require('./schemas');
+const disclosureSchemas = require('../../entities/disclosures/schemas');
+
+module.exports = async (fastify) => {
+  forEach(
+    (schema) => fastify.addSchema(schema),
+    [...values(disclosureSchemas), ...values(controllerSchemas)]
+  );
+
+  fastify
+    .autoSchemaPreset({
+      tags: ['webwallet'],
+    })
+    .register(oauthPlugin, {
+      domain: fastify.config.auth0Domain,
+      audience: [fastify.config.auth0WebWalletAudience],
+    });
+};

package/src/controllers/disclosures/controller.js

@@ -0,0 +1,168 @@
+const { jwtDecode } = require('@velocitycareerlabs/jwt');
+const {
+  VCLPresentationSubmission,
+  VCLDeepLink,
+  VCLPresentationRequestDescriptor,
+  VCLDidJwk,
+} = require('@velocitycareerlabs/vnf-nodejs-wallet-sdk');
+const { getAppConfig } = require('../../fetchers/career-wallet/get-app-config');
+
+/**
+ * @param {import('fastify').FastifyInstance} fastify
+ */
+const disclosureController = async (fastify) => {
+  fastify.get(
+    '/get-presentation-request',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        querystring: {
+          $ref: 'https://velocitycareerlabs.io/webwallet-get-presentation-request-query.schema.json',
+        },
+        response: {
+          200: {
+            $ref: 'https://velocitycareerlabs.io/webwallet-get-presentation-request-response.schema.json',
+          },
+          '4xx': { $ref: 'error#' },
+        },
+      }),
+    },
+    async (req) => {
+      const presentationRequest = await req.vclSdk.getPresentationRequest(
+        new VCLPresentationRequestDescriptor(new VCLDeepLink(req.query.link))
+      );
+
+      const { payload: presentation } = jwtDecode(
+        presentationRequest.jwt.encodedJwt
+      );
+
+      return { presentation };
+    }
+  );
+
+  fastify.get(
+    '/get-public-share-link',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        response: {
+          200: {
+            type: 'object',
+            properties: {
+              link: { type: 'string' },
+              template: { type: 'string' },
+            },
+          },
+          '4xx': { $ref: 'error#' },
+        },
+      }),
+    },
+    async (req) => {
+      const {
+        verificationServiceDeepLink: link,
+        verificationServicePresentationLinkTemplate: template,
+      } = await getAppConfig(req);
+
+      return { link, template };
+    }
+  );
+
+  fastify.post(
+    '/accept-presentation-request',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        body: {
+          $ref: 'https://velocitycareerlabs.io/webwallet-accept-presentation-request-body.schema.json',
+        },
+        response: {
+          200: {
+            $ref: 'https://velocitycareerlabs.io/webwallet-accept-presentation-response.schema.json',
+          },
+          '4xx': { $ref: 'error#' },
+        },
+      }),
+    },
+    async ({
+      body,
+      vclSdk,
+      repos,
+      user,
+      repos: { accounts },
+      config: { careerWalletAdminAccessToken },
+    }) => {
+      const { didKeyMetadatum } = await accounts.findOne({
+        filter: { userId: user.sub },
+      });
+      const didJwk =
+        didKeyMetadatum &&
+        Array.isArray(didKeyMetadatum) &&
+        didKeyMetadatum.length > 0
+          ? VCLDidJwk.fromJSON(didKeyMetadatum[0])
+          : null;
+
+      const presentationRequest = await vclSdk.getPresentationRequest(
+        new VCLPresentationRequestDescriptor(
+          new VCLDeepLink(body.link),
+          null,
+          didJwk,
+          careerWalletAdminAccessToken
+        )
+      );
+
+      const { payload: presentation } = jwtDecode(
+        presentationRequest.jwt.encodedJwt
+      );
+
+      const submissionResult = await vclSdk.submitPresentation(
+        new VCLPresentationSubmission(presentationRequest, body.credentials)
+      );
+
+      const { did: userDid } = await repos.accounts.findOne({
+        filter: { userId: user.sub },
+      });
+
+      const disclosure = await repos.disclosures.insert({
+        auth0UserId: user.sub,
+        userDid,
+        presentation,
+        encodedJwt: presentationRequest.jwt.encodedJwt,
+        jti: submissionResult.jti,
+        submissionId: submissionResult.submissionId,
+        presentationDefinitionId: presentation.presentation_definition.id,
+        token: submissionResult.sessionToken.value,
+        sharedCredentials: body.credentials.map(({ id }) => id),
+        type: body.type,
+      });
+
+      return { disclosure };
+    }
+  );
+
+  fastify.get(
+    '',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        response: {
+          200: {
+            $ref: 'https://velocitycareerlabs.io/webwallet-get-disclosures-response.schema.json',
+          },
+        },
+      }),
+    },
+    async ({ repos, user }) => {
+      const disclosures = await repos.disclosures.find({
+        filter: { auth0UserId: user.sub },
+      });
+
+      return { disclosures };
+    }
+  );
+};
+
+module.exports = disclosureController;

package/src/controllers/disclosures/schemas/index.js

@@ -0,0 +1,7 @@
+module.exports = {
+  ...require('./webwallet-get-presentation-request-query.schema'),
+  ...require('./webwallet-get-presentation-request-response.schema'),
+  ...require('./webwallet-accept-presentation-request-body.schema'),
+  ...require('./webwallet-accept-presentation-response.schema'),
+  ...require('./webwallet-get-disclosures-response.schema'),
+};

package/src/controllers/disclosures/schemas/webwallet-accept-presentation-request-body.schema.js

@@ -0,0 +1,28 @@
+const webWalletAcceptPresentationRequestBodySchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-accept-presentation-request-body.schema.json',
+  title: 'webwallet-accept-presentation-request',
+  description: 'the request schema for webwallet accept presentation request',
+  type: 'object',
+  properties: {
+    link: { type: 'string' },
+    credentials: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string' },
+          inputDescriptor: { type: 'string' },
+          jwtVc: { type: 'string' },
+        },
+        required: ['inputDescriptor', 'jwtVc', 'id'],
+      },
+      minItems: 1,
+    },
+    type: { type: 'string', enum: ['public', 'linkedin'] },
+  },
+  required: ['link', 'credentials'],
+};
+
+module.exports = {
+  webWalletAcceptPresentationRequestBodySchema,
+};

package/src/controllers/disclosures/schemas/webwallet-accept-presentation-response.schema.js

@@ -0,0 +1,16 @@
+const webWalletAcceptPresentationResponseSchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-accept-presentation-response.schema.json',
+  title: 'webwallet-accept-presentation-response',
+  description: 'the response schema for webwallet accept presentation request',
+  type: 'object',
+  properties: {
+    disclosure: {
+      $ref: 'https://velocitycareerlabs.io/webwallet-disclosure.schema.json',
+    },
+  },
+  required: ['disclosure'],
+};
+
+module.exports = {
+  webWalletAcceptPresentationResponseSchema,
+};

package/src/controllers/disclosures/schemas/webwallet-get-disclosures-response.schema.js

@@ -0,0 +1,18 @@
+const webWalletGetDisclosuresResponseSchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-get-disclosures-response.schema.json',
+  title: 'webwallet-get-disclosures-response',
+  description: 'the response schema for webwallet get disclosures request',
+  type: 'object',
+  properties: {
+    disclosures: {
+      type: 'array',
+      items: {
+        $ref: 'https://velocitycareerlabs.io/webwallet-disclosure.schema.json',
+      },
+    },
+  },
+};
+
+module.exports = {
+  webWalletGetDisclosuresResponseSchema,
+};

package/src/controllers/disclosures/schemas/webwallet-get-presentation-request-query.schema.js

@@ -0,0 +1,21 @@
+const config = require('../../../config/config');
+
+const webWalletGetPresentationRequestQuerySchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-get-presentation-request-query.schema.json',
+  title: 'webwallet-get-presentation-request-query',
+  description: 'the request schema for webwallet get presentation request',
+  type: 'object',
+  properties: {
+    link: {
+      type: 'string',
+      format: 'uri',
+      pattern: `${config.deepLinkProtocol.replace('//', '')}\\/\\/inspect.*`,
+    },
+    public_share: { type: 'boolean' },
+  },
+  oneOf: [{ required: ['link'] }, { required: ['public_share'] }],
+};
+
+module.exports = {
+  webWalletGetPresentationRequestQuerySchema,
+};

package/src/controllers/disclosures/schemas/webwallet-get-presentation-request-response.schema.js

@@ -0,0 +1,16 @@
+const webWalletGetPresentationRequestResponseSchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-get-presentation-request-response.schema.json',
+  title: 'webwallet-get-presentation-request-response',
+  description: 'the response schema for webwallet get presentation request',
+  type: 'object',
+  properties: {
+    presentation: {
+      $ref: 'https://velocitycareerlabs.io/presentation-request.schema.json',
+    },
+  },
+  required: ['presentation'],
+};
+
+module.exports = {
+  webWalletGetPresentationRequestResponseSchema,
+};

package/src/controllers/feedback/autohooks.js

@@ -0,0 +1,11 @@
+const { oauthPlugin } = require('@velocitycareerlabs/auth');
+const multipart = require('@fastify/multipart');
+
+module.exports = async (fastify) => {
+  fastify
+    .register(multipart, { attachFieldsToBody: 'keyValues' })
+    .register(oauthPlugin, {
+      domain: fastify.config.auth0Domain,
+      audience: [fastify.config.auth0WebWalletAudience],
+    });
+};

package/src/controllers/feedback/controller.js

@@ -0,0 +1,48 @@
+const { sendFeedback } = require('../../fetchers/career-wallet');
+
+const feedbackController = async (fastify) => {
+  fastify.post(
+    '/',
+    {
+      preValidation: fastify.verifyAccessToken(),
+      schema: fastify.autoSchema({
+        tags: ['webwallet'],
+        body: {
+          type: 'object',
+          properties: {
+            feedback: { type: 'string' },
+            errorCode: { type: 'string' },
+            deviceOS: { type: 'string' },
+          },
+          required: ['feedback', 'deviceOS', 'errorCode'],
+        },
+        response: {
+          '4xx': { $ref: 'error#' },
+        },
+      }),
+    },
+    async (req, reply) => {
+      const {
+        repos: { accounts },
+        user,
+        ip,
+      } = req;
+      const { careerWalletAccountId } = await accounts.findOne({
+        filter: { userId: user.sub },
+      });
+      const payload = {
+        accountId: careerWalletAccountId,
+        appVersion: '',
+        deviceManufacturer: '',
+        deviceModel: '',
+        ip,
+        ...req.body,
+      };
+      await sendFeedback(payload, req);
+      reply.status(204);
+      return {};
+    }
+  );
+};
+
+module.exports = feedbackController;

package/src/controllers/issuing/common-schemas/index.js

@@ -0,0 +1,10 @@
+/**
+ * Created by Michael Avoyan on 31/07/2024.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+module.exports = {
+  ...require('./webwallet-get-credential-manifest-query.schema'),
+  ...require('./webwallet-get-credential-manifest-response.schema'),
+};

package/src/controllers/issuing/common-schemas/webwallet-get-credential-manifest-query.schema.js

@@ -0,0 +1,27 @@
+/**
+ * Created by Michael Avoyan on 31/07/2024.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const config = require('../../../config/config');
+
+const webWalletGetCredentialManifestQuerySchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-get-credential-manifest-query.schema.json',
+  title: 'webwallet-get-credential-manifest-query',
+  description: 'the request schema for webwallet get credential manifest',
+  type: 'object',
+  properties: {
+    link: {
+      type: 'string',
+      format: 'uri',
+      pattern: `${config.deepLinkProtocol.replace('//', '')}\\/\\/issue.*`,
+    },
+    public_share: { type: 'boolean' },
+  },
+  oneOf: [{ required: ['link'] }, { required: ['public_share'] }],
+};
+
+module.exports = {
+  webWalletGetCredentialManifestQuerySchema,
+};

package/src/controllers/issuing/common-schemas/webwallet-get-credential-manifest-response.schema.js

@@ -0,0 +1,31 @@
+/**
+ * Created by Michael Avoyan on 31/07/2024.
+ *
+ * Copyright 2022 Velocity Career Labs inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const webWalletGetCredentialManifestResponseSchema = {
+  $id: 'https://velocitycareerlabs.io/webwallet-get-credential-manifest-response.schema.json',
+  title: 'webwallet-get-credential-manifest-response',
+  description: 'the response for credential manifest',
+  type: 'object',
+  properties: {
+    credentialManifest: {
+      type: 'object',
+      properties: {
+        presentation: {
+          $ref: 'https://velocitycareerlabs.io/credential-manifest.schema.json',
+        },
+        jwt: { type: 'string' },
+        link: { type: 'string' },
+      },
+      required: ['jwt', 'presentation'],
+      additionalProperties: true,
+    },
+  },
+  required: ['credentialManifest'],
+};
+
+module.exports = {
+  webWalletGetCredentialManifestResponseSchema,
+};

package/src/controllers/issuing/deep-link/autohooks.js

@@ -0,0 +1,51 @@
+const { oauthPlugin } = require('@velocitycareerlabs/auth');
+
+const {
+  newOfferRelatedResourceSchema,
+  holderOfferSchema,
+  organizationProfileBaseSchema,
+  organizationProfileSchema,
+  addressSchema,
+  locationSchema,
+} = require('@velocitycareerlabs/common-schemas');
+const {
+  webWalletDeepLinkOffersRequestSchema,
+  webWalletDeepLinkOffersResponseSchema,
+  webWalletDeepLinkAcceptOffersRequestSchema,
+  webWalletDeepLinkAcceptOffersResponseSchema,
+} = require('./schemas');
+const {
+  webWalletCredentialResponseSchema,
+  webWalletDisplayDescriptorResponseSchema,
+  webWalletCredentialManifestSchema,
+} = require('../../../entities');
+const {
+  webWalletGetCredentialManifestQuerySchema,
+  webWalletGetCredentialManifestResponseSchema,
+} = require('../common-schemas');
+
+module.exports = async (fastify) => {
+  fastify
+    .addSchema(newOfferRelatedResourceSchema)
+    .addSchema(holderOfferSchema)
+    .addSchema(webWalletCredentialManifestSchema)
+    .addSchema(webWalletGetCredentialManifestQuerySchema)
+    .addSchema(webWalletGetCredentialManifestResponseSchema)
+    .addSchema(webWalletDeepLinkAcceptOffersRequestSchema)
+    .addSchema(webWalletDeepLinkAcceptOffersResponseSchema)
+    .addSchema(webWalletDeepLinkOffersRequestSchema)
+    .addSchema(webWalletDeepLinkOffersResponseSchema)
+    .addSchema(addressSchema)
+    .addSchema(locationSchema)
+    .addSchema(organizationProfileBaseSchema)
+    .addSchema(organizationProfileSchema)
+    .addSchema(webWalletCredentialResponseSchema)
+    .addSchema(webWalletDisplayDescriptorResponseSchema)
+    .autoSchemaPreset({
+      tags: ['webwallet'],
+    })
+    .register(oauthPlugin, {
+      domain: fastify.config.auth0Domain,
+      audience: [fastify.config.auth0WebWalletAudience],
+    });
+};