@stacksjs/commerce 0.70.37 → 0.70.42

package/dist/src/products/items/update.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Update a product item
+ *
+ * @param id The ID of the product item to update
+ * @param data The product item data to update
+ * @returns The updated product item record
+ */
+export declare function update(id: number, data: Omit<ProductUpdate, 'id'>): Promise<ProductJsonResponse>;
+/**
+ * Update multiple product items at once
+ *
+ * @param data Array of product item updates
+ * @returns Number of product items updated
+ */
+export declare function bulkUpdate(data: ProductUpdate[]): Promise<number>;
+/**
+ * Update a product item's availability status
+ *
+ * @param id The ID of the product item
+ * @param isAvailable The new availability status
+ * @returns The updated product item with the new availability status
+ */
+export declare function updateAvailability(id: number, isAvailable: boolean): Promise<ProductJsonResponse | undefined>;
+/**
+ * Atomically decrement (or increment) a product's inventory count by `delta`.
+ *
+ * Returns the updated row, or `null` if the requested decrement would push
+ * inventory below zero — that's how callers detect "we sold the last one"
+ * during checkout. The conditional UPDATE means two parallel checkout
+ * requests can't both observe stock=1 and both succeed; the second one
+ * matches zero rows and the function returns null. Existing
+ * `updateInventory(id, count)` keeps the previous "set absolute count"
+ * semantics for admin tooling.
+ */
+export declare function adjustInventory(id: number, delta: number): Promise<ProductJsonResponse | null>;
+/**
+ * Update inventory information for a product item
+ *
+ * @param id The ID of the product item
+ * @param inventoryCount The updated inventory count
+ * @returns The updated product item
+ */
+export declare function updateInventory(id: number, inventoryCount?: number): Promise<ProductJsonResponse | undefined>;
+declare type ProductJsonResponse = ModelRow<typeof Product>;
+declare type ProductUpdate = UpdateModelData<typeof Product>;

package/dist/src/products/manufacturers/destroy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delete an order by ID
+ *
+ * @param id The ID of the order to delete
+ * @returns True if the order was deleted, false otherwise
+ */
+export declare function destroy(id: number): Promise<boolean>;
+/**
+ * Delete multiple orders by ID
+ *
+ * @param ids Array of order IDs to delete
+ * @returns Number of orders deleted
+ */
+export declare function bulkDestroy(ids: number[]): Promise<number>;

package/dist/src/products/manufacturers/fetch.d.ts

@@ -0,0 +1,23 @@
+import type { FetchManufacturersOptions, ManufacturerResponse } from '../../types';
+export declare function fetchAll(): Promise<ManufacturerJsonResponse[]>;
+/**
+ * Fetch a product manufacturer by ID
+ */
+export declare function fetchById(id: number): Promise<ManufacturerJsonResponse | undefined>;
+/**
+ * Fetch a product manufacturer by UUID
+ */
+export declare function fetchByUuid(uuid: string): Promise<ManufacturerJsonResponse | undefined>;
+/**
+ * Fetch featured manufacturers
+ */
+export declare function fetchFeatured(limit?: number): Promise<ManufacturerJsonResponse[]>;
+/**
+ * Fetch manufacturers by country
+ */
+export declare function fetchByCountry(country: string, options?: FetchManufacturersOptions): Promise<ManufacturerResponse>;
+/**
+ * Fetch manufacturers with their product count
+ */
+export declare function fetchWithProductCount(options?: FetchManufacturersOptions): Promise<ManufacturerJsonResponse[]>;
+declare type ManufacturerJsonResponse = ModelRow<typeof Manufacturer>;

package/dist/src/products/manufacturers/index.d.ts

@@ -0,0 +1,21 @@
+export {
+  bulkDestroy,
+  destroy,
+} from './destroy';
+export {
+  fetchAll,
+  fetchByCountry,
+  fetchById,
+  fetchByUuid,
+  fetchFeatured,
+  fetchWithProductCount,
+} from './fetch';
+export {
+  bulkStore,
+  store,
+} from './store';
+export {
+  update,
+  updateByUuid,
+  updateFeaturedStatus,
+} from './update';

package/dist/src/products/manufacturers/store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Create a new product manufacturer
+ *
+ * @param data The manufacturer data to store
+ * @returns The newly created manufacturer record
+ */
+export declare function store(data: NewManufacturer): Promise<ManufacturerJsonResponse>;
+/**
+ * Create multiple manufacturers at once
+ *
+ * @param data Array of manufacturer data to store
+ * @returns Number of manufacturers created
+ */
+export declare function bulkStore(data: NewManufacturer[]): Promise<number>;
+declare type ManufacturerJsonResponse = ModelRow<typeof Manufacturer>;
+declare type NewManufacturer = NewModelData<typeof Manufacturer>;

