@proveanything/smartlinks 2.0.19 → 2.0.20

package/dist/api/functions.d.ts

@@ -0,0 +1,27 @@
+/** A server function's returned value — shape is app-defined, so untyped by default. */
+export type FunctionCallResult = any;
+export interface FunctionListEntry {
+    name: string;
+    visibility?: string;
+    trigger?: string;
+}
+export interface FunctionListResponse {
+    functions: FunctionListEntry[];
+}
+export declare namespace functions {
+    /**
+     * Call a PUBLIC app server function inline.
+     * `POST /public/collection/:collectionId/functions/:name` — surface `'public'`.
+     *
+     * @example
+     * const { value } = await SL.functions.call<{ value: number }>(collectionId, 'increment')
+     */
+    function call<T = FunctionCallResult>(collectionId: string, name: string, body?: Record<string, any>): Promise<T>;
+    /**
+     * Call an ADMIN app server function (surface `'admin'`; requires an admin session).
+     * `POST /admin/collection/:collectionId/functions/:name`.
+     */
+    function callAdmin<T = FunctionCallResult>(collectionId: string, name: string, body?: Record<string, any>): Promise<T>;
+    /** List the public functions available for a collection (discovery). `GET /public/collection/:c/functions`. */
+    function list(collectionId: string): Promise<FunctionListResponse>;
+}

package/dist/api/functions.js

