@proveanything/smartlinks 1.8.11 → 1.9.0

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.8.11  |  Generated: 2026-03-19T19:58:44.820Z
+Version: 1.9.0  |  Generated: 2026-03-22T15:51:25.814Z
 
 This is a concise summary of all available API functions and types.
 
@@ -26,6 +26,7 @@ For detailed guides on specific features:
 - **[App Objects: Cases, Threads & Records](app-objects.md)** - Generic app-scoped building blocks for support cases, discussions, bookings, registrations, and more
 - **[Communications](comms.md)** - Transactional sends, multi-channel broadcasts, consent management, push registration, and analytics
 - **[Interactions & Event Tracking](interactions.md)** - Log user events, count outcomes, query history, and define interaction types with permissions
+- **[Loyalty: Points, Members & Earning Rules](loyalty.md)** - Loyalty schemes, automatic point earning via interaction rules, member balances, transaction history, and manual adjustments
 - **[Deep Link Discovery](deep-link-discovery.md)** - Registering and discovering navigable app states for portal menus and AI orchestration
 - **[AI-Native App Manifests](manifests.md)** - How AI workflows discover, configure, and import apps via structured manifests and prose guides
 - **[AI Guide Template](ai-guide-template.md)** - A sample for an app on how to build an AI setup guide
@@ -79,6 +80,7 @@ The Smartlinks SDK is organized into the following namespaces:
 
 — Analytics & Events —
 - **interactions** - Log and analyze interactions/outcomes; aggregates and actor lists; interaction definition CRUD. → [Guide](interactions.md)
+- **loyalty** - Loyalty programmes: schemes, earning rules tied to interactions, member balances, transaction ledger, and manual adjustments. → [Guide](loyalty.md)
 
 — Automation —
 - **journeys** - Configure automated flows triggered by events or schedules; steps, rules; full CRUD.
@@ -99,10 +101,12 @@ The Smartlinks SDK is organized into the following namespaces:
 - **attestation** - Functions for attestation operations
 - **attestations** - Functions for attestations operations
 - **containers** - Functions for containers operations
+- **facets** - Functions for facets operations
 - **jobs** - Functions for jobs operations
 - **journeysAnalytics** - Functions for journeysAnalytics operations
 - **location** - Functions for location operations
 - **order** - Functions for order operations
+- **products** - Functions for products operations
 - **realtime** - Functions for realtime operations
 - **tags** - Functions for tags operations
 - **template** - Functions for template operations
