@getuserfeedback/adapters 0.2.1 → 0.4.0

package/README.md

@@ -0,0 +1,135 @@
+# `@getuserfeedback/adapters`
+
+`@getuserfeedback/adapters` publishes external-system translation layers built on top of the public widget protocol.
+
+## GTM
+
+The `@getuserfeedback/adapters/gtm` entrypoint is the authoritative source for Google Tag Manager template generation. It owns:
+
+- GTM consent mapping logic
+- GTM theme normalization logic
+- GTM template parameter generation
+- GTM runtime source generation
+- GTM permission generation
+- GTM template defaults, help text, and option labels
+- the canonical loader script base URL pattern
+
+### Public exports
+
+Core mappings:
+
+- `GTM_CONSENT_TYPES`
+- `ESSENTIAL_GTM_SCOPES`
+- `DEFAULT_GTM_SCOPE_MAPPINGS`
+- `GTM_TEMPLATE_SCOPE_OPTIONS`
+- `GTM_TEMPLATE_MAPPING_OPTIONS`
+- `isGtmConsentType(value)`
+- `isHostConfigurableGtmScope(scope)`
+- `normalizeGtmThemeInput(input)`
+- `resolveDefaultConsentFromGtm(input)`
+- `buildInitOptionsFromGtmTemplate(input)`
+
+Types:
+
+- `GtmConsentType`
+- `GtmConsentValue`
+- `GtmConsentState`
+- `GtmScopeMapping`
+- `GtmAnalyticsMeasurementMode`
+- `GtmTemplateInput`
+- `GtmTemplateScopeOption`
+- `GtmTemplateMappingOption`
+
+Template generation:
+
+- `DEFAULT_GTM_LOADER_SCRIPT_BASE_URL`
+- `buildGtmTemplateParameters(options?)`
+- `buildGtmRuntimeSource(options?)`
+- `buildGtmPermissions(options?)`
+- `buildGtmTemplateInfo(options?)`
+- `buildGtmTemplateParts(options?)`
+- `buildGtmTemplateArtifact(options?)`
+
+### Essential scope policy
+
+`functionality.storage` and `security.storage` are essential baseline scopes.
+
+- They remain accepted by the protocol for backward compatibility.
+- They are not host-configurable in GTM-generated consent UI.
+- They are not emitted in GTM-generated host-overridable default consent output.
+- Generated help text states that they are fixed by the loader.
+
+### Analytics measurement policy
+
+Automatic GTM consent mode exposes an explicit analytics measurement policy:
+
+- `inherit-analytics-storage`
+- `granted`
+- `denied`
+
+Manual GTM consent mode does not apply hidden analytics measurement behavior. It only uses the generated host-configurable scope mappings.
+
+### Theme behavior
+
+Generated GTM theme support accepts:
+
+- fixed `light`
+- fixed `dark`
+- fixed `system`
+- host-sync via protocol auto-detect attributes
+- GTM variable-driven values
+- comma-separated auto-detect attribute lists
+
+The adapter normalizes all theme inputs into protocol-valid `colorScheme`.
+
+### Generate a GTM template artifact
+
+```ts
+import { buildGtmTemplateArtifact } from "@getuserfeedback/adapters/gtm";
+
+const artifact = buildGtmTemplateArtifact({
+	loaderScriptBaseUrl: "https://cdn.getuserfeedback.com/widget/loader/v1",
+});
+
+artifact.info;
+artifact.parameters;
+artifact.runtimeSource;
+artifact.permissions;
+```
+
+The returned object is suitable for rendering into GTM `___INFO___`, `___TEMPLATE_PARAMETERS___`, `___SANDBOXED_JS_FOR_WEB_TEMPLATE___`, and `___WEB_PERMISSIONS___` sections.
+
+### What the GTM repo should still own
+
+After importing the published package, the GTM repo should only own:
+
+- GTM Gallery wrapper file assembly
+- brand thumbnail and base64 image assets
+- `metadata.yaml`
+- publishing and release workflow
+
+It should not rebuild parameters, runtime source, permissions, or GTM-specific init payload translation.
+
+### Customizing the loader base URL
+
+Pass `loaderScriptBaseUrl` to:
+
+- `buildGtmRuntimeSource`
+- `buildGtmPermissions`
+- `buildGtmTemplateParts`
+- `buildGtmTemplateArtifact`
+
+The same base URL is used to derive the runtime loader URL and the `inject_script` permission pattern.
+
+### Versioning expectations
+
+Any change that affects generated GTM output is a public package change and should be versioned accordingly. This includes:
+
+- parameter shape or defaults
+- runtime behavior
+- permission generation
+- default mappings
+- essential-scope exposure
+- analytics measurement behavior
+
+Release notes should call out template-affecting changes explicitly.

package/dist/gtm/core.d.ts

@@ -0,0 +1,58 @@
+import { type InitOptions, type Scope } from "@getuserfeedback/protocol";
+export declare const GTM_CONSENT_TYPES: readonly [
+    "functionality_storage",
+    "security_storage",
+    "analytics_storage",
+    "personalization_storage",
+    "ad_storage",
+    "ad_user_data",
+    "ad_personalization"
+];
+export type GtmConsentType = (typeof GTM_CONSENT_TYPES)[number];
+export type GtmConsentValue = "granted" | "denied";
+export type GtmAnalyticsMeasurementMode = "inherit-analytics-storage" | "granted" | "denied";
+export type GtmScopeMapping = {
+    scope: Scope;
+    consentType: GtmConsentType;
+};
+export type GtmConsentState = Partial<Record<GtmConsentType, GtmConsentValue>>;
+export type GtmTemplateInput = {
+    apiKey: string;
+    consentState?: GtmConsentState;
+    scopeMappings?: ReadonlyArray<GtmScopeMapping>;
+    analyticsMeasurementMode?: GtmAnalyticsMeasurementMode;
+    colorScheme?: unknown;
+    disableTelemetry?: boolean;
+    enableDebug?: InitOptions["enableDebug"];
+    capabilities?: InitOptions["capabilities"];
+    runtimeEndpoints?: InitOptions["runtimeEndpoints"];
+    clientMeta?: InitOptions["clientMeta"];
+};
+type ProtocolConsentScope = NonNullable<Exclude<InitOptions["defaultConsent"], string>>[number];
+export type GtmTemplateScopeOption = {
+    label: string;
+    scope: Scope;
+    description: string;
+};
+export type GtmTemplateMappingOption = {
+    consentType: GtmConsentType;
+    label: string;
+};
+export declare const ESSENTIAL_GTM_SCOPES: readonly [
+    "functionality.storage",
+    "security.storage"
+];
+export declare const isHostConfigurableGtmScope: (scope: Scope) => scope is ProtocolConsentScope;
+export declare const DEFAULT_GTM_SCOPE_MAPPINGS: ReadonlyArray<GtmScopeMapping>;
+export declare const GTM_TEMPLATE_SCOPE_OPTIONS: ReadonlyArray<GtmTemplateScopeOption>;
+export declare const GTM_TEMPLATE_MAPPING_OPTIONS: ReadonlyArray<GtmTemplateMappingOption>;
+export declare function isGtmConsentType(value: unknown): value is GtmConsentType;
+export declare function normalizeGtmThemeInput(input: unknown): InitOptions["colorScheme"] | undefined;
+export declare function resolveDefaultConsentFromGtm(input: {
+    consentState?: GtmConsentState;
+    scopeMappings?: ReadonlyArray<GtmScopeMapping>;
+    analyticsMeasurementMode?: GtmAnalyticsMeasurementMode;
+}): InitOptions["defaultConsent"] | undefined;
+export declare function buildInitOptionsFromGtmTemplate(input: GtmTemplateInput): InitOptions;
+export {};
+//# sourceMappingURL=core.d.ts.map

