@voxgig/sdkgen 0.35.2 → 0.36.0

package/project/.sdk/tm/php/utility/MakeOptions.php

@@ -0,0 +1,98 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_options
+
+class ProjectNameMakeOptions
+{
+    private static function to_array_deep(mixed $val): mixed
+    {
+        if ($val instanceof \Closure) {
+            return $val;
+        }
+        if (is_object($val)) {
+            $val = (array)$val;
+        }
+        if (is_array($val)) {
+            foreach ($val as $k => $v) {
+                if (is_object($v) || is_array($v)) {
+                    $val[$k] = self::to_array_deep($v);
+                }
+            }
+        }
+        return $val;
+    }
+
+    public static function call(ProjectNameContext $ctx): array
+    {
+        $options = $ctx->options ?? [];
+
+        $custom_utils = \Voxgig\Struct\Struct::getprop($options, 'utility');
+        if ((is_array($custom_utils) || is_object($custom_utils)) && $ctx->utility) {
+            foreach ((array)$custom_utils as $k => $v) {
+                $ctx->utility->custom[$k] = $v;
+            }
+        }
+
+        // Preserve system.fetch before merge/validate.
+        $sys_fetch = \Voxgig\Struct\Struct::getpath($options, 'system.fetch');
+
+        $opts = \Voxgig\Struct\Struct::clone($options);
+        $opts = self::to_array_deep($opts);
+        if (!is_array($opts)) {
+            $opts = [];
+        }
+
+        $config = $ctx->config ?? [];
+        $cfgopts = isset($config['options']) && is_array($config['options']) ? $config['options'] : [];
+
+        $optspec = [
+            'apikey' => '',
+            'base' => 'http://localhost:8000',
+            'prefix' => '',
+            'suffix' => '',
+            'auth' => ['prefix' => ''],
+            'headers' => ['`$CHILD`' => '`$STRING`'],
+            'allow' => [
+                'method' => 'GET,PUT,POST,PATCH,DELETE,OPTIONS',
+                'op' => 'create,update,load,list,remove,command,direct',
+            ],
+            'entity' => ['`$CHILD`' => ['`$OPEN`' => true, 'active' => false, 'alias' => (object)[]]],
+            'feature' => ['`$CHILD`' => ['`$OPEN`' => true, 'active' => false]],
+            'utility' => (object)[],
+            'system' => (object)[],
+            'test' => ['active' => false, 'entity' => ['`$OPEN`' => true]],
+            'clean' => ['keys' => 'key,token,id'],
+        ];
+
+        $merged = \Voxgig\Struct\Struct::merge([(object)[], $cfgopts, $opts]);
+        $validated = \Voxgig\Struct\Struct::validate($merged, $optspec);
+        $opts = self::to_array_deep($validated);
+        if (!is_array($opts)) {
+            $opts = [];
+        }
+
+        if ($sys_fetch) {
+            if (!is_array($opts['system'] ?? null)) {
+                $opts['system'] = [];
+            }
+            $opts['system']['fetch'] = $sys_fetch;
+        }
+
+        $clean_keys = \Voxgig\Struct\Struct::getpath($opts, 'clean.keys');
+        if (!is_string($clean_keys)) {
+            $clean_keys = 'key,token,id';
+        }
+        $parts = array_filter(array_map('trim', explode(',', $clean_keys)), function ($p) {
+            return $p !== '';
+        });
+        $parts = array_map(function ($p) {
+            return \Voxgig\Struct\Struct::escre($p);
+        }, $parts);
+        $keyre = implode('|', $parts);
+        $derived = ['clean' => $keyre === '' ? [] : ['keyre' => $keyre]];
+        $opts['__derived__'] = $derived;
+
+        return $opts;
+    }
+}

package/project/.sdk/tm/php/utility/MakePoint.php

