@constructive-io/react 1.19.2 → 1.19.3

package/esm/storage/schema-types.d.ts

@@ -0,0 +1,1288 @@
+/**
+ * GraphQL schema types for custom operations
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { Bucket, File, PlatformBucket, PlatformFile, BigIntFilter, BooleanFilter, DatetimeFilter, StringFilter, StringListFilter, UUIDFilter } from './types';
+export type ConstructiveInternalTypeUpload = unknown;
+/** Methods to use when ordering `Bucket`. */
+export type BucketOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ALLOWED_MIME_TYPES_ASC' | 'ALLOWED_MIME_TYPES_DESC' | 'ALLOWED_ORIGINS_ASC' | 'ALLOWED_ORIGINS_DESC' | 'ALLOW_CUSTOM_KEYS_ASC' | 'ALLOW_CUSTOM_KEYS_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'DESTINATION_BUCKET_ID_ASC' | 'DESTINATION_BUCKET_ID_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MAX_FILE_SIZE_ASC' | 'MAX_FILE_SIZE_DESC' | 'NATURAL' | 'PHYSICAL_NAME_ASC' | 'PHYSICAL_NAME_DESC' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'STAGING_TTL_ASC' | 'STAGING_TTL_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'TYPE_ASC' | 'TYPE_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
+export type BucketType = 'PRIVATE' | 'PUBLIC' | 'TEMP';
+/** Methods to use when ordering `File`. */
+export type FileOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'BUCKET_ID_ASC' | 'BUCKET_ID_DESC' | 'CONTENT_HASH_ASC' | 'CONTENT_HASH_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DATABASE_ID_ASC' | 'DATABASE_ID_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'EXPIRY_ENQUEUED_AT_ASC' | 'EXPIRY_ENQUEUED_AT_DESC' | 'FILENAME_ASC' | 'FILENAME_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MIME_TYPE_ASC' | 'MIME_TYPE_DESC' | 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'PROMOTED_AT_ASC' | 'PROMOTED_AT_DESC' | 'SIZE_ASC' | 'SIZE_DESC' | 'STATUS_ASC' | 'STATUS_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'UPLOAD_ASC' | 'UPLOAD_DESC';
+export type FileStatus = 'EXPIRED' | 'PROCESSED' | 'REJECTED' | 'REQUESTED' | 'UPLOADED';
+/** Methods to use when ordering `PlatformBucket`. */
+export type PlatformBucketOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'ALLOWED_MIME_TYPES_ASC' | 'ALLOWED_MIME_TYPES_DESC' | 'ALLOWED_ORIGINS_ASC' | 'ALLOWED_ORIGINS_DESC' | 'ALLOW_CUSTOM_KEYS_ASC' | 'ALLOW_CUSTOM_KEYS_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'DESTINATION_BUCKET_ID_ASC' | 'DESTINATION_BUCKET_ID_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MAX_FILE_SIZE_ASC' | 'MAX_FILE_SIZE_DESC' | 'NATURAL' | 'PHYSICAL_NAME_ASC' | 'PHYSICAL_NAME_DESC' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'STAGING_TTL_ASC' | 'STAGING_TTL_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'TYPE_ASC' | 'TYPE_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC';
+/** Methods to use when ordering `PlatformFile`. */
+export type PlatformFileOrderBy = 'ACTOR_ID_ASC' | 'ACTOR_ID_DESC' | 'BUCKET_ID_ASC' | 'BUCKET_ID_DESC' | 'CONTENT_HASH_ASC' | 'CONTENT_HASH_DESC' | 'CREATED_AT_ASC' | 'CREATED_AT_DESC' | 'DESCRIPTION_ASC' | 'DESCRIPTION_DESC' | 'EXPIRY_ENQUEUED_AT_ASC' | 'EXPIRY_ENQUEUED_AT_DESC' | 'FILENAME_ASC' | 'FILENAME_DESC' | 'ID_ASC' | 'ID_DESC' | 'IS_PUBLIC_ASC' | 'IS_PUBLIC_DESC' | 'KEY_ASC' | 'KEY_DESC' | 'MIME_TYPE_ASC' | 'MIME_TYPE_DESC' | 'NATURAL' | 'PRIMARY_KEY_ASC' | 'PRIMARY_KEY_DESC' | 'PROMOTED_AT_ASC' | 'PROMOTED_AT_DESC' | 'SIZE_ASC' | 'SIZE_DESC' | 'STATUS_ASC' | 'STATUS_DESC' | 'TAGS_ASC' | 'TAGS_DESC' | 'UPDATED_AT_ASC' | 'UPDATED_AT_DESC' | 'UPLOAD_ASC' | 'UPLOAD_DESC';
+/** A filter to be used against `Bucket` object types. All fields are combined with a logical ‘and.’ */
+export interface BucketFilter {
+    /** Filter by the object’s `actorId` field. */
+    actorId?: UUIDFilter;
+    /** Filter by the object’s `allowCustomKeys` field. */
+    allowCustomKeys?: BooleanFilter;
+    /** Filter by the object’s `allowedMimeTypes` field. */
+    allowedMimeTypes?: StringListFilter;
+    /** Filter by the object’s `allowedOrigins` field. */
+    allowedOrigins?: StringListFilter;
+    /** Checks for all expressions in this list. */
+    and?: BucketFilter[];
+    /** Filter by the object’s `bucketsByDestinationBucketId` relation. */
+    bucketsByDestinationBucketId?: BucketToManyBucketFilter;
+    /** `bucketsByDestinationBucketId` exist. */
+    bucketsByDestinationBucketIdExist?: boolean;
+    /** Filter by the object’s `createdAt` field. */
+    createdAt?: DatetimeFilter;
+    /** Filter by the object’s `databaseId` field. */
+    databaseId?: UUIDFilter;
+    /** Filter by the object’s `description` field. */
+    description?: StringFilter;
+    /** Filter by the object’s `destinationBucket` relation. */
+    destinationBucket?: BucketFilter;
+    /** A related `destinationBucket` exists. */
+    destinationBucketExists?: boolean;
+    /** Filter by the object’s `destinationBucketId` field. */
+    destinationBucketId?: UUIDFilter;
+    /** Filter by the object’s `files` relation. */
+    files?: BucketToManyFileFilter;
+    /** `files` exist. */
+    filesExist?: boolean;
+    /** Filter by the object’s `id` field. */
+    id?: UUIDFilter;
+    /** Filter by the object’s `isPublic` field. */
+    isPublic?: BooleanFilter;
+    /** Filter by the object’s `key` field. */
+    key?: StringFilter;
+    /** Filter by the object’s `maxFileSize` field. */
+    maxFileSize?: BigIntFilter;
+    /** Negates the expression. */
+    not?: BucketFilter;
+    /** Checks for any expressions in this list. */
+    or?: BucketFilter[];
+    /** Filter by the object’s `physicalName` field. */
+    physicalName?: StringFilter;
+    /** Filter by the object’s `stagingTtl` field. */
+    stagingTtl?: IntervalFilter;
+    /** Filter by the object’s `tags` field. */
+    tags?: StringListFilter;
+    /** Filter by the object’s `type` field. */
+    type?: BucketTypeFilter;
+    /** Filter by the object’s `updatedAt` field. */
+    updatedAt?: DatetimeFilter;
+}
+/** An input for mutations affecting `Bucket` */
+export interface BucketInput {
+    /** User who created this bucket. Forced to current_user_id() on INSERT. */
+    actorId: string;
+    /** When true, clients can provide custom S3 keys (e.g. reports/2024/Q1.pdf). When false (default), S3 key = content hash (automatic dedup). contentHash always required for integrity. */
+    allowCustomKeys?: boolean;
+    /** Whitelist of allowed MIME types for files in this bucket (NULL = all allowed, enforcement deferred) */
+    allowedMimeTypes?: string[];
+    /** Per-bucket CORS allowed origins override (NULL = inherit from storage_module/plugin defaults). Use ARRAY['*'] for open/CDN mode. */
+    allowedOrigins?: string[];
+    createdAt?: string;
+    /** Database that owns this resource (database-scoped isolation) */
+    databaseId: string;
+    /** Human-readable description of the bucket purpose */
+    description?: string;
+    /** For a temp bucket, the permanent bucket its uploads are promoted into. NULL on non-temp buckets; required on temp buckets. */
+    destinationBucketId?: string;
+    id?: string;
+    /** Whether bucket contents are publicly readable. Set to true when type is public. */
+    isPublic?: boolean;
+    /** Unique bucket identifier used in S3 key paths (e.g. avatars, documents, temp) */
+    key: string;
+    /** Maximum file size in bytes allowed in this bucket (NULL = no limit, enforcement deferred) */
+    maxFileSize?: string;
+    /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
+    physicalName?: string;
+    /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
+    stagingTtl?: IntervalInput;
+    /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
+    tags?: string[];
+    /** Bucket CDN access type: public (CDN-served), private (presigned GET), temp (staging uploads) */
+    type?: BucketType;
+    updatedAt?: string;
+}
+/** Represents an update to a `Bucket`. Fields that are set will be updated. */
+export interface BucketPatch {
+    /** User who created this bucket. Forced to current_user_id() on INSERT. */
+    actorId?: string;
+    /** When true, clients can provide custom S3 keys (e.g. reports/2024/Q1.pdf). When false (default), S3 key = content hash (automatic dedup). contentHash always required for integrity. */
+    allowCustomKeys?: boolean;
+    /** Whitelist of allowed MIME types for files in this bucket (NULL = all allowed, enforcement deferred) */
+    allowedMimeTypes?: string[];
+    /** Per-bucket CORS allowed origins override (NULL = inherit from storage_module/plugin defaults). Use ARRAY['*'] for open/CDN mode. */
+    allowedOrigins?: string[];
+    createdAt?: string;
+    /** Database that owns this resource (database-scoped isolation) */
+    databaseId?: string;
+    /** Human-readable description of the bucket purpose */
+    description?: string;
+    /** For a temp bucket, the permanent bucket its uploads are promoted into. NULL on non-temp buckets; required on temp buckets. */
+    destinationBucketId?: string;
+    id?: string;
+    /** Whether bucket contents are publicly readable. Set to true when type is public. */
+    isPublic?: boolean;
+    /** Unique bucket identifier used in S3 key paths (e.g. avatars, documents, temp) */
+    key?: string;
+    /** Maximum file size in bytes allowed in this bucket (NULL = no limit, enforcement deferred) */
+    maxFileSize?: string;
+    /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
+    physicalName?: string;
+    /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
+    stagingTtl?: IntervalInput;
+    /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
+    tags?: string[];
+    /** Bucket CDN access type: public (CDN-served), private (presigned GET), temp (staging uploads) */
+    type?: BucketType;
+    updatedAt?: string;
+}
+/** A filter to be used against many `Bucket` object types. All fields are combined with a logical ‘and.’ */
+export interface BucketToManyBucketFilter {
+    /** Filters to entities where every related entity matches. */
+    every?: BucketFilter;
+    /** Filters to entities where no related entity matches. */
+    none?: BucketFilter;
+    /** Filters to entities where at least one related entity matches. */
+    some?: BucketFilter;
+}
+/** A filter to be used against many `File` object types. All fields are combined with a logical ‘and.’ */
+export interface BucketToManyFileFilter {
+    /** Filters to entities where every related entity matches. */
+    every?: FileFilter;
+    /** Filters to entities where no related entity matches. */
+    none?: FileFilter;
+    /** Filters to entities where at least one related entity matches. */
+    some?: FileFilter;
+}
+/** A filter to be used against BucketType fields. All fields are combined with a logical ‘and.’ */
+export interface BucketTypeFilter {
+    /** Not equal to the specified value, treating null like an ordinary value. */
+    distinctFrom?: BucketType;
+    /** Equal to the specified value. */
+    equalTo?: BucketType;
+    /** Greater than the specified value. */
+    greaterThan?: BucketType;
+    /** Greater than or equal to the specified value. */
+    greaterThanOrEqualTo?: BucketType;
+    /** Included in the specified list. */
+    in?: BucketType[];
+    /** Is null (if `true` is specified) or is not null (if `false` is specified). */
+    isNull?: boolean;
+    /** Less than the specified value. */
+    lessThan?: BucketType;
+    /** Less than or equal to the specified value. */
+    lessThanOrEqualTo?: BucketType;
+    /** Equal to the specified value, treating null like an ordinary value. */
+    notDistinctFrom?: BucketType;
+    /** Not equal to the specified value. */
+    notEqualTo?: BucketType;
+    /** Not included in the specified list. */
+    notIn?: BucketType[];
+}
+/** A filter to be used against ConstructiveInternalTypeUpload fields. All fields are combined with a logical ‘and.’ */
+export interface ConstructiveInternalTypeUploadFilter {
+    /** Contained by the specified JSON. */
+    containedBy?: ConstructiveInternalTypeUpload;
+    /** Contains the specified JSON. */
+    contains?: ConstructiveInternalTypeUpload;
+    /** Contains all of the specified keys. */
+    containsAllKeys?: string[];
+    /** Contains any of the specified keys. */
+    containsAnyKeys?: string[];
+    /** Contains the specified key. */
+    containsKey?: string;
+    /** Not equal to the specified value, treating null like an ordinary value. */
+    distinctFrom?: ConstructiveInternalTypeUpload;
+    /** Equal to the specified value. */
+    equalTo?: ConstructiveInternalTypeUpload;
+    /** Greater than the specified value. */
+    greaterThan?: ConstructiveInternalTypeUpload;
+    /** Greater than or equal to the specified value. */
+    greaterThanOrEqualTo?: ConstructiveInternalTypeUpload;
+    /** Included in the specified list. */
+    in?: ConstructiveInternalTypeUpload[];
+    /** Is null (if `true` is specified) or is not null (if `false` is specified). */
+    isNull?: boolean;
+    /** Less than the specified value. */
+    lessThan?: ConstructiveInternalTypeUpload;
+    /** Less than or equal to the specified value. */
+    lessThanOrEqualTo?: ConstructiveInternalTypeUpload;
+    /** Equal to the specified value, treating null like an ordinary value. */
+    notDistinctFrom?: ConstructiveInternalTypeUpload;
+    /** Not equal to the specified value. */
+    notEqualTo?: ConstructiveInternalTypeUpload;
+    /** Not included in the specified list. */
+    notIn?: ConstructiveInternalTypeUpload[];
+}
+export interface CreateBucketInput {
+    /** The `Bucket` to be created by this mutation. */
+    bucket: BucketInput;
+    clientMutationId?: string;
+}
+export interface CreateFileInput {
+    clientMutationId?: string;
+    /** The `File` to be created by this mutation. */
+    file: FileInput;
+}
+export interface CreatePlatformBucketInput {
+    clientMutationId?: string;
+    /** The `PlatformBucket` to be created by this mutation. */
+    platformBucket: PlatformBucketInput;
+}
+export interface CreatePlatformFileInput {
+    clientMutationId?: string;
+    /** The `PlatformFile` to be created by this mutation. */
+    platformFile: PlatformFileInput;
+}
+export interface DeleteBucketInput {
+    clientMutationId?: string;
+    id: string;
+}
+export interface DeleteFileInput {
+    clientMutationId?: string;
+    id: string;
+}
+export interface DeletePlatformBucketInput {
+    clientMutationId?: string;
+    id: string;
+}
+export interface DeletePlatformFileInput {
+    clientMutationId?: string;
+    id: string;
+}
+/** A filter to be used against `File` object types. All fields are combined with a logical ‘and.’ */
+export interface FileFilter {
+    /** Filter by the object’s `actorId` field. */
+    actorId?: UUIDFilter;
+    /** Checks for all expressions in this list. */
+    and?: FileFilter[];
+    /** Filter by the object’s `bucket` relation. */
+    bucket?: BucketFilter;
+    /** Filter by the object’s `bucketId` field. */
+    bucketId?: UUIDFilter;
+    /** Filter by the object’s `contentHash` field. */
+    contentHash?: StringFilter;
+    /** Filter by the object’s `createdAt` field. */
+    createdAt?: DatetimeFilter;
+    /** Filter by the object’s `databaseId` field. */
+    databaseId?: UUIDFilter;
+    /** Filter by the object’s `description` field. */
+    description?: StringFilter;
+    /** Filter by the object’s `expiryEnqueuedAt` field. */
+    expiryEnqueuedAt?: DatetimeFilter;
+    /** Filter by the object’s `filename` field. */
+    filename?: StringFilter;
+    /** Filter by the object’s `id` field. */
+    id?: UUIDFilter;
+    /** Filter by the object’s `isPublic` field. */
+    isPublic?: BooleanFilter;
+    /** Filter by the object’s `key` field. */
+    key?: StringFilter;
+    /** Filter by the object’s `mimeType` field. */
+    mimeType?: StringFilter;
+    /** Negates the expression. */
+    not?: FileFilter;
+    /** Checks for any expressions in this list. */
+    or?: FileFilter[];
+    /** Filter by the object’s `promotedAt` field. */
+    promotedAt?: DatetimeFilter;
+    /** Filter by the object’s `size` field. */
+    size?: BigIntFilter;
+    /** Filter by the object’s `status` field. */
+    status?: FileStatusFilter;
+    /** Filter by the object’s `tags` field. */
+    tags?: StringListFilter;
+    /** Filter by the object’s `updatedAt` field. */
+    updatedAt?: DatetimeFilter;
+    /** Filter by the object’s `upload` field. */
+    upload?: ConstructiveInternalTypeUploadFilter;
+}
+/** An input for mutations affecting `File` */
+export interface FileInput {
+    /** User who uploaded this file. Forced to current_user_id() on INSERT. Used for UPDATE/DELETE authorization. */
+    actorId: string;
+    /** Bucket this file belongs to. Determines owner_id and is_public via inheritance trigger. */
+    bucketId: string;
+    /** SHA-256 content hash for integrity verification and dedup. In default mode, equals the S3 key. In custom key mode, stored separately. */
+    contentHash?: string;
+    createdAt?: string;
+    /** Human-readable description or alt text for the file (mutable) */
+    description?: string;
+    /** When the staged-expiry sweep enqueued deletion of this file's object. NULL until it expires; set once so expiry is enqueued exactly once. */
+    expiryEnqueuedAt?: string;
+    /** Original filename provided by the uploader. Used for display and Content-Disposition header on download. */
+    filename?: string;
+    id?: string;
+    /** S3 object key for this file, unique within its bucket */
+    key: string;
+    /** MIME type of the file (e.g. image/png, application/pdf). Immutable after INSERT. */
+    mimeType: string;
+    /** When this file was promoted out of its staging bucket into its destination bucket. NULL for a file that was never staged, or is still staged. */
+    promotedAt?: string;
+    /** File size in bytes. Immutable after INSERT. */
+    size: string;
+    /** File lifecycle status: requested (presigned URL generated, not yet in S3), uploaded (file in S3 and content validated, ready for use), processed (image resized, text extracted, embedding computed), rejected (declared type disagreed with the bytes), expired (bytes never arrived before the confirm window closed). */
+    status?: FileStatus;
+    /** User-defined tags for categorization and search (mutable) */
+    tags?: string[];
+    updatedAt?: string;
+    /** Processed file reference (upload domain). Populated by processing jobs after file is uploaded. Copy this value to other tables to reference the file. */
+    upload?: ConstructiveInternalTypeUpload;
+}
+/** Represents an update to a `File`. Fields that are set will be updated. */
+export interface FilePatch {
+    /** User who uploaded this file. Forced to current_user_id() on INSERT. Used for UPDATE/DELETE authorization. */
+    actorId?: string;
+    /** Bucket this file belongs to. Determines owner_id and is_public via inheritance trigger. */
+    bucketId?: string;
+    /** SHA-256 content hash for integrity verification and dedup. In default mode, equals the S3 key. In custom key mode, stored separately. */
+    contentHash?: string;
+    createdAt?: string;
+    /** Database that owns this resource (database-scoped isolation) */
+    databaseId?: string;
+    /** Human-readable description or alt text for the file (mutable) */
+    description?: string;
+    /** When the staged-expiry sweep enqueued deletion of this file's object. NULL until it expires; set once so expiry is enqueued exactly once. */
+    expiryEnqueuedAt?: string;
+    /** Original filename provided by the uploader. Used for display and Content-Disposition header on download. */
+    filename?: string;
+    id?: string;
+    /** Whether this file is publicly readable. Inherited from bucket on INSERT. */
+    isPublic?: boolean;
+    /** S3 object key for this file, unique within its bucket */
+    key?: string;
+    /** MIME type of the file (e.g. image/png, application/pdf). Immutable after INSERT. */
+    mimeType?: string;
+    /** When this file was promoted out of its staging bucket into its destination bucket. NULL for a file that was never staged, or is still staged. */
+    promotedAt?: string;
+    /** File size in bytes. Immutable after INSERT. */
+    size?: string;
+    /** File lifecycle status: requested (presigned URL generated, not yet in S3), uploaded (file in S3 and content validated, ready for use), processed (image resized, text extracted, embedding computed), rejected (declared type disagreed with the bytes), expired (bytes never arrived before the confirm window closed). */
+    status?: FileStatus;
+    /** User-defined tags for categorization and search (mutable) */
+    tags?: string[];
+    updatedAt?: string;
+    /** Processed file reference (upload domain). Populated by processing jobs after file is uploaded. Copy this value to other tables to reference the file. */
+    upload?: ConstructiveInternalTypeUpload;
+    /** Upload for Processed file reference (upload domain). Populated by processing jobs after file is uploaded. Copy this value to other tables to reference the file. */
+    uploadUpload?: File;
+}
+/** A filter to be used against FileStatus fields. All fields are combined with a logical ‘and.’ */
+export interface FileStatusFilter {
+    /** Not equal to the specified value, treating null like an ordinary value. */
+    distinctFrom?: FileStatus;
+    /** Equal to the specified value. */
+    equalTo?: FileStatus;
+    /** Greater than the specified value. */
+    greaterThan?: FileStatus;
+    /** Greater than or equal to the specified value. */
+    greaterThanOrEqualTo?: FileStatus;
+    /** Included in the specified list. */
+    in?: FileStatus[];
+    /** Is null (if `true` is specified) or is not null (if `false` is specified). */
+    isNull?: boolean;
+    /** Less than the specified value. */
+    lessThan?: FileStatus;
+    /** Less than or equal to the specified value. */
+    lessThanOrEqualTo?: FileStatus;
+    /** Equal to the specified value, treating null like an ordinary value. */
+    notDistinctFrom?: FileStatus;
+    /** Not equal to the specified value. */
+    notEqualTo?: FileStatus;
+    /** Not included in the specified list. */
+    notIn?: FileStatus[];
+}
+export interface FilesRenameInput {
+    clientMutationId?: string;
+    fileId?: string;
+    newFilename?: string;
+}
+/** A filter to be used against Interval fields. All fields are combined with a logical ‘and.’ */
+export interface IntervalFilter {
+    /** Not equal to the specified value, treating null like an ordinary value. */
+    distinctFrom?: IntervalInput;
+    /** Equal to the specified value. */
+    equalTo?: IntervalInput;
+    /** Greater than the specified value. */
+    greaterThan?: IntervalInput;
+    /** Greater than or equal to the specified value. */
+    greaterThanOrEqualTo?: IntervalInput;
+    /** Included in the specified list. */
+    in?: IntervalInput[];
+    /** Is null (if `true` is specified) or is not null (if `false` is specified). */
+    isNull?: boolean;
+    /** Less than the specified value. */
+    lessThan?: IntervalInput;
+    /** Less than or equal to the specified value. */
+    lessThanOrEqualTo?: IntervalInput;
+    /** Equal to the specified value, treating null like an ordinary value. */
+    notDistinctFrom?: IntervalInput;
+    /** Not equal to the specified value. */
+    notEqualTo?: IntervalInput;
+    /** Not included in the specified list. */
+    notIn?: IntervalInput[];
+}
+/** An interval of time that has passed where the smallest distinct unit is a second. */
+export interface IntervalInput {
+    /** A quantity of days. */
+    days?: number;
+    /** A quantity of hours. */
+    hours?: number;
+    /** A quantity of minutes. */
+    minutes?: number;
+    /** A quantity of months. */
+    months?: number;
+    /**
+     * A quantity of seconds. This is the only non-integer field, as all the other
+     * fields will dump their overflow into a smaller unit of time. Intervals don’t
+     * have a smaller unit than seconds.
+     */
+    seconds?: number;
+    /** A quantity of years. */
+    years?: number;
+}
+/** A filter to be used against `PlatformBucket` object types. All fields are combined with a logical ‘and.’ */
+export interface PlatformBucketFilter {
+    /** Filter by the object’s `actorId` field. */
+    actorId?: UUIDFilter;
+    /** Filter by the object’s `allowCustomKeys` field. */
+    allowCustomKeys?: BooleanFilter;
+    /** Filter by the object’s `allowedMimeTypes` field. */
+    allowedMimeTypes?: StringListFilter;
+    /** Filter by the object’s `allowedOrigins` field. */
+    allowedOrigins?: StringListFilter;
+    /** Checks for all expressions in this list. */
+    and?: PlatformBucketFilter[];
+    /** Filter by the object’s `createdAt` field. */
+    createdAt?: DatetimeFilter;
+    /** Filter by the object’s `description` field. */
+    description?: StringFilter;
+    /** Filter by the object’s `destinationBucket` relation. */
+    destinationBucket?: PlatformBucketFilter;
+    /** A related `destinationBucket` exists. */
+    destinationBucketExists?: boolean;
+    /** Filter by the object’s `destinationBucketId` field. */
+    destinationBucketId?: UUIDFilter;
+    /** Filter by the object’s `id` field. */
+    id?: UUIDFilter;
+    /** Filter by the object’s `isPublic` field. */
+    isPublic?: BooleanFilter;
+    /** Filter by the object’s `key` field. */
+    key?: StringFilter;
+    /** Filter by the object’s `maxFileSize` field. */
+    maxFileSize?: BigIntFilter;
+    /** Negates the expression. */
+    not?: PlatformBucketFilter;
+    /** Checks for any expressions in this list. */
+    or?: PlatformBucketFilter[];
+    /** Filter by the object’s `physicalName` field. */
+    physicalName?: StringFilter;
+    /** Filter by the object’s `platformBucketsByDestinationBucketId` relation. */
+    platformBucketsByDestinationBucketId?: PlatformBucketToManyPlatformBucketFilter;
+    /** `platformBucketsByDestinationBucketId` exist. */
+    platformBucketsByDestinationBucketIdExist?: boolean;
+    /** Filter by the object’s `platformFilesByBucketId` relation. */
+    platformFilesByBucketId?: PlatformBucketToManyPlatformFileFilter;
+    /** `platformFilesByBucketId` exist. */
+    platformFilesByBucketIdExist?: boolean;
+    /** Filter by the object’s `stagingTtl` field. */
+    stagingTtl?: IntervalFilter;
+    /** Filter by the object’s `tags` field. */
+    tags?: StringListFilter;
+    /** Filter by the object’s `type` field. */
+    type?: BucketTypeFilter;
+    /** Filter by the object’s `updatedAt` field. */
+    updatedAt?: DatetimeFilter;
+}
+/** An input for mutations affecting `PlatformBucket` */
+export interface PlatformBucketInput {
+    /** User who created this bucket. Forced to current_user_id() on INSERT. */
+    actorId: string;
+    /** When true, clients can provide custom S3 keys (e.g. reports/2024/Q1.pdf). When false (default), S3 key = content hash (automatic dedup). contentHash always required for integrity. */
+    allowCustomKeys?: boolean;
+    /** Whitelist of allowed MIME types for files in this bucket (NULL = all allowed, enforcement deferred) */
+    allowedMimeTypes?: string[];
+    /** Per-bucket CORS allowed origins override (NULL = inherit from storage_module/plugin defaults). Use ARRAY['*'] for open/CDN mode. */
+    allowedOrigins?: string[];
+    createdAt?: string;
+    /** Human-readable description of the bucket purpose */
+    description?: string;
+    /** For a temp bucket, the permanent bucket its uploads are promoted into. NULL on non-temp buckets; required on temp buckets. */
+    destinationBucketId?: string;
+    id?: string;
+    /** Whether bucket contents are publicly readable. Set to true when type is public. */
+    isPublic?: boolean;
+    /** Unique bucket identifier used in S3 key paths (e.g. avatars, documents, temp) */
+    key: string;
+    /** Maximum file size in bytes allowed in this bucket (NULL = no limit, enforcement deferred) */
+    maxFileSize?: string;
+    /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
+    physicalName?: string;
+    /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
+    stagingTtl?: IntervalInput;
+    /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
+    tags?: string[];
+    /** Bucket CDN access type: public (CDN-served), private (presigned GET), temp (staging uploads) */
+    type?: BucketType;
+    updatedAt?: string;
+}
+/** Represents an update to a `PlatformBucket`. Fields that are set will be updated. */
+export interface PlatformBucketPatch {
+    /** User who created this bucket. Forced to current_user_id() on INSERT. */
+    actorId?: string;
+    /** When true, clients can provide custom S3 keys (e.g. reports/2024/Q1.pdf). When false (default), S3 key = content hash (automatic dedup). contentHash always required for integrity. */
+    allowCustomKeys?: boolean;
+    /** Whitelist of allowed MIME types for files in this bucket (NULL = all allowed, enforcement deferred) */
+    allowedMimeTypes?: string[];
+    /** Per-bucket CORS allowed origins override (NULL = inherit from storage_module/plugin defaults). Use ARRAY['*'] for open/CDN mode. */
+    allowedOrigins?: string[];
+    createdAt?: string;
+    /** Human-readable description of the bucket purpose */
+    description?: string;
+    /** For a temp bucket, the permanent bucket its uploads are promoted into. NULL on non-temp buckets; required on temp buckets. */
+    destinationBucketId?: string;
+    id?: string;
+    /** Whether bucket contents are publicly readable. Set to true when type is public. */
+    isPublic?: boolean;
+    /** Unique bucket identifier used in S3 key paths (e.g. avatars, documents, temp) */
+    key?: string;
+    /** Maximum file size in bytes allowed in this bucket (NULL = no limit, enforcement deferred) */
+    maxFileSize?: string;
+    /** Physical S3/MinIO bucket name recorded at provision time (NULL until the physical bucket exists) */
+    physicalName?: string;
+    /** For a temp bucket, how long an unpromoted staged file survives before it is eligible for expiry. NULL on non-temp buckets; required on temp buckets. */
+    stagingTtl?: IntervalInput;
+    /** Selector labels for capability resolution and grouping (e.g. uploads, variants, exports). A function's required bucket key is matched against these plus type. */
+    tags?: string[];
+    /** Bucket CDN access type: public (CDN-served), private (presigned GET), temp (staging uploads) */
+    type?: BucketType;
+    updatedAt?: string;
+}
+/** A filter to be used against many `PlatformBucket` object types. All fields are combined with a logical ‘and.’ */
+export interface PlatformBucketToManyPlatformBucketFilter {
+    /** Filters to entities where every related entity matches. */
+    every?: PlatformBucketFilter;
+    /** Filters to entities where no related entity matches. */
+    none?: PlatformBucketFilter;
+    /** Filters to entities where at least one related entity matches. */
+    some?: PlatformBucketFilter;
+}
+/** A filter to be used against many `PlatformFile` object types. All fields are combined with a logical ‘and.’ */
+export interface PlatformBucketToManyPlatformFileFilter {
+    /** Filters to entities where every related entity matches. */
+    every?: PlatformFileFilter;
+    /** Filters to entities where no related entity matches. */
+    none?: PlatformFileFilter;
+    /** Filters to entities where at least one related entity matches. */
+    some?: PlatformFileFilter;
+}
+/** A filter to be used against `PlatformFile` object types. All fields are combined with a logical ‘and.’ */
+export interface PlatformFileFilter {
+    /** Filter by the object’s `actorId` field. */
+    actorId?: UUIDFilter;
+    /** Checks for all expressions in this list. */
+    and?: PlatformFileFilter[];
+    /** Filter by the object’s `bucket` relation. */
+    bucket?: PlatformBucketFilter;
+    /** Filter by the object’s `bucketId` field. */
+    bucketId?: UUIDFilter;
+    /** Filter by the object’s `contentHash` field. */
+    contentHash?: StringFilter;
+    /** Filter by the object’s `createdAt` field. */
+    createdAt?: DatetimeFilter;
+    /** Filter by the object’s `description` field. */
+    description?: StringFilter;
+    /** Filter by the object’s `expiryEnqueuedAt` field. */
+    expiryEnqueuedAt?: DatetimeFilter;
+    /** Filter by the object’s `filename` field. */
+    filename?: StringFilter;
+    /** Filter by the object’s `id` field. */
+    id?: UUIDFilter;
+    /** Filter by the object’s `isPublic` field. */
+    isPublic?: BooleanFilter;
+    /** Filter by the object’s `key` field. */
+    key?: StringFilter;
+    /** Filter by the object’s `mimeType` field. */
+    mimeType?: StringFilter;
+    /** Negates the expression. */
+    not?: PlatformFileFilter;
+    /** Checks for any expressions in this list. */
+    or?: PlatformFileFilter[];
+    /** Filter by the object’s `promotedAt` field. */
+    promotedAt?: DatetimeFilter;
+    /** Filter by the object’s `size` field. */
+    size?: BigIntFilter;
+    /** Filter by the object’s `status` field. */
+    status?: FileStatusFilter;
+    /** Filter by the object’s `tags` field. */
+    tags?: StringListFilter;
+    /** Filter by the object’s `updatedAt` field. */
+    updatedAt?: DatetimeFilter;
+    /** Filter by the object’s `upload` field. */
+    upload?: ConstructiveInternalTypeUploadFilter;
+}
+/** An input for mutations affecting `PlatformFile` */
+export interface PlatformFileInput {
+    /** User who uploaded this file. Forced to current_user_id() on INSERT. Used for UPDATE/DELETE authorization. */
+    actorId: string;
+    /** Bucket this file belongs to. Determines owner_id and is_public via inheritance trigger. */
+    bucketId: string;
+    /** SHA-256 content hash for integrity verification and dedup. In default mode, equals the S3 key. In custom key mode, stored separately. */
+    contentHash?: string;
+    createdAt?: string;
+    /** Human-readable description or alt text for the file (mutable) */
+    description?: string;
+    /** When the staged-expiry sweep enqueued deletion of this file's object. NULL until it expires; set once so expiry is enqueued exactly once. */
+    expiryEnqueuedAt?: string;
+    /** Original filename provided by the uploader. Used for display and Content-Disposition header on download. */
+    filename?: string;
+    id?: string;
+    /** S3 object key for this file, unique within its bucket */
+    key: string;
+    /** MIME type of the file (e.g. image/png, application/pdf). Immutable after INSERT. */
+    mimeType: string;
+    /** When this file was promoted out of its staging bucket into its destination bucket. NULL for a file that was never staged, or is still staged. */
+    promotedAt?: string;
+    /** File size in bytes. Immutable after INSERT. */
+    size: string;
+    /** File lifecycle status: requested (presigned URL generated, not yet in S3), uploaded (file in S3 and content validated, ready for use), processed (image resized, text extracted, embedding computed), rejected (declared type disagreed with the bytes), expired (bytes never arrived before the confirm window closed). */
+    status?: FileStatus;
+    /** User-defined tags for categorization and search (mutable) */
+    tags?: string[];
+    updatedAt?: string;
+    /** Processed file reference (upload domain). Populated by processing jobs after file is uploaded. Copy this value to other tables to reference the file. */
+    upload?: ConstructiveInternalTypeUpload;
+}
+/** Represents an update to a `PlatformFile`. Fields that are set will be updated. */
+export interface PlatformFilePatch {
+    /** User who uploaded this file. Forced to current_user_id() on INSERT. Used for UPDATE/DELETE authorization. */
+    actorId?: string;
+    /** Bucket this file belongs to. Determines owner_id and is_public via inheritance trigger. */
+    bucketId?: string;
+    /** SHA-256 content hash for integrity verification and dedup. In default mode, equals the S3 key. In custom key mode, stored separately. */
+    contentHash?: string;
+    createdAt?: string;
+    /** Human-readable description or alt text for the file (mutable) */
+    description?: string;
+    /** When the staged-expiry sweep enqueued deletion of this file's object. NULL until it expires; set once so expiry is enqueued exactly once. */
+    expiryEnqueuedAt?: string;
+    /** Original filename provided by the uploader. Used for display and Content-Disposition header on download. */
+    filename?: string;
+    id?: string;
+    /** Whether this file is publicly readable. Inherited from bucket on INSERT. */
+    isPublic?: boolean;
+    /** S3 object key for this file, unique within its bucket */
+    key?: string;
+    /** MIME type of the file (e.g. image/png, application/pdf). Immutable after INSERT. */
+    mimeType?: string;
+    /** When this file was promoted out of its staging bucket into its destination bucket. NULL for a file that was never staged, or is still staged. */
+    promotedAt?: string;
+    /** File size in bytes. Immutable after INSERT. */
+    size?: string;
+    /** File lifecycle status: requested (presigned URL generated, not yet in S3), uploaded (file in S3 and content validated, ready for use), processed (image resized, text extracted, embedding computed), rejected (declared type disagreed with the bytes), expired (bytes never arrived before the confirm window closed). */
+    status?: FileStatus;
+    /** User-defined tags for categorization and search (mutable) */
+    tags?: string[];
+    updatedAt?: string;
+    /** Processed file reference (upload domain). Populated by processing jobs after file is uploaded. Copy this value to other tables to reference the file. */
+    upload?: ConstructiveInternalTypeUpload;
+    /** Upload for Processed file reference (upload domain). Populated by processing jobs after file is uploaded. Copy this value to other tables to reference the file. */
+    uploadUpload?: File;
+}
+export interface PlatformFilesRenameInput {
+    clientMutationId?: string;
+    fileId?: string;
+    newFilename?: string;
+}
+export interface ProvisionBucketInput {
+    /** The logical bucket key (e.g., "public", "private") */
+    bucketKey: string;
+    /**
+     * Owner entity ID for entity-scoped bucket provisioning.
+     * Omit for app-level (database-wide) storage.
+     */
+    ownerId?: string;
+}
+export interface UpdateBucketInput {
+    /** An object where the defined keys will be set on the `Bucket` being updated. */
+    bucketPatch: BucketPatch;
+    clientMutationId?: string;
+    id: string;
+}
+export interface UpdateFileInput {
+    clientMutationId?: string;
+    /** An object where the defined keys will be set on the `File` being updated. */
+    filePatch: FilePatch;
+    id: string;
+}
+export interface UpdatePlatformBucketInput {
+    clientMutationId?: string;
+    id: string;
+    /** An object where the defined keys will be set on the `PlatformBucket` being updated. */
+    platformBucketPatch: PlatformBucketPatch;
+}
+export interface UpdatePlatformFileInput {
+    clientMutationId?: string;
+    id: string;
+    /** An object where the defined keys will be set on the `PlatformFile` being updated. */
+    platformFilePatch: PlatformFilePatch;
+}
+export interface UploadFileBulkFileInput {
+    /** SHA-256 content hash (hex-encoded, 64 chars) */
+    contentHash: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** Original filename (optional) */
+    filename?: string;
+    /** Custom S3 key (only when bucket has allow_custom_keys=true) */
+    key?: string;
+    /** File size in bytes */
+    size: number;
+}
+export interface UploadFileBulkInput {
+    /** Bucket key (e.g., "public", "private"). Omit to use the database's default bucket for the requested access. */
+    bucketKey?: string;
+    /** Array of files to upload */
+    files: UploadFileBulkFileInput[];
+    /** Which default bucket to resolve when bucketKey is omitted. Ignored when bucketKey is given. */
+    isPublic?: boolean;
+}
+export interface UploadFileInput {
+    /** Bucket key (e.g., "public", "private"). Omit to use the database's default bucket for the requested access. */
+    bucketKey?: string;
+    /** SHA-256 content hash (hex-encoded, 64 chars) */
+    contentHash: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** Original filename (optional) */
+    filename?: string;
+    /** Which default bucket to resolve when bucketKey is omitted: the public one (true) or the private one (default false). Ignored when bucketKey is given. */
+    isPublic?: boolean;
+    /** Custom S3 key (only when bucket has allow_custom_keys=true) */
+    key?: string;
+    /** File size in bytes */
+    size: number;
+}
+export interface UploadPlatformFileBulkFileInput {
+    /** SHA-256 content hash (hex-encoded, 64 chars) */
+    contentHash: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** Original filename (optional) */
+    filename?: string;
+    /** Custom S3 key (only when bucket has allow_custom_keys=true) */
+    key?: string;
+    /** File size in bytes */
+    size: number;
+}
+export interface UploadPlatformFileBulkInput {
+    /** Bucket key (e.g., "public", "private"). Omit to use the database's default bucket for the requested access. */
+    bucketKey?: string;
+    /** Array of files to upload */
+    files: UploadPlatformFileBulkFileInput[];
+    /** Which default bucket to resolve when bucketKey is omitted. Ignored when bucketKey is given. */
+    isPublic?: boolean;
+}
+export interface UploadPlatformFileInput {
+    /** Bucket key (e.g., "public", "private"). Omit to use the database's default bucket for the requested access. */
+    bucketKey?: string;
+    /** SHA-256 content hash (hex-encoded, 64 chars) */
+    contentHash: string;
+    /** MIME type of the file */
+    contentType: string;
+    /** Original filename (optional) */
+    filename?: string;
+    /** Which default bucket to resolve when bucketKey is omitted: the public one (true) or the private one (default false). Ignored when bucketKey is given. */
+    isPublic?: boolean;
+    /** Custom S3 key (only when bucket has allow_custom_keys=true) */
+    key?: string;
+    /** File size in bytes */
+    size: number;
+}
+/** Root meta schema type */
+export interface MetaSchema {
+    tables: MetaTable[];
+}
+/** A connection to a list of `Bucket` values. */
+export interface BucketConnection {
+    edges: BucketEdge[];
+    nodes: Bucket[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+/** A connection to a list of `File` values. */
+export interface FileConnection {
+    edges: FileEdge[];
+    nodes: File[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+/** A connection to a list of `PlatformBucket` values. */
+export interface PlatformBucketConnection {
+    edges: PlatformBucketEdge[];
+    nodes: PlatformBucket[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+/** A connection to a list of `PlatformFile` values. */
+export interface PlatformFileConnection {
+    edges: PlatformFileEdge[];
+    nodes: PlatformFile[];
+    pageInfo: PageInfo;
+    totalCount: number;
+}
+export interface CreateBucketPayload {
+    /** The `Bucket` that was created by this mutation. */
+    bucket?: Bucket | null;
+    bucketEdge?: BucketEdge | null;
+    clientMutationId?: string | null;
+}
+export interface CreateFilePayload {
+    clientMutationId?: string | null;
+    /** The `File` that was created by this mutation. */
+    file?: File | null;
+    fileEdge?: FileEdge | null;
+}
+export interface CreatePlatformBucketPayload {
+    clientMutationId?: string | null;
+    /** The `PlatformBucket` that was created by this mutation. */
+    platformBucket?: PlatformBucket | null;
+    platformBucketEdge?: PlatformBucketEdge | null;
+}
+export interface CreatePlatformFilePayload {
+    clientMutationId?: string | null;
+    /** The `PlatformFile` that was created by this mutation. */
+    platformFile?: PlatformFile | null;
+    platformFileEdge?: PlatformFileEdge | null;
+}
+export interface DeleteBucketPayload {
+    /** The `Bucket` that was deleted by this mutation. */
+    bucket?: Bucket | null;
+    bucketEdge?: BucketEdge | null;
+    clientMutationId?: string | null;
+}
+export interface DeleteFilePayload {
+    clientMutationId?: string | null;
+    /** The `File` that was deleted by this mutation. */
+    file?: File | null;
+    fileEdge?: FileEdge | null;
+}
+export interface DeletePlatformBucketPayload {
+    clientMutationId?: string | null;
+    /** The `PlatformBucket` that was deleted by this mutation. */
+    platformBucket?: PlatformBucket | null;
+    platformBucketEdge?: PlatformBucketEdge | null;
+}
+export interface DeletePlatformFilePayload {
+    clientMutationId?: string | null;
+    /** The `PlatformFile` that was deleted by this mutation. */
+    platformFile?: PlatformFile | null;
+    platformFileEdge?: PlatformFileEdge | null;
+}
+export interface FilesRenamePayload {
+    clientMutationId?: string | null;
+    fileEdge?: FileEdge | null;
+    result?: File | null;
+}
+export interface PlatformFilesRenamePayload {
+    clientMutationId?: string | null;
+    platformFileEdge?: PlatformFileEdge | null;
+    result?: PlatformFile | null;
+}
+export interface ProvisionBucketPayload {
+    /** The logical bucket row that was queued for reconciliation. */
+    bucketId: string;
+    bucketKey: string;
+    /** The reconciler job enqueued to provision this bucket. */
+    jobId: string;
+    /** The physical bucket name already recorded, or null when reconciliation has not completed. */
+    physicalName?: string | null;
+}
+export interface UpdateBucketPayload {
+    /** The `Bucket` that was updated by this mutation. */
+    bucket?: Bucket | null;
+    bucketEdge?: BucketEdge | null;
+    clientMutationId?: string | null;
+}
+export interface UpdateFilePayload {
+    clientMutationId?: string | null;
+    /** The `File` that was updated by this mutation. */
+    file?: File | null;
+    fileEdge?: FileEdge | null;
+}
+export interface UpdatePlatformBucketPayload {
+    clientMutationId?: string | null;
+    /** The `PlatformBucket` that was updated by this mutation. */
+    platformBucket?: PlatformBucket | null;
+    platformBucketEdge?: PlatformBucketEdge | null;
+}
+export interface UpdatePlatformFilePayload {
+    clientMutationId?: string | null;
+    /** The `PlatformFile` that was updated by this mutation. */
+    platformFile?: PlatformFile | null;
+    platformFileEdge?: PlatformFileEdge | null;
+}
+export interface UploadFilePayload {
+    /** Whether this file was deduplicated (content already exists) */
+    deduplicated: boolean;
+    /** Presigned URL expiry time (null if deduplicated) */
+    expiresAt?: string | null;
+    /** The projection document for the created file: {id, key, bucket_id, mime, size, filename, url?}. Store this verbatim in an image/upload column — its `id` is what keeps the object from being garbage collected while the column still references it. */
+    file?: unknown | null;
+    /** The file ID (UUID) */
+    fileId: string;
+    /** The S3 object key */
+    key: string;
+    /** ID of the previous version (when using custom keys) */
+    previousVersionId?: string | null;
+    /** Presigned PUT URL (null if deduplicated) */
+    uploadUrl?: string | null;
+}
+export interface UploadFileBulkPayload {
+    files: UploadFileBulkFilePayload[];
+}
+export interface UploadPlatformFilePayload {
+    /** Whether this file was deduplicated (content already exists) */
+    deduplicated: boolean;
+    /** Presigned URL expiry time (null if deduplicated) */
+    expiresAt?: string | null;
+    /** The projection document for the created file: {id, key, bucket_id, mime, size, filename, url?}. Store this verbatim in an image/upload column — its `id` is what keeps the object from being garbage collected while the column still references it. */
+    file?: unknown | null;
+    /** The file ID (UUID) */
+    fileId: string;
+    /** The S3 object key */
+    key: string;
+    /** ID of the previous version (when using custom keys) */
+    previousVersionId?: string | null;
+    /** Presigned PUT URL (null if deduplicated) */
+    uploadUrl?: string | null;
+}
+export interface UploadPlatformFileBulkPayload {
+    files: UploadPlatformFileBulkFilePayload[];
+}
+/** Information about a database table */
+export interface MetaTable {
+    constraints: MetaConstraints;
+    fields: MetaField[];
+    foreignKeyConstraints: MetaForeignKeyConstraint[];
+    /** i18n metadata (null if no @i18n tag) */
+    i18n?: MetaI18n | null;
+    indexes: MetaIndex[];
+    inflection: MetaInflection;
+    /** Final GraphQL output type name */
+    name: string;
+    primaryKeyConstraints: MetaPrimaryKeyConstraint[];
+    query: MetaQuery;
+    /** Realtime metadata (null if no @realtime tag) */
+    realtime?: MetaRealtime | null;
+    relations: MetaRelations;
+    schemaName: string;
+    /** Provisioning scope metadata (null if no @scope tag) */
+    scope?: MetaScope | null;
+    /** Search metadata (null if no search configured) */
+    search?: MetaSearch | null;
+    /** Storage metadata (null if not a storage table) */
+    storage?: MetaStorage | null;
+    /** PostgreSQL table name */
+    tableName: string;
+    uniqueConstraints: MetaUniqueConstraint[];
+}
+/** A `Bucket` edge in the connection. */
+export interface BucketEdge {
+    cursor?: string | null;
+    /** The `Bucket` at the end of the edge. */
+    node?: Bucket | null;
+}
+/** Information about pagination in a connection. */
+export interface PageInfo {
+    /** When paginating forwards, the cursor to continue. */
+    endCursor?: string | null;
+    /** When paginating forwards, are there more items? */
+    hasNextPage: boolean;
+    /** When paginating backwards, are there more items? */
+    hasPreviousPage: boolean;
+    /** When paginating backwards, the cursor to continue. */
+    startCursor?: string | null;
+}
+/** A `File` edge in the connection. */
+export interface FileEdge {
+    cursor?: string | null;
+    /** The `File` at the end of the edge. */
+    node?: File | null;
+}
+/** A `PlatformBucket` edge in the connection. */
+export interface PlatformBucketEdge {
+    cursor?: string | null;
+    /** The `PlatformBucket` at the end of the edge. */
+    node?: PlatformBucket | null;
+}
+/** A `PlatformFile` edge in the connection. */
+export interface PlatformFileEdge {
+    cursor?: string | null;
+    /** The `PlatformFile` at the end of the edge. */
+    node?: PlatformFile | null;
+}
+export interface UploadFileBulkFilePayload {
+    deduplicated: boolean;
+    expiresAt?: string | null;
+    /** The projection document for the created file. */
+    file?: unknown | null;
+    fileId: string;
+    key: string;
+    previousVersionId?: string | null;
+    uploadUrl?: string | null;
+}
+export interface UploadPlatformFileBulkFilePayload {
+    deduplicated: boolean;
+    expiresAt?: string | null;
+    /** The projection document for the created file. */
+    file?: unknown | null;
+    fileId: string;
+    key: string;
+    previousVersionId?: string | null;
+    uploadUrl?: string | null;
+}
+/** Table constraints */
+export interface MetaConstraints {
+    foreignKey: MetaForeignKeyConstraint[];
+    primaryKey?: MetaPrimaryKeyConstraint | null;
+    unique: MetaUniqueConstraint[];
+}
+/** Information about a table field/column */
+export interface MetaField {
+    /** PostgreSQL column name */
+    columnName: string;
+    description?: string | null;
+    /** Enum metadata if this field has an enum type */
+    enumValues?: MetaEnum | null;
+    hasDefault: boolean;
+    isForeignKey: boolean;
+    isNotNull: boolean;
+    isPrimaryKey: boolean;
+    /** Final GraphQL field name */
+    name: string;
+    type: MetaType;
+}
+/** Information about a foreign key constraint */
+export interface MetaForeignKeyConstraint {
+    fields: MetaField[];
+    name: string;
+    refFields?: MetaField[] | null;
+    refTable?: MetaRefTable | null;
+    referencedFields: string[];
+    referencedTable: string;
+}
+/** i18n metadata for a table with @i18n tag */
+export interface MetaI18n {
+    /** Fields that are translatable */
+    translatableFields: MetaI18nField[];
+    /** Name of the translation table */
+    translationTable: string;
+}
+/** Information about a database index */
+export interface MetaIndex {
+    columns: string[];
+    fields?: MetaField[] | null;
+    isPrimary: boolean;
+    isUnique: boolean;
+    name: string;
+}
+/** Table inflection names */
+export interface MetaInflection {
+    allRows: string;
+    conditionType: string;
+    connection: string;
+    createInputType: string;
+    createPayloadType: string;
+    deletePayloadType: string;
+    edge: string;
+    filterType?: string | null;
+    orderByType: string;
+    patchType?: string | null;
+    tableType: string;
+    updatePayloadType?: string | null;
+}
+/** Information about a primary key constraint */
+export interface MetaPrimaryKeyConstraint {
+    fields: MetaField[];
+    name: string;
+}
+/** Table query/mutation names */
+export interface MetaQuery {
+    all?: string | null;
+    create?: string | null;
+    delete?: string | null;
+    one?: string | null;
+    update?: string | null;
+}
+/** Realtime metadata for a table with @realtime tag */
+export interface MetaRealtime {
+    /** The generated subscription field name (e.g. onPostChanged) */
+    subscriptionFieldName: string;
+}
+/** Table relations */
+export interface MetaRelations {
+    belongsTo: MetaBelongsToRelation[];
+    has: MetaHasRelation[];
+    hasMany: MetaHasRelation[];
+    hasOne: MetaHasRelation[];
+    manyToMany: MetaManyToManyRelation[];
+}
+/** Provisioning scope metadata for a table */
+export interface MetaScope {
+    /** SQL name of the entity table for entity scopes, else null */
+    entityTable?: string | null;
+    /** Inflected scope key column (e.g. databaseId, orgId), null for global tiers */
+    keyColumn?: string | null;
+    /** Provisioning scope: 'platform', 'app', 'database', or an entity scope (e.g. 'org') */
+    scope: string;
+    /** Provenance of the scope metadata (always 'smartTag') */
+    source: string;
+    /** Coarse bucket: 'global', 'database', or 'entity' */
+    tier: string;
+}
+/** Search metadata for a table */
+export interface MetaSearch {
+    /** Active search algorithms on this table */
+    algorithms: string[];
+    /** Searchable columns with their algorithm */
+    columns: MetaSearchColumn[];
+    /** Per-table search configuration */
+    config?: MetaSearchConfig | null;
+    /** Whether unifiedSearch composite filter is available */
+    hasUnifiedSearch: boolean;
+}
+/** Storage metadata for a table */
+export interface MetaStorage {
+    /** GraphQL type name of the plane's buckets table */
+    bucketsType: string;
+    /** Computed download-URL field on the files type; null on the buckets side */
+    downloadUrlField?: string | null;
+    /** GraphQL type name of the plane's files table */
+    filesType: string;
+    /** Whether this table is a storage buckets table */
+    isBucketsTable: boolean;
+    /** Whether this table is a storage files table */
+    isFilesTable: boolean;
+    /** The plane's GraphQL upload surface */
+    upload: MetaStorageUpload;
+}
+/** Information about a unique constraint */
+export interface MetaUniqueConstraint {
+    fields: MetaField[];
+    name: string;
+}
+/** Information about a PostgreSQL enum type */
+export interface MetaEnum {
+    /** The PostgreSQL enum type name */
+    name: string;
+    /** Allowed values for this enum */
+    values: string[];
+}
+/** Information about a PostgreSQL type */
+export interface MetaType {
+    /** Scalar serialization contract (null for plain scalars) */
+    encoding?: MetaScalarEncoding | null;
+    gqlType: string;
+    hasDefault?: boolean | null;
+    isArray: boolean;
+    isNotNull?: boolean | null;
+    pgType: string;
+    subtype?: string | null;
+}
+/** Reference to a related table */
+export interface MetaRefTable {
+    name: string;
+}
+/** A translatable field */
+export interface MetaI18nField {
+    /** GraphQL field name */
+    name: string;
+    /** PostgreSQL column type (text, citext) */
+    type: string;
+}
+/** A belongs-to (forward FK) relation */
+export interface MetaBelongsToRelation {
+    fieldName?: string | null;
+    isUnique: boolean;
+    keys: MetaField[];
+    references: MetaRefTable;
+    type?: string | null;
+}
+/** A has-one or has-many (reverse FK) relation */
+export interface MetaHasRelation {
+    fieldName?: string | null;
+    isUnique: boolean;
+    keys: MetaField[];
+    referencedBy: MetaRefTable;
+    type?: string | null;
+}
+/** A many-to-many relation via junction table */
+export interface MetaManyToManyRelation {
+    fieldName?: string | null;
+    junctionLeftConstraint: MetaForeignKeyConstraint;
+    junctionLeftKeyAttributes: MetaField[];
+    junctionRightConstraint: MetaForeignKeyConstraint;
+    junctionRightKeyAttributes: MetaField[];
+    junctionTable: MetaRefTable;
+    leftKeyAttributes: MetaField[];
+    rightKeyAttributes: MetaField[];
+    rightTable: MetaRefTable;
+    type?: string | null;
+}
+/** A searchable column with its algorithm */
+export interface MetaSearchColumn {
+    /** Search algorithm: tsvector, bm25, trgm, or vector */
+    algorithm: string;
+    /** Column name (camelCase) */
+    name: string;
+}
+/** Per-table search configuration from @searchConfig smart tag */
+export interface MetaSearchConfig {
+    /** Exponential decay factor per day */
+    boostRecencyDecay?: number | null;
+    /** Field used for recency decay */
+    boostRecencyField?: string | null;
+    /** Whether recency boosting is enabled */
+    boostRecent: boolean;
+    /** JSON-encoded per-adapter score weights */
+    weights?: string | null;
+}
+/** The GraphQL upload surface of a storage plane, derived from the registry facts the presigned-url plugin emits from */
+export interface MetaStorageUpload {
+    /** Per-file input type inside the bulk input */
+    bulkFileInputType: string;
+    /** Per-file payload type inside the bulk payload */
+    bulkFilePayloadType: string;
+    /** Input type of the bulk upload mutation */
+    bulkInputType: string;
+    /** Root mutation field for bulk upload */
+    bulkMutation: string;
+    /** Payload type of the bulk upload mutation */
+    bulkPayloadType: string;
+    /** Input type of the single upload mutation */
+    inputType: string;
+    /** Root mutation field for single-file upload (e.g. uploadAppFile) */
+    mutation: string;
+    /** Payload type of the single upload mutation */
+    payloadType: string;
+    /** Whether the upload input requires ownerId (entity-keyed plane) */
+    requiresOwnerId: boolean;
+}
+/** How a client must serialize/parse a scalar — the one field-type detail standard GraphQL introspection cannot describe. Null for plain scalars whose wire format is obvious from gqlType. */
+export interface MetaScalarEncoding {
+    /** For 'vector': declared length, else null. */
+    dimensions?: number | null;
+    /** For 'ltree': values are dot-separated path strings. */
+    dotPath?: boolean | null;
+    /** For 'vector': element scalar (e.g. 'float'). */
+    elementType?: string | null;
+    /** For 'geojson': Point/LineString/Polygon/…, else null. */
+    geometrySubtype?: string | null;
+    /** Machine kind: bigint, datetime, date, time, interval, uuid, geojson, point, inet, ltree, vector, bytea, or composite. */
+    kind: string;
+    /** For 'geojson': spatial reference id, else null. */
+    srid?: number | null;
+}