@plyaz/types 1.15.18 → 1.15.20

package/dist/core/featureFlag/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default Configuration Values
+ */
+export declare const FEATURE_FLAG_DEFAULTS: {
+    readonly CACHE_TTL: 300;
+    readonly REFRESH_INTERVAL: 0;
+    readonly POOL_SIZE: 10;
+    readonly TIMEOUT: 30000;
+    readonly TABLE_NAME: "feature_flags";
+};
+/**
+ * Metadata keys used for attaching feature flag information
+ * to route handlers via decorators.
+ */
+export declare const FEATURE_FLAG_METADATA: {
+    FLAG_CHECK: string;
+    RESOLVE_FLAGS: string;
+};

package/dist/core/featureFlag/enums.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Sort direction for database queries
+ */
+export declare enum SORT_DIRECTION {
+    Asc = "asc",
+    Desc = "desc"
+}
+/**
+ * Database table names enumeration
+ */
+export declare enum DATABASE_TABLE {
+    FeatureFlags = "feature_flags",
+    FeatureFlagRules = "feature_flag_rules",
+    FeatureFlagEvaluations = "feature_flag_evaluations",
+    FeatureFlagOverrides = "feature_flag_overrides"
+}
+/**
+ * Database field names for feature flags table
+ */
+export declare enum FEATURE_FLAG_FIELD {
+    Key = "key",
+    Value = "value",
+    IsEnabled = "is_enabled",
+    Environments = "environments",
+    Description = "description",
+    CreatedAt = "created_at",
+    UpdatedAt = "updated_at"
+}
+/**
+ * Database field names for feature flag rules table
+ */
+export declare enum FEATURE_FLAG_RULE_FIELD {
+    Id = "id",
+    FlagKey = "flag_key",
+    Name = "name",
+    Conditions = "conditions",
+    Value = "value",
+    Priority = "priority",
+    IsEnabled = "is_enabled"
+}
+/**
+ * Feature Flag Provider Types
+ */
+export declare enum FEATURE_FLAG_PROVIDERS {
+    MEMORY = "memory",
+    FILE = "file",
+    REDIS = "redis",
+    API = "api",
+    DATABASE = "database"
+}
+/**
+ * Node Environment Types
+ */
+export declare enum NODE_ENVIRONMENTS {
+    DEVELOPMENT = "development",
+    PRODUCTION = "production",
+    STAGING = "staging",
+    TEST = "test"
+}
+/**
+ * Database Field Names
+ */
+export declare enum DATABASE_FIELDS {
+    Key = "key",
+    FlagKey = "flag_key",
+    UserId = "user_id",
+    IsEnabled = "is_enabled",
+    CreatedAt = "created_at",
+    UpdatedAt = "updated_at",
+    ExpiresAt = "expires_at",
+    EvaluatedAt = "evaluated_at"
+}
+/**
+ * System User Constants
+ */
+export declare enum SYSTEM_USERS {
+    SYSTEM = "system"
+}
+/**
+ * Evaluation Reasons
+ */
+export declare enum EVALUATION_REASONS {
+    EVALUATION = "evaluation",
+    DefaultValue = "default_value",
+    RuleMatch = "rule_match",
+    OVERRIDE = "override"
+}
+/**
+ * Feature Flag Types
+ */
+export declare enum FEATURE_FLAG_TYPES {
+    BOOLEAN = "boolean",
+    STRING = "string",
+    NUMBER = "number",
+    OBJECT = "object"
+}

