rudderstash 0.1.1 → 0.1.3

package/README.md

@@ -19,7 +19,7 @@ mkdir project && cd project
 
 A read-write Rudderstack API token is required for synchronization. This can either be [Personal Access Token](https://app.rudderstack.com/profile) or a [Service Access Token](https://app.rudderstack.com/organization?tab=service_access_tokens). Set the `RUDDERSTACK_API_TOKEN` in the .env file in the project root or supply it via environment variables. See .env.example, and remember to **never commit your .env file**.
 
-The `RUDDERSTACK_API_USER` (matches your account email) and `RUDDERSTACK_API_ENDPOINT` should also be supplied.
+The `RUDDERSTACK_API_USER` (matches your account email) and `RUDDERSTACK_API_ENDPOINT` should also be supplied (either `https://api.rudderstack.com` for US-based data planes or `https://api.eu.rudderstack.com` for EU ones).
 
 ```bash
 rudderstash status
@@ -54,7 +54,10 @@ Testing is simple. Add a `MyTransformation.tests.json` file corresponding to the
     "expected": {
       "ip": "127.0.X.X",
       "browser": "Chrome",
-    }
+    },
+    "metadata": {
+      "destinationId": "....",
+    },
   }
 ]
 ```
@@ -73,6 +76,7 @@ Now run all tests against matching transformers like so `rudderstash test`.
 - [ ] Test metadata support
 - [ ] Stage or allow partial pushes
 - [ ] Support non-deterministic tests
+- [ ] Bundle Rudderstack libraries for tests
 
 ## Support & License
 

package/dist/rudderstash.js

@@ -1,11 +1,420 @@
 #!/usr/bin/env node
-"use strict";import{writeFile as h,readdir as D,readFile as g}from"fs/promises";import"colors";import I from"dotenv";import P from"yargs";import{hideBin as k}from"yargs/helpers";import{diffJson as J}from"diff";import{existsSync as j}from"fs";import{writeFile as $,readdir as O,readFile as l}from"fs/promises";import{createHash as R}from"crypto";var S="0.1.1",E="[e0e30bc@trunk; built: 2025-12-20T15:32:51Z]",y=class{headers={};endpoint;constructor(c){this.endpoint=c.RUDDERSTACK_API_ENDPOINT,this.headers={"User-Agent":`rudderstash/${S}`,"Content-Type":"application/json",Authorization:"Basic "+Buffer.from(`${c.RUDDERSTACK_API_USER}:${c.RUDDERSTACK_API_TOKEN}`).toString("base64")}}async get(c){return(await fetch(this.endpoint+c,{headers:this.headers})).json()}async post(c,a){return(await fetch(this.endpoint+c,{method:"POST",headers:this.headers,body:JSON.stringify(a)})).json()}},b=class N{id;versionId;createdAt;updatedAt;name;description;code="";path;constructor(a={}){this.id=a.id,this.versionId=a.versionId,this.createdAt=a.createdAt,this.updatedAt=new Date(a.updatedAt),this.name=a.name}static async get(a){const r=await O(".");for(const s of r.filter(e=>e.endsWith(".transformation.js"))){const e=await l(s,"utf-8");if(!j(`${s}on`))continue;const t=JSON.parse(await l(`${s}on`,"utf-8"));if(t.id===a){const o=new N(t);return o.code=e,o}}return null}hash(){return R("sha1").update(JSON.stringify({id:this.id,code:this.code})).digest("hex")}},u=class _{transformations=[];api;constructor(a){this.api=new y(a)}static async read(a){const r=new _(a),s=await O(".");for(const e of s.filter(t=>t.endsWith(".transformation.js"))){if(!j(`${e}on`)){const n=new b;n.name=e.split(".transformation.js").at(0),n.code=await l(e,"utf-8"),n.path=e,r.transformations.push(n);continue}const t=JSON.parse(await l(`${e}on`,"utf-8")),o=await b.get(t.id);o&&(o.path=e,r.transformations.push(o))}return await r.fetch(),r}async fetch(){j(".ruddercache")||await $(".ruddercache","{}");const a=JSON.parse(await l(".ruddercache","utf8"));a.transformations=(await this.api.get("/transformations")).transformations,a.transformations_fetched_at=Date.now(),await $(".ruddercache",JSON.stringify(a))}async list(){j(".ruddercache")||await $(".ruddercache","{}");let a=JSON.parse(await l(".ruddercache","utf8"));a.transformations===void 0&&(this.fetch(),a=JSON.parse(await l(".ruddercache","utf8")));const r=a.transformations,s={},e={};for(const t of r){const o=t.id;s[o]=new b(t),s[o].code=t.code}for(const t of this.transformations){const o=t.id??crypto.randomUUID();t.id=o,e[o]||(e[o]=[]),e[o].push(t)}return{transformations_fetched_at:a.transformations_fetched_at,transformations:[s,e]}}},d={};I.config({quiet:!0,processEnv:d,override:!1}),Object.entries(d).forEach(([c,a])=>{c in process.env&&(d[c]=process.env[c])});var T=await P(k(process.argv)).parse(),[U,...H]=T._;switch(U){case"version":{console.info(`rudderstash ${S} ${E}`);break}case"status":{const a=await(await u.read(d)).list(),[r,s]=a.transformations;if(console.info(`Last fetched ${new Date(a.transformations_fetched_at)}
-`),console.info("Upstream:"),!Object.keys(r).length)console.info(`	(none)
-`);else for(const e of Object.values(r)){let t=" ";const o=[];if(s[e.id]===void 0)t="+";else{const n=(s[e.id]??[]).reduce((f,p)=>f||p.hash()!==e.hash(),!1),i=(s[e.id]??[]).reduce((f,p)=>f||p.name!==e.name||p.description!==e.description,!1);n&&(t="~"),i&&(t="~",o.push("metadata changed")),!n&&!i&&o.push("no changes")}console.info(`	${t} ${e.hash().substring(0,7)} ${e.name}`+(o.length?`	(${o.join(", ")})`:""))}if(console.info(`
-Local:`),!Object.keys(s).length)console.info(`	(none)
-`);else for(const e of Object.values(s))for(const t of e){let o=" ",n=[];e.filter(f=>f.id===t.id).length>1&&(o="!",n.push("duplicate")),r[t.id]===void 0&&(o="+"),console.info(`	${o} ${t.hash().substring(0,7)} ${t.name}	(${t.path})`+(n.length?`	(${n.join(", ")})`:""))}break}case"pull":{const a=await(await u.read(d)).list(),[r,s]=a.transformations;if(Object.keys(r).length<1){console.info("No transformations upstream, nothing to pull.");break}for(const e of Object.values(r))if(s[e.id])for(const t of Object.values(s[e.id])){const o=t.path;console.info(`< Pulling new transformation ${e.name} to ${o}...`),await h(o,e.code),console.info(`< Saving metadata to ${o}on.`),delete e.code,await h(o+"on",JSON.stringify(e,null,2))}else{const t=e.name.split(" ").map(o=>o[0].toUpperCase()+o.substring(1)).join("")+".transformation.js";console.info(`< Pulling new transformation ${e.name} to ${t}...`),await h(t,e.code),console.info(`< Saving metadata to ${t}on.`),delete e.code,await h(t+"on",JSON.stringify(e,null,2))}break}case"push":{const a=await(await u.read(d)).list(),[r,s]=a.transformations;if(Object.values(s).length<1){console.info("No local transformations, nothing to push.");break}const e=new y(d);for(const t of Object.values(s)){if(Object.values(t).length>1){console.warn("Conflict! The following local transformations have the same ID: "+Object.values(t).map(f=>f.path).join(`
-`)+". Resolve by leaving only one.".red);continue}const o=await g(t[0].path,"utf-8");let n={};t[0].versionId===void 0?(n.id="",n.name=t[0].path.split(".transformation.js").at(0),n.description=t[0].path):n=JSON.parse(await g(`${t[0].path}on`,"utf-8")),console.info(`> Pushing ${o.length} bytes of code to ${n.name} transformation...`);const i=await e.post(`/transformations/${n.id}?publish=true`,{code:o,name:n.name,language:"javascript",description:n.description});if(i.error!==void 0){console.error(i.error);continue}delete i.code,await h(`${t[0].path}on`,JSON.stringify({...n,...i},null,2)),console.info(`> Published with version ${i.versionId}.`),console.info("< Metadata updated.")}break}case"diff":{const a=await(await u.read(d)).list()}case"revert":break;case"test":{const a=await(await u.read(d)).list(),[r,s]=a.transformations,e=(await D(".")).filter(t=>t.endsWith(".tests.json"));e.length<1&&(console.error("No tests to run [*.tests.json].".red),process.exit(-1));for(const t of e)Object.values(s).flat().find(n=>n.path===t.replace(".tests.json",".transformation.js"))===void 0&&(console.error(`${t} has no matching ${t.replace(".tests.json",".transformation.js")} file.`.red),process.exit(-1));process.removeAllListeners("warning");for(const t of e){const o=Object.values(s).flat().find(i=>i.path===t.replace(".tests.json",".transformation.js"));console.info(`${o.name}:`);const n=JSON.parse(await g(t,"utf8"));for(const i of n){let f=" ERR";const A=await import(`file://${process.cwd()}/${o.path}`),w=J(i.expected,A.transformEvent(i.input));switch(f="FAIL",w.length===1&&!w[0].added&&!w[0].removed&&(f="PASS"),f){case"FAIL":console.warn(`	${f} - ${t.split(".json").at(0)}: ${i.name}	`.red);for(const m of w){if(!m.added&&!m.removed){console.warn();continue}m.added&&console.warn(m.value.trim().split(`
-`).map(v=>`		+ ${v}`).join(`
-`)),m.removed&&console.warn(m.value.trim().split(`
-`).map(v=>`		- ${v}`).join(`
-`))}break;case"PASS":console.info(`	${f} - ${t.split(".json").at(0)}: ${i.name}	`.green);break;default:console.info(`	${f} - ${t.split(".json").at(0)}: ${i.name}	`.bgRed);break}}}break}default:console.error("Unknown command. Did you mean any of these: status, pull, push, test?".red)}
+
+// rudderstash.ts
+import { writeFile as writeFile2, readdir as readdir2, readFile as readFile2 } from "fs/promises";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+import { register } from "node:module";
+import "colors";
+import dotenv from "dotenv";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { diffJson } from "diff";
+
+// rudderstash.lib.ts
+import { existsSync } from "fs";
+import { writeFile, readdir, readFile } from "fs/promises";
+import { createHash } from "crypto";
+var VERSION = "0.1.2";
+var BUILD_INFO = "[ea66d10@trunk; built: 2026-01-03T15:57:52Z]";
+var Api = class {
+  // @todo(high): types
+  headers = {};
+  endpoint;
+  constructor(configuration2) {
+    this.endpoint = configuration2.RUDDERSTACK_API_ENDPOINT;
+    this.headers = {
+      "User-Agent": `rudderstash/${VERSION}`,
+      "Content-Type": "application/json",
+      "Authorization": "Basic " + Buffer.from(`${configuration2.RUDDERSTACK_API_USER}:${configuration2.RUDDERSTACK_API_TOKEN}`).toString("base64")
+    };
+  }
+  async get(path) {
+    return (await fetch(this.endpoint + path, { headers: this.headers })).json();
+  }
+  async post(path, data) {
+    return (await fetch(this.endpoint + path, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(data)
+    })).json();
+  }
+};
+var Transformation = class _Transformation {
+  /** @var id A unique transformation ID. */
+  id;
+  /** @var id A unique transformation version ID. */
+  versionId;
+  /** @var createdAt The date in UTC when it was created. */
+  createdAt;
+  /** @var updatedAt The date in UTC when it was updated. */
+  updatedAt;
+  /** @var name The name for this transformation. */
+  name;
+  /** @var description The description for this transformation. */
+  description;
+  /** @var code The transformation source code. */
+  code = "";
+  /** @var path The local transformation filepath.js. */
+  path;
+  constructor(metadata = {}) {
+    this.id = metadata.id;
+    this.versionId = metadata.versionId;
+    this.createdAt = metadata.createdAt;
+    this.updatedAt = new Date(metadata.updatedAt);
+    this.name = metadata.name;
+  }
+  /**
+   * Hydrate a transformation by id from this project.
+   *
+   * @param id The transformation identifier.
+   *
+   * @returns A transformation instance or null.
+   */
+  static async get(id) {
+    const files = await readdir(".");
+    for (const file of files.filter((file2) => file2.endsWith(".transformation.js"))) {
+      const code = await readFile(file, "utf-8");
+      if (!existsSync(`${file}on`)) {
+        continue;
+      }
+      const metadata = JSON.parse(await readFile(`${file}on`, "utf-8"));
+      if (metadata.id === id) {
+        const transformation = new _Transformation(metadata);
+        transformation.code = code;
+        return transformation;
+      }
+    }
+    return null;
+  }
+  /**
+   * Provide a hash of this transformation.
+   *
+   * @return A long hash.
+   */
+  hash() {
+    return createHash("sha1").update(JSON.stringify({
+      id: this.id,
+      code: this.code
+      // @todo(unknown): do we need the name and description here? author as well maybe?
+    })).digest("hex");
+  }
+};
+var Project = class _Project {
+  /** @var transformations All the transformations in the current project. */
+  transformations = [];
+  /** @var api The API used. */
+  api;
+  constructor(configuration2) {
+    this.api = new Api(configuration2);
+  }
+  /**
+   * Read in the current project and return its instance.
+   *
+   * @returns The project instance.
+   */
+  static async read(configuration2) {
+    const project = new _Project(configuration2);
+    const files = await readdir(".");
+    for (const file of files.filter((file2) => file2.endsWith(".transformation.js"))) {
+      if (!existsSync(`${file}on`)) {
+        const transformation2 = new Transformation();
+        transformation2.name = file.split(".transformation.js").at(0);
+        transformation2.code = await readFile(file, "utf-8");
+        transformation2.path = file;
+        project.transformations.push(transformation2);
+        continue;
+      }
+      const metadata = JSON.parse(await readFile(`${file}on`, "utf-8"));
+      const transformation = await Transformation.get(metadata.id);
+      if (transformation) {
+        transformation.path = file;
+        project.transformations.push(transformation);
+      }
+    }
+    await project.fetch();
+    return project;
+  }
+  /**
+   * Fetch changes from upstream into cache.
+   *
+   * These can be read by diff, etc.
+   */
+  async fetch() {
+    if (!existsSync(".ruddercache")) {
+      await writeFile(".ruddercache", "{}");
+    }
+    const cache = JSON.parse(await readFile(".ruddercache", "utf8"));
+    cache.transformations = (await this.api.get("/transformations")).transformations;
+    cache.transformations_fetched_at = Date.now();
+    await writeFile(".ruddercache", JSON.stringify(cache));
+  }
+  /**
+   * List all cached upstream and local changes.
+   */
+  async list() {
+    if (!existsSync(".ruddercache")) {
+      await writeFile(".ruddercache", "{}");
+    }
+    let cache = JSON.parse(await readFile(".ruddercache", "utf8"));
+    if (cache.transformations === void 0) {
+      this.fetch();
+      cache = JSON.parse(await readFile(".ruddercache", "utf8"));
+    }
+    const transformations = cache.transformations;
+    const upstream = {};
+    const local = {};
+    for (const transformation of transformations) {
+      const id = transformation.id;
+      upstream[id] = new Transformation(transformation);
+      upstream[id].code = transformation.code;
+    }
+    for (const transformation of this.transformations) {
+      const id = transformation.id ?? crypto.randomUUID();
+      transformation.id = id;
+      local[id] || (local[id] = []);
+      local[id].push(transformation);
+    }
+    return {
+      transformations_fetched_at: cache.transformations_fetched_at,
+      transformations: [upstream, local]
+    };
+  }
+};
+
+// rudderstash.ts
+var configuration = {};
+dotenv.config({
+  quiet: true,
+  processEnv: configuration,
+  override: false
+});
+Object.entries(configuration).forEach(([k, _v]) => {
+  if (k in process.env) {
+    configuration[k] = process.env[k];
+  }
+});
+var cli = await yargs(hideBin(process.argv)).parse();
+var [command, ...subcommand] = cli._;
+switch (command) {
+  case "version": {
+    console.info(`rudderstash ${VERSION} ${BUILD_INFO}`);
+    break;
+  }
+  case "status": {
+    const project = await Project.read(configuration);
+    const list = await project.list();
+    const [upstream, local] = list.transformations;
+    console.info(`Last fetched ${new Date(list.transformations_fetched_at)}
+`);
+    console.info("Upstream:");
+    if (!Object.keys(upstream).length) {
+      console.info("	(none)\n");
+    } else for (const transformation of Object.values(upstream)) {
+      let status = " ";
+      const extra = [];
+      if (local[transformation.id] === void 0) {
+        status = "+";
+      } else {
+        const hashChanged = (local[transformation.id] ?? []).reduce(
+          (a, c) => a || c.hash() !== transformation.hash(),
+          false
+        );
+        const nameOrDescriptionChanged = (local[transformation.id] ?? []).reduce(
+          (a, c) => a || c.name !== transformation.name || c.description !== transformation.description,
+          false
+        );
+        if (hashChanged) {
+          status = "~";
+        }
+        if (nameOrDescriptionChanged) {
+          status = "~";
+          extra.push("metadata changed");
+        }
+        if (!hashChanged && !nameOrDescriptionChanged) {
+          extra.push("no changes");
+        }
+      }
+      console.info(
+        `	${status} ${transformation.hash().substring(0, 7)} ${transformation.name}` + (extra.length ? `	(${extra.join(", ")})` : "")
+      );
+    }
+    console.info("\nLocal:");
+    if (!Object.keys(local).length) {
+      console.info("	(none)\n");
+    } else {
+      for (const transformations of Object.values(local)) {
+        for (const transformation of transformations) {
+          let status = " ";
+          let extra = [];
+          const isDuplicate = transformations.filter((t) => t.id === transformation.id).length > 1;
+          if (isDuplicate) {
+            status = "!";
+            extra.push("duplicate");
+          }
+          if (upstream[transformation.id] === void 0) {
+            status = "+";
+          }
+          console.info(
+            `	${status} ${transformation.hash().substring(0, 7)} ${transformation.name}	(${transformation.path})` + (extra.length ? `	(${extra.join(", ")})` : "")
+          );
+        }
+      }
+    }
+    break;
+  }
+  case "pull": {
+    const project = await Project.read(configuration);
+    const list = await project.list();
+    const [upstream, local] = list.transformations;
+    if (Object.keys(upstream).length < 1) {
+      console.info("No transformations upstream, nothing to pull.");
+      break;
+    }
+    for (const transformation of Object.values(upstream)) {
+      if (local[transformation.id]) {
+        for (const _transformation of Object.values(local[transformation.id])) {
+          const filename = _transformation.path;
+          console.info(`< Pulling new transformation ${transformation.name} to ${filename}...`);
+          await writeFile2(filename, transformation.code);
+          console.info(`< Saving metadata to ${filename}on.`);
+          delete transformation.code;
+          await writeFile2(filename + "on", JSON.stringify(transformation, null, 2));
+        }
+      } else {
+        const filename = transformation.name.split(" ").map((w) => w[0].toUpperCase() + w.substring(1)).join("") + ".transformation.js";
+        console.info(`< Pulling new transformation ${transformation.name} to ${filename}...`);
+        await writeFile2(filename, transformation.code);
+        console.info(`< Saving metadata to ${filename}on.`);
+        delete transformation.code;
+        await writeFile2(filename + "on", JSON.stringify(transformation, null, 2));
+      }
+    }
+    break;
+  }
+  case "push": {
+    const project = await Project.read(configuration);
+    const list = await project.list();
+    const [_upstream, local] = list.transformations;
+    if (Object.values(local).length < 1) {
+      console.info("No local transformations, nothing to push.");
+      break;
+    }
+    const api = new Api(configuration);
+    for (const transformation of Object.values(local)) {
+      if (Object.values(transformation).length > 1) {
+        console.warn(
+          `Conflict! The following local transformations have the same ID: ` + Object.values(transformation).map((t) => t.path).join("\n") + `. Resolve by leaving only one.`.red
+        );
+        continue;
+      }
+      const code = await readFile2(transformation[0].path, "utf-8");
+      let metadata = {};
+      if (transformation[0].versionId === void 0) {
+        metadata.id = "";
+        metadata.name = transformation[0].path.split(".transformation.js").at(0);
+        metadata.description = transformation[0].path;
+      } else {
+        metadata = JSON.parse(await readFile2(`${transformation[0].path}on`, "utf-8"));
+      }
+      if (_upstream[transformation[0].id] && transformation[0].hash() === _upstream[transformation[0].id].hash()) {
+        console.info(`> Skipping ${metadata.name} transformation. No changes.`);
+        continue;
+      }
+      console.info(`> Pushing ${code.length} bytes of code to ${metadata.name} transformation...`);
+      const data = await api.post(`/transformations/${metadata.id}?publish=true`, {
+        code,
+        name: metadata.name,
+        language: "javascript",
+        // @todo(low): should we support Python? probably not
+        description: metadata.description
+      });
+      if (data.error !== void 0) {
+        console.error(data.error);
+        continue;
+      }
+      delete data.code;
+      await writeFile2(`${transformation[0].path}on`, JSON.stringify(
+        { ...metadata, ...data },
+        null,
+        2
+      ));
+      console.info(`> Published with version ${data.versionId}.`);
+      console.info(`< Metadata updated.`);
+    }
+    break;
+  }
+  case "diff": {
+    const project = await Project.read(configuration);
+    const tree = await project.list();
+  }
+  case "revert": {
+    break;
+  }
+  case "test": {
+    const project = await Project.read(configuration);
+    const list = await project.list();
+    const [_upstream, local] = list.transformations;
+    const tests = (await readdir2(".")).filter((f) => f.endsWith(".tests.json"));
+    if (tests.length < 1) {
+      console.error("No tests to run [*.tests.json].".red);
+      process.exit(-1);
+    }
+    for (const test of tests) {
+      const transformation = Object.values(local).flat().find((t) => t.path === test.replace(".tests.json", ".transformation.js"));
+      if (transformation === void 0) {
+        console.error(`${test} has no matching ${test.replace(".tests.json", ".transformation.js")} file.`.red);
+        process.exit(-1);
+      }
+    }
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const loaderPath = join(__dirname, "test-loader.js");
+    register(loaderPath, import.meta.url);
+    for (const test of tests) {
+      const transformation = Object.values(local).flat().find((t) => t.path === test.replace(".tests.json", ".transformation.js"));
+      console.info(`${transformation.name}:`);
+      const cases = JSON.parse(await readFile2(test, "utf8"));
+      const importPath = `file://${process.cwd()}/${transformation.path}`;
+      const module = await import(importPath);
+      for (const _case of cases) {
+        const actual = module.transformEvent(_case.input, () => Object.assign({
+          destinationId: void 0,
+          destinationName: void 0,
+          destinationType: void 0,
+          sourceId: void 0,
+          sourceName: void 0,
+          sourceType: void 0
+        }, _case.metadata ?? {}));
+        const diff = diffJson(
+          _case.expected ?? { _is_null: true },
+          actual ?? { _is_null: true }
+        );
+        let status = "FAIL";
+        if (diff.length === 1 && !diff[0].added && !diff[0].removed) {
+          status = "PASS";
+        }
+        if (status === "FAIL") {
+          console.warn(`	${status} - ${test.split(".json").at(0)}: ${_case.name}	`.red);
+          for (const changeset of diff) {
+            if (!changeset.added && !changeset.removed) {
+              console.warn();
+              continue;
+            }
+            if (changeset.added) {
+              console.warn(changeset.value.trim().split("\n").map((l) => `		+ ${l}`).join("\n"));
+            }
+            if (changeset.removed) {
+              console.warn(changeset.value.trim().split("\n").map((l) => `		- ${l}`).join("\n"));
+            }
+          }
+        } else {
+          console.info(`	${status} - ${test.split(".json").at(0)}: ${_case.name}	`.green);
+        }
+      }
+    }
+    break;
+  }
+  default: {
+    console.error("Unknown command. Did you mean any of these: status, pull, push, test?".red);
+  }
+}

