A high level, cross-platform API for Bluetooth Pub-Sub

Create an instance of a Bluetooth service.

constructor is an example property that is set to true Creates a new service with key-value pairs

Start the bluetooth service.

Start scanning for published values that correspond to a well-known UUID. Once subscribed to a UUID, events that correspond to that UUID will be emitted. To receive these events you can add an event listener, for example...

const ble = new Bluetooth(id)
ble.subscribe(uuid)
ble.on(uuid, (data, details) => {
  // ...do something interesting
})

Start advertising a new value for a well-known UUID

External docs: https://nodejs.org/api/buffer.html#buffer_class_buffer

Some high level methods around the crypto.subtle api for getting random bytes and hashing.

WebCrypto API

External docs: https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues

Generate cryptographically strong random values into buffer

Maximum total size of random bytes per page

Maximum total size for random bytes.

Maximum total amount of allocated per page of bytes (max/quota)

Generate size random bytes.

This module provides an implementation of UDP datagram sockets. It does not (yet) provide any of the multicast methods or properties.

Thrown when a socket is already bound.

Thrown when the socket is already connected.

Thrown when the socket is not connected.

Thrown when the socket is not running (not bound or connected).

Thrown when a bad socket type is used in an argument.

Thrown when a bad port is given.

Creates a Socket instance. if ()

New instances of dgram.Socket are created using dgram.createSocket(). The new keyword is not to be used to create dgram.Socket instances.

Implements gc.finalizer for gc'd resource cleanup.

External docs: https://nodejs.org/api/dgram.html#socketbindport-address-callback

Listen for datagram messages on a named port and optional address If address is not specified, the operating system will attempt to listen on all addresses. Once binding is complete, a 'listening' event is emitted and the optional callback function is called.

If binding fails, an 'error' event is emitted.

External docs: https://nodejs.org/api/dgram.html#socketconnectport-address-callback

Associates the dgram.Socket to a remote address and port. Every message sent by this handle is automatically sent to that destination. Also, the socket will only receive messages from that remote peer. Trying to call connect() on an already connected socket will result in an ERR_SOCKET_DGRAM_IS_CONNECTED exception. If address is not provided, '127.0.0.1' (for udp4 sockets) or '::1' (for udp6 sockets) will be used by default. Once the connection is complete, a 'connect' event is emitted and the optional callback function is called. In case of failure, the callback is called or, failing this, an 'error' event is emitted.

External docs: https://nodejs.org/api/dgram.html#socketdisconnect

A synchronous function that disassociates a connected dgram.Socket from its remote address. Trying to call disconnect() on an unbound or already disconnected socket will result in an ERR_SOCKET_DGRAM_NOT_CONNECTED exception.

External docs: https://nodejs.org/api/dgram.html#socketsendmsg-offset-length-port-address-callback

Broadcasts a datagram on the socket. For connectionless sockets, the destination port and address must be specified. Connected sockets, on the other hand, will use their associated remote endpoint, so the port and address arguments must not be set.

The msg argument contains the message to be sent. Depending on its type, different behavior can apply. If msg is a Buffer, any TypedArray or a DataView, the offset and length specify the offset within the Buffer where the message begins and the number of bytes in the message, respectively. If msg is a String, then it is automatically converted to a Buffer with 'utf8' encoding. With messages that contain multi-byte characters, offset and length will be calculated with respect to byte length and not the character position. If msg is an array, offset and length must not be specified.

The address argument is a string. If the value of address is a host name, DNS will be used to resolve the address of the host. If address is not provided or otherwise nullish, '127.0.0.1' (for udp4 sockets) or '::1' (for udp6 sockets) will be used by default.

If the socket has not been previously bound with a call to bind, the socket is assigned a random port number and is bound to the "all interfaces" address ('0.0.0.0' for udp4 sockets, '::0' for udp6 sockets.)

An optional callback function may be specified to as a way of reporting DNS errors or for determining when it is safe to reuse the buf object. DNS lookups delay the time to send for at least one tick of the Node.js event loop.

The only way to know for sure that the datagram has been sent is by using a callback. If an error occurs and a callback is given, the error will be passed as the first argument to the callback. If a callback is not given, the error is emitted as an 'error' event on the socket object.

Offset and length are optional but both must be set if either are used. They are supported only when the first argument is a Buffer, a TypedArray, or a DataView.

External docs: https://nodejs.org/api/dgram.html#socketclosecallback

