vintasend-api 0.0.0-stage → 1.0.0-alpha6

package/dist/services/github-template-client.js

@@ -0,0 +1,148 @@
+import { getGitHubTemplatePreviewConfigFromEnv, } from './github-template-preview-config.js';
+import { resolveTemplatePath } from './template-path-resolver.js';
+/**
+ * Decode GitHub's base64 file content as UTF-8, with Web APIs only, so the client works wherever
+ * `fetch` does and not just in Node.
+ */
+function decodeBase64Utf8(base64) {
+    const binary = atob(base64);
+    return new TextDecoder().decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
+}
+export class GitHubTemplateClient {
+    config;
+    fetcher;
+    cacheMaxEntries;
+    cache = new Map();
+    constructor(config, fetcher = fetch, options = {}) {
+        this.config = config;
+        this.fetcher = fetcher;
+        this.cacheMaxEntries = options.cacheMaxEntries ?? 100;
+    }
+    async getTemplateContentByCommit(request) {
+        const resolvedPath = resolveTemplatePath(request.templatePath, {
+            templatesBasePath: this.config.templatesBasePath,
+        });
+        const cacheKey = this.buildCacheKey(resolvedPath, request.gitCommitSha);
+        const fromCache = this.cache.get(cacheKey);
+        if (fromCache !== undefined) {
+            return fromCache;
+        }
+        const apiUrl = this.buildApiUrl(resolvedPath, request.gitCommitSha);
+        const response = await this.fetcher(apiUrl, {
+            method: 'GET',
+            headers: this.buildHeaders(),
+        });
+        if (!response.ok) {
+            throw await this.buildHttpError(response);
+        }
+        const payload = (await response.json());
+        if (!payload.content || payload.encoding !== 'base64') {
+            throw new Error('GitHub template response is invalid or unsupported.');
+        }
+        const decoded = decodeBase64Utf8(payload.content.replace(/\n/g, ''));
+        this.setCache(cacheKey, decoded);
+        return decoded;
+    }
+    async getLatestMainCommitSha() {
+        const apiUrl = `${this.config.apiBaseUrl}/repos/${this.config.repo}/commits/main`;
+        const response = await this.fetcher(apiUrl, {
+            method: 'GET',
+            headers: this.buildHeaders(),
+        });
+        if (!response.ok) {
+            throw await this.buildCommitLookupHttpError(response);
+        }
+        const payload = (await response.json());
+        if (!payload.sha) {
+            throw new Error('GitHub main branch commit lookup returned an invalid response.');
+        }
+        return payload.sha;
+    }
+    buildApiUrl(path, gitCommitSha) {
+        const encodedPath = path
+            .split('/')
+            .map((segment) => encodeURIComponent(segment))
+            .join('/');
+        const refParam = encodeURIComponent(gitCommitSha);
+        return `${this.config.apiBaseUrl}/repos/${this.config.repo}/contents/${encodedPath}?ref=${refParam}`;
+    }
+    buildCacheKey(path, gitCommitSha) {
+        return `${this.config.repo}:${path}:${gitCommitSha}`;
+    }
+    buildHeaders() {
+        return {
+            Accept: 'application/vnd.github+json',
+            Authorization: `Bearer ${this.config.apiKey}`,
+            'X-GitHub-Api-Version': '2022-11-28',
+        };
+    }
+    setCache(key, value) {
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        this.cache.set(key, value);
+        while (this.cache.size > this.cacheMaxEntries) {
+            const firstKey = this.cache.keys().next().value;
+            if (!firstKey) {
+                break;
+            }
+            this.cache.delete(firstKey);
+        }
+    }
+    async buildHttpError(response) {
+        if (response.status === 404) {
+            return new Error('Template file was not found in GitHub for the requested commit.');
+        }
+        if (response.status === 403) {
+            const remaining = response.headers.get('x-ratelimit-remaining');
+            if (remaining === '0') {
+                return new Error('GitHub API rate limit exceeded while fetching template preview.');
+            }
+            return new Error('GitHub API request was forbidden. Check repository access and token permissions.');
+        }
+        if (response.status === 429) {
+            return new Error('GitHub API rate limit exceeded while fetching template preview.');
+        }
+        let messageSuffix = '';
+        try {
+            const body = (await response.json());
+            if (body.message) {
+                messageSuffix = `: ${body.message}`;
+            }
+        }
+        catch {
+            // noop
+        }
+        return new Error(`GitHub template fetch failed with status ${response.status}${messageSuffix}`);
+    }
+    async buildCommitLookupHttpError(response) {
+        if (response.status === 404) {
+            return new Error('Unable to resolve latest commit SHA from the main branch.');
+        }
+        if (response.status === 403) {
+            const remaining = response.headers.get('x-ratelimit-remaining');
+            if (remaining === '0') {
+                return new Error('GitHub API rate limit exceeded while fetching template preview.');
+            }
+            return new Error('GitHub API request was forbidden. Check repository access and token permissions.');
+        }
+        if (response.status === 429) {
+            return new Error('GitHub API rate limit exceeded while fetching template preview.');
+        }
+        let messageSuffix = '';
+        try {
+            const body = (await response.json());
+            if (body.message) {
+                messageSuffix = `: ${body.message}`;
+            }
+        }
+        catch {
+            // noop
+        }
+        return new Error(`GitHub main branch commit lookup failed with status ${response.status}${messageSuffix}`);
+    }
+}
+export function createGitHubTemplateClientFromEnv(options = {}) {
+    return new GitHubTemplateClient(getGitHubTemplatePreviewConfigFromEnv(), fetch, options);
+}
+//# sourceMappingURL=github-template-client.js.map

