@decaf-ts/integrations 0.3.12 → 0.4.1-0

package/lib/esm/plugins/superset/types.js

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/plugins/superset/types
+ * @summary Superset embed plugin types.
+ * @description Re-exports the shared contract types and Superset-specific
+ * constants/types for the org-agnostic dashboard embed plugin.
+ */
+export * from "./../contract.js";
+export { SUPERSET_PLUGIN_ID, SUPERSET_APP_ID, SUPERSET_PLUGIN_VERSION, buildSupersetManifest, } from "./manifest.js";
+export { supersetPatchFiles } from "./templates.js";
+export { SupersetDashboardEmbedPlugin, supersetDashboardEmbedPlugin, createSupersetDashboardEmbedPlugin, buildSupersetEmbedUrl, SUPERSET_DEFAULT_BASE_PATH, } from "./installer.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvcGx1Z2lucy9zdXBlcnNldC90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7R0FLRztBQUNILGlDQUE0QjtBQUM1QixPQUFPLEVBQ0wsa0JBQWtCLEVBQ2xCLGVBQWUsRUFDZix1QkFBdUIsRUFDdkIscUJBQXFCLEdBRXRCLHNCQUFtQjtBQUNwQixPQUFPLEVBQUUsa0JBQWtCLEVBQTBCLHVCQUFvQjtBQUN6RSxPQUFPLEVBQ0wsNEJBQTRCLEVBQzVCLDRCQUE0QixFQUM1QixrQ0FBa0MsRUFDbEMscUJBQXFCLEVBQ3JCLDBCQUEwQixHQUUzQix1QkFBb0IiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL3BsdWdpbnMvc3VwZXJzZXQvdHlwZXNcbiAqIEBzdW1tYXJ5IFN1cGVyc2V0IGVtYmVkIHBsdWdpbiB0eXBlcy5cbiAqIEBkZXNjcmlwdGlvbiBSZS1leHBvcnRzIHRoZSBzaGFyZWQgY29udHJhY3QgdHlwZXMgYW5kIFN1cGVyc2V0LXNwZWNpZmljXG4gKiBjb25zdGFudHMvdHlwZXMgZm9yIHRoZSBvcmctYWdub3N0aWMgZGFzaGJvYXJkIGVtYmVkIHBsdWdpbi5cbiAqL1xuZXhwb3J0ICogZnJvbSBcIi4uL2NvbnRyYWN0XCI7XG5leHBvcnQge1xuICBTVVBFUlNFVF9QTFVHSU5fSUQsXG4gIFNVUEVSU0VUX0FQUF9JRCxcbiAgU1VQRVJTRVRfUExVR0lOX1ZFUlNJT04sXG4gIGJ1aWxkU3VwZXJzZXRNYW5pZmVzdCxcbiAgdHlwZSBTdXBlcnNldE1hbmlmZXN0LFxufSBmcm9tIFwiLi9tYW5pZmVzdFwiO1xuZXhwb3J0IHsgc3VwZXJzZXRQYXRjaEZpbGVzLCB0eXBlIFN1cGVyc2V0UGF0Y2hGaWxlIH0gZnJvbSBcIi4vdGVtcGxhdGVzXCI7XG5leHBvcnQge1xuICBTdXBlcnNldERhc2hib2FyZEVtYmVkUGx1Z2luLFxuICBzdXBlcnNldERhc2hib2FyZEVtYmVkUGx1Z2luLFxuICBjcmVhdGVTdXBlcnNldERhc2hib2FyZEVtYmVkUGx1Z2luLFxuICBidWlsZFN1cGVyc2V0RW1iZWRVcmwsXG4gIFNVUEVSU0VUX0RFRkFVTFRfQkFTRV9QQVRILFxuICB0eXBlIFN1cGVyc2V0SW5zdGFsbE9wdGlvbnMsXG59IGZyb20gXCIuL2luc3RhbGxlclwiO1xuIl19

package/lib/types/feature-flags/constants.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/feature-flags
+ * @summary Feature flag constants and metadata keys.
+ */
+export declare const FEATURE_FLAG_ENV_ROOT = "featureFlag";
+export declare const FEATURE_FLAG_ENV_PREFIX = "FEATURE_FLAG";
+export declare const FEATURE_FLAG_MODEL_KEY = "feature-flags:model";
+export declare const FEATURE_FLAG_AUTH_KEY = "feature-flags:auth";
+export declare const FEATURE_FLAG_BLOCK_KEY = "feature-flags:block";
+export declare const FEATURE_FLAG_RENDER_KEY = "feature-flags:render-if";
+export declare const FEATURE_FLAG_HIDE_KEY = "feature-flags:hide-on";