package/dist/gtm/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/gtm/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,WAAW,EAGhB,KAAK,KAAK,EACV,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,iBAAiB,EAAE,SAAS;IACxC,uBAAuB;IACvB,kBAAkB;IAClB,mBAAmB;IACnB,yBAAyB;IACzB,YAAY;IACZ,cAAc;IACd,oBAAoB;CASpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,2BAA2B,GACpC,2BAA2B,GAC3B,SAAS,GACT,QAAQ,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,oBAAoB,GAAG,WAAW,CACtC,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAC9C,CAAC,MAAM,CAAC,CAAC;AAEV,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,WAAW,EAAE,cAAc,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAAS;IAC3C,uBAAuB;IACvB,kBAAkB;CAC8B,CAAC;AAIlD,eAAO,MAAM,0BAA0B,GACtC,OAAO,KAAK,KACV,KAAK,IAAI,oBAAmD,CAAC;AAEhE,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,eAAe,CA6BrE,CAAC;AA4BF,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,sBAAsB,CAKzE,CAAC;AAEL,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC,wBAAwB,CAI7E,CAAC;AAEL,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,OAAO,GACZ,WAAW,CAAC,aAAa,CAAC,GAAG,SAAS,CA2CxC;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IACnD,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;CACvD,GAAG,WAAW,CAAC,gBAAgB,CAAC,GAAG,SAAS,CA6B5C;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,gBAAgB,GACrB,WAAW,CA8Bb"}

package/dist/gtm/core.js

