@sonisoft/now-sdk-ext-core 3.0.1 → 3.3.0

package/dist/sn/catalog/CatalogManager.js

@@ -0,0 +1,352 @@
+import { Logger } from "../../util/Logger.js";
+import { ServiceNowRequest } from "../../comm/http/ServiceNowRequest.js";
+import { TableAPIRequest } from "../../comm/http/TableAPIRequest.js";
+import { AggregateQuery } from "../aggregate/AggregateQuery.js";
+/**
+ * Mapping of numeric variable type codes to friendly names.
+ * Sourced from a ServiceNow instance with sysparm_display_value: 'all'.
+ */
+export const VARIABLE_TYPE_MAP = {
+    '1': 'Yes/No',
+    '2': 'Multi Line Text',
+    '3': 'Multiple Choice',
+    '4': 'Numeric Scale',
+    '5': 'Select Box',
+    '6': 'Single Line Text',
+    '7': 'CheckBox',
+    '8': 'Reference',
+    '9': 'Date',
+    '10': 'Date/Time',
+    '11': 'Label',
+    '14': 'Custom',
+    '16': 'Wide Single Line Text',
+    '17': 'Custom with Label',
+    '18': 'Lookup Select Box',
+    '19': 'Container Start',
+    '20': 'Container End',
+    '21': 'List Collector',
+    '23': 'HTML',
+    '24': 'Container Split',
+    '26': 'Email',
+    '28': 'IP Address',
+    '29': 'Duration',
+    '31': 'Requested For',
+    '32': 'Rich Text Label',
+    '33': 'Attachment',
+    '40': 'Table Name'
+};
+/**
+ * Get a human-readable variable type name from a numeric type code.
+ *
+ * @param typeCode The numeric type code (as a string)
+ * @returns The friendly type name, or "Unknown ({typeCode})" if not mapped
+ */
+export function getVariableTypeName(typeCode) {
+    if (!typeCode)
+        return 'Unknown';
+    return VARIABLE_TYPE_MAP[typeCode] || `Unknown (${typeCode})`;
+}
+/**
+ * Provides operations for managing ServiceNow Service Catalog items,
+ * categories, variables, and request submissions via the Table API,
+ * Stats API, and Service Catalog REST API.
+ */
+export class CatalogManager {
+    static CATALOG_ITEM_TABLE = 'sc_cat_item';
+    static CATEGORY_TABLE = 'sc_category';
+    static VARIABLE_TABLE = 'item_option_new';
+    static VARIABLE_SET_ITEM_TABLE = 'io_set_item';
+    static REQUEST_ITEM_TABLE = 'sc_req_item';
+    static ORDER_NOW_API = '/api/sn_sc/servicecatalog/items/{sys_id}/order_now';
+    /** Fields to return for catalog item list operations */
+    static ITEM_LIST_FIELDS = 'sys_id,name,short_description,description,category,price,active,order,sys_scope,sc_catalogs,type';
+    /** Fields to return for category list operations */
+    static CATEGORY_LIST_FIELDS = 'sys_id,title,description,parent,sc_catalog,active,order,icon,header_icon';
+    /** Fields to return for variable list operations */
+    static VARIABLE_LIST_FIELDS = 'sys_id,name,question_text,type,mandatory,default_value,help_text,order,reference,reference_qual,choice_table,choice_field,cat_item,variable_set';
+    _logger = new Logger("CatalogManager");
+    _req;
+    _tableAPI;
+    _aggregateQuery;
+    _instance;
+    _headers = {
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+    };
+    constructor(instance) {
+        this._instance = instance;
+        this._req = new ServiceNowRequest(instance);
+        this._tableAPI = new TableAPIRequest(instance);
+        this._aggregateQuery = new AggregateQuery(instance);
+    }
+    /**
+     * List catalog items with optional filtering and pagination.
+     *
+     * @param options Filtering and pagination options
+     * @returns Array of catalog item records
+     * @throws Error if the API call fails
+     */
+    async listCatalogItems(options = {}) {
+        const { query, textSearch, categorySysId, catalogSysId, active, limit = 20, offset = 0 } = options;
+        this._logger.info('Listing catalog items');
+        const queryParts = [];
+        if (active !== undefined)
+            queryParts.push(`active=${active}`);
+        if (categorySysId)
+            queryParts.push(`category=${categorySysId}`);
+        if (catalogSysId)
+            queryParts.push(`sc_catalogs=${catalogSysId}`);
+        if (textSearch)
+            queryParts.push(`nameLIKE${textSearch}^ORshort_descriptionLIKE${textSearch}`);
+        if (query)
+            queryParts.push(query);
+        const params = {
+            sysparm_limit: limit,
+            sysparm_offset: offset,
+            sysparm_fields: CatalogManager.ITEM_LIST_FIELDS
+        };
+        if (queryParts.length > 0) {
+            params.sysparm_query = queryParts.join('^');
+        }
+        const response = await this._tableAPI.get(CatalogManager.CATALOG_ITEM_TABLE, params);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Retrieved ${response.bodyObject.result.length} catalog items`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to list catalog items. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Get details of a specific catalog item, optionally including its variables.
+     *
+     * @param sysId The sys_id of the catalog item
+     * @param includeVariables Whether to include variables (default true)
+     * @returns Catalog item detail with item record and variables
+     * @throws Error if the sys_id is empty, the item is not found, or the API call fails
+     */
+    async getCatalogItem(sysId, includeVariables = true) {
+        if (!sysId || sysId.trim().length === 0) {
+            throw new Error('Catalog item sys_id is required');
+        }
+        this._logger.info(`Getting catalog item: ${sysId}`);
+        const response = await this._tableAPI.get(CatalogManager.CATALOG_ITEM_TABLE, { sysparm_query: `sys_id=${sysId}`, sysparm_limit: 1 });
+        if (!response || response.status !== 200 || !response.bodyObject?.result ||
+            response.bodyObject.result.length === 0) {
+            throw new Error(`Catalog item '${sysId}' not found. Status: ${response?.status ?? 'unknown'}`);
+        }
+        const item = response.bodyObject.result[0];
+        let variables = [];
+        if (includeVariables) {
+            variables = await this._fetchAllVariables(sysId);
+        }
+        this._logger.info(`Catalog item '${item.name}': ${variables.length} variables`);
+        return { item, variables };
+    }
+    /**
+     * List catalog categories with optional filtering and pagination.
+     *
+     * @param options Filtering and pagination options
+     * @returns Array of catalog category records
+     * @throws Error if the API call fails
+     */
+    async listCatalogCategories(options = {}) {
+        const { parentSysId, catalogSysId, active, title, query, limit = 20, offset = 0 } = options;
+        this._logger.info('Listing catalog categories');
+        const queryParts = [];
+        if (parentSysId)
+            queryParts.push(`parent=${parentSysId}`);
+        if (catalogSysId)
+            queryParts.push(`sc_catalog=${catalogSysId}`);
+        if (active !== undefined)
+            queryParts.push(`active=${active}`);
+        if (title)
+            queryParts.push(`title=${title}`);
+        if (query)
+            queryParts.push(query);
+        const params = {
+            sysparm_limit: limit,
+            sysparm_offset: offset,
+            sysparm_fields: CatalogManager.CATEGORY_LIST_FIELDS
+        };
+        if (queryParts.length > 0) {
+            params.sysparm_query = queryParts.join('^');
+        }
+        const response = await this._tableAPI.get(CatalogManager.CATEGORY_TABLE, params);
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            this._logger.info(`Retrieved ${response.bodyObject.result.length} catalog categories`);
+            return response.bodyObject.result;
+        }
+        throw new Error(`Failed to list catalog categories. Status: ${response?.status ?? 'unknown'}`);
+    }
+    /**
+     * Get details of a specific catalog category including its item count.
+     *
+     * @param sysId The sys_id of the catalog category
+     * @returns Category detail with category record and item count
+     * @throws Error if the sys_id is empty, the category is not found, or the API call fails
+     */
+    async getCatalogCategory(sysId) {
+        if (!sysId || sysId.trim().length === 0) {
+            throw new Error('Catalog category sys_id is required');
+        }
+        this._logger.info(`Getting catalog category: ${sysId}`);
+        const response = await this._tableAPI.get(CatalogManager.CATEGORY_TABLE, {
+            sysparm_query: `sys_id=${sysId}`,
+            sysparm_limit: 1,
+            sysparm_fields: CatalogManager.CATEGORY_LIST_FIELDS
+        });
+        if (!response || response.status !== 200 || !response.bodyObject?.result ||
+            response.bodyObject.result.length === 0) {
+            throw new Error(`Catalog category '${sysId}' not found. Status: ${response?.status ?? 'unknown'}`);
+        }
+        const category = response.bodyObject.result[0];
+        const itemCount = await this._aggregateQuery.count({
+            table: CatalogManager.CATALOG_ITEM_TABLE,
+            query: `category=${sysId}`
+        });
+        this._logger.info(`Category '${category.title}': ${itemCount} items`);
+        return { category, itemCount };
+    }
+    /**
+     * List variables for a catalog item, including variables from variable sets.
+     *
+     * @param options Options including the catalog item sys_id
+     * @returns Array of catalog variable records sorted by order
+     * @throws Error if the catalog item sys_id is empty or the API call fails
+     */
+    async listCatalogItemVariables(options) {
+        if (!options.catalogItemSysId || options.catalogItemSysId.trim().length === 0) {
+            throw new Error('Catalog item sys_id is required');
+        }
+        this._logger.info(`Listing variables for catalog item: ${options.catalogItemSysId}`);
+        const includeVariableSets = options.includeVariableSets !== false;
+        const variables = includeVariableSets
+            ? await this._fetchAllVariables(options.catalogItemSysId)
+            : await this._fetchDirectVariables(options.catalogItemSysId);
+        this._logger.info(`Retrieved ${variables.length} variables for item ${options.catalogItemSysId}`);
+        return variables;
+    }
+    /**
+     * Submit a catalog request using the Service Catalog order_now API.
+     * After ordering, fetches the RITM record for the complete result.
+     *
+     * @param options Request submission options
+     * @returns Request result with REQ and RITM numbers/sys_ids
+     * @throws Error if the catalog item sys_id is empty or the API call fails
+     */
+    async submitCatalogRequest(options) {
+        if (!options.catalogItemSysId || options.catalogItemSysId.trim().length === 0) {
+            throw new Error('Catalog item sys_id is required');
+        }
+        this._logger.info(`Submitting catalog request for item: ${options.catalogItemSysId}`);
+        const orderBody = {
+            sysparm_quantity: options.quantity || 1,
+            variables: options.variables || {}
+        };
+        const orderUrl = CatalogManager.ORDER_NOW_API.replace('{sys_id}', options.catalogItemSysId);
+        const request = {
+            path: orderUrl,
+            method: 'post',
+            headers: this._headers,
+            query: null,
+            body: null,
+            json: orderBody
+        };
+        const orderResponse = await this._req.executeRequest(request);
+        if (!orderResponse || orderResponse.status !== 200 || !orderResponse.bodyObject?.result) {
+            throw new Error(`Failed to submit catalog request. Status: ${orderResponse?.status ?? 'unknown'}`);
+        }
+        const orderResult = orderResponse.bodyObject.result;
+        const result = {
+            requestNumber: orderResult.request_number || orderResult.number,
+            requestSysId: orderResult.request_id || orderResult.sys_id
+        };
+        // Fetch the RITM record
+        try {
+            const ritmResponse = await this._tableAPI.get(CatalogManager.REQUEST_ITEM_TABLE, {
+                sysparm_query: `request=${result.requestSysId}`,
+                sysparm_fields: 'sys_id,number',
+                sysparm_limit: 1
+            });
+            if (ritmResponse && ritmResponse.status === 200 &&
+                ritmResponse.bodyObject?.result && ritmResponse.bodyObject.result.length > 0) {
+                const ritm = ritmResponse.bodyObject.result[0];
+                result.requestItemNumber = ritm.number;
+                result.requestItemSysId = ritm.sys_id;
+                this._logger.info(`Catalog request submitted: ${result.requestNumber} / ${result.requestItemNumber}`);
+            }
+            else {
+                this._logger.info(`Catalog request submitted: ${result.requestNumber} (RITM not yet available)`);
+            }
+        }
+        catch (err) {
+            // RITM fetch is best-effort; log but don't fail the overall request
+            this._logger.info(`Catalog request submitted: ${result.requestNumber} (RITM fetch failed)`);
+        }
+        return result;
+    }
+    /**
+     * Fetch all variables for a catalog item: direct variables + variable set variables.
+     * Merges, deduplicates by sys_id, enriches with friendly_type, and sorts by order.
+     * @private
+     */
+    async _fetchAllVariables(catalogItemSysId) {
+        // Fetch direct variables and variable set IDs in parallel
+        const [directVars, setItemResponse] = await Promise.all([
+            this._fetchDirectVariables(catalogItemSysId),
+            this._tableAPI.get(CatalogManager.VARIABLE_SET_ITEM_TABLE, {
+                sysparm_query: `sc_cat_item=${catalogItemSysId}`,
+                sysparm_fields: 'sys_id,sc_cat_item,variable_set'
+            })
+        ]);
+        let setVars = [];
+        if (setItemResponse && setItemResponse.status === 200 &&
+            setItemResponse.bodyObject?.result && setItemResponse.bodyObject.result.length > 0) {
+            const setIds = setItemResponse.bodyObject.result.map(r => r.variable_set).filter(Boolean);
+            if (setIds.length > 0) {
+                const setQuery = `variable_setIN${setIds.join(',')}`;
+                const setVarsResponse = await this._tableAPI.get(CatalogManager.VARIABLE_TABLE, {
+                    sysparm_query: setQuery,
+                    sysparm_fields: CatalogManager.VARIABLE_LIST_FIELDS
+                });
+                if (setVarsResponse && setVarsResponse.status === 200 && setVarsResponse.bodyObject?.result) {
+                    setVars = setVarsResponse.bodyObject.result;
+                }
+            }
+        }
+        // Merge, deduplicate by sys_id, enrich, and sort
+        const allVars = [...directVars, ...setVars];
+        const seen = new Set();
+        const deduped = [];
+        for (const v of allVars) {
+            if (!seen.has(v.sys_id)) {
+                seen.add(v.sys_id);
+                v.friendly_type = getVariableTypeName(v.type);
+                deduped.push(v);
+            }
+        }
+        deduped.sort((a, b) => {
+            const orderA = parseInt(a.order || '0', 10);
+            const orderB = parseInt(b.order || '0', 10);
+            return orderA - orderB;
+        });
+        return deduped;
+    }
+    /**
+     * Fetch variables directly assigned to a catalog item (cat_item field).
+     * @private
+     */
+    async _fetchDirectVariables(catalogItemSysId) {
+        const response = await this._tableAPI.get(CatalogManager.VARIABLE_TABLE, {
+            sysparm_query: `cat_item=${catalogItemSysId}^ORDERBYorder`,
+            sysparm_fields: CatalogManager.VARIABLE_LIST_FIELDS
+        });
+        if (response && response.status === 200 && response.bodyObject?.result) {
+            return response.bodyObject.result.map(v => ({
+                ...v,
+                friendly_type: getVariableTypeName(v.type)
+            }));
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=CatalogManager.js.map

package/dist/sn/catalog/CatalogManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatalogManager.js","sourceRoot":"","sources":["../../../src/sn/catalog/CatalogManager.ts"],"names":[],"mappings":"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"}

package/dist/sn/catalog/CatalogModels.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Models for Service Catalog management operations against ServiceNow tables:
+ * sc_cat_item, sc_category, and item_option_new.
+ */
+/**
+ * A catalog item record from the sc_cat_item table.
+ */
+export interface CatalogItemRecord {
+    sys_id: string;
+    name: string;
+    short_description?: string;
+    description?: string;
+    category?: string;
+    price?: string;
+    active?: string;
+    order?: string;
+    sys_scope?: string;
+    sc_catalogs?: string;
+    type?: string;
+    [key: string]: unknown;
+}
+/**
+ * A catalog category record from the sc_category table.
+ */
+export interface CatalogCategoryRecord {
+    sys_id: string;
+    title: string;
+    description?: string;
+    parent?: string;
+    sc_catalog?: string;
+    active?: string;
+    order?: string;
+    icon?: string;
+    header_icon?: string;
+    [key: string]: unknown;
+}
+/**
+ * A catalog variable record from the item_option_new table.
+ * Includes an enriched friendly_type field mapped from the numeric type code.
+ */
+export interface CatalogVariableRecord {
+    sys_id: string;
+    name: string;
+    question_text?: string;
+    type?: string;
+    mandatory?: string;
+    default_value?: string;
+    help_text?: string;
+    order?: string;
+    reference?: string;
+    reference_qual?: string;
+    choice_table?: string;
+    choice_field?: string;
+    cat_item?: string;
+    variable_set?: string;
+    /** Human-readable variable type name mapped from the numeric type code */
+    friendly_type?: string;
+    [key: string]: unknown;
+}
+/**
+ * A record from the io_set_item table linking variable sets to catalog items.
+ */
+export interface VariableSetItemRecord {
+    sys_id: string;
+    sc_cat_item: string;
+    variable_set: string;
+    [key: string]: unknown;
+}
+/**
+ * Options for listing catalog items.
+ */
+export interface ListCatalogItemsOptions {
+    /** Encoded query string for filtering */
+    query?: string;
+    /** Text search term (searches name and short_description) */
+    textSearch?: string;
+    /** Filter by category sys_id */
+    categorySysId?: string;
+    /** Filter by catalog sys_id */
+    catalogSysId?: string;
+    /** Filter by active status */
+    active?: boolean;
+    /** Maximum number of records to return (default 20) */
+    limit?: number;
+    /** Offset for pagination (default 0) */
+    offset?: number;
+}
+/**
+ * Options for listing catalog categories.
+ */
+export interface ListCatalogCategoriesOptions {
+    /** Filter by parent category sys_id */
+    parentSysId?: string;
+    /** Filter by catalog sys_id */
+    catalogSysId?: string;
+    /** Filter by active status */
+    active?: boolean;
+    /** Filter by title (exact match) */
+    title?: string;
+    /** Encoded query string for additional filtering */
+    query?: string;
+    /** Maximum number of records (default 20) */
+    limit?: number;
+    /** Offset for pagination (default 0) */
+    offset?: number;
+}
+/**
+ * Options for listing catalog item variables.
+ */
+export interface ListCatalogVariablesOptions {
+    /** The catalog item sys_id (required) */
+    catalogItemSysId: string;
+    /** Include variables from variable sets (default true) */
+    includeVariableSets?: boolean;
+}
+/**
+ * Options for submitting a catalog request via order_now.
+ */
+export interface SubmitCatalogRequestOptions {
+    /** The catalog item sys_id (required) */
+    catalogItemSysId: string;
+    /** Quantity to order (default 1) */
+    quantity?: number;
+    /** Variable name-value pairs */
+    variables?: Record<string, string>;
+}
+/**
+ * Enriched catalog item detail including its variables.
+ */
+export interface CatalogItemDetail {
+    item: CatalogItemRecord;
+    variables: CatalogVariableRecord[];
+}
+/**
+ * Enriched catalog category detail including item count.
+ */
+export interface CatalogCategoryDetail {
+    category: CatalogCategoryRecord;
+    itemCount: number;
+}
+/**
+ * Result from submitting a catalog request, including both REQ and RITM.
+ */
+export interface CatalogRequestResult {
+    requestNumber: string;
+    requestSysId: string;
+    requestItemNumber?: string;
+    requestItemSysId?: string;
+}
+export interface CatalogItemResponse {
+    result: CatalogItemRecord[];
+}
+export interface CatalogCategoryResponse {
+    result: CatalogCategoryRecord[];
+}
+export interface CatalogVariableResponse {
+    result: CatalogVariableRecord[];
+}
+export interface VariableSetItemResponse {
+    result: VariableSetItemRecord[];
+}
+export interface CatalogOrderResponse {
+    result: {
+        sys_id: string;
+        number: string;
+        request_number: string;
+        request_id: string;
+        table: string;
+    };
+}
+export interface RequestItemResponse {
+    result: Array<{
+        sys_id: string;
+        number: string;
+        [key: string]: unknown;
+    }>;
+}

package/dist/sn/catalog/CatalogModels.js

@@ -0,0 +1,6 @@
+/**
+ * Models for Service Catalog management operations against ServiceNow tables:
+ * sc_cat_item, sc_category, and item_option_new.
+ */
+export {};
+//# sourceMappingURL=CatalogModels.js.map

package/dist/sn/catalog/CatalogModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatalogModels.js","sourceRoot":"","sources":["../../../src/sn/catalog/CatalogModels.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/sn/knowledge/KnowledgeManager.d.ts

@@ -0,0 +1,93 @@
+import { ServiceNowInstance } from "../ServiceNowInstance.js";
+import { KnowledgeBaseRecord, KnowledgeBaseDetail, KnowledgeCategoryRecord, KnowledgeArticleRecord, KnowledgeArticleSummary, ListKnowledgeBasesOptions, ListCategoriesOptions, CreateCategoryOptions, ListArticlesOptions, CreateArticleOptions, UpdateArticleOptions } from './KnowledgeModels.js';
+/**
+ * Provides operations for managing ServiceNow Knowledge Base articles,
+ * knowledge bases, and categories via the Table API and Stats API.
+ */
+export declare class KnowledgeManager {
+    private static readonly KB_BASE_TABLE;
+    private static readonly KB_CATEGORY_TABLE;
+    private static readonly KB_KNOWLEDGE_TABLE;
+    /** Fields to return in list operations (excludes large body fields) */
+    private static readonly ARTICLE_LIST_FIELDS;
+    private _logger;
+    private _req;
+    private _tableAPI;
+    private _aggregateQuery;
+    private _instance;
+    constructor(instance: ServiceNowInstance);
+    /**
+     * List knowledge bases with optional filtering and pagination.
+     *
+     * @param options Filtering and pagination options
+     * @returns Array of knowledge base records
+     * @throws Error if the API call fails
+     */
+    listKnowledgeBases(options?: ListKnowledgeBasesOptions): Promise<KnowledgeBaseRecord[]>;
+    /**
+     * Get details of a specific knowledge base including article and category counts.
+     *
+     * @param sysId The sys_id of the knowledge base
+     * @returns Knowledge base detail with article and category counts
+     * @throws Error if the sys_id is empty, the KB is not found, or the API call fails
+     */
+    getKnowledgeBase(sysId: string): Promise<KnowledgeBaseDetail>;
+    /**
+     * List categories within a knowledge base with optional filtering.
+     *
+     * @param options Filtering and pagination options
+     * @returns Array of category records
+     * @throws Error if the API call fails
+     */
+    listCategories(options?: ListCategoriesOptions): Promise<KnowledgeCategoryRecord[]>;
+    /**
+     * Create a new knowledge base category.
+     *
+     * @param options Category creation options
+     * @returns The created category record
+     * @throws Error if required fields are missing or the API call fails
+     */
+    createCategory(options: CreateCategoryOptions): Promise<KnowledgeCategoryRecord>;
+    /**
+     * List knowledge articles with filtering by KB, category, workflow state, and text search.
+     * Returns article summaries (without large body fields) for efficiency.
+     *
+     * @param options Filtering and pagination options
+     * @returns Array of article summaries
+     * @throws Error if the API call fails
+     */
+    listArticles(options?: ListArticlesOptions): Promise<KnowledgeArticleSummary[]>;
+    /**
+     * Get full article content including body text.
+     *
+     * @param sysId The sys_id of the article
+     * @returns The full article record
+     * @throws Error if the sys_id is empty, the article is not found, or the API call fails
+     */
+    getArticle(sysId: string): Promise<KnowledgeArticleRecord>;
+    /**
+     * Create a new knowledge article.
+     *
+     * @param options Article creation options
+     * @returns The created article record
+     * @throws Error if required fields are missing or the API call fails
+     */
+    createArticle(options: CreateArticleOptions): Promise<KnowledgeArticleRecord>;
+    /**
+     * Update an existing knowledge article.
+     *
+     * @param sysId The sys_id of the article to update
+     * @param options Fields to update
+     * @returns The updated article record
+     * @throws Error if the sys_id is empty, no fields are provided, or the API call fails
+     */
+    updateArticle(sysId: string, options: UpdateArticleOptions): Promise<KnowledgeArticleRecord>;
+    /**
+     * Publish a draft article by setting its workflow_state to "published".
+     *
+     * @param sysId The sys_id of the article to publish
+     * @returns The updated article record
+     * @throws Error if the sys_id is empty or the API call fails
+     */
+    publishArticle(sysId: string): Promise<KnowledgeArticleRecord>;
+}