@nubitio/core 0.9.10 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -993,6 +993,59 @@ function CoreProvider({ children, http, httpClient, runtime }) {
993
993
  });
994
994
  }
995
995
  //#endregion
996
+ //#region packages/core/featureFlags/FeatureFlags.tsx
997
+ var StaticFeatureFlagClient = class {
998
+ flags;
999
+ context;
1000
+ constructor(flags = {}, context = {}) {
1001
+ this.flags = flags;
1002
+ this.context = context;
1003
+ }
1004
+ getBooleanValue(key, defaultValue) {
1005
+ const value = this.flags[key];
1006
+ return typeof value === "boolean" ? value : defaultValue;
1007
+ }
1008
+ getStringValue(key, defaultValue) {
1009
+ const value = this.flags[key];
1010
+ return typeof value === "string" ? value : defaultValue;
1011
+ }
1012
+ getNumberValue(key, defaultValue) {
1013
+ const value = this.flags[key];
1014
+ return typeof value === "number" && Number.isFinite(value) ? value : defaultValue;
1015
+ }
1016
+ getObjectValue(key, defaultValue) {
1017
+ const value = this.flags[key];
1018
+ return typeof value === "object" && value !== null && !Array.isArray(value) ? value : defaultValue;
1019
+ }
1020
+ };
1021
+ const FeatureFlagsContext = (0, react.createContext)(new StaticFeatureFlagClient());
1022
+ function FeatureFlagsProvider({ children, client, flags = {}, context = {} }) {
1023
+ const value = (0, react.useMemo)(() => client ?? new StaticFeatureFlagClient(flags, context), [
1024
+ client,
1025
+ context,
1026
+ flags
1027
+ ]);
1028
+ return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FeatureFlagsContext.Provider, {
1029
+ value,
1030
+ children
1031
+ });
1032
+ }
1033
+ function useFeatureFlags() {
1034
+ return (0, react.useContext)(FeatureFlagsContext);
1035
+ }
1036
+ function useBooleanFlag(key, defaultValue = false) {
1037
+ return useFeatureFlags().getBooleanValue(key, defaultValue);
1038
+ }
1039
+ function useStringFlag(key, defaultValue = "") {
1040
+ return useFeatureFlags().getStringValue(key, defaultValue);
1041
+ }
1042
+ function useNumberFlag(key, defaultValue = 0) {
1043
+ return useFeatureFlags().getNumberValue(key, defaultValue);
1044
+ }
1045
+ function useObjectFlag(key, defaultValue) {
1046
+ return useFeatureFlags().getObjectValue(key, defaultValue);
1047
+ }
1048
+ //#endregion
996
1049
  //#region packages/core/mercure/MercureProvider.tsx
