Ajout du dossier tools

tools/cargo_cmd_arch.sh

@@ -0,0 +1,8 @@
+case $TARGETARCH in
+  "amd64")
+    echo "./mold/bin/mold -run cargo"
+    ;;
+  "arm64")
+    echo "cargo"
+    ;;
+esac

tools/clean-old-rocksdb-logs.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+
+# Clean old RocksDB log files, always leave the last two.
+#
+# On invocation, the script will prompt whether to run in dry mode.
+#
+# Script MUST be run in the ./storage directory of Qdrant.
+
+# Number of newest old logs to keep
+KEEP_N=2
+DRY=1
+CLEAN_COUNT=0
+
+set -e
+
+function main {
+    # Ensure script is run in storage directory
+    if [[ "$(basename "$(pwd)")" != "storage" ]]; then
+        echo Error: script must be run in ./storage directory
+        echo Currently in "$(pwd)"
+        exit 1
+    fi
+
+    echo This script removes old and obsolete log files to clean up disk space.
+    echo It is potentionally dangerous. Always make sure you have a backup before running this.
+    echo Qdrant must be stopped before running this script.
+
+    # Ask for dry run
+    yes_or_no "Dry run?" || DRY=0
+
+    # Confirmation
+    if [[ $DRY == 0 ]]; then
+        yes_or_no "Are you sure you want to continue?" || (echo "Aborted"; exit 1)
+    fi
+
+    # Go through collections/shards/segments to clean
+    for collection in $(find collections/* -maxdepth 0 -type d); do
+        echo "Cleaning collection: $collection"
+        for shard in $(find $collection/* -maxdepth 0 -type d); do
+            for segment in $(find $shard/segments/* -maxdepth 0 -type d); do
+                clean_segment "$segment"
+            done
+        done
+    done
+
+    echo Cleaned $CLEAN_COUNT old log files
+}
+
+function yes_or_no {
+    while true; do
+        read -p "$* [y/n]: " yn
+        case $yn in
+            [Yy]*) return 0 ;;
+            [Nn]*) return 1 ;;
+        esac
+    done
+}
+
+function clean_segment {
+    remove_oldest_logs_in "$segment"
+
+    if [[ -d "$segment/payload_index" ]]; then
+        remove_oldest_logs_in "$segment/payload_index"
+    fi
+}
+
+function remove_oldest_logs_in {
+    FILES=$(find "$1" -maxdepth 1 -name 'LOG.old.*' | sort -n | head -n -${KEEP_N})
+    CLEAN_COUNT=$((CLEAN_COUNT + $(echo "$FILES" | wc -w)))
+    remove $FILES
+}
+
+function remove {
+    if [[ -z "$*" ]]; then
+        return
+    fi
+
+    echo "+ rm -f" $*
+    if [[ $DRY == 0 ]]; then
+        rm -f $*
+    fi
+}
+
+main

tools/entrypoint.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Script to run qdrant in docker container and handle contingencies, like OOM.
+# The functioning logic is as follows:
+# - If recovery mode is allowed, we check if qdrant was killed during initialization or not.
+#   - If it was killed during initialization, we remove run qdrant in recovery mode
+#   - If it was killed after initialization, do nothing and restart container
+# - If recovery mode is not allowed, we just restart container
+
+_term () {
+  kill -TERM "$QDRANT_PID" 2>/dev/null
+}
+
+trap _term SIGTERM
+
+_interrupt () {
+  kill -INT "$QDRANT_PID" 2>/dev/null
+}
+
+trap _interrupt SIGINT
+
+./qdrant $@ &
+
+# Get PID for the traps
+QDRANT_PID=$!
+wait $QDRANT_PID
+
+EXIT_CODE=$?
+
+QDRANT_ALLOW_RECOVERY_MODE=${QDRANT_ALLOW_RECOVERY_MODE:-false}
+
+# Check that recovery mode is allowed
+if [ "$QDRANT_ALLOW_RECOVERY_MODE" != true ]; then
+    exit $EXIT_CODE
+fi
+
+# Check that qdrant was killed (exit code 137)
+# Ideally, we want to catch only OOM, but it's not possible to distinguish it from random kill signal
+if [ $EXIT_CODE != 137 ]; then
+    exit $EXIT_CODE
+fi
+
+QDRANT_INIT_FILE_PATH=${QDRANT_INIT_FILE_PATH:-'.qdrant-initialized'}
+RECOVERY_MESSAGE="Qdrant was killed during initialization. Most likely it's Out-of-Memory.
+Please check memory consumption, increase memory limit or remove some collections and restart"
+
+# Check that qdrant was initialized
+# Qdrant creates QDRANT_INIT_FILE_PATH file after initialization
+# So if it doesn't exist, qdrant was killed during initialization
+if [ ! -f "$QDRANT_INIT_FILE_PATH" ]; then
+    # Run qdrant in recovery mode.
+    # No collection operations are allowed in recovery mode except for removing collections
+    QDRANT__STORAGE__RECOVERY_MODE="$RECOVERY_MESSAGE" ./qdrant $@ &
+    # Get PID for the traps
+    QDRANT_PID=$!
+    wait $QDRANT_PID
+    exit $?
+fi
+
+exit $EXIT_CODE

tools/generate_docker_compose_cluster.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+
+# Generate a docker-compose configuration for a cluster.
+#
+# Parameters:
+# - $1: number of nodes (default: 5)
+# - $2: base port (default: 6330)
+#
+# Example usage:
+# ./generate_docker_compose_cluster.sh 5 > docker-compose.yaml
+
+set -euo pipefail
+
+declare NODES="${1:-5}"
+declare BASE_PORT="${2:-6330}"
+
+cat <<-EOF
+version: "3.7"
+
+services:
+EOF
+
+for ((node=0; node<NODES; node++))
+do
+	declare SERVICE_NAME=qdrant_node_$node
+
+	declare HTTP_PORT=$((BASE_PORT + node * 10 + 3))
+	declare GRPC_PORT=$((BASE_PORT + node * 10 + 4))
+
+	if ((node == 0))
+	then
+		declare COMMAND="./qdrant --uri 'http://$SERVICE_NAME:6335'"
+	else
+		declare COMMAND="bash -c \"sleep $((10 + node / 10 + RANDOM % 10)) && ./qdrant --bootstrap 'http://qdrant_node_0:6335' --uri 'http://$SERVICE_NAME:6335'\""
+	fi
+
+	cat <<-EOF
+	  $SERVICE_NAME:
+	    image: qdrant/qdrant:latest
+	    command: $COMMAND
+	    restart: always
+	    environment:
+	      - QDRANT__SERVICE__GRPC_PORT=6334
+	      - QDRANT__CLUSTER__ENABLED=true
+	      - QDRANT__CLUSTER__P2P__PORT=6335
+	      - QDRANT__CLUSTER__CONSENSUS__MAX_MESSAGE_QUEUE_SIZE=5000
+	      - QDRANT__LOG_LEVEL=debug,raft=info
+	    ports:
+	      - "$HTTP_PORT:6333"
+	      - "$GRPC_PORT:6334"
+	    deploy:
+	      resources:
+	        limits:
+	          cpus: "0.3"
+
+	EOF
+done

tools/generate_grpc_docs.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+set -e
+
+# Ensure current path is project root
+cd "$(dirname "$0")/../"
+
+# Create a temporary directory and store its name in a variable.
+TEMPD=$(mktemp -d -t qdrant_docs.XXXXXXXXXX)
+trap 'rm -rf -- "$TEMPD"' EXIT
+
+cp -r "$PWD"/lib/api/src/grpc/proto/* "$TEMPD"
+
+# Do not generate docs for internal services
+rm "$TEMPD/collections_internal_service.proto"
+rm "$TEMPD/points_internal_service.proto"
+rm "$TEMPD/shard_snapshots_service.proto"
+rm "$TEMPD/raft_service.proto"
+
+cat "$TEMPD/qdrant.proto" \
+  | grep -v 'collections_internal_service.proto' \
+  | grep -v 'points_internal_service.proto' \
+  | grep -v 'shard_snapshots_service.proto' \
+  | grep -v 'raft_service.proto'\
+   > "$TEMPD/qdrant.proto.tmp"
+mv "$TEMPD/qdrant.proto.tmp" "$TEMPD/qdrant.proto"
+
+docker run --rm \
+  -u "$(id -u):$(id -g)" \
+  -v "$PWD/docs/grpc":/out \
+  -v "$TEMPD":/protos \
+  pseudomuto/protoc-gen-doc --doc_opt=markdown,docs.md

tools/generate_openapi_models.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# This script generate model definitions for OpenAPI 3.0 documentation
+
+set -e
+
+# Ensure current path is project root
+cd "$(dirname "$0")/../"
+
+# Fallback to dockerized utilities if they are not installed locally
+
+if command -v ytt &>/dev/null; then
+    sh_with_ytt() { sh -c "$1"; }
+else
+    sh_with_ytt() { docker run --rm -v "${PWD}":/workspace --entrypoint sh gerritk/ytt -c "$1"; }
+fi
+
+if ! yq --version 2>&1 | grep -q mikefarah; then
+    yq() { docker run --rm -v "${PWD}":/workdir mikefarah/yq "$@"; }
+fi
+
+# Apply `ytt` template engine to obtain OpenAPI definitions for REST endpoints
+
+sh_with_ytt '
+    set -e
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-shards.ytt.yaml > ./openapi/openapi-shards.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-service.ytt.yaml > ./openapi/openapi-service.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-cluster.ytt.yaml > ./openapi/openapi-cluster.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-collections.ytt.yaml > ./openapi/openapi-collections.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-snapshots.ytt.yaml > ./openapi/openapi-snapshots.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-shard-snapshots.ytt.yaml > ./openapi/openapi-shard-snapshots.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-points.ytt.yaml > ./openapi/openapi-points.yaml
+    ytt -f ./openapi/openapi.lib.yml -f ./openapi/openapi-main.ytt.yaml > ./openapi/openapi-main.yaml
+'
+
+# Generates models from internal service structures
+cargo run --package qdrant --bin schema_generator > ./openapi/schemas/AllDefinitions.json
+
+docker build tools/schema2openapi --tag schema2openapi
+
+docker run --rm \
+    -v "$PWD/openapi/schemas/AllDefinitions.json:/app/schema.json" \
+    schema2openapi | sed -e 's%#/definitions/%#/components/schemas/%g' >./openapi/models.json
+
+yq eval -o yaml -P ./openapi/models.json > ./openapi/models.yaml
+
+# Merge all *.yaml files together into a single-file OpenAPI definition
+yq eval-all '. as $item ireduce ({}; . *+ $item)' \
+  ./openapi/openapi-shards.yaml \
+  ./openapi/openapi-service.yaml \
+  ./openapi/openapi-cluster.yaml \
+  ./openapi/openapi-collections.yaml \
+  ./openapi/openapi-snapshots.yaml \
+  ./openapi/openapi-shard-snapshots.yaml \
+  ./openapi/openapi-points.yaml \
+  ./openapi/openapi-main.yaml \
+  ./openapi/models.yaml > ./openapi/openapi-merged.yaml
+
+docker run --rm -v "${PWD}"/openapi:/spec redocly/openapi-cli:v1.0.0-beta.88 lint openapi-merged.yaml
+
+yq eval -o=json ./openapi/openapi-merged.yaml | jq > ./openapi/openapi-merged.json
+
+cp ./openapi/openapi-merged.json ./docs/redoc/master/openapi.json

tools/missed_cherry_picks.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# List all commits that have not been cherry-picked from dev into master yet
+#
+# Example usage:
+# ./missed_cherry_picks.sh
+
+set -euo pipefail
+
+# Ignore all commits upto and including this commit hash on dev
+IGNORE_UPTO=9d83ef2a6d24cfc5b8c5a504d71710fecabfc7fe
+
+# Fetch latest branch info from remote
+git fetch -q origin master
+git fetch -q origin dev
+
+# Get remote/local commit hash of dev, user must have up-to-date branch
+REMOTE_SHA=$(git log -n 1 --pretty=format:"%H" origin/dev)
+LOCAL_SHA=$(git log -n 1 --pretty=format:"%H" dev)
+if [[ "$REMOTE_SHA" != "$LOCAL_SHA" ]]; then
+    echo Error: your local dev branch must match the current remote
+    echo To pull latest dev, use: git checkout dev \&\& git pull --ff-only origin dev
+    exit 1
+fi
+
+# List all commits yet-to-be-cherry-picked
+git cherry -v origin/master origin/dev $IGNORE_UPTO \
+| grep --color=never '^+ ' \
+| cut -d' ' -f2-

tools/nix/npins/default.nix

@@ -0,0 +1,80 @@
+# Generated by npins. Do not modify; will be overwritten regularly
+let
+  data = builtins.fromJSON (builtins.readFile ./sources.json);
+  version = data.version;
+
+  mkSource =
+    spec:
+    assert spec ? type;
+    let
+      path =
+        if spec.type == "Git" then
+          mkGitSource spec
+        else if spec.type == "GitRelease" then
+          mkGitSource spec
+        else if spec.type == "PyPi" then
+          mkPyPiSource spec
+        else if spec.type == "Channel" then
+          mkChannelSource spec
+        else
+          builtins.throw "Unknown source type ${spec.type}";
+    in
+    spec // { outPath = path; };
+
+  mkGitSource =
+    {
+      repository,
+      revision,
+      url ? null,
+      hash,
+      branch ? null,
+      ...
+    }:
+    assert repository ? type;
+    # At the moment, either it is a plain git repository (which has an url), or it is a GitHub/GitLab repository
+    # In the latter case, there we will always be an url to the tarball
+    if url != null then
+      (builtins.fetchTarball {
+        inherit url;
+        sha256 = hash; # FIXME: check nix version & use SRI hashes
+      })
+    else
+      assert repository.type == "Git";
+      let
+        urlToName =
+          url: rev:
+          let
+            matched = builtins.match "^.*/([^/]*)(\\.git)?$" repository.url;
+
+            short = builtins.substring 0 7 rev;
+
+            appendShort = if (builtins.match "[a-f0-9]*" rev) != null then "-${short}" else "";
+          in
+          "${if matched == null then "source" else builtins.head matched}${appendShort}";
+        name = urlToName repository.url revision;
+      in
+      builtins.fetchGit {
+        url = repository.url;
+        rev = revision;
+        inherit name;
+        # hash = hash;
+      };
+
+  mkPyPiSource =
+    { url, hash, ... }:
+    builtins.fetchurl {
+      inherit url;
+      sha256 = hash;
+    };
+
+  mkChannelSource =
+    { url, hash, ... }:
+    builtins.fetchTarball {
+      inherit url;
+      sha256 = hash;
+    };
+in
+if version == 3 then
+  builtins.mapAttrs (_: mkSource) data.pins
+else
+  throw "Unsupported format version ${toString version} in sources.json. Try running `npins upgrade`"

tools/nix/npins/sources.json

@@ -0,0 +1,35 @@
+{
+  "pins": {
+    "fenix": {
+      "type": "Git",
+      "repository": {
+        "type": "GitHub",
+        "owner": "nix-community",
+        "repo": "fenix"
+      },
+      "branch": "main",
+      "revision": "cdfd7bf3e3edaf9e3f6d1e397d3ee601e513613c",
+      "url": "https://github.com/nix-community/fenix/archive/cdfd7bf3e3edaf9e3f6d1e397d3ee601e513613c.tar.gz",
+      "hash": "1h9p1s3bkrilyafx15qzb5y5m6wdip9iiykv5mgbl48vhvgip2c3"
+    },
+    "nixpkgs": {
+      "type": "Channel",
+      "name": "nixpkgs-unstable",
+      "url": "https://releases.nixos.org/nixpkgs/nixpkgs-24.11pre688989.e2f08f4d8b3e/nixexprs.tar.xz",
+      "hash": "14hxnbnm41j3px7819dqzmfnqpalgxcnxy7gk8qi0lyyjgzjf103"
+    },
+    "poetry2nix": {
+      "type": "Git",
+      "repository": {
+        "type": "GitHub",
+        "owner": "nix-community",
+        "repo": "poetry2nix"
+      },
+      "branch": "master",
+      "revision": "ef877b8e159b23f36ebc39155021657bed744a68",
+      "url": "https://github.com/nix-community/poetry2nix/archive/ef877b8e159b23f36ebc39155021657bed744a68.tar.gz",
+      "hash": "1kgfnxrji87fdh0vjldkskcs2cnizghsbczdakhxak1y1kk0njff"
+    }
+  },
+  "version": 3
+}

tools/nix/update.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+
+import argparse
+import hashlib
+import json
+import pathlib
+import re
+import shlex
+import shutil
+import subprocess
+import sys
+import tomllib
+import urllib.request
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Update the versions.json and nix dependencies",
+    )
+    parser.add_argument(
+        "--nix",
+        action=argparse.BooleanOptionalAction,
+        default=True,
+        help="update nix dependencies by running `npins update` (default: yes)",
+    )
+    parser.add_argument(
+        "--nightly",
+        type=str,
+        help="nightly version, e.g. 2021-01-01 (default: use latest)",
+    )
+    parser.add_argument(
+        "--stable",
+        type=str,
+        help="stable version, e.g. 1.76.0 (default: use latest)",
+    )
+    args = parser.parse_args()
+
+    if args.nix:
+        if shutil.which("npins") is not None:
+            command = ["npins", "update"]
+        else:
+            command = ["nix-shell", "-p", "npins", "--run", "npins update"]
+        print(f"Running {shlex.join(command)}", file=sys.stderr)
+        subprocess.run(
+            args=command,
+            cwd=pathlib.Path(__file__).parent,
+            check=True,
+        )
+
+    print("Updating versions.json", file=sys.stderr)
+    d = f"{args.nightly}/" if args.nightly else ""
+    url = f"https://static.rust-lang.org/dist/{d}channel-rust-nightly.toml"
+    with urllib.request.urlopen(url) as response:
+        data = response.read()
+    nightly_sha256 = hashlib.sha256(data).digest().hex()
+    nightly_date = tomllib.loads(data.decode("utf-8"))["date"]
+
+    d = args.stable if args.stable else "stable"
+    url = f"https://static.rust-lang.org/dist/channel-rust-{d}.toml"
+    with urllib.request.urlopen(url) as response:
+        data = response.read()
+    stable_sha256 = hashlib.sha256(data).digest().hex()
+    stable_version = tomllib.loads(data.decode("utf-8"))["pkg"]["rust"]["version"]
+    m = re.match(r"^(\d+\.\d+\.\d+) \(.*\)$", stable_version)
+    if not m:
+        raise ValueError(f"Failed to parse stable version: {stable_version}")
+    stable_version = m[1]
+
+    result = {
+        "#": "This file is autogenerated by ./update.py",
+        "nightly": {
+            "date": nightly_date,
+            "sha256": nightly_sha256,
+        },
+        "stable": {
+            "version": stable_version,
+            "sha256": stable_sha256,
+        },
+    }
+
+    with open(pathlib.Path(__file__).parent / "versions.json", "w") as f:
+        f.write(json.dumps(result, indent=2) + "\n")
+
+
+if __name__ == "__main__":
+    main()

tools/nix/versions.json

@@ -0,0 +1,11 @@
+{
+  "#": "This file is autogenerated by ./update.py",
+  "nightly": {
+    "date": "2024-10-05",
+    "sha256": "6602972eedaba88e29e24197e471b6fac66e605868d6f2e387a68b636d5ea0f2"
+  },
+  "stable": {
+    "version": "1.81.0",
+    "sha256": "5596679723faf7e63772bacb1d0c898abaa51eb4ed193b328929d907c8c4bd5a"
+  }
+}

tools/schema2openapi/Dockerfile

@@ -0,0 +1,9 @@
+FROM node:lts-alpine
+
+WORKDIR /app
+
+COPY . .
+
+RUN npm install
+
+CMD ["node", "convert.js"]

tools/schema2openapi/convert.js

@@ -0,0 +1,52 @@
+const toOpenApi = require('@openapi-contrib/json-schema-to-openapi-schema');
+
+const fs = require('fs');
+
+let rawdata = fs.readFileSync('schema.json');
+
+let schema = JSON.parse(rawdata);
+
+// Generated result contains usage of "allOf" directive with a single class.
+// It breaks client generator serves no function.
+// This function should replace "allOf" directives with simple class usages
+function replaceAllOf(schema) {
+    if (Array.isArray(schema)) {
+        var newSchema = [];
+        for (var k in schema) {
+            newSchema[k] = replaceAllOf(schema[k]);
+        }
+        return newSchema;
+    }
+    if (typeof schema === 'object' && schema !== null) {
+        var newSchema = {};
+        for (var k in schema) {
+            if (k === 'allOf' && schema[k].length === 1) {
+                newSchema = {...schema[k][0]};
+                break
+            } else {
+                newSchema[k] = replaceAllOf(schema[k]);
+            }
+        }
+        return newSchema;
+    }
+    return schema;
+}
+
+
+
+(async () => {
+    var convertedSchema = await toOpenApi(schema);
+
+    convertedSchema = replaceAllOf(convertedSchema);
+
+    for (var modelName in convertedSchema['definitions']) {
+        convertedSchema['definitions'][modelName]["$schema"] = schema["$schema"];
+        convertedSchema['definitions'][modelName] = await toOpenApi(convertedSchema['definitions'][modelName]);
+    }
+
+    console.log(JSON.stringify({components: {schemas: convertedSchema['definitions']}}, null, 4));
+})();
+
+
+
+

tools/schema2openapi/package-lock.json

@@ -0,0 +1,443 @@
+{
+  "name": "tools",
+  "version": "1.0.0",
+  "lockfileVersion": 2,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "tools",
+      "version": "1.0.0",
+      "license": "ISC",
+      "dependencies": {
+        "@openapi-contrib/json-schema-to-openapi-schema": "^1.3.0"
+      },
+      "devDependencies": {}
+    },
+    "node_modules/@cloudflare/json-schema-walker": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/@cloudflare/json-schema-walker/-/json-schema-walker-0.1.1.tgz",
+      "integrity": "sha512-P3n0hEgk1m6uKWgL4Yb1owzXVG4pM70G4kRnDQxZXiVvfCRtaqiHu+ZRiRPzmwGBiLTO1LWc2yR1M8oz0YkXww=="
+    },
+    "node_modules/@openapi-contrib/json-schema-to-openapi-schema": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@openapi-contrib/json-schema-to-openapi-schema/-/json-schema-to-openapi-schema-1.3.0.tgz",
+      "integrity": "sha512-EaZoAT3U1oZObNQEiI1FDV1Lf/PHTkNCKtTVCOqdLY568iJfFV8nPvsKyKpUrmdCVJXtbNKeIrRFO2lJpa+EoA==",
+      "dependencies": {
+        "@cloudflare/json-schema-walker": "^0.1.1",
+        "@stoplight/json-ref-resolver": "^3.1.1",
+        "@stoplight/yaml": "^3.7.1",
+        "node-fetch": "^2.6.0",
+        "tslib": "^1.11.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@stoplight/json": {
+      "version": "3.18.1",
+      "resolved": "https://registry.npmjs.org/@stoplight/json/-/json-3.18.1.tgz",
+      "integrity": "sha512-QmELAqBS8DC+8YuG7+OvDVP6RaUVi8bzN0KKW2UEcZg+0a1sqeeZgfW079AmJIZg8HEN7udAt4iozIB8Dm0t1Q==",
+      "dependencies": {
+        "@stoplight/ordered-object-literal": "^1.0.2",
+        "@stoplight/types": "^13.0.0",
+        "jsonc-parser": "~2.2.1",
+        "lodash": "^4.17.21",
+        "safe-stable-stringify": "^1.1"
+      },
+      "engines": {
+        "node": ">=8.3.0"
+      }
+    },
+    "node_modules/@stoplight/json-ref-resolver": {
+      "version": "3.1.4",
+      "resolved": "https://registry.npmjs.org/@stoplight/json-ref-resolver/-/json-ref-resolver-3.1.4.tgz",
+      "integrity": "sha512-842JVmMsi++qpDuIX+JpQvK7YY8FXEZZb+/z4xuRfStOAVEryJT/tbgGOWxniSdxEl9Eni5D/I2afMyy6BuiNw==",
+      "dependencies": {
+        "@stoplight/json": "^3.17.0",
+        "@stoplight/path": "^1.3.2",
+        "@stoplight/types": "^12.3.0 || ^13.0.0",
+        "@types/urijs": "^1.19.19",
+        "dependency-graph": "~0.11.0",
+        "fast-memoize": "^2.5.2",
+        "immer": "^9.0.6",
+        "lodash": "^4.17.21",
+        "tslib": "^2.3.1",
+        "urijs": "^1.19.11"
+      },
+      "engines": {
+        "node": ">=8.3.0"
+      }
+    },
+    "node_modules/@stoplight/json-ref-resolver/node_modules/@stoplight/types": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@stoplight/types/-/types-13.2.0.tgz",
+      "integrity": "sha512-V3BRfzWEAcCpICGQh/WW2LX4rcB2KagQ7/msf0BDTCF5qpFMSwOxcjv25k1NUMVQSh3qwGfGoka/gYGA5m+NQA==",
+      "dependencies": {
+        "@types/json-schema": "^7.0.4",
+        "utility-types": "^3.10.0"
+      },
+      "engines": {
+        "node": "^12.20 || >=14.13"
+      }
+    },
+    "node_modules/@stoplight/json-ref-resolver/node_modules/tslib": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz",
+      "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ=="
+    },
+    "node_modules/@stoplight/json/node_modules/@stoplight/types": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/@stoplight/types/-/types-13.2.0.tgz",
+      "integrity": "sha512-V3BRfzWEAcCpICGQh/WW2LX4rcB2KagQ7/msf0BDTCF5qpFMSwOxcjv25k1NUMVQSh3qwGfGoka/gYGA5m+NQA==",
+      "dependencies": {
+        "@types/json-schema": "^7.0.4",
+        "utility-types": "^3.10.0"
+      },
+      "engines": {
+        "node": "^12.20 || >=14.13"
+      }
+    },
+    "node_modules/@stoplight/ordered-object-literal": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@stoplight/ordered-object-literal/-/ordered-object-literal-1.0.3.tgz",
+      "integrity": "sha512-cjJ7PPkhgTXNMTkevAlmyrx9xOOCaI3c6rEeYb6VitL1o1WcZtrz9KyFyISmTmUa7yYTiy2IS/ud9S8s2sn3+A==",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@stoplight/path": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/@stoplight/path/-/path-1.3.2.tgz",
+      "integrity": "sha512-lyIc6JUlUA8Ve5ELywPC8I2Sdnh1zc1zmbYgVarhXIp9YeAB0ReeqmGEOWNtlHkbP2DAA1AL65Wfn2ncjK/jtQ==",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@stoplight/types": {
+      "version": "11.9.0",
+      "resolved": "https://registry.npmjs.org/@stoplight/types/-/types-11.9.0.tgz",
+      "integrity": "sha512-4bzPpWZobt0e+d0OtALCJyl1HGzKo6ur21qxnId9dTl8v3yeD+5HJKZ2h1mv7e94debH5QDtimMU80V6jbXM8Q==",
+      "dependencies": {
+        "@types/json-schema": "^7.0.4",
+        "utility-types": "^3.10.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/@stoplight/yaml": {
+      "version": "3.8.1",
+      "resolved": "https://registry.npmjs.org/@stoplight/yaml/-/yaml-3.8.1.tgz",
+      "integrity": "sha512-wbhcgo7dTjwjjwFziC/SAcQlwPucYhYq6vjzyOjj8zeOVnnmoa7hzU1i9Kj31473FG/re7xtt6j3LWu2VnYbxg==",
+      "dependencies": {
+        "@stoplight/ordered-object-literal": "^1.0.1",
+        "@stoplight/types": "^11.1.1",
+        "@stoplight/yaml-ast-parser": "0.0.45",
+        "lodash": "^4.17.15"
+      },
+      "engines": {
+        "node": ">=8.3.0"
+      }
+    },
+    "node_modules/@stoplight/yaml-ast-parser": {
+      "version": "0.0.45",
+      "resolved": "https://registry.npmjs.org/@stoplight/yaml-ast-parser/-/yaml-ast-parser-0.0.45.tgz",
+      "integrity": "sha512-0MTEvgp3XMdeMUSTCGiNECuC+YlLbzytDEIOJVDHrrmzVZpIR3gGnHI6mmPI4P7saPxUiHxFF2uuoTuCNlKjrw=="
+    },
+    "node_modules/@types/json-schema": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.6.tgz",
+      "integrity": "sha512-3c+yGKvVP5Y9TYBEibGNR+kLtijnj7mYrXRg+WpFb2X9xm04g/DXYkfg4hmzJQosc9snFNUPkbYIhu+KAm6jJw=="
+    },
+    "node_modules/@types/urijs": {
+      "version": "1.19.19",
+      "resolved": "https://registry.npmjs.org/@types/urijs/-/urijs-1.19.19.tgz",
+      "integrity": "sha512-FDJNkyhmKLw7uEvTxx5tSXfPeQpO0iy73Ry+PmYZJvQy0QIWX8a7kJ4kLWRf+EbTPJEPDSgPXHaM7pzr5lmvCg=="
+    },
+    "node_modules/dependency-graph": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/dependency-graph/-/dependency-graph-0.11.0.tgz",
+      "integrity": "sha512-JeMq7fEshyepOWDfcfHK06N3MhyPhz++vtqWhMT5O9A3K42rdsEDpfdVqjaqaAhsw6a+ZqeDvQVtD0hFHQWrzg==",
+      "engines": {
+        "node": ">= 0.6.0"
+      }
+    },
+    "node_modules/fast-memoize": {
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/fast-memoize/-/fast-memoize-2.5.2.tgz",
+      "integrity": "sha512-Ue0LwpDYErFbmNnZSF0UH6eImUwDmogUO1jyE+JbN2gsQz/jICm1Ve7t9QT0rNSsfJt+Hs4/S3GnsDVjL4HVrw=="
+    },
+    "node_modules/immer": {
+      "version": "9.0.14",
+      "resolved": "https://registry.npmjs.org/immer/-/immer-9.0.14.tgz",
+      "integrity": "sha512-ubBeqQutOSLIFCUBN03jGeOS6a3DoYlSYwYJTa+gSKEZKU5redJIqkIdZ3JVv/4RZpfcXdAWH5zCNLWPRv2WDw==",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/immer"
+      }
+    },
+    "node_modules/jsonc-parser": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-2.2.1.tgz",
+      "integrity": "sha512-o6/yDBYccGvTz1+QFevz6l6OBZ2+fMVu2JZ9CIhzsYRX4mjaK5IyX9eldUdCmga16zlgQxyrj5pt9kzuj2C02w=="
+    },
+    "node_modules/lodash": {
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
+    },
+    "node_modules/node-fetch": {
+      "version": "2.6.7",
+      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.6.7.tgz",
+      "integrity": "sha512-ZjMPFEfVx5j+y2yF35Kzx5sF7kDzxuDj6ziH4FFbOp87zKDZNx8yExJIb05OGF4Nlt9IHFIMBkRl41VdvcNdbQ==",
+      "dependencies": {
+        "whatwg-url": "^5.0.0"
+      },
+      "engines": {
+        "node": "4.x || >=6.0.0"
+      },
+      "peerDependencies": {
+        "encoding": "^0.1.0"
+      },
+      "peerDependenciesMeta": {
+        "encoding": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/safe-stable-stringify": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-1.1.1.tgz",
+      "integrity": "sha512-ERq4hUjKDbJfE4+XtZLFPCDi8Vb1JqaxAPTxWFLBx8XcAlf9Bda/ZJdVezs/NAfsMQScyIlUMx+Yeu7P7rx5jw=="
+    },
+    "node_modules/tr46": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+      "integrity": "sha1-gYT9NH2snNwYWZLzpmIuFLnZq2o="
+    },
+    "node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg=="
+    },
+    "node_modules/urijs": {
+      "version": "1.19.11",
+      "resolved": "https://registry.npmjs.org/urijs/-/urijs-1.19.11.tgz",
+      "integrity": "sha512-HXgFDgDommxn5/bIv0cnQZsPhHDA90NPHD6+c/v21U5+Sx5hoP8+dP9IZXBU1gIfvdRfhG8cel9QNPeionfcCQ=="
+    },
+    "node_modules/utility-types": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/utility-types/-/utility-types-3.10.0.tgz",
+      "integrity": "sha512-O11mqxmi7wMKCo6HKFt5AhO4BwY3VV68YU07tgxfz8zJTIxr4BpsezN49Ffwy9j3ZpwwJp4fkRwjRzq3uWE6Rg==",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+      "integrity": "sha1-JFNCdeKnvGvnvIZhHMFq4KVlSHE="
+    },
+    "node_modules/whatwg-url": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+      "integrity": "sha1-lmRU6HZUYuN2RNNib2dCzotwll0=",
+      "dependencies": {
+        "tr46": "~0.0.3",
+        "webidl-conversions": "^3.0.0"
+      }
+    }
+  },
+  "dependencies": {
+    "@cloudflare/json-schema-walker": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/@cloudflare/json-schema-walker/-/json-schema-walker-0.1.1.tgz",
+      "integrity": "sha512-P3n0hEgk1m6uKWgL4Yb1owzXVG4pM70G4kRnDQxZXiVvfCRtaqiHu+ZRiRPzmwGBiLTO1LWc2yR1M8oz0YkXww=="
+    },
+    "@openapi-contrib/json-schema-to-openapi-schema": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@openapi-contrib/json-schema-to-openapi-schema/-/json-schema-to-openapi-schema-1.3.0.tgz",
+      "integrity": "sha512-EaZoAT3U1oZObNQEiI1FDV1Lf/PHTkNCKtTVCOqdLY568iJfFV8nPvsKyKpUrmdCVJXtbNKeIrRFO2lJpa+EoA==",
+      "requires": {
+        "@cloudflare/json-schema-walker": "^0.1.1",
+        "@stoplight/json-ref-resolver": "^3.1.1",
+        "@stoplight/yaml": "^3.7.1",
+        "node-fetch": "^2.6.0",
+        "tslib": "^1.11.1"
+      }
+    },
+    "@stoplight/json": {
+      "version": "3.18.1",
+      "resolved": "https://registry.npmjs.org/@stoplight/json/-/json-3.18.1.tgz",
+      "integrity": "sha512-QmELAqBS8DC+8YuG7+OvDVP6RaUVi8bzN0KKW2UEcZg+0a1sqeeZgfW079AmJIZg8HEN7udAt4iozIB8Dm0t1Q==",
+      "requires": {
+        "@stoplight/ordered-object-literal": "^1.0.2",
+        "@stoplight/types": "^13.0.0",
+        "jsonc-parser": "~2.2.1",
+        "lodash": "^4.17.21",
+        "safe-stable-stringify": "^1.1"
+      },
+      "dependencies": {
+        "@stoplight/types": {
+          "version": "13.2.0",
+          "resolved": "https://registry.npmjs.org/@stoplight/types/-/types-13.2.0.tgz",
+          "integrity": "sha512-V3BRfzWEAcCpICGQh/WW2LX4rcB2KagQ7/msf0BDTCF5qpFMSwOxcjv25k1NUMVQSh3qwGfGoka/gYGA5m+NQA==",
+          "requires": {
+            "@types/json-schema": "^7.0.4",
+            "utility-types": "^3.10.0"
+          }
+        }
+      }
+    },
+    "@stoplight/json-ref-resolver": {
+      "version": "3.1.4",
+      "resolved": "https://registry.npmjs.org/@stoplight/json-ref-resolver/-/json-ref-resolver-3.1.4.tgz",
+      "integrity": "sha512-842JVmMsi++qpDuIX+JpQvK7YY8FXEZZb+/z4xuRfStOAVEryJT/tbgGOWxniSdxEl9Eni5D/I2afMyy6BuiNw==",
+      "requires": {
+        "@stoplight/json": "^3.17.0",
+        "@stoplight/path": "^1.3.2",
+        "@stoplight/types": "^12.3.0 || ^13.0.0",
+        "@types/urijs": "^1.19.19",
+        "dependency-graph": "~0.11.0",
+        "fast-memoize": "^2.5.2",
+        "immer": "^9.0.6",
+        "lodash": "^4.17.21",
+        "tslib": "^2.3.1",
+        "urijs": "^1.19.11"
+      },
+      "dependencies": {
+        "@stoplight/types": {
+          "version": "13.2.0",
+          "resolved": "https://registry.npmjs.org/@stoplight/types/-/types-13.2.0.tgz",
+          "integrity": "sha512-V3BRfzWEAcCpICGQh/WW2LX4rcB2KagQ7/msf0BDTCF5qpFMSwOxcjv25k1NUMVQSh3qwGfGoka/gYGA5m+NQA==",
+          "requires": {
+            "@types/json-schema": "^7.0.4",
+            "utility-types": "^3.10.0"
+          }
+        },
+        "tslib": {
+          "version": "2.4.0",
+          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz",
+          "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ=="
+        }
+      }
+    },
+    "@stoplight/ordered-object-literal": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@stoplight/ordered-object-literal/-/ordered-object-literal-1.0.3.tgz",
+      "integrity": "sha512-cjJ7PPkhgTXNMTkevAlmyrx9xOOCaI3c6rEeYb6VitL1o1WcZtrz9KyFyISmTmUa7yYTiy2IS/ud9S8s2sn3+A=="
+    },
+    "@stoplight/path": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/@stoplight/path/-/path-1.3.2.tgz",
+      "integrity": "sha512-lyIc6JUlUA8Ve5ELywPC8I2Sdnh1zc1zmbYgVarhXIp9YeAB0ReeqmGEOWNtlHkbP2DAA1AL65Wfn2ncjK/jtQ=="
+    },
+    "@stoplight/types": {
+      "version": "11.9.0",
+      "resolved": "https://registry.npmjs.org/@stoplight/types/-/types-11.9.0.tgz",
+      "integrity": "sha512-4bzPpWZobt0e+d0OtALCJyl1HGzKo6ur21qxnId9dTl8v3yeD+5HJKZ2h1mv7e94debH5QDtimMU80V6jbXM8Q==",
+      "requires": {
+        "@types/json-schema": "^7.0.4",
+        "utility-types": "^3.10.0"
+      }
+    },
+    "@stoplight/yaml": {
+      "version": "3.8.1",
+      "resolved": "https://registry.npmjs.org/@stoplight/yaml/-/yaml-3.8.1.tgz",
+      "integrity": "sha512-wbhcgo7dTjwjjwFziC/SAcQlwPucYhYq6vjzyOjj8zeOVnnmoa7hzU1i9Kj31473FG/re7xtt6j3LWu2VnYbxg==",
+      "requires": {
+        "@stoplight/ordered-object-literal": "^1.0.1",
+        "@stoplight/types": "^11.1.1",
+        "@stoplight/yaml-ast-parser": "0.0.45",
+        "lodash": "^4.17.15"
+      }
+    },
+    "@stoplight/yaml-ast-parser": {
+      "version": "0.0.45",
+      "resolved": "https://registry.npmjs.org/@stoplight/yaml-ast-parser/-/yaml-ast-parser-0.0.45.tgz",
+      "integrity": "sha512-0MTEvgp3XMdeMUSTCGiNECuC+YlLbzytDEIOJVDHrrmzVZpIR3gGnHI6mmPI4P7saPxUiHxFF2uuoTuCNlKjrw=="
+    },
+    "@types/json-schema": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.6.tgz",
+      "integrity": "sha512-3c+yGKvVP5Y9TYBEibGNR+kLtijnj7mYrXRg+WpFb2X9xm04g/DXYkfg4hmzJQosc9snFNUPkbYIhu+KAm6jJw=="
+    },
+    "@types/urijs": {
+      "version": "1.19.19",
+      "resolved": "https://registry.npmjs.org/@types/urijs/-/urijs-1.19.19.tgz",
+      "integrity": "sha512-FDJNkyhmKLw7uEvTxx5tSXfPeQpO0iy73Ry+PmYZJvQy0QIWX8a7kJ4kLWRf+EbTPJEPDSgPXHaM7pzr5lmvCg=="
+    },
+    "dependency-graph": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/dependency-graph/-/dependency-graph-0.11.0.tgz",
+      "integrity": "sha512-JeMq7fEshyepOWDfcfHK06N3MhyPhz++vtqWhMT5O9A3K42rdsEDpfdVqjaqaAhsw6a+ZqeDvQVtD0hFHQWrzg=="
+    },
+    "fast-memoize": {
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/fast-memoize/-/fast-memoize-2.5.2.tgz",
+      "integrity": "sha512-Ue0LwpDYErFbmNnZSF0UH6eImUwDmogUO1jyE+JbN2gsQz/jICm1Ve7t9QT0rNSsfJt+Hs4/S3GnsDVjL4HVrw=="
+    },
+    "immer": {
+      "version": "9.0.14",
+      "resolved": "https://registry.npmjs.org/immer/-/immer-9.0.14.tgz",
+      "integrity": "sha512-ubBeqQutOSLIFCUBN03jGeOS6a3DoYlSYwYJTa+gSKEZKU5redJIqkIdZ3JVv/4RZpfcXdAWH5zCNLWPRv2WDw=="
+    },
+    "jsonc-parser": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-2.2.1.tgz",
+      "integrity": "sha512-o6/yDBYccGvTz1+QFevz6l6OBZ2+fMVu2JZ9CIhzsYRX4mjaK5IyX9eldUdCmga16zlgQxyrj5pt9kzuj2C02w=="
+    },
+    "lodash": {
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="
+    },
+    "node-fetch": {
+      "version": "2.6.7",
+      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.6.7.tgz",
+      "integrity": "sha512-ZjMPFEfVx5j+y2yF35Kzx5sF7kDzxuDj6ziH4FFbOp87zKDZNx8yExJIb05OGF4Nlt9IHFIMBkRl41VdvcNdbQ==",
+      "requires": {
+        "whatwg-url": "^5.0.0"
+      }
+    },
+    "safe-stable-stringify": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-1.1.1.tgz",
+      "integrity": "sha512-ERq4hUjKDbJfE4+XtZLFPCDi8Vb1JqaxAPTxWFLBx8XcAlf9Bda/ZJdVezs/NAfsMQScyIlUMx+Yeu7P7rx5jw=="
+    },
+    "tr46": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+      "integrity": "sha1-gYT9NH2snNwYWZLzpmIuFLnZq2o="
+    },
+    "tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg=="
+    },
+    "urijs": {
+      "version": "1.19.11",
+      "resolved": "https://registry.npmjs.org/urijs/-/urijs-1.19.11.tgz",
+      "integrity": "sha512-HXgFDgDommxn5/bIv0cnQZsPhHDA90NPHD6+c/v21U5+Sx5hoP8+dP9IZXBU1gIfvdRfhG8cel9QNPeionfcCQ=="
+    },
+    "utility-types": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/utility-types/-/utility-types-3.10.0.tgz",
+      "integrity": "sha512-O11mqxmi7wMKCo6HKFt5AhO4BwY3VV68YU07tgxfz8zJTIxr4BpsezN49Ffwy9j3ZpwwJp4fkRwjRzq3uWE6Rg=="
+    },
+    "webidl-conversions": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+      "integrity": "sha1-JFNCdeKnvGvnvIZhHMFq4KVlSHE="
+    },
+    "whatwg-url": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+      "integrity": "sha1-lmRU6HZUYuN2RNNib2dCzotwll0=",
+      "requires": {
+        "tr46": "~0.0.3",
+        "webidl-conversions": "^3.0.0"
+      }
+    }
+  }
+}

