@algolia/client-abtesting 5.0.0-alpha.99 → 5.0.0-beta.10

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 (56) hide show
  1. package/LICENSE +21 -0
  2. package/dist/builds/browser.d.ts +22 -3
  3. package/dist/builds/browser.d.ts.map +1 -1
  4. package/dist/builds/node.d.ts +22 -3
  5. package/dist/builds/node.d.ts.map +1 -1
  6. package/dist/client-abtesting.cjs +51 -42
  7. package/dist/client-abtesting.esm.browser.js +47 -50
  8. package/dist/client-abtesting.esm.node.js +51 -42
  9. package/dist/client-abtesting.umd.js +2 -2
  10. package/dist/model/aBTest.d.ts +14 -29
  11. package/dist/model/aBTest.d.ts.map +1 -1
  12. package/dist/model/aBTestConfiguration.d.ts +12 -0
  13. package/dist/model/aBTestConfiguration.d.ts.map +1 -0
  14. package/dist/model/aBTestResponse.d.ts +3 -3
  15. package/dist/model/abTestsVariant.d.ts +3 -3
  16. package/dist/model/addABTestsRequest.d.ts +1 -1
  17. package/dist/model/clientMethodProps.d.ts +7 -7
  18. package/dist/model/{currenciesValue.d.ts → currency.d.ts} +2 -2
  19. package/dist/model/currency.d.ts.map +1 -0
  20. package/dist/model/customSearchParams.d.ts +1 -1
  21. package/dist/model/effect.d.ts +5 -0
  22. package/dist/model/effect.d.ts.map +1 -0
  23. package/dist/model/emptySearch.d.ts +10 -0
  24. package/dist/model/emptySearch.d.ts.map +1 -0
  25. package/dist/model/index.d.ts +7 -1
  26. package/dist/model/index.d.ts.map +1 -1
  27. package/dist/model/listABTestsResponse.d.ts +2 -2
  28. package/dist/model/listABTestsResponse.d.ts.map +1 -1
  29. package/dist/model/minimumDetectableEffect.d.ts +12 -0
  30. package/dist/model/minimumDetectableEffect.d.ts.map +1 -0
  31. package/dist/model/outliers.d.ts +10 -0
  32. package/dist/model/outliers.d.ts.map +1 -0
  33. package/dist/model/status.d.ts +5 -0
  34. package/dist/model/status.d.ts.map +1 -0
  35. package/dist/model/variant.d.ts +29 -25
  36. package/dist/model/variant.d.ts.map +1 -1
  37. package/dist/src/abtestingClient.d.ts +28 -26
  38. package/dist/src/abtestingClient.d.ts.map +1 -1
  39. package/model/aBTest.ts +15 -29
  40. package/model/aBTestConfiguration.ts +16 -0
  41. package/model/aBTestResponse.ts +3 -3
  42. package/model/abTestsVariant.ts +3 -3
  43. package/model/addABTestsRequest.ts +1 -1
  44. package/model/clientMethodProps.ts +7 -7
  45. package/model/{currenciesValue.ts → currency.ts} +1 -1
  46. package/model/customSearchParams.ts +1 -1
  47. package/model/effect.ts +10 -0
  48. package/model/emptySearch.ts +11 -0
  49. package/model/index.ts +7 -1
  50. package/model/listABTestsResponse.ts +2 -2
  51. package/model/minimumDetectableEffect.ts +15 -0
  52. package/model/outliers.ts +11 -0
  53. package/model/status.ts +6 -0
  54. package/model/variant.ts +30 -25
  55. package/package.json +11 -8
  56. package/dist/model/currenciesValue.d.ts.map +0 -1
@@ -1,4 +1,4 @@
1
- import type { CurrenciesValue } from './currenciesValue';
1
+ import type { Currency } from './currency';
2
2
  import type { FilterEffects } from './filterEffects';
