@featurevisor/core 0.52.0 → 0.52.1

package/lib/site/getRepoDetails.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRepoDetails = void 0;
+var child_process_1 = require("child_process");
+var getOwnerAndRepoFromUrl_1 = require("./getOwnerAndRepoFromUrl");
+function getRepoDetails() {
+    try {
+        var topLevelPathOutput = (0, child_process_1.execSync)("git rev-parse --show-toplevel");
+        var topLevelPath = topLevelPathOutput.toString().trim();
+        var remoteUrlOutput = (0, child_process_1.execSync)("git remote get-url origin");
+        var remoteUrl = remoteUrlOutput.toString().trim();
+        var branchOutput = (0, child_process_1.execSync)("git rev-parse --abbrev-ref HEAD");
+        var branch = branchOutput.toString().trim();
+        if (!remoteUrl || !branch) {
+            return;
+        }
+        var _a = (0, getOwnerAndRepoFromUrl_1.getOwnerAndRepoFromUrl)(remoteUrl), owner = _a.owner, repo = _a.repo;
+        if (!owner || !repo) {
+            return;
+        }
+        var blobUrl = void 0;
+        var commitUrl = void 0;
+        if (remoteUrl.indexOf("github.com") > -1) {
+            blobUrl = "https://github.com/".concat(owner, "/").concat(repo, "/blob/").concat(branch, "/{{blobPath}}");
+            commitUrl = "https://github.com/".concat(owner, "/").concat(repo, "/commit/{{hash}}");
+        }
+        else if (remoteUrl.indexOf("bitbucket.org") > -1) {
+            blobUrl = "https://bitbucket.org/".concat(owner, "/").concat(repo, "/src/").concat(branch, "/{{blobPath}}");
+            commitUrl = "https://bitbucket.org/".concat(owner, "/").concat(repo, "/commits/{{hash}}");
+        }
+        if (!blobUrl || !commitUrl) {
+            return;
+        }
+        return {
+            branch: branch,
+            remoteUrl: remoteUrl,
+            blobUrl: blobUrl,
+            commitUrl: commitUrl,
+            topLevelPath: topLevelPath,
+        };
+    }
+    catch (e) {
+        console.error(e);
+        return;
+    }
+    return;
+}
+exports.getRepoDetails = getRepoDetails;
+//# sourceMappingURL=getRepoDetails.js.map

package/lib/site/getRepoDetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRepoDetails.js","sourceRoot":"","sources":["../../src/site/getRepoDetails.ts"],"names":[],"mappings":";;;AAAA,+CAAyC;AAEzC,mEAAkE;AAUlE,SAAgB,cAAc;IAC5B,IAAI;QACF,IAAM,kBAAkB,GAAG,IAAA,wBAAQ,EAAC,+BAA+B,CAAC,CAAC;QACrE,IAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAE1D,IAAM,eAAe,GAAG,IAAA,wBAAQ,EAAC,2BAA2B,CAAC,CAAC;QAC9D,IAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAEpD,IAAM,YAAY,GAAG,IAAA,wBAAQ,EAAC,iCAAiC,CAAC,CAAC;QACjE,IAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAE9C,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE;YACzB,OAAO;SACR;QAEK,IAAA,KAAkB,IAAA,+CAAsB,EAAC,SAAS,CAAC,EAAjD,KAAK,WAAA,EAAE,IAAI,UAAsC,CAAC;QAE1D,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE;YACnB,OAAO;SACR;QAED,IAAI,OAAO,SAAA,CAAC;QACZ,IAAI,SAAS,SAAA,CAAC;QAEd,IAAI,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE;YACxC,OAAO,GAAG,6BAAsB,KAAK,cAAI,IAAI,mBAAS,MAAM,kBAAe,CAAC;YAC5E,SAAS,GAAG,6BAAsB,KAAK,cAAI,IAAI,qBAAkB,CAAC;SACnE;aAAM,IAAI,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE;YAClD,OAAO,GAAG,gCAAyB,KAAK,cAAI,IAAI,kBAAQ,MAAM,kBAAe,CAAC;YAC9E,SAAS,GAAG,gCAAyB,KAAK,cAAI,IAAI,sBAAmB,CAAC;SACvE;QAED,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE;YAC1B,OAAO;SACR;QAED,OAAO;YACL,MAAM,QAAA;YACN,SAAS,WAAA;YACT,OAAO,SAAA;YACP,SAAS,WAAA;YACT,YAAY,cAAA;SACb,CAAC;KACH;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO;KACR;IAED,OAAO;AACT,CAAC;AAjDD,wCAiDC"}

