@decaf-ts/integrations 0.11.0 → 0.12.0

package/lib/esm/devops/github/GithubService.js

@@ -0,0 +1,297 @@
+/**
+ * @module integrations/devops/github/service
+ * @summary GitHub REST API integration service for repositories, issues, and pull requests.
+ * @description Exposes a focused subset of the GitHub REST API (`/repos/*`:
+ * repository lookup, issue listing/creation/commenting, and pull-request
+ * listing) as an undecorated client-based service built on
+ * {@link HttpApiService}. Configuration comes from an explicit
+ * `GithubServiceConfig` or the `devops.github` environment slice; repository
+ * targets default to the configured `owner`/`repo` and can be overridden per
+ * call. Raw GitHub responses are normalized to camelCase issue descriptors,
+ * and failures are mapped to decaf errors via {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { DevopsEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description GitHub REST API integration service
+ * @summary An undecorated HTTP service for looking up
+ * repositories, listing issues (excluding pull requests), creating issues,
+ * commenting on issues, and listing pull requests. Repository targets resolve
+ * per call from the input's `owner`/`repo`, falling back to the configured
+ * config values, and throw `InternalError` when unresolved. The token is sent
+ * as a bearer token with the GitHub `Accept` and API-version headers, and
+ * transport failures are mapped to decaf errors via {@link httpError}.
+ * @class GithubService
+ * @category DevOps
+ * @example
+ * ```ts
+ * import { GithubService } from "@decaf-ts/integrations/devops/github";
+ *
+ * const github = new GithubService();
+ * await github.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_GITHUB_TOKEN,
+ *   owner: "example-org",
+ *   repo: "example-repo",
+ * });
+ * const issue = await github.createIssue({
+ *   title: "Bug report",
+ *   body: "Something is broken",
+ *   labels: ["bug"],
+ * });
+ * ```
+ * @memberOf module:integrations/devops/github/service
+ */
+export class GithubService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "GitHub";
+    }
+    /**
+     * @description The GitHub REST API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://api.github.com"`.
+     */
+    defaultBaseUrl() {
+        return "https://api.github.com";
+    }
+    /**
+     * @description Builds the GitHub authentication and API version headers
+     * @summary Returns `Authorization: Bearer <token>`, the GitHub JSON
+     * `Accept` header, and the `X-GitHub-Api-Version` header when the config
+     * carries a token; without a token only the `Accept` headers are sent.
+     * @param {GithubServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization and version headers.
+     */
+    authHeaders(config) {
+        return config.token
+            ? {
+                Authorization: `Bearer ${config.token}`,
+                Accept: "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+            }
+            : { Accept: "application/vnd.github+json" };
+    }
+    /**
+     * @description Reads the GitHub credentials and defaults from the environment
+     * @summary Reads the `devops.github` environment slice and returns a
+     * partial config when a token is configured, `undefined` otherwise. Values
+     * pass through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<GithubServiceConfig> | undefined} A partial config, or `undefined` when no GitHub token is configured.
+     */
+    configFromEnvironment() {
+        const env = DevopsEnvironment.devops.github;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            owner: envString(env.owner),
+            repo: envString(env.repo),
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Resolves the URL-encoded repository path for a call
+     * @summary Builds `/repos/<owner>/<repo>` from the input's `owner`/`repo`,
+     * falling back to the configured config values, and throws when either
+     * value is missing.
+     * @param {GithubRepositoryRef} [input] - The per-call repository override.
+     * @returns {string} The URL-encoded repository API path.
+     * @throws {InternalError} When neither the input nor the config yields an owner and repository.
+     */
+    repoPath(input = {}) {
+        const owner = input.owner ?? this.config.owner;
+        const repo = input.repo ?? this.config.repo;
+        if (!owner || !repo) {
+            throw new InternalError("GitHub requires an owner and repository");
+        }
+        return `/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`;
+    }
+    /**
+     * @description Normalizes a raw GitHub issue payload
+     * @summary Maps the raw issue JSON onto a {@link GithubIssue}: label objects
+     * are reduced to names, the author to its `login`, and numeric/string
+     * fields are coerced. The repository reference is echoed from the input,
+     * falling back to the configured `owner`/`repo`.
+     * @param {Record<string, unknown>} raw - The raw GitHub issue payload.
+     * @param {GithubRepositoryRef} ref - The repository reference the issue belongs to.
+     * @returns {GithubIssue} The normalized issue descriptor.
+     */
+    mapIssue(raw, ref) {
+        return {
+            owner: ref.owner ?? this.config.owner,
+            repo: ref.repo ?? this.config.repo,
+            number: Number(raw["number"] ?? 0),
+            title: String(raw["title"] ?? ""),
+            state: envString(raw["state"]),
+            htmlUrl: envString(raw["html_url"]),
+            body: envString(raw["body"]),
+            user: envString(raw["user"]?.login),
+            labels: Array.isArray(raw["labels"])
+                ? raw["labels"].map((label) => typeof label === "string" ? label : String(label.name ?? ""))
+                : undefined,
+            comments: typeof raw["comments"] === "number"
+                ? raw["comments"]
+                : undefined,
+            createdAt: envString(raw["created_at"]),
+            updatedAt: envString(raw["updated_at"]),
+        };
+    }
+    /**
+     * @description Fetches a GitHub repository
+     * @summary `GET`s `/repos/<owner>/<repo>` for the given reference (falling
+     * back to the configured `owner`/`repo`) and returns the raw repository
+     * payload.
+     * @param {GithubRepositoryRef} [ref] - The repository to look up; defaults to the configured `owner`/`repo`.
+     * @returns {Promise<unknown>} The raw GitHub repository payload.
+     * @throws {InternalError} When the repository reference cannot be resolved.
+     * @throws {NotFoundError} When the repository does not exist (HTTP 404).
+     * @throws {ConflictError} When GitHub answers with HTTP 409.
+     * @throws {BadRequestError} When GitHub answers with any other HTTP error status.
+     */
+    async getRepository(ref = {}) {
+        try {
+            const response = await this.client.get(this.repoPath(ref));
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("GitHub", "get repository", error);
+        }
+    }
+    /**
+     * @description Lists GitHub issues with state, label, and page filtering
+     * @summary `GET`s `/repos/<owner>/<repo>/issues` with a `state` filter
+     * (default `"open"`), a page size (`per_page`, default `30`), a page
+     * number, and a comma-separated `labels` filter. Entries carrying a
+     * `pull_request` key are filtered out so only true issues are returned.
+     * @param {GithubListOptions} [options] - Repository override, state, paging, and label options.
+     * @returns {Promise<GithubIssue[]>} The normalized issues for the requested page.
+     * @throws {InternalError} When the repository reference cannot be resolved.
+     * @throws {NotFoundError} When the repository does not exist (HTTP 404).
+     * @throws {ConflictError} When GitHub answers with HTTP 409.
+     * @throws {BadRequestError} When GitHub answers with any other HTTP error status.
+     * @example
+     * ```ts
+     * let page = 1;
+     * for (;;) {
+     *   const issues = await github.listIssues({
+     *     state: "open",
+     *     labels: "bug,priority:high",
+     *     limit: 50,
+     *     page,
+     *   });
+     *   if (issues.length === 0) break;
+     *   page += 1;
+     * }
+     * ```
+     */
+    async listIssues(options = {}) {
+        try {
+            const response = await this.client.get(`${this.repoPath(options)}/issues`, {
+                params: {
+                    state: options.state ?? "open",
+                    per_page: options.limit ?? 30,
+                    page: options.page,
+                    labels: options.labels,
+                },
+            });
+            return response.data
+                .filter((entry) => !entry["pull_request"])
+                .map((entry) => this.mapIssue(entry, options));
+        }
+        catch (error) {
+            throw httpError("GitHub", "list issues", error);
+        }
+    }
+    /**
+     * @description Creates a GitHub issue
+     * @summary `POST`s the title, body, labels, assignees, and milestone to
+     * `/repos/<owner>/<repo>/issues` and returns the normalized issue
+     * descriptor. Requires a non-empty `title` and a resolvable repository
+     * reference.
+     * @param {GithubIssueInput} input - The issue content and repository targeting.
+     * @returns {Promise<GithubIssue>} The normalized created issue.
+     * @throws {InternalError} When the title is empty or the repository reference cannot be resolved.
+     * @throws {NotFoundError} When the repository does not exist (HTTP 404).
+     * @throws {ConflictError} When GitHub answers with HTTP 409.
+     * @throws {BadRequestError} When GitHub answers with any other HTTP error status (e.g. invalid labels or assignees).
+     */
+    async createIssue(input) {
+        if (!input.title) {
+            throw new InternalError("GitHub issue requires a title");
+        }
+        try {
+            const response = await this.client.post(`${this.repoPath(input)}/issues`, {
+                title: input.title,
+                body: input.body,
+                labels: input.labels,
+                assignees: input.assignees,
+                milestone: input.milestone,
+            });
+            return this.mapIssue(response.data, input);
+        }
+        catch (error) {
+            throw httpError("GitHub", "create issue", error);
+        }
+    }
+    /**
+     * @description Comments on a GitHub issue
+     * @summary `POST`s the comment body to
+     * `/repos/<owner>/<repo>/issues/<number>/comments` and returns the comment
+     * identifier and its HTML URL. Requires a non-empty issue number and body.
+     * @param {GithubRepositoryRef & {number: number, body: string}} input - The repository targeting, issue number, and comment body.
+     * @returns {Promise<{id: number, htmlUrl?: string}>} The created comment's ID and HTML URL.
+     * @throws {InternalError} When the issue number or body is empty, or the repository reference cannot be resolved.
+     * @throws {NotFoundError} When the issue does not exist (HTTP 404).
+     * @throws {ConflictError} When GitHub answers with HTTP 409.
+     * @throws {BadRequestError} When GitHub answers with any other HTTP error status.
+     */
+    async commentOnIssue(input) {
+        if (!input.number || !input.body) {
+            throw new InternalError("GitHub comment requires an issue number and body");
+        }
+        try {
+            const response = await this.client.post(`${this.repoPath(input)}/issues/${input.number}/comments`, {
+                body: input.body,
+            });
+            return { id: Number(response.data.id ?? 0), htmlUrl: response.data.html_url };
+        }
+        catch (error) {
+            throw httpError("GitHub", "comment on issue", error);
+        }
+    }
+    /**
+     * @description Lists GitHub pull requests with state and page filtering
+     * @summary `GET`s `/repos/<owner>/<repo>/pulls` with a `state` filter
+     * (default `"open"`), a page size (`per_page`, default `30`), and a page
+     * number. Pull requests are returned as raw GitHub payloads.
+     * @param {GithubListOptions} [options] - Repository override, state, and paging options.
+     * @returns {Promise<unknown[]>} The raw GitHub pull-request payloads.
+     * @throws {InternalError} When the repository reference cannot be resolved.
+     * @throws {NotFoundError} When the repository does not exist (HTTP 404).
+     * @throws {ConflictError} When GitHub answers with HTTP 409.
+     * @throws {BadRequestError} When GitHub answers with any other HTTP error status.
+     */
+    async listPullRequests(options = {}) {
+        try {
+            const response = await this.client.get(`${this.repoPath(options)}/pulls`, {
+                params: {
+                    state: options.state ?? "open",
+                    per_page: options.limit ?? 30,
+                    page: options.page,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("GitHub", "list pull requests", error);
+        }
+    }
+}
+//# sourceMappingURL=GithubService.js.map

package/lib/esm/devops/github/GithubService.js.map

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

package/lib/esm/devops/github/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/devops/github
+ * @summary GitHub REST v3 service (repositories, issues, pull requests).
+ * @description Re-exports the GitHub client-based service and its types.
+ */
+export * from "./GithubService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/devops/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/devops/github/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,mCAAgC"}

package/lib/esm/devops/gitlab/GitlabService.js

@@ -0,0 +1,277 @@
+/**
+ * @module integrations/devops/gitlab/service
+ * @summary GitLab REST API integration service for projects, issues, and merge requests.
+ * @description Exposes a focused subset of the GitLab REST v4 API (`/projects/*`:
+ * project lookup, issue listing/creation/commenting, and merge-request
+ * listing) as an undecorated client-based service built on
+ * {@link HttpApiService}. Configuration comes from an explicit
+ * `GitlabServiceConfig` or the `devops.gitlab` environment slice; project
+ * targets default to the configured `projectId` and can be overridden per
+ * call. Raw GitLab responses are normalized to camelCase issue descriptors,
+ * and failures are mapped to decaf errors via {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { DevopsEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description GitLab REST API integration service
+ * @summary An undecorated HTTP service for looking up projects,
+ * listing issues, creating issues, commenting on issues (notes), and listing
+ * merge requests. Project targets resolve per call from the input's
+ * `projectId`, falling back to the configured value, and throw
+ * `InternalError` when unresolved. The token is sent as the `PRIVATE-TOKEN`
+ * header, and transport failures are mapped to decaf errors via
+ * {@link httpError}.
+ * @class GitlabService
+ * @category DevOps
+ * @example
+ * ```ts
+ * import { GitlabService } from "@decaf-ts/integrations/devops/gitlab";
+ *
+ * const gitlab = new GitlabService();
+ * await gitlab.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_GITLAB_TOKEN,
+ *   projectId: "example-org%2Fexample-repo",
+ * });
+ * const issue = await gitlab.createIssue({
+ *   title: "Bug report",
+ *   description: "Something is broken",
+ * });
+ * ```
+ * @memberOf module:integrations/devops/gitlab/service
+ */
+export class GitlabService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "GitLab";
+    }
+    /**
+     * @description The GitLab REST v4 base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://gitlab.com/api/v4"`.
+     */
+    defaultBaseUrl() {
+        return "https://gitlab.com/api/v4";
+    }
+    /**
+     * @description Builds the GitLab `PRIVATE-TOKEN` authorization headers
+     * @summary Returns the `PRIVATE-TOKEN: <token>` header when the config
+     * carries a token, and no headers otherwise.
+     * @param {GitlabServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        return config.token ? { "PRIVATE-TOKEN": config.token } : {};
+    }
+    /**
+     * @description Reads the GitLab credentials and defaults from the environment
+     * @summary Reads the `devops.gitlab` environment slice and returns a
+     * partial config when a token is configured, `undefined` otherwise. Values
+     * pass through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<GitlabServiceConfig> | undefined} A partial config, or `undefined` when no GitLab token is configured.
+     */
+    configFromEnvironment() {
+        const env = DevopsEnvironment.devops.gitlab;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            projectId: envString(env.projectId),
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Resolves the URL-encoded project path for a call
+     * @summary Builds `/projects/<projectId>` from the given project ID,
+     * falling back to the configured value, and throws when neither is
+     * available.
+     * @param {string} [projectId] - The per-call project override (URL-encoded path or numeric ID).
+     * @returns {string} The URL-encoded project API path.
+     * @throws {InternalError} When neither the input nor the config yields a project ID.
+     */
+    projectPath(projectId) {
+        const resolved = projectId ?? this.config.projectId;
+        if (!resolved)
+            throw new InternalError("GitLab requires a project ID");
+        return `/projects/${encodeURIComponent(resolved)}`;
+    }
+    /**
+     * @description Normalizes a raw GitLab issue payload
+     * @summary Maps the raw issue JSON onto a {@link GitlabIssue}: the author
+     * to its `username`, the label array to strings, and numeric/string fields
+     * are coerced. The project ID is echoed from the input, falling back to the
+     * configured value.
+     * @param {Record<string, unknown>} raw - The raw GitLab issue payload.
+     * @param {string} [projectId] - The project ID the issue belongs to.
+     * @returns {GitlabIssue} The normalized issue descriptor.
+     */
+    mapIssue(raw, projectId) {
+        return {
+            projectId: projectId ?? this.config.projectId,
+            iid: Number(raw["iid"] ?? raw["id"] ?? 0),
+            title: String(raw["title"] ?? ""),
+            state: envString(raw["state"]),
+            webUrl: envString(raw["web_url"]),
+            description: envString(raw["description"]),
+            author: envString(raw["author"]?.username),
+            labels: Array.isArray(raw["labels"])
+                ? raw["labels"].map((label) => String(label))
+                : undefined,
+            createdAt: envString(raw["created_at"]),
+            updatedAt: envString(raw["updated_at"]),
+        };
+    }
+    /**
+     * @description Fetches a GitLab project
+     * @summary `GET`s `/projects/<projectId>` for the given ID (falling back to
+     * the configured `projectId`) and returns the raw project payload.
+     * @param {string} [projectId] - The project to look up; defaults to the configured `projectId`.
+     * @returns {Promise<unknown>} The raw GitLab project payload.
+     * @throws {InternalError} When the project ID cannot be resolved.
+     * @throws {NotFoundError} When the project does not exist (HTTP 404).
+     * @throws {ConflictError} When GitLab answers with HTTP 409.
+     * @throws {BadRequestError} When GitLab answers with any other HTTP error status.
+     */
+    async getProject(projectId) {
+        try {
+            const response = await this.client.get(this.projectPath(projectId));
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("GitLab", "get project", error);
+        }
+    }
+    /**
+     * @description Lists GitLab issues with state, label, search, and page filtering
+     * @summary `GET`s `/projects/<projectId>/issues` with a `state` filter
+     * (default `"opened"`), a page size (`per_page`, default `30`), a page
+     * number, a comma-separated `labels` filter, and a `search` term.
+     * @param {GitlabListOptions} [options] - Project override, state, paging, label, and search options.
+     * @returns {Promise<GitlabIssue[]>} The normalized issues for the requested page.
+     * @throws {InternalError} When the project ID cannot be resolved.
+     * @throws {NotFoundError} When the project does not exist (HTTP 404).
+     * @throws {ConflictError} When GitLab answers with HTTP 409.
+     * @throws {BadRequestError} When GitLab answers with any other HTTP error status.
+     * @example
+     * ```ts
+     * const issues = await gitlab.listIssues({
+     *   projectId: "example-org%2Fexample-repo",
+     *   state: "opened",
+     *   labels: "bug,priority::high",
+     *   limit: 50,
+     *   page: 1,
+     * });
+     * ```
+     */
+    async listIssues(options = {}) {
+        try {
+            const response = await this.client.get(`${this.projectPath(options.projectId)}/issues`, {
+                params: {
+                    state: options.state ?? "opened",
+                    per_page: options.limit ?? 30,
+                    page: options.page,
+                    labels: options.labels,
+                    search: options.search,
+                },
+            });
+            return response.data.map((entry) => this.mapIssue(entry, options.projectId));
+        }
+        catch (error) {
+            throw httpError("GitLab", "list issues", error);
+        }
+    }
+    /**
+     * @description Creates a GitLab issue
+     * @summary `POST`s the title, description, labels, assignee IDs, and
+     * milestone ID to `/projects/<projectId>/issues` and returns the normalized
+     * issue descriptor. Requires a non-empty `title` and a resolvable project
+     * ID.
+     * @param {GitlabIssueInput} input - The issue content and project targeting.
+     * @returns {Promise<GitlabIssue>} The normalized created issue.
+     * @throws {InternalError} When the title is empty or the project ID cannot be resolved.
+     * @throws {NotFoundError} When the project does not exist (HTTP 404).
+     * @throws {ConflictError} When GitLab answers with HTTP 409.
+     * @throws {BadRequestError} When GitLab answers with any other HTTP error status (e.g. invalid labels or assignees).
+     */
+    async createIssue(input) {
+        if (!input.title) {
+            throw new InternalError("GitLab issue requires a title");
+        }
+        try {
+            const response = await this.client.post(`${this.projectPath(input.projectId)}/issues`, {
+                title: input.title,
+                description: input.description,
+                labels: input.labels,
+                assignee_ids: input.assigneeIds,
+                milestone_id: input.milestoneId,
+            });
+            return this.mapIssue(response.data, input.projectId);
+        }
+        catch (error) {
+            throw httpError("GitLab", "create issue", error);
+        }
+    }
+    /**
+     * @description Comments on a GitLab issue
+     * @summary `POST`s the comment body as a note to
+     * `/projects/<projectId>/issues/<iid>/notes` and returns the note
+     * identifier and its web URL. Requires a non-empty issue IID and body.
+     * @param {object} input - The comment target and body.
+     * @param {string} [input.projectId] - The project override; falls back to the configured `projectId`.
+     * @param {number} input.iid - The issue's project-scoped IID.
+     * @param {string} input.body - The comment body.
+     * @returns {Promise<{id: number, webUrl?: string}>} The created note's ID and web URL.
+     * @throws {InternalError} When the issue IID or body is empty, or the project ID cannot be resolved.
+     * @throws {NotFoundError} When the issue does not exist (HTTP 404).
+     * @throws {ConflictError} When GitLab answers with HTTP 409.
+     * @throws {BadRequestError} When GitLab answers with any other HTTP error status.
+     */
+    async commentOnIssue(input) {
+        if (!input.iid || !input.body) {
+            throw new InternalError("GitLab comment requires an issue IID and body");
+        }
+        try {
+            const response = await this.client.post(`${this.projectPath(input.projectId)}/issues/${input.iid}/notes`, { body: input.body });
+            return { id: Number(response.data.id ?? 0), webUrl: response.data.web_url };
+        }
+        catch (error) {
+            throw httpError("GitLab", "comment on issue", error);
+        }
+    }
+    /**
+     * @description Lists GitLab merge requests with state, search, and page filtering
+     * @summary `GET`s `/projects/<projectId>/merge_requests` with a `state`
+     * filter (default `"opened"`; `"all"` is sent as no state parameter),
+     * a page size (`per_page`, default `30`), a page number, and a `search`
+     * term. Merge requests are returned as raw GitLab payloads.
+     * @param {GitlabListOptions} [options] - Project override, state, paging, and search options.
+     * @returns {Promise<unknown[]>} The raw GitLab merge-request payloads.
+     * @throws {InternalError} When the project ID cannot be resolved.
+     * @throws {NotFoundError} When the project does not exist (HTTP 404).
+     * @throws {ConflictError} When GitLab answers with HTTP 409.
+     * @throws {BadRequestError} When GitLab answers with any other HTTP error status.
+     */
+    async listMergeRequests(options = {}) {
+        try {
+            const response = await this.client.get(`${this.projectPath(options.projectId)}/merge_requests`, {
+                params: {
+                    state: options.state === "all" ? undefined : options.state ?? "opened",
+                    per_page: options.limit ?? 30,
+                    page: options.page,
+                    search: options.search,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("GitLab", "list merge requests", error);
+        }
+    }
+}
+//# sourceMappingURL=GitlabService.js.map

package/lib/esm/devops/gitlab/GitlabService.js.map

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

package/lib/esm/devops/gitlab/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/devops/gitlab
+ * @summary GitLab REST v4 service (projects, issues, merge requests).
+ * @description Re-exports the GitLab client-based service and its types.
+ */
+export * from "./GitlabService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/devops/gitlab/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/devops/gitlab/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,mCAAgC"}

package/lib/esm/devops/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/devops
+ * @summary DevOps integration services (GitHub, GitLab).
+ * @description Re-exports the repository-hosting services, their per-service
+ * modules, and the shared `devops` environment slice. Each sub-module is also
+ * available through its own package subpath export.
+ */
+export * from "./github/index.js";
+export * from "./gitlab/index.js";
+export * from "./environment.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/devops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/devops/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,kCAAyB;AACzB,kCAAyB;AACzB,iCAA8B"}

package/lib/esm/feature-flags/models/FeatureFlag.model.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+import { description } from "@decaf-ts/decoration";
 import { BaseModel } from "@decaf-ts/core";
 import { column, createdAt, pk, table, updatedAt, uuid, unique, } from "@decaf-ts/core";
 import { model, required } from "@decaf-ts/decorator-validation";
@@ -64,6 +65,7 @@ __decorate([
     __metadata("design:type", Date)
 ], FeatureFlag.prototype, "updatedAt", void 0);
 FeatureFlag = __decorate([
+    description("Persisted feature flag definition used for runtime evaluation"),
     table("feature_flags"),
     model(),
     __metadata("design:paramtypes", [Object])

package/lib/esm/feature-flags/models/FeatureFlag.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureFlag.model.js","sourceRoot":"","sources":["../../../../src/feature-flags/models/FeatureFlag.model.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,MAAM,EACN,SAAS,EACT,EAAE,EACF,KAAK,EACL,SAAS,EACT,IAAI,EACJ,MAAM,GACP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK1D,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,SAAS;IACxC,YAAY,IAA2B;QACrC,KAAK,CAAC,IAAI,CAAC,CAAC;QAad,YAAO,GAAY,IAAI,CAAC;IAZxB,CAAC;CAqCF,CAAA;AAjCC;IAFC,EAAE,EAAE;IACJ,IAAI,EAAE;;uCACK;AAKZ;IAHC,MAAM,EAAE;IACR,QAAQ,EAAE;IACV,MAAM,EAAE;;wCACI;AAGb;IADC,MAAM,EAAE;;4CACe;AAGxB;IADC,MAAM,EAAE;;gDACY;AAGrB;IADC,MAAM,EAAE;;0CACM;AAGf;IADC,MAAM,EAAE;;6CAC0B;AAGnC;IADC,MAAM,EAAE;;2CACkB;AAG3B;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAGjB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAvCN,WAAW;IAFvB,KAAK,CAAC,eAAe,CAAC;IACtB,KAAK,EAAE;;GACK,WAAW,CAwCvB"}
+{"version":3,"file":"FeatureFlag.model.js","sourceRoot":"","sources":["../../../../src/feature-flags/models/FeatureFlag.model.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EACL,MAAM,EACN,SAAS,EACT,EAAE,EACF,KAAK,EACL,SAAS,EACT,IAAI,EACJ,MAAM,GACP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM1D,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,SAAS;IACxC,YAAY,IAA2B;QACrC,KAAK,CAAC,IAAI,CAAC,CAAC;QAad,YAAO,GAAY,IAAI,CAAC;IAZxB,CAAC;CAqCF,CAAA;AAjCC;IAFC,EAAE,EAAE;IACJ,IAAI,EAAE;;uCACK;AAKZ;IAHC,MAAM,EAAE;IACR,QAAQ,EAAE;IACV,MAAM,EAAE;;wCACI;AAGb;IADC,MAAM,EAAE;;4CACe;AAGxB;IADC,MAAM,EAAE;;gDACY;AAGrB;IADC,MAAM,EAAE;;0CACM;AAGf;IADC,MAAM,EAAE;;6CAC0B;AAGnC;IADC,MAAM,EAAE;;2CACkB;AAG3B;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,MAAM,EAAE;;8CACU;AAGnB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAGjB;IADC,SAAS,EAAE;8BACA,IAAI;8CAAC;AAvCN,WAAW;IAHvB,WAAW,CAAC,+DAA+D,CAAC;IAC5E,KAAK,CAAC,eAAe,CAAC;IACtB,KAAK,EAAE;;GACK,WAAW,CAwCvB"}