@warlock.js/core 5.29.0 → 5.30.0

package/esm/mail/test-mailbox.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"test-mailbox.mjs","names":[],"sources":["../../../../../../../core/src/mail/test-mailbox.ts"],"sourcesContent":["/**\n * Test Mailbox for Mail v2\n *\n * Provides utilities for capturing and asserting sent emails in test mode.\n *\n * ## Setup\n *\n * ```typescript\n * import { setMailMode, clearTestMailbox } from \"@warlock.js/core/mail/v2\";\n *\n * beforeEach(() => {\n *   setMailMode(\"test\");\n *   clearTestMailbox();\n * });\n * ```\n *\n * ## Usage\n *\n * ```typescript\n * import { sendMail, getTestMailbox, findMailsTo } from \"@warlock.js/core/mail/v2\";\n *\n * // Send email in test mode\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Welcome!\",\n *   html: \"<p>Hello</p>\",\n * });\n *\n * // Get all captured mails\n * const mails = getTestMailbox();\n * expect(mails).toHaveLength(1);\n * expect(mails[0].options.subject).toBe(\"Welcome!\");\n *\n * // Find specific mails\n * const userMails = findMailsTo(\"user@example.com\");\n * expect(userMails).toHaveLength(1);\n *\n * // Check if mail was sent\n * expect(wasMailSentTo(\"user@example.com\")).toBe(true);\n * expect(wasMailSentWithSubject(\"Welcome!\")).toBe(true);\n * ```\n *\n * ## Assertion Helpers\n *\n * ```typescript\n * // Assert a mail matching a predicate was sent\n * const mail = assertMailSent(m => m.options.to === \"user@example.com\");\n * expect(mail.options.subject).toBe(\"Welcome!\");\n *\n * // Assert exact count\n * assertMailCount(2); // throws if count doesn't match\n * ```\n *\n * ## Captured Mail Structure\n *\n * Each captured mail contains:\n * - `options` - Original MailOptions passed to sendMail\n * - `normalized` - Normalized mail data (arrays, addresses resolved)\n * - `timestamp` - When the mail was captured\n * - `result` - MailResult (in test mode, always success)\n * - `error` - MailError if sending failed (null in test mode)\n *\n * @module test-mailbox\n */\n\nimport type { CapturedMail } from \"./types\";\n\n/**\n * Test mailbox for capturing sent emails in test mode\n */\nlet testMailbox: CapturedMail[] = [];\n\n/**\n * Add a mail to the test mailbox\n */\nexport function captureMail(mail: CapturedMail): void {\n  testMailbox.push(mail);\n}\n\n/**\n * Get all captured mails\n */\nexport function getTestMailbox(): CapturedMail[] {\n  return [...testMailbox];\n}\n\n/**\n * Get the last captured mail\n */\nexport function getLastMail(): CapturedMail | undefined {\n  return testMailbox[testMailbox.length - 1];\n}\n\n/**\n * Find mails by recipient\n */\nexport function findMailsTo(email: string): CapturedMail[] {\n  return testMailbox.filter((mail) => {\n    const to = Array.isArray(mail.options.to) ? mail.options.to : [mail.options.to];\n    return to.includes(email);\n  });\n}\n\n/**\n * Find mails by subject (partial match)\n */\nexport function findMailsBySubject(subject: string): CapturedMail[] {\n  return testMailbox.filter((mail) => mail.options.subject.includes(subject));\n}\n\n/**\n * Check if a mail was sent to a specific recipient\n */\nexport function wasMailSentTo(email: string): boolean {\n  return findMailsTo(email).length > 0;\n}\n\n/**\n * Check if a mail with specific subject was sent\n */\nexport function wasMailSentWithSubject(subject: string): boolean {\n  return testMailbox.some((mail) => mail.options.subject === subject);\n}\n\n/**\n * Get mailbox size\n */\nexport function getMailboxSize(): number {\n  return testMailbox.length;\n}\n\n/**\n * Clear the test mailbox\n */\nexport function clearTestMailbox(): void {\n  testMailbox = [];\n}\n\n/**\n * Assert helper for testing\n */\nexport function assertMailSent(predicate: (mail: CapturedMail) => boolean): CapturedMail {\n  const mail = testMailbox.find(predicate);\n\n  if (!mail) {\n    throw new Error(\"No mail matching the predicate was found in the test mailbox\");\n  }\n\n  return mail;\n}\n\n/**\n * Assert that a specific number of mails were sent\n */\nexport function assertMailCount(count: number): void {\n  if (testMailbox.length !== count) {\n    throw new Error(`Expected ${count} mails to be sent, but found ${testMailbox.length}`);\n  }\n}\n"],"mappings":";;;;AAsEA,IAAI,cAA8B,CAAC;;;;AAKnC,SAAgB,YAAY,MAA0B;CACpD,YAAY,KAAK,IAAI;AACvB;;;;AAKA,SAAgB,iBAAiC;CAC/C,OAAO,CAAC,GAAG,WAAW;AACxB;;;;AAKA,SAAgB,cAAwC;CACtD,OAAO,YAAY,YAAY,SAAS;AAC1C;;;;AAKA,SAAgB,YAAY,OAA+B;CACzD,OAAO,YAAY,QAAQ,SAAS;EAElC,QADW,MAAM,QAAQ,KAAK,QAAQ,EAAE,IAAI,KAAK,QAAQ,KAAK,CAAC,KAAK,QAAQ,EAAE,EACrE,CAAC,SAAS,KAAK;CAC1B,CAAC;AACH;;;;AAKA,SAAgB,mBAAmB,SAAiC;CAClE,OAAO,YAAY,QAAQ,SAAS,KAAK,QAAQ,QAAQ,SAAS,OAAO,CAAC;AAC5E;;;;AAKA,SAAgB,cAAc,OAAwB;CACpD,OAAO,YAAY,KAAK,CAAC,CAAC,SAAS;AACrC;;;;AAKA,SAAgB,uBAAuB,SAA0B;CAC/D,OAAO,YAAY,MAAM,SAAS,KAAK,QAAQ,YAAY,OAAO;AACpE;;;;AAKA,SAAgB,iBAAyB;CACvC,OAAO,YAAY;AACrB;;;;AAKA,SAAgB,mBAAyB;CACvC,cAAc,CAAC;AACjB;;;;AAKA,SAAgB,eAAe,WAA0D;CACvF,MAAM,OAAO,YAAY,KAAK,SAAS;CAEvC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,8DAA8D;CAGhF,OAAO;AACT;;;;AAKA,SAAgB,gBAAgB,OAAqB;CACnD,IAAI,YAAY,WAAW,OACzB,MAAM,IAAI,MAAM,YAAY,MAAM,+BAA+B,YAAY,QAAQ;AAEzF"}
+{"version":3,"file":"test-mailbox.mjs","names":[],"sources":["../../../../../../../../packages/core/src/mail/test-mailbox.ts"],"sourcesContent":["/**\n * Test Mailbox for Mail v2\n *\n * Provides utilities for capturing and asserting sent emails in test mode.\n *\n * ## Setup\n *\n * ```typescript\n * import { setMailMode, clearTestMailbox } from \"@warlock.js/core/mail/v2\";\n *\n * beforeEach(() => {\n *   setMailMode(\"test\");\n *   clearTestMailbox();\n * });\n * ```\n *\n * ## Usage\n *\n * ```typescript\n * import { sendMail, getTestMailbox, findMailsTo } from \"@warlock.js/core/mail/v2\";\n *\n * // Send email in test mode\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Welcome!\",\n *   html: \"<p>Hello</p>\",\n * });\n *\n * // Get all captured mails\n * const mails = getTestMailbox();\n * expect(mails).toHaveLength(1);\n * expect(mails[0].options.subject).toBe(\"Welcome!\");\n *\n * // Find specific mails\n * const userMails = findMailsTo(\"user@example.com\");\n * expect(userMails).toHaveLength(1);\n *\n * // Check if mail was sent\n * expect(wasMailSentTo(\"user@example.com\")).toBe(true);\n * expect(wasMailSentWithSubject(\"Welcome!\")).toBe(true);\n * ```\n *\n * ## Assertion Helpers\n *\n * ```typescript\n * // Assert a mail matching a predicate was sent\n * const mail = assertMailSent(m => m.options.to === \"user@example.com\");\n * expect(mail.options.subject).toBe(\"Welcome!\");\n *\n * // Assert exact count\n * assertMailCount(2); // throws if count doesn't match\n * ```\n *\n * ## Captured Mail Structure\n *\n * Each captured mail contains:\n * - `options` - Original MailOptions passed to sendMail\n * - `normalized` - Normalized mail data (arrays, addresses resolved)\n * - `timestamp` - When the mail was captured\n * - `result` - MailResult (in test mode, always success)\n * - `error` - MailError if sending failed (null in test mode)\n *\n * @module test-mailbox\n */\n\nimport type { CapturedMail } from \"./types\";\n\n/**\n * Test mailbox for capturing sent emails in test mode\n */\nlet testMailbox: CapturedMail[] = [];\n\n/**\n * Add a mail to the test mailbox\n */\nexport function captureMail(mail: CapturedMail): void {\n  testMailbox.push(mail);\n}\n\n/**\n * Get all captured mails\n */\nexport function getTestMailbox(): CapturedMail[] {\n  return [...testMailbox];\n}\n\n/**\n * Get the last captured mail\n */\nexport function getLastMail(): CapturedMail | undefined {\n  return testMailbox[testMailbox.length - 1];\n}\n\n/**\n * Find mails by recipient\n */\nexport function findMailsTo(email: string): CapturedMail[] {\n  return testMailbox.filter((mail) => {\n    const to = Array.isArray(mail.options.to) ? mail.options.to : [mail.options.to];\n    return to.includes(email);\n  });\n}\n\n/**\n * Find mails by subject (partial match)\n */\nexport function findMailsBySubject(subject: string): CapturedMail[] {\n  return testMailbox.filter((mail) => mail.options.subject.includes(subject));\n}\n\n/**\n * Check if a mail was sent to a specific recipient\n */\nexport function wasMailSentTo(email: string): boolean {\n  return findMailsTo(email).length > 0;\n}\n\n/**\n * Check if a mail with specific subject was sent\n */\nexport function wasMailSentWithSubject(subject: string): boolean {\n  return testMailbox.some((mail) => mail.options.subject === subject);\n}\n\n/**\n * Get mailbox size\n */\nexport function getMailboxSize(): number {\n  return testMailbox.length;\n}\n\n/**\n * Clear the test mailbox\n */\nexport function clearTestMailbox(): void {\n  testMailbox = [];\n}\n\n/**\n * Assert helper for testing\n */\nexport function assertMailSent(predicate: (mail: CapturedMail) => boolean): CapturedMail {\n  const mail = testMailbox.find(predicate);\n\n  if (!mail) {\n    throw new Error(\"No mail matching the predicate was found in the test mailbox\");\n  }\n\n  return mail;\n}\n\n/**\n * Assert that a specific number of mails were sent\n */\nexport function assertMailCount(count: number): void {\n  if (testMailbox.length !== count) {\n    throw new Error(`Expected ${count} mails to be sent, but found ${testMailbox.length}`);\n  }\n}\n"],"mappings":";;;;AAsEA,IAAI,cAA8B,CAAC;;;;AAKnC,SAAgB,YAAY,MAA0B;CACpD,YAAY,KAAK,IAAI;AACvB;;;;AAKA,SAAgB,iBAAiC;CAC/C,OAAO,CAAC,GAAG,WAAW;AACxB;;;;AAKA,SAAgB,cAAwC;CACtD,OAAO,YAAY,YAAY,SAAS;AAC1C;;;;AAKA,SAAgB,YAAY,OAA+B;CACzD,OAAO,YAAY,QAAQ,SAAS;EAElC,QADW,MAAM,QAAQ,KAAK,QAAQ,EAAE,IAAI,KAAK,QAAQ,KAAK,CAAC,KAAK,QAAQ,EAAE,EACrE,CAAC,SAAS,KAAK;CAC1B,CAAC;AACH;;;;AAKA,SAAgB,mBAAmB,SAAiC;CAClE,OAAO,YAAY,QAAQ,SAAS,KAAK,QAAQ,QAAQ,SAAS,OAAO,CAAC;AAC5E;;;;AAKA,SAAgB,cAAc,OAAwB;CACpD,OAAO,YAAY,KAAK,CAAC,CAAC,SAAS;AACrC;;;;AAKA,SAAgB,uBAAuB,SAA0B;CAC/D,OAAO,YAAY,MAAM,SAAS,KAAK,QAAQ,YAAY,OAAO;AACpE;;;;AAKA,SAAgB,iBAAyB;CACvC,OAAO,YAAY;AACrB;;;;AAKA,SAAgB,mBAAyB;CACvC,cAAc,CAAC;AACjB;;;;AAKA,SAAgB,eAAe,WAA0D;CACvF,MAAM,OAAO,YAAY,KAAK,SAAS;CAEvC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,8DAA8D;CAGhF,OAAO;AACT;;;;AAKA,SAAgB,gBAAgB,OAAqB;CACnD,IAAI,YAAY,WAAW,OACzB,MAAM,IAAI,MAAM,YAAY,MAAM,+BAA+B,YAAY,QAAQ;AAEzF"}

package/esm/mail/types.d.mts

@@ -1,7 +1,7 @@
 import React from "react";
 import SMTPTransport from "nodemailer/lib/smtp-transport";
 
-//#region ../core/src/mail/types.d.ts
+//#region ../../packages/core/src/mail/types.d.ts
 /**
  * AWS SES mail configuration
  */

package/esm/mail/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/mail/types.ts"],"mappings":";;;;;;AAMA;KAAY,iBAAA;EACV,MAAA;EACA,WAAA;EACA,eAAA;EACA,MAAA;EACA,IAAA,GAAO,WAAW;AAAA;;;;KAMR,kBAAA,GAAqB,kBAAA,GAAqB,iBAAiB;AAAvE;;;AAAA,KAKY,QAAA;AAL2D;AAKvE;;AALuE,KAU3D,YAAA;;AALQ;AAKpB;KAKY,WAAA;EAGN,IAAA;EACA,OAAO;AAAA;AAJb;;;;AAAA,KAWY,cAAA;EACV,QAAA;EACA,WAAA;EACA,QAAA;EACA,GAAA;AAAA;EAGI,OAAA,EAAS,MAAM;EACf,IAAA;AAAA;EAGA,OAAA;EACA,IAAA;AAAA;;;;AAAI;AAqEV;;;;;;;;;;;;;AAwBoB;AAMpB;;;;;;;;;;;;;;AAQ6C;AAM7C;;;;;;;;;;;;;AAQM;AAON;;;;AAAyB;AAezB;;;;;;;;;;;;;KA1EY,kBAAA,GAAqB,aAAA,CAAc,OAAA;EA+FR;;;EA3FrC,MAAA;EA2EA;;;;EAtEA,GAAA;EA0EA;;;;EArEA,QAAA;EAwES;;;;EAnET,QAAA;EAwEa;;;;EAnEb,IAAA,GAAO,WAAW;AAAA;;;;KAMR,aAAA;EAiEuD;AAAA;AAMnE;EAnEE,OAAA,GAAU,kBAAA;;;;EAIV,OAAA,GAAU,MAAA,SAAe,kBAAA;AAAA;;;;KAMf,UAAA;EACV,OAAA;EACA,SAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;IACE,IAAA;IACA,EAAA;EAAA;AAAA;;;;KAOQ,aAAA;;;;;KAeA,UAAA;EA8DV;;;;EAzDA,aAAA,IAAiB,IAAA,EAAM,WAAA,YAAuB,OAAA,iBAAwB,OAAA;EA8DtE;;;EA1DA,MAAA,IACE,IAAA,EAAM,WAAA,EACN,MAAA,EAAQ,UAAA,SACR,KAAA,EAAO,SAAA,mBACG,OAAA;EA4DF;;;EAxDV,SAAA,IAAa,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,UAAA,YAAsB,OAAA;EAiEjD;;;EA7Db,OAAA,IAAW,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,SAAA,YAAqB,OAAA;AAAA;;;;KAMhD,WAAA;EAkDV;;;;;;;;;;;EAtCA,EAAA;EAGA,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EAGA,OAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA,GAAY,KAAA,CAAM,YAAA;EAGlB,MAAA,GAAS,kBAAA;EACT,MAAA;EACA,IAAA,GAAO,WAAA;EAGP,WAAA,GAAc,cAAA;EAGd,QAAA,GAAW,YAAA;EACX,OAAA,GAAU,MAAA;EACV,IAAA;EAGA,aAAA;AAAA,IACE,UAAA;;;;KAKQ,cAAA;EACV,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EACA,IAAA,EAAM,WAAA;EACN,OAAA;EACA,IAAA;EACA,IAAA;EACA,WAAA,EAAa,cAAA;EACb,QAAA,EAAU,YAAA;EACV,OAAA,EAAS,MAAA;EACT,IAAA;EACA,aAAA;EACA,MAAA,EAAQ,kBAAA;AAAA;;;;;;;KASE,YAAA;EAesB,qEAbhC,EAAA;EACA,OAAA,EAAS,WAAA;EACT,UAAA,EAAY,cAAA;EACZ,SAAA,EAAW,IAAA;EACX,MAAA,GAAS,UAAA;EACT,KAAA,GAAQ,SAAA;AAAA;AAUsE;;;AAAA,cAJnE,SAAA,SAAkB,KAAA;EAAA,SACb,IAAA,EAAM,aAAA;EAAA,SACN,aAAA,GAAgB,KAAA;cAEb,OAAA,UAAiB,IAAA,EAAM,aAAA,EAAe,aAAA,GAAgB,KAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/mail/types.ts"],"mappings":";;;;;;AAMA;KAAY,iBAAA;EACV,MAAA;EACA,WAAA;EACA,eAAA;EACA,MAAA;EACA,IAAA,GAAO,WAAW;AAAA;;;;KAMR,kBAAA,GAAqB,kBAAA,GAAqB,iBAAiB;AAAvE;;;AAAA,KAKY,QAAA;AAL2D;AAKvE;;AALuE,KAU3D,YAAA;;AALQ;AAKpB;KAKY,WAAA;EAGN,IAAA;EACA,OAAO;AAAA;AAJb;;;;AAAA,KAWY,cAAA;EACV,QAAA;EACA,WAAA;EACA,QAAA;EACA,GAAA;AAAA;EAGI,OAAA,EAAS,MAAM;EACf,IAAA;AAAA;EAGA,OAAA;EACA,IAAA;AAAA;;;;AAAI;AAqEV;;;;;;;;;;;;;AAwBoB;AAMpB;;;;;;;;;;;;;;AAQ6C;AAM7C;;;;;;;;;;;;;AAQM;AAON;;;;AAAyB;AAezB;;;;;;;;;;;;;KA1EY,kBAAA,GAAqB,aAAA,CAAc,OAAA;EA+FR;;;EA3FrC,MAAA;EA2EA;;;;EAtEA,GAAA;EA0EA;;;;EArEA,QAAA;EAwES;;;;EAnET,QAAA;EAwEa;;;;EAnEb,IAAA,GAAO,WAAW;AAAA;;;;KAMR,aAAA;EAiEuD;AAAA;AAMnE;EAnEE,OAAA,GAAU,kBAAA;;;;EAIV,OAAA,GAAU,MAAA,SAAe,kBAAA;AAAA;;;;KAMf,UAAA;EACV,OAAA;EACA,SAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;IACE,IAAA;IACA,EAAA;EAAA;AAAA;;;;KAOQ,aAAA;;;;;KAeA,UAAA;EA8DV;;;;EAzDA,aAAA,IAAiB,IAAA,EAAM,WAAA,YAAuB,OAAA,iBAAwB,OAAA;EA8DtE;;;EA1DA,MAAA,IACE,IAAA,EAAM,WAAA,EACN,MAAA,EAAQ,UAAA,SACR,KAAA,EAAO,SAAA,mBACG,OAAA;EA4DF;;;EAxDV,SAAA,IAAa,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,UAAA,YAAsB,OAAA;EAiEjD;;;EA7Db,OAAA,IAAW,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,SAAA,YAAqB,OAAA;AAAA;;;;KAMhD,WAAA;EAkDV;;;;;;;;;;;EAtCA,EAAA;EAGA,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EAGA,OAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA,GAAY,KAAA,CAAM,YAAA;EAGlB,MAAA,GAAS,kBAAA;EACT,MAAA;EACA,IAAA,GAAO,WAAA;EAGP,WAAA,GAAc,cAAA;EAGd,QAAA,GAAW,YAAA;EACX,OAAA,GAAU,MAAA;EACV,IAAA;EAGA,aAAA;AAAA,IACE,UAAA;;;;KAKQ,cAAA;EACV,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EACA,IAAA,EAAM,WAAA;EACN,OAAA;EACA,IAAA;EACA,IAAA;EACA,WAAA,EAAa,cAAA;EACb,QAAA,EAAU,YAAA;EACV,OAAA,EAAS,MAAA;EACT,IAAA;EACA,aAAA;EACA,MAAA,EAAQ,kBAAA;AAAA;;;;;;;KASE,YAAA;EAesB,qEAbhC,EAAA;EACA,OAAA,EAAS,WAAA;EACT,UAAA,EAAY,cAAA;EACZ,SAAA,EAAW,IAAA;EACX,MAAA,GAAS,UAAA;EACT,KAAA,GAAQ,SAAA;AAAA;AAUsE;;;AAAA,cAJnE,SAAA,SAAkB,KAAA;EAAA,SACb,IAAA,EAAM,aAAA;EAAA,SACN,aAAA,GAAgB,KAAA;cAEb,OAAA,UAAiB,IAAA,EAAM,aAAA,EAAe,aAAA,GAAgB,KAAA;AAAA"}

