@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/notifications/email/utils/color-conversion.utils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Color Conversion Utilities
+ *
+ * Utilities for converting colors between formats for email compatibility.
+ * Email clients don't support OKLCH, so we need to convert to Hex.
+ */
+/**
+ * Convert an OKLCH color string to Hex
+ *
+ * @param oklchColor - OKLCH color string (e.g., "oklch(0.7 0.15 180)")
+ * @returns Hex color string (e.g., "#4fa3a3")
+ */
+export declare function oklchToHex(oklchColor: string): string;
+/**
+ * Check if a color string is in OKLCH format
+ */
+export declare function isOklchColor(color: string): boolean;
+/**
+ * Convert any color to hex format
+ * Handles OKLCH, rgb, hsl, and passes through hex
+ */
+export declare function toHexColor(color: string): string;
+/**
+ * Email Brand Tokens structure (hex colors)
+ */
+export interface EmailBrandTokens {
+    primaryColor: string;
+    primaryForeground: string;
+    secondaryColor: string;
+    backgroundColor: string;
+    foregroundColor: string;
+    mutedColor: string;
+    mutedForeground: string;
+    borderColor: string;
+    successColor: string;
+    warningColor: string;
+    destructiveColor: string;
+    borderRadius: string;
+    fontFamily: string;
+    headingFontFamily?: string;
+}
+/**
+ * Default email design tokens (fallback values)
+ */
+export declare const DEFAULT_EMAIL_DESIGN_TOKENS: EmailBrandTokens;
+/**
+ * Build full `EmailBrandTokens` from the simplified `email.brandTokens` config.
+ * Merges provided values with `DEFAULT_EMAIL_DESIGN_TOKENS`.
+ */
+export declare function buildEmailBrandTokensFromConfig(brandTokens?: {
+    primaryColor?: string;
+    secondaryColor?: string;
+    fontFamily?: string;
+    logoUrl?: string;
+}): EmailBrandTokens;
+//# sourceMappingURL=color-conversion.utils.d.ts.map

package/dist/esm/notifications/email/utils/color-conversion.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-conversion.utils.d.ts","sourceRoot":"","sources":["../../../../../src/notifications/email/utils/color-conversion.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA4BrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,gBAezC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,CAAC,EAAE;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,gBAAgB,CAYlB"}

package/dist/esm/notifications/email/utils/color-conversion.utils.js