package/lib/site/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./exportSite";
+export * from "./serveSite";

package/lib/site/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./exportSite"), exports);
+__exportStar(require("./serveSite"), exports);
+//# sourceMappingURL=index.js.map

package/lib/site/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/site/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,8CAA4B"}

package/lib/site/serveSite.d.ts

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

package/lib/site/serveSite.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveSite = void 0;
+var fs = require("fs");
+var path = require("path");
+var http = require("http");
+function serveSite(rootDirectoryPath, projectConfig, options) {
+    if (options === void 0) { options = {}; }
+    var port = options.p || 3000;
+    http
+        .createServer(function (request, response) {
+        var requestedUrl = request.url;
+        var filePath = requestedUrl === "/"
+            ? path.join(projectConfig.siteExportDirectoryPath, "index.html")
+            : path.join(projectConfig.siteExportDirectoryPath, requestedUrl);
+        console.log("requesting: " + filePath + "");
+        var extname = path.extname(filePath);
+        var contentType = "text/html";
+        switch (extname) {
+            case ".js":
+                contentType = "text/javascript";
+                break;
+            case ".css":
+                contentType = "text/css";
+                break;
+            case ".json":
+                contentType = "application/json";
+                break;
+            case ".png":
+                contentType = "image/png";
+                break;
+        }
+        fs.readFile(filePath, function (error, content) {
+            if (error) {
+                if (error.code == "ENOENT") {
+                    response.writeHead(404, { "Content-Type": "text/html" });
+                    response.end("404 Not Found", "utf-8");
+                }
+                else {
+                    response.writeHead(500);
+                    response.end("Error 500: " + error.code);
+                    response.end();
+                }
+            }
+            else {
+                response.writeHead(200, { "Content-Type": contentType });
+                response.end(content, "utf-8");
+            }
+        });
+    })
+        .listen(port);
+    console.log("Server running at http://127.0.0.1:".concat(port, "/"));
+}
+exports.serveSite = serveSite;
+//# sourceMappingURL=serveSite.js.map

package/lib/site/serveSite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveSite.js","sourceRoot":"","sources":["../../src/site/serveSite.ts"],"names":[],"mappings":";;;AAAA,uBAAyB;AACzB,2BAA6B;AAC7B,2BAA6B;AAI7B,SAAgB,SAAS,CACvB,iBAAyB,EACzB,aAA4B,EAC5B,OAAiB;IAAjB,wBAAA,EAAA,YAAiB;IAEjB,IAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;IAE/B,IAAI;SACD,YAAY,CAAC,UAAU,OAAO,EAAE,QAAQ;QACvC,IAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;QACjC,IAAM,QAAQ,GACZ,YAAY,KAAK,GAAG;YAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,uBAAuB,EAAE,YAAY,CAAC;YAChE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,uBAAuB,EAAE,YAAsB,CAAC,CAAC;QAE/E,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;QAE5C,IAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,WAAW,GAAG,WAAW,CAAC;QAC9B,QAAQ,OAAO,EAAE;YACf,KAAK,KAAK;gBACR,WAAW,GAAG,iBAAiB,CAAC;gBAChC,MAAM;YACR,KAAK,MAAM;gBACT,WAAW,GAAG,UAAU,CAAC;gBACzB,MAAM;YACR,KAAK,OAAO;gBACV,WAAW,GAAG,kBAAkB,CAAC;gBACjC,MAAM;YACR,KAAK,MAAM;gBACT,WAAW,GAAG,WAAW,CAAC;gBAC1B,MAAM;SACT;QAED,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,KAAK,EAAE,OAAO;YAC5C,IAAI,KAAK,EAAE;gBACT,IAAI,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE;oBAC1B,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;oBACzD,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;iBACxC;qBAAM;oBACL,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBACxB,QAAQ,CAAC,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;oBACzC,QAAQ,CAAC,GAAG,EAAE,CAAC;iBAChB;aACF;iBAAM;gBACL,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;gBACzD,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;aAChC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,6CAAsC,IAAI,MAAG,CAAC,CAAC;AAC7D,CAAC;AArDD,8BAqDC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featurevisor/core",
-  "version": "0.52.0",
+  "version": "0.52.1",
   "description": "Core package of Featurevisor for Node.js usage",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -57,5 +57,5 @@
     "@types/js-yaml": "^4.0.5",
     "@types/tar": "^6.1.4"
   },