package/dist/services/github-template-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-template-client.js","sourceRoot":"","sources":["../../src/services/github-template-client.ts"],"names":[],"mappings":"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"}

package/dist/services/github-template-preview-config.d.ts

@@ -0,0 +1,8 @@
+export declare const DEFAULT_GITHUB_API_BASE_URL = "https://api.github.com";
+export type GitHubTemplatePreviewConfig = {
+    repo: string;
+    apiKey: string;
+    apiBaseUrl: string;
+    templatesBasePath?: string;
+};
+export declare function getGitHubTemplatePreviewConfigFromEnv(): GitHubTemplatePreviewConfig;

package/dist/services/github-template-preview-config.js

@@ -0,0 +1,51 @@
+export const DEFAULT_GITHUB_API_BASE_URL = 'https://api.github.com';
+function normalizeBaseUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+function normalizeRepo(repo) {
+    const trimmedRepo = repo.trim().replace(/\.git$/, '');
+    if (/^https?:\/\//i.test(trimmedRepo)) {
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(trimmedRepo);
+        }
+        catch {
+            throw new Error('GITHUB_REPO must be a valid GitHub repository URL or owner/repo.');
+        }
+        const segments = parsedUrl.pathname.split('/').filter(Boolean);
+        if (segments.length < 2) {
+            throw new Error('GITHUB_REPO URL must include owner and repository name.');
+        }
+        return `${segments[0]}/${segments[1]}`;
+    }
+    const sshMatch = trimmedRepo.match(/^git@[^:]+:([^/\s]+)\/([^/\s]+)$/);
+    if (sshMatch) {
+        const owner = sshMatch[1];
+        const repoName = sshMatch[2]?.replace(/\.git$/, '');
+        return `${owner}/${repoName}`;
+    }
+    const directMatch = trimmedRepo.match(/^([^/\s]+)\/([^/\s]+)$/);
+    if (directMatch) {
+        return `${directMatch[1]}/${directMatch[2]}`;
+    }
+    throw new Error('GITHUB_REPO is required in owner/repo format or as a GitHub repository URL.');
+}
+export function getGitHubTemplatePreviewConfigFromEnv() {
+    const repo = process.env.GITHUB_REPO?.trim();
+    const apiKey = process.env.GITHUB_API_KEY?.trim();
+    const apiBaseUrl = (process.env.GITHUB_API_BASE_URL || DEFAULT_GITHUB_API_BASE_URL).trim();
+    const templatesBasePath = process.env.GITHUB_TEMPLATES_BASE_PATH?.trim();
+    if (!repo) {
+        throw new Error('GITHUB_REPO is required (owner/repo).');
+    }
+    if (!apiKey) {
+        throw new Error('GITHUB_API_KEY is required for template preview.');
+    }
+    return {
+        repo: normalizeRepo(repo),
+        apiKey,
+        apiBaseUrl: normalizeBaseUrl(apiBaseUrl),
+        templatesBasePath,
+    };
+}
+//# sourceMappingURL=github-template-preview-config.js.map

