Class ProductLimitRuleAdminService

Admin-tier CRUD over product_limit_rule. Accepts any rule type (admin-global, admin-for-customer, or customer).

Identity / version split: see ProductLimitRuleAdminService (this file). Edits insert a new version row and re-point currentVersionId in one transaction.

Duplicate-matcher detection is enforced by the partial unique index product_limit_rule_unique_tuple — see ProductActivationRuleAdminService for the rationale. matcherHash is denormalized onto the identity row; service code maintains identity.matcherHash = currentVersion.matcherHash on every version bump and translates the unique-violation back into DUPLICATE_MATCHER.

Hierarchy

ProductConfigSearchCache<AdminProductLimitRule>
- ProductLimitRuleAdminService

Index

Constructors

constructor

new ProductLimitRuleAdminService(
    __namedParameters: {
        db: B2bDatabase;
        internalEventPublisher: InternalEventPublisher | null;
        valkeyClient: ValkeyClient | null;
    },
): ProductLimitRuleAdminService
Parameters
- __namedParameters: {
      db: B2bDatabase;
      internalEventPublisher: InternalEventPublisher | null;
      valkeyClient: ValkeyClient | null;
  }
  - db: B2bDatabase
  - internalEventPublisher: InternalEventPublisher | null
    
    Publishes product.limitRule.*; null publishes nothing (scripts, tests).
  - valkeyClient: ValkeyClient | null
Returns ProductLimitRuleAdminService
Overrides ProductConfigSearchCache<AdminProductLimitRule>.constructor
- Defined in packages/product-services/src/ProductLimitRuleAdminService.ts:174

Properties

`Protected` `Readonly`cache

cache: ServiceCache<CachedSearchPage<AdminProductLimitRule>>

`Protected` `Readonly`db

db: B2bDatabase

`Static`instance

instance: (...args: []) => ProductLimitRuleAdminService = ...

The process default: built from each dependency's own instance().

Methods

`Protected`bustSearchCache

bustSearchCache(...keys: CacheKey[]): Promise<void>
After a committed write: the folded-get keys (a tag bust no-ops without Valkey), then every page through the collection tag.
Parameters
- ...keys: CacheKey[]
Returns Promise<void>
Inherited from ProductConfigSearchCache.bustSearchCache
- Defined in packages/product-services/src/internal/configSearchCache.ts:106

`Protected`cachedSearch

cachedSearch(
input: Record<string, unknown>,
query: () => Promise<CachedSearchPage<AdminProductLimitRule>>,
): Promise<CachedSearchPage<AdminProductLimitRule>>
Serves input's page from the cache, else runs query and caches it.
Parameters
- input: Record<string, unknown>
- query: () => Promise<CachedSearchPage<AdminProductLimitRule>>
Returns Promise<CachedSearchPage<AdminProductLimitRule>>
Inherited from ProductConfigSearchCache.cachedSearch
- Defined in packages/product-services/src/internal/configSearchCache.ts:85

create

create(
    input: {
        customerId?: string;
        description?: string;
        effectiveFrom?: Instant;
        label?: string;
        matcher?: Matcher | undefined;
        priority: number;
        type?: "CUSTOMER" | "ADMIN";
    } & (LimitRuleScopeInput & LimitFields),
): Promise<
    | { ok: true; value: AdminProductLimitRule }
    | { error: ServiceError; ok: false },
>
Parameters
- input: {
      customerId?: string;
      description?: string;
      effectiveFrom?: Instant;
      label?: string;
      matcher?: Matcher | undefined;
      priority: number;
      type?: "CUSTOMER" | "ADMIN";
  } & (LimitRuleScopeInput & LimitFields)
  - OptionalcustomerId?: string
  - Optionaldescription?: string
  - OptionaleffectiveFrom?: Instant
    
    When this version becomes effective. Defaults to now() at the DB layer when omitted. Pass a future Temporal.Instant to schedule a change (e.g. Reg E 30-day notice).
  - Optionallabel?: string
  - Optionalmatcher?: Matcher | undefined
  - priority: number
  - Optionaltype?: "CUSTOMER" | "ADMIN"
Returns Promise<
| { ok: true; value: AdminProductLimitRule }
| { error: ServiceError; ok: false },
>
- Defined in packages/product-services/src/ProductLimitRuleAdminService.ts:194

delete

delete(
input: { id: string },
): Promise<{ ok: true; value: void } | { error: ServiceError; ok: false }>
Parameters
- input: { id: string }
Returns Promise<{ ok: true; value: void } | { error: ServiceError; ok: false }>
- Defined in packages/product-services/src/ProductLimitRuleAdminService.ts:492

