@warlock.js/core 5.27.0 → 5.29.0

package/esm/router/response-schema-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"response-schema-types.mjs","names":[],"sources":["../../../../../../../core/src/router/response-schema-types.ts"],"sourcesContent":["import { posix, relative, sep } from \"node:path\";\n\n/**\n * Where a resource class lives: the module it is exported from and the export name.\n */\nexport type ResourceModuleExport = Readonly<{\n  file: string;\n  exportName: string;\n}>;\n\n/**\n * Import location of a resource as it is written in a generated declaration file.\n * `importPath` has no extension and starts with `./` or `../`.\n */\nexport type ResourceTypeReference = Readonly<{\n  importPath: string;\n  exportName: string;\n}>;\n\n/**\n * Maps a response-schema resource value back to where it is exported from.\n * Returns `undefined` when the value is not a known resource export.\n */\nexport type ResourceTypeResolver = (value: unknown) => ResourceTypeReference | undefined;\n\n/**\n * A loaded module namespace together with the file it was imported from.\n */\nexport type ResourceModuleNamespace = Readonly<{\n  file: string;\n  namespace: Record<string, unknown>;\n}>;\n\n/**\n * Called with the dotted path of every field that could not be mapped\n * (for example `200.body.user`).\n */\nexport type UnmappedResourceHandler = (fieldPath: string) => void;\n\nconst CORE_PACKAGE = \"@warlock.js/core\";\n\nfunction isIndexFile(file: string): boolean {\n  return /(^|[\\\\/])index\\.[cm]?[jt]sx?$/.test(file);\n}\n\n/**\n * Build an identity map from every function export (resource classes) to the module\n * export it came from.\n *\n * When the same value is exported more than once (a barrel re-export, or a default next\n * to a named export) the most specific location wins: a non-`index.*` file beats an\n * `index.*` file, then a named export beats `default`, then the first one seen.\n */\nexport function buildResourceMap(\n  namespaces: readonly ResourceModuleNamespace[],\n): Map<unknown, ResourceModuleExport> {\n  const map = new Map<unknown, ResourceModuleExport>();\n\n  const rank = (location: ResourceModuleExport): number =>\n    (isIndexFile(location.file) ? 2 : 0) + (location.exportName === \"default\" ? 1 : 0);\n\n  for (const { file, namespace } of namespaces) {\n    for (const [exportName, value] of Object.entries(namespace)) {\n      if (typeof value !== \"function\") continue;\n\n      const candidate: ResourceModuleExport = { file, exportName };\n      const existing = map.get(value);\n\n      if (!existing || rank(candidate) < rank(existing)) {\n        map.set(value, candidate);\n      }\n    }\n  }\n\n  return map;\n}\n\n/**\n * Turn a resource map into a resolver whose import paths are relative to\n * `<appRoot>/.warlock/typings/`, the folder the generated declarations live in.\n */\nexport function createResourceTypeResolver(\n  map: ReadonlyMap<unknown, ResourceModuleExport>,\n  appRoot: string,\n): ResourceTypeResolver {\n  const typingsDirectory = `${appRoot}${sep}.warlock${sep}typings`;\n\n  return (value) => {\n    const location = map.get(value);\n\n    if (!location) return undefined;\n\n    let importPath = relative(typingsDirectory, location.file)\n      .split(sep)\n      .join(posix.sep)\n      .replace(/\\.[cm]?[jt]sx?$/, \"\");\n\n    if (!importPath.startsWith(\".\")) {\n      importPath = `./${importPath}`;\n    }\n\n    return { importPath, exportName: location.exportName };\n  };\n}\n\nfunction describeCast(cast: string): string {\n  return `import(${JSON.stringify(CORE_PACKAGE)}).CastOutput<${JSON.stringify(cast)}>`;\n}\n\nfunction describeResource(reference: ResourceTypeReference): string {\n  return (\n    `import(${JSON.stringify(CORE_PACKAGE)}).ResourceOutput<` +\n    `typeof import(${JSON.stringify(reference.importPath)})[${JSON.stringify(reference.exportName)}]>`\n  );\n}\n\nfunction describeBodyValue(\n  value: unknown,\n  path: string,\n  resolveResource: ResourceTypeResolver,\n  onUnmapped: UnmappedResourceHandler | undefined,\n): string {\n  if (typeof value === \"string\") {\n    return describeCast(value);\n  }\n\n  if (typeof value === \"function\") {\n    const reference = resolveResource(value);\n\n    if (!reference) {\n      onUnmapped?.(path);\n      return \"unknown\";\n    }\n\n    return describeResource(reference);\n  }\n\n  if (Array.isArray(value)) {\n    return `(${describeBodyValue(value[0], path, resolveResource, onUnmapped)})[]`;\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    const members = Object.entries(value).map(\n      ([key, member]) =>\n        `${JSON.stringify(key)}: ${describeBodyValue(member, `${path}.${key}`, resolveResource, onUnmapped)}`,\n    );\n\n    return members.length === 0 ? \"{}\" : `{ ${members.join(\"; \")} }`;\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Serialize a route's `responseSchema` into TypeScript type expressions, one per status code.\n *\n * The expressions are self-contained: they reference only `CastOutput` and `ResourceOutput`\n * from `@warlock.js/core`, `typeof import(...)` of resource modules, object literal types\n * and arrays. A resource that `resolveResource` cannot map becomes `unknown` and is\n * reported through `onUnmapped`.\n *\n * Both the typings child process and the dev server call this, so their output matches.\n *\n * @returns `undefined` when the schema declares no status code.\n *\n * @example\n * describeResponseSchemaTypes({ 400: { body: { error: \"string\" } } }, resolve);\n * // { \"400\": '{ \"error\": import(\"@warlock.js/core\").CastOutput<\"string\"> }' }\n */\nexport function describeResponseSchemaTypes(\n  schema: unknown,\n  resolveResource: ResourceTypeResolver,\n  onUnmapped?: UnmappedResourceHandler,\n): Record<string, string> | undefined {\n  if (typeof schema !== \"object\" || schema === null) return undefined;\n\n  const described: Record<string, string> = {};\n\n  for (const [status, entry] of Object.entries(schema)) {\n    if (typeof entry !== \"object\" || entry === null) continue;\n\n    const body = (entry as { body?: unknown }).body;\n\n    if (typeof body !== \"object\" || body === null) continue;\n\n    described[status] = describeBodyValue(body, `${status}.body`, resolveResource, onUnmapped);\n  }\n\n  return Object.keys(described).length === 0 ? undefined : described;\n}\n"],"mappings":";;;AAuCA,MAAM,eAAe;AAErB,SAAS,YAAY,MAAuB;CAC1C,OAAO,gCAAgC,KAAK,IAAI;AAClD;;;;;;;;;AAUA,SAAgB,iBACd,YACoC;CACpC,MAAM,sBAAM,IAAI,IAAmC;CAEnD,MAAM,QAAQ,cACX,YAAY,SAAS,IAAI,IAAI,IAAI,MAAM,SAAS,eAAe,YAAY,IAAI;CAElF,KAAK,MAAM,EAAE,MAAM,eAAe,YAChC,KAAK,MAAM,CAAC,YAAY,UAAU,OAAO,QAAQ,SAAS,GAAG;EAC3D,IAAI,OAAO,UAAU,YAAY;EAEjC,MAAM,YAAkC;GAAE;GAAM;EAAW;EAC3D,MAAM,WAAW,IAAI,IAAI,KAAK;EAE9B,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,QAAQ,GAC9C,IAAI,IAAI,OAAO,SAAS;CAE5B;CAGF,OAAO;AACT;;;;;AAMA,SAAgB,2BACd,KACA,SACsB;CACtB,MAAM,mBAAmB,GAAG,UAAU,IAAI,UAAU,IAAI;CAExD,QAAQ,UAAU;EAChB,MAAM,WAAW,IAAI,IAAI,KAAK;EAE9B,IAAI,CAAC,UAAU,OAAO;EAEtB,IAAI,aAAa,SAAS,kBAAkB,SAAS,IAAI,CAAC,CACvD,MAAM,GAAG,CAAC,CACV,KAAK,MAAM,GAAG,CAAC,CACf,QAAQ,mBAAmB,EAAE;EAEhC,IAAI,CAAC,WAAW,WAAW,GAAG,GAC5B,aAAa,KAAK;EAGpB,OAAO;GAAE;GAAY,YAAY,SAAS;EAAW;CACvD;AACF;AAEA,SAAS,aAAa,MAAsB;CAC1C,OAAO,UAAU,KAAK,UAAU,YAAY,EAAE,eAAe,KAAK,UAAU,IAAI,EAAE;AACpF;AAEA,SAAS,iBAAiB,WAA0C;CAClE,OACE,UAAU,KAAK,UAAU,YAAY,EAAE,iCACtB,KAAK,UAAU,UAAU,UAAU,EAAE,IAAI,KAAK,UAAU,UAAU,UAAU,EAAE;AAEnG;AAEA,SAAS,kBACP,OACA,MACA,iBACA,YACQ;CACR,IAAI,OAAO,UAAU,UACnB,OAAO,aAAa,KAAK;CAG3B,IAAI,OAAO,UAAU,YAAY;EAC/B,MAAM,YAAY,gBAAgB,KAAK;EAEvC,IAAI,CAAC,WAAW;GACd,aAAa,IAAI;GACjB,OAAO;EACT;EAEA,OAAO,iBAAiB,SAAS;CACnC;CAEA,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,IAAI,kBAAkB,MAAM,IAAI,MAAM,iBAAiB,UAAU,EAAE;CAG5E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAC/C,MAAM,UAAU,OAAO,QAAQ,KAAK,CAAC,CAAC,KACnC,CAAC,KAAK,YACL,GAAG,KAAK,UAAU,GAAG,EAAE,IAAI,kBAAkB,QAAQ,GAAG,KAAK,GAAG,OAAO,iBAAiB,UAAU,GACtG;EAEA,OAAO,QAAQ,WAAW,IAAI,OAAO,KAAK,QAAQ,KAAK,IAAI,EAAE;CAC/D;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;AAkBA,SAAgB,4BACd,QACA,iBACA,YACoC;CACpC,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO;CAE1D,MAAM,YAAoC,CAAC;CAE3C,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,MAAM,GAAG;EACpD,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAEjD,MAAM,OAAQ,MAA6B;EAE3C,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM;EAE/C,UAAU,UAAU,kBAAkB,MAAM,GAAG,OAAO,QAAQ,iBAAiB,UAAU;CAC3F;CAEA,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,WAAW,IAAI,SAAY;AAC3D"}
+{"version":3,"file":"response-schema-types.mjs","names":[],"sources":["../../../../../../../core/src/router/response-schema-types.ts"],"sourcesContent":["import { posix, relative, sep } from \"node:path\";\nimport { isNullableResource } from \"../resource/nullable-resource\";\n\n/**\n * Where a resource class lives: the module it is exported from and the export name.\n */\nexport type ResourceModuleExport = Readonly<{\n  file: string;\n  exportName: string;\n}>;\n\n/**\n * Import location of a resource as it is written in a generated declaration file.\n * `importPath` has no extension and starts with `./` or `../`.\n */\nexport type ResourceTypeReference = Readonly<{\n  importPath: string;\n  exportName: string;\n}>;\n\n/**\n * Maps a response-schema resource value back to where it is exported from.\n * Returns `undefined` when the value is not a known resource export.\n */\nexport type ResourceTypeResolver = (value: unknown) => ResourceTypeReference | undefined;\n\n/**\n * A loaded module namespace together with the file it was imported from.\n */\nexport type ResourceModuleNamespace = Readonly<{\n  file: string;\n  namespace: Record<string, unknown>;\n}>;\n\n/**\n * Called with the dotted path of every field that could not be mapped\n * (for example `200.body.user`).\n */\nexport type UnmappedResourceHandler = (fieldPath: string) => void;\n\nconst CORE_PACKAGE = \"@warlock.js/core\";\n\nfunction isIndexFile(file: string): boolean {\n  return /(^|[\\\\/])index\\.[cm]?[jt]sx?$/.test(file);\n}\n\n/**\n * Build an identity map from every function export (resource classes) to the module\n * export it came from.\n *\n * When the same value is exported more than once (a barrel re-export, or a default next\n * to a named export) the most specific location wins: a non-`index.*` file beats an\n * `index.*` file, then a named export beats `default`, then the first one seen.\n */\nexport function buildResourceMap(\n  namespaces: readonly ResourceModuleNamespace[],\n): Map<unknown, ResourceModuleExport> {\n  const map = new Map<unknown, ResourceModuleExport>();\n\n  const rank = (location: ResourceModuleExport): number =>\n    (isIndexFile(location.file) ? 2 : 0) + (location.exportName === \"default\" ? 1 : 0);\n\n  for (const { file, namespace } of namespaces) {\n    for (const [exportName, value] of Object.entries(namespace)) {\n      if (typeof value !== \"function\") continue;\n\n      const candidate: ResourceModuleExport = { file, exportName };\n      const existing = map.get(value);\n\n      if (!existing || rank(candidate) < rank(existing)) {\n        map.set(value, candidate);\n      }\n    }\n  }\n\n  return map;\n}\n\n/**\n * Turn a resource map into a resolver whose import paths are relative to\n * `<appRoot>/.warlock/typings/`, the folder the generated declarations live in.\n */\nexport function createResourceTypeResolver(\n  map: ReadonlyMap<unknown, ResourceModuleExport>,\n  appRoot: string,\n): ResourceTypeResolver {\n  const typingsDirectory = `${appRoot}${sep}.warlock${sep}typings`;\n\n  return (value) => {\n    const location = map.get(value);\n\n    if (!location) return undefined;\n\n    let importPath = relative(typingsDirectory, location.file)\n      .split(sep)\n      .join(posix.sep)\n      .replace(/\\.[cm]?[jt]sx?$/, \"\");\n\n    if (!importPath.startsWith(\".\")) {\n      importPath = `./${importPath}`;\n    }\n\n    return { importPath, exportName: location.exportName };\n  };\n}\n\nfunction describeCast(cast: string): string {\n  return `import(${JSON.stringify(CORE_PACKAGE)}).CastOutput<${JSON.stringify(cast)}>`;\n}\n\nfunction describeResource(reference: ResourceTypeReference): string {\n  return (\n    `import(${JSON.stringify(CORE_PACKAGE)}).ResourceOutput<` +\n    `typeof import(${JSON.stringify(reference.importPath)})[${JSON.stringify(reference.exportName)}]>`\n  );\n}\n\nfunction describeBodyValue(\n  value: unknown,\n  path: string,\n  resolveResource: ResourceTypeResolver,\n  onUnmapped: UnmappedResourceHandler | undefined,\n): string {\n  if (typeof value === \"string\") {\n    return describeCast(value);\n  }\n\n  if (isNullableResource(value)) {\n    return `(${describeBodyValue(value.resource, path, resolveResource, onUnmapped)}) | null`;\n  }\n\n  if (typeof value === \"function\") {\n    const reference = resolveResource(value);\n\n    if (!reference) {\n      onUnmapped?.(path);\n      return \"unknown\";\n    }\n\n    return describeResource(reference);\n  }\n\n  if (Array.isArray(value)) {\n    return `(${describeBodyValue(value[0], path, resolveResource, onUnmapped)})[]`;\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    const members = Object.entries(value).map(\n      ([key, member]) =>\n        `${JSON.stringify(key)}: ${describeBodyValue(member, `${path}.${key}`, resolveResource, onUnmapped)}`,\n    );\n\n    return members.length === 0 ? \"{}\" : `{ ${members.join(\"; \")} }`;\n  }\n\n  return \"unknown\";\n}\n\n/**\n * Serialize a route's `responseSchema` into TypeScript type expressions, one per status code.\n *\n * The expressions are self-contained: they reference only `CastOutput` and `ResourceOutput`\n * from `@warlock.js/core`, `typeof import(...)` of resource modules, object literal types\n * and arrays. A resource that `resolveResource` cannot map becomes `unknown` and is\n * reported through `onUnmapped`.\n *\n * Both the typings child process and the dev server call this, so their output matches.\n *\n * @returns `undefined` when the schema declares no status code.\n *\n * @example\n * describeResponseSchemaTypes({ 400: { body: { error: \"string\" } } }, resolve);\n * // { \"400\": '{ \"error\": import(\"@warlock.js/core\").CastOutput<\"string\"> }' }\n */\nexport function describeResponseSchemaTypes(\n  schema: unknown,\n  resolveResource: ResourceTypeResolver,\n  onUnmapped?: UnmappedResourceHandler,\n): Record<string, string> | undefined {\n  if (typeof schema !== \"object\" || schema === null) return undefined;\n\n  const described: Record<string, string> = {};\n\n  for (const [status, entry] of Object.entries(schema)) {\n    if (typeof entry !== \"object\" || entry === null) continue;\n\n    const body = (entry as { body?: unknown }).body;\n\n    if (typeof body !== \"object\" || body === null) continue;\n\n    described[status] = describeBodyValue(body, `${status}.body`, resolveResource, onUnmapped);\n  }\n\n  return Object.keys(described).length === 0 ? undefined : described;\n}\n"],"mappings":"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"}