package/dist/services/github-template-preview-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-template-preview-config.js","sourceRoot":"","sources":["../../src/services/github-template-preview-config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AASpE,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEtD,IAAI,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,IAAI,SAAc,CAAC;QAEnB,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACvE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpD,OAAO,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAChE,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,2BAA2B,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3F,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,EAAE,CAAC;IAEzE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,MAAM;QACN,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC;QACxC,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/services/notification-preview.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Builds a rendered preview of a notification's templates.
+ *
+ * Templates are fetched from GitHub at the commit SHA persisted with the
+ * notification, so a preview always shows the template as it was when the
+ * notification was created. Notifications that are still pending fall back to
+ * the current `main` commit, since they have not been rendered yet.
+ */
+import type { NotificationPreview } from '../contract/types.js';
+import type { ApiAnyDatabaseNotification, NotificationServicePort } from './notification-service-port.js';
+export interface TemplateSourceClient {
+    getTemplateContentByCommit(request: {
+        templatePath: string;
+        gitCommitSha: string;
+    }): Promise<string>;
+    getLatestMainCommitSha(): Promise<string>;
+}
+export declare function buildNotificationPreview({ service, templateClient, notification, }: {
+    service: NotificationServicePort;
+    templateClient: TemplateSourceClient;
+    notification: ApiAnyDatabaseNotification;
+}): Promise<NotificationPreview>;

package/dist/services/notification-preview.js

@@ -0,0 +1,66 @@
+/**
+ * Builds a rendered preview of a notification's templates.
+ *
+ * Templates are fetched from GitHub at the commit SHA persisted with the
+ * notification, so a preview always shows the template as it was when the
+ * notification was created. Notifications that are still pending fall back to
+ * the current `main` commit, since they have not been rendered yet.
+ */
+import { ApiError, errorMessage } from '../errors.js';
+/**
+ * Runs a template-source call, reporting its failures as UPSTREAM_ERROR (502).
+ *
+ * A template lookup depends on a third party (GitHub, by default): being unable
+ * to reach it, or being refused by it, is not a fault of this API and should not
+ * read as one. The client's messages are deterministic and carry no credentials,
+ * so they are safe to pass through to the caller.
+ */
+async function fromTemplateSource(operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (error instanceof ApiError) {
+            throw error;
+        }
+        throw new ApiError('UPSTREAM_ERROR', errorMessage(error));
+    }
+}
+export async function buildNotificationPreview({ service, templateClient, notification, }) {
+    let gitCommitSha = notification.gitCommitSha;
+    if (!gitCommitSha && notification.status === 'PENDING_SEND') {
+        gitCommitSha = await fromTemplateSource(() => templateClient.getLatestMainCommitSha());
+    }
+    if (!gitCommitSha) {
+        throw new ApiError('PREVIEW_UNAVAILABLE', 'This notification does not have a tracked git commit SHA and is not pending send, so preview is unavailable.');
+    }
+    const bodyTemplateContent = await fromTemplateSource(() => templateClient.getTemplateContentByCommit({
+        templatePath: notification.bodyTemplate,
+        gitCommitSha,
+    }));
+    let subjectTemplateContent = null;
+    if (notification.subjectTemplate) {
+        const subjectTemplate = notification.subjectTemplate;
+        subjectTemplateContent = await fromTemplateSource(() => templateClient.getTemplateContentByCommit({
+            templatePath: subjectTemplate,
+            gitCommitSha,
+        }));
+    }
+    // Context generators may be async, so a stored context is typed as possibly a
+    // promise; awaiting resolves that without changing already-materialised data.
+    const storedContext = notification.contextUsed ? await notification.contextUsed : null;
+    const renderedTemplate = await service.renderEmailTemplateFromContent(notification, { body: bodyTemplateContent, subject: subjectTemplateContent }, storedContext
+        ? { context: storedContext }
+        : {
+            contextName: notification.contextName,
+            contextParameters: notification.contextParameters,
+        });
+    return {
+        gitCommitSha,
+        bodyTemplatePath: notification.bodyTemplate,
+        subjectTemplatePath: notification.subjectTemplate,
+        renderedBodyHtml: renderedTemplate.body,
+        renderedSubjectHtml: renderedTemplate.subject,
+    };
+}
+//# sourceMappingURL=notification-preview.js.map

