@featurevisor/core 2.7.0 → 2.8.0

package/lib/parsers/yml.spec.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const yml_1 = require("./yml");
+describe("core :: parser :: ymlParser", () => {
+    it("should parse YAML string into object", () => {
+        const yamlString = `
+foo: 1
+bar: baz
+arr:
+  - 1
+  - 2
+`;
+        const result = yml_1.ymlParser.parse(yamlString);
+        expect(result).toEqual({ foo: 1, bar: "baz", arr: [1, 2] });
+    });
+    it("should stringify object into YAML string", () => {
+        const obj = { foo: 1, bar: "baz", arr: [1, 2] };
+        const yamlString = yml_1.ymlParser.stringify(obj);
+        expect(yamlString.trim()).toBe(`foo: 1
+bar: baz
+arr:
+  - 1
+  - 2`);
+    });
+    it("should parse and then stringify to preserve YAML content semantically", () => {
+        const original = {
+            alpha: "a",
+            num: 42,
+            bool: true,
+            nullish: null,
+            nested: { z: "x", y: [1, 2] },
+        };
+        const str = yml_1.ymlParser.stringify(original);
+        const reparsed = yml_1.ymlParser.parse(str);
+        expect(reparsed).toEqual(original);
+    });
+    it("should throw if invalid YAML string is provided to parse", () => {
+        expect(() => {
+            yml_1.ymlParser.parse("foo: : bar");
+        }).toThrow();
+    });
+    describe("stringify() with filePath argument (existing file for ordering/comments only)", () => {
+        const fs = require("fs");
+        const path = require("path");
+        const os = require("os");
+        let tempFile;
+        beforeEach(() => {
+            tempFile = path.join(os.tmpdir(), `test_${Math.random()}.yml`);
+        });
+        afterEach(() => {
+            if (fs.existsSync(tempFile)) {
+                fs.unlinkSync(tempFile);
+            }
+        });
+        it("should save exactly the new object; existing file is only for ordering/comments", () => {
+            const beforeYaml = `
+foo: 1 # foo comment here
+extra: blah
+
+##
+# Comment above nested
+#
+nested:
+  a: x
+  b: y # b comment
+array:
+  - one # one
+  - two # two
+  - three # three
+`.trim() + "\n";
+            const newContent = {
+                foo: 42,
+                bar: "new",
+                nested: { b: "updated", c: "added" },
+                array: ["two", "three", "four"],
+            };
+            const afterYaml = `
+foo: 42 # foo comment here
+bar: new
+##
+# Comment above nested
+#
+nested:
+  b: updated # b comment
+  c: added
+array:
+  - two # two
+  - three # three
+  - four
+`.trim() + "\n";
+            fs.writeFileSync(tempFile, beforeYaml);
+            const output = yml_1.ymlParser.stringify(newContent, tempFile);
+            expect(output).toBe(afterYaml);
+        });
+        it("should replace the root if YAML file is empty", () => {
+            const beforeYaml = "";
+            const afterYaml = `
+hello: world
+test:
+  - 1
+  - 2
+  - 3
+`.trim() + "\n";
+            fs.writeFileSync(tempFile, beforeYaml);
+            const obj = { hello: "world", test: [1, 2, 3] };
+            const output = yml_1.ymlParser.stringify(obj, tempFile);
+            expect(output).toBe(afterYaml);
+        });
+        it("should throw if trying to set YAML document root to a primitive", () => {
+            const beforeYaml = `
+foo: bar
+`.trim() + "\n";
+            fs.writeFileSync(tempFile, beforeYaml);
+            // Root must be an object when using filePath; primitives throw
+            expect(() => {
+                yml_1.ymlParser.stringify("primitive", tempFile);
+            }).toThrow(/Cannot set root document to a primitive value/);
+        });
+        it("should fall back to simple stringify if filePath does not exist", () => {
+            const fakeFilePath = path.join(os.tmpdir(), `notfound_${Math.random()}.yml`);
+            const afterYaml = `
+only: in-memory
+`.trim() + "\n";
+            const obj = { only: "in-memory" };
+            const output = yml_1.ymlParser.stringify(obj, fakeFilePath);
+            expect(output).toBe(afterYaml);
+            expect(fs.existsSync(fakeFilePath)).toBe(false); // should not create the file
+        });
+        it("should not mutate the original YAML file", () => {
+            const beforeYaml = `
+foo: unchanged
+bar: before
+`.trim() + "\n";
+            fs.writeFileSync(tempFile, beforeYaml);
+            const onDiskBefore = fs.readFileSync(tempFile, "utf8");
+            const obj = { bar: "after" };
+            yml_1.ymlParser.stringify(obj, tempFile);
+            const onDiskAfter = fs.readFileSync(tempFile, "utf8");
+            expect(onDiskAfter).toBe(onDiskBefore); // file on disk unchanged
+        });
+    });
+});
+//# sourceMappingURL=yml.spec.js.map

