npm - @wildo-ai/saas-models - Versions diffs - 1.0.1 → 1.1.0 - Mend

@wildo-ai/saas-models 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1282) hide show

package/dist/esm/queue/queues.shared.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queues.shared.schemas.js","sourceRoot":"","sources":["../../../src/queue/queues.shared.schemas.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"queues.shared.schemas.js","sourceRoot":"","sources":["../../../../src/queue/queues.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Queues Shared Schemas\n \n All queue-related enums, schemas, configuration, and types consolidated in a single file.\n * Includes: queue config, retry config, category registry, and monitoring schemas.\n /\n\nimport { z } from 'zod';\nimport { ErrorHandling_Strategy, RetryPolicy_BackoffType } from '../errors/errors.shared.schemas';\nimport { JobPriority, QueueRetryBackoffConfigSchema } from './jobs.shared.schemas';\n\n// ============================================================================\n// ENUMS\n// ============================================================================\n\n/\n Consumer mode for queue categories.\n /\nexport enum QueueConsumerMode {\n /* Any worker in the pool consumes (general operations, scheduled jobs) /\n SHARED = 'shared',\n /* Dedicated consumer process/pod (email, agents, exports - different resource needs) /\n DEDICATED = 'dedicated',\n /* All pods consume, filter locally (callbacks - find the pod with matching callbackId) /\n BROADCAST = 'broadcast',\n}\n\n/\n Queue health status.\n /\nexport enum QueueHealthStatus {\n HEALTHY = 'healthy',\n DEGRADED = 'degraded',\n UNHEALTHY = 'unhealthy',\n UNKNOWN = 'unknown',\n}\n\n/\n Queue variant for queue name construction.\n /\nexport enum QueueVariant {\n /* Priority queue for high/critical priority jobs /\n PRIORITY = 'priority',\n /* Dead letter queue for failed jobs /\n DEADLETTER = 'deadletter',\n}\n\n// ============================================================================\n// ZOD ENUM VALUE EXTRACTION (for Zod 4)\n// ============================================================================\n\nconst ErrorHandlingStrategyValues = Object.values(ErrorHandling_Strategy) as [string, ...string[]];\nconst QueueConsumerModeValues = Object.values(QueueConsumerMode) as [string, ...string[]];\nconst QueueHealthStatusValues = Object.values(QueueHealthStatus) as [string, ...string[]];\n\n// ============================================================================\n// QUEUE CONFIGURATION SCHEMA\n// ============================================================================\n\n/\n Queue-specific configuration for operations.\n * All fields are optional with sensible defaults.\n \n NOTE: Uses ErrorHandling_Strategy from errors module (STOP, SKIP, RETRY, FALLBACK)\n * for dead letter policy to maintain consistency across the engine.\n \n Authorization is NOT configured here - it is inherited automatically\n * from the operation's `roles` and `resourcePrimaryScope`.\n /\nexport const ResourceConfiguration_QueueConfigSchema = z.object({\n /* Priority for queue routing (HIGH/CRITICAL → priority queue) /\n priority: z.enum(JobPriority).default(JobPriority.NORMAL),\n\n /* Maximum retry attempts before dead-letter /\n maxRetries: z.number().int().min(0).default(3),\n\n /* Job execution timeout in milliseconds (default: 5 minutes) /\n timeoutMs: z.number().int().min(1000).default(300000),\n\n /\n Retry backoff timing (base delay, cap, curve). Controls how long a failed\n * job of this operation waits before each re-attempt. Optional — unset fields\n * fall back to `QUEUE_RETRY_DEFAULTS`. Honored by the queue worker via a\n * durable broker delay queue (see `QueueRetryBackoffConfig`). Distinct from\n * `maxRetries` (how many attempts) and `timeoutMs` (per-attempt execution cap).\n /\n retryConfig: QueueRetryBackoffConfigSchema.optional(),\n\n /\n Dead letter handling policy (reuses ErrorHandling_Strategy)\n * - STOP: discard the job\n * - RETRY: retry with backoff\n * - FALLBACK: move to dead-letter queue\n /\n errorHandlingStrategy: z.enum(ErrorHandlingStrategyValues).default(ErrorHandling_Strategy.FALLBACK),\n}).optional();\n\nexport type ResourceConfiguration_QueueConfig = z.infer<typeof ResourceConfiguration_QueueConfigSchema>;\n\n/\n Default values for queue configuration.\n * Used when queueConfig is not specified on an operation.\n /\nexport const QUEUE_CONFIG_DEFAULTS = {\n priority: 'normal',\n maxRetries: 3,\n timeoutMs: 300000, // 5 minutes\n // Retry backoff timing defaults (baseDelayMs / maxDelayMs / retryPolicy) live in\n // QUEUE_RETRY_DEFAULTS below — the single source of truth the enqueue path reads\n // per-field to resolve an operation's optional `queueConfig.retryConfig`.\n errorHandlingStrategy: ErrorHandling_Strategy.FALLBACK,\n} as const;\n\n// ============================================================================\n// QUEUE RETRY CONFIGURATION SCHEMA\n// ============================================================================\n\n/\n Retry configuration for queue jobs.\n * Aligns with existing patterns from WildoError and remote-client-base.\n /\nexport const QueueRetryConfigSchema = z.object({\n /* Retry policy (matches WildoError pattern) /\n retryPolicy: z.enum(RetryPolicy_BackoffType).default(RetryPolicy_BackoffType.EXPONENTIAL),\n\n /* Maximum retry attempts /\n maxRetries: z.number().int().min(0).default(3),\n\n /* Base delay in ms (for first retry / base of exponential) /\n baseDelayMs: z.number().int().min(100).default(1000),\n\n /* Maximum delay cap (prevents infinite backoff) /\n maxDelayMs: z.number().int().min(1000).default(60000), // 1 minute cap\n\n /* Timeout for job execution /\n timeoutMs: z.number().int().min(1000).default(300000), // 5 minutes\n});\n\nexport type QueueRetryConfig = z.infer<typeof QueueRetryConfigSchema>;\n\n/\n Default retry configuration values.\n * Matches existing patterns from remote-client-base.backend.service.ts:\n * - RETRY_DELAY = 1000\n * - RETRY_MAX_ATTEMPTS = 3\n * - TIMEOUT = 300000\n /\nexport const QUEUE_RETRY_DEFAULTS: QueueRetryConfig = {\n retryPolicy: RetryPolicy_BackoffType.EXPONENTIAL,\n maxRetries: 3,\n baseDelayMs: 1000,\n maxDelayMs: 60000,\n timeoutMs: 300000,\n};\n\n// ============================================================================\n// QUEUE CATEGORY CONFIGURATION SCHEMA\n// ============================================================================\n\n/\n Rate limit configuration for domain queues.\n /\nexport const QueueRateLimitConfigSchema = z.object({\n /* Maximum requests in window /\n max: z.number().int().min(1),\n /* Window duration in milliseconds /\n windowMs: z.number().int().min(1000),\n});\n\nexport type QueueRateLimitConfig = z.infer<typeof QueueRateLimitConfigSchema>;\n\n/\n Queue category configuration.\n /\nexport const QueueCategoryConfigSchema = z.object({\n /* Human-readable description /\n description: z.string(),\n\n /* How consumers should handle this queue /\n consumerMode: z.enum(QueueConsumerModeValues),\n\n /* Whether this queue has a dead-letter queue /\n hasDeadletter: z.boolean().default(true),\n\n /* Whether this queue has a priority variant /\n hasPriority: z.boolean().default(false),\n\n /* Whether messages require JWT signature verification (scheduled queue) /\n requiresSignature: z.boolean().default(false),\n\n /* Rate limit configuration (for domain queues) /\n rateLimit: QueueRateLimitConfigSchema.optional(),\n\n /* Maximum concurrent executions (for domain queues) /\n concurrency: z.number().int().min(1).optional(),\n\n /* Custom timeout override (optional) /\n timeoutMs: z.number().int().min(1000).optional(),\n});\n\nexport type QueueCategoryConfig = z.infer<typeof QueueCategoryConfigSchema>;\n\n/\n Core queue categories (always available).\n * Additional domains can be registered at app startup.\n /\nexport const CORE_QUEUE_CATEGORIES: Record<string, QueueCategoryConfig> = {\n /* QUEUED resource operations (API-triggered) /\n operations: {\n description: 'QUEUED resource operations from API',\n consumerMode: QueueConsumerMode.SHARED,\n hasDeadletter: true,\n hasPriority: true,\n requiresSignature: false,\n },\n\n /* Cron/batch jobs from crontabs-manager (JWT signed) /\n scheduled: {\n description: 'Cron/batch jobs from crontabs-manager',\n consumerMode: QueueConsumerMode.SHARED,\n hasDeadletter: true,\n hasPriority: false,\n requiresSignature: true, // JWT signed messages only\n },\n\n /* Internal callback distribution /\n callbacks: {\n description: 'Internal callback distribution',\n consumerMode: QueueConsumerMode.BROADCAST,\n hasDeadletter: false,\n hasPriority: false,\n requiresSignature: false,\n },\n};\n\n/\n Registry for custom queue categories (domain-specific).\n * Populated at application startup via registerQueueCategory().\n /\nexport const customQueueCategories: Record<string, QueueCategoryConfig> = {};\n\n/\n Register a custom queue category (typically domain-specific).\n * Category names are automatically prefixed with 'domain-'.\n \n @param name - Category name (e.g., 'email', 'agents')\n * @param config - Queue category configuration\n * @throws Error if attempting to override a core category\n \n @example\n * registerQueueCategory('email', {\n * description: 'Email sending operations',\n * consumerMode: QueueConsumerMode.DEDICATED,\n * hasDeadletter: true,\n * rateLimit: { max: 100, windowMs: 60000 },\n * concurrency: 5,\n * });\n /\nexport function registerQueueCategory(name: string, config: QueueCategoryConfig): void {\n if (CORE_QUEUE_CATEGORIES[name]) {\n throw new Error(`Cannot override core queue category: ${name}`);\n }\n customQueueCategories[`domain-${name}`] = config;\n}\n\n/\n Get a queue category by name.\n * Checks both core and custom categories.\n \n @param name - Category name\n * @returns Queue category configuration or undefined\n /\nexport function getQueueCategory(name: string): QueueCategoryConfig \| undefined {\n return CORE_QUEUE_CATEGORIES[name] ?? customQueueCategories[name];\n}\n\n// ============================================================================\n// QUEUE MONITORING SCHEMAS\n// ============================================================================\n\n/\n Queue metrics for monitoring.\n /\nexport const QueueMetricsSchema = z.object({\n /* Queue name /\n queueName: z.string(),\n\n // === Queue Stats ===\n /* Messages waiting to be processed /\n pendingCount: z.number().int().min(0),\n /* Messages currently being processed /\n processingCount: z.number().int().min(0),\n /* Messages in dead letter queue /\n deadLetterCount: z.number().int().min(0),\n\n // === Rate Metrics (per minute) ===\n /* Messages published per minute /\n publishRatePerMinute: z.number().min(0),\n /* Messages consumed per minute /\n consumeRatePerMinute: z.number().min(0),\n\n // === Latency Metrics (milliseconds) ===\n /* Average processing time /\n avgProcessingTimeMs: z.number().min(0),\n /* 95th percentile processing time /\n p95ProcessingTimeMs: z.number().min(0),\n /* 99th percentile processing time /\n p99ProcessingTimeMs: z.number().min(0),\n\n // === Error Metrics ===\n /* Error rate (0-1) /\n errorRate: z.number().min(0).max(1),\n /* Retry rate (0-1) /\n retryRate: z.number().min(0).max(1),\n\n // === Timestamp ===\n /* When metrics were collected /\n collectedAt: z.date(),\n});\n\nexport type QueueMetrics = z.infer<typeof QueueMetricsSchema>;\n\n/\n Alert threshold configuration.\n /\nexport const QueueAlertThresholdSchema = z.object({\n /* Queue name or pattern to monitor /\n queuePattern: z.string(),\n\n /* Alert when dead letter count exceeds this value /\n deadLetterThreshold: z.number().int().min(0).optional(),\n\n /* Alert when processing latency exceeds this value (ms) /\n latencyThresholdMs: z.number().int().min(0).optional(),\n\n /* Alert when error rate exceeds this value (0-1) /\n errorRateThreshold: z.number().min(0).max(1).optional(),\n\n /* Alert when pending count exceeds this value /\n pendingCountThreshold: z.number().int().min(0).optional(),\n});\n\nexport type QueueAlertThreshold = z.infer<typeof QueueAlertThresholdSchema>;\n\n/\n Queue health summary.\n /\nexport const QueueHealthSummarySchema = z.object({\n /* Overall health status /\n status: z.enum(QueueHealthStatusValues),\n\n /* Number of healthy queues /\n healthyQueues: z.number().int().min(0),\n\n /* Number of degraded queues /\n degradedQueues: z.number().int().min(0),\n\n /* Number of unhealthy queues /\n unhealthyQueues: z.number().int().min(0),\n\n /* Active alerts /\n activeAlerts: z.array(z.object({\n queueName: z.string(),\n alertType: z.string(),\n value: z.number(),\n threshold: z.number(),\n triggeredAt: z.date(),\n })),\n\n /* When health was checked */\n checkedAt: z.date(),\n});\n\nexport type QueueHealthSummary = z.infer<typeof QueueHealthSummarySchema>;\n"]}

