@kya-os/consent 0.1.0

package/dist/templates/registry.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Template Registry
+ *
+ * Central registry for consent page templates.
+ * Provides factory methods for creating templates by auth mode.
+ *
+ * @module @kya-os/consent/templates/registry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplateForMode = getTemplateForMode;
+exports.detectAuthMode = detectAuthMode;
+exports.isValidAuthMode = isValidAuthMode;
+exports.getRegisteredModes = getRegisteredModes;
+exports.renderConsentPage = renderConsentPage;
+exports.renderOAuthConsentPage = renderOAuthConsentPage;
+const modes_1 = require("./modes");
+const resolution_1 = require("../resolution");
+const modes_types_1 = require("../types/modes.types");
+/**
+ * Template registry mapping auth modes to their templates.
+ */
+const TEMPLATE_REGISTRY = {
+    [modes_types_1.AUTH_MODES.CONSENT_ONLY]: modes_1.ConsentOnlyTemplate,
+    [modes_types_1.AUTH_MODES.CREDENTIALS]: modes_1.CredentialsTemplate,
+    [modes_types_1.AUTH_MODES.OAUTH]: modes_1.OAuthTemplate,
+    [modes_types_1.AUTH_MODES.MAGIC_LINK]: modes_1.MagicLinkTemplate,
+    [modes_types_1.AUTH_MODES.OTP]: modes_1.OTPTemplate,
+};
+/**
+ * Get a template instance for the specified auth mode.
+ *
+ * @param authMode - The authentication mode
+ * @param config - Extended page config with mode-specific settings
+ * @param remoteConfig - Remote consent configuration from AgentShield
+ * @returns Template instance ready to render
+ */
+function getTemplateForMode(authMode, config, remoteConfig) {
+    const TemplateClass = TEMPLATE_REGISTRY[authMode];
+    if (!TemplateClass) {
+        // Fallback to consent-only for unknown modes
+        console.warn(`Unknown auth mode: ${authMode}, falling back to consent-only`);
+        return getTemplateForMode(modes_types_1.AUTH_MODES.CONSENT_ONLY, config, remoteConfig);
+    }
+    // Resolve config values
+    const mergedRemoteConfig = remoteConfig || (0, resolution_1.getDefaultConsentConfig)();
+    const resolved = (0, resolution_1.resolveConsentConfig)(mergedRemoteConfig, config.tool);
+    // Special handling for credentials template to pass remote credentials config
+    if (authMode === modes_types_1.AUTH_MODES.CREDENTIALS) {
+        return new modes_1.CredentialsTemplate(config, resolved, mergedRemoteConfig.credentials);
+    }
+    return new TemplateClass(config, resolved);
+}
+/**
+ * Determine the auth mode from config.
+ *
+ * @param config - Page config with optional OAuth settings
+ * @returns Detected auth mode
+ */
+function detectAuthMode(config) {
+    // Check for OAuth requirement
+    if (config.oauthRequired || config.oauthUrl) {
+        return modes_types_1.AUTH_MODES.OAUTH;
+    }
+    // Check for provider hint
+    if (config.provider) {
+        const provider = config.provider.toLowerCase();
+        if (provider.includes("oauth") ||
+            ["github", "google", "microsoft", "slack", "auth0"].includes(provider)) {
+            return modes_types_1.AUTH_MODES.OAUTH;
+        }
+    }
+    // Check mode config
+    const modeConfig = config.modeConfig;
+    if (modeConfig) {
+        if (modeConfig.oauth)
+            return modes_types_1.AUTH_MODES.OAUTH;
+        if (modeConfig.credentials)
+            return modes_types_1.AUTH_MODES.CREDENTIALS;
+        if (modeConfig.magicLink?.enabled)
+            return modes_types_1.AUTH_MODES.MAGIC_LINK;
+        if (modeConfig.otp?.enabled)
+            return modes_types_1.AUTH_MODES.OTP;
+    }
+    // Default to consent-only
+    return modes_types_1.AUTH_MODES.CONSENT_ONLY;
+}
+/**
+ * Check if an auth mode is valid.
+ *
+ * @param mode - Mode string to check
+ * @returns True if valid auth mode
+ */
+function isValidAuthMode(mode) {
+    return Object.values(modes_types_1.AUTH_MODES).includes(mode);
+}
+/**
+ * Get all registered auth modes.
+ *
+ * @returns Array of auth mode identifiers
+ */
+function getRegisteredModes() {
+    return Object.keys(TEMPLATE_REGISTRY);
+}
+/**
+ * Render a consent page for the given config.
+ *
+ * This is the main entry point for rendering consent pages.
+ *
+ * @param config - Extended page config
+ * @param remoteConfig - Remote consent configuration from AgentShield
+ * @param authMode - Optional explicit auth mode (auto-detected if not provided)
+ * @returns Rendered HTML string
+ */
+function renderConsentPage(config, remoteConfig, authMode) {
+    const mode = authMode || detectAuthMode(config);
+    const template = getTemplateForMode(mode, config, remoteConfig);
+    return template.render();
+}
+/**
+ * Render an OAuth consent page with pre-configured OAuth URL.
+ *
+ * @param config - Extended page config
+ * @param oauthUrl - OAuth authorization URL
+ * @param remoteConfig - Remote consent configuration from AgentShield
+ * @returns Rendered HTML string
+ */
+function renderOAuthConsentPage(config, oauthUrl, remoteConfig) {
+    const mergedRemoteConfig = remoteConfig || (0, resolution_1.getDefaultConsentConfig)();
+    const resolved = (0, resolution_1.resolveConsentConfig)(mergedRemoteConfig, config.tool);
+    const template = new modes_1.OAuthTemplate(config, resolved);
+    template.setOAuthUrl(oauthUrl);
+    return template.render();
+}
+//# sourceMappingURL=registry.js.map