package/esm/mail/types.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/mail/types.ts
+//#region ../../packages/core/src/mail/types.ts
 /**
 * Mail error class
 */

package/esm/mail/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../core/src/mail/types.ts"],"sourcesContent":["import type SMTPTransport from \"nodemailer/lib/smtp-transport\";\nimport type React from \"react\";\n\n/**\n * AWS SES mail configuration\n */\nexport type SESConfigurations = {\n  driver: \"ses\";\n  accessKeyId: string;\n  secretAccessKey: string;\n  region: string;\n  from?: MailAddress;\n};\n\n/**\n * Any mail configuration (SMTP or SES)\n */\nexport type MailConfigurations = SMTPConfigurations | SESConfigurations;\n\n/**\n * Mail mode determines how emails are handled\n */\nexport type MailMode = \"production\" | \"development\" | \"test\";\n\n/**\n * Mail priority levels\n */\nexport type MailPriority = \"high\" | \"normal\" | \"low\";\n\n/**\n * Email address with optional name\n */\nexport type MailAddress =\n  | string\n  | {\n      name: string;\n      address: string;\n    };\n\n/**\n * Mail attachment\n * Supports both buffer/string content and file paths\n */\nexport type MailAttachment = {\n  filename: string;\n  contentType?: string;\n  encoding?: \"base64\" | \"binary\" | \"hex\";\n  cid?: string; // Content-ID for inline attachments\n} & (\n  | {\n      content: Buffer | string;\n      path?: never;\n    }\n  | {\n      content?: never;\n      path: string; // File path - will be read automatically\n    }\n);\n\n/**\n * Mail configuration for SMTP transport\n *\n * ## Basic Configuration\n *\n * ```typescript\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   secure: false,           // true for 465, false for other ports\n *   tls: true,               // Use STARTTLS\n *   username: \"user@gmail.com\",\n *   password: \"app-password\",\n *   from: { name: \"My App\", address: \"noreply@myapp.com\" },\n * });\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `host` | `string` | - | SMTP server hostname (e.g., \"smtp.gmail.com\") |\n * | `port` | `number` | 587 | SMTP port. Common: 25, 465 (SSL), 587 (TLS) |\n * | `secure` | `boolean` | false | Use SSL/TLS. Set `true` for port 465 |\n * | `tls` | `boolean` | true | Enable STARTTLS upgrade. For port 587 |\n * | `requireTLS` | `boolean` | - | Fail if STARTTLS upgrade fails |\n * | `username` | `string` | - | SMTP auth username (convenience alias) |\n * | `password` | `string` | - | SMTP auth password (convenience alias) |\n * | `auth` | `object` | - | Full auth object: `{ user, pass, type }` |\n * | `from` | `MailAddress` | - | Default sender for all emails |\n *\n * ## Provider Examples\n *\n * ### Gmail\n * ```typescript\n * { host: \"smtp.gmail.com\", port: 587, tls: true, username: \"...\", password: \"...\" }\n * ```\n *\n * ### SendGrid\n * ```typescript\n * { host: \"smtp.sendgrid.net\", port: 587, username: \"apikey\", password: \"SG.xxx\" }\n * ```\n *\n * ### AWS SES\n * ```typescript\n * { host: \"email-smtp.us-east-1.amazonaws.com\", port: 587, username: \"...\", password: \"...\" }\n * ```\n *\n * ### Mailgun\n * ```typescript\n * { host: \"smtp.mailgun.org\", port: 587, username: \"postmaster@...\", password: \"...\" }\n * ```\n *\n * ## Multi-tenant Usage\n *\n * For multi-tenant apps, pass config per-mail instead of globally:\n * ```typescript\n * await sendMail({\n *   config: tenant.mailSettings,  // Tenant-specific config\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n * ```\n */\nexport type SMTPConfigurations = SMTPTransport.Options & {\n  /**\n   * Transport driver type\n   */\n  driver?: \"smtp\";\n  /**\n   * Enable STARTTLS upgrade (alias for requireTLS)\n   * Set to `true` for port 587\n   */\n  tls?: boolean;\n  /**\n   * SMTP authentication username\n   * Convenience alias - can also use `auth.user`\n   */\n  username?: string;\n  /**\n   * SMTP authentication password\n   * Convenience alias - can also use `auth.pass`\n   */\n  password?: string;\n  /**\n   * Default sender for all emails\n   * Can be string (\"noreply@app.com\") or object ({ name, address })\n   */\n  from?: MailAddress;\n};\n\n/**\n * Named mailers configuration\n */\nexport type MailersConfig = {\n  /**\n   * Default mailer configuration\n   */\n  default?: MailConfigurations;\n  /**\n   * Named mailer configurations\n   */\n  mailers?: Record<string, MailConfigurations>;\n};\n\n/**\n * Mail result after sending\n */\nexport type MailResult = {\n  success: boolean;\n  messageId?: string;\n  accepted: string[];\n  rejected: string[];\n  response?: string;\n  envelope?: {\n    from: string;\n    to: string[];\n  };\n};\n\n/**\n * Error codes for mail operations\n */\nexport type MailErrorCode =\n  | \"CONNECTION_ERROR\"\n  | \"AUTH_ERROR\"\n  | \"RATE_LIMIT\"\n  | \"INVALID_ADDRESS\"\n  | \"REJECTED\"\n  | \"TIMEOUT\"\n  | \"RENDER_ERROR\"\n  | \"CONFIG_ERROR\"\n  | \"UNKNOWN\";\n\n/**\n * Mail event callbacks (per-mail)\n * For global events, use mailEvents.on() from events.ts\n */\nexport type MailEvents = {\n  /**\n   * Called before sending the email\n   * Can be used to modify the mail or cancel sending\n   */\n  beforeSending?: (mail: MailOptions) => void | Promise<void> | false | Promise<false>;\n  /**\n   * Called after send attempt (success or failure)\n   */\n  onSent?: (\n    mail: MailOptions,\n    result: MailResult | null,\n    error: MailError | null,\n  ) => void | Promise<void>;\n  /**\n   * Called only on successful send\n   */\n  onSuccess?: (mail: MailOptions, result: MailResult) => void | Promise<void>;\n  /**\n   * Called only on error\n   */\n  onError?: (mail: MailOptions, error: MailError) => void | Promise<void>;\n};\n\n/**\n * Mail options for sending\n */\nexport type MailOptions = {\n  /**\n   * Unique mail ID for event namespacing\n   * If not provided, one will be auto-generated\n   *\n   * Use this to subscribe to events for a specific mail:\n   * ```typescript\n   * const mailId = generateMailId();\n   * mailEvents.onMailSuccess(mailId, (mail, result) => { ... });\n   * await sendMail({ id: mailId, to: \"...\", subject: \"...\", html: \"...\" });\n   * ```\n   */\n  id?: string;\n\n  // Recipients\n  to: string | string[];\n  cc?: string | string[];\n  bcc?: string | string[];\n  replyTo?: string;\n\n  // Content\n  subject: string;\n  html?: string;\n  text?: string;\n  component?: React.ReactElement;\n\n  // Configuration\n  config?: MailConfigurations;\n  mailer?: string;\n  from?: MailAddress;\n\n  // Attachments\n  attachments?: MailAttachment[];\n\n  // Options\n  priority?: MailPriority;\n  headers?: Record<string, string>;\n  tags?: string[];\n\n  // Meta\n  correlationId?: string;\n} & MailEvents;\n\n/**\n * Internal normalized mail data\n */\nexport type NormalizedMail = {\n  to: string[];\n  cc: string[];\n  bcc: string[];\n  replyTo?: string;\n  from: MailAddress;\n  subject: string;\n  html?: string;\n  text?: string;\n  attachments: MailAttachment[];\n  priority: MailPriority;\n  headers: Record<string, string>;\n  tags: string[];\n  correlationId?: string;\n  config: MailConfigurations;\n};\n\n/**\n * Captured mail for development and test modes.\n *\n * Attachments retain their normalized contents so test assertions can inspect\n * the exact mail that would be sent.\n */\nexport type CapturedMail = {\n  /** The mail ID used for event namespacing and result correlation. */\n  id: string;\n  options: MailOptions;\n  normalized: NormalizedMail;\n  timestamp: Date;\n  result?: MailResult;\n  error?: MailError;\n};\n\n/**\n * Mail error class\n */\nexport class MailError extends Error {\n  public readonly code: MailErrorCode;\n  public readonly originalError?: Error;\n\n  public constructor(message: string, code: MailErrorCode, originalError?: Error) {\n    super(message);\n    this.name = \"MailError\";\n    this.code = code;\n    this.originalError = originalError;\n  }\n}\n"],"mappings":";;;;AAmTA,IAAa,YAAb,cAA+B,MAAM;CAInC,AAAO,YAAY,SAAiB,MAAqB,eAAuB;EAC9E,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,gBAAgB;CACvB;AACF"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../../packages/core/src/mail/types.ts"],"sourcesContent":["import type SMTPTransport from \"nodemailer/lib/smtp-transport\";\nimport type React from \"react\";\n\n/**\n * AWS SES mail configuration\n */\nexport type SESConfigurations = {\n  driver: \"ses\";\n  accessKeyId: string;\n  secretAccessKey: string;\n  region: string;\n  from?: MailAddress;\n};\n\n/**\n * Any mail configuration (SMTP or SES)\n */\nexport type MailConfigurations = SMTPConfigurations | SESConfigurations;\n\n/**\n * Mail mode determines how emails are handled\n */\nexport type MailMode = \"production\" | \"development\" | \"test\";\n\n/**\n * Mail priority levels\n */\nexport type MailPriority = \"high\" | \"normal\" | \"low\";\n\n/**\n * Email address with optional name\n */\nexport type MailAddress =\n  | string\n  | {\n      name: string;\n      address: string;\n    };\n\n/**\n * Mail attachment\n * Supports both buffer/string content and file paths\n */\nexport type MailAttachment = {\n  filename: string;\n  contentType?: string;\n  encoding?: \"base64\" | \"binary\" | \"hex\";\n  cid?: string; // Content-ID for inline attachments\n} & (\n  | {\n      content: Buffer | string;\n      path?: never;\n    }\n  | {\n      content?: never;\n      path: string; // File path - will be read automatically\n    }\n);\n\n/**\n * Mail configuration for SMTP transport\n *\n * ## Basic Configuration\n *\n * ```typescript\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   secure: false,           // true for 465, false for other ports\n *   tls: true,               // Use STARTTLS\n *   username: \"user@gmail.com\",\n *   password: \"app-password\",\n *   from: { name: \"My App\", address: \"noreply@myapp.com\" },\n * });\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `host` | `string` | - | SMTP server hostname (e.g., \"smtp.gmail.com\") |\n * | `port` | `number` | 587 | SMTP port. Common: 25, 465 (SSL), 587 (TLS) |\n * | `secure` | `boolean` | false | Use SSL/TLS. Set `true` for port 465 |\n * | `tls` | `boolean` | true | Enable STARTTLS upgrade. For port 587 |\n * | `requireTLS` | `boolean` | - | Fail if STARTTLS upgrade fails |\n * | `username` | `string` | - | SMTP auth username (convenience alias) |\n * | `password` | `string` | - | SMTP auth password (convenience alias) |\n * | `auth` | `object` | - | Full auth object: `{ user, pass, type }` |\n * | `from` | `MailAddress` | - | Default sender for all emails |\n *\n * ## Provider Examples\n *\n * ### Gmail\n * ```typescript\n * { host: \"smtp.gmail.com\", port: 587, tls: true, username: \"...\", password: \"...\" }\n * ```\n *\n * ### SendGrid\n * ```typescript\n * { host: \"smtp.sendgrid.net\", port: 587, username: \"apikey\", password: \"SG.xxx\" }\n * ```\n *\n * ### AWS SES\n * ```typescript\n * { host: \"email-smtp.us-east-1.amazonaws.com\", port: 587, username: \"...\", password: \"...\" }\n * ```\n *\n * ### Mailgun\n * ```typescript\n * { host: \"smtp.mailgun.org\", port: 587, username: \"postmaster@...\", password: \"...\" }\n * ```\n *\n * ## Multi-tenant Usage\n *\n * For multi-tenant apps, pass config per-mail instead of globally:\n * ```typescript\n * await sendMail({\n *   config: tenant.mailSettings,  // Tenant-specific config\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n * ```\n */\nexport type SMTPConfigurations = SMTPTransport.Options & {\n  /**\n   * Transport driver type\n   */\n  driver?: \"smtp\";\n  /**\n   * Enable STARTTLS upgrade (alias for requireTLS)\n   * Set to `true` for port 587\n   */\n  tls?: boolean;\n  /**\n   * SMTP authentication username\n   * Convenience alias - can also use `auth.user`\n   */\n  username?: string;\n  /**\n   * SMTP authentication password\n   * Convenience alias - can also use `auth.pass`\n   */\n  password?: string;\n  /**\n   * Default sender for all emails\n   * Can be string (\"noreply@app.com\") or object ({ name, address })\n   */\n  from?: MailAddress;\n};\n\n/**\n * Named mailers configuration\n */\nexport type MailersConfig = {\n  /**\n   * Default mailer configuration\n   */\n  default?: MailConfigurations;\n  /**\n   * Named mailer configurations\n   */\n  mailers?: Record<string, MailConfigurations>;\n};\n\n/**\n * Mail result after sending\n */\nexport type MailResult = {\n  success: boolean;\n  messageId?: string;\n  accepted: string[];\n  rejected: string[];\n  response?: string;\n  envelope?: {\n    from: string;\n    to: string[];\n  };\n};\n\n/**\n * Error codes for mail operations\n */\nexport type MailErrorCode =\n  | \"CONNECTION_ERROR\"\n  | \"AUTH_ERROR\"\n  | \"RATE_LIMIT\"\n  | \"INVALID_ADDRESS\"\n  | \"REJECTED\"\n  | \"TIMEOUT\"\n  | \"RENDER_ERROR\"\n  | \"CONFIG_ERROR\"\n  | \"UNKNOWN\";\n\n/**\n * Mail event callbacks (per-mail)\n * For global events, use mailEvents.on() from events.ts\n */\nexport type MailEvents = {\n  /**\n   * Called before sending the email\n   * Can be used to modify the mail or cancel sending\n   */\n  beforeSending?: (mail: MailOptions) => void | Promise<void> | false | Promise<false>;\n  /**\n   * Called after send attempt (success or failure)\n   */\n  onSent?: (\n    mail: MailOptions,\n    result: MailResult | null,\n    error: MailError | null,\n  ) => void | Promise<void>;\n  /**\n   * Called only on successful send\n   */\n  onSuccess?: (mail: MailOptions, result: MailResult) => void | Promise<void>;\n  /**\n   * Called only on error\n   */\n  onError?: (mail: MailOptions, error: MailError) => void | Promise<void>;\n};\n\n/**\n * Mail options for sending\n */\nexport type MailOptions = {\n  /**\n   * Unique mail ID for event namespacing\n   * If not provided, one will be auto-generated\n   *\n   * Use this to subscribe to events for a specific mail:\n   * ```typescript\n   * const mailId = generateMailId();\n   * mailEvents.onMailSuccess(mailId, (mail, result) => { ... });\n   * await sendMail({ id: mailId, to: \"...\", subject: \"...\", html: \"...\" });\n   * ```\n   */\n  id?: string;\n\n  // Recipients\n  to: string | string[];\n  cc?: string | string[];\n  bcc?: string | string[];\n  replyTo?: string;\n\n  // Content\n  subject: string;\n  html?: string;\n  text?: string;\n  component?: React.ReactElement;\n\n  // Configuration\n  config?: MailConfigurations;\n  mailer?: string;\n  from?: MailAddress;\n\n  // Attachments\n  attachments?: MailAttachment[];\n\n  // Options\n  priority?: MailPriority;\n  headers?: Record<string, string>;\n  tags?: string[];\n\n  // Meta\n  correlationId?: string;\n} & MailEvents;\n\n/**\n * Internal normalized mail data\n */\nexport type NormalizedMail = {\n  to: string[];\n  cc: string[];\n  bcc: string[];\n  replyTo?: string;\n  from: MailAddress;\n  subject: string;\n  html?: string;\n  text?: string;\n  attachments: MailAttachment[];\n  priority: MailPriority;\n  headers: Record<string, string>;\n  tags: string[];\n  correlationId?: string;\n  config: MailConfigurations;\n};\n\n/**\n * Captured mail for development and test modes.\n *\n * Attachments retain their normalized contents so test assertions can inspect\n * the exact mail that would be sent.\n */\nexport type CapturedMail = {\n  /** The mail ID used for event namespacing and result correlation. */\n  id: string;\n  options: MailOptions;\n  normalized: NormalizedMail;\n  timestamp: Date;\n  result?: MailResult;\n  error?: MailError;\n};\n\n/**\n * Mail error class\n */\nexport class MailError extends Error {\n  public readonly code: MailErrorCode;\n  public readonly originalError?: Error;\n\n  public constructor(message: string, code: MailErrorCode, originalError?: Error) {\n    super(message);\n    this.name = \"MailError\";\n    this.code = code;\n    this.originalError = originalError;\n  }\n}\n"],"mappings":";;;;AAmTA,IAAa,YAAb,cAA+B,MAAM;CAInC,AAAO,YAAY,SAAiB,MAAqB,eAAuB;EAC9E,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,gBAAgB;CACvB;AACF"}

package/esm/manifest/manifest-manager.mjs

