unlayer-types 1.508.0 → 1.510.0

package/embed.d.ts

@@ -1891,8 +1891,46 @@ declare module "packages/editor/src/state/types/types" {
         id?: string | number;
         name?: string | null | undefined;
         avatar?: string | null | undefined;
-        email?: string;
+        email?: string | null;
         signature?: string;
+        /**
+         * Signed feature policy generated on your server. Supersedes `signature`: it
+         * covers the same user id and additionally carries the features this
+         * particular end user may use.
+         *
+         * Build it with your project secret, never in the browser:
+         *
+         * ```js
+         * const claims  = { id, exp, features: { ai: { fullTemplateGeneration: false } } };
+         * const payload = Buffer.from(JSON.stringify(claims)).toString('base64url');
+         * const salt    = 'unlayer:end-user-policy-token:v1:salt';
+         * const info    = 'unlayer:end-user-policy-token:v1:signing-key';
+         * const key     = Buffer.from(hkdfSync('sha256', SECRET, salt, info, 32));
+         * const signed  = `v1.${payload}`;
+         * const token   = `${signed}.${createHmac('sha256', key).update(signed).digest('hex')}`;
+         * ```
+         *
+         * `features` accepts the boolean feature-flag portion of
+         * `unlayer.init({ features })`: objects are containers and every leaf must be
+         * `true` or `false`. It can only restrict; a policy cannot grant a feature
+         * the project's plan excludes.
+         */
+        featurePolicyToken?: string | null;
+        /**
+         * Your own fields. Anything beyond the properties above is stored with the
+         * end user and returned on the next session, merged into what is already
+         * stored — so a field you stop sending keeps its last value. Unlayer never
+         * interprets them.
+         *
+         * Reserved names are dropped here: the credentials above, plus `projectId`,
+         * `customId`, `consoleAttestation`, `entitlements`, `featurePolicy`,
+         * `policyExp`, `featurePolicyVerified`, `legacySignatureVerified`,
+         * `consoleSession`, `_consoleSession`, `_consoleSessionId`,
+         * `_consoleSessionProof`, `_consoleUserId`, `consoleContextVerified`,
+         * `consoleSessionExp`, `consoleSessionId`, `consoleUserId`, and
+         * `consoleSessionProof`. Prefer names specific to your application.
+         */
+        [field: string]: unknown;
     };
     export type Language = {
         label: string;
@@ -2583,6 +2621,14 @@ declare module "packages/editor/src/engine/config/features" {
         deepmerge?: boolean;
     }): void;
     export function getFeatures(): Features;
+    /**
+     * Applies the verified feature policy returned with the editor session.
+     *
+     * Callers pass an init-shaped object of denials (`toDeniedFeatures`), not the
+     * flattened policy the JWT carries.
+     */
+    export function setFeaturePolicy(deniedFeatures: Features): void;
+    export function getFeaturePolicy(): Features;
     export function getFeature<Path extends keyof Features | [keyof Features, ...string[]] | (string & {})>(path: Path): Path extends keyof Features ? Features[Path] : any;
     export function normalizeFeatureAsObject<Object extends Record<string, any>, Feature extends boolean | Object>(feature: Feature | undefined): Partial<Feature & object>;
     export function getFeatureAsObject<Path extends keyof Features | [keyof Features, ...string[]] | (string & {})>(path: Path): Partial<(Path extends keyof Features ? Features[Path] : any) & object>;
@@ -3303,6 +3349,12 @@ declare module "packages/editor/src/engine/config/tools" {
         validator?: string;
         hidden?: boolean;
     };
+    /**
+     * The validator a tool override (`unlayer.init({ tools: { image: { validator } } })`)
+     * supplies for `id`, or `undefined` when there is none or the plan does not
+     * include custom audit validators — see `canRunEmbedderValidators`.
+     */
+    export function getOverrideToolValidator(id: string): string;
     export function isRowToolEnabled(): boolean;
     export function getTool(toolItem: ToolItem): ToolConfig<ValueMap, Validator>;
     /**

package/package.json

@@ -1,5 +1,5 @@
 {
   "name": "unlayer-types",
-  "version": "1.508.0",
+  "version": "1.510.0",
   "license": "MIT"
 }