@proveanything/smartlinks 1.9.14 → 1.9.15

package/dist/api/config.d.ts

@@ -0,0 +1,19 @@
+import type { FieldDefinition, ProofTypeDefinition } from "../types/config";
+export declare namespace config {
+    /**
+     * Returns the full platform field catalog.
+     * Fields are used as building blocks for proof type templates — they define
+     * the input widgets shown when creating or editing products and proof items.
+     *
+     * **Endpoint:** `GET /api/v1/public/config/fields`
+     */
+    function getFields(): Promise<FieldDefinition[]>;
+    /**
+     * Returns all proof type definitions.
+     * Proof types are templates that specify which fields to show, which apps are
+     * pre-installed, and how the portal behaves for a given product category.
+     *
+     * **Endpoint:** `GET /api/v1/public/config/proofTypes`
+     */
+    function getProofTypes(): Promise<ProofTypeDefinition[]>;
+}

package/dist/api/config.js

@@ -0,0 +1,27 @@
+// src/api/config.ts
+import { request } from "../http";
+export var config;
+(function (config) {
+    /**
+     * Returns the full platform field catalog.
+     * Fields are used as building blocks for proof type templates — they define
+     * the input widgets shown when creating or editing products and proof items.
+     *
+     * **Endpoint:** `GET /api/v1/public/config/fields`
+     */
+    async function getFields() {
+        return request("/public/config/fields");
+    }
+    config.getFields = getFields;
+    /**
+     * Returns all proof type definitions.
+     * Proof types are templates that specify which fields to show, which apps are
+     * pre-installed, and how the portal behaves for a given product category.
+     *
+     * **Endpoint:** `GET /api/v1/public/config/proofTypes`
+     */
+    async function getProofTypes() {
+        return request("/public/config/proofTypes");
+    }
+    config.getProofTypes = getProofTypes;
+})(config || (config = {}));

package/dist/api/index.d.ts

@@ -36,3 +36,4 @@ export { attestations } from "./attestations";
 export { containers } from "./containers";
 export { loyalty } from "./loyalty";
 export { translations } from "./translations";
+export { config } from "./config";

package/dist/api/index.js

@@ -39,3 +39,4 @@ export { attestations } from "./attestations";
 export { containers } from "./containers";
 export { loyalty } from "./loyalty";
 export { translations } from "./translations";
+export { config } from "./config";

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.9.14  |  Generated: 2026-03-31T19:46:30.667Z
+Version: 1.9.15  |  Generated: 2026-04-13T12:48:02.968Z
 
 This is a concise summary of all available API functions and types.
 
@@ -103,6 +103,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **async** - Functions for async operations
 - **attestation** - Functions for attestation operations
 - **attestations** - Functions for attestations operations
+- **config** - Functions for config operations
 - **containers** - Functions for containers operations
 - **facets** - Functions for facets operations
 - **jobs** - Functions for jobs operations