@@ -2,7 +2,7 @@ import { warlockPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
 import { getJsonFileAsync, putJsonFileAsync, unlinkAsync } from "@warlock.js/fs";
 
-//#region ../core/src/manifest/manifest-manager.ts
+//#region ../../packages/core/src/manifest/manifest-manager.ts
 var ManifestManager = class {
 	constructor() {
 		this._hasChanges = false;

package/esm/manifest/manifest-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-manager.mjs","names":[],"sources":["../../../../../../../core/src/manifest/manifest-manager.ts"],"sourcesContent":["import { getJsonFileAsync, putJsonFileAsync, unlinkAsync } from \"@warlock.js/fs\";\nimport { warlockPath } from \"../utils\";\n\n/**\n * Stored option metadata in manifest\n */\nexport type ManifestCommandOption = {\n  name: string;\n  text: string;\n  alias?: string;\n  description?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n  required?: boolean;\n  defaultValue?: string | boolean | number;\n};\n\n/**\n * Command metadata stored in commands.json\n */\nexport type ManifestCommandData = {\n  relativePath?: string;\n  source: \"framework\" | \"plugin\" | \"project\";\n  description?: string;\n  alias?: string;\n  options?: ManifestCommandOption[];\n};\n\ntype ManifestCommandsJson = {\n  commands: Record<string, ManifestCommandData>;\n};\n\nexport class ManifestManager {\n  /**\n   * commands json\n   */\n  protected _commandsJson?: ManifestCommandsJson;\n\n  /**\n   * Check if commands json is changed\n   */\n  protected _hasChanges = false;\n\n  /**\n   * Whether commands json is loaded\n   */\n  protected _isLoaded = false;\n\n  /**\n   * Get if commands json has changes\n   */\n  public get hasChanges() {\n    return this._hasChanges;\n  }\n\n  /**\n   * Check if commands json is loaded\n   */\n  public get isCommandLoaded() {\n    return this._isLoaded;\n  }\n\n  /**\n   * Load commands.json file\n   */\n  public async loadCommands(): Promise<ManifestCommandsJson | undefined> {\n    // now try to locate it in .warlock folder\n    if (this._isLoaded) return this._commandsJson;\n\n    try {\n      this._commandsJson = await getJsonFileAsync(warlockPath(\"commands.json\"));\n\n      this._isLoaded = true;\n\n      return this._commandsJson;\n    } catch {\n      return;\n    }\n  }\n\n  /**\n   * Get commands json content\n   */\n  public get commandsJson() {\n    return this._commandsJson;\n  }\n\n  /**\n   * Save commands in commands.json file\n   */\n  public async saveCommands() {\n    await putJsonFileAsync(warlockPath(\"commands.json\"), this._commandsJson);\n\n    this._isLoaded = true;\n    this._hasChanges = false;\n  }\n\n  /**\n   * Add command info to commands list (But do not save commands)\n   */\n  public addCommandToList(name: string, command: ManifestCommandsJson[\"commands\"][string]) {\n    if (!this._commandsJson) {\n      this._commandsJson = {\n        commands: {},\n      };\n    }\n\n    this._commandsJson.commands[name] = command;\n\n    this._hasChanges = true;\n  }\n\n  /**\n   * Clear commands cache\n   */\n  public clearCommandsCache() {\n    this._commandsJson = undefined;\n    this._hasChanges = false;\n    this._isLoaded = false;\n  }\n\n  /**\n   * Remove commands.json file\n   */\n  public async removeCommandsFile() {\n    try {\n      await unlinkAsync(warlockPath(\"commands.json\"));\n    } catch {\n      // do nothing\n    }\n  }\n}\n\nexport const manifestManager = new ManifestManager();\n"],"mappings":";;;;;AA+BA,IAAa,kBAAb,MAA6B;;qBASH;mBAKF;;;;;CAKtB,IAAW,aAAa;EACtB,OAAO,KAAK;CACd;;;;CAKA,IAAW,kBAAkB;EAC3B,OAAO,KAAK;CACd;;;;CAKA,MAAa,eAA0D;EAErE,IAAI,KAAK,WAAW,OAAO,KAAK;EAEhC,IAAI;GACF,KAAK,gBAAgB,MAAM,iBAAiB,YAAY,eAAe,CAAC;GAExE,KAAK,YAAY;GAEjB,OAAO,KAAK;EACd,QAAQ;GACN;EACF;CACF;;;;CAKA,IAAW,eAAe;EACxB,OAAO,KAAK;CACd;;;;CAKA,MAAa,eAAe;EAC1B,MAAM,iBAAiB,YAAY,eAAe,GAAG,KAAK,aAAa;EAEvE,KAAK,YAAY;EACjB,KAAK,cAAc;CACrB;;;;CAKA,AAAO,iBAAiB,MAAc,SAAmD;EACvF,IAAI,CAAC,KAAK,eACR,KAAK,gBAAgB,EACnB,UAAU,CAAC,EACb;EAGF,KAAK,cAAc,SAAS,QAAQ;EAEpC,KAAK,cAAc;CACrB;;;;CAKA,AAAO,qBAAqB;EAC1B,KAAK,gBAAgB;EACrB,KAAK,cAAc;EACnB,KAAK,YAAY;CACnB;;;;CAKA,MAAa,qBAAqB;EAChC,IAAI;GACF,MAAM,YAAY,YAAY,eAAe,CAAC;EAChD,QAAQ,CAER;CACF;AACF;AAEA,MAAa,kBAAkB,IAAI,gBAAgB"}
+{"version":3,"file":"manifest-manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/manifest/manifest-manager.ts"],"sourcesContent":["import { getJsonFileAsync, putJsonFileAsync, unlinkAsync } from \"@warlock.js/fs\";\nimport { warlockPath } from \"../utils\";\n\n/**\n * Stored option metadata in manifest\n */\nexport type ManifestCommandOption = {\n  name: string;\n  text: string;\n  alias?: string;\n  description?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n  required?: boolean;\n  defaultValue?: string | boolean | number;\n};\n\n/**\n * Command metadata stored in commands.json\n */\nexport type ManifestCommandData = {\n  relativePath?: string;\n  source: \"framework\" | \"plugin\" | \"project\";\n  description?: string;\n  alias?: string;\n  options?: ManifestCommandOption[];\n};\n\ntype ManifestCommandsJson = {\n  commands: Record<string, ManifestCommandData>;\n};\n\nexport class ManifestManager {\n  /**\n   * commands json\n   */\n  protected _commandsJson?: ManifestCommandsJson;\n\n  /**\n   * Check if commands json is changed\n   */\n  protected _hasChanges = false;\n\n  /**\n   * Whether commands json is loaded\n   */\n  protected _isLoaded = false;\n\n  /**\n   * Get if commands json has changes\n   */\n  public get hasChanges() {\n    return this._hasChanges;\n  }\n\n  /**\n   * Check if commands json is loaded\n   */\n  public get isCommandLoaded() {\n    return this._isLoaded;\n  }\n\n  /**\n   * Load commands.json file\n   */\n  public async loadCommands(): Promise<ManifestCommandsJson | undefined> {\n    // now try to locate it in .warlock folder\n    if (this._isLoaded) return this._commandsJson;\n\n    try {\n      this._commandsJson = await getJsonFileAsync(warlockPath(\"commands.json\"));\n\n      this._isLoaded = true;\n\n      return this._commandsJson;\n    } catch {\n      return;\n    }\n  }\n\n  /**\n   * Get commands json content\n   */\n  public get commandsJson() {\n    return this._commandsJson;\n  }\n\n  /**\n   * Save commands in commands.json file\n   */\n  public async saveCommands() {\n    await putJsonFileAsync(warlockPath(\"commands.json\"), this._commandsJson);\n\n    this._isLoaded = true;\n    this._hasChanges = false;\n  }\n\n  /**\n   * Add command info to commands list (But do not save commands)\n   */\n  public addCommandToList(name: string, command: ManifestCommandsJson[\"commands\"][string]) {\n    if (!this._commandsJson) {\n      this._commandsJson = {\n        commands: {},\n      };\n    }\n\n    this._commandsJson.commands[name] = command;\n\n    this._hasChanges = true;\n  }\n\n  /**\n   * Clear commands cache\n   */\n  public clearCommandsCache() {\n    this._commandsJson = undefined;\n    this._hasChanges = false;\n    this._isLoaded = false;\n  }\n\n  /**\n   * Remove commands.json file\n   */\n  public async removeCommandsFile() {\n    try {\n      await unlinkAsync(warlockPath(\"commands.json\"));\n    } catch {\n      // do nothing\n    }\n  }\n}\n\nexport const manifestManager = new ManifestManager();\n"],"mappings":";;;;;AA+BA,IAAa,kBAAb,MAA6B;;qBASH;mBAKF;;;;;CAKtB,IAAW,aAAa;EACtB,OAAO,KAAK;CACd;;;;CAKA,IAAW,kBAAkB;EAC3B,OAAO,KAAK;CACd;;;;CAKA,MAAa,eAA0D;EAErE,IAAI,KAAK,WAAW,OAAO,KAAK;EAEhC,IAAI;GACF,KAAK,gBAAgB,MAAM,iBAAiB,YAAY,eAAe,CAAC;GAExE,KAAK,YAAY;GAEjB,OAAO,KAAK;EACd,QAAQ;GACN;EACF;CACF;;;;CAKA,IAAW,eAAe;EACxB,OAAO,KAAK;CACd;;;;CAKA,MAAa,eAAe;EAC1B,MAAM,iBAAiB,YAAY,eAAe,GAAG,KAAK,aAAa;EAEvE,KAAK,YAAY;EACjB,KAAK,cAAc;CACrB;;;;CAKA,AAAO,iBAAiB,MAAc,SAAmD;EACvF,IAAI,CAAC,KAAK,eACR,KAAK,gBAAgB,EACnB,UAAU,CAAC,EACb;EAGF,KAAK,cAAc,SAAS,QAAQ;EAEpC,KAAK,cAAc;CACrB;;;;CAKA,AAAO,qBAAqB;EAC1B,KAAK,gBAAgB;EACrB,KAAK,cAAc;EACnB,KAAK,YAAY;CACnB;;;;CAKA,MAAa,qBAAqB;EAChC,IAAI;GACF,MAAM,YAAY,YAAY,eAAe,CAAC;EAChD,QAAQ,CAER;CACF;AACF;AAEA,MAAa,kBAAkB,IAAI,gBAAgB"}

package/esm/openapi/build-openapi-document.d.mts

@@ -1,6 +1,6 @@
 import { OpenApiBuildResult, OpenApiContext, OpenApiRouteInput } from "./types.mjs";
 
-//#region ../core/src/openapi/build-openapi-document.d.ts
+//#region ../../packages/core/src/openapi/build-openapi-document.d.ts
 /** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */
 declare const OPENAPI_JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
 /**

package/esm/openapi/build-openapi-document.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"build-openapi-document.d.mts","names":[],"sources":["../../../../../../../core/src/openapi/build-openapi-document.ts"],"mappings":";;;;cA2Ba,2BAAA;AAAb;;;;AAAwC;AA8BxC;;;AA9BA,iBA8BgB,oBAAA,CACd,MAAA,WAAiB,iBAAA,IACjB,OAAA,EAAS,cAAA,GACR,kBAAA"}
+{"version":3,"file":"build-openapi-document.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/openapi/build-openapi-document.ts"],"mappings":";;;;cA2Ba,2BAAA;AAAb;;;;AAAwC;AA8BxC;;;AA9BA,iBA8BgB,oBAAA,CACd,MAAA,WAAiB,iBAAA,IACjB,OAAA,EAAS,cAAA,GACR,kBAAA"}

package/esm/openapi/build-openapi-document.mjs

@@ -5,7 +5,7 @@ import { buildRequestParts } from "./request-schemas.mjs";
 import { SchemaRegistry } from "./schema-registry.mjs";
 import { SecuritySchemes, readRouteAuth } from "./security.mjs";
 
-//#region ../core/src/openapi/build-openapi-document.ts
+//#region ../../packages/core/src/openapi/build-openapi-document.ts
 /** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */
 const OPENAPI_JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
 const UNSAFE_METHODS = [

package/esm/openapi/build-openapi-document.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-openapi-document.mjs","names":[],"sources":["../../../../../../../core/src/openapi/build-openapi-document.ts"],"sourcesContent":["import {\n  buildUnauthorizedResponse,\n  buildValidationFailedResponse,\n  resolveValidationResponse,\n} from \"./error-responses\";\nimport {\n  buildOperationId,\n  expandMethods,\n  firstSegmentTag,\n  toOpenApiPath,\n  type OpenApiMethod,\n} from \"./paths\";\nimport { buildRequestParts } from \"./request-schemas\";\nimport { buildDeclaredResponses } from \"./response-schemas\";\nimport { SchemaRegistry } from \"./schema-registry\";\nimport { readRouteAuth, SecuritySchemes } from \"./security\";\nimport type {\n  AuthDescriptor,\n  OpenApiBuildResult,\n  OpenApiContext,\n  OpenApiDocument,\n  OpenApiOperation,\n  OpenApiResponse,\n  OpenApiRouteInput,\n} from \"./types\";\n\n/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */\nexport const OPENAPI_JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\n\nconst UNSAFE_METHODS: readonly OpenApiMethod[] = [\"post\", \"put\", \"patch\", \"delete\"];\n\nfunction describeAuth(auth: AuthDescriptor, method: OpenApiMethod): string[] {\n  const lines: string[] = [];\n\n  if (auth.userTypes.length > 0) {\n    lines.push(`Requires an authenticated user of type: ${auth.userTypes.join(\", \")}.`);\n  }\n\n  const usesCookie = auth.sources.some((source) => typeof source !== \"string\");\n\n  if (usesCookie && UNSAFE_METHODS.includes(method)) {\n    lines.push(\n      \"When authenticating with the cookie, the request must also carry a same-origin Origin or Referer header (CSRF guard).\",\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Build an OpenAPI 3.1 document from registered routes.\n *\n * Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas\n * with `toJsonSchema(\"draft-2020-12\")` and returns plain JSON plus the gaps it found as\n * `warnings`. It never throws for a single route it cannot document; that route is\n * documented as far as possible and a warning explains what was left out.\n */\nexport function buildOpenApiDocument(\n  routes: readonly OpenApiRouteInput[],\n  context: OpenApiContext,\n): OpenApiBuildResult {\n  const warnings: string[] = [];\n  const registry = new SchemaRegistry(context.resolveResourceName, (message) => warnings.push(message));\n  const security = new SecuritySchemes();\n  const validationShape = resolveValidationResponse(context.validationResponse);\n  const paths: OpenApiDocument[\"paths\"] = {};\n  const tags = new Set<string>();\n  const operationIds = new Set<string>();\n\n  for (const route of routes) {\n    if (route.isPage && !context.includePages) {\n      continue;\n    }\n\n    const methods = expandMethods(route.method);\n    const label = `${String(route.method).toUpperCase()} ${route.path}`;\n    const warn = (message: string) => warnings.push(`${label}: ${message}`);\n\n    if (methods.length === 0) {\n      warn(`unsupported method \"${String(route.method)}\", route skipped.`);\n\n      continue;\n    }\n\n    const handler = route.handler as OpenApiRouteInput[\"handler\"] | undefined;\n    const validation = handler?.validation;\n    const auth = readRouteAuth(route.middleware, warn);\n    const tag = firstSegmentTag(route.path);\n    const pathKey = toOpenApiPath(route.path);\n\n    if (validation?.validate) {\n      warn(\"validation.validate is custom middleware and is not documented.\");\n    }\n\n    for (const method of methods) {\n      paths[pathKey] ??= {};\n\n      if (paths[pathKey][method]) {\n        warn(`${method.toUpperCase()} ${pathKey} is already documented by an earlier route; this one is skipped.`);\n\n        continue;\n      }\n\n      let operationId = buildOperationId(route.name, method, route.path, methods.length > 1);\n\n      if (operationIds.has(operationId)) {\n        let suffix = 2;\n\n        while (operationIds.has(`${operationId}_${suffix}`)) {\n          suffix++;\n        }\n\n        warn(`operationId \"${operationId}\" is already used; renamed to \"${operationId}_${suffix}\".`);\n        operationId = `${operationId}_${suffix}`;\n      }\n\n      operationIds.add(operationId);\n\n      const description = [\n        route.description ?? handler?.description,\n        ...(auth ? describeAuth(auth, method) : []),\n      ].filter((line): line is string => typeof line === \"string\" && line.length > 0);\n\n      const request = buildRequestParts({ method, path: route.path, validation, warn });\n\n      const responses: Record<string, OpenApiResponse> = route.isPage\n        ? { \"200\": { description: \"HTML page\", content: { \"text/html\": { schema: { type: \"string\" } } } } }\n        : buildDeclaredResponses(handler?.responseSchema, registry, warn);\n\n      if (!Object.keys(responses).some((status) => status.startsWith(\"2\"))) {\n        responses[\"200\"] = { description: \"Successful response\" };\n      }\n\n      if (validation?.schema) {\n        const failed = buildValidationFailedResponse(validationShape, registry);\n\n        responses[failed.status] ??= failed.response;\n      }\n\n      if (auth) {\n        responses[\"401\"] ??= buildUnauthorizedResponse(registry);\n      }\n\n      if (tag) {\n        tags.add(tag);\n      }\n\n      // Built in reading order: identity, prose, inputs, outputs, security.\n      const operation: OpenApiOperation = {\n        operationId,\n        ...(route.label ? { summary: route.label } : {}),\n        ...(description.length > 0 ? { description: description.join(\"\\n\\n\") } : {}),\n        ...(tag ? { tags: [tag] } : {}),\n        ...(request.parameters.length > 0 ? { parameters: request.parameters } : {}),\n        ...(request.requestBody ? { requestBody: request.requestBody } : {}),\n        responses: sortResponses(responses),\n        ...(auth ? { security: security.requirementsFor(auth) } : {}),\n      };\n\n      paths[pathKey][method] = operation;\n    }\n  }\n\n  // Keys in reading order: header, servers, tags, paths, components.\n  const document: OpenApiDocument = {\n    openapi: \"3.1.0\",\n    jsonSchemaDialect: OPENAPI_JSON_SCHEMA_DIALECT,\n    info: { ...context.info },\n    ...(context.servers && context.servers.length > 0\n      ? { servers: context.servers.map((url) => ({ url })) }\n      : {}),\n    ...(tags.size > 0 ? { tags: [...tags].sort().map((name) => ({ name })) } : {}),\n    paths,\n  };\n\n  const hasSchemas = Object.keys(registry.schemas).length > 0;\n\n  if (hasSchemas || security.hasSchemes()) {\n    document.components = {};\n\n    if (hasSchemas) {\n      document.components.schemas = registry.schemas;\n    }\n\n    if (security.hasSchemes()) {\n      document.components.securitySchemes = security.schemes;\n    }\n  }\n\n  return { document, warnings: [...new Set(warnings)] };\n}\n\nfunction sortResponses(responses: Record<string, OpenApiResponse>): Record<string, OpenApiResponse> {\n  return Object.fromEntries(\n    Object.entries(responses).sort(([first], [second]) => first.localeCompare(second)),\n  );\n}\n"],"mappings":";;;;;;;;;AA2BA,MAAa,8BAA8B;AAE3C,MAAM,iBAA2C;CAAC;CAAQ;CAAO;CAAS;AAAQ;AAElF,SAAS,aAAa,MAAsB,QAAiC;CAC3E,MAAM,QAAkB,CAAC;CAEzB,IAAI,KAAK,UAAU,SAAS,GAC1B,MAAM,KAAK,2CAA2C,KAAK,UAAU,KAAK,IAAI,EAAE,EAAE;CAKpF,IAFmB,KAAK,QAAQ,MAAM,WAAW,OAAO,WAAW,QAEtD,KAAK,eAAe,SAAS,MAAM,GAC9C,MAAM,KACJ,uHACF;CAGF,OAAO;AACT;;;;;;;;;AAUA,SAAgB,qBACd,QACA,SACoB;CACpB,MAAM,WAAqB,CAAC;CAC5B,MAAM,WAAW,IAAI,eAAe,QAAQ,sBAAsB,YAAY,SAAS,KAAK,OAAO,CAAC;CACpG,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,kBAAkB,0BAA0B,QAAQ,kBAAkB;CAC5E,MAAM,QAAkC,CAAC;CACzC,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,+BAAe,IAAI,IAAY;CAErC,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,MAAM,UAAU,CAAC,QAAQ,cAC3B;EAGF,MAAM,UAAU,cAAc,MAAM,MAAM;EAC1C,MAAM,QAAQ,GAAG,OAAO,MAAM,MAAM,CAAC,CAAC,YAAY,EAAE,GAAG,MAAM;EAC7D,MAAM,QAAQ,YAAoB,SAAS,KAAK,GAAG,MAAM,IAAI,SAAS;EAEtE,IAAI,QAAQ,WAAW,GAAG;GACxB,KAAK,uBAAuB,OAAO,MAAM,MAAM,EAAE,kBAAkB;GAEnE;EACF;EAEA,MAAM,UAAU,MAAM;EACtB,MAAM,aAAa,SAAS;EAC5B,MAAM,OAAO,cAAc,MAAM,YAAY,IAAI;EACjD,MAAM,MAAM,gBAAgB,MAAM,IAAI;EACtC,MAAM,UAAU,cAAc,MAAM,IAAI;EAExC,IAAI,YAAY,UACd,KAAK,iEAAiE;EAGxE,KAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,aAAa,CAAC;GAEpB,IAAI,MAAM,QAAQ,CAAC,SAAS;IAC1B,KAAK,GAAG,OAAO,YAAY,EAAE,GAAG,QAAQ,iEAAiE;IAEzG;GACF;GAEA,IAAI,cAAc,iBAAiB,MAAM,MAAM,QAAQ,MAAM,MAAM,QAAQ,SAAS,CAAC;GAErF,IAAI,aAAa,IAAI,WAAW,GAAG;IACjC,IAAI,SAAS;IAEb,OAAO,aAAa,IAAI,GAAG,YAAY,GAAG,QAAQ,GAChD;IAGF,KAAK,gBAAgB,YAAY,iCAAiC,YAAY,GAAG,OAAO,GAAG;IAC3F,cAAc,GAAG,YAAY,GAAG;GAClC;GAEA,aAAa,IAAI,WAAW;GAE5B,MAAM,cAAc,CAClB,MAAM,eAAe,SAAS,aAC9B,GAAI,OAAO,aAAa,MAAM,MAAM,IAAI,CAAC,CAC3C,CAAC,CAAC,QAAQ,SAAyB,OAAO,SAAS,YAAY,KAAK,SAAS,CAAC;GAE9E,MAAM,UAAU,kBAAkB;IAAE;IAAQ,MAAM,MAAM;IAAM;IAAY;GAAK,CAAC;GAEhF,MAAM,YAA6C,MAAM,SACrD,EAAE,OAAO;IAAE,aAAa;IAAa,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,EAAE,EAAE;GAAE,EAAE,IAChG,uBAAuB,SAAS,gBAAgB,UAAU,IAAI;GAElE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,WAAW,OAAO,WAAW,GAAG,CAAC,GACjE,UAAU,SAAS,EAAE,aAAa,sBAAsB;GAG1D,IAAI,YAAY,QAAQ;IACtB,MAAM,SAAS,8BAA8B,iBAAiB,QAAQ;IAEtE,UAAU,OAAO,YAAY,OAAO;GACtC;GAEA,IAAI,MACF,UAAU,WAAW,0BAA0B,QAAQ;GAGzD,IAAI,KACF,KAAK,IAAI,GAAG;GAId,MAAM,YAA8B;IAClC;IACA,GAAI,MAAM,QAAQ,EAAE,SAAS,MAAM,MAAM,IAAI,CAAC;IAC9C,GAAI,YAAY,SAAS,IAAI,EAAE,aAAa,YAAY,KAAK,MAAM,EAAE,IAAI,CAAC;IAC1E,GAAI,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC;IAC7B,GAAI,QAAQ,WAAW,SAAS,IAAI,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;IAC1E,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;IAClE,WAAW,cAAc,SAAS;IAClC,GAAI,OAAO,EAAE,UAAU,SAAS,gBAAgB,IAAI,EAAE,IAAI,CAAC;GAC7D;GAEA,MAAM,QAAQ,CAAC,UAAU;EAC3B;CACF;CAGA,MAAM,WAA4B;EAChC,SAAS;EACT,mBAAmB;EACnB,MAAM,EAAE,GAAG,QAAQ,KAAK;EACxB,GAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,IAC5C,EAAE,SAAS,QAAQ,QAAQ,KAAK,SAAS,EAAE,IAAI,EAAE,EAAE,IACnD,CAAC;EACL,GAAI,KAAK,OAAO,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,UAAU,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;EAC5E;CACF;CAEA,MAAM,aAAa,OAAO,KAAK,SAAS,OAAO,CAAC,CAAC,SAAS;CAE1D,IAAI,cAAc,SAAS,WAAW,GAAG;EACvC,SAAS,aAAa,CAAC;EAEvB,IAAI,YACF,SAAS,WAAW,UAAU,SAAS;EAGzC,IAAI,SAAS,WAAW,GACtB,SAAS,WAAW,kBAAkB,SAAS;CAEnD;CAEA,OAAO;EAAE;EAAU,UAAU,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC;CAAE;AACtD;AAEA,SAAS,cAAc,WAA6E;CAClG,OAAO,OAAO,YACZ,OAAO,QAAQ,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,MAAM,cAAc,MAAM,CAAC,CACnF;AACF"}
+{"version":3,"file":"build-openapi-document.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/build-openapi-document.ts"],"sourcesContent":["import {\n  buildUnauthorizedResponse,\n  buildValidationFailedResponse,\n  resolveValidationResponse,\n} from \"./error-responses\";\nimport {\n  buildOperationId,\n  expandMethods,\n  firstSegmentTag,\n  toOpenApiPath,\n  type OpenApiMethod,\n} from \"./paths\";\nimport { buildRequestParts } from \"./request-schemas\";\nimport { buildDeclaredResponses } from \"./response-schemas\";\nimport { SchemaRegistry } from \"./schema-registry\";\nimport { readRouteAuth, SecuritySchemes } from \"./security\";\nimport type {\n  AuthDescriptor,\n  OpenApiBuildResult,\n  OpenApiContext,\n  OpenApiDocument,\n  OpenApiOperation,\n  OpenApiResponse,\n  OpenApiRouteInput,\n} from \"./types\";\n\n/** `jsonSchemaDialect` of every document: OpenAPI 3.1 schemas are JSON Schema 2020-12. */\nexport const OPENAPI_JSON_SCHEMA_DIALECT = \"https://json-schema.org/draft/2020-12/schema\";\n\nconst UNSAFE_METHODS: readonly OpenApiMethod[] = [\"post\", \"put\", \"patch\", \"delete\"];\n\nfunction describeAuth(auth: AuthDescriptor, method: OpenApiMethod): string[] {\n  const lines: string[] = [];\n\n  if (auth.userTypes.length > 0) {\n    lines.push(`Requires an authenticated user of type: ${auth.userTypes.join(\", \")}.`);\n  }\n\n  const usesCookie = auth.sources.some((source) => typeof source !== \"string\");\n\n  if (usesCookie && UNSAFE_METHODS.includes(method)) {\n    lines.push(\n      \"When authenticating with the cookie, the request must also carry a same-origin Origin or Referer header (CSRF guard).\",\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Build an OpenAPI 3.1 document from registered routes.\n *\n * Pure: it reads the routes it is given (`router.list()` in the app), converts Seal schemas\n * with `toJsonSchema(\"draft-2020-12\")` and returns plain JSON plus the gaps it found as\n * `warnings`. It never throws for a single route it cannot document; that route is\n * documented as far as possible and a warning explains what was left out.\n */\nexport function buildOpenApiDocument(\n  routes: readonly OpenApiRouteInput[],\n  context: OpenApiContext,\n): OpenApiBuildResult {\n  const warnings: string[] = [];\n  const registry = new SchemaRegistry(context.resolveResourceName, (message) => warnings.push(message));\n  const security = new SecuritySchemes();\n  const validationShape = resolveValidationResponse(context.validationResponse);\n  const paths: OpenApiDocument[\"paths\"] = {};\n  const tags = new Set<string>();\n  const operationIds = new Set<string>();\n\n  for (const route of routes) {\n    if (route.isPage && !context.includePages) {\n      continue;\n    }\n\n    const methods = expandMethods(route.method);\n    const label = `${String(route.method).toUpperCase()} ${route.path}`;\n    const warn = (message: string) => warnings.push(`${label}: ${message}`);\n\n    if (methods.length === 0) {\n      warn(`unsupported method \"${String(route.method)}\", route skipped.`);\n\n      continue;\n    }\n\n    const handler = route.handler as OpenApiRouteInput[\"handler\"] | undefined;\n    const validation = handler?.validation;\n    const auth = readRouteAuth(route.middleware, warn);\n    const tag = firstSegmentTag(route.path);\n    const pathKey = toOpenApiPath(route.path);\n\n    if (validation?.validate) {\n      warn(\"validation.validate is custom middleware and is not documented.\");\n    }\n\n    for (const method of methods) {\n      paths[pathKey] ??= {};\n\n      if (paths[pathKey][method]) {\n        warn(`${method.toUpperCase()} ${pathKey} is already documented by an earlier route; this one is skipped.`);\n\n        continue;\n      }\n\n      let operationId = buildOperationId(route.name, method, route.path, methods.length > 1);\n\n      if (operationIds.has(operationId)) {\n        let suffix = 2;\n\n        while (operationIds.has(`${operationId}_${suffix}`)) {\n          suffix++;\n        }\n\n        warn(`operationId \"${operationId}\" is already used; renamed to \"${operationId}_${suffix}\".`);\n        operationId = `${operationId}_${suffix}`;\n      }\n\n      operationIds.add(operationId);\n\n      const description = [\n        route.description ?? handler?.description,\n        ...(auth ? describeAuth(auth, method) : []),\n      ].filter((line): line is string => typeof line === \"string\" && line.length > 0);\n\n      const request = buildRequestParts({ method, path: route.path, validation, warn });\n\n      const responses: Record<string, OpenApiResponse> = route.isPage\n        ? { \"200\": { description: \"HTML page\", content: { \"text/html\": { schema: { type: \"string\" } } } } }\n        : buildDeclaredResponses(handler?.responseSchema, registry, warn);\n\n      if (!Object.keys(responses).some((status) => status.startsWith(\"2\"))) {\n        responses[\"200\"] = { description: \"Successful response\" };\n      }\n\n      if (validation?.schema) {\n        const failed = buildValidationFailedResponse(validationShape, registry);\n\n        responses[failed.status] ??= failed.response;\n      }\n\n      if (auth) {\n        responses[\"401\"] ??= buildUnauthorizedResponse(registry);\n      }\n\n      if (tag) {\n        tags.add(tag);\n      }\n\n      // Built in reading order: identity, prose, inputs, outputs, security.\n      const operation: OpenApiOperation = {\n        operationId,\n        ...(route.label ? { summary: route.label } : {}),\n        ...(description.length > 0 ? { description: description.join(\"\\n\\n\") } : {}),\n        ...(tag ? { tags: [tag] } : {}),\n        ...(request.parameters.length > 0 ? { parameters: request.parameters } : {}),\n        ...(request.requestBody ? { requestBody: request.requestBody } : {}),\n        responses: sortResponses(responses),\n        ...(auth ? { security: security.requirementsFor(auth) } : {}),\n      };\n\n      paths[pathKey][method] = operation;\n    }\n  }\n\n  // Keys in reading order: header, servers, tags, paths, components.\n  const document: OpenApiDocument = {\n    openapi: \"3.1.0\",\n    jsonSchemaDialect: OPENAPI_JSON_SCHEMA_DIALECT,\n    info: { ...context.info },\n    ...(context.servers && context.servers.length > 0\n      ? { servers: context.servers.map((url) => ({ url })) }\n      : {}),\n    ...(tags.size > 0 ? { tags: [...tags].sort().map((name) => ({ name })) } : {}),\n    paths,\n  };\n\n  const hasSchemas = Object.keys(registry.schemas).length > 0;\n\n  if (hasSchemas || security.hasSchemes()) {\n    document.components = {};\n\n    if (hasSchemas) {\n      document.components.schemas = registry.schemas;\n    }\n\n    if (security.hasSchemes()) {\n      document.components.securitySchemes = security.schemes;\n    }\n  }\n\n  return { document, warnings: [...new Set(warnings)] };\n}\n\nfunction sortResponses(responses: Record<string, OpenApiResponse>): Record<string, OpenApiResponse> {\n  return Object.fromEntries(\n    Object.entries(responses).sort(([first], [second]) => first.localeCompare(second)),\n  );\n}\n"],"mappings":"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"}

