@voxgig/apidef 8.13.0 → 8.15.0

package/src/transform/select.ts

@@ -39,7 +39,7 @@ const selectTransform: Transform = async function(
       each(mop.points, (mpoint: ModelPoint) => {
         // GraphQL defs have no `paths`; the lookup is only passed through to
         // an unused parameter, so skip it rather than dereference undefined.
-        const pdef: PathDef = def.paths?.[mpoint.orig]
+        const pdef: PathDef = def.paths?.[mpoint.o]
         resolveSelect(guide, ment, mop, mpoint, pdef)
       })
       if (null != mop.points && 0 < mop.points.length) {
@@ -61,8 +61,8 @@ function resolveSelect(
   mpoint: ModelPoint,
   _pdef: PathDef
 ) {
-  const select: any = mpoint.select
-  const margs: any = mpoint.args
+  const select: any = mpoint.q
+  const margs: any = mpoint.g
 
   const argkinds = ['params', 'query', 'header', 'cookie']
 
@@ -71,15 +71,15 @@ function resolveSelect(
   // after, filters) as params, and requiring those for selection would make
   // list() unusable without supplying every pagination argument. Only
   // required arguments identify a point.
-  const reqdonly = 'graphql' === (mpoint as any).kind
+  const reqdonly = 'graphql' === (mpoint as any).k
 
   argkinds.map((kind: string) => {
     each(margs[kind], (marg: ModelArg) => {
-      if (reqdonly && !marg.reqd) {
+      if (reqdonly && !marg.r) {
         return
       }
-      if (!select.exist.includes(marg.name)) {
-        select.exist.push(marg.name)
+      if (!select.exist.includes(marg.n)) {
+        select.exist.push(marg.n)
       }
     })
   })
@@ -88,7 +88,7 @@ function resolveSelect(
 
   const gent = guide.entity[ment.name]
   // REST guides key entries by path, GraphQL guides by root field.
-  const gpath = gent.path?.[mpoint.orig] ?? (gent as any).field?.[mpoint.orig]
+  const gpath = gent.path?.[mpoint.o] ?? (gent as any).field?.[mpoint.o]
 
   if (null == gpath) {
     return
@@ -113,16 +113,16 @@ function sortPoints(
   // Cache joined exist strings to avoid recomputing on every comparison.
   const existCache = new Map<ModelPoint, string>()
   for (const pt of mop.points) {
-    existCache.set(pt, pt.select.exist.join('\t'))
+    existCache.set(pt, pt.q.exist.join('\t'))
   }
 
   mop.points.sort((a: ModelPoint, b: ModelPoint) => {
     // longest exist len first
-    let order = b.select.exist.length - a.select.exist.length
+    let order = b.q.exist.length - a.q.exist.length
     if (0 === order) {
-      if (null != a.select.$action && null != b.select.$action) {
-        order = a.select.$action < b.select.$action ? -1 :
-          a.select.$action > b.select.$action ? 1 : 0
+      if (null != a.q.$action && null != b.q.$action) {
+        order = a.q.$action < b.q.$action ? -1 :
+          a.q.$action > b.q.$action ? 1 : 0
       }
 
       if (0 === order) {

package/src/transform/top.ts

@@ -40,7 +40,7 @@ const topTransform = async function(
   // Guarantee at least one sentence of API description. Many specs (e.g. the
   // readme.io-hosted Bluefin APIs) ship a placeholder `info.description` of
   // "." — letterless, useless prose. When the description is empty or has no
-  // letters, synthesise a sentence from the title so the api-info.aontu (and
+  // letters, synthesise a sentence from the title so the api-info.aon (and
   // the docs generated from it) never carry an empty/degenerate description.
   kit.info.description = ensureDescription(kit.info)
 

package/src/types.ts

@@ -298,7 +298,7 @@ type GuideRenameParam = {
 }
 
 type GuidePathOp = {
-  live?: Record<string, any>
+  live?: boolean | Record<string, any>
   contract?: Record<string, any>
   method: string
   // GraphQL root-field ops carry the operation type instead of relying on

package/src/utility.ts

@@ -1068,6 +1068,12 @@ function inferFieldType(name: string, specType: string): string {
 }
 
 
+function humanTitle(name: string): string {
+  return snakify(name).split('_').filter(Boolean)
+    .map(word => word[0].toUpperCase() + word.slice(1)).join(' ')
+}
+
+
 function normalizeFieldName(s: string): string {
   if (null == s || '' === s) return ''
   return s
@@ -1135,7 +1141,7 @@ const CMP_RESULT_VERBS = [
 
 const CMP_PREFIXES = ['get_', 'post_', 'put_', 'delete_', 'patch_']
 
-// A guide node (entity, path or op) is active unless guide.aontu explicitly
+// A guide node (entity, path or op) is active unless guide.aon explicitly
 // says otherwise. `active` has always been declared in the guide model and
 // documented as the escape hatch for a misclassified entity; this is the
 // single place that decides what it means, so entity/flow/operation transforms
@@ -1738,6 +1744,7 @@ export {
   ensureMinEntityName,
   inferFieldType,
   normalizeFieldName,
+  humanTitle,
   prefixLeadingDigit,
   debugpath,
   debugpathOn,