setup-node/node_modules/@octokit/rest/plugins/register-endpoints/register-endpoints.js

99 lines
2.8 KiB
JavaScript
Raw Normal View History

2020-01-24 12:20:19 -05:00
module.exports = registerEndpoints;
2020-01-24 12:20:19 -05:00
const { Deprecation } = require("deprecation");
2020-01-24 12:20:19 -05:00
function registerEndpoints(octokit, routes) {
Object.keys(routes).forEach(namespaceName => {
if (!octokit[namespaceName]) {
2020-01-24 12:20:19 -05:00
octokit[namespaceName] = {};
}
Object.keys(routes[namespaceName]).forEach(apiName => {
2020-01-24 12:20:19 -05:00
const apiOptions = routes[namespaceName][apiName];
2020-01-24 12:20:19 -05:00
const endpointDefaults = ["method", "url", "headers"].reduce(
(map, key) => {
if (typeof apiOptions[key] !== "undefined") {
map[key] = apiOptions[key];
}
2020-01-24 12:20:19 -05:00
return map;
},
{}
);
endpointDefaults.request = {
validate: apiOptions.params
2020-01-24 12:20:19 -05:00
};
2020-01-24 12:20:19 -05:00
let request = octokit.request.defaults(endpointDefaults);
// patch request & endpoint methods to support deprecated parameters.
// Not the most elegant solution, but we dont want to move deprecation
// logic into octokit/endpoint.js as its out of scope
2020-01-24 12:20:19 -05:00
const hasDeprecatedParam = Object.keys(apiOptions.params || {}).find(
key => apiOptions.params[key].deprecated
);
if (hasDeprecatedParam) {
2020-01-24 12:20:19 -05:00
const patch = patchForDeprecation.bind(null, octokit, apiOptions);
request = patch(
octokit.request.defaults(endpointDefaults),
`.${namespaceName}.${apiName}()`
2020-01-24 12:20:19 -05:00
);
request.endpoint = patch(
request.endpoint,
`.${namespaceName}.${apiName}.endpoint()`
2020-01-24 12:20:19 -05:00
);
request.endpoint.merge = patch(
request.endpoint.merge,
`.${namespaceName}.${apiName}.endpoint.merge()`
2020-01-24 12:20:19 -05:00
);
}
if (apiOptions.deprecated) {
2020-01-24 12:20:19 -05:00
octokit[namespaceName][apiName] = function deprecatedEndpointMethod() {
octokit.log.warn(
new Deprecation(`[@octokit/rest] ${apiOptions.deprecated}`)
);
octokit[namespaceName][apiName] = request;
return request.apply(null, arguments);
};
return;
}
2020-01-24 12:20:19 -05:00
octokit[namespaceName][apiName] = request;
});
});
}
2020-01-24 12:20:19 -05:00
function patchForDeprecation(octokit, apiOptions, method, methodName) {
const patchedMethod = options => {
options = Object.assign({}, options);
Object.keys(options).forEach(key => {
if (apiOptions.params[key] && apiOptions.params[key].deprecated) {
2020-01-24 12:20:19 -05:00
const aliasKey = apiOptions.params[key].alias;
2020-01-24 12:20:19 -05:00
octokit.log.warn(
new Deprecation(
`[@octokit/rest] "${key}" parameter is deprecated for "${methodName}". Use "${aliasKey}" instead`
)
);
if (!(aliasKey in options)) {
2020-01-24 12:20:19 -05:00
options[aliasKey] = options[key];
}
2020-01-24 12:20:19 -05:00
delete options[key];
}
2020-01-24 12:20:19 -05:00
});
2020-01-24 12:20:19 -05:00
return method(options);
};
Object.keys(method).forEach(key => {
2020-01-24 12:20:19 -05:00
patchedMethod[key] = method[key];
});
2020-01-24 12:20:19 -05:00
return patchedMethod;
}