@jakubmazanec/carson 0.1.0-c5ebb6f → 0.1.0-next.336fe21

package/dist/template/TemplateAttributes.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 export declare const templateAttributesSchema: z.ZodObject<{
-    strategy: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"overwrite">, z.ZodLiteral<"merge">, z.ZodLiteral<"check">, z.ZodTuple<[z.ZodLiteral<"insert">, z.ZodString], null>]>;
+    strategy: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"ensure">, z.ZodLiteral<"overwrite">, z.ZodLiteral<"merge">, z.ZodLiteral<"check">, z.ZodTuple<[z.ZodLiteral<"insert">, z.ZodString], null>]>;
 }, "strict", z.ZodTypeAny, {
-    strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+    strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
 }, {
-    strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+    strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
 }>;
 export type TemplateAttributes = z.infer<typeof templateAttributesSchema>;

package/dist/template/TemplateAttributes.js

@@ -1,6 +1,8 @@
 import { z } from 'zod';
+// TODO: add strategy 'none' so when you using template A that extends template B, you can overwrite template files to no-op
 let strategyTemplateAttributeSchema = z.union([
     z.literal('create'),
+    z.literal('ensure'),
     z.literal('overwrite'),
     z.literal('merge'),
     z.literal('check'),
@@ -10,7 +12,6 @@ let strategyTemplateAttributeSchema = z.union([
     ])
 ]);
 export const templateAttributesSchema = z.object({
-    // TODO: add strategy 'none' so when you using template A that extends template B, you can overwrite template files to no-op
     strategy: strategyTemplateAttributeSchema
 }).strict();
 

