@proveanything/smartlinks 2.1.15 → 2.1.17

package/dist/openapi.yaml

@@ -9141,6 +9141,35 @@ paths:
           description: Unauthorized
         404:
           description: Not found
+  /admin/partner/{partnerId}/tags/attempts:
+    get:
+      tags:
+        - partner
+      summary: "What phones reported about one chip (errors.report with entityType 'tag'), newest first: a tag that failed to program or register, with the host's NFC log in context."
+      operationId: partner_tagAttempts
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: partnerId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ClientErrorEvent"
+        400:
+          description: Bad request
+        401:
+          description: Unauthorized
+        404:
+          description: Not found
   /admin/partner/{partnerId}/tags/lookup:
     get:
       tags:
@@ -14952,6 +14981,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 +15102,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:
@@ -20764,6 +20857,56 @@ components:
       required:
         - slots
         - blocks
+    AppHistoryEvent:
+      type: object
+      properties:
+        id:
+          type: string
+        at:
+          type: string
+        type:
+          type: string
+        entityId:
+          type: string
+        data:
+          type: object
+          additionalProperties: true
+        actorType:
+          type: string
+          enum:
+            - user
+            - contact
+        actorId:
+          type: string
+      required:
+        - id
+        - at
+        - type
+        - entityId
+        - data
+        - actorType
+        - actorId
+    AppHistoryQuery:
+      type: object
+      properties:
+        types:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+        entityId:
+          type: string
+        data:
+          type: object
+          additionalProperties:
+            type: object
+            additionalProperties: true
+        from:
+          type: string
+        to:
+          type: string
+        limit:
+          type: number
     ServerFunctionSl:
       type: object
       properties:
@@ -20772,6 +20915,9 @@ components:
         appRecords:
           type: object
           additionalProperties: true
+        history:
+          type: object
+          additionalProperties: true
         counters:
           $ref: "#/components/schemas/ServerFunctionCounters"
         tags:
@@ -20793,6 +20939,7 @@ components:
       required:
         - bookings
         - appRecords
+        - history
         - counters
         - tags
         - contacts
@@ -21568,6 +21715,9 @@ components:
       enum:
         - caller
         - collection
+    RecordTransactionOp:
+      type: object
+      additionalProperties: true
     PaginatedResponse:
       type: object
       properties:
@@ -21617,6 +21767,19 @@ components:
         expires_at:
           type: object
           additionalProperties: true
+        updated_at:
+          type: object
+          additionalProperties: true
+        data:
+          type: object
+          additionalProperties:
+            type: object
+            additionalProperties: true
+        dataRange:
+          type: object
+          additionalProperties:
+            type: object
+            additionalProperties: true
         groupBy:
           type: array
           items:
@@ -25919,6 +26082,8 @@ components:
           type: string
         namespace:
           type: string
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         notes:
@@ -25972,6 +26137,7 @@ components:
         - id
         - claimSetId
         - namespace
+        - kind
         - name
         - notes
         - startIndex
@@ -25995,6 +26161,8 @@ components:
     CreateClaimSetRangeRequest:
       type: object
       properties:
+        kind:
+          $ref: "#/components/schemas/ClaimSetRangeKind"
         name:
           type: string
         quantity:
@@ -26018,7 +26186,6 @@ components:
           type: string
       required:
         - name
-        - quantity
     UpdateClaimSetRangeRequest:
       type: object
       properties:
@@ -26062,6 +26229,10 @@ components:
           type: string
         proofId:
           type: string
+        rangeId:
+          type: string
+        groupId:
+          type: string
         programmedAt:
           type: string
         scans:
@@ -26075,6 +26246,8 @@ components:
         - productId
         - batchId
         - proofId
+        - rangeId
+        - groupId
         - programmedAt
         - scans
     ClaimSetRangeTagsPage:
@@ -26103,6 +26276,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:
@@ -26272,12 +26480,15 @@ components:
           $ref: "#/components/schemas/ClaimSetRangeTag"
         range:
           $ref: "#/components/schemas/ClaimSetRange"
+        group:
+          $ref: "#/components/schemas/ClaimSetRange"
       required:
         - namespace
         - claimSetId
         - set
         - tag
         - range
+        - group
     CreatePartnerClaimSetRequest:
       type: object
       properties:
@@ -26303,6 +26514,12 @@ components:
         - ntag424
         - ntag21x
         - qr