package/lib/parsers/yml.spec.js.map

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

package/lib/utils/git.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,8 +44,8 @@
     "@featurevisor/site": "2.7.0",
     "@featurevisor/types": "2.7.0",
     "axios": "^1.3.4",
-    "js-yaml": "^4.1.0",
     "tar": "^6.1.13",
+    "yaml": "^1.10.2",
     "yargs": "^17.7.2",
     "zod": "^3.22.4"
   },
@@ -53,5 +53,5 @@
     "@types/js-yaml": "^4.0.5",
     "@types/tar": "^6.1.4"
   },
-  "gitHead": "aebf65e5be80d1f8a67453e45b4609af2490103e"
+  "gitHead": "8b9d6bf3c8c25d8bd0eb1db05b1a9f7e8493caf5"
 }

package/src/config/index.ts

@@ -1,2 +1 @@
 export * from "./projectConfig";
-export * from "./parsers";

package/src/config/projectConfig.ts

@@ -2,7 +2,7 @@ import * as path from "path";
 
 import type { BucketBy, Context, Tag } from "@featurevisor/types";
 
-import { Parser, parsers } from "./parsers";
+import { Parser, parsers } from "../parsers";
 import { FilesystemAdapter } from "../datasource/filesystemAdapter";
 import type { Plugin } from "../cli";
 import type { BuildTags } from "../builder/buildDatafile";

package/src/datasource/datasource.ts

@@ -13,7 +13,8 @@ import type {
   EntityType,
 } from "@featurevisor/types";
 
-import { ProjectConfig, CustomParser } from "../config";
+import { ProjectConfig } from "../config";
+import { CustomParser } from "../parsers";
 
 import { Adapter, DatafileOptions } from "./adapter";
 

package/src/datasource/filesystemAdapter.ts

@@ -14,7 +14,8 @@ import type {
 } from "@featurevisor/types";
 
 import { Adapter, DatafileOptions } from "./adapter";
-import { ProjectConfig, CustomParser } from "../config";
+import { ProjectConfig } from "../config";
+import { CustomParser } from "../parsers";
 import { getCommit } from "../utils/git";
 
 export function getExistingStateFilePath(
@@ -128,7 +129,7 @@ export class FilesystemAdapter extends Adapter {
       fs.mkdirSync(this.getEntityDirectoryPath(entityType), { recursive: true });
     }
 
-    fs.writeFileSync(filePath, this.parser.stringify(entity));
+    fs.writeFileSync(filePath, this.parser.stringify(entity, filePath));
 
     return entity;
   }

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from "./config";
+export * from "./parsers";
 export * from "./linter";
 export * from "./builder";
 export * from "./tester";

package/src/linter/conditionSchema.ts

@@ -25,6 +25,12 @@ const arrayOperators = ["in", "notIn"];
 const regexOperators = ["matches", "notMatches"];
 const operatorsWithoutValue = ["exists", "notExists"];
 