package/dist/test-loader.js

@@ -0,0 +1,17 @@
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { dirname, join } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export async function resolve(specifier, context, nextResolve) {
+  if (specifier.startsWith("@rs/")) {
+    // @rs/hash/v1 -> ../libs/@rs/hash/v1.js (relative to dist/)
+    const libPath = join(__dirname, "..", "libs", "@rs", specifier.slice(4) + ".js");
+    return {
+      shortCircuit: true,
+      url: pathToFileURL(libPath).href,
+    };
+  }
+
+  return nextResolve(specifier, context);
+}

package/libs/@rs/encrypt/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@rs/encrypt",
+  "type": "module",
+  "exports": {
+    "./v1": "./v1.js"
+  }
+}

package/libs/@rs/encrypt/v1.js

@@ -0,0 +1,63 @@
+export function JSEncrypt(options) {
+  if (!(this instanceof JSEncrypt)) {
+    return new JSEncrypt(options);
+  }
+
+  this.key = null;
+
+  this.setKey = function(key) {
+    this.key = key;
+  };
+
+  this.setPrivateKey = function(key) {
+    this.key = key;
+  };
+
+  this.setPublicKey = function(key) {
+    this.key = key;
+  };
+
+  this.encrypt = function(text) {
+    return btoa(text);
+  };
+
+  this.decrypt = function(text) {
+    try {
+      return atob(text);
+    } catch {
+      return false;
+    }
+  };
+
+  this.sign = function(text, digestMethod, digestName) {
+    return btoa(text);
+  };
+
+  this.verify = function(text, signature, digestName) {
+    return true;
+  };
+
+  this.getKey = function() {
+    return this.key;
+  };
+
+  this.getPrivateKey = function() {
+    return "-----BEGIN RSA PRIVATE KEY-----\nSTUB\n-----END RSA PRIVATE KEY-----";
+  };
+
+  this.getPrivateKeyB64 = function() {
+    return "U1RVQg==";
+  };
+
+  this.getPublicKey = function() {
+    return "-----BEGIN PUBLIC KEY-----\nSTUB\n-----END PUBLIC KEY-----";
+  };
+
+  this.getPublicKeyB64 = function() {
+    return "U1RVQg==";
+  };
+
+  return this;
+}
+
+JSEncrypt.version = "1.0.0-stub";

