contentful-management 11.60.3 → 12.0.0-beta.10

package/dist/typings/create-ui-config-api.d.ts

@@ -1,34 +0,0 @@
-import type { MakeRequest } from './common-types';
-/**
- * @private
- */
-export type ContentfulUIConfigApi = ReturnType<typeof createUIConfigApi>;
-/**
- * @private
- */
-export default function createUIConfigApi(makeRequest: MakeRequest): {
-    /**
-     * Sends an update to the server with any changes made to the object's properties
-     * @return Object returned from the server with updated changes.
-     * @example ```javascript
-     * const contentful = require('contentful-management')
-     *
-     * const client = contentful.createClient({
-     *   accessToken: '<content_management_api_key>'
-     * })
-     *
-     * client.getSpace('<space_id>')
-     * .then((space) => space.getEnvironment('<environment_id>'))
-     * .then((environment) => environment.getUIConfig())
-     * .then((uiConfig) => {
-     *   uiConfig.entryListViews = [...]
-     *   return uiConfig.update()
-     * })
-     * .then((uiConfig) => console.log(`UIConfig updated.`))
-     * .catch(console.error)
-     * ```
-     */
-    update: () => Promise<any & import("./entities/ui-config").UIConfigProps & {
-        toPlainObject(): import("./entities/ui-config").UIConfigProps;
-    }>;
-};

package/dist/typings/create-user-ui-config-api.d.ts

@@ -1,34 +0,0 @@
-import type { MakeRequest } from './common-types';
-/**
- * @private
- */
-export type ContentfulUIConfigApi = ReturnType<typeof createUserUIConfigApi>;
-/**
- * @private
- */
-export default function createUserUIConfigApi(makeRequest: MakeRequest): {
-    /**
-     * Sends an update to the server with any changes made to the object's properties
-     * @return Object returned from the server with updated changes.
-     * @example ```javascript
-     * const contentful = require('contentful-management')
-     *
-     * const client = contentful.createClient({
-     *   accessToken: '<content_management_api_key>'
-     * })
-     *
-     * client.getSpace('<space_id>')
-     * .then((space) => space.getEnvironment('<environment_id>'))
-     * .then((environment) => environment.getUserUIConfig())
-     * .then((uiConfig) => {
-     *   uiConfig.entryListViews = [...]
-     *   return uiConfig.update()
-     * })
-     * .then((uiConfig) => console.log(`UserUIConfig updated.`))
-     * .catch(console.error)
-     * ```
-     */
-    update: () => Promise<any & import("./entities/user-ui-config").UserUIConfigProps & {
-        toPlainObject(): import("./entities/user-ui-config").UserUIConfigProps;
-    }>;
-};

package/dist/typings/entities/access-token.d.ts

@@ -1,61 +0,0 @@
-import type { DefaultElements, MakeRequest, BasicMetaSysProps, SysLink } from '../common-types';
-type Application = {
-    id?: string;
-    name?: string;
-    sys: SysLink;
-};
-type AccessTokenSysProps = BasicMetaSysProps & {
-    application: Application | null;
-    expiresAt: string | null;
-    lastUsedAt: string | null;
-    redactedValue: string;
-};
-export type AccessTokenProps = {
-    sys: AccessTokenSysProps;
-    name: string;
-    scopes: 'content_management_manage'[];
-    revokedAt: null | string;
-    token?: string;
-};
-/**
- * @deprecated Use `AccessTokenProps` instead.
- */
-export type AccessTokenProp = AccessTokenProps;
-export type CreatePersonalAccessTokenProps = Pick<AccessToken, 'name' | 'scopes'> & {
-    expiresIn: number;
-};
-export interface AccessToken extends AccessTokenProps, DefaultElements<AccessTokenProps> {
-    /**
-     * Revokes access token
-     * @return Object the revoked access token
-     * @example ```javascript
-     * const contentful = require('contentful-management')
-     *
-     * const client = contentful.createClient({
-     *  accessToken: <content_management_api_key>
-     * })
-     *
-     * client.getAccessToken('<token-id>')
-     *  .then((AccessToken) => {
-     *    return accessToken.revoke()
-     *  })
-     *  .catch(console.error)
-     * ```
-     */
-    revoke(): Promise<AccessToken>;
-}
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw  access token data
- * @return Wrapped access token
- */
-export declare function wrapAccessToken(makeRequest: MakeRequest, data: AccessTokenProps): AccessToken;
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw access collection data
- * @return Wrapped access token collection data
- */
-export declare const wrapAccessTokenCollection: (makeRequest: MakeRequest, data: import("../common-types").CollectionProp<AccessTokenProps>) => import("../common-types").Collection<AccessToken, AccessTokenProps>;
-export {};

