@wix/blog 1.0.305 → 1.0.307

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/blog",
-  "version": "1.0.305",
+  "version": "1.0.307",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -18,12 +18,12 @@
     "type-bundles"
   ],
   "dependencies": {
-    "@wix/blog_blog-cache": "1.0.5",
-    "@wix/blog_blog-importer": "1.0.16",
-    "@wix/blog_categories": "1.0.42",
-    "@wix/blog_draft-posts": "1.0.42",
-    "@wix/blog_posts": "1.0.49",
-    "@wix/blog_tags": "1.0.40"
+    "@wix/blog_blog-cache": "1.0.6",
+    "@wix/blog_blog-importer": "1.0.17",
+    "@wix/blog_categories": "1.0.44",
+    "@wix/blog_draft-posts": "1.0.44",
+    "@wix/blog_posts": "1.0.50",
+    "@wix/blog_tags": "1.0.42"
   },
   "devDependencies": {
     "glob": "^10.4.1",
@@ -48,5 +48,5 @@
       "fqdn": ""
     }
   },
-  "falconPackageHash": "084449baad1b18bbd0cc1334e72c80ee31af06417f374be10561727a"
+  "falconPackageHash": "e61700ba7fc994882ee2caeb6f386c95f3a373c0ba2fd11fb028fb26"
 }

package/type-bundles/context.bundle.d.ts

@@ -12,6 +12,10 @@ type Host<Environment = unknown> = {
         }>;
     };
     environment?: Environment;
+    /**
+     * Optional name of the environment, use for logging
+     */
+    name?: string;
     /**
      * Optional bast url to use for API requests, for example `www.wixapis.com`
      */
@@ -63,16 +67,16 @@ type APIMetadata = {
     packageName?: string;
 };
 type BuildRESTFunction<T extends RESTFunctionDescriptor> = T extends RESTFunctionDescriptor<infer U> ? U : never;
-type EventDefinition$4<Payload = unknown, Type extends string = string> = {
+type EventDefinition<Payload = unknown, Type extends string = string> = {
     __type: 'event-definition';
     type: Type;
     isDomainEvent?: boolean;
     transformations?: (envelope: unknown) => Payload;
     __payload: Payload;
 };
-declare function EventDefinition$4<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$4<Payload, Type>;
-type EventHandler$4<T extends EventDefinition$4> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$4<T extends EventDefinition$4<any, string>> = (handler: EventHandler$4<T>) => void;
+declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
+type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
+type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
 
 type ServicePluginMethodInput = {
     request: any;
@@ -271,6 +275,72 @@ type Except<ObjectType, KeysType extends keyof ObjectType, Options extends Excep
 	? Partial<Record<KeysType, never>>
 	: {});
 
+/**
+Returns a boolean for whether the given type is `never`.
+
+@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
+@link https://stackoverflow.com/a/53984913/10292952
+@link https://www.zhenghao.io/posts/ts-never
+
+Useful in type utilities, such as checking if something does not occur.
+
+@example
+```
+import type {IsNever, And} from 'type-fest';
+
+// https://github.com/andnp/SimplyTyped/blob/master/src/types/strings.ts
+type AreStringsEqual<A extends string, B extends string> =
+	And<
+		IsNever<Exclude<A, B>> extends true ? true : false,
+		IsNever<Exclude<B, A>> extends true ? true : false
+	>;
+
+type EndIfEqual<I extends string, O extends string> =
+	AreStringsEqual<I, O> extends true
+		? never
+		: void;
+
+function endIfEqual<I extends string, O extends string>(input: I, output: O): EndIfEqual<I, O> {
+	if (input === output) {
+		process.exit(0);
+	}
+}
+
+endIfEqual('abc', 'abc');
+//=> never
+
+endIfEqual('abc', '123');
+//=> void
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsNever<T> = [T] extends [never] ? true : false;
+
+/**
+An if-else-like type that resolves depending on whether the given type is `never`.
+
+@see {@link IsNever}
+
+@example
+```
+import type {IfNever} from 'type-fest';
+
+type ShouldBeTrue = IfNever<never>;
+//=> true
+
+type ShouldBeBar = IfNever<'not never', 'foo', 'bar'>;
+//=> 'bar'
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IfNever<T, TypeIfNever = true, TypeIfNotNever = false> = (
+	IsNever<T> extends true ? TypeIfNever : TypeIfNotNever
+);
+
 /**
 Extract the keys from a type where the value type of the key extends the given `Condition`.
 
@@ -303,21 +373,19 @@ type StringKeysAndUndefined = ConditionalKeys<Example, string | undefined>;
 
 @category Object
 */
-type ConditionalKeys<Base, Condition> = NonNullable<
-// Wrap in `NonNullable` to strip away the `undefined` type from the produced union.
+type ConditionalKeys<Base, Condition> =
 {
 	// Map through all the keys of the given base type.
-	[Key in keyof Base]:
+	[Key in keyof Base]-?:
 	// Pick only keys with types extending the given `Condition` type.
 	Base[Key] extends Condition
-	// Retain this key since the condition passes.
-		? Key
+	// Retain this key
+	// If the value for the key extends never, only include it if `Condition` also extends never
+		? IfNever<Base[Key], IfNever<Condition, Key, never>, Key>
 	// Discard this key since the condition fails.
 		: never;
-
 	// Convert the produced object into a union type of the keys which passed the conditional test.
-}[keyof Base]
->;
+}[keyof Base];
 
 /**
 Exclude keys from a shape that matches the given `Condition`.
@@ -367,7 +435,7 @@ ConditionalKeys<Base, Condition>
  * can either be a REST module or a host module.
  * This type is recursive, so it can describe nested modules.
  */
