@voxgig/sdkgen 4.33.0 → 4.34.1

package/project/.sdk/src/cmp/lua/PrepareAuth_lua.ts

@@ -83,8 +83,20 @@ return prepare_auth_util
 
   return head + `
 local vs = require("utility.struct.struct")
-
-` + consts + (basic ? BASE64 : '') + ('cookie' === where ? COOKIE_SET : '') + `
+` + ('cookie' === where ? `local helpers = require("core.helpers")
+` : '') + `
+` + consts + `
+
+-- The client's auth.name option, when set, replaces the name the API declares.
+local function auth_name(options)
+  local name = vs.getpath(options, "auth.name")
+  if type(name) == "string" and name ~= "" then${'header' === where ? `
+    -- ASCII rules, as a field name is ASCII: lower-casing in the string library follows the C locale.` : ''}
+    return ${'header' === where ? FOLD : 'name'}
+  end
+  return ${CRED}
+end
+` + (basic ? BASE64 : '') + ('cookie' === where ? COOKIE_SET : '') + `
 local function prepare_auth_util(ctx)
   local spec = ctx.spec
   if spec == nil then
@@ -96,16 +108,23 @@ ${bag(where)}  local options = ctx.client:options_map()
 
   -- Public APIs that need no auth omit the options.auth block entirely.
   if options.auth == nil then
-${clear(where, 4)}
+${clear(where, CRED, 4)}
     return spec, nil
   end
 
+  local name = auth_name(options)
+
+  -- A credential left under the declared name would travel beside the renamed one.
+  if name ~= ${CRED} then
+${clear(where, CRED, 4)}
+  end
+
   local apikey = vs.getprop(options, OPTION_APIKEY, NOT_FOUND)
 ` + (basic ? BASIC : '') + `
   if apikey == nil
     or (type(apikey) == "string" and (apikey == NOT_FOUND or apikey == ""))
   then
-${clear(where, 4)}
+${clear(where, 'name', 4)}
   else
 ${place(where)}
   end
@@ -118,6 +137,9 @@ return prepare_auth_util
 }
 
 
+const FOLD = '(string.gsub(name, "[A-Z]", function(c) return string.char(c:byte() + 32) end))'
+
+
 function credConst(where: string): string {
   return 'query' === where ? 'QUERY_AUTH' :
     'cookie' === where ? 'COOKIE_AUTH' : 'HEADER_AUTH'
@@ -133,18 +155,20 @@ function bag(where: string): string {
 }
 
 
-function clear(where: string, indent: number): string {
+// A cookie has no header of its own: place() writes it into `cookie` as
+// `name=value`, so clear() frees that pair, not a header of that name.
+function clear(where: string, name: string, indent: number): string {
   const pad = ' '.repeat(indent)
 
   if ('query' === where) {
-    return pad + 'query[QUERY_AUTH] = nil'
+    return pad + `query[${name}] = nil`
   }
 
   if ('cookie' === where) {
-    return pad + 'cookie_set(headers, nil)'
+    return pad + `cookie_set(headers, ${name}, nil)`
   }
 
-  return pad + 'headers[HEADER_AUTH] = nil'
+  return pad + `headers[${name}] = nil`
 }
 
 
@@ -157,7 +181,7 @@ function place(where: string): string {
     if type(apikey) == "string" then
       apikey_val = apikey
     end
-    query[QUERY_AUTH] = apikey_val`
+    query[name] = apikey_val`
   }
 
   if ('cookie' === where) {
@@ -167,7 +191,7 @@ function place(where: string): string {
     end
     -- The prefix is a header-value convention and has no meaning in a
     -- cookie pair, so it is dropped the way a query placement drops it.
-    cookie_set(headers, apikey_val)`
+    cookie_set(headers, name, apikey_val)`
   }
 
   return `    local auth_prefix = ""
