@stndrds/schema 1.0.0-alpha.168 → 1.0.0-alpha.170

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { k as SortRule, l as FilterState, m as Timestamps, n as AttributeType, V as ViewType, o as ViewConfig, p as ConfigOverrides, j as CompletionStatus, A as Attribute, q as LocationGranularity, r as Location, e as FormulaAttribute, f as RollupAttribute, d as StatusAttribute, c as SelectAttribute, b as MultiselectAttribute, s as Phone, t as Currency, u as ObjectRecord, D as DateAttribute, U as UserAttribute, v as DocumentAttribute, w as DocumentSlotConfig, x as FeatureGate, g as CheckboxAttribute, C as CurrencyAttribute, F as FileAttribute, y as FormulaReturnType, L as LocationAttribute, z as Option, N as NumberAttribute, P as PhoneAttribute, h as RatingAttribute, R as RelationAttribute, i as TextAttribute, T as TextAreaAttribute, B as BilateralConfig, S as SingleRelationAttribute, M as MultiRelationAttribute, E as RelationTarget, a as RichtextAttribute, G as RichtextFeature, H as RollupFunction, I as MigrationDefinition, O as ObjectDefinition, J as DetailViewConfig, K as DetailViewDefinition, Q as DetailViewLayout, W as SidePanelConfig, X as Field, Y as AttributeGroupField, Z as FieldGroup, _ as RelationGroup, $ as Group, a0 as TableTab, a1 as CreateMode, a2 as Tab, a3 as ListViewConfig, a4 as ListViewDefinition, a5 as FlagValueType, a6 as FeatureFlagDefinition, a7 as FlagLevel, a8 as FeatureFlagsRepository, a9 as StaticFlagDefault, aa as ResolvedFlag, ab as ViewDefinition, ac as ListViewTab, ad as FilterOperator, ae as FilterValue } from './filters-zzsF0GxK.js';
-export { af as ActivityTab, ag as AdvancedFilterState, ah as AttributeGroup, ai as BaseAttribute, aj as BuiltInTransform, ak as CreateDocument, al as CreateDocumentSlot, am as CreateProcessingJob, an as CurrencyFilterValue, ao as CustomTab, ap as DEFAULT_DOCUMENT_SLOT, aq as DateFormat, ar as DateValue, as as Document, at as DocumentListOptions, au as DocumentSlot, av as DocumentWithSlots, aw as DocumentsTab, ax as ExtendedFilterRule, ay as FeatureFlagsConfig, az as FilterCombinator, aA as FilterGroup, aB as FilterRule, aC as FlagOverride, aD as FormDensity, aE as FormTab, aF as FormsTab, aG as InverseSource, aH as ListViewLayout, aI as MigrationError, aJ as NO_VALUE_OPERATORS, aK as NoValueOperator, aL as NumberUnit, aM as OPERATORS_BY_TYPE, aN as ObjectAttribute, aO as OptionPropertyAttribute, aP as PhoneFilterValue, aQ as ProcessingJob, aR as ProcessingJobStatus, aS as ProcessingJobType, aT as PropertyAttribute, aU as PropertySchema, aV as PropertyType, aW as QueryState, aX as RELATION_TARGET_ANY, aY as RESERVED_ATTRIBUTE_NAMES, aZ as RecordDocuments, a_ as RelationSource, a$ as RelativeDateValue, b0 as ReservedAttributeName, b1 as RichtextTab, b2 as SYSTEM_FIELD_NAMES, b3 as SchemaOperation, b4 as SchemaTransform, b5 as SlotStatus, b6 as SortDirection, b7 as StatusGroup, b8 as SystemFieldName, b9 as TabType, ba as TableSource, bb as TransformSource, bc as UpdateDocument, bd as UpdateDocumentSlot, be as UpdateProcessingJob, bf as ViewOperation, bg as ViewOverlay, bh as ViewTransform, bi as getRollupFilterOperators, bj as hasOptions, bk as inferInverseCardinality, bl as isAttributeSortable, bm as isBilateralRelation, bn as isDetailView, bo as isFieldGroup, bp as isListView, bq as isNoValueOperator, br as isRelationGroup, bs as isUniversalRelation } from './filters-zzsF0GxK.js';
+import { k as SortRule, l as FilterState, m as Timestamps, n as AttributeType, V as ViewType, o as ViewConfig, p as ConfigOverrides, j as CompletionStatus, A as Attribute, q as LocationGranularity, r as Location, e as FormulaAttribute, f as RollupAttribute, s as DocumentAttribute, d as StatusAttribute, c as SelectAttribute, b as MultiselectAttribute, t as Phone, u as Currency, v as ObjectRecord, D as DateAttribute, U as UserAttribute, w as DocumentSlotConfig, x as PropertySchema, y as FeatureGate, g as CheckboxAttribute, C as CurrencyAttribute, i as TextAttribute, T as TextAreaAttribute, N as NumberAttribute, P as PhoneAttribute, z as Option, h as RatingAttribute, L as LocationAttribute, F as FileAttribute, B as FormulaReturnType, R as RelationAttribute, E as BilateralConfig, S as SingleRelationAttribute, M as MultiRelationAttribute, G as RelationTarget, a as RichtextAttribute, H as RichtextFeature, I as RollupFunction, J as MigrationDefinition, O as ObjectDefinition, K as DetailViewConfig, Q as DetailViewDefinition, W as DetailViewLayout, X as SidePanelConfig, Y as Field, Z as AttributeGroupField, _ as FieldGroup, $ as RelationGroup, a0 as Group, a1 as TableTab, a2 as CreateMode, a3 as Tab, a4 as ListViewConfig, a5 as ListViewDefinition, a6 as FlagValueType, a7 as FeatureFlagDefinition, a8 as FlagLevel, a9 as FeatureFlagsRepository, aa as StaticFlagDefault, ab as ResolvedFlag, ac as ViewDefinition, ad as ListViewTab, ae as FilterOperator, af as FilterValue } from './filters-B2cCCbDq.js';
+export { ag as ActivityTab, ah as AdvancedFilterState, ai as AttributeGroup, aj as BaseAttribute, ak as BuiltInTransform, al as CreateDocument, am as CreateDocumentSlot, an as CreateProcessingJob, ao as CurrencyFilterValue, ap as CustomTab, aq as DEFAULT_DOCUMENT_SLOT, ar as DateFormat, as as DateValue, at as Document, au as DocumentListOptions, av as DocumentSlot, aw as DocumentWithSlots, ax as DocumentsTab, ay as ExtendedFilterRule, az as FeatureFlagsConfig, aA as FilterCombinator, aB as FilterGroup, aC as FilterRule, aD as FlagOverride, aE as FormDensity, aF as FormTab, aG as FormsTab, aH as InverseSource, aI as ListViewLayout, aJ as MigrationError, aK as NO_VALUE_OPERATORS, aL as NoValueOperator, aM as NumberUnit, aN as OPERATORS_BY_TYPE, aO as ObjectAttribute, aP as OptionPropertyAttribute, aQ as PhoneFilterValue, aR as ProcessingJob, aS as ProcessingJobStatus, aT as ProcessingJobType, aU as PropertyAttribute, aV as PropertyType, aW as QueryState, aX as RELATION_TARGET_ANY, aY as RESERVED_ATTRIBUTE_NAMES, aZ as RecordDocuments, a_ as RelationSource, a$ as RelativeDateValue, b0 as ReservedAttributeName, b1 as RichtextTab, b2 as SYSTEM_FIELD_NAMES, b3 as SchemaOperation, b4 as SchemaTransform, b5 as SlotStatus, b6 as SortDirection, b7 as StatusGroup, b8 as SystemFieldName, b9 as TabType, ba as TableSource, bb as TransformSource, bc as UpdateDocument, bd as UpdateDocumentSlot, be as UpdateProcessingJob, bf as ViewOperation, bg as ViewOverlay, bh as ViewTransform, bi as getRollupFilterOperators, bj as hasOptions, bk as inferInverseCardinality, bl as isAttributeSortable, bm as isBilateralRelation, bn as isDetailView, bo as isFieldGroup, bp as isListView, bq as isNoValueOperator, br as isRelationGroup, bs as isUniversalRelation } from './filters-B2cCCbDq.js';
 import { MimeType, IconName, ColorId, CountryIso3, CurrencyCode } from '@stndrds/constants';
 import { Uuid, TenantId } from './utils.js';
 export { UserId, asTenantId, asUserId, deepEqual, generateId, indexBy } from './utils.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export { StandardSchemaV1 } from '@standard-schema/spec';
 import z from 'zod';
