contentful-management 12.0.0-new-beta.3 → 12.0.0-new-beta.4

package/dist/types/plain/entities/concept-scheme.d.ts

@@ -0,0 +1,136 @@
+import type { CursorPaginatedCollectionProp, DeleteConceptSchemeParams, GetConceptSchemeParams, GetManyConceptSchemeParams, GetOrganizationParams, UpdateConceptSchemeParams } from '../../common-types';
+import type { ConceptSchemeProps, CreateConceptSchemeProps } from '../../entities/concept-scheme';
+import type { OpPatch } from 'json-patch';
+import type { SetOptional } from 'type-fest';
+export type ConceptSchemePlainClientAPI = {
+    /**
+     * Create Concept Scheme
+     * @returns the created Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/create-a-concept-scheme}
+     * @example
+     * ```javascript
+     * const concept = await client.conceptScheme.create({
+     *   organizationId: '<organization_id>',
+     * }, conceptSchemeProps);
+     * ```
+     */
+    create(params: SetOptional<GetOrganizationParams, 'organizationId'>, payload: CreateConceptSchemeProps): Promise<ConceptSchemeProps>;
+    /**
+     * Create Concept Scheme With Id
+     * @returns the created Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/create-a-concept-scheme-with-user-defined-id}
+     * @example
+     * ```javascript
+     * const concept = await client.conceptScheme.createWithId({
+     *   organizationId: '<organization_id>',
+     *   conceptSchemeId: '<concept_scheme_id>',
+     * }, conceptSchemeProps);
+     * ```
+     */
+    createWithId(params: SetOptional<GetConceptSchemeParams, 'organizationId'>, payload: CreateConceptSchemeProps): Promise<ConceptSchemeProps>;
+    /**
+     * Update Concept Scheme
+     * @returns the updated Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-scheme}
+     * @deprecated The behavior of this method as a PATCH is being deprecated, and will be replaced with a PUT in the next major version. Use the `patch` method instead.
+     * @example
+     * ```javascript
+     * const updatedConcept = await client.conceptScheme.update({
+     *   organizationId: '<organization_id>',
+     *   conceptSchemeId: '<concept_scheme_id>',
+     *   version: 1,
+     * }, conceptSchemePatch);
+     * ```
+     */
+    update(params: SetOptional<UpdateConceptSchemeParams, 'organizationId'>, payload: OpPatch[]): Promise<ConceptSchemeProps>;
+    /**
+     * Update Concept Scheme with PUT
+     * @returns the updated Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-scheme}
+     * @deprecated In the next major version, this method will be replaced with the standard `update` method which will be updated to use PUT instead of PATCH.
+     * @example
+     * ```javascript
+     * const updatedConcept = await client.conceptScheme.update({
+     *   organizationId: '<organization_id>',
+     *   conceptSchemeId: '<concept_scheme_id>',
+     *   version: 1,
+     * }, CreateConceptSchemeProps);
+     * ```
+     */
+    updatePut(params: SetOptional<UpdateConceptSchemeParams, 'organizationId'>, payload: CreateConceptSchemeProps): Promise<ConceptSchemeProps>;
+    /**
+     * Update Concept Scheme
+     * @returns the updated Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-scheme}
+     * @example
+     * ```javascript
+     * const updatedConcept = await client.conceptScheme.patch({
+     *   organizationId: '<organization_id>',
+     *   conceptSchemeId: '<concept_scheme_id>',
+     *   version: 1,
+     * }, conceptSchemePatch);
+     * ```
+     */
+    patch(params: SetOptional<UpdateConceptSchemeParams, 'organizationId'>, payload: OpPatch[]): Promise<ConceptSchemeProps>;
+    /**
+     * Get Concept Scheme
+     * @returns the Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-scheme}
+     * @example
+     * ```javascript
+     * const concept = await client.conceptScheme.get({
+     *   organizationId: '<organization_id>',
+     *   conceptSchemeId: '<concept_scheme_id>',
+     * });
+     * ```
+     */
+    get(params: SetOptional<GetConceptSchemeParams, 'organizationId'>): Promise<ConceptSchemeProps>;
+    /**
+     * Get many Concept Schemes
+     * @returns list of many Concept Schemes
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-scheme-collection}
+     * @example
+     * ```javascript
+     * const concepts = await client.conceptScheme.getMany({
+     *   organizationId: '<organization_id>',
+     * });
+     * ```
+     */
+    getMany(params: SetOptional<GetManyConceptSchemeParams, 'organizationId'>): Promise<CursorPaginatedCollectionProp<ConceptSchemeProps>>;
+    /**
+     * Get number of total Concept Scheme
+     * @returns number of total Concept Scheme
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/total-concept-schemes}
+     * @example
+     * ```javascript
+     * const {total} = await client.conceptScheme.getTotal({
+     *   organizationId: '<organization_id>',
+     * });
+     * ```
+     */
+    getTotal(params: SetOptional<GetOrganizationParams, 'organizationId'>): Promise<{
+        total: number;
+    }>;
+    /**
+     * Delete Concept Scheme
+     * @returns nothing
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-scheme}
+     * @example
+     * ```javascript
+     * await client.conceptScheme.update({
+     *   organizationId: '<organization_id>',
+     *   conceptSchemeId: '<concept_scheme_id>',
+     * });
+     * ```
+     */
+    delete(params: SetOptional<DeleteConceptSchemeParams, 'organizationId'>): Promise<void>;
+};

