@memberjunction/work-queue-core 0.0.1-seed.1 → 6.2.0-edge.3

package/dist/transport.d.ts

@@ -0,0 +1,106 @@
+import type { WorkJson, WorkMessage } from './envelope.js';
+import type { FilterSupport, SubscriptionFilter } from './filterTypes.js';
+import type { WorkProgress } from './handler.js';
+import type { ITransportOperator } from './operator.js';
+import type { DeliveryStatus, HostType, SubscriptionPolicy } from './policy.js';
+import type { PublishResult } from './publishing.js';
+export interface TopicBinding {
+    TopicName: string;
+    IsFifo: boolean;
+    MaxPayloadBytes: number;
+    /** e.g. { SnsTopicArn } */
+    Config: Record<string, WorkJson>;
+}
+export interface SubscriptionBinding {
+    Policy: SubscriptionPolicy;
+    Filter: SubscriptionFilter | null;
+    HostType: HostType;
+    /** e.g. { Region, QueueUrl, QueueArn, DeadLetterQueueUrl, DeadLetterQueueArn, SnsSubscriptionArn, IsFifo } */
+    Config: Record<string, WorkJson>;
+}
+export interface ReceivedDelivery<TPayload extends WorkJson = WorkJson> {
+    Message: WorkMessage<TPayload>;
+    DeliveryID: string;
+    /** Database: per-claim UUID; SQS: receipt handle */
+    LeaseToken: string;
+    Attempt: number;
+    IsReplay: boolean;
+    LeaseExpiresAt: Date;
+}
+export type SettleResult = {
+    Kind: 'Settled';
+    DeliveryID: string;
+    Status: DeliveryStatus;
+}
+/** The guarded write changed no row: taken over, expired or cancelled. */
+ | {
+    Kind: 'LeaseLost';
+    DeliveryID: string;
+} | {
+    Kind: 'Failed';
+    DeliveryID: string;
+    Error: string;
+};
+export type LeaseExtension = 'Held' | 'Lost' | 'Cancelled';
+export interface TransportCapabilities {
+    /** Filter operators and structure this transport accepts (spec 03 §4.1). */
+    Filters: FilterSupport;
+    /** Database true; AWS false */
+    DetectsMessageIDDuplicates: boolean;
+    /** Database true; AWS false */
+    PersistsProgress: boolean;
+    /** Database true; AWS false — Ordered requires the Database transport */
+    SupportsOrdered: boolean;
+    /** Database false; AWS true */
+    SupportsExternalHosts: boolean;
+    /** Database true; AWS false */
+    CancelPending: boolean;
+    /** Cancel an InFlight delivery with the cancel flag + AcknowledgeCancel (spec 03 §7). Database true; AWS false. */
+    CancelInFlight: boolean;
+    /** Database true; AWS false */
+    ListPartitions: boolean;
+    /** Database Full; AWS BestEffort (≤ 100 scanned) */
+    PeekDeadLetters: 'Full' | 'BestEffort';
+    /** Database true; AWS true (scan-based) */
+    ReplaySingleDeadLetter: boolean;
+    /** Database true; AWS false */
+    CompletedCounts: boolean;
+    /** Database 2147483647; AWS 43200 */
+    MaxRetryDelaySeconds: number;
+}
+/** Opaque to core; the Database driver narrows it (transaction enlistment, PublishedByUserID). Cloud drivers ignore it. */
+export interface DatabasePublishOptions {
+    readonly Kind: 'Database';
+}
+export interface ITransportDriver {
+    readonly Name: string;
+    readonly Capabilities: TransportCapabilities;
+    Publish(topic: TopicBinding, messages: WorkMessage[], subscriptions: SubscriptionBinding[], opts?: DatabasePublishOptions): Promise<PublishResult[]>;
+    OpenConsumer<TPayload extends WorkJson>(subscription: SubscriptionBinding): ITransportConsumer<TPayload>;
+    Operator(): ITransportOperator;
+    ValidateBindings(topic: TopicBinding, subscriptions: SubscriptionBinding[]): Promise<BindingValidationIssue[]>;
+}
+export interface ITransportConsumer<TPayload extends WorkJson = WorkJson> {
+    /** Never returns two deliveries of one partition key for a partitioned subscription (spec 03 §7). */
+    Receive(max: number, waitSeconds: number, signal: AbortSignal): Promise<ReceivedDelivery<TPayload>[]>;
+    /** A thrown error is transient (the runtime retries next tick). 'Cancelled' only where CancelInFlight. */
+    ExtendLease(delivery: ReceivedDelivery<TPayload>, leaseSeconds: number, progress?: WorkProgress): Promise<LeaseExtension>;
+    Complete(delivery: ReceivedDelivery<TPayload>): Promise<SettleResult>;
+    Retry(delivery: ReceivedDelivery<TPayload>, delaySeconds: number, error: string): Promise<SettleResult>;
+    DeadLetter(delivery: ReceivedDelivery<TPayload>, reason: string, error: string | null): Promise<SettleResult>;
+    /** Database: no attempt consumed. SQS: the receive is already counted (spec 03 §5.1). */
+    Release(delivery: ReceivedDelivery<TPayload>): Promise<SettleResult>;
+    /**
+     * Token-fenced: a cancelled InFlight delivery held by this token → Discarded now, freeing its key (spec 03 §7).
+     * Anything else → LeaseLost with no change. Transports without CancelInFlight always return LeaseLost.
+     */
+    AcknowledgeCancel(delivery: ReceivedDelivery<TPayload>): Promise<SettleResult>;
+    /** Releases the consumer's independent executor / clients (spec 03 §11). */
+    Close(): Promise<void>;
+}
+export interface BindingValidationIssue {
+    Severity: 'Error' | 'Warning';
+    Subject: string;
+    Message: string;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,26 @@
+import type { WorkJson, WorkMessage } from './envelope.js';
+import type { PublishError, PublishRequest } from './publishing.js';
+import type { TopicBinding } from './transport.js';
+export declare const MAX_ENVELOPE_BYTES = 262144;
+export declare const MAX_ATTRIBUTES = 10;
+export declare const MAX_ATTRIBUTE_KEY_LENGTH = 64;
+export declare const MAX_ATTRIBUTE_VALUE_LENGTH = 256;
+export declare const MAX_PARTITION_KEY_LENGTH = 200;
+export declare const MAX_DEDUPLICATION_KEY_LENGTH = 200;
+export declare const MIN_DEDUPLICATION_TTL_SECONDS = 60;
+export declare const MAX_DEDUPLICATION_TTL_SECONDS = 2592000;
+/** No dot: a dotted name is MJ's `source.field` filter form, so a dotted attribute key could never be filtered. Shared with filter.ts so a filter can only name a key a producer could publish. */
+export declare const ATTRIBUTE_KEY_PATTERN: RegExp;
+export declare function IsWorkQueueUuid(value: string): boolean;
+export declare function IsReservedAttributeKey(key: string): boolean;
+/** First failing envelope rule (spec 03 §1.1) that core can check without MJ state, or null. */
+export declare function ValidatePublishRequest(topic: TopicBinding, request: PublishRequest): PublishError | null;
+export declare function BuildWorkMessage<TPayload extends WorkJson = WorkJson>(topicName: string, request: PublishRequest<TPayload>, publishedAt: Date, newId: () => string): WorkMessage<TPayload>;
+export declare function SerializedEnvelopeBytes(message: WorkMessage): number;
+/**
+ * Sorted-key JSON of the fields that identify a publish — never MessageID, Topic or PublishedAt (spec 03 §2.1).
+ * Two publishes that reuse a MessageID are the same publish exactly when their canonical envelopes are equal,
+ * however the producer ordered its object keys.
+ */
+export declare function CanonicalEnvelope(message: WorkMessage): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,6BAA6B,UAAU,CAAC;AAErD,mMAAmM;AACnM,eAAO,MAAM,qBAAqB,QAA0B,CAAC;AAO7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CASxG;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,QAAQ,GAAG,QAAQ,EACjE,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EACjC,WAAW,EAAE,IAAI,EACjB,KAAK,EAAE,MAAM,MAAM,GACpB,WAAW,CAAC,QAAQ,CAAC,CAWvB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAgB9D"}

package/dist/validation.js

@@ -0,0 +1,177 @@
+import { CreatePublishError, PublishErrorCodes } from './publishing.js';
+export const MAX_ENVELOPE_BYTES = 262144;
+export const MAX_ATTRIBUTES = 10;
+export const MAX_ATTRIBUTE_KEY_LENGTH = 64;
+export const MAX_ATTRIBUTE_VALUE_LENGTH = 256;
+export const MAX_PARTITION_KEY_LENGTH = 200;
+export const MAX_DEDUPLICATION_KEY_LENGTH = 200;
+export const MIN_DEDUPLICATION_TTL_SECONDS = 60;
+export const MAX_DEDUPLICATION_TTL_SECONDS = 2592000;
+/** No dot: a dotted name is MJ's `source.field` filter form, so a dotted attribute key could never be filtered. Shared with filter.ts so a filter can only name a key a producer could publish. */
+export const ATTRIBUTE_KEY_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+const UUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+const RESERVED_ATTRIBUTE_PREFIXES = ['mj.', 'mj_'];
+const SIZE_PLACEHOLDER_MESSAGE_ID = '00000000-0000-0000-0000-000000000000';
+const SIZE_PLACEHOLDER_PUBLISHED_AT = new Date(Date.UTC(2000, 0, 1));
+const utf8 = new TextEncoder();
+export function IsWorkQueueUuid(value) {
+    return UUID_PATTERN.test(value);
+}
+export function IsReservedAttributeKey(key) {
+    const lower = key.toLowerCase();
+    return RESERVED_ATTRIBUTE_PREFIXES.some((prefix) => lower.startsWith(prefix));
+}
+/** First failing envelope rule (spec 03 §1.1) that core can check without MJ state, or null. */
+export function ValidatePublishRequest(topic, request) {
+    return (validateMessageID(request) ??
+        validateAttributes(request) ??
+        validatePayloadShape(request) ??
+        validatePartitionKey(request) ??
+        validateDeduplication(request) ??
+        validateSize(topic, request));
+}
+export function BuildWorkMessage(topicName, request, publishedAt, newId) {
+    return {
+        MessageID: request.MessageID ?? newId(),
+        Topic: topicName,
+        ...(request.PartitionKey !== undefined ? { PartitionKey: request.PartitionKey } : {}),
+        Attributes: { ...(request.Attributes ?? {}) },
+        ...(request.Payload !== undefined ? { Payload: request.Payload } : {}),
+        ...(request.PayloadRef !== undefined ? { PayloadRef: { ...request.PayloadRef } } : {}),
+        ...(request.CorrelationID !== undefined ? { CorrelationID: request.CorrelationID } : {}),
+        PublishedAt: publishedAt.toISOString(),
+    };
+}
+export function SerializedEnvelopeBytes(message) {
+    return utf8.encode(JSON.stringify(message)).length;
+}
+/**
+ * Sorted-key JSON of the fields that identify a publish — never MessageID, Topic or PublishedAt (spec 03 §2.1).
+ * Two publishes that reuse a MessageID are the same publish exactly when their canonical envelopes are equal,
+ * however the producer ordered its object keys.
+ */
+export function CanonicalEnvelope(message) {
+    const compared = {};
+    if (message.PartitionKey !== undefined) {
+        compared.PartitionKey = message.PartitionKey;
+    }
+    compared.Attributes = { ...message.Attributes };
+    if (message.Payload !== undefined) {
+        compared.Payload = message.Payload;
+    }
+    if (message.PayloadRef !== undefined) {
+        compared.PayloadRef = payloadRefJson(message.PayloadRef);
+    }
+    if (message.CorrelationID !== undefined) {
+        compared.CorrelationID = message.CorrelationID;
+    }
+    return JSON.stringify(sortKeys(compared));
+}
+/** Only the fields that are present: an optional property typed `undefined` is not a WorkJson value. */
+function payloadRefJson(ref) {
+    const json = { Uri: ref.Uri };
+    if (ref.ContentType !== undefined) {
+        json.ContentType = ref.ContentType;
+    }
+    if (ref.SizeBytes !== undefined) {
+        json.SizeBytes = ref.SizeBytes;
+    }
+    if (ref.Checksum !== undefined) {
+        json.Checksum = ref.Checksum;
+    }
+    return json;
+}
+/** Object keys sorted recursively; array order is significant and kept. */
+function sortKeys(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortKeys);
+    }
+    if (typeof value !== 'object' || value === null) {
+        return value;
+    }
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+        sorted[key] = sortKeys(value[key]);
+    }
+    return sorted;
+}
+function validateMessageID(request) {
+    if (request.MessageID === undefined || IsWorkQueueUuid(request.MessageID)) {
+        return null;
+    }
+    return CreatePublishError(PublishErrorCodes.InvalidMessageID, `MessageID '${request.MessageID}' is not a UUID`);
+}
+function validateAttributes(request) {
+    if (request.Attributes === undefined) {
+        return null;
+    }
+    const entries = Object.entries(request.Attributes);
+    if (entries.length > MAX_ATTRIBUTES) {
+        return invalidAttributes(`At most ${MAX_ATTRIBUTES} attributes are allowed; got ${entries.length}`);
+    }
+    for (const [key, value] of entries) {
+        if (!ATTRIBUTE_KEY_PATTERN.test(key)) {
+            return invalidAttributes(`Attribute key '${key}' must be 1-${MAX_ATTRIBUTE_KEY_LENGTH} characters of A-Z a-z 0-9 _ - (no dots)`);
+        }
+        if (IsReservedAttributeKey(key)) {
+            return invalidAttributes(`Attribute key '${key}' uses a reserved prefix (mj. or mj_)`);
+        }
+        if (typeof value !== 'string' || value.length === 0 || value.length > MAX_ATTRIBUTE_VALUE_LENGTH) {
+            return invalidAttributes(`Attribute '${key}' must be a string of 1-${MAX_ATTRIBUTE_VALUE_LENGTH} characters`);
+        }
+    }
+    return null;
+}
+function validatePayloadShape(request) {
+    if (request.Payload !== undefined && request.PayloadRef !== undefined) {
+        return CreatePublishError(PublishErrorCodes.InvalidPayload, 'Supply Payload or PayloadRef, not both');
+    }
+    if (request.PayloadRef !== undefined && (typeof request.PayloadRef.Uri !== 'string' || request.PayloadRef.Uri.length === 0)) {
+        return CreatePublishError(PublishErrorCodes.InvalidPayload, 'PayloadRef.Uri must be a non-empty string');
+    }
+    return null;
+}
+function validatePartitionKey(request) {
+    const key = request.PartitionKey;
+    if (key === undefined || (key.length > 0 && key.length <= MAX_PARTITION_KEY_LENGTH)) {
+        return null;
+    }
+    return CreatePublishError(PublishErrorCodes.InvalidPartitionKey, `PartitionKey must be 1-${MAX_PARTITION_KEY_LENGTH} characters`);
+}
+function validateDeduplication(request) {
+    const key = request.DeduplicationKey;
+    const ttl = request.DeduplicationTTLSeconds;
+    if (key === undefined) {
+        return ttl === undefined ? null : invalidDeduplication('DeduplicationTTLSeconds requires a DeduplicationKey');
+    }
+    if (key.length === 0 || key.length > MAX_DEDUPLICATION_KEY_LENGTH) {
+        return invalidDeduplication(`DeduplicationKey must be 1-${MAX_DEDUPLICATION_KEY_LENGTH} characters`);
+    }
+    if (ttl !== undefined && (!Number.isInteger(ttl) || ttl < MIN_DEDUPLICATION_TTL_SECONDS || ttl > MAX_DEDUPLICATION_TTL_SECONDS)) {
+        return invalidDeduplication(`DeduplicationTTLSeconds must be an integer from ${MIN_DEDUPLICATION_TTL_SECONDS} to ${MAX_DEDUPLICATION_TTL_SECONDS}`);
+    }
+    return null;
+}
+function validateSize(topic, request) {
+    const limit = Math.min(topic.MaxPayloadBytes, MAX_ENVELOPE_BYTES);
+    let bytes;
+    try {
+        const provisional = BuildWorkMessage(topic.TopicName, request, SIZE_PLACEHOLDER_PUBLISHED_AT, () => SIZE_PLACEHOLDER_MESSAGE_ID);
+        bytes = SerializedEnvelopeBytes(provisional);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return CreatePublishError(PublishErrorCodes.InvalidPayload, `Payload is not serializable JSON: ${detail}`);
+    }
+    if (bytes > limit) {
+        return CreatePublishError(PublishErrorCodes.PayloadTooLarge, `Envelope is ${bytes} bytes; the limit for '${topic.TopicName}' is ${limit}`);
+    }
+    return null;
+}
+function invalidAttributes(message) {
+    return CreatePublishError(PublishErrorCodes.InvalidAttributes, message);
+}
+function invalidDeduplication(message) {
+    return CreatePublishError(PublishErrorCodes.InvalidDeduplication, message);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,10 +1,51 @@
 {
   "name": "@memberjunction/work-queue-core",
-  "version": "0.0.1-seed.1",
-  "description": "Trusted-publishing seed. Proves OIDC is configured; contains no code.",
-  "license": "ISC",
+  "type": "module",
+  "version": "6.2.0-edge.3",
+  "description": "MemberJunction: durable work queue contracts, consumer runtime, in-memory transport and conformance kit. No MemberJunction runtime dependencies.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./testing/vitest": {
+      "types": "./dist/testing/vitest.d.ts",
+      "default": "./dist/testing/vitest.js"
+    }
+  },
+  "files": [
+    "/dist"
+  ],
+  "author": "MemberJunction.com",
+  "license": "BUSL-1.1",
+  "peerDependencies": {
+    "vitest": ">=3.2.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/MemberJunction/MJ.git"
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck:tests": "tsc -p tsconfig.test.json"
   }
-}
+}