package/dist/typings/entities/ai-action-invocation.d.ts

@@ -1,82 +0,0 @@
-import type { DefaultElements, MakeRequest, SysLink } from '../common-types';
-import type { Document as RichTextDocument } from '@contentful/rich-text-types';
-export type InvocationStatus = 'SCHEDULED' | 'IN_PROGRESS' | 'FAILED' | 'COMPLETED' | 'CANCELLED';
-export type InvocationResultType = 'text';
-export declare const AiActionOutputFormat: {
-    readonly RichText: "RichText";
-    readonly Markdown: "Markdown";
-    readonly PlainText: "PlainText";
-};
-export type AiActionOutputFormatType = (typeof AiActionOutputFormat)[keyof typeof AiActionOutputFormat];
-export type AiActionInvocationMetadata = {
-    invocationResult?: {
-        modelProvider?: string;
-        modelId?: string;
-        wordCount?: number;
-        outputFormat?: AiActionOutputFormatType;
-    };
-    statusChangedDates?: {
-        status: InvocationStatus;
-        date: string;
-    }[];
-};
-export interface InvocationResult {
-    content: string | RichTextDocument;
-    type: InvocationResultType;
-    metadata: AiActionInvocationMetadata;
-}
-export type AiActionInvocationProps = {
-    sys: {
-        id: string;
-        type: 'AiActionInvocation';
-        space: SysLink;
-        environment: SysLink;
-        aiAction: SysLink;
-        status: InvocationStatus;
-        errorCode?: string;
-    };
-    result?: InvocationResult;
-};
-export type AiActionInvocationType = {
-    outputFormat: 'RichText' | 'Markdown' | 'PlainText';
-    variables?: Array<{
-        value: string;
-        id: string;
-    } | {
-        value: {
-            entityPath: string;
-            entityType: 'Entry' | 'Asset' | 'ResourceLink';
-            entityId: string;
-        };
-        id: string;
-    } | {
-        value: {
-            entityPaths: Array<string>;
-            entityType: 'Entry';
-            entityId: string;
-        };
-        id: string;
-    }>;
-};
-/**
- * The AI Action Invocation entity.
- * This entity is read-only and primarily used to inspect the result of an AI action invocation.
- */
-export interface AiActionInvocation extends AiActionInvocationProps, DefaultElements<AiActionInvocationProps> {
-}
-/**
- * Wraps raw AI Action Invocation data with SDK helper methods.
- *
- * @param makeRequest - Function to make API requests.
- * @param data - Raw AI Action Invocation data.
- * @returns The AI Action Invocation entity.
- */
-export declare function wrapAiActionInvocation(makeRequest: MakeRequest, data: AiActionInvocationProps): AiActionInvocation;
-/**
- * Wraps a collection of raw AI Action Invocation data.
- *
- * @param makeRequest - Function to make API requests.
- * @param data - Raw collection data.
- * @returns A collection of AI Action Invocation entities.
- */
-export declare const wrapAiActionInvocationCollection: (makeRequest: MakeRequest, data: import("../common-types").CollectionProp<AiActionInvocationProps>) => import("../common-types").Collection<AiActionInvocation, AiActionInvocationProps>;