package/esm/openapi/cast-schema.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/openapi/cast-schema.ts
+//#region ../../packages/core/src/openapi/cast-schema.ts
 /**
 * JSON Schema of the DEFAULT date output of a resource field (`iso`, `format`, `timestamp`
 * and `humanTime` on; `timezone`, `locale` and `offset` off), matching `BaseCastOutput<"date">`.

package/esm/openapi/cast-schema.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cast-schema.mjs","names":[],"sources":["../../../../../../../core/src/openapi/cast-schema.ts"],"sourcesContent":["import type { OpenApiSchema } from \"./types\";\n\n/**\n * JSON Schema of the DEFAULT date output of a resource field (`iso`, `format`, `timestamp`\n * and `humanTime` on; `timezone`, `locale` and `offset` off), matching `BaseCastOutput<\"date\">`.\n */\nconst DEFAULT_DATE_SCHEMA: OpenApiSchema = {\n  type: \"object\",\n  properties: {\n    iso: { type: \"string\", format: \"date-time\" },\n    format: { type: \"string\" },\n    timestamp: { type: \"number\" },\n    humanTime: { type: \"string\" },\n  },\n  required: [\"iso\", \"format\", \"timestamp\", \"humanTime\"],\n};\n\nfunction baseCastSchema(base: string): OpenApiSchema | undefined {\n  switch (base) {\n    case \"string\":\n    case \"localized\":\n      return { type: \"string\" };\n    case \"url\":\n    case \"uploadsUrl\":\n    case \"storageUrl\":\n      return { type: \"string\", format: \"uri\" };\n    case \"number\":\n    case \"float\":\n      return { type: \"number\" };\n    case \"int\":\n      return { type: \"integer\" };\n    case \"boolean\":\n      return { type: \"boolean\" };\n    case \"object\":\n      return { type: \"object\" };\n    case \"array\":\n      return { type: \"array\" };\n    case \"date\":\n      return structuredClone(DEFAULT_DATE_SCHEMA);\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Make a schema accept `null` too, the 3.1 way: `type: [T, \"null\"]`. A schema without a plain\n * `type` (a `$ref`, `{}`) is wrapped in `anyOf` with `{ type: \"null\" }`.\n */\nexport function makeNullable(schema: OpenApiSchema): OpenApiSchema {\n  if (typeof schema.type === \"string\") {\n    return { ...schema, type: [schema.type, \"null\"] };\n  }\n\n  if (Array.isArray(schema.type)) {\n    return schema.type.includes(\"null\") ? schema : { ...schema, type: [...schema.type, \"null\"] };\n  }\n\n  return { anyOf: [schema, { type: \"null\" }] };\n}\n\n/**\n * JSON Schema of a resource cast string, suffixes included (`\"string\"`, `\"number?\"`,\n * `\"string[]\"`, `\"date[]?\"`). `?` means \"always present, value or null\"; `[]` wraps the base\n * in an array, and with `?` it is the array that may be null.\n *\n * @returns `undefined` for a cast this mapper does not know.\n */\nexport function castToJsonSchema(cast: string): OpenApiSchema | undefined {\n  let base = cast;\n  let nullable = false;\n  let isArray = false;\n\n  if (base.endsWith(\"?\")) {\n    nullable = true;\n    base = base.slice(0, -1);\n  }\n\n  if (base.endsWith(\"[]\")) {\n    isArray = true;\n    base = base.slice(0, -2);\n  }\n\n  const baseSchema = baseCastSchema(base);\n\n  if (!baseSchema) {\n    return undefined;\n  }\n\n  const shaped: OpenApiSchema = isArray ? { type: \"array\", items: baseSchema } : baseSchema;\n\n  return nullable ? makeNullable(shaped) : shaped;\n}\n"],"mappings":";;;;;AAMA,MAAM,sBAAqC;CACzC,MAAM;CACN,YAAY;EACV,KAAK;GAAE,MAAM;GAAU,QAAQ;EAAY;EAC3C,QAAQ,EAAE,MAAM,SAAS;EACzB,WAAW,EAAE,MAAM,SAAS;EAC5B,WAAW,EAAE,MAAM,SAAS;CAC9B;CACA,UAAU;EAAC;EAAO;EAAU;EAAa;CAAW;AACtD;AAEA,SAAS,eAAe,MAAyC;CAC/D,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,aACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK;EACL,KAAK;EACL,KAAK,cACH,OAAO;GAAE,MAAM;GAAU,QAAQ;EAAM;EACzC,KAAK;EACL,KAAK,SACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK,OACH,OAAO,EAAE,MAAM,UAAU;EAC3B,KAAK,WACH,OAAO,EAAE,MAAM,UAAU;EAC3B,KAAK,UACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK,SACH,OAAO,EAAE,MAAM,QAAQ;EACzB,KAAK,QACH,OAAO,gBAAgB,mBAAmB;EAC5C,SACE;CACJ;AACF;;;;;AAMA,SAAgB,aAAa,QAAsC;CACjE,IAAI,OAAO,OAAO,SAAS,UACzB,OAAO;EAAE,GAAG;EAAQ,MAAM,CAAC,OAAO,MAAM,MAAM;CAAE;CAGlD,IAAI,MAAM,QAAQ,OAAO,IAAI,GAC3B,OAAO,OAAO,KAAK,SAAS,MAAM,IAAI,SAAS;EAAE,GAAG;EAAQ,MAAM,CAAC,GAAG,OAAO,MAAM,MAAM;CAAE;CAG7F,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,EAAE;AAC7C;;;;;;;;AASA,SAAgB,iBAAiB,MAAyC;CACxE,IAAI,OAAO;CACX,IAAI,WAAW;CACf,IAAI,UAAU;CAEd,IAAI,KAAK,SAAS,GAAG,GAAG;EACtB,WAAW;EACX,OAAO,KAAK,MAAM,GAAG,EAAE;CACzB;CAEA,IAAI,KAAK,SAAS,IAAI,GAAG;EACvB,UAAU;EACV,OAAO,KAAK,MAAM,GAAG,EAAE;CACzB;CAEA,MAAM,aAAa,eAAe,IAAI;CAEtC,IAAI,CAAC,YACH;CAGF,MAAM,SAAwB,UAAU;EAAE,MAAM;EAAS,OAAO;CAAW,IAAI;CAE/E,OAAO,WAAW,aAAa,MAAM,IAAI;AAC3C"}
+{"version":3,"file":"cast-schema.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/cast-schema.ts"],"sourcesContent":["import type { OpenApiSchema } from \"./types\";\n\n/**\n * JSON Schema of the DEFAULT date output of a resource field (`iso`, `format`, `timestamp`\n * and `humanTime` on; `timezone`, `locale` and `offset` off), matching `BaseCastOutput<\"date\">`.\n */\nconst DEFAULT_DATE_SCHEMA: OpenApiSchema = {\n  type: \"object\",\n  properties: {\n    iso: { type: \"string\", format: \"date-time\" },\n    format: { type: \"string\" },\n    timestamp: { type: \"number\" },\n    humanTime: { type: \"string\" },\n  },\n  required: [\"iso\", \"format\", \"timestamp\", \"humanTime\"],\n};\n\nfunction baseCastSchema(base: string): OpenApiSchema | undefined {\n  switch (base) {\n    case \"string\":\n    case \"localized\":\n      return { type: \"string\" };\n    case \"url\":\n    case \"uploadsUrl\":\n    case \"storageUrl\":\n      return { type: \"string\", format: \"uri\" };\n    case \"number\":\n    case \"float\":\n      return { type: \"number\" };\n    case \"int\":\n      return { type: \"integer\" };\n    case \"boolean\":\n      return { type: \"boolean\" };\n    case \"object\":\n      return { type: \"object\" };\n    case \"array\":\n      return { type: \"array\" };\n    case \"date\":\n      return structuredClone(DEFAULT_DATE_SCHEMA);\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Make a schema accept `null` too, the 3.1 way: `type: [T, \"null\"]`. A schema without a plain\n * `type` (a `$ref`, `{}`) is wrapped in `anyOf` with `{ type: \"null\" }`.\n */\nexport function makeNullable(schema: OpenApiSchema): OpenApiSchema {\n  if (typeof schema.type === \"string\") {\n    return { ...schema, type: [schema.type, \"null\"] };\n  }\n\n  if (Array.isArray(schema.type)) {\n    return schema.type.includes(\"null\") ? schema : { ...schema, type: [...schema.type, \"null\"] };\n  }\n\n  return { anyOf: [schema, { type: \"null\" }] };\n}\n\n/**\n * JSON Schema of a resource cast string, suffixes included (`\"string\"`, `\"number?\"`,\n * `\"string[]\"`, `\"date[]?\"`). `?` means \"always present, value or null\"; `[]` wraps the base\n * in an array, and with `?` it is the array that may be null.\n *\n * @returns `undefined` for a cast this mapper does not know.\n */\nexport function castToJsonSchema(cast: string): OpenApiSchema | undefined {\n  let base = cast;\n  let nullable = false;\n  let isArray = false;\n\n  if (base.endsWith(\"?\")) {\n    nullable = true;\n    base = base.slice(0, -1);\n  }\n\n  if (base.endsWith(\"[]\")) {\n    isArray = true;\n    base = base.slice(0, -2);\n  }\n\n  const baseSchema = baseCastSchema(base);\n\n  if (!baseSchema) {\n    return undefined;\n  }\n\n  const shaped: OpenApiSchema = isArray ? { type: \"array\", items: baseSchema } : baseSchema;\n\n  return nullable ? makeNullable(shaped) : shaped;\n}\n"],"mappings":";;;;;AAMA,MAAM,sBAAqC;CACzC,MAAM;CACN,YAAY;EACV,KAAK;GAAE,MAAM;GAAU,QAAQ;EAAY;EAC3C,QAAQ,EAAE,MAAM,SAAS;EACzB,WAAW,EAAE,MAAM,SAAS;EAC5B,WAAW,EAAE,MAAM,SAAS;CAC9B;CACA,UAAU;EAAC;EAAO;EAAU;EAAa;CAAW;AACtD;AAEA,SAAS,eAAe,MAAyC;CAC/D,QAAQ,MAAR;EACE,KAAK;EACL,KAAK,aACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK;EACL,KAAK;EACL,KAAK,cACH,OAAO;GAAE,MAAM;GAAU,QAAQ;EAAM;EACzC,KAAK;EACL,KAAK,SACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK,OACH,OAAO,EAAE,MAAM,UAAU;EAC3B,KAAK,WACH,OAAO,EAAE,MAAM,UAAU;EAC3B,KAAK,UACH,OAAO,EAAE,MAAM,SAAS;EAC1B,KAAK,SACH,OAAO,EAAE,MAAM,QAAQ;EACzB,KAAK,QACH,OAAO,gBAAgB,mBAAmB;EAC5C,SACE;CACJ;AACF;;;;;AAMA,SAAgB,aAAa,QAAsC;CACjE,IAAI,OAAO,OAAO,SAAS,UACzB,OAAO;EAAE,GAAG;EAAQ,MAAM,CAAC,OAAO,MAAM,MAAM;CAAE;CAGlD,IAAI,MAAM,QAAQ,OAAO,IAAI,GAC3B,OAAO,OAAO,KAAK,SAAS,MAAM,IAAI,SAAS;EAAE,GAAG;EAAQ,MAAM,CAAC,GAAG,OAAO,MAAM,MAAM;CAAE;CAG7F,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,EAAE;AAC7C;;;;;;;;AASA,SAAgB,iBAAiB,MAAyC;CACxE,IAAI,OAAO;CACX,IAAI,WAAW;CACf,IAAI,UAAU;CAEd,IAAI,KAAK,SAAS,GAAG,GAAG;EACtB,WAAW;EACX,OAAO,KAAK,MAAM,GAAG,EAAE;CACzB;CAEA,IAAI,KAAK,SAAS,IAAI,GAAG;EACvB,UAAU;EACV,OAAO,KAAK,MAAM,GAAG,EAAE;CACzB;CAEA,MAAM,aAAa,eAAe,IAAI;CAEtC,IAAI,CAAC,YACH;CAGF,MAAM,SAAwB,UAAU;EAAE,MAAM;EAAS,OAAO;CAAW,IAAI;CAE/E,OAAO,WAAW,aAAa,MAAM,IAAI;AAC3C"}

package/esm/openapi/collect-openapi-document.mjs

@@ -1,7 +1,7 @@
 import { runRegistrationChild } from "../production/registration-child-runner.mjs";
 import { OPENAPI_RESULT_MESSAGE, parseOpenApiChildResult } from "./openapi-protocol.mjs";
 
