@voxgig/sdkgen 2.0.2 → 3.1.0

package/project/.sdk/tm/csharp/test/FeatureTest.cs

@@ -1,13 +1,11 @@
-// Offline feature-test harness plus behavioural tests for the enterprise
-// features shipped with this SDK (retry, cache, rbac, telemetry, ...).
-// C# twin of tm/go/test/feature_test.go.
+// Behavioural tests for the enterprise features shipped with this SDK
+// (retry, cache, rbac, telemetry, ...). Each block runs only when its
+// feature is present (see Fh.HasFeature in FeatureHarness.cs, which also
+// holds the Fh* pipeline harness these tests drive).
 //
-// Feature behaviour is unit-tested by driving each feature through a
-// faithful miniature of the real operation pipeline against a configurable
-// mock transport - the same hook order and short-circuit rules as the
-// generated entity op code, but with no live server and no API-specific
-// fixtures. Each block runs only when its feature is present in this SDK
-// (see Fh.HasFeature; absent features early-return their tests).
+// This file constructs every shipped feature type by name, so it only
+// compiles with the COMPLETE feature set - it is listed in the csharp
+// target's `feature.fullset` and dropped when a project trims its features.
 
 using System.Text.RegularExpressions;
 
@@ -19,382 +17,6 @@ using ProjectNameSdk.Feature;
 
 namespace ProjectNameSdk.Test;
 
