@servicenow/sdk-build-core 4.1.0 → 4.2.0

package/src/plugins/time.ts

@@ -1,17 +1,26 @@
-import type { TimeDuration } from '@servicenow/sdk/core'
+import type { Duration, TimeOfDay } from '@servicenow/sdk/core'
 
-function prefixZeroIfNeeded(n: number) {
-    return n < 10 ? `0${n}` : `${n}`
-}
+const padZero = (n: number) => String(n).padStart(2, '0')
 
 export function formatDateToPlatformFormat(date: Date | undefined): string {
     if (date === undefined) {
         return '1970-01-01 00:00:00'
     }
-    return `${date.getUTCFullYear()}-${prefixZeroIfNeeded(date.getUTCMonth() + 1)}-${prefixZeroIfNeeded(date.getUTCDate())} ${prefixZeroIfNeeded(date.getUTCHours())}:${prefixZeroIfNeeded(date.getUTCMinutes())}:${prefixZeroIfNeeded(date.getUTCSeconds())}`
+    return `${date.getUTCFullYear()}-${padZero(date.getUTCMonth() + 1)}-${padZero(date.getUTCDate())} ${padZero(date.getUTCHours())}:${padZero(date.getUTCMinutes())}:${padZero(date.getUTCSeconds())}`
+}
+
+/**
+ * Format a Date object to ServiceNow platform datetime format using local time (not UTC).
+ * This is used for glide_time fields which are timezone-aware.
+ */
+export function formatDateToPlatformFormatLocal(date: Date | undefined): string {
+    if (date === undefined) {
+        return '1970-01-01 00:00:00'
+    }
+    return `${date.getFullYear()}-${padZero(date.getMonth() + 1)}-${padZero(date.getDate())} ${padZero(date.getHours())}:${padZero(date.getMinutes())}:${padZero(date.getSeconds())}`
 }
 