-type Descriptors = RESTFunctionDescriptor | AmbassadorFunctionDescriptor | HostModule<any, any> | EventDefinition$4<any> | ServicePluginDefinition<any> | {
+type Descriptors = RESTFunctionDescriptor | AmbassadorFunctionDescriptor | HostModule<any, any> | EventDefinition<any> | ServicePluginDefinition<any> | {
     [key: string]: Descriptors | PublicMetadata | any;
 };
 /**
@@ -380,7 +448,7 @@ type BuildDescriptors<T extends Descriptors, H extends Host<any> | undefined, De
     done: T;
     recurse: T extends {
         __type: typeof SERVICE_PLUGIN_ERROR_TYPE;
-    } ? never : T extends AmbassadorFunctionDescriptor ? BuildAmbassadorFunction<T> : T extends RESTFunctionDescriptor ? BuildRESTFunction<T> : T extends EventDefinition$4<any> ? BuildEventDefinition$4<T> : T extends ServicePluginDefinition<any> ? BuildServicePluginDefinition<T> : T extends HostModule<any, any> ? HostModuleAPI<T> : ConditionalExcept<{
+    } ? never : T extends AmbassadorFunctionDescriptor ? BuildAmbassadorFunction<T> : T extends RESTFunctionDescriptor ? BuildRESTFunction<T> : T extends EventDefinition<any> ? BuildEventDefinition<T> : T extends ServicePluginDefinition<any> ? BuildServicePluginDefinition<T> : T extends HostModule<any, any> ? HostModuleAPI<T> : ConditionalExcept<{
         [Key in keyof T]: T[Key] extends Descriptors ? BuildDescriptors<T[Key], H, [
             -1,
             0,
@@ -1422,7 +1490,7 @@ interface Keyword$3 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$3 {
@@ -1492,9 +1560,7 @@ declare enum Field$3 {
      */
     INTERNAL_ID = "INTERNAL_ID",
     /** Includes SEO data. */
-    SEO = "SEO",
-    /** Includes translations. */
-    TRANSLATIONS = "TRANSLATIONS"
+    SEO = "SEO"
 }
 interface CreateCategoryResponse {
     /** Category info. */
@@ -2154,29 +2220,11 @@ interface QueryCategoriesSignature {
      */
     (options?: QueryCategoriesOptions | undefined): CategoriesQueryBuilder;
 }
-declare const onCategoryCreated$1: EventDefinition$4<CategoryCreatedEnvelope, "wix.blog.v3.category_created">;
-declare const onCategoryUpdated$1: EventDefinition$4<CategoryUpdatedEnvelope, "wix.blog.v3.category_updated">;
-declare const onCategoryDeleted$1: EventDefinition$4<CategoryDeletedEnvelope, "wix.blog.v3.category_deleted">;
-
-type EventDefinition$3<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$3<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$3<Payload, Type>;
-type EventHandler$3<T extends EventDefinition$3> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$3<T extends EventDefinition$3<any, string>> = (handler: EventHandler$3<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
+declare const onCategoryCreated$1: EventDefinition<CategoryCreatedEnvelope, "wix.blog.v3.category_created">;
+declare const onCategoryUpdated$1: EventDefinition<CategoryUpdatedEnvelope, "wix.blog.v3.category_updated">;
+declare const onCategoryDeleted$1: EventDefinition<CategoryDeletedEnvelope, "wix.blog.v3.category_deleted">;
 
-declare function createEventModule$3<T extends EventDefinition$3<any, string>>(eventDefinition: T): BuildEventDefinition$3<T> & T;
+declare function createEventModule$3<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 
 declare const getCategory: MaybeContext<BuildRESTFunction<typeof getCategory$1> & typeof getCategory$1>;
 declare const getCategoryBySlug: MaybeContext<BuildRESTFunction<typeof getCategoryBySlug$1> & typeof getCategoryBySlug$1>;
@@ -3769,7 +3817,7 @@ interface Keyword$2 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$2 {
@@ -3920,8 +3968,6 @@ declare enum Field$2 {
     CONTENT = "CONTENT",
     /** Includes rich content field. */
     RICH_CONTENT = "RICH_CONTENT",
-    /** Includes draft post translations when present. */
-    TRANSLATIONS = "TRANSLATIONS",
     /** If the user has not set excerpt, returns the one autogenerated from content. */
     GENERATED_EXCERPT = "GENERATED_EXCERPT"
 }
@@ -5713,29 +5759,11 @@ interface PublishDraftPostSignature {
      */
     (draftPostId: string): Promise<PublishDraftPostResponse & PublishDraftPostResponseNonNullableFields>;
 }
-declare const onDraftCreated$1: EventDefinition$4<DraftCreatedEnvelope, "wix.blog.v3.draft_created">;
-declare const onDraftUpdated$1: EventDefinition$4<DraftUpdatedEnvelope, "wix.blog.v3.draft_updated">;
-declare const onDraftDeleted$1: EventDefinition$4<DraftDeletedEnvelope, "wix.blog.v3.draft_deleted">;
+declare const onDraftCreated$1: EventDefinition<DraftCreatedEnvelope, "wix.blog.v3.draft_created">;
+declare const onDraftUpdated$1: EventDefinition<DraftUpdatedEnvelope, "wix.blog.v3.draft_updated">;
+declare const onDraftDeleted$1: EventDefinition<DraftDeletedEnvelope, "wix.blog.v3.draft_deleted">;
 
-type EventDefinition$2<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$2<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$2<Payload, Type>;
-type EventHandler$2<T extends EventDefinition$2> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$2<T extends EventDefinition$2<any, string>> = (handler: EventHandler$2<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
-declare function createEventModule$2<T extends EventDefinition$2<any, string>>(eventDefinition: T): BuildEventDefinition$2<T> & T;
+declare function createEventModule$2<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 
 declare const createDraftPost: MaybeContext<BuildRESTFunction<typeof createDraftPost$1> & typeof createDraftPost$1>;
 declare const bulkCreateDraftPosts: MaybeContext<BuildRESTFunction<typeof bulkCreateDraftPosts$1> & typeof bulkCreateDraftPosts$1>;
@@ -7685,9 +7713,7 @@ declare enum GetPostsSort {
     /** Sorting by title ascending */
     TITLE_ASC = "TITLE_ASC",
     /** Sorting by title descending */
-    TITLE_DESC = "TITLE_DESC",
-    /** Sorting by post rating descending. */
-    RATING = "RATING"
+    TITLE_DESC = "TITLE_DESC"
 }
 interface BlogPaging {
     /**
@@ -7709,8 +7735,6 @@ interface BlogPaging {
 }
 declare enum PostFieldField {
     UNKNOWN = "UNKNOWN",
-    /** Deprecated use `METRICS` instead */
-    COUNTERS = "COUNTERS",
     /** Includes Post url when present */
     URL = "URL",
     /** Includes Post content text string when present */
@@ -7719,26 +7743,10 @@ declare enum PostFieldField {
     METRICS = "METRICS",
     /** Includes SEO data */
     SEO = "SEO",
-    /**
-     * Includes Post content as a stringified DraftJS document
-     * Reserved for internal use
-     */
-    CONTENT = "CONTENT",
-    /**
-     * Includes internal id field
-     * Reserved for internal use
-     */
-    INTERNAL_ID = "INTERNAL_ID",
     /** Includes post owners Contact Id */
     CONTACT_ID = "CONTACT_ID",
     /** Includes post rich content */
-    RICH_CONTENT = "RICH_CONTENT",
-    /** Includes post rich content string */
-    RICH_CONTENT_STRING = "RICH_CONTENT_STRING",
-    /** Includes compressed post rich content string */
-    RICH_CONTENT_COMPRESSED = "RICH_CONTENT_COMPRESSED",
-    /** Includes post translations */
-    TRANSLATIONS = "TRANSLATIONS"
+    RICH_CONTENT = "RICH_CONTENT"
 }
 interface ListDemoPostsResponse {
     /** List of posts. */
@@ -9486,31 +9494,13 @@ interface GetTotalPostsSignature {
      */
     (options?: GetTotalPostsOptions | undefined): Promise<GetTotalPostsResponse & GetTotalPostsResponseNonNullableFields>;
 }
-declare const onPostCreated$1: EventDefinition$4<PostCreatedEnvelope, "wix.blog.v3.post_created">;
-declare const onPostUpdated$1: EventDefinition$4<PostUpdatedEnvelope, "wix.blog.v3.post_updated">;
-declare const onPostDeleted$1: EventDefinition$4<PostDeletedEnvelope, "wix.blog.v3.post_deleted">;
-declare const onPostLiked$1: EventDefinition$4<PostLikedEnvelope, "wix.blog.v3.post_liked">;
-declare const onPostUnliked$1: EventDefinition$4<PostUnlikedEnvelope, "wix.blog.v3.post_unliked">;
-
-type EventDefinition$1<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$1<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$1<Payload, Type>;
-type EventHandler$1<T extends EventDefinition$1> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$1<T extends EventDefinition$1<any, string>> = (handler: EventHandler$1<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
+declare const onPostCreated$1: EventDefinition<PostCreatedEnvelope, "wix.blog.v3.post_created">;
+declare const onPostUpdated$1: EventDefinition<PostUpdatedEnvelope, "wix.blog.v3.post_updated">;
+declare const onPostDeleted$1: EventDefinition<PostDeletedEnvelope, "wix.blog.v3.post_deleted">;
+declare const onPostLiked$1: EventDefinition<PostLikedEnvelope, "wix.blog.v3.post_liked">;
+declare const onPostUnliked$1: EventDefinition<PostUnlikedEnvelope, "wix.blog.v3.post_unliked">;
 
-declare function createEventModule$1<T extends EventDefinition$1<any, string>>(eventDefinition: T): BuildEventDefinition$1<T> & T;
+declare function createEventModule$1<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 
 declare const getPost: MaybeContext<BuildRESTFunction<typeof getPost$1> & typeof getPost$1>;
 declare const getPostBySlug: MaybeContext<BuildRESTFunction<typeof getPostBySlug$1> & typeof getPostBySlug$1>;
@@ -9910,7 +9900,7 @@ interface Keyword {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag {
@@ -9965,9 +9955,7 @@ interface GetOrCreateTagRequest {
 declare enum Field {
     UNKNOWN = "UNKNOWN",
     /** Includes Tag URL when present. */
-    URL = "URL",
-    /** Includes SEO data. */
-    SEO = "SEO"
+    URL = "URL"
 }
 interface GetOrCreateTagResponse {
     /** Tag info. */
@@ -10842,27 +10830,9 @@ interface DeleteTagSignature {
      */
     (tagId: string): Promise<void>;
 }
-declare const onTagCreated$1: EventDefinition$4<TagCreatedEnvelope, "wix.blog.v3.tag_created">;
-declare const onTagUpdated$1: EventDefinition$4<TagUpdatedEnvelope, "wix.blog.v3.tag_updated">;
-declare const onTagDeleted$1: EventDefinition$4<TagDeletedEnvelope, "wix.blog.v3.tag_deleted">;
-
-type EventDefinition<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
-type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
+declare const onTagCreated$1: EventDefinition<TagCreatedEnvelope, "wix.blog.v3.tag_created">;
+declare const onTagUpdated$1: EventDefinition<TagUpdatedEnvelope, "wix.blog.v3.tag_updated">;
+declare const onTagDeleted$1: EventDefinition<TagDeletedEnvelope, "wix.blog.v3.tag_deleted">;
 
 declare function createEventModule<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 

package/type-bundles/index.bundle.d.ts

@@ -12,6 +12,10 @@ type Host<Environment = unknown> = {
         }>;
     };
     environment?: Environment;
+    /**
+     * Optional name of the environment, use for logging
+     */
+    name?: string;
     /**
      * Optional bast url to use for API requests, for example `www.wixapis.com`
      */
@@ -63,16 +67,16 @@ type APIMetadata = {
     packageName?: string;
 };
 type BuildRESTFunction<T extends RESTFunctionDescriptor> = T extends RESTFunctionDescriptor<infer U> ? U : never;
-type EventDefinition$4<Payload = unknown, Type extends string = string> = {
+type EventDefinition<Payload = unknown, Type extends string = string> = {
     __type: 'event-definition';
     type: Type;
     isDomainEvent?: boolean;
     transformations?: (envelope: unknown) => Payload;
     __payload: Payload;
 };
-declare function EventDefinition$4<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$4<Payload, Type>;
-type EventHandler$4<T extends EventDefinition$4> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$4<T extends EventDefinition$4<any, string>> = (handler: EventHandler$4<T>) => void;
+declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
+type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
+type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
 
 type ServicePluginMethodInput = {
     request: any;
@@ -271,6 +275,72 @@ type Except<ObjectType, KeysType extends keyof ObjectType, Options extends Excep
 	? Partial<Record<KeysType, never>>
 	: {});
 
+/**
+Returns a boolean for whether the given type is `never`.
+
+@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
+@link https://stackoverflow.com/a/53984913/10292952
+@link https://www.zhenghao.io/posts/ts-never
+
+Useful in type utilities, such as checking if something does not occur.
+
+@example
+```
+import type {IsNever, And} from 'type-fest';
+
+// https://github.com/andnp/SimplyTyped/blob/master/src/types/strings.ts
+type AreStringsEqual<A extends string, B extends string> =
+	And<
+		IsNever<Exclude<A, B>> extends true ? true : false,
+		IsNever<Exclude<B, A>> extends true ? true : false
+	>;
+
+type EndIfEqual<I extends string, O extends string> =
+	AreStringsEqual<I, O> extends true
+		? never
+		: void;
+
+function endIfEqual<I extends string, O extends string>(input: I, output: O): EndIfEqual<I, O> {
+	if (input === output) {
+		process.exit(0);
+	}
+}
+
+endIfEqual('abc', 'abc');
+//=> never
+
+endIfEqual('abc', '123');
+//=> void
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsNever<T> = [T] extends [never] ? true : false;
+
+/**
+An if-else-like type that resolves depending on whether the given type is `never`.
+
+@see {@link IsNever}
+
+@example
+```
+import type {IfNever} from 'type-fest';
+
+type ShouldBeTrue = IfNever<never>;
+//=> true
+
+type ShouldBeBar = IfNever<'not never', 'foo', 'bar'>;
+//=> 'bar'
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IfNever<T, TypeIfNever = true, TypeIfNotNever = false> = (
+	IsNever<T> extends true ? TypeIfNever : TypeIfNotNever
+);
+
 /**
 Extract the keys from a type where the value type of the key extends the given `Condition`.
 
@@ -303,21 +373,19 @@ type StringKeysAndUndefined = ConditionalKeys<Example, string | undefined>;
 
 @category Object
 */
-type ConditionalKeys<Base, Condition> = NonNullable<
-// Wrap in `NonNullable` to strip away the `undefined` type from the produced union.
+type ConditionalKeys<Base, Condition> =
 {
 	// Map through all the keys of the given base type.
-	[Key in keyof Base]:
+	[Key in keyof Base]-?:
 	// Pick only keys with types extending the given `Condition` type.
 	Base[Key] extends Condition
-	// Retain this key since the condition passes.
-		? Key
+	// Retain this key
+	// If the value for the key extends never, only include it if `Condition` also extends never
+		? IfNever<Base[Key], IfNever<Condition, Key, never>, Key>
 	// Discard this key since the condition fails.
 		: never;
-
 	// Convert the produced object into a union type of the keys which passed the conditional test.
-}[keyof Base]
->;
+}[keyof Base];
 
 /**
 Exclude keys from a shape that matches the given `Condition`.
@@ -367,7 +435,7 @@ ConditionalKeys<Base, Condition>
  * can either be a REST module or a host module.
  * This type is recursive, so it can describe nested modules.
  */
-type Descriptors = RESTFunctionDescriptor | AmbassadorFunctionDescriptor | HostModule<any, any> | EventDefinition$4<any> | ServicePluginDefinition<any> | {
+type Descriptors = RESTFunctionDescriptor | AmbassadorFunctionDescriptor | HostModule<any, any> | EventDefinition<any> | ServicePluginDefinition<any> | {
     [key: string]: Descriptors | PublicMetadata | any;
 };
 /**
@@ -380,7 +448,7 @@ type BuildDescriptors<T extends Descriptors, H extends Host<any> | undefined, De
     done: T;
     recurse: T extends {
         __type: typeof SERVICE_PLUGIN_ERROR_TYPE;
-    } ? never : T extends AmbassadorFunctionDescriptor ? BuildAmbassadorFunction<T> : T extends RESTFunctionDescriptor ? BuildRESTFunction<T> : T extends EventDefinition$4<any> ? BuildEventDefinition$4<T> : T extends ServicePluginDefinition<any> ? BuildServicePluginDefinition<T> : T extends HostModule<any, any> ? HostModuleAPI<T> : ConditionalExcept<{
+    } ? never : T extends AmbassadorFunctionDescriptor ? BuildAmbassadorFunction<T> : T extends RESTFunctionDescriptor ? BuildRESTFunction<T> : T extends EventDefinition<any> ? BuildEventDefinition<T> : T extends ServicePluginDefinition<any> ? BuildServicePluginDefinition<T> : T extends HostModule<any, any> ? HostModuleAPI<T> : ConditionalExcept<{
         [Key in keyof T]: T[Key] extends Descriptors ? BuildDescriptors<T[Key], H, [
             -1,
             0,
@@ -1422,7 +1490,7 @@ interface Keyword$3 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$3 {
@@ -1492,9 +1560,7 @@ declare enum Field$3 {
      */
     INTERNAL_ID = "INTERNAL_ID",
     /** Includes SEO data. */
-    SEO = "SEO",
-    /** Includes translations. */
-    TRANSLATIONS = "TRANSLATIONS"
+    SEO = "SEO"
 }
 interface CreateCategoryResponse {
     /** Category info. */
@@ -2154,29 +2220,11 @@ interface QueryCategoriesSignature {
      */
     (options?: QueryCategoriesOptions | undefined): CategoriesQueryBuilder;
 }
-declare const onCategoryCreated$1: EventDefinition$4<CategoryCreatedEnvelope, "wix.blog.v3.category_created">;
-declare const onCategoryUpdated$1: EventDefinition$4<CategoryUpdatedEnvelope, "wix.blog.v3.category_updated">;
-declare const onCategoryDeleted$1: EventDefinition$4<CategoryDeletedEnvelope, "wix.blog.v3.category_deleted">;
-
-type EventDefinition$3<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$3<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$3<Payload, Type>;
-type EventHandler$3<T extends EventDefinition$3> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$3<T extends EventDefinition$3<any, string>> = (handler: EventHandler$3<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
+declare const onCategoryCreated$1: EventDefinition<CategoryCreatedEnvelope, "wix.blog.v3.category_created">;
+declare const onCategoryUpdated$1: EventDefinition<CategoryUpdatedEnvelope, "wix.blog.v3.category_updated">;
+declare const onCategoryDeleted$1: EventDefinition<CategoryDeletedEnvelope, "wix.blog.v3.category_deleted">;
 
-declare function createEventModule$3<T extends EventDefinition$3<any, string>>(eventDefinition: T): BuildEventDefinition$3<T> & T;
+declare function createEventModule$3<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 
 declare const getCategory: MaybeContext<BuildRESTFunction<typeof getCategory$1> & typeof getCategory$1>;
 declare const getCategoryBySlug: MaybeContext<BuildRESTFunction<typeof getCategoryBySlug$1> & typeof getCategoryBySlug$1>;
@@ -3769,7 +3817,7 @@ interface Keyword$2 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$2 {
@@ -3920,8 +3968,6 @@ declare enum Field$2 {
     CONTENT = "CONTENT",
     /** Includes rich content field. */
     RICH_CONTENT = "RICH_CONTENT",
-    /** Includes draft post translations when present. */
-    TRANSLATIONS = "TRANSLATIONS",
     /** If the user has not set excerpt, returns the one autogenerated from content. */
     GENERATED_EXCERPT = "GENERATED_EXCERPT"
 }
@@ -5713,29 +5759,11 @@ interface PublishDraftPostSignature {
      */
     (draftPostId: string): Promise<PublishDraftPostResponse & PublishDraftPostResponseNonNullableFields>;
 }
-declare const onDraftCreated$1: EventDefinition$4<DraftCreatedEnvelope, "wix.blog.v3.draft_created">;
-declare const onDraftUpdated$1: EventDefinition$4<DraftUpdatedEnvelope, "wix.blog.v3.draft_updated">;
-declare const onDraftDeleted$1: EventDefinition$4<DraftDeletedEnvelope, "wix.blog.v3.draft_deleted">;
+declare const onDraftCreated$1: EventDefinition<DraftCreatedEnvelope, "wix.blog.v3.draft_created">;
+declare const onDraftUpdated$1: EventDefinition<DraftUpdatedEnvelope, "wix.blog.v3.draft_updated">;
+declare const onDraftDeleted$1: EventDefinition<DraftDeletedEnvelope, "wix.blog.v3.draft_deleted">;
 
-type EventDefinition$2<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$2<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$2<Payload, Type>;
-type EventHandler$2<T extends EventDefinition$2> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$2<T extends EventDefinition$2<any, string>> = (handler: EventHandler$2<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
-
-declare function createEventModule$2<T extends EventDefinition$2<any, string>>(eventDefinition: T): BuildEventDefinition$2<T> & T;
+declare function createEventModule$2<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 
 declare const createDraftPost: MaybeContext<BuildRESTFunction<typeof createDraftPost$1> & typeof createDraftPost$1>;
 declare const bulkCreateDraftPosts: MaybeContext<BuildRESTFunction<typeof bulkCreateDraftPosts$1> & typeof bulkCreateDraftPosts$1>;
@@ -7685,9 +7713,7 @@ declare enum GetPostsSort {
     /** Sorting by title ascending */
     TITLE_ASC = "TITLE_ASC",
     /** Sorting by title descending */
-    TITLE_DESC = "TITLE_DESC",
-    /** Sorting by post rating descending. */
-    RATING = "RATING"
+    TITLE_DESC = "TITLE_DESC"
 }
 interface BlogPaging {
     /**
@@ -7709,8 +7735,6 @@ interface BlogPaging {
 }
 declare enum PostFieldField {
     UNKNOWN = "UNKNOWN",
-    /** Deprecated use `METRICS` instead */
-    COUNTERS = "COUNTERS",
     /** Includes Post url when present */
     URL = "URL",
     /** Includes Post content text string when present */
@@ -7719,26 +7743,10 @@ declare enum PostFieldField {
     METRICS = "METRICS",
     /** Includes SEO data */
     SEO = "SEO",
-    /**
-     * Includes Post content as a stringified DraftJS document
-     * Reserved for internal use
-     */
-    CONTENT = "CONTENT",
-    /**
-     * Includes internal id field
-     * Reserved for internal use
-     */
-    INTERNAL_ID = "INTERNAL_ID",
     /** Includes post owners Contact Id */
     CONTACT_ID = "CONTACT_ID",
     /** Includes post rich content */
-    RICH_CONTENT = "RICH_CONTENT",
-    /** Includes post rich content string */
-    RICH_CONTENT_STRING = "RICH_CONTENT_STRING",
-    /** Includes compressed post rich content string */
-    RICH_CONTENT_COMPRESSED = "RICH_CONTENT_COMPRESSED",
-    /** Includes post translations */
-    TRANSLATIONS = "TRANSLATIONS"
+    RICH_CONTENT = "RICH_CONTENT"
 }
 interface ListDemoPostsResponse {
     /** List of posts. */
@@ -9486,31 +9494,13 @@ interface GetTotalPostsSignature {
      */
     (options?: GetTotalPostsOptions | undefined): Promise<GetTotalPostsResponse & GetTotalPostsResponseNonNullableFields>;
 }
-declare const onPostCreated$1: EventDefinition$4<PostCreatedEnvelope, "wix.blog.v3.post_created">;
-declare const onPostUpdated$1: EventDefinition$4<PostUpdatedEnvelope, "wix.blog.v3.post_updated">;
-declare const onPostDeleted$1: EventDefinition$4<PostDeletedEnvelope, "wix.blog.v3.post_deleted">;
-declare const onPostLiked$1: EventDefinition$4<PostLikedEnvelope, "wix.blog.v3.post_liked">;
-declare const onPostUnliked$1: EventDefinition$4<PostUnlikedEnvelope, "wix.blog.v3.post_unliked">;
-
-type EventDefinition$1<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition$1<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition$1<Payload, Type>;
-type EventHandler$1<T extends EventDefinition$1> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition$1<T extends EventDefinition$1<any, string>> = (handler: EventHandler$1<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
+declare const onPostCreated$1: EventDefinition<PostCreatedEnvelope, "wix.blog.v3.post_created">;
+declare const onPostUpdated$1: EventDefinition<PostUpdatedEnvelope, "wix.blog.v3.post_updated">;
+declare const onPostDeleted$1: EventDefinition<PostDeletedEnvelope, "wix.blog.v3.post_deleted">;
+declare const onPostLiked$1: EventDefinition<PostLikedEnvelope, "wix.blog.v3.post_liked">;
+declare const onPostUnliked$1: EventDefinition<PostUnlikedEnvelope, "wix.blog.v3.post_unliked">;
 
-declare function createEventModule$1<T extends EventDefinition$1<any, string>>(eventDefinition: T): BuildEventDefinition$1<T> & T;
+declare function createEventModule$1<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 
 declare const getPost: MaybeContext<BuildRESTFunction<typeof getPost$1> & typeof getPost$1>;
 declare const getPostBySlug: MaybeContext<BuildRESTFunction<typeof getPostBySlug$1> & typeof getPostBySlug$1>;
@@ -9910,7 +9900,7 @@ interface Keyword {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag {
@@ -9965,9 +9955,7 @@ interface GetOrCreateTagRequest {
 declare enum Field {
     UNKNOWN = "UNKNOWN",
     /** Includes Tag URL when present. */
-    URL = "URL",
-    /** Includes SEO data. */
-    SEO = "SEO"
+    URL = "URL"
 }
 interface GetOrCreateTagResponse {
     /** Tag info. */
@@ -10842,27 +10830,9 @@ interface DeleteTagSignature {
      */
     (tagId: string): Promise<void>;
 }
-declare const onTagCreated$1: EventDefinition$4<TagCreatedEnvelope, "wix.blog.v3.tag_created">;
-declare const onTagUpdated$1: EventDefinition$4<TagUpdatedEnvelope, "wix.blog.v3.tag_updated">;
-declare const onTagDeleted$1: EventDefinition$4<TagDeletedEnvelope, "wix.blog.v3.tag_deleted">;
-
-type EventDefinition<Payload = unknown, Type extends string = string> = {
-    __type: 'event-definition';
-    type: Type;
-    isDomainEvent?: boolean;
-    transformations?: (envelope: unknown) => Payload;
-    __payload: Payload;
-};
-declare function EventDefinition<Type extends string>(type: Type, isDomainEvent?: boolean, transformations?: (envelope: any) => unknown): <Payload = unknown>() => EventDefinition<Payload, Type>;
-type EventHandler<T extends EventDefinition> = (payload: T['__payload']) => void | Promise<void>;
-type BuildEventDefinition<T extends EventDefinition<any, string>> = (handler: EventHandler<T>) => void;
-
-declare global {
-	// eslint-disable-next-line @typescript-eslint/consistent-type-definitions -- It has to be an `interface` so that it can be merged.
-	interface SymbolConstructor {
-		readonly observable: symbol;
-	}
-}
+declare const onTagCreated$1: EventDefinition<TagCreatedEnvelope, "wix.blog.v3.tag_created">;
+declare const onTagUpdated$1: EventDefinition<TagUpdatedEnvelope, "wix.blog.v3.tag_updated">;
+declare const onTagDeleted$1: EventDefinition<TagDeletedEnvelope, "wix.blog.v3.tag_deleted">;
 
 declare function createEventModule<T extends EventDefinition<any, string>>(eventDefinition: T): BuildEventDefinition<T> & T;
 

package/type-bundles/meta.bundle.d.ts

@@ -1052,7 +1052,7 @@ interface Keyword$5 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$5 {
@@ -1121,9 +1121,7 @@ declare enum Field$5 {
      */
     INTERNAL_ID = "INTERNAL_ID",
     /** Includes SEO data. */
-    SEO = "SEO",
-    /** Includes translations. */
-    TRANSLATIONS = "TRANSLATIONS"
+    SEO = "SEO"
 }
 interface GetCategoryRequest$1 {
     /** Category ID. */
@@ -1432,7 +1430,7 @@ interface Keyword$4 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$4 {
@@ -1478,9 +1476,7 @@ declare enum Field$4 {
      */
     INTERNAL_ID = "INTERNAL_ID",
     /** Includes SEO data. */
-    SEO = "SEO",
-    /** Includes translations. */
-    TRANSLATIONS = "TRANSLATIONS"
+    SEO = "SEO"
 }
 interface GetCategoryRequest {
     /** Category ID. */
@@ -3229,7 +3225,7 @@ interface Keyword$3 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$3 {
@@ -3369,8 +3365,6 @@ declare enum Field$3 {
     CONTENT = "CONTENT",
     /** Includes rich content field. */
     RICH_CONTENT = "RICH_CONTENT",
-    /** Includes draft post translations when present. */
-    TRANSLATIONS = "TRANSLATIONS",
     /** If the user has not set excerpt, returns the one autogenerated from content. */
     GENERATED_EXCERPT = "GENERATED_EXCERPT"
 }
@@ -5681,7 +5675,7 @@ interface Keyword$2 {
     term?: string;
     /** Whether the keyword is the main focus keyword. */
     isMain?: boolean;
-    /** Who added the keyword to the settings */
+    /** The source that added the keyword terms to the SEO settings. */
     origin?: string | null;
 }
 interface Tag$2 {
@@ -5791,8 +5785,6 @@ declare enum Field$2 {
     CONTENT = "CONTENT",
     /** Includes rich content field. */
     RICH_CONTENT = "RICH_CONTENT",
-    /** Includes draft post translations when present. */
-    TRANSLATIONS = "TRANSLATIONS",
     /** If the user has not set excerpt, returns the one autogenerated from content. */
     GENERATED_EXCERPT = "GENERATED_EXCERPT"
 }
@@ -8226,9 +8218,7 @@ declare enum GetPostsSort$1 {
     /** Sorting by title ascending */
     TITLE_ASC = "TITLE_ASC",
     /** Sorting by title descending */
-    TITLE_DESC = "TITLE_DESC",
-    /** Sorting by post rating descending. */
-    RATING = "RATING"
+    TITLE_DESC = "TITLE_DESC"
 }
 interface BlogPaging$1 {
     /**
@@ -8250,8 +8240,6 @@ interface BlogPaging$1 {
 }
 declare enum PostFieldField$1 {
     UNKNOWN = "UNKNOWN",
-    /** Deprecated use `METRICS` instead */
-    COUNTERS = "COUNTERS",
     /** Includes Post url when present */
     URL = "URL",
     /** Includes Post content text string when present */
@@ -8260,26 +8248,10 @@ declare enum PostFieldField$1 {
     METRICS = "METRICS",
     /** Includes SEO data */
     SEO = "SEO",
-    /**
-     * Includes Post content as a stringified DraftJS document
-     * Reserved for internal use
-     */
-    CONTENT = "CONTENT",
-    /**
-     * Includes internal id field
-     * Reserved for internal use
-     */
-    INTERNAL_ID = "INTERNAL_ID",
     /** Includes post owners Contact Id */
     CONTACT_ID = "CONTACT_ID",
     /** Includes post rich content */
-    RICH_CONTENT = "RICH_CONTENT",
-    /** Includes post rich content string */
-    RICH_CONTENT_STRING = "RICH_CONTENT_STRING",
-    /** Includes compressed post rich content string */
-    RICH_CONTENT_COMPRESSED = "RICH_CONTENT_COMPRESSED",
-    /** Includes post translations */
-    TRANSLATIONS = "TRANSLATIONS"
+    RICH_CONTENT = "RICH_CONTENT"
 }
 interface MetaData$3 {
     /** Number of items returned in this response. */
@@ -10587,9 +10559,7 @@ declare enum GetPostsSort {
     /** Sorting by title ascending */
     TITLE_ASC = "TITLE_ASC",
     /** Sorting by title descending */
-    TITLE_DESC = "TITLE_DESC",
-    /** Sorting by post rating descending. */
-    RATING = "RATING"
+    TITLE_DESC = "TITLE_DESC"
 }
 interface BlogPaging {
     /**
@@ -10611,8 +10581,6 @@ interface BlogPaging {
 }
 declare enum PostFieldField {
     UNKNOWN = "UNKNOWN",
-    /** Deprecated use `METRICS` instead */
-    COUNTERS = "COUNTERS",
     /** Includes Post url when present */
     URL = "URL",
     /** Includes Post content text string when present */
@@ -10621,26 +10589,10 @@ declare enum PostFieldField {
     METRICS = "METRICS",
     /** Includes SEO data */
     SEO = "SEO",
-    /**
-     * Includes Post content as a stringified DraftJS document
-     * Reserved for internal use
-     */
-    CONTENT = "CONTENT",
-    /**
-     * Includes internal id field
-     * Reserved for internal use
-     */
-    INTERNAL_ID = "INTERNAL_ID",
     /** Includes post owners Contact Id */
     CONTACT_ID = "CONTACT_ID",
     /** Includes post rich content */
-    RICH_CONTENT = "RICH_CONTENT",
-    /** Includes post rich content string */
-    RICH_CONTENT_STRING = "RICH_CONTENT_STRING",
-    /** Includes compressed post rich content string */
-    RICH_CONTENT_COMPRESSED = "RICH_CONTENT_COMPRESSED",
-    /** Includes post translations */
-    TRANSLATIONS = "TRANSLATIONS"
+    RICH_CONTENT = "RICH_CONTENT"
 }
 interface MetaData$2 {
     /** Number of items returned in this response. */
@@ -11464,9 +11416,7 @@ interface PageUrl {
 declare enum Field$1 {
     UNKNOWN = "UNKNOWN",
     /** Includes Tag URL when present. */
-    URL = "URL",
-    /** Includes SEO data. */
-    SEO = "SEO"
+    URL = "URL"
 }
 interface CreateTagRequest$1 {
     /** Tag label. The label for each tag in a blog must be unique. */
@@ -11873,9 +11823,7 @@ interface BlogTag {
 declare enum Field {
     UNKNOWN = "UNKNOWN",
     /** Includes Tag URL when present. */
-    URL = "URL",
-    /** Includes SEO data. */
-    SEO = "SEO"
+    URL = "URL"
 }
 interface CreateTagRequest {
     /** Tag label. The label for each tag in a blog must be unique. */