@ackplus/nest-dynamic-templates 1.1.15 → 2.0.0

package/dist/lib/entities/template-layout.entity.js

@@ -34,12 +34,16 @@ let NestDynamicTemplateLayout = class NestDynamicTemplateLayout extends typeorm_
 };
 exports.NestDynamicTemplateLayout = NestDynamicTemplateLayout;
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, format: 'uuid', readOnly: true }),
+    (0, swagger_1.ApiProperty)({ type: String, format: 'uuid', readOnly: true, description: 'Primary key.' }),
     (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "id", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        example: 'email-shell',
+        description: 'Stable identifier you reference by (lowercase letters, numbers, "-" and "_").',
+    }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.Matches)(/^[a-z0-9\-_]+$/, { message: 'Invalid template name format' }),
@@ -47,28 +51,32 @@ __decorate([
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "name", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Human-friendly label for admin UIs.' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "displayName", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Free-text notes about what this layout is for.' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ type: 'text', nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "description", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Free category for grouping/filtering.' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ type: 'text' }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "type", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ enum: template_types_1.TemplateEngineEnum, type: String }),
+    (0, swagger_1.ApiProperty)({
+        enum: template_types_1.TemplateEngineEnum,
+        type: String,
+        description: 'Template engine that interpolates variables: njk (Nunjucks), hbs, ejs, pug.',
+    }),
     (0, class_validator_1.IsEnum)(template_types_1.TemplateEngineEnum),
     (0, typeorm_1.Column)({
         type: 'text',
@@ -78,52 +86,81 @@ __decorate([
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "engine", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ enum: template_types_1.TemplateLanguageEnum, type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        enum: template_types_1.TemplateLanguageEnum,
+        type: String,
+        nullable: true,
+        description: 'Output processor applied after interpolation: html, mjml, md, txt.',
+    }),
     (0, class_validator_1.IsEnum)(template_types_1.TemplateLanguageEnum),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ type: 'text' }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "language", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        description: 'The layout body. Use {{ content }} where the wrapped template should be injected.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)('text'),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "content", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Name of another layout to nest this one in.' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "templateLayoutName", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        default: 'system',
+        description: 'Who owns this version: "system" (shared default) or a custom owner kind like "tenant"/"user". Overrides fall back to the system layout.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, typeorm_1.Column)({ nullable: true, default: 'system' }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "scope", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        description: 'Which owner inside the scope (e.g. the tenant id). Leave empty for system layouts.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "scopeId", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        default: 'en',
+        description: 'Language variant, e.g. en, fr, es. Missing locales fall back to "en".',
+    }),
     (0, class_validator_1.IsString)(),
     (0, typeorm_1.Column)({ nullable: true, default: 'en' }),
     __metadata("design:type", String)
 ], NestDynamicTemplateLayout.prototype, "locale", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: Object, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: Object,
+        nullable: true,
+        description: 'Sample data used to preview the layout (not applied during render).',
+    }),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)('simple-json', { nullable: true }),
     __metadata("design:type", Object)
 ], NestDynamicTemplateLayout.prototype, "previewContext", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: Boolean }),
+    (0, swagger_1.ApiProperty)({
+        type: Boolean,
+        description: 'Set false to disable without deleting; inactive layouts are skipped during resolution.',
+    }),
     (0, class_validator_1.IsBoolean)(),
     (0, typeorm_1.Column)({ default: true }),
     __metadata("design:type", Boolean)

package/dist/lib/entities/template-layout.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-layout.entity.js","sourceRoot":"","sources":["../../../src/lib/entities/template-layout.entity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template-layout.entity.js","sourceRoot":"","sources":["../../../src/lib/entities/template-layout.entity.ts"],"names":[],"mappings":"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"}

package/dist/lib/entities/template.entity.js