-  "gitHead": "9bc6c82fa09d23dd9486c44b51474758c3e8c8bb"
+  "gitHead": "2ab10538e5f287087fe0892c3a383476dbe6df86"
 }

package/src/site/exportSite.ts

@@ -0,0 +1,53 @@
+import * as fs from "fs";
+import * as path from "path";
+
+import * as mkdirp from "mkdirp";
+
+import { ProjectConfig } from "../config";
+
+import { generateHistory } from "./generateHistory";
+import { getRepoDetails } from "./getRepoDetails";
+import { generateSiteSearchIndex } from "./generateSiteSearchIndex";
+
+export function exportSite(rootDirectoryPath: string, projectConfig: ProjectConfig) {
+  const hasError = false;
+
+  mkdirp.sync(projectConfig.siteExportDirectoryPath);
+
+  const sitePackagePath = path.dirname(require.resolve("@featurevisor/site/package.json"));
+
+  // copy site dist
+  const siteDistPath = path.join(sitePackagePath, "dist");
+  fs.cpSync(siteDistPath, projectConfig.siteExportDirectoryPath, { recursive: true });
+
+  const sitePublicPath = path.join(sitePackagePath, "public");
+  fs.cpSync(sitePublicPath, projectConfig.siteExportDirectoryPath, { recursive: true });
+
+  console.log("Site dist copied to:", projectConfig.siteExportDirectoryPath);
+
+  // generate history
+  const fullHistory = generateHistory(rootDirectoryPath, projectConfig);
+
+  // site search index
+  const repoDetails = getRepoDetails();
+  const searchIndex = generateSiteSearchIndex(
+    rootDirectoryPath,
+    projectConfig,
+    fullHistory,
+    repoDetails,
+  );
+  const searchIndexFilePath = path.join(projectConfig.siteExportDirectoryPath, "search-index.json");
+  fs.writeFileSync(searchIndexFilePath, JSON.stringify(searchIndex));
+  console.log(`Site search index written at: ${searchIndexFilePath}`);
+
+  // copy datafiles
+  fs.cpSync(
+    projectConfig.outputDirectoryPath,
+    path.join(projectConfig.siteExportDirectoryPath, "datafiles"),
+    { recursive: true },
+  );
+
+  // @TODO: replace placeoholders in index.html
+
+  return hasError;
+}

package/src/site/generateHistory.ts

@@ -0,0 +1,101 @@
+import * as path from "path";
+import * as fs from "fs";
+import { execSync } from "child_process";
+
+import { HistoryEntry } from "@featurevisor/types";
+
+import { ProjectConfig } from "../config";
+
+import { getRelativePaths } from "./getRelativePaths";
+
+export function generateHistory(rootDirectoryPath, projectConfig: ProjectConfig): HistoryEntry[] {
+  try {
+    // raw history
+    const rawHistoryFilePath = path.join(projectConfig.siteExportDirectoryPath, "history-raw.txt");
+
+    const { relativeFeaturesPath, relativeSegmentsPath, relativeAttributesPath } = getRelativePaths(
+      rootDirectoryPath,
+      projectConfig,
+    );
+
+    const separator = "|";
+
+    const cmd = `git log --name-only --pretty=format:"%h${separator}%an${separator}%aI" --no-merges --relative -- ${relativeFeaturesPath} ${relativeSegmentsPath} ${relativeAttributesPath} > ${rawHistoryFilePath}`;
+    execSync(cmd);
+
+    console.log(`History (raw) generated at: ${rawHistoryFilePath}`);
+
+    // structured history
+    const rawHistory = fs.readFileSync(rawHistoryFilePath, "utf8");
+
+    const fullHistory: HistoryEntry[] = [];
+
+    let entry: HistoryEntry = {
+      commit: "",
+      author: "",
+      timestamp: "",
+      entities: [],
+    };
+
+    rawHistory.split("\n").forEach((line, index) => {
+      if (index === 0 && line.length === 0) {
+        // no history found
+        return;
+      }
+
+      if (index > 0 && line.length === 0) {
+        // commit finished
+        fullHistory.push(entry);
+
+        return;
+      }
+
+      if (line.indexOf(separator) > -1) {
+        // commit line
+        const parts = line.split("|");
+
+        entry = {
+          commit: parts[0],
+          author: parts[1],
+          timestamp: parts[2],
+          entities: [],
+        };
+      } else {
+        // file line
+        const lineSplit = line.split(path.sep);
+        const fileName = lineSplit.pop() as string;
+        const relativeDir = lineSplit.join(path.sep);
+
+        const key = fileName.replace("." + projectConfig.parser, "");
+
+        let type = "feature" as "attribute" | "segment" | "feature";
+
+        if (relativeDir === relativeSegmentsPath) {
+          type = "segment";
+        } else if (relativeDir === relativeAttributesPath) {
+          type = "attribute";
+        }
+
+        entry.entities.push({
+          type,
+          key,
+        });
+      }
+    });
+
+    const fullHistoryFilePath = path.join(
+      projectConfig.siteExportDirectoryPath,
+      "history-full.json",
+    );
+    fs.writeFileSync(fullHistoryFilePath, JSON.stringify(fullHistory));
+    console.log(`History (full) generated at: ${fullHistoryFilePath}`);
+
+    return fullHistory;
+  } catch (error) {
+    console.error(
+      `Error when generating history from git: ${error.status}\n${error.stderr.toString()}`,
+    );
+
+    return [];
+  }
+}

