SDK 3.0.2

[bryce-godfrey]

📢 We are pleased to announce the release of 3.0.2 of the @servicenow/sdk is available for download on npm!

Docs: https://www.servicenow.com/docs/bundle/yokohama-application-development/page/build/servicenow-sdk/concept/servicenow-sdk-landing.html

This is a patch release that fixes a few bugs in the SDK and adds an option for CI server installs

Add option to specify basic auth credentials through env variables for install command
To inject basic authentication credentials for the install command from a CI server type environment, you can specify the following env variables and the sdk will detect them and default to using them.

SN_SDK_INSTANCE_URL = "https://your-instance-url.com"
SN_SDK_USER = "username" # servicenow user name
SN_SDK_USER_PWD = "passwordvalue" # servicenow user password
SN_SDK_NODE_ENV = "SN_SDK_CI_INSTALL" # needs to be set to enable the feature

Fixes

• packOutputDir in now.config.json not being respected
• List API should also accept columns other than defined table schema elements
• Choice columns with dropdown: 'dropdown_without_none' are showing as a dropdown WITH none when installed
• Transform generates invalid sys_security_acl_role when the ACL is in metadata directory
• Reinstalling a new fluent app right after installation fails
• ignoreTransformTableList doesn't respect the table configured inside them
• Role Plugin throws error when changedData is empty
• sys_documentation gets duplication upon transformation
• Wrap the Now.include html content with CDATA tag upon generating the XML

---

This discussion was created from the release SDK 3.0.2.

[americk0]

This is awesome and helps us get rid of a lot of hacky code. Keep up the great work!

[shaumik100x]

I'm unable to init an existing app that was converted to SDK into a new project (new directory) even though the Package JSON is empty.
This was the steps I've taken:

1. Created a custom app using Application Engine Studio
2. npx @servicenow/sdk init --from 53df26b383b1a610b02ac430ceaad3f4 on my computer
3. Did a build and install
   
   The Package JSON never got set
4. On my coworkers computer I've ran npx @servicenow/sdk init --from 53df26b383b1a610b02ac430ceaad3f4 and gotten this error:

[now-sdk] ERROR: Cannot convert an application that's already a nowSDK app.

My understanding was that as long as Package JSON was empty we should be able to init again and again.

[shaumik100x]

Interesting, when i queried that record

{
    "success": true,
    "message": "Retrieved 1 record(s) from sys_app.",
    "columns": [
        "sys_code",
        "template",
        "short_description",
        "private",
        "license_definition",
        "restrict_table_access",
        "ide_created",
        "source",
        "sys_updated_on",
        "license_category",
        "sys_class_name",
        "vendor_prefix",
        "store_url",
        "uninstall_blocked",
        "licensable",
        "sys_id",
        "user_role",
        "sys_updated_by",
        "sys_created_on",
        "vendor",
        "scope",
        "logo",
        "package_json",
        "installed_as_dependency",
        "store_correlation_id",
        "sys_created_by",
        "runtime_access_tracking",
        "trackable",
        "can_edit_in_studio",
        "guided_setup_guid",
        "sys_mod_count",
        "active",
        "hide_on_ui",
        "js_level",
        "license_model",
        "menu",
        "sys_tags",
        "version",
        "scoped_administration",
        "subscription_entitlement",
        "license",
        "enforce_license",
        "name",
    ],
    "rows": [
        {
            "sys_code": "",
            "template": "",
            "short_description": "asdf",
            "private": "false",
            "license_definition": "",
            "restrict_table_access": "false",
            "ide_created": "AES",
            "source": "x_1628191_real_app",
            "sys_updated_on": "2025-06-05 01:05:27",
            "license_category": "none",
            "sys_class_name": "sys_app",
            "vendor_prefix": "",
            "store_url": "",
            "uninstall_blocked": "false",
            "licensable": "true",
            "sys_id": "53df26b383b1a610b02ac430ceaad3f4",
            "user_role": "",
            "sys_updated_by": "admin",
            "sys_created_on": "2025-06-05 01:05:27",
            "vendor": "",
            "scope": "x_1628191_real_app",
            "logo": "",
            "package_json": "x_1628191_real_app/real_app/1.0.0/package.json",
            "installed_as_dependency": "false",
            "store_correlation_id": "",
            "sys_created_by": "admin",
            "runtime_access_tracking": "permissive",
            "trackable": "true",
            "can_edit_in_studio": "true",
            "guided_setup_guid": "",
            "sys_mod_count": "1",
            "active": "true",
            "hide_on_ui": "false",
            "js_level": "es_latest",
            "license_model": "none",
            "menu": "",
            "sys_tags": "",
            "version": "1.0.0",
            "scoped_administration": "false",
            "subscription_entitlement": "",
            "license": "",
            "enforce_license": "none",
            "name": "real_app",
        }
    ],
}

"package_json": "x_1628191_real_app/real_app/1.0.0/package.json", is there

[bryce-godfrey]

I'm unable to init an existing app that was converted to SDK into a new project (new directory) even though the Package JSON is empty. This was the steps I've taken:

1. Created a custom app using Application Engine Studio
2. npx @servicenow/sdk init --from 53df26b383b1a610b02ac430ceaad3f4 on my computer
3. Did a build and install
   
   The Package JSON never got set
4. On my coworkers computer I've ran npx @servicenow/sdk init --from 53df26b383b1a610b02ac430ceaad3f4 and gotten this error:

[now-sdk] ERROR: Cannot convert an application that's already a nowSDK app.

My understanding was that as long as Package JSON was empty we should be able to init again and again.

Yes it should convert again if the packagejson field for the sys_app on the instance is empty, but let me have my team verify that.