@@ -35,12 +35,16 @@ let NestDynamicTemplate = class NestDynamicTemplate extends typeorm_1.BaseEntity
 };
 exports.NestDynamicTemplate = NestDynamicTemplate;
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, format: 'uuid', readOnly: true }),
+    (0, swagger_1.ApiProperty)({ type: String, format: 'uuid', readOnly: true, description: 'Primary key.' }),
     (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "id", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        example: 'welcome-email',
+        description: 'Stable identifier you render by (lowercase letters, numbers, "-" and "_"). Stays the same across scopes and locales.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.Matches)(/^[a-z0-9\-_]+$/, { message: 'Invalid template name format' }),
@@ -48,28 +52,37 @@ __decorate([
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "name", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Human-friendly label for admin UIs, e.g. "Welcome email".' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "displayName", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Free-text notes about what this template is for.' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ type: 'text', nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "description", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        example: 'email',
+        description: 'Free category for grouping/filtering, e.g. email, sms, push, pdf.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ type: 'text', nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "type", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ enum: template_types_1.TemplateEngineEnum, type: String }),
+    (0, swagger_1.ApiProperty)({
+        enum: template_types_1.TemplateEngineEnum,
+        type: String,
+        description: 'Template engine that interpolates variables: njk (Nunjucks), hbs, ejs, pug.',
+    }),
     (0, class_validator_1.IsEnum)(template_types_1.TemplateEngineEnum),
     (0, typeorm_1.Column)({
         type: 'text',
@@ -79,59 +92,89 @@ __decorate([
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "engine", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ enum: template_types_1.TemplateLanguageEnum, type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        enum: template_types_1.TemplateLanguageEnum,
+        type: String,
+        nullable: true,
+        description: 'Output processor applied after interpolation: html, mjml, md, txt. Omit to skip post-processing.',
+    }),
     (0, class_validator_1.IsEnum)(template_types_1.TemplateLanguageEnum),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ type: 'text' }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "language", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        description: 'Optional subject line (emails). Rendered with the engine, so it can use variables.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "subject", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String }),
+    (0, swagger_1.ApiProperty)({ type: String, description: "The template body, written in the chosen engine's syntax." }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)('text'),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "content", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, description: 'Name of a layout to wrap this content in.' }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "templateLayoutName", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        default: 'system',
+        description: 'Who owns this version: "system" (shared default) or a custom owner kind like "tenant"/"user". Overrides fall back to the system template.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, typeorm_1.Column)({ nullable: true, default: 'system' }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "scope", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        description: 'Which owner inside the scope (e.g. the tenant id). Leave empty for system templates.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, typeorm_1.Column)({ nullable: true }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "scopeId", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        nullable: true,
+        default: 'en',
+        description: 'Language variant, e.g. en, fr, es. Missing locales fall back to "en".',
+    }),
     (0, class_validator_1.IsString)(),
     (0, typeorm_1.Column)({ nullable: true, default: 'en' }),
     __metadata("design:type", String)
 ], NestDynamicTemplate.prototype, "locale", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: Object, nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: Object,
+        nullable: true,
+        description: 'Sample data used to preview the template (not applied during render).',
+    }),
     (0, class_validator_1.IsOptional)(),
     (0, typeorm_1.Column)('simple-json', { nullable: true }),
     __metadata("design:type", Object)
 ], NestDynamicTemplate.prototype, "previewContext", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: Boolean }),
+    (0, swagger_1.ApiProperty)({
+        type: Boolean,
+        description: 'Set false to disable without deleting; inactive templates are skipped during resolution.',
+    }),
     (0, class_validator_1.IsBoolean)(),
     (0, typeorm_1.Column)({ default: true }),
     __metadata("design:type", Boolean)

package/dist/lib/entities/template.entity.js.map

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

package/dist/lib/errors/diagnose.d.ts

@@ -0,0 +1,11 @@
+import { RenderStage, TemplateRenderError } from './template.errors';
+export interface RenderContextMeta {
+    stage: RenderStage;
+    engine?: string;
+    language?: string;
+    templateName?: string;
+    scope?: string;
+    scopeId?: string;
+    locale?: string;
+}
+export declare function diagnoseRenderError(cause: unknown, source: string, context: Record<string, any> | undefined, meta: RenderContextMeta): TemplateRenderError;

