@voxgig/sdkgen 0.35.2 → 0.37.0

package/project/.sdk/src/cmp/php/fragment/EntityListOp.fragment.php

@@ -0,0 +1,23 @@
+// EJECT-START
+
+    public function list($reqmatch, $ctrl = null): array
+    {
+        $utility = $this->_utility;
+        $ctx = ($utility->make_context)([
+            "opname" => "list",
+            "ctrl" => $ctrl,
+            "match" => $this->_match,
+            "data" => $this->_data,
+            "reqmatch" => $reqmatch,
+        ], $this->_entctx);
+
+        return $this->_run_op($ctx, function () use ($ctx) {
+            if ($ctx->result) {
+                if ($ctx->result->resmatch) {
+                    $this->_match = $ctx->result->resmatch;
+                }
+            }
+        });
+    }
+
+// EJECT-END

package/project/.sdk/src/cmp/php/fragment/EntityLoadOp.fragment.php

@@ -0,0 +1,29 @@
+require_once __DIR__ . '/../utility/struct/Struct.php';
+require_once __DIR__ . '/../core/Helpers.php';
+
+// EJECT-START
+
+    public function load($reqmatch, $ctrl = null): array
+    {
+        $utility = $this->_utility;
+        $ctx = ($utility->make_context)([
+            "opname" => "load",
+            "ctrl" => $ctrl,
+            "match" => $this->_match,
+            "data" => $this->_data,
+            "reqmatch" => $reqmatch,
+        ], $this->_entctx);
+
+        return $this->_run_op($ctx, function () use ($ctx) {
+            if ($ctx->result) {
+                if ($ctx->result->resmatch) {
+                    $this->_match = $ctx->result->resmatch;
+                }
+                if ($ctx->result->resdata) {
+                    $this->_data = ProjectNameHelpers::to_map(Struct::clone($ctx->result->resdata)) ?? [];
+                }
+            }
+        });
+    }
+
+// EJECT-END

package/project/.sdk/src/cmp/php/fragment/EntityRemoveOp.fragment.php

@@ -0,0 +1,29 @@
+require_once __DIR__ . '/../utility/struct/Struct.php';
+require_once __DIR__ . '/../core/Helpers.php';
+
+// EJECT-START
+
+    public function remove($reqmatch, $ctrl = null): array
+    {
+        $utility = $this->_utility;
+        $ctx = ($utility->make_context)([
+            "opname" => "remove",
+            "ctrl" => $ctrl,
+            "match" => $this->_match,
+            "data" => $this->_data,
+            "reqmatch" => $reqmatch,
+        ], $this->_entctx);
+
+        return $this->_run_op($ctx, function () use ($ctx) {
+            if ($ctx->result) {
+                if ($ctx->result->resmatch) {
+                    $this->_match = $ctx->result->resmatch;
+                }
+                if ($ctx->result->resdata) {
+                    $this->_data = ProjectNameHelpers::to_map(Struct::clone($ctx->result->resdata)) ?? [];
+                }
+            }
+        });
+    }
+
+// EJECT-END

package/project/.sdk/src/cmp/php/fragment/EntityUpdateOp.fragment.php

@@ -0,0 +1,29 @@
+require_once __DIR__ . '/../utility/struct/Struct.php';
+require_once __DIR__ . '/../core/Helpers.php';
+
+// EJECT-START
+
+    public function update($reqdata, $ctrl = null): array
+    {
+        $utility = $this->_utility;
+        $ctx = ($utility->make_context)([
+            "opname" => "update",
+            "ctrl" => $ctrl,
+            "match" => $this->_match,
+            "data" => $this->_data,
+            "reqdata" => $reqdata,
+        ], $this->_entctx);
+
+        return $this->_run_op($ctx, function () use ($ctx) {
+            if ($ctx->result) {
+                if ($ctx->result->resmatch) {
+                    $this->_match = $ctx->result->resmatch;
+                }
+                if ($ctx->result->resdata) {
+                    $this->_data = ProjectNameHelpers::to_map(Struct::clone($ctx->result->resdata)) ?? [];
+                }
+            }
+        });
+    }
+
+// EJECT-END

package/project/.sdk/src/cmp/php/fragment/Main.fragment.php