-export { V as ValidationMessages } from './types-Bemfgle3.js';
+export { V as ValidationMessages } from './types-DGGecyHV.js';
 export { DEFAULT_VALIDATION_MESSAGES, formatZodErrors } from './validation/core/index.js';
 export { parseAttributeConfig } from './validation/config/index.js';
-export { c as computeRecordStatus, a as createFormAttributeValidator, v as validateDraftOrThrow, b as validateObject, d as validateObjectOrThrow } from './helpers-D3nsZLoE.js';
+export { c as computeRecordStatus, a as createFormAttributeValidator, v as validateDraft, b as validateDraftOrThrow, d as validateObject, e as validateObjectOrThrow } from './helpers-icxxQQJQ.js';
 
 /**
  * Generic list options for pagination and sorting
@@ -2467,12 +2467,51 @@ type InferSelectValue<A extends SelectAttribute> = A["options"] extends readonly
 type InferMultiselectValue<A extends MultiselectAttribute> = A["options"] extends readonly {
     value: infer V;
 }[] ? V[] : string[];
+/**
+ * @internal — implementation detail of DocumentAttributeBuilder.qualifyWith().
+ *
+ * Phantom brand carrying typed props into the type system without changing
+ * the runtime attribute shape. `TProps` is `{ [propName]?: value | null }`
+ * inferred from the builders passed to .qualifyWith(). `TMultiple` tracks
+ * whether .multiple() was called.
+ */
+interface QualifiedDocumentBrand<TProps extends Record<string, unknown>, TMultiple extends boolean> {
+    readonly __qualifiedDocumentProps: TProps;
+    readonly __qualifiedDocumentMultiple: TMultiple;
+}
+/**
+ * @internal — used by DocumentAttributeBuilder.qualifyWith().
+ *
+ * Infers the props shape from a tuple of PropertyAttributeBuilders.
+ * Each builder contributes `{ [name]?: value | null }` to the result.
+ */
+type InferQualifiedProps<TBuilders extends readonly unknown[]> = {
+    [B in TBuilders[number] as B extends {
+        $infer: {
+            value: unknown;
+        };
+    } & {
+        _types: {
+            name: infer N extends string;
+        };
+    } ? N : never]?: (B extends {
+        $infer: {
+            value: infer V;
+        };
+    } ? V : never) | null;
+};
 /**
  * Maps an Attribute type to its runtime value type
  * Uses a flat lookup table + 3 special cases for option-based attributes
  * This avoids deep conditional nesting that causes TS2589 on large objects
  */