package/dist/src/products/manufacturers/update.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Update a manufacturer
+ *
+ * @param id The ID of the manufacturer to update
+ * @param data The manufacturer data to update
+ * @returns The updated manufacturer record
+ */
+export declare function update(id: number, data: ManufacturerUpdate): Promise<ManufacturerJsonResponse>;
+/**
+ * Toggle the featured status of a manufacturer
+ *
+ * @param id The ID of the manufacturer
+ * @param featured The new featured status (or toggle if not provided)
+ * @returns The updated manufacturer with the new featured status
+ */
+export declare function updateFeaturedStatus(id: number, featured?: boolean): Promise<ManufacturerJsonResponse>;
+/**
+ * Update a manufacturer by UUID
+ *
+ * @param uuid The UUID of the manufacturer to update
+ * @param data The updated manufacturer data
+ * @returns The updated manufacturer record
+ */
+export declare function updateByUuid(uuid: string, data: Omit<ManufacturerUpdate, 'id'>): Promise<ManufacturerJsonResponse>;
+declare type ManufacturerJsonResponse = ModelRow<typeof Manufacturer>;
+declare type ManufacturerUpdate = UpdateModelData<typeof Manufacturer>;

package/dist/src/products/reviews/destroy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delete an order by ID
+ *
+ * @param id The ID of the order to delete
+ * @returns True if the order was deleted, false otherwise
+ */
+export declare function destroy(id: number): Promise<boolean>;
+/**
+ * Delete multiple orders by ID
+ *
+ * @param ids Array of order IDs to delete
+ * @returns Number of orders deleted
+ */
+export declare function bulkDestroy(ids: number[]): Promise<number>;

package/dist/src/products/reviews/fetch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fetch a product review by ID
+ */
+export declare function fetchById(id: number): Promise<ReviewJsonResponse | undefined>;
+/**
+ * Fetch all product reviews
+ */
+export declare function fetchAll(): Promise<ReviewJsonResponse[]>;
+/**
+ * Fetch reviews for a specific product
+ */
+export declare function fetchByProductId(productId: number): Promise<ReviewJsonResponse[]>;
+/**
+ * Fetch reviews by user ID
+ */
+export declare function fetchByUserId(userId: number): Promise<ReviewJsonResponse[]>;
+/**
+ * Fetch approved reviews for a product
+ */
+export declare function fetchApprovedByProductId(productId: number): Promise<ReviewJsonResponse[]>;
+export declare function fetchMostHelpfulByProductId(productId: number): Promise<ReviewJsonResponse[]>;
+declare type ReviewJsonResponse = ModelRow<typeof Review>;

package/dist/src/products/reviews/index.d.ts

@@ -0,0 +1,22 @@
+export {
+  bulkDestroy,
+  destroy,
+} from './destroy';
+// Functions from fetch.ts
+export {
+  fetchAll,
+  fetchApprovedByProductId,
+  fetchById,
+  fetchByProductId,
+  fetchByUserId,
+  fetchMostHelpfulByProductId,
+} from './fetch';
+// Functions from store.ts
+export {
+  store,
+} from './store';
+// Functions from update.ts
+export {
+  update,
+  updateVotes,
+} from './update';

package/dist/src/products/reviews/store.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Create a new product review
+ *
+ * @param data The review data to store
+ * @returns The newly created review record
+ */
+export declare function store(data: NewReview): Promise<ReviewJsonResponse>;
+declare type ReviewJsonResponse = ModelRow<typeof Review>;
+declare type NewReview = NewModelData<typeof Review>;

package/dist/src/products/reviews/update.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Update a review
+ *
+ * @param id The id of the review to update
+ * @param data The review data to update
+ * @returns The updated review record
+ */
+export declare function update(id: number, data: ReviewUpdate): Promise<ReviewJsonResponse>;
+/**
+ * Update a review's vote counts
+ *
+ * @param id The ID of the review
+ * @param voteType The type of vote ('helpful' or 'unhelpful')
+ * @param increment Whether to increment (true) or decrement (false) the vote count
+ * @returns The updated review with new vote counts
+ */
+export declare function updateVotes(id: number, voteType: 'helpful' | 'unhelpful', increment?: boolean): Promise<ReviewJsonResponse>;
+declare type ReviewJsonResponse = ModelRow<typeof Review>;
+declare type ReviewUpdate = UpdateModelData<typeof Review>;

