NotaryTool

 !npm bundle size 

NotaryTool is a TypeScript implimentation of Apple's notarization process.
The tool can be used on any platform and on macOS will attempt to staple on completion.

NotaryTool is supported by ON LX Limited. Check out our projects such as Ctrl Suite and bonjour-service.

Installation

Add to your project dependencies using Yarn or NPM.

#### Install with Yarn
``
yarn add notarytool
`
#### Install with NPM
`
npm install notarytool
`




Usage

`js
import NotaryTool from 'notarytool'

/**
* Setup the tool using API credentials
*/
const tool = new NotaryTool({
appleApiKey : process.env.APPLE_API_KEY,
appleApiKeyId : process.env.APPLE_API_KEY_ID,
appleApiIssuerId : process.env.APPLE_API_ISSUER_ID
})

/**
* Monitor the current status of the tool
*/
tool.on('progress', val => console.log('progress:', val))
tool.on('status', (status, message) => console.log('status:', status, message))

/**
* Call notarize with the file path
*/
try {
await tool.notarize(process.env.FILE_PATH)
console.log('Success')
} catch(error) {
console.log('Failed', error)
}
`

API

$3

`js
const tool = new NotaryTool(options: NotaryToolConfig)
`

Creates an new tool instance that can handle notarizing multiple times

Options are:

- @string appleApiKey The file path to the AuthKey_{id}.p8 file from the App Store
- @string appleApiKeyId The {id} of the AuthKey file
- @string appleApiIssuerId The issuer ID provided by the App Store
- @boolean? ignoreStaple If enabled on macOS, staple stage will be skipped

$3

#### await tool.notarize(filePath: string)

Begins the file notarization process. Function returns a void on success and throws errors

$3

#### tool.on('progress', (val: number) => console.log(val))

Provides progress of process from 0.0 to 1.0. Value will hang around 0.75 whilst response from App Store is provided.

#### tool.on('status', (status: NotaryToolStatus, message: string | undefined) => console.log(status, message))

Provides a status value and optional readable message where applicable.




$3

#### NotaryToolStatus

`js
enum NotaryToolStatus {
BeginUpload = 'begin_upload',
Uploaded = 'uploaded',
Invalid = 'invalid',
InProgress = 'in_progress',
Complete = 'complete'
}
``