tools/schema2openapi/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "tools",
+  "version": "1.0.0",
+  "description": "",
+  "main": "convert.js",
+  "dependencies": {
+    "@openapi-contrib/json-schema-to-openapi-schema": "^1.3.0"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "convert": "node convert.js"
+  },
+  "author": "",
+  "license": "ISC"
+}

tools/schema2openapi/schema.json

@@ -0,0 +1,218 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "StorageOps",
+  "anyOf": [
+    {
+      "description": "Create new collection and (optionally) specify index params",
+      "type": "object",
+      "required": [
+        "create_collection"
+      ],
+      "properties": {
+        "create_collection": {
+          "type": "object",
+          "required": [
+            "distance",
+            "name",
+            "vector_size"
+          ],
+          "properties": {
+            "distance": {
+              "$ref": "#/definitions/Distance"
+            },
+            "index": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/Indexes"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "name": {
+              "type": "string"
+            },
+            "vector_size": {
+              "type": "integer",
+              "format": "uint",
+              "minimum": 0.0
+            }
+          }
+        }
+      }
+    },
+    {
+      "description": "Delete collection with given name",
+      "type": "object",
+      "required": [
+        "delete_collection"
+      ],
+      "properties": {
+        "delete_collection": {
+          "type": "string"
+        }
+      }
+    },
+    {
+      "description": "Perform changes of collection aliases",
+      "type": "object",
+      "required": [
+        "change_aliases"
+      ],
+      "properties": {
+        "change_aliases": {
+          "type": "object",
+          "required": [
+            "actions"
+          ],
+          "properties": {
+            "actions": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/AliasOperations"
+              }
+            }
+          }
+        }
+      }
+    }
+  ],
+  "definitions": {
+    "AliasOperations": {
+      "anyOf": [
+        {
+          "type": "object",
+          "required": [
+            "create_alias"
+          ],
+          "properties": {
+            "create_alias": {
+              "type": "object",
+              "required": [
+                "alias_name",
+                "collection_name"
+              ],
+              "properties": {
+                "alias_name": {
+                  "type": "string"
+                },
+                "collection_name": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "delete_alias"
+          ],
+          "properties": {
+            "delete_alias": {
+              "type": "object",
+              "required": [
+                "alias_name"
+              ],
+              "properties": {
+                "alias_name": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "rename_alias"
+          ],
+          "properties": {
+            "rename_alias": {
+              "type": "object",
+              "required": [
+                "new_alias_name",
+                "old_alias_name"
+              ],
+              "properties": {
+                "new_alias_name": {
+                  "type": "string"
+                },
+                "old_alias_name": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "Distance": {
+      "description": "Type of internal tags, build from payload",
+      "type": "string",
+      "enum": [
+        "Cosine",
+        "Euclid",
+        "Dot",
+        "Manhattan"
+      ]
+    },
+    "Indexes": {
+      "anyOf": [
+        {
+          "type": "object",
+          "required": [
+            "options",
+            "type"
+          ],
+          "properties": {
+            "options": {
+              "type": "object"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "plain"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "options",
+            "type"
+          ],
+          "properties": {
+            "options": {
+              "type": "object",
+              "required": [
+                "ef_construct",
+                "m"
+              ],
+              "properties": {
+                "ef_construct": {
+                  "type": "integer",
+                  "format": "uint",
+                  "minimum": 0.0
+                },
+                "m": {
+                  "type": "integer",
+                  "format": "uint",
+                  "minimum": 0.0
+                }
+              }
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "hnsw"
+              ]
+            }
+          }
+        }
+      ]
+    }
+  }
+}

tools/sync-web-ui.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+STATIC_DIR=${STATIC_DIR:-"./static"}
+OPENAPI_FILE=${OPENAPI_DIR:-"./docs/redoc/master/openapi.json"}
+
+# Download `dist.zip` from the latest release of https://github.com/qdrant/qdrant-web-ui and unzip given folder
+
+# Get latest dist.zip, assume jq is installed
+DOWNLOAD_LINK=$(curl --silent "https://api.github.com/repos/qdrant/qdrant-web-ui/releases/latest" | jq -r '.assets[] | select(.name=="dist-qdrant.zip") | .browser_download_url')
+
+if command -v wget &> /dev/null
+then
+    wget -O dist-qdrant.zip $DOWNLOAD_LINK
+else
+    curl -L -o dist-qdrant.zip $DOWNLOAD_LINK
+fi
+
+rm -rf "${STATIC_DIR}/"*
+unzip -o dist-qdrant.zip -d "${STATIC_DIR}"
+rm dist-qdrant.zip
+cp -r "${STATIC_DIR}/dist/"* "${STATIC_DIR}"
+rm -rf "${STATIC_DIR}/dist"
+
+cp "${OPENAPI_FILE}" "${STATIC_DIR}/openapi.json"

tools/update-diagrams.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+
+# Finds all diagrams in documentation and updates renders
+# Use this script if you updated one of the *.mmd files.
+
+# Ensure current path is project root
+cd "$(dirname "$0")/../" || exit
+
+find . -name '*.mmd' \
+  | xargs -I {} docker run --rm -v $PWD:/data -u $UID ghcr.io/mermaid-js/mermaid-cli/mermaid-cli:latest -i /data/{} -o /data/{}.png
+