@mikrojs/native 0.18.0 → 0.18.1

package/dist/runtime/schema/shared.js

@@ -0,0 +1,489 @@
+/* Host-side helpers for config schemas, shared by the CLI and registries.
+ * Not part of the mikro/schema device bundle: the device never validates a
+ * schema AST (its manifest copy was written by the CLI) and never derives an
+ * overlay. Imports core.ts only, so hosts load it without resolving mikro/*
+ * builtins; results are plain {ok} shapes for the same reason. */
+import { applyDefaults, SchemaError, validate } from './core.js';
+const MAX_DEPTH = 8;
+const KINDS = new Set([
+    'string',
+    'number',
+    'boolean',
+    'unknown',
+    'literal',
+    'array',
+    'object',
+    'optional',
+    'tuple',
+    'union',
+    'taggedUnion',
+]);
+function fail(message, path) {
+    return { ok: false, error: SchemaError.ValidationFailed(message, path) };
+}
+/* JSON.parse creates `__proto__` as an own key, and downstream walks assign
+ * overlay values through `out[key] = …` — with these keys that assignment
+ * writes the prototype, not a property. The AST is untrusted, so refuse them
+ * outright. */
+const UNSAFE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/**
+ * Validates an untrusted serialized schema AST as a config schema: well-formed
+ * nodes only, an object at the root, no `unknown()`, no `optional()` around an
+ * object or array (an overlay needs every absence to mean exactly one thing),
+ * defaults that match their own node, and nesting of at most 8 levels.
+ * The size cap is the caller's, since only the caller sees encoded bytes.
+ */
+export function parseConfigSchema(value) {
+    if (!isPlainObject(value) || value.kind !== 'object') {
+        return fail('config schema root must be an object()', '');
+    }
+    const result = walk(value, '', 1);
+    if (result !== null)
+        return result;
+    return { ok: true, value: value };
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/* A default below a wholesale unit never applies: applyDefaults replaces the
+ * unit whole, so only the unit's own whole-value default fills anything. The
+ * constructors reject it where it is written (core.ts, rejectInnerDefaults);
+ * a schema that arrived as JSON ran none of them, so the same rule is enforced
+ * here. The whole subtree is walked, not just the plain-object path, because
+ * nothing checked a nested unit's contents on the way in. Structure is already
+ * validated by `walk`, so a non-node here is left for it to report. */
+function rejectInnerDefaults(value, path, unit, self) {
+    if (!isPlainObject(value))
+        return null;
+    if (value.default !== undefined) {
+        return fail(`a default under ${unit} never applies; give ${self} itself a whole-value default instead`, path);
+    }
+    const children = [];
+    for (const key of ['shape', 'branches']) {
+        const map = value[key];
+        if (isPlainObject(map)) {
+            for (const name of Object.keys(map))
+                children.push([map[name], `${path}.${name}`]);
+        }
+    }
+    for (const key of ['element', 'inner']) {
+        if (value[key] !== undefined)
+            children.push([value[key], path]);
+    }
+    for (const key of ['elements', 'members']) {
+        const items = value[key];
+        if (Array.isArray(items)) {
+            for (let i = 0; i < items.length; i++)
+                children.push([items[i], `${path}[${i}]`]);
+        }
+    }
+    for (const [child, childPath] of children) {
+        const result = rejectInnerDefaults(child, childPath, unit, self);
+        if (result !== null)
+            return result;
+    }
+    return null;
+}
+function walk(value, path, depth) {
+    if (depth > MAX_DEPTH)
+        return fail(`nesting deeper than ${MAX_DEPTH} levels`, path);
+    if (!isPlainObject(value))
+        return fail('expected a schema node', path);
+    const node = value;
+    const kind = node.kind;
+    if (typeof kind !== 'string' || !KINDS.has(kind)) {
+        return fail(`unknown schema kind ${JSON.stringify(kind)}`, path);
+    }
+    if (kind === 'unknown')
+        return fail('unknown() is not allowed in a config schema', path);
+    switch (kind) {
+        case 'literal': {
+            const t = typeof node.value;
+            if (t !== 'string' && t !== 'number' && t !== 'boolean') {
+                return fail('literal value must be a primitive', path);
+            }
+            break;
+        }
+        case 'array': {
+            const result = walk(node.element, `${path}.element`, depth + 1);
+            if (result !== null)
+                return result;
+            const inner = rejectInnerDefaults(node.element, `${path}.element`, 'an array', 'the array');
+            if (inner !== null)
+                return inner;
+            break;
+        }
+        case 'object': {
+            if (!isPlainObject(node.shape))
+                return fail('object shape must be a map', path);
+            if (node.default !== undefined)
+                return fail('object() cannot carry a default', path);
+            for (const key of Object.keys(node.shape)) {
+                if (UNSAFE_KEYS.has(key))
+                    return fail(`unsafe field name ${JSON.stringify(key)}`, path);
+                const result = walk(node.shape[key], `${path}.${key}`, depth + 1);
+                if (result !== null)
+                    return result;
+            }
+            break;
+        }
+        case 'optional': {
+            const inner = node.inner;
+            if (isPlainObject(inner) && (inner.kind === 'object' || inner.kind === 'array')) {
+                return fail(`optional() cannot wrap an ${inner.kind} in a config schema`, path);
+            }
+            if (node.default !== undefined) {
+                // The wrapper never carries one (the constructor forbids it); in an
+                // untrusted AST it would validate here and then be ignored by
+                // applyDefaults, a default that silently never applies.
+                return fail('optional() cannot carry a default', path);
+            }
+            if (isPlainObject(inner) && inner.default !== undefined) {
+                return fail('optional() cannot wrap a schema with a default', path);
+            }
+            const result = walk(inner, path, depth + 1);
+            if (result !== null)
+                return result;
+            break;
+        }
+        case 'tuple':
+        case 'union': {
+            const items = kind === 'tuple' ? node.elements : node.members;
+            if (!Array.isArray(items))
+                return fail(`${kind} items must be an array`, path);
+            if (kind === 'union' && items.length === 0) {
+                // Unsatisfiable: no value matches an empty union, so it would only
+                // fail later, at serve, one device at a time.
+                return fail('union needs at least one member', path);
+            }
+            for (let i = 0; i < items.length; i++) {
+                const result = walk(items[i], `${path}[${i}]`, depth + 1);
+                if (result !== null)
+                    return result;
+                const unit = kind === 'tuple' ? 'a tuple' : 'a union';
+                const inner = rejectInnerDefaults(items[i], `${path}[${i}]`, unit, `the ${kind}`);
+                if (inner !== null)
+                    return inner;
+            }
+            break;
+        }
+        case 'taggedUnion': {
+            if (typeof node.key !== 'string')
+                return fail('taggedUnion key must be a string', path);
+            if (!isPlainObject(node.branches))
+                return fail('taggedUnion branches must be a map', path);
+            if (Object.keys(node.branches).length === 0) {
+                // Unsatisfiable, like an empty union: it would only fail at serve.
+                return fail('taggedUnion needs at least one branch', path);
+            }
+            for (const tag of Object.keys(node.branches)) {
+                if (UNSAFE_KEYS.has(tag))
+                    return fail(`unsafe branch tag ${JSON.stringify(tag)}`, path);
+                const branch = node.branches[tag];
+                if (!isPlainObject(branch) || branch.kind !== 'object') {
+                    return fail('taggedUnion branch must be an object()', `${path}.${tag}`);
+                }
+                const result = walk(branch, `${path}.${tag}`, depth + 1);
+                if (result !== null)
+                    return result;
+                const inner = rejectInnerDefaults(branch, `${path}.${tag}`, 'a taggedUnion', 'the union');
+                if (inner !== null)
+                    return inner;
+            }
+            break;
+        }
+    }
+    if (node.default !== undefined) {
+        const check = validate(node, node.default, '');
+        if (check !== null) {
+            return fail(`default does not match the schema: ${check.error.message}`, path);
+        }
+    }
+    return null;
+}
+/**
+ * Derives the overlay to store or serve from operator-supplied values: drops
+ * keys the schema does not know, strips values structurally equal to the
+ * schema default, and prunes empty objects and arrays. Returns undefined when
+ * nothing deviates from the defaults. Wholesale nodes (arrays, tuples, unions)
+ * are compared and kept as units; nothing inside them is stripped.
+ */
+export function deriveOverlay(schema, values) {
+    switch (schema.kind) {
+        case 'object': {
+            if (values === undefined)
+                return undefined;
+            // A defined value of the wrong kind is kept, not dropped: dropping it
+            // would derive a clean overlay from garbage, so a typo'd save would
+            // succeed while storing nothing and rule 5 would never gate on it.
+            // Kept, it fails the merge-validate that every caller runs next.
+            if (!isPlainObject(values))
+                return values;
+            const out = {};
+            for (const key of Object.keys(schema.shape)) {
+                const field = schema.shape[key];
+                const value = values[key];
+                if (value === undefined)
+                    continue;
+                const derived = field.kind === 'optional'
+                    ? deriveOverlay(field.inner, value)
+                    : deriveOverlay(field, value);
+                if (derived !== undefined)
+                    out[key] = derived;
+            }
+            return Object.keys(out).length > 0 ? out : undefined;
+        }
+        case 'array': {
+            if (values === undefined)
+                return undefined;
+            // Wrong kind kept for the same reason as objects above; only a real
+            // empty array prunes (emptiness is never a deliberate overlay state).
+            if (!Array.isArray(values))
+                return values;
+            if (values.length === 0)
+                return undefined;
+            if (schema.default !== undefined && structuralEquals(values, schema.default)) {
+                return undefined;
+            }
+            return stripDangerousKeys(values);
+        }
+        default: {
+            const fallback = schema.default;
+            if (fallback !== undefined && structuralEquals(values, fallback))
+                return undefined;
+            return stripDangerousKeys(values);
+        }
+    }
+}
+/** Wholesale units travel with their unknown keys intact, but the three
+ *  prototype-writing names never survive into a stored or served value:
+ *  downstream walks and consumers assign through `out[key]`. */
+function stripDangerousKeys(value) {
+    if (Array.isArray(value))
+        return value.map(stripDangerousKeys);
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const key of Object.keys(value)) {
+            if (UNSAFE_KEYS.has(key))
+                continue;
+            out[key] = stripDangerousKeys(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+export function structuralEquals(a, b) {
+    if (a === b)
+        return true;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (!structuralEquals(a[i], b[i]))
+                return false;
+        }
+        return true;
+    }
+    if (isPlainObject(a) && isPlainObject(b)) {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        for (const key of keysA) {
+            if (!Object.hasOwn(b, key) || !structuralEquals(a[key], b[key]))
+                return false;
+        }
+        return true;
+    }
+    return false;
+}
+/**
+ * The effective config for an overlay: defaults filled in, then validated.
+ * What a registry runs before serving and what `ota.config()` runs on read.
+ */
+export function parseEffective(schema, overlay) {
+    const effective = applyDefaults(schema, overlay);
+    const result = validate(schema, effective, '');
+    return result !== null ? result : { ok: true, value: effective };
+}
+/**
+ * The partial defaults a schema materializes with no overrides: every field a
+ * default covers, and nothing else. Unlike parseEffective it never fails on a
+ * required defaultless field, it omits it. This is what pack bakes into the
+ * manifest and what a device reads when it holds no served document.
+ *
+ * Plain objects compose, so a nested one is included only when defaults fill
+ * it completely: a half-filled object would not validate, and the read type
+ * makes that field optional anyway. Wholesale units (array, tuple, union,
+ * taggedUnion) need a whole-value default on the node itself, matching
+ * applyDefaults, where a default inside an element or branch is a form hint.
+ * Optional fields rest on absence, so they are omitted too.
+ */
+export function materializeDefaults(schema) {
+    return schema.kind === 'object' ? fillObject(schema).value : {};
+}
+/** What defaults cover in an object shape. `complete` (every field covered or
+ *  optional) is what makes a NESTED object safe to include. */
+function fillObject(node) {
+    const out = {};
+    let complete = true;
+    for (const key of Object.keys(node.shape)) {
+        const field = node.shape[key];
+        if (field.kind === 'optional')
+            continue;
+        const filled = fillField(field);
+        if (filled === undefined)
+            complete = false;
+        else
+            out[key] = filled.value;
+    }
+    return { value: out, complete };
+}
+/** The value defaults give one field, or undefined when nothing covers it. */
+function fillField(node) {
+    if (node.kind === 'object') {
+        const filled = fillObject(node);
+        return filled.complete ? { value: filled.value } : undefined;
+    }
+    const fallback = node.default;
+    return fallback === undefined ? undefined : { value: fallback };
+}
+/** A node with its annotations removed, recursively, so two schemas can be
+ *  compared on structure alone. */
+function stripAnnotations(node) {
+    if (!isPlainObject(node))
+        return node;
+    const { default: _default, ...rest } = node;
+    const out = {};
+    for (const key of Object.keys(rest)) {
+        const value = rest[key];
+        if (key === 'shape' || key === 'branches') {
+            const map = value;
+            const stripped = {};
+            for (const k of Object.keys(map))
+                stripped[k] = stripAnnotations(map[k]);
+            out[key] = stripped;
+        }
+        else if (key === 'element' || key === 'inner') {
+            out[key] = stripAnnotations(value);
+        }
+        else if (key === 'elements' || key === 'members') {
+            out[key] = value.map(stripAnnotations);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/** required / defaulted / optional, per the spec's scalar-leaf classes.
+ *  Containers have no class; objects report 'object' so the walk descends. */
+function leafClass(node) {
+    if (node.kind === 'optional')
+        return 'optional';
+    if (node.kind === 'object')
+        return 'object';
+    if (node.kind === 'array')
+        return 'array';
+    return node.default !== undefined ? 'defaulted' : 'required';
+}
+/** Every required scalar leaf reachable in `node`, for reporting an added
+ *  subtree that will gate offers until an operator supplies values. */
+function requiredLeaves(node, path, out) {
+    if (node.kind === 'object') {
+        for (const key of Object.keys(node.shape)) {
+            requiredLeaves(node.shape[key], `${path}.${key}`, out);
+        }
+        return;
+    }
+    if (leafClass(node) === 'required')
+        out.push(path);
+}
+/**
+ * Human-readable warnings for what changed between two releases' config
+ * schemas, per the spec's change taxonomy (registry-spec.md, "Schema changes
+ * between releases"). Safe changes (new defaulted or optional fields, added
+ * union members, loosened requirements) produce nothing. "requires an
+ * operator" lines gate offers under rule 5 until someone supplies or fixes a
+ * value; "note" lines are compatible but worth telling the operator about.
+ */
+export function diffConfigSchemas(previous, next) {
+    const warnings = [];
+    function walk(prev, curr, path) {
+        const prevInner = prev.kind === 'optional' ? prev.inner : prev;
+        const currInner = curr.kind === 'optional' ? curr.inner : curr;
+        if (prevInner.kind === 'object' && currInner.kind === 'object') {
+            const prevShape = prevInner.shape;
+            const currShape = currInner.shape;
+            for (const key of Object.keys(currShape)) {
+                const fieldPath = `${path}.${key}`;
+                if (Object.hasOwn(prevShape, key)) {
+                    walk(prevShape[key], currShape[key], fieldPath);
+                }
+                else {
+                    const added = [];
+                    requiredLeaves(currShape[key], fieldPath, added);
+                    for (const leaf of added) {
+                        warnings.push(`requires an operator: new required field ${leaf} (devices are not offered ` +
+                            `this release until a value is set)`);
+                    }
+                }
+            }
+            for (const key of Object.keys(prevShape)) {
+                if (!Object.hasOwn(currShape, key)) {
+                    warnings.push(`note: removed field ${path}.${key} (stored overrides for it stay, but are no ` +
+                        `longer served)`);
+                }
+            }
+            return;
+        }
+        if (prevInner.kind === 'union' && currInner.kind === 'union') {
+            // Member sets, not wholesale structure: adding a member (the common
+            // safe widening) must not read as a type change. Only removals can
+            // invalidate a stored override.
+            const removed = prevInner.members.filter((prevMember) => !currInner.members.some((currMember) => structuralEquals(stripAnnotations(prevMember), stripAnnotations(currMember))));
+            if (removed.length > 0) {
+                warnings.push(`requires an operator: ${path} removed ${removed.length} union member(s) ` +
+                    `(stored overrides using them no longer validate)`);
+            }
+        }
+        else if (prevInner.kind === 'taggedUnion' &&
+            currInner.kind === 'taggedUnion' &&
+            prevInner.key === currInner.key) {
+            // Same idea per branch: added branches are safe, removed or reshaped
+            // ones can strand a stored override.
+            for (const tag of Object.keys(prevInner.branches)) {
+                const prevBranch = prevInner.branches[tag];
+                const currBranch = currInner.branches[tag];
+                if (currBranch === undefined || !Object.hasOwn(currInner.branches, tag)) {
+                    warnings.push(`requires an operator: ${path} removed branch ${JSON.stringify(tag)} ` +
+                        `(stored overrides using it no longer validate)`);
+                }
+                else if (!structuralEquals(stripAnnotations(prevBranch), stripAnnotations(currBranch))) {
+                    warnings.push(`requires an operator: ${path}.${tag} changed type ` +
+                        `(stored overrides may no longer validate)`);
+                }
+            }
+        }
+        else if (!structuralEquals(stripAnnotations(prevInner), stripAnnotations(currInner))) {
+            warnings.push(`requires an operator: ${path} changed type (stored overrides may no longer validate)`);
+            return;
+        }
+        const prevClass = leafClass(prev);
+        const currClass = leafClass(curr);
+        if (currClass === 'required' && prevClass !== 'required') {
+            warnings.push(`requires an operator: ${path} is now required (devices without a value are not ` +
+                `offered this release)`);
+        }
+        const prevDefault = prevInner.default;
+        const currDefault = currInner.default;
+        // A removed default is the required-transition above, not also a default
+        // change.
+        if (currDefault !== undefined && !structuralEquals(prevDefault, currDefault)) {
+            warnings.push(`note: default of ${path} changed (takes effect on every device without an override)`);
+        }
+    }
+    walk(previous, next, '');
+    return warnings;
+}
+//# sourceMappingURL=shared.js.map

package/dist/runtime/schema/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../runtime/schema/shared.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -46,5 +46,12 @@ export interface NativeBindings {
     MikroRuntime: new (options?: MikroRuntimeOptions) => NativeMikroRuntime;
     jsonToBjson(json: string): Buffer;
     compileBytecode(source: string, moduleName: string, externals?: string[]): Buffer;
+    parseOffer(body: unknown, options?: {
+        allowInsecure?: boolean;
+    }): {
+        url: string;
+        checksum: string;
+        size: number;
+    } | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,QAAQ,IAAI,MAAM,CAAA;IAClB,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,aAAa,IAAI,WAAW,EAAE,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;IACvB,UAAU,IAAI,YAAY,EAAE,CAAA;IAC5B,kBAAkB,IAAI,MAAM,CAAA;IAC5B,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAA;IACpD,EAAE,IAAI,IAAI,CAAA;IACV,iBAAiB,IAAI,IAAI,CAAA;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;CAClF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../addon/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,QAAQ,IAAI,MAAM,CAAA;IAClB,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,aAAa,IAAI,WAAW,EAAE,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IACnF,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;IACvB,UAAU,IAAI,YAAY,EAAE,CAAA;IAC5B,kBAAkB,IAAI,MAAM,CAAA;IAC5B,WAAW,IAAI;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAA;IACpD,EAAE,IAAI,IAAI,CAAA;IACV,iBAAiB,IAAI,IAAI,CAAA;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,KAAK,OAAO,CAAC,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACjC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACjF,UAAU,CACR,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAC,GAClC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAA;CAC7D"}

package/include/mikrojs/cbor_helpers.h

@@ -22,3 +22,23 @@ int mik__cbor_encode_value(JSContext* ctx, nanocbor_encoder_t* enc, JSValue val,
  * Returns JS_EXCEPTION on error.
  */
 JSValue mik__cbor_decode_value(JSContext* ctx, nanocbor_value_t* val, int depth);
+
+/**
+ * Skip the value at the iterator, treating it as ONE item of the container the
+ * iterator is walking.
+ *
+ * nanocbor_skip() cannot be used directly for that: it walks a nested container
+ * on the same iterator and decrements `remaining` once per inner item, so
+ * skipping a container value underflows the outer container's count and every
+ * later key reads as "end of map". Lifting the count for the duration keeps the
+ * walk bounded by the buffer end, which is the bound that matters.
+ *
+ * Returns what nanocbor_skip() returned.
+ */
+static inline int mik__cbor_skip_value(nanocbor_value_t* it) {
+    uint64_t remaining = it->remaining;
+    it->remaining = UINT64_MAX;
+    int res = nanocbor_skip(it);
+    it->remaining = remaining > 0 ? remaining - 1 : 0;
+    return res;
+}

package/include/mikrojs/mem.h

@@ -26,3 +26,14 @@ void* mik__js_realloc(void* ptr, size_t size);
  * the original pointer came from. */
 void mik__set_quickjs_heap_psram(bool enable);
 bool mik__is_quickjs_heap_psram(void);
+
+#ifdef MIK_OOM_INJECT
+#include <stdint.h>
+/* Host-test fault injection (standalone builds only; ESP-IDF compiles
+ * without MIK_OOM_INJECT). After `n` more mik__js_* allocations succeed,
+ * every subsequent one fails until re-armed; n < 0 disables. */
+void mik__oom_inject_fail_after(int64_t n);
+/* Net live allocations across all mem.cpp allocators, for leak checks
+ * spanning an inject/recover cycle. */
+int64_t mik__oom_inject_live_allocs(void);
+#endif

package/include/mikrojs/mikrojs.h

@@ -141,7 +141,8 @@ void MIK_SetErrorHandler(MIKRuntime* mik_rt, MIKErrorHandlerFn fn, void* opaque)
 /* Module source preprocessor — called on source files before compilation.
  * The callback receives filename, source, and source_len. It should return
  * a malloc'd string and set *out_len, or return NULL to use the original source.
- * The caller frees the returned string with free(). */
+ * The returned buffer must be null-terminated (JS_Eval reads buf[len]) and
+ * *out_len excludes the terminator. The caller frees it with free(). */
 typedef char* (*MIKPreprocessFn)(const char* filename, const char* source, size_t source_len,
                                  size_t* out_len, void* opaque);
 void MIK_SetPreprocessor(MIKRuntime* mik_rt, MIKPreprocessFn fn, void* opaque);