@pnpm/registry-access.commands 1100.1.0 → 1100.2.1

package/lib/common.d.ts

@@ -1,5 +1,7 @@
 export declare function rcOptionsTypes(): Record<string, unknown>;
 export declare function parsePackageSpec(spec: string): {
     name: string;
+    escapedName: string;
     versionRange: string | undefined;
 };
+export declare function normalizeRegistryUrl(registryUrl: string): string;

package/lib/common.js

@@ -15,10 +15,13 @@ export function parsePackageSpec(spec) {
     catch {
         throw new PnpmError('INVALID_PACKAGE_SPEC', `Invalid package spec: ${spec}`);
     }
-    if (!parsed.name) {
+    if (!parsed.name || !parsed.escapedName) {
         throw new PnpmError('INVALID_PACKAGE_SPEC', `Invalid package spec: ${spec}`);
     }
     const versionRange = parsed.rawSpec || undefined;
-    return { name: parsed.name, versionRange };
+    return { name: parsed.name, escapedName: parsed.escapedName, versionRange };
+}
+export function normalizeRegistryUrl(registryUrl) {
+    return registryUrl.endsWith('/') ? registryUrl : `${registryUrl}/`;
 }
 //# sourceMappingURL=common.js.map

package/lib/index.d.ts

@@ -3,5 +3,9 @@ import * as undeprecate from './deprecation/undeprecate.js';
 import * as distTag from './distTag.js';
 import * as ping from './ping.js';
 import * as search from './search.js';
+import * as star from './star/star.js';
+import * as stars from './star/stars.js';
+import * as unstar from './star/unstar.js';
 import * as unpublish from './unpublish.js';
-export { deprecate, distTag, ping, search, undeprecate, unpublish };
+import * as whoami from './whoami.js';
+export { deprecate, distTag, ping, search, star, stars, undeprecate, unpublish, unstar, whoami };

package/lib/index.js

@@ -3,6 +3,10 @@ import * as undeprecate from './deprecation/undeprecate.js';
 import * as distTag from './distTag.js';
 import * as ping from './ping.js';
 import * as search from './search.js';
+import * as star from './star/star.js';
+import * as stars from './star/stars.js';
+import * as unstar from './star/unstar.js';
 import * as unpublish from './unpublish.js';
-export { deprecate, distTag, ping, search, undeprecate, unpublish };
+import * as whoami from './whoami.js';
+export { deprecate, distTag, ping, search, star, stars, undeprecate, unpublish, unstar, whoami };
 //# sourceMappingURL=index.js.map

package/lib/star/common.d.ts

@@ -0,0 +1,15 @@
+import { type CreateFetchFromRegistryOptions } from '@pnpm/network.fetch';
+import type { Registries, RegistryConfig } from '@pnpm/types';
+export declare function cliOptionsTypes(): Record<string, unknown>;
+export declare function rcOptionsTypes(): Record<string, unknown>;
+export interface StarOptions extends CreateFetchFromRegistryOptions {
+    configByUri?: Record<string, RegistryConfig>;
+    registries?: Registries;
+}
+interface StarActionArgs {
+    packageName: string;
+    star: boolean;
+}
+export declare function performStarAction(opts: StarOptions, { packageName, star }: StarActionArgs): Promise<void>;
+export declare function getAuthHeaderForRegistry(configByUri: Record<string, RegistryConfig> | undefined, registryUrl: string): string | undefined;
+export {};

package/lib/star/common.js

@@ -0,0 +1,93 @@
+import { pickRegistryForPackage } from '@pnpm/config.pick-registry-for-package';
+import { PnpmError } from '@pnpm/error';
+import { createGetAuthHeaderByURI } from '@pnpm/network.auth-header';
+import { createFetchFromRegistry } from '@pnpm/network.fetch';
+import { normalizeRegistryUrl, parsePackageSpec, rcOptionsTypes as commonRcOptionsTypes } from '../common.js';
+import { fetchWhoami } from '../whoami.js';
+export function cliOptionsTypes() {
+    return {
+        ...commonRcOptionsTypes(),
+    };
+}
+export function rcOptionsTypes() {
+    return commonRcOptionsTypes();
+}
+export async function performStarAction(opts, { packageName, star }) {
+    const { escapedName } = parsePackageSpec(packageName);
+    const registryUrl = normalizeRegistryUrl(pickRegistryForPackage(opts.registries ?? { default: 'https://registry.npmjs.org/' }, packageName));
+    const authHeader = getAuthHeaderForRegistry(opts.configByUri, registryUrl);
+    const action = star ? 'star' : 'unstar';
+    if (!authHeader) {
+        throw new PnpmError('STAR_UNAUTHORIZED', `You must be logged in to ${action} packages`);
+    }
+    const fetchFromRegistry = createFetchFromRegistry(opts);
+    const method = star ? 'PUT' : 'DELETE';
+    const starUrl = new URL('./-/user/v1/star', registryUrl).href;
+    let response = await fetchFromRegistry(starUrl, {
+        authHeaderValue: authHeader,
+        method,
+        headers: {
+            'content-type': 'application/json',
+        },
+        body: JSON.stringify({ name: packageName, package: packageName }),
+    });
+    if (!response.ok) {
+        const altStarUrl = new URL(`./-/user/package/${escapedName}/star`, registryUrl).href;
+        response = await fetchFromRegistry(altStarUrl, {
+            authHeaderValue: authHeader,
+            method,
+            headers: {
+                'content-type': 'application/json',
+            },
+        });
+    }
+    if (!response.ok) {
+        if (response.status === 404 || response.status === 405 || response.status === 400 || response.status === 500) {
+            return performLegacyStarAction({ packageName, escapedName, star, registryUrl, authHeader, fetchFromRegistry });
+        }
+        const errorBody = await response.text();
+        throw new PnpmError('REGISTRY_ERROR', `Failed to ${action} package: ${response.status} ${response.statusText}. ${errorBody}`);
+    }
+}
+async function performLegacyStarAction(args) {
+    const { packageName, escapedName, star, registryUrl, authHeader, fetchFromRegistry } = args;
+    const action = star ? 'star' : 'unstar';
+    const username = await fetchWhoami(registryUrl, fetchFromRegistry, authHeader);
+    const pkgUrl = new URL(`./${escapedName}`, registryUrl).href;
+    const response = await fetchFromRegistry(pkgUrl, {
+        authHeaderValue: authHeader,
+        fullMetadata: true,
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new PnpmError('PACKAGE_NOT_FOUND', `Package "${packageName}" not found in registry`);
+        }
+        throw new PnpmError('REGISTRY_ERROR', `Failed to fetch package info: ${response.status} ${response.statusText}`);
+    }
+    const pkgData = await response.json();
+    pkgData.users = pkgData.users || {};
+    if (star) {
+        pkgData.users[username] = true;
+    }
+    else {
+        delete pkgData.users[username];
+    }
+    const updateUrl = pkgData._rev ? `${pkgUrl}/-rev/${pkgData._rev}` : pkgUrl;
+    const updateResponse = await fetchFromRegistry(updateUrl, {
+        authHeaderValue: authHeader,
+        method: 'PUT',
+        headers: {
+            'content-type': 'application/json',
+        },
+        body: JSON.stringify(pkgData),
+    });
+    if (!updateResponse.ok) {
+        const errorBody = await updateResponse.text();
+        throw new PnpmError('REGISTRY_ERROR', `Failed to ${action} package (legacy): ${updateResponse.status} ${updateResponse.statusText}. ${errorBody}`);
+    }
+}
+export function getAuthHeaderForRegistry(configByUri, registryUrl) {
+    const getAuthHeader = createGetAuthHeaderByURI(configByUri ?? {}, registryUrl);
+    return getAuthHeader(registryUrl);
+}
+//# sourceMappingURL=common.js.map

package/lib/star/star.d.ts

@@ -0,0 +1,5 @@
+import { cliOptionsTypes, rcOptionsTypes, type StarOptions } from './common.js';
+export { cliOptionsTypes, rcOptionsTypes };
+export declare const commandNames: string[];
+export declare function help(): string;
+export declare function handler(opts: StarOptions, params: string[]): Promise<void>;

package/lib/star/star.js

@@ -0,0 +1,20 @@
+import { docsUrl } from '@pnpm/cli.utils';
+import { PnpmError } from '@pnpm/error';
+import { renderHelp } from 'render-help';
+import { cliOptionsTypes, performStarAction, rcOptionsTypes } from './common.js';
+export { cliOptionsTypes, rcOptionsTypes };
+export const commandNames = ['star'];
+export function help() {
+    return renderHelp({
+        description: 'Marks a package as a favorite.',
+        url: docsUrl('star'),
+        usages: ['pnpm star <package>'],
+    });
+}
+export async function handler(opts, params) {
+    if (params.length === 0) {
+        throw new PnpmError('STAR_PACKAGE_REQUIRED', 'Package name is required');
+    }
+    await performStarAction(opts, { packageName: params[0], star: true });
+}
+//# sourceMappingURL=star.js.map

package/lib/star/stars.d.ts

@@ -0,0 +1,5 @@
+import { cliOptionsTypes, rcOptionsTypes, type StarOptions } from './common.js';
+export { cliOptionsTypes, rcOptionsTypes };
+export declare const commandNames: string[];
+export declare function help(): string;
+export declare function handler(opts: StarOptions, params: string[]): Promise<string>;

package/lib/star/stars.js

@@ -0,0 +1,61 @@
+import { docsUrl } from '@pnpm/cli.utils';
+import { PnpmError } from '@pnpm/error';
+import { createFetchFromRegistry } from '@pnpm/network.fetch';
+import { renderHelp } from 'render-help';
+import { normalizeRegistryUrl } from '../common.js';
+import { fetchWhoami } from '../whoami.js';
+import { cliOptionsTypes, getAuthHeaderForRegistry, rcOptionsTypes } from './common.js';
+export { cliOptionsTypes, rcOptionsTypes };
+export const commandNames = ['stars'];
+export function help() {
+    return renderHelp({
+        description: 'Lists all packages starred by a specific user.',
+        url: docsUrl('stars'),
+        usages: ['pnpm stars [<user>]'],
+    });
+}
+export async function handler(opts, params) {
+    const registryUrl = normalizeRegistryUrl(opts.registries?.default ?? 'https://registry.npmjs.org/');
+    const fetchFromRegistry = createFetchFromRegistry(opts);
+    const authHeader = getAuthHeaderForRegistry(opts.configByUri, registryUrl);
+    let username = params[0];
+    if (!username) {
+        if (!authHeader) {
+            throw new PnpmError('STARS_UNAUTHORIZED', 'You must be logged in to list your starred packages');
+        }
+        username = await fetchWhoami(registryUrl, fetchFromRegistry, authHeader);
+    }
+    if (!params[0]) {
+        const starUrl = new URL('./-/user/v1/star', registryUrl).href;
+        const response = await fetchFromRegistry(starUrl, {
+            authHeaderValue: authHeader,
+        });
+        if (response.ok) {
+            const starsData = await response.json();
+            if (Array.isArray(starsData))
+                return starsData.join('\n');
+            if (typeof starsData === 'object' && starsData !== null) {
+                return Object.keys(starsData).join('\n');
+            }
+        }
+    }
+    const starsUrl = new URL(`./-/user/${encodeURIComponent(username)}/stars`, registryUrl).href;
+    let response = await fetchFromRegistry(starsUrl, {
+        authHeaderValue: authHeader,
+    });
+    if (!response.ok) {
+        const utilStarsUrl = new URL(`./-/util/user/${encodeURIComponent(username)}/stars`, registryUrl).href;
+        response = await fetchFromRegistry(utilStarsUrl, {
+            authHeaderValue: authHeader,
+        });
+    }
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new PnpmError('USER_NOT_FOUND', `User "${username}" not found`);
+        }
+        throw new PnpmError('REGISTRY_ERROR', `Failed to fetch stars: ${response.status} ${response.statusText}`);
+    }
+    const starsData = await response.json();
+    return Object.keys(starsData).join('\n');
+}
+//# sourceMappingURL=stars.js.map

