@verii/server-credentialing-hub 2.0.0

package/src/entities/presentations/repo/add-verification.js

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+const addVerificationExtension = (parent) => ({
+  addVerification: (presentationId, verification) =>
+    parent.collection().updateOne(
+      { _id: presentationId },
+      {
+        $push: { verifications: { ...verification, createdAt: new Date() } },
+        $set: { updatedAt: new Date() },
+      },
+    ),
+  extensions: parent.extensions.concat(['addVerificationExtension']),
+});
+
+module.exports = {
+  addVerificationExtension,
+};

package/src/entities/presentations/repo/finders-extension.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+
+const { ObjectId } = require('mongodb');
+const { isEmpty, map } = require('lodash/fp');
+
+const findersExtension = (parent) => ({
+  search: async ({ presentationIds, exchangeId, depotId }) => {
+    const filter = {};
+    if (!isEmpty(presentationIds)) {
+      filter._id = {
+        $in: map((id) => new ObjectId(id), presentationIds),
+      };
+    }
+    if (exchangeId) {
+      filter.exchangeId = new ObjectId(exchangeId);
+    }
+    if (depotId) {
+      filter.depotId = new ObjectId(depotId);
+    }
+
+    return parent.find({ filter });
+  },
+  findByDepotId: async ({ depotId }) => {
+    const filter = {
+      depotId: new ObjectId(depotId),
+    };
+
+    return parent.find({ filter });
+  },
+  extensions: parent.extensions.concat(['findersExtension']),
+});
+
+module.exports = {
+  findersExtension,
+};

package/src/entities/presentations/repo/index.js

@@ -0,0 +1,19 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+module.exports = {
+  presentationsRepoPlugin: require('./repo'),
+};

package/src/entities/presentations/repo/repo.js

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+
+const {
+  mongoDb,
+  repoFactory,
+  autoboxIdsExtension,
+} = require('@spencejs/spence-mongo-repos');
+const { multitenantExtension } = require('@verii/spencer-mongo-extensions');
+const { findersExtension } = require('./finders-extension');
+const { addVerificationExtension } = require('./add-verification');
+
+module.exports = (app, options, next = () => {}) => {
+  app.ready(async () => {
+    await mongoDb()
+      .collection('presentations')
+      .createIndex({ tenantId: 1, depotId: 1 });
+    await mongoDb()
+      .collection('presentations')
+      .createIndex({ tenantId: 1, exchangeId: 1 });
+  });
+  next();
+  return repoFactory({
+    name: 'presentations',
+    entityName: 'presentation',
+    defaultProjection: {
+      _id: 1,
+      format: 1,
+      presentation: 1,
+      verifications: 1,
+      exchangeId: 1,
+      depotId: 1,
+      tenantId: 1,
+      createdAt: 1,
+      updatedAt: 1,
+    },
+    extensions: [
+      autoboxIdsExtension,
+      multitenantExtension(),
+      findersExtension,
+      addVerificationExtension,
+    ],
+  });
+};

package/src/entities/relying-party-services/factories/index.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2023 Velocity Team
+ *
+ * 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.
+ */
+
+module.exports = {
+  ...require('./relying-party-service-factory'),
+};

package/src/entities/relying-party-services/factories/relying-party-service-factory.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2023 Velocity Team
+ *
+ * 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.
+ */
+
+const { register } = require('@spencejs/spence-factories');
+const { ObjectId } = require('mongodb');
+const { initTenantFactory } = require('../../tenants');
+const { relyingPartyServicesRepoPlugin } = require('../repo');
+
+const initRelyingPartyServiceFactory = (app) => {
+  const initRepo = relyingPartyServicesRepoPlugin(app);
+  return register('relyingPartyService', async (overrides, { getOrBuild }) => {
+    const tenant = await getOrBuild('tenant', initTenantFactory(app));
+    return {
+      item: {
+        mode: 'single',
+        velocityNetworkServiceId: '#foo-relying-party-service-1',
+        termsUrl: 'https://www.example.com/terms-of-service',
+        authTokensExpireIn: 100000,
+        presentationRequestsExpireIn: 600,
+        ...overrides(),
+      },
+      repo: initRepo({
+        tenant: { ...tenant, _id: new ObjectId(tenant._id) },
+        config: app.config,
+      }),
+    };
+  });
+};
+
+module.exports = { initRelyingPartyServiceFactory };