3
3
  export type Variant = {
4
4
  /**
@@ -6,73 +6,77 @@ export type Variant = {
6
6
  */
7
7
  addToCartCount: number;
8
8
  /**
9
- * Variant\'s [add-to-cart rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#add-to-cart-rate).
9
+ * [Add-to-cart rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#add-to-cart-rate) for this variant.
10
10
  */
11
- addToCartRate: number;
11
+ addToCartRate: number | null;
12
12
  /**
13
- * Variant\'s [average click position](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-position).
13
+ * [Average click position](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-position) for this variant.
14
14
  */
15
- averageClickPosition: number;
15
+ averageClickPosition: number | null;
16
16
  /**
17
17
  * Number of click events for this variant.
18
18
  */
19
19
  clickCount: number;
20
20
  /**
21
- * Variant\'s [click-through rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
21
+ * [Click-through rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate) for this variant.
22
22
  */
23
- clickThroughRate: number;
23
+ clickThroughRate: number | null;
24
24
  /**
25
25
  * Number of click events for this variant.
26
26
  */
27
27
  conversionCount: number;
28
28
  /**
29
- * Variant\'s [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
29
+ * [Conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate) for this variant.
30
30
  */
31
- conversionRate: number;
31
+ conversionRate: number | null;
32
32
  /**
33
33
  * A/B test currencies.
34
34
  */
35
- currencies: Record<string, CurrenciesValue>;
35
+ currencies?: Record<string, Currency>;
36
36
  /**
37
- * A/B test description.
37
+ * Description for this variant.
38
38
  */
39
39
  description: string;
40
+ /**
41
+ * Estimated number of searches required to achieve the desired statistical significance. The A/B test configuration must include a `mininmumDetectableEffect` setting for this number to be included in the response.
42
+ */
43
+ estimatedSampleSize?: number;
40
44
  filterEffects?: FilterEffects;
41
45
  /**
42
- * A/B test index.
46
+ * Index name of the A/B test variant (case-sensitive).
43
47
  */
44
48
  index: string;
45
49
  /**
46
- * Number of [searches without results](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#searches-without-results) for that variant.
50
+ * Number of [searches without results](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#searches-without-results) for this variant.
47
51
  */
48
- noResultCount: number;
52
+ noResultCount: number | null;
49
53
  /**
50
54
  * Number of purchase events for this variant.
51
55
  */
52
56
  purchaseCount: number;
53
57
  /**
54
- * Variant\'s [purchase rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#purchase-rate).
58
+ * [Purchase rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#purchase-rate) for this variant.
55
59
  */
56
- purchaseRate: number;
60
+ purchaseRate: number | null;
57
61
  /**
58
- * Number of searches carried out during the A/B test.
62
+ * Number of searches for this variant.
59
63
  */
60
- searchCount: number;
64
+ searchCount: number | null;
61
65
  /**
62
- * Number of tracked searches. This is the number of search requests where the `clickAnalytics` parameter is `true`.
66
+ * Number of tracked searches. Tracked searches are search requests where the `clickAnalytics` parameter is true.
63
67
  */
64
- trackedSearchCount: number;
68
+ trackedSearchCount?: number;
65
69
  /**
66
- * A/B test traffic percentage.
70
+ * Percentage of search requests each variant receives.
67
71
  */
68
72
  trafficPercentage: number;
69
73
  /**
70
- * Number of users during the A/B test.
74
+ * Number of users that made searches to this variant.
71
75
  */
72
- userCount: number;
76
+ userCount: number | null;
73
77
  /**
74
- * Number of users that performed a tracked search during the A/B test.
78
+ * Number of users that made tracked searches to this variant.
75
79
  */
76
- trackedUserCount: number;
80
+ trackedUserCount: number | null;
77
81
  };
78
82
  //# sourceMappingURL=variant.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../../model/variant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE5C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC"}
1
+ {"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../../model/variant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IACpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEtC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC"}
@@ -4,7 +4,7 @@ import type { ABTestResponse } from '../model/aBTestResponse';
4
4
  import type { AddABTestsRequest } from '../model/addABTestsRequest';
5
5
  import type { CustomDeleteProps, CustomGetProps, CustomPostProps, CustomPutProps, DeleteABTestProps, GetABTestProps, ListABTestsProps, StopABTestProps } from '../model/clientMethodProps';
6
6
  import type { ListABTestsResponse } from '../model/listABTestsResponse';
7
- export declare const apiClientVersion = "5.0.0-alpha.99";
7
+ export declare const apiClientVersion = "5.0.0-beta.10";
8
8
  export declare const REGIONS: readonly ["de", "us"];
9
9
  export type Region = (typeof REGIONS)[number];