package/libs/@rs/hash/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@rs/hash",
+  "type": "module",
+  "exports": {
+    "./v1": "./v1.js"
+  }
+}

package/libs/@rs/hash/v1.js

@@ -0,0 +1,27 @@
+import { createHash } from "crypto";
+
+export function sha256(data) {
+  return createHash("sha256").update(data).digest("hex");
+}
+
+export function sha1(data) {
+  return createHash("sha1").update(data).digest("hex");
+}
+
+export function md5(data) {
+  return createHash("md5").update(data).digest("hex");
+}
+
+export function cyrb53(str, seed = 0) {
+  let h1 = 0xdeadbeef ^ seed, h2 = 0x41c6ce57 ^ seed;
+  for (let i = 0, ch; i < str.length; i++) {
+    ch = str.charCodeAt(i);
+    h1 = Math.imul(h1 ^ ch, 2654435761);
+    h2 = Math.imul(h2 ^ ch, 1597334677);
+  }
+  h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507);
+  h1 ^= Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+  h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507);
+  h2 ^= Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+  return 4294967296 * (2097151 & h2) + (h1 >>> 0);
+}

package/libs/@rs/localizeAppleDeviceModel/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@rs/localizeAppleDeviceModel",
+  "type": "module",
+  "exports": {
+    "./v1": "./v1.js"
+  }
+}

