@promptlycms/prompts 0.4.0 → 0.4.1-canary.8df0df3

package/README.md

@@ -180,6 +180,24 @@ const [first, second] = await promptly.getComposers([
 ]);
 ```
 
+### HTML blocks
+
+Composers can contain raw HTML blocks (for vendor-specific markup like MSO conditional comments in transactional emails). These surface as a distinct `html_block` segment type:
+
+```typescript
+const composer = await promptly.getComposer('my-email-composer', {
+  input: { country: 'United Kingdom' },
+});
+
+for (const segment of composer.segments) {
+  if (segment.type === 'html_block') {
+    console.log(segment.html); // raw HTML, byte-exact
+  }
+}
+```
+
+Variable references inside an `html_block` (e.g. `<span data-variable-ref data-field-path="country">`) are interpolated normally during `formatComposer()` / `compose()`. Embedded prompt references inside an `html_block` are passed through opaquely — they aren't resolved as named prompts.
+
 ## Model auto-detection
 
 The SDK automatically resolves models configured in the CMS to the correct AI SDK provider based on the model name prefix:

package/dist/cli.js

@@ -86,6 +86,28 @@ var extractTemplateVariables = (text) => {
   }
   return [...vars];
 };
+var extractStaticSegmentVariables = (content) => {
+  const vars = /* @__PURE__ */ new Set();
+  const varRefRegex = /<span[^>]*\sdata-variable-ref(?:="[^"]*")?[^>]*\sdata-field-path="([^"]+)"[^>]*><\/span>/g;
+  const varRefAltRegex = /<span[^>]*\sdata-field-path="([^"]+)"[^>]*\sdata-variable-ref(?:="[^"]*")?[^>]*><\/span>/g;
+  const mustacheRegex = /\{\{(\w[\w.]*)\}\}/g;
+  for (const match of content.matchAll(varRefRegex)) {
+    if (match[1]) {
+      vars.add(match[1]);
+    }
+  }
+  for (const match of content.matchAll(varRefAltRegex)) {
+    if (match[1]) {
+      vars.add(match[1]);
+    }
+  }
+  for (const match of content.matchAll(mustacheRegex)) {
+    if (match[1]) {
+      vars.add(match[1]);
+    }
+  }
+  return [...vars];
+};
 var fetchAllPrompts = async (apiKey, baseUrl) => {
   const url = new URL("/prompts", baseUrl ?? DEFAULT_BASE_URL);
   url.searchParams.set("include_versions", "true");
@@ -115,14 +137,21 @@ var fetchAllComposers = async (apiKey, baseUrl) => {
 var extractComposerVariables = (composer) => {
   const vars = /* @__PURE__ */ new Set();
   for (const segment of composer.segments) {
-    if (segment.type !== "prompt") {
-      continue;
-    }
-    if (!segment.userMessage) {
-      continue;
-    }
-    for (const v of extractTemplateVariables(segment.userMessage)) {
-      vars.add(v);
+    if (segment.type === "prompt") {
+      if (!segment.userMessage) {
+        continue;
+      }
+      for (const v of extractTemplateVariables(segment.userMessage)) {
+        vars.add(v);
+      }
+    } else if (segment.type === "static") {
+      for (const v of extractStaticSegmentVariables(segment.content)) {
+        vars.add(v);
+      }
+    } else if (segment.type === "html_block") {
+      for (const v of extractStaticSegmentVariables(segment.html)) {
+        vars.add(v);
+      }
     }
   }
   return [...vars];

package/dist/index.cjs

@@ -275,6 +275,13 @@ var createPromptlyClient = (config) => {
         });
         continue;
       }
+      if (segment.type === "html_block") {
+        processedSegments.push({
+          type: "static",
+          content: interpolateStaticSegment(segment.html, input)
+        });
+        continue;
+      }
       const camelName = toCamelCase(segment.promptName);
       if (!promptsByName.has(camelName)) {
         const segmentConfig = segment.config;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-DIVyjOlH.cjs';
-export { C as ComposerConfig, b as ComposerFormatFn, c as ComposerGenerateFn, d as ComposerId, e as ComposerInputFor, f as ComposerPrompt, g as ComposerPromptMap, h as ComposerPromptNamesFor, i as ComposerPromptSegment, j as ComposerRequest, k as ComposerResponse, l as ComposerResult, m as ComposerSegment, n as ComposerStaticSegment, o as ComposerVariableMap, p as ComposerVersion, q as ErrorResponse, F as FormatInput, G as GetComposerOptions, r as GetOptions, s as PromptConfig, t as PromptId, u as PromptMessage, v as PromptRequest, w as PromptResponse, x as PromptResult, y as PromptVariableMap, z as PromptVersion, A as PublishedVersion, S as SchemaField, B as SchemaFieldParams, V as ValidationRule } from './types-DIVyjOlH.cjs';
+import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-uh2qV9-f.cjs';
+export { C as ComposerConfig, b as ComposerFormatFn, c as ComposerGenerateFn, d as ComposerHtmlBlockSegment, e as ComposerId, f as ComposerInputFor, g as ComposerPrompt, h as ComposerPromptMap, i as ComposerPromptNamesFor, j as ComposerPromptSegment, k as ComposerRequest, l as ComposerResponse, m as ComposerResult, n as ComposerSegment, o as ComposerStaticSegment, p as ComposerVariableMap, q as ComposerVersion, r as ErrorResponse, F as FormatInput, G as GetComposerOptions, s as GetOptions, t as PromptConfig, u as PromptId, v as PromptMessage, w as PromptRequest, x as PromptResponse, y as PromptResult, z as PromptVariableMap, A as PromptVersion, B as PublishedVersion, S as SchemaField, D as SchemaFieldParams, V as ValidationRule } from './types-uh2qV9-f.cjs';
 import 'ai';
 
 declare const getSdkModelId: (modelId: string) => string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-DIVyjOlH.js';
-export { C as ComposerConfig, b as ComposerFormatFn, c as ComposerGenerateFn, d as ComposerId, e as ComposerInputFor, f as ComposerPrompt, g as ComposerPromptMap, h as ComposerPromptNamesFor, i as ComposerPromptSegment, j as ComposerRequest, k as ComposerResponse, l as ComposerResult, m as ComposerSegment, n as ComposerStaticSegment, o as ComposerVariableMap, p as ComposerVersion, q as ErrorResponse, F as FormatInput, G as GetComposerOptions, r as GetOptions, s as PromptConfig, t as PromptId, u as PromptMessage, v as PromptRequest, w as PromptResponse, x as PromptResult, y as PromptVariableMap, z as PromptVersion, A as PublishedVersion, S as SchemaField, B as SchemaFieldParams, V as ValidationRule } from './types-DIVyjOlH.js';
+import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-uh2qV9-f.js';
+export { C as ComposerConfig, b as ComposerFormatFn, c as ComposerGenerateFn, d as ComposerHtmlBlockSegment, e as ComposerId, f as ComposerInputFor, g as ComposerPrompt, h as ComposerPromptMap, i as ComposerPromptNamesFor, j as ComposerPromptSegment, k as ComposerRequest, l as ComposerResponse, m as ComposerResult, n as ComposerSegment, o as ComposerStaticSegment, p as ComposerVariableMap, q as ComposerVersion, r as ErrorResponse, F as FormatInput, G as GetComposerOptions, s as GetOptions, t as PromptConfig, u as PromptId, v as PromptMessage, w as PromptRequest, x as PromptResponse, y as PromptResult, z as PromptVariableMap, A as PromptVersion, B as PublishedVersion, S as SchemaField, D as SchemaFieldParams, V as ValidationRule } from './types-uh2qV9-f.js';
 import 'ai';
 
 declare const getSdkModelId: (modelId: string) => string;

package/dist/index.js

@@ -234,6 +234,13 @@ var createPromptlyClient = (config) => {
         });
         continue;
       }
+      if (segment.type === "html_block") {
+        processedSegments.push({
+          type: "static",
+          content: interpolateStaticSegment(segment.html, input)
+        });
+        continue;
+      }
       const camelName = toCamelCase(segment.promptName);
       if (!promptsByName.has(camelName)) {
         const segmentConfig = segment.config;

package/dist/schema.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { S as SchemaField } from './types-DIVyjOlH.cjs';
+import { S as SchemaField } from './types-uh2qV9-f.cjs';
 import 'ai';
 
 declare const buildFieldSchema: (field: SchemaField) => z.ZodTypeAny;

package/dist/schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { S as SchemaField } from './types-DIVyjOlH.js';
+import { S as SchemaField } from './types-uh2qV9-f.js';
 import 'ai';
 
 declare const buildFieldSchema: (field: SchemaField) => z.ZodTypeAny;

package/dist/{types-DIVyjOlH.d.cts → types-uh2qV9-f.d.cts}

@@ -108,7 +108,11 @@ type ComposerPromptSegment = {
     userMessage: string | null;
     config: Record<string, unknown>;
 };
-type ComposerSegment = ComposerStaticSegment | ComposerPromptSegment;
+type ComposerHtmlBlockSegment = {
+    type: 'html_block';
+    html: string;
+};
+type ComposerSegment = ComposerStaticSegment | ComposerPromptSegment | ComposerHtmlBlockSegment;
 type ComposerConfig = {
     schema: SchemaField[];
     inputData: unknown;
@@ -195,4 +199,4 @@ type PromptlyClient = {
     getComposers: <const T extends readonly ComposerRequest[]>(entries: T) => Promise<GetComposersResults<T>>;
 };
 
-export type { PublishedVersion as A, SchemaFieldParams as B, ComposerConfig as C, ErrorCode as E, FormatInput as F, GetComposerOptions as G, PromptlyClientConfig as P, SchemaField as S, ValidationRule as V, PromptlyClient as a, ComposerFormatFn as b, ComposerGenerateFn as c, ComposerId as d, ComposerInputFor as e, ComposerPrompt as f, ComposerPromptMap as g, ComposerPromptNamesFor as h, ComposerPromptSegment as i, ComposerRequest as j, ComposerResponse as k, ComposerResult as l, ComposerSegment as m, ComposerStaticSegment as n, ComposerVariableMap as o, ComposerVersion as p, ErrorResponse as q, GetOptions as r, PromptConfig as s, PromptId as t, PromptMessage as u, PromptRequest as v, PromptResponse as w, PromptResult as x, PromptVariableMap as y, PromptVersion as z };
+export type { PromptVersion as A, PublishedVersion as B, ComposerConfig as C, SchemaFieldParams as D, ErrorCode as E, FormatInput as F, GetComposerOptions as G, PromptlyClientConfig as P, SchemaField as S, ValidationRule as V, PromptlyClient as a, ComposerFormatFn as b, ComposerGenerateFn as c, ComposerHtmlBlockSegment as d, ComposerId as e, ComposerInputFor as f, ComposerPrompt as g, ComposerPromptMap as h, ComposerPromptNamesFor as i, ComposerPromptSegment as j, ComposerRequest as k, ComposerResponse as l, ComposerResult as m, ComposerSegment as n, ComposerStaticSegment as o, ComposerVariableMap as p, ComposerVersion as q, ErrorResponse as r, GetOptions as s, PromptConfig as t, PromptId as u, PromptMessage as v, PromptRequest as w, PromptResponse as x, PromptResult as y, PromptVariableMap as z };

package/dist/{types-DIVyjOlH.d.ts → types-uh2qV9-f.d.ts}

@@ -108,7 +108,11 @@ type ComposerPromptSegment = {
     userMessage: string | null;
     config: Record<string, unknown>;
 };
-type ComposerSegment = ComposerStaticSegment | ComposerPromptSegment;
+type ComposerHtmlBlockSegment = {
+    type: 'html_block';
+    html: string;
+};
+type ComposerSegment = ComposerStaticSegment | ComposerPromptSegment | ComposerHtmlBlockSegment;
 type ComposerConfig = {
     schema: SchemaField[];
     inputData: unknown;
@@ -195,4 +199,4 @@ type PromptlyClient = {
     getComposers: <const T extends readonly ComposerRequest[]>(entries: T) => Promise<GetComposersResults<T>>;
 };
 
-export type { PublishedVersion as A, SchemaFieldParams as B, ComposerConfig as C, ErrorCode as E, FormatInput as F, GetComposerOptions as G, PromptlyClientConfig as P, SchemaField as S, ValidationRule as V, PromptlyClient as a, ComposerFormatFn as b, ComposerGenerateFn as c, ComposerId as d, ComposerInputFor as e, ComposerPrompt as f, ComposerPromptMap as g, ComposerPromptNamesFor as h, ComposerPromptSegment as i, ComposerRequest as j, ComposerResponse as k, ComposerResult as l, ComposerSegment as m, ComposerStaticSegment as n, ComposerVariableMap as o, ComposerVersion as p, ErrorResponse as q, GetOptions as r, PromptConfig as s, PromptId as t, PromptMessage as u, PromptRequest as v, PromptResponse as w, PromptResult as x, PromptVariableMap as y, PromptVersion as z };
+export type { PromptVersion as A, PublishedVersion as B, ComposerConfig as C, SchemaFieldParams as D, ErrorCode as E, FormatInput as F, GetComposerOptions as G, PromptlyClientConfig as P, SchemaField as S, ValidationRule as V, PromptlyClient as a, ComposerFormatFn as b, ComposerGenerateFn as c, ComposerHtmlBlockSegment as d, ComposerId as e, ComposerInputFor as f, ComposerPrompt as g, ComposerPromptMap as h, ComposerPromptNamesFor as i, ComposerPromptSegment as j, ComposerRequest as k, ComposerResponse as l, ComposerResult as m, ComposerSegment as n, ComposerStaticSegment as o, ComposerVariableMap as p, ComposerVersion as q, ErrorResponse as r, GetOptions as s, PromptConfig as t, PromptId as u, PromptMessage as v, PromptRequest as w, PromptResponse as x, PromptResult as y, PromptVariableMap as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptlycms/prompts",
-  "version": "0.4.0",
+  "version": "0.4.1-canary.8df0df3",
   "description": "TypeScript SDK for Promptly CMS — fetch prompts, build Zod schemas, generate typed code",
   "type": "module",
   "exports": {