package/dist/src/products/units/destroy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delete a product unit by ID
+ *
+ * @param id The ID of the product unit to delete
+ * @returns True if the product unit was deleted, false otherwise
+ */
+export declare function destroy(id: number): Promise<boolean>;
+/**
+ * Delete multiple product units by ID
+ *
+ * @param ids Array of product unit IDs to delete
+ * @returns Number of product units deleted
+ */
+export declare function bulkDestroy(ids: number[]): Promise<number>;

package/dist/src/products/units/fetch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fetch a product unit by ID
+ */
+export declare function fetchById(id: number): Promise<ProductUnitJsonResponse | undefined>;
+/**
+ * Fetch all product units
+ */
+export declare function fetchAll(): Promise<ProductUnitJsonResponse[]>;
+declare type ProductUnitJsonResponse = ModelRow<typeof ProductUnit>;

package/dist/src/products/units/index.d.ts

@@ -0,0 +1,9 @@
+// Export all functions from the unit modules
+// Destroy functions
+export { bulkDestroy, destroy } from './destroy';
+// Fetch functions
+export { fetchAll, fetchById } from './fetch';
+// Store functions
+export { bulkStore, formatUnitOptions, getDefaultUnit, store } from './store';
+// Update functions
+export { bulkUpdate, update, updateDefaultStatus } from './update';

package/dist/src/products/units/store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Create a new product unit
+ *
+ * @param data The product unit data to store
+ * @returns The newly created product unit record
+ */
+export declare function store(data: NewProductUnit): Promise<ProductUnitJsonResponse>;
+/**
+ * Create multiple product units at once
+ *
+ * @param data Array of product unit data to store
+ * @returns Number of product units created
+ */
+export declare function bulkStore(data: NewProductUnit[]): Promise<number>;
+/**
+ * Format product unit options for dropdown menus or selectors
+ *
+ * @param type Optional filter by unit type
+ * @returns Array of formatted unit options with id, name, and abbreviation
+ */
+export declare function formatUnitOptions(type?: string): Promise<{ id: string, name: string, abbreviation: string, is_default: boolean | undefined }[] | []>;
+/**
+ * Get the default unit for a specific type
+ *
+ * @param type The unit type to get the default for
+ * @returns The default unit or undefined if none found
+ */
+export declare function getDefaultUnit(type: string): Promise<ProductUnitJsonResponse | undefined>;
+// Import dependencies
+declare type ProductUnitJsonResponse = ModelRow<typeof ProductUnit>;
+declare type NewProductUnit = NewModelData<typeof ProductUnit>;

package/dist/src/products/units/update.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Update a product unit
+ *
+ * @param id The ID of the product unit
+ * @param data The product unit data to update
+ * @returns The updated product unit record
+ */
+export declare function update(id: number, data: ProductUnitUpdate): Promise<ProductUnitJsonResponse>;
+/**
+ * Update multiple product units at once
+ *
+ * @param data Array of product unit updates
+ * @returns Number of product units updated
+ */
+export declare function bulkUpdate(data: ProductUnitUpdate[]): Promise<number>;
+/**
+ * Update the default status of a product unit
+ *
+ * @param id The ID of the product unit
+ * @param isDefault The new default status value
+ * @returns True if the status was updated successfully
+ */
+export declare function updateDefaultStatus(id: number, isDefault: boolean): Promise<boolean>;
+declare type ProductUnitJsonResponse = ModelRow<typeof ProductUnit>;
+declare type ProductUnitUpdate = UpdateModelData<typeof ProductUnit>;

package/dist/src/products/variants/destroy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delete a product variant by ID
+ *
+ * @param id The ID of the product variant to delete
+ * @returns True if the product variant was deleted, false otherwise
+ */
+export declare function destroy(id: number): Promise<boolean>;
+/**
+ * Delete multiple product variants by ID
+ *
+ * @param ids Array of product variant IDs to delete
+ * @returns Number of product variants deleted
+ */
+export declare function bulkDestroy(ids: number[]): Promise<number>;

package/dist/src/products/variants/fetch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fetch a product variant by ID
+ */
+export declare function fetchById(id: number): Promise<ProductVariantJsonResponse | undefined>;
+/**
+ * Fetch all product variants
+ */
+export declare function fetchAll(): Promise<ProductVariantJsonResponse[]>;
+declare type ProductVariantJsonResponse = ModelRow<typeof ProductVariant>;

package/dist/src/products/variants/index.d.ts

@@ -0,0 +1,18 @@
+export {
+  bulkDestroy,
+  destroy,
+} from './destroy';
+export {
+  fetchAll,
+  fetchById,
+} from './fetch';
+export {
+  bulkStore,
+  formatVariantOptions,
+  generateVariantCombinations,
+  store,
+} from './store';
+export {
+  bulkUpdate,
+  update,
+} from './update';