@@ -0,0 +1,166 @@
+import { colorSchemeConfigInputSchema, consentConfigInputSchema, DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, listScopes, parseInitOptions, } from "@getuserfeedback/protocol";
+export const GTM_CONSENT_TYPES = [
+    "functionality_storage",
+    "security_storage",
+    "analytics_storage",
+    "personalization_storage",
+    "ad_storage",
+    "ad_user_data",
+    "ad_personalization",
+];
+export const ESSENTIAL_GTM_SCOPES = ["functionality.storage", "security.storage"];
+const essentialScopes = new Set(ESSENTIAL_GTM_SCOPES);
+export const isHostConfigurableGtmScope = (scope) => !essentialScopes.has(scope);
+export const DEFAULT_GTM_SCOPE_MAPPINGS = [
+    {
+        scope: "functionality.storage",
+        consentType: "functionality_storage",
+    },
+    {
+        scope: "security.storage",
+        consentType: "security_storage",
+    },
+    {
+        scope: "analytics.storage",
+        consentType: "analytics_storage",
+    },
+    {
+        scope: "personalization.storage",
+        consentType: "personalization_storage",
+    },
+    {
+        scope: "ads.storage",
+        consentType: "ad_storage",
+    },
+    {
+        scope: "ads.user_data",
+        consentType: "ad_user_data",
+    },
+    {
+        scope: "ads.personalization",
+        consentType: "ad_personalization",
+    },
+];
+const toTitleCase = (value) => value
+    .split(/[_\-.]/g)
+    .filter((part) => part.length > 0)
+    .map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`)
+    .join(" ");
+const uniqueScopes = (scopes) => {
+    const deduped = new Set();
+    for (const scope of scopes) {
+        if (!isHostConfigurableGtmScope(scope)) {
+            continue;
+        }
+        deduped.add(scope);
+    }
+    return [...deduped];
+};
+const normalizeAttrList = (value) => value
+    .split(",")
+    .map((entry) => entry.trim())
+    .filter((entry) => entry.length > 0);
+export const GTM_TEMPLATE_SCOPE_OPTIONS = listScopes().map((scopeMeta) => ({
+    label: toTitleCase(scopeMeta.id),
+    scope: scopeMeta.id,
+    description: scopeMeta.description,
+}));
+export const GTM_TEMPLATE_MAPPING_OPTIONS = GTM_CONSENT_TYPES.map((consentType) => ({
+    consentType,
+    label: toTitleCase(consentType),
+}));
+export function isGtmConsentType(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    return GTM_CONSENT_TYPES.some((consentType) => consentType === value);
+}
+export function normalizeGtmThemeInput(input) {
+    if (input === undefined || input === null) {
+        return undefined;
+    }
+    if (Array.isArray(input)) {
+        const attrs = input
+            .filter((value) => typeof value === "string")
+            .map((value) => value.trim())
+            .filter((value) => value.length > 0);
+        if (attrs.length === 0) {
+            return undefined;
+        }
+        return { autoDetectColorScheme: attrs };
+    }
+    if (typeof input !== "string") {
+        return undefined;
+    }
+    const normalized = input.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return undefined;
+    }
+    if (normalized === "light" ||
+        normalized === "dark" ||
+        normalized === "system") {
+        return normalized;
+    }
+    if (normalized === "auto") {
+        return colorSchemeConfigInputSchema.parse({
+            autoDetectColorScheme: [...DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS],
+        });
+    }
+    const attrs = normalizeAttrList(input);
+    if (attrs.length === 0) {
+        return undefined;
+    }
+    return colorSchemeConfigInputSchema.parse({
+        autoDetectColorScheme: attrs,
+    });
+}
+export function resolveDefaultConsentFromGtm(input) {
+    const consentState = input.consentState;
+    if (!consentState) {
+        return undefined;
+    }
+    const mappings = input.scopeMappings ?? DEFAULT_GTM_SCOPE_MAPPINGS;
+    const grantedScopes = uniqueScopes(mappings.flatMap((mapping) => consentState[mapping.consentType] === "granted" ? [mapping.scope] : []));
+    const analyticsMeasurementMode = input.analyticsMeasurementMode ?? "inherit-analytics-storage";
+    if (analyticsMeasurementMode === "granted") {
+        grantedScopes.push("analytics.measurement");
+    }
+    if (analyticsMeasurementMode === "inherit-analytics-storage" &&
+        consentState.analytics_storage === "granted") {
+        grantedScopes.push("analytics.measurement");
+    }
+    const normalizedGrantedScopes = uniqueScopes(grantedScopes);
+    return normalizedGrantedScopes.length > 0
+        ? consentConfigInputSchema.parse(normalizedGrantedScopes)
+        : undefined;
+}
+export function buildInitOptionsFromGtmTemplate(input) {
+    const colorScheme = normalizeGtmThemeInput(input.colorScheme);
+    const defaultConsent = resolveDefaultConsentFromGtm({
+        consentState: input.consentState,
+        scopeMappings: input.scopeMappings,
+        analyticsMeasurementMode: input.analyticsMeasurementMode,
+    });
+    return parseInitOptions({
+        apiKey: input.apiKey,
+        ...(colorScheme !== undefined ? { colorScheme } : {}),
+        ...(input.disableTelemetry !== undefined
+            ? { disableTelemetry: input.disableTelemetry }
+            : {}),
+        ...(input.enableDebug !== undefined
+            ? { enableDebug: input.enableDebug }
+            : {}),
+        ...(defaultConsent !== undefined ? { defaultConsent } : {}),
+        clientMeta: {
+            ...(input.clientMeta ?? {}),
+            loader: "gtm",
+            transport: input.clientMeta?.transport ?? "tag-manager",
+        },
+        ...(input.capabilities !== undefined
+            ? { capabilities: input.capabilities }
+            : {}),
+        ...(input.runtimeEndpoints !== undefined
+            ? { runtimeEndpoints: input.runtimeEndpoints }
+            : {}),
+    });
+}

package/dist/gtm/index.d.ts

@@ -1,52 +1,3 @@
-import { type InitOptions, type Scope } from "@getuserfeedback/protocol";
-export declare const GTM_CONSENT_TYPES: readonly [
-    "functionality_storage",
-    "security_storage",
-    "analytics_storage",
-    "personalization_storage",
-    "ad_storage",
-    "ad_user_data",
-    "ad_personalization"
-];
-export type GtmConsentType = (typeof GTM_CONSENT_TYPES)[number];
-export type GtmConsentValue = "granted" | "denied";
-export type GtmAnalyticsMeasurementMode = "inherit-analytics-storage" | "granted" | "denied";
-export type GtmScopeMapping = {
-    scope: Scope;
-    consentType: GtmConsentType;
-};
-export type GtmConsentState = Partial<Record<GtmConsentType, GtmConsentValue>>;
-export type GtmTemplateInput = {
-    apiKey: string;
-    consentState?: GtmConsentState;
-    scopeMappings?: ReadonlyArray<GtmScopeMapping>;
-    analyticsMeasurementMode?: GtmAnalyticsMeasurementMode;
-    colorScheme?: unknown;
-    disableTelemetry?: boolean;
-    enableDebug?: InitOptions["enableDebug"];
-    capabilities?: InitOptions["capabilities"];
-    runtimeEndpoints?: InitOptions["runtimeEndpoints"];
-    clientMeta?: InitOptions["clientMeta"];
-};
-type GtmTemplateScopeOption = {
-    label: string;
-    scope: Scope;
-    description: string;
-};
-type GtmTemplateMappingOption = {
-    consentType: GtmConsentType;
-    label: string;
-};
-export declare const DEFAULT_GTM_SCOPE_MAPPINGS: ReadonlyArray<GtmScopeMapping>;
-export declare const GTM_TEMPLATE_SCOPE_OPTIONS: ReadonlyArray<GtmTemplateScopeOption>;
-export declare const GTM_TEMPLATE_MAPPING_OPTIONS: ReadonlyArray<GtmTemplateMappingOption>;
-export declare function isGtmConsentType(value: unknown): value is GtmConsentType;
-export declare function normalizeGtmThemeInput(input: unknown): InitOptions["colorScheme"] | undefined;
-export declare function resolveDefaultConsentFromGtm(input: {
-    consentState?: GtmConsentState;
-    scopeMappings?: ReadonlyArray<GtmScopeMapping>;
-    analyticsMeasurementMode?: GtmAnalyticsMeasurementMode;
-}): InitOptions["defaultConsent"] | undefined;
-export declare function buildInitOptionsFromGtmTemplate(input: GtmTemplateInput): InitOptions;
-export {};
+export { buildInitOptionsFromGtmTemplate, DEFAULT_GTM_SCOPE_MAPPINGS, ESSENTIAL_GTM_SCOPES, GTM_CONSENT_TYPES, GTM_TEMPLATE_MAPPING_OPTIONS, GTM_TEMPLATE_SCOPE_OPTIONS, type GtmAnalyticsMeasurementMode, type GtmConsentState, type GtmConsentType, type GtmConsentValue, type GtmScopeMapping, type GtmTemplateInput, type GtmTemplateMappingOption, type GtmTemplateScopeOption, isGtmConsentType, isHostConfigurableGtmScope, normalizeGtmThemeInput, resolveDefaultConsentFromGtm, } from "./core.js";
+export { buildGtmPermissions, buildGtmRuntimeSource, buildGtmTemplateArtifact, buildGtmTemplateInfo, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, type GtmTemplateArtifact, type GtmTemplateGenerationOptions, type GtmTemplateInfo, type GtmTemplateParts, type GtmTemplatePermission, type TemplateCondition, type TemplateParameter, type TemplateSelectItem, type TemplateValueValidator, } from "./template-generation.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gtm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,WAAW,EAEhB,KAAK,KAAK,EACV,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,iBAAiB,EAAE,SAAS;IACxC,uBAAuB;IACvB,kBAAkB;IAClB,mBAAmB;IACnB,yBAAyB;IACzB,YAAY;IACZ,cAAc;IACd,oBAAoB;CASpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,2BAA2B,GACpC,2BAA2B,GAC3B,SAAS,GACT,QAAQ,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAMF,KAAK,sBAAsB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAUF,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,eAAe,CA6BrE,CAAC;AA4BF,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,sBAAsB,CAKzE,CAAC;AAEL,eAAO,MAAM,4BAA4B,EAAE,aAAa,CAAC,wBAAwB,CAI7E,CAAC;AAEL,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,OAAO,GACZ,WAAW,CAAC,aAAa,CAAC,GAAG,SAAS,CA2CxC;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IACnD,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;CACvD,GAAG,WAAW,CAAC,gBAAgB,CAAC,GAAG,SAAS,CA0B5C;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,gBAAgB,GACrB,WAAW,CA8Bb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gtm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,EACjB,4BAA4B,EAC5B,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,GAC5B,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,EAClC,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC3B,MAAM,0BAA0B,CAAC"}

package/dist/gtm/index.js

@@ -1,165 +1,2 @@
-import { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, listScopes, } from "@getuserfeedback/protocol";
-export const GTM_CONSENT_TYPES = [
-    "functionality_storage",
-    "security_storage",
-    "analytics_storage",
-    "personalization_storage",
-    "ad_storage",
-    "ad_user_data",
-    "ad_personalization",
-];
-const essentialScopes = new Set([
-    "functionality.storage",
-    "security.storage",
-]);
-const isProtocolConsentScope = (scope) => !essentialScopes.has(scope);
-export const DEFAULT_GTM_SCOPE_MAPPINGS = [
-    {
-        scope: "functionality.storage",
-        consentType: "functionality_storage",
-    },
-    {
-        scope: "security.storage",
-        consentType: "security_storage",
-    },
-    {
-        scope: "analytics.storage",
-        consentType: "analytics_storage",
-    },
-    {
-        scope: "personalization.storage",
-        consentType: "personalization_storage",
-    },
-    {
-        scope: "ads.storage",
-        consentType: "ad_storage",
-    },
-    {
-        scope: "ads.user_data",
-        consentType: "ad_user_data",
-    },
-    {
-        scope: "ads.personalization",
-        consentType: "ad_personalization",
-    },
-];
-const toTitleCase = (value) => value
-    .split(/[_\-.]/g)
-    .filter((part) => part.length > 0)
-    .map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`)
-    .join(" ");
-const uniqueScopes = (scopes) => {
-    const deduped = new Set();
-    for (const scope of scopes) {
-        if (!isProtocolConsentScope(scope)) {
-            continue;
-        }
-        deduped.add(scope);
-    }
-    return [...deduped];
-};
-const normalizeAttrList = (value) => value
-    .split(",")
-    .map((entry) => entry.trim())
-    .filter((entry) => entry.length > 0);
-export const GTM_TEMPLATE_SCOPE_OPTIONS = listScopes().map((scopeMeta) => ({
-    label: toTitleCase(scopeMeta.id),
-    scope: scopeMeta.id,
-    description: scopeMeta.description,
-}));
-export const GTM_TEMPLATE_MAPPING_OPTIONS = GTM_CONSENT_TYPES.map((consentType) => ({
-    consentType,
-    label: toTitleCase(consentType),
-}));
-export function isGtmConsentType(value) {
-    if (typeof value !== "string") {
-        return false;
-    }
-    return GTM_CONSENT_TYPES.some((consentType) => consentType === value);
-}
-export function normalizeGtmThemeInput(input) {
-    if (input === undefined || input === null) {
-        return undefined;
-    }
-    if (Array.isArray(input)) {
-        const attrs = input
-            .filter((value) => typeof value === "string")
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0);
-        if (attrs.length === 0) {
-            return undefined;
-        }
-        return { autoDetectColorScheme: attrs };
-    }
-    if (typeof input !== "string") {
-        return undefined;
-    }
-    const normalized = input.trim().toLowerCase();
-    if (normalized.length === 0) {
-        return undefined;
-    }
-    if (normalized === "light" ||
-        normalized === "dark" ||
-        normalized === "system") {
-        return normalized;
-    }
-    if (normalized === "auto") {
-        return {
-            autoDetectColorScheme: [...DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS],
-        };
-    }
-    const attrs = normalizeAttrList(input);
-    if (attrs.length === 0) {
-        return undefined;
-    }
-    return {
-        autoDetectColorScheme: attrs,
-    };
-}
-export function resolveDefaultConsentFromGtm(input) {
-    const consentState = input.consentState;
-    if (!consentState) {
-        return undefined;
-    }
-    const mappings = input.scopeMappings ?? DEFAULT_GTM_SCOPE_MAPPINGS;
-    const grantedScopes = uniqueScopes(mappings.flatMap((mapping) => consentState[mapping.consentType] === "granted" ? [mapping.scope] : []));
-    const analyticsMeasurementMode = input.analyticsMeasurementMode ?? "inherit-analytics-storage";
-    if (analyticsMeasurementMode === "granted") {
-        grantedScopes.push("analytics.measurement");
-    }
-    if (analyticsMeasurementMode === "inherit-analytics-storage" &&
-        consentState.analytics_storage === "granted") {
-        grantedScopes.push("analytics.measurement");
-    }
-    return uniqueScopes(grantedScopes);
-}
-export function buildInitOptionsFromGtmTemplate(input) {
-    const colorScheme = normalizeGtmThemeInput(input.colorScheme);
-    const defaultConsent = resolveDefaultConsentFromGtm({
-        consentState: input.consentState,
-        scopeMappings: input.scopeMappings,
-        analyticsMeasurementMode: input.analyticsMeasurementMode,
-    });
-    return {
-        apiKey: input.apiKey,
-        ...(colorScheme !== undefined ? { colorScheme } : {}),
-        ...(input.disableTelemetry !== undefined
-            ? { disableTelemetry: input.disableTelemetry }
-            : {}),
-        ...(input.enableDebug !== undefined
-            ? { enableDebug: input.enableDebug }
-            : {}),
-        ...(defaultConsent !== undefined ? { defaultConsent } : {}),
-        clientMeta: {
-            ...(input.clientMeta ?? {}),
-            loader: "gtm",
-            transport: input.clientMeta?.transport ?? "tag-manager",
-        },
-        ...(input.capabilities !== undefined
-            ? { capabilities: input.capabilities }
-            : {}),
-        ...(input.runtimeEndpoints !== undefined
-            ? { runtimeEndpoints: input.runtimeEndpoints }
-            : {}),
-    };
-}
+export { buildInitOptionsFromGtmTemplate, DEFAULT_GTM_SCOPE_MAPPINGS, ESSENTIAL_GTM_SCOPES, GTM_CONSENT_TYPES, GTM_TEMPLATE_MAPPING_OPTIONS, GTM_TEMPLATE_SCOPE_OPTIONS, isGtmConsentType, isHostConfigurableGtmScope, normalizeGtmThemeInput, resolveDefaultConsentFromGtm, } from "./core.js";
+export { buildGtmPermissions, buildGtmRuntimeSource, buildGtmTemplateArtifact, buildGtmTemplateInfo, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, } from "./template-generation.js";