package/dist/templates/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA8CH,gDA6BC;AAQD,wCA8BC;AAQD,0CAEC;AAOD,gDAEC;AAYD,8CAQC;AAUD,wDAWC;AA1KD,mCAMiB;AACjB,8CAA8E;AAE9E,sDAAkD;AAelD;;GAEG;AACH,MAAM,iBAAiB,GAAmD;IACxE,CAAC,wBAAU,CAAC,YAAY,CAAC,EAAE,2BAAmB;IAC9C,CAAC,wBAAU,CAAC,WAAW,CAAC,EAAE,2BAAmB;IAC7C,CAAC,wBAAU,CAAC,KAAK,CAAC,EAAE,qBAAa;IACjC,CAAC,wBAAU,CAAC,UAAU,CAAC,EAAE,yBAAiB;IAC1C,CAAC,wBAAU,CAAC,GAAG,CAAC,EAAE,mBAAW;CAC9B,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,QAAkB,EAClB,MAAiC,EACjC,YAAoC;IAEpC,MAAM,aAAa,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,6CAA6C;QAC7C,OAAO,CAAC,IAAI,CACV,sBAAsB,QAAQ,gCAAgC,CAC/D,CAAC;QACF,OAAO,kBAAkB,CAAC,wBAAU,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3E,CAAC;IAED,wBAAwB;IACxB,MAAM,kBAAkB,GAAG,YAAY,IAAI,IAAA,oCAAuB,GAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAA,iCAAoB,EAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvE,8EAA8E;IAC9E,IAAI,QAAQ,KAAK,wBAAU,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,IAAI,2BAAmB,CAC5B,MAAM,EACN,QAAQ,EACR,kBAAkB,CAAC,WAAW,CAC/B,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAC5B,MAAiC;IAEjC,8BAA8B;IAC9B,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5C,OAAO,wBAAU,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC/C,IACE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC1B,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACtE,CAAC;YACD,OAAO,wBAAU,CAAC,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK;YAAE,OAAO,wBAAU,CAAC,KAAK,CAAC;QAC9C,IAAI,UAAU,CAAC,WAAW;YAAE,OAAO,wBAAU,CAAC,WAAW,CAAC;QAC1D,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO;YAAE,OAAO,wBAAU,CAAC,UAAU,CAAC;QAChE,IAAI,UAAU,CAAC,GAAG,EAAE,OAAO;YAAE,OAAO,wBAAU,CAAC,GAAG,CAAC;IACrD,CAAC;IAED,0BAA0B;IAC1B,OAAO,wBAAU,CAAC,YAAY,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,wBAAU,CAAC,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAe,CAAC;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAC/B,MAAiC,EACjC,YAAoC,EACpC,QAAmB;IAEnB,MAAM,IAAI,GAAG,QAAQ,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CACpC,MAAiC,EACjC,QAAgB,EAChB,YAAoC;IAEpC,MAAM,kBAAkB,GAAG,YAAY,IAAI,IAAA,oCAAuB,GAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAA,iCAAoB,EAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,IAAI,qBAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/types/api.types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Consent API Types
+ *
+ * Canonical type definitions for consent API request/response payloads.
+ *
+ * @module @kya-os/consent/types/api
+ */
+import type { AuthMode } from "./modes.types";
+/**
+ * OAuth Identity
+ *
+ * Represents a user's OAuth provider account information.
+ * Used to link OAuth accounts to persistent User DIDs.
+ */
+export interface OAuthIdentity {
+    /**
+     * OAuth provider name (e.g., "google", "github", "microsoft")
+     */
+    provider: string;
+    /**
+     * OAuth subject identifier (unique user ID from provider)
+     * @example "123456789" (Google), "github-user-id" (GitHub)
+     */
+    subject: string;
+    /**
+     * User's email address from OAuth provider (optional)
+     */
+    email?: string;
+    /**
+     * User's display name from OAuth provider (optional)
+     */
+    name?: string;
+}
+/**
+ * Consent Approval Request
+ *
+ * Request payload when user approves consent.
+ * Note: Uses snake_case for API compatibility (agent_did, session_id, project_id)
+ */
+export interface ConsentApprovalRequest {
+    /** Tool name */
+    tool: string;
+    /** Approved scopes */
+    scopes: string[];
+    /** Agent DID (snake_case for API compatibility) */
+    agent_did: string;
+    /** Session ID (snake_case for API compatibility) */
+    session_id: string;
+    /** Project ID (snake_case for API compatibility) */
+    project_id: string;
+    /** Authentication mode used */
+    auth_mode: AuthMode;
+    /** Provider type */
+    provider_type: string;
+    /** Whether terms were accepted */
+    termsAccepted: boolean;
+    /** Terms version (if applicable) */
+    termsVersion?: string;
+    /** Custom field values */
+    customFields?: Record<string, string | boolean>;
+    /** OAuth provider identity information (optional) */
+    oauth_identity?: OAuthIdentity | null;
+    /** User DID for persistent identity (optional) */
+    user_did?: string;
+}
+/**
+ * Consent Approval Response
+ *
+ * Response after processing consent approval.
+ */
+export interface ConsentApprovalResponse {
+    /** Whether approval was successful */
+    success: boolean;
+    /** Delegation ID (if successful) */
+    delegation_id?: string;
+    /** Delegation token (if successful) */
+    delegation_token?: string;
+    /** Error message (if failed) */
+    error?: string;
+    /** Error code (if failed) */
+    error_code?: string;
+}
+/**
+ * Consent Config API Response
+ *
+ * Response from the consent config API endpoint.
+ */
+export interface ConsentConfigAPIResponse {
+    /** Whether the request was successful */
+    success: boolean;
+    /** The consent configuration (if successful) */
+    data?: import("./config.types").ConsentConfigWithMeta;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * Credential Authentication Request
+ *
+ * Request payload for username/password authentication.
+ */
+export interface CredentialAuthRequest {
+    /** Username */
+    username: string;
+    /** Password */
+    password: string;
+    /** CSRF token */
+    csrf_token: string;
+    /** Session ID */
+    session_id: string;
+    /** Agent DID */
+    agent_did: string;
+    /** Project ID */
+    project_id: string;
+    /** Provider identifier */
+    provider: string;
+    /** Remember me preference */
+    remember_me?: boolean;
+}
+/**
+ * Credential Authentication Response
+ *
+ * Response from credential authentication.
+ */
+export interface CredentialAuthResponse {
+    /** Whether authentication was successful */
+    success: boolean;
+    /** OAuth identity (if authentication successful) */
+    oauth_identity?: OAuthIdentity;
+    /** Error message (if failed) */
+    error?: string;
+    /** Error code (if failed) */
+    error_code?: string;
+}
+//# sourceMappingURL=api.types.d.ts.map

package/dist/types/api.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.types.d.ts","sourceRoot":"","sources":["../../src/types/api.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,EAAE,QAAQ,CAAC;IAEpB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,aAAa,EAAE,OAAO,CAAC;IAEvB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAEhD,qDAAqD;IACrD,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAEtC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,gBAAgB,EAAE,qBAAqB,CAAC;IAEtD,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IAEjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IAEjB,oDAAoD;IACpD,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/api.types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Consent API Types
+ *
+ * Canonical type definitions for consent API request/response payloads.
+ *
+ * @module @kya-os/consent/types/api
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.types.js.map

package/dist/types/api.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.types.js","sourceRoot":"","sources":["../../src/types/api.types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/types/branding.types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Consent Branding Types
+ *
+ * Canonical type definitions for consent page branding and styling.
+ *
+ * @module @kya-os/consent/types/branding
+ */
+/**
+ * Consent Branding Configuration
+ *
+ * Customization options for consent page appearance.
+ * All fields are optional - defaults are applied during resolution.
+ */
+export interface ConsentBranding {
+    /** Primary brand color (hex format, e.g., '#2563EB') */
+    primaryColor?: string;
+    /** Secondary/accent color (hex format, e.g., '#DBEAFE') */
+    secondaryColor?: string;
+    /** Logo URL for display on consent page */
+    logoUrl?: string;
+    /** Company/application name */
+    companyName?: string;
+}
+/**
+ * CSS Variables for Consent Branding
+ *
+ * Generated CSS custom properties for theming.
+ */
+export interface ConsentCSSVars {
+    "--consent-primary": string;
+    "--consent-secondary": string;
+    "--consent-primary-rgb": string;
+    "--consent-secondary-rgb": string;
+}
+/**
+ * Resolved Consent Branding
+ *
+ * Fully resolved branding with all required fields populated.
+ * Ready for rendering - no undefined values.
+ */
+export interface ResolvedConsentBranding {
+    /** Primary brand color (always has a value) */
+    primaryColor: string;
+    /** Secondary/accent color (always has a value) */
+    secondaryColor: string;
+    /** Logo URL (optional, validated) */
+    logoUrl?: string;
+    /** Company name (optional) */
+    companyName?: string;
+    /** CSS variables for style injection */
+    cssVars: ConsentCSSVars;
+}
+//# sourceMappingURL=branding.types.d.ts.map

package/dist/types/branding.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.types.d.ts","sourceRoot":"","sources":["../../src/types/branding.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IAErB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IAEvB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,OAAO,EAAE,cAAc,CAAC;CACzB"}

package/dist/types/branding.types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Consent Branding Types
+ *
+ * Canonical type definitions for consent page branding and styling.
+ *
+ * @module @kya-os/consent/types/branding
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=branding.types.js.map

package/dist/types/branding.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.types.js","sourceRoot":"","sources":["../../src/types/branding.types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/types/config.types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Consent Configuration Types
+ *
+ * Canonical type definitions for consent configuration.
+ *
+ * @module @kya-os/consent/types/config
+ */
+import type { ConsentBranding, ResolvedConsentBranding } from "./branding.types";
+import type { ConsentUI, ConsentTerms, ConsentSuccess, ResolvedConsentCopy } from "./copy.types";
+export type { ConsentBranding, ResolvedConsentBranding } from "./branding.types";
+export type { ConsentUI, ConsentTerms, ConsentSuccess, ResolvedConsentCopy } from "./copy.types";
+import type { CredentialsConfig, OAuthConfig, MagicLinkConfig, OTPConfig, QRCodeConfig, PasskeyConfig, IDVConfig, AuthMode } from "./modes.types";
+/**
+ * Consent Custom Field Option
+ *
+ * Option for select/dropdown custom fields.
+ */
+export interface ConsentCustomFieldOption {
+    /** Option value */
+    value: string;
+    /** Display label */
+    label: string;
+}
+/**
+ * Consent Custom Field
+ *
+ * Additional fields to collect during consent (e.g., email, preferences).
+ */
+export interface ConsentCustomField {
+    /** Field name (used as form field name, must be valid identifier) */
+    name: string;
+    /** Display label for the field */
+    label: string;
+    /** Field type */
+    type: "text" | "textarea" | "checkbox" | "select" | "email";
+    /** Whether field is required */
+    required: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Options for select fields */
+    options?: ConsentCustomFieldOption[];
+    /** Validation pattern (regex) */
+    pattern?: string;
+}
+/**
+ * Consent Configuration Metadata
+ *
+ * Metadata for tracking config versions and cache invalidation.
+ */
+export interface ConsentMetadata {
+    /** Config version number (incremented on each update) */
+    version?: number;
+    /** Last update timestamp (ISO string) */
+    updatedAt?: string;
+    /** Cache version string for invalidation */
+    cacheVersion?: string;
+}
+/**
+ * Consent Configuration
+ *
+ * Complete consent configuration fetched from AgentShield or defaults.
+ * This is the canonical type used for remote config storage and API responses.
+ */
+export interface ConsentConfig {
+    /** Branding configuration */
+    branding?: ConsentBranding;
+    /** UI/copy configuration */
+    ui?: ConsentUI;
+    /** Terms configuration */
+    terms?: ConsentTerms;
+    /** Success screen configuration */
+    success?: ConsentSuccess;
+    /** Custom fields configuration */
+    customFields?: ConsentCustomField[];
+    /** Credentials mode configuration */
+    credentials?: CredentialsConfig;
+    /** OAuth mode configuration */
+    oauth?: OAuthConfig;
+    /** Magic link mode configuration */
+    magicLink?: MagicLinkConfig;
+    /** OTP mode configuration */
+    otp?: OTPConfig;
+    /** QR code mode configuration */
+    qrCode?: QRCodeConfig;
+    /** Passkey mode configuration */
+    passkey?: PasskeyConfig;
+    /** IDV mode configuration */
+    idv?: IDVConfig;
+    /** Delegation expiration in days */
+    expirationDays?: number;
+    /** Configuration metadata */
+    metadata?: ConsentMetadata;
+}
+/**
+ * Consent Configuration with Metadata
+ *
+ * Extended type including all fields that may come from the remote API.
+ * This is the full type used when fetching config from AgentShield.
+ */
+export interface ConsentConfigWithMeta extends ConsentConfig {
+    /** Configuration metadata (always present in API responses) */
+    metadata?: ConsentMetadata;
+}
+/**
+ * Resolved UI Configuration
+ *
+ * Fully resolved UI settings with all defaults applied.
+ */
+export interface ResolvedUI {
+    /** Page title */
+    title: string;
+    /** Description text */
+    description: string;
+    /** Expiration text prefix */
+    expirationText: string;
+    /** Cancel button text */
+    cancelButtonText: string;
+    /** Submit button text */
+    submitButtonText: string;
+    /** Permissions header text */
+    permissionsHeader: string;
+    /** Whether to auto-close window */
+    autoClose: boolean;
+    /** Whether popup mode is enabled */
+    popupEnabled: boolean;
+    /** Theme preference */
+    theme: "light" | "dark" | "auto";
+}
+/**
+ * Resolved Terms Configuration
+ *
+ * Fully resolved terms settings with all defaults applied.
+ */
+export interface ResolvedTerms {
+    /** Terms text */
+    text: string;
+    /** Terms URL (optional) */
+    url?: string;
+    /** Terms version (optional) */
+    version?: string;
+    /** Whether terms are required */
+    required: boolean;
+}
+/**
+ * Resolved Success Configuration
+ *
+ * Fully resolved success page settings with all defaults applied.
+ */
+export interface ResolvedSuccess {
+    /** Success page title */
+    title: string;
+    /** Success page description */
+    description: string;
+    /** Whether to show credential */
+    showCredential: boolean;
+    /** Redirect URL (optional) */
+    redirectUrl?: string;
+    /** Redirect delay in seconds (optional) */
+    redirectDelay?: number;
+    /** Continue button text */
+    continueButtonText: string;
+}
+/**
+ * Resolved Consent Configuration
+ *
+ * Fully resolved configuration ready for rendering.
+ * All required fields are populated, no undefined values.
+ */
+export interface ResolvedConsentConfig {
+    /** Resolved copy/text content */
+    copy: ResolvedConsentCopy;
+    /** Resolved branding */
+    branding: ResolvedConsentBranding;
+    /** Resolved UI settings */
+    ui: ResolvedUI;
+    /** Resolved terms settings */
+    terms: ResolvedTerms;
+    /** Resolved success settings */
+    success: ResolvedSuccess;
+    /** Custom fields (passed through unchanged) */
+    customFields: ConsentCustomField[];
+    /** Delegation expiration in days (always has a value) */
+    expirationDays: number;
+    /** Effective auth mode */
+    authMode: AuthMode;
+    /** Credentials config (passthrough) */
+    credentials?: CredentialsConfig;
+    /** OAuth config (passthrough) */
+    oauth?: OAuthConfig;
+    /** Magic link config (passthrough) */
+    magicLink?: MagicLinkConfig;
+    /** OTP config (passthrough) */
+    otp?: OTPConfig;
+    /** QR code config (passthrough) */
+    qrCode?: QRCodeConfig;
+    /** Passkey config (passthrough) */
+    passkey?: PasskeyConfig;
+    /** IDV config (passthrough) */
+    idv?: IDVConfig;
+}
+//# sourceMappingURL=config.types.d.ts.map

package/dist/types/config.types.d.ts.map

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

package/dist/types/config.types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Consent Configuration Types
+ *
+ * Canonical type definitions for consent configuration.
+ *
+ * @module @kya-os/consent/types/config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.types.js.map

package/dist/types/config.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.js","sourceRoot":"","sources":["../../src/types/config.types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}