pte-interpolation-core 1.2.1 → 1.3.1

package/dist/index.cjs

@@ -61,7 +61,10 @@ function interpolateToString(blocks, values, fallback = defaultFallback) {
     return children.map((child) => {
       if (child._type === VARIABLE_TYPE_PREFIX) {
         const variableKey = child.variableKey;
-        return values[variableKey] !== void 0 ? values[variableKey] : fallback(variableKey);
+        if (typeof variableKey === "string") {
+          return values[variableKey] !== void 0 ? values[variableKey] : fallback(variableKey);
+        }
+        return "";
       }
       return typeof child.text === "string" ? child.text : "";
     }).join("");

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/extractVariableKeys.ts","../src/getMissingVariableKeys.ts","../src/interpolateToString.ts"],"sourcesContent":["export {VARIABLE_TYPE_PREFIX} from './constants'\nexport {extractVariableKeys} from './extractVariableKeys'\nexport {getMissingVariableKeys} from './getMissingVariableKeys'\nexport {interpolateToString} from './interpolateToString'\nexport type {\n  InterpolationFallback,\n  InterpolationValues,\n  PortableTextBlockLike,\n  PortableTextChild,\n  PteInterpolationVariableBlock,\n} from './types'\n","/** @public */\nexport const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {PortableTextBlockLike} from './types'\n\n/** @public */\nexport function extractVariableKeys(blocks: PortableTextBlockLike[]): string[] {\n  const seen = new Set<string>()\n\n  return blocks.reduce<string[]>((keys, block) => {\n    const children = block.children ?? []\n\n    return children.reduce((accumulated, child) => {\n      if (child._type !== VARIABLE_TYPE_PREFIX) return accumulated\n\n      const variableKey = child.variableKey\n      if (typeof variableKey !== 'string') return accumulated\n      if (seen.has(variableKey)) return accumulated\n\n      seen.add(variableKey)\n      return [...accumulated, variableKey]\n    }, keys)\n  }, [])\n}\n","import {extractVariableKeys} from './extractVariableKeys'\nimport type {InterpolationValues, PortableTextBlockLike} from './types'\n\n/** @public */\nexport function getMissingVariableKeys(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n): string[] {\n  return extractVariableKeys(blocks).filter((key) => values[key] === undefined)\n}\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {InterpolationFallback, InterpolationValues, PortableTextBlockLike} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function interpolateToString(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): string {\n  return blocks\n    .map((block) => {\n      const children = block.children ?? []\n\n      return children\n        .map((child) => {\n          if (child._type === VARIABLE_TYPE_PREFIX) {\n            const variableKey = child.variableKey as string\n            return values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n          }\n\n          return typeof child.text === 'string' ? child.text : ''\n        })\n        .join('')\n    })\n    .join('\\n')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCO,IAAM,uBAAuB;;;ACG7B,SAAS,oBAAoB,QAA2C;AAC7E,QAAM,OAAO,oBAAI,IAAY;AAE7B,SAAO,OAAO,OAAiB,CAAC,MAAM,UAAU;AAC9C,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SAAS,OAAO,CAAC,aAAa,UAAU;AAC7C,UAAI,MAAM,UAAU,qBAAsB,QAAO;AAEjD,YAAM,cAAc,MAAM;AAC1B,UAAI,OAAO,gBAAgB,SAAU,QAAO;AAC5C,UAAI,KAAK,IAAI,WAAW,EAAG,QAAO;AAElC,WAAK,IAAI,WAAW;AACpB,aAAO,CAAC,GAAG,aAAa,WAAW;AAAA,IACrC,GAAG,IAAI;AAAA,EACT,GAAG,CAAC,CAAC;AACP;;;ACjBO,SAAS,uBACd,QACA,QACU;AACV,SAAO,oBAAoB,MAAM,EAAE,OAAO,CAAC,QAAQ,OAAO,GAAG,MAAM,MAAS;AAC9E;;;ACNA,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,oBACd,QACA,QACA,WAAkC,iBAC1B;AACR,SAAO,OACJ,IAAI,CAAC,UAAU;AACd,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SACJ,IAAI,CAAC,UAAU;AACd,UAAI,MAAM,UAAU,sBAAsB;AACxC,cAAM,cAAc,MAAM;AAC1B,eAAO,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAAA,MACvF;AAEA,aAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAAA,IACvD,CAAC,EACA,KAAK,EAAE;AAAA,EACZ,CAAC,EACA,KAAK,IAAI;AACd;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/extractVariableKeys.ts","../src/getMissingVariableKeys.ts","../src/interpolateToString.ts"],"sourcesContent":["export {VARIABLE_TYPE_PREFIX} from './constants'\nexport {extractVariableKeys} from './extractVariableKeys'\nexport {getMissingVariableKeys} from './getMissingVariableKeys'\nexport {interpolateToString} from './interpolateToString'\nexport type {\n  InterpolationFallback,\n  InterpolationValues,\n  PortableTextBlockLike,\n  PortableTextChild,\n  PteInterpolationVariableBlock,\n} from './types'\n","/** @public */\nexport const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {PortableTextBlockLike} from './types'\n\n/** @public */\nexport function extractVariableKeys(blocks: PortableTextBlockLike[]): string[] {\n  const seen = new Set<string>()\n\n  return blocks.reduce<string[]>((keys, block) => {\n    const children = block.children ?? []\n\n    return children.reduce((accumulated, child) => {\n      if (child._type !== VARIABLE_TYPE_PREFIX) return accumulated\n\n      const variableKey = child.variableKey\n      if (typeof variableKey !== 'string') return accumulated\n      if (seen.has(variableKey)) return accumulated\n\n      seen.add(variableKey)\n      return [...accumulated, variableKey]\n    }, keys)\n  }, [])\n}\n","import {extractVariableKeys} from './extractVariableKeys'\nimport type {InterpolationValues, PortableTextBlockLike} from './types'\n\n/** @public */\nexport function getMissingVariableKeys(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n): string[] {\n  return extractVariableKeys(blocks).filter((key) => values[key] === undefined)\n}\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {InterpolationFallback, InterpolationValues, PortableTextBlockLike} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function interpolateToString(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): string {\n  return blocks\n    .map((block) => {\n      const children = block.children ?? []\n\n      return children\n        .map((child) => {\n          if (child._type === VARIABLE_TYPE_PREFIX) {\n            const variableKey = child.variableKey\n            if (typeof variableKey === 'string') {\n              return values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n            }\n            return ''\n          }\n\n          return typeof child.text === 'string' ? child.text : ''\n        })\n        .join('')\n    })\n    .join('\\n')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCO,IAAM,uBAAuB;;;ACG7B,SAAS,oBAAoB,QAA2C;AAC7E,QAAM,OAAO,oBAAI,IAAY;AAE7B,SAAO,OAAO,OAAiB,CAAC,MAAM,UAAU;AAC9C,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SAAS,OAAO,CAAC,aAAa,UAAU;AAC7C,UAAI,MAAM,UAAU,qBAAsB,QAAO;AAEjD,YAAM,cAAc,MAAM;AAC1B,UAAI,OAAO,gBAAgB,SAAU,QAAO;AAC5C,UAAI,KAAK,IAAI,WAAW,EAAG,QAAO;AAElC,WAAK,IAAI,WAAW;AACpB,aAAO,CAAC,GAAG,aAAa,WAAW;AAAA,IACrC,GAAG,IAAI;AAAA,EACT,GAAG,CAAC,CAAC;AACP;;;ACjBO,SAAS,uBACd,QACA,QACU;AACV,SAAO,oBAAoB,MAAM,EAAE,OAAO,CAAC,QAAQ,OAAO,GAAG,MAAM,MAAS;AAC9E;;;ACNA,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,oBACd,QACA,QACA,WAAkC,iBAC1B;AACR,SAAO,OACJ,IAAI,CAAC,UAAU;AACd,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SACJ,IAAI,CAAC,UAAU;AACd,UAAI,MAAM,UAAU,sBAAsB;AACxC,cAAM,cAAc,MAAM;AAC1B,YAAI,OAAO,gBAAgB,UAAU;AACnC,iBAAO,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAAA,QACvF;AACA,eAAO;AAAA,MACT;AAEA,aAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAAA,IACvD,CAAC,EACA,KAAK,EAAE;AAAA,EACZ,CAAC,EACA,KAAK,IAAI;AACd;","names":[]}

package/dist/index.js

@@ -32,7 +32,10 @@ function interpolateToString(blocks, values, fallback = defaultFallback) {
     return children.map((child) => {
       if (child._type === VARIABLE_TYPE_PREFIX) {
         const variableKey = child.variableKey;
-        return values[variableKey] !== void 0 ? values[variableKey] : fallback(variableKey);
+        if (typeof variableKey === "string") {
+          return values[variableKey] !== void 0 ? values[variableKey] : fallback(variableKey);
+        }
+        return "";
       }
       return typeof child.text === "string" ? child.text : "";
     }).join("");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/extractVariableKeys.ts","../src/getMissingVariableKeys.ts","../src/interpolateToString.ts"],"sourcesContent":["/** @public */\nexport const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {PortableTextBlockLike} from './types'\n\n/** @public */\nexport function extractVariableKeys(blocks: PortableTextBlockLike[]): string[] {\n  const seen = new Set<string>()\n\n  return blocks.reduce<string[]>((keys, block) => {\n    const children = block.children ?? []\n\n    return children.reduce((accumulated, child) => {\n      if (child._type !== VARIABLE_TYPE_PREFIX) return accumulated\n\n      const variableKey = child.variableKey\n      if (typeof variableKey !== 'string') return accumulated\n      if (seen.has(variableKey)) return accumulated\n\n      seen.add(variableKey)\n      return [...accumulated, variableKey]\n    }, keys)\n  }, [])\n}\n","import {extractVariableKeys} from './extractVariableKeys'\nimport type {InterpolationValues, PortableTextBlockLike} from './types'\n\n/** @public */\nexport function getMissingVariableKeys(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n): string[] {\n  return extractVariableKeys(blocks).filter((key) => values[key] === undefined)\n}\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {InterpolationFallback, InterpolationValues, PortableTextBlockLike} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function interpolateToString(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): string {\n  return blocks\n    .map((block) => {\n      const children = block.children ?? []\n\n      return children\n        .map((child) => {\n          if (child._type === VARIABLE_TYPE_PREFIX) {\n            const variableKey = child.variableKey as string\n            return values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n          }\n\n          return typeof child.text === 'string' ? child.text : ''\n        })\n        .join('')\n    })\n    .join('\\n')\n}\n"],"mappings":";AACO,IAAM,uBAAuB;;;ACG7B,SAAS,oBAAoB,QAA2C;AAC7E,QAAM,OAAO,oBAAI,IAAY;AAE7B,SAAO,OAAO,OAAiB,CAAC,MAAM,UAAU;AAC9C,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SAAS,OAAO,CAAC,aAAa,UAAU;AAC7C,UAAI,MAAM,UAAU,qBAAsB,QAAO;AAEjD,YAAM,cAAc,MAAM;AAC1B,UAAI,OAAO,gBAAgB,SAAU,QAAO;AAC5C,UAAI,KAAK,IAAI,WAAW,EAAG,QAAO;AAElC,WAAK,IAAI,WAAW;AACpB,aAAO,CAAC,GAAG,aAAa,WAAW;AAAA,IACrC,GAAG,IAAI;AAAA,EACT,GAAG,CAAC,CAAC;AACP;;;ACjBO,SAAS,uBACd,QACA,QACU;AACV,SAAO,oBAAoB,MAAM,EAAE,OAAO,CAAC,QAAQ,OAAO,GAAG,MAAM,MAAS;AAC9E;;;ACNA,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,oBACd,QACA,QACA,WAAkC,iBAC1B;AACR,SAAO,OACJ,IAAI,CAAC,UAAU;AACd,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SACJ,IAAI,CAAC,UAAU;AACd,UAAI,MAAM,UAAU,sBAAsB;AACxC,cAAM,cAAc,MAAM;AAC1B,eAAO,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAAA,MACvF;AAEA,aAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAAA,IACvD,CAAC,EACA,KAAK,EAAE;AAAA,EACZ,CAAC,EACA,KAAK,IAAI;AACd;","names":[]}
+{"version":3,"sources":["../src/constants.ts","../src/extractVariableKeys.ts","../src/getMissingVariableKeys.ts","../src/interpolateToString.ts"],"sourcesContent":["/** @public */\nexport const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {PortableTextBlockLike} from './types'\n\n/** @public */\nexport function extractVariableKeys(blocks: PortableTextBlockLike[]): string[] {\n  const seen = new Set<string>()\n\n  return blocks.reduce<string[]>((keys, block) => {\n    const children = block.children ?? []\n\n    return children.reduce((accumulated, child) => {\n      if (child._type !== VARIABLE_TYPE_PREFIX) return accumulated\n\n      const variableKey = child.variableKey\n      if (typeof variableKey !== 'string') return accumulated\n      if (seen.has(variableKey)) return accumulated\n\n      seen.add(variableKey)\n      return [...accumulated, variableKey]\n    }, keys)\n  }, [])\n}\n","import {extractVariableKeys} from './extractVariableKeys'\nimport type {InterpolationValues, PortableTextBlockLike} from './types'\n\n/** @public */\nexport function getMissingVariableKeys(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n): string[] {\n  return extractVariableKeys(blocks).filter((key) => values[key] === undefined)\n}\n","import {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {InterpolationFallback, InterpolationValues, PortableTextBlockLike} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function interpolateToString(\n  blocks: PortableTextBlockLike[],\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): string {\n  return blocks\n    .map((block) => {\n      const children = block.children ?? []\n\n      return children\n        .map((child) => {\n          if (child._type === VARIABLE_TYPE_PREFIX) {\n            const variableKey = child.variableKey\n            if (typeof variableKey === 'string') {\n              return values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n            }\n            return ''\n          }\n\n          return typeof child.text === 'string' ? child.text : ''\n        })\n        .join('')\n    })\n    .join('\\n')\n}\n"],"mappings":";AACO,IAAM,uBAAuB;;;ACG7B,SAAS,oBAAoB,QAA2C;AAC7E,QAAM,OAAO,oBAAI,IAAY;AAE7B,SAAO,OAAO,OAAiB,CAAC,MAAM,UAAU;AAC9C,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SAAS,OAAO,CAAC,aAAa,UAAU;AAC7C,UAAI,MAAM,UAAU,qBAAsB,QAAO;AAEjD,YAAM,cAAc,MAAM;AAC1B,UAAI,OAAO,gBAAgB,SAAU,QAAO;AAC5C,UAAI,KAAK,IAAI,WAAW,EAAG,QAAO;AAElC,WAAK,IAAI,WAAW;AACpB,aAAO,CAAC,GAAG,aAAa,WAAW;AAAA,IACrC,GAAG,IAAI;AAAA,EACT,GAAG,CAAC,CAAC;AACP;;;ACjBO,SAAS,uBACd,QACA,QACU;AACV,SAAO,oBAAoB,MAAM,EAAE,OAAO,CAAC,QAAQ,OAAO,GAAG,MAAM,MAAS;AAC9E;;;ACNA,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,oBACd,QACA,QACA,WAAkC,iBAC1B;AACR,SAAO,OACJ,IAAI,CAAC,UAAU;AACd,UAAM,WAAW,MAAM,YAAY,CAAC;AAEpC,WAAO,SACJ,IAAI,CAAC,UAAU;AACd,UAAI,MAAM,UAAU,sBAAsB;AACxC,cAAM,cAAc,MAAM;AAC1B,YAAI,OAAO,gBAAgB,UAAU;AACnC,iBAAO,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAAA,QACvF;AACA,eAAO;AAAA,MACT;AAEA,aAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAAA,IACvD,CAAC,EACA,KAAK,EAAE;AAAA,EACZ,CAAC,EACA,KAAK,IAAI;AACd;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pte-interpolation-core",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "type": "module",
   "license": "MIT",
   "description": "Framework-agnostic utilities for Portable Text variable interpolation",

package/src/__tests__/fixtures.ts

@@ -81,6 +81,14 @@ export const duplicateVariableBlock: PortableTextBlockLike[] = [
 
 export const blockWithNoChildren: PortableTextBlockLike[] = [{_type: 'block', _key: 'block-1'}]
 
+export const blockWithMissingVariableKey: PortableTextBlockLike[] = [
+  {
+    _type: 'block',
+    _key: 'block-1',
+    children: [{_type: 'pteInterpolationVariable', _key: 'var-1'}],
+  },
+]
+
 export const blockWithNonStringVariableKey: PortableTextBlockLike[] = [
   {
     _type: 'block',

package/src/__tests__/getMissingVariableKeys.test.ts

@@ -22,14 +22,14 @@ describe('getMissingVariableKeys', () => {
   })
 
   it('returns empty array when all variables provided', () => {
-    expect(getMissingVariableKeys(singleVariableBlock, {firstName: 'Alice'})).toEqual([])
+    expect(getMissingVariableKeys(singleVariableBlock, {firstName: 'Patrick'})).toEqual([])
   })
 
   it('returns empty array when all multiple variables provided', () => {
     expect(
       getMissingVariableKeys(multipleVariablesBlock, {
-        firstName: 'Alice',
-        lastName: 'Smith',
+        firstName: 'Patrick',
+        lastName: 'Pickles',
         email: 'a@b.com',
       }),
     ).toEqual([])
@@ -40,7 +40,7 @@ describe('getMissingVariableKeys', () => {
   })
 
   it('returns only missing keys when some values provided', () => {
-    expect(getMissingVariableKeys(multipleVariablesBlock, {firstName: 'Alice'})).toEqual([
+    expect(getMissingVariableKeys(multipleVariablesBlock, {firstName: 'Patrick'})).toEqual([
       'lastName',
       'email',
     ])
@@ -51,7 +51,7 @@ describe('getMissingVariableKeys', () => {
   })
 
   it('returns missing keys across multiple blocks', () => {
-    expect(getMissingVariableKeys(multiBlockContent, {firstName: 'Alice'})).toEqual(['email'])
+    expect(getMissingVariableKeys(multiBlockContent, {firstName: 'Patrick'})).toEqual(['email'])
   })
 
   it('deduplicates missing keys', () => {
@@ -67,14 +67,14 @@ describe('getMissingVariableKeys', () => {
   })
 
   it('returns missing keys for consecutive variables', () => {
-    expect(getMissingVariableKeys(consecutiveVariablesBlock, {firstName: 'Alice'})).toEqual([
+    expect(getMissingVariableKeys(consecutiveVariablesBlock, {firstName: 'Patrick'})).toEqual([
       'lastName',
     ])
   })
 
   it('ignores extra values not in blocks', () => {
     expect(
-      getMissingVariableKeys(singleVariableBlock, {firstName: 'Alice', extraKey: 'ignored'}),
+      getMissingVariableKeys(singleVariableBlock, {firstName: 'Patrick', extraKey: 'ignored'}),
     ).toEqual([])
   })
 

package/src/__tests__/interpolateToString.test.ts

@@ -1,6 +1,8 @@
 import {describe, expect, it} from 'vitest'
 import {interpolateToString} from '../interpolateToString'
 import {
+  blockWithMissingVariableKey,
+  blockWithNonStringVariableKey,
   consecutiveVariablesBlock,
   emptyBlocksContent,
   multiBlockContent,
@@ -19,7 +21,7 @@ describe('interpolateToString', () => {
   })
 
   it('resolves a single variable from values', () => {
-    expect(interpolateToString(singleVariableBlock, {firstName: 'Alice'})).toBe('Hello, Alice!')
+    expect(interpolateToString(singleVariableBlock, {firstName: 'Patrick'})).toBe('Hello, Patrick!')
   })
 
   it('uses default fallback for missing variables', () => {
@@ -37,23 +39,31 @@ describe('interpolateToString', () => {
 
   it('resolves consecutive variables', () => {
     expect(
-      interpolateToString(consecutiveVariablesBlock, {firstName: 'Alice', lastName: 'Smith'}),
-    ).toBe('AliceSmith')
+      interpolateToString(consecutiveVariablesBlock, {firstName: 'Patrick', lastName: 'Pickles'}),
+    ).toBe('PatrickPickles')
   })
 
   it('joins multiple blocks with newlines', () => {
     expect(
-      interpolateToString(multiBlockContent, {firstName: 'Alice', email: 'alice@example.com'}),
-    ).toBe('Dear Alice,\nYour email is alice@example.com.')
+      interpolateToString(multiBlockContent, {firstName: 'Patrick', email: 'patrick@example.com'}),
+    ).toBe('Dear Patrick,\nYour email is patrick@example.com.')
   })
 
   it('resolves multiple variables in one block', () => {
     expect(
       interpolateToString(multipleVariablesBlock, {
-        firstName: 'Alice',
-        lastName: 'Smith',
-        email: 'alice@example.com',
+        firstName: 'Patrick',
+        lastName: 'Pickles',
+        email: 'patrick@example.com',
       }),
-    ).toBe('Name: Alice Smith, Email: alice@example.com')
+    ).toBe('Name: Patrick Pickles, Email: patrick@example.com')
+  })
+
+  it('returns empty string for a variable block with a missing variableKey', () => {
+    expect(interpolateToString(blockWithMissingVariableKey, {})).toBe('')
+  })
+
+  it('returns empty string for a variable block with a non-string variableKey', () => {
+    expect(interpolateToString(blockWithNonStringVariableKey, {})).toBe('')
   })
 })

package/src/interpolateToString.ts

@@ -18,8 +18,11 @@ export function interpolateToString(
       return children
         .map((child) => {
           if (child._type === VARIABLE_TYPE_PREFIX) {
-            const variableKey = child.variableKey as string
-            return values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)
+            const variableKey = child.variableKey
+            if (typeof variableKey === 'string') {
+              return values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)
+            }
+            return ''
           }
 
           return typeof child.text === 'string' ? child.text : ''