@breadstone/archipel-mcp 0.0.23 → 0.0.26

package/data/packages/platform-queue/api/Class.QueueHealthIndicator.md

@@ -0,0 +1,68 @@
+---
+title: 'Class: QueueHealthIndicator'
+generated: true
+editUrl: false
+---
+# Class: QueueHealthIndicator
+
+Defined in: health/QueueHealthIndicator.ts:15
+
+Health indicator for the queue infrastructure.
+
+## Implements
+
+- `IHealthIndicator`
+
+## Constructors
+
+### Constructor
+
+```ts
+new QueueHealthIndicator(): QueueHealthIndicator;
+```
+
+#### Returns
+
+`QueueHealthIndicator`
+
+## Properties
+
+### key
+
+```ts
+readonly key: string = 'queue';
+```
+
+Defined in: health/QueueHealthIndicator.ts:18
+
+Unique key identifying the indicator
+
+#### Implementation of
+
+```ts
+IHealthIndicator.key
+```
+
+## Methods
+
+### check()
+
+```ts
+check(): HealthIndicatorResult<string>;
+```
+
+Defined in: health/QueueHealthIndicator.ts:30
+
+Returns the health status of the queue infrastructure.
+
+#### Returns
+
+`HealthIndicatorResult`\<`string`\>
+
+The health indicator result.
+
+#### Implementation of
+
+```ts
+IHealthIndicator.check
+```

package/data/packages/platform-queue/api/Class.QueueJobNotFoundError.md