@@ -0,0 +1,38 @@
+// Client-side invocation of app SERVER FUNCTIONS.
+//
+// The function itself is authored server-side (one contract: `async (ctx, event) => result`,
+// see docs/server-functions.md). THIS is how a page/UI actually calls one — the missing
+// client half. The PUBLIC route runs a function inline on the caller's own authority (owner if
+// signed in via authKit, else public); the ADMIN route runs on the admin surface (needs an admin
+// session). The returned value is the function's own result (`event.body` is what you pass here).
+import { post, request } from "../http.js";
+export var functions;
+(function (functions) {
+    /**
+     * Call a PUBLIC app server function inline.
+     * `POST /public/collection/:collectionId/functions/:name` — surface `'public'`.
+     *
+     * @example
+     * const { value } = await SL.functions.call<{ value: number }>(collectionId, 'increment')
+     */
+    async function call(collectionId, name, body = {}) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/functions/${encodeURIComponent(name)}`;
+        return post(path, body);
+    }
+    functions.call = call;
+    /**
+     * Call an ADMIN app server function (surface `'admin'`; requires an admin session).
+     * `POST /admin/collection/:collectionId/functions/:name`.
+     */
+    async function callAdmin(collectionId, name, body = {}) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/functions/${encodeURIComponent(name)}`;
+        return post(path, body);
+    }
+    functions.callAdmin = callAdmin;
+    /** List the public functions available for a collection (discovery). `GET /public/collection/:c/functions`. */
+    async function list(collectionId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/functions`;
+        return request(path);
+    }
+    functions.list = list;
+})(functions || (functions = {}));

package/dist/api/index.d.ts

@@ -28,6 +28,7 @@ export { qr } from "./qr.js";
 export { template } from "./template.js";
 export { interactions } from "./interactions.js";
 export { analytics } from "./analytics.js";
+export { functions } from "./functions.js";
 export { location } from "./location.js";
 export * as realtime from "./realtime.js";
 export { tags } from "./tags.js";

package/dist/api/index.js

@@ -30,6 +30,7 @@ export { qr } from "./qr.js";
 export { template } from "./template.js";
 export { interactions } from "./interactions.js";
 export { analytics } from "./analytics.js";
+export { functions } from "./functions.js";
 export { location } from "./location.js";
 import * as realtime_1 from "./realtime.js";
 export { realtime_1 as realtime };

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.19  |  Generated: 2026-09-24T19:51:28.993Z
+Version: 2.0.20  |  Generated: 2026-09-25T11:48:23.950Z
 
 This is a concise summary of all available API functions and types.
 
@@ -135,6 +135,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **config** - Functions for config operations
 - **containers** - Functions for containers operations
 - **facets** - Functions for facets operations
+- **functions** - Functions for functions operations
 - **http** - Functions for http operations
 - **integrations** - Functions for integrations operations
 - **jobs** - Functions for jobs operations
@@ -8943,6 +8944,24 @@ type VerifyTokenResponse = {
 }
 ```
 
+### functions (api)
+
+**FunctionListEntry** (interface)
+```typescript
+interface FunctionListEntry {
+  name: string; visibility?: string; trigger?: string
+}
+```
+
+**FunctionListResponse** (interface)
+```typescript
+interface FunctionListResponse {
+  functions: FunctionListEntry[]
+}
+```
+
+**FunctionCallResult** = `any`
+
 ### sequence (api)
 
 **AllocateSequenceInput** (interface)
@@ -10435,6 +10454,21 @@ Update a form for a collection (admin only).
 **remove**(collectionId: string, formId: string) → `Promise<void>`
 Delete a form for a collection (admin only).
 
+### functions
+
+**call**(collectionId: string,
+    name: string,
+    body: Record<string, any> = {}) → `Promise<T>`
+Call a PUBLIC app server function inline. `POST /public/collection/:collectionId/functions/:name` — surface `'public'`. const { value } = await SL.functions.call<{ value: number }>(collectionId, 'increment')
+
+**callAdmin**(collectionId: string,
+    name: string,
+    body: Record<string, any> = {}) → `Promise<T>`
+Call an ADMIN app server function (surface `'admin'`; requires an admin session). `POST /admin/collection/:collectionId/functions/:name`.
+
+**list**(collectionId: string) → `Promise<FunctionListResponse>`
+List the public functions available for a collection (discovery). `GET /public/collection/:c/functions`.
+
 ### http
 
 **get**(path: string) → `Promise<T>`

package/dist/openapi.yaml

@@ -72,6 +72,8 @@ tags:
     description: Product facet querying and aggregation.
   - name: form
     description: Form definitions and submissions.
+  - name: functions
+    description: functions API
   - name: integrations
     description: Third-party integration flows and imports.
   - name: interactions
@@ -12150,6 +12152,32 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/functions:
+    get:
+      tags:
+        - functions
+      summary: List the public functions available for a collection (discovery).
+      operationId: functions_list
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/FunctionListResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /public/collection/{collectionId}/interactions:
     get:
       tags:
@@ -29269,6 +29297,23 @@ components:
           additionalProperties: true
       required:
         - valid
+    FunctionListEntry:
+      type: object
+      properties:
+        name:
+          type: object
+          additionalProperties: true
+      required:
+        - name
+    FunctionListResponse:
+      type: object
+      properties:
+        functions:
+          type: array
+          items:
+            $ref: "#/components/schemas/FunctionListEntry"
+      required:
+        - functions
     AllocateSequenceInput:
       type: object
       properties:

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.19  |  Generated: 2026-09-24T19:51:28.993Z
+Version: 2.0.20  |  Generated: 2026-09-25T11:48:23.950Z
 
 This is a concise summary of all available API functions and types.
 
@@ -135,6 +135,7 @@ The Smartlinks SDK is organized into the following namespaces:
 - **config** - Functions for config operations
 - **containers** - Functions for containers operations
 - **facets** - Functions for facets operations
+- **functions** - Functions for functions operations
 - **http** - Functions for http operations
 - **integrations** - Functions for integrations operations
 - **jobs** - Functions for jobs operations
@@ -8943,6 +8944,24 @@ type VerifyTokenResponse = {
 }
 ```
 
+### functions (api)
+
+**FunctionListEntry** (interface)
+```typescript
+interface FunctionListEntry {
+  name: string; visibility?: string; trigger?: string
+}
+```
+
+**FunctionListResponse** (interface)
+```typescript
+interface FunctionListResponse {
+  functions: FunctionListEntry[]
+}
+```
+
+**FunctionCallResult** = `any`
+
 ### sequence (api)
 
 **AllocateSequenceInput** (interface)
@@ -10435,6 +10454,21 @@ Update a form for a collection (admin only).
 **remove**(collectionId: string, formId: string) → `Promise<void>`
 Delete a form for a collection (admin only).
 
+### functions
+
+**call**(collectionId: string,
+    name: string,
+    body: Record<string, any> = {}) → `Promise<T>`
+Call a PUBLIC app server function inline. `POST /public/collection/:collectionId/functions/:name` — surface `'public'`. const { value } = await SL.functions.call<{ value: number }>(collectionId, 'increment')
+
+**callAdmin**(collectionId: string,
+    name: string,
+    body: Record<string, any> = {}) → `Promise<T>`
+Call an ADMIN app server function (surface `'admin'`; requires an admin session). `POST /admin/collection/:collectionId/functions/:name`.
+
+**list**(collectionId: string) → `Promise<FunctionListResponse>`
+List the public functions available for a collection (discovery). `GET /public/collection/:c/functions`.
+
 ### http
 
 **get**(path: string) → `Promise<T>`

package/openapi.yaml

@@ -72,6 +72,8 @@ tags:
     description: Product facet querying and aggregation.
   - name: form
     description: Form definitions and submissions.
+  - name: functions
+    description: functions API
   - name: integrations
     description: Third-party integration flows and imports.
   - name: interactions
@@ -12150,6 +12152,32 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/functions:
+    get:
+      tags:
+        - functions
+      summary: List the public functions available for a collection (discovery).
+      operationId: functions_list
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/FunctionListResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /public/collection/{collectionId}/interactions:
     get:
       tags:
@@ -29269,6 +29297,23 @@ components:
           additionalProperties: true
       required:
         - valid
+    FunctionListEntry:
+      type: object
+      properties:
+        name:
+          type: object
+          additionalProperties: true
+      required:
+        - name
+    FunctionListResponse:
+      type: object
+      properties:
+        functions:
+          type: array
+          items:
+            $ref: "#/components/schemas/FunctionListEntry"
+      required:
+        - functions
     AllocateSequenceInput:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.19",
+  "version": "2.0.20",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",