@salesforce/packaging 5.0.9-spi.4 → 5.0.9-spi.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -193,16 +193,31 @@ export type PackageTrustLinkRecord = {
193
193
  EstablishedDate: string | null;
194
194
  RevokedDate: string | null;
195
195
  };
196
- export type PackageTrustLinkApproveOptions = {
196
+ export type PackageTrustLinkSelectorOptions = {
197
197
  requestId?: string;
198
198
  authoringOrgId?: string;
199
199
  };
200
+ export type PackageTrustLinkApproveOptions = PackageTrustLinkSelectorOptions;
201
+ export type PackageTrustLinkDenyOptions = PackageTrustLinkSelectorOptions;
202
+ export type PackageTrustLinkRevokeOptions = PackageTrustLinkSelectorOptions;
200
203
  export type PackageTrustLinkApproveResult = {
201
204
  LinkRequestId: string;
202
205
  AuthoringOrgId: string;
203
206
  VerifiedOrgId: string;
204
207
  Status: 'Accepted';
205
208
  };
209
+ export type PackageTrustLinkDenyResult = {
210
+ LinkRequestId: string;
211
+ AuthoringOrgId: string;
212
+ VerifiedOrgId: string;
213
+ Status: 'Declined';
214
+ };
215
+ export type PackageTrustLinkRevokeResult = {
216
+ LinkRequestId: string;
217
+ AuthoringOrgId: string;
218
+ VerifiedOrgId: string;
219
+ Status: 'Revoked';
220
+ };
206
221
  export type PackageTrustLinkUnlinkResult = {
207
222
  removed: boolean;
208
223
  LinkRequestId?: string;
@@ -1,5 +1,5 @@
1
1
  import { Connection } from '@salesforce/core';
2
- import { PackageTrustLinkApproveOptions, PackageTrustLinkApproveResult, PackageTrustLinkListStatusFilter, PackageTrustLinkRecord, PackageTrustLinkRequestOptions, PackageTrustLinkRequestResult, PackageTrustLinkStatusResult, PackageTrustLinkUnlinkResult } from '../interfaces';
2
+ import { PackageTrustLinkApproveOptions, PackageTrustLinkApproveResult, PackageTrustLinkDenyOptions, PackageTrustLinkDenyResult, PackageTrustLinkListStatusFilter, PackageTrustLinkRecord, PackageTrustLinkRequestOptions, PackageTrustLinkRequestResult, PackageTrustLinkRevokeOptions, PackageTrustLinkRevokeResult, PackageTrustLinkStatusResult, PackageTrustLinkUnlinkResult } from '../interfaces';
3
3
  export declare class PackageTrustLink {
4
4
  constructor();
5
5
  /**
@@ -42,6 +42,28 @@ export declare class PackageTrustLink {
42
42
  * @returns the accepted trust relationship details.
43
43
  */
44
44
  static approve(connection: Connection, options: PackageTrustLinkApproveOptions): Promise<PackageTrustLinkApproveResult>;
45
+ /**
46
+ * Deny a pending Public Secure (VerifiedDev) trust-link request for the connected Verified PBO.
47
+ *
48
+ * Core only allows Pending → Declined on the verified-org copy. This does not delete the
49
+ * relationship; the authoring org can unlink and request again.
50
+ *
51
+ * @param connection - Connection to the Verified Partner Business Org (PBO).
52
+ * @param options - Exactly one request ID or authoring org ID identifying the pending request.
53
+ * @returns the declined trust relationship details.
54
+ */
55
+ static deny(connection: Connection, options: PackageTrustLinkDenyOptions): Promise<PackageTrustLinkDenyResult>;
56
+ /**
57
+ * Revoke an accepted Public Secure (VerifiedDev) trust link for the connected Verified PBO.
58
+ *
59
+ * Core only allows Accepted → Revoked on the verified-org copy. Pending requests must be
60
+ * denied instead; already-declined or already-revoked links cannot be revoked again.
61
+ *
62
+ * @param connection - Connection to the Verified Partner Business Org (PBO).
63
+ * @param options - Exactly one request ID or authoring org ID identifying the accepted link.
64
+ * @returns the revoked trust relationship details.
65
+ */
66
+ static revoke(connection: Connection, options: PackageTrustLinkRevokeOptions): Promise<PackageTrustLinkRevokeResult>;
45
67
  /**
46
68
  * Clear the connected authoring org's Public Secure (VerifiedDev) trust link, returning it to the
47
69
  * `Not Linked` state.
@@ -16,7 +16,6 @@ const STATUS_FILTER_TO_API = {
16
16
  declined: 'Declined',
17
17
  revoked: 'Revoked',
18
18
  };
19
- const SALESFORCE_ID_PATTERN = /^[a-zA-Z0-9]{15}([a-zA-Z0-9]{3})?$/;
20
19
  const isStatusFilter = (status) => Object.prototype.hasOwnProperty.call(STATUS_FILTER_TO_API, status);
21
20
  const toApiStatus = (status) => {
22
21
  if (!isStatusFilter(status)) {
@@ -141,59 +140,33 @@ class PackageTrustLink {
141
140
  * @returns the accepted trust relationship details.
142
141
  */
143
142
  static async approve(connection, options) {
144
- if (Number(connection.getApiVersion()) < Number(MINIMUM_API_VERSION)) {
145
- throw messages.createError('apiVersionTooLow', [MINIMUM_API_VERSION]);
146
- }
147
- if (Boolean(options.requestId) === Boolean(options.authoringOrgId)) {
148
- throw messages.createError('exactlyOneApproveSelector');
149
- }
150
- const orgId = connection.getAuthInfoFields()?.orgId;
151
- if (!orgId) {
152
- throw messages.createError('missingOrgId');
153
- }
154
- const verifiedOrgId = (0, core_1.trimTo15)(orgId);
155
- let selector;
156
- let selectorValue;
157
- if (options.requestId) {
158
- if (!options.requestId.startsWith('2vt') ||
159
- !SALESFORCE_ID_PATTERN.test(options.requestId) ||
160
- !(0, core_1.validateSalesforceId)(options.requestId)) {
161
- throw messages.createError('invalidTrustLinkRequestId', [options.requestId]);
162
- }
163
- selector = `Id = '${options.requestId}'`;
164
- selectorValue = options.requestId;
165
- }
166
- else {
167
- const authoringOrgId = options.authoringOrgId;
168
- if (!authoringOrgId.startsWith('00D') ||
169
- !SALESFORCE_ID_PATTERN.test(authoringOrgId) ||
170
- !(0, core_1.validateSalesforceId)(authoringOrgId)) {
171
- throw messages.createError('invalidAuthoringOrgId', [authoringOrgId]);
172
- }
173
- selector = `AuthoringOrg = '${(0, core_1.trimTo15)(authoringOrgId)}'`;
174
- selectorValue = authoringOrgId;
175
- }
176
- const query = `SELECT Id, AuthoringOrg, VerifiedOrg, Status FROM ${TRUST_LINK_SOBJECT} ` +
177
- `WHERE VerifiedOrg = '${verifiedOrgId}' AND OrganizationType = '${ORGANIZATION_TYPE_VERIFIED}' ` +
178
- `AND AuthoringOrg != '${verifiedOrgId}' AND Status = 'Pending' AND ${selector} ORDER BY CreatedDate DESC LIMIT 1`;
179
- const queryResult = await connection.autoFetchQuery(query, { tooling: true });
180
- const pendingRequest = queryResult.records?.[0];
181
- if (!pendingRequest) {
182
- throw messages.createError('pendingTrustLinkNotFound', [selectorValue]);
183
- }
184
- const updateResult = await connection.tooling.update(TRUST_LINK_SOBJECT, {
185
- Id: pendingRequest.Id,
186
- Status: 'Accepted',
187
- });
188
- if (!updateResult.success) {
189
- throw (0, packageUtils_1.combineSaveErrors)(TRUST_LINK_SOBJECT, 'update', updateResult.errors);
190
- }
191
- return {
192
- LinkRequestId: pendingRequest.Id,
193
- AuthoringOrgId: pendingRequest.AuthoringOrg,
194
- VerifiedOrgId: pendingRequest.VerifiedOrg,
195
- Status: 'Accepted',
196
- };
143
+ return updateInboundTrustLink(connection, options, 'Pending', 'Accepted', 'pendingTrustLinkNotFound');
144
+ }
145
+ /**
146
+ * Deny a pending Public Secure (VerifiedDev) trust-link request for the connected Verified PBO.
147
+ *
148
+ * Core only allows Pending → Declined on the verified-org copy. This does not delete the
149
+ * relationship; the authoring org can unlink and request again.
150
+ *
151
+ * @param connection - Connection to the Verified Partner Business Org (PBO).
152
+ * @param options - Exactly one request ID or authoring org ID identifying the pending request.
153
+ * @returns the declined trust relationship details.
154
+ */
155
+ static async deny(connection, options) {
156
+ return updateInboundTrustLink(connection, options, 'Pending', 'Declined', 'pendingTrustLinkNotFound');
157
+ }
158
+ /**
159
+ * Revoke an accepted Public Secure (VerifiedDev) trust link for the connected Verified PBO.
160
+ *
161
+ * Core only allows Accepted → Revoked on the verified-org copy. Pending requests must be
162
+ * denied instead; already-declined or already-revoked links cannot be revoked again.
163
+ *
164
+ * @param connection - Connection to the Verified Partner Business Org (PBO).
165
+ * @param options - Exactly one request ID or authoring org ID identifying the accepted link.
166
+ * @returns the revoked trust relationship details.
167
+ */
168
+ static async revoke(connection, options) {
169
+ return updateInboundTrustLink(connection, options, 'Accepted', 'Revoked', 'acceptedTrustLinkNotFound');
197
170
  }
198
171
  /**
199
172
  * Clear the connected authoring org's Public Secure (VerifiedDev) trust link, returning it to the
@@ -227,6 +200,57 @@ class PackageTrustLink {
227
200
  }
228
201
  }
229
202
  exports.PackageTrustLink = PackageTrustLink;
203
+ async function updateInboundTrustLink(connection, options, requiredStatus, nextStatus, notFoundMessage) {
204
+ if (Number(connection.getApiVersion()) < Number(MINIMUM_API_VERSION)) {
205
+ throw messages.createError('apiVersionTooLow', [MINIMUM_API_VERSION]);
206
+ }
207
+ if (Boolean(options.requestId) === Boolean(options.authoringOrgId)) {
208
+ throw messages.createError('exactlyOneApproveSelector');
209
+ }
210
+ const orgId = connection.getAuthInfoFields()?.orgId;
211
+ if (!orgId) {
212
+ throw messages.createError('missingOrgId');
213
+ }
214
+ const verifiedOrgId = (0, core_1.trimTo15)(orgId);
215
+ let selector;
216
+ let selectorValue;
217
+ if (options.requestId) {
218
+ if (!options.requestId.startsWith('2vt') || !(0, core_1.validateSalesforceId)(options.requestId)) {
219
+ throw messages.createError('invalidTrustLinkRequestId', [options.requestId]);
220
+ }
221
+ selector = `Id = '${options.requestId}'`;
222
+ selectorValue = options.requestId;
223
+ }
224
+ else {
225
+ const authoringOrgId = options.authoringOrgId;
226
+ if (!authoringOrgId.startsWith('00D') || !(0, core_1.validateSalesforceId)(authoringOrgId)) {
227
+ throw messages.createError('invalidAuthoringOrgId', [authoringOrgId]);
228
+ }
229
+ selector = `AuthoringOrg = '${(0, core_1.trimTo15)(authoringOrgId)}'`;
230
+ selectorValue = authoringOrgId;
231
+ }
232
+ const query = `SELECT Id, AuthoringOrg, VerifiedOrg, Status FROM ${TRUST_LINK_SOBJECT} ` +
233
+ `WHERE VerifiedOrg = '${verifiedOrgId}' AND OrganizationType = '${ORGANIZATION_TYPE_VERIFIED}' ` +
234
+ `AND AuthoringOrg != '${verifiedOrgId}' AND Status = '${requiredStatus}' AND ${selector} ORDER BY CreatedDate DESC LIMIT 1`;
235
+ const queryResult = await connection.autoFetchQuery(query, { tooling: true });
236
+ const matchingRequest = queryResult.records?.[0];
237
+ if (!matchingRequest) {
238
+ throw messages.createError(notFoundMessage, [selectorValue]);
239
+ }
240
+ const updateResult = await connection.tooling.update(TRUST_LINK_SOBJECT, {
241
+ Id: matchingRequest.Id,
242
+ Status: nextStatus,
243
+ });
244
+ if (!updateResult.success) {
245
+ throw (0, packageUtils_1.combineSaveErrors)(TRUST_LINK_SOBJECT, 'update', updateResult.errors);
246
+ }
247
+ return {
248
+ LinkRequestId: matchingRequest.Id,
249
+ AuthoringOrgId: matchingRequest.AuthoringOrg,
250
+ VerifiedOrgId: matchingRequest.VerifiedOrg,
251
+ Status: nextStatus,
252
+ };
253
+ }
230
254
  async function queryExistingTrustLink(connection) {
231
255
  const query = `SELECT Id, VerifiedOrg, Status, EstablishedDate, RevokedDate, CreatedDate FROM ${TRUST_LINK_SOBJECT} LIMIT 1`;
232
256
  const result = await connection.autoFetchQuery(query, { tooling: true });
@@ -34,6 +34,10 @@ The Authoring Org ID %s isn't valid. Specify a valid organization ID (starts wit
34
34
 
35
35
  No pending trust link request matching %s was found for this Verified Org. Run "sf package trust link list --status pending" to review pending requests.
36
36
 
37
+ # acceptedTrustLinkNotFound
38
+
39
+ No accepted trust link matching %s was found for this Verified Org. Run "sf package trust link list --status approved" to review approved links.
40
+
37
41
  # trustLinkNotFound
38
42
 
39
43
  This org has no trust link to remove; it's already in the Not Linked state.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/packaging",
3
- "version": "5.0.9-spi.4",
3
+ "version": "5.0.9-spi.5",
4
4
  "description": "Packaging library for the Salesforce packaging platform",
5
5
  "main": "lib/exported",
6
6
  "types": "lib/exported.d.ts",