convex-cms 0.0.15 → 0.0.16

package/admin/dist/types/src/component/contentTypeMutations.d.ts

@@ -0,0 +1,1253 @@
+/**
+ * Content Type Mutation Functions
+ *
+ * Provides mutation functions for creating, updating, and managing content types.
+ * Content types define the schema/blueprint for content entries in the CMS.
+ */
+/**
+ * Describes a potential breaking change when updating a content type.
+ */
+interface BreakingChange {
+    /** Type of breaking change detected */
+    type: "FIELD_REMOVED" | "FIELD_TYPE_CHANGED" | "FIELD_MADE_REQUIRED" | "SELECT_OPTIONS_REMOVED" | "REFERENCE_TYPES_RESTRICTED" | "VALIDATION_TIGHTENED";
+    /** The field name affected */
+    fieldName: string;
+    /** Human-readable description of the breaking change */
+    message: string;
+    /** Number of entries affected by this change */
+    affectedEntriesCount: number;
+}
+/**
+ * Mutation to create a new content type.
+ *
+ * Creates a content type definition with a unique name, display name, and
+ * field definitions. The content type can then be used to create content entries.
+ *
+ * @param name - Unique machine-readable name (e.g., "blog_post")
+ * @param displayName - Human-readable name (e.g., "Blog Post")
+ * @param description - Optional description of the content type
+ * @param fields - Array of field definitions
+ * @param icon - Optional icon identifier for UI
+ * @param singleton - If true, only one entry of this type can exist
+ * @param slugField - Field name to use for slug generation (defaults to first text field)
+ * @param titleField - Field name to use as display title (defaults to first text field)
+ * @param sortOrder - Custom sort order for admin UI
+ * @param createdBy - User ID who is creating this content type
+ *
+ * @returns The created content type document
+ *
+ * @throws Error if the name is not unique
+ * @throws Error if the name format is invalid
+ * @throws Error if field definitions are invalid
+ *
+ * @example
+ * ```typescript
+ * const blogPost = await ctx.runMutation(api.contentTypeMutations.createContentType, {
+ *   name: "blog_post",
+ *   displayName: "Blog Post",
+ *   description: "Articles for the company blog",
+ *   fields: [
+ *     { name: "title", label: "Title", type: "text", required: true },
+ *     { name: "content", label: "Content", type: "richText", required: true },
+ *     { name: "published_date", label: "Published Date", type: "date", required: false },
+ *   ],
+ *   slugField: "title",
+ *   titleField: "title",
+ *   createdBy: currentUserId,
+ * });
+ * ```
+ */
+export declare const createContentType: import("convex/server").RegisteredMutation<"public", {
+    description?: string | undefined;
+    icon?: string | undefined;
+    _auth?: {
+        resourceOwnerId?: string | undefined;
+        role: string | null;
+        userId: string;
+    } | undefined;
+    singleton?: boolean | undefined;
+    slugField?: string | undefined;
+    sortOrder?: number | undefined;
+    titleField?: string | undefined;
+    fields: ({
+        description?: string | undefined;
+        options?: {
+            pattern?: string | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            patternMessage?: string | undefined;
+            placeholder?: string | undefined;
+            multiline?: boolean | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "text";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "number";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            trueLabel?: string | undefined;
+            falseLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "boolean";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxLength?: number | undefined;
+            placeholder?: string | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "richText";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            mediaType?: "image" | "video" | "audio" | "document" | "other" | undefined;
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "media";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "select";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "tags";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowMultiple?: boolean | undefined;
+            maxSelections?: number | undefined;
+            depth?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "category";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            schema?: any;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "json";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "reference";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            maxSelections?: number | undefined;
+            minSelections?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "multiSelect";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "date";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            timezone?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "datetime";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            defaultCurrency?: string | undefined;
+            allowedCurrencies?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "money";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxItems?: number | undefined;
+            minItems?: number | undefined;
+            subFields?: any;
+            itemLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "arrayObject";
+        label: string;
+        required: boolean;
+        name: string;
+    })[];
+    createdBy: string;
+    displayName: string;
+    name: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"contentTypes">;
+    _creationTime: number;
+    description?: string | undefined;
+    icon?: string | undefined;
+    updatedBy?: string | undefined;
+    singleton?: boolean | undefined;
+    slugField?: string | undefined;
+    sortOrder?: number | undefined;
+    titleField?: string | undefined;
+    deletedAt?: number | undefined;
+    fields: ({
+        description?: string | undefined;
+        options?: {
+            pattern?: string | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            patternMessage?: string | undefined;
+            placeholder?: string | undefined;
+            multiline?: boolean | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "text";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "number";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            trueLabel?: string | undefined;
+            falseLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "boolean";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxLength?: number | undefined;
+            placeholder?: string | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "richText";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            mediaType?: "image" | "video" | "audio" | "document" | "other" | undefined;
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "media";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "select";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "tags";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowMultiple?: boolean | undefined;
+            maxSelections?: number | undefined;
+            depth?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "category";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            schema?: any;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "json";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "reference";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            maxSelections?: number | undefined;
+            minSelections?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "multiSelect";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "date";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            timezone?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "datetime";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            defaultCurrency?: string | undefined;
+            allowedCurrencies?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "money";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxItems?: number | undefined;
+            minItems?: number | undefined;
+            subFields?: any;
+            itemLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "arrayObject";
+        label: string;
+        required: boolean;
+        name: string;
+    })[];
+    createdBy: string;
+    displayName: string;
+    name: string;
+    isActive: boolean;
+}>>;
+/**
+ * Mutation to update an existing content type's fields and configuration.
+ *
+ * Includes validation to prevent breaking changes to fields with existing content.
+ * When breaking changes are detected and `force` is not set to true, the mutation
+ * will throw an error with details about the breaking changes.
+ *
+ * **Breaking Change Detection:**
+ * - Removing fields that have data in existing entries
+ * - Changing field types (e.g., text → number)
+ * - Making optional fields required when entries have empty values
+ * - Removing select/multiSelect options that are in use
+ * - Restricting allowed reference content types
+ * - Tightening validation rules (increased minLength, decreased maxLength)
+ *
+ * @param id - The content type ID to update
+ * @param displayName - Optional new display name
+ * @param description - Optional new description
+ * @param fields - Optional new field definitions (replaces all existing fields)
+ * @param icon - Optional new icon
+ * @param singleton - Optional singleton flag
+ * @param slugField - Optional field name for slug generation
+ * @param titleField - Optional field name for display title
+ * @param sortOrder - Optional new sort order
+ * @param isActive - Optional active status
+ * @param updatedBy - User ID making the update (for audit trail)
+ * @param force - If true, allow breaking changes (default: false)
+ *
+ * @returns The updated content type, with breakingChanges if force was used
+ *
+ * @throws Error if the content type does not exist
+ * @throws Error if breaking changes are detected and force is not true
+ * @throws Error if field definitions are invalid
+ *
+ * @example
+ * ```typescript
+ * // Simple update (no breaking changes)
+ * const updated = await ctx.runMutation(api.contentTypeMutations.updateContentType, {
+ *   id: contentTypeId,
+ *   displayName: "Updated Blog Post",
+ *   description: "New description",
+ *   updatedBy: currentUserId,
+ * });
+ *
+ * // Update fields (will check for breaking changes)
+ * const updated = await ctx.runMutation(api.contentTypeMutations.updateContentType, {
+ *   id: contentTypeId,
+ *   fields: [
+ *     { name: "title", label: "Title", type: "text", required: true },
+ *     { name: "content", label: "Content", type: "richText", required: true },
+ *     { name: "author", label: "Author", type: "text", required: false }, // New field
+ *   ],
+ *   updatedBy: currentUserId,
+ * });
+ *
+ * // Force update with breaking changes
+ * const updated = await ctx.runMutation(api.contentTypeMutations.updateContentType, {
+ *   id: contentTypeId,
+ *   fields: newFields,
+ *   force: true, // Acknowledge potential data loss
+ *   updatedBy: currentUserId,
+ * });
+ * ```
+ */
+export declare const updateContentType: import("convex/server").RegisteredMutation<"public", {
+    description?: string | undefined;
+    icon?: string | undefined;
+    fields?: ({
+        description?: string | undefined;
+        options?: {
+            pattern?: string | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            patternMessage?: string | undefined;
+            placeholder?: string | undefined;
+            multiline?: boolean | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "text";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "number";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            trueLabel?: string | undefined;
+            falseLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "boolean";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxLength?: number | undefined;
+            placeholder?: string | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "richText";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            mediaType?: "image" | "video" | "audio" | "document" | "other" | undefined;
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "media";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "select";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "tags";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowMultiple?: boolean | undefined;
+            maxSelections?: number | undefined;
+            depth?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "category";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            schema?: any;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "json";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "reference";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            maxSelections?: number | undefined;
+            minSelections?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "multiSelect";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "date";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            timezone?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "datetime";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            defaultCurrency?: string | undefined;
+            allowedCurrencies?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "money";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxItems?: number | undefined;
+            minItems?: number | undefined;
+            subFields?: any;
+            itemLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "arrayObject";
+        label: string;
+        required: boolean;
+        name: string;
+    })[] | undefined;
+    updatedBy?: string | undefined;
+    displayName?: string | undefined;
+    _auth?: {
+        resourceOwnerId?: string | undefined;
+        role: string | null;
+        userId: string;
+    } | undefined;
+    singleton?: boolean | undefined;
+    slugField?: string | undefined;
+    sortOrder?: number | undefined;
+    titleField?: string | undefined;
+    force?: boolean | undefined;
+    isActive?: boolean | undefined;
+    id: import("convex/values").GenericId<"contentTypes">;
+}, Promise<{
+    breakingChanges: BreakingChange[] | undefined;
+    _id: import("convex/values").GenericId<"contentTypes">;
+    _creationTime: number;
+    description?: string | undefined;
+    icon?: string | undefined;
+    updatedBy?: string | undefined;
+    singleton?: boolean | undefined;
+    slugField?: string | undefined;
+    sortOrder?: number | undefined;
+    titleField?: string | undefined;
+    deletedAt?: number | undefined;
+    fields: ({
+        description?: string | undefined;
+        options?: {
+            pattern?: string | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            patternMessage?: string | undefined;
+            placeholder?: string | undefined;
+            multiline?: boolean | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "text";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "number";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            trueLabel?: string | undefined;
+            falseLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "boolean";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxLength?: number | undefined;
+            placeholder?: string | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "richText";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            mediaType?: "image" | "video" | "audio" | "document" | "other" | undefined;
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "media";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "select";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "tags";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            taxonomyId?: string | undefined;
+            taxonomyName?: string | undefined;
+            allowMultiple?: boolean | undefined;
+            maxSelections?: number | undefined;
+            depth?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "category";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            schema?: any;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "json";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            multiple?: boolean | undefined;
+            maxItems?: number | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "reference";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            options?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+            maxSelections?: number | undefined;
+            minSelections?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "multiSelect";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "date";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            format?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            timezone?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "datetime";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            min?: number | undefined;
+            max?: number | undefined;
+            defaultCurrency?: string | undefined;
+            allowedCurrencies?: string[] | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "money";
+        label: string;
+        required: boolean;
+        name: string;
+    } | {
+        description?: string | undefined;
+        options?: {
+            maxItems?: number | undefined;
+            minItems?: number | undefined;
+            subFields?: any;
+            itemLabel?: string | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        defaultValue?: any;
+        group?: string | undefined;
+        type: "arrayObject";
+        label: string;
+        required: boolean;
+        name: string;
+    })[];
+    createdBy: string;
+    displayName: string;
+    name: string;
+    isActive: boolean;
+}>>;
+/**
+ * Result type for the delete content type mutation.
+ * Includes information about any cascade-deleted entries.
+ */
+export declare const deleteContentTypeResult: import("convex/values").VObject<{
+    success: boolean;
+    deletedVersionsCount: number;
+    deletedId: import("convex/values").GenericId<"contentTypes">;
+    deletedEntriesCount: number;
+    wasHardDelete: boolean;
+}, {
+    /** Whether the deletion was successful */
+    success: import("convex/values").VBoolean<boolean, "required">;
+    /** The ID of the deleted content type */
+    deletedId: import("convex/values").VId<import("convex/values").GenericId<"contentTypes">, "required">;
+    /** Number of content entries that were deleted (when cascade=true) */
+    deletedEntriesCount: import("convex/values").VFloat64<number, "required">;
+    /** Number of content versions that were deleted (when cascade=true and hardDelete=true) */
+    deletedVersionsCount: import("convex/values").VFloat64<number, "required">;
+    /** Whether this was a hard delete (permanent) or soft delete */
+    wasHardDelete: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "success" | "deletedVersionsCount" | "deletedId" | "deletedEntriesCount" | "wasHardDelete">;
+/**
+ * Mutation to delete a content type.
+ *
+ * Supports two deletion strategies via the `cascade` flag:
+ * 1. **Cascade delete** (`cascade: true`): Deletes all content entries of this type
+ *    before deleting the content type itself.
+ * 2. **Prevent if entries exist** (`cascade: false` or not specified): Fails the
+ *    deletion if any content entries exist for this type.
+ *
+ * Also supports two deletion modes via the `hardDelete` flag:
+ * - **Soft delete** (default): Sets `deletedAt` timestamp, entries remain in database
+ * - **Hard delete** (`hardDelete: true`): Permanently removes from database
+ *
+ * @param id - The content type ID to delete
+ * @param cascade - If true, delete all entries of this type first. Default: false
+ * @param hardDelete - If true, permanently delete. Default: false (soft delete)
+ * @param deletedBy - User ID performing the deletion (for audit trail)
+ *
+ * @returns Object with deletion results including counts of deleted entries/versions
+ *
+ * @throws Error if content type does not exist
+ * @throws Error if content type is already deleted (soft deleted)
+ * @throws Error if cascade is false and content entries exist
+ *
+ * @example
+ * ```typescript
+ * // Soft delete - fails if entries exist
+ * const result = await ctx.runMutation(api.contentTypeMutations.deleteContentType, {
+ *   id: contentTypeId,
+ *   deletedBy: currentUserId,
+ * });
+ *
+ * // Cascade soft delete - deletes all entries too
+ * const result = await ctx.runMutation(api.contentTypeMutations.deleteContentType, {
+ *   id: contentTypeId,
+ *   cascade: true,
+ *   deletedBy: currentUserId,
+ * });
+ *
+ * // Hard delete with cascade - permanently removes everything
+ * const result = await ctx.runMutation(api.contentTypeMutations.deleteContentType, {
+ *   id: contentTypeId,
+ *   cascade: true,
+ *   hardDelete: true,
+ *   deletedBy: currentUserId,
+ * });
+ * ```
+ */
+export declare const deleteContentType: import("convex/server").RegisteredMutation<"public", {
+    deletedBy?: string | undefined;
+    hardDelete?: boolean | undefined;
+    _auth?: {
+        resourceOwnerId?: string | undefined;
+        role: string | null;
+        userId: string;
+    } | undefined;
+    cascade?: boolean | undefined;
+    id: import("convex/values").GenericId<"contentTypes">;
+}, Promise<{
+    success: boolean;
+    deletedId: import("convex/values").GenericId<"contentTypes">;
+    deletedEntriesCount: number;
+    deletedVersionsCount: number;
+    wasHardDelete: boolean;
+}>>;
+export {};
+//# sourceMappingURL=contentTypeMutations.d.ts.map