@scalar/cli 2.10.0 → 2.12.0

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.
Files changed (99) hide show
  1. package/README.md +84 -1289
  2. package/chunks/action-2OPUQFUY.js +164 -0
  3. package/chunks/{action-4GZI2M5B.js → action-36LZ6XXE.js} +19 -17
  4. package/chunks/{action-KDUFU7TZ.js → action-3XMTJJRT.js} +19 -16
  5. package/chunks/{action-R4PGILN4.js → action-6CLEENBI.js} +47 -36
  6. package/chunks/{action-ZFI77WA5.js → action-7HXYZPOT.js} +10 -10
  7. package/chunks/{action-X7BA7PQQ.js → action-AC5ENU6Z.js} +20 -18
  8. package/chunks/{action-PPTFYZWD.js → action-ADGLTNFC.js} +28 -22
  9. package/chunks/{action-7XOHYWYM.js → action-AOKHLTZ6.js} +25 -21
  10. package/chunks/{action-XOADBXSX.js → action-AVSJ3AJY.js} +17 -16
  11. package/chunks/{action-GFLRD7LO.js → action-D3IVCY24.js} +8 -8
  12. package/chunks/action-EBZJS367.js +130 -0
  13. package/chunks/{action-ZKA3RR3S.js → action-EZXHSAJ2.js} +18 -17
  14. package/chunks/{action-5LF4XYHX.js → action-FDTVHVHF.js} +12 -12
  15. package/chunks/{action-JEYDBB3P.js → action-FUO5F7NV.js} +15 -15
  16. package/chunks/{action-DKDRAIKV.js → action-HA3CMV3P.js} +13 -15
  17. package/chunks/{action-YSVTZVKV.js → action-IG3BK2LF.js} +37 -26
  18. package/chunks/{action-H3RTILLM.js → action-IIQMZVRJ.js} +1 -1
  19. package/chunks/{action-DTEO4YNX.js → action-JT6C472I.js} +13 -11
  20. package/chunks/{action-UUL6SWV4.js → action-KDT6H6ML.js} +12 -14
  21. package/chunks/{action-PAM2EZ22.js → action-KJDIJQ3A.js} +8 -7
  22. package/chunks/{action-HT42NUUX.js → action-NF5E7JKA.js} +40 -38
  23. package/chunks/{action-EAUTQ77U.js → action-NIZBME45.js} +26 -24
  24. package/chunks/{action-CB55NWAU.js → action-O757TFA2.js} +9 -9
  25. package/chunks/{action-XLE37MZL.js → action-ONR7QSN7.js} +23 -22
  26. package/chunks/{action-5RL4NWUZ.js → action-QM2BMMHG.js} +33 -30
  27. package/chunks/{action-GWYYTUTM.js → action-QVTAZCKY.js} +5 -5
  28. package/chunks/action-SLB52XRG.js +65 -0
  29. package/chunks/{action-CABLS46Q.js → action-UTFRCKGE.js} +11 -11
  30. package/chunks/{action-4W5GUGEG.js → action-VESBFIP3.js} +20 -19
  31. package/chunks/{action-657A4K2D.js → action-VGFAIFYE.js} +26 -23
  32. package/chunks/action-WCU5O2VT.js +100 -0
  33. package/chunks/{action-TOBU74JH.js → action-XS5EESHW.js} +51 -27
  34. package/chunks/action-XVNRZ5VX.js +38 -0
  35. package/chunks/action-Y7EBKCUU.js +16 -0
  36. package/chunks/{action-5N3P43MD.js → action-YWQ2OKS3.js} +16 -15
  37. package/chunks/{actions-3SAMH7A5.js → actions-6QG7LH7P.js} +23 -20
  38. package/chunks/{agent-2ESZI7NO.js → agent-ONXROEAE.js} +44 -9
  39. package/chunks/{asyncapi-4HGVM3PR.js → asyncapi-7IFXAIE3.js} +13 -12
  40. package/chunks/{build.action-VBGFGACM.js → build.action-FI4OWY3T.js} +28 -26
  41. package/chunks/{chunk-ZGNDXPLU.js → chunk-26VIHQGL.js} +3 -3
  42. package/chunks/{chunk-JXGF5EHC.js → chunk-3HCEUGOE.js} +42 -13
  43. package/chunks/{chunk-G4HRW2FZ.js → chunk-5TNKTLQP.js} +370 -254
  44. package/chunks/{chunk-XAGJJNQW.js → chunk-BB6WWG25.js} +10 -10
  45. package/chunks/{chunk-K2HIB5BA.js → chunk-BCFUMXMC.js} +3 -3
  46. package/chunks/{action-F2ZJNURT.js → chunk-EBNFCIKS.js} +7 -10
  47. package/chunks/{chunk-MC4EMNOR.js → chunk-EJSGWV2K.js} +7 -6
  48. package/chunks/{chunk-GYRQPDTK.js → chunk-FJCOYEKT.js} +139 -3
  49. package/chunks/{chunk-ZKJPLWRJ.js → chunk-HU47OMI4.js} +4 -4
  50. package/chunks/{chunk-VVRUSQCY.js → chunk-I57ID5K7.js} +13 -0
  51. package/chunks/{chunk-43WALAW3.js → chunk-JLNHOA5Z.js} +64 -115
  52. package/chunks/{chunk-5SMP756H.js → chunk-LCSU43NJ.js} +2 -2
  53. package/chunks/{chunk-KHF2QXBG.js → chunk-N645RGAB.js} +1853 -683
  54. package/chunks/{chunk-3ZJYGGAA.js → chunk-ORCUZITN.js} +1 -1
  55. package/chunks/{chunk-H467HDVV.js → chunk-PERC34BV.js} +1 -1
  56. package/chunks/chunk-Q26DFKTY.js +37 -0
  57. package/chunks/{chunk-MMWSCTDB.js → chunk-QJQTSRU4.js} +19 -19
  58. package/chunks/{chunk-WDIWLXLV.js → chunk-RLBS4HJT.js} +3 -3
  59. package/chunks/{chunk-ATNTXKMS.js → chunk-RNZVZMYC.js} +198 -42
  60. package/chunks/{chunk-IPZP3VRA.js → chunk-RYWXF3LO.js} +12 -21
  61. package/chunks/{chunk-CWVYOXXM.js → chunk-SNOAL2C5.js} +11 -7
  62. package/chunks/{chunk-UDBSV3CK.js → chunk-T3R66THO.js} +6085 -4167
  63. package/chunks/{chunk-VYFGRLVQ.js → chunk-U73OW57G.js} +1 -1
  64. package/chunks/chunk-U764PQUA.js +1034 -0
  65. package/chunks/{chunk-KZNRQVMY.js → chunk-UAFCSWQ6.js} +1 -1
  66. package/chunks/{chunk-WB6PWTMU.js → chunk-UBLFIMUA.js} +1 -1
  67. package/chunks/{chunk-WIEXQUTD.js → chunk-UODTHS76.js} +1 -1
  68. package/chunks/chunk-V3MYP5SQ.js +247 -0
  69. package/chunks/{chunk-36LXIJIZ.js → chunk-V6LUKXBV.js} +1 -16
  70. package/chunks/{chunk-6M7TL2G2.js → chunk-VRZSDUZK.js} +45 -5
  71. package/chunks/{chunk-GLWTVLKM.js → chunk-VUNOOPEG.js} +9 -2
  72. package/chunks/chunk-VUXPDHTQ.js +22 -0
  73. package/chunks/{chunk-DHZW7Q7U.js → chunk-VVQOFG76.js} +2 -4
  74. package/chunks/chunk-XP5UM7SF.js +21 -0
  75. package/chunks/{chunk-ZYBLQ5CT.js → chunk-Y6C3H27E.js} +9 -4
  76. package/chunks/{chunk-35Z7VTJT.js → chunk-YTFFBGNQ.js} +52 -38
  77. package/chunks/{chunk-BIMLCGKS.js → chunk-ZNLMQKDU.js} +1 -1
  78. package/chunks/{create.action-DBNIS665.js → create.action-PPMZEMZL.js} +34 -32
  79. package/chunks/{delete.action-GBOZC45K.js → delete.action-GDOHATRZ.js} +30 -28
  80. package/chunks/{delete.action-K7BLK7DK.js → delete.action-VAHKEHEU.js} +29 -27
  81. package/chunks/{get.action-QHKMYZBK.js → get.action-UXFTGO7W.js} +24 -20
  82. package/chunks/{get.action-N3JOY3OU.js → get.action-XON3EZDT.js} +16 -15
  83. package/chunks/{list.action-TJCS6UEY.js → list.action-24F5WDGR.js} +37 -26
  84. package/chunks/{list.action-6SSO3JVN.js → list.action-OQEAEJ5U.js} +39 -29
  85. package/chunks/{publish.action-T24VHRMR.js → publish.action-G7FPDRBZ.js} +45 -43
  86. package/chunks/{scripts-VIBLGKYG.js → scripts-6CI6U32J.js} +1 -1
  87. package/chunks/{update.action-VOE6PH5F.js → update.action-IFIFXZWA.js} +29 -27
  88. package/chunks/{update.action-OGYNBXRU.js → update.action-MJDHVVR3.js} +30 -28
  89. package/index.js +290 -284
  90. package/package.json +2 -2
  91. package/skills/scalar-cli/SKILL.md +49 -49
  92. package/template.md +68 -252
  93. package/chunks/action-FBRY5JKU.js +0 -37
  94. package/chunks/action-LYCNT3KA.js +0 -73
  95. package/chunks/action-OJ2NK25F.js +0 -121
  96. package/chunks/action-U2L5DCFG.js +0 -91
  97. package/chunks/chunk-MNNGUUKJ.js +0 -405
  98. package/chunks/chunk-ZGVZU6L2.js +0 -422
  99. package/docs.html +0 -6977
