@objectql/types 1.7.2 → 1.8.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 ObjectQL Contributors
+Copyright (c) 2026 ObjectQL Contributors (https://github.com/objectql)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/field.d.ts

@@ -1,4 +1,44 @@
 import { FieldValidation, ValidationAiContext } from './validation';
+/**
+ * Attachment field data structure for file and image types.
+ * Stores metadata about uploaded files, with actual file content stored separately.
+ */
+export interface AttachmentData {
+    /** Unique identifier for this file */
+    id?: string;
+    /** File name (e.g., "invoice.pdf") */
+    name: string;
+    /** Publicly accessible URL to the file */
+    url: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type (e.g., "application/pdf", "image/jpeg") */
+    type: string;
+    /** Original filename as uploaded by user */
+    original_name?: string;
+    /** Upload timestamp (ISO 8601) */
+    uploaded_at?: string;
+    /** User ID who uploaded the file */
+    uploaded_by?: string;
+}
+/**
+ * Image-specific attachment data with additional metadata.
+ * Extends AttachmentData with image-specific properties.
+ */
+export interface ImageAttachmentData extends AttachmentData {
+    /** Image width in pixels */
+    width?: number;
+    /** Image height in pixels */
+    height?: number;
+    /** Thumbnail URL (if generated) */
+    thumbnail_url?: string;
+    /** Alternative sizes/versions */
+    variants?: {
+        small?: string;
+        medium?: string;
+        large?: string;
+    };
+}
 /**
  * Represents the supported field data types in the ObjectQL schema.
  * These types determine how data is stored, validated, and rendered.
@@ -7,8 +47,10 @@ import { FieldValidation, ValidationAiContext } from './validation';
  * - `textarea`: Long string.
  * - `select`: Choice from a list.
  * - `lookup`: Relationship to another object.
+ * - `file`: File attachment. Value stored as AttachmentData (single) or AttachmentData[] (multiple).
+ * - `image`: Image attachment. Value stored as ImageAttachmentData (single) or ImageAttachmentData[] (multiple).
  */
-export type FieldType = 'text' | 'textarea' | 'markdown' | 'html' | 'select' | 'date' | 'datetime' | 'time' | 'number' | 'currency' | 'percent' | 'boolean' | 'email' | 'phone' | 'url' | 'image' | 'file' | 'avatar' | 'location' | 'lookup' | 'master_detail' | 'password' | 'formula' | 'summary' | 'auto_number' | 'object' | 'vector' | 'grid';
+export type FieldType = 'text' | 'textarea' | 'markdown' | 'html' | 'select' | 'date' | 'datetime' | 'time' | 'number' | 'currency' | 'percent' | 'boolean' | 'email' | 'phone' | 'url' | 'image' | 'file' | 'location' | 'lookup' | 'master_detail' | 'password' | 'formula' | 'summary' | 'auto_number' | 'object' | 'vector' | 'grid';
 /**
  * Defines a single option for select/multiselect fields.
  */
@@ -63,6 +105,36 @@ export interface FieldConfig {
      * Specifies the target object name for relationship fields.
      */
     reference_to?: string;
+    /**
+     * Allowed file extensions for file/image fields.
+     * Example: ['.pdf', '.docx'] or ['.jpg', '.png', '.gif']
+     */
+    accept?: string[];
+    /**
+     * Maximum file size in bytes for file/image fields.
+     * Example: 5242880 (5MB)
+     */
+    max_size?: number;
+    /**
+     * Minimum file size in bytes for file/image fields.
+     */
+    min_size?: number;
+    /**
+     * Maximum image width in pixels for image fields.
+     */
+    max_width?: number;
+    /**
+     * Maximum image height in pixels for image fields.
+     */
+    max_height?: number;
+    /**
+     * Minimum image width in pixels for image fields.
+     */
+    min_width?: number;
+    /**
+     * Minimum image height in pixels for image fields.
+     */
+    min_height?: number;
     /** Minimum for number/currency/percent. */
     min?: number;
     /** Maximum for number/currency/percent. */

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@objectql/types",
-  "version": "1.7.2",
+  "version": "1.8.0",
+  "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [

package/schemas/object.schema.json

@@ -548,6 +548,13 @@
       "additionalProperties": false,
       "description": "Configuration for a single field on an object. This defines the schema, validation rules, and UI hints for the attribute.",
       "properties": {
+        "accept": {
+          "description": "Allowed file extensions for file/image fields. Example: ['.pdf', '.docx'] or ['.jpg', '.png', '.gif']",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
         "ai_context": {
           "$ref": "#/definitions/ValidationAiContext",
           "description": "AI context for the field. Provides semantic information for AI tools."
@@ -591,18 +598,42 @@
           "description": "Maximum for number/currency/percent.",
           "type": "number"
         },
+        "max_height": {
+          "description": "Maximum image height in pixels for image fields.",
+          "type": "number"
+        },
         "max_length": {
           "description": "Maximum length for text based fields.",
           "type": "number"
         },
+        "max_size": {
+          "description": "Maximum file size in bytes for file/image fields. Example: 5242880 (5MB)",
+          "type": "number"
+        },
+        "max_width": {
+          "description": "Maximum image width in pixels for image fields.",
+          "type": "number"
+        },
         "min": {
           "description": "Minimum for number/currency/percent.",
           "type": "number"
         },
+        "min_height": {
+          "description": "Minimum image height in pixels for image fields.",
+          "type": "number"
+        },
         "min_length": {
           "description": "Minimum length for text based fields.",
           "type": "number"
         },
+        "min_size": {
+          "description": "Minimum file size in bytes for file/image fields.",
+          "type": "number"
+        },
+        "min_width": {
+          "description": "Minimum image width in pixels for image fields.",
+          "type": "number"
+        },
         "multiple": {
           "description": "Whether the field allows multiple values.  Supported by 'select', 'lookup', 'file', 'image'.",
           "type": "boolean"
@@ -687,7 +718,7 @@
       "type": "object"
     },
     "FieldType": {
-      "description": "Represents the supported field data types in the ObjectQL schema. These types determine how data is stored, validated, and rendered.\n\n- `text`: Simple string.\n- `textarea`: Long string.\n- `select`: Choice from a list.\n- `lookup`: Relationship to another object.",
+      "description": "Represents the supported field data types in the ObjectQL schema. These types determine how data is stored, validated, and rendered.\n\n- `text`: Simple string.\n- `textarea`: Long string.\n- `select`: Choice from a list.\n- `lookup`: Relationship to another object.\n- `file`: File attachment. Value stored as AttachmentData (single) or AttachmentData[] (multiple).\n- `image`: Image attachment. Value stored as ImageAttachmentData (single) or ImageAttachmentData[] (multiple).",
       "enum": [
         "text",
         "textarea",
@@ -706,7 +737,6 @@
         "url",
         "image",
         "file",
-        "avatar",
         "location",
         "lookup",
         "master_detail",