@featurevisor/core 0.33.0 → 0.34.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.34.0](https://github.com/fahad19/featurevisor/compare/v0.33.1...v0.34.0) (2023-07-08)
+
+
+### Features
+
+* code generation ([#98](https://github.com/fahad19/featurevisor/issues/98)) ([7474443](https://github.com/fahad19/featurevisor/commit/7474443d26fd526f471ef5258cbe39b42c0fad60))
+
+
+
+
+
 # [0.33.0](https://github.com/fahad19/featurevisor/compare/v0.32.1...v0.33.0) (2023-07-06)
 
 **Note:** Version bump only for package @featurevisor/core

package/coverage/clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1688672127151" clover="3.2.0">
-  <project timestamp="1688672127151" name="All files">
+<coverage generated="1688829810488" clover="3.2.0">
+  <project timestamp="1688829810488" name="All files">
     <metrics statements="169" coveredstatements="161" conditionals="75" coveredconditionals="62" methods="28" coveredmethods="28" elements="272" coveredelements="251" complexity="0" loc="169" ncloc="169" packages="2" files="4" classes="4"/>
     <package name="lib">
       <metrics statements="88" coveredstatements="84" conditionals="42" coveredconditionals="35" methods="14" coveredmethods="14"/>

package/coverage/lcov-report/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/lib/allocator.js.html

@@ -175,7 +175,7 @@ exports.getUpdatedAvailableRangesAfterFilling = getUpdatedAvailableRangesAfterFi
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/lib/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/lib/traffic.js.html

@@ -427,7 +427,7 @@ exports.getTraffic = getTraffic;
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/allocator.ts.html

@@ -193,7 +193,7 @@ export function getUpdatedAvailableRangesAfterFilling(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/traffic.ts.html

@@ -535,7 +535,7 @@ export function getTraffic(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2023-07-06T19:35:27.123Z
+                at 2023-07-08T15:23:30.468Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/lib/generate-code/index.d.ts

@@ -0,0 +1,7 @@
+import { ProjectConfig } from "../config";
+export declare const ALLOWED_LANGUAGES_FOR_CODE_GENERATION: string[];
+export interface GenerateCodeCLIOptions {
+    language: string;
+    outDir: string;
+}
+export declare function generateCodeForProject(rootDirectoryPath: any, projectConfig: ProjectConfig, cliOptions: GenerateCodeCLIOptions): void;

package/lib/generate-code/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCodeForProject = exports.ALLOWED_LANGUAGES_FOR_CODE_GENERATION = void 0;
+var fs = require("fs");
+var path = require("path");
+var mkdirp = require("mkdirp");
+var typescript_1 = require("./typescript");
+exports.ALLOWED_LANGUAGES_FOR_CODE_GENERATION = ["typescript"];
+function generateCodeForProject(rootDirectoryPath, projectConfig, cliOptions) {
+    if (!cliOptions.language) {
+        throw new Error("Option `--language` is required");
+    }
+    if (!cliOptions.outDir) {
+        throw new Error("Option `--out-dir` is required");
+    }
+    var absolutePath = path.resolve(rootDirectoryPath, cliOptions.outDir);
+    if (!fs.existsSync(absolutePath)) {
+        console.log("Creating output directory: ".concat(absolutePath));
+        mkdirp.sync(absolutePath);
+    }
+    else {
+        console.log("Output directory already exists at: ".concat(absolutePath));
+    }
+    if (!exports.ALLOWED_LANGUAGES_FOR_CODE_GENERATION.includes(cliOptions.language)) {
+        console.log("Only these languages are supported: ".concat(exports.ALLOWED_LANGUAGES_FOR_CODE_GENERATION.join(", ")));
+        throw new Error("Language ".concat(cliOptions.language, " is not supported for code generation"));
+    }
+    if (cliOptions.language === "typescript") {
+        return (0, typescript_1.generateTypeScriptCodeForProject)(rootDirectoryPath, projectConfig, absolutePath);
+    }
+    throw new Error("Language ".concat(cliOptions.language, " is not supported"));
+}
+exports.generateCodeForProject = generateCodeForProject;
+//# sourceMappingURL=index.js.map

package/lib/generate-code/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generate-code/index.ts"],"names":[],"mappings":";;;AAAA,uBAAyB;AACzB,2BAA6B;AAE7B,+BAAiC;AAGjC,2CAAgE;AAEnD,QAAA,qCAAqC,GAAG,CAAC,YAAY,CAAC,CAAC;AAOpE,SAAgB,sBAAsB,CACpC,iBAAiB,EACjB,aAA4B,EAC5B,UAAkC;IAElC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;KACpD;IAED,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;KACnD;IAED,IAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAExE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;QAChC,OAAO,CAAC,GAAG,CAAC,qCAA8B,YAAY,CAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;KAC3B;SAAM;QACL,OAAO,CAAC,GAAG,CAAC,8CAAuC,YAAY,CAAE,CAAC,CAAC;KACpE;IAED,IAAI,CAAC,6CAAqC,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;QACxE,OAAO,CAAC,GAAG,CACT,8CAAuC,6CAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAE,CAC1F,CAAC;QAEF,MAAM,IAAI,KAAK,CAAC,mBAAY,UAAU,CAAC,QAAQ,0CAAuC,CAAC,CAAC;KACzF;IAED,IAAI,UAAU,CAAC,QAAQ,KAAK,YAAY,EAAE;QACxC,OAAO,IAAA,6CAAgC,EAAC,iBAAiB,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;KACzF;IAED,MAAM,IAAI,KAAK,CAAC,mBAAY,UAAU,CAAC,QAAQ,sBAAmB,CAAC,CAAC;AACtE,CAAC;AAnCD,wDAmCC"}

package/lib/generate-code/typescript.d.ts

@@ -0,0 +1,2 @@
+import { ProjectConfig } from "../config";
+export declare function generateTypeScriptCodeForProject(rootDirectoryPath: string, projectConfig: ProjectConfig, outputPath: string): void;

package/lib/generate-code/typescript.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTypeScriptCodeForProject = void 0;
+var fs = require("fs");
+var path = require("path");
+var utils_1 = require("../utils");
+function convertFeaturevisorTypeToTypeScriptType(featurevisorType) {
+    switch (featurevisorType) {
+        case "boolean":
+            return "boolean";
+        case "string":
+            return "string";
+        case "integer":
+            return "number";
+        case "double":
+            return "number";
+        case "date":
+            return "Date | string";
+        case "array":
+            return "string[]";
+        case "object":
+            return "any"; // @TODO: do a flat dictionary
+        case "json":
+            return "any";
+        default:
+            throw new Error("Unknown type: ".concat(featurevisorType));
+    }
+}
+function getPascalCase(str) {
+    // Remove special characters and split the string into an array of words
+    var words = str.replace(/[^a-zA-Z0-9]/g, " ").split(" ");
+    // Capitalize the first letter of each word and join them together
+    var pascalCased = words.map(function (word) { return word.charAt(0).toUpperCase() + word.slice(1); }).join("");
+    return pascalCased;
+}
+function getFeaturevisorTypeFromValue(value) {
+    if (typeof value === "boolean") {
+        return "boolean";
+    }
+    if (typeof value === "string") {
+        return "string";
+    }
+    if (typeof value === "number") {
+        if (Number.isInteger(value)) {
+            return "integer";
+        }
+        return "double";
+    }
+    if (value instanceof Date) {
+        return "date";
+    }
+    throw new Error("Could not detect Featurevisor type from value");
+}
+var instanceSnippet = "\nimport { FeaturevisorInstance } from \"@featurevisor/sdk\";\n\nlet _instance: FeaturevisorInstance;\n\nexport function setInstance(instance: FeaturevisorInstance) {\n  _instance = instance;\n}\n\nexport function getInstance(): FeaturevisorInstance {\n  return _instance as FeaturevisorInstance;\n}\n".trimStart();
+function generateTypeScriptCodeForProject(rootDirectoryPath, projectConfig, outputPath) {
+    console.log("Generating TypeScript code...");
+    // instance
+    var instanceFilePath = path.join(outputPath, "instance.ts");
+    fs.writeFileSync(instanceFilePath, instanceSnippet);
+    console.log("Instance file written at: ".concat(instanceFilePath));
+    // attributes
+    var attributeFiles = (0, utils_1.getYAMLFiles)(projectConfig.attributesDirectoryPath);
+    var attributes = attributeFiles
+        .map(function (attributeFile) {
+        var parsedAttribute = (0, utils_1.parseYaml)(fs.readFileSync(attributeFile, "utf8"));
+        var attributeKey = path.basename(attributeFile, ".yml");
+        return {
+            archived: parsedAttribute.archived,
+            key: attributeKey,
+            type: parsedAttribute.type,
+            typescriptType: convertFeaturevisorTypeToTypeScriptType(parsedAttribute.type),
+        };
+    })
+        .filter(function (attribute) {
+        if (typeof attribute.archived === "undefined") {
+            return true;
+        }
+        return !attribute.archived;
+    });
+    var attributeProperties = attributes
+        .map(function (attribute) {
+        return "  ".concat(attribute.key, "?: ").concat(attribute.typescriptType, ";");
+    })
+        .join("\n");
+    var attributesContent = "\nimport { AttributeKey, AttributeValue } from \"@featurevisor/types\";\n\nexport interface Attributes {\n".concat(attributeProperties, "\n  [key: AttributeKey]: AttributeValue;\n}\n").trimStart();
+    var attributesTypeFilePath = path.join(outputPath, "Attributes.ts");
+    fs.writeFileSync(attributesTypeFilePath, attributesContent);
+    console.log("Attributes type file written at: ".concat(attributesTypeFilePath));
+    // features
+    var featureNamespaces = [];
+    var featureFiles = (0, utils_1.getYAMLFiles)(projectConfig.featuresDirectoryPath);
+    for (var _i = 0, featureFiles_1 = featureFiles; _i < featureFiles_1.length; _i++) {
+        var featureFile = featureFiles_1[_i];
+        var featureKey = path.basename(featureFile, ".yml");
+        var parsedFeature = (0, utils_1.parseYaml)(fs.readFileSync(featureFile, "utf8"));
+        var variationType = getFeaturevisorTypeFromValue(parsedFeature.defaultVariation);
+        var variationTypeScriptType = convertFeaturevisorTypeToTypeScriptType(variationType);
+        if (typeof parsedFeature.archived !== "undefined" && parsedFeature.archived) {
+            continue;
+        }
+        var namespaceValue = getPascalCase(featureKey) + "Feature";
+        featureNamespaces.push(namespaceValue);
+        var variableMethods = "";
+        if (parsedFeature.variablesSchema) {
+            for (var _a = 0, _b = parsedFeature.variablesSchema; _a < _b.length; _a++) {
+                var variableSchema = _b[_a];
+                var variableKey = variableSchema.key;
+                var variableType = variableSchema.type;
+                var internalMethodName = "getVariable".concat(variableType === "json" ? "JSON" : getPascalCase(variableType));
+                if (variableType === "json" || variableType === "object") {
+                    variableMethods += "\n\n  export function get".concat(getPascalCase(variableKey), "<T>(attributes: Attributes = {}) {\n    return getInstance().").concat(internalMethodName, "<T>(key, \"").concat(variableKey, "\", attributes);\n  }");
+                }
+                else {
+                    variableMethods += "\n\n  export function get".concat(getPascalCase(variableKey), "(attributes: Attributes = {}) {\n    return getInstance().").concat(internalMethodName, "(key, \"").concat(variableKey, "\", attributes);\n  }");
+                }
+            }
+        }
+        var featureContent = "\nimport { Attributes } from \"./Attributes\";\nimport { getInstance } from \"./instance\";\n\nexport namespace ".concat(namespaceValue, " {\n  export const key = \"").concat(featureKey, "\";\n\n  export function getVariation(attributes: Attributes = {}) {\n    return getInstance().getVariation").concat(getPascalCase(variationType), "(key, attributes);\n  }").concat(variableMethods, "\n}\n").trimStart();
+        var featureNamespaceFilePath = path.join(outputPath, "".concat(namespaceValue, ".ts"));
+        fs.writeFileSync(featureNamespaceFilePath, featureContent);
+        console.log("Feature ".concat(featureKey, " file written at: ").concat(featureNamespaceFilePath));
+    }
+    // index
+    var indexContent = ["export * from \"./Attributes\";", "export * from \"./instance\";"]
+        .concat(featureNamespaces.map(function (featureNamespace) {
+        return "export * from \"./".concat(featureNamespace, "\";");
+    }))
+        .join("\n") + "\n";
+    var indexFilePath = path.join(outputPath, "index.ts");
+    fs.writeFileSync(indexFilePath, indexContent);
+    console.log("Index file written at: ".concat(indexFilePath));
+}
+exports.generateTypeScriptCodeForProject = generateTypeScriptCodeForProject;
+//# sourceMappingURL=typescript.js.map

package/lib/generate-code/typescript.js.map

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

package/lib/index.d.ts

@@ -4,3 +4,4 @@ export * from "./builder";
 export * from "./tester";
 export * from "./init";
 export * from "./site";
+export * from "./generate-code";

package/lib/index.js

@@ -20,4 +20,5 @@ __exportStar(require("./builder"), exports);
 __exportStar(require("./tester"), exports);
 __exportStar(require("./init"), exports);
 __exportStar(require("./site"), exports);
+__exportStar(require("./generate-code"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,yCAAuB;AACvB,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,yCAAuB;AACvB,yCAAuB;AACvB,kDAAgC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -41,9 +41,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@featurevisor/sdk": "^0.33.0",
-    "@featurevisor/site": "^0.33.0",
-    "@featurevisor/types": "^0.33.0",
+    "@featurevisor/sdk": "^0.34.0",
+    "@featurevisor/site": "^0.34.0",
+    "@featurevisor/types": "^0.34.0",
     "axios": "^1.3.4",
     "joi": "^17.8.3",
     "js-yaml": "^4.1.0",
@@ -54,5 +54,5 @@
     "@types/js-yaml": "^4.0.5",
     "@types/tar": "^6.1.4"
   },
-  "gitHead": "a03246983110e5e83432b0a90849aece2fae1512"
+  "gitHead": "202f481ab6230534d224192bd7d170779ac399f8"
 }

package/src/generate-code/index.ts

@@ -0,0 +1,51 @@
+import * as fs from "fs";
+import * as path from "path";
+
+import * as mkdirp from "mkdirp";
+
+import { ProjectConfig } from "../config";
+import { generateTypeScriptCodeForProject } from "./typescript";
+
+export const ALLOWED_LANGUAGES_FOR_CODE_GENERATION = ["typescript"];
+
+export interface GenerateCodeCLIOptions {
+  language: string;
+  outDir: string;
+}
+
+export function generateCodeForProject(
+  rootDirectoryPath,
+  projectConfig: ProjectConfig,
+  cliOptions: GenerateCodeCLIOptions,
+) {
+  if (!cliOptions.language) {
+    throw new Error("Option `--language` is required");
+  }
+
+  if (!cliOptions.outDir) {
+    throw new Error("Option `--out-dir` is required");
+  }
+
+  const absolutePath = path.resolve(rootDirectoryPath, cliOptions.outDir);
+
+  if (!fs.existsSync(absolutePath)) {
+    console.log(`Creating output directory: ${absolutePath}`);
+    mkdirp.sync(absolutePath);
+  } else {
+    console.log(`Output directory already exists at: ${absolutePath}`);
+  }
+
+  if (!ALLOWED_LANGUAGES_FOR_CODE_GENERATION.includes(cliOptions.language)) {
+    console.log(
+      `Only these languages are supported: ${ALLOWED_LANGUAGES_FOR_CODE_GENERATION.join(", ")}`,
+    );
+
+    throw new Error(`Language ${cliOptions.language} is not supported for code generation`);
+  }
+
+  if (cliOptions.language === "typescript") {
+    return generateTypeScriptCodeForProject(rootDirectoryPath, projectConfig, absolutePath);
+  }
+
+  throw new Error(`Language ${cliOptions.language} is not supported`);
+}

package/src/generate-code/typescript.ts

@@ -0,0 +1,207 @@
+import * as fs from "fs";
+import * as path from "path";
+
+import { Attribute, ParsedFeature } from "@featurevisor/types";
+
+import { ProjectConfig } from "../config";
+import { getYAMLFiles, parseYaml } from "../utils";
+
+function convertFeaturevisorTypeToTypeScriptType(featurevisorType: string) {
+  switch (featurevisorType) {
+    case "boolean":
+      return "boolean";
+    case "string":
+      return "string";
+    case "integer":
+      return "number";
+    case "double":
+      return "number";
+    case "date":
+      return "Date | string";
+    case "array":
+      return "string[]";
+    case "object":
+      return "any"; // @TODO: do a flat dictionary
+    case "json":
+      return "any";
+    default:
+      throw new Error(`Unknown type: ${featurevisorType}`);
+  }
+}
+
+function getPascalCase(str) {
+  // Remove special characters and split the string into an array of words
+  const words = str.replace(/[^a-zA-Z0-9]/g, " ").split(" ");
+
+  // Capitalize the first letter of each word and join them together
+  const pascalCased = words.map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+
+  return pascalCased;
+}
+
+function getFeaturevisorTypeFromValue(value) {
+  if (typeof value === "boolean") {
+    return "boolean";
+  }
+
+  if (typeof value === "string") {
+    return "string";
+  }
+
+  if (typeof value === "number") {
+    if (Number.isInteger(value)) {
+      return "integer";
+    }
+
+    return "double";
+  }
+
+  if (value instanceof Date) {
+    return "date";
+  }
+
+  throw new Error("Could not detect Featurevisor type from value");
+}
+
+const instanceSnippet = `
+import { FeaturevisorInstance } from "@featurevisor/sdk";
+
+let _instance: FeaturevisorInstance;
+
+export function setInstance(instance: FeaturevisorInstance) {
+  _instance = instance;
+}
+
+export function getInstance(): FeaturevisorInstance {
+  return _instance as FeaturevisorInstance;
+}
+`.trimStart();
+
+export function generateTypeScriptCodeForProject(
+  rootDirectoryPath: string,
+  projectConfig: ProjectConfig,
+  outputPath: string,
+) {
+  console.log("Generating TypeScript code...");
+
+  // instance
+  const instanceFilePath = path.join(outputPath, "instance.ts");
+  fs.writeFileSync(instanceFilePath, instanceSnippet);
+  console.log(`Instance file written at: ${instanceFilePath}`);
+
+  // attributes
+  const attributeFiles = getYAMLFiles(projectConfig.attributesDirectoryPath);
+  const attributes = attributeFiles
+    .map((attributeFile) => {
+      const parsedAttribute = parseYaml(fs.readFileSync(attributeFile, "utf8")) as Attribute;
+
+      const attributeKey = path.basename(attributeFile, ".yml");
+
+      return {
+        archived: parsedAttribute.archived,
+        key: attributeKey,
+        type: parsedAttribute.type,
+        typescriptType: convertFeaturevisorTypeToTypeScriptType(parsedAttribute.type),
+      };
+    })
+    .filter((attribute) => {
+      if (typeof attribute.archived === "undefined") {
+        return true;
+      }
+
+      return !attribute.archived;
+    });
+
+  const attributeProperties = attributes
+    .map((attribute) => {
+      return `  ${attribute.key}?: ${attribute.typescriptType};`;
+    })
+    .join("\n");
+  const attributesContent = `
+import { AttributeKey, AttributeValue } from "@featurevisor/types";
+
+export interface Attributes {
+${attributeProperties}
+  [key: AttributeKey]: AttributeValue;
+}
+`.trimStart();
+
+  const attributesTypeFilePath = path.join(outputPath, "Attributes.ts");
+  fs.writeFileSync(attributesTypeFilePath, attributesContent);
+  console.log(`Attributes type file written at: ${attributesTypeFilePath}`);
+
+  // features
+  const featureNamespaces: string[] = [];
+  const featureFiles = getYAMLFiles(projectConfig.featuresDirectoryPath);
+  for (const featureFile of featureFiles) {
+    const featureKey = path.basename(featureFile, ".yml");
+    const parsedFeature = parseYaml(fs.readFileSync(featureFile, "utf8")) as ParsedFeature;
+
+    const variationType = getFeaturevisorTypeFromValue(parsedFeature.defaultVariation);
+    const variationTypeScriptType = convertFeaturevisorTypeToTypeScriptType(variationType);
+
+    if (typeof parsedFeature.archived !== "undefined" && parsedFeature.archived) {
+      continue;
+    }
+
+    const namespaceValue = getPascalCase(featureKey) + "Feature";
+    featureNamespaces.push(namespaceValue);
+
+    let variableMethods = "";
+
+    if (parsedFeature.variablesSchema) {
+      for (const variableSchema of parsedFeature.variablesSchema) {
+        const variableKey = variableSchema.key;
+        const variableType = variableSchema.type;
+
+        const internalMethodName = `getVariable${
+          variableType === "json" ? "JSON" : getPascalCase(variableType)
+        }`;
+
+        if (variableType === "json" || variableType === "object") {
+          variableMethods += `
+
+  export function get${getPascalCase(variableKey)}<T>(attributes: Attributes = {}) {
+    return getInstance().${internalMethodName}<T>(key, "${variableKey}", attributes);
+  }`;
+        } else {
+          variableMethods += `
+
+  export function get${getPascalCase(variableKey)}(attributes: Attributes = {}) {
+    return getInstance().${internalMethodName}(key, "${variableKey}", attributes);
+  }`;
+        }
+      }
+    }
+
+    const featureContent = `
+import { Attributes } from "./Attributes";
+import { getInstance } from "./instance";
+
+export namespace ${namespaceValue} {
+  export const key = "${featureKey}";
+
+  export function getVariation(attributes: Attributes = {}) {
+    return getInstance().getVariation${getPascalCase(variationType)}(key, attributes);
+  }${variableMethods}
+}
+`.trimStart();
+
+    const featureNamespaceFilePath = path.join(outputPath, `${namespaceValue}.ts`);
+    fs.writeFileSync(featureNamespaceFilePath, featureContent);
+    console.log(`Feature ${featureKey} file written at: ${featureNamespaceFilePath}`);
+  }
+
+  // index
+  const indexContent =
+    [`export * from "./Attributes";`, `export * from "./instance";`]
+      .concat(
+        featureNamespaces.map((featureNamespace) => {
+          return `export * from "./${featureNamespace}";`;
+        }),
+      )
+      .join("\n") + "\n";
+  const indexFilePath = path.join(outputPath, "index.ts");
+  fs.writeFileSync(indexFilePath, indexContent);
+  console.log(`Index file written at: ${indexFilePath}`);
+}

package/src/index.ts

@@ -4,3 +4,4 @@ export * from "./builder";
 export * from "./tester";
 export * from "./init";
 export * from "./site";
+export * from "./generate-code";