flagmint-js-sdk 2.2.2-rc.0 → 2.2.2

package/dist/sdk/core/config-sync/index.d.ts

@@ -7,8 +7,8 @@ export type { ConfigSyncPayload, DeltaConfigPayload, DeltasCatchUpPayload, FullC
 export { performAslHandshake } from './handshake';
 export type { AslHandshakeSuccess } from './handshake';
 export { evaluateSdkFlag, evaluateAllSdkFlags, coerceType, prepareContextForEvaluator, prepareContextForLocalEval, mapToRecord, } from './evaluateSdkFlag';
-export { PII_VALUE_ENCODING, normalizePiiString, hashPiiValue, isPiiAttribute, piiWireOptionsFromPayload, applyPiiHashToFlatContext, } from './piiHash';
-export type { PiiWireOptions } from './piiHash';
+export { PII_VALUE_ENCODING, normalizePiiString, hashPiiValue, isPiiAttribute, payloadHasExplicitPiiFields, piiWireOptionsFromPayload, resolvePiiWireForDelta, applyPiiHashToFlatContext, } from './piiHash';
+export type { PiiWireOptions, ApplyPiiHashMode } from './piiHash';
 export { evaluateRule, evaluateKillSwitch, evaluateOnVariation, evaluateFlagWithTargetingRules, applyRolloutStrategy, applyPercentageRollout, applyVariantRollout, applyGradualRollout, computeCurrentPercentage, defaultHash, getContextAttribute, } from './flagEvaluator';
 export type { ExpectedFlagType, FlagEvaluationResult, Condition, TargetingRule, Rollout, Variation, Segment, EvaluationDeps, } from './flagEvaluator';
 export { flattenContext, flattenEvaluationContext } from './flattenContext';

package/dist/sdk/core/config-sync/piiHash.d.ts

@@ -8,6 +8,14 @@ export type PiiWireOptions = {
     piiSalt: string;
     piiValueEncoding?: typeof PII_VALUE_ENCODING | string;
 };
+/**
+ * Extra apply options. Prefer plaintext context; only set `alreadyHashed`
+ * when callers intentionally supply wire digests (do not infer from hex shape).
+ */
+export type ApplyPiiHashMode = {
+    /** When true, leave PII string fields unchanged (caller supplied digests). */
+    alreadyHashed?: boolean;
+};
 /**
  * Normalize a string before PII hashing (trim + lowercase).
  * Must match FF-EU `normalizePiiString`.
@@ -31,23 +39,49 @@ export declare function hashPiiValue(value: string, salt: string): string;
  * @param piiAttributes Keys from signed config
  */
 export declare function isPiiAttribute(attribute: string | undefined | null, piiAttributes: readonly string[]): boolean;
+/** Payload fields that carry PII wire metadata. */
+export type PiiWirePayloadFields = {
+    piiAttributes?: unknown;
+    piiSalt?: unknown;
+    piiValueEncoding?: unknown;
+};
+/**
+ * Whether a payload explicitly includes any PII wire field (vs omitting all).
+ * Used so deltas that omit PII metadata keep the previous options, while
+ * deltas that send unusable fields clear them.
+ *
+ * @param payload Signed fullConfig / delta fields
+ */
+export declare function payloadHasExplicitPiiFields(payload: PiiWirePayloadFields | null | undefined): boolean;
 /**
  * Parse PII wire options from a config-sync payload body.
  *
  * @param payload Signed fullConfig / delta fields
  * @returns Options when salt + encoding are usable; otherwise null
  */
-export declare function piiWireOptionsFromPayload(payload: {
-    piiAttributes?: unknown;
-    piiSalt?: unknown;
-    piiValueEncoding?: unknown;
-} | null | undefined): PiiWireOptions | null;
+export declare function piiWireOptionsFromPayload(payload: PiiWirePayloadFields | null | undefined): PiiWireOptions | null;
+/**
+ * Resolve PII wire options for a delta: keep prior when all PII fields are
+ * absent; otherwise parse after merging omitted fields from `previous`.
+ *
+ * FF-EU `piiMetadata` always emits the full triple (or nothing). Merge is
+ * defensive so a salt-only / attrs-only delta cannot wipe the other fields.
+ * Explicit empty salt or unknown encoding still clears to null.
+ *
+ * @param previous Current store options
+ * @param action Delta (or similar) payload fields
+ */
+export declare function resolvePiiWireForDelta(previous: PiiWireOptions | null, action: PiiWirePayloadFields | null | undefined): PiiWireOptions | null;
 /**
  * Hash PII string fields on a flat evaluation context so they match hashed
  * rule values on the wire.
  *
+ * Always hashes plaintext strings (including values that look like 64-char hex).
+ * Pass `{ alreadyHashed: true }` only when the caller already supplied digests.
+ *
  * @param context Flat context map (after prepare / flatten)
  * @param options PII options from the rules store
+ * @param mode Optional apply mode (`alreadyHashed` skips hashing)
  * @returns New context object with PII strings hashed (or the input if no-op)
  */
-export declare function applyPiiHashToFlatContext(context: Record<string, unknown>, options: PiiWireOptions | null | undefined): Record<string, unknown>;
+export declare function applyPiiHashToFlatContext(context: Record<string, unknown>, options: PiiWireOptions | null | undefined, mode?: ApplyPiiHashMode): Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagmint-js-sdk",
-  "version": "2.2.2-rc.0",
+  "version": "2.2.2",
   "description": "Framework-agnostic JavaScript SDK for managing feature flags in Flagmint applications.",
   "author": "Flagmint Team",
   "license": "BSD 3-Clause",