@servicenow/sdk 1.0.6 → 2.0.1

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.
Files changed (104) hide show
  1. package/README.md +16 -68
  2. package/bin/debug.js +1 -1
  3. package/bin/index.js +2 -1
  4. package/dist/api/index.d.ts +1 -0
  5. package/dist/api/index.js +31279 -0
  6. package/dist/global/index.d.ts +1 -0
  7. package/package.json +53 -40
  8. package/src/core/index.ts +10 -0
  9. package/dist/auth/index.d.ts +0 -11
  10. package/dist/auth/index.js +0 -206
  11. package/dist/auth/index.js.map +0 -1
  12. package/dist/auth/keychain/index.d.ts +0 -12
  13. package/dist/auth/keychain/index.js +0 -44
  14. package/dist/auth/keychain/index.js.map +0 -1
  15. package/dist/command/auth/commands/clear.d.ts +0 -6
  16. package/dist/command/auth/commands/clear.js +0 -30
  17. package/dist/command/auth/commands/clear.js.map +0 -1
  18. package/dist/command/auth/commands/list.d.ts +0 -6
  19. package/dist/command/auth/commands/list.js +0 -30
  20. package/dist/command/auth/commands/list.js.map +0 -1
  21. package/dist/command/auth/commands/save.d.ts +0 -10
  22. package/dist/command/auth/commands/save.js +0 -96
  23. package/dist/command/auth/commands/save.js.map +0 -1
  24. package/dist/command/auth/commands/setDefault.d.ts +0 -6
  25. package/dist/command/auth/commands/setDefault.js +0 -30
  26. package/dist/command/auth/commands/setDefault.js.map +0 -1
  27. package/dist/command/auth/commands/validate.d.ts +0 -6
  28. package/dist/command/auth/commands/validate.js +0 -43
  29. package/dist/command/auth/commands/validate.js.map +0 -1
  30. package/dist/command/auth/index.d.ts +0 -2
  31. package/dist/command/auth/index.js +0 -35
  32. package/dist/command/auth/index.js.map +0 -1
  33. package/dist/command/build/index.d.ts +0 -11
  34. package/dist/command/build/index.js +0 -102
  35. package/dist/command/build/index.js.map +0 -1
  36. package/dist/command/clean/index.d.ts +0 -6
  37. package/dist/command/clean/index.js +0 -34
  38. package/dist/command/clean/index.js.map +0 -1
  39. package/dist/command/compile/index.d.ts +0 -7
  40. package/dist/command/compile/index.js +0 -42
  41. package/dist/command/compile/index.js.map +0 -1
  42. package/dist/command/convert/index.d.ts +0 -12
  43. package/dist/command/convert/index.js +0 -77
  44. package/dist/command/convert/index.js.map +0 -1
  45. package/dist/command/create/index.d.ts +0 -15
  46. package/dist/command/create/index.js +0 -92
  47. package/dist/command/create/index.js.map +0 -1
  48. package/dist/command/deploy/index.d.ts +0 -12
  49. package/dist/command/deploy/index.js +0 -80
  50. package/dist/command/deploy/index.js.map +0 -1
  51. package/dist/command/fetch/index.d.ts +0 -12
  52. package/dist/command/fetch/index.js +0 -78
  53. package/dist/command/fetch/index.js.map +0 -1
  54. package/dist/command/generate-modules/index.d.ts +0 -7
  55. package/dist/command/generate-modules/index.js +0 -46
  56. package/dist/command/generate-modules/index.js.map +0 -1
  57. package/dist/command/pack/index.d.ts +0 -6
  58. package/dist/command/pack/index.js +0 -40
  59. package/dist/command/pack/index.js.map +0 -1
  60. package/dist/command/package-dependencies/index.d.ts +0 -8
  61. package/dist/command/package-dependencies/index.js +0 -52
  62. package/dist/command/package-dependencies/index.js.map +0 -1
  63. package/dist/command/test/index.d.ts +0 -3
  64. package/dist/command/test/index.js +0 -52
  65. package/dist/command/test/index.js.map +0 -1
  66. package/dist/command/transform/index.d.ts +0 -3
  67. package/dist/command/transform/index.js +0 -63
  68. package/dist/command/transform/index.js.map +0 -1
  69. package/dist/epilogue/index.d.ts +0 -1
  70. package/dist/epilogue/index.js +0 -9
  71. package/dist/epilogue/index.js.map +0 -1
  72. package/dist/index.d.ts +0 -1
  73. package/dist/index.js +0 -55
  74. package/dist/index.js.map +0 -1
  75. package/dist/usage/index.d.ts +0 -1
  76. package/dist/usage/index.js +0 -16
  77. package/dist/usage/index.js.map +0 -1
  78. package/dist/util.d.ts +0 -1
  79. package/dist/util.js +0 -25
  80. package/dist/util.js.map +0 -1
  81. package/src/auth/index.ts +0 -238
  82. package/src/auth/keychain/index.ts +0 -23
  83. package/src/command/auth/commands/clear.ts +0 -21
  84. package/src/command/auth/commands/list.ts +0 -21
  85. package/src/command/auth/commands/save.ts +0 -100
  86. package/src/command/auth/commands/setDefault.ts +0 -21
  87. package/src/command/auth/commands/validate.ts +0 -35
  88. package/src/command/auth/index.ts +0 -24
  89. package/src/command/build/index.ts +0 -100
  90. package/src/command/clean/index.ts +0 -22
  91. package/src/command/compile/index.ts +0 -31
  92. package/src/command/convert/index.ts +0 -76
  93. package/src/command/create/index.ts +0 -97
  94. package/src/command/deploy/index.ts +0 -84
  95. package/src/command/fetch/index.ts +0 -78
  96. package/src/command/generate-modules/index.ts +0 -36
  97. package/src/command/pack/index.ts +0 -27
  98. package/src/command/package-dependencies/index.ts +0 -43
  99. package/src/command/test/index.ts +0 -40
  100. package/src/command/transform/index.ts +0 -45
  101. package/src/epilogue/index.ts +0 -5
  102. package/src/index.ts +0 -50
  103. package/src/usage/index.ts +0 -13
  104. package/src/util.ts +0 -21
package/README.md CHANGED
@@ -1,86 +1,34 @@
1
1
  # ServiceNow SDK
2
2
 
3
- Use the ServiceNow software development kit (SDK) to add JavaScript modules and third-party libraries to applications locally and upload changes to an instance of the Now Platform.
3
+ The ServiceNow software development kit (SDK) provides the core libraries and tools for authoring applications with application metadata written in code using the ServiceNow Fluent language, as well as server-side JavaScript modules and third-party libraries. The SDK aims to transform the ServiceNow development experience by providing a source-driven model with modern, industry-standard development paradigms.
4
4
 
5
- # Overview
5
+ ## Prerequisites
6
6
 
7
- With the ServiceNow SDK, developers can create and modify scoped applications with custom modules and third-party libraries in Visual Studio Code and deploy those applications to a non-production instance on the Washington DC release. Writing ServiceNow applications outside of a ServiceNow instance enables you to use industry-standard development practices and familiar tools and catch errors at build-time rather than at run-time only.
8
-
9
- For more information see the [SDK Overview documentation](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/script/sdk/concept/servicenow-sdk.html) or the [CLI Overview](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/script/sdk/reference/servicenow-sdk-cli-commands.html)
7
+ - Node.js `v18.16.1`
8
+ - npm `v8.19.3`
10
9
 
11
10
  ## Installation
12
11
 
