/* * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT. */ import * as z from "zod/v4-mini"; import { ShippoCore } from "../core.js"; import { encodeFormQuery, encodeSimple } from "../lib/encodings.js"; import * as M from "../lib/matchers.js"; import { compactMap } from "../lib/primitives.js"; import { safeParse } from "../lib/schemas.js"; import { RequestOptions } from "../lib/sdks.js"; import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js"; import { pathToFunc } from "../lib/url.js"; import * as components from "../models/components/index.js"; import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError, } from "../models/errors/httpclienterrors.js"; import { ResponseValidationError } from "../models/errors/responsevalidationerror.js"; import { SDKValidationError } from "../models/errors/sdkvalidationerror.js"; import { ShippoError } from "../models/errors/shippoerror.js"; import * as operations from "../models/operations/index.js"; import { APICall, APIPromise } from "../types/async.js"; import { Result } from "../types/fp.js"; /** * List all shipments * * @remarks * Returns a list of all shipment objects.

* In order to filter results, you must use the below path parameters. * A maximum date range of 90 days is permitted. * Provided dates should be ISO 8601 UTC dates (timezone offsets are currently not supported).

* * Optional path parameters:
* `object_created_gt`- object(s) created greater than a provided date time
* `object_created_gte` - object(s) created greater than or equal to a provided date time
* `object_created_lt` - object(s) created less than a provided date time
* `object_created_lte` - object(s) created less than or equal to a provided date time
* * Date format examples:
* `2017-01-01`
* `2017-01-01T03:30:30` or `2017-01-01T03:30:30.5`
* `2017-01-01T03:30:30Z`

* * Example URL:
* `https://api.goshippo.com/shipments/?object_created_gte=2017-01-01T00:00:30&object_created_lt=2017-04-01T00:00:30` */ export function shipmentsList( client: ShippoCore, request: operations.ListShipmentsRequest, options?: RequestOptions, ): APIPromise< Result< components.ShipmentPaginatedList, | ShippoError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError > > { return new APIPromise($do( client, request, options, )); } async function $do( client: ShippoCore, request: operations.ListShipmentsRequest, options?: RequestOptions, ): Promise< [ Result< components.ShipmentPaginatedList, | ShippoError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >, APICall, ] > { const parsed = safeParse( request, (value) => z.parse(operations.ListShipmentsRequest$outboundSchema, value), "Input validation failed", ); if (!parsed.ok) { return [parsed, { status: "invalid" }]; } const payload = parsed.value; const body = null; const path = pathToFunc("/shipments")(); const query = encodeFormQuery({ "object_created_gt": payload.object_created_gt, "object_created_gte": payload.object_created_gte, "object_created_lt": payload.object_created_lt, "object_created_lte": payload.object_created_lte, "page": payload.page, "page_token": payload.page_token, "results": payload.results, }); const headers = new Headers(compactMap({ Accept: "application/json", "SHIPPO-API-VERSION": encodeSimple( "SHIPPO-API-VERSION", client._options.shippoApiVersion, { explode: false, charEncoding: "none" }, ), })); const secConfig = await extractSecurity(client._options.apiKeyHeader); const securityInput = secConfig == null ? {} : { apiKeyHeader: secConfig }; const requestSecurity = resolveGlobalSecurity(securityInput); const context = { options: client._options, baseURL: options?.serverURL ?? client._baseURL ?? "", operationID: "ListShipments", oAuth2Scopes: null, resolvedSecurity: requestSecurity, securitySource: client._options.apiKeyHeader, retryConfig: options?.retries || client._options.retryConfig || { strategy: "none" }, retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"], }; const requestRes = client._createRequest(context, { security: requestSecurity, method: "GET", baseURL: options?.serverURL, path: path, headers: headers, query: query, body: body, userAgent: client._options.userAgent, timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1, }, options); if (!requestRes.ok) { return [requestRes, { status: "invalid" }]; } const req = requestRes.value; const doResult = await client._do(req, { context, errorCodes: ["400", "4XX", "5XX"], retryConfig: context.retryConfig, retryCodes: context.retryCodes, }); if (!doResult.ok) { return [doResult, { status: "request-error", request: req }]; } const response = doResult.value; const [result] = await M.match< components.ShipmentPaginatedList, | ShippoError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >( M.json(200, components.ShipmentPaginatedList$inboundSchema), M.fail([400, "4XX"]), M.fail("5XX"), )(response, req); if (!result.ok) { return [result, { status: "complete", request: req, response }]; } return [result, { status: "complete", request: req, response }]; }