package/src/site/generateSiteSearchIndex.ts

@@ -0,0 +1,203 @@
+import {
+  HistoryEntry,
+  SearchIndex,
+  AttributeKey,
+  FeatureKey,
+  SegmentKey,
+  Condition,
+} from "@featurevisor/types";
+
+import { Datasource } from "../datasource";
+import { ProjectConfig } from "../config";
+import { extractAttributeKeysFromConditions, extractSegmentKeysFromGroupSegments } from "../utils";
+
+import { getRelativePaths } from "./getRelativePaths";
+import { getLastModifiedFromHistory } from "./getLastModifiedFromHistory";
+import { RepoDetails } from "./getRepoDetails";
+
+export function generateSiteSearchIndex(
+  rootDirectoryPath: string,
+  projectConfig: ProjectConfig,
+  fullHistory: HistoryEntry[],
+  repoDetails: RepoDetails | undefined,
+): SearchIndex {
+  const result: SearchIndex = {
+    links: undefined,
+    entities: {
+      attributes: [],
+      segments: [],
+      features: [],
+    },
+  };
+  const datasource = new Datasource(projectConfig);
+
+  /**
+   * Links
+   */
+  if (repoDetails) {
+    const { relativeAttributesPath, relativeSegmentsPath, relativeFeaturesPath } = getRelativePaths(
+      rootDirectoryPath,
+      projectConfig,
+    );
+
+    let prefix = "";
+    if (repoDetails.topLevelPath !== rootDirectoryPath) {
+      prefix = rootDirectoryPath.replace(repoDetails.topLevelPath + "/", "") + "/";
+    }
+
+    result.links = {
+      attribute: repoDetails.blobUrl.replace(
+        "{{blobPath}}",
+        prefix + relativeAttributesPath + "/{{key}}." + datasource.getExtension(),
+      ),
+      segment: repoDetails.blobUrl.replace(
+        "{{blobPath}}",
+        prefix + relativeSegmentsPath + "/{{key}}." + datasource.getExtension(),
+      ),
+      feature: repoDetails.blobUrl.replace(
+        "{{blobPath}}",
+        prefix + relativeFeaturesPath + "/{{key}}." + datasource.getExtension(),
+      ),
+      commit: repoDetails.commitUrl,
+    };
+  }
+
+  /**
+   * Entities
+   */
+  // usage
+  const attributesUsedInFeatures: {
+    [key: AttributeKey]: Set<FeatureKey>;
+  } = {};
+  const attributesUsedInSegments: {
+    [key: AttributeKey]: Set<SegmentKey>;
+  } = {};
+  const segmentsUsedInFeatures: {
+    [key: SegmentKey]: Set<FeatureKey>;
+  } = {};
+
+  // features
+  const featureFiles = datasource.listFeatures();
+  featureFiles.forEach((entityName) => {
+    const parsed = datasource.readFeature(entityName);
+
+    if (Array.isArray(parsed.variations)) {
+      parsed.variations.forEach((variation) => {
+        if (!variation.variables) {
+          return;
+        }
+
+        variation.variables.forEach((v) => {
+          if (v.overrides) {
+            v.overrides.forEach((o) => {
+              if (o.conditions) {
+                extractAttributeKeysFromConditions(o.conditions).forEach((attributeKey) => {
+                  if (!attributesUsedInFeatures[attributeKey]) {
+                    attributesUsedInFeatures[attributeKey] = new Set();
+                  }
+
+                  attributesUsedInFeatures[attributeKey].add(entityName);
+                });
+              }
+
+              if (o.segments && o.segments !== "*") {
+                extractSegmentKeysFromGroupSegments(o.segments).forEach((segmentKey) => {
+                  if (!segmentsUsedInFeatures[segmentKey]) {
+                    segmentsUsedInFeatures[segmentKey] = new Set();
+                  }
+
+                  segmentsUsedInFeatures[segmentKey].add(entityName);
+                });
+              }
+            });
+          }
+        });
+      });
+    }
+
+    Object.keys(parsed.environments).forEach((environmentKey) => {
+      const env = parsed.environments[environmentKey];
+
+      env.rules.forEach((rule) => {
+        if (rule.segments && rule.segments !== "*") {
+          extractSegmentKeysFromGroupSegments(rule.segments).forEach((segmentKey) => {
+            if (!segmentsUsedInFeatures[segmentKey]) {
+              segmentsUsedInFeatures[segmentKey] = new Set();
+            }
+
+            segmentsUsedInFeatures[segmentKey].add(entityName);
+          });
+        }
+      });
+
+      if (env.force) {
+        env.force.forEach((force) => {
+          if (force.segments && force.segments !== "*") {
+            extractSegmentKeysFromGroupSegments(force.segments).forEach((segmentKey) => {
+              if (!segmentsUsedInFeatures[segmentKey]) {
+                segmentsUsedInFeatures[segmentKey] = new Set();
+              }
+
+              segmentsUsedInFeatures[segmentKey].add(entityName);
+            });
+          }
+
+          if (force.conditions) {
+            extractAttributeKeysFromConditions(force.conditions).forEach((attributeKey) => {
+              if (!attributesUsedInFeatures[attributeKey]) {
+                attributesUsedInFeatures[attributeKey] = new Set();
+              }
+
+              attributesUsedInFeatures[attributeKey].add(entityName);
+            });
+          }
+        });
+      }
+    });
+
+    result.entities.features.push({
+      ...parsed,
+      key: entityName,
+      lastModified: getLastModifiedFromHistory(fullHistory, "feature", entityName),
+    });
+  });
+
+  // segments
+  const segmentFiles = datasource.listSegments();
+  segmentFiles.forEach((entityName) => {
+    const parsed = datasource.readSegment(entityName);
+
+    extractAttributeKeysFromConditions(parsed.conditions as Condition | Condition[]).forEach(
+      (attributeKey) => {
+        if (!attributesUsedInSegments[attributeKey]) {
+          attributesUsedInSegments[attributeKey] = new Set();
+        }
+
+        attributesUsedInSegments[attributeKey].add(entityName);
+      },
+    );
+
+    result.entities.segments.push({
+      ...parsed,
+      key: entityName,
+      lastModified: getLastModifiedFromHistory(fullHistory, "segment", entityName),
+      usedInFeatures: Array.from(segmentsUsedInFeatures[entityName] || []),
+    });
+  });
+
+  // attributes
+  const attributeFiles = datasource.listAttributes();
+  attributeFiles.forEach((entityName) => {
+    const parsed = datasource.readAttribute(entityName);
+
+    result.entities.attributes.push({
+      ...parsed,
+      key: entityName,
+      lastModified: getLastModifiedFromHistory(fullHistory, "attribute", entityName),
+      usedInFeatures: Array.from(attributesUsedInFeatures[entityName] || []),
+      usedInSegments: Array.from(attributesUsedInSegments[entityName] || []),
+    });
+  });
+
+  return result;
+}