package/dist/src/products/variants/store.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Create a new product variant
+ *
+ * @param data The product variant data to store
+ * @returns The newly created product variant record
+ */
+export declare function store(data: NewProductVariant): Promise<ProductVariantJsonResponse>;
+/**
+ * Create multiple product variants at once
+ *
+ * @param data Array of product variant data to store
+ * @returns Number of product variants created
+ */
+export declare function bulkStore(data: NewProductVariant[]): Promise<number>;
+/**
+ * Generate product variant options from raw input
+ *
+ * @param rawOptions String array of options
+ * @returns Formatted JSON string of options
+ */
+export declare function formatVariantOptions(rawOptions: string[]): string;
+/**
+ * Create a set of common variant combinations from different option types
+ *
+ * @param optionSets Object containing option types and their values
+ * @returns Array of variant combinations
+ *
+ * @example
+ * // Generate combinations for a t-shirt product
+ * const options = {
+ *   size: ['S', 'M', 'L'],
+ *   color: ['Red', 'Blue']
+ * }
+ * // Returns: [
+ * //   { size: 'S', color: 'Red' },
+ * //   { size: 'S', color: 'Blue' },
+ * //   { size: 'M', color: 'Red' },
+ * //   ...
+ * // ]
+ */
+export declare function generateVariantCombinations(optionSets: Record<string, string[]>): Record<string, string>[];
+declare type ProductVariantJsonResponse = ModelRow<typeof ProductVariant>;
+declare type NewProductVariant = NewModelData<typeof ProductVariant>;

package/dist/src/products/variants/update.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Update a product variant
+ *
+ * @param id The ID of the product variant to update
+ * @param data The product variant data to update
+ * @returns The updated product variant record
+ */
+export declare function update(id: number, data: Omit<ProductVariantUpdate, 'id'>): Promise<ProductVariantJsonResponse>;
+/**
+ * Update multiple product variants at once
+ *
+ * @param data Array of objects containing variant ID and update data
+ * @returns Number of product variants updated
+ */
+export declare function bulkUpdate(data: ProductVariantUpdate[]): Promise<number>;
+/**
+ * Update the status of a product variant
+ *
+ * @param id The ID of the product variant
+ * @param status The new status value
+ * @returns True if the status was updated successfully
+ */
+export declare function updateStatus(id: number, status: string): Promise<boolean>;
+declare type ProductVariantJsonResponse = ModelRow<typeof ProductVariant>;
+declare type ProductVariantUpdate = UpdateModelData<typeof ProductVariant>;

package/dist/src/receipts/destroy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delete a print log by ID
+ *
+ * @param id The ID of the print log to delete
+ * @returns True if the print log was deleted, false otherwise
+ */
+export declare function destroy(id: number): Promise<boolean>;
+/**
+ * Delete multiple print logs by ID
+ *
+ * @param ids Array of print log IDs to delete
+ * @returns Number of print logs deleted
+ */
+export declare function bulkDestroy(ids: number[]): Promise<number>;

package/dist/src/receipts/fetch.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Fetch a print log by ID
+ */
+export declare function fetchById(id: number): Promise<ReceiptJsonResponse | undefined>;
+/**
+ * Fetch all print logs
+ */
+export declare function fetchAll(): Promise<ReceiptJsonResponse[]>;
+/**
+ * Fetch print job statistics by status within a date range
+ *
+ * @param startDate Start date for the range
+ * @param endDate End date for the range
+ * @returns Object containing counts for each status and total
+ */
+export declare function fetchPrintJobStats(_startDate: Date | number, _endDate: Date | number): Promise<{
+    total: number
+    success: number
+    failed: number
+    warning: number
+    averageSize: number
+    averagePages: number
+    averageDuration: number
+  }>;
+/**
+ * Calculate the success rate percentage for print jobs within a date range
+ *
+ * @param startDate Start date for the range
+ * @param endDate End date for the range
+ * @returns Object containing success rate percentage and detailed counts
+ */
+export declare function fetchSuccessRate(_startDate: Date | number, _endDate: Date | number): Promise<{
+    successRate: number
+    total: number
+    success: number
+    failed: number
+    warning: number
+  }>;
+/**
+ * Calculate total pages and average pages per receipt within a date range
+ *
+ * @param startDate Start date for the range
+ * @param endDate End date for the range
+ * @returns Object containing total pages and average pages per receipt
+ */
+export declare function fetchPageStats(_startDate: Date | number, _endDate: Date | number): Promise<{
+    totalPages: number
+    averagePagesPerReceipt: number
+    totalReceipts: number
+  }>;
+/**
+ * Calculate average print time statistics within a date range
+ *
+ * @param startDate Start date for the range
+ * @param endDate End date for the range
+ * @returns Object containing average print time and related statistics
+ */
+export declare function fetchPrintTimeStats(_startDate: Date | number, _endDate: Date | number): Promise<{
+    averageDuration: number
+    minDuration: number
+    maxDuration: number
+    totalJobs: number
+  }>;
+/**
+ * Calculate prints per hour statistics within a date range
+ *
+ * @param startDate Start date for the range
+ * @param endDate End date for the range
+ * @returns Object containing prints per hour statistics
+ */
+export declare function fetchPrintsPerHour(_startDate: Date | number, _endDate: Date | number): Promise<{
+    totalPrints: number
+    totalHours: number
+    printsPerHour: number
+    hourlyBreakdown: Array<{
+      hour: number
+      count: number
+    }>
+  }>;
+declare type ReceiptJsonResponse = ModelRow<typeof Receipt>;