@@ -0,0 +1,87 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_point
+
+require_once __DIR__ . '/../core/Helpers.php';
+
+class ProjectNameMakePoint
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        if (isset($ctx->out['point'])) {
+            $ctx->point = $ctx->out['point'];
+            return [$ctx->point, null];
+        }
+
+        $op = $ctx->op;
+        $options = $ctx->options;
+
+        $allow_op = \Voxgig\Struct\Struct::getpath($options, 'allow.op') ?? '';
+        if (strpos($allow_op, $op->name) === false) {
+            return [null, $ctx->make_error('point_op_allow',
+                "Operation \"{$op->name}\" not allowed by SDK option allow.op value: \"{$allow_op}\"")];
+        }
+
+        if (empty($op->points)) {
+            return [null, $ctx->make_error('point_no_points',
+                "Operation \"{$op->name}\" has no endpoint definitions.")];
+        }
+
+        if (count($op->points) === 1) {
+            $ctx->point = $op->points[0];
+        } else {
+            $reqselector = $op->input === 'data' ? $ctx->reqdata : $ctx->reqmatch;
+            $selector = $op->input === 'data' ? $ctx->data : $ctx->match;
+
+            $point = null;
+            foreach ($op->points as $p) {
+                $point = $p;
+                $select_def = ProjectNameHelpers::to_map(\Voxgig\Struct\Struct::getprop($p, 'select'));
+                $found = true;
+
+                if ($selector && $select_def) {
+                    $exist = \Voxgig\Struct\Struct::getprop($select_def, 'exist');
+                    if (is_array($exist)) {
+                        foreach ($exist as $ek) {
+                            $rv = \Voxgig\Struct\Struct::getprop($reqselector, (string)$ek);
+                            $sv = \Voxgig\Struct\Struct::getprop($selector, (string)$ek);
+                            if ($rv === null && $sv === null) {
+                                $found = false;
+                                break;
+                            }
+                        }
+                    }
+                }
+
+                if ($found) {
+                    $req_action = \Voxgig\Struct\Struct::getprop($reqselector, '$action');
+                    $select_action = \Voxgig\Struct\Struct::getprop($select_def, '$action');
+                    if ($req_action !== $select_action) {
+                        $found = false;
+                    }
+                }
+
+                if ($found) {
+                    break;
+                }
+            }
+
+            if ($reqselector) {
+                $req_action = \Voxgig\Struct\Struct::getprop($reqselector, '$action');
+                if ($req_action && $point) {
+                    $point_select = ProjectNameHelpers::to_map(\Voxgig\Struct\Struct::getprop($point, 'select'));
+                    $point_action = \Voxgig\Struct\Struct::getprop($point_select, '$action');
+                    if ($req_action !== $point_action) {
+                        return [null, $ctx->make_error('point_action_invalid',
+                            "Operation \"{$op->name}\" action \"" . \Voxgig\Struct\Struct::stringify($req_action) . "\" is not valid.")];
+                    }
+                }
+            }
+
+            $ctx->point = $point;
+        }
+
+        return [$ctx->point, null];
+    }
+}

package/project/.sdk/tm/php/utility/MakeRequest.php

@@ -0,0 +1,57 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_request
+
+require_once __DIR__ . '/../core/Response.php';
+require_once __DIR__ . '/../core/Result.php';
+
+class ProjectNameMakeRequest
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        if (isset($ctx->out['request'])) {
+            return [$ctx->out['request'], null];
+        }
+
+        $spec = $ctx->spec;
+        $utility = $ctx->utility;
+        $response = new ProjectNameResponse([]);
+        $result = new ProjectNameResult([]);
+        $ctx->result = $result;
+
+        if (!$spec) {
+            return [null, $ctx->make_error('request_no_spec', 'Expected context spec property to be defined.')];
+        }
+
+        [$fetchdef, $err] = ($utility->make_fetch_def)($ctx);
+        if ($err) {
+            $response->err = $err;
+            $ctx->response = $response;
+            $spec->step = 'postrequest';
+            return [$response, null];
+        }
+
+        if ($ctx->ctrl->explain) {
+            $ctx->ctrl->explain['fetchdef'] = $fetchdef;
+        }
+
+        $spec->step = 'prerequest';
+        $url = $fetchdef['url'] ?? '';
+        [$fetched, $fetch_err] = ($utility->fetcher)($ctx, $url, $fetchdef);
+
+        if ($fetch_err) {
+            $response->err = $fetch_err;
+        } elseif ($fetched === null) {
+            $response = new ProjectNameResponse(['err' => $ctx->make_error('request_no_response', 'response: undefined')]);
+        } elseif (is_array($fetched)) {
+            $response = new ProjectNameResponse($fetched);
+        } else {
+            $response->err = $ctx->make_error('request_invalid_response', 'response: invalid type');
+        }
+
+        $spec->step = 'postrequest';
+        $ctx->response = $response;
+        return [$response, null];
+    }
+}