-//#region ../core/src/openapi/collect-openapi-document.ts
+//#region ../../packages/core/src/openapi/collect-openapi-document.ts
 /**
 * Build the app's OpenAPI document in a fresh process.
 *

package/esm/openapi/collect-openapi-document.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect-openapi-document.mjs","names":[],"sources":["../../../../../../../core/src/openapi/collect-openapi-document.ts"],"sourcesContent":["import {\n  runRegistrationChild,\n  type RegistrationChildForker,\n} from \"../production/registration-child-runner\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport {\n  OPENAPI_PROTOCOL_VERSION,\n  OPENAPI_RESULT_MESSAGE,\n  parseOpenApiChildResult,\n  type OpenApiChildRequestOptions,\n  type OpenApiChildResult,\n} from \"./openapi-protocol\";\n\nexport type CollectOpenApiDocumentOptions = Readonly<{\n  cwd?: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  timeoutMs?: number;\n  childEntry?: string;\n  forkProcess?: RegistrationChildForker;\n  title?: string;\n  server?: string;\n  includePages?: boolean;\n}>;\n\n/**\n * Build the app's OpenAPI document in a fresh process.\n *\n * Uses the same registration child as `warlock build` (it imports the route modules without\n * booting connectors) in OpenAPI mode: the document is built inside the child, where the Seal\n * schemas and resource classes live, and only the finished JSON crosses IPC.\n */\nexport function collectOpenApiDocument(\n  options: CollectOpenApiDocumentOptions = {},\n): Promise<OpenApiChildResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const openapi: OpenApiChildRequestOptions = {\n    version: OPENAPI_PROTOCOL_VERSION,\n    ...(options.title !== undefined ? { title: options.title } : {}),\n    ...(options.server !== undefined ? { server: options.server } : {}),\n    ...(options.includePages !== undefined ? { includePages: options.includePages } : {}),\n  };\n\n  return runRegistrationChild<OpenApiChildResult>({\n    cwd,\n    timeoutMs: options.timeoutMs,\n    childEntry: options.childEntry,\n    forkProcess: options.forkProcess,\n    request: {\n      version: 1,\n      cwd,\n      environment: options.environment,\n      runtimeStrategy: options.runtimeStrategy,\n      openapi,\n    },\n    resultMessageType: OPENAPI_RESULT_MESSAGE,\n    resultNoun: \"document\",\n    readResult: (message) => parseOpenApiChildResult(message.result),\n  });\n}\n"],"mappings":";;;;;;;;;;;AAgCA,SAAgB,uBACd,UAAyC,CAAC,GACb;CAC7B,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,UAAsC;EAC1C;EACA,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EAC9D,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;EACjE,GAAI,QAAQ,iBAAiB,SAAY,EAAE,cAAc,QAAQ,aAAa,IAAI,CAAC;CACrF;CAEA,OAAO,qBAAyC;EAC9C;EACA,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,aAAa,QAAQ;EACrB,SAAS;GACP,SAAS;GACT;GACA,aAAa,QAAQ;GACrB,iBAAiB,QAAQ;GACzB;EACF;EACA,mBAAmB;EACnB,YAAY;EACZ,aAAa,YAAY,wBAAwB,QAAQ,MAAM;CACjE,CAAC;AACH"}
+{"version":3,"file":"collect-openapi-document.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/collect-openapi-document.ts"],"sourcesContent":["import {\n  runRegistrationChild,\n  type RegistrationChildForker,\n} from \"../production/registration-child-runner\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport {\n  OPENAPI_PROTOCOL_VERSION,\n  OPENAPI_RESULT_MESSAGE,\n  parseOpenApiChildResult,\n  type OpenApiChildRequestOptions,\n  type OpenApiChildResult,\n} from \"./openapi-protocol\";\n\nexport type CollectOpenApiDocumentOptions = Readonly<{\n  cwd?: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  timeoutMs?: number;\n  childEntry?: string;\n  forkProcess?: RegistrationChildForker;\n  title?: string;\n  server?: string;\n  includePages?: boolean;\n}>;\n\n/**\n * Build the app's OpenAPI document in a fresh process.\n *\n * Uses the same registration child as `warlock build` (it imports the route modules without\n * booting connectors) in OpenAPI mode: the document is built inside the child, where the Seal\n * schemas and resource classes live, and only the finished JSON crosses IPC.\n */\nexport function collectOpenApiDocument(\n  options: CollectOpenApiDocumentOptions = {},\n): Promise<OpenApiChildResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const openapi: OpenApiChildRequestOptions = {\n    version: OPENAPI_PROTOCOL_VERSION,\n    ...(options.title !== undefined ? { title: options.title } : {}),\n    ...(options.server !== undefined ? { server: options.server } : {}),\n    ...(options.includePages !== undefined ? { includePages: options.includePages } : {}),\n  };\n\n  return runRegistrationChild<OpenApiChildResult>({\n    cwd,\n    timeoutMs: options.timeoutMs,\n    childEntry: options.childEntry,\n    forkProcess: options.forkProcess,\n    request: {\n      version: 1,\n      cwd,\n      environment: options.environment,\n      runtimeStrategy: options.runtimeStrategy,\n      openapi,\n    },\n    resultMessageType: OPENAPI_RESULT_MESSAGE,\n    resultNoun: \"document\",\n    readResult: (message) => parseOpenApiChildResult(message.result),\n  });\n}\n"],"mappings":";;;;;;;;;;;AAgCA,SAAgB,uBACd,UAAyC,CAAC,GACb;CAC7B,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CACvC,MAAM,UAAsC;EAC1C;EACA,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;EAC9D,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;EACjE,GAAI,QAAQ,iBAAiB,SAAY,EAAE,cAAc,QAAQ,aAAa,IAAI,CAAC;CACrF;CAEA,OAAO,qBAAyC;EAC9C;EACA,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,aAAa,QAAQ;EACrB,SAAS;GACP,SAAS;GACT;GACA,aAAa,QAAQ;GACrB,iBAAiB,QAAQ;GACzB;EACF;EACA,mBAAmB;EACnB,YAAY;EACZ,aAAa,YAAY,wBAAwB,QAAQ,MAAM;CACjE,CAAC;AACH"}

package/esm/openapi/development-openapi-provider.d.mts

@@ -1,7 +1,7 @@
 import { PostmanCollection, PostmanCollectionOptions } from "./postman/postman-types.mjs";
 import { OpenApiBuildResult } from "./types.mjs";
 
-//#region ../core/src/openapi/development-openapi-provider.d.ts
+//#region ../../packages/core/src/openapi/development-openapi-provider.d.ts
 type DevelopmentOpenApiProvider = () => Promise<OpenApiBuildResult>;
 type DevelopmentPostmanResult = {
   collection: PostmanCollection;

package/esm/openapi/development-openapi-provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"development-openapi-provider.d.mts","names":[],"sources":["../../../../../../../core/src/openapi/development-openapi-provider.ts"],"mappings":";;;;KAIK,0BAAA,SAAmC,OAAO,CAAC,kBAAA;AAAA,KAEpC,wBAAA;EACV,UAAA,EAAY,iBAAiB;EAC7B,QAAA;AAAA;;AAJgE;AAElE;;iBAWgB,kCAAA,CAAmC,KAAiC,EAA1B,0BAA0B;;;;;iBAQ9D,6BAAA,IAAiC,OAAO,CAAC,kBAAA;AAjBrD;AASV;;;;AATU,iBAgCY,+BAAA,CACpB,OAAA,GAAS,wBAAA,GACR,OAAA,CAAQ,wBAAA"}
+{"version":3,"file":"development-openapi-provider.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/openapi/development-openapi-provider.ts"],"mappings":";;;;KAIK,0BAAA,SAAmC,OAAO,CAAC,kBAAA;AAAA,KAEpC,wBAAA;EACV,UAAA,EAAY,iBAAiB;EAC7B,QAAA;AAAA;;AAJgE;AAElE;;iBAWgB,kCAAA,CAAmC,KAAiC,EAA1B,0BAA0B;;;;;iBAQ9D,6BAAA,IAAiC,OAAO,CAAC,kBAAA;AAjBrD;AASV;;;;AATU,iBAgCY,+BAAA,CACpB,OAAA,GAAS,wBAAA,GACR,OAAA,CAAQ,wBAAA"}

package/esm/openapi/development-openapi-provider.mjs

@@ -1,6 +1,6 @@
 import { openApiToPostmanCollection } from "./postman/openapi-to-postman-collection.mjs";
 
-//#region ../core/src/openapi/development-openapi-provider.ts
+//#region ../../packages/core/src/openapi/development-openapi-provider.ts
 let provider;
 /**
 * Called by the dev server at startup. The builder lives under `dev-server/`, so the

package/esm/openapi/development-openapi-provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"development-openapi-provider.mjs","names":[],"sources":["../../../../../../../core/src/openapi/development-openapi-provider.ts"],"sourcesContent":["import { openApiToPostmanCollection } from \"./postman/openapi-to-postman-collection\";\nimport type { PostmanCollection, PostmanCollectionOptions } from \"./postman/postman-types\";\nimport type { OpenApiBuildResult } from \"./types\";\n\ntype DevelopmentOpenApiProvider = () => Promise<OpenApiBuildResult>;\n\nexport type DevelopmentPostmanResult = {\n  collection: PostmanCollection;\n  warnings: string[];\n};\n\nlet provider: DevelopmentOpenApiProvider | undefined;\n\n/**\n * Called by the dev server at startup. The builder lives under `dev-server/`, so the\n * production entry never reaches it; this registry is the only thing the root exports.\n */\nexport function registerDevelopmentOpenApiProvider(build: DevelopmentOpenApiProvider): void {\n  provider = build;\n}\n\n/**\n * The OpenAPI document for the routes registered in this process, built by the dev\n * server's provider. Throws outside `warlock dev`, where no provider is registered.\n */\nexport async function getDevelopmentOpenApiDocument(): Promise<OpenApiBuildResult> {\n  if (!provider) {\n    throw new Error(\n      \"No development OpenAPI provider is registered; the API docs are only available under `warlock dev`.\",\n    );\n  }\n\n  return provider();\n}\n\n/**\n * The Postman collection (v2.1.0) for the routes registered in this process: the development\n * OpenAPI document run through `openApiToPostmanCollection`, so both always agree. Throws\n * outside `warlock dev`, like `getDevelopmentOpenApiDocument`.\n */\nexport async function getDevelopmentPostmanCollection(\n  options: PostmanCollectionOptions = {},\n): Promise<DevelopmentPostmanResult> {\n  const { document, warnings } = await getDevelopmentOpenApiDocument();\n\n  return { collection: openApiToPostmanCollection(document, options), warnings };\n}\n"],"mappings":";;;AAWA,IAAI;;;;;AAMJ,SAAgB,mCAAmC,OAAyC;CAC1F,WAAW;AACb;;;;;AAMA,eAAsB,gCAA6D;CACjF,IAAI,CAAC,UACH,MAAM,IAAI,MACR,qGACF;CAGF,OAAO,SAAS;AAClB;;;;;;AAOA,eAAsB,gCACpB,UAAoC,CAAC,GACF;CACnC,MAAM,EAAE,UAAU,aAAa,MAAM,8BAA8B;CAEnE,OAAO;EAAE,YAAY,2BAA2B,UAAU,OAAO;EAAG;CAAS;AAC/E"}
+{"version":3,"file":"development-openapi-provider.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/development-openapi-provider.ts"],"sourcesContent":["import { openApiToPostmanCollection } from \"./postman/openapi-to-postman-collection\";\nimport type { PostmanCollection, PostmanCollectionOptions } from \"./postman/postman-types\";\nimport type { OpenApiBuildResult } from \"./types\";\n\ntype DevelopmentOpenApiProvider = () => Promise<OpenApiBuildResult>;\n\nexport type DevelopmentPostmanResult = {\n  collection: PostmanCollection;\n  warnings: string[];\n};\n\nlet provider: DevelopmentOpenApiProvider | undefined;\n\n/**\n * Called by the dev server at startup. The builder lives under `dev-server/`, so the\n * production entry never reaches it; this registry is the only thing the root exports.\n */\nexport function registerDevelopmentOpenApiProvider(build: DevelopmentOpenApiProvider): void {\n  provider = build;\n}\n\n/**\n * The OpenAPI document for the routes registered in this process, built by the dev\n * server's provider. Throws outside `warlock dev`, where no provider is registered.\n */\nexport async function getDevelopmentOpenApiDocument(): Promise<OpenApiBuildResult> {\n  if (!provider) {\n    throw new Error(\n      \"No development OpenAPI provider is registered; the API docs are only available under `warlock dev`.\",\n    );\n  }\n\n  return provider();\n}\n\n/**\n * The Postman collection (v2.1.0) for the routes registered in this process: the development\n * OpenAPI document run through `openApiToPostmanCollection`, so both always agree. Throws\n * outside `warlock dev`, like `getDevelopmentOpenApiDocument`.\n */\nexport async function getDevelopmentPostmanCollection(\n  options: PostmanCollectionOptions = {},\n): Promise<DevelopmentPostmanResult> {\n  const { document, warnings } = await getDevelopmentOpenApiDocument();\n\n  return { collection: openApiToPostmanCollection(document, options), warnings };\n}\n"],"mappings":";;;AAWA,IAAI;;;;;AAMJ,SAAgB,mCAAmC,OAAyC;CAC1F,WAAW;AACb;;;;;AAMA,eAAsB,gCAA6D;CACjF,IAAI,CAAC,UACH,MAAM,IAAI,MACR,qGACF;CAGF,OAAO,SAAS;AAClB;;;;;;AAOA,eAAsB,gCACpB,UAAoC,CAAC,GACF;CACnC,MAAM,EAAE,UAAU,aAAa,MAAM,8BAA8B;CAEnE,OAAO;EAAE,YAAY,2BAA2B,UAAU,OAAO;EAAG;CAAS;AAC/E"}

package/esm/openapi/error-responses.mjs

@@ -1,6 +1,6 @@
 import { describeStatus } from "./response-schemas.mjs";
 
-//#region ../core/src/openapi/error-responses.ts
+//#region ../../packages/core/src/openapi/error-responses.ts
 const DEFAULT_VALIDATION_RESPONSE = {
 	errors: "errors",
 	inputKey: "input",

package/esm/openapi/error-responses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"error-responses.mjs","names":[],"sources":["../../../../../../../core/src/openapi/error-responses.ts"],"sourcesContent":["import { describeStatus } from \"./response-schemas\";\nimport type { SchemaRegistry } from \"./schema-registry\";\nimport type { OpenApiResponse, OpenApiValidationResponseConfig } from \"./types\";\n\nconst DEFAULT_VALIDATION_RESPONSE = {\n  errors: \"errors\",\n  inputKey: \"input\",\n  inputError: \"error\",\n  status: 422,\n};\n\nexport type ValidationResponseShape = typeof DEFAULT_VALIDATION_RESPONSE;\n\n/**\n * The `validation.response` config over its documented defaults, as `Response.failedSchema`\n * reads it.\n */\nexport function resolveValidationResponse(\n  config: OpenApiValidationResponseConfig | undefined,\n): ValidationResponseShape {\n  const merged = { ...DEFAULT_VALIDATION_RESPONSE };\n\n  if (typeof config?.errors === \"string\" && config.errors) {\n    merged.errors = config.errors;\n  }\n\n  if (typeof config?.inputKey === \"string\" && config.inputKey) {\n    merged.inputKey = config.inputKey;\n  }\n\n  if (typeof config?.inputError === \"string\" && config.inputError) {\n    merged.inputError = config.inputError;\n  }\n\n  if (typeof config?.status === \"number\" && Number.isInteger(config.status)) {\n    merged.status = config.status;\n  }\n\n  return merged;\n}\n\n/**\n * The failed-validation response: `{ [errors]: [{ [inputKey]: string, [inputError]: string }] }`\n * under the configured status. The body is a shared component, emitted once.\n */\nexport function buildValidationFailedResponse(\n  shape: ValidationResponseShape,\n  registry: SchemaRegistry,\n): { status: string; response: OpenApiResponse } {\n  const ref = registry.shared(\"ValidationFailed\", {\n    type: \"object\",\n    properties: {\n      [shape.errors]: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            [shape.inputKey]: { type: \"string\" },\n            [shape.inputError]: { type: \"string\" },\n          },\n          required: [shape.inputKey, shape.inputError],\n        },\n      },\n    },\n    required: [shape.errors],\n  });\n\n  return {\n    status: String(shape.status),\n    response: {\n      description: describeStatus(\"422\"),\n      content: { \"application/json\": { schema: ref } },\n    },\n  };\n}\n\n/**\n * The 401 response of a guarded route: the conventional `{ error: string }` body.\n */\nexport function buildUnauthorizedResponse(registry: SchemaRegistry): OpenApiResponse {\n  const ref = registry.shared(\"Unauthorized\", {\n    type: \"object\",\n    properties: { error: { type: \"string\" } },\n    required: [\"error\"],\n  });\n\n  return {\n    description: describeStatus(\"401\"),\n    content: { \"application/json\": { schema: ref } },\n  };\n}\n"],"mappings":";;;AAIA,MAAM,8BAA8B;CAClC,QAAQ;CACR,UAAU;CACV,YAAY;CACZ,QAAQ;AACV;;;;;AAQA,SAAgB,0BACd,QACyB;CACzB,MAAM,SAAS,EAAE,GAAG,4BAA4B;CAEhD,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,QAC/C,OAAO,SAAS,OAAO;CAGzB,IAAI,OAAO,QAAQ,aAAa,YAAY,OAAO,UACjD,OAAO,WAAW,OAAO;CAG3B,IAAI,OAAO,QAAQ,eAAe,YAAY,OAAO,YACnD,OAAO,aAAa,OAAO;CAG7B,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,UAAU,OAAO,MAAM,GACtE,OAAO,SAAS,OAAO;CAGzB,OAAO;AACT;;;;;AAMA,SAAgB,8BACd,OACA,UAC+C;CAC/C,MAAM,MAAM,SAAS,OAAO,oBAAoB;EAC9C,MAAM;EACN,YAAY,GACT,MAAM,SAAS;GACd,MAAM;GACN,OAAO;IACL,MAAM;IACN,YAAY;MACT,MAAM,WAAW,EAAE,MAAM,SAAS;MAClC,MAAM,aAAa,EAAE,MAAM,SAAS;IACvC;IACA,UAAU,CAAC,MAAM,UAAU,MAAM,UAAU;GAC7C;EACF,EACF;EACA,UAAU,CAAC,MAAM,MAAM;CACzB,CAAC;CAED,OAAO;EACL,QAAQ,OAAO,MAAM,MAAM;EAC3B,UAAU;GACR,aAAa,eAAe,KAAK;GACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;EACjD;CACF;AACF;;;;AAKA,SAAgB,0BAA0B,UAA2C;CACnF,MAAM,MAAM,SAAS,OAAO,gBAAgB;EAC1C,MAAM;EACN,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE;EACxC,UAAU,CAAC,OAAO;CACpB,CAAC;CAED,OAAO;EACL,aAAa,eAAe,KAAK;EACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;CACjD;AACF"}
+{"version":3,"file":"error-responses.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/error-responses.ts"],"sourcesContent":["import { describeStatus } from \"./response-schemas\";\nimport type { SchemaRegistry } from \"./schema-registry\";\nimport type { OpenApiResponse, OpenApiValidationResponseConfig } from \"./types\";\n\nconst DEFAULT_VALIDATION_RESPONSE = {\n  errors: \"errors\",\n  inputKey: \"input\",\n  inputError: \"error\",\n  status: 422,\n};\n\nexport type ValidationResponseShape = typeof DEFAULT_VALIDATION_RESPONSE;\n\n/**\n * The `validation.response` config over its documented defaults, as `Response.failedSchema`\n * reads it.\n */\nexport function resolveValidationResponse(\n  config: OpenApiValidationResponseConfig | undefined,\n): ValidationResponseShape {\n  const merged = { ...DEFAULT_VALIDATION_RESPONSE };\n\n  if (typeof config?.errors === \"string\" && config.errors) {\n    merged.errors = config.errors;\n  }\n\n  if (typeof config?.inputKey === \"string\" && config.inputKey) {\n    merged.inputKey = config.inputKey;\n  }\n\n  if (typeof config?.inputError === \"string\" && config.inputError) {\n    merged.inputError = config.inputError;\n  }\n\n  if (typeof config?.status === \"number\" && Number.isInteger(config.status)) {\n    merged.status = config.status;\n  }\n\n  return merged;\n}\n\n/**\n * The failed-validation response: `{ [errors]: [{ [inputKey]: string, [inputError]: string }] }`\n * under the configured status. The body is a shared component, emitted once.\n */\nexport function buildValidationFailedResponse(\n  shape: ValidationResponseShape,\n  registry: SchemaRegistry,\n): { status: string; response: OpenApiResponse } {\n  const ref = registry.shared(\"ValidationFailed\", {\n    type: \"object\",\n    properties: {\n      [shape.errors]: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            [shape.inputKey]: { type: \"string\" },\n            [shape.inputError]: { type: \"string\" },\n          },\n          required: [shape.inputKey, shape.inputError],\n        },\n      },\n    },\n    required: [shape.errors],\n  });\n\n  return {\n    status: String(shape.status),\n    response: {\n      description: describeStatus(\"422\"),\n      content: { \"application/json\": { schema: ref } },\n    },\n  };\n}\n\n/**\n * The 401 response of a guarded route: the conventional `{ error: string }` body.\n */\nexport function buildUnauthorizedResponse(registry: SchemaRegistry): OpenApiResponse {\n  const ref = registry.shared(\"Unauthorized\", {\n    type: \"object\",\n    properties: { error: { type: \"string\" } },\n    required: [\"error\"],\n  });\n\n  return {\n    description: describeStatus(\"401\"),\n    content: { \"application/json\": { schema: ref } },\n  };\n}\n"],"mappings":";;;AAIA,MAAM,8BAA8B;CAClC,QAAQ;CACR,UAAU;CACV,YAAY;CACZ,QAAQ;AACV;;;;;AAQA,SAAgB,0BACd,QACyB;CACzB,MAAM,SAAS,EAAE,GAAG,4BAA4B;CAEhD,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,QAC/C,OAAO,SAAS,OAAO;CAGzB,IAAI,OAAO,QAAQ,aAAa,YAAY,OAAO,UACjD,OAAO,WAAW,OAAO;CAG3B,IAAI,OAAO,QAAQ,eAAe,YAAY,OAAO,YACnD,OAAO,aAAa,OAAO;CAG7B,IAAI,OAAO,QAAQ,WAAW,YAAY,OAAO,UAAU,OAAO,MAAM,GACtE,OAAO,SAAS,OAAO;CAGzB,OAAO;AACT;;;;;AAMA,SAAgB,8BACd,OACA,UAC+C;CAC/C,MAAM,MAAM,SAAS,OAAO,oBAAoB;EAC9C,MAAM;EACN,YAAY,GACT,MAAM,SAAS;GACd,MAAM;GACN,OAAO;IACL,MAAM;IACN,YAAY;MACT,MAAM,WAAW,EAAE,MAAM,SAAS;MAClC,MAAM,aAAa,EAAE,MAAM,SAAS;IACvC;IACA,UAAU,CAAC,MAAM,UAAU,MAAM,UAAU;GAC7C;EACF,EACF;EACA,UAAU,CAAC,MAAM,MAAM;CACzB,CAAC;CAED,OAAO;EACL,QAAQ,OAAO,MAAM,MAAM;EAC3B,UAAU;GACR,aAAa,eAAe,KAAK;GACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;EACjD;CACF;AACF;;;;AAKA,SAAgB,0BAA0B,UAA2C;CACnF,MAAM,MAAM,SAAS,OAAO,gBAAgB;EAC1C,MAAM;EACN,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE;EACxC,UAAU,CAAC,OAAO;CACpB,CAAC;CAED,OAAO;EACL,aAAa,eAAe,KAAK;EACjC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,IAAI,EAAE;CACjD;AACF"}

package/esm/openapi/openapi-child-output.mjs