package/dist/esm/queue/queues.shared.utils.d.ts CHANGED Viewed

@@ -4,13 +4,20 @@
  * All queue-related utility classes consolidated in a single file.
  * Includes: queue naming, retry delay calculations (legacy functions).
  */
-import { QueueRetryConfig, QueueVariant } from './queues.shared.schemas.js';
+import { QueueRetryConfig, QueueVariant } from './queues.shared.schemas';
 /**
  * Utilities for building queue names.
  *
  * Mono-env architecture: each deployment has its own infra, so env is NOT
  * part of queue names. Uniqueness comes from appId alone.
  *
+ * The `appId` here is the application's canonical identifier — its Mongo `_id`,
+ * projected into the app runtime as env `APPLICATION_ID` and exposed by
+ * `AppConfigurationService.applicationId`. It is NOT the human-readable
+ * `appSlug`. Every producer AND consumer of a given app's queues must derive
+ * the name from the same identifier; keying one side on the slug orphans the
+ * queue (nothing consumes it) and a slug rename would silently orphan it again.
+ *
  * Queue naming convention:
  * - App queues: wildo.queue.{appId}.{category}[.{variant}]
  * - Reply queues: wildo.reply.{appId}.{podId}
@@ -22,14 +29,16 @@ export declare class QueueNamingUtils {
      * Build queue name following the convention:
      * wildo.queue.{appId}.{category}[.{variant}]
      *
-     * @param appId - Application identifier (slug)
+     * @param appId - Canonical application identifier (the app's Mongo `_id` /
+     *   env `APPLICATION_ID`), NOT the human-readable slug. Producer and consumer
+     *   must agree on this identifier or the queue is orphaned.
      * @param category - Queue category (operations, scheduled, callbacks, domain.*)
      * @param variant - Optional variant (priority, deadletter)
      * @returns Formatted queue name
      *
      * @example
-     * QueueNamingUtils.buildQueueName('my-app', 'operations')
-     * // => 'wildo.queue.my-app.operations'
+     * QueueNamingUtils.buildQueueName('6a08488438bc965729b8b9ff', 'operations')
+     * // => 'wildo.queue.6a08488438bc965729b8b9ff.operations'
      */
     static buildQueueName(appId: string, category: string, variant?: QueueVariant): string;
     /**
@@ -38,13 +47,47 @@ export declare class QueueNamingUtils {
      *
      * wildo.reply.{appId}.{podId}
      */