package/project/.sdk/tm/php/utility/MakeResponse.php

@@ -0,0 +1,43 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_response
+
+class ProjectNameMakeResponse
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        if (isset($ctx->out['response'])) {
+            return [$ctx->out['response'], null];
+        }
+        $utility = $ctx->utility;
+        $spec = $ctx->spec;
+        $result = $ctx->result;
+        $response = $ctx->response;
+
+        if (!$spec) {
+            return [null, $ctx->make_error('response_no_spec', 'Expected context spec property to be defined.')];
+        }
+        if (!$response) {
+            return [null, $ctx->make_error('response_no_response', 'Expected context response property to be defined.')];
+        }
+        if (!$result) {
+            return [null, $ctx->make_error('response_no_result', 'Expected context result property to be defined.')];
+        }
+
+        $spec->step = 'response';
+        ($utility->result_basic)($ctx);
+        ($utility->result_headers)($ctx);
+        ($utility->result_body)($ctx);
+        ($utility->transform_response)($ctx);
+
+        if ($result->err === null) {
+            $result->ok = true;
+        }
+        if ($ctx->ctrl->explain) {
+            $ctx->ctrl->explain['result'] = $result;
+        }
+
+        return [$response, null];
+    }
+}

package/project/.sdk/tm/php/utility/MakeResult.php

@@ -0,0 +1,50 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_result
+
+class ProjectNameMakeResult
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        if (isset($ctx->out['result'])) {
+            return [$ctx->out['result'], null];
+        }
+        $utility = $ctx->utility;
+        $op = $ctx->op;
+        $entity = $ctx->entity;
+        $spec = $ctx->spec;
+        $result = $ctx->result;
+
+        if (!$spec) {
+            return [null, $ctx->make_error('result_no_spec', 'Expected context spec property to be defined.')];
+        }
+        if (!$result) {
+            return [null, $ctx->make_error('result_no_result', 'Expected context result property to be defined.')];
+        }
+
+        $spec->step = 'result';
+        ($utility->transform_response)($ctx);
+
+        if ($op->name === 'list') {
+            $resdata = $result->resdata;
+            $result->resdata = [];
+            if (is_array($resdata) && !empty($resdata) && $entity) {
+                $entities = [];
+                foreach ($resdata as $entry) {
+                    $ent = $entity->make();
+                    if (is_array($entry)) {
+                        $ent->data_set($entry);
+                    }
+                    $entities[] = $ent;
+                }
+                $result->resdata = $entities;
+            }
+        }
+
+        if ($ctx->ctrl->explain) {
+            $ctx->ctrl->explain['result'] = $result;
+        }
+        return [$result, null];
+    }
+}

package/project/.sdk/tm/php/utility/MakeSpec.php

@@ -0,0 +1,64 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_spec
+
+require_once __DIR__ . '/../core/Spec.php';
+
+class ProjectNameMakeSpec
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        if (isset($ctx->out['spec'])) {
+            $ctx->spec = $ctx->out['spec'];
+            return [$ctx->spec, null];
+        }
+
+        $point = $ctx->point;
+        $options = $ctx->options;
+        $utility = $ctx->utility;
+
+        $base = \Voxgig\Struct\Struct::getprop($options, 'base') ?? '';
+        $prefix = \Voxgig\Struct\Struct::getprop($options, 'prefix') ?? '';
+        $suffix = \Voxgig\Struct\Struct::getprop($options, 'suffix') ?? '';
+
+        $parts = [];
+        if ($point) {
+            $p = \Voxgig\Struct\Struct::getprop($point, 'parts');
+            if (is_array($p)) {
+                $parts = $p;
+            }
+        }
+
+        $ctx->spec = new ProjectNameSpec([
+            'base' => $base, 'prefix' => $prefix, 'parts' => $parts,
+            'suffix' => $suffix, 'step' => 'start',
+        ]);
+
+        $ctx->spec->method = ($utility->prepare_method)($ctx);
+
+        $allow_method = \Voxgig\Struct\Struct::getpath($options, 'allow.method') ?? '';
+        if (strpos($allow_method, $ctx->spec->method) === false) {
+            return [null, $ctx->make_error('spec_method_allow',
+                "Method \"{$ctx->spec->method}\" not allowed by SDK option allow.method value: \"{$allow_method}\"")];
+        }
+
+        $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 ($ctx->ctrl->explain) {
+            $ctx->ctrl->explain['spec'] = $ctx->spec;
+        }
+
+        [$spec, $err] = ($utility->prepare_auth)($ctx);
+        if ($err) {
+            return [null, $err];
+        }
+
+        $ctx->spec = $spec;
+        return [$spec, null];
+    }
+}

