@kya-os/consent 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,sBAAsB;AACtB,0CAAwB;AAExB,wBAAwB;AACxB,4CAA0B;AAE1B,0BAA0B;AAC1B,8CAA4B;AAE5B,uBAAuB;AACvB,2CAAyB;AAEzB,qCAAqC;AACrC,+CAA6B;AAE7B,mCAAmC;AACnC,6CAA2B;AAE3B,0BAA0B;AAC1B,8CAA4B"}

package/dist/resolution/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Consent Resolution Utilities
+ *
+ * Functions to resolve partial config into complete render-ready config.
+ * Applies defaults and placeholder substitution.
+ *
+ * @module @kya-os/consent/resolution
+ */
+export * from "./resolve-copy";
+export * from "./resolve-branding";
+export * from "./resolve-config";
+//# sourceMappingURL=index.d.ts.map

package/dist/resolution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolution/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/resolution/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Consent Resolution Utilities
+ *
+ * Functions to resolve partial config into complete render-ready config.
+ * Applies defaults and placeholder substitution.
+ *
+ * @module @kya-os/consent/resolution
+ */
+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 });
+__exportStar(require("./resolve-copy"), exports);
+__exportStar(require("./resolve-branding"), exports);
+__exportStar(require("./resolve-config"), exports);
+//# sourceMappingURL=index.js.map

package/dist/resolution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolution/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,qDAAmC;AACnC,mDAAiC"}

package/dist/resolution/resolve-branding.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Branding Resolution
+ *
+ * Resolves branding config with defaults and generates CSS variables.
+ *
+ * @module @kya-os/consent/resolution/resolve-branding
+ */
+import type { ConsentBranding, ResolvedConsentBranding, ConsentCSSVars } from "../types/branding.types";
+/**
+ * Validate hex color format
+ *
+ * @param color - Color string to validate
+ * @returns True if valid hex color
+ */
+export declare function isValidHexColor(color: string | undefined): color is string;
+/**
+ * Sanitize a color value, returning default if invalid
+ *
+ * @param color - Color to sanitize
+ * @param defaultColor - Default if invalid
+ * @returns Valid hex color
+ */
+export declare function sanitizeColor(color: string | undefined, defaultColor: string): string;
+/**
+ * Validate URL format
+ *
+ * @param url - URL string to validate
+ * @returns True if valid http/https URL
+ */
+export declare function isValidUrl(url: string | undefined): url is string;
+/**
+ * Sanitize a URL value, returning undefined if invalid
+ *
+ * @param url - URL to sanitize
+ * @returns Valid URL or undefined
+ */
+export declare function sanitizeUrl(url: string | undefined): string | undefined;
+/**
+ * Generate CSS variables from branding
+ *
+ * @param branding - Resolved branding config
+ * @returns CSS variable object
+ */
+export declare function generateBrandingCSSVars(branding: {
+    primaryColor: string;
+    secondaryColor: string;
+}): ConsentCSSVars;
+/**
+ * Resolve branding config with defaults and validation
+ *
+ * @param branding - Partial branding config
+ * @returns Fully resolved branding with CSS variables
+ */
+export declare function resolveConsentBranding(branding?: ConsentBranding): ResolvedConsentBranding;
+/**
+ * Check if branding has custom values (non-default)
+ *
+ * @param branding - Branding config
+ * @returns True if any custom values are set
+ */
+export declare function hasCustomBranding(branding?: ConsentBranding): boolean;
+/**
+ * Merge branding configs (later values override earlier)
+ *
+ * @param base - Base branding config
+ * @param override - Override values
+ * @returns Merged branding
+ */
+export declare function mergeBranding(base: ConsentBranding, override?: ConsentBranding): ConsentBranding;
+//# sourceMappingURL=resolve-branding.d.ts.map

package/dist/resolution/resolve-branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-branding.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-branding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIxG;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAG1E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKrF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI,MAAM,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvE;AAoBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,cAAc,CAOjB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,eAAe,GACzB,uBAAuB,CA2BzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAWrE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,eAAe,EACrB,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe,CASjB"}