997
1050
  /**
998
1051
  * MercureProvider — React context provider for the Mercure hub URL.
@@ -1179,8 +1232,10 @@ exports.CoreProvider = CoreProvider;
1179
1232
  exports.CoreRuntimeProvider = CoreRuntimeProvider;
1180
1233
  exports.DEFAULT_TIMEZONE = DEFAULT_TIMEZONE;
1181
1234
  exports.DateUtils = DateUtils;
1235
+ exports.FeatureFlagsProvider = FeatureFlagsProvider;
1182
1236
  exports.MercureManager = mercureManager;
1183
1237
  exports.MercureProvider = MercureProvider;
1238
+ exports.StaticFeatureFlagClient = StaticFeatureFlagClient;
1184
1239
  exports.buildMercureCollectionTopic = buildMercureCollectionTopic;
1185
1240
  exports.configureCore = configureCore;
1186
1241
  exports.configureCoreDate = configureCoreDate;
@@ -1202,11 +1257,16 @@ exports.getMercureTopicOrigin = getMercureTopicOrigin;
1202
1257
  exports.initCoreI18n = initCoreI18n;
1203
1258
  exports.parseLinkHeader = parseLinkHeader;
1204
1259
  exports.resolveMercureTopicOrigin = resolveMercureTopicOrigin;
1260
+ exports.useBooleanFlag = useBooleanFlag;
1205
1261
  exports.useCoreConfig = useCoreConfig;
1206
1262
  exports.useCoreHttpClient = useCoreHttpClient;
1207
1263
  exports.useCoreRuntime = useCoreRuntime;
1208
1264
  exports.useCoreTranslation = useCoreTranslation;
1209
1265
  exports.useDiscoveredMercureTopicOrigin = useDiscoveredMercureTopicOrigin;
1210
1266
  exports.useEvents = useEvents;
1267
+ exports.useFeatureFlags = useFeatureFlags;
1211
1268
  exports.useMercureHub = useMercureHub;
1212
1269
  exports.useMercureSubscription = useMercureSubscription;
1270
+ exports.useNumberFlag = useNumberFlag;
1271
+ exports.useObjectFlag = useObjectFlag;
1272
+ exports.useStringFlag = useStringFlag;
package/dist/index.d.cts CHANGED
@@ -466,6 +466,47 @@ declare function CoreProvider({
466
466
  runtime
467
467
  }: CoreProviderProps): React.JSX.Element;
468
468
  //#endregion
469
+ //#region packages/core/featureFlags/FeatureFlags.d.ts
470
+ interface FeatureFlagEvaluationContext {
471
+ targetingKey?: string;
472
+ tenantId?: number;
473
+ tenantName?: string;
474
+ attributes?: Readonly<Record<string, boolean | number | string | null>>;
475
+ }
476
+ type FeatureFlagValues = Readonly<Record<string, unknown>>;
477
+ interface FeatureFlagClient {
478
+ getBooleanValue(key: string, defaultValue: boolean): boolean;
479
+ getStringValue(key: string, defaultValue: string): string;
480
+ getNumberValue(key: string, defaultValue: number): number;
481
+ getObjectValue<T extends object>(key: string, defaultValue: T): T;
482
+ }
483
+ declare class StaticFeatureFlagClient implements FeatureFlagClient {
484
+ private readonly flags;
485
+ readonly context: FeatureFlagEvaluationContext;
486
+ constructor(flags?: FeatureFlagValues, context?: FeatureFlagEvaluationContext);
487
+ getBooleanValue(key: string, defaultValue: boolean): boolean;
488
+ getStringValue(key: string, defaultValue: string): string;
489
+ getNumberValue(key: string, defaultValue: number): number;
490
+ getObjectValue<T extends object>(key: string, defaultValue: T): T;
491
+ }
492
+ interface FeatureFlagsProviderProps {
493
+ children: React.ReactNode;
494
+ client?: FeatureFlagClient;
495
+ flags?: FeatureFlagValues;
496
+ context?: FeatureFlagEvaluationContext;
497
+ }
498
+ declare function FeatureFlagsProvider({
499
+ children,
500
+ client,
501
+ flags,
502
+ context
503
+ }: FeatureFlagsProviderProps): React.JSX.Element;
504
+ declare function useFeatureFlags(): FeatureFlagClient;
505
+ declare function useBooleanFlag(key: string, defaultValue?: boolean): boolean;
506
+ declare function useStringFlag(key: string, defaultValue?: string): string;
507
+ declare function useNumberFlag(key: string, defaultValue?: number): number;
508
+ declare function useObjectFlag<T extends object>(key: string, defaultValue: T): T;
509
+ //#endregion
469
510
  //#region packages/core/mercure/MercureProvider.d.ts
470
511
  interface MercureProviderProps {
471
512
  /**
@@ -656,4 +697,4 @@ declare class MercureManager {
656
697
  /** Singleton instance — shared across the entire application. */
657
698
  declare const mercureManager: MercureManager;
658
699
  //#endregion
