@fragus/sam-types 1.1.3 → 1.1.5

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.3",
+  "version": "1.1.5",
   "name": "@fragus/sam-types",
   "description": "Typescript interfaces for all types used to communicate between SAM client(s) and the SAM API",
   "author": "Fragus",

package/types/accessKey/index.d.ts

@@ -1,5 +1,8 @@
 import { AccessKeyPermission, AccessKeyService, TIsoCountry } from '../index'
 
+/** How an access key chooses its providers: country-scoped, manually scoped, or group-scoped. */
+export type TAccessKeyScopeMode = 'all' | 'manual' | 'group'
+
 export interface IAccessKey {
   accessKeyId: number
   apiKey: string
@@ -10,5 +13,7 @@ export interface IAccessKey {
   contractProviderIds: number[]
   allProvidersAllowed: boolean
   isoCountries: TIsoCountry[] // scope for allProvidersAllowed; non-empty when it is true
+  scopeMode: TAccessKeyScopeMode
+  contractProviderGroupId: number | null // set only in 'group' mode; resolved live at request time
   description?: string
 }

package/types/admin/vehicleBlacklist/index.d.ts

@@ -6,6 +6,10 @@ export interface IBlacklistedVehicleRequest {
     add: number[]
     remove: number[]
   }
+  contractProviderGroupIds?: {
+    add: number[]
+    remove: number[]
+  }
 }
 
 export interface IBlacklistedVehicleResponse {
@@ -14,11 +18,21 @@ export interface IBlacklistedVehicleResponse {
   model: string
   fuelType: string
   parentRecord?: boolean
+  groupRecord?: boolean
 }
 
 export interface IBlacklistedVehicleListRecord extends IBlacklistedVehicleResponse {
-  providerId: number
-  providerName: string
+  // Null on a group-owned entry: the two owners are exclusive.
+  providerId: number | null
+  providerName: string | null
+  contractProviderGroupId: number | null
+  contractProviderGroupName: string | null
+}
+
+/** Which providers and groups a blacklisted vehicle is registered for. */
+export interface IBlacklistedVehicleScope {
+  providerIds: number[]
+  contractProviderGroupIds: number[]
 }
 
 export type BlacklistedVehicleOrderByType = 'id' | 'brand' | 'model' | 'fuelType'

package/types/contractProviderFlags.d.ts

@@ -1,13 +1,17 @@
 export type TContractProviderFlagKey = 'RENAULT_UNIQ_PDF_FORMAT'
 
+/** Exactly one of the two ids is sent: a flag row is owned by a provider or by a group. */
 export interface ContractProviderFlagRequest {
-  contractProviderId: number
+  contractProviderId?: number
+  contractProviderGroupId?: number
 }
 
 export interface ContractProviderFlagResponse {
   id: number
   featureKey: TContractProviderFlagKey
-  contractProviderId: number
-  contractProviderName: string
+  contractProviderId: number | null
+  contractProviderName: string | null
+  contractProviderGroupId: number | null
+  contractProviderGroupName: string | null
   updatedByUser: string
 }

package/types/contractProviderGroup.d.ts

@@ -0,0 +1,58 @@
+import { ProviderState } from './contractProvider'
+import { EmailCampaignStatus } from './emailCampaign'
+
+export interface IContractProviderGroupMember {
+  contractProviderId: number
+  administrativeName: string
+  isoName: string // country
+  state: ProviderState // lets every picker count Inactive members
+}
+
+export interface IProviderGroupTag {
+  providerGroupTagId: number
+  name: string
+}
+
+export interface IContractProviderGroupListItem {
+  contractProviderGroupId: number
+  name: string
+  description: string | null
+  tags: IProviderGroupTag[]
+  memberCount: number
+  inactiveMemberCount: number
+  archivedAt: string | null // ISO
+  updatedByEmail: string // 'USER NOT FOUND' when the acting user is gone
+}
+
+export type IContractProviderGroupDetail = IContractProviderGroupListItem & {
+  members: IContractProviderGroupMember[]
+  createdAt: string // ISO
+  updatedAt: string // ISO
+}
+
+export interface IContractProviderGroupUsage {
+  accessKeys: { accessKeyId: number; description: string | null }[]
+  emailCampaigns: { id: number; name: string; status: EmailCampaignStatus }[]
+  blacklistEntryCount: number
+  documentCount: number
+  dashboardBannerCount: number
+  featureFlagCount: number
+}
+
+export interface IUpsertContractProviderGroupRequest {
+  name: string
+  description: string | null
+  tags: string[]
+  contractProviderIds: number[]
+}
+
+// The provider-side view of membership: every joinable group, plus any archived group this provider is
+// still in (archived groups can be left but not joined).
+export interface IContractProviderGroupMembership {
+  groups: IContractProviderGroupListItem[]
+  memberGroupIds: number[]
+}
+
+export interface ISetContractProviderGroupsRequest {
+  contractProviderGroupIds: number[] // the full set for one provider; the api diffs it against what is stored
+}

package/types/dashboardBanner.d.ts

@@ -1,32 +1,39 @@
-import { TIsoCountry } from './country';
+import { TIsoCountry } from './country'
+
 /**
  * Request body for creating or updating a dashboard banner (Superadmin)
  */
 export interface DashboardBannerRequest {
-    text: string;
-    countryIso: TIsoCountry;
-    /**
-     * ISO date string (YYYY-MM-DD) for the start date of the banner
-     */
-    startDate: string;
-    /**
-     * ISO date string (YYYY-MM-DD) for the end date of the banner
-     */
-    endDate: string;
+  text: string
+  /**
+   * Exactly one of the two targets the banner: a whole country, or the members of one provider group.
+   * A group banner takes precedence over a country one.
+   */
+  countryIso?: TIsoCountry | null
+  contractProviderGroupId?: number | null
+  /**
+   * ISO date string (YYYY-MM-DD) for the start date of the banner
+   */
+  startDate: string
+  /**
+   * ISO date string (YYYY-MM-DD) for the end date of the banner
+   */
+  endDate: string
 }
 /**
  * Response body for retrieving a dashboard banner (Superadmin)
  */
 export interface DashboardBannerResponse extends DashboardBannerRequest {
-    id: number;
-    /**
-     * Email of the user who last updated the banner
-     */
-    updatedByUser: string;
+  id: number
+  contractProviderGroupName: string | null
+  /**
+   * Email of the user who last updated the banner
+   */
+  updatedByUser: string
 }
 /**
  * Response body for retrieving dashboard banner text in Admin
  */
 export interface ProviderDashboardBannerResponse {
-    text: string;
+  text: string
 }

package/types/emailCampaign.d.ts

@@ -10,12 +10,19 @@ export declare enum EmailCampaignStatus {
 }
 export declare type EmailCampaignRole = 'admin' | 'seller';
 export declare type EmailCampaignSelectionMode = 'all' | 'subset';
+export declare type EmailCampaignProviderMode = EmailCampaignSelectionMode | 'group';
 export declare type EmailCampaignProviderSelection = {
     providerMode: 'all';
     selectedProviderIds: null;
+    selectedGroupIds: null;
 } | {
     providerMode: 'subset';
     selectedProviderIds: number[];
+    selectedGroupIds: null;
+} | {
+    providerMode: 'group';
+    selectedProviderIds: null;
+    selectedGroupIds: number[];
 };
 export declare type EmailCampaignRecipientSelection = {
     recipientMode: 'all';

package/types/emailCampaign.ts

@@ -21,11 +21,15 @@ export type EmailCampaignRole = 'admin' | 'seller'
 // How a pool (providers or recipients) is narrowed: 'all' = every match, 'subset' = explicit ids.
 export type EmailCampaignSelectionMode = 'all' | 'subset'
 
+// The provider dimension has a third mode the recipient dimension does not: 'group'.
+export type EmailCampaignProviderMode = EmailCampaignSelectionMode | 'group'
+
 // Provider dimension: mode is discriminated against its selection, so an invalid combination can't type-check.
 // The candidate-pool filter (`filters`) is carried separately on the request/detail DTOs.
 export type EmailCampaignProviderSelection =
-  | { providerMode: 'all'; selectedProviderIds: null }
-  | { providerMode: 'subset'; selectedProviderIds: number[] }
+  | { providerMode: 'all'; selectedProviderIds: null; selectedGroupIds: null }
+  | { providerMode: 'subset'; selectedProviderIds: number[]; selectedGroupIds: null }
+  | { providerMode: 'group'; selectedProviderIds: null; selectedGroupIds: number[] }
 
 // Recipient dimension: mode is discriminated against its user picks.
 export type EmailCampaignRecipientSelection =

package/types/index.d.ts

@@ -175,6 +175,7 @@ export * from './invoice';
 export * from './locale';
 export * from './localizationData';
 export * from './model';
+export * from './myPage';
 export * from './outage';
 export * from './payment';
 export * from './priceCalculation';
@@ -218,3 +219,4 @@ export * from './ISendEmail';
 export * from './emailCampaign';
 export * from './contractProviderFlags';
 export * from './providerDocument';
+export * from './contractProviderGroup';

package/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/types/index.ts

@@ -194,6 +194,7 @@ export * from './invoice'
 export * from './locale'
 export * from './localizationData'
 export * from './model'
+export * from './myPage'
 export * from './outage'
 export * from './payment'
 export * from './priceCalculation'
@@ -237,3 +238,4 @@ export * from './ISendEmail'
 export * from './emailCampaign'
 export * from './contractProviderFlags'
 export * from './providerDocument'
+export * from './contractProviderGroup'

package/types/myPage/index.d.ts

@@ -0,0 +1 @@
+export * from './payment'

package/types/myPage/payment.d.ts

@@ -0,0 +1,18 @@
+import { IPublicKeyResponse, ISetupIntentResponse } from '../admin/contractCreation/contractCreation'
+
+/**
+ * Everything a client needs to mount Stripe Elements against the provider's connected Stripe
+ * account: the SetupIntent secret, the platform publishable key and the account to run Stripe.js
+ * against. Returned by the MyPage setup-intent endpoints, for both activating an offer and
+ * adding a card to a running subscription.
+ */
+export type TStripeElementsSetupIntent = ISetupIntentResponse & IPublicKeyResponse
+
+/**
+ * Body of the customer-facing set-payment-method endpoints. The contract is taken from the route
+ * param or the accept-contract token, so only the payment method confirmed client-side is sent.
+ * The admin counterpart is `ISetPaymentMethodRequest`, which names the contract in the body.
+ */
+export interface ISetPaymentMethodCustomerRequest {
+  paymentMethodId: string
+}

package/types/payment.d.ts

@@ -22,25 +22,6 @@ export interface PaymentPlan {
   totalCost: PriceSpecification
 }
 
-/**
- * Payload to Initialize a Stripe Checkout Session.
- */
-export interface IPreparePaymentRequest {
-  prettyIdentifier: string
-  success_url: string
-}
-
-/**
- * Response payload from from a Stripe Checkout Session initialization request.
- */
-export interface IPreparePaymentResponse {
-  prettyIdentifier: string
-  paymentGateway: PaymentGateway
-  checkoutSessionId?: string
-  stripePublicKey?: string
-  stripeAccount?: string
-}
-
 /**
  * Payload to create settlement payments.
  */

package/types/providerDocument.d.ts

@@ -16,9 +16,12 @@ export interface IProviderDocument {
 // Admin sees the document and its upload date only — no internal staff names.
 export interface IProviderDocumentAdminView extends IProviderDocument {}
 
-// Superadmin additionally sees the acting support users and the tombstone state.
+// Superadmin also sees the acting support users, the tombstone state, and the sharing group. The group
+// fields are null on a provider-owned row.
 export interface IProviderDocumentSuperadminView extends IProviderDocument {
   uploadedByName: string | null
   deletedAt: string | null
   deletedByName: string | null
+  contractProviderGroupId: number | null
+  contractProviderGroupName: string | null
 }

package/types/responseErrors/contractProviderGroupErrors.d.ts

@@ -0,0 +1 @@
+export type ContractProviderGroupErrors = 'CONTRACT_PROVIDER_GROUP_NAME_TAKEN' | 'CONTRACT_PROVIDER_GROUP_IN_USE'

package/types/responseErrors/index.d.ts

@@ -1,6 +1,7 @@
 import { AdjustmentRequestResponseErrors } from './adjustmentRequestResponseErrors'
 import { AdminPaymentErrors } from './adminPaymentErrors'
 import { CalculatorResponseErrors } from './calculatorResponseErrors'
+import { ContractProviderGroupErrors } from './contractProviderGroupErrors'
 import { ContractResponseErrors } from './contractResponseErrors'
 import { GenericResponseErrors } from './genericResponseTypes'
 import { ImportErrors } from './importErrors'
@@ -17,6 +18,7 @@ export type ResponseErrors =
   | AdjustmentRequestResponseErrors
   | AdminPaymentErrors
   | CalculatorResponseErrors
+  | ContractProviderGroupErrors
   | ContractResponseErrors
   | GenericResponseErrors
   | ImportErrors