graphql-upload 15.0.2 → 16.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/{GRAPHQL_MULTIPART_REQUEST_SPEC_URL.js → GRAPHQL_MULTIPART_REQUEST_SPEC_URL.mjs} +1 -3
- package/{GraphQLUpload.js → GraphQLUpload.mjs} +8 -9
- package/{Upload.js → Upload.mjs} +6 -10
- package/{graphqlUploadExpress.js → graphqlUploadExpress.mjs} +10 -13
- package/{graphqlUploadKoa.js → graphqlUploadKoa.mjs} +11 -13
- package/{ignoreStream.js → ignoreStream.mjs} +1 -5
- package/package.json +17 -17
- package/{processRequest.js → processRequest.mjs} +16 -17
- package/readme.md +11 -11
|
@@ -1,7 +1,5 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
"use strict";
|
|
4
|
-
|
|
5
3
|
/**
|
|
6
4
|
* [GraphQL multipart request spec](https://github.com/jaydenseric/graphql-multipart-request-spec)
|
|
7
5
|
* URL. Useful for error messages, etc.
|
|
@@ -9,4 +7,4 @@
|
|
|
9
7
|
const GRAPHQL_MULTIPART_REQUEST_SPEC_URL =
|
|
10
8
|
"https://github.com/jaydenseric/graphql-multipart-request-spec";
|
|
11
9
|
|
|
12
|
-
|
|
10
|
+
export default GRAPHQL_MULTIPART_REQUEST_SPEC_URL;
|
|
@@ -1,11 +1,10 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
import { GraphQLError, GraphQLScalarType } from "graphql";
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
const Upload = require("./Upload.js");
|
|
5
|
+
import Upload from "./Upload.mjs";
|
|
7
6
|
|
|
8
|
-
/** @typedef {import("./processRequest").FileUpload} FileUpload */
|
|
7
|
+
/** @typedef {import("./processRequest.mjs").FileUpload} FileUpload */
|
|
9
8
|
|
|
10
9
|
/**
|
|
11
10
|
* A GraphQL `Upload` scalar that can be used in a
|
|
@@ -18,8 +17,8 @@ const Upload = require("./Upload.js");
|
|
|
18
17
|
* from [`@graphql-tools/schema`](https://npm.im/@graphql-tools/schema):
|
|
19
18
|
*
|
|
20
19
|
* ```js
|
|
21
|
-
*
|
|
22
|
-
*
|
|
20
|
+
* import { makeExecutableSchema } from "@graphql-tools/schema/makeExecutableSchema";
|
|
21
|
+
* import GraphQLUpload from "graphql-upload/GraphQLUpload.mjs";
|
|
23
22
|
*
|
|
24
23
|
* const schema = makeExecutableSchema({
|
|
25
24
|
* typeDefs: `
|
|
@@ -34,8 +33,8 @@ const Upload = require("./Upload.js");
|
|
|
34
33
|
* A manually constructed schema with an image upload mutation:
|
|
35
34
|
*
|
|
36
35
|
* ```js
|
|
37
|
-
*
|
|
38
|
-
*
|
|
36
|
+
* import { GraphQLBoolean, GraphQLObjectType, GraphQLSchema } from "graphql";
|
|
37
|
+
* import GraphQLUpload from "graphql-upload/GraphQLUpload.mjs";
|
|
39
38
|
*
|
|
40
39
|
* const schema = new GraphQLSchema({
|
|
41
40
|
* mutation: new GraphQLObjectType({
|
|
@@ -77,4 +76,4 @@ const GraphQLUpload = new GraphQLScalarType({
|
|
|
77
76
|
},
|
|
78
77
|
});
|
|
79
78
|
|
|
80
|
-
|
|
79
|
+
export default GraphQLUpload;
|
package/{Upload.js → Upload.mjs}
RENAMED
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
"
|
|
4
|
-
|
|
5
|
-
/** @typedef {import("./GraphQLUpload.js")} GraphQLUpload */
|
|
6
|
-
/** @typedef {import("./processRequest.js")} processRequest */
|
|
3
|
+
/** @typedef {import("./GraphQLUpload.mjs").default} GraphQLUpload */
|
|
4
|
+
/** @typedef {import("./processRequest.mjs").default} processRequest */
|
|
7
5
|
|
|
8
6
|
/**
|
|
9
7
|
* A file expected to be uploaded as it was declared in the `map` field of a
|
|
@@ -12,18 +10,18 @@
|
|
|
12
10
|
* this class wherever the file is expected in the GraphQL operation. The scalar
|
|
13
11
|
* {@linkcode GraphQLUpload} derives it’s value from {@linkcode Upload.promise}.
|
|
14
12
|
*/
|
|
15
|
-
class Upload {
|
|
13
|
+
export default class Upload {
|
|
16
14
|
constructor() {
|
|
17
15
|
/**
|
|
18
16
|
* Promise that resolves file upload details. This should only be utilized
|
|
19
17
|
* by {@linkcode GraphQLUpload}.
|
|
20
|
-
* @type {Promise<import("./processRequest.
|
|
18
|
+
* @type {Promise<import("./processRequest.mjs").FileUpload>}
|
|
21
19
|
*/
|
|
22
20
|
this.promise = new Promise((resolve, reject) => {
|
|
23
21
|
/**
|
|
24
22
|
* Resolves the upload promise with the file upload details. This should
|
|
25
23
|
* only be utilized by {@linkcode processRequest}.
|
|
26
|
-
* @param {import("./processRequest.
|
|
24
|
+
* @param {import("./processRequest.mjs").FileUpload} file File upload
|
|
27
25
|
* details.
|
|
28
26
|
*/
|
|
29
27
|
this.resolve = (file) => {
|
|
@@ -31,7 +29,7 @@ class Upload {
|
|
|
31
29
|
* The file upload details, available when the
|
|
32
30
|
* {@linkcode Upload.promise} resolves. This should only be utilized by
|
|
33
31
|
* {@linkcode processRequest}.
|
|
34
|
-
* @type {import("./processRequest.
|
|
32
|
+
* @type {import("./processRequest.mjs").FileUpload | undefined}
|
|
35
33
|
*/
|
|
36
34
|
this.file = file;
|
|
37
35
|
|
|
@@ -51,5 +49,3 @@ class Upload {
|
|
|
51
49
|
this.promise.catch(() => {});
|
|
52
50
|
}
|
|
53
51
|
}
|
|
54
|
-
|
|
55
|
-
module.exports = Upload;
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
const defaultProcessRequest = require("./processRequest.js");
|
|
3
|
+
import defaultProcessRequest from "./processRequest.mjs";
|
|
6
4
|
|
|
7
5
|
/**
|
|
8
6
|
* Creates [Express](https://expressjs.com) middleware that processes incoming
|
|
@@ -10,29 +8,30 @@ const defaultProcessRequest = require("./processRequest.js");
|
|
|
10
8
|
* using {@linkcode processRequest}, ignoring non multipart requests. It sets
|
|
11
9
|
* the request `body` to be similar to a conventional GraphQL POST request for
|
|
12
10
|
* following GraphQL middleware to consume.
|
|
13
|
-
* @param {import("./processRequest.
|
|
14
|
-
* processRequest?: import("./processRequest.
|
|
11
|
+
* @param {import("./processRequest.mjs").ProcessRequestOptions & {
|
|
12
|
+
* processRequest?: import("./processRequest.mjs").ProcessRequestFunction
|
|
15
13
|
* }} options Options.
|
|
16
14
|
* @returns Express middleware.
|
|
17
15
|
* @example
|
|
18
16
|
* Basic [`express-graphql`](https://npm.im/express-graphql) setup:
|
|
19
17
|
*
|
|
20
18
|
* ```js
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
*
|
|
19
|
+
* import express from "express";
|
|
20
|
+
* import expressGraphQL from "express-graphql";
|
|
21
|
+
* import graphqlUploadExpress from "graphql-upload/graphqlUploadExpress.mjs";
|
|
22
|
+
*
|
|
23
|
+
* import schema from "./schema.mjs";
|
|
25
24
|
*
|
|
26
25
|
* express()
|
|
27
26
|
* .use(
|
|
28
27
|
* "/graphql",
|
|
29
28
|
* graphqlUploadExpress({ maxFileSize: 10000000, maxFiles: 10 }),
|
|
30
|
-
* graphqlHTTP({ schema })
|
|
29
|
+
* expressGraphQL.graphqlHTTP({ schema })
|
|
31
30
|
* )
|
|
32
31
|
* .listen(3000);
|
|
33
32
|
* ```
|
|
34
33
|
*/
|
|
35
|
-
function graphqlUploadExpress({
|
|
34
|
+
export default function graphqlUploadExpress({
|
|
36
35
|
processRequest = defaultProcessRequest,
|
|
37
36
|
...processRequestOptions
|
|
38
37
|
} = {}) {
|
|
@@ -76,5 +75,3 @@ function graphqlUploadExpress({
|
|
|
76
75
|
|
|
77
76
|
return graphqlUploadExpressMiddleware;
|
|
78
77
|
}
|
|
79
|
-
|
|
80
|
-
module.exports = graphqlUploadExpress;
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
const defaultProcessRequest = require("./processRequest.js");
|
|
3
|
+
import defaultProcessRequest from "./processRequest.mjs";
|
|
6
4
|
|
|
7
5
|
/**
|
|
8
6
|
* Creates [Koa](https://koajs.com) middleware that processes incoming
|
|
@@ -10,19 +8,21 @@ const defaultProcessRequest = require("./processRequest.js");
|
|
|
10
8
|
* using {@linkcode processRequest}, ignoring non multipart requests. It sets
|
|
11
9
|
* the request `body` to be similar to a conventional GraphQL POST request for
|
|
12
10
|
* following GraphQL middleware to consume.
|
|
13
|
-
* @param {import("./processRequest.
|
|
14
|
-
* processRequest?: import("./processRequest.
|
|
11
|
+
* @param {import("./processRequest.mjs").ProcessRequestOptions & {
|
|
12
|
+
* processRequest?: import("./processRequest.mjs").ProcessRequestFunction
|
|
15
13
|
* }} options Options.
|
|
16
14
|
* @returns Koa middleware.
|
|
17
15
|
* @example
|
|
18
16
|
* Basic [`graphql-api-koa`](https://npm.im/graphql-api-koa) setup:
|
|
19
17
|
*
|
|
20
18
|
* ```js
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
*
|
|
25
|
-
*
|
|
19
|
+
* import errorHandler from "graphql-api-koa/errorHandler.mjs";
|
|
20
|
+
* import execute from "graphql-api-koa/execute.mjs";
|
|
21
|
+
* import graphqlUploadKoa from "graphql-upload/graphqlUploadKoa.mjs";
|
|
22
|
+
* import Koa from "koa";
|
|
23
|
+
* import bodyParser from "koa-bodyparser";
|
|
24
|
+
*
|
|
25
|
+
* import schema from "./schema.mjs";
|
|
26
26
|
*
|
|
27
27
|
* new Koa()
|
|
28
28
|
* .use(errorHandler())
|
|
@@ -32,7 +32,7 @@ const defaultProcessRequest = require("./processRequest.js");
|
|
|
32
32
|
* .listen(3000);
|
|
33
33
|
* ```
|
|
34
34
|
*/
|
|
35
|
-
function graphqlUploadKoa({
|
|
35
|
+
export default function graphqlUploadKoa({
|
|
36
36
|
processRequest = defaultProcessRequest,
|
|
37
37
|
...processRequestOptions
|
|
38
38
|
} = {}) {
|
|
@@ -65,5 +65,3 @@ function graphqlUploadKoa({
|
|
|
65
65
|
|
|
66
66
|
return graphqlUploadKoaMiddleware;
|
|
67
67
|
}
|
|
68
|
-
|
|
69
|
-
module.exports = graphqlUploadKoa;
|
|
@@ -1,17 +1,13 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
"use strict";
|
|
4
|
-
|
|
5
3
|
/**
|
|
6
4
|
* Safely ignores a Node.js readable stream.
|
|
7
5
|
* @param {import("stream").Readable} stream Node.js readable stream.
|
|
8
6
|
*/
|
|
9
|
-
function ignoreStream(stream) {
|
|
7
|
+
export default function ignoreStream(stream) {
|
|
10
8
|
// Prevent an unhandled error from crashing the process.
|
|
11
9
|
stream.on("error", () => {});
|
|
12
10
|
|
|
13
11
|
// Waste the stream.
|
|
14
12
|
stream.resume();
|
|
15
13
|
}
|
|
16
|
-
|
|
17
|
-
module.exports = ignoreStream;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "graphql-upload",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "16.0.0",
|
|
4
4
|
"description": "Middleware and an Upload scalar to add support for GraphQL multipart requests (file uploads via queries and mutations) to various Node.js GraphQL servers.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": {
|
|
@@ -27,22 +27,22 @@
|
|
|
27
27
|
"mjs"
|
|
28
28
|
],
|
|
29
29
|
"files": [
|
|
30
|
-
"GRAPHQL_MULTIPART_REQUEST_SPEC_URL.
|
|
31
|
-
"GraphQLUpload.
|
|
32
|
-
"graphqlUploadExpress.
|
|
33
|
-
"graphqlUploadKoa.
|
|
34
|
-
"ignoreStream.
|
|
35
|
-
"processRequest.
|
|
36
|
-
"Upload.
|
|
30
|
+
"GRAPHQL_MULTIPART_REQUEST_SPEC_URL.mjs",
|
|
31
|
+
"GraphQLUpload.mjs",
|
|
32
|
+
"graphqlUploadExpress.mjs",
|
|
33
|
+
"graphqlUploadKoa.mjs",
|
|
34
|
+
"ignoreStream.mjs",
|
|
35
|
+
"processRequest.mjs",
|
|
36
|
+
"Upload.mjs"
|
|
37
37
|
],
|
|
38
38
|
"sideEffects": false,
|
|
39
39
|
"exports": {
|
|
40
|
-
"./GraphQLUpload.
|
|
41
|
-
"./graphqlUploadExpress.
|
|
42
|
-
"./graphqlUploadKoa.
|
|
40
|
+
"./GraphQLUpload.mjs": "./GraphQLUpload.mjs",
|
|
41
|
+
"./graphqlUploadExpress.mjs": "./graphqlUploadExpress.mjs",
|
|
42
|
+
"./graphqlUploadKoa.mjs": "./graphqlUploadKoa.mjs",
|
|
43
43
|
"./package.json": "./package.json",
|
|
44
|
-
"./processRequest.
|
|
45
|
-
"./Upload.
|
|
44
|
+
"./processRequest.mjs": "./processRequest.mjs",
|
|
45
|
+
"./Upload.mjs": "./Upload.mjs"
|
|
46
46
|
},
|
|
47
47
|
"engines": {
|
|
48
48
|
"node": "^14.17.0 || ^16.0.0 || >= 18.0.0"
|
|
@@ -65,22 +65,22 @@
|
|
|
65
65
|
"@types/node": "*",
|
|
66
66
|
"@types/object-path": "^0.11.1",
|
|
67
67
|
"busboy": "^1.6.0",
|
|
68
|
-
"fs-capacitor": "^
|
|
68
|
+
"fs-capacitor": "^8.0.0",
|
|
69
69
|
"http-errors": "^2.0.0",
|
|
70
70
|
"object-path": "^0.11.8"
|
|
71
71
|
},
|
|
72
72
|
"devDependencies": {
|
|
73
73
|
"@types/express": "^4.17.13",
|
|
74
|
-
"@types/koa": "^2.13.
|
|
74
|
+
"@types/koa": "^2.13.5",
|
|
75
75
|
"coverage-node": "^6.1.0",
|
|
76
|
-
"eslint": "^8.
|
|
76
|
+
"eslint": "^8.20.0",
|
|
77
77
|
"eslint-plugin-simple-import-sort": "^7.0.0",
|
|
78
78
|
"express": "^4.18.1",
|
|
79
79
|
"form-data-encoder": "^2.0.1",
|
|
80
80
|
"graphql": "^16.5.0",
|
|
81
81
|
"koa": "^2.13.4",
|
|
82
82
|
"node-abort-controller": "^3.0.1",
|
|
83
|
-
"node-fetch": "^3.2.
|
|
83
|
+
"node-fetch": "^3.2.9",
|
|
84
84
|
"prettier": "^2.6.2",
|
|
85
85
|
"test-director": "^8.0.2",
|
|
86
86
|
"typescript": "^4.7.4"
|
|
@@ -1,16 +1,15 @@
|
|
|
1
1
|
// @ts-check
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
import busboy from "busboy";
|
|
4
|
+
import { WriteStream } from "fs-capacitor";
|
|
5
|
+
import createError from "http-errors";
|
|
6
|
+
import objectPath from "object-path";
|
|
4
7
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
const objectPath = require("object-path");
|
|
9
|
-
const GRAPHQL_MULTIPART_REQUEST_SPEC_URL = require("./GRAPHQL_MULTIPART_REQUEST_SPEC_URL.js");
|
|
10
|
-
const ignoreStream = require("./ignoreStream.js");
|
|
11
|
-
const Upload = require("./Upload.js");
|
|
8
|
+
import GRAPHQL_MULTIPART_REQUEST_SPEC_URL from "./GRAPHQL_MULTIPART_REQUEST_SPEC_URL.mjs";
|
|
9
|
+
import ignoreStream from "./ignoreStream.mjs";
|
|
10
|
+
import Upload from "./Upload.mjs";
|
|
12
11
|
|
|
13
|
-
/** @typedef {import("./GraphQLUpload.
|
|
12
|
+
/** @typedef {import("./GraphQLUpload.mjs").default} GraphQLUpload */
|
|
14
13
|
|
|
15
14
|
/**
|
|
16
15
|
* Processes an incoming
|
|
@@ -23,7 +22,7 @@ const Upload = require("./Upload.js");
|
|
|
23
22
|
* with appropriate HTTP status codes. Used to create custom middleware.
|
|
24
23
|
* @type {ProcessRequestFunction}
|
|
25
24
|
*/
|
|
26
|
-
function processRequest(
|
|
25
|
+
export default function processRequest(
|
|
27
26
|
request,
|
|
28
27
|
response,
|
|
29
28
|
{
|
|
@@ -346,8 +345,6 @@ function processRequest(
|
|
|
346
345
|
});
|
|
347
346
|
}
|
|
348
347
|
|
|
349
|
-
module.exports = processRequest;
|
|
350
|
-
|
|
351
348
|
/**
|
|
352
349
|
* File upload details that are only available after the file’s field in the
|
|
353
350
|
* [GraphQL multipart request](https://github.com/jaydenseric/graphql-multipart-request-spec)
|
|
@@ -383,17 +380,19 @@ module.exports = processRequest;
|
|
|
383
380
|
/**
|
|
384
381
|
* {@linkcode FileUploadCreateReadStream} options.
|
|
385
382
|
* @typedef {object} FileUploadCreateReadStreamOptions
|
|
386
|
-
* @prop {
|
|
387
|
-
* [
|
|
383
|
+
* @prop {import("fs-capacitor")
|
|
384
|
+
* .ReadStreamOptions["encoding"]} [options.encoding] Specify an encoding for
|
|
385
|
+
* the [`data`](https://nodejs.org/api/stream.html#event-data) chunks to be
|
|
388
386
|
* strings (without splitting multi-byte characters across chunks) instead of
|
|
389
387
|
* Node.js [`Buffer`](https://nodejs.org/api/buffer.html#buffer) instances.
|
|
390
388
|
* Supported values depend on the
|
|
391
389
|
* [`Buffer` implementation](https://github.com/nodejs/node/blob/v18.1.0/lib/buffer.js#L590-L680)
|
|
392
390
|
* and include `utf8`, `ucs2`, `utf16le`, `latin1`, `ascii`, `base64`,
|
|
393
391
|
* `base64url`, or `hex`. Defaults to `utf8`.
|
|
394
|
-
* @prop {
|
|
395
|
-
*
|
|
396
|
-
*
|
|
392
|
+
* @prop {import("fs-capacitor")
|
|
393
|
+
* .ReadStreamOptions["highWaterMark"]} [options.highWaterMark] Maximum number
|
|
394
|
+
* of bytes to store in the internal buffer before ceasing to read from the
|
|
395
|
+
* underlying resource. Defaults to `16384`.
|
|
397
396
|
*/
|
|
398
397
|
|
|
399
398
|
/**
|
package/readme.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
[](https://npm.im/graphql-upload) [](https://github.com/jaydenseric/graphql-upload/actions)
|
|
6
6
|
|
|
7
|
-
Middleware and an [`Upload`](./GraphQLUpload.
|
|
7
|
+
Middleware and an [`Upload`](./GraphQLUpload.mjs) scalar to add support for [GraphQL multipart requests](https://github.com/jaydenseric/graphql-multipart-request-spec) (file uploads via queries and mutations) to various Node.js GraphQL servers.
|
|
8
8
|
|
|
9
9
|
## Installation
|
|
10
10
|
|
|
@@ -16,13 +16,13 @@ To install [`graphql-upload`](https://npm.im/graphql-upload) and the [`graphql`]
|
|
|
16
16
|
npm install graphql-upload graphql
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
Use the [`graphqlUploadKoa`](./graphqlUploadKoa.
|
|
19
|
+
Use the [`graphqlUploadKoa`](./graphqlUploadKoa.mjs) or [`graphqlUploadExpress`](./graphqlUploadExpress.mjs) middleware just before GraphQL middleware. Alternatively, use [`processRequest`](./processRequest.mjs) to create custom middleware.
|
|
20
20
|
|
|
21
|
-
A schema built with separate SDL and resolvers (e.g. using [`makeExecutableSchema`](https://www.graphql-tools.com/docs/api/modules/schema_src#makeexecutableschema) from [`@graphql-tools/schema`](https://npm.im/@graphql-tools/schema)) requires the [`Upload`](./GraphQLUpload.
|
|
21
|
+
A schema built with separate SDL and resolvers (e.g. using [`makeExecutableSchema`](https://www.graphql-tools.com/docs/api/modules/schema_src#makeexecutableschema) from [`@graphql-tools/schema`](https://npm.im/@graphql-tools/schema)) requires the [`Upload`](./GraphQLUpload.mjs) scalar to be setup.
|
|
22
22
|
|
|
23
23
|
## Usage
|
|
24
24
|
|
|
25
|
-
[Clients implementing the GraphQL multipart request spec](https://github.com/jaydenseric/graphql-multipart-request-spec#client) upload files as [`Upload`](./GraphQLUpload.
|
|
25
|
+
[Clients implementing the GraphQL multipart request spec](https://github.com/jaydenseric/graphql-multipart-request-spec#client) upload files as [`Upload`](./GraphQLUpload.mjs) scalar query or mutation variables. Their resolver values are promises that resolve file upload details for processing and storage. Files are typically streamed into cloud storage but may also be stored in the filesystem.
|
|
26
26
|
|
|
27
27
|
See the [example API and client](https://github.com/jaydenseric/apollo-upload-examples).
|
|
28
28
|
|
|
@@ -40,7 +40,7 @@ See the [example API and client](https://github.com/jaydenseric/apollo-upload-ex
|
|
|
40
40
|
|
|
41
41
|
The [GraphQL multipart request spec](https://github.com/jaydenseric/graphql-multipart-request-spec) allows a file to be used for multiple query or mutation variables (file deduplication), and for variables to be used in multiple places. GraphQL resolvers need to be able to manage independent file streams. As resolvers are executed asynchronously, it’s possible they will try to process files in a different order than received in the multipart request.
|
|
42
42
|
|
|
43
|
-
[`busboy`](https://npm.im/busboy) parses multipart request streams. Once the `operations` and `map` fields have been parsed, [`Upload`](./GraphQLUpload.
|
|
43
|
+
[`busboy`](https://npm.im/busboy) parses multipart request streams. Once the `operations` and `map` fields have been parsed, [`Upload`](./GraphQLUpload.mjs) scalar values in the GraphQL operations are populated with promises, and the operations are passed down the middleware chain to GraphQL resolvers.
|
|
44
44
|
|
|
45
45
|
[`fs-capacitor`](https://npm.im/fs-capacitor) is used to buffer file uploads to the filesystem and coordinate simultaneous reading and writing. As soon as a file upload’s contents begins streaming, its data begins buffering to the filesystem and its associated promise resolves. GraphQL resolvers can then create new streams from the buffer by calling the function `createReadStream`. The buffer is destroyed once all streams have ended or closed and the server has responded to the request. Any remaining buffer files will be cleaned when the process exits.
|
|
46
46
|
|
|
@@ -50,10 +50,10 @@ The [GraphQL multipart request spec](https://github.com/jaydenseric/graphql-mult
|
|
|
50
50
|
|
|
51
51
|
## Exports
|
|
52
52
|
|
|
53
|
-
These
|
|
53
|
+
These ECMAScript modules are published to [npm](https://npmjs.com) and exported via the [`package.json`](./package.json) `exports` field:
|
|
54
54
|
|
|
55
|
-
- [`GraphQLUpload.
|
|
56
|
-
- [`graphqlUploadExpress.
|
|
57
|
-
- [`graphqlUploadKoa.
|
|
58
|
-
- [`processRequest.
|
|
59
|
-
- [`Upload.
|
|
55
|
+
- [`GraphQLUpload.mjs`](./GraphQLUpload.mjs)
|
|
56
|
+
- [`graphqlUploadExpress.mjs`](./graphqlUploadExpress.mjs)
|
|
57
|
+
- [`graphqlUploadKoa.mjs`](./graphqlUploadKoa.mjs)
|
|
58
|
+
- [`processRequest.mjs`](./processRequest.mjs)
|
|
59
|
+
- [`Upload.mjs`](./Upload.mjs)
|