10
10
  export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authMode, algoliaAgents, region: regionOption, ...options }: CreateClientOptions & {
@@ -31,9 +31,11 @@ export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiK
31
31
  */
32
32
  addAlgoliaAgent(segment: string, version?: string): void;
33
33
  /**
34
- * Creates an A/B test.
34
+ * Creates a new A/B test.
35
+ *
36
+ * Required API Key ACLs:
37
+ * - editSettings.
35
38
  *
36
- * @summary Create an A/B test.
37
39
  * @param addABTestsRequest - The addABTestsRequest object.
38
40
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
39
41
  */
@@ -41,7 +43,6 @@ export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiK
41
43
  /**
42
44
  * This method allow you to send requests to the Algolia REST API.
43
45
  *
44
- * @summary Send requests to the Algolia REST API.
45
46
  * @param customDelete - The customDelete object.
46
47
  * @param customDelete.path - Path of the endpoint, anything after \"/1\" must be specified.
47
48
  * @param customDelete.parameters - Query parameters to apply to the current query.
@@ -51,7 +52,6 @@ export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiK
51
52
  /**
52
53
  * This method allow you to send requests to the Algolia REST API.
53
54
  *
54
- * @summary Send requests to the Algolia REST API.
55
55
  * @param customGet - The customGet object.
56
56
  * @param customGet.path - Path of the endpoint, anything after \"/1\" must be specified.
57
57
  * @param customGet.parameters - Query parameters to apply to the current query.
@@ -61,7 +61,6 @@ export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiK
61
61
  /**
62
62
  * This method allow you to send requests to the Algolia REST API.
63
63
  *
64
- * @summary Send requests to the Algolia REST API.
65
64
  * @param customPost - The customPost object.
66
65
  * @param customPost.path - Path of the endpoint, anything after \"/1\" must be specified.
67
66
  * @param customPost.parameters - Query parameters to apply to the current query.
@@ -72,7 +71,6 @@ export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiK
72
71
  /**
73
72
  * This method allow you to send requests to the Algolia REST API.
74
73
  *
75
- * @summary Send requests to the Algolia REST API.
76
74
  * @param customPut - The customPut object.
77
75
  * @param customPut.path - Path of the endpoint, anything after \"/1\" must be specified.
78
76
  * @param customPut.parameters - Query parameters to apply to the current query.
@@ -81,47 +79,51 @@ export declare function createAbtestingClient({ appId: appIdOption, apiKey: apiK
81
79
  */
82
80
  customPut({ path, parameters, body }: CustomPutProps, requestOptions?: RequestOptions): Promise<Record<string, any>>;
83
81
  /**
84
- * Delete an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
82
+ * Deletes an A/B test by its ID.
83
+ *
84
+ * Required API Key ACLs:
85
+ * - editSettings.
85
86
  *
86
- * @summary Delete an A/B test.
87
87
  * @param deleteABTest - The deleteABTest object.
88
- * @param deleteABTest.id - Unique A/B test ID.
88
+ * @param deleteABTest.id - Unique A/B test identifier.
89
89
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
90
90
  */
91
91
  deleteABTest({ id }: DeleteABTestProps, requestOptions?: RequestOptions): Promise<ABTestResponse>;
92
92
  /**
93
- * Get specific details for an A/B test. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
93
+ * Retrieves the details for an A/B test by its ID.
94
+ *
95
+ * Required API Key ACLs:
96
+ * - analytics.
94
97
  *
95
- * @summary Get A/B test details.
96
98
  * @param getABTest - The getABTest object.
97
- * @param getABTest.id - Unique A/B test ID.
99
+ * @param getABTest.id - Unique A/B test identifier.
98
100
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
99
101
  */
100
102
  getABTest({ id }: GetABTestProps, requestOptions?: RequestOptions): Promise<ABTest>;
101
103
  /**
102
- * List all A/B tests.
104
+ * Lists all A/B tests you configured for this application.
105
+ *
106
+ * Required API Key ACLs:
107
+ * - analytics.
103
108
  *
104
- * @summary List all A/B tests.
105
109
  * @param listABTests - The listABTests object.
106
- * @param listABTests.offset - Position of the starting record. Used for paging. 0 is the first record.
107
- * @param listABTests.limit - Number of records to return (page size).
108
- * @param listABTests.indexPrefix - Only return A/B tests for indices starting with this prefix.
109
- * @param listABTests.indexSuffix - Only return A/B tests for indices ending with this suffix.
110
+ * @param listABTests.offset - Position of the first item to return.
111
+ * @param listABTests.limit - Number of items to return.
112
+ * @param listABTests.indexPrefix - Index name prefix. Only A/B tests for indices starting with this string are included in the response.
113
+ * @param listABTests.indexSuffix - Index name suffix. Only A/B tests for indices ending with this string are included in the response.
110
114
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
111
115
  */
112
116
  listABTests({ offset, limit, indexPrefix, indexSuffix }?: ListABTestsProps, requestOptions?: RequestOptions | undefined): Promise<ListABTestsResponse>;
113
117
  /**
114
- * If stopped, the test is over and can\'t be restarted. There is now only one index, receiving 100% of all search requests. The data gathered for stopped A/B tests is retained. To determine the `id` for an A/B test, use the [`listABTests` operation](#tag/abtest/operation/listABTests).
118
+ * Stops an A/B test by its ID. You can\'t restart stopped A/B tests.
119
+ *
120
+ * Required API Key ACLs:
121
+ * - editSettings.
115
122
  *
116
- * @summary Stop an A/B test.
117
123
  * @param stopABTest - The stopABTest object.
118
- * @param stopABTest.id - Unique A/B test ID.
124
+ * @param stopABTest.id - Unique A/B test identifier.
119
125
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
120
126
  */
121
127
  stopABTest({ id }: StopABTestProps, requestOptions?: RequestOptions): Promise<ABTestResponse>;
122
128
  };