package/project/.sdk/tm/php/utility/MakeUrl.php

@@ -0,0 +1,41 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: make_url
+
+class ProjectNameMakeUrl
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        $spec = $ctx->spec;
+        $result = $ctx->result;
+
+        if (!$spec) {
+            return ['', $ctx->make_error('url_no_spec', 'Expected context spec property to be defined.')];
+        }
+        if (!$result) {
+            return ['', $ctx->make_error('url_no_result', 'Expected context result property to be defined.')];
+        }
+
+        $url = \Voxgig\Struct\Struct::join([$spec->base, $spec->prefix, $spec->path, $spec->suffix], '/', true);
+        $resmatch = [];
+
+        $param_items = \Voxgig\Struct\Struct::items($spec->params);
+        if ($param_items) {
+            foreach ($param_items as $item) {
+                $key = $item[0];
+                $val = $item[1];
+                if ($val !== null && is_string($key)) {
+                    $placeholder = '{' . $key . '}';
+                    $val_str = is_string($val) ? $val : (string)$val;
+                    $encoded = \Voxgig\Struct\Struct::escurl($val_str);
+                    $url = str_replace($placeholder, $encoded, $url);
+                    $resmatch[$key] = $val;
+                }
+            }
+        }
+
+        $result->resmatch = $resmatch;
+        return [$url, null];
+    }
+}

package/project/.sdk/tm/php/utility/Param.php

@@ -0,0 +1,66 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: param
+
+require_once __DIR__ . '/../core/Helpers.php';
+
+class ProjectNameParam
+{
+    public static function call(ProjectNameContext $ctx, mixed $paramdef): mixed
+    {
+        $point = $ctx->point;
+        $spec = $ctx->spec;
+        $match_val = $ctx->match;
+        $reqmatch = $ctx->reqmatch;
+        $data = $ctx->data;
+        $reqdata = $ctx->reqdata;
+
+        $pt = \Voxgig\Struct\Struct::typify($paramdef);
+        if ((\Voxgig\Struct\Struct::T_string & $pt) > 0) {
+            $key = $paramdef;
+        } else {
+            $k = \Voxgig\Struct\Struct::getprop($paramdef, 'name');
+            $key = is_string($k) ? $k : '';
+        }
+
+        $akey = '';
+        if ($point) {
+            $alias_map = ProjectNameHelpers::to_map(\Voxgig\Struct\Struct::getprop($point, 'alias'));
+            if ($alias_map) {
+                $ak = \Voxgig\Struct\Struct::getprop($alias_map, $key);
+                if (is_string($ak)) {
+                    $akey = $ak;
+                }
+            }
+        }
+
+        $val = \Voxgig\Struct\Struct::getprop($reqmatch, $key);
+        if ($val === null) {
+            $val = \Voxgig\Struct\Struct::getprop($match_val, $key);
+        }
+
+        if ($val === null && $akey !== '') {
+            if ($spec) {
+                $spec->alias_map[$akey] = $key;
+            }
+            $val = \Voxgig\Struct\Struct::getprop($reqmatch, $akey);
+        }
+
+        if ($val === null) {
+            $val = \Voxgig\Struct\Struct::getprop($reqdata, $key);
+        }
+        if ($val === null) {
+            $val = \Voxgig\Struct\Struct::getprop($data, $key);
+        }
+
+        if ($val === null && $akey !== '') {
+            $val = \Voxgig\Struct\Struct::getprop($reqdata, $akey);
+            if ($val === null) {
+                $val = \Voxgig\Struct\Struct::getprop($data, $akey);
+            }
+        }
+
+        return $val;
+    }
+}

