@voxgig/sdkgen 4.9.0 → 4.10.0

package/project/.sdk/tm/dart/lib/feature/debug/DebugFeature.dart

@@ -1,153 +0,0 @@
-// ignore_for_file: non_constant_identifier_names
-
-import '../base/BaseFeature.dart';
-
-// Request/response capture for debugging. Records a bounded ring buffer of
-// per-operation traces — method, URL, redacted headers, response status and
-// timing — on the client track (`debug.entries`). Sensitive header values
-// (matching `redact`, default authorization/cookie/api-key style names) are
-// masked. An optional `onEntry` callback receives each finished entry (e.g.
-// to stream to a console). `max` caps the buffer (default 100).
-class DebugFeature extends BaseFeature {
-  dynamic _client;
-  final Map<dynamic, dynamic> _entries = {};
-
-  DebugFeature() {
-    version = '0.0.1';
-    name = 'debug';
-    active = true;
-  }
-
-  @override
-  dynamic init(dynamic ctx, dynamic opts) {
-    _client = ctx.client;
-    options = opts is Map ? Map<String, dynamic>.from(opts) : {};
-    active = true == options['active'];
-    _entries.clear();
-
-    final track = _client.track;
-    if (null == track['debug']) {
-      track['debug'] = <String, dynamic>{'entries': <dynamic>[]};
-    }
-    return null;
-  }
-
-  @override
-  dynamic PreRequest(dynamic ctx) {
-    final spec = ctx.spec;
-    final entry = <String, dynamic>{
-      'op': (null == ctx.op ? '_' : (ctx.op.entity ?? '_')).toString() +
-          '.' +
-          (null == ctx.op ? '_' : (ctx.op.name ?? '_')).toString(),
-      'method': null == spec ? null : spec.method,
-      'url': null == spec ? null : (spec.url ?? spec.path),
-      'headers': _redact(null == spec ? null : spec.headers),
-      'start': _now(),
-      'status': null,
-      'ok': null,
-      'durationMs': null,
-      'error': null,
-    };
-    _entries[ctx] = entry;
-    return null;
-  }
-
-  @override
-  dynamic PreResponse(dynamic ctx) {
-    final entry = _entries[ctx];
-    if (null == entry) {
-      return null;
-    }
-    final response = ctx.response;
-    if (null != response) {
-      entry['status'] = response.status;
-      entry['url'] = entry['url'] ?? (null == ctx.spec ? null : ctx.spec.url);
-    }
-    return null;
-  }
-
-  @override
-  dynamic PreDone(dynamic ctx) {
-    _finish(ctx, true);
-    return null;
-  }
-
-  @override
-  dynamic PreUnexpected(dynamic ctx) {
-    final entry = _entries[ctx];
-    if (null != entry && ctx.ctrl is Map) {
-      final err = ctx.ctrl['err'];
-      if (null != err) {
-        try {
-          entry['error'] = (err as dynamic).message;
-        } catch (_e) {
-          entry['error'] = err.toString();
-        }
-      }
-    }
-    _finish(ctx, false);
-    return null;
-  }
-
-  void _finish(dynamic ctx, bool ok) {
-    final entry = _entries[ctx];
-    if (null == entry) {
-      return;
-    }
-    _entries.remove(ctx);
-    entry['ok'] = ok && (null == ctx.result || false != ctx.result.ok);
-    var dur = _now() - entry['start'];
-    entry['durationMs'] = dur < 0 ? 0 : dur;
-    if (null == entry['status'] && null != ctx.result) {
-      entry['status'] = ctx.result.status;
-    }
-
-    final List buf = _client.track['debug']['entries'];
-    buf.add(entry);
-    final max = null == options['max'] ? 100 : (options['max'] as num).toInt();
-    while (buf.length > max) {
-      buf.removeAt(0);
-    }
-
-    final onEntry = options['onEntry'];
-    if (onEntry is Function) {
-      try {
-        onEntry(entry);
-      } catch (_e) {
-        // Callback failures are swallowed.
-      }
-    }
-  }
-
-  dynamic _redact(dynamic headers) {
-    if (headers is! Map) {
-      return {};
-    }
-    final patterns = options['redact'] ??
-        [
-          'authorization',
-          'cookie',
-          'set-cookie',
-          'api-key',
-          'apikey',
-          'x-api-key',
-          'idempotency-key'
-        ];
-    final out = <String, dynamic>{};
-    for (final k in headers.keys) {
-      out[k.toString()] =
-          (patterns as List).contains(k.toString().toLowerCase())
-              ? '<redacted>'
-              : headers[k];
-    }
-    return out;
-  }
-
-  num _now() {
-    final now = options['now'];
-    if (now is Function) {
-      return now();
-    }
-    return DateTime.now().millisecondsSinceEpoch;
-  }
-}