-// --- harness ----------------------------------------------------------------
-
-// FhClock is a deterministic virtual clock: Now() advances only when
-// Sleep(ms) is called, so timing-based features can be asserted without
-// real delays.
-internal class FhClock
-{
-    public long T;
-    public long Now() => T;
-    public void Sleep(int ms) => T += ms;
-    public void Advance(int ms) => T += ms;
-}
-
-// FhRecorder is a mock transport recording every call, replying via an
-// optional Reply func (default: 200 with a call counter).
-internal class FhRecorder
-{
-    public List<Dictionary<string, object?>> Calls = new();
-    public Func<int, Dictionary<string, object?>, object?>? Reply;
-
-    public object? Fetch(Context ctx, string url, Dictionary<string, object?> fetchdef)
-    {
-        Calls.Add(new Dictionary<string, object?>
-        {
-            ["url"] = url,
-            ["fetchdef"] = fetchdef,
-        });
-        if (Reply != null)
-        {
-            return Reply(Calls.Count, fetchdef);
-        }
-        return Fh.Response(200, new Dictionary<string, object?>
-        {
-            ["ok"] = true,
-            ["n"] = Calls.Count,
-        }, null);
-    }
-
-    public Dictionary<string, object?> Headers(int i)
-    {
-        var fetchdef = Calls[i]["fetchdef"] as Dictionary<string, object?>;
-        return fetchdef?["headers"] as Dictionary<string, object?>
-            ?? new Dictionary<string, object?>();
-    }
-
-    public Dictionary<string, object?> Fetchdef(int i)
-    {
-        return Calls[i]["fetchdef"] as Dictionary<string, object?>
-            ?? new Dictionary<string, object?>();
-    }
-
-    public string Url(int i)
-    {
-        return Calls[i]["url"] as string ?? "";
-    }
-}
-
-internal class FhOpSpec
-{
-    public string Entity = "";
-    public string Op = "";
-    public string Method = "";
-    public string Path = "";
-    public Dictionary<string, object?>? Query;
-    public Dictionary<string, object?>? Headers;
-    public object? Body;
-    public Dictionary<string, object?>? Ctrl;
-}
-
-internal class FhOpResult
-{
-    public bool Ok;
-    public object? Data;
-    public Exception? Err;
-    public Result? Result;
-    public Context? Ctx;
-}
-
-// FhHarness wires features (in init order) to a mock transport and a mini
-// operation pipeline.
-internal class FhHarness
-{
-    public ProjectNameSDK Client = null!;
-    public Utility Utility = null!;
-    public Context Rootctx = null!;
-    public string Base = "http://api.test";
-
-    private static string FhDefaultMethod(string op)
-    {
-        return op switch
-        {
-            "create" => "POST",
-            "update" => "PATCH",
-            "remove" => "DELETE",
-            _ => "GET",
-        };
-    }
-
-    private static string FhBuildUrl(Spec spec)
-    {
-        var keys = spec.Query.Where(kv => kv.Value != null)
-            .Select(kv => kv.Key).OrderBy(k => k, StringComparer.Ordinal).ToList();
-        var qs = string.Join("&", keys.Select(k =>
-            Uri.EscapeDataString(k) + "=" +
-            Uri.EscapeDataString(StructUtils.Stringify(spec.Query[k]))));
-        var url = spec.Base + spec.Path;
-        if (qs != "")
-        {
-            url += "?" + qs;
-        }
-        return url;
-    }
-
-    // Op runs one operation through the mini pipeline (mirrors the generated
-    // entity op code: hook, short-circuit, make*, hook, ...).
-    public FhOpResult Op(FhOpSpec o)
-    {
-        var entity = o.Entity == "" ? "widget" : o.Entity;
-        var opname = o.Op == "" ? "load" : o.Op;
-        var method = o.Method == "" ? FhDefaultMethod(opname) : o.Method;
-        var ctrl = o.Ctrl ?? new Dictionary<string, object?>();
-
-        var ctx = Utility.MakeContext(new Dictionary<string, object?>
-        {
-            ["opname"] = opname,
-            ["ctrl"] = ctrl,
-        }, Rootctx);
-        ctx.Op = new Operation(new Dictionary<string, object?>
-        {
-            ["entity"] = entity,
-            ["name"] = opname,
-        });
-
-        Utility.FeatureHook(ctx, "PostConstructEntity");
-
-        Utility.FeatureHook(ctx, "PrePoint");
-        if (ctx.Out.TryGetValue("point", out var pointOut) && pointOut is Exception perr)
-        {
-            return Fail(ctx, perr);
-        }
-
-        Utility.FeatureHook(ctx, "PreSpec");
-        var path = o.Path == "" ? "/" + entity : o.Path;
-        var headers = new Dictionary<string, object?>(o.Headers
-            ?? new Dictionary<string, object?>());
-        var query = new Dictionary<string, object?>(o.Query
-            ?? new Dictionary<string, object?>());
-        ctx.Spec = new Spec(new Dictionary<string, object?>
-        {
-            ["method"] = method,
-            ["base"] = Base,
-            ["path"] = path,
-            ["headers"] = headers,
-            ["query"] = query,
-            ["step"] = "start",
-        });
-        if (o.Body != null)
-        {
-            ctx.Spec.Body = o.Body;
-        }
-
-        Utility.FeatureHook(ctx, "PreRequest");
-        ctx.Spec.Url = FhBuildUrl(ctx.Spec);
-
-        var fetchdef = new Dictionary<string, object?>
-        {
-            ["url"] = ctx.Spec.Url,
-            ["method"] = ctx.Spec.Method,
-            ["headers"] = ctx.Spec.Headers,
-        };
-        if (ctx.Spec.Body != null)
-        {
-            fetchdef["body"] = ctx.Spec.Body;
-        }
-
-        object? response = null;
-        Exception? fetchErr = null;
-        if (ctx.Out.TryGetValue("request", out var reqOut) && reqOut != null)
-        {
-            response = reqOut;
-        }
-        else
-        {
-            try
-            {
-                response = Utility.Fetcher(ctx, ctx.Spec.Url, fetchdef);
-            }
-            catch (Exception ex)
-            {
-                fetchErr = ex;
-            }
-        }
-        if (response is Dictionary<string, object?> rm)
-        {
-            ctx.Response = new Response(rm);
-        }
-
-        Utility.FeatureHook(ctx, "PreResponse");
-        FhPopulateResult(ctx, response, fetchErr);
-        Utility.FeatureHook(ctx, "PreResult");
-        Utility.FeatureHook(ctx, "PreDone");
-
-        if (ctx.Result != null && ctx.Result.Ok)
-        {
-            return new FhOpResult
-            {
-                Ok = true,
-                Data = ctx.Result.Resdata,
-                Result = ctx.Result,
-                Ctx = ctx,
-            };
-        }
-
-        Exception err;
-        if (ctx.Result?.Err != null)
-        {
-            err = ctx.Result.Err;
-        }
-        else
-        {
-            err = ctx.MakeError("op_failed", "operation failed");
-        }
-        return Fail(ctx, err);
-    }
-
-    private FhOpResult Fail(Context ctx, Exception err)
-    {
-        ctx.Ctrl.Err = err;
-        Utility.FeatureHook(ctx, "PreUnexpected");
-        return new FhOpResult
-        {
-            Ok = false,
-            Err = err,
-            Result = ctx.Result,
-            Ctx = ctx,
-        };
-    }
-
-    private static void FhPopulateResult(Context ctx, object? response, Exception? fetchErr)
-    {
-        var result = new Result(new Dictionary<string, object?>());
-        ctx.Result = result;
-
-        if (fetchErr != null)
-        {
-            result.Err = fetchErr;
-            return;
-        }
-
-        if (response is not Dictionary<string, object?> rm)
-        {
-            result.Err = ctx.MakeError("request_no_response", "response: undefined");
-            return;
-        }
-
-        var resp = new Response(rm);
-        result.Status = resp.Status;
-        result.StatusText = resp.StatusText;
-        if (resp.Headers is Dictionary<string, object?> hm)
-        {
-            result.Headers = hm;
-        }
-        if (resp.JsonFunc != null)
-        {
-            result.Body = resp.JsonFunc();
-        }
-        result.Resdata = result.Body;
-
-        if (result.Status >= 400)
-        {
-            result.Err = ctx.MakeError("request_status",
-                $"request: {result.Status}: {result.StatusText}");
-        }
-        else if (resp.Err != null)
-        {
-            result.Err = resp.Err;
-        }
-        if (result.Err == null)
-        {
-            result.Ok = true;
-        }
-    }
-}
-
-internal static class Fh
-{
-    // HasFeature is true when this SDK was generated with the named feature.
-    public static bool HasFeature(string name)
-    {
-        var config = SdkConfig.MakeConfig();
-        return config.TryGetValue("feature", out var fraw) &&
-            fraw is Dictionary<string, object?> fm &&
-            fm.TryGetValue(name, out var f) && f != null;
-    }
-
-    public static bool SkipWithout(params string[] names)
-    {
-        return names.Any(name => !HasFeature(name));
-    }
-
-    // Response builds a transport-shaped response the pipeline understands.
-    public static Dictionary<string, object?> Response(int status, object? data,
-        Dictionary<string, object?>? headers)
-    {
-        var h = new Dictionary<string, object?>();
-        if (headers != null)
-        {
-            foreach (var kv in headers)
-            {
-                h[kv.Key.ToLowerInvariant()] = kv.Value;
-            }
-        }
-        return new Dictionary<string, object?>
-        {
-            ["status"] = status,
-            ["statusText"] = status >= 400 ? "ERR" : "OK",
-            ["body"] = "not-used",
-            ["json"] = (Func<object?>)(() => data),
-            ["headers"] = h,
-        };
-    }
-
-    // Make constructs the harness: a real (test-mode) client, an isolated
-    // utility whose fetcher is the mock server, and the requested features
-    // initialised against it. Fires PostConstruct once wiring is complete.
-    public static FhHarness Make(FetcherFunc? server,
-        params (BaseFeature f, Dictionary<string, object?>? options)[] features)
-    {
-        var client = ProjectNameSDK.TestSDK(null, null);
-        client.Features = new List<BaseFeature>();
-
-        var utility = client.GetUtility();
-        if (server == null)
-        {
-            var rec = new FhRecorder();
-            server = rec.Fetch;
-        }
-        utility.Fetcher = server;
-
-        var rootctx = utility.MakeContext(new Dictionary<string, object?>
-        {
-            ["client"] = client,
-            ["utility"] = utility,
-        }, client.GetRootCtx());
-
-        foreach (var (f, options) in features)
-        {
-            var fopts = new Dictionary<string, object?> { ["active"] = true };
-            if (options != null)
-            {
-                foreach (var kv in options)
-                {
-                    fopts[kv.Key] = kv.Value;
-                }
-            }
-            f.Init(rootctx, fopts);
-            client.Features.Add(f);
-        }
-
-        utility.FeatureHook(rootctx, "PostConstruct");
-
-        return new FhHarness
-        {
-            Client = client,
-            Utility = utility,
-            Rootctx = rootctx,
-        };
-    }
-
-    // ErrCode extracts the SDK error code, "" otherwise.
-    public static string ErrCode(Exception? err)
-    {
-        return err is ProjectNameError se ? se.Code : "";
-    }
-}
-
 // --- netsim -----------------------------------------------------------------
 
 public class FeatureNetsimTest

