Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve JSDoc documentation #1796

Open
flevi29 opened this issue Dec 6, 2024 · 0 comments
Open

Improve JSDoc documentation #1796

flevi29 opened this issue Dec 6, 2024 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@flevi29
Copy link
Collaborator

flevi29 commented Dec 6, 2024

JSDoc documentation is missing for most exported symbols, and could use some improvements on existing ones.
In addition, I think most methods that are already documented on the API reference page, should just link to it, rather than having extra documentation, reducing maintenance requirements.

We should also get rid of the extra extra documeantation that's in the README.md, and just link to the typedoc documenation.

If we're ever going to publish to JSR (#1792), it's going to complain a lot for the following 171 problems.

deno doc --lint --unstable-sloppy-imports ./src/index.ts

Output
error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\meilisearch.ts:39:1
   |
39 | export class MeiliSearch {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\meilisearch.ts:40:3
   |
40 |   config: Config;
   |   ^


error[private-type-ref]: public type 'MeiliSearch.prototype.httpRequest' references private type 'HttpRequests'
  --> anon\meilisearch-js\src\meilisearch.ts:41:3
   |
41 |   httpRequest: HttpRequests;
   |   ^
   = hint: make the referenced type public or remove the reference
   |
92 | class HttpRequests {
   | - this is the referenced type
   |

  info: to ensure documentation is complete all types that are exposed in the public API must be public


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\meilisearch.ts:41:3
   |
41 |   httpRequest: HttpRequests;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\meilisearch.ts:42:3
   |
42 |   tasks: TaskClient;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\types\types.ts:9:1
  |
9 | export type Config = {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:22:1
   |
22 | export type Pagination = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:27:1
   |
27 | export type ResourceQuery = Pagination & {};
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:29:1
   |
29 | export type ResourceResults<T> = Pagination & {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:38:1
   |
38 | export type IndexOptions = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:42:1
   |
42 | export type IndexObject = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:49:1
   |
49 | export type IndexesQuery = ResourceQuery & {};
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:51:1
   |
51 | export type IndexesResults<T> = ResourceResults<T> & {};
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:57:14
   |
57 | export const MatchingStrategies = {
   |              ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:63:1
   |
63 | export type MatchingStrategies =
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:66:1
   |
66 | export type Filter = string | Array<string | string[]>;
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:68:1
   |
68 | export type Query = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:72:1
   |
72 | export type Highlight = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:78:1
   |
78 | export type Crop = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:85:1
   |
85 | export type SearchForFacetValuesParams = Omit<SearchParams, "facetName"> & {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:89:1
   |
89 | export type FacetHit = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\types\types.ts:94:1
   |
94 | export type SearchForFacetValuesResponse = {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:100:1
    |
100 | export type HybridSearch = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:106:1
    |
106 | export type Locale = string;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:108:1
    |
108 | export type SearchParams = Query &
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:135:1
    |
135 | export type SearchRequestGET = Pagination &
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:156:1
    |
156 | export type MergeFacets = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:160:1
    |
160 | export type FederationOptions = { weight: number };
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:161:1
    |
161 | export type MultiSearchFederation = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:168:1
    |
168 | export type MultiSearchQuery = SearchParams & { indexUid: string };
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:169:1
    |
169 | export type MultiSearchQueryWithFederation = MultiSearchQuery & {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:173:1
    |
173 | export type MultiSearchParams = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:176:1
    |
176 | export type FederatedMultiSearchParams = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:181:1
    |
181 | export type CategoriesDistribution = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:185:1
    |
185 | export type Facet = string;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:186:1
    |
186 | export type FacetDistribution = Record<Facet, CategoriesDistribution>;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:187:1
    |
187 | export type MatchesPosition<T> = Partial<
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:191:1
    |
191 | export type RankingScoreDetails = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:222:1
    |
222 | export type FederationDetails = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:228:1
    |
228 | export type Hit<T = Record<string, any>> = T & {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:236:1
    |
236 | export type Hits<T = Record<string, any>> = Array<Hit<T>>;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:238:1
    |
238 | export type FacetStat = { min: number; max: number };
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:239:1
    |
239 | export type FacetStats = Record<string, FacetStat>;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:241:1
    |
241 | export type FacetsByIndex = Record<
    | ^


error[private-type-ref]: public type 'SearchResponse' references private type 'FinitePagination'
   --> anon\meilisearch-js\src\types\types.ts:249:1
    |
249 | export type SearchResponse<
    | ^
    = hint: make the referenced type public or remove the reference
    |
265 | type FinitePagination = {
    | - this is the referenced type
    |

  info: to ensure documentation is complete all types that are exposed in the public API must be public


error[private-type-ref]: public type 'SearchResponse' references private type 'InfinitePagination'
   --> anon\meilisearch-js\src\types\types.ts:249:1
    |
249 | export type SearchResponse<
    | ^
    = hint: make the referenced type public or remove the reference
    |
271 | type InfinitePagination = {
    | - this is the referenced type
    |

  info: to ensure documentation is complete all types that are exposed in the public API must be public


error[private-type-ref]: public type 'SearchResponse' references private type 'IsFinitePagination'
   --> anon\meilisearch-js\src\types\types.ts:249:1
    |
249 | export type SearchResponse<
    | ^
    = hint: make the referenced type public or remove the reference
    |
277 | type IsFinitePagination<S extends SearchParams> = Or<
    | - this is the referenced type
    |

  info: to ensure documentation is complete all types that are exposed in the public API must be public


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:249:1
    |
249 | export type SearchResponse<
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:296:1
    |
296 | export type MultiSearchResult<T> = SearchResponse<T> & { indexUid: string };
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:298:1
    |
298 | export type MultiSearchResponse<T = Record<string, any>> = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:302:1
    |
302 | export type MultiSearchResponseOrSearchResponse<
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:309:1
    |
309 | export type FieldDistribution = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:313:1
    |
313 | export type SearchSimilarDocumentsParams = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:333:1
    |
333 | export type DocumentOptions = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:337:14
    |
337 | export const ContentTypeEnum: Readonly<Record<string, ContentType>> = {
    |              ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:343:1
    |
343 | export type ContentType =
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:348:1
    |
348 | export type RawDocumentAdditionOptions = DocumentOptions & {
    | ^


error[private-type-ref]: public type 'DocumentsQuery' references private type 'Fields'
   --> anon\meilisearch-js\src\types\types.ts:352:1
    |
352 | export type DocumentsQuery<T = Record<string, any>> = ResourceQuery & {
    | ^
    = hint: make the referenced type public or remove the reference
    |
329 | type Fields<T = Record<string, any>> =
    | - this is the referenced type
    |

  info: to ensure documentation is complete all types that are exposed in the public API must be public


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:352:1
    |
352 | export type DocumentsQuery<T = Record<string, any>> = ResourceQuery & {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:360:1
    |
360 | export type DocumentQuery<T = Record<string, any>> = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:364:1
    |
364 | export type DocumentsDeletionQuery = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:368:1
    |
368 | export type DocumentsIds = string[] | number[];
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:370:1
    |
370 | export type UpdateDocumentsByFunctionOptions = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:380:1
    |
380 | export type FilterableAttributes = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:381:1
    |
381 | export type DistinctAttribute = string | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:382:1
    |
382 | export type SearchableAttributes = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:383:1
    |
383 | export type SortableAttributes = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:384:1
    |
384 | export type DisplayedAttributes = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:385:1
    |
385 | export type RankingRules = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:386:1
    |
386 | export type StopWords = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:387:1
    |
387 | export type Synonyms = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:390:1
    |
390 | export type TypoTolerance = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:399:1
    |
399 | export type SeparatorTokens = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:400:1
    |
400 | export type NonSeparatorTokens = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:401:1
    |
401 | export type Dictionary = string[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:402:1
    |
402 | export type ProximityPrecision = "byWord" | "byAttribute";
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:404:1
    |
404 | export type Distribution = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:409:1
    |
409 | export type OpenAiEmbedder = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:421:1
    |
421 | export type HuggingFaceEmbedder = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:431:1
    |
431 | export type UserProvidedEmbedder = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:438:1
    |
438 | export type RestEmbedder = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:452:1
    |
452 | export type OllamaEmbedder = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:464:1
    |
464 | export type Embedder =
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:472:1
    |
472 | export type Embedders = Record<string, Embedder> | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:474:1
    |
474 | export type FacetOrder = "alpha" | "count";
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:476:1
    |
476 | export type Faceting = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:481:1
    |
481 | export type PaginationSettings = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:485:1
    |
485 | export type SearchCutoffMs = number | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:487:1
    |
487 | export type LocalizedAttribute = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:492:1
    |
492 | export type LocalizedAttributes = LocalizedAttribute[] | null;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:494:1
    |
494 | export type Settings = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:519:14
    |
519 | export const TaskStatus = {
    |              ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:527:1
    |
527 | export type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:529:14
    |
529 | export const TaskTypes = {
    |              ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:543:1
    |
543 | export type TaskTypes = (typeof TaskTypes)[keyof typeof TaskTypes];
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:545:1
    |
545 | export type TasksQuery = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:561:1
    |
561 | export type CancelTasksQuery = Omit<TasksQuery, "limit" | "from"> & {};
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:563:1
    |
563 | export type DeleteTasksQuery = Omit<TasksQuery, "limit" | "from"> & {};
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:565:1
    |
565 | export type EnqueuedTaskObject = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:574:1
    |
574 | export type TaskObject = Omit<EnqueuedTaskObject, "taskUid"> & {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:637:1
    |
637 | export type SwapIndexesParams = Array<{
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:649:1
    |
649 | export type TasksResults = CursorResults<Task>;
    | ^


error[private-type-ref]: public type 'TasksResultsObject' references private type 'CursorResults'
   --> anon\meilisearch-js\src\types\types.ts:650:1
    |
650 | export type TasksResultsObject = CursorResults<TaskObject>;
    | ^
    = hint: make the referenced type public or remove the reference
    |
641 | type CursorResults<T> = {
    | - this is the referenced type
    |

  info: to ensure documentation is complete all types that are exposed in the public API must be public


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:650:1
    |
650 | export type TasksResultsObject = CursorResults<TaskObject>;
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:652:1
    |
652 | export type WaitOptions = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:661:1
    |
661 | export type Health = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:669:1
    |
669 | export type IndexStats = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:675:1
    |
675 | export type Stats = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:687:1
    |
687 | export type Key = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:699:1
    |
699 | export type KeyCreation = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:708:1
    |
708 | export type KeyUpdate = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:713:1
    |
713 | export type KeysQuery = ResourceQuery & {};
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:715:1
    |
715 | export type KeysResults = ResourceResults<Key[]> & {};
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:720:1
    |
720 | export type Version = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:730:1
    |
730 | export interface FetchError extends Error {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:731:3
    |
731 |   type: string;
    |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:732:3
    |
732 |   errno: string;
    |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:733:3
    |
733 |   code: string;
    |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:736:1
    |
736 | export type MeiliSearchErrorResponse = {
    | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
   --> anon\meilisearch-js\src\types\types.ts:746:14
    |
746 | export const ErrorStatusCode = {
    |              ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
    --> anon\meilisearch-js\src\types\types.ts:1108:1
     |
1108 | export type ErrorStatusCode =
     | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
    --> anon\meilisearch-js\src\types\types.ts:1111:1
     |
1111 | export type TokenIndexRules = {
     | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
    --> anon\meilisearch-js\src\types\types.ts:1115:1
     |
1115 | export type TokenSearchRules =
     | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
    --> anon\meilisearch-js\src\types\types.ts:1119:1
     |
1119 | export type TokenOptions = {
     | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-api-error.ts:4:1
  |
4 | export class MeiliSearchApiError extends MeiliSearchError {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-api-error.ts:5:3
  |
5 |   override name = "MeiliSearchApiError";
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-api-error.ts:6:3
  |
6 |   override cause?: MeiliSearchErrorResponse;
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-api-error.ts:7:3
  |
7 |   readonly response: Response;
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-api-error.ts:9:3
  |
9 |   constructor(response: Response, responseBody?: MeiliSearchErrorResponse) {
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-request-error.ts:3:1
  |
3 | export class MeiliSearchRequestError extends MeiliSearchError {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-request-error.ts:4:3
  |
4 |   override name = "MeiliSearchRequestError";
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-request-error.ts:6:3
  |
6 |   constructor(url: string, cause: unknown) {
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-error.ts:1:1
  |
1 | export class MeiliSearchError extends Error {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-error.ts:2:3
  |
2 |   override name = "MeiliSearchError";
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-error.ts:4:3
  |
4 |   constructor(...params: ConstructorParameters<typeof Error>) {
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-timeout-error.ts:3:1
  |
3 | export class MeiliSearchTimeOutError extends MeiliSearchError {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-timeout-error.ts:4:3
  |
4 |   override name = "MeiliSearchTimeOutError";
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\meilisearch-timeout-error.ts:6:3
  |
6 |   constructor(message: string) {
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\errors\version-hint-message.ts:1:1
  |
1 | export function versionErrorHintMessage(message: string, method: string) {
  | ^


error[missing-return-type]: exported function is missing an explicit return type annotation
 --> anon\meilisearch-js\src\errors\version-hint-message.ts:1:1
  |
1 | export function versionErrorHintMessage(message: string, method: string) {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:65:1
   |
65 | class Index<T extends Record<string, any> = Record<string, any>> {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:66:3
   |
66 |   uid: string;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:67:3
   |
67 |   primaryKey: string | undefined;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:68:3
   |
68 |   createdAt: Date | undefined;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:69:3
   |
69 |   updatedAt: Date | undefined;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:70:3
   |
70 |   httpRequest: HttpRequests;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:71:3
   |
71 |   tasks: TaskClient;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\indexes.ts:78:3
   |
78 |   constructor(config: Config, uid: string, primaryKey?: string) {
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\enqueued-task.ts:3:1
  |
3 | class EnqueuedTask {
  | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\enqueued-task.ts:4:3
  |
4 |   taskUid: EnqueuedTaskObject["taskUid"];
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\enqueued-task.ts:5:3
  |
5 |   indexUid: EnqueuedTaskObject["indexUid"];
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\enqueued-task.ts:6:3
  |
6 |   status: EnqueuedTaskObject["status"];
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\enqueued-task.ts:7:3
  |
7 |   type: EnqueuedTaskObject["type"];
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
 --> anon\meilisearch-js\src\enqueued-task.ts:8:3
  |
8 |   enqueuedAt: Date;
  |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\enqueued-task.ts:10:3
   |
10 |   constructor(task: EnqueuedTaskObject) {
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:17:1
   |
17 | class Task {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:18:3
   |
18 |   indexUid: TaskObject["indexUid"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:19:3
   |
19 |   status: TaskObject["status"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:20:3
   |
20 |   type: TaskObject["type"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:21:3
   |
21 |   uid: TaskObject["uid"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:22:3
   |
22 |   canceledBy: TaskObject["canceledBy"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:23:3
   |
23 |   details: TaskObject["details"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:24:3
   |
24 |   error: TaskObject["error"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:25:3
   |
25 |   duration: TaskObject["duration"];
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:26:3
   |
26 |   startedAt: Date;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:27:3
   |
27 |   enqueuedAt: Date;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:28:3
   |
28 |   finishedAt: Date;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:30:3
   |
30 |   constructor(task: TaskObject) {
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:46:1
   |
46 | class TaskClient {
   | ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:47:3
   |
47 |   httpRequest: HttpRequests;
   |   ^


error[missing-jsdoc]: exported symbol is missing JSDoc documentation
  --> anon\meilisearch-js\src\task.ts:49:3
   |
49 |   constructor(config: Config) {
   |   ^


error: Found 171 documentation lint errors.
@flevi29 flevi29 added the documentation Improvements or additions to documentation label Dec 6, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant