apib2swagger 1.12.0 → 1.13.0

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 (118) hide show
  1. package/.github/workflows/codeql-analysis.yml +71 -0
  2. package/.github/workflows/docker-publish.yml +1 -1
  3. package/.github/workflows/nodejs.yml +1 -1
  4. package/.travis.yml +2 -1
  5. package/Dockerfile +1 -1
  6. package/LICENSE +0 -0
  7. package/README.md +29 -3
  8. package/bin/apib2swagger.js +43 -17
  9. package/index.js +81 -366
  10. package/package.json +5 -3
  11. package/src/escape_json_pointer.js +0 -0
  12. package/src/mson_to_json_schema.js +12 -10
  13. package/src/parameters.js +111 -0
  14. package/src/requests.js +344 -0
  15. package/src/responses.js +181 -0
  16. package/src/util.js +127 -0
  17. package/test/input/Attributes.md +0 -0
  18. package/test/input/Issue-#15.md +0 -0
  19. package/test/input/Issue-#22.md +0 -0
  20. package/test/input/Issue-#23.md +0 -0
  21. package/test/input/Issue-#26.md +0 -0
  22. package/test/input/Issue-#29.md +0 -0
  23. package/test/input/Issue-#33.md +0 -0
  24. package/test/input/Issue-#35.md +0 -0
  25. package/test/input/Issue-#36.md +0 -0
  26. package/test/input/Issue-#38.md +0 -0
  27. package/test/input/Issue-#49.md +0 -0
  28. package/test/input/OpenAPI3_attributes.md +36 -0
  29. package/test/input/OpenAPI3_headers.md +74 -0
  30. package/test/input/OpenAPI3_includes.md +22 -0
  31. package/test/input/OpenAPI3_requests.md +162 -0
  32. package/test/input/OpenAPI3_responses.md +177 -0
  33. package/test/input/Schema.md +0 -0
  34. package/test/input/apiblueprint_uber.md +0 -0
  35. package/test/input/apiblueprint_valid_simple.md +0 -0
  36. package/test/input/includes/resource-request-body-2.json +3 -0
  37. package/test/input/includes/resource-request-body.json +3 -0
  38. package/test/input/includes/resource-request-schema.json +9 -0
  39. package/test/input/includes/resource-response-body-2.json +3 -0
  40. package/test/input/includes/resource-response-body.json +3 -0
  41. package/test/input/includes/resource-response-schema.json +9 -0
  42. package/test/input/schema_without_body.md +17 -0
  43. package/test/meta_schema.json +0 -0
  44. package/test/openAPI_30_schema.json +1662 -0
  45. package/test/output/01. Simplest API.json +0 -0
  46. package/test/output/01. Simplest API.ref.json +0 -0
  47. package/test/output/02. Resource and Actions.json +0 -0
  48. package/test/output/02. Resource and Actions.ref.json +0 -0
  49. package/test/output/03. Named Resource and Actions.json +0 -0
  50. package/test/output/03. Named Resource and Actions.ref.json +0 -0
  51. package/test/output/04. Grouping Resources.json +0 -0
  52. package/test/output/04. Grouping Resources.ref.json +0 -0
  53. package/test/output/05. Responses.json +0 -0
  54. package/test/output/05. Responses.ref.json +0 -0
  55. package/test/output/06. Requests.json +0 -0
  56. package/test/output/06. Requests.ref.json +0 -0
  57. package/test/output/07. Parameters.json +0 -0
  58. package/test/output/07. Parameters.ref.json +0 -0
  59. package/test/output/08. Attributes.json +0 -0
  60. package/test/output/08. Attributes.ref.json +0 -0
  61. package/test/output/09. Advanced Attributes.json +0 -0
  62. package/test/output/09. Advanced Attributes.ref.json +0 -0
  63. package/test/output/10. Data Structures.json +0 -0
  64. package/test/output/10. Data Structures.ref.json +0 -0
  65. package/test/output/11. Resource Model.json +0 -0
  66. package/test/output/11. Resource Model.ref.json +0 -0
  67. package/test/output/12. Advanced Action.json +0 -0
  68. package/test/output/12. Advanced Action.ref.json +0 -0
  69. package/test/output/13. Named Endpoints.json +0 -0
  70. package/test/output/13. Named Endpoints.ref.json +0 -0
  71. package/test/output/Attributes.json +0 -0
  72. package/test/output/Attributes.ref.json +0 -0
  73. package/test/output/Gist Fox API + Auth.json +0 -0
  74. package/test/output/Gist Fox API + Auth.ref.json +0 -0
  75. package/test/output/Issue-#15.json +0 -0
  76. package/test/output/Issue-#15.ref.json +0 -0
  77. package/test/output/Issue-#22.json +0 -0
  78. package/test/output/Issue-#22.ref.json +0 -0
  79. package/test/output/Issue-#23.json +0 -0
  80. package/test/output/Issue-#23.ref.json +0 -0
  81. package/test/output/Issue-#26.json +0 -0
  82. package/test/output/Issue-#26.ref.json +0 -0
  83. package/test/output/Issue-#29.json +0 -0
  84. package/test/output/Issue-#29.ref.json +0 -0
  85. package/test/output/Issue-#33.json +0 -0
  86. package/test/output/Issue-#33.ref.json +0 -0
  87. package/test/output/Issue-#35.json +0 -0
  88. package/test/output/Issue-#35.ref.json +0 -0
  89. package/test/output/Issue-#36.json +0 -0
  90. package/test/output/Issue-#36.ref.json +0 -0
  91. package/test/output/Issue-#38.bearer.json +0 -0
  92. package/test/output/Issue-#38.json +0 -0
  93. package/test/output/Issue-#38.ref.json +0 -0
  94. package/test/output/Issue-#49.json +0 -0
  95. package/test/output/Issue-#49.ref.json +0 -0
  96. package/test/output/OpenAPI3_attributes.json +199 -0
  97. package/test/output/OpenAPI3_attributes.ref.json +173 -0
  98. package/test/output/OpenAPI3_headers.json +169 -0
  99. package/test/output/OpenAPI3_headers.ref.json +169 -0
  100. package/test/output/OpenAPI3_includes.json +66 -0
  101. package/test/output/OpenAPI3_includes.ref.json +66 -0
  102. package/test/output/OpenAPI3_requests.json +326 -0
  103. package/test/output/OpenAPI3_requests.ref.json +321 -0
  104. package/test/output/OpenAPI3_responses.json +255 -0
  105. package/test/output/OpenAPI3_responses.ref.json +245 -0
  106. package/test/output/Schema.json +0 -0
  107. package/test/output/Schema.ref.json +0 -0
  108. package/test/output/apiblueprint_uber.json +0 -0
  109. package/test/output/apiblueprint_uber.ref.json +0 -0
  110. package/test/output/apiblueprint_valid_simple.json +0 -0
  111. package/test/output/apiblueprint_valid_simple.ref.json +0 -0
  112. package/test/output/schema_without_body.json +52 -0
  113. package/test/output/schema_without_body.ref.json +52 -0
  114. package/test/swagger_20_schema.json +0 -0
  115. package/test/test.js +24 -9
  116. package/test/util.test.js +151 -0
  117. package/.npmignore +0 -35
  118. package/package-lock.json +0 -2021