package/project/.sdk/tm/php/utility/PrepareAuth.php

@@ -0,0 +1,33 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_auth
+
+class ProjectNamePrepareAuth
+{
+    private const HEADER_AUTH = 'authorization';
+    private const OPTION_APIKEY = 'apikey';
+    private const NOT_FOUND = '__NOTFOUND__';
+
+    public static function call(ProjectNameContext $ctx): array
+    {
+        $spec = $ctx->spec;
+        if (!$spec) {
+            return [null, $ctx->make_error('auth_no_spec', 'Expected context spec property to be defined.')];
+        }
+
+        $headers = &$spec->headers;
+        $options = $ctx->client->options_map();
+        $apikey = \Voxgig\Struct\Struct::getprop($options, self::OPTION_APIKEY, self::NOT_FOUND);
+
+        if (is_string($apikey) && $apikey === self::NOT_FOUND) {
+            unset($headers[self::HEADER_AUTH]);
+        } else {
+            $auth_prefix = \Voxgig\Struct\Struct::getpath($options, 'auth.prefix') ?? '';
+            $apikey_val = is_string($apikey) ? $apikey : '';
+            $headers[self::HEADER_AUTH] = "{$auth_prefix} {$apikey_val}";
+        }
+
+        return [$spec, null];
+    }
+}

package/project/.sdk/tm/php/utility/PrepareBody.php

@@ -0,0 +1,15 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_body
+
+class ProjectNamePrepareBody
+{
+    public static function call(ProjectNameContext $ctx): mixed
+    {
+        if ($ctx->op->input === 'data') {
+            return ($ctx->utility->transform_request)($ctx);
+        }
+        return null;
+    }
+}

package/project/.sdk/tm/php/utility/PrepareHeaders.php

@@ -0,0 +1,18 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_headers
+
+class ProjectNamePrepareHeaders
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        $options = $ctx->client->options_map();
+        $headers = \Voxgig\Struct\Struct::getprop($options, 'headers');
+        if (!$headers) {
+            return [];
+        }
+        $out = \Voxgig\Struct\Struct::clone($headers);
+        return is_array($out) ? $out : [];
+    }
+}

package/project/.sdk/tm/php/utility/PrepareMethod.php

@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_method
+
+class ProjectNamePrepareMethod
+{
+    private const METHOD_MAP = [
+        'create' => 'POST',
+        'update' => 'PUT',
+        'load' => 'GET',
+        'list' => 'GET',
+        'remove' => 'DELETE',
+        'patch' => 'PATCH',
+    ];
+
+    public static function call(ProjectNameContext $ctx): string
+    {
+        return self::METHOD_MAP[$ctx->op->name] ?? 'GET';
+    }
+}

package/project/.sdk/tm/php/utility/PrepareParams.php

@@ -0,0 +1,34 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_params
+
+class ProjectNamePrepareParams
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        $utility = $ctx->utility;
+        $point = $ctx->point;
+        $params = [];
+        if ($point) {
+            $args = \Voxgig\Struct\Struct::getprop($point, 'args');
+            if (is_array($args)) {
+                $p = \Voxgig\Struct\Struct::getprop($args, 'params');
+                if (is_array($p)) {
+                    $params = $p;
+                }
+            }
+        }
+        $out = [];
+        foreach ($params as $pd) {
+            $val = ($utility->param)($ctx, $pd);
+            if ($val !== null && is_array($pd)) {
+                $name = \Voxgig\Struct\Struct::getprop($pd, 'name');
+                if (is_string($name) && $name !== '') {
+                    $out[$name] = $val;
+                }
+            }
+        }
+        return $out;
+    }
+}

package/project/.sdk/tm/php/utility/PreparePath.php

@@ -0,0 +1,20 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_path
+
+class ProjectNamePreparePath
+{
+    public static function call(ProjectNameContext $ctx): string
+    {
+        $point = $ctx->point;
+        $parts = [];
+        if ($point) {
+            $p = \Voxgig\Struct\Struct::getprop($point, 'parts');
+            if (is_array($p)) {
+                $parts = $p;
+            }
+        }
+        return \Voxgig\Struct\Struct::join($parts, '/', true);
+    }
+}