@pnpm/registry-access.commands 1100.2.8 → 1100.2.10

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 import * as deprecate from './deprecation/deprecate.js';
 import * as undeprecate from './deprecation/undeprecate.js';
 import * as distTag from './distTag.js';
+import * as owner from './owner.js';
 import * as ping from './ping.js';
 import * as search from './search.js';
 import * as star from './star/star.js';
@@ -8,4 +9,4 @@ import * as stars from './star/stars.js';
 import * as unstar from './star/unstar.js';
 import * as unpublish from './unpublish.js';
 import * as whoami from './whoami.js';
-export { deprecate, distTag, ping, search, star, stars, undeprecate, unpublish, unstar, whoami };
+export { deprecate, distTag, owner, ping, search, star, stars, undeprecate, unpublish, unstar, whoami };

package/lib/index.js

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

package/lib/owner.d.ts

@@ -0,0 +1,15 @@
+import { type CreateFetchFromRegistryOptions } from '@pnpm/network.fetch';
+import type { Registries, RegistryConfig } from '@pnpm/types';
+import { rcOptionsTypes } from './common.js';
+export { rcOptionsTypes };
+export declare function cliOptionsTypes(): Record<string, unknown>;
+export declare const commandNames: string[];
+export declare function help(): string;
+export interface OwnerOptions extends CreateFetchFromRegistryOptions {
+    cliOptions?: {
+        otp?: string;
+    };
+    configByUri?: Record<string, RegistryConfig>;
+    registries?: Registries;
+}
+export declare function handler(opts: OwnerOptions, params: string[]): Promise<string>;

package/lib/owner.js