package/project/.sdk/tm/csharp/test/Runner.cs

@@ -71,8 +71,8 @@ public static class TestRunner
 
     public static Dictionary<string, object?> EnvOverride(Dictionary<string, object?> m)
     {
-        if (Environment.GetEnvironmentVariable("PROJECTNAME_TEST_LIVE") == "TRUE" ||
-            Environment.GetEnvironmentVariable("PROJECTNAME_TEST_OVERRIDE") == "TRUE")
+        if (Environment.GetEnvironmentVariable("PROJECTENV_TEST_LIVE") == "TRUE" ||
+            Environment.GetEnvironmentVariable("PROJECTENV_TEST_OVERRIDE") == "TRUE")
         {
             foreach (var key in m.Keys.ToList())
             {
@@ -98,10 +98,10 @@ public static class TestRunner
             }
         }
 
-        var explain = Environment.GetEnvironmentVariable("PROJECTNAME_TEST_EXPLAIN");
+        var explain = Environment.GetEnvironmentVariable("PROJECTENV_TEST_EXPLAIN");
         if (!string.IsNullOrEmpty(explain))
         {
-            m["PROJECTNAME_TEST_EXPLAIN"] = explain;
+            m["PROJECTENV_TEST_EXPLAIN"] = explain;
         }
 
         return m;

package/project/.sdk/tm/dart/lib/utility/MakeErrorUtility.dart

@@ -47,6 +47,10 @@ dynamic makeError(dynamic ctx, [dynamic err]) {
   sdkerr.result = clean(ctx, result);
   sdkerr.spec = clean(ctx, spec);
 
+  // Promote the HTTP status to the top level, so a consumer can branch on
+  // `err.status` / `err.notFound` instead of reaching into `err.result`.
+  sdkerr.status = null == result.status ? -1 : result.status;
+
   ctx.ctrl['err'] = sdkerr;
 
   // Fire PreUnexpected so observability features (metrics, telemetry, audit,

package/project/.sdk/tm/dart/test/utility.dart

@@ -34,8 +34,8 @@ String resolveTestPath(String rel) {
 Map<String, dynamic> envOverride(Map<String, dynamic> m) {
   final env = Platform.environment;
 
-  if ('TRUE' == env['PROJECTNAME_TEST_LIVE'] ||
-      'TRUE' == env['PROJECTNAME_TEST_OVERRIDE']) {
+  if ('TRUE' == env['PROJECTENV_TEST_LIVE'] ||
+      'TRUE' == env['PROJECTENV_TEST_OVERRIDE']) {
     for (final k in m.keys.toList()) {
       var envval = env[k];
       if (null != envval) {
@@ -45,8 +45,8 @@ Map<String, dynamic> envOverride(Map<String, dynamic> m) {
     }
   }
 
-  m['PROJECTNAME_TEST_EXPLAIN'] =
-      env['PROJECTNAME_TEST_EXPLAIN'] ?? m['PROJECTNAME_TEST_EXPLAIN'];
+  m['PROJECTENV_TEST_EXPLAIN'] =
+      env['PROJECTENV_TEST_EXPLAIN'] ?? m['PROJECTENV_TEST_EXPLAIN'];
 
   return m;
 }

package/project/.sdk/tm/elixir/VERSION

@@ -1 +1 @@
-0.1.0
+PROJECTVERSION

package/project/.sdk/tm/elixir/lib/projectname/entity_base.ex

@@ -39,6 +39,32 @@ defmodule ProjectName.EntityBase do
 
   def get_name(ent), do: S.getprop(ent, "_name")
 
+  # Every operation resolves to the ENTITY, not the raw data — the record is
+  # reached through data_get/1. `run_op` returns the terminal result value, so
+  # the op hands that value back only when the pipeline FAILED (the error
+  # shape is utility-configurable); on success it hands back the entity.
+  # See AGENTS.md "Entity operations return ENTITIES".
+  def op_return(ent, ctx, out) do
+    result = S.getprop(ctx, "result")
+
+    if result != nil and S.getprop(result, "ok") == true do
+      ent
+    else
+      out
+    end
+  end
+
+  # `remove` resolves to the entity, marked. The instance KEEPS the data it
+  # held — a caller can still read what was deleted — but it is no longer a
+  # live record.
+  def mark_deleted(ent) do
+    S.setprop(ent, "_deleted", true)
+    ent
+  end
+
+  def deleted(ent), do: S.getprop(ent, "_deleted") == true
+
+
   def make(ent) do
     module = S.getprop(ent, "_module")
     client = S.getprop(ent, "_client")

package/project/.sdk/tm/go/VERSION

@@ -1 +1 @@
-0.0.1
+PROJECTVERSION

package/project/.sdk/tm/go/core/types.go

@@ -28,6 +28,12 @@ type Entity interface {
 	Make() Entity
 	Data(data ...any) any
 	Match(match ...any) any
+
+	// Every operation resolves to the entity; Remove additionally marks it.
+	// The instance keeps the data it held — a caller can still read what was
+	// deleted — but it is no longer a live record.
+	MarkDeleted()
+	Deleted() bool
 }
 
 type ProjectNameEntity interface {