Add rudimentary gemlog archive support

[rbdr/blog] / lib / blog.js

'use strict';

const { access, mkdir, readdir, readFile, rm, writeFile } = require('fs/promises');
const { exec } = require('child_process');
const { ncp } = require('ncp');
const { join } = require('path');
const ParseGemini = require('gemini-to-html/parse');
const RenderGemini = require('gemini-to-html/render');
const { debuglog, promisify } = require('util');

// Generators for the Blog

const StaticGenerator = require('./generators/static');
const HTMLGenerator = require('./generators/html');
const RSSGenerator = require('./generators/rss');
const TXTGenerator = require('./generators/txt');

// Archiving Methods

const GemlogArchiver = require('./archivers/gemlog');

const internals = {

  // Promisified functions
  exec: promisify(exec),
  ncp: promisify(ncp),

  debuglog: debuglog('blog'),

  // constants

  kFileNotFoundError: 'ENOENT',
  kGeminiRe: /\.gmi$/i,
  kMetadataFilename: 'metadata.json',

  // Strings

  strings: {
    geminiNotFound: 'Gemini file was not found in blog directory. Please update.'
  }
};

/**
 * The Blog class is the blog generator, it's in charge of adding and
 * updating posts, and handling the publishing.
 *
 * @class Blog
 * @param {Blog.tConfiguration} config the initialization options to
 * extend the instance
 */