123
- /**
124
- * The client type.
125
- */
126
- export type AbtestingClient = ReturnType<typeof createAbtestingClient>;
127
129
  //# sourceMappingURL=abtestingClient.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"abtestingClient.d.ts","sourceRoot":"","sources":["../../src/abtestingClient.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,mBAAmB,EAInB,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD,eAAO,MAAM,OAAO,uBAAwB,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAW9C,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,QAAQ,EACR,aAAa,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;IAwBxC;;OAEG;;IAGH;;OAEG;kBACW,QAAQ,IAAI,CAAC;IAO3B;;OAEG;;IAKH;;;;;OAKG;6BACsB,MAAM,YAAY,MAAM,GAAG,IAAI;IAIxD;;;;;;OAMG;kCAEkB,iBAAiB,mBACnB,cAAc,GAC9B,QAAQ,cAAc,CAAC;IAsC1B;;;;;;;;OAQG;uCAEqB,iBAAiB,mBACtB,cAAc,GAC9B,QAAQ,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC;IAqB/B;;;;;;;;OAQG;oCAEqB,cAAc,mBACnB,cAAc,GAC9B,QAAQ,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC;IAqB/B;;;;;;;;;OASG;2CAE2B,eAAe,mBAC1B,cAAc,GAC9B,QAAQ,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC;IAsB/B;;;;;;;;;OASG;0CAE2B,cAAc,mBACzB,cAAc,GAC9B,QAAQ,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC;IAsB/B;;;;;;;OAOG;yBAEO,iBAAiB,mBACR,cAAc,GAC9B,QAAQ,cAAc,CAAC;IAwB1B;;;;;;;OAOG;sBAEO,cAAc,mBACL,cAAc,GAC9B,QAAQ,MAAM,CAAC;IAsBlB;;;;;;;;;;OAUG;8DAE4C,gBAAgB,mBAC7C,cAAc,GAAG,SAAS,GACzC,QAAQ,mBAAmB,CAAC;IA+B/B;;;;;;;OAOG;uBAEO,eAAe,mBACN,cAAc,GAC9B,QAAQ,cAAc,CAAC;EAwB7B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
