@proveanything/smartlinks 1.5.6 → 1.6.1

package/dist/api/contact.d.ts

@@ -1,4 +1,4 @@
-import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse, ContactSchema } from "../types";
+import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse, ContactSchemaResponse } from "../types";
 export declare namespace contact {
     function create(collectionId: string, data: ContactCreateRequest): Promise<ContactResponse>;
     function list(collectionId: string, params?: {
@@ -20,18 +20,34 @@ export declare namespace contact {
     function publicGetMine(collectionId: string): Promise<PublicGetMyContactResponse>;
     function publicUpdateMine(collectionId: string, data: ContactPatch): Promise<PublicUpdateMyContactResponse>;
     /**
-     * Public: Get contact update schema for a collection
+     * Public: Get the contact schema for a collection.
+     * GET /public/collection/:collectionId/contact/schema
      *
-     * Fetches the public contact schema including core fields, custom fields with
-     * conditional visibility rules, and visibility/editability settings.
+     * Returns a ContactSchemaResponse describing all publicly visible contact fields.
+     * Core fields and collection-defined custom fields are merged into a single flat schema.
      *
-     * Custom fields may include a `condition` property that specifies when the field
-     * should be displayed. Apps rendering these forms should:
-     * 1. Evaluate each field's `condition` against current form values
-     * 2. Hide fields whose conditions are not met
-     * 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+     * Fields not in `publicVisibleFields` are stripped entirely from the response.
+     * Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`.
+     *
+     * Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions`
+     * from the types package to handle conditional field visibility.
+     *
+     * @example
+     * ```typescript
+     * import { contact, evaluateConditions } from '@proveanything/smartlinks'
+     *
+     * const schema = await contact.publicGetSchema(collectionId)
+     *
+     * for (const fieldId of schema.fieldOrder) {
+     *   const property = schema.schema.properties[fieldId]
+     *   const ui       = schema.uiSchema[fieldId] || {}
+     *   const visible  = evaluateConditions(property.conditions, property.showWhen, formValues)
+     *   const disabled = ui['ui:disabled'] === true
+     *   if (visible) renderField({ fieldId, property, ui, disabled })
+     * }
+     * ```
      */
-    function publicGetSchema(collectionId: string): Promise<ContactSchema>;
+    function publicGetSchema(collectionId: string): Promise<ContactSchemaResponse>;
     function erase(collectionId: string, contactId: string, body?: any): Promise<ContactResponse>;
     function getUser(collectionId: string, userId: string): Promise<UserSearchResponse>;
 }

package/dist/api/contact.js

@@ -72,16 +72,32 @@ export var contact;
     }
     contact.publicUpdateMine = publicUpdateMine;
     /**
-     * Public: Get contact update schema for a collection
+     * Public: Get the contact schema for a collection.
+     * GET /public/collection/:collectionId/contact/schema
      *
-     * Fetches the public contact schema including core fields, custom fields with
-     * conditional visibility rules, and visibility/editability settings.
+     * Returns a ContactSchemaResponse describing all publicly visible contact fields.
+     * Core fields and collection-defined custom fields are merged into a single flat schema.
      *
-     * Custom fields may include a `condition` property that specifies when the field
-     * should be displayed. Apps rendering these forms should:
-     * 1. Evaluate each field's `condition` against current form values
-     * 2. Hide fields whose conditions are not met
-     * 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+     * Fields not in `publicVisibleFields` are stripped entirely from the response.
+     * Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`.
+     *
+     * Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions`
+     * from the types package to handle conditional field visibility.
+     *
+     * @example
+     * ```typescript
+     * import { contact, evaluateConditions } from '@proveanything/smartlinks'
+     *
+     * const schema = await contact.publicGetSchema(collectionId)
+     *
+     * for (const fieldId of schema.fieldOrder) {
+     *   const property = schema.schema.properties[fieldId]
+     *   const ui       = schema.uiSchema[fieldId] || {}
+     *   const visible  = evaluateConditions(property.conditions, property.showWhen, formValues)
+     *   const disabled = ui['ui:disabled'] === true
+     *   if (visible) renderField({ fieldId, property, ui, disabled })
+     * }
+     * ```
      */
     async function publicGetSchema(collectionId) {
         const path = `/public/collection/${encodeURIComponent(collectionId)}/contact/schema`;

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.5.6  |  Generated: 2026-02-26T08:32:23.437Z
+Version: 1.6.1  |  Generated: 2026-02-26T11:23:15.062Z
 
 This is a concise summary of all available API functions and types.
 
@@ -2502,36 +2502,64 @@ interface CommsState {
 **FieldCondition** (interface)
 ```typescript
 interface FieldCondition {
-  dependsOn: string          // key of the field to check (not path)
+  targetFieldId: string   // The field whose value is tested
   operator: ConditionOperator
-  value?: string | string[]  // required for equals/notEquals/contains/notContains
+  value?: unknown         // Required for equals / not_equals / contains / not_contains / greater_than / less_than
 }
 ```
 
-**BaseField** (interface)
+**ContactSchemaProperty** (interface)
 ```typescript
-interface BaseField {
-  key: string
-  label: string
-  type: FieldType
-  widget: FieldWidget
-  visible: boolean
-  editable: boolean
-  readOnly: boolean
+interface ContactSchemaProperty {
+  type: 'string' | 'number' | 'boolean' | 'array'
+  title?: string
+  description?: string
+  format?: string
+  enum?: string[]
+  * Display labels for `enum` values — parallel array.
+  * `enum[i]` is the stored value; `enumNames[i]` is the display label.
+  * When absent, `enum` values are used as labels.
+  enumNames?: string[]
+  default?: unknown
+  minLength?: number
+  maxLength?: number
+  pattern?: string
+  minimum?: number
+  maximum?: number
+  conditions?: FieldCondition[]
+  showWhen?: 'all' | 'any'
+}
+```
+
+**ContactUiSchemaEntry** (interface)
+```typescript
+interface ContactUiSchemaEntry {
+  'ui:disabled'?: true
+  'ui:placeholder'?: string
+  'ui:help'?: string
+  'ui:widget'?: string
+  'ui:options'?: {
+  rows?: number        // textarea: number of visible rows
+  accept?: string      // file: accepted MIME types
+  label?: boolean      // checkbox: show inline label
+  [key: string]: unknown
+  }
+  [key: string]: unknown
 }
 ```
 
-**ContactSchema** (interface)
+**ContactSchemaResponse** (interface)
 ```typescript
-interface ContactSchema {
-  version: number          // 1
-  fields: CoreField[]      // core fields
-  customFields: CustomField[]
-  settings: {
-  publicVisibleFields: string[]
-  publicEditableFields: string[]
-  customFieldsVersion: number
+interface ContactSchemaResponse {
+  schema: {
+  type: 'object'
+  required?: string[]
+  properties: Record<string, ContactSchemaProperty>
   }
+  uiSchema: Record<string, ContactUiSchemaEntry>
+  fieldOrder: string[]
+  settings: Record<string, unknown>
+  styling: Record<string, unknown>
 }
 ```
 
@@ -2553,9 +2581,7 @@ interface ContactSchema {
 
 **ConditionOperator** = ``
 
-**FieldWidget** = `'text' | 'email' | 'tel' | 'select' | 'multiselect' | 'checkbox' | 'number' | 'date' | 'url'`
-
-**FieldType** = ``
+**ContactSchema** = `ContactSchemaResponse`
 
 ### crate
 
@@ -4965,15 +4991,15 @@ Logging: Append many communication events for a list of IDs. POST /admin/collect
 **publicUpdateMine**(collectionId: string,
     data: ContactPatch) → `Promise<PublicUpdateMyContactResponse>`
 
-**publicGetSchema**(collectionId: string) → `Promise<ContactSchema>`
-Public: Get contact update schema for a collection Fetches the public contact schema including core fields, custom fields with conditional visibility rules, and visibility/editability settings. Custom fields may include a `condition` property that specifies when the field should be displayed. Apps rendering these forms should: 1. Evaluate each field's `condition` against current form values 2. Hide fields whose conditions are not met 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+**publicGetSchema**(collectionId: string) → `Promise<ContactSchemaResponse>`
+Public: Get the contact schema for a collection. GET /public/collection/:collectionId/contact/schema Returns a ContactSchemaResponse describing all publicly visible contact fields. Core fields and collection-defined custom fields are merged into a single flat schema. Fields not in `publicVisibleFields` are stripped entirely from the response. Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`. Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions` from the types package to handle conditional field visibility. ```typescript import { contact, evaluateConditions } from '@proveanything/smartlinks' const schema = await contact.publicGetSchema(collectionId) for (const fieldId of schema.fieldOrder) { const property = schema.schema.properties[fieldId] const ui       = schema.uiSchema[fieldId] || {} const visible  = evaluateConditions(property.conditions, property.showWhen, formValues) const disabled = ui['ui:disabled'] === true if (visible) renderField({ fieldId, property, ui, disabled }) } ```
 
 **erase**(collectionId: string, contactId: string, body?: any) → `Promise<ContactResponse>`
-Public: Get contact update schema for a collection Fetches the public contact schema including core fields, custom fields with conditional visibility rules, and visibility/editability settings. Custom fields may include a `condition` property that specifies when the field should be displayed. Apps rendering these forms should: 1. Evaluate each field's `condition` against current form values 2. Hide fields whose conditions are not met 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+Public: Get the contact schema for a collection. GET /public/collection/:collectionId/contact/schema Returns a ContactSchemaResponse describing all publicly visible contact fields. Core fields and collection-defined custom fields are merged into a single flat schema. Fields not in `publicVisibleFields` are stripped entirely from the response. Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`. Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions` from the types package to handle conditional field visibility. ```typescript import { contact, evaluateConditions } from '@proveanything/smartlinks' const schema = await contact.publicGetSchema(collectionId) for (const fieldId of schema.fieldOrder) { const property = schema.schema.properties[fieldId] const ui       = schema.uiSchema[fieldId] || {} const visible  = evaluateConditions(property.conditions, property.showWhen, formValues) const disabled = ui['ui:disabled'] === true if (visible) renderField({ fieldId, property, ui, disabled }) } ```
 
 **getUser**(collectionId: string,
     userId: string,) → `Promise<UserSearchResponse>`
-Public: Get contact update schema for a collection Fetches the public contact schema including core fields, custom fields with conditional visibility rules, and visibility/editability settings. Custom fields may include a `condition` property that specifies when the field should be displayed. Apps rendering these forms should: 1. Evaluate each field's `condition` against current form values 2. Hide fields whose conditions are not met 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+Public: Get the contact schema for a collection. GET /public/collection/:collectionId/contact/schema Returns a ContactSchemaResponse describing all publicly visible contact fields. Core fields and collection-defined custom fields are merged into a single flat schema. Fields not in `publicVisibleFields` are stripped entirely from the response. Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`. Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions` from the types package to handle conditional field visibility. ```typescript import { contact, evaluateConditions } from '@proveanything/smartlinks' const schema = await contact.publicGetSchema(collectionId) for (const fieldId of schema.fieldOrder) { const property = schema.schema.properties[fieldId] const ui       = schema.uiSchema[fieldId] || {} const visible  = evaluateConditions(property.conditions, property.showWhen, formValues) const disabled = ui['ui:disabled'] === true if (visible) renderField({ fieldId, property, ui, disabled }) } ```
 
 ### crate
 

package/dist/types/contact.d.ts

@@ -131,61 +131,128 @@ export interface CommsState {
 }
 /**
  * Operators for conditional field visibility.
- * Use these to control when a custom field is shown based on another field's value.
+ * Used in ContactSchemaProperty.conditions[].operator.
  */
-export type ConditionOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'isEmpty' | 'isNotEmpty' | 'isTrue' | 'isFalse';
+export type ConditionOperator = 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'is_empty' | 'is_not_empty' | 'is_true' | 'is_false' | 'greater_than' | 'less_than';
 /**
- * Condition that determines when a field should be visible.
- * When present, the field only renders if the condition evaluates to true.
+ * A single visibility condition on a field.
+ * The field renders only when its conditions are satisfied (see `showWhen`).
  */
 export interface FieldCondition {
-    dependsOn: string;
+    targetFieldId: string;
     operator: ConditionOperator;
-    value?: string | string[];
+    value?: unknown;
 }
-export type FieldWidget = 'text' | 'email' | 'tel' | 'select' | 'multiselect' | 'checkbox' | 'number' | 'date' | 'url';
-export type FieldType = 'string' | 'url' | 'email' | 'tel' | 'text' | 'select' | 'checkbox' | 'boolean';
-export interface BaseField {
-    key: string;
-    label: string;
-    type: FieldType;
-    widget: FieldWidget;
-    visible: boolean;
-    editable: boolean;
-    readOnly: boolean;
+/**
+ * A single field property as returned by the contact schema endpoint.
+ * Follows JSON Schema conventions with rendering hints via `format`.
+ *
+ * Format values:
+ *   (none)        → plain text input
+ *   email         → email input
+ *   uri           → URL input
+ *   tel           → phone input
+ *   date          → date picker
+ *   textarea      → multi-line text
+ *   select        → single-select dropdown (requires `enum`)
+ *   multiselect   → multi-select (type will be 'array', requires `enum`)
+ *   radio         → radio button group (requires `enum`)
+ */
+export interface ContactSchemaProperty {
+    type: 'string' | 'number' | 'boolean' | 'array';
+    title?: string;
+    description?: string;
+    format?: string;
+    /** Stored values for select / radio / multiselect fields */
+    enum?: string[];
+    /**
+     * Display labels for `enum` values — parallel array.
+     * `enum[i]` is the stored value; `enumNames[i]` is the display label.
+     * When absent, `enum` values are used as labels.
+     */
+    enumNames?: string[];
+    /** Default value pre-populated into the field */
+    default?: unknown;
+    /** Minimum string length (type: 'string') */
+    minLength?: number;
+    /** Maximum string length (type: 'string') */
+    maxLength?: number;
+    /** Regex pattern the value must match (type: 'string') */
+    pattern?: string;
+    /** Minimum value (type: 'number') */
+    minimum?: number;
+    /** Maximum value (type: 'number') */
+    maximum?: number;
+    conditions?: FieldCondition[];
+    showWhen?: 'all' | 'any';
 }
-export interface CoreField extends BaseField {
+/**
+ * UI rendering hints for a single field, keyed by field ID in `uiSchema`.
+ */
+export interface ContactUiSchemaEntry {
+    /** Field is visible but not editable */
+    'ui:disabled'?: true;
+    /** Placeholder text shown inside the input */
+    'ui:placeholder'?: string;
+    /** Help text shown below the field (longer than description) */
+    'ui:help'?: string;
+    /** Override the auto-detected widget (e.g. 'textarea', 'radio', 'checkboxes') */
+    'ui:widget'?: string;
+    /** Widget-specific options */
+    'ui:options'?: {
+        rows?: number;
+        accept?: string;
+        label?: boolean;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
 }
 /**
- * Custom field definition returned by the schema endpoint.
+ * Response from GET /public/collection/:collectionId/contact/schema
+ *
+ * Core fields and collection-defined custom fields are merged into a single
+ * flat schema. Fields not in `publicVisibleFields` are stripped entirely.
+ * Fields visible but not in `publicEditableFields` have `ui:disabled: true`
+ * in `uiSchema`.
  */
-export interface CustomField extends BaseField {
-    path: string;
-    required: boolean;
-    order?: number;
-    options?: string[];
-    placeholder?: string;
-    description?: string;
-    condition?: FieldCondition;
-}
-export interface ContactSchema {
-    version: number;
-    fields: CoreField[];
-    customFields: CustomField[];
-    settings: {
-        publicVisibleFields: string[];
-        publicEditableFields: string[];
-        customFieldsVersion: number;
+export interface ContactSchemaResponse {
+    schema: {
+        type: 'object';
+        required?: string[];
+        properties: Record<string, ContactSchemaProperty>;
     };
+    uiSchema: Record<string, ContactUiSchemaEntry>;
+    /** Ordered list of field IDs — core fields first, then custom fields */
+    fieldOrder: string[];
+    /** Pass-through of the collection's SchemaFormConfig settings block */
+    settings: Record<string, unknown>;
+    /** Pass-through of the collection's SchemaFormConfig styling block */
+    styling: Record<string, unknown>;
 }
+/** @deprecated Use ContactSchemaResponse instead */
+export type ContactSchema = ContactSchemaResponse;
 /**
- * Evaluate whether a field's condition is satisfied.
- * Returns true if the field should be visible.
+ * Evaluate whether a field's conditions are satisfied given the current form values.
+ * Returns `true` if the field should be visible.
+ *
+ * @param conditions  The `conditions` array from a ContactSchemaProperty (may be undefined)
+ * @param showWhen    'all' requires every condition to pass; 'any' requires at least one
+ * @param fieldValues Current form values keyed by field ID
  *
  * @example
  * ```typescript
- * const field = schema.customFields.find(f => f.key === 'city')
- * const isVisible = evaluateCondition(field.condition, formValues)
+ * const property = schema.schema.properties[fieldId]
+ * const visible = evaluateConditions(property.conditions, property.showWhen, formValues)
  * ```
  */
-export declare function evaluateCondition(condition: FieldCondition | undefined, fieldValues: Record<string, any>): boolean;
+export declare function evaluateConditions(conditions: FieldCondition[] | undefined, showWhen: 'all' | 'any' | undefined, fieldValues: Record<string, unknown>): boolean;
+/**
+ * @deprecated Use evaluateConditions (plural) instead.
+ * Shim for code using the old single-condition API.
+ */
+export declare function evaluateCondition(condition: {
+    dependsOn?: string;
+    targetFieldId?: string;
+    operator: string;
+    value?: unknown;
+} | undefined, fieldValues: Record<string, unknown>): boolean;

package/dist/types/contact.js

@@ -1,35 +1,69 @@
 /**
- * Evaluate whether a field's condition is satisfied.
- * Returns true if the field should be visible.
+ * Evaluate whether a field's conditions are satisfied given the current form values.
+ * Returns `true` if the field should be visible.
+ *
+ * @param conditions  The `conditions` array from a ContactSchemaProperty (may be undefined)
+ * @param showWhen    'all' requires every condition to pass; 'any' requires at least one
+ * @param fieldValues Current form values keyed by field ID
  *
  * @example
  * ```typescript
- * const field = schema.customFields.find(f => f.key === 'city')
- * const isVisible = evaluateCondition(field.condition, formValues)
+ * const property = schema.schema.properties[fieldId]
+ * const visible = evaluateConditions(property.conditions, property.showWhen, formValues)
  * ```
  */
+export function evaluateConditions(conditions, showWhen, fieldValues) {
+    if (!conditions || conditions.length === 0)
+        return true;
+    const results = conditions.map(condition => {
+        const value = fieldValues[condition.targetFieldId];
+        switch (condition.operator) {
+            case 'is_empty':
+                return value == null || value === '' || (Array.isArray(value) && value.length === 0);
+            case 'is_not_empty':
+                return value != null && value !== '' && !(Array.isArray(value) && value.length === 0);
+            case 'is_true':
+                return value === true;
+            case 'is_false':
+                return value === false;
+            case 'equals':
+                return value === condition.value;
+            case 'not_equals':
+                return value !== condition.value;
+            case 'contains':
+                return Array.isArray(value)
+                    ? value.includes(condition.value)
+                    : typeof value === 'string' && value.includes(String(condition.value));
+            case 'not_contains':
+                return Array.isArray(value)
+                    ? !value.includes(condition.value)
+                    : typeof value === 'string' && !value.includes(String(condition.value));
+            case 'greater_than':
+                return typeof value === 'number' && typeof condition.value === 'number'
+                    ? value > condition.value
+                    : String(value) > String(condition.value);
+            case 'less_than':
+                return typeof value === 'number' && typeof condition.value === 'number'
+                    ? value < condition.value
+                    : String(value) < String(condition.value);
+            default:
+                return true;
+        }
+    });
+    return (showWhen !== null && showWhen !== void 0 ? showWhen : 'all') === 'any'
+        ? results.some(Boolean)
+        : results.every(Boolean);
+}
+/**
+ * @deprecated Use evaluateConditions (plural) instead.
+ * Shim for code using the old single-condition API.
+ */
 export function evaluateCondition(condition, fieldValues) {
+    var _a;
     if (!condition)
-        return true; // No condition = always visible
-    const value = fieldValues[condition.dependsOn];
-    switch (condition.operator) {
-        case 'isEmpty':
-            return value == null || value === '' || (Array.isArray(value) && !value.length);
-        case 'isNotEmpty':
-            return value != null && value !== '' && !(Array.isArray(value) && !value.length);
-        case 'isTrue':
-            return value === true;
-        case 'isFalse':
-            return value === false;
-        case 'equals':
-            return value === condition.value;
-        case 'notEquals':
-            return value !== condition.value;
-        case 'contains':
-            return Array.isArray(value) && value.includes(condition.value);
-        case 'notContains':
-            return !Array.isArray(value) || !value.includes(condition.value);
-        default:
-            return true;
-    }
+        return true;
+    const targetFieldId = (_a = condition.dependsOn) !== null && _a !== void 0 ? _a : condition.targetFieldId;
+    if (!targetFieldId)
+        return true;
+    return evaluateConditions([{ targetFieldId, operator: condition.operator, value: condition.value }], 'all', fieldValues);
 }

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.5.6  |  Generated: 2026-02-26T08:32:23.437Z
+Version: 1.6.1  |  Generated: 2026-02-26T11:23:15.062Z
 
 This is a concise summary of all available API functions and types.
 
@@ -2502,36 +2502,64 @@ interface CommsState {
 **FieldCondition** (interface)
 ```typescript
 interface FieldCondition {
-  dependsOn: string          // key of the field to check (not path)
+  targetFieldId: string   // The field whose value is tested
   operator: ConditionOperator
-  value?: string | string[]  // required for equals/notEquals/contains/notContains
+  value?: unknown         // Required for equals / not_equals / contains / not_contains / greater_than / less_than
 }
 ```
 
-**BaseField** (interface)
+**ContactSchemaProperty** (interface)
 ```typescript
-interface BaseField {
-  key: string
-  label: string
-  type: FieldType
-  widget: FieldWidget
-  visible: boolean
-  editable: boolean
-  readOnly: boolean
+interface ContactSchemaProperty {
+  type: 'string' | 'number' | 'boolean' | 'array'
+  title?: string
+  description?: string
+  format?: string
+  enum?: string[]
+  * Display labels for `enum` values — parallel array.
+  * `enum[i]` is the stored value; `enumNames[i]` is the display label.
+  * When absent, `enum` values are used as labels.
+  enumNames?: string[]
+  default?: unknown
+  minLength?: number
+  maxLength?: number
+  pattern?: string
+  minimum?: number
+  maximum?: number
+  conditions?: FieldCondition[]
+  showWhen?: 'all' | 'any'
+}
+```
+
+**ContactUiSchemaEntry** (interface)
+```typescript
+interface ContactUiSchemaEntry {
+  'ui:disabled'?: true
+  'ui:placeholder'?: string
+  'ui:help'?: string
+  'ui:widget'?: string
+  'ui:options'?: {
+  rows?: number        // textarea: number of visible rows
+  accept?: string      // file: accepted MIME types
+  label?: boolean      // checkbox: show inline label
+  [key: string]: unknown
+  }
+  [key: string]: unknown
 }
 ```
 
-**ContactSchema** (interface)
+**ContactSchemaResponse** (interface)
 ```typescript
-interface ContactSchema {
-  version: number          // 1
-  fields: CoreField[]      // core fields
-  customFields: CustomField[]
-  settings: {
-  publicVisibleFields: string[]
-  publicEditableFields: string[]
-  customFieldsVersion: number
+interface ContactSchemaResponse {
+  schema: {
+  type: 'object'
+  required?: string[]
+  properties: Record<string, ContactSchemaProperty>
   }
+  uiSchema: Record<string, ContactUiSchemaEntry>
+  fieldOrder: string[]
+  settings: Record<string, unknown>
+  styling: Record<string, unknown>
 }
 ```
 
@@ -2553,9 +2581,7 @@ interface ContactSchema {
 
 **ConditionOperator** = ``
 
-**FieldWidget** = `'text' | 'email' | 'tel' | 'select' | 'multiselect' | 'checkbox' | 'number' | 'date' | 'url'`
-
-**FieldType** = ``
+**ContactSchema** = `ContactSchemaResponse`
 
 ### crate
 
@@ -4965,15 +4991,15 @@ Logging: Append many communication events for a list of IDs. POST /admin/collect
 **publicUpdateMine**(collectionId: string,
     data: ContactPatch) → `Promise<PublicUpdateMyContactResponse>`
 
-**publicGetSchema**(collectionId: string) → `Promise<ContactSchema>`
-Public: Get contact update schema for a collection Fetches the public contact schema including core fields, custom fields with conditional visibility rules, and visibility/editability settings. Custom fields may include a `condition` property that specifies when the field should be displayed. Apps rendering these forms should: 1. Evaluate each field's `condition` against current form values 2. Hide fields whose conditions are not met 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+**publicGetSchema**(collectionId: string) → `Promise<ContactSchemaResponse>`
+Public: Get the contact schema for a collection. GET /public/collection/:collectionId/contact/schema Returns a ContactSchemaResponse describing all publicly visible contact fields. Core fields and collection-defined custom fields are merged into a single flat schema. Fields not in `publicVisibleFields` are stripped entirely from the response. Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`. Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions` from the types package to handle conditional field visibility. ```typescript import { contact, evaluateConditions } from '@proveanything/smartlinks' const schema = await contact.publicGetSchema(collectionId) for (const fieldId of schema.fieldOrder) { const property = schema.schema.properties[fieldId] const ui       = schema.uiSchema[fieldId] || {} const visible  = evaluateConditions(property.conditions, property.showWhen, formValues) const disabled = ui['ui:disabled'] === true if (visible) renderField({ fieldId, property, ui, disabled }) } ```
 
 **erase**(collectionId: string, contactId: string, body?: any) → `Promise<ContactResponse>`
-Public: Get contact update schema for a collection Fetches the public contact schema including core fields, custom fields with conditional visibility rules, and visibility/editability settings. Custom fields may include a `condition` property that specifies when the field should be displayed. Apps rendering these forms should: 1. Evaluate each field's `condition` against current form values 2. Hide fields whose conditions are not met 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+Public: Get the contact schema for a collection. GET /public/collection/:collectionId/contact/schema Returns a ContactSchemaResponse describing all publicly visible contact fields. Core fields and collection-defined custom fields are merged into a single flat schema. Fields not in `publicVisibleFields` are stripped entirely from the response. Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`. Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions` from the types package to handle conditional field visibility. ```typescript import { contact, evaluateConditions } from '@proveanything/smartlinks' const schema = await contact.publicGetSchema(collectionId) for (const fieldId of schema.fieldOrder) { const property = schema.schema.properties[fieldId] const ui       = schema.uiSchema[fieldId] || {} const visible  = evaluateConditions(property.conditions, property.showWhen, formValues) const disabled = ui['ui:disabled'] === true if (visible) renderField({ fieldId, property, ui, disabled }) } ```
 
 **getUser**(collectionId: string,
     userId: string,) → `Promise<UserSearchResponse>`
-Public: Get contact update schema for a collection Fetches the public contact schema including core fields, custom fields with conditional visibility rules, and visibility/editability settings. Custom fields may include a `condition` property that specifies when the field should be displayed. Apps rendering these forms should: 1. Evaluate each field's `condition` against current form values 2. Hide fields whose conditions are not met 3. Skip validation for hidden fields (they shouldn't be required when not visible)
+Public: Get the contact schema for a collection. GET /public/collection/:collectionId/contact/schema Returns a ContactSchemaResponse describing all publicly visible contact fields. Core fields and collection-defined custom fields are merged into a single flat schema. Fields not in `publicVisibleFields` are stripped entirely from the response. Fields visible but not in `publicEditableFields` have `ui:disabled: true` in `uiSchema`. Use `fieldOrder` to render fields in the correct sequence, and `evaluateConditions` from the types package to handle conditional field visibility. ```typescript import { contact, evaluateConditions } from '@proveanything/smartlinks' const schema = await contact.publicGetSchema(collectionId) for (const fieldId of schema.fieldOrder) { const property = schema.schema.properties[fieldId] const ui       = schema.uiSchema[fieldId] || {} const visible  = evaluateConditions(property.conditions, property.showWhen, formValues) const disabled = ui['ui:disabled'] === true if (visible) renderField({ fieldId, property, ui, disabled }) } ```
 
 ### crate
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.5.6",
+  "version": "1.6.1",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",