Skip to content

Commit c378572

Browse files
tothandrasGAlexIHU
tothandras
authored and
GAlexIHU
committed
feat(backend): add billing cadence and pro-rating config to plan & subscription
1 parent e2e7936 commit c378572

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

69 files changed

+6824
-3161
lines changed

‎api/api.gen.go‎

Lines changed: 1155 additions & 1080 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎api/client/go/client.gen.go‎

Lines changed: 1123 additions & 1047 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎api/client/javascript/src/client/schemas.ts‎

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3504,6 +3504,24 @@ export interface components {
35043504
* @default USD
35053505
*/
35063506
currency: components['schemas']['CurrencyCode']
3507+
/**
3508+
* Billing cadence
3509+
* Format: duration
3510+
* @description The default billing cadence for subscriptions using this plan.
3511+
* Defines how often customers are billed using ISO8601 duration format.
3512+
* Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
3513+
* @example P1M
3514+
*/
3515+
billingCadence: string
3516+
/**
3517+
* Pro-rating configuration
3518+
* @description Default pro-rating configuration for subscriptions using this plan.
3519+
* @default {
3520+
* "enabled": true,
3521+
* "mode": "prorate_prices"
3522+
* }
3523+
*/
3524+
proRatingConfig?: components['schemas']['ProRatingConfig']
35073525
/**
35083526
* Plan phases
35093527
* @description The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.
@@ -7933,6 +7951,24 @@ export interface components {
79337951
* @default USD
79347952
*/
79357953
currency: components['schemas']['CurrencyCode']
7954+
/**
7955+
* Billing cadence
7956+
* Format: duration
7957+
* @description The default billing cadence for subscriptions using this plan.
7958+
* Defines how often customers are billed using ISO8601 duration format.
7959+
* Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
7960+
* @example P1M
7961+
*/
7962+
billingCadence: string
7963+
/**
7964+
* Pro-rating configuration
7965+
* @description Default pro-rating configuration for subscriptions using this plan.
7966+
* @default {
7967+
* "enabled": true,
7968+
* "mode": "prorate_prices"
7969+
* }
7970+
*/
7971+
proRatingConfig?: components['schemas']['ProRatingConfig']
79367972
/**
79377973
* Effective start date
79387974
* Format: date-time
@@ -8127,6 +8163,24 @@ export interface components {
81278163
* @default USD
81288164
*/
81298165
currency: components['schemas']['CurrencyCode']
8166+
/**
8167+
* Billing cadence
8168+
* Format: duration
8169+
* @description The default billing cadence for subscriptions using this plan.
8170+
* Defines how often customers are billed using ISO8601 duration format.
8171+
* Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
8172+
* @example P1M
8173+
*/
8174+
billingCadence: string
8175+
/**
8176+
* Pro-rating configuration
8177+
* @description Default pro-rating configuration for subscriptions using this plan.
8178+
* @default {
8179+
* "enabled": true,
8180+
* "mode": "prorate_prices"
8181+
* }
8182+
*/
8183+
proRatingConfig?: components['schemas']['ProRatingConfig']
81308184
/**
81318185
* Plan phases
81328186
* @description The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.
@@ -8232,6 +8286,24 @@ export interface components {
82328286
metadata?: components['schemas']['Metadata'] | null
82338287
/** @description Alignment configuration for the plan. */
82348288
alignment?: components['schemas']['Alignment']
8289+
/**
8290+
* Billing cadence
8291+
* Format: duration
8292+
* @description The default billing cadence for subscriptions using this plan.
8293+
* Defines how often customers are billed using ISO8601 duration format.
8294+
* Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
8295+
* @example P1M
8296+
*/
8297+
billingCadence: string
8298+
/**
8299+
* Pro-rating configuration
8300+
* @description Default pro-rating configuration for subscriptions using this plan.
8301+
* @default {
8302+
* "enabled": true,
8303+
* "mode": "prorate_prices"
8304+
* }
8305+
*/
8306+
proRatingConfig?: components['schemas']['ProRatingConfig']
82358307
/**
82368308
* Plan phases
82378309
* @description The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.
@@ -8358,6 +8430,26 @@ export interface components {
83588430
*/
83598431
unitPrice: components['schemas']['UnitPrice'] | null
83608432
}
8433+
/** @description Configuration for pro-rating behavior. */
8434+
ProRatingConfig: {
8435+
/**
8436+
* Enable pro-rating
8437+
* @description Whether pro-rating is enabled for this plan.
8438+
* @default true
8439+
*/
8440+
enabled: boolean
8441+
/**
8442+
* Pro-rating mode
8443+
* @description How to handle pro-rating for billing period changes.
8444+
* @default prorate_prices
8445+
*/
8446+
mode: components['schemas']['ProRatingMode']
8447+
}
8448+
/**
8449+
* @description Pro-rating mode options for handling billing period changes.
8450+
* @enum {string}
8451+
*/
8452+
ProRatingMode: 'prorate_prices'
83618453
/** @description Progress describes a progress of a task. */
83628454
Progress: {
83638455
/**
@@ -9222,6 +9314,24 @@ export interface components {
92229314
* @default USD
92239315
*/
92249316
currency: components['schemas']['CurrencyCode']
9317+
/**
9318+
* Billing cadence
9319+
* Format: duration
9320+
* @description The billing cadence for the subscriptions.
9321+
* Defines how often customers are billed using ISO8601 duration format.
9322+
* Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
9323+
* @example P1M
9324+
*/
9325+
readonly billingCadence: string
9326+
/**
9327+
* Pro-rating configuration
9328+
* @description The pro-rating configuration for the subscriptions.
9329+
* @default {
9330+
* "enabled": true,
9331+
* "mode": "prorate_prices"
9332+
* }
9333+
*/
9334+
readonly proRatingConfig?: components['schemas']['ProRatingConfig']
92259335
}
92269336
/** @description A subscription add-on, represents concrete instances of an add-on for a given subscription. */
92279337
SubscriptionAddon: {
@@ -9573,6 +9683,24 @@ export interface components {
95739683
* @default USD
95749684
*/
95759685
currency: components['schemas']['CurrencyCode']
9686+
/**
9687+
* Billing cadence
9688+
* Format: duration
9689+
* @description The billing cadence for the subscriptions.
9690+
* Defines how often customers are billed using ISO8601 duration format.
9691+
* Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
9692+
* @example P1M
9693+
*/
9694+
readonly billingCadence: string
9695+
/**
9696+
* Pro-rating configuration
9697+
* @description The pro-rating configuration for the subscriptions.
9698+
* @default {
9699+
* "enabled": true,
9700+
* "mode": "prorate_prices"
9701+
* }
9702+
*/
9703+
readonly proRatingConfig?: components['schemas']['ProRatingConfig']
95769704
/** @description Alignment details enriched with the current billing period. */
95779705
alignment?: components['schemas']['SubscriptionAlignment']
95789706
/** @description The phases of the subscription. */
@@ -10804,6 +10932,8 @@ export type PreconditionFailedProblemResponse =
1080410932
components['schemas']['PreconditionFailedProblemResponse']
1080510933
export type PricePaymentTerm = components['schemas']['PricePaymentTerm']
1080610934
export type PriceTier = components['schemas']['PriceTier']
10935+
export type ProRatingConfig = components['schemas']['ProRatingConfig']
10936+
export type ProRatingMode = components['schemas']['ProRatingMode']
1080710937
export type Progress = components['schemas']['Progress']
1080810938
export type RateCard = components['schemas']['RateCard']
1080910939
export type RateCardBooleanEntitlement =

‎api/client/javascript/src/zod/index.ts‎

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10073,6 +10073,12 @@ export const createPlanBodyCurrencyMaxOne = 3
1007310073

1007410074
export const createPlanBodyCurrencyRegExpOne = new RegExp('^[A-Z]{3}$')
1007510075
export const createPlanBodyCurrencyDefault = 'USD'
10076+
export const createPlanBodyProRatingConfigEnabledDefault = true
10077+
export const createPlanBodyProRatingConfigModeDefault = 'prorate_prices'
10078+
export const createPlanBodyProRatingConfigDefault = {
10079+
enabled: true,
10080+
mode: 'prorate_prices',
10081+
}
1007610082
export const createPlanBodyPhasesItemKeyMax = 64
1007710083

1007810084
export const createPlanBodyPhasesItemKeyRegExp = new RegExp(
@@ -10179,6 +10185,11 @@ export const createPlanBody = zod
1017910185
.describe('Alignment configuration for a plan or subscription.')
1018010186
.optional()
1018110187
.describe('Alignment configuration for the plan.'),
10188+
billingCadence: zod
10189+
.string()
10190+
.describe(
10191+
'The default billing cadence for subscriptions using this plan.\nDefines how often customers are billed using ISO8601 duration format.\nExamples: \"P1M\" (monthly), \"P3M\" (quarterly), \"P1Y\" (annually).'
10192+
),
1018210193
currency: zod
1018310194
.string()
1018410195
.min(createPlanBodyCurrencyMinOne)
@@ -11050,6 +11061,23 @@ export const createPlanBody = zod
1105011061
.describe(
1105111062
"The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.\nA phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices."
1105211063
),
11064+
proRatingConfig: zod
11065+
.object({
11066+
enabled: zod
11067+
.boolean()
11068+
.describe('Whether pro-rating is enabled for this plan.'),
11069+
mode: zod
11070+
.enum(['prorate_prices'])
11071+
.describe(
11072+
'Pro-rating mode options for handling billing period changes.'
11073+
)
11074+
.describe('How to handle pro-rating for billing period changes.'),
11075+
})
11076+
.describe('Configuration for pro-rating behavior.')
11077+
.default(createPlanBodyProRatingConfigDefault)
11078+
.describe(
11079+
'Default pro-rating configuration for subscriptions using this plan.'
11080+
),
1105311081
})
1105411082
.describe('Resource create operation model.')
1105511083

@@ -11087,6 +11115,12 @@ export const updatePlanParams = zod.object({
1108711115

1108811116
export const updatePlanBodyNameMax = 256
1108911117
export const updatePlanBodyDescriptionMax = 1024
11118+
export const updatePlanBodyProRatingConfigEnabledDefault = true
11119+
export const updatePlanBodyProRatingConfigModeDefault = 'prorate_prices'
11120+
export const updatePlanBodyProRatingConfigDefault = {
11121+
enabled: true,
11122+
mode: 'prorate_prices',
11123+
}
1109011124
export const updatePlanBodyPhasesItemKeyMax = 64
1109111125

1109211126
export const updatePlanBodyPhasesItemKeyRegExp = new RegExp(
@@ -11193,6 +11227,11 @@ export const updatePlanBody = zod
1119311227
.describe('Alignment configuration for a plan or subscription.')
1119411228
.optional()
1119511229
.describe('Alignment configuration for the plan.'),
11230+
billingCadence: zod
11231+
.string()
11232+
.describe(
11233+
'The default billing cadence for subscriptions using this plan.\nDefines how often customers are billed using ISO8601 duration format.\nExamples: \"P1M\" (monthly), \"P3M\" (quarterly), \"P1Y\" (annually).'
11234+
),
1119611235
description: zod
1119711236
.string()
1119811237
.max(updatePlanBodyDescriptionMax)
@@ -12049,6 +12088,23 @@ export const updatePlanBody = zod
1204912088
.describe(
1205012089
"The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.\nA phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices."
1205112090
),
12091+
proRatingConfig: zod
12092+
.object({
12093+
enabled: zod
12094+
.boolean()
12095+
.describe('Whether pro-rating is enabled for this plan.'),
12096+
mode: zod
12097+
.enum(['prorate_prices'])
12098+
.describe(
12099+
'Pro-rating mode options for handling billing period changes.'
12100+
)
12101+
.describe('How to handle pro-rating for billing period changes.'),
12102+
})
12103+
.describe('Configuration for pro-rating behavior.')
12104+
.default(updatePlanBodyProRatingConfigDefault)
12105+
.describe(
12106+
'Default pro-rating configuration for subscriptions using this plan.'
12107+
),
1205212108
})
1205312109
.describe('Resource update operation model.')
1205412110

@@ -13663,6 +13719,14 @@ export const createSubscriptionBodyCustomPlanCurrencyRegExpOne = new RegExp(
1366313719
'^[A-Z]{3}$'
1366413720
)
1366513721
export const createSubscriptionBodyCustomPlanCurrencyDefault = 'USD'
13722+
export const createSubscriptionBodyCustomPlanProRatingConfigEnabledDefault =
13723+
true
13724+
export const createSubscriptionBodyCustomPlanProRatingConfigModeDefault =
13725+
'prorate_prices'
13726+
export const createSubscriptionBodyCustomPlanProRatingConfigDefault = {
13727+
enabled: true,
13728+
mode: 'prorate_prices',
13729+
}
1366613730
export const createSubscriptionBodyCustomPlanPhasesItemKeyMax = 64
1366713731

1366813732
export const createSubscriptionBodyCustomPlanPhasesItemKeyRegExp = new RegExp(
@@ -13874,6 +13938,11 @@ export const createSubscriptionBody = zod
1387413938
.describe('Alignment configuration for a plan or subscription.')
1387513939
.optional()
1387613940
.describe('Alignment configuration for the plan.'),
13941+
billingCadence: zod
13942+
.string()
13943+
.describe(
13944+
'The default billing cadence for subscriptions using this plan.\nDefines how often customers are billed using ISO8601 duration format.\nExamples: \"P1M\" (monthly), \"P3M\" (quarterly), \"P1Y\" (annually).'
13945+
),
1387713946
currency: zod
1387813947
.string()
1387913948
.min(createSubscriptionBodyCustomPlanCurrencyMinOne)
@@ -14787,6 +14856,25 @@ export const createSubscriptionBody = zod
1478714856
.describe(
1478814857
"The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.\nA phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices."
1478914858
),
14859+
proRatingConfig: zod
14860+
.object({
14861+
enabled: zod
14862+
.boolean()
14863+
.describe('Whether pro-rating is enabled for this plan.'),
14864+
mode: zod
14865+
.enum(['prorate_prices'])
14866+
.describe(
14867+
'Pro-rating mode options for handling billing period changes.'
14868+
)
14869+
.describe(
14870+
'How to handle pro-rating for billing period changes.'
14871+
),
14872+
})
14873+
.describe('Configuration for pro-rating behavior.')
14874+
.default(createSubscriptionBodyCustomPlanProRatingConfigDefault)
14875+
.describe(
14876+
'Default pro-rating configuration for subscriptions using this plan.'
14877+
),
1479014878
})
1479114879
.describe('The template for omitting properties.')
1479214880
.describe(
@@ -16150,6 +16238,14 @@ export const changeSubscriptionBodyCustomPlanCurrencyRegExpOne = new RegExp(
1615016238
'^[A-Z]{3}$'
1615116239
)
1615216240
export const changeSubscriptionBodyCustomPlanCurrencyDefault = 'USD'
16241+
export const changeSubscriptionBodyCustomPlanProRatingConfigEnabledDefault =
16242+
true
16243+
export const changeSubscriptionBodyCustomPlanProRatingConfigModeDefault =
16244+
'prorate_prices'
16245+
export const changeSubscriptionBodyCustomPlanProRatingConfigDefault = {
16246+
enabled: true,
16247+
mode: 'prorate_prices',
16248+
}
1615316249
export const changeSubscriptionBodyCustomPlanPhasesItemKeyMax = 64
1615416250

1615516251
export const changeSubscriptionBodyCustomPlanPhasesItemKeyRegExp = new RegExp(
@@ -16329,6 +16425,11 @@ export const changeSubscriptionBody = zod
1632916425
.describe('Alignment configuration for a plan or subscription.')
1633016426
.optional()
1633116427
.describe('Alignment configuration for the plan.'),
16428+
billingCadence: zod
16429+
.string()
16430+
.describe(
16431+
'The default billing cadence for subscriptions using this plan.\nDefines how often customers are billed using ISO8601 duration format.\nExamples: \"P1M\" (monthly), \"P3M\" (quarterly), \"P1Y\" (annually).'
16432+
),
1633216433
currency: zod
1633316434
.string()
1633416435
.min(changeSubscriptionBodyCustomPlanCurrencyMinOne)
@@ -17242,6 +17343,25 @@ export const changeSubscriptionBody = zod
1724217343
.describe(
1724317344
"The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses.\nA phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices."
1724417345
),
17346+
proRatingConfig: zod
17347+
.object({
17348+
enabled: zod
17349+
.boolean()
17350+
.describe('Whether pro-rating is enabled for this plan.'),
17351+
mode: zod
17352+
.enum(['prorate_prices'])
17353+
.describe(
17354+
'Pro-rating mode options for handling billing period changes.'
17355+
)
17356+
.describe(
17357+
'How to handle pro-rating for billing period changes.'
17358+
),
17359+
})
17360+
.describe('Configuration for pro-rating behavior.')
17361+
.default(changeSubscriptionBodyCustomPlanProRatingConfigDefault)
17362+
.describe(
17363+
'Default pro-rating configuration for subscriptions using this plan.'
17364+
),
1724517365
})
1724617366
.describe('The template for omitting properties.')
1724717367
.describe(

0 commit comments

Comments
 (0)