@voxgig/sdkgen 1.5.1 → 2.0.1

package/project/.sdk/tm/py/{core → pkg/core}/result.py

@@ -1,7 +1,7 @@
 # ProjectName SDK result
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 
 class ProjectNameResult:

package/project/.sdk/tm/py/{core → pkg/core}/utility_type.py

@@ -33,6 +33,8 @@ class ProjectNameUtility:
         self.prepare_method = None
         self.prepare_params = None
         self.prepare_path = None
+        self.graphql_body = None
+        self.graphql_errors = None
         self.prepare_query = None
         self.result_basic = None
         self.result_body = None

package/project/.sdk/tm/py/{feature → pkg/feature}/audit_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Audit trail. Emits a structured record for every operation — who (actor),

package/project/.sdk/tm/py/{feature → pkg/feature}/cache_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Response caching for safe (read) requests. Wraps the active transport and

package/project/.sdk/tm/py/{feature → pkg/feature}/clienttrack_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import random
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Client tracking. Establishes a stable per-client session id at

package/project/.sdk/tm/py/{feature → pkg/feature}/debug_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Request/response capture for debugging. Records a bounded ring buffer of

package/project/.sdk/tm/py/{feature → pkg/feature}/idempotency_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import random
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Idempotency keys for mutating operations. Adds an `Idempotency-Key`

package/project/.sdk/tm/py/{feature → pkg/feature}/log_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import sys
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 class ProjectNameLogFeature(ProjectNameBaseFeature):

package/project/.sdk/tm/py/{feature → pkg/feature}/metrics_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Statistics capture. Records per-operation counters and latency for every

