497 lines
16 KiB
JavaScript
Raw Normal View History

2016-12-23 16:59:48 -02:00
import LocalForage from "localforage";
import { Base64 } from "js-base64";
import _ from "lodash";
2017-01-10 22:23:22 -02:00
import AssetProxy from "../../valueObjects/AssetProxy";
2016-12-23 16:59:48 -02:00
import { SIMPLE, EDITORIAL_WORKFLOW, status } from "../../constants/publishModes";
import { APIError, EditorialWorkflowError } from "../../valueObjects/errors";
export default class API {
2016-12-23 16:59:48 -02:00
constructor(config) {
this.api_root = config.api_root || "https://api.github.com";
this.token = config.token || false;
this.branch = config.branch || "master";
this.repo = config.repo || "";
this.repoURL = `/repos/${ this.repo }`;
}
user() {
2016-12-23 16:59:48 -02:00
return this.request("/user");
}
requestHeaders(headers = {}) {
2016-12-23 16:59:48 -02:00
const baseHeader = {
"Content-Type": "application/json",
...headers,
};
2016-12-23 16:59:48 -02:00
if (this.token) {
baseHeader.Authorization = `token ${ this.token }`;
return baseHeader;
}
return baseHeader;
}
parseJsonResponse(response) {
return response.json().then((json) => {
if (!response.ok) {
return Promise.reject(json);
}
return json;
});
}
urlFor(path, options) {
const params = [];
if (options.params) {
for (const key in options.params) {
params.push(`${ key }=${ encodeURIComponent(options.params[key]) }`);
}
}
if (params.length) {
2016-12-23 16:59:48 -02:00
path += `?${ params.join("&") }`;
}
2016-12-23 16:59:48 -02:00
return this.api_root + path;
}
request(path, options = {}) {
const headers = this.requestHeaders(options.headers || {});
const url = this.urlFor(path, options);
let responseStatus;
return fetch(url, { ...options, headers }).then((response) => {
responseStatus = response.status;
2016-12-23 16:59:48 -02:00
const contentType = response.headers.get("Content-Type");
2016-09-14 18:55:42 -03:00
if (contentType && contentType.match(/json/)) {
return this.parseJsonResponse(response);
}
return response.text();
})
.catch((error) => {
throw new APIError(error.message, responseStatus, 'GitHub');
});
}
2016-08-31 16:41:29 -03:00
checkMetadataRef() {
return this.request(`${ this.repoURL }/git/refs/meta/_netlify_cms?${ Date.now() }`, {
2016-12-23 16:59:48 -02:00
cache: "no-store",
})
2016-08-31 16:41:29 -03:00
.then(response => response.object)
.catch((error) => {
2016-08-31 16:41:29 -03:00
// Meta ref doesn't exist
const readme = {
2016-12-23 16:59:48 -02:00
raw: "# Netlify CMS\n\nThis tree is used by the Netlify CMS to store metadata information for specific files and branches.",
};
2016-08-31 13:30:14 -03:00
return this.uploadBlob(readme)
.then(item => this.request(`${ this.repoURL }/git/trees`, {
2016-12-23 16:59:48 -02:00
method: "POST",
body: JSON.stringify({ tree: [{ path: "README.md", mode: "100644", type: "blob", sha: item.sha }] }),
}))
2016-12-23 16:59:48 -02:00
.then(tree => this.commit("First Commit", tree))
.then(response => this.createRef("meta", "_netlify_cms", response.sha))
2016-08-31 13:30:14 -03:00
.then(response => response.object);
});
2016-08-31 13:30:14 -03:00
}
2016-08-31 15:44:00 -03:00
storeMetadata(key, data) {
2016-08-31 17:33:12 -03:00
return this.checkMetadataRef()
2016-08-31 13:30:14 -03:00
.then((branchData) => {
const fileTree = {
[`${ key }.json`]: {
path: `${ key }.json`,
2016-08-31 13:30:14 -03:00
raw: JSON.stringify(data),
file: true,
},
2016-08-31 13:30:14 -03:00
};
return this.uploadBlob(fileTree[`${ key }.json`])
2016-12-23 16:59:48 -02:00
.then(item => this.updateTree(branchData.sha, "/", fileTree))
.then(changeTree => this.commit(`Updating “${ key }” metadata`, changeTree))
2016-12-23 16:59:48 -02:00
.then(response => this.patchRef("meta", "_netlify_cms", response.sha))
2016-09-13 16:00:24 -03:00
.then(() => {
LocalForage.setItem(`gh.meta.${ key }`, {
2016-09-13 16:00:24 -03:00
expires: Date.now() + 300000, // In 5 minutes
data,
2016-09-13 16:00:24 -03:00
});
});
2016-08-31 13:30:14 -03:00
});
}
2016-09-06 17:18:27 -03:00
retrieveMetadata(key) {
const cache = LocalForage.getItem(`gh.meta.${ key }`);
2016-09-13 16:00:24 -03:00
return cache.then((cached) => {
if (cached && cached.expires > Date.now()) { return cached.data; }
console.log("%c Checking for MetaData files", "line-height: 30px;text-align: center;font-weight: bold"); // eslint-disable-line
return this.request(`${ this.repoURL }/contents/${ key }.json`, {
2016-12-23 16:59:48 -02:00
params: { ref: "refs/meta/_netlify_cms" },
headers: { Accept: "application/vnd.github.VERSION.raw" },
cache: "no-store",
2016-09-13 16:00:24 -03:00
})
.then(response => JSON.parse(response))
.catch(error => console.log("%c %s does not have metadata", "line-height: 30px;text-align: center;font-weight: bold", key)); // eslint-disable-line
2016-09-13 16:00:24 -03:00
});
2016-08-31 15:44:00 -03:00
}
2016-09-06 17:18:27 -03:00
readFile(path, sha, branch = this.branch) {
const cache = sha ? LocalForage.getItem(`gh.${ sha }`) : Promise.resolve(null);
return cache.then((cached) => {
if (cached) { return cached; }
return this.request(`${ this.repoURL }/contents/${ path }`, {
2016-12-23 16:59:48 -02:00
headers: { Accept: "application/vnd.github.VERSION.raw" },
2016-09-06 17:18:27 -03:00
params: { ref: branch },
cache: false,
}).then((result) => {
if (sha) {
LocalForage.setItem(`gh.${ sha }`, result);
}
return result;
});
});
}
listFiles(path) {
return this.request(`${ this.repoURL }/contents/${ path }`, {
params: { ref: this.branch },
});
}
2016-09-06 17:18:27 -03:00
readUnpublishedBranchFile(contentKey) {
2016-09-13 16:00:24 -03:00
let metaData;
const unpublishedPromise = this.retrieveMetadata(contentKey)
.then((data) => {
2016-09-13 16:00:24 -03:00
metaData = data;
if (data.objects.entry.path) {
return this.readFile(data.objects.entry.path, null, data.branch);
}
return Promise.reject(null);
2016-09-13 16:00:24 -03:00
})
.then(fileData => ({ metaData, fileData }))
.catch(() => {
throw new EditorialWorkflowError('content is not under editorial workflow', true);
});
return unpublishedPromise;
2016-09-06 17:18:27 -03:00
}
listUnpublishedBranches() {
console.log("%c Checking for Unpublished entries", "line-height: 30px;text-align: center;font-weight: bold"); // eslint-disable-line
return this.request(`${ this.repoURL }/git/refs/heads/cms`)
.catch((error) => {
console.log("%c No Unpublished entries", "line-height: 30px;text-align: center;font-weight: bold"); // eslint-disable-line
throw error;
});
2016-09-06 17:18:27 -03:00
}
composeFileTree(files) {
let filename;
let part;
let parts;
let subtree;
const fileTree = {};
files.forEach((file) => {
if (file.uploaded) { return; }
2016-12-23 16:59:48 -02:00
parts = file.path.split("/").filter(part => part);
filename = parts.pop();
subtree = fileTree;
while (part = parts.shift()) {
subtree[part] = subtree[part] || {};
subtree = subtree[part];
}
subtree[filename] = file;
file.file = true;
});
return fileTree;
}
persistFiles(entry, mediaFiles, options) {
const uploadPromises = [];
const files = mediaFiles.concat(entry);
files.forEach((file) => {
if (file.uploaded) { return; }
uploadPromises.push(this.uploadBlob(file));
});
const fileTree = this.composeFileTree(files);
return Promise.all(uploadPromises).then(() => {
if (!options.mode || (options.mode && options.mode === SIMPLE)) {
return this.getBranch()
2016-12-23 16:59:48 -02:00
.then(branchData => this.updateTree(branchData.commit.sha, "/", fileTree))
.then(changeTree => this.commit(options.commitMessage, changeTree))
.then(response => this.patchBranch(this.branch, response.sha));
} else if (options.mode && options.mode === EDITORIAL_WORKFLOW) {
const mediaFilesList = mediaFiles.map(file => ({ path: file.path, sha: file.sha }));
return this.editorialWorkflowGit(fileTree, entry, mediaFilesList, options);
}
});
}
editorialWorkflowGit(fileTree, entry, filesList, options) {
const contentKey = entry.slug;
const branchName = `cms/${ contentKey }`;
const unpublished = options.unpublished || false;
if (!unpublished) {
// Open new editorial review workflow for this entry - Create new metadata and commit to new branch`
const contentKey = entry.slug;
const branchName = `cms/${ contentKey }`;
2016-09-14 18:25:45 -03:00
return this.getBranch()
2016-12-23 16:59:48 -02:00
.then(branchData => this.updateTree(branchData.commit.sha, "/", fileTree))
2016-08-31 13:30:14 -03:00
.then(changeTree => this.commit(options.commitMessage, changeTree))
2016-09-14 18:25:45 -03:00
.then(commitResponse => this.createBranch(branchName, commitResponse.sha))
.then(branchResponse => this.createPR(options.commitMessage, branchName))
2016-12-23 16:59:48 -02:00
.then(prResponse => this.user().then(user => user.name ? user.name : user.login)
.then(username => this.storeMetadata(contentKey, {
2016-12-23 16:59:48 -02:00
type: "PR",
2016-09-14 18:25:45 -03:00
pr: {
number: prResponse.number,
head: prResponse.head && prResponse.head.sha,
2016-09-14 18:25:45 -03:00
},
user: username,
status: status.first(),
branch: branchName,
collection: options.collectionName,
title: options.parsedData && options.parsedData.title,
description: options.parsedData && options.parsedData.description,
objects: {
entry: {
path: entry.path,
sha: entry.sha,
},
files: filesList,
},
timeStamp: new Date().toISOString(),
}
)));
} else {
// Entry is already on editorial review workflow - just update metadata and commit to existing branch
return this.getBranch(branchName)
2016-12-23 16:59:48 -02:00
.then(branchData => this.updateTree(branchData.commit.sha, "/", fileTree))
.then(changeTree => this.commit(options.commitMessage, changeTree))
.then((response) => {
const contentKey = entry.slug;
const branchName = `cms/${ contentKey }`;
2016-12-23 16:59:48 -02:00
return this.user().then(user => user.name ? user.name : user.login)
.then(username => this.retrieveMetadata(contentKey))
.then((metadata) => {
let files = metadata.objects && metadata.objects.files || [];
files = files.concat(filesList);
const updatedPR = metadata.pr;
updatedPR.head = response.sha;
return {
...metadata,
pr: updatedPR,
2016-09-09 17:15:58 -03:00
title: options.parsedData && options.parsedData.title,
description: options.parsedData && options.parsedData.description,
2016-09-06 17:18:27 -03:00
objects: {
entry: {
path: entry.path,
sha: entry.sha,
},
files: _.uniq(files),
2016-09-09 17:15:58 -03:00
},
timeStamp: new Date().toISOString(),
};
})
.then(updatedMetadata => this.storeMetadata(contentKey, updatedMetadata))
.then(this.patchBranch(branchName, response.sha));
});
}
}
2016-09-13 16:00:24 -03:00
updateUnpublishedEntryStatus(collection, slug, status) {
const contentKey = slug;
2016-09-13 16:00:24 -03:00
return this.retrieveMetadata(contentKey)
2016-12-23 16:59:48 -02:00
.then(metadata => ({
...metadata,
status,
}))
2016-09-13 16:00:24 -03:00
.then(updatedMetadata => this.storeMetadata(contentKey, updatedMetadata));
}
deleteUnpublishedEntry(collection, slug) {
const contentKey = slug;
let prNumber;
return this.retrieveMetadata(contentKey)
.then(metadata => this.closePR(metadata.pr, metadata.objects))
.then(() => this.deleteBranch(`cms/${ contentKey }`));
}
publishUnpublishedEntry(collection, slug) {
const contentKey = slug;
let prNumber;
2016-09-14 18:25:45 -03:00
return this.retrieveMetadata(contentKey)
.then(metadata => this.mergePR(metadata.pr, metadata.objects))
.then(() => this.deleteBranch(`cms/${ contentKey }`));
2016-09-14 18:25:45 -03:00
}
2016-08-31 16:41:29 -03:00
createRef(type, name, sha) {
return this.request(`${ this.repoURL }/git/refs`, {
2016-12-23 16:59:48 -02:00
method: "POST",
body: JSON.stringify({ ref: `refs/${ type }/${ name }`, sha }),
});
}
2016-08-31 16:41:29 -03:00
patchRef(type, name, sha) {
return this.request(`${ this.repoURL }/git/refs/${ type }/${ encodeURIComponent(name) }`, {
2016-12-23 16:59:48 -02:00
method: "PATCH",
body: JSON.stringify({ sha }),
});
}
2016-09-14 18:55:42 -03:00
deleteRef(type, name, sha) {
return this.request(`${ this.repoURL }/git/refs/${ type }/${ encodeURIComponent(name) }`, {
2016-12-23 16:59:48 -02:00
method: "DELETE",
2016-09-14 18:55:42 -03:00
});
2016-08-31 16:41:29 -03:00
}
getBranch(branch = this.branch) {
return this.request(`${ this.repoURL }/branches/${ encodeURIComponent(branch) }`);
2016-08-31 16:41:29 -03:00
}
2016-09-14 18:55:42 -03:00
createBranch(branchName, sha) {
2016-12-23 16:59:48 -02:00
return this.createRef("heads", branchName, sha);
2016-09-14 18:55:42 -03:00
}
patchBranch(branchName, sha) {
2016-12-23 16:59:48 -02:00
return this.patchRef("heads", branchName, sha);
2016-09-14 18:55:42 -03:00
}
deleteBranch(branchName) {
2016-12-23 16:59:48 -02:00
return this.deleteRef("heads", branchName);
2016-09-14 18:55:42 -03:00
}
2016-12-23 16:59:48 -02:00
createPR(title, head, base = "master") {
const body = "Automatically generated by Netlify CMS";
return this.request(`${ this.repoURL }/pulls`, {
2016-12-23 16:59:48 -02:00
method: "POST",
2016-08-31 17:33:12 -03:00
body: JSON.stringify({ title, body, head, base }),
});
}
closePR(pullrequest, objects) {
const headSha = pullrequest.head;
const prNumber = pullrequest.number;
console.log("%c Deleting PR", "line-height: 30px;text-align: center;font-weight: bold"); // eslint-disable-line
return this.request(`${ this.repoURL }/pulls/${ prNumber }`, {
method: "PATCH",
body: JSON.stringify({
state: closed,
}),
});
}
mergePR(pullrequest, objects) {
const headSha = pullrequest.head;
const prNumber = pullrequest.number;
console.log("%c Merging PR", "line-height: 30px;text-align: center;font-weight: bold"); // eslint-disable-line
return this.request(`${ this.repoURL }/pulls/${ prNumber }/merge`, {
2016-12-23 16:59:48 -02:00
method: "PUT",
2016-09-14 18:25:45 -03:00
body: JSON.stringify({
2016-12-23 16:59:48 -02:00
commit_message: "Automatically generated. Merged on Netlify CMS.",
sha: headSha,
2016-09-14 18:25:45 -03:00
}),
})
.catch((error) => {
if (error instanceof APIError && error.status === 405) {
this.forceMergePR(pullrequest, objects);
} else {
throw error;
}
});
}
forceMergePR(pullrequest, objects) {
const files = objects.files.concat(objects.entry);
const fileTree = this.composeFileTree(files);
let commitMessage = "Automatically generated. Merged on Netlify CMS\n\nForce merge of:";
files.forEach((file) => {
commitMessage += `\n* "${ file.path }"`;
2016-09-14 18:25:45 -03:00
});
console.log("%c Automatic merge not possible - Forcing merge.", "line-height: 30px;text-align: center;font-weight: bold"); // eslint-disable-line
return this.getBranch()
.then(branchData => this.updateTree(branchData.commit.sha, "/", fileTree))
.then(changeTree => this.commit(commitMessage, changeTree))
.then(response => this.patchBranch(this.branch, response.sha));
2016-09-14 18:25:45 -03:00
}
getTree(sha) {
return sha ? this.request(`${ this.repoURL }/git/trees/${ sha }`) : Promise.resolve({ tree: [] });
}
toBase64(str) {
return Promise.resolve(
Base64.encode(str)
);
}
uploadBlob(item) {
2017-01-10 22:23:22 -02:00
const content = item instanceof AssetProxy ? item.toBase64() : this.toBase64(item.raw);
2016-12-23 16:59:48 -02:00
return content.then(contentBase64 => this.request(`${ this.repoURL }/git/blobs`, {
method: "POST",
body: JSON.stringify({
content: contentBase64,
encoding: "base64",
}),
}).then((response) => {
item.sha = response.sha;
item.uploaded = true;
return item;
}));
}
updateTree(sha, path, fileTree) {
return this.getTree(sha)
.then((tree) => {
let obj;
let filename;
let fileOrDir;
const updates = [];
const added = {};
for (let i = 0, len = tree.tree.length; i < len; i++) {
obj = tree.tree[i];
if (fileOrDir = fileTree[obj.path]) {
added[obj.path] = true;
if (fileOrDir.file) {
updates.push({ path: obj.path, mode: obj.mode, type: obj.type, sha: fileOrDir.sha });
} else {
updates.push(this.updateTree(obj.sha, obj.path, fileOrDir));
}
}
}
for (filename in fileTree) {
fileOrDir = fileTree[filename];
if (added[filename]) { continue; }
updates.push(
fileOrDir.file ?
2016-12-23 16:59:48 -02:00
{ path: filename, mode: "100644", type: "blob", sha: fileOrDir.sha } :
this.updateTree(null, filename, fileOrDir)
);
}
return Promise.all(updates)
2016-12-23 16:59:48 -02:00
.then(updates => this.request(`${ this.repoURL }/git/trees`, {
method: "POST",
body: JSON.stringify({ base_tree: sha, tree: updates }),
})).then(response => ({ path, mode: "040000", type: "tree", sha: response.sha, parentSha: sha }));
});
}
2016-08-31 13:30:14 -03:00
commit(message, changeTree) {
const tree = changeTree.sha;
const parents = changeTree.parentSha ? [changeTree.parentSha] : [];
return this.request(`${ this.repoURL }/git/commits`, {
2016-12-23 16:59:48 -02:00
method: "POST",
body: JSON.stringify({ message, tree, parents }),
2016-08-31 13:30:14 -03:00
});
}
}