package/dist/resolution/resolve-branding.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Branding Resolution
+ *
+ * Resolves branding config with defaults and generates CSS variables.
+ *
+ * @module @kya-os/consent/resolution/resolve-branding
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidHexColor = isValidHexColor;
+exports.sanitizeColor = sanitizeColor;
+exports.isValidUrl = isValidUrl;
+exports.sanitizeUrl = sanitizeUrl;
+exports.generateBrandingCSSVars = generateBrandingCSSVars;
+exports.resolveConsentBranding = resolveConsentBranding;
+exports.hasCustomBranding = hasCustomBranding;
+exports.mergeBranding = mergeBranding;
+const defaults_1 = require("../constants/defaults");
+const colors_1 = require("../constants/colors");
+/**
+ * Validate hex color format
+ *
+ * @param color - Color string to validate
+ * @returns True if valid hex color
+ */
+function isValidHexColor(color) {
+    if (!color)
+        return false;
+    return /^#[0-9A-Fa-f]{6}$/.test(color);
+}
+/**
+ * Sanitize a color value, returning default if invalid
+ *
+ * @param color - Color to sanitize
+ * @param defaultColor - Default if invalid
+ * @returns Valid hex color
+ */
+function sanitizeColor(color, defaultColor) {
+    if (isValidHexColor(color)) {
+        return color;
+    }
+    return defaultColor;
+}
+/**
+ * Validate URL format
+ *
+ * @param url - URL string to validate
+ * @returns True if valid http/https URL
+ */
+function isValidUrl(url) {
+    if (!url)
+        return false;
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sanitize a URL value, returning undefined if invalid
+ *
+ * @param url - URL to sanitize
+ * @returns Valid URL or undefined
+ */
+function sanitizeUrl(url) {
+    if (isValidUrl(url)) {
+        return url;
+    }
+    return undefined;
+}
+/**
+ * Convert hex color to RGB string
+ *
+ * @param hex - Hex color string (e.g., '#2563EB')
+ * @returns RGB string (e.g., '37, 99, 235')
+ */
+function hexToRgb(hex) {
+    // Remove # if present
+    const cleanHex = hex.replace(/^#/, '');
+    // Parse hex to RGB
+    const r = parseInt(cleanHex.slice(0, 2), 16);
+    const g = parseInt(cleanHex.slice(2, 4), 16);
+    const b = parseInt(cleanHex.slice(4, 6), 16);
+    return `${r}, ${g}, ${b}`;
+}
+/**
+ * Generate CSS variables from branding
+ *
+ * @param branding - Resolved branding config
+ * @returns CSS variable object
+ */
+function generateBrandingCSSVars(branding) {
+    return {
+        "--consent-primary": branding.primaryColor,
+        "--consent-secondary": branding.secondaryColor,
+        "--consent-primary-rgb": hexToRgb(branding.primaryColor),
+        "--consent-secondary-rgb": hexToRgb(branding.secondaryColor),
+    };
+}
+/**
+ * Resolve branding config with defaults and validation
+ *
+ * @param branding - Partial branding config
+ * @returns Fully resolved branding with CSS variables
+ */
+function resolveConsentBranding(branding) {
+    // Sanitize and resolve colors
+    const primaryColor = sanitizeColor(branding?.primaryColor, colors_1.DEFAULT_COLORS.PRIMARY);
+    const secondaryColor = sanitizeColor(branding?.secondaryColor, colors_1.DEFAULT_COLORS.SECONDARY);
+    // Sanitize URL (only allow valid http/https)
+    const logoUrl = sanitizeUrl(branding?.logoUrl);
+    // Company name - basic sanitization (just trim, escaping happens at render)
+    const companyName = branding?.companyName?.trim() || undefined;
+    // Generate CSS variables
+    const cssVars = generateBrandingCSSVars({ primaryColor, secondaryColor });
+    return {
+        primaryColor,
+        secondaryColor,
+        logoUrl,
+        companyName,
+        cssVars,
+    };
+}
+/**
+ * Check if branding has custom values (non-default)
+ *
+ * @param branding - Branding config
+ * @returns True if any custom values are set
+ */
+function hasCustomBranding(branding) {
+    if (!branding)
+        return false;
+    return ((branding.primaryColor !== undefined &&
+        branding.primaryColor !== defaults_1.DEFAULT_BRANDING.primaryColor) ||
+        (branding.secondaryColor !== undefined &&
+            branding.secondaryColor !== defaults_1.DEFAULT_BRANDING.secondaryColor) ||
+        branding.logoUrl !== undefined ||
+        branding.companyName !== undefined);
+}
+/**
+ * Merge branding configs (later values override earlier)
+ *
+ * @param base - Base branding config
+ * @param override - Override values
+ * @returns Merged branding
+ */
+function mergeBranding(base, override) {
+    if (!override)
+        return base;
+    return {
+        primaryColor: override.primaryColor ?? base.primaryColor,
+        secondaryColor: override.secondaryColor ?? base.secondaryColor,
+        logoUrl: override.logoUrl ?? base.logoUrl,
+        companyName: override.companyName ?? base.companyName,
+    };
+}
+//# sourceMappingURL=resolve-branding.js.map

package/dist/resolution/resolve-branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-branding.js","sourceRoot":"","sources":["../../src/resolution/resolve-branding.ts"],"names":[],"mappings":"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"}

package/dist/resolution/resolve-config.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Config Resolution
+ *
+ * Resolves complete consent config with all defaults applied.
+ *
+ * @module @kya-os/consent/resolution/resolve-config
+ */
+import type { ConsentConfig, ConsentConfigWithMeta, ResolvedConsentConfig, ConsentCustomField, ResolvedUI, ResolvedTerms, ResolvedSuccess } from "../types/config.types";
+import type { AuthMode } from "../types/modes.types";
+/**
+ * Resolve custom fields with validation
+ *
+ * @param fields - Custom fields array
+ * @returns Validated custom fields (max 10)
+ */
+export declare function resolveCustomFields(fields?: ConsentCustomField[]): ConsentCustomField[];
+/**
+ * Resolve expiration days with bounds checking
+ *
+ * @param days - Expiration days from config
+ * @returns Valid expiration days (1-365)
+ */
+export declare function resolveExpirationDays(days?: number): number;
+/**
+ * Determine the effective auth mode from config
+ *
+ * @param config - Consent config
+ * @returns Effective auth mode
+ */
+export declare function determineAuthMode(config?: ConsentConfig): AuthMode;
+/**
+ * Get default consent config
+ *
+ * @returns Default consent config with all fields undefined
+ */
+export declare function getDefaultConsentConfig(): ConsentConfigWithMeta;
+/**
+ * Resolve UI settings with all defaults
+ *
+ * @param ui - Partial UI config
+ * @returns Fully resolved UI settings
+ */
+export declare function resolveUISettings(ui?: ConsentConfig["ui"]): ResolvedUI;
+/**
+ * Resolve terms settings with all defaults
+ *
+ * @param terms - Partial terms config
+ * @returns Fully resolved terms settings
+ */
+export declare function resolveTermsSettings(terms?: ConsentConfig["terms"]): ResolvedTerms;
+/**
+ * Resolve success settings with all defaults
+ *
+ * @param success - Partial success config
+ * @returns Fully resolved success settings
+ */
+export declare function resolveSuccessSettings(success?: ConsentConfig["success"]): ResolvedSuccess;
+/**
+ * Resolve complete consent config with all defaults
+ *
+ * @param config - Partial consent config
+ * @param agentName - Optional agent name for placeholder substitution
+ * @returns Fully resolved config ready for rendering
+ */
+export declare function resolveConsentConfig(config?: ConsentConfig, agentName?: string): ResolvedConsentConfig;
+/**
+ * Merge two config objects, with override taking precedence
+ *
+ * @param base - Base config
+ * @param override - Override config
+ * @returns Merged config
+ */
+export declare function mergeConsentConfigs(base: ConsentConfig, override?: ConsentConfig): ConsentConfig;
+/**
+ * Check if config has any customization
+ *
+ * @param config - Config to check
+ * @returns True if any non-default values are set
+ */
+export declare function hasCustomConfig(config?: ConsentConfig): boolean;
+//# sourceMappingURL=resolve-config.d.ts.map

package/dist/resolution/resolve-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGzK,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMrD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,kBAAkB,EAAE,GAC5B,kBAAkB,EAAE,CAuBtB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,CAoBlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,qBAAqB,CAiB/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,UAAU,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAOlF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,eAAe,CAS1F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,qBAAqB,CAuCvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,aAAa,GACvB,aAAa,CAmBf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAkB/D"}

package/dist/resolution/resolve-config.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Config Resolution
+ *
+ * Resolves complete consent config with all defaults applied.
+ *
+ * @module @kya-os/consent/resolution/resolve-config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCustomFields = resolveCustomFields;
+exports.resolveExpirationDays = resolveExpirationDays;
+exports.determineAuthMode = determineAuthMode;
+exports.getDefaultConsentConfig = getDefaultConsentConfig;
+exports.resolveUISettings = resolveUISettings;
+exports.resolveTermsSettings = resolveTermsSettings;
+exports.resolveSuccessSettings = resolveSuccessSettings;
+exports.resolveConsentConfig = resolveConsentConfig;
+exports.mergeConsentConfigs = mergeConsentConfigs;
+exports.hasCustomConfig = hasCustomConfig;
+const modes_types_1 = require("../types/modes.types");
+const defaults_1 = require("../constants/defaults");
+const resolve_branding_1 = require("./resolve-branding");
+const resolve_copy_1 = require("./resolve-copy");
+/**
+ * Resolve custom fields with validation
+ *
+ * @param fields - Custom fields array
+ * @returns Validated custom fields (max 10)
+ */
+function resolveCustomFields(fields) {
+    if (!fields || fields.length === 0) {
+        return [];
+    }
+    // Limit to 10 fields
+    const limitedFields = fields.slice(0, 10);
+    // Filter valid fields
+    return limitedFields.filter((field) => {
+        // Must have name and label
+        if (!field.name || !field.label)
+            return false;
+        // Name must be alphanumeric with underscores
+        if (!/^[a-zA-Z0-9_]+$/.test(field.name))
+            return false;
+        // Select fields must have options
+        if (field.type === "select" && (!field.options || field.options.length === 0)) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * Resolve expiration days with bounds checking
+ *
+ * @param days - Expiration days from config
+ * @returns Valid expiration days (1-365)
+ */
+function resolveExpirationDays(days) {
+    if (days === undefined || days === null) {
+        return defaults_1.DEFAULT_EXPIRATION_DAYS;
+    }
+    // Clamp to valid range
+    if (days < 1)
+        return 1;
+    if (days > 365)
+        return 365;
+    return Math.floor(days);
+}
+/**
+ * Determine the effective auth mode from config
+ *
+ * @param config - Consent config
+ * @returns Effective auth mode
+ */
+function determineAuthMode(config) {
+    // Check which auth mode is configured
+    if (config?.oauth?.providerId) {
+        return modes_types_1.AUTH_MODES.OAUTH;
+    }
+    if (config?.credentials?.usernameLabel || config?.credentials?.passwordLabel) {
+        return modes_types_1.AUTH_MODES.CREDENTIALS;
+    }
+    if (config?.magicLink?.enabled) {
+        return modes_types_1.AUTH_MODES.MAGIC_LINK;
+    }
+    if (config?.otp?.enabled) {
+        return modes_types_1.AUTH_MODES.OTP;
+    }
+    // Default to consent-only
+    return modes_types_1.AUTH_MODES.CONSENT_ONLY;
+}
+/**
+ * Get default consent config
+ *
+ * @returns Default consent config with all fields undefined
+ */
+function getDefaultConsentConfig() {
+    return {
+        branding: undefined,
+        ui: undefined,
+        terms: undefined,
+        success: undefined,
+        customFields: undefined,
+        credentials: undefined,
+        oauth: undefined,
+        magicLink: undefined,
+        otp: undefined,
+        qrCode: undefined,
+        passkey: undefined,
+        idv: undefined,
+        expirationDays: defaults_1.DEFAULT_EXPIRATION_DAYS,
+        metadata: undefined,
+    };
+}
+/**
+ * Resolve UI settings with all defaults
+ *
+ * @param ui - Partial UI config
+ * @returns Fully resolved UI settings
+ */
+function resolveUISettings(ui) {
+    return {
+        title: ui?.title ?? defaults_1.DEFAULT_UI.title,
+        description: ui?.description ?? defaults_1.DEFAULT_UI.description,
+        expirationText: ui?.expirationText ?? defaults_1.DEFAULT_UI.expirationText,
+        cancelButtonText: ui?.cancelButtonText ?? defaults_1.DEFAULT_UI.cancelButtonText,
+        submitButtonText: ui?.submitButtonText ?? defaults_1.DEFAULT_UI.submitButtonText,
+        permissionsHeader: ui?.permissionsHeader ?? defaults_1.DEFAULT_UI.permissionsHeader,
+        autoClose: ui?.autoClose ?? defaults_1.DEFAULT_UI.autoClose,
+        popupEnabled: ui?.popupEnabled ?? defaults_1.DEFAULT_UI.popupEnabled,
+        theme: ui?.theme ?? defaults_1.DEFAULT_UI.theme,
+    };
+}
+/**
+ * Resolve terms settings with all defaults
+ *
+ * @param terms - Partial terms config
+ * @returns Fully resolved terms settings
+ */
+function resolveTermsSettings(terms) {
+    return {
+        text: terms?.text ?? defaults_1.DEFAULT_TERMS.text,
+        url: terms?.url,
+        version: terms?.version,
+        required: terms?.required ?? defaults_1.DEFAULT_TERMS.required,
+    };
+}
+/**
+ * Resolve success settings with all defaults
+ *
+ * @param success - Partial success config
+ * @returns Fully resolved success settings
+ */
+function resolveSuccessSettings(success) {
+    return {
+        title: success?.title ?? defaults_1.DEFAULT_SUCCESS.title,
+        description: success?.description ?? defaults_1.DEFAULT_SUCCESS.description,
+        showCredential: success?.showCredential ?? defaults_1.DEFAULT_SUCCESS.showCredential,
+        redirectUrl: success?.redirectUrl,
+        redirectDelay: success?.redirectDelay,
+        continueButtonText: success?.continueButtonText ?? defaults_1.DEFAULT_SUCCESS.continueButtonText,
+    };
+}
+/**
+ * Resolve complete consent config with all defaults
+ *
+ * @param config - Partial consent config
+ * @param agentName - Optional agent name for placeholder substitution
+ * @returns Fully resolved config ready for rendering
+ */
+function resolveConsentConfig(config, agentName) {
+    // Resolve branding
+    const branding = (0, resolve_branding_1.resolveConsentBranding)(config?.branding);
+    // Resolve copy/text
+    const copy = (0, resolve_copy_1.resolveConsentCopy)(config, agentName);
+    // Resolve UI, terms, success
+    const ui = resolveUISettings(config?.ui);
+    const terms = resolveTermsSettings(config?.terms);
+    const success = resolveSuccessSettings(config?.success);
+    // Resolve custom fields
+    const customFields = resolveCustomFields(config?.customFields);
+    // Resolve expiration
+    const expirationDays = resolveExpirationDays(config?.expirationDays);
+    // Determine auth mode
+    const authMode = determineAuthMode(config);
+    return {
+        branding,
+        copy,
+        ui,
+        terms,
+        success,
+        customFields,
+        expirationDays,
+        authMode,
+        // Passthrough mode configs
+        credentials: config?.credentials,
+        oauth: config?.oauth,
+        magicLink: config?.magicLink,
+        otp: config?.otp,
+        qrCode: config?.qrCode,
+        passkey: config?.passkey,
+        idv: config?.idv,
+    };
+}
+/**
+ * Merge two config objects, with override taking precedence
+ *
+ * @param base - Base config
+ * @param override - Override config
+ * @returns Merged config
+ */
+function mergeConsentConfigs(base, override) {
+    if (!override)
+        return base;
+    return {
+        branding: override.branding ?? base.branding,
+        ui: { ...base.ui, ...override.ui },
+        terms: { ...base.terms, ...override.terms },
+        success: { ...base.success, ...override.success },
+        customFields: override.customFields ?? base.customFields,
+        credentials: override.credentials ?? base.credentials,
+        oauth: override.oauth ?? base.oauth,
+        magicLink: override.magicLink ?? base.magicLink,
+        otp: override.otp ?? base.otp,
+        qrCode: override.qrCode ?? base.qrCode,
+        passkey: override.passkey ?? base.passkey,
+        idv: override.idv ?? base.idv,
+        expirationDays: override.expirationDays ?? base.expirationDays,
+        metadata: override.metadata ?? base.metadata,
+    };
+}
+/**
+ * Check if config has any customization
+ *
+ * @param config - Config to check
+ * @returns True if any non-default values are set
+ */
+function hasCustomConfig(config) {
+    if (!config)
+        return false;
+    return (config.branding !== undefined ||
+        config.ui !== undefined ||
+        config.terms !== undefined ||
+        config.success !== undefined ||
+        (config.customFields !== undefined && config.customFields.length > 0) ||
+        config.credentials !== undefined ||
+        config.oauth !== undefined ||
+        config.magicLink !== undefined ||
+        config.otp !== undefined ||
+        config.qrCode !== undefined ||
+        config.passkey !== undefined ||
+        config.idv !== undefined ||
+        config.expirationDays !== undefined);
+}
+//# sourceMappingURL=resolve-config.js.map

package/dist/resolution/resolve-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config.js","sourceRoot":"","sources":["../../src/resolution/resolve-config.ts"],"names":[],"mappings":"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"}