@@ -6,7 +6,7 @@ import config from "@mongez/config";
 import path from "node:path";
 import { readFile } from "node:fs/promises";
 
-//#region ../core/src/openapi/openapi-child-output.ts
+//#region ../../packages/core/src/openapi/openapi-child-output.ts
 async function readAppPackage(cwd) {
 	try {
 		return JSON.parse(await readFile(path.join(cwd, "package.json"), "utf8"));

package/esm/openapi/openapi-child-output.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-child-output.mjs","names":[],"sources":["../../../../../../../core/src/openapi/openapi-child-output.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { httpConfig } from \"../http/config\";\nimport {\n  collectResourceExportMap,\n  type ResourceSourceFile,\n} from \"../router/named-api-routes-with-responses\";\nimport { router } from \"../router/router\";\nimport { buildOpenApiDocument } from \"./build-openapi-document\";\nimport type { OpenApiChildRequestOptions } from \"./openapi-protocol\";\nimport type { OpenApiBuildResult, OpenApiValidationResponseConfig } from \"./types\";\n\nexport type BuildOpenApiForChildOptions = Readonly<{\n  /** Application root (the child's cwd). */\n  cwd: string;\n  /** Every source file the orchestrator knows; `*.resource.ts(x)` ones are mapped to exports. */\n  files: Iterable<ResourceSourceFile>;\n  request: OpenApiChildRequestOptions;\n  onWarn?: (message: string) => void;\n}>;\n\ntype AppPackage = { name?: unknown; version?: unknown; description?: unknown };\n\nasync function readAppPackage(cwd: string): Promise<AppPackage> {\n  try {\n    return JSON.parse(await readFile(path.join(cwd, \"package.json\"), \"utf8\")) as AppPackage;\n  } catch {\n    return {};\n  }\n}\n\nfunction stringOr(value: unknown, fallback: string): string {\n  return typeof value === \"string\" && value.length > 0 ? value : fallback;\n}\n\n/**\n * `http://<host>:<port>` from the `http` config. A wildcard bind address is not a place a\n * client can call, so it becomes `localhost`.\n */\nexport function resolveDefaultServer(): string {\n  const host = stringOr(httpConfig(\"host\"), \"localhost\");\n  const port = httpConfig(\"port\");\n  const callable = host === \"0.0.0.0\" || host === \"::\" ? \"localhost\" : host;\n\n  return `http://${callable}${typeof port === \"number\" || typeof port === \"string\" ? `:${port}` : \"\"}`;\n}\n\n/**\n * Build the OpenAPI document from the routes registered in THIS process.\n *\n * Runs inside the registration child, after the app's route modules are loaded and config is\n * available. Maps resource classes to their export names, reads `info` from the app\n * `package.json`, the server from the `http` config and the 422 shape from\n * `validation.response`.\n */\nexport async function buildOpenApiForChild(\n  options: BuildOpenApiForChildOptions,\n): Promise<OpenApiBuildResult> {\n  const routes = router.list();\n  const declaresSchema = routes.some((route) => route.handler?.responseSchema);\n  const resourceMap = declaresSchema\n    ? await collectResourceExportMap(options.files, options.onWarn)\n    : undefined;\n  const pkg = await readAppPackage(options.cwd);\n  const validationResponse = config.get(\n    \"validation.response\",\n    {},\n  ) as OpenApiValidationResponseConfig;\n\n  return buildOpenApiDocument(routes, {\n    info: {\n      title: options.request.title ?? stringOr(pkg.name, \"Warlock API\"),\n      version: stringOr(pkg.version, \"0.0.0\"),\n      ...(typeof pkg.description === \"string\" && pkg.description\n        ? { description: pkg.description }\n        : {}),\n    },\n    servers: [options.request.server ?? resolveDefaultServer()],\n    includePages: options.request.includePages === true,\n    resolveResourceName: (resource) => resourceMap?.get(resource)?.exportName,\n    validationResponse,\n  });\n}\n"],"mappings":";;;;;;;;;AAwBA,eAAe,eAAe,KAAkC;CAC9D,IAAI;EACF,OAAO,KAAK,MAAM,MAAM,SAAS,KAAK,KAAK,KAAK,cAAc,GAAG,MAAM,CAAC;CAC1E,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,SAAS,OAAgB,UAA0B;CAC1D,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;;;;;AAMA,SAAgB,uBAA+B;CAC7C,MAAM,OAAO,SAAS,WAAW,MAAM,GAAG,WAAW;CACrD,MAAM,OAAO,WAAW,MAAM;CAG9B,OAAO,UAFU,SAAS,aAAa,SAAS,OAAO,cAAc,OAEzC,OAAO,SAAS,YAAY,OAAO,SAAS,WAAW,IAAI,SAAS;AAClG;;;;;;;;;AAUA,eAAsB,qBACpB,SAC6B;CAC7B,MAAM,SAAS,OAAO,KAAK;CAE3B,MAAM,cADiB,OAAO,MAAM,UAAU,MAAM,SAAS,cAC5B,IAC7B,MAAM,yBAAyB,QAAQ,OAAO,QAAQ,MAAM,IAC5D;CACJ,MAAM,MAAM,MAAM,eAAe,QAAQ,GAAG;CAC5C,MAAM,qBAAqB,OAAO,IAChC,uBACA,CAAC,CACH;CAEA,OAAO,qBAAqB,QAAQ;EAClC,MAAM;GACJ,OAAO,QAAQ,QAAQ,SAAS,SAAS,IAAI,MAAM,aAAa;GAChE,SAAS,SAAS,IAAI,SAAS,OAAO;GACtC,GAAI,OAAO,IAAI,gBAAgB,YAAY,IAAI,cAC3C,EAAE,aAAa,IAAI,YAAY,IAC/B,CAAC;EACP;EACA,SAAS,CAAC,QAAQ,QAAQ,UAAU,qBAAqB,CAAC;EAC1D,cAAc,QAAQ,QAAQ,iBAAiB;EAC/C,sBAAsB,aAAa,aAAa,IAAI,QAAQ,CAAC,EAAE;EAC/D;CACF,CAAC;AACH"}
+{"version":3,"file":"openapi-child-output.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/openapi-child-output.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { httpConfig } from \"../http/config\";\nimport {\n  collectResourceExportMap,\n  type ResourceSourceFile,\n} from \"../router/named-api-routes-with-responses\";\nimport { router } from \"../router/router\";\nimport { buildOpenApiDocument } from \"./build-openapi-document\";\nimport type { OpenApiChildRequestOptions } from \"./openapi-protocol\";\nimport type { OpenApiBuildResult, OpenApiValidationResponseConfig } from \"./types\";\n\nexport type BuildOpenApiForChildOptions = Readonly<{\n  /** Application root (the child's cwd). */\n  cwd: string;\n  /** Every source file the orchestrator knows; `*.resource.ts(x)` ones are mapped to exports. */\n  files: Iterable<ResourceSourceFile>;\n  request: OpenApiChildRequestOptions;\n  onWarn?: (message: string) => void;\n}>;\n\ntype AppPackage = { name?: unknown; version?: unknown; description?: unknown };\n\nasync function readAppPackage(cwd: string): Promise<AppPackage> {\n  try {\n    return JSON.parse(await readFile(path.join(cwd, \"package.json\"), \"utf8\")) as AppPackage;\n  } catch {\n    return {};\n  }\n}\n\nfunction stringOr(value: unknown, fallback: string): string {\n  return typeof value === \"string\" && value.length > 0 ? value : fallback;\n}\n\n/**\n * `http://<host>:<port>` from the `http` config. A wildcard bind address is not a place a\n * client can call, so it becomes `localhost`.\n */\nexport function resolveDefaultServer(): string {\n  const host = stringOr(httpConfig(\"host\"), \"localhost\");\n  const port = httpConfig(\"port\");\n  const callable = host === \"0.0.0.0\" || host === \"::\" ? \"localhost\" : host;\n\n  return `http://${callable}${typeof port === \"number\" || typeof port === \"string\" ? `:${port}` : \"\"}`;\n}\n\n/**\n * Build the OpenAPI document from the routes registered in THIS process.\n *\n * Runs inside the registration child, after the app's route modules are loaded and config is\n * available. Maps resource classes to their export names, reads `info` from the app\n * `package.json`, the server from the `http` config and the 422 shape from\n * `validation.response`.\n */\nexport async function buildOpenApiForChild(\n  options: BuildOpenApiForChildOptions,\n): Promise<OpenApiBuildResult> {\n  const routes = router.list();\n  const declaresSchema = routes.some((route) => route.handler?.responseSchema);\n  const resourceMap = declaresSchema\n    ? await collectResourceExportMap(options.files, options.onWarn)\n    : undefined;\n  const pkg = await readAppPackage(options.cwd);\n  const validationResponse = config.get(\n    \"validation.response\",\n    {},\n  ) as OpenApiValidationResponseConfig;\n\n  return buildOpenApiDocument(routes, {\n    info: {\n      title: options.request.title ?? stringOr(pkg.name, \"Warlock API\"),\n      version: stringOr(pkg.version, \"0.0.0\"),\n      ...(typeof pkg.description === \"string\" && pkg.description\n        ? { description: pkg.description }\n        : {}),\n    },\n    servers: [options.request.server ?? resolveDefaultServer()],\n    includePages: options.request.includePages === true,\n    resolveResourceName: (resource) => resourceMap?.get(resource)?.exportName,\n    validationResponse,\n  });\n}\n"],"mappings":";;;;;;;;;AAwBA,eAAe,eAAe,KAAkC;CAC9D,IAAI;EACF,OAAO,KAAK,MAAM,MAAM,SAAS,KAAK,KAAK,KAAK,cAAc,GAAG,MAAM,CAAC;CAC1E,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,SAAS,OAAgB,UAA0B;CAC1D,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AACjE;;;;;AAMA,SAAgB,uBAA+B;CAC7C,MAAM,OAAO,SAAS,WAAW,MAAM,GAAG,WAAW;CACrD,MAAM,OAAO,WAAW,MAAM;CAG9B,OAAO,UAFU,SAAS,aAAa,SAAS,OAAO,cAAc,OAEzC,OAAO,SAAS,YAAY,OAAO,SAAS,WAAW,IAAI,SAAS;AAClG;;;;;;;;;AAUA,eAAsB,qBACpB,SAC6B;CAC7B,MAAM,SAAS,OAAO,KAAK;CAE3B,MAAM,cADiB,OAAO,MAAM,UAAU,MAAM,SAAS,cAC5B,IAC7B,MAAM,yBAAyB,QAAQ,OAAO,QAAQ,MAAM,IAC5D;CACJ,MAAM,MAAM,MAAM,eAAe,QAAQ,GAAG;CAC5C,MAAM,qBAAqB,OAAO,IAChC,uBACA,CAAC,CACH;CAEA,OAAO,qBAAqB,QAAQ;EAClC,MAAM;GACJ,OAAO,QAAQ,QAAQ,SAAS,SAAS,IAAI,MAAM,aAAa;GAChE,SAAS,SAAS,IAAI,SAAS,OAAO;GACtC,GAAI,OAAO,IAAI,gBAAgB,YAAY,IAAI,cAC3C,EAAE,aAAa,IAAI,YAAY,IAC/B,CAAC;EACP;EACA,SAAS,CAAC,QAAQ,QAAQ,UAAU,qBAAqB,CAAC;EAC1D,cAAc,QAAQ,QAAQ,iBAAiB;EAC/C,sBAAsB,aAAa,aAAa,IAAI,QAAQ,CAAC,EAAE;EAC/D;CACF,CAAC;AACH"}

package/esm/openapi/openapi-protocol.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/openapi/openapi-protocol.ts
+//#region ../../packages/core/src/openapi/openapi-protocol.ts
 /** Version of the OpenAPI mode of the registration child protocol. */
 const OPENAPI_PROTOCOL_VERSION = 1;
 /** `type` of the one message the child answers with in OpenAPI mode. */

package/esm/openapi/openapi-protocol.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-protocol.mjs","names":[],"sources":["../../../../../../../core/src/openapi/openapi-protocol.ts"],"sourcesContent":["import type { OpenApiDocument } from \"./types\";\n\n/** Version of the OpenAPI mode of the registration child protocol. */\nexport const OPENAPI_PROTOCOL_VERSION = 1;\n\n/** `type` of the one message the child answers with in OpenAPI mode. */\nexport const OPENAPI_RESULT_MESSAGE = \"openapi-registration:document\";\n\n/**\n * The `openapi` field of the registration child request. Its presence switches the child\n * from \"send the route snapshot\" to \"build the OpenAPI document in this process\".\n */\nexport type OpenApiChildRequestOptions = Readonly<{\n  version: typeof OPENAPI_PROTOCOL_VERSION;\n  /** Overrides `info.title` (default: the app `package.json` name). */\n  title?: string;\n  /** Overrides `servers[0].url` (default: built from the `http` config). */\n  server?: string;\n  includePages?: boolean;\n}>;\n\n/** What the child sends back: plain JSON only, never a Seal instance. */\nexport type OpenApiChildResult = Readonly<{\n  version: typeof OPENAPI_PROTOCOL_VERSION;\n  document: OpenApiDocument;\n  warnings: readonly string[];\n}>;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Validate the `openapi` request field inside the child. Throws on anything unexpected.\n */\nexport function parseOpenApiChildOptions(value: unknown): OpenApiChildRequestOptions {\n  if (\n    !isRecord(value) ||\n    value.version !== OPENAPI_PROTOCOL_VERSION ||\n    !(value.title === undefined || typeof value.title === \"string\") ||\n    !(value.server === undefined || typeof value.server === \"string\") ||\n    !(value.includePages === undefined || typeof value.includePages === \"boolean\")\n  ) {\n    throw new Error(\"Route registration child received an invalid OpenAPI request.\");\n  }\n\n  return value as OpenApiChildRequestOptions;\n}\n\n/**\n * Validate the result message in the parent. Throws on anything unexpected.\n */\nexport function parseOpenApiChildResult(value: unknown): OpenApiChildResult {\n  if (\n    !isRecord(value) ||\n    value.version !== OPENAPI_PROTOCOL_VERSION ||\n    !isRecord(value.document) ||\n    typeof value.document.openapi !== \"string\" ||\n    !isRecord(value.document.paths) ||\n    !Array.isArray(value.warnings) ||\n    !value.warnings.every((warning) => typeof warning === \"string\")\n  ) {\n    throw new Error(\"Route registration child sent an invalid OpenAPI document payload.\");\n  }\n\n  return Object.freeze({\n    version: OPENAPI_PROTOCOL_VERSION,\n    document: value.document as unknown as OpenApiDocument,\n    warnings: Object.freeze([...(value.warnings as string[])]),\n  });\n}\n"],"mappings":";;AAGA,MAAa,2BAA2B;;AAGxC,MAAa,yBAAyB;AAsBtC,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;AAKA,SAAgB,yBAAyB,OAA4C;CACnF,IACE,CAAC,SAAS,KAAK,KACf,MAAM,iBACN,EAAE,MAAM,UAAU,UAAa,OAAO,MAAM,UAAU,aACtD,EAAE,MAAM,WAAW,UAAa,OAAO,MAAM,WAAW,aACxD,EAAE,MAAM,iBAAiB,UAAa,OAAO,MAAM,iBAAiB,YAEpE,MAAM,IAAI,MAAM,+DAA+D;CAGjF,OAAO;AACT;;;;AAKA,SAAgB,wBAAwB,OAAoC;CAC1E,IACE,CAAC,SAAS,KAAK,KACf,MAAM,iBACN,CAAC,SAAS,MAAM,QAAQ,KACxB,OAAO,MAAM,SAAS,YAAY,YAClC,CAAC,SAAS,MAAM,SAAS,KAAK,KAC9B,CAAC,MAAM,QAAQ,MAAM,QAAQ,KAC7B,CAAC,MAAM,SAAS,OAAO,YAAY,OAAO,YAAY,QAAQ,GAE9D,MAAM,IAAI,MAAM,oEAAoE;CAGtF,OAAO,OAAO,OAAO;EACnB;EACA,UAAU,MAAM;EAChB,UAAU,OAAO,OAAO,CAAC,GAAI,MAAM,QAAqB,CAAC;CAC3D,CAAC;AACH"}
+{"version":3,"file":"openapi-protocol.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/openapi-protocol.ts"],"sourcesContent":["import type { OpenApiDocument } from \"./types\";\n\n/** Version of the OpenAPI mode of the registration child protocol. */\nexport const OPENAPI_PROTOCOL_VERSION = 1;\n\n/** `type` of the one message the child answers with in OpenAPI mode. */\nexport const OPENAPI_RESULT_MESSAGE = \"openapi-registration:document\";\n\n/**\n * The `openapi` field of the registration child request. Its presence switches the child\n * from \"send the route snapshot\" to \"build the OpenAPI document in this process\".\n */\nexport type OpenApiChildRequestOptions = Readonly<{\n  version: typeof OPENAPI_PROTOCOL_VERSION;\n  /** Overrides `info.title` (default: the app `package.json` name). */\n  title?: string;\n  /** Overrides `servers[0].url` (default: built from the `http` config). */\n  server?: string;\n  includePages?: boolean;\n}>;\n\n/** What the child sends back: plain JSON only, never a Seal instance. */\nexport type OpenApiChildResult = Readonly<{\n  version: typeof OPENAPI_PROTOCOL_VERSION;\n  document: OpenApiDocument;\n  warnings: readonly string[];\n}>;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Validate the `openapi` request field inside the child. Throws on anything unexpected.\n */\nexport function parseOpenApiChildOptions(value: unknown): OpenApiChildRequestOptions {\n  if (\n    !isRecord(value) ||\n    value.version !== OPENAPI_PROTOCOL_VERSION ||\n    !(value.title === undefined || typeof value.title === \"string\") ||\n    !(value.server === undefined || typeof value.server === \"string\") ||\n    !(value.includePages === undefined || typeof value.includePages === \"boolean\")\n  ) {\n    throw new Error(\"Route registration child received an invalid OpenAPI request.\");\n  }\n\n  return value as OpenApiChildRequestOptions;\n}\n\n/**\n * Validate the result message in the parent. Throws on anything unexpected.\n */\nexport function parseOpenApiChildResult(value: unknown): OpenApiChildResult {\n  if (\n    !isRecord(value) ||\n    value.version !== OPENAPI_PROTOCOL_VERSION ||\n    !isRecord(value.document) ||\n    typeof value.document.openapi !== \"string\" ||\n    !isRecord(value.document.paths) ||\n    !Array.isArray(value.warnings) ||\n    !value.warnings.every((warning) => typeof warning === \"string\")\n  ) {\n    throw new Error(\"Route registration child sent an invalid OpenAPI document payload.\");\n  }\n\n  return Object.freeze({\n    version: OPENAPI_PROTOCOL_VERSION,\n    document: value.document as unknown as OpenApiDocument,\n    warnings: Object.freeze([...(value.warnings as string[])]),\n  });\n}\n"],"mappings":";;AAGA,MAAa,2BAA2B;;AAGxC,MAAa,yBAAyB;AAsBtC,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;AAKA,SAAgB,yBAAyB,OAA4C;CACnF,IACE,CAAC,SAAS,KAAK,KACf,MAAM,iBACN,EAAE,MAAM,UAAU,UAAa,OAAO,MAAM,UAAU,aACtD,EAAE,MAAM,WAAW,UAAa,OAAO,MAAM,WAAW,aACxD,EAAE,MAAM,iBAAiB,UAAa,OAAO,MAAM,iBAAiB,YAEpE,MAAM,IAAI,MAAM,+DAA+D;CAGjF,OAAO;AACT;;;;AAKA,SAAgB,wBAAwB,OAAoC;CAC1E,IACE,CAAC,SAAS,KAAK,KACf,MAAM,iBACN,CAAC,SAAS,MAAM,QAAQ,KACxB,OAAO,MAAM,SAAS,YAAY,YAClC,CAAC,SAAS,MAAM,SAAS,KAAK,KAC9B,CAAC,MAAM,QAAQ,MAAM,QAAQ,KAC7B,CAAC,MAAM,SAAS,OAAO,YAAY,OAAO,YAAY,QAAQ,GAE9D,MAAM,IAAI,MAAM,oEAAoE;CAGtF,OAAO,OAAO,OAAO;EACnB;EACA,UAAU,MAAM;EAChB,UAAU,OAAO,OAAO,CAAC,GAAI,MAAM,QAAqB,CAAC;CAC3D,CAAC;AACH"}

package/esm/openapi/paths.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/openapi/paths.ts
+//#region ../../packages/core/src/openapi/paths.ts
 /**
 * The concrete verbs an `all` route expands into. Mirrors `ALL_METHODS` in the route registry.
 */

