@dockflow/sdk 0.0.0-stage → 0.2.0

package/src/apis/V3DownstreamApi.ts

@@ -0,0 +1,174 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Dockflow v3 API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type DownstreamTradeflow,
+    DownstreamTradeflowFromJSON,
+    DownstreamTradeflowToJSON,
+} from '../models/DownstreamTradeflow';
+import {
+    type V3DownstreamPost202Response,
+    V3DownstreamPost202ResponseFromJSON,
+    V3DownstreamPost202ResponseToJSON,
+} from '../models/V3DownstreamPost202Response';
+
+export interface V3DownstreamDeleteRequest {
+    /**
+     * 
+     */
+    tradeflowReference: string;
+    /**
+     * 
+     */
+    confirm?: string;
+    /**
+     * true deletes the tradeflow permanently. Default: it is deactivated.
+     */
+    hard?: boolean;
+}
+
+export interface V3DownstreamPostRequest {
+    /**
+     * 
+     */
+    downstreamTradeflow: Array<DownstreamTradeflow>;
+}
+
+/**
+ * 
+ */
+export class V3DownstreamApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for v3DownstreamDelete without sending the request
+     */
+    async v3DownstreamDeleteRequestOpts(requestParameters: V3DownstreamDeleteRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['tradeflowReference'] == null) {
+            throw new runtime.RequiredError(
+                'tradeflowReference',
+                'Required parameter "tradeflowReference" was null or undefined when calling v3DownstreamDelete().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['confirm'] != null) {
+            queryParameters['confirm'] = requestParameters['confirm'];
+        }
+
+        if (requestParameters['hard'] != null) {
+            queryParameters['hard'] = requestParameters['hard'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v3/downstream/tradeflows/{tradeflow_reference}`;
+        urlPath = urlPath.replace('{tradeflow_reference}', encodeURIComponent(String(requestParameters['tradeflowReference'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Delete a tradeflow
+     */
+    async v3DownstreamDeleteRaw(requestParameters: V3DownstreamDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<string>> {
+        const requestOptions = await this.v3DownstreamDeleteRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        if (this.isJsonMime(response.headers.get('content-type'))) {
+            return new runtime.JSONApiResponse<string>(response);
+        } else {
+            return new runtime.TextApiResponse(response) as any;
+        }
+    }
+
+    /**
+     * Delete a tradeflow
+     */
+    async v3DownstreamDelete(requestParameters: V3DownstreamDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<string> {
+        const response = await this.v3DownstreamDeleteRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for v3DownstreamPost without sending the request
+     */
+    async v3DownstreamPostRequestOpts(requestParameters: V3DownstreamPostRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['downstreamTradeflow'] == null) {
+            throw new runtime.RequiredError(
+                'downstreamTradeflow',
+                'Required parameter "downstreamTradeflow" was null or undefined when calling v3DownstreamPost().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v3/downstream/tradeflows`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: requestParameters['downstreamTradeflow']!.map(DownstreamTradeflowToJSON),
+        };
+    }
+
+    /**
+     * Upsert tradeflows
+     */
+    async v3DownstreamPostRaw(requestParameters: V3DownstreamPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<V3DownstreamPost202Response>> {
+        const requestOptions = await this.v3DownstreamPostRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => V3DownstreamPost202ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Upsert tradeflows
+     */
+    async v3DownstreamPost(requestParameters: V3DownstreamPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<V3DownstreamPost202Response> {
+        const response = await this.v3DownstreamPostRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/V3UpstreamApi.ts

@@ -0,0 +1,185 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Dockflow v3 API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type V3UpstreamGet200Response,
+    V3UpstreamGet200ResponseFromJSON,
+    V3UpstreamGet200ResponseToJSON,
+} from '../models/V3UpstreamGet200Response';
+import {
+    type V3UpstreamGet400Response,
+    V3UpstreamGet400ResponseFromJSON,
+    V3UpstreamGet400ResponseToJSON,
+} from '../models/V3UpstreamGet400Response';
+
+export interface V3UpstreamGetRequest {
+    /**
+     * Only tradeflows changed after this ISO 8601 timestamp (exclusive), with an offset. Without since, cursor, tradeflow or container: the last 15 minutes.
+     */
+    since?: string;
+    /**
+     * Your tradeflow reference. Returns that tradeflow regardless of when it changed.
+     */
+    tradeflow?: string;
+    /**
+     * A container number. Returns its tradeflows regardless of when they changed.
+     */
+    container?: string;
+    /**
+     * Keep only events of this category: MILESTONE, SHIPMENT or LOCATION.
+     */
+    category?: string;
+    /**
+     * Keep only events whose code starts with this value. One of: GE, GN, AE, VD, VA, UV, GT, GD, GR, POS, A-BKD, A-RCS, A-DEP, A-ARR, A-RCF, A-NFD, A-DLV. Any other value returns 400.
+     */
+    code?: string;
+    /**
+     * next_cursor from the previous page. Keep since identical across the pages of one cycle.
+     */
+    cursor?: string;
+    /**
+     * true (active only), false, or both. Default: active plus recently deactivated.
+     */
+    active?: string;
+    /**
+     * Comma-separated blocks: events, locations, containers, shipment, vessels. Default: all but vessels.
+     */
+    fields?: string;
+    /**
+     * Shape of `events`: `v3` (Dockflow milestones) or `dcsa-tnt-2.2` (DCSA Track & Trace 2.2). The rest of the record is identical.
+     */
+    format?: V3UpstreamGetFormatEnum;
+    /**
+     * Tradeflows per page, 1 to 1000. Default 50.
+     */
+    perPage?: number;
+    /**
+     * Set to 1 and Dockflow keeps your position per API key and filter set, so repeated identical polls skip nothing.
+     */
+    failsafe?: V3UpstreamGetFailsafeEnum;
+}
+
+/**
+ * 
+ */
+export class V3UpstreamApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for v3UpstreamGet without sending the request
+     */
+    async v3UpstreamGetRequestOpts(requestParameters: V3UpstreamGetRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = requestParameters['since'];
+        }
+
+        if (requestParameters['tradeflow'] != null) {
+            queryParameters['tradeflow'] = requestParameters['tradeflow'];
+        }
+
+        if (requestParameters['container'] != null) {
+            queryParameters['container'] = requestParameters['container'];
+        }
+
+        if (requestParameters['category'] != null) {
+            queryParameters['category'] = requestParameters['category'];
+        }
+
+        if (requestParameters['code'] != null) {
+            queryParameters['code'] = requestParameters['code'];
+        }
+
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
+        if (requestParameters['active'] != null) {
+            queryParameters['active'] = requestParameters['active'];
+        }
+
+        if (requestParameters['fields'] != null) {
+            queryParameters['fields'] = requestParameters['fields'];
+        }
+
+        if (requestParameters['format'] != null) {
+            queryParameters['format'] = requestParameters['format'];
+        }
+
+        if (requestParameters['perPage'] != null) {
+            queryParameters['per_page'] = requestParameters['perPage'];
+        }
+
+        if (requestParameters['failsafe'] != null) {
+            queryParameters['failsafe'] = requestParameters['failsafe'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v3/upstream`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Poll upstream events
+     */
+    async v3UpstreamGetRaw(requestParameters: V3UpstreamGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<V3UpstreamGet200Response>> {
+        const requestOptions = await this.v3UpstreamGetRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => V3UpstreamGet200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Poll upstream events
+     */
+    async v3UpstreamGet(requestParameters: V3UpstreamGetRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<V3UpstreamGet200Response> {
+        const response = await this.v3UpstreamGetRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const V3UpstreamGetFormatEnum = {
+    V3: 'v3',
+    DcsaTnt22: 'dcsa-tnt-2.2',
+} as const;
+export type V3UpstreamGetFormatEnum = typeof V3UpstreamGetFormatEnum[keyof typeof V3UpstreamGetFormatEnum];
+/**
+ * @export
+ */
+export const V3UpstreamGetFailsafeEnum = {
+    _0: '0',
+    _1: '1',
+} as const;
+export type V3UpstreamGetFailsafeEnum = typeof V3UpstreamGetFailsafeEnum[keyof typeof V3UpstreamGetFailsafeEnum];

package/src/apis/WidgetApi.ts

@@ -0,0 +1,97 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Dockflow v3 API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type InlineObject,
+    InlineObjectFromJSON,
+    InlineObjectToJSON,
+} from '../models/InlineObject';
+import {
+    type WidgetSearchResult,
+    WidgetSearchResultFromJSON,
+    WidgetSearchResultToJSON,
+} from '../models/WidgetSearchResult';
+
+export interface SearchWidgetRequest {
+    /**
+     * Container number, booking or bill of lading reference.
+     */
+    q: string;
+}
+
+/**
+ * 
+ */
+export class WidgetApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for searchWidget without sending the request
+     */
+    async searchWidgetRequestOpts(requestParameters: SearchWidgetRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['q'] == null) {
+            throw new runtime.RequiredError(
+                'q',
+                'Required parameter "q" was null or undefined when calling searchWidget().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['q'] != null) {
+            queryParameters['q'] = requestParameters['q'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v3/widget/search`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Matches a container number, booking or bill of lading within the token\'s entity and returns the best match.
+     * Search a shipment for the embeddable tracking widget
+     */
+    async searchWidgetRaw(requestParameters: SearchWidgetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WidgetSearchResult>> {
+        const requestOptions = await this.searchWidgetRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => WidgetSearchResultFromJSON(jsonValue));
+    }
+
+    /**
+     * Matches a container number, booking or bill of lading within the token\'s entity and returns the best match.
+     * Search a shipment for the embeddable tracking widget
+     */
+    async searchWidget(requestParameters: SearchWidgetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WidgetSearchResult> {
+        const response = await this.searchWidgetRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/index.ts

@@ -0,0 +1,6 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from './V3DocumentApi';
+export * from './V3DownstreamApi';
+export * from './V3UpstreamApi';
+export * from './WidgetApi';

package/src/index.ts

@@ -0,0 +1,5 @@
+/* tslint:disable */
+/* eslint-disable */
+export * from './runtime';
+export * from './apis/index';
+export * from './models/index';

package/src/models/ContainerReference.ts

@@ -0,0 +1,70 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Dockflow v3 API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * 
+ * @export
+ * @interface ContainerReference
+ */
+export interface ContainerReference {
+    /**
+     * 
+     */
+    reference: string;
+    /**
+     * Free-form key-value pairs stored on the container.
+     */
+    customProperties?: object;
+}
+
+/**
+ * Check if a given object implements the ContainerReference interface.
+ */
+export function instanceOfContainerReference(value: object): value is ContainerReference {
+    if (!('reference' in value) || value['reference'] === undefined) return false;
+    return true;
+}
+
+export function ContainerReferenceFromJSON(json: any): ContainerReference {
+    return ContainerReferenceFromJSONTyped(json, false);
+}
+
+export function ContainerReferenceFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContainerReference {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'reference': json['reference'],
+        'customProperties': json['custom_properties'] == null ? undefined : json['custom_properties'],
+    };
+}
+
+export function ContainerReferenceToJSON(json: any): ContainerReference {
+    return ContainerReferenceToJSONTyped(json, false);
+}
+
+export function ContainerReferenceToJSONTyped(value?: ContainerReference | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'reference': value['reference'],
+        'custom_properties': value['customProperties'],
+    };
+}
+

package/src/models/DocumentUpdate.ts

@@ -0,0 +1,75 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Dockflow v3 API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * Only the fields sent are changed.
+ * @export
+ * @interface DocumentUpdate
+ */
+export interface DocumentUpdate {
+    /**
+     * 
+     */
+    documentFilename?: string;
+    /**
+     * A type name from GET /v3/downstream/documents/types. An unknown name leaves the type unchanged.
+     */
+    documentType?: string;
+    /**
+     * Links the document to this container; an unknown reference unlinks it.
+     */
+    containerReference?: string;
+}
+
+/**
+ * Check if a given object implements the DocumentUpdate interface.
+ */
+export function instanceOfDocumentUpdate(value: object): value is DocumentUpdate {
+    return true;
+}
+
+export function DocumentUpdateFromJSON(json: any): DocumentUpdate {
+    return DocumentUpdateFromJSONTyped(json, false);
+}
+
+export function DocumentUpdateFromJSONTyped(json: any, ignoreDiscriminator: boolean): DocumentUpdate {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'documentFilename': json['document_filename'] == null ? undefined : json['document_filename'],
+        'documentType': json['document_type'] == null ? undefined : json['document_type'],
+        'containerReference': json['container_reference'] == null ? undefined : json['container_reference'],
+    };
+}
+
+export function DocumentUpdateToJSON(json: any): DocumentUpdate {
+    return DocumentUpdateToJSONTyped(json, false);
+}
+
+export function DocumentUpdateToJSONTyped(value?: DocumentUpdate | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'document_filename': value['documentFilename'],
+        'document_type': value['documentType'],
+        'container_reference': value['containerReference'],
+    };
+}
+