@voxgig/sdkgen 0.45.0 → 1.0.1

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/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/php/feature/TestFeature.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 // ProjectName SDK test feature
 
 require_once __DIR__ . '/BaseFeature.php';
+require_once __DIR__ . '/../utility/Param.php';
 
 class ProjectNameTestFeature extends ProjectNameBaseFeature
 {
@@ -45,7 +46,7 @@ class ProjectNameTestFeature extends ProjectNameBaseFeature
         $entity->data = $entity_data;
 
         $test_fetcher = function (ProjectNameContext $fctx, string $_fullurl, array $_fetchdef) use ($entity): array {
-            $respond = function (int $status, mixed $data, ?array $extra): array {
+            $respond = function (int $status, mixed $data, ?array $extra = null): array {
                 $out = [
                     'status' => $status,
                     'statusText' => 'OK',
@@ -64,53 +65,115 @@ class ProjectNameTestFeature extends ProjectNameBaseFeature
             $entname = $op->entity;
             $entmap = is_array($entity->data[$entname] ?? null) ? $entity->data[$entname] : [];
 
-            // Extract id from context: reqmatch for load/remove, reqdata for update/create.
-            $get_id = function () use ($fctx) {
-                $sources = [$fctx->reqmatch, $fctx->reqdata, $fctx->data];
-                foreach ($sources as $src) {
-                    if (is_array($src) && isset($src['id']) && $src['id'] !== '__UNDEFINED__') {
-                        return $src['id'];
+            // PHP-portable equivalent of TS buildArgs+select: a flat-key
+            // filter that matches by exact-equality on each provided key,
+            // with alias fallback. Empty match matches all entries — load
+            // with empty match returns the first fixture entry (or last
+            // create), list returns all entries.
+            $find_first = function (array $entmap, $match, $alias) {
+                if (!is_array($match) || empty($match)) {
+                    foreach ($entmap as $e) {
+                        if (is_array($e)) return $e;
+                    }
+                    return null;
+                }
+                foreach ($entmap as $e) {
+                    if (!is_array($e)) continue;
+                    $ok = true;
+                    foreach ($match as $k => $v) {
+                        if ($v === null || $v === '__UNDEFINED__') continue;
+                        $ev = $e[$k] ?? null;
+                        if ($ev !== $v) {
+                            // Try alias key if any
+                            $ka = is_array($alias) ? ($alias[$k] ?? null) : null;
+                            $aliased = ($ka !== null) ? ($e[$ka] ?? null) : null;
+                            if ($aliased !== $v) {
+                                $ok = false;
+                                break;
+                            }
+                        }
                     }
+                    if ($ok) return $e;
                 }
                 return null;
             };
 
-            if ($op->name === 'load') {
-                $id = $get_id();
-                $ent = ($id !== null && isset($entmap[$id])) ? $entmap[$id] : null;
-                if (!$ent) {
-                    // Fallback: search by id field value
-                    foreach ($entmap as $e) {
-                        if (is_array($e) && ($e['id'] ?? null) === $id) { $ent = $e; break; }
+            $find_all = function (array $entmap, $match, $alias) use ($find_first) {
+                if (!is_array($match) || empty($match)) {
+                    return array_values(array_filter($entmap, 'is_array'));
+                }
+                $out = [];
+                foreach ($entmap as $e) {
+                    if (!is_array($e)) continue;
+                    $ok = true;
+                    foreach ($match as $k => $v) {
+                        if ($v === null || $v === '__UNDEFINED__') continue;
+                        $ev = $e[$k] ?? null;
+                        if ($ev !== $v) {
+                            $ka = is_array($alias) ? ($alias[$k] ?? null) : null;
+                            $aliased = ($ka !== null) ? ($e[$ka] ?? null) : null;
+                            if ($aliased !== $v) { $ok = false; break; }
+                        }
+                    }
+                    if ($ok) $out[] = $e;
+                }
+                return $out;
+            };
+
+            $alias = is_object($op) ? ($op->alias ?? null) : \Voxgig\Struct\Struct::getprop($op, 'alias');
+
+            // 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 (carried in $fctx->match / $fctx->data). This
+            // mirrors the TS mock where param() resolves the id from that
+            // accumulated state — e.g. `create()` then `remove([])` removes the
+            // just-created entity, not an arbitrary fixture.
+            $resolve_match = function ($explicit) use ($fctx) {
+                if (is_array($explicit) && !empty($explicit)) return $explicit;
+                foreach ([$fctx->match, $fctx->data] as $src) {
+                    $arr = is_array($src) ? $src : (is_object($src) ? (array) $src : []);
+                    if (isset($arr['id']) && $arr['id'] !== null && $arr['id'] !== '__UNDEFINED__') {
+                        return ['id' => $arr['id']];
                     }
                 }
-                if (!$ent) {
+                return [];
+            };
+
+            if ($op->name === 'load') {
+                $ent = $find_first($entmap, $resolve_match($fctx->reqmatch), $alias);
+                if ($ent === null) {
                     return $respond(404, null, ['statusText' => 'Not found']);
                 }
+                if (is_array($ent)) unset($ent['$KEY']);
                 $out = \Voxgig\Struct\Struct::clone($ent);
-                if (is_array($out)) { unset($out['$KEY']); }
-                return $respond(200, $out, null);
+                return $respond(200, $out);
 
             } elseif ($op->name === 'list') {
-                $out = [];
-                foreach ($entmap as $e) {
-                    if (is_array($e)) {
-                        $copy = $e;
-                        unset($copy['$KEY']);
-                        $out[] = $copy;
-                    }
+                $found = $find_all($entmap, $fctx->reqmatch, $alias);
+                $cleaned = [];
+                foreach ($found as $e) {
+                    if (is_array($e)) unset($e['$KEY']);
+                    $cleaned[] = $e;
                 }
-                return $respond(200, $out, null);
+                $out = \Voxgig\Struct\Struct::clone($cleaned);
+                return $respond(200, $out);
 
             } elseif ($op->name === 'update') {
-                $id = $get_id();
-                $ent = ($id !== null && isset($entmap[$id])) ? $entmap[$id] : null;
-                if (!$ent) {
-                    foreach ($entmap as $e) {
-                        if (is_array($e) && ($e['id'] ?? null) === $id) { $ent = $e; break; }
+                // Match the existing entity by id only (or its alias). reqdata
+                // also contains the new field values, which would otherwise
+                // cause find_first to filter out the entity we want to update.
+                $update_match = [];
+                if (is_array($fctx->reqdata)) {
+                    if (array_key_exists('id', $fctx->reqdata)) {
+                        $update_match['id'] = $fctx->reqdata['id'];
+                    }
+                    $id_alias = is_array($alias) ? ($alias['id'] ?? null) : null;
+                    if ($id_alias !== null && array_key_exists($id_alias, $fctx->reqdata)) {
+                        $update_match[$id_alias] = $fctx->reqdata[$id_alias];
                     }
                 }
-                if (!$ent) {
+                $ent = $find_first($entmap, $update_match, $alias);
+                if ($ent === null) {
                     return $respond(404, null, ['statusText' => 'Not found']);
                 }
                 if (is_array($fctx->reqdata)) {
@@ -118,33 +181,42 @@ class ProjectNameTestFeature extends ProjectNameBaseFeature
                         $ent[$k] = $v;
                     }
                 }
-                $entmap[$id] = $ent;
-                $entity->data[$entname] = $entmap;
+                $id = is_array($ent) ? ($ent['id'] ?? null) : null;
+                if ($id !== null) {
+                    $entmap[$id] = $ent;
+                    $entity->data[$entname] = $entmap;
+                }
+                if (is_array($ent)) unset($ent['$KEY']);
                 $out = \Voxgig\Struct\Struct::clone($ent);
-                if (is_array($out)) { unset($out['$KEY']); }
-                return $respond(200, $out, null);
+                return $respond(200, $out);
 
             } elseif ($op->name === 'remove') {
-                $id = $get_id();
-                if ($id !== null && isset($entmap[$id])) {
+                $ent = $find_first($entmap, $resolve_match($fctx->reqmatch), $alias);
+                if ($ent === null) {
+                    return $respond(404, null, ['statusText' => 'Not found']);
+                }
+                $id = is_array($ent) ? ($ent['id'] ?? null) : null;
+                if ($id !== null) {
                     unset($entmap[$id]);
                     $entity->data[$entname] = $entmap;
                 }
-                return $respond(200, null, null);
+                return $respond(200, null);
 
             } elseif ($op->name === 'create') {
-                $id = $get_id();
-                if ($id === null) {
-                    $id = sprintf('%04x%04x%04x%04x', random_int(0, 0xFFFF), random_int(0, 0xFFFF), random_int(0, 0xFFFF), random_int(0, 0xFFFF));
+                $id = ProjectNameParam::call($fctx, 'id');
+                if ($id === null || $id === '__UNDEFINED__') {
+                    $id = sprintf('%04x%04x%04x%04x',
+                        random_int(0, 0xFFFF), random_int(0, 0xFFFF),
+                        random_int(0, 0xFFFF), random_int(0, 0xFFFF));
                 }
 
                 $ent = is_array($fctx->reqdata) ? $fctx->reqdata : [];
                 $ent['id'] = $id;
                 $entmap[$id] = $ent;
                 $entity->data[$entname] = $entmap;
+                if (is_array($ent)) unset($ent['$KEY']);
                 $out = \Voxgig\Struct\Struct::clone($ent);
-                if (is_array($out)) { unset($out['$KEY']); }
-                return $respond(200, $out, null);
+                return $respond(200, $out);
 
             } else {
                 return $respond(404, null, ['statusText' => 'Unknown operation']);
@@ -153,4 +225,74 @@ class ProjectNameTestFeature extends ProjectNameBaseFeature
 
         $ctx->utility->fetcher = $test_fetcher;
     }
+
+    /**
+     * Build a structured `$AND` query from the request match/data dict,
+     * matching the TS test feature's buildArgs. Mirrors ts/src/feature/test/TestFeature.ts:158-204.
+     *
+     * For each key in $args that is 'id' OR a required-param key on the
+     * current operation point, emit a `$OR` clause matching the key (and
+     * its alias, if any) against the supplied value.
+     */
+    public function buildArgs(ProjectNameContext $ctx, $op, $args): array
+    {
+        // If args is empty/missing, return an empty $AND so select() matches
+        // every entry — the TS test feature relies on this for empty-match
+        // load against fixture entries.
+        $keys = is_array($args) ? \Voxgig\Struct\Struct::keysof($args) : [];
+        if (empty($keys)) {
+            return ['$AND' => []];
+        }
+
+        $opname = is_object($op) ? ($op->name ?? null) : (\Voxgig\Struct\Struct::getprop($op, 'name'));
+        $entityName = null;
+        if (isset($ctx->entity)) {
+            $entityName = is_object($ctx->entity)
+                ? ($ctx->entity->name ?? null)
+                : (is_array($ctx->entity) ? ($ctx->entity['name'] ?? null) : null);
+        }
+
+        // Resolve required-param names from the op's last point. Defensive:
+        // any missing piece falls back to "no required params".
+        $reqd_names = [];
+        if (is_string($opname) && is_string($entityName) && isset($ctx->config)) {
+            $points = \Voxgig\Struct\Struct::getpath(
+                ['entity', $entityName, 'op', $opname, 'points'],
+                $ctx->config
+            );
+            $point = \Voxgig\Struct\Struct::getelem($points, -1);
+            $params = is_array($point) ? ($point['args']['params'] ?? null) : null;
+            if (is_array($params)) {
+                foreach ($params as $p) {
+                    if (is_array($p) && (($p['reqd'] ?? false) === true)) {
+                        $n = $p['name'] ?? null;
+                        if ($n !== null) {
+                            $reqd_names[] = $n;
+                        }
+                    }
+                }
+            }
+        }
+
+        $alias = is_object($op) ? ($op->alias ?? null) : \Voxgig\Struct\Struct::getprop($op, 'alias');
+        $qand = [];
+
+        foreach ($keys as $k) {
+            $is_id = ($k === 'id');
+            $in_reqd = in_array($k, $reqd_names, true);
+            if ($is_id || $in_reqd) {
+                $v = ProjectNameParam::call($ctx, $k);
+                $ka = \Voxgig\Struct\Struct::getprop($alias, $k);
+
+                $qor = [[$k => $v]];
+                if ($ka !== null) {
+                    $qor[] = [$ka => $v];
+                }
+
+                $qand[] = ['$OR' => $qor];
+            }
+        }
+
+        return ['$AND' => $qand];
+    }
 }

package/project/.sdk/tm/php/test/Runner.php

@@ -86,6 +86,68 @@ class ProjectNameTestRunner
         }
         return $out;
     }
+
+    private static $test_control = null;
+
+    /**
+     * Load sdk-test-control.json from this test dir; cache. Returns an
+     * empty-skip default if the file is missing or invalid.
+     */
+    public static function load_test_control(): array
+    {
+        if (self::$test_control !== null) {
+            return self::$test_control;
+        }
+        $ctrl_path = __DIR__ . '/sdk-test-control.json';
+        $default = [
+            'version' => 1,
+            'test' => ['skip' => [
+                'live' => ['direct' => [], 'entityOp' => []],
+                'unit' => ['direct' => [], 'entityOp' => []],
+            ]],
+        ];
+        if (!file_exists($ctrl_path)) {
+            self::$test_control = $default;
+            return self::$test_control;
+        }
+        $content = file_get_contents($ctrl_path);
+        $parsed = json_decode($content, true);
+        self::$test_control = is_array($parsed) ? $parsed : $default;
+        return self::$test_control;
+    }
+
+    /**
+     * Check sdk-test-control.json for a skip entry. Returns [skip, reason].
+     */
+    public static function is_control_skipped(string $kind, string $name, string $mode): array
+    {
+        $ctrl = self::load_test_control();
+        $skip = $ctrl['test']['skip'][$mode] ?? [];
+        $items = $skip[$kind] ?? [];
+        foreach ($items as $item) {
+            if ($kind === 'direct' && ($item['test'] ?? null) === $name) {
+                return [true, $item['reason'] ?? null];
+            }
+            if ($kind === 'entityOp') {
+                $key = ($item['entity'] ?? '') . '.' . ($item['op'] ?? '');
+                if ($key === $name) {
+                    return [true, $item['reason'] ?? null];
+                }
+            }
+        }
+        return [false, null];
+    }
+
+    /** Per-test live pacing delay (ms); default 500. */
+    public static function live_delay_ms(): int
+    {
+        $ctrl = self::load_test_control();
+        $v = $ctrl['test']['live']['delayMs'] ?? null;
+        if (is_int($v) && $v >= 0) {
+            return $v;
+        }
+        return 500;
+    }
 }
 
 // Aliases for test convenience.

package/project/.sdk/tm/php/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 php test runner.",
+  "test": {
+    "skip": {
+      "live": {
+        "direct": [],
+        "entityOp": []
+      },
+      "unit": {
+        "direct": [],
+        "entityOp": []
+      }
+    },
+    "live": {
+      "delayMs": 500
+    }
+  }
+}