package/test/output/OpenAPI3_headers.json ADDED
@@ -0,0 +1,169 @@
1
+ {
2
+ "openapi": "3.0.3",
3
+ "info": {
4
+ "title": "",
5
+ "version": "1.0.0",
6
+ "description": ""
7
+ },
8
+ "servers": [
9
+ {
10
+ "url": "https://www.testhost.com"
11
+ }
12
+ ],
13
+ "paths": {
14
+ "/some/resource": {
15
+ "post": {
16
+ "responses": {
17
+ "200": {
18
+ "description": "OK",
19
+ "headers": {},
20
+ "content": {}
21
+ }
22
+ },
23
+ "summary": "Some resource",
24
+ "operationId": "Some resource",
25
+ "description": "",
26
+ "tags": [],
27
+ "parameters": [
28
+ {
29
+ "name": "x-testhost-auth-sign",
30
+ "in": "header",
31
+ "description": "e.g. signed body",
32
+ "required": false,
33
+ "example": "signed body",
34
+ "schema": {
35
+ "type": "string"
36
+ }
37
+ },
38
+ {
39
+ "name": "Authorization",
40
+ "in": "header",
41
+ "description": "e.g. Bearer Admin",
42
+ "required": false,
43
+ "example": "Bearer Admin",
44
+ "schema": {
45
+ "type": "string"
46
+ }
47
+ },
48
+ {
49
+ "name": "Authorization",
50
+ "in": "header",
51
+ "description": "e.g. Bearer User",
52
+ "required": false,
53
+ "example": "Bearer User",
54
+ "schema": {
55
+ "type": "string"
56
+ }
57
+ }
58
+ ],
59
+ "requestBody": {
60
+ "content": {
61
+ "application/json": {
62
+ "schema": {
63
+ "type": "object",
64
+ "properties": {
65
+ "someType": {
66
+ "type": "string"
67
+ }
68
+ }
69
+ }
70
+ }
71
+ }
72
+ }
73
+ }
74
+ },
75
+ "/some/restricted/resource": {
76
+ "get": {
77
+ "responses": {
78
+ "200": {
79
+ "description": "OK",
80
+ "headers": {},
81
+ "content": {}
82
+ }
83
+ },
84
+ "summary": "Restricted resource",
85
+ "operationId": "Restricted resource",
86
+ "description": "Has a duplicate header within a single declaration",
87
+ "tags": [],
88
+ "parameters": [
89
+ {
90
+ "name": "Authorization",
91
+ "in": "header",
92
+ "description": "e.g. Bearer Admin",
93
+ "required": false,
94
+ "example": "Bearer Admin",
95
+ "schema": {
96
+ "type": "string"
97
+ }
98
+ }
99
+ ],
100
+ "requestBody": {
101
+ "content": {
102
+ "application/json": {
103
+ "schema": {
104
+ "type": "object",
105
+ "properties": {
106
+ "message1": {
107
+ "type": "string",
108
+ "description": "This is the message description "
109
+ }
110
+ }
111
+ }
112
+ }
113
+ }
114
+ }
115
+ }
116
+ },
117
+ "/additional/resource": {
118
+ "get": {
119
+ "responses": {
120
+ "200": {
121
+ "description": "OK",
122
+ "headers": {},
123
+ "content": {}
124
+ }
125
+ },
126
+ "summary": "Additional resource",
127
+ "operationId": "Additional resource",
128
+ "description": "",
129
+ "tags": [],
130
+ "parameters": [
131
+ {
132
+ "name": "x-testhost-auth-sign",
133
+ "in": "header",
134
+ "description": "e.g. signed body",
135
+ "required": false,
136
+ "example": "signed body",
137
+ "schema": {
138
+ "type": "string"
139
+ }
140
+ },
141
+ {
142
+ "name": "Authorization",
143
+ "in": "header",
144
+ "description": "e.g. Bearer Admin",
145
+ "required": false,
146
+ "example": "Bearer Admin",
147
+ "schema": {
148
+ "type": "string"
149
+ }
150
+ },
151
+ {
152
+ "name": "Authorization",
153
+ "in": "header",
154
+ "description": "e.g. Bearer User",
155
+ "required": false,
156
+ "example": "Bearer User",
157
+ "schema": {
158
+ "type": "string"
159
+ }
160
+ }
161
+ ]
162
+ }
163
+ }
164
+ },
165
+ "components": {
166
+ "schemas": {}
167
+ },
168
+ "tags": []
169
+ }
package/test/output/OpenAPI3_headers.ref.json ADDED
@@ -0,0 +1,169 @@
1
+ {
2
+ "openapi": "3.0.3",
3
+ "info": {
4
+ "title": "",
5
+ "version": "1.0.0",
6
+ "description": ""
7
+ },
8
+ "servers": [
9
+ {
10
+ "url": "https://www.testhost.com"
11
+ }
12
+ ],
13
+ "paths": {
14
+ "/some/resource": {
15
+ "post": {
16
+ "responses": {
17
+ "200": {
18
+ "description": "OK",
19
+ "headers": {},
20
+ "content": {}
21
+ }
22
+ },
23
+ "summary": "Some resource",
24
+ "operationId": "Some resource",
25
+ "description": "",
26
+ "tags": [],
27
+ "parameters": [
28
+ {
29
+ "name": "x-testhost-auth-sign",
30
+ "in": "header",
31
+ "description": "e.g. signed body",
32
+ "required": false,
33
+ "example": "signed body",
34
+ "schema": {
35
+ "type": "string"
36
+ }
37
+ },
38
+ {
39
+ "name": "Authorization",
40
+ "in": "header",
41
+ "description": "e.g. Bearer Admin",
42
+ "required": false,
43
+ "example": "Bearer Admin",
44
+ "schema": {
45
+ "type": "string"
46
+ }
47
+ },
48
+ {
49
+ "name": "Authorization",
50
+ "in": "header",
51
+ "description": "e.g. Bearer User",
52
+ "required": false,
53
+ "example": "Bearer User",
54
+ "schema": {
55
+ "type": "string"
56
+ }
57
+ }
58
+ ],
59
+ "requestBody": {
60
+ "content": {
61
+ "application/json": {
62
+ "schema": {
63
+ "type": "object",
64
+ "properties": {
65
+ "someType": {
66
+ "type": "string"
67
+ }
68
+ }
69
+ }
70
+ }
71
+ }
72
+ }
73
+ }
74
+ },
75
+ "/some/restricted/resource": {
76
+ "get": {
77
+ "responses": {
78
+ "200": {
79
+ "description": "OK",
80
+ "headers": {},
81
+ "content": {}
82
+ }
83
+ },
84
+ "summary": "Restricted resource",
85
+ "operationId": "Restricted resource",
86
+ "description": "Has a duplicate header within a single declaration",
87
+ "tags": [],
88
+ "parameters": [
89
+ {
90
+ "name": "Authorization",
91
+ "in": "header",
92
+ "description": "e.g. Bearer Admin",
93
+ "required": false,
94
+ "example": "Bearer Admin",
95
+ "schema": {
96
+ "type": "string"
97
+ }
98
+ }
99
+ ],
100
+ "requestBody": {
101
+ "content": {
102
+ "application/json": {
103
+ "schema": {
104
+ "type": "object",
105
+ "properties": {
106
+ "message1": {
107
+ "type": "string",
108
+ "description": "This is the message description "
109
+ }
110
+ }
111
+ }
112
+ }
113
+ }
114
+ }
115
+ }
116
+ },
117
+ "/additional/resource": {
118
+ "get": {
119
+ "responses": {
120
+ "200": {
121
+ "description": "OK",
122
+ "headers": {},
123
+ "content": {}
124
+ }
125
+ },
126
+ "summary": "Additional resource",
127
+ "operationId": "Additional resource",
128
+ "description": "",
129
+ "tags": [],
130
+ "parameters": [
131
+ {
132
+ "name": "x-testhost-auth-sign",
133
+ "in": "header",
134
+ "description": "e.g. signed body",
135
+ "required": false,
136
+ "example": "signed body",
137
+ "schema": {
138
+ "type": "string"
139
+ }
140
+ },
141
+ {
142
+ "name": "Authorization",
143
+ "in": "header",
144
+ "description": "e.g. Bearer Admin",
145
+ "required": false,
146
+ "example": "Bearer Admin",
147
+ "schema": {
148
+ "type": "string"
149
+ }
150
+ },
151
+ {
152
+ "name": "Authorization",
153
+ "in": "header",
154
+ "description": "e.g. Bearer User",
155
+ "required": false,
156
+ "example": "Bearer User",
157
+ "schema": {
158
+ "type": "string"
159
+ }
160
+ }
161
+ ]
162
+ }
163
+ }
164
+ },
165
+ "components": {
166
+ "schemas": {}
167
+ },
168
+ "tags": []
169
+ }
package/test/output/OpenAPI3_includes.json ADDED
@@ -0,0 +1,66 @@
1
+ {
2
+ "openapi": "3.0.3",
3
+ "info": {
4
+ "title": "",
5
+ "version": "1.0.0",
6
+ "description": ""
7
+ },
8
+ "servers": [
9
+ {
10
+ "url": "https://www.testhost.com"
11
+ }
12
+ ],
13
+ "paths": {
14
+ "/some/resource": {
15
+ "get": {
16
+ "responses": {
17
+ "200": {
18
+ "description": "OK",
19
+ "headers": {},
20
+ "content": {
21
+ "application/json": {
22
+ "schema": {
23
+ "$ref": "./includes/resource-response-schema.json"
24
+ },
25
+ "examples": {
26
+ "example1": {
27
+ "$ref": "./includes/resource-response-body.json"
28
+ },
29
+ "example2": {
30
+ "$ref": "./includes/resource-response-body-2.json"
31
+ }
32
+ }
33
+ }
34
+ }
35
+ }
36
+ },
37
+ "summary": "Some resource",
38
+ "operationId": "Some resource",
39
+ "description": "",
40
+ "tags": [],
41
+ "parameters": [],
42
+ "requestBody": {
43
+ "content": {
44
+ "application/json": {
45
+ "examples": {
46
+ "example1": {
47
+ "$ref": "./includes/resource-request-body.json"
48
+ },
49
+ "example2": {
50
+ "$ref": "./includes/resource-request-body-2.json"
51
+ }
52
+ },
53
+ "schema": {
54
+ "$ref": "./includes/resource-request-schema.json"
55
+ }
56
+ }
57
+ }
58
+ }
59
+ }
60
+ }
61
+ },
62
+ "components": {
63
+ "schemas": {}
64
+ },
65
+ "tags": []
66
+ }
package/test/output/OpenAPI3_includes.ref.json ADDED
@@ -0,0 +1,66 @@
1
+ {
2
+ "openapi": "3.0.3",
3
+ "info": {
4
+ "title": "",
5
+ "version": "1.0.0",
6
+ "description": ""
7
+ },
8
+ "servers": [
9
+ {
10
+ "url": "https://www.testhost.com"
11
+ }
12
+ ],
13
+ "paths": {
14
+ "/some/resource": {
15
+ "get": {
16
+ "responses": {
17
+ "200": {
18
+ "description": "OK",
19
+ "headers": {},
20
+ "content": {
21
+ "application/json": {
22
+ "schema": {
23
+ "$ref": "./includes/resource-response-schema.json"
24
+ },
25
+ "examples": {
26
+ "example1": {
27
+ "$ref": "./includes/resource-response-body.json"
28
+ },
29
+ "example2": {
30
+ "$ref": "./includes/resource-response-body-2.json"
31
+ }
32
+ }
33
+ }
34
+ }
35
+ }
36
+ },
37
+ "summary": "Some resource",
38
+ "operationId": "Some resource",
39
+ "description": "",
40
+ "tags": [],
41
+ "parameters": [],
42
+ "requestBody": {
43
+ "content": {
44
+ "application/json": {
45
+ "examples": {
46
+ "example1": {
47
+ "$ref": "./includes/resource-request-body.json"
48
+ },
49
+ "example2": {
50
+ "$ref": "./includes/resource-request-body-2.json"
51
+ }
52
+ },
53
+ "schema": {
54
+ "$ref": "./includes/resource-request-schema.json"
55
+ }
56
+ }
57
+ }
58
+ }
59
+ }
60
+ }
61
+ },
62
+ "components": {
63
+ "schemas": {}
64
+ },
65
+ "tags": []
66
+ }