@shipengine/connect-carrier-api 2.6.4 → 2.8.1

package/lib/responses/get-service-points-response.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetServicePointsResponseSchema = exports.GetServicePointsResponse = void 0;
+const tslib_1 = require("tslib");
+const base_response_1 = require("./base-response");
+const joi_1 = tslib_1.__importDefault(require("joi"));
+const service_points_1 = require("../models/service-points");
+/** @description Basic structure for a response to get service points */
+class GetServicePointsResponse extends base_response_1.BaseResponse {
+}
+exports.GetServicePointsResponse = GetServicePointsResponse;
+exports.GetServicePointsResponseSchema = base_response_1.BaseResponseSchema.keys({
+    service_points: joi_1.default.array().required().items(service_points_1.ServicePointSchema),
+});
+//# sourceMappingURL=get-service-points-response.js.map

package/lib/responses/get-service-points-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-service-points-response.js","sourceRoot":"","sources":["../../src/responses/get-service-points-response.ts"],"names":[],"mappings":";;;;AAAA,mDAAmE;AACnE,sDAAsB;AACtB,6DAA4E;AAE5E,wEAAwE;AACxE,MAAa,wBAAyB,SAAQ,4BAAY;CAGzD;AAHD,4DAGC;AAEY,QAAA,8BAA8B,GAAG,kCAAkB,CAAC,IAAI,CAAC;IACpE,cAAc,EAAE,aAAG,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,mCAAkB,CAAC;CACjE,CAAC,CAAC"}

package/lib/responses/index.d.ts

@@ -12,3 +12,5 @@ export * from './create-notification-response';
 export * from './validate-inbound-data-response';
 export * from './normalize-tracking-data-response';
 export * from './get-relay-points-response';
+export * from './get-service-points-response';
+export * from './get-service-point-response';

package/lib/responses/index.js

@@ -15,4 +15,6 @@ tslib_1.__exportStar(require("./create-notification-response"), exports);
 tslib_1.__exportStar(require("./validate-inbound-data-response"), exports);
 tslib_1.__exportStar(require("./normalize-tracking-data-response"), exports);
 tslib_1.__exportStar(require("./get-relay-points-response"), exports);
+tslib_1.__exportStar(require("./get-service-points-response"), exports);
+tslib_1.__exportStar(require("./get-service-point-response"), exports);
 //# sourceMappingURL=index.js.map

package/lib/responses/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/responses/index.ts"],"names":[],"mappings":";;;AAAA,mEAAyC;AACzC,kEAAwC;AACxC,qEAA2C;AAC3C,+DAAqC;AACrC,8DAAoC;AACpC,qEAA2C;AAC3C,8DAAoC;AACpC,iEAAuC;AACvC,2DAAiC;AACjC,yEAA+C;AAC/C,yEAA+C;AAC/C,2EAAiD;AACjD,6EAAmD;AACnD,sEAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/responses/index.ts"],"names":[],"mappings":";;;AAAA,mEAAyC;AACzC,kEAAwC;AACxC,qEAA2C;AAC3C,+DAAqC;AACrC,8DAAoC;AACpC,qEAA2C;AAC3C,8DAAoC;AACpC,iEAAuC;AACvC,2DAAiC;AACjC,yEAA+C;AAC/C,yEAA+C;AAC/C,2EAAiD;AACjD,6EAAmD;AACnD,sEAA4C;AAC5C,wEAA8C;AAC9C,uEAA6C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipengine/connect-carrier-api",
-  "version": "2.6.4",
+  "version": "2.8.1",
   "description": "This is the typescript/javascript definitions for carrier api",
   "homepage": "https://github.com/ShipEngine/connect",
   "main": "./lib/index.js",

package/src/app/carrier-app-definition.ts