package/dist/typings/entities/ai-action.d.ts

@@ -1,75 +0,0 @@
-import type { DefaultElements, Link, MakeRequest, MetaSysProps } from '../common-types';
-import { type AiActionInvocationType, type AiActionInvocation } from './ai-action-invocation';
-export type VariableType = 'ResourceLink' | 'Text' | 'StandardInput' | 'Locale' | 'MediaReference' | 'Reference' | 'SmartContext';
-export type ReferenceVariableConfiguration = {
-    allowedEntities: Array<'Entry'>;
-};
-export type VariableConfiguration = {
-    strict: boolean;
-    in: Array<string>;
-} | ReferenceVariableConfiguration;
-export type Variable = {
-    configuration?: VariableConfiguration;
-    description?: string;
-    name?: string;
-    type: VariableType;
-    id: string;
-};
-export type Instruction = {
-    variables: Array<Variable>;
-    template: string;
-};
-export type Configuration = {
-    modelType: string;
-    modelTemperature: number;
-};
-export type AiActionTestCase = {
-    type?: 'Text';
-    value?: string;
-} | {
-    type?: 'Reference';
-    value?: {
-        entityPath?: string;
-        entityType?: 'Entry';
-        entityId?: string;
-    };
-};
-export interface AiActionQueryOptions {
-    limit?: number;
-    skip?: number;
-    status?: 'all' | 'published';
-}
-export type AiActionProps = {
-    sys: MetaSysProps & {
-        type: 'AiAction';
-        space: {
-            sys: {
-                id: string;
-            };
-        };
-        publishedBy?: Link<'User'> | Link<'AppDefinition'>;
-        updatedBy: Link<'User'> | Link<'AppDefinition'>;
-        createdBy: Link<'User'> | Link<'AppDefinition'>;
-        publishedVersion?: number;
-        version: number;
-        publishedAt?: string;
-        updatedAt: string;
-        createdAt: string;
-        id: string;
-    };
-    name: string;
-    description: string;
-    configuration: Configuration;
-    instruction: Instruction;
-    testCases?: Array<AiActionTestCase>;
-};
-export type CreateAiActionProps = Pick<Omit<AiActionProps, 'sys'>, 'name' | 'description' | 'configuration' | 'instruction' | 'testCases'>;
-export interface AiAction extends AiActionProps, DefaultElements<AiActionProps> {
-    update(): Promise<AiAction>;
-    delete(): Promise<void>;
-    publish(): Promise<AiAction>;
-    unpublish(): Promise<AiAction>;
-    invoke(environmentId: string, payload: AiActionInvocationType): Promise<AiActionInvocation>;
-}
-export declare function wrapAiAction(makeRequest: MakeRequest, data: AiActionProps): AiAction;
-export declare const wrapAiActionCollection: (makeRequest: MakeRequest, data: import("../common-types").CollectionProp<AiActionProps>) => import("../common-types").Collection<AiAction, AiActionProps>;

package/dist/typings/entities/api-key.d.ts

