@ignex/nova 0.1.1

package/src/generated/ts-ser.ts

@@ -0,0 +1,465 @@
+// @generated by scripts/ts-ser-gen.ts — DO NOT EDIT
+import * as flatbuffers from "flatbuffers";
+import {
+  QuoteT,
+  TradeT,
+  PortfolioSnapshotT,
+  PortfolioPositionT,
+  ComplexT,
+  OrderT,
+  CustomerT,
+  OrderLineT,
+  OrderBillingT,
+  BigValT,
+  HelloT,
+  WelcomeT,
+  SubscribeT,
+  UnsubscribeT,
+  JoinGroupT,
+  LeaveGroupT,
+  SnapshotRequestT,
+  PingT,
+  PongT,
+} from "./ts/backend";
+import { anyEventNameToId, WIRE_HEADER_LEN, WIRE_VERSION } from "./registry";
+import type { AnyEventName, ControlEvents, Events } from "../schema";
+
+/** string → flatc numeric enum value lookups */
+const SIDE = { buy: 0, sell: 1 } as const;
+const TAGS = { hot: 0, new: 1, sale: 2 } as const;
+
+/** pooled builder — each encode clears it (safe because encodeEventFrame copies). */
+let shared: flatbuffers.Builder | null = null;
+function getBuilder(): flatbuffers.Builder {
+  if (!shared) shared = new flatbuffers.Builder(1024);
+  return shared;
+}
+
+type QuotePlain = {
+  symbol: string;
+  bid: number;
+  ask: number;
+  bidSize: number;
+  askSize: number;
+  ts: number;
+};
+
+type TradePlain = {
+  symbol: string;
+  price: number;
+  volume: number;
+  side: "buy" | "sell";
+  ts: number;
+};
+
+type PortfolioSnapshotPlain = {
+  accountId: string;
+  positions: PortfolioPositionPlain[];
+  totalValue: number;
+  cash: number;
+  ts: number;
+  updatedBy?: string | undefined;
+};
+
+type PortfolioPositionPlain = {
+  symbol: string;
+  quantity: number;
+  avgPrice: number;
+  pnl: number;
+};
+
+type ComplexPlain = {
+  id: string;
+  names: string[];
+  prices: number[];
+  counts: number[];
+  flags: boolean[];
+  tags: ("hot" | "new" | "sale")[];
+  active: boolean;
+  total: number;
+  ts: number;
+};
+
+type OrderPlain = {
+  orderId: string;
+  customer: CustomerPlain;
+  lines: OrderLinePlain[];
+  notes: string[];
+  discounts: number[];
+  active: boolean;
+  createdAt: number;
+  billing?: OrderBillingPlain | undefined;
+};
+
+type CustomerPlain = {
+  id: string;
+  name: string;
+  vip: boolean;
+  loyaltyPoints: number;
+  rating: number;
+};
+
+type OrderLinePlain = {
+  sku: string;
+  qty: number;
+  unitPrice: number;
+  tags: ("hot" | "new" | "sale")[];
+};
+
+type OrderBillingPlain = {
+  id: string;
+  name: string;
+  vip: boolean;
+  loyaltyPoints: number;
+  rating: number;
+};
+
+type BigValPlain = {
+  id: string;
+  seq: bigint;
+  when: number;
+};
+
+type HelloPlain = {
+  version: number;
+  caps: string[];
+  lastSeq: number;
+};
+
+type WelcomePlain = {
+  clientId: string;
+  groups: string[];
+};
+
+type SubscribePlain = {
+  topic: string;
+};
+
+type UnsubscribePlain = {
+  topic: string;
+};
+
+type JoinGroupPlain = {
+  group: string;
+};
+
+type LeaveGroupPlain = {
+  group: string;
+};
+
+type SnapshotRequestPlain = {
+  topic: string;
+};
+
+type PingPlain = {
+  ts: number;
+};
+
+type PongPlain = {
+  ts: number;
+};
+
+function buildQuoteT(o: QuotePlain): QuoteT {
+  return new QuoteT(
+    o.symbol,
+    o.bid,
+    o.ask,
+    o.bidSize === undefined ? 0n : BigInt(o.bidSize),
+    o.askSize === undefined ? 0n : BigInt(o.askSize),
+    o.ts === undefined ? 0n : BigInt(o.ts),
+  );
+}
+
+function buildTradeT(o: TradePlain): TradeT {
+  return new TradeT(
+    o.symbol,
+    o.price,
+    o.volume === undefined ? 0n : BigInt(o.volume),
+    SIDE[o.side],
+    o.ts === undefined ? 0n : BigInt(o.ts),
+  );
+}
+
+function buildPortfolioSnapshotT(o: PortfolioSnapshotPlain): PortfolioSnapshotT {
+  return new PortfolioSnapshotT(
+    o.accountId,
+    (o.positions ?? []).map((v) => buildPortfolioPositionT(v)),
+    o.totalValue,
+    o.cash,
+    o.ts === undefined ? 0n : BigInt(o.ts),
+    o.updatedBy ?? null,
+  );
+}
+
+function buildPortfolioPositionT(o: PortfolioPositionPlain): PortfolioPositionT {
+  return new PortfolioPositionT(
+    o.symbol,
+    o.quantity === undefined ? 0n : BigInt(o.quantity),
+    o.avgPrice,
+    o.pnl,
+  );
+}
+
+function buildComplexT(o: ComplexPlain): ComplexT {
+  return new ComplexT(
+    o.id,
+    (o.names ?? []),
+    (o.prices ?? []),
+    (o.counts ?? []).map((v) => BigInt(v)),
+    (o.flags ?? []),
+    (o.tags ?? []).map((v) => TAGS[v]),
+    o.active,
+    o.total,
+    o.ts === undefined ? 0n : BigInt(o.ts),
+  );
+}
+
+function buildOrderT(o: OrderPlain): OrderT {
+  return new OrderT(
+    o.orderId,
+    buildCustomerT(o.customer),
+    (o.lines ?? []).map((v) => buildOrderLineT(v)),
+    (o.notes ?? []),
+    (o.discounts ?? []),
+    o.active,
+    o.createdAt === undefined ? 0n : BigInt(o.createdAt),
+    o.billing ? buildOrderBillingT(o.billing) : null,
+  );
+}
+
+function buildCustomerT(o: CustomerPlain): CustomerT {
+  return new CustomerT(
+    o.id,
+    o.name,
+    o.vip,
+    o.loyaltyPoints === undefined ? 0n : BigInt(o.loyaltyPoints),
+    o.rating,
+  );
+}
+
+function buildOrderLineT(o: OrderLinePlain): OrderLineT {
+  return new OrderLineT(
+    o.sku,
+    o.qty === undefined ? 0n : BigInt(o.qty),
+    o.unitPrice,
+    (o.tags ?? []).map((v) => TAGS[v]),
+  );
+}
+
+function buildOrderBillingT(o: OrderBillingPlain): OrderBillingT {
+  return new OrderBillingT(
+    o.id,
+    o.name,
+    o.vip,
+    o.loyaltyPoints === undefined ? 0n : BigInt(o.loyaltyPoints),
+    o.rating,
+  );
+}
+
+function buildBigValT(o: BigValPlain): BigValT {
+  return new BigValT(
+    o.id,
+    o.seq,
+    o.when === undefined ? 0n : BigInt(o.when),
+  );
+}
+
+function buildHelloT(o: HelloPlain): HelloT {
+  return new HelloT(
+    o.version === undefined ? 0n : BigInt(o.version),
+    (o.caps ?? []),
+    o.lastSeq === undefined ? 0n : BigInt(o.lastSeq),
+  );
+}
+
+function buildWelcomeT(o: WelcomePlain): WelcomeT {
+  return new WelcomeT(
+    o.clientId,
+    (o.groups ?? []),
+  );
+}
+
+function buildSubscribeT(o: SubscribePlain): SubscribeT {
+  return new SubscribeT(
+    o.topic,
+  );
+}
+
+function buildUnsubscribeT(o: UnsubscribePlain): UnsubscribeT {
+  return new UnsubscribeT(
+    o.topic,
+  );
+}
+
+function buildJoinGroupT(o: JoinGroupPlain): JoinGroupT {
+  return new JoinGroupT(
+    o.group,
+  );
+}
+
+function buildLeaveGroupT(o: LeaveGroupPlain): LeaveGroupT {
+  return new LeaveGroupT(
+    o.group,
+  );
+}
+
+function buildSnapshotRequestT(o: SnapshotRequestPlain): SnapshotRequestT {
+  return new SnapshotRequestT(
+    o.topic,
+  );
+}
+
+function buildPingT(o: PingPlain): PingT {
+  return new PingT(
+    o.ts === undefined ? 0n : BigInt(o.ts),
+  );
+}
+
+function buildPongT(o: PongPlain): PongT {
+  return new PongT(
+    o.ts === undefined ? 0n : BigInt(o.ts),
+  );
+}
+
+/** payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeQuotePayload(o: Events["quote"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildQuoteT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeTradePayload(o: Events["trade"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildTradeT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodePortfolioPayload(o: Events["portfolio"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildPortfolioSnapshotT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeComplexPayload(o: Events["complex"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildComplexT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeOrderPayload(o: Events["order"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildOrderT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeBigValPayload(o: Events["bigVal"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildBigValT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeHelloPayload(o: ControlEvents["hello"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildHelloT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeWelcomePayload(o: ControlEvents["welcome"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildWelcomeT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeSubscribePayload(o: ControlEvents["subscribe"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildSubscribeT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeUnsubscribePayload(o: ControlEvents["unsubscribe"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildUnsubscribeT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeJoinGroupPayload(o: ControlEvents["joinGroup"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildJoinGroupT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeLeaveGroupPayload(o: ControlEvents["leaveGroup"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildLeaveGroupT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodeSnapshotRequestPayload(o: ControlEvents["snapshotRequest"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildSnapshotRequestT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodePingPayload(o: ControlEvents["ping"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildPingT(o).pack(b));
+  return b.asUint8Array();
+}
+
+/** control payload encoder: plain object → size-prefixed FlatBuffer. */
+export function encodePongPayload(o: ControlEvents["pong"], b: flatbuffers.Builder = getBuilder()): Uint8Array {
+  b.clear();
+  b.finishSizePrefixed(buildPongT(o).pack(b));
+  return b.asUint8Array();
+}
+
+export type JsEncoder = (o: unknown, b?: flatbuffers.Builder) => Uint8Array;
+
+export const jsEncoders: Record<string, JsEncoder> = {
+  quote: encodeQuotePayload as JsEncoder,
+  trade: encodeTradePayload as JsEncoder,
+  portfolio: encodePortfolioPayload as JsEncoder,
+  complex: encodeComplexPayload as JsEncoder,
+  order: encodeOrderPayload as JsEncoder,
+  bigVal: encodeBigValPayload as JsEncoder,
+  hello: encodeHelloPayload as JsEncoder,
+  welcome: encodeWelcomePayload as JsEncoder,
+  subscribe: encodeSubscribePayload as JsEncoder,
+  unsubscribe: encodeUnsubscribePayload as JsEncoder,
+  joinGroup: encodeJoinGroupPayload as JsEncoder,
+  leaveGroup: encodeLeaveGroupPayload as JsEncoder,
+  snapshotRequest: encodeSnapshotRequestPayload as JsEncoder,
+  ping: encodePingPayload as JsEncoder,
+  pong: encodePongPayload as JsEncoder,
+};
+
+/** Encode a payload (app or control event) → size-prefixed FlatBuffer. */
+export function encodeJsPayload(name: AnyEventName, o: unknown, b?: flatbuffers.Builder): Uint8Array {
+  const enc = jsEncoders[name];
+  if (!enc) throw new Error(`ignex: no JS encoder for "${name}" — regenerate`);
+  return enc(o, b);
+}
+
+/** Encode a payload into a full wire frame `[version][event_id:u32][size-prefixed FB]`. */
+export function encodeEventFrame(name: AnyEventName, o: unknown, b?: flatbuffers.Builder): Uint8Array {
+  const payload = encodeJsPayload(name, o, b);
+  const id = anyEventNameToId[name]!;
+  const frame = new Uint8Array(WIRE_HEADER_LEN + payload.byteLength);
+  frame[0] = WIRE_VERSION;
+  new DataView(frame.buffer).setUint32(1, id, true);
+  frame.set(payload, WIRE_HEADER_LEN);
+  return frame;
+}