get

get(input: { id: string }): Promise<AdminProductLimitRule | null>
Parameters
- input: { id: string }
Returns Promise<AdminProductLimitRule | null>
- Defined in packages/product-services/src/ProductLimitRuleAdminService.ts:548

invalidateCache

invalidateCache(
    __namedParameters: {
        customerIds: readonly string[];
        keys?: readonly CacheKey[];
        records?: readonly string[];
    },
): Promise<void>
Clear each customer's membership tag and each record tag wherever cached, and always this namespace's collection tag. keys are exact deletes in this instance's key space: the only bust a null client honours.
Parameters
- __namedParameters: {
      customerIds: readonly string[];
      keys?: readonly CacheKey[];
      records?: readonly string[];
  }
Returns Promise<void>
Inherited from ProductConfigSearchCache.invalidateCache
- Defined in packages/db/src/valkey/service-cache.ts:543

search

search(
    input: {
        createdAt?: DbTimestampCriteria<Instant>;
        customerIds?: string[];
        ids?: string[];
        orderBy?: RuleOrderByCriterion[];
        page?: number;
        pageSize?: number;
        productCategories?: ProductCategory[];
        routeIds?: string[];
        statuses?: ("ACTIVE" | "DISABLED")[];
        types?: ("CUSTOMER" | "ADMIN")[];
        updatedAt?: DbTimestampCriteria<Instant>;
    },
): Promise<
    {
        ok: true;
        value: { hasNext: boolean; items: AdminProductLimitRule[]; total: number };
    },
>
Parameters
- input: {
      createdAt?: DbTimestampCriteria<Instant>;
      customerIds?: string[];
      ids?: string[];
      orderBy?: RuleOrderByCriterion[];
      page?: number;
      pageSize?: number;
      productCategories?: ProductCategory[];
      routeIds?: string[];
      statuses?: ("ACTIVE" | "DISABLED")[];
      types?: ("CUSTOMER" | "ADMIN")[];
      updatedAt?: DbTimestampCriteria<Instant>;
  }
  - OptionalcreatedAt?: DbTimestampCriteria<Instant>
  - OptionalcustomerIds?: string[]
  - Optionalids?: string[]
  - OptionalorderBy?: RuleOrderByCriterion[]
  - Optionalpage?: number
  - OptionalpageSize?: number
  - OptionalproductCategories?: ProductCategory[]
    
    Matches category rules only.
  - OptionalrouteIds?: string[]
    
    Matches route rules only.
  - Optionalstatuses?: ("ACTIVE" | "DISABLED")[]
  - Optionaltypes?: ("CUSTOMER" | "ADMIN")[]
  - OptionalupdatedAt?: DbTimestampCriteria<Instant>
Returns Promise<
    {
        ok: true;
        value: { hasNext: boolean; items: AdminProductLimitRule[]; total: number };
    },
>
- Defined in packages/product-services/src/ProductLimitRuleAdminService.ts:528

`Protected`searchTags

