@proveanything/smartlinks 1.2.1 → 1.2.3

package/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.2.1  |  Generated: 2026-01-21T17:11:59.946Z
+Version: 1.2.3  |  Generated: 2026-01-24T13:13:09.436Z
 
 This is a concise summary of all available API functions and types.
 
@@ -454,13 +454,13 @@ interface BroadcastRecord {
   }
   broadcastType?: string
   topic: string
+  templateParams?: Record<string, unknown>;
   channelSettings?: {
   mode?: 'preferred' | 'channels' | 'all'
   channels?: Array<{
-  channel: import('./broadcasts').BroadcastChannel
+  channel: BroadcastChannel
   enabled?: boolean
   priority?: number
-  templateId?: string
   }>
   }
   [key: string]: unknown
@@ -866,9 +866,12 @@ interface TopicConfig {
   label?: string
   description?: string
   labels?: string[]
+  classification?: 'transactional' | 'marketing'
   defaults?: {
   channels?: Partial<Record<BroadcastChannel, boolean>>
   topics?: Record<string, boolean | undefined>
+  policy?: 'opt-in' | 'opt-out'
+  byChannel?: Partial<Record<BroadcastChannel, 'opt-in' | 'opt-out'>>
   }
   rules?: {
   allowChannels?: BroadcastChannel[]
@@ -1193,6 +1196,33 @@ interface CommsState {
 }
 ```
 
+**BaseField** (interface)
+```typescript
+interface BaseField {
+  key: string
+  label: string
+  type: FieldType
+  widget: FieldWidget
+  visible: boolean
+  editable: boolean
+  readOnly: boolean
+}
+```
+
+**ContactSchema** (interface)
+```typescript
+interface ContactSchema {
+  version: number          // 1
+  fields: CoreField[]      // core fields
+  customFields: CustomField[]
+  settings: {
+  publicVisibleFields: string[]
+  publicEditableFields: string[]
+  customFieldsVersion: number
+  }
+}
+```
+
 **ContactCustomFields** = `Record<string, any>`
 
 **ContactResponse** = `Contact`
@@ -1209,6 +1239,10 @@ interface CommsState {
 
 **SubjectType** = `'product' | 'proof' | 'batch'`
 
+**FieldWidget** = `'text' | 'email' | 'tel' | 'select' | 'checkbox'`
+
+**FieldType** = ``
+
 ### error
 
 **ErrorResponse** (interface)
@@ -1878,6 +1912,7 @@ interface TemplateBase {
   push: { title: string; body: string, url?: string, iconUrl?: string },
   wallet?: { header: string; body: string; imageUri?: string }
   }
+  parameters: TemplateParameterSchema[]
   subject?: string
   body?: string
   css?: string
@@ -2594,6 +2629,8 @@ 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>`
+
 **erase**(collectionId: string, contactId: string, body?: any) → `Promise<ContactResponse>`
 
 **getUser**(collectionId: string,

package/dist/api/contact.d.ts

@@ -1,4 +1,4 @@
-import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse } from "../types";
+import { ContactResponse, ContactCreateRequest, ContactUpdateRequest, ContactListResponse, PublicContactUpsertRequest, PublicContactUpsertResponse, UserSearchResponse, ContactPatch, PublicGetMyContactResponse, PublicUpdateMyContactResponse, ContactSchema } from "../types";
 export declare namespace contact {
     function create(collectionId: string, data: ContactCreateRequest): Promise<ContactResponse>;
     function list(collectionId: string, params?: {
@@ -19,6 +19,7 @@ export declare namespace contact {
     function publicUpsert(collectionId: string, data: PublicContactUpsertRequest): Promise<PublicContactUpsertResponse>;
     function publicGetMine(collectionId: string): Promise<PublicGetMyContactResponse>;
     function publicUpdateMine(collectionId: string, data: ContactPatch): Promise<PublicUpdateMyContactResponse>;
+    function publicGetSchema(collectionId: string): Promise<ContactSchema>;
     function erase(collectionId: string, contactId: string, body?: any): Promise<ContactResponse>;
     function getUser(collectionId: string, userId: string): Promise<UserSearchResponse>;
 }

package/dist/api/contact.js

@@ -71,6 +71,12 @@ export var contact;
         return patch(path, data);
     }
     contact.publicUpdateMine = publicUpdateMine;
+    // Public: Get contact update schema for a collection
+    async function publicGetSchema(collectionId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/contact/schema`;
+        return request(path);
+    }
+    contact.publicGetSchema = publicGetSchema;
     async function erase(collectionId, contactId, body) {
         const path = `/admin/collection/${encodeURIComponent(collectionId)}/contacts/${encodeURIComponent(contactId)}/erase`;
         return post(path, body || {});

package/dist/types/broadcasts.d.ts

@@ -3,6 +3,7 @@ export interface ListBroadcastsQuery {
     offset?: number;
     appId?: string;
 }
+export type BroadcastChannel = 'email' | 'push' | 'sms' | 'wallet';
 export interface BroadcastRecord {
     id: string;
     collectionId: string;
@@ -22,14 +23,15 @@ export interface BroadcastRecord {
         broadcastType?: string;
         /** Required topic key for consent enforcement (e.g. newsletter, marketing, critical) */
         topic: string;
+        /** Required topic key for consent enforcement (e.g. newsletter, marketing, critical) */
+        templateParams?: Record<string, unknown>;
         /** Per-channel enablement/priority and optional template overrides */
         channelSettings?: {
             mode?: 'preferred' | 'channels' | 'all';
             channels?: Array<{
-                channel: import('./broadcasts').BroadcastChannel;
+                channel: BroadcastChannel;
                 enabled?: boolean;
                 priority?: number;
-                templateId?: string;
             }>;
         };
         [key: string]: unknown;
@@ -48,7 +50,6 @@ export interface BroadcastRecipientsResponse {
     offset: number;
     note?: string;
 }
-export type BroadcastChannel = 'email' | 'push' | 'sms' | 'wallet';
 export interface BroadcastPreviewRequest {
     contactId?: string;
     email?: string;

package/dist/types/comms.d.ts

@@ -141,9 +141,15 @@ export interface TopicConfig {
     description?: string;
     /** Optional UI-only grouping labels */
     labels?: string[];
+    /** Classification for UI and default policy guidance */
+    classification?: 'transactional' | 'marketing';
     defaults?: {
         channels?: Partial<Record<BroadcastChannel, boolean>>;
         topics?: Record<string, boolean | undefined>;
+        /** Default consent policy when explicit preferences are absent */
+        policy?: 'opt-in' | 'opt-out';
+        /** Per-channel default policy (overrides policy when present) */
+        byChannel?: Partial<Record<BroadcastChannel, 'opt-in' | 'opt-out'>>;
     };
     rules?: {
         allowChannels?: BroadcastChannel[];

package/dist/types/contact.d.ts

@@ -129,3 +129,32 @@ export interface CommsState {
     /** Keyed by `_default` or `${type}_${id}` */
     preferences?: Record<string, PreferenceEntry>;
 }
+export type FieldWidget = 'text' | 'email' | 'tel' | 'select' | 'checkbox';
+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;
+}
+export interface CoreField extends BaseField {
+}
+export interface CustomField extends BaseField {
+    path: string;
+    required: boolean;
+    order?: number;
+    options?: string[];
+}
+export interface ContactSchema {
+    version: number;
+    fields: CoreField[];
+    customFields: CustomField[];
+    settings: {
+        publicVisibleFields: string[];
+        publicEditableFields: string[];
+        customFieldsVersion: number;
+    };
+}

package/dist/types/template.d.ts

@@ -1,3 +1,10 @@
+interface TemplateParameterSchema {
+    key: string;
+    label?: string;
+    type?: string;
+    required?: boolean;
+    defaultValue?: string;
+}
 export interface TemplateBase {
     id: string;
     collectionId: string;
@@ -31,6 +38,7 @@ export interface TemplateBase {
             imageUri?: string;
         };
     };
+    parameters: TemplateParameterSchema[];
     subject?: string;
     body?: string;
     css?: string;
@@ -65,3 +73,4 @@ export interface TemplateRenderSourceResponse {
     ok: boolean;
     html: string;
 }
+export {};

package/package.json

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