UNPKG

4.04 kBTypeScriptView Raw
1/**
2 * This package exports several functions to query
3 * the {@link https://www.npmjs.com | npm registry}
4 * (or one of its mirrors) through one of its
5 * {@link https://github.com/npm/registry/blob/master/docs/REGISTRY-API.md | endpoints}.
6 *
7 * @example
8 * Get the metadata for the npm registry:
9 *
10 * ```typescript
11 * import { getRegistryMetadata } from 'query-registry';
12 *
13 * (async () => {
14 * const metadata = await getRegistryMetadata();
15 *
16 * // Output: 'registry'
17 * console.log(metadata.db_name);
18 * })();
19 * ```
20 *
21 * @example
22 * Get the latest manifest for package `query-registry` from the npm registry:
23 *
24 * ```typescript
25 * import { getPackageManifest } from 'query-registry';
26 *
27 * (async () => {
28 * const manifest = await getPackageManifest({ name: 'query-registry' });
29 *
30 * // Output: 'query-registry'
31 * console.log(manifest.name);
32 * })();
33 * ```
34 *
35 * @example
36 * Get the abbreviated packument for package `query-registry` from the npm registry:
37 *
38 * ```typescript
39 * import { getAbbreviatedPackument } from 'query-registry';
40 *
41 * (async () => {
42 * const packument = await getAbbreviatedPackument({ name: 'query-registry' });
43 *
44 * // Output: 'query-registry'
45 * console.log(manifest.name);
46 * })();
47 * ```
48 *
49 * @example
50 * Get the weekly downloads for package `query-registry` from the npm registry:
51 *
52 * ```typescript
53 * import { getPackageDownloads } from 'query-registry';
54 *
55 * (async () => {
56 * const downloads = await getPackageDownloads({ name: 'query-registry' });
57 *
58 * // Output: 'query-registry'
59 * console.log(downloads.package);
60 *
61 * // Output: 'number'
62 * console.log(typeof downloads.downloads);
63 * })();
64 * ```
65 *
66 * @example
67 * Get the search results for text query `query-registry` from the npm registry:
68 *
69 * ```typescript
70 * import { searchPackages } from 'query-registry';
71 *
72 * (async () => {
73 * const results = await searchPackages({ query: { text: 'query-registry' } });
74 *
75 * // Output: 'query-registry'
76 * console.log(results.objects[0].package.name);
77 * })();
78 * ```
79 *
80 * @example
81 * Enable {@link https://www.npmjs.com/package/debug | debug messages}
82 * by setting the `DEBUG` environment variable to `query-registry`
83 * (available only in non production environments):
84 *
85 * ```bash
86 * $ DEBUG="query-registry"
87 * ```
88 *
89 * @packageDocumentation
90 */
91export * from './data/registries';
92export * from './endpoints/get-abbreviated-packument';
93export * from './endpoints/get-daily-package-downloads';
94export * from './endpoints/get-daily-registry-downloads';
95export * from './endpoints/get-package-downloads';
96export * from './endpoints/get-package-manifest';
97export * from './endpoints/get-packument';
98export * from './endpoints/get-raw-abbreviated-packument';
99export * from './endpoints/get-raw-package-manifest';
100export * from './endpoints/get-raw-packument';
101export * from './endpoints/get-registry-downloads';
102export * from './endpoints/get-registry-metadata';
103export * from './endpoints/search-packages';
104export * from './types/abbreviated-packument';
105export * from './types/bug-tracker';
106export * from './types/dist-info';
107export * from './types/dist-tags';
108export * from './types/download-period';
109export * from './types/downloads';
110export * from './types/git-repository';
111export * from './types/npm-operational-internal';
112export * from './types/package-json';
113export * from './types/package-manifest';
114export * from './types/packument';
115export * from './types/person';
116export * from './types/raw-abbreviated-packument';
117export * from './types/raw-package-manifest';
118export * from './types/raw-packument';
119export * from './types/registry-metadata';
120export * from './types/repository';
121export * from './types/search-criteria';
122export * from './types/search-results';
123export * from './types/versions-to-timestamps';
124export * from './utils/errors';
125//# sourceMappingURL=index.d.ts.map
\No newline at end of file