package/dist/services/notification-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-preview.js","sourceRoot":"","sources":["../../src/services/notification-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMtD;;;;;;;GAOG;AACH,KAAK,UAAU,kBAAkB,CAAI,SAA2B;IAC9D,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,EAC7C,OAAO,EACP,cAAc,EACd,YAAY,GAKb;IACC,IAAI,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC;IAE7C,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAC5D,YAAY,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,QAAQ,CAChB,qBAAqB,EACrB,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IAED,MAAM,mBAAmB,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,CACxD,cAAc,CAAC,0BAA0B,CAAC;QACxC,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,YAAY;KACb,CAAC,CACH,CAAC;IAEF,IAAI,sBAAsB,GAAkB,IAAI,CAAC;IACjD,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,YAAY,CAAC,eAAe,CAAC;QACrD,sBAAsB,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,CACrD,cAAc,CAAC,0BAA0B,CAAC;YACxC,YAAY,EAAE,eAAe;YAC7B,YAAY;SACb,CAAC,CACH,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvF,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,8BAA8B,CACnE,YAAY,EACZ,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAC9D,aAAa;QACX,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE;QAC5B,CAAC,CAAC;YACE,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,iBAAiB,EAAE,YAAY,CAAC,iBAAiB;SAClD,CACN,CAAC;IAEF,OAAO;QACL,YAAY;QACZ,gBAAgB,EAAE,YAAY,CAAC,YAAY;QAC3C,mBAAmB,EAAE,YAAY,CAAC,eAAe;QACjD,gBAAgB,EAAE,gBAAgB,CAAC,IAAI;QACvC,mBAAmB,EAAE,gBAAgB,CAAC,OAAO;KAC9C,CAAC;AACJ,CAAC"}

package/dist/services/notification-service-port.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The slice of a VintaSend service this API depends on.
+ *
+ * The API is generic over notification config: it only reads fields that exist
+ * on every notification, so it pins the config to `BaseNotificationTypeConfig`.
+ * Operator-provided services are configured with their own concrete config and
+ * are adapted to this port when loaded (see `service-loader.ts`).
+ */
+import type { AnyDatabaseNotification, BaseNotificationTypeConfig, DatabaseNotification, DatabaseOneOffNotification, EmailTemplate, EmailTemplateContent, JsonObject, NotificationFilterCapabilities, NotificationFilterFields, NotificationOrderBy } from 'vintasend';
+export type ApiNotificationConfig = BaseNotificationTypeConfig;
+export type ApiDatabaseNotification = DatabaseNotification<ApiNotificationConfig>;
+export type ApiDatabaseOneOffNotification = DatabaseOneOffNotification<ApiNotificationConfig>;
+export type ApiAnyDatabaseNotification = AnyDatabaseNotification<ApiNotificationConfig>;
+export type ApiNotificationFilterFields = NotificationFilterFields<ApiNotificationConfig>;
+export type RenderContextInput = {
+    context: JsonObject;
+} | {
+    contextName: string;
+    contextParameters: JsonObject;
+};
+export interface NotificationServicePort {
+    getBackendSupportedFilterCapabilities(backendIdentifier?: string): Promise<NotificationFilterCapabilities>;
+    filterNotifications(filter: ApiNotificationFilterFields, page: number, pageSize: number, orderBy?: NotificationOrderBy, backendIdentifier?: string): Promise<ApiAnyDatabaseNotification[]>;
+    getPendingNotifications(page: number, pageSize: number, backendIdentifier?: string): Promise<ApiAnyDatabaseNotification[]>;
+    getFutureNotifications(page: number, pageSize: number, backendIdentifier?: string): Promise<ApiAnyDatabaseNotification[]>;
+    getOneOffNotifications(page: number, pageSize: number, backendIdentifier?: string): Promise<ApiDatabaseOneOffNotification[]>;
+    getNotification(notificationId: string, forUpdate?: boolean, backendIdentifier?: string): Promise<ApiDatabaseNotification | null>;
+    getOneOffNotification(notificationId: string, forUpdate?: boolean, backendIdentifier?: string): Promise<ApiDatabaseOneOffNotification | null>;
+    resendNotification(notificationId: string, useStoredContextIfAvailable?: boolean): Promise<ApiDatabaseNotification | undefined>;
+    cancelNotification(notificationId: string): Promise<void>;
+    renderEmailTemplateFromContent(notification: ApiAnyDatabaseNotification, templateContent: EmailTemplateContent, contextInput: RenderContextInput): Promise<EmailTemplate>;
+}
+/**
+ * Resolves a VintaSend service (or anything structurally compatible) to the port.
+ *
+ * VintaSend services are generic over the operator's notification config, so a
+ * concrete service is not assignable to the base-config port even though every
+ * member the API touches is compatible. The cast is confined to this function.
+ */
+export declare function asNotificationServicePort(service: unknown): NotificationServicePort;

package/dist/services/notification-service-port.js

@@ -0,0 +1,19 @@
+/**
+ * The slice of a VintaSend service this API depends on.
+ *
+ * The API is generic over notification config: it only reads fields that exist
+ * on every notification, so it pins the config to `BaseNotificationTypeConfig`.
+ * Operator-provided services are configured with their own concrete config and
+ * are adapted to this port when loaded (see `service-loader.ts`).
+ */
+/**
+ * Resolves a VintaSend service (or anything structurally compatible) to the port.
+ *
+ * VintaSend services are generic over the operator's notification config, so a
+ * concrete service is not assignable to the base-config port even though every
+ * member the API touches is compatible. The cast is confined to this function.
+ */
+export function asNotificationServicePort(service) {
+    return service;
+}
+//# sourceMappingURL=notification-service-port.js.map

package/dist/services/notification-service-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service-port.js","sourceRoot":"","sources":["../../src/services/notification-service-port.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmFH;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO,OAAkC,CAAC;AAC5C,CAAC"}

package/dist/services/paged-notification-reader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The one place page numbers are translated.
+ *
+ * Routes deal exclusively in the contract's 1-indexed pages; this wrapper takes
+ * those, reads the backend's pagination convention once per request, and calls
+ * the service with whatever numbering it expects. Keeping the arithmetic here
+ * rather than in each route means a route cannot forget it — which is how
+ * `/pending`, `/future` and `/one-off` previously ended up paging by assumption.
+ */
+import type { NotificationFilterCapabilities, NotificationOrderBy } from 'vintasend';
+import type { ApiAnyDatabaseNotification, ApiDatabaseOneOffNotification, ApiNotificationFilterFields, NotificationServicePort } from './notification-service-port.js';
+export interface PagedNotificationReader {
+    /**
+     * The backend's capability report, fetched at most once per reader.
+     */
+    capabilities(): Promise<NotificationFilterCapabilities>;
+    filterNotifications(filter: ApiNotificationFilterFields, page: number, pageSize: number, orderBy?: NotificationOrderBy): Promise<ApiAnyDatabaseNotification[]>;
+    getPendingNotifications(page: number, pageSize: number): Promise<ApiAnyDatabaseNotification[]>;
+    getFutureNotifications(page: number, pageSize: number): Promise<ApiAnyDatabaseNotification[]>;
+    getOneOffNotifications(page: number, pageSize: number): Promise<ApiDatabaseOneOffNotification[]>;
+}
+export declare function createPagedNotificationReader(service: NotificationServicePort, backendIdentifier?: string | undefined): PagedNotificationReader;

