@hotmeshio/long-tail 0.30.2 → 0.30.3

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

@@ -1,5 +1,6 @@
 import type { AccumulatedItem, ContainerSelector, LTEscalationRecord } from '../../types';
 import type { LTApiAuth, LTApiResult } from '../../types/sdk';
+import type { FacetValue } from '../../types/facets';
 /** Names the second row of a reciprocal add or removal. Exactly one selector. */
 export interface ReciprocalInput {
     id?: string;
@@ -62,7 +63,7 @@ export declare function accumulateItemBySignalKey(input: {
  */
 export declare function accumulateItemByMetadata(input: {
     key: string;
-    value: string;
+    value: FacetValue;
     restrictRoles?: string[];
     /** Narrows the container beyond the facet: type, subtype, extra facet guards. */
     container?: ContainerSelector;

package/build/api/escalations/accumulate.js

@@ -51,6 +51,7 @@ const escalation_1 = require("../../types/escalation");
 const helpers_1 = require("./helpers");
 const resolve_1 = require("./resolve");
 const metadata_1 = require("./metadata");
+const facet_value_1 = require("../../lib/facet-value");
 function parseEnvelope(escalation) {
     try {
         const parsed = JSON.parse(escalation.envelope || '{}');
@@ -317,7 +318,7 @@ async function accumulateItemBySignalKey(input, auth) {
 async function accumulateItemByMetadata(input, auth) {
     try {
         const { key, value, itemKey, metadata } = input;
-        if (!key || !value)
+        if (!key || !(0, facet_value_1.hasFacetValue)(value))
             return { status: 400, error: 'key and value are required' };
         const keyError = itemKeyError(itemKey);
         if (keyError)

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

@@ -1,6 +1,7 @@
 import { type ProvisionIfAbsent } from './helpers';
 import type { LTApiAuth, LTApiResult } from '../../types/sdk';
 import type { ScanAvailability } from '../../types';
+import type { FacetValue } from '../../types/facets';
 /**
  * Intersect the caller's scope roles with an optional caller-supplied
  * restriction (e.g. a scan step's expected queues). Global scope with no
@@ -31,7 +32,7 @@ export declare function findByMetadata(input: {
  */
 export declare function claimByMetadata(input: {
     key: string;
-    value: string;
+    value: FacetValue;
     durationMinutes?: number;
     assignee?: string;
     metadata?: Record<string, any>;
@@ -54,7 +55,7 @@ export declare function claimByMetadata(input: {
  */
 export declare function resolveByMetadata(input: {
     key: string;
-    value: string;
+    value: FacetValue;
     resolverPayload: Record<string, any>;
     assignee?: string;
     metadata?: Record<string, any>;

package/build/api/escalations/metadata.js

@@ -43,6 +43,7 @@ const resolver_validation_1 = require("../../services/escalation/resolver-valida
 const enforcement_cache_1 = require("../../services/role/enforcement-cache");
 const resolve_1 = require("./resolve");
 const uuid_1 = require("../../lib/uuid");
+const facet_value_1 = require("../../lib/facet-value");
 /**
  * Intersect the caller's scope roles with an optional caller-supplied
  * restriction (e.g. a scan step's expected queues). Global scope with no
@@ -65,7 +66,7 @@ function restrictScopeRoles(scopeRoles, global, restrictRoles) {
  */
 async function findByMetadata(input, auth) {
     try {
-        if (!input.key || !input.value) {
+        if (!input.key || !(0, facet_value_1.hasFacetValue)(input.value)) {
             return { status: 400, error: 'key and value are required' };
         }
         // RBAC scoped IN SQL: the caller's read scope (read_all roles see every match;
@@ -94,7 +95,7 @@ async function findByMetadata(input, auth) {
  */
 async function claimByMetadata(input, auth) {
     try {
-        if (!input.key || !input.value) {
+        if (!input.key || !(0, facet_value_1.hasFacetValue)(input.value)) {
             return { status: 400, error: 'key and value are required' };
         }
         if (input.assertId !== undefined && !(0, uuid_1.isUuid)(input.assertId)) {
@@ -145,7 +146,7 @@ async function claimByMetadata(input, auth) {
  */
 async function resolveByMetadata(input, auth) {
     try {
-        if (!input.key || !input.value) {
+        if (!input.key || !(0, facet_value_1.hasFacetValue)(input.value)) {
             return { status: 400, error: 'key and value are required' };
         }
         if (!input.resolverPayload) {

package/build/api/escalations/resolve-batch.d.ts

@@ -4,7 +4,9 @@ import type { LTApiAuth, LTApiResult } from '../../types/sdk';
  * with `batch: [...]`). Interim submissions are cheap atomic fills — the row
  * stays pending and `remaining` reports progress. The LAST item completes the
  * escalation: the row resolves and the waiting workflow wakes with the full
- * collection, in the same statement.
+ * collection, in the same statement. On a wait that declared `wakeOnFill` for
+ * this key, the fill resolves the row early and the workflow wakes with the
+ * items so far (`outcome: 'woke'`, `remaining` > 0).
  *
  * Each item validates against the SAME versioned form schema a single-item
  * resolver gets (metadata.form_schema → pinned lt_role_schemas → live role

package/build/api/escalations/resolve-batch.js

@@ -48,7 +48,9 @@ const metadata_1 = require("./metadata");
  * with `batch: [...]`). Interim submissions are cheap atomic fills — the row
  * stays pending and `remaining` reports progress. The LAST item completes the
  * escalation: the row resolves and the waiting workflow wakes with the full
- * collection, in the same statement.
+ * collection, in the same statement. On a wait that declared `wakeOnFill` for
+ * this key, the fill resolves the row early and the workflow wakes with the
+ * items so far (`outcome: 'woke'`, `remaining` > 0).
  *
  * Each item validates against the SAME versioned form schema a single-item
  * resolver gets (metadata.form_schema → pinned lt_role_schemas → live role
@@ -228,6 +230,17 @@ function batchOutcomeResult(result, itemKey, workflowId) {
                     escalationId: result.escalation?.id,
                 },
             };
+        case escalation_1.BATCH_ITEM_OUTCOMES.WOKE:
+            return {
+                status: 200,
+                data: {
+                    outcome: escalation_1.BATCH_ITEM_OUTCOMES.WOKE,
+                    remaining: result.remaining,
+                    signaled: !!result.escalation?.signal_key,
+                    escalationId: result.escalation?.id,
+                    workflowId,
+                },
+            };
         case 'duplicate-item':
             return {
                 status: 409,

package/build/api/scan-codes/choice.js

@@ -41,6 +41,7 @@ const identity_1 = require("./identity");
 const grant_1 = require("./grant");
 const helpers_1 = require("../escalations/helpers");
 const context_1 = require("./context");
+const scan_code_1 = require("../../shared/scan-code");
 const present_1 = require("./present");
 const choice_roles_1 = require("./choice-roles");
 const x_lt_actions_1 = require("../../shared/form-validation/x-lt-actions");
@@ -109,8 +110,8 @@ async function executeScanChoice(input, auth) {
             return stampPointer((0, context_1.conflict)('the item is no longer in the presented state'), rule, input);
         }
         const row = loaded;
-        const target = row?.metadata?.[scheme.target_facet];
-        if (!row || typeof target !== 'string' || !target) {
+        const target = (0, scan_code_1.facetTarget)(row?.metadata?.[scheme.target_facet]);
+        if (!row || !target) {
             return {
                 status: 200,
                 data: { outcome: types_1.SCAN_OUTCOMES.UNCONFIGURED, error: `escalation does not carry the scheme facet "${scheme.target_facet}"` },

package/build/api/scan-codes/context.d.ts

@@ -44,6 +44,12 @@ export interface StepContext {
     subjectStale?: boolean;
 }
 export declare function targetFilter(step: ScanStep, ctx: StepContext): Record<string, any>;
+/**
+ * The value the target facet contains on a matching row: the target, or a
+ * one-item list when the scheme's facet holds a list (`metadata @>` then
+ * matches membership).
+ */
+export declare function targetValue(ctx: Pick<StepContext, 'scheme' | 'parsed'>): string | string[];
 export declare function templateContext(ctx: StepContext): scanCodeService.ScanTemplateContext;
 /** The `{subject.x}` bag: the held row's metadata plus its id. */
 export declare function subjectBag(row: LTEscalationRecord): Record<string, unknown>;

package/build/api/scan-codes/context.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.targetFilter = targetFilter;
+exports.targetValue = targetValue;
 exports.templateContext = templateContext;
 exports.subjectBag = subjectBag;
 exports.liveClaimMetadata = liveClaimMetadata;
@@ -52,7 +53,15 @@ const scanCodeService = __importStar(require("../../services/scan-code"));
 const escalationService = __importStar(require("../../services/escalation"));
 const types_1 = require("../../types");
 function targetFilter(step, ctx) {
-    return { [ctx.scheme.target_facet]: ctx.parsed.target, ...(step.query?.facets ?? {}) };
+    return { [ctx.scheme.target_facet]: targetValue(ctx), ...(step.query?.facets ?? {}) };
+}
+/**
+ * The value the target facet contains on a matching row: the target, or a
+ * one-item list when the scheme's facet holds a list (`metadata @>` then
+ * matches membership).
+ */
+function targetValue(ctx) {
+    return ctx.scheme.target_match === types_1.SCAN_TARGET_MATCH.MEMBER ? [ctx.parsed.target] : ctx.parsed.target;
 }
 function templateContext(ctx) {
     return {

package/build/api/scan-codes/locate.js

@@ -123,6 +123,7 @@ async function locateStep(step, ctx) {
                     ...step.query,
                     targetFacet: ctx.scheme.target_facet,
                     target: ctx.parsed.target,
+                    targetMatch: ctx.scheme.target_match,
                 },
             },
         };

package/build/api/scan-codes/subject.js

@@ -41,6 +41,8 @@ const userService = __importStar(require("../../services/user"));
 const uuid_1 = require("../../lib/uuid");
 const helpers_1 = require("../escalations/helpers");
 const types_1 = require("../../types");
+const scan_code_1 = require("../../shared/scan-code");
+const escalation_1 = require("../../types/escalation");
 async function resolveSubject(ref, schemes, stationAuth) {
     if (!ref)
         return null;
@@ -49,16 +51,43 @@ async function resolveSubject(ref, schemes, stationAuth) {
     const parsed = scanCodeService.parseScanCode(ref.code, schemes);
     if (!parsed.ok || parsed.scheme.kind !== types_1.SCAN_SCHEME_KINDS.ACTION)
         return { ok: false };
-    const row = await escalationService.getEscalation(ref.escalationId);
-    if (!row || row.status !== 'pending')
+    const held = await escalationService.getEscalation(ref.escalationId);
+    const row = held?.status === 'pending' ? held : await nextRound(held, parsed.scheme, parsed.parsed.target);
+    if (!row)
         return { ok: false };
     if (await (0, helpers_1.assertReadAccess)(stationAuth.userId, row))
         return { ok: false };
-    if (row.metadata?.[parsed.scheme.target_facet] !== parsed.parsed.target) {
+    if (!(0, scan_code_1.facetHolds)(row.metadata?.[parsed.scheme.target_facet], parsed.parsed.target)) {
         return { ok: false };
     }
     return { ok: true, subject: { row, parsed: parsed.parsed, scheme: parsed.scheme, code: ref.code } };
 }
+/**
+ * The pending round that follows a row a fill resolved to wake its wait
+ * (`$trigger: 'fill'`): the one pending row in the same role, of the same
+ * workflow, carrying the same target. Null when there is none yet.
+ */
+async function nextRound(held, scheme, target) {
+    if (!held || held.status !== 'resolved' || !held.workflow_id)
+        return null;
+    if (resolverTrigger(held) !== escalation_1.ESCALATION_TRIGGER_FILL)
+        return null;
+    const value = scheme.target_match === types_1.SCAN_TARGET_MATCH.MEMBER ? [target] : target;
+    const { escalations } = await escalationService.searchByFacets({
+        roles: [held.role], facets: { [scheme.target_facet]: value }, status: 'pending', limit: 2,
+    });
+    const rounds = escalations.filter((e) => e.workflow_id === held.workflow_id);
+    return rounds.length === 1 ? rounds[0] : null;
+}
+function resolverTrigger(row) {
+    try {
+        const payload = typeof row.resolver_payload === 'string' ? JSON.parse(row.resolver_payload) : row.resolver_payload;
+        return payload?.[escalation_1.ESCALATION_TRIGGER_KEY];
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Who holds a live claim on the row, when that is someone other than `actorId`. */
 async function claimedByOther(row, actorId) {
     if (!row.assigned_to || !(0, types_1.isEffectivelyClaimed)(row) || row.assigned_to === actorId)

package/build/api/scan-codes/verb-accumulate.js

@@ -109,7 +109,7 @@ async function accumulateStep(step, ctx) {
     else {
         request = {
             key: ctx.scheme.target_facet,
-            value: ctx.parsed.target,
+            value: (0, context_1.targetValue)(ctx),
             itemKey: rendered.itemKey,
             payload: rendered.payload,
             metadata: rendered.metadata,

package/build/api/scan-codes/verb-fill.js

@@ -139,7 +139,8 @@ async function fillStep(step, ctx) {
         }, ctx.auth);
         if (result.status === 200) {
             const data = result.data;
-            const done = data.outcome === 'completed';
+            // A fill that woke the wait (`woke`) is interim here: the next round carries the rest.
+            const done = data.outcome === escalation_1.BATCH_ITEM_OUTCOMES.COMPLETED;
             const filled = progress(batch, batch.pending.length - (done ? 0 : (data.remaining ?? 0)));
             const next = pendingCopy(batch.pending.filter((k) => k !== itemKey), separator, labeler).next;
             return (0, context_1.withDone)({

package/build/api/scan-codes/verb-into-subject.js

@@ -62,7 +62,7 @@ async function locateItem(step, ctx) {
         roles: roles ?? undefined,
         types: selector.types,
         subtypes: selector.subtypes,
-        facets: { ...selector.facets, [ctx.scheme.target_facet]: ctx.parsed.target },
+        facets: { ...selector.facets, [ctx.scheme.target_facet]: (0, context_1.targetValue)(ctx) },
         status: 'pending',
         exists: [escalation_1.ESCALATION_ACCUMULATE_KEYS.COUNT],
         limit: 3,

package/build/api/scan-codes/verbs-subject.js

@@ -87,7 +87,7 @@ async function locateContainer(step, ctx) {
         roles: roles ?? undefined,
         types: selector?.types,
         subtypes: selector?.subtypes,
-        facets: { ...selector?.facets, [ctx.scheme.target_facet]: ctx.parsed.target },
+        facets: { ...selector?.facets, [ctx.scheme.target_facet]: (0, context_1.targetValue)(ctx) },
         status: 'pending',
         exists: [escalation_1.ESCALATION_ACCUMULATE_KEYS.COUNT],
         limit: 2,

package/build/api/scan-codes/verbs.js

@@ -64,7 +64,7 @@ async function claimStep(step, ctx, presentedId) {
         return notPrimed;
     const result = await (0, metadata_1.claimByMetadata)({
         key: ctx.scheme.target_facet,
-        value: ctx.parsed.target,
+        value: (0, context_1.targetValue)(ctx),
         durationMinutes: step.params?.durationMinutes,
         metadata: { ...metadata, ...(0, context_1.provenance)(ctx) },
         restrictRoles: step.query?.roles,
@@ -95,7 +95,7 @@ async function resolveStep(step, ctx, presentedId) {
         return notPrimed;
     const result = await (0, metadata_1.resolveByMetadata)({
         key: ctx.scheme.target_facet,
-        value: ctx.parsed.target,
+        value: (0, context_1.targetValue)(ctx),
         resolverPayload: rendered.resolverPayload,
         metadata: { ...rendered.metadata, ...(0, context_1.provenance)(ctx) },
         restrictRoles: step.query?.roles,
@@ -143,7 +143,7 @@ async function escalateStep(step, ctx, presentedId) {
         role: step.params.targetRole,
         description: step.params?.description ?? ctx.rule.name,
         metadata: {
-            [ctx.scheme.target_facet]: ctx.parsed.target,
+            [ctx.scheme.target_facet]: (0, context_1.targetValue)(ctx),
             ...(0, context_1.interpolatedMetadata)(step, ctx),
             ...(0, context_1.provenance)(ctx),
         },
@@ -234,7 +234,7 @@ async function cancelStep(step, ctx, presentedId) {
         return notPrimed;
     const claimed = await (0, metadata_1.claimByMetadata)({
         key: ctx.scheme.target_facet,
-        value: ctx.parsed.target,
+        value: (0, context_1.targetValue)(ctx),
         metadata: (0, context_1.provenance)(ctx),
         restrictRoles: step.query?.roles,
         assertId: presentedId,

package/build/lib/db/schemas/043_scan_pattern_and_member_targets.sql

@@ -0,0 +1,26 @@
+-- Migration 043: pattern scan schemes and list-valued target facets
+--
+-- encoding 'pattern': a scheme whose codes carry no scheme or category, such
+-- as a carrier tracking number. A code matching one of `patterns` (regular
+-- expressions over the whole code) parses with the code as the target, and
+-- the scheme's single rule is category '0'. `precedes_gtin` declares which
+-- reads a digits-only code first while an enabled gtin scheme exists: true,
+-- the patterns; false, the gtin scheme. Beside an enabled gtin scheme the
+-- declaration is required.
+--
+-- target_match:
+--   'value'   the target facet holds one value equal to the target.
+--   'member'  the target facet holds a list; a row matches when the list
+--             contains the target (metadata @> {facet: [target]}).
+
+ALTER TABLE lt_config_scan_schemes
+  DROP CONSTRAINT IF EXISTS lt_config_scan_schemes_encoding_check;
+ALTER TABLE lt_config_scan_schemes
+  ADD CONSTRAINT lt_config_scan_schemes_encoding_check
+    CHECK (encoding IN ('fixed', 'delimited', 'gtin', 'pattern'));
+
+ALTER TABLE lt_config_scan_schemes
+  ADD COLUMN IF NOT EXISTS patterns JSONB NOT NULL DEFAULT '[]'::jsonb,
+  ADD COLUMN IF NOT EXISTS precedes_gtin BOOLEAN,
+  ADD COLUMN IF NOT EXISTS target_match TEXT NOT NULL DEFAULT 'value'
+    CHECK (target_match IN ('value', 'member'));

package/build/lib/facet-value.d.ts

@@ -0,0 +1,3 @@
+import type { FacetValue } from '../types/facets';
+/** True when a facet value names something to match: a non-empty string or a non-empty list of them. */
+export declare function hasFacetValue(value: unknown): value is FacetValue;

package/build/lib/facet-value.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasFacetValue = hasFacetValue;
+/** True when a facet value names something to match: a non-empty string or a non-empty list of them. */
+function hasFacetValue(value) {
+    if (typeof value === 'string')
+        return value.length > 0;
+    return Array.isArray(value) && value.length > 0 && value.every((v) => typeof v === 'string' && v.length > 0);
+}

package/build/routes/scan-codes.js

@@ -105,6 +105,9 @@ router.put('/schemes/:version', auth_1.requireRoleManager, async (req, res) => {
         grant_ttl_seconds: req.body.grant_ttl_seconds,
         grant_max_uses: req.body.grant_max_uses,
         grant_scope: req.body.grant_scope,
+        patterns: req.body.patterns,
+        precedes_gtin: req.body.precedes_gtin,
+        target_match: req.body.target_match,
         enabled: req.body.enabled,
     });
     res.status(result.status).json(result.data ?? { error: result.error });

package/build/sdk/index.d.ts

@@ -207,7 +207,7 @@ export declare function createClient(options?: LTClientOptions): {
         }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
         claimByMetadata: (input: {
             key: string;
-            value: string;
+            value: import("..").FacetValue;
             durationMinutes?: number;
             assignee?: string;
             metadata?: Record<string, any>;
@@ -217,7 +217,7 @@ export declare function createClient(options?: LTClientOptions): {
         }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
         resolveByMetadata: (input: {
             key: string;
-            value: string;
+            value: import("..").FacetValue;
             resolverPayload: Record<string, any>;
             assignee?: string;
             metadata?: Record<string, any>;
@@ -266,7 +266,7 @@ export declare function createClient(options?: LTClientOptions): {
         } & Omit<import("../api/escalations/accumulate").AccumulateItemInput, "assertClaim">, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
         accumulateByMetadata: (input: {
             key: string;
-            value: string;
+            value: import("..").FacetValue;
             restrictRoles?: string[];
             container?: import("..").ContainerSelector;
         } & Omit<import("../api/escalations/accumulate").AccumulateItemInput, "assertClaim">, auth?: LTApiAuth) => Promise<LTApiResult<any>>;

package/build/services/escalation/batch.d.ts

@@ -3,15 +3,16 @@ export interface ResolveBatchItemOutcome {
     outcome: BatchItemOutcome;
     /** Items still awaiting submission after this call (0 exactly when completed). */
     remaining: number;
-    /** The post-fill row on `completed`/`accepted`; null on every failure outcome. */
+    /** The post-fill row on `completed`/`accepted`/`woke`; null on every failure outcome. */
     escalation: LTEscalationRecord | null;
 }
 /**
  * Fills one declared item of a batch escalation in a single atomic SDK
  * statement (guarded fill + facet recompute + resolve-and-wake on the last
  * item). `actor` is recorded under `envelope.batch_filled_by[itemKey]`. Interim fills publish `escalation.updated` with progress; the
- * completing fill publishes the standard `escalation.resolved`. Failure
- * outcomes publish nothing — the row was untouched.
+ * completing fill, and a fill that woke a `wakeOnFill` wait (`woke`), publish
+ * the standard `escalation.resolved`. Failure outcomes publish nothing — the
+ * row was untouched.
  */
 export declare function resolveBatchItem(id: string, itemKey: string, payload: Record<string, any>, metadata?: Record<string, any>, assertClaim?: string, resolvedBy?: {
     id: string;

package/build/services/escalation/batch.js

@@ -4,6 +4,7 @@ exports.resolveBatchItem = resolveBatchItem;
 exports.resolveBatchItemBySignalKey = resolveBatchItemBySignalKey;
 exports.resolveBatchItemByMetadata = resolveBatchItemByMetadata;
 const escalation_wire_1 = require("../../lib/events/escalation-wire");
+const escalation_1 = require("../../types/escalation");
 const uuid_1 = require("../../lib/uuid");
 const client_1 = require("./client");
 const crud_1 = require("./crud");
@@ -12,8 +13,9 @@ const map_1 = require("./map");
  * Fills one declared item of a batch escalation in a single atomic SDK
  * statement (guarded fill + facet recompute + resolve-and-wake on the last
  * item). `actor` is recorded under `envelope.batch_filled_by[itemKey]`. Interim fills publish `escalation.updated` with progress; the
- * completing fill publishes the standard `escalation.resolved`. Failure
- * outcomes publish nothing — the row was untouched.
+ * completing fill, and a fill that woke a `wakeOnFill` wait (`woke`), publish
+ * the standard `escalation.resolved`. Failure outcomes publish nothing — the
+ * row was untouched.
  */
 async function resolveBatchItem(id, itemKey, payload, metadata, assertClaim, resolvedBy, actor) {
     if (!(0, uuid_1.isUuid)(id))
@@ -72,7 +74,7 @@ function settleBatchOutcome(result, itemKey) {
         return { outcome: result.outcome, remaining: -1, escalation: null };
     }
     const escalation = (0, map_1.toEscalationRecord)(result.entry);
-    const completed = result.outcome === 'completed';
+    const completed = result.outcome === escalation_1.BATCH_ITEM_OUTCOMES.COMPLETED || result.outcome === escalation_1.BATCH_ITEM_OUTCOMES.WOKE;
     (0, crud_1.publishEscalationChange)({
         type: completed ? 'escalation.resolved' : 'escalation.updated',
         source: 'service',

package/build/services/escalation/claim-asserted.d.ts

@@ -1,4 +1,5 @@
 import type { ClaimResult } from './types';
+import type { FacetValue } from '../../types/facets';
 /**
  * Claims one named row, the same claim `claimByMetadata` makes on the row it
  * picks: pending, the facet still matches, the role is allowed, and no live
@@ -7,4 +8,4 @@ import type { ClaimResult } from './types';
  */
 export declare const CLAIM_ASSERTED = "WITH target AS MATERIALIZED (\n  SELECT id, assigned_to AS prior_assigned_to FROM public.hmsh_escalations\n  WHERE id = $6\n    AND metadata @> $1::jsonb\n    AND ($4::text[] IS NULL OR role = ANY($4::text[]))\n    AND status = 'pending'\n    AND (assigned_to IS NULL OR assigned_until IS NULL OR assigned_until <= NOW() OR assigned_to = $2)\n  FOR UPDATE SKIP LOCKED\n)\nUPDATE public.hmsh_escalations e\nSET assigned_to      = $2,\n    claimed_at       = NOW(),\n    claim_expires_at = NOW() + ($3 * INTERVAL '1 minute'),\n    assigned_until   = NOW() + ($3 * INTERVAL '1 minute'),\n    metadata         = CASE WHEN $5::jsonb IS NOT NULL\n                            THEN COALESCE(e.metadata, '{}'::jsonb) || $5::jsonb\n                            ELSE e.metadata END,\n    updated_at       = NOW()\nFROM target WHERE e.id = target.id\nRETURNING e.*, target.prior_assigned_to\n";
 /** Claim the row `id` when it still carries `key = value`; null when it does not. */
-export declare function claimAssertedByMetadata(id: string, key: string, value: string, userId: string, durationMinutes?: number, metadata?: Record<string, any>, allowedRoles?: string[] | null): Promise<ClaimResult | null>;
+export declare function claimAssertedByMetadata(id: string, key: string, value: FacetValue, userId: string, durationMinutes?: number, metadata?: Record<string, any>, allowedRoles?: string[] | null): Promise<ClaimResult | null>;

package/build/services/escalation/crud.d.ts

@@ -1,6 +1,7 @@
 import { publishEscalationEvent } from '../../lib/events/publish';
 import type { LTEscalationRecord, ScanAvailability } from '../../types';
 import type { CreateEscalationInput, ClaimResult } from './types';
+import type { FacetValue } from '../../types/facets';
 /**
  * Every escalation write publishes an event AND drops this container's cached
  * aggregates — the event triggers a dashboard refetch, which must observe the
@@ -212,7 +213,7 @@ export declare function findByMetadata(key: string, value: string, status?: stri
  *   excluded from claim-by-metadata (their items are pre-claimed and resolved
  *   by id). Self-scope claim-by-metadata would require a HotMesh SDK predicate.
  */
-export declare function claimByMetadata(key: string, value: string, userId: string, durationMinutes?: number, metadata?: Record<string, any>, allowedRoles?: string[] | null): Promise<(ClaimResult & {
+export declare function claimByMetadata(key: string, value: FacetValue, userId: string, durationMinutes?: number, metadata?: Record<string, any>, allowedRoles?: string[] | null): Promise<(ClaimResult & {
     candidatesExist: number;
 }) | null>;
 export interface ResolveByMetadataResult {
@@ -256,4 +257,4 @@ export interface ResolveByMetadataResult {
  * business logic over the shared table, so it runs as one atomic statement on
  * `hmsh_escalations` rather than through the generic SDK resolve.
  */
-export declare function resolveByMetadataAtomic(key: string, value: string, userId: string, resolverPayload: Record<string, any>, metadata?: Record<string, any>, writeAllRoles?: string[] | null, writeSelfRoles?: string[] | null, enforcingRoles?: string[] | null, assertId?: string | null, extraFacets?: Record<string, any> | null, availability?: ScanAvailability | null): Promise<ResolveByMetadataResult>;
+export declare function resolveByMetadataAtomic(key: string, value: FacetValue, userId: string, resolverPayload: Record<string, any>, metadata?: Record<string, any>, writeAllRoles?: string[] | null, writeSelfRoles?: string[] | null, enforcingRoles?: string[] | null, assertId?: string | null, extraFacets?: Record<string, any> | null, availability?: ScanAvailability | null): Promise<ResolveByMetadataResult>;

package/build/services/orchestrator/condition.d.ts

@@ -126,6 +126,12 @@ export type ConditionEscalationConfig = Types.ConditionQueueConfig & {
  * already satisfied go in `filled` (hotmesh 0.31.0+), keyed by item key
  * with `payload`, `at` from the source of record, and an optional `actor`;
  * the row starts with that progress and delivers them with the collection.
+ * Add `wakeOnFill: true` (or a list of keys, hotmesh 0.32.0+) and a fill
+ * resumes the wait with the items so far, `$filled: [itemKey]`, `$filledAt`,
+ * `$filledBy` and `$trigger: 'fill'`, so the workflow acts on each item as it
+ * lands; park the next round with every fill carried forward in `filled`,
+ * built from `$filledAt` and `$filledBy`. The last key completes as on any
+ * batch.
  *
  * **Open accumulation — items arrive over time (hotmesh 0.29.0+).** Declare
  * `accumulate` and the escalation holds items added via `accumulateItem`

package/build/services/orchestrator/condition.js

@@ -172,6 +172,12 @@ function toEngineConfig(escalation) {
  * already satisfied go in `filled` (hotmesh 0.31.0+), keyed by item key
  * with `payload`, `at` from the source of record, and an optional `actor`;
  * the row starts with that progress and delivers them with the collection.
+ * Add `wakeOnFill: true` (or a list of keys, hotmesh 0.32.0+) and a fill
+ * resumes the wait with the items so far, `$filled: [itemKey]`, `$filledAt`,
+ * `$filledBy` and `$trigger: 'fill'`, so the workflow acts on each item as it
+ * lands; park the next round with every fill carried forward in `filled`,
+ * built from `$filledAt` and `$filledBy`. The last key completes as on any
+ * batch.
  *
  * **Open accumulation — items arrive over time (hotmesh 0.29.0+).** Declare
  * `accumulate` and the escalation holds items added via `accumulateItem`

package/build/services/scan-code/read.js

@@ -15,6 +15,9 @@ function mapScheme(row) {
         encoding: row.encoding,
         delimiter: row.delimiter,
         target_length: row.target_length ?? null,
+        patterns: Array.isArray(row.patterns) ? row.patterns : [],
+        precedes_gtin: row.precedes_gtin ?? null,
+        target_match: row.target_match ?? 'value',
         kind: row.kind ?? 'action',
         grant_ttl_seconds: row.grant_ttl_seconds ?? null,
         grant_max_uses: row.grant_max_uses ?? 0,

package/build/services/scan-code/sql.d.ts

@@ -2,16 +2,16 @@ export declare const LIST_SCHEMES = "SELECT * FROM lt_config_scan_schemes ORDER
 export declare const GET_SCHEME = "SELECT * FROM lt_config_scan_schemes WHERE version = $1";
 export declare const LIST_ACTIONS = "SELECT * FROM lt_config_scan_actions WHERE scheme_version = $1 ORDER BY category";
 export declare const GET_ACTION = "SELECT * FROM lt_config_scan_actions WHERE scheme_version = $1 AND category = $2";
-export declare const UPSERT_SCHEME = "INSERT INTO lt_config_scan_schemes\n  (version, name, description, target_facet, encoding, delimiter, target_length,\n   kind, grant_ttl_seconds, grant_max_uses, enabled, grant_scope)\nVALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\nON CONFLICT (version) DO UPDATE SET\n  name = EXCLUDED.name,\n  description = EXCLUDED.description,\n  target_facet = EXCLUDED.target_facet,\n  encoding = EXCLUDED.encoding,\n  delimiter = EXCLUDED.delimiter,\n  target_length = EXCLUDED.target_length,\n  kind = EXCLUDED.kind,\n  grant_ttl_seconds = EXCLUDED.grant_ttl_seconds,\n  grant_max_uses = EXCLUDED.grant_max_uses,\n  grant_scope = EXCLUDED.grant_scope,\n  enabled = EXCLUDED.enabled\nRETURNING *";
+export declare const UPSERT_SCHEME = "INSERT INTO lt_config_scan_schemes\n  (version, name, description, target_facet, encoding, delimiter, target_length,\n   kind, grant_ttl_seconds, grant_max_uses, enabled, grant_scope,\n   patterns, precedes_gtin, target_match)\nVALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)\nON CONFLICT (version) DO UPDATE SET\n  name = EXCLUDED.name,\n  description = EXCLUDED.description,\n  target_facet = EXCLUDED.target_facet,\n  encoding = EXCLUDED.encoding,\n  delimiter = EXCLUDED.delimiter,\n  target_length = EXCLUDED.target_length,\n  kind = EXCLUDED.kind,\n  grant_ttl_seconds = EXCLUDED.grant_ttl_seconds,\n  grant_max_uses = EXCLUDED.grant_max_uses,\n  grant_scope = EXCLUDED.grant_scope,\n  patterns = EXCLUDED.patterns,\n  precedes_gtin = EXCLUDED.precedes_gtin,\n  target_match = EXCLUDED.target_match,\n  enabled = EXCLUDED.enabled\nRETURNING *";
 export declare const DELETE_SCHEME = "DELETE FROM lt_config_scan_schemes WHERE version = $1";
 export declare const UPSERT_ACTION = "INSERT INTO lt_config_scan_actions\n  (scheme_version, category, name, steps, fallback, not_primed, enabled)\nVALUES ($1, $2, $3, $4, $5, $6, $7)\nON CONFLICT (scheme_version, category) DO UPDATE SET\n  name = EXCLUDED.name,\n  steps = EXCLUDED.steps,\n  fallback = EXCLUDED.fallback,\n  not_primed = EXCLUDED.not_primed,\n  enabled = EXCLUDED.enabled\nRETURNING *";
 export declare const DELETE_ACTION = "DELETE FROM lt_config_scan_actions WHERE scheme_version = $1 AND category = $2";
-export declare const SEED_SCHEME = "INSERT INTO lt_config_scan_schemes\n  (version, name, description, target_facet, encoding, delimiter, target_length,\n   kind, grant_ttl_seconds, grant_max_uses, enabled, grant_scope)\nVALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\nON CONFLICT (version) DO NOTHING";
+export declare const SEED_SCHEME = "INSERT INTO lt_config_scan_schemes\n  (version, name, description, target_facet, encoding, delimiter, target_length,\n   kind, grant_ttl_seconds, grant_max_uses, enabled, grant_scope,\n   patterns, precedes_gtin, target_match)\nVALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)\nON CONFLICT (version) DO NOTHING";
 export declare const SEED_ACTION = "INSERT INTO lt_config_scan_actions\n  (scheme_version, category, name, steps, fallback, not_primed, enabled)\nVALUES ($1, $2, $3, $4, $5, $6, $7)\nON CONFLICT (scheme_version, category) DO NOTHING";
 /**
  * Apply — same column set as the upsert, guarded by IS DISTINCT FROM so an
  * unchanged declaration is a zero-row no-op. `(xmax = 0)` distinguishes
  * insert from update. jsonb columns compare content-wise in SQL.
  */
-export declare const APPLY_SCHEME = "INSERT INTO lt_config_scan_schemes\n  (version, name, description, target_facet, encoding, delimiter, target_length,\n   kind, grant_ttl_seconds, grant_max_uses, enabled, grant_scope)\nVALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\nON CONFLICT (version) DO UPDATE SET\n  name = EXCLUDED.name,\n  description = EXCLUDED.description,\n  target_facet = EXCLUDED.target_facet,\n  encoding = EXCLUDED.encoding,\n  delimiter = EXCLUDED.delimiter,\n  target_length = EXCLUDED.target_length,\n  kind = EXCLUDED.kind,\n  grant_ttl_seconds = EXCLUDED.grant_ttl_seconds,\n  grant_max_uses = EXCLUDED.grant_max_uses,\n  grant_scope = EXCLUDED.grant_scope,\n  enabled = EXCLUDED.enabled,\n  updated_at = NOW()\nWHERE (lt_config_scan_schemes.name, lt_config_scan_schemes.description,\n       lt_config_scan_schemes.target_facet, lt_config_scan_schemes.encoding,\n       lt_config_scan_schemes.delimiter, lt_config_scan_schemes.target_length,\n       lt_config_scan_schemes.kind, lt_config_scan_schemes.grant_ttl_seconds,\n       lt_config_scan_schemes.grant_max_uses, lt_config_scan_schemes.enabled,\n       lt_config_scan_schemes.grant_scope)\n  IS DISTINCT FROM\n      (EXCLUDED.name, EXCLUDED.description, EXCLUDED.target_facet,\n       EXCLUDED.encoding, EXCLUDED.delimiter, EXCLUDED.target_length,\n       EXCLUDED.kind, EXCLUDED.grant_ttl_seconds, EXCLUDED.grant_max_uses,\n       EXCLUDED.enabled, EXCLUDED.grant_scope)\nRETURNING (xmax = 0) AS inserted";
+export declare const APPLY_SCHEME = "INSERT INTO lt_config_scan_schemes\n  (version, name, description, target_facet, encoding, delimiter, target_length,\n   kind, grant_ttl_seconds, grant_max_uses, enabled, grant_scope,\n   patterns, precedes_gtin, target_match)\nVALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)\nON CONFLICT (version) DO UPDATE SET\n  name = EXCLUDED.name,\n  description = EXCLUDED.description,\n  target_facet = EXCLUDED.target_facet,\n  encoding = EXCLUDED.encoding,\n  delimiter = EXCLUDED.delimiter,\n  target_length = EXCLUDED.target_length,\n  kind = EXCLUDED.kind,\n  grant_ttl_seconds = EXCLUDED.grant_ttl_seconds,\n  grant_max_uses = EXCLUDED.grant_max_uses,\n  grant_scope = EXCLUDED.grant_scope,\n  patterns = EXCLUDED.patterns,\n  precedes_gtin = EXCLUDED.precedes_gtin,\n  target_match = EXCLUDED.target_match,\n  enabled = EXCLUDED.enabled,\n  updated_at = NOW()\nWHERE (lt_config_scan_schemes.name, lt_config_scan_schemes.description,\n       lt_config_scan_schemes.target_facet, lt_config_scan_schemes.encoding,\n       lt_config_scan_schemes.delimiter, lt_config_scan_schemes.target_length,\n       lt_config_scan_schemes.kind, lt_config_scan_schemes.grant_ttl_seconds,\n       lt_config_scan_schemes.grant_max_uses, lt_config_scan_schemes.enabled,\n       lt_config_scan_schemes.grant_scope, lt_config_scan_schemes.patterns,\n       lt_config_scan_schemes.precedes_gtin, lt_config_scan_schemes.target_match)\n  IS DISTINCT FROM\n      (EXCLUDED.name, EXCLUDED.description, EXCLUDED.target_facet,\n       EXCLUDED.encoding, EXCLUDED.delimiter, EXCLUDED.target_length,\n       EXCLUDED.kind, EXCLUDED.grant_ttl_seconds, EXCLUDED.grant_max_uses,\n       EXCLUDED.enabled, EXCLUDED.grant_scope, EXCLUDED.patterns,\n       EXCLUDED.precedes_gtin, EXCLUDED.target_match)\nRETURNING (xmax = 0) AS inserted";
 export declare const APPLY_ACTION = "INSERT INTO lt_config_scan_actions\n  (scheme_version, category, name, steps, fallback, not_primed, enabled)\nVALUES ($1, $2, $3, $4, $5, $6, $7)\nON CONFLICT (scheme_version, category) DO UPDATE SET\n  name = EXCLUDED.name,\n  steps = EXCLUDED.steps,\n  fallback = EXCLUDED.fallback,\n  not_primed = EXCLUDED.not_primed,\n  enabled = EXCLUDED.enabled,\n  updated_at = NOW()\nWHERE (lt_config_scan_actions.name, lt_config_scan_actions.steps,\n       lt_config_scan_actions.fallback, lt_config_scan_actions.not_primed,\n       lt_config_scan_actions.enabled)\n  IS DISTINCT FROM\n      (EXCLUDED.name, EXCLUDED.steps, EXCLUDED.fallback,\n       EXCLUDED.not_primed, EXCLUDED.enabled)\nRETURNING (xmax = 0) AS inserted";