@builtbystack/sq-shopify-theme-sdk 0.0.7 → 0.0.9

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.
package/README.md CHANGED
@@ -239,6 +239,7 @@ getPurchasingCustomerMetafield は渡されたnamespaceとkeyに一致する現
239
239
 
240
240
  ## Type Aliases
241
241
 
242
+ - [Address](#type-aliasesaddressmd)
242
243
  - [CustomerRank](#type-aliasescustomerrankmd)
243
244
  - [CustomerRankCalculationCondition](#type-aliasescustomerrankcalculationconditionmd)
244
245
  - [CustomerRankCalculationPeriod](#type-aliasescustomerrankcalculationperiodmd)
@@ -260,6 +261,59 @@ getPurchasingCustomerMetafield は渡されたnamespaceとkeyに一致する現
260
261
  # Type Aliases
261
262
 
262
263
 
264
+ <a name="type-aliasesaddressmd"></a>
265
+
266
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
267
+
268
+ ***
269
+
270
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / Address
271
+
272
+ ## Type Alias: Address
273
+
274
+ > **Address**: `object`
275
+
276
+ Address はLocationの住所を表す。
277
+
278
+ ### Type declaration
279
+
280
+ #### address1
281
+
282
+ > **address1**: `string`
283
+
284
+ #### address2
285
+
286
+ > **address2**: `string`
287
+
288
+ #### city
289
+
290
+ > **city**: `string`
291
+
292
+ #### country
293
+
294
+ > **country**: `string`
295
+
296
+ #### countryCode
297
+
298
+ > **countryCode**: `string`
299
+
300
+ #### id
301
+
302
+ > **id**: `string`
303
+
304
+ #### postalCode
305
+
306
+ > **postalCode**: `string`
307
+
308
+ #### province
309
+
310
+ > **province**: `string`
311
+
312
+ #### provinceCode
313
+
314
+ > **provinceCode**: `string`
315
+
316
+
263
317
  <a name="type-aliasescustomerrankmd"></a>
264
318
 
265
319
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -280,14 +334,20 @@ CustomerRank は会員ランクを表す。
280
334
 
281
335
  > **calculationCondition**: [`CustomerRankCalculationCondition`](#type-aliasescustomerrankcalculationconditionmd)
282
336
 
337
+ この会員ランクを算出した際の条件
338
+
283
339
  #### earnedPointToRankUp
284
340
 
285
341
  > **earnedPointToRankUp**: `number`
286
342
 
343
+ ランクアップするために必要な残り獲得ポイント
344
+
287
345
  #### higherRank?
288
346
 
289
347
  > `optional` **higherRank**: [`CustomerRankRule`](#type-aliasescustomerrankrulemd)
290
348
 
349
+ この会員ランクの一段階上の会員ランク。上の会員ランクが存在しない場合はnull
350
+
291
351
  #### id
292
352
 
293
353
  > **id**: `string`
@@ -296,22 +356,32 @@ CustomerRank は会員ランクを表す。
296
356
 
297
357
  > `optional` **lowerRank**: [`CustomerRankRule`](#type-aliasescustomerrankrulemd)
298
358
 
359
+ この会員ランクの一段階下の会員ランク。下の会員ランクが存在しない場合はnull
360
+
299
361
  #### name
300
362
 
301
363
  > **name**: `string`
302
364
 
365
+ 会員ランク名
366
+
303
367
  #### pointMultiplier?
304
368
 
305
369
  > `optional` **pointMultiplier**: [`PointMultiplierCustomerRankRule`](#type-aliasespointmultipliercustomerrankrulemd)
306
370
 
371
+ この会員ランクの注文時ポイント倍率。ポイント設定がなかったり、ポイント設定があってもポイント倍率設定がなければnullが返る
372
+
307
373
  #### purchasePriceToRankUp
308
374
 
309
375
  > **purchasePriceToRankUp**: `number`
310
376
 
377
+ ランクアップするために必要な残り購入金額
378
+
311
379
  #### threshold
312
380
 
313
381
  > **threshold**: `number`
314
382
 
383
+ この会員ランクへのランクアップに必要な値。会員ランクの算出方法によりthresholdが指す値は異なり、獲得ポイントと購入金額のどちらかになる
384
+
315
385
 
316
386
  <a name="type-aliasescustomerrankcalculationconditionmd"></a>
317
387
 
@@ -333,14 +403,20 @@ CustomerRankCalculationCondition は会員ランクの算出条件を表す。
333
403
 
334
404
  > `optional` **customerRankCalculationPeriod**: [`CustomerRankCalculationPeriod`](#type-aliasescustomerrankcalculationperiodmd)
335
405
 
406
+ 会員ランク算出期間。期間が無期限の場合はnullを返す
407
+
336
408
  #### earnedPoint
337
409
 
338
410
  > **earnedPoint**: `number`
339
411
 
412
+ 会員ランクの算出根拠となる獲得ポイント
413
+
340
414
  #### purchasePrice
341
415
 
342
416
  > **purchasePrice**: `number`
343
417
 
418
+ 会員ランクの算出根拠となる購入金額
419
+
344
420
 
345
421
  <a name="type-aliasescustomerrankcalculationperiodmd"></a>
346
422
 
@@ -362,10 +438,14 @@ CustomerRankCalculationPeriod は会員ランクの算出期間を表す。
362
438
 
363
439
  > **end**: `Date`
364
440
 
441
+ 集計期間終了日
442
+
365
443
  #### start
366
444
 
367
445
  > **start**: `Date`
368
446
 
447
+ 集計期間開始日
448
+
369
449
 
370
450
  <a name="type-aliasescustomerrankrulemd"></a>
371
451
 
@@ -391,10 +471,14 @@ CustomerRankRule は会員ランクのルールを表す。
391
471
 
392
472
  > **name**: `string`
393
473
 
474
+ 会員ランク名
475
+
394
476
  #### threshold
395
477
 
396
478
  > **threshold**: `number`
397
479
 
480
+ この会員ランクへのランクアップに必要な値。会員ランクの算出方法によりthresholdが指す値は異なり、獲得ポイントと購入金額のどちらかになる。
481
+
398
482
 
399
483
  <a name="type-aliaseslocationmd"></a>
400
484
 
@@ -412,6 +496,10 @@ Location は ShopifyIntegration に紐付いている Location を表す。
412
496
 
413
497
  ### Type declaration
414
498
 
499
+ #### address?
500
+
501
+ > `optional` **address**: [`Address`](#type-aliasesaddressmd)
502
+
415
503
  #### id
416
504
 
417
505
  > **id**: `string`
@@ -420,6 +508,10 @@ Location は ShopifyIntegration に紐付いている Location を表す。
420
508
 
421
509
  > **name**: `string`
422
510
 
511
+ #### phone
512
+
513
+ > **phone**: `string`
514
+
423
515
 
424
516
  <a name="type-aliaseslocationavailabilitiesmd"></a>
425
517
 
@@ -470,16 +562,10 @@ inventoryQuantity は在庫数を表す。
470
562
 
471
563
  #### location
472
564
 
473
- > **location**: `object`
565
+ > **location**: [`Location`](#type-aliaseslocationmd)
474
566
 
475
567
  location は在庫のLocationを表す。
476
568
 
477
- #### location.name
478
-
479
- > **name**: `string`
480
-
481
- name はLocationの名前を表す。
482
-
483
569
 
484
570
  <a name="type-aliaseslocationsmd"></a>
485
571
 
@@ -568,22 +654,33 @@ PointChange はポイントの変動を表す。
568
654
 
569
655
  > `optional` **availableAt**: `Date`
570
656
 
657
+ ポイントが利用可能になる日時。nilの場合はまだ利用可能になる日時が決まっていない。主に未配送注文に関するポイントはnilになる。
658
+
571
659
  #### availableUntil?
572
660
 
573
661
  > `optional` **availableUntil**: `Date`
574
662
 
663
+ ポイントが利用できる期限。失効する直前を表すため、expiresDateから1ナノ秒を引いた値となる。
664
+ 例えば、expiresDateが 2024-06-12 00:00:00 なら、availableUntilは 2024-06-11 23:59:59.999999999 となる。
665
+
575
666
  #### createdAt
576
667
 
577
668
  > **createdAt**: `Date`
578
669
 
670
+ PointChangeのコミットタイムスタンプ
671
+
579
672
  #### delta
580
673
 
581
674
  > **delta**: `number`
582
675
 
676
+ ポイント変動の数値。正負どちらの値も取りうる。
677
+
583
678
  #### expiresDate?
584
679
 
585
680
  > `optional` **expiresDate**: `Date`
586
681
 
682
+ ポイントの失効日。nilの場合はまだ失効日が決まっていない。ポイント消費や、未配送注文に関するポイントはnilになる。
683
+
587
684
  #### id
588
685
 
589
686
  > **id**: `string`
@@ -592,6 +689,8 @@ PointChange はポイントの変動を表す。
592
689
 
593
690
  > **pointChangeCreatedAt**: `Date`
594
691
 
692
+ ポイントの発生日時
693
+
595
694
 
596
695
  <a name="type-aliasespointchangeactivitiesmd"></a>
597
696
 
@@ -605,6 +704,8 @@ PointChange はポイントの変動を表す。
605
704
 
606
705
  > **PointChangeActivities**: `object`
607
706
 
707
+ PointChangeActivities はポイントの変動の履歴一覧を表す。
708
+
608
709
  ### Type declaration
609
710
 
610
711
  #### nodes
@@ -694,10 +795,14 @@ Points は SDK から取得できるポイントの情報を表す。
694
795
 
695
796
  > **pointsApproved**: `number`
696
797
 
798
+ PointsApproved は保有ポイントを表す。
799
+
697
800
  #### pointsPending
698
801
 
699
802
  > **pointsPending**: `number`
700
803
 
804
+ PointsPending は獲得予定ポイントを表す。
805
+
701
806
 
702
807
  <a name="type-aliasespurchasingcustomerdiscountmd"></a>
703
808
 
@@ -727,10 +832,24 @@ PurchasingCustomerDiscount は購入者の割引情報を表す。
727
832
 
728
833
  > **description**: `string`
729
834
 
835
+ #### endsAt
836
+
837
+ > **endsAt**: `Date`
838
+
730
839
  #### id
731
840
 
732
841
  > **id**: `string`
733
842
 
843
+ #### startsAt
844
+
845
+ > **startsAt**: `Date`
846
+
847
+ #### status
848
+
849
+ > **status**: `string`
850
+
851
+ Discountのステータス。"ACTIVE", "SCHEDULED", "EXPIRED" のいずれかが入る。
852
+
734
853
  #### title
735
854
 
736
855
  > **title**: `string`
@@ -752,7 +871,7 @@ PurchasingCustomerDiscount は購入者の割引情報を表す。
752
871
 
753
872
  > **PurchasingCustomerDiscounts**: `object`
754
873
 
755
- DiscountCodes は PurchasingCustomerDiscount の一覧を取得するための情報を表す。
874
+ PurchasingCustomerDiscounts は PurchasingCustomerDiscount の一覧を取得するための情報を表す。
756
875
 
757
876
  ### Type declaration
758
877
 
@@ -1,15 +1,54 @@
1
+ /**
2
+ * Address はLocationの住所を表す。
3
+ */
4
+ export declare type Address = {
5
+ id: string;
6
+ countryCode: string;
7
+ country: string;
8
+ postalCode: string;
9
+ provinceCode: string;
10
+ province: string;
11
+ city: string;
12
+ address1: string;
13
+ address2: string;
14
+ };
15
+
1
16
  /**
2
17
  * CustomerRank は会員ランクを表す。
3
18
  */
4
19
  export declare type CustomerRank = {
5
20
  id: string;
21
+ /**
22
+ * 会員ランク名
23
+ */
6
24
  name: string;
25
+ /**
26
+ * この会員ランクを算出した際の条件
27
+ */
7
28
  calculationCondition: CustomerRankCalculationCondition;
29
+ /**
30
+ * ランクアップするために必要な残り獲得ポイント
31
+ */
8
32
  earnedPointToRankUp: number;
33
+ /**
34
+ * この会員ランクの一段階上の会員ランク。上の会員ランクが存在しない場合はnull
35
+ */
9
36
  higherRank?: CustomerRankRule;
37
+ /**
38
+ * この会員ランクの一段階下の会員ランク。下の会員ランクが存在しない場合はnull
39
+ */
10
40
  lowerRank?: CustomerRankRule;
41
+ /**
42
+ * ランクアップするために必要な残り購入金額
43
+ */
11
44
  purchasePriceToRankUp: number;
45
+ /**
46
+ * この会員ランクへのランクアップに必要な値。会員ランクの算出方法によりthresholdが指す値は異なり、獲得ポイントと購入金額のどちらかになる
47
+ */
12
48
  threshold: number;
49
+ /**
50
+ * この会員ランクの注文時ポイント倍率。ポイント設定がなかったり、ポイント設定があってもポイント倍率設定がなければnullが返る
51
+ */
13
52
  pointMultiplier?: PointMultiplierCustomerRankRule;
14
53
  };
15
54
 
@@ -17,8 +56,17 @@ export declare type CustomerRank = {
17
56
  * CustomerRankCalculationCondition は会員ランクの算出条件を表す。
18
57
  */
19
58
  export declare type CustomerRankCalculationCondition = {
59
+ /**
60
+ * 会員ランク算出期間。期間が無期限の場合はnullを返す
61
+ */
20
62
  customerRankCalculationPeriod?: CustomerRankCalculationPeriod;
63
+ /**
64
+ * 会員ランクの算出根拠となる獲得ポイント
65
+ */
21
66
  earnedPoint: number;
67
+ /**
68
+ * 会員ランクの算出根拠となる購入金額
69
+ */
22
70
  purchasePrice: number;
23
71
  };
24
72
 
@@ -26,7 +74,13 @@ export declare type CustomerRankCalculationCondition = {
26
74
  * CustomerRankCalculationPeriod は会員ランクの算出期間を表す。
27
75
  */
28
76
  export declare type CustomerRankCalculationPeriod = {
77
+ /**
78
+ * 集計期間開始日
79
+ */
29
80
  start: Date;
81
+ /**
82
+ * 集計期間終了日
83
+ */
30
84
  end: Date;
31
85
  };
32
86
 
@@ -35,7 +89,13 @@ export declare type CustomerRankCalculationPeriod = {
35
89
  */
36
90
  export declare type CustomerRankRule = {
37
91
  id: string;
92
+ /**
93
+ * 会員ランク名
94
+ */
38
95
  name: string;
96
+ /**
97
+ * この会員ランクへのランクアップに必要な値。会員ランクの算出方法によりthresholdが指す値は異なり、獲得ポイントと購入金額のどちらかになる。
98
+ */
39
99
  threshold: number;
40
100
  };
41
101
 
@@ -45,6 +105,8 @@ export declare type CustomerRankRule = {
45
105
  declare type Location_2 = {
46
106
  id: string;
47
107
  name: string;
108
+ phone: string;
109
+ address?: Address;
48
110
  };
49
111
  export { Location_2 as Location }
50
112
 
@@ -63,12 +125,7 @@ export declare type LocationAvailability = {
63
125
  /**
64
126
  * location は在庫のLocationを表す。
65
127
  */
66
- location: {
67
- /**
68
- * name はLocationの名前を表す。
69
- */
70
- name: string;
71
- };
128
+ location: Location_2;
72
129
  /**
73
130
  * inventoryQuantity は在庫数を表す。
74
131
  */
@@ -111,16 +168,35 @@ export declare type PageInfo = {
111
168
  */
112
169
  export declare type PointChange = {
113
170
  id: string;
171
+ /**
172
+ * ポイント変動の数値。正負どちらの値も取りうる。
173
+ */
114
174
  delta: number;
175
+ /**
176
+ * ポイントが利用可能になる日時。nilの場合はまだ利用可能になる日時が決まっていない。主に未配送注文に関するポイントはnilになる。
177
+ */
115
178
  availableAt?: Date;
179
+ /**
180
+ * ポイントが利用できる期限。失効する直前を表すため、expiresDateから1ナノ秒を引いた値となる。
181
+ * 例えば、expiresDateが 2024-06-12 00:00:00 なら、availableUntilは 2024-06-11 23:59:59.999999999 となる。
182
+ */
116
183
  availableUntil?: Date;
184
+ /**
185
+ * ポイントの失効日。nilの場合はまだ失効日が決まっていない。ポイント消費や、未配送注文に関するポイントはnilになる。
186
+ */
117
187
  expiresDate?: Date;
188
+ /**
189
+ * ポイントの発生日時
190
+ */
118
191
  pointChangeCreatedAt: Date;
192
+ /**
193
+ * PointChangeのコミットタイムスタンプ
194
+ */
119
195
  createdAt: Date;
120
196
  };
121
197
 
122
198
  /**
123
- *
199
+ * PointChangeActivities はポイントの変動の履歴一覧を表す。
124
200
  */
125
201
  export declare type PointChangeActivities = {
126
202
  nodes: PointChangeActivity[];
@@ -142,7 +218,7 @@ declare enum PointChangeActivitySortKey {
142
218
  }
143
219
 
144
220
  /**
145
- * PointMultiplierCustomerRankRule はこの会員ランクの注文時ポイント倍率を表す。
221
+ * PointMultiplierCustomerRankRule はこの会員ランクの注文時ポイント倍率を表す。
146
222
  */
147
223
  export declare type PointMultiplierCustomerRankRule = {
148
224
  id: string;
@@ -154,7 +230,13 @@ export declare type PointMultiplierCustomerRankRule = {
154
230
  * Points は SDK から取得できるポイントの情報を表す。
155
231
  */
156
232
  export declare type Points = {
233
+ /**
234
+ * PointsApproved は保有ポイントを表す。
235
+ */
157
236
  pointsApproved: number;
237
+ /**
238
+ * PointsPending は獲得予定ポイントを表す。
239
+ */
158
240
  pointsPending: number;
159
241
  };
160
242
 
@@ -165,13 +247,19 @@ export declare type PurchasingCustomerDiscount = {
165
247
  id: string;
166
248
  title: string;
167
249
  description: string;
250
+ /**
251
+ * Discountのステータス。"ACTIVE", "SCHEDULED", "EXPIRED" のいずれかが入る。
252
+ */
253
+ status: string;
168
254
  code: string;
255
+ startsAt: Date;
256
+ endsAt: Date;
169
257
  createdAt: Date;
170
258
  updatedAt: Date;
171
259
  };
172
260
 
173
261
  /**
174
- * DiscountCodes は PurchasingCustomerDiscount の一覧を取得するための情報を表す。
262
+ * PurchasingCustomerDiscounts は PurchasingCustomerDiscount の一覧を取得するための情報を表す。
175
263
  */
176
264
  export declare type PurchasingCustomerDiscounts = {
177
265
  id: string;