@fiado/api-invoker 5.71.0 → 5.73.0

package/bin/container.config.js

@@ -122,6 +122,8 @@ import { WalletFundingSettlementApi } from "./walletFundingSettlement/index.js";
 import { WalletFundingRulesApi } from "./wallet-funding-rules/index.js";
 // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
 import { SnsSesConnectorApi } from "./sns-ses-connector/index.js";
+// Twilio connector — envío WhatsApp/SMS por Twilio (lee TWILIO_CONNECTOR_LAMBDA_URL)
+import { TwilioConnectorApi } from "./twilio-connector/index.js";
 // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
 import { RemittanceBusinessApi } from "./remittance-business/index.js";
 import { BeneficiaryApi } from "./beneficiary/index.js";
@@ -269,6 +271,9 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IWalletFundingRulesApi").to(WalletFundingRulesApi);
     // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
     bind("ISnsSesConnectorApi").to(SnsSesConnectorApi);
+    // Twilio connector — envío WhatsApp/SMS por Twilio, elegido por el `provider` del senderConfig.
+    // El consumidor necesita TWILIO_CONNECTOR_LAMBDA_URL desde el SSM `fiado-twilio-connector`.
+    bind("ITwilioConnectorApi").to(TwilioConnectorApi);
     // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
     bind("IRemittanceBusinessApi").to(RemittanceBusinessApi);
     // Borrado en cascada del directorio — deleteByDirectoryId por dominio

package/bin/index.d.ts

@@ -103,6 +103,7 @@ export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
 export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
+export * from "./twilio-connector/index.js";
 export * from "./remittance-business/index.js";
 export * from "./modelias-connector/index.js";
 export * from "./beneficiary/index.js";

package/bin/index.js

@@ -103,6 +103,7 @@ export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
 export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
+export * from "./twilio-connector/index.js";
 export * from "./remittance-business/index.js";
 export * from "./modelias-connector/index.js";
 export * from "./beneficiary/index.js";

package/bin/messages-business/api/MessagesBusinessApi.d.ts

