165 lines
7.0 KiB
JavaScript
165 lines
7.0 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.createForm = exports.multipartFormRequestOptions = exports.maybeMultipartFormRequestOptions = exports.isMultipartBody = exports.toFile = exports.isUploadable = exports.isBlobLike = exports.isFileLike = exports.isResponseLike = exports.fileFromPath = void 0;
|
|
const index_1 = require("./_shims/index.js");
|
|
var index_2 = require("./_shims/index.js");
|
|
Object.defineProperty(exports, "fileFromPath", { enumerable: true, get: function () { return index_2.fileFromPath; } });
|
|
const isResponseLike = (value) => value != null &&
|
|
typeof value === 'object' &&
|
|
typeof value.url === 'string' &&
|
|
typeof value.blob === 'function';
|
|
exports.isResponseLike = isResponseLike;
|
|
const isFileLike = (value) => value != null &&
|
|
typeof value === 'object' &&
|
|
typeof value.name === 'string' &&
|
|
typeof value.lastModified === 'number' &&
|
|
(0, exports.isBlobLike)(value);
|
|
exports.isFileLike = isFileLike;
|
|
/**
|
|
* The BlobLike type omits arrayBuffer() because @types/node-fetch@^2.6.4 lacks it; but this check
|
|
* adds the arrayBuffer() method type because it is available and used at runtime
|
|
*/
|
|
const isBlobLike = (value) => value != null &&
|
|
typeof value === 'object' &&
|
|
typeof value.size === 'number' &&
|
|
typeof value.type === 'string' &&
|
|
typeof value.text === 'function' &&
|
|
typeof value.slice === 'function' &&
|
|
typeof value.arrayBuffer === 'function';
|
|
exports.isBlobLike = isBlobLike;
|
|
const isUploadable = (value) => {
|
|
return (0, exports.isFileLike)(value) || (0, exports.isResponseLike)(value) || (0, index_1.isFsReadStream)(value);
|
|
};
|
|
exports.isUploadable = isUploadable;
|
|
/**
|
|
* Helper for creating a {@link File} to pass to an SDK upload method from a variety of different data formats
|
|
* @param value the raw content of the file. Can be an {@link Uploadable}, {@link BlobLikePart}, or {@link AsyncIterable} of {@link BlobLikePart}s
|
|
* @param {string=} name the name of the file. If omitted, toFile will try to determine a file name from bits if possible
|
|
* @param {Object=} options additional properties
|
|
* @param {string=} options.type the MIME type of the content
|
|
* @param {number=} options.lastModified the last modified timestamp
|
|
* @returns a {@link File} with the given properties
|
|
*/
|
|
async function toFile(value, name, options) {
|
|
// If it's a promise, resolve it.
|
|
value = await value;
|
|
// Use the file's options if there isn't one provided
|
|
options ?? (options = (0, exports.isFileLike)(value) ? { lastModified: value.lastModified, type: value.type } : {});
|
|
if ((0, exports.isResponseLike)(value)) {
|
|
const blob = await value.blob();
|
|
name || (name = new URL(value.url).pathname.split(/[\\/]/).pop() ?? 'unknown_file');
|
|
return new index_1.File([blob], name, options);
|
|
}
|
|
const bits = await getBytes(value);
|
|
name || (name = getName(value) ?? 'unknown_file');
|
|
if (!options.type) {
|
|
const type = bits[0]?.type;
|
|
if (typeof type === 'string') {
|
|
options = { ...options, type };
|
|
}
|
|
}
|
|
return new index_1.File(bits, name, options);
|
|
}
|
|
exports.toFile = toFile;
|
|
async function getBytes(value) {
|
|
let parts = [];
|
|
if (typeof value === 'string' ||
|
|
ArrayBuffer.isView(value) || // includes Uint8Array, Buffer, etc.
|
|
value instanceof ArrayBuffer) {
|
|
parts.push(value);
|
|
}
|
|
else if ((0, exports.isBlobLike)(value)) {
|
|
parts.push(await value.arrayBuffer());
|
|
}
|
|
else if (isAsyncIterableIterator(value) // includes Readable, ReadableStream, etc.
|
|
) {
|
|
for await (const chunk of value) {
|
|
parts.push(chunk); // TODO, consider validating?
|
|
}
|
|
}
|
|
else {
|
|
throw new Error(`Unexpected data type: ${typeof value}; constructor: ${value?.constructor
|
|
?.name}; props: ${propsForError(value)}`);
|
|
}
|
|
return parts;
|
|
}
|
|
function propsForError(value) {
|
|
const props = Object.getOwnPropertyNames(value);
|
|
return `[${props.map((p) => `"${p}"`).join(', ')}]`;
|
|
}
|
|
function getName(value) {
|
|
return (getStringFromMaybeBuffer(value.name) ||
|
|
getStringFromMaybeBuffer(value.filename) ||
|
|
// For fs.ReadStream
|
|
getStringFromMaybeBuffer(value.path)?.split(/[\\/]/).pop());
|
|
}
|
|
const getStringFromMaybeBuffer = (x) => {
|
|
if (typeof x === 'string')
|
|
return x;
|
|
if (typeof Buffer !== 'undefined' && x instanceof Buffer)
|
|
return String(x);
|
|
return undefined;
|
|
};
|
|
const isAsyncIterableIterator = (value) => value != null && typeof value === 'object' && typeof value[Symbol.asyncIterator] === 'function';
|
|
const isMultipartBody = (body) => body && typeof body === 'object' && body.body && body[Symbol.toStringTag] === 'MultipartBody';
|
|
exports.isMultipartBody = isMultipartBody;
|
|
/**
|
|
* Returns a multipart/form-data request if any part of the given request body contains a File / Blob value.
|
|
* Otherwise returns the request as is.
|
|
*/
|
|
const maybeMultipartFormRequestOptions = async (opts) => {
|
|
if (!hasUploadableValue(opts.body))
|
|
return opts;
|
|
const form = await (0, exports.createForm)(opts.body);
|
|
return (0, index_1.getMultipartRequestOptions)(form, opts);
|
|
};
|
|
exports.maybeMultipartFormRequestOptions = maybeMultipartFormRequestOptions;
|
|
const multipartFormRequestOptions = async (opts) => {
|
|
const form = await (0, exports.createForm)(opts.body);
|
|
return (0, index_1.getMultipartRequestOptions)(form, opts);
|
|
};
|
|
exports.multipartFormRequestOptions = multipartFormRequestOptions;
|
|
const createForm = async (body) => {
|
|
const form = new index_1.FormData();
|
|
await Promise.all(Object.entries(body || {}).map(([key, value]) => addFormValue(form, key, value)));
|
|
return form;
|
|
};
|
|
exports.createForm = createForm;
|
|
const hasUploadableValue = (value) => {
|
|
if ((0, exports.isUploadable)(value))
|
|
return true;
|
|
if (Array.isArray(value))
|
|
return value.some(hasUploadableValue);
|
|
if (value && typeof value === 'object') {
|
|
for (const k in value) {
|
|
if (hasUploadableValue(value[k]))
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
};
|
|
const addFormValue = async (form, key, value) => {
|
|
if (value === undefined)
|
|
return;
|
|
if (value == null) {
|
|
throw new TypeError(`Received null for "${key}"; to pass null in FormData, you must use the string 'null'`);
|
|
}
|
|
// TODO: make nested formats configurable
|
|
if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
|
|
form.append(key, String(value));
|
|
}
|
|
else if ((0, exports.isUploadable)(value)) {
|
|
const file = await toFile(value);
|
|
form.append(key, file);
|
|
}
|
|
else if (Array.isArray(value)) {
|
|
await Promise.all(value.map((entry) => addFormValue(form, key + '[]', entry)));
|
|
}
|
|
else if (typeof value === 'object') {
|
|
await Promise.all(Object.entries(value).map(([name, prop]) => addFormValue(form, `${key}[${name}]`, prop)));
|
|
}
|
|
else {
|
|
throw new TypeError(`Invalid value given to form, expected a string, number, boolean, object, Array, File or Blob but got ${value} instead`);
|
|
}
|
|
};
|
|
//# sourceMappingURL=uploads.js.map
|