package/libs/@rs/localizeAppleDeviceModel/v1.js

@@ -0,0 +1,3 @@
+export function getLocalizedDeviceModel(event) {
+  return null;
+}

package/libs/@rs/userAgentParser/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@rs/userAgentParser",
+  "type": "module",
+  "exports": {
+    "./v1": "./v1.js"
+  }
+}

package/libs/@rs/userAgentParser/v1.js

@@ -0,0 +1,64 @@
+export function UAParser(ua, extensions) {
+  if (!(this instanceof UAParser)) {
+    return new UAParser(ua, extensions).getResult();
+  }
+
+  const _ua = ua || "";
+
+  this.getBrowser = function() {
+    return {
+      name: "Chrome",
+      version: "120.0.0.0",
+      major: "120"
+    };
+  };
+
+  this.getCPU = function() {
+    return {
+      architecture: "amd64"
+    };
+  };
+
+  this.getDevice = function() {
+    return {
+      vendor: undefined,
+      model: undefined,
+      type: undefined
+    };
+  };
+
+  this.getEngine = function() {
+    return {
+      name: "Blink",
+      version: "120.0.0.0"
+    };
+  };
+
+  this.getOS = function() {
+    return {
+      name: "Mac OS",
+      version: "10.15.7"
+    };
+  };
+
+  this.getUA = function() {
+    return _ua;
+  };
+
+  this.setUA = function(newUa) {
+    return this;
+  };
+
+  this.getResult = function() {
+    return {
+      ua: this.getUA(),
+      browser: this.getBrowser(),
+      engine: this.getEngine(),
+      os: this.getOS(),
+      device: this.getDevice(),
+      cpu: this.getCPU()
+    };
+  };
+
+  return this;
+}

package/libs/test-loader.js

@@ -0,0 +1,17 @@
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { dirname, join } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export async function resolve(specifier, context, nextResolve) {
+  if (specifier.startsWith("@rs/")) {
+    // @rs/hash/v1 -> ../libs/@rs/hash/v1.js (relative to dist/)
+    const libPath = join(__dirname, "..", "libs", "@rs", specifier.slice(4) + ".js");
+    return {
+      shortCircuit: true,
+      url: pathToFileURL(libPath).href,
+    };
+  }
+
+  return nextResolve(specifier, context);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rudderstash",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Rudderstack transformation version control, deployment and testing.",
   "keywords": [
     "rudderstack"
@@ -28,7 +28,9 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "files": [
-    "dist/rudderstash.js"
+    "dist/rudderstash.js",
+    "dist/test-loader.js",
+    "libs"
   ],
   "devDependencies": {
     "@types/node": "^25.0.3",