searchTags(
    __namedParameters: {
        customerIds: readonly string[] | undefined;
        fields?: readonly string[];
        records?: readonly string[];
    },
): string[]
Tags for a page: the scope its query searched (each customer's membership tag, else the collection tag), so an empty page is bustable too, plus the records it projects and the fields that chose or ordered its rows.
Parameters
- __namedParameters: {
      customerIds: readonly string[] | undefined;
      fields?: readonly string[];
      records?: readonly string[];
  }
Returns string[]
Inherited from ProductConfigSearchCache.searchTags
- Defined in packages/db/src/valkey/service-cache.ts:519

update

update(
    input: {
        data: {
            description?: string | null;
            effectiveFrom?: Instant;
            label?: string | null;
            matcher?: Matcher;
            priority?: number;
            status?: "ACTIVE" | "DISABLED";
        } & {
            limit24hMaxCount?: BigNumber
            | null;
            limit24hMaxUsd?: BigNumber | null;
            limit30dMaxCount?: BigNumber | null;
            limit30dMaxUsd?: BigNumber | null;
            limit7dMaxCount?: BigNumber | null;
            limit7dMaxUsd?: BigNumber | null;
            limitCalendarMonthMaxCount?: BigNumber | null;
            limitCalendarMonthMaxUsd?: BigNumber | null;
            transactionMaxUsd?: BigNumber | null;
            transactionMinUsd?: BigNumber | null;
        };
        id: string;
    },
): Promise<
    | { error: ServiceError; ok: false }
    | { ok: true; value: AdminProductLimitRule },
>
The rule's scope (route or category) is fixed at create.
Parameters
- input: {
      data: {
          description?: string | null;
          effectiveFrom?: Instant;
          label?: string | null;
          matcher?: Matcher;
          priority?: number;
          status?: "ACTIVE" | "DISABLED";
      } & {
          limit24hMaxCount?: BigNumber
          | null;
          limit24hMaxUsd?: BigNumber | null;
          limit30dMaxCount?: BigNumber | null;
          limit30dMaxUsd?: BigNumber | null;
          limit7dMaxCount?: BigNumber | null;
          limit7dMaxUsd?: BigNumber | null;
          limitCalendarMonthMaxCount?: BigNumber | null;
          limitCalendarMonthMaxUsd?: BigNumber | null;
          transactionMaxUsd?: BigNumber | null;
          transactionMinUsd?: BigNumber | null;
      };
      id: string;
  }
Returns Promise<
| { error: ServiceError; ok: false }
| { ok: true; value: AdminProductLimitRule },
>
- Defined in packages/product-services/src/ProductLimitRuleAdminService.ts:346

Class ProductLimitRuleAdminService

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

db: B2bDatabase

internalEventPublisher: InternalEventPublisher | null

valkeyClient: ValkeyClient | null

Returns ProductLimitRuleAdminService

Properties

Protected Readonlycache

Protected Readonlydb

Staticinstance

Methods

ProtectedbustSearchCache

Parameters

Returns Promise<void>

ProtectedcachedSearch

Parameters

Returns Promise<CachedSearchPage<AdminProductLimitRule>>

create

Parameters

OptionalcustomerId?: string

Optionaldescription?: string

OptionaleffectiveFrom?: Instant

Optionallabel?: string

Optionalmatcher?: Matcher | undefined

priority: number

Optionaltype?: "CUSTOMER" | "ADMIN"

Returns Promise< | { ok: true; value: AdminProductLimitRule } | { error: ServiceError; ok: false },>

delete

Parameters

Returns Promise<{ ok: true; value: void } | { error: ServiceError; ok: false }>

get

Parameters

Returns Promise<AdminProductLimitRule | null>

invalidateCache

Parameters

Returns Promise<void>

search

Parameters

OptionalcreatedAt?: DbTimestampCriteria<Instant>

OptionalcustomerIds?: string[]

Optionalids?: string[]

OptionalorderBy?: RuleOrderByCriterion[]

Optionalpage?: number

OptionalpageSize?: number

OptionalproductCategories?: ProductCategory[]

OptionalrouteIds?: string[]

Optionalstatuses?: ("ACTIVE" | "DISABLED")[]

Optionaltypes?: ("CUSTOMER" | "ADMIN")[]

OptionalupdatedAt?: DbTimestampCriteria<Instant>

Returns Promise< { ok: true; value: { hasNext: boolean; items: AdminProductLimitRule[]; total: number }; },>

ProtectedsearchTags

Parameters

Returns string[]

update

Parameters

Returns Promise< | { error: ServiceError; ok: false } | { ok: true; value: AdminProductLimitRule },>

Settings

On This Page

`Protected` `Readonly`cache

`Protected` `Readonly`db

`Static`instance

`Protected`bustSearchCache

`Protected`cachedSearch

`Optional`customerId?: string

`Optional`description?: string

`Optional`effectiveFrom?: Instant

`Optional`label?: string

`Optional`matcher?: Matcher | undefined

`Optional`type?: "CUSTOMER" | "ADMIN"

Returns Promise<
| { ok: true; value: AdminProductLimitRule }
| { error: ServiceError; ok: false },
>

`Optional`createdAt?: DbTimestampCriteria<Instant>

`Optional`customerIds?: string[]

`Optional`ids?: string[]

`Optional`orderBy?: RuleOrderByCriterion[]

`Optional`page?: number

`Optional`pageSize?: number

`Optional`productCategories?: ProductCategory[]

`Optional`routeIds?: string[]

`Optional`statuses?: ("ACTIVE" | "DISABLED")[]

`Optional`types?: ("CUSTOMER" | "ADMIN")[]

`Optional`updatedAt?: DbTimestampCriteria<Instant>

Returns Promise<
{
ok: true;
value: { hasNext: boolean; items: AdminProductLimitRule[]; total: number };
},
>

`Protected`searchTags

Returns Promise<
| { error: ServiceError; ok: false }
| { ok: true; value: AdminProductLimitRule },
>