-type InferAttributeValue<A extends Attribute> = A extends StatusAttribute ? InferStatusValue<A> : A extends SelectAttribute ? InferSelectValue<A> : A extends MultiselectAttribute ? InferMultiselectValue<A> : A["type"] extends keyof AttributeValueMap ? AttributeValueMap[A["type"]] : unknown;
+type InferAttributeValue<A extends Attribute> = A extends DocumentAttribute & QualifiedDocumentBrand<infer TProps, infer TMultiple> ? TMultiple extends true ? Array<{
+    id: string;
+    props: TProps;
+}> : {
+    id: string;
+    props: TProps;
+} : A extends StatusAttribute ? InferStatusValue<A> : A extends SelectAttribute ? InferSelectValue<A> : A extends MultiselectAttribute ? InferMultiselectValue<A> : A["type"] extends keyof AttributeValueMap ? AttributeValueMap[A["type"]] : unknown;
 /**
  * Base type for custom attribute values added via UI
  * Supports all possible attribute value types
@@ -3150,6 +3189,26 @@ declare class DocumentSlotValidationError extends Error {
 }
 declare function validateSlotAgainstConfig(slotName: string, mimeType: string, slots: DocumentSlotConfig[]): DocumentSlotConfig;
 
+/**
+ * The set of attribute types allowed as relation/document properties.
+ * This is the complement of the internal FORBIDDEN_PROPERTY_TYPES list.
+ */
+declare const ALLOWED_PROPERTY_TYPES: readonly ["text", "textarea", "number", "checkbox", "date", "phone", "currency", "status", "select", "multiselect", "rating", "location"];
+interface BuilderLike {
+    build(): {
+        type: string;
+        name: string;
+    };
+}
+/**
+ * Validates and builds a PropertySchema from an array of attribute builders.
+ * Throws if any builder produces a forbidden attribute type.
+ *
+ * Preserved error message (byte-equivalent with RelationAttributeBuilder.qualifyWith):
+ * `Property type "<type>" is not supported in .qualifyWith()`
+ */
+declare function buildPropertySchema(builders: BuilderLike[]): PropertySchema;
+
 /**
  * Default empty value placeholder
  */
