@voxgig/apidef 6.3.2 → 6.3.5

package/dist/transform/top.d.ts

@@ -1,5 +1,8 @@
 import type { TransformResult } from '../transform';
 declare const topTransform: (ctx: any) => Promise<TransformResult>;
+declare function resolveSummary(def: any): string | undefined;
+declare function resolveWebsite(def: any, servers: any[]): string | undefined;
+declare function homepageFromServer(url: any): string | undefined;
 declare function resolveSecurity(def: any): Record<string, string> | null;
 declare function findAuthPrefix(text: unknown): string | null;
-export { topTransform, resolveSecurity, findAuthPrefix, };
+export { topTransform, resolveSecurity, resolveSummary, resolveWebsite, homepageFromServer, findAuthPrefix, };

package/dist/transform/top.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.topTransform = void 0;
 exports.resolveSecurity = resolveSecurity;
+exports.resolveSummary = resolveSummary;
+exports.resolveWebsite = resolveWebsite;
+exports.homepageFromServer = homepageFromServer;
 exports.findAuthPrefix = findAuthPrefix;
 const struct_1 = require("@voxgig/struct");
 const types_1 = require("../types");
@@ -79,9 +82,110 @@ const topTransform = async function (ctx) {
     if (null == firstServerUrl || '' === String(firstServerUrl).trim()) {
         throw new Error('apidef: no server URL found in API definition (servers[0].url is required).');
     }
+    // A short "what this API is" blurb and a canonical website link, for doc
+    // generators. Only set when derivable, so downstream can gate on them.
+    const summary = resolveSummary(def);
+    if (null != summary) {
+        kit.info.summary = summary;
+    }
+    const website = resolveWebsite(def, kit.info.servers);
+    if (null != website) {
+        kit.info.website = website;
+    }
     return { ok: true, msg: 'top' };
 };
 exports.topTransform = topTransform;
+// A short one-line description of the API's purpose: the spec's
+// `info.summary` (OpenAPI 3.1) when present, else the first prose sentence
+// of `info.description` with leading markdown headings/blank lines stripped
+// and the length capped. Returns undefined when no usable prose exists
+// (e.g. GitLab, whose top-level description is empty).
+function resolveSummary(def) {
+    const info = def?.info ?? {};
+    const explicit = 'string' === typeof info.summary ? info.summary.trim() : '';
+    if ('' !== explicit) {
+        return firstSentence(explicit);
+    }
+    const desc = 'string' === typeof info.description ? info.description : '';
+    if ('' === desc.trim()) {
+        return undefined;
+    }
+    const lines = desc.split('\n');
+    let i = 0;
+    // Skip leading blank lines, ATX headings (`# ...`) and setext underlines.
+    while (i < lines.length &&
+        ('' === lines[i].trim() ||
+            /^\s*#{1,6}\s/.test(lines[i]) ||
+            /^\s*(-{2,}|={2,})\s*$/.test(lines[i]))) {
+        i++;
+    }
+    // Take the first paragraph (up to the next blank line or heading).
+    const para = [];
+    while (i < lines.length &&
+        '' !== lines[i].trim() &&
+        !/^\s*#{1,6}\s/.test(lines[i])) {
+        para.push(lines[i].trim());
+        i++;
+    }
+    const paragraph = para.join(' ').trim();
+    return '' === paragraph ? undefined : firstSentence(paragraph);
+}
+// The first sentence of `text` (up to a `.`/`!`/`?` followed by whitespace
+// or end), whitespace-collapsed and length-capped with an ellipsis.
+function firstSentence(text) {
+    const collapsed = text.replace(/\s+/g, ' ').trim();
+    const m = collapsed.match(/^(.+?[.!?])(\s|$)/);
+    let out = m ? m[1] : collapsed;
+    const MAX = 240;
+    if (out.length > MAX) {
+        out = out.slice(0, MAX - 1).trimEnd() + '…';
+    }
+    return out;
+}
+// A canonical link back to the API's own website, in priority order:
+//   1. externalDocs.url          (the spec's explicit external link)
+//   2. info['x-logo'].href       (redoc homepage link)
+//   3. homepage from the server  (strip an api./developer./docs. subdomain)
+//   4. info.contact.url
+//   5. info.termsOfService
+function resolveWebsite(def, servers) {
+    const info = def?.info ?? {};
+    const ext = def?.externalDocs?.url;
+    if (isHttpUrl(ext))
+        return ext.trim();
+    const logoHref = info['x-logo']?.href;
+    if (isHttpUrl(logoHref))
+        return logoHref.trim();
+    const home = homepageFromServer(servers?.[0]?.url);
+    if (null != home)
+        return home;
+    if (isHttpUrl(info.contact?.url))
+        return info.contact.url.trim();
+    if (isHttpUrl(info.termsOfService))
+        return info.termsOfService.trim();
+    return undefined;
+}
+// Derive a homepage from an API server URL by dropping the path and an
+// `api.` / `developer.` / `docs.` / `www.` service subdomain — e.g.
+// `https://api.thesmsworks.co.uk/v1` -> `https://thesmsworks.co.uk`.
+function homepageFromServer(url) {
+    if ('string' !== typeof url || '' === url.trim())
+        return undefined;
+    try {
+        const u = new URL(url.includes('://') ? url : 'https://' + url);
+        let host = u.hostname;
+        if ('' === host || !host.includes('.'))
+            return undefined;
+        host = host.replace(/^(api|api-[a-z0-9]+|apis|developer|developers|docs?|www)\./i, '');
+        return u.protocol + '//' + host;
+    }
+    catch (_e) {
+        return undefined;
+    }
+}
+function isHttpUrl(v) {
+    return 'string' === typeof v && /^https?:\/\//i.test(v.trim());
+}
 // Describe the spec's PRIMARY security scheme as model facts
 // (info.security): scheme key, type, where the credential goes (in/name),
 // and the value prefix for Authorization-header credentials. The primary