@@ -0,0 +1,108 @@
+/**
+ * Color Conversion Utilities
+ *
+ * Utilities for converting colors between formats for email compatibility.
+ * Email clients don't support OKLCH, so we need to convert to Hex.
+ */
+import { oklch, formatHex } from 'culori';
+/**
+ * Convert an OKLCH color string to Hex
+ *
+ * @param oklchColor - OKLCH color string (e.g., "oklch(0.7 0.15 180)")
+ * @returns Hex color string (e.g., "#4fa3a3")
+ */
+export function oklchToHex(oklchColor) {
+    try {
+        // Parse the OKLCH color
+        const parsed = oklch(oklchColor);
+        if (!parsed) {
+            // If parsing fails, try to extract values manually
+            const match = oklchColor.match(/oklch\(\s*([\d.]+)\s+([\d.]+)\s+([\d.]+)\s*\)/i);
+            if (match) {
+                const color = {
+                    mode: 'oklch',
+                    l: parseFloat(match[1]),
+                    c: parseFloat(match[2]),
+                    h: parseFloat(match[3]),
+                };
+                return formatHex(color) || '#000000';
+            }
+            return '#000000';
+        }
+        // Convert to Hex
+        const hex = formatHex(parsed);
+        return hex || '#000000';
+    }
+    catch {
+        // Silently return fallback - color conversion failures are non-critical
+        // Caller can log if needed, but we return a safe default
+        return '#000000';
+    }
+}
+/**
+ * Check if a color string is in OKLCH format
+ */
+export function isOklchColor(color) {
+    return color.toLowerCase().startsWith('oklch(');
+}
+/**
+ * Convert any color to hex format
+ * Handles OKLCH, rgb, hsl, and passes through hex
+ */
+export function toHexColor(color) {
+    if (!color)
+        return '#000000';
+    // Already hex
+    if (color.startsWith('#')) {
+        return color;
+    }
+    // OKLCH
+    if (isOklchColor(color)) {
+        return oklchToHex(color);
+    }
+    // Try culori for other formats
+    try {
+        const hex = formatHex(color);
+        return hex || '#000000';
+    }
+    catch {
+        return '#000000';
+    }
+}
+/**
+ * Default email design tokens (fallback values)
+ */
+export const DEFAULT_EMAIL_DESIGN_TOKENS = {
+    primaryColor: '#0066cc',
+    primaryForeground: '#ffffff',
+    secondaryColor: '#6c757d',
+    backgroundColor: '#ffffff',
+    foregroundColor: '#1a1a1a',
+    mutedColor: '#f5f5f5',
+    mutedForeground: '#6c757d',
+    borderColor: '#e5e5e5',
+    successColor: '#22c55e',
+    warningColor: '#f59e0b',
+    destructiveColor: '#ef4444',
+    borderRadius: '0.5rem',
+    fontFamily: 'Arial, Helvetica, sans-serif',
+    headingFontFamily: 'Arial, Helvetica, sans-serif',
+};
+/**
+ * Build full `EmailBrandTokens` from the simplified `email.brandTokens` config.
+ * Merges provided values with `DEFAULT_EMAIL_DESIGN_TOKENS`.
+ */
+export function buildEmailBrandTokensFromConfig(brandTokens) {
+    if (!brandTokens)
+        return { ...DEFAULT_EMAIL_DESIGN_TOKENS };
+    return {
+        ...DEFAULT_EMAIL_DESIGN_TOKENS,
+        ...(brandTokens.primaryColor && { primaryColor: toHexColor(brandTokens.primaryColor) }),
+        ...(brandTokens.secondaryColor && { secondaryColor: toHexColor(brandTokens.secondaryColor) }),
+        ...(brandTokens.fontFamily && {
+            fontFamily: brandTokens.fontFamily,
+            headingFontFamily: brandTokens.fontFamily,
+        }),
+    };
+}
+//# sourceMappingURL=color-conversion.utils.js.map

package/dist/esm/notifications/email/utils/color-conversion.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-conversion.utils.js","sourceRoot":"","sources":["../../../../../src/notifications/email/utils/color-conversion.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/notifications/email/utils/interpolate-email-label.utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Replace `{placeholder}` tokens in email label strings.
+ *
+ * Translators can reorder clauses and words; placeholders stay semantic
+ * (`{appName}`, `{firstName}`, …) so each locale controls word order.
+ */
+export declare function interpolateEmailLabel(template: string, params: Record<string, string | number | undefined | null>): string;
+//# sourceMappingURL=interpolate-email-label.utils.d.ts.map

package/dist/esm/notifications/email/utils/interpolate-email-label.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate-email-label.utils.d.ts","sourceRoot":"","sources":["../../../../../src/notifications/email/utils/interpolate-email-label.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GACzD,MAAM,CAMR"}

package/dist/esm/notifications/email/utils/interpolate-email-label.utils.js

@@ -0,0 +1,15 @@
+/**
+ * Replace `{placeholder}` tokens in email label strings.
+ *
+ * Translators can reorder clauses and words; placeholders stay semantic
+ * (`{appName}`, `{firstName}`, …) so each locale controls word order.
+ */
+export function interpolateEmailLabel(template, params) {
+    return template.replace(/\{(\w+)\}/g, (match, key) => {
+        const v = params[key];
+        if (v === undefined || v === null)
+            return match;
+        return String(v);
+    });
+}
+//# sourceMappingURL=interpolate-email-label.utils.js.map

