@memberjunction/cli 6.2.0-edge.1 → 6.2.0-edge.3

package/dist/commands/queue/export-topology.js

@@ -0,0 +1,40 @@
+import { writeFile } from 'node:fs/promises';
+import { Command, Flags } from '@oclif/core';
+import { WorkQueueEngine } from '@memberjunction/work-queue-engine';
+// Registers the 'AWS' transport driver factory and manifest enricher for this command only (work-queue 03 §0).
+import '@memberjunction/work-queue-engine/aws';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+export default class QueueExportTopology extends Command {
+    static { this.description = 'Write the topology manifest for one transport (input to the Terraform module)'; }
+    static { this.examples = ['<%= config.bin %> <%= command.id %> --transport AWS-prod --output infrastructure/work-queue/manifest.json']; }
+    static { this.flags = {
+        transport: Flags.string({ char: 't', description: 'Transport name', required: true }),
+        output: Flags.string({ char: 'o', description: 'File to write; stdout when omitted' }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueueExportTopology);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            await WorkQueueEngine.Instance.Config(false, session.User, session.Provider);
+            const manifest = JSON.stringify(WorkQueueEngine.Instance.ExportManifest(flags.transport), null, 2);
+            if (flags.output) {
+                await writeFile(flags.output, `${manifest}\n`, 'utf8');
+                this.log(`Wrote ${flags.output}`);
+            }
+            else {
+                this.log(manifest);
+            }
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=export-topology.js.map

package/dist/commands/queue/export-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-topology.js","sourceRoot":"","sources":["../../../src/commands/queue/export-topology.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,+GAA+G;AAC/G,OAAO,uCAAuC,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;aAC/C,gBAAW,GAAG,+EAA+E,CAAC;aAE9F,aAAQ,GAAG,CAAC,2GAA2G,CAAC,CAAC;aAEzH,UAAK,GAAG;QACb,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACrF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;KACvF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACnG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,QAAQ,IAAI,EAAE,MAAM,CAAC,CAAC;gBACvD,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC"}

package/dist/commands/queue/import-bindings.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+import '@memberjunction/work-queue-engine/aws';
+export default class QueueImportBindings extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        file: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=import-bindings.d.ts.map

package/dist/commands/queue/import-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-bindings.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/import-bindings.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAGnD,OAAO,uCAAuC,CAAC;AAI/C,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;IACtD,MAAM,CAAC,WAAW,SAA8F;IAEhH,MAAM,CAAC,QAAQ,WAA0H;IAEzI,MAAM,CAAC,IAAI;;MAET;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB3B"}

package/dist/commands/queue/import-bindings.js

@@ -0,0 +1,41 @@
+import { readFile } from 'node:fs/promises';
+import { Args, Command, Flags } from '@oclif/core';
+import { WorkQueueEngine } from '@memberjunction/work-queue-engine';
+// Registers the 'AWS' transport driver factory and manifest enricher for this command only (work-queue 03 §0).
+import '@memberjunction/work-queue-engine/aws';
+import { FormatBindingIssues, HasBindingErrors, ParseBindingImport } from '../../lib/work-queue/queue-format.js';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+export default class QueueImportBindings extends Command {
+    static { this.description = 'Record cloud resource bindings (Terraform output) on work-queue topics and subscriptions'; }
+    static { this.examples = ['terraform output -json mj_work_queue_bindings > bindings.json && <%= config.bin %> <%= command.id %> bindings.json']; }
+    static { this.args = {
+        file: Args.string({ description: 'BindingImport JSON file', required: true }),
+    }; }
+    static { this.flags = {
+        json: Flags.boolean({ description: 'Print issues as JSON', default: false }),
+    }; }
+    async run() {
+        const { args, flags } = await this.parse(QueueImportBindings);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            const bindings = ParseBindingImport(await readFile(args.file, 'utf8'));
+            await WorkQueueEngine.Instance.Config(false, session.User, session.Provider);
+            const issues = await WorkQueueEngine.Instance.ImportBindings(bindings, session.User);
+            this.log(flags.json ? JSON.stringify(issues, null, 2) : FormatBindingIssues(issues));
+            if (HasBindingErrors(issues)) {
+                failure = 'Binding import reported errors.';
+            }
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=import-bindings.js.map

package/dist/commands/queue/import-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-bindings.js","sourceRoot":"","sources":["../../../src/commands/queue/import-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,+GAA+G;AAC/G,OAAO,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AACjH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;aAC/C,gBAAW,GAAG,0FAA0F,CAAC;aAEzG,aAAQ,GAAG,CAAC,oHAAoH,CAAC,CAAC;aAElI,SAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC9E,CAAC;aAEK,UAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KAC7E,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACvE,MAAM,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACrF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;YACrF,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,OAAO,GAAG,iCAAiC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC"}

package/dist/commands/queue/index.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class Queue extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAC,WAAW,SAAoC;IAEtD,MAAM,CAAC,QAAQ,WAIb;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAe3B"}

package/dist/commands/queue/index.js

@@ -0,0 +1,25 @@
+import { Command } from '@oclif/core';
+export default class Queue extends Command {
+    static { this.description = 'Operate the durable work queue'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> publish --topic samples.hello --payload \'{"name":"Paul"}\'',
+        '<%= config.bin %> <%= command.id %> stats',
+        '<%= config.bin %> <%= command.id %> dead-letters --subscription email.unsubscribe',
+    ]; }
+    async run() {
+        this.log('MemberJunction Work Queue\n');
+        this.log('  mj queue publish               - Publish test messages to a topic from this machine');
+        this.log('  mj queue stats                 - Counts per subscription');
+        this.log("  mj queue dead-letters          - List a subscription's dead letters");
+        this.log('  mj queue partitions            - List in-flight / blocked partition keys');
+        this.log('  mj queue replay                - Replay one dead letter');
+        this.log('  mj queue discard               - Discard a pending or dead-lettered delivery, or cancel one in flight');
+        this.log('  mj queue backlog               - The autoscaler metric for one subscription');
+        this.log('  mj queue work                  - Run subscriptions here: --once for a container job, or until stopped');
+        this.log('  mj queue export-topology       - Write the topology manifest for Terraform');
+        this.log('  mj queue import-bindings       - Record cloud resource bindings from Terraform output');
+        this.log('  mj queue validate-bindings     - Check topology and cloud bindings');
+        this.log('\nRun "mj queue COMMAND --help" for details.');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/queue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;aACjC,gBAAW,GAAG,gCAAgC,CAAC;aAE/C,aAAQ,GAAG;QAChB,iGAAiG;QACjG,2CAA2C;QAC3C,mFAAmF;KACpF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;QAClG,IAAI,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;QAClF,IAAI,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QACtE,IAAI,CAAC,GAAG,CAAC,yGAAyG,CAAC,CAAC;QACpH,IAAI,CAAC,GAAG,CAAC,+EAA+E,CAAC,CAAC;QAC1F,IAAI,CAAC,GAAG,CAAC,yGAAyG,CAAC,CAAC;QACpH,IAAI,CAAC,GAAG,CAAC,8EAA8E,CAAC,CAAC;QACzF,IAAI,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;QACpG,IAAI,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC3D,CAAC"}

package/dist/commands/queue/partitions.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class QueuePartitions extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        subscription: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        condition: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        cursor: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'page-size': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=partitions.d.ts.map

package/dist/commands/queue/partitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitions.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/partitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,MAAM,CAAC,WAAW,SAA0E;IAE5F,MAAM,CAAC,QAAQ,WAAgG;IAE/G,MAAM,CAAC,KAAK;;;;;;MAMV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB3B"}

package/dist/commands/queue/partitions.js

@@ -0,0 +1,36 @@
+import { Command, Flags } from '@oclif/core';
+import { WorkQueueListPartitionsOperation } from '@memberjunction/core-entities';
+import { FormatPartitions, PARTITION_CONDITION_OPTIONS, RequireOperationOutput, ToPartitionCondition } from '../../lib/work-queue/queue-format.js';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+export default class QueuePartitions extends Command {
+    static { this.description = "List a work-queue subscription's in-flight or blocked partition keys"; }
+    static { this.examples = ['<%= config.bin %> <%= command.id %> --subscription integration.apply --condition Blocked']; }
+    static { this.flags = {
+        subscription: Flags.string({ char: 's', description: 'Subscription name', required: true }),
+        condition: Flags.string({ description: 'Only keys in this condition', options: [...PARTITION_CONDITION_OPTIONS] }),
+        cursor: Flags.string({ description: 'nextCursor from a previous page' }),
+        'page-size': Flags.integer({ description: 'Items per page (1–500)', default: 50 }),
+        json: Flags.boolean({ description: 'Print JSON instead of a table', default: false }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueuePartitions);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            const input = { subscriptionName: flags.subscription, condition: ToPartitionCondition(flags.condition), cursor: flags.cursor, pageSize: flags['page-size'] };
+            const result = await new WorkQueueListPartitionsOperation().Execute(input, { provider: session.Provider, user: session.User });
+            const output = RequireOperationOutput(result, 'WorkQueue.ListPartitions');
+            this.log(flags.json ? JSON.stringify(output, null, 2) : FormatPartitions(output));
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=partitions.js.map

package/dist/commands/queue/partitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitions.js","sourceRoot":"","sources":["../../../src/commands/queue/partitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACnJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;aAC3C,gBAAW,GAAG,sEAAsE,CAAC;aAErF,aAAQ,GAAG,CAAC,0FAA0F,CAAC,CAAC;aAExG,UAAK,GAAG;QACb,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC3F,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,CAAC,GAAG,2BAA2B,CAAC,EAAE,CAAC;QAClH,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;QACxE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAClF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACtF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7J,MAAM,MAAM,GAAG,MAAM,IAAI,gCAAgC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/H,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;YAC1E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC"}

package/dist/commands/queue/publish.d.ts

@@ -0,0 +1,35 @@
+import { Command } from '@oclif/core';
+import type { PublishRequest, PublishResult, WorkJson } from '@memberjunction/work-queue-core';
+/** Turns `key=value` flags into message attributes; the first `=` splits, so values may contain `=`. */
+export declare function ParseAttributes(pairs: string[] | undefined): Record<string, string>;
+/** Parses the --payload JSON; any JSON value is a legal payload, an object is the useful one. */
+export declare function ParsePayload(json: string): WorkJson;
+export interface PublishFlags {
+    Payload: WorkJson;
+    PartitionKey?: string;
+    DedupKey?: string;
+    Attributes: Record<string, string>;
+    Count: number;
+}
+/**
+ * One request per copy. With --count above 1 each copy carries a `sequence` attribute (1-based) so the copies can
+ * be told apart in logs and dead-letter lists; a --dedup-key applies to the first copy only, since the ledger
+ * would (correctly) report every later copy as a Duplicate.
+ */
+export declare function BuildPublishRequests(flags: PublishFlags): PublishRequest[];
+export declare function FormatPublishResults(results: PublishResult[]): string;
+export default class QueuePublish extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        topic: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        payload: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'partition-key': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'dedup-key': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        attribute: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        count: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=publish.d.ts.map

package/dist/commands/queue/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAK/F,wGAAwG;AACxG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUnF;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAMnD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,QAAQ,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CAc1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAKrE;AAED,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,MAAM,CAAC,WAAW,SAAkG;IAEpH,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;;;;;;MAQV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B3B"}

package/dist/commands/queue/publish.js

@@ -0,0 +1,94 @@
+import { Command, Flags } from '@oclif/core';
+import { WorkQueueEngine } from '@memberjunction/work-queue-engine';
+import { FormatTable } from '../../lib/work-queue/queue-format.js';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+/** Turns `key=value` flags into message attributes; the first `=` splits, so values may contain `=`. */
+export function ParseAttributes(pairs) {
+    const attributes = {};
+    for (const pair of pairs ?? []) {
+        const separator = pair.indexOf('=');
+        if (separator <= 0) {
+            throw new Error(`--attribute expects key=value, got '${pair}'`);
+        }
+        attributes[pair.slice(0, separator)] = pair.slice(separator + 1);
+    }
+    return attributes;
+}
+/** Parses the --payload JSON; any JSON value is a legal payload, an object is the useful one. */
+export function ParsePayload(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch (error) {
+        throw new Error(`--payload is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * One request per copy. With --count above 1 each copy carries a `sequence` attribute (1-based) so the copies can
+ * be told apart in logs and dead-letter lists; a --dedup-key applies to the first copy only, since the ledger
+ * would (correctly) report every later copy as a Duplicate.
+ */
+export function BuildPublishRequests(flags) {
+    return Array.from({ length: flags.Count }, (_, index) => {
+        const request = { Payload: flags.Payload, Attributes: { ...flags.Attributes } };
+        if (flags.Count > 1) {
+            request.Attributes = { ...request.Attributes, sequence: String(index + 1) };
+        }
+        if (flags.PartitionKey !== undefined) {
+            request.PartitionKey = flags.PartitionKey;
+        }
+        if (flags.DedupKey !== undefined && index === 0) {
+            request.DeduplicationKey = flags.DedupKey;
+        }
+        return request;
+    });
+}
+export function FormatPublishResults(results) {
+    return FormatTable(['#', 'Message ID', 'Status', 'Error'], results.map((result, index) => [String(index + 1), result.MessageID, result.Status, result.Error ? `${result.Error.Code}: ${result.Error.Message}` : '']));
+}
+export default class QueuePublish extends Command {
+    static { this.description = 'Publish messages to a work-queue topic from this machine through MJ code (no API key needed)'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> --topic samples.hello --payload \'{"name":"Paul"}\'',
+        '<%= config.bin %> <%= command.id %> --topic samples.hello --payload \'{"sleepMs":60000}\' --partition-key customer-42',
+        '<%= config.bin %> <%= command.id %> --topic samples.hello --count 5 --partition-key k1 --attribute source=demo',
+    ]; }
+    static { this.flags = {
+        topic: Flags.string({ char: 't', description: 'Topic name', required: true }),
+        payload: Flags.string({ char: 'p', description: 'Message payload as JSON', default: '{}' }),
+        'partition-key': Flags.string({ char: 'k', description: 'PartitionKey for Exclusive / Ordered subscriptions' }),
+        'dedup-key': Flags.string({ description: 'DeduplicationKey: a repeat within the topic TTL is reported as Duplicate' }),
+        attribute: Flags.string({ char: 'a', description: 'Message attribute as key=value (repeatable)', multiple: true }),
+        count: Flags.integer({ char: 'n', description: 'How many copies to publish in one batch', default: 1, min: 1 }),
+        json: Flags.boolean({ description: 'Print the publish results as JSON', default: false }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueuePublish);
+        const requests = BuildPublishRequests({
+            Payload: ParsePayload(flags.payload), PartitionKey: flags['partition-key'], DedupKey: flags['dedup-key'],
+            Attributes: ParseAttributes(flags.attribute), Count: flags.count,
+        });
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        let rejected = 0;
+        try {
+            await WorkQueueEngine.Instance.Config(false, session.User, session.Provider);
+            const results = await WorkQueueEngine.Instance.PublishAs(flags.topic, requests, { ContextUser: session.User });
+            rejected = results.filter(result => result.Status === 'Rejected').length;
+            this.log(flags.json ? JSON.stringify(results, null, 2) : FormatPublishResults(results));
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+        if (rejected > 0) {
+            this.error(`${rejected} of ${requests.length} message(s) were rejected`, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/commands/queue/publish.js.map

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

package/dist/commands/queue/replay.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class QueueReplay extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        subscription: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        delivery: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        note: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=replay.d.ts.map

package/dist/commands/queue/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,MAAM,CAAC,WAAW,SAAkD;IAEpE,MAAM,CAAC,QAAQ,WAAmH;IAElI,MAAM,CAAC,KAAK;;;;MAIV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB3B"}

package/dist/commands/queue/replay.js

@@ -0,0 +1,42 @@
+import { Command, Flags } from '@oclif/core';
+import { WorkQueueReplayDeadLetterOperation } from '@memberjunction/core-entities';
+import { RequireOperationOutput } from '../../lib/work-queue/queue-format.js';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+export default class QueueReplay extends Command {
+    static { this.description = 'Replay one dead-lettered work-queue delivery'; }
+    static { this.examples = ['<%= config.bin %> <%= command.id %> --subscription integration.apply --delivery <id> --note "mapping fixed"']; }
+    static { this.flags = {
+        subscription: Flags.string({ char: 's', description: 'Subscription name', required: true }),
+        delivery: Flags.string({ char: 'd', description: 'DeliveryID from `mj queue dead-letters`', required: true }),
+        note: Flags.string({ description: 'Operator note stored with the resolution' }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueueReplay);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            const input = { subscriptionName: flags.subscription, deliveryID: flags.delivery, note: flags.note };
+            const result = await new WorkQueueReplayDeadLetterOperation().Execute(input, { provider: session.Provider, user: session.User });
+            const output = RequireOperationOutput(result, 'WorkQueue.ReplayDeadLetter');
+            if (!output.supported) {
+                failure = "This subscription's transport cannot replay a single dead letter.";
+            }
+            else if (!output.replayed) {
+                failure = 'Nothing replayed: the delivery does not exist or is not dead-lettered.';
+            }
+            else {
+                this.log(`Replayed ${flags.delivery}.`);
+            }
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/commands/queue/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../../src/commands/queue/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;aACvC,gBAAW,GAAG,8CAA8C,CAAC;aAE7D,aAAQ,GAAG,CAAC,6GAA6G,CAAC,CAAC;aAE3H,UAAK,GAAG;QACb,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC3F,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,yCAAyC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC7G,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;KAChF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YACrG,MAAM,MAAM,GAAG,MAAM,IAAI,kCAAkC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjI,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO,GAAG,mEAAmE,CAAC;YAChF,CAAC;iBAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC5B,OAAO,GAAG,wEAAwE,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC"}

package/dist/commands/queue/stats.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class QueueStats extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        subscription: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/queue/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAC,WAAW,SAAmF;IAErG,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB3B"}

package/dist/commands/queue/stats.js

@@ -0,0 +1,35 @@
+import { Command, Flags } from '@oclif/core';
+import { WorkQueueGetSubscriptionStatsOperation } from '@memberjunction/core-entities';
+import { FormatStatsTable, RequireOperationOutput } from '../../lib/work-queue/queue-format.js';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+export default class QueueStats extends Command {
+    static { this.description = 'Show pending, in-flight and dead-lettered counts for work-queue subscriptions'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --subscription email.unsubscribe --json',
+    ]; }
+    static { this.flags = {
+        subscription: Flags.string({ char: 's', description: 'Subscription name; omit for every subscription' }),
+        json: Flags.boolean({ description: 'Print JSON instead of a table', default: false }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueueStats);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            const result = await new WorkQueueGetSubscriptionStatsOperation().Execute({ subscriptionName: flags.subscription }, { provider: session.Provider, user: session.User });
+            const output = RequireOperationOutput(result, 'WorkQueue.GetSubscriptionStats');
+            this.log(flags.json ? JSON.stringify(output, null, 2) : FormatStatsTable(output.subscriptions, output.failures));
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/queue/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/commands/queue/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,sCAAsC,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;aACtC,gBAAW,GAAG,+EAA+E,CAAC;aAE9F,aAAQ,GAAG;QAChB,qCAAqC;QACrC,6EAA6E;KAC9E,CAAC;aAEK,UAAK,GAAG;QACb,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;QACxG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACtF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,sCAAsC,EAAE,CAAC,OAAO,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACxK,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;YAChF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC"}

package/dist/commands/queue/usage.d.ts

@@ -0,0 +1,7 @@
+import { DomainUsageCommand } from '../../lib/domain-usage-command.js';
+/** Tier-2 usage for the `queue` domain (`mj queue usage`). */
+export default class QueueUsage extends DomainUsageCommand {
+    static description: string;
+    protected Domain: string;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/commands/queue/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,8DAA8D;AAC9D,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,kBAAkB;IACxD,MAAM,CAAC,WAAW,SAAkF;IACpG,SAAS,CAAC,MAAM,SAAW;CAC5B"}

package/dist/commands/queue/usage.js

@@ -0,0 +1,10 @@
+import { DomainUsageCommand } from '../../lib/domain-usage-command.js';
+/** Tier-2 usage for the `queue` domain (`mj queue usage`). */
+export default class QueueUsage extends DomainUsageCommand {
+    constructor() {
+        super(...arguments);
+        this.Domain = 'queue';
+    }
+    static { this.description = 'Show usage, flags, examples, and runtime hints for every `mj queue` command.'; }
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/queue/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/commands/queue/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,8DAA8D;AAC9D,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,kBAAkB;IAA1D;;QAEY,WAAM,GAAG,OAAO,CAAC;IAC7B,CAAC;aAFQ,gBAAW,GAAG,8EAA8E,AAAjF,CAAkF"}

package/dist/commands/queue/validate-bindings.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+import '@memberjunction/work-queue-engine/aws';
+export default class QueueValidateBindings extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        transport: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=validate-bindings.d.ts.map

package/dist/commands/queue/validate-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-bindings.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/validate-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C,OAAO,uCAAuC,CAAC;AAE/C,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,OAAO;IACxD,MAAM,CAAC,WAAW,SAA2E;IAE7F,MAAM,CAAC,QAAQ,WAAuG;IAEtH,MAAM,CAAC,KAAK;;;MAGV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB3B"}

package/dist/commands/queue/validate-bindings.js

@@ -0,0 +1,37 @@
+import { Command, Flags } from '@oclif/core';
+import { WorkQueueValidateBindingsOperation } from '@memberjunction/core-entities';
+import { FormatBindingIssues, HasBindingErrors, RequireOperationOutput } from '../../lib/work-queue/queue-format.js';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+// Registers the 'AWS' transport driver factory and manifest enricher for this command only (work-queue 03 §0).
+import '@memberjunction/work-queue-engine/aws';
+export default class QueueValidateBindings extends Command {
+    static { this.description = 'Validate work-queue topology and cloud bindings; exits 1 on any error'; }
+    static { this.examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --transport AWS-prod']; }
+    static { this.flags = {
+        transport: Flags.string({ char: 't', description: "Validate one transport's bindings against its resources" }),
+        json: Flags.boolean({ description: 'Print issues as JSON', default: false }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueueValidateBindings);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            const result = await new WorkQueueValidateBindingsOperation().Execute({ transportName: flags.transport }, { provider: session.Provider, user: session.User });
+            const output = RequireOperationOutput(result, 'WorkQueue.ValidateBindings');
+            this.log(flags.json ? JSON.stringify(output.issues, null, 2) : FormatBindingIssues(output.issues));
+            if (HasBindingErrors(output.issues)) {
+                failure = 'Binding validation reported errors.';
+            }
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close();
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=validate-bindings.js.map

package/dist/commands/queue/validate-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-bindings.js","sourceRoot":"","sources":["../../../src/commands/queue/validate-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACrH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,+GAA+G;AAC/G,OAAO,uCAAuC,CAAC;AAE/C,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,OAAO;aACjD,gBAAW,GAAG,uEAAuE,CAAC;aAEtF,aAAQ,GAAG,CAAC,qCAAqC,EAAE,0DAA0D,CAAC,CAAC;aAE/G,UAAK,GAAG;QACb,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;QAC9G,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KAC7E,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,kCAAkC,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9J,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;YAC5E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACnG,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,OAAO,GAAG,qCAAqC,CAAC;YAClD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC"}

package/dist/commands/queue/work.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+import '@memberjunction/work-queue-engine/aws';
+export default class QueueWork extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        subscription: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        once: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        max: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'idle-exit-ms': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'max-duration-ms': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        concurrency: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'shutdown-drain-ms': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /** One-shot mode. Exit 0 for an empty queue, a spent budget, MaxDuration or a signal; non-zero when nothing could run. */
+    private runOnce;
+    private runUntilSignal;
+}
+//# sourceMappingURL=work.d.ts.map

package/dist/commands/queue/work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../../src/commands/queue/work.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAM7C,OAAO,uCAAuC,CAAC;AAK/C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAA8F;IAEhH,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;;;;;;MAQV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B1B,0HAA0H;YAC5G,OAAO;YAgBP,cAAc;CAW7B"}