@@ -1,70 +0,0 @@
-import type { DefaultElements, MakeRequest, MetaLinkProps, MetaSysProps } from '../common-types';
-export type ApiKeyProps = {
-    sys: MetaSysProps;
-    name: string;
-    accessToken: string;
-    environments: {
-        sys: MetaLinkProps;
-    }[];
-    preview_api_key: {
-        sys: MetaLinkProps;
-    };
-    description?: string;
-    policies?: {
-        effect: string;
-        action: string;
-    }[];
-};
-export type CreateApiKeyProps = Pick<ApiKeyProps, 'name' | 'environments' | 'description'>;
-export interface ApiKey extends ApiKeyProps, DefaultElements<ApiKeyProps> {
-    /**
-     * Deletes this object on the server.
-     * @return Promise for the deletion. It contains no data, but the Promise error case should be handled.
-     * @example ```javascript
-     * const contentful = require('contentful-management')
-     *
-     * const client = contentful.createClient({
-     *   accessToken: '<content_management_api_key>'
-     * })
-     * client.getSpace('<space_id>')
-     * .then((space) => space.getApiKey(<api-key-id>))
-     * .then((apiKey) => apiKey.delete())
-     * .then(() => console.log('apikey deleted'))
-     * .catch(console.error)
-     * ```
-     */
-    delete(): Promise<void>;
-    /**
-     * Sends an update to the server with any changes made to the object's properties
-     * @return Object returned from the server with updated changes.
-     * @example ```javascript
-     * const contentful = require('contentful-management')
-     *
-     * const client = contentful.createClient({
-     *   accessToken: '<content_management_api_key>'
-     * })
-     * client.getSpace('<space_id>')
-     * .then((space) => space.getApiKey(<api-key-id>))
-     * .then((apiKey) => {
-     *  apiKey.name = 'New name'
-     *  return apiKey.update()
-     * })
-     * .then(apiKey => console.log(apiKey.name))
-     * .catch(console.error)
-     * ```
-     */
-    update(): Promise<ApiKey>;
-}
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw api key data
- */
-export declare function wrapApiKey(makeRequest: MakeRequest, data: ApiKeyProps): ApiKey;
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw api key collection data
- * @return Wrapped api key collection data
- */
-export declare const wrapApiKeyCollection: (makeRequest: MakeRequest, data: import("../common-types").CollectionProp<ApiKeyProps>) => import("../common-types").Collection<ApiKey, ApiKeyProps>;

package/dist/typings/entities/app-access-token.d.ts

@@ -1,34 +0,0 @@
-import type { Except } from 'type-fest';
-import type { BasicMetaSysProps, DefaultElements, MakeRequest, SysLink } from '../common-types';
-type AppAccessTokenSys = Except<BasicMetaSysProps, 'version' | 'id'> & {
-    space: SysLink;
-    environment: SysLink;
-    appDefinition: SysLink;
-    expiresAt: string;
-};
-export type AppAccessTokenProps = {
-    /**
-     * System metadata
-     */
-    sys: AppAccessTokenSys;
-    /**
-     * Token for an app installation in a space environment
-     */
-    token: string;
-};
-export type CreateAppAccessTokenProps = {
-    /**
-     * JSON Web Token
-     */
-    jwt: string;
-};
-export interface AppAccessToken extends AppAccessTokenProps, DefaultElements<AppAccessTokenProps> {
-}
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw app access token data
- * @return {AppAccessToken} Wrapped AppAccessToken data
- */
-export declare function wrapAppAccessToken(_makeRequest: MakeRequest, data: AppAccessTokenProps): AppAccessToken;
-export {};

package/dist/typings/entities/app-action-call.d.ts