package/dist/esm/notifications/email/utils/interpolate-email-label.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate-email-label.utils.js","sourceRoot":"","sources":["../../../../../src/notifications/email/utils/interpolate-email-label.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,MAA0D;IAE1D,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/notifications/email/utils/zod-to-typescript.utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Zod Schema to TypeScript Text Serialization
+ *
+ * Converts Zod schemas to human-readable TypeScript interface text.
+ * Used to provide type context to LLM for email template generation.
+ */
+import { z } from 'zod';
+export interface SerializationOptions {
+    /** Include JSDoc comments from schema descriptions */
+    includeDescriptions?: boolean;
+    /** Indentation string (default: 2 spaces) */
+    indent?: string;
+    /** Maximum depth for nested objects (default: 5) */
+    maxDepth?: number;
+}
+/**
+ * Serialize a Zod schema to a TypeScript interface definition string.
+ *
+ * @param schema - The Zod schema to serialize
+ * @param typeName - The name for the TypeScript interface
+ * @param options - Serialization options
+ * @returns TypeScript interface definition as a string
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   email: z.email(),
+ *   age: z.number().optional(),
+ * });
+ *
+ * const typeDefinition = serializeZodSchemaToTypeScript(UserSchema, 'User');
+ * // Returns:
+ * // interface User {
+ * //   name: string;
+ * //   email: string /* email * /;
+ * //   age?: number;
+ * // }
+ * ```
+ */
+export declare function serializeZodSchemaToTypeScript(schema: z.ZodTypeAny, typeName: string, options?: SerializationOptions): string;
+/**
+ * Serialize multiple schemas with a header comment for LLM context.
+ */
+export declare function serializeZodSchemasForLLMContext(schemas: Array<{
+    schema: z.ZodTypeAny;
+    typeName: string;
+    description?: string;
+}>, options?: SerializationOptions): string;
+//# sourceMappingURL=zod-to-typescript.utils.d.ts.map

package/dist/esm/notifications/email/utils/zod-to-typescript.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-typescript.utils.d.ts","sourceRoot":"","sources":["../../../../../src/notifications/email/utils/zod-to-typescript.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoPD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAChF,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAkBR"}

package/dist/esm/notifications/email/utils/zod-to-typescript.utils.js

