Hyperse
  • Pricing
  • FAQs
Newsletter

Subscribe to our newsletter

Receive weekly updates with latest collections and exclusive offers, straight to your inbox.

Hyperse

Headless commerce solutions for brands, developers, and modern ecommerce teams.

Explore

  • Home
  • About Us
  • Partners
  • FAQs

Legal & resources

  • Proposal
  • Privacy Policy
  • Terms & Conditions

© 2026 Hyperse. All rights reserved.


  1. Home
  2. Vendure Plugins
  3. hps-plugin-public-customer-groups
hps-plugin-public-customer-groups

hps-plugin-public-customer-groups

By Yingchun Tian

hps-plugin-public-customer-groups is a Public Customer Groups plugin in the Hub Store group.hps-plugin-public-customer-groups provides Public Customer Groups plugin capabilities for Hub Store. Storefront commerce features for shopping and orders.

CoreVendure Plugins

Specifications

Technical details and package information for this product.

Package

@hyperse-hub/hps-plugin-public-customer-groups

Support by

Yingchun Tian

Support languages

TypeScript, JavaScript, CSS, Prolog, Shell

Integration type

Core

Category

Vendure Plugins

Compatible with

^3.0.0

Latest version

1.1.6

Downloads

0

Repository

https://github.com/hyperse-hub/hub-store

Last published

July 14, 2026

Description
Changelog
loading...

On this page

  • @hyperse-hub/hps-plugin-public-customer-groups
    • What it does
    • Installation
    • Development
    • Shop GraphQL example
    • Security notes
    • License

@hyperse-hub/hps-plugin-public-customer-groups

Vendure plugin that exposes customer group membership on the Shop API in a privacy-conscious way: only groups explicitly marked “public” are listed on the authenticated customer, and the member list on each group is always empty in the shop schema so other customers’ data cannot be scraped.

Part of the Hub Store monorepo — see Platform.md.

What it does

AreaBehavior
AdminAdds a boolean custom field CustomerGroup.customFields.isPublic. You assign customers to groups as usual; toggle isPublic for groups that are safe to surface on the storefront (e.g. loyalty tier labels).
Shop – Customer.customerGroupsNew field listing groups the current customer belongs to after filtering to isPublic === true. Groups with a missing or false flag are omitted.
Shop – CustomerGroup.customersResolved to an always-empty paginated connection so the default Vendure shop exposure of group members is neutralized.

The isPublic flag uses public: false in custom-field config so it is not part of the generated Shop GraphQL type for CustomerGroup. The storefront does not get a direct isPublic argument or field on group objects from schema introspection; the server still reads the stored value when building customerGroups.

Installation

Development

From this package directory:

# run a local test server (see ./config/dev-server.ts)

Shop GraphQL example

After a customer signs in, you can load public groups only:

Use Admin API mutations/queries to create groups, set customFields.isPublic, and assign customers.

Security notes

  • Default is private: If isPublic is unset or false, the group does not appear under customerGroups in the shop.
  • Peer listing disabled: Do not rely on CustomerGroup.customers in the Shop API for real data; it is intentionally empty for privacy.
  • Admin vs shop: Managing groups and the isPublic flag remains an admin concern; the shop only sees filtered membership.

License

MIT — see the repository root.

import { VendureConfig } from '@vendure/core';
import { HpsPluginPublicCustomerGroups } from '@hyperse-hub/hps-plugin-public-customer-groups';
export const config: VendureConfig = {
// ...
plugins: [
HpsPluginPublicCustomerGroups,
// ...
],
};
yarn serve
# build / lint / typecheck / tests
yarn build
yarn lint
yarn typecheck
yarn test
query ActiveCustomerPublicGroups {
activeCustomer {
id
customerGroups {
id
name
customers {
totalItems # always 0 in Shop API when this plugin is enabled
}
}
}
}