space-data-module-sdk 0.5.10 → 0.5.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "space-data-module-sdk",
-  "version": "0.5.10",
+  "version": "0.5.13",
   "description": "Module SDK for building, validating, signing, and deploying WebAssembly modules on the Space Data Network.",
   "type": "module",
   "types": "./src/index.d.ts",
@@ -40,6 +40,9 @@
     "schemas/",
     "src/"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "node --test",
     "test:host-surfaces": "node --test test/node-host.test.js test/host-abi.test.js",

package/src/compiler/flatcSupport.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { readFile } from "node:fs/promises";
+import { readFile, readdir, stat } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 
 import { FlatcRunner } from "flatc-wasm";
@@ -18,6 +18,48 @@ function loadFlatcRunner() {
   return flatcRunnerPromise;
 }
 
+const FLATBUFFERS_INCLUDE_ROOT_CANDIDATES = [
+  process.env.FLATBUFFERS_INCLUDE_DIR,
+  "/opt/homebrew/include",
+  "/usr/local/include",
+  "/usr/include",
+].filter(Boolean);
+
+async function findFlatbuffersIncludeRoot() {
+  for (const candidate of FLATBUFFERS_INCLUDE_ROOT_CANDIDATES) {
+    const headerPath = path.join(candidate, "flatbuffers", "flatbuffers.h");
+    try {
+      const headerStat = await stat(headerPath);
+      if (headerStat.isFile()) {
+        return candidate;
+      }
+    } catch {
+      // Try the next candidate.
+    }
+  }
+  throw new Error(
+    "Unable to locate the installed flatbuffers C++ headers. Set FLATBUFFERS_INCLUDE_DIR to the directory containing flatbuffers/flatbuffers.h.",
+  );
+}
+
+async function readDirectoryTree(rootDir, currentDir = rootDir) {
+  const entries = await readdir(currentDir, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const fullPath = path.join(currentDir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...(await readDirectoryTree(rootDir, fullPath)));
+      continue;
+    }
+    if (!entry.isFile()) {
+      continue;
+    }
+    const relativePath = path.relative(rootDir, fullPath).split(path.sep).join("/");
+    files.push([`/${relativePath}`, await readFile(fullPath, "utf8")]);
+  }
+  return files;
+}
+
 async function loadInvokeSchemaFiles() {
   const filenames = [
     "TypedArenaBuffer.fbs",
@@ -36,8 +78,10 @@ async function loadInvokeSchemaFiles() {
 export async function getFlatbuffersCppRuntimeHeaders() {
   if (!flatbuffersCppRuntimeHeadersPromise) {
     flatbuffersCppRuntimeHeadersPromise = (async () => {
-      const flatc = await loadFlatcRunner();
-      return flatc.getEmbeddedRuntime("cpp");
+      const includeRoot = await findFlatbuffersIncludeRoot();
+      return Object.fromEntries(
+        await readDirectoryTree(includeRoot, path.join(includeRoot, "flatbuffers")),
+      );
     })();
   }
   return flatbuffersCppRuntimeHeadersPromise;

package/src/compliance/pluginCompliance.js

@@ -366,7 +366,7 @@ function validateAllowedType(type, issues, location) {
       "Allowed type fixedStringLength",
       { min: 0 },
     );
-    validateIntegerField(
+    validateOptionalIntegerField(
       issues,
       type.byteLength,
       `${location}.byteLength`,

package/src/manifest/typeRefs.js

@@ -1,31 +1,62 @@
 function cloneSchemaHash(value) {
   if (value instanceof Uint8Array) {
-    return new Uint8Array(value);
+    return value.byteLength > 0 ? new Uint8Array(value) : undefined;
   }
   if (Array.isArray(value)) {
-    return [...value];
+    return value.length > 0 ? [...value] : undefined;
   }
   return value ?? undefined;
 }
 
+function normalizeNullableString(value) {
+  if (value === undefined || value === null) {
+    return null;
+  }
+  const normalized = String(value).trim();
+  return normalized.length > 0 ? normalized : null;
+}
+
+function normalizeAlignedMetadataScalar(value) {
+  if (value === undefined || value === null || value === "") {
+    return undefined;
+  }
+  const numeric = Number(value);
+  if (Number.isFinite(numeric)) {
+    return numeric === 0 ? undefined : numeric;
+  }
+  return value;
+}
+
 export function clonePayloadTypeRef(value = null) {
   if (!value || typeof value !== "object") {
-    return { acceptsAnyFlatbuffer: true };
+    return { acceptsAnyFlatbuffer: true, fileIdentifier: null };
   }
   return {
-    schemaName: value.schemaName ?? value.schema_name ?? undefined,
-    fileIdentifier: value.fileIdentifier ?? value.file_identifier ?? undefined,
+    schemaName: normalizeNullableString(
+      value.schemaName ?? value.schema_name,
+    ),
+    fileIdentifier: normalizeNullableString(
+      value.fileIdentifier ?? value.file_identifier,
+    ),
     schemaHash: cloneSchemaHash(value.schemaHash ?? value.schema_hash),
     acceptsAnyFlatbuffer: Boolean(
       value.acceptsAnyFlatbuffer ?? value.accepts_any_flatbuffer ?? false,
     ),
-    wireFormat: value.wireFormat ?? value.wire_format ?? undefined,
-    rootTypeName: value.rootTypeName ?? value.root_type_name ?? undefined,
-    fixedStringLength:
-      value.fixedStringLength ?? value.fixed_string_length ?? undefined,
-    byteLength: value.byteLength ?? value.byte_length ?? undefined,
-    requiredAlignment:
-      value.requiredAlignment ?? value.required_alignment ?? undefined,
+    wireFormat: normalizePayloadWireFormatName(
+      value.wireFormat ?? value.wire_format,
+    ),
+    rootTypeName: normalizeNullableString(
+      value.rootTypeName ?? value.root_type_name,
+    ),
+    fixedStringLength: normalizeAlignedMetadataScalar(
+      value.fixedStringLength ?? value.fixed_string_length,
+    ),
+    byteLength: normalizeAlignedMetadataScalar(
+      value.byteLength ?? value.byte_length,
+    ),
+    requiredAlignment: normalizeAlignedMetadataScalar(
+      value.requiredAlignment ?? value.required_alignment,
+    ),
   };
 }
 
@@ -33,6 +64,12 @@ export function normalizePayloadWireFormatName(value) {
   if (value === undefined || value === null || value === "") {
     return null;
   }
+  if (value === 1 || value === "1") {
+    return "aligned-binary";
+  }
+  if (value === 0 || value === "0") {
+    return "flatbuffer";
+  }
   const normalized = String(value).trim().toLowerCase().replace(/_/g, "-");
   if (normalized === "aligned-binary") {
     return "aligned-binary";

package/src/transport/records.js

@@ -609,7 +609,16 @@ export function decodePublicationRecordCollection(bytes) {
       8,
       `REC trailer record ${index} standard`,
     );
-    const recordType = recordTable.value_type();
+    const recordType =
+      typeof recordTable.valueType === "function"
+        ? recordTable.valueType()
+        : typeof recordTable.value_type === "function"
+          ? recordTable.value_type()
+          : (() => {
+              throw new TypeError(
+                "REC Record wrapper is missing both valueType() and value_type() accessors.",
+              );
+            })();
     const standard =
       normalizeStringField(recordTable.standard()) ??
       STANDARD_BY_RECORD_TYPE[recordType] ??