@5ss/ai-tools 3.5.1 → 3.7.0

package/dist/vendors/shipstation/index.js

@@ -0,0 +1,706 @@
+import { t as ToolError } from "../../errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "../../define-ieoksEQ0.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { t as HttpService } from "../../http-service-BMBIryAL.js";
+import { n as bytesToBase64, o as utf8ToBytes } from "../../bytes-BxpimpQx.js";
+import { z } from "zod";
+//#region src/vendors/shipstation/contracts.ts
+const shipstationAuthSchema = z.object({
+	v2_api_key: z.string().min(1).describe("ShipStation V2 API key"),
+	v1_api_key: z.string().min(1).describe("ShipStation V1 API key"),
+	v1_api_secret: z.string().min(1).describe("ShipStation V1 API secret")
+});
+const shipstationPageSchema = z.int().min(1).optional().describe("Provider page number, starting at 1");
+const shipstationPageSizeSchema = z.int().min(1).max(500).optional().describe("Records per page, from 1 to 500; defaults to 25");
+const shipstationMoneySchema = z.looseObject({
+	currency: z.string().min(1),
+	amount: z.number().nonnegative()
+});
+const shipstationRefundDetailsRawSchema = z.looseObject({
+	refund_status: z.string().nullable().optional(),
+	request_date: z.string().nullable().optional(),
+	amount_paid: shipstationMoneySchema.nullable().optional(),
+	amount_requested: shipstationMoneySchema.nullable().optional()
+});
+const shipstationLabelRawSchema = z.looseObject({
+	label_id: z.string().min(1),
+	shipment_id: z.string().nullable().optional(),
+	external_shipment_id: z.string().nullable().optional(),
+	external_order_id: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	service_code: z.string().nullable().optional(),
+	tracking_number: z.string().nullable().optional(),
+	created_at: z.string().nullable().optional(),
+	modified_at: z.string().nullable().optional(),
+	ship_date: z.string().nullable().optional(),
+	shipment_cost: shipstationMoneySchema.nullable().optional(),
+	insurance_cost: shipstationMoneySchema.nullable().optional(),
+	voided: z.boolean().nullable().optional(),
+	voided_at: z.string().nullable().optional(),
+	refund_details: shipstationRefundDetailsRawSchema.nullable().optional(),
+	status: z.string().nullable().optional()
+});
+const shipstationShipmentRawSchema = z.looseObject({
+	shipment_id: z.string().min(1),
+	external_order_id: z.string().nullable().optional(),
+	shipment_number: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	service_code: z.string().nullable().optional(),
+	store_id: z.string().nullable().optional(),
+	created_at: z.string().nullable().optional(),
+	modified_at: z.string().nullable().optional(),
+	shipment_status: z.string().nullable().optional()
+});
+const shipstationFulfillmentRawSchema = z.looseObject({
+	fulfillment_id: z.string().min(1),
+	shipment_id: z.string().nullable().optional(),
+	shipment_number: z.string().nullable().optional(),
+	tracking_number: z.string().nullable().optional(),
+	carrier_code: z.string().nullable().optional(),
+	fulfillment_provider_code: z.string().nullable().optional(),
+	created_at: z.string().nullable().optional(),
+	ship_date: z.string().nullable().optional()
+});
+const shipstationCarrierServiceRawSchema = z.looseObject({
+	service_code: z.string().min(1),
+	name: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	carrier_code: z.string().nullable().optional(),
+	domestic: z.boolean().nullable().optional(),
+	international: z.boolean().nullable().optional()
+});
+const shipstationCarrierPackageRawSchema = z.looseObject({
+	package_code: z.string().min(1),
+	name: z.string().nullable().optional(),
+	carrier_id: z.string().nullable().optional(),
+	carrier_code: z.string().nullable().optional()
+});
+const shipstationCarrierOptionRawSchema = z.looseObject({
+	name: z.string().min(1),
+	description: z.string().nullable().optional(),
+	default_value: z.union([
+		z.string(),
+		z.number(),
+		z.boolean()
+	]).nullable().optional()
+});
+const shipstationCarrierRawSchema = z.looseObject({
+	carrier_id: z.string().min(1),
+	carrier_code: z.string().nullable().optional(),
+	account_number: z.string().nullable().optional(),
+	nickname: z.string().nullable().optional(),
+	friendly_name: z.string().nullable().optional(),
+	primary: z.boolean().nullable().optional(),
+	connection_status: z.string().nullable().optional(),
+	services: z.array(shipstationCarrierServiceRawSchema).optional(),
+	packages: z.array(shipstationCarrierPackageRawSchema).optional(),
+	options: z.array(shipstationCarrierOptionRawSchema).optional()
+});
+const shipstationOrderRawSchema = z.looseObject({
+	orderId: z.int(),
+	orderNumber: z.string().nullable().optional(),
+	orderKey: z.string().nullable().optional(),
+	orderStatus: z.string().nullable().optional(),
+	createDate: z.string().nullable().optional(),
+	modifyDate: z.string().nullable().optional(),
+	orderDate: z.string().nullable().optional(),
+	paymentDate: z.string().nullable().optional(),
+	shipByDate: z.string().nullable().optional(),
+	storeId: z.int().nullable().optional()
+});
+const shipstationStoreRawSchema = z.looseObject({
+	storeId: z.int(),
+	storeName: z.string().nullable().optional(),
+	marketplaceId: z.int().nullable().optional(),
+	marketplaceName: z.string().nullable().optional(),
+	active: z.boolean().nullable().optional(),
+	createDate: z.string().nullable().optional(),
+	modifyDate: z.string().nullable().optional(),
+	autoRefresh: z.boolean().nullable().optional()
+});
+const shipstationPaginationSchema = z.object({
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative(),
+	page_size: z.int().min(1).max(500),
+	has_more: z.boolean()
+});
+const shipstationListLabelsPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	label_status: z.string().min(1).optional().describe("Label status filter"),
+	service_code: z.string().min(1).optional().describe("Carrier service code filter"),
+	carrier_id: z.string().min(1).optional().describe("ShipStation carrier id filter"),
+	tracking_number: z.string().min(1).optional().describe("Exact tracking number filter"),
+	batch_id: z.string().min(1).optional().describe("ShipStation batch id filter"),
+	rate_id: z.string().min(1).optional().describe("ShipStation rate id filter"),
+	shipment_id: z.string().min(1).optional().describe("ShipStation shipment id filter"),
+	external_shipment_id: z.string().min(1).optional().describe("External shipment id filter"),
+	warehouse_id: z.string().min(1).optional().describe("ShipStation warehouse id filter"),
+	created_at_start: z.iso.datetime({ offset: true }).optional().describe("Include labels created at or after this ISO 8601 timestamp"),
+	created_at_end: z.iso.datetime({ offset: true }).optional().describe("Include labels created at or before this ISO 8601 timestamp"),
+	refund_status: z.string().min(1).optional().describe("Comma-separated label refund statuses"),
+	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction; defaults to desc"),
+	sort_by: z.enum([
+		"modified_at",
+		"created_at",
+		"voided_at"
+	]).optional().describe("Label field used to sort the provider slice")
+});
+const shipstationListLabelsPageOutputSchema = z.object({
+	items: z.array(shipstationLabelRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationListShipmentsPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	shipment_status: z.string().min(1).optional().describe("Shipment status filter"),
+	batch_id: z.string().min(1).optional().describe("ShipStation batch id filter"),
+	pickup_id: z.string().min(1).optional().describe("ShipStation pickup id filter"),
+	created_at_start: z.iso.datetime({ offset: true }).optional().describe("Include shipments created at or after this ISO 8601 timestamp"),
+	created_at_end: z.iso.datetime({ offset: true }).optional().describe("Include shipments created at or before this ISO 8601 timestamp"),
+	modified_at_start: z.iso.datetime({ offset: true }).optional().describe("Include shipments modified at or after this ISO 8601 timestamp"),
+	modified_at_end: z.iso.datetime({ offset: true }).optional().describe("Include shipments modified at or before this ISO 8601 timestamp"),
+	sales_order_id: z.string().min(1).optional().describe("Sales order id filter"),
+	shipment_number: z.string().min(1).optional().describe("Shipment number filter"),
+	ship_to_name: z.string().min(1).optional().describe("Recipient name filter"),
+	item_keyword: z.string().min(1).optional().describe("Shipment item keyword filter"),
+	payment_date_start: z.iso.datetime({ offset: true }).optional().describe("Include shipments paid at or after this ISO 8601 timestamp"),
+	payment_date_end: z.iso.datetime({ offset: true }).optional().describe("Include shipments paid at or before this ISO 8601 timestamp"),
+	store_id: z.string().min(1).optional().describe("ShipStation store id filter"),
+	external_shipment_id: z.string().min(1).optional().describe("External shipment id filter"),
+	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction; defaults to desc"),
+	sort_by: z.enum(["modified_at", "created_at"]).optional().describe("Shipment field used to sort the provider slice")
+});
+const shipstationListShipmentsPageOutputSchema = z.object({
+	items: z.array(shipstationShipmentRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationListFulfillmentsPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	ship_to_name: z.string().min(1).optional().describe("Recipient name filter"),
+	ship_to_country_code: z.string().length(2).optional().describe("Two-letter destination country code"),
+	shipment_number: z.string().min(1).optional().describe("Shipment number filter"),
+	shipment_id: z.string().min(1).optional().describe("Shipment id filter"),
+	fulfillment_id: z.string().min(1).optional().describe("Fulfillment id filter"),
+	batch_id: z.string().min(1).optional().describe("Batch id filter"),
+	order_source_id: z.string().min(1).optional().describe("Order source id filter"),
+	fulfillment_provider_code: z.string().min(1).optional().describe("Fulfillment provider code filter"),
+	tracking_number: z.string().min(1).optional().describe("Tracking number filter"),
+	ship_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest fulfillment ship time"),
+	ship_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest fulfillment ship time"),
+	create_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest fulfillment creation time"),
+	create_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest fulfillment creation time"),
+	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction"),
+	sort_by: z.literal("created_at").optional().describe("Fulfillment field used to sort the provider slice")
+});
+const shipstationListFulfillmentsPageOutputSchema = z.object({
+	items: z.array(shipstationFulfillmentRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationCarrierIdInputSchema = z.strictObject({ carrier_id: z.string().min(1).describe("ShipStation V2 carrier id") });
+const shipstationListCarriersOutputSchema = z.object({ items: z.array(shipstationCarrierRawSchema) });
+const shipstationGetCarrierOutputSchema = shipstationCarrierRawSchema;
+const shipstationListCarrierServicesOutputSchema = z.object({ items: z.array(shipstationCarrierServiceRawSchema) });
+const shipstationListCarrierPackagesOutputSchema = z.object({ items: z.array(shipstationCarrierPackageRawSchema) });
+const shipstationListCarrierOptionsOutputSchema = z.object({ items: z.array(shipstationCarrierOptionRawSchema) });
+const shipstationListOrdersPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	customer_name: z.string().min(1).optional().describe("Customer name filter"),
+	item_keyword: z.string().min(1).optional().describe("Order item SKU, description, or option filter"),
+	create_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest ShipStation creation time"),
+	create_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest ShipStation creation time"),
+	modify_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest modification time"),
+	modify_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest modification time"),
+	order_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest order time"),
+	order_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest order time"),
+	order_number: z.string().min(1).optional().describe("Order number prefix filter"),
+	order_status: z.enum([
+		"awaiting_payment",
+		"awaiting_shipment",
+		"pending_fulfillment",
+		"shipped",
+		"on_hold",
+		"cancelled",
+		"rejected_fulfillment"
+	]).optional().describe("Order status filter"),
+	payment_date_start: z.iso.datetime({ offset: true }).optional().describe("Earliest payment time"),
+	payment_date_end: z.iso.datetime({ offset: true }).optional().describe("Latest payment time"),
+	store_id: z.int().optional().describe("V1 store id filter"),
+	sort_by: z.enum([
+		"OrderDate",
+		"ModifyDate",
+		"CreateDate"
+	]).optional().describe("Order sort field"),
+	sort_dir: z.enum(["ASC", "DESC"]).optional().describe("Order sort direction")
+});
+const shipstationListOrdersPageOutputSchema = z.object({
+	items: z.array(shipstationOrderRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationListStoresInputSchema = z.strictObject({
+	show_inactive: z.boolean().optional().describe("Include inactive stores"),
+	marketplace_id: z.int().optional().describe("Marketplace type id filter")
+});
+const shipstationListStoresOutputSchema = z.object({ items: z.array(shipstationStoreRawSchema) });
+const shipstationListLabelsResponseSchema = z.looseObject({
+	labels: z.array(shipstationLabelRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListShipmentsResponseSchema = z.looseObject({
+	shipments: z.array(shipstationShipmentRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListFulfillmentsResponseSchema = z.looseObject({
+	fulfillments: z.array(shipstationFulfillmentRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListCarriersResponseSchema = z.looseObject({ carriers: z.array(shipstationCarrierRawSchema) });
+const shipstationListCarrierServicesResponseSchema = z.looseObject({ services: z.array(shipstationCarrierServiceRawSchema) });
+const shipstationListCarrierPackagesResponseSchema = z.looseObject({ packages: z.array(shipstationCarrierPackageRawSchema) });
+const shipstationListCarrierOptionsResponseSchema = z.looseObject({ options: z.array(shipstationCarrierOptionRawSchema) });
+const shipstationListOrdersResponseSchema = z.looseObject({
+	orders: z.array(shipstationOrderRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListStoresResponseSchema = z.array(shipstationStoreRawSchema);
+//#endregion
+//#region src/vendors/shipstation/client.ts
+const SHIPSTATION_V2_API_BASE = "https://api.shipstation.com/v2";
+const SHIPSTATION_V1_API_BASE = "https://ssapi.shipstation.com";
+const DEFAULT_PAGE_SIZE = 25;
+function parseInput(schema, input, message) {
+	const parsed = schema.safeParse(input);
+	if (!parsed.success) throw new ToolError(message, {
+		code: "bad_input",
+		details: { issues: parsed.error.issues.map((issue) => issue.message) }
+	});
+	return parsed.data;
+}
+function parseResponse(schema, data, message) {
+	const parsed = schema.safeParse(data);
+	if (!parsed.success) throw new ToolError(message, {
+		code: "upstream",
+		details: { issues: parsed.error.issues.map((issue) => issue.message) }
+	});
+	return parsed.data;
+}
+function v1Authorization(apiKey, apiSecret) {
+	return `Basic ${bytesToBase64(utf8ToBytes(`${apiKey}:${apiSecret}`))}`;
+}
+var ShipstationClient = class ShipstationClient {
+	#v2;
+	#v1;
+	constructor(auth, options = {}) {
+		const parsed = shipstationAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid ShipStation auth credentials", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		this.#v2 = new HttpService({
+			...options,
+			baseURL: SHIPSTATION_V2_API_BASE,
+			headers: {
+				Accept: "application/json",
+				"API-Key": parsed.data.v2_api_key
+			},
+			label: "ShipStation V2"
+		});
+		this.#v1 = new HttpService({
+			...options,
+			baseURL: SHIPSTATION_V1_API_BASE,
+			headers: {
+				Accept: "application/json",
+				Authorization: v1Authorization(parsed.data.v1_api_key, parsed.data.v1_api_secret)
+			},
+			label: "ShipStation V1"
+		});
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, shipstationAuthSchema);
+		return new ShipstationClient(auth, {
+			...ctx.fetch && { fetch: ctx.fetch },
+			...ctx.signal && { signal: ctx.signal }
+		});
+	}
+	/** One V2 GET /labels request with provider pagination and filters. */
+	async listLabelsPage(input = {}) {
+		const parsedInput = parseInput(shipstationListLabelsPageInputSchema, input, "Invalid ShipStation labels page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v2.get("/labels", {
+			label: "ShipStation listLabelsPage",
+			query: {
+				...parsedInput,
+				page,
+				page_size: pageSize
+			}
+		});
+		const response = parseResponse(shipstationListLabelsResponseSchema, data, "ShipStation returned an invalid labels page");
+		return {
+			items: response.labels,
+			pagination: {
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
+				page_size: pageSize,
+				has_more: response.page < response.pages
+			}
+		};
+	}
+	/** One V2 GET /shipments request with provider pagination and filters. */
+	async listShipmentsPage(input = {}) {
+		const parsedInput = parseInput(shipstationListShipmentsPageInputSchema, input, "Invalid ShipStation shipments page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v2.get("/shipments", {
+			label: "ShipStation listShipmentsPage",
+			query: {
+				...parsedInput,
+				page,
+				page_size: pageSize
+			}
+		});
+		const response = parseResponse(shipstationListShipmentsResponseSchema, data, "ShipStation returned an invalid shipments page");
+		return {
+			items: response.shipments,
+			pagination: {
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
+				page_size: pageSize,
+				has_more: response.page < response.pages
+			}
+		};
+	}
+	/** One V2 GET /fulfillments request with provider pagination and filters. */
+	async listFulfillmentsPage(input = {}) {
+		const parsedInput = parseInput(shipstationListFulfillmentsPageInputSchema, input, "Invalid ShipStation fulfillments page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v2.get("/fulfillments", {
+			label: "ShipStation listFulfillmentsPage",
+			query: {
+				...parsedInput,
+				page,
+				page_size: pageSize
+			}
+		});
+		const response = parseResponse(shipstationListFulfillmentsResponseSchema, data, "ShipStation returned an invalid fulfillments page");
+		return {
+			items: response.fulfillments,
+			pagination: {
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
+				page_size: pageSize,
+				has_more: response.page < response.pages
+			}
+		};
+	}
+	/** V2 GET /carriers. */
+	async listCarriers() {
+		const { data } = await this.#v2.get("/carriers", { label: "ShipStation listCarriers" });
+		return { items: parseResponse(shipstationListCarriersResponseSchema, data, "ShipStation returned an invalid carriers response").carriers };
+	}
+	/** V2 GET /carriers/{carrier_id}. */
+	async getCarrier(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}`, { label: "ShipStation getCarrier" });
+		return parseResponse(shipstationCarrierRawSchema, data, "ShipStation returned an invalid carrier");
+	}
+	/** V2 GET /carriers/{carrier_id}/services. */
+	async listCarrierServices(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}/services`, { label: "ShipStation listCarrierServices" });
+		return { items: parseResponse(shipstationListCarrierServicesResponseSchema, data, "ShipStation returned invalid carrier services").services };
+	}
+	/** V2 GET /carriers/{carrier_id}/packages. */
+	async listCarrierPackages(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}/packages`, { label: "ShipStation listCarrierPackages" });
+		return { items: parseResponse(shipstationListCarrierPackagesResponseSchema, data, "ShipStation returned invalid carrier packages").packages };
+	}
+	/** V2 GET /carriers/{carrier_id}/options. */
+	async listCarrierOptions(input) {
+		const parsedInput = parseInput(shipstationCarrierIdInputSchema, input, "Invalid ShipStation carrier input");
+		const { data } = await this.#v2.get(`/carriers/${encodeURIComponent(parsedInput.carrier_id)}/options`, { label: "ShipStation listCarrierOptions" });
+		return { items: parseResponse(shipstationListCarrierOptionsResponseSchema, data, "ShipStation returned invalid carrier options").options };
+	}
+	/** One legacy V1 GET /orders request. */
+	async listOrdersPage(input = {}) {
+		const parsedInput = parseInput(shipstationListOrdersPageInputSchema, input, "Invalid ShipStation orders page input");
+		const page = parsedInput.page ?? 1;
+		const pageSize = parsedInput.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#v1.get("/orders", {
+			label: "ShipStation listOrdersPage",
+			query: {
+				page,
+				pageSize,
+				...parsedInput.customer_name && { customerName: parsedInput.customer_name },
+				...parsedInput.item_keyword && { itemKeyword: parsedInput.item_keyword },
+				...parsedInput.create_date_start && { createDateStart: parsedInput.create_date_start },
+				...parsedInput.create_date_end && { createDateEnd: parsedInput.create_date_end },
+				...parsedInput.modify_date_start && { modifyDateStart: parsedInput.modify_date_start },
+				...parsedInput.modify_date_end && { modifyDateEnd: parsedInput.modify_date_end },
+				...parsedInput.order_date_start && { orderDateStart: parsedInput.order_date_start },
+				...parsedInput.order_date_end && { orderDateEnd: parsedInput.order_date_end },
+				...parsedInput.order_number && { orderNumber: parsedInput.order_number },
+				...parsedInput.order_status && { orderStatus: parsedInput.order_status },
+				...parsedInput.payment_date_start && { paymentDateStart: parsedInput.payment_date_start },
+				...parsedInput.payment_date_end && { paymentDateEnd: parsedInput.payment_date_end },
+				...parsedInput.store_id !== void 0 && { storeId: parsedInput.store_id },
+				...parsedInput.sort_by && { sortBy: parsedInput.sort_by },
+				...parsedInput.sort_dir && { sortDir: parsedInput.sort_dir }
+			}
+		});
+		const response = parseResponse(shipstationListOrdersResponseSchema, data, "ShipStation returned an invalid orders page");
+		return {
+			items: response.orders,
+			pagination: {
+				total: response.total,
+				page: response.page,
+				pages: response.pages,
+				page_size: pageSize,
+				has_more: response.page < response.pages
+			}
+		};
+	}
+	/** Legacy V1 GET /stores. */
+	async listStores(input = {}) {
+		const parsedInput = parseInput(shipstationListStoresInputSchema, input, "Invalid ShipStation stores input");
+		const { data } = await this.#v1.get("/stores", {
+			label: "ShipStation listStores",
+			query: {
+				...parsedInput.show_inactive !== void 0 && { showInactive: parsedInput.show_inactive },
+				...parsedInput.marketplace_id !== void 0 && { marketplaceId: parsedInput.marketplace_id }
+			}
+		});
+		return { items: parseResponse(shipstationListStoresResponseSchema, data, "ShipStation returned an invalid stores response") };
+	}
+};
+//#endregion
+//#region src/vendors/shipstation/module.ts
+const emptyInputSchema = z.strictObject({}).describe("No input fields");
+const shipstationListLabelsTool = defineTool({
+	id: "shipstation-list-labels",
+	name: "shipstationListLabels",
+	description: "List one V2 page of ShipStation labels, including shipping and insurance cost, carrier, service, tracking, void, and refund data.",
+	inputSchema: shipstationListLabelsPageInputSchema,
+	outputSchema: shipstationListLabelsPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"labels",
+		"shipping",
+		"tracking",
+		"costs",
+		"fulfillment"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listLabelsPage(input)
+});
+const shipstationListShipmentsTool = defineTool({
+	id: "shipstation-list-shipments",
+	name: "shipstationListShipments",
+	description: "List one V2 page of ShipStation shipments. Filter by time, status, order, store, recipient, item, batch, pickup, or shipment identifiers.",
+	inputSchema: shipstationListShipmentsPageInputSchema,
+	outputSchema: shipstationListShipmentsPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"shipments",
+		"shipping",
+		"orders",
+		"fulfillment"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listShipmentsPage(input)
+});
+const shipstationListFulfillmentsTool = defineTool({
+	id: "shipstation-list-fulfillments",
+	name: "shipstationListFulfillments",
+	description: "List one V2 page of completed ShipStation fulfillments with shipment, provider, tracking, creation, and ship-date filters.",
+	inputSchema: shipstationListFulfillmentsPageInputSchema,
+	outputSchema: shipstationListFulfillmentsPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"fulfillments",
+		"shipments",
+		"tracking"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listFulfillmentsPage(input)
+});
+const shipstationListCarriersTool = defineTool({
+	id: "shipstation-list-carriers",
+	name: "shipstationListCarriers",
+	description: "List connected V2 ShipStation carrier accounts and their available shipping capabilities.",
+	inputSchema: emptyInputSchema,
+	outputSchema: shipstationListCarriersOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: ["carriers", "shipping"],
+	execute: async (_input, ctx) => ShipstationClient.fromContext(ctx).listCarriers()
+});
+const shipstationGetCarrierTool = defineTool({
+	id: "shipstation-get-carrier",
+	name: "shipstationGetCarrier",
+	description: "Get one connected V2 ShipStation carrier account and its capabilities.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationGetCarrierOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: ["carriers", "shipping"],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).getCarrier(input)
+});
+const shipstationListCarrierServicesTool = defineTool({
+	id: "shipstation-list-carrier-services",
+	name: "shipstationListCarrierServices",
+	description: "List shipping services available through one V2 ShipStation carrier account.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationListCarrierServicesOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"carriers",
+		"services",
+		"shipping"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listCarrierServices(input)
+});
+const shipstationListCarrierPackagesTool = defineTool({
+	id: "shipstation-list-carrier-packages",
+	name: "shipstationListCarrierPackages",
+	description: "List package types available through one V2 ShipStation carrier account.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationListCarrierPackagesOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"carriers",
+		"packages",
+		"shipping"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listCarrierPackages(input)
+});
+const shipstationListCarrierOptionsTool = defineTool({
+	id: "shipstation-list-carrier-options",
+	name: "shipstationListCarrierOptions",
+	description: "List advanced options available through one V2 ShipStation carrier account.",
+	inputSchema: shipstationCarrierIdInputSchema,
+	outputSchema: shipstationListCarrierOptionsOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"carriers",
+		"options",
+		"shipping"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listCarrierOptions(input)
+});
+const shipstationListOrdersTool = defineTool({
+	id: "shipstation-list-orders",
+	name: "shipstationListOrders",
+	description: "List one legacy V1 page of ShipStation sales orders. Filter by creation, modification, order, or payment time plus customer, item, number, status, or store.",
+	inputSchema: shipstationListOrdersPageInputSchema,
+	outputSchema: shipstationListOrdersPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"orders",
+		"sales",
+		"stores"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listOrdersPage(input)
+});
+const shipstationListStoresTool = defineTool({
+	id: "shipstation-list-stores",
+	name: "shipstationListStores",
+	description: "List installed legacy V1 ShipStation stores, optionally including inactive stores or one marketplace.",
+	inputSchema: shipstationListStoresInputSchema,
+	outputSchema: shipstationListStoresOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"stores",
+		"orders",
+		"marketplaces"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listStores(input)
+});
+const shipstationModule = defineModule({
+	id: "shipstation",
+	title: "ShipStation",
+	description: "Hybrid ShipStation pack: V2 shipping operations plus legacy V1 sales orders and stores.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: shipstationAuthSchema
+	},
+	categories: ["commerce", "shipping"],
+	classification: "pii",
+	tags: [
+		"labels",
+		"shipments",
+		"fulfillments",
+		"carriers",
+		"orders",
+		"stores",
+		"tracking"
+	],
+	tools: [
+		shipstationListLabelsTool,
+		shipstationListShipmentsTool,
+		shipstationListFulfillmentsTool,
+		shipstationListCarriersTool,
+		shipstationGetCarrierTool,
+		shipstationListCarrierServicesTool,
+		shipstationListCarrierPackagesTool,
+		shipstationListCarrierOptionsTool,
+		shipstationListOrdersTool,
+		shipstationListStoresTool
+	]
+});
+//#endregion
+export { ShipstationClient, shipstationAuthSchema, shipstationCarrierIdInputSchema, shipstationCarrierOptionRawSchema, shipstationCarrierPackageRawSchema, shipstationCarrierRawSchema, shipstationCarrierServiceRawSchema, shipstationFulfillmentRawSchema, shipstationGetCarrierOutputSchema, shipstationGetCarrierTool, shipstationLabelRawSchema, shipstationListCarrierOptionsOutputSchema, shipstationListCarrierOptionsResponseSchema, shipstationListCarrierOptionsTool, shipstationListCarrierPackagesOutputSchema, shipstationListCarrierPackagesResponseSchema, shipstationListCarrierPackagesTool, shipstationListCarrierServicesOutputSchema, shipstationListCarrierServicesResponseSchema, shipstationListCarrierServicesTool, shipstationListCarriersOutputSchema, shipstationListCarriersResponseSchema, shipstationListCarriersTool, shipstationListFulfillmentsPageInputSchema, shipstationListFulfillmentsPageOutputSchema, shipstationListFulfillmentsResponseSchema, shipstationListFulfillmentsTool, shipstationListLabelsPageInputSchema, shipstationListLabelsPageOutputSchema, shipstationListLabelsResponseSchema, shipstationListLabelsTool, shipstationListOrdersPageInputSchema, shipstationListOrdersPageOutputSchema, shipstationListOrdersResponseSchema, shipstationListOrdersTool, shipstationListShipmentsPageInputSchema, shipstationListShipmentsPageOutputSchema, shipstationListShipmentsResponseSchema, shipstationListShipmentsTool, shipstationListStoresInputSchema, shipstationListStoresOutputSchema, shipstationListStoresResponseSchema, shipstationListStoresTool, shipstationModule, shipstationMoneySchema, shipstationOrderRawSchema, shipstationPaginationSchema, shipstationRefundDetailsRawSchema, shipstationShipmentRawSchema, shipstationStoreRawSchema };
+
+//# sourceMappingURL=index.js.map