@@ -159,7 +163,7 @@ Returns true if the SDK currently has any auth credential set (bearer token or A
 Configure the SDK's built-in in-memory GET cache. The cache is transparent — it sits inside the HTTP layer and requires no changes to your existing API calls. All GET requests benefit automatically. Per-resource rules (collections/products → 1 h, proofs → 30 s, etc.) override this value. in-memory only (`'none'`, default). Ignored in Node.js. fallback, from the original fetch time (default: 7 days). `SmartlinksOfflineError` with stale data instead of propagating the network error. caches on page load/refresh. IndexedDB persists for offline. ```ts // Enable IndexedDB persistence for offline support configureSdkCache({ persistence: 'indexeddb' }) // Disable cache entirely in test environments configureSdkCache({ enabled: false }) // Keep caches across page refreshes (not recommended for production) configureSdkCache({ clearOnPageLoad: false }) ```
 
 **invalidateCache**(urlPattern?: string) → `void`
-Manually invalidate entries in the SDK's GET cache. *contains* this string is removed. Omit (or pass `undefined`) to wipe the entire cache. ```ts invalidateCache()                     // clear everything invalidateCache('/collection/abc123') // one specific collection invalidateCache('/product/')          // all product responses ```
+Manually invalidate entries in the SDK's GET cache. *contains* this string is removed. Omit (or pass `undefined`) to wipe the entire cache. ```ts invalidateCache()                     // clear everything invalidateCache('/collection/abc123') // one specific collection invalidateCache('/product/')          // all legacy singular product responses invalidateCache('/products/')         // all canonical plural product responses ```
 
 **proxyUploadFormData**(path: string,
   formData: FormData,
@@ -4173,6 +4177,194 @@ interface ErrorResponse {
 }
 ```
 
+### facets
+
+**FacetDefinition** (interface)
+```typescript
+interface FacetDefinition {
+  id?: string
+  orgId?: string
+  collectionId?: string | null
+  key: string
+  name: string
+  description?: string | null
+  cardinality?: "single" | "multi"
+  kind?: "system" | "custom"
+  hierarchical?: boolean
+  reserved?: boolean
+  enabled?: boolean
+  sortOrder?: number | null
+  config?: Record<string, JsonValue>
+  createdAt?: string
+  updatedAt?: string
+  deletedAt?: string | null
+  values?: FacetValue[]
+}
+```
+
+**FacetValue** (interface)
+```typescript
+interface FacetValue {
+  id?: string
+  orgId?: string
+  collectionId?: string | null
+  facetDefinitionId?: string
+  facetKey: string
+  key: string
+  slug?: string | null
+  name: string
+  shortName?: string | null
+  description?: string | null
+  color?: string | null
+  icon?: string | null
+  image?: Record<string, JsonValue> | null
+  metadata?: Record<string, JsonValue>
+  sortOrder?: number | null
+  parentValueId?: string | null
+  parentValueKey?: string | null
+  enabled?: boolean
+  createdAt?: string
+  updatedAt?: string
+  deletedAt?: string | null
+  count?: number
+}
+```
+
+**FacetDefinitionWriteInput** (interface)
+```typescript
+interface FacetDefinitionWriteInput {
+  key?: string
+  name: string
+  description?: string | null
+  cardinality?: "single" | "multi"
+  kind?: "system" | "custom"
+  hierarchical?: boolean
+  reserved?: boolean
+  enabled?: boolean
+  sortOrder?: number | null
+  config?: Record<string, JsonValue>
+}
+```
+
+**FacetValueWriteInput** (interface)
+```typescript
+interface FacetValueWriteInput {
+  key?: string
+  slug?: string | null
+  name: string
+  shortName?: string | null
+  description?: string | null
+  color?: string | null
+  icon?: string | null
+  image?: Record<string, JsonValue> | null
+  metadata?: Record<string, JsonValue>
+  sortOrder?: number | null
+  parentValueKey?: string | null
+  enabled?: boolean
+}
+```
+
+**FacetListResponse** (interface)
+```typescript
+interface FacetListResponse {
+  items: FacetDefinition[]
+}
+```
+
+**FacetValueListResponse** (interface)
+```typescript
+interface FacetValueListResponse {
+  facet: FacetDefinition
+  items: FacetValue[]
+}
+```
+
+**FacetValueResponse** (interface)
+```typescript
+interface FacetValueResponse {
+  facet: FacetDefinition
+  item: FacetValue
+}
+```
+
+**FacetQueryRequest** (interface)
+```typescript
+interface FacetQueryRequest {
+  facetKeys?: string[]
+  includeEmpty?: boolean
+  includeDeleted?: boolean
+  query?: ProductQueryRequest["query"] & {
+  facetEquals?: Record<string, JsonValue | JsonValue[]>
+  }
+}
+```
+
+**FacetBucket** (interface)
+```typescript
+interface FacetBucket {
+  facetKey: string
+  valueKey: string
+  name?: string
+  count: number
+}
+```
+
+**FacetQueryResponse** (interface)
+```typescript
+interface FacetQueryResponse {
+  items: Array<{
+  facet: FacetDefinition
+  values: FacetValue[]
+  }>
+  buckets: FacetBucket[]
+  meta?: {
+  source?: "postgres"
+  matchedProducts?: number
+  }
+}
+```
+
+**FacetListParams** (interface)
+```typescript
+interface FacetListParams {
+  includeValues?: boolean
+  includeDeleted?: boolean
+  kind?: "system" | "custom"
+  reserved?: boolean
+}
+```
+
+**PublicFacetListParams** (interface)
+```typescript
+interface PublicFacetListParams {
+  includeValues?: boolean
+}
+```
+
+**FacetGetParams** (interface)
+```typescript
+interface FacetGetParams {
+  includeValues?: boolean
+  includeDeleted?: boolean
+}
+```
+
+**FacetValueListParams** (interface)
+```typescript
+interface FacetValueListParams {
+  includeDeleted?: boolean
+}
+```
+
+**FacetValueGetParams** (interface)
+```typescript
+interface FacetValueGetParams {
+  includeDeleted?: boolean
+}
+```
+
+**FacetValueDefinition** = `FacetValue`
+
 ### iframeResponder
 
 **CachedData** (interface)
@@ -4861,6 +5053,174 @@ interface LocationSearchResponse {
 
 **LocationPayload** = `Omit<`
 
+### loyalty
+
+**LoyaltyScheme** (interface)
+```typescript
+interface LoyaltyScheme {
+  id: string
+  orgId: string
+  collectionId: string
+  name: string
+  type: string
+  active: boolean
+  createdAt: string // ISO
+  updatedAt: string // ISO
+  deletedAt: string | null // ISO
+  data: DataBlock
+  owner?: DataBlock
+  admin?: DataBlock
+}
+```
+
+**LoyaltyMember** (interface)
+```typescript
+interface LoyaltyMember {
+  id: string
+  orgId: string
+  collectionId: string
+  schemeId: string
+  contactId: string
+  userId: string | null
+  balance: number
+  lifetimePoints: number
+  createdAt: string // ISO
+  updatedAt: string // ISO
+  data: DataBlock
+  owner?: DataBlock
+  admin?: DataBlock
+}
+```
+
+**LoyaltyTransaction** (interface)
+```typescript
+interface LoyaltyTransaction {
+  id: string
+  orgId: string
+  collectionId: string
+  schemeId: string
+  memberId: string
+  points: number
+  reason: string | null
+  idempotencyKey: string | null
+  metadata: DataBlock
+  createdAt: string // ISO
+}
+```
+
+**LoyaltyEarningRule** (interface)
+```typescript
+interface LoyaltyEarningRule {
+  id: string
+  orgId: string
+  collectionId: string
+  schemeId: string
+  interactionId: string
+  points: number
+  * Key-value conditions matched against the interaction event before awarding.
+  * Supports top-level event fields (outcome, scope, status, eventType, etc.)
+  * and dot-path into metadata (e.g. `"metadata.tier": "gold"`).
+  * Empty object = always fires for any event on this interaction.
+  conditions: Record<string, string>
+  maxPerContact: number | null
+  cooldownHours: number | null
+  active: boolean
+  createdAt: string // ISO
+  updatedAt: string // ISO
+  data: DataBlock
+}
+```
+
+**LoyaltyTransactionResult** (interface)
+```typescript
+interface LoyaltyTransactionResult {
+  member: LoyaltyMember
+  transaction: LoyaltyTransaction
+}
+```
+
+**LoyaltyPaginationParams** (interface)
+```typescript
+interface LoyaltyPaginationParams {
+  limit?: number  // default 50, max 200
+  offset?: number
+}
+```
+
+**LoyaltyPaginatedResult<T>** (interface)
+```typescript
+interface LoyaltyPaginatedResult<T> {
+  items: T[]
+  limit: number
+  offset: number
+}
+```
+
+**CreateLoyaltySchemeBody** (interface)
+```typescript
+interface CreateLoyaltySchemeBody {
+  name: string
+  type: string
+  active?: boolean
+  data?: DataBlock
+  owner?: DataBlock
+  admin?: DataBlock
+}
+```
+
+**UpdateLoyaltySchemeBody** (interface)
+```typescript
+interface UpdateLoyaltySchemeBody {
+  name?: string
+  type?: string
+  active?: boolean
+  data?: DataBlock
+  owner?: DataBlock
+  admin?: DataBlock
+}
+```
+
+**CreateLoyaltyEarningRuleBody** (interface)
+```typescript
+interface CreateLoyaltyEarningRuleBody {
+  interactionId: string
+  points: number
+  conditions?: Record<string, string>
+  maxPerContact?: number | null
+  cooldownHours?: number | null
+  active?: boolean
+  data?: DataBlock
+}
+```
+
+**UpdateLoyaltyEarningRuleBody** (interface)
+```typescript
+interface UpdateLoyaltyEarningRuleBody {
+  points?: number
+  conditions?: Record<string, string>
+  maxPerContact?: number | null
+  cooldownHours?: number | null
+  active?: boolean
+  data?: DataBlock
+}
+```
+
+**RecordLoyaltyTransactionBody** (interface)
+```typescript
+interface RecordLoyaltyTransactionBody {
+  points: number
+  reason?: string
+  * Optional caller-supplied key scoped to the scheme.
+  * If a transaction with this key already exists the server returns 409.
+  * Use to safely retry without double-crediting points.
+  idempotencyKey?: string
+  metadata?: DataBlock
+  userId?: string
+}
+```
+
+**DataBlock** = `Record<string, unknown>`
+
 ### nfc
 
 **NfcTagInfo** (interface)
@@ -5408,46 +5768,175 @@ interface CollectionSummaryResponse {
 
 ### product
 
-**Product** (interface)
+**ProductKey** (interface)
 ```typescript
-interface Product {
-  id: string
-  name: string
+interface ProductKey {
   collectionId: string
-  description: string
-  gtin?: string
+  id: string
+}
+```
+
+**ProductImageThumbnails** (interface)
+```typescript
+interface ProductImageThumbnails {
+  x100?: string
+  x200?: string
+  x512?: string
+}
+```
+
+**ProductImage** (interface)
+```typescript
+interface ProductImage {
+  id?: string
+  collectionId?: string
+  productId?: string
+  site?: string
+  name?: string
+  cleanName?: string
+  assetType?: string
   type?: string
-  * Hero image asset object.
-  * When creating/updating, you can pass either:
-  * - A full asset object with url and thumbnails
-  * - A string URL - the system will automatically fetch and store the image
-  heroImage: {
+  url?: string
+  thumbnails?: ProductImageThumbnails
+  contentType?: string
+  size?: string | number
+  hash?: string
+  createdAt?: ISODateString | null
+  updatedAt?: ISODateString | null
+  deletedAt?: ISODateString | null
+}
+```
+
+**ProductImageUrlInput** (interface)
+```typescript
+interface ProductImageUrlInput {
   url: string
-  thumbnails: {
-  x100: string
-  x200: string
-  x512: string
+}
+```
+
+**AdditionalGtin** (interface)
+```typescript
+interface AdditionalGtin {
+  gtin: string
+  owner?: boolean | null
+}
+```
+
+**ProductFacetValue** (interface)
+```typescript
+interface ProductFacetValue {
+  id?: string
+  key: string
+  slug?: string
+  name: string
+  shortName?: string
+  description?: string
+  color?: string
+  icon?: string
+}
+```
+
+**ProductFacetMap** (interface)
+```typescript
+interface ProductFacetMap {
+  [facetKey: string]: ProductFacetValue[]
+}
+```
+
+**ProductQueryRequest** (interface)
+```typescript
+interface ProductQueryRequest {
+  query?: {
+  search?: string
+  status?: string[]
+  category?: string[]
+  type?: string[]
+  schemaType?: string[]
+  tags?: string[]
+  productIds?: string[]
+  sku?: string
+  gtin?: string
+  updatedAfter?: ISODateString
+  updatedBefore?: ISODateString
+  createdAfter?: ISODateString
+  createdBefore?: ISODateString
+  facetEquals?: Record<string, JsonValue>
+  }
+  sort?: Array<{
+  field: string
+  direction: 'asc' | 'desc'
+  }>
+  page?: {
+  limit?: number
+  offset?: number
+  cursor?: string | null
   }
+  includeDeleted?: boolean
+}
+```
+
+**ProductWriteInput** (interface)
+```typescript
+interface ProductWriteInput {
+  id?: string
+  name: string
+  description?: string | null
+  gtin?: string | null
+  ownGtin?: boolean | null
+  additionalGtins?: AdditionalGtin[]
+  sku?: string | null
+  schemaType?: string | null
+  type?: string | null
+  category?: string | null
+  label?: string | null
+  status?: string | null
+  sortOrder?: number | null
+  heroImage?: ProductImage | ProductImageUrlInput | string | null
+  facets?: ProductFacetMap
+  tags?: Record<string, boolean>
+  data?: Record<string, JsonValue>
+  admin?: ProductAdminData
+  extra?: Record<string, JsonValue>
+  validCollections?: string[]
+}
+```
+
+**ProductQueryResponse** (interface)
+```typescript
+interface ProductQueryResponse {
+  items: Product[]
+  page?: {
+  limit?: number
+  offset?: number
+  returned?: number
+  total?: number
+  hasMore?: boolean
+  nextCursor?: string | null
   }
-  tags: {
-  [tagName: string]: boolean
-  } // Flexible map of tags with true/false values
-  data: {
-  [key: string]: any
-  } // Flexible key/value data map
-  admin?: {
-  allowAutoGenerateClaims?: boolean
-  lastSerialId?: number
-  [key: string]: any
+  meta?: {
+  apiVersion?: 'v1'
+  mode?: 'canonical-products' | 'legacy-product-compatibility'
+  source?: 'postgres' | 'firestore' | 'compatibility-layer'
+  queryMode?: 'canonical' | 'compatibility'
+  unsupportedFilters?: string[]
+  supportedSortFields?: string[]
   }
 }
 ```
 
+**JsonPrimitive** = `string | number | boolean | null`
+
+**JsonValue** = ``
+
+**ISODateString** = `string`
+
+**ProductClaimCreateRequestBody** = `Omit<ProductClaimCreateInput, 'collectionId' | 'id'>`
+
 **ProductResponse** = `Product`
 
-**ProductCreateRequest** = `Omit<Product, 'id' | 'collectionId'> & {`
+**ProductCreateRequest** = `ProductWriteInput`
 
-**ProductUpdateRequest** = `Partial<Omit<Product, 'id' | 'collectionId'>> & {`
+**ProductUpdateRequest** = `Partial<Omit<ProductWriteInput, 'id'>>`
 
 ### proof
 
@@ -5931,6 +6420,10 @@ type VerifyTokenResponse = {
 }
 ```
 
+### products (api)
+
+**ProductPublicFindParams** = `Record<`
+
 ## API Functions
 
 ### analytics.admin
@@ -6913,6 +7406,67 @@ Update a crate for a collection (admin only). ```typescript const updated = awai
     crateId: string) → `Promise<DeleteCrateResponse>`
 Delete a crate for a collection (admin only). This performs a soft delete. ```typescript await crate.remove('coll_123', 'crate_abc123') ```
 
+### facets
+
+**list**(collectionId: string,
+    params?: FacetListParams) → `Promise<FacetListResponse>`
+
+**create**(collectionId: string,
+    data: FacetDefinitionWriteInput) → `Promise<FacetDefinition>`
+
+**get**(collectionId: string,
+    facetKey: string,
+    params?: FacetGetParams) → `Promise<FacetDefinition>`
+
+**update**(collectionId: string,
+    facetKey: string,
+    data: FacetDefinitionWriteInput) → `Promise<FacetDefinition>`
+
+**remove**(collectionId: string,
+    facetKey: string) → `Promise<void>`
+
+**listValues**(collectionId: string,
+    facetKey: string,
+    params?: FacetValueListParams) → `Promise<FacetValueListResponse>`
+
+**createValue**(collectionId: string,
+    facetKey: string,
+    data: FacetValueWriteInput) → `Promise<FacetValueResponse>`
+
+**getValue**(collectionId: string,
+    facetKey: string,
+    valueKey: string,
+    params?: FacetValueGetParams) → `Promise<FacetValueResponse>`
+
+**updateValue**(collectionId: string,
+    facetKey: string,
+    valueKey: string,
+    data: FacetValueWriteInput) → `Promise<FacetValueResponse>`
+
+**removeValue**(collectionId: string,
+    facetKey: string,
+    valueKey: string) → `Promise<void>`
+
+**query**(collectionId: string,
+    body: FacetQueryRequest) → `Promise<FacetQueryResponse>`
+
+**publicList**(collectionId: string,
+    params?: PublicFacetListParams) → `Promise<FacetListResponse>`
+
+**publicGet**(collectionId: string,
+    facetKey: string,
+    params?: PublicFacetListParams) → `Promise<FacetDefinition>`
+
+**publicListValues**(collectionId: string,
+    facetKey: string) → `Promise<FacetValueListResponse>`
+
+**publicGetValue**(collectionId: string,
+    facetKey: string,
+    valueKey: string) → `Promise<FacetValueResponse>`
+
+**publicQuery**(collectionId: string,
+    body: FacetQueryRequest) → `Promise<FacetQueryResponse>`
+
 ### form
 
 **get**(collectionId: string, formId: string, admin?: boolean) → `Promise<any>`
@@ -7064,6 +7618,89 @@ Public: Fetch a global location by ID GET /public/location/:locationId
     locationId: string) → `Promise<Location>`
 Public: Fetch a location for a collection; returns either a collection-owned or global fallback GET /public/collection/:collectionId/location/:locationId
 
+### loyalty
+
+Loyalty programmes built on top of collections. Configure schemes and earning rules; contacts earn points automatically via interaction events. See the [Loyalty guide](loyalty.md) for the full walkthrough.
+
+**list**(collectionId: string,
+    params: { includeDeleted?: boolean } = {}) → `Promise<LoyaltyScheme[]>`
+
+**get**(collectionId: string,
+    schemeId: string) → `Promise<LoyaltyScheme>`
+
+**create**(collectionId: string,
+    body: CreateLoyaltySchemeBody) → `Promise<LoyaltyScheme>`
+
+**update**(collectionId: string,
+    schemeId: string,
+    body: UpdateLoyaltySchemeBody) → `Promise<LoyaltyScheme>`
+
+**remove**(collectionId: string,
+    schemeId: string) → `Promise<LoyaltyScheme>`
+
+**listEarningRules**(collectionId: string,
+    schemeId: string) → `Promise<LoyaltyEarningRule[]>`
+
+**getEarningRule**(collectionId: string,
+    schemeId: string,
+    ruleId: string) → `Promise<LoyaltyEarningRule>`
+
+**createEarningRule**(collectionId: string,
+    schemeId: string,
+    body: CreateLoyaltyEarningRuleBody) → `Promise<LoyaltyEarningRule>`
+
+**updateEarningRule**(collectionId: string,
+    schemeId: string,
+    ruleId: string,
+    body: UpdateLoyaltyEarningRuleBody) → `Promise<LoyaltyEarningRule>`
+
+**removeEarningRule**(collectionId: string,
+    schemeId: string,
+    ruleId: string) → `Promise<LoyaltyEarningRule>`
+
+**listMembers**(collectionId: string,
+    schemeId: string,
+    params: LoyaltyPaginationParams = {}) → `Promise<LoyaltyPaginatedResult<LoyaltyMember>>`
+
+**getMember**(collectionId: string,
+    schemeId: string,
+    contactId: string) → `Promise<LoyaltyMember>`
+
+**recordTransaction**(collectionId: string,
+    schemeId: string,
+    contactId: string,
+    body: RecordLoyaltyTransactionBody) → `Promise<LoyaltyTransactionResult>`
+Manually award or deduct points for a contact. - `points` must be a non-zero integer - Positive = award, negative = deduct - Deducting below zero returns HTTP 422 `INSUFFICIENT_BALANCE` - Supply `idempotencyKey` to safely retry without double-crediting Points earned via interaction events are awarded automatically by the server — this endpoint is for manual adjustments and admin overrides.
+
+**getMemberHistory**(collectionId: string,
+    schemeId: string,
+    contactId: string,
+    params: LoyaltyPaginationParams = {}) → `Promise<LoyaltyPaginatedResult<LoyaltyTransaction>>`
+Manually award or deduct points for a contact. - `points` must be a non-zero integer - Positive = award, negative = deduct - Deducting below zero returns HTTP 422 `INSUFFICIENT_BALANCE` - Supply `idempotencyKey` to safely retry without double-crediting Points earned via interaction events are awarded automatically by the server — this endpoint is for manual adjustments and admin overrides.
+
+**publicList**(collectionId: string) → `Promise<LoyaltyScheme[]>`
+List active schemes for a collection. No authentication required.
+
+**publicGet**(collectionId: string,
+    schemeId: string) → `Promise<LoyaltyScheme>`
+Get a single active scheme. No authentication required.
+
+**publicListEarningRules**(collectionId: string,
+    schemeId: string) → `Promise<LoyaltyEarningRule[]>`
+List active earning rules for a scheme — useful for showing "how to earn" in a loyalty UI. No authentication required.
+
+**publicGetMe**(collectionId: string) → `Promise<LoyaltySchemeWithMembership[]>`
+Get all active schemes with the caller's membership embedded in each. This is the primary entry point for a loyalty widget — one call gives you everything needed to render a user's loyalty status across all programs in a collection. - Authenticated: `member` is populated with balance + lifetimePoints (or null if not yet enrolled in that scheme) - Unauthenticated: `member` is null on all schemes
+
+**publicGetMine**(collectionId: string,
+    schemeId: string) → `Promise<LoyaltyMember>`
+Get the authenticated caller's membership (balance + lifetimePoints) on a specific scheme. Requires authentication.
+
+**publicGetMineHistory**(collectionId: string,
+    schemeId: string,
+    params: LoyaltyPaginationParams = {}) → `Promise<LoyaltyPaginatedResult<LoyaltyTransaction>>`
+Get the authenticated caller's transaction history on a specific scheme. Ordered newest first. Requires authentication.
+
 ### models
 
 **list**(collectionId: string, params?: AIModelListParams) → `Promise<AIModelListResponse>`
@@ -7210,17 +7847,119 @@ Update a product for a collection (admin only). The `data` payload is a partial
     productId: string) → `Promise<void>`
 Delete a product for a collection (admin only).
 
+**query**(collectionId: string,
+    body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
+
+**find**(collectionId: string,
+    body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
+
+**publicFind**(collectionId: string,
+    params?: ProductPublicFindParams) → `Promise<ProductResponse[]>`
+
+**clone**(collectionId: string,
+    productId: string,
+    body: Record<string, JsonValue> = {}) → `Promise<ProductResponse>`
+
+**listAssets**(collectionId: string,
+    productId: string,
+    admin?: boolean) → `Promise<unknown>`
+
+**createClaimWindow**(collectionId: string,
+    productId: string,
+    body: Record<string, JsonValue>) → `Promise<unknown>`
+
+**updateClaimWindow**(collectionId: string,
+    productId: string,
+    claimId: string,
+    body: Record<string, JsonValue>) → `Promise<unknown>`
+
+**refresh**(collectionId: string,
+    productId: string) → `Promise<ProductResponse>`
+
 **getSN**(collectionId: string,
     productId: string,
     startIndex: number = 0,
-    count: number = 10) → `Promise<any>`
+    count: number = 10) → `Promise<unknown>`
 Get serial numbers for a product (admin only).
 
 **lookupSN**(collectionId: string,
     productId: string,
-    codeId: string) → `Promise<any>`
+    codeId: string) → `Promise<unknown>`
 Look up a serial number by code for a product (admin only).
 
+**publicLookupClaim**(collectionId: string,
+    productId: string,
+    claimId: string) → `Promise<unknown>`
+
+**publicCreateClaim**(collectionId: string,
+    productId: string,
+    body: ProductClaimCreateRequestBody) → `Promise<unknown>`
+
+### products
+
+**get**(collectionId: string,
+    productId: string,
+    admin?: boolean) → `Promise<ProductResponse>`
+
+**list**(collectionId: string,
+    admin?: boolean) → `Promise<ProductResponse[]>`
+
+**create**(collectionId: string,
+    data: ProductCreateRequest) → `Promise<ProductResponse>`
+
+**update**(collectionId: string,
+    productId: string,
+    data: ProductUpdateRequest) → `Promise<ProductResponse>`
+
+**remove**(collectionId: string,
+    productId: string) → `Promise<void>`
+
+**query**(collectionId: string,
+    body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
+
+**find**(collectionId: string,
+    body: ProductQueryRequest | Record<string, JsonValue>) → `Promise<ProductQueryResponse>`
+
+**publicFind**(collectionId: string,
+    params?: ProductPublicFindParams) → `Promise<ProductResponse[]>`
+
+**clone**(collectionId: string,
+    productId: string,
+    body: Record<string, JsonValue> = {}) → `Promise<ProductResponse>`
+
+**listAssets**(collectionId: string,
+    productId: string,
+    admin?: boolean) → `Promise<unknown>`
+
+**createClaimWindow**(collectionId: string,
+    productId: string,
+    body: Record<string, JsonValue>) → `Promise<unknown>`
+
+**updateClaimWindow**(collectionId: string,
+    productId: string,
+    claimId: string,
+    body: Record<string, JsonValue>) → `Promise<unknown>`
+
+**refresh**(collectionId: string,
+    productId: string) → `Promise<ProductResponse>`
+
+**getSN**(collectionId: string,
+    productId: string,
+    startIndex: number = 0,
+    count: number = 10) → `Promise<unknown>`
+
+**lookupSN**(collectionId: string,
+    productId: string,
+    codeId: string) → `Promise<unknown>`
+
+**publicLookupClaim**(collectionId: string,
+    productId: string,
+    claimId: string) → `Promise<unknown>`
+
+**publicCreateClaim**(collectionId: string,
+    productId: string,
+    body: ProductClaimCreateRequestBody) → `Promise<unknown>`
+
 ### proof
 
 **get**(collectionId: string,