@@ -0,0 +1,233 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK
+
+require_once __DIR__ . '/utility/struct/Struct.php';
+require_once __DIR__ . '/core/UtilityType.php';
+require_once __DIR__ . '/core/Spec.php';
+require_once __DIR__ . '/core/Helpers.php';
+
+// Load utility registration
+require_once __DIR__ . '/utility/Register.php';
+
+// Load config and features
+require_once __DIR__ . '/config.php';
+require_once __DIR__ . '/feature/BaseFeature.php';
+require_once __DIR__ . '/features.php';
+
+use Voxgig\Struct\Struct;
+
+class ProjectNameSDK
+{
+    public string $mode;
+    public array $features;
+    public ?array $options;
+
+    private $_utility;
+    private $_rootctx;
+
+    public function __construct(array $options = [])
+    {
+        $this->mode = "live";
+        $this->features = [];
+        $this->options = null;
+
+        $utility = new ProjectNameUtility();
+        $this->_utility = $utility;
+
+        $config = ProjectNameConfig::make_config();
+
+        $this->_rootctx = ($utility->make_context)([
+            "client" => $this,
+            "utility" => $utility,
+            "config" => $config,
+            "options" => $options ?? [],
+            "shared" => [],
+        ], null);
+
+        $this->options = ($utility->make_options)($this->_rootctx);
+
+        if (Struct::getpath($this->options, "feature.test.active") === true) {
+            $this->mode = "test";
+        }
+
+        $this->_rootctx->options = $this->options;
+
+        // Add features from config.
+        $feature_opts = ProjectNameHelpers::to_map(Struct::getprop($this->options, "feature"));
+        if ($feature_opts) {
+            $items = Struct::items($feature_opts);
+            if ($items) {
+                foreach ($items as $item) {
+                    $fname = $item[0];
+                    $fopts = ProjectNameHelpers::to_map($item[1]);
+                    if ($fopts && isset($fopts["active"]) && $fopts["active"] === true) {
+                        ($utility->feature_add)($this->_rootctx, ProjectNameFeatures::make_feature($fname));
+                    }
+                }
+            }
+        }
+
+        // Add extension features.
+        $extend_val = Struct::getprop($this->options, "extend");
+        if (is_array($extend_val)) {
+            foreach ($extend_val as $f) {
+                if (is_object($f) && method_exists($f, 'get_name')) {
+                    ($utility->feature_add)($this->_rootctx, $f);
+                }
+            }
+        }
+
+        // Initialize features.
+        foreach ($this->features as $f) {
+            ($utility->feature_init)($this->_rootctx, $f);
+        }
+
+        ($utility->feature_hook)($this->_rootctx, "PostConstruct");
+    }
+
+    public function options_map(): array
+    {
+        $out = Struct::clone($this->options);
+        return is_array($out) ? $out : [];
+    }
+
+    public function get_utility()
+    {
+        return ProjectNameUtility::copy($this->_utility);
+    }
+
+    public function get_root_ctx()
+    {
+        return $this->_rootctx;
+    }
+
+    public function prepare(array $fetchargs = []): array
+    {
+        $utility = $this->_utility;
+        $fetchargs = $fetchargs ?? [];
+
+        $ctrl = ProjectNameHelpers::to_map(Struct::getprop($fetchargs, "ctrl")) ?? [];
+
+        $ctx = ($utility->make_context)([
+            "opname" => "prepare",
+            "ctrl" => $ctrl,
+        ], $this->_rootctx);
+
+        $opts = $this->options;
+        $path = Struct::getprop($fetchargs, "path") ?? "";
+        $path = is_string($path) ? $path : "";
+        $method_val = Struct::getprop($fetchargs, "method") ?? "GET";
+        $method_val = is_string($method_val) ? $method_val : "GET";
+        $params = ProjectNameHelpers::to_map(Struct::getprop($fetchargs, "params")) ?? [];
+        $query = ProjectNameHelpers::to_map(Struct::getprop($fetchargs, "query")) ?? [];
+        $headers = ($utility->prepare_headers)($ctx);
+
+        $base = Struct::getprop($opts, "base") ?? "";
+        $base = is_string($base) ? $base : "";
+        $prefix = Struct::getprop($opts, "prefix") ?? "";
+        $prefix = is_string($prefix) ? $prefix : "";
+        $suffix = Struct::getprop($opts, "suffix") ?? "";
+        $suffix = is_string($suffix) ? $suffix : "";
+
+        $ctx->spec = new ProjectNameSpec([
+            "base" => $base, "prefix" => $prefix, "suffix" => $suffix,
+            "path" => $path, "method" => $method_val,
+            "params" => $params, "query" => $query, "headers" => $headers,
+            "body" => Struct::getprop($fetchargs, "body"),
+            "step" => "start",
+        ]);
+
+        // Merge user-provided headers.
+        $uh = Struct::getprop($fetchargs, "headers");
+        if (is_array($uh)) {
+            foreach ($uh as $k => $v) {
+                $ctx->spec->headers[$k] = $v;
+            }
+        }
+
+        [$_, $err] = ($utility->prepare_auth)($ctx);
+        if ($err) {
+            return [null, $err];
+        }
+
+        return ($utility->make_fetch_def)($ctx);
+    }
+
+    public function direct(array $fetchargs = []): array
+    {
+        $utility = $this->_utility;
+
+        [$fetchdef, $err] = $this->prepare($fetchargs);
+        if ($err) {
+            return [["ok" => false, "err" => $err], null];
+        }
+
+        $fetchargs = $fetchargs ?? [];
+        $ctrl = ProjectNameHelpers::to_map(Struct::getprop($fetchargs, "ctrl")) ?? [];
+
+        $ctx = ($utility->make_context)([
+            "opname" => "direct",
+            "ctrl" => $ctrl,
+        ], $this->_rootctx);
+
+        $url = $fetchdef["url"] ?? "";
+        [$fetched, $fetch_err] = ($utility->fetcher)($ctx, $url, $fetchdef);
+
+        if ($fetch_err) {
+            return [["ok" => false, "err" => $fetch_err], null];
+        }
+
+        if ($fetched === null) {
+            return [[
+                "ok" => false,
+                "err" => $ctx->make_error("direct_no_response", "response: undefined"),
+            ], null];
+        }
+
+        if (is_array($fetched)) {
+            $status = ProjectNameHelpers::to_int(Struct::getprop($fetched, "status"));
+            $json_data = null;
+            $jf = Struct::getprop($fetched, "json");
+            if (is_callable($jf)) {
+                $json_data = $jf();
+            }
+
+            return [[
+                "ok" => $status >= 200 && $status < 300,
+                "status" => $status,
+                "headers" => Struct::getprop($fetched, "headers"),
+                "data" => $json_data,
+            ], null];
+        }
+
+        return [[
+            "ok" => false,
+            "err" => $ctx->make_error("direct_invalid", "invalid response type"),
+        ], null];
+    }
+
+    // <[SLOT]>
+
+    public static function test(?array $testopts = null, ?array $sdkopts = null): self
+    {
+        $sdkopts = $sdkopts ?? [];
+        $sdkopts = Struct::clone($sdkopts);
+        $sdkopts = is_array($sdkopts) ? $sdkopts : [];
+
+        $testopts = $testopts ?? [];
+        $testopts = Struct::clone($testopts);
+        $testopts = is_array($testopts) ? $testopts : [];
+        $testopts["active"] = true;
+
+        if (!isset($sdkopts["feature"])) {
+            $sdkopts["feature"] = [];
+        }
+        $sdkopts["feature"]["test"] = $testopts;
+
+        $sdk = new ProjectNameSDK($sdkopts);
+        $sdk->mode = "test";
+        return $sdk;
+    }
+}