+    ClaimSetRangeKind:
+      type: string
+      enum:
+        - range
+        - open
+        - group
     ClaimSetRangeStatus:
       type: string
       enum:
@@ -26311,6 +26528,11 @@ components:
         - sent
         - received
         - assigned
+        - open
+        - group
+    CloseClaimSetRangeResponse:
+      type: object
+      additionalProperties: true
     ClaimSetImportResult:
       type: string
       enum:
@@ -26324,6 +26546,92 @@ components:
         - duplicate_uid
         - uid_in_use
         - uid_conflict
+    ClientErrorReport:
+      type: object
+      properties:
+        app:
+          type: string
+        appVersion:
+          type: string
+        collectionId:
+          type: string
+        operation:
+          type: string
+        severity:
+          type: string
+          enum:
+            - debug
+            - info
+            - warning
+            - error
+            - critical
+        errorCode:
+          type: string
+        errorType:
+          type: string
+        message:
+          type: string
+        stack:
+          type: string
+        entityType:
+          type: string
+        entityId:
+          type: string
+        labels:
+          type: object
+          additionalProperties: true
+        context:
+          type: object
+          additionalProperties: true
+        refId:
+          type: string
+        correlationId:
+          type: string
+    ClientErrorEvent:
+      type: object
+      properties:
+        id:
+          type: string
+        time:
+          type: string
+        event_category:
+          type: string
+        event_action:
+          type: string
+        log_level:
+          type: string
+        error_code:
+          type: string
+        error_message:
+          type: string
+        service_name:
+          type: string
+        service_version:
+          type: string
+        collection_id:
+          type: string
+        user_id:
+          type: string
+        labels:
+          type: object
+          additionalProperties: true
+        context:
+          type: object
+          additionalProperties: true
+      required:
+        - id
+        - time
+        - event_category
+        - event_action
+        - log_level
+        - error_code
+        - error_message
+        - service_name
+        - service_version
+        - collection_id
+        - user_id
+        - labels
+        - context
     Collection:
       type: object
       properties:

package/dist/testing/index.d.ts

@@ -16,7 +16,11 @@ export interface TestSlImpl {
         get?(id: string): any;
         query?(params: any): any;
         listTypes?(): any;
+        adjust?(id: string, by: Record<string, number>, opts?: any): any;
+        aggregate?(params?: any): any;
     };
