@scriptc/compiler 0.3.4 → 0.3.5

package/dist/ir/builtin-signatures.js

@@ -1,5 +1,5 @@
 import { BIGINT_T } from "./ir.js";
-import { arrayOf, BOOL, BYTES_U8, bytesOf, CHILD_T, CHILDSTREAM_T, CHILDWRITER_T, CRYPTOHASH_T, CRYPTOHMAC_T, DATE_T, DIR_T, DGRAMSOCK_T, DYN, F64, FILEHANDLE_T, FSWATCHER_T, HTTP2SESSION_T, HTTP2STREAM_T, HTTPCLIENTREQ_T, HTTPREQ_T, HTTPRES_T, NETSERVER_T, NETSOCKET_T, PROCSTREAM_T, REGEX, SEARCH_PARAMS_T, SECURECTX_T, SPAWNRES_T, STATS_T, STRING, SYMBOL_T, TESTCTX_T, URL_T, VOID, } from "./ir.js";
+import { arrayOf, BOOL, BYTES_U8, bytesOf, CHILD_T, CHILDSTREAM_T, CHILDWRITER_T, CRYPTOHASH_T, CRYPTOHMAC_T, DATE_T, DIR_T, DGRAMSOCK_T, DYN, F64, FILEHANDLE_T, FSWATCHER_T, HTTP2SESSION_T, HTTP2STREAM_T, HTTPCLIENTREQ_T, HTTPREQ_T, HTTPRES_T, NETSERVER_T, NETSOCKET_T, PROCSTREAM_T, REGEX, SEARCH_PARAMS_T, SECURECTX_T, SPAWNRES_T, STATS_T, STRING, SYMBOL_T, TESTCTX_T, URL_T, VOID, funcOf, } from "./ir.js";
 /** Preserve the closed names while giving every entry the same slot type. */
 function defineLibFnSignatures(signatures) {
     return signatures;
@@ -1277,6 +1277,22 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
     },
     "dgram.unref": { argTypes: [DGRAMSOCK_T], result: VOID },
     "dgram.ref": { argTypes: [DGRAMSOCK_T], result: VOID },
+    /** The socket options (scr_dgram.c): the membership calls take the
+     * interface and whether it was given. May-throw. */
+    "dgram.setBroadcast": { argTypes: [DGRAMSOCK_T, BOOL], result: VOID },
+    "dgram.setTTL": { argTypes: [DGRAMSOCK_T, F64], result: F64 },
+    "dgram.setMulticastTTL": { argTypes: [DGRAMSOCK_T, F64], result: F64 },
+    "dgram.setMulticastLoopback": { argTypes: [DGRAMSOCK_T, BOOL], result: BOOL },
+    "dgram.setMulticastInterface": { argTypes: [DGRAMSOCK_T, STRING], result: VOID },
+    "dgram.addMembership": { argTypes: [DGRAMSOCK_T, STRING, STRING, BOOL], result: VOID },
+    "dgram.dropMembership": { argTypes: [DGRAMSOCK_T, STRING, STRING, BOOL], result: VOID },
+    "dgram.getRecvBufferSize": { argTypes: [DGRAMSOCK_T], result: F64 },
+    "dgram.getSendBufferSize": { argTypes: [DGRAMSOCK_T], result: F64 },
+    "dgram.setRecvBufferSize": { argTypes: [DGRAMSOCK_T, F64], result: VOID },
+    "dgram.setSendBufferSize": { argTypes: [DGRAMSOCK_T, F64], result: VOID },
+    "dgram.getSendQueueSize": { argTypes: [DGRAMSOCK_T], result: F64 },
+    "dgram.getSendQueueCount": { argTypes: [DGRAMSOCK_T], result: F64 },
+    "dgram.disconnect": { argTypes: [DGRAMSOCK_T], result: VOID },
     "dgram.onMessage": { argTypes: [DGRAMSOCK_T, null, BOOL], result: VOID },
     "dgram.onError": { argTypes: [DGRAMSOCK_T, null, BOOL], result: VOID },
     "dgram.onListening": {
@@ -1660,6 +1676,10 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
     "net.sockResume": { argTypes: [NETSOCKET_T], result: NETSOCKET_T },
     "net.sockSetNoDelay": { argTypes: [NETSOCKET_T, BOOL], result: NETSOCKET_T },
     "net.sockDestroySoon": { argTypes: [NETSOCKET_T], result: VOID },
+    /** RST close, answers the socket; throws ERR_INVALID_HANDLE_TYPE on TLS. */
+    "net.sockResetAndDestroy": { argTypes: [NETSOCKET_T], result: NETSOCKET_T },
+    /** socket.address(): { address, family, port } or {} as a dyn. */
+    "net.sockAddress": { argTypes: [NETSOCKET_T], result: DYN },
     "net.sockBytesWritten": { argTypes: [NETSOCKET_T], result: F64 },
     /** remotePort (0), remoteFamily (1), localAddress (2), localPort (3),
      * localFamily (4): dyn values, undefined when unknown. */
@@ -1691,6 +1711,8 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
     "net.isIPv6": { argTypes: [DYN], result: BOOL },
     "net.serverMaxConnectionsGet": { argTypes: [NETSERVER_T], result: DYN },
     "net.serverMaxConnectionsSet": { argTypes: [NETSERVER_T, DYN], result: VOID },
+    "net.serverDropMaxConnectionGet": { argTypes: [NETSERVER_T], result: DYN },
+    "net.serverDropMaxConnectionSet": { argTypes: [NETSERVER_T, DYN], result: VOID },
     "net.serverOnDrop": { argTypes: [NETSERVER_T, DYN, BOOL], result: VOID },
     "net.serverGetConnections": { argTypes: [NETSERVER_T, DYN], result: VOID },
     "net.sockReadable": { argTypes: [NETSOCKET_T], result: BOOL },
@@ -1768,6 +1790,12 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
      * the 'session' registration (fires once with the serialized session —
      * a Buffer; the received-ticket event). */
     "tls.sockAuthorized": { argTypes: [NETSOCKET_T], result: BOOL },
+    /** getProtocol() (string | null), getCipher() (CipherNameAndProtocol,
+     * undefined before the handshake, null after close) and alpnProtocol
+     * (string | false | null), as dyn values. */
+    "tls.sockGetProtocol": { argTypes: [NETSOCKET_T], result: DYN },
+    "tls.sockGetCipher": { argTypes: [NETSOCKET_T], result: DYN },
+    "tls.sockAlpnProtocol": { argTypes: [NETSOCKET_T], result: DYN },
     "tls.sockAuthError": { argTypes: [NETSOCKET_T], result: VOID },
     "tls.sockOnSecureConnect": {
         argTypes: [NETSOCKET_T, { kind: "func", params: [], ret: VOID }, BOOL],
@@ -2073,17 +2101,19 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
         ],
         result: STRING,
     },
