@hotmeshio/long-tail 0.30.4 → 0.31.0

package/build/api/escalations/index.d.ts

@@ -8,6 +8,7 @@ export { resolveEscalation, resolveBySignalKey, resolveByIds, resolveAllOrNone }
 export { resolveBatchItem, resolveBatchItemBySignalKey, resolveBatchItemByMetadata } from './resolve-batch';
 export { flagBatchItem, unflagBatchItem } from './batch-flag';
 export { runRosterAction, ROSTER_ACTION_OUTCOMES } from './roster-action';
+export { runRosterScan, ROSTER_SCAN_OUTCOMES } from './roster-scan';
 export { accumulateItem, accumulateItemBySignalKey, accumulateItemByMetadata, removeItem, removeItemBySignalKey, removeItemByMetadata, getEscalationItems, getEscalationItemsBySignalKey, itemsView, } from './accumulate';
 export { findByMetadata, claimByMetadata, resolveByMetadata } from './metadata';
 export { cancelSingleEscalation, bulkCancel } from './cancel';

package/build/api/escalations/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.aggregateByFacets = exports.claimByFacets = exports.claimGroups = exports.searchByFacets = exports.bulkCancel = exports.cancelSingleEscalation = exports.resolveByMetadata = exports.claimByMetadata = exports.findByMetadata = exports.itemsView = exports.getEscalationItemsBySignalKey = exports.getEscalationItems = exports.removeItemByMetadata = exports.removeItemBySignalKey = exports.removeItem = exports.accumulateItemByMetadata = exports.accumulateItemBySignalKey = exports.accumulateItem = exports.ROSTER_ACTION_OUTCOMES = exports.runRosterAction = exports.unflagBatchItem = exports.flagBatchItem = exports.resolveBatchItemByMetadata = exports.resolveBatchItemBySignalKey = exports.resolveBatchItem = exports.resolveAllOrNone = exports.resolveByIds = exports.resolveBySignalKey = exports.resolveEscalation = exports.bulkTriage = exports.bulkEscalate = exports.bulkUnassign = exports.bulkAssign = exports.bulkClaim = exports.updatePriority = exports.releaseExpiredClaims = exports.releaseEscalation = exports.claimEscalation = exports.getEscalationLookups = exports.escalateToRole = exports.getEscalationsByWorkflowId = exports.getEscalation = exports.getStationMetrics = exports.getEscalationStats = exports.listFacetValues = exports.listFacetKeys = exports.listDistinctTypes = exports.listAvailableEscalations = exports.listEscalations = exports.createEscalation = void 0;
-exports.getRelatedRows = exports.getRelatedAggregates = exports.timelineByFacet = void 0;
+exports.claimGroups = exports.searchByFacets = exports.bulkCancel = exports.cancelSingleEscalation = exports.resolveByMetadata = exports.claimByMetadata = exports.findByMetadata = exports.itemsView = exports.getEscalationItemsBySignalKey = exports.getEscalationItems = exports.removeItemByMetadata = exports.removeItemBySignalKey = exports.removeItem = exports.accumulateItemByMetadata = exports.accumulateItemBySignalKey = exports.accumulateItem = exports.ROSTER_SCAN_OUTCOMES = exports.runRosterScan = exports.ROSTER_ACTION_OUTCOMES = exports.runRosterAction = exports.unflagBatchItem = exports.flagBatchItem = exports.resolveBatchItemByMetadata = exports.resolveBatchItemBySignalKey = exports.resolveBatchItem = exports.resolveAllOrNone = exports.resolveByIds = exports.resolveBySignalKey = exports.resolveEscalation = exports.bulkTriage = exports.bulkEscalate = exports.bulkUnassign = exports.bulkAssign = exports.bulkClaim = exports.updatePriority = exports.releaseExpiredClaims = exports.releaseEscalation = exports.claimEscalation = exports.getEscalationLookups = exports.escalateToRole = exports.getEscalationsByWorkflowId = exports.getEscalation = exports.getStationMetrics = exports.getEscalationStats = exports.listFacetValues = exports.listFacetKeys = exports.listDistinctTypes = exports.listAvailableEscalations = exports.listEscalations = exports.createEscalation = void 0;
+exports.getRelatedRows = exports.getRelatedAggregates = exports.timelineByFacet = exports.aggregateByFacets = exports.claimByFacets = void 0;
 var create_1 = require("./create");
 Object.defineProperty(exports, "createEscalation", { enumerable: true, get: function () { return create_1.createEscalation; } });
 var list_1 = require("./list");