package/esm/openapi/paths.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../../../../../../core/src/openapi/paths.ts"],"sourcesContent":["import type { RequestMethod } from \"../router/types\";\n\n/**\n * The concrete verbs an `all` route expands into. Mirrors `ALL_METHODS` in the route registry.\n */\nconst ALL_METHODS = [\"get\", \"post\", \"put\", \"patch\", \"delete\", \"options\", \"head\"] as const;\n\nexport type OpenApiMethod = (typeof ALL_METHODS)[number];\n\nconst PATH_PARAM_PATTERN = /:([A-Za-z_][A-Za-z0-9_]*)(\\([^)]*\\))?/g;\n\n/**\n * Convert a Warlock path into an OpenAPI path template: `/users/:id` -> `/users/{id}`.\n * A Fastify-style regex suffix (`:id(\\d+)`) is dropped.\n */\nexport function toOpenApiPath(path: string): string {\n  return path.replace(PATH_PARAM_PATTERN, (_match, name: string) => `{${name}}`);\n}\n\n/**\n * Names of the path parameters of a Warlock path, in order of appearance.\n */\nexport function extractPathParamNames(path: string): string[] {\n  return [...path.matchAll(PATH_PARAM_PATTERN)].flatMap((match) => match[1] ?? []);\n}\n\n/**\n * Lowercase operation verbs of a route method; `all` expands to every verb.\n */\nexport function expandMethods(method: RequestMethod | string): OpenApiMethod[] {\n  const lowered = String(method).toLowerCase();\n\n  if (lowered === \"all\") {\n    return [...ALL_METHODS];\n  }\n\n  return (ALL_METHODS as readonly string[]).includes(lowered) ? [lowered as OpenApiMethod] : [];\n}\n\n/**\n * `operationId` for an operation. A named route keeps its name (with `.<verb>` appended when\n * an `all` route expands into several operations); an unnamed route gets a `method_path_slug`\n * id such as `get_users_id`.\n */\nexport function buildOperationId(\n  name: string | undefined,\n  method: OpenApiMethod,\n  path: string,\n  expanded: boolean,\n): string {\n  if (name) {\n    return expanded ? `${name}.${method}` : name;\n  }\n\n  const slug = path\n    .replace(PATH_PARAM_PATTERN, \"$1\")\n    .replace(/[^A-Za-z0-9]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  return slug ? `${method}_${slug}` : method;\n}\n\n/**\n * Tag of a route: its first static path segment (`/users/:id` -> `users`).\n */\nexport function firstSegmentTag(path: string): string | undefined {\n  const segment = path.split(\"/\").find((part) => part.length > 0);\n\n  if (!segment || segment.startsWith(\":\") || segment === \"*\") {\n    return undefined;\n  }\n\n  return segment;\n}\n\n/**\n * Verbs whose requests carry no body, so unscoped validation maps to query parameters.\n */\nexport function isBodylessMethod(method: OpenApiMethod): boolean {\n  return method === \"get\" || method === \"head\" || method === \"delete\" || method === \"options\";\n}\n"],"mappings":";;;;AAKA,MAAM,cAAc;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAW;AAAM;AAI/E,MAAM,qBAAqB;;;;;AAM3B,SAAgB,cAAc,MAAsB;CAClD,OAAO,KAAK,QAAQ,qBAAqB,QAAQ,SAAiB,IAAI,KAAK,EAAE;AAC/E;;;;AAKA,SAAgB,sBAAsB,MAAwB;CAC5D,OAAO,CAAC,GAAG,KAAK,SAAS,kBAAkB,CAAC,CAAC,CAAC,SAAS,UAAU,MAAM,MAAM,CAAC,CAAC;AACjF;;;;AAKA,SAAgB,cAAc,QAAiD;CAC7E,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,YAAY;CAE3C,IAAI,YAAY,OACd,OAAO,CAAC,GAAG,WAAW;CAGxB,OAAQ,YAAkC,SAAS,OAAO,IAAI,CAAC,OAAwB,IAAI,CAAC;AAC9F;;;;;;AAOA,SAAgB,iBACd,MACA,QACA,MACA,UACQ;CACR,IAAI,MACF,OAAO,WAAW,GAAG,KAAK,GAAG,WAAW;CAG1C,MAAM,OAAO,KACV,QAAQ,oBAAoB,IAAI,CAAC,CACjC,QAAQ,kBAAkB,GAAG,CAAC,CAC9B,QAAQ,YAAY,EAAE;CAEzB,OAAO,OAAO,GAAG,OAAO,GAAG,SAAS;AACtC;;;;AAKA,SAAgB,gBAAgB,MAAkC;CAChE,MAAM,UAAU,KAAK,MAAM,GAAG,CAAC,CAAC,MAAM,SAAS,KAAK,SAAS,CAAC;CAE9D,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,KAAK,YAAY,KACrD;CAGF,OAAO;AACT;;;;AAKA,SAAgB,iBAAiB,QAAgC;CAC/D,OAAO,WAAW,SAAS,WAAW,UAAU,WAAW,YAAY,WAAW;AACpF"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../../../../../../../packages/core/src/openapi/paths.ts"],"sourcesContent":["import type { RequestMethod } from \"../router/types\";\n\n/**\n * The concrete verbs an `all` route expands into. Mirrors `ALL_METHODS` in the route registry.\n */\nconst ALL_METHODS = [\"get\", \"post\", \"put\", \"patch\", \"delete\", \"options\", \"head\"] as const;\n\nexport type OpenApiMethod = (typeof ALL_METHODS)[number];\n\nconst PATH_PARAM_PATTERN = /:([A-Za-z_][A-Za-z0-9_]*)(\\([^)]*\\))?/g;\n\n/**\n * Convert a Warlock path into an OpenAPI path template: `/users/:id` -> `/users/{id}`.\n * A Fastify-style regex suffix (`:id(\\d+)`) is dropped.\n */\nexport function toOpenApiPath(path: string): string {\n  return path.replace(PATH_PARAM_PATTERN, (_match, name: string) => `{${name}}`);\n}\n\n/**\n * Names of the path parameters of a Warlock path, in order of appearance.\n */\nexport function extractPathParamNames(path: string): string[] {\n  return [...path.matchAll(PATH_PARAM_PATTERN)].flatMap((match) => match[1] ?? []);\n}\n\n/**\n * Lowercase operation verbs of a route method; `all` expands to every verb.\n */\nexport function expandMethods(method: RequestMethod | string): OpenApiMethod[] {\n  const lowered = String(method).toLowerCase();\n\n  if (lowered === \"all\") {\n    return [...ALL_METHODS];\n  }\n\n  return (ALL_METHODS as readonly string[]).includes(lowered) ? [lowered as OpenApiMethod] : [];\n}\n\n/**\n * `operationId` for an operation. A named route keeps its name (with `.<verb>` appended when\n * an `all` route expands into several operations); an unnamed route gets a `method_path_slug`\n * id such as `get_users_id`.\n */\nexport function buildOperationId(\n  name: string | undefined,\n  method: OpenApiMethod,\n  path: string,\n  expanded: boolean,\n): string {\n  if (name) {\n    return expanded ? `${name}.${method}` : name;\n  }\n\n  const slug = path\n    .replace(PATH_PARAM_PATTERN, \"$1\")\n    .replace(/[^A-Za-z0-9]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  return slug ? `${method}_${slug}` : method;\n}\n\n/**\n * Tag of a route: its first static path segment (`/users/:id` -> `users`).\n */\nexport function firstSegmentTag(path: string): string | undefined {\n  const segment = path.split(\"/\").find((part) => part.length > 0);\n\n  if (!segment || segment.startsWith(\":\") || segment === \"*\") {\n    return undefined;\n  }\n\n  return segment;\n}\n\n/**\n * Verbs whose requests carry no body, so unscoped validation maps to query parameters.\n */\nexport function isBodylessMethod(method: OpenApiMethod): boolean {\n  return method === \"get\" || method === \"head\" || method === \"delete\" || method === \"options\";\n}\n"],"mappings":";;;;AAKA,MAAM,cAAc;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAW;AAAM;AAI/E,MAAM,qBAAqB;;;;;AAM3B,SAAgB,cAAc,MAAsB;CAClD,OAAO,KAAK,QAAQ,qBAAqB,QAAQ,SAAiB,IAAI,KAAK,EAAE;AAC/E;;;;AAKA,SAAgB,sBAAsB,MAAwB;CAC5D,OAAO,CAAC,GAAG,KAAK,SAAS,kBAAkB,CAAC,CAAC,CAAC,SAAS,UAAU,MAAM,MAAM,CAAC,CAAC;AACjF;;;;AAKA,SAAgB,cAAc,QAAiD;CAC7E,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,YAAY;CAE3C,IAAI,YAAY,OACd,OAAO,CAAC,GAAG,WAAW;CAGxB,OAAQ,YAAkC,SAAS,OAAO,IAAI,CAAC,OAAwB,IAAI,CAAC;AAC9F;;;;;;AAOA,SAAgB,iBACd,MACA,QACA,MACA,UACQ;CACR,IAAI,MACF,OAAO,WAAW,GAAG,KAAK,GAAG,WAAW;CAG1C,MAAM,OAAO,KACV,QAAQ,oBAAoB,IAAI,CAAC,CACjC,QAAQ,kBAAkB,GAAG,CAAC,CAC9B,QAAQ,YAAY,EAAE;CAEzB,OAAO,OAAO,GAAG,OAAO,GAAG,SAAS;AACtC;;;;AAKA,SAAgB,gBAAgB,MAAkC;CAChE,MAAM,UAAU,KAAK,MAAM,GAAG,CAAC,CAAC,MAAM,SAAS,KAAK,SAAS,CAAC;CAE9D,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,KAAK,YAAY,KACrD;CAGF,OAAO;AACT;;;;AAKA,SAAgB,iBAAiB,QAAgC;CAC/D,OAAO,WAAW,SAAS,WAAW,UAAU,WAAW,YAAY,WAAW;AACpF"}

package/esm/openapi/postman/build-request-body.mjs

@@ -1,7 +1,7 @@
 import { isRecord, primaryType, resolveSchema } from "./schema-refs.mjs";
 import { exampleFromSchema } from "./example-from-schema.mjs";
 
-//#region ../core/src/openapi/postman/build-request-body.ts
+//#region ../../packages/core/src/openapi/postman/build-request-body.ts
 const MULTIPART = "multipart/form-data";
 const URL_ENCODED = "application/x-www-form-urlencoded";
 function isJsonContentType(contentType) {

package/esm/openapi/postman/build-request-body.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-body.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/build-request-body.ts"],"sourcesContent":["import type { OpenApiRequestBody, OpenApiSchema } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport type { PostmanBody, PostmanFormParam } from \"./postman-types\";\nimport { isRecord, primaryType, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nexport type RequestBodyParts = {\n  body: PostmanBody;\n  /** Set when the request needs an explicit `Content-Type` header; Postman adds the form ones itself. */\n  contentType?: string;\n};\n\nconst MULTIPART = \"multipart/form-data\";\nconst URL_ENCODED = \"application/x-www-form-urlencoded\";\n\nfunction isJsonContentType(contentType: string): boolean {\n  return contentType === \"application/json\" || contentType.endsWith(\"+json\");\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\nfunction isFileSchema(schema: OpenApiSchema, components: SchemaComponents): boolean {\n  const resolved = resolveSchema(schema, components);\n\n  if (resolved.format === \"binary\" || typeof resolved.contentMediaType === \"string\") {\n    return true;\n  }\n\n  return primaryType(resolved) === \"array\" && isRecord(resolved.items)\n    ? isFileSchema(resolved.items, components)\n    : false;\n}\n\nfunction formFields(schema: OpenApiSchema, components: SchemaComponents): PostmanFormParam[] {\n  const resolved = resolveSchema(schema, components);\n  const properties = isRecord(resolved.properties) ? resolved.properties : {};\n\n  return Object.entries(properties).flatMap(([key, property]): PostmanFormParam[] => {\n    if (!isRecord(property)) {\n      return [];\n    }\n\n    const description = typeof property.description === \"string\" ? { description: property.description } : {};\n\n    if (isFileSchema(property, components)) {\n      return [{ key, type: \"file\", src: [], ...description }];\n    }\n\n    return [{ key, value: stringifyValue(exampleFromSchema(property, components)), type: \"text\", ...description }];\n  });\n}\n\nfunction pickContentType(contentTypes: string[]): string | undefined {\n  return (\n    contentTypes.find(isJsonContentType) ??\n    contentTypes.find((contentType) => contentType === MULTIPART) ??\n    contentTypes.find((contentType) => contentType === URL_ENCODED) ??\n    contentTypes[0]\n  );\n}\n\n/**\n * The Postman body of an operation's request body: JSON becomes a raw JSON example, multipart\n * becomes `formdata` (binary properties as file rows), url-encoded becomes `urlencoded`.\n *\n * @returns `undefined` when the operation has no usable body.\n */\nexport function buildRequestBody(\n  requestBody: OpenApiRequestBody | undefined,\n  components: SchemaComponents,\n): RequestBodyParts | undefined {\n  if (!requestBody) {\n    return undefined;\n  }\n\n  const contentType = pickContentType(Object.keys(requestBody.content));\n  const schema = contentType !== undefined ? requestBody.content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return undefined;\n  }\n\n  if (contentType === MULTIPART) {\n    return { body: { mode: \"formdata\", formdata: formFields(schema, components) } };\n  }\n\n  if (contentType === URL_ENCODED) {\n    const urlencoded = formFields(schema, components).flatMap((field) =>\n      field.type === \"text\" ? [{ key: field.key, value: field.value, type: \"text\" as const }] : [],\n    );\n\n    return { body: { mode: \"urlencoded\", urlencoded } };\n  }\n\n  const example = exampleFromSchema(schema, components);\n\n  if (isJsonContentType(contentType)) {\n    return {\n      contentType,\n      body: {\n        mode: \"raw\",\n        raw: JSON.stringify(example, null, 2),\n        options: { raw: { language: \"json\" } },\n      },\n    };\n  }\n\n  return {\n    contentType,\n    body: {\n      mode: \"raw\",\n      raw: typeof example === \"string\" ? example : \"\",\n      options: { raw: { language: \"text\" } },\n    },\n  };\n}\n"],"mappings":";;;;AAWA,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,SAAS,kBAAkB,aAA8B;CACvD,OAAO,gBAAgB,sBAAsB,YAAY,SAAS,OAAO;AAC3E;AAEA,SAAS,eAAe,OAAwB;CAC9C,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,OAAO,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI,OAAO,KAAK;AACvF;AAEA,SAAS,aAAa,QAAuB,YAAuC;CAClF,MAAM,WAAW,cAAc,QAAQ,UAAU;CAEjD,IAAI,SAAS,WAAW,YAAY,OAAO,SAAS,qBAAqB,UACvE,OAAO;CAGT,OAAO,YAAY,QAAQ,MAAM,WAAW,SAAS,SAAS,KAAK,IAC/D,aAAa,SAAS,OAAO,UAAU,IACvC;AACN;AAEA,SAAS,WAAW,QAAuB,YAAkD;CAC3F,MAAM,WAAW,cAAc,QAAQ,UAAU;CACjD,MAAM,aAAa,SAAS,SAAS,UAAU,IAAI,SAAS,aAAa,CAAC;CAE1E,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,cAAkC;EACjF,IAAI,CAAC,SAAS,QAAQ,GACpB,OAAO,CAAC;EAGV,MAAM,cAAc,OAAO,SAAS,gBAAgB,WAAW,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;EAExG,IAAI,aAAa,UAAU,UAAU,GACnC,OAAO,CAAC;GAAE;GAAK,MAAM;GAAQ,KAAK,CAAC;GAAG,GAAG;EAAY,CAAC;EAGxD,OAAO,CAAC;GAAE;GAAK,OAAO,eAAe,kBAAkB,UAAU,UAAU,CAAC;GAAG,MAAM;GAAQ,GAAG;EAAY,CAAC;CAC/G,CAAC;AACH;AAEA,SAAS,gBAAgB,cAA4C;CACnE,OACE,aAAa,KAAK,iBAAiB,KACnC,aAAa,MAAM,gBAAgB,gBAAgB,SAAS,KAC5D,aAAa,MAAM,gBAAgB,gBAAgB,WAAW,KAC9D,aAAa;AAEjB;;;;;;;AAQA,SAAgB,iBACd,aACA,YAC8B;CAC9B,IAAI,CAAC,aACH;CAGF,MAAM,cAAc,gBAAgB,OAAO,KAAK,YAAY,OAAO,CAAC;CACpE,MAAM,SAAS,gBAAgB,SAAY,YAAY,QAAQ,YAAY,EAAE,SAAS;CAEtF,IAAI,gBAAgB,UAAa,WAAW,QAC1C;CAGF,IAAI,gBAAgB,WAClB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAY,UAAU,WAAW,QAAQ,UAAU;CAAE,EAAE;CAGhF,IAAI,gBAAgB,aAKlB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAc,YAJlB,WAAW,QAAQ,UAAU,CAAC,CAAC,SAAS,UACzD,MAAM,SAAS,SAAS,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,MAAM;EAAgB,CAAC,IAAI,CAAC,CAG/C;CAAE,EAAE;CAGpD,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAEpD,IAAI,kBAAkB,WAAW,GAC/B,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,KAAK,UAAU,SAAS,MAAM,CAAC;GACpC,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;CAGF,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,OAAO,YAAY,WAAW,UAAU;GAC7C,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;AACF"}
+{"version":3,"file":"build-request-body.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-request-body.ts"],"sourcesContent":["import type { OpenApiRequestBody, OpenApiSchema } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport type { PostmanBody, PostmanFormParam } from \"./postman-types\";\nimport { isRecord, primaryType, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nexport type RequestBodyParts = {\n  body: PostmanBody;\n  /** Set when the request needs an explicit `Content-Type` header; Postman adds the form ones itself. */\n  contentType?: string;\n};\n\nconst MULTIPART = \"multipart/form-data\";\nconst URL_ENCODED = \"application/x-www-form-urlencoded\";\n\nfunction isJsonContentType(contentType: string): boolean {\n  return contentType === \"application/json\" || contentType.endsWith(\"+json\");\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\nfunction isFileSchema(schema: OpenApiSchema, components: SchemaComponents): boolean {\n  const resolved = resolveSchema(schema, components);\n\n  if (resolved.format === \"binary\" || typeof resolved.contentMediaType === \"string\") {\n    return true;\n  }\n\n  return primaryType(resolved) === \"array\" && isRecord(resolved.items)\n    ? isFileSchema(resolved.items, components)\n    : false;\n}\n\nfunction formFields(schema: OpenApiSchema, components: SchemaComponents): PostmanFormParam[] {\n  const resolved = resolveSchema(schema, components);\n  const properties = isRecord(resolved.properties) ? resolved.properties : {};\n\n  return Object.entries(properties).flatMap(([key, property]): PostmanFormParam[] => {\n    if (!isRecord(property)) {\n      return [];\n    }\n\n    const description = typeof property.description === \"string\" ? { description: property.description } : {};\n\n    if (isFileSchema(property, components)) {\n      return [{ key, type: \"file\", src: [], ...description }];\n    }\n\n    return [{ key, value: stringifyValue(exampleFromSchema(property, components)), type: \"text\", ...description }];\n  });\n}\n\nfunction pickContentType(contentTypes: string[]): string | undefined {\n  return (\n    contentTypes.find(isJsonContentType) ??\n    contentTypes.find((contentType) => contentType === MULTIPART) ??\n    contentTypes.find((contentType) => contentType === URL_ENCODED) ??\n    contentTypes[0]\n  );\n}\n\n/**\n * The Postman body of an operation's request body: JSON becomes a raw JSON example, multipart\n * becomes `formdata` (binary properties as file rows), url-encoded becomes `urlencoded`.\n *\n * @returns `undefined` when the operation has no usable body.\n */\nexport function buildRequestBody(\n  requestBody: OpenApiRequestBody | undefined,\n  components: SchemaComponents,\n): RequestBodyParts | undefined {\n  if (!requestBody) {\n    return undefined;\n  }\n\n  const contentType = pickContentType(Object.keys(requestBody.content));\n  const schema = contentType !== undefined ? requestBody.content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return undefined;\n  }\n\n  if (contentType === MULTIPART) {\n    return { body: { mode: \"formdata\", formdata: formFields(schema, components) } };\n  }\n\n  if (contentType === URL_ENCODED) {\n    const urlencoded = formFields(schema, components).flatMap((field) =>\n      field.type === \"text\" ? [{ key: field.key, value: field.value, type: \"text\" as const }] : [],\n    );\n\n    return { body: { mode: \"urlencoded\", urlencoded } };\n  }\n\n  const example = exampleFromSchema(schema, components);\n\n  if (isJsonContentType(contentType)) {\n    return {\n      contentType,\n      body: {\n        mode: \"raw\",\n        raw: JSON.stringify(example, null, 2),\n        options: { raw: { language: \"json\" } },\n      },\n    };\n  }\n\n  return {\n    contentType,\n    body: {\n      mode: \"raw\",\n      raw: typeof example === \"string\" ? example : \"\",\n      options: { raw: { language: \"text\" } },\n    },\n  };\n}\n"],"mappings":";;;;AAWA,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,SAAS,kBAAkB,aAA8B;CACvD,OAAO,gBAAgB,sBAAsB,YAAY,SAAS,OAAO;AAC3E;AAEA,SAAS,eAAe,OAAwB;CAC9C,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,OAAO,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI,OAAO,KAAK;AACvF;AAEA,SAAS,aAAa,QAAuB,YAAuC;CAClF,MAAM,WAAW,cAAc,QAAQ,UAAU;CAEjD,IAAI,SAAS,WAAW,YAAY,OAAO,SAAS,qBAAqB,UACvE,OAAO;CAGT,OAAO,YAAY,QAAQ,MAAM,WAAW,SAAS,SAAS,KAAK,IAC/D,aAAa,SAAS,OAAO,UAAU,IACvC;AACN;AAEA,SAAS,WAAW,QAAuB,YAAkD;CAC3F,MAAM,WAAW,cAAc,QAAQ,UAAU;CACjD,MAAM,aAAa,SAAS,SAAS,UAAU,IAAI,SAAS,aAAa,CAAC;CAE1E,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,cAAkC;EACjF,IAAI,CAAC,SAAS,QAAQ,GACpB,OAAO,CAAC;EAGV,MAAM,cAAc,OAAO,SAAS,gBAAgB,WAAW,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;EAExG,IAAI,aAAa,UAAU,UAAU,GACnC,OAAO,CAAC;GAAE;GAAK,MAAM;GAAQ,KAAK,CAAC;GAAG,GAAG;EAAY,CAAC;EAGxD,OAAO,CAAC;GAAE;GAAK,OAAO,eAAe,kBAAkB,UAAU,UAAU,CAAC;GAAG,MAAM;GAAQ,GAAG;EAAY,CAAC;CAC/G,CAAC;AACH;AAEA,SAAS,gBAAgB,cAA4C;CACnE,OACE,aAAa,KAAK,iBAAiB,KACnC,aAAa,MAAM,gBAAgB,gBAAgB,SAAS,KAC5D,aAAa,MAAM,gBAAgB,gBAAgB,WAAW,KAC9D,aAAa;AAEjB;;;;;;;AAQA,SAAgB,iBACd,aACA,YAC8B;CAC9B,IAAI,CAAC,aACH;CAGF,MAAM,cAAc,gBAAgB,OAAO,KAAK,YAAY,OAAO,CAAC;CACpE,MAAM,SAAS,gBAAgB,SAAY,YAAY,QAAQ,YAAY,EAAE,SAAS;CAEtF,IAAI,gBAAgB,UAAa,WAAW,QAC1C;CAGF,IAAI,gBAAgB,WAClB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAY,UAAU,WAAW,QAAQ,UAAU;CAAE,EAAE;CAGhF,IAAI,gBAAgB,aAKlB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAc,YAJlB,WAAW,QAAQ,UAAU,CAAC,CAAC,SAAS,UACzD,MAAM,SAAS,SAAS,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,MAAM;EAAgB,CAAC,IAAI,CAAC,CAG/C;CAAE,EAAE;CAGpD,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAEpD,IAAI,kBAAkB,WAAW,GAC/B,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,KAAK,UAAU,SAAS,MAAM,CAAC;GACpC,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;CAGF,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,OAAO,YAAY,WAAW,UAAU;GAC7C,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;AACF"}