-    /** The promisified-execFile capture (args: cmd, argv, cwd, hasEnv,
-     * envPairs, timeoutMs): the same exec core in the async shape — both
-     * streams captured, no echo, Node's ASYNC messages on the throw paths
+    /** The promisified-execFile/exec capture (args: cmd, argv, shell, cwd,
+     * hasEnv, envPairs, timeoutMs; shell marks exec's /bin/sh -c argv, as
+     * for execSync, so failures display the command string): the same exec
+     * core in the async shape — both streams captured, no echo, Node's ASYNC messages on the throw paths
      * ("Command failed: <cmd>\n<stderr>" with the unconditional newline,
      * "spawn <file> ENOENT" with .code, timeouts reporting as ordinary
      * SIGTERM command failures — never ETIMEDOUT). Result reuses the
      * ScrSpawnRes container (+1; stdout/stderr strings, status unused).
-     * Called only from the frontend's interned %execFileAsync ASYNC helper,
-     * whose fiber turns the throw into the rejection. */
+     * Called only from the frontend's interned %execFileAsync and
+     * %execAsync ASYNC helpers, whose fiber turns the throw into the
+     * rejection. */
     "cp.execCapture": {
-        argTypes: [STRING, arrayOf(STRING), STRING, BOOL, arrayOf(STRING), F64],
+        argTypes: [STRING, arrayOf(STRING), BOOL, STRING, BOOL, arrayOf(STRING), F64],
         result: SPAWNRES_T,
     },
     /** child_process.spawn (scr_child.c + the scr_async.c loop): posix_spawnp
@@ -2386,6 +2416,22 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
      * opaque reference inputs retain explicit runtime refusals. */
     "buffer.fromDyn": { argTypes: [DYN, STRING], result: BYTES_U8 },
     "buffer.concat": { argTypes: [arrayOf(BYTES_U8)], result: BYTES_U8 },
+    /** The pooled Buffer factories (Node's allocate/fromStringFast/
+     * fromArrayLike): allocUnsafe, Buffer.from of strings, Uint8Arrays,
+     * number[] and checked values, and concat return views into the
+     * per-thread pool slab below Buffer.poolSize >>> 1 bytes. alloc and
+     * allocUnsafeSlow never pool. The size forms validate like Node
+     * (ERR_OUT_OF_RANGE). poolSize reads and writes Buffer.poolSize. */
+    "buffer.alloc": { argTypes: [F64], result: BYTES_U8 },
+    "buffer.allocUnsafe": { argTypes: [F64], result: BYTES_U8 },
+    "buffer.allocUnsafeSlow": { argTypes: [F64], result: BYTES_U8 },
+    "buffer.poolFromStr": { argTypes: [STRING, STRING], result: BYTES_U8 },
+    "buffer.poolFromStrChecked": { argTypes: [STRING, STRING], result: BYTES_U8 },
+    "buffer.poolFromBytes": { argTypes: [BYTES_U8], result: BYTES_U8 },
+    "buffer.poolFromArray": { argTypes: [arrayOf(F64)], result: BYTES_U8 },
+    "buffer.poolFromDyn": { argTypes: [DYN, STRING], result: BYTES_U8 },
+    "buffer.poolSize": { argTypes: [], result: F64 },
+    "buffer.setPoolSize": { argTypes: [F64], result: VOID },
     /** Buffer.byteLength(string, enc) — enc a NORMALIZED literal like
      * fromStr's — and Buffer.isEncoding(name) over a runtime string
      * (case-insensitive against Node's alias set). Pure; never throw. */
