@kya-os/consent 0.1.0

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

@@ -0,0 +1,53 @@
+/**
+ * Copy Resolution
+ *
+ * Resolves UI text and copy with defaults and placeholder substitution.
+ *
+ * @module @kya-os/consent/resolution/resolve-copy
+ */
+import type { ConsentConfig, ConsentUI, ConsentTerms, ConsentSuccess } from "../types/config.types";
+import type { ResolvedConsentCopy } from "../types/copy.types";
+/**
+ * Placeholder for agent name in description text
+ */
+export declare const AGENT_NAME_PLACEHOLDER = "[AI Agent]";
+/**
+ * Resolve UI text with defaults
+ *
+ * @param ui - Partial UI config
+ * @returns Resolved UI with all defaults applied
+ */
+export declare function resolveUI(ui?: ConsentUI): Required<ConsentUI>;
+/**
+ * Resolve terms config with defaults
+ *
+ * @param terms - Partial terms config
+ * @returns Resolved terms with all defaults applied
+ */
+export declare function resolveTerms(terms?: ConsentTerms): Required<ConsentTerms>;
+/**
+ * Resolve success page config with defaults
+ *
+ * @param success - Partial success config
+ * @returns Resolved success with all defaults applied
+ */
+export declare function resolveSuccess(success?: ConsentSuccess): Required<ConsentSuccess>;
+/**
+ * Substitute agent name placeholder in text
+ *
+ * @param text - Text potentially containing [AI Agent] placeholder
+ * @param agentName - Agent name to substitute
+ * @returns Text with placeholder replaced
+ */
+export declare function substituteAgentName(text: string, agentName?: string): string;
+/**
+ * Resolve consent copy from config
+ *
+ * Applies all defaults and performs placeholder substitution.
+ *
+ * @param config - Partial consent config
+ * @param agentName - Optional agent name for placeholder substitution
+ * @returns Fully resolved copy ready for rendering
+ */
+export declare function resolveConsentCopy(config?: ConsentConfig, agentName?: string): ResolvedConsentCopy;
+//# sourceMappingURL=resolve-copy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-copy.d.ts","sourceRoot":"","sources":["../../src/resolution/resolve-copy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAY7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAOzE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,CASjF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AASD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,CA0CrB"}

