Add comments explaining playbook concept

Author: jeremydw

README.md

@@ -0,0 +1,12 @@
+### Usage
+
+```
+# fileset.yaml
+
+site: mysite
+schedule:
+  default: master
+  2020-12-21 08:10:05: master
+  2021-01-12 08:10:05: feature/takedown
+  2050-02-12 09:10:05: feature/takedown-2
+```

src/server.ts

@@ -30,23 +30,26 @@ const getManifest = async (siteId: string, branchOrRef: string) => {
   if (!result) {
     return;
   }
+  return result;
 
-  // TODO: Allow this to be overwritten.
-  const now = new Date();
-  let latestManifest = null;
-  for (const ttlString in result.schedule) {
-    const ttlDate = new Date(ttlString);
-    const isLaterThanManifestDate = now >= ttlDate;
-    const isLaterThanAllManifests =
-      !latestManifest || ttlDate >= latestManifest.ttl;
-    if (isLaterThanManifestDate && isLaterThanAllManifests) {
-      latestManifest = result.schedule[ttlString];
-      latestManifest.ttl = ttlDate;
-    }
-  }
-  if (latestManifest) {
-    return latestManifest;
-  }
+  // TODO: Add getPlaybook which can be used for prod serving and TTLs.
+  // getManifest is only used for staging.
+  // // TODO: Allow this to be overwritten.
+  // const now = new Date();
+  // let latestManifest = null;
+  // for (const ttlString in result.schedule) {
+  //   const ttlDate = new Date(ttlString);
+  //   const isLaterThanManifestDate = now >= ttlDate;
+  //   const isLaterThanAllManifests =
+  //     !latestManifest || ttlDate >= latestManifest.ttl;
+  //   if (isLaterThanManifestDate && isLaterThanAllManifests) {
+  //     latestManifest = result.schedule[ttlString];
+  //     latestManifest.ttl = ttlDate;
+  //   }
+  // }
+  // if (latestManifest) {
+  //   return latestManifest;
+  // }
 };
 
 const parseHostname = (hostname: string) => {

src/upload.ts

@@ -130,28 +130,10 @@ export async function uploadManifest(
   }
 }
 
-interface ScheduleItem {
-  ttl: Date;
-  ref: string;
-  paths: Record<string, string>;
-}
-
-function createScheduleItem(
-  manifest: Manifest,
-  manifestPaths: Record<string, string>,
-  ttl: Date
-) {
-  return {
-    ttl: ttl,
-    ref: manifest.ref,
-    paths: manifestPaths,
-  } as ScheduleItem;
-}
-
 async function saveManifestEntity(key: entity.Key, data: any) {
   const ent = {
     key: key,
-    excludeFromIndexes: ['schedule'],
+    excludeFromIndexes: ['paths'],
     data: data,
   };
   await datastore.save(ent);
@@ -161,56 +143,39 @@ async function finalize(manifest: Manifest, ttl?: Date) {
   const manifestPaths = manifest.toJSON();
   const now = new Date();
 
-  // Create shortSha mapping.
+  // Create shortSha mapping for staging.
   const key = datastore.key([
     'Fileset2Manifest',
     `${manifest.site}:ref:${manifest.shortSha}`,
   ]);
-  const scheduleItem = createScheduleItem(manifest, manifestPaths, now);
-  const schedule: Record<string, ScheduleItem> = {};
-  schedule[now.toString()] = scheduleItem;
   await saveManifestEntity(key, {
     site: manifest.site,
     ref: manifest.ref,
     branch: manifest.branch,
-    schedule: schedule,
+    paths: manifestPaths,
   });
 
-  // Create branch mapping.
+  // Create branch mapping for staging.
   if (manifest.branch) {
     const branchKey = datastore.key([
       'Fileset2Manifest',
       `${manifest.site}:branch:${manifest.branch}`,
     ]);
-    const branchScheduleItem = createScheduleItem(
-      manifest,
-      manifestPaths,
-      ttl || now
-    );
-    const branchSchedule: Record<string, ScheduleItem> = {};
-    const branchScheduleKey = (ttl || now).toString();
-    branchSchedule[branchScheduleKey] = branchScheduleItem;
-    const resp = await datastore.get(branchKey);
-    let existingData = resp && resp[0];
-    if (!existingData) {
-      existingData = {
-        site: manifest.site,
-        ref: manifest.ref,
-        branch: manifest.branch,
-        schedule: branchSchedule,
-      };
-    } else {
-      // TODO: Clean up past scheduled items here.
-      existingData.schedule[branchScheduleKey] = branchScheduleItem;
-    }
-    console.log(
-      `TTLs for branch: ${manifest.branch} -> ${Object.keys(
-        existingData.schedule
-      )}`
-    );
-    await saveManifestEntity(branchKey, existingData);
+    await saveManifestEntity(branchKey, {
+      site: manifest.site,
+      ref: manifest.ref,
+      branch: manifest.branch,
+      paths: manifestPaths,
+    });
   }
 
+  // TODO: Update the site's playbook and use the playbook for timed launches.
+  // The playbook should contain copies of all future launches. Each site should only
+  // have one playbook.
+  // const routerKey = datastore.key(['Fileset2Router', manifest.site]);
+  // const router =  await datastore.get(routerKey);
+  // const entity = router && router[0];
+
   console.log(
     `Finalized upload for site: ${manifest.site} -> ${manifest.branch} @ ${manifest.shortSha}`
   );