@teammaestro/node-document-service v2.7.5

node-document-service

A TypeScript NodeJS client that interfaces with the Maestro Document Service

Getting Started

Run this to install the latest stable version.

npm i @teammaestro/node-document-service

Import @teammaestro/node-document-service and the client will be exported into your script from the latest build.

import { DocumentService } from 'node-document-service';

Documentation

Overview

new DocumentService(apiKey: string, options?: { host?: string, logging?: boolean | Function })

Parameters:

• apiKey (string) - This is the API Key from your document managment service account
• options.host (string | optional | default: https://dms.meetmaestro.com) - The domain that DMS is located at
• options.logging (boolean or Function | optional ) - Use this to turn on logging or pass in your custom logger.

Request Example:

new DocumentService(apiKey: '123', {
    host: 'https://dev-dms.meetmaestro.com',
    logging: console.log
})

.catch()

Whenever the API makes a call and runs into a catch block, you will get an error block that looks consistently like this:

Response Example:

{
    error: Error
    status: 500,
    message: 'Internal Server Error',
    duration: 300
}

getPreSignedData({ filename: string, acl: string, expiration: number }) GET /api/v1/pre-sign

This endpoint is used for creating policies in order to upload content to your S3 bucket Note: You must send the payload to S3 in the order that we send them back.

You can append anything you want to the key property (including the file extension).

You can also update the Content-Type to the real mime-type.

Parameters

Request Example:

dms.getPreSignedConfig({
    acl: 'public',
    filename: 'test.pdf',
    expiration: 120
})

Response Example:

{
    "url": "https://new-media-test-bucket.s3.amazonaws.com",
    "key": "a8231d87-c327-4cfc-a225-d1567de732ce",
    "Content-Type": "binary/octet-stream",
    "AWSAccessKeyId": "AKIAIF4CQIVFLH2VGVNA",
    "acl": "public-read",
    "policy": "eyJleHBpcmF0aW9uIjoiMjAxNy0wMi0xM1QwN...",
    "signature": "mmgVVFG6swkWvm3AmWZ9FB71R8s=",
    "expiration": "2017-04-06T14:49:16.267Z"
}

getSignedUrl(url: string, expiration: number) GET /api/v1/sign

This endpoint is used for signing your S3 private content

Parameters

Request Example:

dms.getSignedUrl('https://new-media-test-bucket.s3.amazonaws.com/test.pdf', 2000)

Response Example:

{
  "url": "https://bucket.s3.amazonaws.com/73aff5ee-a986-4af...",
  "expiration": "2017-04-06T14:49:16.267Z"
}

register(options: DocumentServiceOptions.RegistrationData) POST /api/v1/content

This endpoint is used to register your content with the document service.

Parameters

Request Example:

dms.register({
    title: 'Training Intro',
    path: 'https://new-media-test-bucket.s3.amazonaws.com/test.pdf',
    fileFormat: 'PDF',
    shouldGenerateThumbnail: true
})

Response Example:

{
  "identity": "ad9991a8-ab82-4521-befe-a8f2f956ce12"
}

view(options: DocumentServiceOptions.ViewOptions) GET /api/v1/content/:identity/view

This endpoint is used for generating the information you need to view the content

The payload will be a little dynamic based on the content type

Parameters

Request Example:

dms.view({
    identity: 'ad9991a8-ab82-4521-befe-a8f2f956ce12'
})

Response Example:

{
  "url": "https://bucket.s3.amazonaws.com/73aff5ee-a986-4af...",
  "expiration": "2017-04-06T14:49:16.267Z",
  "downloadUrl": "https://bucket.s3.amazonaws.com/73aff5ee-a986-4af...",
  "fileFormat": "docx",
  "convertedContent": {
    "url": "https://bucket.s3.amazonaws.com/73aff5ee-a986-4af...",
    "expiration": "2017-04-06T14:49:16.267Z",
    "downloadUrl": "https://bucket.s3.amazonaws.com/73aff5ee-a986-4af...",
    "fileFormat": "pdf",
  }
}

Contributors