@wordpress/core-data
Version:
Access to and manipulation of core WordPress entities.
8 lines (7 loc) • 7.19 kB
Source Map (JSON)
{
"version": 3,
"sources": ["../../src/batch/create-batch.js"],
"sourcesContent": ["/**\n * Internal dependencies\n */\nimport defaultProcessor from './default-processor';\n\n/**\n * Creates a batch, which can be used to combine multiple API requests into one\n * API request using the WordPress batch processing API (/v1/batch).\n *\n * ```\n * const batch = createBatch();\n * const dunePromise = batch.add( {\n * path: '/v1/books',\n * method: 'POST',\n * data: { title: 'Dune' }\n * } );\n * const lotrPromise = batch.add( {\n * path: '/v1/books',\n * method: 'POST',\n * data: { title: 'Lord of the Rings' }\n * } );\n * const isSuccess = await batch.run(); // Sends one POST to /v1/batch.\n * if ( isSuccess ) {\n * console.log(\n * 'Saved two books:',\n * await dunePromise,\n * await lotrPromise\n * );\n * }\n * ```\n *\n * @param {Function} [processor] Processor function. Can be used to replace the\n * default functionality which is to send an API\n * request to /v1/batch. Is given an array of\n * inputs and must return a promise that\n * resolves to an array of objects containing\n * either `output` or `error`.\n */\nexport default function createBatch( processor = defaultProcessor ) {\n\tlet lastId = 0;\n\t/** @type {Array<{ input: any; resolve: ( value: any ) => void; reject: ( error: any ) => void }>} */\n\tlet queue = [];\n\tconst pending = new ObservableSet();\n\n\treturn {\n\t\t/**\n\t\t * Adds an input to the batch and returns a promise that is resolved or\n\t\t * rejected when the input is processed by `batch.run()`.\n\t\t *\n\t\t * You may also pass a thunk which allows inputs to be added\n\t\t * asynchronously.\n\t\t *\n\t\t * ```\n\t\t * // Both are allowed:\n\t\t * batch.add( { path: '/v1/books', ... } );\n\t\t * batch.add( ( add ) => add( { path: '/v1/books', ... } ) );\n\t\t * ```\n\t\t *\n\t\t * If a thunk is passed, `batch.run()` will pause until either:\n\t\t *\n\t\t * - The thunk calls its `add` argument, or;\n\t\t * - The thunk returns a promise and that promise resolves, or;\n\t\t * - The thunk returns a non-promise.\n\t\t *\n\t\t * @param {any|Function} inputOrThunk Input to add or thunk to execute.\n\t\t *\n\t\t * @return {Promise|any} If given an input, returns a promise that\n\t\t * is resolved or rejected when the batch is\n\t\t * processed. If given a thunk, returns the return\n\t\t * value of that thunk.\n\t\t */\n\t\tadd( inputOrThunk ) {\n\t\t\tconst id = ++lastId;\n\t\t\tpending.add( id );\n\n\t\t\tconst add = ( input ) =>\n\t\t\t\tnew Promise( ( resolve, reject ) => {\n\t\t\t\t\tqueue.push( {\n\t\t\t\t\t\tinput,\n\t\t\t\t\t\tresolve,\n\t\t\t\t\t\treject,\n\t\t\t\t\t} );\n\t\t\t\t\tpending.delete( id );\n\t\t\t\t} );\n\n\t\t\tif ( typeof inputOrThunk === 'function' ) {\n\t\t\t\treturn Promise.resolve( inputOrThunk( add ) ).finally( () => {\n\t\t\t\t\tpending.delete( id );\n\t\t\t\t} );\n\t\t\t}\n\n\t\t\treturn add( inputOrThunk );\n\t\t},\n\n\t\t/**\n\t\t * Runs the batch. This calls `batchProcessor` and resolves or rejects\n\t\t * all promises returned by `add()`.\n\t\t *\n\t\t * @return {Promise<boolean>} A promise that resolves to a boolean that is true\n\t\t * if the processor returned no errors.\n\t\t */\n\t\tasync run() {\n\t\t\tif ( pending.size ) {\n\t\t\t\tawait new Promise( ( resolve ) => {\n\t\t\t\t\tconst unsubscribe = pending.subscribe( () => {\n\t\t\t\t\t\tif ( ! pending.size ) {\n\t\t\t\t\t\t\tunsubscribe();\n\t\t\t\t\t\t\tresolve( undefined );\n\t\t\t\t\t\t}\n\t\t\t\t\t} );\n\t\t\t\t} );\n\t\t\t}\n\n\t\t\tlet results;\n\n\t\t\ttry {\n\t\t\t\tresults = await processor(\n\t\t\t\t\tqueue.map( ( { input } ) => input )\n\t\t\t\t);\n\n\t\t\t\tif ( results.length !== queue.length ) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'run: Array returned by processor must be same size as input array.'\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t} catch ( error ) {\n\t\t\t\tfor ( const { reject } of queue ) {\n\t\t\t\t\treject( error );\n\t\t\t\t}\n\n\t\t\t\tthrow error;\n\t\t\t}\n\n\t\t\tlet isSuccess = true;\n\n\t\t\tresults.forEach( ( result, key ) => {\n\t\t\t\tconst queueItem = queue[ key ];\n\n\t\t\t\tif ( result?.error ) {\n\t\t\t\t\tqueueItem?.reject( result.error );\n\t\t\t\t\tisSuccess = false;\n\t\t\t\t} else {\n\t\t\t\t\tqueueItem?.resolve( result?.output ?? result );\n\t\t\t\t}\n\t\t\t} );\n\n\t\t\tqueue = [];\n\n\t\t\treturn isSuccess;\n\t\t},\n\t};\n}\n\nclass ObservableSet {\n\tconstructor( ...args ) {\n\t\tthis.set = new Set( ...args );\n\t\tthis.subscribers = new Set();\n\t}\n\n\tget size() {\n\t\treturn this.set.size;\n\t}\n\n\tadd( value ) {\n\t\tthis.set.add( value );\n\t\tthis.subscribers.forEach( ( subscriber ) => subscriber() );\n\t\treturn this;\n\t}\n\n\tdelete( value ) {\n\t\tconst isSuccess = this.set.delete( value );\n\t\tthis.subscribers.forEach( ( subscriber ) => subscriber() );\n\t\treturn isSuccess;\n\t}\n\n\tsubscribe( subscriber ) {\n\t\tthis.subscribers.add( subscriber );\n\t\treturn () => {\n\t\t\tthis.subscribers.delete( subscriber );\n\t\t};\n\t}\n}\n"],
"mappings": ";AAGA,OAAO,sBAAsB;AAmCd,SAAR,YAA8B,YAAY,kBAAmB;AACnE,MAAI,SAAS;AAEb,MAAI,QAAQ,CAAC;AACb,QAAM,UAAU,IAAI,cAAc;AAElC,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IA2BN,IAAK,cAAe;AACnB,YAAM,KAAK,EAAE;AACb,cAAQ,IAAK,EAAG;AAEhB,YAAM,MAAM,CAAE,UACb,IAAI,QAAS,CAAE,SAAS,WAAY;AACnC,cAAM,KAAM;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,QACD,CAAE;AACF,gBAAQ,OAAQ,EAAG;AAAA,MACpB,CAAE;AAEH,UAAK,OAAO,iBAAiB,YAAa;AACzC,eAAO,QAAQ,QAAS,aAAc,GAAI,CAAE,EAAE,QAAS,MAAM;AAC5D,kBAAQ,OAAQ,EAAG;AAAA,QACpB,CAAE;AAAA,MACH;AAEA,aAAO,IAAK,YAAa;AAAA,IAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASA,MAAM,MAAM;AACX,UAAK,QAAQ,MAAO;AACnB,cAAM,IAAI,QAAS,CAAE,YAAa;AACjC,gBAAM,cAAc,QAAQ,UAAW,MAAM;AAC5C,gBAAK,CAAE,QAAQ,MAAO;AACrB,0BAAY;AACZ,sBAAS,MAAU;AAAA,YACpB;AAAA,UACD,CAAE;AAAA,QACH,CAAE;AAAA,MACH;AAEA,UAAI;AAEJ,UAAI;AACH,kBAAU,MAAM;AAAA,UACf,MAAM,IAAK,CAAE,EAAE,MAAM,MAAO,KAAM;AAAA,QACnC;AAEA,YAAK,QAAQ,WAAW,MAAM,QAAS;AACtC,gBAAM,IAAI;AAAA,YACT;AAAA,UACD;AAAA,QACD;AAAA,MACD,SAAU,OAAQ;AACjB,mBAAY,EAAE,OAAO,KAAK,OAAQ;AACjC,iBAAQ,KAAM;AAAA,QACf;AAEA,cAAM;AAAA,MACP;AAEA,UAAI,YAAY;AAEhB,cAAQ,QAAS,CAAE,QAAQ,QAAS;AACnC,cAAM,YAAY,MAAO,GAAI;AAE7B,YAAK,QAAQ,OAAQ;AACpB,qBAAW,OAAQ,OAAO,KAAM;AAChC,sBAAY;AAAA,QACb,OAAO;AACN,qBAAW,QAAS,QAAQ,UAAU,MAAO;AAAA,QAC9C;AAAA,MACD,CAAE;AAEF,cAAQ,CAAC;AAET,aAAO;AAAA,IACR;AAAA,EACD;AACD;AAEA,IAAM,gBAAN,MAAoB;AAAA,EACnB,eAAgB,MAAO;AACtB,SAAK,MAAM,IAAI,IAAK,GAAG,IAAK;AAC5B,SAAK,cAAc,oBAAI,IAAI;AAAA,EAC5B;AAAA,EAEA,IAAI,OAAO;AACV,WAAO,KAAK,IAAI;AAAA,EACjB;AAAA,EAEA,IAAK,OAAQ;AACZ,SAAK,IAAI,IAAK,KAAM;AACpB,SAAK,YAAY,QAAS,CAAE,eAAgB,WAAW,CAAE;AACzD,WAAO;AAAA,EACR;AAAA,EAEA,OAAQ,OAAQ;AACf,UAAM,YAAY,KAAK,IAAI,OAAQ,KAAM;AACzC,SAAK,YAAY,QAAS,CAAE,eAAgB,WAAW,CAAE;AACzD,WAAO;AAAA,EACR;AAAA,EAEA,UAAW,YAAa;AACvB,SAAK,YAAY,IAAK,UAAW;AACjC,WAAO,MAAM;AACZ,WAAK,YAAY,OAAQ,UAAW;AAAA,IACrC;AAAA,EACD;AACD;",
"names": []
}