@ufcalendar/sdk 0.8.3 → 0.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1171,11 +1171,13 @@ interface Plan {
1171
1171
  interface Plans {
1172
1172
  currency: string;
1173
1173
  plans: Plan[];
1174
- trial: {
1175
- hours: number;
1176
- requests: number;
1174
+ /** The permanent free plan (2026-10-29): 1,000 requests a month, no card, never expires. */
1175
+ free_plan: {
1176
+ requests_per_month: number;
1177
+ rpm: number;
1178
+ key_limit: number;
1177
1179
  card_required: boolean;
1178
- per_account: number;
1180
+ expires: boolean;
1179
1181
  start_url: string;
1180
1182
  };
1181
1183
  mcp: {
@@ -1377,7 +1379,7 @@ declare class FightAPI {
1377
1379
  /** Raw GET returning the whole `{data, meta}` envelope. */
1378
1380
  getWithMeta<T = unknown>(path: string, params?: Query): Promise<Envelope<T>>;
1379
1381
  /**
1380
- * Plans, quotas, the free 1-day trial rule, the MCP endpoint and the doc
1382
+ * Plans (Free first), quotas, the free-plan rule, the MCP endpoint and the doc
1381
1383
  * links. The only endpoint that answers without a credential.
1382
1384
  */
1383
1385
  plans(): Promise<Plans>;
@@ -1738,7 +1740,7 @@ declare class FightAPI {
1738
1740
 
1739
1741
  /** Kept in lockstep with package.json and the User-Agent by
1740
1742
  * `apps/api/src/surfaces.test.ts`. Bump all three together. */
1741
- declare const VERSION = "0.8.3";
1743
+ declare const VERSION = "0.8.4";
1742
1744
 
1743
1745
  /**
1744
1746
  * This file was auto-generated by openapi-typescript.
@@ -1755,7 +1757,7 @@ interface paths {
1755
1757
  };
1756
1758
  /**
1757
1759
  * Plans, quotas and how to connect (no key required)
1758
- * @description The only endpoint that answers without a credential. Returns every plan with its monthly request quota, per-minute limit, key limit and a `checkout_url`; the terms of the free 1-day trial and the URL that starts it; the MCP endpoint with both of its auth doors; and the documentation links. Static per deploy and cached an hour — poll it never, read it once.
1760
+ * @description The only endpoint that answers without a credential. Returns every plan, Free first, with its monthly request quota, per-minute limit, key limit and a `checkout_url`; the free-plan terms (1,000 requests a month, no card, never expires) and the URL that mints its key; the MCP endpoint with both of its auth doors; and the documentation links. Static per deploy and cached an hour — poll it never, read it once.
1759
1761
  */
1760
1762
  get: {
1761
1763
  parameters: {
@@ -1766,7 +1768,7 @@ interface paths {
1766
1768
  };
1767
1769
  requestBody?: never;
1768
1770
  responses: {
1769
- /** @description Plans, trial rule, MCP endpoint and links */
1771
+ /** @description Plans, the free-plan rule, MCP endpoint and links */
1770
1772
  200: {
1771
1773
  headers: {
1772
1774
  [name: string]: unknown;
@@ -1778,6 +1780,20 @@ interface paths {
1778
1780
  * "currency": "USD",
1779
1781
  * "plans": [
1780
1782
  * {
1783
+ * "key": "free",
1784
+ * "name": "Free",
1785
+ * "price_monthly_usd": 0,
1786
+ * "price_yearly_usd": 0,
1787
+ * "requests_per_month": 1000,
1788
+ * "rpm": 10,
1789
+ * "key_limit": 1,
1790
+ * "features": [
1791
+ * "no card",
1792
+ * "never expires"
1793
+ * ],
1794
+ * "checkout_url": "https://www.ufcalendar.com/account/api?trial=1"
1795
+ * },
1796
+ * {
1781
1797
  * "key": "hobby",
1782
1798
  * "name": "Hobby",
1783
1799
  * "price_monthly_usd": 19,
@@ -1789,11 +1805,12 @@ interface paths {
1789
1805
  * "checkout_url": "https://www.ufcalendar.com/account/api?plan=hobby"
1790
1806
  * }
1791
1807
  * ],
1792
- * "trial": {
1793
- * "hours": 24,
1794
- * "requests": 100,
1808
+ * "free_plan": {
1809
+ * "requests_per_month": 1000,
1810
+ * "rpm": 10,
1811
+ * "key_limit": 1,
1795
1812
  * "card_required": false,
1796
- * "per_account": 1,
1813
+ * "expires": false,
1797
1814
  * "start_url": "https://www.ufcalendar.com/account/api?trial=1"
1798
1815
  * },
1799
1816
  * "mcp": {
@@ -1919,7 +1936,7 @@ interface paths {
1919
1936
  "application/json": components["schemas"]["Error"];
1920
1937
  };
1921
1938
  };
1922
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
1939
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
1923
1940
  403: {
1924
1941
  headers: {
1925
1942
  [name: string]: unknown;
@@ -2024,7 +2041,7 @@ interface paths {
2024
2041
  "application/json": components["schemas"]["Error"];
2025
2042
  };
2026
2043
  };
2027
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
2044
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
2028
2045
  403: {
2029
2046
  headers: {
2030
2047
  [name: string]: unknown;
@@ -2230,7 +2247,7 @@ interface paths {
2230
2247
  "application/json": components["schemas"]["Error"];
2231
2248
  };
2232
2249
  };
2233
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
2250
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
2234
2251
  403: {
2235
2252
  headers: {
2236
2253
  [name: string]: unknown;
@@ -2411,7 +2428,7 @@ interface paths {
2411
2428
  "application/json": components["schemas"]["Error"];
2412
2429
  };
2413
2430
  };
2414
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
2431
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
2415
2432
  403: {
2416
2433
  headers: {
2417
2434
  [name: string]: unknown;
@@ -2544,7 +2561,7 @@ interface paths {
2544
2561
  "application/json": components["schemas"]["Error"];
2545
2562
  };
2546
2563
  };
2547
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
2564
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
2548
2565
  403: {
2549
2566
  headers: {
2550
2567
  [name: string]: unknown;
@@ -2659,7 +2676,7 @@ interface paths {
2659
2676
  "application/json": components["schemas"]["Error"];
2660
2677
  };
2661
2678
  };
2662
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
2679
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
2663
2680
  403: {
2664
2681
  headers: {
2665
2682
  [name: string]: unknown;
@@ -2838,7 +2855,7 @@ interface paths {
2838
2855
  "application/json": components["schemas"]["Error"];
2839
2856
  };
2840
2857
  };
2841
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
2858
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
2842
2859
  403: {
2843
2860
  headers: {
2844
2861
  [name: string]: unknown;
@@ -3069,7 +3086,7 @@ interface paths {
3069
3086
  "application/json": components["schemas"]["Error"];
3070
3087
  };
3071
3088
  };
3072
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
3089
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
3073
3090
  403: {
3074
3091
  headers: {
3075
3092
  [name: string]: unknown;
@@ -3220,7 +3237,7 @@ interface paths {
3220
3237
  "application/json": components["schemas"]["Error"];
3221
3238
  };
3222
3239
  };
3223
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
3240
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
3224
3241
  403: {
3225
3242
  headers: {
3226
3243
  [name: string]: unknown;
@@ -3427,7 +3444,7 @@ interface paths {
3427
3444
  "application/json": components["schemas"]["Error"];
3428
3445
  };
3429
3446
  };
3430
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
3447
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
3431
3448
  403: {
3432
3449
  headers: {
3433
3450
  [name: string]: unknown;
@@ -3603,7 +3620,7 @@ interface paths {
3603
3620
  "application/json": components["schemas"]["Error"];
3604
3621
  };
3605
3622
  };
3606
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
3623
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
3607
3624
  403: {
3608
3625
  headers: {
3609
3626
  [name: string]: unknown;
@@ -3809,7 +3826,7 @@ interface paths {
3809
3826
  "application/json": components["schemas"]["Error"];
3810
3827
  };
3811
3828
  };
3812
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
3829
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
3813
3830
  403: {
3814
3831
  headers: {
3815
3832
  [name: string]: unknown;
@@ -3994,7 +4011,7 @@ interface paths {
3994
4011
  "application/json": components["schemas"]["Error"];
3995
4012
  };
3996
4013
  };
3997
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
4014
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
3998
4015
  403: {
3999
4016
  headers: {
4000
4017
  [name: string]: unknown;
@@ -4099,7 +4116,7 @@ interface paths {
4099
4116
  "application/json": components["schemas"]["Error"];
4100
4117
  };
4101
4118
  };
4102
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
4119
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
4103
4120
  403: {
4104
4121
  headers: {
4105
4122
  [name: string]: unknown;
@@ -4204,7 +4221,7 @@ interface paths {
4204
4221
  "application/json": components["schemas"]["Error"];
4205
4222
  };
4206
4223
  };
4207
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
4224
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
4208
4225
  403: {
4209
4226
  headers: {
4210
4227
  [name: string]: unknown;
@@ -4414,7 +4431,7 @@ interface paths {
4414
4431
  "application/json": components["schemas"]["Error"];
4415
4432
  };
4416
4433
  };
4417
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
4434
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
4418
4435
  403: {
4419
4436
  headers: {
4420
4437
  [name: string]: unknown;
@@ -4735,7 +4752,7 @@ interface paths {
4735
4752
  "application/json": components["schemas"]["Error"];
4736
4753
  };
4737
4754
  };
4738
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
4755
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
4739
4756
  403: {
4740
4757
  headers: {
4741
4758
  [name: string]: unknown;
@@ -5180,7 +5197,7 @@ interface paths {
5180
5197
  "application/json": components["schemas"]["Error"];
5181
5198
  };
5182
5199
  };
5183
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
5200
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
5184
5201
  403: {
5185
5202
  headers: {
5186
5203
  [name: string]: unknown;
@@ -5344,7 +5361,7 @@ interface paths {
5344
5361
  "application/json": components["schemas"]["Error"];
5345
5362
  };
5346
5363
  };
5347
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
5364
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
5348
5365
  403: {
5349
5366
  headers: {
5350
5367
  [name: string]: unknown;
@@ -5449,7 +5466,7 @@ interface paths {
5449
5466
  "application/json": components["schemas"]["Error"];
5450
5467
  };
5451
5468
  };
5452
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
5469
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
5453
5470
  403: {
5454
5471
  headers: {
5455
5472
  [name: string]: unknown;
@@ -5645,7 +5662,7 @@ interface paths {
5645
5662
  "application/json": components["schemas"]["Error"];
5646
5663
  };
5647
5664
  };
5648
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
5665
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
5649
5666
  403: {
5650
5667
  headers: {
5651
5668
  [name: string]: unknown;
@@ -5788,7 +5805,7 @@ interface paths {
5788
5805
  "application/json": components["schemas"]["Error"];
5789
5806
  };
5790
5807
  };
5791
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
5808
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
5792
5809
  403: {
5793
5810
  headers: {
5794
5811
  [name: string]: unknown;
@@ -6113,7 +6130,7 @@ interface paths {
6113
6130
  "application/json": components["schemas"]["Error"];
6114
6131
  };
6115
6132
  };
6116
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
6133
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
6117
6134
  403: {
6118
6135
  headers: {
6119
6136
  [name: string]: unknown;
@@ -6267,7 +6284,7 @@ interface paths {
6267
6284
  "application/json": components["schemas"]["Error"];
6268
6285
  };
6269
6286
  };
6270
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
6287
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
6271
6288
  403: {
6272
6289
  headers: {
6273
6290
  [name: string]: unknown;
@@ -6382,7 +6399,7 @@ interface paths {
6382
6399
  "application/json": components["schemas"]["Error"];
6383
6400
  };
6384
6401
  };
6385
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
6402
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
6386
6403
  403: {
6387
6404
  headers: {
6388
6405
  [name: string]: unknown;
@@ -6532,7 +6549,7 @@ interface paths {
6532
6549
  "application/json": components["schemas"]["Error"];
6533
6550
  };
6534
6551
  };
6535
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
6552
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
6536
6553
  403: {
6537
6554
  headers: {
6538
6555
  [name: string]: unknown;
@@ -6666,7 +6683,7 @@ interface paths {
6666
6683
  "application/json": components["schemas"]["Error"];
6667
6684
  };
6668
6685
  };
6669
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
6686
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
6670
6687
  403: {
6671
6688
  headers: {
6672
6689
  [name: string]: unknown;
@@ -6912,7 +6929,7 @@ interface paths {
6912
6929
  "application/json": components["schemas"]["Error"];
6913
6930
  };
6914
6931
  };
6915
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
6932
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
6916
6933
  403: {
6917
6934
  headers: {
6918
6935
  [name: string]: unknown;
@@ -7101,7 +7118,7 @@ interface paths {
7101
7118
  "application/json": components["schemas"]["Error"];
7102
7119
  };
7103
7120
  };
7104
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
7121
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
7105
7122
  403: {
7106
7123
  headers: {
7107
7124
  [name: string]: unknown;
@@ -7253,7 +7270,7 @@ interface paths {
7253
7270
  "application/json": components["schemas"]["Error"];
7254
7271
  };
7255
7272
  };
7256
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
7273
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
7257
7274
  403: {
7258
7275
  headers: {
7259
7276
  [name: string]: unknown;
@@ -7394,7 +7411,7 @@ interface paths {
7394
7411
  "application/json": components["schemas"]["Error"];
7395
7412
  };
7396
7413
  };
7397
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
7414
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
7398
7415
  403: {
7399
7416
  headers: {
7400
7417
  [name: string]: unknown;
@@ -7549,7 +7566,7 @@ interface paths {
7549
7566
  "application/json": components["schemas"]["Error"];
7550
7567
  };
7551
7568
  };
7552
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
7569
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
7553
7570
  403: {
7554
7571
  headers: {
7555
7572
  [name: string]: unknown;
@@ -7604,7 +7621,7 @@ interface paths {
7604
7621
  };
7605
7622
  /**
7606
7623
  * Matchmaker board
7607
- * @description UFCalendar's matchmaker for one MMA promotion (`ufc`, `pfl`, `oktagon`, `rizin`; `bkfc` 400s `unsupported_org` — the engine runs on the Power Index, which rates MMA only). Every candidate pair inside a division is scored 0–100 for rank proximity, momentum, competitiveness, readiness and story (rematches, trilogy deciders, eliminators): the promotion's official ladder where one exists plus the strongest active unranked Power Index fighters. A promotion with no official ladder (`rizin`) draws only on its current roster — fighters whose latest bout in the promotion is within 450 days — and its pairs are weighted by what each fighter has done there (title fights, wins, career pedigree), so a former champion is not paired with a two-fight prospect. UFC pairs are scored by UFCalendar's booking model (a ranker trained on every realized UFC booking), weighted by the stakes term; other promotions use the fitted heuristic. Fighters already booked leave the board, pairs already booked are excluded, and one fighter appears in at most two slips per division.
7624
+ * @description UFCalendar's matchmaker for one MMA promotion (`ufc`, `pfl`, `oktagon`, `rizin`; `bkfc` 400s `unsupported_org` — the engine runs on the Power Index, which rates MMA only). Every candidate pair inside a division is scored 0–100 for rank proximity, momentum, competitiveness, readiness and story (rematches, trilogy deciders, eliminators): the promotion's official ladder where one exists plus the strongest active unranked Power Index fighters. A promotion with no official ladder (`rizin`) draws only on its current roster — fighters whose latest bout in the promotion is within 450 days — and its pairs are weighted by what each fighter has done there (title fights, wins, career pedigree), so a former champion is not paired with a two-fight prospect. UFC and RIZIN pairs are scored by UFCalendar's booking model (a ranker trained on every realized UFC booking, which also beat the heuristic on RIZIN's own bookings), weighted by the stakes term; other promotions use the fitted heuristic. Fighters already booked leave the board, pairs already booked are excluded, and one fighter appears in at most two slips per division.
7608
7625
  *
7609
7626
  * Without `division` the list is the cross-division top board (at most two slips per division); with it, that division's best pairs. `meta.divisions` lists the promotion's divisions (an unknown one 400s `invalid_division`), `meta.rankings_date` the ladder snapshot used (null when the promotion has no current ladder). Each slip: `key` (`lo-hi` fighter ids), `a` (red corner — the better-credentialed side) and `b` with `rank` (0 = champion, null = unranked), `power_index`, `streak` (signed: +3 = three straight wins) and `booked`; `score`; `win_probability_a` from the two Power Index ratings; `tags` (`title`, `eliminator`, `coinFlip`, `bothStreaking`, `finishers`, `trilogyDecider`, `unfinishedBusiness`, `rematch`, `unrankedGem`, `bounceBack`, `steppingUp`, `bothDue`, `booked`).
7610
7627
  *
@@ -7728,7 +7745,7 @@ interface paths {
7728
7745
  "application/json": components["schemas"]["Error"];
7729
7746
  };
7730
7747
  };
7731
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
7748
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
7732
7749
  403: {
7733
7750
  headers: {
7734
7751
  [name: string]: unknown;
@@ -7901,7 +7918,7 @@ interface paths {
7901
7918
  "application/json": components["schemas"]["Error"];
7902
7919
  };
7903
7920
  };
7904
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
7921
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
7905
7922
  403: {
7906
7923
  headers: {
7907
7924
  [name: string]: unknown;
@@ -8083,7 +8100,7 @@ interface paths {
8083
8100
  "application/json": components["schemas"]["Error"];
8084
8101
  };
8085
8102
  };
8086
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
8103
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8087
8104
  403: {
8088
8105
  headers: {
8089
8106
  [name: string]: unknown;
@@ -8275,7 +8292,7 @@ interface paths {
8275
8292
  "application/json": components["schemas"]["Error"];
8276
8293
  };
8277
8294
  };
8278
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
8295
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8279
8296
  403: {
8280
8297
  headers: {
8281
8298
  [name: string]: unknown;
@@ -8511,7 +8528,7 @@ interface paths {
8511
8528
  "application/json": components["schemas"]["Error"];
8512
8529
  };
8513
8530
  };
8514
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
8531
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8515
8532
  403: {
8516
8533
  headers: {
8517
8534
  [name: string]: unknown;
@@ -8617,7 +8634,7 @@ interface paths {
8617
8634
  "application/json": components["schemas"]["Error"];
8618
8635
  };
8619
8636
  };
8620
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
8637
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8621
8638
  403: {
8622
8639
  headers: {
8623
8640
  [name: string]: unknown;
@@ -8754,7 +8771,7 @@ interface paths {
8754
8771
  "application/json": components["schemas"]["Error"];
8755
8772
  };
8756
8773
  };
8757
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
8774
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8758
8775
  403: {
8759
8776
  headers: {
8760
8777
  [name: string]: unknown;
@@ -8896,7 +8913,7 @@ interface paths {
8896
8913
  "application/json": components["schemas"]["Error"];
8897
8914
  };
8898
8915
  };
8899
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
8916
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
8900
8917
  403: {
8901
8918
  headers: {
8902
8919
  [name: string]: unknown;
@@ -9061,7 +9078,7 @@ interface paths {
9061
9078
  "application/json": components["schemas"]["Error"];
9062
9079
  };
9063
9080
  };
9064
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
9081
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9065
9082
  403: {
9066
9083
  headers: {
9067
9084
  [name: string]: unknown;
@@ -9184,7 +9201,7 @@ interface paths {
9184
9201
  "application/json": components["schemas"]["Error"];
9185
9202
  };
9186
9203
  };
9187
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
9204
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9188
9205
  403: {
9189
9206
  headers: {
9190
9207
  [name: string]: unknown;
@@ -9333,7 +9350,7 @@ interface paths {
9333
9350
  "application/json": components["schemas"]["Error"];
9334
9351
  };
9335
9352
  };
9336
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
9353
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9337
9354
  403: {
9338
9355
  headers: {
9339
9356
  [name: string]: unknown;
@@ -9474,7 +9491,7 @@ interface paths {
9474
9491
  "application/json": components["schemas"]["Error"];
9475
9492
  };
9476
9493
  };
9477
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
9494
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9478
9495
  403: {
9479
9496
  headers: {
9480
9497
  [name: string]: unknown;
@@ -9614,7 +9631,7 @@ interface paths {
9614
9631
  "application/json": components["schemas"]["Error"];
9615
9632
  };
9616
9633
  };
9617
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
9634
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9618
9635
  403: {
9619
9636
  headers: {
9620
9637
  [name: string]: unknown;
@@ -9703,7 +9720,7 @@ interface paths {
9703
9720
  "application/json": components["schemas"]["Error"];
9704
9721
  };
9705
9722
  };
9706
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
9723
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
9707
9724
  403: {
9708
9725
  headers: {
9709
9726
  [name: string]: unknown;
@@ -10198,7 +10215,7 @@ interface paths {
10198
10215
  };
10199
10216
  /**
10200
10217
  * Your quota usage
10201
- * @description Current-month usage for the calling key: tier, requests used/limit, rpm limit, and the reset as both a Unix timestamp (`reset`) and ISO-8601 (`reset_at`); `month` (`YYYYMM`) and `period` (`YYYY-MM`) are the same month in two spellings. On the free 1-day trial, `trial_ends_at` is when access stops (null on a paid plan) — plan around it, not `reset_at`.
10218
+ * @description Current-month usage for the calling key: tier, requests used/limit, rpm limit, and the reset as both a Unix timestamp (`reset`) and ISO-8601 (`reset_at`); `month` (`YYYYMM`) and `period` (`YYYY-MM`) are the same month in two spellings. On the free plan `tier` is `free` (1,000 requests a month, metered per account). On an owner-granted trial, `trial_ends_at` is when the trial ends (null otherwise) — plan around it, not `reset_at`.
10202
10219
  */
10203
10220
  get: {
10204
10221
  parameters: {
@@ -10262,7 +10279,7 @@ interface paths {
10262
10279
  "application/json": components["schemas"]["Error"];
10263
10280
  };
10264
10281
  };
10265
- /** @description No active plan on the key's account (`subscription_required`) — choose a plan or start the free 1-day trial at https://www.ufcalendar.com/account/api. */
10282
+ /** @description No plan on the credential (`subscription_required`) — rare: every account with a key is on at least the free plan (1,000 requests/month, no card; keys at https://www.ufcalendar.com/account/api). */
10266
10283
  403: {
10267
10284
  headers: {
10268
10285
  [name: string]: unknown;
@@ -10360,7 +10377,7 @@ interface components {
10360
10377
  * @description Plan tier.
10361
10378
  * @enum {string}
10362
10379
  */
10363
- Tier: "trial" | "hobby" | "pro" | "business";
10380
+ Tier: "free" | "trial" | "hobby" | "pro" | "business";
10364
10381
  /**
10365
10382
  * @description Webhook event types.
10366
10383
  * @enum {string}
@@ -12344,7 +12361,7 @@ interface components {
12344
12361
  reset_at: string;
12345
12362
  /**
12346
12363
  * Format: date-time
12347
- * @description Trial plans only: when the trial ends and access stops — usually well before `reset_at`. Null on a paid plan.
12364
+ * @description Owner-granted trials only: when the trial ends and the account falls back to the free plan — usually well before `reset_at`. Null on the free plan and on a paid plan.
12348
12365
  */
12349
12366
  trial_ends_at: string | null;
12350
12367
  };
@@ -12362,11 +12379,13 @@ interface components {
12362
12379
  Plans: {
12363
12380
  currency: string;
12364
12381
  plans: components["schemas"]["Plan"][];
12365
- trial: {
12366
- hours: number;
12367
- requests: number;
12382
+ free_plan: {
12383
+ requests_per_month: number;
12384
+ rpm: number;
12385
+ key_limit: number;
12368
12386
  card_required: boolean;
12369
- per_account: number;
12387
+ /** @description Always false: the free plan never expires. */
12388
+ expires: boolean;
12370
12389
  start_url: string;
12371
12390
  };
12372
12391
  mcp: {
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // src/version.ts
2
- var VERSION = "0.8.3";
2
+ var VERSION = "0.8.4";
3
3
 
4
4
  // src/client.ts
5
5
  var DEFAULT_BASE_URL = "https://api.ufcalendar.com/v1";
@@ -58,7 +58,7 @@ var FightAPI = class {
58
58
  throw new FightAPIError(
59
59
  401,
60
60
  "no_api_key",
61
- 'No API key. Pass new FightAPI("ufcalendar_...") or set UFCALENDAR_API_KEY. Keys (and the free 1-day trial) live at https://www.ufcalendar.com/account/api'
61
+ 'No API key. Pass new FightAPI("ufcalendar_...") or set UFCALENDAR_API_KEY. Keys (free plan: 1,000 requests/month, no card) live at https://www.ufcalendar.com/account/api'
62
62
  );
63
63
  }
64
64
  const headers = { Accept: "application/json", ...this.#headers };
@@ -138,7 +138,7 @@ var FightAPI = class {
138
138
  }
139
139
  /* --------------------------------------------------------------- plans */
140
140
  /**
141
- * Plans, quotas, the free 1-day trial rule, the MCP endpoint and the doc
141
+ * Plans (Free first), quotas, the free-plan rule, the MCP endpoint and the doc
142
142
  * links. The only endpoint that answers without a credential.
143
143
  */
144
144
  async plans() {
@@ -537,7 +537,7 @@ var FightAPI = class {
537
537
  throw new FightAPIError(
538
538
  401,
539
539
  "no_api_key",
540
- 'No API key. Pass new FightAPI("ufcalendar_...") or set UFCALENDAR_API_KEY. Keys (and the free 1-day trial) live at https://www.ufcalendar.com/account/api'
540
+ 'No API key. Pass new FightAPI("ufcalendar_...") or set UFCALENDAR_API_KEY. Keys (free plan: 1,000 requests/month, no card) live at https://www.ufcalendar.com/account/api'
541
541
  );
542
542
  }
543
543
  return `${this.baseUrl}/calendar/${encodeURIComponent(org)}.ics?key=${encodeURIComponent(this.apiKey)}`;