@cosmicdrift/kumiko-bundled-features 0.364.0 → 0.365.0

package/dist/template-resolver/index.js

@@ -1,6 +1,6 @@
 export { createTemplateResolverApi, requireTemplateResolver, TemplateNotFoundError, } from "./api.js";
 export { collectDocumentResourceKeys, compileDocumentBodyToHandlebars, toResourceDataUri, } from "./compile-document-body.js";
-export { CONTENT_FORMATS, DEFAULT_MAIL_LAYOUT_SLUG, DOCUMENT_HTML_KINDS, FALLBACK_LOCALE, NON_RENDER_KINDS, PDF_DEFAULT_MARGIN_MM, PDF_FOOTER_MARGIN_MM, PDF_HEADER_MARGIN_MM, PDF_ORIENTATIONS, PDF_PAGE_FORMATS, RENDER_KINDS, SYSTEM_TENANT_ID, TEMPLATE_KINDS, TEMPLATE_SCOPES, TEMPLATE_STATUSES, TEXT_BLOCK_KIND, UPSERT_KINDS, } from "./constants.js";
+export { CONTENT_FORMATS, DEFAULT_MAIL_LAYOUT_SLUG, DEFAULT_PDF_LAYOUT_SLUG, DOCUMENT_HTML_KINDS, FALLBACK_LOCALE, NON_RENDER_KINDS, PDF_DEFAULT_MARGIN_MM, PDF_FOOTER_MARGIN_MM, PDF_HEADER_MARGIN_MM, PDF_ORIENTATIONS, PDF_PAGE_FORMATS, RENDER_KINDS, SYSTEM_TENANT_ID, TEMPLATE_KINDS, TEMPLATE_SCOPES, TEMPLATE_STATUSES, TEXT_BLOCK_KIND, UPSERT_KINDS, } from "./constants.js";
 export { documentViolationsToFieldIssues, sanitizeDocumentHtml, sanitizeTemplateBody, } from "./document-sanitizer.js";
 export { DOCUMENT_NODE_NAMES, DOCUMENT_TEXT_ALIGNMENTS, DocumentButton, DocumentDivider, DocumentLink, DocumentPageBreak, DocumentResource, DocumentTable, DocumentTableCell, DocumentTableHeader, DocumentTableRow, DocumentTextAlign, DocumentVariable, documentExtensions, isAllowedDocumentLinkHref, isDocumentPlaceholderHref, isDocumentReferenceName, isDocumentResourceKey, } from "./document-schema.js";
 export { createTemplateResolverFeature } from "./feature.js";