@@ -9,10 +9,12 @@ export declare class MessagesBusinessApi implements IMessagesBusinessApi {
     sendMessage(request: SendMessageRequest): Promise<FiadoApiResponse<SendMessageResponse>>;
     verifyOtp(request: VerifyOtpRequest): Promise<FiadoApiResponse<VerifyOtpResponse>>;
     getValidatedOtp(directoryId: string, otpCode: string): Promise<FiadoApiResponse<OtpValidatedResponse>>;
-    createTemplate(request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    listTemplates(filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>>;
-    getTemplate(id: string): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    updateTemplate(id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    deleteTemplate(id: string): Promise<FiadoApiResponse<void>>;
+    createTemplate(tenantId: string, request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    listTemplates(tenantId: string, filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>>;
+    getTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    updateTemplate(tenantId: string, id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    deleteTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<void>>;
+    /** Cuelga el `tenantId` del query string de una URL sin query previo. */
+    private withTenantId;
 }
 export {};

package/bin/messages-business/api/MessagesBusinessApi.js

@@ -11,6 +11,9 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from 'inversify';
+import { joinUrl } from '../../utils/joinUrl.js';
+// El CRUD de plantillas manda el `tenantId` en el query string. En POST y PUT se cuelga de la URL
+// porque el http-client solo expone canal de params en GET y DELETE.
 let MessagesBusinessApi = class MessagesBusinessApi {
     httpRequest;
     baseUrl = process.env.MESSAGES_BUSINESS_URL || '';
@@ -26,20 +29,28 @@ let MessagesBusinessApi = class MessagesBusinessApi {
     async getValidatedOtp(directoryId, otpCode) {
         return await this.httpRequest.get(`${this.baseUrl}messages/otp/validated`, { directoryId, otpCode }, { 'operationName': 'privateGetValidatedOtp' });
     }
-    async createTemplate(request) {
-        return await this.httpRequest.post(`${this.baseUrl}templates`, request, { 'operationName': 'backofficeCreateTemplate' });
+    async createTemplate(tenantId, request) {
+        const url = this.withTenantId(joinUrl(this.baseUrl, 'templates'), tenantId);
+        return await this.httpRequest.post(url, request, { 'operationName': 'backofficeCreateTemplate' });
     }
-    async listTemplates(filters) {
-        return await this.httpRequest.get(`${this.baseUrl}templates`, filters, { 'operationName': 'backofficeListTemplates' });
+    async listTemplates(tenantId, filters) {
+        // El tenant explicito pisa el que venga en los filtros: si no, viajarian dos `tenantId`.
+        const params = { ...filters, tenantId };
+        return await this.httpRequest.get(joinUrl(this.baseUrl, 'templates'), params, { 'operationName': 'backofficeListTemplates' });
     }
-    async getTemplate(id) {
-        return await this.httpRequest.get(`${this.baseUrl}templates/${id}`, undefined, { 'operationName': 'backofficeGetTemplate' });
+    async getTemplate(tenantId, id) {
+        return await this.httpRequest.get(joinUrl(this.baseUrl, `templates/${id}`), { tenantId }, { 'operationName': 'backofficeGetTemplate' });
     }
-    async updateTemplate(id, request) {
-        return await this.httpRequest.put(`${this.baseUrl}templates/${id}`, request, { 'operationName': 'backofficeUpdateTemplate' });
+    async updateTemplate(tenantId, id, request) {
+        const url = this.withTenantId(joinUrl(this.baseUrl, `templates/${id}`), tenantId);
+        return await this.httpRequest.put(url, request, { 'operationName': 'backofficeUpdateTemplate' });
     }
-    async deleteTemplate(id) {
-        return await this.httpRequest.delete(`${this.baseUrl}templates/${id}`, undefined, { 'operationName': 'backofficeDeleteTemplate' });
+    async deleteTemplate(tenantId, id) {
+        return await this.httpRequest.delete(joinUrl(this.baseUrl, `templates/${id}`), { tenantId }, { 'operationName': 'backofficeDeleteTemplate' });
+    }
+    /** Cuelga el `tenantId` del query string de una URL sin query previo. */
+    withTenantId(url, tenantId) {
+        return `${url}?tenantId=${encodeURIComponent(tenantId)}`;
     }
 };
 MessagesBusinessApi = __decorate([

package/bin/messages-business/api/interfaces/IMessagesBusinessApi.d.ts

@@ -4,10 +4,14 @@ export interface IMessagesBusinessApi {
     sendMessage(request: SendMessageRequest): Promise<FiadoApiResponse<SendMessageResponse>>;
     verifyOtp(request: VerifyOtpRequest): Promise<FiadoApiResponse<VerifyOtpResponse>>;
     getValidatedOtp(directoryId: string, otpCode: string): Promise<FiadoApiResponse<OtpValidatedResponse>>;
-    createTemplate(request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    listTemplates(filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>>;
-    getTemplate(id: string): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    updateTemplate(id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    deleteTemplate(id: string): Promise<FiadoApiResponse<void>>;
+    /**
+     * CRUD de plantillas. Los cinco viven en la API privada sin authorizer, asi que el `tenantId`
+     * es obligatorio y explicito: el lambda responde 400 TENANT_ID_REQUIRED si no llega.
+     */
+    createTemplate(tenantId: string, request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    listTemplates(tenantId: string, filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>>;
+    getTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    updateTemplate(tenantId: string, id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    deleteTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<void>>;
 }
 export {};

package/bin/sns-ses-connector/api/SnsSesConnectorApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from 'inversify';
+import { joinUrl } from '../../utils/joinUrl.js';
 let SnsSesConnectorApi = class SnsSesConnectorApi {
     httpRequest;
     baseUrl = process.env.SNS_SES_CONNECTOR_LAMBDA_URL || '';
@@ -18,7 +19,7 @@ let SnsSesConnectorApi = class SnsSesConnectorApi {
         this.httpRequest = httpRequest;
     }
     async send(request) {
-        const url = `${this.baseUrl}send`;
+        const url = joinUrl(this.baseUrl, 'send');
         return await this.httpRequest.post(url, request, { 'operationName': 'privateSend' });
     }
 };

package/bin/twilio-connector/api/TwilioConnectorApi.d.ts

@@ -1,4 +1,4 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
 import { ITwilioConnectorApi } from "./interfaces/ITwilioConnectorApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;

package/bin/twilio-connector/api/TwilioConnectorApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+import { joinUrl } from "../../utils/joinUrl.js";
 let TwilioConnectorApi = class TwilioConnectorApi {
     httpRequest;
     baseUrl = process.env.TWILIO_CONNECTOR_LAMBDA_URL || "";
@@ -18,7 +19,7 @@ let TwilioConnectorApi = class TwilioConnectorApi {
         this.httpRequest = httpRequest;
     }
     async send(request) {
-        const url = `${this.baseUrl}/messages/send`;
+        const url = joinUrl(this.baseUrl, "messages/send");
         return await this.httpRequest.post(url, request, { operationName: "privateSendMessage" });
     }
 };

package/bin/utils/joinUrl.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Une la URL base de un lambda con un path relativo dejando exactamente una barra
+ * entre ambos, venga o no la base con barra final desde SSM.
+ */
+export declare function joinUrl(baseUrl: string, path: string): string;

package/bin/utils/joinUrl.js

@@ -0,0 +1,9 @@
+/**
+ * Une la URL base de un lambda con un path relativo dejando exactamente una barra
+ * entre ambos, venga o no la base con barra final desde SSM.
+ */
+export function joinUrl(baseUrl, path) {
+    const base = baseUrl.replace(/\/+$/, '');
+    const relativePath = path.replace(/^\/+/, '');
+    return `${base}/${relativePath}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.71.0",
+  "version": "5.73.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",

package/src/container.config.ts

@@ -187,6 +187,8 @@ import { IWalletFundingSettlementApi, WalletFundingSettlementApi } from "./walle
 import { IWalletFundingRulesApi, WalletFundingRulesApi } from "./wallet-funding-rules/index.js";
 // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
 import { ISnsSesConnectorApi, SnsSesConnectorApi } from "./sns-ses-connector/index.js";
+// Twilio connector — envío WhatsApp/SMS por Twilio (lee TWILIO_CONNECTOR_LAMBDA_URL)
+import { ITwilioConnectorApi, TwilioConnectorApi } from "./twilio-connector/index.js";
 // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
 import { IRemittanceBusinessApi, RemittanceBusinessApi } from "./remittance-business/index.js";
 import { IBeneficiaryApi, BeneficiaryApi } from "./beneficiary/index.js";
@@ -360,6 +362,10 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // SNS/SES connector — envío SMS/MAIL síncrono (restaurado para RBAC — DEC-002 messages-business)
     bind<ISnsSesConnectorApi>("ISnsSesConnectorApi").to(SnsSesConnectorApi);
 
+    // Twilio connector — envío WhatsApp/SMS por Twilio, elegido por el `provider` del senderConfig.
+    // El consumidor necesita TWILIO_CONNECTOR_LAMBDA_URL desde el SSM `fiado-twilio-connector`.
+    bind<ITwilioConnectorApi>("ITwilioConnectorApi").to(TwilioConnectorApi);
+
     // Remittance business — pricingResolve (Dashboard Ops Fase B, puente de resolución de precio en send-time)
     bind<IRemittanceBusinessApi>("IRemittanceBusinessApi").to(RemittanceBusinessApi);
 

package/src/index.ts

@@ -103,6 +103,7 @@ export * from "./uniteller-connector/index.js";
 export * from "./walletFundingSettlement/index.js";
 export * from "./wallet-funding-rules/index.js";
 export * from "./sns-ses-connector/index.js";
+export * from "./twilio-connector/index.js";
 export * from "./remittance-business/index.js";
 export * from "./modelias-connector/index.js";
 export * from "./beneficiary/index.js";

package/src/messages-business/api/MessagesBusinessApi.ts

@@ -9,7 +9,10 @@ import {
     TemplateMessageResponse, TemplateMessageListResponse, TemplateMessageListFiltersRequest,
 } from '@fiado/type-kit/bin/messagesConnector/index.js';
 import { IMessagesBusinessApi } from './interfaces/IMessagesBusinessApi.js';
+import { joinUrl } from '../../utils/joinUrl.js';
 
+// El CRUD de plantillas manda el `tenantId` en el query string. En POST y PUT se cuelga de la URL
+// porque el http-client solo expone canal de params en GET y DELETE.
 @injectable()
 export class MessagesBusinessApi implements IMessagesBusinessApi {
     private readonly baseUrl = process.env.MESSAGES_BUSINESS_URL || '';
@@ -28,23 +31,32 @@ export class MessagesBusinessApi implements IMessagesBusinessApi {
         return await this.httpRequest.get(`${this.baseUrl}messages/otp/validated`, { directoryId, otpCode }, { 'operationName': 'privateGetValidatedOtp' });
     }
 
-    async createTemplate(request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>> {
-        return await this.httpRequest.post(`${this.baseUrl}templates`, request, { 'operationName': 'backofficeCreateTemplate' });
+    async createTemplate(tenantId: string, request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>> {
+        const url = this.withTenantId(joinUrl(this.baseUrl, 'templates'), tenantId);
+        return await this.httpRequest.post(url, request, { 'operationName': 'backofficeCreateTemplate' });
     }
 
-    async listTemplates(filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>> {
-        return await this.httpRequest.get(`${this.baseUrl}templates`, filters as Record<string, unknown>, { 'operationName': 'backofficeListTemplates' });
+    async listTemplates(tenantId: string, filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>> {
+        // El tenant explicito pisa el que venga en los filtros: si no, viajarian dos `tenantId`.
+        const params = { ...filters, tenantId } as Record<string, unknown>;
+        return await this.httpRequest.get(joinUrl(this.baseUrl, 'templates'), params, { 'operationName': 'backofficeListTemplates' });
     }
 
-    async getTemplate(id: string): Promise<FiadoApiResponse<TemplateMessageResponse>> {
-        return await this.httpRequest.get(`${this.baseUrl}templates/${id}`, undefined, { 'operationName': 'backofficeGetTemplate' });
+    async getTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<TemplateMessageResponse>> {
+        return await this.httpRequest.get(joinUrl(this.baseUrl, `templates/${id}`), { tenantId }, { 'operationName': 'backofficeGetTemplate' });
     }
 
-    async updateTemplate(id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>> {
-        return await this.httpRequest.put(`${this.baseUrl}templates/${id}`, request, { 'operationName': 'backofficeUpdateTemplate' });
+    async updateTemplate(tenantId: string, id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>> {
+        const url = this.withTenantId(joinUrl(this.baseUrl, `templates/${id}`), tenantId);
+        return await this.httpRequest.put(url, request, { 'operationName': 'backofficeUpdateTemplate' });
     }
 
-    async deleteTemplate(id: string): Promise<FiadoApiResponse<void>> {
-        return await this.httpRequest.delete(`${this.baseUrl}templates/${id}`, undefined, { 'operationName': 'backofficeDeleteTemplate' });
+    async deleteTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<void>> {
+        return await this.httpRequest.delete(joinUrl(this.baseUrl, `templates/${id}`), { tenantId }, { 'operationName': 'backofficeDeleteTemplate' });
+    }
+
+    /** Cuelga el `tenantId` del query string de una URL sin query previo. */
+    private withTenantId(url: string, tenantId: string): string {
+        return `${url}?tenantId=${encodeURIComponent(tenantId)}`;
     }
 }

package/src/messages-business/api/interfaces/IMessagesBusinessApi.ts

@@ -12,9 +12,13 @@ export interface IMessagesBusinessApi {
     verifyOtp(request: VerifyOtpRequest): Promise<FiadoApiResponse<VerifyOtpResponse>>;
     getValidatedOtp(directoryId: string, otpCode: string): Promise<FiadoApiResponse<OtpValidatedResponse>>;
 
-    createTemplate(request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    listTemplates(filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>>;
-    getTemplate(id: string): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    updateTemplate(id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
-    deleteTemplate(id: string): Promise<FiadoApiResponse<void>>;
+    /**
+     * CRUD de plantillas. Los cinco viven en la API privada sin authorizer, asi que el `tenantId`
+     * es obligatorio y explicito: el lambda responde 400 TENANT_ID_REQUIRED si no llega.
+     */
+    createTemplate(tenantId: string, request: TemplateMessageCreateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    listTemplates(tenantId: string, filters: TemplateMessageListFiltersRequest): Promise<FiadoApiResponse<TemplateMessageListResponse>>;
+    getTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    updateTemplate(tenantId: string, id: string, request: TemplateMessageUpdateRequest): Promise<FiadoApiResponse<TemplateMessageResponse>>;
+    deleteTemplate(tenantId: string, id: string): Promise<FiadoApiResponse<void>>;
 }

package/src/sns-ses-connector/api/SnsSesConnectorApi.ts

@@ -2,6 +2,7 @@ import { inject, injectable } from 'inversify';
 import type { IHttpRequest } from '@fiado/http-client';
 import { MessageDeliveryRequest, MessageDeliveryResponse } from '@fiado/type-kit/bin/messaging/index.js';
 import { ISnsSesConnectorApi } from './interfaces/ISnsSesConnectorApi.js';
+import { joinUrl } from '../../utils/joinUrl.js';
 
 type FiadoApiResponse<T> = import('@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js').default<T>;
 
@@ -12,7 +13,7 @@ export class SnsSesConnectorApi implements ISnsSesConnectorApi {
     constructor(@inject('IHttpRequest') private readonly httpRequest: IHttpRequest) {}
 
     async send(request: MessageDeliveryRequest): Promise<FiadoApiResponse<MessageDeliveryResponse>> {
-        const url = `${this.baseUrl}send`;
+        const url = joinUrl(this.baseUrl, 'send');
         return await this.httpRequest.post(url, request, { 'operationName': 'privateSend' });
     }
 }

package/src/twilio-connector/api/TwilioConnectorApi.ts

@@ -1,7 +1,8 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { ConnectorSendMessageRequest, ConnectorSendMessageResponse } from "@fiado/type-kit/bin/twilioConnector/index.js";
 import { ITwilioConnectorApi } from "./interfaces/ITwilioConnectorApi.js";
+import { joinUrl } from "../../utils/joinUrl.js";
 
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 
@@ -12,7 +13,7 @@ export default class TwilioConnectorApi implements ITwilioConnectorApi {
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
 
     async send(request: ConnectorSendMessageRequest): Promise<FiadoApiResponse<ConnectorSendMessageResponse>> {
-        const url = `${this.baseUrl}/messages/send`;
+        const url = joinUrl(this.baseUrl, "messages/send");
         return await this.httpRequest.post(url, request, { operationName: "privateSendMessage" });
     }
 }

package/src/utils/joinUrl.ts

@@ -0,0 +1,9 @@
+/**
+ * Une la URL base de un lambda con un path relativo dejando exactamente una barra
+ * entre ambos, venga o no la base con barra final desde SSM.
+ */
+export function joinUrl(baseUrl: string, path: string): string {
+    const base = baseUrl.replace(/\/+$/, '');
+    const relativePath = path.replace(/^\/+/, '');
+    return `${base}/${relativePath}`;
+}