@@ -3745,6 +3746,90 @@ export interface TransactionalSendError {
 
 export type TransactionalSendResult =`
 
+### config
+
+**FieldOption** (interface)
+```typescript
+interface FieldOption {
+  label: string
+  value: string
+}
+```
+
+**FieldDefinition** (interface)
+```typescript
+interface FieldDefinition {
+  id: string
+  label: string
+  storageKey?: string
+  type: FieldType
+  options?: FieldOption[]
+  required?: boolean
+  col?: number
+  placeholder?: string
+  help?: string
+  min?: number
+  max?: number
+  step?: number
+  rows?: number
+  autoGrow?: boolean
+  accept?: string
+  clearable?: boolean
+  disabled?: boolean
+  * Conditional visibility. If absent the field is always shown.
+  * Object form: `{ field: 'someKey', equals: 'someValue' }` — show when `model[field] === equals`.
+  showIf?: { field: string; equals: unknown }
+}
+```
+
+**ProofTypeDefinition** (interface)
+```typescript
+interface ProofTypeDefinition {
+  id: string
+  name: string
+  description?: string
+  * Grouping used to organise proof types in the picker.
+  * Examples: 'basic', 'retail', 'ownable', 'consumable', 'attendance',
+  * 'qualification', 'creative', 'memories', 'safety', 'connected',
+  * 'smartdocent', 'tradable'
+  category?: string
+  * Whether this proof type is shown to users.
+  * Only types with `active === true` are returned to the public API
+  * when the platform admin has filtered by "Only Active".
+  active?: boolean
+  group: boolean
+  * The underlying proof mechanisms that products of this type can use.
+  * Stored as `proofTypes` (plural) on the product document.
+  proofTypes?: ProofMechanism[]
+  proofType?: ProofMechanism
+  * Field IDs (from the field catalog) shown when creating/editing the product group.
+  * Ordered — rendered in this sequence.
+  groupFields?: string[]
+  * Field IDs shown when creating/editing an individual proof item within the group.
+  * If absent, falls back to groupFields.
+  proofFields?: string[]
+  * Column definitions shown in the proof list view.
+  * Keys are field IDs; value true means show the column.
+  listFields?: Record<string, boolean>
+  * App uniqueNames automatically installed (for free) when this proof type is selected.
+  freeApps?: string[]
+  * App uniqueNames shown as recommended paid add-ons for this proof type.
+  apps?: string[]
+  collection?: string
+  action?: string
+  bound?: 'soul'
+  * UI translation overrides for this proof type.
+  * Keys are source English words; values are replacement strings.
+  * Example: `{ "Products": "Works" }`
+  translations?: Record<string, string>
+  hideProductTools?: boolean
+}
+```
+
+**FieldType** = ``
+
+**ProofMechanism** = ``
+
 ### contact
 
 **Contact** (interface)
@@ -7637,6 +7722,14 @@ Logging: Append a single communication event. POST /admin/collection/:collection
     body: LogBulkCommunicationEventsBody | ({ sourceId: string; ids: string[]; idField?: 'userId'|'contactId'; [k: string]: any }) → `void`
 Logging: Append many communication events for a list of IDs. POST /admin/collection/:collectionId/comm/log/bulk
 
+### config
+
+**getFields**() → `Promise<FieldDefinition[]>`
+Returns the full platform field catalog. Fields are used as building blocks for proof type templates — they define the input widgets shown when creating or editing products and proof items. **Endpoint:** `GET /api/v1/public/config/fields`
+
+**getProofTypes**() → `Promise<ProofTypeDefinition[]>`
+Returns all proof type definitions. Proof types are templates that specify which fields to show, which apps are pre-installed, and how the portal behaves for a given product category. **Endpoint:** `GET /api/v1/public/config/proofTypes`
+
 ### contact
 
 **create**(collectionId: string, data: ContactCreateRequest) → `Promise<ContactResponse>`

package/dist/openapi.yaml

@@ -32,6 +32,7 @@ tags:
   - name: claimSet
   - name: collection
   - name: comms
+  - name: config
   - name: contact
   - name: containers
   - name: crate
@@ -11831,6 +11832,50 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TranslationLookupRequest"
+  /public/config/fields:
+    get:
+      tags:
+        - config
+      summary: Returns the full platform field catalog.
+      operationId: config_getFields
+      security: []
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/FieldDefinition"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /public/config/proofTypes:
+    get:
+      tags:
+        - config
+      summary: Returns the full platform field catalog.
+      operationId: config_getProofTypes
+      security: []
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ProofTypeDefinition"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /public/location/{locationId}:
     get:
       tags:
@@ -17691,6 +17736,132 @@ components:
       required:
         - ok
         - error
+    FieldOption:
+      type: object
+      properties:
+        label:
+          type: string
+        value:
+          type: string
+      required:
+        - label
+        - value
+    FieldDefinition:
+      type: object
+      properties:
+        id:
+          type: string
+        label:
+          type: string
+        storageKey:
+          type: string
+        type:
+          $ref: "#/components/schemas/FieldType"
+        options:
+          type: array
+          items:
+            $ref: "#/components/schemas/FieldOption"
+        required:
+          type: boolean
+        col:
+          type: number
+        placeholder:
+          type: string
+        help:
+          type: string
+        min:
+          type: number
+        max:
+          type: number
+        step:
+          type: number
+        rows:
+          type: number
+        autoGrow:
+          type: boolean
+        accept:
+          type: string
+        clearable:
+          type: boolean
+        disabled:
+          type: boolean
+        showIf:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+        - label
+        - type
+    ProofTypeDefinition:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        description:
+          type: string
+        category:
+          type: string
+        active:
+          type: boolean
+        group:
+          type: boolean
+        proofTypes:
+          type: array
+          items:
+            $ref: "#/components/schemas/ProofMechanism"
+        proofType:
+          $ref: "#/components/schemas/ProofMechanism"
+        groupFields:
+          type: array
+          items:
+            type: string
+        proofFields:
+          type: array
+          items:
+            type: string
+        listFields:
+          type: object
+          additionalProperties:
+            type: boolean
+        freeApps:
+          type: array
+          items:
+            type: string
+        apps:
+          type: array
+          items:
+            type: string
+        collection:
+          type: string
+        action:
+          type: string
+        bound:
+          type: string
+          enum:
+            - soul
+        translations:
+          type: object
+          additionalProperties:
+            type: string
+        hideProductTools:
+          type: boolean
+      required:
+        - id
+        - name
+        - group
+    FieldType:
+      type: array
+      items:
+        type: string
+        enum:
+          - text
+          - email
+          - url
+          - textarea
+          - number
+          - select
     Contact:
       type: object
       properties:

package/dist/types/config.d.ts

@@ -0,0 +1,132 @@
+/** Accepted input widget types for a FieldDefinition. */
+export type FieldType = 'text' | 'email' | 'url' | 'textarea' | 'number' | 'select' | 'switch' | 'checkbox' | 'date' | 'json' | 'image-upload' | 'file-upload';
+/** A label/value pair used when FieldDefinition.type === 'select'. */
+export interface FieldOption {
+    label: string;
+    value: string;
+}
+/**
+ * A single entry in the platform field catalog.
+ * Fields are referenced by their `id` inside ProofTypeDefinition.groupFields / proofFields arrays.
+ */
+export interface FieldDefinition {
+    /** Unique identifier, kebab-case. Auto-generated from `label` if omitted on create. */
+    id: string;
+    /** Human-readable display label shown in forms. */
+    label: string;
+    /** Key used when storing the value on the product/proof document. Defaults to `id`. */
+    storageKey?: string;
+    /** Input widget type. */
+    type: FieldType;
+    /** Available choices — only relevant when type === 'select'. */
+    options?: FieldOption[];
+    /** Whether the field must be filled in. */
+    required?: boolean;
+    /** Column span (1–12) in a 12-column grid. */
+    col?: number;
+    /** Placeholder text shown inside the input. */
+    placeholder?: string;
+    /** Descriptive hint shown below the input. */
+    help?: string;
+    /** Numeric minimum — only relevant when type === 'number'. */
+    min?: number;
+    /** Numeric maximum — only relevant when type === 'number'. */
+    max?: number;
+    /** Step increment — only relevant when type === 'number'. */
+    step?: number;
+    /** Number of visible rows — only relevant when type === 'textarea' or 'json'. */
+    rows?: number;
+    /** Auto-grow textarea height — only relevant when type === 'textarea'. */
+    autoGrow?: boolean;
+    /** Accept filter passed to the file input — only relevant when type === 'image-upload' or 'file-upload'. Examples: 'image/*', '.glb,.gltf,.fbx' */
+    accept?: string;
+    /** Whether the input has a clear (×) button (text/number fields). Default true. */
+    clearable?: boolean;
+    /** Disable this field regardless of model state. */
+    disabled?: boolean;
+    /**
+     * Conditional visibility. If absent the field is always shown.
+     * Object form: `{ field: 'someKey', equals: 'someValue' }` — show when `model[field] === equals`.
+     */
+    showIf?: {
+        field: string;
+        equals: unknown;
+    };
+}
+/**
+ * The base proof mechanism that items in a proof type use.
+ * Matches the `proofType` / `proofTypes` values stored on product documents.
+ */
+export type ProofMechanism = 'certificate' | 'ownable' | 'consumable' | 'timeline' | 'docent' | 'connected' | 'text' | 'image' | 'video';
+/**
+ * A proof type defines a template for creating products.
+ * It specifies which fields to show, which apps are pre-installed,
+ * and how the portal should behave.
+ */
+export interface ProofTypeDefinition {
+    /** Unique identifier, kebab-case. Auto-generated from `name` if omitted on create. */
+    id: string;
+    /** Human-readable name shown in product-creation wizards. */
+    name: string;
+    /** Long description shown in the proof type picker UI. */
+    description?: string;
+    /**
+     * Grouping used to organise proof types in the picker.
+     * Examples: 'basic', 'retail', 'ownable', 'consumable', 'attendance',
+     * 'qualification', 'creative', 'memories', 'safety', 'connected',
+     * 'smartdocent', 'tradable'
+     */
+    category?: string;
+    /**
+     * Whether this proof type is shown to users.
+     * Only types with `active === true` are returned to the public API
+     * when the platform admin has filtered by "Only Active".
+     */
+    active?: boolean;
+    /** Whether this proof type produces a group of items (true) or a single item (false). */
+    group: boolean;
+    /**
+     * The underlying proof mechanisms that products of this type can use.
+     * Stored as `proofTypes` (plural) on the product document.
+     */
+    proofTypes?: ProofMechanism[];
+    /** Legacy single-value equivalent of proofTypes. */
+    proofType?: ProofMechanism;
+    /**
+     * Field IDs (from the field catalog) shown when creating/editing the product group.
+     * Ordered — rendered in this sequence.
+     */
+    groupFields?: string[];
+    /**
+     * Field IDs shown when creating/editing an individual proof item within the group.
+     * If absent, falls back to groupFields.
+     */
+    proofFields?: string[];
+    /**
+     * Column definitions shown in the proof list view.
+     * Keys are field IDs; value true means show the column.
+     */
+    listFields?: Record<string, boolean>;
+    /**
+     * App uniqueNames automatically installed (for free) when this proof type is selected.
+     */
+    freeApps?: string[];
+    /**
+     * App uniqueNames shown as recommended paid add-ons for this proof type.
+     */
+    apps?: string[];
+    /** Collection-level slug that this proof type is scoped to (legacy, rarely used). */
+    collection?: string;
+    /** Action name used by the legacy proof action pipeline. */
+    action?: string;
+    /** Whether items are soul-bound (non-transferable by default). */
+    bound?: 'soul';
+    /**
+     * UI translation overrides for this proof type.
+     * Keys are source English words; values are replacement strings.
+     * Example: `{ "Products": "Works" }`
+     */
+    translations?: Record<string, string>;
+    /** Whether product tools (edit, duplicate, etc.) are hidden in the console UI. */
+    hideProductTools?: boolean;
+}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+// src/types/config.ts
+export {};

package/dist/types/index.d.ts

@@ -33,3 +33,4 @@ export * from "./appManifest";
 export * from "./appObjects";
 export * from "./loyalty";
 export * from "./translations";
+export * from "./config";

package/dist/types/index.js

@@ -35,3 +35,4 @@ export * from "./appManifest";
 export * from "./appObjects";
 export * from "./loyalty";
 export * from "./translations";
+export * from "./config";

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.9.14  |  Generated: 2026-03-31T19:46:30.667Z
+Version: 1.9.15  |  Generated: 2026-04-13T12:48:02.968Z
 
 This is a concise summary of all available API functions and types.
 
@@ -103,6 +103,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **async** - Functions for async operations
 - **attestation** - Functions for attestation operations
 - **attestations** - Functions for attestations operations
+- **config** - Functions for config operations
 - **containers** - Functions for containers operations
 - **facets** - Functions for facets operations
 - **jobs** - Functions for jobs operations
@@ -3745,6 +3746,90 @@ export interface TransactionalSendError {
 
 export type TransactionalSendResult =`
 
+### config
+
+**FieldOption** (interface)
+```typescript
+interface FieldOption {
+  label: string
+  value: string
+}
+```
+
+**FieldDefinition** (interface)
+```typescript
+interface FieldDefinition {
+  id: string
+  label: string
+  storageKey?: string
+  type: FieldType
+  options?: FieldOption[]
+  required?: boolean
+  col?: number
+  placeholder?: string
+  help?: string
+  min?: number
+  max?: number
+  step?: number
+  rows?: number
+  autoGrow?: boolean
+  accept?: string
+  clearable?: boolean
+  disabled?: boolean
+  * Conditional visibility. If absent the field is always shown.
+  * Object form: `{ field: 'someKey', equals: 'someValue' }` — show when `model[field] === equals`.
+  showIf?: { field: string; equals: unknown }
+}
+```
+
+**ProofTypeDefinition** (interface)
+```typescript
+interface ProofTypeDefinition {
+  id: string
+  name: string
+  description?: string
+  * Grouping used to organise proof types in the picker.
+  * Examples: 'basic', 'retail', 'ownable', 'consumable', 'attendance',
+  * 'qualification', 'creative', 'memories', 'safety', 'connected',
+  * 'smartdocent', 'tradable'
+  category?: string
+  * Whether this proof type is shown to users.
+  * Only types with `active === true` are returned to the public API
+  * when the platform admin has filtered by "Only Active".
+  active?: boolean
+  group: boolean
+  * The underlying proof mechanisms that products of this type can use.
+  * Stored as `proofTypes` (plural) on the product document.
+  proofTypes?: ProofMechanism[]
+  proofType?: ProofMechanism
+  * Field IDs (from the field catalog) shown when creating/editing the product group.
+  * Ordered — rendered in this sequence.
+  groupFields?: string[]
+  * Field IDs shown when creating/editing an individual proof item within the group.
+  * If absent, falls back to groupFields.
+  proofFields?: string[]
+  * Column definitions shown in the proof list view.
+  * Keys are field IDs; value true means show the column.
+  listFields?: Record<string, boolean>
+  * App uniqueNames automatically installed (for free) when this proof type is selected.
+  freeApps?: string[]
+  * App uniqueNames shown as recommended paid add-ons for this proof type.
+  apps?: string[]
+  collection?: string
+  action?: string
+  bound?: 'soul'
+  * UI translation overrides for this proof type.
+  * Keys are source English words; values are replacement strings.
+  * Example: `{ "Products": "Works" }`
+  translations?: Record<string, string>
+  hideProductTools?: boolean
+}
+```
+
+**FieldType** = ``
+
+**ProofMechanism** = ``
+
 ### contact
 
 **Contact** (interface)
@@ -7637,6 +7722,14 @@ Logging: Append a single communication event. POST /admin/collection/:collection
     body: LogBulkCommunicationEventsBody | ({ sourceId: string; ids: string[]; idField?: 'userId'|'contactId'; [k: string]: any }) → `void`
 Logging: Append many communication events for a list of IDs. POST /admin/collection/:collectionId/comm/log/bulk
 
+### config
+
+**getFields**() → `Promise<FieldDefinition[]>`
+Returns the full platform field catalog. Fields are used as building blocks for proof type templates — they define the input widgets shown when creating or editing products and proof items. **Endpoint:** `GET /api/v1/public/config/fields`
+
+**getProofTypes**() → `Promise<ProofTypeDefinition[]>`
+Returns all proof type definitions. Proof types are templates that specify which fields to show, which apps are pre-installed, and how the portal behaves for a given product category. **Endpoint:** `GET /api/v1/public/config/proofTypes`
+
 ### contact
 
 **create**(collectionId: string, data: ContactCreateRequest) → `Promise<ContactResponse>`

package/openapi.yaml

@@ -32,6 +32,7 @@ tags:
   - name: claimSet
   - name: collection
   - name: comms
+  - name: config
   - name: contact
   - name: containers
   - name: crate
@@ -11831,6 +11832,50 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TranslationLookupRequest"
+  /public/config/fields:
+    get:
+      tags:
+        - config
+      summary: Returns the full platform field catalog.
+      operationId: config_getFields
+      security: []
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/FieldDefinition"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+  /public/config/proofTypes:
+    get:
+      tags:
+        - config
+      summary: Returns the full platform field catalog.
+      operationId: config_getProofTypes
+      security: []
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ProofTypeDefinition"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /public/location/{locationId}:
     get:
       tags:
@@ -17691,6 +17736,132 @@ components:
       required:
         - ok
         - error
+    FieldOption:
+      type: object
+      properties:
+        label:
+          type: string
+        value:
+          type: string
+      required:
+        - label
+        - value
+    FieldDefinition:
+      type: object
+      properties:
+        id:
+          type: string
+        label:
+          type: string
+        storageKey:
+          type: string
+        type:
+          $ref: "#/components/schemas/FieldType"
+        options:
+          type: array
+          items:
+            $ref: "#/components/schemas/FieldOption"
+        required:
+          type: boolean
+        col:
+          type: number
+        placeholder:
+          type: string
+        help:
+          type: string
+        min:
+          type: number
+        max:
+          type: number
+        step:
+          type: number
+        rows:
+          type: number
+        autoGrow:
+          type: boolean
+        accept:
+          type: string
+        clearable:
+          type: boolean
+        disabled:
+          type: boolean
+        showIf:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+        - label
+        - type
+    ProofTypeDefinition:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        description:
+          type: string
+        category:
+          type: string
+        active:
+          type: boolean
+        group:
+          type: boolean
+        proofTypes:
+          type: array
+          items:
+            $ref: "#/components/schemas/ProofMechanism"
+        proofType:
+          $ref: "#/components/schemas/ProofMechanism"
+        groupFields:
+          type: array
+          items:
+            type: string
+        proofFields:
+          type: array
+          items:
+            type: string
+        listFields:
+          type: object
+          additionalProperties:
+            type: boolean
+        freeApps:
+          type: array
+          items:
+            type: string
+        apps:
+          type: array
+          items:
+            type: string
+        collection:
+          type: string
+        action:
+          type: string
+        bound:
+          type: string
+          enum:
+            - soul
+        translations:
+          type: object
+          additionalProperties:
+            type: string
+        hideProductTools:
+          type: boolean
+      required:
+        - id
+        - name
+        - group
+    FieldType:
+      type: array
+      items:
+        type: string
+        enum:
+          - text
+          - email
+          - url
+          - textarea
+          - number
+          - select
     Contact:
       type: object
       properties:

package/package.json

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