@uniformdev/canvas 16.2.3 → 17.1.0

package/dist/createEventBus-c46c67da.d.ts

@@ -0,0 +1,1155 @@
+import Pusher from 'pusher-js';
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths$1 {
+    "/api/v1/canvas-definitions": {
+        get: {
+            parameters: {
+                query: {
+                    /** The project ID to get component definitions for. */
+                    projectId: string;
+                    /** Limit list to one result by ID (response remains an array). */
+                    componentId?: string;
+                    /** Number of records to skip */
+                    offset?: number;
+                    /** Max number of records to return */
+                    limit?: number;
+                    /** Whether to fetch system meta-component definitions (personalize, test, etc) */
+                    includeSystem?: boolean;
+                };
+            };
+            responses: {
+                /** OK */
+                200: {
+                    content: {
+                        "application/json": {
+                            /** @description Component definitions that match the query */
+                            componentDefinitions: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinition"][];
+                        };
+                    };
+                };
+                400: external$1["swagger.yml"]["components"]["responses"]["BadRequestError"];
+                401: external$1["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
+                403: external$1["swagger.yml"]["components"]["responses"]["ForbiddenError"];
+                429: external$1["swagger.yml"]["components"]["responses"]["RateLimitError"];
+                500: external$1["swagger.yml"]["components"]["responses"]["InternalServerError"];
+            };
+        };
+        /** Upserts a component definition */
+        put: {
+            responses: {
+                /** OK */
+                204: never;
+                400: external$1["swagger.yml"]["components"]["responses"]["BadRequestError"];
+                401: external$1["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
+                403: external$1["swagger.yml"]["components"]["responses"]["ForbiddenError"];
+                429: external$1["swagger.yml"]["components"]["responses"]["RateLimitError"];
+                500: external$1["swagger.yml"]["components"]["responses"]["InternalServerError"];
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description The project ID to upsert the component definition to
+                         */
+                        projectId: string;
+                        componentDefinition: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinition"];
+                    };
+                };
+            };
+        };
+        /** Deletes a component definition */
+        delete: {
+            responses: {
+                /** OK */
+                204: never;
+                400: external$1["swagger.yml"]["components"]["responses"]["BadRequestError"];
+                401: external$1["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
+                403: external$1["swagger.yml"]["components"]["responses"]["ForbiddenError"];
+                429: external$1["swagger.yml"]["components"]["responses"]["RateLimitError"];
+                500: external$1["swagger.yml"]["components"]["responses"]["InternalServerError"];
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description The public ID of the component definition to delete */
+                        componentId: string;
+                        /**
+                         * Format: uuid
+                         * @description The ID of the project the composition to delete belongs to
+                         */
+                        projectId: string;
+                    };
+                };
+            };
+        };
+        /** Handles preflight requests. This endpoint allows CORS. */
+        options: {
+            responses: {
+                /** OK */
+                204: never;
+            };
+        };
+    };
+}
+interface external$1 {
+    "swagger.yml": {
+        paths: {};
+        components: {
+            schemas: {
+                Error: {
+                    /** @description Error message(s) that occurred while processing the request */
+                    errorMessage?: string[] | string;
+                };
+            };
+            responses: {
+                /** Request input validation failed */
+                BadRequestError: {
+                    content: {
+                        "application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** API key or token was not valid */
+                UnauthorizedError: {
+                    content: {
+                        "application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** Permission was denied */
+                ForbiddenError: {
+                    content: {
+                        "application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** Resource not found */
+                NotFoundError: {
+                    content: {
+                        "application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** Too many requests in allowed time period */
+                RateLimitError: unknown;
+                /** Execution error occurred */
+                InternalServerError: unknown;
+            };
+        };
+        operations: {};
+    };
+    "uniform-canvas-types.swagger.yml": {
+        paths: {};
+        components: {
+            schemas: {
+                /** @description Public ID (used in code). Do not change after creation. */
+                PublicIdProperty: string;
+                /** @description The definition of a component parameter */
+                ComponentDefinitionParameter: {
+                    id: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the parameter */
+                    name: string;
+                    /** @description Appears next to the parameter in the Composition editor */
+                    helpText?: string;
+                    /** @description Type name of the parameter (provided by a Uniform integration) */
+                    type: string;
+                    /** @description The configuration object for the type (type-specific) */
+                    typeConfig?: unknown;
+                };
+                /** @description The definition of a named component slot that can contain other components */
+                ComponentDefinitionSlot: {
+                    id: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the slot */
+                    name: string;
+                    /** @description A list of component definition public IDs that are allowed in this named slot */
+                    allowedComponents: string[];
+                    /**
+                     * @description Whether this slot inherits its allowed components from the parent slot it lives in. If true, allowedComponents is irrelevant.
+                     * @default false
+                     */
+                    inheritAllowedComponents: boolean;
+                    /** @description Minimum valid number of components in this slot */
+                    minComponents?: number;
+                    /** @description Maximum valid number of components in this slot */
+                    maxComponents?: number;
+                };
+                /** @description The definition of a composition's slug settings */
+                ComponentDefinitionSlugSettings: {
+                    /**
+                     * @description Whether the slug is required
+                     * no: slug is optional
+                     * yes: slug is required
+                     * disabled: slug is disabled and will not be shown in the editor
+                     *
+                     * @default no
+                     * @enum {string}
+                     */
+                    required?: "no" | "yes" | "disabled";
+                    /**
+                     * @description Slug uniqueness configuration.
+                     * no = no unique constraint
+                     * local = must be unique within this component type
+                     * global = must be unique across all component types
+                     *
+                     * @enum {string}
+                     */
+                    unique?: "no" | "local" | "global";
+                    /** @description Regular expression slugs must match */
+                    regularExpression?: string;
+                    /**
+                     * @description Custom error message when regular expression validation fails.
+                     * Has no effect if `regularExpression` is not set.
+                     */
+                    regularExpressionMessage?: string;
+                };
+                /** @description The definition of a component variant */
+                ComponentDefinitionVariant: {
+                    id: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the variant */
+                    name: string;
+                };
+                /** @description Permission set for a component defintion */
+                ComponentDefinitionPermission: {
+                    roleId: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /**
+                     * @description Permission type for this permission ComponentDefinition:
+                     * read | write | delete
+                     *
+                     * @enum {string}
+                     */
+                    permission: "read" | "write" | "delete";
+                    /** @description State of the component that this permission applies to */
+                    state: number;
+                };
+                /** @description Defines a component type that can live on a Composition */
+                ComponentDefinition: {
+                    id: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the component definition */
+                    name: string;
+                    /**
+                     * @description Icon name or URL for the component definition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /**
+                     * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
+                     * The parameter type must support being used as a title parameter for this to work.
+                     */
+                    titleParameter?: string | null;
+                    /**
+                     * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components.
+                     * @default false
+                     */
+                    canBeComposition?: boolean;
+                    /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries. */
+                    parameters?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionParameter"][];
+                    /**
+                     * @description if this component uses team permissions or custom permissions
+                     * @default true
+                     */
+                    useTeamPermissions?: boolean;
+                    /** @description Custom role permissions for this component definition */
+                    permissions?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionPermission"][];
+                    /** @description The named slots for this component; placement areas where arrays of other components can be added. */
+                    slots?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionSlot"][];
+                    slugSettings?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionSlugSettings"];
+                    /** @description Default component instance value */
+                    defaults?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"] | null;
+                    /** @description Named variants for this component; enables creation of visual variants that use the same parameter data */
+                    variants?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionVariant"][];
+                    /** @description Created date string for this definition (ignored for writes) */
+                    created?: string;
+                    /** @description Last modified date string for this definition (ignored for writes) */
+                    updated?: string;
+                };
+                /** @description Defines an editable parameter on a component. */
+                ComponentParameter: {
+                    /** @description The value of the parameter. Any JSON-serializable value is acceptable. */
+                    value: unknown;
+                    /** @description The type of the parameter. Determines how it is displayed when editing, and tells the consumer how to process it. */
+                    type: string;
+                    binding?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentParameterBinding"];
+                };
+                /**
+                 * @deprecated
+                 * @description Defines a binding from a resource data value to a component parameter value. Do not use.
+                 */
+                ComponentParameterBinding: {
+                    /**
+                     * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
+                     * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
+                     * Used to bind to object-type values.
+                     * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
+                     * {
+                     *   prop1: {
+                     *     thing: "value of /res1/things/value resource"
+                     *   }
+                     * }
+                     */
+                    pointer: string | {
+                        [key: string]: string;
+                    };
+                    /**
+                     * @description The syntax of the binding (currently always 'jptr')
+                     * @enum {string}
+                     */
+                    syntax: "jptr";
+                    /**
+                     * @description Whether the binding should cause an error if it cannot be resolved.
+                     * If true, and the binding cannot be resolved, an error will be returned by the binding process.
+                     * If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
+                     *
+                     * @default false
+                     */
+                    required?: boolean;
+                };
+                /** @description Defines the shape of a component instance served by the composition API. */
+                ComponentInstance: {
+                    /** @description Type of the component instance (public_id of its definition) */
+                    type: string;
+                    /** @description Component parameter values for the component instance */
+                    parameters?: {
+                        [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentParameter"];
+                    };
+                    /** @description Public ID of alternate visual appearance for this component, if any selected */
+                    variant?: string;
+                    /** @description Slots containing any child components */
+                    slots?: {
+                        [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
+                    };
+                    /** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
+                    _id?: string;
+                    /** @description Indicates this component instance should be sourced from a pattern library pattern. */
+                    _pattern?: string;
+                    /**
+                     * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
+                     * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
+                     * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
+                     *
+                     * @enum {string}
+                     */
+                    _patternError?: "NOTFOUND" | "CYCLIC";
+                };
+                /** @description Defines the shape of the root component in a composition */
+                RootComponentInstance: {
+                    /** @description Type of the component instance (public_id of its definition) */
+                    type: string;
+                    /** @description Component parameter values for the component instance */
+                    parameters?: {
+                        [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentParameter"];
+                    };
+                    /** @description Public ID of alternate visual appearance for this component, if any selected */
+                    variant?: string;
+                    /** @description Slots containing any child components */
+                    slots?: {
+                        [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
+                    };
+                    /** @description The public UUID of the composition. */
+                    _id: string;
+                    /** @description Slug pattern of this component. */
+                    _slug?: string | null;
+                    /** @description Friendly name of this component. */
+                    _name: string;
+                };
+            };
+        };
+        operations: {};
+    };
+}
+
+interface components$1 {
+    schemas: {
+        /** @description Public ID (used in code). Do not change after creation. */
+        PublicIdProperty: string;
+        /** @description The definition of a component parameter */
+        ComponentDefinitionParameter: {
+            id: components$1["schemas"]["PublicIdProperty"];
+            /** @description Friendly name of the parameter */
+            name: string;
+            /** @description Appears next to the parameter in the Composition editor */
+            helpText?: string;
+            /** @description Type name of the parameter (provided by a Uniform integration) */
+            type: string;
+            /** @description The configuration object for the type (type-specific) */
+            typeConfig?: unknown;
+        };
+        /** @description The definition of a named component slot that can contain other components */
+        ComponentDefinitionSlot: {
+            id: components$1["schemas"]["PublicIdProperty"];
+            /** @description Friendly name of the slot */
+            name: string;
+            /** @description A list of component definition public IDs that are allowed in this named slot */
+            allowedComponents: string[];
+            /**
+             * @description Whether this slot inherits its allowed components from the parent slot it lives in. If true, allowedComponents is irrelevant.
+             * @default false
+             */
+            inheritAllowedComponents: boolean;
+            /** @description Minimum valid number of components in this slot */
+            minComponents?: number;
+            /** @description Maximum valid number of components in this slot */
+            maxComponents?: number;
+        };
+        /** @description The definition of a composition's slug settings */
+        ComponentDefinitionSlugSettings: {
+            /**
+             * @description Whether the slug is required
+             * no: slug is optional
+             * yes: slug is required
+             * disabled: slug is disabled and will not be shown in the editor
+             *
+             * @default no
+             * @enum {string}
+             */
+            required?: "no" | "yes" | "disabled";
+            /**
+             * @description Slug uniqueness configuration.
+             * no = no unique constraint
+             * local = must be unique within this component type
+             * global = must be unique across all component types
+             *
+             * @enum {string}
+             */
+            unique?: "no" | "local" | "global";
+            /** @description Regular expression slugs must match */
+            regularExpression?: string;
+            /**
+             * @description Custom error message when regular expression validation fails.
+             * Has no effect if `regularExpression` is not set.
+             */
+            regularExpressionMessage?: string;
+        };
+        /** @description The definition of a component variant */
+        ComponentDefinitionVariant: {
+            id: components$1["schemas"]["PublicIdProperty"];
+            /** @description Friendly name of the variant */
+            name: string;
+        };
+        /** @description Permission set for a component defintion */
+        ComponentDefinitionPermission: {
+            roleId: components$1["schemas"]["PublicIdProperty"];
+            /**
+             * @description Permission type for this permission ComponentDefinition:
+             * read | write | delete
+             *
+             * @enum {string}
+             */
+            permission: "read" | "write" | "delete";
+            /** @description State of the component that this permission applies to */
+            state: number;
+        };
+        /** @description Defines a component type that can live on a Composition */
+        ComponentDefinition: {
+            id: components$1["schemas"]["PublicIdProperty"];
+            /** @description Friendly name of the component definition */
+            name: string;
+            /**
+             * @description Icon name or URL for the component definition (e.g. 'screen' or 'https://s3/my-component.jpg')
+             * @default screen
+             */
+            icon?: string;
+            /**
+             * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
+             * The parameter type must support being used as a title parameter for this to work.
+             */
+            titleParameter?: string | null;
+            /**
+             * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components.
+             * @default false
+             */
+            canBeComposition?: boolean;
+            /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries. */
+            parameters?: components$1["schemas"]["ComponentDefinitionParameter"][];
+            /**
+             * @description if this component uses team permissions or custom permissions
+             * @default true
+             */
+            useTeamPermissions?: boolean;
+            /** @description Custom role permissions for this component definition */
+            permissions?: components$1["schemas"]["ComponentDefinitionPermission"][];
+            /** @description The named slots for this component; placement areas where arrays of other components can be added. */
+            slots?: components$1["schemas"]["ComponentDefinitionSlot"][];
+            slugSettings?: components$1["schemas"]["ComponentDefinitionSlugSettings"];
+            /** @description Default component instance value */
+            defaults?: components$1["schemas"]["ComponentInstance"] | null;
+            /** @description Named variants for this component; enables creation of visual variants that use the same parameter data */
+            variants?: components$1["schemas"]["ComponentDefinitionVariant"][];
+            /** @description Created date string for this definition (ignored for writes) */
+            created?: string;
+            /** @description Last modified date string for this definition (ignored for writes) */
+            updated?: string;
+        };
+        /** @description Defines an editable parameter on a component. */
+        ComponentParameter: {
+            /** @description The value of the parameter. Any JSON-serializable value is acceptable. */
+            value: unknown;
+            /** @description The type of the parameter. Determines how it is displayed when editing, and tells the consumer how to process it. */
+            type: string;
+            binding?: components$1["schemas"]["ComponentParameterBinding"];
+        };
+        /**
+         * @deprecated
+         * @description Defines a binding from a resource data value to a component parameter value. Do not use.
+         */
+        ComponentParameterBinding: {
+            /**
+             * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
+             * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
+             * Used to bind to object-type values.
+             * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
+             * {
+             *   prop1: {
+             *     thing: "value of /res1/things/value resource"
+             *   }
+             * }
+             */
+            pointer: string | {
+                [key: string]: string;
+            };
+            /**
+             * @description The syntax of the binding (currently always 'jptr')
+             * @enum {string}
+             */
+            syntax: "jptr";
+            /**
+             * @description Whether the binding should cause an error if it cannot be resolved.
+             * If true, and the binding cannot be resolved, an error will be returned by the binding process.
+             * If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
+             *
+             * @default false
+             */
+            required?: boolean;
+        };
+        /** @description Defines the shape of a component instance served by the composition API. */
+        ComponentInstance: {
+            /** @description Type of the component instance (public_id of its definition) */
+            type: string;
+            /** @description Component parameter values for the component instance */
+            parameters?: {
+                [key: string]: components$1["schemas"]["ComponentParameter"];
+            };
+            /** @description Public ID of alternate visual appearance for this component, if any selected */
+            variant?: string;
+            /** @description Slots containing any child components */
+            slots?: {
+                [key: string]: components$1["schemas"]["ComponentInstance"][];
+            };
+            /** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
+            _id?: string;
+            /** @description Indicates this component instance should be sourced from a pattern library pattern. */
+            _pattern?: string;
+            /**
+             * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
+             * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
+             * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
+             *
+             * @enum {string}
+             */
+            _patternError?: "NOTFOUND" | "CYCLIC";
+        };
+        /** @description Defines the shape of the root component in a composition */
+        RootComponentInstance: {
+            /** @description Type of the component instance (public_id of its definition) */
+            type: string;
+            /** @description Component parameter values for the component instance */
+            parameters?: {
+                [key: string]: components$1["schemas"]["ComponentParameter"];
+            };
+            /** @description Public ID of alternate visual appearance for this component, if any selected */
+            variant?: string;
+            /** @description Slots containing any child components */
+            slots?: {
+                [key: string]: components$1["schemas"]["ComponentInstance"][];
+            };
+            /** @description The public UUID of the composition. */
+            _id: string;
+            /** @description Slug pattern of this component. */
+            _slug?: string | null;
+            /** @description Friendly name of this component. */
+            _name: string;
+        };
+    };
+}
+
+declare type SharedComponents$1 = components$1['schemas'];
+declare type Api$1 = paths$1['/api/v1/canvas-definitions'];
+/** Shape of the GET response from /api/v1/canvas-definitions */
+declare type ComponentDefinitionGetResponse = Api$1['get']['responses']['200']['content']['application/json'];
+/** Shape of the PUT request body for /api/v1/canvas-definitions */
+declare type ComponentDefinitionPutParameters = Api$1['put']['requestBody']['content']['application/json'];
+/** Shape of the DELETE request body for /api/v1/canvas-definitions */
+declare type ComponentDefinitionDeleteParameters = Api$1['delete']['requestBody']['content']['application/json'];
+/** Query parameter options for GET /api/v1/canvas-definitions */
+declare type ComponentDefinitionGetParameters = Api$1['get']['parameters']['query'];
+/** @deprecated use ComponentDefinitionGetResponse instead */
+declare type ComponentDefinitionAPIResponse = ComponentDefinitionGetResponse;
+/** @deprecated use ComponentDefinitionPutParameters */
+declare type ComponentDefinitionAPIPutRequest = ComponentDefinitionPutParameters;
+/** @deprecated use ComponentDefinitionDeleteParameters */
+declare type ComponentDefinitionAPIDeleteRequest = ComponentDefinitionDeleteParameters;
+/** @deprecated use ComponentDefinitionGetParameters */
+declare type ComponentDefinitionListAPIOptions = ComponentDefinitionGetParameters;
+/** The definition of a component parameter */
+declare type ComponentDefinitionParameter<TConfig = unknown> = Omit<components$1['schemas']['ComponentDefinitionParameter'], 'typeConfig'> & {
+    typeConfig?: TConfig;
+};
+/** The definition of a component visual variant */
+declare type ComponentDefinitionVariant = SharedComponents$1['ComponentDefinitionVariant'];
+/** The definition of a composition's slug settings */
+declare type ComponentDefinitionSlugSettings = SharedComponents$1['ComponentDefinitionSlugSettings'];
+/** The definition of a named component slot that can contain other components */
+declare type ComponentDefinitionSlot = SharedComponents$1['ComponentDefinitionSlot'];
+/** Permission set for a component defintion */
+declare type ComponentDefinitionPermission = SharedComponents$1['ComponentDefinitionPermission'];
+/** Defines a component type that can live on a Composition */
+declare type ComponentDefinition = SharedComponents$1['ComponentDefinition'];
+/** @deprecated use ComponentDefinition instead */
+declare type CreatingComponentDefinition = Omit<Partial<ComponentDefinition>, 'created' | 'updated'>;
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+    "/api/v1/canvas": {
+        get: {
+            parameters: {
+                query: {
+                    /** The project the composition(s) are on. */
+                    projectId: string;
+                    /** Specify a single composition ID to fetch. Changes response from list to single. */
+                    compositionId?: string;
+                    /** Specify a single composition to fetch by slug. Changes response from list to single. */
+                    slug?: string;
+                    /** The component type to filter by */
+                    type?: string;
+                    /** State of compositions to fetch. 0 = draft, 64 = published. */
+                    state?: number;
+                    /** Number of records to skip */
+                    offset?: number;
+                    /** Max number of records to return */
+                    limit?: number;
+                    /**
+                     * @deprecated Signals an enhancer proxy to skip processing enhancements to the data and return raw data only.
+                     * This improves performance if you do not require enhanced component data.
+                     * If calling the Canvas API directly with no enhancer proxy, this has no effect.
+                     */
+                    skipEnhance?: boolean;
+                    /**
+                     * If true, any pattern references in the composition will be left unresolved.
+                     * This is appropriate if you intend to serialize the composition data without pattern
+                     * data embedded into it, and serialize the pattern data separately.
+                     */
+                    skipPatternResolution?: boolean;
+                    /**
+                     * If true the `_id` unique identifier of each non-root component will be part of the response data.
+                     * If false, the `_id` will not be present in the API response.
+                     */
+                    withComponentIDs?: boolean;
+                };
+            };
+            responses: {
+                /** OK */
+                200: {
+                    content: {
+                        "application/json": components["schemas"]["CompositionListResponse"] | components["schemas"]["CompositionApiResponse"];
+                    };
+                };
+                400: external["swagger.yml"]["components"]["responses"]["BadRequestError"];
+                401: external["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
+                403: external["swagger.yml"]["components"]["responses"]["ForbiddenError"];
+                /** Composition not found */
+                404: {
+                    content: {
+                        "text/plain": string;
+                    };
+                };
+                429: external["swagger.yml"]["components"]["responses"]["RateLimitError"];
+                500: external["swagger.yml"]["components"]["responses"]["InternalServerError"];
+            };
+        };
+        /** Upserts a composition */
+        put: {
+            responses: {
+                /** OK */
+                204: never;
+                400: external["swagger.yml"]["components"]["responses"]["BadRequestError"];
+                401: external["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
+                403: external["swagger.yml"]["components"]["responses"]["ForbiddenError"];
+                429: external["swagger.yml"]["components"]["responses"]["RateLimitError"];
+                500: external["swagger.yml"]["components"]["responses"]["InternalServerError"];
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description The project ID to upsert the composition to
+                         */
+                        projectId: string;
+                        /** @description The state of the composition to upsert into. 0 = draft, 64 = published */
+                        state: number;
+                        composition: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["RootComponentInstance"];
+                        /**
+                         * @description True if the composition is a pattern (which can be referenced on other compositions)
+                         * @default false
+                         */
+                        pattern?: boolean;
+                        resources?: components["schemas"]["CompositionResourceDefinitions"];
+                        variables?: components["schemas"]["CompositionVariableDefinitions"];
+                        /** @description Ignored if present */
+                        created?: string;
+                        /** @description Ignored if present */
+                        modified?: string;
+                    };
+                };
+            };
+        };
+        /** Deletes or unpublishes a composition */
+        delete: {
+            responses: {
+                /** OK */
+                204: never;
+                400: external["swagger.yml"]["components"]["responses"]["BadRequestError"];
+                401: external["swagger.yml"]["components"]["responses"]["UnauthorizedError"];
+                403: external["swagger.yml"]["components"]["responses"]["ForbiddenError"];
+                429: external["swagger.yml"]["components"]["responses"]["RateLimitError"];
+                500: external["swagger.yml"]["components"]["responses"]["InternalServerError"];
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description The ID of the composition to delete
+                         */
+                        compositionId: string;
+                        /**
+                         * Format: uuid
+                         * @description The ID of the project the composition to delete belongs to
+                         */
+                        projectId: string;
+                        /** @description The state of the composition to delete (0 = draft, 64 = published [causes unpublishing], unspecified = all) */
+                        state?: number;
+                    };
+                };
+            };
+        };
+        /** Handles preflight requests. This endpoint allows CORS. */
+        options: {
+            responses: {
+                /** OK */
+                204: never;
+            };
+        };
+    };
+}
+interface components {
+    schemas: {
+        CompositionApiResponse: {
+            /** @description State of compositions to fetch. 0 = draft, 64 = published. */
+            state: number;
+            /**
+             * Format: uuid
+             * @description The project ID that this layout data is part of
+             */
+            projectId: string;
+            /**
+             * Format: date-time,
+             * @description Created date string for this definition
+             */
+            created: string;
+            /**
+             * Format: date-time,
+             * @description Modified date string for this definition
+             */
+            modified: string;
+            /** @description Whether this composition is a pattern (can be referenced by other compositions, not treated as a composition) */
+            pattern: boolean;
+            resources?: components["schemas"]["CompositionResourceDefinitions"];
+            composition: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["RootComponentInstance"];
+            variables?: components["schemas"]["CompositionVariableDefinitions"];
+        };
+        CompositionListResponse: {
+            compositions: components["schemas"]["CompositionApiResponse"][];
+        };
+        /**
+         * @deprecated
+         * @description Variables defined for this composition.
+         */
+        CompositionVariableDefinitions: {
+            [key: string]: components["schemas"]["CompositionVariable"];
+        };
+        /**
+         * @deprecated
+         * @description Defines a variable value that can be used in resources and bindings.
+         */
+        CompositionVariable: {
+            /**
+             * @description Whether the variable must have a value when bound to.
+             * If true, binding a composition without this variable set will return an error.
+             * If false, binding a composition without this variable set will use the default value instead.
+             */
+            required: boolean;
+            /** @description The default value of the variable, used when binding for editing or when an optional variable value is not provided. */
+            default: string;
+        };
+        /**
+         * @deprecated
+         * @description Resource definitions attached to this composition. The property name is the key of the resource in the resource document.
+         */
+        CompositionResourceDefinitions: {
+            [key: string]: components["schemas"]["CompositionResourceDefinition"];
+        };
+        /**
+         * @deprecated
+         * @description Resource definition attached to this composition
+         */
+        CompositionResourceDefinition: {
+            /** @description Integration that provides this resource */
+            type: string;
+            /** @description Type-specific data to configure resource */
+            data: {
+                [key: string]: unknown;
+            };
+        };
+    };
+}
+interface external {
+    "swagger.yml": {
+        paths: {};
+        components: {
+            schemas: {
+                Error: {
+                    /** @description Error message(s) that occurred while processing the request */
+                    errorMessage?: string[] | string;
+                };
+            };
+            responses: {
+                /** Request input validation failed */
+                BadRequestError: {
+                    content: {
+                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** API key or token was not valid */
+                UnauthorizedError: {
+                    content: {
+                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** Permission was denied */
+                ForbiddenError: {
+                    content: {
+                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** Resource not found */
+                NotFoundError: {
+                    content: {
+                        "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
+                    };
+                };
+                /** Too many requests in allowed time period */
+                RateLimitError: unknown;
+                /** Execution error occurred */
+                InternalServerError: unknown;
+            };
+        };
+        operations: {};
+    };
+    "uniform-canvas-types.swagger.yml": {
+        paths: {};
+        components: {
+            schemas: {
+                /** @description Public ID (used in code). Do not change after creation. */
+                PublicIdProperty: string;
+                /** @description The definition of a component parameter */
+                ComponentDefinitionParameter: {
+                    id: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the parameter */
+                    name: string;
+                    /** @description Appears next to the parameter in the Composition editor */
+                    helpText?: string;
+                    /** @description Type name of the parameter (provided by a Uniform integration) */
+                    type: string;
+                    /** @description The configuration object for the type (type-specific) */
+                    typeConfig?: unknown;
+                };
+                /** @description The definition of a named component slot that can contain other components */
+                ComponentDefinitionSlot: {
+                    id: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the slot */
+                    name: string;
+                    /** @description A list of component definition public IDs that are allowed in this named slot */
+                    allowedComponents: string[];
+                    /**
+                     * @description Whether this slot inherits its allowed components from the parent slot it lives in. If true, allowedComponents is irrelevant.
+                     * @default false
+                     */
+                    inheritAllowedComponents: boolean;
+                    /** @description Minimum valid number of components in this slot */
+                    minComponents?: number;
+                    /** @description Maximum valid number of components in this slot */
+                    maxComponents?: number;
+                };
+                /** @description The definition of a composition's slug settings */
+                ComponentDefinitionSlugSettings: {
+                    /**
+                     * @description Whether the slug is required
+                     * no: slug is optional
+                     * yes: slug is required
+                     * disabled: slug is disabled and will not be shown in the editor
+                     *
+                     * @default no
+                     * @enum {string}
+                     */
+                    required?: "no" | "yes" | "disabled";
+                    /**
+                     * @description Slug uniqueness configuration.
+                     * no = no unique constraint
+                     * local = must be unique within this component type
+                     * global = must be unique across all component types
+                     *
+                     * @enum {string}
+                     */
+                    unique?: "no" | "local" | "global";
+                    /** @description Regular expression slugs must match */
+                    regularExpression?: string;
+                    /**
+                     * @description Custom error message when regular expression validation fails.
+                     * Has no effect if `regularExpression` is not set.
+                     */
+                    regularExpressionMessage?: string;
+                };
+                /** @description The definition of a component variant */
+                ComponentDefinitionVariant: {
+                    id: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the variant */
+                    name: string;
+                };
+                /** @description Permission set for a component defintion */
+                ComponentDefinitionPermission: {
+                    roleId: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /**
+                     * @description Permission type for this permission ComponentDefinition:
+                     * read | write | delete
+                     *
+                     * @enum {string}
+                     */
+                    permission: "read" | "write" | "delete";
+                    /** @description State of the component that this permission applies to */
+                    state: number;
+                };
+                /** @description Defines a component type that can live on a Composition */
+                ComponentDefinition: {
+                    id: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+                    /** @description Friendly name of the component definition */
+                    name: string;
+                    /**
+                     * @description Icon name or URL for the component definition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /**
+                     * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
+                     * The parameter type must support being used as a title parameter for this to work.
+                     */
+                    titleParameter?: string | null;
+                    /**
+                     * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components.
+                     * @default false
+                     */
+                    canBeComposition?: boolean;
+                    /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries. */
+                    parameters?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionParameter"][];
+                    /**
+                     * @description if this component uses team permissions or custom permissions
+                     * @default true
+                     */
+                    useTeamPermissions?: boolean;
+                    /** @description Custom role permissions for this component definition */
+                    permissions?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionPermission"][];
+                    /** @description The named slots for this component; placement areas where arrays of other components can be added. */
+                    slots?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionSlot"][];
+                    slugSettings?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionSlugSettings"];
+                    /** @description Default component instance value */
+                    defaults?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"] | null;
+                    /** @description Named variants for this component; enables creation of visual variants that use the same parameter data */
+                    variants?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentDefinitionVariant"][];
+                    /** @description Created date string for this definition (ignored for writes) */
+                    created?: string;
+                    /** @description Last modified date string for this definition (ignored for writes) */
+                    updated?: string;
+                };
+                /** @description Defines an editable parameter on a component. */
+                ComponentParameter: {
+                    /** @description The value of the parameter. Any JSON-serializable value is acceptable. */
+                    value: unknown;
+                    /** @description The type of the parameter. Determines how it is displayed when editing, and tells the consumer how to process it. */
+                    type: string;
+                    binding?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentParameterBinding"];
+                };
+                /**
+                 * @deprecated
+                 * @description Defines a binding from a resource data value to a component parameter value. Do not use.
+                 */
+                ComponentParameterBinding: {
+                    /**
+                     * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
+                     * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
+                     * Used to bind to object-type values.
+                     * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
+                     * {
+                     *   prop1: {
+                     *     thing: "value of /res1/things/value resource"
+                     *   }
+                     * }
+                     */
+                    pointer: string | {
+                        [key: string]: string;
+                    };
+                    /**
+                     * @description The syntax of the binding (currently always 'jptr')
+                     * @enum {string}
+                     */
+                    syntax: "jptr";
+                    /**
+                     * @description Whether the binding should cause an error if it cannot be resolved.
+                     * If true, and the binding cannot be resolved, an error will be returned by the binding process.
+                     * If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
+                     *
+                     * @default false
+                     */
+                    required?: boolean;
+                };
+                /** @description Defines the shape of a component instance served by the composition API. */
+                ComponentInstance: {
+                    /** @description Type of the component instance (public_id of its definition) */
+                    type: string;
+                    /** @description Component parameter values for the component instance */
+                    parameters?: {
+                        [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentParameter"];
+                    };
+                    /** @description Public ID of alternate visual appearance for this component, if any selected */
+                    variant?: string;
+                    /** @description Slots containing any child components */
+                    slots?: {
+                        [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
+                    };
+                    /** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
+                    _id?: string;
+                    /** @description Indicates this component instance should be sourced from a pattern library pattern. */
+                    _pattern?: string;
+                    /**
+                     * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
+                     * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
+                     * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
+                     *
+                     * @enum {string}
+                     */
+                    _patternError?: "NOTFOUND" | "CYCLIC";
+                };
+                /** @description Defines the shape of the root component in a composition */
+                RootComponentInstance: {
+                    /** @description Type of the component instance (public_id of its definition) */
+                    type: string;
+                    /** @description Component parameter values for the component instance */
+                    parameters?: {
+                        [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentParameter"];
+                    };
+                    /** @description Public ID of alternate visual appearance for this component, if any selected */
+                    variant?: string;
+                    /** @description Slots containing any child components */
+                    slots?: {
+                        [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
+                    };
+                    /** @description The public UUID of the composition. */
+                    _id: string;
+                    /** @description Slug pattern of this component. */
+                    _slug?: string | null;
+                    /** @description Friendly name of this component. */
+                    _name: string;
+                };
+            };
+        };
+        operations: {};
+    };
+}
+
+declare type Components = components['schemas'];
+declare type SharedComponents = components$1['schemas'];
+declare type Api = paths['/api/v1/canvas'];
+/** Query parameter options for GET /api/v1/canvas */
+declare type CompositionGetParameters = Api['get']['parameters']['query'];
+/** The GET response from /api/v1/canvas when `component` or `slug` params are specified */
+declare type CompositionGetResponse = Components['CompositionApiResponse'];
+/** The GET response from /api/v1/canvas when `component` or `slug` are not specified */
+declare type CompositionGetListResponse = Components['CompositionListResponse'];
+/** The PUT request body for /api/v1/canvas */
+declare type CompositionPutParameters = Api['put']['requestBody']['content']['application/json'];
+/** Shape of the DELETE request body for /api/v1/canvas */
+declare type CompositionDeleteParameters = Api['delete']['requestBody']['content']['application/json'];
+/** @deprecated use CompositionGetResponse */
+declare type CompositionAPIResponse = CompositionGetResponse;
+/** @deprecated use CompositionDeleteParameters */
+declare type CompositionAPIDeleteRequest = CompositionDeleteParameters;
+/** @deprecated use CompositionGetParameters */
+declare type CompositionListAPIResponse = CompositionGetListResponse;
+/** @deprecated use CompositionGetParameters */
+declare type CompositionAPIOptions = CompositionGetParameters;
+/** Defines an editable parameter on a component. */
+declare type ComponentParameter<TValue = unknown> = Omit<SharedComponents['ComponentParameter'], 'value'> & {
+    /** The type of the parameter. Determines how it is displayed when editing, and tells the consumer how to process it. */
+    value: TValue;
+};
+/** Defines a binding from a resource data value to a component parameter value. */
+declare type ComponentParameterBinding = SharedComponents['ComponentParameterBinding'];
+/** Variables defined for this composition. */
+declare type CompositionVariableDefinitions = Components['CompositionVariableDefinitions'];
+/** Defines a variable value that can be used in resources and bindings. */
+declare type CompositionVariable = Components['CompositionVariable'];
+/** Defines the shape of a resource bound to a composition */
+declare type CompositionResourceDefinitions = components['schemas']['CompositionResourceDefinitions'];
+/** Defines the shape of a resource bound to a composition */
+declare type CompositionResourceDefinition = components['schemas']['CompositionResourceDefinition'];
+/** Defines the shape of a component instance served by the composition API. */
+declare type ComponentInstance = SharedComponents['ComponentInstance'] & {
+    /** Data for the component instance, provided by a component enhancer. Never set in unenhanced data. */
+    data?: Record<string, unknown>;
+};
+/** Defines the shape of the root component in a composition */
+declare type RootComponentInstance = SharedComponents['RootComponentInstance'];
+/** Defines single structure to keep all canvas models (used in CLI commands and Starter content generations) */
+declare type CanvasDefinitions = {
+    components?: Array<ComponentDefinition>;
+    compositions?: Array<CompositionGetResponse>;
+};
+
+/**
+ * Pusher-js is large (80k) and not tree shakable so it is always bundled if directly referenced,
+ * when it's only needed during preview mode. To avoid bundling it for all, we use an old-school
+ * write-a-script-tag hack to load it in a poor man's approximation of a dynamic import ;)
+ */
+declare type ChannelSubscription = {
+    addEventHandler: (eventName: string, handler: (data: unknown) => void) => () => void;
+    unsubscribe: () => void;
+};
+declare type PreviewEventBus = {
+    subscribe: (channel: string) => ChannelSubscription;
+};
+declare global {
+    interface Window {
+        Pusher?: typeof Pusher;
+        __UNIFORM_EVENT_BUS__?: PreviewEventBus;
+    }
+}
+/**
+ * Creates an event bus client to receive updates from Canvas
+ * IMPORTANT: in a server-side context this will always return undefined
+ * IMPORTANT: in a browser context this is cached in window and does not create multiple instances
+ */
+declare function createEventBus(): Promise<PreviewEventBus | undefined>;
+
+export { CompositionVariableDefinitions as A, CompositionVariable as B, ComponentInstance as C, CompositionResourceDefinitions as D, CompositionResourceDefinition as E, CanvasDefinitions as F, ChannelSubscription as G, createEventBus as H, PreviewEventBus as P, RootComponentInstance as R, ComponentParameter as a, CompositionGetParameters as b, CompositionPutParameters as c, CompositionDeleteParameters as d, ComponentDefinitionGetParameters as e, ComponentDefinitionPutParameters as f, ComponentDefinitionDeleteParameters as g, ComponentDefinitionGetResponse as h, ComponentDefinitionAPIResponse as i, ComponentDefinitionAPIPutRequest as j, ComponentDefinitionAPIDeleteRequest as k, ComponentDefinitionListAPIOptions as l, ComponentDefinitionParameter as m, ComponentDefinitionVariant as n, ComponentDefinitionSlugSettings as o, ComponentDefinitionSlot as p, ComponentDefinitionPermission as q, ComponentDefinition as r, CreatingComponentDefinition as s, CompositionGetResponse as t, CompositionGetListResponse as u, CompositionAPIResponse as v, CompositionAPIDeleteRequest as w, CompositionListAPIResponse as x, CompositionAPIOptions as y, ComponentParameterBinding as z };