package/project/.sdk/tm/py/{feature → pkg/feature}/netsim_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Network behaviour simulation. Wraps the active transport (the live

package/project/.sdk/tm/py/{feature → pkg/feature}/paging_feature.py

@@ -3,7 +3,9 @@
 from __future__ import annotations
 import re
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
+
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Pagination support for list operations. On the way out (PreRequest) it
@@ -53,6 +55,14 @@ class ProjectNamePagingFeature(ProjectNameBaseFeature):
         if not isinstance(paging, dict):
             paging = {}
 
+        # GraphQL paginates through operation VARIABLES, not the query
+        # string. This hook runs after make_spec, so spec.body already holds
+        # the { query, variables } envelope, and before make_fetch_def
+        # serialises it.
+        if "graphql" == vs.getprop(ctx.point, "kind"):
+            self._graphql_pre_request(ctx, paging)
+            return
+
         if paging.get("cursor") is not None:
             spec.query[cursor_param] = paging["cursor"]
         elif spec.query.get(page_param) is None:
@@ -64,6 +74,39 @@ class ProjectNamePagingFeature(ProjectNameBaseFeature):
         if self.options.get("limit") is not None and spec.query.get(limit_param) is None:
             spec.query[limit_param] = self.options.get("limit")
 
+    # Relay pagination: the cursor is the `after` variable (or whatever the
+    # model named it), and the page size is `first`.
+    def _graphql_pre_request(self, ctx, paging):
+        body = ctx.spec.body
+        if not isinstance(body, dict):
+            return
+
+        variables = body.get("variables")
+        if not isinstance(variables, dict):
+            variables = {}
+            body["variables"] = variables
+
+        after_var = self.options.get("afterVar") or "after"
+        first_var = self.options.get("firstVar") or "first"
+
+        # Only bind variables the operation actually declares, or the server
+        # rejects the document.
+        declared = set()
+        varlist = vs.getpath(ctx.point, "graphql.vars")
+        if isinstance(varlist, list):
+            for v in varlist:
+                name = vs.getprop(v, "name")
+                if name is not None:
+                    declared.add(name)
+
+        if paging.get("cursor") is not None and after_var in declared:
+            variables[after_var] = paging["cursor"]
+
+        limit = self.options.get("limit")
+        if (limit is not None and variables.get(first_var) is None
+                and first_var in declared):
+            variables[first_var] = limit
+
     def PreResult(self, ctx):
         if not self.active:
             return
@@ -92,6 +135,37 @@ class ProjectNamePagingFeature(ProjectNameBaseFeature):
             if m:
                 paging["next"] = m.group(1)
 
+        # Set when the response states hasMore outright, rather than leaving
+        # it to be inferred from the presence of a cursor.
+        explicit_more = False
+
+        # Relay connections carry the cursor in pageInfo, at the path the
+        # model recorded for this op.
+        page = vs.getpath(ctx.point, "graphql.page")
+        if isinstance(page, dict) and isinstance(body, dict):
+            # `connpath` locates the connection object inside the response
+            # envelope (data.<field>); the cursor/more paths are relative
+            # to it.
+            connpath = page.get("connpath")
+            conn = body
+            if isinstance(connpath, str) and "" != connpath:
+                sub = vs.getpath(body, connpath)
+                if sub is not None:
+                    conn = sub
+
+            cursorpath = page.get("cursor")
+            if isinstance(cursorpath, str) and "" != cursorpath:
+                cursor = vs.getpath(conn, cursorpath)
+                if cursor is not None:
+                    paging["cursor"] = cursor
+
+            morepath = page.get("more")
+            if isinstance(morepath, str) and "" != morepath:
+                more = vs.getpath(conn, morepath)
+                if isinstance(more, bool):
+                    paging["hasMore"] = more
+                    explicit_more = True
+
         # Body-level cursors.
         if isinstance(body, dict):
             if body.get("next") is not None:
@@ -102,11 +176,18 @@ class ProjectNamePagingFeature(ProjectNameBaseFeature):
                 paging["cursor"] = body["nextCursor"]
             if isinstance(body.get("hasMore"), bool):
                 paging["hasMore"] = body["hasMore"]
-
-        paging["hasMore"] = (paging["hasMore"]
-                             or paging["next"] is not None
-                             or paging["cursor"] is not None
-                             or paging["nextPage"] is not None)
+                explicit_more = True
+
+        # Cursor presence only INFERS another page. When the server stated
+        # the answer outright — relay's `hasNextPage: false`, or a body
+        # `hasMore` — that wins: a final page normally carries both an end
+        # cursor and hasNextPage false, and inferring from the cursor there
+        # would send the caller back for a page that does not exist, forever.
+        if not explicit_more:
+            paging["hasMore"] = (paging["hasMore"]
+                                 or paging["next"] is not None
+                                 or paging["cursor"] is not None
+                                 or paging["nextPage"] is not None)
 
         result.paging = paging
 

package/project/.sdk/tm/py/{feature → pkg/feature}/proxy_feature.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import os
 import re
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Outbound HTTP(S) proxy support. Wraps the active transport and attaches

package/project/.sdk/tm/py/{feature → pkg/feature}/ratelimit_feature.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import math
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Client-side rate limiting via a token bucket. Each request consumes a

package/project/.sdk/tm/py/{feature → pkg/feature}/rbac_feature.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Client-side role/permission enforcement. Before an operation resolves its

package/project/.sdk/tm/py/{feature → pkg/feature}/retry_feature.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import random
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Automatic retry of transient failures with exponential backoff and

package/project/.sdk/tm/py/{feature → pkg/feature}/streaming_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Streaming result support. For list-style operations it attaches a

package/project/.sdk/tm/py/{feature → pkg/feature}/telemetry_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Distributed-tracing telemetry. Opens a span per operation (PrePoint),

package/project/.sdk/tm/py/{feature → pkg/feature}/test_feature.py

@@ -5,8 +5,8 @@ import re
 import random
 import time
 
-from utility.voxgig_struct import voxgig_struct as vs
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # The `body.<key>` form of an op's response transform: the mock wraps its

package/project/.sdk/tm/py/{feature → pkg/feature}/timeout_feature.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 import time
 
-from feature.base_feature import ProjectNameBaseFeature
+from projectname_sdk.feature.base_feature import ProjectNameBaseFeature
 
 
 # Per-request timeout. Wraps the active transport with a deadline of `ms`

package/project/.sdk/tm/py/{utility → pkg/utility}/feature_init.py

@@ -1,6 +1,6 @@
 # ProjectName SDK utility: feature_init
 
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 
 def feature_init_util(ctx, f):

package/project/.sdk/tm/py/{utility → pkg/utility}/fetcher.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 import json
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 
 # Default User-Agent — many CDNs (notably Cloudflare) reject requests with

package/project/.sdk/tm/py/pkg/utility/graphql.py

@@ -0,0 +1,145 @@
+# ProjectName SDK utility: graphql
+
+# GraphQL transport. API-INDEPENDENT: every GraphQL SDK this generator
+# produces uses this file unchanged. The API-specific part — which
+# operations exist and what each one's document is — is model data,
+# computed once by apidef and emitted into Config.
+#
+# Two jobs:
+#
+#   graphql_body   — build { query, variables } for a point, binding the
+#                    op's arguments to the document's declared variables.
+#
+#   graphql_errors — lift a GraphQL failure into an SDK error. GraphQL
+#                    reports failures as a top-level `errors` array under
+#                    HTTP 200, so the status-driven path in result_basic
+#                    never sees them.
+
+from __future__ import annotations
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
+
+
+# Content type every GraphQL-over-HTTP request uses.
+GRAPHQL_CONTENT_TYPE = "application/json"
+
+
+def graphql_error_code(gqlerr):
+    """Map a GraphQL error to the same error codes the HTTP path produces,
+    so a caller handles auth or rate limiting identically on both
+    transports. Servers put the machine-readable code in
+    `extensions.code`; Linear-style APIs use `extensions.type`."""
+    ext = vs.getprop(gqlerr, "extensions") or {}
+
+    raw = vs.getprop(ext, "code") or vs.getprop(ext, "type") or ""
+    raw = str(raw).upper()
+
+    if "AUTH" in raw or "FORBIDDEN" in raw or "UNAUTHENTICATED" in raw:
+        return "request_auth"
+    if "RATELIMIT" in raw or "RATE_LIMIT" in raw or "TOO_MANY" in raw:
+        return "request_ratelimit"
+    if "BAD_USER_INPUT" in raw or "VALIDATION" in raw or "INVALID" in raw:
+        return "request_invalid"
+
+    return "request_graphql"
+
+
+def graphql_body_util(ctx):
+    """Build the request body for a GraphQL point.
+
+    Variables come from the op's own arguments: a named variable binds to
+    the like-named argument (`from`), and the input-object variable (empty
+    `from`) takes the request data as a whole — which is what makes a
+    generated create/update call look exactly like its REST equivalent."""
+    point = ctx.point
+    gql = vs.getprop(point, "graphql")
+
+    if not isinstance(gql, dict):
+        return None
+
+    # reqmatch/reqdata hold the caller's arguments for THIS call; data/match
+    # hold the entity's current state. Which pair depends on whether the op
+    # takes match or data input. A named variable falls back to the current
+    # state, so updating a loaded entity with just {title} still binds the
+    # stored id the mutation requires.
+    reqsrc, datasrc = ctx.reqmatch, ctx.match
+    if ctx.op is not None and getattr(ctx.op, "input", "match") == "data":
+        reqsrc, datasrc = ctx.reqdata, ctx.data
+    if not isinstance(reqsrc, dict):
+        reqsrc = {}
+    if not isinstance(datasrc, dict):
+        datasrc = {}
+
+    variables = {}
+
+    varlist = vs.getprop(gql, "vars")
+    if not isinstance(varlist, list):
+        varlist = []
+
+    for spec in varlist:
+        if not isinstance(spec, dict):
+            continue
+
+        name = vs.getprop(spec, "name")
+        frm = vs.getprop(spec, "from")
+
+        if frm is None or frm == "":
+            # The input object IS the request body. Strip the action
+            # selector, which is an SDK-side point discriminator, not an
+            # API field.
+            variables[name] = {
+                k: v for k, v in reqsrc.items() if k != "$action"
+            }
+            continue
+
+        # Only send variables the caller actually supplied: sending an
+        # explicit null would clear a field on many APIs.
+        val = vs.getprop(reqsrc, frm)
+        if val is None:
+            val = vs.getprop(datasrc, frm)
+        if val is not None:
+            variables[name] = val
+
+    return {
+        "query": vs.getprop(gql, "doc"),
+        "variables": variables,
+    }
+
+
+def graphql_errors_util(ctx):
+    """Inspect a decoded GraphQL response body and record a failure when
+    the server reported one. Returns True when an error was recorded.
+
+    Partial data (`data` alongside `errors`) is treated as failure: the
+    REST surface has no partial-success concept, and silently returning
+    half an object would be worse than failing. The raw envelope stays
+    available on the result for callers that need it."""
+    result = ctx.result
+    point = ctx.point
+
+    if result is None or point is None:
+        return False
+
+    if vs.getprop(point, "kind") != "graphql":
+        return False
+
+    errors = vs.getprop(result.body, "errors")
+    if not isinstance(errors, list) or 0 == len(errors):
+        return False
+
+    first = errors[0]
+    msg = vs.getprop(first, "message") or "graphql error"
+    if 1 < len(errors):
+        msg = msg + " (+" + str(len(errors) - 1) + " more)"
+
+    err = ctx.make_error(graphql_error_code(first), "graphql: " + msg)
+
+    # Keep the full error list reachable for diagnostics.
+    try:
+        err.graphql = errors
+    except Exception:
+        pass
+
+    result.err = err
+    result.ok = False
+
+    return True

package/project/.sdk/tm/py/{utility → pkg/utility}/make_context.py

@@ -1,6 +1,6 @@
 # ProjectName SDK utility: make_context
 
-from core.context import ProjectNameContext
+from projectname_sdk.core.context import ProjectNameContext
 
 
 def make_context_util(ctxmap, basectx):

package/project/.sdk/tm/py/{utility → pkg/utility}/make_error.py

@@ -1,15 +1,15 @@
 # ProjectName SDK utility: make_error
 
 from __future__ import annotations
-from core.operation import ProjectNameOperation
-from core.result import ProjectNameResult
-from core.control import ProjectNameControl
-from core.error import ProjectNameError
+from projectname_sdk.core.operation import ProjectNameOperation
+from projectname_sdk.core.result import ProjectNameResult
+from projectname_sdk.core.control import ProjectNameControl
+from projectname_sdk.core.error import ProjectNameError
 
 
 def make_error_util(ctx, err):
     if ctx is None:
-        from core.context import ProjectNameContext
+        from projectname_sdk.core.context import ProjectNameContext
         ctx = ProjectNameContext({}, None)
 
     op = ctx.op

package/project/.sdk/tm/py/{utility → pkg/utility}/make_fetch_def.py

@@ -1,7 +1,7 @@
 # ProjectName SDK utility: make_fetch_def
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 
 def make_fetch_def_util(ctx):
@@ -10,7 +10,7 @@ def make_fetch_def_util(ctx):
         return None, ctx.make_error("fetchdef_no_spec",
             "Expected context spec property to be defined.")
 
-    from core.result import ProjectNameResult
+    from projectname_sdk.core.result import ProjectNameResult
     if ctx.result is None:
         ctx.result = ProjectNameResult({})
 

package/project/.sdk/tm/py/{utility → pkg/utility}/make_options.py

@@ -1,7 +1,7 @@
 # ProjectName SDK utility: make_options
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 
 def make_options_util(ctx):
@@ -58,7 +58,7 @@ def make_options_util(ctx):
         },
         "allow": {
             "method": "GET,PUT,POST,PATCH,DELETE,OPTIONS",
-            "op": "create,update,load,list,remove,command,direct",
+            "op": "create,update,load,list,remove,command,direct,graphql",
         },
         "entity": {
             "`$CHILD`": {

package/project/.sdk/tm/py/{utility → pkg/utility}/make_point.py

@@ -1,8 +1,8 @@
 # ProjectName SDK utility: make_point
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
-from core.helpers import to_map
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.core.helpers import to_map
 
 
 def make_point_util(ctx):

package/project/.sdk/tm/py/{utility → pkg/utility}/make_request.py

@@ -1,8 +1,8 @@
 # ProjectName SDK utility: make_request
 
 from __future__ import annotations
-from core.response import ProjectNameResponse
-from core.result import ProjectNameResult
+from projectname_sdk.core.response import ProjectNameResponse
+from projectname_sdk.core.result import ProjectNameResult
 
 
 def make_request_util(ctx):

package/project/.sdk/tm/py/{utility → pkg/utility}/make_response.py

@@ -29,6 +29,12 @@ def make_response_util(ctx):
     utility.result_basic(ctx)
     utility.result_headers(ctx)
     utility.result_body(ctx)
+
+    # GraphQL reports failures as a top-level `errors` array under HTTP
+    # 200, so result_basic's status check never sees them. Lift them here,
+    # before the response transform tries to unwrap data that is not there.
+    utility.graphql_errors(ctx)
+
     utility.transform_response(ctx)
 
     if result.err is None:

package/project/.sdk/tm/py/{utility → pkg/utility}/make_spec.py

@@ -1,8 +1,9 @@
 # ProjectName SDK utility: make_spec
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
-from core.spec import ProjectNameSpec
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.core.spec import ProjectNameSpec
+from projectname_sdk.utility.graphql import GRAPHQL_CONTENT_TYPE
 
 
 def make_spec_util(ctx):
@@ -58,8 +59,22 @@ def make_spec_util(ctx):
     ctx.spec.params = utility.prepare_params(ctx)
     ctx.spec.query = utility.prepare_query(ctx)
     ctx.spec.headers = utility.prepare_headers(ctx)
-    ctx.spec.body = utility.prepare_body(ctx)
-    ctx.spec.path = utility.prepare_path(ctx)
+
+    if "graphql" == vs.getprop(point, "kind"):
+        # GraphQL addresses one endpoint: no path parts, no query string,
+        # and the body carries the operation. prepare_body is skipped
+        # deliberately — it only emits a body for data-input ops, whereas
+        # every GraphQL op posts one, including load/list/remove.
+        ctx.spec.body = utility.graphql_body(ctx)
+        ctx.spec.path = ""
+        # prepare_query already copied the op's match arguments into the
+        # query string. Those same values are bound as operation
+        # variables, so leaving them would send /graphql?id=i1.
+        ctx.spec.query = {}
+        ctx.spec.headers["content-type"] = GRAPHQL_CONTENT_TYPE
+    else:
+        ctx.spec.body = utility.prepare_body(ctx)
+        ctx.spec.path = utility.prepare_path(ctx)
 
     if ctx.ctrl.explain is not None:
         ctx.ctrl.explain["spec"] = ctx.spec

package/project/.sdk/tm/py/{utility → pkg/utility}/make_url.py

@@ -1,7 +1,7 @@
 # ProjectName SDK utility: make_url
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 
 def make_url_util(ctx):

package/project/.sdk/tm/py/{utility → pkg/utility}/param.py

@@ -1,8 +1,8 @@
 # ProjectName SDK utility: param
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
-from core.helpers import to_map
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.core.helpers import to_map
 
 
 def param_util(ctx, paramdef):

package/project/.sdk/tm/py/{utility → pkg/utility}/prepare_auth.py

@@ -1,7 +1,7 @@
 # ProjectName SDK utility: prepare_auth
 
 from __future__ import annotations
-from utility.voxgig_struct import voxgig_struct as vs
+from projectname_sdk.utility.voxgig_struct import voxgig_struct as vs
 
 HEADER_AUTH = "authorization"
 OPTION_APIKEY = "apikey"