@@ -4175,10 +4234,10 @@ declare function rollup<TName extends string>(config: TypedBuilderConfig<TName>)
  *   .maxDocuments(10)
  * ```
  */
-declare class DocumentAttributeBuilder<TName extends string, TRequired extends boolean = false> extends BaseAttributeBuilder<DocumentAttribute> {
+declare class DocumentAttributeBuilder<TName extends string, TRequired extends boolean = false, TProps extends Record<string, unknown> = never, TMultiple extends boolean = false> extends BaseAttributeBuilder<DocumentAttribute> {
     readonly _types: {
         name: TName;
-        attribute: DocumentAttribute;
+        attribute: [TProps] extends [never] ? DocumentAttribute : DocumentAttribute & QualifiedDocumentBrand<TProps, TMultiple>;
         required: TRequired;
     };
     /**
@@ -4187,16 +4246,22 @@ declare class DocumentAttributeBuilder<TName extends string, TRequired extends b
      */
     readonly $infer: {
         /** The runtime value type for this attribute (document ID or array of IDs) */
-        value: string | string[];
+        value: [TProps] extends [never] ? string | string[] : TMultiple extends true ? Array<{
+            id: string;
+            props: TProps;
+        }> : {
+            id: string;
+            props: TProps;
+        };
         /** The full attribute definition type */
         definition: DocumentAttribute;
     };
     constructor(name: TName, label: string);
     /**
      * Allow multiple documents.
-     * Value becomes string[] instead of string.
+     * Value becomes string[] instead of string (or Array<{ id; props }> when qualified).
      */
-    multiple(): this;
+    multiple(): DocumentAttributeBuilder<TName, TRequired, TProps, true>;
     /**
      * Maximum number of documents (only applies when multiple: true).
      */
@@ -4222,14 +4287,27 @@ declare class DocumentAttributeBuilder<TName extends string, TRequired extends b
     attribute<TAttr extends Attribute>(builder: {
         build(): TAttr;
     }): this;
+    /**
+     * Add properties to qualify each document using existing attribute builders.
+     * Returns a new builder type that carries the inferred props shape for $infer.
+     *
+     * @example
+     * document({ name: "contracts", label: "Contracts" })
+     *   .multiple()
+     *   .qualifyWith(
+     *     select({ name: "kind", label: "Kind" }).options([...]),
+     *     number({ name: "amount", label: "Amount" }).min(0),
+     *   )
+     */
+    qualifyWith<const TBuilders extends readonly PropertyAttributeBuilder[]>(...builders: TBuilders): DocumentAttributeBuilder<TName, TRequired, InferQualifiedProps<TBuilders>, TMultiple>;
     /**
      * Mark this attribute as required.
      */
-    required(): DocumentAttributeBuilder<TName, true>;
+    required(): DocumentAttributeBuilder<TName, true, TProps, TMultiple>;
     /**
      * Mark this attribute as optional (undo required).
      */
-    optional(): DocumentAttributeBuilder<TName, false>;
+    optional(): DocumentAttributeBuilder<TName, false, TProps, TMultiple>;
 }
 /**
  * Create a document attribute.
@@ -5176,10 +5254,6 @@ declare class DetailViewBuilder {
      * Build the final view definition
      */
     build(): DetailViewDefinition;
-    /**
-     * Validate view name format (kebab-case)
-     */
-    private validateName;
 }
 /**
  * Create a new detail view builder
@@ -5341,10 +5415,6 @@ declare class ListViewBuilder {
      * Build the final list view definition
      */
     build(): ListViewDefinition;
-    /**
-     * Validate view name format (kebab-case)
-     */
-    private validateName;
 }
 /**
  * Builder for configuring tabs in list views.
@@ -6483,4 +6553,4 @@ declare const OPERATOR_SPECS: Record<FilterOperator, OperatorSpec>;
  */
 declare function evaluateFilterState(state: FilterState, values: Record<string, unknown>, attributes: Attribute[]): boolean;
 
-export { type AIAvailableModel, type AIBatchQuestion, type AIBatchQuestionAnswer, type AIBatchQuestionOption, type AIChatMessage, type AIChatMessagePart, type AIChatMessagePartType, type AICompactionSummary, type AIMemoryEntry, type AIMemoryType, type AIMessageRole, type AIProviderMetrics, type AIQuestion, type AIQuestionAnswer, type AIQuestionOption, type AIQuestionType, type AITodoItem, type AITodoList, type AITodoStatus, type AIToolCall, type AIToolCallStatus, type AIUsageMetrics, ALL_ACTIONS, ALL_SYSTEM_RESOURCES, type AccessAction, type AccessActionList, AccessDeniedError, type AccessLevel, type AccessPolicy, type AccessPolicyPreset, type AccessResourceType, type Action, ActivityTabConfig, type Actor, type ActorRoleAssignment, type ActorStatus, type ActorType, type AddAttributeInput, type AgentConfig, type AgentContextEntry, type AgentDashboard, type AgentDefinition, type AgentEvent, type AgentExecutionConfig, type AgentExecutionPolicy, type AgentMessageAttachment, type AgentMessagePart, type AgentQuestion, type AgentRun, type AgentRunStatus, type AgentSchedule, type AgentSession, type AgentSessionMessage, type AgentSessionMode, type AgentSessionStatus, type AgentToolCall, type AgentTriggerDefinition, type AgentTriggerType, type ApiKey, type ApiKeyAuthContext, type ApiKeyPermission, type ApiKeyWithSecret, type AssignActorRoleInput, type AssignRoleInput, Attribute, AttributeGroupField, AttributeInUseError, AttributeNotFoundError, AttributeType, type AttributeUsage, type AuditAction, type AuditActorType, type AuditChange, type AuditListOptions, type AuditLogEntry, type AuditResourceType, type AuditServiceOptions, type AuditSortField, BEHAVIOR_PROPERTIES, BilateralConfig, type BoundingBox, type BuilderConfig, CheckboxAttribute, CompletionStatus, ConcurrentModificationError, ConfigOverrides, type CountMode, type CreateActorInput, type CreateApiKeyInput, type CreateAuditLogInput, type CreateCustomObjectInput, type CreateDBAttribute, type CreateDBForm, type CreateDBFormSubmission, type CreateDBObject, type CreateDBView, type CreateDBViewOverlay, type CreateFile, CreateMode, type CreateObjectRecord, type CreatePermissionInput, type CreateRoleInput, type CreateSandboxExecution, type CreateUserProfile, type CreateViewInput, type CriticConfig, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, type DBAttribute, type DBForm, type DBFormSubmission, type DBObject, type DBView, type DBViewOverlay, DB_COLUMN_FIELDS, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DOCUMENT_SYSTEM_ATTRIBUTES, DateAttribute, type DefaultRoleName, DetailViewBuilder, DetailViewConfig, DetailViewDefinition, DetailViewLayout, DocumentAttribute, DocumentSlotConfig, DocumentSlotValidationError, DocumentsTabConfig, type DomainEvent, DuplicateError, EMPTY_VALUE_PLACEHOLDER, type EffectivePermissions, type EventDataMap, type EventType, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, FORM_FORBIDDEN_ATTRIBUTE_TYPES, FeatureFlagDefinition, FeatureFlagsRepository, FeatureGate, Field, FieldGroup, type File, FileAttribute, type FileListOptions, type FileVisibility, FilterOperator, FilterState, FilterValue, FlagLevel, FlagRegistry, FlagService, FlagValueType, ForbiddenError, FormBuilder, type FormDefinition, type FormFieldRef, type FormFieldsRow, type FormFreeFieldRef, type FormHeadingRow, FormRegistry, type FormRow, FormRowBuilder, type FormSeparatorRow, type FormSlot, type FormSlotFieldRef, type FormStatus, type FormStep, FormStepBuilder, type FormSubmission, type FormSubmissionStatus, type FormSubmittedAgentEvent, type FormTextRow, FormulaAttribute, type FormulaResult, FormulaReturnType, type GeocodingAdapter, type GeocodingAutocompleteParams, type GeocodingParams, type GeocodingSuggestion, type GlobalSearchGroupedOptions, type GlobalSearchGroupedResult, type GlobalSearchOptions, type GlobalSearchResultItem, type GrantResourceAccessInput, Group, GroupBuilder, IDENTITY_PROPERTIES, type InferAttributeValue, InvalidPathError, type InviteUserInput, type ListOptions, ListViewBuilder, ListViewConfig, ListViewDefinition, ListViewTab, ListViewTabConfigBuilder, Location, LocationAttribute, LocationGranularity, MaxDepthExceededError, MemoryNotFoundError, type MentionEntityType, type MentionReference, type MentionedContext, type MentionedEntityContext, MigrationDefinition, type ModelDefinition, MultiRelationAttribute, MultiselectAttribute, NoopGeocodingAdapter, NotFoundError, NotImplementedError, NumberAttribute, OPERATOR_SPECS, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, type ObjectPermissions, ObjectRecord, ObjectReferencedError, type OcrAdapter, type OcrInput, type OcrOptions, type OcrPage, type OcrResult, type OcrTextBlock, type OperatorSpec, Option, PRESENTATION_PROPERTIES, type PageInfo, type PageOptions, type PageResponse, type PathCardinality, type PathSegment, type PathSegmentType, type Permission, type PermissionScope, Phone, PhoneAttribute, type PolicyContext, PolicyViolationError, type PrincipalType, ProtectedResourceError, ProtectedRoleError, type ProviderName, type QuestionResponse, type QuestionStatus, RatingAttribute, type ReasoningPartData, type RecordAgentEvent, type RecordMetadata, RecordNotFoundError, type RecordPolicy, type RecordReference, RecordReferencedError, RelationAttribute, RelationGroup, RelationGroupBuilder, type RelationOption, type RelationOptionsResponse, RelationTarget, RepositoryError, type RepositoryOperation, ResolvedFlag, type ResourceAccess, type ResourceRef, type RetryPolicy, type ReverseGeocodingParams, RichtextAttribute, RichtextFeature, RichtextTabConfig, type Role, RoleNotFoundError, RollupAttribute, RollupFunction, STANDARD_SCHEMA_VENDOR, SYSTEM_ATTRIBUTES, SYSTEM_ATTRIBUTE_I18N_KEYS, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, type SandboxExecution, type SandboxExecutionInput, type SandboxExecutionResult, type SandboxExecutionStatus, type SandboxMode, type SandboxTrigger, SchemaError, SchemaErrorCode, type SchemaResolver, type SearchOptions, SelectAttribute, SidePanelConfig, type SidebarExtraItem, SingleRelationAttribute, type SlotMode, SortRule, type SpecificAccessAction, type StandardSchemaIssue, type StandardSchemaResult, StaticFlagDefault, StatusAttribute, StorageError, type StorageOperation, type StorageProvider, type StreamEventCompactionEnd, type StreamEventCompactionFailed, type StreamEventCompactionStart, type StreamEventMessagePersisted, SyncError, type SystemAttribute, type SystemAttributeI18nKey, type SystemFields, type SystemPermissions, type SystemResource, Tab, TabBuilder, TableTab, TableTabConfig, TenantId, TextAreaAttribute, TextAttribute, type TextPartData, type ThinkingPartData, type TimeoutPolicy, Timestamps, type ToolPartData, type ToolPartState, type TriggerEventType, USER_STATUSES, type UpdateActorInput, type UpdateDBAttribute, type UpdateDBForm, type UpdateDBFormSubmission, type UpdateDBObject, type UpdateDBView, type UpdateDBViewOverlay, type UpdateFile, type UpdateObjectInput, type UpdateRoleInput, type UpdateUserProfile, type UpdateViewInput, type UpsertAccessPolicyInput, type UpsertDBAttribute, type UpsertDBObject, type UpsertDBView, UserAttribute, type UserProfile, type UserRoleAssignment, type UserStatus, Uuid, ValidationError, type ValidationErrorDetail, ViewConfig, ViewDefinition, ViewType, type WithCustomAttributes$1 as WithCustomAttributes, accessLevelToActions, actionsToAccessLevel, applyPipes, booleanFlag, checkbox, createFlagRegistry, createFlagService, createStandardSchemaProps, currency, date, detailView, document, evaluateFilterState, evaluateFormula, evaluateFormulaAttribute, evaluateFormulaWithResult, extractAttributeNames, extractFormulaVariables, extractRelationNames, extractRelationReferences, file, flagRegistry, flattenRelationsForEval, form, formRegistry, formatAttributeValue, formatFormulaResult, formula, generateDefaultDetailView, generateDefaultListView, getActiveTab, getErrorMessage, getPathDepth, getRelationPath, getSystemAttributeI18nKey, getSystemAttributeList, getTargetAttributeName, group, hasRelationReferences, isAttributeInUseError, isDefaultRole, isDocumentAttribute, isEmptyObject, isFormDefinition, isFormFieldsRow, isFormFreeFieldRef, isFormHeadingRow, isFormSeparatorRow, isFormSlotFieldRef, isFormTextRow, isLabelExpression, isNotEmpty, isNotFoundError, isObjectReferencedError, isProtectedResourceError, isRecordReferencedError, isSchemaError, isStandardSchema, isValidationError, jsonFlag, listView, location, matchesMime, multiselect, normaliseDocumentSlots, number, numberFlag, object, parsePath, pathHasManyCardinality, phone, rating, registry, relation, relationGroup, renderLabelExpression, resetViewToDefault, richtext, rollup, select, status, stringFlag, text, textarea, toUndefinedIfEmpty, user, validateAttributeName, validateFormulaExpression, validatePath, validateSlotAgainstConfig, viewRegistry };
+export { type AIAvailableModel, type AIBatchQuestion, type AIBatchQuestionAnswer, type AIBatchQuestionOption, type AIChatMessage, type AIChatMessagePart, type AIChatMessagePartType, type AICompactionSummary, type AIMemoryEntry, type AIMemoryType, type AIMessageRole, type AIProviderMetrics, type AIQuestion, type AIQuestionAnswer, type AIQuestionOption, type AIQuestionType, type AITodoItem, type AITodoList, type AITodoStatus, type AIToolCall, type AIToolCallStatus, type AIUsageMetrics, ALLOWED_PROPERTY_TYPES, ALL_ACTIONS, ALL_SYSTEM_RESOURCES, type AccessAction, type AccessActionList, AccessDeniedError, type AccessLevel, type AccessPolicy, type AccessPolicyPreset, type AccessResourceType, type Action, ActivityTabConfig, type Actor, type ActorRoleAssignment, type ActorStatus, type ActorType, type AddAttributeInput, type AgentConfig, type AgentContextEntry, type AgentDashboard, type AgentDefinition, type AgentEvent, type AgentExecutionConfig, type AgentExecutionPolicy, type AgentMessageAttachment, type AgentMessagePart, type AgentQuestion, type AgentRun, type AgentRunStatus, type AgentSchedule, type AgentSession, type AgentSessionMessage, type AgentSessionMode, type AgentSessionStatus, type AgentToolCall, type AgentTriggerDefinition, type AgentTriggerType, type ApiKey, type ApiKeyAuthContext, type ApiKeyPermission, type ApiKeyWithSecret, type AssignActorRoleInput, type AssignRoleInput, Attribute, AttributeGroupField, AttributeInUseError, AttributeNotFoundError, AttributeType, type AttributeUsage, type AuditAction, type AuditActorType, type AuditChange, type AuditListOptions, type AuditLogEntry, type AuditResourceType, type AuditServiceOptions, type AuditSortField, BEHAVIOR_PROPERTIES, BilateralConfig, type BoundingBox, type BuilderConfig, CheckboxAttribute, CompletionStatus, ConcurrentModificationError, ConfigOverrides, type CountMode, type CreateActorInput, type CreateApiKeyInput, type CreateAuditLogInput, type CreateCustomObjectInput, type CreateDBAttribute, type CreateDBForm, type CreateDBFormSubmission, type CreateDBObject, type CreateDBView, type CreateDBViewOverlay, type CreateFile, CreateMode, type CreateObjectRecord, type CreatePermissionInput, type CreateRoleInput, type CreateSandboxExecution, type CreateUserProfile, type CreateViewInput, type CriticConfig, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, type DBAttribute, type DBForm, type DBFormSubmission, type DBObject, type DBView, type DBViewOverlay, DB_COLUMN_FIELDS, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DOCUMENT_SYSTEM_ATTRIBUTES, DateAttribute, type DefaultRoleName, DetailViewBuilder, DetailViewConfig, DetailViewDefinition, DetailViewLayout, DocumentAttribute, DocumentSlotConfig, DocumentSlotValidationError, DocumentsTabConfig, type DomainEvent, DuplicateError, EMPTY_VALUE_PLACEHOLDER, type EffectivePermissions, type EventDataMap, type EventType, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, FORM_FORBIDDEN_ATTRIBUTE_TYPES, FeatureFlagDefinition, FeatureFlagsRepository, FeatureGate, Field, FieldGroup, type File, FileAttribute, type FileListOptions, type FileVisibility, FilterOperator, FilterState, FilterValue, FlagLevel, FlagRegistry, FlagService, FlagValueType, ForbiddenError, FormBuilder, type FormDefinition, type FormFieldRef, type FormFieldsRow, type FormFreeFieldRef, type FormHeadingRow, FormRegistry, type FormRow, FormRowBuilder, type FormSeparatorRow, type FormSlot, type FormSlotFieldRef, type FormStatus, type FormStep, FormStepBuilder, type FormSubmission, type FormSubmissionStatus, type FormSubmittedAgentEvent, type FormTextRow, FormulaAttribute, type FormulaResult, FormulaReturnType, type GeocodingAdapter, type GeocodingAutocompleteParams, type GeocodingParams, type GeocodingSuggestion, type GlobalSearchGroupedOptions, type GlobalSearchGroupedResult, type GlobalSearchOptions, type GlobalSearchResultItem, type GrantResourceAccessInput, Group, GroupBuilder, IDENTITY_PROPERTIES, type InferAttributeValue, type InferQualifiedProps, InvalidPathError, type InviteUserInput, type ListOptions, ListViewBuilder, ListViewConfig, ListViewDefinition, ListViewTab, ListViewTabConfigBuilder, Location, LocationAttribute, LocationGranularity, MaxDepthExceededError, MemoryNotFoundError, type MentionEntityType, type MentionReference, type MentionedContext, type MentionedEntityContext, MigrationDefinition, type ModelDefinition, MultiRelationAttribute, MultiselectAttribute, NoopGeocodingAdapter, NotFoundError, NotImplementedError, NumberAttribute, OPERATOR_SPECS, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, type ObjectPermissions, ObjectRecord, ObjectReferencedError, type OcrAdapter, type OcrInput, type OcrOptions, type OcrPage, type OcrResult, type OcrTextBlock, type OperatorSpec, Option, PRESENTATION_PROPERTIES, type PageInfo, type PageOptions, type PageResponse, type PathCardinality, type PathSegment, type PathSegmentType, type Permission, type PermissionScope, Phone, PhoneAttribute, type PolicyContext, PolicyViolationError, type PrincipalType, PropertySchema, ProtectedResourceError, ProtectedRoleError, type ProviderName, type QualifiedDocumentBrand, type QuestionResponse, type QuestionStatus, RatingAttribute, type ReasoningPartData, type RecordAgentEvent, type RecordMetadata, RecordNotFoundError, type RecordPolicy, type RecordReference, RecordReferencedError, RelationAttribute, RelationGroup, RelationGroupBuilder, type RelationOption, type RelationOptionsResponse, RelationTarget, RepositoryError, type RepositoryOperation, ResolvedFlag, type ResourceAccess, type ResourceRef, type RetryPolicy, type ReverseGeocodingParams, RichtextAttribute, RichtextFeature, RichtextTabConfig, type Role, RoleNotFoundError, RollupAttribute, RollupFunction, STANDARD_SCHEMA_VENDOR, SYSTEM_ATTRIBUTES, SYSTEM_ATTRIBUTE_I18N_KEYS, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, type SandboxExecution, type SandboxExecutionInput, type SandboxExecutionResult, type SandboxExecutionStatus, type SandboxMode, type SandboxTrigger, SchemaError, SchemaErrorCode, type SchemaResolver, type SearchOptions, SelectAttribute, SidePanelConfig, type SidebarExtraItem, SingleRelationAttribute, type SlotMode, SortRule, type SpecificAccessAction, type StandardSchemaIssue, type StandardSchemaResult, StaticFlagDefault, StatusAttribute, StorageError, type StorageOperation, type StorageProvider, type StreamEventCompactionEnd, type StreamEventCompactionFailed, type StreamEventCompactionStart, type StreamEventMessagePersisted, SyncError, type SystemAttribute, type SystemAttributeI18nKey, type SystemFields, type SystemPermissions, type SystemResource, Tab, TabBuilder, TableTab, TableTabConfig, TenantId, TextAreaAttribute, TextAttribute, type TextPartData, type ThinkingPartData, type TimeoutPolicy, Timestamps, type ToolPartData, type ToolPartState, type TriggerEventType, USER_STATUSES, type UpdateActorInput, type UpdateDBAttribute, type UpdateDBForm, type UpdateDBFormSubmission, type UpdateDBObject, type UpdateDBView, type UpdateDBViewOverlay, type UpdateFile, type UpdateObjectInput, type UpdateRoleInput, type UpdateUserProfile, type UpdateViewInput, type UpsertAccessPolicyInput, type UpsertDBAttribute, type UpsertDBObject, type UpsertDBView, UserAttribute, type UserProfile, type UserRoleAssignment, type UserStatus, Uuid, ValidationError, type ValidationErrorDetail, ViewConfig, ViewDefinition, ViewType, type WithCustomAttributes$1 as WithCustomAttributes, accessLevelToActions, actionsToAccessLevel, applyPipes, booleanFlag, buildPropertySchema, checkbox, createFlagRegistry, createFlagService, createStandardSchemaProps, currency, date, detailView, document, evaluateFilterState, evaluateFormula, evaluateFormulaAttribute, evaluateFormulaWithResult, extractAttributeNames, extractFormulaVariables, extractRelationNames, extractRelationReferences, file, flagRegistry, flattenRelationsForEval, form, formRegistry, formatAttributeValue, formatFormulaResult, formula, generateDefaultDetailView, generateDefaultListView, getActiveTab, getErrorMessage, getPathDepth, getRelationPath, getSystemAttributeI18nKey, getSystemAttributeList, getTargetAttributeName, group, hasRelationReferences, isAttributeInUseError, isDefaultRole, isDocumentAttribute, isEmptyObject, isFormDefinition, isFormFieldsRow, isFormFreeFieldRef, isFormHeadingRow, isFormSeparatorRow, isFormSlotFieldRef, isFormTextRow, isLabelExpression, isNotEmpty, isNotFoundError, isObjectReferencedError, isProtectedResourceError, isRecordReferencedError, isSchemaError, isStandardSchema, isValidationError, jsonFlag, listView, location, matchesMime, multiselect, normaliseDocumentSlots, number, numberFlag, object, parsePath, pathHasManyCardinality, phone, rating, registry, relation, relationGroup, renderLabelExpression, resetViewToDefault, richtext, rollup, select, status, stringFlag, text, textarea, toUndefinedIfEmpty, user, validateAttributeName, validateFormulaExpression, validatePath, validateSlotAgainstConfig, viewRegistry };

package/dist/index.js

@@ -748,6 +748,33 @@ function validateSlotAgainstConfig(slotName, mimeType, slots) {
   }
   return slot;
 }
+
+// src/lib/qualify-with.ts
+var ALLOWED_PROPERTY_TYPES = Object.freeze([
+  "text",
+  "textarea",
+  "number",
+  "checkbox",
+  "date",
+  "phone",
+  "currency",
+  "status",
+  "select",
+  "multiselect",
+  "rating",
+  "location"
+]);
+function buildPropertySchema(builders) {
+  const definitions = [];
+  for (const builder of builders) {
+    const attr = builder.build();
+    if (!ALLOWED_PROPERTY_TYPES.includes(attr.type)) {
+      throw new Error(`Property type "${attr.type}" is not supported in .qualifyWith()`);
+    }
+    definitions.push(attr);
+  }
+  return { definitions };
+}
 var EMPTY_VALUE_PLACEHOLDER = "\u2014";
 function formatText(value) {
   return String(value);
@@ -1263,15 +1290,6 @@ function validateOptions(options, attributeName) {
 }
 
 // src/builders/attribute-builders.ts
-var FORBIDDEN_PROPERTY_TYPES = [
-  "formula",
-  "rollup",
-  "relation",
-  "file",
-  "user",
-  "document",
-  "richtext"
-];
 function asMutableArray(arr) {
   return arr;
 }
@@ -1879,14 +1897,7 @@ var BaseRelationAttributeBuilder = class extends BaseAttributeBuilder {
         '.qualifyWith() must be called AFTER .to(). Example: relation({ name: "companies" }).to("companies").qualifyWith(...)'
       );
     }
-    const definitions = builders.map((builder) => {
-      const attr = builder.build();
-      if (FORBIDDEN_PROPERTY_TYPES.includes(attr.type)) {
-        throw new Error(`Property type "${attr.type}" is not supported in .qualifyWith()`);
-      }
-      return attr;
-    });
-    this.attr.properties = { definitions };
+    this.attr.properties = buildPropertySchema(builders);
     return this;
   }
   /**
@@ -2140,7 +2151,7 @@ var DocumentAttributeBuilder = class extends BaseAttributeBuilder {
   }
   /**
    * Allow multiple documents.
-   * Value becomes string[] instead of string.
+   * Value becomes string[] instead of string (or Array<{ id; props }> when qualified).
    */
   multiple() {
     this.attr.multiple = true;
@@ -2184,6 +2195,24 @@ var DocumentAttributeBuilder = class extends BaseAttributeBuilder {
     this.attr.attributes = [...this.attr.attributes, builder.build()];
     return this;
   }
+  /**
+   * Add properties to qualify each document using existing attribute builders.
+   * Returns a new builder type that carries the inferred props shape for $infer.
+   *
+   * @example
+   * document({ name: "contracts", label: "Contracts" })
+   *   .multiple()
+   *   .qualifyWith(
+   *     select({ name: "kind", label: "Kind" }).options([...]),
+   *     number({ name: "amount", label: "Amount" }).min(0),
+   *   )
+   */
+  qualifyWith(...builders) {
+    this.attr.properties = buildPropertySchema(
+      builders
+    );
+    return this;
+  }
   /**
    * Mark this attribute as required.
    */
@@ -3006,6 +3035,35 @@ var RelationGroupBuilder = class {
     return this.data;
   }
 };
+function assertViewVersion(version) {
+  if (version < 1) throw new Error("View version must be >= 1");
+}
+function assertUniqueBy(items, getKey, buildError) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    const key = getKey(item);
+    if (seen.has(key)) {
+      throw new Error(buildError(key));
+    }
+    seen.add(key);
+  }
+}
+function validateViewName(name, builderName, examples) {
+  const viewNameSchema = z3.z.string().min(1, "View name cannot be empty").max(63, "View name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
+    message: `Invalid view name format.
+Name must be in kebab-case:
+  \u2705 Valid: ${examples.valid}
+  \u274C Invalid: ${examples.invalid}`
+  });
+  try {
+    viewNameSchema.parse(name);
+  } catch (error) {
+    if (error instanceof z3.z.ZodError) {
+      throw new Error(`[${builderName}] ${error.issues[0].message}`);
+    }
+    throw error;
+  }
+}
 var TableTabConfig = class {
   /** @internal */
   constructor(view, tabData) {
@@ -3416,7 +3474,10 @@ var TabBuilder = class {
 var DetailViewBuilder = class {
   constructor(name, label) {
     this._version = 1;
-    this.validateName(name);
+    validateViewName(name, "DetailViewBuilder", {
+      valid: "'detail', 'list-view', 'company-detail'",
+      invalid: "'Detail', 'listView', 'list_view'"
+    });
     this.data = {
       name,
       label,
@@ -3484,7 +3545,7 @@ var DetailViewBuilder = class {
    * @default 1
    */
   version(v) {
-    if (v < 1) throw new Error("View version must be >= 1");
+    assertViewVersion(v);
     this._version = v;
     return this;
   }
@@ -3528,13 +3589,11 @@ var DetailViewBuilder = class {
     if (this.data.tabs.length === 0) {
       throw new Error("[DetailViewBuilder] At least one tab is required");
     }
-    const tabNames = /* @__PURE__ */ new Set();
-    for (const tab of this.data.tabs) {
-      if (tabNames.has(tab.name)) {
-        throw new Error(`[DetailViewBuilder] Duplicate tab name "${tab.name}"`);
-      }
-      tabNames.add(tab.name);
-    }
+    assertUniqueBy(
+      this.data.tabs,
+      (tab) => tab.name,
+      (name) => `[DetailViewBuilder] Duplicate tab name "${name}"`
+    );
     if (this.data.layout === "modal") {
       if (this.data.tabs.length !== 1) {
         throw new Error("[DetailViewBuilder] Modal views must have exactly one tab");
@@ -3564,22 +3623,6 @@ var DetailViewBuilder = class {
       schema_version: this._version
     };
   }
-  /**
-   * Validate view name format (kebab-case)
-   */
-  validateName(name) {
-    const viewNameSchema = z3.z.string().min(1, "View name cannot be empty").max(63, "View name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
-      message: "Invalid view name format.\nName must be in kebab-case:\n  \u2705 Valid: 'detail', 'list-view', 'company-detail'\n  \u274C Invalid: 'Detail', 'listView', 'list_view'"
-    });
-    try {
-      viewNameSchema.parse(name);
-    } catch (error) {
-      if (error instanceof z3.z.ZodError) {
-        throw new Error(`[DetailViewBuilder] ${error.issues[0].message}`);
-      }
-      throw error;
-    }
-  }
 };
 function detailView(name, label) {
   return new DetailViewBuilder(name, label);
@@ -3587,7 +3630,10 @@ function detailView(name, label) {
 var ListViewBuilder = class {
   constructor(name, label) {
     this._version = 1;
-    this.validateName(name);
+    validateViewName(name, "ListViewBuilder", {
+      valid: "'default', 'list-view', 'active-contacts'",
+      invalid: "'Default', 'listView', 'list_view'"
+    });
     this.data = {
       name,
       label,
@@ -3637,7 +3683,7 @@ var ListViewBuilder = class {
    * @default 1
    */
   version(v) {
-    if (v < 1) throw new Error("View version must be >= 1");
+    assertViewVersion(v);
     this._version = v;
     return this;
   }
@@ -3679,13 +3725,11 @@ var ListViewBuilder = class {
     if (this.data.tabs.length === 0) {
       throw new Error("[ListViewBuilder] At least one tab is required");
     }
-    const tabIds = /* @__PURE__ */ new Set();
-    for (const tab of this.data.tabs) {
-      if (tabIds.has(tab.id)) {
-        throw new Error(`[ListViewBuilder] Duplicate tab id "${tab.id}"`);
-      }
-      tabIds.add(tab.id);
-    }
+    assertUniqueBy(
+      this.data.tabs,
+      (tab) => tab.id,
+      (id) => `[ListViewBuilder] Duplicate tab id "${id}"`
+    );
     const defaultTabs = this.data.tabs.filter((t) => t.default);
     if (defaultTabs.length > 1) {
       throw new Error("[ListViewBuilder] Only one tab can be marked as default");
@@ -3740,22 +3784,6 @@ var ListViewBuilder = class {
       schema_version: this._version
     };
   }
-  /**
-   * Validate view name format (kebab-case)
-   */
-  validateName(name) {
-    const viewNameSchema = z3.z.string().min(1, "View name cannot be empty").max(63, "View name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
-      message: "Invalid view name format.\nName must be in kebab-case:\n  \u2705 Valid: 'default', 'list-view', 'active-contacts'\n  \u274C Invalid: 'Default', 'listView', 'list_view'"
-    });
-    try {
-      viewNameSchema.parse(name);
-    } catch (error) {
-      if (error instanceof z3.z.ZodError) {
-        throw new Error(`[ListViewBuilder] ${error.issues[0].message}`);
-      }
-      throw error;
-    }
-  }
 };
 var ListViewTabConfigBuilder = class _ListViewTabConfigBuilder {
   /** @internal */
@@ -5575,6 +5603,10 @@ Object.defineProperty(exports, "createFormAttributeValidator", {
   enumerable: true,
   get: function () { return chunk64R5X3DF_js.createFormAttributeValidator; }
 });
+Object.defineProperty(exports, "validateDraft", {
+  enumerable: true,
+  get: function () { return chunk64R5X3DF_js.validateDraft; }
+});
 Object.defineProperty(exports, "validateDraftOrThrow", {
   enumerable: true,
   get: function () { return chunk64R5X3DF_js.validateDraftOrThrow; }
@@ -5595,6 +5627,7 @@ Object.defineProperty(exports, "formatZodErrors", {
   enumerable: true,
   get: function () { return chunkT225DB55_js.formatZodErrors; }
 });
+exports.ALLOWED_PROPERTY_TYPES = ALLOWED_PROPERTY_TYPES;
 exports.ALL_ACTIONS = ALL_ACTIONS;
 exports.ALL_SYSTEM_RESOURCES = ALL_SYSTEM_RESOURCES;
 exports.AccessDeniedError = AccessDeniedError;
@@ -5670,6 +5703,7 @@ exports.accessLevelToActions = accessLevelToActions;
 exports.actionsToAccessLevel = actionsToAccessLevel;
 exports.applyPipes = applyPipes;
 exports.booleanFlag = booleanFlag;
+exports.buildPropertySchema = buildPropertySchema;
 exports.checkbox = checkbox;
 exports.createFlagRegistry = createFlagRegistry;
 exports.createFlagService = createFlagService;