package/dist/types/plain/entities/concept.d.ts

@@ -0,0 +1,164 @@
+import type { CursorPaginatedCollectionProp, DeleteConceptParams, GetConceptDescendantsParams, GetConceptParams, GetManyConceptParams, GetOrganizationParams, UpdateConceptParams } from '../../common-types';
+import type { ConceptProps, CreateConceptProps } from '../../entities/concept';
+import type { OpPatch } from 'json-patch';
+import type { SetOptional } from 'type-fest';
+export type ConceptPlainClientAPI = {
+    /**
+     * Create Concept
+     * @returns ConceptProps
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/create-a-concept}
+     * @example
+     * ```javascript
+     * const concept = await client.concept.create({
+     *   organizationId: '<organization_id>',
+     * }, conceptProps);
+     * ```
+     */
+    create(params: SetOptional<GetOrganizationParams, 'organizationId'>, payload: CreateConceptProps): Promise<ConceptProps>;
+    /**
+     * Create Concept With Id
+     * @returns ConceptProps
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/create-a-concept-with-user-defined-id}
+     * @example
+     * ```javascript
+     * const concept = await client.concept.createWithId({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     * }, conceptProps);
+     * ```
+     */
+    createWithId(params: SetOptional<GetConceptParams, 'organizationId'>, payload: CreateConceptProps): Promise<ConceptProps>;
+    /**
+     * Update Concept
+     * @returns the updated Concept
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept}
+     * @deprecated The behavior of this method as a PATCH is being deprecated, and will be replaced with a PUT in the next major version. Use the `patch` method instead.
+     * @example
+     * ```javascript
+     * const updatedConcept = await client.concept.update({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     *   version: 1,
+     * }, patch);
+     * ```
+     */
+    update(params: SetOptional<UpdateConceptParams, 'organizationId'>, payload: OpPatch[]): Promise<ConceptProps>;
+    /**
+     * Update Concept with PUT
+     * @returns the updated Concept
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept}
+     * @deprecated In the next major version, this method will be replaced with the standard `update` method which will be updated to use PUT instead of PATCH.
+     * @example
+     * ```javascript
+     * const updatedConcept = await client.concept.updatePut({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     *   version: 1,
+     * }, patch);
+     * ```
+     */
+    updatePut(params: SetOptional<UpdateConceptParams, 'organizationId'>, payload: CreateConceptProps): Promise<ConceptProps>;
+    /**
+     * Update Concept
+     * @returns the updated Concept
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept}
+     * @example
+     * ```javascript
+     * const updatedConcept = await client.concept.patch({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     *   version: 1,
+     * }, patch);
+     * ```
+     */
+    patch(params: SetOptional<UpdateConceptParams, 'organizationId'>, payload: OpPatch[]): Promise<ConceptProps>;
+    /**
+     * Get Concept
+     * @returns the Concept
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept}
+     * @example
+     * ```javascript
+     * const concept = await client.concept.get({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     * });
+     * ```
+     */
+    get(params: SetOptional<GetConceptParams, 'organizationId'>): Promise<ConceptProps>;
+    /**
+     * Delete Concept
+     * @returns nothing
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept}
+     * @example
+     * ```javascript
+     * await client.concept.delete({
+     *   conceptId: '<concept_id>',
+     *   version: 1,
+     * });
+     * ```
+     */
+    delete(params: SetOptional<DeleteConceptParams, 'organizationId'>): Promise<void>;
+    /**
+     * Get many Concepts
+     * @returns list of many Concepts
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/concept-collection}
+     * @example
+     * ```javascript
+     * const concepts = await client.concept.getMany({
+     *   organizationId: '<organization_id>',
+     * });
+     * ```
+     */
+    getMany(params: SetOptional<GetManyConceptParams, 'organizationId'>): Promise<CursorPaginatedCollectionProp<ConceptProps>>;
+    /**
+     * Get number of total Concept
+     * @returns number of total Concept
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/total-concepts}
+     * @example
+     * ```javascript
+     * const {total} = await client.concept.getTotal({
+     *   organizationId: '<organization_id>',
+     * });
+     * ```
+     */
+    getTotal(params: SetOptional<GetOrganizationParams, 'organizationId'>): Promise<{
+        total: number;
+    }>;
+    /**
+     * Get descendant Concepts
+     * @returns list of Concepts
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/descendants}
+     * @example
+     * ```javascript
+     * const concepts = await client.concept.getDescendants({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     * });
+     * ```
+     */
+    getDescendants(params: SetOptional<GetConceptDescendantsParams, 'organizationId'>): Promise<CursorPaginatedCollectionProp<ConceptProps>>;
+    /**
+     * Get ancestor Concepts
+     * @returns list of ancestor Concepts
+     * @throws if the request fails
+     * @see {@link https://www.contentful.com/developers/docs/references/content-management-api/#/reference/taxonomy/ancestors}
+     * @example
+     * ```javascript
+     * const concepts = await client.concept.getAncestors({
+     *   organizationId: '<organization_id>',
+     *   conceptId: '<concept_id>',
+     * });
+     * ```
+     */
+    getAncestors(params: SetOptional<GetConceptDescendantsParams, 'organizationId'>): Promise<CursorPaginatedCollectionProp<ConceptProps>>;
+};