-export function parseGlideDuration(dateTimeStr: string | undefined): TimeDuration | undefined {
+export function parseGlideDuration(dateTimeStr: string | undefined): Duration | undefined {
     if (!dateTimeStr) {
         return undefined
     }
@@ -34,7 +43,7 @@ export function parseGlideDuration(dateTimeStr: string | undefined): TimeDuratio
 
     let diffMs = inputDate.getTime() - epochDate.getTime()
 
-    const duration: TimeDuration = {}
+    const duration: Duration = {}
 
     // Calculate days
     const days = Math.floor(diffMs / (1000 * 60 * 60 * 24))
@@ -66,7 +75,85 @@ export function parseGlideDuration(dateTimeStr: string | undefined): TimeDuratio
     return duration
 }
 
-export function parseDateTime(dateTimeStr: string | undefined) {
+/**
+ * Parse a datetime string to a TimeOfDay object.
+ * Respects user's timezone by reversing the timeFieldToXML conversion.
+ * The datetime string is in UTC format, but represents a local time that was converted.
+ * @param dateTimeStr - ServiceNow datetime format string (e.g., '1970-01-01 14:30:00')
+ * @param timeZone - Optional IANA timezone string (e.g., 'America/New_York'). Defaults to system timezone.
+ * @returns TimeOfDay object with hours, minutes, and seconds, or undefined if parsing fails
+ */
+export function parseGlideTime(dateTimeStr: string | undefined, timeZone?: string): TimeOfDay | undefined {
+    if (!dateTimeStr) {
+        return undefined
+    }
+
+    const components = parseDateTime(dateTimeStr)
+    if (!components) {
+        return undefined
+    }
+
+    // Create a UTC Date from the parsed components
+    const utcDate = new Date(
+        Date.UTC(
+            components.year,
+            components.month - 1,
+            components.day,
+            components.hours,
+            components.minutes,
+            components.seconds
+        )
+    )
+
+    let localHours: number
+    let localMinutes: number
+    let localSeconds: number
+
+    if (timeZone) {
+        // Use Intl.DateTimeFormat to convert UTC to specified timezone
+        const { hour, minute, second } = new Intl.DateTimeFormat('en-US', {
+            timeZone,
+            hour: 'numeric',
+            minute: 'numeric',
+            second: 'numeric',
+            hourCycle: 'h23', // Use 0-23 hour format (midnight = 0, not 24)
+        })
+            .formatToParts(utcDate)
+            .reduce(
+                (acc, p) => {
+                    if (p.type === 'hour' || p.type === 'minute' || p.type === 'second') {
+                        acc[p.type] = Number(p.value)
+                    }
+                    return acc
+                },
+                { hour: 0, minute: 0, second: 0 }
+            )
+
+        localHours = hour
+        localMinutes = minute
+        localSeconds = second
+    } else {
+        // Use system timezone (JavaScript's default behavior)
+        localHours = utcDate.getHours()
+        localMinutes = utcDate.getMinutes()
+        localSeconds = utcDate.getSeconds()
+    }
+
+    const timeOfDay: TimeOfDay = {}
+    if (localHours > 0) {
+        timeOfDay.hours = localHours
+    }
+    if (localMinutes > 0) {
+        timeOfDay.minutes = localMinutes
+    }
+    if (localSeconds > 0) {
+        timeOfDay.seconds = localSeconds
+    }
+
+    return timeOfDay
+}
+
+export function parseDateTime(dateTimeStr: string) {
     if (!dateTimeStr) {
         return undefined
     }
@@ -88,14 +175,70 @@ export function parseDateTime(dateTimeStr: string | undefined) {
     return undefined
 }
 
-export function durationFieldToXML(duration: TimeDuration): Date {
+/**
+ * Convert a Duration object to a Date for glide_duration fields.
+ * Duration fields are timezone-agnostic (they represent a span of time),
+ * so we create the Date in UTC.
+ */
+export function durationFieldToXML(duration: Duration): Date {
     const durationInMs = toMilliseconds(
         duration['days'] !== undefined ? duration['days'] : 0,
         duration['hours'] !== undefined ? duration['hours'] : 0,
         duration['minutes'] !== undefined ? duration['minutes'] : 0,
         duration['seconds'] !== undefined ? duration['seconds'] : 0
     )
-    return new Date(durationInMs)
+    // Create Date in UTC to avoid timezone conversion issues
+    // Date.UTC() returns milliseconds since epoch in UTC
+    return new Date(Date.UTC(1970, 0, 1) + durationInMs)
+}
+
+/**
+ * Convert a time object to a Date for glide_time fields.
+ * Time fields represent a time-of-day and are timezone-aware.
+ * We create the Date in local time (or specified timezone), then format it as UTC.
+ * This means the UTC time will include the timezone offset,
+ * and ServiceNow will display it correctly in the user's timezone.
+ *
+ * @param time - TimeOfDay object with hours, minutes, seconds
+ * @param timeZone - Optional IANA timezone string (e.g., 'America/New_York'). Defaults to system timezone.
+ */
+export function timeFieldToXML(time: TimeOfDay, timeZone?: string): Date {
+    const hours = time.hours ?? 0
+    const minutes = time.minutes ?? 0
+    const seconds = time.seconds ?? 0
+
+    if (timeZone) {
+        // Convert from specified timezone to UTC
+        // Calculate offset by comparing UTC time with timezone time
+        const refUtc = Date.UTC(1970, 0, 1, 12, 0, 0)
+        const refDate = new Date(refUtc)
+        const tzString = refDate.toLocaleString('en-US', {
+            timeZone,
+            hour: '2-digit',
+            minute: '2-digit',
+            hour12: false,
+        })
+        const parts = tzString.split(':').map(Number)
+        const tzHour = parts[0] ?? 12
+        const tzMin = parts[1] ?? 0
+        const offsetMinutes = (tzHour - 12) * 60 + tzMin // Offset from UTC in minutes
+
+        // Apply the offset: local time in timezone -> UTC
+        // If timezone is UTC+5:30, then 14:00 local = 08:30 UTC (subtract offset)
+        const totalMinutes = hours * 60 + minutes - offsetMinutes
+        return new Date(Date.UTC(1970, 0, 1, Math.floor(totalMinutes / 60), totalMinutes % 60, seconds))
+    }
+
+    // Default: use system timezone
+    // Create a Date in local time - this will have the timezone offset built in
+    return new Date(
+        1970,
+        0, // January
+        1,
+        hours,
+        minutes,
+        seconds
+    )
 }
 
 function toMilliseconds(days: number, hours: number, minutes: number, seconds: number): number {

package/src/taxonomy.ts

@@ -0,0 +1,343 @@
+import * as z from 'zod'
+import kebabCase from 'lodash/kebabCase'
+
+const TableNames = {
+    // Automation tables
+    SYS_ALIAS: 'sys_alias',
+    SYS_HUB_ACTION_TYPE_DEFINITION: 'sys_hub_action_type_definition',
+    SYS_HUB_TRIGGER_DEFINITION: 'sys_hub_trigger_definition',
+    SYS_HUB_FLOW: 'sys_hub_flow',
+    SYS_PD_ACTIVITY_DEFINITION: 'sys_pd_activity_definition',
+    SYS_DECISION: 'sys_decision',
+    SYSEVENT_EMAIL_TEMPLATE: 'sysevent_email_template',
+    SYSEVENT_EMAIL_ACTION: 'sysevent_email_action',
+    SYS_PD_PROCESS_DEFINITION: 'sys_pd_process_definition',
+    SYS_HUB_TRIGGER_TEMPLATE: 'sys_hub_trigger_template',
+
+    // Client Development tables
+    DL_U_ASSIGNMENT: 'dl_u_assignment',
+    SYS_SCRIPT_CLIENT: 'sys_script_client',
+    SYS_UI_SCRIPT: 'sys_ui_script',
+    DL_DEFINITION: 'dl_definition',
+    DL_U_PRIORITY: 'dl_u_priority',
+    SYS_CLIENT_EXTENSION_INSTANCE: 'sys_client_extension_instance',
+    SYS_CLIENT_EXTENSION_POINT: 'sys_client_extension_point',
+    SYS_UI_EXTENSION_INSTANCE: 'sys_ui_extension_instance',
+    SYS_UI_EXTENSION_POINT: 'sys_ui_extension_point',
+
+    // Content tables
+    CONTENT_BLOCK_PROGRAMMATIC: 'content_block_programmatic',
+    CONTENT_BLOCK_STATIC: 'content_block_static',
+    CONTENT_BLOCK_DETAIL: 'content_block_detail',
+    CONTENT_BLOCK_IFRAME: 'content_block_iframe',
+
+    // Data tables
+    DB_AUDIO: 'db_audio',
+    DB_IMAGE: 'db_image',
+    SYS_DB_OBJECT: 'sys_db_object',
+    SYS_DICTIONARY: 'sys_dictionary',
+    SYS_UI_FORM: 'sys_ui_form',
+    SYS_M2M: 'sys_m2m',
+    SYS_RELATIONSHIP: 'sys_relationship',
+
+    // Integrations Inbound tables
+    SYS_REST_MESSAGE: 'sys_rest_message',
+    SYS_WEB_SERVICE: 'sys_web_service',
+    SYS_DATA_SOURCE: 'sys_data_source',
+    SN_IHUB_INTEGRATION_INSTANCE: 'sn_ihub_integration_instance',
+    SCHEDULED_IMPORT_SET: 'scheduled_import_set',
+    SCHEDULED_DATA_IMPORT: 'scheduled_data_import',
+    SYS_WS_DEFINITION: 'sys_ws_definition',
+
+    // Integrations Outbound tables
+    SYS_EXPORT_DEFINITION: 'sys_export_definition',
+    SYS_EXPORT_TARGET: 'sys_export_target',
+    SYS_EXPORT_SET: 'sys_export_set',
+    SCHEDULED_DATA_EXPORT: 'scheduled_data_export',
+    SYS_SOAP_MESSAGE: 'sys_soap_message',
+
+    // Mid Server tables
+    ECC_AGENT_APPLICATION: 'ecc_agent_application',
+    ECC_AGENT_SCRIPT_INCLUDE: 'ecc_agent_script_include',
+    ECC_AGENT_IP_RANGE: 'ecc_agent_ip_range',
+    ECC_AGENT_PROPERTY: 'ecc_agent_property',
+    ECC_AGENT_SCRIPT_FILE: 'ecc_agent_script_file',
+    ECC_AGENT_CAPABILITY_VALUE_TEST: 'ecc_agent_capability_value_test',
+
+    // Mobile tables
+    SYS_SG_BROWSER_SCREEN: 'sys_sg_browser_screen',
+    SYS_SG_CHART: 'sys_sg_chart',
+    SYS_SG_FORM_SCREEN: 'sys_sg_form_screen',
+    SYS_SG_LIST_SCREEN: 'sys_sg_list_screen',
+    SYS_SG_NATIVE_CLIENT: 'sys_sg_native_client',
+    SYS_SG_CUSTOM_MAP_SCREEN: 'sys_sg_custom_map_screen',
+    SYS_SG_MAP_SCREEN: 'sys_sg_map_screen',
+    SYS_SG_CHART_SCREEN: 'sys_sg_chart_screen',
+    SYS_SG_CALENDAR_SCREEN: 'sys_sg_calendar_screen',
+    SYS_SG_BUTTON: 'sys_sg_button',
+    SYS_SG_PARAMETER_SCREEN: 'sys_sg_parameter_screen',
+    SYS_SG_APPLET_LAUNCHER: 'sys_sg_applet_launcher',
+
+    // Natural Language Understanding tables
+    SYS_NLU_MODEL: 'sys_nlu_model',
+
+    // Properties tables
+    SYS_PROPERTIES: 'sys_properties',
+    SYS_PROPERTIES_CATEGORY: 'sys_properties_category',
+    SYS_UI_MESSAGE: 'sys_ui_message',
+
+    // Reporting tables
+    METRIC_DEFINITION: 'metric_definition',
+    SYS_REPORT: 'sys_report',
+    SYS_REPORT_RANGE: 'sys_report_range',
+    SYS_REPORT_CHART_COLOR: 'sys_report_chart_color',
+    SYS_REPORT_COLOR: 'sys_report_color',
+    SYSAUTO_REPORT: 'sysauto_report',
+    PA_DASHBOARDS: 'pa_dashboards',
+
+    // Schedules tables
+    CMN_SCHEDULE: 'cmn_schedule',
+    CMN_SCHEDULE_PAGE: 'cmn_schedule_page',
+    SYSAUTO_PA: 'sysauto_pa',
+    SYSAUTO_SCRIPT: 'sysauto_script',
+    CMN_SCHEDULE_BLACKOUT: 'cmn_schedule_blackout',
+    CMN_SCHEDULE_MAINTENANCE: 'cmn_schedule_maintenance',
+    CMN_RELATIVE_DURATION: 'cmn_relative_duration',
+    RISK_CONDITIONS: 'risk_conditions',
+
+    // Security-related tables
+    SYS_PUBLIC: 'sys_public',
+    SYS_SECURITY_ACL: 'sys_security_acl',
+    SYS_USER_ROLE: 'sys_user_role',
+    SYS_USER_ROLE_CONTAINS: 'sys_user_role_contains',
+
+    // Server Development tables
+    SYS_SCRIPT: 'sys_script',
+    SYS_SCRIPT_FIX: 'sys_script_fix',
+    SYS_SCRIPT_INCLUDE: 'sys_script_include',
+    SYS_TRANSFORM_MAP: 'sys_transform_map',
+    SYS_UI_ACTION: 'sys_ui_action',
+    SYSEVENT_REGISTER: 'sysevent_register',
+    SYS_DATA_POLICY2: 'sys_data_policy2',
+    SYS_EXTENSION_INSTANCE: 'sys_extension_instance',
+    SYS_EXTENSION_POINT: 'sys_extension_point',
+    SYSEVENT_SCRIPT_ACTION: 'sysevent_script_action',
+
+    // Service Portal tables
+    SP_PORTAL: 'sp_portal',
+
+    // User Interface tables
+    ASMT_METRIC: 'asmt_metric',
+    SYS_APP_APPLICATION: 'sys_app_application',
+    SYS_APP_MODULE: 'sys_app_module',
+    SYS_UI_POLICY: 'sys_ui_policy',
+    SYS_UI_SECTION: 'sys_ui_section',
+    SYS_EMBEDDED_HELP_QUALIFIER: 'sys_embedded_help_qualifier',
+    SC_CATALOG: 'sc_catalog',
+    SC_CAT_ITEM: 'sc_cat_item',
+    SC_CAT_ITEM_PRODUCER: 'sc_cat_item_producer',
+    SYS_UI_CONTEXT_MENU: 'sys_ui_context_menu',
+    SYS_UI_LIST: 'sys_ui_list',
+    SYS_UI_LIST_CONTROL: 'sys_ui_list_control',
+    SYS_UI_RELATED_LIST: 'sys_ui_related_list',
+    SYS_UI_STYLE: 'sys_ui_style',
+    SYS_UI_THEME: 'sys_ui_theme',
+    SYS_UI_VIEW: 'sys_ui_view',
+    SYS_EMBEDDED_HELP_CONTENT: 'sys_embedded_help_content',
+    SYS_EMBEDDED_TOUR_GUIDE: 'sys_embedded_tour_guide',
+    CMN_MAP_PAGE: 'cmn_map_page',
+    CMN_TIMELINE_PAGE: 'cmn_timeline_page',
+    SYS_UX_EXTENSION_POINT: 'sys_ux_extension_point',
+    SYS_UX_APP_CONFIG: 'sys_ux_app_config',
+    SYS_UX_PAGE_REGISTRY: 'sys_ux_page_registry',
+    SYS_TEMPLATE: 'sys_template',
+    SYSRULE_VIEW: 'sysrule_view',
+}
+
+// String format: one or more path segments separated by '/' (e.g., 'server-development/business-rule' or 'integration/outbound/rest-api')
+const taxonomyItem = z.string().regex(/^[a-z0-9_-]+(\/[a-z0-9_-]+)*$/)
+
+const taxonomyMapping = z
+    .object({
+        // Automation tables
+        [TableNames.SYS_HUB_ACTION_TYPE_DEFINITION]: taxonomyItem.default('automation/action'),
+        [TableNames.SYS_HUB_TRIGGER_DEFINITION]: taxonomyItem.default('automation/trigger'),
+        [TableNames.SYS_PD_ACTIVITY_DEFINITION]: taxonomyItem.default('automation/activity-definition'),
+        [TableNames.SYS_ALIAS]: taxonomyItem.default('automation/workflow-activity'),
+        [TableNames.SYS_HUB_FLOW]: taxonomyItem.default('automation/flow'),
+        [TableNames.SYS_DECISION]: taxonomyItem.default('automation/decision-table'),
+        [TableNames.SYSEVENT_EMAIL_TEMPLATE]: taxonomyItem.default('automation/email-template'),
+        [TableNames.SYSEVENT_EMAIL_ACTION]: taxonomyItem.default('automation/notification'),
+        [TableNames.SYS_PD_PROCESS_DEFINITION]: taxonomyItem.default('automation/playbook'),
+        [TableNames.SYS_HUB_TRIGGER_TEMPLATE]: taxonomyItem.default('automation/trigger'),
+
+        // Client Development tables
+        [TableNames.DL_U_ASSIGNMENT]: taxonomyItem.default('client-development/assignment-data-lookup'),
+        [TableNames.SYS_SCRIPT_CLIENT]: taxonomyItem.default('client-development/client-script'),
+        [TableNames.SYS_UI_SCRIPT]: taxonomyItem.default('client-development/ui-script'),
+        [TableNames.DL_DEFINITION]: taxonomyItem.default('client-development/data-lookup-definitions'),
+        [TableNames.DL_U_PRIORITY]: taxonomyItem.default('client-development/priority-data-lookup'),
+        [TableNames.SYS_CLIENT_EXTENSION_INSTANCE]: taxonomyItem.default(
+            'client-development/client-extension-instance'
+        ),
+        [TableNames.SYS_CLIENT_EXTENSION_POINT]: taxonomyItem.default('client-development/client-extension-point'),
+        [TableNames.SYS_UI_EXTENSION_INSTANCE]: taxonomyItem.default('client-development/ui-extension-instance'),
+        [TableNames.SYS_UI_EXTENSION_POINT]: taxonomyItem.default('client-development/ui-extension-point'),
+
+        // Content tables
+        [TableNames.CONTENT_BLOCK_PROGRAMMATIC]: taxonomyItem.default('content/dynamic-content'),
+        [TableNames.CONTENT_BLOCK_STATIC]: taxonomyItem.default('content/static-content'),
+        [TableNames.CONTENT_BLOCK_DETAIL]: taxonomyItem.default('content/detailed-content'),
+        [TableNames.CONTENT_BLOCK_IFRAME]: taxonomyItem.default('content/i-frames'),
+
+        // Data tables
+        [TableNames.DB_AUDIO]: taxonomyItem.default('content/audio'),
+        [TableNames.DB_IMAGE]: taxonomyItem.default('content/images'),
+        [TableNames.SYS_DB_OBJECT]: taxonomyItem.default('data/table'),
+        [TableNames.SYS_DICTIONARY]: taxonomyItem.default('data/table-column'),
+        [TableNames.SYS_UI_FORM]: taxonomyItem.default('data/form'),
+        [TableNames.SYS_M2M]: taxonomyItem.default('data/many-to-many-definition'),
+        [TableNames.SYS_RELATIONSHIP]: taxonomyItem.default('data/relationship'),
+
+        // Integrations Inbound tables
+        [TableNames.SYS_WEB_SERVICE]: taxonomyItem.default('integrations-inbound/scripted-web-service'),
+        [TableNames.SYS_DATA_SOURCE]: taxonomyItem.default('integrations-inbound/data-source'),
+        [TableNames.SYS_TRANSFORM_MAP]: taxonomyItem.default('integrations-inbound/table-transform-map'),
+        [TableNames.SN_IHUB_INTEGRATION_INSTANCE]: taxonomyItem.default('integrations-inbound/data-import'),
+        [TableNames.SCHEDULED_IMPORT_SET]: taxonomyItem.default('integrations-inbound/scheduled-data-import'),
+        [TableNames.SCHEDULED_DATA_IMPORT]: taxonomyItem.default('integrations-inbound/scheduled-data-import'),
+        [TableNames.SYS_WS_DEFINITION]: taxonomyItem.default('integrations-inbound/scripted-rest-api'),
+
+        // Integrations Outbound tables
+        [TableNames.SYS_EXPORT_DEFINITION]: taxonomyItem.default('integrations-outbound/export-definition'),
+        [TableNames.SYS_EXPORT_TARGET]: taxonomyItem.default('integrations-outbound/export-target'),
+        [TableNames.SYS_EXPORT_SET]: taxonomyItem.default('integrations-outbound/export-set'),
+        [TableNames.SYS_REST_MESSAGE]: taxonomyItem.default('integrations-outbound/rest-message'),
+        [TableNames.SCHEDULED_DATA_EXPORT]: taxonomyItem.default('integrations-outbound/scheduled-data-export'),
+        [TableNames.SYS_SOAP_MESSAGE]: taxonomyItem.default('integrations-outbound/soap-message'),
+
+        // Mid Server tables
+        [TableNames.ECC_AGENT_APPLICATION]: taxonomyItem.default('mid-server/mid-server-application'),
+        [TableNames.ECC_AGENT_SCRIPT_INCLUDE]: taxonomyItem.default('mid-server/mid-server-script-include'),
+        [TableNames.ECC_AGENT_IP_RANGE]: taxonomyItem.default('mid-server/mid-server-ip-range'),
+        [TableNames.ECC_AGENT_PROPERTY]: taxonomyItem.default('mid-server/mid-server-property'),
+        [TableNames.ECC_AGENT_SCRIPT_FILE]: taxonomyItem.default('mid-server/mid-server-script-file'),
+        [TableNames.ECC_AGENT_CAPABILITY_VALUE_TEST]: taxonomyItem.default(
+            'mid-server/mid-server-capability-value-test'
+        ),
+
+        // Mobile tables
+        [TableNames.SYS_SG_CHART]: taxonomyItem.default('mobile/analytics-preview'),
+        [TableNames.SYS_SG_BROWSER_SCREEN]: taxonomyItem.default('mobile/mobile-web-screen'),
+        [TableNames.SYS_SG_FORM_SCREEN]: taxonomyItem.default('mobile/record-screen'),
+        [TableNames.SYS_SG_LIST_SCREEN]: taxonomyItem.default('mobile/list-screen'),
+        [TableNames.SYS_SG_NATIVE_CLIENT]: taxonomyItem.default('mobile/mobile-app-config'),
+        [TableNames.SYS_SG_CUSTOM_MAP_SCREEN]: taxonomyItem.default('mobile/custom-map-screen'),
+        [TableNames.SYS_SG_MAP_SCREEN]: taxonomyItem.default('mobile/map-screen'),
+        [TableNames.SYS_SG_CHART_SCREEN]: taxonomyItem.default('mobile/chart-screen'),
+        [TableNames.SYS_SG_CALENDAR_SCREEN]: taxonomyItem.default('mobile/calendar-screen'),
+        [TableNames.SYS_SG_BUTTON]: taxonomyItem.default('mobile/function'),
+        [TableNames.SYS_SG_PARAMETER_SCREEN]: taxonomyItem.default('mobile/input-form-screen'),
+        [TableNames.SYS_SG_APPLET_LAUNCHER]: taxonomyItem.default('mobile/launcher-screen'),
+
+        // Natural Language Understanding tables
+        [TableNames.SYS_NLU_MODEL]: taxonomyItem.default('natural-language-understanding/nlu-model'),
+
+        // Properties tables
+        [TableNames.SYS_PROPERTIES]: taxonomyItem.default('properties/system-property'),
+        [TableNames.SYS_PROPERTIES_CATEGORY]: taxonomyItem.default('properties/system-property-category'),
+        [TableNames.SYS_UI_MESSAGE]: taxonomyItem.default('properties/message'),
+
+        // Reporting tables
+        [TableNames.METRIC_DEFINITION]: taxonomyItem.default('reporting/metric-definition'),
+        [TableNames.SYS_REPORT]: taxonomyItem.default('reporting/report'),
+        [TableNames.SYS_REPORT_RANGE]: taxonomyItem.default('reporting/range'),
+        [TableNames.SYS_REPORT_CHART_COLOR]: taxonomyItem.default('reporting/chart-colors'),
+        [TableNames.SYS_REPORT_COLOR]: taxonomyItem.default('reporting/color-definition'),
+        [TableNames.SYSAUTO_REPORT]: taxonomyItem.default('reporting/scheduled-email-of-report'),
+        [TableNames.PA_DASHBOARDS]: taxonomyItem.default('reporting/dashboard'),
+
+        // Schedules tables
+        [TableNames.CMN_SCHEDULE]: taxonomyItem.default('schedules/schedule'),
+        [TableNames.CMN_SCHEDULE_PAGE]: taxonomyItem.default('schedules/schedule-page'),
+        [TableNames.SYSAUTO_PA]: taxonomyItem.default('schedules/performance-analytics-job'),
+        [TableNames.SYSAUTO_SCRIPT]: taxonomyItem.default('schedules/scheduled-script-execution'),
+        [TableNames.CMN_SCHEDULE_BLACKOUT]: taxonomyItem.default('schedules/blackout-schedule'),
+        [TableNames.CMN_SCHEDULE_MAINTENANCE]: taxonomyItem.default('schedules/maintenance-schedule'),
+        [TableNames.CMN_RELATIVE_DURATION]: taxonomyItem.default('schedules/relative-duration'),
+        [TableNames.RISK_CONDITIONS]: taxonomyItem.default('schedules/risk-conditions'),
+
+        // Security-related tables
+        [TableNames.SYS_SECURITY_ACL]: taxonomyItem.default('security/access-control'),
+        [TableNames.SYS_PUBLIC]: taxonomyItem.default('security/public-pages'),
+        [TableNames.SYS_USER_ROLE]: taxonomyItem.default('security/role'),
+        [TableNames.SYS_USER_ROLE_CONTAINS]: taxonomyItem.default('security/role'),
+
+        // Server Development tables
+        [TableNames.SYS_SCRIPT]: taxonomyItem.default('server-development/business-rule'),
+        [TableNames.SYS_SCRIPT_FIX]: taxonomyItem.default('server-development/fix-script'),
+        [TableNames.SYS_SCRIPT_INCLUDE]: taxonomyItem.default('server-development/script-include'),
+        [TableNames.SYS_UI_ACTION]: taxonomyItem.default('server-development/ui-action'),
+        [TableNames.SYSEVENT_REGISTER]: taxonomyItem.default('server-development/event-registration'),
+        [TableNames.SYS_DATA_POLICY2]: taxonomyItem.default('server-development/data-policy'),
+        [TableNames.SYS_EXTENSION_INSTANCE]: taxonomyItem.default('server-development/extension-instance'),
+        [TableNames.SYS_EXTENSION_POINT]: taxonomyItem.default('server-development/extension-point'),
+        [TableNames.SYSEVENT_SCRIPT_ACTION]: taxonomyItem.default('server-development/script-action'),
+
+        // Service Portal tables
+        [TableNames.SP_PORTAL]: taxonomyItem.default('service-portal/service-portal'),
+
+        // User Interface tables
+        [TableNames.SYS_APP_APPLICATION]: taxonomyItem.default('user-interface/application-menu'),
+        [TableNames.ASMT_METRIC]: taxonomyItem.default('user-interface/assessment-metric'),
+        [TableNames.SYS_APP_MODULE]: taxonomyItem.default('user-interface/module'),
+        [TableNames.SYS_UI_POLICY]: taxonomyItem.default('client-development/ui-policy'),
+        [TableNames.SYS_UI_SECTION]: taxonomyItem.default('data/form-section'),
+        [TableNames.SYS_EMBEDDED_HELP_QUALIFIER]: taxonomyItem.default('user-interface/embedded-help-qualifier'),
+        [TableNames.SC_CATALOG]: taxonomyItem.default('user-interface/catalog'),
+        [TableNames.SC_CAT_ITEM]: taxonomyItem.default('user-interface/catalog-item'),
+        [TableNames.SC_CAT_ITEM_PRODUCER]: taxonomyItem.default('user-interface/record-producer'),
+        [TableNames.SYS_UI_CONTEXT_MENU]: taxonomyItem.default('user-interface/context-menu'),
+        [TableNames.SYS_UI_LIST]: taxonomyItem.default('user-interface/list'),
+        [TableNames.SYS_UI_VIEW]: taxonomyItem.default('user-interface/view'),
+        [TableNames.SYS_UI_LIST_CONTROL]: taxonomyItem.default('user-interface/list-control'),
+        [TableNames.SYS_UI_RELATED_LIST]: taxonomyItem.default('user-interface/related-list'),
+        [TableNames.SYS_UI_STYLE]: taxonomyItem.default('user-interface/style'),
+        [TableNames.SYS_UI_THEME]: taxonomyItem.default('user-interface/theme'),
+        [TableNames.SYS_EMBEDDED_HELP_CONTENT]: taxonomyItem.default('user-interface/embedded-help'),
+        [TableNames.SYS_EMBEDDED_TOUR_GUIDE]: taxonomyItem.default('user-interface/guided-tour'),
+        [TableNames.CMN_MAP_PAGE]: taxonomyItem.default('user-interface/map-page'),
+        [TableNames.CMN_TIMELINE_PAGE]: taxonomyItem.default('user-interface/timeline-page'),
+        [TableNames.SYS_UX_EXTENSION_POINT]: taxonomyItem.default('user-interface/page-collection'),
+        [TableNames.SYS_UX_APP_CONFIG]: taxonomyItem.default('user-interface/ux-app-configuration'),
+        [TableNames.SYS_UX_PAGE_REGISTRY]: taxonomyItem.default('user-interface/workspace'),
+        [TableNames.SYS_TEMPLATE]: taxonomyItem.default('user-interface/template'),
+        [TableNames.SYSRULE_VIEW]: taxonomyItem.default('user-interface/view-rule'),
+    })
+    .catchall(taxonomyItem)
+    .default({})
+
+export const taxonomySchemaDefault = taxonomyMapping.parse({})
+
+export const taxonomy = z
+    .object({
+        mapping: taxonomyMapping.default({}),
+        fallbackFolderName: z.string().default('other'),
+    })
+    .transform((data) => {
+        const mappingWithDefaults = new Proxy(data.mapping || {}, {
+            get(target, prop) {
+                if (typeof prop === 'string' && !(prop in target)) {
+                    // Return fallback path for unmapped tables
+                    return `${data.fallbackFolderName}/${kebabCase(prop)}`
+                }
+                return Reflect.get(target, prop)
+            },
+        }) as Record<string, string>
+
+        return {
+            mapping: mappingWithDefaults,
+            fallbackFolderName: data.fallbackFolderName,
+        }
+    })
+    .default({})

package/src/typescript.ts

@@ -122,6 +122,10 @@ export const SupportedKinds = {
         name: 'TypeLiteral',
         node: {} as ts.TypeLiteralNode,
     },
+    [ts.SyntaxKind.LiteralType]: {
+        name: 'LiteralType',
+        node: {} as ts.LiteralTypeNode,
+    },
     [ts.SyntaxKind.PropertySignature]: {
         name: 'PropertySignature',
         node: {} as ts.PropertySignature,

package/src/xml.ts

@@ -1,7 +1,7 @@
-import { type Action, Record, RecordId, ResolvableShape, Shape } from './plugins'
+import { Record, RecordId, ResolvableShape, Shape } from './plugins'
 import { js2xml, type Element } from 'xml-js'
 
-export function unloadBuilder({ scope, scopeId }: { scope: string; scopeId: string }) {
+export function unloadBuilder({ scope, scopeId, table }: { scope: string; scopeId: string; table?: string }) {
     const recordUpdateElements = []
     const xmlJsObj = {
         declaration: {
@@ -13,6 +13,9 @@ export function unloadBuilder({ scope, scopeId }: { scope: string; scopeId: stri
             {
                 type: 'element',
                 name: 'record_update',
+                attributes: {
+                    table,
+                },
                 elements: recordUpdateElements,
             },
         ],
@@ -24,18 +27,24 @@ export function unloadBuilder({ scope, scopeId }: { scope: string; scopeId: stri
         recordUpdateElements,
         end,
         record: (record: Record, updateName: string) => {
-            const rec = recordXml(recordUpdateElements, record.getTable(), record.getId().getValue(), {
-                attr: { action: record.getAction() },
+            const table = record.getTable()
+
+            // TODO: Let the plugins define this kind of thing?
+            const extraAttributes =
+                table === 'sys_dictionary'
+                    ? {
+                          element: record.get('element').ifString()?.getValue() ?? '',
+                          table: record.get('name').ifString()?.getValue() ?? '',
+                      }
+                    : {}
+
+            const rec = recordXml(recordUpdateElements, table, record.getId().getValue(), {
+                attr: { action: record.getAction(), ...extraAttributes },
             })
             rec.field('sys_scope', scopeId, { display_value: scope })
             rec.field('sys_update_name', updateName)
             return rec
         },
-        createXML: (tableName: string, id: string | number, action: Action = 'INSERT_OR_UPDATE') => {
-            const rec = recordXml(recordUpdateElements, tableName, id, { attr: { action } })
-            rec.addSysScope(scope, scopeId)
-            return rec
-        },
     }
 }