@memberjunction/cli 6.2.0-edge.2 → 6.2.0-edge.4

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"}

package/dist/commands/queue/work.js

@@ -0,0 +1,77 @@
+import { Command, Flags } from '@oclif/core';
+import { MJWorkLogger, SharedProviderSource, WorkQueueEngine, WorkQueueHost } from '@memberjunction/work-queue-engine';
+import { OpenWorkQueueSession } from '../../lib/work-queue/queue-session.js';
+import { RunUntilStopped, WorkerStartFailure } from '../../lib/work-queue/queue-worker.js';
+// Registers the 'AWS' transport driver factory and manifest enricher for this command only (work-queue 03 §0).
+import '@memberjunction/work-queue-engine/aws';
+const DEFAULT_IDLE_EXIT_MS = 5000;
+const DEFAULT_SHUTDOWN_DRAIN_MS = 30000;
+export default class QueueWork extends Command {
+    static { this.description = 'Run work-queue subscriptions in this process: once for a container job, or until stopped'; }
+    static { this.examples = [
+        '<%= config.bin %> <%= command.id %> --subscription venue-import --once',
+        '<%= config.bin %> <%= command.id %> --subscription venue-import --once --max 5 --concurrency 2 --max-duration-ms 3300000',
+        '<%= config.bin %> <%= command.id %> --subscription "*"',
+    ]; }
+    static { this.flags = {
+        subscription: Flags.string({ char: 's', description: "Subscription name, or '*' for every MJWorker subscription", required: true }),
+        once: Flags.boolean({ description: 'Receive up to --max deliveries, drain and exit (container-job mode)', default: false }),
+        max: Flags.integer({ description: 'With --once: how many deliveries to receive', default: 1, min: 1, dependsOn: ['once'] }),
+        'idle-exit-ms': Flags.integer({ description: 'With --once: exit after this long with an empty queue', default: DEFAULT_IDLE_EXIT_MS, min: 0, dependsOn: ['once'] }),
+        'max-duration-ms': Flags.integer({ description: "With --once: stop claiming after this long and drain (keep it below the scheduler's job deadline)", min: 1000, dependsOn: ['once'] }),
+        concurrency: Flags.integer({ description: 'Handlers in flight per subscription', default: 1, min: 1 }),
+        'shutdown-drain-ms': Flags.integer({ description: 'How long in-flight handlers get to finish on exit; the drain can take twice this', default: DEFAULT_SHUTDOWN_DRAIN_MS, min: 0 }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(QueueWork);
+        const session = await OpenWorkQueueSession();
+        let failure = null;
+        try {
+            await WorkQueueEngine.Instance.Config(false, session.User, session.Provider);
+            const host = new WorkQueueHost({
+                InstanceID: `mj-queue-work-${process.pid}`,
+                Subscriptions: [{ Name: flags.subscription, Concurrency: flags.concurrency }],
+                IdlePollMinMs: 250, IdlePollMaxMs: 2000, ShutdownDrainMs: flags['shutdown-drain-ms'],
+                SweeperIntervalMs: 0, ReconcileIntervalMs: 0, // a short-lived job neither sweeps nor re-plans
+            }, WorkQueueEngine.Instance, session.User, session.Provider, new MJWorkLogger('[mj queue work]'), { ProviderSource: new SharedProviderSource(session.Provider) });
+            failure = flags.once ? await this.runOnce(host, flags) : await this.runUntilSignal(host, flags.subscription);
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message : String(error);
+        }
+        finally {
+            await session.Close(); // only after the drain: RunUntilStopped awaits host.Shutdown() first
+        }
+        if (failure) {
+            this.error(failure, { exit: 1 });
+        }
+    }
+    /** One-shot mode. Exit 0 for an empty queue, a spent budget, MaxDuration or a signal; non-zero when nothing could run. */
+    async runOnce(host, flags) {
+        let result = { Processed: 0, Reason: 'Shutdown' };
+        const work = host
+            .RunOnce({ MaxDeliveries: flags.max, IdleExitMs: flags['idle-exit-ms'], MaxDurationMs: flags['max-duration-ms'] })
+            .then(r => { result = r; });
+        await RunUntilStopped(host, work);
+        // RunOnce returns at once when nothing could run (Task 3b); the health says why. The host is shut down by now,
+        // so a subscription that did run reports HOST_SHUT_DOWN_REASON.
+        const startFailure = WorkerStartFailure(host.GetHealth(), flags.subscription);
+        if (startFailure) {
+            return startFailure;
+        }
+        this.log(`Processed ${result.Processed} deliver${result.Processed === 1 ? 'y' : 'ies'} (${result.Reason}).`);
+        return null;
+    }
+    async runUntilSignal(host, requested) {
+        await host.Start();
+        const startFailure = WorkerStartFailure(host.GetHealth(), requested);
+        if (startFailure) {
+            await host.Shutdown();
+            return startFailure;
+        }
+        this.log(`Running ${requested}; send SIGINT or SIGTERM to stop.`);
+        await RunUntilStopped(host, new Promise(() => undefined));
+        return null;
+    }
+}
+//# sourceMappingURL=work.js.map

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

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

package/dist/commands/rubric/evaluate.d.ts

@@ -6,6 +6,9 @@ export default class RubricEvaluate extends Command {
         entity: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         record: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         evaluator: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        model: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        mode: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/rubric/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../src/commands/rubric/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,MAAM,CAAC,WAAW,SAA6D;IAC/E,MAAM,CAAC,KAAK;;;;;MAKV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAS3B"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../src/commands/rubric/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,MAAM,CAAC,WAAW,SAA6D;IAC/E,MAAM,CAAC,KAAK;;;;;;;;MAQV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3B"}

package/dist/commands/rubric/evaluate.js

@@ -5,13 +5,20 @@ export default class RubricEvaluate extends Command {
         rubric: Flags.string({ required: true, description: 'Rubric name or id, optionally @version' }),
         entity: Flags.string({ required: true, description: 'Subject entity name' }),
         record: Flags.string({ required: true, description: 'Subject record id' }),
-        evaluator: Flags.string({ description: 'LLM or Deterministic', default: 'LLM' }),
+        evaluator: Flags.string({ description: 'A registered evaluator: LLM, Decision, Agent, Deterministic, or a custom one', default: 'LLM' }),
+        prompt: Flags.string({ description: 'LLM: the judge prompt composed into Rubric Evaluator (default Rubric Evaluator - Default Judge). Decision: the decision prompt (default Default Decision)' }),
+        model: Flags.string({ description: 'AI Model ID to pin. Otherwise the prompt\'s bindings choose' }),
+        mode: Flags.string({ description: 'LLM only: SinglePass or PerCriterion', options: ['SinglePass', 'PerCriterion'] }),
     }; }
     async run() {
         const { CloseMJProvider, RubricCommands } = await import('@memberjunction/testing-cli');
         const { flags } = await this.parse(RubricEvaluate);
         try {
-            await new RubricCommands().Evaluate(flags.rubric, flags.entity, flags.record, flags.evaluator);
+            await new RubricCommands().Evaluate(flags.rubric, flags.entity, flags.record, flags.evaluator, {
+                ...(flags.prompt ? { PromptName: flags.prompt } : {}),
+                ...(flags.model ? { ModelID: flags.model } : {}),
+                ...(flags.mode === 'SinglePass' || flags.mode === 'PerCriterion' ? { Mode: flags.mode } : {}),
+            });
         }
         finally {
             await CloseMJProvider();

package/dist/commands/rubric/evaluate.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../../src/commands/rubric/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;aAC1C,gBAAW,GAAG,yDAAyD,CAAC;aACxE,UAAK,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;QAC/F,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;QAC5E,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAC1E,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACjF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QACxF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjG,CAAC;gBAAS,CAAC;YACT,MAAM,eAAe,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC"}
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../../src/commands/rubric/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;aAC1C,gBAAW,GAAG,yDAAyD,CAAC;aACxE,UAAK,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;QAC/F,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;QAC5E,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAC1E,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8EAA8E,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACxI,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2JAA2J,EAAE,CAAC;QAClM,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC;QACnG,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC;KACrH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QACxF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,IAAI,cAAc,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE;gBAC7F,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9F,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,eAAe,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC"}

package/dist/commands/sync/push.d.ts

@@ -1,9 +1,34 @@
-/**
- * Thin oclif shim — the real logic lives in {@link SyncPushPlugin} in
- * `@memberjunction/metadata-sync/plugins` (plan §3, open-question #2 "shim"
- * approach). oclif discovers this default export and routes `mj sync push` to it;
- * the plugin inherits `--format`/`--verbose`/`--no-banner`, the runtime advisory,
- * and uniform result emission from BaseCLIPlugin.
- */
-export { SyncPushPlugin as default } from '@memberjunction/metadata-sync/plugins';
+import type { MJCLIResult, PluginUsage } from '@memberjunction/cli-core';
+import { SyncPushPlugin } from '@memberjunction/metadata-sync/plugins';
+export default class SyncPush extends SyncPushPlugin {
+    static flags: {
+        'skip-cache-clear': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        ci: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'no-validate': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'delete-db-only': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'isolated-transactions': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'parallel-batch-size': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        include: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        exclude: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        incremental: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'change-detail': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    static Usage: PluginUsage;
+    protected Execute(): Promise<MJCLIResult>;
+    /**
+     * Whether a failed push left rows in the database. False only when the outcome positively says
+     * the push rolled back and committed nothing; anything unreadable counts as "it may have".
+     */
+    private failedPushLeftWrites;
+    /**
+     * Whether a successful push positively reports that it wrote nothing: it was cancelled before
+     * writing, or it created, updated and deleted no rows. A result without those counts counts as
+     * "it may have written".
+     */
+    private successfulPushWroteNothing;
+    /** Clears the shared cache unless this was a dry run (which writes nothing). */
+    private clearSharedCache;
+}
 //# sourceMappingURL=push.d.ts.map

package/dist/commands/sync/push.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/push.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/push.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAOvE,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,cAAc;IAClD,MAAM,CAAC,KAAK;;;;;;;;;;;;;MAKV;IAEF,MAAM,CAAC,KAAK,EAAE,WAAW,CAMvB;cAEuB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAwBxD;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAWlC,gFAAgF;YAClE,gBAAgB;CAI/B"}

package/dist/commands/sync/push.js

@@ -1,9 +1,97 @@
 /**
- * Thin oclif shim — the real logic lives in {@link SyncPushPlugin} in
- * `@memberjunction/metadata-sync/plugins` (plan §3, open-question #2 "shim"
- * approach). oclif discovers this default export and routes `mj sync push` to it;
- * the plugin inherits `--format`/`--verbose`/`--no-banner`, the runtime advisory,
- * and uniform result emission from BaseCLIPlugin.
+ * oclif entry for `mj sync push`. The logic lives in {@link SyncPushPlugin} in
+ * `@memberjunction/metadata-sync/plugins`; this subclass only adds the shared-cache clear that must
+ * follow a database write, before the plugin's Cleanup() ends the process. Running servers never
+ * hear about rows written here, so without the clear they keep serving the old ones.
+ *
+ * The clear runs only when the push may have changed the database:
+ * - A successful push clears unless it reports that it wrote nothing: it was cancelled before
+ *   writing, or it created, updated and deleted no rows. Clearing after a no-op push would drop
+ *   every server's cache on every deploy for nothing.
+ * - A failed push clears only when it left something behind. An atomic push (the default) rolls its
+ *   writes back, and `PushAbortedError` says so: `rolledBack`, plus the rows a non-atomic push
+ *   committed anyway.
+ * - When the outcome cannot be read, the clear still runs: a needless reload is cheaper than a fleet
+ *   serving rows that are no longer in the database.
  */
-export { SyncPushPlugin as default } from '@memberjunction/metadata-sync/plugins';
+import { Flags } from '@oclif/core';
+import { SyncPushPlugin } from '@memberjunction/metadata-sync/plugins';
+import { PushAbortedError } from '@memberjunction/metadata-sync';
+import { AppendSharedCacheClear, ClearSharedCacheAfterWrite, SKIP_CACHE_CLEAR_ENV } from '../../lib/shared-cache.js';
+export default class SyncPush extends SyncPushPlugin {
+    static { this.flags = {
+        ...SyncPushPlugin.flags,
+        'skip-cache-clear': Flags.boolean({
+            description: `Do not clear the shared Redis cache (REDIS_URL) after pushing. Also: ${SKIP_CACHE_CLEAR_ENV}=1`,
+        }),
+    }; }
+    static { this.Usage = {
+        ...SyncPushPlugin.Usage,
+        flags: [
+            ...(SyncPushPlugin.Usage?.flags ?? []),
+            { name: '--skip-cache-clear', type: 'boolean', description: 'Do not clear the shared Redis cache after pushing' },
+        ],
+    }; }
+    async Execute() {
+        let result;
+        try {
+            result = await super.Execute();
+        }
+        catch (error) {
+            // Runs after the plugin's rollback, so servers reload whatever the push did commit.
+            if (this.failedPushLeftWrites(undefined, error)) {
+                const report = await this.clearSharedCache('mj sync push (failed)');
+                if (report) {
+                    this.Host.Log(report.Message, report.Ok ? 'info' : 'warn');
+                }
+            }
+            throw error;
+        }
+        if (!result.success && !this.failedPushLeftWrites(result, undefined)) {
+            return result; // rolled back cleanly: nothing in the database changed, so nothing is stale
+        }
+        if (result.success && this.successfulPushWroteNothing(result)) {
+            return result; // cancelled, or a no-op: nothing in the database changed
+        }
+        const report = await this.clearSharedCache(result.success ? 'mj sync push' : 'mj sync push (failed)');
+        return AppendSharedCacheClear(result, report, this.Host);
+    }
+    /**
+     * Whether a failed push left rows in the database. False only when the outcome positively says
+     * the push rolled back and committed nothing; anything unreadable counts as "it may have".
+     */
+    failedPushLeftWrites(result, error) {
+        if (error instanceof PushAbortedError) {
+            return !error.rolledBack || error.committedWrites.length > 0;
+        }
+        if (error) {
+            return true; // an error the push did not describe
+        }
+        const data = result?.data;
+        if (typeof data?.rolledBack !== 'boolean') {
+            return true;
+        }
+        return !data.rolledBack || (data.committedOutsideTransaction ?? 0) > 0;
+    }
+    /**
+     * Whether a successful push positively reports that it wrote nothing: it was cancelled before
+     * writing, or it created, updated and deleted no rows. A result without those counts counts as
+     * "it may have written".
+     */
+    successfulPushWroteNothing(result) {
+        const data = result.data;
+        if (data?.cancelled === true) {
+            return true;
+        }
+        if (typeof data?.created !== 'number' || typeof data.updated !== 'number' || typeof data.deleted !== 'number') {
+            return false;
+        }
+        return data.created + data.updated + data.deleted === 0;
+    }
+    /** Clears the shared cache unless this was a dry run (which writes nothing). */
+    async clearSharedCache(commandName) {
+        const flags = this.GetFlags();
+        return flags['dry-run'] ? null : ClearSharedCacheAfterWrite(commandName, flags['skip-cache-clear']);
+    }
+}
 //# sourceMappingURL=push.js.map

package/dist/commands/sync/push.js.map

@@ -1 +1 @@
-{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/commands/sync/push.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/commands/sync/push.ts"],"names":[],"mappings":"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"}

package/dist/commands/user/clone.d.ts

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+/**
+ * CLI command: `mj user clone`.
+ *
+ * Creates a new user as a copy of an existing one through the `MJ: Users` clone configuration. From a
+ * template user (IsTemplate) the default `template` preset copies everything the template was set up
+ * with, dashboards and conversations included; from an ordinary user, choose one of the other presets.
+ * Runs as the system user, so it needs no sign-in; it is meant for administrators and install scripts
+ * (an app's post-install hook pre-provisions the person who will sign in).
+ */
+export default class UserClone extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        from: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        email: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        first: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        last: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        preset: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        inactive: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** The user with this email, if any. */
+    private findUser;
+}
+//# sourceMappingURL=clone.d.ts.map

package/dist/commands/user/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../src/commands/user/clone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAc7C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAAqE;IAEvF,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;;;;;;MAWV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA4D1B,wCAAwC;YAC1B,QAAQ;CAavB"}