@servicenow/sdk-build-plugins 4.4.1 → 4.6.0

package/src/rest-api-plugin.ts

@@ -8,11 +8,13 @@ import {
     type ObjectShape,
     type RecordId,
     type NowConfig,
+    DeletedShape,
 } from '@servicenow/sdk-build-core'
 import { ModuleFunctionShape } from './server-module-plugin'
 import { NowIdShape } from './now-id-plugin'
 import { NowIncludeShape } from './now-include-plugin'
-import { generateDeprecatedDiagnostics } from './utils'
+import { createSdkDocEntry, generateDeprecatedDiagnostics } from './utils'
+import { RecordPlugin } from './record-plugin'
 
 const DEFAULT_MEDIA_TYPE = 'application/json,application/xml,text/xml'
 const DEFAULT_REST_ENFORCED_ACL = 'cf9d01d3e73003009d6247e603f6a990'
@@ -181,6 +183,7 @@ async function generateRouteAttributeRecords(
             installCategory: restDef.getInstallCategory(),
         })
 
+        const isShared = attrMap.has(attrRecord.getId().getValue())
         checkForDuplicateRecords(attrMap, attrRecord, attr.asObject(), diagnostics)
 
         const attributeMappingRecord = await factory.createRecord({
@@ -193,7 +196,12 @@ async function generateRouteAttributeRecords(
             installCategory: restDef.getInstallCategory(),
         })
 
-        records.push(attrRecord.with(attributeMappingRecord))
+        if (isShared) {
+            // The attrRecord was already emitted by a previous route — only emit the mapping
+            records.push(attributeMappingRecord)
+        } else {
+            records.push(attrRecord.with(attributeMappingRecord))
+        }
     }
 
     return records
@@ -318,6 +326,16 @@ async function generateRouteAndRouteAttrRecords(
     return routeRecords
 }
 
+function findReclaimedRecords(records: Record[], orphanedRecords: Record[]) {
+    return records
+        .filter(
+            (record) =>
+                record.getCreator()?.getName() === RecordPlugin.getName() &&
+                !orphanedRecords.find((orphan) => orphan.getId().getValue() === record.getId().getValue())
+        )
+        .map((record) => new DeletedShape({ source: record.getSource() }))
+}
+
 function findOrphanedAttributes(
     attributes: Record[],
     attributeRouteAssociations: Record[],
@@ -418,6 +436,7 @@ function versionsTransform(versions: Record[]) {
 
 export const RestApiPlugin = Plugin.create({
     name: 'RestApiPlugin',
+    docs: [createSdkDocEntry('RestApi', ['sys_ws_definition'])],
     records: {
         sys_ws_header_map: {
             coalesce: ['web_service_operation', 'web_service_header'],
@@ -546,17 +565,24 @@ export const RestApiPlugin = Plugin.create({
                     ],
                 })
 
+                const reclaimedRecords = [
+                    ...findReclaimedRecords(headers, orphanedHeaders),
+                    ...findReclaimedRecords(parameters, orphanedParameters),
+                ]
+
                 if (unhandledRecords.length > 0) {
                     return {
                         success: 'partial',
                         value: shape,
                         unhandledRecords,
+                        reclaimedRecords,
                     }
                 }
 
                 return {
                     success: true,
                     value: shape,
+                    reclaimedRecords,
                 }
             },
         },

package/src/role-plugin.ts

@@ -1,6 +1,6 @@
 import { isSNScope, type Record } from '@servicenow/sdk-build-core'
 import { CallExpressionShape, Plugin } from '@servicenow/sdk-build-core'
-import { generateDeprecatedDiagnostics } from './utils'
+import { createSdkDocEntry, generateDeprecatedDiagnostics } from './utils'
 
 const roleAliases = {
     canDelegate: ['can_delegate'],
@@ -12,6 +12,7 @@ const roleAliases = {
 
 export const RolePlugin = Plugin.create({
     name: 'RolePlugin',
+    docs: [createSdkDocEntry('Role', ['sys_user_role'])],
     records: {
         sys_user_role: {
             relationships: {

package/src/schedule-script/index.ts

@@ -0,0 +1 @@
+export * from './scheduled-script-plugin'