@@ -44,6 +44,9 @@ Object.defineProperty(exports, "unflagBatchItem", { enumerable: true, get: funct
 var roster_action_1 = require("./roster-action");
 Object.defineProperty(exports, "runRosterAction", { enumerable: true, get: function () { return roster_action_1.runRosterAction; } });
 Object.defineProperty(exports, "ROSTER_ACTION_OUTCOMES", { enumerable: true, get: function () { return roster_action_1.ROSTER_ACTION_OUTCOMES; } });
+var roster_scan_1 = require("./roster-scan");
+Object.defineProperty(exports, "runRosterScan", { enumerable: true, get: function () { return roster_scan_1.runRosterScan; } });
+Object.defineProperty(exports, "ROSTER_SCAN_OUTCOMES", { enumerable: true, get: function () { return roster_scan_1.ROSTER_SCAN_OUTCOMES; } });
 var accumulate_1 = require("./accumulate");
 Object.defineProperty(exports, "accumulateItem", { enumerable: true, get: function () { return accumulate_1.accumulateItem; } });
 Object.defineProperty(exports, "accumulateItemBySignalKey", { enumerable: true, get: function () { return accumulate_1.accumulateItemBySignalKey; } });

package/build/api/escalations/roster-action.d.ts

@@ -1,4 +1,5 @@
 import type { LTApiAuth, LTApiResult } from '../../types/sdk';
+import type { LTEscalationRecord } from '../../types';
 /** Outcomes a roster action answers with besides the act's own result. */
 export declare const ROSTER_ACTION_OUTCOMES: {
     /** The action is limited to roles the person acting does not hold, and no badge rode the request. */
@@ -35,3 +36,13 @@ export interface RosterActionInput {
  * act that does not land returns the use.
  */
 export declare function runRosterAction(input: RosterActionInput, auth: LTApiAuth): Promise<LTApiResult>;
+/** The host row and one field of its pinned form, or null when the row is gone or unreadable. */
+export declare function loadHostField(id: string, field: string, auth: LTApiAuth): Promise<{
+    host: LTEscalationRecord;
+    fieldSchema: Record<string, unknown> | undefined;
+} | null>;
+/** Spend the badge, run the act, and return the use when the act does not land. */
+export declare function spendAndRun(actingToken: string | undefined, run: () => Promise<LTApiResult>): Promise<LTApiResult>;
+/** The person acting: the badge's person when one rides the request, read without spending it. */
+export declare function actorFor(actingToken: string | undefined, auth: LTApiAuth): Promise<LTApiAuth | LTApiResult>;
+export declare function refusal(status: number, outcome: string, error: string): LTApiResult;

package/build/api/escalations/roster-action.js

@@ -35,6 +35,10 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ROSTER_ACTION_OUTCOMES = void 0;
 exports.runRosterAction = runRosterAction;
+exports.loadHostField = loadHostField;
+exports.spendAndRun = spendAndRun;
+exports.actorFor = actorFor;
+exports.refusal = refusal;
 const escalationService = __importStar(require("../../services/escalation"));
 const userService = __importStar(require("../../services/user"));
 const roster_1 = require("../../services/escalation/roster");
@@ -77,14 +81,10 @@ async function runRosterAction(input, auth) {
             return { status: 400, error: 'id, field, action and entry are required' };
         }
         // 1. The host row and its form, as the page that offered the action read them
-        const detail = await escalationService.getEscalationWithFormSchema(input.id);
-        if (!detail || (await (0, helpers_1.assertReadAccess)(auth.userId, detail.escalation))) {
+        const loaded = await loadHostField(input.id, input.field, auth);
+        if (!loaded)
             return { status: 404, error: 'Escalation not found' };
-        }
-        const host = detail.escalation;
-        const embedded = host.metadata?.form_schema;
-        const schema = (embedded && typeof embedded === 'object' ? embedded : detail.form_schema);
-        const fieldSchema = schema?.properties?.[input.field];
+        const { host, fieldSchema } = loaded;
         const def = (0, form_validation_1.readRosterDef)(fieldSchema);
         const action = (0, form_validation_1.readRosterActions)(fieldSchema)[input.action];
         if (!def || !action)
@@ -104,40 +104,57 @@ async function runRosterAction(input, auth) {
             return { status: 422, error, data: { error, outcome: 'code_mismatch' } };
         }
         // 3. The person acting: the badge's person when one rides the request, read without spending it
-        let actor = auth;
-        if (input.actingToken) {
-            const peeked = await (0, acting_identity_1.peekActingAuth)(input.actingToken);
-            if (!peeked.ok)
-                return refusal(401, exports.ROSTER_ACTION_OUTCOMES.NOT_PRIMED, peeked.error);
-            actor = peeked.auth;
-        }
+        const actor = await actorFor(input.actingToken, auth);
+        if ('status' in actor)
+            return actor;
         if (!(await holdsRole(action, actor.userId))) {
             return input.actingToken
                 ? refusal(403, exports.ROSTER_ACTION_OUTCOMES.ROLE_REFUSED, (0, form_validation_1.actionRefusal)(action))
                 : refusal(403, exports.ROSTER_ACTION_OUTCOMES.NEEDS_BADGE, (0, form_validation_1.actionRefusal)(action));
         }
         // 4. Spend the badge, run the act, and return the use when it does not land
-        let remaining;
-        if (input.actingToken) {
-            const spent = await (0, acting_identity_1.consumeActingGrant)(input.actingToken);
-            if (!spent.ok)
-                return refusal(401, exports.ROSTER_ACTION_OUTCOMES.NOT_PRIMED, spent.error);
-            remaining = spent.grant.remaining;
-        }
-        const result = await runAct(kind, action, entry, host.id, ctx, input.code, actor);
-        if (input.actingToken && result.status >= 300) {
-            await (0, acting_identity_1.refundActingGrant)(input.actingToken, false);
-            return result;
-        }
-        if (input.actingToken && result.data && typeof result.data === 'object') {
-            result.data = { ...result.data, acting: { remaining } };
-        }
-        return result;
+        return spendAndRun(input.actingToken, () => runAct(kind, action, entry, host.id, ctx, input.code, actor));
     }
     catch (err) {
         return { status: 500, error: err.message };
     }
 }
+/** The host row and one field of its pinned form, or null when the row is gone or unreadable. */
+async function loadHostField(id, field, auth) {
+    const detail = await escalationService.getEscalationWithFormSchema(id);
+    if (!detail || (await (0, helpers_1.assertReadAccess)(auth.userId, detail.escalation)))
+        return null;
+    const host = detail.escalation;
+    const embedded = host.metadata?.form_schema;
+    const schema = (embedded && typeof embedded === 'object' ? embedded : detail.form_schema);
+    return { host, fieldSchema: schema?.properties?.[field] };
+}
+/** Spend the badge, run the act, and return the use when the act does not land. */
+async function spendAndRun(actingToken, run) {
+    let remaining;
+    if (actingToken) {
+        const spent = await (0, acting_identity_1.consumeActingGrant)(actingToken);
+        if (!spent.ok)
+            return refusal(401, exports.ROSTER_ACTION_OUTCOMES.NOT_PRIMED, spent.error);
+        remaining = spent.grant.remaining;
+    }
+    const result = await run();
+    if (actingToken && result.status >= 300) {
+        await (0, acting_identity_1.refundActingGrant)(actingToken, false);
+        return result;
+    }
+    if (actingToken && result.data && typeof result.data === 'object') {
+        result.data = { ...result.data, acting: { remaining } };
+    }
+    return result;
+}
+/** The person acting: the badge's person when one rides the request, read without spending it. */
+async function actorFor(actingToken, auth) {
+    if (!actingToken)
+        return auth;
+    const peeked = await (0, acting_identity_1.peekActingAuth)(actingToken);
+    return peeked.ok ? peeked.auth : refusal(401, exports.ROSTER_ACTION_OUTCOMES.NOT_PRIMED, peeked.error);
+}
 async function holdsRole(action, userId) {
     if (!action.roles?.length)
         return true;

package/build/api/escalations/roster-scan.d.ts

@@ -0,0 +1,26 @@
+import type { LTApiAuth, LTApiResult } from '../../types/sdk';
+/** Outcomes a roster scan answers with besides the fill's own result. */
+export declare const ROSTER_SCAN_OUTCOMES: {
+    /** The field takes no scans, or not this code's scheme. */
+    readonly NOT_ACCEPTED: "not_accepted";
+    /** No open entry on the list is this code. */
+    readonly UNEXPECTED: "unexpected";
+};
+export interface RosterScanInput {
+    /** The host row: the escalation whose form declares the roster. */
+    id: string;
+    /** The roster field. */
+    field: string;
+    /** The code as scanned. */
+    code: string;
+    /** A badge grant: the fill runs as its person. */
+    actingToken?: string;
+}
+/**
+ * A scan into a batch roster on an open form. The field must declare
+ * `x-lt-scan` accepting the code's scheme; the scan fills the first open
+ * entry whose key is that code, as the person acting, with `scannedCode` as
+ * the entry's payload. Nothing about the request is trusted: the roster and
+ * its entries are re-read from the host row.
+ */
+export declare function runRosterScan(input: RosterScanInput, auth: LTApiAuth): Promise<LTApiResult>;

package/build/api/escalations/roster-scan.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROSTER_SCAN_OUTCOMES = void 0;
+exports.runRosterScan = runRosterScan;
+const scanCodeService = __importStar(require("../../services/scan-code"));
+const roster_1 = require("../../services/escalation/roster");
+const form_validation_1 = require("../../shared/form-validation");
+const types_1 = require("../../types");
+const roster_action_1 = require("./roster-action");
+const resolve_batch_1 = require("./resolve-batch");
+/** Outcomes a roster scan answers with besides the fill's own result. */
+exports.ROSTER_SCAN_OUTCOMES = {
+    /** The field takes no scans, or not this code's scheme. */
+    NOT_ACCEPTED: 'not_accepted',
+    /** No open entry on the list is this code. */
+    UNEXPECTED: 'unexpected',
+};
+const STOCK_UNEXPECTED = 'Not one of the items expected here.';
+/** A batch fill whose key was filled since the roster was read. */
+const DUPLICATE_ITEM = 'duplicate-item';
+function refused(status, outcome, error) {
+    return { status, error, data: { error, outcome } };
+}
+/**
+ * A scan into a batch roster on an open form. The field must declare
+ * `x-lt-scan` accepting the code's scheme; the scan fills the first open
+ * entry whose key is that code, as the person acting, with `scannedCode` as
+ * the entry's payload. Nothing about the request is trusted: the roster and
+ * its entries are re-read from the host row.
+ */
+async function runRosterScan(input, auth) {
+    try {
+        if (!input?.id || typeof input.field !== 'string' || typeof input.code !== 'string' || !input.code.trim()) {
+            return { status: 400, error: 'id, field and code are required' };
+        }
+        // 1. The host row and a batch roster that takes this code's scheme
+        const loaded = await (0, roster_action_1.loadHostField)(input.id, input.field, auth);
+        if (!loaded)
+            return { status: 404, error: 'Escalation not found' };
+        const def = (0, form_validation_1.readRosterDef)(loaded.fieldSchema);
+        const sink = (0, form_validation_1.readScanSink)(loaded.fieldSchema);
+        if (!def || !('batch' in def.expected) || !sink) {
+            return refused(409, exports.ROSTER_SCAN_OUTCOMES.NOT_ACCEPTED, 'This list takes no scans');
+        }
+        const parsed = scanCodeService.parseScanCode(input.code.trim(), await scanCodeService.listScanSchemes());
+        if (!parsed.ok || parsed.scheme.kind !== types_1.SCAN_SCHEME_KINDS.ACTION || !sink.schemes.includes(parsed.parsed.version)) {
+            return refused(422, exports.ROSTER_SCAN_OUTCOMES.NOT_ACCEPTED, 'This list takes no code like that');
+        }
+        const value = sink.value === 'code' ? (parsed.parsed.raw ?? input.code.trim()) : parsed.parsed.target;
+        // 2. The open entries this code names, on the roster the server computes
+        const { escalation, metadata, envelope, payload } = (0, form_validation_1.rosterRowContext)(loaded.host);
+        const ctx = { escalation, metadata, envelope, payload };
+        const roster = await (0, roster_1.loadRoster)(def, ctx);
+        const named = roster.entries.filter((e) => (0, form_validation_1.enteredCodeMatches)(value, e.key, def.countedBy));
+        const open = named.filter((e) => e.state !== form_validation_1.ROSTER_STATES.IN);
+        if (open.length === 0) {
+            const error = named.length ? `All ${named.length} of these are already checked off.` : STOCK_UNEXPECTED;
+            return refused(422, exports.ROSTER_SCAN_OUTCOMES.UNEXPECTED, error);
+        }
+        // 3. Fill as the person acting; an entry taken since the read moves to the next
+        const actor = await (0, roster_action_1.actorFor)(input.actingToken, auth);
+        if ('status' in actor)
+            return actor;
+        return (0, roster_action_1.spendAndRun)(input.actingToken, async () => {
+            let result = { status: 409, error: 'Those entries were just checked off' };
+            for (const entry of open) {
+                result = await (0, resolve_batch_1.resolveBatchItem)({
+                    id: loaded.host.id,
+                    itemKey: entry.key,
+                    resolverPayload: { scannedCode: input.code.trim() },
+                }, actor);
+                if (result.data?.outcome !== DUPLICATE_ITEM)
+                    return result;
+            }
+            return result;
+        });
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/api/labels/errors.d.ts

@@ -0,0 +1,3 @@
+import type { LTApiResult } from '../../types/sdk';
+/** A refused label request as an API result; anything else is a 500. */
+export declare function labelFailure(err: any): LTApiResult;

package/build/api/labels/errors.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.labelFailure = labelFailure;
+const labels_1 = require("../../services/labels");
+/** A refused label request as an API result; anything else is a 500. */
+function labelFailure(err) {
+    if (err instanceof labels_1.LabelRequestError)
+        return { status: err.status, error: err.message };
+    if (err instanceof labels_1.LabelTemplateValidationError || err instanceof labels_1.LabelTemplateConflictError) {
+        return { status: err.status, error: err.message };
+    }
+    if (err?.status === 400 || err?.status === 409)
+        return { status: err.status, error: err.message };
+    return { status: 500, error: err?.message ?? 'label request failed' };
+}

package/build/api/labels/index.d.ts

@@ -0,0 +1,2 @@
+export { listLabelTemplates, getLabelTemplate, upsertLabelTemplate, deleteLabelTemplate, listLabelMedia, listLabelTransports, } from './templates';
+export { previewLabels, issueLabels, reissueBadge, listLabelJobs, getLabelJob, reprintLabelJob } from './issue';

package/build/api/labels/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reprintLabelJob = exports.getLabelJob = exports.listLabelJobs = exports.reissueBadge = exports.issueLabels = exports.previewLabels = exports.listLabelTransports = exports.listLabelMedia = exports.deleteLabelTemplate = exports.upsertLabelTemplate = exports.getLabelTemplate = exports.listLabelTemplates = void 0;
+var templates_1 = require("./templates");
+Object.defineProperty(exports, "listLabelTemplates", { enumerable: true, get: function () { return templates_1.listLabelTemplates; } });
+Object.defineProperty(exports, "getLabelTemplate", { enumerable: true, get: function () { return templates_1.getLabelTemplate; } });
+Object.defineProperty(exports, "upsertLabelTemplate", { enumerable: true, get: function () { return templates_1.upsertLabelTemplate; } });
+Object.defineProperty(exports, "deleteLabelTemplate", { enumerable: true, get: function () { return templates_1.deleteLabelTemplate; } });
+Object.defineProperty(exports, "listLabelMedia", { enumerable: true, get: function () { return templates_1.listLabelMedia; } });
+Object.defineProperty(exports, "listLabelTransports", { enumerable: true, get: function () { return templates_1.listLabelTransports; } });
+var issue_1 = require("./issue");
+Object.defineProperty(exports, "previewLabels", { enumerable: true, get: function () { return issue_1.previewLabels; } });
+Object.defineProperty(exports, "issueLabels", { enumerable: true, get: function () { return issue_1.issueLabels; } });
+Object.defineProperty(exports, "reissueBadge", { enumerable: true, get: function () { return issue_1.reissueBadge; } });
+Object.defineProperty(exports, "listLabelJobs", { enumerable: true, get: function () { return issue_1.listLabelJobs; } });
+Object.defineProperty(exports, "getLabelJob", { enumerable: true, get: function () { return issue_1.getLabelJob; } });
+Object.defineProperty(exports, "reprintLabelJob", { enumerable: true, get: function () { return issue_1.reprintLabelJob; } });

package/build/api/labels/issue.d.ts

@@ -0,0 +1,54 @@
+import type { LTApiAuth, LTApiResult } from '../../types/sdk';
+import type { LabelIssueRequest, LabelLayoutRequest, LabelOutput, LabelSource } from '../../types/labels';
+/**
+ * Lay out a print job without printing or recording it. Sensitive templates
+ * come back masked: positions without codes.
+ *
+ * @returns `{ status: 200, data: { template, sheet, warnings, labelCount } }`
+ */
+export declare function previewLabels(input: {
+    template: string;
+    source: LabelSource;
+    layout?: LabelLayoutRequest;
+}, auth: LTApiAuth): Promise<LTApiResult>;
+/**
+ * Issue labels: recorded in the label ledger before any code is composed.
+ * Sensitive templates (every identity template) need `confirm: true`.
+ *
+ * @returns `{ status: 200, data: { job, replay, warnings, sheet?, pdf?, zpl?, receipt? } }`;
+ *   400 bad request, 403 no access, 404 unknown template, 428 confirmation required,
+ *   502 the transport failed after the job was recorded
+ */
+export declare function issueLabels(input: LabelIssueRequest, auth: LTApiAuth): Promise<LTApiResult>;
+/**
+ * Rotate a user's badge credential and print the new badge in one act. The
+ * old code stops resolving immediately. Needs credentialIssuer and `confirm`.
+ */
+export declare function reissueBadge(input: {
+    userId: string;
+    template: string;
+    layout?: LabelLayoutRequest;
+    output: LabelOutput;
+    confirm?: boolean;
+}, auth: LTApiAuth): Promise<LTApiResult>;
+/** Label history as the caller may see it: credential issuers see every job; others see item jobs and their own. */
+export declare function listLabelJobs(input: {
+    template?: string;
+    subjectUserId?: string;
+    limit?: number;
+    offset?: number;
+}, auth: LTApiAuth): Promise<LTApiResult>;
+export declare function getLabelJob(input: {
+    id: string;
+}, auth: LTApiAuth): Promise<LTApiResult>;
+/**
+ * Print a recorded job again from its source, with the template as it is
+ * now: the whole job, or `indices` of its labels. A new job is recorded.
+ */
+export declare function reprintLabelJob(input: {
+    id: string;
+    indices?: number[];
+    output: LabelOutput;
+    layout?: LabelLayoutRequest;
+    confirm?: boolean;
+}, auth: LTApiAuth): Promise<LTApiResult>;

package/build/api/labels/issue.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewLabels = previewLabels;
+exports.issueLabels = issueLabels;
+exports.reissueBadge = reissueBadge;
+exports.listLabelJobs = listLabelJobs;
+exports.getLabelJob = getLabelJob;
+exports.reprintLabelJob = reprintLabelJob;
+const labels = __importStar(require("../../services/labels"));
+const capabilities_1 = require("../../modules/capabilities");
+const logger_1 = require("../../lib/logger");
+const errors_1 = require("./errors");
+/**
+ * Lay out a print job without printing or recording it. Sensitive templates
+ * come back masked: positions without codes.
+ *
+ * @returns `{ status: 200, data: { template, sheet, warnings, labelCount } }`
+ */
+async function previewLabels(input, auth) {
+    try {
+        return { status: 200, data: await labels.previewLabels(input, auth) };
+    }
+    catch (err) {
+        return (0, errors_1.labelFailure)(err);
+    }
+}
+/**
+ * Issue labels: recorded in the label ledger before any code is composed.
+ * Sensitive templates (every identity template) need `confirm: true`.
+ *
+ * @returns `{ status: 200, data: { job, replay, warnings, sheet?, pdf?, zpl?, receipt? } }`;
+ *   400 bad request, 403 no access, 404 unknown template, 428 confirmation required,
+ *   502 the transport failed after the job was recorded
+ */
+async function issueLabels(input, auth) {
+    try {
+        const result = await labels.issueLabels(input, auth);
+        logger_1.loggerRegistry.info(`[long-tail] labels issued: job=${result.job.id} template=${input.template} labels=${result.job.label_count} output=${input.output}${result.replay ? ' replay' : ''}`);
+        return { status: 200, data: result };
+    }
+    catch (err) {
+        return (0, errors_1.labelFailure)(err);
+    }
+}
+/**
+ * Rotate a user's badge credential and print the new badge in one act. The
+ * old code stops resolving immediately. Needs credentialIssuer and `confirm`.
+ */
+async function reissueBadge(input, auth) {
+    try {
+        const result = await labels.reissueBadge(input, auth);
+        logger_1.loggerRegistry.info(`[long-tail] badge reissued: job=${result.reissueJobId} template=${input.template}`);
+        return { status: 200, data: result };
+    }
+    catch (err) {
+        return (0, errors_1.labelFailure)(err);
+    }
+}
+/** Label history as the caller may see it: credential issuers see every job; others see item jobs and their own. */
+async function listLabelJobs(input, auth) {
+    try {
+        const jobs = await labels.listLabelJobs({ ...input, readerId: auth.userId, seesCredentials: await (0, capabilities_1.mayIssueCredentials)(auth) });
+        return { status: 200, data: { jobs } };
+    }
+    catch (err) {
+        return (0, errors_1.labelFailure)(err);
+    }
+}
+async function readableJob(id, auth) {
+    const job = await labels.getLabelJob(id);
+    if (!job)
+        return null;
+    if (job.sensitive && job.requested_by !== auth.userId && !(await (0, capabilities_1.mayIssueCredentials)(auth)))
+        return null;
+    return job;
+}
+async function getLabelJob(input, auth) {
+    try {
+        const { isUuid } = await Promise.resolve().then(() => __importStar(require('../../lib/uuid')));
+        const job = isUuid(input.id) ? await readableJob(input.id, auth) : null;
+        return job ? { status: 200, data: job } : { status: 404, error: 'Label job not found' };
+    }
+    catch (err) {
+        return (0, errors_1.labelFailure)(err);
+    }
+}
+/**
+ * Print a recorded job again from its source, with the template as it is
+ * now: the whole job, or `indices` of its labels. A new job is recorded.
+ */
+async function reprintLabelJob(input, auth) {
+    try {
+        const { isUuid } = await Promise.resolve().then(() => __importStar(require('../../lib/uuid')));
+        const job = isUuid(input.id) ? await readableJob(input.id, auth) : null;
+        if (!job || job.action !== 'print' || !job.template_name)
+            return { status: 404, error: 'Label job not found' };
+        const named = job.subject_user_ids ?? job.targets ?? [];
+        const only = input.indices?.length ? input.indices.map((i) => named[i]).filter((v) => v !== undefined) : undefined;
+        return issueLabels({
+            template: job.template_name,
+            source: job.source,
+            layout: input.layout,
+            output: input.output,
+            confirm: input.confirm,
+            only,
+        }, auth);
+    }
+    catch (err) {
+        return (0, errors_1.labelFailure)(err);
+    }
+}

package/build/api/labels/templates.d.ts

@@ -0,0 +1,29 @@
+import type { LTApiResult } from '../../types/sdk';
+import type { LabelTemplateInput } from '../../types/labels';
+/**
+ * List label templates, optionally for one scan scheme.
+ *
+ * @param input.scheme — scheme version to filter by
+ * @returns `{ status: 200, data: { templates } }`
+ */
+export declare function listLabelTemplates(input?: {
+    scheme?: number;
+}): Promise<LTApiResult>;
+/** One label template by name; 404 when absent. */
+export declare function getLabelTemplate(input: {
+    name: string;
+}): Promise<LTApiResult>;
+/**
+ * Create or replace a label template. With `expected_revision`, the write
+ * lands only on that revision (409 otherwise).
+ */
+export declare function upsertLabelTemplate(input: LabelTemplateInput & {
+    expected_revision?: number;
+}): Promise<LTApiResult>;
+export declare function deleteLabelTemplate(input: {
+    name: string;
+}): Promise<LTApiResult>;
+/** Media presets and the deployment's default. */
+export declare function listLabelMedia(): Promise<LTApiResult>;
+/** Registered printer transports by name. */
+export declare function listLabelTransports(): Promise<LTApiResult>;