All notable changes to this project will be documented in this file. See standard-version for commit guidelines.
7.5.1 (2024-10-08)
- Prevent mutation of global headers config (8abba41)
7.5.0 (2024-10-08)
- adds support for defining global headers in
IManagementClientConfig
(6582914) - updates deps (3d6fe1f)
7.4.0 (2024-10-03)
- adds 'display_timezone' to ContentItemElement class. Fixes mapping of components in element (bd1b082)
7.3.0 (2024-09-26)
- updates deps (e88a901)
7.2.0 (2024-08-15)
- updates deps (& fixes Axios vulnerability), updates eslint config (b6ce5bb)
7.1.1 (2024-08-14)
- Use full reference contract for asset folders (adds ability to reference asset folder by
codename
) (8a6a5a5)
7.1.0 (2024-08-13)
- Add spaces to item, installs prettier as devDep (86e85d4)
- Adds support for asset folder codenames (d032c7b)
7.0.0 (2024-07-29)
- Removes deprecated
listWorkflowSteps
andchangeWorkflowStepOfLanguageVariant
queries - Removes deprecated 'workflow_step' from language variant model
- Adds support for
schedule
anddue_date
props in language variants (b60a84c) - Adds support for copy data options when cloning environment (fixes #150) (5a7df98)
- Adds support for setting
due_date
when upserting language variant (34cc81b) - Adds support for Web spotlight API endpoints (activate/deactivate/get status) (4070892)
- Removes deprecated 'workflow_step' from language variant model (a687bf1)
- Removes deprecated
listWorkflowSteps
andchangeWorkflowStepOfLanguageVariant
queries (a56173c) - updates deps & sets required node.js to <= 20 (98b0cc1)
6.5.0 (2024-07-02)
- Adds support for fetching published language variants (8fc4668)
6.4.0 (2024-06-28)
- updates deps (74f0f7d)
6.3.1 (2024-06-26)
6.3.0 (2024-05-17)
- Adds
elements
property to asset model (a07f051)
6.2.1 (2024-05-07)
- Fixes invalid
filter
types in webhooks - Adds missing
headers
property to webhook data model
6.2.0 (2024-04-29)
- updates deps (90bf54e)
6.1.0 (2024-04-02)
- adds support for
move
operation type, adds support forunder
taxonomy modification prop (fixes #146) (e70be03)
6.0.0 (2024-03-21)
- change element types to discriminated union. Renames
IElementShared
toElement
and changes it to type instead of interface (#144)
- add new webhook filters (#143) (ae43650)
- change element types to discriminated union. Renames
IElementShared
toElement
and changes it to type instead of interface (#144) (7d35f3e) - change the folder patch operation type into a discriminated union (#142) (6994c3a)
- updates dev deps (d9a7873)
5.9.0 (2024-02-29)
- Add support for collections in spaces (#141) (db09550)
- added display_timezone to workflow model (#136) (cfc5ef9)
- adds support for Webhook headers (fixes #139) (9173a0b)
- updates deps (333db01)
5.8.2 (2024-01-29)
- Adds 'components' to element models (d0ac229)
5.8.1 (2024-01-29)
- Fixes missing listQueryConfig when using toAllPromise (5d4868e)
- Updates webhook contract models (actions) (#134) (1cf2e4c)
5.8.0 (2024-01-22)
5.7.0 (2023-12-06)
- updates deps (ba32a69)
- Downgrades TS due to incompatibility with karma tests (d10c486)
- Uses 'null' type for element's value property contract (7d9d78e)
5.6.0 (2023-11-16)
- updates deps (updated core-sdk with latest axios), updates node to be >= 16 (5fca107)
5.5.0 (2023-11-01)
5.4.0 (2023-10-24)
5.3.0 (2023-09-07)
5.2.0 (2023-07-31)
- updates '@kontent-ai/core-sdk' dependency (4616d3b)
5.1.0 (2023-07-31)
- adds 'scheduled_step' property to workflow (fixes #116) (9a5d161)
- adds support 'external_id' property when referencing content type in new content items (fixes #119) (4ced950)
- adds support for 'getPreviewConfiguration' API endpoint (#95) (6f8c7a5)
- adds support for 'modifyPreviewConfiguration' query (#95) (2baa8ff)
- updates all dependencies & migrates to eslint from tslint (15dcc29)
- fixes mapping of enable & disable webhook responses which causes exception to occur (21ecdda)
- ITaxonomy element data is missing name property #113 (#114) (d07b457)
- makes 'codename' in url slug element optional (fixes #118) (751c445)
- makes id in multiple choice option non-required (fixes #117) (2d9143b)
- typo (#112) (066b363)
5.0.0 (2023-04-12)
- Renames all project related properties & types & queries to reflect new environment naming conventions, also removes deprecated validateProject query
- Adds support for spaces & adds null support for regex flag (#109) (d11e5f1)
- Renames all project related properties & types & queries to reflect new environment naming conventions, also removes deprecated validateProject query (e99f007)
- updates dependencies (788779b)
- updates dependencies (bdaa2c7)
4.1.0 (2023-03-08)
- Add spaces support (#105) (d765d45), closes #104
- Adds id field to IAddContentItemPostCOntract and makes id and codename nullable (#101) (14cd7ae)
- adds support for limiting workflows to collections (#96) (bcbdde7)
- Unifies shared elements models (#100) (3a59a45)
- updates deps (26ba21e)
4.0.0 (2023-01-18)
- Adds ability to specify
workflow
inupsertLanguageVariant
query (#93)
Updated way of using the upsertLanguageVariant
is:
import { ManagementClient } from '@kontent-ai/management-sdk';
const client = new ManagementClient({
environmentId: '<YOUR_PROJECT_ID>',
apiKey: '<YOUR_API_KEY>'
});
const response = await client
.upsertLanguageVariant()
.byItemCodename('x')
.byLanguageCodename('x')
.withData((builder) => {
return {
elements: [
builder.textElement({
element: {
codename: 'xElementCodename'
},
value: 'xText'
}),
],
workflow: {
step_identifier: {
codename: 'y'
},
workflow_identifier: {
codename: 'x'
}
}
}
})
.toPromise();
- Add workflow to upsert variant (#93) (9472209)
- remove is_non_localizable property from unsupported type elements in MAPI (561583c)
- Update dependencies (#98) (8e31e20)
3.4.0 (2022-10-03)
- updates dependencies (e8183bb)
3.3.0 (2022-09-14)
- Adds default value support for linked items & asset elements (fixes #84), updates default property signature (bd13ec2)
3.2.0 (2022-09-14)
3.1.0 (2022-08-08)
3.0.1 (2022-07-25)
- Fixes 'uploadAssetFromUrl ' method from never resolving by cloning config and making sure proper headers are used for 'addAsset' method (fixes #82) (c12fa3c)
3.0.0 (2022-07-14)
3.0.0-0 (2022-07-14)
2.9.2 (2022-07-13)
- Use PUT request for update workflow query (7e49a58)
2.9.1 (2022-07-13)
- Handle errors where 'error_code' is equal to '0' (3ef7fa0)
2.9.0 (2022-07-13)
- Adds support for default values in text, taxonomy, date time, multiple choice and number elements (eb22c57)
- Moves WorkflowColor to WorkflowContracts and uses it for contracts as well as in models (f6ef3cc)
- Renames 'changeWorkflowLanguageVariant' to 'changeWorkflowOfLanguageVariant' (2a77dee)
- updates all dev dependencies (24a8c89)
- Adds missing 'await' in post query (d2a4c69)
2.8.0 (2022-06-30)
- Adds support for default values in text, taxonomy, date time, multiple choice and number elements (eb22c57)
- updates all dev dependencies (24a8c89)
2.7.0 (2022-05-24)
- adds additional properties to add webhook model (3426c7f)
- makes webhook triggers optional (fc83181)
2.6.0 (2022-05-19)
- Adds support for 'Update workflow' query (fixes #78) (c98fb2e)
- Adds support for allowed link types (2fc7689)
- updates dependencies (2686a9b)
2.5.0 (2022-04-14)
2.4.0 (2022-03-28)
- updates deps (5f4f394)
- Adds missing IAssetElement to ContentTypeElementModel type (12f9a9e)
2.3.0 (2022-03-23)
- updates deps (5f4f394)
2.2.0 (2022-03-17)
- adds is_non_localizable property to type elements (5ef6096)
2.1.0 (2022-03-10)
The upsertAsset
and addAsset
queries now use builder
that helps setting new asset's elements
property. Currently, only taxonomy
element is supported. You may need to update your syntax to following format:
client.addAsset()
.withData((builder) => {
return {
descriptions: [],
elements: [
builder.taxonomyElement({
element: {
codename: 'taxonomy-categories'
},
value: [
{
codename: 'coffee'
},
{
codename: 'brewing'
}
]
})
],
file_reference: {
id: 'x',
type: 'internal'
}
};
})
.toPromise();
- adds support for Environment endpoints
- adds support for asset rendition endpoints (fixes #68) (9e22f6e)
- adds support for taxonomy elements (fixes #71) (d8f3f21)
- updates deps (945ad06)
2.0.2 (2022-01-20)
2.0.2-0 (2022-01-20)
- Return
urlSlugElement()
to elements builder (41e63c2)
2.0.1 (2022-01-19)
- Correct the generic
get()
HTTP method (65946d8)
2.0.0 (2022-01-13)
- Adds management client factory and updates docs to use it (14aa84e)
- Adds support for listing project roles (1aae040)
- Adds support for project user endpoints (abe35f9)
- Adds support for Subscription API (subscription projects & users), updates client configuration by separating management & subscription endpoints (e43ccc3)
- Adds support for view role (acb653c)
- updates all dependencies to latest versions (4bc7fcd)
- Uses list query for taxonomy list endpoint and removes temporary taxonomy response included due to a breaking change in API some time ago (827279d)
- fixes scripts & cuts prerelease (3c25601)
2.0.0-0 (2022-01-13)
- Adds management client factory and updates docs to use it (14aa84e)
- Adds support for listing project roles (1aae040)
- Adds support for project user endpoints (abe35f9)
- Adds support for Subscription API (subscription projects & users), updates client configuration by separating management & subscription endpoints (e43ccc3)
- Adds support for view role (acb653c)
- updates all dependencies to latest versions (4bc7fcd)
- Uses list query for taxonomy list endpoint and removes temporary taxonomy response included due to a breaking change in API some time ago (827279d)
1.8.0 (2021-12-16)
- Adds validation message to Text element regex property
1.7.0 (2021-11-29)
- adds guidelines to taxonomy element data model (9f436cd)
- adds support for subpages element & uses type in favor of enum for some models (5713d8f)
- adds validation_regex support for text element (ac81a48)
- improves types for element builders (0c076c6)
- removes unnecessary builder code by extending content type snippet builder (728a5e1)
- updates dependencies (391b29b)
1.6.0 (2021-11-02)
1.5.0 (2021-09-24)
- updates dependencies (93b80c7)
1.4.0 (2021-08-25)
- updates deps (e306ba6)
1.3.0 (2021-08-12)
- updates dependencies (4031f16)
1.2.0 (2021-07-30)
1.1.0 (2021-07-19)
There are some notable changes when migrating from 0.x.y
(latest release 0.4.10
) version of sdk:
Rxjs
was removed from dependencies and is no longer included with this SDK. One major benefit is reduced complexity & size of this library (about 30-40% size reduction).toObservable
was removed without replacement in favor oftoPromise
. If you need to keep usingObservable
, usefrom
operator that comes withrxjs
(https://www.learnrxjs.io/learn-rxjs/operators/creation/from)- Distributed files, formats and paths were modified. Available outputs:
dist/bundles
,dist/cjs
,dist/es6
,dist/es2020
,dist/esnext
isDeveloper
configuration option was removed without replacementretryStrategy
configuration was updated and simplifies. New options are listed at https://github.com/Kentico/kontent-core-js/blob/7ec7faaa779a4aa55802ade927f296cc3619a720/lib/http/http.models.ts#L16- Support for additional endpoints:
- Create, update & list of collections
- List language variants by collection
- Create asset + binary file from external URL
- Improved typings for content type elements
- Other minor improvements & bug fixes
- adds mode & searchableValue to variant element model and contract (13d9b84)
- adds support for constructing edit urls (fixes #10) (ba2fc2e)
- adds support for creating & updating collections (db2a1d2)
- adds support for listing collections (01bcc2b)
- adds support for listing language variants by collection (f12a877)
- adds support for taxonomy 'term_count_limit' option (fixes #48) (f19aae4)
- adds support for uploading assets & binary files from url (fixes #18), adds automatic mime type detection support (d54a0b8)
- adds types support for content type elements (fixes #46) (01f7c82)
- removes 'isDeveloperMode' config property as its not utilized anymore (986cc40)
- removes "_" from dist folder names (079c1f6)
- updates deps (43e857c)
- updates deps (6123ea0)
- updates deps (fe0778d)
- updates deps (fixes retry strategy) (946f864)
- updates kontent-core dependency to v9 (dd25dd4)
- use 'mime' npm instead of 'mime-type' due to browser compatibility support (2200b73)
- fixes cjs folder name (d470214)
- fixes commonjs folder output (5abf59f)
- fixes package.json entry modules (0fa0176)
0.4.10 (2021-04-21)
- adds support for enabling / disabling webhooks (485cfe0)
0.4.9 (2021-04-21)
- adds support for codename in workflow related endpoints & queries (fixes #35) (98f1ddf)
- adds url encoding tests & changes name of internal base query props (6413d3f)
- simplifies scripts & update dependencies (b948be5)
0.4.8 (2021-01-08)
- updates dependencies (bdde42c)
0.4.7 (2020-12-15)
- adds 'cancel scheduled unpublish' endpoint support (9860c1b)
0.4.6 (2020-12-14)
- adds support for new unpublish / schedule unpublish endpoint & removes deprecated unpublish endpoint (fixes #28) (4da0b6b)
- unifies publish / unpublish naming convention, removes unsused query models (cc78e90)
- updates all dependencies (6b2e7c1)
0.4.5 (2020-11-23)
- updates all dependencies, uses axios models directly instead of proxy models (53837e1)
0.4.4 (2020-11-12)
- uses correct query identifier for upsert content item query (6079c04)
0.4.3 (2020-10-23)
- fixes interface typo (applied_to -> applies_to) in content type elements builder (b019338)
0.4.2 (2020-10-21)
- encodes url by default. Fixes errors when url contained special characters (such as space in filename within uploadBinaryFile method) (7c318f5)
0.4.1 (2020-10-07)
- adds 'responseFetched' callback configuration property to IContentManagementListQueryConfig (f2371f8)
0.4.0 (2020-09-30)
- adds new rich text element properties and removes class mapping of content type element properties. Reason for this removal is that the model class was missing many of existing properties (e.g. rich text element & text element properties are very different) and there was no benefit in using this class.
- refactors language variants query - adds builder similar to addContentType query which gives developers intellisense and better control over creating variants
- adds new rich text element properties and removes class mapping of content type element properties. Reason for this removal is that the model class was missing many of existing properties (e.g. rich text element & text element properties are very different) and there was no benefit in using this class. (fec3fc4)
- adds support for collections (fixes #26) (9f653b0)
- refactors language variants query - adds builder similar to addContentType query which gives developers intellisense and better control over creating variants (e4c003e)
- updates deps + refactors content management error handling (9b5ca5b)
0.3.20 (2020-06-24)
- adds missing type properties to content item contract (fixes #12) (022e267)
- adds support for generic queries (POST, PATCH, GET, PUT & PATCH) (ce00b49)
- adds support for modify taxonomy query (fixes #15) (fd96edc)
- hints file reference 'internal' type (0ad6476)
- updates deps (db94674)
- uses correct url property for add taxonomy query (7ba17dc)
0.3.19 (2020-04-08)
- updates dependencies (69262d1)
0.3.18 (2020-02-25)
- adds 'codename' to content item upsert model & makes 'type' optional (2c2b4fa)
- removes deprecated sitemap locations (71bda7e)
- removes data processing in asset update request data (7898689)
- uses proper model without additional processing for adding taxonomies (585fd4e)
0.3.17 (2020-01-23)
- adds support for content groups in content types and adds missing external id props to content type & snippet (20a71fd)
0.3.16 (2020-01-22)
- adds support for 'modifyContentTypeSnippet' endpoint (a326689)
0.3.15 (2020-01-21)
- Added is_required to ILinkedItemsInType
0.3.14 (2020-01-15)
- assigns raw data to asset folders correctly (654ef6b)
0.3.13 (2020-01-15)
- re-release due to leftover files in dist folder (no code changes) (eb84a96)
0.3.12 (2020-01-15)
- fixes typo in 'ILinkedITemsInType' elements builder interface (fc36157)
- removes obsolete update asset query in favor of upsert query which is now in sync with other endpoints and use proper input data and indentifiers (9308880)
0.3.11 (2020-01-14)
- adds '_raw' property to language variant with component (58fcb6b)
0.3.10 (2020-01-13)
- adds new url property to asset contract & models (fd188c1)
0.3.9 (2020-01-09)
0.3.8 (2020-01-09)
- removes elements query data from delete language variant query (f7cee7a)
0.3.7 (2020-01-09)
- adds support delete language variant API endpoint (90188c7)
0.3.6 (2020-01-07)
- updates all dependencies (reworks retryStrategy options to give more control over what errors should be retried) (29dc496)
0.3.5 (2020-01-06)
- exposes more mapping methods (e.g. mapping contentType instead of whole response) (c01804f)
0.3.4 (2020-01-06)
- adds '_raw' property with original data to base models & fixes incorrect model for content type snippes responses (c4606c8)
0.3.3 (2020-01-06)
- fixes return type of 'toAllPromise' so that it matched original 'toAllPromise'. Adds type check test for items in listing query. (212829e)
0.3.2 (2019-12-19)
- creates MappingService and exposes it via ManagementClient. This service can be used for mapping raw data to SDK models. (146b4b7)
0.3.1 (2019-12-19)
- adds ability to set delay between requests made by listing queries to prevent being rate limited by CM API (b561d10)
0.3.0 (2019-12-18)
- implements ability to get all items with automatic paging using
toAllPromise
andtoAllPromise
extension methods. This commit changes names of some responses and also changes name of property holding paged items to 'items'.
- adds support for list/add/modify asset folders endpoints (b35b08d)
- implements ability to get all items with automatic paging using
toAllPromise
andtoAllPromise
extension methods. This commit changes names of some responses and also changes name of property holding paged items to 'items'. (c77353f)
- fixes incorrect import source in readme (5642343)
- uses base github url in package.json to fix automatic commit url generation (38b243e)
0.2.8 (2019-12-16)
- adds codename to add taxonomy data model (7bb118b)
- adds support for add/get/list webhooks endpoints (5744e94)
- adds support for project information endpoint (234f175)
- adds support for retrieving single taxonomy items (0cdb48f)
- adds support for setting content item codename during creation (94c1f94)
- adds support for updating conten item codename (9c7786e)
- uses internal id for content type identifier instead of external id (bb6d46b)
0.2.7 (2019-11-21)
- add support for 'ListLanguageVariantsOfContentTypeWithVariants' API endpoint (008f5e5)
- adds additional language reference properties and fixes filename (73109ad)
0.2.6 (2019-11-21)
- uses reference contract instead of reference object (5df58b1)
0.2.5 (2019-11-20)
- updates @kentico/kontent-core dep which removes testing warn logging in console (cf38dbe)
0.2.4 (2019-11-13)
- adds codename property to 'addContentType' and 'addContentTypeSnippet' queries, adds 'content_groups' property to 'addContentType' (bec6a8c)
0.2.3 (2019-11-13)
- adds 'isDeveloperMode' client configuration option. If this option is enabled, additional errors are logged in console. (7d64864)
- adds optional data query builder class and uses it for 'publishOrScheduleLanguageVariant' method to allow for skipping data. Fixes #5 (e5cb868)
- adds support for pagination with x-continuation header token, adds ability to set headers in query config, internally refactors the way headers are retrieved, changes debug response type to include strongly typed properties (7efafc0)
- internal - separates query builders from queries (513d058)
- removes the ability to set entire query config to prevent overriding headers (8115e2a)
- sets correct data model for modifying language (fixes #7) (ae740e4)
0.2.2 (2019-11-05)
- adds elements builder for add content type snippet query (74249a9)
- adds elements builder with models for convenient creation of new content types (6b0128e)
- updates kontent-core package which fixes http retry requests (5545f10)
0.2.1 (2019-10-31)
- Fixes modifyLanguage request type (#3) (cc989ce)
- Updates kontent-core package which fixes patch requests incorrectly using put callback (e9faa5d)
- implements 'modifyContentType' endpoint, uses new retry policy & uses standard versioning
- implements 'modifyContentType' endpoint, uses new retry policy & uses standard versioning (75a9e74)