@decaf-ts/integrations 0.10.8 → 0.12.0

package/lib/cjs/devops/gitlab/GitlabService.cjs

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitlabService = void 0;
+/**
+ * @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}.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const environment_js_1 = require("./../environment.cjs");
+const environmentValue_js_1 = require("./../../shared/environmentValue.cjs");
+const index_js_1 = require("./../../shared/http/index.cjs");
+/**
+ * @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
+ */
+class GitlabService extends index_js_1.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 = environment_js_1.DevopsEnvironment.devops.gitlab;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            projectId: (0, environmentValue_js_1.envString)(env.projectId),
+            baseUrl: (0, environmentValue_js_1.envString)(env.baseUrl),
+            timeout: (0, environmentValue_js_1.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 db_decorators_1.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: (0, environmentValue_js_1.envString)(raw["state"]),
+            webUrl: (0, environmentValue_js_1.envString)(raw["web_url"]),
+            description: (0, environmentValue_js_1.envString)(raw["description"]),
+            author: (0, environmentValue_js_1.envString)(raw["author"]?.username),
+            labels: Array.isArray(raw["labels"])
+                ? raw["labels"].map((label) => String(label))
+                : undefined,
+            createdAt: (0, environmentValue_js_1.envString)(raw["created_at"]),
+            updatedAt: (0, environmentValue_js_1.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 (0, index_js_1.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 (0, index_js_1.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 db_decorators_1.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 (0, index_js_1.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 db_decorators_1.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 (0, index_js_1.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 (0, index_js_1.httpError)("GitLab", "list merge requests", error);
+        }
+    }
+}
+exports.GitlabService = GitlabService;
+//# sourceMappingURL=GitlabService.js.map
+//# sourceMappingURL=GitlabService.cjs.map

package/lib/cjs/devops/gitlab/GitlabService.cjs.map

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

package/lib/cjs/devops/gitlab/index.cjs

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/devops/gitlab
+ * @summary GitLab REST v4 service (projects, issues, merge requests).
+ * @description Re-exports the GitLab client-based service and its types.
+ */
+__exportStar(require("./GitlabService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/devops/gitlab/index.cjs.map

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

package/lib/cjs/devops/index.cjs

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @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.
+ */
+__exportStar(require("./github/index.cjs"), exports);
+__exportStar(require("./gitlab/index.cjs"), exports);
+__exportStar(require("./environment.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/devops/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"devops/index.cjs","sourceRoot":"","sources":["devops/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,oDAAkC;AAClC,oDAAkC;AAClC,mDAAiC;AACjC,iCAAiC"}

package/lib/cjs/feature-flags/EngineCapabilityFeatureFlag.service.cjs

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EngineCapabilityFeatureFlagService = void 0;
+exports.engineCapabilityFlagKey = engineCapabilityFlagKey;
+exports.engineCapabilityFlagRegistry = engineCapabilityFlagRegistry;
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+        r = Reflect.decorate(decorators, target, key, desc);
+    else
+        for (var i = decorators.length - 1; i >= 0; i--)
+            if (d = decorators[i])
+                r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+        return Reflect.metadata(k, v);
+};
+var EngineCapabilityFeatureFlagService_1;
+/**
+ * @module integrations/feature-flags/EngineCapabilityFeatureFlag.service
+ * @summary Capability-derived feature-flag service (SAA-197, SAA-193 C22).
+ * @description A {@link FeatureFlagService} subclass whose flag values are derived
+ * exclusively from a served engine capability manifest — never from the
+ * environment and never from the persistence repository. Resolution is
+ * fail-closed: a feature that the manifest does not declare resolves to
+ * `false`/absent, so an undeclared feature is denied rather than admitted.
+ *
+ * The input is the same manifest shape the as-graph server serves (per engine:
+ * `engineId` plus `capabilities: [{ feature, verdict }]`), so no import of the
+ * as-graph package is required and the dependency direction is preserved.
+ */
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const FeatureFlag_model_js_1 = require("./models/FeatureFlag.model.cjs");
+const FeatureFlagReader_js_1 = require("./readers/FeatureFlagReader.cjs");
+const FeatureFlag_service_js_1 = require("./services/FeatureFlag.service.cjs");
+const utils_js_1 = require("./utils.cjs");
+/** Pascal-cases a flag segment through the shared feature-name normalizer. */
+function pascalSegment(value) {
+    const normalized = (0, utils_js_1.normalizeFeatureName)(value);
+    return normalized
+        ? normalized.charAt(0).toUpperCase() + normalized.slice(1)
+        : normalized;
+}
+/**
+ * Builds the canonical, collision-safe feature-flag key for an engine, or for one
+ * feature of an engine. Keys are `engine<Pascal(engineId)>` and
+ * `engine<Pascal(engineId)><Pascal(feature)>`; use this helper rather than
+ * assembling keys by hand.
+ *
+ * @param engineId - The engine id.
+ * @param feature - The feature name, when a feature key is wanted.
+ * @returns The canonical flag key.
+ */
+function engineCapabilityFlagKey(engineId, feature) {
+    const engine = pascalSegment(engineId);
+    return feature === undefined
+        ? `engine${engine}`
+        : `engine${engine}${pascalSegment(feature)}`;
+}
+/**
+ * Derives a fail-closed feature-flag registry from an engine capability manifest:
+ * an engine key is enabled, and a feature key is enabled **only** when the engine
+ * declares that feature `SUPPORTED`. Features declared `NOT_SUPPORTED` or
+ * `EXTENSION_POINT`, and features absent from the manifest, are all disabled.
+ *
+ * @param manifest - The served engine capability manifest.
+ * @returns The derived flag registry.
+ */
+function engineCapabilityFlagRegistry(manifest) {
+    const registry = {};
+    for (const engine of manifest.engines ?? []) {
+        registry[engineCapabilityFlagKey(engine.engineId)] = true;
+        for (const capability of engine.capabilities ?? []) {
+            registry[engineCapabilityFlagKey(engine.engineId, capability.feature)] =
+                capability.verdict === "SUPPORTED";
+        }
+    }
+    return registry;
+}
+/**
+ * A {@link FeatureFlagReader} over an already-derived capability registry. It
+ * never reads the environment; {@link FeatureFlagReader.read} returns a copy of the
+ * capability registry so the base service's reader plumbing stays satisfied.
+ */
+class EngineCapabilityFlagReader extends FeatureFlagReader_js_1.FeatureFlagReader {
+    /**
+     * @param registry - The capability-derived flag registry.
+     */
+    constructor(registry) {
+        super();
+        this.registry = registry;
+    }
+    /** Returns a copy of the capability registry, ignoring any reader input. */
+    async read(input) {
+        void input;
+        return { ...this.registry };
+    }
+}
+/**
+ * A {@link FeatureFlagService} whose values come from the served engine
+ * capability manifest. Every read path (`isEnabled`, `resolveFeatureFlags`,
+ * `isEnabledForSubject`, `resolveFeatureFlagsForSubject`) resolves against the
+ * derived registry only; a feature the manifest does not declare is denied.
+ * `syncFromEnvironment` is overridden to fail closed rather than read the
+ * environment.
+ *
+ * Carries its own `@service()` decorator: the parent {@link FeatureFlagService}
+ * is itself `@service(...)`-decorated, so without a decorator of its own the
+ * parent constructor's singleton wrapper would be returned and the capability
+ * methods below would be unreachable. Decorating the leaf subclass restores it;
+ * the subclass does not rely on the parent's environment/repository fields.
+ *
+ * The constructor additionally re-parents the constructed instance when the parent's
+ * singleton wrapper has already cached a `FeatureFlagService` (which would otherwise
+ * be returned through `super()`), so the capability methods stay reachable on every
+ * construction.
+ */
+let EngineCapabilityFeatureFlagService = EngineCapabilityFeatureFlagService_1 = class EngineCapabilityFeatureFlagService extends FeatureFlag_service_js_1.FeatureFlagService {
+    constructor() {
+        const base = super();
+        if (!(this instanceof EngineCapabilityFeatureFlagService_1)) {
+            return Object.assign(Object.create(EngineCapabilityFeatureFlagService_1.prototype), base, { capabilityRegistry: {} });
+        }
+        this.capabilityRegistry = {};
+    }
+    /**
+     * Initializes the service from its manifest, replacing the base service's
+     * environment/repository-backed registry with the capability-derived one. No
+     * environment source is read.
+     */
+    async initialize(...args) {
+        const config = args[0] ?? {};
+        if (config.repository) {
+            this._repository = config.repository;
+        }
+        this.capabilityRegistry = engineCapabilityFlagRegistry(config.manifest ?? { engines: [] });
+        const reader = new EngineCapabilityFlagReader(this.capabilityRegistry);
+        const effectiveConfig = {
+            ...config,
+            reader,
+            readerConfig: { ...(config.readerConfig ?? {}), source: {} },
+        };
+        return { config: effectiveConfig, client: reader };
+    }
+    /**
+     * Whether an engine is available in the manifest.
+     *
+     * @param engineId - The engine id to check.
+     * @returns `true` when the engine is declared.
+     */
+    isEngineEnabled(engineId) {
+        return (0, utils_js_1.isFeatureFlagEnabledByName)(this.capabilityRegistry, engineCapabilityFlagKey(engineId));
+    }
+    /**
+     * Whether an engine declares a feature as `SUPPORTED`. An undeclared feature,
+     * or one declared `NOT_SUPPORTED`/`EXTENSION_POINT`, resolves `false`.
+     *
+     * @param engineId - The engine id to check.
+     * @param feature - The feature name to check.
+     * @returns `true` only when the manifest declares the feature `SUPPORTED`.
+     */
+    isEngineFeatureEnabled(engineId, feature) {
+        return (0, utils_js_1.isFeatureFlagEnabledByName)(this.capabilityRegistry, engineCapabilityFlagKey(engineId, feature));
+    }
+    /** Resolves a flag from the capability registry; undeclared keys are denied. */
+    isEnabled(key) {
+        return (0, utils_js_1.isFeatureFlagEnabledByName)(this.capabilityRegistry, key);
+    }
+    /** Returns a copy of the capability-derived registry. */
+    async resolveFeatureFlags() {
+        return { ...this.capabilityRegistry };
+    }
+    /** Returns a copy of the capability-derived registry (not subject-scoped). */
+    async resolveFeatureFlagsForSubject(subject, ...args) {
+        void subject;
+        void args;
+        return { ...this.capabilityRegistry };
+    }
+    /** Resolves a flag from the capability registry; undeclared keys are denied. */
+    async isEnabledForSubject(key, subject, ...args) {
+        void subject;
+        void args;
+        return (0, utils_js_1.isFeatureFlagEnabledByName)(this.capabilityRegistry, key);
+    }
+    /** Lists the enabled capability flags as models, without touching a repository. */
+    async listEnabled(...args) {
+        void args;
+        return Object.entries(this.capabilityRegistry)
+            .filter(([, value]) => (0, utils_js_1.isFeatureFlagEnabled)(value))
+            .map(([key]) => new FeatureFlag_model_js_1.FeatureFlag({
+            key,
+            enabled: true,
+            config: { enabled: true },
+        }));
+    }
+    /**
+     * Fails closed: capability flags are derived from the served engine manifest
+     * and are never synced from the environment.
+     */
+    async syncFromEnvironment(...args) {
+        void args;
+        throw new db_decorators_1.InternalError("Engine capability feature flags are derived from the served engine manifest and are never synced from the environment");
+    }
+};
+exports.EngineCapabilityFeatureFlagService = EngineCapabilityFeatureFlagService;
+exports.EngineCapabilityFeatureFlagService = EngineCapabilityFeatureFlagService = EngineCapabilityFeatureFlagService_1 = __decorate([
+    (0, core_1.service)(),
+    __metadata("design:paramtypes", [])
+], EngineCapabilityFeatureFlagService);
+//# sourceMappingURL=EngineCapabilityFeatureFlag.service.js.map
+//# sourceMappingURL=EngineCapabilityFeatureFlag.service.cjs.map

package/lib/cjs/feature-flags/EngineCapabilityFeatureFlag.service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags/EngineCapabilityFeatureFlag.service.cjs","sourceRoot":"","sources":["feature-flags/EngineCapabilityFeatureFlag.service.js"],"names":[],"mappings":";;;AA8CA,0DAKC;AAUD,oEAUC;AAvED,IAAI,UAAU,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI;IACjF,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7H,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU;QAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;;QAC1H,KAAK,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;gBAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAClJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC;AACF,IAAI,UAAU,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC;IACxD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7G,CAAC,CAAC;AACF,IAAI,oCAAoC,CAAC;AACzC;;;;;;;;;;;;GAYG;AACH,yCAAyC;AACzC,2DAAwD;AACxD,wEAA4D;AAC5D,yEAAmE;AACnE,8EAAwE;AACxE,yCAAqG;AACrG,8EAA8E;AAC9E,SAAS,aAAa,CAAC,KAAK;IACxB,MAAM,UAAU,GAAG,IAAA,+BAAoB,EAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,UAAU;QACb,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,UAAU,CAAC;AACrB,CAAC;AACD;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,OAAO,KAAK,SAAS;QACxB,CAAC,CAAC,SAAS,MAAM,EAAE;QACnB,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;AACrD,CAAC;AACD;;;;;;;;GAQG;AACH,SAAgB,4BAA4B,CAAC,QAAQ;IACjD,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC1C,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;QAC1D,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YACjD,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClE,UAAU,CAAC,OAAO,KAAK,WAAW,CAAC;QAC3C,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AACD;;;;GAIG;AACH,MAAM,0BAA2B,SAAQ,wCAAiB;IACtD;;OAEG;IACH,YAAY,QAAQ;QAChB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD,4EAA4E;IAC5E,KAAK,CAAC,IAAI,CAAC,KAAK;QACZ,KAAK,KAAK,CAAC;QACX,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;CACJ;AACD;;;;;;;;;;;;;;;;;;GAkBG;AACH,IAAI,kCAAkC,GAAG,oCAAoC,GAAG,MAAM,kCAAmC,SAAQ,2CAAkB;IAC/I;QACI,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,IAAI,YAAY,oCAAoC,CAAC,EAAE,CAAC;YAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,oCAAoC,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1H,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IACjC,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,4BAA4B,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACvE,MAAM,eAAe,GAAG;YACpB,GAAG,MAAM;YACT,MAAM;YACN,YAAY,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;SAC/D,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvD,CAAC;IACD;;;;;OAKG;IACH,eAAe,CAAC,QAAQ;QACpB,OAAO,IAAA,qCAA0B,EAAC,IAAI,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClG,CAAC;IACD;;;;;;;OAOG;IACH,sBAAsB,CAAC,QAAQ,EAAE,OAAO;QACpC,OAAO,IAAA,qCAA0B,EAAC,IAAI,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3G,CAAC;IACD,gFAAgF;IAChF,SAAS,CAAC,GAAG;QACT,OAAO,IAAA,qCAA0B,EAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,yDAAyD;IACzD,KAAK,CAAC,mBAAmB;QACrB,OAAO,EAAE,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC1C,CAAC;IACD,8EAA8E;IAC9E,KAAK,CAAC,6BAA6B,CAAC,OAAO,EAAE,GAAG,IAAI;QAChD,KAAK,OAAO,CAAC;QACb,KAAK,IAAI,CAAC;QACV,OAAO,EAAE,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC1C,CAAC;IACD,gFAAgF;IAChF,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI;QAC3C,KAAK,OAAO,CAAC;QACb,KAAK,IAAI,CAAC;QACV,OAAO,IAAA,qCAA0B,EAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,mFAAmF;IACnF,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI;QACrB,KAAK,IAAI,CAAC;QACV,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC;aACzC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAA,+BAAoB,EAAC,KAAK,CAAC,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,kCAAW,CAAC;YAChC,GAAG;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SAC5B,CAAC,CAAC,CAAC;IACR,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAG,IAAI;QAC7B,KAAK,IAAI,CAAC;QACV,MAAM,IAAI,6BAAa,CAAC,uHAAuH,CAAC,CAAC;IACrJ,CAAC;CACJ,CAAC;AAKO,gFAAkC;AAJ3C,6CAAA,kCAAkC,GAAG,oCAAoC,GAAG,UAAU,CAAC;IACnF,IAAA,cAAO,GAAE;IACT,UAAU,CAAC,mBAAmB,EAAE,EAAE,CAAC;CACtC,EAAE,kCAAkC,CAAC,CAAC;AAEvC,+DAA+D"}

package/lib/cjs/feature-flags/index.cjs

@@ -26,6 +26,7 @@ __exportStar(require("./models/FeatureFlag.model.cjs"), exports);
 __exportStar(require("./models/FeatureFlagAccess.model.cjs"), exports);
 __exportStar(require("./readers/index.cjs"), exports);
 __exportStar(require("./services/FeatureFlag.service.cjs"), exports);
+__exportStar(require("./EngineCapabilityFeatureFlag.service.cjs"), exports);
 __exportStar(require("./decorators.cjs"), exports);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.cjs.map

package/lib/cjs/feature-flags/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags/index.cjs","sourceRoot":"","sources":["feature-flags/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,mDAAiC;AACjC,gEAA8C;AAC9C,sEAAoD;AACpD,qDAAmC;AACnC,oEAAkD;AAClD,kDAAgC;AAChC,iCAAiC"}
+{"version":3,"file":"feature-flags/index.cjs","sourceRoot":"","sources":["feature-flags/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,mDAAiC;AACjC,gEAA8C;AAC9C,sEAAoD;AACpD,qDAAmC;AACnC,oEAAkD;AAClD,2EAAyD;AACzD,kDAAgC;AAChC,iCAAiC"}

package/lib/cjs/feature-flags/models/FeatureFlag.model.cjs

@@ -15,6 +15,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
         return Reflect.metadata(k, v);
 };
+const decoration_1 = require("@decaf-ts/decoration");
 const core_1 = require("@decaf-ts/core");
 const core_2 = require("@decaf-ts/core");
 const decorator_validation_1 = require("@decaf-ts/decorator-validation");
@@ -73,6 +74,7 @@ __decorate([
     __metadata("design:type", Date)
 ], FeatureFlag.prototype, "updatedAt", void 0);
 exports.FeatureFlag = FeatureFlag = __decorate([
+    (0, decoration_1.description)("Persisted feature flag definition used for runtime evaluation"),
     (0, core_2.table)("feature_flags"),
     (0, decorator_validation_1.model)(),
     __metadata("design:paramtypes", [Object])

package/lib/cjs/feature-flags/models/FeatureFlag.model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags/models/FeatureFlag.model.cjs","sourceRoot":"","sources":["feature-flags/models/FeatureFlag.model.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"feature-flags/models/FeatureFlag.model.cjs","sourceRoot":"","sources":["feature-flags/models/FeatureFlag.model.js"],"names":[],"mappings":"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"}

package/lib/cjs/feature-flags/models/FeatureFlagAccess.model.cjs

@@ -15,6 +15,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
         return Reflect.metadata(k, v);
 };
+const decoration_1 = require("@decaf-ts/decoration");
 const core_1 = require("@decaf-ts/core");
 const core_2 = require("@decaf-ts/core");
 const decorator_validation_1 = require("@decaf-ts/decorator-validation");
@@ -70,6 +71,7 @@ __decorate([
     __metadata("design:type", Date)
 ], FeatureFlagAccess.prototype, "updatedAt", void 0);
 exports.FeatureFlagAccess = FeatureFlagAccess = __decorate([
+    (0, decoration_1.description)("Persisted feature flag access rule for a subject"),
     (0, core_2.table)("feature_flag_access"),
     (0, decorator_validation_1.model)(),
     __metadata("design:paramtypes", [Object])