package/project/.sdk/tm/dart/lib/feature/idempotency/IdempotencyFeature.dart

@@ -1,92 +0,0 @@
-// ignore_for_file: non_constant_identifier_names
-
-import 'dart:math';
-
-import '../base/BaseFeature.dart';
-
-// Idempotency keys for mutating operations. Adds an `Idempotency-Key`
-// header (name configurable) to unsafe requests so a server can
-// de-duplicate retried writes. The key is set once, at PreRequest, before
-// the request is built — so it is stable across transport-level retries of
-// the same call. A caller-supplied header is never overwritten.
-class IdempotencyFeature extends BaseFeature {
-  dynamic _client;
-
-  IdempotencyFeature() {
-    version = '0.0.1';
-    name = 'idempotency';
-    active = true;
-  }
-
-  @override
-  dynamic init(dynamic ctx, dynamic opts) {
-    _client = ctx.client;
-    options = opts is Map ? Map<String, dynamic>.from(opts) : {};
-    active = true == options['active'];
-    return null;
-  }
-
-  @override
-  dynamic PreRequest(dynamic ctx) {
-    final spec = ctx.spec;
-    if (null == spec) {
-      return null;
-    }
-
-    if (!_mutating(ctx)) {
-      return null;
-    }
-
-    final header = options['header'] ?? 'Idempotency-Key';
-    spec.headers ??= {};
-
-    // Respect a key the caller already provided.
-    if (null != _existing(spec.headers, header)) {
-      return null;
-    }
-
-    final key = _genkey();
-    spec.headers[header] = key;
-
-    final track = _client.track;
-    if (null == track['idempotency']) {
-      track['idempotency'] = <String, dynamic>{'issued': 0, 'last': null};
-    }
-    track['idempotency']['issued']++;
-    track['idempotency']['last'] = key;
-    return null;
-  }
-
-  bool _mutating(dynamic ctx) {
-    final methods = options['methods'] ?? ['POST', 'PUT', 'PATCH', 'DELETE'];
-    final method = (null == ctx.spec || null == ctx.spec.method)
-        ? ''
-        : ctx.spec.method.toString().toUpperCase();
-    if ('' != method && (methods as List).contains(method)) {
-      return true;
-    }
-    final opname = null == ctx.op ? null : ctx.op.name;
-    final ops = options['ops'] ?? ['create', 'update', 'remove'];
-    return (ops as List).contains(opname);
-  }
-
-  dynamic _existing(dynamic headers, String header) {
-    final lower = header.toLowerCase();
-    for (final k in (headers as Map).keys) {
-      if (k.toString().toLowerCase() == lower) {
-        return headers[k];
-      }
-    }
-    return null;
-  }
-
-  String _genkey() {
-    final keygen = options['keygen'];
-    if (keygen is Function) {
-      return keygen().toString();
-    }
-    final rng = Random();
-    final h = () => rng.nextInt(0x8000000).toRadixString(16);
-    return (h() + h() + h() + h()).padRight(24, '0').substring(0, 24);
-  }
-}

package/project/.sdk/tm/dart/lib/feature/log/LogFeature.dart