659
- export { type CoreConfig, CoreConfigProvider, type CoreConfigProviderProps, CoreHttpClient, type CoreHttpClientConfig, type CoreHttpError, type CoreHttpErrorData, CoreHttpProvider, type CoreHttpProviderProps, type CoreHttpResponse, type CoreNotificationType, CoreProvider, type CoreProviderProps, type CoreRequestConfig, type CoreResponseType, type CoreRuntime, CoreRuntimeProvider, type CoreRuntimeProviderProps, type CoreTranslationKeys, DEFAULT_TIMEZONE, type DataGridEventNames, type DataRecord, DateUtils, type DialogEventNames, type EventSubscription, type FormEventNames, type GridData, mercureManager as MercureManager, type MercureManager as MercureManagerType, MercureProvider, type MercureProviderProps, type ScopedFormEventNames, type ToolbarButtonItem, buildMercureCollectionTopic, configureCore, configureCoreDate, coreTranslationsEn, coreTranslationsEs, createCoreHttpClient, createCrudEvents, createScopedEventBus, discoverMercureFromResponse, dispatch, extractMercureHubUrl, extractTopicOriginFromPayload, getCoreApiBaseUrl, getCoreCurrency, getCoreLocale, getCoreTimezone, getDiscoveredMercureTopicOrigin, getMercureTopicOrigin, initCoreI18n, parseLinkHeader, resolveMercureTopicOrigin, useCoreConfig, useCoreHttpClient, useCoreRuntime, useCoreTranslation, useDiscoveredMercureTopicOrigin, useEvents, useMercureHub, useMercureSubscription };
700
+ export { type CoreConfig, CoreConfigProvider, type CoreConfigProviderProps, CoreHttpClient, type CoreHttpClientConfig, type CoreHttpError, type CoreHttpErrorData, CoreHttpProvider, type CoreHttpProviderProps, type CoreHttpResponse, type CoreNotificationType, CoreProvider, type CoreProviderProps, type CoreRequestConfig, type CoreResponseType, type CoreRuntime, CoreRuntimeProvider, type CoreRuntimeProviderProps, type CoreTranslationKeys, DEFAULT_TIMEZONE, type DataGridEventNames, type DataRecord, DateUtils, type DialogEventNames, type EventSubscription, type FeatureFlagClient, type FeatureFlagEvaluationContext, type FeatureFlagValues, FeatureFlagsProvider, type FeatureFlagsProviderProps, type FormEventNames, type GridData, mercureManager as MercureManager, type MercureManager as MercureManagerType, MercureProvider, type MercureProviderProps, type ScopedFormEventNames, StaticFeatureFlagClient, type ToolbarButtonItem, buildMercureCollectionTopic, configureCore, configureCoreDate, coreTranslationsEn, coreTranslationsEs, createCoreHttpClient, createCrudEvents, createScopedEventBus, discoverMercureFromResponse, dispatch, extractMercureHubUrl, extractTopicOriginFromPayload, getCoreApiBaseUrl, getCoreCurrency, getCoreLocale, getCoreTimezone, getDiscoveredMercureTopicOrigin, getMercureTopicOrigin, initCoreI18n, parseLinkHeader, resolveMercureTopicOrigin, useBooleanFlag, useCoreConfig, useCoreHttpClient, useCoreRuntime, useCoreTranslation, useDiscoveredMercureTopicOrigin, useEvents, useFeatureFlags, useMercureHub, useMercureSubscription, useNumberFlag, useObjectFlag, useStringFlag };
package/dist/index.d.mts CHANGED
@@ -466,6 +466,47 @@ declare function CoreProvider({
466
466
  runtime
467
467
  }: CoreProviderProps): React.JSX.Element;
468
468
  //#endregion