package/dist/services/paged-notification-reader.js

@@ -0,0 +1,36 @@
+/**
+ * The one place page numbers are translated.
+ *
+ * Routes deal exclusively in the contract's 1-indexed pages; this wrapper takes
+ * those, reads the backend's pagination convention once per request, and calls
+ * the service with whatever numbering it expects. Keeping the arithmetic here
+ * rather than in each route means a route cannot forget it — which is how
+ * `/pending`, `/future` and `/one-off` previously ended up paging by assumption.
+ */
+import { toBackendPage } from '../domain/pagination.js';
+export function createPagedNotificationReader(service, backendIdentifier) {
+    let cached;
+    const capabilities = () => {
+        if (!cached) {
+            cached = service.getBackendSupportedFilterCapabilities(backendIdentifier);
+        }
+        return cached;
+    };
+    const backendPage = async (page) => toBackendPage(page, await capabilities());
+    return {
+        capabilities,
+        async filterNotifications(filter, page, pageSize, orderBy) {
+            return service.filterNotifications(filter, await backendPage(page), pageSize, orderBy, backendIdentifier);
+        },
+        async getPendingNotifications(page, pageSize) {
+            return service.getPendingNotifications(await backendPage(page), pageSize, backendIdentifier);
+        },
+        async getFutureNotifications(page, pageSize) {
+            return service.getFutureNotifications(await backendPage(page), pageSize, backendIdentifier);
+        },
+        async getOneOffNotifications(page, pageSize) {
+            return service.getOneOffNotifications(await backendPage(page), pageSize, backendIdentifier);
+        },
+    };
+}
+//# sourceMappingURL=paged-notification-reader.js.map

package/dist/services/paged-notification-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paged-notification-reader.js","sourceRoot":"","sources":["../../src/services/paged-notification-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA4BxD,MAAM,UAAU,6BAA6B,CAC3C,OAAgC,EAChC,iBAAsC;IAEtC,IAAI,MAA2D,CAAC;IAEhE,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,OAAO,CAAC,qCAAqC,CAAC,iBAAiB,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,YAAY,EAAE,CAAC,CAAC;IAEtF,OAAO;QACL,YAAY;QAEZ,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO;YACvD,OAAO,OAAO,CAAC,mBAAmB,CAChC,MAAM,EACN,MAAM,WAAW,CAAC,IAAI,CAAC,EACvB,QAAQ,EACR,OAAO,EACP,iBAAiB,CAClB,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,uBAAuB,CAAC,IAAI,EAAE,QAAQ;YAC1C,OAAO,OAAO,CAAC,uBAAuB,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC/F,CAAC;QAED,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ;YACzC,OAAO,OAAO,CAAC,sBAAsB,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC9F,CAAC;QAED,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ;YACzC,OAAO,OAAO,CAAC,sBAAsB,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC9F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/service-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Loads the operator-provided VintaSend service.
+ *
+ * The API ships no backend of its own: which database, adapters and template
+ * renderers to use is a deployment decision. `VINTASEND_SERVICE_MODULE` points
+ * at a module whose default export builds a configured VintaSend service; see
+ * `src/vintasend.config.example.ts` and the README.
+ */
+import { type NotificationServicePort } from './notification-service-port.js';
+export type VintaSendServiceFactory = () => Promise<unknown> | unknown;
+export declare function loadNotificationService(modulePath: string): Promise<NotificationServicePort>;
+/**
+ * Builds the service once and reuses it for every request.
+ */
+export declare function createServiceProvider(modulePath: string): () => Promise<NotificationServicePort>;

package/dist/services/service-loader.js