-    static buildReplyQueueName(appId: string, podId: string): string;
+    static buildReplyQueueName(appId: string, podId: string, principalSegment?: string): string;
     /**
      * Build domain-specific queue name.
      *
      * wildo.queue.{appId}.domain.{domainName}
      */
     static buildDomainQueueName(appId: string, domainName: string): string;
+    /**
+     * Build a delay (retry-hold) queue name for durable backoff.
+     *
+     * A delay queue holds a failed job for a fixed TTL, then dead-letters it back
+     * to its source queue for re-delivery. One queue exists PER distinct delay
+     * value so every message in it shares the same `x-message-ttl` — this avoids
+     * RabbitMQ's per-message-TTL head-of-line blocking (where a short-delay message
+     * would wait behind a longer-delay one ahead of it in the queue). The delay is
+     * embedded in the name, so the set of delay queues stays bounded by the (few)
+     * distinct backoff delays an app produces (`baseDelayMs × 2^attempt`, capped).
+     *
+     * `{sourceQueueName}.delay.{delayMs}`
+     *
+     * @param sourceQueueName - Full name of the queue the message returns to on expiry
+     * @param delayMs - Hold duration in ms (becomes the delay queue's `x-message-ttl`)
+     * @example
+     * QueueNamingUtils.buildDelayQueueName('wildo.queue.my-app.operations', 2000)
+     * // => 'wildo.queue.my-app.operations.delay.2000'
+     */
+    static buildDelayQueueName(sourceQueueName: string, delayMs: number): string;
+    /**
+     * Build minion-tick queue name (KD-12 of
+     * `.claude/plans/minions-and-workers-implementation.md`).
+     *
+     * `wildo.queue.{appId}.minion-tick.{minionName}`
+     *
+     * Each minion subscribes only to its own per-minion queue so the
+     * backend-api and the minion (which both connect to the same RabbitMQ
+     * vhost) do not compete on the shared `scheduled` queue. The publisher
+     * (`platform-crontabs-batches-manager`) routes `MINION_TICK` ticks to
+     * this per-minion queue; `SCHEDULED_CRON` ticks keep flowing to the
+     * shared `scheduled` queue (consumed by the backend-api executor).
+     */
+    static buildMinionTickQueueName(appId: string, minionName: string): string;
     /**
      * Build platform microservice queue name.
      * Platform queues don't include environment as they're shared infrastructure.
@@ -98,12 +141,22 @@ export declare function buildQueueName(appId: string, category: string, variant?
  * Build reply queue name for RPC pattern.
  * wildo.reply.{appId}.{podId}
  */
-export declare function buildReplyQueueName(appId: string, podId: string): string;
+export declare function buildReplyQueueName(appId: string, podId: string, principalSegment?: string): string;
 /**
  * Build domain queue name.
  * wildo.queue.{appId}.domain.{domainName}
  */
 export declare function buildDomainQueueName(appId: string, domainName: string): string;
+/**
+ * Build a delay (retry-hold) queue name for durable backoff.
+ * {sourceQueueName}.delay.{delayMs}
+ */
+export declare function buildDelayQueueName(sourceQueueName: string, delayMs: number): string;
+/**
+ * Build per-minion tick queue name (KD-12).
+ * wildo.queue.{appId}.minion-tick.{minionName}
+ */
+export declare function buildMinionTickQueueName(appId: string, minionName: string): string;
 /**
  * Calculate retry delay based on policy and attempt number.
  *
@@ -119,4 +172,82 @@ export declare function calculateRetryDelay(config: QueueRetryConfig, attempt: n
  * @returns Total maximum duration for all retries in milliseconds
  */
 export declare function calculateMaxRetryDuration(config: QueueRetryConfig): number;
+/**
+ * The RabbitMQ default virtual host, whose NAME is the single character `/`.
+ *
+ * Every broker ships with it, and an app that authors no
+ * `backingServices.rabbitmq.vhost` lands here (isolation then comes from the
+ * per-app user's permission regex rather than from a dedicated vhost).
+ *
+ * Note the deliberate ambiguity this constant resolves: `/` is BOTH the name of
+ * the default vhost AND the AMQP URI path separator. Conflating the two is what
+ * broke the two pre-consolidation URL builders — see
+ * {@link buildRabbitMQConnectionUrl}.
+ */
+export declare const DEFAULT_RABBITMQ_VHOST = "/";
+/** Connection inputs for {@link buildRabbitMQConnectionUrl}. */
+export interface RabbitMQConnectionUrlParts {
+    /** Broker hostname, e.g. `'localhost'`. */
+    host: string;
+    /** Broker AMQP port, e.g. `5672`. */
+    port: number;
+    /** Per-app broker username (minted by the infra provider module). */
+    username: string;
+    /** Per-app broker password (minted by the infra provider module). */
+    password: string;
+    /**
+     * Virtual host **name** — e.g. `'wonder-todos'`, with NO leading slash. This
+     * is the value authored at `backingServices.rabbitmq.vhost` in
+     * `wildo.infra.<envName>.config.ts` and the same name the infra provider
+     * passes to `ensureVhost()` (`PUT /api/vhosts/{name}`), so the string that
+     * names the vhost on the broker is the string that appears here.
+     *
+     * Omit it — or pass {@link DEFAULT_RABBITMQ_VHOST} — to connect to the broker
+     * default vhost.
+     */
+    vhost?: string;
+}
+/**
+ * Assemble the AMQP connection URL for a broker + vhost + credential triple.
+ *
+ * This is the SINGLE owner of AMQP URL assembly across the monorepo. It exists
+ * because the URL was previously built ad-hoc at three call sites with three
+ * different conventions, two of which were wrong in the same way — they
+ * interpolated the vhost directly after the port with no separator:
+ *
+ * ```ts
+ * `amqp://${user}:${pass}@${host}:${port}${vhost || '/'}`   // ← the old, broken form
+ * ```
+ *
+ * That form only ever worked because the `'/'` fallback doubles as the URI path
+ * separator, so the default case accidentally produced a well-formed URL with an
+ * empty path. The moment a real vhost was threaded through it produced
+ * `amqp://…@localhost:5672wonder-todos` — a malformed authority that fails to
+ * connect. A silent misconfiguration (every app quietly sharing the default
+ * vhost) was therefore load-bearing for the URL builder not crashing, which is
+ * why the two defects had to be fixed together.
+ *
+ * The encoding rules, per the AMQP URI spec (RFC 3986 userinfo + path):
+ *
+ * - **Userinfo is percent-encoded.** Minted passwords are random and may contain
+ *   `@`, `:` or `/`, any of which would otherwise terminate the userinfo or
+ *   authority early and silently retarget the connection.
+ * - **The path separator is unconditional.** The `/` after the port is always
+ *   emitted; it is URI syntax, never vhost data.
+ * - **An EMPTY path means the default vhost.** So both an omitted vhost and the
+ *   literal default-vhost name `'/'` collapse to `amqp://host:port/`. This is
+ *   byte-for-byte what the previous builders emitted for the default case, so
+ *   consolidating cannot regress a currently-connected deployment.
+ * - **A named vhost is percent-encoded** into exactly one path segment, so a
+ *   vhost containing `/` encodes to `%2F` and addresses one vhost rather than
+ *   splitting into a bogus second segment.
+ *
+ * @example
+ * buildRabbitMQConnectionUrl({ host: 'localhost', port: 5672, username: 'wildo', password: 'pw' });
+ * // → 'amqp://wildo:pw@localhost:5672/'                (default vhost)
+ *
+ * buildRabbitMQConnectionUrl({ host: 'localhost', port: 5672, username: 'wildo', password: 'pw', vhost: 'wonder-todos' });
+ * // → 'amqp://wildo:pw@localhost:5672/wonder-todos'    (per-app vhost)
+ */
+export declare function buildRabbitMQConnectionUrl(parts: RabbitMQConnectionUrlParts): string;
 //# sourceMappingURL=queues.shared.utils.d.ts.map

