@voxgig/sdkgen 0.44.0 → 1.0.1

package/project/.sdk/tm/go/test/runner_test.go

@@ -71,12 +71,112 @@ func envOverride(m map[string]any) map[string]any {
 }
 
 type entityTestSetup struct {
-	client  *sdk.ProjectNameSDK
-	data    map[string]any
-	idmap   map[string]any
-	env     map[string]any
-	explain bool
-	now     int64
+	client         *sdk.ProjectNameSDK
+	data           map[string]any
+	idmap          map[string]any
+	env            map[string]any
+	explain        bool
+	live           bool
+	syntheticOnly  bool
+	now            int64
+}
+
+var (
+	cachedTestControl     map[string]any
+	cachedTestControlOnce sync.Once
+)
+
+// loadTestControl reads sdk-test-control.json from this test dir; caches
+// after first read. Returns an empty-skip default if the file is missing
+// or invalid so tests never crash on a bad config.
+func loadTestControl() map[string]any {
+	cachedTestControlOnce.Do(func() {
+		_, filename, _, _ := runtime.Caller(0)
+		dir := filepath.Dir(filename)
+		ctrlPath := filepath.Join(dir, "sdk-test-control.json")
+		def := map[string]any{
+			"version": 1,
+			"test": map[string]any{"skip": map[string]any{
+				"live": map[string]any{"direct": []any{}, "entityOp": []any{}},
+				"unit": map[string]any{"direct": []any{}, "entityOp": []any{}},
+			}},
+		}
+		data, err := os.ReadFile(ctrlPath)
+		if err != nil {
+			cachedTestControl = def
+			return
+		}
+		var parsed map[string]any
+		if err := json.Unmarshal(data, &parsed); err != nil {
+			cachedTestControl = def
+			return
+		}
+		cachedTestControl = parsed
+	})
+	return cachedTestControl
+}
+
+// isControlSkipped checks sdk-test-control.json for a skip entry.
+// Returns (skip, reason).
+func isControlSkipped(kind, name, mode string) (bool, string) {
+	ctrl := loadTestControl()
+	test, _ := ctrl["test"].(map[string]any)
+	if test == nil {
+		return false, ""
+	}
+	skip, _ := test["skip"].(map[string]any)
+	if skip == nil {
+		return false, ""
+	}
+	modeMap, _ := skip[mode].(map[string]any)
+	if modeMap == nil {
+		return false, ""
+	}
+	items, _ := modeMap[kind].([]any)
+	for _, raw := range items {
+		item, _ := raw.(map[string]any)
+		if item == nil {
+			continue
+		}
+		reason, _ := item["reason"].(string)
+		if kind == "direct" {
+			if t, _ := item["test"].(string); t == name {
+				return true, reason
+			}
+		}
+		if kind == "entityOp" {
+			ent, _ := item["entity"].(string)
+			op, _ := item["op"].(string)
+			if ent+"."+op == name {
+				return true, reason
+			}
+		}
+	}
+	return false, ""
+}
+
+// liveDelayMs returns the configured per-test live delay in ms; default 500.
+func liveDelayMs() int {
+	ctrl := loadTestControl()
+	test, _ := ctrl["test"].(map[string]any)
+	if test == nil {
+		return 500
+	}
+	live, _ := test["live"].(map[string]any)
+	if live == nil {
+		return 500
+	}
+	switch v := live["delayMs"].(type) {
+	case float64:
+		if v >= 0 {
+			return int(v)
+		}
+	case int:
+		if v >= 0 {
+			return v
+		}
+	}
+	return 500
 }
 
 var cachedTestSpec map[string]any

package/project/.sdk/tm/go/test/sdk-test-control.json