package/lib/types/feature-flags/constants.d.mts

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/feature-flags
+ * @summary Feature flag constants and metadata keys.
+ */
+export declare const FEATURE_FLAG_ENV_ROOT = "featureFlag";
+export declare const FEATURE_FLAG_ENV_PREFIX = "FEATURE_FLAG";
+export declare const FEATURE_FLAG_MODEL_KEY = "feature-flags:model";
+export declare const FEATURE_FLAG_AUTH_KEY = "feature-flags:auth";
+export declare const FEATURE_FLAG_BLOCK_KEY = "feature-flags:block";
+export declare const FEATURE_FLAG_RENDER_KEY = "feature-flags:render-if";
+export declare const FEATURE_FLAG_HIDE_KEY = "feature-flags:hide-on";

package/lib/types/feature-flags/decorators.d.cts

@@ -0,0 +1,11 @@
+import { FEATURE_FLAG_AUTH_KEY, FEATURE_FLAG_BLOCK_KEY, FEATURE_FLAG_HIDE_KEY, FEATURE_FLAG_MODEL_KEY, FEATURE_FLAG_RENDER_KEY } from "./constants.d.cts";
+import type { FeatureFlagRule } from "./types.d.cts";
+export declare function featureFlags(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function featureAuth(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function blockFeatureOperations(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function renderIfFeature(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function hideOnFeature(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function getFeatureGateMetadata(target: object, key: typeof FEATURE_FLAG_MODEL_KEY | typeof FEATURE_FLAG_AUTH_KEY | typeof FEATURE_FLAG_BLOCK_KEY | typeof FEATURE_FLAG_RENDER_KEY | typeof FEATURE_FLAG_HIDE_KEY, propertyKey?: string | symbol): FeatureFlagRule | undefined;
+export declare function shouldExposeForFeatures(target: object, enabledFeatures: Record<string, unknown>, key: typeof FEATURE_FLAG_MODEL_KEY | typeof FEATURE_FLAG_AUTH_KEY | typeof FEATURE_FLAG_BLOCK_KEY | typeof FEATURE_FLAG_RENDER_KEY | typeof FEATURE_FLAG_HIDE_KEY, propertyKey?: string | symbol): boolean;
+export declare function shouldHideForFeatures(target: object, enabledFeatures: Record<string, unknown>, key: typeof FEATURE_FLAG_MODEL_KEY | typeof FEATURE_FLAG_AUTH_KEY | typeof FEATURE_FLAG_BLOCK_KEY | typeof FEATURE_FLAG_RENDER_KEY | typeof FEATURE_FLAG_HIDE_KEY, propertyKey?: string | symbol): boolean;
+export { FEATURE_FLAG_AUTH_KEY, FEATURE_FLAG_BLOCK_KEY, FEATURE_FLAG_HIDE_KEY, FEATURE_FLAG_MODEL_KEY, FEATURE_FLAG_RENDER_KEY, };

package/lib/types/feature-flags/decorators.d.mts

@@ -0,0 +1,11 @@
+import { FEATURE_FLAG_AUTH_KEY, FEATURE_FLAG_BLOCK_KEY, FEATURE_FLAG_HIDE_KEY, FEATURE_FLAG_MODEL_KEY, FEATURE_FLAG_RENDER_KEY } from "./constants.d.mts";
+import type { FeatureFlagRule } from "./types.d.mts";
+export declare function featureFlags(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function featureAuth(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function blockFeatureOperations(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function renderIfFeature(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function hideOnFeature(...features: string[]): (target: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor) => any;
+export declare function getFeatureGateMetadata(target: object, key: typeof FEATURE_FLAG_MODEL_KEY | typeof FEATURE_FLAG_AUTH_KEY | typeof FEATURE_FLAG_BLOCK_KEY | typeof FEATURE_FLAG_RENDER_KEY | typeof FEATURE_FLAG_HIDE_KEY, propertyKey?: string | symbol): FeatureFlagRule | undefined;
+export declare function shouldExposeForFeatures(target: object, enabledFeatures: Record<string, unknown>, key: typeof FEATURE_FLAG_MODEL_KEY | typeof FEATURE_FLAG_AUTH_KEY | typeof FEATURE_FLAG_BLOCK_KEY | typeof FEATURE_FLAG_RENDER_KEY | typeof FEATURE_FLAG_HIDE_KEY, propertyKey?: string | symbol): boolean;
+export declare function shouldHideForFeatures(target: object, enabledFeatures: Record<string, unknown>, key: typeof FEATURE_FLAG_MODEL_KEY | typeof FEATURE_FLAG_AUTH_KEY | typeof FEATURE_FLAG_BLOCK_KEY | typeof FEATURE_FLAG_RENDER_KEY | typeof FEATURE_FLAG_HIDE_KEY, propertyKey?: string | symbol): boolean;
+export { FEATURE_FLAG_AUTH_KEY, FEATURE_FLAG_BLOCK_KEY, FEATURE_FLAG_HIDE_KEY, FEATURE_FLAG_MODEL_KEY, FEATURE_FLAG_RENDER_KEY, };

package/lib/types/feature-flags/environment.d.cts

@@ -0,0 +1,11 @@
+import { FEATURE_FLAG_ENV_ROOT, FEATURE_FLAG_ENV_PREFIX } from "./constants.d.cts";
+import type { FeatureFlagEnvironmentShape, FeatureFlagRegistry, FeatureFlagValue } from "./types.d.cts";
+export declare const FeatureFlagEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & FeatureFlagEnvironmentShape>;
+export declare function loadFeatureFlagsFromEnvironment(source?: Pick<FeatureFlagEnvironmentShape, "featureFlag">): Promise<FeatureFlagRegistry>;
+export declare function resolveFeatureFlagFromEnvironment(featureName: string, source?: Pick<FeatureFlagEnvironmentShape, "featureFlag">): Promise<FeatureFlagValue | undefined>;
+export declare function hasFeatureFlagInEnvironment(featureName: string, source?: Pick<FeatureFlagEnvironmentShape, "featureFlag">): Promise<boolean>;
+export { FEATURE_FLAG_ENV_PREFIX, FEATURE_FLAG_ENV_ROOT };

package/lib/types/feature-flags/environment.d.mts

@@ -0,0 +1,11 @@
+import { FEATURE_FLAG_ENV_ROOT, FEATURE_FLAG_ENV_PREFIX } from "./constants.d.mts";
+import type { FeatureFlagEnvironmentShape, FeatureFlagRegistry, FeatureFlagValue } from "./types.d.mts";
+export declare const FeatureFlagEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & FeatureFlagEnvironmentShape>;
+export declare function loadFeatureFlagsFromEnvironment(source?: Pick<FeatureFlagEnvironmentShape, "featureFlag">): Promise<FeatureFlagRegistry>;
+export declare function resolveFeatureFlagFromEnvironment(featureName: string, source?: Pick<FeatureFlagEnvironmentShape, "featureFlag">): Promise<FeatureFlagValue | undefined>;
+export declare function hasFeatureFlagInEnvironment(featureName: string, source?: Pick<FeatureFlagEnvironmentShape, "featureFlag">): Promise<boolean>;
+export { FEATURE_FLAG_ENV_PREFIX, FEATURE_FLAG_ENV_ROOT };

package/lib/types/feature-flags/index.d.cts

@@ -0,0 +1,13 @@
+/**
+ * @module integrations/feature-flags
+ * @summary Feature-flag models, services, decorators, and environment helpers.
+ */
+export * from "./constants.d.cts";
+export * from "./types.d.cts";
+export * from "./utils.d.cts";
+export * from "./environment.d.cts";
+export * from "./models/FeatureFlag.model.d.cts";
+export * from "./models/FeatureFlagAccess.model.d.cts";
+export * from "./readers/index.d.cts";
+export * from "./services/FeatureFlag.service.d.cts";
+export * from "./decorators.d.cts";

package/lib/types/feature-flags/index.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @module integrations/feature-flags
+ * @summary Feature-flag models, services, decorators, and environment helpers.
+ */
+export * from "./constants.d.mts";
+export * from "./types.d.mts";
+export * from "./utils.d.mts";
+export * from "./environment.d.mts";
+export * from "./models/FeatureFlag.model.d.mts";
+export * from "./models/FeatureFlagAccess.model.d.mts";
+export * from "./readers/index.d.mts";
+export * from "./services/FeatureFlag.service.d.mts";
+export * from "./decorators.d.mts";

package/lib/types/feature-flags/models/FeatureFlag.model.d.cts

@@ -0,0 +1,16 @@
+import { BaseModel } from "@decaf-ts/core";
+import type { FeatureFlagConfig } from "../types.d.cts";
+export declare class FeatureFlag extends BaseModel {
+    constructor(data?: Partial<FeatureFlag>);
+    id: string;
+    key: string;
+    enabled: boolean;
+    description?: string;
+    scope?: string;
+    metadata?: Record<string, unknown>;
+    config?: FeatureFlagConfig;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/lib/types/feature-flags/models/FeatureFlag.model.d.mts

@@ -0,0 +1,16 @@
+import { BaseModel } from "@decaf-ts/core";
+import type { FeatureFlagConfig } from "../types.d.mts";
+export declare class FeatureFlag extends BaseModel {
+    constructor(data?: Partial<FeatureFlag>);
+    id: string;
+    key: string;
+    enabled: boolean;
+    description?: string;
+    scope?: string;
+    metadata?: Record<string, unknown>;
+    config?: FeatureFlagConfig;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/lib/types/feature-flags/models/FeatureFlagAccess.model.d.cts

@@ -0,0 +1,15 @@
+import { BaseModel } from "@decaf-ts/core";
+import type { FeatureFlagAccessSubjectType } from "../types.d.cts";
+export declare class FeatureFlagAccess extends BaseModel {
+    constructor(data?: Partial<FeatureFlagAccess>);
+    id: string;
+    featureKey: string;
+    subjectType: FeatureFlagAccessSubjectType | string;
+    subjectKey: string;
+    enabled: boolean;
+    metadata?: Record<string, unknown>;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/lib/types/feature-flags/models/FeatureFlagAccess.model.d.mts

@@ -0,0 +1,15 @@
+import { BaseModel } from "@decaf-ts/core";
+import type { FeatureFlagAccessSubjectType } from "../types.d.mts";
+export declare class FeatureFlagAccess extends BaseModel {
+    constructor(data?: Partial<FeatureFlagAccess>);
+    id: string;
+    featureKey: string;
+    subjectType: FeatureFlagAccessSubjectType | string;
+    subjectKey: string;
+    enabled: boolean;
+    metadata?: Record<string, unknown>;
+    createdBy?: string;
+    updatedBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/lib/types/feature-flags/readers/FeatureFlagReader.d.cts

@@ -0,0 +1,10 @@
+import type { FeatureFlagReaderInput, FeatureFlagRegistry, FeatureFlagValue } from "../types.d.cts";
+export declare abstract class FeatureFlagReader {
+    abstract read(input?: FeatureFlagReaderInput): Promise<FeatureFlagRegistry>;
+    readOne(featureName: string, input?: FeatureFlagReaderInput): Promise<FeatureFlagValue | undefined>;
+}
+export declare class EnvironmeFlagReader extends FeatureFlagReader {
+    read(input?: FeatureFlagReaderInput): Promise<FeatureFlagRegistry>;
+}
+export type FeatureFlagReaderConstructor = new () => FeatureFlagReader;
+export type FeatureFlagReaderLike = FeatureFlagReader | FeatureFlagReaderConstructor;

package/lib/types/feature-flags/readers/FeatureFlagReader.d.mts

@@ -0,0 +1,10 @@
+import type { FeatureFlagReaderInput, FeatureFlagRegistry, FeatureFlagValue } from "../types.d.mts";
+export declare abstract class FeatureFlagReader {
+    abstract read(input?: FeatureFlagReaderInput): Promise<FeatureFlagRegistry>;
+    readOne(featureName: string, input?: FeatureFlagReaderInput): Promise<FeatureFlagValue | undefined>;
+}
+export declare class EnvironmeFlagReader extends FeatureFlagReader {
+    read(input?: FeatureFlagReaderInput): Promise<FeatureFlagRegistry>;
+}
+export type FeatureFlagReaderConstructor = new () => FeatureFlagReader;
+export type FeatureFlagReaderLike = FeatureFlagReader | FeatureFlagReaderConstructor;

package/lib/types/feature-flags/readers/index.d.cts

@@ -0,0 +1 @@
+export * from "./FeatureFlagReader.d.cts";

package/lib/types/feature-flags/readers/index.d.mts

@@ -0,0 +1 @@
+export * from "./FeatureFlagReader.d.mts";

package/lib/types/feature-flags/services/FeatureFlag.service.d.cts

@@ -0,0 +1,43 @@
+import { ModelService, Repository } from "@decaf-ts/core";
+import type { Repo } from "@decaf-ts/core";
+import { FeatureFlagAccess } from "../models/FeatureFlagAccess.model.d.cts";
+import { FeatureFlag } from "../models/FeatureFlag.model.d.cts";
+import { FeatureFlagReader, FeatureFlagReaderLike } from "../readers/index.d.cts";
+import type { FeatureFlagAccessInput, FeatureFlagAccessQuery, FeatureFlagAccessSubject, FeatureFlagReaderConfig, FeatureFlagReaderInput, FeatureFlagRegistry } from "../types.d.cts";
+export interface FeatureFlagServiceConfig extends FeatureFlagReaderConfig {
+    reader?: FeatureFlagReaderLike;
+    repository?: Repository<FeatureFlag, any>;
+}
+export declare class FeatureFlagService extends ModelService<FeatureFlag> {
+    private reader;
+    private cachedRegistry;
+    protected accessRepository: Repo<FeatureFlagAccess>;
+    constructor();
+    initialize(...args: any[]): Promise<{
+        config: FeatureFlagServiceConfig;
+        client: FeatureFlagReader;
+    }>;
+    private cloneRegistry;
+    private refreshCachedRegistry;
+    private setCachedFlag;
+    private getAccessRepository;
+    private assertInitialized;
+    private normalizeFeatureAccessInput;
+    private buildAccessCondition;
+    create(model: FeatureFlag, ...args: any[]): Promise<FeatureFlag>;
+    update(model: FeatureFlag, ...args: any[]): Promise<FeatureFlag>;
+    findOneBy(key: keyof FeatureFlag, value: any, ...args: any[]): Promise<FeatureFlag>;
+    readAll(keys: any[], ...args: any[]): Promise<FeatureFlag[]>;
+    listEnabled(...args: any[]): Promise<FeatureFlag[]>;
+    grantFeatureAccess(input: FeatureFlagAccessInput, ...args: any[]): Promise<FeatureFlagAccess>;
+    revokeFeatureAccess(input: FeatureFlagAccessSubject & {
+        featureKey: string;
+    }, ...args: any[]): Promise<FeatureFlagAccess | undefined>;
+    findFeatureAccess(query: FeatureFlagAccessQuery, ...args: any[]): Promise<FeatureFlagAccess>;
+    listFeatureAccess(query: FeatureFlagAccessQuery, ...args: any[]): Promise<FeatureFlagAccess[]>;
+    resolveFeatureFlagsForSubject(subject: FeatureFlagAccessSubject, ...args: any[]): Promise<FeatureFlagRegistry>;
+    isEnabledForSubject(key: string, subject: FeatureFlagAccessSubject, ...args: any[]): Promise<boolean>;
+    isEnabled(key: string): boolean;
+    resolveFeatureFlags(): Promise<FeatureFlagRegistry>;
+    syncFromEnvironment(options?: FeatureFlagReaderInput, ...args: any[]): Promise<FeatureFlag[]>;
+}

package/lib/types/feature-flags/services/FeatureFlag.service.d.mts

@@ -0,0 +1,43 @@
+import { ModelService, Repository } from "@decaf-ts/core";
+import type { Repo } from "@decaf-ts/core";
+import { FeatureFlagAccess } from "../models/FeatureFlagAccess.model.d.mts";
+import { FeatureFlag } from "../models/FeatureFlag.model.d.mts";
+import { FeatureFlagReader, FeatureFlagReaderLike } from "../readers/index.d.mts";
+import type { FeatureFlagAccessInput, FeatureFlagAccessQuery, FeatureFlagAccessSubject, FeatureFlagReaderConfig, FeatureFlagReaderInput, FeatureFlagRegistry } from "../types.d.mts";
+export interface FeatureFlagServiceConfig extends FeatureFlagReaderConfig {
+    reader?: FeatureFlagReaderLike;
+    repository?: Repository<FeatureFlag, any>;
+}
+export declare class FeatureFlagService extends ModelService<FeatureFlag> {
+    private reader;
+    private cachedRegistry;
+    protected accessRepository: Repo<FeatureFlagAccess>;
+    constructor();
+    initialize(...args: any[]): Promise<{
+        config: FeatureFlagServiceConfig;
+        client: FeatureFlagReader;
+    }>;
+    private cloneRegistry;
+    private refreshCachedRegistry;
+    private setCachedFlag;
+    private getAccessRepository;
+    private assertInitialized;
+    private normalizeFeatureAccessInput;
+    private buildAccessCondition;
+    create(model: FeatureFlag, ...args: any[]): Promise<FeatureFlag>;
+    update(model: FeatureFlag, ...args: any[]): Promise<FeatureFlag>;
+    findOneBy(key: keyof FeatureFlag, value: any, ...args: any[]): Promise<FeatureFlag>;
+    readAll(keys: any[], ...args: any[]): Promise<FeatureFlag[]>;
+    listEnabled(...args: any[]): Promise<FeatureFlag[]>;
+    grantFeatureAccess(input: FeatureFlagAccessInput, ...args: any[]): Promise<FeatureFlagAccess>;
+    revokeFeatureAccess(input: FeatureFlagAccessSubject & {
+        featureKey: string;
+    }, ...args: any[]): Promise<FeatureFlagAccess | undefined>;
+    findFeatureAccess(query: FeatureFlagAccessQuery, ...args: any[]): Promise<FeatureFlagAccess>;
+    listFeatureAccess(query: FeatureFlagAccessQuery, ...args: any[]): Promise<FeatureFlagAccess[]>;
+    resolveFeatureFlagsForSubject(subject: FeatureFlagAccessSubject, ...args: any[]): Promise<FeatureFlagRegistry>;
+    isEnabledForSubject(key: string, subject: FeatureFlagAccessSubject, ...args: any[]): Promise<boolean>;
+    isEnabled(key: string): boolean;
+    resolveFeatureFlags(): Promise<FeatureFlagRegistry>;
+    syncFromEnvironment(options?: FeatureFlagReaderInput, ...args: any[]): Promise<FeatureFlag[]>;
+}

package/lib/types/feature-flags/types.d.cts

@@ -0,0 +1,39 @@
+export type FeatureFlagMatchMode = "any" | "all";
+export type FeatureFlagAccessSubjectType = "user" | "account" | "namespace" | "model" | "route" | "ui";
+export interface FeatureFlagRule {
+    features: string[];
+    match?: FeatureFlagMatchMode;
+}
+export interface FeatureFlagConfig {
+    enabled?: boolean;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    scope?: string;
+    targets?: string[];
+    [key: string]: unknown;
+}
+export type FeatureFlagValue = boolean | FeatureFlagConfig;
+export type FeatureFlagRegistry = Record<string, FeatureFlagValue>;
+export interface FeatureFlagEnvironmentShape {
+    featureFlag?: FeatureFlagRegistry;
+}
+export interface FeatureFlagAccessSubject {
+    subjectType: FeatureFlagAccessSubjectType;
+    subjectKey: string;
+}
+export interface FeatureFlagAccessInput extends FeatureFlagAccessSubject {
+    featureKey: string;
+    enabled?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface FeatureFlagAccessQuery extends FeatureFlagAccessSubject {
+    featureKeys?: string[];
+    enabled?: boolean;
+}
+export interface FeatureFlagReaderInput {
+    source?: FeatureFlagEnvironmentShape | unknown;
+    [key: string]: unknown;
+}
+export interface FeatureFlagReaderConfig {
+    readerConfig?: FeatureFlagReaderInput;
+}

package/lib/types/feature-flags/types.d.mts

@@ -0,0 +1,39 @@
+export type FeatureFlagMatchMode = "any" | "all";
+export type FeatureFlagAccessSubjectType = "user" | "account" | "namespace" | "model" | "route" | "ui";
+export interface FeatureFlagRule {
+    features: string[];
+    match?: FeatureFlagMatchMode;
+}
+export interface FeatureFlagConfig {
+    enabled?: boolean;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    scope?: string;
+    targets?: string[];
+    [key: string]: unknown;
+}
+export type FeatureFlagValue = boolean | FeatureFlagConfig;
+export type FeatureFlagRegistry = Record<string, FeatureFlagValue>;
+export interface FeatureFlagEnvironmentShape {
+    featureFlag?: FeatureFlagRegistry;
+}
+export interface FeatureFlagAccessSubject {
+    subjectType: FeatureFlagAccessSubjectType;
+    subjectKey: string;
+}
+export interface FeatureFlagAccessInput extends FeatureFlagAccessSubject {
+    featureKey: string;
+    enabled?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface FeatureFlagAccessQuery extends FeatureFlagAccessSubject {
+    featureKeys?: string[];
+    enabled?: boolean;
+}
+export interface FeatureFlagReaderInput {
+    source?: FeatureFlagEnvironmentShape | unknown;
+    [key: string]: unknown;
+}
+export interface FeatureFlagReaderConfig {
+    readerConfig?: FeatureFlagReaderInput;
+}

package/lib/types/feature-flags/utils.d.cts

@@ -0,0 +1,13 @@
+import { FeatureFlagAccessSubjectType, FeatureFlagMatchMode, FeatureFlagRegistry, FeatureFlagRule, FeatureFlagValue } from "./types.d.cts";
+export declare function normalizeFeatureName(name: string): string;
+export declare function parseRuntimeValue(value: unknown): unknown;
+export declare function normalizeFeatureConfig(value: unknown): FeatureFlagValue | undefined;
+export declare function normalizeFeatureRegistry(value: unknown): FeatureFlagRegistry;
+export declare function isFeatureFlagEnabled(value: FeatureFlagValue | undefined): boolean;
+export declare function isFeatureFlagEnabledByName(registry: FeatureFlagRegistry | undefined, featureName: string): boolean;
+export declare function normalizeFeatureRule(features: string[], match?: FeatureFlagMatchMode): FeatureFlagRule;
+export declare function isFeatureRuleSatisfied(rule: FeatureFlagRule | undefined, registry: FeatureFlagRegistry | undefined): boolean;
+export declare function isFeatureRuleBlocked(rule: FeatureFlagRule | undefined, registry: FeatureFlagRegistry | undefined): boolean;
+export declare function readMetadata<T = unknown>(target: object, key: string): T | undefined;
+export declare function normalizeFeatureSubjectType(subjectType: FeatureFlagAccessSubjectType | string): FeatureFlagAccessSubjectType;
+export declare function normalizeFeatureSubjectKey(subjectKey: string): string;

package/lib/types/feature-flags/utils.d.mts

@@ -0,0 +1,13 @@
+import { FeatureFlagAccessSubjectType, FeatureFlagMatchMode, FeatureFlagRegistry, FeatureFlagRule, FeatureFlagValue } from "./types.d.mts";
+export declare function normalizeFeatureName(name: string): string;
+export declare function parseRuntimeValue(value: unknown): unknown;
+export declare function normalizeFeatureConfig(value: unknown): FeatureFlagValue | undefined;
+export declare function normalizeFeatureRegistry(value: unknown): FeatureFlagRegistry;
+export declare function isFeatureFlagEnabled(value: FeatureFlagValue | undefined): boolean;
+export declare function isFeatureFlagEnabledByName(registry: FeatureFlagRegistry | undefined, featureName: string): boolean;
+export declare function normalizeFeatureRule(features: string[], match?: FeatureFlagMatchMode): FeatureFlagRule;
+export declare function isFeatureRuleSatisfied(rule: FeatureFlagRule | undefined, registry: FeatureFlagRegistry | undefined): boolean;
+export declare function isFeatureRuleBlocked(rule: FeatureFlagRule | undefined, registry: FeatureFlagRegistry | undefined): boolean;
+export declare function readMetadata<T = unknown>(target: object, key: string): T | undefined;
+export declare function normalizeFeatureSubjectType(subjectType: FeatureFlagAccessSubjectType | string): FeatureFlagAccessSubjectType;
+export declare function normalizeFeatureSubjectKey(subjectKey: string): string;

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.cts

@@ -16,8 +16,8 @@ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
  *
  * Evaluates each case's condition in order and routes the input to the
  * first matching case's output port. When no case matches:
- * - If `hasDefault` is `true` (or omitted), routes to the `default` output port.
- * - If `hasDefault` is `false`, returns an empty output (the input is dropped).
+ * - If `hasDefault` is `true`, routes to the `default` output port.
+ * - If `hasDefault` is `false` (the default), throws `GRAPH_SWITCH_NO_MATCH`.
  *
  * Condition evaluation:
  * - `ConditionExpression` — evaluated via {@link ConditionExpressionEvaluator}.

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.mts

@@ -16,8 +16,8 @@ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
  *
  * Evaluates each case's condition in order and routes the input to the
  * first matching case's output port. When no case matches:
- * - If `hasDefault` is `true` (or omitted), routes to the `default` output port.
- * - If `hasDefault` is `false`, returns an empty output (the input is dropped).
+ * - If `hasDefault` is `true`, routes to the `default` output port.
+ * - If `hasDefault` is `false` (the default), throws `GRAPH_SWITCH_NO_MATCH`.
  *
  * Condition evaluation:
  * - `ConditionExpression` — evaluated via {@link ConditionExpressionEvaluator}.

package/lib/types/graph/shared/types.d.cts

@@ -103,9 +103,9 @@ export interface SwitchCase {
 /**
  * Metadata for a Switch node, stored in `metadata.switch`.
  *
- * When `hasDefault` is `false`, the `default` output port is hidden and the
- * executor returns an empty output (no port) when no case matches. When
- * `hasDefault` is `true` (or omitted), the `default` output port is visible
+ * When `hasDefault` is `false` (the default), the `default` output port is
+ * hidden and the executor throws a `GraphExecutionError` when no case
+ * matches. When `hasDefault` is `true`, the `default` output port is visible
  * and receives the input when no case matches (DECAF-34 §6.2).
  */
 export interface SwitchNodeMetadata {

package/lib/types/graph/shared/types.d.mts

@@ -103,9 +103,9 @@ export interface SwitchCase {
 /**
  * Metadata for a Switch node, stored in `metadata.switch`.
  *
- * When `hasDefault` is `false`, the `default` output port is hidden and the
- * executor returns an empty output (no port) when no case matches. When
- * `hasDefault` is `true` (or omitted), the `default` output port is visible
+ * When `hasDefault` is `false` (the default), the `default` output port is
+ * hidden and the executor throws a `GraphExecutionError` when no case
+ * matches. When `hasDefault` is `true`, the `default` output port is visible
  * and receives the input when no case matches (DECAF-34 §6.2).
  */
 export interface SwitchNodeMetadata {

package/lib/types/index.d.cts

@@ -5,7 +5,8 @@
  */
 export * from "./utils.d.cts";
 export * from "./namespaces/index.d.cts";
+export * from "./feature-flags/index.d.cts";
 export declare const VERSION: string;
-export declare const COMMIT = "e2c4409";
-export declare const FULL_VERSION = "0.3.11-e2c4409";
+export declare const COMMIT = "7e1a5ac";
+export declare const FULL_VERSION = "0.4.0-7e1a5ac";
 export declare const PACKAGE_NAME: string;

package/lib/types/index.d.mts

@@ -5,7 +5,8 @@
  */
 export * from "./utils.d.mts";
 export * from "./namespaces/index.d.mts";
+export * from "./feature-flags/index.d.mts";
 export declare const VERSION: string;
-export declare const COMMIT = "e2c4409";
-export declare const FULL_VERSION = "0.3.11-e2c4409";
+export declare const COMMIT = "7e1a5ac";
+export declare const FULL_VERSION = "0.4.0-7e1a5ac";
 export declare const PACKAGE_NAME: string;

package/lib/types/kibana/builders/KibanaIndexBuilder.d.cts

@@ -0,0 +1,67 @@
+/**
+ * @module integrations/kibana/builders/KibanaIndexBuilder
+ * @summary Fluent builder for Kibana index pattern (data view) configurations.
+ * @description Implements the project Builder Pattern (constitution §2):
+ * extends `Model`, uses `@decaf-ts/decorator-validation` decorators, fluent
+ * `setX(): this` methods, and a terminal `build()` that validates via
+ * `hasErrors()` and returns a `KibanaDataViewConfig`.
+ *
+ * Supports three base matching modes:
+ * - `EXACT` — single, fully-qualified index name (no wildcards).
+ * - `PREFIX` — wildcard pattern (e.g. `filebeat-pla-demo-*`).
+ * - `LOGGER_GENERATED` — derives index name segments from a log pattern
+ *   compiled via `compileLogPattern()` and rendered via
+ *   `logParameterRegistry.render()`.
+ *
+ * **Compounding:** Logger-generated segments can be compounded with ANY
+ * base matching mode. When `logPattern` + `logPayload` are provided
+ * alongside EXACT or PREFIX mode, the rendered segments are appended to
+ * the base index name and a trailing `*` is added.
+ */
+import { Model, ModelArg } from "@decaf-ts/decorator-validation";
+import { type LogParameterPayload } from "@decaf-ts/logging";
+import { KibanaDataViewConfig, KibanaIndexMatchMode } from "../types.d.cts";
+export declare class KibanaIndexBuilder extends Model {
+    matchMode: KibanaIndexMatchMode;
+    prefix?: string;
+    exactIndexName?: string;
+    logPattern?: string;
+    logPayload?: Partial<LogParameterPayload>;
+    separator: string;
+    id: string;
+    name: string;
+    timeFieldName?: string;
+    namespaces?: string[];
+    sourceFilters?: Array<{
+        value: string;
+    }>;
+    runtimeFieldMap?: Record<string, unknown>;
+    fieldAttrs?: Record<string, unknown>;
+    allowNoIndex?: boolean;
+    constructor(arg?: ModelArg<KibanaIndexBuilder>);
+    setMatchMode(mode: KibanaIndexMatchMode): this;
+    setPrefix(prefix: string): this;
+    setExactIndexName(name: string): this;
+    setLogPattern(pattern: string): this;
+    setLogPayload(payload: Partial<LogParameterPayload>): this;
+    setSeparator(sep: string): this;
+    setId(id: string): this;
+    setName(name: string): this;
+    setTimeFieldName(field: string): this;
+    setNamespaces(ns: string[]): this;
+    setSourceFilters(filters: Array<{
+        value: string;
+    }>): this;
+    setRuntimeFieldMap(map: Record<string, unknown>): this;
+    setFieldAttrs(attrs: Record<string, unknown>): this;
+    setAllowNoIndex(allow: boolean): this;
+    build(): KibanaDataViewConfig;
+    protected composeTitle(): string;
+    protected composeBaseSegments(): string[];
+    protected composeLoggerGeneratedSegments(): string[];
+    /**
+     * Fill missing LogParameterPayload fields with sensible defaults
+     * so partial payloads can be accepted from the caller.
+     */
+    protected buildFullPayload(partial: Partial<LogParameterPayload>): LogParameterPayload;
+}

package/lib/types/kibana/builders/KibanaIndexBuilder.d.mts

@@ -0,0 +1,67 @@
+/**
+ * @module integrations/kibana/builders/KibanaIndexBuilder
+ * @summary Fluent builder for Kibana index pattern (data view) configurations.
+ * @description Implements the project Builder Pattern (constitution §2):
+ * extends `Model`, uses `@decaf-ts/decorator-validation` decorators, fluent
+ * `setX(): this` methods, and a terminal `build()` that validates via
+ * `hasErrors()` and returns a `KibanaDataViewConfig`.
+ *
+ * Supports three base matching modes:
+ * - `EXACT` — single, fully-qualified index name (no wildcards).
+ * - `PREFIX` — wildcard pattern (e.g. `filebeat-pla-demo-*`).
+ * - `LOGGER_GENERATED` — derives index name segments from a log pattern
+ *   compiled via `compileLogPattern()` and rendered via
+ *   `logParameterRegistry.render()`.
+ *
+ * **Compounding:** Logger-generated segments can be compounded with ANY
+ * base matching mode. When `logPattern` + `logPayload` are provided
+ * alongside EXACT or PREFIX mode, the rendered segments are appended to
+ * the base index name and a trailing `*` is added.
+ */
+import { Model, ModelArg } from "@decaf-ts/decorator-validation";
+import { type LogParameterPayload } from "@decaf-ts/logging";
+import { KibanaDataViewConfig, KibanaIndexMatchMode } from "../types.d.mts";
+export declare class KibanaIndexBuilder extends Model {
+    matchMode: KibanaIndexMatchMode;
+    prefix?: string;
+    exactIndexName?: string;
+    logPattern?: string;
+    logPayload?: Partial<LogParameterPayload>;
+    separator: string;
+    id: string;
+    name: string;
+    timeFieldName?: string;
+    namespaces?: string[];
+    sourceFilters?: Array<{
+        value: string;
+    }>;
+    runtimeFieldMap?: Record<string, unknown>;
+    fieldAttrs?: Record<string, unknown>;
+    allowNoIndex?: boolean;
+    constructor(arg?: ModelArg<KibanaIndexBuilder>);
+    setMatchMode(mode: KibanaIndexMatchMode): this;
+    setPrefix(prefix: string): this;
+    setExactIndexName(name: string): this;
+    setLogPattern(pattern: string): this;
+    setLogPayload(payload: Partial<LogParameterPayload>): this;
+    setSeparator(sep: string): this;
+    setId(id: string): this;
+    setName(name: string): this;
+    setTimeFieldName(field: string): this;
+    setNamespaces(ns: string[]): this;
+    setSourceFilters(filters: Array<{
+        value: string;
+    }>): this;
+    setRuntimeFieldMap(map: Record<string, unknown>): this;
+    setFieldAttrs(attrs: Record<string, unknown>): this;
+    setAllowNoIndex(allow: boolean): this;
+    build(): KibanaDataViewConfig;
+    protected composeTitle(): string;
+    protected composeBaseSegments(): string[];
+    protected composeLoggerGeneratedSegments(): string[];
+    /**
+     * Fill missing LogParameterPayload fields with sensible defaults
+     * so partial payloads can be accepted from the caller.
+     */
+    protected buildFullPayload(partial: Partial<LogParameterPayload>): LogParameterPayload;
+}