@featurevisor/core 2.7.0 → 2.9.0

package/lib/parsers/json.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/parsers/json.spec.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const json_1 = require("./json");
+describe("core :: parser :: jsonParser", () => {
+    it("should parse JSON string into object", () => {
+        const jsonString = '{"foo":1,"bar":"baz","arr":[1,2]}';
+        const result = json_1.jsonParser.parse(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 = json_1.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 = json_1.jsonParser.stringify(original);
+        const reparsed = json_1.jsonParser.parse(str);
+        expect(reparsed).toEqual(original);
+    });
+    it("should throw if invalid JSON string is provided to parse", () => {
+        expect(() => {
+            json_1.jsonParser.parse("this is not json");
+        }).toThrow();
+    });
+});
+//# sourceMappingURL=json.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.spec.js","sourceRoot":"","sources":["../../src/parsers/json.spec.ts"],"names":[],"mappings":";;AAAA,iCAAoC;AAEpC,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,UAAU,GAAG,mCAAmC,CAAC;QACvD,MAAM,MAAM,GAAG,iBAAU,CAAC,KAAK,CAA8C,UAAU,CAAC,CAAC;QACzF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,iBAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG;;;;;;;EAOzB,CAAC;QACC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;QACxF,MAAM,GAAG,GAAG,iBAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,iBAAU,CAAC,KAAK,CAAkB,GAAG,CAAC,CAAC;QACxD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,EAAE;YACV,iBAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/parsers/yml.d.ts

@@ -0,0 +1,2 @@
+import type { CustomParser } from "./index";
+export declare const ymlParser: CustomParser;

package/lib/parsers/yml.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ymlParser = void 0;
+const fs = require("fs");
+const yaml_1 = require("yaml");
+const types_1 = require("yaml/types");
+function getKeyString(keyNode) {
+    if (keyNode == null)
+        return undefined;
+    if (typeof keyNode.value !== "undefined") {
+        return String(keyNode.value);
+    }
+    return typeof keyNode === "string" ? keyNode : undefined;
+}
+function copyComments(source, target) {
+    if (source.comment != null)
+        target.comment = source.comment;
+    if (source.commentBefore != null)
+        target.commentBefore = source.commentBefore;
+    const srcVal = source.value;
+    const tgtVal = target.value;
+    if (srcVal && tgtVal && typeof tgtVal === "object" && tgtVal !== null) {
+        const t = tgtVal;
+        if (srcVal.comment != null)
+            t.comment = srcVal.comment;
+        if (srcVal.commentBefore != null)
+            t.commentBefore = srcVal.commentBefore;
+    }
+}
+function isYamlMap(node) {
+    return node != null && typeof node === "object" && Array.isArray(node.items);
+}
+function isYamlSeq(node) {
+    return node != null && typeof node === "object" && Array.isArray(node.items);
+}
+function seqItemValueKey(item) {
+    if (item == null)
+        return String(item);
+    const n = item;
+    if (typeof n.value !== "undefined")
+        return JSON.stringify(n.value);
+    if (typeof n.toJSON === "function")
+        return JSON.stringify(n.toJSON());
+    return JSON.stringify(item);
+}
+function primitiveValueKey(v) {
+    return JSON.stringify(v);
+}
+function createValueWithComments(schema, oldNode, newValue) {
+    if (newValue === null || typeof newValue !== "object") {
+        const node = new types_1.Scalar(newValue);
+        const old = oldNode;
+        if (old) {
+            if (old.comment != null)
+                node.comment = old.comment;
+            if (old.commentBefore != null)
+                node.commentBefore = old.commentBefore;
+        }
+        return node;
+    }
+    if (Array.isArray(newValue)) {
+        const oldSeq = isYamlSeq(oldNode) ? oldNode : null;
+        const oldItemsByValue = new Map();
+        if (oldSeq && oldSeq.items) {
+            for (const item of oldSeq.items) {
+                oldItemsByValue.set(seqItemValueKey(item), item);
+            }
+        }
+        const newSeq = schema.createNode([]);
+        for (const el of newValue) {
+            const oldItem = oldItemsByValue.get(primitiveValueKey(el));
+            const itemNode = createValueWithComments(schema, oldItem, el);
+            newSeq.add(itemNode);
+        }
+        return newSeq;
+    }
+    // newValue is a plain object; preserve comments from old map if present
+    const oldMap = isYamlMap(oldNode) ? oldNode : null;
+    const oldPairsByKey = new Map();
+    if (oldMap) {
+        for (const pair of (oldMap.items || [])) {
+            const keyStr = getKeyString(pair.key);
+            if (keyStr !== undefined)
+                oldPairsByKey.set(keyStr, pair);
+        }
+    }
+    const newMap = schema.createNode({});
+    const obj = newValue;
+    for (const k of Object.keys(obj)) {
+        const oldPair = oldPairsByKey.get(k);
+        const childOldNode = oldPair ? oldPair.value : undefined;
+        const childNewValue = createValueWithComments(schema, childOldNode, obj[k]);
+        const newPair = schema.createPair(k, childNewValue);
+        if (oldPair)
+            copyComments(oldPair, newPair);
+        newMap.add(newPair);
+    }
+    const result = newMap;
+    const oldVal = oldNode;
+    if (oldVal && result) {
+        if (oldVal.comment != null)
+            result.comment = oldVal.comment;
+        if (oldVal.commentBefore != null)
+            result.commentBefore = oldVal.commentBefore;
+    }
+    return result;
+}
+function replaceContentsPreservingComments(doc, newContent) {
+    const oldRoot = doc.contents;
+    if (!oldRoot || !Array.isArray(oldRoot.items)) {
+        doc.contents = doc.schema.createNode(newContent);
+        return;
+    }
+    const schema = doc.schema;
+    const oldPairsByKey = new Map();
+    for (const pair of oldRoot.items) {
+        const keyStr = getKeyString(pair.key);
+        if (keyStr !== undefined)
+            oldPairsByKey.set(keyStr, pair);
+    }
+    const newMap = schema.createNode({});
+    for (const key of Object.keys(newContent)) {
+        const oldPair = oldPairsByKey.get(key);
+        const valueNode = createValueWithComments(schema, oldPair?.value, newContent[key]);
+        const newPair = schema.createPair(key, valueNode);
+        if (oldPair)
+            copyComments(oldPair, newPair);
+        newMap.add(newPair);
+    }
+    doc.contents = newMap;
+}
+exports.ymlParser = {
+    extension: "yml",
+    parse: function (content) {
+        return (0, yaml_1.parse)(content);
+    },
+    stringify: function (content, filePath) {
+        if (!filePath || !fs.existsSync(filePath)) {
+            return (0, yaml_1.stringify)(content);
+        }
+        const fileContent = fs.readFileSync(filePath, "utf8");
+        if (!fileContent.trim()) {
+            return (0, yaml_1.stringify)(content);
+        }
+        // newObject is the final saved object; existing file is only for ordering/comments
+        if (content === null || typeof content !== "object" || Array.isArray(content)) {
+            throw new Error("Cannot set root document to a primitive value");
+        }
+        const doc = (0, yaml_1.parseDocument)(fileContent);
+        replaceContentsPreservingComments(doc, content);
+        return doc.toString();
+    },
+};
+//# sourceMappingURL=yml.js.map

package/lib/parsers/yml.js.map

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

package/lib/parsers/yml.spec.d.ts

@@ -0,0 +1 @@
+export {};

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.9.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,14 +44,10 @@
     "@featurevisor/site": "2.7.0",
     "@featurevisor/types": "2.7.0",
     "axios": "^1.3.4",
-    "js-yaml": "^4.1.0",
-    "tar": "^6.1.13",
+    "tar": "^7.5.7",
+    "yaml": "^1.10.2",
     "yargs": "^17.7.2",
     "zod": "^3.22.4"
   },
-  "devDependencies": {
-    "@types/js-yaml": "^4.0.5",
-    "@types/tar": "^6.1.4"
-  },
-  "gitHead": "aebf65e5be80d1f8a67453e45b4609af2490103e"
+  "gitHead": "2cb1e557e83348b80b15fc5c5362b8445349d045"
 }

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);
+  },
+};