@getuserfeedback/adapters 0.4.5 → 0.5.1

package/README.md

@@ -6,25 +6,20 @@
 
 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 color scheme normalization logic
 - GTM template parameter generation
 - GTM runtime source generation
 - GTM permission generation
+- GTM importable `template.tpl` file generation
 - GTM template defaults, help text, and option labels
 - the canonical loader script base URL pattern
 
 ### Public exports
 
-Core mappings:
+Template inputs and init translation:
 
 - `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)`
@@ -34,11 +29,7 @@ Types:
 - `GtmConsentType`
 - `GtmConsentValue`
 - `GtmConsentState`
-- `GtmScopeMapping`
-- `GtmAnalyticsMeasurementMode`
 - `GtmTemplateInput`
-- `GtmTemplateScopeOption`
-- `GtmTemplateMappingOption`
 
 Template generation:
 
@@ -49,29 +40,19 @@ Template generation:
 - `buildGtmTemplateInfo(options?)`
 - `buildGtmTemplateParts(options?)`
 - `buildGtmTemplateArtifact(options?)`
+- `buildGtmTemplateFileSource(options?)`
 
-### Essential scope policy
+### Consent behavior
 
-`functionality.storage` and `security.storage` are essential baseline scopes.
+The GTM template no longer exposes consent settings in its UI.
 
-- 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.
+- Default consent is derived automatically from Google Consent Mode state.
+- `analytics.measurement` follows `analytics.storage`.
+- If no GTM consent state is available, the adapter leaves `defaultConsent` unset.
 
-### Analytics measurement policy
+### Color scheme behavior
 
-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:
+Generated GTM color scheme support accepts:
 
 - fixed `light`
 - fixed `dark`
@@ -80,35 +61,56 @@ Generated GTM theme support accepts:
 - GTM variable-driven values
 - comma-separated auto-detect attribute lists
 
-The adapter normalizes all theme inputs into protocol-valid `colorScheme`.
+The adapter normalizes all of these into protocol-valid `colorScheme`.
 
-### Generate a GTM template artifact
+### Identity behavior
+
+The generated template supports:
+
+- `Intelligent` mode, which reads common data-layer keys for user ID, email, phone, first name, and last name
+- `Custom` mode, which lets GTM explicitly map a main identity and traits
+- `Disabled` mode, which skips identify entirely
+
+### Generate GTM output
 
 ```ts
-import { buildGtmTemplateArtifact } from "@getuserfeedback/adapters/gtm";
+import {
+	buildGtmTemplateArtifact,
+	buildGtmTemplateFileSource,
+} from "@getuserfeedback/adapters/gtm";
 
 const artifact = buildGtmTemplateArtifact({
 	loaderScriptBaseUrl: "https://cdn.getuserfeedback.com/widget/loader/v1",
 });
 
-artifact.info;
-artifact.parameters;
-artifact.runtimeSource;
-artifact.permissions;
+const templateFile = buildGtmTemplateFileSource({
+	loaderScriptBaseUrl: "https://cdn.getuserfeedback.com/widget/loader/v1",
+});
+```
+
+Use the package script to write a local importable file:
+
+```sh
+bun run generate:gtm-template
 ```
 
-The returned object is suitable for rendering into GTM `___INFO___`, `___TEMPLATE_PARAMETERS___`, `___SANDBOXED_JS_FOR_WEB_TEMPLATE___`, and `___WEB_PERMISSIONS___` sections.
+For the sandbox-backed GTM smoke:
+
+```sh
+bun run generate:gtm-template:sandbox-hybrid
+```
+
+`buildGtmTemplateArtifact()` returns the rendered GTM sections. `buildGtmTemplateFileSource()` returns a full importable `template.tpl`.
 
 ### 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.
+It should not rebuild parameters, runtime source, permissions, file assembly, or GTM-specific init payload translation.
 
 ### Customizing the loader base URL
 
@@ -118,9 +120,12 @@ Pass `loaderScriptBaseUrl` to:
 - `buildGtmPermissions`
 - `buildGtmTemplateParts`
 - `buildGtmTemplateArtifact`
+- `buildGtmTemplateFileSource`
 
 The same base URL is used to derive the runtime loader URL and the `inject_script` permission pattern.
 
+Pass `runtimeEndpoints` when you need the generated template to point loader bootstrap at non-default `core` and `api` endpoints.
+
 ### Versioning expectations
 
 Any change that affects generated GTM output is a public package change and should be versioned accordingly. This includes:
@@ -128,8 +133,8 @@ Any change that affects generated GTM output is a public package change and shou
 - parameter shape or defaults
 - runtime behavior
 - permission generation
