@proveanything/smartlinks 1.16.0 → 1.16.2

package/dist/api/lots.d.ts

@@ -10,16 +10,29 @@ export declare namespace lots {
     function create(collectionId: string, lot: LotCreateInput): Promise<Lot>;
     /** List lots (summary rows; `payload`/`productIds` omitted). Filter by status, search, or containing productId. */
     function list(collectionId: string, params?: ListLotsParams): Promise<Lot[]>;
-    /** Get the full lot record. */
-    function get(collectionId: string, lotId: string): Promise<Lot>;
+    /** Get the full lot record. Pass `{ includeDeleted: true }` to fetch a soft-deleted one. */
+    function get(collectionId: string, lotId: string, opts?: {
+        includeDeleted?: boolean;
+    }): Promise<Lot>;
     /** Look up a lot by its number (case-insensitive) — used by scan/resolver flows. */
-    function getByNumber(collectionId: string, lotNumber: string): Promise<Lot>;
+    function getByNumber(collectionId: string, lotNumber: string, opts?: {
+        includeDeleted?: boolean;
+    }): Promise<Lot>;
     /** Update a lot. Re-resolves members if the selector changed (response then carries `diff`). */
     function update(collectionId: string, lotId: string, lot: LotUpdateInput): Promise<Lot>;
-    /** Soft-archive a lot (never deletes members). */
+    /**
+     * Soft-delete a lot — recoverable, and frees its `lotNumber` for reuse. Distinct from
+     * {@link archive}. Hidden from reads unless `{ includeDeleted: true }`; undo with {@link restore}.
+     */
+    function remove(collectionId: string, lotId: string): Promise<{
+        success: boolean;
+    }>;
+    /** Archive a lot — a live lifecycle state (stays visible, keeps its number). Not a delete. */
     function archive(collectionId: string, lotId: string): Promise<{
         success: boolean;
     }>;
+    /** Restore a soft-deleted lot. Rejects (409) if a live lot now uses the same number. */
+    function restore(collectionId: string, lotId: string): Promise<Lot>;
     /** Re-resolve members from the current selector; returns the lot + a member diff. */
     function resolve(collectionId: string, lotId: string): Promise<ResolveLotResponse>;
     /** Paginated member product summaries. */

package/dist/api/lots.js

@@ -22,6 +22,8 @@ export var lots;
             qs.append('search', params.search);
         if (params.productId)
             qs.append('productId', params.productId);
+        if (params.includeDeleted)
+            qs.append('includeDeleted', 'true');
         const s = qs.toString();
         return s ? `?${s}` : '';
     }
@@ -46,14 +48,16 @@ export var lots;
         return res.lots;
     }
     lots.list = list;
-    /** Get the full lot record. */
-    async function get(collectionId, lotId) {
-        return request(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}`);
+    /** Get the full lot record. Pass `{ includeDeleted: true }` to fetch a soft-deleted one. */
+    async function get(collectionId, lotId, opts = {}) {
+        const qs = opts.includeDeleted ? '?includeDeleted=true' : '';
+        return request(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}${qs}`);
     }
     lots.get = get;
     /** Look up a lot by its number (case-insensitive) — used by scan/resolver flows. */
-    async function getByNumber(collectionId, lotNumber) {
-        return request(`${adminBase(collectionId)}/by-number/${encodeURIComponent(lotNumber)}`);
+    async function getByNumber(collectionId, lotNumber, opts = {}) {
+        const qs = opts.includeDeleted ? '?includeDeleted=true' : '';
+        return request(`${adminBase(collectionId)}/by-number/${encodeURIComponent(lotNumber)}${qs}`);
     }
     lots.getByNumber = getByNumber;
     /** Update a lot. Re-resolves members if the selector changed (response then carries `diff`). */
@@ -61,11 +65,24 @@ export var lots;
         return put(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}`, lot);
     }
     lots.update = update;
-    /** Soft-archive a lot (never deletes members). */
-    async function archive(collectionId, lotId) {
+    /**
+     * Soft-delete a lot — recoverable, and frees its `lotNumber` for reuse. Distinct from
+     * {@link archive}. Hidden from reads unless `{ includeDeleted: true }`; undo with {@link restore}.
+     */
+    async function remove(collectionId, lotId) {
         return del(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}`);
     }