@@ -0,0 +1,56 @@
+/**
+ * Loads the operator-provided VintaSend service.
+ *
+ * The API ships no backend of its own: which database, adapters and template
+ * renderers to use is a deployment decision. `VINTASEND_SERVICE_MODULE` points
+ * at a module whose default export builds a configured VintaSend service; see
+ * `src/vintasend.config.example.ts` and the README.
+ */
+import { isAbsolute, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { asNotificationServicePort, } from './notification-service-port.js';
+function resolveModuleSpecifier(modulePath) {
+    if (modulePath.startsWith('.') || isAbsolute(modulePath)) {
+        return pathToFileURL(resolve(process.cwd(), modulePath)).href;
+    }
+    // Bare specifier: let Node resolve it from node_modules.
+    return modulePath;
+}
+export async function loadNotificationService(modulePath) {
+    let loaded;
+    try {
+        loaded = (await import(resolveModuleSpecifier(modulePath)));
+    }
+    catch (error) {
+        throw new Error(`Could not load the VintaSend service module "${modulePath}". ` +
+            'Set VINTASEND_SERVICE_MODULE to a module that default-exports a service factory ' +
+            `(see vintasend.config.example.ts). Cause: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const factory = loaded.default ?? loaded.createVintaSendService;
+    if (typeof factory !== 'function') {
+        throw new Error(`The VintaSend service module "${modulePath}" must export a default function ` +
+            'that returns a configured VintaSend service.');
+    }
+    const service = await factory();
+    if (!service || typeof service !== 'object') {
+        throw new Error(`The VintaSend service factory in "${modulePath}" did not return a service instance.`);
+    }
+    return asNotificationServicePort(service);
+}
+/**
+ * Builds the service once and reuses it for every request.
+ */
+export function createServiceProvider(modulePath) {
+    let cached;
+    return () => {
+        if (!cached) {
+            cached = loadNotificationService(modulePath).catch((error) => {
+                // Do not cache failures: a transient misconfiguration should be retried.
+                cached = undefined;
+                throw error;
+            });
+        }
+        return cached;
+    };
+}
+//# sourceMappingURL=service-loader.js.map

package/dist/services/service-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-loader.js","sourceRoot":"","sources":["../../src/services/service-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,yBAAyB,GAE1B,MAAM,gCAAgC,CAAC;AASxC,SAAS,sBAAsB,CAAC,UAAkB;IAChD,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED,yDAAyD;IACzD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAkB;IAElB,IAAI,MAAqB,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAkB,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,gDAAgD,UAAU,KAAK;YAC7D,kFAAkF;YAClF,6CACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACL,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,sBAAsB,CAAC;IAEhE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,iCAAiC,UAAU,mCAAmC;YAC5E,8CAA8C,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAC;IAEhC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,sCAAsC,CACtF,CAAC;IACJ,CAAC;IAED,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,IAAI,MAAoD,CAAC;IAEzD,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC3D,yEAAyE;gBACzE,MAAM,GAAG,SAAS,CAAC;gBACnB,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/services/template-path-resolver.d.ts

@@ -0,0 +1,4 @@
+export type TemplatePathResolverOptions = {
+    templatesBasePath?: string;
+};
+export declare function resolveTemplatePath(templatePath: string, options?: TemplatePathResolverOptions): string;

package/dist/services/template-path-resolver.js

@@ -0,0 +1,17 @@
+function trimPathEdges(path) {
+    return path.replace(/^\/+|\/+$/g, '');
+}
+export function resolveTemplatePath(templatePath, options = {}) {
+    const cleanedTemplatePath = trimPathEdges(templatePath.trim());
+    if (!cleanedTemplatePath) {
+        throw new Error('Template path is required for preview rendering.');
+    }
+    const cleanedBasePath = options.templatesBasePath
+        ? trimPathEdges(options.templatesBasePath.trim())
+        : '';
+    if (!cleanedBasePath) {
+        return cleanedTemplatePath;
+    }
+    return `${cleanedBasePath}/${cleanedTemplatePath}`;
+}
+//# sourceMappingURL=template-path-resolver.js.map

package/dist/services/template-path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-path-resolver.js","sourceRoot":"","sources":["../../src/services/template-path-resolver.ts"],"names":[],"mappings":"AAIA,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,UAAuC,EAAE;IAEzC,MAAM,mBAAmB,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAE/D,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,iBAAiB;QAC/C,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QACjD,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,OAAO,GAAG,eAAe,IAAI,mBAAmB,EAAE,CAAC;AACrD,CAAC"}