@@ -0,0 +1,172 @@
+import { docsUrl } from '@pnpm/cli.utils';
+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 { renderHelp } from 'render-help';
+import { parsePackageSpec, rcOptionsTypes } from './common.js';
+export { rcOptionsTypes };
+export function cliOptionsTypes() {
+    return {
+        ...rcOptionsTypes(),
+        otp: String,
+    };
+}
+export const commandNames = ['owner', 'owners'];
+export function help() {
+    return renderHelp({
+        description: 'Manages package owners on the registry.',
+        descriptionLists: [
+            {
+                title: 'Commands',
+                list: [
+                    {
+                        description: 'List all owners of a package. Default if no subcommand is given.',
+                        name: 'ls',
+                    },
+                    {
+                        description: 'Add an owner to a package.',
+                        name: 'add',
+                    },
+                    {
+                        description: 'Remove an owner from a package.',
+                        name: 'rm',
+                    },
+                ],
+            },
+            {
+                title: 'Options',
+                list: [
+                    {
+                        description: 'The base URL of the npm registry.',
+                        name: '--registry <url>',
+                    },
+                    {
+                        description: 'When publishing packages that require two-factor authentication, this option can specify a one-time password.',
+                        name: '--otp',
+                    },
+                ],
+            },
+        ],
+        url: docsUrl('owner'),
+        usages: [
+            'pnpm owner ls <package>',
+            'pnpm owner add <package> <user>',
+            'pnpm owner rm <package> <user>',
+        ],
+    });
+}
+export async function handler(opts, params) {
+    switch (params[0]) {
+        case 'add':
+            return ownerAdd(opts, params.slice(1));
+        case 'rm':
+            return ownerRm(opts, params.slice(1));
+        case 'ls':
+        case 'list':
+            return ownerLs(opts, params.slice(1));
+        default:
+            return ownerLs(opts, params);
+    }
+}
+async function ownerLs(opts, params) {
+    if (params.length === 0) {
+        throw new PnpmError('OWNER_LS_PACKAGE_REQUIRED', 'Package name is required');
+    }
+    const { name: packageName, escapedName } = parsePackageSpec(params[0]);
+    const registryUrl = pickRegistryForPackage(opts.registries ?? { default: 'https://registry.npmjs.org/' }, packageName);
+    const authHeader = getAuthHeaderForRegistry(opts.configByUri, registryUrl);
+    const fetchFromRegistry = createFetchFromRegistry(opts);
+    const owners = await fetchOwners(packageName, escapedName, registryUrl, fetchFromRegistry, authHeader);
+    const lines = [];
+    for (const owner of owners) {
+        lines.push(`${owner.username} <${owner.email}>`);
+    }
+    return lines.join('\n');
+}
+async function ownerAdd(opts, params) {
+    if (params.length < 2) {
+        throw new PnpmError('OWNER_ADD_ARGS_REQUIRED', 'Package name and owner are required (e.g., pnpm owner add pkg username)');
+    }
+    const { name: packageName, escapedName } = parsePackageSpec(params[0]);
+    const owner = params[1];
+    const registryUrl = pickRegistryForPackage(opts.registries ?? { default: 'https://registry.npmjs.org/' }, packageName);
+    const authHeader = getAuthHeaderForRegistry(opts.configByUri, registryUrl);
+    const fetchFromRegistry = createFetchFromRegistry(opts);
+    const otp = opts.cliOptions?.otp;
+    const ownerUrl = getOwnerUrl(escapedName, registryUrl);
+    const response = await fetchFromRegistry(ownerUrl, {
+        authHeaderValue: authHeader,
+        method: 'PUT',
+        headers: {
+            'content-type': 'application/json',
+            ...(otp ? { 'npm-otp': otp } : {}),
+        },
+        body: JSON.stringify({ user: owner }),
+    });
+    if (!response.ok) {
+        await throwRegistryError(response, `add owner "${owner}" to`);
+    }
+    return `+${owner}: ${packageName}`;
+}
+async function ownerRm(opts, params) {
+    if (params.length < 2) {
+        throw new PnpmError('OWNER_RM_ARGS_REQUIRED', 'Package name and owner are required (e.g., pnpm owner rm pkg username)');
+    }
+    const { name: packageName, escapedName } = parsePackageSpec(params[0]);
+    const owner = params[1];
+    const registryUrl = pickRegistryForPackage(opts.registries ?? { default: 'https://registry.npmjs.org/' }, packageName);
+    const authHeader = getAuthHeaderForRegistry(opts.configByUri, registryUrl);
+    const fetchFromRegistry = createFetchFromRegistry(opts);
+    const otp = opts.cliOptions?.otp;
+    const ownerUrl = getOwnerUrl(escapedName, registryUrl, owner);
+    const response = await fetchFromRegistry(ownerUrl, {
+        authHeaderValue: authHeader,
+        method: 'DELETE',
+        headers: {
+            ...(otp ? { 'npm-otp': otp } : {}),
+        },
+    });
+    if (!response.ok) {
+        await throwRegistryError(response, `remove owner "${owner}" from`);
+    }
+    return `-${owner}: ${packageName}`;
+}
+function getAuthHeaderForRegistry(configByUri, registryUrl) {
+    const getAuthHeader = createGetAuthHeaderByURI(configByUri ?? {}, registryUrl);
+    return getAuthHeader(registryUrl);
+}
+function getOwnerUrl(escapedName, registryUrl, owner) {
+    const base = new URL(`-/package/${escapedName}/owners`, registryUrl).href;
+    if (owner) {
+        return `${base}/${encodeURIComponent(owner)}`;
+    }
+    return base;
+}
+async function fetchOwners(packageName, escapedName, registryUrl, fetchFromRegistry, authHeader) {
+    const ownersUrl = new URL(`-/package/${escapedName}/owners`, registryUrl).href;
+    const response = await fetchFromRegistry(ownersUrl, {
+        authHeaderValue: authHeader,
+    });
+    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 owners: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+}
+async function throwRegistryError(response, action) {
+    const errorBody = await response.text();
+    if (response.status === 401) {
+        throw new PnpmError('UNAUTHORIZED', `You must be logged in to ${action} packages. ${errorBody}`);
+    }
+    if (response.status === 403) {
+        throw new PnpmError('FORBIDDEN', `You do not have permission to ${action} this package. ${errorBody}`);
+    }
+    if (response.status === 404) {
+        throw new PnpmError('PACKAGE_NOT_FOUND', `Package not found in registry. ${errorBody}`);
+    }
+    throw new PnpmError('REGISTRY_ERROR', `Failed to ${action} package: ${response.status} ${response.statusText}. ${errorBody}`);
+}
+//# sourceMappingURL=owner.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/registry-access.commands",
-  "version": "1100.2.8",
+  "version": "1100.2.10",
   "description": "Commands for managing packages on the registry",
   "keywords": [
     "pnpm",
@@ -25,18 +25,18 @@
   ],
   "dependencies": {
     "@pnpm/npm-package-arg": "^2.0.0",
-    "chalk": "^5.6.2",
+    "chalk": "^5.6.0",
     "ramda": "npm:@pnpm/ramda@0.28.1",
     "render-help": "^2.0.0",
-    "semver": "^7.7.4",
-    "@pnpm/cli.utils": "1101.0.2",
-    "@pnpm/config.pick-registry-for-package": "1100.0.2",
+    "semver": "^7.7.2",
+    "@pnpm/cli.utils": "1101.0.3",
+    "@pnpm/config.reader": "1101.3.0",
+    "@pnpm/config.pick-registry-for-package": "1100.0.3",
     "@pnpm/error": "1100.0.0",
-    "@pnpm/config.reader": "1101.2.1",
-    "@pnpm/network.auth-header": "1100.0.1",
-    "@pnpm/network.fetch": "1100.0.2",
-    "@pnpm/resolving.registry.types": "1100.0.2",
-    "@pnpm/types": "1101.0.0"
+    "@pnpm/network.auth-header": "1100.0.2",
+    "@pnpm/network.fetch": "1100.0.3",
+    "@pnpm/resolving.registry.types": "1100.0.3",
+    "@pnpm/types": "1101.1.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.5",
-    "@pnpm/releasing.commands": "1100.2.9",
-    "@pnpm/registry-access.commands": "1100.2.8",
+    "@pnpm/registry-access.commands": "1100.2.10",
+    "@pnpm/prepare": "1100.0.7",
+    "@pnpm/releasing.commands": "1100.2.12",
     "@pnpm/testing.command-defaults": "1100.0.1",
-    "@pnpm/testing.mock-agent": "1100.0.2"
+    "@pnpm/testing.mock-agent": "1100.0.3"
   },
   "engines": {
     "node": ">=22.13"