space-data-module-sdk 0.6.0 → 0.7.0

package/src/generated/orbpro/query/catalog-query-result.ts

@@ -0,0 +1,179 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+
+import * as flatbuffers from 'flatbuffers';
+
+import { EntityMetadata } from '../../orbpro/entity/entity-metadata.js';
+import { CatalogQueryKind } from '../../orbpro/query/catalog-query-kind.js';
+
+
+export class CatalogQueryResult {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):CatalogQueryResult {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+static getRootAsCatalogQueryResult(bb:flatbuffers.ByteBuffer, obj?:CatalogQueryResult):CatalogQueryResult {
+  return (obj || new CatalogQueryResult()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static getSizePrefixedRootAsCatalogQueryResult(bb:flatbuffers.ByteBuffer, obj?:CatalogQueryResult):CatalogQueryResult {
+  bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+  return (obj || new CatalogQueryResult()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+}
+
+static bufferHasIdentifier(bb:flatbuffers.ByteBuffer):boolean {
+  return bb.__has_identifier('CQRS');
+}
+
+queryKind():CatalogQueryKind {
+  const offset = this.bb!.__offset(this.bb_pos, 4);
+  return offset ? this.bb!.readUint8(this.bb_pos + offset) : CatalogQueryKind.ROWS;
+}
+
+rows(index: number, obj?:EntityMetadata):EntityMetadata|null {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? (obj || new EntityMetadata()).__init(this.bb!.__indirect(this.bb!.__vector(this.bb_pos + offset) + index * 4), this.bb!) : null;
+}
+
+rowsLength():number {
+  const offset = this.bb!.__offset(this.bb_pos, 6);
+  return offset ? this.bb!.__vector_len(this.bb_pos + offset) : 0;
+}
+
+entityIndices(index: number):number|null {
+  const offset = this.bb!.__offset(this.bb_pos, 8);
+  return offset ? this.bb!.readUint32(this.bb!.__vector(this.bb_pos + offset) + index * 4) : 0;
+}
+
+entityIndicesLength():number {
+  const offset = this.bb!.__offset(this.bb_pos, 8);
+  return offset ? this.bb!.__vector_len(this.bb_pos + offset) : 0;
+}
+
+entityIndicesArray():Uint32Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 8);
+  return offset ? new Uint32Array(this.bb!.bytes().buffer, this.bb!.bytes().byteOffset + this.bb!.__vector(this.bb_pos + offset), this.bb!.__vector_len(this.bb_pos + offset)) : null;
+}
+
+mask(index: number):number|null {
+  const offset = this.bb!.__offset(this.bb_pos, 10);
+  return offset ? this.bb!.readUint8(this.bb!.__vector(this.bb_pos + offset) + index) : 0;
+}
+
+maskLength():number {
+  const offset = this.bb!.__offset(this.bb_pos, 10);
+  return offset ? this.bb!.__vector_len(this.bb_pos + offset) : 0;
+}
+
+maskArray():Uint8Array|null {
+  const offset = this.bb!.__offset(this.bb_pos, 10);
+  return offset ? new Uint8Array(this.bb!.bytes().buffer, this.bb!.bytes().byteOffset + this.bb!.__vector(this.bb_pos + offset), this.bb!.__vector_len(this.bb_pos + offset)) : null;
+}
+
+visibleCount():number {
+  const offset = this.bb!.__offset(this.bb_pos, 12);
+  return offset ? this.bb!.readUint32(this.bb_pos + offset) : 0;
+}
+
+entityIndex():number {
+  const offset = this.bb!.__offset(this.bb_pos, 14);
+  return offset ? this.bb!.readUint32(this.bb_pos + offset) : 0;
+}
+
+row(obj?:EntityMetadata):EntityMetadata|null {
+  const offset = this.bb!.__offset(this.bb_pos, 16);
+  return offset ? (obj || new EntityMetadata()).__init(this.bb!.__indirect(this.bb_pos + offset), this.bb!) : null;
+}
+
+static startCatalogQueryResult(builder:flatbuffers.Builder) {
+  builder.startObject(7);
+}
+
+static addQueryKind(builder:flatbuffers.Builder, queryKind:CatalogQueryKind) {
+  builder.addFieldInt8(0, queryKind, CatalogQueryKind.ROWS);
+}
+
+static addRows(builder:flatbuffers.Builder, rowsOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(1, rowsOffset, 0);
+}
+
+static createRowsVector(builder:flatbuffers.Builder, data:flatbuffers.Offset[]):flatbuffers.Offset {
+  builder.startVector(4, data.length, 4);
+  for (let i = data.length - 1; i >= 0; i--) {
+    builder.addOffset(data[i]!);
+  }
+  return builder.endVector();
+}
+
+static startRowsVector(builder:flatbuffers.Builder, numElems:number) {
+  builder.startVector(4, numElems, 4);
+}
+
+static addEntityIndices(builder:flatbuffers.Builder, entityIndicesOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(2, entityIndicesOffset, 0);
+}
+
+static createEntityIndicesVector(builder:flatbuffers.Builder, data:number[]|Uint32Array):flatbuffers.Offset;
+/**
+ * @deprecated This Uint8Array overload will be removed in the future.
+ */
+static createEntityIndicesVector(builder:flatbuffers.Builder, data:number[]|Uint8Array):flatbuffers.Offset;
+static createEntityIndicesVector(builder:flatbuffers.Builder, data:number[]|Uint32Array|Uint8Array):flatbuffers.Offset {
+  builder.startVector(4, data.length, 4);
+  for (let i = data.length - 1; i >= 0; i--) {
+    builder.addInt32(data[i]!);
+  }
+  return builder.endVector();
+}
+
+static startEntityIndicesVector(builder:flatbuffers.Builder, numElems:number) {
+  builder.startVector(4, numElems, 4);
+}
+
+static addMask(builder:flatbuffers.Builder, maskOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(3, maskOffset, 0);
+}
+
+static createMaskVector(builder:flatbuffers.Builder, data:number[]|Uint8Array):flatbuffers.Offset {
+  builder.startVector(1, data.length, 1);
+  for (let i = data.length - 1; i >= 0; i--) {
+    builder.addInt8(data[i]!);
+  }
+  return builder.endVector();
+}
+
+static startMaskVector(builder:flatbuffers.Builder, numElems:number) {
+  builder.startVector(1, numElems, 1);
+}
+
+static addVisibleCount(builder:flatbuffers.Builder, visibleCount:number) {
+  builder.addFieldInt32(4, visibleCount, 0);
+}
+
+static addEntityIndex(builder:flatbuffers.Builder, entityIndex:number) {
+  builder.addFieldInt32(5, entityIndex, 0);
+}
+
+static addRow(builder:flatbuffers.Builder, rowOffset:flatbuffers.Offset) {
+  builder.addFieldOffset(6, rowOffset, 0);
+}
+
+static endCatalogQueryResult(builder:flatbuffers.Builder):flatbuffers.Offset {
+  const offset = builder.endObject();
+  return offset;
+}
+
+static finishCatalogQueryResultBuffer(builder:flatbuffers.Builder, offset:flatbuffers.Offset) {
+  builder.finish(offset, 'CQRS');
+}
+
+static finishSizePrefixedCatalogQueryResultBuffer(builder:flatbuffers.Builder, offset:flatbuffers.Offset) {
+  builder.finish(offset, 'CQRS', true);
+}
+
+}

package/src/generated/orbpro/query.js

@@ -0,0 +1,8 @@
+import { CatalogQueryKind } from "./query/catalog-query-kind.js";
+import { CatalogQueryRequest } from "./query/catalog-query-request.js";
+import { CatalogQueryResult } from "./query/catalog-query-result.js";
+export {
+  CatalogQueryKind,
+  CatalogQueryRequest,
+  CatalogQueryResult
+};

package/src/generated/orbpro/query.ts

@@ -0,0 +1,4 @@
+// generated by scripts/generate-orbpro-bindings.mjs
+export { CatalogQueryKind } from "./query/catalog-query-kind.js";
+export { CatalogQueryRequest } from "./query/catalog-query-request.js";
+export { CatalogQueryResult } from "./query/catalog-query-result.js";

package/src/generated/orbpro/vec3.js

@@ -0,0 +1,39 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class Vec3 {
+  constructor() {
+    __publicField(this, "bb", null);
+    __publicField(this, "bb_pos", 0);
+  }
+  __init(i, bb) {
+    this.bb_pos = i;
+    this.bb = bb;
+    return this;
+  }
+  x() {
+    return this.bb.readFloat64(this.bb_pos);
+  }
+  y() {
+    return this.bb.readFloat64(this.bb_pos + 8);
+  }
+  z() {
+    return this.bb.readFloat64(this.bb_pos + 16);
+  }
+  static sizeOf() {
+    return 24;
+  }
+  static createVec3(builder, x, y, z) {
+    builder.prep(8, 24);
+    builder.writeFloat64(z);
+    builder.writeFloat64(y);
+    builder.writeFloat64(x);
+    return builder.offset();
+  }
+}
+export {
+  Vec3
+};

package/src/generated/orbpro/vec3.ts

@@ -0,0 +1,40 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+
+import * as flatbuffers from 'flatbuffers';
+
+export class Vec3 {
+  bb: flatbuffers.ByteBuffer|null = null;
+  bb_pos = 0;
+  __init(i:number, bb:flatbuffers.ByteBuffer):Vec3 {
+  this.bb_pos = i;
+  this.bb = bb;
+  return this;
+}
+
+x():number {
+  return this.bb!.readFloat64(this.bb_pos);
+}
+
+y():number {
+  return this.bb!.readFloat64(this.bb_pos + 8);
+}
+
+z():number {
+  return this.bb!.readFloat64(this.bb_pos + 16);
+}
+
+static sizeOf():number {
+  return 24;
+}
+
+static createVec3(builder:flatbuffers.Builder, x: number, y: number, z: number):flatbuffers.Offset {
+  builder.prep(8, 24);
+  builder.writeFloat64(z);
+  builder.writeFloat64(y);
+  builder.writeFloat64(x);
+  return builder.offset();
+}
+
+}

package/src/host/abi.js

@@ -24,6 +24,78 @@ export const SyncHostcallOperations = Object.freeze([
 ]);
 export const NodeHostSyncHostcallOperations = SyncHostcallOperations;
 
+function normalizeCapabilityOperation(operation) {
+  const normalized = assertNonEmptyString(operation, "Host operation");
+  const separator = normalized.indexOf(".");
+  if (separator <= 0 || separator === normalized.length - 1) {
+    return null;
+  }
+  return {
+    capabilityId: normalized.slice(0, separator),
+    methodId: normalized.slice(separator + 1),
+  };
+}
+
+function getHostCapabilityAdapter(host, capabilityId) {
+  if (!host || typeof host !== "object") {
+    return null;
+  }
+  if (typeof host.getCapability === "function") {
+    const adapter = host.getCapability(capabilityId);
+    if (adapter) {
+      return adapter;
+    }
+  }
+  const capabilityRegistry = host.capabilities;
+  if (capabilityRegistry instanceof Map) {
+    const adapter = capabilityRegistry.get(capabilityId);
+    if (adapter) {
+      return adapter;
+    }
+  } else if (capabilityRegistry && typeof capabilityRegistry === "object") {
+    const adapter = capabilityRegistry[capabilityId];
+    if (adapter) {
+      return adapter;
+    }
+  }
+
+  const directAdapter = host[capabilityId];
+  if (directAdapter && typeof directAdapter === "object") {
+    return directAdapter;
+  }
+
+  const camelCapabilityId = capabilityId.replace(/_([a-z])/g, (_, letter) =>
+    letter.toUpperCase(),
+  );
+  const camelAdapter = host[camelCapabilityId];
+  if (camelAdapter && typeof camelAdapter === "object") {
+    return camelAdapter;
+  }
+
+  return null;
+}
+
+async function dispatchHostCapabilityOperation(host, operation, params = null) {
+  const normalized = normalizeCapabilityOperation(operation);
+  if (!normalized) {
+    return undefined;
+  }
+
+  const adapter = getHostCapabilityAdapter(host, normalized.capabilityId);
+  if (!adapter || typeof adapter !== "object") {
+    return undefined;
+  }
+  if (typeof adapter[normalized.methodId] === "function") {
+    return adapter[normalized.methodId](params);
+  }
+  if (typeof adapter.invoke === "function") {
+    return adapter.invoke(normalized.methodId, params);
+  }
+  throw new Error(
+    `Host capability "${normalized.capabilityId}" does not implement "${normalized.methodId}" or invoke().`,
+  );
+}
+
 function assertNonEmptyString(value, label) {
   const normalized = String(value ?? "").trim();
   if (!normalized) {
@@ -109,6 +181,15 @@ function isPromiseLike(value) {
   );
 }
 
+function assertSyncHostcallResult(value, operation) {
+  if (isPromiseLike(value)) {
+    throw new Error(
+      `Operation "${operation}" is not available in the synchronous hostcall ABI.`,
+    );
+  }
+  return value;
+}
+
 function encodeHostcallValue(value) {
   if (value === undefined) {
     return undefined;
@@ -179,6 +260,65 @@ export function dispatchHostSyncOperation(host, operation, params = null) {
       return host.schedule.next(params?.expression, params?.from);
     case "filesystem.resolvePath":
       return host.filesystem.resolvePath(params?.path);
+    case "crypto.sha256":
+      return assertSyncHostcallResult(
+        host.crypto.sha256(params?.value ?? params?.bytes),
+        normalized,
+      );
+    case "crypto.sha512":
+      return assertSyncHostcallResult(
+        host.crypto.sha512(params?.value ?? params?.bytes),
+        normalized,
+      );
+    case "crypto.hkdf":
+      return assertSyncHostcallResult(host.crypto.hkdf(params), normalized);
+    case "crypto.aesGcmEncrypt":
+      return assertSyncHostcallResult(
+        host.crypto.aesGcmEncrypt(params),
+        normalized,
+      );
+    case "crypto.aesGcmDecrypt":
+      return assertSyncHostcallResult(
+        host.crypto.aesGcmDecrypt(params),
+        normalized,
+      );
+    case "crypto.x25519.generateKeypair":
+      return assertSyncHostcallResult(
+        host.crypto.generateX25519Keypair(),
+        normalized,
+      );
+    case "crypto.x25519.publicKey":
+      return assertSyncHostcallResult(
+        host.crypto.x25519PublicKey(params?.privateKey),
+        normalized,
+      );
+    case "crypto.x25519.sharedSecret":
+      return assertSyncHostcallResult(
+        host.crypto.x25519SharedSecret(
+          params?.privateKey,
+          params?.publicKey,
+        ),
+        normalized,
+      );
+    case "crypto.ed25519.publicKeyFromSeed":
+      return assertSyncHostcallResult(
+        host.crypto.ed25519.publicKeyFromSeed(params?.seed),
+        normalized,
+      );
+    case "crypto.ed25519.sign":
+      return assertSyncHostcallResult(
+        host.crypto.ed25519.sign(params?.message, params?.seed),
+        normalized,
+      );
+    case "crypto.ed25519.verify":
+      return assertSyncHostcallResult(
+        host.crypto.ed25519.verify(
+          params?.message,
+          params?.signature,
+          params?.publicKey,
+        ),
+        normalized,
+      );
     default:
       throw new Error(
         `Operation "${normalized}" is not available in the synchronous hostcall ABI.`,
@@ -210,6 +350,24 @@ export async function dispatchHostOperation(host, operation, params = null) {
   if (typeof host.invoke === "function") {
     return host.invoke(normalized, params);
   }
+  if (typeof host.invokeCapability === "function") {
+    try {
+      return host.invokeCapability(normalized, params);
+    } catch (error) {
+      if (SyncHostcallOperations.includes(normalized)) {
+        return dispatchHostSyncOperation(host, normalized, params);
+      }
+      throw error;
+    }
+  }
+  const genericResult = await dispatchHostCapabilityOperation(
+    host,
+    normalized,
+    params,
+  );
+  if (genericResult !== undefined) {
+    return genericResult;
+  }
   return dispatchHostSyncOperation(host, normalized, params);
 }
 

package/src/host/browserEdgeShims.js

@@ -341,17 +341,30 @@ export function createMemoryFilesystemEdgeShim(options = {}) {
 }
 
 export function createBrowserEdgeShims(options = {}) {
+  const capabilityAdapters =
+    options.capabilityAdapters && typeof options.capabilityAdapters === "object"
+      ? options.capabilityAdapters
+      : {};
   return Object.freeze({
     fetch: options.fetch ?? globalThis.fetch?.bind(globalThis),
     WebSocket: options.WebSocket ?? globalThis.WebSocket,
     crypto: options.crypto ?? globalThis.crypto,
     performance: options.performance ?? globalThis.performance,
-    network: options.network ?? null,
-    ipfs: options.ipfs ?? null,
-    protocolHandle: options.protocolHandle ?? null,
-    protocolDial: options.protocolDial ?? null,
+    network: options.network ?? capabilityAdapters.network ?? null,
+    ipfs: options.ipfs ?? capabilityAdapters.ipfs ?? null,
+    protocolHandle:
+      options.protocolHandle ??
+      capabilityAdapters.protocolHandle ??
+      capabilityAdapters.protocol_handle ??
+      null,
+    protocolDial:
+      options.protocolDial ??
+      capabilityAdapters.protocolDial ??
+      capabilityAdapters.protocol_dial ??
+      null,
     filesystem:
       options.filesystem ??
+      capabilityAdapters.filesystem ??
       createMemoryFilesystemEdgeShim({
         filesystemRoot: options.filesystemRoot ?? "/",
       }),