@vltpkg/types 0.0.0-2 → 0.0.0-20

package/README.md

@@ -2,7 +2,8 @@
 
 # @vltpkg/types
 
-A module for a handful of core types that are used throughout vlt extensively, and don't belong to any one particular implementation.
+A module for a handful of core types that are used throughout vlt
+extensively, and don't belong to any one particular implementation.
 
 ## Usage
 

package/dist/esm/index.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Utility type that overrides specific properties of type T with new types
+ * from R. Constrains override values to exclude undefined, ensuring that
+ * normalization cannot introduce undefined to fields that shouldn't have it.
+ */
+export type Override<T, R extends {
+    [K in keyof R]: R[K] extends undefined ? never : R[K];
+}> = {
+    [K in keyof T]: K extends keyof R ? R[K] : T[K];
+};
 /** anything that can be encoded in JSON */
 export type JSONField = JSONField[] | boolean | number | string | {
     [k: string]: JSONField;
@@ -33,8 +43,73 @@ export type Exports = Exclude<ConditionalValue, null> | ExportsSubpaths;
 export type Imports = Record<`#${string}`, ConditionalValue>;
 export type FundingEntry = string | {
     url: string;
+    type?: string;
+    [key: string]: JSONField;
 };
 export type Funding = FundingEntry | FundingEntry[];
+/**
+ * An object with url and optional additional properties
+ */
+export type NormalizedFundingEntry = {
+    url: string;
+    type?: string;
+    [key: string]: JSONField;
+};
+/**
+ * Normalized funding information, an array of {@link NormalizedFundingEntry}.
+ */
+export type NormalizedFunding = NormalizedFundingEntry[];
+/**
+ * Normalize funding information to a consistent format.
+ */
+export declare const normalizeFunding: (funding: unknown) => NormalizedFunding | undefined;
+/**
+ * Type guard to check if a value is a {@link NormalizedFundingEntry}.
+ */
+export declare const isNormalizedFundingEntry: (o: unknown) => o is NormalizedFundingEntry;
+/**
+ * Type guard to check if a value is a {@link NormalizedFunding}.
+ */
+export declare const isNormalizedFunding: (o: unknown) => o is NormalizedFunding;
+/**
+ * Given a version Normalize the version field in a manifest.
+ */
+export declare const fixManifestVersion: <T extends Manifest | ManifestRegistry>(manifest: T) => T;
+declare const kWriteAccess: unique symbol;
+declare const kIsPublisher: unique symbol;
+/**
+ * Parse a string or object into a normalized contributor.
+ */
+export declare const parsePerson: (person: unknown, writeAccess?: boolean, isPublisher?: boolean) => NormalizedContributorEntry | undefined;
+/**
+ * Normalized contributors - always an array of {@link NormalizedContributorEntry}.
+ */
+export type NormalizedContributors = NormalizedContributorEntry[];
+/**
+ * Represents a normalized contributor object. This is the type that is
+ * used in the {@link NormalizedManifest} and {@link NormalizedManifestRegistry}
+ * objects.
+ */
+export type NormalizedContributorEntry = {
+    email?: string;
+    name?: string;
+    [kWriteAccess]?: boolean;
+    [kIsPublisher]?: boolean;
+    writeAccess?: boolean;
+    isPublisher?: boolean;
+};
+/**
+ * Type guard to check if a value is a normalized contributor entry.
+ */
+export declare const isNormalizedContributorEntry: (o: unknown) => o is NormalizedContributorEntry;
+/**
+ * Type guard to check if a value is a {@link NormalizedContributors}.
+ */
+export declare const isNormalizedContributors: (o: unknown) => o is NormalizedContributors;
+/**
+ * Normalize contributors and maintainers from various formats
+ */
+export declare const normalizeContributors: (contributors: unknown, maintainers?: unknown) => NormalizedContributorEntry[] | undefined;
 export type Person = string | {
     name: string;
     url?: string;
@@ -48,6 +123,43 @@ export type Bugs = string | {
     url?: string;
     email?: string;
 };
+export type Keywords = string[] | string;
+/**
+ * Normalized bugs entry - always an object with type and url/email
+ */
+export type NormalizedBugsEntry = {
+    type?: 'email' | 'link';
+    url?: string;
+    email?: string;
+};
+/**
+ * Normalized keywords - always an array of strings
+ */
+export type NormalizedKeywords = string[];
+/**
+ * Normalized bugs - always an array of {@link NormalizedBugsEntry}
+ */
+export type NormalizedBugs = NormalizedBugsEntry[];
+/**
+ * Normalize bugs information to a {@link NormalizedBugs} consistent format.
+ */
+export declare const normalizeBugs: (bugs: unknown) => NormalizedBugs | undefined;
+/**
+ * Type guard to check if a value is a {@link NormalizedBugsEntry}.
+ */
+export declare const isNormalizedBugsEntry: (o: unknown) => o is NormalizedBugsEntry;
+/**
+ * Type guard to check if a value is a {@link NormalizedBugs}.
+ */
+export declare const isNormalizedBugs: (o: unknown) => o is NormalizedBugs;
+/**
+ * Normalize keywords information to a {@link NormalizedKeywords} consistent format.
+ */
+export declare const normalizeKeywords: (keywords: unknown) => NormalizedKeywords | undefined;
+/**
+ * Type guard to check if a value is a {@link NormalizedKeywords}.
+ */
+export declare const isNormalizedKeywords: (o: unknown) => o is NormalizedKeywords;
 export type Manifest = {
     /** The name of the package. optional because {} is a valid package.json */
     name?: string;
@@ -81,6 +193,8 @@ export type Manifest = {
     cpu?: string[] | string;
     /** URLs that can be visited to fund this project */
     funding?: Funding;
+    /** The homepage of the repository */
+    homepage?: string;
     /**
      * Only present in Manifests served by a registry. Contains information
      * about the artifact served for this package release.
@@ -89,7 +203,7 @@ export type Manifest = {
     /** a short description of the package */
     description?: string;
     /** search keywords */
-    keywords?: string[];
+    keywords?: Keywords;
     /** where to go to file issues */
     bugs?: Bugs;
     /** where the development happens */
@@ -115,8 +229,43 @@ export type Manifest = {
     author?: Person;
     /** contributors to the package */
     contributors?: Person[];
+    /** the license of the package */
+    license?: string;
+};
+export type NormalizedFields = {
+    bugs: NormalizedBugs | undefined;
+    author: NormalizedContributorEntry | undefined;
+    contributors: NormalizedContributors | undefined;
+    funding: NormalizedFunding | undefined;
+    keywords: NormalizedKeywords | undefined;
+};
+/**
+ * A {@link Manifest} object that contains normalized fields.
+ */
+export type NormalizedManifest = Override<Manifest, NormalizedFields>;
+/**
+ * A {@link ManifestRegistry} object that contains normalized fields.
+ */
+export type NormalizedManifestRegistry = Override<ManifestRegistry, NormalizedFields>;
+/**
+ * A specific type of {@link Manifest} that represents manifests that were
+ * retrieved from a registry, these will always have `name`, `version`
+ * and `dist` information along with an optional `maintainers` field.
+ */
+export type ManifestRegistry = Manifest & Required<Pick<Manifest, 'name' | 'version' | 'dist'>> & {
+    maintainers?: unknown;
 };
-export type ManifestRegistry = Manifest & Required<Pick<Manifest, 'name' | 'version' | 'dist'>>;
+/**
+ * Maps the manifest type to the equivalent normalized manifest type.
+ */
+export type SomeNormalizedManifest<T> = T extends ManifestRegistry ? NormalizedManifestRegistry : NormalizedManifest;
+/**
+ * A document that represents available package versions in a given registry
+ * along with extra information, such as `dist-tags` and `maintainers` info.
+ * The `versions` field is key-value structure in which keys are the
+ * available versions of a given package and values are
+ * {@link ManifestRegistry} objects.
+ */
 export type Packument = {
     name: string;
     'dist-tags': Record<string, string>;
@@ -124,6 +273,8 @@ export type Packument = {
     modified?: string;
     time?: Record<string, string>;
     readme?: string;
+    contributors?: Person[];
+    maintainers?: Person[];
 };
 export type RefType = 'branch' | 'head' | 'other' | 'pull' | 'tag';
 /**
@@ -150,16 +301,93 @@ export type RevDoc = Omit<Packument, 'versions'> & {
     /** all named shas referenced above */
     shas: Record<string, string[]>;
 };
+/**
+ * A type guard to check if a value is a boolean.
+ */
+export declare const isBoolean: (value: unknown) => value is boolean;
+export declare const integrityRE: RegExp;
 export declare const isIntegrity: (i: unknown) => i is Integrity;
 export declare const asIntegrity: (i: unknown) => Integrity;
 export declare const assertIntegrity: (i: unknown) => asserts i is Integrity;
+export declare const keyIDRE: RegExp;
 export declare const isKeyID: (k: unknown) => k is KeyID;
 export declare const asKeyID: (k: unknown) => KeyID;
 export declare const assertKeyID: (k: unknown) => asserts k is KeyID;
+/**
+ * Convert an unknown value to an error.
+ */
+export declare const asError: (er: unknown, fallbackMessage?: string) => Error;
+/**
+ * Check if a value is an error.
+ */
+export declare const isError: (er: unknown) => er is Error;
+/**
+ * Check if an error has a cause property.
+ */
+export declare const isErrorWithCause: (er: unknown) => er is Error & {
+    cause: unknown;
+};
+/**
+ * Check if an unknown value is a plain object.
+ */
+export declare const isObject: (v: unknown) => v is Record<string, unknown>;
+export declare const maybeRecordStringString: (o: unknown) => o is Record<string, string> | undefined;
+export declare const isRecordStringString: (o: unknown) => o is Record<string, string>;
+export declare const assertRecordStringString: (o: unknown) => void;
+export declare const isRecordStringT: <T>(o: unknown, check: (o: unknown) => o is T) => o is Record<string, T>;
+export declare const assertRecordStringT: <T>(o: unknown, check: (o: unknown) => o is T, wanted: string) => asserts o is Record<string, T>;
+export declare const isRecordStringManifest: (o: unknown) => o is Record<string, Manifest>;
+export declare const maybePeerDependenciesMetaSet: (o: unknown) => o is Record<string, PeerDependenciesMetaValue> | undefined;
+export declare const maybeBoolean: (o: unknown) => o is boolean;
+export declare const isPeerDependenciesMetaValue: (o: unknown) => o is PeerDependenciesMetaValue;
+export declare const maybeString: (a: unknown) => a is string | undefined;
+export declare const maybeDist: (a: unknown) => a is Manifest["dist"];
+/**
+ * Is a given unknown value a valid {@link Manifest} object?
+ * Returns `true` if so.
+ */
 export declare const isManifest: (m: unknown) => m is Manifest;
+/**
+ * A specific {@link Manifest} that is retrieved uniquely from reading
+ * registry packument and manifest endpoints, it has `dist`, `name` and
+ * `version` fields defined.
+ */
 export declare const isManifestRegistry: (m: unknown) => m is ManifestRegistry;
+/**
+ * Given an unknown value, convert it to a {@link Manifest}.
+ */
 export declare const asManifest: (m: unknown, from?: (...a: unknown[]) => any) => Manifest;
+/**
+ * Given a {@link Manifest} returns a {@link NormalizedManifest} that
+ * contains normalized author, bugs, funding, contributors, keywords and
+ * version fields.
+ */
+export declare const normalizeManifest: <T extends Manifest | ManifestRegistry>(manifest: T) => SomeNormalizedManifest<T>;
+/**
+ * Type guard to check if a value is a {@link NormalizedManifest}.
+ */
+export declare const isNormalizedManifest: (o: unknown) => o is NormalizedManifest;
+/**
+ * Given an unknown value, convert it to a {@link NormalizedManifest}.
+ */
+export declare const asNormalizedManifest: (m: unknown, from?: (...a: unknown[]) => any) => NormalizedManifest;
+/**
+ * Given an unknown value, convert it to a {@link ManifestRegistry}.
+ */
 export declare const asManifestRegistry: (m: unknown, from?: (...a: unknown[]) => any) => ManifestRegistry;
+/**
+ * Type guard to check if a value is a {@link NormalizedManifestRegistry}.
+ */
+export declare const isNormalizedManifestRegistry: (o: unknown) => o is NormalizedManifestRegistry;
+/**
+ * Given an unknown value, convert it to a {@link NormalizedManifestRegistry}.
+ */
+export declare const asNormalizedManifestRegistry: (m: unknown, from?: (...a: unknown[]) => any) => NormalizedManifestRegistry;
+/**
+ * Walks a normalized manifest and expands any symbols found
+ * in the `author` and `contributors` fields.
+ */
+export declare const expandNormalizedManifestSymbols: (m: NormalizedManifest) => NormalizedManifest;
 export declare const assertManifest: (m: unknown) => asserts m is Manifest;
 export declare const assertManifestRegistry: (m: unknown) => asserts m is ManifestRegistry;
 export declare const isPackument: (p: unknown) => p is Packument;
@@ -173,6 +401,16 @@ export type DependencyTypeLong = 'dependencies' | 'devDependencies' | 'optionalD
  * Unique keys that define different types of dependencies relationship.
  */
 export type DependencyTypeShort = 'dev' | 'optional' | 'peer' | 'peerOptional' | 'prod';
+/**
+ * Unique keys that indicate how a new or updated dependency should be saved
+ * back to a manifest.
+ *
+ * `'implicit'` is used to indicate that a dependency should be saved as
+ * whatever type it already exists as. If the dependency does not exist,
+ * then `'implicit'` is equivalent to `'prod'`, as that is the default
+ * save type.
+ */
+export type DependencySaveType = DependencyTypeShort | 'implicit';
 /**
  * A set of the possible long dependency type names,
  * as used in `package.json` files.
@@ -187,4 +425,5 @@ export declare const shortDependencyTypes: Set<DependencyTypeShort>;
  * to a corresponding short form name, used in lockfiles.
  */
 export declare const dependencyTypes: Map<DependencyTypeLong, DependencyTypeShort>;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -1,5 +1,331 @@
 import { error } from '@vltpkg/error-cause';
-const integrityRE = /^sha512-[a-zA-Z0-9/+]{86}==$/;
+import { Version } from '@vltpkg/semver';
+/**
+ * Normalize a single funding entry to a consistent format.
+ */
+const normalizeFundingEntry = (item) => {
+    const getTypeFromUrl = (url) => {
+        try {
+            const { hostname } = new URL(url);
+            const domain = hostname.startsWith('www.') ? hostname.slice(4) : hostname;
+            if (domain === 'github.com')
+                return 'github';
+            if (domain === 'patreon.com')
+                return 'patreon';
+            if (domain === 'opencollective.com')
+                return 'opencollective';
+            return 'individual';
+        }
+        catch {
+            return 'invalid';
+        }
+    };
+    const validateType = (url, type) => {
+        const urlType = getTypeFromUrl(url);
+        if (!type ||
+            ['github', 'patreon', 'opencollective'].includes(urlType))
+            return urlType;
+        if (urlType === 'invalid')
+            return undefined;
+        return type;
+    };
+    if (typeof item === 'string') {
+        return { url: item, type: getTypeFromUrl(item) };
+    }
+    if (isObject(item) &&
+        'url' in item &&
+        typeof item.url === 'string') {
+        // If the item is already normalized, return it directly
+        if (isNormalizedFundingEntry(item)) {
+            return item;
+        }
+        const obj = item;
+        const url = obj.url;
+        const validatedType = validateType(url, obj.type);
+        const result = { ...obj, url };
+        if (validatedType) {
+            result.type = validatedType;
+        }
+        else {
+            delete result.type;
+        }
+        return result;
+    }
+    return { url: '', type: 'individual' };
+};
+/**
+ * Normalize funding information to a consistent format.
+ */
+export const normalizeFunding = (funding) => {
+    if (!funding)
+        return;
+    const fundingArray = Array.isArray(funding) ? funding : [funding];
+    const sources = fundingArray.map(normalizeFundingEntry);
+    return sources.length > 0 ? sources : undefined;
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedFundingEntry}.
+ */
+export const isNormalizedFundingEntry = (o) => {
+    return (isObject(o) &&
+        'url' in o &&
+        typeof o.url === 'string' &&
+        !!o.url &&
+        'type' in o &&
+        typeof o.type === 'string' &&
+        ['github', 'patreon', 'opencollective', 'individual'].includes(o.type));
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedFunding}.
+ */
+export const isNormalizedFunding = (o) => {
+    return (Array.isArray(o) &&
+        o.length > 0 &&
+        o.every(isNormalizedFundingEntry));
+};
+/**
+ * Given a version Normalize the version field in a manifest.
+ */
+export const fixManifestVersion = (manifest) => {
+    if (!Object.hasOwn(manifest, 'version')) {
+        return manifest;
+    }
+    if (!manifest.version) {
+        throw error('version is empty', {
+            manifest,
+        });
+    }
+    const version = Version.parse(manifest.version);
+    manifest.version = version.toString();
+    return manifest;
+};
+const kWriteAccess = Symbol.for('writeAccess');
+const kIsPublisher = Symbol.for('isPublisher');
+/**
+ * Parse a string or object into a normalized contributor.
+ */
+export const parsePerson = (person, writeAccess, isPublisher) => {
+    if (!person)
+        return;
+    if (isObject(person)) {
+        // this is an already parsed object person, just return its value
+        if (isNormalizedContributorEntry(person)) {
+            return person;
+        }
+        const name = typeof person.name === 'string' ? person.name : undefined;
+        const email = typeof person.email === 'string' ? person.email
+            : typeof person.mail === 'string' ? person.mail
+                : undefined;
+        if (!name && !email)
+            return undefined;
+        return {
+            name,
+            email,
+            [kWriteAccess]: writeAccess ?? false,
+            [kIsPublisher]: isPublisher ?? false,
+        };
+    }
+    else if (typeof person === 'string') {
+        const NAME_PATTERN = /^([^(<]+)/;
+        const EMAIL_PATTERN = /<([^<>]+)>/;
+        const name = NAME_PATTERN.exec(person)?.[0].trim() || '';
+        const email = EMAIL_PATTERN.exec(person)?.[1] || '';
+        if (!name && !email)
+            return undefined;
+        return {
+            name: name || undefined,
+            email: email || undefined,
+            [kWriteAccess]: writeAccess ?? false,
+            [kIsPublisher]: isPublisher ?? false,
+        };
+    }
+    return;
+};
+/**
+ * Type guard to check if a value is a normalized contributor entry.
+ */
+export const isNormalizedContributorEntry = (o) => {
+    return (isObject(o) &&
+        typeof o.name === 'string' &&
+        !!o.name &&
+        typeof o.email === 'string' &&
+        !!o.email &&
+        (isBoolean(o[kWriteAccess]) ||
+            isBoolean(o.writeAccess)) &&
+        (isBoolean(o[kIsPublisher]) ||
+            isBoolean(o.isPublisher)));
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedContributors}.
+ */
+export const isNormalizedContributors = (o) => {
+    return (Array.isArray(o) &&
+        o.length > 0 &&
+        o.every(isNormalizedContributorEntry));
+};
+/**
+ * Normalize contributors and maintainers from various formats
+ */
+export const normalizeContributors = (contributors, maintainers) => {
+    if (!contributors && !maintainers)
+        return;
+    const result = [];
+    // Parse regular contributors (if any)
+    if (contributors) {
+        const contributorsArray = Array.isArray(contributors) ? contributors : [contributors];
+        const normalizedArray = contributorsArray.every(isNormalizedContributorEntry);
+        const noMaintainers = !maintainers ||
+            (Array.isArray(maintainers) && maintainers.length === 0);
+        // If all contributors are already normalized, and there are
+        // no maintainers, return the contributors directly
+        if (normalizedArray) {
+            if (noMaintainers) {
+                return contributorsArray.length > 0 ?
+                    contributorsArray
+                    : undefined;
+            }
+            else {
+                result.push(...contributorsArray);
+            }
+        }
+        // Parse each contributor and filter out undefined values
+        const parsedContributors = contributorsArray
+            .map(person => parsePerson(person))
+            .filter((c) => c !== undefined);
+        result.push(...parsedContributors);
+    }
+    // Parse maintainers with special flags
+    if (maintainers) {
+        const maintainersArray = Array.isArray(maintainers) ? maintainers : [maintainers];
+        const parsedMaintainers = maintainersArray
+            .map(person => parsePerson(person, true, true))
+            .filter((c) => c !== undefined);
+        result.push(...parsedMaintainers);
+    }
+    return result.length > 0 ? result : undefined;
+};
+/**
+ * Helper function to normalize a single {@link Bugs} entry.
+ */
+const normalizeSingleBug = (bug) => {
+    const res = [];
+    if (typeof bug === 'string') {
+        // Try to parse as URL first - if it succeeds, treat as link
+        try {
+            new URL(bug);
+            res.push({ type: 'link', url: bug });
+        }
+        catch {
+            // TODO: need a more robust email validation, likely
+            // to be replaced with valibot / zod
+            // If URL parsing fails, check if it's a valid email
+            const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+            if (emailRegex.test(bug)) {
+                res.push({ type: 'email', email: bug });
+            }
+            else {
+                // Default to link for plain strings like 'example.com'
+                res.push({ type: 'link', url: bug });
+            }
+        }
+    }
+    else if (isObject(bug)) {
+        if (isNormalizedBugsEntry(bug)) {
+            res.push(bug);
+        }
+        const obj = bug;
+        if (obj.url) {
+            res.push({ type: 'link', url: obj.url });
+        }
+        if (obj.email) {
+            res.push({ type: 'email', email: obj.email });
+        }
+    }
+    return res.length > 0 ? res : [];
+};
+/**
+ * Normalize bugs information to a {@link NormalizedBugs} consistent format.
+ */
+export const normalizeBugs = (bugs) => {
+    if (!bugs)
+        return;
+    const result = [];
+    // Handle array of bugs entries
+    if (Array.isArray(bugs)) {
+        for (const bug of bugs) {
+            result.push(...normalizeSingleBug(bug));
+        }
+    }
+    else {
+        // Handle single bugs entry
+        result.push(...normalizeSingleBug(bugs));
+    }
+    return result.length > 0 ? result : undefined;
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedBugsEntry}.
+ */
+export const isNormalizedBugsEntry = (o) => {
+    return (isObject(o) &&
+        'type' in o &&
+        ((o.type === 'email' &&
+            typeof o.email === 'string' &&
+            !!o.email) ||
+            (o.type === 'link' && typeof o.url === 'string' && !!o.url)));
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedBugs}.
+ */
+export const isNormalizedBugs = (o) => {
+    return (Array.isArray(o) && o.length > 0 && o.every(isNormalizedBugsEntry));
+};
+/**
+ * Normalize keywords information to a {@link NormalizedKeywords} consistent format.
+ */
+export const normalizeKeywords = (keywords) => {
+    if (!keywords)
+        return;
+    let keywordArray = [];
+    if (typeof keywords === 'string') {
+        // Handle comma-separated string values
+        keywordArray = keywords
+            .split(',')
+            .map(keyword => keyword.trim())
+            .filter(keyword => keyword.length > 0);
+    }
+    else if (Array.isArray(keywords)) {
+        // If all keywords are already normalized, return them directly
+        if (isNormalizedKeywords(keywords)) {
+            return keywords;
+        }
+        // Handle array of strings, filter out empty/invalid entries
+        keywordArray = keywords
+            .filter((keyword) => typeof keyword === 'string')
+            .map(keyword => keyword.trim())
+            .filter(keyword => keyword.length > 0);
+    }
+    else {
+        // Invalid format
+        return;
+    }
+    return keywordArray.length > 0 ? keywordArray : undefined;
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedKeywords}.
+ */
+export const isNormalizedKeywords = (o) => {
+    return (Array.isArray(o) &&
+        o.length > 0 &&
+        o.every(keyword => typeof keyword === 'string' &&
+            !!keyword &&
+            !keyword.startsWith(' ') &&
+            !keyword.endsWith(' ')));
+};
+/**
+ * A type guard to check if a value is a boolean.
+ */
+export const isBoolean = (value) => typeof value === 'boolean';
+export const integrityRE = /^sha512-[a-zA-Z0-9/+]{86}==$/;
 export const isIntegrity = (i) => typeof i === 'string' && integrityRE.test(i);
 export const asIntegrity = (i) => {
     if (!isIntegrity(i)) {
@@ -13,7 +339,7 @@ export const asIntegrity = (i) => {
 export const assertIntegrity = i => {
     asIntegrity(i);
 };
-const keyIDRE = /^SHA256:[a-zA-Z0-9/+]{43}$/;
+export const keyIDRE = /^SHA256:[a-zA-Z0-9/+]{43}$/;
 export const isKeyID = (k) => typeof k === 'string' && keyIDRE.test(k);
 export const asKeyID = (k) => {
     if (!isKeyID(k)) {
@@ -27,19 +353,52 @@ export const asKeyID = (k) => {
 export const assertKeyID = k => {
     asKeyID(k);
 };
-const isObj = (o) => !!o && typeof o === 'object';
-const maybeRecordStringString = (o) => o === undefined || isRecordStringString(o);
-const isRecordStringString = (o) => isRecordStringT(o, s => typeof s === 'string');
-const isRecordStringT = (o, check) => isObj(o) &&
+/**
+ * Convert an unknown value to an error.
+ */
+export const asError = (er, fallbackMessage = 'Unknown error') => er instanceof Error ? er : new Error(String(er) || fallbackMessage);
+/**
+ * Check if a value is an error.
+ */
+export const isError = (er) => er instanceof Error;
+/**
+ * Check if an error has a cause property.
+ */
+export const isErrorWithCause = (er) => isError(er) && 'cause' in er;
+/**
+ * Check if an unknown value is a plain object.
+ */
+export const isObject = (v) => !!v &&
+    typeof v === 'object' &&
+    (v.constructor === Object ||
+        v.constructor === undefined);
+export const maybeRecordStringString = (o) => o === undefined || isRecordStringString(o);
+export const isRecordStringString = (o) => isRecordStringT(o, s => typeof s === 'string');
+export const assertRecordStringString = (o) => assertRecordStringT(o, s => typeof s === 'string', 'Record<string, string>');
+export const isRecordStringT = (o, check) => isObject(o) &&
     Object.entries(o).every(([k, v]) => typeof k === 'string' && check(v));
-const isRecordStringManifest = (o) => isRecordStringT(o, v => isManifest(v));
-const maybePeerDependenciesMetaSet = (o) => o === undefined ||
+export const assertRecordStringT = (o, check, 
+/** a type description, like 'Record<string, Record<string, string>>' */
+wanted) => {
+    if (!isRecordStringT(o, check)) {
+        throw error('Invalid record', {
+            found: o,
+            wanted,
+        });
+    }
+};
+export const isRecordStringManifest = (o) => isRecordStringT(o, v => isManifest(v));
+export const maybePeerDependenciesMetaSet = (o) => o === undefined ||
     isRecordStringT(o, v => isPeerDependenciesMetaValue(v));
-const maybeBoolean = (o) => o === undefined || typeof o === 'boolean';
-const isPeerDependenciesMetaValue = (o) => isObj(o) && maybeBoolean(o.optional);
-const maybeString = (a) => a === undefined || typeof a === 'string';
-const maybeDist = (a) => a === undefined || (isObj(a) && maybeString(a.tarball));
-export const isManifest = (m) => isObj(m) &&
+export const maybeBoolean = (o) => o === undefined || typeof o === 'boolean';
+export const isPeerDependenciesMetaValue = (o) => isObject(o) && maybeBoolean(o.optional);
+export const maybeString = (a) => a === undefined || typeof a === 'string';
+export const maybeDist = (a) => a === undefined || (isObject(a) && maybeString(a.tarball));
+/**
+ * Is a given unknown value a valid {@link Manifest} object?
+ * Returns `true` if so.
+ */
+export const isManifest = (m) => isObject(m) &&
     !Array.isArray(m) &&
     maybeString(m.name) &&
     maybeString(m.version) &&
@@ -50,19 +409,148 @@ export const isManifest = (m) => isObj(m) &&
     maybeRecordStringString(m.acceptDependencies) &&
     maybePeerDependenciesMetaSet(m.peerDependenciesMeta) &&
     maybeDist(m.dist);
+/**
+ * A specific {@link Manifest} that is retrieved uniquely from reading
+ * registry packument and manifest endpoints, it has `dist`, `name` and
+ * `version` fields defined.
+ */
 export const isManifestRegistry = (m) => isManifest(m) && !!m.dist && !!m.name && !!m.version;
+/**
+ * Given an unknown value, convert it to a {@link Manifest}.
+ */
 export const asManifest = (m, from) => {
     if (!isManifest(m)) {
         throw error('invalid manifest', { found: m }, from ?? asManifest);
     }
     return m;
 };
+/**
+ * Given a {@link Manifest} returns a {@link NormalizedManifest} that
+ * contains normalized author, bugs, funding, contributors, keywords and
+ * version fields.
+ */
+export const normalizeManifest = (manifest) => {
+    manifest = fixManifestVersion(manifest);
+    const normalizedAuthor = parsePerson(manifest.author);
+    const normalizedFunding = normalizeFunding(manifest.funding);
+    const normalizedContributors = normalizeContributors(manifest.contributors, manifest.maintainers);
+    const normalizedBugs = normalizeBugs(manifest.bugs);
+    const normalizedKeywords = normalizeKeywords(manifest.keywords);
+    // holds the same object reference but renames the variable here
+    // so that it's simpler to cast it to the normalized type
+    const normalizedManifest = manifest;
+    if (normalizedAuthor) {
+        normalizedManifest.author = normalizedAuthor;
+    }
+    else {
+        delete normalizedManifest.author;
+    }
+    if (normalizedFunding) {
+        normalizedManifest.funding = normalizedFunding;
+    }
+    else {
+        delete normalizedManifest.funding;
+    }
+    if (normalizedContributors) {
+        normalizedManifest.contributors = normalizedContributors;
+    }
+    else {
+        delete normalizedManifest.contributors;
+    }
+    if (normalizedBugs) {
+        normalizedManifest.bugs = normalizedBugs;
+    }
+    else {
+        delete normalizedManifest.bugs;
+    }
+    if (normalizedKeywords) {
+        normalizedManifest.keywords = normalizedKeywords;
+    }
+    else {
+        delete normalizedManifest.keywords;
+    }
+    // Remove maintainers field if it exists in the raw manifest
+    // this can only happen if the manifest is of ManifestRegistry type
+    if ('maintainers' in normalizedManifest &&
+        normalizedManifest.maintainers) {
+        delete normalizedManifest.maintainers;
+        return normalizedManifest;
+    }
+    return normalizedManifest;
+};
+/**
+ * Type guard to check if a value is a {@link NormalizedManifest}.
+ */
+export const isNormalizedManifest = (o) => {
+    return (isManifest(o) &&
+        // given that all these values are optional and potentially undefined
+        // we only check their value content if they are present
+        ('author' in o ? isNormalizedContributorEntry(o.author) : true) &&
+        ('contributors' in o ?
+            isNormalizedContributors(o.contributors)
+            : true) &&
+        ('funding' in o ? isNormalizedFunding(o.funding) : true) &&
+        ('bugs' in o ? isNormalizedBugs(o.bugs) : true) &&
+        ('keywords' in o ? isNormalizedKeywords(o.keywords) : true));
+};
+/**
+ * Given an unknown value, convert it to a {@link NormalizedManifest}.
+ */
+export const asNormalizedManifest = (m, from) => {
+    if (!isNormalizedManifest(m)) {
+        throw error('invalid normalized manifest', { found: m }, from ?? asNormalizedManifest);
+    }
+    return m;
+};
+/**
+ * Given an unknown value, convert it to a {@link ManifestRegistry}.
+ */
 export const asManifestRegistry = (m, from) => {
     if (!isManifestRegistry(m)) {
         throw error('invalid registry manifest', { found: m }, from ?? asManifestRegistry);
     }
     return m;
 };
+/**
+ * Type guard to check if a value is a {@link NormalizedManifestRegistry}.
+ */
+export const isNormalizedManifestRegistry = (o) => {
+    return isNormalizedManifest(o) && isManifestRegistry(o);
+};
+/**
+ * Given an unknown value, convert it to a {@link NormalizedManifestRegistry}.
+ */
+export const asNormalizedManifestRegistry = (m, from) => {
+    if (!isNormalizedManifestRegistry(m)) {
+        throw error('invalid normalized manifest registry', { found: m }, from ?? asNormalizedManifestRegistry);
+    }
+    return m;
+};
+/**
+ * Expands a normalized contributor entry by converting the
+ * in-memory symbols to their plain values.
+ */
+const expandNormalizedContributorEntrySymbols = (c) => {
+    return {
+        ...c,
+        writeAccess: c[kWriteAccess],
+        isPublisher: c[kIsPublisher],
+    };
+};
+/**
+ * Walks a normalized manifest and expands any symbols found
+ * in the `author` and `contributors` fields.
+ */
+export const expandNormalizedManifestSymbols = (m) => {
+    const res = { ...m };
+    if (isNormalizedContributorEntry(m.author)) {
+        res.author = expandNormalizedContributorEntrySymbols(m.author);
+    }
+    if (isNormalizedContributors(m.contributors)) {
+        res.contributors = m.contributors.map(expandNormalizedContributorEntrySymbols);
+    }
+    return res;
+};
 export const assertManifest = m => {
     asManifest(m, assertManifest);
 };
@@ -70,7 +558,7 @@ export const assertManifestRegistry = m => {
     asManifestRegistry(m, assertManifestRegistry);
 };
 export const isPackument = (p) => {
-    if (!isObj(p) || typeof p.name !== 'string')
+    if (!isObject(p) || typeof p.name !== 'string')
         return false;
     const { versions, 'dist-tags': distTags, time } = p;
     return (isRecordStringString(distTags) &&

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\n\n/** anything that can be encoded in JSON */\nexport type JSONField =\n  | JSONField[]\n  | boolean\n  | number\n  | string\n  | { [k: string]: JSONField }\n  | null\n  | undefined\n\n/** sha512 SRI string */\nexport type Integrity = `sha512-${string}`\n\n/** SHA256 key identifier */\nexport type KeyID = `SHA256:${string}`\n\n/** The Manifest['dist'] field present in registry manifests */\nexport type Dist = {\n  integrity?: Integrity\n  shasum?: string\n  tarball?: string\n  fileCount?: number\n  unpackedSize?: number\n  signatures?: {\n    keyid: KeyID\n    sig: string\n  }[]\n}\n\n/** An object used to mark some peerDeps as optional */\nexport type PeerDependenciesMetaValue = {\n  optional?: boolean\n}\n\n// Don't use Record here since TS cant do circular references with that\n// https://github.com/microsoft/TypeScript/issues/41164#issuecomment-1427073368\nexport type ConditionalValueObject = {\n  [k: string]: ConditionalValue\n}\n\nexport type ConditionalValue =\n  | ConditionalValue[]\n  | ConditionalValueObject\n  | string\n  | null\n\nexport type ExportsSubpaths = {\n  [path in '.' | `./${string}`]?: ConditionalValue\n}\n\nexport type Exports =\n  | Exclude<ConditionalValue, null>\n  | ExportsSubpaths\n\nexport type Imports = Record<`#${string}`, ConditionalValue>\n\nexport type FundingEntry = string | { url: string }\nexport type Funding = FundingEntry | FundingEntry[]\n\nexport type Person =\n  | string\n  | {\n      name: string\n      url?: string\n      email?: string\n    }\n\nexport type Repository =\n  | string\n  | {\n      type: string\n      url: string\n    }\n\nexport type Bugs =\n  | string\n  | {\n      url?: string\n      email?: string\n    }\n\nexport type Manifest = {\n  /** The name of the package. optional because {} is a valid package.json */\n  name?: string\n  /** The version of the package. optional because {} is a valid package.json */\n  version?: string\n  /** production dependencies, name:specifier */\n  dependencies?: Record<string, string>\n  /** development dependencies, name:specifier */\n  devDependencies?: Record<string, string>\n  /** optional dependencies, name:specifier */\n  optionalDependencies?: Record<string, string>\n  /** peer dependencies, name:specifier */\n  peerDependencies?: Record<string, string>\n  /** peer dependencies marked as optional */\n  peerDependenciesMeta?: Record<string, PeerDependenciesMetaValue>\n  /** dependency ranges that are acceptable, but not forced */\n  acceptDependencies?: Record<string, string>\n  /** names of dependencies included in the package tarball */\n  bundleDependencies?: string[]\n  /** a message indicating that this is not to be used */\n  deprecated?: string\n  /** executable built and linked by this package */\n  bin?: Record<string, string> | string\n  /** run-script actions for this package */\n  scripts?: Record<string, string>\n  /** supported run-time platforms this package can run on */\n  engines?: Record<string, string>\n  /** supported operating systems this package can run on */\n  os?: string[] | string\n  /** supported CPU architectures this package can run on */\n  cpu?: string[] | string\n  /** URLs that can be visited to fund this project */\n  funding?: Funding\n  /**\n   * Only present in Manifests served by a registry. Contains information\n   * about the artifact served for this package release.\n   */\n  dist?: Dist\n  /** a short description of the package */\n  description?: string\n  /** search keywords */\n  keywords?: string[]\n  /** where to go to file issues */\n  bugs?: Bugs\n  /** where the development happens */\n  repository?: Repository\n  /** the main module, if exports['.'] is not set */\n  main?: string\n  /** named subpath exports */\n  exports?: Exports\n  /** named #identifier imports */\n  imports?: Imports\n  /**\n   * the HEAD of the git repo this was published from\n   * only present in published packages\n   */\n  gitHead?: string\n  /** whether the package is private */\n  private?: boolean\n  /** whether this is ESM or CommonJS by default */\n  type?: 'commonjs' | 'module'\n  /** npm puts this on published manifests */\n  gypfile?: boolean\n  /** the author of a package */\n  author?: Person\n  /** contributors to the package */\n  contributors?: Person[]\n}\n\nexport type ManifestRegistry = Manifest &\n  Required<Pick<Manifest, 'name' | 'version' | 'dist'>>\n\nexport type Packument = {\n  name: string\n  'dist-tags': Record<string, string>\n  versions: Record<string, Manifest>\n  modified?: string\n  time?: Record<string, string>\n  readme?: string\n}\n\nexport type RefType = 'branch' | 'head' | 'other' | 'pull' | 'tag'\n\n/**\n * A representation of a given remote ref in a {@link RevDoc} object.\n */\nexport type RevDocEntry = Omit<Manifest, 'type'> &\n  Required<Pick<Manifest, 'version'>> & {\n    /** sha this references */\n    sha: string\n    /** ref as passed git locally */\n    ref: string\n    /** canonical full ref, like `refs/tags/blahblah` */\n    rawRef: string\n    /** what type of ref this is: 'branch', 'tag', etc. */\n    type: RefType\n  }\n\n/**\n * An object kind of resembling a packument, but about a git repo.\n */\nexport type RevDoc = Omit<Packument, 'versions'> & {\n  /** all semver-looking tags go in this record */\n  versions: Record<string, RevDocEntry>\n  /** all named things that can be cloned down remotely */\n  refs: Record<string, RevDocEntry>\n  /** all named shas referenced above */\n  shas: Record<string, string[]>\n}\n\nconst integrityRE = /^sha512-[a-zA-Z0-9/+]{86}==$/\nexport const isIntegrity = (i: unknown): i is Integrity =>\n  typeof i === 'string' && integrityRE.test(i)\n\nexport const asIntegrity = (i: unknown): Integrity => {\n  if (!isIntegrity(i)) {\n    throw error(\n      'invalid integrity',\n      {\n        found: i,\n        wanted: integrityRE,\n      },\n      asIntegrity,\n    )\n  }\n  return i\n}\n\nexport const assertIntegrity: (\n  i: unknown,\n) => asserts i is Integrity = i => {\n  asIntegrity(i)\n}\n\nconst keyIDRE = /^SHA256:[a-zA-Z0-9/+]{43}$/\nexport const isKeyID = (k: unknown): k is KeyID =>\n  typeof k === 'string' && keyIDRE.test(k)\n\nexport const asKeyID = (k: unknown): KeyID => {\n  if (!isKeyID(k)) {\n    throw error(\n      'invalid key ID',\n      {\n        found: k,\n        wanted: keyIDRE,\n      },\n      asKeyID,\n    )\n  }\n  return k\n}\n\nexport const assertKeyID: (k: unknown) => asserts k is KeyID = k => {\n  asKeyID(k)\n}\n\nconst isObj = (o: unknown): o is Record<string, unknown> =>\n  !!o && typeof o === 'object'\n\nconst maybeRecordStringString = (\n  o: unknown,\n): o is Record<string, string> | undefined =>\n  o === undefined || isRecordStringString(o)\n\nconst isRecordStringString = (\n  o: unknown,\n): o is Record<string, string> =>\n  isRecordStringT<string>(o, s => typeof s === 'string')\n\nconst isRecordStringT = <T>(\n  o: unknown,\n  check: (o: unknown) => boolean,\n): o is Record<string, T> =>\n  isObj(o) &&\n  Object.entries(o).every(\n    ([k, v]) => typeof k === 'string' && check(v),\n  )\n\nconst isRecordStringManifest = (\n  o: unknown,\n): o is Record<string, Manifest> =>\n  isRecordStringT<Manifest>(o, v => isManifest(v))\n\nconst maybePeerDependenciesMetaSet = (\n  o: unknown,\n): o is Record<string, PeerDependenciesMetaValue> | undefined =>\n  o === undefined ||\n  isRecordStringT<PeerDependenciesMetaValue>(o, v =>\n    isPeerDependenciesMetaValue(v),\n  )\n\nconst maybeBoolean = (o: unknown): o is boolean =>\n  o === undefined || typeof o === 'boolean'\n\nconst isPeerDependenciesMetaValue = (\n  o: unknown,\n): o is PeerDependenciesMetaValue =>\n  isObj(o) && maybeBoolean(o.optional)\n\nconst maybeString = (a: unknown): a is string | undefined =>\n  a === undefined || typeof a === 'string'\n\nconst maybeDist = (a: unknown): a is Manifest['dist'] =>\n  a === undefined || (isObj(a) && maybeString(a.tarball))\n\nexport const isManifest = (m: unknown): m is Manifest =>\n  isObj(m) &&\n  !Array.isArray(m) &&\n  maybeString(m.name) &&\n  maybeString(m.version) &&\n  maybeRecordStringString(m.dependencies) &&\n  maybeRecordStringString(m.devDependencies) &&\n  maybeRecordStringString(m.optionalDependencies) &&\n  maybeRecordStringString(m.peerDependencies) &&\n  maybeRecordStringString(m.acceptDependencies) &&\n  maybePeerDependenciesMetaSet(m.peerDependenciesMeta) &&\n  maybeDist(m.dist)\n\nexport const isManifestRegistry = (\n  m: unknown,\n): m is ManifestRegistry =>\n  isManifest(m) && !!m.dist && !!m.name && !!m.version\n\nexport const asManifest = (\n  m: unknown,\n  from?: (...a: unknown[]) => any,\n): Manifest => {\n  if (!isManifest(m)) {\n    throw error('invalid manifest', { found: m }, from ?? asManifest)\n  }\n  return m\n}\n\nexport const asManifestRegistry = (\n  m: unknown,\n  from?: (...a: unknown[]) => any,\n): ManifestRegistry => {\n  if (!isManifestRegistry(m)) {\n    throw error(\n      'invalid registry manifest',\n      { found: m },\n      from ?? asManifestRegistry,\n    )\n  }\n  return m\n}\n\nexport const assertManifest: (\n  m: unknown,\n) => asserts m is Manifest = m => {\n  asManifest(m, assertManifest)\n}\nexport const assertManifestRegistry: (\n  m: unknown,\n) => asserts m is ManifestRegistry = m => {\n  asManifestRegistry(m, assertManifestRegistry)\n}\n\nexport const isPackument = (p: unknown): p is Packument => {\n  if (!isObj(p) || typeof p.name !== 'string') return false\n  const { versions, 'dist-tags': distTags, time } = p\n  return (\n    isRecordStringString(distTags) &&\n    isRecordStringManifest(versions) &&\n    maybeRecordStringString(time) &&\n    Object.values(distTags).every(v => versions[v]?.name == p.name)\n  )\n}\n\nexport const asPackument = (\n  p: unknown,\n  from?: (...a: unknown[]) => any,\n): Packument => {\n  if (!isPackument(p)) {\n    throw error(\n      'invalid packument',\n      { found: p },\n      from ?? asPackument,\n    )\n  }\n  return p\n}\n\nexport const assertPackument: (\n  m: unknown,\n) => asserts m is Packument = m => {\n  asPackument(m)\n}\n\n/**\n * Name of the package.json keys used to define different types of dependencies.\n */\nexport type DependencyTypeLong =\n  | 'dependencies'\n  | 'devDependencies'\n  | 'optionalDependencies'\n  | 'peerDependencies'\n\n/**\n * Unique keys that define different types of dependencies relationship.\n */\nexport type DependencyTypeShort =\n  | 'dev'\n  | 'optional'\n  | 'peer'\n  | 'peerOptional'\n  | 'prod'\n\n/**\n * A set of the possible long dependency type names,\n * as used in `package.json` files.\n */\nexport const longDependencyTypes = new Set<DependencyTypeLong>([\n  'dependencies',\n  'devDependencies',\n  'peerDependencies',\n  'optionalDependencies',\n])\n\n/**\n * A set of the short type keys used to represent dependency relationships.\n */\nexport const shortDependencyTypes = new Set<DependencyTypeShort>([\n  'prod',\n  'dev',\n  'peer',\n  'optional',\n  'peerOptional',\n])\n\n/**\n * Maps between long form names usually used in `package.json` files\n * to a corresponding short form name, used in lockfiles.\n */\nexport const dependencyTypes = new Map<\n  DependencyTypeLong,\n  DependencyTypeShort\n>([\n  ['dependencies', 'prod'],\n  ['devDependencies', 'dev'],\n  ['peerDependencies', 'peer'],\n  ['optionalDependencies', 'optional'],\n])\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { Version } from '@vltpkg/semver'\n\n/**\n * Utility type that overrides specific properties of type T with new types\n * from R. Constrains override values to exclude undefined, ensuring that\n * normalization cannot introduce undefined to fields that shouldn't have it.\n */\nexport type Override<\n  T,\n  R extends { [K in keyof R]: R[K] extends undefined ? never : R[K] },\n> = {\n  [K in keyof T]: K extends keyof R ? R[K] : T[K]\n}\n\n/** anything that can be encoded in JSON */\nexport type JSONField =\n  | JSONField[]\n  | boolean\n  | number\n  | string\n  | { [k: string]: JSONField }\n  | null\n  | undefined\n\n/** sha512 SRI string */\nexport type Integrity = `sha512-${string}`\n\n/** SHA256 key identifier */\nexport type KeyID = `SHA256:${string}`\n\n/** The Manifest['dist'] field present in registry manifests */\nexport type Dist = {\n  integrity?: Integrity\n  shasum?: string\n  tarball?: string\n  fileCount?: number\n  unpackedSize?: number\n  signatures?: {\n    keyid: KeyID\n    sig: string\n  }[]\n}\n\n/** An object used to mark some peerDeps as optional */\nexport type PeerDependenciesMetaValue = {\n  optional?: boolean\n}\n\n// Don't use Record here since TS cant do circular references with that\n// https://github.com/microsoft/TypeScript/issues/41164#issuecomment-1427073368\nexport type ConditionalValueObject = {\n  [k: string]: ConditionalValue\n}\n\nexport type ConditionalValue =\n  | ConditionalValue[]\n  | ConditionalValueObject\n  | string\n  | null\n\nexport type ExportsSubpaths = {\n  [path in '.' | `./${string}`]?: ConditionalValue\n}\n\nexport type Exports =\n  | Exclude<ConditionalValue, null>\n  | ExportsSubpaths\n\nexport type Imports = Record<`#${string}`, ConditionalValue>\n\nexport type FundingEntry =\n  | string\n  | { url: string; type?: string; [key: string]: JSONField }\nexport type Funding = FundingEntry | FundingEntry[]\n\n/**\n * An object with url and optional additional properties\n */\nexport type NormalizedFundingEntry = {\n  url: string\n  type?: string\n  [key: string]: JSONField\n}\n\n/**\n * Normalized funding information, an array of {@link NormalizedFundingEntry}.\n */\nexport type NormalizedFunding = NormalizedFundingEntry[]\n\n/**\n * Normalize a single funding entry to a consistent format.\n */\nconst normalizeFundingEntry = (\n  item: unknown,\n): NormalizedFundingEntry => {\n  const getTypeFromUrl = (url: string): string => {\n    try {\n      const { hostname } = new URL(url)\n      const domain =\n        hostname.startsWith('www.') ? hostname.slice(4) : hostname\n      if (domain === 'github.com') return 'github'\n      if (domain === 'patreon.com') return 'patreon'\n      if (domain === 'opencollective.com') return 'opencollective'\n      return 'individual'\n    } catch {\n      return 'invalid'\n    }\n  }\n\n  const validateType = (\n    url: string,\n    type?: string,\n  ): string | undefined => {\n    const urlType = getTypeFromUrl(url)\n    if (\n      !type ||\n      ['github', 'patreon', 'opencollective'].includes(urlType)\n    )\n      return urlType\n    if (urlType === 'invalid') return undefined\n    return type\n  }\n\n  if (typeof item === 'string') {\n    return { url: item, type: getTypeFromUrl(item) }\n  }\n  if (\n    isObject(item) &&\n    'url' in item &&\n    typeof item.url === 'string'\n  ) {\n    // If the item is already normalized, return it directly\n    if (isNormalizedFundingEntry(item)) {\n      return item\n    }\n\n    const obj = item\n    const url = obj.url as string\n    const validatedType = validateType(\n      url,\n      obj.type as string | undefined,\n    )\n    const result = { ...obj, url } as Record<string, unknown>\n    if (validatedType) {\n      result.type = validatedType\n    } else {\n      delete result.type\n    }\n    return result as NormalizedFundingEntry\n  }\n  return { url: '', type: 'individual' }\n}\n\n/**\n * Normalize funding information to a consistent format.\n */\nexport const normalizeFunding = (\n  funding: unknown,\n): NormalizedFunding | undefined => {\n  if (!funding) return\n\n  const fundingArray = Array.isArray(funding) ? funding : [funding]\n  const sources = fundingArray.map(normalizeFundingEntry)\n  return sources.length > 0 ? sources : undefined\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedFundingEntry}.\n */\nexport const isNormalizedFundingEntry = (\n  o: unknown,\n): o is NormalizedFundingEntry => {\n  return (\n    isObject(o) &&\n    'url' in o &&\n    typeof o.url === 'string' &&\n    !!o.url &&\n    'type' in o &&\n    typeof o.type === 'string' &&\n    ['github', 'patreon', 'opencollective', 'individual'].includes(\n      o.type,\n    )\n  )\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedFunding}.\n */\nexport const isNormalizedFunding = (\n  o: unknown,\n): o is NormalizedFunding => {\n  return (\n    Array.isArray(o) &&\n    o.length > 0 &&\n    o.every(isNormalizedFundingEntry)\n  )\n}\n\n/**\n * Given a version Normalize the version field in a manifest.\n */\nexport const fixManifestVersion = <\n  T extends Manifest | ManifestRegistry,\n>(\n  manifest: T,\n): T => {\n  if (!Object.hasOwn(manifest, 'version')) {\n    return manifest\n  }\n  if (!manifest.version) {\n    throw error('version is empty', {\n      manifest,\n    })\n  }\n  const version = Version.parse(manifest.version)\n  manifest.version = version.toString()\n  return manifest\n}\n\nconst kWriteAccess = Symbol.for('writeAccess')\nconst kIsPublisher = Symbol.for('isPublisher')\n\n/**\n * Parse a string or object into a normalized contributor.\n */\nexport const parsePerson = (\n  person: unknown,\n  writeAccess?: boolean,\n  isPublisher?: boolean,\n): NormalizedContributorEntry | undefined => {\n  if (!person) return\n\n  if (isObject(person)) {\n    // this is an already parsed object person, just return its value\n    if (isNormalizedContributorEntry(person)) {\n      return person\n    }\n\n    const name =\n      typeof person.name === 'string' ? person.name : undefined\n    const email =\n      typeof person.email === 'string' ? person.email\n      : typeof person.mail === 'string' ? person.mail\n      : undefined\n\n    if (!name && !email) return undefined\n\n    return {\n      name,\n      email,\n      [kWriteAccess]: writeAccess ?? false,\n      [kIsPublisher]: isPublisher ?? false,\n    }\n  } else if (typeof person === 'string') {\n    const NAME_PATTERN = /^([^(<]+)/\n    const EMAIL_PATTERN = /<([^<>]+)>/\n    const name = NAME_PATTERN.exec(person)?.[0].trim() || ''\n    const email = EMAIL_PATTERN.exec(person)?.[1] || ''\n    if (!name && !email) return undefined\n    return {\n      name: name || undefined,\n      email: email || undefined,\n      [kWriteAccess]: writeAccess ?? false,\n      [kIsPublisher]: isPublisher ?? false,\n    }\n  }\n  return\n}\n\n/**\n * Normalized contributors - always an array of {@link NormalizedContributorEntry}.\n */\nexport type NormalizedContributors = NormalizedContributorEntry[]\n\n/**\n * Represents a normalized contributor object. This is the type that is\n * used in the {@link NormalizedManifest} and {@link NormalizedManifestRegistry}\n * objects.\n */\nexport type NormalizedContributorEntry = {\n  email?: string\n  name?: string\n  // in-memory we store those keys as symbols so that they\n  // don't get written to user-managed package.json files\n  [kWriteAccess]?: boolean\n  [kIsPublisher]?: boolean\n  // we also have a plain version that is used in the\n  // transfer data format and lockfiles\n  writeAccess?: boolean\n  isPublisher?: boolean\n}\n\n/**\n * Type guard to check if a value is a normalized contributor entry.\n */\nexport const isNormalizedContributorEntry = (\n  o: unknown,\n): o is NormalizedContributorEntry => {\n  return (\n    isObject(o) &&\n    typeof o.name === 'string' &&\n    !!o.name &&\n    typeof o.email === 'string' &&\n    !!o.email &&\n    (isBoolean((o as NormalizedContributorEntry)[kWriteAccess]) ||\n      isBoolean(o.writeAccess)) &&\n    (isBoolean((o as NormalizedContributorEntry)[kIsPublisher]) ||\n      isBoolean(o.isPublisher))\n  )\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedContributors}.\n */\nexport const isNormalizedContributors = (\n  o: unknown,\n): o is NormalizedContributors => {\n  return (\n    Array.isArray(o) &&\n    o.length > 0 &&\n    o.every(isNormalizedContributorEntry)\n  )\n}\n\n/**\n * Normalize contributors and maintainers from various formats\n */\nexport const normalizeContributors = (\n  contributors: unknown,\n  maintainers?: unknown,\n): NormalizedContributorEntry[] | undefined => {\n  if (!contributors && !maintainers) return\n\n  const result: NormalizedContributorEntry[] = []\n\n  // Parse regular contributors (if any)\n  if (contributors) {\n    const contributorsArray: unknown[] =\n      Array.isArray(contributors) ? contributors : [contributors]\n\n    const normalizedArray = contributorsArray.every(\n      isNormalizedContributorEntry,\n    )\n    const noMaintainers =\n      !maintainers ||\n      (Array.isArray(maintainers) && maintainers.length === 0)\n\n    // If all contributors are already normalized, and there are\n    // no maintainers, return the contributors directly\n    if (normalizedArray) {\n      if (noMaintainers) {\n        return contributorsArray.length > 0 ?\n            contributorsArray\n          : undefined\n      } else {\n        result.push(...contributorsArray)\n      }\n    }\n\n    // Parse each contributor and filter out undefined values\n    const parsedContributors = contributorsArray\n      .map(person => parsePerson(person))\n      .filter((c): c is NormalizedContributorEntry => c !== undefined)\n    result.push(...parsedContributors)\n  }\n\n  // Parse maintainers with special flags\n  if (maintainers) {\n    const maintainersArray: unknown[] =\n      Array.isArray(maintainers) ? maintainers : [maintainers]\n    const parsedMaintainers = maintainersArray\n      .map(person => parsePerson(person, true, true))\n      .filter((c): c is NormalizedContributorEntry => c !== undefined)\n    result.push(...parsedMaintainers)\n  }\n\n  return result.length > 0 ? result : undefined\n}\n\nexport type Person =\n  | string\n  | {\n      name: string\n      url?: string\n      email?: string\n    }\n\nexport type Repository =\n  | string\n  | {\n      type: string\n      url: string\n    }\n\nexport type Bugs =\n  | string\n  | {\n      url?: string\n      email?: string\n    }\n\nexport type Keywords = string[] | string\n\n/**\n * Normalized bugs entry - always an object with type and url/email\n */\nexport type NormalizedBugsEntry = {\n  type?: 'email' | 'link'\n  url?: string\n  email?: string\n}\n\n/**\n * Normalized keywords - always an array of strings\n */\nexport type NormalizedKeywords = string[]\n\n/**\n * Normalized bugs - always an array of {@link NormalizedBugsEntry}\n */\nexport type NormalizedBugs = NormalizedBugsEntry[]\n\n/**\n * Helper function to normalize a single {@link Bugs} entry.\n */\nconst normalizeSingleBug = (bug: unknown): NormalizedBugsEntry[] => {\n  const res: NormalizedBugsEntry[] = []\n\n  if (typeof bug === 'string') {\n    // Try to parse as URL first - if it succeeds, treat as link\n    try {\n      new URL(bug)\n      res.push({ type: 'link', url: bug })\n    } catch {\n      // TODO: need a more robust email validation, likely\n      // to be replaced with valibot / zod\n      // If URL parsing fails, check if it's a valid email\n      const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n      if (emailRegex.test(bug)) {\n        res.push({ type: 'email', email: bug })\n      } else {\n        // Default to link for plain strings like 'example.com'\n        res.push({ type: 'link', url: bug })\n      }\n    }\n  } else if (isObject(bug)) {\n    if (isNormalizedBugsEntry(bug)) {\n      res.push(bug)\n    }\n    const obj = bug as { url?: string; email?: string }\n\n    if (obj.url) {\n      res.push({ type: 'link', url: obj.url })\n    }\n    if (obj.email) {\n      res.push({ type: 'email', email: obj.email })\n    }\n  }\n\n  return res.length > 0 ? res : []\n}\n\n/**\n * Normalize bugs information to a {@link NormalizedBugs} consistent format.\n */\nexport const normalizeBugs = (\n  bugs: unknown,\n): NormalizedBugs | undefined => {\n  if (!bugs) return\n\n  const result: NormalizedBugsEntry[] = []\n\n  // Handle array of bugs entries\n  if (Array.isArray(bugs)) {\n    for (const bug of bugs) {\n      result.push(...normalizeSingleBug(bug))\n    }\n  } else {\n    // Handle single bugs entry\n    result.push(...normalizeSingleBug(bugs))\n  }\n\n  return result.length > 0 ? result : undefined\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedBugsEntry}.\n */\nexport const isNormalizedBugsEntry = (\n  o: unknown,\n): o is NormalizedBugsEntry => {\n  return (\n    isObject(o) &&\n    'type' in o &&\n    ((o.type === 'email' &&\n      typeof o.email === 'string' &&\n      !!o.email) ||\n      (o.type === 'link' && typeof o.url === 'string' && !!o.url))\n  )\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedBugs}.\n */\nexport const isNormalizedBugs = (o: unknown): o is NormalizedBugs => {\n  return (\n    Array.isArray(o) && o.length > 0 && o.every(isNormalizedBugsEntry)\n  )\n}\n\n/**\n * Normalize keywords information to a {@link NormalizedKeywords} consistent format.\n */\nexport const normalizeKeywords = (\n  keywords: unknown,\n): NormalizedKeywords | undefined => {\n  if (!keywords) return\n\n  let keywordArray: string[] = []\n\n  if (typeof keywords === 'string') {\n    // Handle comma-separated string values\n    keywordArray = keywords\n      .split(',')\n      .map(keyword => keyword.trim())\n      .filter(keyword => keyword.length > 0)\n  } else if (Array.isArray(keywords)) {\n    // If all keywords are already normalized, return them directly\n    if (isNormalizedKeywords(keywords)) {\n      return keywords as unknown as NormalizedKeywords\n    }\n    // Handle array of strings, filter out empty/invalid entries\n    keywordArray = keywords\n      .filter(\n        (keyword): keyword is string => typeof keyword === 'string',\n      )\n      .map(keyword => keyword.trim())\n      .filter(keyword => keyword.length > 0)\n  } else {\n    // Invalid format\n    return\n  }\n\n  return keywordArray.length > 0 ? keywordArray : undefined\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedKeywords}.\n */\nexport const isNormalizedKeywords = (\n  o: unknown,\n): o is NormalizedKeywords => {\n  return (\n    Array.isArray(o) &&\n    o.length > 0 &&\n    o.every(\n      keyword =>\n        typeof keyword === 'string' &&\n        !!keyword &&\n        !keyword.startsWith(' ') &&\n        !keyword.endsWith(' '),\n    )\n  )\n}\n\nexport type Manifest = {\n  /** The name of the package. optional because {} is a valid package.json */\n  name?: string\n  /** The version of the package. optional because {} is a valid package.json */\n  version?: string\n  /** production dependencies, name:specifier */\n  dependencies?: Record<string, string>\n  /** development dependencies, name:specifier */\n  devDependencies?: Record<string, string>\n  /** optional dependencies, name:specifier */\n  optionalDependencies?: Record<string, string>\n  /** peer dependencies, name:specifier */\n  peerDependencies?: Record<string, string>\n  /** peer dependencies marked as optional */\n  peerDependenciesMeta?: Record<string, PeerDependenciesMetaValue>\n  /** dependency ranges that are acceptable, but not forced */\n  acceptDependencies?: Record<string, string>\n  /** names of dependencies included in the package tarball */\n  bundleDependencies?: string[]\n  /** a message indicating that this is not to be used */\n  deprecated?: string\n  /** executable built and linked by this package */\n  bin?: Record<string, string> | string\n  /** run-script actions for this package */\n  scripts?: Record<string, string>\n  /** supported run-time platforms this package can run on */\n  engines?: Record<string, string>\n  /** supported operating systems this package can run on */\n  os?: string[] | string\n  /** supported CPU architectures this package can run on */\n  cpu?: string[] | string\n  /** URLs that can be visited to fund this project */\n  funding?: Funding\n  /** The homepage of the repository */\n  homepage?: string\n  /**\n   * Only present in Manifests served by a registry. Contains information\n   * about the artifact served for this package release.\n   */\n  dist?: Dist\n  /** a short description of the package */\n  description?: string\n  /** search keywords */\n  keywords?: Keywords\n  /** where to go to file issues */\n  bugs?: Bugs\n  /** where the development happens */\n  repository?: Repository\n  /** the main module, if exports['.'] is not set */\n  main?: string\n  /** named subpath exports */\n  exports?: Exports\n  /** named #identifier imports */\n  imports?: Imports\n  /**\n   * the HEAD of the git repo this was published from\n   * only present in published packages\n   */\n  gitHead?: string\n  /** whether the package is private */\n  private?: boolean\n  /** whether this is ESM or CommonJS by default */\n  type?: 'commonjs' | 'module'\n  /** npm puts this on published manifests */\n  gypfile?: boolean\n  /** the author of a package */\n  author?: Person\n  /** contributors to the package */\n  contributors?: Person[]\n  /** the license of the package */\n  license?: string\n}\n\nexport type NormalizedFields = {\n  bugs: NormalizedBugs | undefined\n  author: NormalizedContributorEntry | undefined\n  contributors: NormalizedContributors | undefined\n  funding: NormalizedFunding | undefined\n  keywords: NormalizedKeywords | undefined\n}\n\n/**\n * A {@link Manifest} object that contains normalized fields.\n */\nexport type NormalizedManifest = Override<Manifest, NormalizedFields>\n\n/**\n * A {@link ManifestRegistry} object that contains normalized fields.\n */\nexport type NormalizedManifestRegistry = Override<\n  ManifestRegistry,\n  NormalizedFields\n>\n\n/**\n * A specific type of {@link Manifest} that represents manifests that were\n * retrieved from a registry, these will always have `name`, `version`\n * and `dist` information along with an optional `maintainers` field.\n */\nexport type ManifestRegistry = Manifest &\n  Required<Pick<Manifest, 'name' | 'version' | 'dist'>> & {\n    maintainers?: unknown\n  }\n\n/**\n * Maps the manifest type to the equivalent normalized manifest type.\n */\nexport type SomeNormalizedManifest<T> =\n  T extends ManifestRegistry ? NormalizedManifestRegistry\n  : NormalizedManifest\n\n/**\n * A document that represents available package versions in a given registry\n * along with extra information, such as `dist-tags` and `maintainers` info.\n * The `versions` field is key-value structure in which keys are the\n * available versions of a given package and values are\n * {@link ManifestRegistry} objects.\n */\nexport type Packument = {\n  name: string\n  'dist-tags': Record<string, string>\n  versions: Record<string, Manifest>\n  modified?: string\n  time?: Record<string, string>\n  readme?: string\n  contributors?: Person[]\n  maintainers?: Person[]\n}\n\nexport type RefType = 'branch' | 'head' | 'other' | 'pull' | 'tag'\n\n/**\n * A representation of a given remote ref in a {@link RevDoc} object.\n */\nexport type RevDocEntry = Omit<Manifest, 'type'> &\n  Required<Pick<Manifest, 'version'>> & {\n    /** sha this references */\n    sha: string\n    /** ref as passed git locally */\n    ref: string\n    /** canonical full ref, like `refs/tags/blahblah` */\n    rawRef: string\n    /** what type of ref this is: 'branch', 'tag', etc. */\n    type: RefType\n  }\n\n/**\n * An object kind of resembling a packument, but about a git repo.\n */\nexport type RevDoc = Omit<Packument, 'versions'> & {\n  /** all semver-looking tags go in this record */\n  versions: Record<string, RevDocEntry>\n  /** all named things that can be cloned down remotely */\n  refs: Record<string, RevDocEntry>\n  /** all named shas referenced above */\n  shas: Record<string, string[]>\n}\n\n/**\n * A type guard to check if a value is a boolean.\n */\nexport const isBoolean = (value: unknown): value is boolean =>\n  typeof value === 'boolean'\n\nexport const integrityRE = /^sha512-[a-zA-Z0-9/+]{86}==$/\nexport const isIntegrity = (i: unknown): i is Integrity =>\n  typeof i === 'string' && integrityRE.test(i)\n\nexport const asIntegrity = (i: unknown): Integrity => {\n  if (!isIntegrity(i)) {\n    throw error(\n      'invalid integrity',\n      {\n        found: i,\n        wanted: integrityRE,\n      },\n      asIntegrity,\n    )\n  }\n  return i\n}\n\nexport const assertIntegrity: (\n  i: unknown,\n) => asserts i is Integrity = i => {\n  asIntegrity(i)\n}\n\nexport const keyIDRE = /^SHA256:[a-zA-Z0-9/+]{43}$/\nexport const isKeyID = (k: unknown): k is KeyID =>\n  typeof k === 'string' && keyIDRE.test(k)\n\nexport const asKeyID = (k: unknown): KeyID => {\n  if (!isKeyID(k)) {\n    throw error(\n      'invalid key ID',\n      {\n        found: k,\n        wanted: keyIDRE,\n      },\n      asKeyID,\n    )\n  }\n  return k\n}\n\nexport const assertKeyID: (k: unknown) => asserts k is KeyID = k => {\n  asKeyID(k)\n}\n\n/**\n * Convert an unknown value to an error.\n */\nexport const asError = (\n  er: unknown,\n  fallbackMessage = 'Unknown error',\n): Error =>\n  er instanceof Error ? er : new Error(String(er) || fallbackMessage)\n\n/**\n * Check if a value is an error.\n */\nexport const isError = (er: unknown): er is Error =>\n  er instanceof Error\n\n/**\n * Check if an error has a cause property.\n */\nexport const isErrorWithCause = (\n  er: unknown,\n): er is Error & { cause: unknown } => isError(er) && 'cause' in er\n\n/**\n * Check if an unknown value is a plain object.\n */\nexport const isObject = (v: unknown): v is Record<string, unknown> =>\n  !!v &&\n  typeof v === 'object' &&\n  (v.constructor === Object ||\n    (v.constructor as unknown) === undefined)\n\nexport const maybeRecordStringString = (\n  o: unknown,\n): o is Record<string, string> | undefined =>\n  o === undefined || isRecordStringString(o)\n\nexport const isRecordStringString = (\n  o: unknown,\n): o is Record<string, string> =>\n  isRecordStringT<string>(o, s => typeof s === 'string')\n\nexport const assertRecordStringString: (o: unknown) => void = (\n  o: unknown,\n): asserts o is Record<string, string> =>\n  assertRecordStringT<string>(\n    o,\n    s => typeof s === 'string',\n    'Record<string, string>',\n  )\n\nexport const isRecordStringT = <T>(\n  o: unknown,\n  check: (o: unknown) => o is T,\n): o is Record<string, T> =>\n  isObject(o) &&\n  Object.entries(o).every(\n    ([k, v]) => typeof k === 'string' && check(v),\n  )\n\nexport const assertRecordStringT: <T>(\n  o: unknown,\n  check: (o: unknown) => o is T,\n  wanted: string,\n) => asserts o is Record<string, T> = <T>(\n  o: unknown,\n  check: (o: unknown) => o is T,\n  /** a type description, like 'Record<string, Record<string, string>>' */\n  wanted: string,\n): asserts o is Record<string, T> => {\n  if (!isRecordStringT(o, check)) {\n    throw error('Invalid record', {\n      found: o,\n      wanted,\n    })\n  }\n}\n\nexport const isRecordStringManifest = (\n  o: unknown,\n): o is Record<string, Manifest> =>\n  isRecordStringT<Manifest>(o, v => isManifest(v))\n\nexport const maybePeerDependenciesMetaSet = (\n  o: unknown,\n): o is Record<string, PeerDependenciesMetaValue> | undefined =>\n  o === undefined ||\n  isRecordStringT<PeerDependenciesMetaValue>(o, v =>\n    isPeerDependenciesMetaValue(v),\n  )\n\nexport const maybeBoolean = (o: unknown): o is boolean =>\n  o === undefined || typeof o === 'boolean'\n\nexport const isPeerDependenciesMetaValue = (\n  o: unknown,\n): o is PeerDependenciesMetaValue =>\n  isObject(o) && maybeBoolean(o.optional)\n\nexport const maybeString = (a: unknown): a is string | undefined =>\n  a === undefined || typeof a === 'string'\n\nexport const maybeDist = (a: unknown): a is Manifest['dist'] =>\n  a === undefined || (isObject(a) && maybeString(a.tarball))\n\n/**\n * Is a given unknown value a valid {@link Manifest} object?\n * Returns `true` if so.\n */\nexport const isManifest = (m: unknown): m is Manifest =>\n  isObject(m) &&\n  !Array.isArray(m) &&\n  maybeString(m.name) &&\n  maybeString(m.version) &&\n  maybeRecordStringString(m.dependencies) &&\n  maybeRecordStringString(m.devDependencies) &&\n  maybeRecordStringString(m.optionalDependencies) &&\n  maybeRecordStringString(m.peerDependencies) &&\n  maybeRecordStringString(m.acceptDependencies) &&\n  maybePeerDependenciesMetaSet(m.peerDependenciesMeta) &&\n  maybeDist(m.dist)\n\n/**\n * A specific {@link Manifest} that is retrieved uniquely from reading\n * registry packument and manifest endpoints, it has `dist`, `name` and\n * `version` fields defined.\n */\nexport const isManifestRegistry = (\n  m: unknown,\n): m is ManifestRegistry =>\n  isManifest(m) && !!m.dist && !!m.name && !!m.version\n\n/**\n * Given an unknown value, convert it to a {@link Manifest}.\n */\nexport const asManifest = (\n  m: unknown,\n  from?: (...a: unknown[]) => any,\n): Manifest => {\n  if (!isManifest(m)) {\n    throw error('invalid manifest', { found: m }, from ?? asManifest)\n  }\n  return m\n}\n\n/**\n * Given a {@link Manifest} returns a {@link NormalizedManifest} that\n * contains normalized author, bugs, funding, contributors, keywords and\n * version fields.\n */\nexport const normalizeManifest = <\n  T extends Manifest | ManifestRegistry,\n>(\n  manifest: T,\n): SomeNormalizedManifest<T> => {\n  manifest = fixManifestVersion(manifest)\n\n  const normalizedAuthor = parsePerson(manifest.author)\n  const normalizedFunding = normalizeFunding(manifest.funding)\n  const normalizedContributors = normalizeContributors(\n    manifest.contributors,\n    (manifest as ManifestRegistry).maintainers,\n  )\n  const normalizedBugs = normalizeBugs(manifest.bugs)\n  const normalizedKeywords = normalizeKeywords(manifest.keywords)\n\n  // holds the same object reference but renames the variable here\n  // so that it's simpler to cast it to the normalized type\n  const normalizedManifest = manifest as SomeNormalizedManifest<T>\n\n  if (normalizedAuthor) {\n    normalizedManifest.author = normalizedAuthor\n  } else {\n    delete normalizedManifest.author\n  }\n\n  if (normalizedFunding) {\n    normalizedManifest.funding = normalizedFunding\n  } else {\n    delete normalizedManifest.funding\n  }\n\n  if (normalizedContributors) {\n    normalizedManifest.contributors = normalizedContributors\n  } else {\n    delete normalizedManifest.contributors\n  }\n\n  if (normalizedBugs) {\n    normalizedManifest.bugs = normalizedBugs\n  } else {\n    delete normalizedManifest.bugs\n  }\n\n  if (normalizedKeywords) {\n    normalizedManifest.keywords = normalizedKeywords\n  } else {\n    delete normalizedManifest.keywords\n  }\n\n  // Remove maintainers field if it exists in the raw manifest\n  // this can only happen if the manifest is of ManifestRegistry type\n  if (\n    'maintainers' in normalizedManifest &&\n    normalizedManifest.maintainers\n  ) {\n    delete normalizedManifest.maintainers\n    return normalizedManifest\n  }\n\n  return normalizedManifest\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedManifest}.\n */\nexport const isNormalizedManifest = (\n  o: unknown,\n): o is NormalizedManifest => {\n  return (\n    isManifest(o) &&\n    // given that all these values are optional and potentially undefined\n    // we only check their value content if they are present\n    ('author' in o ? isNormalizedContributorEntry(o.author) : true) &&\n    ('contributors' in o ?\n      isNormalizedContributors(o.contributors)\n    : true) &&\n    ('funding' in o ? isNormalizedFunding(o.funding) : true) &&\n    ('bugs' in o ? isNormalizedBugs(o.bugs) : true) &&\n    ('keywords' in o ? isNormalizedKeywords(o.keywords) : true)\n  )\n}\n\n/**\n * Given an unknown value, convert it to a {@link NormalizedManifest}.\n */\nexport const asNormalizedManifest = (\n  m: unknown,\n  from?: (...a: unknown[]) => any,\n): NormalizedManifest => {\n  if (!isNormalizedManifest(m)) {\n    throw error(\n      'invalid normalized manifest',\n      { found: m },\n      from ?? asNormalizedManifest,\n    )\n  }\n  return m\n}\n\n/**\n * Given an unknown value, convert it to a {@link ManifestRegistry}.\n */\nexport const asManifestRegistry = (\n  m: unknown,\n  from?: (...a: unknown[]) => any,\n): ManifestRegistry => {\n  if (!isManifestRegistry(m)) {\n    throw error(\n      'invalid registry manifest',\n      { found: m },\n      from ?? asManifestRegistry,\n    )\n  }\n  return m\n}\n\n/**\n * Type guard to check if a value is a {@link NormalizedManifestRegistry}.\n */\nexport const isNormalizedManifestRegistry = (\n  o: unknown,\n): o is NormalizedManifestRegistry => {\n  return isNormalizedManifest(o) && isManifestRegistry(o)\n}\n\n/**\n * Given an unknown value, convert it to a {@link NormalizedManifestRegistry}.\n */\nexport const asNormalizedManifestRegistry = (\n  m: unknown,\n  from?: (...a: unknown[]) => any,\n): NormalizedManifestRegistry => {\n  if (!isNormalizedManifestRegistry(m)) {\n    throw error(\n      'invalid normalized manifest registry',\n      { found: m },\n      from ?? asNormalizedManifestRegistry,\n    )\n  }\n  return m\n}\n\n/**\n * Expands a normalized contributor entry by converting the\n * in-memory symbols to their plain values.\n */\nconst expandNormalizedContributorEntrySymbols = (\n  c: NormalizedContributorEntry,\n): NormalizedContributorEntry => {\n  return {\n    ...c,\n    writeAccess: c[kWriteAccess],\n    isPublisher: c[kIsPublisher],\n  }\n}\n\n/**\n * Walks a normalized manifest and expands any symbols found\n * in the `author` and `contributors` fields.\n */\nexport const expandNormalizedManifestSymbols = (\n  m: NormalizedManifest,\n): NormalizedManifest => {\n  const res = { ...m }\n\n  if (isNormalizedContributorEntry(m.author)) {\n    res.author = expandNormalizedContributorEntrySymbols(m.author)\n  }\n\n  if (isNormalizedContributors(m.contributors)) {\n    res.contributors = m.contributors.map(\n      expandNormalizedContributorEntrySymbols,\n    )\n  }\n\n  return res\n}\n\nexport const assertManifest: (\n  m: unknown,\n) => asserts m is Manifest = m => {\n  asManifest(m, assertManifest)\n}\nexport const assertManifestRegistry: (\n  m: unknown,\n) => asserts m is ManifestRegistry = m => {\n  asManifestRegistry(m, assertManifestRegistry)\n}\n\nexport const isPackument = (p: unknown): p is Packument => {\n  if (!isObject(p) || typeof p.name !== 'string') return false\n  const { versions, 'dist-tags': distTags, time } = p\n  return (\n    isRecordStringString(distTags) &&\n    isRecordStringManifest(versions) &&\n    maybeRecordStringString(time) &&\n    Object.values(distTags).every(v => versions[v]?.name == p.name)\n  )\n}\n\nexport const asPackument = (\n  p: unknown,\n  from?: (...a: unknown[]) => any,\n): Packument => {\n  if (!isPackument(p)) {\n    throw error(\n      'invalid packument',\n      { found: p },\n      from ?? asPackument,\n    )\n  }\n  return p\n}\n\nexport const assertPackument: (\n  m: unknown,\n) => asserts m is Packument = m => {\n  asPackument(m)\n}\n\n/**\n * Name of the package.json keys used to define different types of dependencies.\n */\nexport type DependencyTypeLong =\n  | 'dependencies'\n  | 'devDependencies'\n  | 'optionalDependencies'\n  | 'peerDependencies'\n\n/**\n * Unique keys that define different types of dependencies relationship.\n */\nexport type DependencyTypeShort =\n  | 'dev'\n  | 'optional'\n  | 'peer'\n  | 'peerOptional'\n  | 'prod'\n\n/**\n * Unique keys that indicate how a new or updated dependency should be saved\n * back to a manifest.\n *\n * `'implicit'` is used to indicate that a dependency should be saved as\n * whatever type it already exists as. If the dependency does not exist,\n * then `'implicit'` is equivalent to `'prod'`, as that is the default\n * save type.\n */\nexport type DependencySaveType = DependencyTypeShort | 'implicit'\n\n/**\n * A set of the possible long dependency type names,\n * as used in `package.json` files.\n */\nexport const longDependencyTypes = new Set<DependencyTypeLong>([\n  'dependencies',\n  'devDependencies',\n  'peerDependencies',\n  'optionalDependencies',\n])\n\n/**\n * A set of the short type keys used to represent dependency relationships.\n */\nexport const shortDependencyTypes = new Set<DependencyTypeShort>([\n  'prod',\n  'dev',\n  'peer',\n  'optional',\n  'peerOptional',\n])\n\n/**\n * Maps between long form names usually used in `package.json` files\n * to a corresponding short form name, used in lockfiles.\n */\nexport const dependencyTypes = new Map<\n  DependencyTypeLong,\n  DependencyTypeShort\n>([\n  ['dependencies', 'prod'],\n  ['devDependencies', 'dev'],\n  ['peerDependencies', 'peer'],\n  ['optionalDependencies', 'optional'],\n])\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vltpkg/types",
   "description": "definitions for some of vlt's core types",
-  "version": "0.0.0-2",
+  "version": "0.0.0-20",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
@@ -19,19 +19,19 @@
     }
   },
   "dependencies": {
-    "@vltpkg/error-cause": "0.0.0-2"
+    "@vltpkg/error-cause": "0.0.0-20",
+    "@vltpkg/semver": "0.0.0-20"
   },
   "devDependencies": {
-    "@eslint/js": "^9.20.0",
-    "@types/eslint__js": "^8.42.3",
-    "@types/node": "^22.13.1",
-    "eslint": "^9.20.0",
-    "prettier": "^3.4.2",
+    "@eslint/js": "^9.28.0",
+    "@types/node": "^22.15.29",
+    "eslint": "^9.28.0",
+    "prettier": "^3.6.0",
     "tap": "^21.1.0",
     "tshy": "^3.0.2",
-    "typedoc": "0.27.6",
+    "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.23.0"
+    "typescript-eslint": "^8.33.1"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {
@@ -63,6 +63,7 @@
     "snap": "tap",
     "test": "tap",
     "posttest": "tsc --noEmit",
+    "tshy": "tshy",
     "typecheck": "tsc --noEmit"
   }
 }