@proveanything/smartlinks 2.1.15 → 2.1.16

package/dist/api/claimSet.d.ts

@@ -1,4 +1,4 @@
-import { ClaimSetScope, ClaimSetRange, CreateClaimSetRangeRequest, UpdateClaimSetRangeRequest, ClaimSetRangeTagsPage, ClaimSetRangeTag, ClaimSetRangeNextTag, ImportClaimSetRangeUidsRequest, ImportClaimSetRangeUidsResponse, AssignClaimSetRangeRequest, AssignClaimSetRangeResponse, ClaimSetRangeFile, UpdateClaimDataRequest, AssignClaimsRequest, CreateClaimSetTagRequest, CreateClaimSetTagResponse, CreateClaimSetRequest, ImportClaimSetTagsRequest, ImportClaimSetTagsResponse } from "../types/index.js";
+import { ClaimSetScope, ClaimSetRange, CreateClaimSetRangeRequest, UpdateClaimSetRangeRequest, ClaimSetRangeTagsPage, ClaimSetRangeTag, ClaimSetRangeNextTag, ImportClaimSetRangeUidsRequest, ImportClaimSetRangeUidsResponse, AssignClaimSetRangeRequest, AddClaimSetRangeMemberRequest, AddClaimSetRangeMemberResponse, CloseClaimSetRangeResponse, AssignClaimSetRangeResponse, ClaimSetRangeFile, UpdateClaimDataRequest, AssignClaimsRequest, CreateClaimSetTagRequest, CreateClaimSetTagResponse, CreateClaimSetRequest, ImportClaimSetTagsRequest, ImportClaimSetTagsResponse } from "../types/index.js";
 export declare namespace claimSet {
     /**
      * Get all claim sets.
@@ -106,6 +106,14 @@ export declare namespace claimSet {
         function update(scope: ClaimSetScope, claimSetId: string, rangeId: string, params: UpdateClaimSetRangeRequest): Promise<ClaimSetRange>;
         /** Finish minting a range that was interrupted. */
         function resume(scope: ClaimSetScope, claimSetId: string, rangeId: string): Promise<ClaimSetRange>;
+        /** Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted). */
+        function close(scope: ClaimSetScope, claimSetId: string, rangeId: string): Promise<CloseClaimSetRangeResponse>;
+        /** Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given. */
+        function addMember(scope: ClaimSetScope, claimSetId: string, groupId: string, params: AddClaimSetRangeMemberRequest): Promise<AddClaimSetRangeMemberResponse>;
+        /** Take a tag out of a group. Its assignment is left as it is. */
+        function removeMember(scope: ClaimSetScope, claimSetId: string, groupId: string, code: string): Promise<{
+            range: ClaimSetRange;
+        }>;
         /** The range's tags in index order, a page at a time (keys: owners/admins only). */
         function tags(scope: ClaimSetScope, claimSetId: string, rangeId: string, options?: {
             from?: number;

package/dist/api/claimSet.js

@@ -190,6 +190,21 @@ export var claimSet;
             return post(`${rangesBase(scope, claimSetId)}/${encodeURIComponent(rangeId)}/resume`, {});
         }
         ranges.resume = resume;
+        /** Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted). */
+        async function close(scope, claimSetId, rangeId) {
+            return post(`${rangesBase(scope, claimSetId)}/${encodeURIComponent(rangeId)}/close`, {});
+        }
+        ranges.close = close;
+        /** Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given. */
+        async function addMember(scope, claimSetId, groupId, params) {
+            return post(`${rangesBase(scope, claimSetId)}/${encodeURIComponent(groupId)}/members`, params);
+        }
+        ranges.addMember = addMember;
+        /** Take a tag out of a group. Its assignment is left as it is. */
+        async function removeMember(scope, claimSetId, groupId, code) {
+            return del(`${rangesBase(scope, claimSetId)}/${encodeURIComponent(groupId)}/members/${encodeURIComponent(code)}`);
+        }
+        ranges.removeMember = removeMember;
         /** The range's tags in index order, a page at a time (keys: owners/admins only). */
         async function tags(scope, claimSetId, rangeId, options = {}) {
             const q = new URLSearchParams();

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.1.15  |  Generated: 2026-11-09T15:17:42.472Z
+Version: 2.1.16  |  Generated: 2026-11-10T17:19:48.505Z
 
 This is a concise summary of all available API functions and types.
 
@@ -5775,10 +5775,11 @@ interface ClaimSetRange {
   id: string
   claimSetId: string
   namespace: string
+  kind: ClaimSetRangeKind
   name: string
   notes: string | null
-  startIndex: number
-  endIndex: number
+  startIndex: number | null
+  endIndex: number | null
   quantity: number
   tagType: ClaimSetTagType
   fulfilment: 'printer' | 'sidekick'
@@ -5801,8 +5802,9 @@ interface ClaimSetRange {
 **CreateClaimSetRangeRequest** (interface)
 ```typescript
 interface CreateClaimSetRangeRequest {
+  kind?: ClaimSetRangeKind
   name: string
-  quantity: number
+  quantity?: number
   intendedCollectionId?: string
   intendedProductId?: string
   intendedBatchId?: string
@@ -5837,6 +5839,8 @@ interface ClaimSetRangeTag {
   productId: string | null
   batchId: string | null
   proofId: string | null
+  rangeId: string | null
+  groupId: string | null
   programmedAt: string | null
   scans: number
 }
@@ -5850,6 +5854,29 @@ interface ClaimSetRangeTagsPage {
 }
 ```
 
+**AddClaimSetRangeMemberRequest** (interface)
+```typescript
+interface AddClaimSetRangeMemberRequest {
+  code?: string
+  uid?: string
+  collectionId?: string
+  productId?: string
+  batchId?: string
+  data?: Record<string, unknown>
+  clear?: boolean
+}
+```
+
+**AddClaimSetRangeMemberResponse** (interface)
+```typescript
+interface AddClaimSetRangeMemberResponse {
+  tag: ClaimSetRangeTag
+  range: ClaimSetRange
+  assigned: { changed: number; skipped: Array<{ code: string; index: number | null; reason: 'other_range' | 'has_proof' | 'assigned_elsewhere'; collectionId?: string }> }
+  movedFrom: string | null
+}
+```
+
 **ImportClaimSetRangeUidsRequest** (interface)
 ```typescript
 interface ImportClaimSetRangeUidsRequest {
@@ -5958,7 +5985,11 @@ type ClaimSetScope = { collectionId: string }
 
 **ClaimSetTagType** = `'ntag424' | 'ntag21x' | 'qr'`
 
-**ClaimSetRangeStatus** = `'minting' | 'minted' | 'sent' | 'received' | 'assigned'`
+**ClaimSetRangeKind** = `'range' | 'open' | 'group'`
+
+**ClaimSetRangeStatus** = `'minting' | 'minted' | 'sent' | 'received' | 'assigned' | 'open' | 'group'`
+
+**CloseClaimSetRangeResponse** = `ClaimSetRange | { id: string`
 
 **ClaimSetImportResult** = ``
 
@@ -12464,6 +12495,15 @@ Name, notes, order details, or a stage move (sent to the printer, received).
 **resume**(scope: ClaimSetScope, claimSetId: string, rangeId: string) → `Promise<ClaimSetRange>`
 Finish minting a range that was interrupted.
 
+**close**(scope: ClaimSetScope, claimSetId: string, rangeId: string) → `Promise<CloseClaimSetRangeResponse>`
+Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted).
+
+**addMember**(scope: ClaimSetScope, claimSetId: string, groupId: string, params: AddClaimSetRangeMemberRequest) → `Promise<AddClaimSetRangeMemberResponse>`
+Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given.
+
+**removeMember**(scope: ClaimSetScope, claimSetId: string, groupId: string, code: string) → `Promise<`
+Take a tag out of a group. Its assignment is left as it is.
+
 **tags**(scope: ClaimSetScope, claimSetId: string, rangeId: string,
       options: { from?: number; limit?: number; keys?: boolean } = {}) → `Promise<ClaimSetRangeTagsPage>`
 The range's tags in index order, a page at a time (keys: owners/admins only).

package/dist/docs/tag-ranges.md

@@ -55,6 +55,27 @@ tag without a chip, with its URL and key; write it, then `ranges.recordTag(scope
 
 To find where a chip or code went, `partner.lookupTags(partner.id, { uid })` or `{ code }` searches every set the partner owns and returns each hit's set, tag and range, never a key.
 
+## Open ranges and groups
+
+A range's count is fixed when it is minted. Two phone-side jobs don't know their count in advance, so a range
+has a `kind`:
+
+- **`open`**: blank tags programmed on Sidekick one at a time. `ranges.create(scope, set.id, { kind: 'open', name })`
+  reserves only a start index; each `ranges.next()` hands back a free minted code or mints one more, so
+  `quantity`/`endIndex` grow as tags are written (`remaining` is null). One open range per set, and nothing can
+  be minted behind it (`409 RANGE_OPEN`) until `ranges.close(scope, set.id, range.id)` turns it into an ordinary
+  range (an open range that minted nothing is removed instead).
+- **`group`**: tags that already exist, added by tapping, assigned by hand, and moved together later. Assigners may
+  make one: `ranges.create(scope, set.id, { kind: 'group', name, intendedCollectionId? })`. Each tap goes through
+  `ranges.addMember(scope, set.id, group.id, { code | uid, collectionId, productId? })`, which stamps the tag with
+  the group and assigns it with the single-tag rules; `assigned.skipped` says when a tag was left alone (claimed,
+  or in a collection you don't administer). `ranges.assign(scope, set.id, group.id, { collectionId })` moves every
+  member in one go; `ranges.removeMember` takes one out. Groups have no printer file, instructions, import or
+  `next` (`400 NOT_A_RANGE`). Its tags must be codes of the group's set; a chip that is a code elsewhere is
+  `409 OTHER_SET`.
+
+Status reads `open` or `group` for these (and `assigned` once every member of a group is assigned).
+
 ## The printer file
 
 One row per tag, in index order. The manufacturer fills in `UID` and sends the same file back; rows are

package/dist/openapi.yaml

@@ -14952,6 +14952,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /{groupId}/members:
+    post:
+      tags:
+        - ranges
+      summary: Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given.
+      operationId: ranges_addMember
+      security: []
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AddClaimSetRangeMemberResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddClaimSetRangeMemberRequest"
   /{rangeId}:
     get:
       tags:
@@ -15041,6 +15073,38 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/AssignClaimSetRangeRequest"
+  /{rangeId}/close:
+    post:
+      tags:
+        - ranges
+      summary: "Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted)."
+      operationId: ranges_close
+      security: []
+      parameters:
+        - name: rangeId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CloseClaimSetRangeResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ClaimSetScope"
   /{rangeId}/export:
     get:
       tags:
@@ -25919,6 +25983,8 @@ components:
           type: string
         namespace:
           type: string
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         notes:
@@ -25972,6 +26038,7 @@ components:
         - id
         - claimSetId
         - namespace
+        - kind
         - name
         - notes
         - startIndex
@@ -25995,6 +26062,8 @@ components:
     CreateClaimSetRangeRequest:
       type: object
       properties:
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         quantity:
@@ -26018,7 +26087,6 @@ components:
           type: string
       required:
         - name
-        - quantity
     UpdateClaimSetRangeRequest:
       type: object
       properties:
@@ -26062,6 +26130,10 @@ components:
           type: string
         proofId:
           type: string
+        rangeId:
+          type: string
+        groupId:
+          type: string
         programmedAt:
           type: string
         scans:
@@ -26075,6 +26147,8 @@ components:
         - productId
         - batchId
         - proofId
+        - rangeId
+        - groupId
         - programmedAt
         - scans
     ClaimSetRangeTagsPage:
@@ -26103,6 +26177,41 @@ components:
       required:
         - url
         - remaining
+    AddClaimSetRangeMemberRequest:
+      type: object
+      properties:
+        code:
+          type: string
+        uid:
+          type: string
+        collectionId:
+          type: string
+        productId:
+          type: string
+        batchId:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+        clear:
+          type: boolean
+    AddClaimSetRangeMemberResponse:
+      type: object
+      properties:
+        tag:
+          $ref: "#/components/schemas/ClaimSetRangeTag"
+        range:
+          $ref: "#/components/schemas/ClaimSetRange"
+        assigned:
+          type: object
+          additionalProperties: true
+        movedFrom:
+          type: string
+      required:
+        - tag
+        - range
+        - assigned
+        - movedFrom
     ImportClaimSetRangeUidsRequest:
       type: object
       properties:
@@ -26303,6 +26412,12 @@ components:
         - ntag424
         - ntag21x
         - qr
+    ClaimSetRangeKind:
+      type: string
+      enum:
+        - range
+        - open
+        - group
     ClaimSetRangeStatus:
       type: string
       enum:
@@ -26311,6 +26426,11 @@ components:
         - sent
         - received
         - assigned
+        - open
+        - group
+    CloseClaimSetRangeResponse:
+      type: object
+      additionalProperties: true
     ClaimSetImportResult:
       type: string
       enum:

package/dist/types/claimSet.d.ts

@@ -129,21 +129,32 @@ export type ClaimSetScope = {
     partnerId: string;
 };
 export type ClaimSetTagType = 'ntag424' | 'ntag21x' | 'qr';
-export type ClaimSetRangeStatus = 'minting' | 'minted' | 'sent' | 'received' | 'assigned';
+/**
+ * range: a contiguous block of indexes minted up front. open: grows one index per tag programmed on a phone
+ * (count unknown in advance), closed into a range later. group: existing tags added by tapping, assigned by
+ * hand and moved together; no indexes.
+ */
+export type ClaimSetRangeKind = 'range' | 'open' | 'group';
+export type ClaimSetRangeStatus = 'minting' | 'minted' | 'sent' | 'received' | 'assigned' | 'open' | 'group';
 export interface ClaimSetRange {
     id: string;
     claimSetId: string;
     namespace: string;
+    kind: ClaimSetRangeKind;
     name: string;
     notes: string | null;
-    startIndex: number;
-    endIndex: number;
+    /** null for a group */
+    startIndex: number | null;
+    /** open: the highest index minted so far (null until the first); group: null */
+    endIndex: number | null;
+    /** range: the block; open: minted so far; group: its members */
     quantity: number;
     tagType: ClaimSetTagType;
+    /** open ranges and groups are always 'sidekick' */
     fulfilment: 'printer' | 'sidekick';
-    /** The stored step: minting | minted | sent | received */
+    /** The stored step: minting | minted | sent | received (always 'minted' for open ranges and groups) */
     stage: 'minting' | 'minted' | 'sent' | 'received';
-    /** What to show: the stage, or 'assigned' once every tag is assigned */
+    /** What to show: the stage, 'open', 'group', or 'assigned' once every tag is assigned */
     status: ClaimSetRangeStatus;
     intendedCollectionId: string | null;
     intendedProductId: string | null;
@@ -162,9 +173,11 @@ export interface ClaimSetRange {
     updatedAt: string;
 }
 export interface CreateClaimSetRangeRequest {
+    /** Default 'range'. Owners and admins make ranges and open ranges; assigners may make groups too. */
+    kind?: ClaimSetRangeKind;
     name: string;
-    /** 1 to 10,000 */
-    quantity: number;
+    /** 1 to 10,000 (a range); ignored for open ranges and groups */
+    quantity?: number;
     /** Pre-assign every tag at mint time (you must administer the collection) */
     intendedCollectionId?: string;
     intendedProductId?: string;
@@ -194,6 +207,10 @@ export interface ClaimSetRangeTag {
     productId: string | null;
     batchId: string | null;
     proofId: string | null;
+    /** The range it was minted into, if any */
+    rangeId: string | null;
+    /** The group it was added to, if any */
+    groupId: string | null;
     programmedAt: string | null;
     scans: number;
 }
@@ -207,8 +224,42 @@ export interface ClaimSetRangeNextTag extends ClaimSetRangeTag {
     url: string;
     piccOffset?: number;
     mirrorOffset?: number;
-    remaining: number;
+    /** Tags still without a chip; null for an open range (it grows as you go) */
+    remaining: number | null;
+}
+/** Add an existing tag of the set to a group, and (with a collection, or clear) assign it as you go. */
+export interface AddClaimSetRangeMemberRequest {
+    /** The tag's code, printed or bare… */
+    code?: string;
+    /** …or its chip UID (14 hex) */
+    uid?: string;
+    collectionId?: string;
+    productId?: string;
+    batchId?: string;
+    data?: Record<string, unknown>;
+    clear?: boolean;
 }
+export interface AddClaimSetRangeMemberResponse {
+    tag: ClaimSetRangeTag;
+    range: ClaimSetRange;
+    /** The assignment, with the same skips as assign (has_proof, assigned_elsewhere) */
+    assigned: {
+        changed: number;
+        skipped: Array<{
+            code: string;
+            index: number | null;
+            reason: 'other_range' | 'has_proof' | 'assigned_elsewhere';
+            collectionId?: string;
+        }>;
+    };
+    /** The group the tag was taken from, if it was in another one */
+    movedFrom: string | null;
+}
+/** Closing an open range: the range it became, or that it was removed because nothing was minted. */
+export type CloseClaimSetRangeResponse = ClaimSetRange | {
+    id: string;
+    deleted: true;
+};
 export type ClaimSetImportResult = 'ok' | 'unchanged' | 'unknown_code' | 'duplicate_row' | 'index_mismatch' | 'no_uid' | 'bad_uid' | 'duplicate_uid' | 'uid_in_use' | 'uid_conflict';
 export interface ImportClaimSetRangeUidsRequest {
     /** The manufacturer's file as CSV text (the file we sent, with UID filled in) */

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.1.15  |  Generated: 2026-11-09T15:17:42.472Z
+Version: 2.1.16  |  Generated: 2026-11-10T17:19:48.505Z
 
 This is a concise summary of all available API functions and types.
 
@@ -5775,10 +5775,11 @@ interface ClaimSetRange {
   id: string
   claimSetId: string
   namespace: string
+  kind: ClaimSetRangeKind
   name: string
   notes: string | null
-  startIndex: number
-  endIndex: number
+  startIndex: number | null
+  endIndex: number | null
   quantity: number
   tagType: ClaimSetTagType
   fulfilment: 'printer' | 'sidekick'
@@ -5801,8 +5802,9 @@ interface ClaimSetRange {
 **CreateClaimSetRangeRequest** (interface)
 ```typescript
 interface CreateClaimSetRangeRequest {
+  kind?: ClaimSetRangeKind
   name: string
-  quantity: number
+  quantity?: number
   intendedCollectionId?: string
   intendedProductId?: string
   intendedBatchId?: string
@@ -5837,6 +5839,8 @@ interface ClaimSetRangeTag {
   productId: string | null
   batchId: string | null
   proofId: string | null
+  rangeId: string | null
+  groupId: string | null
   programmedAt: string | null
   scans: number
 }
@@ -5850,6 +5854,29 @@ interface ClaimSetRangeTagsPage {
 }
 ```
 
+**AddClaimSetRangeMemberRequest** (interface)
+```typescript
+interface AddClaimSetRangeMemberRequest {
+  code?: string
+  uid?: string
+  collectionId?: string
+  productId?: string
+  batchId?: string
+  data?: Record<string, unknown>
+  clear?: boolean
+}
+```
+
+**AddClaimSetRangeMemberResponse** (interface)
+```typescript
+interface AddClaimSetRangeMemberResponse {
+  tag: ClaimSetRangeTag
+  range: ClaimSetRange
+  assigned: { changed: number; skipped: Array<{ code: string; index: number | null; reason: 'other_range' | 'has_proof' | 'assigned_elsewhere'; collectionId?: string }> }
+  movedFrom: string | null
+}
+```
+
 **ImportClaimSetRangeUidsRequest** (interface)
 ```typescript
 interface ImportClaimSetRangeUidsRequest {
@@ -5958,7 +5985,11 @@ type ClaimSetScope = { collectionId: string }
 
 **ClaimSetTagType** = `'ntag424' | 'ntag21x' | 'qr'`
 
-**ClaimSetRangeStatus** = `'minting' | 'minted' | 'sent' | 'received' | 'assigned'`
+**ClaimSetRangeKind** = `'range' | 'open' | 'group'`
+
+**ClaimSetRangeStatus** = `'minting' | 'minted' | 'sent' | 'received' | 'assigned' | 'open' | 'group'`
+
+**CloseClaimSetRangeResponse** = `ClaimSetRange | { id: string`
 
 **ClaimSetImportResult** = ``
 
@@ -12464,6 +12495,15 @@ Name, notes, order details, or a stage move (sent to the printer, received).
 **resume**(scope: ClaimSetScope, claimSetId: string, rangeId: string) → `Promise<ClaimSetRange>`
 Finish minting a range that was interrupted.
 
+**close**(scope: ClaimSetScope, claimSetId: string, rangeId: string) → `Promise<CloseClaimSetRangeResponse>`
+Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted).
+
+**addMember**(scope: ClaimSetScope, claimSetId: string, groupId: string, params: AddClaimSetRangeMemberRequest) → `Promise<AddClaimSetRangeMemberResponse>`
+Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given.
+
+**removeMember**(scope: ClaimSetScope, claimSetId: string, groupId: string, code: string) → `Promise<`
+Take a tag out of a group. Its assignment is left as it is.
+
 **tags**(scope: ClaimSetScope, claimSetId: string, rangeId: string,
       options: { from?: number; limit?: number; keys?: boolean } = {}) → `Promise<ClaimSetRangeTagsPage>`
 The range's tags in index order, a page at a time (keys: owners/admins only).

package/docs/tag-ranges.md

@@ -55,6 +55,27 @@ tag without a chip, with its URL and key; write it, then `ranges.recordTag(scope
 
 To find where a chip or code went, `partner.lookupTags(partner.id, { uid })` or `{ code }` searches every set the partner owns and returns each hit's set, tag and range, never a key.
 
+## Open ranges and groups
+
+A range's count is fixed when it is minted. Two phone-side jobs don't know their count in advance, so a range
+has a `kind`:
+
+- **`open`**: blank tags programmed on Sidekick one at a time. `ranges.create(scope, set.id, { kind: 'open', name })`
+  reserves only a start index; each `ranges.next()` hands back a free minted code or mints one more, so
+  `quantity`/`endIndex` grow as tags are written (`remaining` is null). One open range per set, and nothing can
+  be minted behind it (`409 RANGE_OPEN`) until `ranges.close(scope, set.id, range.id)` turns it into an ordinary
+  range (an open range that minted nothing is removed instead).
+- **`group`**: tags that already exist, added by tapping, assigned by hand, and moved together later. Assigners may
+  make one: `ranges.create(scope, set.id, { kind: 'group', name, intendedCollectionId? })`. Each tap goes through
+  `ranges.addMember(scope, set.id, group.id, { code | uid, collectionId, productId? })`, which stamps the tag with
+  the group and assigns it with the single-tag rules; `assigned.skipped` says when a tag was left alone (claimed,
+  or in a collection you don't administer). `ranges.assign(scope, set.id, group.id, { collectionId })` moves every
+  member in one go; `ranges.removeMember` takes one out. Groups have no printer file, instructions, import or
+  `next` (`400 NOT_A_RANGE`). Its tags must be codes of the group's set; a chip that is a code elsewhere is
+  `409 OTHER_SET`.
+
+Status reads `open` or `group` for these (and `assigned` once every member of a group is assigned).
+
 ## The printer file
 
 One row per tag, in index order. The manufacturer fills in `UID` and sends the same file back; rows are

package/openapi.yaml

@@ -14952,6 +14952,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /{groupId}/members:
+    post:
+      tags:
+        - ranges
+      summary: Put an existing tag of the set into a group (by code or chip UID), assigning it if a collection is given.
+      operationId: ranges_addMember
+      security: []
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AddClaimSetRangeMemberResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/AddClaimSetRangeMemberRequest"
   /{rangeId}:
     get:
       tags:
@@ -15041,6 +15073,38 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/AssignClaimSetRangeRequest"
+  /{rangeId}/close:
+    post:
+      tags:
+        - ranges
+      summary: "Close an open range: it becomes a range with the quantity it reached (removed if nothing was minted)."
+      operationId: ranges_close
+      security: []
+      parameters:
+        - name: rangeId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CloseClaimSetRangeResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ClaimSetScope"
   /{rangeId}/export:
     get:
       tags:
@@ -25919,6 +25983,8 @@ components:
           type: string
         namespace:
           type: string
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         notes:
@@ -25972,6 +26038,7 @@ components:
         - id
         - claimSetId
         - namespace
+        - kind
         - name
         - notes
         - startIndex
@@ -25995,6 +26062,8 @@ components:
     CreateClaimSetRangeRequest:
       type: object
       properties:
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         quantity:
@@ -26018,7 +26087,6 @@ components:
           type: string
       required:
         - name
-        - quantity
     UpdateClaimSetRangeRequest:
       type: object
       properties:
@@ -26062,6 +26130,10 @@ components:
           type: string
         proofId:
           type: string
+        rangeId:
+          type: string
+        groupId:
+          type: string
         programmedAt:
           type: string
         scans:
@@ -26075,6 +26147,8 @@ components:
         - productId
         - batchId
         - proofId
+        - rangeId
+        - groupId
         - programmedAt
         - scans
     ClaimSetRangeTagsPage:
@@ -26103,6 +26177,41 @@ components:
       required:
         - url
         - remaining
+    AddClaimSetRangeMemberRequest:
+      type: object
+      properties:
+        code:
+          type: string
+        uid:
+          type: string
+        collectionId:
+          type: string
+        productId:
+          type: string
+        batchId:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+        clear:
+          type: boolean
+    AddClaimSetRangeMemberResponse:
+      type: object
+      properties:
+        tag:
+          $ref: "#/components/schemas/ClaimSetRangeTag"
+        range:
+          $ref: "#/components/schemas/ClaimSetRange"
+        assigned:
+          type: object
+          additionalProperties: true
+        movedFrom:
+          type: string
+      required:
+        - tag
+        - range
+        - assigned
+        - movedFrom
     ImportClaimSetRangeUidsRequest:
       type: object
       properties:
@@ -26303,6 +26412,12 @@ components:
         - ntag424
         - ntag21x
         - qr
+    ClaimSetRangeKind:
+      type: string
+      enum:
+        - range
+        - open
+        - group
     ClaimSetRangeStatus:
       type: string
       enum:
@@ -26311,6 +26426,11 @@ components:
         - sent
         - received
         - assigned
+        - open
+        - group
+    CloseClaimSetRangeResponse:
+      type: object
+      additionalProperties: true
     ClaimSetImportResult:
       type: string
       enum:

package/package.json

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