package/src/entities/relying-party-services/index.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ *
+ */
+module.exports = {
+  ...require('./factories'),
+  ...require('./repo'),
+};

package/src/entities/relying-party-services/repo/find-relying-party-services-extension.js

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ */
+
+const { isEmpty } = require('lodash/fp');
+
+const findRelyingPartyServicesExtension = (parent) => ({
+  findServices: async (servicesIds) => {
+    const filter = {};
+    if (!isEmpty(servicesIds)) {
+      filter._id = { $in: servicesIds };
+    }
+    return parent.find({ filter });
+  },
+  extensions: parent.extensions.concat(['findRelyingPartyServicesExtension']),
+});
+
+module.exports = { findRelyingPartyServicesExtension };

package/src/entities/relying-party-services/repo/index.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright 2023 Velocity Team
+ *
+ * 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.
+ */
+
+module.exports = {
+  relyingPartyServicesRepoPlugin: require('./repo'),
+};

package/src/entities/relying-party-services/repo/repo.js

@@ -0,0 +1,55 @@
+/**
+ * Copyright 2023 Velocity Team
+ *
+ * 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.
+ */
+
+const {
+  repoFactory,
+  autoboxIdsExtension,
+} = require('@spencejs/spence-mongo-repos');
+const { multitenantExtension } = require('@verii/spencer-mongo-extensions');
+const {
+  findRelyingPartyServicesExtension,
+} = require('./find-relying-party-services-extension');
+
+module.exports = (app, options, next = () => {}) => {
+  next();
+  return repoFactory(
+    {
+      name: 'relyingPartyServices',
+      entityName: 'relyingPartyService',
+      defaultProjection: {
+        _id: 1,
+        velocityNetworkServiceId: 1,
+        description: 1,
+        mode: 1,
+        termsUrl: 1,
+        disclosureRequest: 1,
+        presentationDefinition: 1,
+        deactivationDate: 1,
+        authTokensExpireIn: 1,
+        presentationRequestsExpireIn: 1,
+        tenantId: 1,
+        createdAt: 1,
+        updatedAt: 1,
+      },
+      extensions: [
+        autoboxIdsExtension,
+        multitenantExtension(),
+        findRelyingPartyServicesExtension,
+      ],
+    },
+    app,
+  );
+};

package/src/entities/service-configurations/domain/canonicalize-service-configuration.js

@@ -0,0 +1,12 @@
+const canonicalizeServiceConfiguration = (issuerService) => {
+  if (issuerService.deactivationDate != null) {
+    // eslint-disable-next-line better-mutation/no-mutation
+    issuerService.deactivationDate = new Date(issuerService.deactivationDate);
+  }
+
+  return issuerService;
+};
+
+module.exports = {
+  canonicalizeServiceConfiguration,
+};

package/src/entities/service-configurations/domain/index.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+module.exports = {
+  ...require('./canonicalize-service-configuration'),
+  ...require('./service-configuration-errors'),
+  ...require('./validate-service-configuration'),
+  ...require('./validate-update-service-configuration'),
+};

package/src/entities/service-configurations/domain/service-configuration-errors.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ *
+ */
+
+const ServiceConfigurationErrors = {
+  SERVICE_NOT_MATCHED: 'service_not_matched',
+  SERVICE_NOT_FOUND: 'service_not_found',
+  SERVICE_MUST_BE_UNIQUE: 'service_must_be_unique',
+  RELATED_DEPOT_UNDELETED: 'related_depot_undeleted',
+};
+module.exports = { ServiceConfigurationErrors };

package/src/entities/service-configurations/domain/validate-service-configuration.js

@@ -0,0 +1,31 @@
+const newError = require('http-errors');
+const { find } = require('lodash/fp');
+const {
+  ServiceConfigurationErrors,
+} = require('./service-configuration-errors');
+
+const validateServiceConfiguration = ({ service, didDoc, otherServices }) => {
+  const matchingService = find(
+    { id: service.velocityNetworkServiceId },
+    didDoc.service,
+  );
+  if (matchingService == null) {
+    throw newError(400, ServiceConfigurationErrors.SERVICE_NOT_MATCHED, {
+      errorCode: ServiceConfigurationErrors.SERVICE_NOT_MATCHED,
+    });
+  }
+
+  const matchingExistingService = find(
+    { velocityNetworkServiceId: service.velocityNetworkServiceId },
+    otherServices,
+  );
+  if (matchingExistingService != null) {
+    throw newError(400, ServiceConfigurationErrors.SERVICE_MUST_BE_UNIQUE, {
+      errorCode: ServiceConfigurationErrors.SERVICE_MUST_BE_UNIQUE,
+    });
+  }
+};
+
+module.exports = {
+  validateServiceConfiguration,
+};