package/dist/types/plain/entities/editor-interface.d.ts

@@ -0,0 +1,67 @@
+import type { RawAxiosRequestHeaders } from 'axios';
+import type { CollectionProp, GetEditorInterfaceParams, GetSpaceEnvironmentParams, QueryParams } from '../../common-types';
+import type { EditorInterfaceProps } from '../../entities/editor-interface';
+import type { OptionalDefaults } from '../wrappers/wrap';
+export type EditorInterfacePlainClientAPI = {
+    /**
+     * Fetch an Editor Interface
+     * @param params entity IDs to identify the Editor Interface
+     * @returns the Editor Interface config
+     * @throws if the request fails, or the Editor Interface is not found
+     * @example
+     * ```javascript
+     * const editorInterface = await client.editorInterface.get({
+     *   spaceId: "<space_id>",
+     *   environmentId: "<environment_id>",
+     *   contentTypeId: "<content_type_id>",
+     * });
+     * ```
+     */
+    get(params: OptionalDefaults<GetEditorInterfaceParams>): Promise<EditorInterfaceProps>;
+    /**
+     * Fetch all Editor Interfaces for the given Space and Environment
+     * @param params entity IDs to identify the Environment from which to fetch Editor Interfaces
+     * @returns an object containing an array of Editor Interfaces
+     * @throws if the request fails, or the Space/Environment is not found
+     * @example
+     * ```javascript
+     * const results = await client.editorInterface.getMany({
+     *   spaceId: "<space_id>",
+     *   environmentId: "<environment_id>"
+     * });
+     * ```
+     */
+    getMany(params: OptionalDefaults<GetSpaceEnvironmentParams & QueryParams>): Promise<CollectionProp<EditorInterfaceProps>>;
+    /**
+     * Update an Editor Interface
+     * @param params entity IDs to identify the Editor Interface
+     * @param rawData the updated Editor Interface config
+     * @returns the updated Editor Interface config
+     * @throws if the request fails, the Editor Interface is not found, or the update payload is malformed
+     * @example
+     * ```javascript
+     * const updatedEditorInterface =
+     *   await client.editorInterface.update(
+     *     {
+     *       spaceId: "<space_id>",
+     *       environmentId: "<environment_id>",
+     *       contentTypeId: "<content_type_id>",
+     *     },
+     *     {
+     *       ...currentEditorInterface,
+     *       sidebar: [
+     *         ...(currentEditorInterface.sidebar ?? []),
+     *         {
+     *           widgetId: "translation-widget",
+     *           widgetNamespace: "sidebar-builtin",
+     *           settings: {
+     *             defaultLocale: "en-US",
+     *           },
+     *         },
+     *       ],
+     *     }
+     *   );
+     * ```
+     */
+    update(params: OptionalDefaults<GetEditorInterfaceParams>, rawData: EditorInterfaceProps, headers?: RawAxiosRequestHeaders): Promise<EditorInterfaceProps>;
+};