module.exports = class Blog {

  constructor(config) {

    Object.assign(this, config);
  }

  /**
   * Shifts the blog posts, adds the passed path to slot 0, and
   * generates files.
   *
   * @function add
   * @memberof Blog
   * @param {string} postLocation the path to the directory containing
   * the post structure
   * @return {Promise<undefined>} empty promise, returns no value
   * @instance
   */
  async add(postLocation) {

    await this._ensurePostsDirectoryExists();
    await this._shift();
    await mkdir(join(this.postsDirectory, '0'));
    await this.update(postLocation);
  }

  /**
   * Adds the passed path to slot 0, and generates files.
   *
   * @function update
   * @memberof Blog
   * @param {string} postLocation the path to the directory containing
   * the post structure
   * @return {Promise<undefined>} empty promise, returns no value
   * @instance
   */
  async update(postLocation) {

    const metadata = await this._getMetadata();
    await this._ensurePostsDirectoryExists();
    await this._copyPost(postLocation);
    await this._writeMetadata(metadata);

    await this._archive(postLocation);

    await this.generate();
  }

  /**
   * Publishes the files to a static host.
   *
   * @function publish
   * @memberof Blog
   * @return {Promise<undefined>} empty promise, returns no value
   * @instance
   */
  async publish(bucket) {

    internals.debuglog(`Publishing to ${bucket}`);
    try {
      await internals.exec('which aws');
    }
    catch (err) {
      console.error('Please install and configure AWS CLI to publish.');
    }

    try {
      await internals.exec(`aws s3 sync --acl public-read --delete ${this.staticDirectory} s3://${bucket}`);
      await internals.exec(`aws s3 cp --content-type 'text/plain; charset=utf-8 ' --acl public-read ${this.staticDirectory}/index.txt s3://${bucket}`);
    }
    catch (err) {
      console.error('Failed to publish');
      console.error(err.stderr);
    }

    internals.debuglog('Finished publishing');
  }

  // Parses Gemini for each page, copies assets and generates index.

  async generate() {

    internals.debuglog('Generating output');

    const posts = await this._readPosts();

    await StaticGenerator(this.postsDirectory, this.staticDirectory, posts);
    await HTMLGenerator(this.templatesDirectory, this.staticDirectory, posts);
    await RSSGenerator(this.templatesDirectory, this.staticDirectory, posts);
    await TXTGenerator(this.templatesDirectory, this.staticDirectory, posts);

    await GemlogArchiver(this.archiveDirectory);
  }

  // Reads the posts into an array

  async _readPosts() {

    internals.debuglog('Reading posts');
    const posts = [];

    for (let i = 0; i < this.maxPosts; ++i) {
      try {
        posts.push(await this._readPost(i));
      }
      catch (error) {
        if (error.code === internals.kFileNotFoundError) {
          internals.debuglog(`Skipping ${i}`);
          continue;
        }

        throw error;
      }
    }

    return posts;
  }

  // Reads an individual post

  async _readPost(index=0) {
      const postSourcePath = join(this.postsDirectory, `${index}`);

      internals.debuglog(`Reading ${postSourcePath}`);

      await access(postSourcePath);

      const metadata = await this._getMetadata(index);

      const postContentPath = await this._findBlogContent(postSourcePath);
      internals.debuglog(`Reading ${postContentPath}`);
      const postContent = await readFile(postContentPath, { encoding: 'utf8' });

      internals.debuglog('Parsing Gemini');
      return {
        ...metadata,
        location: postSourcePath,
        index,
        html: RenderGemini(ParseGemini(postContent)),
        raw: postContent
      };
  }

  // Shift the posts, delete any remainder.

  async _shift() {


    for (let i = this.maxPosts - 1; i >= 0; --i) {
      const targetPath = join(this.postsDirectory, `${i}`);
      const sourcePath = join(this.postsDirectory, `${i - 1}`);

      try {
        internals.debuglog(`Archiving ${targetPath}`);
        await rm(targetPath, { recursive: true });

        await access(sourcePath); // check the source path

        internals.debuglog(`Shifting blog post ${sourcePath} to ${targetPath}`);
        await internals.ncp(sourcePath, targetPath);
      }
      catch (error) {
        if (error.code === internals.kFileNotFoundError) {
          internals.debuglog(`Skipping ${sourcePath}: Does not exist.`);
          continue;
        }

        throw error;
      }
    }
  }

  // Moves older posts to the archive

  async _archive() {
    internals.debuglog('Archiving post');
    const post = await this._readPost(0);
    await this._ensureDirectoryExists(this.archiveDirectory);

    const targetPath = join(this.archiveDirectory, post.id);

    try {
      internals.debuglog(`Removing ${targetPath}`);
      await rm(targetPath, { recursive: true });
    } 
    finally {
      internals.debuglog(`Adding ${post.location} to ${targetPath}`);
      await internals.ncp(post.location, targetPath);
      internals.debuglog(`Added ${post.location} to ${targetPath}`);
    }
  }

  // Attempts to read existing metadata. Otherwise generates new set.

  async _getMetadata(index = 0) {

    const metadataTarget = join(this.postsDirectory, String(index), internals.kMetadataFilename);

    try {
      internals.debuglog(`Looking for metadata at ${metadataTarget}`);
      return JSON.parse(await readFile(metadataTarget, { encoding: 'utf8' }));
    }
    catch (e) {
      internals.debuglog(`Metadata not found or unreadable. Generating new set.`);
      const createdOn = Date.now();
      const metadata = {
        id: String(createdOn),
        createdOn
      };

      return metadata;
    }
  }

  // Writes metadata. Assumes post 0 since it only gets written
  // on create

  async _writeMetadata(metadata) {

    const metadataTarget = join(this.postsDirectory, '0', internals.kMetadataFilename);
    internals.debuglog(`Writing ${metadataTarget}`);
    await writeFile(metadataTarget, JSON.stringify(metadata, null, 2));
  }

  // Copies a post directory to the latest slot.

  async _copyPost(postLocation) {

    const targetPath = join(this.postsDirectory, '0');

    internals.debuglog(`Removing ${targetPath}`);
    await rm(targetPath, { recursive: true });

    internals.debuglog(`Adding ${postLocation} to ${targetPath}`);
    await internals.ncp(postLocation, targetPath);
  }

  // Ensures a directory exists.

  async _ensureDirectoryExists(directory) {

    internals.debuglog(`Checking if ${directory} exists.`);
    try {
      await access(directory);
    }
    catch (error) {
      if (error.code === internals.kFileNotFoundError) {
        internals.debuglog('Creating posts directory');
        await mkdir(directory);
        return;
      }

      throw error;
    }
  }

  // Ensures posts directory exists

  async _ensurePostsDirectoryExists() {

    return this._ensureDirectoryExists(this.postsDirectory);
    internals.debuglog(`Checking if ${this.postsDirectory} exists.`);
    try {
      await access(this.postsDirectory);
    }
    catch (error) {
      if (error.code === internals.kFileNotFoundError) {
        internals.debuglog('Creating posts directory');
        await mkdir(this.postsDirectory);
        return;
      }

      throw error;
    }
  }

  // Looks for a `.gmi` file in the blog directory, and returns the path

  async _findBlogContent(directory) {

    const entries = await readdir(directory);

    const geminiEntries = entries
      .filter((entry) => internals.kGeminiRe.test(entry))
      .map((entry) => join(directory, entry));

    if (geminiEntries.length > 0) {
      internals.debuglog(`Found gemini file: ${geminiEntries[0]}`);
      return geminiEntries[0];
    }

    throw new Error(internals.strings.geminiNotFound);
  }
};