@proveanything/smartlinks 1.0.38 → 1.0.40

package/dist/api/auth.d.ts

@@ -1,3 +1,4 @@
+import type { UserAccountRegistrationRequest } from "../types/auth";
 export type LoginResponse = {
     id: string;
     name: string;
@@ -70,6 +71,10 @@ export declare namespace auth {
      * Validates if the user has access to the resource, and returns a JWT
      */
     function requestPublicJWT(collectionId: string, productId: string, proofId: string): Promise<string>;
+    /**
+     * Tries to register a new user account. Can return a bearer token, or a Firebase token
+     */
+    function registerUser(user: UserAccountRegistrationRequest): Promise<LoginResponse>;
     /**
      * Admin: Get a user bearer token (impersonation/automation).
      * POST /admin/auth/userToken

package/dist/api/auth.js

@@ -60,6 +60,17 @@ export var auth;
         return post("/public/auth/requestJWT", { collectionId, productId, proofId });
     }
     auth.requestPublicJWT = requestPublicJWT;
+    /**
+     * Tries to register a new user account. Can return a bearer token, or a Firebase token
+     */
+    async function registerUser(user) {
+        // Use the provided token, or the one from getApiHeaders
+        const res = await post("/public/auth/register", user);
+        if (res.bearerToken)
+            setBearerToken(res.bearerToken);
+        return res;
+    }
+    auth.registerUser = registerUser;
     /**
      * Admin: Get a user bearer token (impersonation/automation).
      * POST /admin/auth/userToken

package/dist/api/claimSet.d.ts

@@ -1,3 +1,4 @@
+import { UpdateClaimDataRequest, AssignClaimsRequest } from "../types";
 export declare namespace claimSet {
     /**
      * Get all claim sets for a collection.
@@ -71,12 +72,22 @@ export declare namespace claimSet {
      * Assign claims to a claim set.
      * @param collectionId – The collection identifier
      * @param data – The claims data to assign
+     *  {
+     *    id: string,          // claim set id (required)
+     *    collectionId: string,// required
+     *    productId: string,   // required
+     *    batchId?: string,    // optional
+     *    start?: number,      // optional bulk range start
+     *    end?: number,        // optional bulk range end
+     *    codeId?: string,     // optional single code
+     *    data?: { [k: string]: any } // optional claim key/values
+     *  }
      */
-    function assignClaims(collectionId: string, data: any): Promise<any>;
+    function assignClaims(collectionId: string, data: AssignClaimsRequest): Promise<any>;
     /**
      * Update claim data for a collection.
      * @param collectionId – The collection identifier
      * @param data – The claim data to update
      */
-    function updateClaimData(collectionId: string, data: any): Promise<any>;
+    function updateClaimData(collectionId: string, data: UpdateClaimDataRequest): Promise<any>;
 }

package/dist/api/claimSet.js

@@ -113,6 +113,16 @@ export var claimSet;
      * Assign claims to a claim set.
      * @param collectionId – The collection identifier
      * @param data – The claims data to assign
+     *  {
+     *    id: string,          // claim set id (required)
+     *    collectionId: string,// required
+     *    productId: string,   // required
+     *    batchId?: string,    // optional
+     *    start?: number,      // optional bulk range start
+     *    end?: number,        // optional bulk range end
+     *    codeId?: string,     // optional single code
+     *    data?: { [k: string]: any } // optional claim key/values
+     *  }
      */
     async function assignClaims(collectionId, data) {
         const path = `/admin/collection/${encodeURIComponent(collectionId)}/claimSet/${encodeURIComponent(data.id)}/assignClaims`;

package/dist/api/collection.d.ts

@@ -15,6 +15,19 @@ export declare namespace collection {
      * @throws ErrorResponse if the request fails
      */
     function list(admin?: boolean): Promise<CollectionResponse[]>;
+    /**
+     * Retrieve a collection by its shortId (public endpoint).
+     * @param shortId – The short identifier of the collection
+     * @returns Promise resolving to a CollectionResponse object
+     */
+    function getShortId(shortId: string): Promise<CollectionResponse>;
+    /**
+     * Retrieve a specific settings group for a collection (public endpoint).
+     * @param collectionId – Identifier of the collection
+     * @param settingGroup – The settings group name
+     * @returns Promise resolving to the settings object
+     */
+    function getSettings(collectionId: string, settingGroup: string): Promise<any>;
     /**
      * Create a new collection (admin only).
      * @param data – Collection creation data

package/dist/api/collection.js

@@ -27,6 +27,27 @@ export var collection;
         return request(path);
     }
     collection.list = list;
+    /**
+     * Retrieve a collection by its shortId (public endpoint).
+     * @param shortId – The short identifier of the collection
+     * @returns Promise resolving to a CollectionResponse object
+     */
+    async function getShortId(shortId) {
+        const path = `/public/collection/getShortId/${encodeURIComponent(shortId)}`;
+        return request(path);
+    }
+    collection.getShortId = getShortId;
+    /**
+     * Retrieve a specific settings group for a collection (public endpoint).
+     * @param collectionId – Identifier of the collection
+     * @param settingGroup – The settings group name
+     * @returns Promise resolving to the settings object
+     */
+    async function getSettings(collectionId, settingGroup) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/settings/${encodeURIComponent(settingGroup)}`;
+        return request(path);
+    }
+    collection.getSettings = getSettings;
     /**
      * Create a new collection (admin only).
      * @param data – Collection creation data

package/dist/api/proof.d.ts

@@ -19,6 +19,11 @@ export declare namespace proof {
      * PUT /admin/collection/:collectionId/product/:productId/proof/:proofId
      */
     function update(collectionId: string, productId: string, proofId: string, values: any): Promise<ProofResponse>;
+    /**
+     * Claim a proof for a product.
+     * PUT /public/collection/:collectionId/product/:productId/proof/:proofId
+     */
+    function claim(collectionId: string, productId: string, proofId: string, values: any): Promise<ProofResponse>;
     /**
      * Delete a proof for a product (admin only).
      * DELETE /admin/collection/:collectionId/product/:productId/proof/:proofId

package/dist/api/proof.js

@@ -39,6 +39,15 @@ export var proof;
         return put(path, values);
     }
     proof.update = update;
+    /**
+     * Claim a proof for a product.
+     * PUT /public/collection/:collectionId/product/:productId/proof/:proofId
+     */
+    async function claim(collectionId, productId, proofId, values) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}`;
+        return put(path, values);
+    }
+    proof.claim = claim;
     /**
      * Delete a proof for a product (admin only).
      * DELETE /admin/collection/:collectionId/product/:productId/proof/:proofId

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { initializeApi, request, sendCustomProxyMessage } from "./http";
 export * from "./api";
 export * from "./types";
 export type { LoginResponse, VerifyTokenResponse, AccountInfoResponse, } from "./api/auth";
+export type { UserAccountRegistrationRequest, } from "./types/auth";
 export type { AttestationResponse, AttestationCreateRequest, AttestationUpdateRequest, } from "./types/attestation";
 export type { BatchResponse, BatchCreateRequest, BatchUpdateRequest, } from "./types/batch";
 export type { VariantResponse, VariantCreateRequest, VariantUpdateRequest, } from "./types/variant";

package/dist/types/auth.d.ts

@@ -0,0 +1,9 @@
+export type UserAccountRegistrationRequest = {
+    name: string;
+    email?: string;
+    phone?: string;
+    password?: string;
+    sendAccountConfirmation?: boolean;
+    collectionId?: string;
+    tokenType?: 'bearer' | 'firebase';
+};

package/dist/types/auth.js

@@ -0,0 +1,3 @@
+// src/types/auth.ts
+// Auth-related request/response type shapes used by the SDK.
+export {};

package/dist/types/claimSet.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Reference to a specific claim attached to a code/tag.
+ */
+export interface ClaimCodeRef {
+    /** Identifier of the code (e.g., tag or QR code) */
+    codeId: string;
+    /** Identifier of the claim within the claim set */
+    claimId: string;
+}
+/**
+ * Request body for updating claim data on a claim set.
+ * Contains arbitrary key/value pairs and a list of code+claim references to update.
+ */
+export interface UpdateClaimDataRequest {
+    /** Arbitrary key/value pairs for the claim data update */
+    data: Record<string, any>;
+    /** Array of code+claim references affected by this update */
+    codes: ClaimCodeRef[];
+}
+/**
+ * Request body for assigning claims to codes or ranges within a collection.
+ */
+export interface AssignClaimsRequest {
+    /** The claim set ID (required) */
+    id: string;
+    /** The collection ID (required) */
+    collectionId: string;
+    /** The product ID (required) */
+    productId: string;
+    /** Optional batch identifier */
+    batchId?: string;
+    /** Optional start index for bulk assignment */
+    start?: number;
+    /** Optional end index for bulk assignment */
+    end?: number;
+    /** Optional single code identifier for single assignment */
+    codeId?: string;
+    /** Optional key/value pairs to set on the claim */
+    data?: Record<string, any>;
+}

package/dist/types/claimSet.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -6,3 +6,5 @@ export * from "./error";
 export * from "./asset";
 export * from "./batch";
 export * from "./variant";
+export * from "./claimSet";
+export * from "./auth";

package/dist/types/index.js

@@ -8,3 +8,5 @@ export * from "./error";
 export * from "./asset";
 export * from "./batch";
 export * from "./variant";
+export * from "./claimSet";
+export * from "./auth";

package/package.json

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