Close the underlying socket and stop listening for data on it. If a callback is provided, it is added as a listener for the 'close' event.

External docs: https://nodejs.org/api/dgram.html#socketaddress

Returns an object containing the address information for a socket. For UDP sockets, this object will contain address, family, and port properties.

This method throws EBADF if called on an unbound socket.

External docs: https://nodejs.org/api/dgram.html#socketremoteaddress

Returns an object containing the address, family, and port of the remote endpoint. This method throws an ERR_SOCKET_DGRAM_NOT_CONNECTED exception if the socket is not connected.

External docs: https://nodejs.org/api/dgram.html#socketsetrecvbuffersizesize

Sets the SO_RCVBUF socket option. Sets the maximum socket receive buffer in bytes.

External docs: https://nodejs.org/api/dgram.html#socketsetsendbuffersizesize

Sets the SO_SNDBUF socket option. Sets the maximum socket send buffer in bytes.

External docs: https://nodejs.org/api/dgram.html#socketgetrecvbuffersize

External docs: https://nodejs.org/api/dgram.html#socketgetsendbuffersize

This module enables name resolution. For example, use it to look up IP addresses of host names. Although named for the Domain Name System (DNS), it does not always use the DNS protocol for lookups. dns.lookup() uses the operating system facilities to perform name resolution. It may not need to perform any network communication. To perform name resolution the way other applications on the same system do, use dns.lookup().

External docs: https://nodejs.org/api/dns.html#dns_dns_lookup_hostname_options_callback

Resolves a host name (e.g. example.org) into the first found A (IPv4) or AAAA (IPv6) record. All option properties are optional. If options is an integer, then it must be 4 or 6 – if options is 0 or not provided, then IPv4 and IPv6 addresses are both returned if found.

From the node.js website...

With the all option set to true, the arguments for callback change to (err, addresses), with addresses being an array of objects with the properties address and family.

On error, err is an Error object, where err.code is the error code. Keep in mind that err.code will be set to 'ENOTFOUND' not only when the host name does not exist but also when the lookup fails in other ways such as no available file descriptors. dns.lookup() does not necessarily have anything to do with the DNS protocol. The implementation uses an operating system facility that can associate names with addresses and vice versa. This implementation can have subtle but important consequences on the behavior of any Node.js program. Please take some time to consult the Implementation considerations section before using dns.lookup().

This module enables name resolution. For example, use it to look up IP addresses of host names. Although named for the Domain Name System (DNS), it does not always use the DNS protocol for lookups. dns.lookup() uses the operating system facilities to perform name resolution. It may not need to perform any network communication. To perform name resolution the way other applications on the same system do, use dns.lookup().

External docs: https://nodejs.org/api/dns.html#dnspromiseslookuphostname-options

This module enables interacting with the file system in a way modeled on standard POSIX functions.

The Application Sandbox restricts access to the file system. Please see the Application Sandbox documentation for more information: https://sockets.sh/guides/#working-with-the-file-system-on-ios

To use the promise-based APIs:

import * as fs from '@socketsupply/io/fs/promises.js';

To use the callback and async APIs:

import * as fs from '@socketsupply/io/fs/index.js';

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fsopenpath-flags-mode-callback

Asynchronously check access a file for a given mode calling callback upon success or error.

External docs: https://nodejs.org/api/fs.html#fschmodpath-mode-callback

Asynchronously changes the permissions of a file. No arguments other than a possible exception are given to the completion callback

Asynchronously close a file descriptor calling callback upon success or error.

This is a FunctionDeclaration named copyFile in fs/index.js, it's exported but undocumented.

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fscreatewritestreampath-options

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fscreatewritestreampath-options

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fsfstatfd-options-callback

Invokes the callback with the <fs.Stats> for the file descriptor. See the POSIX fstat(2) documentation for more detail.

Asynchronously open a file calling callback upon success or error.

Asynchronously open a directory calling callback upon success or error.

Asynchronously read from an open file descriptor.

Asynchronously read all entries in a directory.

This is a FunctionDeclaration named writev in fs/index.js, it's exported but undocumented.

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromisesaccesspath-mode

Asynchronously check access a file.

External docs: https://nodejs.org/api/fs.html#fspromisesopenpath-flags-mode

Asynchronously open a file.

External docs: https://nodejs.org/api/fs.html#fspromisesopendirpath-options

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromisesreaddirpath-options

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromisesreadfilepath-options