package/src/site/getLastModifiedFromHistory.ts

@@ -0,0 +1,21 @@
+import { HistoryEntry, LastModified } from "@featurevisor/types";
+
+export function getLastModifiedFromHistory(
+  fullHistory: HistoryEntry[],
+  type,
+  key,
+): LastModified | undefined {
+  const lastModified = fullHistory.find((entry) => {
+    return entry.entities.find((entity) => {
+      return entity.type === type && entity.key === key;
+    });
+  });
+
+  if (lastModified) {
+    return {
+      commit: lastModified.commit,
+      timestamp: lastModified.timestamp,
+      author: lastModified.author,
+    };
+  }
+}

package/src/site/getOwnerAndRepoFromUrl.ts

@@ -0,0 +1,17 @@
+export function getOwnerAndRepoFromUrl(url: string): { owner: string; repo: string } {
+  let owner;
+  let repo;
+
+  if (url.startsWith("https://")) {
+    const parts = url.split("/");
+    repo = (parts.pop() as string).replace(".git", "");
+    owner = parts.pop();
+  } else if (url.startsWith("git@")) {
+    const urlParts = url.split(":");
+    const parts = urlParts[1].split("/");
+    repo = (parts.pop() as string).replace(".git", "");
+    owner = parts.pop();
+  }
+
+  return { owner, repo };
+}