package/dist/template/TemplateAttributes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/template/TemplateAttributes.ts"],"sourcesContent":["import {z} from 'zod';\n\nlet strategyTemplateAttributeSchema = z.union([\n  z.literal('create'),\n  z.literal('overwrite'),\n  z.literal('merge'),\n  z.literal('check'),\n  z.tuple([z.literal('insert'), z.string()]),\n]);\n\nexport const templateAttributesSchema = z\n  .object({\n    // TODO: add strategy 'none' so when you using template A that extends template B, you can overwrite template files to no-op\n    strategy: strategyTemplateAttributeSchema,\n  })\n  .strict();\n\nexport type TemplateAttributes = z.infer<typeof templateAttributesSchema>;\n"],"names":["z","strategyTemplateAttributeSchema","union","literal","tuple","string","templateAttributesSchema","object","strategy","strict"],"mappings":"AAAA,SAAQA,CAAC,QAAO,MAAM;AAEtB,IAAIC,kCAAkCD,EAAEE,KAAK,CAAC;IAC5CF,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEI,KAAK,CAAC;QAACJ,EAAEG,OAAO,CAAC;QAAWH,EAAEK,MAAM;KAAG;CAC1C;AAED,OAAO,MAAMC,2BAA2BN,EACrCO,MAAM,CAAC;IACN,4HAA4H;IAC5HC,UAAUP;AACZ,GACCQ,MAAM,GAAG"}
+{"version":3,"sources":["../../src/template/TemplateAttributes.ts"],"sourcesContent":["import {z} from 'zod';\n\n// TODO: add strategy 'none' so when you using template A that extends template B, you can overwrite template files to no-op\nlet strategyTemplateAttributeSchema = z.union([\n  z.literal('create'),\n  z.literal('ensure'),\n  z.literal('overwrite'),\n  z.literal('merge'),\n  z.literal('check'),\n  z.tuple([z.literal('insert'), z.string()]),\n]);\n\nexport const templateAttributesSchema = z\n  .object({\n    strategy: strategyTemplateAttributeSchema,\n  })\n  .strict();\n\nexport type TemplateAttributes = z.infer<typeof templateAttributesSchema>;\n"],"names":["z","strategyTemplateAttributeSchema","union","literal","tuple","string","templateAttributesSchema","object","strategy","strict"],"mappings":"AAAA,SAAQA,CAAC,QAAO,MAAM;AAEtB,4HAA4H;AAC5H,IAAIC,kCAAkCD,EAAEE,KAAK,CAAC;IAC5CF,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEG,OAAO,CAAC;IACVH,EAAEI,KAAK,CAAC;QAACJ,EAAEG,OAAO,CAAC;QAAWH,EAAEK,MAAM;KAAG;CAC1C;AAED,OAAO,MAAMC,2BAA2BN,EACrCO,MAAM,CAAC;IACNC,UAAUP;AACZ,GACCQ,MAAM,GAAG"}

package/dist/template/TemplateRender.d.ts

@@ -2,6 +2,10 @@ import { type TemplateRender as BaseTemplateRender } from '@jakubmazanec/templat
 import { type templateAttributesSchema } from './TemplateAttributes.js';
 import { type templateDataSchema } from './TemplateData.js';
 /**
- * A template render result.
+ * A result of rendering a Carson template file.
  */
-export type TemplateRender = BaseTemplateRender<typeof templateAttributesSchema, typeof templateDataSchema>;
+export type TemplateRender = BaseTemplateRender<typeof templateAttributesSchema, typeof templateDataSchema> & {
+    template: {
+        path: string;
+    };
+};

package/dist/template/TemplateRender.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/template/TemplateRender.ts"],"sourcesContent":["import {type TemplateRender as BaseTemplateRender} from '@jakubmazanec/template';\n\nimport {type templateAttributesSchema} from './TemplateAttributes.js';\nimport {type templateDataSchema} from './TemplateData.js';\n\n/**\n * A template render result.\n */\nexport type TemplateRender = BaseTemplateRender<\n  typeof templateAttributesSchema,\n  typeof templateDataSchema\n>;\n"],"names":[],"mappings":"AAAA,WAWE"}
+{"version":3,"sources":["../../src/template/TemplateRender.ts"],"sourcesContent":["import {type TemplateRender as BaseTemplateRender} from '@jakubmazanec/template';\n\nimport {type templateAttributesSchema} from './TemplateAttributes.js';\nimport {type templateDataSchema} from './TemplateData.js';\n\n/**\n * A result of rendering a Carson template file.\n */\nexport type TemplateRender = BaseTemplateRender<\n  typeof templateAttributesSchema,\n  typeof templateDataSchema\n> & {\n  template: {\n    path: string;\n  };\n};\n"],"names":[],"mappings":"AAAA,WAeE"}

package/dist/template/TemplateRenders.d.ts

@@ -1,5 +1,5 @@
 import { type TemplateRender } from './TemplateRender.js';
 /**
- * A collection of template render results.
+ * A {@link TemplateRender} collection.
  */
 export type TemplateRenders = TemplateRender[];

package/dist/template/TemplateRenders.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/template/TemplateRenders.ts"],"sourcesContent":["import {type TemplateRender} from './TemplateRender.js';\n\n/**\n * A collection of template render results.\n */\nexport type TemplateRenders = TemplateRender[];\n"],"names":[],"mappings":"AAAA,WAK+C"}
+{"version":3,"sources":["../../src/template/TemplateRenders.ts"],"sourcesContent":["import {type TemplateRender} from './TemplateRender.js';\n\n/**\n * A {@link TemplateRender} collection.\n */\nexport type TemplateRenders = TemplateRender[];\n"],"names":[],"mappings":"AAAA,WAK+C"}

package/dist/template/applyTemplateRenders.d.ts

@@ -4,4 +4,7 @@ export type ApplyTemplateRendersOptions = {
     path: string;
     ignoreStrategies: string[];
 };
+/**
+ * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.
+ */
 export declare function applyTemplateRenders({ templateRenders, path: targetPath, ignoreStrategies, }: ApplyTemplateRendersOptions): Promise<void>;

package/dist/template/applyTemplateRenders.js

@@ -1,11 +1,16 @@
-import fs from 'fs-extra';
+// TODO: can this be fixed?
+/* eslint-disable complexity -- TODO */ import fs from 'fs-extra';
 import path from 'node:path';
 import prettier from 'prettier';
+import { CarsonTemplateError } from './CarsonTemplateError.js';
 import { createUsingTemplateRender, deleteUsingTemplateRender, insertUsingTemplateRender, loadTemplateRenderSnapshots, mergeUsingTemplateRender, overwriteUsingTemplateRender, saveTemplateRenderSnapshots, uninsertUsingTemplateRender, unmergeUsingTemplateRender } from './internals.js';
 import { CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME } from '../constants.js';
-export async function applyTemplateRenders({ templateRenders, path: targetPath, ignoreStrategies }) {
+/**
+ * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.
+ */ export async function applyTemplateRenders({ templateRenders, path: targetPath, ignoreStrategies }) {
     // we need to clear Prettier cache, because we are changing file system
     prettier.clearConfigCache();
+    // first, we read the existing snapshots and use them to undo previous changes
     let templateRenderSnapshotsPath = path.join(targetPath, CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME);
     if (await fs.pathExists(templateRenderSnapshotsPath)) {
         let templateRenderSnapshots = await loadTemplateRenderSnapshots(templateRenderSnapshotsPath);
@@ -14,6 +19,11 @@ export async function applyTemplateRenders({ templateRenders, path: targetPath,
             if (ignoreStrategies.includes(strategy)) {
                 continue;
             }
+            if (templateRenderSnapshot.attributes.strategy === 'ensure') {
+                await deleteUsingTemplateRender(templateRenderSnapshot, targetPath, {
+                    onlyDeleteWhenContentsMatch: true
+                });
+            }
             if (templateRenderSnapshot.attributes.strategy === 'overwrite') {
                 await deleteUsingTemplateRender(templateRenderSnapshot, targetPath);
             }
@@ -25,13 +35,24 @@ export async function applyTemplateRenders({ templateRenders, path: targetPath,
             }
         }
     }
-    if (!ignoreStrategies.includes('create')) {
-        for (let templateRender of templateRenders){
-            if (templateRender.attributes.strategy === 'create') {
+    // second, we apply strategies that create files
+    for (let templateRender of templateRenders){
+        let strategy = typeof templateRender.attributes.strategy === 'string' ? templateRender.attributes.strategy : templateRender.attributes.strategy[0];
+        if (ignoreStrategies.includes(strategy)) {
+            continue;
+        }
+        if (templateRender.attributes.strategy === 'create') {
+            await createUsingTemplateRender(templateRender, targetPath);
+        }
+        if (templateRender.attributes.strategy === 'ensure') {
+            let to = path.join(targetPath, templateRender.attributes.to);
+            let doesToExist = await fs.pathExists(to);
+            if (!doesToExist) {
                 await createUsingTemplateRender(templateRender, targetPath);
             }
         }
     }
+    // third, we apply strategies that change files
     for (let templateRender of templateRenders){
         let strategy = typeof templateRender.attributes.strategy === 'string' ? templateRender.attributes.strategy : templateRender.attributes.strategy[0];
         if (ignoreStrategies.includes(strategy)) {
@@ -50,7 +71,16 @@ export async function applyTemplateRenders({ templateRenders, path: targetPath,
             let to = path.join(targetPath, templateRender.attributes.to);
             let doesToExist = await fs.pathExists(to);
             if (!doesToExist) {
-                throw new Error(`File "${to}" doesn't exist!`);
+                throw new CarsonTemplateError('STRATEGY_MISSING_FILE', {
+                    messageParameters: [
+                        templateRender.attributes.strategy,
+                        templateRender.template.path,
+                        to
+                    ],
+                    data: {
+                        path: to
+                    }
+                });
             }
         }
     }

package/dist/template/applyTemplateRenders.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/template/applyTemplateRenders.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport path from 'node:path';\nimport prettier from 'prettier';\n\nimport {\n  createUsingTemplateRender,\n  deleteUsingTemplateRender,\n  insertUsingTemplateRender,\n  loadTemplateRenderSnapshots,\n  mergeUsingTemplateRender,\n  overwriteUsingTemplateRender,\n  saveTemplateRenderSnapshots,\n  uninsertUsingTemplateRender,\n  unmergeUsingTemplateRender,\n} from './internals.js';\nimport {type TemplateRenders} from './TemplateRenders.js';\nimport {CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME} from '../constants.js';\n\nexport type ApplyTemplateRendersOptions = {\n  templateRenders: TemplateRenders;\n  path: string;\n  ignoreStrategies: string[];\n};\n\nexport async function applyTemplateRenders({\n  templateRenders,\n  path: targetPath,\n  ignoreStrategies,\n}: ApplyTemplateRendersOptions) {\n  // we need to clear Prettier cache, because we are changing file system\n  prettier.clearConfigCache();\n\n  let templateRenderSnapshotsPath = path.join(\n    targetPath,\n    CARSON_CONFIG_DIRECTORY,\n    SNAPSHOTS_FILENAME,\n  );\n\n  if (await fs.pathExists(templateRenderSnapshotsPath)) {\n    let templateRenderSnapshots = await loadTemplateRenderSnapshots(templateRenderSnapshotsPath);\n\n    for (let templateRenderSnapshot of templateRenderSnapshots) {\n      let strategy =\n        typeof templateRenderSnapshot.attributes.strategy === 'string'\n          ? templateRenderSnapshot.attributes.strategy\n          : templateRenderSnapshot.attributes.strategy[0];\n\n      if (ignoreStrategies.includes(strategy)) {\n        continue;\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'overwrite') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'merge') {\n        await unmergeUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy[0] === 'insert') {\n        await uninsertUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n    }\n  }\n\n  if (!ignoreStrategies.includes('create')) {\n    for (let templateRender of templateRenders) {\n      if (templateRender.attributes.strategy === 'create') {\n        await createUsingTemplateRender(templateRender, targetPath);\n      }\n    }\n  }\n\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'overwrite') {\n      await overwriteUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'merge') {\n      await mergeUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy[0] === 'insert') {\n      await insertUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'check') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        throw new Error(`File \"${to}\" doesn't exist!`);\n      }\n    }\n  }\n\n  await saveTemplateRenderSnapshots(templateRenders, templateRenderSnapshotsPath);\n}\n"],"names":["fs","path","prettier","createUsingTemplateRender","deleteUsingTemplateRender","insertUsingTemplateRender","loadTemplateRenderSnapshots","mergeUsingTemplateRender","overwriteUsingTemplateRender","saveTemplateRenderSnapshots","uninsertUsingTemplateRender","unmergeUsingTemplateRender","CARSON_CONFIG_DIRECTORY","SNAPSHOTS_FILENAME","applyTemplateRenders","templateRenders","targetPath","ignoreStrategies","clearConfigCache","templateRenderSnapshotsPath","join","pathExists","templateRenderSnapshots","templateRenderSnapshot","strategy","attributes","includes","templateRender","to","doesToExist","Error"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAC7B,OAAOC,cAAc,WAAW;AAEhC,SACEC,yBAAyB,EACzBC,yBAAyB,EACzBC,yBAAyB,EACzBC,2BAA2B,EAC3BC,wBAAwB,EACxBC,4BAA4B,EAC5BC,2BAA2B,EAC3BC,2BAA2B,EAC3BC,0BAA0B,QACrB,iBAAiB;AAExB,SAAQC,uBAAuB,EAAEC,kBAAkB,QAAO,kBAAkB;AAQ5E,OAAO,eAAeC,qBAAqB,EACzCC,eAAe,EACfd,MAAMe,UAAU,EAChBC,gBAAgB,EACY;IAC5B,uEAAuE;IACvEf,SAASgB,gBAAgB;IAEzB,IAAIC,8BAA8BlB,KAAKmB,IAAI,CACzCJ,YACAJ,yBACAC;IAGF,IAAI,MAAMb,GAAGqB,UAAU,CAACF,8BAA8B;QACpD,IAAIG,0BAA0B,MAAMhB,4BAA4Ba;QAEhE,KAAK,IAAII,0BAA0BD,wBAAyB;YAC1D,IAAIE,WACF,OAAOD,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,WAClDD,uBAAuBE,UAAU,CAACD,QAAQ,GAC1CD,uBAAuBE,UAAU,CAACD,QAAQ,CAAC,EAAE;YAEnD,IAAIP,iBAAiBS,QAAQ,CAACF,WAAW;gBACvC;YACF;YAEA,IAAID,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,aAAa;gBAC9D,MAAMpB,0BAA0BmB,wBAAwBP;YAC1D;YAEA,IAAIO,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,SAAS;gBAC1D,MAAMb,2BAA2BY,wBAAwBP;YAC3D;YAEA,IAAIO,uBAAuBE,UAAU,CAACD,QAAQ,CAAC,EAAE,KAAK,UAAU;gBAC9D,MAAMd,4BAA4Ba,wBAAwBP;YAC5D;QACF;IACF;IAEA,IAAI,CAACC,iBAAiBS,QAAQ,CAAC,WAAW;QACxC,KAAK,IAAIC,kBAAkBZ,gBAAiB;YAC1C,IAAIY,eAAeF,UAAU,CAACD,QAAQ,KAAK,UAAU;gBACnD,MAAMrB,0BAA0BwB,gBAAgBX;YAClD;QACF;IACF;IAEA,KAAK,IAAIW,kBAAkBZ,gBAAiB;QAC1C,IAAIS,WACF,OAAOG,eAAeF,UAAU,CAACD,QAAQ,KAAK,WAC1CG,eAAeF,UAAU,CAACD,QAAQ,GAClCG,eAAeF,UAAU,CAACD,QAAQ,CAAC,EAAE;QAE3C,IAAIP,iBAAiBS,QAAQ,CAACF,WAAW;YACvC;QACF;QAEA,IAAIG,eAAeF,UAAU,CAACD,QAAQ,KAAK,aAAa;YACtD,MAAMhB,6BAA6BmB,gBAAgBX;QACrD;QAEA,IAAIW,eAAeF,UAAU,CAACD,QAAQ,KAAK,SAAS;YAClD,MAAMjB,yBAAyBoB,gBAAgBX;QACjD;QAEA,IAAIW,eAAeF,UAAU,CAACD,QAAQ,CAAC,EAAE,KAAK,UAAU;YACtD,MAAMnB,0BAA0BsB,gBAAgBX;QAClD;QAEA,IAAIW,eAAeF,UAAU,CAACD,QAAQ,KAAK,SAAS;YAClD,IAAII,KAAK3B,KAAKmB,IAAI,CAACJ,YAAYW,eAAeF,UAAU,CAACG,EAAE;YAC3D,IAAIC,cAAc,MAAM7B,GAAGqB,UAAU,CAACO;YAEtC,IAAI,CAACC,aAAa;gBAChB,MAAM,IAAIC,MAAM,CAAC,MAAM,EAAEF,GAAG,gBAAgB,CAAC;YAC/C;QACF;IACF;IAEA,MAAMnB,4BAA4BM,iBAAiBI;AACrD"}
+{"version":3,"sources":["../../src/template/applyTemplateRenders.ts"],"sourcesContent":["// TODO: can this be fixed?\n/* eslint-disable complexity -- TODO */\nimport fs from 'fs-extra';\nimport path from 'node:path';\nimport prettier from 'prettier';\n\nimport {CarsonTemplateError} from './CarsonTemplateError.js';\nimport {\n  createUsingTemplateRender,\n  deleteUsingTemplateRender,\n  insertUsingTemplateRender,\n  loadTemplateRenderSnapshots,\n  mergeUsingTemplateRender,\n  overwriteUsingTemplateRender,\n  saveTemplateRenderSnapshots,\n  uninsertUsingTemplateRender,\n  unmergeUsingTemplateRender,\n} from './internals.js';\nimport {type TemplateRenders} from './TemplateRenders.js';\nimport {CARSON_CONFIG_DIRECTORY, SNAPSHOTS_FILENAME} from '../constants.js';\n\nexport type ApplyTemplateRendersOptions = {\n  templateRenders: TemplateRenders;\n  path: string;\n  ignoreStrategies: string[];\n};\n\n/**\n * Applies rendered Carson template to a specified path, i.e. creates and updates files based on the result of rendering each Carson template file.\n */\nexport async function applyTemplateRenders({\n  templateRenders,\n  path: targetPath,\n  ignoreStrategies,\n}: ApplyTemplateRendersOptions) {\n  // we need to clear Prettier cache, because we are changing file system\n  prettier.clearConfigCache();\n\n  // first, we read the existing snapshots and use them to undo previous changes\n  let templateRenderSnapshotsPath = path.join(\n    targetPath,\n    CARSON_CONFIG_DIRECTORY,\n    SNAPSHOTS_FILENAME,\n  );\n\n  if (await fs.pathExists(templateRenderSnapshotsPath)) {\n    let templateRenderSnapshots = await loadTemplateRenderSnapshots(templateRenderSnapshotsPath);\n\n    for (let templateRenderSnapshot of templateRenderSnapshots) {\n      let strategy =\n        typeof templateRenderSnapshot.attributes.strategy === 'string'\n          ? templateRenderSnapshot.attributes.strategy\n          : templateRenderSnapshot.attributes.strategy[0];\n\n      if (ignoreStrategies.includes(strategy)) {\n        continue;\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'ensure') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath, {\n          onlyDeleteWhenContentsMatch: true,\n        });\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'overwrite') {\n        await deleteUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy === 'merge') {\n        await unmergeUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n\n      if (templateRenderSnapshot.attributes.strategy[0] === 'insert') {\n        await uninsertUsingTemplateRender(templateRenderSnapshot, targetPath);\n      }\n    }\n  }\n\n  // second, we apply strategies that create files\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'create') {\n      await createUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'ensure') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        await createUsingTemplateRender(templateRender, targetPath);\n      }\n    }\n  }\n\n  // third, we apply strategies that change files\n  for (let templateRender of templateRenders) {\n    let strategy =\n      typeof templateRender.attributes.strategy === 'string'\n        ? templateRender.attributes.strategy\n        : templateRender.attributes.strategy[0];\n\n    if (ignoreStrategies.includes(strategy)) {\n      continue;\n    }\n\n    if (templateRender.attributes.strategy === 'overwrite') {\n      await overwriteUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'merge') {\n      await mergeUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy[0] === 'insert') {\n      await insertUsingTemplateRender(templateRender, targetPath);\n    }\n\n    if (templateRender.attributes.strategy === 'check') {\n      let to = path.join(targetPath, templateRender.attributes.to);\n      let doesToExist = await fs.pathExists(to);\n\n      if (!doesToExist) {\n        throw new CarsonTemplateError('STRATEGY_MISSING_FILE', {\n          messageParameters: [templateRender.attributes.strategy, templateRender.template.path, to],\n          data: {\n            path: to,\n          },\n        });\n      }\n    }\n  }\n\n  await saveTemplateRenderSnapshots(templateRenders, templateRenderSnapshotsPath);\n}\n"],"names":["fs","path","prettier","CarsonTemplateError","createUsingTemplateRender","deleteUsingTemplateRender","insertUsingTemplateRender","loadTemplateRenderSnapshots","mergeUsingTemplateRender","overwriteUsingTemplateRender","saveTemplateRenderSnapshots","uninsertUsingTemplateRender","unmergeUsingTemplateRender","CARSON_CONFIG_DIRECTORY","SNAPSHOTS_FILENAME","applyTemplateRenders","templateRenders","targetPath","ignoreStrategies","clearConfigCache","templateRenderSnapshotsPath","join","pathExists","templateRenderSnapshots","templateRenderSnapshot","strategy","attributes","includes","onlyDeleteWhenContentsMatch","templateRender","to","doesToExist","messageParameters","template","data"],"mappings":"AAAA,2BAA2B;AAC3B,qCAAqC,GACrC,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAC7B,OAAOC,cAAc,WAAW;AAEhC,SAAQC,mBAAmB,QAAO,2BAA2B;AAC7D,SACEC,yBAAyB,EACzBC,yBAAyB,EACzBC,yBAAyB,EACzBC,2BAA2B,EAC3BC,wBAAwB,EACxBC,4BAA4B,EAC5BC,2BAA2B,EAC3BC,2BAA2B,EAC3BC,0BAA0B,QACrB,iBAAiB;AAExB,SAAQC,uBAAuB,EAAEC,kBAAkB,QAAO,kBAAkB;AAQ5E;;CAEC,GACD,OAAO,eAAeC,qBAAqB,EACzCC,eAAe,EACff,MAAMgB,UAAU,EAChBC,gBAAgB,EACY;IAC5B,uEAAuE;IACvEhB,SAASiB,gBAAgB;IAEzB,8EAA8E;IAC9E,IAAIC,8BAA8BnB,KAAKoB,IAAI,CACzCJ,YACAJ,yBACAC;IAGF,IAAI,MAAMd,GAAGsB,UAAU,CAACF,8BAA8B;QACpD,IAAIG,0BAA0B,MAAMhB,4BAA4Ba;QAEhE,KAAK,IAAII,0BAA0BD,wBAAyB;YAC1D,IAAIE,WACF,OAAOD,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,WAClDD,uBAAuBE,UAAU,CAACD,QAAQ,GAC1CD,uBAAuBE,UAAU,CAACD,QAAQ,CAAC,EAAE;YAEnD,IAAIP,iBAAiBS,QAAQ,CAACF,WAAW;gBACvC;YACF;YAEA,IAAID,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,UAAU;gBAC3D,MAAMpB,0BAA0BmB,wBAAwBP,YAAY;oBAClEW,6BAA6B;gBAC/B;YACF;YAEA,IAAIJ,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,aAAa;gBAC9D,MAAMpB,0BAA0BmB,wBAAwBP;YAC1D;YAEA,IAAIO,uBAAuBE,UAAU,CAACD,QAAQ,KAAK,SAAS;gBAC1D,MAAMb,2BAA2BY,wBAAwBP;YAC3D;YAEA,IAAIO,uBAAuBE,UAAU,CAACD,QAAQ,CAAC,EAAE,KAAK,UAAU;gBAC9D,MAAMd,4BAA4Ba,wBAAwBP;YAC5D;QACF;IACF;IAEA,gDAAgD;IAChD,KAAK,IAAIY,kBAAkBb,gBAAiB;QAC1C,IAAIS,WACF,OAAOI,eAAeH,UAAU,CAACD,QAAQ,KAAK,WAC1CI,eAAeH,UAAU,CAACD,QAAQ,GAClCI,eAAeH,UAAU,CAACD,QAAQ,CAAC,EAAE;QAE3C,IAAIP,iBAAiBS,QAAQ,CAACF,WAAW;YACvC;QACF;QAEA,IAAII,eAAeH,UAAU,CAACD,QAAQ,KAAK,UAAU;YACnD,MAAMrB,0BAA0ByB,gBAAgBZ;QAClD;QAEA,IAAIY,eAAeH,UAAU,CAACD,QAAQ,KAAK,UAAU;YACnD,IAAIK,KAAK7B,KAAKoB,IAAI,CAACJ,YAAYY,eAAeH,UAAU,CAACI,EAAE;YAC3D,IAAIC,cAAc,MAAM/B,GAAGsB,UAAU,CAACQ;YAEtC,IAAI,CAACC,aAAa;gBAChB,MAAM3B,0BAA0ByB,gBAAgBZ;YAClD;QACF;IACF;IAEA,+CAA+C;IAC/C,KAAK,IAAIY,kBAAkBb,gBAAiB;QAC1C,IAAIS,WACF,OAAOI,eAAeH,UAAU,CAACD,QAAQ,KAAK,WAC1CI,eAAeH,UAAU,CAACD,QAAQ,GAClCI,eAAeH,UAAU,CAACD,QAAQ,CAAC,EAAE;QAE3C,IAAIP,iBAAiBS,QAAQ,CAACF,WAAW;YACvC;QACF;QAEA,IAAII,eAAeH,UAAU,CAACD,QAAQ,KAAK,aAAa;YACtD,MAAMhB,6BAA6BoB,gBAAgBZ;QACrD;QAEA,IAAIY,eAAeH,UAAU,CAACD,QAAQ,KAAK,SAAS;YAClD,MAAMjB,yBAAyBqB,gBAAgBZ;QACjD;QAEA,IAAIY,eAAeH,UAAU,CAACD,QAAQ,CAAC,EAAE,KAAK,UAAU;YACtD,MAAMnB,0BAA0BuB,gBAAgBZ;QAClD;QAEA,IAAIY,eAAeH,UAAU,CAACD,QAAQ,KAAK,SAAS;YAClD,IAAIK,KAAK7B,KAAKoB,IAAI,CAACJ,YAAYY,eAAeH,UAAU,CAACI,EAAE;YAC3D,IAAIC,cAAc,MAAM/B,GAAGsB,UAAU,CAACQ;YAEtC,IAAI,CAACC,aAAa;gBAChB,MAAM,IAAI5B,oBAAoB,yBAAyB;oBACrD6B,mBAAmB;wBAACH,eAAeH,UAAU,CAACD,QAAQ;wBAAEI,eAAeI,QAAQ,CAAChC,IAAI;wBAAE6B;qBAAG;oBACzFI,MAAM;wBACJjC,MAAM6B;oBACR;gBACF;YACF;QACF;IACF;IAEA,MAAMpB,4BAA4BM,iBAAiBI;AACrD"}

package/dist/template/internals/TemplateRenderSnapshot.d.ts

@@ -2,24 +2,37 @@ import { z } from 'zod';
 export declare const templateRenderSnapshotSchema: z.ZodObject<{
     attributes: z.ZodObject<{
         to: z.ZodString;
-        strategy: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"overwrite">, z.ZodLiteral<"merge">, z.ZodLiteral<"check">, z.ZodTuple<[z.ZodLiteral<"insert">, z.ZodString], null>]>;
+        strategy: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"ensure">, z.ZodLiteral<"overwrite">, z.ZodLiteral<"merge">, z.ZodLiteral<"check">, z.ZodTuple<[z.ZodLiteral<"insert">, z.ZodString], null>]>;
     }, "strict", z.ZodTypeAny, {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     }, {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     }>;
     content: z.ZodString;
+    template: z.ZodObject<{
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>;
 }, "strict", z.ZodTypeAny, {
+    template: {
+        path: string;
+    };
     attributes: {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     };
     content: string;
 }, {
+    template: {
+        path: string;
+    };
     attributes: {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     };
     content: string;

package/dist/template/internals/TemplateRenderSnapshot.js

@@ -5,7 +5,10 @@ export const templateRenderSnapshotSchema = z.object({
     attributes: baseTemplateAttributesSchema.pick({
         to: true
     }).merge(templateAttributesSchema),
-    content: z.string()
+    content: z.string(),
+    template: z.object({
+        path: z.string()
+    }).strict()
 }).strict();
 
 //# sourceMappingURL=TemplateRenderSnapshot.js.map

package/dist/template/internals/TemplateRenderSnapshot.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/TemplateRenderSnapshot.ts"],"sourcesContent":["import {templateAttributesSchema as baseTemplateAttributesSchema} from '@jakubmazanec/template';\nimport {z} from 'zod';\n\nimport {templateAttributesSchema} from '../TemplateAttributes.js';\n\nexport const templateRenderSnapshotSchema = z\n  .object({\n    attributes: baseTemplateAttributesSchema.pick({to: true}).merge(templateAttributesSchema),\n    content: z.string(),\n  })\n  .strict();\n\nexport type TemplateRenderSnapshot = z.infer<typeof templateRenderSnapshotSchema>;\n"],"names":["templateAttributesSchema","baseTemplateAttributesSchema","z","templateRenderSnapshotSchema","object","attributes","pick","to","merge","content","string","strict"],"mappings":"AAAA,SAAQA,4BAA4BC,4BAA4B,QAAO,yBAAyB;AAChG,SAAQC,CAAC,QAAO,MAAM;AAEtB,SAAQF,wBAAwB,QAAO,2BAA2B;AAElE,OAAO,MAAMG,+BAA+BD,EACzCE,MAAM,CAAC;IACNC,YAAYJ,6BAA6BK,IAAI,CAAC;QAACC,IAAI;IAAI,GAAGC,KAAK,CAACR;IAChES,SAASP,EAAEQ,MAAM;AACnB,GACCC,MAAM,GAAG"}
+{"version":3,"sources":["../../../src/template/internals/TemplateRenderSnapshot.ts"],"sourcesContent":["import {templateAttributesSchema as baseTemplateAttributesSchema} from '@jakubmazanec/template';\nimport {z} from 'zod';\n\nimport {templateAttributesSchema} from '../TemplateAttributes.js';\n\nexport const templateRenderSnapshotSchema = z\n  .object({\n    attributes: baseTemplateAttributesSchema.pick({to: true}).merge(templateAttributesSchema),\n    content: z.string(),\n    template: z\n      .object({\n        path: z.string(),\n      })\n      .strict(),\n  })\n  .strict();\n\nexport type TemplateRenderSnapshot = z.infer<typeof templateRenderSnapshotSchema>;\n"],"names":["templateAttributesSchema","baseTemplateAttributesSchema","z","templateRenderSnapshotSchema","object","attributes","pick","to","merge","content","string","template","path","strict"],"mappings":"AAAA,SAAQA,4BAA4BC,4BAA4B,QAAO,yBAAyB;AAChG,SAAQC,CAAC,QAAO,MAAM;AAEtB,SAAQF,wBAAwB,QAAO,2BAA2B;AAElE,OAAO,MAAMG,+BAA+BD,EACzCE,MAAM,CAAC;IACNC,YAAYJ,6BAA6BK,IAAI,CAAC;QAACC,IAAI;IAAI,GAAGC,KAAK,CAACR;IAChES,SAASP,EAAEQ,MAAM;IACjBC,UAAUT,EACPE,MAAM,CAAC;QACNQ,MAAMV,EAAEQ,MAAM;IAChB,GACCG,MAAM;AACX,GACCA,MAAM,GAAG"}

package/dist/template/internals/TemplateRenderSnapshots.d.ts

@@ -2,24 +2,37 @@ import { type z } from 'zod';
 export declare const templateRenderSnapshotsSchema: z.ZodArray<z.ZodObject<{
     attributes: z.ZodObject<{
         to: z.ZodString;
-        strategy: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"overwrite">, z.ZodLiteral<"merge">, z.ZodLiteral<"check">, z.ZodTuple<[z.ZodLiteral<"insert">, z.ZodString], null>]>;
+        strategy: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"ensure">, z.ZodLiteral<"overwrite">, z.ZodLiteral<"merge">, z.ZodLiteral<"check">, z.ZodTuple<[z.ZodLiteral<"insert">, z.ZodString], null>]>;
     }, "strict", z.ZodTypeAny, {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     }, {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     }>;
     content: z.ZodString;
+    template: z.ZodObject<{
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>;
 }, "strict", z.ZodTypeAny, {
+    template: {
+        path: string;
+    };
     attributes: {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     };
     content: string;
 }, {
+    template: {
+        path: string;
+    };
     attributes: {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     };
     content: string;

package/dist/template/internals/deleteUsingTemplateRender.d.ts

@@ -1,3 +1,6 @@
 import { type TemplateRenderSnapshot } from './TemplateRenderSnapshot.js';
 import { type TemplateRender } from '../TemplateRender.js';
-export declare function deleteUsingTemplateRender(templateRender: TemplateRender | TemplateRenderSnapshot, basePath: string): Promise<void>;
+export type DeleteUsingTemplateRenderOptions = {
+    onlyDeleteWhenContentsMatch?: boolean;
+};
+export declare function deleteUsingTemplateRender(templateRender: TemplateRender | TemplateRenderSnapshot, basePath: string, options?: DeleteUsingTemplateRenderOptions): Promise<void>;

package/dist/template/internals/deleteUsingTemplateRender.js

@@ -1,10 +1,23 @@
 import fs from 'fs-extra';
 import path from 'node:path';
-export async function deleteUsingTemplateRender(templateRender, basePath) {
+import { prettify } from './prettify.js';
+export async function deleteUsingTemplateRender(templateRender, basePath, options) {
+    var _options;
     let to = path.join(basePath, templateRender.attributes.to);
-    if (await fs.pathExists(to)) {
-        await fs.rm(to);
+    if (!await fs.pathExists(to)) {
+        return;
     }
+    if ((_options = options) === null || _options === void 0 ? void 0 : _options.onlyDeleteWhenContentsMatch) {
+        let existingContent = await fs.readFile(to, {
+            encoding: 'utf8'
+        });
+        let newContent = await prettify(templateRender.content, to);
+        if (existingContent.trim() === newContent.trim()) {
+            await fs.rm(to);
+        }
+        return;
+    }
+    await fs.rm(to);
 }
 
 //# sourceMappingURL=deleteUsingTemplateRender.js.map

package/dist/template/internals/deleteUsingTemplateRender.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/deleteUsingTemplateRender.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function deleteUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n\n  if (await fs.pathExists(to)) {\n    await fs.rm(to);\n  }\n}\n"],"names":["fs","path","deleteUsingTemplateRender","templateRender","basePath","to","join","attributes","pathExists","rm"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAK7B,OAAO,eAAeC,0BACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKJ,KAAKK,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IAEzD,IAAI,MAAML,GAAGQ,UAAU,CAACH,KAAK;QAC3B,MAAML,GAAGS,EAAE,CAACJ;IACd;AACF"}
+{"version":3,"sources":["../../../src/template/internals/deleteUsingTemplateRender.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport type DeleteUsingTemplateRenderOptions = {\n  onlyDeleteWhenContentsMatch?: boolean;\n};\n\nexport async function deleteUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n  options?: DeleteUsingTemplateRenderOptions,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n\n  if (!(await fs.pathExists(to))) {\n    return;\n  }\n\n  if (options?.onlyDeleteWhenContentsMatch) {\n    let existingContent = await fs.readFile(to, {encoding: 'utf8'});\n    let newContent = await prettify(templateRender.content, to);\n\n    if (existingContent.trim() === newContent.trim()) {\n      await fs.rm(to);\n    }\n\n    return;\n  }\n\n  await fs.rm(to);\n}\n"],"names":["fs","path","prettify","deleteUsingTemplateRender","templateRender","basePath","options","to","join","attributes","pathExists","onlyDeleteWhenContentsMatch","existingContent","readFile","encoding","newContent","content","trim","rm"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAE7B,SAAQC,QAAQ,QAAO,gBAAgB;AAQvC,OAAO,eAAeC,0BACpBC,cAAuD,EACvDC,QAAgB,EAChBC,OAA0C;QAQtCA;IANJ,IAAIC,KAAKN,KAAKO,IAAI,CAACH,UAAUD,eAAeK,UAAU,CAACF,EAAE;IAEzD,IAAI,CAAE,MAAMP,GAAGU,UAAU,CAACH,KAAM;QAC9B;IACF;IAEA,KAAID,WAAAA,qBAAAA,+BAAAA,SAASK,2BAA2B,EAAE;QACxC,IAAIC,kBAAkB,MAAMZ,GAAGa,QAAQ,CAACN,IAAI;YAACO,UAAU;QAAM;QAC7D,IAAIC,aAAa,MAAMb,SAASE,eAAeY,OAAO,EAAET;QAExD,IAAIK,gBAAgBK,IAAI,OAAOF,WAAWE,IAAI,IAAI;YAChD,MAAMjB,GAAGkB,EAAE,CAACX;QACd;QAEA;IACF;IAEA,MAAMP,GAAGkB,EAAE,CAACX;AACd"}

package/dist/template/internals/insertUsingTemplateRender.js

@@ -2,6 +2,7 @@ import fs from 'fs-extra';
 import _ from 'lodash';
 import path from 'node:path';
 import { prettify } from './prettify.js';
+import { CarsonTemplateError } from '../CarsonTemplateError.js';
 export async function insertUsingTemplateRender(templateRender, basePath) {
     let to = path.join(basePath, templateRender.attributes.to);
     let extension = path.extname(to);
@@ -23,7 +24,16 @@ export async function insertUsingTemplateRender(templateRender, basePath) {
             }
         default:
             {
-                throw new Error(`File extension "${extension}" is not supported!`);
+                throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {
+                    messageParameters: [
+                        templateRender.attributes.strategy,
+                        templateRender.template.path,
+                        extension
+                    ],
+                    data: {
+                        path: templateRender.template.path
+                    }
+                });
             }
     }
 }

package/dist/template/internals/insertUsingTemplateRender.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/insertUsingTemplateRender.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport _ from 'lodash';\nimport path from 'node:path';\n\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function insertUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.md': {\n      if (await fs.pathExists(to)) {\n        let targetFile = await fs.readFile(to, {encoding: 'utf8'});\n        let newContent = `<!-- ${templateRender.attributes.strategy[1]} -->${templateRender.content}<!-- ${templateRender.attributes.strategy[1]} -->`;\n        let oldContentRegexp = new RegExp(\n          `<!--\\\\s*${_.escapeRegExp(\n            templateRender.attributes.strategy[1],\n          )}\\\\s-->[\\\\s\\\\S]*<!--\\\\s*${_.escapeRegExp(templateRender.attributes.strategy[1])}\\\\s-->`,\n          'u',\n        );\n        let newFile = targetFile.replace(oldContentRegexp, newContent);\n\n        await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n      }\n\n      break;\n    }\n\n    default: {\n      throw new Error(`File extension \"${extension}\" is not supported!`);\n    }\n  }\n}\n"],"names":["fs","_","path","prettify","insertUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","pathExists","targetFile","readFile","encoding","newContent","strategy","content","oldContentRegexp","RegExp","escapeRegExp","newFile","replace","writeFile","Error"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,OAAO,SAAS;AACvB,OAAOC,UAAU,YAAY;AAE7B,SAAQC,QAAQ,QAAO,gBAAgB;AAIvC,OAAO,eAAeC,0BACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKL,KAAKM,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYR,KAAKS,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAO;gBACV,IAAI,MAAMV,GAAGY,UAAU,CAACL,KAAK;oBAC3B,IAAIM,aAAa,MAAMb,GAAGc,QAAQ,CAACP,IAAI;wBAACQ,UAAU;oBAAM;oBACxD,IAAIC,aAAa,CAAC,KAAK,EAAEX,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAEZ,eAAea,OAAO,CAAC,KAAK,EAAEb,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC;oBAC9I,IAAIE,mBAAmB,IAAIC,OACzB,CAAC,QAAQ,EAAEnB,EAAEoB,YAAY,CACvBhB,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,EACrC,uBAAuB,EAAEhB,EAAEoB,YAAY,CAAChB,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,EACxF;oBAEF,IAAIK,UAAUT,WAAWU,OAAO,CAACJ,kBAAkBH;oBAEnD,MAAMhB,GAAGwB,SAAS,CAACjB,IAAI,MAAMJ,SAASmB,SAASf,KAAK;wBAACQ,UAAU;oBAAM;gBACvE;gBAEA;YACF;QAEA;YAAS;gBACP,MAAM,IAAIU,MAAM,CAAC,gBAAgB,EAAEf,UAAU,mBAAmB,CAAC;YACnE;IACF;AACF"}
+{"version":3,"sources":["../../../src/template/internals/insertUsingTemplateRender.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport _ from 'lodash';\nimport path from 'node:path';\n\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {CarsonTemplateError} from '../CarsonTemplateError.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function insertUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.md': {\n      if (await fs.pathExists(to)) {\n        let targetFile = await fs.readFile(to, {encoding: 'utf8'});\n        let newContent = `<!-- ${templateRender.attributes.strategy[1]} -->${templateRender.content}<!-- ${templateRender.attributes.strategy[1]} -->`;\n        let oldContentRegexp = new RegExp(\n          `<!--\\\\s*${_.escapeRegExp(\n            templateRender.attributes.strategy[1],\n          )}\\\\s-->[\\\\s\\\\S]*<!--\\\\s*${_.escapeRegExp(templateRender.attributes.strategy[1])}\\\\s-->`,\n          'u',\n        );\n        let newFile = targetFile.replace(oldContentRegexp, newContent);\n\n        await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n      }\n\n      break;\n    }\n\n    default: {\n      throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {\n        messageParameters: [\n          templateRender.attributes.strategy,\n          templateRender.template.path,\n          extension,\n        ],\n        data: {\n          path: templateRender.template.path,\n        },\n      });\n    }\n  }\n}\n"],"names":["fs","_","path","prettify","CarsonTemplateError","insertUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","pathExists","targetFile","readFile","encoding","newContent","strategy","content","oldContentRegexp","RegExp","escapeRegExp","newFile","replace","writeFile","messageParameters","template","data"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,OAAO,SAAS;AACvB,OAAOC,UAAU,YAAY;AAE7B,SAAQC,QAAQ,QAAO,gBAAgB;AAEvC,SAAQC,mBAAmB,QAAO,4BAA4B;AAG9D,OAAO,eAAeC,0BACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKN,KAAKO,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYT,KAAKU,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAO;gBACV,IAAI,MAAMX,GAAGa,UAAU,CAACL,KAAK;oBAC3B,IAAIM,aAAa,MAAMd,GAAGe,QAAQ,CAACP,IAAI;wBAACQ,UAAU;oBAAM;oBACxD,IAAIC,aAAa,CAAC,KAAK,EAAEX,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAEZ,eAAea,OAAO,CAAC,KAAK,EAAEb,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC;oBAC9I,IAAIE,mBAAmB,IAAIC,OACzB,CAAC,QAAQ,EAAEpB,EAAEqB,YAAY,CACvBhB,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,EACrC,uBAAuB,EAAEjB,EAAEqB,YAAY,CAAChB,eAAeI,UAAU,CAACQ,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,EACxF;oBAEF,IAAIK,UAAUT,WAAWU,OAAO,CAACJ,kBAAkBH;oBAEnD,MAAMjB,GAAGyB,SAAS,CAACjB,IAAI,MAAML,SAASoB,SAASf,KAAK;wBAACQ,UAAU;oBAAM;gBACvE;gBAEA;YACF;QAEA;YAAS;gBACP,MAAM,IAAIZ,oBAAoB,kCAAkC;oBAC9DsB,mBAAmB;wBACjBpB,eAAeI,UAAU,CAACQ,QAAQ;wBAClCZ,eAAeqB,QAAQ,CAACzB,IAAI;wBAC5BS;qBACD;oBACDiB,MAAM;wBACJ1B,MAAMI,eAAeqB,QAAQ,CAACzB,IAAI;oBACpC;gBACF;YACF;IACF;AACF"}

package/dist/template/internals/loadTemplateRenderSnapshots.d.ts

@@ -1,6 +1,9 @@
 export declare function loadTemplateRenderSnapshots(templateRenderSnapshotsPath: string): Promise<{
+    template: {
+        path: string;
+    };
     attributes: {
-        strategy: ("create" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
+        strategy: ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string]) & ("create" | "ensure" | "overwrite" | "merge" | "check" | ["insert", string] | undefined);
         to: string;
     };
     content: string;

package/dist/template/internals/mergeUsingTemplateRender.js

@@ -4,6 +4,7 @@ import path from 'node:path';
 import yaml from 'yaml';
 import { merge } from './merge.js';
 import { prettify } from './prettify.js';
+import { CarsonTemplateError } from '../CarsonTemplateError.js';
 export async function mergeUsingTemplateRender(templateRender, basePath) {
     let to = path.join(basePath, templateRender.attributes.to);
     let extension = path.extname(to);
@@ -32,7 +33,16 @@ export async function mergeUsingTemplateRender(templateRender, basePath) {
             }
         default:
             {
-                throw new Error(`File extension "${extension}" is not supported!`);
+                throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {
+                    messageParameters: [
+                        templateRender.attributes.strategy,
+                        templateRender.template.path,
+                        extension
+                    ],
+                    data: {
+                        path: templateRender.template.path
+                    }
+                });
             }
     }
 }

package/dist/template/internals/mergeUsingTemplateRender.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/mergeUsingTemplateRender.ts"],"sourcesContent":["import {type Json} from '@jakubmazanec/zod-utils';\nimport fs from 'fs-extra';\nimport json from 'json5';\nimport path from 'node:path';\nimport yaml from 'yaml';\n\nimport {merge} from './merge.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function mergeUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.json': {\n      let targetFile = (await fs.readJson(to)) as Json;\n      let fileToMerge = json.parse<Json>(templateRender.content);\n      let newFile = JSON.stringify(merge(targetFile, fileToMerge));\n\n      await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n\n      break;\n    }\n\n    case '.yaml': {\n      let targetFile = yaml.parse(await fs.readFile(to, {encoding: 'utf8'})) as unknown;\n      let fileToMerge = yaml.parse(templateRender.content) as unknown;\n      let newFile = yaml.stringify(merge(targetFile, fileToMerge));\n\n      await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n\n      break;\n    }\n\n    default: {\n      throw new Error(`File extension \"${extension}\" is not supported!`);\n    }\n  }\n}\n"],"names":["fs","json","path","yaml","merge","prettify","mergeUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","targetFile","readJson","fileToMerge","parse","content","newFile","JSON","stringify","writeFile","encoding","readFile","Error"],"mappings":"AACA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,QAAQ;AACzB,OAAOC,UAAU,YAAY;AAC7B,OAAOC,UAAU,OAAO;AAExB,SAAQC,KAAK,QAAO,aAAa;AACjC,SAAQC,QAAQ,QAAO,gBAAgB;AAIvC,OAAO,eAAeC,yBACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKP,KAAKQ,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYV,KAAKW,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAS;gBACZ,IAAIE,aAAc,MAAMd,GAAGe,QAAQ,CAACN;gBACpC,IAAIO,cAAcf,KAAKgB,KAAK,CAAOV,eAAeW,OAAO;gBACzD,IAAIC,UAAUC,KAAKC,SAAS,CAACjB,MAAMU,YAAYE;gBAE/C,MAAMhB,GAAGsB,SAAS,CAACb,IAAI,MAAMJ,SAASc,SAASV,KAAK;oBAACc,UAAU;gBAAM;gBAErE;YACF;QAEA,KAAK;YAAS;gBACZ,IAAIT,aAAaX,KAAKc,KAAK,CAAC,MAAMjB,GAAGwB,QAAQ,CAACf,IAAI;oBAACc,UAAU;gBAAM;gBACnE,IAAIP,cAAcb,KAAKc,KAAK,CAACV,eAAeW,OAAO;gBACnD,IAAIC,UAAUhB,KAAKkB,SAAS,CAACjB,MAAMU,YAAYE;gBAE/C,MAAMhB,GAAGsB,SAAS,CAACb,IAAI,MAAMJ,SAASc,SAASV,KAAK;oBAACc,UAAU;gBAAM;gBAErE;YACF;QAEA;YAAS;gBACP,MAAM,IAAIE,MAAM,CAAC,gBAAgB,EAAEb,UAAU,mBAAmB,CAAC;YACnE;IACF;AACF"}
+{"version":3,"sources":["../../../src/template/internals/mergeUsingTemplateRender.ts"],"sourcesContent":["import {type Json} from '@jakubmazanec/zod-utils';\nimport fs from 'fs-extra';\nimport json from 'json5';\nimport path from 'node:path';\nimport yaml from 'yaml';\n\nimport {merge} from './merge.js';\nimport {prettify} from './prettify.js';\nimport {type TemplateRenderSnapshot} from './TemplateRenderSnapshot.js';\nimport {CarsonTemplateError} from '../CarsonTemplateError.js';\nimport {type TemplateRender} from '../TemplateRender.js';\n\nexport async function mergeUsingTemplateRender(\n  templateRender: TemplateRender | TemplateRenderSnapshot,\n  basePath: string,\n) {\n  let to = path.join(basePath, templateRender.attributes.to);\n  let extension = path.extname(to);\n\n  switch (extension) {\n    case '.json': {\n      let targetFile = (await fs.readJson(to)) as Json;\n      let fileToMerge = json.parse<Json>(templateRender.content);\n      let newFile = JSON.stringify(merge(targetFile, fileToMerge));\n\n      await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n\n      break;\n    }\n\n    case '.yaml': {\n      let targetFile = yaml.parse(await fs.readFile(to, {encoding: 'utf8'})) as unknown;\n      let fileToMerge = yaml.parse(templateRender.content) as unknown;\n      let newFile = yaml.stringify(merge(targetFile, fileToMerge));\n\n      await fs.writeFile(to, await prettify(newFile, to), {encoding: 'utf8'});\n\n      break;\n    }\n\n    default: {\n      throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {\n        messageParameters: [\n          templateRender.attributes.strategy,\n          templateRender.template.path,\n          extension,\n        ],\n        data: {\n          path: templateRender.template.path,\n        },\n      });\n    }\n  }\n}\n"],"names":["fs","json","path","yaml","merge","prettify","CarsonTemplateError","mergeUsingTemplateRender","templateRender","basePath","to","join","attributes","extension","extname","targetFile","readJson","fileToMerge","parse","content","newFile","JSON","stringify","writeFile","encoding","readFile","messageParameters","strategy","template","data"],"mappings":"AACA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,QAAQ;AACzB,OAAOC,UAAU,YAAY;AAC7B,OAAOC,UAAU,OAAO;AAExB,SAAQC,KAAK,QAAO,aAAa;AACjC,SAAQC,QAAQ,QAAO,gBAAgB;AAEvC,SAAQC,mBAAmB,QAAO,4BAA4B;AAG9D,OAAO,eAAeC,yBACpBC,cAAuD,EACvDC,QAAgB;IAEhB,IAAIC,KAAKR,KAAKS,IAAI,CAACF,UAAUD,eAAeI,UAAU,CAACF,EAAE;IACzD,IAAIG,YAAYX,KAAKY,OAAO,CAACJ;IAE7B,OAAQG;QACN,KAAK;YAAS;gBACZ,IAAIE,aAAc,MAAMf,GAAGgB,QAAQ,CAACN;gBACpC,IAAIO,cAAchB,KAAKiB,KAAK,CAAOV,eAAeW,OAAO;gBACzD,IAAIC,UAAUC,KAAKC,SAAS,CAAClB,MAAMW,YAAYE;gBAE/C,MAAMjB,GAAGuB,SAAS,CAACb,IAAI,MAAML,SAASe,SAASV,KAAK;oBAACc,UAAU;gBAAM;gBAErE;YACF;QAEA,KAAK;YAAS;gBACZ,IAAIT,aAAaZ,KAAKe,KAAK,CAAC,MAAMlB,GAAGyB,QAAQ,CAACf,IAAI;oBAACc,UAAU;gBAAM;gBACnE,IAAIP,cAAcd,KAAKe,KAAK,CAACV,eAAeW,OAAO;gBACnD,IAAIC,UAAUjB,KAAKmB,SAAS,CAAClB,MAAMW,YAAYE;gBAE/C,MAAMjB,GAAGuB,SAAS,CAACb,IAAI,MAAML,SAASe,SAASV,KAAK;oBAACc,UAAU;gBAAM;gBAErE;YACF;QAEA;YAAS;gBACP,MAAM,IAAIlB,oBAAoB,kCAAkC;oBAC9DoB,mBAAmB;wBACjBlB,eAAeI,UAAU,CAACe,QAAQ;wBAClCnB,eAAeoB,QAAQ,CAAC1B,IAAI;wBAC5BW;qBACD;oBACDgB,MAAM;wBACJ3B,MAAMM,eAAeoB,QAAQ,CAAC1B,IAAI;oBACpC;gBACF;YACF;IACF;AACF"}

package/dist/template/internals/parseCarsonTemplateId.js

@@ -1,7 +1,12 @@
+import { CarsonTemplateError } from '../CarsonTemplateError.js';
 export function parseCarsonTemplateId(value) {
     let parts = value.split(':');
     if (!parts[0] || !parts[1]) {
-        throw new Error('Template id is invalid!');
+        throw new CarsonTemplateError('INVALID_CARSON_TEMPLATE_ID', {
+            messageParameters: [
+                value
+            ]
+        });
     }
     return [
         parts[0],

package/dist/template/internals/parseCarsonTemplateId.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/parseCarsonTemplateId.ts"],"sourcesContent":["export function parseCarsonTemplateId(value: string): [moduleId: string, templateName: string] {\n  let parts = value.split(':');\n\n  if (!parts[0] || !parts[1]) {\n    throw new Error('Template id is invalid!');\n  }\n\n  return [parts[0], parts[1]];\n}\n"],"names":["parseCarsonTemplateId","value","parts","split","Error"],"mappings":"AAAA,OAAO,SAASA,sBAAsBC,KAAa;IACjD,IAAIC,QAAQD,MAAME,KAAK,CAAC;IAExB,IAAI,CAACD,KAAK,CAAC,EAAE,IAAI,CAACA,KAAK,CAAC,EAAE,EAAE;QAC1B,MAAM,IAAIE,MAAM;IAClB;IAEA,OAAO;QAACF,KAAK,CAAC,EAAE;QAAEA,KAAK,CAAC,EAAE;KAAC;AAC7B"}
+{"version":3,"sources":["../../../src/template/internals/parseCarsonTemplateId.ts"],"sourcesContent":["import {CarsonTemplateError} from '../CarsonTemplateError.js';\n\nexport function parseCarsonTemplateId(value: string): [moduleId: string, templateName: string] {\n  let parts = value.split(':');\n\n  if (!parts[0] || !parts[1]) {\n    throw new CarsonTemplateError('INVALID_CARSON_TEMPLATE_ID', {\n      messageParameters: [value],\n    });\n  }\n\n  return [parts[0], parts[1]];\n}\n"],"names":["CarsonTemplateError","parseCarsonTemplateId","value","parts","split","messageParameters"],"mappings":"AAAA,SAAQA,mBAAmB,QAAO,4BAA4B;AAE9D,OAAO,SAASC,sBAAsBC,KAAa;IACjD,IAAIC,QAAQD,MAAME,KAAK,CAAC;IAExB,IAAI,CAACD,KAAK,CAAC,EAAE,IAAI,CAACA,KAAK,CAAC,EAAE,EAAE;QAC1B,MAAM,IAAIH,oBAAoB,8BAA8B;YAC1DK,mBAAmB;gBAACH;aAAM;QAC5B;IACF;IAEA,OAAO;QAACC,KAAK,CAAC,EAAE;QAAEA,KAAK,CAAC,EAAE;KAAC;AAC7B"}

package/dist/template/internals/readCarsonTemplate.js

@@ -7,6 +7,7 @@ import { parseCarsonTemplateId } from './parseCarsonTemplateId.js';
 import { resolveModule } from './resolveModule.js';
 import { TEMPLATES_PATH, TEMPLATE_CONFIG_FILENAME } from '../../constants.js';
 import { carsonTemplateConfigSchema } from '../CarsonTemplateConfig.js';
+import { CarsonTemplateError } from '../CarsonTemplateError.js';
 import { templateAttributesSchema } from '../TemplateAttributes.js';
 export async function readCarsonTemplate(templateId) {
     let [moduleId, templateName] = parseCarsonTemplateId(templateId);
@@ -33,7 +34,12 @@ export async function readCarsonTemplate(templateId) {
         }
         return carsonTemplate;
     }
-    throw new Error(`Template ${templateId} was not found in module ${moduleId}!`);
+    throw new CarsonTemplateError('CARSON_TEMPLATE_NOT_FOUND', {
+        messageParameters: [
+            templateId,
+            moduleId
+        ]
+    });
 }
 
 //# sourceMappingURL=readCarsonTemplate.js.map

package/dist/template/internals/readCarsonTemplate.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/readCarsonTemplate.ts"],"sourcesContent":["import {Template} from '@jakubmazanec/template';\nimport {readFile} from '@jakubmazanec/zod-utils';\nimport glob from 'fast-glob';\nimport fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {parseCarsonTemplateId} from './parseCarsonTemplateId.js';\nimport {resolveModule} from './resolveModule.js';\nimport {TEMPLATES_PATH, TEMPLATE_CONFIG_FILENAME} from '../../constants.js';\nimport {type CarsonTemplate} from '../CarsonTemplate.js';\nimport {carsonTemplateConfigSchema} from '../CarsonTemplateConfig.js';\nimport {templateAttributesSchema} from '../TemplateAttributes.js';\n\nexport async function readCarsonTemplate(templateId: string): Promise<CarsonTemplate> {\n  let [moduleId, templateName] = parseCarsonTemplateId(templateId);\n  let modulePath = await resolveModule(moduleId);\n  let carsonTemplatePath = path.join(modulePath, TEMPLATES_PATH, templateName);\n\n  if (await fs.pathExists(carsonTemplatePath)) {\n    let templateConfigPath = path.join(carsonTemplatePath, TEMPLATE_CONFIG_FILENAME);\n    let templateConfig = await readFile(templateConfigPath, carsonTemplateConfigSchema, {\n      throwOnZodError: true,\n    });\n    let templateFilePaths = await glob('**/*.ejs', {\n      cwd: carsonTemplatePath,\n      dot: true,\n    });\n    let carsonTemplate: CarsonTemplate = {\n      name: templateName,\n      config: templateConfig,\n      files: [],\n    };\n\n    for (let templateFilePath of templateFilePaths) {\n      carsonTemplate.files.push(\n        await Template.read(path.join(carsonTemplatePath, templateFilePath), {\n          attributesSchema: templateAttributesSchema,\n        }),\n      );\n    }\n\n    return carsonTemplate;\n  }\n\n  throw new Error(`Template ${templateId} was not found in module ${moduleId}!`);\n}\n"],"names":["Template","readFile","glob","fs","path","parseCarsonTemplateId","resolveModule","TEMPLATES_PATH","TEMPLATE_CONFIG_FILENAME","carsonTemplateConfigSchema","templateAttributesSchema","readCarsonTemplate","templateId","moduleId","templateName","modulePath","carsonTemplatePath","join","pathExists","templateConfigPath","templateConfig","throwOnZodError","templateFilePaths","cwd","dot","carsonTemplate","name","config","files","templateFilePath","push","read","attributesSchema","Error"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,yBAAyB;AAChD,SAAQC,QAAQ,QAAO,0BAA0B;AACjD,OAAOC,UAAU,YAAY;AAC7B,OAAOC,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAE7B,SAAQC,qBAAqB,QAAO,6BAA6B;AACjE,SAAQC,aAAa,QAAO,qBAAqB;AACjD,SAAQC,cAAc,EAAEC,wBAAwB,QAAO,qBAAqB;AAE5E,SAAQC,0BAA0B,QAAO,6BAA6B;AACtE,SAAQC,wBAAwB,QAAO,2BAA2B;AAElE,OAAO,eAAeC,mBAAmBC,UAAkB;IACzD,IAAI,CAACC,UAAUC,aAAa,GAAGT,sBAAsBO;IACrD,IAAIG,aAAa,MAAMT,cAAcO;IACrC,IAAIG,qBAAqBZ,KAAKa,IAAI,CAACF,YAAYR,gBAAgBO;IAE/D,IAAI,MAAMX,GAAGe,UAAU,CAACF,qBAAqB;QAC3C,IAAIG,qBAAqBf,KAAKa,IAAI,CAACD,oBAAoBR;QACvD,IAAIY,iBAAiB,MAAMnB,SAASkB,oBAAoBV,4BAA4B;YAClFY,iBAAiB;QACnB;QACA,IAAIC,oBAAoB,MAAMpB,KAAK,YAAY;YAC7CqB,KAAKP;YACLQ,KAAK;QACP;QACA,IAAIC,iBAAiC;YACnCC,MAAMZ;YACNa,QAAQP;YACRQ,OAAO,EAAE;QACX;QAEA,KAAK,IAAIC,oBAAoBP,kBAAmB;YAC9CG,eAAeG,KAAK,CAACE,IAAI,CACvB,MAAM9B,SAAS+B,IAAI,CAAC3B,KAAKa,IAAI,CAACD,oBAAoBa,mBAAmB;gBACnEG,kBAAkBtB;YACpB;QAEJ;QAEA,OAAOe;IACT;IAEA,MAAM,IAAIQ,MAAM,CAAC,SAAS,EAAErB,WAAW,yBAAyB,EAAEC,SAAS,CAAC,CAAC;AAC/E"}
+{"version":3,"sources":["../../../src/template/internals/readCarsonTemplate.ts"],"sourcesContent":["import {Template} from '@jakubmazanec/template';\nimport {readFile} from '@jakubmazanec/zod-utils';\nimport glob from 'fast-glob';\nimport fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {parseCarsonTemplateId} from './parseCarsonTemplateId.js';\nimport {resolveModule} from './resolveModule.js';\nimport {TEMPLATES_PATH, TEMPLATE_CONFIG_FILENAME} from '../../constants.js';\nimport {type CarsonTemplate} from '../CarsonTemplate.js';\nimport {carsonTemplateConfigSchema} from '../CarsonTemplateConfig.js';\nimport {CarsonTemplateError} from '../CarsonTemplateError.js';\nimport {templateAttributesSchema} from '../TemplateAttributes.js';\n\nexport async function readCarsonTemplate(templateId: string): Promise<CarsonTemplate> {\n  let [moduleId, templateName] = parseCarsonTemplateId(templateId);\n  let modulePath = await resolveModule(moduleId);\n  let carsonTemplatePath = path.join(modulePath, TEMPLATES_PATH, templateName);\n\n  if (await fs.pathExists(carsonTemplatePath)) {\n    let templateConfigPath = path.join(carsonTemplatePath, TEMPLATE_CONFIG_FILENAME);\n    let templateConfig = await readFile(templateConfigPath, carsonTemplateConfigSchema, {\n      throwOnZodError: true,\n    });\n    let templateFilePaths = await glob('**/*.ejs', {\n      cwd: carsonTemplatePath,\n      dot: true,\n    });\n    let carsonTemplate: CarsonTemplate = {\n      name: templateName,\n      config: templateConfig,\n      files: [],\n    };\n\n    for (let templateFilePath of templateFilePaths) {\n      carsonTemplate.files.push(\n        await Template.read(path.join(carsonTemplatePath, templateFilePath), {\n          attributesSchema: templateAttributesSchema,\n        }),\n      );\n    }\n\n    return carsonTemplate;\n  }\n\n  throw new CarsonTemplateError('CARSON_TEMPLATE_NOT_FOUND', {\n    messageParameters: [templateId, moduleId],\n  });\n}\n"],"names":["Template","readFile","glob","fs","path","parseCarsonTemplateId","resolveModule","TEMPLATES_PATH","TEMPLATE_CONFIG_FILENAME","carsonTemplateConfigSchema","CarsonTemplateError","templateAttributesSchema","readCarsonTemplate","templateId","moduleId","templateName","modulePath","carsonTemplatePath","join","pathExists","templateConfigPath","templateConfig","throwOnZodError","templateFilePaths","cwd","dot","carsonTemplate","name","config","files","templateFilePath","push","read","attributesSchema","messageParameters"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,yBAAyB;AAChD,SAAQC,QAAQ,QAAO,0BAA0B;AACjD,OAAOC,UAAU,YAAY;AAC7B,OAAOC,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAE7B,SAAQC,qBAAqB,QAAO,6BAA6B;AACjE,SAAQC,aAAa,QAAO,qBAAqB;AACjD,SAAQC,cAAc,EAAEC,wBAAwB,QAAO,qBAAqB;AAE5E,SAAQC,0BAA0B,QAAO,6BAA6B;AACtE,SAAQC,mBAAmB,QAAO,4BAA4B;AAC9D,SAAQC,wBAAwB,QAAO,2BAA2B;AAElE,OAAO,eAAeC,mBAAmBC,UAAkB;IACzD,IAAI,CAACC,UAAUC,aAAa,GAAGV,sBAAsBQ;IACrD,IAAIG,aAAa,MAAMV,cAAcQ;IACrC,IAAIG,qBAAqBb,KAAKc,IAAI,CAACF,YAAYT,gBAAgBQ;IAE/D,IAAI,MAAMZ,GAAGgB,UAAU,CAACF,qBAAqB;QAC3C,IAAIG,qBAAqBhB,KAAKc,IAAI,CAACD,oBAAoBT;QACvD,IAAIa,iBAAiB,MAAMpB,SAASmB,oBAAoBX,4BAA4B;YAClFa,iBAAiB;QACnB;QACA,IAAIC,oBAAoB,MAAMrB,KAAK,YAAY;YAC7CsB,KAAKP;YACLQ,KAAK;QACP;QACA,IAAIC,iBAAiC;YACnCC,MAAMZ;YACNa,QAAQP;YACRQ,OAAO,EAAE;QACX;QAEA,KAAK,IAAIC,oBAAoBP,kBAAmB;YAC9CG,eAAeG,KAAK,CAACE,IAAI,CACvB,MAAM/B,SAASgC,IAAI,CAAC5B,KAAKc,IAAI,CAACD,oBAAoBa,mBAAmB;gBACnEG,kBAAkBtB;YACpB;QAEJ;QAEA,OAAOe;IACT;IAEA,MAAM,IAAIhB,oBAAoB,6BAA6B;QACzDwB,mBAAmB;YAACrB;YAAYC;SAAS;IAC3C;AACF"}

package/dist/template/internals/saveTemplateRenderSnapshots.js

@@ -3,18 +3,18 @@ import fs from 'fs-extra';
 export async function saveTemplateRenderSnapshots(templateRenders, templateRenderSnapshotsPath) {
     let templateRendersSnapshots = [];
     for (let templateRender of templateRenders){
-        if (templateRender.attributes.strategy === 'overwrite' || templateRender.attributes.strategy === 'merge' || templateRender.attributes.strategy[0] === 'insert') {
+        if (templateRender.attributes.strategy === 'ensure' || templateRender.attributes.strategy === 'overwrite' || templateRender.attributes.strategy === 'merge' || templateRender.attributes.strategy[0] === 'insert') {
             templateRendersSnapshots.push({
                 attributes: {
                     to: templateRender.attributes.to,
                     strategy: templateRender.attributes.strategy
                 },
-                content: templateRender.content
+                content: templateRender.content,
+                template: templateRender.template
             });
         }
     }
-    let uncompressedSnapshots = JSON.stringify(templateRendersSnapshots);
-    await fs.writeFile(templateRenderSnapshotsPath, deflateSync(strToU8(uncompressedSnapshots), {
+    await fs.writeFile(templateRenderSnapshotsPath, deflateSync(strToU8(JSON.stringify(templateRendersSnapshots)), {
         level: 1,
         mem: 0
     }));

package/dist/template/internals/saveTemplateRenderSnapshots.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/template/internals/saveTemplateRenderSnapshots.ts"],"sourcesContent":["import {deflateSync, strToU8} from 'fflate';\nimport fs from 'fs-extra';\n\nimport {type TemplateRenderSnapshots} from './TemplateRenderSnapshots.js';\nimport {type TemplateRenders} from '../TemplateRenders.js';\n\nexport async function saveTemplateRenderSnapshots(\n  templateRenders: TemplateRenders,\n  templateRenderSnapshotsPath: string,\n) {\n  let templateRendersSnapshots: TemplateRenderSnapshots = [];\n\n  for (let templateRender of templateRenders) {\n    if (\n      templateRender.attributes.strategy === 'overwrite' ||\n      templateRender.attributes.strategy === 'merge' ||\n      templateRender.attributes.strategy[0] === 'insert'\n    ) {\n      templateRendersSnapshots.push({\n        attributes: {\n          to: templateRender.attributes.to,\n          strategy: templateRender.attributes.strategy,\n        },\n        content: templateRender.content,\n      });\n    }\n  }\n  let uncompressedSnapshots = JSON.stringify(templateRendersSnapshots);\n\n  await fs.writeFile(\n    templateRenderSnapshotsPath,\n    deflateSync(strToU8(uncompressedSnapshots), {level: 1, mem: 0}),\n  );\n}\n"],"names":["deflateSync","strToU8","fs","saveTemplateRenderSnapshots","templateRenders","templateRenderSnapshotsPath","templateRendersSnapshots","templateRender","attributes","strategy","push","to","content","uncompressedSnapshots","JSON","stringify","writeFile","level","mem"],"mappings":"AAAA,SAAQA,WAAW,EAAEC,OAAO,QAAO,SAAS;AAC5C,OAAOC,QAAQ,WAAW;AAK1B,OAAO,eAAeC,4BACpBC,eAAgC,EAChCC,2BAAmC;IAEnC,IAAIC,2BAAoD,EAAE;IAE1D,KAAK,IAAIC,kBAAkBH,gBAAiB;QAC1C,IACEG,eAAeC,UAAU,CAACC,QAAQ,KAAK,eACvCF,eAAeC,UAAU,CAACC,QAAQ,KAAK,WACvCF,eAAeC,UAAU,CAACC,QAAQ,CAAC,EAAE,KAAK,UAC1C;YACAH,yBAAyBI,IAAI,CAAC;gBAC5BF,YAAY;oBACVG,IAAIJ,eAAeC,UAAU,CAACG,EAAE;oBAChCF,UAAUF,eAAeC,UAAU,CAACC,QAAQ;gBAC9C;gBACAG,SAASL,eAAeK,OAAO;YACjC;QACF;IACF;IACA,IAAIC,wBAAwBC,KAAKC,SAAS,CAACT;IAE3C,MAAMJ,GAAGc,SAAS,CAChBX,6BACAL,YAAYC,QAAQY,wBAAwB;QAACI,OAAO;QAAGC,KAAK;IAAC;AAEjE"}
+{"version":3,"sources":["../../../src/template/internals/saveTemplateRenderSnapshots.ts"],"sourcesContent":["import {deflateSync, strToU8} from 'fflate';\nimport fs from 'fs-extra';\n\nimport {type TemplateRenderSnapshots} from './TemplateRenderSnapshots.js';\nimport {type TemplateRenders} from '../TemplateRenders.js';\n\nexport async function saveTemplateRenderSnapshots(\n  templateRenders: TemplateRenders,\n  templateRenderSnapshotsPath: string,\n) {\n  let templateRendersSnapshots: TemplateRenderSnapshots = [];\n\n  for (let templateRender of templateRenders) {\n    if (\n      templateRender.attributes.strategy === 'ensure' ||\n      templateRender.attributes.strategy === 'overwrite' ||\n      templateRender.attributes.strategy === 'merge' ||\n      templateRender.attributes.strategy[0] === 'insert'\n    ) {\n      templateRendersSnapshots.push({\n        attributes: {\n          to: templateRender.attributes.to,\n          strategy: templateRender.attributes.strategy,\n        },\n        content: templateRender.content,\n        template: templateRender.template,\n      });\n    }\n  }\n\n  await fs.writeFile(\n    templateRenderSnapshotsPath,\n    deflateSync(strToU8(JSON.stringify(templateRendersSnapshots)), {level: 1, mem: 0}),\n  );\n}\n"],"names":["deflateSync","strToU8","fs","saveTemplateRenderSnapshots","templateRenders","templateRenderSnapshotsPath","templateRendersSnapshots","templateRender","attributes","strategy","push","to","content","template","writeFile","JSON","stringify","level","mem"],"mappings":"AAAA,SAAQA,WAAW,EAAEC,OAAO,QAAO,SAAS;AAC5C,OAAOC,QAAQ,WAAW;AAK1B,OAAO,eAAeC,4BACpBC,eAAgC,EAChCC,2BAAmC;IAEnC,IAAIC,2BAAoD,EAAE;IAE1D,KAAK,IAAIC,kBAAkBH,gBAAiB;QAC1C,IACEG,eAAeC,UAAU,CAACC,QAAQ,KAAK,YACvCF,eAAeC,UAAU,CAACC,QAAQ,KAAK,eACvCF,eAAeC,UAAU,CAACC,QAAQ,KAAK,WACvCF,eAAeC,UAAU,CAACC,QAAQ,CAAC,EAAE,KAAK,UAC1C;YACAH,yBAAyBI,IAAI,CAAC;gBAC5BF,YAAY;oBACVG,IAAIJ,eAAeC,UAAU,CAACG,EAAE;oBAChCF,UAAUF,eAAeC,UAAU,CAACC,QAAQ;gBAC9C;gBACAG,SAASL,eAAeK,OAAO;gBAC/BC,UAAUN,eAAeM,QAAQ;YACnC;QACF;IACF;IAEA,MAAMX,GAAGY,SAAS,CAChBT,6BACAL,YAAYC,QAAQc,KAAKC,SAAS,CAACV,4BAA4B;QAACW,OAAO;QAAGC,KAAK;IAAC;AAEpF"}

package/dist/template/internals/uninsertUsingTemplateRender.js

@@ -2,6 +2,7 @@ import fs from 'fs-extra';
 import _ from 'lodash';
 import path from 'node:path';
 import { prettify } from './prettify.js';
+import { CarsonTemplateError } from '../CarsonTemplateError.js';
 export async function uninsertUsingTemplateRender(templateRender, basePath) {
     let to = path.join(basePath, templateRender.attributes.to);
     let extension = path.extname(to);
@@ -23,7 +24,16 @@ export async function uninsertUsingTemplateRender(templateRender, basePath) {
             }
         default:
             {
-                throw new Error(`File extension "${extension}" is not supported!`);
+                throw new CarsonTemplateError('STRATEGY_UNSUPPORTED_EXTENSION', {
+                    messageParameters: [
+                        templateRender.attributes.strategy,
+                        templateRender.template.path,
+                        extension
+                    ],
+                    data: {
+                        path: templateRender.template.path
+                    }
+                });
             }
     }
 }