package/lib/star/unstar.d.ts

@@ -0,0 +1,5 @@
+import { cliOptionsTypes, rcOptionsTypes, type StarOptions } from './common.js';
+export { cliOptionsTypes, rcOptionsTypes };
+export declare const commandNames: string[];
+export declare function help(): string;
+export declare function handler(opts: StarOptions, params: string[]): Promise<void>;

package/lib/star/unstar.js

@@ -0,0 +1,20 @@
+import { docsUrl } from '@pnpm/cli.utils';
+import { PnpmError } from '@pnpm/error';
+import { renderHelp } from 'render-help';
+import { cliOptionsTypes, performStarAction, rcOptionsTypes } from './common.js';
+export { cliOptionsTypes, rcOptionsTypes };
+export const commandNames = ['unstar'];
+export function help() {
+    return renderHelp({
+        description: 'Removes a package from your favorites.',
+        url: docsUrl('unstar'),
+        usages: ['pnpm unstar <package>'],
+    });
+}
+export async function handler(opts, params) {
+    if (params.length === 0) {
+        throw new PnpmError('UNSTAR_PACKAGE_REQUIRED', 'Package name is required');
+    }
+    await performStarAction(opts, { packageName: params[0], star: false });
+}
+//# sourceMappingURL=unstar.js.map