package/src/site/getRelativePaths.ts

@@ -0,0 +1,24 @@
+import * as path from "path";
+
+import { ProjectConfig } from "../config";
+
+export function getRelativePaths(rootDirectoryPath, projectConfig: ProjectConfig) {
+  const relativeFeaturesPath = path.relative(
+    rootDirectoryPath,
+    projectConfig.featuresDirectoryPath,
+  );
+  const relativeSegmentsPath = path.relative(
+    rootDirectoryPath,
+    projectConfig.segmentsDirectoryPath,
+  );
+  const relativeAttributesPath = path.relative(
+    rootDirectoryPath,
+    projectConfig.attributesDirectoryPath,
+  );
+
+  return {
+    relativeFeaturesPath,
+    relativeSegmentsPath,
+    relativeAttributesPath,
+  };
+}

package/src/site/getRepoDetails.ts

@@ -0,0 +1,62 @@
+import { execSync } from "child_process";
+
+import { getOwnerAndRepoFromUrl } from "./getOwnerAndRepoFromUrl";
+
+export interface RepoDetails {
+  branch: string;
+  remoteUrl: string;
+  blobUrl: string;
+  commitUrl: string;
+  topLevelPath: string;
+}
+
+export function getRepoDetails(): RepoDetails | undefined {
+  try {
+    const topLevelPathOutput = execSync(`git rev-parse --show-toplevel`);
+    const topLevelPath = topLevelPathOutput.toString().trim();
+
+    const remoteUrlOutput = execSync(`git remote get-url origin`);
+    const remoteUrl = remoteUrlOutput.toString().trim();
+
+    const branchOutput = execSync(`git rev-parse --abbrev-ref HEAD`);
+    const branch = branchOutput.toString().trim();
+
+    if (!remoteUrl || !branch) {
+      return;
+    }
+
+    const { owner, repo } = getOwnerAndRepoFromUrl(remoteUrl);
+
+    if (!owner || !repo) {
+      return;
+    }
+
+    let blobUrl;
+    let commitUrl;
+
+    if (remoteUrl.indexOf("github.com") > -1) {
+      blobUrl = `https://github.com/${owner}/${repo}/blob/${branch}/{{blobPath}}`;
+      commitUrl = `https://github.com/${owner}/${repo}/commit/{{hash}}`;
+    } else if (remoteUrl.indexOf("bitbucket.org") > -1) {
+      blobUrl = `https://bitbucket.org/${owner}/${repo}/src/${branch}/{{blobPath}}`;
+      commitUrl = `https://bitbucket.org/${owner}/${repo}/commits/{{hash}}`;
+    }
+
+    if (!blobUrl || !commitUrl) {
+      return;
+    }
+
+    return {
+      branch,
+      remoteUrl,
+      blobUrl,
+      commitUrl,
+      topLevelPath,
+    };
+  } catch (e) {
+    console.error(e);
+    return;
+  }
+
+  return;
+}

package/src/site/index.ts

@@ -0,0 +1,2 @@
+export * from "./exportSite";
+export * from "./serveSite";