@eluvio/elv-client-js 4.0.144 → 4.0.146

package/dist/src/client/ABRPublishing.js

@@ -2,8 +2,8 @@ var _toConsumableArray = require("@babel/runtime/helpers/toConsumableArray");
 var _regeneratorRuntime = require("@babel/runtime/regenerator");
 var _defineProperty = require("@babel/runtime/helpers/defineProperty");
 var _asyncToGenerator = require("@babel/runtime/helpers/asyncToGenerator");
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /**
  * Methods for ABR video creation and management
  *
@@ -18,7 +18,8 @@ var _require = require("../Validation"),
   ValidateLibrary = _require.ValidateLibrary,
   ValidateVersion = _require.ValidateVersion,
   ValidateParameters = _require.ValidateParameters,
-  ValidateWriteToken = _require.ValidateWriteToken;
+  ValidateWriteToken = _require.ValidateWriteToken,
+  ValidateObject = _require.ValidateObject;
 
 // When `/abr_mezzanine/offerings` contains more than one entry, only 1 is the 'real' offering, the others are
 // additional copies to be modified upon finalization due to addlOfferingSpecs having been specified in call to
@@ -90,7 +91,7 @@ var MezJobMainOfferingKey = function MezJobMainOfferingKey(abrMezOfferings) {
  */
 exports.CreateProductionMaster = /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
-    var libraryId, type, writeToken, name, description, _ref$metadata, metadata, fileInfo, _ref$encrypt, encrypt, _ref$access, access, _ref$copy, copy, callback, _ref$respLogLevel, respLogLevel, _ref$structLogLevel, structLogLevel, id, finalize, _yield$this$CreateCon, s3prefixRegex, i, oneFileInfo, matched, j, credentialSet, credentialSetBucket, matchers, k, matcher, fileSourcePath, s3prefixMatch, bucketName, _i, _credentialSet, region, bucket, accessKey, secret, _yield$this$CallBitco, logs, errors, warnings, finalizeResponse;
+    var libraryId, type, writeToken, name, description, _ref$metadata, metadata, fileInfo, _ref$encrypt, encrypt, _ref$access, access, _ref$copy, copy, callback, _ref$respLogLevel, respLogLevel, _ref$structLogLevel, structLogLevel, objectId, finalize, _yield$this$CreateCon, s3prefixRegex, i, oneFileInfo, matched, j, credentialSet, credentialSetBucket, matchers, k, matcher, fileSourcePath, s3prefixMatch, bucketName, _i, _credentialSet, region, bucket, accessKey, secret, _yield$this$CallBitco, logs, errors, warnings, additionalReturnVals;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -101,7 +102,8 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
             _context.next = 7;
             break;
           }
-          id = this.utils.DecodeWriteToken(writeToken).objectId;
+          // if write token passed in, don't create a new object
+          objectId = this.utils.DecodeWriteToken(writeToken).objectId;
           _context.next = 12;
           break;
         case 7:
@@ -114,7 +116,7 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           });
         case 9:
           _yield$this$CreateCon = _context.sent;