@@ -181,9 +205,9 @@ function place(where: string): string {
     end
     -- Empty prefix (raw apiKey credential) must not add a leading space.
     if auth_prefix == "" then
-      headers[HEADER_AUTH] = apikey_val
+      headers[name] = apikey_val
     else
-      headers[HEADER_AUTH] = auth_prefix .. " " .. apikey_val
+      headers[name] = auth_prefix .. " " .. apikey_val
     end`
 }
 
@@ -203,7 +227,7 @@ const BASIC = `
     if apikey == nil
       or (type(apikey) == "string" and (apikey == NOT_FOUND or apikey == ""))
     then
-      headers[HEADER_AUTH] = nil
+      headers[name] = nil
     else
       local auth_prefix = ""
       local ap = vs.getpath(options, "auth.prefix")
@@ -215,9 +239,9 @@ const BASIC = `
       -- registration covers.
       ctx.utility.clean_add(ctx, joined)
       if auth_prefix == "" then
-        headers[HEADER_AUTH] = joined
+        headers[name] = joined
       else
-        headers[HEADER_AUTH] = auth_prefix .. " " .. joined
+        headers[name] = auth_prefix .. " " .. joined
       end
     end
 
@@ -273,21 +297,16 @@ end
 
 
 const COOKIE_SET = `
-local function cookie_set(headers, value)
+local function cookie_set(headers, name, value)
   local kept = {}
   local existing = headers[HEADER_COOKIE]
 
   if type(existing) == "string" then
-    for pair in string.gmatch(existing, "[^;]+") do
-      local one = string.match(pair, "^%s*(.-)%s*$")
-      if one ~= "" and string.match(one, "^[^=]*") ~= COOKIE_AUTH then
-        kept[#kept + 1] = one
-      end
-    end
+    kept = helpers.cookie_keep(existing, { [name] = true })
   end
 
   if value ~= nil then
-    kept[#kept + 1] = COOKIE_AUTH .. "=" .. value
+    kept[#kept + 1] = name .. "=" .. value
   end
 
   if #kept == 0 then

package/project/.sdk/src/cmp/lua/ReadmeEntity_lua.ts

@@ -1,5 +1,5 @@
 
-import { cmp, each, Content, canonToType, canonKey, canonScalarKey, entityIdField, opRequestShape, safeVarName, exampleVarName, luaKey } from '@voxgig/sdkgen'
+import { cmp, each, Content, canonToType, canonKey, canonScalarKey, entityIdField, opRequestShape, safeVarName, exampleVarName, luaKey, opNeedsAction } from '@voxgig/sdkgen'
 
 import {
   KIT,
@@ -26,6 +26,7 @@ const OP_DESC: Record<string, { method: string, desc: string }> = {
   list:   { method: 'list(match)',   desc: 'List entities matching the criteria.' },
   create: { method: 'create(data)',  desc: 'Create a new entity with the given data.' },
   update: { method: 'update(data)',  desc: 'Update an existing entity.' },
+  patch:  { method: 'patch(data)',   desc: 'Change part of an existing entity.' },
   remove: { method: 'remove(match)', desc: 'Remove the matching entity.' },
 }
 
@@ -51,6 +52,8 @@ const ReadmeEntity = cmp(function ReadmeEntity(props: any) {
 
   publishedEntities.map((entity: any) => {
     const opnames = Object.keys(entity.op || {})
+    // An op that needs an action has no plain call to show.
+    const callable = opnames.filter((o: string) => !opNeedsAction(entity.op[o]))
     const fields = Object.values(entity.fields || {})
     const idF = entityIdField(entity)
     // Sanitise the local variable name — an entity whose lowercased name is a
@@ -107,7 +110,7 @@ const ReadmeEntity = cmp(function ReadmeEntity(props: any) {
 `)
     }
 
-    if (opnames.includes('load')) {
+    if (callable.includes('load')) {
       const loadItems = opRequestShape(entity, 'load').items
         .filter((it: any) => !it.optional || it.name === idF)
         .sort((a: any, b: any) =>
@@ -126,7 +129,7 @@ local ${eVar}, err = client:${entity.Name}():load(${loadArg})
 `)
     }
 
-    if (opnames.includes('list')) {
+    if (callable.includes('list')) {
       Content(`#### Example: List
 
 \`\`\`lua
@@ -136,7 +139,7 @@ local ${eVar}s, err = client:${entity.Name}():list()
 `)
     }
 
-    if (opnames.includes('create')) {
+    if (callable.includes('create')) {
       // Members come from the SAME shape the runtime validates
       // (opRequestShape): every required member must appear — including a
       // required id and parent keys like page_id — with a real, executable

package/project/.sdk/src/cmp/lua/ReadmeExamplesTest_lua.ts

@@ -102,12 +102,18 @@ local function extract_blocks(md, lang)
   return blocks
 end
 
+-- The client VARIABLE, not the word: a module name carries the word between
+-- hyphens (multifon-client_sdk).
+local function uses_client(src)
+  return (" " .. src .. " "):find("[^%w_%-%./\\"']client[^%w_%-/\\"']") ~= nil
+end
+
 -- A block is runnable if it builds a client (sdk.new / sdk.test) or uses one
 -- (references \`client\`). These are the blocks we EXECUTE offline.
 local function is_runnable(block)
   return block:find("sdk%s*%.%s*new") ~= nil
     or block:find("sdk%s*%.%s*test") ~= nil
-    or block:find("client") ~= nil
+    or uses_client(block)
 end
 
 -- NARROW illustration class:
@@ -149,7 +155,7 @@ local function make_runnable(block)
   if not src:find("require%s*%(") then
     table.insert(prelude, 'local sdk = require("' .. SDK_MODULE .. '")')
   end
-  if not constructs and src:find("client") then
+  if not constructs and uses_client(src) then
     table.insert(prelude, "local client = " .. TEST_CTOR)
   end
 

package/project/.sdk/src/cmp/lua/ReadmeHowto_lua.ts

@@ -38,7 +38,7 @@ const ReadmeHowto = cmp(function ReadmeHowto(props: any) {
     testCallArg = 0 < items.length
       ? `{ ${items.map((it: any) => `${luaKey(it.name)} = ${it.name === idF ? '"test01"' : luaLit(it.type)}`).join(', ')} }`
       : ''
-  } else if (exampleEntity && ('create' === primaryOp || 'update' === primaryOp)) {
+  } else if (exampleEntity && ('create' === primaryOp || 'update' === primaryOp || 'patch' === primaryOp)) {
     const items = opRequestShape(exampleEntity, primaryOp).items
       .filter((it: any) => it.name !== idF && it.name !== 'id')
     const required = items.filter((it: any) => !it.optional)

package/project/.sdk/src/cmp/lua/ReadmeInstall_lua.ts

@@ -24,9 +24,9 @@ export LUA_PATH="path/to/lua/?.lua;path/to/lua/?/init.lua;;"
 
   // Publish pending: not yet on LuaRocks. Install from the git release tag,
   // or add the source directory to LUA_PATH.
-  const { releasesUrl } = repoInfo(model)
+  const { hostName, tagsUrl } = repoInfo(model)
   Content(`This package is not yet published to LuaRocks. Install it from the
-GitHub release tag (\`${target.name}/vX.Y.Z\`, see [Releases](${releasesUrl})),
+${hostName} release tag (\`${target.name}/vX.Y.Z\`, see [Tags](${tagsUrl})),
 or add the source directory to your \`LUA_PATH\`:
 
 \`\`\`bash

package/project/.sdk/src/cmp/lua/ReadmeIntro_lua.ts

@@ -1,5 +1,5 @@
 
-import { cmp, Content } from '@voxgig/sdkgen'
+import { cmp, Content, modelText } from '@voxgig/sdkgen'
 
 import {
   KIT,
@@ -10,7 +10,7 @@ import {
 
 const ReadmeIntro = cmp(function ReadmeIntro(props: any) {
   const { target, ctx$: { model } } = props
-  const info = (model.main && model.main.kit && model.main.kit.info) || {}
+  const info = modelText(model)
   const tagline = info.tagline || ''
 
   // Derive a real entity accessor from the model for the semantic-entity
@@ -22,7 +22,7 @@ const ReadmeIntro = cmp(function ReadmeIntro(props: any) {
   // Model-driven op list — only the operations the active entities actually
   // expose (a read-only entity has just list+load); never claim
   // create/update/remove exist when no entity has them.
-  const CANON_OPS = ['list', 'load', 'create', 'update', 'remove']
+  const CANON_OPS = ['list', 'load', 'create', 'update', 'patch', 'remove']
   const opSet = new Set<string>()
   Object.values(entity || {}).forEach((e: any) => {
     if (!e || e.active === false) return

package/project/.sdk/src/cmp/lua/ReadmeModel_lua.ts

@@ -21,12 +21,13 @@ const ReadmeModel = cmp(function ReadmeModel(props: any) {
     list: '| `list` | `(reqmatch, ctrl) -> any, err` | List entities matching the criteria. |',
     create: '| `create` | `(reqdata, ctrl) -> any, err` | Create a new entity. |',
     update: '| `update` | `(reqdata, ctrl) -> any, err` | Update an existing entity. |',
+    patch: '| `patch` | `(reqdata, ctrl) -> any, err` | Change part of an existing entity. |',
     remove: '| `remove` | `(reqmatch, ctrl) -> any, err` | Remove an entity. |',
   }
-  const opRows = ['load', 'list', 'create', 'update', 'remove']
+  const opRows = ['load', 'list', 'create', 'update', 'patch', 'remove']
     .filter((o) => opUnion.has(o)).map((o) => opRowDefs[o]).join('\n')
 
-  const recordOps = ['load', 'create', 'update', 'remove'].filter((o) => opUnion.has(o))
+  const recordOps = ['load', 'create', 'update', 'patch', 'remove'].filter((o) => opUnion.has(o))
     .map((o) => '`' + o + '`')
   const resultRows: string[] = []
   if (recordOps.length) resultRows.push('| ' + recordOps.join(' / ') + ' | the entity record (a `table`) |')

package/project/.sdk/src/cmp/lua/ReadmeQuick_lua.ts

@@ -172,7 +172,8 @@ print(${eVar})
       ? `created:data_get()["${dataIdF}"]`
       : luaLit(idParamType(opname), 'example_id')
 
-    if (opnames.includes('create') || opnames.includes('update') || opnames.includes('remove')) {
+    if (opnames.includes('create') || opnames.includes('update') || opnames.includes('patch') ||
+      opnames.includes('remove')) {
       Content(`### 4. Create, update, and remove
 
 \`\`\`lua
@@ -189,6 +190,13 @@ if err then error(err) end
         Content(`-- Update
 client:${eName}():update({ ${updatePairs.join(', ')} })
 
+`)
+      }
+      if (opnames.includes('patch')) {
+        const patchPairs = (idF ? [`${idF} = ${idValueFor('patch')}`] : []).concat(examplePairs('patch'))
+        Content(`-- Patch — sends only the fields given
+client:${eName}():patch({ ${patchPairs.join(', ')} })
+
 `)
       }
       if (opnames.includes('remove')) {

package/project/.sdk/src/cmp/lua/ReadmeRef_lua.ts

@@ -1,5 +1,5 @@
 
-import { cmp, each, Content, canonToType, canonKey, canonScalarKey, File, isAuthActive, entityIdField, opRequestShape, safeVarName, exampleVarName, luaKey , targetFeatures } from '@voxgig/sdkgen'
+import { cmp, each, Content, canonToType, canonKey, canonScalarKey, File, isAuthActive, entityIdField, opRequestShape, safeVarName, exampleVarName, luaKey , targetFeatures, opNeedsAction, bodyNote } from '@voxgig/sdkgen'
 import { ReadmeRefFeatures } from '@voxgig/sdkgen'
 
 import {
@@ -44,6 +44,11 @@ const OP_SIGNATURES: Record<string, { sig: string, returns: string, desc: string
     returns: 'any, err',
     desc: 'Update an existing entity. The data must include the entity `id`.',
   },
+  patch: {
+    sig: 'patch(reqdata, ctrl) -> any, err',
+    returns: 'any, err',
+    desc: 'Change part of an existing entity: only the fields given are sent. The data must include the entity `id`.',
+  },
   remove: {
     sig: 'remove(reqmatch, ctrl) -> any, err',
     returns: 'any, err',
@@ -215,7 +220,7 @@ local ${eVar} = client:${ent.Name}(nil)
         if (hasFieldOps) {
           // Only emit columns for operations this entity actually exposes —
           // never advertise a create/update/remove column the entity lacks.
-          const opcols = ['load', 'list', 'create', 'update', 'remove']
+          const opcols = ['load', 'list', 'create', 'update', 'patch', 'remove']
             .filter((op: string) => opnames.includes(op) && ent.op[op]?.active !== false)
           Content(`### Field Usage by Operation
 
@@ -255,6 +260,10 @@ ${info.desc}
 
 `)
 
+          if (opNeedsAction(ent.op[opname])) {
+            return
+          }
+
           if ('load' === opname || 'remove' === opname) {
             // The id key plus every REQUIRED match key (parent path params
             // like page_id) — the same shape the runtime resolves path
@@ -301,10 +310,10 @@ local result, err = client:${ent.Name}():create({
 
 `)
           }
-          else if ('update' === opname) {
+          else if ('update' === opname || 'patch' === opname) {
             // The id key plus every REQUIRED data member — the same shape the
             // runtime validates — then the patch-fields note.
-            const updateItems = opRequestShape(ent, 'update').items
+            const updateItems = opRequestShape(ent, opname).items
               .filter((it: any) => !it.optional || it.name === idF)
               .sort((a: any, b: any) =>
                 (a.name === idF ? 0 : 1) - (b.name === idF ? 0 : 1))
@@ -312,13 +321,20 @@ local result, err = client:${ent.Name}():create({
               `  ${luaKey(it.name)} = ${luaLit(it.type,
                 it.name === idF ? ent.name + '_id' : it.name)},\n`).join('')
             Content(`\`\`\`lua
-local result, err = client:${ent.Name}():update({
-${updateLines}  -- Fields to update
+local result, err = client:${ent.Name}():${opname}({
+${updateLines}  -- ${'patch' === opname ? 'Only the fields to change' : 'Fields to update'}
 })
 \`\`\`
 
 `)
           }
+
+          if ('create' === opname || 'update' === opname || 'patch' === opname) {
+            const note = bodyNote(ent.op[opname], {
+              values: 'a string',
+            })
+            if ('' !== note) Content(note)
+          }
         })
       }
 

package/project/.sdk/src/cmp/lua/ReadmeTopTest_lua.ts

@@ -47,7 +47,7 @@ local client = sdk.test()
         ? `{ ${items.map((it: any) =>
           `${luaKey(it.name)} = ${it.name === idF ? '"test01"' : luaLit(it.type)}`).join(', ')} }`
         : ''
-    } else if ('create' === primaryOp || 'update' === primaryOp) {
+    } else if ('create' === primaryOp || 'update' === primaryOp || 'patch' === primaryOp) {
       const items = opRequestShape(exampleEntity, primaryOp).items
         .filter((it: any) => it.name !== idF && it.name !== 'id')
       const required = items.filter((it: any) => !it.optional)

package/project/.sdk/src/cmp/lua/TestClean_lua.ts

@@ -400,7 +400,31 @@ local function has_feature(name)
 end
 
 
-local function make_sdk(scenario, sinks, cleanopts, extra)
+-- Offline, as every generated suite is: the test OPTION resolves a required
+-- server variable to test-<name>, and installs no transport.
+local function offline(opts)
+  local out = {}
+  for k, v in pairs(opts) do
+    out[k] = v
+  end
+  out.test = { active = true }
+  return out
+end
+
+
+-- A client the sweep cannot build leaves nothing swept: a harness error, not
+-- a leak.
+local function construct(opts)
+  local ok, client = pcall(sdk.new, offline(opts))
+  if not ok then
+    error("clean harness: the client could not be constructed, so nothing was swept: " ..
+      tostring(client), 0)
+  end
+  return client
+end
+
+
+local function make_sdk(scenario, sinks, cleanopts, extra, auth)
   local function capture(name)
     return function(rec) append(sinks, surfaces(name, rec)) end
   end
@@ -442,7 +466,7 @@ local function make_sdk(scenario, sinks, cleanopts, extra)
     extend[#extend + 1] = f
   end
 
-  return sdk.new({
+  return construct({
     apikey = CANARY.apikey,
     secret = CANARY.secret,
     headers = { ["X-Custom-Token"] = CANARY.header },
@@ -452,6 +476,7 @@ local function make_sdk(scenario, sinks, cleanopts, extra)
     utility = {
       fetcher = function(_ctx, url, fetchdef) return scenario.respond(url, fetchdef) end,
     },
+    auth = auth,
   })
 end
 
@@ -459,7 +484,7 @@ end
 -- The first operation that completes against a plain 200: with no
 -- arguments, else with every path parameter its points declare filled in.
 local function usable_op()
-  local plain = sdk.new({
+  local plain = construct({
     apikey = CANARY.apikey,
     utility = { fetcher = function() return response(200, { id = "i1" }) end },
   })
@@ -530,6 +555,8 @@ local function drive(client, target, ctrl, sinks)
   if out ~= nil then
     append(sinks, surfaces("result", out))
   end
+  -- Raw, as a caller copying the match into another query reads it.
+  append(sinks, surfaces("match", ent:match_get()))
   if ctrl.explain ~= nil then
     append(sinks, surfaces("explain", ctrl.explain))
   end
@@ -573,12 +600,16 @@ describe("clean", function()
       end
     end
 
+    -- A name given at run time replaces the declared one: the match leaves
+    -- out whichever name prepare_auth placed.
+    drive(make_sdk(SCENARIOS[1], sinks, nil, nil, { name = "zzcred" }), target, {}, sinks)
+
     -- A credential mistyped as a table is rejected by validation, whose
     -- message quotes the value it rejected.
-    local built, rejected = pcall(sdk.new, {
+    local built, rejected = pcall(sdk.new, offline({
       apikey = { value = CANARY.apikey },
       clean = { values = CANARY.value },
-    })
+    }))
     assert.is_false(built, "a credential mistyped as a table should be rejected")
     append(sinks, surfaces("rejected", rejected))
 
@@ -604,13 +635,13 @@ describe("clean", function()
 
     -- Iterating a stream runs inside the same catch path as the operation,
     -- and the explain record the caller passed is cleaned however it ends.
-    -- A step's error ends a stream without raising. The caller stops at the
-    -- first item, leaving the stream open.
+    -- A step's error raises from the stream, as it fails the operation. The
+    -- caller stops at the first item, leaving the stream open.
     for _, case in ipairs({
       { name = "stream", extra = { StreamThrowFeature.new() }, raises = true },
       { name = "stream-ok", extra = { StreamOkFeature.new() } },
       { name = "stream-plain", extra = {} },
-      { name = "stream-step", extra = { StepFailFeature.new() } },
+      { name = "stream-step", extra = { StepFailFeature.new() }, raises = true },
     }) do
       local streamed = make_sdk(SCENARIOS[1], sinks, nil, case.extra)
       local sent = streamed[target.accessor](streamed)
@@ -628,7 +659,7 @@ describe("clean", function()
     end
 
     -- A client given no clean block at all masks by the schema defaults.
-    local bare = sdk.new({
+    local bare = construct({
       apikey = CANARY.apikey,
       secret = CANARY.secret,
       headers = { ["X-Custom-Token"] = CANARY.header },
@@ -727,12 +758,14 @@ describe("clean", function()
   -- A feature's name is not a field name: a feature called secrets does not
   -- make its settings secret, though a sensitive field inside it still is. An
   -- entity block, of per-entity settings or seeded records keyed by entity
-  -- name and id, is not read at all.
+  -- name and id, is not read at all, and nor are rbac's rules, keyed by entity
+  -- and operation names.
   it("a feature's name is read as a name", function()
-    local client = sdk.new({
+    local client = construct({
       apikey = CANARY.apikey,
       feature = {
         secrets = { active = false, name = "ZZNAME-feat123", token = "ZZTOKEN-feat456" },
+        rbac = { active = false, rules = { ["zztoken.load"] = "PLAINRULE-k7j5h3g1" } },
         test = { active = false, entity = { zztoken = { ZZTOKEN01 = { note = "PLAINRECORD-t5r3e1w9" } } } },
       },
       entity = { zztoken = { alias = { zzkey = "PLAINALIAS-m2n4b6v8" } } },
@@ -742,11 +775,12 @@ describe("clean", function()
     assert.are.equal("ZZNAME-feat123 " .. MASK, clean(ctx, "ZZNAME-feat123 ZZTOKEN-feat456"))
     assert.are.equal("record PLAINRECORD-t5r3e1w9", clean(ctx, "record PLAINRECORD-t5r3e1w9"))
     assert.are.equal("alias PLAINALIAS-m2n4b6v8", clean(ctx, "alias PLAINALIAS-m2n4b6v8"))
+    assert.are.equal("rule PLAINRULE-k7j5h3g1", clean(ctx, "rule PLAINRULE-k7j5h3g1"))
   end)
 
 
   it("the generated config's own clean block is honoured", function()
-    local utility = sdk.new({}):get_utility()
+    local utility = construct({}):get_utility()
     local config = { options = { clean = { keys = "zzsens", values = "CONFIG-SEEDED-1" } } }
     local opts = utility.make_options({
       utility = utility,