package/dist/gtm/template-generation.d.ts

@@ -0,0 +1,129 @@
+export type TemplateSelectItem = {
+    value: string;
+    displayValue: string;
+};
+export type TemplateCondition = {
+    paramName: string;
+    paramValue: string;
+    type: "EQUALS";
+};
+export type TemplateValueValidator = {
+    type: "NON_EMPTY";
+};
+export type TemplateParameter = {
+    type: "TEXT";
+    name: string;
+    displayName: string;
+    simpleValueType: true;
+    help?: string;
+    defaultValue?: string;
+    valueValidators?: TemplateValueValidator[];
+    enablingConditions?: TemplateCondition[];
+} | {
+    type: "SELECT";
+    name: string;
+    displayName: string;
+    simpleValueType: true;
+    help?: string;
+    defaultValue?: string;
+    macrosInSelect: boolean;
+    selectItems: TemplateSelectItem[];
+    valueValidators?: TemplateValueValidator[];
+    enablingConditions?: TemplateCondition[];
+} | {
+    type: "RADIO";
+    name: string;
+    displayName: string;
+    simpleValueType: true;
+    defaultValue: string;
+    radioItems: Array<TemplateSelectItem & {
+        help?: string;
+    }>;
+} | {
+    type: "SIMPLE_TABLE";
+    name: string;
+    displayName: string;
+    help?: string;
+    defaultValue?: Array<Record<string, string>>;
+    newRowButtonText: string;
+    simpleTableColumns: Array<{
+        defaultValue?: string;
+        displayName: string;
+        name: string;
+        type: "SELECT";
+        isUnique?: boolean;
+        macrosInSelect?: boolean;
+        selectItems: TemplateSelectItem[];
+    }>;
+    valueValidators?: TemplateValueValidator[];
+    enablingConditions?: TemplateCondition[];
+} | {
+    type: "GROUP";
+    name: string;
+    displayName: string;
+    groupStyle: "ZIPPY_CLOSED";
+    subParams: TemplateParameter[];
+};
+type GtmPermissionStringValue = {
+    type: 1;
+    string: string;
+};
+type GtmPermissionBooleanValue = {
+    type: 8;
+    boolean: boolean;
+};
+type GtmPermissionMapValue = {
+    type: 3;
+    mapKey: GtmPermissionStringValue[];
+    mapValue: Array<GtmPermissionStringValue | GtmPermissionBooleanValue | GtmPermissionListValue | GtmPermissionMapValue>;
+};
+type GtmPermissionListValue = {
+    type: 2;
+    listItem: Array<GtmPermissionStringValue | GtmPermissionBooleanValue | GtmPermissionMapValue>;
+};
+type GtmPermissionParam = {
+    key: string;
+    value: GtmPermissionStringValue | GtmPermissionBooleanValue | GtmPermissionListValue | GtmPermissionMapValue;
+};
+export type GtmTemplatePermission = {
+    instance: {
+        key: {
+            publicId: string;
+            versionId: "1";
+        };
+        param: GtmPermissionParam[];
+    };
+    clientAnnotations?: {
+        isEditedByUser: true;
+    };
+    isRequired: true;
+};
+export type GtmTemplateInfo = {
+    type: "TAG";
+    version: 1;
+    displayName: string;
+    description: string;
+    categories: readonly ["SURVEY", "PERSONALIZATION", "UTILITY"];
+    containerContexts: readonly ["WEB"];
+};
+export type GtmTemplateParts = {
+    info: GtmTemplateInfo;
+    parameters: TemplateParameter[];
+    runtimeSource: string;
+    permissions: GtmTemplatePermission[];
+};
+export type GtmTemplateArtifact = GtmTemplateParts;
+export type GtmTemplateGenerationOptions = {
+    loaderScriptBaseUrl?: string;
+    displayName?: string;
+    description?: string;
+};
+export declare const DEFAULT_GTM_LOADER_SCRIPT_BASE_URL = "https://cdn.getuserfeedback.com/widget/loader/v1";
+export declare function buildGtmTemplateParameters(_options?: GtmTemplateGenerationOptions): TemplateParameter[];
+export declare function buildGtmRuntimeSource(input?: GtmTemplateGenerationOptions): string;
+export declare function buildGtmPermissions(input?: GtmTemplateGenerationOptions): GtmTemplatePermission[];
+export declare function buildGtmTemplateInfo(input?: GtmTemplateGenerationOptions): GtmTemplateInfo;
+export declare function buildGtmTemplateParts(input?: GtmTemplateGenerationOptions): GtmTemplateParts;
+export declare function buildGtmTemplateArtifact(input?: GtmTemplateGenerationOptions): GtmTemplateArtifact;
+export {};
+//# sourceMappingURL=template-generation.d.ts.map

