@obinexusltd/obix-binding-swift

TypeScript bindings for an OBIX Swift bridge that connects a libpolycall-style FFI layer to Swift runtimes on iOS and macOS.

Features

• Creates a Swift binding with lifecycle management.
• Builds invocation envelopes for FFI dispatch.
• Exposes dispatch queue, ARC tracking, schema resolution, and Combine stream helpers.
• Supports monoglot, polyglot, and hybrid schema modes.

Installation

npm install @obinexusltd/obix-binding-swift

Usage

import { createSwiftBinding } from '@obinexusltd/obix-binding-swift';

const binding = createSwiftBinding({
  ffiPath: '/path/to/libpolycall',
  schemaMode: 'hybrid',
  memoryModel: 'hybrid',
  objcBridging: true,
  swiftConcurrencyEnabled: true,
  asyncAwaitSupport: true,
  swiftVersion: '5.10',
});

await binding.initialize();

const result = await binding.invoke('render_view', [{ screen: 'home' }]);
console.log(result);

await binding.destroy();

API overview

createSwiftBinding(config)

Creates a SwiftBindingBridge with the following core capabilities:

• initialize() to validate configuration and mark the bridge ready.
• invoke(fn, args) to dispatch FFI calls.
• submitTask(taskId, fn, args, priority?) to queue work.
• getMemoryUsage() to inspect ARC statistics.
• getQueueStats() to inspect dispatch queue activity.
• getSchemaMode() and schemaResolver helpers for schema behavior.
• combineStreamManager for lightweight publisher/subscriber streams.

Development

npm test
npm run build

License

MIT.