package/dist/resolution/resolve-copy.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Copy Resolution
+ *
+ * Resolves UI text and copy with defaults and placeholder substitution.
+ *
+ * @module @kya-os/consent/resolution/resolve-copy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_NAME_PLACEHOLDER = void 0;
+exports.resolveUI = resolveUI;
+exports.resolveTerms = resolveTerms;
+exports.resolveSuccess = resolveSuccess;
+exports.substituteAgentName = substituteAgentName;
+exports.resolveConsentCopy = resolveConsentCopy;
+const defaults_1 = require("../constants/defaults");
+/**
+ * Placeholder for agent name in description text
+ */
+exports.AGENT_NAME_PLACEHOLDER = "[AI Agent]";
+/**
+ * Resolve UI text with defaults
+ *
+ * @param ui - Partial UI config
+ * @returns Resolved UI with all defaults applied
+ */
+function resolveUI(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 config with defaults
+ *
+ * @param terms - Partial terms config
+ * @returns Resolved terms with all defaults applied
+ */
+function resolveTerms(terms) {
+    return {
+        text: terms?.text ?? defaults_1.DEFAULT_TERMS.text,
+        url: terms?.url ?? undefined,
+        version: terms?.version ?? undefined,
+        required: terms?.required ?? defaults_1.DEFAULT_TERMS.required,
+    };
+}
+/**
+ * Resolve success page config with defaults
+ *
+ * @param success - Partial success config
+ * @returns Resolved success with all defaults applied
+ */
+function resolveSuccess(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 ?? undefined,
+        redirectDelay: success?.redirectDelay ?? undefined,
+        continueButtonText: success?.continueButtonText ?? defaults_1.DEFAULT_SUCCESS.continueButtonText,
+    };
+}
+/**
+ * Substitute agent name placeholder in text
+ *
+ * @param text - Text potentially containing [AI Agent] placeholder
+ * @param agentName - Agent name to substitute
+ * @returns Text with placeholder replaced
+ */
+function substituteAgentName(text, agentName) {
+    if (!agentName) {
+        return text;
+    }
+    return text.replace(new RegExp(escapeRegExp(exports.AGENT_NAME_PLACEHOLDER), "g"), agentName);
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Resolve consent copy from config
+ *
+ * Applies all defaults and performs placeholder substitution.
+ *
+ * @param config - Partial consent config
+ * @param agentName - Optional agent name for placeholder substitution
+ * @returns Fully resolved copy ready for rendering
+ */
+function resolveConsentCopy(config, agentName) {
+    const ui = config?.ui ?? {};
+    const terms = config?.terms ?? {};
+    const success = config?.success ?? {};
+    // Get raw values with defaults
+    const rawTitle = ui.title ?? defaults_1.DEFAULT_UI.title;
+    const rawDescription = ui.description ?? defaults_1.DEFAULT_UI.description;
+    const rawExpirationText = ui.expirationText ?? defaults_1.DEFAULT_UI.expirationText;
+    const rawCancelButtonText = ui.cancelButtonText ?? defaults_1.DEFAULT_UI.cancelButtonText;
+    const rawSubmitButtonText = ui.submitButtonText ?? defaults_1.DEFAULT_UI.submitButtonText;
+    const rawPermissionsHeader = ui.permissionsHeader ?? defaults_1.DEFAULT_UI.permissionsHeader;
+    const rawTermsText = terms.text ?? defaults_1.DEFAULT_TERMS.text;
+    const rawSuccessTitle = success.title ?? defaults_1.DEFAULT_SUCCESS.title;
+    const rawSuccessDescription = success.description ?? defaults_1.DEFAULT_SUCCESS.description;
+    // Substitute agent name in description
+    const resolvedDescription = substituteAgentName(rawDescription, agentName);
+    const resolvedSuccessDescription = substituteAgentName(rawSuccessDescription, agentName);
+    return {
+        // Raw values (without substitution)
+        title: rawTitle,
+        description: rawDescription,
+        expirationText: rawExpirationText,
+        cancelButtonText: rawCancelButtonText,
+        submitButtonText: rawSubmitButtonText,
+        permissionsHeader: rawPermissionsHeader,
+        termsText: rawTermsText,
+        termsUrl: terms.url,
+        termsRequired: terms.required ?? defaults_1.DEFAULT_TERMS.required,
+        // Resolved values (with substitution)
+        resolvedDescription,
+        // Success page
+        successTitle: rawSuccessTitle,
+        successDescription: rawSuccessDescription,
+        resolvedSuccessDescription,
+        showCredential: success.showCredential ?? defaults_1.DEFAULT_SUCCESS.showCredential,
+        continueButtonText: success.continueButtonText ?? defaults_1.DEFAULT_SUCCESS.continueButtonText,
+    };
+}
+//# sourceMappingURL=resolve-copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-copy.js","sourceRoot":"","sources":["../../src/resolution/resolve-copy.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAiBH,8BAYC;AAQD,oCAOC;AAQD,wCASC;AASD,kDAKC;AAkBD,gDA6CC;AAtID,oDAAmF;AAEnF;;GAEG;AACU,QAAA,sBAAsB,GAAG,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,EAAc;IACtC,OAAO;QACL,KAAK,EAAE,EAAE,EAAE,KAAK,IAAI,qBAAU,CAAC,KAAK;QACpC,WAAW,EAAE,EAAE,EAAE,WAAW,IAAI,qBAAU,CAAC,WAAW;QACtD,cAAc,EAAE,EAAE,EAAE,cAAc,IAAI,qBAAU,CAAC,cAAc;QAC/D,gBAAgB,EAAE,EAAE,EAAE,gBAAgB,IAAI,qBAAU,CAAC,gBAAgB;QACrE,gBAAgB,EAAE,EAAE,EAAE,gBAAgB,IAAI,qBAAU,CAAC,gBAAgB;QACrE,iBAAiB,EAAE,EAAE,EAAE,iBAAiB,IAAI,qBAAU,CAAC,iBAAiB;QACxE,SAAS,EAAE,EAAE,EAAE,SAAS,IAAI,qBAAU,CAAC,SAAS;QAChD,YAAY,EAAE,EAAE,EAAE,YAAY,IAAI,qBAAU,CAAC,YAAY;QACzD,KAAK,EAAE,EAAE,EAAE,KAAK,IAAI,qBAAU,CAAC,KAAK;KACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,KAAoB;IAC/C,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,wBAAa,CAAC,IAAI;QACvC,GAAG,EAAE,KAAK,EAAE,GAAG,IAAK,SAA+B;QACnD,OAAO,EAAE,KAAK,EAAE,OAAO,IAAK,SAA+B;QAC3D,QAAQ,EAAE,KAAK,EAAE,QAAQ,IAAI,wBAAa,CAAC,QAAQ;KACpD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAwB;IACrD,OAAO;QACL,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,0BAAe,CAAC,KAAK;QAC9C,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,0BAAe,CAAC,WAAW;QAChE,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,0BAAe,CAAC,cAAc;QACzE,WAAW,EAAE,OAAO,EAAE,WAAW,IAAK,SAA+B;QACrE,aAAa,EAAE,OAAO,EAAE,aAAa,IAAK,SAA+B;QACzE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,IAAI,0BAAe,CAAC,kBAAkB;KACtF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,IAAY,EAAE,SAAkB;IAClE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,8BAAsB,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAChC,MAAsB,EACtB,SAAkB;IAElB,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;IAEtC,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,IAAI,qBAAU,CAAC,KAAK,CAAC;IAC9C,MAAM,cAAc,GAAG,EAAE,CAAC,WAAW,IAAI,qBAAU,CAAC,WAAW,CAAC;IAChE,MAAM,iBAAiB,GAAG,EAAE,CAAC,cAAc,IAAI,qBAAU,CAAC,cAAc,CAAC;IACzE,MAAM,mBAAmB,GAAG,EAAE,CAAC,gBAAgB,IAAI,qBAAU,CAAC,gBAAgB,CAAC;IAC/E,MAAM,mBAAmB,GAAG,EAAE,CAAC,gBAAgB,IAAI,qBAAU,CAAC,gBAAgB,CAAC;IAC/E,MAAM,oBAAoB,GAAG,EAAE,CAAC,iBAAiB,IAAI,qBAAU,CAAC,iBAAiB,CAAC;IAClF,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,IAAI,wBAAa,CAAC,IAAI,CAAC;IACtD,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,IAAI,0BAAe,CAAC,KAAK,CAAC;IAC/D,MAAM,qBAAqB,GAAG,OAAO,CAAC,WAAW,IAAI,0BAAe,CAAC,WAAW,CAAC;IAEjF,uCAAuC;IACvC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC3E,MAAM,0BAA0B,GAAG,mBAAmB,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;IAEzF,OAAO;QACL,oCAAoC;QACpC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,cAAc;QAC3B,cAAc,EAAE,iBAAiB;QACjC,gBAAgB,EAAE,mBAAmB;QACrC,gBAAgB,EAAE,mBAAmB;QACrC,iBAAiB,EAAE,oBAAoB;QACvC,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,aAAa,EAAE,KAAK,CAAC,QAAQ,IAAI,wBAAa,CAAC,QAAQ;QAEvD,sCAAsC;QACtC,mBAAmB;QAEnB,eAAe;QACf,YAAY,EAAE,eAAe;QAC7B,kBAAkB,EAAE,qBAAqB;QACzC,0BAA0B;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,0BAAe,CAAC,cAAc;QACxE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,0BAAe,CAAC,kBAAkB;KACrF,CAAC;AACJ,CAAC"}