package/project/.sdk/src/cmp/php/fragment/SdkError.fragment.php

@@ -0,0 +1,24 @@
+<?php
+declare(strict_types=1);
+
+// ProjectName SDK error
+
+class ProjectNameError extends \Exception
+{
+    public string $code;
+    public string $msg;
+    public string $sdk;
+
+    public function __construct(string $code = "", string $msg = "")
+    {
+        parent::__construct($msg);
+        $this->code = $code;
+        $this->msg = $msg;
+        $this->sdk = "ProjectName";
+    }
+
+    public function error(): string
+    {
+        return "{$this->sdk}: {$this->code}: {$this->msg}";
+    }
+}

package/project/.sdk/src/cmp/php/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "module": "nodenext",
+    "noEmitOnError": true,
+    "outDir":"../dist",
+    "rootDir":".",
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "es2022",
+    "declaration": true,
+    "declarationDir": "../dist"
+  }
+}

package/project/.sdk/src/cmp/php/utility_php.ts

@@ -0,0 +1,85 @@
+
+import * as Path from 'node:path'
+
+import {
+  clone,
+  walk,
+} from '@voxgig/struct'
+
+
+function projectPath(suffix?: string): string {
+  return Path.normalize(Path.join(__dirname, '../../..', suffix ?? ''))
+}
+
+
+function formatPhpArray(obj: any, indent: number = 0): string {
+  if (obj == null) {
+    return 'null'
+  }
+
+  const pad = '  '.repeat(indent)
+  const padInner = '  '.repeat(indent + 1)
+
+  if (Array.isArray(obj)) {
+    if (obj.length === 0) {
+      return '[]'
+    }
+    const items = obj.map(v => padInner + formatPhpValue(v, indent + 1)).join(',\n')
+    return `[\n${items},\n${pad}]`
+  }
+
+  if (typeof obj === 'object') {
+    const entries = Object.entries(obj)
+    if (entries.length === 0) {
+      return '[]'
+    }
+    const items = entries
+      .map(([k, v]) => `${padInner}'${k}' => ${formatPhpValue(v, indent + 1)}`)
+      .join(',\n')
+    return `[\n${items},\n${pad}]`
+  }
+
+  return formatPhpValue(obj, indent)
+}
+
+
+function formatPhpValue(val: any, indent: number = 0): string {
+  if (val === null || val === undefined) {
+    return 'null'
+  }
+  if (typeof val === 'string') {
+    // Use single quotes to avoid PHP variable interpolation (e.g. $STRING)
+    return `'${val.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`
+  }
+  if (typeof val === 'number') {
+    return String(val)
+  }
+  if (typeof val === 'boolean') {
+    return val ? 'true' : 'false'
+  }
+  if (Array.isArray(val)) {
+    return formatPhpArray(val, indent)
+  }
+  if (typeof val === 'object') {
+    return formatPhpArray(val, indent)
+  }
+  return String(val)
+}
+
+
+function clean(o: any) {
+  return walk(clone(o), (k: any, v: any, p: any) => {
+    if (null != k && k.endsWith('$')) {
+      delete p[k]
+    }
+    return v
+  })
+}
+
+
+export {
+  clean,
+  formatPhpArray,
+  formatPhpValue,
+  projectPath,
+}