@@ -11,10 +11,10 @@ export { fileAttachmentsOf, imageLinksOf, parseLinkedResourceEntries, pdfAttachm
 export { prepareDocumentForPrint } from "./print-document.js";
 export { TEMPLATE_RESOLVER_FEATURE, TemplateResolverErrors, TemplateResolverHandlers, TemplateResolverQueries, } from "./qualified-names.js";
 export { mapRecordToVariables } from "./record-mapping.js";
-export { readTemplateResourceMaxBytes, storeTemplateResource, } from "./store-template-resource.js";
+export { prepareTemplateResourceBeforeTransaction, readTemplateResourceMaxBytes, storePreparedTemplateResource, } from "./store-template-resource.js";
 export { templateResourceEntity, templateResourcesTable, } from "./table.js";
 export { templateBundleSchema } from "./template-bundle.js";
-export { isMailTemplateMeta, MAIL_CATEGORIES, parseTemplateMeta, pdfAttachmentFileNamePatternSchema, readMailLayoutMeta, readPdfTemplateMeta, templateSlugSchema, } from "./template-meta.js";
+export { isMailTemplateMeta, MAIL_CATEGORIES, MAIL_TONES, parseTemplateMeta, pdfAttachmentFileNamePatternSchema, readMailLayoutMeta, readPdfTemplateMeta, templateSlugSchema, } from "./template-meta.js";
 export { evaluateDocumentDraft } from "./template-preview.js";
 export { readTemplateResource } from "./template-resources.js";
 export { collectTemplateUsage } from "./template-usage.js";

package/dist/template-resolver/layout-appearance.d.ts

@@ -7,4 +7,4 @@ export type MailLayoutAppearance = {
     readonly buttonStyle: string;
 };
 export declare function isHexColor(value: string): boolean;
-export declare function mailLayoutAppearance(meta: MailLayoutMeta | unknown): MailLayoutAppearance;
+export declare function mailLayoutAppearance(meta: MailLayoutMeta | unknown, brandingAccentColor?: string): MailLayoutAppearance;

package/dist/template-resolver/layout-appearance.js

@@ -4,23 +4,33 @@ const FONT_FAMILIES = {
     sans: "Arial, Helvetica, sans-serif",
     serif: "Georgia, 'Times New Roman', serif",
 };
-const BUTTON_COLOR = "#1f5468";
+const DEFAULT_BUTTON_COLOR = "#1f5468";
 const BUTTON_BASE = "display:inline-block;padding:10px 20px;font-weight:600;text-decoration:none";
-const BUTTON_STYLES = {
-    "filled-rounded": `${BUTTON_BASE};border-radius:6px;background-color:${BUTTON_COLOR};color:#ffffff`,
-    "filled-square": `${BUTTON_BASE};background-color:${BUTTON_COLOR};color:#ffffff`,
-    outline: `${BUTTON_BASE};border:2px solid ${BUTTON_COLOR};border-radius:6px;color:${BUTTON_COLOR}`,
-};
+function buttonStyleCss(style, color) {
+    switch (style) {
+        case "filled-rounded":
+            return `${BUTTON_BASE};border-radius:6px;background-color:${color};color:#ffffff`;
+        case "filled-square":
+            return `${BUTTON_BASE};background-color:${color};color:#ffffff`;
+        case "outline":
+            return `${BUTTON_BASE};border:2px solid ${color};border-radius:6px;color:${color}`;
+    }
+}
 export function isHexColor(value) {
     return HEX_COLOR_PATTERN.test(value);
 }
-export function mailLayoutAppearance(meta) {
+// The branding accent colors the buttons only where the layout opted into the branding accent line.
+export function mailLayoutAppearance(meta, brandingAccentColor) {
     const parsed = readMailLayoutMeta(meta);
+    const accentLine = (parsed.accentLine ?? "none") === "branding";
+    const buttonColor = accentLine && brandingAccentColor !== undefined && isHexColor(brandingAccentColor)
+        ? brandingAccentColor
+        : DEFAULT_BUTTON_COLOR;
     return {
         width: parsed.width ?? 600,
         fontFamily: FONT_FAMILIES[parsed.font ?? "sans"],
         outerBackground: parsed.outerBackground ?? "#f5f5f5",
-        accentLine: (parsed.accentLine ?? "none") === "branding",
-        buttonStyle: BUTTON_STYLES[parsed.buttonStyle ?? "filled-rounded"],
+        accentLine,
+        buttonStyle: buttonStyleCss(parsed.buttonStyle ?? "filled-rounded", buttonColor),
     };
 }

package/dist/template-resolver/mail-constants.d.ts

@@ -0,0 +1,2 @@
+export declare const MAIL_TONES: readonly ["accent", "info", "success", "warning", "danger", "neutral"];
+export type MailTone = (typeof MAIL_TONES)[number];

package/dist/template-resolver/mail-constants.js

@@ -0,0 +1,3 @@
+// @runtime client
+// No imports: web/ re-exports these, and template-meta.ts pulls in zod and the framework engine.
+export const MAIL_TONES = ["accent", "info", "success", "warning", "danger", "neutral"];

package/dist/template-resolver/resource-image.d.ts

@@ -1,15 +1,8 @@
-declare const CONTENT_TYPE_BY_FORMAT: {
-    readonly png: "image/png";
-    readonly jpeg: "image/jpeg";
-    readonly gif: "image/gif";
-    readonly webp: "image/webp";
-};
-type ResourceImageFormat = keyof typeof CONTENT_TYPE_BY_FORMAT;
+import { type ResourceImageContentType } from "../shared/index.js";
 export type NormalizedResourceImage = {
     readonly data: Uint8Array;
-    readonly contentType: (typeof CONTENT_TYPE_BY_FORMAT)[ResourceImageFormat];
+    readonly contentType: ResourceImageContentType;
     readonly width: number;
     readonly height: number;
 };
 export declare function normalizeResourceImage(data: Uint8Array): Promise<NormalizedResourceImage>;
-export {};

package/dist/template-resolver/resource-image.js

@@ -1,14 +1,5 @@
-import { assertNotSvg, SHARP_INPUT_OPTIONS } from "../shared/index.js";
+import { assertNotSvg, isResourceImageFormat, RESOURCE_IMAGE_FORMATS, SHARP_INPUT_OPTIONS, } from "../shared/index.js";
 const MAX_RESOURCE_WIDTH = 1200;
-const CONTENT_TYPE_BY_FORMAT = {
-    png: "image/png",
-    jpeg: "image/jpeg",
-    gif: "image/gif",
-    webp: "image/webp",
-};
-function isResourceImageFormat(format) {
-    return format !== undefined && Object.hasOwn(CONTENT_TYPE_BY_FORMAT, format);
-}
 // Re-encodes an uploaded image: the stored content type comes from the decoded format, never
 // from the client, and re-encoding drops metadata and anything appended to the file.
 // sharp is imported lazily because every app loads template-resolver, few of them need an image decoder.
@@ -27,7 +18,7 @@ export async function normalizeResourceImage(data) {
     const { data: output, info } = await pipeline.toBuffer({ resolveWithObject: true });
     return {
         data: new Uint8Array(output),
-        contentType: CONTENT_TYPE_BY_FORMAT[format],
+        contentType: RESOURCE_IMAGE_FORMATS[format].contentType,
         width: info.width,
         height: info.height,
     };

package/dist/template-resolver/seeding.js

@@ -95,6 +95,8 @@ export async function seedSystemTemplate(db, opts) {
             current?.title === rowFields.title &&
             current?.variableSchema === rowFields.variableSchema &&
             current?.meta === rowFields.meta &&
+            current?.status === rowFields.status &&
+            current?.parentTemplateId === rowFields.parentTemplateId &&
             (linkedResources === undefined || current?.linkedResources === linkedResources)) {
             return { id: String(row.id) };
         }

package/dist/template-resolver/store-template-resource.d.ts

@@ -1,5 +1,5 @@
-import type { ConfigAccessor, HandlerContext, Registry, SessionUser, TenantId, WriteResult } from "@cosmicdrift/kumiko-framework/engine";
-import type { FileAttachmentRef } from "../renderer-foundation/index.js";
+import type { BeforeTransactionResult, ConfigAccessor, HandlerContext, Registry, SessionUser, TenantId, WriteResult } from "@cosmicdrift/kumiko-framework/engine";
+import { type UploadedFileBytes } from "@cosmicdrift/kumiko-framework/files";
 import { type LinkedResourceEntry } from "./linked-resources.js";
 export declare function readTemplateResourceMaxBytes(config: ConfigAccessor | undefined, registry: Registry): Promise<number>;
 export type StoredTemplateResource = {
@@ -10,7 +10,28 @@ export type StoredTemplateResource = {
     readonly height: number;
     readonly size: number;
 };
-export declare function storeTemplateResource(args: {
+export type PreparedTemplateImage = {
+    readonly kind: "image";
+    readonly contentType: string;
+    readonly width: number;
+    readonly height: number;
+    readonly size: number;
+    readonly upload: UploadedFileBytes;
+};
+export type PreparedTemplateAttachment = {
+    readonly kind: "attachment";
+    readonly contentType: string;
+    readonly size: number;
+    readonly fileName: string;
+    readonly upload: UploadedFileBytes;
+};
+export type PreparedTemplateFile = PreparedTemplateImage | PreparedTemplateAttachment;
+type TenantScope = {
+    readonly ctx: HandlerContext;
+    readonly user: SessionUser;
+    readonly tenantId: TenantId;
+};
+export declare function prepareTemplateResourceBeforeTransaction(args: {
     readonly ctx: HandlerContext;
     readonly user: SessionUser;
     readonly tenantId: TenantId;
@@ -18,6 +39,28 @@ export declare function storeTemplateResource(args: {
     readonly maxBytes: number;
     readonly templateId?: string;
     readonly key?: string;
+}): Promise<BeforeTransactionResult<PreparedTemplateImage>>;
+export type Release = () => Promise<void>;
+export declare function releaseAll(releases: readonly Release[]): Promise<void>;
+export type PreparedLinkedResourceCopy = {
+    readonly key: string;
+    readonly entry: LinkedResourceEntry;
+    readonly upload?: UploadedFileBytes;
+};
+export declare function prepareLinkedResourceCopiesBeforeTransaction(args: {
+    readonly ctx: HandlerContext;
+    readonly user: SessionUser;
+    readonly tenantId: TenantId;
+    readonly resources: Readonly<Record<string, LinkedResourceEntry>>;
+}): Promise<BeforeTransactionResult<readonly PreparedLinkedResourceCopy[]>>;
+export declare function createLinkedResourceCopies(scope: TenantScope, prepared: readonly PreparedLinkedResourceCopy[]): Promise<WriteResult<Record<string, LinkedResourceEntry>>>;
+export declare function storePreparedTemplateResource(args: {
+    readonly ctx: HandlerContext;
+    readonly user: SessionUser;
+    readonly tenantId: TenantId;
+    readonly prepared: PreparedTemplateImage;
+    readonly templateId?: string;
+    readonly key?: string;
 }): Promise<WriteResult<StoredTemplateResource>>;
 export type StoredTemplateAttachment = {
     readonly fileRefId: string;
@@ -29,7 +72,7 @@ export type StoredTemplateAttachment = {
 export declare function attachmentNeedsMailTemplate(): WriteResult<never>;
 export declare function attachmentLimitFailure(): WriteResult<never>;
 export declare function otherAttachmentCount(linked: Readonly<Record<string, LinkedResourceEntry>>, key: string): number;
-export declare function storeBundleAttachment(args: {
+export declare function prepareTemplateAttachmentBeforeTransaction(args: {
     readonly ctx: HandlerContext;
     readonly user: SessionUser;
     readonly tenantId: TenantId;
@@ -37,16 +80,16 @@ export declare function storeBundleAttachment(args: {
     readonly maxBytes: number;
     readonly key: string;
     readonly fileName: string;
-}): Promise<WriteResult<FileAttachmentRef>>;
-export declare function storeTemplateAttachment(args: {
+    readonly templateId?: string;
+}): Promise<BeforeTransactionResult<PreparedTemplateAttachment>>;
+export declare function createPreparedBundleResourceEntry(scope: TenantScope, prepared: PreparedTemplateFile): Promise<WriteResult<LinkedResourceEntry>>;
+export declare function storePreparedTemplateAttachment(args: {
     readonly ctx: HandlerContext;
     readonly user: SessionUser;
     readonly tenantId: TenantId;
-    readonly bytes: Uint8Array;
-    readonly maxBytes: number;
+    readonly prepared: PreparedTemplateAttachment;
     readonly templateId: string;
     readonly key: string;
-    readonly fileName: string;
 }): Promise<WriteResult<StoredTemplateAttachment>>;
 export type LinkedTemplatePdfAttachment = {
     readonly key: string;
@@ -62,3 +105,4 @@ export declare function linkTemplatePdfAttachment(args: {
     readonly templateSlug: string;
     readonly fileName: string;
 }): Promise<WriteResult<LinkedTemplatePdfAttachment>>;
+export {};