convex-cms 0.0.1

package/dist/component/exportImport.d.ts

@@ -0,0 +1,1120 @@
+/**
+ * Content Export/Import Functions
+ *
+ * Provides functions to export content entries to JSON format and import from JSON.
+ * Supports selective export by type or filter, handles reference resolution, and
+ * validates imports against schemas.
+ *
+ * ## Export Features
+ * - Export all entries or filter by content type
+ * - Optionally resolve references to include related content
+ * - Support for status filtering (export only published, etc.)
+ * - Include content type definitions for schema validation during import
+ *
+ * ## Import Features
+ * - Validate all entries against content type schemas before import
+ * - Handle reference ID mapping (old IDs to new IDs)
+ * - Support for skip, update, or error on duplicate slugs
+ * - Dry-run mode to validate without making changes
+ *
+ * @example
+ * ```typescript
+ * // Export all published blog posts
+ * const exportData = await ctx.runQuery(api.exportImport.exportEntries, {
+ *   contentTypeName: "blog_post",
+ *   status: "published",
+ *   includeReferences: true,
+ * });
+ *
+ * // Import entries with conflict resolution
+ * const result = await ctx.runMutation(api.exportImport.importEntries, {
+ *   data: exportData,
+ *   onConflict: "skip",
+ *   importedBy: currentUserId,
+ * });
+ * ```
+ */
+import { Id } from "./_generated/dataModel.js";
+import { FieldDefinition } from "./validation.js";
+/**
+ * Structure for a single exported content entry.
+ * Includes all data needed to recreate the entry on import.
+ */
+export declare const exportedEntryValidator: import("convex/values").VObject<{
+    createdBy?: string | undefined;
+    locale?: string | undefined;
+    scheduledPublishAt?: number | undefined;
+    firstPublishedAt?: number | undefined;
+    lastPublishedAt?: number | undefined;
+    slug: string;
+    status: string;
+    data: any;
+    version: number;
+    createdAt: number;
+    contentTypeName: string;
+    _originalId: string;
+}, {
+    /** Original entry ID (for reference mapping) */
+    _originalId: import("convex/values").VString<string, "required">;
+    /** Content type name (machine-readable) */
+    contentTypeName: import("convex/values").VString<string, "required">;
+    /** URL-friendly slug */
+    slug: import("convex/values").VString<string, "required">;
+    /** Entry status at time of export */
+    status: import("convex/values").VString<string, "required">;
+    /** Content data */
+    data: import("convex/values").VAny<any, "required", string>;
+    /** Locale code if localized */
+    locale: import("convex/values").VString<string | undefined, "optional">;
+    /** Version number at time of export */
+    version: import("convex/values").VFloat64<number, "required">;
+    /** First published timestamp */
+    firstPublishedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** Last published timestamp */
+    lastPublishedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** Scheduled publish timestamp */
+    scheduledPublishAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    /** User who created the entry */
+    createdBy: import("convex/values").VString<string | undefined, "optional">;
+    /** Original creation timestamp */
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "createdBy" | "slug" | "status" | "data" | "locale" | "version" | "scheduledPublishAt" | "firstPublishedAt" | "lastPublishedAt" | `data.${string}` | "createdAt" | "contentTypeName" | "_originalId">;
+export type ExportedEntry = {
+    _originalId: string;
+    contentTypeName: string;
+    slug: string;
+    /** Content status (supports custom workflow states) */
+    status: string;
+    data: Record<string, unknown>;
+    locale?: string;
+    version: number;
+    firstPublishedAt?: number;
+    lastPublishedAt?: number;
+    scheduledPublishAt?: number;
+    createdBy?: string;
+    createdAt: number;
+};
+/**
+ * Structure for an exported content type definition.
+ * Allows importing schemas along with content.
+ * Uses exportedFieldDefinitionValidator which has string taxonomyId
+ * for portability across Convex deployments.
+ */
+export declare const exportedContentTypeValidator: import("convex/values").VObject<{
+    description?: string | undefined;
+    icon?: string | undefined;
+    singleton?: boolean | undefined;
+    slugField?: string | undefined;
+    titleField?: string | undefined;
+    fields: {
+        options?: {
+            options?: {
+                label: string;
+                value: string;
+            }[] | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            pattern?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            multiple?: boolean | undefined;
+            taxonomyId?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+            allowMultiple?: boolean | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: any;
+        required: boolean;
+        type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+        name: string;
+        label: string;
+    }[];
+    name: string;
+    displayName: string;
+}, {
+    /** Content type name (machine-readable) */
+    name: import("convex/values").VString<string, "required">;
+    /** Display name */
+    displayName: import("convex/values").VString<string, "required">;
+    /** Description */
+    description: import("convex/values").VString<string | undefined, "optional">;
+    /** Field definitions with portable types */
+    fields: import("convex/values").VArray<{
+        options?: {
+            options?: {
+                label: string;
+                value: string;
+            }[] | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            pattern?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            multiple?: boolean | undefined;
+            taxonomyId?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+            allowMultiple?: boolean | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: any;
+        required: boolean;
+        type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+        name: string;
+        label: string;
+    }[], import("convex/values").VObject<{
+        options?: {
+            options?: {
+                label: string;
+                value: string;
+            }[] | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            pattern?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            multiple?: boolean | undefined;
+            taxonomyId?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+            allowMultiple?: boolean | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined;
+        searchable?: boolean | undefined;
+        localized?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: any;
+        required: boolean;
+        type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+        name: string;
+        label: string;
+    }, {
+        name: import("convex/values").VString<string, "required">;
+        label: import("convex/values").VString<string, "required">;
+        type: import("convex/values").VUnion<"number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category", [import("convex/values").VLiteral<"text", "required">, import("convex/values").VLiteral<"richText", "required">, import("convex/values").VLiteral<"number", "required">, import("convex/values").VLiteral<"boolean", "required">, import("convex/values").VLiteral<"date", "required">, import("convex/values").VLiteral<"datetime", "required">, import("convex/values").VLiteral<"reference", "required">, import("convex/values").VLiteral<"media", "required">, import("convex/values").VLiteral<"json", "required">, import("convex/values").VLiteral<"select", "required">, import("convex/values").VLiteral<"multiSelect", "required">, import("convex/values").VLiteral<"tags", "required">, import("convex/values").VLiteral<"category", "required">], "required", never>;
+        required: import("convex/values").VBoolean<boolean, "required">;
+        searchable: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        localized: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        description: import("convex/values").VString<string | undefined, "optional">;
+        defaultValue: import("convex/values").VAny<any, "optional", string>;
+        options: import("convex/values").VObject<{
+            options?: {
+                label: string;
+                value: string;
+            }[] | undefined;
+            minLength?: number | undefined;
+            maxLength?: number | undefined;
+            pattern?: string | undefined;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            precision?: number | undefined;
+            allowedBlocks?: string[] | undefined;
+            allowedMarks?: string[] | undefined;
+            allowedMimeTypes?: string[] | undefined;
+            maxFileSize?: number | undefined;
+            multiple?: boolean | undefined;
+            taxonomyId?: string | undefined;
+            allowCreate?: boolean | undefined;
+            maxTags?: number | undefined;
+            minTags?: number | undefined;
+            allowMultiple?: boolean | undefined;
+            allowedContentTypes?: string[] | undefined;
+            minItems?: number | undefined;
+        } | undefined, {
+            minLength: import("convex/values").VFloat64<number | undefined, "optional">;
+            maxLength: import("convex/values").VFloat64<number | undefined, "optional">;
+            pattern: import("convex/values").VString<string | undefined, "optional">;
+            min: import("convex/values").VFloat64<number | undefined, "optional">;
+            max: import("convex/values").VFloat64<number | undefined, "optional">;
+            step: import("convex/values").VFloat64<number | undefined, "optional">;
+            precision: import("convex/values").VFloat64<number | undefined, "optional">;
+            allowedContentTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+            multiple: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            minItems: import("convex/values").VFloat64<number | undefined, "optional">;
+            allowedMimeTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+            maxFileSize: import("convex/values").VFloat64<number | undefined, "optional">;
+            options: import("convex/values").VArray<{
+                label: string;
+                value: string;
+            }[] | undefined, import("convex/values").VObject<{
+                label: string;
+                value: string;
+            }, {
+                value: import("convex/values").VString<string, "required">;
+                label: import("convex/values").VString<string, "required">;
+            }, "required", "label" | "value">, "optional">;
+            allowedBlocks: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+            allowedMarks: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+            taxonomyId: import("convex/values").VString<string | undefined, "optional">;
+            allowCreate: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            maxTags: import("convex/values").VFloat64<number | undefined, "optional">;
+            minTags: import("convex/values").VFloat64<number | undefined, "optional">;
+            allowMultiple: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        }, "optional", "options" | "minLength" | "maxLength" | "pattern" | "min" | "max" | "step" | "precision" | "allowedBlocks" | "allowedMarks" | "allowedMimeTypes" | "maxFileSize" | "multiple" | "taxonomyId" | "allowCreate" | "maxTags" | "minTags" | "allowMultiple" | "allowedContentTypes" | "minItems">;
+    }, "required", "required" | "type" | "options" | "name" | "label" | "searchable" | "localized" | "description" | "defaultValue" | "options.minLength" | "options.maxLength" | "options.pattern" | `defaultValue.${string}` | "options.min" | "options.max" | "options.step" | "options.precision" | "options.allowedBlocks" | "options.allowedMarks" | "options.allowedMimeTypes" | "options.maxFileSize" | "options.multiple" | "options.options" | "options.taxonomyId" | "options.allowCreate" | "options.maxTags" | "options.minTags" | "options.allowMultiple" | "options.allowedContentTypes" | "options.minItems">, "required">;
+    /** Icon identifier */
+    icon: import("convex/values").VString<string | undefined, "optional">;
+    /** Whether this is a singleton type */
+    singleton: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    /** Field to generate slugs from */
+    slugField: import("convex/values").VString<string | undefined, "optional">;
+    /** Field to use for display titles */
+    titleField: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "fields" | "name" | "description" | "displayName" | "icon" | "singleton" | "slugField" | "titleField">;
+export type ExportedContentType = {
+    name: string;
+    displayName: string;
+    description?: string;
+    fields: FieldDefinition[];
+    icon?: string;
+    singleton?: boolean;
+    slugField?: string;
+    titleField?: string;
+};
+/**
+ * Complete export package structure.
+ * Contains all information needed to import content into another instance.
+ */
+export declare const exportPackageValidator: import("convex/values").VObject<{
+    contentTypes?: {
+        description?: string | undefined;
+        icon?: string | undefined;
+        singleton?: boolean | undefined;
+        slugField?: string | undefined;
+        titleField?: string | undefined;
+        fields: {
+            options?: {
+                options?: {
+                    label: string;
+                    value: string;
+                }[] | undefined;
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                multiple?: boolean | undefined;
+                taxonomyId?: string | undefined;
+                allowCreate?: boolean | undefined;
+                maxTags?: number | undefined;
+                minTags?: number | undefined;
+                allowMultiple?: boolean | undefined;
+                allowedContentTypes?: string[] | undefined;
+                minItems?: number | undefined;
+            } | undefined;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            required: boolean;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+            name: string;
+            label: string;
+        }[];
+        name: string;
+        displayName: string;
+    }[] | undefined;
+    metadata?: {
+        description?: string | undefined;
+        source?: string | undefined;
+        entriesByType?: any;
+        totalEntries: number;
+    } | undefined;
+    entries: {
+        createdBy?: string | undefined;
+        locale?: string | undefined;
+        scheduledPublishAt?: number | undefined;
+        firstPublishedAt?: number | undefined;
+        lastPublishedAt?: number | undefined;
+        slug: string;
+        status: string;
+        data: any;
+        version: number;
+        createdAt: number;
+        contentTypeName: string;
+        _originalId: string;
+    }[];
+    version: "1.0";
+    exportedAt: number;
+}, {
+    /** Export format version for compatibility checking */
+    version: import("convex/values").VLiteral<"1.0", "required">;
+    /** Timestamp when export was created */
+    exportedAt: import("convex/values").VFloat64<number, "required">;
+    /** Content type definitions (optional, for schema validation) */
+    contentTypes: import("convex/values").VArray<{
+        description?: string | undefined;
+        icon?: string | undefined;
+        singleton?: boolean | undefined;
+        slugField?: string | undefined;
+        titleField?: string | undefined;
+        fields: {
+            options?: {
+                options?: {
+                    label: string;
+                    value: string;
+                }[] | undefined;
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                multiple?: boolean | undefined;
+                taxonomyId?: string | undefined;
+                allowCreate?: boolean | undefined;
+                maxTags?: number | undefined;
+                minTags?: number | undefined;
+                allowMultiple?: boolean | undefined;
+                allowedContentTypes?: string[] | undefined;
+                minItems?: number | undefined;
+            } | undefined;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            required: boolean;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+            name: string;
+            label: string;
+        }[];
+        name: string;
+        displayName: string;
+    }[] | undefined, import("convex/values").VObject<{
+        description?: string | undefined;
+        icon?: string | undefined;
+        singleton?: boolean | undefined;
+        slugField?: string | undefined;
+        titleField?: string | undefined;
+        fields: {
+            options?: {
+                options?: {
+                    label: string;
+                    value: string;
+                }[] | undefined;
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                multiple?: boolean | undefined;
+                taxonomyId?: string | undefined;
+                allowCreate?: boolean | undefined;
+                maxTags?: number | undefined;
+                minTags?: number | undefined;
+                allowMultiple?: boolean | undefined;
+                allowedContentTypes?: string[] | undefined;
+                minItems?: number | undefined;
+            } | undefined;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            required: boolean;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+            name: string;
+            label: string;
+        }[];
+        name: string;
+        displayName: string;
+    }, {
+        /** Content type name (machine-readable) */
+        name: import("convex/values").VString<string, "required">;
+        /** Display name */
+        displayName: import("convex/values").VString<string, "required">;
+        /** Description */
+        description: import("convex/values").VString<string | undefined, "optional">;
+        /** Field definitions with portable types */
+        fields: import("convex/values").VArray<{
+            options?: {
+                options?: {
+                    label: string;
+                    value: string;
+                }[] | undefined;
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                multiple?: boolean | undefined;
+                taxonomyId?: string | undefined;
+                allowCreate?: boolean | undefined;
+                maxTags?: number | undefined;
+                minTags?: number | undefined;
+                allowMultiple?: boolean | undefined;
+                allowedContentTypes?: string[] | undefined;
+                minItems?: number | undefined;
+            } | undefined;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            required: boolean;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+            name: string;
+            label: string;
+        }[], import("convex/values").VObject<{
+            options?: {
+                options?: {
+                    label: string;
+                    value: string;
+                }[] | undefined;
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                multiple?: boolean | undefined;
+                taxonomyId?: string | undefined;
+                allowCreate?: boolean | undefined;
+                maxTags?: number | undefined;
+                minTags?: number | undefined;
+                allowMultiple?: boolean | undefined;
+                allowedContentTypes?: string[] | undefined;
+                minItems?: number | undefined;
+            } | undefined;
+            searchable?: boolean | undefined;
+            localized?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: any;
+            required: boolean;
+            type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+            name: string;
+            label: string;
+        }, {
+            name: import("convex/values").VString<string, "required">;
+            label: import("convex/values").VString<string, "required">;
+            type: import("convex/values").VUnion<"number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category", [import("convex/values").VLiteral<"text", "required">, import("convex/values").VLiteral<"richText", "required">, import("convex/values").VLiteral<"number", "required">, import("convex/values").VLiteral<"boolean", "required">, import("convex/values").VLiteral<"date", "required">, import("convex/values").VLiteral<"datetime", "required">, import("convex/values").VLiteral<"reference", "required">, import("convex/values").VLiteral<"media", "required">, import("convex/values").VLiteral<"json", "required">, import("convex/values").VLiteral<"select", "required">, import("convex/values").VLiteral<"multiSelect", "required">, import("convex/values").VLiteral<"tags", "required">, import("convex/values").VLiteral<"category", "required">], "required", never>;
+            required: import("convex/values").VBoolean<boolean, "required">;
+            searchable: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            localized: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            description: import("convex/values").VString<string | undefined, "optional">;
+            defaultValue: import("convex/values").VAny<any, "optional", string>;
+            options: import("convex/values").VObject<{
+                options?: {
+                    label: string;
+                    value: string;
+                }[] | undefined;
+                minLength?: number | undefined;
+                maxLength?: number | undefined;
+                pattern?: string | undefined;
+                min?: number | undefined;
+                max?: number | undefined;
+                step?: number | undefined;
+                precision?: number | undefined;
+                allowedBlocks?: string[] | undefined;
+                allowedMarks?: string[] | undefined;
+                allowedMimeTypes?: string[] | undefined;
+                maxFileSize?: number | undefined;
+                multiple?: boolean | undefined;
+                taxonomyId?: string | undefined;
+                allowCreate?: boolean | undefined;
+                maxTags?: number | undefined;
+                minTags?: number | undefined;
+                allowMultiple?: boolean | undefined;
+                allowedContentTypes?: string[] | undefined;
+                minItems?: number | undefined;
+            } | undefined, {
+                minLength: import("convex/values").VFloat64<number | undefined, "optional">;
+                maxLength: import("convex/values").VFloat64<number | undefined, "optional">;
+                pattern: import("convex/values").VString<string | undefined, "optional">;
+                min: import("convex/values").VFloat64<number | undefined, "optional">;
+                max: import("convex/values").VFloat64<number | undefined, "optional">;
+                step: import("convex/values").VFloat64<number | undefined, "optional">;
+                precision: import("convex/values").VFloat64<number | undefined, "optional">;
+                allowedContentTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+                multiple: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                minItems: import("convex/values").VFloat64<number | undefined, "optional">;
+                allowedMimeTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+                maxFileSize: import("convex/values").VFloat64<number | undefined, "optional">;
+                options: import("convex/values").VArray<{
+                    label: string;
+                    value: string;
+                }[] | undefined, import("convex/values").VObject<{
+                    label: string;
+                    value: string;
+                }, {
+                    value: import("convex/values").VString<string, "required">;
+                    label: import("convex/values").VString<string, "required">;
+                }, "required", "label" | "value">, "optional">;
+                allowedBlocks: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+                allowedMarks: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+                taxonomyId: import("convex/values").VString<string | undefined, "optional">;
+                allowCreate: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                maxTags: import("convex/values").VFloat64<number | undefined, "optional">;
+                minTags: import("convex/values").VFloat64<number | undefined, "optional">;
+                allowMultiple: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            }, "optional", "options" | "minLength" | "maxLength" | "pattern" | "min" | "max" | "step" | "precision" | "allowedBlocks" | "allowedMarks" | "allowedMimeTypes" | "maxFileSize" | "multiple" | "taxonomyId" | "allowCreate" | "maxTags" | "minTags" | "allowMultiple" | "allowedContentTypes" | "minItems">;
+        }, "required", "required" | "type" | "options" | "name" | "label" | "searchable" | "localized" | "description" | "defaultValue" | "options.minLength" | "options.maxLength" | "options.pattern" | `defaultValue.${string}` | "options.min" | "options.max" | "options.step" | "options.precision" | "options.allowedBlocks" | "options.allowedMarks" | "options.allowedMimeTypes" | "options.maxFileSize" | "options.multiple" | "options.options" | "options.taxonomyId" | "options.allowCreate" | "options.maxTags" | "options.minTags" | "options.allowMultiple" | "options.allowedContentTypes" | "options.minItems">, "required">;
+        /** Icon identifier */
+        icon: import("convex/values").VString<string | undefined, "optional">;
+        /** Whether this is a singleton type */
+        singleton: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        /** Field to generate slugs from */
+        slugField: import("convex/values").VString<string | undefined, "optional">;
+        /** Field to use for display titles */
+        titleField: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "fields" | "name" | "description" | "displayName" | "icon" | "singleton" | "slugField" | "titleField">, "optional">;
+    /** Exported entries */
+    entries: import("convex/values").VArray<{
+        createdBy?: string | undefined;
+        locale?: string | undefined;
+        scheduledPublishAt?: number | undefined;
+        firstPublishedAt?: number | undefined;
+        lastPublishedAt?: number | undefined;
+        slug: string;
+        status: string;
+        data: any;
+        version: number;
+        createdAt: number;
+        contentTypeName: string;
+        _originalId: string;
+    }[], import("convex/values").VObject<{
+        createdBy?: string | undefined;
+        locale?: string | undefined;
+        scheduledPublishAt?: number | undefined;
+        firstPublishedAt?: number | undefined;
+        lastPublishedAt?: number | undefined;
+        slug: string;
+        status: string;
+        data: any;
+        version: number;
+        createdAt: number;
+        contentTypeName: string;
+        _originalId: string;
+    }, {
+        /** Original entry ID (for reference mapping) */
+        _originalId: import("convex/values").VString<string, "required">;
+        /** Content type name (machine-readable) */
+        contentTypeName: import("convex/values").VString<string, "required">;
+        /** URL-friendly slug */
+        slug: import("convex/values").VString<string, "required">;
+        /** Entry status at time of export */
+        status: import("convex/values").VString<string, "required">;
+        /** Content data */
+        data: import("convex/values").VAny<any, "required", string>;
+        /** Locale code if localized */
+        locale: import("convex/values").VString<string | undefined, "optional">;
+        /** Version number at time of export */
+        version: import("convex/values").VFloat64<number, "required">;
+        /** First published timestamp */
+        firstPublishedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        /** Last published timestamp */
+        lastPublishedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        /** Scheduled publish timestamp */
+        scheduledPublishAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        /** User who created the entry */
+        createdBy: import("convex/values").VString<string | undefined, "optional">;
+        /** Original creation timestamp */
+        createdAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "createdBy" | "slug" | "status" | "data" | "locale" | "version" | "scheduledPublishAt" | "firstPublishedAt" | "lastPublishedAt" | `data.${string}` | "createdAt" | "contentTypeName" | "_originalId">, "required">;
+    /** Metadata about the export */
+    metadata: import("convex/values").VObject<{
+        description?: string | undefined;
+        source?: string | undefined;
+        entriesByType?: any;
+        totalEntries: number;
+    } | undefined, {
+        /** Source system identifier */
+        source: import("convex/values").VString<string | undefined, "optional">;
+        /** Export description */
+        description: import("convex/values").VString<string | undefined, "optional">;
+        /** Total count of entries */
+        totalEntries: import("convex/values").VFloat64<number, "required">;
+        /** Breakdown by content type */
+        entriesByType: import("convex/values").VAny<any, "optional", string>;
+    }, "optional", "description" | "source" | "totalEntries" | "entriesByType" | `entriesByType.${string}`>;
+}, "required", "entries" | "contentTypes" | "metadata" | "version" | "exportedAt" | "metadata.description" | "metadata.source" | "metadata.totalEntries" | "metadata.entriesByType" | `metadata.entriesByType.${string}`>;
+export type ExportPackage = {
+    version: "1.0";
+    exportedAt: number;
+    contentTypes?: ExportedContentType[];
+    entries: ExportedEntry[];
+    metadata?: {
+        source?: string;
+        description?: string;
+        totalEntries: number;
+        entriesByType?: Record<string, number>;
+    };
+};
+/**
+ * Conflict resolution strategy for imports.
+ * - "skip": Skip entries with conflicting slugs
+ * - "update": Update existing entries with new data
+ * - "error": Fail the entire import if any conflicts exist
+ */
+export declare const conflictStrategyValidator: import("convex/values").VUnion<"error" | "skip" | "update", [import("convex/values").VLiteral<"skip", "required">, import("convex/values").VLiteral<"update", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
+export type ConflictStrategy = "skip" | "update" | "error";
+/**
+ * Result for a single imported entry.
+ */
+export declare const importEntryResultValidator: import("convex/values").VObject<{
+    error?: string | undefined;
+    newId?: import("convex/values").GenericId<"contentEntries"> | undefined;
+    slug: string;
+    action: "failed" | "created" | "updated" | "skipped";
+    contentTypeName: string;
+    originalId: string;
+}, {
+    /** Original ID from export */
+    originalId: import("convex/values").VString<string, "required">;
+    /** New ID after import (if created/updated) */
+    newId: import("convex/values").VId<import("convex/values").GenericId<"contentEntries"> | undefined, "optional">;
+    /** Import action taken */
+    action: import("convex/values").VUnion<"failed" | "created" | "updated" | "skipped", [import("convex/values").VLiteral<"created", "required">, import("convex/values").VLiteral<"updated", "required">, import("convex/values").VLiteral<"skipped", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
+    /** Error message if failed */
+    error: import("convex/values").VString<string | undefined, "optional">;
+    /** Slug of the entry */
+    slug: import("convex/values").VString<string, "required">;
+    /** Content type name */
+    contentTypeName: import("convex/values").VString<string, "required">;
+}, "required", "slug" | "action" | "error" | "contentTypeName" | "originalId" | "newId">;
+export type ImportEntryResult = {
+    originalId: string;
+    newId?: Id<"contentEntries">;
+    action: "created" | "updated" | "skipped" | "failed";
+    error?: string;
+    slug: string;
+    contentTypeName: string;
+};
+/**
+ * Complete import result.
+ */
+export declare const importResultValidator: import("convex/values").VObject<{
+    validationErrors?: string[] | undefined;
+    failed: number;
+    created: number;
+    updated: number;
+    success: boolean;
+    results: {
+        error?: string | undefined;
+        newId?: import("convex/values").GenericId<"contentEntries"> | undefined;
+        slug: string;
+        action: "failed" | "created" | "updated" | "skipped";
+        contentTypeName: string;
+        originalId: string;
+    }[];
+    skipped: number;
+    totalProcessed: number;
+    idMapping: any;
+}, {
+    /** Whether import was successful */
+    success: import("convex/values").VBoolean<boolean, "required">;
+    /** Total entries processed */
+    totalProcessed: import("convex/values").VFloat64<number, "required">;
+    /** Number of entries created */
+    created: import("convex/values").VFloat64<number, "required">;
+    /** Number of entries updated */
+    updated: import("convex/values").VFloat64<number, "required">;
+    /** Number of entries skipped */
+    skipped: import("convex/values").VFloat64<number, "required">;
+    /** Number of entries failed */
+    failed: import("convex/values").VFloat64<number, "required">;
+    /** Detailed results for each entry */
+    results: import("convex/values").VArray<{
+        error?: string | undefined;
+        newId?: import("convex/values").GenericId<"contentEntries"> | undefined;
+        slug: string;
+        action: "failed" | "created" | "updated" | "skipped";
+        contentTypeName: string;
+        originalId: string;
+    }[], import("convex/values").VObject<{
+        error?: string | undefined;
+        newId?: import("convex/values").GenericId<"contentEntries"> | undefined;
+        slug: string;
+        action: "failed" | "created" | "updated" | "skipped";
+        contentTypeName: string;
+        originalId: string;
+    }, {
+        /** Original ID from export */
+        originalId: import("convex/values").VString<string, "required">;
+        /** New ID after import (if created/updated) */
+        newId: import("convex/values").VId<import("convex/values").GenericId<"contentEntries"> | undefined, "optional">;
+        /** Import action taken */
+        action: import("convex/values").VUnion<"failed" | "created" | "updated" | "skipped", [import("convex/values").VLiteral<"created", "required">, import("convex/values").VLiteral<"updated", "required">, import("convex/values").VLiteral<"skipped", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
+        /** Error message if failed */
+        error: import("convex/values").VString<string | undefined, "optional">;
+        /** Slug of the entry */
+        slug: import("convex/values").VString<string, "required">;
+        /** Content type name */
+        contentTypeName: import("convex/values").VString<string, "required">;
+    }, "required", "slug" | "action" | "error" | "contentTypeName" | "originalId" | "newId">, "required">;
+    /** ID mapping from old to new IDs (for reference updates) */
+    idMapping: import("convex/values").VAny<any, "required", string>;
+    /** Validation errors encountered */
+    validationErrors: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+}, "required", "failed" | "created" | "updated" | "success" | "results" | "skipped" | "totalProcessed" | "idMapping" | "validationErrors" | `idMapping.${string}`>;
+export type ImportResult = {
+    success: boolean;
+    totalProcessed: number;
+    created: number;
+    updated: number;
+    skipped: number;
+    failed: number;
+    results: ImportEntryResult[];
+    idMapping: Record<string, string>;
+    validationErrors?: string[];
+};
+/**
+ * Export content entries to a JSON-serializable package.
+ *
+ * This query retrieves content entries matching the specified filters and
+ * packages them into a format suitable for import into another system.
+ *
+ * ## Features
+ * - Filter by content type, status, or locale
+ * - Optionally include content type definitions for schema validation
+ * - Preserves original IDs for reference mapping during import
+ * - Includes metadata about the export for traceability
+ *
+ * @param contentTypeId - Filter by content type ID
+ * @param contentTypeName - Filter by content type name (alternative to ID)
+ * @param status - Filter by single status
+ * @param statusIn - Filter by multiple statuses
+ * @param locale - Filter by locale code
+ * @param includeContentTypes - Include content type definitions (default: true)
+ * @param includeDeleted - Include soft-deleted entries (default: false)
+ * @param limit - Maximum entries to export (default: 1000)
+ * @param description - Description for export metadata
+ * @param source - Source identifier for export metadata
+ *
+ * @returns ExportPackage containing entries and optional content types
+ *
+ * @example
+ * ```typescript
+ * // Export all published blog posts
+ * const exportData = await ctx.runQuery(api.exportImport.exportEntries, {
+ *   contentTypeName: "blog_post",
+ *   status: "published",
+ *   includeContentTypes: true,
+ * });
+ *
+ * // Export all entries of all types
+ * const allData = await ctx.runQuery(api.exportImport.exportEntries, {
+ *   limit: 5000,
+ *   description: "Full site backup",
+ * });
+ * ```
+ */
+export declare const exportEntries: import("convex/server").RegisteredQuery<"public", {
+    description?: string | undefined;
+    contentTypeId?: import("convex/values").GenericId<"contentTypes"> | undefined;
+    status?: string | undefined;
+    locale?: string | undefined;
+    includeDeleted?: boolean | undefined;
+    contentTypeName?: string | undefined;
+    statusIn?: string[] | undefined;
+    limit?: number | undefined;
+    includeContentTypes?: boolean | undefined;
+    source?: string | undefined;
+}, Promise<{
+    version: "1.0";
+    exportedAt: number;
+    contentTypes: ExportedContentType[] | undefined;
+    entries: ExportedEntry[];
+    metadata: {
+        source: string | undefined;
+        description: string | undefined;
+        totalEntries: number;
+        entriesByType: Record<string, number>;
+    };
+}>>;
+/**
+ * Import content entries from an export package.
+ *
+ * This mutation validates and imports content entries from an export package.
+ * It supports conflict resolution, dry-run mode, and reference ID mapping.
+ *
+ * ## Features
+ * - Validates all entries against content type schemas before import
+ * - Maps old reference IDs to new IDs for reference fields
+ * - Supports skip, update, or error on slug conflicts
+ * - Dry-run mode validates without making changes
+ * - Preserves or resets entry status
+ *
+ * ## Import Process
+ * 1. Validate all entries against existing content type schemas
+ * 2. Check for slug conflicts based on onConflict strategy
+ * 3. Create or update entries, collecting ID mappings
+ * 4. Update reference fields with new IDs (second pass)
+ *
+ * @param data - The export package to import
+ * @param onConflict - How to handle slug conflicts (default: "skip")
+ * @param preserveStatus - Keep original status or set to draft (default: false)
+ * @param dryRun - Validate only without making changes (default: false)
+ * @param importedBy - User ID for audit trail
+ * @param contentTypeFilter - Only import entries of these content types
+ *
+ * @returns ImportResult with details of the import operation
+ *
+ * @example
+ * ```typescript
+ * // Dry run to validate import
+ * const validation = await ctx.runMutation(api.exportImport.importEntries, {
+ *   data: exportPackage,
+ *   dryRun: true,
+ * });
+ *
+ * // Import with skip on conflicts
+ * const result = await ctx.runMutation(api.exportImport.importEntries, {
+ *   data: exportPackage,
+ *   onConflict: "skip",
+ *   preserveStatus: true,
+ *   importedBy: currentUserId,
+ * });
+ * ```
+ */
+export declare const importEntries: import("convex/server").RegisteredMutation<"public", {
+    dryRun?: boolean | undefined;
+    contentTypeFilter?: string[] | undefined;
+    importedBy?: string | undefined;
+    onConflict?: "error" | "skip" | "update" | undefined;
+    preserveStatus?: boolean | undefined;
+    data: {
+        contentTypes?: {
+            description?: string | undefined;
+            icon?: string | undefined;
+            singleton?: boolean | undefined;
+            slugField?: string | undefined;
+            titleField?: string | undefined;
+            fields: {
+                options?: {
+                    options?: {
+                        label: string;
+                        value: string;
+                    }[] | undefined;
+                    minLength?: number | undefined;
+                    maxLength?: number | undefined;
+                    pattern?: string | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    step?: number | undefined;
+                    precision?: number | undefined;
+                    allowedBlocks?: string[] | undefined;
+                    allowedMarks?: string[] | undefined;
+                    allowedMimeTypes?: string[] | undefined;
+                    maxFileSize?: number | undefined;
+                    multiple?: boolean | undefined;
+                    taxonomyId?: string | undefined;
+                    allowCreate?: boolean | undefined;
+                    maxTags?: number | undefined;
+                    minTags?: number | undefined;
+                    allowMultiple?: boolean | undefined;
+                    allowedContentTypes?: string[] | undefined;
+                    minItems?: number | undefined;
+                } | undefined;
+                searchable?: boolean | undefined;
+                localized?: boolean | undefined;
+                description?: string | undefined;
+                defaultValue?: any;
+                required: boolean;
+                type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+                name: string;
+                label: string;
+            }[];
+            name: string;
+            displayName: string;
+        }[] | undefined;
+        metadata?: {
+            description?: string | undefined;
+            source?: string | undefined;
+            entriesByType?: any;
+            totalEntries: number;
+        } | undefined;
+        entries: {
+            createdBy?: string | undefined;
+            locale?: string | undefined;
+            scheduledPublishAt?: number | undefined;
+            firstPublishedAt?: number | undefined;
+            lastPublishedAt?: number | undefined;
+            slug: string;
+            status: string;
+            data: any;
+            version: number;
+            createdAt: number;
+            contentTypeName: string;
+            _originalId: string;
+        }[];
+        version: "1.0";
+        exportedAt: number;
+    };
+}, Promise<{
+    success: boolean;
+    totalProcessed: number;
+    created: number;
+    updated: number;
+    skipped: number;
+    failed: number;
+    results: ImportEntryResult[];
+    idMapping: Record<string, string>;
+    validationErrors: string[] | undefined;
+}>>;
+/**
+ * Get a summary of content that would be exported without actually exporting.
+ *
+ * This is useful for previewing what an export would contain before
+ * running the full export operation.
+ */
+export declare const getExportPreview: import("convex/server").RegisteredQuery<"public", {
+    contentTypeId?: import("convex/values").GenericId<"contentTypes"> | undefined;
+    status?: string | undefined;
+    locale?: string | undefined;
+    includeDeleted?: boolean | undefined;
+    contentTypeName?: string | undefined;
+    statusIn?: string[] | undefined;
+}, Promise<{
+    totalEntries: number;
+    entriesByType: Record<string, number>;
+    entriesByStatus: Record<string, number>;
+    contentTypes: string[];
+}>>;
+/**
+ * Validate an export package without importing.
+ *
+ * Checks that all entries can be validated against existing content type
+ * schemas and reports any issues that would occur during import.
+ */
+export declare const validateImportPackage: import("convex/server").RegisteredQuery<"public", {
+    contentTypeFilter?: string[] | undefined;
+    data: {
+        contentTypes?: {
+            description?: string | undefined;
+            icon?: string | undefined;
+            singleton?: boolean | undefined;
+            slugField?: string | undefined;
+            titleField?: string | undefined;
+            fields: {
+                options?: {
+                    options?: {
+                        label: string;
+                        value: string;
+                    }[] | undefined;
+                    minLength?: number | undefined;
+                    maxLength?: number | undefined;
+                    pattern?: string | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    step?: number | undefined;
+                    precision?: number | undefined;
+                    allowedBlocks?: string[] | undefined;
+                    allowedMarks?: string[] | undefined;
+                    allowedMimeTypes?: string[] | undefined;
+                    maxFileSize?: number | undefined;
+                    multiple?: boolean | undefined;
+                    taxonomyId?: string | undefined;
+                    allowCreate?: boolean | undefined;
+                    maxTags?: number | undefined;
+                    minTags?: number | undefined;
+                    allowMultiple?: boolean | undefined;
+                    allowedContentTypes?: string[] | undefined;
+                    minItems?: number | undefined;
+                } | undefined;
+                searchable?: boolean | undefined;
+                localized?: boolean | undefined;
+                description?: string | undefined;
+                defaultValue?: any;
+                required: boolean;
+                type: "number" | "boolean" | "text" | "richText" | "date" | "datetime" | "reference" | "media" | "json" | "select" | "multiSelect" | "tags" | "category";
+                name: string;
+                label: string;
+            }[];
+            name: string;
+            displayName: string;
+        }[] | undefined;
+        metadata?: {
+            description?: string | undefined;
+            source?: string | undefined;
+            entriesByType?: any;
+            totalEntries: number;
+        } | undefined;
+        entries: {
+            createdBy?: string | undefined;
+            locale?: string | undefined;
+            scheduledPublishAt?: number | undefined;
+            firstPublishedAt?: number | undefined;
+            lastPublishedAt?: number | undefined;
+            slug: string;
+            status: string;
+            data: any;
+            version: number;
+            createdAt: number;
+            contentTypeName: string;
+            _originalId: string;
+        }[];
+        version: "1.0";
+        exportedAt: number;
+    };
+}, Promise<{
+    valid: boolean;
+    totalEntries: number;
+    validEntries: number;
+    invalidEntries: number;
+    missingContentTypes: string[];
+    validationErrors: {
+        slug: string;
+        contentTypeName: string;
+        errors: string[];
+    }[];
+}>>;
+//# sourceMappingURL=exportImport.d.ts.map