@stacksjs/commerce 0.72.103 → 0.73.0

package/dist/carts/destroy.d.ts

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

package/dist/carts/fetch.d.ts

@@ -0,0 +1,10 @@
+import type { Cart, ModelRow } from '@stacksjs/orm';
+/**
+ * Fetch a cart by ID
+ */
+export declare function fetchById(id: number): Promise<CartJsonResponse | undefined>;
+/**
+ * Fetch all carts
+ */
+export declare function fetchAll(): Promise<CartJsonResponse[]>;
+declare type CartJsonResponse = ModelRow<typeof Cart>;

package/dist/carts/index.d.ts

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

package/dist/carts/store.d.ts

@@ -0,0 +1,17 @@
+import type { Cart, ModelRow, NewModelData } from '@stacksjs/orm';
+/**
+ * Create a new cart
+ *
+ * @param data Cart data to store
+ * @returns The newly created cart record
+ */
+export declare function store(data: NewCart): Promise<CartJsonResponse>;
+/**
+ * Create multiple carts at once
+ *
+ * @param data Array of cart data to store
+ * @returns Number of carts created
+ */
+export declare function bulkStore(data: NewCart[]): Promise<number>;
+declare type CartJsonResponse = ModelRow<typeof Cart>;
+declare type NewCart = NewModelData<typeof Cart>;

package/dist/carts/update.d.ts

@@ -0,0 +1,18 @@
+import type { Cart, ModelRow, UpdateModelData } from '@stacksjs/orm';
+/**
+ * Update a cart
+ *
+ * @param id The ID of the cart to update
+ * @param data The cart data to update
+ * @returns The updated cart record
+ */
+export declare function update(id: number, data: Omit<CartUpdate, 'id'>): Promise<CartJsonResponse>;
+/**
+ * Update multiple carts at once
+ *
+ * @param data Array of objects containing cart ID and update data
+ * @returns Number of carts updated
+ */
+export declare function bulkUpdate(data: CartUpdate[]): Promise<number>;
+declare type CartJsonResponse = ModelRow<typeof Cart>;
+declare type CartUpdate = UpdateModelData<typeof Cart>;

package/dist/gift-cards/index.d.ts

@@ -1,6 +1,8 @@
 export {
   bulkDestroy,
+  deactivate,
   destroy,
+  destroyExpired,
 } from './destroy';
 export {
   calculateGiftCardValues,

package/dist/gift-cards/update.d.ts

@@ -10,7 +10,7 @@ export declare function update(id: number, data: Omit<GiftCardUpdate, 'id'>): Pr
 /**
  * Update a gift card's balance atomically (stacksjs/stacks#1879 Co-8).
  *
- * Pre-fix: read balance → compute new → write. Two parallel $50
+ * Pre-fix: read balance -> compute new -> write. Two parallel $50
  * redemptions of a $100 card both saw `current_balance = 100`,
  * both wrote `50`, leaving `50` instead of `0`. The post-read
  * negative-balance guard only caught single-threaded misuse.
@@ -19,8 +19,14 @@ export declare function update(id: number, data: Omit<GiftCardUpdate, 'id'>): Pr
  * enforces every precondition in the WHERE clause. The database
  * guarantees only one writer wins the race. Throws when the row
  * was found but the precondition failed (insufficient balance,
- * inactive, missing) so the caller can distinguish from a
- * not-found row.
+ * inactive, expired, not reloadable) so the caller can distinguish
+ * from a not-found row.
+ *
+ * A negative `amount` is a redemption and a positive one a reload.
+ * The two are not symmetric, so the statement is shaped per direction:
+ * only a redemption stamps `last_used_date`, and only a reload may
+ * touch a card already spent down to `USED` (and then only when the
+ * card is `is_reloadable`, which is otherwise a field nothing honours).
  *
  * @param id The ID of the gift card
  * @param amount The amount to adjust (positive to add, negative to deduct)

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import * as auctions from './auctions/index';
+import * as carts from './carts/index';
 import * as coupons from './coupons/index';
 import * as customers from './customers/index';
 import * as devices from './devices/index';
@@ -15,6 +16,7 @@ import * as waitlists from './waitlists/index';
 export declare const commerce: CommerceNamespace;
 export declare interface CommerceNamespace {
   auctions: AuctionsModule
+  carts: CartsModule
   coupons: CouponsModule
   customers: CustomersModule
   errors: ErrorsModule
@@ -30,6 +32,7 @@ export declare interface CommerceNamespace {
   receipts: ReceiptsModule
 }
 declare type AuctionsModule = typeof auctions;
+declare type CartsModule = typeof carts;
 declare type CouponsModule = typeof coupons;
 declare type CustomersModule = typeof customers;
 declare type ErrorsModule = typeof errors;
@@ -45,6 +48,7 @@ declare type DevicesModule = typeof devices;
 declare type ReceiptsModule = typeof receipts;
 export {
   auctions,
+  carts,
   coupons,
   customers,
   devices,