package/src/generated/wire-registry.json

@@ -0,0 +1,20 @@
+{
+  "version": 1,
+  "events": {
+    "quote": 2995289047,
+    "trade": 1362521689,
+    "portfolio": 464274147,
+    "complex": 2318166199,
+    "order": 1932267671,
+    "bigVal": 3211729064,
+    "hello": 1335831723,
+    "welcome": 669089267,
+    "subscribe": 2946386435,
+    "unsubscribe": 4190043798,
+    "joinGroup": 3026600144,
+    "leaveGroup": 3755061443,
+    "snapshotRequest": 1249175018,
+    "ping": 375255177,
+    "pong": 2061178551
+  }
+}

package/src/native/codec.ts

@@ -0,0 +1,35 @@
+/**
+ * Zero-allocation UTF-8 helpers (Bun, server-side). Used by the generated
+ * direct fast-path encoders to turn JS strings into pre-encoded byte buffers
+ * WITHOUT allocating: write into a reusable scratch via a cached `Buffer` view
+ * (castrum's `encodeUtf8Into` pattern).
+ */
+import { Buffer } from "node:buffer";
+
+const viewCache = new WeakMap<ArrayBuffer, Buffer>();
+
+function bufView(ab: ArrayBuffer): Buffer {
+  let b = viewCache.get(ab);
+  if (!b) {
+    b = Buffer.from(ab);
+    viewCache.set(ab, b);
+  }
+  return b;
+}
+
+/** UTF-8 byte length of `s` — no allocation. */
+export function utf8Len(s: string): number {
+  return Buffer.byteLength(s, "utf8");
+}
+
+/** Write `s` as UTF-8 into `dest` at `offset`; returns bytes written. */
+export function encodeUtf8Into(s: string, dest: Uint8Array, offset = 0): number {
+  return bufView(dest.buffer as ArrayBuffer).write(s, offset, "utf8");
+}
+
+/** Grow a scratch in place (returns a new buffer) if it can't hold `needed`. */
+export function ensureCapacity(current: Uint8Array, needed: number, minGrow = 64): Uint8Array {
+  if (current.byteLength >= needed) return current;
+  const cap = Math.max(current.byteLength * 2, needed, minGrow);
+  return new Uint8Array(cap);
+}