469
+ //#region packages/core/featureFlags/FeatureFlags.d.ts
470
+ interface FeatureFlagEvaluationContext {
471
+ targetingKey?: string;
472
+ tenantId?: number;
473
+ tenantName?: string;
474
+ attributes?: Readonly<Record<string, boolean | number | string | null>>;
475
+ }
476
+ type FeatureFlagValues = Readonly<Record<string, unknown>>;
477
+ interface FeatureFlagClient {
478
+ getBooleanValue(key: string, defaultValue: boolean): boolean;
479
+ getStringValue(key: string, defaultValue: string): string;
480
+ getNumberValue(key: string, defaultValue: number): number;
481
+ getObjectValue<T extends object>(key: string, defaultValue: T): T;
482
+ }
483
+ declare class StaticFeatureFlagClient implements FeatureFlagClient {
484
+ private readonly flags;
485
+ readonly context: FeatureFlagEvaluationContext;
486
+ constructor(flags?: FeatureFlagValues, context?: FeatureFlagEvaluationContext);
487
+ getBooleanValue(key: string, defaultValue: boolean): boolean;
488
+ getStringValue(key: string, defaultValue: string): string;
489
+ getNumberValue(key: string, defaultValue: number): number;
490
+ getObjectValue<T extends object>(key: string, defaultValue: T): T;
491
+ }
492
+ interface FeatureFlagsProviderProps {
493
+ children: React.ReactNode;
494
+ client?: FeatureFlagClient;
495
+ flags?: FeatureFlagValues;
496
+ context?: FeatureFlagEvaluationContext;
497
+ }
498
+ declare function FeatureFlagsProvider({
499
+ children,
500
+ client,
501
+ flags,
502
+ context
503
+ }: FeatureFlagsProviderProps): React.JSX.Element;
504
+ declare function useFeatureFlags(): FeatureFlagClient;
505
+ declare function useBooleanFlag(key: string, defaultValue?: boolean): boolean;
506
+ declare function useStringFlag(key: string, defaultValue?: string): string;
507
+ declare function useNumberFlag(key: string, defaultValue?: number): number;
508
+ declare function useObjectFlag<T extends object>(key: string, defaultValue: T): T;
509
+ //#endregion
469
510
  //#region packages/core/mercure/MercureProvider.d.ts
