@voxgig/sdkgen 0.35.2 → 0.37.0

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,68 @@
+<?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;
+                }
+            }
+        }
+
+        $undef = '__UNDEFINED__';
+
+        $val = \Voxgig\Struct\Struct::getprop($reqmatch, $key);
+        if ($val === null || $val === $undef) {
+            $val = \Voxgig\Struct\Struct::getprop($match_val, $key);
+        }
+
+        if (($val === null || $val === $undef) && $akey !== '') {
+            if ($spec) {
+                $spec->alias_map[$akey] = $key;
+            }
+            $val = \Voxgig\Struct\Struct::getprop($reqmatch, $akey);
+        }
+
+        if ($val === null || $val === $undef) {
+            $val = \Voxgig\Struct\Struct::getprop($reqdata, $key);
+        }
+        if ($val === null || $val === $undef) {
+            $val = \Voxgig\Struct\Struct::getprop($data, $key);
+        }
+
+        if (($val === null || $val === $undef) && $akey !== '') {
+            $val = \Voxgig\Struct\Struct::getprop($reqdata, $akey);
+            if ($val === null || $val === $undef) {
+                $val = \Voxgig\Struct\Struct::getprop($data, $akey);
+            }
+        }
+
+        return ($val === $undef) ? null : $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);
+    }
+}

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

@@ -0,0 +1,32 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: prepare_query
+
+class ProjectNamePrepareQuery
+{
+    public static function call(ProjectNameContext $ctx): array
+    {
+        $point = $ctx->point;
+        $reqmatch = $ctx->reqmatch ?? [];
+        $params = [];
+        if ($point) {
+            $p = \Voxgig\Struct\Struct::getprop($point, 'params');
+            if (is_array($p)) {
+                $params = $p;
+            }
+        }
+        $out = [];
+        $items = \Voxgig\Struct\Struct::items($reqmatch);
+        if ($items) {
+            foreach ($items as $item) {
+                $key = $item[0];
+                $val = $item[1];
+                if ($val !== null && is_string($key) && !in_array($key, $params, true)) {
+                    $out[$key] = $val;
+                }
+            }
+        }
+        return $out;
+    }
+}

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

@@ -0,0 +1,67 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility registration
+
+require_once __DIR__ . '/../core/UtilityType.php';
+require_once __DIR__ . '/Clean.php';
+require_once __DIR__ . '/Done.php';
+require_once __DIR__ . '/MakeError.php';
+require_once __DIR__ . '/FeatureAdd.php';
+require_once __DIR__ . '/FeatureHook.php';
+require_once __DIR__ . '/FeatureInit.php';
+require_once __DIR__ . '/Fetcher.php';
+require_once __DIR__ . '/MakeFetchDef.php';
+require_once __DIR__ . '/MakeContext.php';
+require_once __DIR__ . '/MakeOptions.php';
+require_once __DIR__ . '/MakeRequest.php';
+require_once __DIR__ . '/MakeResponse.php';
+require_once __DIR__ . '/MakeResult.php';
+require_once __DIR__ . '/MakePoint.php';
+require_once __DIR__ . '/MakeSpec.php';
+require_once __DIR__ . '/MakeUrl.php';
+require_once __DIR__ . '/Param.php';
+require_once __DIR__ . '/PrepareAuth.php';
+require_once __DIR__ . '/PrepareBody.php';
+require_once __DIR__ . '/PrepareHeaders.php';
+require_once __DIR__ . '/PrepareMethod.php';
+require_once __DIR__ . '/PrepareParams.php';
+require_once __DIR__ . '/PreparePath.php';
+require_once __DIR__ . '/PrepareQuery.php';
+require_once __DIR__ . '/ResultBasic.php';
+require_once __DIR__ . '/ResultBody.php';
+require_once __DIR__ . '/ResultHeaders.php';
+require_once __DIR__ . '/TransformRequest.php';
+require_once __DIR__ . '/TransformResponse.php';
+
+ProjectNameUtility::setRegistrar(function (ProjectNameUtility $u): void {
+    $u->clean = [ProjectNameClean::class, 'call'];
+    $u->done = [ProjectNameDone::class, 'call'];
+    $u->make_error = [ProjectNameMakeError::class, 'call'];
+    $u->feature_add = [ProjectNameFeatureAdd::class, 'call'];
+    $u->feature_hook = [ProjectNameFeatureHook::class, 'call'];
+    $u->feature_init = [ProjectNameFeatureInit::class, 'call'];
+    $u->fetcher = [ProjectNameFetcher::class, 'call'];
+    $u->make_fetch_def = [ProjectNameMakeFetchDef::class, 'call'];
+    $u->make_context = [ProjectNameMakeContext::class, 'call'];
+    $u->make_options = [ProjectNameMakeOptions::class, 'call'];
+    $u->make_request = [ProjectNameMakeRequest::class, 'call'];
+    $u->make_response = [ProjectNameMakeResponse::class, 'call'];
+    $u->make_result = [ProjectNameMakeResult::class, 'call'];
+    $u->make_point = [ProjectNameMakePoint::class, 'call'];
+    $u->make_spec = [ProjectNameMakeSpec::class, 'call'];
+    $u->make_url = [ProjectNameMakeUrl::class, 'call'];
+    $u->param = [ProjectNameParam::class, 'call'];
+    $u->prepare_auth = [ProjectNamePrepareAuth::class, 'call'];
+    $u->prepare_body = [ProjectNamePrepareBody::class, 'call'];
+    $u->prepare_headers = [ProjectNamePrepareHeaders::class, 'call'];
+    $u->prepare_method = [ProjectNamePrepareMethod::class, 'call'];
+    $u->prepare_params = [ProjectNamePrepareParams::class, 'call'];
+    $u->prepare_path = [ProjectNamePreparePath::class, 'call'];
+    $u->prepare_query = [ProjectNamePrepareQuery::class, 'call'];
+    $u->result_basic = [ProjectNameResultBasic::class, 'call'];
+    $u->result_body = [ProjectNameResultBody::class, 'call'];
+    $u->result_headers = [ProjectNameResultHeaders::class, 'call'];
+    $u->transform_request = [ProjectNameTransformRequest::class, 'call'];
+    $u->transform_response = [ProjectNameTransformResponse::class, 'call'];
+});

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

