@stndrds/schema 0.1.0-alpha.63 → 0.1.0-alpha.64

package/dist/{validators-BPIB7Miq.d.ts → validators-CEzdvxEq.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { CurrencyCode, IconName, ColorId, CountryIso3, MimeType } from '@stndrds/constants';
+import { IconName, CountryIso3, CurrencyCode, ColorId, MimeType } from '@stndrds/constants';
 import { Uuid } from './utils.js';
 
 /**
@@ -152,9 +152,9 @@ interface FeatureFlagsConfig {
 }
 
 /**
- * Allowed property types in .qualifyWith()
+ * Allowed attribute types in .qualifyWith()
  *
- * IMPORTANT: Complex types (formula, rollup, relation, file, user, document)
+ * IMPORTANT: Complex types (formula, rollup, relation, file, user, document, richtext)
  * are NOT supported to avoid duplicating backend behavior.
  */
 type PropertyType = "text" | "textarea" | "number" | "checkbox" | "date" | "phone" | "currency" | "status" | "select" | "multiselect" | "rating" | "location";
@@ -164,132 +164,29 @@ type PropertyType = "text" | "textarea" | "number" | "checkbox" | "date" | "phon
 declare const FORBIDDEN_PROPERTY_TYPES: readonly ["formula", "rollup", "relation", "file", "user", "document", "richtext"];
 type ForbiddenPropertyType = (typeof FORBIDDEN_PROPERTY_TYPES)[number];
 /**
- * Base interface for all property definitions
- */
-interface BasePropertyDefinition {
-    name: string;
-    label?: string;
-    required?: boolean;
-    description?: string;
-}
-/**
- * Text property definition
- */
-interface TextPropertyDefinition extends BasePropertyDefinition {
-    type: "text";
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    placeholder?: string;
-}
-/**
- * Textarea property definition
- */
-interface TextareaPropertyDefinition extends BasePropertyDefinition {
-    type: "textarea";
-    minLength?: number;
-    maxLength?: number;
-    placeholder?: string;
-}
-/**
- * Number property definition
- */
-interface NumberPropertyDefinition extends BasePropertyDefinition {
-    type: "number";
-    min?: number;
-    max?: number;
-    decimal?: number;
-    integer?: boolean;
-    placeholder?: string;
-}
-/**
- * Checkbox property definition
- */
-interface CheckboxPropertyDefinition extends BasePropertyDefinition {
-    type: "checkbox";
-}
-/**
- * Date property definition
- */
-interface DatePropertyDefinition extends BasePropertyDefinition {
-    type: "date";
-    includeTime?: boolean;
-    min?: string;
-    max?: string;
-}
-/**
- * Phone property definition
- */
-interface PhonePropertyDefinition extends BasePropertyDefinition {
-    type: "phone";
-}
-/**
- * Currency property definition
- */
-interface CurrencyPropertyDefinition extends BasePropertyDefinition {
-    type: "currency";
-    currency?: CurrencyCode;
-    min?: number;
-    max?: number;
-}
-/**
- * Status property definition
- */
-interface StatusPropertyDefinition extends BasePropertyDefinition {
-    type: "status";
-    options: Array<Option & {
-        group: StatusGroup;
-    }>;
-}
-/**
- * Select property definition
- */
-interface SelectPropertyDefinition extends BasePropertyDefinition {
-    type: "select";
-    options: Option[];
-}
-/**
- * Multiselect property definition
- */
-interface MultiselectPropertyDefinition extends BasePropertyDefinition {
-    type: "multiselect";
-    options: Option[];
-    maxSelections?: number;
-}
-/**
- * Rating property definition
- */
-interface RatingPropertyDefinition extends BasePropertyDefinition {
-    type: "rating";
-    max?: number;
-    icon?: IconName;
-}
-/**
- * Location property definition
- */
-interface LocationPropertyDefinition extends BasePropertyDefinition {
-    type: "location";
-}
-/**
- * Union of all property definitions
+ * Union of attribute types allowed as qualified relation properties.
+ *
+ * These are the same Attribute types used for object attributes,
+ * restricted to simple types that don't require complex backend duplication.
  */
-type PropertyDefinition = TextPropertyDefinition | TextareaPropertyDefinition | NumberPropertyDefinition | CheckboxPropertyDefinition | DatePropertyDefinition | PhonePropertyDefinition | CurrencyPropertyDefinition | StatusPropertyDefinition | SelectPropertyDefinition | MultiselectPropertyDefinition | RatingPropertyDefinition | LocationPropertyDefinition;
+type PropertyAttribute = TextAttribute | TextAreaAttribute | NumberAttribute | CheckboxAttribute | DateAttribute | PhoneAttribute | CurrencyAttribute | StatusAttribute | SelectAttribute | MultiselectAttribute | RatingAttribute | LocationAttribute;
 /**
- * Schema defining properties for a qualified relation
+ * Schema defining properties for a qualified relation.
+ *
+ * Uses the same Attribute types as object attributes, enabling DRY builders:
  *
  * @example
  * ```typescript
- * const schema: PropertySchema = {
- *   definitions: [
- *     { name: "role", type: "select", options: [...], required: true },
- *     { name: "shares", type: "number", min: 0 },
- *     { name: "percentage", type: "number", min: 0, max: 100, decimal: 2 }
- *   ]
- * };
+ * relation({ name: "companies", label: "Companies" })
+ *   .to("companies").many()
+ *   .qualifyWith(
+ *     select({ name: "role", label: "Role" }).options([...]).required(),
+ *     number({ name: "shares", label: "Shares" }).min(0),
+ *   )
  * ```
  */
 interface PropertySchema {
-    definitions: PropertyDefinition[];
+    definitions: PropertyAttribute[];
 }
 
 type AttributeType = "text" | "textarea" | "richtext" | "number" | "checkbox" | "date" | "phone" | "currency" | "status" | "location" | "select" | "multiselect" | "file" | "user" | "relation" | "rating" | "formula" | "rollup" | "document";
@@ -448,6 +345,20 @@ interface UserAttribute extends BaseAttribute<string> {
  * Use with `.toAny()` builder method
  */
 declare const RELATION_TARGET_ANY: "*";
+/**
+ * Configuration for bilateral synchronization (bidirectional relations)
+ */
+interface BilateralConfig {
+    /** Target object containing the inverse attribute */
+    object: string;
+    /** Name of the inverse attribute */
+    attribute: string;
+    /** Optional cardinality override (inferred by default) */
+    cardinality?: "one" | "many";
+    /** When true, this side owns the storage direction for qualified properties.
+     *  Set to false on the inverse side (enriched at read time). */
+    storageOwner?: boolean;
+}
 /**
  * Target object for a relation - defines which objects can be linked
  */
@@ -479,6 +390,8 @@ interface RelationAttributeBase extends Omit<BaseAttribute<unknown>, "defaultVal
     targets: RelationTarget[];
     /** Optional properties schema for qualified relations */
     properties?: PropertySchema;
+    /** Configuration for bilateral synchronization (opt-in) */
+    bilateral?: BilateralConfig;
 }
 /**
  * Single relation attribute (one-to-one or many-to-one)
@@ -537,6 +450,18 @@ type RelationAttribute = SingleRelationAttribute | MultiRelationAttribute;
  * Universal relations have `targets: [{ object: "*" }]`
  */
 declare function isUniversalRelation(attr: RelationAttribute): boolean;
+/**
+ * Check if a relation attribute has bilateral synchronization enabled
+ */
+declare function isBilateralRelation(attr: RelationAttribute): attr is RelationAttribute & {
+    bilateral: BilateralConfig;
+};
+/**
+ * Infer the cardinality of the inverse relation
+ * - one → many (contact.company ↔ company.contacts)
+ * - many → many (contact.tags ↔ tag.contacts)
+ */
+declare function inferInverseCardinality(cardinality: "one" | "many"): "one" | "many";
 interface TextAreaAttribute extends BaseAttribute<string> {
     type: "textarea";
 }
@@ -1628,4 +1553,4 @@ declare function isRecordComplete(objectDef: ObjectDefinition, data: Record<stri
  */
 declare function computeRecordStatus(objectDef: ObjectDefinition, data: Record<string, unknown>): CompletionStatus;
 
-export { type DateFormat as $, type Attribute as A, type FormulaReturnType as B, type CheckboxPropertyDefinition as C, type DateAttribute as D, type RollupAttribute as E, type FeatureGate as F, type RollupFunction as G, type AttributeType as H, type ObjectDefinition as I, type FlagValueType as J, type FeatureFlagDefinition as K, type LocationPropertyDefinition as L, type MultiselectPropertyDefinition as M, type NumberPropertyDefinition as N, type Option as O, type PropertyDefinition as P, type FlagLevel as Q, type RatingPropertyDefinition as R, type StatusPropertyDefinition as S, type TextPropertyDefinition as T, type UserAttribute as U, type FeatureFlagsRepository as V, type StaticFlagDefault as W, type ResolvedFlag as X, type AttributeGroup as Y, type BaseAttribute as Z, type NumberUnit as _, type DocumentAttribute as a, createRelationValidator as a$, type DateValue as a0, type Phone as a1, type Currency as a2, type Location as a3, type LocationGranularity as a4, RELATION_TARGET_ANY as a5, type RelationAttribute as a6, isUniversalRelation as a7, type FlagOverride as a8, type FeatureFlagsConfig as a9, multiselectConfigSchema as aA, fileConfigSchema as aB, userConfigSchema as aC, relationConfigSchema as aD, ratingConfigSchema as aE, formulaConfigSchema as aF, rollupConfigSchema as aG, documentConfigSchema as aH, attributeConfigSchemas as aI, getAttributeConfigSchema as aJ, validateAttributeConfig as aK, parseAttributeConfig as aL, safeParseAttributeConfig as aM, createTextValidator as aN, createNumberValidator as aO, createCheckboxValidator as aP, createDateValidator as aQ, createPhoneValidator as aR, createCurrencyValidator as aS, createStatusValidator as aT, createSelectValidator as aU, createMultiselectValidator as aV, createLocationValidator as aW, createFileValidator as aX, createUserValidator as aY, createSingleRelationValidator as aZ, createMultiRelationValidator as a_, RESERVED_ATTRIBUTE_NAMES as aa, SYSTEM_FIELD_NAMES as ab, type ReservedAttributeName as ac, type SystemFieldName as ad, type Timestamps as ae, type SharingMode as af, type ObjectAttribute as ag, type CompletionStatus as ah, type ObjectRecord as ai, type PropertyType as aj, FORBIDDEN_PROPERTY_TYPES as ak, type ForbiddenPropertyType as al, formatZodErrors as am, type ValidationMessages as an, DEFAULT_VALIDATION_MESSAGES as ao, textConfigSchema as ap, textareaConfigSchema as aq, richtextConfigSchema as ar, numberConfigSchema as as, checkboxConfigSchema as at, dateConfigSchema as au, phoneConfigSchema as av, currencyConfigSchema as aw, statusConfigSchema as ax, locationConfigSchema as ay, selectConfigSchema as az, type TextareaPropertyDefinition as b, createRatingValidator as b0, createFormulaValidator as b1, createRollupValidator as b2, createTextAreaValidator as b3, createRichtextValidator as b4, createAttributeValidator as b5, createFormAttributeValidator as b6, createObjectValidator as b7, type ValidationResult as b8, validateAttribute as b9, validateObject as ba, validateObjectOrThrow as bb, createDraftValidator as bc, validateDraft as bd, validateDraftOrThrow as be, getMissingRequiredAttributes as bf, isRecordComplete as bg, computeRecordStatus as bh, type DatePropertyDefinition as c, type PhonePropertyDefinition as d, type CurrencyPropertyDefinition as e, type StatusGroup as f, type SelectPropertyDefinition as g, type PropertySchema as h, type TextAttribute as i, type TextAreaAttribute as j, type RichtextAttribute as k, type RichtextFeature as l, type NumberAttribute as m, type CheckboxAttribute as n, type PhoneAttribute as o, type CurrencyAttribute as p, type StatusAttribute as q, type SelectAttribute as r, type MultiselectAttribute as s, type LocationAttribute as t, type FileAttribute as u, type SingleRelationAttribute as v, type MultiRelationAttribute as w, type RelationTarget as x, type RatingAttribute as y, type FormulaAttribute as z };
+export { RESERVED_ATTRIBUTE_NAMES as $, type Attribute as A, type BilateralConfig as B, type CheckboxAttribute as C, type DateAttribute as D, type NumberUnit as E, type FeatureGate as F, type DateFormat as G, type DateValue as H, type Phone as I, type Currency as J, type Location as K, type LocationAttribute as L, type MultiselectAttribute as M, type NumberAttribute as N, type Option as O, type PhoneAttribute as P, type LocationGranularity as Q, type RichtextAttribute as R, type StatusAttribute as S, type TextAttribute as T, type UserAttribute as U, RELATION_TARGET_ANY as V, isUniversalRelation as W, isBilateralRelation as X, inferInverseCardinality as Y, type FlagOverride as Z, type FeatureFlagsConfig as _, type DocumentAttribute as a, type ValidationResult as a$, SYSTEM_FIELD_NAMES as a0, type ReservedAttributeName as a1, type SystemFieldName as a2, type Timestamps as a3, type SharingMode as a4, type ObjectAttribute as a5, type CompletionStatus as a6, type ObjectRecord as a7, type PropertyType as a8, FORBIDDEN_PROPERTY_TYPES as a9, getAttributeConfigSchema as aA, validateAttributeConfig as aB, parseAttributeConfig as aC, safeParseAttributeConfig as aD, createTextValidator as aE, createNumberValidator as aF, createCheckboxValidator as aG, createDateValidator as aH, createPhoneValidator as aI, createCurrencyValidator as aJ, createStatusValidator as aK, createSelectValidator as aL, createMultiselectValidator as aM, createLocationValidator as aN, createFileValidator as aO, createUserValidator as aP, createSingleRelationValidator as aQ, createMultiRelationValidator as aR, createRelationValidator as aS, createRatingValidator as aT, createFormulaValidator as aU, createRollupValidator as aV, createTextAreaValidator as aW, createRichtextValidator as aX, createAttributeValidator as aY, createFormAttributeValidator as aZ, createObjectValidator as a_, type ForbiddenPropertyType as aa, type PropertyAttribute as ab, type PropertySchema as ac, formatZodErrors as ad, type ValidationMessages as ae, DEFAULT_VALIDATION_MESSAGES as af, textConfigSchema as ag, textareaConfigSchema as ah, richtextConfigSchema as ai, numberConfigSchema as aj, checkboxConfigSchema as ak, dateConfigSchema as al, phoneConfigSchema as am, currencyConfigSchema as an, statusConfigSchema as ao, locationConfigSchema as ap, selectConfigSchema as aq, multiselectConfigSchema as ar, fileConfigSchema as as, userConfigSchema as at, relationConfigSchema as au, ratingConfigSchema as av, formulaConfigSchema as aw, rollupConfigSchema as ax, documentConfigSchema as ay, attributeConfigSchemas as az, type TextAreaAttribute as b, validateAttribute as b0, validateObject as b1, validateObjectOrThrow as b2, createDraftValidator as b3, validateDraft as b4, validateDraftOrThrow as b5, getMissingRequiredAttributes as b6, isRecordComplete as b7, computeRecordStatus as b8, type RichtextFeature as c, type CurrencyAttribute as d, type SelectAttribute as e, type FileAttribute as f, type RatingAttribute as g, type RelationAttribute as h, type SingleRelationAttribute as i, type MultiRelationAttribute as j, type RelationTarget as k, type FormulaAttribute as l, type FormulaReturnType as m, type RollupAttribute as n, type RollupFunction as o, type AttributeType as p, type ObjectDefinition as q, type FlagValueType as r, type FeatureFlagDefinition as s, type FlagLevel as t, type FeatureFlagsRepository as u, type StaticFlagDefault as v, type ResolvedFlag as w, type StatusGroup as x, type AttributeGroup as y, type BaseAttribute as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/schema",
-  "version": "0.1.0-alpha.63",
+  "version": "0.1.0-alpha.64",
   "description": "Standard schema definitions and utilities",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -35,7 +35,7 @@
     "jose": "^6.1.3",
     "pdf-lib": "^1.17.1",
     "zod": "^4.2.1",
-    "@stndrds/constants": "0.1.0-alpha.63"
+    "@stndrds/constants": "0.1.0-alpha.64"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",