+const isoDateRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|([+\-]\d{2}:\d{2})))?$/;
+
+function isIsoDateString(value: string): boolean {
+  return isoDateRegex.test(value);
+}
+
 export function getConditionsZodSchema(
   projectConfig: ProjectConfig,
   availableAttributeKeys: [string, ...string[]],
@@ -114,12 +120,43 @@ export function getConditionsZodSchema(
       }
 
       // date
-      if (dateOperators.includes(data.operator) && !(data.value instanceof Date)) {
-        context.addIssue({
-          code: z.ZodIssueCode.custom,
-          message: `when operator is "${data.operator}", value must be a date`,
-          path: ["value"],
-        });
+      if (dateOperators.includes(data.operator)) {
+        // Value is required and must not be undefined or null
+        if (typeof data.value === "undefined" || data.value === null || data.value === "") {
+          context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `when operator is "${data.operator}", value must be provided`,
+            path: ["value"],
+          });
+        } else if (typeof data.value === "string") {
+          // If it's a string, must be valid ISO 8601
+          if (!isIsoDateString(data.value)) {
+            context.addIssue({
+              code: z.ZodIssueCode.custom,
+              message: `when operator is "${data.operator}", value must be a stringified date in ISO 8601 format`,
+              path: ["value"],
+            });
+          } else {
+            // valid ISO 8601 string -- no issue
+          }
+        } else if (data.value instanceof Date) {
+          // If it's a Date, must be valid
+          if (isNaN(data.value.getTime())) {
+            context.addIssue({
+              code: z.ZodIssueCode.custom,
+              message: `when operator is "${data.operator}", value is a Date but invalid`,
+              path: ["value"],
+            });
+          }
+          // Valid JS Date -- no issue
+        } else {
+          // NOT a string, NOT a Date
+          context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `when operator is "${data.operator}", value must be a stringified date in ISO 8601 format or a valid Date object`,
+            path: ["value"],
+          });
+        }
       }
 
       // array

package/src/parsers/index.ts

@@ -0,0 +1,22 @@
+import { jsonParser } from "./json";
+import { ymlParser } from "./yml";
+
+export interface CustomParser {
+  extension: string;
+  parse: <T>(content: string, filePath?: string) => T;
+  stringify: (content: any, filePath?: string) => string;
+}
+
+/**
+ * If we want to add more built-in parsers,
+ * add them to this object with new file extension as the key,
+ * and a function that takes file content as string and returns parsed object as the value.
+ */
+export const parsers: { [key: string]: CustomParser } = {
+  yml: ymlParser,
+  json: jsonParser,
+};
+
+export type BuiltInParser = keyof typeof parsers; // keys of parsers object
+
+export type Parser = BuiltInParser | CustomParser;

package/src/parsers/json.spec.ts

@@ -0,0 +1,36 @@
+import { jsonParser } from "./json";
+
+describe("core :: parser :: jsonParser", () => {
+  it("should parse JSON string into object", () => {
+    const jsonString = '{"foo":1,"bar":"baz","arr":[1,2]}';
+    const result = jsonParser.parse<{ foo: number; bar: string; arr: number[] }>(jsonString);
+    expect(result).toEqual({ foo: 1, bar: "baz", arr: [1, 2] });
+  });
+
+  it("should stringify object into JSON string (pretty-printed)", () => {
+    const obj = { foo: 1, bar: "baz", arr: [1, 2] };
+    const jsonString = jsonParser.stringify(obj);
+    const expectedString = `{
+  "foo": 1,
+  "bar": "baz",
+  "arr": [
+    1,
+    2
+  ]
+}`;
+    expect(jsonString).toBe(expectedString);
+  });
+
+  it("should parse and then stringify to preserve content", () => {
+    const original = { alpha: "a", num: 42, bool: true, nullish: null, nested: { z: "x" } };
+    const str = jsonParser.stringify(original);
+    const reparsed = jsonParser.parse<typeof original>(str);
+    expect(reparsed).toEqual(original);
+  });
+
+  it("should throw if invalid JSON string is provided to parse", () => {
+    expect(() => {
+      jsonParser.parse("this is not json");
+    }).toThrow();
+  });
+});

package/src/parsers/json.ts

@@ -0,0 +1,11 @@
+import type { CustomParser } from "./index";
+
+export const jsonParser: CustomParser = {
+  extension: "json",
+  parse: function <T>(content: string): T {
+    return JSON.parse(content) as T;
+  },
+  stringify: function (content: any) {
+    return JSON.stringify(content, null, 2);
+  },
+};

package/src/parsers/yml.spec.ts