@@ -92,8 +196,13 @@ exports.topTransform = topTransform;
 // Prefix rules:
 //   http basic/bearer      -> 'Basic' / 'Bearer'
 //   oauth2 / openIdConnect -> 'Bearer' (access token in Authorization)
-//   apiKey in an Authorization header -> the scheme the API's own prose
-//     documents (e.g. `Authorization: OAuth <key>`), else 'Bearer'
+//   apiKey in an Authorization header -> the prefix the API's own prose
+//     documents (e.g. `Authorization: OAuth <key>`), else '' (raw). An
+//     `apiKey` scheme means "send the credential as-is" — a `Bearer`/etc.
+//     prefix is only implied by an `http`+`bearer` scheme or explicit
+//     prose, so absent evidence the key goes in raw (e.g. The SMS Works'
+//     `Authorization: <jwt>`). A user override is available via
+//     config.auth.prefix.
 //   apiKey in any other header/query/cookie -> '' (raw credential)
 function resolveSecurity(def) {
     const schemes = def.components?.securitySchemes ?? def.securityDefinitions ?? {};
@@ -132,31 +241,61 @@ function resolveSecurity(def) {
     else if ('apikey' === type) {
         if ('header' === String(out.in).toLowerCase() &&
             'authorization' === String(out.name).toLowerCase()) {
+            // Only adopt a prefix the API's prose actually documents; otherwise
+            // the apiKey goes in raw (no assumed 'Bearer').
             out.prefix =
                 findAuthPrefix(scheme.description) ??
                     findAuthPrefix(def.info?.description) ??
-                    'Bearer';
+                    '';
         }
         // else: raw credential in a named header/query/cookie — no prefix.
     }
     return out;
 }
-// Extract the credential prefix from prose showing the Authorization
-// header format, e.g. `Authorization: OAuth 89a2...` or
-// `-H "Authorization: token <key>"`. The prefix must be a short word on
-// the SAME line, followed by something credential-shaped — a long token,
-// or a `<key>` / `{token}` / `$KEY` / `YOUR_...`-style placeholder. Bare
-// credentials (`Authorization: 89a2...`) and prose coincidences yield no
-// match.
+// Extract the credential prefix from a securityScheme's / info prose.
+// Three signals, in confidence order:
+//   1. An explicit `Authorization: <prefix> <cred>` line (any prefix word)
+//      — e.g. Statuspage's `Authorization: OAuth 89a2...`. The prefix must
+//      be a short word followed by something credential-shaped (a long
+//      token, or a `<key>` / `{token}` / `$KEY` / `YOUR_...` placeholder),
+//      so a bare `Authorization: 89a2...` doesn't match.
+//   2. A KNOWN scheme word (Bearer/OAuth/Token/Basic) shown as an example
+//      prefix — `Example: Bearer eyJ...` (NoFrixion's shape).
+//   3. A KNOWN scheme word named as the scheme — `the Bearer scheme`,
+//      `Bearer authentication`.
+// Returns null when nothing indicates a prefix (an apiKey then goes in raw).
 function findAuthPrefix(text) {
     if ('string' !== typeof text || '' === text) {
         return null;
     }
-    const m = text.match(/Authorization:[ \t]*([A-Za-z][A-Za-z0-9._-]{0,14})[ \t]+(?:<[^>\n]+>|\{[^}\n]+\}|\$[A-Za-z_][A-Za-z0-9_]*|[Yy][Oo][Uu][Rr][A-Za-z0-9_-]*|[A-Za-z0-9._~+/=-]{8,})/);
-    if (null == m) {
-        return null;
+    const explicit = text.match(/Authorization:[ \t]*([A-Za-z][A-Za-z0-9._-]{0,14})[ \t]+(?:<[^>\n]+>|\{[^}\n]+\}|\$[A-Za-z_][A-Za-z0-9_]*|[Yy][Oo][Uu][Rr][A-Za-z0-9_-]*|[A-Za-z0-9._~+/=-]{8,})/);
+    if (null != explicit) {
+        return explicit[1];
+    }
+    // A known scheme word as an example prefix, then a credential-shaped tail.
+    const example = text.match(/(?:example|e\.g\.)[:\s][^\n]{0,20}?\b(Bearer|OAuth2?|Token|Basic)\b[ \t]+(?:<[^>\n]+>|\{[^}\n]+\}|[A-Za-z0-9._~+/=-]{6,})/i);
+    if (null != example) {
+        return canonAuthScheme(example[1]);
     }