package/project/.sdk/src/cmp/py/Config_py.ts

@@ -0,0 +1,97 @@
+
+import * as Path from 'node:path'
+
+
+import {
+  Content,
+  File,
+  Fragment,
+  Line,
+  cmp,
+  each,
+} from '@voxgig/sdkgen'
+
+
+import {
+  KIT,
+  Model,
+  getModelPath,
+  nom,
+} from '@voxgig/apidef'
+
+
+import {
+  clean,
+  formatPyDict,
+} from './utility_py'
+
+
+const Config = cmp(async function Config(props: any) {
+  const ctx$ = props.ctx$
+  const target = props.target
+
+  const model: Model = ctx$.model
+
+  const entity = getModelPath(model, `main.${KIT}.entity`)
+  const feature = getModelPath(model, `main.${KIT}.feature`)
+
+  const headers = getModelPath(model, `main.${KIT}.config.headers`) || {}
+
+  let authPrefix = ''
+  try { authPrefix = getModelPath(model, `main.${KIT}.config.auth.prefix`) } catch (_e) { }
+
+  let baseUrl = ''
+  try { baseUrl = getModelPath(model, `main.${KIT}.info.servers.0.url`) } catch (_e) { }
+
+  File({ name: 'config.' + target.ext }, () => {
+
+    Content(`# ${model.const.Name} SDK configuration
+
+
+def make_config():
+    return {
+        "main": {
+            "name": "${model.const.Name}",
+        },
+        "feature": {
+`)
+
+    each(feature, (f: any) => {
+      const fconfig = f.config || {}
+      Content(`            "${f.name}": ${formatPyDict(fconfig, 3)},
+`)
+    })
+
+    Content(`        },
+        "options": {
+            "base": "${baseUrl}",
+            "auth": {
+                "prefix": "${authPrefix}",
+            },
+            "headers": ${formatPyDict(headers, 3)},
+            "entity": {
+`)
+
+    each(entity, (entity: any) => {
+      Content(`                "${entity.name}": {},
+`)
+    })
+
+    Content(`            },
+        },
+        "entity": ${formatPyDict(
+      Object.values(entity).reduce((a: any, n: any) => (a[n.name] = clean({
+        fields: n.fields,
+        name: n.name,
+        op: n.op,
+        relations: n.relations,
+      }), a), {}), 2)},
+    }
+`)
+  })
+})
+
+
+export {
+  Config
+}