@@ -1,92 +0,0 @@
-import type { Except, JsonValue } from 'type-fest';
-import type { BasicMetaSysProps, AppActionCallRetryOptions, DefaultElements, MakeRequest, SysLink, CreateWithResponseParams, CreateWithResultParams, GetAppActionCallDetailsParams, GetAppActionCallParamsWithId } from '../common-types';
-import type { WebhookCallDetailsProps } from './webhook';
-type AppActionCallSys = Except<BasicMetaSysProps, 'version'> & {
-    appDefinition: SysLink;
-    space: SysLink;
-    environment: SysLink;
-    action: SysLink;
-    appActionCallResponse?: SysLink;
-} & (AppActionCallSucceeded | AppActionCallProcessing | AppActionCallFailed);
-type RetryOptions = AppActionCallRetryOptions;
-export type AppActionCallStatus = 'processing' | 'succeeded' | 'failed';
-export interface AppActionCallErrorProps {
-    sys: {
-        type: 'Error';
-        id: string;
-    };
-    message: string;
-    details?: Record<string, unknown>;
-    statusCode?: number;
-}
-export type AppActionCallSucceeded = {
-    status: 'succeeded';
-    result: JsonValue;
-};
-export type AppActionCallProcessing = {
-    status: 'processing';
-};
-export type AppActionCallFailed = {
-    status: 'failed';
-    error: AppActionCallErrorProps;
-};
-export type AppActionCallProps = {
-    /**
-     * System metadata
-     */
-    sys: AppActionCallSys;
-};
-export type CreateAppActionCallProps = {
-    /** The body for the call */
-    parameters: {
-        [key: string]: unknown;
-    };
-};
-type AppActionCallApi = {
-    createWithResponse(params: CreateWithResponseParams, payload: CreateAppActionCallProps): Promise<AppActionCallResponse>;
-    getCallDetails(params: GetAppActionCallDetailsParams): Promise<AppActionCallResponse>;
-    get(params: GetAppActionCallParamsWithId): Promise<AppActionCallProps>;
-    createWithResult(params: CreateWithResultParams, payload: CreateAppActionCallProps): Promise<AppActionCallProps>;
-};
-export type AppActionCallResponse = WebhookCallDetailsProps;
-export interface AppActionCallRawResponseProps {
-    sys: {
-        id: string;
-        type: 'AppActionCallResponse';
-        space: SysLink;
-        environment: SysLink;
-        appInstallation: SysLink;
-        appAction: SysLink;
-        createdAt: string;
-        createdBy: SysLink;
-    };
-    response: {
-        headers?: {
-            contentType?: string;
-        };
-        statusCode?: number;
-        body: string;
-    };
-}
-export interface AppActionCallResponseData extends AppActionCallResponse, DefaultElements<AppActionCallResponse>, AppActionCallApi {
-}
-export type AppActionCall = AppActionCallProps & DefaultElements<AppActionCallProps>;
-/**
- * @private
- */
-export default function createAppActionCallApi(makeRequest: MakeRequest, retryOptions?: RetryOptions): AppActionCallApi;
-/**
- * @private
- * @param http - HTTP client instance
- * @param data - Raw AppActionCall data
- * @return Wrapped AppActionCall data
- */
-export declare function wrapAppActionCall(makeRequest: MakeRequest, data: AppActionCallProps): AppActionCall;
-/**
- * @private
- * @param http - HTTP client instance
- * @param data - Raw AppActionCall data
- * @return Wrapped AppActionCall data
- */
-export declare function wrapAppActionCallResponse(makeRequest: MakeRequest, data: AppActionCallResponse, retryOptions?: RetryOptions): AppActionCallResponseData;
-export {};

package/dist/typings/entities/app-action.d.ts