@@ -0,0 +1,19 @@
+{
+  "version": 1,
+  "_doc": "Per-SDK test control. Lists tests/operations to skip in unit and live modes; tunes per-test pacing. Edit by hand. Loaded by go test runner.",
+  "test": {
+    "skip": {
+      "live": {
+        "direct": [],
+        "entityOp": []
+      },
+      "unit": {
+        "direct": [],
+        "entityOp": []
+      }
+    },
+    "live": {
+      "delayMs": 500
+    }
+  }
+}

package/project/.sdk/tm/go/utility/fetcher.go

@@ -27,13 +27,23 @@ func defaultHTTPFetch(fullurl string, fetchdef map[string]any) (map[string]any,
 		return nil, err
 	}
 
+	hasUA := false
 	if headers, ok := fetchdef["headers"].(map[string]any); ok {
 		for k, v := range headers {
 			if sv, ok := v.(string); ok {
+				if strings.EqualFold(k, "user-agent") {
+					hasUA = true
+				}
 				req.Header.Set(k, sv)
 			}
 		}
 	}
+	// Default User-Agent — Go's net/http defaults to "Go-http-client/1.1"
+	// which some CDNs block. Use a Mozilla-shaped UA unless the caller
+	// already set one.
+	if !hasUA {
+		req.Header.Set("User-Agent", "Mozilla/5.0 (compatible; ProjectNameSDK/1.0)")
+	}
 
 	resp, err := http.DefaultClient.Do(req)
 	if err != nil {

package/project/.sdk/tm/go/utility/make_url.go

@@ -35,6 +35,18 @@ func makeUrlUtil(ctx *core.Context) (string, error) {
 		}
 	}
 
+	// Append query string from spec.Query.
+	qsep := "?"
+	for _, item := range vs.Items(spec.Query) {
+		key, _ := item[0].(string)
+		val := item[1]
+		if val != nil {
+			url += qsep + vs.EscUrl(key) + "=" + vs.EscUrl(vs.Stringify(val))
+			qsep = "&"
+			resmatch[key] = val
+		}
+	}
+
 	result.Resmatch = resmatch
 
 	return url, nil

package/project/.sdk/tm/go/utility/prepare_auth.go