package/esm/openapi/postman/build-request-url.mjs

@@ -1,6 +1,6 @@
 import { isRecord, resolveSchema } from "./schema-refs.mjs";
 
-//#region ../core/src/openapi/postman/build-request-url.ts
+//#region ../../packages/core/src/openapi/postman/build-request-url.ts
 /** The Postman variable every request URL starts with. */
 const BASE_URL_HOST = "{{baseUrl}}";
 const PATH_TEMPLATE_PARAM = /\{([^}]+)\}/g;

package/esm/openapi/postman/build-request-url.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-request-url.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/build-request-url.ts"],"sourcesContent":["import type { OpenApiParameter, OpenApiSchema } from \"../types\";\nimport { isRecord, resolveSchema, type SchemaComponents } from \"./schema-refs\";\nimport type { PostmanHeader, PostmanQueryParam, PostmanUrl, PostmanVariable } from \"./postman-types\";\n\n/** The Postman variable every request URL starts with. */\nexport const BASE_URL_HOST = \"{{baseUrl}}\";\n\nconst PATH_TEMPLATE_PARAM = /\\{([^}]+)\\}/g;\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\n/**\n * Value a parameter starts with in Postman: its declared `example`, `default`, `const` or\n * first `enum` value, otherwise empty so the caller fills it in.\n */\nfunction parameterValue(schema: OpenApiSchema, components: SchemaComponents): string {\n  const resolved = resolveSchema(schema, components);\n\n  for (const key of [\"example\", \"default\", \"const\"]) {\n    if (key in resolved) {\n      return stringifyValue(resolved[key]);\n    }\n  }\n\n  if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {\n    return stringifyValue(resolved.enum[0]);\n  }\n\n  return \"\";\n}\n\nfunction withDescription<T extends object>(row: T, parameter: OpenApiParameter): T & { description?: string } {\n  return parameter.description ? { ...row, description: parameter.description } : row;\n}\n\nfunction queryRows(parameter: OpenApiParameter, components: SchemaComponents): PostmanQueryParam[] {\n  const disabled = parameter.required === true ? {} : { disabled: true as const };\n  const schema = resolveSchema(parameter.schema, components);\n\n  if (parameter.style === \"deepObject\" && isRecord(schema.properties)) {\n    return Object.entries(schema.properties).map(([property, propertySchema]) => ({\n      key: `${parameter.name}[${property}]`,\n      value: isRecord(propertySchema) ? parameterValue(propertySchema, components) : \"\",\n      ...disabled,\n    }));\n  }\n\n  return [\n    {\n      key: parameter.name,\n      value: parameterValue(parameter.schema, components),\n      ...(parameter.description ? { description: parameter.description } : {}),\n      ...disabled,\n    },\n  ];\n}\n\n/**\n * Header rows for the `header` parameters of an operation. Optional ones start disabled.\n */\nexport function buildHeaderParameters(\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanHeader[] {\n  return parameters\n    .filter((parameter) => parameter.in === \"header\")\n    .map((parameter) =>\n      withDescription(\n        {\n          key: parameter.name,\n          value: parameterValue(parameter.schema, components),\n          ...(parameter.required === true ? {} : { disabled: true as const }),\n        },\n        parameter,\n      ),\n    );\n}\n\n/**\n * The Postman URL of an operation: `{id}` templates become `:id` path variables, query\n * parameters become rows (optional ones disabled, so `raw` carries only the enabled ones).\n */\nexport function buildRequestUrl(\n  path: string,\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanUrl {\n  const segments = path\n    .split(\"/\")\n    .filter((segment) => segment.length > 0)\n    .map((segment) => segment.replace(PATH_TEMPLATE_PARAM, \":$1\"));\n\n  const variables: PostmanVariable[] = [...path.matchAll(PATH_TEMPLATE_PARAM)].flatMap((match) => {\n    const name = match[1];\n\n    if (name === undefined) {\n      return [];\n    }\n\n    const description = parameters.find((parameter) => parameter.in === \"path\" && parameter.name === name)\n      ?.description;\n\n    return [{ key: name, value: \"\", ...(description ? { description } : {}) }];\n  });\n\n  const query = parameters\n    .filter((parameter) => parameter.in === \"query\")\n    .flatMap((parameter) => queryRows(parameter, components));\n\n  const search = query\n    .filter((row) => row.disabled !== true)\n    .map((row) => `${row.key}=${row.value}`)\n    .join(\"&\");\n\n  return {\n    raw: `${BASE_URL_HOST}/${segments.join(\"/\")}${search ? `?${search}` : \"\"}`,\n    host: [BASE_URL_HOST],\n    path: segments,\n    ...(variables.length > 0 ? { variable: variables } : {}),\n    ...(query.length > 0 ? { query } : {}),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"build-request-url.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-request-url.ts"],"sourcesContent":["import type { OpenApiParameter, OpenApiSchema } from \"../types\";\nimport { isRecord, resolveSchema, type SchemaComponents } from \"./schema-refs\";\nimport type { PostmanHeader, PostmanQueryParam, PostmanUrl, PostmanVariable } from \"./postman-types\";\n\n/** The Postman variable every request URL starts with. */\nexport const BASE_URL_HOST = \"{{baseUrl}}\";\n\nconst PATH_TEMPLATE_PARAM = /\\{([^}]+)\\}/g;\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\n/**\n * Value a parameter starts with in Postman: its declared `example`, `default`, `const` or\n * first `enum` value, otherwise empty so the caller fills it in.\n */\nfunction parameterValue(schema: OpenApiSchema, components: SchemaComponents): string {\n  const resolved = resolveSchema(schema, components);\n\n  for (const key of [\"example\", \"default\", \"const\"]) {\n    if (key in resolved) {\n      return stringifyValue(resolved[key]);\n    }\n  }\n\n  if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {\n    return stringifyValue(resolved.enum[0]);\n  }\n\n  return \"\";\n}\n\nfunction withDescription<T extends object>(row: T, parameter: OpenApiParameter): T & { description?: string } {\n  return parameter.description ? { ...row, description: parameter.description } : row;\n}\n\nfunction queryRows(parameter: OpenApiParameter, components: SchemaComponents): PostmanQueryParam[] {\n  const disabled = parameter.required === true ? {} : { disabled: true as const };\n  const schema = resolveSchema(parameter.schema, components);\n\n  if (parameter.style === \"deepObject\" && isRecord(schema.properties)) {\n    return Object.entries(schema.properties).map(([property, propertySchema]) => ({\n      key: `${parameter.name}[${property}]`,\n      value: isRecord(propertySchema) ? parameterValue(propertySchema, components) : \"\",\n      ...disabled,\n    }));\n  }\n\n  return [\n    {\n      key: parameter.name,\n      value: parameterValue(parameter.schema, components),\n      ...(parameter.description ? { description: parameter.description } : {}),\n      ...disabled,\n    },\n  ];\n}\n\n/**\n * Header rows for the `header` parameters of an operation. Optional ones start disabled.\n */\nexport function buildHeaderParameters(\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanHeader[] {\n  return parameters\n    .filter((parameter) => parameter.in === \"header\")\n    .map((parameter) =>\n      withDescription(\n        {\n          key: parameter.name,\n          value: parameterValue(parameter.schema, components),\n          ...(parameter.required === true ? {} : { disabled: true as const }),\n        },\n        parameter,\n      ),\n    );\n}\n\n/**\n * The Postman URL of an operation: `{id}` templates become `:id` path variables, query\n * parameters become rows (optional ones disabled, so `raw` carries only the enabled ones).\n */\nexport function buildRequestUrl(\n  path: string,\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanUrl {\n  const segments = path\n    .split(\"/\")\n    .filter((segment) => segment.length > 0)\n    .map((segment) => segment.replace(PATH_TEMPLATE_PARAM, \":$1\"));\n\n  const variables: PostmanVariable[] = [...path.matchAll(PATH_TEMPLATE_PARAM)].flatMap((match) => {\n    const name = match[1];\n\n    if (name === undefined) {\n      return [];\n    }\n\n    const description = parameters.find((parameter) => parameter.in === \"path\" && parameter.name === name)\n      ?.description;\n\n    return [{ key: name, value: \"\", ...(description ? { description } : {}) }];\n  });\n\n  const query = parameters\n    .filter((parameter) => parameter.in === \"query\")\n    .flatMap((parameter) => queryRows(parameter, components));\n\n  const search = query\n    .filter((row) => row.disabled !== true)\n    .map((row) => `${row.key}=${row.value}`)\n    .join(\"&\");\n\n  return {\n    raw: `${BASE_URL_HOST}/${segments.join(\"/\")}${search ? `?${search}` : \"\"}`,\n    host: [BASE_URL_HOST],\n    path: segments,\n    ...(variables.length > 0 ? { variable: variables } : {}),\n    ...(query.length > 0 ? { query } : {}),\n  };\n}\n"],"mappings":"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"}

package/esm/openapi/postman/build-saved-responses.mjs

@@ -1,7 +1,7 @@
 import { exampleFromSchema } from "./example-from-schema.mjs";
 import { httpStatusText } from "./http-status-text.mjs";
 
-//#region ../core/src/openapi/postman/build-saved-responses.ts
+//#region ../../packages/core/src/openapi/postman/build-saved-responses.ts
 function previewLanguage(contentType) {
 	if (contentType === "application/json" || contentType.endsWith("+json")) return "json";
 	return contentType === "text/html" ? "html" : "text";

package/esm/openapi/postman/build-saved-responses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-saved-responses.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/build-saved-responses.ts"],"sourcesContent":["import type { OpenApiOperation } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport { httpStatusText } from \"./http-status-text\";\nimport type { PostmanHeader, PostmanOriginalRequest, PostmanResponse } from \"./postman-types\";\nimport type { SchemaComponents } from \"./schema-refs\";\n\ntype PreviewLanguage = PostmanResponse[\"_postman_previewlanguage\"];\n\nfunction previewLanguage(contentType: string): PreviewLanguage {\n  if (contentType === \"application/json\" || contentType.endsWith(\"+json\")) {\n    return \"json\";\n  }\n\n  return contentType === \"text/html\" ? \"html\" : \"text\";\n}\n\nfunction stringExample(example: unknown): string {\n  return typeof example === \"string\" ? example : \"\";\n}\n\nfunction responseBody(\n  content: NonNullable<OpenApiOperation[\"responses\"][string][\"content\"]>,\n  components: SchemaComponents,\n): { body: string; header: PostmanHeader[]; language: PreviewLanguage } {\n  const contentTypes = Object.keys(content);\n  const contentType = contentTypes.find((type) => previewLanguage(type) === \"json\") ?? contentTypes[0];\n  const schema = contentType !== undefined ? content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return { body: \"\", header: [], language: \"text\" };\n  }\n\n  const language = previewLanguage(contentType);\n  const example = exampleFromSchema(schema, components);\n  const body = language === \"json\" ? JSON.stringify(example, null, 2) : stringExample(example);\n\n  return { body, header: [{ key: \"Content-Type\", value: contentType, type: \"text\" }], language };\n}\n\n/**\n * One saved Postman response per declared numeric status, with an example body from the\n * response schema. `default` and range keys (`2XX`) have no single status code and are skipped.\n */\nexport function buildSavedResponses(\n  responses: OpenApiOperation[\"responses\"],\n  originalRequest: PostmanOriginalRequest,\n  components: SchemaComponents,\n): PostmanResponse[] {\n  return Object.entries(responses).flatMap(([status, response]): PostmanResponse[] => {\n    if (!/^\\d{3}$/.test(status)) {\n      return [];\n    }\n\n    const code = Number(status);\n    const { body, header, language } = response.content\n      ? responseBody(response.content, components)\n      : { body: \"\", header: [], language: \"text\" as const };\n\n    return [\n      {\n        name: `${status} ${response.description}`,\n        originalRequest,\n        status: httpStatusText(code, response.description),\n        code,\n        _postman_previewlanguage: language,\n        header,\n        body,\n      },\n    ];\n  });\n}\n"],"mappings":";;;;AAQA,SAAS,gBAAgB,aAAsC;CAC7D,IAAI,gBAAgB,sBAAsB,YAAY,SAAS,OAAO,GACpE,OAAO;CAGT,OAAO,gBAAgB,cAAc,SAAS;AAChD;AAEA,SAAS,cAAc,SAA0B;CAC/C,OAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,SAAS,aACP,SACA,YACsE;CACtE,MAAM,eAAe,OAAO,KAAK,OAAO;CACxC,MAAM,cAAc,aAAa,MAAM,SAAS,gBAAgB,IAAI,MAAM,MAAM,KAAK,aAAa;CAClG,MAAM,SAAS,gBAAgB,SAAY,QAAQ,YAAY,EAAE,SAAS;CAE1E,IAAI,gBAAgB,UAAa,WAAW,QAC1C,OAAO;EAAE,MAAM;EAAI,QAAQ,CAAC;EAAG,UAAU;CAAO;CAGlD,MAAM,WAAW,gBAAgB,WAAW;CAC5C,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAGpD,OAAO;EAAE,MAFI,aAAa,SAAS,KAAK,UAAU,SAAS,MAAM,CAAC,IAAI,cAAc,OAAO;EAE5E,QAAQ,CAAC;GAAE,KAAK;GAAgB,OAAO;GAAa,MAAM;EAAO,CAAC;EAAG;CAAS;AAC/F;;;;;AAMA,SAAgB,oBACd,WACA,iBACA,YACmB;CACnB,OAAO,OAAO,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,cAAiC;EAClF,IAAI,CAAC,UAAU,KAAK,MAAM,GACxB,OAAO,CAAC;EAGV,MAAM,OAAO,OAAO,MAAM;EAC1B,MAAM,EAAE,MAAM,QAAQ,aAAa,SAAS,UACxC,aAAa,SAAS,SAAS,UAAU,IACzC;GAAE,MAAM;GAAI,QAAQ,CAAC;GAAG,UAAU;EAAgB;EAEtD,OAAO,CACL;GACE,MAAM,GAAG,OAAO,GAAG,SAAS;GAC5B;GACA,QAAQ,eAAe,MAAM,SAAS,WAAW;GACjD;GACA,0BAA0B;GAC1B;GACA;EACF,CACF;CACF,CAAC;AACH"}
+{"version":3,"file":"build-saved-responses.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/build-saved-responses.ts"],"sourcesContent":["import type { OpenApiOperation } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport { httpStatusText } from \"./http-status-text\";\nimport type { PostmanHeader, PostmanOriginalRequest, PostmanResponse } from \"./postman-types\";\nimport type { SchemaComponents } from \"./schema-refs\";\n\ntype PreviewLanguage = PostmanResponse[\"_postman_previewlanguage\"];\n\nfunction previewLanguage(contentType: string): PreviewLanguage {\n  if (contentType === \"application/json\" || contentType.endsWith(\"+json\")) {\n    return \"json\";\n  }\n\n  return contentType === \"text/html\" ? \"html\" : \"text\";\n}\n\nfunction stringExample(example: unknown): string {\n  return typeof example === \"string\" ? example : \"\";\n}\n\nfunction responseBody(\n  content: NonNullable<OpenApiOperation[\"responses\"][string][\"content\"]>,\n  components: SchemaComponents,\n): { body: string; header: PostmanHeader[]; language: PreviewLanguage } {\n  const contentTypes = Object.keys(content);\n  const contentType = contentTypes.find((type) => previewLanguage(type) === \"json\") ?? contentTypes[0];\n  const schema = contentType !== undefined ? content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return { body: \"\", header: [], language: \"text\" };\n  }\n\n  const language = previewLanguage(contentType);\n  const example = exampleFromSchema(schema, components);\n  const body = language === \"json\" ? JSON.stringify(example, null, 2) : stringExample(example);\n\n  return { body, header: [{ key: \"Content-Type\", value: contentType, type: \"text\" }], language };\n}\n\n/**\n * One saved Postman response per declared numeric status, with an example body from the\n * response schema. `default` and range keys (`2XX`) have no single status code and are skipped.\n */\nexport function buildSavedResponses(\n  responses: OpenApiOperation[\"responses\"],\n  originalRequest: PostmanOriginalRequest,\n  components: SchemaComponents,\n): PostmanResponse[] {\n  return Object.entries(responses).flatMap(([status, response]): PostmanResponse[] => {\n    if (!/^\\d{3}$/.test(status)) {\n      return [];\n    }\n\n    const code = Number(status);\n    const { body, header, language } = response.content\n      ? responseBody(response.content, components)\n      : { body: \"\", header: [], language: \"text\" as const };\n\n    return [\n      {\n        name: `${status} ${response.description}`,\n        originalRequest,\n        status: httpStatusText(code, response.description),\n        code,\n        _postman_previewlanguage: language,\n        header,\n        body,\n      },\n    ];\n  });\n}\n"],"mappings":";;;;AAQA,SAAS,gBAAgB,aAAsC;CAC7D,IAAI,gBAAgB,sBAAsB,YAAY,SAAS,OAAO,GACpE,OAAO;CAGT,OAAO,gBAAgB,cAAc,SAAS;AAChD;AAEA,SAAS,cAAc,SAA0B;CAC/C,OAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,SAAS,aACP,SACA,YACsE;CACtE,MAAM,eAAe,OAAO,KAAK,OAAO;CACxC,MAAM,cAAc,aAAa,MAAM,SAAS,gBAAgB,IAAI,MAAM,MAAM,KAAK,aAAa;CAClG,MAAM,SAAS,gBAAgB,SAAY,QAAQ,YAAY,EAAE,SAAS;CAE1E,IAAI,gBAAgB,UAAa,WAAW,QAC1C,OAAO;EAAE,MAAM;EAAI,QAAQ,CAAC;EAAG,UAAU;CAAO;CAGlD,MAAM,WAAW,gBAAgB,WAAW;CAC5C,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAGpD,OAAO;EAAE,MAFI,aAAa,SAAS,KAAK,UAAU,SAAS,MAAM,CAAC,IAAI,cAAc,OAAO;EAE5E,QAAQ,CAAC;GAAE,KAAK;GAAgB,OAAO;GAAa,MAAM;EAAO,CAAC;EAAG;CAAS;AAC/F;;;;;AAMA,SAAgB,oBACd,WACA,iBACA,YACmB;CACnB,OAAO,OAAO,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,cAAiC;EAClF,IAAI,CAAC,UAAU,KAAK,MAAM,GACxB,OAAO,CAAC;EAGV,MAAM,OAAO,OAAO,MAAM;EAC1B,MAAM,EAAE,MAAM,QAAQ,aAAa,SAAS,UACxC,aAAa,SAAS,SAAS,UAAU,IACzC;GAAE,MAAM;GAAI,QAAQ,CAAC;GAAG,UAAU;EAAgB;EAEtD,OAAO,CACL;GACE,MAAM,GAAG,OAAO,GAAG,SAAS;GAC5B;GACA,QAAQ,eAAe,MAAM,SAAS,WAAW;GACjD;GACA,0BAA0B;GAC1B;GACA;EACF,CACF;CACF,CAAC;AACH"}

package/esm/openapi/postman/example-from-schema.d.mts

@@ -1,7 +1,7 @@
 import { OpenApiSchema } from "../types.mjs";
 import { SchemaComponents } from "./schema-refs.mjs";
 
-//#region ../core/src/openapi/postman/example-from-schema.d.ts
+//#region ../../packages/core/src/openapi/postman/example-from-schema.d.ts
 /**
  * A deterministic example value for a JSON Schema.
  *

package/esm/openapi/postman/example-from-schema.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"example-from-schema.d.mts","names":[],"sources":["../../../../../../../../core/src/openapi/postman/example-from-schema.ts"],"mappings":";;;;;;AAgJA;;;;;;;iBAAgB,iBAAA,CAAkB,MAAA,EAAQ,aAAA,EAAe,UAAA,GAAa,gBAAgB"}
+{"version":3,"file":"example-from-schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/openapi/postman/example-from-schema.ts"],"mappings":";;;;;;AAgJA;;;;;;;iBAAgB,iBAAA,CAAkB,MAAA,EAAQ,aAAA,EAAe,UAAA,GAAa,gBAAgB"}