@@ -2439,6 +2485,32 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
     "fsp.lchmodChk": { argTypes: [DYN, DYN], result: { kind: "promise", inner: VOID } },
     "fs.readChk": { argTypes: [DYN, DYN, DYN, DYN, DYN, STRING], result: VOID },
     "fs.streamOptsChk": { argTypes: [DYN, DYN, STRING], result: VOID },
+    /** fs.ReadStream / fs.WriteStream (scr_fs_stream.c): the constructors
+     * take the path and options as dyn values and throw Node's option
+     * errors; the members read bytesRead/bytesWritten, pending and the path
+     * value, and close() / close(cb) (a `() => void` callback). */
+    "fs.createReadStream": {
+        argTypes: [DYN, DYN],
+        result: { kind: "object", className: "%Readable" },
+    },
+    "fs.createWriteStream": {
+        argTypes: [DYN, DYN],
+        result: { kind: "object", className: "%Writable" },
+    },
+    "fs.fsStreamBytes": { argTypes: [null], result: F64 },
+    "fs.fsStreamPending": { argTypes: [null], result: BOOL },
+    "fs.fsStreamPath": { argTypes: [null], result: DYN },
+    "fs.fsStreamPropDyn": { argTypes: [null, STRING], result: DYN },
+    "fileHandle.createReadStream": {
+        argTypes: [FILEHANDLE_T, DYN],
+        result: { kind: "object", className: "%Readable" },
+    },
+    "fileHandle.createWriteStream": {
+        argTypes: [FILEHANDLE_T, DYN],
+        result: { kind: "object", className: "%Writable" },
+    },
+    "fs.fsStreamClose": { argTypes: [null], result: VOID },
+    "fs.fsStreamCloseCb": { argTypes: [null, funcOf([], VOID)], result: VOID },
     /** The compiler-resolved ERR_INVALID_ARG_TYPE throw with a RUNTIME-
      * rendered Received tail: args [argname, "of type ..." clause, the
      * offending dyn value]. ALWAYS THROWS; polymorphic result (the
@@ -3032,6 +3104,9 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
      * lowered directly (the list's values need no dyn representation to
      * fail). */
     "dyn.cloneTransferFail": { argTypes: [], result: DYN },
+    /** The same refusal given the transfer list's first member, an
+     * ArrayBuffer: a Buffer pool slab gets Node's untransferable message. */
+    "dyn.cloneTransferFailWith": { argTypes: [DYN], result: DYN },
     /** `new RegExp(pattern, flags?)` (scr_regex.c): a heap regex over the
      * same libregexp engine the literals use. The pattern compiles EAGERLY
      * so an invalid pattern (or an unknown flag letter) throws Node's
@@ -3518,6 +3593,11 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
     "insp.seenPush": { argTypes: [null], result: VOID },
     "insp.refWrap": { argTypes: [null, STRING], result: STRING },
     "insp.circular": { argTypes: [F64], result: STRING },
+    /* Whether a closed declared-field record kept the undeclared properties
+     * of its checked source (scr_record_source_note): reflective surfaces
+     * (inspect, Object.keys/values/entries) then answer through its live
+     * checked view. The receiver is any such record type. Never throws. */
+    "record.sourceHas": { argTypes: [null], result: BOOL },
     "insp.key": { argTypes: [STRING], result: STRING },
     "insp.moreItems": { argTypes: [F64], result: STRING },
     "insp.end": { argTypes: [STRING, STRING, STRING, F64, BOOL, BOOL], result: STRING },
@@ -3588,6 +3668,10 @@ export const LIB_FN_SIGS = defineLibFnSignatures({
      * turns, Node's check phase). Neither throws. */
     "tp.setTimeout": { argTypes: [F64], result: { kind: "promise", inner: VOID } },
     "tp.setImmediate": { argTypes: [], result: { kind: "promise", inner: VOID } },
+    /** events.once (scr_events_emitter.c): [emitter, name, boxer,
+     * errorBoxer, listenForError] → a pending promise of any[]; the boxers
+     * turn the event's and the 'error' tuple into that array. */
+    "events.once": { argTypes: [null, STRING, null, null, BOOL], result: VOID },
     /** The resolve-value forms: [ms?, value, ref] → a pending promise of the
      * value's type that copies the borrowed already-resolved `value` promise
      * when the timer (or immediate) fires; ref false unrefs it. The result