package/dist/types/plain/entities/environment-alias.d.ts

@@ -0,0 +1,99 @@
+import type { RawAxiosRequestHeaders } from 'axios';
+import type { CollectionProp, GetSpaceEnvAliasParams, GetSpaceParams, PaginationQueryParams } from '../../common-types';
+import type { CreateEnvironmentAliasProps, EnvironmentAliasProps } from '../../entities/environment-alias';
+import type { OptionalDefaults } from '../wrappers/wrap';
+export type EnvironmentAliasPlainClientAPI = {
+    /**
+     * Fetch an environment alias
+     * @param params a space and environment alias id
+     * @returns the environment alias\
+     * @throws if the environment alias does not exist
+     * @example
+     * ```javascript
+     * const environmentAlias = await client.environmentAlias.get({
+     *   spaceId: '<space_id>',
+     *   environmentAliasId: '<environment_alias_id>'
+     * })
+     * ```
+     */
+    get(params: OptionalDefaults<GetSpaceEnvAliasParams>): Promise<EnvironmentAliasProps>;
+    /**
+     * Fetch all environment aliases in a space
+     * @param params a space Id and optional pagination parameters
+     * @returns a collection of environment aliases
+     * @throws if the space does not exist
+     * @example
+     * ```javascript
+     * const environmentAliases = await client.environmentAlias.getMany({
+     *   spaceId: '<space_id>'
+     * })
+     * ```
+     */
+    getMany(params: OptionalDefaults<GetSpaceParams & PaginationQueryParams>): Promise<CollectionProp<EnvironmentAliasProps>>;
+    /**
+     * Create an environment alias
+     * @param params a space ID to create the environment alias in
+     * @param rawData the environment alias metadata
+     * @param headers optional custom headers
+     * @returns the created environment alias
+     * @throws if the space does not exist, or `rawData` is invalid
+     * @example
+     * ```javascript
+     * const environmentAlias = await client.environmentAlias.createWithId(
+     *   {
+     *     spaceId: '<space_id>',
+     *     environmentAliasId: '<environment_alias_id>',
+     *   },
+     *   {
+     *     environment: {
+     *       sys: {
+     *         type: 'Link',
+     *         linkType: 'Environment',
+     *         id: '<environment_id>',
+     *       },
+     *     },
+     *   }
+     * );
+     * ```
+     */
+    createWithId(params: OptionalDefaults<GetSpaceEnvAliasParams>, rawData: CreateEnvironmentAliasProps, headers?: RawAxiosRequestHeaders): Promise<EnvironmentAliasProps>;
+    /**
+     * Update an environment alias
+     * @param params a space and environment alias id
+     * @param rawData the updated environment alias metadata
+     * @param headers optional custom headers
+     * @returns the updated environment alias
+     * @throws if the environment alias does not exist, or `rawData` is invalid
+     * @example
+     * ```javascript
+     * const environmentAlias = await client.environmentAlias.update(
+     *   {
+     *      spaceId: '<space_id>',
+     *      environmentAliasId: '<environment_alias_id>',
+     *   },
+     *   {
+     *     environment: {
+     *     sys: {
+     *       type: 'Link',
+     *       linkType: 'Environment',
+     *       id: '<environment_id>',
+     *     },
+     *   }
+     * );
+     */
+    update(params: OptionalDefaults<GetSpaceEnvAliasParams>, rawData: EnvironmentAliasProps, headers?: RawAxiosRequestHeaders): Promise<EnvironmentAliasProps>;
+    /**
+     * Delete an environment alias
+     * @param params a space and environment alias id
+     * @returns an empty object
+     * @throws if the environment alias does not exist
+     * @example
+     * ```javascript
+     * await client.environmentAlias.delete({
+     *   spaceId: '<space_id>',
+     *   environmentAliasId: '<environment_alias_id>',
+     * })
+     * ```
+     */
+    delete(params: OptionalDefaults<GetSpaceEnvAliasParams>): Promise<any>;
+};