package/lib/whoami.d.ts

@@ -0,0 +1,12 @@
+import { type CreateFetchFromRegistryOptions, type FetchFromRegistry } from '@pnpm/network.fetch';
+import type { Registries, RegistryConfig } from '@pnpm/types';
+export declare function cliOptionsTypes(): Record<string, unknown>;
+export declare function rcOptionsTypes(): Record<string, unknown>;
+export interface WhoamiOptions extends CreateFetchFromRegistryOptions {
+    configByUri?: Record<string, RegistryConfig>;
+    registries?: Registries;
+}
+export declare const commandNames: string[];
+export declare function help(): string;
+export declare function handler(opts: WhoamiOptions): Promise<string>;
+export declare function fetchWhoami(registryUrl: string, fetchFromRegistry: FetchFromRegistry, authHeader: string): Promise<string>;

package/lib/whoami.js

@@ -0,0 +1,43 @@
+import { docsUrl } from '@pnpm/cli.utils';
+import { PnpmError } from '@pnpm/error';
+import { createGetAuthHeaderByURI } from '@pnpm/network.auth-header';
+import { createFetchFromRegistry } from '@pnpm/network.fetch';
+import { renderHelp } from 'render-help';
+import { normalizeRegistryUrl, rcOptionsTypes as commonRcOptionsTypes } from './common.js';
+export function cliOptionsTypes() {
+    return {
+        ...commonRcOptionsTypes(),
+    };
+}
+export function rcOptionsTypes() {
+    return commonRcOptionsTypes();
+}
+export const commandNames = ['whoami'];
+export function help() {
+    return renderHelp({
+        description: 'Displays your pnpm username.',
+        url: docsUrl('whoami'),
+        usages: ['pnpm whoami'],
+    });
+}
+export async function handler(opts) {
+    const registryUrl = normalizeRegistryUrl(opts.registries?.default ?? 'https://registry.npmjs.org/');
+    const getAuthHeader = createGetAuthHeaderByURI(opts.configByUri ?? {}, registryUrl);
+    const authHeader = getAuthHeader(registryUrl);
+    if (!authHeader) {
+        throw new PnpmError('WHOAMI_UNAUTHORIZED', 'You must be logged in to use whoami');
+    }
+    return fetchWhoami(registryUrl, createFetchFromRegistry(opts), authHeader);
+}
+export async function fetchWhoami(registryUrl, fetchFromRegistry, authHeader) {
+    const whoamiUrl = new URL('./-/whoami', normalizeRegistryUrl(registryUrl)).href;
+    const response = await fetchFromRegistry(whoamiUrl, {
+        authHeaderValue: authHeader,
+    });
+    if (!response.ok) {
+        throw new PnpmError('WHOAMI_FAILED', `Failed to find the current user: ${response.status} ${response.statusText}`);
+    }
+    const { username } = await response.json();
+    return username;
+}
+//# sourceMappingURL=whoami.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/registry-access.commands",
-  "version": "1100.1.0",
+  "version": "1100.2.1",
   "description": "Commands for managing packages on the registry",
   "keywords": [
     "pnpm",
@@ -29,14 +29,14 @@
     "ramda": "npm:@pnpm/ramda@0.28.1",
     "render-help": "^2.0.0",
     "semver": "^7.7.2",
-    "@pnpm/config.reader": "1100.0.1",
     "@pnpm/config.pick-registry-for-package": "1100.0.1",
-    "@pnpm/error": "1100.0.0",
+    "@pnpm/config.reader": "1101.1.0",
     "@pnpm/network.auth-header": "1100.0.1",
     "@pnpm/network.fetch": "1100.0.1",
+    "@pnpm/types": "1101.0.0",
+    "@pnpm/error": "1100.0.0",
     "@pnpm/resolving.registry.types": "1100.0.1",
-    "@pnpm/cli.utils": "1100.0.1",
-    "@pnpm/types": "1101.0.0"
+    "@pnpm/cli.utils": "1101.0.0"
   },
   "devDependencies": {
     "@jest/globals": "30.3.0",
@@ -44,11 +44,11 @@
     "@types/ramda": "0.31.1",
     "@types/semver": "7.7.1",
     "execa": "npm:safe-execa@0.3.0",
-    "@pnpm/prepare": "1100.0.1",
-    "@pnpm/registry-access.commands": "1100.1.0",
-    "@pnpm/testing.command-defaults": "1100.0.0",
-    "@pnpm/testing.mock-agent": "1100.0.1",
-    "@pnpm/releasing.commands": "1100.0.1"
+    "@pnpm/prepare": "1100.0.2",
+    "@pnpm/registry-access.commands": "1100.2.1",
+    "@pnpm/releasing.commands": "1100.1.0",
+    "@pnpm/testing.command-defaults": "1100.0.1",
+    "@pnpm/testing.mock-agent": "1100.0.1"
   },
   "engines": {
     "node": ">=22.13"