@@ -1,85 +0,0 @@
-// ignore_for_file: non_constant_identifier_names
-
-import '../base/BaseFeature.dart';
-
-// Structured operation logging. Dependency-free: log records are written
-// with print (or a caller-supplied `logger` function receiving the record
-// map), one line per hook, mirroring the donor log feature's record shape.
-class LogFeature extends BaseFeature {
-  dynamic _client;
-  dynamic _logger;
-
-  LogFeature() {
-    version = '0.0.1';
-    name = 'log';
-    active = true;
-  }
-
-  @override
-  dynamic init(dynamic ctx, dynamic opts) {
-    _client = ctx.client;
-    options = opts is Map ? Map<String, dynamic>.from(opts) : {};
-    active = true == options['active'];
-
-    if (active) {
-      var logger = options['logger'];
-
-      if (null == logger) {
-        final level = options['level'] ?? 'info';
-        logger = (dynamic record) {
-          // ignore: avoid_print
-          print('[' +
-              level.toString() +
-              '] ' +
-              (record is Map ? record['hook'].toString() : '') +
-              ' ' +
-              record.toString());
-        };
-      }
-
-      _logger = logger;
-    }
-  }
-
-  @override
-  dynamic PostConstruct(dynamic ctx) => _loghook('PostConstruct', ctx);
-
-  @override
-  dynamic PostConstructEntity(dynamic ctx) =>
-      _loghook('PostConstructEntity', ctx);
-
-  @override
-  dynamic SetData(dynamic ctx) => _loghook('SetData', ctx);
-
-  @override
-  dynamic GetData(dynamic ctx) => _loghook('GetData', ctx);
-
-  @override
-  dynamic GetMatch(dynamic ctx) => _loghook('GetMatch', ctx);
-
-  @override
-  dynamic PrePoint(dynamic ctx) => _loghook('PrePoint', ctx);
-
-  @override
-  dynamic PreSpec(dynamic ctx) => _loghook('PreSpec', ctx);
-
-  @override
-  dynamic PreRequest(dynamic ctx) => _loghook('PreRequest', ctx);
-
-  @override
-  dynamic PreResponse(dynamic ctx) => _loghook('PreResponse', ctx);
-
-  @override
-  dynamic PreResult(dynamic ctx) => _loghook('PreResult', ctx);
-
-  dynamic _loghook(String hook, dynamic ctx) {
-    if (null != _logger) {
-      _logger({
-        'hook': hook,
-        'op': null == ctx.op ? null : ctx.op.name,
-        'client': null == _client ? null : 'ProjectName',
-      });
-    }
-    return null;
-  }
-}

package/project/.sdk/tm/dart/lib/feature/metrics/MetricsFeature.dart

@@ -1,103 +0,0 @@
-// ignore_for_file: non_constant_identifier_names
-
-import '../base/BaseFeature.dart';
-
-// Statistics capture. Records per-operation counters and latency for every
-// call: totals plus a breakdown keyed by `<entity>.<op>`. Timing starts at
-// endpoint resolution (PrePoint) and stops when the call returns (PreDone)
-// or throws (PreUnexpected). Aggregates live on the client track
-// (`metrics`). The clock is injectable (`now`) for deterministic tests.
-class MetricsFeature extends BaseFeature {
-  dynamic _client;
-  final Map<dynamic, dynamic> _starts = {};
-
-  MetricsFeature() {
-    version = '0.0.1';
-    name = 'metrics';
-    active = true;
-  }
-
-  @override
-  dynamic init(dynamic ctx, dynamic opts) {
-    _client = ctx.client;
-    options = opts is Map ? Map<String, dynamic>.from(opts) : {};
-    active = true == options['active'];
-    _starts.clear();
-
-    final track = _client.track;
-    if (null == track['metrics']) {
-      track['metrics'] = <String, dynamic>{
-        'total': <String, dynamic>{'count': 0, 'ok': 0, 'err': 0, 'totalMs': 0, 'maxMs': 0},
-        'ops': <String, dynamic>{},
-      };
-    }
-    return null;
-  }
-
-  @override
-  dynamic PrePoint(dynamic ctx) {
-    _starts[ctx] = _now();
-    return null;
-  }
-
-  @override
-  dynamic PreDone(dynamic ctx) {
-    // Classify by the actual result: a 4xx/5xx that flows through still
-    // reaches PreDone before the pipeline throws.
-    _record(
-        ctx,
-        null != ctx.result &&
-            false != ctx.result.ok &&
-            null == ctx.result.err);
-    return null;
-  }
-
-  @override
-  dynamic PreUnexpected(dynamic ctx) {
-    _record(ctx, false);
-    return null;
-  }
-
-  void _record(dynamic ctx, bool ok) {
-    // Record once per operation. When a non-2xx result reaches PreDone the
-    // pipeline then throws, firing PreUnexpected too; the missing start
-    // marker makes the second call a no-op.
-    if (!_starts.containsKey(ctx)) {
-      return;
-    }
-    final start = _starts[ctx];
-    var dur = null == start ? 0 : _now() - start;
-    dur = dur < 0 ? 0 : dur;
-    _starts.remove(ctx);
-
-    final m = _client.track['metrics'];
-    final key = (null == ctx.op ? '_' : (ctx.op.entity ?? '_')).toString() +
-        '.' +
-        (null == ctx.op ? '_' : (ctx.op.name ?? '_')).toString();
-
-    var op = m['ops'][key];
-    if (null == op) {
-      op = m['ops'][key] = <String, dynamic>{'count': 0, 'ok': 0, 'err': 0, 'totalMs': 0, 'maxMs': 0};
-    }
-
-    _bump(m['total'], ok, dur);
-    _bump(op, ok, dur);
-  }
-
-  void _bump(dynamic bucket, bool ok, num dur) {
-    bucket['count']++;
-    bucket[ok ? 'ok' : 'err']++;
-    bucket['totalMs'] += dur;
-    if (dur > bucket['maxMs']) {
-      bucket['maxMs'] = dur;
-    }
-  }
-
-  num _now() {
-    final now = options['now'];
-    if (now is Function) {
-      return now();
-    }
-    return DateTime.now().millisecondsSinceEpoch;
-  }
-}