package/dist/types/plain/entities/environment.d.ts

@@ -0,0 +1,116 @@
+import type { RawAxiosRequestHeaders } from 'axios';
+import type { CollectionProp, GetSpaceEnvironmentParams, GetSpaceParams, PaginationQueryParams } from '../../common-types';
+import type { CreateEnvironmentProps, EnvironmentProps } from '../../entities/environment';
+import type { OptionalDefaults } from '../wrappers/wrap';
+export type EnvironmentPlainClientAPI = {
+    /**
+     * Fetch an environment
+     * @param params a space and environment id
+     * @returns the environment
+     * @throws if the environment does not exist
+     * @example
+     * ```javascript
+     * const environment = await client.environment.get({
+     *   spaceId: '<space_id>',
+     *   environmentId: '<environment_id>'
+     * })
+     * ```
+     */
+    get(params: OptionalDefaults<GetSpaceEnvironmentParams>): Promise<EnvironmentProps>;
+    /**
+     * Fetch all environments in a space
+     * @param params a space Id and optional pagination parameters
+     * @returns a collection of environments
+     * @throws if the space does not exist
+     * @example
+     * ```javascript
+     * const environments = await client.environment.getMany({
+     *   spaceId: '<space_id>'
+     * })
+     * ```
+     */
+    getMany(params: OptionalDefaults<GetSpaceParams & PaginationQueryParams>): Promise<CollectionProp<EnvironmentProps>>;
+    /**
+     * Create an environment
+     * @param params a space ID to create the environment in
+     * @param rawData the environment metadata
+     * @param headers optional custom headers
+     * @returns the created environment
+     * @throws if the space does not exist, or `rawData` is invalid
+     * @example
+     * ```javascript
+     * const environment = await client.environment.create(
+     *   {
+     *     spaceId: '<space_id>'
+     *   },
+     *   {
+     *      name: 'new-env'
+     *   }
+     * )
+     * ```
+     */
+    create(params: OptionalDefaults<GetSpaceParams>, rawData: Partial<Pick<EnvironmentProps, 'name'>>, headers?: RawAxiosRequestHeaders): Promise<EnvironmentProps>;
+    /**
+     * Create an environment with a specific ID
+     * @param params a space ID to create the environment in
+     * @param rawData the environment metadata
+     * @param headers optional custom headers
+     * @returns the created environment
+     * @throws if the space does not exist, or `rawData` is invalid
+     * @example
+     * ```javascript
+     * const environment = await client.environment.createWithId(
+     *   {
+     *     spaceId: '<space_id>',
+     *     environmentId: '<environment_id>'
+     *   },
+     *   {
+     *      name: 'new-env'
+     *   }
+     * )
+     * ```
+     */
+    createWithId(params: OptionalDefaults<GetSpaceEnvironmentParams & {
+        sourceEnvironmentId?: string;
+    }>, rawData: CreateEnvironmentProps, headers?: RawAxiosRequestHeaders): Promise<EnvironmentProps>;
+    /**
+     * Update an environment
+     * @param params a space and environment id
+     * @param rawData the environment metadata
+     * @param headers optional custom headers
+     * @returns the updated environment
+     * @throws if the environment does not exist, or `rawData` is invalid
+     * @example
+     * ```javascript
+     * let environment = await client.environment.get({
+     *   spaceId: '<space_id>',
+     *   environmentId: '<environment_id>'
+     * })
+     *
+     * environment = await client.environment.update(
+     *   {
+     *     spaceId: '<space_id>',
+     *     environmentId: '<environment_id>'
+     *   },
+     *   {
+     *      name: 'updated-env'
+     *   }
+     * )
+     * ```
+     */
+    update(params: OptionalDefaults<GetSpaceEnvironmentParams>, rawData: EnvironmentProps, headers?: RawAxiosRequestHeaders): Promise<EnvironmentProps>;
+    /**
+     * Delete an environment
+     * @param params a space and environment id
+     * @returns an empty object
+     * @throws if the environment does not exist
+     * @example
+     * ```javascript
+     * await client.environment.delete({
+     *   spaceId: '<space_id>',
+     *   environmentId: '<environment_id>'
+     * })
+     * ```
+     */
+    delete(params: OptionalDefaults<GetSpaceEnvironmentParams>): Promise<any>;
+};