@@ -0,0 +1,43 @@
+---
+title: 'Class: QueueJobNotFoundError'
+generated: true
+editUrl: false
+---
+# Class: QueueJobNotFoundError
+
+Defined in: [errors/QueueJobNotFoundError.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/errors/QueueJobNotFoundError.ts#L15)
+
+Thrown when a queue job cannot be found by its ID.
+
+Typically raised by [IQueue.markCompleted](Interface.IQueue#markcompleted) or [IQueue.markFailed](Interface.IQueue#markfailed)
+when the supplied job identifier does not match any tracked job.
+
+## Extends
+
+- [`QueueError`](Class.QueueError)
+
+## Constructors
+
+### Constructor
+
+```ts
+new QueueJobNotFoundError(jobId): QueueJobNotFoundError;
+```
+
+Defined in: [errors/QueueJobNotFoundError.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/errors/QueueJobNotFoundError.ts#L23)
+
+Creates a new QueueJobNotFoundError.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `jobId` | `string` | The identifier of the job that could not be located. |
+
+#### Returns
+
+`QueueJobNotFoundError`
+
+#### Overrides
+
+[`QueueError`](Class.QueueError).[`constructor`](Class.QueueError#constructor)

package/data/packages/platform-queue/api/Class.QueueJobStateError.md

@@ -0,0 +1,48 @@
+---
+title: 'Class: QueueJobStateError'
+generated: true
+editUrl: false
+---
+# Class: QueueJobStateError
+
+Defined in: [errors/QueueJobStateError.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/errors/QueueJobStateError.ts#L15)
+
+Thrown when a queue job is in an invalid state for the requested transition.
+
+For example, calling [IQueue.markCompleted](Interface.IQueue#markcompleted) on a job that is still
+in `pending` status rather than `processing` triggers this error.
+
+## Extends
+
+- [`QueueError`](Class.QueueError)
+
+## Constructors
+
+### Constructor
+
+```ts
+new QueueJobStateError(
+   jobId, 
+   expectedStatus, 
+   actualStatus): QueueJobStateError;
+```
+
+Defined in: [errors/QueueJobStateError.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/errors/QueueJobStateError.ts#L25)
+
+Creates a new QueueJobStateError.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `jobId` | `string` | The identifier of the affected job. |
+| `expectedStatus` | `string` | The status required for the attempted transition. |
+| `actualStatus` | `string` | The current status of the job. |
+
+#### Returns
+
+`QueueJobStateError`
+
+#### Overrides
+
+[`QueueError`](Class.QueueError).[`constructor`](Class.QueueError#constructor)

package/data/packages/platform-queue/api/Class.QueueValidationError.md

@@ -0,0 +1,43 @@
+---
+title: 'Class: QueueValidationError'
+generated: true
+editUrl: false
+---
+# Class: QueueValidationError
+
+Defined in: [errors/QueueValidationError.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/errors/QueueValidationError.ts#L15)
+
+Thrown when a queue operation receives invalid input.
+
+Common triggers include an empty or whitespace-only queue name,
+or an empty error message passed to [IQueue.markFailed](Interface.IQueue#markfailed).
+
+## Extends
+
+- [`QueueError`](Class.QueueError)
+
+## Constructors
+
+### Constructor
+
+```ts
+new QueueValidationError(message): QueueValidationError;
+```
+
+Defined in: [errors/QueueValidationError.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/errors/QueueValidationError.ts#L23)
+
+Creates a new QueueValidationError.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `message` | `string` | A human-readable description of the validation failure. |
+
+#### Returns
+
+`QueueValidationError`
+
+#### Overrides
+
+[`QueueError`](Class.QueueError).[`constructor`](Class.QueueError#constructor)

package/data/packages/platform-queue/api/Interface.IAzureQueueOptions.md

@@ -0,0 +1,48 @@
+---
+title: 'Interface: IAzureQueueOptions'
+generated: true
+editUrl: false
+---
+# Interface: IAzureQueueOptions
+
+Defined in: [azure/AzureQueue.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/azure/AzureQueue.ts#L19)
+
+Configuration options for [AzureQueue](Class.AzureQueue).
+
+## Properties
+
+### connectionString
+
+```ts
+connectionString: string;
+```
+
+Defined in: [azure/AzureQueue.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/azure/AzureQueue.ts#L28)
+
+Azure Service Bus connection string.
+
+#### Example
+
+```ts
+`Endpoint=sb://my-namespace.servicebus.windows.net/;SharedAccessKeyName=...;SharedAccessKey=...`
+@public
+```
+
+***
+
+### receiveWaitMs?
+
+```ts
+optional receiveWaitMs?: number;
+```
+
+Defined in: [azure/AzureQueue.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/azure/AzureQueue.ts#L36)
+
+Maximum wait time in milliseconds when receiving messages.
+
+#### Default Value
+
+```ts
+5_000
+@public
+```

package/data/packages/platform-queue/api/Interface.IBullMqQueueOptions.md

@@ -0,0 +1,45 @@
+---
+title: 'Interface: IBullMqQueueOptions'
+generated: true
+editUrl: false
+---
+# Interface: IBullMqQueueOptions
+
+Defined in: [bullmq/BullMqQueue.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/bullmq/BullMqQueue.ts#L20)
+
+Configuration options for [BullMqQueue](Class.BullMqQueue).
+
+## Properties
+
+### prefix?
+
+```ts
+optional prefix?: string;
+```
+
+Defined in: [bullmq/BullMqQueue.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/bullmq/BullMqQueue.ts#L37)
+
+Optional prefix applied to all BullMQ queue keys in Redis.
+
+#### Default Value
+
+`''`
+
+***
+
+### redisUrl
+
+```ts
+redisUrl: string;
+```
+
+Defined in: [bullmq/BullMqQueue.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/bullmq/BullMqQueue.ts#L29)
+
+Redis connection URL.
+
+#### Example
+
+```ts
+`redis://localhost:6379`
+@public
+```

package/data/packages/platform-queue/api/Interface.IMemoryQueueOptions.md

@@ -0,0 +1,32 @@
+---
+title: 'Interface: IMemoryQueueOptions'
+generated: true
+editUrl: false
+---
+# Interface: IMemoryQueueOptions
+
+Defined in: [memory/MemoryQueue.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/memory/MemoryQueue.ts#L17)
+
+Configuration options for [MemoryQueue](Class.MemoryQueue).
+
+## Properties
+
+### maxJobs?
+
+```ts
+optional maxJobs?: number;
+```
+
+Defined in: [memory/MemoryQueue.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/memory/MemoryQueue.ts#L29)
+
+Maximum number of jobs retained across all queues.
+
+When the limit is exceeded, the oldest completed or failed jobs
+are evicted first. Defaults to `10_000`.
+
+#### Default Value
+
+```ts
+10_000
+@public
+```

package/data/packages/platform-queue/api/Interface.IQueue.md

@@ -0,0 +1,173 @@
+---
+title: 'Interface: IQueue\<TPayload\>'
+generated: true
+editUrl: false
+---
+# Interface: IQueue\<TPayload\>
+
+Defined in: [interfaces/IQueue.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/interfaces/IQueue.ts#L23)
+
+Contract for queue implementations.
+
+Provides FIFO job enqueue/dequeue, status transitions, and listing.
+Implementations may be in-memory, Redis-backed, or cloud-service-backed.
+
+## Remarks
+
+All methods are asynchronous and return [IQueueJob](Interface.IQueueJob) instances.
+Errors are signalled via domain-specific exceptions:
+- [QueueValidationError](Class.QueueValidationError) for invalid input.
+- [QueueJobNotFoundError](Class.QueueJobNotFoundError) when a job ID cannot be resolved.
+- [QueueJobStateError](Class.QueueJobStateError) when a job is in the wrong state for a transition.
+
+## Type Parameters
+
+| Type Parameter | Default type | Description |
+| ------ | ------ | ------ |
+| `TPayload` | `unknown` | The default payload type for jobs in this queue. Defaults to `unknown`. |
+
+## Methods
+
+### dequeue()
+
+```ts
+dequeue(queueName): Promise<IQueueJob<unknown> | null>;
+```
+
+Defined in: [interfaces/IQueue.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/interfaces/IQueue.ts#L45)
+
+Dequeues the next pending job from the named queue.
+
+The returned job transitions to `processing` status.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `queueName` | `string` | The name of the queue to dequeue from. |
+
+#### Returns
+
+`Promise`\<[`IQueueJob`](Interface.IQueueJob)\<`unknown`\> \| `null`\>
+
+The next pending job, or `null` if the queue is empty.
+
+***
+
+### enqueue()
+
+```ts
+enqueue<T>(queueName, payload): Promise<IQueueJob<T>>;
+```
+
+Defined in: [interfaces/IQueue.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/interfaces/IQueue.ts#L34)
+
+Enqueues a new job into the named queue.
+
+#### Type Parameters
+
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | `TPayload` |
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `queueName` | `string` | The name of the target queue. |
+| `payload` | `T` | The job payload. |
+
+#### Returns
+
+`Promise`\<[`IQueueJob`](Interface.IQueueJob)\<`T`\>\>
+
+The created job in `pending` status.
+
+***
+
+### getJobs()
+
+```ts
+getJobs(queueName): Promise<readonly IQueueJob<unknown>[]>;
+```
+
+Defined in: [interfaces/IQueue.ts:77](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/interfaces/IQueue.ts#L77)
+
+Returns all jobs for the given queue in insertion order.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `queueName` | `string` | The name of the queue. |
+
+#### Returns
+
+`Promise`\<readonly [`IQueueJob`](Interface.IQueueJob)\<`unknown`\>[]\>
+
+An array of jobs, possibly empty.
+
+***
+
+### markCompleted()
+
+```ts
+markCompleted(jobId): Promise<IQueueJob<unknown>>;
+```
+
+Defined in: [interfaces/IQueue.ts:56](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/interfaces/IQueue.ts#L56)
+
+Marks a processing job as completed.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `jobId` | `string` | The ID of the job to complete. |
+
+#### Returns
+
+`Promise`\<[`IQueueJob`](Interface.IQueueJob)\<`unknown`\>\>
+
+The updated job in `completed` status.
+
+#### Throws
+
+[QueueJobNotFoundError](Class.QueueJobNotFoundError) When no job with the given ID exists.
+
+#### Throws
+
+[QueueJobStateError](Class.QueueJobStateError) When the job is not in `processing` status.
+
+***
+
+### markFailed()
+
+```ts
+markFailed(jobId, errorMessage): Promise<IQueueJob<unknown>>;
+```
+
+Defined in: [interfaces/IQueue.ts:68](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/interfaces/IQueue.ts#L68)
+
+Marks a processing job as failed.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `jobId` | `string` | The ID of the job to mark as failed. |
+| `errorMessage` | `string` | A human-readable error message. |
+
+#### Returns
+
+`Promise`\<[`IQueueJob`](Interface.IQueueJob)\<`unknown`\>\>
+
+The updated job in `failed` status.
+
+#### Throws
+
+[QueueJobNotFoundError](Class.QueueJobNotFoundError) When no job with the given ID exists.
+
+#### Throws
+
+[QueueJobStateError](Class.QueueJobStateError) When the job is not in `processing` status.

package/data/packages/platform-queue/api/Interface.IQueueJob.md

@@ -0,0 +1,139 @@
+---
+title: 'Interface: IQueueJob\<TPayload\>'
+generated: true
+editUrl: false
+---
+# Interface: IQueueJob\<TPayload\>
+
+Defined in: [models/IQueueJob.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L37)
+
+Represents a job in a named queue with tracking metadata.
+
+All queue implementations return objects conforming to this interface,
+making it the unified exchange type between producers and consumers.
+
+## Type Parameters
+
+| Type Parameter | Default type | Description |
+| ------ | ------ | ------ |
+| `TPayload` | `unknown` | The type of the job payload. Defaults to `unknown`. |
+
+## Properties
+
+### attempts
+
+```ts
+readonly attempts: number;
+```
+
+Defined in: [models/IQueueJob.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L51)
+
+Number of processing attempts.
+
+***
+
+### completedAt
+
+```ts
+readonly completedAt: Date | null;
+```
+
+Defined in: [models/IQueueJob.ts:60](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L60)
+
+Timestamp when the job completed successfully.
+
+***
+
+### createdAt
+
+```ts
+readonly createdAt: Date;
+```
+
+Defined in: [models/IQueueJob.ts:54](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L54)
+
+Timestamp when the job was created.
+
+***
+
+### errorMessage
+
+```ts
+readonly errorMessage: string | null;
+```
+
+Defined in: [models/IQueueJob.ts:66](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L66)
+
+Error message from the last failure, if any.
+
+***
+
+### failedAt
+
+```ts
+readonly failedAt: Date | null;
+```
+
+Defined in: [models/IQueueJob.ts:63](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L63)
+
+Timestamp when the job last failed.
+
+***
+
+### id
+
+```ts
+readonly id: string;
+```
+
+Defined in: [models/IQueueJob.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L39)
+
+Unique job identifier.
+
+***
+
+### payload
+
+```ts
+readonly payload: TPayload;
+```
+
+Defined in: [models/IQueueJob.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L45)
+
+The job payload.
+
+***
+
+### queueName
+
+```ts
+readonly queueName: string;
+```
+
+Defined in: [models/IQueueJob.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L42)
+
+Name of the queue this job belongs to.
+
+***
+
+### startedAt
+
+```ts
+readonly startedAt: Date | null;
+```
+
+Defined in: [models/IQueueJob.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L57)
+
+Timestamp when the job was last picked up for processing.
+
+***
+
+### status
+
+```ts
+readonly status: QueueJobStatus;
+```
+
+Defined in: [models/IQueueJob.ts:48](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L48)
+
+Current status of the job.

package/data/packages/platform-queue/api/TypeAlias.QueueJobStatus.md

@@ -0,0 +1,14 @@
+---
+title: 'Type Alias: QueueJobStatus'
+generated: true
+editUrl: false
+---
+# Type Alias: QueueJobStatus
+
+```ts
+type QueueJobStatus = typeof QUEUE_JOB_STATUS[keyof typeof QUEUE_JOB_STATUS];
+```
+
+Defined in: [models/IQueueJob.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/models/IQueueJob.ts#L26)
+
+Union type derived from [QUEUE\_JOB\_STATUS](Variable.QUEUE_JOB_STATUS).

package/data/packages/platform-queue/api/Variable.AZURE_CONFIG_ENTRIES.md

@@ -0,0 +1,17 @@
+---
+title: 'Variable: AZURE\_CONFIG\_ENTRIES'
+generated: true
+editUrl: false
+---
+# Variable: AZURE\_CONFIG\_ENTRIES
+
+```ts
+const AZURE_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
+```
+
+Defined in: [azure/env.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/azure/env.ts#L38)
+
+All configuration entries required by the Azure queue provider.
+
+Pass this array to the module's `register()` method so that the
+configuration service validates and provides the values at startup.

package/data/packages/platform-queue/api/Variable.AZURE_CONNECTION_STRING.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: AZURE\_CONNECTION\_STRING'
+generated: true
+editUrl: false
+---
+# Variable: AZURE\_CONNECTION\_STRING
+
+```ts
+const AZURE_CONNECTION_STRING: IConfigKey<string>;
+```
+
+Defined in: [azure/env.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-queue/src/azure/env.ts#L16)
+
+Azure queue connection string.