package/src/entities/service-configurations/domain/validate-update-service-configuration.js

@@ -0,0 +1,19 @@
+const newError = require('http-errors');
+const {
+  ServiceConfigurationErrors,
+} = require('./service-configuration-errors');
+
+const validateUpdateServiceConfiguration =
+  (validator) =>
+  ({ service, didDoc, existingService, otherServices }) => {
+    if (existingService == null) {
+      throw newError(400, ServiceConfigurationErrors.SERVICE_NOT_FOUND, {
+        errorCode: ServiceConfigurationErrors.SERVICE_NOT_FOUND,
+      });
+    }
+    validator({ service, didDoc, otherServices });
+  };
+
+module.exports = {
+  validateUpdateServiceConfiguration,
+};

package/src/entities/service-configurations/index.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+module.exports = {
+  ...require('./domain'),
+  ...require('./orchestrators'),
+};

package/src/entities/service-configurations/orchestrators/create-service-configuration.js

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ *
+ */
+
+const { loadTenantDidDoc } = require('../../tenants');
+const { canonicalizeServiceConfiguration } = require('../domain');
+
+const createServiceConfiguration =
+  (repoName, validator) => async (newService, context) => {
+    const { tenant, repos } = context;
+    const [didDoc, otherServices] = await Promise.all([
+      loadTenantDidDoc(tenant.did, context),
+      repos[repoName].findServices(),
+    ]);
+    validator({ service: newService, didDoc, otherServices });
+
+    const finalService = canonicalizeServiceConfiguration(newService);
+    return repos[repoName].insert(finalService);
+  };
+
+module.exports = { createServiceConfiguration };

package/src/entities/service-configurations/orchestrators/delete-service-configuration.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ *
+ */
+
+const { isEmpty, map } = require('lodash/fp');
+const newError = require('http-errors');
+const { ServiceConfigurationErrors } = require('../domain');
+
+const deleteServiceConfiguration = (repoName) => async (serviceId, context) => {
+  const { repos } = context;
+  const depots = await repos.depots.findDepots(serviceId);
+  if (!isEmpty(depots)) {
+    throw newError(
+      400,
+      `Depot(s) ${map('_id')(
+        depots,
+      )} must be deleted before deleting service ${serviceId}`,
+      {
+        errorCode: ServiceConfigurationErrors.RELATED_DEPOT_UNDELETED,
+      },
+    );
+  }
+  return repos[repoName].delUsingFilter({
+    filter: { _id: serviceId },
+  });
+};
+
+module.exports = { deleteServiceConfiguration };

package/src/entities/service-configurations/orchestrators/index.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * 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.
+ *
+ */
+module.exports = {
+  ...require('./create-service-configuration'),
+  ...require('./delete-service-configuration'),
+  ...require('./update-service-configuration'),
+};

package/src/entities/service-configurations/orchestrators/update-service-configuration.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ *
+ */
+
+const { partition } = require('lodash/fp');
+const { ObjectId } = require('mongodb');
+const { loadTenantDidDoc } = require('../../tenants');
+const { canonicalizeServiceConfiguration } = require('../domain');
+
+const updateServiceConfiguration =
+  (repoName, validator) => async (serviceId, service, context) => {
+    const { tenant, repos } = context;
+    const [didDoc, existingServices] = await Promise.all([
+      loadTenantDidDoc(tenant.did, context),
+      repos[repoName].findServices(),
+    ]);
+    const [[existingService], otherServices] = partition(
+      { _id: new ObjectId(serviceId) },
+      existingServices,
+    );
+    validator({ service, didDoc, existingService, otherServices });
+
+    const finalService = canonicalizeServiceConfiguration(service);
+    return repos[repoName].update(serviceId, finalService);
+  };
+
+module.exports = { updateServiceConfiguration };

package/src/entities/tenants/adapters/index.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright 2024 Velocity Team
+ *
+ * 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.
+ *
+ */
+module.exports = {
+  ...require('./load-tenant-did-doc'),
+  ...require('./load-tenant-profile'),
+};