470
511
  interface MercureProviderProps {
471
512
  /**
@@ -656,4 +697,4 @@ declare class MercureManager {
656
697
  /** Singleton instance — shared across the entire application. */
657
698
  declare const mercureManager: MercureManager;
658
699
  //#endregion
659
- export { type CoreConfig, CoreConfigProvider, type CoreConfigProviderProps, CoreHttpClient, type CoreHttpClientConfig, type CoreHttpError, type CoreHttpErrorData, CoreHttpProvider, type CoreHttpProviderProps, type CoreHttpResponse, type CoreNotificationType, CoreProvider, type CoreProviderProps, type CoreRequestConfig, type CoreResponseType, type CoreRuntime, CoreRuntimeProvider, type CoreRuntimeProviderProps, type CoreTranslationKeys, DEFAULT_TIMEZONE, type DataGridEventNames, type DataRecord, DateUtils, type DialogEventNames, type EventSubscription, type FormEventNames, type GridData, mercureManager as MercureManager, type MercureManager as MercureManagerType, MercureProvider, type MercureProviderProps, type ScopedFormEventNames, type ToolbarButtonItem, buildMercureCollectionTopic, configureCore, configureCoreDate, coreTranslationsEn, coreTranslationsEs, createCoreHttpClient, createCrudEvents, createScopedEventBus, discoverMercureFromResponse, dispatch, extractMercureHubUrl, extractTopicOriginFromPayload, getCoreApiBaseUrl, getCoreCurrency, getCoreLocale, getCoreTimezone, getDiscoveredMercureTopicOrigin, getMercureTopicOrigin, initCoreI18n, parseLinkHeader, resolveMercureTopicOrigin, useCoreConfig, useCoreHttpClient, useCoreRuntime, useCoreTranslation, useDiscoveredMercureTopicOrigin, useEvents, useMercureHub, useMercureSubscription };
700
+ export { type CoreConfig, CoreConfigProvider, type CoreConfigProviderProps, CoreHttpClient, type CoreHttpClientConfig, type CoreHttpError, type CoreHttpErrorData, CoreHttpProvider, type CoreHttpProviderProps, type CoreHttpResponse, type CoreNotificationType, CoreProvider, type CoreProviderProps, type CoreRequestConfig, type CoreResponseType, type CoreRuntime, CoreRuntimeProvider, type CoreRuntimeProviderProps, type CoreTranslationKeys, DEFAULT_TIMEZONE, type DataGridEventNames, type DataRecord, DateUtils, type DialogEventNames, type EventSubscription, type FeatureFlagClient, type FeatureFlagEvaluationContext, type FeatureFlagValues, FeatureFlagsProvider, type FeatureFlagsProviderProps, type FormEventNames, type GridData, mercureManager as MercureManager, type MercureManager as MercureManagerType, MercureProvider, type MercureProviderProps, type ScopedFormEventNames, StaticFeatureFlagClient, type ToolbarButtonItem, buildMercureCollectionTopic, configureCore, configureCoreDate, coreTranslationsEn, coreTranslationsEs, createCoreHttpClient, createCrudEvents, createScopedEventBus, discoverMercureFromResponse, dispatch, extractMercureHubUrl, extractTopicOriginFromPayload, getCoreApiBaseUrl, getCoreCurrency, getCoreLocale, getCoreTimezone, getDiscoveredMercureTopicOrigin, getMercureTopicOrigin, initCoreI18n, parseLinkHeader, resolveMercureTopicOrigin, useBooleanFlag, useCoreConfig, useCoreHttpClient, useCoreRuntime, useCoreTranslation, useDiscoveredMercureTopicOrigin, useEvents, useFeatureFlags, useMercureHub, useMercureSubscription, useNumberFlag, useObjectFlag, useStringFlag };
package/dist/index.mjs CHANGED
@@ -968,6 +968,59 @@ function CoreProvider({ children, http, httpClient, runtime }) {
968
968
  });
969
969
  }
970
970
  //#endregion
971
+ //#region packages/core/featureFlags/FeatureFlags.tsx
972
+ var StaticFeatureFlagClient = class {
973
+ flags;
974
+ context;
975
+ constructor(flags = {}, context = {}) {
976
+ this.flags = flags;
977
+ this.context = context;
978
+ }
979
+ getBooleanValue(key, defaultValue) {
980
+ const value = this.flags[key];
981
+ return typeof value === "boolean" ? value : defaultValue;
982
+ }
983
+ getStringValue(key, defaultValue) {
984
+ const value = this.flags[key];
985
+ return typeof value === "string" ? value : defaultValue;
986
+ }
987
+ getNumberValue(key, defaultValue) {
988
+ const value = this.flags[key];
989
+ return typeof value === "number" && Number.isFinite(value) ? value : defaultValue;
990
+ }
991
+ getObjectValue(key, defaultValue) {
992
+ const value = this.flags[key];
993
+ return typeof value === "object" && value !== null && !Array.isArray(value) ? value : defaultValue;
994
+ }
995
+ };
996
+ const FeatureFlagsContext = createContext(new StaticFeatureFlagClient());
997
+ function FeatureFlagsProvider({ children, client, flags = {}, context = {} }) {
998
+ const value = useMemo(() => client ?? new StaticFeatureFlagClient(flags, context), [
999
+ client,
1000
+ context,
1001
+ flags
1002
+ ]);
1003
+ return /* @__PURE__ */ jsx(FeatureFlagsContext.Provider, {
1004
+ value,
1005
+ children
1006
+ });
1007
+ }
1008
+ function useFeatureFlags() {
1009
+ return useContext(FeatureFlagsContext);
1010
+ }
1011
+ function useBooleanFlag(key, defaultValue = false) {
1012
+ return useFeatureFlags().getBooleanValue(key, defaultValue);
1013
+ }
1014
+ function useStringFlag(key, defaultValue = "") {
1015
+ return useFeatureFlags().getStringValue(key, defaultValue);
1016
+ }
1017
+ function useNumberFlag(key, defaultValue = 0) {
1018
+ return useFeatureFlags().getNumberValue(key, defaultValue);
1019
+ }
1020
+ function useObjectFlag(key, defaultValue) {
1021
+ return useFeatureFlags().getObjectValue(key, defaultValue);
1022
+ }
1023
+ //#endregion
971
1024
  //#region packages/core/mercure/MercureProvider.tsx