package/project/.sdk/tm/dart/lib/feature/netsim/NetsimFeature.dart

@@ -1,186 +0,0 @@
-// ignore_for_file: non_constant_identifier_names
-
-import 'dart:async';
-
-import '../../utility/voxgig_struct.dart' as vs;
-
-import '../base/BaseFeature.dart';
-
-// Network behaviour simulation. Wraps the active transport (the live
-// dart:io transport or the `test` feature's in-memory mock) and injects
-// realistic network conditions so offline unit tests can exercise slowness,
-// transient failures, rate limiting and outages deterministically.
-//
-// Every injection mode is counter-driven (per client instance) so tests
-// are reproducible without mocking timers. `failRate` adds optional
-// pseudo-random failures via a seeded LCG for coverage-style testing.
-class NetsimFeature extends BaseFeature {
-  dynamic _client;
-  int _calls = 0;
-  int _seed = 1;
-
-  NetsimFeature() {
-    version = '0.0.1';
-    name = 'netsim';
-    active = true;
-  }
-
-  @override
-  dynamic init(dynamic ctx, dynamic opts) {
-    _client = ctx.client;
-    options = opts is Map ? Map<String, dynamic>.from(opts) : {};
-    active = true == options['active'];
-    _seed = options['seed'] is num ? (options['seed'] as num).toInt() : 1;
-    if (0 == _seed) {
-      _seed = 1;
-    }
-    _calls = 0;
-
-    if (!active) {
-      return null;
-    }
-
-    final self = this;
-    final utility = ctx.utility;
-    final inner = utility.fetcher;
-
-    utility.fetcher = (dynamic ctx2, dynamic url, dynamic fetchdef) async {
-      return self._simulate(ctx2, url, fetchdef, inner);
-    };
-    return null;
-  }
-
-  Future<dynamic> _simulate(
-      dynamic ctx, dynamic url, dynamic fetchdef, dynamic inner) async {
-    final opts = options;
-    _calls++;
-    final call = _calls;
-
-    // Record the simulated conditions for test/debug inspection.
-    final applied = <String, dynamic>{};
-
-    // Total outage: every call fails at the transport level.
-    if (true == opts['offline']) {
-      await _sleep(_pickLatency());
-      applied['offline'] = true;
-      _track(ctx, applied);
-      return ctx.error('netsim_offline',
-          'Simulated network offline (URL was: "' + url.toString() + '")');
-    }
-
-    // Connection-level errors for the first N calls (e.g. ECONNRESET).
-    final errorTimes =
-        opts['errorTimes'] is num ? (opts['errorTimes'] as num).toInt() : 0;
-    if (call <= errorTimes) {
-      await _sleep(_pickLatency());
-      applied['error'] = true;
-      _track(ctx, applied);
-      return ctx.error('netsim_conn',
-          'Simulated connection error (call ' + call.toString() + ')');
-    }
-
-    // Rate-limit responses (HTTP 429 + Retry-After) for the first N calls.
-    final rateLimitTimes = opts['rateLimitTimes'] is num
-        ? (opts['rateLimitTimes'] as num).toInt()
-        : 0;
-    if (call <= rateLimitTimes) {
-      await _sleep(_pickLatency());
-      applied['rateLimited'] = true;
-      _track(ctx, applied);
-      return _respond(ctx, 429, null, {
-        'statusText': 'Too Many Requests',
-        'headers': {
-          'retry-after':
-              (null == opts['retryAfter'] ? 0 : opts['retryAfter']).toString()
-        },
-      });
-    }
-
-    // Retryable failure status for the first N calls, or every Nth call.
-    final failStatus = null == opts['failStatus'] ? 503 : opts['failStatus'];
-    final failTimes =
-        opts['failTimes'] is num ? (opts['failTimes'] as num).toInt() : 0;
-    final failEvery =
-        opts['failEvery'] is num ? (opts['failEvery'] as num).toInt() : 0;
-    final failRate = opts['failRate'] is num ? opts['failRate'] as num : 0;
-    final failByCount = call <= failTimes;
-    final failByEvery = 0 < failEvery && 0 == call % failEvery;
-    final failByRate = 0 < failRate && _rand() < failRate;
-    if (failByCount || failByEvery || failByRate) {
-      await _sleep(_pickLatency());
-      applied['failStatus'] = failStatus;
-      _track(ctx, applied);
-      return _respond(ctx, failStatus, null, {'statusText': 'Simulated Failure'});
-    }
-
-    // Otherwise: apply latency then delegate to the real transport.
-    final latency = _pickLatency();
-    applied['latency'] = latency;
-    _track(ctx, applied);
-    await _sleep(latency);
-    return inner(ctx, url, fetchdef);
-  }
-
-  // Latency in ms: a fixed number, or a uniform sample from {min,max}.
-  int _pickLatency() {
-    final l = options['latency'];
-    if (null == l) {
-      return 0;
-    }
-    if (l is num) {
-      return l < 0 ? 0 : l.toInt();
-    }
-    final min = l['min'] is num ? (l['min'] as num).toInt() : 0;
-    final max = null == l['max'] ? min : (l['max'] as num).toInt();
-    if (max <= min) {
-      return min;
-    }
-    return min + (_rand() * (max - min)).floor();
-  }
-
-  Future<void> _sleep(int ms) {
-    if (0 >= ms) {
-      return Future.value();
-    }
-    final sleeper = options['sleep'];
-    if (sleeper is Function) {
-      return Future.value(sleeper(ms)).then((_x) {});
-    }
-    return Future.delayed(Duration(milliseconds: ms));
-  }
-
-  // Deterministic 0..1 pseudo-random via a linear congruential generator.
-  double _rand() {
-    _seed = (_seed * 1103515245 + 12345) & 0x7fffffff;
-    return _seed / 0x7fffffff;
-  }
-
-  void _track(dynamic ctx, dynamic applied) {
-    final track = _client.track;
-    if (null == track['netsim']) {
-      track['netsim'] = <String, dynamic>{'calls': 0, 'applied': <dynamic>[]};
-    }
-    track['netsim']['calls']++;
-    track['netsim']['applied'].add(applied);
-    if (ctx.ctrl is Map && null != ctx.ctrl['explain']) {
-      ctx.ctrl['explain']['netsim'] = track['netsim'];
-    }
-  }
-
-  // Build a transport-shaped response (matching the test feature's mock).
-  dynamic _respond(dynamic ctx, dynamic status, [dynamic data, dynamic extra]) {
-    final out = vs.merge([
-      <String, dynamic>{
-        'status': status,
-        'statusText': 'OK',
-        'json': () => data,
-        'body': 'not-used',
-      },
-      vs.getdef(extra, {}),
-    ]);
-
-    out['headers'] = vs.getprop(out, 'headers', {});
-
-    return out;
-  }
-}