1
+ {"version":3,"file":"abtestingClient.d.ts","sourceRoot":"","sources":["../../src/abtestingClient.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,mBAAmB,EAKnB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,eAAO,MAAM,OAAO,uBAAwB,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAW9C,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,QAAQ,EACR,aAAa,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,OAAO,EACX,EAAE,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;IAwBxC;;OAEG;;IAGH;;OAEG;kBACW,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;;IAKH;;;;;OAKG;6BACsB,MAAM,YAAY,MAAM,GAAG,IAAI;IAIxD;;;;;;;;OAQG;kCAEkB,iBAAiB,mBACnB,cAAc,GAC9B,OAAO,CAAC,cAAc,CAAC;IAsC1B;;;;;;;OAOG;uCAEqB,iBAAiB,mBACtB,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAqB/B;;;;;;;OAOG;oCAEqB,cAAc,mBACnB,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAqB/B;;;;;;;;OAQG;2CAE2B,eAAe,mBAC1B,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAsB/B;;;;;;;;OAQG;0CAE2B,cAAc,mBACzB,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAsB/B;;;;;;;;;OASG;yBAEO,iBAAiB,mBACR,cAAc,GAC9B,OAAO,CAAC,cAAc,CAAC;IAwB1B;;;;;;;;;OASG;sBAEO,cAAc,mBACL,cAAc,GAC9B,OAAO,CAAC,MAAM,CAAC;IAsBlB;;;;;;;;;;;;OAYG;8DAE4C,gBAAgB,mBAC7C,cAAc,GAAG,SAAS,GACzC,OAAO,CAAC,mBAAmB,CAAC;IA+B/B;;;;;;;;;OASG;uBAEO,eAAe,mBACN,cAAc,GAC9B,OAAO,CAAC,cAAc,CAAC;EAwB7B"}
package/model/aBTest.ts CHANGED
@@ -1,50 +1,37 @@
1
1
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
2
 
3
+ import type { ABTestConfiguration } from './aBTestConfiguration';
4
+ import type { Status } from './status';
3
5
  import type { Variant } from './variant';
4
6
 
5
7
  export type ABTest = {
6
8
  /**
7
- * Unique A/B test ID.
9
+ * Unique A/B test identifier.
8
10
  */
9
11
  abTestID: number;
10
12
 
11
- /**
12
- * [A/B test significance](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing/in-depth/how-ab-test-scores-are-calculated/#statistical-significance-or-chance) based on click data. A value of 0.95 or over is considered to be _significant_.
13
- */
14
- clickSignificance: number;
13
+ clickSignificance: number | null;
15
14
 
16
- /**
17
- * [A/B test significance](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing/in-depth/how-ab-test-scores-are-calculated/#statistical-significance-or-chance) based on conversion. A value of 0.95 or over is considered to be _significant_.
18
- */
19
- conversionSignificance: number;
15
+ conversionSignificance: number | null;
20
16
 
21
- /**
22
- * [A/B test significance](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing/in-depth/how-ab-test-scores-are-calculated/#statistical-significance-or-chance) based on add-to-cart data. A value of 0.95 or over is considered to be _significant_.
23
- */
24
- addToCartSignificance: number;
17
+ addToCartSignificance: number | null;
25
18
 
26
- /**
27
- * [A/B test significance](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing/in-depth/how-ab-test-scores-are-calculated/#statistical-significance-or-chance) based on purchase data. A value of 0.95 or over is considered to be _significant_.
28
- */
29
- purchaseSignificance: number;
19
+ purchaseSignificance: number | null;
30
20
 
31
- /**
32
- * [A/B test significance](https://www.algolia.com/doc/guides/ab-testing/what-is-ab-testing/in-depth/how-ab-test-scores-are-calculated/#statistical-significance-or-chance) based on revenue data. A value of 0.95 or over is considered to be _significant_.
33
- */
34
- revenueSignificance: Record<string, number>;
21
+ revenueSignificance: Record<string, number> | null;
35
22
 
36
23
  /**
37
- * Update date timestamp in [ISO-8601](https://wikipedia.org/wiki/ISO_8601) format.
24
+ * Date and time when the A/B test was last updated, in RFC 3339 format.
38
25
  */
39
26
  updatedAt: string;
40
27
 
41
28
  /**
42
- * Creation date timestamp in [ISO-8601](https://wikipedia.org/wiki/ISO_8601) format.
29
+ * Date and time when the A/B test was created, in RFC 3339 format.
43
30
  */
44
31
  createdAt: string;
45
32
 
46
33
  /**
47
- * End date timestamp in [ISO-8601](https://wikipedia.org/wiki/ISO_8601) format.
34
+ * End date and time of the A/B test, in RFC 3339 format.
48
35
  */
49
36
  endAt: string;
50
37
 
@@ -53,13 +40,12 @@ export type ABTest = {
53
40
  */
54
41
  name: string;
55
42
 
56
- /**
57
- * A/B test status.
58
- */
59
- status: string;
43
+ status: Status;
60
44
 
61
45
  /**
62
- * A/B test variants.
46
+ * A/B test variants. The first variant is your _control_ index, typically your production index. The second variant is an index with changed settings that you want to test against the control.
63
47
  */
64
48
  variants: Variant[];
49
+
50
+ configuration?: ABTestConfiguration;
65
51
  };
@@ -0,0 +1,16 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ import type { EmptySearch } from './emptySearch';
4
+ import type { MinimumDetectableEffect } from './minimumDetectableEffect';
5
+ import type { Outliers } from './outliers';
6
+
7
+ /**
8
+ * A/B test configuration.
9
+ */
10
+ export type ABTestConfiguration = {
11
+ outliers: Outliers;
12
+
13
+ emptySearch?: EmptySearch;
14
+
15
+ minimumDetectableEffect?: MinimumDetectableEffect;
16
+ };
@@ -2,17 +2,17 @@
2
2
 
3
3
  export type ABTestResponse = {
4
4
  /**
5
- * A/B test index.
5
+ * Index name of the A/B test variant (case-sensitive).
6
6
  */
7
7
  index: string;
8
8
 
9
9
  /**
10
- * Unique A/B test ID.
10
+ * Unique A/B test identifier.
11
11
  */
12
12
  abTestID: number;
13
13
 
14
14
  /**
15
- * Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task\'s progress with the `task` operation and this `taskID`.
15
+ * Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task\'s progress with the [`task` operation](#tag/Indices/operation/getTask) and this `taskID`.
16
16
  */
17
17
  taskID: number;
18
18
  };
@@ -2,17 +2,17 @@
2
2
 
3
3
  export type AbTestsVariant = {
4
4
  /**
5
- * A/B test index.
5
+ * Index name of the A/B test variant (case-sensitive).
6
6
  */
7
7
  index: string;
8
8
 
9
9
  /**
10
- * A/B test traffic percentage.
10
+ * Percentage of search requests each variant receives.
11
11
  */
12
12
  trafficPercentage: number;
13
13
 
14
14
  /**
15
- * A/B test description.
15
+ * Description for this variant.
16
16
  */
17
17
  description?: string;
18
18
  };
@@ -14,7 +14,7 @@ export type AddABTestsRequest = {
14
14
  variants: AddABTestsVariant[];
15
15
 
16
16
  /**
17
- * End date timestamp in [ISO-8601](https://wikipedia.org/wiki/ISO_8601) format.
17
+ * End date and time of the A/B test, in RFC 3339 format.
18
18
  */
19
19
  endAt: string;
20
20
  };
@@ -69,7 +69,7 @@ export type CustomPutProps = {
69
69
  */
70
70
  export type DeleteABTestProps = {
71
71
  /**
72
- * Unique A/B test ID.
72
+ * Unique A/B test identifier.
73
73
  */
74
74
  id: number;
75
75
  };
@@ -79,7 +79,7 @@ export type DeleteABTestProps = {
79
79
  */
80
80
  export type GetABTestProps = {
81
81
  /**
82
- * Unique A/B test ID.
82
+ * Unique A/B test identifier.
83
83
  */
84
84
  id: number;
85
85
  };
@@ -89,19 +89,19 @@ export type GetABTestProps = {
89
89
  */
90
90
  export type ListABTestsProps = {
91
91
  /**
92
- * Position of the starting record. Used for paging. 0 is the first record.
92
+ * Position of the first item to return.
93
93
  */
94
94
  offset?: number;
95
95
  /**
96
- * Number of records to return (page size).
96
+ * Number of items to return.
97
97
  */
98
98
  limit?: number;
99
99
  /**
100
- * Only return A/B tests for indices starting with this prefix.
100
+ * Index name prefix. Only A/B tests for indices starting with this string are included in the response.
101
101
  */
102
102
  indexPrefix?: string;
103
103
  /**
104
- * Only return A/B tests for indices ending with this suffix.
104
+ * Index name suffix. Only A/B tests for indices ending with this string are included in the response.
105
105
  */
106
106
  indexSuffix?: string;
107
107
  };
@@ -111,7 +111,7 @@ export type ListABTestsProps = {
111
111
  */
112
112
  export type StopABTestProps = {
113
113
  /**
114
- * Unique A/B test ID.
114
+ * Unique A/B test identifier.
115
115
  */
116
116
  id: number;
117
117
  };
@@ -1,6 +1,6 @@
1
1
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
2
 
3
- export type CurrenciesValue = {
3
+ export type Currency = {
4
4
  /**
5
5
  * Currency code.
6
6
  */
@@ -1,7 +1,7 @@
1
1
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
2
 
3
3
  /**
4
- * Applies search parameters from [a restricted set of options](https://www.algolia.com/doc/api-reference/api-methods/add-ab-test/#method-param-customsearchparameters). Only use this parameter if the two variants use the same index.
4
+ * Search parameters to add to the test variant. Only use this parameter if the two variants use the same index.
5
5
  */
6
6
  export type CustomSearchParams = {
7
7
  customSearchParameters: Record<string, any>;
@@ -0,0 +1,10 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ /**
4
+ * Metric for which you want to detect the smallest relative difference.
5
+ */
6
+ export type Effect =
7
+ | 'addToCartRate'
8
+ | 'clickThroughRate'
9
+ | 'conversionRate'
10
+ | 'purchaseRate';
@@ -0,0 +1,11 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ /**
4
+ * Configuration for handling empty searches.
5
+ */
6
+ export type EmptySearch = {
7
+ /**
8
+ * Whether to exclude empty searches when calculating A/B test results.
9
+ */
10
+ exclude?: boolean;
11
+ };
package/model/index.ts CHANGED
@@ -1,17 +1,23 @@
1
1
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
2
 
3
3
  export * from './aBTest';
4
+ export * from './aBTestConfiguration';
4
5
  export * from './aBTestResponse';
5
6
  export * from './abTestsVariant';
6
7
  export * from './abTestsVariantSearchParams';
7
8
  export * from './addABTestsRequest';
8
9
  export * from './addABTestsVariant';
9
- export * from './currenciesValue';
10
+ export * from './currency';
10
11
  export * from './customSearchParams';
12
+ export * from './effect';
13
+ export * from './emptySearch';
11
14
  export * from './errorBase';
12
15
  export * from './filterEffects';
13
16
  export * from './filterEffectsEmptySearch';
14
17
  export * from './filterEffectsOutliers';
15
18
  export * from './listABTestsResponse';
19
+ export * from './minimumDetectableEffect';
20
+ export * from './outliers';
21
+ export * from './status';
16
22
  export * from './variant';
17
23
  export * from './clientMethodProps';
@@ -6,10 +6,10 @@ export type ListABTestsResponse = {
6
6
  /**
7
7
  * A/B tests.
8
8
  */
9
- abtests: ABTest[];
9
+ abtests: ABTest[] | null;
10
10
 
11
11
  /**
12
- * Number of A/B tests implemented.
12
+ * Number of A/B tests.
13
13
  */
14
14
  count: number;
15
15
 
@@ -0,0 +1,15 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ import type { Effect } from './effect';
4
+
5
+ /**
6
+ * Configuration for the smallest difference between test variants you want to detect.
7
+ */
8
+ export type MinimumDetectableEffect = {
9
+ /**
10
+ * Smallest difference in an observable metric between variants. For example, to detect a 10% difference between variants, set this value to 0.1.
11
+ */
12
+ size?: number;
13
+
14
+ effect?: Effect;
15
+ };
@@ -0,0 +1,11 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ /**
4
+ * Configuration for handling outliers.
5
+ */
6
+ export type Outliers = {
7
+ /**
8
+ * Whether to exclude outliers when calculating A/B test results.
9
+ */
10
+ exclude?: boolean;
11
+ };
@@ -0,0 +1,6 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ /**
4
+ * A/B test status. - `active`. The A/B test is live and search traffic is split between the two variants. - `stopped`. You stopped the A/B test. The A/B test data is still available for analysis. - `expired`. The A/B test was automatically stopped after reaching its end date. - `failed`. Creating the A/B test failed.
5
+ */
6
+ export type Status = 'active' | 'expired' | 'failed' | 'stopped';