@aimee.shop/sdk 0.0.1

package/dist/services/core/shipping/shipping.client.js

@@ -0,0 +1,165 @@
+import { ShippingZonesClient } from './zones.client.js';
+import { ShippingRatesClient } from './rates.client.js';
+import { ShippingProvidersClient } from './providers.client.js';
+import { ShippingLabelsClient } from './labels.client.js';
+import { ShippingClassesClient } from './classes.client.js';
+import { ShippingRulesClient } from './rules.client.js';
+import { StoreShippingProvidersClient } from './store-providers.client.js';
+import { ShipperIdentityClient } from './shipper-identity.client.js';
+/**
+ * ShippingClient provides access to all shipping functionality
+ * via nested sub-clients.
+ *
+ * @example
+ * ```typescript
+ * // Calculate shipping rates
+ * const rates = await sdk.shipping.calculateRates({
+ *   destination: { address1: '123 Main St', city: 'NYC', zip: '10001', country: 'US' },
+ *   items: [{ productVariantId: 'variant-1', quantity: 2 }],
+ * });
+ *
+ * // Manage shipping zones
+ * const zones = await sdk.shipping.zones.list();
+ * await sdk.shipping.zones.create({ name: 'US Domestic', zoneType: 'domestic', countries: ['US'] });
+ *
+ * // Generate shipping labels
+ * const label = await sdk.shipping.labels.generate({ ... });
+ *
+ * // Track packages
+ * const tracking = await sdk.shipping.labels.getTrackingInfo('1Z999AA1234567890');
+ * ```
+ */
+export class ShippingClient {
+    http;
+    baseUrl;
+    // Lazy-loaded sub-clients
+    _zones;
+    _rates;
+    _providers;
+    _labels;
+    _classes;
+    _rules;
+    _storeProviders;
+    _shipperIdentity;
+    constructor(httpClient, baseUrl) {
+        this.http = httpClient;
+        this.baseUrl = baseUrl;
+    }
+    // ==================== Sub-Clients ====================
+    /**
+     * Shipping zones management
+     */
+    get zones() {
+        if (!this._zones) {
+            this._zones = new ShippingZonesClient(this.http, this.baseUrl);
+        }
+        return this._zones;
+    }
+    /**
+     * Shipping rates management
+     */
+    get rates() {
+        if (!this._rates) {
+            this._rates = new ShippingRatesClient(this.http, this.baseUrl);
+        }
+        return this._rates;
+    }
+    /**
+     * Shipping providers management
+     */
+    get providers() {
+        if (!this._providers) {
+            this._providers = new ShippingProvidersClient(this.http, this.baseUrl);
+        }
+        return this._providers;
+    }
+    /**
+     * Shipping labels management and generation
+     */
+    get labels() {
+        if (!this._labels) {
+            this._labels = new ShippingLabelsClient(this.http, this.baseUrl);
+        }
+        return this._labels;
+    }
+    /**
+     * Shipping classes for product categorization
+     */
+    get classes() {
+        if (!this._classes) {
+            this._classes = new ShippingClassesClient(this.http, this.baseUrl);
+        }
+        return this._classes;
+    }
+    /**
+     * Shipping rules for rate calculation
+     */
+    get rules() {
+        if (!this._rules) {
+            this._rules = new ShippingRulesClient(this.http, this.baseUrl);
+        }
+        return this._rules;
+    }
+    /**
+     * Per-store shipping provider enablement and settings
+     */
+    get storeProviders() {
+        if (!this._storeProviders) {
+            this._storeProviders = new StoreShippingProvidersClient(this.http, this.baseUrl);
+        }
+        return this._storeProviders;
+    }
+    /**
+     * Shipper identity management (USPS PCID compliance entity, one per store)
+     */
+    get shipperIdentity() {
+        if (!this._shipperIdentity) {
+            this._shipperIdentity = new ShipperIdentityClient(this.http, this.baseUrl);
+        }
+        return this._shipperIdentity;
+    }
+    // ==================== Main Operations ====================
+    /**
+     * Calculate shipping rates for a given destination and items
+     */
+    async calculateRates(data) {
+        return this.http.post(`${this.baseUrl}/v1/shipping/calculate`, data);
+    }
+    /**
+     * Validate and potentially correct a shipping address
+     */
+    async validateAddress(address) {
+        return this.http.post(`${this.baseUrl}/v1/shipping/validate-address`, address);
+    }
+    /**
+     * Look up which shipping zones apply for a given address
+     */
+    async lookupZones(params) {
+        const queryParams = { country: params.country };
+        if (params.postalCode)
+            queryParams.postalCode = params.postalCode;
+        if (params.state)
+            queryParams.state = params.state;
+        return this.http.get(`${this.baseUrl}/v1/shipping/zone-lookup`, {
+            params: queryParams,
+        });
+    }
+    /**
+     * Get cached shipping rates by calculation hash
+     */
+    async getCachedRates(hash) {
+        try {
+            return await this.http.get(`${this.baseUrl}/v1/shipping/cache/rates/${hash}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Cache shipping rates for future use
+     */
+    async cacheRates(hash, rates) {
+        await this.http.post(`${this.baseUrl}/v1/shipping/cache/rates`, { hash, rates });
+    }
+}
+//# sourceMappingURL=shipping.client.js.map

package/dist/services/core/shipping/shipping.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/shipping/shipping.client.ts"],"names":[],"mappings":"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"}

package/dist/services/core/shipping/store-providers.client.d.ts

@@ -0,0 +1,48 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import type { StoreShippingProviderList, StoreShippingProviderWithProvider, EnableStoreShippingProviderDto, UpdateStoreShippingProviderDto } from './types.js';
+/**
+ * Manages per-store enablement of tenant-level shipping providers.
+ *
+ * All endpoints require both tenant and store context (`setTenant` + `setStore`).
+ *
+ * @example
+ * ```typescript
+ * sdk.setTenant('tenant-uuid');
+ * sdk.setStore('store-uuid');
+ *
+ * // List all providers with per-store enabled status
+ * const { data } = await sdk.shipping.storeProviders.list();
+ *
+ * // Enable a provider for this store
+ * await sdk.shipping.storeProviders.enable(providerId, { sortOrder: 0 });
+ *
+ * // List only enabled providers
+ * const { data: enabled } = await sdk.shipping.storeProviders.listEnabled();
+ * ```
+ */
+export declare class StoreShippingProvidersClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * List all tenant providers with per-store enablement status
+     */
+    list(): Promise<StoreShippingProviderList>;
+    /**
+     * List only enabled providers for this store
+     */
+    listEnabled(): Promise<StoreShippingProviderList>;
+    /**
+     * Enable a tenant-level provider for this store
+     */
+    enable(providerId: string, data?: EnableStoreShippingProviderDto): Promise<StoreShippingProviderWithProvider>;
+    /**
+     * Disable a provider for this store
+     */
+    disable(providerId: string): Promise<void>;
+    /**
+     * Update store-provider settings (sort order, markup, handling fee, display name)
+     */
+    updateSettings(providerId: string, data: UpdateStoreShippingProviderDto): Promise<StoreShippingProviderWithProvider>;
+}
+//# sourceMappingURL=store-providers.client.d.ts.map

package/dist/services/core/shipping/store-providers.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-providers.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/shipping/store-providers.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EACjC,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAIhD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAMvD;;OAEG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,8BAA8B,GACpC,OAAO,CAAC,iCAAiC,CAAC;IAO7C;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,iCAAiC,CAAC;CAM9C"}

package/dist/services/core/shipping/store-providers.client.js

@@ -0,0 +1,59 @@
+/**
+ * Manages per-store enablement of tenant-level shipping providers.
+ *
+ * All endpoints require both tenant and store context (`setTenant` + `setStore`).
+ *
+ * @example
+ * ```typescript
+ * sdk.setTenant('tenant-uuid');
+ * sdk.setStore('store-uuid');
+ *
+ * // List all providers with per-store enabled status
+ * const { data } = await sdk.shipping.storeProviders.list();
+ *
+ * // Enable a provider for this store
+ * await sdk.shipping.storeProviders.enable(providerId, { sortOrder: 0 });
+ *
+ * // List only enabled providers
+ * const { data: enabled } = await sdk.shipping.storeProviders.listEnabled();
+ * ```
+ */
+export class StoreShippingProvidersClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List all tenant providers with per-store enablement status
+     */
+    async list() {
+        return this.http.get(`${this.baseUrl}/v1/shipping/store-providers`);
+    }
+    /**
+     * List only enabled providers for this store
+     */
+    async listEnabled() {
+        return this.http.get(`${this.baseUrl}/v1/shipping/store-providers/enabled`);
+    }
+    /**
+     * Enable a tenant-level provider for this store
+     */
+    async enable(providerId, data) {
+        return this.http.post(`${this.baseUrl}/v1/shipping/store-providers/${providerId}/enable`, data ?? {});
+    }
+    /**
+     * Disable a provider for this store
+     */
+    async disable(providerId) {
+        await this.http.delete(`${this.baseUrl}/v1/shipping/store-providers/${providerId}/disable`);
+    }
+    /**
+     * Update store-provider settings (sort order, markup, handling fee, display name)
+     */
+    async updateSettings(providerId, data) {
+        return this.http.patch(`${this.baseUrl}/v1/shipping/store-providers/${providerId}/settings`, data);
+    }
+}
+//# sourceMappingURL=store-providers.client.js.map

package/dist/services/core/shipping/store-providers.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-providers.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/shipping/store-providers.client.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,4BAA4B;IAEpB;IACA;IAFnB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA4B,GAAG,IAAI,CAAC,OAAO,8BAA8B,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,OAAO,sCAAsC,CACtD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,UAAkB,EAClB,IAAqC;QAErC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,gCAAgC,UAAU,SAAS,EAClE,IAAI,IAAI,EAAE,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,gCAAgC,UAAU,UAAU,CAAC,CAAC;IAC9F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,IAAoC;QAEpC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CACpB,GAAG,IAAI,CAAC,OAAO,gCAAgC,UAAU,WAAW,EACpE,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}