Class ProductLimitRuleService

Customer-tier CRUD over product_limit_rule. Always operates on the type='CUSTOMER' slice. Customer rules can only TIGHTEN against the matching admin baseline (max columns ≤ admin baseline; min columns ≥ admin baseline). Violations return INVALID_LIMIT_RULE naming the offending column.

Identity / version split: see ProductLimitRuleAdminService.

Internal admins must use ProductLimitRuleAdminService instead.

Index

Constructors

constructor

new ProductLimitRuleService(
__namedParameters: { db: B2bDatabase },
): ProductLimitRuleService
Parameters
- __namedParameters: { db: B2bDatabase }
Returns ProductLimitRuleService
- Defined in packages/product-services/src/ProductLimitRuleService.ts:111

Properties

`Protected` `Readonly`db

db: B2bDatabase

`Static`instance

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

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

Methods

create

create(
    input: {
        customerId: string;
        description?: string;
        effectiveFrom?: Instant;
        label?: string;
        matcher?: Matcher | undefined;
        priority: number;
    } & (LimitRuleScopeInput & LimitFields),
): Promise<
    | { ok: true; value: ProductLimitRule }
    | { error: ServiceError; ok: false },
>
Parameters
- input: {
      customerId: string;
      description?: string;
      effectiveFrom?: Instant;
      label?: string;
      matcher?: Matcher | undefined;
      priority: number;
  } & (LimitRuleScopeInput & LimitFields)
  - customerId: string
  - Optionaldescription?: string
  - OptionaleffectiveFrom?: Instant
    
    When this version becomes effective. Defaults to now() at the DB layer when omitted.
  - Optionallabel?: string
  - Optionalmatcher?: Matcher | undefined
  - priority: number
Returns Promise<
| { ok: true; value: ProductLimitRule }
| { error: ServiceError; ok: false },
>
- Defined in packages/product-services/src/ProductLimitRuleService.ts:115

delete

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

get

get(input: { customerId: string; id: string }): Promise<ProductLimitRule | null>
Parameters
- input: { customerId: string; id: string }
Returns Promise<ProductLimitRule | null>
- Defined in packages/product-services/src/ProductLimitRuleService.ts:597

search

search(
    input: {
        createdAt?: DbTimestampCriteria<Instant>;
        customerId: 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: ProductLimitRule[]; total: number };
    },
>
Returns limit rules visible to this customer:
- admin-global (customerId IS NULL)
- admin-for-this-customer (type='ADMIN', customerId=input.customerId)
- customer-tier (type='CUSTOMER', customerId=input.customerId)
Pass types: ["CUSTOMER"] from a controller to restrict to the customer's own writable slice. Write paths always operate on the CUSTOMER slice regardless of this filter.
Parameters
- input: {
      createdAt?: DbTimestampCriteria<Instant>;
      customerId: 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>
  - customerId: 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: ProductLimitRule[]; total: number };
    },
>
- Defined in packages/product-services/src/ProductLimitRuleService.ts:485

update

update(
    input: {
        customerId: string;
        data: {
            description?: string | null;
            effectiveFrom?: Instant;
            label?: string | null;
            matcher?: Matcher;
            priority?: number;
            status?: "ACTIVE" | "DISABLED";
        } & LimitFieldsNullable;
        id: string;
    },
): Promise<
    | { ok: true; value: ProductLimitRule }
    | { error: ServiceError; ok: false },
>
Parameters
- input: {
      customerId: string;
      data: {
          description?: string | null;
          effectiveFrom?: Instant;
          label?: string | null;
          matcher?: Matcher;
          priority?: number;
          status?: "ACTIVE" | "DISABLED";
      } & LimitFieldsNullable;
      id: string;
  }
Returns Promise<
| { ok: true; value: ProductLimitRule }
| { error: ServiceError; ok: false },
>
- Defined in packages/product-services/src/ProductLimitRuleService.ts:276

Class ProductLimitRuleService

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ProductLimitRuleService

Properties

Protected Readonlydb

Staticinstance

Methods

create

Parameters

customerId: string

Optionaldescription?: string

OptionaleffectiveFrom?: Instant

Optionallabel?: string

Optionalmatcher?: Matcher | undefined

priority: number

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

delete

Parameters

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

get

Parameters

Returns Promise<ProductLimitRule | null>

search

Parameters

OptionalcreatedAt?: DbTimestampCriteria<Instant>

customerId: 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: ProductLimitRule[]; total: number }; },>

update

Parameters

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

Settings

On This Page

`Protected` `Readonly`db

`Static`instance

`Optional`description?: string

`Optional`effectiveFrom?: Instant

`Optional`label?: string

`Optional`matcher?: Matcher | undefined

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

`Optional`createdAt?: DbTimestampCriteria<Instant>

`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: ProductLimitRule[]; total: number };
},
>

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