package/project/.sdk/src/cmp/py/EntityOperation_py.ts

@@ -0,0 +1,44 @@
+
+import {
+  cmp, camelify,
+  Content, Fragment
+} from '@voxgig/sdkgen'
+
+
+const EntityOperation = cmp(function Operation(props: any) {
+  const { model } = props.ctx$
+  const { ff, opname, entity, entrep } = props
+
+  let { indent } = props
+
+  if (null != indent) {
+    indent = indent.substring(1)
+    if ('' == indent) {
+      indent = undefined
+    }
+  }
+
+  const entop = entity.op[opname]
+
+  Fragment({
+    from: ff + '/Entity' + camelify(opname) + 'Op.fragment.py',
+    eject: ['# EJECT-START', '# EJECT-END'],
+    indent,
+    replace: {
+      ...entrep,
+      ProjectName: model.const.Name,
+      EntityName: entity.Name,
+      entityname: entity.name,
+      '#Feature-Hook': ({ name, indent }: any) =>
+        Content({ indent }, `
+u.feature_hook(ctx, "${name}")
+`)
+
+    }
+  })
+})
+
+
+export {
+  EntityOperation
+}

package/project/.sdk/src/cmp/py/Entity_py.ts

@@ -0,0 +1,62 @@
+
+import * as Path from 'node:path'
+
+import {
+  cmp, each, camelify, names,
+  File, Content, Folder, Fragment, Line, FeatureHook, Slot
+} from '@voxgig/sdkgen'
+
+import { EntityOperation } from './EntityOperation_py'
+
+
+const Entity = cmp(function Entity(props: any) {
+  const { model, stdrep } = props.ctx$
+  const { target, entity } = props
+
+  const entrep = {
+    ...stdrep,
+  }
+
+  names(entrep, entity.Name, 'EntityName')
+
+  const ff = Path.normalize(__dirname + '/../../../src/cmp/py/fragment/')
+
+  // Entity files go to entity/ folder
+  Folder({ name: 'entity' }, () => {
+
+    File({ name: entity.name + '_entity.' + target.ext }, () => {
+
+      const opnames = Object.keys(entity.op)
+
+      const opfrags =
+        (['load', 'list', 'create', 'update', 'remove']
+          .reduce((a: any, opname: string) =>
+          (a['# #' + camelify(opname) + 'Op'] =
+            !opnames.includes(opname) ? '' : ({ indent }: any) => {
+              EntityOperation({ ff, opname, indent, entity, entrep })
+            }, a), {}))
+
+      Fragment({
+        from: ff + 'Entity.fragment.py',
+        replace: {
+          ...entrep,
+          ProjectName: model.const.Name,
+          EntityName: entity.Name,
+          entityname: entity.name,
+
+          '#Entity-Hook': ({ name, indent }: any) =>
+            Content({ indent }, `utility.feature_hook(ctx, "${name}")`),
+
+          ...opfrags,
+        }
+      })
+
+    })
+  })
+})
+
+
+
+export {
+  Entity
+}

package/project/.sdk/src/cmp/py/MainEntity_py.ts

@@ -0,0 +1,22 @@
+
+
+import { cmp, Content } from '@voxgig/sdkgen'
+
+
+const MainEntity = cmp(async function MainEntity(props: any) {
+  const { entity } = props
+  const { model } = props.ctx$
+
+  Content(`
+    def ${entity.Name}(self, data=None):
+        from entity.${entity.name}_entity import ${entity.Name}Entity
+        return ${entity.Name}Entity(self, data)
+
+`)
+
+})
+
+
+export {
+  MainEntity
+}