972
1025
  /**
973
1026
  * MercureProvider — React context provider for the Mercure hub URL.
@@ -1147,4 +1200,4 @@ function useMercureSubscription(apiUrl, onUpdate, enabled = true) {
1147
1200
  ]);
1148
1201
  }
1149
1202
  //#endregion
1150
- export { CoreConfigProvider, CoreHttpClient, CoreHttpProvider, CoreProvider, CoreRuntimeProvider, DEFAULT_TIMEZONE, DateUtils, mercureManager as MercureManager, MercureProvider, buildMercureCollectionTopic, configureCore, configureCoreDate, coreTranslationsEn, coreTranslationsEs, createCoreHttpClient, createCrudEvents, createScopedEventBus, discoverMercureFromResponse, dispatch, extractMercureHubUrl, extractTopicOriginFromPayload, getCoreApiBaseUrl, getCoreCurrency, getCoreLocale, getCoreTimezone, getDiscoveredMercureTopicOrigin, getMercureTopicOrigin, initCoreI18n, parseLinkHeader, resolveMercureTopicOrigin, useCoreConfig, useCoreHttpClient, useCoreRuntime, useCoreTranslation, useDiscoveredMercureTopicOrigin, useEvents, useMercureHub, useMercureSubscription };
1203
+ export { CoreConfigProvider, CoreHttpClient, CoreHttpProvider, CoreProvider, CoreRuntimeProvider, DEFAULT_TIMEZONE, DateUtils, FeatureFlagsProvider, mercureManager as MercureManager, MercureProvider, StaticFeatureFlagClient, buildMercureCollectionTopic, configureCore, configureCoreDate, coreTranslationsEn, coreTranslationsEs, createCoreHttpClient, createCrudEvents, createScopedEventBus, discoverMercureFromResponse, dispatch, extractMercureHubUrl, extractTopicOriginFromPayload, getCoreApiBaseUrl, getCoreCurrency, getCoreLocale, getCoreTimezone, getDiscoveredMercureTopicOrigin, getMercureTopicOrigin, initCoreI18n, parseLinkHeader, resolveMercureTopicOrigin, useBooleanFlag, useCoreConfig, useCoreHttpClient, useCoreRuntime, useCoreTranslation, useDiscoveredMercureTopicOrigin, useEvents, useFeatureFlags, useMercureHub, useMercureSubscription, useNumberFlag, useObjectFlag, useStringFlag };
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@nubitio/core",
3
- "version": "0.9.10",
3
+ "version": "0.10.0",
4
4
  "type": "module",
5
- "description": "Runtime foundation for Nubit: HTTP client, event bus, i18n, Mercure SSE, CoreProvider, and date utilities.",
5
+ "description": "Runtime foundation for Nubit: HTTP, events, i18n, Mercure, feature flags, providers, and date utilities.",
6
6
  "license": "MIT",
7
7
  "keywords": [
8
8
  "react",
@@ -39,6 +39,7 @@
39
39
  "files": [
40
40
  "dist"
41
41
  ],
42
+ "sideEffects": false,
42
43
  "engines": {
43
44
  "node": ">=18.0.0"
44
45
  },