@taskcluster/client-web 88.0.1

package/src/clients/WorkerManagerEvents.js

@@ -0,0 +1,112 @@
+// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+
+import Client from '../Client';
+
+export default class WorkerManagerEvents extends Client {
+  constructor(options = {}) {
+    super({
+      serviceName: 'worker-manager',
+      serviceVersion: 'v1',
+      exchangePrefix: 'exchange/taskcluster-worker-manager/v1/',
+      ...options,
+    });
+  }
+  /* eslint-disable max-len */
+  // Whenever the api receives a request to create a
+  // worker pool, a message is posted to this exchange and
+  // a provider can act upon it.
+  /* eslint-enable max-len */
+  workerPoolCreated(pattern) {
+    const entry = {"exchange":"worker-pool-created","name":"workerPoolCreated","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":false},{"multipleWords":false,"name":"provisionerId","required":false},{"multipleWords":false,"name":"workerType","required":false},{"multipleWords":false,"name":"workerGroup","required":false},{"multipleWords":false,"name":"workerId","required":false},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-pool-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever the api receives a request to update a
+  // worker pool, a message is posted to this exchange and
+  // a provider can act upon it.
+  /* eslint-enable max-len */
+  workerPoolUpdated(pattern) {
+    const entry = {"exchange":"worker-pool-updated","name":"workerPoolUpdated","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":false},{"multipleWords":false,"name":"provisionerId","required":false},{"multipleWords":false,"name":"workerType","required":false},{"multipleWords":false,"name":"workerGroup","required":false},{"multipleWords":false,"name":"workerId","required":false},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-pool-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a worker reports an error
+  // or provisioner encounters an error while
+  // provisioning a worker pool, a message is posted to this
+  // exchange.
+  /* eslint-enable max-len */
+  workerPoolError(pattern) {
+    const entry = {"exchange":"worker-pool-error","name":"workerPoolError","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":false},{"multipleWords":false,"name":"provisionerId","required":false},{"multipleWords":false,"name":"workerType","required":false},{"multipleWords":false,"name":"workerGroup","required":false},{"multipleWords":false,"name":"workerId","required":false},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-pool-error-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a worker is requested, a message is posted
+  // to this exchange.
+  /* eslint-enable max-len */
+  workerRequested(pattern) {
+    const entry = {"exchange":"worker-requested","name":"workerRequested","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":true},{"multipleWords":false,"name":"provisionerId","required":true},{"multipleWords":false,"name":"workerType","required":true},{"multipleWords":false,"name":"workerGroup","required":true},{"multipleWords":false,"name":"workerId","required":true},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a worker has registered, a message is posted
+  // to this exchange. This means that worker started
+  // successfully and is ready to claim work.
+  /* eslint-enable max-len */
+  workerRunning(pattern) {
+    const entry = {"exchange":"worker-running","name":"workerRunning","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":true},{"multipleWords":false,"name":"provisionerId","required":true},{"multipleWords":false,"name":"workerType","required":true},{"multipleWords":false,"name":"workerGroup","required":true},{"multipleWords":false,"name":"workerId","required":true},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a worker has stopped, a message is posted
+  // to this exchange. This means that instance was
+  // either terminated or stopped gracefully.
+  /* eslint-enable max-len */
+  workerStopped(pattern) {
+    const entry = {"exchange":"worker-stopped","name":"workerStopped","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":true},{"multipleWords":false,"name":"provisionerId","required":true},{"multipleWords":false,"name":"workerType","required":true},{"multipleWords":false,"name":"workerGroup","required":true},{"multipleWords":false,"name":"workerId","required":true},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a worker is removed, a message is posted to this exchange.
+  // This occurs when a worker is requested to be removed via an API call
+  // or when a worker is terminated by the worker manager.
+  // The reason for the removal is included in the message.
+  /* eslint-enable max-len */
+  workerRemoved(pattern) {
+    const entry = {"exchange":"worker-removed","name":"workerRemoved","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":true},{"multipleWords":false,"name":"provisionerId","required":true},{"multipleWords":false,"name":"workerType","required":true},{"multipleWords":false,"name":"workerGroup","required":true},{"multipleWords":false,"name":"workerId","required":true},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-worker-removed-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a new launch configuration is created for a worker pool,
+  // a message is posted to this exchange.
+  /* eslint-enable max-len */
+  launchConfigCreated(pattern) {
+    const entry = {"exchange":"launch-config-created","name":"launchConfigCreated","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":false},{"multipleWords":false,"name":"provisionerId","required":false},{"multipleWords":false,"name":"workerType","required":false},{"multipleWords":false,"name":"workerGroup","required":false},{"multipleWords":false,"name":"workerId","required":false},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-launch-config-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a launch configuration is updated for a worker pool,
+  // a message is posted to this exchange.
+  /* eslint-enable max-len */
+  launchConfigUpdated(pattern) {
+    const entry = {"exchange":"launch-config-updated","name":"launchConfigUpdated","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":false},{"multipleWords":false,"name":"provisionerId","required":false},{"multipleWords":false,"name":"workerType","required":false},{"multipleWords":false,"name":"workerGroup","required":false},{"multipleWords":false,"name":"workerId","required":false},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-launch-config-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+  /* eslint-disable max-len */
+  // Whenever a launch configuration is archived for a worker pool,
+  // a message is posted to this exchange.
+  /* eslint-enable max-len */
+  launchConfigArchived(pattern) {
+    const entry = {"exchange":"launch-config-archived","name":"launchConfigArchived","routingKey":[{"constant":"primary","multipleWords":false,"name":"routingKeyKind","required":true},{"multipleWords":false,"name":"providerId","required":false},{"multipleWords":false,"name":"provisionerId","required":false},{"multipleWords":false,"name":"workerType","required":false},{"multipleWords":false,"name":"workerGroup","required":false},{"multipleWords":false,"name":"workerId","required":false},{"multipleWords":false,"name":"launchConfigId","required":false},{"multipleWords":true,"name":"reserved","required":false}],"schema":"v1/pulse-launch-config-message.json#","type":"topic-exchange"}; // eslint-disable-line
+
+    return this.normalizePattern(entry, pattern);
+  }
+}

package/src/credentials.js

@@ -0,0 +1,210 @@
+import { algo, enc } from 'crypto-js';
+import { v4 } from './utils';
+import Auth from './clients/Auth';
+
+const createHmac = (...args) => algo.HMAC.create(...args);
+const sha256 = algo.SHA256;
+const base64 = enc.Base64;
+const THIRTY_ONE_DAYS = 31 * 24 * 60 * 60 * 1000;
+
+/**
+ * Construct a set of temporary credentials.
+ *
+ * options:
+ * {
+ *  start:        new Date(),   // Start time of credentials (defaults to now)
+ *  expiry:       new Date(),   // Credentials expiration time
+ *  scopes:       ['scope'...], // Scopes granted (defaults to empty-set)
+ *  clientId:     '...',  // *optional* ID to create named temporary credential
+ *  credentials: {        // (defaults to use global config, if available)
+ *    clientId:    '...', // ClientId
+ *    accessToken: '...', // AccessToken for clientId
+ *  },
+ * }
+ *
+ * Note that a named temporary credential is only valid if the issuing
+ * credentials have the scope 'auth:create-client:<name>'. This function does
+ * not check for this scope, but it will be checked when the credentials are
+ * used.
+ *
+ * The auth service already tolerates up to five minutes clock drift for start
+ * and expiry fields, therefore caller should *not* apply further clock skew
+ * adjustment.
+ *
+ * Returns an object on the form: {clientId, accessToken, certificate}
+ */
+export const createTemporaryCredentials = opts => {
+  if (!opts) {
+    throw new Error('Missing required options');
+  }
+
+  // auth service handles clock drift (PR #117) - should not skew times here
+  const now = new Date();
+  const options = { start: now, scopes: [], ...opts };
+  const isNamed = !!options.clientId;
+
+  if (!options.credentials) {
+    throw new Error('options.credentials is required');
+  }
+
+  if (!options.credentials.clientId) {
+    throw new Error('options.credentials.clientId is required');
+  }
+
+  if (isNamed && options.clientId === options.credentials.clientId) {
+    throw new Error('Credential issuer must be different from the name');
+  }
+
+  if (!options.credentials.accessToken) {
+    throw new Error('options.credentials.accessToken is required');
+  }
+
+  if (options.credentials.certificate != null) {
+    throw new Error(
+      `Temporary credentials cannot be used to make new temporary credentials.
+      Ensure that options.credentials.certificate is null.`,
+    );
+  }
+
+  if (!(options.start instanceof Date)) {
+    throw new Error('options.start must be a Date object');
+  }
+
+  if (!(options.expiry instanceof Date)) {
+    throw new Error('options.expiry must be a Date object');
+  }
+
+  if (+options.expiry - options.start > THIRTY_ONE_DAYS) {
+    throw new Error('Credentials cannot span more than 31 days');
+  }
+
+  if (!Array.isArray(options.scopes)) {
+    throw new Error('options.scopes must be an array');
+  }
+
+  options.scopes.forEach(scope => {
+    if (typeof scope !== 'string') {
+      throw new Error('options.scopes must be an array of strings');
+    }
+  });
+
+  const certificate = {
+    version: 1,
+    scopes: [...options.scopes],
+    start: options.start.getTime(),
+    expiry: options.expiry.getTime(),
+    seed: v4() + v4(),
+    signature: null,
+    issuer: isNamed ? options.credentials.clientId : null,
+  };
+  const signature = createHmac(sha256, options.credentials.accessToken);
+
+  signature.update(`version:${certificate.version}\n`);
+
+  if (isNamed) {
+    signature.update(`clientId:${options.clientId}\n`);
+    signature.update(`issuer:${options.credentials.clientId}\n`);
+  }
+
+  signature.update(`seed:${certificate.seed}\n`);
+  signature.update(`start:${certificate.start}\n`);
+  signature.update(`expiry:${certificate.expiry}\n`);
+  signature.update('scopes:\n');
+  signature.update(certificate.scopes.join('\n'));
+  certificate.signature = signature.finalize().toString(base64);
+
+  const accessToken = createHmac(sha256, options.credentials.accessToken)
+    .update(certificate.seed)
+    .finalize()
+    .toString(base64)
+    .replace(/\+/g, '-') // Replace + with - (see RFC 4648, sec. 5)
+    .replace(/\//g, '_') // Replace / with _ (see RFC 4648, sec. 5)
+    .replace(/=/g, ''); // Drop '==' padding
+
+  return {
+    accessToken,
+    clientId: isNamed ? options.clientId : options.credentials.clientId,
+    certificate: JSON.stringify(certificate),
+  };
+};
+
+/**
+ * Get information about a set of credentials.
+ *
+ * credentials: {
+ *   clientId,
+ *   accessToken,
+ *   certificate,           // optional
+ * }
+ *
+ * result: Promise for
+ * {
+ *    clientId: ..,         // name of the credential
+ *    type: ..,             // type of credential, e.g., "temporary"
+ *    active: ..,           // active (valid, not disabled, etc.)
+ *    start: ..,            // validity start time (if applicable)
+ *    expiry: ..,           // validity end time (if applicable)
+ *    scopes: [...],        // associated scopes (if available)
+ * }
+ */
+export const credentialInformation = async (credentials, rootUrl) => {
+  let issuer = credentials.clientId;
+  const result = {
+    clientId: issuer,
+    active: true,
+  };
+
+  // Distinguish permanent credentials from temporary credentials
+  if (credentials.certificate) {
+    let { certificate } = credentials;
+
+    if (typeof certificate === 'string') {
+      try {
+        certificate = JSON.parse(certificate);
+      } catch (err) {
+        return Promise.reject(err);
+      }
+    }
+
+    result.type = 'temporary';
+    result.scopes = certificate.scopes;
+    result.start = new Date(certificate.start);
+    result.expiry = new Date(certificate.expiry);
+
+    if (certificate.issuer) {
+      // eslint-disable-next-line prefer-destructuring
+      issuer = certificate.issuer;
+    }
+  } else {
+    result.type = 'permanent';
+  }
+
+  const anonymousClient = new Auth({ rootUrl });
+  const credentialsClient = new Auth({ credentials, rootUrl });
+  const clientLookup = anonymousClient.client(issuer).then(client => {
+    const expires = new Date(client.expires);
+
+    if (!result.expiry || result.expiry > expires) {
+      result.expiry = expires;
+    }
+
+    if (client.disabled) {
+      result.active = false;
+    }
+  });
+  const scopeLookup = credentialsClient.currentScopes().then(response => {
+    result.scopes = response.scopes;
+  });
+
+  await Promise.all([clientLookup, scopeLookup]);
+
+  const now = new Date();
+
+  if (result.start && result.start > now) {
+    result.active = false;
+  } else if (result.expiry && result.expiry < now) {
+    result.active = false;
+  }
+
+  return result;
+};

package/src/emitter.js

@@ -0,0 +1,58 @@
+/**
+ * The MIT License (MIT)
+ Copyright 2016 Andrey Sitnik <andrey@sitnik.ru>
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
+ this software and associated documentation files (the "Software"), to deal in
+ the Software without restriction, including without limitation the rights to
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+ of the Software, and to permit persons to whom the Software is furnished to do
+ so, subject to the following conditions:
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ SOFTWARE.
+ */
+
+export default class Emitter {
+  constructor() {
+    this.events = {};
+  }
+
+  on(eventName, handler) {
+    if (
+      process.env.NODE_ENV !== 'production' &&
+      typeof handler !== 'function'
+    ) {
+      throw new Error('Listener must be a function');
+    }
+
+    const event = this.events[eventName] || [];
+
+    event.push(handler);
+    this.events[eventName] = event;
+
+    return () => this.off(eventName, handler);
+  }
+
+  off(eventName, handler) {
+    const event = this.events[eventName] || [];
+
+    // eslint-disable-next-line no-bitwise
+    event.splice(event.indexOf(handler) >>> 0, 1);
+  }
+
+  emit(eventName, ...args) {
+    const handlers = this.events[eventName];
+
+    if (!handlers || !handlers[0]) {
+      return;
+    }
+
+    handlers.forEach(handler => handler(...args));
+  }
+}

package/src/fetch.js

@@ -0,0 +1,93 @@
+import hawk from 'hawk';
+
+/* eslint-disable-next-line max-len */
+const JSON_CONTENT = /^(application\/(json|x-javascript)|text\/(x-)?javascript|x-json)(;.*)?$/;
+const defaults = {
+  credentials: 'omit',
+  retries: 5,
+  delayFactor: 100,
+  randomizationFactor: 0.25,
+  maxDelay: 30 * 1000,
+  timeout: 30 * 1000,
+  headers: {
+    'Content-Type': 'application/json',
+  },
+};
+const handleResponse = response =>
+  Promise.resolve(response)
+    .then(
+      () =>
+        JSON_CONTENT.test(response.headers.get('Content-Type'))
+          ? response.json()
+          : null,
+    )
+    .then(json => {
+      if (response.ok) {
+        return json;
+      }
+
+      const message = json.message
+        ? json.message.split('---')[0]
+        : response.statusText;
+
+      return Promise.reject(
+        Object.assign(new Error(message), {
+          response,
+          body: json,
+        }),
+      );
+    });
+
+export default (url, opts = {}) => {
+  const options = {
+    ...defaults,
+    ...opts,
+    headers: { ...(opts.body && defaults.headers), ...opts.headers },
+  };
+  const { delayFactor, randomizationFactor, maxDelay, retries } = options;
+
+  if (typeof options.credentials !== 'string') {
+    const { header } = hawk.client.header(url, options.method.toUpperCase(), {
+      credentials: {
+        id: options.credentials.clientId,
+        key: options.credentials.accessToken,
+        algorithm: 'sha256',
+      },
+      ext: options.extra,
+    });
+
+    options.credentials = 'omit';
+    options.headers.Authorization = header;
+  }
+
+  // do not follow redirects
+  // https://developer.mozilla.org/en-US/docs/Web/API/Response/redirected#Disallowing_redirects
+  options.redirect = "error";
+
+  return new Promise((resolve, reject) => {
+    (function attempt(n) {
+      fetch(url, options)
+        .then(handleResponse)
+        .then(resolve)
+        .catch(err => {
+          if (err.response && err.response.status < 500) {
+            // only retry on errors or 500-series responses
+            reject(err);
+          } else if (n > retries) {
+            reject(err);
+          } else {
+            const delay = Math.min(
+              (n - 1) ** 2 *
+                delayFactor *
+                (Math.random() * 2 * randomizationFactor +
+                  1 -
+                  randomizationFactor),
+              maxDelay,
+            );
+
+            setTimeout(() => attempt(n + 1), delay);
+          }
+        });
+    })(1);
+  });
+};

package/src/index.js

@@ -0,0 +1,26 @@
+export { default as Client } from './Client';
+export {
+  createTemporaryCredentials,
+  credentialInformation,
+} from './credentials';
+export { fromNow, fromNowJSON, slugid, nice, v4, parseTime } from './utils';
+export { default as request } from './fetch';
+
+// AUTOGENERATED-START
+export { default as Auth } from './clients/Auth';
+export { default as AuthEvents } from './clients/AuthEvents';
+export { default as Github } from './clients/Github';
+export { default as GithubEvents } from './clients/GithubEvents';
+export { default as Hooks } from './clients/Hooks';
+export { default as HooksEvents } from './clients/HooksEvents';
+export { default as Index } from './clients/Index';
+export { default as Notify } from './clients/Notify';
+export { default as NotifyEvents } from './clients/NotifyEvents';
+export { default as Object } from './clients/Object';
+export { default as PurgeCache } from './clients/PurgeCache';
+export { default as Queue } from './clients/Queue';
+export { default as QueueEvents } from './clients/QueueEvents';
+export { default as Secrets } from './clients/Secrets';
+export { default as WorkerManager } from './clients/WorkerManager';
+export { default as WorkerManagerEvents } from './clients/WorkerManagerEvents';
+// AUTOGENERATED-END

package/src/utils.js

@@ -0,0 +1,123 @@
+// Regular expression matching:
+// A years B months C days D hours E minutes F seconds
+const timeExpression = new RegExp(
+  [
+    '^(\\s*(-|\\+))?',
+    '(\\s*(\\d+)\\s*y((ears?)|r)?)?',
+    '(\\s*(\\d+)\\s*mo(nths?)?)?',
+    '(\\s*(\\d+)\\s*w((eeks?)|k)?)?',
+    '(\\s*(\\d+)\\s*d(ays?)?)?',
+    '(\\s*(\\d+)\\s*h((ours?)|r)?)?',
+    '(\\s*(\\d+)\\s*m(in(utes?)?)?)?',
+    '(\\s*(\\d+)\\s*s(ec(onds?)?)?)?',
+    '\\s*$',
+  ].join(''),
+  'i',
+);
+
+export const parseTime = (str = '') => {
+  // Parse the string
+  const match = timeExpression.exec(str);
+
+  if (!match) {
+    throw new Error(`"${str}" is not a valid time expression`);
+  }
+
+  // Negate if needed
+  const neg = match[2] === '-' ? -1 : 1;
+
+  // Return parsed values
+  return {
+    years: parseInt(match[4] || 0, 10) * neg,
+    months: parseInt(match[8] || 0, 10) * neg,
+    weeks: parseInt(match[11] || 0, 10) * neg,
+    days: parseInt(match[15] || 0, 10) * neg,
+    hours: parseInt(match[18] || 0, 10) * neg,
+    minutes: parseInt(match[22] || 0, 10) * neg,
+    seconds: parseInt(match[25] || 0, 10) * neg,
+  };
+};
+
+/**
+ * Create a Date object offset = '1d 2h 3min' into the future
+ *
+ * Offset format: The argument `offset` (if given) is a string on the form
+ *   `1 day 2 hours 3 minutes`
+ * where specification of day, hours and minutes is optional. You can also the
+ * short hand `1d2h3min`, it's fairly tolerant of different spelling forms and
+ * whitespace. But only really meant to be used with constants.
+ */
+export const fromNow = (offset, reference = new Date()) => {
+  const parsedOffset = parseTime(offset || '');
+
+  parsedOffset.days += 30 * parsedOffset.months;
+  parsedOffset.days += 365 * parsedOffset.years;
+
+  return new Date(
+    reference.getTime() +
+      parsedOffset.weeks * 7 * 24 * 60 * 60 * 1000 +
+      parsedOffset.days * 24 * 60 * 60 * 1000 +
+      parsedOffset.hours * 60 * 60 * 1000 +
+      parsedOffset.minutes * 60 * 1000 +
+      parsedOffset.seconds * 1000,
+  );
+};
+
+/**
+ * Create an ISO 8601 time stamp offset = '1d 2h 3min' into the future
+ *
+ * This returns a time stamp in the format expected by taskcluster.
+ * Compatible with Date.toJSON() from Javascript. These time stamps are string
+ * that with UTC as timezone.
+ *
+ * Offset format: The argument `offset` (if given) is a string on the form
+ *   `1 day 2 hours 3 minutes`
+ * where specification of day, hours and minutes is optional. You can also the
+ * short hand `1d2h3min`, it's fairly tolerant of different spelling forms and
+ * whitespace. But only really meant to be used with constants.
+ */
+export const fromNowJSON = (offset, reference) =>
+  fromNow(offset, reference).toJSON();
+
+/* eslint-disable no-bitwise, no-mixed-operators */
+export const uuid = () => {
+  const randoms = crypto.getRandomValues(new Uint8Array(16));
+
+  randoms[6] = (randoms[6] & 0x0f) | 0x40;
+  randoms[8] = (randoms[8] & 0x3f) | 0x80;
+
+  return randoms;
+};
+
+const slug = (nice = false) => {
+  const bytes = uuid();
+
+  if (nice) {
+    bytes[0] &= 0x7f; // unset first bit to ensure [A-Za-f] first char
+  }
+
+  return btoa(String.fromCharCode.apply(null, bytes))
+    .replace(/\+/g, '-') // Replace + with - (see RFC 4648, sec. 5)
+    .replace(/\//g, '_') // Replace / with _ (see RFC 4648, sec. 5)
+    .substring(0, 22); // Drop '==' padding
+};
+/* eslint-enable no-bitwise, no-mixed-operators */
+
+/**
+ * Returns a randomly generated uuid v4 compliant slug
+ */
+export const v4 = slug;
+
+/**
+ * Returns a randomly generated uuid v4 compliant slug which conforms to a set
+ * of "nice" properties, at the cost of some entropy. Currently this means one
+ * extra fixed bit (the first bit of the uuid is set to 0) which guarantees the
+ * slug will begin with [A-Za-f]. For example such slugs don't require special
+ * handling when used as command line parameters (whereas non-nice slugs may
+ * start with `-` which can confuse command line tools).
+ *
+ * Potentially other "nice" properties may be added in future to further
+ * restrict the range of potential uuids that may be generated.
+ */
+export const nice = () => slug(true);
+export const slugid = nice;