@@ -13,6 +13,8 @@ import {
   ValidateInboundDataRequest,
   NormalizeTrackingDataRequest,
   GetRelayPointsRequest,
+  GetServicePointsRequest,
+  GetServicePointRequest,
 } from '../requests';
 
 import {
@@ -29,6 +31,8 @@ import {
   ValidateInboundDataResponse,
   NormalizeTrackingDataResponse,
   GetRelayPointsResponse,
+  GetServicePointsResponse,
+  GetServicePointResponse,
 } from '../responses';
 
 import { CarrierAppMetadata } from './metadata/carrier-app-metadata';
@@ -126,4 +130,18 @@ export interface CarrierAppDefinition {
   GetRelayPoints?: (
     request: GetRelayPointsRequest,
   ) => GetRelayPointsResponse | Promise<GetRelayPointsResponse>;
+  /**
+   * @description This endpoint is used to get carrier service points
+   * @param request Data needed by the provider about the service points to be returned
+   */
+  GetServicePoints?: (
+    request: GetServicePointsRequest,
+  ) => GetServicePointsResponse | Promise<GetServicePointsResponse>;
+  /**
+   * @description This endpoint is used to get a carrier service point by id
+   * @param request Data needed by the provider about the service point to be returned
+   */
+  GetServicePoint?: (
+    request: GetServicePointRequest,
+  ) => GetServicePointResponse | Promise<GetServicePointResponse>;
 }

package/src/app/carrier-app.ts

@@ -20,6 +20,8 @@ import {
   ValidateInboundDataResponseSchema,
   NormalizeTrackingDataResponseSchema,
   GetRelayPointsResponseSchema,
+  GetServicePointsResponseSchema,
+  GetServicePointResponseSchema,
 } from '../responses';
 import { Schema } from 'joi';
 
@@ -113,6 +115,18 @@ export class CarrierApp implements ConnectRuntimeApp {
         definition.GetRelayPoints,
         GetRelayPointsResponseSchema,
       ],
+      [
+        Method.POST,
+        ApiEndpoints.GetServicePoints,
+        definition.GetServicePoints,
+        GetServicePointsResponseSchema,
+      ],
+      [
+        Method.POST,
+        ApiEndpoints.GetServicePoint,
+        definition.GetServicePoint,
+        GetServicePointResponseSchema,
+      ],
     ).forEach(([method, path, implementation, schema]) => {
       if (implementation) {
         this.routes.push({

package/src/app/constants.ts

@@ -13,4 +13,6 @@ export enum ApiEndpoints {
   ValidateInboundData = '/ValidateInboundData',
   NormalizeTrackingData = '/NormalizeTrackingData',
   GetRelayPoints = '/GetRelayPoints',
+  GetServicePoints = '/GetServicePoints',
+  GetServicePoint = '/GetServicePoint',
 }

package/src/app/metadata/carrier-app-metadata.ts

@@ -13,9 +13,7 @@ export interface CarrierAppMetadata {
 }
 
 export const CarrierAppMetadataSchema = Joi.object({
-  Id: Joi.string()
-    .uuid({ version: ['uuidv4'] })
-    .required(),
+  Id: Joi.string().uuid().required(),
   Name: Joi.string().required(),
   AuthProcess: AuthSpecificationSchema.optional(),
   Carriers: Joi.array()

package/src/app/metadata/carrier.ts

@@ -93,9 +93,7 @@ export const CarrierSchema = Joi.object({
   ApiCode: Joi.string()
     .optional()
     .pattern(/^[a-z][a-z0-9_]*[a-z]$/, 'ApiCode'),
-  Id: Joi.string()
-    .uuid({ version: ['uuidv4'] })
-    .required(),
+  Id: Joi.string().uuid().required(),
   Images: Joi.object({
     Icon: Joi.string()
       .required()

package/src/app/metadata/package-type.ts

@@ -32,9 +32,7 @@ export enum PackageAttribute {
 }
 
 export const PackageTypeSchema = Joi.object({
-  Id: Joi.string()
-    .uuid({ version: ['uuidv4'] })
-    .required(),
+  Id: Joi.string().uuid().required(),
   Name: Joi.string().required().max(50),
   ApiCode: Joi.string()
     .optional()

package/src/app/metadata/service-point-feature.ts

@@ -0,0 +1,13 @@
+import Joi from 'joi';
+
+export enum ServicePointFeaturesEnum {
+  DropOffPoint = 'DropOffPoint',
+  PickupPoint = 'PickupPoint',
+  PrintServices = 'PrintServices',
+  AfterHoursLocker = 'AfterHoursLocker',
+  AfterHoursDropbox = 'AfterHoursDropbox',
+}
+
+export const ServicePointFeaturesEnumSchema = Joi.string().valid(
+  ...Object.values(ServicePointFeaturesEnum),
+);

package/src/app/metadata/shipping-service.ts

@@ -58,7 +58,5 @@ export const ShippingServiceSchema = Joi.object({
   ApiCode: Joi.string()
     .optional()
     .pattern(/^[a-z][a-z0-9_]*[a-z]$/, 'ApiCode'),
-  Id: Joi.string()
-    .uuid({ version: ['uuidv4'] })
-    .required(),
+  Id: Joi.string().uuid().required(),
 });

package/src/models/addresses/service-point-address.ts

@@ -0,0 +1,8 @@
+import { LatLong } from '../tracking/lat-long';
+import { AddressBase } from './address-base';
+
+/** @description The basic address type related to service points */
+export class ServicePointAddress extends AddressBase {
+  /** @description Geographical location */
+  geo?: LatLong;
+}

package/src/models/billing/billing-line-item.ts

@@ -12,8 +12,10 @@ export class BillingLineItem {
   carrier_billing_code?: string;
   /** @description This will often be empty; however, if there was additionally specific information about the charge it should go here, could also be a reference number. Maximum length of 250 characters. */
   memo?: string;
-  /** @description Total amount of the line item */
+  /** @description Total amount of the line item displayed and charged to the buyer */
   amount!: Currency;
+  /** @description Total amount of the line item billed by the provider. This should only be populated if it differs from 'amount' **/
+  provider_billed_amount?: Currency;
 }
 
 export const BillingLineItemSchema = Joi.object({
@@ -22,4 +24,5 @@ export const BillingLineItemSchema = Joi.object({
   carrier_billing_code: Joi.string().optional().empty(),
   memo: Joi.string().optional().empty().max(250),
   amount: CurrencySchema.required(),
+  provider_billed_amount: CurrencySchema.optional(),
 });

package/src/models/service-points/hours-of-operation.ts

@@ -0,0 +1,14 @@
+import Joi from 'joi';
+
+/** @description Indicates a specific time window that a service point is open */
+export class HoursOfOperation {
+  /** @description The open time expressed in ISO 8601 time only format */
+  open?: string;
+  /** @description The close time expressed in ISO 8601 time only format */
+  close?: string;
+}
+
+export const HoursOfOperationSchema = Joi.object({
+  open: Joi.string().optional().empty(),
+  close: Joi.string().optional().empty(),
+});

package/src/models/service-points/index.ts

@@ -0,0 +1,3 @@
+export * from './service-point';
+export * from './weekly-hours-of-operation';
+export * from './service-point-response-address';

package/src/models/service-points/search-radius-unit.ts

@@ -0,0 +1,5 @@
+/** @description Unit of measurement for search radius */
+export enum SearchRadiusUnit {
+  Miles = 'miles',
+  Kilometers = 'kilometers',
+}

package/src/models/service-points/search-radius.ts

@@ -0,0 +1,13 @@
+import { SearchRadiusUnit } from './search-radius-unit';
+
+/** @description Basic structure for service point search radius */
+export class SearchRadius {
+  /** @description Search radius in miles */
+  radius_in_miles?: number;
+  /** @description Search radius in kilometers */
+  radius_in_kilometers?: number;
+  /** @description Search radius in the original unit */
+  source_radius?: number;
+  /** @description Search radius unit */
+  source_radius_unit!: SearchRadiusUnit;
+}

package/src/models/service-points/service-point-response-address.ts

@@ -0,0 +1,21 @@
+import Joi from 'joi';
+import { ServicePointAddress } from '../addresses/service-point-address';
+import { LatLongSchema } from '../tracking/lat-long';
+
+/** @description The address information corresponding to a specific service point */
+export class ServicePointResponseAddress extends ServicePointAddress {
+  /** @description Description of the location */
+  description?: string;
+}
+
+export const ServicePointResponseAddressSchema = Joi.object({
+  phone_number: Joi.string().optional().empty(),
+  company_name: Joi.string().optional().empty(),
+  description: Joi.string().optional().empty(),
+  geo: LatLongSchema.optional(),
+  address_lines: Joi.array().items(Joi.string()).required(),
+  city_locality: Joi.string().required(),
+  state_province: Joi.string().required(),
+  postal_code: Joi.string().required(),
+  country_code: Joi.string().required(),
+});

package/src/models/service-points/service-point.ts

@@ -0,0 +1,29 @@
+import Joi from 'joi';
+import {
+  ServicePointFeaturesEnum,
+  ServicePointFeaturesEnumSchema,
+} from '../../app/metadata/service-point-feature';
+import {
+  ServicePointResponseAddress,
+  ServicePointResponseAddressSchema,
+} from './service-point-response-address';
+import { WeeklyHoursOfOperation, WeeklyHoursOfOperationSchema } from './weekly-hours-of-operation';
+
+/** @description Basic structure for a service point */
+export class ServicePoint {
+  /** @description The identifier for the carrier's service point */
+  service_point_id!: string;
+  /** @description The address where the service point is located */
+  address!: ServicePointResponseAddress;
+  /** @description Weekly hours of operation for the service point */
+  hours_of_operation!: WeeklyHoursOfOperation;
+  /** @description Features supported by the service point */
+  features?: ServicePointFeaturesEnum[];
+}
+
+export const ServicePointSchema = Joi.object({
+  service_point_id: Joi.string().required(),
+  address: ServicePointResponseAddressSchema.required(),
+  hours_of_operation: WeeklyHoursOfOperationSchema.required(),
+  features: Joi.array().items(ServicePointFeaturesEnumSchema).optional(),
+});

package/src/models/service-points/weekly-hours-of-operation.ts

@@ -0,0 +1,23 @@
+import Joi from 'joi';
+import { HoursOfOperation, HoursOfOperationSchema } from './hours-of-operation';
+
+/** @description The times during the week that the relay point is open */
+export class WeeklyHoursOfOperation {
+  monday?: HoursOfOperation[];
+  tuesday?: HoursOfOperation[];
+  wednesday?: HoursOfOperation[];
+  thursday?: HoursOfOperation[];
+  friday?: HoursOfOperation[];
+  saturday?: HoursOfOperation[];
+  sunday?: HoursOfOperation[];
+}
+
+export const WeeklyHoursOfOperationSchema = Joi.object({
+  monday: HoursOfOperationSchema.optional(),
+  tuesday: HoursOfOperationSchema.optional(),
+  wednesday: HoursOfOperationSchema.optional(),
+  thursday: HoursOfOperationSchema.optional(),
+  friday: HoursOfOperationSchema.optional(),
+  saturday: HoursOfOperationSchema.optional(),
+  sunday: HoursOfOperationSchema.optional(),
+});

package/src/requests/get-service-point-request.ts

@@ -0,0 +1,9 @@
+import { BaseRequest } from './base-request';
+
+/** @description Basic structure for a request to get a single service point by id */
+export class GetServicePointRequest extends BaseRequest {
+  /** @description The service point id to get */
+  service_point_id!: string;
+  /** @description The two character country code of the service point. The codes are specified by ISO 3166-1 alpha-2 */
+  country_code!: string;
+}

package/src/requests/get-service-points-request.ts

@@ -0,0 +1,15 @@
+import { ServicePointAddress } from '../models/addresses/service-point-address';
+import { SearchRadius } from '../models/service-points/search-radius';
+import { BaseRequest } from './base-request';
+
+/** @description Basic structure for a request to get service points */
+export class GetServicePointsRequest extends BaseRequest {
+  /** @description The service code uniquely identifies a shipping service */
+  service_code?: string;
+  /** @description The address input for searching nearby carrier service points */
+  address!: ServicePointAddress;
+  /** @description The desired search radius around the given address */
+  search_radius?: SearchRadius;
+  /** @description The maximum number of service points to return */
+  max_results?: number;
+}

package/src/requests/index.ts

@@ -12,3 +12,5 @@ export * from './cancel-notification-request';
 export * from './validate-inbound-data-request';
 export * from './normalize-tracking-data-request';
 export * from './get-relay-points-request';
+export * from './get-service-points-request';
+export * from './get-service-point-request';

package/src/responses/get-service-point-response.ts

@@ -0,0 +1,12 @@
+import { BaseResponse, BaseResponseSchema } from './base-response';
+import { ServicePoint, ServicePointSchema } from '../models/service-points';
+
+/** @description Basic structure for a response to get a single service point by id */
+export class GetServicePointResponse extends BaseResponse {
+  /** @description The resulting service point */
+  service_point!: ServicePoint;
+}
+
+export const GetServicePointResponseSchema = BaseResponseSchema.keys({
+  service_point: ServicePointSchema.required(),
+});

package/src/responses/get-service-points-response.ts

@@ -0,0 +1,13 @@
+import { BaseResponse, BaseResponseSchema } from './base-response';
+import Joi from 'joi';
+import { ServicePoint, ServicePointSchema } from '../models/service-points';
+
+/** @description Basic structure for a response to get service points */
+export class GetServicePointsResponse extends BaseResponse {
+  /** @description The resulting service points */
+  service_points!: ServicePoint[];
+}
+
+export const GetServicePointsResponseSchema = BaseResponseSchema.keys({
+  service_points: Joi.array().required().items(ServicePointSchema),
+});

package/src/responses/index.ts

@@ -12,3 +12,5 @@ export * from './create-notification-response';
 export * from './validate-inbound-data-response';
 export * from './normalize-tracking-data-response';
 export * from './get-relay-points-response';
+export * from './get-service-points-response';
+export * from './get-service-point-response';