package/dist/core/featureFlag/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Database Repository Types and Interfaces
+ *
+ * @description Comprehensive type definitions for feature flag database operations,
+ * including table schemas, query interfaces, and data transformation types.
+ * These types ensure type safety across the entire database layer.
+ */
+import type { FEATURES } from '@plyaz/config';
+import type { FeatureFlagCondition, FeatureFlagConfig, FeatureFlagValue } from '../../features';
+/**
+ * Raw database row interface for feature flags table
+ */
+export interface DatabaseFeatureFlagRow {
+    key: string;
+    value: FeatureFlagValue;
+    isEnabled?: boolean;
+    is_enabled?: boolean;
+    environments?: string[];
+    description?: string;
+    createdAt?: Date;
+    created_at?: string;
+    updatedAt?: Date;
+    updated_at?: string;
+}
+/**
+ * Raw database row interface for feature flag rules
+ */
+export interface DatabaseFeatureFlagRuleRow {
+    id: string;
+    flagKey: string;
+    flag_key?: string;
+    name: string;
+    conditions: FeatureFlagCondition[];
+    value: FeatureFlagValue;
+    priority: number;
+    isEnabled: boolean;
+    is_enabled?: boolean;
+}
+/**
+ * Database override row interface
+ */
+export interface DatabaseOverrideRow {
+    id: string;
+    flag_key: string;
+    user_id: string;
+    value: FeatureFlagValue;
+    expires_at?: string;
+    created_at: string;
+}
+/**
+ * Database evaluation log row interface
+ */
+export interface DatabaseEvaluationRow {
+    id: string;
+    flag_key: string;
+    user_id?: string;
+    context?: Record<string, string | number | boolean>;
+    result: FeatureFlagValue;
+    reason: string;
+    evaluated_at: string;
+}
+/**
+ * Environment filter interface
+ */
+export interface EnvironmentFilterRow {
+    environments?: string[];
+}
+/**
+ * Validation result interface
+ */
+export interface FeatureFlagValidationResult {
+    isValid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation error interface
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Validation warning interface
+ */
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Database configuration interface
+ */
+export interface FeatureFlagDatabaseConfig {
+    connectionString: string;
+    tableName: string;
+    poolSize?: number;
+    timeout?: number;
+}
+/**
+ * Environment-specific feature flag configuration
+ */
+export interface FeatureFlagEnvironmentConfig extends Omit<FeatureFlagConfig<FeatureFlagKey>, 'databaseConfig'> {
+    databaseConfig?: FeatureFlagDatabaseConfig;
+}
+/**
+ * Union type of all available feature flag keys.
+ * Automatically derived from the FEATURES constant for type safety.
+ */
+export type FeatureFlagKey = keyof typeof FEATURES;
+export type FeatureFlags = typeof FEATURES extends Record<FeatureFlagKey, FeatureFlagValue> ? typeof FEATURES : never;

package/dist/core/index.d.ts

@@ -7,3 +7,6 @@
 export type { ApiEnvironmentConfig, ApiProviderProps } from './services';
 export * from './tables/enum';
 export type * from './auth/types';
+export type * from './featureFlag/types';
+export * from './featureFlag/enums';
+export * from './featureFlag/constants';

package/dist/index.cjs

@@ -63,6 +63,99 @@ var TABLES = /* @__PURE__ */ ((TABLES2) => {
   return TABLES2;
 })(TABLES || {});
 
+// src/core/featureFlag/enums.ts
+var SORT_DIRECTION = /* @__PURE__ */ ((SORT_DIRECTION2) => {
+  SORT_DIRECTION2["Asc"] = "asc";
+  SORT_DIRECTION2["Desc"] = "desc";
+  return SORT_DIRECTION2;
+})(SORT_DIRECTION || {});
+var DATABASE_TABLE = /* @__PURE__ */ ((DATABASE_TABLE2) => {
+  DATABASE_TABLE2["FeatureFlags"] = "feature_flags";
+  DATABASE_TABLE2["FeatureFlagRules"] = "feature_flag_rules";
+  DATABASE_TABLE2["FeatureFlagEvaluations"] = "feature_flag_evaluations";
+  DATABASE_TABLE2["FeatureFlagOverrides"] = "feature_flag_overrides";
+  return DATABASE_TABLE2;
+})(DATABASE_TABLE || {});
+var FEATURE_FLAG_FIELD = /* @__PURE__ */ ((FEATURE_FLAG_FIELD2) => {
+  FEATURE_FLAG_FIELD2["Key"] = "key";
+  FEATURE_FLAG_FIELD2["Value"] = "value";
+  FEATURE_FLAG_FIELD2["IsEnabled"] = "is_enabled";
+  FEATURE_FLAG_FIELD2["Environments"] = "environments";
+  FEATURE_FLAG_FIELD2["Description"] = "description";
+  FEATURE_FLAG_FIELD2["CreatedAt"] = "created_at";
+  FEATURE_FLAG_FIELD2["UpdatedAt"] = "updated_at";
+  return FEATURE_FLAG_FIELD2;
+})(FEATURE_FLAG_FIELD || {});
+var FEATURE_FLAG_RULE_FIELD = /* @__PURE__ */ ((FEATURE_FLAG_RULE_FIELD2) => {
+  FEATURE_FLAG_RULE_FIELD2["Id"] = "id";
+  FEATURE_FLAG_RULE_FIELD2["FlagKey"] = "flag_key";
+  FEATURE_FLAG_RULE_FIELD2["Name"] = "name";
+  FEATURE_FLAG_RULE_FIELD2["Conditions"] = "conditions";
+  FEATURE_FLAG_RULE_FIELD2["Value"] = "value";
+  FEATURE_FLAG_RULE_FIELD2["Priority"] = "priority";
+  FEATURE_FLAG_RULE_FIELD2["IsEnabled"] = "is_enabled";
+  return FEATURE_FLAG_RULE_FIELD2;
+})(FEATURE_FLAG_RULE_FIELD || {});
+var FEATURE_FLAG_PROVIDERS = /* @__PURE__ */ ((FEATURE_FLAG_PROVIDERS2) => {
+  FEATURE_FLAG_PROVIDERS2["MEMORY"] = "memory";
+  FEATURE_FLAG_PROVIDERS2["FILE"] = "file";
+  FEATURE_FLAG_PROVIDERS2["REDIS"] = "redis";
+  FEATURE_FLAG_PROVIDERS2["API"] = "api";
+  FEATURE_FLAG_PROVIDERS2["DATABASE"] = "database";
+  return FEATURE_FLAG_PROVIDERS2;
+})(FEATURE_FLAG_PROVIDERS || {});
+var NODE_ENVIRONMENTS = /* @__PURE__ */ ((NODE_ENVIRONMENTS2) => {
+  NODE_ENVIRONMENTS2["DEVELOPMENT"] = "development";
+  NODE_ENVIRONMENTS2["PRODUCTION"] = "production";
+  NODE_ENVIRONMENTS2["STAGING"] = "staging";
+  NODE_ENVIRONMENTS2["TEST"] = "test";
+  return NODE_ENVIRONMENTS2;
+})(NODE_ENVIRONMENTS || {});
+var DATABASE_FIELDS = /* @__PURE__ */ ((DATABASE_FIELDS2) => {
+  DATABASE_FIELDS2["Key"] = "key";
+  DATABASE_FIELDS2["FlagKey"] = "flag_key";
+  DATABASE_FIELDS2["UserId"] = "user_id";
+  DATABASE_FIELDS2["IsEnabled"] = "is_enabled";
+  DATABASE_FIELDS2["CreatedAt"] = "created_at";
+  DATABASE_FIELDS2["UpdatedAt"] = "updated_at";
+  DATABASE_FIELDS2["ExpiresAt"] = "expires_at";
+  DATABASE_FIELDS2["EvaluatedAt"] = "evaluated_at";
+  return DATABASE_FIELDS2;
+})(DATABASE_FIELDS || {});
+var SYSTEM_USERS = /* @__PURE__ */ ((SYSTEM_USERS2) => {
+  SYSTEM_USERS2["SYSTEM"] = "system";
+  return SYSTEM_USERS2;
+})(SYSTEM_USERS || {});
+var EVALUATION_REASONS = /* @__PURE__ */ ((EVALUATION_REASONS2) => {
+  EVALUATION_REASONS2["EVALUATION"] = "evaluation";
+  EVALUATION_REASONS2["DefaultValue"] = "default_value";
+  EVALUATION_REASONS2["RuleMatch"] = "rule_match";
+  EVALUATION_REASONS2["OVERRIDE"] = "override";
+  return EVALUATION_REASONS2;
+})(EVALUATION_REASONS || {});
+var FEATURE_FLAG_TYPES = /* @__PURE__ */ ((FEATURE_FLAG_TYPES2) => {
+  FEATURE_FLAG_TYPES2["BOOLEAN"] = "boolean";
+  FEATURE_FLAG_TYPES2["STRING"] = "string";
+  FEATURE_FLAG_TYPES2["NUMBER"] = "number";
+  FEATURE_FLAG_TYPES2["OBJECT"] = "object";
+  return FEATURE_FLAG_TYPES2;
+})(FEATURE_FLAG_TYPES || {});
+
+// src/core/featureFlag/constants.ts
+var FEATURE_FLAG_DEFAULTS = {
+  CACHE_TTL: 300,
+  REFRESH_INTERVAL: 0,
+  POOL_SIZE: 10,
+  TIMEOUT: 3e4,
+  TABLE_NAME: "feature_flags"
+};
+var FEATURE_FLAG_METADATA = {
+  FLAG_CHECK: "plyaz:feature_flag_check",
+  // Single feature flag check
+  RESOLVE_FLAGS: "plyaz:resolve_feature_flags"
+  // Multiple flags resolved at once
+};
+
 // src/errors/enums.ts
 var ERROR_TYPE = {
   /** A general validation error (e.g., form or input errors). */
@@ -5295,6 +5388,8 @@ exports.ContactUsFormSchema = ContactUsFormSchema;
 exports.CorrelationIdSchema = CorrelationIdSchema;
 exports.DATABASE_ERROR_CODES = DATABASE_ERROR_CODES;
 exports.DATABASE_EVENT_TYPE = DATABASE_EVENT_TYPE;
+exports.DATABASE_FIELDS = DATABASE_FIELDS;
+exports.DATABASE_TABLE = DATABASE_TABLE;
 exports.DATA_SAVER_PRESETS = DATA_SAVER_PRESETS;
 exports.DB_POOL_EVENTS = DB_POOL_EVENTS;
 exports.DEBUGGER_CONFIG_SOURCES = DEBUGGER_CONFIG_SOURCES;
@@ -5311,6 +5406,7 @@ exports.ERROR_EXCEPTIONS_NAMESPACES = ERROR_EXCEPTIONS_NAMESPACES;
 exports.ERROR_FIELDS = COMMON_FIELDS;
 exports.ERROR_SEVERITY = ERROR_SEVERITY;
 exports.ERROR_TYPE = ERROR_TYPE;
+exports.EVALUATION_REASONS = EVALUATION_REASONS;
 exports.EVENTS_CONFIG_SOURCES = EVENTS_CONFIG_SOURCES;
 exports.EVENT_CONSTANTS = EVENT_CONSTANTS;
 exports.EVENT_NAMESPACES = EVENT_NAMESPACES;
@@ -5325,6 +5421,12 @@ exports.EVENT_TYPE = EVENT_TYPE;
 exports.EmailSchema = EmailSchema;
 exports.FACTORY_OPERATIONS = FACTORY_OPERATIONS;
 exports.FAIL_OVER_STRATEGY = FAIL_OVER_STRATEGY;
+exports.FEATURE_FLAG_DEFAULTS = FEATURE_FLAG_DEFAULTS;
+exports.FEATURE_FLAG_FIELD = FEATURE_FLAG_FIELD;
+exports.FEATURE_FLAG_METADATA = FEATURE_FLAG_METADATA;
+exports.FEATURE_FLAG_PROVIDERS = FEATURE_FLAG_PROVIDERS;
+exports.FEATURE_FLAG_RULE_FIELD = FEATURE_FLAG_RULE_FIELD;
+exports.FEATURE_FLAG_TYPES = FEATURE_FLAG_TYPES;
 exports.FILE_EXTENSIONS = FILE_EXTENSIONS;
 exports.HANDLER_SCOPES = HANDLER_SCOPES;
 exports.HEADER_EVENTS = HEADER_EVENTS;
@@ -5353,6 +5455,7 @@ exports.MIME_TYPES = MIME_TYPES;
 exports.NETWORK_CONFIDENCE_LEVELS = NETWORK_CONFIDENCE_LEVELS;
 exports.NETWORK_EVENTS = NETWORK_EVENTS;
 exports.NETWORK_QUALITY = NETWORK_QUALITY;
+exports.NODE_ENVIRONMENTS = NODE_ENVIRONMENTS;
 exports.NOTIFICATION_CATEGORIES = NOTIFICATION_CATEGORIES;
 exports.NOTIFICATION_CHANNELS = NOTIFICATION_CHANNELS;
 exports.NOTIFICATION_ERROR_CODES = NOTIFICATION_ERROR_CODES;
@@ -5392,8 +5495,10 @@ exports.ROUTING_STRATEGY = ROUTING_STRATEGY;
 exports.RTT_THRESHOLDS = RTT_THRESHOLDS;
 exports.SECURITY_THREAT_TYPE = SECURITY_THREAT_TYPE;
 exports.SIGNATURE_METHOD = SIGNATURE_METHOD;
+exports.SORT_DIRECTION = SORT_DIRECTION;
 exports.SPEED_THRESHOLDS = SPEED_THRESHOLDS;
 exports.STORAGE_TYPES = COMMON_STORAGE_TYPES;
+exports.SYSTEM_USERS = SYSTEM_USERS;
 exports.SendGridEventSchema = SendGridEventSchema;
 exports.SendGridWebhookSchema = SendGridWebhookSchema;
 exports.SignupFormSchema = SignupFormSchema;