-    return m[1];
+    // A known scheme word named as the auth scheme.
+    const named = text.match(/\b(Bearer|OAuth2?|Token|Basic)\b[ \t]+(?:scheme|authentication|auth\b|credentials?)/i);
+    if (null != named) {
+        return canonAuthScheme(named[1]);
+    }
+    return null;
+}
+// Canonical casing for a known scheme word (Bearer/OAuth/Token/Basic).
+function canonAuthScheme(word) {
+    const w = word.toLowerCase();
+    if (w.startsWith('oauth'))
+        return 'OAuth';
+    if ('bearer' === w)
+        return 'Bearer';
+    if ('token' === w)
+        return 'Token';
+    if ('basic' === w)
+        return 'Basic';
+    return word;
 }
 // Does the spec declare any authentication? True if it defines security
 // schemes (OpenAPI 3 `components.securitySchemes` or Swagger 2

package/dist/transform/top.js.map

@@ -1 +1 @@
-{"version":3,"file":"top.js","sourceRoot":"","sources":["../../src/transform/top.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"top.js","sourceRoot":"","sources":["../../src/transform/top.ts"],"names":[],"mappings":"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"}

package/model/apidef.aontu

@@ -4,6 +4,20 @@ main: kit: info: {
   title?: string
   version?: string
 
+  # Short one-line description of the API's purpose, set by the top
+  # transform: the spec's `info.summary` when present, else the first
+  # prose sentence of `info.description` (leading markdown headings
+  # stripped, capped). Downstream doc generators surface it as the SDK's
+  # "what this API is" blurb. Unset when the spec offers no usable prose.
+  summary?: string
+
+  # Canonical link back to the API's own website, set by the top
+  # transform: `externalDocs.url`, else the redoc `x-logo.href`, else the
+  # homepage derived from the primary server host (stripping an `api.` /
+  # `developer.` / `docs.` subdomain), else `contact.url` / termsOfService.
+  # Doc generators link to it so readers can reach the source API.
+  website?: string
+
   # Set to false by the top transform when the spec declares no
   # authentication (no security schemes / security requirements). sdkgen's
   # isAuthActive() reads this to suppress apikey/auth code and docs. Left

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxgig/apidef",
-  "version": "6.3.2",
+  "version": "6.3.5",
   "main": "dist/apidef.js",
   "type": "commonjs",
   "types": "dist/apidef.d.ts",

package/src/transform/top.ts

@@ -105,10 +105,124 @@ const topTransform = async function(
     )
   }
 
+  // A short "what this API is" blurb and a canonical website link, for doc
+  // generators. Only set when derivable, so downstream can gate on them.
+  const summary = resolveSummary(def)
+  if (null != summary) {
+    kit.info.summary = summary
+  }
+  const website = resolveWebsite(def, kit.info.servers as any[])
+  if (null != website) {
+    kit.info.website = website
+  }
+
   return { ok: true, msg: 'top' }
 }
 
 
+// A short one-line description of the API's purpose: the spec's
+// `info.summary` (OpenAPI 3.1) when present, else the first prose sentence
+// of `info.description` with leading markdown headings/blank lines stripped
+// and the length capped. Returns undefined when no usable prose exists
+// (e.g. GitLab, whose top-level description is empty).
+function resolveSummary(def: any): string | undefined {
+  const info = def?.info ?? {}
+
+  const explicit = 'string' === typeof info.summary ? info.summary.trim() : ''
+  if ('' !== explicit) {
+    return firstSentence(explicit)
+  }
+
+  const desc = 'string' === typeof info.description ? info.description : ''
+  if ('' === desc.trim()) {
+    return undefined
+  }
+
+  const lines = desc.split('\n')
+  let i = 0
+  // Skip leading blank lines, ATX headings (`# ...`) and setext underlines.
+  while (i < lines.length &&
+    ('' === lines[i].trim() ||
+      /^\s*#{1,6}\s/.test(lines[i]) ||
+      /^\s*(-{2,}|={2,})\s*$/.test(lines[i]))) {
+    i++
+  }
+  // Take the first paragraph (up to the next blank line or heading).
+  const para: string[] = []
+  while (i < lines.length &&
+    '' !== lines[i].trim() &&
+    !/^\s*#{1,6}\s/.test(lines[i])) {
+    para.push(lines[i].trim())
+    i++
+  }
+  const paragraph = para.join(' ').trim()
+  return '' === paragraph ? undefined : firstSentence(paragraph)
+}
+
+
+// The first sentence of `text` (up to a `.`/`!`/`?` followed by whitespace
+// or end), whitespace-collapsed and length-capped with an ellipsis.
+function firstSentence(text: string): string {
+  const collapsed = text.replace(/\s+/g, ' ').trim()
+  const m = collapsed.match(/^(.+?[.!?])(\s|$)/)
+  let out = m ? m[1] : collapsed
+  const MAX = 240
+  if (out.length > MAX) {
+    out = out.slice(0, MAX - 1).trimEnd() + '…'
+  }
+  return out
+}
+
+
+// A canonical link back to the API's own website, in priority order:
+//   1. externalDocs.url          (the spec's explicit external link)
+//   2. info['x-logo'].href       (redoc homepage link)
+//   3. homepage from the server  (strip an api./developer./docs. subdomain)
+//   4. info.contact.url
+//   5. info.termsOfService
+function resolveWebsite(def: any, servers: any[]): string | undefined {
+  const info = def?.info ?? {}
+
+  const ext = def?.externalDocs?.url
+  if (isHttpUrl(ext)) return ext.trim()
+
+  const logoHref = info['x-logo']?.href
+  if (isHttpUrl(logoHref)) return logoHref.trim()
+
+  const home = homepageFromServer(servers?.[0]?.url)
+  if (null != home) return home
+
+  if (isHttpUrl(info.contact?.url)) return info.contact.url.trim()
+  if (isHttpUrl(info.termsOfService)) return info.termsOfService.trim()
+
+  return undefined
+}
+
+
+// Derive a homepage from an API server URL by dropping the path and an
+// `api.` / `developer.` / `docs.` / `www.` service subdomain — e.g.
+// `https://api.thesmsworks.co.uk/v1` -> `https://thesmsworks.co.uk`.
+function homepageFromServer(url: any): string | undefined {
+  if ('string' !== typeof url || '' === url.trim()) return undefined
+  try {
+    const u = new URL(url.includes('://') ? url : 'https://' + url)
+    let host = u.hostname
+    if ('' === host || !host.includes('.')) return undefined
+    host = host.replace(
+      /^(api|api-[a-z0-9]+|apis|developer|developers|docs?|www)\./i, '')
+    return u.protocol + '//' + host
+  }
+  catch (_e) {
+    return undefined
+  }
+}
+
+
+function isHttpUrl(v: any): boolean {
+  return 'string' === typeof v && /^https?:\/\//i.test(v.trim())
+}
+
+
 // Describe the spec's PRIMARY security scheme as model facts
 // (info.security): scheme key, type, where the credential goes (in/name),
 // and the value prefix for Authorization-header credentials. The primary
@@ -119,8 +233,13 @@ const topTransform = async function(
 // Prefix rules:
 //   http basic/bearer      -> 'Basic' / 'Bearer'
 //   oauth2 / openIdConnect -> 'Bearer' (access token in Authorization)
-//   apiKey in an Authorization header -> the scheme the API's own prose
-//     documents (e.g. `Authorization: OAuth <key>`), else 'Bearer'
+//   apiKey in an Authorization header -> the prefix the API's own prose
+//     documents (e.g. `Authorization: OAuth <key>`), else '' (raw). An
+//     `apiKey` scheme means "send the credential as-is" — a `Bearer`/etc.
+//     prefix is only implied by an `http`+`bearer` scheme or explicit
+//     prose, so absent evidence the key goes in raw (e.g. The SMS Works'
+//     `Authorization: <jwt>`). A user override is available via
+//     config.auth.prefix.
 //   apiKey in any other header/query/cookie -> '' (raw credential)
 function resolveSecurity(def: any): Record<string, string> | null {
   const schemes: Record<string, any> =
@@ -167,10 +286,12 @@ function resolveSecurity(def: any): Record<string, string> | null {
   else if ('apikey' === type) {
     if ('header' === String(out.in).toLowerCase() &&
       'authorization' === String(out.name).toLowerCase()) {
+      // Only adopt a prefix the API's prose actually documents; otherwise
+      // the apiKey goes in raw (no assumed 'Bearer').
       out.prefix =
         findAuthPrefix(scheme.description) ??
         findAuthPrefix(def.info?.description) ??
-        'Bearer'
+        ''
     }
     // else: raw credential in a named header/query/cookie — no prefix.
   }
@@ -179,23 +300,55 @@ function resolveSecurity(def: any): Record<string, string> | null {
 }
 
 
-// Extract the credential prefix from prose showing the Authorization
-// header format, e.g. `Authorization: OAuth 89a2...` or
-// `-H "Authorization: token <key>"`. The prefix must be a short word on
-// the SAME line, followed by something credential-shaped — a long token,
-// or a `<key>` / `{token}` / `$KEY` / `YOUR_...`-style placeholder. Bare
-// credentials (`Authorization: 89a2...`) and prose coincidences yield no
-// match.
+// Extract the credential prefix from a securityScheme's / info prose.
+// Three signals, in confidence order:
+//   1. An explicit `Authorization: <prefix> <cred>` line (any prefix word)
+//      — e.g. Statuspage's `Authorization: OAuth 89a2...`. The prefix must
+//      be a short word followed by something credential-shaped (a long
+//      token, or a `<key>` / `{token}` / `$KEY` / `YOUR_...` placeholder),
+//      so a bare `Authorization: 89a2...` doesn't match.
+//   2. A KNOWN scheme word (Bearer/OAuth/Token/Basic) shown as an example
+//      prefix — `Example: Bearer eyJ...` (NoFrixion's shape).
+//   3. A KNOWN scheme word named as the scheme — `the Bearer scheme`,
+//      `Bearer authentication`.
+// Returns null when nothing indicates a prefix (an apiKey then goes in raw).
 function findAuthPrefix(text: unknown): string | null {
   if ('string' !== typeof text || '' === text) {
     return null
   }
-  const m = text.match(
+
+  const explicit = text.match(
     /Authorization:[ \t]*([A-Za-z][A-Za-z0-9._-]{0,14})[ \t]+(?:<[^>\n]+>|\{[^}\n]+\}|\$[A-Za-z_][A-Za-z0-9_]*|[Yy][Oo][Uu][Rr][A-Za-z0-9_-]*|[A-Za-z0-9._~+/=-]{8,})/)
-  if (null == m) {
-    return null
+  if (null != explicit) {
+    return explicit[1]
   }
-  return m[1]
+
+  // A known scheme word as an example prefix, then a credential-shaped tail.
+  const example = text.match(
+    /(?:example|e\.g\.)[:\s][^\n]{0,20}?\b(Bearer|OAuth2?|Token|Basic)\b[ \t]+(?:<[^>\n]+>|\{[^}\n]+\}|[A-Za-z0-9._~+/=-]{6,})/i)
+  if (null != example) {
+    return canonAuthScheme(example[1])
+  }
+
+  // A known scheme word named as the auth scheme.
+  const named = text.match(
+    /\b(Bearer|OAuth2?|Token|Basic)\b[ \t]+(?:scheme|authentication|auth\b|credentials?)/i)
+  if (null != named) {
+    return canonAuthScheme(named[1])
+  }
+
+  return null
+}
+
+
+// Canonical casing for a known scheme word (Bearer/OAuth/Token/Basic).
+function canonAuthScheme(word: string): string {
+  const w = word.toLowerCase()
+  if (w.startsWith('oauth')) return 'OAuth'
+  if ('bearer' === w) return 'Bearer'
+  if ('token' === w) return 'Token'
+  if ('basic' === w) return 'Basic'
+  return word
 }
 
 
@@ -264,6 +417,9 @@ function stringifyInfoScalars(node: any): any {
 export {
   topTransform,
   resolveSecurity,
+  resolveSummary,
+  resolveWebsite,
+  homepageFromServer,
   findAuthPrefix,
 }