@@ -20,9 +20,23 @@ func prepareAuthUtil(ctx *core.Context) (*core.Spec, error) {
 	headers := spec.Headers
 	options := ctx.Client.OptionsMap()
 
+	// Public APIs that need no auth omit the options.auth block entirely.
+	if options["auth"] == nil {
+		delete(headers, headerAuth)
+		return spec, nil
+	}
+
 	apikey := vs.GetProp(options, optionApikey, notFound)
 
-	if apikeyStr, ok := apikey.(string); ok && apikeyStr == notFound {
+	skip := false
+	if apikey == nil {
+		skip = true
+	} else if apikeyStr, ok := apikey.(string); ok &&
+		(apikeyStr == notFound || apikeyStr == "") {
+		skip = true
+	}
+
+	if skip {
 		delete(headers, headerAuth)
 	} else {
 		authPrefix := ""

package/project/.sdk/tm/js/src/utility/PrepareAuthUtility.js

@@ -24,9 +24,15 @@ function prepareAuth(ctx) {
 
   const options = client.options()
 
+  // Public APIs that need no auth omit the options.auth block entirely.
+  if (null == options.auth) {
+    delprop(headers, HEADER_auth)
+    return spec
+  }
+
   const apikey = getprop(options, OPTION_apikey, NOTFOUND)
 
-  if (NOTFOUND === apikey) {
+  if (NOTFOUND === apikey || null == apikey || '' === apikey) {
     delprop(headers, HEADER_auth)
   }
   else {

package/project/.sdk/tm/lua/feature/test_feature.lua

@@ -62,8 +62,27 @@ function TestFeature:init(ctx, options)
       entmap = {}
     end
 
+    -- For single-entity ops (load, remove) with an empty explicit match, fall
+    -- back to the id the entity client already knows from a prior create/load
+    -- (in fctx.match / fctx.data). Mirrors the TS mock where param() resolves
+    -- the id from that accumulated state.
+    local function resolve_match(explicit)
+      if type(explicit) == "table" and next(explicit) ~= nil then
+        return explicit
+      end
+      local function id_of(src)
+        if src == nil then return nil end
+        local v = vs.getprop(src, "id")
+        if v ~= nil and v ~= "__UNDEFINED__" then return v end
+        return nil
+      end
+      local v = id_of(fctx.match) or id_of(fctx.data)
+      if v ~= nil then return { id = v } end
+      return {}
+    end
+
     if op.name == "load" then
-      local args = test_self:build_args(fctx, op, fctx.reqmatch)
+      local args = test_self:build_args(fctx, op, resolve_match(fctx.reqmatch))
       local found = vs.select(entmap, args)
       local ent = vs.getelem(found, 0)
       if ent == nil then
@@ -88,9 +107,28 @@ function TestFeature:init(ctx, options)
       return respond(200, out, nil)
 
     elseif op.name == "update" then
-      local args = test_self:build_args(fctx, op, fctx.reqdata)
+      -- Match the existing entity by id only (or its alias). reqdata also
+      -- contains the new field values, which would otherwise cause select
+      -- to filter out the entity we want to update. Falls back to first
+      -- entity when no match found, mirroring the TS mock.
+      local update_match = {}
+      if type(fctx.reqdata) == "table" then
+        if fctx.reqdata["id"] ~= nil then update_match["id"] = fctx.reqdata["id"] end
+        if op.alias_map ~= nil then
+          local alias_id = vs.getprop(op.alias_map, "id")
+          if alias_id ~= nil and fctx.reqdata[alias_id] ~= nil then
+            update_match[alias_id] = fctx.reqdata[alias_id]
+          end
+        end
+      end
+      local args = test_self:build_args(fctx, op, update_match)
       local found = vs.select(entmap, args)
       local ent = vs.getelem(found, 0)
+      if ent == nil and type(entmap) == "table" then
+        for _, e in pairs(entmap) do
+          if type(e) == "table" then ent = e; break end
+        end
+      end
       if ent == nil then
         return respond(404, nil, { statusText = "Not found" })
       end
@@ -107,7 +145,7 @@ function TestFeature:init(ctx, options)
       return respond(200, out, nil)
 
     elseif op.name == "remove" then
-      local args = test_self:build_args(fctx, op, fctx.reqmatch)
+      local args = test_self:build_args(fctx, op, resolve_match(fctx.reqmatch))
       local found = vs.select(entmap, args)
       local ent = vs.getelem(found, 0)
       if ent == nil then

package/project/.sdk/tm/lua/test/runner.lua

@@ -83,4 +83,78 @@ function runner.entity_list_to_data(list)
 end
 
 
+-- Load sdk-test-control.json from this test dir; cache. Returns an
+-- empty-skip default if the file is missing or invalid.
+runner._test_control = nil
+
+function runner.load_test_control()
+  if runner._test_control ~= nil then
+    return runner._test_control
+  end
+  local this_dir = debug.getinfo(1, "S").source:match("^@(.+/)") or "./"
+  local ctrl_path = this_dir .. "sdk-test-control.json"
+  local f = io.open(ctrl_path, "r")
+  if f == nil then
+    runner._test_control = {
+      version = 1,
+      test = {
+        skip = {
+          live = { direct = {}, entityOp = {} },
+          unit = { direct = {}, entityOp = {} },
+        },
+      },
+    }
+    return runner._test_control
+  end
+  local content = f:read("*a")
+  f:close()
+  local parsed = json.decode(content)
+  if parsed == nil then
+    runner._test_control = {
+      version = 1,
+      test = {
+        skip = {
+          live = { direct = {}, entityOp = {} },
+          unit = { direct = {}, entityOp = {} },
+        },
+      },
+    }
+  else
+    runner._test_control = parsed
+  end
+  return runner._test_control
+end
+
+
+-- Check sdk-test-control.json for a skip entry. Returns (skip, reason).
+function runner.is_control_skipped(kind, name, mode)
+  local ctrl = runner.load_test_control()
+  local skip = (((ctrl.test or {}).skip or {})[mode] or {})
+  local items = skip[kind] or {}
+  for _, item in ipairs(items) do
+    if kind == "direct" and item.test == name then
+      return true, item.reason
+    end
+    if kind == "entityOp" then
+      local key = (item.entity or "") .. "." .. (item.op or "")
+      if key == name then
+        return true, item.reason
+      end
+    end
+  end
+  return false, nil
+end
+
+
+-- Per-test live pacing delay (ms); default 500.
+function runner.live_delay_ms()
+  local ctrl = runner.load_test_control()
+  local v = ((ctrl.test or {}).live or {}).delayMs
+  if type(v) == "number" and v >= 0 then
+    return v
+  end
+  return 500
+end
+
+
 return runner

package/project/.sdk/tm/lua/test/sdk-test-control.json

@@ -0,0 +1,19 @@
+{
+  "version": 1,
+  "_doc": "Per-SDK test control. Lists tests/operations to skip in unit and live modes; tunes per-test pacing. Edit by hand. Loaded by lua test runner.",
+  "test": {
+    "skip": {
+      "live": {
+        "direct": [],
+        "entityOp": []
+      },
+      "unit": {
+        "direct": [],
+        "entityOp": []
+      }
+    },
+    "live": {
+      "delayMs": 500
+    }
+  }
+}

package/project/.sdk/tm/lua/utility/fetcher.lua

@@ -25,6 +25,19 @@ local function default_http_fetch(fullurl, fetchdef)
     headers["content-length"] = tostring(#body_str)
   end
 
+  -- Default User-Agent — many CDNs reject requests with no UA. Set a
+  -- Mozilla-shaped UA unless the caller already set one.
+  local has_ua = false
+  for k, _ in pairs(headers) do
+    if string.lower(k) == "user-agent" then
+      has_ua = true
+      break
+    end
+  end
+  if not has_ua then
+    headers["User-Agent"] = "Mozilla/5.0 (compatible; ProjectNameSDK/1.0)"
+  end
+
   local response_body = {}
   local res, code, response_headers = http.request({
     url = fullurl,

package/project/.sdk/tm/lua/utility/make_url.lua

@@ -38,6 +38,22 @@ local function make_url_util(ctx)
     end
   end
 
+  -- Append query string from spec.query.
+  local qsep = "?"
+  local query_items = vs.items(spec.query)
+  if query_items ~= nil then
+    for _, item in ipairs(query_items) do
+      local key = item[1]
+      local val = item[2]
+      if val ~= nil and type(key) == "string" then
+        local val_str = type(val) == "string" and val or tostring(val)
+        url = url .. qsep .. vs.escurl(key) .. "=" .. vs.escurl(val_str)
+        qsep = "&"
+        resmatch[key] = val
+      end
+    end
+  end
+
   result.resmatch = resmatch
 
   return url, nil

package/project/.sdk/tm/lua/utility/prepare_auth.lua

@@ -16,9 +16,17 @@ local function prepare_auth_util(ctx)
   local headers = spec.headers
   local options = ctx.client:options_map()
 
+  -- Public APIs that need no auth omit the options.auth block entirely.
+  if options.auth == nil then
+    headers[HEADER_AUTH] = nil
+    return spec, nil
+  end
+
   local apikey = vs.getprop(options, OPTION_APIKEY, NOT_FOUND)
 
-  if type(apikey) == "string" and apikey == NOT_FOUND then
+  if apikey == nil
+    or (type(apikey) == "string" and (apikey == NOT_FOUND or apikey == ""))
+  then
     headers[HEADER_AUTH] = nil
   else
     local auth_prefix = ""