+    /** ctx.sl.transaction(ops, { idempotencyKey }) — defaults to the in-memory one (all or none, replay by key). */
+    transaction?(ops: any[], opts?: any): any;
     counters?: {
         next?(name: string, opts?: any): any;
         get?(name: string): any;
@@ -108,6 +112,18 @@ export interface FunctionTestMemory {
     interactions: any[];
     /** Slots, bookings and allocations of the in-memory bookings engine. */
     bookings: BookingsMemory;
+    /** ctx.sl.transaction results by idempotency key (a repeat replays them). */
+    transactions: Record<string, any[]>;
+    /** ctx.sl.history events (log ops and history.log), oldest first. */
+    history: Array<{
+        id: string;
+        at: string;
+        type: string;
+        entityId: string | null;
+        data: Record<string, any>;
+        actorType: null;
+        actorId: null;
+    }>;
 }
 /** A fresh in-memory store — pass the same one to several test contexts to simulate concurrent callers. */
 export declare function createFunctionTestMemory(): FunctionTestMemory;

package/dist/testing/index.js

@@ -77,7 +77,7 @@ function allowsSl(p, resource, op) {
 }
 /** A fresh in-memory store — pass the same one to several test contexts to simulate concurrent callers. */
 export function createFunctionTestMemory() {
-    return { records: [], counters: {}, contacts: [], interactions: [], bookings: createBookingsMemory() };
+    return { records: [], counters: {}, contacts: [], interactions: [], bookings: createBookingsMemory(), transactions: {}, history: [] };
 }
 const stub = (method, args) => ({ __stub: true, method, args });
 /**
@@ -101,6 +101,9 @@ export function createFunctionTestContext(opts) {
         return fn ? fn(...args) : stub(`${resource}.${name}`, args);
     };
     const mem = opts.memory || createFunctionTestMemory();
+    // A memory built before history / transactions existed still works.
+    mem.history = mem.history || [];
+    mem.transactions = mem.transactions || {};
     const ar = impl.appRecords || {};
     const pr = impl.products || {};
     const at = impl.attestations || {};
@@ -147,6 +150,60 @@ export function createFunctionTestContext(opts) {
             return null; Object.assign(r, fields); return Object.assign({}, r); },
         delete: async (id) => { const r = mem.records.find((x) => x.id === id); if (r)
             r.deletedAt = new Date().toISOString(); return {}; },
+        // Numbers in data changed in place, with atLeast / atMost checked after the change (as the platform).
+        adjust: async (id, by = {}, opts = {}) => {
+            var _a, _b;
+            const r = mem.records.find((x) => x.id === id && !x.deletedAt);
+            if (!r)
+                throw Object.assign(new Error('Record not found'), { code: 'NOT_FOUND', statusCode: 404 });
+            const data = r.data || {};
+            const keys = [...new Set([...Object.keys(by), ...Object.keys(opts.atLeast || {}), ...Object.keys(opts.atMost || {})])];
+            const bad = keys.find((k) => data[k] != null && typeof data[k] !== 'number');
+            if (bad)
+                throw Object.assign(new Error(`data.${bad} isn't a number, so it can't be adjusted`), { code: 'NOT_A_NUMBER', statusCode: 400, key: bad });
+            const next = {};
+            for (const k of keys)
+                next[k] = ((_a = data[k]) !== null && _a !== void 0 ? _a : 0) + ((_b = by[k]) !== null && _b !== void 0 ? _b : 0);
+            const broken = Object.entries(opts.atLeast || {}).some(([k, n]) => next[k] < n) || Object.entries(opts.atMost || {}).some(([k, n]) => next[k] > n);
+            if (broken)
+                throw Object.assign(new Error('The change would break its condition (atLeast / atMost)'), { code: 'CONDITION_FAILED', statusCode: 409, current: Object.fromEntries(keys.map((k) => { var _a; return [k, (_a = data[k]) !== null && _a !== void 0 ? _a : 0]; })) });
+            r.data = Object.assign(Object.assign({}, data), Object.fromEntries(Object.keys(by).map((k) => [k, next[k]])));
+            return Object.assign({}, r);
+        },
+        // count / sum: / avg: / min: / max: over data numbers, grouped by top-level fields or data keys
+        // ('data.location'); filters.data (exact) as the platform. A simple stand-in for tests.
+        aggregate: async (params = {}) => {
+            const { groupBy = [], metrics = ['count'], filters = {} } = params || {};
+            const rows = mem.records.filter((r) => !r.deletedAt &&
+                (!filters.record_type || r.recordType === filters.record_type) &&
+                (!filters.status || r.status === filters.status) &&
+                Object.entries(filters.data || {}).every(([k, v]) => (Array.isArray(v) ? v.map(String) : [String(v)]).includes(String((r.data || {})[k]))));
+            const field = (r, f) => (f.startsWith('data.') ? (r.data || {})[f.slice(5)] : r[f === 'record_type' ? 'recordType' : f]);
+            const measure = (set) => {
+                const out = {};
+                for (const m of metrics) {
+                    if (m === 'count') {
+                        out.count = set.length;
+                        continue;
+                    }
+                    const [fn, key] = String(m).split(':');
+                    const nums = set.map((r) => (r.data || {})[key]).filter((v) => typeof v === 'number');
+                    const sum = nums.reduce((a, b) => a + b, 0);
+                    out[`${fn}_${key}`] = !nums.length ? null : fn === 'sum' ? sum : fn === 'avg' ? sum / nums.length : fn === 'min' ? Math.min(...nums) : Math.max(...nums);
+                }
+                return out;
+            };
+            if (!groupBy.length)
+                return measure(rows);
+            const buckets = new Map();
+            for (const r of rows) {
+                const key = JSON.stringify(groupBy.map((f) => { var _a; return (_a = field(r, f)) !== null && _a !== void 0 ? _a : null; }));
+                if (!buckets.has(key))
+                    buckets.set(key, []);
+                buckets.get(key).push(r);
+            }
+            return { groups: [...buckets].map(([key, set]) => (Object.assign(Object.assign({}, Object.fromEntries(groupBy.map((f, i) => [f, JSON.parse(key)[i]]))), measure(set)))) };
+        },
         // Simple equality filter on top-level fields (recordType, proofId, customId, status, …).
         query: async (params = {}) => {
             const _a = params || {}, { limit, offset, sort } = _a, where = __rest(_a, ["limit", "offset", "sort"]);
@@ -158,6 +215,60 @@ export function createFunctionTestContext(opts) {
             return { data, pagination: { total: all.length, limit: size, offset: from, hasMore: from + data.length < all.length } };
         },
     };
+    // The app's history, in memory (newest first when read, like the platform).
+    let nextEventId = 1;
+    const memLog = (type, data = {}, opts = {}) => {
+        var _a;
+        if (typeof type !== 'string' || !/^[a-z][a-z0-9._-]{0,63}$/.test(type))
+            throw Object.assign(new Error('history type: lowercase letters, digits and . _ - (e.g. "stock.moved")'), { code: 'INVALID_INPUT', statusCode: 400 });
+        const ev = { id: `ev-${nextEventId++}`, at: new Date().toISOString(), type, entityId: (_a = opts.entityId) !== null && _a !== void 0 ? _a : null, data: data || {}, actorType: null, actorId: null };
+        mem.history.push(ev);
+        return { id: ev.id };
+    };
+    const memHistoryQuery = async (params = {}) => {
+        const types = params.types == null ? null : (Array.isArray(params.types) ? params.types : [params.types]);
+        return mem.history
+            .filter((e) => (!types || types.includes(e.type)) && (params.entityId == null || e.entityId === params.entityId) &&
+            Object.entries(params.data || {}).every(([k, v]) => (Array.isArray(v) ? v.map(String) : [String(v)]).includes(String(e.data[k]))))
+            .slice().reverse().slice(0, params.limit || 100).map((e) => (Object.assign({}, e)));
+    };
+    // All ops or none, like the platform: records are restored when an op fails; a repeat of an
+    // idempotencyKey replays the first results.
+    const memTransaction = async (ops, opts = {}) => {
+        const key = opts.idempotencyKey;
+        if (key && mem.transactions[key])
+            return { results: mem.transactions[key], replayed: true };
+        const before = JSON.parse(JSON.stringify(mem.records));
+        const historyBefore = mem.history.length;
+        const results = [];
+        for (let i = 0; i < ops.length; i++) {
+            const o = ops[i] || {};
+            try {
+                if (o.op === 'create')
+                    results.push(await memRecords.create(o.record || {}));
+                else if (o.op === 'update')
+                    results.push(await memRecords.update(o.recordId, o.fields || {}));
+                else if (o.op === 'adjust')
+                    results.push(await memRecords.adjust(o.recordId, o.by, { atLeast: o.atLeast, atMost: o.atMost }));
+                else if (o.op === 'delete') {
+                    await memRecords.delete(o.recordId);
+                    results.push({ deleted: o.recordId });
+                }
+                else if (o.op === 'log')
+                    results.push({ logged: memLog(o.type, o.data, { entityId: o.entityId }).id });
+                else
+                    throw Object.assign(new Error(`ops[${i}].op must be create, update, adjust, delete or log`), { code: 'INVALID_INPUT', statusCode: 400 });
+            }
+            catch (err) {
+                mem.records.splice(0, mem.records.length, ...before);
+                mem.history.splice(historyBefore);
+                throw Object.assign(err, { opIndex: i });
+            }
+        }
+        if (key)
+            mem.transactions[key] = results;
+        return { results, replayed: false };
+    };
     const recordsFn = (name) => ar[name] ? ar[name].bind(ar) : (impl.appRecords ? undefined : memRecords[name]);
     const sl = {
         appRecords: {
@@ -169,6 +280,17 @@ export function createFunctionTestContext(opts) {
             get: gated('records', 'read', recordsFn('get'), 'get'),
             query: gated('records', 'read', recordsFn('query'), 'query'),
             listTypes: gated('records', 'read', recordsFn('listTypes'), 'listTypes'),
+            adjust: gated('records', 'write', recordsFn('adjust'), 'adjust'),
+            aggregate: gated('records', 'read', recordsFn('aggregate'), 'aggregate'),
+        },
+        transaction: gated('records', 'write', impl.transaction ? impl.transaction : (impl.appRecords ? undefined : async (ops, opts) => {
+            if (Array.isArray(ops) && ops.some((o) => o && o.op === 'log') && !allowsSl(parsed, 'history', 'write'))
+                throw new CapabilityError('sl:history:write');
+            return memTransaction(ops, opts);
+        }), 'transaction'),
+        history: {
+            log: gated('history', 'write', async (type, data, opts) => memLog(type, data, opts), 'log'),
+            query: gated('history', 'read', memHistoryQuery, 'query'),
         },
         products: {
             get: gated('products', 'read', pr.get && pr.get.bind(pr), 'get'),