@@ -2,16 +2,16 @@ import { createRequire as $$cR } from "node:module"; const require = $$cR(import
2
2
  import {
3
3
  findConfig,
4
4
  parseConfig
5
- } from "./chunk-UDBSV3CK.js";
5
+ } from "./chunk-T3R66THO.js";
6
6
  import {
7
7
  ConfigVersion
8
- } from "./chunk-6M7TL2G2.js";
8
+ } from "./chunk-VRZSDUZK.js";
9
9
  import {
10
10
  output
11
11
  } from "./chunk-T5HJUAWB.js";
12
12
  import {
13
13
  external_exports
14
- } from "./chunk-VVRUSQCY.js";
14
+ } from "./chunk-I57ID5K7.js";
15
15
 
16
16
  // src/domains/project/check-config/parse-config.ts
17
17
  import fs from "node:fs";
@@ -23,7 +23,7 @@ function readAndParseConfig(configPath) {
23
23
  success: false,
24
24
  error: {
25
25
  type: "file-not-found",
26
- message: "Could not find the Scalar Configuration file",
26
+ message: "Could not find the Scalar configuration file",
27
27
  inputPath: configPath
28
28
  }
29
29
  };
@@ -36,7 +36,7 @@ function readAndParseConfig(configPath) {
36
36
  success: false,
37
37
  error: {
38
38
  type: "validation-error",
39
- message: "The given Scalar Configuration is invalid",
39
+ message: "Scalar configuration is invalid",
40
40
  filePath: file,
41
41
  prettyError: external_exports.prettifyError(parseConfigResult.error),
42
42
  version: parseConfigResult.version
@@ -47,7 +47,7 @@ function readAndParseConfig(configPath) {
47
47
  success: false,
48
48
  error: {
49
49
  type: "parse-error",
50
- message: "Could not parse the Scalar Configuration file",
50
+ message: "Could not parse the Scalar configuration file",
51
51
  filePath: file,
52
52
  detail: typeof parseConfigResult.error === "string" ? parseConfigResult.error : parseConfigResult.error instanceof Error ? parseConfigResult.error.message : void 0
53
53
  }
@@ -65,20 +65,20 @@ function readAndParseConfig(configPath) {
65
65
  import as from "ansis";
66
66
  function renderConfigError(error) {
67
67
  if (error.type === "file-not-found") {
68
- return output.error().title("Scalar Configuration file not found").message(error.inputPath).line(
68
+ return output.error().title("Scalar configuration file not found").message(error.inputPath).line(
69
69
  as.grey(
70
70
  "Create a `scalar.config.json`, or pass the path to your configuration file as an argument."
71
71
  )
72
72
  ).exit("error");
73
73
  }
74
74
  if (error.type === "parse-error") {
75
- const block2 = output.error().title("Invalid configuration file").message("Could not parse the Scalar Configuration file:").line(error.filePath);
75
+ const block2 = output.error().title("Invalid configuration file").message("Could not parse the Scalar configuration file:").line(error.filePath);
76
76
  if (error.detail) {
77
77
  block2.message(error.detail);
78
78
  }
79
79
  return block2.exit("error");
80
80
  }
81
- const block = output.error().title("The given Scalar Configuration is invalid").message(error.filePath);
81
+ const block = output.error().title("Scalar configuration is invalid").message(error.filePath);
82
82
  const note = versionNote(error.version);
83
83
  if (note) {
84
84
  block.line(note);
@@ -91,7 +91,7 @@ function renderConfigError(error) {
91
91
  }
92
92
  function versionNote(version) {
93
93
  if (version === ConfigVersion.V2) {
94
- return as.grey("Validated as Scalar Configuration v2.0.0.");
94
+ return as.grey("Validated as Scalar configuration v2.0.0.");
95
95
  }
96
96
  if (version === ConfigVersion.V1) {
97
97
  return as.grey(
@@ -1,17 +1,17 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
2
  import {
3
3
  BaseCollections
4
- } from "./chunk-JXGF5EHC.js";
4
+ } from "./chunk-3HCEUGOE.js";
5
5
  import {
6
6
  sdkTrackedApiVersionSpec
7
- } from "./chunk-KHF2QXBG.js";
7
+ } from "./chunk-N645RGAB.js";
8
8
  import {
9
9
  err,
10
10
  ok
11
11
  } from "./chunk-5ENKYZA4.js";
12
12
  import {
13
13
  managedDocSchema
14
- } from "./chunk-GLWTVLKM.js";
14
+ } from "./chunk-VUNOOPEG.js";
15
15
 
16
16
  // src/domains/sdk/inspect-sdk.ts
17
17
  var sdkMetadata = (sdk, builds) => {
@@ -1,11 +1,10 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
- import "./chunk-3MZYUBJ6.js";
3
2
 
4
3
  // src/helpers/documentation/context.ts
5
4
  var AGENT_NOTES = [
6
5
  "Run `scalar <command>` when the CLI is installed, or `npx @scalar/cli <command>` when it is not.",
7
6
  "Run `scalar context` for this command tree as JSON, or `scalar <command> --help` for a single command.",
8
- "Authenticate with a personal token: `scalar auth login --token <token>`, or set `SCALAR_API_KEY` and run `scalar auth login`. Both store the session on disk for later commands. Without a token, `scalar auth login` opens a browser and waits for a person to sign in, so do not run it that way. Check the session with `scalar auth whoami`.",
7
+ "Log in with a personal token: `scalar auth login --token <token>`, or set `SCALAR_API_KEY` and run `scalar auth login`. Both store the session on disk for later commands. Without a token, `scalar auth login` opens a browser and waits for a person to log in, so do not run it that way. Check the session with `scalar auth whoami`.",
9
8
  "Many commands prompt when a value is left out, such as a slug, a team, or a confirmation before overwriting a file, and a prompt blocks a non-interactive run. Pass every value as an argument or flag: for example `--output` on `document bundle` and `document upgrade`, `--yes` on `project rollback`, and `--force` on `project init`.",
10
9
  "Results go to stdout. Errors go to stderr, prefixed with `[ERROR]`."
11
10
  ];
@@ -59,14 +58,12 @@ var buildCliContext = (program) => ({
59
58
  options: visibleOptions(program),
60
59
  commands: program.commands.filter((command) => !isHidden(command)).map((command) => toCommand(command, program.name()))
61
60
  });
61
+ var runnableCommands = (commands) => commands.flatMap((command) => [
62
+ ...command.runnable ? [command] : [],
63
+ ...runnableCommands(command.commands)
64
+ ]);
62
65
 
63
- // src/domains/context/action.ts
64
- var rootCommand = (command) => command.parent ? rootCommand(command.parent) : command;
65
- function contextAction(command) {
66
- const context = buildCliContext(rootCommand(command));
67
- process.stdout.write(`${JSON.stringify(context, null, 2)}
68
- `);
69
- }
70
66
  export {
71
- contextAction
67
+ buildCliContext,
68
+ runnableCommands
72
69
  };
@@ -24,11 +24,12 @@ var parseFetchLimit = (value) => parseIntegerOption(value, 1, Number.MAX_SAFE_IN
24
24
  var DEFAULT_FETCH_CONCURRENCY = 5;
25
25
  function BundleCommand() {
26
26
  const cmd = new Command("bundle");
27
- cmd.description(
28
- "Bundle an OpenAPI document by resolving all references and external dependencies"
27
+ cmd.description("Bundle external references into a single API description");
28
+ cmd.argument("[file|url]", "API description file path or URL to bundle");
29
+ cmd.option(
30
+ "-o, --output <file>",
31
+ "Output file, or - for YAML on stdout (required for URLs and non-interactive use; otherwise confirms overwriting the input file)"
29
32
  );
30
- cmd.argument("[file|url]", "Path to OpenAPI file or URL to bundle");
31
- cmd.option("-o, --output <file>", "Path to save the bundled output file");
32
33
  cmd.option("--treeShake", "Remove unused components from the bundled output");
33
34
  cmd.option(
34
35
  "--urlMap",
@@ -36,12 +37,12 @@ function BundleCommand() {
36
37
  );
37
38
  cmd.option(
38
39
  "--fetchLimit <limit>",
39
- "Maximum number of URLs to fetch during bundling at the same time",
40
+ "Maximum number of concurrent URL fetches",
40
41
  parseFetchLimit
41
42
  );
42
43
  completeFiles(cmd, ["file|url"], ["--output"]);
43
44
  cmd.action(async (...args) => {
44
- const { bundleAction } = await import("./action-7XOHYWYM.js");
45
+ const { bundleAction } = await import("./action-AOKHLTZ6.js");
45
46
  return bundleAction(...args);
46
47
  });
47
48
  return cmd;
@@ -1,7 +1,12 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
2
  import {
3
3
  customProjectIconSchema
4
- } from "./chunk-6M7TL2G2.js";
4
+ } from "./chunk-VRZSDUZK.js";
5
+ import {
6
+ MAX_TEAM_ENVIRONMENTS,
7
+ defaultTeamEnvironments,
8
+ teamEnvironmentSchema
9
+ } from "./chunk-Q26DFKTY.js";
5
10
  import {
6
11
  brandedUid,
7
12
  emailSchema,
@@ -13,8 +18,9 @@ import {
13
18
  schemaModel,
14
19
  slugSchema,
15
20
  timestampSchema,
16
- unixTimestamp
17
- } from "./chunk-VVRUSQCY.js";
21
+ unixTimestamp,
22
+ zod_default
23
+ } from "./chunk-I57ID5K7.js";
18
24
 
19
25
  // ../../packages/entities/dist/team/access.js
20
26
  var ExternalAccessMethod;
@@ -267,6 +273,8 @@ var teamSdkPricing = external_exports.object({
267
273
  endpointCount: external_exports.number().int().nullable(),
268
274
  /** Targets this SDK currently bills. */
269
275
  billedTargets: external_exports.number().int(),
276
+ /** Set when the SDK bills in this band whatever its size. */
277
+ billingBandPin: external_exports.literal("standard").nullish(),
270
278
  band: sdkPriceBandSchema
271
279
  }).array().default([]),
272
280
  /**
@@ -378,6 +386,13 @@ var teamSchema = entitySchema.extend({
378
386
  namespaces: namespaceSchema.array().refine((ns) => !ns.includes("share"), {
379
387
  message: '"share" is a reserved namespace and cannot be used'
380
388
  }).default([]),
389
+ /**
390
+ * The team's environment vocabulary, shared by every entity: each entity's
391
+ * own environments are a subset of it. `production` is always in it and
392
+ * cannot be removed; a version's tag names an environment only once it is
393
+ * listed here.
394
+ */
395
+ environments: teamEnvironmentSchema.array().max(MAX_TEAM_ENVIRONMENTS).default(defaultTeamEnvironments),
381
396
  users: userRefSchema.array(),
382
397
  icons: customProjectIconSchema.array().default([]),
383
398
  pendingInvites: pendingInviteSchema.array().default([]),
@@ -400,6 +415,101 @@ var teamSchema = entitySchema.extend({
400
415
  verified: external_exports.boolean().default(false).optional()
401
416
  }).meta({ id: "team" });
402
417
 
418
+ // ../../packages/entities/dist/team/flat-pricing-report.js
419
+ var flatPricingSkipReasons = [
420
+ "no-billing-id",
421
+ "free-or-trial",
422
+ /** Enterprise plan, or an `enterprise` or `enterprise_sla` item; never moved. */
423
+ "enterprise",
424
+ /** Seat or SDK auto-billing is frozen for a flat-rate contract. */
425
+ "auto-billing-frozen",
426
+ "past-due",
427
+ "no-customer",
428
+ "no-subscription",
429
+ /** More than one subscription Stripe still bills; the webhooks assume one. */
430
+ "multiple-subscriptions",
431
+ /** A cancellation is pending. */
432
+ "cancelling",
433
+ "subscription-schedule",
434
+ "non-usd",
435
+ /** No plan item, more than one, a plan interval other than month or year, or two SDK lines landing on one price. */
436
+ "unsupported-items",
437
+ /** On 2026 pricing in Stripe and Mongo, within its tier's limits. */
438
+ "already-flat",
439
+ /** The target differs from the one the reviewed dry run listed. */
440
+ "changed-since-review"
441
+ ];
442
+ var unmeasuredSdkReasons = [
443
+ "unlinked",
444
+ "unpublished",
445
+ "no-version-row",
446
+ /** The API, its version head or the stored document could not be read. */
447
+ "no-content",
448
+ "unparseable",
449
+ "asyncapi"
450
+ ];
451
+ var lineItemSchema = zod_default.object({
452
+ lookupKey: zod_default.string().nullable(),
453
+ quantity: zod_default.number().int()
454
+ });
455
+ var flatPricingTargetSchema = zod_default.object({
456
+ plan: billingPlanSchema,
457
+ items: zod_default.array(lineItemSchema),
458
+ pinnedSdkUids: zod_default.array(zod_default.string())
459
+ });
460
+ var flatPricingSdkSchema = zod_default.object({
461
+ sdkUid: zod_default.string(),
462
+ name: zod_default.string(),
463
+ /** Targets the SDK bills. */
464
+ targets: zod_default.number().int(),
465
+ endpointCount: zod_default.number().int().nullable(),
466
+ /** The version row's count, a count taken from the stored document, or neither. */
467
+ source: zod_default.enum(["stored", "measured", "unmeasured"]),
468
+ unmeasuredReason: zod_default.enum(unmeasuredSdkReasons).nullable(),
469
+ /** The band its targets bill in today; every target on a legacy subscription bills standard. */
470
+ currentBand: sdkPriceBandSchema,
471
+ /** Pinned to the standard band once the team moves, by this migration or before it. */
472
+ pinned: zod_default.boolean()
473
+ });
474
+ var flatPricingReportSchema = zod_default.object({
475
+ teamUid: zod_default.string(),
476
+ teamName: zod_default.string(),
477
+ plan: billingPlanSchema,
478
+ pricingModel: zod_default.literal("flat_2026").nullable(),
479
+ outcome: zod_default.enum([
480
+ "skipped",
481
+ "would-migrate",
482
+ "migrated",
483
+ /** Flat in Stripe but stale in Mongo: only the team record is written. */
484
+ "would-repair",
485
+ "repaired"
486
+ ]),
487
+ skipReason: zod_default.enum(flatPricingSkipReasons).nullable(),
488
+ subscriptionId: zod_default.string().nullable(),
489
+ /** Which pricing the subscription's plan item is on, read from its lookup key. */
490
+ stripeModel: zod_default.enum(["legacy", "flat"]).nullable(),
491
+ interval: zod_default.enum(["month", "year"]).nullable(),
492
+ /** The plan item's `current_period_end`, in unix seconds: when the new price is first invoiced. */
493
+ renewsAt: zod_default.number().int().nullable(),
494
+ currentItems: zod_default.array(lineItemSchema.extend({ unitAmountUsd: zod_default.number().nullable() })),
495
+ /** Null when a licensed item has no flat unit amount to add up. */
496
+ currentPerCycleUsd: zod_default.number().nullable(),
497
+ projectedPerCycleUsd: zod_default.number().nullable(),
498
+ /** Coupons on the subscription and the customer; an in-place update keeps them. */
499
+ discounts: zod_default.array(zod_default.string()),
500
+ editors: zod_default.number().int(),
501
+ apis: zod_default.number().int(),
502
+ sdks: zod_default.array(flatPricingSdkSchema),
503
+ /** Targets on SDK rows the read drops, billed at the standard band. */
504
+ legacySdkTargets: zod_default.number().int(),
505
+ classification: zod_default.object({
506
+ tier: zod_default.enum(["pro", "business"]),
507
+ reasons: zod_default.array(zod_default.string()),
508
+ exceedsBusiness: zod_default.array(zod_default.string())
509
+ }).nullable(),
510
+ target: flatPricingTargetSchema.nullable()
511
+ }).meta({ id: "flat-pricing-report" });
512
+
403
513
  // ../../packages/entities/dist/team/helpers.js
404
514
  var billingFeatures = {
405
515
  team: {
@@ -499,6 +609,32 @@ var teamPermissions = {
499
609
  }
500
610
  };
501
611
 
612
+ // ../../packages/entities/dist/team/usage-billing-report.js
613
+ var usageBillingReportSchema = zod_default.object({
614
+ teamUid: zod_default.string(),
615
+ outcome: zod_default.enum([
616
+ /** The team has no Stripe customer. */
617
+ "no-customer",
618
+ /** The customer has no subscription Stripe still bills. */
619
+ "no-subscription",
620
+ /** More than one subscription; left for a human, since the webhooks assume one. */
621
+ "multiple-subscriptions",
622
+ /** Canceled or never completed: Stripe no longer bills it, so it is not migrated. */
623
+ "not-billable",
624
+ /** Already flexible with the usage item attached. */
625
+ "up-to-date",
626
+ /** Dry run: would migrate and/or attach the usage item. */
627
+ "would-update",
628
+ "updated"
629
+ ]),
630
+ subscriptionId: zod_default.string().nullable(),
631
+ status: zod_default.string().nullable(),
632
+ billingMode: zod_default.string().nullable(),
633
+ hadUsageItem: zod_default.boolean(),
634
+ /** Intervals of the subscription's items, e.g. ['year', 'month'], to spot unusual contracts. */
635
+ intervals: zod_default.array(zod_default.string())
636
+ }).meta({ id: "usage-billing-report" });
637
+
502
638
  export {
503
639
  roleSchema,
504
640
  userRefSchema,
@@ -1,14 +1,14 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
2
  import {
3
3
  displayError
4
- } from "./chunk-3ZJYGGAA.js";
4
+ } from "./chunk-ORCUZITN.js";
5
5
  import {
6
6
  ISOLATE_DIR,
7
7
  ISOLATE_EXTRACTION_DIR
8
- } from "./chunk-VYFGRLVQ.js";
8
+ } from "./chunk-U73OW57G.js";
9
9
  import {
10
10
  config
11
- } from "./chunk-WB6PWTMU.js";
11
+ } from "./chunk-UBLFIMUA.js";
12
12
  import {
13
13
  output
14
14
  } from "./chunk-T5HJUAWB.js";
@@ -409,7 +409,7 @@ async function downloadIsolate() {
409
409
  const existingIsolateVersion = await getExistingIsolateVersion();
410
410
  const version = config.ssgDocsIsolateVersion;
411
411
  if (version === existingIsolateVersion) return;
412
- const logger = output.info({ animate: true }).loader("Downloading the docs preview server. This may take a minute...");
412
+ const logger = output.info({ animate: true }).loader("Downloading the docs preview server\u2026");
413
413
  try {
414
414
  const completion = await installIsolate(version, existingIsolateVersion);
415
415
  logger.update("loader", 0, { content: completion });
@@ -13779,6 +13779,18 @@ var slugify2 = (str, options) => {
13779
13779
  const ascii = options?.ascii ?? false;
13780
13780
  return str.normalize(ascii ? "NFD" : "NFC").toLowerCase().trim().replace(ascii ? /[^a-z0-9\s.-]/g : /[^\p{L}\p{M}\p{N}\s.-]/gu, "").replace(/[\s-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 255);
13781
13781
  };
13782
+ function deduplicateSlugInSet({ slug, used, limit = 100 }) {
13783
+ if (!used.has(slug)) {
13784
+ used.add(slug);
13785
+ return slug;
13786
+ }
13787
+ let i = 1;
13788
+ while (i < limit && used.has(`${slug}-${i}`))
13789
+ i++;
13790
+ const result = `${slug}-${i}`;
13791
+ used.add(result);
13792
+ return result;
13793
+ }
13782
13794
 
13783
13795
  // ../../packages/entities/dist/utility/utility.js
13784
13796
  import { customAlphabet } from "nanoid";
@@ -17324,6 +17336,7 @@ export {
17324
17336
  randomAccessGroupSlug,
17325
17337
  randomManagedDocSlug,
17326
17338
  slugify2 as slugify,
17339
+ deduplicateSlugInSet,
17327
17340
  schemaModel,
17328
17341
  nanoid3 as nanoid,
17329
17342
  emailSchema,
@@ -1,9 +1,17 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
+ import {
3
+ SdkLanguage,
4
+ sdkVersionStatusSchema,
5
+ sdkVersionTargetStateSchema
6
+ } from "./chunk-RYWXF3LO.js";
7
+ import {
8
+ cloudflareHostnameStateSchema
9
+ } from "./chunk-V3MYP5SQ.js";
2
10
  import {
3
11
  RegistryResourceTypes,
4
12
  baseRegistrySchema,
5
13
  contentShaSchema
6
- } from "./chunk-MNNGUUKJ.js";
14
+ } from "./chunk-U764PQUA.js";
7
15
  import {
8
16
  brandedUid,
9
17
  docVersionSchema,
@@ -19,7 +27,7 @@ import {
19
27
  slugSchema,
20
28
  timestampSchema,
21
29
  unixTimestamp
22
- } from "./chunk-VVRUSQCY.js";
30
+ } from "./chunk-I57ID5K7.js";
23
31
 
24
32
  // ../../packages/entities/dist/access-group/schema.js
25
33
  var emailDomainRegex = /^([A-Za-z0-9]+(-[A-Za-z0-9]+)*\.)+[A-Za-z]{2,}$/i;
@@ -64,8 +72,19 @@ var authIdentitySchema = external_exports.discriminatedUnion("kind", [
64
72
  var authReaderResourceSchema = external_exports.discriminatedUnion("kind", [
65
73
  external_exports.object({ kind: external_exports.literal("project"), uid: external_exports.string() }),
66
74
  external_exports.object({ kind: external_exports.literal("registry"), uid: external_exports.string() }),
67
- /** An MCP installation, by its uuid */
68
- external_exports.object({ kind: external_exports.literal("mcp"), uid: external_exports.string() }),
75
+ external_exports.object({
76
+ kind: external_exports.literal("mcp"),
77
+ /** The MCP server's uid with `environment`, or an installation uuid when `environment` is absent. */
78
+ uid: external_exports.string(),
79
+ /**
80
+ * The environment slug of the server named by `uid`. This is the shape
81
+ * minted today; a resource without it is the legacy installation-uuid
82
+ * shape, which resolves through the legacy address map.
83
+ */
84
+ environment: external_exports.string().nullish(),
85
+ /** The docs project whose host the environment was reached through, whose readers bound the grant too */
86
+ project: external_exports.string().nullish()
87
+ }),
69
88
  /** A namespace's own pages, which list what the reader may see */
70
89
  external_exports.object({ kind: external_exports.literal("namespace") })
71
90
  ]);
@@ -120,6 +139,8 @@ var attemptRequestSchema = external_exports.object({
120
139
  target: authTargetRequestSchema,
121
140
  /** The name of what is being signed in to, as resolved from the resource: `@acme`, `docs.acme.com` */
122
141
  entity: external_exports.string(),
142
+ /** The resource is a server Scalar does not vouch for, which consent warns of */
143
+ unverified: external_exports.boolean().nullish(),
123
144
  /** The login portal that brands a reader's sign-in to the resource */
124
145
  portalUid: external_exports.string().nullish(),
125
146
  /**
@@ -288,6 +309,15 @@ var limitsSnapshotSchema = external_exports.strictObject({
288
309
  teams: external_exports.array(epochSchema)
289
310
  });
290
311
 
312
+ // ../../packages/entities/dist/auth/vcs-link-state.js
313
+ var vcsProviderSchema = external_exports.enum(["github", "bitbucket"]);
314
+ var vcsLinkStateSchema = external_exports.object({
315
+ uid: external_exports.string().min(5),
316
+ userUid: brandedUid(),
317
+ provider: vcsProviderSchema,
318
+ expiresAt: external_exports.date()
319
+ }).meta({ id: "vcs-link-state" });
320
+
291
321
  // ../../packages/entities/dist/auth/domains.js
292
322
  var AuthDomains;
293
323
  (function(AuthDomains2) {
@@ -330,91 +360,6 @@ var relayStateSchema = external_exports.object({
330
360
  }).optional()
331
361
  }).meta({ id: "relay-state", default: "nanoid()" });
332
362
 
333
- // ../../packages/entities/dist/publish/publish.js
334
- var headingRecordSchema = external_exports.object({
335
- slug: external_exports.string(),
336
- name: external_exports.string(),
337
- level: external_exports.coerce.number().int(),
338
- uid: nanoidSchema,
339
- parent: external_exports.string().optional(),
340
- isPageTitle: external_exports.boolean().optional(),
341
- /** `timeline-item` for a changelog entry (`scalar-timeline-item`). Absent for headings. */
342
- kind: external_exports.enum(["timeline-item"]).optional(),
343
- /** Secondary TOC line for a changelog entry, usually its date */
344
- description: external_exports.string().optional()
345
- }).meta({ id: "heading-record" });
346
- var publishAssetSchema = external_exports.object({
347
- path: external_exports.string(),
348
- data: external_exports.string()
349
- }).meta({ id: "publish-asset" });
350
- var typesenseConfigSchema = external_exports.object({
351
- keyId: external_exports.number(),
352
- keyValue: external_exports.string(),
353
- collectionName: external_exports.string()
354
- }).meta({ id: "typesense-config" });
355
-
356
- // ../../packages/entities/dist/deploys/deploy.js
357
- var subpathSchema = external_exports.object({
358
- subpath: external_exports.string(),
359
- projectUid: external_exports.string(),
360
- /**
361
- * The project's own title, for labelling it in cross-project search.
362
- * Written on publish, so it is absent until the project next publishes.
363
- */
364
- name: external_exports.string().optional(),
365
- /**
366
- * The project's active publish, used to cache-bust its search index the
367
- * way a project already busts its own. Absent until it next publishes.
368
- */
369
- publishUid: external_exports.string().optional(),
370
- /**
371
- * Present only for sites still served by Typesense. Builds on the jsonl
372
- * search backend omit it; federated search fetches `${subpath}/search-entries.jsonl`.
373
- */
374
- typesenseConfig: typesenseConfigSchema.optional().nullable()
375
- }).meta({ id: "subpath" });
376
- var cloudflareHttpTokenSchema = external_exports.object({
377
- /** URL path, e.g. `/.well-known/pki-validation/ca3-<id>.txt` */
378
- path: external_exports.string(),
379
- /** Plain-text response body the token path must answer with */
380
- body: external_exports.string()
381
- }).meta({ id: "cloudflare-http-token" });
382
- var cloudflareHostnameStateSchema = external_exports.object({
383
- /** Custom hostname id in the Cloudflare zone */
384
- hostnameId: external_exports.string(),
385
- /** Hostname ownership status reported by Cloudflare (pending, active, …) */
386
- status: external_exports.string(),
387
- /** Certificate status reported by Cloudflare (pending_validation, active, …) */
388
- sslStatus: external_exports.string(),
389
- httpTokens: cloudflareHttpTokenSchema.array().default([]),
390
- /** Unix seconds of the reconciler run that last wrote this state */
391
- syncedAt: external_exports.number()
392
- }).meta({ id: "cloudflare-hostname-state" });
393
- var siteDeploySchema = entitySchema.extend({
394
- domain: external_exports.string(),
395
- teamUid: nanoidSchema,
396
- projectUid: nanoidSchema,
397
- /**
398
- * Title of the project mounted at the domain root.
399
- *
400
- * The root project is deliberately not one of `subpaths` — both request
401
- * matchers resolve by longest path prefix, so a '/' entry would become a
402
- * catch-all that every request matched. It is denormalized here instead so
403
- * search can name and scope it without a second lookup.
404
- */
405
- rootName: external_exports.string().optional(),
406
- subpaths: subpathSchema.array().default([]),
407
- cloudflare: cloudflareHostnameStateSchema.optional().nullable()
408
- }).meta({ id: "site-deploy" });
409
- var searchConfigRootSchema = external_exports.object({
410
- projectUid: external_exports.string(),
411
- name: external_exports.string().optional()
412
- }).meta({ id: "search-config-root" });
413
- var searchConfigResponseSchema = external_exports.object({
414
- subpaths: subpathSchema.array(),
415
- root: searchConfigRootSchema.optional()
416
- }).meta({ id: "search-config-response" });
417
-
418
363
  // ../../packages/entities/dist/login-portals/customization.js
419
364
  var loginPortalEmailSchema = external_exports.object({
420
365
  /** @deprecated No longer rendered in the email template */
@@ -518,30 +463,6 @@ var managedSchema = baseRegistrySchema.extend({
518
463
  format: managedSchemaFormat.default("json")
519
464
  }).meta({ id: "managed-schema" });
520
465
 
521
- // ../../packages/entities/dist/mcp-server/schema.js
522
- var mcpServerToolStates = ["enabled", "disabled"];
523
- var mcpServerRecordSchema = baseRegistrySchema.extend({
524
- /** Own uid, branded so it cannot be confused with another entity's uid */
525
- uid: brandedUid().default(mintUid).meta({ default: "nanoid()" }),
526
- /** The state a tool starts in when a linked document gains an operation. */
527
- defaultToolState: external_exports.enum(mcpServerToolStates).default("enabled"),
528
- /** A custom domain the server is served from, when one is configured. */
529
- domain: external_exports.string().nullable().default(null),
530
- /**
531
- * The Cloudflare custom hostname behind `domain`, mirrored by the edge
532
- * cache sync. Absent until the sync has provisioned it.
533
- */
534
- cloudflare: cloudflareHostnameStateSchema.optional().nullable(),
535
- /**
536
- * When core last asked the sync to re-read the hostname from Cloudflare,
537
- * in Unix milliseconds. The sync's own refresh schedule ends ten minutes
538
- * after a claim, and core holds no Cloudflare credentials, so a domain
539
- * check that finds the CNAME in place but the certificate not yet active
540
- * stamps this for the sync to pick up.
541
- */
542
- domainRefreshRequestedAt: external_exports.number().nullable().optional()
543
- }).meta({ id: "mcp-server-record" });
544
-
545
466
  // ../../packages/entities/dist/mcp-server/domain.js
546
467
  var mcpDomainStatuses = [
547
468
  "pending",
@@ -621,6 +542,23 @@ var webhookEventClaimRecordSchema = entitySchema.extend({
621
542
  expiresAt: external_exports.date()
622
543
  }).meta({ id: "webhook-event-claim-record" });
623
544
 
545
+ // ../../packages/entities/dist/sdk/version.js
546
+ var sdkVersionRecordSchema = entitySchema.extend({
547
+ /** Own uid, branded so it cannot be confused with another entity's uid */
548
+ uid: brandedUid().default(mintUid).meta({ default: "nanoid()" }),
549
+ version: docVersionSchema,
550
+ /** The exact API version this SDK version was created against. */
551
+ apiVersion: docVersionSchema,
552
+ apiDocumentHash: external_exports.string().nullish(),
553
+ status: sdkVersionStatusSchema,
554
+ publishedAt: timestampSchema.nullish(),
555
+ changeSource: external_exports.enum(["user", "api-version", "created"]).nullish(),
556
+ /** SHA-256 of the config string, naming its blob under the SDK's artifacts. */
557
+ configSha: contentShaSchema,
558
+ languages: external_exports.enum(SdkLanguage).array(),
559
+ targets: external_exports.partialRecord(external_exports.enum(SdkLanguage), sdkVersionTargetStateSchema)
560
+ }).meta({ id: "sdk-version-record" });
561
+
624
562
  // ../../packages/entities/dist/waitlist/index.js
625
563
  var WaitlistProducts;
626
564
  (function(WaitlistProducts2) {
@@ -672,7 +610,13 @@ var webhookSubscriptionSchema = entitySchema.extend({
672
610
  */
673
611
  disabledReason: webhookDisabledReasonSchema.nullable().optional(),
674
612
  /** When the platform disabled it, in unix seconds. Nullable, as above. */
675
- disabledAt: external_exports.number().nullable().optional()
613
+ disabledAt: external_exports.number().nullable().optional(),
614
+ /**
615
+ * The uid of the team secret deliveries are signed with, in the auth
616
+ * secret store. Null for a subscription whose secret is still the local
617
+ * record in `webhook-secrets`, keyed by the subscription uid.
618
+ */
619
+ signingSecretUid: nanoidSchema.nullish()
676
620
  }).meta({ id: "webhook-subscription" });
677
621
  var WEBHOOK_SECRET_KEY_VERSION = 1;
678
622
  var WEBHOOK_SECRET_GRACE_PERIOD_SECONDS = 24 * 60 * 60;
@@ -729,6 +673,12 @@ var webhookDeliverySchema = entitySchema.extend({
729
673
  /** Attempts made so far, across Cloud Tasks retries. */
730
674
  attempts: external_exports.number().int().min(0).default(0),
731
675
  status: webhookDeliveryStatusSchema.default("pending"),
676
+ /**
677
+ * Unix seconds until which the attempt last claimed is being made. A
678
+ * dispatch that arrives while it stands leaves the delivery alone; one
679
+ * that arrives after it takes over an attempt that never settled.
680
+ */
681
+ claimedUntil: external_exports.number().nullable().optional(),
732
682
  /** Unix seconds of the most recent attempt. Nullable for the round-trip reason above. */
733
683
  lastAttemptAt: external_exports.number().nullable().optional(),
734
684
  /** HTTP status the endpoint returned, when it returned one at all. */
@@ -902,7 +852,6 @@ export {
902
852
  accessGroupNameSchema,
903
853
  accessGroupSchema,
904
854
  identityProviderRecordSchema,
905
- siteDeploySchema,
906
855
  loginPortalSchema,
907
856
  managedSchemaVersion,
908
857
  managedSchema,
@@ -1,10 +1,10 @@
1
1
  import { createRequire as $$cR } from "node:module"; const require = $$cR(import.meta.url);
2
2
  import {
3
3
  config
4
- } from "./chunk-WB6PWTMU.js";
4
+ } from "./chunk-UBLFIMUA.js";
5
5
  import {
6
6
  RegistryAsset
7
- } from "./chunk-GLWTVLKM.js";
7
+ } from "./chunk-VUNOOPEG.js";
8
8
 
9
9
  // src/domains/registry/helpers/links.ts
10
10
  function registryUrl(path) {