URL Mapper Transport

1'use strict';
2
3const WRITER_ROOT = '/_api/url-mapper/writer/v1/url-mapping';
4
5function createUrlMapperTransport({ send, inspectDestination }) {
6  if (typeof send !== 'function' || typeof inspectDestination !== 'function') throw new Error('authenticated sender and destination inspection required');
7  return {
8    inspectDestination,
9    async read(key) {
10      const result = await send({ method: 'GET', path: `${WRITER_ROOT}/${encodeURIComponent(key)}` });
11      if (result && (result.code === 'URL_MAPPER_NOT_FOUND' || result.status === 404)) return null;
12      const mapping = result && (result.urlMapping || result.mappingRecord || result);
13      if (!mapping || typeof mapping.mapping !== 'string' || typeof mapping.pageIdentifier !== 'string') {
14        throw new Error(`URL Mapper read-back for ${key} lacks saved mapping or page identifier`);
15      }
16      return mapping;
17    },
18    async write(payload, capability, { mode }) {
19      if (!capability || payload.key !== capability.key || payload.urlMapping?.pageIdentifier !== capability.pageIdentifier) {
20        throw new Error('URL Mapper payload differs from capability knowledge');
21      }
22      if (!['create', 'update'].includes(mode)) throw new Error('URL Mapper write mode required');
23      return send({ method: mode === 'create' ? 'POST' : 'PUT', path: `${WRITER_ROOT}/${encodeURIComponent(payload.key)}`, body: payload });
24    },
25  };
26}
27
28module.exports = { WRITER_ROOT, createUrlMapperTransport };