@@ -0,0 +1,281 @@
+/**
+ * Zod Schema to TypeScript Text Serialization
+ *
+ * Converts Zod schemas to human-readable TypeScript interface text.
+ * Used to provide type context to LLM for email template generation.
+ */
+import { getZodType, unwrapSchema, isOptional, getZodObjectShape, getEnumValues, getArrayItemSchema, getMapSchemas, getStringFormat, getNumberConstraints, getZodDefProperty, getZodDefSchemaProperty, getZodDefArrayProperty, isZodTypeAny, } from '@wildo-ai/zod-decorators';
+// ═══════════════════════════════════════════════════════════════════════════
+// Helper Functions
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Check if a schema is nullable (recursively through wrappers).
+ */
+function isNullableRecursive(schema) {
+    const type = getZodType(schema);
+    if (type === 'nullable')
+        return true;
+    if (type === 'optional' || type === 'default' || type === 'pipe' || type === 'readonly' || type === 'catch') {
+        const innerSchema = getZodDefSchemaProperty(schema, 'innerType') ?? getZodDefSchemaProperty(schema, 'in');
+        return innerSchema ? isNullableRecursive(innerSchema) : false;
+    }
+    return false;
+}
+/**
+ * Get description from a schema.
+ */
+function getSchemaDescription(schema) {
+    if ('description' in schema && typeof schema.description === 'string') {
+        return schema.description;
+    }
+    return undefined;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Type Conversion
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Convert a Zod schema to a TypeScript type string
+ */
+function zodTypeToString(schema, depth, options) {
+    const maxDepth = options.maxDepth ?? 5;
+    const indent = options.indent ?? '  ';
+    if (depth > maxDepth) {
+        return 'unknown /* max depth exceeded */';
+    }
+    const unwrapped = unwrapSchema(schema);
+    const type = getZodType(unwrapped);
+    switch (type) {
+        // String types
+        case 'string': {
+            const format = getStringFormat(unwrapped);
+            if (format === 'email')
+                return 'string /* email */';
+            if (format === 'url')
+                return 'string /* url */';
+            if (format === 'uuid')
+                return 'string /* uuid */';
+            if (format === 'datetime')
+                return 'string /* ISO datetime */';
+            if (format === 'time')
+                return 'string /* time */';
+            return 'string';
+        }
+        // Number types
+        case 'number':
+        case 'int': {
+            const constraints = getNumberConstraints(unwrapped);
+            if (constraints.isInt)
+                return 'number /* integer */';
+            return 'number';
+        }
+        // Bigint
+        case 'bigint':
+            return 'bigint';
+        // Boolean
+        case 'boolean':
+            return 'boolean';
+        // Date
+        case 'date':
+            return 'Date';
+        // Literal
+        case 'literal': {
+            const values = getZodDefProperty(unwrapped, 'values');
+            const value = values?.[0];
+            return typeof value === 'string' ? `"${value}"` : String(value);
+        }
+        // Enum
+        case 'enum': {
+            const values = getEnumValues(unwrapped);
+            if (values.length === 0)
+                return 'string';
+            return values.map(v => `"${v}"`).join(' | ');
+        }
+        // Array
+        case 'array': {
+            const elementSchema = getArrayItemSchema(unwrapped);
+            if (!elementSchema)
+                return 'unknown[]';
+            const elementType = zodTypeToString(elementSchema, depth + 1, options);
+            return `${elementType}[]`;
+        }
+        // Object
+        case 'object': {
+            const shape = getZodObjectShape(unwrapped);
+            const entries = Object.entries(shape);
+            if (entries.length === 0) {
+                return '{}';
+            }
+            const currentIndent = indent.repeat(depth);
+            const nextIndent = indent.repeat(depth + 1);
+            const lines = ['{'];
+            for (const [key, fieldSchema] of entries) {
+                const optional = isOptional(fieldSchema);
+                const nullable = isNullableRecursive(fieldSchema);
+                const fieldType = zodTypeToString(fieldSchema, depth + 1, options);
+                const description = getSchemaDescription(fieldSchema);
+                // Build type with nullability
+                let fullType = fieldType;
+                if (nullable && !fullType.includes('null')) {
+                    fullType = `${fullType} | null`;
+                }
+                // Add JSDoc comment if description exists and option is enabled
+                if (options.includeDescriptions && description) {
+                    lines.push(`${nextIndent}/** ${description} */`);
+                }
+                lines.push(`${nextIndent}${key}${optional ? '?' : ''}: ${fullType};`);
+            }
+            lines.push(`${currentIndent}}`);
+            return lines.join('\n');
+        }
+        // Record
+        case 'record': {
+            const keySchema = getZodDefSchemaProperty(unwrapped, 'keyType');
+            const valueSchema = getZodDefSchemaProperty(unwrapped, 'valueType');
+            if (!keySchema || !valueSchema)
+                return 'Record<string, unknown>';
+            const keyType = zodTypeToString(keySchema, depth + 1, options);
+            const valueType = zodTypeToString(valueSchema, depth + 1, options);
+            return `Record<${keyType}, ${valueType}>`;
+        }
+        // Map
+        case 'map': {
+            const schemas = getMapSchemas(unwrapped);
+            if (!schemas)
+                return 'Map<unknown, unknown>';
+            const keyType = zodTypeToString(schemas.keySchema, depth + 1, options);
+            const valueType = zodTypeToString(schemas.valueSchema, depth + 1, options);
+            return `Map<${keyType}, ${valueType}>`;
+        }
+        // Union
+        case 'union': {
+            const unionOptions = (getZodDefArrayProperty(unwrapped, 'options') ?? [])
+                .filter((opt) => isZodTypeAny(opt));
+            if (unionOptions.length === 0)
+                return 'unknown';
+            return unionOptions.map(opt => zodTypeToString(opt, depth + 1, options)).join(' | ');
+        }
+        // Tuple
+        case 'tuple': {
+            const items = (getZodDefArrayProperty(unwrapped, 'items') ?? [])
+                .filter((item) => isZodTypeAny(item));
+            if (items.length === 0)
+                return '[]';
+            const itemTypes = items.map(item => zodTypeToString(item, depth + 1, options));
+            return `[${itemTypes.join(', ')}]`;
+        }
+        // Set
+        case 'set': {
+            const elementSchema = getZodDefSchemaProperty(unwrapped, 'valueType');
+            if (!elementSchema)
+                return 'Set<unknown>';
+            const elementType = zodTypeToString(elementSchema, depth + 1, options);
+            return `Set<${elementType}>`;
+        }
+        // Unknown/Any
+        case 'unknown':
+            return 'unknown';
+        case 'any':
+            return 'any';
+        // Void/Undefined/Null
+        case 'void':
+            return 'void';
+        case 'undefined':
+            return 'undefined';
+        case 'null':
+            return 'null';
+        // Never
+        case 'never':
+            return 'never';
+        // Intersection
+        case 'intersection': {
+            const left = getZodDefSchemaProperty(unwrapped, 'left');
+            const right = getZodDefSchemaProperty(unwrapped, 'right');
+            if (!left || !right)
+                return 'unknown';
+            const leftType = zodTypeToString(left, depth + 1, options);
+            const rightType = zodTypeToString(right, depth + 1, options);
+            return `${leftType} & ${rightType}`;
+        }
+        // Lazy (recursive types)
+        case 'lazy':
+            return 'unknown /* recursive type */';
+        // Promise
+        case 'promise': {
+            const innerSchema = getZodDefSchemaProperty(unwrapped, 'type');
+            if (!innerSchema)
+                return 'Promise<unknown>';
+            const innerType = zodTypeToString(innerSchema, depth + 1, options);
+            return `Promise<${innerType}>`;
+        }
+        // Function
+        case 'function':
+            return '(...args: unknown[]) => unknown';
+        // Fallback for unknown types
+        default:
+            return 'unknown';
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Main Export
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Serialize a Zod schema to a TypeScript interface definition string.
+ *
+ * @param schema - The Zod schema to serialize
+ * @param typeName - The name for the TypeScript interface
+ * @param options - Serialization options
+ * @returns TypeScript interface definition as a string
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   email: z.email(),
+ *   age: z.number().optional(),
+ * });
+ *
+ * const typeDefinition = serializeZodSchemaToTypeScript(UserSchema, 'User');
+ * // Returns:
+ * // interface User {
+ * //   name: string;
+ * //   email: string /* email * /;
+ * //   age?: number;
+ * // }
+ * ```
+ */
+export function serializeZodSchemaToTypeScript(schema, typeName, options = {}) {
+    const mergedOptions = {
+        includeDescriptions: true,
+        indent: '  ',
+        maxDepth: 5,
+        ...options,
+    };
+    const typeBody = zodTypeToString(schema, 0, mergedOptions);
+    // If the type is an object, format as interface
+    if (typeBody.startsWith('{')) {
+        return `interface ${typeName} ${typeBody}`;
+    }
+    // Otherwise, format as type alias
+    return `type ${typeName} = ${typeBody};`;
+}
+/**
+ * Serialize multiple schemas with a header comment for LLM context.
+ */
+export function serializeZodSchemasForLLMContext(schemas, options = {}) {
+    const lines = [
+        '// ═══════════════════════════════════════════════════════════════════════════',
+        '// TYPE DEFINITIONS',
+        '// These types describe the data available in your template.',
+        '// ═══════════════════════════════════════════════════════════════════════════',
+        '',
+    ];
+    for (const { schema, typeName, description } of schemas) {
+        if (description) {
+            lines.push(`/** ${description} */`);
+        }
+        lines.push(serializeZodSchemaToTypeScript(schema, typeName, options));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=zod-to-typescript.utils.js.map

package/dist/esm/notifications/email/utils/zod-to-typescript.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-typescript.utils.js","sourceRoot":"","sources":["../../../../../src/notifications/email/utils/zod-to-typescript.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/notifications/services/notification-badge.backend.service.d.ts

@@ -0,0 +1,94 @@
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { RepositoriesRegistryHandlerBackendService } from '../../base-classes/services/repositories/repositories-registry-handler.backend.service.js';
+import { ExecutionContext } from '../../runtime/models/execution-context.backend.schemas.js';
+import { ResourceConfiguration_Operation } from '@wildo-ai/saas-models';
+import { ResourcePrimaryScope, NotificationBadgeOperation, NotificationBadgeIdentifier } from '@wildo-ai/saas-models';
+import { WebSocketService } from '../../requests/service/websocket.service.js';
+/**
+ * Badge reference format: `${scope}:${scopeId}:${identifier}`
+ * Examples:
+ * - user_self:user123:new_messages
+ * - organization:org456:pending_tasks
+ */
+export interface BadgeReference {
+    scope: ResourcePrimaryScope;
+    scopeId: string;
+    identifier: NotificationBadgeIdentifier;
+}
+export interface BadgeUpdateResult {
+    badgeReference: string;
+    previousCount: number;
+    newCount: number;
+}
+/**
+ * NotificationBadgeBackendService
+ *
+ * Manages notification badge counts stored in the database.
+ * Provides operations to increment, decrement, set, and reset badge counts.
+ * Emits WebSocket events when badge counts change.
+ */
+export declare class NotificationBadgeBackendService {
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly repositoriesRegistry;
+    private readonly webSocketService;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    constructor(logger: LoggerService, errorBuilder: ErrorBuilderBackendService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService, webSocketService: WebSocketService);
+    /**
+     * Build a badge reference string
+     */
+    buildBadgeReference(scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier): string;
+    /**
+     * Parse a badge reference string
+     */
+    parseBadgeReference(badgeReference: string): BadgeReference | null;
+    /**
+     * Get badge count for a specific identifier and scope
+     */
+    getBadgeCount<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier): Promise<number>;
+    /**
+     * Get all badges for a specific scope
+     */
+    getAllBadges<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string): Promise<Array<{
+        identifier: string;
+        count: number;
+    }>>;
+    /**
+     * Execute a badge operation (increment, decrement, set, reset)
+     */
+    executeBadgeOperation<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier, operation: NotificationBadgeOperation, value?: number): Promise<BadgeUpdateResult>;
+    /**
+     * Increment a badge count
+     */
+    increment<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier, amount?: number): Promise<BadgeUpdateResult>;
+    /**
+     * Decrement a badge count
+     */
+    decrement<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier, amount?: number): Promise<BadgeUpdateResult>;
+    /**
+     * Set a badge count to a specific value
+     */
+    set<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier, value: number): Promise<BadgeUpdateResult>;
+    /**
+     * Reset a badge count to zero
+     */
+    reset<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, scope: ResourcePrimaryScope, scopeId: string, identifier: NotificationBadgeIdentifier): Promise<BadgeUpdateResult>;
+    /**
+     * Find a badge by scope, scopeId, and identifier
+     */
+    private findBadge;
+    /**
+     * Build filter for scope-specific queries
+     */
+    private buildScopeFilter;
+    /**
+     * Build a new badge document
+     */
+    private buildNewBadge;
+    /**
+     * Emit WebSocket event for badge update
+     */
+    private emitBadgeUpdate;
+}
+//# sourceMappingURL=notification-badge.backend.service.d.ts.map