@01.software/sdk 0.27.0 → 0.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +125 -1
  2. package/dist/analytics/react.cjs.map +1 -1
  3. package/dist/analytics/react.js.map +1 -1
  4. package/dist/analytics.cjs.map +1 -1
  5. package/dist/analytics.js.map +1 -1
  6. package/dist/{const-D-xucnw4.d.ts → const-Cz9Ki_I7.d.cts} +4 -4
  7. package/dist/{const-C0GlmeJ_.d.cts → const-mdQQtIOz.d.ts} +4 -4
  8. package/dist/index.cjs +84 -7
  9. package/dist/index.cjs.map +1 -1
  10. package/dist/index.d.cts +19 -8
  11. package/dist/index.d.ts +19 -8
  12. package/dist/index.js +84 -7
  13. package/dist/index.js.map +1 -1
  14. package/dist/{payload-types-BPvUmPAq.d.cts → payload-types-BrSYb-sh.d.cts} +145 -70
  15. package/dist/{payload-types-BPvUmPAq.d.ts → payload-types-BrSYb-sh.d.ts} +145 -70
  16. package/dist/realtime.cjs.map +1 -1
  17. package/dist/realtime.d.cts +2 -2
  18. package/dist/realtime.d.ts +2 -2
  19. package/dist/realtime.js.map +1 -1
  20. package/dist/{server-_zvihptw.d.ts → server-C2Q9R-Lu.d.ts} +228 -9
  21. package/dist/{server-n3xK4Nks.d.cts → server-D369bCVJ.d.cts} +228 -9
  22. package/dist/server.cjs +71 -4
  23. package/dist/server.cjs.map +1 -1
  24. package/dist/server.d.cts +4 -4
  25. package/dist/server.d.ts +4 -4
  26. package/dist/server.js +71 -4
  27. package/dist/server.js.map +1 -1
  28. package/dist/{types-BLdthWiW.d.ts → types-BLUb4cYq.d.ts} +1 -1
  29. package/dist/{types-DzWNu9pw.d.cts → types-CW4PaIL7.d.cts} +1 -1
  30. package/dist/ui/canvas/server.cjs.map +1 -1
  31. package/dist/ui/canvas/server.js.map +1 -1
  32. package/dist/ui/canvas.cjs.map +1 -1
  33. package/dist/ui/canvas.js.map +1 -1
  34. package/dist/ui/form.d.cts +1 -1
  35. package/dist/ui/form.d.ts +1 -1
  36. package/dist/ui/video.d.cts +1 -1
  37. package/dist/ui/video.d.ts +1 -1
  38. package/dist/webhook.d.cts +3 -3
  39. package/dist/webhook.d.ts +3 -3
  40. package/package.json +3 -3