13
- Install the ServiceNow software development kit (SDK) locally using Node Package Manager (npm).
14
-
15
- ### Before you begin
16
-
17
- Your system must meet the following requirements to use npm to install the SDK:
18
- * Node.js v16.16.0 or later
19
- * npm v8.11.0 or later
20
-
21
- To install or upgrade Node.js or npm, see the [installation instructions](https://docs.npmjs.com/cli/v8/configuring-npm/install) on the npm website.
22
-
23
- ### Procedure
24
-
25
- 1. Open a command-line tool on your system.
26
- 2. Verify that your system meets the requirements.
27
- a. Enter `node –v`​ to check if you have Node.js installed and which version.
28
- b. Enter `npm –v`​ to check if you have npm installed and which version.
29
- 3. Enter the following command to install the SDK:
30
- ```bash
12
+ ```sh
31
13
  npm install --global @servicenow/sdk
32
14
  ```
33
15
 
34
- ## Usage
35
-
36
- ### Authentication
37
-
38
- Authenticate with a ServiceNow instance using a user account with an `admin` role.
39
-
40
- ```bash
41
- now-sdk auth save default
42
- ```
43
-
44
- View credentials saved in the device keychain or credential manager on your system.
45
-
46
- ```bash
47
- now-sdk auth list
48
- ```
49
-
50
- ### Creating an app
51
-
52
- Create a new scoped application, optionally including a sample table.
53
-
54
- **Note**: Replace `{vendorprefix}` with your organization's unique scope prefix.
55
- ```bash
56
- now-sdk create sdk_demo x_{vendorprefix}_demo --sampleTable
57
- ```
58
-
59
- ### Building code changes
16
+ ## Upgrading
60
17
 
61
- Compile source files and generate a deployable package. Third-party library dependencies are converted into XML files that can be installed with the application.
62
-
63
- ```bash
64
- now-sdk build
65
- ```
66
-
67
- ### Deploying app updates
68
-
69
- Deploy an application to an instance. Before using the deploy command, you must use the build command to generate a deployable package.
70
-
71
- ```bash
72
- now-sdk deploy
18
+ ```sh
19
+ now-sdk upgrade
73
20
  ```
74
21
 
75
- ### Synchronizing changes from the instance
22
+ ## Documentation
76
23
 
77
- Download application metadata from an instance and update the metadata XML files in your local application to match.
24
+ - [Using the ServiceNow SDK CLI](https://docs.servicenow.com/bundle/xanadu-application-development/page/build/servicenow-sdk/reference/servicenow-sdk-cli-commands.html)
25
+ - [Overview of the ServiceNow Fluent Language](https://docs.servicenow.com/bundle/xanadu-application-development/page/build/servicenow-sdk/concept/servicenow-fluent.html)
26
+ - [Installing the Fluent VS Code Extension](https://docs.servicenow.com/bundle/xanadu-application-development/page/build/servicenow-sdk/task/install-fluent-language-extension-vs-code.html)
78
27
 
79
- ```bash
80
- now-sdk fetch
81
- ```
28
+ ## Release Notes
82
29
 
83
- ## What to do next
30
+ View the release notes on the [ServiceNow documentation site](https://docs.servicenow.com/bundle/xanadu-release-notes/page/release-notes/now-platform-app-engine/servicenow-sdk-rn.html).
84
31
 
85
- Use the ServiceNow SDK to create a scoped application or convert an existing application for use with the SDK. For more information, see [Create or convert an application with the ServiceNow SDK](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/script/sdk/task/create-application-now-sdk.html).
32
+ ## Known Issues
86
33
 
34
+ View the list of known issues on the [ServiceNow support site](https://support.servicenow.com/problem_list.do?sysparm_query=u_product_initial_taxonomy=a859dddac3773510f9691f0fb00131ba^stateNOT%20IN23,3).
package/bin/debug.js CHANGED
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node --inspect-brk
2
2
 
3
- require('../dist/index.js')
3
+ require('@servicenow/sdk-cli')
package/bin/index.js CHANGED
@@ -1,2 +1,3 @@
1
1
  #!/usr/bin/env node
2
- require('../dist/index.js')
2
+
3
+ require('@servicenow/sdk-cli')
@@ -0,0 +1 @@
1
+ export * from '@servicenow/sdk-api';