+    lots.remove = remove;
+    /** Archive a lot — a live lifecycle state (stays visible, keeps its number). Not a delete. */
+    async function archive(collectionId, lotId) {
+        return post(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}/archive`, {});
+    }
     lots.archive = archive;
+    /** Restore a soft-deleted lot. Rejects (409) if a live lot now uses the same number. */
+    async function restore(collectionId, lotId) {
+        return post(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}/restore`, {});
+    }
+    lots.restore = restore;
     /** Re-resolve members from the current selector; returns the lot + a member diff. */
     async function resolve(collectionId, lotId) {
         return post(`${adminBase(collectionId)}/${encodeURIComponent(lotId)}/resolve`, {});

package/dist/api/proof.d.ts

@@ -1,4 +1,4 @@
-import { ProofResponse, ProofCreateRequest, ProofUpdateRequest, ProofClaimRequest, ProofGrant, CreateGrantOptions, RedeemGrantOptions, RedeemGrantResult, ProofTransfer, TransferProofOptions, TransferProofResult } from "../types/proof";
+import { ProofResponse, ProofCreateRequest, ProofUpdateRequest, ProofValuesUpdateRequest, ProofClaimRequest, ProofGrant, CreateGrantOptions, RedeemGrantOptions, RedeemGrantResult, ProofTransfer, TransferProofOptions, TransferProofResult } from "../types/proof";
 export declare namespace proof {
     /**
      * Retrieves a single Proof by Collection ID, Product ID, and Proof ID.
@@ -42,6 +42,27 @@ export declare namespace proof {
      * Object zones deep-merge, so you can change one field without wiping the rest.
      */
     function update(collectionId: string, productId: string, proofId: string, values: ProofUpdateRequest): Promise<ProofResponse>;
+    /**
+     * Owner self-service update of a proof's owner-writable data.
+     * PUT /public/collection/:collectionId/product/:productId/proof/:proofId/values
+     *
+     * The public counterpart to admin `update` — the current OWNER (or a collection
+     * admin) editing their own proof, no admin credentials required. Only owner-writable
+     * zones are honoured (see {@link ProofValuesUpdateRequest}):
+     * ```ts
+     * proof.updateValues(collectionId, productId, proofId, {
+     *   colour:   'blue',            // → proof.values.colour   (public)
+     *   owner:    { warranty: '2y' }, // → proof.values.owner    (owner-scoped)
+     *   personal: { nickname: 'Bo' }, // → proof.values.personal[callerUid] (private, own slot only)
+     * })
+     * ```
+     * `personal` always targets the caller's OWN slot — you cannot write another
+     * user's personal data, even as an admin. Object zones deep-merge (owner/personal
+     * merge field-by-field), so you can change one field without wiping the rest.
+     * Business-only zones (`data`/`admin`/`private`) are not writable here — use the
+     * admin `update` for those.
+     */
+    function updateValues(collectionId: string, productId: string, proofId: string, values: ProofValuesUpdateRequest): Promise<ProofResponse>;
     /**
      * Claim a proof for a product using a proof ID (serial number, NFC tag, etc.).
      * PUT /public/collection/:collectionId/product/:productId/proof/:proofId/claim

package/dist/api/proof.js

@@ -64,6 +64,31 @@ export var proof;
         return put(path, values);
     }
     proof.update = update;
+    /**
+     * Owner self-service update of a proof's owner-writable data.
+     * PUT /public/collection/:collectionId/product/:productId/proof/:proofId/values
+     *
+     * The public counterpart to admin `update` — the current OWNER (or a collection
+     * admin) editing their own proof, no admin credentials required. Only owner-writable
+     * zones are honoured (see {@link ProofValuesUpdateRequest}):
+     * ```ts
+     * proof.updateValues(collectionId, productId, proofId, {
+     *   colour:   'blue',            // → proof.values.colour   (public)
+     *   owner:    { warranty: '2y' }, // → proof.values.owner    (owner-scoped)
+     *   personal: { nickname: 'Bo' }, // → proof.values.personal[callerUid] (private, own slot only)
+     * })
+     * ```
+     * `personal` always targets the caller's OWN slot — you cannot write another
+     * user's personal data, even as an admin. Object zones deep-merge (owner/personal
+     * merge field-by-field), so you can change one field without wiping the rest.
+     * Business-only zones (`data`/`admin`/`private`) are not writable here — use the
+     * admin `update` for those.
+     */
+    async function updateValues(collectionId, productId, proofId, values) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/values`;
+        return put(path, values);
+    }
+    proof.updateValues = updateValues;
     /**
      * Claim a proof for a product using a proof ID (serial number, NFC tag, etc.).
      * PUT /public/collection/:collectionId/product/:productId/proof/:proofId/claim

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.16.0  |  Generated: 2026-09-01T12:28:06.435Z
+Version: 1.16.2  |  Generated: 2026-09-05T10:46:06.239Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3549,20 +3549,25 @@ interface FirebaseTimestamp {
 ```typescript
 interface BatchResponse {
   id: string                      // Batch ID
-  name?: string                   // Batch name
-  expiryDate?: FirebaseTimestamp | string  // Firebase timestamp or ISO 8601 date
-  productId?: string              // Product ID (for collection-level searches)
+  name?: string | null            // Batch name
+  expiryDate?: string | null
+  productId?: string              // Product ID
   collectionId?: string           // Collection ID
-  [key: string]: any              // Additional batch fields
+  createdAt?: string              // ISO 8601
+  updatedAt?: string              // ISO 8601
+  deleted?: boolean
+  deletedAt?: string              // ISO 8601
+  admin?: Record<string, any>
+  [key: string]: any              // Additional (schemaless) batch fields
 }
 ```
 
 **BatchCreateRequest** (interface)
 ```typescript
 interface BatchCreateRequest {
-  id: string                      // Batch ID
-  name?: string                   // Batch name
-  expiryDate?: FirebaseTimestamp | string  // Firebase timestamp or ISO 8601 date
+  id?: string
+  name?: string
+  expiryDate?: FirebaseTimestamp | string | Date
   [key: string]: any              // Additional batch fields
 }
 ```
@@ -3570,8 +3575,8 @@ interface BatchCreateRequest {
 **BatchUpdateRequest** (interface)
 ```typescript
 interface BatchUpdateRequest {
-  name?: string                   // Batch name
-  expiryDate?: FirebaseTimestamp | string  // Firebase timestamp or ISO 8601 date
+  name?: string
+  expiryDate?: FirebaseTimestamp | string | Date
   [key: string]: any              // Additional batch fields
 }
 ```
@@ -6389,6 +6394,7 @@ interface Lot {
   updatedBy?: string | null
   createdAt: string
   updatedAt: string
+  deletedAt?: string | null
 }
 ```
 
@@ -6412,6 +6418,7 @@ interface ListLotsParams {
   status?: LotStatus
   search?: string
   productId?: string
+  includeDeleted?: boolean
 }
 ```
 
@@ -7431,6 +7438,9 @@ interface ProductFieldsConfig {
 ```typescript
 interface ProofValues {
   [key: string]: JsonValue | Record<string, JsonValue> | Record<string, Record<string, JsonValue>> | undefined
+  * Owner-scoped: read/write by business + current owner; transfers with ownership.
+  * Read exception: while the proof is `claimable`, this bag is also readable by everyone
+  * (so a prospective claimer sees pre-set owner data); it reverts to owner-only once claimed.
   owner?: Record<string, JsonValue>
   personal?: Record<string, Record<string, JsonValue>>
 }
@@ -7489,6 +7499,15 @@ interface ProofCreateRequest {
 }
 ```
 
+**ProofValuesUpdateRequest** (interface)
+```typescript
+interface ProofValuesUpdateRequest {
+  [key: string]: JsonValue | Record<string, JsonValue> | undefined
+  owner?: Record<string, JsonValue>
+  personal?: Record<string, JsonValue>
+}
+```
+
 **ProofFieldsConfig** (interface)
 ```typescript
 interface ProofFieldsConfig {
@@ -8151,11 +8170,38 @@ interface TranslationUpdateRequest {
 
 ### variant
 
-**VariantResponse** = `any`
+**VariantResponse** (interface)
+```typescript
+interface VariantResponse {
+  id: string
+  name?: string | null
+  productId?: string
+  collectionId?: string
+  createdAt?: string              // ISO 8601
+  updatedAt?: string              // ISO 8601
+  deleted?: boolean
+  deletedAt?: string              // ISO 8601
+  admin?: Record<string, any>
+  [key: string]: any              // Additional (schemaless) variant fields
+}
+```
 
-**VariantCreateRequest** = `any`
+**VariantCreateRequest** (interface)
+```typescript
+interface VariantCreateRequest {
+  id?: string
+  name?: string
+  [key: string]: any
+}
+```
 
-**VariantUpdateRequest** = `any`
+**VariantUpdateRequest** (interface)
+```typescript
+interface VariantUpdateRequest {
+  name?: string
+  [key: string]: any
+}
+```
 
 ### widgets
 
@@ -9898,17 +9944,23 @@ Create a lot (resolves its selector into members).
 **list**(collectionId: string, params: ListLotsParams = {}) → `Promise<Lot[]>`
 List lots (summary rows; `payload`/`productIds` omitted). Filter by status, search, or containing productId.
 
-**get**(collectionId: string, lotId: string) → `Promise<Lot>`
-Get the full lot record.
+**get**(collectionId: string, lotId: string, opts: { includeDeleted?: boolean } = {}) → `Promise<Lot>`
+Get the full lot record. Pass `{ includeDeleted: true }` to fetch a soft-deleted one.
 
-**getByNumber**(collectionId: string, lotNumber: string) → `Promise<Lot>`
+**getByNumber**(collectionId: string, lotNumber: string, opts: { includeDeleted?: boolean } = {}) → `Promise<Lot>`
 Look up a lot by its number (case-insensitive) — used by scan/resolver flows.
 
 **update**(collectionId: string, lotId: string, lot: LotUpdateInput) → `Promise<Lot>`
 Update a lot. Re-resolves members if the selector changed (response then carries `diff`).
 
+**remove**(collectionId: string, lotId: string) → `Promise<`
+Soft-delete a lot — recoverable, and frees its `lotNumber` for reuse. Distinct from {@link archive}. Hidden from reads unless `{ includeDeleted: true }`; undo with {@link restore}.
+
 **archive**(collectionId: string, lotId: string) → `Promise<`
-Soft-archive a lot (never deletes members).
+Archive a lot — a live lifecycle state (stays visible, keeps its number). Not a delete.
+
+**restore**(collectionId: string, lotId: string) → `Promise<Lot>`
+Restore a soft-deleted lot. Rejects (409) if a live lot now uses the same number.
 
 **resolve**(collectionId: string, lotId: string) → `Promise<ResolveLotResponse>`
 Re-resolve members from the current selector; returns the lot + a member diff.
@@ -10301,6 +10353,12 @@ Create a proof for a product (admin only). POST /admin/collection/:collectionId/
     values: ProofUpdateRequest) → `Promise<ProofResponse>`
 Update a proof for a product (admin only). PUT /admin/collection/:collectionId/product/:productId/proof/:proofId Pass the fields to change **at the root**, keyed by zone (see {@link ProofWrite}): ```ts proof.update(collectionId, productId, proofId, { data:   { serialNo: 1002 },   // → proof.data (admin-only writable) values: { colour: 'blue' },   // → proof.values }) ``` Object zones deep-merge, so you can change one field without wiping the rest.
 
+**updateValues**(collectionId: string,
+    productId: string,
+    proofId: string,
+    values: ProofValuesUpdateRequest) → `Promise<ProofResponse>`
+Owner self-service update of a proof's owner-writable data. PUT /public/collection/:collectionId/product/:productId/proof/:proofId/values The public counterpart to admin `update` — the current OWNER (or a collection admin) editing their own proof, no admin credentials required. Only owner-writable zones are honoured (see {@link ProofValuesUpdateRequest}): ```ts proof.updateValues(collectionId, productId, proofId, { colour:   'blue',            // → proof.values.colour   (public) owner:    { warranty: '2y' }, // → proof.values.owner    (owner-scoped) personal: { nickname: 'Bo' }, // → proof.values.personal[callerUid] (private, own slot only) }) ``` `personal` always targets the caller's OWN slot — you cannot write another user's personal data, even as an admin. Object zones deep-merge (owner/personal merge field-by-field), so you can change one field without wiping the rest. Business-only zones (`data`/`admin`/`private`) are not writable here — use the admin `update` for those.
+
 **claim**(collectionId: string,
     productId: string,
     proofId: string,

package/dist/docs/lots.md

@@ -18,9 +18,22 @@ truth for its shared data.
   - `{ mode: 'products', productIds: [...] }` — an explicit list.
 - **`productIds` / `productCount`** — the materialised snapshot of resolved members (re-resolved on create, on selector change, and on demand via `resolve`).
 - **`payload`** — shared lot data (dates, supplier ref, custom fields). Lives only on the lot.
-- **`status`** — `open` → `closed` → `recalled` → `archived`. Archiving never deletes anything.
+- **`status`** — `open` → `closed` → `recalled` → `archived`. A live lifecycle state, distinct from deletion.
 - **`destination`** — optional lot-level redirect; wins over the product's on a lot-scoped scan.
 
+### Archive vs delete
+
+Two separate ideas — mirroring the platform's `deletedAt` convention:
+
+| | `archive` (`status: 'archived'`) | `remove` (soft-delete, `deletedAt`) |
+|---|---|---|
+| Record | stays **live** & visible | **hidden** from reads unless `includeDeleted: true` |
+| `lotNumber` | **stays reserved** | **freed** for reuse by a new lot |
+| AI(10) scan | not resolved (excluded) | not resolved |
+| Reversible | change status back | `restore` (409 if the number was taken by a live lot) |
+
+Nothing is ever hard-deleted (joins/history stay intact). Use **archive** for "this run is done, keep it around"; use **remove** for "this was a mistake, and I want the number back."
+
 ---
 
 ## SDK — `SL.lots.*`
@@ -50,7 +63,11 @@ const containing  = await lots.list(collectionId, { productId: 'prd_abc' }) // r
 const updated     = await lots.update(collectionId, lot.id, { status: 'closed' })
 const { diff }    = await lots.resolve(collectionId, lot.id)               // { added, removed }
 const members     = await lots.listProducts(collectionId, lot.id, { page: 1, limit: 50 })
-await lots.archive(collectionId, lot.id)
+
+await lots.archive(collectionId, lot.id)                       // live, keeps its number
+await lots.remove(collectionId, lot.id)                        // soft-delete, frees the number
+const withDeleted = await lots.list(collectionId, { includeDeleted: true })
+const restored    = await lots.restore(collectionId, lot.id)   // undo a soft-delete
 
 // Cross-app reads
 const publicLots  = await lots.publicList(collectionId)

package/dist/docs/proof-product-data-scoping.md

@@ -37,7 +37,8 @@ proof.admin = { … }        // BUSINESS-ONLY → read: business,       write: b
 proof.values = {           // consumer bag — owner + business-writable
   <anyKey>: …,              // PUBLIC        → read: everyone,
                              //                write: business + current owner
-  owner: { … },              // OWNER-SCOPED  → read: business + current owner,
+  owner: { … },              // OWNER-SCOPED  → read: business + current owner
+                             //                (also everyone while `claimable`, see below),
                              //                write: business + current owner,
                              //                transfers with ownership
   personal: {                // PER-USER      → read/write: only the specific user,
@@ -75,10 +76,12 @@ The field-config editor and SDK write helpers MUST reject attempts to create top
 | `proof.data.*`                    |         ✅          |             ✅             |       ✅       |        ✅       |
 | `proof.admin.*`                   |         ❌          |             ❌             |       ❌       |        ✅       |
 | `proof.values.<publicKey>`        |         ✅          |             ✅             |       ✅       |        ✅       |
-| `proof.values.owner.*`            |         ❌          |             ❌             |       ✅       |        ✅       |
+| `proof.values.owner.*`            |        ❌ †         |            ❌ †            |       ✅       |        ✅       |
 | `proof.values.personal[me].*`     |         ❌          |     ✅ (own slot only)     | ✅ (own slot)  | ❌ (see note)   |
 | `proof.values.personal[other].*`  |         ❌          |             ❌             |       ❌       | ❌ (see note)   |
 
+> **† Claimable exception (`proof.values.owner.*`):** while a proof is **claimable** (`proof.claimable === true` *or* `proof.values.claimable === true`), its `owner` bag is returned to **everyone** — public/anonymous and authenticated non-owners included — so a prospective claimer can see pre-set owner data before claiming. Once the proof is claimed (`claimable` flips off) it reverts to owner-only (unless re-marked claimable). This is **read-only** exposure — write authority is unchanged (still owner + business). Implication: don't put anything in `values.owner` on a claimable proof that shouldn't be visible before it's claimed.
+>
 > **Note on `personal`:** the default rule is that `personal` slots are readable *only* by the user whose `userId` matches the slot key — not even business admins. If the platform ever needs an admin-visible variant, it should be a separate mechanism, not a relaxation of this rule.
 
 ## Who writes what (authority matrix)

package/dist/openapi.yaml

@@ -4996,6 +4996,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/lots/{lotId}/restore:
+    post:
+      tags:
+        - lots
+      summary: Restore a soft-deleted lot.
+      operationId: lots_restore
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: lotId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Lot"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/lots{params}:
     get:
       tags:
@@ -12611,6 +12643,48 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/product/{productId}/proof/{proofId}/values:
+    put:
+      tags:
+        - proof
+      summary: proof.updateValues
+      operationId: proof_updateValues
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: productId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: proofId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ProofResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ProofValuesUpdateRequest"
   /public/collection/{collectionId}/products/{productId}/createClaim:
     post:
       tags:
@@ -19810,12 +19884,22 @@ components:
         name:
           type: string
         expiryDate:
-          type: object
-          additionalProperties: true
+          type: string
         productId:
           type: string
         collectionId:
           type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        deleted:
+          type: boolean
+        deletedAt:
+          type: string
+        admin:
+          type: object
+          additionalProperties: true
       required:
         - id
     BatchCreateRequest:
@@ -19828,8 +19912,6 @@ components:
         expiryDate:
           type: object
           additionalProperties: true
-      required:
-        - id
     BatchUpdateRequest:
       type: object
       properties:
@@ -23737,6 +23819,8 @@ components:
           type: string
         updatedAt:
           type: string
+        deletedAt:
+          type: string
       required:
         - id
         - collectionId
@@ -23777,6 +23861,8 @@ components:
           type: string
         productId:
           type: string
+        includeDeleted:
+          type: boolean
     ListLotsResponse:
       type: object
       properties:
@@ -25620,6 +25706,17 @@ components:
           type: object
           additionalProperties:
             $ref: "#/components/schemas/JsonValue"
+    ProofValuesUpdateRequest:
+      type: object
+      properties:
+        owner:
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/JsonValue"
+        personal:
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/JsonValue"
     ProofFieldsConfig:
       type: object
       properties:
@@ -26654,6 +26751,42 @@ components:
         metadata:
           type: object
           additionalProperties: true
+    VariantResponse:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        productId:
+          type: string
+        collectionId:
+          type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        deleted:
+          type: boolean
+        deletedAt:
+          type: string
+        admin:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+    VariantCreateRequest:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+    VariantUpdateRequest:
+      type: object
+      properties:
+        name:
+          type: string
     NavigationRequest:
       type: object
       properties:

package/dist/types/batch.d.ts

@@ -1,28 +1,39 @@
 /**
- * Firebase Timestamp object.
+ * @deprecated Batches moved to Postgres — dates now come back as ISO 8601 strings, never
+ * Firestore Timestamp objects. Kept only so request bodies can still pass a legacy value.
  */
 export interface FirebaseTimestamp {
     seconds: number;
     nanoseconds?: number;
 }
 /**
- * Represents a Batch object.
+ * Represents a Batch object. Dates are **ISO 8601 strings**.
  */
 export interface BatchResponse {
     id: string;
-    name?: string;
-    expiryDate?: FirebaseTimestamp | string;
+    name?: string | null;
+    /** ISO 8601 date-time (was a Firebase Timestamp; now normalised to a string). */
+    expiryDate?: string | null;
     productId?: string;
     collectionId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /** Present only on soft-deleted batches. */
+    deleted?: boolean;
+    deletedAt?: string;
+    /** Admin-only zone (e.g. `lastSerialId`). Returned on admin reads only — never on public reads. */
+    admin?: Record<string, any>;
     [key: string]: any;
 }
 /**
  * Request payload for creating a new batch.
  */
 export interface BatchCreateRequest {
-    id: string;
+    /** @deprecated Ignored — the server generates the batch id. */
+    id?: string;
     name?: string;
-    expiryDate?: FirebaseTimestamp | string;
+    /** A `Date`, ISO 8601 string, or legacy Firebase Timestamp — all accepted. */
+    expiryDate?: FirebaseTimestamp | string | Date;
     [key: string]: any;
 }
 /**
@@ -30,7 +41,7 @@ export interface BatchCreateRequest {
  */
 export interface BatchUpdateRequest {
     name?: string;
-    expiryDate?: FirebaseTimestamp | string;
+    expiryDate?: FirebaseTimestamp | string | Date;
     [key: string]: any;
 }
 /**

package/dist/types/lots.d.ts

@@ -39,6 +39,8 @@ export interface Lot {
     updatedBy?: string | null;
     createdAt: string;
     updatedAt: string;
+    /** Soft-delete timestamp (recoverable). `null` for live lots. Distinct from `status:'archived'`. */
+    deletedAt?: string | null;
 }
 export interface LotCreateInput {
     lotNumber: string;
@@ -57,6 +59,8 @@ export interface ListLotsParams {
     search?: string;
     /** Reverse lookup — lots containing this product id. */
     productId?: string;
+    /** Admin only: include soft-deleted lots (default false). */
+    includeDeleted?: boolean;
 }
 export interface ListLotsResponse {
     lots: Lot[];

package/dist/types/proof.d.ts

@@ -7,7 +7,11 @@ import { JsonValue, ScopedFieldDef } from './product';
  */
 export interface ProofValues {
     [key: string]: JsonValue | Record<string, JsonValue> | Record<string, Record<string, JsonValue>> | undefined;
-    /** Owner-scoped: read/write by business + current owner; transfers with ownership. */
+    /**
+     * Owner-scoped: read/write by business + current owner; transfers with ownership.
+     * Read exception: while the proof is `claimable`, this bag is also readable by everyone
+     * (so a prospective claimer sees pre-set owner data); it reverts to owner-only once claimed.
+     */
     owner?: Record<string, JsonValue>;
     /** Per-user: read/write only by the matching userId; not visible to the next owner, not even business admins. */
     personal?: Record<string, Record<string, JsonValue>>;
@@ -111,6 +115,27 @@ export interface ProofCreateRequest {
 export type ProofUpdateRequest = Partial<ProofWrite> & {
     proof?: ProofWrite;
 };
+/**
+ * Body for the owner self-service values write (`proof.updateValues`), the
+ * public counterpart to the admin `update`. The caller must be the current
+ * owner (or a collection admin). Only owner-writable zones are honoured:
+ *
+ * - flat keys        → `proof.values.<key>` (public data)
+ * - `owner`          → merged into `proof.values.owner` (owner-scoped)
+ * - `personal`       → merged into `proof.values.personal[callerUid]` — the
+ *                      caller's OWN private slot only, never another user's
+ *                      (owner-only, non-transferring; not even admins can
+ *                      write someone else's slot)
+ *
+ * `private` / `proof` sub-keys are business-only and are ignored here.
+ */
+export interface ProofValuesUpdateRequest {
+    [key: string]: JsonValue | Record<string, JsonValue> | undefined;
+    /** Owner-scoped data, merged into `proof.values.owner`. */
+    owner?: Record<string, JsonValue>;
+    /** The caller's own private slot, merged into `proof.values.personal[callerUid]`. */
+    personal?: Record<string, JsonValue>;
+}
 export type ProofClaimRequest = Record<string, any>;
 /**
  * `'public'` (default, omitted) reads/writes `proof.values[key]`.

package/dist/types/variant.d.ts

@@ -1,12 +1,33 @@
 /**
- * Represents a Variant object.
+ * Represents a Variant object. Dates are ISO 8601 strings (Postgres-backed).
  */
-export type VariantResponse = any;
+export interface VariantResponse {
+    id: string;
+    name?: string | null;
+    productId?: string;
+    collectionId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    /** Present only on soft-deleted variants. */
+    deleted?: boolean;
+    deletedAt?: string;
+    /** Admin-only zone (e.g. `lastSerialId`). Admin reads only — never on public reads. */
+    admin?: Record<string, any>;
+    [key: string]: any;
+}
 /**
  * Request payload for creating a new variant.
  */
-export type VariantCreateRequest = any;
+export interface VariantCreateRequest {
+    /** @deprecated Ignored — the server generates the variant id. (Use PUT with an id to choose one.) */
+    id?: string;
+    name?: string;
+    [key: string]: any;
+}
 /**
- * Request payload for updating an existing variant.
+ * Request payload for updating a variant. PUT with a new id creates it (upsert).
  */
-export type VariantUpdateRequest = any;
+export interface VariantUpdateRequest {
+    name?: string;
+    [key: string]: any;
+}

package/dist/utils/paths.js

@@ -110,13 +110,9 @@ export function buildPortalPath(params) {
         // Batch object - extract id and expiryDate
         extractedBatchId = batch.id;
         if (batch.expiryDate) {
-            // Handle Firebase timestamp or Date
-            if (typeof batch.expiryDate === 'object' && 'seconds' in batch.expiryDate) {
-                expiryDate = new Date(batch.expiryDate.seconds * 1000);
-            }
-            else {
-                expiryDate = batch.expiryDate;
-            }
+            // Now an ISO string, but stay defensive about a legacy Firebase Timestamp object.
+            const exp = batch.expiryDate;
+            expiryDate = (exp && typeof exp === 'object' && 'seconds' in exp) ? new Date(exp.seconds * 1000) : exp;
         }
     }
     else if (batchId) {

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.16.0  |  Generated: 2026-09-01T12:28:06.435Z
+Version: 1.16.2  |  Generated: 2026-09-05T10:46:06.239Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3549,20 +3549,25 @@ interface FirebaseTimestamp {
 ```typescript
 interface BatchResponse {
   id: string                      // Batch ID
-  name?: string                   // Batch name
-  expiryDate?: FirebaseTimestamp | string  // Firebase timestamp or ISO 8601 date
-  productId?: string              // Product ID (for collection-level searches)
+  name?: string | null            // Batch name
+  expiryDate?: string | null
+  productId?: string              // Product ID
   collectionId?: string           // Collection ID
-  [key: string]: any              // Additional batch fields
+  createdAt?: string              // ISO 8601
+  updatedAt?: string              // ISO 8601
+  deleted?: boolean
+  deletedAt?: string              // ISO 8601
+  admin?: Record<string, any>
+  [key: string]: any              // Additional (schemaless) batch fields
 }
 ```
 
 **BatchCreateRequest** (interface)
 ```typescript
 interface BatchCreateRequest {
-  id: string                      // Batch ID
-  name?: string                   // Batch name
-  expiryDate?: FirebaseTimestamp | string  // Firebase timestamp or ISO 8601 date
+  id?: string
+  name?: string
+  expiryDate?: FirebaseTimestamp | string | Date
   [key: string]: any              // Additional batch fields
 }
 ```
@@ -3570,8 +3575,8 @@ interface BatchCreateRequest {
 **BatchUpdateRequest** (interface)
 ```typescript
 interface BatchUpdateRequest {
-  name?: string                   // Batch name
-  expiryDate?: FirebaseTimestamp | string  // Firebase timestamp or ISO 8601 date
+  name?: string
+  expiryDate?: FirebaseTimestamp | string | Date
   [key: string]: any              // Additional batch fields
 }
 ```
@@ -6389,6 +6394,7 @@ interface Lot {
   updatedBy?: string | null
   createdAt: string
   updatedAt: string
+  deletedAt?: string | null
 }
 ```
 
@@ -6412,6 +6418,7 @@ interface ListLotsParams {
   status?: LotStatus
   search?: string
   productId?: string
+  includeDeleted?: boolean
 }
 ```
 
@@ -7431,6 +7438,9 @@ interface ProductFieldsConfig {
 ```typescript
 interface ProofValues {
   [key: string]: JsonValue | Record<string, JsonValue> | Record<string, Record<string, JsonValue>> | undefined
+  * Owner-scoped: read/write by business + current owner; transfers with ownership.
+  * Read exception: while the proof is `claimable`, this bag is also readable by everyone
+  * (so a prospective claimer sees pre-set owner data); it reverts to owner-only once claimed.
   owner?: Record<string, JsonValue>
   personal?: Record<string, Record<string, JsonValue>>
 }
@@ -7489,6 +7499,15 @@ interface ProofCreateRequest {
 }
 ```
 
+**ProofValuesUpdateRequest** (interface)
+```typescript
+interface ProofValuesUpdateRequest {
+  [key: string]: JsonValue | Record<string, JsonValue> | undefined
+  owner?: Record<string, JsonValue>
+  personal?: Record<string, JsonValue>
+}
+```
+
 **ProofFieldsConfig** (interface)
 ```typescript
 interface ProofFieldsConfig {
@@ -8151,11 +8170,38 @@ interface TranslationUpdateRequest {
 
 ### variant
 
-**VariantResponse** = `any`
+**VariantResponse** (interface)
+```typescript
+interface VariantResponse {
+  id: string
+  name?: string | null
+  productId?: string
+  collectionId?: string
+  createdAt?: string              // ISO 8601
+  updatedAt?: string              // ISO 8601
+  deleted?: boolean
+  deletedAt?: string              // ISO 8601
+  admin?: Record<string, any>
+  [key: string]: any              // Additional (schemaless) variant fields
+}
+```
 
-**VariantCreateRequest** = `any`
+**VariantCreateRequest** (interface)
+```typescript
+interface VariantCreateRequest {
+  id?: string
+  name?: string
+  [key: string]: any
+}
+```
 
-**VariantUpdateRequest** = `any`
+**VariantUpdateRequest** (interface)
+```typescript
+interface VariantUpdateRequest {
+  name?: string
+  [key: string]: any
+}
+```
 
 ### widgets
 
@@ -9898,17 +9944,23 @@ Create a lot (resolves its selector into members).
 **list**(collectionId: string, params: ListLotsParams = {}) → `Promise<Lot[]>`
 List lots (summary rows; `payload`/`productIds` omitted). Filter by status, search, or containing productId.
 
-**get**(collectionId: string, lotId: string) → `Promise<Lot>`
-Get the full lot record.
+**get**(collectionId: string, lotId: string, opts: { includeDeleted?: boolean } = {}) → `Promise<Lot>`
+Get the full lot record. Pass `{ includeDeleted: true }` to fetch a soft-deleted one.
 
-**getByNumber**(collectionId: string, lotNumber: string) → `Promise<Lot>`
+**getByNumber**(collectionId: string, lotNumber: string, opts: { includeDeleted?: boolean } = {}) → `Promise<Lot>`
 Look up a lot by its number (case-insensitive) — used by scan/resolver flows.
 
 **update**(collectionId: string, lotId: string, lot: LotUpdateInput) → `Promise<Lot>`
 Update a lot. Re-resolves members if the selector changed (response then carries `diff`).
 
+**remove**(collectionId: string, lotId: string) → `Promise<`
+Soft-delete a lot — recoverable, and frees its `lotNumber` for reuse. Distinct from {@link archive}. Hidden from reads unless `{ includeDeleted: true }`; undo with {@link restore}.
+
 **archive**(collectionId: string, lotId: string) → `Promise<`
-Soft-archive a lot (never deletes members).
+Archive a lot — a live lifecycle state (stays visible, keeps its number). Not a delete.
+
+**restore**(collectionId: string, lotId: string) → `Promise<Lot>`
+Restore a soft-deleted lot. Rejects (409) if a live lot now uses the same number.
 
 **resolve**(collectionId: string, lotId: string) → `Promise<ResolveLotResponse>`
 Re-resolve members from the current selector; returns the lot + a member diff.
@@ -10301,6 +10353,12 @@ Create a proof for a product (admin only). POST /admin/collection/:collectionId/
     values: ProofUpdateRequest) → `Promise<ProofResponse>`
 Update a proof for a product (admin only). PUT /admin/collection/:collectionId/product/:productId/proof/:proofId Pass the fields to change **at the root**, keyed by zone (see {@link ProofWrite}): ```ts proof.update(collectionId, productId, proofId, { data:   { serialNo: 1002 },   // → proof.data (admin-only writable) values: { colour: 'blue' },   // → proof.values }) ``` Object zones deep-merge, so you can change one field without wiping the rest.
 
+**updateValues**(collectionId: string,
+    productId: string,
+    proofId: string,
+    values: ProofValuesUpdateRequest) → `Promise<ProofResponse>`
+Owner self-service update of a proof's owner-writable data. PUT /public/collection/:collectionId/product/:productId/proof/:proofId/values The public counterpart to admin `update` — the current OWNER (or a collection admin) editing their own proof, no admin credentials required. Only owner-writable zones are honoured (see {@link ProofValuesUpdateRequest}): ```ts proof.updateValues(collectionId, productId, proofId, { colour:   'blue',            // → proof.values.colour   (public) owner:    { warranty: '2y' }, // → proof.values.owner    (owner-scoped) personal: { nickname: 'Bo' }, // → proof.values.personal[callerUid] (private, own slot only) }) ``` `personal` always targets the caller's OWN slot — you cannot write another user's personal data, even as an admin. Object zones deep-merge (owner/personal merge field-by-field), so you can change one field without wiping the rest. Business-only zones (`data`/`admin`/`private`) are not writable here — use the admin `update` for those.
+
 **claim**(collectionId: string,
     productId: string,
     proofId: string,

package/docs/lots.md

@@ -18,9 +18,22 @@ truth for its shared data.
   - `{ mode: 'products', productIds: [...] }` — an explicit list.
 - **`productIds` / `productCount`** — the materialised snapshot of resolved members (re-resolved on create, on selector change, and on demand via `resolve`).
 - **`payload`** — shared lot data (dates, supplier ref, custom fields). Lives only on the lot.
-- **`status`** — `open` → `closed` → `recalled` → `archived`. Archiving never deletes anything.
+- **`status`** — `open` → `closed` → `recalled` → `archived`. A live lifecycle state, distinct from deletion.
 - **`destination`** — optional lot-level redirect; wins over the product's on a lot-scoped scan.
 
+### Archive vs delete
+
+Two separate ideas — mirroring the platform's `deletedAt` convention:
+
+| | `archive` (`status: 'archived'`) | `remove` (soft-delete, `deletedAt`) |
+|---|---|---|
+| Record | stays **live** & visible | **hidden** from reads unless `includeDeleted: true` |
+| `lotNumber` | **stays reserved** | **freed** for reuse by a new lot |
+| AI(10) scan | not resolved (excluded) | not resolved |
+| Reversible | change status back | `restore` (409 if the number was taken by a live lot) |
+
+Nothing is ever hard-deleted (joins/history stay intact). Use **archive** for "this run is done, keep it around"; use **remove** for "this was a mistake, and I want the number back."
+
 ---
 
 ## SDK — `SL.lots.*`
@@ -50,7 +63,11 @@ const containing  = await lots.list(collectionId, { productId: 'prd_abc' }) // r
 const updated     = await lots.update(collectionId, lot.id, { status: 'closed' })
 const { diff }    = await lots.resolve(collectionId, lot.id)               // { added, removed }
 const members     = await lots.listProducts(collectionId, lot.id, { page: 1, limit: 50 })
-await lots.archive(collectionId, lot.id)
+
+await lots.archive(collectionId, lot.id)                       // live, keeps its number
+await lots.remove(collectionId, lot.id)                        // soft-delete, frees the number
+const withDeleted = await lots.list(collectionId, { includeDeleted: true })
+const restored    = await lots.restore(collectionId, lot.id)   // undo a soft-delete
 
 // Cross-app reads
 const publicLots  = await lots.publicList(collectionId)

package/docs/proof-product-data-scoping.md

@@ -37,7 +37,8 @@ proof.admin = { … }        // BUSINESS-ONLY → read: business,       write: b
 proof.values = {           // consumer bag — owner + business-writable
   <anyKey>: …,              // PUBLIC        → read: everyone,
                              //                write: business + current owner
-  owner: { … },              // OWNER-SCOPED  → read: business + current owner,
+  owner: { … },              // OWNER-SCOPED  → read: business + current owner
+                             //                (also everyone while `claimable`, see below),
                              //                write: business + current owner,
                              //                transfers with ownership
   personal: {                // PER-USER      → read/write: only the specific user,
@@ -75,10 +76,12 @@ The field-config editor and SDK write helpers MUST reject attempts to create top
 | `proof.data.*`                    |         ✅          |             ✅             |       ✅       |        ✅       |
 | `proof.admin.*`                   |         ❌          |             ❌             |       ❌       |        ✅       |
 | `proof.values.<publicKey>`        |         ✅          |             ✅             |       ✅       |        ✅       |
-| `proof.values.owner.*`            |         ❌          |             ❌             |       ✅       |        ✅       |
+| `proof.values.owner.*`            |        ❌ †         |            ❌ †            |       ✅       |        ✅       |
 | `proof.values.personal[me].*`     |         ❌          |     ✅ (own slot only)     | ✅ (own slot)  | ❌ (see note)   |
 | `proof.values.personal[other].*`  |         ❌          |             ❌             |       ❌       | ❌ (see note)   |
 
+> **† Claimable exception (`proof.values.owner.*`):** while a proof is **claimable** (`proof.claimable === true` *or* `proof.values.claimable === true`), its `owner` bag is returned to **everyone** — public/anonymous and authenticated non-owners included — so a prospective claimer can see pre-set owner data before claiming. Once the proof is claimed (`claimable` flips off) it reverts to owner-only (unless re-marked claimable). This is **read-only** exposure — write authority is unchanged (still owner + business). Implication: don't put anything in `values.owner` on a claimable proof that shouldn't be visible before it's claimed.
+>
 > **Note on `personal`:** the default rule is that `personal` slots are readable *only* by the user whose `userId` matches the slot key — not even business admins. If the platform ever needs an admin-visible variant, it should be a separate mechanism, not a relaxation of this rule.
 
 ## Who writes what (authority matrix)

package/openapi.yaml

@@ -4996,6 +4996,38 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/collection/{collectionId}/lots/{lotId}/restore:
+    post:
+      tags:
+        - lots
+      summary: Restore a soft-deleted lot.
+      operationId: lots_restore
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: lotId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Lot"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/collection/{collectionId}/lots{params}:
     get:
       tags:
@@ -12611,6 +12643,48 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /public/collection/{collectionId}/product/{productId}/proof/{proofId}/values:
+    put:
+      tags:
+        - proof
+      summary: proof.updateValues
+      operationId: proof_updateValues
+      security: []
+      parameters:
+        - name: collectionId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: productId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: proofId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ProofResponse"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ProofValuesUpdateRequest"
   /public/collection/{collectionId}/products/{productId}/createClaim:
     post:
       tags:
@@ -19810,12 +19884,22 @@ components:
         name:
           type: string
         expiryDate:
-          type: object
-          additionalProperties: true
+          type: string
         productId:
           type: string
         collectionId:
           type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        deleted:
+          type: boolean
+        deletedAt:
+          type: string
+        admin:
+          type: object
+          additionalProperties: true
       required:
         - id
     BatchCreateRequest:
@@ -19828,8 +19912,6 @@ components:
         expiryDate:
           type: object
           additionalProperties: true
-      required:
-        - id
     BatchUpdateRequest:
       type: object
       properties:
@@ -23737,6 +23819,8 @@ components:
           type: string
         updatedAt:
           type: string
+        deletedAt:
+          type: string
       required:
         - id
         - collectionId
@@ -23777,6 +23861,8 @@ components:
           type: string
         productId:
           type: string
+        includeDeleted:
+          type: boolean
     ListLotsResponse:
       type: object
       properties:
@@ -25620,6 +25706,17 @@ components:
           type: object
           additionalProperties:
             $ref: "#/components/schemas/JsonValue"
+    ProofValuesUpdateRequest:
+      type: object
+      properties:
+        owner:
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/JsonValue"
+        personal:
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/JsonValue"
     ProofFieldsConfig:
       type: object
       properties:
@@ -26654,6 +26751,42 @@ components:
         metadata:
           type: object
           additionalProperties: true
+    VariantResponse:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        productId:
+          type: string
+        collectionId:
+          type: string
+        createdAt:
+          type: string
+        updatedAt:
+          type: string
+        deleted:
+          type: boolean
+        deletedAt:
+          type: string
+        admin:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+    VariantCreateRequest:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+    VariantUpdateRequest:
+      type: object
+      properties:
+        name:
+          type: string
     NavigationRequest:
       type: object
       properties:

package/package.json

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