@proveanything/smartlinks 1.8.9 → 1.8.11

package/dist/api/interactions.d.ts

@@ -1,4 +1,4 @@
-import type { AdminInteractionsCountsByOutcomeRequest, AdminInteractionsQueryRequest, AppendInteractionBody, UpdateInteractionBody, OutcomeCount, InteractionEventRow, PublicInteractionsCountsByOutcomeRequest, PublicInteractionsByUserRequest, CreateInteractionTypeBody, UpdateInteractionTypeBody, ListInteractionTypesQuery, InteractionTypeRecord, InteractionTypeList } from "../types/interaction";
+import type { AdminInteractionsCountsByOutcomeRequest, AdminInteractionsQueryRequest, AdminInteractionsAggregateRequest, AdminInteractionsAggregateResponse, AppendInteractionBody, UpdateInteractionBody, OutcomeCount, InteractionEventRow, PublicInteractionsCountsByOutcomeRequest, PublicInteractionsByUserRequest, CreateInteractionTypeBody, UpdateInteractionTypeBody, ListInteractionTypesQuery, InteractionTypeRecord, InteractionTypeList } from "../types/interaction";
 export declare namespace interactions {
     /**
      * POST /admin/collection/:collectionId/interactions/query
@@ -10,6 +10,15 @@ export declare namespace interactions {
      * Returns array of { outcome, count }.
      */
     function countsByOutcome(collectionId: string, query?: AdminInteractionsCountsByOutcomeRequest): Promise<OutcomeCount[]>;
+    /**
+     * POST /admin/collection/:collectionId/interactions/aggregate
+     * Returns grouped numeric aggregates (sum, avg, min, max, count).
+     */
+    function aggregate(collectionId: string, body: AdminInteractionsAggregateRequest): Promise<AdminInteractionsAggregateResponse>;
+    /**
+     * Legacy-friendly alias for aggregate().
+     */
+    function aggregateByOutcome(collectionId: string, body: AdminInteractionsAggregateRequest): Promise<AdminInteractionsAggregateResponse>;
     /**
      * POST /admin/collection/:collectionId/interactions/append
      * Appends one interaction event.

package/dist/api/interactions.js

@@ -35,6 +35,22 @@ export var interactions;
         return post(path, query);
     }
     interactions.countsByOutcome = countsByOutcome;
+    /**
+     * POST /admin/collection/:collectionId/interactions/aggregate
+     * Returns grouped numeric aggregates (sum, avg, min, max, count).
+     */
+    async function aggregate(collectionId, body) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/interactions/aggregate`;
+        return post(path, body);
+    }
+    interactions.aggregate = aggregate;
+    /**
+     * Legacy-friendly alias for aggregate().
+     */
+    async function aggregateByOutcome(collectionId, body) {
+        return aggregate(collectionId, body);
+    }
+    interactions.aggregateByOutcome = aggregateByOutcome;
     // Deprecated endpoint removed: actorIdsByInteraction
     /**
      * POST /admin/collection/:collectionId/interactions/append

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.8.9  |  Generated: 2026-03-19T15:02:36.521Z
+Version: 1.8.11  |  Generated: 2026-03-19T19:58:44.820Z
 
 This is a concise summary of all available API functions and types.
 
@@ -4401,6 +4401,52 @@ interface AdminInteractionsCountsByOutcomeRequest {
 }
 ```
 
+**AdminInteractionsAggregateRequest** (interface)
+```typescript
+interface AdminInteractionsAggregateRequest {
+  appId?: string
+  interactionId?: string
+  interactionIds?: string[]
+  scope?: string
+  outcome?: string | null
+  from?: string
+  to?: string
+  limit?: number
+  dedupeLatest?: boolean
+  groupBy: string
+  aggregate: {
+  field: string
+  ops: Array<'count' | 'sum' | 'avg' | 'min' | 'max'>
+  }
+}
+```
+
+**AdminInteractionsAggregateResponse** (interface)
+```typescript
+interface AdminInteractionsAggregateResponse {
+  groupBy: string
+  aggregate: {
+  field: string
+  ops: Array<'count' | 'sum' | 'avg' | 'min' | 'max'>
+  dedupeLatest?: boolean
+  }
+  rows: AdminInteractionsAggregateRow[]
+}
+```
+
+**AdminInteractionsAggregateRow** (interface)
+```typescript
+interface AdminInteractionsAggregateRow {
+  groupValue: string | null
+  eventCount: number
+  count?: number
+  sum?: number
+  avg?: number
+  min?: number
+  max?: number
+}
+```
+
 **PublicInteractionsCountsByOutcomeRequest** (interface)
 ```typescript
 interface PublicInteractionsCountsByOutcomeRequest {
@@ -6894,6 +6940,14 @@ POST /admin/collection/:collectionId/interactions/query Flexible query for inter
     query: AdminInteractionsCountsByOutcomeRequest = {}) → `Promise<OutcomeCount[]>`
 POST /admin/collection/:collectionId/interactions/counts-by-outcome Returns array of { outcome, count }.
 
+**aggregate**(collectionId: string,
+    body: AdminInteractionsAggregateRequest) → `Promise<AdminInteractionsAggregateResponse>`
+POST /admin/collection/:collectionId/interactions/aggregate Returns grouped numeric aggregates (sum, avg, min, max, count).
+
+**aggregateByOutcome**(collectionId: string,
+    body: AdminInteractionsAggregateRequest) → `Promise<AdminInteractionsAggregateResponse>`
+Legacy-friendly alias for aggregate().
+
 **appendEvent**(collectionId: string,
     body: AppendInteractionBody) → `Promise<`
 POST /admin/collection/:collectionId/interactions/append Appends one interaction event.

package/dist/docs/containers.md

@@ -302,15 +302,15 @@ See `widgets.md` for the full `NavigationRequest` documentation and additional e
 
 ## Architecture
 
-Containers use **MemoryRouter** (not HashRouter) because the parent app owns the browser's URL bar. Context is passed via props rather than URL parameters. Each container gets its own `QueryClient` to avoid cache collisions with the parent app.
+The framework wraps containers in a **MemoryRouter** (not HashRouter) because the parent app owns the browser's URL bar. Context is passed via props rather than URL parameters. Each container gets its own `QueryClient` to avoid cache collisions with the parent app.
 
 ```
 Parent App (owns URL bar, provides globals)
-  └── <PublicContainer>                    ← Container component
-        ├── QueryClientProvider (isolated)
-        ├── MemoryRouter (internal routing)
-        ├── LanguageProvider
-        └── PublicPage (+ all sub-routes)
+  └── MemoryRouter                         ← Framework provides this
+       └── <PublicContainer>               ← Container component (no Router!)
+             ├── QueryClientProvider (isolated)
+             ├── LanguageProvider
+             └── Routes/Route (internal navigation)
 ```
 
 ---
@@ -417,7 +417,7 @@ src/containers/
 1. Create your container component in `src/containers/MyContainer.tsx`
 2. Export it from `src/containers/index.ts`
 3. Add it to the `CONTAINER_MANIFEST` in `src/containers/index.ts`
-4. Ensure it uses `MemoryRouter` (not HashRouter)
+4. Ensure it does NOT include a Router wrapper (framework provides `MemoryRouter`)
 5. Give it its own `QueryClient` to avoid cache collisions
 
 ---
@@ -442,7 +442,7 @@ src/containers/
 | -------------------------- | ---------------------------------------- | ---------------------------------------------------- |
 | Container doesn't render   | Missing shared globals                   | Ensure all Shared Dependencies are on `window`       |
 | Styles don't apply         | Missing `containers.css`                 | Load the CSS file alongside the JS bundle            |
-| Routing doesn't work       | Using HashRouter instead of MemoryRouter | Containers must use MemoryRouter                     |
+| Routing doesn't work       | Container includes a Router wrapper      | Remove all Router wrappers (framework provides MemoryRouter) |
 | Query cache conflicts      | Sharing parent's QueryClient             | Each container needs its own `QueryClient` instance  |
 | `cva.cva` runtime error    | Global set to lowercase `cva`            | Use uppercase `CVA` for the global name              |
 | Navigation does nothing    | Using legacy string with `onNavigate`    | Use structured `NavigationRequest` object instead    |

package/dist/openapi.yaml

@@ -3382,6 +3382,39 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/CreateInteractionTypeBody"
+  /admin/collection/{collectionId}/interactions/aggregate:
+    post:
+      tags:
+        - interactions
+      summary: "POST /admin/collection/:collectionId/interactions/counts-by-outcome Returns array of { outcome, count }."
+      operationId: interactions_aggregate
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AdminInteractionsAggregateResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AdminInteractionsAggregateRequest"
   /admin/collection/{collectionId}/interactions/counts-by-outcome:
     post:
       tags:
@@ -15773,6 +15806,103 @@ components:
           type: boolean
         idField:
           $ref: "#/components/schemas/IdField"
+    AdminInteractionsAggregateRequest:
+      type: object
+      properties:
+        appId:
+          type: string
+        interactionId:
+          type: string
+        interactionIds:
+          type: array
+          items:
+            type: string
+        scope:
+          type: string
+        outcome:
+          type: string
+        from:
+          type: string
+        to:
+          type: string
+        limit:
+          type: number
+        dedupeLatest:
+          type: boolean
+        groupBy:
+          type: string
+        aggregate:
+          type: object
+          additionalProperties: true
+        field:
+          type: string
+        ops:
+          type: array
+          items:
+            type: string
+            enum:
+              - count
+              - sum
+              - avg
+              - min
+              - max
+      required:
+        - groupBy
+        - aggregate
+        - field
+        - ops
+    AdminInteractionsAggregateResponse:
+      type: object
+      properties:
+        groupBy:
+          type: string
+        aggregate:
+          type: object
+          additionalProperties: true
+        field:
+          type: string
+        ops:
+          type: array
+          items:
+            type: string
+            enum:
+              - count
+              - sum
+              - avg
+              - min
+              - max
+        dedupeLatest:
+          type: boolean
+        rows:
+          type: array
+          items:
+            $ref: "#/components/schemas/AdminInteractionsAggregateRow"
+      required:
+        - groupBy
+        - aggregate
+        - field
+        - ops
+        - rows
+    AdminInteractionsAggregateRow:
+      type: object
+      properties:
+        groupValue:
+          type: string
+        eventCount:
+          type: number
+        count:
+          type: number
+        sum:
+          type: number
+        avg:
+          type: number
+        min:
+          type: number
+        max:
+          type: number
+      required:
+        - groupValue
+        - eventCount
     PublicInteractionsCountsByOutcomeRequest:
       type: object
       properties:

package/dist/types/interaction.d.ts

@@ -26,6 +26,40 @@ export interface AdminInteractionsCountsByOutcomeRequest {
     dedupeLatest?: boolean;
     idField?: IdField;
 }
+export interface AdminInteractionsAggregateRequest {
+    appId?: string;
+    interactionId?: string;
+    interactionIds?: string[];
+    scope?: string;
+    outcome?: string | null;
+    from?: string;
+    to?: string;
+    limit?: number;
+    dedupeLatest?: boolean;
+    groupBy: string;
+    aggregate: {
+        field: string;
+        ops: Array<'count' | 'sum' | 'avg' | 'min' | 'max'>;
+    };
+}
+export interface AdminInteractionsAggregateResponse {
+    groupBy: string;
+    aggregate: {
+        field: string;
+        ops: Array<'count' | 'sum' | 'avg' | 'min' | 'max'>;
+        dedupeLatest?: boolean;
+    };
+    rows: AdminInteractionsAggregateRow[];
+}
+export interface AdminInteractionsAggregateRow {
+    groupValue: string | null;
+    eventCount: number;
+    count?: number;
+    sum?: number;
+    avg?: number;
+    min?: number;
+    max?: number;
+}
 export interface PublicInteractionsCountsByOutcomeRequest {
     appId: string;
     interactionId: string;

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.8.9  |  Generated: 2026-03-19T15:02:36.521Z
+Version: 1.8.11  |  Generated: 2026-03-19T19:58:44.820Z
 
 This is a concise summary of all available API functions and types.
 
@@ -4401,6 +4401,52 @@ interface AdminInteractionsCountsByOutcomeRequest {
 }
 ```
 
+**AdminInteractionsAggregateRequest** (interface)
+```typescript
+interface AdminInteractionsAggregateRequest {
+  appId?: string
+  interactionId?: string
+  interactionIds?: string[]
+  scope?: string
+  outcome?: string | null
+  from?: string
+  to?: string
+  limit?: number
+  dedupeLatest?: boolean
+  groupBy: string
+  aggregate: {
+  field: string
+  ops: Array<'count' | 'sum' | 'avg' | 'min' | 'max'>
+  }
+}
+```
+
+**AdminInteractionsAggregateResponse** (interface)
+```typescript
+interface AdminInteractionsAggregateResponse {
+  groupBy: string
+  aggregate: {
+  field: string
+  ops: Array<'count' | 'sum' | 'avg' | 'min' | 'max'>
+  dedupeLatest?: boolean
+  }
+  rows: AdminInteractionsAggregateRow[]
+}
+```
+
+**AdminInteractionsAggregateRow** (interface)
+```typescript
+interface AdminInteractionsAggregateRow {
+  groupValue: string | null
+  eventCount: number
+  count?: number
+  sum?: number
+  avg?: number
+  min?: number
+  max?: number
+}
+```
+
 **PublicInteractionsCountsByOutcomeRequest** (interface)
 ```typescript
 interface PublicInteractionsCountsByOutcomeRequest {
@@ -6894,6 +6940,14 @@ POST /admin/collection/:collectionId/interactions/query Flexible query for inter
     query: AdminInteractionsCountsByOutcomeRequest = {}) → `Promise<OutcomeCount[]>`
 POST /admin/collection/:collectionId/interactions/counts-by-outcome Returns array of { outcome, count }.
 
+**aggregate**(collectionId: string,
+    body: AdminInteractionsAggregateRequest) → `Promise<AdminInteractionsAggregateResponse>`
+POST /admin/collection/:collectionId/interactions/aggregate Returns grouped numeric aggregates (sum, avg, min, max, count).
+
+**aggregateByOutcome**(collectionId: string,
+    body: AdminInteractionsAggregateRequest) → `Promise<AdminInteractionsAggregateResponse>`
+Legacy-friendly alias for aggregate().
+
 **appendEvent**(collectionId: string,
     body: AppendInteractionBody) → `Promise<`
 POST /admin/collection/:collectionId/interactions/append Appends one interaction event.

package/docs/containers.md

@@ -302,15 +302,15 @@ See `widgets.md` for the full `NavigationRequest` documentation and additional e
 
 ## Architecture
 
-Containers use **MemoryRouter** (not HashRouter) because the parent app owns the browser's URL bar. Context is passed via props rather than URL parameters. Each container gets its own `QueryClient` to avoid cache collisions with the parent app.
+The framework wraps containers in a **MemoryRouter** (not HashRouter) because the parent app owns the browser's URL bar. Context is passed via props rather than URL parameters. Each container gets its own `QueryClient` to avoid cache collisions with the parent app.
 
 ```
 Parent App (owns URL bar, provides globals)
-  └── <PublicContainer>                    ← Container component
-        ├── QueryClientProvider (isolated)
-        ├── MemoryRouter (internal routing)
-        ├── LanguageProvider
-        └── PublicPage (+ all sub-routes)
+  └── MemoryRouter                         ← Framework provides this
+       └── <PublicContainer>               ← Container component (no Router!)
+             ├── QueryClientProvider (isolated)
+             ├── LanguageProvider
+             └── Routes/Route (internal navigation)
 ```
 
 ---
@@ -417,7 +417,7 @@ src/containers/
 1. Create your container component in `src/containers/MyContainer.tsx`
 2. Export it from `src/containers/index.ts`
 3. Add it to the `CONTAINER_MANIFEST` in `src/containers/index.ts`
-4. Ensure it uses `MemoryRouter` (not HashRouter)
+4. Ensure it does NOT include a Router wrapper (framework provides `MemoryRouter`)
 5. Give it its own `QueryClient` to avoid cache collisions
 
 ---
@@ -442,7 +442,7 @@ src/containers/
 | -------------------------- | ---------------------------------------- | ---------------------------------------------------- |
 | Container doesn't render   | Missing shared globals                   | Ensure all Shared Dependencies are on `window`       |
 | Styles don't apply         | Missing `containers.css`                 | Load the CSS file alongside the JS bundle            |
-| Routing doesn't work       | Using HashRouter instead of MemoryRouter | Containers must use MemoryRouter                     |
+| Routing doesn't work       | Container includes a Router wrapper      | Remove all Router wrappers (framework provides MemoryRouter) |
 | Query cache conflicts      | Sharing parent's QueryClient             | Each container needs its own `QueryClient` instance  |
 | `cva.cva` runtime error    | Global set to lowercase `cva`            | Use uppercase `CVA` for the global name              |
 | Navigation does nothing    | Using legacy string with `onNavigate`    | Use structured `NavigationRequest` object instead    |

package/openapi.yaml

@@ -3382,6 +3382,39 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/CreateInteractionTypeBody"
+  /admin/collection/{collectionId}/interactions/aggregate:
+    post:
+      tags:
+        - interactions
+      summary: "POST /admin/collection/:collectionId/interactions/counts-by-outcome Returns array of { outcome, count }."
+      operationId: interactions_aggregate
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AdminInteractionsAggregateResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AdminInteractionsAggregateRequest"
   /admin/collection/{collectionId}/interactions/counts-by-outcome:
     post:
       tags:
@@ -15773,6 +15806,103 @@ components:
           type: boolean
         idField:
           $ref: "#/components/schemas/IdField"
+    AdminInteractionsAggregateRequest:
+      type: object
+      properties:
+        appId:
+          type: string
+        interactionId:
+          type: string
+        interactionIds:
+          type: array
+          items:
+            type: string
+        scope:
+          type: string
+        outcome:
+          type: string
+        from:
+          type: string
+        to:
+          type: string
+        limit:
+          type: number
+        dedupeLatest:
+          type: boolean
+        groupBy:
+          type: string
+        aggregate:
+          type: object
+          additionalProperties: true
+        field:
+          type: string
+        ops:
+          type: array
+          items:
+            type: string
+            enum:
+              - count
+              - sum
+              - avg
+              - min
+              - max
+      required:
+        - groupBy
+        - aggregate
+        - field
+        - ops
+    AdminInteractionsAggregateResponse:
+      type: object
+      properties:
+        groupBy:
+          type: string
+        aggregate:
+          type: object
+          additionalProperties: true
+        field:
+          type: string
+        ops:
+          type: array
+          items:
+            type: string
+            enum:
+              - count
+              - sum
+              - avg
+              - min
+              - max
+        dedupeLatest:
+          type: boolean
+        rows:
+          type: array
+          items:
+            $ref: "#/components/schemas/AdminInteractionsAggregateRow"
+      required:
+        - groupBy
+        - aggregate
+        - field
+        - ops
+        - rows
+    AdminInteractionsAggregateRow:
+      type: object
+      properties:
+        groupValue:
+          type: string
+        eventCount:
+          type: number
+        count:
+          type: number
+        sum:
+          type: number
+        avg:
+          type: number
+        min:
+          type: number
+        max:
+          type: number
+      required:
+        - groupValue
+        - eventCount
     PublicInteractionsCountsByOutcomeRequest:
       type: object
       properties:

package/package.json

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