@shipengine/connect-carrier-api 2.2.2 → 2.3.1

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

@@ -39,23 +39,17 @@ export interface CarrierAppDefinition {
    * @description This method is used to register an account
    * @param request The information needed to register or initialize a connection with the shipping provider
    */
-  Register?: (
-    request: RegisterRequest,
-  ) => RegisterResponse | Promise<RegisterResponse>;
+  Register?: (request: RegisterRequest) => RegisterResponse | Promise<RegisterResponse>;
   /**
    * @description This method is used to create a label
    * @param request Data needed by the provider to create a label
    */
-  CreateLabel?: (
-    request: CreateLabelRequest,
-  ) => CreateLabelResponse | Promise<CreateLabelResponse>;
+  CreateLabel?: (request: CreateLabelRequest) => CreateLabelResponse | Promise<CreateLabelResponse>;
   /**
    * @description This method is used to void multiple labels
    * @param request Data needed by the provider to void multiple labels
    */
-  VoidLabels?: (
-    request: VoidLabelsRequest,
-  ) => VoidLabelsResponse | Promise<VoidLabelsResponse>;
+  VoidLabels?: (request: VoidLabelsRequest) => VoidLabelsResponse | Promise<VoidLabelsResponse>;
   /**
    * @description This method is used to create a manifest with a carrier
    * @param request Data needed by the provider to create a manifest
@@ -81,16 +75,12 @@ export interface CarrierAppDefinition {
    * @description This endpoint is used to get rates for a particular shipment
    * @param request Data needed by the provider to get a rate estimate
    */
-  GetRates?: (
-    request: GetRatesRequest,
-  ) => GetRatesResponse | Promise<GetRatesResponse>;
+  GetRates?: (request: GetRatesRequest) => GetRatesResponse | Promise<GetRatesResponse>;
   /**
    * @description This endpoint is used to get tracking information about a shipment
    * @param request Data needed by the provider to track a shipment
    */
-  Track?: (
-    request: TrackingRequest,
-  ) => TrackingResponse | Promise<TrackingResponse>;
+  Track?: (request: TrackingRequest) => TrackingResponse | Promise<TrackingResponse>;
   /**
    * @description This endpoint is used to submit notification of the creation of a shipment
    * @param request Data needed by the provider to inform them of a shipment

package/src/app/carrier-app.ts

@@ -44,15 +44,11 @@ export class CarrierApp implements ConnectRuntimeApp {
         c.DefaultSupportedCountries?.flatMap((sc) => sc.FromCountry),
       );
       const serviceCountries = definition.Metadata.Carriers.flatMap((c) =>
-        c.ShippingServices?.flatMap((s) => s.SupportedCountries).flatMap(
-          (sc) => sc?.FromCountry,
-        ),
+        c.ShippingServices?.flatMap((s) => s.SupportedCountries).flatMap((sc) => sc?.FromCountry),
       );
       countries.push(...rootCountries);
       countries.push(...serviceCountries);
-      const uniqueCountries = [...new Set(countries)].filter(
-        (c) => c !== undefined,
-      ) as string[];
+      const uniqueCountries = [...new Set(countries)].filter((c) => c !== undefined) as string[];
       return uniqueCountries;
     };
     this.validate = () => {
@@ -71,18 +67,8 @@ export class CarrierApp implements ConnectRuntimeApp {
         definition.CancelNotification,
         CancelNotificationResponseSchema,
       ],
-      [
-        Method.POST,
-        ApiEndpoints.CancelPickup,
-        definition.CancelPickup,
-        CancelPickupResponseSchema,
-      ],
-      [
-        Method.POST,
-        ApiEndpoints.CreateLabel,
-        definition.CreateLabel,
-        CreateLabelResponseSchema,
-      ],
+      [Method.POST, ApiEndpoints.CancelPickup, definition.CancelPickup, CancelPickupResponseSchema],
+      [Method.POST, ApiEndpoints.CreateLabel, definition.CreateLabel, CreateLabelResponseSchema],
       [
         Method.POST,
         ApiEndpoints.CreateManifest,
@@ -95,48 +81,28 @@ export class CarrierApp implements ConnectRuntimeApp {
         definition.CreateNotification,
         CreateNotificationResponseSchema,
       ],
-      [
-        Method.POST,
-        ApiEndpoints.GetRates,
-        definition.GetRates,
-        GetRatesResponseSchema,
-      ],
+      [Method.POST, ApiEndpoints.GetRates, definition.GetRates, GetRatesResponseSchema],
       [
         Method.POST,
         ApiEndpoints.NormalizeTrackingData,
         definition.NormalizeTrackingData,
         NormalizeTrackingDataResponseSchema,
       ],
-      [
-        Method.POST,
-        ApiEndpoints.Register,
-        definition.Register,
-        RegisterResponseSchema,
-      ],
+      [Method.POST, ApiEndpoints.Register, definition.Register, RegisterResponseSchema],
       [
         Method.POST,
         ApiEndpoints.SchedulePickup,
         definition.SchedulePickup,
         SchedulePickupResponseSchema,
       ],
-      [
-        Method.POST,
-        ApiEndpoints.Track,
-        definition.Track,
-        TrackingResponseSchema,
-      ],
+      [Method.POST, ApiEndpoints.Track, definition.Track, TrackingResponseSchema],
       [
         Method.POST,
         ApiEndpoints.ValidateInboundData,
         definition.ValidateInboundData,
         ValidateInboundDataResponseSchema,
       ],
-      [
-        Method.POST,
-        ApiEndpoints.VoidLabels,
-        definition.VoidLabels,
-        VoidLabelsResponseSchema,
-      ],
+      [Method.POST, ApiEndpoints.VoidLabels, definition.VoidLabels, VoidLabelsResponseSchema],
     ).forEach(([method, path, implementation, schema]) => {
       if (implementation) {
         this.routes.push({
@@ -147,9 +113,7 @@ export class CarrierApp implements ConnectRuntimeApp {
             const validationResults = schema.validate(result, {
               abortEarly: false,
             });
-            const errors = validationResults?.error?.details?.map(
-              (detail) => detail.message,
-            );
+            const errors = validationResults?.error?.details?.map((detail) => detail.message);
             return errors;
           },
         });

package/src/app/internal/carrier-specification.ts

@@ -37,9 +37,7 @@ export const mapShippingOptions = (
   return ret;
 };
 
-export const mapConfirmationTypes = (
-  types?: ConfirmationDictionary,
-): ConfirmationType[] => {
+export const mapConfirmationTypes = (types?: ConfirmationDictionary): ConfirmationType[] => {
   if (!types) {
     return [];
   }
@@ -56,6 +54,23 @@ export const mapConfirmationTypes = (
   return ret;
 };
 
+const mapAccountModal = (modal: AccountModals): AccountModals => {
+  return {
+    RegistrationFormSchema: {
+      JsonSchema:
+        modal.RegistrationFormSchema.JsonSchema ??
+        modal.RegistrationFormSchema.formSchema?.jsonSchema,
+      UiSchema:
+        modal.RegistrationFormSchema.UiSchema ?? modal.RegistrationFormSchema.formSchema?.uiSchema,
+    },
+    SettingsFormSchema: {
+      JsonSchema:
+        modal.SettingsFormSchema.JsonSchema ?? modal.SettingsFormSchema.formSchema?.jsonSchema,
+      UiSchema: modal.SettingsFormSchema.UiSchema ?? modal.SettingsFormSchema.formSchema?.uiSchema,
+    },
+  };
+};
+
 /** @description This represents what we send to data manager */
 export class CarrierSpecification {
   Id: string;
@@ -84,16 +99,14 @@ export class CarrierSpecification {
     };
     this.Id = definition.Id;
     this.Name = definition.Name;
-    this.AccountModals = definition.AccountModals;
+    this.AccountModals = mapAccountModal(definition.AccountModals);
     this.PackageTypes = definition.PackageTypes;
     this.ShippingServices = definition.ShippingServices;
     this.ShippingOptions = mapShippingOptions(definition.ShippingOptions);
     this.DefaultSupportedCountries = definition.DefaultSupportedCountries;
     this.DefaultLabelSizes = definition.DefaultLabelSizes;
     this.LabelFormats = definition.LabelFormats;
-    this.DefaultConfirmationTypes = mapConfirmationTypes(
-      definition.DefaultConfirmationTypes,
-    );
+    this.DefaultConfirmationTypes = mapConfirmationTypes(definition.DefaultConfirmationTypes);
     this.CarrierAttributes = definition.CarrierAttributes;
     this.TrackingUrl = definition.TrackingUrl;
     this.CarrierUrl = definition.CarrierUrl;

package/src/app/internal/metadata.ts

@@ -63,9 +63,7 @@ export class Metadata implements CarrierAppSpecification {
     if (this.AuthProcess) {
       this.AuthProcess.Identifier.Version = '2.0';
     }
-    this.Carriers = app.Metadata.Carriers.map(
-      (c) => new CarrierSpecification(c),
-    );
+    this.Carriers = app.Metadata.Carriers.map((c) => new CarrierSpecification(c));
 
     this.Connector = {
       DiagnosticRoutes: {

package/src/app/metadata/account-modals.ts

@@ -3,17 +3,23 @@ import Joi from 'joi';
 export interface AccountModals {
   /** @description Schema for the form to register with the carrier */
   RegistrationFormSchema: {
-    formSchema: {
+    /** @deprecated Please use JsonSchema & UiSchema */
+    formSchema?: {
       jsonSchema: object;
       uiSchema: object;
     };
+    JsonSchema?: object;
+    UiSchema?: object;
   };
   /** @description  Schema for the form to update carrier settings */
   SettingsFormSchema: {
-    formSchema: {
+    /** @deprecated Please use JsonSchema & UiSchema */
+    formSchema?: {
       jsonSchema: object;
       uiSchema: object;
     };
+    JsonSchema?: object;
+    UiSchema?: object;
   };
 }
 

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

@@ -1,10 +1,5 @@
 import Joi from 'joi';
-import {
-  AuthSpecification,
-  AuthSpecificationSchema,
-  Carrier,
-  CarrierSchema,
-} from '.';
+import { AuthSpecification, AuthSpecificationSchema, Carrier, CarrierSchema } from '.';
 
 export interface CarrierAppMetadata {
   /** @description Id of the carrier app */

package/src/app/metadata/carrier.ts

@@ -1,24 +1,12 @@
 import { AccountModals, AccountModalsSchema } from './account-modals';
 import { PackageType, PackageTypeSchema } from './package-type';
 import { ShippingService, ShippingServiceSchema } from './shipping-service';
-import {
-  ShippingOptionDictionary,
-  ShippingOptionDictionarySchema,
-} from './shipping-option';
-import {
-  CountryAssociation,
-  CountryAssociationSchema,
-} from './country-association';
-import {
-  CarrierAttributeEnum,
-  CarrierAttributeEnumSchema,
-} from './carrier-attributes';
+import { ShippingOptionDictionary, ShippingOptionDictionarySchema } from './shipping-option';
+import { CountryAssociation, CountryAssociationSchema } from './country-association';
+import { CarrierAttributeEnum, CarrierAttributeEnumSchema } from './carrier-attributes';
 import { LabelFormatsEnum, LabelFormatsEnumSchema } from './label-formats';
 import { LabelSizesEnum, LabelSizesEnumSchema } from './label-sizes';
-import {
-  ConfirmationDictionary,
-  ConfirmationDictionarySchema,
-} from './confirmation-type';
+import { ConfirmationDictionary, ConfirmationDictionarySchema } from './confirmation-type';
 import { existsSync } from 'fs';
 import Joi from 'joi';
 
@@ -37,6 +25,7 @@ export interface Carrier {
   CarrierUrl?: string;
   Description?: string;
   Name: string;
+  ApiCode?: string;
   Id: string;
   Images: {
     Logo: string;
@@ -54,25 +43,16 @@ const fileExists = (value: string, helpers: any) => {
 export const CarrierSchema = Joi.object({
   AccountModals: AccountModalsSchema.required(),
   PackageTypes: Joi.array().optional().items(PackageTypeSchema).unique('Id'),
-  ShippingServices: Joi.array()
-    .optional()
-    .items(ShippingServiceSchema)
-    .unique('Id'),
+  ShippingServices: Joi.array().optional().items(ShippingServiceSchema).unique('Id'),
   ShippingOptions: ShippingOptionDictionarySchema.optional(),
   DefaultSupportedCountries: Joi.array()
     .optional()
     .items(CountryAssociationSchema)
     .unique('FromCountry'),
-  DefaultLabelSizes: Joi.array()
-    .optional()
-    .items(LabelSizesEnumSchema)
-    .unique(),
+  DefaultLabelSizes: Joi.array().optional().items(LabelSizesEnumSchema).unique(),
   LabelFormats: Joi.array().optional().items(LabelFormatsEnumSchema).unique(),
   DefaultConfirmationTypes: ConfirmationDictionarySchema.optional(),
-  CarrierAttributes: Joi.array()
-    .optional()
-    .items(CarrierAttributeEnumSchema)
-    .unique(),
+  CarrierAttributes: Joi.array().optional().items(CarrierAttributeEnumSchema).unique(),
   TrackingUrl: Joi.string()
     .optional()
     .pattern(
@@ -84,6 +64,9 @@ export const CarrierSchema = Joi.object({
   CarrierUrl: Joi.string().optional().uri().max(200),
   Description: Joi.string().optional().max(250),
   Name: Joi.string().required().max(50),
+  ApiCode: Joi.string()
+    .optional()
+    .pattern(/^[a-z][a-z0-9_]*[a-z]$/, 'ApiCode'),
   Id: Joi.string()
     .uuid({ version: ['uuidv4'] })
     .required(),

package/src/app/metadata/label-formats.ts

@@ -6,6 +6,4 @@ export enum LabelFormatsEnum {
   PNG = 'PNG',
 }
 
-export const LabelFormatsEnumSchema = Joi.string().valid(
-  ...Object.values(LabelFormatsEnum),
-);
+export const LabelFormatsEnumSchema = Joi.string().valid(...Object.values(LabelFormatsEnum));

package/src/app/metadata/label-sizes.ts

@@ -5,6 +5,4 @@ export enum LabelSizesEnum {
   Inches4x8 = 'Inches4x8',
 }
 
-export const LabelSizesEnumSchema = Joi.string().valid(
-  ...Object.values(LabelSizesEnum),
-);
+export const LabelSizesEnumSchema = Joi.string().valid(...Object.values(LabelSizesEnum));

package/src/app/metadata/monoauth.ts

@@ -67,10 +67,7 @@ export class ResponseTransformationConfiguration {
   connection_context?: MapOfStrings;
 }
 
-export const MapOfStringsSchema = Joi.object().pattern(
-  Joi.string(),
-  Joi.string(),
-);
+export const MapOfStringsSchema = Joi.object().pattern(Joi.string(), Joi.string());
 
 export const ResponseTransformationConfigurationSchema = Joi.object({
   access_token: Joi.string().required(),

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

@@ -9,6 +9,7 @@ export enum RequiredToShipEnum {
 export interface PackageType {
   Id: string;
   Name: string;
+  ApiCode?: string;
   CarrierPackageTypeCode: string;
   Description?: string;
   Abbreviation?: string;
@@ -27,6 +28,9 @@ export const PackageTypeSchema = Joi.object({
     .uuid({ version: ['uuidv4'] })
     .required(),
   Name: Joi.string().required().max(50),
+  ApiCode: Joi.string()
+    .optional()
+    .pattern(/^[a-z][a-z0-9_]*[a-z]$/, 'ApiCode'),
   CarrierPackageTypeCode: Joi.string().required().max(50),
   Description: Joi.string().optional().max(500),
   Abbreviation: Joi.string().optional().max(20),

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

@@ -12,6 +12,4 @@ export enum ServiceClassEnum {
   ThreeDay = 'ThreeDay',
 }
 
-export const ServiceClassEnumSchema = Joi.string().valid(
-  ...Object.values(ServiceClassEnum),
-);
+export const ServiceClassEnumSchema = Joi.string().valid(...Object.values(ServiceClassEnum));

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

@@ -9,6 +9,4 @@ export enum ServiceGradeEnum {
   Standard = 'Standard',
 }
 
-export const ServiceGradeEnumSchema = Joi.string().valid(
-  ...Object.values(ServiceGradeEnum),
-);
+export const ServiceGradeEnumSchema = Joi.string().valid(...Object.values(ServiceGradeEnum));

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

@@ -1,12 +1,6 @@
 import { ConfirmationType, ConfirmationTypeSchema } from './confirmation-type';
-import {
-  CountryAssociation,
-  CountryAssociationSchema,
-} from './country-association';
-import {
-  ServiceAttributesEnum,
-  ServiceAttributesEnumSchema,
-} from './services-attributes';
+import { CountryAssociation, CountryAssociationSchema } from './country-association';
+import { ServiceAttributesEnum, ServiceAttributesEnumSchema } from './services-attributes';
 import { LabelSizesEnum, LabelSizesEnumSchema } from './label-sizes';
 import { ServiceClassEnum, ServiceClassEnumSchema } from './service-class';
 import { ServiceGradeEnum, ServiceGradeEnumSchema } from './service-grade';
@@ -30,27 +24,16 @@ export interface ShippingService {
   Code: string;
   Abbreviation?: string;
   Name: string;
+  ApiCode?: string;
   Id: string;
 }
 
 export const ShippingServiceSchema = Joi.object({
-  ConfirmationTypes: Joi.array()
-    .optional()
-    .items(ConfirmationTypeSchema)
-    .unique('Type'),
+  ConfirmationTypes: Joi.array().optional().items(ConfirmationTypeSchema).unique('Type'),
   ServiceAttributes: Joi.array().items(ServiceAttributesEnumSchema).optional(),
-  SupportedCountries: Joi.array()
-    .optional()
-    .items(CountryAssociationSchema)
-    .unique('FromCountry'),
-  SupportedLabelSizes: Joi.array()
-    .optional()
-    .items(LabelSizesEnumSchema)
-    .unique(),
-  RequiredProperties: Joi.array()
-    .optional()
-    .items(ServiceRequiredPropertiesEnumSchema)
-    .unique(),
+  SupportedCountries: Joi.array().optional().items(CountryAssociationSchema).unique('FromCountry'),
+  SupportedLabelSizes: Joi.array().optional().items(LabelSizesEnumSchema).unique(),
+  RequiredProperties: Joi.array().optional().items(ServiceRequiredPropertiesEnumSchema).unique(),
   Grade: ServiceGradeEnumSchema.optional(),
   Class: ServiceClassEnumSchema.optional(),
   LabelCode: Joi.string().optional().max(50),
@@ -58,6 +41,9 @@ export const ShippingServiceSchema = Joi.object({
   Code: Joi.string().required().max(50),
   Abbreviation: Joi.string().optional().max(20),
   Name: Joi.string().required().max(80),
+  ApiCode: Joi.string()
+    .optional()
+    .pattern(/^[a-z][a-z0-9_]*[a-z]$/, 'ApiCode'),
   Id: Joi.string()
     .uuid({ version: ['uuidv4'] })
     .required(),

package/src/index.ts

@@ -5,3 +5,4 @@ export * as responses from './responses';
 export * from './requests';
 export * from './responses';
 export * from './app';
+export * from './models';

package/src/models/addresses/address-base.ts

@@ -1,35 +1,34 @@
 import { AddressResidentialIndicator } from './address-residential-indicator';
 
 export class AddressBase {
-  /** @description Name of the contact */
+  /** @description The full name of the contact contact associated with the address */
   name?: string;
-  /** @description First or given name of the contact */
+  /** @description The first name of the contact associated with the address */
   first_name?: string;
-  /** @description Last or family name of the contact  */
+  /** @description The last name of the contact associated with the address */
   last_name?: string;
-  /** @description Email of the contact */
+  /** @description The email of the contact associated with the address */
   email?: string;
-  /** @description Phone number of the contact. Cannot include newline chars. */
-
+  /** @description The phone number of the contact associated with the address (No Newline Characters) */
   phone_number?: string;
-  /** @description Company name, if applicable. Cannot include newline chars. */
+  /** @description The name of the company associated with this address (No Newline Characters) max length 100 characters */
   company_name?: string;
-  /** @description Address fields separated by line. Up to 100 chars per line. Cannot include newline chars. */
+  /** @description The address lines of the address (No Newline Characters) max length 100 characters */
   address_lines?: string[];
-  /** @description City or locality. Cannot contain newline chars. */
+  /** @description City or locality (No Newline Characters) */
   city_locality?: string;
-  /** @description State or province. Cannot contain newline chars. */
+  /** @description State or province (No Newline Characters) */
   state_province?: string;
-  /** @description Zip or postal code. Cannot include newline chars. */
+  /** @description Zip or postal code (No Newline Characters) */
   postal_code!: string;
-  /** @description ISO 3166-1 two-letter country code  */
+  /** @description ISO 3166-1 two-letter country code max length 2 characters  */
   country_code!: string;
   /** @description Whether the address is residential or commercial */
   address_residential_indicator?: AddressResidentialIndicator;
   /** @description Whether the country of the shipment address is a member of the EU */
   is_eu?: boolean;
-  /** @description Metadata for this address */
+  /** @description Additional metadata provided for specific requests */
   address_metadata?: { [key: string]: string };
-  /** @description Instructions to help the carrier navigate to the address. */
+  /** @description Instructions to help the carrier navigate to the address */
   instructions?: string;
 }

package/src/models/addresses/address-residential-indicator.ts

@@ -1,6 +1,9 @@
 /** @description Used for indicating whether an address is residential or commercial */
 export enum AddressResidentialIndicator {
+  /** @description Indicates that it is unknown whether or not the address is in a residential or commercial area */
   Unknown = 'unknown',
+  /** @description Indicates that the address is in a residential area */
   Yes = 'yes',
+  /** @description Indicates that the address is not in a residential area */
   No = 'no',
 }

package/src/models/addresses/ship-from-display.ts

@@ -1,3 +1,4 @@
 import { AddressBase } from './address-base';
 
+/** @description The address that should be displayed on the label as the ship from location */
 export class ShipFromDisplay extends AddressBase {}

package/src/models/addresses/ship-from.ts

@@ -1,6 +1,7 @@
 import { AddressBase } from './address-base';
 import { TaxIdentifier } from '../taxes/tax-identifier';
 
+/** @description The address for where the shipment will be shipped from */
 export class ShipFrom extends AddressBase {
   /** @description Tax IDs associated with the exporter */
   tax_identifiers?: TaxIdentifier[];

package/src/models/addresses/ship-to.ts

@@ -1,6 +1,7 @@
 import { AddressBase } from './address-base';
 import { TaxIdentifier } from '../taxes/tax-identifier';
 
+/** @description The address that a shipment will be delivered to */
 export class ShipTo extends AddressBase {
   /** @description Tax IDs associated with the consignee */
   tax_identifiers?: TaxIdentifier[];

package/src/models/advanced-options.ts

@@ -12,7 +12,7 @@ export class AdvancedOptions {
   bill_duties_to_sender?: boolean;
   /** @description Whether Saturday delivery is permissible  */
   saturday_delivery?: boolean;
-  /** @description Amount to be paid to the driver, used for local delivery and courier services. */
+  /** @description Amount to be paid to the driver, used for local delivery and courier services */
   tip?: Currency;
   /** @description Any other custom shipping options */
   [key: string]: any;

package/src/models/authorization.ts

@@ -1,4 +1,6 @@
 export class Authorization {
+  /** @description The access token used to authorize the request */
   access_token?: string;
+  /** @description Optional - any additional information required to authorize the request */
   connection_context?: any;
 }

package/src/models/billing/billing-categories.ts

@@ -22,10 +22,8 @@ export enum BillingCategories {
   Oversize = 'oversize',
   Returns = 'returns',
   Notifications = 'notifications',
-  /** @description Amount to be paid to the driver, used for local delivery and courier services. */
+  /** @description Amount to be paid to the driver, used for local delivery and courier services */
   Tip = 'tip',
 }
 
-export const BillingCategoriesSchema = Joi.string().valid(
-  ...Object.values(BillingCategories),
-);
+export const BillingCategoriesSchema = Joi.string().valid(...Object.values(BillingCategories));

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

@@ -1,23 +1,25 @@
-import {
-  BillingCategories,
-  BillingCategoriesSchema,
-} from './billing-categories';
+import { BillingCategories, BillingCategoriesSchema } from './billing-categories';
 import { Currency, CurrencySchema } from '../currency';
 import Joi from 'joi';
 
 /** @description Basic structure of each charge or line item */
 export class BillingLineItem {
+  /** A generalized category for what type of billing line item this is */
   billing_category!: BillingCategories;
+  /** @description If the carrier provides a description from their API about the billing charge (not specific to the user). Maximum length of 100 characters. */
   carrier_description?: string;
+  /** @description If the carrier provides a billing code for */
   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 */
   amount!: Currency;
 }
 
 export const BillingLineItemSchema = Joi.object({
   billing_category: BillingCategoriesSchema.required(),
-  carrier_description: Joi.string().optional().empty(),
+  carrier_description: Joi.string().optional().empty().max(100),
   carrier_billing_code: Joi.string().optional().empty(),
-  memo: Joi.string().optional().empty(),
+  memo: Joi.string().optional().empty().max(250),
   amount: CurrencySchema.required(),
 });

package/src/models/confirmation-types.ts

@@ -1,13 +1,13 @@
 /** @description Types of delivery confirmation */
 export enum ConfirmationTypes {
-  /** @description No confirmation is requested. */
+  /** @description No confirmation is requested */
   None = 'None',
-  /** @description Delivery confirmation is requested. */
+  /** @description Delivery confirmation is requested */
   Delivery = 'Delivery',
-  /** @description A signature is required. This signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present). */
+  /** @description A signature is required. This signature may be a neighbor, building manager, or the recipient can authorize the release of the package (without being present) */
   Signature = 'Signature',
-  /** @description A signature of an adult is required. */
+  /** @description A signature of an adult is required */
   AdultSignature = 'AdultSignature',
-  /** @description Only supported by FedEx. The signature of somebody at the address is required. */
+  /** @description Only supported by FedEx. The signature of somebody at the address is required */
   DirectSignature = 'DirectSignature',
 }

package/src/models/currency.ts

@@ -2,7 +2,9 @@ import Joi from 'joi';
 
 /** @description Basic structure for defining an amount of money and its currency */
 export class Currency {
+  /** @description The ISO 4217 Currency Code (USD, EUR, etc) https://www.iso.org/iso-4217-currency-codes.html */
   currency!: string;
+  /** @description The amount */
   amount!: string;
 }