restfuncs-transformer 1.0.0 → 1.1.0

package/index.js

@@ -1,10 +1,34 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transformerVersion = void 0;
 const AddRemoteMethodsMeta_1 = require("./AddRemoteMethodsMeta");
 const transformerUtil_1 = require("./transformerUtil");
+const fs = __importStar(require("node:fs"));
 // From: https://github.com/nonara/ts-patch/discussions/29#discussioncomment-325979
-exports.transformerVersion = { major: 1, feature: 1 };
+exports.transformerVersion = { major: 1, feature: 2 };
 /* ****************************************************************************************************************** */
 // region: Helpers
 /* ****************************************************************************************************************** */
@@ -40,18 +64,30 @@ function transformProgram(program, host, config, extras) {
     const compilerHost = getPatchedHost(host, tsInstance, compilerOptions);
     const rootFileNames = program.getRootFileNames().map(tsInstance.normalizePath);
     const transformerFactoryOOP = new transformerUtil_1.TransformerFactoryOOP(AddRemoteMethodsMeta_1.AddRemoteMethodsMeta);
+    AddRemoteMethodsMeta_1.AddRemoteMethodsMeta.squeezeDeclarationsIntoOneLine = !(config.pretty);
+    // TODO: Do we still need all this transformer stuff or can we throw that out and use a simple file vistor ? Cause we don't actually **transform** a SourceFile anymore, but just patch text content and not an AST.
     /* Transform AST */
     tsInstance.transform(
-    /* sourceFiles */ program.getSourceFiles().filter(sourceFile => rootFileNames.includes(sourceFile.fileName)), 
+    /* sourceFiles */ program.getSourceFiles().filter(sourceFile => rootFileNames.includes(sourceFile.fileName) && !sourceFile.fileName.includes("after_restfuncs-transformer")), 
     /* transformerFactoryOOP */ [transformerFactoryOOP.asFunction], compilerOptions);
     transformerFactoryOOP.transformRunsDone.forEach(transformRun => {
-        if (transformRun.astWasModified) {
+        if (transformRun.result.patches.length > 0) { // wants to make changes to the file ?
             /* Render modified files and create new SourceFiles for them to use in host's cache */
-            const { printFile } = tsInstance.createPrinter();
             const sourceFile = transformRun.sourceFile;
-            const updatedSourceFile = tsInstance.createSourceFile(sourceFile.fileName, printFile(sourceFile), sourceFile.languageVersion);
-            updatedSourceFile.version = `${sourceFile.version}_restfuncs_${exports.transformerVersion.major}.${exports.transformerVersion.feature}`;
-            compilerHost.fileCache.set(sourceFile.fileName, updatedSourceFile);
+            const sourceText = fs.readFileSync(sourceFile.fileName, { encoding: "utf8" });
+            const patchedSourceText = transformRun.result.applyPatches(sourceText);
+            if (config.debug) {
+                // Write content to file so you can better inspect it.
+                const newFileName = sourceFile.fileName.replace(/\.ts$/, ".after_restfuncs-transformer.tmp");
+                if (newFileName === sourceFile.fileName) {
+                    throw new Error("invalid file name");
+                }
+                fs.writeFileSync(newFileName, patchedSourceText, { encoding: "utf8" });
+            }
+            // Insert patchedSourceText into host's cache:
+            const newSourceFile = tsInstance.createSourceFile(sourceFile.fileName, patchedSourceText, sourceFile.languageVersion);
+            newSourceFile.version = `${sourceFile.version}_restfuncs_${exports.transformerVersion.major}.${exports.transformerVersion.feature}`;
+            compilerHost.fileCache.set(sourceFile.fileName, newSourceFile);
         }
     });
     /* Re-create Program instance */

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/index.ts

@@ -2,10 +2,11 @@ import ts, {CompilerHost, CompilerOptions, Program, SourceFile} from 'typescript
 import {PluginConfig, ProgramTransformerExtras} from "ts-patch";
 import {AddRemoteMethodsMeta} from "./AddRemoteMethodsMeta";
 import {FileTransformRun, TransformerFactoryOOP} from "./transformerUtil";
+import * as fs from "node:fs";
 
 // From: https://github.com/nonara/ts-patch/discussions/29#discussioncomment-325979
 
-export const transformerVersion = {major: 1,  feature: 1 }
+export const transformerVersion = {major: 1,  feature: 2 }
 
 /* ****************************************************************************************************************** */
 // region: Helpers
@@ -61,22 +62,37 @@ export default function transformProgram(
     const rootFileNames = program.getRootFileNames().map(tsInstance.normalizePath);
 
     const transformerFactoryOOP = new TransformerFactoryOOP(AddRemoteMethodsMeta);
+    AddRemoteMethodsMeta.squeezeDeclarationsIntoOneLine = !((config as any).pretty);
+
+    // TODO: Do we still need all this transformer stuff or can we throw that out and use a simple file vistor ? Cause we don't actually **transform** a SourceFile anymore, but just patch text content and not an AST.
 
     /* Transform AST */
     tsInstance.transform(
-        /* sourceFiles */ program.getSourceFiles().filter(sourceFile => rootFileNames.includes(sourceFile.fileName)),
+        /* sourceFiles */ program.getSourceFiles().filter(sourceFile => rootFileNames.includes(sourceFile.fileName) && !sourceFile.fileName.includes("after_restfuncs-transformer")),
         /* transformerFactoryOOP */ [ transformerFactoryOOP.asFunction ],
         compilerOptions
     )
 
     transformerFactoryOOP.transformRunsDone.forEach(transformRun => {
-        if(transformRun.astWasModified) {
+        if(transformRun.result.patches.length > 0) { // wants to make changes to the file ?
             /* Render modified files and create new SourceFiles for them to use in host's cache */
-            const {printFile} = tsInstance.createPrinter();
             const sourceFile = transformRun.sourceFile;
-            const updatedSourceFile = tsInstance.createSourceFile(sourceFile.fileName, printFile(sourceFile), sourceFile.languageVersion);
-            updatedSourceFile.version = `${sourceFile.version}_restfuncs_${transformerVersion.major}.${transformerVersion.feature}`;
-            compilerHost.fileCache.set(sourceFile.fileName, updatedSourceFile);
+            const sourceText = fs.readFileSync(sourceFile.fileName, {encoding: "utf8"});
+            const patchedSourceText = transformRun.result.applyPatches(sourceText);
+            if((config as any).debug) {
+                // Write content to file so you can better inspect it.
+                const newFileName = sourceFile.fileName.replace(/\.ts$/,".after_restfuncs-transformer.tmp");
+                if(newFileName === sourceFile.fileName) {
+                    throw new Error("invalid file name")
+                }
+                fs.writeFileSync(newFileName, patchedSourceText, {encoding: "utf8"});
+            }
+
+
+            // Insert patchedSourceText into host's cache:
+            const newSourceFile = tsInstance.createSourceFile(sourceFile.fileName, patchedSourceText, sourceFile.languageVersion);
+            newSourceFile.version = `${sourceFile.version}_restfuncs_${transformerVersion.major}.${transformerVersion.feature}`;
+            compilerHost.fileCache.set(sourceFile.fileName, newSourceFile);
         }
     })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restfuncs-transformer",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Enhances your classes with typescript-rtti, to make them usable with Restfuncs",
   "keywords": ["rpc","rest"],
   "author": "Boris Gingold <bogeee@bogitech.de>",
@@ -13,6 +13,7 @@
   "scripts": {
     "clean": "tsc --build --clean && rimraf dist LICENSE",
     "build": "tsc --build",
+    "test": "npm run build && jest --runInBand --testPathIgnorePatterns=\".*\\.ts\" --testNamePattern=\".*\"",
     "dev:playgrund": "tsx devPlayground.ts"
   },
   "exports": {
@@ -21,13 +22,16 @@
     }
   },
   "dependencies": {
-    "typescript": "5.0 || 5.1 || 5.3"
+    "typescript": "5.0 || 5.1 || 5.3",
+    "restfuncs-common": "^3.1.0"
   },
   "peerDependencies": {
     "restfuncs-server": ">=2"
   },
   "devDependencies": {
     "@types/ts-expose-internals": "npm:ts-expose-internals@5.3.3",
-    "rimraf": "=5.0.5"
+    "rimraf": "=5.0.5",
+    "ts-jest": "^29.0.3",
+    "@types/jest": "^29.2.2"
   }
 }

package/readme.md

@@ -4,30 +4,56 @@ This transformer prepares `ServerSession` subclasses for Typia and adds jsDoc in
 ## Usage
 [Here's how to use it](https://github.com/bogeeee/restfuncs/tree/3.x/readme.md#setting-up-the-build-here-it-gets-a-bit-nasty-)
 
+## Debugging parameters
+Insert these into the `{ "transform": "restfuncs-transformer", ...}` block.
+- debug: Set to true to dump the output of transformed **and affected** files each into a file named ...after_restfuncs-transformer.tmp
+- pretty: Pretty print the output (normally it is squeezed into one line to preserve line numbers and keep source maps intact)
+
 
 ## How the transformer chain works
 Here is, how the restfuncs-transformer, typia transformer and typescript-rtti work together: 
-1. The `restfuncs-transformer` scans for all `@remote` methods and, at the bottom of inside their class, it adds the following code (here for "myMethod"): 
+1. The `restfuncs-transformer` scans for all `@remote` methods and, at the bottom of inside their class, it adds the following code (here for):
 ````typescript
+@remote
+async myMethod(param1: string, someCallbackFn: (p:number) => Promise<string>);
+````
+
+results in adding this to the class body:
 
+````typescript
+import _rf_typia from "typia";
 /**
  * Code is generated by the restfuncs-transformer during compile-time
  */
 static getRemoteMethodsMeta(): (typeof this.type_remoteMethodsMeta) {
-    this.__hello_developer__make_sure_your_class_is_a_subclass_of_ServerSession // Give a friendly error message when this is not the case. Otherwise the following statement "const typia = ..." would fail and leaves the user wondering.
-    let typia = this.typiaRuntime; // We need a "typia" defined in the scope, but let restfuncs manage where that dependency comes from
-    return {
+    this.__hello_developer__make_sure_your_class_is_a_subclass_of_ServerSession // Attempt to give a friendly error message when this is not the case. Otherwise the previous line would fail and leaves the user wondering.
+    type CallbackPlaceholder<DECL_INDEX extends number>  = string & _rf_typia.tags.TagBase<{kind: "callbackFn", target: "string", value: DECL_INDEX, validate: `onValidateCallbackArg($input, ${DECL_INDEX})`}>; // Create a [custom tag](https://typia.io/docs/validators/tags/#customization), that can be used via `CallbackPlaceholder<n>`. During validation, this tag then calls onValidateCallbackArg.   
+    const result= {
         transformerVersion: {major: XX,  feature: XX },
         instanceMethods: {
             "myMethod": {
                 arguments: {
-                    validateEquals: (args: unknown) => typia.validateEquals<Parameters<typeof this.prototype["myMethod"]>>(args),
-                    validatePrune: ...
-                },
+                    validateEquals: (args: unknown) => _rf_typia.validateEquals<[param1: string, someCallback: (p:number) => Promise<string>]>(args),
+                    validatePrune: ...,
+                    withPlaceholders: {
+                        validateEquals: (args: unknown, onValidateCallbackArg: (placeholderId: string, declarationIndex: number) => boolean) => _rf_typia.validateEquals<[param1: string, someCallback: CallbackPlaceholder<0>]>(args),
+                        ...
+                    }
+                },                
                 result: {
-                    validateEquals: (value: unknown) => typia.validateEquals<Awaited<ReturnType<typeof this.prototype["myMethod"]>>>(value),
+                    validateEquals: (value: unknown) => _rf_typia.validateEquals<Awaited<ReturnType<typeof this.prototype["myMethod"]>>>(value),
                     ...
                 },
+                callbacks: [{ // here for the `someCallbackFn: (p:number) => Promise<string>` declaration
+                    arguments: {
+                        validateEquals: (args: unknown) => _rf_typia.validateEquals<[p: number]>(args),
+                        validatePrune: ...
+                    },
+                    awaitedResult: {
+                        validateEquals: (value: unknown) => _rf_typia.validateEquals<string>(value),
+                        ...
+                    }
+                }],
                 jsDoc: {
                     comment: "text with <strong>markup</strong>", 
                     params: {a: "text..."},
@@ -35,7 +61,9 @@ static getRemoteMethodsMeta(): (typeof this.type_remoteMethodsMeta) {
                 }
             }
         }
-    }
+    };
+    
+    return result; // Code style note for this line: Why not do `return {...}` directly ? This tiny difference allows for extra properties which ensure backward compatibility with older "restfuncs-server" packages.
 }
 ````
 

package/transformerUtil.d.ts

@@ -46,5 +46,15 @@ export declare abstract class FileTransformRun {
      */
     getIdentifierName(node: Node, escaped?: boolean): any;
 }
+export declare class TextPatch {
+    /**
+     * character index (not byte index) => content to insert
+     */
+    patches: {
+        position: number;
+        contentToInsert: string;
+    }[];
+    applyPatches(content: string): string;
+}
 export {};
 //# sourceMappingURL=transformerUtil.d.ts.map

package/transformerUtil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformerUtil.d.ts","sourceRoot":"","sources":["transformerUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAC,IAAI,EAAE,UAAU,EAAc,qBAAqB,EAAE,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAEvG,KAAK,OAAO,CAAC,CAAC,IAAI;IACd,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAqB,CAAC,EAAE,SAAS,gBAAgB;IAC1D,iBAAiB,EAAE,EAAE,EAAE,CAAK;IAC5B,qBAAqB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBAGrC,uBAAuB,EAAE,OAAO,CAAC,EAAE,CAAC;IAIhD;;OAEG;IACH,IAAI,UAAU,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAQ/C;CACJ;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IAClC,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,IAAI,EAAE,CAAK;IACxB,IAAI,UAAS;gBAED,UAAU,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB;IAOzF,SAAS,gBAEP;IAEF;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAGhC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI;IAWhC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAK3B,SAAS,CAAC,IAAI,EAAE,IAAI;IAMpB;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,UAAQ;CAUhD"}
+{"version":3,"file":"transformerUtil.d.ts","sourceRoot":"","sources":["transformerUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAC,IAAI,EAAE,UAAU,EAAc,qBAAqB,EAAE,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAEvG,KAAK,OAAO,CAAC,CAAC,IAAI;IACd,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAqB,CAAC,EAAE,SAAS,gBAAgB;IAC1D,iBAAiB,EAAE,EAAE,EAAE,CAAK;IAC5B,qBAAqB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBAGrC,uBAAuB,EAAE,OAAO,CAAC,EAAE,CAAC;IAIhD;;OAEG;IACH,IAAI,UAAU,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAQ/C;CACJ;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IAClC,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,IAAI,EAAE,CAAK;IACxB,IAAI,UAAS;gBAED,UAAU,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB;IAOzF,SAAS,gBAEP;IAEF;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAGhC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI;IAWhC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAK3B,SAAS,CAAC,IAAI,EAAE,IAAI;IAMpB;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,UAAQ;CAUhD;AAED,qBAAa,SAAS;IAClB;;OAEG;IACH,OAAO,EAAE;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAC,EAAE,CAAM;IAC5D,YAAY,CAAC,OAAO,EAAE,MAAM;CAgB/B"}

package/transformerUtil.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileTransformRun = exports.TransformerFactoryOOP = void 0;
+exports.TextPatch = exports.FileTransformRun = exports.TransformerFactoryOOP = void 0;
 const typescript_1 = __importStar(require("typescript"));
 /**
  * Transformerfactory in a better oop style
@@ -101,4 +101,26 @@ class FileTransformRun {
     }
 }
 exports.FileTransformRun = FileTransformRun;
+class TextPatch {
+    constructor() {
+        /**
+         * character index (not byte index) => content to insert
+         */
+        this.patches = [];
+    }
+    applyPatches(content) {
+        this.patches.sort((a, b) => a.position - b.position);
+        let result = "";
+        let emittedTil = 0;
+        for (const patch of this.patches) {
+            // emit the stuff before the patch
+            result += content.slice(emittedTil, patch.position);
+            emittedTil = patch.position;
+            result += patch.contentToInsert;
+        }
+        result += content.slice(emittedTil); // emit the rest
+        return result;
+    }
+}
+exports.TextPatch = TextPatch;
 //# sourceMappingURL=transformerUtil.js.map

package/transformerUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformerUtil.js","sourceRoot":"","sources":["transformerUtil.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAAuG;AAMvG;;GAEG;AACH,MAAa,qBAAqB;IAK9B,YAAY,uBAAoC;QAJhD,sBAAiB,GAAS,EAAE,CAAA;QAKxB,IAAI,CAAC,qBAAqB,GAAG,uBAAuB,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,CAAC,OAA8B,EAAE,EAAE;YACtC,OAAO,CAAC,UAAsB,EAAc,EAAE;gBAC1C,MAAM,eAAe,GAAG,IAAI,IAAI,CAAC,qBAAqB,CAAC,oBAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;gBAChF,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAqB,CAAC,CAAC;gBACnD,OAAO,oBAAE,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACzF,CAAC,CAAA;QACL,CAAC,CAAA;IACL,CAAC;CACJ;AArBD,sDAqBC;AAED;;GAEG;AACH,MAAsB,gBAAgB;IAOlC,YAAY,UAAqB,EAAE,UAAsB,EAAE,OAA8B;QAHzF,gBAAW,GAAW,EAAE,CAAA;QACxB,SAAI,GAAG,KAAK,CAAC;QASb,cAAS,GAAG,GAAG,EAAE;YACb,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QARE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAeS,WAAW,CAAC,IAAU;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI;YACA,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SACzF;gBAAS;YACN,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;SAC1B;IACL,CAAC;IAID;;;OAGG;IACH,OAAO,CAAC,IAAU;QACd,aAAa;QACb,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,IAAU;QAChB,IAAI,MAAM,GAAW,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,MAAM,CAAA;IACjB,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAU,EAAE,OAAO,GAAG,KAAK;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,uBAAU,CAAC,UAAU,CAAC,CAAC;QAC/F,IAAG,CAAC,cAAc,EAAE;YAChB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;SAC/C;QACD,IAAG,OAAO,EAAE;YACR,OAAQ,cAAsB,CAAC,WAAW,CAAC;SAC9C;QACD,OAAO,cAAc,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;CACJ;AApED,4CAoEC"}
+{"version":3,"file":"transformerUtil.js","sourceRoot":"","sources":["transformerUtil.ts"],"names":[],"mappings":"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"}

package/transformerUtil.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transformerUtil.test.d.ts.map

package/transformerUtil.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformerUtil.test.d.ts","sourceRoot":"","sources":["transformerUtil.test.ts"],"names":[],"mappings":""}

package/transformerUtil.test.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const transformerUtil_1 = require("./transformerUtil");
+jest.setTimeout(60 * 60 * 1000); // Increase timeout to 1h to make debugging possible
+test('TextPatch', () => {
+    const content = 'abc><de><fg';
+    const patch = new transformerUtil_1.TextPatch();
+    patch.patches = [{ position: 4, contentToInsert: "_insert1_" }, { position: 8, contentToInsert: "_insert2_" }];
+    expect(patch.applyPatches(content)).toBe('abc>_insert1_<de>_insert2_<fg');
+});
+//# sourceMappingURL=transformerUtil.test.js.map

package/transformerUtil.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformerUtil.test.js","sourceRoot":"","sources":["transformerUtil.test.ts"],"names":[],"mappings":";;AAAA,uDAA4C;AAE5C,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,oDAAoD;AAGrF,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;IACnB,MAAM,OAAO,GAAC,aAAa,CAAA;IAC3B,MAAM,KAAK,GAAG,IAAI,2BAAS,EAAE,CAAC;IAC9B,KAAK,CAAC,OAAO,GAAG,CAAC,EAAC,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,WAAW,EAAC,EAAE,EAAC,QAAQ,EAAE,CAAC,EAAE,eAAe,EAAE,WAAW,EAAC,CAAC,CAAC;IAC3G,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC"}

package/transformerUtil.test.ts

@@ -0,0 +1,12 @@
+import {TextPatch} from "./transformerUtil";
+
+jest.setTimeout(60 * 60 * 1000); // Increase timeout to 1h to make debugging possible
+
+
+test('TextPatch', () => {
+    const content='abc><de><fg'
+    const patch = new TextPatch();
+    patch.patches = [{position: 4, contentToInsert: "_insert1_"}, {position: 8, contentToInsert: "_insert2_"}];
+    expect(patch.applyPatches(content)).toBe('abc>_insert1_<de>_insert2_<fg');
+});
+

package/transformerUtil.ts

@@ -101,4 +101,27 @@ export abstract class FileTransformRun {
         }
         return identifierNode.getText();
     }
+}
+
+export class TextPatch {
+    /**
+     * character index (not byte index) => content to insert
+     */
+    patches: {position: number, contentToInsert: string}[] = [];
+    applyPatches(content: string) {
+        this.patches.sort((a,b) => a.position - b.position);
+        let result = "";
+        let emittedTil = 0;
+        for(const patch of this.patches) {
+            // emit the stuff before the patch
+            result+=content.slice(emittedTil, patch.position);
+            emittedTil = patch.position;
+
+            result+=patch.contentToInsert;
+        }
+
+        result+= content.slice(emittedTil);// emit the rest
+
+        return result;
+    }
 }