@owlmeans/package-registry-npm 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +110 -2
- package/agent-meta/manifest.json +16 -0
- package/agent-meta/skills/package-registry-npm/SKILL.md +101 -0
- package/build/append.d.ts +9 -0
- package/build/append.d.ts.map +1 -0
- package/build/append.js +12 -0
- package/build/append.js.map +1 -0
- package/build/consts.d.ts +63 -0
- package/build/consts.d.ts.map +1 -0
- package/build/consts.js +64 -0
- package/build/consts.js.map +1 -0
- package/build/index.d.ts +7 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +5 -0
- package/build/index.js.map +1 -0
- package/build/registry/facts.d.ts +3 -0
- package/build/registry/facts.d.ts.map +1 -0
- package/build/registry/facts.js +89 -0
- package/build/registry/facts.js.map +1 -0
- package/build/registry/http.d.ts +3 -0
- package/build/registry/http.d.ts.map +1 -0
- package/build/registry/http.js +105 -0
- package/build/registry/http.js.map +1 -0
- package/build/registry/types.local.d.ts +48 -0
- package/build/registry/types.local.d.ts.map +1 -0
- package/build/registry/types.local.js +2 -0
- package/build/registry/types.local.js.map +1 -0
- package/build/registry.d.ts +20 -0
- package/build/registry.d.ts.map +1 -0
- package/build/registry.js +202 -0
- package/build/registry.js.map +1 -0
- package/build/repository/types.d.ts +24 -0
- package/build/repository/types.d.ts.map +1 -0
- package/build/repository/types.js +2 -0
- package/build/repository/types.js.map +1 -0
- package/build/repository.d.ts +5 -0
- package/build/repository.d.ts.map +1 -0
- package/build/repository.js +79 -0
- package/build/repository.js.map +1 -0
- package/build/types.d.ts +45 -0
- package/build/types.d.ts.map +1 -0
- package/build/types.js +2 -0
- package/build/types.js.map +1 -0
- package/build/types.local.d.ts +64 -0
- package/build/types.local.d.ts.map +1 -0
- package/build/types.local.js +2 -0
- package/build/types.local.js.map +1 -0
- package/package.json +49 -4
- package/src/append.ts +17 -0
- package/src/consts.ts +91 -0
- package/src/index.ts +8 -0
- package/src/registry/facts.ts +101 -0
- package/src/registry/http.ts +117 -0
- package/src/registry/types.local.ts +52 -0
- package/src/registry.ts +234 -0
- package/src/repository/types.ts +25 -0
- package/src/repository.ts +90 -0
- package/src/types.local.ts +50 -0
- package/src/types.ts +47 -0
- package/tests/append.spec.ts +26 -0
- package/tests/context.ts +118 -0
- package/tests/fixtures.ts +99 -0
- package/tests/live.spec.ts +39 -0
- package/tests/registry.spec.ts +137 -0
- package/tests/repository.spec.ts +41 -0
- package/tests/tsconfig.json +12 -0
- package/tsconfig.json +16 -0
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { logger } from '@owlmeans/log';
|
|
2
|
+
import { PackageRegistryError } from '@owlmeans/package-inspector';
|
|
3
|
+
import { NPM_RETRY_BACKOFF, NPM_RETRY_MAX_WAIT, NPM_RETRY_STATUSES } from '../consts.js';
|
|
4
|
+
const log = logger('package-registry-npm');
|
|
5
|
+
export const createNpmHttp = (options) => {
|
|
6
|
+
const headers = { accept: 'application/json', 'user-agent': options.userAgent };
|
|
7
|
+
const failure = (label, cause) => {
|
|
8
|
+
log.debug('npm request failed', { label, cause });
|
|
9
|
+
return new PackageRegistryError(`${label}:${cause}`);
|
|
10
|
+
};
|
|
11
|
+
const causeOf = (error) => error instanceof Error && (error.name === 'TimeoutError' || error.name === 'AbortError') ? 'timeout' : 'unreachable';
|
|
12
|
+
/** The body as text, up to `maxBytes`; past them the rest is cancelled and `truncated` set. */
|
|
13
|
+
const readCapped = async (response, maxBytes) => {
|
|
14
|
+
const reader = response.body?.getReader();
|
|
15
|
+
if (reader == null) {
|
|
16
|
+
return { text: '', truncated: false };
|
|
17
|
+
}
|
|
18
|
+
const chunks = [];
|
|
19
|
+
let size = 0;
|
|
20
|
+
for (;;) {
|
|
21
|
+
const { done, value } = await reader.read();
|
|
22
|
+
if (done) {
|
|
23
|
+
break;
|
|
24
|
+
}
|
|
25
|
+
if (size + value.byteLength > maxBytes) {
|
|
26
|
+
chunks.push(value.subarray(0, maxBytes - size));
|
|
27
|
+
await reader.cancel().catch(() => undefined);
|
|
28
|
+
return { text: Buffer.concat(chunks).toString('utf8'), truncated: true };
|
|
29
|
+
}
|
|
30
|
+
size += value.byteLength;
|
|
31
|
+
chunks.push(value);
|
|
32
|
+
}
|
|
33
|
+
return { text: Buffer.concat(chunks).toString('utf8'), truncated: false };
|
|
34
|
+
};
|
|
35
|
+
/** How long to wait before retry `attempt` (0-based): the server's `retry-after`, else a doubling backoff. */
|
|
36
|
+
const waitOf = (response, attempt) => {
|
|
37
|
+
const header = response.headers.get('retry-after');
|
|
38
|
+
const seconds = header != null && header.trim() !== '' ? Number(header) : Number.NaN;
|
|
39
|
+
const dated = header != null && Number.isNaN(seconds) ? Date.parse(header) - Date.now() : Number.NaN;
|
|
40
|
+
const wait = !Number.isNaN(seconds) ? seconds * 1000 : !Number.isNaN(dated) ? dated : NPM_RETRY_BACKOFF * 2 ** attempt;
|
|
41
|
+
return Math.min(Math.max(wait, 0), NPM_RETRY_MAX_WAIT);
|
|
42
|
+
};
|
|
43
|
+
/** The response, retried while the server says it is throttling or briefly unavailable. */
|
|
44
|
+
const request = async (url, label) => {
|
|
45
|
+
const send = options.fetch ?? fetch;
|
|
46
|
+
for (let attempt = 0;; attempt++) {
|
|
47
|
+
let response;
|
|
48
|
+
try {
|
|
49
|
+
response = await send(url, { headers, signal: AbortSignal.timeout(options.timeoutMs), redirect: 'follow' });
|
|
50
|
+
}
|
|
51
|
+
catch (error) {
|
|
52
|
+
throw failure(label, causeOf(error));
|
|
53
|
+
}
|
|
54
|
+
if (!NPM_RETRY_STATUSES.includes(response.status) || attempt >= options.retries) {
|
|
55
|
+
return response;
|
|
56
|
+
}
|
|
57
|
+
await response.body?.cancel().catch(() => undefined);
|
|
58
|
+
const wait = waitOf(response, attempt);
|
|
59
|
+
log.debug('npm request throttled', { label, status: response.status, attempt, wait });
|
|
60
|
+
await new Promise(resolve => setTimeout(resolve, wait));
|
|
61
|
+
}
|
|
62
|
+
};
|
|
63
|
+
/** The body of a successful answer, capped; `null` for a 404. */
|
|
64
|
+
const read = async (url, label, maxBytes, whole) => {
|
|
65
|
+
const response = await request(url, label);
|
|
66
|
+
if (response.status === 404) {
|
|
67
|
+
await response.body?.cancel().catch(() => undefined);
|
|
68
|
+
return null;
|
|
69
|
+
}
|
|
70
|
+
if (!response.ok) {
|
|
71
|
+
await response.body?.cancel().catch(() => undefined);
|
|
72
|
+
throw failure(label, String(response.status));
|
|
73
|
+
}
|
|
74
|
+
// A declared length past the cap (compressed or not) is past it decompressed too.
|
|
75
|
+
const declared = Number(response.headers.get('content-length') ?? Number.NaN);
|
|
76
|
+
if (whole && Number.isFinite(declared) && declared > maxBytes) {
|
|
77
|
+
await response.body?.cancel().catch(() => undefined);
|
|
78
|
+
return { text: '', truncated: true };
|
|
79
|
+
}
|
|
80
|
+
try {
|
|
81
|
+
return await readCapped(response, maxBytes);
|
|
82
|
+
}
|
|
83
|
+
catch (error) {
|
|
84
|
+
throw failure(label, causeOf(error));
|
|
85
|
+
}
|
|
86
|
+
};
|
|
87
|
+
const json = async (url, label, maxBytes) => {
|
|
88
|
+
const answer = await read(url, label, maxBytes, true);
|
|
89
|
+
if (answer == null || answer.truncated) {
|
|
90
|
+
return answer == null ? null : { body: null, truncated: true };
|
|
91
|
+
}
|
|
92
|
+
try {
|
|
93
|
+
return { body: JSON.parse(answer.text), truncated: false };
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
throw failure(label, 'malformed');
|
|
97
|
+
}
|
|
98
|
+
};
|
|
99
|
+
const text = async (url, label, maxBytes) => {
|
|
100
|
+
const answer = await read(url, label, maxBytes, false);
|
|
101
|
+
return answer == null ? null : { body: answer.text, truncated: answer.truncated };
|
|
102
|
+
};
|
|
103
|
+
return { json, text };
|
|
104
|
+
};
|
|
105
|
+
//# sourceMappingURL=http.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/registry/http.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { NpmFetch } from '../types.js';
|
|
2
|
+
import type { PackageFacts } from '@owlmeans/package-inspector';
|
|
3
|
+
import type { RepositoryLocator } from '../repository/types.js';
|
|
4
|
+
import type { NpmPackument, NpmVersion } from '../types.local.js';
|
|
5
|
+
export interface NpmHttpOptions {
|
|
6
|
+
fetch?: NpmFetch;
|
|
7
|
+
timeoutMs: number;
|
|
8
|
+
userAgent: string;
|
|
9
|
+
/** Retries of a throttled (429) or briefly unavailable (502–504) request. */
|
|
10
|
+
retries: number;
|
|
11
|
+
}
|
|
12
|
+
/** A document read with a size cap. */
|
|
13
|
+
export interface NpmDocument<T> {
|
|
14
|
+
/** The parsed document (`null` when a JSON one was cut at the cap), or the text read. */
|
|
15
|
+
body: T | null;
|
|
16
|
+
/** Larger than the cap: the rest was never read. */
|
|
17
|
+
truncated: boolean;
|
|
18
|
+
}
|
|
19
|
+
/** GET of JSON documents over the injected fetch, with a timeout and a size cap. */
|
|
20
|
+
export interface NpmHttp {
|
|
21
|
+
/**
|
|
22
|
+
* The document at `url`; `null` for a 404. A throttled or briefly unavailable answer is retried
|
|
23
|
+
* after the server's `retry-after` (else a doubling backoff), at most `retries` times.
|
|
24
|
+
*
|
|
25
|
+
* @throws {PackageRegistryError} `<label>:<status>` for another failure status, `<label>:timeout`,
|
|
26
|
+
* `<label>:unreachable`, `<label>:malformed` for a body that is not JSON.
|
|
27
|
+
*/
|
|
28
|
+
json: <T>(url: string, label: string, maxBytes: number) => Promise<NpmDocument<T> | null>;
|
|
29
|
+
/**
|
|
30
|
+
* The text at `url`, its first `maxBytes` when longer (`truncated`); `null` for a 404.
|
|
31
|
+
*
|
|
32
|
+
* @throws {PackageRegistryError} as `json` does.
|
|
33
|
+
*/
|
|
34
|
+
text: (url: string, label: string, maxBytes: number) => Promise<NpmDocument<string> | null>;
|
|
35
|
+
}
|
|
36
|
+
export interface NpmFactsOptions {
|
|
37
|
+
locator: RepositoryLocator;
|
|
38
|
+
maxReadmeChars: number;
|
|
39
|
+
}
|
|
40
|
+
/** npm documents → the inspector's provider-neutral facts. */
|
|
41
|
+
export interface NpmFactsMapper {
|
|
42
|
+
/**
|
|
43
|
+
* The facts of `name` from its full packument, or — when the packument was too large to read —
|
|
44
|
+
* from the latest version's own document alone (`partial`).
|
|
45
|
+
*/
|
|
46
|
+
factsOf: (name: string, packument: NpmPackument | null, latest: NpmVersion | null) => PackageFacts;
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=types.local.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.local.d.ts","sourceRoot":"","sources":["../../src/registry/types.local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEjE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,yFAAyF;IACzF,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACzF;;;;OAIG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;CAC5F;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,KAAK,YAAY,CAAA;CACnG"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.local.js","sourceRoot":"","sources":["../../src/registry/types.local.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { NpmRegistry, NpmRegistryOptions } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* The npm registry behind the package inspector's port, over the injected `fetch`:
|
|
4
|
+
*
|
|
5
|
+
* - `manifest` — the full packument (scoped names as `@scope%2fname`), read up to `maxDocumentBytes`;
|
|
6
|
+
* a larger one is read through `/<name>/latest` (`partial` facts: no dates or version count) and
|
|
7
|
+
* the readme from the repository.
|
|
8
|
+
* Holding = latest `0.0.1-security` or the description "security holding package".
|
|
9
|
+
* - `downloads` — the weekly point API: unscoped names in bulk calls of ≤ 128, scoped names one call
|
|
10
|
+
* each; `null` for a name npm does not know. Counts are cached for `cacheTtlMs`.
|
|
11
|
+
* - `neighbours` — the name helper's variants (≤ `maxVariants`, ≤ `maxScopedLookups` scoped ones)
|
|
12
|
+
* priced in bulk; the existing ones, most downloaded first (≤ `maxNeighbours`). npm search does not
|
|
13
|
+
* surface them: it answers `loadsh` without `lodash`.
|
|
14
|
+
* - `repositoryManifest` — the repository's own `package.json` at its default branch on GitHub or
|
|
15
|
+
* GitLab, at the declared `directory`.
|
|
16
|
+
*
|
|
17
|
+
* A 404 is `null` everywhere; any other failure throws `PackageRegistryError`.
|
|
18
|
+
*/
|
|
19
|
+
export declare const createNpmRegistry: (options?: NpmRegistryOptions) => NpmRegistry;
|
|
20
|
+
//# sourceMappingURL=registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGjE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,aAAa,kBAAkB,KAAQ,WA0MpE,CAAA"}
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
import { packageNameHelper, PackageRegistryError } from '@owlmeans/package-inspector';
|
|
2
|
+
import { NPM_BULK_CONCURRENCY, NPM_BULK_LIMIT, NPM_CACHE_SIZE, NPM_CACHE_TTL, NPM_DOWNLOADS_PERIOD, NPM_DOWNLOADS_URL, NPM_MAX_DOCUMENT_BYTES, NPM_MAX_NEIGHBOURS, NPM_MAX_README_CHARS, NPM_README_FILES, NPM_MAX_SCOPED_LOOKUPS, NPM_MAX_SMALL_BYTES, NPM_MAX_VARIANTS, NPM_REGISTRY, NPM_REGISTRY_URL, NPM_RETRIES, NPM_SCOPED_CONCURRENCY, NPM_TIMEOUT, NPM_USER_AGENT, } from './consts.js';
|
|
3
|
+
import { createNpmFactsMapper } from './registry/facts.js';
|
|
4
|
+
import { createNpmHttp } from './registry/http.js';
|
|
5
|
+
import { createRepositoryLocator } from './repository.js';
|
|
6
|
+
/**
|
|
7
|
+
* The npm registry behind the package inspector's port, over the injected `fetch`:
|
|
8
|
+
*
|
|
9
|
+
* - `manifest` — the full packument (scoped names as `@scope%2fname`), read up to `maxDocumentBytes`;
|
|
10
|
+
* a larger one is read through `/<name>/latest` (`partial` facts: no dates or version count) and
|
|
11
|
+
* the readme from the repository.
|
|
12
|
+
* Holding = latest `0.0.1-security` or the description "security holding package".
|
|
13
|
+
* - `downloads` — the weekly point API: unscoped names in bulk calls of ≤ 128, scoped names one call
|
|
14
|
+
* each; `null` for a name npm does not know. Counts are cached for `cacheTtlMs`.
|
|
15
|
+
* - `neighbours` — the name helper's variants (≤ `maxVariants`, ≤ `maxScopedLookups` scoped ones)
|
|
16
|
+
* priced in bulk; the existing ones, most downloaded first (≤ `maxNeighbours`). npm search does not
|
|
17
|
+
* surface them: it answers `loadsh` without `lodash`.
|
|
18
|
+
* - `repositoryManifest` — the repository's own `package.json` at its default branch on GitHub or
|
|
19
|
+
* GitLab, at the declared `directory`.
|
|
20
|
+
*
|
|
21
|
+
* A 404 is `null` everywhere; any other failure throws `PackageRegistryError`.
|
|
22
|
+
*/
|
|
23
|
+
export const createNpmRegistry = (options = {}) => {
|
|
24
|
+
const registryUrl = (options.registryUrl ?? NPM_REGISTRY_URL).replace(/\/+$/, '');
|
|
25
|
+
const downloadsUrl = (options.downloadsUrl ?? NPM_DOWNLOADS_URL).replace(/\/+$/, '');
|
|
26
|
+
const maxDocumentBytes = options.maxDocumentBytes ?? NPM_MAX_DOCUMENT_BYTES;
|
|
27
|
+
const maxNeighbours = options.maxNeighbours ?? NPM_MAX_NEIGHBOURS;
|
|
28
|
+
const maxVariants = options.maxVariants ?? NPM_MAX_VARIANTS;
|
|
29
|
+
const maxScopedLookups = options.maxScopedLookups ?? NPM_MAX_SCOPED_LOOKUPS;
|
|
30
|
+
const cacheTtl = options.cacheTtlMs ?? NPM_CACHE_TTL;
|
|
31
|
+
const http = createNpmHttp({
|
|
32
|
+
fetch: options.fetch, timeoutMs: options.timeoutMs ?? NPM_TIMEOUT, userAgent: options.userAgent ?? NPM_USER_AGENT,
|
|
33
|
+
retries: options.retries ?? NPM_RETRIES,
|
|
34
|
+
});
|
|
35
|
+
const locator = createRepositoryLocator(options.repositoryHosts);
|
|
36
|
+
const maxReadmeChars = options.maxReadmeChars ?? NPM_MAX_README_CHARS;
|
|
37
|
+
const mapper = createNpmFactsMapper({ locator, maxReadmeChars });
|
|
38
|
+
const counts = new Map();
|
|
39
|
+
/** `@scope/name` as one path segment of the registry (`@scope%2fname`) or as two (`@scope/name`). */
|
|
40
|
+
const pathOf = (name, separator) => {
|
|
41
|
+
const slash = name.indexOf('/');
|
|
42
|
+
return name.startsWith('@') && slash > 1
|
|
43
|
+
? `@${encodeURIComponent(name.slice(1, slash))}${separator}${encodeURIComponent(name.slice(slash + 1))}`
|
|
44
|
+
: encodeURIComponent(name);
|
|
45
|
+
};
|
|
46
|
+
/** A name a downloads URL can carry; a comma would split a bulk list. */
|
|
47
|
+
const askable = (name) => /^@?[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)?$/.test(name);
|
|
48
|
+
const pool = async (items, width, work) => {
|
|
49
|
+
let next = 0;
|
|
50
|
+
const worker = async () => {
|
|
51
|
+
while (next < items.length) {
|
|
52
|
+
await work(items[next++]);
|
|
53
|
+
}
|
|
54
|
+
};
|
|
55
|
+
await Promise.all(Array.from({ length: Math.min(width, items.length) }, worker));
|
|
56
|
+
};
|
|
57
|
+
const remembered = (name) => {
|
|
58
|
+
const entry = counts.get(name);
|
|
59
|
+
return entry != null && Date.now() - entry.at < cacheTtl ? entry.count : undefined;
|
|
60
|
+
};
|
|
61
|
+
const remember = (name, count) => {
|
|
62
|
+
if (cacheTtl <= 0) {
|
|
63
|
+
return;
|
|
64
|
+
}
|
|
65
|
+
counts.delete(name);
|
|
66
|
+
counts.set(name, { count, at: Date.now() });
|
|
67
|
+
for (const oldest of counts.keys()) {
|
|
68
|
+
if (counts.size <= NPM_CACHE_SIZE) {
|
|
69
|
+
break;
|
|
70
|
+
}
|
|
71
|
+
counts.delete(oldest);
|
|
72
|
+
}
|
|
73
|
+
};
|
|
74
|
+
const countOf = (point) => typeof point?.downloads === 'number' ? point.downloads : null;
|
|
75
|
+
/** One bulk call — or, for a single name, the single-package answer, which has another shape. */
|
|
76
|
+
const bulk = async (batch) => {
|
|
77
|
+
const label = `${NPM_REGISTRY}:downloads:${batch.length === 1 ? batch[0] : `${batch[0]}+${batch.length - 1}`}`;
|
|
78
|
+
const url = `${downloadsUrl}/downloads/point/${NPM_DOWNLOADS_PERIOD}/${batch.map(name => encodeURIComponent(name)).join(',')}`;
|
|
79
|
+
const document = await http.json(url, label, NPM_MAX_SMALL_BYTES);
|
|
80
|
+
if (document == null) {
|
|
81
|
+
return Object.fromEntries(batch.map(name => [name, null]));
|
|
82
|
+
}
|
|
83
|
+
const body = document.body;
|
|
84
|
+
if (body == null || typeof body !== 'object') {
|
|
85
|
+
throw new PackageRegistryError(`${label}:malformed`);
|
|
86
|
+
}
|
|
87
|
+
if (batch.length === 1 && typeof body.package === 'string') {
|
|
88
|
+
return { [batch[0]]: countOf(body) };
|
|
89
|
+
}
|
|
90
|
+
return Object.fromEntries(batch.map(name => [name, countOf(body[name])]));
|
|
91
|
+
};
|
|
92
|
+
const scoped = async (name) => {
|
|
93
|
+
const label = `${NPM_REGISTRY}:downloads:${name}`;
|
|
94
|
+
const document = await http.json(`${downloadsUrl}/downloads/point/${NPM_DOWNLOADS_PERIOD}/${pathOf(name, '/')}`, label, NPM_MAX_SMALL_BYTES);
|
|
95
|
+
return countOf(document?.body);
|
|
96
|
+
};
|
|
97
|
+
const downloads = async (names) => {
|
|
98
|
+
const found = new Map();
|
|
99
|
+
const missing = [];
|
|
100
|
+
for (const name of new Set(names.map(entry => entry.trim()))) {
|
|
101
|
+
const known = remembered(name);
|
|
102
|
+
if (known !== undefined) {
|
|
103
|
+
found.set(name, known);
|
|
104
|
+
}
|
|
105
|
+
else if (!askable(name)) {
|
|
106
|
+
found.set(name, null);
|
|
107
|
+
}
|
|
108
|
+
else {
|
|
109
|
+
missing.push(name);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
const batches = [];
|
|
113
|
+
const plain = missing.filter(name => !name.startsWith('@'));
|
|
114
|
+
for (let start = 0; start < plain.length; start += NPM_BULK_LIMIT) {
|
|
115
|
+
batches.push(plain.slice(start, start + NPM_BULK_LIMIT));
|
|
116
|
+
}
|
|
117
|
+
await pool(batches, NPM_BULK_CONCURRENCY, async (batch) => {
|
|
118
|
+
for (const [name, count] of Object.entries(await bulk(batch))) {
|
|
119
|
+
found.set(name, count);
|
|
120
|
+
remember(name, count);
|
|
121
|
+
}
|
|
122
|
+
});
|
|
123
|
+
await pool(missing.filter(name => name.startsWith('@')), NPM_SCOPED_CONCURRENCY, async (name) => {
|
|
124
|
+
const count = await scoped(name);
|
|
125
|
+
found.set(name, count);
|
|
126
|
+
remember(name, count);
|
|
127
|
+
});
|
|
128
|
+
return Object.fromEntries(names.map(name => [name, found.get(name.trim()) ?? null]));
|
|
129
|
+
};
|
|
130
|
+
const manifest = async (raw) => {
|
|
131
|
+
const name = raw.trim();
|
|
132
|
+
const label = `${NPM_REGISTRY}:packument:${name}`;
|
|
133
|
+
const document = await http.json(`${registryUrl}/${pathOf(name, '%2f')}`, label, maxDocumentBytes);
|
|
134
|
+
if (document == null) {
|
|
135
|
+
return null;
|
|
136
|
+
}
|
|
137
|
+
if (!document.truncated) {
|
|
138
|
+
if (document.body == null || typeof document.body !== 'object') {
|
|
139
|
+
throw new PackageRegistryError(`${label}:malformed`);
|
|
140
|
+
}
|
|
141
|
+
return mapper.factsOf(name, document.body, null);
|
|
142
|
+
}
|
|
143
|
+
// Too large to read whole: the latest version's own document carries what the rules need, the
|
|
144
|
+
// repository the readme.
|
|
145
|
+
const latest = await http.json(`${registryUrl}/${pathOf(name, '%2f')}/latest`, `${NPM_REGISTRY}:latest:${name}`, NPM_MAX_SMALL_BYTES);
|
|
146
|
+
const facts = mapper.factsOf(name, null, latest?.body != null && typeof latest.body === 'object' ? latest.body : {});
|
|
147
|
+
const readme = facts.repository != null ? await repositoryReadme(facts.repository) : null;
|
|
148
|
+
return readme != null && readme.body != null && readme.body.trim() !== ''
|
|
149
|
+
? {
|
|
150
|
+
...facts,
|
|
151
|
+
readme: readme.body.slice(0, maxReadmeChars),
|
|
152
|
+
...(readme.truncated || readme.body.length > maxReadmeChars ? { readmeTruncated: true } : {}),
|
|
153
|
+
}
|
|
154
|
+
: facts;
|
|
155
|
+
};
|
|
156
|
+
/** The repository's readme at the package's directory; `null` when there is none or the host fails. */
|
|
157
|
+
const repositoryReadme = async (repository) => {
|
|
158
|
+
const location = locator.locate(repository.url, repository.directory);
|
|
159
|
+
if (location == null) {
|
|
160
|
+
return null;
|
|
161
|
+
}
|
|
162
|
+
for (const file of NPM_README_FILES) {
|
|
163
|
+
const label = `${NPM_REGISTRY}:readme:${location.path}`;
|
|
164
|
+
const document = await http.text(locator.rawUrlOf(location, file), label, maxReadmeChars * 4).catch(() => null);
|
|
165
|
+
if (document != null) {
|
|
166
|
+
return document;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
return null;
|
|
170
|
+
};
|
|
171
|
+
const neighbours = async (raw) => {
|
|
172
|
+
const name = raw.trim();
|
|
173
|
+
const variants = packageNameHelper.variants(name, { limit: maxVariants });
|
|
174
|
+
const candidates = [
|
|
175
|
+
...variants.filter(variant => !variant.startsWith('@')),
|
|
176
|
+
...variants.filter(variant => variant.startsWith('@')).slice(0, maxScopedLookups),
|
|
177
|
+
];
|
|
178
|
+
const priced = await downloads([name, ...candidates]);
|
|
179
|
+
return candidates
|
|
180
|
+
.flatMap(candidate => {
|
|
181
|
+
const count = priced[candidate];
|
|
182
|
+
return typeof count === 'number' && candidate !== name ? [{ candidate, count }] : [];
|
|
183
|
+
})
|
|
184
|
+
.sort((a, b) => b.count - a.count || a.candidate.localeCompare(b.candidate))
|
|
185
|
+
.slice(0, maxNeighbours)
|
|
186
|
+
.map(entry => entry.candidate);
|
|
187
|
+
};
|
|
188
|
+
const repositoryManifest = async (repository) => {
|
|
189
|
+
const location = locator.locate(repository.url, repository.directory);
|
|
190
|
+
if (location == null) {
|
|
191
|
+
return null;
|
|
192
|
+
}
|
|
193
|
+
const document = await http.json(locator.rawUrlOf(location, 'package.json'), `${NPM_REGISTRY}:repository:${location.path}`, NPM_MAX_SMALL_BYTES);
|
|
194
|
+
const body = document?.body;
|
|
195
|
+
if (body == null || typeof body !== 'object' || typeof body.name !== 'string' || body.name.trim() === '') {
|
|
196
|
+
return null;
|
|
197
|
+
}
|
|
198
|
+
return { name: body.name.trim(), root: body.private === true || body.workspaces != null };
|
|
199
|
+
};
|
|
200
|
+
return { id: NPM_REGISTRY, manifest, downloads, neighbours, repositoryManifest };
|
|
201
|
+
};
|
|
202
|
+
//# sourceMappingURL=registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { RepositoryHost } from '../consts.js';
|
|
2
|
+
/** A repository located on a host the adapter can read. */
|
|
3
|
+
export interface RepositoryLocation {
|
|
4
|
+
host: RepositoryHost;
|
|
5
|
+
/** `owner/name` — on GitLab `group/subgroup/name`. */
|
|
6
|
+
path: string;
|
|
7
|
+
/** The package's directory inside the repository. */
|
|
8
|
+
directory?: string;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Locates a declared repository on GitHub or GitLab, whatever form it was declared in:
|
|
12
|
+
* `git+https://github.com/o/r.git`, `git://…`, `git+ssh://git@…`, `git@github.com:o/r.git`,
|
|
13
|
+
* `github:o/r`, `gitlab:g/r`, the bare `o/r` shorthand, and browse URLs whose `tree/<ref>/<dir>`
|
|
14
|
+
* names the directory.
|
|
15
|
+
*/
|
|
16
|
+
export interface RepositoryLocator {
|
|
17
|
+
/** The location; `null` for another host or an address it cannot read. An explicit `directory` wins over a browse path. */
|
|
18
|
+
locate: (url: string, directory?: string) => RepositoryLocation | null;
|
|
19
|
+
/** The browsable https page of the repository (and its directory) on the public host. */
|
|
20
|
+
webOf: (location: RepositoryLocation) => string;
|
|
21
|
+
/** Where the raw `file` at the location's directory (or root) is read, at the default branch. */
|
|
22
|
+
rawUrlOf: (location: RepositoryLocation, file: string) => string;
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/repository/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAA;IACpB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,2HAA2H;IAC3H,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,CAAA;IACtE,yFAAyF;IACzF,KAAK,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,MAAM,CAAA;IAC/C,iGAAiG;IACjG,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACjE"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/repository/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { RepositoryLocator } from './repository/types.js';
|
|
2
|
+
import type { NpmRepositoryHosts } from './types.js';
|
|
3
|
+
export declare const createRepositoryLocator: (hosts?: NpmRepositoryHosts) => RepositoryLocator;
|
|
4
|
+
export declare const repositoryLocator: RepositoryLocator;
|
|
5
|
+
//# sourceMappingURL=repository.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,eAAO,MAAM,uBAAuB,WAAW,kBAAkB,KAAQ,iBAmFxE,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAA4B,CAAA"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { GITHUB_RAW_URL, GITHUB_URL, GITLAB_URL, RepositoryHost } from './consts.js';
|
|
2
|
+
export const createRepositoryLocator = (hosts = {}) => {
|
|
3
|
+
const githubRaw = (hosts.githubRaw ?? GITHUB_RAW_URL).replace(/\/+$/, '');
|
|
4
|
+
const gitlab = (hosts.gitlab ?? GITLAB_URL).replace(/\/+$/, '');
|
|
5
|
+
const tidy = (directory) => {
|
|
6
|
+
const text = (directory ?? '').trim().replace(/^\.?\/+/, '').replace(/\/+$/, '');
|
|
7
|
+
return text !== '' && text !== '.' ? text : undefined;
|
|
8
|
+
};
|
|
9
|
+
const bare = (name) => name.replace(/\.git$/i, '');
|
|
10
|
+
/** The host and the path segments of a declared address. */
|
|
11
|
+
const partsOf = (url) => {
|
|
12
|
+
const text = url.trim();
|
|
13
|
+
const shorthand = /^(github|gitlab|bitbucket|gist):(.+)$/i.exec(text);
|
|
14
|
+
if (shorthand != null) {
|
|
15
|
+
const kind = shorthand[1].toLowerCase();
|
|
16
|
+
const host = kind === 'github' ? RepositoryHost.GitHub : kind === 'gitlab' ? RepositoryHost.GitLab : null;
|
|
17
|
+
return host != null ? { host, segments: shorthand[2].split('/').filter(Boolean) } : null;
|
|
18
|
+
}
|
|
19
|
+
if (/^[\w.-]+\/[\w.-]+$/.test(text)) {
|
|
20
|
+
return { host: RepositoryHost.GitHub, segments: text.split('/') };
|
|
21
|
+
}
|
|
22
|
+
// `git@github.com:o/r.git` (scp form) → an https address; then strip `git+`.
|
|
23
|
+
const scp = /^(?:[\w.-]+@)?([\w.-]+\.[a-z]+):(?!\/\/)(.+)$/i.exec(text.replace(/^git\+/, ''));
|
|
24
|
+
const plain = text.replace(/^git\+/, '');
|
|
25
|
+
const address = scp != null ? `https://${scp[1]}/${scp[2]}` : /^[a-z][a-z+]*:\/\//i.test(plain) ? plain : `https://${plain}`;
|
|
26
|
+
let parsed;
|
|
27
|
+
try {
|
|
28
|
+
parsed = new URL(address);
|
|
29
|
+
}
|
|
30
|
+
catch {
|
|
31
|
+
return null;
|
|
32
|
+
}
|
|
33
|
+
const hostname = parsed.hostname.toLowerCase().replace(/^www\./, '');
|
|
34
|
+
const host = hostname === 'github.com' ? RepositoryHost.GitHub : hostname === 'gitlab.com' ? RepositoryHost.GitLab : null;
|
|
35
|
+
return host != null ? { host, segments: parsed.pathname.split('/').filter(Boolean) } : null;
|
|
36
|
+
};
|
|
37
|
+
const locate = (url, directory) => {
|
|
38
|
+
const parts = partsOf(url);
|
|
39
|
+
if (parts == null) {
|
|
40
|
+
return null;
|
|
41
|
+
}
|
|
42
|
+
const { host, segments } = parts;
|
|
43
|
+
let browsed;
|
|
44
|
+
let path;
|
|
45
|
+
if (host === RepositoryHost.GitHub) {
|
|
46
|
+
if (segments.length < 2) {
|
|
47
|
+
return null;
|
|
48
|
+
}
|
|
49
|
+
const [owner, name, kind, , ...rest] = segments;
|
|
50
|
+
browsed = (kind === 'tree' || kind === 'blob') && rest.length > 0 ? rest.join('/') : undefined;
|
|
51
|
+
path = `${owner}/${bare(name)}`;
|
|
52
|
+
}
|
|
53
|
+
else {
|
|
54
|
+
const marker = segments.indexOf('-');
|
|
55
|
+
const project = marker >= 0 ? segments.slice(0, marker) : segments;
|
|
56
|
+
if (project.length < 2) {
|
|
57
|
+
return null;
|
|
58
|
+
}
|
|
59
|
+
browsed = marker >= 0 && segments[marker + 1] === 'tree' && segments.length > marker + 3
|
|
60
|
+
? segments.slice(marker + 3).join('/')
|
|
61
|
+
: undefined;
|
|
62
|
+
path = [...project.slice(0, -1), bare(project[project.length - 1])].join('/');
|
|
63
|
+
}
|
|
64
|
+
const resolved = tidy(directory) ?? tidy(browsed);
|
|
65
|
+
return { host, path, ...(resolved != null ? { directory: resolved } : {}) };
|
|
66
|
+
};
|
|
67
|
+
const webOf = location => location.host === RepositoryHost.GitHub
|
|
68
|
+
? `${GITHUB_URL}/${location.path}${location.directory != null ? `/tree/HEAD/${location.directory}` : ''}`
|
|
69
|
+
: `${GITLAB_URL}/${location.path}${location.directory != null ? `/-/tree/HEAD/${location.directory}` : ''}`;
|
|
70
|
+
const rawUrlOf = (location, file) => {
|
|
71
|
+
const path = `${location.directory != null ? `${location.directory}/` : ''}${file}`;
|
|
72
|
+
return location.host === RepositoryHost.GitHub
|
|
73
|
+
? `${githubRaw}/${location.path}/HEAD/${path}`
|
|
74
|
+
: `${gitlab}/${location.path}/-/raw/HEAD/${path}`;
|
|
75
|
+
};
|
|
76
|
+
return { locate, webOf, rawUrlOf };
|
|
77
|
+
};
|
|
78
|
+
export const repositoryLocator = createRepositoryLocator();
|
|
79
|
+
//# sourceMappingURL=repository.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}
|
package/build/types.d.ts
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { PackageInspectorOptions, PackageRegistry } from '@owlmeans/package-inspector';
|
|
2
|
+
/** The one call the adapter makes — `fetch`, or a stand-in a test injects. */
|
|
3
|
+
export interface NpmFetch {
|
|
4
|
+
(url: string, init: RequestInit): Promise<Response>;
|
|
5
|
+
}
|
|
6
|
+
/** Where repository manifests are read from — the public hosts unless a test points elsewhere. */
|
|
7
|
+
export interface NpmRepositoryHosts {
|
|
8
|
+
/** GitHub's raw file host. Default `GITHUB_RAW_URL`. */
|
|
9
|
+
githubRaw?: string;
|
|
10
|
+
/** GitLab's host (raw files under `/-/raw/`). Default `GITLAB_URL`. */
|
|
11
|
+
gitlab?: string;
|
|
12
|
+
}
|
|
13
|
+
export interface NpmRegistryOptions {
|
|
14
|
+
/** Default: the global `fetch`. */
|
|
15
|
+
fetch?: NpmFetch;
|
|
16
|
+
/** Default `NPM_REGISTRY_URL`. */
|
|
17
|
+
registryUrl?: string;
|
|
18
|
+
/** Default `NPM_DOWNLOADS_URL`. */
|
|
19
|
+
downloadsUrl?: string;
|
|
20
|
+
repositoryHosts?: NpmRepositoryHosts;
|
|
21
|
+
/** Per request, headers and body. Default `NPM_TIMEOUT`. */
|
|
22
|
+
timeoutMs?: number;
|
|
23
|
+
/** Default `NPM_USER_AGENT`. */
|
|
24
|
+
userAgent?: string;
|
|
25
|
+
/** Retries of a throttled (429) or briefly unavailable (502–504) request. Default `NPM_RETRIES`. */
|
|
26
|
+
retries?: number;
|
|
27
|
+
/** Default `NPM_MAX_NEIGHBOURS`. */
|
|
28
|
+
maxNeighbours?: number;
|
|
29
|
+
/** Default `NPM_MAX_VARIANTS`. */
|
|
30
|
+
maxVariants?: number;
|
|
31
|
+
/** Default `NPM_MAX_SCOPED_LOOKUPS`. */
|
|
32
|
+
maxScopedLookups?: number;
|
|
33
|
+
/** Default `NPM_MAX_DOCUMENT_BYTES`. */
|
|
34
|
+
maxDocumentBytes?: number;
|
|
35
|
+
/** Default `NPM_MAX_README_CHARS`. */
|
|
36
|
+
maxReadmeChars?: number;
|
|
37
|
+
/** Default `NPM_CACHE_TTL`; `0` disables the download count cache. */
|
|
38
|
+
cacheTtlMs?: number;
|
|
39
|
+
}
|
|
40
|
+
/** The npm registry behind `@owlmeans/package-inspector`'s port. */
|
|
41
|
+
export interface NpmRegistry extends PackageRegistry {
|
|
42
|
+
}
|
|
43
|
+
export interface AppendNpmRegistryOptions extends NpmRegistryOptions, Omit<PackageInspectorOptions, 'registry'> {
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE3F,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACpD;AAED,kGAAkG;AAClG,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAY,SAAQ,eAAe;CAAG;AAEvD,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC;CAAG"}
|
package/build/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
|