@getuserfeedback/adapters 0.3.0 → 0.4.1

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.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/gtm/core.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;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,CA0B5C;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,gBAAgB,GACrB,WAAW,CA8Bb"}
+{"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

@@ -1,4 +1,4 @@
-import { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, listScopes, } from "@getuserfeedback/protocol";
+import { colorSchemeConfigInputSchema, consentConfigInputSchema, DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, listScopes, parseInitOptions, } from "@getuserfeedback/protocol";
 export const GTM_CONSENT_TYPES = [
     "functionality_storage",
     "security_storage",
@@ -102,17 +102,17 @@ export function normalizeGtmThemeInput(input) {
         return normalized;
     }
     if (normalized === "auto") {
-        return {
+        return colorSchemeConfigInputSchema.parse({
             autoDetectColorScheme: [...DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS],
-        };
+        });
     }
     const attrs = normalizeAttrList(input);
     if (attrs.length === 0) {
         return undefined;
     }
-    return {
+    return colorSchemeConfigInputSchema.parse({
         autoDetectColorScheme: attrs,
-    };
+    });
 }
 export function resolveDefaultConsentFromGtm(input) {
     const consentState = input.consentState;
@@ -129,7 +129,10 @@ export function resolveDefaultConsentFromGtm(input) {
         consentState.analytics_storage === "granted") {
         grantedScopes.push("analytics.measurement");
     }
-    return uniqueScopes(grantedScopes);
+    const normalizedGrantedScopes = uniqueScopes(grantedScopes);
+    return normalizedGrantedScopes.length > 0
+        ? consentConfigInputSchema.parse(normalizedGrantedScopes)
+        : undefined;
 }
 export function buildInitOptionsFromGtmTemplate(input) {
     const colorScheme = normalizeGtmThemeInput(input.colorScheme);
@@ -138,7 +141,7 @@ export function buildInitOptionsFromGtmTemplate(input) {
         scopeMappings: input.scopeMappings,
         analyticsMeasurementMode: input.analyticsMeasurementMode,
     });
-    return {
+    return parseInitOptions({
         apiKey: input.apiKey,
         ...(colorScheme !== undefined ? { colorScheme } : {}),
         ...(input.disableTelemetry !== undefined
@@ -159,5 +162,5 @@ export function buildInitOptionsFromGtmTemplate(input) {
         ...(input.runtimeEndpoints !== undefined
             ? { runtimeEndpoints: input.runtimeEndpoints }
             : {}),
-    };
+    });
 }

package/dist/gtm/index.d.ts

@@ -1,3 +1,3 @@
 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 { buildGtmRuntimeSource, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, type GtmTemplateParts, type TemplateCondition, type TemplateParameter, type TemplateSelectItem, type TemplateValueValidator, } from "./template-generation.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,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,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,EAClC,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC3B,MAAM,0BAA0B,CAAC"}
+{"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,2 +1,2 @@
 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 { buildGtmRuntimeSource, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, } from "./template-generation.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

@@ -64,16 +64,66 @@ export type TemplateParameter = {
     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 declare const DEFAULT_GTM_LOADER_SCRIPT_BASE_URL = "https://cdn.getuserfeedback.com/widget/loader/v1";
-export declare function buildGtmTemplateParameters(): TemplateParameter[];
-export declare function buildGtmRuntimeSource(input?: {
+export type GtmTemplateArtifact = GtmTemplateParts;
+export type GtmTemplateGenerationOptions = {
     loaderScriptBaseUrl?: string;
-}): string;
-export declare function buildGtmTemplateParts(input?: {
-    loaderScriptBaseUrl?: string;
-}): GtmTemplateParts;
+    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

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

@@ -1,36 +1,47 @@
 import { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, } from "@getuserfeedback/protocol";
-import { GTM_CONSENT_TYPES, GTM_TEMPLATE_MAPPING_OPTIONS, GTM_TEMPLATE_SCOPE_OPTIONS, isHostConfigurableGtmScope, } from "./core.js";
+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 buildScopeParameterHelp = () => GTM_TEMPLATE_SCOPE_OPTIONS.filter((option) => isHostConfigurableGtmScope(option.scope))
-    .map((option) => `${option.label}: ${option.description}`)
-    .join("\n");
-const buildDefaultTemplateScopeMappings = () => [
-    {
-        scope: "analytics.storage",
-        mapping: "analytics_storage",
-    },
-    {
-        scope: "analytics.measurement",
-        mapping: "analytics_storage",
-    },
-    {
-        scope: "personalization.storage",
-        mapping: "personalization_storage",
-    },
+const MANUAL_CONSENT_MODE_CONDITION = [
     {
-        scope: "ads.storage",
-        mapping: "ad_storage",
+        paramName: "consentMode",
+        paramValue: "manual",
+        type: "EQUALS",
     },
+];
+const AUTOMATIC_CONSENT_MODE_CONDITION = [
     {
-        scope: "ads.user_data",
-        mapping: "ad_user_data",
+        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: "ads.personalization",
-        mapping: "ad_personalization",
+        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,
@@ -40,7 +51,45 @@ const buildGtmConsentTypeSelectItems = () => GTM_TEMPLATE_MAPPING_OPTIONS.map((o
     displayValue: `${option.label} Granted`,
 }));
 const trimTrailingSlash = (value) => value.endsWith("/") ? value.slice(0, -1) : value;
-export function buildGtmTemplateParameters() {
+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();
@@ -50,7 +99,7 @@ export function buildGtmTemplateParameters() {
             name: "apiKey",
             displayName: "API Key",
             simpleValueType: true,
-            help: "Find your API key in getuserfeedback.com under Settings → Widget.",
+            help: "Find your API key in getuserfeedback.com under Settings -> Widget.",
             valueValidators: [NON_EMPTY_VALIDATOR],
         },
         {
@@ -79,16 +128,16 @@ export function buildGtmTemplateParameters() {
                         },
                         {
                             value: "host",
-                            displayValue: "Sync With Host",
+                            displayValue: "Sync With Host Attributes",
                         },
                         {
                             value: "variable",
-                            displayValue: "Variable",
+                            displayValue: "Resolve From GTM Variable",
                         },
                     ],
                     simpleValueType: true,
                     defaultValue: "host",
-                    help: "Choose how the widget resolves `init.opts.colorScheme`.",
+                    help: "Generate protocol-valid `init.opts.colorScheme` using fixed modes, host auto-detect attributes, or a GTM variable.",
                 },
                 {
                     type: "SELECT",
@@ -113,7 +162,7 @@ export function buildGtmTemplateParameters() {
                     displayName: "Host Theme Attributes",
                     simpleValueType: true,
                     defaultValue: DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS.join(","),
-                    help: "Comma-separated attributes to inspect on `<html>` or `<body>` for host color scheme detection.",
+                    help: "Comma-separated attributes to inspect on `<html>` or `<body>` when syncing the widget to host theme state.",
                     enablingConditions: [
                         {
                             paramName: "themeMode",
@@ -138,17 +187,41 @@ export function buildGtmTemplateParameters() {
                         {
                             value: "automatic",
                             displayValue: "Automatic (Use GTM Consent Mode)",
-                            help: "Reads GTM Consent Mode and translates granted consent types into widget `defaultConsent`.",
+                            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 the public, host-configurable widget consent scopes with explicit GTM consent mappings.",
+                            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",
@@ -172,16 +245,10 @@ export function buildGtmTemplateParameters() {
                         },
                     ],
                     newRowButtonText: "Add Scope",
-                    help: `Configure public widget consent scopes. Essential scopes are fixed by the loader and are not exposed here.\n\n${scopeHelp}`,
-                    enablingConditions: [
-                        {
-                            paramName: "consentMode",
-                            paramValue: "manual",
-                            type: "EQUALS",
-                        },
-                    ],
+                    help: scopeHelp,
+                    enablingConditions: [...MANUAL_CONSENT_MODE_CONDITION],
                     valueValidators: [NON_EMPTY_VALIDATOR],
-                    defaultValue: buildDefaultTemplateScopeMappings().map((row) => ({
+                    defaultValue: buildHostConfigurableDefaultScopeMappings().map((row) => ({
                         scope: row.scope,
                         mapping: row.mapping,
                     })),
@@ -192,19 +259,21 @@ export function buildGtmTemplateParameters() {
 }
 export function buildGtmRuntimeSource(input) {
     const loaderScriptBaseUrl = trimTrailingSlash(input?.loaderScriptBaseUrl ?? DEFAULT_GTM_LOADER_SCRIPT_BASE_URL);
-    const defaultTemplateScopeMappings = buildDefaultTemplateScopeMappings();
+    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 encodeUriComponent = require("encodeUriComponent");
 
 const loaderScriptBaseUrl = ${JSON.stringify(loaderScriptBaseUrl)};
 const gtmConsentTypes = ${JSON.stringify(GTM_CONSENT_TYPES)};
 const defaultScopeMappings = ${JSON.stringify(defaultTemplateScopeMappings)};
-const hostConfigurableScopes = ${JSON.stringify(buildDefaultTemplateScopeMappings().map((row) => row.scope))};
+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() : "";
@@ -221,13 +290,13 @@ const normalizeAttrList = function(value) {
 		});
 };
 
-const normalizeThemeInput = function(input) {
-	if (input === undefined || input === null) {
+const normalizeThemeInput = function(inputValue) {
+	if (inputValue === undefined || inputValue === null) {
 		return undefined;
 	}
 
-	if (typeof input === "string") {
-		const normalized = input.trim().toLowerCase();
+	if (typeof inputValue === "string") {
+		const normalized = inputValue.trim().toLowerCase();
 		if (!normalized) {
 			return undefined;
 		}
@@ -243,30 +312,13 @@ const normalizeThemeInput = function(input) {
 				autoDetectColorScheme: defaultAutoDetectColorSchemeAttrs.slice(),
 			};
 		}
-		const attrs = normalizeAttrList(input);
+		const attrs = normalizeAttrList(inputValue);
 		return attrs.length > 0
 			? { autoDetectColorScheme: attrs }
 			: undefined;
 	}
 
-	if (!Array.isArray(input)) {
-		return undefined;
-	}
-
-	const attrs = input
-		.filter(function(value) {
-			return typeof value === "string";
-		})
-		.map(function(value) {
-			return value.trim();
-		})
-		.filter(function(value) {
-			return value.length > 0;
-		});
-
-	return attrs.length > 0
-		? { autoDetectColorScheme: attrs }
-		: undefined;
+	return undefined;
 };
 
 const getThemeInput = function(templateData) {
@@ -297,8 +349,48 @@ const getConsentState = function() {
 	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 isListLike = function(value) {
+	return (
+		!!value &&
+		typeof value.length === "number" &&
+		typeof value.map === "function"
+	);
+};
+
 const getManualScopeMappings = function(templateData) {
-	const rawRows = Array.isArray(templateData.scopeMappings)
+	const rawRows = isListLike(templateData.scopeMappings)
 		? templateData.scopeMappings
 		: [];
 	const rows = rawRows.length > 0 ? rawRows : defaultScopeMappings;
@@ -308,74 +400,95 @@ const getManualScopeMappings = function(templateData) {
 				return undefined;
 			}
 			const scope = trimString(row.scope);
-			const mapping = trimString(row.mapping);
-			if (!scope || !mapping) {
+			const consentType = trimString(row.mapping);
+			if (!scope || !consentType) {
 				return undefined;
 			}
-			return { scope: scope, consentType: mapping };
+			if (!isHostConfigurableScope(scope) || !isKnownConsentType(consentType)) {
+				return undefined;
+			}
+			return {
+				scope: scope,
+				consentType: consentType,
+			};
 		})
 		.filter(function(row) {
-			if (!row) {
-				return false;
-			}
-			let isHostConfigurableScope = false;
-			for (let scopeIndex = 0; scopeIndex < hostConfigurableScopes.length; scopeIndex += 1) {
-				if (hostConfigurableScopes[scopeIndex] === row.scope) {
-					isHostConfigurableScope = true;
-					break;
-				}
-			}
-			if (!isHostConfigurableScope) {
-				return false;
-			}
-			for (let index = 0; index < gtmConsentTypes.length; index += 1) {
-				if (gtmConsentTypes[index] === row.consentType) {
-					return true;
-				}
-			}
-			return false;
+			return row !== undefined;
 		});
 };
 
-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);
+const getAnalyticsMeasurementMode = function(templateData) {
+	if (
+		templateData.analyticsMeasurementMode === "granted" ||
+		templateData.analyticsMeasurementMode === "denied"
+	) {
+		return templateData.analyticsMeasurementMode;
 	}
-	return result;
+	return "inherit-analytics-storage";
 };
 
 const buildDefaultConsent = function(templateData) {
 	const consentState = getConsentState();
-	const scopeMappings =
-		templateData.consentMode === "manual"
-			? getManualScopeMappings(templateData)
-			: defaultScopeMappings;
 	const grantedScopes = [];
 
-	for (let index = 0; index < scopeMappings.length; index += 1) {
-		const mapping = scopeMappings[index];
-		const consentType = mapping.consentType || mapping.mapping;
-		if (consentState[consentType] === "granted") {
-			grantedScopes.push(mapping.scope);
+	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);
+			}
 		}
-	}
 
-	if (consentState.analytics_storage === "granted") {
-		grantedScopes.push("analytics.measurement");
+		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 encodedApiKey = encodeUriComponent(apiKey);
+if (!encodedApiKey) {
+	onFailure();
+	return;
+}
+
+const widgetUrl = loaderScriptBaseUrl + "/" + encodedApiKey + "/loader.js";
+const queuePush = createQueue(queueKey);
 const initOptions = {
 	apiKey: apiKey,
 	clientMeta: {
@@ -394,10 +507,6 @@ if (defaultConsent !== undefined) {
 	initOptions.defaultConsent = defaultConsent;
 }
 
-const widgetUrl =
-	loaderScriptBaseUrl + "/" + encodeURIComponent(apiKey) + "/loader.js";
-const queuePush = createQueue("__getuserfeedback_queue");
-
 queuePush({
 	kind: "init",
 	opts: initOptions,
@@ -405,18 +514,6 @@ queuePush({
 
 log("Loading getuserfeedback loader:", widgetUrl);
 
-const onSuccess = function() {
-	if (typeof data.gtmOnSuccess === "function") {
-		data.gtmOnSuccess();
-	}
-};
-
-const onFailure = function() {
-	if (typeof data.gtmOnFailure === "function") {
-		data.gtmOnFailure();
-	}
-};
-
 if (queryPermission("inject_script", widgetUrl)) {
 	injectScript(widgetUrl, onSuccess, onFailure, "getuserfeedback");
 } else {
@@ -424,9 +521,65 @@ if (queryPermission("inject_script", widgetUrl)) {
 }
 `.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 {
-        parameters: buildGtmTemplateParameters(),
+        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.3.0",
+  "version": "0.4.1",
   "description": "getuserfeedback integration adapters",
   "keywords": [
     "getuserfeedback",