Improve Settings

src/meilisearch.ts

@@ -28,6 +28,7 @@
   ExtraRequestInit,
   Network,
   RecordAny,
+  RuntimeTogglableFeatures,
 } from "./types/index.js";
 import { ErrorStatusCode } from "./types/index.js";
 import { HttpRequests } from "./http-requests.js";
@@ -454,4 +455,25 @@
       path: "snapshots",
     });
   }
+
+  ///
+  /// EXPERIMENTAL-FEATURES
+  ///
+
+  /** {@link https://www.meilisearch.com/docs/reference/api/experimental_features#get-all-experimental-features} */
+  async getExperimentalFeatures(): Promise<RuntimeTogglableFeatures> {
+    return await this.httpRequest.get({
+      path: "experimental-features",
+    });
+  }
+
+  /** {@link https://www.meilisearch.com/docs/reference/api/experimental_features#configure-experimental-features} */
+  async updateExperimentalFeatures(
+    runtimeTogglableFeatures: RuntimeTogglableFeatures,
+  ): Promise<RuntimeTogglableFeatures> {
+    return await this.httpRequest.patch({
+      path: "experimental-features",
+      body: runtimeTogglableFeatures,
+    });
+  }
 }

src/settings.ts

@@ -0,0 +1,66 @@
+import type { HttpRequests } from "./http-requests.js";
+import type { HttpRequestsWithEnqueuedTaskPromise } from "./task.js";
+import type {
+  EnqueuedTaskPromise,
+  SingleUpdatableSettings,
+  RecordAny,
+} from "./types/index.js";
+
+/** Each setting property mapped to their REST method required for updates. */
+type MakeSettingsRecord = {
+  [TKey in keyof SingleUpdatableSettings]: "put" | "patch";
+};
+
+/** Each setting property mapped to its get, update and reset functions. */
+export type SettingFns = {
+  [TKey in keyof SingleUpdatableSettings as `get${Capitalize<TKey>}`]: () => Promise<
+    SingleUpdatableSettings[TKey]
+  >;
+} & {
+  [TKey in keyof SingleUpdatableSettings as `update${Capitalize<TKey>}`]: (
+    body: SingleUpdatableSettings[TKey],
+  ) => EnqueuedTaskPromise;
+} & {
+  [TKey in keyof SingleUpdatableSettings as `reset${Capitalize<TKey>}`]: () => EnqueuedTaskPromise;
+};
+
+function capitalize(str: string): string {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+function camelToKebabCase(str: string): string {
+  return str.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+
+/** Returns an object containing all the setting functions. */
+export function makeSettingFns(
+  httpRequest: HttpRequests,
+  httpRequestsWithTask: HttpRequestsWithEnqueuedTaskPromise,
+  basePath: string,
+  opts: MakeSettingsRecord,
+): SettingFns {
+  const settingFns = {} as RecordAny;
+
+  for (const [name, method] of Object.entries(opts)) {
+    const uppercaseName = capitalize(name);
+    const path = `${basePath}/${camelToKebabCase(name)}`;
+
+    settingFns[`get${uppercaseName}`] = async function (): Promise<
+      SingleUpdatableSettings[keyof typeof opts]
+    > {
+      return await httpRequest.get({ path });
+    };
+
+    settingFns[`update${uppercaseName}`] = function (
+      body: SingleUpdatableSettings[keyof typeof opts],
+    ): EnqueuedTaskPromise {
+      return httpRequestsWithTask[method]({ path, body });
+    };
+
+    settingFns[`reset${uppercaseName}`] = function (): EnqueuedTaskPromise {
+      return httpRequestsWithTask.delete({ path });
+    };
+  }
+
+  return settingFns as SettingFns;
+}

src/types/experimental-features.ts

@@ -0,0 +1,14 @@
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/experimental_features#experimental-features-object}
+ *
+ * @see `meilisearch::routes::features::RuntimeTogglableFeatures`
+ */
+export type RuntimeTogglableFeatures = {
+  metrics?: boolean | null;
+  logsRoute?: boolean | null;
+  editDocumentsByFunction?: boolean | null;
+  containsFilter?: boolean | null;
+  network?: boolean | null;
+  getTaskDocumentsRoute?: boolean | null;
+  compositeEmbedders?: boolean | null;
+};

src/types/index.ts

@@ -1,3 +1,5 @@
+export * from "./experimental-features.js";
+export * from "./settings.js";
 export * from "./task_and_batch.js";
 export * from "./token.js";
 export * from "./types.js";

src/types/settings.ts

@@ -0,0 +1,224 @@
+import type { PascalToCamelCase } from "./shared.js";
+
+/** @see `milli::filterable_attributes_rules::FilterFeatures` */
+export type FilterFeatures = {
+  equality?: boolean;
+  comparison?: boolean;
+};
+
+/** @see `milli::filterable_attributes_rules::FilterableAttributesFeatures` */
+export type FilterableAttributesFeatures = {
+  facetSearch?: boolean;
+  filter?: FilterFeatures;
+};
+
+/** @see `milli::filterable_attributes_rules::FilterableAttributesPatterns` */
+export type FilterableAttributesPatterns = {
+  attributePatterns: string[];
+  features?: FilterableAttributesFeatures;
+};
+
+/** @see `milli::filterable_attributes_rules::FilterableAttributesRule` */
+export type FilterableAttributesRule = string | FilterableAttributesPatterns;
+
+/** Deeply map every property of a record to itself excluding null. */
+type NonNullableDeepRecordValues<T> = {
+  [TKey in keyof T]: Exclude<NonNullableDeepRecordValues<T[TKey]>, null>;
+};
+
+/** Map properties of a record to be optional and nullable. */
+type PartialAndNullable<T> = { [P in keyof T]?: T[P] | null };
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#proximity-precision}
+ *
+ * @see `meilisearch_types::settings::ProximityPrecisionView`
+ */
+export type ProximityPrecisionView = PascalToCamelCase<
+  "ByWord" | "ByAttribute"
+>;
+
+/**
+ * @see `minWordSizeForTypos` at {@link https://www.meilisearch.com/docs/reference/api/settings#typo-tolerance}
+ *
+ * @see `meilisearch_types::settings::MinWordSizeTyposSetting`
+ */
+export type MinWordSizeTyposSetting = PartialAndNullable<{
+  oneTypo: number;
+  twoTypos: number;
+}>;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#typo-tolerance}
+ *
+ * @see `meilisearch_types::settings::TypoSettings`
+ */
+export type TypoSettings = PartialAndNullable<{
+  enabled: boolean;
+  minWordSizeForTypos: MinWordSizeTyposSetting;
+  disableOnWords: string[];
+  disableOnAttributes: string[];
+}>;
+
+/**
+ * @see `sortFacetValuesBy` at {@link https://www.meilisearch.com/docs/reference/api/settings#faceting}
+ * @see `meilisearch_types::facet_values_sort::FacetValuesSort`
+ */
+export type FacetValuesSort = PascalToCamelCase<"Alpha" | "Count">;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#faceting}
+ *
+ * @see `meilisearch_types::settings::FacetingSettings`
+ */
+export type FacetingSettings = PartialAndNullable<{
+  maxValuesPerFacet: number;
+  sortFacetValuesBy: Record<string, FacetValuesSort>;
+}>;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#pagination}
+ *
+ * @see `meilisearch_types::settings::PaginationSettings`
+ */
+export type PaginationSettings = PartialAndNullable<{ maxTotalHits: number }>;
+
+/**
+ * `distribution` at
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#embedders}
+ *
+ * @see `milli::vector::DistributionShift`
+ */
+export type DistributionShift = {
+  mean: number;
+  sigma: number;
+};
+
+/**
+ * `source` at
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#embedders}
+ *
+ * @see `milli::vector::settings::EmbedderSource`
+ */
+export type EmbedderSource = PascalToCamelCase<
+  "OpenAi" | "HuggingFace" | "Ollama" | "UserProvided" | "Rest" | "Composite"
+>;
+
+/** @see `milli::vector::hf::OverridePooling` */
+export type OverridePooling = PascalToCamelCase<
+  "UseModel" | "ForceCls" | "ForceMean"
+>;
+
+/** @see `milli::vector::settings::SubEmbeddingSettings` */
+export type SubEmbeddingSettings = PartialAndNullable<{
+  source: EmbedderSource;
+  model: string;
+  revision: string;
+  pooling: OverridePooling;
+  apiKey: string;
+  dimensions: number;
+  documentTemplate: string;
+  documentTemplateMaxBytes: number;
+  url: string;
+  request: unknown;
+  response: unknown;
+  headers: Record<string, string>;
+}>;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#embedders}
+ *
+ * @see `milli::vector::settings::EmbeddingSettings`
+ */
+export type EmbeddingSettings = PartialAndNullable<{
+  distribution: DistributionShift;
+  binaryQuantized: boolean;
+  searchEmbedder: SubEmbeddingSettings;
+  indexingEmbedder: SubEmbeddingSettings;
+}> &
+  SubEmbeddingSettings;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#localized-attributes}
+ *
+ * @see `meilisearch_types::locales::LocalizedAttributesRuleView`
+ */
+export type LocalizedAttributesRuleView = {
+  /** @see `milli::attribute_patterns::AttributePatterns` */
+  attributePatterns: string[];
+  /** @see `meilisearch_types::locales::Locale` */
+  locales: string[];
+};
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#prefix-search}
+ *
+ * @see `meilisearch_types::settings::PrefixSearchSettings`
+ */
+export type PrefixSearchSettings = PascalToCamelCase<
+  "IndexingTime" | "Disabled"
+>;
+
+/** @see `meilisearch_types::settings::RankingRuleView` */
+export type RankingRuleView =
+  | PascalToCamelCase<
+      "Words" | "Typo" | "Proximity" | "Attribute" | "Sort" | "Exactness"
+    >
+  | `${string}:${"asc" | "desc"}`;
+
+/** A version of {@link Settings} that can be used to update the settings. */
+export type UpdatableSettings = PartialAndNullable<{
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#displayed-attributes} */
+  displayedAttributes: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#searchable-attributes} */
+  searchableAttributes: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#filterable-attributes} */
+  filterableAttributes: FilterableAttributesRule[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#sortable-attributes} */
+  sortableAttributes: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#ranking-rules} */
+  rankingRules: RankingRuleView[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#stop-words} */
+  stopWords: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#non-separator-tokens} */
+  nonSeparatorTokens: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#separator-tokens} */
+  separatorTokens: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#dictionary} */
+  dictionary: string[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#synonyms} */
+  synonyms: Record<string, string[]>;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#distinct-attribute} */
+  distinctAttribute: string;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#proximity-precision} */
+  proximityPrecision: ProximityPrecisionView;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#typo-tolerance} */
+  typoTolerance: TypoSettings;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#faceting} */
+  faceting: FacetingSettings;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#pagination} */
+  pagination: PaginationSettings;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#embedders} */
+  embedders: PartialAndNullable<Record<string, EmbeddingSettings>>;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#search-cutoff} */
+  searchCutoffMs: number;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#localized-attributes} */
+  localizedAttributes: LocalizedAttributesRuleView[];
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#facet-search} */
+  facetSearch: boolean;
+  /** {@link https://www.meilisearch.com/docs/reference/api/settings#prefix-search} */
+  prefixSearch: PrefixSearchSettings;
+}>;
+
+/**
+ * A version of {@link UpdatableSettings}, the first layer of properties of which
+ * is used to update or get individual settings.
+ */
+export type SingleUpdatableSettings = Required<UpdatableSettings>;
+
+/**
+ * {@link https://www.meilisearch.com/docs/reference/api/settings#body}
+ *
+ * @see `meilisearch_types::settings::Settings`
+ */
+export type Settings = NonNullableDeepRecordValues<UpdatableSettings>;

src/types/shared.ts

@@ -1,5 +1,3 @@
-import type { RecordAny } from "./types.js";
-
 export type CursorResults<T> = {
   results: T[];
   limit: number;
@@ -8,11 +6,5 @@ export type CursorResults<T> = {
   total: number;
 };
 
-export type NonNullableDeepRecordValues<T> = {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [P in keyof T]: T[P] extends any[]
-    ? Array<NonNullableDeepRecordValues<T[P][number]>>
-    : T[P] extends RecordAny
-      ? NonNullableDeepRecordValues<T[P]>
-      : NonNullable<T[P]>;
-};
+// taken from https://stackoverflow.com/a/65642944
+export type PascalToCamelCase<S extends string> = Uncapitalize<S>;

src/types/task_and_batch.ts

@@ -1,4 +1,4 @@
-import type { Settings } from "./types.js";
+import type { UpdatableSettings } from "./settings.js";
 import type { CursorResults } from "./shared.js";
 import type { MeiliSearchErrorResponse } from "./types.js";
 
@@ -97,7 +97,7 @@ export type TaskUidOrEnqueuedTask = EnqueuedTask["taskUid"] | EnqueuedTask;
 export type IndexSwap = { indexes: [string, string] };
 
 /** {@link https://www.meilisearch.com/docs/reference/api/tasks#details} */
-export type TaskDetails = Settings & {
+export type TaskDetails = UpdatableSettings & {
   receivedDocuments?: number;
   indexedDocuments?: number;
   editedDocuments?: number;