@@ -0,0 +1,174 @@
+import { ymlParser } from "./yml";
+
+describe("core :: parser :: ymlParser", () => {
+  it("should parse YAML string into object", () => {
+    const yamlString = `
+foo: 1
+bar: baz
+arr:
+  - 1
+  - 2
+`;
+    const result = ymlParser.parse<{ foo: number; bar: string; arr: number[] }>(yamlString);
+    expect(result).toEqual({ foo: 1, bar: "baz", arr: [1, 2] });
+  });
+
+  it("should stringify object into YAML string", () => {
+    const obj = { foo: 1, bar: "baz", arr: [1, 2] };
+    const yamlString = ymlParser.stringify(obj);
+    expect(yamlString.trim()).toBe(`foo: 1
+bar: baz
+arr:
+  - 1
+  - 2`);
+  });
+
+  it("should parse and then stringify to preserve YAML content semantically", () => {
+    const original = {
+      alpha: "a",
+      num: 42,
+      bool: true,
+      nullish: null,
+      nested: { z: "x", y: [1, 2] },
+    };
+    const str = ymlParser.stringify(original);
+    const reparsed = ymlParser.parse<typeof original>(str);
+    expect(reparsed).toEqual(original);
+  });
+
+  it("should throw if invalid YAML string is provided to parse", () => {
+    expect(() => {
+      ymlParser.parse("foo: : bar");
+    }).toThrow();
+  });
+
+  describe("stringify() with filePath argument (existing file for ordering/comments only)", () => {
+    const fs = require("fs");
+    const path = require("path");
+    const os = require("os");
+
+    let tempFile: string;
+
+    beforeEach(() => {
+      tempFile = path.join(os.tmpdir(), `test_${Math.random()}.yml`);
+    });
+
+    afterEach(() => {
+      if (fs.existsSync(tempFile)) {
+        fs.unlinkSync(tempFile);
+      }
+    });
+
+    it("should save exactly the new object; existing file is only for ordering/comments", () => {
+      const beforeYaml =
+        `
+foo: 1 # foo comment here
+extra: blah
+
+##
+# Comment above nested
+#
+nested:
+  a: x
+  b: y # b comment
+array:
+  - one # one
+  - two # two
+  - three # three
+`.trim() + "\n";
+
+      const newContent = {
+        foo: 42,
+        bar: "new",
+        nested: { b: "updated", c: "added" },
+        array: ["two", "three", "four"],
+      };
+
+      const afterYaml =
+        `
+foo: 42 # foo comment here
+bar: new
+##
+# Comment above nested
+#
+nested:
+  b: updated # b comment
+  c: added
+array:
+  - two # two
+  - three # three
+  - four
+`.trim() + "\n";
+
+      fs.writeFileSync(tempFile, beforeYaml);
+
+      const output = ymlParser.stringify(newContent, tempFile);
+
+      expect(output).toBe(afterYaml);
+    });
+
+    it("should replace the root if YAML file is empty", () => {
+      const beforeYaml = "";
+      const afterYaml =
+        `
+hello: world
+test:
+  - 1
+  - 2
+  - 3
+`.trim() + "\n";
+
+      fs.writeFileSync(tempFile, beforeYaml);
+
+      const obj = { hello: "world", test: [1, 2, 3] };
+      const output = ymlParser.stringify(obj, tempFile);
+
+      expect(output).toBe(afterYaml);
+    });
+
+    it("should throw if trying to set YAML document root to a primitive", () => {
+      const beforeYaml =
+        `
+foo: bar
+`.trim() + "\n";
+
+      fs.writeFileSync(tempFile, beforeYaml);
+
+      // Root must be an object when using filePath; primitives throw
+      expect(() => {
+        ymlParser.stringify("primitive", tempFile);
+      }).toThrow(/Cannot set root document to a primitive value/);
+    });
+
+    it("should fall back to simple stringify if filePath does not exist", () => {
+      const fakeFilePath = path.join(os.tmpdir(), `notfound_${Math.random()}.yml`);
+      const afterYaml =
+        `
+only: in-memory
+`.trim() + "\n";
+
+      const obj = { only: "in-memory" };
+      const output = ymlParser.stringify(obj, fakeFilePath);
+
+      expect(output).toBe(afterYaml);
+      expect(fs.existsSync(fakeFilePath)).toBe(false); // should not create the file
+    });
+
+    it("should not mutate the original YAML file", () => {
+      const beforeYaml =
+        `
+foo: unchanged
+bar: before
+`.trim() + "\n";
+
+      fs.writeFileSync(tempFile, beforeYaml);
+      const onDiskBefore = fs.readFileSync(tempFile, "utf8");
+
+      const obj = { bar: "after" };
+      ymlParser.stringify(obj, tempFile);
+
+      const onDiskAfter = fs.readFileSync(tempFile, "utf8");
+      expect(onDiskAfter).toBe(onDiskBefore); // file on disk unchanged
+    });
+  });
+});