package/dist/gtm/template-generation.d.ts.map

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

package/dist/gtm/template-generation.js

@@ -0,0 +1,571 @@
+import { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, } from "@getuserfeedback/protocol";
+import { DEFAULT_GTM_SCOPE_MAPPINGS, ESSENTIAL_GTM_SCOPES, GTM_CONSENT_TYPES, GTM_TEMPLATE_MAPPING_OPTIONS, GTM_TEMPLATE_SCOPE_OPTIONS, isHostConfigurableGtmScope, } from "./core.js";
+export const DEFAULT_GTM_LOADER_SCRIPT_BASE_URL = "https://cdn.getuserfeedback.com/widget/loader/v1";
+const GTM_TEMPLATE_VERSION = 1;
+const GTM_TEMPLATE_DEFAULT_DISPLAY_NAME = "getuserfeedback Widget";
+const GTM_TEMPLATE_DEFAULT_DESCRIPTION = "Load the getuserfeedback widget with modern loader, theme, and GTM Consent Mode defaults derived from the public protocol contract.";
+const GTM_TEMPLATE_CATEGORIES = [
+    "SURVEY",
+    "PERSONALIZATION",
+    "UTILITY",
+];
+const GTM_TEMPLATE_CONTAINER_CONTEXTS = ["WEB"];
+const GTM_QUEUE_KEY = "__getuserfeedback_queue";
+const NON_EMPTY_VALIDATOR = { type: "NON_EMPTY" };
+const MANUAL_CONSENT_MODE_CONDITION = [
+    {
+        paramName: "consentMode",
+        paramValue: "manual",
+        type: "EQUALS",
+    },
+];
+const AUTOMATIC_CONSENT_MODE_CONDITION = [
+    {
+        paramName: "consentMode",
+        paramValue: "automatic",
+        type: "EQUALS",
+    },
+];
+const buildHostConfigurableDefaultScopeMappings = () => [
+    ...DEFAULT_GTM_SCOPE_MAPPINGS.filter((mapping) => isHostConfigurableGtmScope(mapping.scope)).map((mapping) => ({
+        scope: mapping.scope,
+        mapping: mapping.consentType,
+    })),
+    {
+        scope: "analytics.measurement",
+        mapping: "analytics_storage",
+    },
+];
+const buildScopeParameterHelp = () => [
+    "Essential scopes are fixed by the loader and are not exposed for GTM override.",
+    `${ESSENTIAL_GTM_SCOPES[0]} and ${ESSENTIAL_GTM_SCOPES[1]} always remain baseline scopes outside the GTM template UI.`,
+    "",
+    ...GTM_TEMPLATE_SCOPE_OPTIONS.filter((option) => isHostConfigurableGtmScope(option.scope)).map((option) => `${option.label}: ${option.description}`),
+].join("\n");
+const buildHostConfigurableScopeSelectItems = () => GTM_TEMPLATE_SCOPE_OPTIONS.filter((option) => isHostConfigurableGtmScope(option.scope)).map((option) => ({
+    value: option.scope,
+    displayValue: option.label,
+}));
+const buildGtmConsentTypeSelectItems = () => GTM_TEMPLATE_MAPPING_OPTIONS.map((option) => ({
+    value: option.consentType,
+    displayValue: `${option.label} Granted`,
+}));
+const trimTrailingSlash = (value) => value.endsWith("/") ? value.slice(0, -1) : value;
+const stringValue = (value) => ({
+    type: 1,
+    string: value,
+});
+const booleanValue = (value) => ({
+    type: 8,
+    boolean: value,
+});
+const listValue = (items) => ({
+    type: 2,
+    listItem: items,
+});
+const mapValue = (entries) => ({
+    type: 3,
+    mapKey: entries.map(([key]) => stringValue(key)),
+    mapValue: entries.map(([, value]) => {
+        if (typeof value === "string") {
+            return stringValue(value);
+        }
+        if (typeof value === "boolean") {
+            return booleanValue(value);
+        }
+        return value;
+    }),
+});
+const buildPermission = (publicId, params) => ({
+    instance: {
+        key: {
+            publicId,
+            versionId: "1",
+        },
+        param: params,
+    },
+    clientAnnotations: {
+        isEditedByUser: true,
+    },
+    isRequired: true,
+});
+export function buildGtmTemplateParameters(_options) {
+    const scopeHelp = buildScopeParameterHelp();
+    const scopeSelectItems = buildHostConfigurableScopeSelectItems();
+    const mappingSelectItems = buildGtmConsentTypeSelectItems();
+    return [
+        {
+            type: "TEXT",
+            name: "apiKey",
+            displayName: "API Key",
+            simpleValueType: true,
+            help: "Find your API key in getuserfeedback.com under Settings -> Widget.",
+            valueValidators: [NON_EMPTY_VALIDATOR],
+        },
+        {
+            type: "GROUP",
+            name: "themeGroup",
+            displayName: "Theme Settings",
+            groupStyle: "ZIPPY_CLOSED",
+            subParams: [
+                {
+                    type: "SELECT",
+                    name: "themeMode",
+                    displayName: "Theme Mode",
+                    macrosInSelect: false,
+                    selectItems: [
+                        {
+                            value: "light",
+                            displayValue: "Always Light",
+                        },
+                        {
+                            value: "dark",
+                            displayValue: "Always Dark",
+                        },
+                        {
+                            value: "system",
+                            displayValue: "Follow System Preference",
+                        },
+                        {
+                            value: "host",
+                            displayValue: "Sync With Host Attributes",
+                        },
+                        {
+                            value: "variable",
+                            displayValue: "Resolve From GTM Variable",
+                        },
+                    ],
+                    simpleValueType: true,
+                    defaultValue: "host",
+                    help: "Generate protocol-valid `init.opts.colorScheme` using fixed modes, host auto-detect attributes, or a GTM variable.",
+                },
+                {
+                    type: "SELECT",
+                    name: "themeModeVariable",
+                    displayName: "Theme Mode Variable",
+                    macrosInSelect: true,
+                    selectItems: [],
+                    simpleValueType: true,
+                    help: "Variable must resolve to `light`, `dark`, `system`, `auto`, or a comma-separated attribute list.",
+                    enablingConditions: [
+                        {
+                            paramName: "themeMode",
+                            paramValue: "variable",
+                            type: "EQUALS",
+                        },
+                    ],
+                    valueValidators: [NON_EMPTY_VALIDATOR],
+                },
+                {
+                    type: "TEXT",
+                    name: "themeAttr",
+                    displayName: "Host Theme Attributes",
+                    simpleValueType: true,
+                    defaultValue: DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS.join(","),
+                    help: "Comma-separated attributes to inspect on `<html>` or `<body>` when syncing the widget to host theme state.",
+                    enablingConditions: [
+                        {
+                            paramName: "themeMode",
+                            paramValue: "host",
+                            type: "EQUALS",
+                        },
+                    ],
+                },
+            ],
+        },
+        {
+            type: "GROUP",
+            name: "consentGroup",
+            displayName: "Consent Settings",
+            groupStyle: "ZIPPY_CLOSED",
+            subParams: [
+                {
+                    type: "RADIO",
+                    name: "consentMode",
+                    displayName: "Consent Mode",
+                    radioItems: [
+                        {
+                            value: "automatic",
+                            displayValue: "Automatic (Use GTM Consent Mode)",
+                            help: "Read GTM consent mode via `isConsentGranted`, translate granted consent types into widget `defaultConsent`, and apply the explicit analytics measurement policy.",
+                        },
+                        {
+                            value: "manual",
+                            displayValue: "Manual (Map Public Scopes)",
+                            help: "Override host-configurable widget consent scopes with explicit GTM consent mappings. Essential scopes remain fixed by the loader and are never configurable here.",
+                        },
+                    ],
+                    simpleValueType: true,
+                    defaultValue: "automatic",
+                },
+                {
+                    type: "SELECT",
+                    name: "analyticsMeasurementMode",
+                    displayName: "Analytics Measurement Policy",
+                    macrosInSelect: false,
+                    selectItems: [
+                        {
+                            value: "inherit-analytics-storage",
+                            displayValue: "Inherit analytics_storage",
+                        },
+                        {
+                            value: "granted",
+                            displayValue: "Always granted",
+                        },
+                        {
+                            value: "denied",
+                            displayValue: "Always denied",
+                        },
+                    ],
+                    simpleValueType: true,
+                    defaultValue: "inherit-analytics-storage",
+                    help: "Controls whether `analytics.measurement` follows GTM `analytics_storage` or is forced on/off in automatic mode.",
+                    enablingConditions: [...AUTOMATIC_CONSENT_MODE_CONDITION],
+                },
+                {
+                    type: "SIMPLE_TABLE",
+                    name: "scopeMappings",
+                    displayName: "Scope Mappings",
+                    simpleTableColumns: [
+                        {
+                            defaultValue: "analytics.storage",
+                            displayName: "Widget Scope",
+                            name: "scope",
+                            type: "SELECT",
+                            isUnique: true,
+                            selectItems: scopeSelectItems,
+                        },
+                        {
+                            defaultValue: "analytics_storage",
+                            displayName: "Granted When",
+                            name: "mapping",
+                            type: "SELECT",
+                            macrosInSelect: true,
+                            selectItems: mappingSelectItems,
+                        },
+                    ],
+                    newRowButtonText: "Add Scope",
+                    help: scopeHelp,
+                    enablingConditions: [...MANUAL_CONSENT_MODE_CONDITION],
+                    valueValidators: [NON_EMPTY_VALIDATOR],
+                    defaultValue: buildHostConfigurableDefaultScopeMappings().map((row) => ({
+                        scope: row.scope,
+                        mapping: row.mapping,
+                    })),
+                },
+            ],
+        },
+    ];
+}
+export function buildGtmRuntimeSource(input) {
+    const loaderScriptBaseUrl = trimTrailingSlash(input?.loaderScriptBaseUrl ?? DEFAULT_GTM_LOADER_SCRIPT_BASE_URL);
+    const defaultTemplateScopeMappings = buildHostConfigurableDefaultScopeMappings();
+    return `
+const log = require("logToConsole");
+const injectScript = require("injectScript");
+const queryPermission = require("queryPermission");
+const createQueue = require("createQueue");
+const isConsentGranted = require("isConsentGranted");
+
+const loaderScriptBaseUrl = ${JSON.stringify(loaderScriptBaseUrl)};
+const gtmConsentTypes = ${JSON.stringify(GTM_CONSENT_TYPES)};
+const defaultScopeMappings = ${JSON.stringify(defaultTemplateScopeMappings)};
+const hostConfigurableScopes = ${JSON.stringify(defaultTemplateScopeMappings.map((row) => row.scope))};
+const defaultAutoDetectColorSchemeAttrs = ${JSON.stringify(DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS)};
+const queueKey = ${JSON.stringify(GTM_QUEUE_KEY)};
+
+const trimString = function(value) {
+	return typeof value === "string" ? value.trim() : "";
+};
+
+const normalizeAttrList = function(value) {
+	return value
+		.split(",")
+		.map(function(entry) {
+			return entry.trim();
+		})
+		.filter(function(entry) {
+			return entry.length > 0;
+		});
+};
+
+const normalizeThemeInput = function(inputValue) {
+	if (inputValue === undefined || inputValue === null) {
+		return undefined;
+	}
+
+	if (typeof inputValue === "string") {
+		const normalized = inputValue.trim().toLowerCase();
+		if (!normalized) {
+			return undefined;
+		}
+		if (
+			normalized === "light" ||
+			normalized === "dark" ||
+			normalized === "system"
+		) {
+			return normalized;
+		}
+		if (normalized === "auto") {
+			return {
+				autoDetectColorScheme: defaultAutoDetectColorSchemeAttrs.slice(),
+			};
+		}
+		const attrs = normalizeAttrList(inputValue);
+		return attrs.length > 0
+			? { autoDetectColorScheme: attrs }
+			: undefined;
+	}
+
+	return undefined;
+};
+
+const getThemeInput = function(templateData) {
+	if (templateData.themeMode === "variable") {
+		return templateData.themeModeVariable;
+	}
+	if (templateData.themeMode === "host") {
+		return templateData.themeAttr;
+	}
+	if (
+		templateData.themeMode === "light" ||
+		templateData.themeMode === "dark" ||
+		templateData.themeMode === "system"
+	) {
+		return templateData.themeMode;
+	}
+	return undefined;
+};
+
+const getConsentState = function() {
+	const result = {};
+	for (let index = 0; index < gtmConsentTypes.length; index += 1) {
+		const consentType = gtmConsentTypes[index];
+		result[consentType] = isConsentGranted(consentType)
+			? "granted"
+			: "denied";
+	}
+	return result;
+};
+
+const dedupeScopes = function(scopes) {
+	const seen = {};
+	const result = [];
+	for (let index = 0; index < scopes.length; index += 1) {
+		const scope = scopes[index];
+		if (typeof scope !== "string" || seen[scope]) {
+			continue;
+		}
+		seen[scope] = true;
+		result.push(scope);
+	}
+	return result;
+};
+
+const isKnownConsentType = function(consentType) {
+	for (let index = 0; index < gtmConsentTypes.length; index += 1) {
+		if (gtmConsentTypes[index] === consentType) {
+			return true;
+		}
+	}
+	return false;
+};
+
+const isHostConfigurableScope = function(scope) {
+	for (let index = 0; index < hostConfigurableScopes.length; index += 1) {
+		if (hostConfigurableScopes[index] === scope) {
+			return true;
+		}
+	}
+	return false;
+};
+
+const getManualScopeMappings = function(templateData) {
+	const rawRows = Array.isArray(templateData.scopeMappings)
+		? templateData.scopeMappings
+		: [];
+	const rows = rawRows.length > 0 ? rawRows : defaultScopeMappings;
+	return rows
+		.map(function(row) {
+			if (!row || typeof row !== "object") {
+				return undefined;
+			}
+			const scope = trimString(row.scope);
+			const consentType = trimString(row.mapping);
+			if (!scope || !consentType) {
+				return undefined;
+			}
+			if (!isHostConfigurableScope(scope) || !isKnownConsentType(consentType)) {
+				return undefined;
+			}
+			return {
+				scope: scope,
+				consentType: consentType,
+			};
+		})
+		.filter(function(row) {
+			return row !== undefined;
+		});
+};
+
+const getAnalyticsMeasurementMode = function(templateData) {
+	if (
+		templateData.analyticsMeasurementMode === "granted" ||
+		templateData.analyticsMeasurementMode === "denied"
+	) {
+		return templateData.analyticsMeasurementMode;
+	}
+	return "inherit-analytics-storage";
+};
+
+const buildDefaultConsent = function(templateData) {
+	const consentState = getConsentState();
+	const grantedScopes = [];
+
+	if (templateData.consentMode === "manual") {
+		const scopeMappings = getManualScopeMappings(templateData);
+		for (let index = 0; index < scopeMappings.length; index += 1) {
+			const mapping = scopeMappings[index];
+			if (consentState[mapping.consentType] === "granted") {
+				grantedScopes.push(mapping.scope);
+			}
+		}
+	} else {
+		for (let index = 0; index < defaultScopeMappings.length; index += 1) {
+			const mapping = defaultScopeMappings[index];
+			if (consentState[mapping.mapping] === "granted") {
+				grantedScopes.push(mapping.scope);
+			}
+		}
+
+		const analyticsMeasurementMode = getAnalyticsMeasurementMode(templateData);
+		if (analyticsMeasurementMode === "granted") {
+			grantedScopes.push("analytics.measurement");
+		}
+		if (
+			analyticsMeasurementMode === "inherit-analytics-storage" &&
+			consentState.analytics_storage === "granted"
+		) {
+			grantedScopes.push("analytics.measurement");
+		}
+	}
+
+	const dedupedScopes = dedupeScopes(grantedScopes);
+	return dedupedScopes.length > 0 ? dedupedScopes : undefined;
+};
+
+const onSuccess = function() {
+	if (typeof data.gtmOnSuccess === "function") {
+		data.gtmOnSuccess();
+	}
+};
+
+const onFailure = function() {
+	if (typeof data.gtmOnFailure === "function") {
+		data.gtmOnFailure();
+	}
+};
+
+const apiKey = trimString(data.apiKey);
+if (!apiKey) {
+	onFailure();
+	return;
+}
+
+const widgetUrl =
+	loaderScriptBaseUrl + "/" + encodeURIComponent(apiKey) + "/loader.js";
+const queuePush = createQueue(queueKey);
+const initOptions = {
+	apiKey: apiKey,
+	clientMeta: {
+		loader: "gtm",
+		transport: "tag-manager",
+	},
+};
+
+const colorScheme = normalizeThemeInput(getThemeInput(data));
+if (colorScheme !== undefined) {
+	initOptions.colorScheme = colorScheme;
+}
+
+const defaultConsent = buildDefaultConsent(data);
+if (defaultConsent !== undefined) {
+	initOptions.defaultConsent = defaultConsent;
+}
+
+queuePush({
+	kind: "init",
+	opts: initOptions,
+});
+
+log("Loading getuserfeedback loader:", widgetUrl);
+
+if (queryPermission("inject_script", widgetUrl)) {
+	injectScript(widgetUrl, onSuccess, onFailure, "getuserfeedback");
+} else {
+	onFailure();
+}
+`.trim();
+}
+export function buildGtmPermissions(input) {
+    const loaderScriptBaseUrl = trimTrailingSlash(input?.loaderScriptBaseUrl ?? DEFAULT_GTM_LOADER_SCRIPT_BASE_URL);
+    const loaderUrlPattern = `${loaderScriptBaseUrl}/*/loader.js`;
+    return [
+        buildPermission("inject_script", [
+            {
+                key: "urls",
+                value: listValue([stringValue(loaderUrlPattern)]),
+            },
+        ]),
+        buildPermission("logging", [
+            {
+                key: "environments",
+                value: stringValue("debug"),
+            },
+        ]),
+        buildPermission("access_globals", [
+            {
+                key: "keys",
+                value: listValue([
+                    mapValue([
+                        ["key", GTM_QUEUE_KEY],
+                        ["read", true],
+                        ["write", true],
+                        ["execute", false],
+                    ]),
+                ]),
+            },
+        ]),
+        buildPermission("access_consent", [
+            {
+                key: "consentTypes",
+                value: listValue(GTM_CONSENT_TYPES.map((consentType) => mapValue([
+                    ["consentType", consentType],
+                    ["read", true],
+                    ["write", false],
+                ]))),
+            },
+        ]),
+    ];
+}
+export function buildGtmTemplateInfo(input) {
+    return {
+        type: "TAG",
+        version: GTM_TEMPLATE_VERSION,
+        displayName: input?.displayName ?? GTM_TEMPLATE_DEFAULT_DISPLAY_NAME,
+        description: input?.description ?? GTM_TEMPLATE_DEFAULT_DESCRIPTION,
+        categories: GTM_TEMPLATE_CATEGORIES,
+        containerContexts: GTM_TEMPLATE_CONTAINER_CONTEXTS,
+    };
+}
+export function buildGtmTemplateParts(input) {
+    return {
+        info: buildGtmTemplateInfo(input),
+        parameters: buildGtmTemplateParameters(input),
+        runtimeSource: buildGtmRuntimeSource(input),
+        permissions: buildGtmPermissions(input),
+    };
+}
+export function buildGtmTemplateArtifact(input) {
+    return buildGtmTemplateParts(input);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getuserfeedback/adapters",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "getuserfeedback integration adapters",
   "keywords": [
     "getuserfeedback",