-- default mappings
-- essential-scope exposure
-- analytics measurement behavior
+- color scheme normalization
+- identity lookup behavior
+- consent derivation behavior
 
 Release notes should call out template-affecting changes explicitly.

package/dist/gtm/core.d.ts

@@ -1,4 +1,4 @@
-import { type InitOptions, type Scope } from "@getuserfeedback/protocol";
+import { type InitOptions } from "@getuserfeedback/protocol";
 export declare const GTM_CONSENT_TYPES: readonly [
     "functionality_storage",
     "security_storage",
@@ -10,17 +10,10 @@ export declare const GTM_CONSENT_TYPES: readonly [
 ];
 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"];
@@ -28,31 +21,10 @@ export type GtmTemplateInput = {
     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

@@ -1 +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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/gtm/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,WAAW,EAEhB,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,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,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;AAQF,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;CAC/B,GAAG,WAAW,CAAC,gBAAgB,CAAC,GAAG,SAAS,CA0B5C;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,gBAAgB,GACrB,WAAW,CA4Bb"}

package/dist/gtm/core.js

@@ -1,4 +1,4 @@
-import { colorSchemeConfigInputSchema, consentConfigInputSchema, DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, listScopes, parseInitOptions, } from "@getuserfeedback/protocol";
+import { colorSchemeConfigInputSchema, consentConfigInputSchema, DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS, parseInitOptions, } from "@getuserfeedback/protocol";
 export const GTM_CONSENT_TYPES = [
     "functionality_storage",
     "security_storage",
@@ -8,67 +8,10 @@ export const GTM_CONSENT_TYPES = [
     "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;
@@ -119,27 +62,30 @@ export function resolveDefaultConsentFromGtm(input) {
     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");
+    const grantedScopes = [];
+    if (consentState.analytics_storage === "granted") {
+        grantedScopes.push("analytics.storage", "analytics.measurement");
+    }
+    if (consentState.personalization_storage === "granted") {
+        grantedScopes.push("personalization.storage");
+    }
+    if (consentState.ad_storage === "granted") {
+        grantedScopes.push("ads.storage");
+    }
+    if (consentState.ad_user_data === "granted") {
+        grantedScopes.push("ads.user_data");
     }
-    if (analyticsMeasurementMode === "inherit-analytics-storage" &&
-        consentState.analytics_storage === "granted") {
-        grantedScopes.push("analytics.measurement");
+    if (consentState.ad_personalization === "granted") {
+        grantedScopes.push("ads.personalization");
     }
-    const normalizedGrantedScopes = uniqueScopes(grantedScopes);
-    return normalizedGrantedScopes.length > 0
-        ? consentConfigInputSchema.parse(normalizedGrantedScopes)
+    return grantedScopes.length > 0
+        ? consentConfigInputSchema.parse(grantedScopes)
         : 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,

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 { 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";
+export { buildInitOptionsFromGtmTemplate, GTM_CONSENT_TYPES, type GtmConsentState, type GtmConsentType, type GtmConsentValue, type GtmTemplateInput, isGtmConsentType, normalizeGtmThemeInput, resolveDefaultConsentFromGtm, } from "./core.js";
+export { buildGtmPermissions, buildGtmRuntimeSource, buildGtmTemplateArtifact, buildGtmTemplateFileSource, buildGtmTemplateInfo, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, type GtmTemplateArtifact, type GtmTemplateFileInfoOverrides, type GtmTemplateFileOptions, 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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gtm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,GAC5B,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,EAClC,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC3B,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 { buildGtmPermissions, buildGtmRuntimeSource, buildGtmTemplateArtifact, buildGtmTemplateInfo, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, } from "./template-generation.js";
+export { buildInitOptionsFromGtmTemplate, GTM_CONSENT_TYPES, isGtmConsentType, normalizeGtmThemeInput, resolveDefaultConsentFromGtm, } from "./core.js";
+export { buildGtmPermissions, buildGtmRuntimeSource, buildGtmTemplateArtifact, buildGtmTemplateFileSource, buildGtmTemplateInfo, buildGtmTemplateParameters, buildGtmTemplateParts, DEFAULT_GTM_LOADER_SCRIPT_BASE_URL, } from "./template-generation.js";

package/dist/gtm/runtime-model.d.ts

@@ -0,0 +1,28 @@
+import type { PublicCommandPayload } from "@getuserfeedback/protocol";
+export declare const GTM_QUEUE_CLIENT_META: {
+    loader: string;
+    transport: string;
+};
+export declare const RESOLVE_GTM_THEME_INPUT_FROM_TEMPLATE_DATA_SOURCE = "function resolveGtmThemeInputFromTemplateData(templateData) {\n\tif (templateData.themeMode === \"variable\") {\n\t\treturn templateData.themeModeVariable;\n\t}\n\tif (templateData.themeMode === \"host\") {\n\t\treturn templateData.themeAttr;\n\t}\n\treturn templateData.themeMode === \"light\" ||\n\t\ttemplateData.themeMode === \"dark\" ||\n\t\ttemplateData.themeMode === \"system\"\n\t\t? templateData.themeMode\n\t\t: undefined;\n}";
+export declare const BUILD_GTM_IDENTIFY_COMMAND_SOURCE = "function buildGtmIdentifyCommand(input) {\n\tfunction normalizeTraitValue(value) {\n\t\tif (value === undefined || value === null) {\n\t\t\treturn undefined;\n\t\t}\n\t\tif (typeof value !== \"string\") {\n\t\t\treturn value;\n\t\t}\n\t\tconst trimmedValue = value.trim();\n\t\treturn trimmedValue.length > 0 ? trimmedValue : undefined;\n\t}\n\n\tfunction normalizeUserIdValue(value) {\n\t\tif (typeof value !== \"string\") {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst trimmedValue = value.trim();\n\t\treturn trimmedValue.length > 0 ? trimmedValue : undefined;\n\t}\n\n\tfunction addTrait(traits, name, value) {\n\t\tconst traitName = name.trim();\n\t\tconst traitValue = normalizeTraitValue(value);\n\t\tif (traitName.length === 0 || traitValue === undefined) {\n\t\t\treturn;\n\t\t}\n\t\ttraits[traitName] = traitValue;\n\t}\n\n\tfunction hasOwnKeys(value) {\n\t\tfor (const key in value) {\n\t\t\treturn key.length > 0;\n\t\t}\n\t\treturn false;\n\t}\n\n\tfunction buildFromUserIdAndTraits(userId, traits) {\n\t\tconst hasTraits = hasOwnKeys(traits);\n\t\tif (userId && hasTraits) {\n\t\t\treturn {\n\t\t\t\tkind: \"identify\",\n\t\t\t\tuserId: userId,\n\t\t\t\ttraits: traits,\n\t\t\t};\n\t\t}\n\t\tif (userId) {\n\t\t\treturn {\n\t\t\t\tkind: \"identify\",\n\t\t\t\tuserId: userId,\n\t\t\t};\n\t\t}\n\t\tif (hasTraits) {\n\t\t\treturn {\n\t\t\t\tkind: \"identify\",\n\t\t\t\ttraits: traits,\n\t\t\t};\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tif (input.mode === \"disabled\") {\n\t\treturn undefined;\n\t}\n\n\tif (input.mode === \"intelligent\") {\n\t\tconst traits = {};\n\t\taddTrait(traits, \"email\", input.email);\n\t\taddTrait(traits, \"firstName\", input.firstName);\n\t\taddTrait(traits, \"lastName\", input.lastName);\n\t\taddTrait(traits, \"phone\", input.phone);\n\t\treturn buildFromUserIdAndTraits(normalizeUserIdValue(input.userId), traits);\n\t}\n\n\tconst traits = {};\n\tif (input.traits && typeof input.traits === \"object\") {\n\t\tfor (const key in input.traits) {\n\t\t\ttraits[key] = input.traits[key];\n\t\t}\n\t}\n\tif (input.primaryIdentityType === \"userId\") {\n\t\treturn buildFromUserIdAndTraits(\n\t\t\tnormalizeUserIdValue(input.primaryIdentityValue),\n\t\t\ttraits,\n\t\t);\n\t}\n\n\tif (\n\t\tinput.primaryIdentityType === \"email\" ||\n\t\tinput.primaryIdentityType === \"phone\"\n\t) {\n\t\taddTrait(traits, input.primaryIdentityType, input.primaryIdentityValue);\n\t}\n\n\treturn hasOwnKeys(traits)\n\t\t? {\n\t\t\t\tkind: \"identify\",\n\t\t\t\ttraits: traits,\n\t\t\t}\n\t\t: undefined;\n}";
+export type GtmIdentifyCommand = Extract<PublicCommandPayload, {
+    kind: "identify";
+}>;
+export type GtmIdentifyCommandInput = {
+    mode: "advanced" | "intelligent" | "disabled";
+    userId?: unknown;
+    email?: unknown;
+    firstName?: unknown;
+    lastName?: unknown;
+    phone?: unknown;
+    primaryIdentityType?: unknown;
+    primaryIdentityValue?: unknown;
+    traits?: Record<string, unknown>;
+};
+export declare function resolveGtmThemeInputFromTemplateData(templateData: {
+    themeMode?: unknown;
+    themeModeVariable?: unknown;
+    themeAttr?: unknown;
+}): unknown;
+export declare function buildGtmIdentifyCommand(input: GtmIdentifyCommandInput): GtmIdentifyCommand | undefined;
+//# sourceMappingURL=runtime-model.d.ts.map

package/dist/gtm/runtime-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model.d.ts","sourceRoot":"","sources":["../../src/gtm/runtime-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;CAGjC,CAAC;AAEF,eAAO,MAAM,iDAAiD,wbAY5D,CAAC;AAEH,eAAO,MAAM,iCAAiC,y+EAmG5C,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACvC,oBAAoB,EACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,YAAY,EAAE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAYV;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,uBAAuB,GAC5B,kBAAkB,GAAG,SAAS,CA0GhC"}

package/dist/gtm/runtime-model.js

@@ -0,0 +1,216 @@
+export const GTM_QUEUE_CLIENT_META = {
+    loader: "gtm",
+    transport: "tag-manager",
+};
+export const RESOLVE_GTM_THEME_INPUT_FROM_TEMPLATE_DATA_SOURCE = `function resolveGtmThemeInputFromTemplateData(templateData) {
+	if (templateData.themeMode === "variable") {
+		return templateData.themeModeVariable;
+	}
+	if (templateData.themeMode === "host") {
+		return templateData.themeAttr;
+	}
+	return templateData.themeMode === "light" ||
+		templateData.themeMode === "dark" ||
+		templateData.themeMode === "system"
+		? templateData.themeMode
+		: undefined;
+}`;
+export const BUILD_GTM_IDENTIFY_COMMAND_SOURCE = `function buildGtmIdentifyCommand(input) {
+	function normalizeTraitValue(value) {
+		if (value === undefined || value === null) {
+			return undefined;
+		}
+		if (typeof value !== "string") {
+			return value;
+		}
+		const trimmedValue = value.trim();
+		return trimmedValue.length > 0 ? trimmedValue : undefined;
+	}
+
+	function normalizeUserIdValue(value) {
+		if (typeof value !== "string") {
+			return undefined;
+		}
+		const trimmedValue = value.trim();
+		return trimmedValue.length > 0 ? trimmedValue : undefined;
+	}
+
+	function addTrait(traits, name, value) {
+		const traitName = name.trim();
+		const traitValue = normalizeTraitValue(value);
+		if (traitName.length === 0 || traitValue === undefined) {
+			return;
+		}
+		traits[traitName] = traitValue;
+	}
+
+	function hasOwnKeys(value) {
+		for (const key in value) {
+			return key.length > 0;
+		}
+		return false;
+	}
+
+	function buildFromUserIdAndTraits(userId, traits) {
+		const hasTraits = hasOwnKeys(traits);
+		if (userId && hasTraits) {
+			return {
+				kind: "identify",
+				userId: userId,
+				traits: traits,
+			};
+		}
+		if (userId) {
+			return {
+				kind: "identify",
+				userId: userId,
+			};
+		}
+		if (hasTraits) {
+			return {
+				kind: "identify",
+				traits: traits,
+			};
+		}
+		return undefined;
+	}
+
+	if (input.mode === "disabled") {
+		return undefined;
+	}
+
+	if (input.mode === "intelligent") {
+		const traits = {};
+		addTrait(traits, "email", input.email);
+		addTrait(traits, "firstName", input.firstName);
+		addTrait(traits, "lastName", input.lastName);
+		addTrait(traits, "phone", input.phone);
+		return buildFromUserIdAndTraits(normalizeUserIdValue(input.userId), traits);
+	}
+
+	const traits = {};
+	if (input.traits && typeof input.traits === "object") {
+		for (const key in input.traits) {
+			traits[key] = input.traits[key];
+		}
+	}
+	if (input.primaryIdentityType === "userId") {
+		return buildFromUserIdAndTraits(
+			normalizeUserIdValue(input.primaryIdentityValue),
+			traits,
+		);
+	}
+
+	if (
+		input.primaryIdentityType === "email" ||
+		input.primaryIdentityType === "phone"
+	) {
+		addTrait(traits, input.primaryIdentityType, input.primaryIdentityValue);
+	}
+
+	return hasOwnKeys(traits)
+		? {
+				kind: "identify",
+				traits: traits,
+			}
+		: undefined;
+}`;
+export function resolveGtmThemeInputFromTemplateData(templateData) {
+    if (templateData.themeMode === "variable") {
+        return templateData.themeModeVariable;
+    }
+    if (templateData.themeMode === "host") {
+        return templateData.themeAttr;
+    }
+    return templateData.themeMode === "light" ||
+        templateData.themeMode === "dark" ||
+        templateData.themeMode === "system"
+        ? templateData.themeMode
+        : undefined;
+}
+export function buildGtmIdentifyCommand(input) {
+    function normalizeTraitValue(value) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
+        if (typeof value !== "string") {
+            return value;
+        }
+        const trimmedValue = value.trim();
+        return trimmedValue.length > 0 ? trimmedValue : undefined;
+    }
+    function normalizeUserIdValue(value) {
+        if (typeof value !== "string") {
+            return undefined;
+        }
+        const trimmedValue = value.trim();
+        return trimmedValue.length > 0 ? trimmedValue : undefined;
+    }
+    function addTrait(traits, name, value) {
+        const traitName = name.trim();
+        const traitValue = normalizeTraitValue(value);
+        if (traitName.length === 0 || traitValue === undefined) {
+            return;
+        }
+        traits[traitName] = traitValue;
+    }
+    function hasOwnKeys(value) {
+        for (const key in value) {
+            return key.length > 0;
+        }
+        return false;
+    }
+    function buildFromUserIdAndTraits(userId, traits) {
+        const hasTraits = hasOwnKeys(traits);
+        if (userId && hasTraits) {
+            return {
+                kind: "identify",
+                userId,
+                traits,
+            };
+        }
+        if (userId) {
+            return {
+                kind: "identify",
+                userId,
+            };
+        }
+        if (hasTraits) {
+            return {
+                kind: "identify",
+                traits,
+            };
+        }
+        return undefined;
+    }
+    if (input.mode === "disabled") {
+        return undefined;
+    }
+    if (input.mode === "intelligent") {
+        const traits = {};
+        addTrait(traits, "email", input.email);
+        addTrait(traits, "firstName", input.firstName);
+        addTrait(traits, "lastName", input.lastName);
+        addTrait(traits, "phone", input.phone);
+        return buildFromUserIdAndTraits(normalizeUserIdValue(input.userId), traits);
+    }
+    const traits = {};
+    if (input.traits && typeof input.traits === "object") {
+        for (const key in input.traits) {
+            traits[key] = input.traits[key];
+        }
+    }
+    if (input.primaryIdentityType === "userId") {
+        return buildFromUserIdAndTraits(normalizeUserIdValue(input.primaryIdentityValue), traits);
+    }
+    if (input.primaryIdentityType === "email" ||
+        input.primaryIdentityType === "phone") {
+        addTrait(traits, input.primaryIdentityType, input.primaryIdentityValue);
+    }
+    return hasOwnKeys(traits)
+        ? {
+            kind: "identify",
+            traits,
+        }
+        : undefined;
+}

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

@@ -120,8 +120,29 @@ export type GtmTemplateParts = {
     permissions: GtmTemplatePermission[];
 };
 export type GtmTemplateArtifact = GtmTemplateParts;
+export type GtmTemplateFileInfoOverrides = {
+    id?: string;
+    securityGroups?: ReadonlyArray<string>;
+    brandDisplayName?: string;
+    brandThumbnail?: string;
+    categories?: ReadonlyArray<string>;
+    displayName?: string;
+    description?: string;
+};
+export type GtmTemplateFileOptions = GtmTemplateGenerationOptions & {
+    includeUtf8Bom?: boolean;
+    infoOverrides?: GtmTemplateFileInfoOverrides;
+    termsOfService?: string;
+    tests?: string;
+    notes?: string;
+};
 export type GtmTemplateGenerationOptions = {
+    additionalLoaderScriptUrlPatterns?: string[];
     loaderScriptBaseUrl?: string;
+    runtimeEndpoints?: {
+        apiUrl: string;
+        coreUrl: string;
+    };
     displayName?: string;
     description?: string;
 };
@@ -132,5 +153,6 @@ export declare function buildGtmPermissions(input?: GtmTemplateGenerationOptions
 export declare function buildGtmTemplateInfo(input?: GtmTemplateGenerationOptions): GtmTemplateInfo;
 export declare function buildGtmTemplateParts(input?: GtmTemplateGenerationOptions): GtmTemplateParts;
 export declare function buildGtmTemplateArtifact(input?: GtmTemplateGenerationOptions): GtmTemplateArtifact;
+export declare function buildGtmTemplateFileSource(input?: GtmTemplateFileOptions): string;
 export {};
 //# sourceMappingURL=template-generation.d.ts.map