@proveanything/smartlinks 1.9.15 → 1.9.17

package/dist/api/authKit.js

@@ -25,12 +25,12 @@ export var authKit;
     authKit.googleLogin = googleLogin;
     /** Send a magic link email to the user (public). */
     async function sendMagicLink(clientId, data) {
-        return post(`/authkit/${encodeURIComponent(clientId)}/magic-link/send`, data);
+        return post(`/authkit/${encodeURIComponent(clientId)}/auth/magic-link/send`, data);
     }
     authKit.sendMagicLink = sendMagicLink;
     /** Verify a magic link token and authenticate/create the user (public). */
     async function verifyMagicLink(clientId, token) {
-        const res = await post(`/authkit/${encodeURIComponent(clientId)}/magic-link/verify`, { token });
+        const res = await post(`/authkit/${encodeURIComponent(clientId)}/auth/magic-link/verify`, { token });
         if (res.token)
             setBearerToken(res.token);
         return res;

package/dist/api/http.d.ts

@@ -0,0 +1,56 @@
+export declare namespace http {
+    /**
+     * Perform a GET request to any API endpoint.
+     *
+     * @param path - Path after the base URL, e.g. `'/public/config/fields'`
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     *
+     * @example
+     * const fields = await http.get<FieldDefinition[]>('/public/config/fields')
+     */
+    function get<T>(path: string): Promise<T>;
+    /**
+     * Perform a POST request to any API endpoint.
+     *
+     * @param path  - Path after the base URL, e.g. `'/public/app/eticket/uploadTickets'`
+     * @param body  - Request body (serialized to JSON, or sent as-is for FormData)
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     *
+     * @example
+     * const result = await http.post('/public/app/eticket/uploadTickets', {
+     *   collectionId,
+     *   productId,
+     *   appId,
+     *   data,
+     * })
+     */
+    function post<T>(path: string, body: any): Promise<T>;
+    /**
+     * Perform a PUT request to any API endpoint.
+     *
+     * @param path - Path after the base URL
+     * @param body - Request body (serialized to JSON, or sent as-is for FormData)
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     */
+    function put<T>(path: string, body: any): Promise<T>;
+    /**
+     * Perform a PATCH request to any API endpoint.
+     *
+     * @param path - Path after the base URL
+     * @param body - Partial request body (serialized to JSON)
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     */
+    function patch<T>(path: string, body: any): Promise<T>;
+    /**
+     * Perform a DELETE request to any API endpoint.
+     *
+     * @param path - Path after the base URL
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     */
+    function del<T>(path: string): Promise<T>;
+}

package/dist/api/http.js

@@ -0,0 +1,101 @@
+// src/api/http.ts
+// Escape-hatch namespace for calling arbitrary API endpoints that are not yet
+// covered by a dedicated SDK namespace.
+//
+// Paths are relative to the base URL configured via initializeApi() — which
+// already includes "/api/v1".  You only need to supply the path segment that
+// comes *after* that prefix:
+//
+//   ✅  http.post('/public/app/eticket/uploadTickets', { ... })
+//   ✅  http.get('/admin/collection/abc123/customReport')
+//   ❌  http.post('/api/v1/public/...')  — do NOT repeat the prefix
+//
+// All methods use the same auth headers (API key / bearer token), proxy mode,
+// and caching behaviour as every other SDK namespace.  Errors are thrown as
+// SmartlinksApiError — catch them the same way you would for any SDK call.
+//
+// Example — calling a custom app endpoint:
+//
+//   import { http } from '@smartlinks/sdk'
+//
+//   const result = await http.post<{ uploaded: number }>(
+//     '/public/app/eticket/uploadTickets',
+//     { collectionId, productId, appId, data }
+//   )
+import { request as _get, post as _post, put as _put, patch as _patch, del as _del, } from '../http';
+/** Ensure the path always starts with `/` so it concatenates correctly with baseURL. */
+function normalizePath(path) {
+    return path.startsWith('/') ? path : `/${path}`;
+}
+export var http;
+(function (http) {
+    /**
+     * Perform a GET request to any API endpoint.
+     *
+     * @param path - Path after the base URL, e.g. `'/public/config/fields'`
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     *
+     * @example
+     * const fields = await http.get<FieldDefinition[]>('/public/config/fields')
+     */
+    async function get(path) {
+        return _get(normalizePath(path));
+    }
+    http.get = get;
+    /**
+     * Perform a POST request to any API endpoint.
+     *
+     * @param path  - Path after the base URL, e.g. `'/public/app/eticket/uploadTickets'`
+     * @param body  - Request body (serialized to JSON, or sent as-is for FormData)
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     *
+     * @example
+     * const result = await http.post('/public/app/eticket/uploadTickets', {
+     *   collectionId,
+     *   productId,
+     *   appId,
+     *   data,
+     * })
+     */
+    async function post(path, body) {
+        return _post(normalizePath(path), body);
+    }
+    http.post = post;
+    /**
+     * Perform a PUT request to any API endpoint.
+     *
+     * @param path - Path after the base URL
+     * @param body - Request body (serialized to JSON, or sent as-is for FormData)
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     */
+    async function put(path, body) {
+        return _put(normalizePath(path), body);
+    }
+    http.put = put;
+    /**
+     * Perform a PATCH request to any API endpoint.
+     *
+     * @param path - Path after the base URL
+     * @param body - Partial request body (serialized to JSON)
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     */
+    async function patch(path, body) {
+        return _patch(normalizePath(path), body);
+    }
+    http.patch = patch;
+    /**
+     * Perform a DELETE request to any API endpoint.
+     *
+     * @param path - Path after the base URL
+     * @returns Parsed JSON response body typed as `T`
+     * @throws {SmartlinksApiError} on non-2xx responses
+     */
+    async function del(path) {
+        return _del(normalizePath(path));
+    }
+    http.del = del;
+})(http || (http = {}));

package/dist/api/index.d.ts

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

package/dist/api/index.js

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

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.9.15  |  Generated: 2026-04-13T12:48:02.968Z
+Version: 1.9.17  |  Generated: 2026-04-15T16:54:07.573Z
 
 This is a concise summary of all available API functions and types.
 
@@ -106,6 +106,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
+- **http** - Functions for http operations
 - **jobs** - Functions for jobs operations
 - **journeysAnalytics** - Functions for journeysAnalytics operations
 - **location** - Functions for location operations
@@ -7929,6 +7930,23 @@ Update a form for a collection (admin only).
 **remove**(collectionId: string, formId: string) → `Promise<void>`
 Delete a form for a collection (admin only).
 
+### http
+
+**get**(path: string) → `Promise<T>`
+Perform a GET request to any API endpoint. const fields = await http.get<FieldDefinition[]>('/public/config/fields')
+
+**post**(path: string, body: any) → `Promise<T>`
+Perform a POST request to any API endpoint. const result = await http.post('/public/app/eticket/uploadTickets', { collectionId, productId, appId, data, })
+
+**put**(path: string, body: any) → `Promise<T>`
+Perform a PUT request to any API endpoint.
+
+**patch**(path: string, body: any) → `Promise<T>`
+Perform a PATCH request to any API endpoint.
+
+**del**(path: string) → `Promise<T>`
+Perform a DELETE request to any API endpoint.
+
 ### interactions
 
 **query**(collectionId: string,

package/dist/openapi.yaml

@@ -8380,6 +8380,65 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /authkit/{clientId}/auth/magic-link/send:
+    post:
+      tags:
+        - authKit
+      summary: Login with email + password (public).
+      operationId: authKit_sendMagicLink
+      security: []
+      parameters:
+        - name: clientId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MagicLinkSendResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: true
+  /authkit/{clientId}/auth/magic-link/verify:
+    post:
+      tags:
+        - authKit
+      summary: Google OAuth login (public).
+      operationId: authKit_verifyMagicLink
+      security: []
+      parameters:
+        - name: clientId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MagicLinkVerifyResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /authkit/{clientId}/auth/phone/send-code:
     post:
       tags:
@@ -8616,65 +8675,6 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /authkit/{clientId}/magic-link/send:
-    post:
-      tags:
-        - authKit
-      summary: Login with email + password (public).
-      operationId: authKit_sendMagicLink
-      security: []
-      parameters:
-        - name: clientId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MagicLinkSendResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              additionalProperties: true
-  /authkit/{clientId}/magic-link/verify:
-    post:
-      tags:
-        - authKit
-      summary: Google OAuth login (public).
-      operationId: authKit_verifyMagicLink
-      security: []
-      parameters:
-        - name: clientId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MagicLinkVerifyResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /platform/location:
     post:
       tags:

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.9.15  |  Generated: 2026-04-13T12:48:02.968Z
+Version: 1.9.17  |  Generated: 2026-04-15T16:54:07.573Z
 
 This is a concise summary of all available API functions and types.
 
@@ -106,6 +106,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
+- **http** - Functions for http operations
 - **jobs** - Functions for jobs operations
 - **journeysAnalytics** - Functions for journeysAnalytics operations
 - **location** - Functions for location operations
@@ -7929,6 +7930,23 @@ Update a form for a collection (admin only).
 **remove**(collectionId: string, formId: string) → `Promise<void>`
 Delete a form for a collection (admin only).
 
+### http
+
+**get**(path: string) → `Promise<T>`
+Perform a GET request to any API endpoint. const fields = await http.get<FieldDefinition[]>('/public/config/fields')
+
+**post**(path: string, body: any) → `Promise<T>`
+Perform a POST request to any API endpoint. const result = await http.post('/public/app/eticket/uploadTickets', { collectionId, productId, appId, data, })
+
+**put**(path: string, body: any) → `Promise<T>`
+Perform a PUT request to any API endpoint.
+
+**patch**(path: string, body: any) → `Promise<T>`
+Perform a PATCH request to any API endpoint.
+
+**del**(path: string) → `Promise<T>`
+Perform a DELETE request to any API endpoint.
+
 ### interactions
 
 **query**(collectionId: string,

package/openapi.yaml

@@ -8380,6 +8380,65 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /authkit/{clientId}/auth/magic-link/send:
+    post:
+      tags:
+        - authKit
+      summary: Login with email + password (public).
+      operationId: authKit_sendMagicLink
+      security: []
+      parameters:
+        - name: clientId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MagicLinkSendResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: true
+  /authkit/{clientId}/auth/magic-link/verify:
+    post:
+      tags:
+        - authKit
+      summary: Google OAuth login (public).
+      operationId: authKit_verifyMagicLink
+      security: []
+      parameters:
+        - name: clientId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MagicLinkVerifyResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /authkit/{clientId}/auth/phone/send-code:
     post:
       tags:
@@ -8616,65 +8675,6 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /authkit/{clientId}/magic-link/send:
-    post:
-      tags:
-        - authKit
-      summary: Login with email + password (public).
-      operationId: authKit_sendMagicLink
-      security: []
-      parameters:
-        - name: clientId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MagicLinkSendResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              additionalProperties: true
-  /authkit/{clientId}/magic-link/verify:
-    post:
-      tags:
-        - authKit
-      summary: Google OAuth login (public).
-      operationId: authKit_verifyMagicLink
-      security: []
-      parameters:
-        - name: clientId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/MagicLinkVerifyResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /platform/location:
     post:
       tags:

package/package.json

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