package/dist/esm/queue/queues.shared.utils.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queues.shared.utils.d.ts","sourceRoot":"","sources":["~~../../../~~src/queue/queues.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAwB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAM/F~~;;;;;;;;;;;GAWG~~;AACH,qBAAa,gBAAgB;IAC3B~~;;;;;;;;;;;;OAYG~~;IACH,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM;IAKT;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;~~IAIhE~~;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAItE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM;IAKT;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;QACxC,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;~~IA0CR~~;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIpD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAMnD;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,~~CAExE~~;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBrF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAO1E"}
1	+ {"version":3,"file":"queues.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/queue/queues.shared.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/queue/queues.shared.utils.js CHANGED Viewed

@@ -14,6 +14,13 @@ import { RetryPolicy_BackoffType } from '../errors/errors.shared.schemas.js';
  * Mono-env architecture: each deployment has its own infra, so env is NOT
  * part of queue names. Uniqueness comes from appId alone.
  *
+ * The `appId` here is the application's canonical identifier — its Mongo `_id`,
+ * projected into the app runtime as env `APPLICATION_ID` and exposed by
+ * `AppConfigurationService.applicationId`. It is NOT the human-readable
+ * `appSlug`. Every producer AND consumer of a given app's queues must derive
+ * the name from the same identifier; keying one side on the slug orphans the
+ * queue (nothing consumes it) and a slug rename would silently orphan it again.
+ *
  * Queue naming convention:
  * - App queues: wildo.queue.{appId}.{category}[.{variant}]
  * - Reply queues: wildo.reply.{appId}.{podId}
@@ -25,14 +32,16 @@ export class QueueNamingUtils {
      * Build queue name following the convention:
      * wildo.queue.{appId}.{category}[.{variant}]
      *
-     * @param appId - Application identifier (slug)
+     * @param appId - Canonical application identifier (the app's Mongo `_id` /
+     *   env `APPLICATION_ID`), NOT the human-readable slug. Producer and consumer
+     *   must agree on this identifier or the queue is orphaned.
      * @param category - Queue category (operations, scheduled, callbacks, domain.*)
      * @param variant - Optional variant (priority, deadletter)
      * @returns Formatted queue name
      *
      * @example
-     * QueueNamingUtils.buildQueueName('my-app', 'operations')
-     * // => 'wildo.queue.my-app.operations'
+     * QueueNamingUtils.buildQueueName('6a08488438bc965729b8b9ff', 'operations')
+     * // => 'wildo.queue.6a08488438bc965729b8b9ff.operations'
      */
     static buildQueueName(appId, category, variant) {
         const base = `wildo.queue.${appId}.${category}`;
@@ -44,8 +53,23 @@ export class QueueNamingUtils {
      *
      * wildo.reply.{appId}.{podId}
      */
-    static buildReplyQueueName(appId, podId) {
-        return `wildo.reply.${appId}.${podId}`;
+    static buildReplyQueueName(appId, podId, principalSegment) {
+        // `principalSegment` makes an RPC reply queue attributable to the RUNTIME
+        // that owns it, which is what lets a broker permission separate one
+        // runtime's replies from another's.
+        //
+        // Without it the name is `wildo.reply.<appId>.<podId>` and `podId` is a
+        // per-PROCESS token carrying no principal — so a minion's reply queue and
+        // the application backend's differ only by an opaque suffix, and no regex
+        // can admit one while refusing the other. Narrowing a minion's broker `read`
+        // therefore refused its OWN replies and crash-looped it (2026-08-12).
+        //
+        // OPTIONAL, and absent means the historical layout. Existing callers keep
+        // producing exactly the names they produce today; only a caller that knows
+        // its principal opts in.
+        return principalSegment
+            ? `wildo.reply.${appId}.${principalSegment}.${podId}`
+            : `wildo.reply.${appId}.${podId}`;
     }
     /**
      * Build domain-specific queue name.
@@ -55,6 +79,44 @@ export class QueueNamingUtils {
     static buildDomainQueueName(appId, domainName) {
         return `wildo.queue.${appId}.domain.${domainName}`;
     }
+    /**
+     * Build a delay (retry-hold) queue name for durable backoff.
+     *
+     * A delay queue holds a failed job for a fixed TTL, then dead-letters it back
+     * to its source queue for re-delivery. One queue exists PER distinct delay
+     * value so every message in it shares the same `x-message-ttl` — this avoids
+     * RabbitMQ's per-message-TTL head-of-line blocking (where a short-delay message
+     * would wait behind a longer-delay one ahead of it in the queue). The delay is
+     * embedded in the name, so the set of delay queues stays bounded by the (few)
+     * distinct backoff delays an app produces (`baseDelayMs × 2^attempt`, capped).
+     *
+     * `{sourceQueueName}.delay.{delayMs}`
+     *
+     * @param sourceQueueName - Full name of the queue the message returns to on expiry
+     * @param delayMs - Hold duration in ms (becomes the delay queue's `x-message-ttl`)
+     * @example
+     * QueueNamingUtils.buildDelayQueueName('wildo.queue.my-app.operations', 2000)
+     * // => 'wildo.queue.my-app.operations.delay.2000'
+     */
+    static buildDelayQueueName(sourceQueueName, delayMs) {
+        return `${sourceQueueName}.delay.${delayMs}`;
+    }
+    /**
+     * Build minion-tick queue name (KD-12 of
+     * `.claude/plans/minions-and-workers-implementation.md`).
+     *
+     * `wildo.queue.{appId}.minion-tick.{minionName}`
+     *
+     * Each minion subscribes only to its own per-minion queue so the
+     * backend-api and the minion (which both connect to the same RabbitMQ
+     * vhost) do not compete on the shared `scheduled` queue. The publisher
+     * (`platform-crontabs-batches-manager`) routes `MINION_TICK` ticks to
+     * this per-minion queue; `SCHEDULED_CRON` ticks keep flowing to the
+     * shared `scheduled` queue (consumed by the backend-api executor).
+     */
+    static buildMinionTickQueueName(appId, minionName) {
+        return `wildo.queue.${appId}.minion-tick.${minionName}`;
+    }
     /**
      * Build platform microservice queue name.
      * Platform queues don't include environment as they're shared infrastructure.
@@ -82,13 +144,23 @@ export class QueueNamingUtils {
             return null;
         }
         // Reply queue: wildo.reply.{appId}.{podId}
+        //           or wildo.reply.{appId}.{principalSegment}.{podId}
+        //
+        // `category` stays the LAST segment in both layouts, so it remains the podId
+        // rather than silently becoming the principal for principal-scoped names —
+        // a caller reading `category` expecting a pod identity must keep getting
+        // one.
         if (parts[1] === 'reply') {
             if (parts.length < 4)
                 return null;
             return {
                 type: 'reply',
                 identifier: parts[2],
-                category: parts[3],
+                category: parts[parts.length - 1],
+                // Present only for the principal-scoped layout; `undefined` for the
+                // historical one rather than an empty string, so "no principal in the
+                // name" is distinguishable from "a principal whose name is empty".
+                variant: parts.length > 4 ? parts[3] : undefined,
             };
         }
         // Queue: wildo.queue.{...}
@@ -162,8 +234,8 @@ export function buildQueueName(appId, category, variant) {
  * Build reply queue name for RPC pattern.
  * wildo.reply.{appId}.{podId}
  */
-export function buildReplyQueueName(appId, podId) {
-    return QueueNamingUtils.buildReplyQueueName(appId, podId);
+export function buildReplyQueueName(appId, podId, principalSegment) {
+    return QueueNamingUtils.buildReplyQueueName(appId, podId, principalSegment);
 }
 /**
  * Build domain queue name.
@@ -172,6 +244,20 @@ export function buildReplyQueueName(appId, podId) {
 export function buildDomainQueueName(appId, domainName) {
     return QueueNamingUtils.buildDomainQueueName(appId, domainName);
 }
+/**
+ * Build a delay (retry-hold) queue name for durable backoff.
+ * {sourceQueueName}.delay.{delayMs}
+ */
+export function buildDelayQueueName(sourceQueueName, delayMs) {
+    return QueueNamingUtils.buildDelayQueueName(sourceQueueName, delayMs);
+}
+/**
+ * Build per-minion tick queue name (KD-12).
+ * wildo.queue.{appId}.minion-tick.{minionName}
+ */
+export function buildMinionTickQueueName(appId, minionName) {
+    return QueueNamingUtils.buildMinionTickQueueName(appId, minionName);
+}
 /**
  * Calculate retry delay based on policy and attempt number.
  *
@@ -209,4 +295,70 @@ export function calculateMaxRetryDuration(config) {
     }
     return totalDelay;
 }
-//# sourceMappingURL=queues.shared.utils.js.map
+// ============================================================================
+// BROKER CONNECTION URL
+// ============================================================================
+/**
+ * The RabbitMQ default virtual host, whose NAME is the single character `/`.
+ *
+ * Every broker ships with it, and an app that authors no
+ * `backingServices.rabbitmq.vhost` lands here (isolation then comes from the
+ * per-app user's permission regex rather than from a dedicated vhost).
+ *
+ * Note the deliberate ambiguity this constant resolves: `/` is BOTH the name of
+ * the default vhost AND the AMQP URI path separator. Conflating the two is what
+ * broke the two pre-consolidation URL builders — see
+ * {@link buildRabbitMQConnectionUrl}.
+ */
+export const DEFAULT_RABBITMQ_VHOST = '/';
+/**
+ * Assemble the AMQP connection URL for a broker + vhost + credential triple.
+ *
+ * This is the SINGLE owner of AMQP URL assembly across the monorepo. It exists
+ * because the URL was previously built ad-hoc at three call sites with three
+ * different conventions, two of which were wrong in the same way — they
+ * interpolated the vhost directly after the port with no separator:
+ *
+ * ```ts
+ * `amqp://${user}:${pass}@${host}:${port}${vhost || '/'}`   // ← the old, broken form
+ * ```
+ *
+ * That form only ever worked because the `'/'` fallback doubles as the URI path
+ * separator, so the default case accidentally produced a well-formed URL with an
+ * empty path. The moment a real vhost was threaded through it produced
+ * `amqp://…@localhost:5672wonder-todos` — a malformed authority that fails to
+ * connect. A silent misconfiguration (every app quietly sharing the default
+ * vhost) was therefore load-bearing for the URL builder not crashing, which is
+ * why the two defects had to be fixed together.
+ *
+ * The encoding rules, per the AMQP URI spec (RFC 3986 userinfo + path):
+ *
+ * - **Userinfo is percent-encoded.** Minted passwords are random and may contain
+ *   `@`, `:` or `/`, any of which would otherwise terminate the userinfo or
+ *   authority early and silently retarget the connection.
+ * - **The path separator is unconditional.** The `/` after the port is always
+ *   emitted; it is URI syntax, never vhost data.
+ * - **An EMPTY path means the default vhost.** So both an omitted vhost and the
+ *   literal default-vhost name `'/'` collapse to `amqp://host:port/`. This is
+ *   byte-for-byte what the previous builders emitted for the default case, so
+ *   consolidating cannot regress a currently-connected deployment.
+ * - **A named vhost is percent-encoded** into exactly one path segment, so a
+ *   vhost containing `/` encodes to `%2F` and addresses one vhost rather than
+ *   splitting into a bogus second segment.
+ *
+ * @example
+ * buildRabbitMQConnectionUrl({ host: 'localhost', port: 5672, username: 'wildo', password: 'pw' });
+ * // → 'amqp://wildo:pw@localhost:5672/'                (default vhost)
+ *
+ * buildRabbitMQConnectionUrl({ host: 'localhost', port: 5672, username: 'wildo', password: 'pw', vhost: 'wonder-todos' });
+ * // → 'amqp://wildo:pw@localhost:5672/wonder-todos'    (per-app vhost)
+ */
+export function buildRabbitMQConnectionUrl(parts) {
+    const { host, port, username, password, vhost } = parts;
+    // An empty path addresses the broker default vhost. Encoding the literal name
+    // `'/'` as `%2F` would ALSO address it, but emitting the empty path keeps this
+    // builder's default-case output identical to the pre-consolidation builders.
+    const vhostPath = !vhost || vhost === DEFAULT_RABBITMQ_VHOST ? '' : encodeURIComponent(vhost);
+    return `amqp://${encodeURIComponent(username)}:${encodeURIComponent(password)}@${host}:${port}/${vhostPath}`;
+}
+//# sourceMappingURL=queues.shared.utils.js.map

package/dist/esm/queue/queues.shared.utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queues.shared.utils.js","sourceRoot":"","sources":["../../../src/queue/queues.shared.utils.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"queues.shared.utils.js","sourceRoot":"","sources":["../../../../src/queue/queues.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG1E,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,cAAc,CACnB,KAAa,EACb,QAAgB,EAChB,OAAsB;QAEtB,MAAM,IAAI,GAAG,eAAe,KAAK,IAAI,QAAQ,EAAE,CAAC;QAChD,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAa,EAAE,KAAa,EAAE,gBAAyB;QAChF,0EAA0E;QAC1E,oEAAoE;QACpE,oCAAoC;QACpC,EAAE;QACF,wEAAwE;QACxE,0EAA0E;QAC1E,0EAA0E;QAC1E,6EAA6E;QAC7E,sEAAsE;QACtE,EAAE;QACF,0EAA0E;QAC1E,2EAA2E;QAC3E,yBAAyB;QACzB,OAAO,gBAAgB;YACrB,CAAC,CAAC,eAAe,KAAK,IAAI,gBAAgB,IAAI,KAAK,EAAE;YACrD,CAAC,CAAC,eAAe,KAAK,IAAI,KAAK,EAAE,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAa,EAAE,UAAkB;QAC3D,OAAO,eAAe,KAAK,WAAW,UAAU,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,mBAAmB,CAAC,eAAuB,EAAE,OAAe;QACjE,OAAO,GAAG,eAAe,UAAU,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,wBAAwB,CAAC,KAAa,EAAE,UAAkB;QAC/D,OAAO,eAAe,KAAK,gBAAgB,UAAU,EAAE,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAC3B,MAAc,EACd,QAAgB,EAChB,OAAsB;QAEtB,MAAM,IAAI,GAAG,wBAAwB,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,SAAiB;QAMrC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2CAA2C;QAC3C,8DAA8D;QAC9D,EAAE;QACF,6EAA6E;QAC7E,2EAA2E;QAC3E,yEAAyE;QACzE,OAAO;QACP,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClC,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;gBACpB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE;gBAClC,oEAAoE;gBACpE,sEAAsE;gBACtE,mEAAmE;gBACnE,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACjD,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;gBAC5B,uEAAuE;gBACvE,OAAO;oBACL,IAAI,EAAE,UAAU;oBAChB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;oBACpB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;iBAClB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,wDAAwD;gBACxD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAClC,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;oBACpB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;oBAClB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;iBAClB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAiB;QACxC,OAAO,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAiB;QACtC,OAAO,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAiB;QACnC,OAAO,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAiB;QACvC,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,qDAAqD;AACrD,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,QAAgB,EAChB,OAAsB;IAEtB,OAAO,gBAAgB,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa,EAAE,gBAAyB;IACzF,OAAO,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,UAAkB;IACpE,OAAO,gBAAgB,CAAC,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,eAAuB,EAAE,OAAe;IAC1E,OAAO,gBAAgB,CAAC,mBAAmB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,UAAkB;IACxE,OAAO,gBAAgB,CAAC,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAwB,EAAE,OAAe;IAC3E,IAAI,KAAa,CAAC;IAElB,QAAQ,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3B,KAAK,uBAAuB,CAAC,KAAK;YAChC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;YAC3B,MAAM;QACR,KAAK,uBAAuB,CAAC,MAAM;YACjC,KAAK,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,uBAAuB,CAAC,WAAW,CAAC;QACzC;YACE,KAAK,GAAG,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM;IACV,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAwB;IAChE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,UAAU,IAAI,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7C,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAyB1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAiC;IAC1E,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAExD,8EAA8E;IAC9E,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,SAAS,GACb,CAAC,KAAK,IAAI,KAAK,KAAK,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAE9E,OAAO,UAAU,kBAAkB,CAAC,QAAQ,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;AAC/G,CAAC","sourcesContent":["/*\n Queues Shared Utilities\n * \n * All queue-related utility classes consolidated in a single file.\n * Includes: queue naming, retry delay calculations (legacy functions).\n /\n\nimport { RetryPolicy_BackoffType } from '../errors/errors.shared.schemas';\nimport { QueueRetryConfig, QUEUE_RETRY_DEFAULTS, QueueVariant } from './queues.shared.schemas';\n\n// ============================================================================\n// QUEUE NAMING UTILITIES\n// ============================================================================\n\n/\n Utilities for building queue names.\n \n Mono-env architecture: each deployment has its own infra, so env is NOT\n * part of queue names. Uniqueness comes from appId alone.\n \n The `appId` here is the application's canonical identifier — its Mongo `_id`,\n * projected into the app runtime as env `APPLICATION_ID` and exposed by\n * `AppConfigurationService.applicationId`. It is NOT the human-readable\n * `appSlug`. Every producer AND consumer of a given app's queues must derive\n * the name from the same identifier; keying one side on the slug orphans the\n * queue (nothing consumes it) and a slug rename would silently orphan it again.\n \n Queue naming convention:\n * - App queues: wildo.queue.{appId}.{category}[.{variant}]\n * - Reply queues: wildo.reply.{appId}.{podId}\n * - Domain queues: wildo.queue.{appId}.domain.{domainName}\n * - Platform queues: wildo.queue.platform.{msName}.{category}[.{variant}]\n /\nexport class QueueNamingUtils {\n /\n Build queue name following the convention:\n * wildo.queue.{appId}.{category}[.{variant}]\n \n @param appId - Canonical application identifier (the app's Mongo `_id` /\n * env `APPLICATION_ID`), NOT the human-readable slug. Producer and consumer\n * must agree on this identifier or the queue is orphaned.\n * @param category - Queue category (operations, scheduled, callbacks, domain.)\n @param variant - Optional variant (priority, deadletter)\n * @returns Formatted queue name\n \n @example\n * QueueNamingUtils.buildQueueName('6a08488438bc965729b8b9ff', 'operations')\n * // => 'wildo.queue.6a08488438bc965729b8b9ff.operations'\n /\n static buildQueueName(\n appId: string,\n category: string,\n variant?: QueueVariant\n ): string {\n const base = `wildo.queue.${appId}.${category}`;\n return variant ? `${base}.${variant}` : base;\n }\n\n /\n Build reply queue name for RPC pattern.\n * Reply queues are exclusive, auto-delete, and transient.\n * \n * wildo.reply.{appId}.{podId}\n /\n static buildReplyQueueName(appId: string, podId: string, principalSegment?: string): string {\n // `principalSegment` makes an RPC reply queue attributable to the RUNTIME\n // that owns it, which is what lets a broker permission separate one\n // runtime's replies from another's.\n //\n // Without it the name is `wildo.reply.<appId>.<podId>` and `podId` is a\n // per-PROCESS token carrying no principal — so a minion's reply queue and\n // the application backend's differ only by an opaque suffix, and no regex\n // can admit one while refusing the other. Narrowing a minion's broker `read`\n // therefore refused its OWN replies and crash-looped it (2026-08-12).\n //\n // OPTIONAL, and absent means the historical layout. Existing callers keep\n // producing exactly the names they produce today; only a caller that knows\n // its principal opts in.\n return principalSegment\n ? `wildo.reply.${appId}.${principalSegment}.${podId}`\n : `wildo.reply.${appId}.${podId}`;\n }\n\n /\n Build domain-specific queue name.\n \n wildo.queue.{appId}.domain.{domainName}\n /\n static buildDomainQueueName(appId: string, domainName: string): string {\n return `wildo.queue.${appId}.domain.${domainName}`;\n }\n\n /\n Build a delay (retry-hold) queue name for durable backoff.\n \n A delay queue holds a failed job for a fixed TTL, then dead-letters it back\n * to its source queue for re-delivery. One queue exists PER distinct delay\n * value so every message in it shares the same `x-message-ttl` — this avoids\n * RabbitMQ's per-message-TTL head-of-line blocking (where a short-delay message\n * would wait behind a longer-delay one ahead of it in the queue). The delay is\n * embedded in the name, so the set of delay queues stays bounded by the (few)\n * distinct backoff delays an app produces (`baseDelayMs × 2^attempt`, capped).\n \n `{sourceQueueName}.delay.{delayMs}`\n \n @param sourceQueueName - Full name of the queue the message returns to on expiry\n * @param delayMs - Hold duration in ms (becomes the delay queue's `x-message-ttl`)\n * @example\n * QueueNamingUtils.buildDelayQueueName('wildo.queue.my-app.operations', 2000)\n * // => 'wildo.queue.my-app.operations.delay.2000'\n /\n static buildDelayQueueName(sourceQueueName: string, delayMs: number): string {\n return `${sourceQueueName}.delay.${delayMs}`;\n }\n\n /\n Build minion-tick queue name (KD-12 of\n * `.claude/plans/minions-and-workers-implementation.md`).\n \n `wildo.queue.{appId}.minion-tick.{minionName}`\n \n Each minion subscribes only to its own per-minion queue so the\n * backend-api and the minion (which both connect to the same RabbitMQ\n * vhost) do not compete on the shared `scheduled` queue. The publisher\n * (`platform-crontabs-batches-manager`) routes `MINION_TICK` ticks to\n * this per-minion queue; `SCHEDULED_CRON` ticks keep flowing to the\n * shared `scheduled` queue (consumed by the backend-api executor).\n /\n static buildMinionTickQueueName(appId: string, minionName: string): string {\n return `wildo.queue.${appId}.minion-tick.${minionName}`;\n }\n\n /\n Build platform microservice queue name.\n * Platform queues don't include environment as they're shared infrastructure.\n * \n * wildo.queue.platform.{msName}.{category}[.{variant}]\n * \n * @param msName - Microservice name\n * @param category - Queue category\n * @param variant - Optional variant\n * @returns Formatted platform queue name\n /\n static buildPlatformQueueName(\n msName: string,\n category: string,\n variant?: QueueVariant\n ): string {\n const base = `wildo.queue.platform.${msName}.${category}`;\n return variant ? `${base}.${variant}` : base;\n }\n\n /\n Parse a queue name to extract its components.\n * \n * @param queueName - Full queue name to parse\n * @returns Parsed components or null if invalid format\n /\n static parseQueueName(queueName: string): {\n type: 'app' \| 'platform' \| 'reply';\n identifier: string;\n category?: string;\n variant?: string;\n } \| null {\n const parts = queueName.split('.');\n \n if (parts.length < 3 \|\| parts[0] !== 'wildo') {\n return null;\n }\n\n // Reply queue: wildo.reply.{appId}.{podId}\n // or wildo.reply.{appId}.{principalSegment}.{podId}\n //\n // `category` stays the LAST segment in both layouts, so it remains the podId\n // rather than silently becoming the principal for principal-scoped names —\n // a caller reading `category` expecting a pod identity must keep getting\n // one.\n if (parts[1] === 'reply') {\n if (parts.length < 4) return null;\n return {\n type: 'reply',\n identifier: parts[2],\n category: parts[parts.length - 1]!,\n // Present only for the principal-scoped layout; `undefined` for the\n // historical one rather than an empty string, so \"no principal in the\n // name\" is distinguishable from \"a principal whose name is empty\".\n variant: parts.length > 4 ? parts[3] : undefined,\n };\n }\n\n // Queue: wildo.queue.{...}\n if (parts[1] === 'queue') {\n if (parts[2] === 'platform') {\n // Platform queue: wildo.queue.platform.{msName}.{category}[.{variant}]\n return {\n type: 'platform',\n identifier: parts[3],\n category: parts[4],\n variant: parts[5],\n };\n } else {\n // App queue: wildo.queue.{appId}.{category}[.{variant}]\n if (parts.length < 4) return null;\n return {\n type: 'app',\n identifier: parts[2],\n category: parts[3],\n variant: parts[4],\n };\n }\n }\n\n return null;\n }\n\n /\n Check if a queue name is a dead letter queue.\n /\n static isDeadLetterQueue(queueName: string): boolean {\n return queueName.endsWith('.deadletter');\n }\n\n /\n Check if a queue name is a priority queue.\n /\n static isPriorityQueue(queueName: string): boolean {\n return queueName.endsWith('.priority');\n }\n\n /\n Check if a queue name is a reply queue.\n /\n static isReplyQueue(queueName: string): boolean {\n return queueName.startsWith('wildo.reply.');\n }\n\n /\n Get the base queue name (without variant suffix).\n * \n * @param queueName - Full queue name\n * @returns Base queue name without variant\n /\n static getBaseQueueName(queueName: string): string {\n if (queueName.endsWith('.priority') \|\| queueName.endsWith('.deadletter')) {\n return queueName.substring(0, queueName.lastIndexOf('.'));\n }\n return queueName;\n }\n}\n\n// ============================================================================\n// STANDALONE FUNCTIONS\n// Convenience wrappers around QueueNamingUtils class\n// ============================================================================\n\n/\n Build queue name following the convention.\n * wildo.queue.{appId}.{category}[.{variant}]\n /\nexport function buildQueueName(\n appId: string,\n category: string,\n variant?: QueueVariant\n): string {\n return QueueNamingUtils.buildQueueName(appId, category, variant);\n}\n\n/\n Build reply queue name for RPC pattern.\n * wildo.reply.{appId}.{podId}\n /\nexport function buildReplyQueueName(appId: string, podId: string, principalSegment?: string): string {\n return QueueNamingUtils.buildReplyQueueName(appId, podId, principalSegment);\n}\n\n/\n Build domain queue name.\n * wildo.queue.{appId}.domain.{domainName}\n /\nexport function buildDomainQueueName(appId: string, domainName: string): string {\n return QueueNamingUtils.buildDomainQueueName(appId, domainName);\n}\n\n/\n Build a delay (retry-hold) queue name for durable backoff.\n * {sourceQueueName}.delay.{delayMs}\n /\nexport function buildDelayQueueName(sourceQueueName: string, delayMs: number): string {\n return QueueNamingUtils.buildDelayQueueName(sourceQueueName, delayMs);\n}\n\n/\n Build per-minion tick queue name (KD-12).\n * wildo.queue.{appId}.minion-tick.{minionName}\n /\nexport function buildMinionTickQueueName(appId: string, minionName: string): string {\n return QueueNamingUtils.buildMinionTickQueueName(appId, minionName);\n}\n\n/\n Calculate retry delay based on policy and attempt number.\n * \n * @param config Retry configuration\n * @param attempt Current retry attempt (0-indexed)\n * @returns Delay in milliseconds (capped at maxDelayMs)\n /\nexport function calculateRetryDelay(config: QueueRetryConfig, attempt: number): number {\n let delay: number;\n \n switch (config.retryPolicy) {\n case RetryPolicy_BackoffType.FIXED:\n delay = config.baseDelayMs;\n break;\n case RetryPolicy_BackoffType.LINEAR:\n delay = config.baseDelayMs (attempt + 1);\n break;\n case RetryPolicy_BackoffType.EXPONENTIAL:\n default:\n delay = config.baseDelayMs * Math.pow(2, attempt);\n break;\n }\n \n return Math.min(delay, config.maxDelayMs);\n}\n\n/*\n Calculate maximum possible retry duration.\n \n @param config Retry configuration\n * @returns Total maximum duration for all retries in milliseconds\n /\nexport function calculateMaxRetryDuration(config: QueueRetryConfig): number {\n let totalDelay = 0;\n for (let i = 0; i < config.maxRetries; i++) {\n totalDelay += calculateRetryDelay(config, i);\n totalDelay += config.timeoutMs;\n }\n return totalDelay;\n}\n\n// ============================================================================\n// BROKER CONNECTION URL\n// ============================================================================\n\n/\n The RabbitMQ default virtual host, whose NAME is the single character `/`.\n \n Every broker ships with it, and an app that authors no\n * `backingServices.rabbitmq.vhost` lands here (isolation then comes from the\n * per-app user's permission regex rather than from a dedicated vhost).\n \n Note the deliberate ambiguity this constant resolves: `/` is BOTH the name of\n * the default vhost AND the AMQP URI path separator. Conflating the two is what\n * broke the two pre-consolidation URL builders — see\n * {@link buildRabbitMQConnectionUrl}.\n /\nexport const DEFAULT_RABBITMQ_VHOST = '/';\n\n/* Connection inputs for {@link buildRabbitMQConnectionUrl}. /\nexport interface RabbitMQConnectionUrlParts {\n /* Broker hostname, e.g. `'localhost'`. /\n host: string;\n /* Broker AMQP port, e.g. `5672`. /\n port: number;\n /* Per-app broker username (minted by the infra provider module). /\n username: string;\n /* Per-app broker password (minted by the infra provider module). /\n password: string;\n /\n Virtual host name — e.g. `'wonder-todos'`, with NO leading slash. This\n * is the value authored at `backingServices.rabbitmq.vhost` in\n * `wildo.infra.<envName>.config.ts` and the same name the infra provider\n * passes to `ensureVhost()` (`PUT /api/vhosts/{name}`), so the string that\n * names the vhost on the broker is the string that appears here.\n \n Omit it — or pass {@link DEFAULT_RABBITMQ_VHOST} — to connect to the broker\n * default vhost.\n /\n vhost?: string;\n}\n\n/\n Assemble the AMQP connection URL for a broker + vhost + credential triple.\n \n This is the SINGLE owner of AMQP URL assembly across the monorepo. It exists\n * because the URL was previously built ad-hoc at three call sites with three\n * different conventions, two of which were wrong in the same way — they\n * interpolated the vhost directly after the port with no separator:\n \n ```ts\n * `amqp://${user}:${pass}@${host}:${port}${vhost \|\| '/'}` // ← the old, broken form\n * ```\n \n That form only ever worked because the `'/'` fallback doubles as the URI path\n * separator, so the default case accidentally produced a well-formed URL with an\n * empty path. The moment a real vhost was threaded through it produced\n * `amqp://…@localhost:5672wonder-todos` — a malformed authority that fails to\n * connect. A silent misconfiguration (every app quietly sharing the default\n * vhost) was therefore load-bearing for the URL builder not crashing, which is\n * why the two defects had to be fixed together.\n \n The encoding rules, per the AMQP URI spec (RFC 3986 userinfo + path):\n \n - Userinfo is percent-encoded. Minted passwords are random and may contain\n * `@`, `:` or `/`, any of which would otherwise terminate the userinfo or\n * authority early and silently retarget the connection.\n * - The path separator is unconditional. The `/` after the port is always\n * emitted; it is URI syntax, never vhost data.\n * - An EMPTY path means the default vhost. So both an omitted vhost and the\n * literal default-vhost name `'/'` collapse to `amqp://host:port/`. This is\n * byte-for-byte what the previous builders emitted for the default case, so\n * consolidating cannot regress a currently-connected deployment.\n * - A named vhost is percent-encoded into exactly one path segment, so a\n * vhost containing `/` encodes to `%2F` and addresses one vhost rather than\n * splitting into a bogus second segment.\n \n @example\n * buildRabbitMQConnectionUrl({ host: 'localhost', port: 5672, username: 'wildo', password: 'pw' });\n * // → 'amqp://wildo:pw@localhost:5672/' (default vhost)\n \n buildRabbitMQConnectionUrl({ host: 'localhost', port: 5672, username: 'wildo', password: 'pw', vhost: 'wonder-todos' });\n * // → 'amqp://wildo:pw@localhost:5672/wonder-todos' (per-app vhost)\n */\nexport function buildRabbitMQConnectionUrl(parts: RabbitMQConnectionUrlParts): string {\n const { host, port, username, password, vhost } = parts;\n\n // An empty path addresses the broker default vhost. Encoding the literal name\n // `'/'` as `%2F` would ALSO address it, but emitting the empty path keeps this\n // builder's default-case output identical to the pre-consolidation builders.\n const vhostPath =\n !vhost \|\| vhost === DEFAULT_RABBITMQ_VHOST ? '' : encodeURIComponent(vhost);\n\n return `amqp://${encodeURIComponent(username)}:${encodeURIComponent(password)}@${host}:${port}/${vhostPath}`;\n}\n"]}

package/dist/esm/queue/rabbitmq-queue-args.shared.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"rabbitmq-queue-args.shared.d.ts","sourceRoot":"","sources":["~~../../../~~src/queue/rabbitmq-queue-args.shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC"}
1	+ {"version":3,"file":"rabbitmq-queue-args.shared.d.ts","sourceRoot":"","sources":["../../../../src/queue/rabbitmq-queue-args.shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC"}

package/dist/esm/queue/rabbitmq-queue-args.shared.js CHANGED Viewed

@@ -10,4 +10,4 @@ export const RabbitMQQueueArgKeys = {
     MESSAGE_TTL: 'x-message-ttl',
     MAX_LENGTH: 'x-max-length',
 };
-//# sourceMappingURL=rabbitmq-queue-args.shared.js.map
+//# sourceMappingURL=rabbitmq-queue-args.shared.js.map

package/dist/esm/queue/rabbitmq-queue-args.shared.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"rabbitmq-queue-args.shared.js","sourceRoot":"","sources":["~~../../../~~src/queue/rabbitmq-queue-args.shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oBAAoB,EAAE,wBAAwB;IAC9C,uBAAuB,EAAE,2BAA2B;IACpD,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,cAAc;CAClB,CAAC"}
1	+ {"version":3,"file":"rabbitmq-queue-args.shared.js","sourceRoot":"","sources":["../../../../src/queue/rabbitmq-queue-args.shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oBAAoB,EAAE,wBAAwB;IAC9C,uBAAuB,EAAE,2BAA2B;IACpD,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,cAAc;CAClB,CAAC","sourcesContent":["/*\n Canonical RabbitMQ queue argument keys.\n \n Single source of truth for AMQP queue arguments (x-).\n Used by RabbitMQ adapter when asserting queues.\n */\nexport const RabbitMQQueueArgKeys = {\n DEAD_LETTER_EXCHANGE: 'x-dead-letter-exchange',\n DEAD_LETTER_ROUTING_KEY: 'x-dead-letter-routing-key',\n MESSAGE_TTL: 'x-message-ttl',\n MAX_LENGTH: 'x-max-length',\n} as const;\n"]}