package/dist/lib/errors/diagnose.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diagnoseRenderError = diagnoseRenderError;
+const template_errors_1 = require("./template.errors");
+function diagnoseRenderError(cause, source, context, meta) {
+    const err = toError(cause);
+    const contextKeys = context ? Object.keys(context) : [];
+    const location = extractLocation(err.message, meta);
+    const missingVariable = extractMissingVariable(err.message, source, location);
+    const snippet = location ? lineAt(source, location.line) : undefined;
+    const reason = missingVariable
+        ? `variable "${missingVariable}" is undefined`
+        : cleanMessage(err.message);
+    const subject = meta.templateName ? `template "${meta.templateName}"` : 'inline content';
+    const tags = [
+        [meta.engine, meta.language].filter(Boolean).join(' → '),
+        meta.scope && `scope=${meta.scope}`,
+        meta.locale && `locale=${meta.locale}`,
+    ].filter(Boolean);
+    const where = tags.length ? ` [${tags.join(', ')}]` : '';
+    const message = `Failed to render ${subject}${where}: ${stripTrailingDot(reason)}.`;
+    const hint = missingVariable
+        ? buildMissingVarHint(missingVariable, contextKeys)
+        : stageHint(meta.stage, meta.engine, meta.language);
+    return new template_errors_1.TemplateRenderError({
+        message,
+        stage: meta.stage,
+        engine: meta.engine,
+        language: meta.language,
+        templateName: meta.templateName,
+        scope: meta.scope,
+        scopeId: meta.scopeId,
+        locale: meta.locale,
+        missingVariable,
+        contextKeys,
+        location,
+        snippet,
+        hint,
+    }, err);
+}
+function buildMissingVarHint(variable, contextKeys) {
+    const provided = contextKeys.length
+        ? `The render context has: [${contextKeys.join(', ')}].`
+        : `The render context was empty.`;
+    return `Pass "${variable}" in the render context. ${provided} To make it optional, guard it in the template, e.g. {{ ${variable} or "" }}.`;
+}
+function stageHint(stage, engine, language) {
+    switch (stage) {
+        case 'template-engine':
+            return `Check the ${engine ?? 'template'} syntax and that every referenced variable is provided.`;
+        case 'language-engine':
+            return `Check that the content is valid ${language ?? 'markup'} after variable interpolation.`;
+        case 'layout':
+            return `The error happened while rendering the layout wrapper around this template.`;
+        case 'subject':
+            return `The error happened while rendering the subject line.`;
+        default:
+            return undefined;
+    }
+}
+function toError(cause) {
+    if (cause instanceof Error)
+        return cause;
+    if (typeof cause === 'string')
+        return new Error(cause);
+    try {
+        return new Error(JSON.stringify(cause));
+    }
+    catch {
+        return new Error(String(cause));
+    }
+}
+function extractLocation(message, meta) {
+    const patterns = [
+        /\[Line (\d+),\s*Column (\d+)\]/i,
+        /Parse error on line (\d+)/i,
+        /(?:ejs|pug):(\d+)/i,
+        />>\s*(\d+)\s*\|/,
+        /\bon line (\d+)(?::(\d+))?/i,
+        /\bline (\d+)(?::(\d+))?/i,
+    ];
+    for (const re of patterns) {
+        const m = message.match(re);
+        if (m) {
+            const line = Number(m[1]);
+            const column = m[2] !== undefined ? Number(m[2]) : undefined;
+            if (Number.isFinite(line) && line > 0) {
+                return column !== undefined && Number.isFinite(column)
+                    ? { line, column }
+                    : { line };
+            }
+        }
+    }
+    return undefined;
+}
+function extractMissingVariable(message, source, location) {
+    const refError = message.match(/(\b[\w$][\w.$]*) is not defined/);
+    if (refError)
+        return refError[1];
+    const njkCall = message.match(/Unable to call `?([\w.$]+)`?, which is undefined/i);
+    if (njkCall)
+        return njkCall[1];
+    if (/attempted to output null or undefined value/i.test(message) && location) {
+        return expressionAt(source, location);
+    }
+    return undefined;
+}
+const TOKEN_RE = /\{\{-?\s*([\s\S]*?)\s*-?\}\}|<%[=\-_]?\s*([\s\S]*?)\s*[-_]?%>|#\{\s*([\s\S]*?)\s*\}/g;
+function expressionAt(source, location) {
+    const lineText = rawLineAt(source, location.line);
+    if (!lineText)
+        return undefined;
+    const tokens = [];
+    TOKEN_RE.lastIndex = 0;
+    let m;
+    while ((m = TOKEN_RE.exec(lineText)) !== null) {
+        const expr = (m[1] ?? m[2] ?? m[3] ?? '').trim();
+        if (expr)
+            tokens.push({ start: m.index, expr });
+    }
+    if (tokens.length === 0)
+        return undefined;
+    let chosen = tokens[0];
+    if (location.column !== undefined) {
+        const col = location.column;
+        for (const t of tokens) {
+            if (t.start <= col)
+                chosen = t;
+        }
+    }
+    return leadingVariable(chosen.expr);
+}
+function leadingVariable(expr) {
+    const beforeFilter = expr.split('|')[0].trim();
+    const path = beforeFilter.match(/^[\w$][\w.$]*(?:\[[^\]]+\])*/);
+    return path ? path[0] : undefined;
+}
+function lineAt(source, line) {
+    const raw = rawLineAt(source, line);
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    return trimmed.length > 200 ? `${trimmed.slice(0, 197)}...` : trimmed;
+}
+function rawLineAt(source, line) {
+    if (!source)
+        return undefined;
+    const lines = source.split(/\r?\n/);
+    return lines[line - 1];
+}
+function cleanMessage(message) {
+    return message
+        .replace(/^Error:\s*/i, '')
+        .replace(/\(unknown path\)\s*/gi, '')
+        .replace(/\[Line \d+,\s*Column \d+\]\s*/gi, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function stripTrailingDot(s) {
+    return s.replace(/\.+$/, '');
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/lib/errors/diagnose.js.map

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

package/dist/lib/errors/template.errors.d.ts

@@ -1,19 +1,83 @@
-import { BadRequestException, InternalServerErrorException } from '@nestjs/common';
-export declare class TemplateRenderError extends InternalServerErrorException {
-    constructor(operation: string, originalError: Error, templateName?: string);
+import { BadRequestException, ConflictException, ForbiddenException, InternalServerErrorException, NotFoundException, UnprocessableEntityException } from '@nestjs/common';
+export declare enum TemplateErrorCode {
+    NOT_FOUND = "TEMPLATE_NOT_FOUND",
+    RENDER_FAILED = "TEMPLATE_RENDER_FAILED",
+    ENGINE_UNAVAILABLE = "TEMPLATE_ENGINE_UNAVAILABLE",
+    INVALID_INPUT = "TEMPLATE_INVALID_INPUT",
+    FORBIDDEN = "TEMPLATE_FORBIDDEN",
+    CONFLICT = "TEMPLATE_CONFLICT"
 }
-export declare class TemplateEngineError extends InternalServerErrorException {
-    constructor(engine: string, originalError: Error);
+export type RenderStage = 'subject' | 'template-engine' | 'language-engine' | 'layout';
+export interface TemplateErrorDetails {
+    code: TemplateErrorCode;
+    message: string;
+    stage?: RenderStage;
+    engine?: string;
+    language?: string;
+    templateName?: string;
+    scope?: string;
+    scopeId?: string;
+    locale?: string;
+    missingVariable?: string;
+    contextKeys?: string[];
+    location?: {
+        line: number;
+        column?: number;
+    };
+    snippet?: string;
+    hint?: string;
 }
-export declare class TemplateLanguageError extends InternalServerErrorException {
-    constructor(language: string, originalError: Error);
+declare const TEMPLATE_ERROR: unique symbol;
+export interface TemplateErrorLike {
+    code: TemplateErrorCode;
+    details: TemplateErrorDetails;
 }
-export declare class TemplateLayoutError extends InternalServerErrorException {
-    constructor(layoutName: string, originalError: Error);
+export declare function isTemplateError(e: unknown): e is TemplateErrorLike;
+export declare class TemplateNotFoundError extends NotFoundException implements TemplateErrorLike {
+    readonly code = TemplateErrorCode.NOT_FOUND;
+    readonly details: TemplateErrorDetails;
+    readonly [TEMPLATE_ERROR] = true;
+    constructor(args: {
+        templateName: string;
+        scope?: string;
+        scopeId?: string;
+        locale?: string;
+        kind?: 'template' | 'layout';
+    });
 }
-export declare class TemplateContentError extends InternalServerErrorException {
-    constructor(contentType: string, originalError: Error);
+export declare class TemplateRenderError extends UnprocessableEntityException implements TemplateErrorLike {
+    readonly code = TemplateErrorCode.RENDER_FAILED;
+    readonly details: TemplateErrorDetails;
+    readonly [TEMPLATE_ERROR] = true;
+    constructor(details: Omit<TemplateErrorDetails, 'code'>, cause?: unknown);
 }
-export declare class TemplateValidationError extends BadRequestException {
-    constructor(field: string, value: any, reason: string);
+export declare class TemplateEngineUnavailableError extends InternalServerErrorException implements TemplateErrorLike {
+    readonly code = TemplateErrorCode.ENGINE_UNAVAILABLE;
+    readonly details: TemplateErrorDetails;
+    readonly [TEMPLATE_ERROR] = true;
+    constructor(args: {
+        engine: string;
+        kind: 'template' | 'language';
+        reason: 'not-enabled' | 'not-installed';
+        peerPackage?: string;
+    });
 }
+export declare class TemplateInputError extends BadRequestException implements TemplateErrorLike {
+    readonly code = TemplateErrorCode.INVALID_INPUT;
+    readonly details: TemplateErrorDetails;
+    readonly [TEMPLATE_ERROR] = true;
+    constructor(message: string, hint?: string);
+}
+export declare class TemplateForbiddenError extends ForbiddenException implements TemplateErrorLike {
+    readonly code = TemplateErrorCode.FORBIDDEN;
+    readonly details: TemplateErrorDetails;
+    readonly [TEMPLATE_ERROR] = true;
+    constructor(message: string, hint?: string);
+}
+export declare class TemplateConflictError extends ConflictException implements TemplateErrorLike {
+    readonly code = TemplateErrorCode.CONFLICT;
+    readonly details: TemplateErrorDetails;
+    readonly [TEMPLATE_ERROR] = true;
+    constructor(message: string, hint?: string);
+}
+export {};