@@ -1,161 +0,0 @@
-import type { Except } from 'type-fest';
-import type { BasicMetaSysProps, DefaultElements, Link, MakeRequest, SysLink } from '../common-types';
-import type { ParameterDefinition } from './widget-parameters';
-type AppActionSys = Except<BasicMetaSysProps, 'version'> & {
-    appDefinition: SysLink;
-    organization: SysLink;
-};
-export type AppActionParameterDefinition = Omit<ParameterDefinition, 'labels'>;
-export type AppActionCategoryProps = {
-    sys: {
-        id: AppActionCategoryType;
-        type: 'AppActionCategory';
-        version: string;
-    };
-    name: string;
-    description: string;
-    parameters?: AppActionParameterDefinition[];
-};
-type BuiltInCategoriesProps = {
-    /**
-     * Category identifying the shape of the action.
-     */
-    category: 'Entries.v1.0' | 'Notification.v1.0';
-};
-type CustomAppActionProps = {
-    /**
-     * "Custom" category requires "parameters"
-     */
-    category: 'Custom';
-    parameters: AppActionParameterDefinition[];
-};
-type AppActionCategory = BuiltInCategoriesProps | CustomAppActionProps;
-export type AppActionCategoryType = AppActionCategory['category'];
-/**
- * 'function' is deprecated, use 'function-invocation' instead
- */
-export type AppActionType = 'endpoint' | 'function' | 'function-invocation';
-type BaseAppActionProps = AppActionCategory & {
-    /**
-     * System metadata
-     */
-    sys: AppActionSys;
-    /**
-     * Human readable name for the action
-     */
-    name: string;
-    /**
-     * Human readable description of the action
-     */
-    description?: string;
-    /**
-     * Optional JSON Schema describing the request payload shape
-     */
-    parametersSchema?: Record<string, unknown>;
-    /**
-     * Optional JSON Schema describing the result shape
-     */
-    resultSchema?: Record<string, unknown>;
-};
-type CreateEndpointAppActionProps = {
-    /**
-     * Type of the action, defaults to endpoint if not provided
-     * endpoint: action is sent to specified URL
-     */
-    type?: 'endpoint';
-    /**
-     * Url that will be called when the action is invoked
-     */
-    url: string;
-};
-type EndpointAppActionProps = {
-    /**
-     * Type of the action
-     * endpoint: action is sent to specified URL
-     */
-    type: 'endpoint';
-    /**
-     * Url that will be called when the action is invoked
-     */
-    url: string;
-};
-type CreateFunctionAppActionProps = {
-    /**
-     * Type of the action
-     * function-invocation: action invokes a contentful function
-     */
-    type: 'function-invocation';
-    /**
-     * Link to a Function
-     */
-    function: Link<'Function'>;
-    /**
-     * ID of the action
-     */
-    id?: string;
-};
-type FunctionAppActionProps = {
-    /**
-     * Type of the action
-     * function-invocation: action invokes a contentful function
-     */
-    type: 'function-invocation';
-    /**
-     * Link to a Function
-     */
-    function: Link<'Function'>;
-};
-/**
- * @deprecated Use FunctionAppActionProps instead
- */
-type LegacyFunctionAppActionProps = Record<string, unknown> & {
-    type: 'function';
-};
-export type CreateAppActionProps = AppActionCategory & {
-    name: string;
-    description?: string;
-    /**
-     * Optional JSON Schema describing the request payload shape
-     */
-    parametersSchema?: Record<string, unknown>;
-    /**
-     * Optional JSON Schema describing the result shape
-     */
-    resultSchema?: Record<string, unknown>;
-} & (CreateEndpointAppActionProps | CreateFunctionAppActionProps | LegacyFunctionAppActionProps);
-export type AppActionProps = BaseAppActionProps & (EndpointAppActionProps | FunctionAppActionProps | LegacyFunctionAppActionProps);
-export type AppAction = AppActionProps & DefaultElements<AppActionProps> & {
-    /**
-     * Deletes this object on the server.
-     * @return Promise for the deletion. It contains no data, but the Promise error case should be handled.
-     * @example ```javascript
-     * const contentful = require('contentful-management')
-     *
-     * const client = contentful.createClient({
-     *   accessToken: '<content_management_api_key>'
-     * })
-     *
-     * client.getOrganization('<org_id>')
-     * .then((org) => org.getAppDefinition('<app_def_id>'))
-     * .then((appDefinition) => appDefinition.getAppAction('<app-action-id>'))
-     * .then((appAction) => appAction.delete())
-     * .catch(console.error)
-     * ```
-     */
-    delete(): Promise<void>;
-};
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw App Bundle data
- * @return Wrapped App Bundle data
- */
-export declare function wrapAppAction(makeRequest: MakeRequest, data: AppActionProps): AppAction;
-/**
- * @private
- * @param makeRequest - function to make requests via an adapter
- * @param data - Raw App Bundle collection data
- * @return Wrapped App Bundle collection data
- */
-export declare const wrapAppActionCollection: (makeRequest: MakeRequest, data: import("../common-types").CollectionProp<AppActionProps>) => import("../common-types").Collection<AppAction, AppActionProps>;
-export {};