External docs: https://nodejs.org/dist/latest-v16.x/docs/api/fs.html#fspromiseswritefilefile-data-options

This is a VariableDeclaration named DEFAULT_STREAM_HIGH_WATER_MARK in fs/stream.js, it's exported but undocumented.

A Readable stream for a FileHandle.

ReadStream class constructor

Sets file handle for the ReadStream.

The max buffer size for the ReadStream.

Relative or absolute path of the underlying FileHandle.

true if the stream is in a pending state.

Handles shouldEmitClose setting from options.emitClose in constructor.

A Writable stream for a FileHandle.

WriteStream class constructor

Sets file handle for the WriteStream.

The max buffer size for the Writetream.

Relative or absolute path of the underlying FileHandle.

true if the stream is in a pending state.

Handles shouldEmitClose setting from options.emitClose in constructor.

This is a VariableDeclaration named FileReadStream in fs/stream.js, it's exported but undocumented.

This is a VariableDeclaration named FileWriteStream in fs/stream.js, it's exported but undocumented.

This is a low level API which you don't need unless you are implementing a library on top of Socket SDK. A Socket SDK app has two or three processes.

• The Render process, the UI where the HTML, CSS and JS is run.
• The Bridge process, the thin layer of code that managers everything.
• The Main processs, for apps that need to run heavier compute jobs. And unlike electron it's optional.

The Bridge process manages the Render and Main process, it may also broker data between them.

The Binding process uses standard input and output as a way to communicate. Data written to the write-end of the pipe is buffered by the OS until it is read from the read-end of the pipe.

The IPC protocol uses a simple URI-like scheme. Data is passed as ArrayBuffers.

ipc://command?key1=value1&key2=value2...

Represents an OK IPC status.

Represents an ERROR IPC status.

Timeout in milliseconds for IPC requests.

Symbol for the ipc.debug.enabled property

Parses seq as integer value

If debug.enabled === true, then debug output will be printed to console.

A container for a IPC message based on a ipc:// URI scheme.

The expected protocol for an IPC message.

Creates a Message instance from a variety of input.

Predicate to determine if input is valid for constructing a new Message instance.

Message class constructor.

Computed command for the IPC message.

Computed id value for the command.

Computed seq (sequence) value for the command.

Computed message value potentially given in message parameters. This value is automatically decoded, but not treated as JSON.

Computed index value for the command potentially referring to the window index the command is scoped to or originating from. If not specified in the message parameters, then this value defaults to -1.

Computed value parsed as JSON. This value is null if the value is not present or it is invalid JSON.

Computed readonly object of message parameters.

Returns computed parameters as entries

Set a parameter value by key.

Get a parameter value by key.

Delete a parameter by key.

Computed parameter keys.

Computed parameter values.

Predicate to determine if parameter key is present in parameters.

Converts a Message instance into a plain JSON object.

A result type used internally for handling IPC result values from the native layer that are in the form of { err?, data? }. The data and err properties on this type of object are in tuple form and be accessed at [data?,err?]

Creates a Result instance from input that may be an object like { err?, data? }, an Error instance, or just data.

Result class constructor.

Computed result length.

Generator for an Iterable interface over this instance.

Waits for the native IPC layer to be ready and exposed on the global window object.

Sends a synchronous IPC command over XHR returning a Result upon success or error.

Emit event to be dispatched on window object.

Resolves a request by seq with possible value.

Sends an async IPC command request with parameters.

Sends an async IPC command request with parameters and buffered bytes.

Sends an async IPC command request with parameters requesting a response with buffered bytes.

Factory for creating a proxy based IPC API.

This module provides normalized system information from all the major operating systems.

This is a FunctionDeclaration named arch in os.js, it's exported but undocumented.

This is a FunctionDeclaration named networkInterfaces in os.js, it's exported but undocumented.

This is a FunctionDeclaration named platform in os.js, it's exported but undocumented.

This is a FunctionDeclaration named type in os.js, it's exported but undocumented.

This is a FunctionDeclaration named isWindows in os.js, it's exported but undocumented.

This is a FunctionDeclaration named tmpdir in os.js, it's exported but undocumented.

This is a VariableDeclaration named EOL in os.js, it's exported but undocumented.

This is a ClassDeclaration named Path in path/path.js, it's exported but undocumented.

Computes current working directory for a path

Path class constructor.