@magda/minion-sdk 2.3.2 → 3.0.0-alpha.0

package/dist/index.d.ts

@@ -1,24 +1,25 @@
 /// <reference types="node" />
+
 import express from 'express';
-import http = require('http');
+import http from 'node:http';
 import { default as URI_2 } from 'urijs';
 import yargs from 'yargs';
 
 /**
-* A type of aspect in the registry, unique for a tenant.
-*/
+ * A type of aspect in the registry, unique for a tenant.
+ */
 export declare class AspectDefinition {
     /**
-    * The identifier for the aspect type.
-    */
+     * The identifier for the aspect type.
+     */
     'id': string;
     /**
-    * The name of the aspect.
-    */
+     * The name of the aspect.
+     */
     'name': string;
     /**
-    * The JSON Schema of this aspect.
-    */
+     * The JSON Schema of this aspect.
+     */
     'jsonSchema': any;
 }
 
@@ -122,13 +123,13 @@ export declare interface AuthorizedRegistryOptions extends RegistryOptions {
 }
 
 /**
-                                                 * Builds an argv object that will accept command line arguments used by all common argv minions.
-                                                 *
-                                                 * @param id
-                                                 * @param defaultPort
-                                                 * @param defaultInternalUrl
-                                                 * @param additions
-                                                 */
+ * Builds an argv object that will accept command line arguments used by all common argv minions.
+ *
+ * @param id
+ * @param defaultPort
+ * @param defaultInternalUrl
+ * @param additions
+ */
 export declare function commonYargs<T extends MinionArguments = MinionArguments>(defaultPort: number, defaultInternalUrl: string, additions?: (a: yargs.Argv<MinionArguments>) => yargs.Argv<T>): T;
 
 declare class CountResponse {
@@ -150,26 +151,26 @@ declare interface Eq<T> {
 }
 
 /**
-* A page of events.
-*/
+ * A page of events.
+ */
 declare class EventsPage {
     /**
-    * Whether there are more events available.
-    */
+     * Whether there are more events available.
+     */
     'hasMore': boolean;
     /**
-    * A token to be used to get the next page of events.
-    */
+     * A token to be used to get the next page of events.
+     */
     'nextPageToken': string;
     /**
-    * The events in this page.
-    */
+     * The events in this page.
+     */
     'events': Array<RegistryEvent>;
 }
 
 /**
-* The type of a registry modification event.
-*/
+ * The type of a registry modification event.
+ */
 declare type EventType = 'CreateRecord' | 'CreateAspectDefinition' | 'CreateRecordAspect' | 'PatchRecord' | 'PatchAspectDefinition' | 'PatchRecordAspect' | 'DeleteRecord' | 'DeleteAspectDefinition' | 'DeleteRecordAspect';
 
 declare interface Functor<T> {
@@ -193,7 +194,7 @@ declare class JsValue {
 
 declare class Maybe<T> implements Monad<T>, Functor<T>, Eq<Maybe<T>> {
     private type;
-    private value;
+    private value?;
     constructor(type: MaybeType, value?: T);
     static sequence<T>(t: {
         [k: string]: Maybe<T>;
@@ -205,9 +206,11 @@ declare class Maybe<T> implements Monad<T>, Functor<T>, Eq<Maybe<T>> {
     }) => Maybe<{
         [k: string]: any;
     }>;
-    static maybe<T>(t: T): Maybe<T>;
+    static maybe<T>(t?: T | null): Maybe<T>;
     static just<T>(t: T): Maybe<T>;
     static nothing<T>(): Maybe<T>;
+    static isJust<T>(t: Maybe<T>): boolean;
+    static isNothing<T>(t: Maybe<T>): boolean;
     unit<U>(u: U): Maybe<U>;
     bind<U>(f: (t: T) => Maybe<U>): Maybe<U>;
     of: <U>(u: U) => Maybe<U>;
@@ -221,7 +224,7 @@ declare class Maybe<T> implements Monad<T>, Functor<T>, Eq<Maybe<T>> {
     valueOr<U extends T>(defaultValue: U): T | U;
     valueOrCompute<U extends T>(defaultValueFunction: () => U): T | U;
     valueOrThrow(error?: Error): T;
-    do(patterns?: OptionalMaybePatterns<T, void>): Maybe<T>;
+    do(patterns?: Partial<MaybePatterns<T, void>>): Maybe<T>;
 }
 
 declare interface MaybePatterns<T, U> {
@@ -231,39 +234,41 @@ declare interface MaybePatterns<T, U> {
 
 declare enum MaybeType {
     Nothing = 0,
-    Just = 1,
+    Just = 1
 }
 
 declare function minion(options: MinionOptions): Promise<void>;
 export default minion;
 
 export declare type MinionArguments = {
-  listenPort: string | number;
-  internalUrl: string;
-  jwtSecret: string;
-  userId: string;
-  registryUrl: string;
-  enableMultiTenant: boolean;
-  tenantUrl: string;
-  retries: string | number;
-  crawlerRecordFetchNumber?: string | number;};
+    listenPort: string | number;
+    internalUrl: string;
+    jwtSecret: string;
+    userId: string;
+    registryUrl: string;
+    enableMultiTenant: boolean;
+    tenantUrl: string;
+    retries: string | number;
+    crawlerRecordFetchNumber?: string | number;
+};
 
 export declare interface MinionOptions {
-  argv: MinionArguments;
-  id: string;
-  aspects: string[];
-  optionalAspects: string[];
-  writeAspectDefs: AspectDefinition[];
-  async?: boolean;
-  onRecordFound: onRecordFoundType;
-  express?: () => express.Express;
-  maxRetries?: number;
-  concurrency?: number;
-  crawlerRecordFetchNumber?: number;
-  includeEvents?: boolean;
-  includeRecords?: boolean;
-  includeAspectDefinitions?: boolean;
-  dereference?: boolean;}
+    argv: MinionArguments;
+    id: string;
+    aspects: string[];
+    optionalAspects: string[];
+    writeAspectDefs: AspectDefinition[];
+    async?: boolean;
+    onRecordFound: onRecordFoundType;
+    express?: () => express.Express;
+    maxRetries?: number;
+    concurrency?: number;
+    crawlerRecordFetchNumber?: number;
+    includeEvents?: boolean;
+    includeRecords?: boolean;
+    includeAspectDefinitions?: boolean;
+    dereference?: boolean;
+}
 
 declare interface Monad<T> {
     unit<U>(t: U): Monad<U>;
@@ -281,11 +286,6 @@ export declare type onRecordFoundType = (record: Record_2, registry: AuthorizedR
 declare class Operation {
 }
 
-declare interface OptionalMaybePatterns<T, U> {
-    just?: (t: T) => U;
-    nothing?: () => U;
-}
-
 declare class PatchRecordsRequest {
     'recordIds': Array<string>;
     'jsonPath': JsonPatch;
@@ -297,28 +297,28 @@ declare class PutRecordsAspectRequest {
 }
 
 /**
-* A record in the registry, usually including data for one or more aspects, unique for a tenant.
-*/
+ * A record in the registry, usually including data for one or more aspects, unique for a tenant.
+ */
 declare class Record_2 {
     /**
-    * The identifier of the record
-    */
+     * The identifier of the record
+     */
     'id': string;
     /**
-    * The name of the record
-    */
+     * The name of the record
+     */
     'name': string;
     /**
-    * The aspects included in this record
-    */
+     * The aspects included in this record
+     */
     'aspects': any;
     /**
-    * A tag representing the action by the source of this record (e.g. an id for a individual crawl of a data portal).
-    */
+     * A tag representing the action by the source of this record (e.g. an id for a individual crawl of a data portal).
+     */
     'sourceTag': string;
     /**
-    * The identifier of a tenant
-    */
+     * The identifier of a tenant
+     */
     'tenantId': number;
 }
 export { Record_2 as Record }
@@ -671,24 +671,24 @@ declare interface RecordsPage<I extends Record_2> {
 }
 
 /**
-* A summary of a record in the registry.  Summaries specify which aspects are available, but do not include data for any aspects.
-*/
+ * A summary of a record in the registry.  Summaries specify which aspects are available, but do not include data for any aspects.
+ */
 declare class RecordSummary {
     /**
-    * The identifier of the record
-    */
+     * The identifier of the record
+     */
     'id': string;
     /**
-    * The name of the record
-    */
+     * The name of the record
+     */
     'name': string;
     /**
-    * The list of aspect IDs for which this record has data
-    */
+     * The list of aspect IDs for which this record has data
+     */
     'aspects': Array<string>;
     /**
-    * The identifier of the tenant
-    */
+     * The identifier of the tenant
+     */
     'tenantId': number;
 }
 
@@ -762,30 +762,30 @@ declare class WebHook {
 }
 
 /**
-* Asynchronously acknowledges receipt of a web hook notification.
-*/
+ * Asynchronously acknowledges receipt of a web hook notification.
+ */
 declare class WebHookAcknowledgement {
     /**
-    * True if the web hook was received successfully and the listener is ready for further notifications.  False if the web hook was not received and the same notification should be repeated.
-    */
+     * True if the web hook was received successfully and the listener is ready for further notifications.  False if the web hook was not received and the same notification should be repeated.
+     */
     'succeeded': boolean;
     /**
-    * The ID of the last event received by the listener.  This should be the value of the `lastEventId` property of the web hook payload that is being acknowledged.  This value is ignored if `succeeded` is false.
-    */
+     * The ID of the last event received by the listener.  This should be the value of the `lastEventId` property of the web hook payload that is being acknowledged.  This value is ignored if `succeeded` is false.
+     */
     'lastEventIdReceived': any;
     /**
-    * Should the webhook be active or inactive?
-    */
+     * Should the webhook be active or inactive?
+     */
     'active': any;
 }
 
 /**
-* The response to an asynchronous web hook acknowledgement.
-*/
+ * The response to an asynchronous web hook acknowledgement.
+ */
 declare class WebHookAcknowledgementResponse {
     /**
-    * The ID of the last event successfully received by the listener.  Further notifications will start after this event.
-    */
+     * The ID of the last event successfully received by the listener.  Further notifications will start after this event.
+     */
     'lastEventIdReceived': number;
 }