package/dist/src/receipts/index.d.ts

@@ -0,0 +1,21 @@
+// Functions from destroy.ts
+export {
+  bulkDestroy,
+  destroy,
+} from './destroy';
+// Functions from fetch.ts
+export {
+  fetchAll,
+  fetchById,
+} from './fetch';
+// Functions from store.ts
+export {
+  bulkStore,
+  store,
+} from './store';
+// Functions from update.ts
+export {
+  update,
+  updatePrintJob,
+  updateStatus,
+} from './update';

package/dist/src/receipts/store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Create a new receipt
+ *
+ * @param data The receipt data to store
+ * @returns The newly created receipt record
+ */
+export declare function store(data: NewReceipt): Promise<ReceiptJsonResponse>;
+/**
+ * Create multiple receipts at once
+ *
+ * @param data Array of receipt data to store
+ * @returns Number of receipts created
+ */
+export declare function bulkStore(data: NewReceipt[]): Promise<number>;
+declare type ReceiptJsonResponse = ModelRow<typeof Receipt>;
+declare type NewReceipt = NewModelData<typeof Receipt>;

package/dist/src/receipts/update.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Update a receipt
+ *
+ * @param id The id of the receipt to update
+ * @param data The receipt data to update
+ * @returns The updated receipt record
+ */
+export declare function update(id: number, data: ReceiptUpdate): Promise<ReceiptJsonResponse>;
+/**
+ * Update a receipt's status
+ *
+ * @param id The ID of the receipt
+ * @param status The new status
+ * @returns The updated receipt with the new status
+ */
+export declare function updateStatus(id: number, status: 'success' | 'failed' | 'warning'): Promise<ReceiptJsonResponse>;
+/**
+ * Update print job information
+ *
+ * @param id The ID of the receipt
+ * @param size Optional new size value
+ * @param pages Optional new pages value
+ * @param duration Optional new duration value
+ * @returns The updated receipt
+ */
+export declare function updatePrintJob(id: number, size?: number, pages?: number, duration?: number): Promise<ReceiptJsonResponse>;
+declare type ReceiptJsonResponse = ModelRow<typeof Receipt>;
+declare type ReceiptUpdate = UpdateModelData<typeof Receipt>;

package/dist/src/shippings/delivery-routes/destroy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Delete a delivery route by ID
+ *
+ * @param id The ID of the delivery route to delete
+ * @returns True if the delivery route was deleted, false otherwise
+ */
+export declare function destroy(id: number): Promise<boolean>;
+/**
+ * Delete multiple delivery routes by ID
+ *
+ * @param ids Array of delivery route IDs to delete
+ * @returns Number of delivery routes deleted
+ */
+export declare function bulkDestroy(ids: number[]): Promise<number>;

package/dist/src/shippings/delivery-routes/fetch.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Fetch a delivery route by ID
+ */
+export declare function fetchById(id: number): Promise<DeliveryRouteJsonResponse | undefined>;
+/**
+ * Fetch all delivery routes
+ */
+export declare function fetchAll(): Promise<DeliveryRouteJsonResponse[]>;
+/**
+ * Fetch active delivery routes
+ */
+export declare function fetchActive(): Promise<DeliveryRouteJsonResponse[]>;
+/**
+ * Fetch delivery routes by driver
+ */
+export declare function fetchByDriver(driver: string): Promise<DeliveryRouteJsonResponse[]>;
+declare type DeliveryRouteJsonResponse = ModelRow<typeof DeliveryRoute>;