@@ -47,11 +47,13 @@ interface Config {
47
47
  'order-items': OrderItem;
48
48
  transactions: Transaction;
49
49
  'order-status-logs': OrderStatusLog;
50
+ 'inventory-reservations': InventoryReservation;
50
51
  fulfillments: Fulfillment;
51
52
  'fulfillment-items': FulfillmentItem;
52
53
  returns: Return;
53
54
  'return-items': ReturnItem;
54
55
  'shipping-policies': ShippingPolicy;
56
+ 'shipping-zones': ShippingZone;
55
57
  customers: Customer;
56
58
  'customer-profiles': CustomerProfile;
57
59
  'customer-profile-lists': CustomerProfileList;
@@ -60,7 +62,6 @@ interface Config {
60
62
  carts: Cart;
61
63
  'cart-items': CartItem;
62
64
  discounts: Discount;
63
- promotions: Promotion;
64
65
  articles: Article;
65
66
  'article-authors': ArticleAuthor;
66
67
  'article-categories': ArticleCategory;
@@ -209,11 +210,13 @@ interface Config {
209
210
  'order-items': OrderItemsSelect<false> | OrderItemsSelect<true>;
210
211
  transactions: TransactionsSelect<false> | TransactionsSelect<true>;
211
212
  'order-status-logs': OrderStatusLogsSelect<false> | OrderStatusLogsSelect<true>;
213
+ 'inventory-reservations': InventoryReservationsSelect<false> | InventoryReservationsSelect<true>;
212
214
  fulfillments: FulfillmentsSelect<false> | FulfillmentsSelect<true>;
213
215
  'fulfillment-items': FulfillmentItemsSelect<false> | FulfillmentItemsSelect<true>;
214
216
  returns: ReturnsSelect<false> | ReturnsSelect<true>;
215
217
  'return-items': ReturnItemsSelect<false> | ReturnItemsSelect<true>;
216
218
  'shipping-policies': ShippingPoliciesSelect<false> | ShippingPoliciesSelect<true>;
219
+ 'shipping-zones': ShippingZonesSelect<false> | ShippingZonesSelect<true>;
217
220
  customers: CustomersSelect<false> | CustomersSelect<true>;
218
221
  'customer-profiles': CustomerProfilesSelect<false> | CustomerProfilesSelect<true>;
219
222
  'customer-profile-lists': CustomerProfileListsSelect<false> | CustomerProfileListsSelect<true>;
@@ -222,7 +225,6 @@ interface Config {
222
225
  carts: CartsSelect<false> | CartsSelect<true>;
223
226
  'cart-items': CartItemsSelect<false> | CartItemsSelect<true>;
224
227
  discounts: DiscountsSelect<false> | DiscountsSelect<true>;
225
- promotions: PromotionsSelect<false> | PromotionsSelect<true>;
226
228
  articles: ArticlesSelect<false> | ArticlesSelect<true>;
227
229
  'article-authors': ArticleAuthorsSelect<false> | ArticleAuthorsSelect<true>;
228
230
  'article-categories': ArticleCategoriesSelect<false> | ArticleCategoriesSelect<true>;
@@ -968,7 +970,7 @@ interface Webhook {
968
970
  /**
969
971
  * Receives create/update events for this collection.
970
972
  */
971
- collection: 'tenant-metadata' | 'tenant-logos' | 'images' | 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-categories' | 'product-tags' | 'product-collections' | 'brands' | 'brand-logos' | 'orders' | 'order-items' | 'transactions' | 'fulfillments' | 'fulfillment-items' | 'returns' | 'return-items' | 'carts' | 'cart-items' | 'discounts' | 'promotions' | 'shipping-policies' | 'customers' | 'customer-profiles' | 'customer-addresses' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-items' | 'gallery-categories' | 'gallery-tags' | 'links' | 'link-categories' | 'link-tags' | 'forms' | 'form-submissions' | 'articles' | 'article-authors' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'canvases' | 'canvas-node-types' | 'canvas-edge-types' | 'canvas-categories' | 'canvas-tags' | 'canvas-nodes' | 'canvas-edges' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'customer-profile-lists' | 'event-calendars' | 'events' | 'event-categories' | 'event-occurrences' | 'event-tags';
973
+ collection: 'tenant-metadata' | 'tenant-logos' | 'images' | 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-categories' | 'product-tags' | 'product-collections' | 'brands' | 'brand-logos' | 'orders' | 'order-items' | 'transactions' | 'fulfillments' | 'fulfillment-items' | 'returns' | 'return-items' | 'carts' | 'cart-items' | 'discounts' | 'shipping-policies' | 'shipping-zones' | 'customers' | 'customer-profiles' | 'customer-addresses' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-items' | 'gallery-categories' | 'gallery-tags' | 'links' | 'link-categories' | 'link-tags' | 'forms' | 'form-submissions' | 'articles' | 'article-authors' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'canvases' | 'canvas-node-types' | 'canvas-edge-types' | 'canvas-categories' | 'canvas-tags' | 'canvas-nodes' | 'canvas-edges' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'customer-profile-lists' | 'event-calendars' | 'events' | 'event-categories' | 'event-occurrences' | 'event-tags';
972
974
  id?: string | null;
973
975
  }[] | null;
974
976
  isActive?: boolean | null;
@@ -2975,6 +2977,12 @@ interface OrderItem {
2975
2977
  */
2976
2978
  totalPrice: number;
2977
2979
  productTitle?: string | null;
2980
+ /**
2981
+ * Option combination snapshot at order time. Later variant/option changes do not rewrite it.
2982
+ */
2983
+ optionSelection?: {
2984
+ [k: string]: unknown;
2985
+ } | unknown[] | string | number | boolean | null;
2978
2986
  /**
2979
2987
  * Tax rate at time of order (%)
2980
2988
  */
@@ -2983,6 +2991,18 @@ interface OrderItem {
2983
2991
  * Currency at time of order (ISO-4217)
2984
2992
  */
2985
2993
  currency?: string | null;
2994
+ /**
2995
+ * Snapshot of the discount amount allocated to this line at order time (minor units).
2996
+ */
2997
+ discountAllocation?: number | null;
2998
+ /**
2999
+ * Per-unit price snapshot after discount allocation. round(discountedTotalPrice / quantity).
3000
+ */
3001
+ discountedUnitPrice?: number | null;
3002
+ /**
3003
+ * Line total snapshot after discount allocation at order time (totalPrice - discountAllocation).
3004
+ */
3005
+ discountedTotalPrice?: number | null;
2986
3006
  updatedAt: string;
2987
3007
  createdAt: string;
2988
3008
  deletedAt?: string | null;
@@ -3144,6 +3164,14 @@ interface Return {
3144
3164
  */
3145
3165
  refundReceiptUrl?: string | null;
3146
3166
  refundAmount: number;
3167
+ /**
3168
+ * Return shipping fee deducted from refundAmount
3169
+ */
3170
+ returnShippingFee?: number | null;
3171
+ /**
3172
+ * Exchange balance (positive: extra charge, negative: extra refund)
3173
+ */
3174
+ exchangeDifference?: number | null;
3147
3175
  metadata?: {
3148
3176
  [k: string]: unknown;
3149
3177
  } | unknown[] | string | number | boolean | null;
@@ -3166,6 +3194,10 @@ interface ReturnItem {
3166
3194
  variant?: (string | null) | ProductVariant;
3167
3195
  quantity: number;
3168
3196
  restockAction: 'return_to_stock' | 'discard';
3197
+ /**
3198
+ * Restocking fee for this line (deducted from line refund)
3199
+ */
3200
+ restockingFee?: number | null;
3169
3201
  productTitle?: string | null;
3170
3202
  updatedAt: string;
3171
3203
  createdAt: string;
@@ -3192,6 +3224,58 @@ interface OrderStatusLog {
3192
3224
  updatedAt: string;
3193
3225
  createdAt: string;
3194
3226
  }
3227
+ /**
3228
+ * This interface was referenced by `Config`'s JSON-Schema
3229
+ * via the `definition` "inventory-reservations".
3230
+ */
3231
+ interface InventoryReservation {
3232
+ id: string;
3233
+ tenant?: (string | null) | Tenant;
3234
+ order: string | Order;
3235
+ orderItem: string | OrderItem;
3236
+ variant: string | ProductVariant;
3237
+ quantity: number;
3238
+ status: 'held' | 'released' | 'consumed';
3239
+ statusChangedAt?: string | null;
3240
+ updatedAt: string;
3241
+ createdAt: string;
3242
+ deletedAt?: string | null;
3243
+ }
3244
+ /**
3245
+ * This interface was referenced by `Config`'s JSON-Schema
3246
+ * via the `definition` "shipping-zones".
3247
+ */
3248
+ interface ShippingZone {
3249
+ id: string;
3250
+ _order?: string | null;
3251
+ tenant?: (string | null) | Tenant;
3252
+ /**
3253
+ * Display name (e.g. Jeju, Remote Islands) for operator reference
3254
+ */
3255
+ title?: string | null;
3256
+ /**
3257
+ * kind=jeju|remote-islands routes surcharge through shipping-policies fields; kind=custom uses this zone's extraAmount.
3258
+ */
3259
+ kind: 'jeju' | 'remote-islands' | 'custom';
3260
+ postalCodePatterns: {
3261
+ /**
3262
+ * Postal code prefix (e.g. 230, 525) or numeric range (e.g. 63000-63644)
3263
+ */
3264
+ pattern: string;
3265
+ id?: string | null;
3266
+ }[];
3267
+ /**
3268
+ * Surcharge applied when kind=custom. Ignored for jeju and remote-islands (those route through shipping-policies).
3269
+ */
3270
+ extraAmount?: number | null;
3271
+ isActive?: boolean | null;
3272
+ metadata?: {
3273
+ [k: string]: unknown;
3274
+ } | unknown[] | string | number | boolean | null;
3275
+ updatedAt: string;
3276
+ createdAt: string;
3277
+ deletedAt?: string | null;
3278
+ }
3195
3279
  /**
3196
3280
  * This interface was referenced by `Config`'s JSON-Schema
3197
3281
  * via the `definition` "customer-profile-lists".
@@ -3303,6 +3387,18 @@ interface CartItem {
3303
3387
  * Price at the time of adding to cart
3304
3388
  */
3305
3389
  unitPrice: number;
3390
+ /**
3391
+ * Minor-unit discount allocated to this line from the header discount. Populated by recalculateCartTotals.
3392
+ */
3393
+ discountAllocation?: number | null;
3394
+ /**
3395
+ * Per-unit price after discount allocation (display). round(discountedTotalPrice / quantity).
3396
+ */
3397
+ discountedUnitPrice?: number | null;
3398
+ /**
3399
+ * Line total after discount allocation (totalPrice - discountAllocation). Populated by recalculateCartTotals.
3400
+ */
3401
+ discountedTotalPrice?: number | null;
3306
3402
  metadata?: {
3307
3403
  [k: string]: unknown;
3308
3404
  } | unknown[] | string | number | boolean | null;
@@ -3403,29 +3499,6 @@ interface Discount {
3403
3499
  createdAt: string;
3404
3500
  deletedAt?: string | null;
3405
3501
  }
3406
- /**
3407
- * This interface was referenced by `Config`'s JSON-Schema
3408
- * via the `definition` "promotions".
3409
- */
3410
- interface Promotion {
3411
- id: string;
3412
- tenant?: (string | null) | Tenant;
3413
- /**
3414
- * Promotion code
3415
- */
3416
- code: string;
3417
- discountType: 'percent' | 'fixed' | 'free-shipping';
3418
- /**
3419
- * Discount value (percent: 0-100, fixed: minor unit)
3420
- */
3421
- discountValue?: number | null;
3422
- validFrom?: string | null;
3423
- validUntil?: string | null;
3424
- status: 'draft' | 'active' | 'paused' | 'expired';
3425
- updatedAt: string;
3426
- createdAt: string;
3427
- deletedAt?: string | null;
3428
- }
3429
3502
  /**
3430
3503
  * This interface was referenced by `Config`'s JSON-Schema
3431
3504
  * via the `definition` "articles".
@@ -3805,7 +3878,6 @@ interface Playlist {
3805
3878
  * Short summary for listing/cards
3806
3879
  */
3807
3880
  description?: string | null;
3808
- videos?: (string | Video)[] | null;
3809
3881
  categories?: (string | PlaylistCategory)[] | null;
3810
3882
  tags?: (string | PlaylistTag)[] | null;
3811
3883
  /**
@@ -3845,8 +3917,6 @@ interface Playlist {
3845
3917
  };
3846
3918
  };
3847
3919
  thumbnail?: (string | null) | Image;
3848
- coverArt?: (string | null) | Image;
3849
- isCollaborative?: boolean | null;
3850
3920
  /**
3851
3921
  * When enabled, the slug will auto-generate from the title field on save and autosave.
3852
3922
  */
@@ -3925,21 +3995,6 @@ interface Track {
3925
3995
  * Short summary for listing/cards
3926
3996
  */
3927
3997
  description?: string | null;
3928
- content?: {
3929
- root: {
3930
- type: string;
3931
- children: {
3932
- type: any;
3933
- version: number;
3934
- [k: string]: unknown;
3935
- }[];
3936
- direction: ('ltr' | 'rtl') | null;
3937
- format: 'left' | 'start' | 'center' | 'right' | 'end' | 'justify' | '';
3938
- indent: number;
3939
- version: number;
3940
- };
3941
- [k: string]: unknown;
3942
- } | null;
3943
3998
  artist?: string | null;
3944
3999
  album?: string | null;
3945
4000
  releaseDate?: string | null;
@@ -3953,13 +4008,10 @@ interface Track {
3953
4008
  slug?: string | null;
3954
4009
  thumbnail?: (string | null) | Image;
3955
4010
  status?: ('draft' | 'published' | 'archived') | null;
3956
- isFeatured?: boolean | null;
3957
- publishedAt?: string | null;
3958
4011
  /**
3959
4012
  * Duration in seconds
3960
4013
  */
3961
4014
  durationSeconds?: number | null;
3962
- isEmbeddable?: boolean | null;
3963
4015
  metadata?: {
3964
4016
  [k: string]: unknown;
3965
4017
  } | unknown[] | string | number | boolean | null;
@@ -6813,8 +6865,12 @@ interface OrderItemsSelect<T extends boolean = true> {
6813
6865
  requiresShipping?: T;
6814
6866
  totalPrice?: T;
6815
6867
  productTitle?: T;
6868
+ optionSelection?: T;
6816
6869
  taxRate?: T;
6817
6870
  currency?: T;
6871
+ discountAllocation?: T;
6872
+ discountedUnitPrice?: T;
6873
+ discountedTotalPrice?: T;
6818
6874
  updatedAt?: T;
6819
6875
  createdAt?: T;
6820
6876
  deletedAt?: T;
@@ -6881,6 +6937,22 @@ interface OrderStatusLogsSelect<T extends boolean = true> {
6881
6937
  updatedAt?: T;
6882
6938
  createdAt?: T;
6883
6939
  }
6940
+ /**
6941
+ * This interface was referenced by `Config`'s JSON-Schema
6942
+ * via the `definition` "inventory-reservations_select".
6943
+ */
6944
+ interface InventoryReservationsSelect<T extends boolean = true> {
6945
+ tenant?: T;
6946
+ order?: T;
6947
+ orderItem?: T;
6948
+ variant?: T;
6949
+ quantity?: T;
6950
+ status?: T;
6951
+ statusChangedAt?: T;
6952
+ updatedAt?: T;
6953
+ createdAt?: T;
6954
+ deletedAt?: T;
6955
+ }
6884
6956
  /**
6885
6957
  * This interface was referenced by `Config`'s JSON-Schema
6886
6958
  * via the `definition` "fulfillments_select".
@@ -6933,6 +7005,8 @@ interface ReturnsSelect<T extends boolean = true> {
6933
7005
  completedAt?: T;
6934
7006
  refundReceiptUrl?: T;
6935
7007
  refundAmount?: T;
7008
+ returnShippingFee?: T;
7009
+ exchangeDifference?: T;
6936
7010
  metadata?: T;
6937
7011
  updatedAt?: T;
6938
7012
  createdAt?: T;
@@ -6952,6 +7026,7 @@ interface ReturnItemsSelect<T extends boolean = true> {
6952
7026
  variant?: T;
6953
7027
  quantity?: T;
6954
7028
  restockAction?: T;
7029
+ restockingFee?: T;
6955
7030
  productTitle?: T;
6956
7031
  updatedAt?: T;
6957
7032
  createdAt?: T;
@@ -6980,6 +7055,26 @@ interface ShippingPoliciesSelect<T extends boolean = true> {
6980
7055
  createdAt?: T;
6981
7056
  deletedAt?: T;
6982
7057
  }
7058
+ /**
7059
+ * This interface was referenced by `Config`'s JSON-Schema
7060
+ * via the `definition` "shipping-zones_select".
7061
+ */
7062
+ interface ShippingZonesSelect<T extends boolean = true> {
7063
+ _order?: T;
7064
+ tenant?: T;
7065
+ title?: T;
7066
+ kind?: T;
7067
+ postalCodePatterns?: T | {
7068
+ pattern?: T;
7069
+ id?: T;
7070
+ };
7071
+ extraAmount?: T;
7072
+ isActive?: T;
7073
+ metadata?: T;
7074
+ updatedAt?: T;
7075
+ createdAt?: T;
7076
+ deletedAt?: T;
7077
+ }
6983
7078
  /**
6984
7079
  * This interface was referenced by `Config`'s JSON-Schema
6985
7080
  * via the `definition` "customers_select".
@@ -7205,6 +7300,9 @@ interface CartItemsSelect<T extends boolean = true> {
7205
7300
  variant?: T;
7206
7301
  quantity?: T;
7207
7302
  unitPrice?: T;
7303
+ discountAllocation?: T;
7304
+ discountedUnitPrice?: T;
7305
+ discountedTotalPrice?: T;
7208
7306
  metadata?: T;
7209
7307
  updatedAt?: T;
7210
7308
  createdAt?: T;
@@ -7255,22 +7353,6 @@ interface DiscountsSelect<T extends boolean = true> {
7255
7353
  createdAt?: T;
7256
7354
  deletedAt?: T;
7257
7355
  }
7258
- /**
7259
- * This interface was referenced by `Config`'s JSON-Schema
7260
- * via the `definition` "promotions_select".
7261
- */
7262
- interface PromotionsSelect<T extends boolean = true> {
7263
- tenant?: T;
7264
- code?: T;
7265
- discountType?: T;
7266
- discountValue?: T;
7267
- validFrom?: T;
7268
- validUntil?: T;
7269
- status?: T;
7270
- updatedAt?: T;
7271
- createdAt?: T;
7272
- deletedAt?: T;
7273
- }
7274
7356
  /**
7275
7357
  * This interface was referenced by `Config`'s JSON-Schema
7276
7358
  * via the `definition` "articles_select".
@@ -7466,7 +7548,6 @@ interface PlaylistsSelect<T extends boolean = true> {
7466
7548
  title?: T;
7467
7549
  subtitle?: T;
7468
7550
  description?: T;
7469
- videos?: T;
7470
7551
  categories?: T;
7471
7552
  tags?: T;
7472
7553
  tracks?: T;
@@ -7482,8 +7563,6 @@ interface PlaylistsSelect<T extends boolean = true> {
7482
7563
  };
7483
7564
  };
7484
7565
  thumbnail?: T;
7485
- coverArt?: T;
7486
- isCollaborative?: T;
7487
7566
  generateSlug?: T;
7488
7567
  slug?: T;
7489
7568
  status?: T;
@@ -7539,7 +7618,6 @@ interface TracksSelect<T extends boolean = true> {
7539
7618
  tenant?: T;
7540
7619
  title?: T;
7541
7620
  description?: T;
7542
- content?: T;
7543
7621
  artist?: T;
7544
7622
  album?: T;
7545
7623
  releaseDate?: T;
@@ -7550,10 +7628,7 @@ interface TracksSelect<T extends boolean = true> {
7550
7628
  slug?: T;
7551
7629
  thumbnail?: T;
7552
7630
  status?: T;
7553
- isFeatured?: T;
7554
- publishedAt?: T;
7555
7631
  durationSeconds?: T;
7556
- isEmbeddable?: T;
7557
7632
  metadata?: T;
7558
7633
  sourceUrl?: T;
7559
7634
  sourceProvider?: T;