-          id = _yield$this$CreateCon.id;
+          objectId = _yield$this$CreateCon.objectId;
           writeToken = _yield$this$CreateCon.writeToken;
         case 12:
           if (!fileInfo) {
@@ -215,7 +217,7 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           _context.next = 57;
           return this.UploadFilesFromS3({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             fileInfo: _credentialSet.matched,
             region: region,
@@ -237,7 +239,7 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           _context.next = 64;
           return this.UploadFiles({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             fileInfo: fileInfo,
             callback: callback,
@@ -247,7 +249,7 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           _context.next = 66;
           return this.CreateEncryptionConk({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             createKMSConk: true
           });
@@ -255,7 +257,7 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           _context.next = 68;
           return this.CallBitcodeMethod({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             method: UrlJoin("media", "production_master", "init"),
             queryParams: {
@@ -275,7 +277,7 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           _context.next = 74;
           return this.MergeMetadata({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             metadata: _objectSpread(_objectSpread({}, metadata || {}), {}, {
               name: name,
@@ -296,28 +298,28 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
           _context.next = 77;
           return this.FinalizeContentObject({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             commitMessage: "Create master",
             awaitCommitConfirmation: false
           });
         case 77:
-          finalizeResponse = _context.sent;
+          additionalReturnVals = _context.sent;
           _context.next = 81;
           break;
         case 80:
-          finalizeResponse = {
+          additionalReturnVals = {
             write_token: writeToken,
             type: type,
             qlib_id: libraryId,
-            id: id
+            id: objectId
           };
         case 81:
           return _context.abrupt("return", _objectSpread({
             errors: errors || [],
             logs: logs || [],
             warnings: warnings || []
-          }, finalizeResponse));
+          }, additionalReturnVals));
         case 82:
         case "end":
           return _context.stop();
@@ -340,8 +342,8 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
  * @param {boolean=} keepOtherStreams=false - If objectId is specified, whether to preserve existing streams with keys other than the ones specified in production master
  * @param {string} libraryId - ID of the mezzanine library
  * @param {string} masterVersionHash - The version hash of the production master content object
- * @param {string=} masterWriteToken - The write token of the production master content object draft. If provided, the object will not be finalized
- * @param {string=} writeToken - The write token of the mezzanine object draft. If specified, the object will not be finalized
+ * @param {string=} masterWriteToken - The write token of the production master content object draft.
+ * @param {string=} writeToken - The write token of the mezzanine object draft. If specified, the object will not be finalized, and no extra version of the object will be created to hold "bread crumb" metadata entry /lro_draft
  * @param {Object=} metadata - Additional metadata for mezzanine content object
  * @param {string} name - Name for mezzanine content object
  * @param {string=} objectId - ID of existing object (if not specified, new object will be created)
@@ -356,135 +358,156 @@ exports.CreateProductionMaster = /*#__PURE__*/function () {
  */
 exports.CreateABRMezzanine = /*#__PURE__*/function () {
   var _ref4 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(_ref3) {
-    var libraryId, objectId, type, name, description, metadata, masterVersionHash, masterWriteToken, writeToken, abrProfile, addlOfferingSpecs, _ref3$variant, variant, _ref3$offeringKey, offeringKey, _ref3$keepOtherStream, keepOtherStreams, _ref3$respLogLevel, respLogLevel, _ref3$structLogLevel, structLogLevel, streamKeys, masterObjectId, existingMez, options, id, finalize, _yield$this$EditConte, createResponse, nameMetaPayload, masterName, authorizationTokens, headers, body, storeClear, _yield$this$CallBitco2, logs, errors, warnings, masterId, existingMetadata, finalizeResponse;
+    var libraryId, objectId, type, name, description, metadata, masterVersionHash, masterWriteToken, writeToken, abrProfile, addlOfferingSpecs, _ref3$variant, variant, _ref3$offeringKey, offeringKey, _ref3$keepOtherStream, keepOtherStreams, _ref3$respLogLevel, respLogLevel, _ref3$structLogLevel, structLogLevel, streamKeys, masterObjectId, masterLibId, useExistingMez, options, finalize, _yield$this$EditConte, _yield$this$CreateCon2, masterMetaSource, masterName, authorizationTokens, headers, body, storeClear, _yield$this$CallBitco2, logs, errors, warnings, masterId, existingMetadata, additionalReturnVals;
     return _regeneratorRuntime.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
           libraryId = _ref3.libraryId, objectId = _ref3.objectId, type = _ref3.type, name = _ref3.name, description = _ref3.description, metadata = _ref3.metadata, masterVersionHash = _ref3.masterVersionHash, masterWriteToken = _ref3.masterWriteToken, writeToken = _ref3.writeToken, abrProfile = _ref3.abrProfile, addlOfferingSpecs = _ref3.addlOfferingSpecs, _ref3$variant = _ref3.variant, variant = _ref3$variant === void 0 ? "default" : _ref3$variant, _ref3$offeringKey = _ref3.offeringKey, offeringKey = _ref3$offeringKey === void 0 ? "default" : _ref3$offeringKey, _ref3$keepOtherStream = _ref3.keepOtherStreams, keepOtherStreams = _ref3$keepOtherStream === void 0 ? false : _ref3$keepOtherStream, _ref3$respLogLevel = _ref3.respLogLevel, respLogLevel = _ref3$respLogLevel === void 0 ? "warn" : _ref3$respLogLevel, _ref3$structLogLevel = _ref3.structLogLevel, structLogLevel = _ref3$structLogLevel === void 0 ? "none" : _ref3$structLogLevel, streamKeys = _ref3.streamKeys;
-          ValidateLibrary(libraryId);
-          if (masterVersionHash) {
-            ValidateVersion(masterVersionHash);
-          } else if (masterWriteToken) {
-            ValidateWriteToken(masterWriteToken);
-            masterObjectId = this.utils.DecodeWriteToken(masterWriteToken).objectId;
+          if (!(!masterVersionHash && !masterWriteToken)) {
+            _context2.next = 3;
+            break;
           }
-          if (writeToken) {
-            ValidateWriteToken(writeToken);
-            if (!objectId) {
-              objectId = this.utils.DecodeWriteToken(writeToken).objectId;
-            }
+          throw Error("Neither master version hash nor master write token specified. One must be provided");
+        case 3:
+          if (!(masterVersionHash && masterWriteToken)) {
+            _context2.next = 5;
+            break;
           }
-          if (!(!masterVersionHash && !masterWriteToken)) {
-            _context2.next = 6;
+          throw Error("Both master version hash and master write token specified. Only one can be provided");
+        case 5:
+          // double-check library id for mez
+          ValidateLibrary(libraryId);
+
+          // The following 2 vars are used only if masterWriteToken is passed in (to retrieve master name)
+          if (!masterVersionHash) {
+            _context2.next = 10;
             break;
           }
-          throw Error("Master version hash and master write token not specified. One must be provided");
-        case 6:
+          // NOTE: masterObjectId is left undefined if masterWriteToken not passed in
+          ValidateVersion(masterVersionHash);
+          _context2.next = 16;
+          break;
+        case 10:
+          if (!masterWriteToken) {
+            _context2.next = 16;
+            break;
+          }
+          // determine master object id if a master write token was passed in
+          ValidateWriteToken(masterWriteToken);
+          masterObjectId = this.utils.DecodeWriteToken(masterWriteToken).objectId;
+          _context2.next = 15;
+          return client.ContentObjectLibraryId({
+            masterObjectId: masterObjectId
+          });
+        case 15:
+          masterLibId = _context2.sent;
+        case 16:
+          // if pre-existing mez object id passed in, validate
+          if (objectId) ValidateObject(objectId);
+
+          // if mez write token supplied, validate it
+          if (writeToken) {
+            ValidateWriteToken(writeToken, objectId);
+
+            // if pre-existing mez object id not passed in, decode it from write token
+            objectId = objectId || this.utils.DecodeWriteToken(writeToken).objectId;
+          }
+          // After above, if objectId is undefined then no mez writeToken was passed in, no mez objectId was passed in,
+          // meaning we must create a new object
+          useExistingMez = !!objectId; // type coerce string or undefined to boolean: "" -> false, undefined -> false, all else -> true
           if (!(!objectId && keepOtherStreams)) {
-            _context2.next = 8;
+            _context2.next = 21;
             break;
           }
           throw Error("Existing mezzanine object ID required in order to use 'keepOtherStreams'");
-        case 8:
+        case 21:
           if (!(addlOfferingSpecs && !abrProfile)) {
-            _context2.next = 10;
+            _context2.next = 23;
             break;
           }
           throw Error("abrProfile required when using addlOfferingSpecs");
-        case 10:
-          existingMez = !!objectId;
+        case 23:
           options = type ? {
             type: type
           } : {};
-          finalize = !writeToken;
-          if (!existingMez) {
-            _context2.next = 25;
-            break;
-          }
-          if (!writeToken) {
-            _context2.next = 18;
+          finalize = !writeToken; // are we ingesting to an existing mez (and did NOT supply a write token?)
+          if (!(useExistingMez && !writeToken)) {
+            _context2.next = 30;
             break;
           }
-          id = objectId;
-          _context2.next = 23;
-          break;
-        case 18:
-          _context2.next = 20;
+          _context2.next = 28;
           return this.EditContentObject({
             libraryId: libraryId,
             objectId: objectId,
             options: options
           });
-        case 20:
+        case 28:
           _yield$this$EditConte = _context2.sent;
           writeToken = _yield$this$EditConte.writeToken;
-          id = _yield$this$EditConte.id;
-        case 23:
-          _context2.next = 30;
-          break;
-        case 25:
-          _context2.next = 27;
+        case 30:
+          if (useExistingMez) {
+            _context2.next = 36;
+            break;
+          }
+          _context2.next = 33;
           return this.CreateContentObject({
             libraryId: libraryId,
             options: options
           });
-        case 27:
-          createResponse = _context2.sent;
-          id = createResponse.id;
-          writeToken = createResponse.write_token;
-        case 30:
-          _context2.next = 32;
+        case 33:
+          _yield$this$CreateCon2 = _context2.sent;
+          objectId = _yield$this$CreateCon2.objectId;
+          writeToken = _yield$this$CreateCon2.writeToken;
+        case 36:
+          _context2.next = 38;
           return this.CreateEncryptionConk({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             createKMSConk: true
           });
-        case 32:
-          if (masterWriteToken) {
-            nameMetaPayload = {
-              libraryId: libraryId,
-              objectId: masterObjectId,
-              writeToken: masterWriteToken
-            };
-          } else if (masterVersionHash) {
-            nameMetaPayload = {
-              versionHash: masterVersionHash
-            };
-          }
-          _context2.next = 35;
-          return this.ContentObjectMetadata(_objectSpread(_objectSpread({}, nameMetaPayload), {}, {
+        case 38:
+          // figure out where to read master metadata from
+          masterMetaSource = masterWriteToken ? {
+            libraryId: masterLibId,
+            objectId: masterObjectId,
+            writeToken: masterWriteToken
+          } : {
+            versionHash: masterVersionHash
+          };
+          _context2.next = 41;
+          return this.ContentObjectMetadata(_objectSpread(_objectSpread({}, masterMetaSource), {}, {
             metadataSubtree: "public/name"
           }));
-        case 35:
+        case 41:
           masterName = _context2.sent;
           // Include authorization for library, master, and mezzanine
           authorizationTokens = [];
           _context2.t0 = authorizationTokens;
-          _context2.next = 40;
+          _context2.next = 46;
           return this.authClient.AuthorizationToken({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             update: true
           });
-        case 40:
+        case 46:
           _context2.t1 = _context2.sent;
           _context2.t0.push.call(_context2.t0, _context2.t1);
           _context2.t2 = authorizationTokens;
-          _context2.next = 45;
+          _context2.next = 51;
           return this.authClient.AuthorizationToken({
             libraryId: libraryId
           });
-        case 45:
+        case 51:
           _context2.t3 = _context2.sent;
           _context2.t2.push.call(_context2.t2, _context2.t3);
           _context2.t4 = authorizationTokens;
-          _context2.next = 50;
+          _context2.next = 56;
           return this.authClient.AuthorizationToken({
             versionHash: masterVersionHash,
             objectId: masterObjectId
           });
-        case 50:
+        case 56:
           _context2.t5 = _context2.sent;
           _context2.t4.push.call(_context2.t4, _context2.t5);
           headers = {
@@ -500,40 +523,39 @@ exports.CreateABRMezzanine = /*#__PURE__*/function () {
             stream_keys: streamKeys,
             variant_key: variant
           };
-          storeClear = false;
           if (!abrProfile) {
-            _context2.next = 60;
+            _context2.next = 65;
             break;
           }
           body.abr_profile = abrProfile;
           storeClear = abrProfile.store_clear;
-          _context2.next = 63;
+          _context2.next = 68;
           break;
-        case 60:
-          _context2.next = 62;
+        case 65:
+          _context2.next = 67;
           return this.ContentObjectMetadata({
             libraryId: libraryId,
             objectId: this.utils.AddressToObjectId(this.utils.HashToAddress(libraryId)),
             metadataSubtree: "abr_profile/store_clear"
           });
-        case 62:
+        case 67:
           storeClear = _context2.sent;
-        case 63:
+        case 68:
           if (storeClear) {
-            _context2.next = 66;
+            _context2.next = 71;
             break;
           }
-          _context2.next = 66;
+          _context2.next = 71;
           return this.EncryptionConk({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken
           });
-        case 66:
-          _context2.next = 68;
+        case 71:
+          _context2.next = 73;
           return this.CallBitcodeMethod({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             method: UrlJoin("media", "abr_mezzanine", "init"),
             queryParams: {
@@ -544,7 +566,7 @@ exports.CreateABRMezzanine = /*#__PURE__*/function () {
             body: body,
             constant: false
           });
-        case 68:
+        case 73:
           _yield$this$CallBitco2 = _context2.sent;
           logs = _yield$this$CallBitco2.logs;
           errors = _yield$this$CallBitco2.errors;
@@ -575,70 +597,70 @@ exports.CreateABRMezzanine = /*#__PURE__*/function () {
               "/": "./rep/playout/".concat(offeringKey, "/options.json")
             })
           }, metadata["public"].asset_metadata);
-          if (name || !existingMez) {
+          if (name || !useExistingMez) {
             metadata.name = name || "".concat(masterName, " Mezzanine");
             metadata["public"].name = name || "".concat(masterName, " Mezzanine");
           }
-          if (description || !existingMez) {
+          if (description || !useExistingMez) {
             metadata.description = description || "";
             metadata["public"].description = description || "";
           }
 
           // retrieve existing metadata to merge with updated metadata
-          _context2.next = 83;
+          _context2.next = 88;
           return this.ContentObjectMetadata({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken
           });
-        case 83:
+        case 88:
           existingMetadata = _context2.sent;
           // newer metadata values replace existing metadata, unless both new and old values are objects,
           // in which case their keys are merged recursively
           metadata = R.mergeDeepRight(existingMetadata, metadata);
-          if (!existingMez) {
+          if (!useExistingMez) {
             // set creation date
             metadata.elv_created_at = new Date().getTime();
           }
 
           // write metadata to mezzanine object
-          _context2.next = 88;
+          _context2.next = 93;
           return this.ReplaceMetadata({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             metadata: metadata
           });
-        case 88:
+        case 93:
           if (!finalize) {
-            _context2.next = 94;
+            _context2.next = 99;
             break;
           }
-          _context2.next = 91;
+          _context2.next = 96;
           return this.FinalizeContentObject({
             libraryId: libraryId,
-            objectId: id,
+            objectId: objectId,
             writeToken: writeToken,
             commitMessage: "Create ABR mezzanine"
           });
-        case 91:
-          finalizeResponse = _context2.sent;
-          _context2.next = 95;
+        case 96:
+          additionalReturnVals = _context2.sent;
+          _context2.next = 100;
           break;
-        case 94:
-          finalizeResponse = {
+        case 99:
+          additionalReturnVals = {
             write_token: writeToken,
             type: type,
             qlib_id: libraryId,
-            id: id
+            id: objectId
           };
-        case 95:
+        case 100:
           return _context2.abrupt("return", _objectSpread({
             logs: logs || [],
             warnings: warnings || [],
             errors: errors || []
-          }, finalizeResponse));
-        case 96:
+          }, additionalReturnVals));
+        case 101:
         case "end":
           return _context2.stop();
       }
@@ -656,7 +678,7 @@ exports.CreateABRMezzanine = /*#__PURE__*/function () {
  * @namedParams
  * @param {string} libraryId - ID of the mezzanine library
  * @param {string} objectId - ID of the mezzanine object
- * @param {string=} writeToken - Write token of the mezzanine object draft. If provided, the object will not be finalized
+ * @param {string=} writeToken - Write token of the mezzanine object draft. If provided, no "bread crumb" metadata /lro_draft will be created, nor saved as an extra finalized version
  * @param {Array<Object>=} access - Array of S3 credentials, along with path matching regexes - Required if any files in the masters are S3 references (See CreateProductionMaster method)
  * - Format: {region, bucket, accessKey, secret}
  * @param {number[]} jobIndexes - Array of LRO job indexes to start. LROs are listed in a map under metadata key /abr_mezzanine/offerings/(offeringKey)/mez_prep_specs/, and job indexes start with 0, corresponding to map keys in alphabetical order
@@ -666,7 +688,7 @@ exports.CreateABRMezzanine = /*#__PURE__*/function () {
 exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
   var _ref6 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4(_ref5) {
     var _this = this;
-    var libraryId, objectId, writeToken, _ref5$access, access, _ref5$jobIndexes, jobIndexes, lastJobOfferingsInfo, offeringKey, prepSpecs, masterVersionHashes, authorizationTokens, headers, processingDraft, nodeUrl, lroInfo, finalizeResponse, statusDraft, _yield$this$CallBitco3, data, errors, warnings, logs;
+    var libraryId, objectId, writeToken, _ref5$access, access, _ref5$jobIndexes, jobIndexes, writeTokenSupplied, lastJobOfferingsInfo, offeringKey, prepSpecs, masterVersionHashes, authorizationTokens, headers, breadCrumb, breadCrumbHash, lroWorkingDraft, breadCrumbDraft, finalizeResponse, nodeUrl, _yield$this$CallBitco3, data, errors, warnings, logs;
     return _regeneratorRuntime.wrap(function _callee4$(_context4) {
       while (1) switch (_context4.prev = _context4.next) {
         case 0:
@@ -675,29 +697,28 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
             libraryId: libraryId,
             objectId: objectId
           });
-          if (writeToken) {
-            ValidateWriteToken(writeToken);
-            if (!objectId) {
-              objectId = this.utils.DecodeWriteToken(writeToken).objectId;
-            }
+          writeTokenSupplied = !!writeToken;
+          if (writeTokenSupplied) {
+            ValidateWriteToken(writeToken, objectId);
+            objectId = objectId || this.utils.DecodeWriteToken(writeToken).objectId;
           }
-          _context4.next = 5;
+          _context4.next = 6;
           return this.ContentObjectMetadata({
             libraryId: libraryId,
             objectId: objectId,
             writeToken: writeToken,
             metadataSubtree: UrlJoin("abr_mezzanine", "offerings")
           });
-        case 5:
+        case 6:
           lastJobOfferingsInfo = _context4.sent;
           offeringKey = MezJobMainOfferingKey(lastJobOfferingsInfo);
           prepSpecs = lastJobOfferingsInfo[offeringKey].mez_prep_specs;
           if (prepSpecs) {
-            _context4.next = 10;
+            _context4.next = 11;
             break;
           }
           throw Error("No stream preparation specs found");
-        case 10:
+        case 11:
           // Retrieve all masters associated with this offering
           masterVersionHashes = Object.keys(prepSpecs).map(function (spec) {
             return (prepSpecs[spec].source_streams || []).map(function (stream) {
@@ -711,7 +732,7 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
           });
 
           // Retrieve authorization tokens for all masters and the mezzanine
-          _context4.next = 14;
+          _context4.next = 15;
           return Promise.all(masterVersionHashes.map( /*#__PURE__*/function () {
             var _ref7 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(versionHash) {
               var payload;
@@ -738,15 +759,15 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
               return _ref7.apply(this, arguments);
             };
           }()));
-        case 14:
+        case 15:
           authorizationTokens = _context4.sent;
-          _context4.next = 17;
+          _context4.next = 18;
           return this.authClient.AuthorizationToken({
             libraryId: libraryId,
             objectId: objectId,
             update: true
           });
-        case 17:
+        case 18:
           _context4.t0 = _context4.sent;
           authorizationTokens = [_context4.t0].concat(_toConsumableArray(authorizationTokens));
           headers = {
@@ -754,83 +775,71 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
               return "Bearer ".concat(token);
             }).join(",")
           };
-          if (!writeToken) {
-            _context4.next = 27;
+          if (writeTokenSupplied) {
+            _context4.next = 36;
             break;
           }
-          _context4.next = 23;
-          return this.WriteTokenNodeUrlNetwork({
-            writeToken: writeToken
-          });
-        case 23:
-          nodeUrl = _context4.sent;
-          processingDraft = {
-            write_token: writeToken,
-            nodeUrl: nodeUrl
-          };
-          _context4.next = 30;
-          break;
-        case 27:
-          _context4.next = 29;
+          _context4.next = 24;
           return this.EditContentObject({
             libraryId: libraryId,
             objectId: objectId
           });
-        case 29:
-          processingDraft = _context4.sent;
-        case 30:
-          lroInfo = {
-            write_token: processingDraft.write_token,
-            node: processingDraft.nodeUrl,
-            offering: offeringKey
-          }; // Update metadata with LRO version write token
-          if (!writeToken) {
-            _context4.next = 36;
-            break;
-          }
-          _context4.next = 34;
-          return this.ReplaceMetadata({
-            libraryId: libraryId,
-            objectId: objectId,
-            writeToken: writeToken,
-            metadataSubtree: "lro_draft",
-            metadata: lroInfo
-          });
-        case 34:
-          _context4.next = 44;
-          break;
-        case 36:
-          _context4.next = 38;
+        case 24:
+          lroWorkingDraft = _context4.sent;
+          writeToken = lroWorkingDraft.writeToken;
+
+          // Save this write token (and node url, and offering key) to ANOTHER, NEW write token in order to
+          // record "bread crumb" metadata at /lro_draft, and save (finalize) this second write token
+          _context4.next = 28;
           return this.EditContentObject({
             libraryId: libraryId,
             objectId: objectId
           });
-        case 38:
-          statusDraft = _context4.sent;
-          _context4.next = 41;
+        case 28:
+          breadCrumbDraft = _context4.sent;
+          breadCrumb = {
+            write_token: lroWorkingDraft.writeToken,
+            node: lroWorkingDraft.nodeUrl,
+            offering: offeringKey
+          };
+          _context4.next = 32;
           return this.ReplaceMetadata({
             libraryId: libraryId,
             objectId: objectId,
-            writeToken: statusDraft.write_token,
+            writeToken: breadCrumbDraft.writeToken,
             metadataSubtree: "lro_draft",
-            metadata: lroInfo
+            metadata: breadCrumb
           });
-        case 41:
-          _context4.next = 43;
+        case 32:
+          _context4.next = 34;
           return this.FinalizeContentObject({
             libraryId: libraryId,
             objectId: objectId,
-            writeToken: statusDraft.write_token,
-            commitMessage: "Mezzanine LRO status"
+            writeToken: breadCrumbDraft.write_token,
+            commitMessage: "Save mez LRO write token to /lro_draft"
           });
-        case 43:
+        case 34:
           finalizeResponse = _context4.sent;
-        case 44:
-          _context4.next = 46;
+          breadCrumbHash = finalizeResponse.hash;
+        case 36:
+          _context4.next = 38;
+          return this.WriteTokenNodeUrlNetwork({
+            writeToken: writeToken
+          });
+        case 38:
+          nodeUrl = _context4.sent;
+          // tell http client what node to contact for this write token
+          this.RecordWriteToken({
+            writeToken: writeToken,
+            fabricNodeUrl: nodeUrl
+          });
+
+          // Make the API call that actually starts the LROs
+          _context4.next = 42;
           return this.CallBitcodeMethod({
             libraryId: libraryId,
             objectId: objectId,
-            writeToken: processingDraft.write_token,
+            writeToken: writeToken,
             headers: headers,
             method: UrlJoin("media", "abr_mezzanine", "prep_start"),
             constant: false,
@@ -840,23 +849,23 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
               job_indexes: jobIndexes
             }
           });
-        case 46:
+        case 42:
           _yield$this$CallBitco3 = _context4.sent;
           data = _yield$this$CallBitco3.data;
           errors = _yield$this$CallBitco3.errors;
           warnings = _yield$this$CallBitco3.warnings;
           logs = _yield$this$CallBitco3.logs;
           return _context4.abrupt("return", {
-            hash: finalizeResponse ? finalizeResponse.hash : "",
-            lro_draft: lroInfo,
-            writeToken: processingDraft.write_token,
-            nodeUrl: processingDraft.nodeUrl,
+            hash: breadCrumbHash,
+            lro_draft: breadCrumb,
+            writeToken: writeToken,
+            nodeUrl: nodeUrl,
             data: data,
             logs: logs || [],
             warnings: warnings || [],
             errors: errors || []
           });
-        case 52:
+        case 48:
         case "end":
           return _context4.stop();
       }
@@ -871,6 +880,10 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
  * Retrieve node and write token for a mezzanine's current offering preparation job (if any).
  * Also returns the offering key.
  *
+ * This information is contained in metadata at /lro_draft, in an extra version of the object
+ * that gets created and finalized as part of creating a mezzanine. This serves as a "bread crumb trail" to
+ * allow users to find the active draft/write token that the ingest LROs are writing to.
+ *
  * @methodGroup ABR Publishing
  * @namedParams
  * @param {string} libraryId - ID of the library
@@ -880,16 +893,15 @@ exports.StartABRMezzanineJobs = /*#__PURE__*/function () {
  */
 exports.LRODraftInfo = /*#__PURE__*/function () {
   var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(_ref8) {
-    var libraryId, objectId, writeToken, standardPathContents, lastJobOfferingsInfo, mainOfferingKey, ready, oldPathContents;
+    var libraryId, objectId, standardPathContents, lastJobOfferingsInfo, mainOfferingKey, ready, oldPathContents;
     return _regeneratorRuntime.wrap(function _callee5$(_context5) {
       while (1) switch (_context5.prev = _context5.next) {
         case 0:
-          libraryId = _ref8.libraryId, objectId = _ref8.objectId, writeToken = _ref8.writeToken;
+          libraryId = _ref8.libraryId, objectId = _ref8.objectId;
           _context5.next = 3;
           return this.ContentObjectMetadata({
             libraryId: libraryId,
             objectId: objectId,
-            writeToken: writeToken,
             metadataSubtree: "lro_draft"
           });
         case 3:
@@ -959,47 +971,67 @@ exports.LRODraftInfo = /*#__PURE__*/function () {
 
 /**
  * Retrieve status information for mezzanine transcoding jobs, aka long running operations (LROs) on the given object.
+ * If a write token is passed in, its draft will be checked directly by lookiing at /lro_status.
+ * If a write token is not passed in, then the latest version of objectId will be checked for "bread crumb" entry
+ * at /lro_draft, to determine the write token that current ingest LRO(s) are writing to.
  *
  * @methodGroup ABR Publishing
  * @namedParams
  * @param {string} libraryId - ID of the library
  * @param {string} objectId - ID of the object
+ * @param {string=} writeToken - Write token of the active draft (that the transcode LROs are writing to)
  *
  * @return {Promise<Object>} - LRO status
  */
 exports.LROStatus = /*#__PURE__*/function () {
   var _ref11 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee6(_ref10) {
-    var libraryId, objectId, writeToken, lroDraft;
+    var libraryId, objectId, _ref10$writeToken, writeToken, activeWriteToken, lroDraft, fabricNodeUrl;
     return _regeneratorRuntime.wrap(function _callee6$(_context6) {
       while (1) switch (_context6.prev = _context6.next) {
         case 0:
-          libraryId = _ref10.libraryId, objectId = _ref10.objectId, writeToken = _ref10.writeToken;
+          libraryId = _ref10.libraryId, objectId = _ref10.objectId, _ref10$writeToken = _ref10.writeToken, writeToken = _ref10$writeToken === void 0 ? "" : _ref10$writeToken;
           ValidateParameters({
             libraryId: libraryId,
             objectId: objectId
           });
-          _context6.next = 4;
+          if (!writeToken) {
+            _context6.next = 7;
+            break;
+          }
+          ValidateWriteToken(writeToken, objectId);
+          activeWriteToken = writeToken;
+          _context6.next = 15;
+          break;
+        case 7:
+          _context6.next = 9;
           return this.LRODraftInfo({
             libraryId: libraryId,
-            objectId: objectId,
-            writeToken: writeToken
+            objectId: objectId
           });
-        case 4:
+        case 9:
           lroDraft = _context6.sent;
+          activeWriteToken = lroDraft.write_token;
+          _context6.next = 13;
+          return this.WriteTokenNodeUrlNetwork({
+            writeToken: activeWriteToken
+          });
+        case 13:
+          fabricNodeUrl = _context6.sent;
           this.RecordWriteToken({
             writeToken: lroDraft.write_token,
-            fabricNodeUrl: lroDraft.node
+            fabricNodeUrl: fabricNodeUrl
           });
-          _context6.next = 8;
+        case 15:
+          _context6.next = 17;
           return this.ContentObjectMetadata({
             libraryId: libraryId,
             objectId: objectId,
-            writeToken: writeToken,
+            writeToken: activeWriteToken,
             metadataSubtree: "lro_status"
           });
-        case 8:
+        case 17:
           return _context6.abrupt("return", _context6.sent);
-        case 9:
+        case 18:
         case "end":
           return _context6.stop();
       }
@@ -1011,13 +1043,17 @@ exports.LROStatus = /*#__PURE__*/function () {
 }();
 
 /**
- * Finalize a mezzanine object after all jobs have finished
+ * Process completed mezzanine transcoding LRO(s), creating the final offering(s) from the transcode(s)
+ * Unless a writeToken is passed in, finalize the mez object working draft as well.
+ *
+ * If a writeToken is not passed in, then it will be retrieved from /lro_draft of most recent version of object.
+ * This is a "bread crumb" entry that gets created by StartABRMezzanineJobs() - unless a writeToken was passed in to StartABRMezzanineJobs() also.
  *
  * @methodGroup ABR Publishing
  * @namedParams
  * @param {string} libraryId - ID of the mezzanine library
  * @param {string} objectId - ID of the mezzanine object
- * @param {string} writeToken - Write token for the mezzanine object. If specified, the object will not be finalized.
+ * @param {string=} writeToken - Write token for the mezzanine object. If specified, the object will not be finalized.
  * @param {function=} preFinalizeFn - A function to call before finalizing changes, to allow further modifications to offering. The function will be invoked with {elvClient, nodeUrl, writeToken} to allow access to the draft and MUST NOT finalize the draft.
  * @param {boolean=} preFinalizeThrow - If set to `true` then any error thrown by preFinalizeFn will not be caught. Otherwise, any exception will be appended to the `warnings` array returned after finalization.
  *
@@ -1025,59 +1061,75 @@ exports.LROStatus = /*#__PURE__*/function () {
  */
 exports.FinalizeABRMezzanine = /*#__PURE__*/function () {
   var _ref13 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee7(_ref12) {
-    var libraryId, objectId, preFinalizeFn, preFinalizeThrow, writeToken, nodeUrl, lastJobOfferingsInfo, offeringKey, masterHash, authPayload, authorizationTokens, headers, _yield$this$CallBitco4, data, errors, warnings, logs, preFinalizeWarnings, params, finalizeResponse;
+    var libraryId, objectId, preFinalizeFn, preFinalizeThrow, _ref12$writeToken, writeToken, writeTokenSupplied, lroDraft, fabricNodeUrl, lastJobOfferingsInfo, offeringKey, masterHash, masterIdentifier, authorizationTokens, headers, _yield$this$CallBitco4, data, errors, warnings, logs, preFinalizeWarnings, params, finalizeResponse;
     return _regeneratorRuntime.wrap(function _callee7$(_context7) {
       while (1) switch (_context7.prev = _context7.next) {
         case 0:
-          libraryId = _ref12.libraryId, objectId = _ref12.objectId, preFinalizeFn = _ref12.preFinalizeFn, preFinalizeThrow = _ref12.preFinalizeThrow, writeToken = _ref12.writeToken;
+          libraryId = _ref12.libraryId, objectId = _ref12.objectId, preFinalizeFn = _ref12.preFinalizeFn, preFinalizeThrow = _ref12.preFinalizeThrow, _ref12$writeToken = _ref12.writeToken, writeToken = _ref12$writeToken === void 0 ? "" : _ref12$writeToken;
           ValidateParameters({
             libraryId: libraryId,
             objectId: objectId
           });
-          if (writeToken) {
-            ValidateWriteToken(writeToken);
+          writeTokenSupplied = !!writeToken;
+          if (!writeTokenSupplied) {
+            _context7.next = 8;
+            break;
           }
-          _context7.next = 5;
+          ValidateWriteToken(writeToken, objectId);
+          objectId = objectId || this.utils.DecodeWriteToken(writeToken).objectId;
+          _context7.next = 12;
+          break;
+        case 8:
+          _context7.next = 10;
+          return this.LRODraftInfo({
+            libraryId: libraryId,
+            objectId: objectId
+          });
+        case 10:
+          lroDraft = _context7.sent;
+          writeToken = lroDraft.write_token;
+        case 12:
+          _context7.next = 14;
           return this.WriteTokenNodeUrlNetwork({
             writeToken: writeToken
           });
-        case 5:
-          nodeUrl = _context7.sent;
+        case 14:
+          fabricNodeUrl = _context7.sent;
           // tell http client what node to contact for this write token
           this.RecordWriteToken({
             writeToken: writeToken,
-            fabricNodeUrl: nodeUrl
+            fabricNodeUrl: fabricNodeUrl
           });
-          _context7.next = 9;
+          _context7.next = 18;
           return this.ContentObjectMetadata({
             libraryId: libraryId,
             objectId: objectId,
             writeToken: writeToken,
             metadataSubtree: UrlJoin("abr_mezzanine", "offerings")
           });
-        case 9:
+        case 18:
           lastJobOfferingsInfo = _context7.sent;
           offeringKey = MezJobMainOfferingKey(lastJobOfferingsInfo);
           masterHash = lastJobOfferingsInfo[offeringKey].prod_master_hash;
-          authPayload = {};
+          masterIdentifier = {};
           if (masterHash.startsWith("tqw__")) {
-            authPayload["objectId"] = this.utils.DecodeWriteToken(masterHash).objectId;
+            masterIdentifier["objectId"] = this.utils.DecodeWriteToken(masterHash).objectId;
           } else {
-            authPayload["versionHash"] = masterHash;
+            masterIdentifier["versionHash"] = masterHash;
           }
 
           // Authorization token for mezzanine and master
-          _context7.next = 16;
+          _context7.next = 25;
           return this.authClient.AuthorizationToken({
             libraryId: libraryId,
             objectId: objectId,
             update: true
           });
-        case 16:
+        case 25:
           _context7.t0 = _context7.sent;
-          _context7.next = 19;
-          return this.authClient.AuthorizationToken(_objectSpread({}, authPayload));
-        case 19:
+          _context7.next = 28;
+          return this.authClient.AuthorizationToken(_objectSpread({}, masterIdentifier));
+        case 28:
           _context7.t1 = _context7.sent;
           authorizationTokens = [_context7.t0, _context7.t1];
           headers = {
@@ -1085,7 +1137,7 @@ exports.FinalizeABRMezzanine = /*#__PURE__*/function () {
               return "Bearer ".concat(token);
             }).join(",")
           };
-          _context7.next = 24;
+          _context7.next = 33;
           return this.CallBitcodeMethod({
             objectId: objectId,
             libraryId: libraryId,
@@ -1094,7 +1146,7 @@ exports.FinalizeABRMezzanine = /*#__PURE__*/function () {
             headers: headers,
             constant: false
           });
-        case 24:
+        case 33:
           _yield$this$CallBitco4 = _context7.sent;
           data = _yield$this$CallBitco4.data;
           errors = _yield$this$CallBitco4.errors;
@@ -1102,7 +1154,7 @@ exports.FinalizeABRMezzanine = /*#__PURE__*/function () {
           logs = _yield$this$CallBitco4.logs;
           preFinalizeWarnings = [];
           if (!preFinalizeFn) {
-            _context7.next = 44;
+            _context7.next = 53;
             break;
           }
           params = {
@@ -1110,31 +1162,34 @@ exports.FinalizeABRMezzanine = /*#__PURE__*/function () {
             offeringKey: offeringKey,
             writeToken: writeToken
           };
-          _context7.prev = 32;
-          _context7.next = 35;
-          return preFinalizeFn(params);
-        case 35:
+          _context7.prev = 41;
           _context7.next = 44;
+          return preFinalizeFn(params);
+        case 44:
+          _context7.next = 53;
           break;
-        case 37:
-          _context7.prev = 37;
-          _context7.t2 = _context7["catch"](32);
+        case 46:
+          _context7.prev = 46;
+          _context7.t2 = _context7["catch"](41);
           if (!preFinalizeThrow) {
-            _context7.next = 43;
+            _context7.next = 52;
             break;
           }
           throw new Error("Error running preFinalize function", {
             cause: _context7.t2
           });
-        case 43:
+        case 52:
           preFinalizeWarnings = "Error running preFinalize function: ".concat(_context7.t2);
-        case 44:
-          finalizeResponse = {};
-          if (writeToken) {
-            _context7.next = 49;
+        case 53:
+          if (!writeTokenSupplied) {
+            _context7.next = 57;
             break;
           }
-          _context7.next = 48;
+          _context7.t3 = {};
+          _context7.next = 60;
+          break;
+        case 57:
+          _context7.next = 59;
           return this.FinalizeContentObject({
             libraryId: libraryId,
             objectId: objectId,
@@ -1142,20 +1197,21 @@ exports.FinalizeABRMezzanine = /*#__PURE__*/function () {
             commitMessage: "Finalize ABR mezzanine",
             awaitCommitConfirmation: false
           });
-        case 48:
-          finalizeResponse = _context7.sent;
-        case 49:
+        case 59:
+          _context7.t3 = _context7.sent;
+        case 60:
+          finalizeResponse = _context7.t3;
           return _context7.abrupt("return", _objectSpread({
             data: data,
             logs: logs || [],
             warnings: (warnings || []).concat(preFinalizeWarnings),
             errors: errors || []
           }, finalizeResponse));
-        case 50:
+        case 62:
         case "end":
           return _context7.stop();
       }
-    }, _callee7, this, [[32, 37]]);
+    }, _callee7, this, [[41, 46]]);
   }));
   return function (_x7) {
     return _ref13.apply(this, arguments);