nativemason 0.2.0 → 0.3.0

package/dist/application/index.js

@@ -364,9 +364,11 @@ export class BridgeApplication {
     async open(input) {
         if ((input.nativePort === undefined) !== (input.nativeToken === undefined))
             throw new BridgeFault('INVALID_INPUT', 'nativePort and nativeToken must be supplied together');
+        if (input.nativeHost && !input.nativeHost.startsWith('127.') && !input.nativeToken)
+            throw new BridgeFault('INVALID_INPUT', 'LAN pairing requires explicit nativePort and nativeToken');
         const id = randomUUID(), token = input.nativeToken ?? randomUUID(), port = input.nativePort ?? 19482;
         const source = this.deps.source(input.projectRoot);
-        const native = await this.deps.native({ port, token, scenarioId: input.scenarioId, sessionId: id, targetId: input.nativeTarget?.targetId, platform: input.nativeTarget?.platform });
+        const native = await this.deps.native({ port, token, host: input.nativeHost, scenarioId: input.scenarioId, sessionId: id, targetId: input.nativeTarget?.targetId, platform: input.nativeTarget?.platform });
         let browser;
         try {
             browser = await this.deps.browser({ ...input, sessionId: id });

package/dist/editor/planner.js

@@ -1,12 +1,16 @@
 import { createHash } from 'node:crypto';
 import { createTwoFilesPatch } from 'diff';
-import { Node, Project, SyntaxKind } from 'ts-morph';
+import { Node, Project, SyntaxKind, ts } from 'ts-morph';
 import { isLiteralStyleObject, valueText } from './source-format.js';
 import { RnStylePatchSchema, SourceRefSchema } from '@nativemason/contracts';
 export const hashSource = (text) => createHash('sha256').update(text, 'utf8').digest('hex');
 class Unsupported extends Error {
 }
 function reject(message) { throw new Unsupported(message); }
+function hasTrailingComma(sourceText) {
+    const scanner = ts.createScanner(ts.ScriptTarget.Latest, true, ts.LanguageVariant.Standard, sourceText);
+    return scanner.scan() === ts.SyntaxKind.CommaToken && scanner.scan() === ts.SyntaxKind.EndOfFileToken;
+}
 function staticLiteral(expression) {
     if (Node.isStringLiteral(expression) || Node.isNumericLiteral(expression) || Node.isNoSubstitutionTemplateLiteral(expression))
         return true;
@@ -284,7 +288,7 @@ export function planSourcePatch(sourceText, sourceRef, patch, scope) {
             const closing = object.getEnd() - 1;
             const properties = object.getProperties();
             // Inserting before the closing brace preserves comments and all unrelated text.
-            const trailingComma = properties.length > 0 && /,\s*(?:\/\*[\s\S]*?\*\/\s*|\/\/[^\n]*\n\s*)*$/.test(sourceText.slice(properties.at(-1).getEnd(), closing));
+            const trailingComma = properties.length > 0 && hasTrailingComma(sourceText.slice(properties.at(-1).getEnd(), closing));
             edits.push({ start: closing, end: closing, text: `${properties.length && !trailingComma ? ',' : ''} ${additions.join(', ')} ` });
         }
         else if (!object) {

package/dist/editor/transaction-port.js

@@ -92,24 +92,53 @@ export function createTransactionSourcePort(projectRoot) {
             catch (error) {
                 if (error.code !== 'EEXIST')
                     throw error;
-                let owner;
+                const recovery = path.join(dir, 'transaction.recovery.lock');
+                let recoveryHandle;
                 try {
-                    owner = JSON.parse(await readFile(lock, 'utf8'));
+                    recoveryHandle = await open(recovery, 'wx', 0o600);
+                    await recoveryHandle.writeFile(JSON.stringify({ pid: process.pid }));
+                    await recoveryHandle.sync();
+                    await recoveryHandle.close();
+                    recoveryHandle = undefined;
                 }
-                catch {
-                    throw new BridgeFault('INTERNAL_ERROR', 'Transaction lock is unreadable; recovery requires checking the owning process');
+                catch (cause) {
+                    const created = recoveryHandle !== undefined;
+                    await recoveryHandle?.close().catch(() => undefined);
+                    if (created)
+                        await remove(recovery).catch(() => undefined);
+                    if (cause.code === 'EEXIST' && !created)
+                        throw new BridgeFault('RECOVERY_CONFLICT', 'Transaction recovery is locked; inspect .nativemason/transaction.recovery.lock for its owner before retrying');
+                    throw cause;
                 }
                 try {
-                    process.kill(owner.pid, 0);
-                    throw new BridgeFault('INVALID_INPUT', 'Another source transaction is active');
+                    let owner;
+                    try {
+                        const decoded = JSON.parse(await readFile(lock, 'utf8'));
+                        if (!decoded || typeof decoded !== 'object' || Array.isArray(decoded) || !Number.isSafeInteger(decoded.pid) || (decoded.pid <= 0))
+                            throw new Error('Invalid lock owner');
+                        owner = decoded;
+                    }
+                    catch (cause) {
+                        if (cause.code !== 'ENOENT')
+                            throw new BridgeFault('INTERNAL_ERROR', 'Transaction lock is unreadable; recovery requires checking the owning process');
+                    }
+                    if (owner) {
+                        try {
+                            process.kill(owner.pid, 0);
+                            throw new BridgeFault('INVALID_INPUT', 'Another source transaction is active');
+                        }
+                        catch (cause) {
+                            if (cause instanceof BridgeFault)
+                                throw cause;
+                            if (cause.code !== 'ESRCH')
+                                throw cause;
+                        }
+                        await remove(lock);
+                    }
                 }
-                catch (cause) {
-                    if (cause instanceof BridgeFault)
-                        throw cause;
-                    if (cause.code !== 'ESRCH')
-                        throw cause;
+                finally {
+                    await remove(recovery);
                 }
-                await remove(lock);
                 return work();
             }
             try {

package/dist/mcp/index.js

@@ -20,7 +20,7 @@ const descriptions = {
     close_session: 'Close Chromium and native transport and discard session state.',
 };
 export function createMcpServer(application = new BridgeApplication()) {
-    const server = new McpServer({ name: 'nativemason', version: '0.2.0' });
+    const server = new McpServer({ name: 'nativemason', version: '0.3.0' });
     server.registerPrompt('layout-workflow', { description: 'Measured layout correction workflow' }, async () => ({ messages: [{ role: 'user', content: { type: 'text', text: 'Open a session for the same named scenario on web and native. Inspect measurements and diagnostics; load or infer and review constraints. Use suggest_fix or batch trials, preview the transaction and blast radius, then apply only an accepted candidate. Verify matching committed revisions on the selected native target. Report unavailable evidence; use revert_commit when requested and verify the revert. Close the session.' } }] }));
     for (const name of Object.keys(ToolSchemas)) {
         server.registerTool(name, { description: descriptions[name], inputSchema: ToolSchemas[name].shape, outputSchema: ToolMcpOutputSchemas[name] }, async (input) => {

package/dist/native/index.js

@@ -1,8 +1,11 @@
 import { randomUUID, timingSafeEqual } from 'node:crypto';
 import { WebSocketServer, WebSocket } from 'ws';
-import { BridgeFault, NativeClientMessageSchema } from '@nativemason/contracts';
+import { BridgeFault, NativeBindHostSchema, NativeClientMessageSchema } from '@nativemason/contracts';
 export async function createNativeBridge(options) {
-    const server = new WebSocketServer({ host: '127.0.0.1', port: options.port, maxPayload: 4 * 1024 * 1024 });
+    const host = NativeBindHostSchema.safeParse(options.host ?? '127.0.0.1');
+    if (!host.success)
+        throw new BridgeFault('INVALID_INPUT', 'Native host must be a loopback or private LAN IPv4 interface address');
+    const server = new WebSocketServer({ host: host.data, port: options.port, maxPayload: 4 * 1024 * 1024 });
     await new Promise((resolve, reject) => { server.once('listening', resolve); server.once('error', reject); });
     let client;
     let closed = false;

package/dist/scenario/index.js

@@ -87,6 +87,8 @@ export function createNativeScenarioPort(options) {
             if (closed)
                 throw new BridgeFault('SESSION_NOT_FOUND', 'Native scenario driver is closed');
             const parsed = ScenarioScriptSchema.parse(script);
+            if (options.target.platform === 'ios' && options.target.kind === 'physical' && [...parsed.reset, ...parsed.actions].some(action => action.type !== 'hook'))
+                throw new BridgeFault('UNSUPPORTED_ACTION', 'Physical iOS supports registered app hooks; Maestro UI actions require an iOS simulator. Navigate manually before capture.');
             // Reject unsupported static actions before executing earlier hooks or UI actions.
             for (const action of [...parsed.reset, ...parsed.actions]) {
                 if (action.type === 'hook' && !options.runHook)
@@ -238,6 +240,16 @@ export function createNativeProfilePort(options) {
     return {
         recover: () => recover(),
         async withProfile(profile, work) {
+            if (options.target.platform === 'ios' && options.target.kind === 'physical') {
+                if (profile.fontScale !== undefined || profile.orientation !== undefined) {
+                    if (!options.readProfile)
+                        throw new BridgeFault('UNSUPPORTED_PROFILE', 'Physical iOS profile checks require runtime measurements');
+                    const actual = await options.readProfile();
+                    if ((profile.fontScale !== undefined && Math.abs(actual.fontScale - profile.fontScale) > 0.01) || (profile.orientation !== undefined && actual.orientation !== profile.orientation))
+                        throw new BridgeFault('UNSUPPORTED_PROFILE', 'Change font scale or orientation manually on the iOS device, then capture its measured profile');
+                }
+                return work();
+            }
             if (active || profileOperations.has(journal))
                 throw new BridgeFault('RECOVERY_CONFLICT', 'Native profile operations must be serialized');
             active = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nativemason",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "nativemason": "./bin/nativemason.js",
@@ -17,10 +17,10 @@
     "@babel/core": "^7.28.5",
     "@babel/types": "^7.28.5",
     "@modelcontextprotocol/sdk": "^1.24.0",
-    "@nativemason/contracts": "0.2.0",
+    "@nativemason/contracts": "0.3.0",
     "diff": "^8.0.2",
     "playwright": "^1.56.1",
-    "sharp": "^0.34.5",
+    "sharp": "^0.35.5",
     "ts-morph": "^27.0.2",
     "ws": "^8.18.3"
   },