@@ -0,0 +1,29 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: result_basic
+
+class ProjectNameResultBasic
+{
+    public static function call(ProjectNameContext $ctx): ?ProjectNameResult
+    {
+        $response = $ctx->response;
+        $result = $ctx->result;
+        if ($result && $response) {
+            $result->status = $response->status;
+            $result->status_text = $response->status_text;
+            if ($result->status >= 400) {
+                $msg = "request: {$result->status}: {$result->status_text}";
+                if ($result->err) {
+                    $prev = ($result->err instanceof ProjectNameError) ? $result->err->msg : (string)$result->err;
+                    $result->err = $ctx->make_error('request_status', "{$prev}: {$msg}");
+                } else {
+                    $result->err = $ctx->make_error('request_status', $msg);
+                }
+            } elseif ($response->err) {
+                $result->err = $response->err;
+            }
+        }
+        return $result;
+    }
+}

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

@@ -0,0 +1,17 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: result_body
+
+class ProjectNameResultBody
+{
+    public static function call(ProjectNameContext $ctx): ?ProjectNameResult
+    {
+        $response = $ctx->response;
+        $result = $ctx->result;
+        if ($result && $response && $response->json_func && $response->body) {
+            $result->body = ($response->json_func)();
+        }
+        return $result;
+    }
+}

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

@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: result_headers
+
+class ProjectNameResultHeaders
+{
+    public static function call(ProjectNameContext $ctx): ?ProjectNameResult
+    {
+        $response = $ctx->response;
+        $result = $ctx->result;
+        if ($result) {
+            if ($response && is_array($response->headers)) {
+                $result->headers = $response->headers;
+            } else {
+                $result->headers = [];
+            }
+        }
+        return $result;
+    }
+}

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

@@ -0,0 +1,27 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: transform_request
+
+require_once __DIR__ . '/../core/Helpers.php';
+
+class ProjectNameTransformRequest
+{
+    public static function call(ProjectNameContext $ctx): mixed
+    {
+        $spec = $ctx->spec;
+        $point = $ctx->point;
+        if ($spec) {
+            $spec->step = 'reqform';
+        }
+        $transform = ProjectNameHelpers::to_map(\Voxgig\Struct\Struct::getprop($point, 'transform'));
+        if (!$transform) {
+            return $ctx->reqdata;
+        }
+        $reqform = \Voxgig\Struct\Struct::getprop($transform, 'req');
+        if (!$reqform) {
+            return $ctx->reqdata;
+        }
+        return \Voxgig\Struct\Struct::transform(['reqdata' => $ctx->reqdata], $reqform);
+    }
+}

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

@@ -0,0 +1,42 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK utility: transform_response
+
+require_once __DIR__ . '/../core/Helpers.php';
+
+class ProjectNameTransformResponse
+{
+    public static function call(ProjectNameContext $ctx): mixed
+    {
+        $spec = $ctx->spec;
+        $result = $ctx->result;
+        $point = $ctx->point;
+        if ($spec) {
+            $spec->step = 'resform';
+        }
+        if ($result === null || !$result->ok) {
+            return null;
+        }
+        $transform = ProjectNameHelpers::to_map(\Voxgig\Struct\Struct::getprop($point, 'transform'));
+        if (!$transform) {
+            return null;
+        }
+        $resform = \Voxgig\Struct\Struct::getprop($transform, 'res');
+        if (!$resform) {
+            return null;
+        }
+        $resdata = \Voxgig\Struct\Struct::transform([
+            'ok' => $result->ok,
+            'status' => $result->status,
+            'statusText' => $result->status_text,
+            'headers' => $result->headers,
+            'body' => $result->body,
+            'err' => $result->err,
+            'resdata' => $result->resdata,
+            'resmatch' => $result->resmatch,
+        ], $resform);
+        $result->resdata = $resdata;
+        return $resdata;
+    }
+}