spacetimedb 2.4.1 → 2.6.0

package/src/server/sys.d.ts

@@ -1,125 +1,125 @@
-declare module 'spacetime:sys@2.0' {
-  export type u8 = number;
-  export type u16 = number;
-  export type u32 = number;
-  export type u64 = bigint;
-  export type u128 = bigint;
-  export type u256 = bigint;
-
-  export const moduleHooks: unique symbol;
-
-  interface ModuleDefaultExport {
-    [moduleHooks](exports: object): ModuleHooks;
-  }
-
-  export interface ModuleHooks {
-    __describe_module__(): Uint8Array;
-
-    __get_error_constructor__(code: number): new (msg: string) => Error;
-    __sender_error_class__: new (msg: string) => Error;
-
-    __call_reducer__(
-      reducerId: u32,
-      sender: u256,
-      connId: u128,
-      timestamp: bigint,
-      argsBuf: DataView
-    ): void;
-
-    __call_view__(id: u32, sender: u256, args: Uint8Array): Uint8Array | object;
-
-    __call_view_anon__(id: u32, args: Uint8Array): Uint8Array | object;
-
-    __call_procedure__(
-      id: u32,
-      sender: u256,
-      connection_id: u128,
-      timestamp: bigint,
-      args: Uint8Array
-    ): Uint8Array;
-
-    __call_http_handler__(
-      id: u32,
-      timestamp: bigint,
-      request: Uint8Array,
-      body: Uint8Array
-    ): [response: Uint8Array, body: Uint8Array];
-  }
-
-  export function register_hooks(hooks: ModuleHooks);
-
-  export function table_id_from_name(name: string): u32;
-  export function index_id_from_name(name: string): u32;
-  export function datastore_table_row_count(table_id: u32): u64;
-  export function datastore_table_scan_bsatn(table_id: u32): u32;
-  export function datastore_index_scan_range_bsatn(
-    index_id: u32,
-    buf: ArrayBuffer,
-    prefix_len: u32,
-    prefix_elems: u16,
-    rstart_len: u32,
-    rend_len: u32
-  ): u32;
-  export function row_iter_bsatn_advance(iter: u32, buffer: ArrayBuffer): u32;
-  export function row_iter_bsatn_close(iter: u32): void;
-  export function datastore_insert_bsatn(
-    table_id: u32,
-    row: ArrayBuffer,
-    row_len: u32
-  ): u32;
-  export function datastore_update_bsatn(
-    table_id: u32,
-    index_id: u32,
-    row: ArrayBuffer,
-    row_len: u32
-  ): u32;
-  export function datastore_delete_by_index_scan_range_bsatn(
-    index_id: u32,
-    buf: ArrayBuffer,
-    prefix_len: u32,
-    prefix_elems: u16,
-    rstart_len: u32,
-    rend_len: u32
-  ): u32;
-  export function datastore_delete_all_by_eq_bsatn(
-    table_id: u32,
-    relation: ArrayBuffer,
-    relation_len: u32
-  ): u32;
-  export function volatile_nonatomic_schedule_immediate(
-    reducer_name: string,
-    args: Uint8Array
-  ): void;
-  export function console_log(level: u8, message: string): void;
-  export function console_timer_start(name: string): u32;
-  export function console_timer_end(span_id: u32): void;
-  export function identity(): u256;
-  export function get_jwt_payload(connection_id: u128): Uint8Array;
-
-  export function procedure_http_request(
-    request: Uint8Array,
-    body: Uint8Array | string
-  ): [response: Uint8Array, body: Uint8Array];
-
-  export function procedure_start_mut_tx(): bigint;
-
-  export function procedure_commit_mut_tx();
-
-  export function procedure_abort_mut_tx();
-
-  export function datastore_index_scan_point_bsatn(
-    index_id: u32,
-    point: ArrayBuffer,
-    point_len: u32
-  ): u32;
-
-  export function datastore_delete_by_index_scan_point_bsatn(
-    index_id: u32,
-    point: ArrayBuffer,
-    point_len: u32
-  ): u32;
-}
-
-declare module 'spacetime:sys@2.1' {
-  export function datastore_clear(table_id: u32): u64;
-}
+declare module 'spacetime:sys@2.0' {
+  export type u8 = number;
+  export type u16 = number;
+  export type u32 = number;
+  export type u64 = bigint;
+  export type u128 = bigint;
+  export type u256 = bigint;
+
+  export const moduleHooks: unique symbol;
+
+  interface ModuleDefaultExport {
+    [moduleHooks](exports: object): ModuleHooks;
+  }
+
+  export interface ModuleHooks {
+    __describe_module__(): Uint8Array;
+
+    __get_error_constructor__(code: number): new (msg: string) => Error;
+    __sender_error_class__: new (msg: string) => Error;
+
+    __call_reducer__(
+      reducerId: u32,
+      sender: u256,
+      connId: u128,
+      timestamp: bigint,
+      argsBuf: DataView
+    ): void;
+
+    __call_view__(id: u32, sender: u256, args: Uint8Array): Uint8Array | object;
+
+    __call_view_anon__(id: u32, args: Uint8Array): Uint8Array | object;
+
+    __call_procedure__(
+      id: u32,
+      sender: u256,
+      connection_id: u128,
+      timestamp: bigint,
+      args: Uint8Array
+    ): Uint8Array;
+
+    __call_http_handler__(
+      id: u32,
+      timestamp: bigint,
+      request: Uint8Array,
+      body: Uint8Array
+    ): [response: Uint8Array, body: Uint8Array];
+  }
+
+  export function register_hooks(hooks: ModuleHooks);
+
+  export function table_id_from_name(name: string): u32;
+  export function index_id_from_name(name: string): u32;
+  export function datastore_table_row_count(table_id: u32): u64;
+  export function datastore_table_scan_bsatn(table_id: u32): u32;
+  export function datastore_index_scan_range_bsatn(
+    index_id: u32,
+    buf: ArrayBuffer,
+    prefix_len: u32,
+    prefix_elems: u16,
+    rstart_len: u32,
+    rend_len: u32
+  ): u32;
+  export function row_iter_bsatn_advance(iter: u32, buffer: ArrayBuffer): u32;
+  export function row_iter_bsatn_close(iter: u32): void;
+  export function datastore_insert_bsatn(
+    table_id: u32,
+    row: ArrayBuffer,
+    row_len: u32
+  ): u32;
+  export function datastore_update_bsatn(
+    table_id: u32,
+    index_id: u32,
+    row: ArrayBuffer,
+    row_len: u32
+  ): u32;
+  export function datastore_delete_by_index_scan_range_bsatn(
+    index_id: u32,
+    buf: ArrayBuffer,
+    prefix_len: u32,
+    prefix_elems: u16,
+    rstart_len: u32,
+    rend_len: u32
+  ): u32;
+  export function datastore_delete_all_by_eq_bsatn(
+    table_id: u32,
+    relation: ArrayBuffer,
+    relation_len: u32
+  ): u32;
+  export function volatile_nonatomic_schedule_immediate(
+    reducer_name: string,
+    args: Uint8Array
+  ): void;
+  export function console_log(level: u8, message: string): void;
+  export function console_timer_start(name: string): u32;
+  export function console_timer_end(span_id: u32): void;
+  export function identity(): u256;
+  export function get_jwt_payload(connection_id: u128): Uint8Array;
+
+  export function procedure_http_request(
+    request: Uint8Array,
+    body: Uint8Array | string
+  ): [response: Uint8Array, body: Uint8Array];
+
+  export function procedure_start_mut_tx(): bigint;
+
+  export function procedure_commit_mut_tx();
+
+  export function procedure_abort_mut_tx();
+
+  export function datastore_index_scan_point_bsatn(
+    index_id: u32,
+    point: ArrayBuffer,
+    point_len: u32
+  ): u32;
+
+  export function datastore_delete_by_index_scan_point_bsatn(
+    index_id: u32,
+    point: ArrayBuffer,
+    point_len: u32
+  ): u32;
+}
+
+declare module 'spacetime:sys@2.1' {
+  export function datastore_clear(table_id: u32): u64;
+}

package/src/server/view.test-d.ts

@@ -1,194 +1,194 @@
-import { schema } from './schema';
-import { table } from '../lib/table';
-import t from '../lib/type_builders';
-
-const person = table(
-  {
-    name: 'person',
-    indexes: [
-      {
-        accessor: 'name_id_idx',
-        name: 'name_id_idx',
-        algorithm: 'btree',
-        columns: ['name', 'id'] as const,
-      },
-    ],
-  },
-  {
-    id: t.u32().primaryKey(),
-    name: t.string(),
-  }
-);
-
-const personWithExtra = table(
-  { name: 'personWithExtra' },
-  {
-    id: t.u32(),
-    name: t.string(),
-    extraField: t.string(),
-  }
-);
-
-const personWithMissing = table(
-  { name: 'personWithMissing' },
-  {
-    id: t.u32(),
-  }
-);
-
-const personReordered = table(
-  { name: 'personReordered' },
-  {
-    name: t.string(),
-    id: t.u32(),
-  }
-);
-
-const order = table(
-  {
-    name: 'order',
-    indexes: [
-      {
-        accessor: 'id_person_id',
-        name: 'id_person_id', // We are adding this to make sure `person_id` still isn't considered indexed.
-        algorithm: 'btree',
-        columns: ['id', 'person_id'] as const,
-      },
-    ],
-  },
-  {
-    id: t.u32().primaryKey(),
-    person_name: t.string().index(),
-    person_id: t.u32(),
-  }
-);
-
-const spacetime = schema({
-  person,
-  order,
-  personWithExtra,
-  personReordered,
-  personWithMissing,
-});
-
-const arrayRetValue = t.array(person.rowType);
-const optionalPerson = t.option(person.rowType);
-const multiplePrimaryKeyRows = t.array(
-  t.row('MultiplePrimaryKeyRows', {
-    id: t.u32().primaryKey(),
-    name: t.string().primaryKey(),
-  })
-);
-
-spacetime.anonymousView({ name: 'v1', public: true }, arrayRetValue, ctx => {
-  return ctx.from.person.build();
-});
-
-// @ts-expect-error views can have at most one primaryKey column on the returned row type.
-spacetime.anonymousView(
-  { name: 'multiplePrimaryRows', public: true },
-  multiplePrimaryKeyRows,
-  () => []
-);
-
-// @ts-expect-error the same multiple-primary-key check also applies to query-builder views.
-spacetime.anonymousView(
-  { name: 'multiplePrimaryRowsQuery', public: true },
-  multiplePrimaryKeyRows,
-  ctx => {
-    return ctx.from.person;
-  }
-);
-
-spacetime.anonymousView(
-  { name: 'optionalPerson', public: true },
-  optionalPerson,
-  ctx => {
-    return ctx.db.person.iter().next().value;
-  }
-);
-
-spacetime.anonymousView(
-  { name: 'optionalPersonWrong', public: true },
-  optionalPerson,
-  // @ts-expect-error returns a value of the wrong type.
-  ctx => {
-    return ctx.db.order.iter().next().value;
-  }
-);
-
-// Extra fields are only an issue for queries.
-spacetime.anonymousView(
-  { name: 'optionalPersonWithExtra', public: true },
-  optionalPerson,
-  ctx => {
-    return ctx.db.personWithExtra.iter().next().value;
-  }
-);
-
-spacetime.anonymousView(
-  { name: 'v2', public: true },
-  arrayRetValue,
-  // @ts-expect-error returns a query of the wrong type.
-  ctx => {
-    return ctx.from.order.build();
-  }
-);
-
-// For queries, we can't return rows with extra fields.
-spacetime.anonymousView(
-  { name: 'v3', public: true },
-  arrayRetValue,
-  // @ts-expect-error returns a query of the wrong type.
-  ctx => {
-    return ctx.from.personWithExtra.build();
-  }
-);
-
-// Ideally this would fail, since we depend on the field ordering for serialization.
-spacetime.anonymousView(
-  { name: 'reorderedPerson', public: true },
-  arrayRetValue,
-  // Comment this out if we can fix the types.
-  // // @ts-expect-error returns a query of the wrong type.
-  ctx => {
-    return ctx.from.personReordered.build();
-  }
-);
-
-// Fails because it is missing a field.
-spacetime.anonymousView(
-  { name: 'missingField', public: true },
-  arrayRetValue,
-  // @ts-expect-error returns a query of the wrong type.
-  ctx => {
-    return ctx.from.personWithMissing.build();
-  }
-);
-
-spacetime.anonymousView({ name: 'v4', public: true }, arrayRetValue, ctx => {
-  // @ts-expect-error returns a query of the wrong type.
-  const _invalid = ctx.from.person.where(row => row.id.eq('string')).build();
-  const _columnEqs = ctx.from.person.where(row => row.id.eq(row.id)).build();
-  return ctx.from.person.where(row => row.id.eq(5)).build();
-});
-
-spacetime.anonymousView({ name: 'v5', public: true }, arrayRetValue, ctx => {
-  const _nonIndexedSemijoin = ctx.from.person
-    .where(row => row.id.eq(5))
-    // @ts-expect-error person_id is not indexed.
-    .leftSemijoin(ctx.from.order, (p, o) => p.id.eq(o.person_id))
-    .build();
-  const _fromCompositeIndex = ctx.from.person
-    .where(row => row.id.eq(5))
-    .leftSemijoin(ctx.from.order, (p, o) => p.name.eq(o.person_name))
-    .build();
-  const _mixedScopeAndInJoinPredicate = ctx.from.person
-    // @ts-expect-error semijoin on(...) only supports one table scope for and/or clauses.
-    .leftSemijoin(ctx.from.order, (p, o) => p.id.eq(o.id).and(o.id.eq(5)))
-    .build();
-  return ctx.from.person
-    .where(row => row.id.eq(5))
-    .leftSemijoin(ctx.from.order, (p, o) => p.id.eq(o.id))
-    .build();
-});
+import { schema } from './schema';
+import { table } from '../lib/table';
+import t from '../lib/type_builders';
+
+const person = table(
+  {
+    name: 'person',
+    indexes: [
+      {
+        accessor: 'name_id_idx',
+        name: 'name_id_idx',
+        algorithm: 'btree',
+        columns: ['name', 'id'] as const,
+      },
+    ],
+  },
+  {
+    id: t.u32().primaryKey(),
+    name: t.string(),
+  }
+);
+
+const personWithExtra = table(
+  { name: 'personWithExtra' },
+  {
+    id: t.u32(),
+    name: t.string(),
+    extraField: t.string(),
+  }
+);
+
+const personWithMissing = table(
+  { name: 'personWithMissing' },
+  {
+    id: t.u32(),
+  }
+);
+
+const personReordered = table(
+  { name: 'personReordered' },
+  {
+    name: t.string(),
+    id: t.u32(),
+  }
+);
+
+const order = table(
+  {
+    name: 'order',
+    indexes: [
+      {
+        accessor: 'id_person_id',
+        name: 'id_person_id', // We are adding this to make sure `person_id` still isn't considered indexed.
+        algorithm: 'btree',
+        columns: ['id', 'person_id'] as const,
+      },
+    ],
+  },
+  {
+    id: t.u32().primaryKey(),
+    person_name: t.string().index(),
+    person_id: t.u32(),
+  }
+);
+
+const spacetime = schema({
+  person,
+  order,
+  personWithExtra,
+  personReordered,
+  personWithMissing,
+});
+
+const arrayRetValue = t.array(person.rowType);
+const optionalPerson = t.option(person.rowType);
+const multiplePrimaryKeyRows = t.array(
+  t.row('MultiplePrimaryKeyRows', {
+    id: t.u32().primaryKey(),
+    name: t.string().primaryKey(),
+  })
+);
+
+spacetime.anonymousView({ name: 'v1', public: true }, arrayRetValue, ctx => {
+  return ctx.from.person.build();
+});
+
+// @ts-expect-error views can have at most one primaryKey column on the returned row type.
+spacetime.anonymousView(
+  { name: 'multiplePrimaryRows', public: true },
+  multiplePrimaryKeyRows,
+  () => []
+);
+
+// @ts-expect-error the same multiple-primary-key check also applies to query-builder views.
+spacetime.anonymousView(
+  { name: 'multiplePrimaryRowsQuery', public: true },
+  multiplePrimaryKeyRows,
+  ctx => {
+    return ctx.from.person;
+  }
+);
+
+spacetime.anonymousView(
+  { name: 'optionalPerson', public: true },
+  optionalPerson,
+  ctx => {
+    return ctx.db.person.iter().next().value;
+  }
+);
+
+spacetime.anonymousView(
+  { name: 'optionalPersonWrong', public: true },
+  optionalPerson,
+  // @ts-expect-error returns a value of the wrong type.
+  ctx => {
+    return ctx.db.order.iter().next().value;
+  }
+);
+
+// Extra fields are only an issue for queries.
+spacetime.anonymousView(
+  { name: 'optionalPersonWithExtra', public: true },
+  optionalPerson,
+  ctx => {
+    return ctx.db.personWithExtra.iter().next().value;
+  }
+);
+
+spacetime.anonymousView(
+  { name: 'v2', public: true },
+  arrayRetValue,
+  // @ts-expect-error returns a query of the wrong type.
+  ctx => {
+    return ctx.from.order.build();
+  }
+);
+
+// For queries, we can't return rows with extra fields.
+spacetime.anonymousView(
+  { name: 'v3', public: true },
+  arrayRetValue,
+  // @ts-expect-error returns a query of the wrong type.
+  ctx => {
+    return ctx.from.personWithExtra.build();
+  }
+);
+
+// Ideally this would fail, since we depend on the field ordering for serialization.
+spacetime.anonymousView(
+  { name: 'reorderedPerson', public: true },
+  arrayRetValue,
+  // Comment this out if we can fix the types.
+  // // @ts-expect-error returns a query of the wrong type.
+  ctx => {
+    return ctx.from.personReordered.build();
+  }
+);
+
+// Fails because it is missing a field.
+spacetime.anonymousView(
+  { name: 'missingField', public: true },
+  arrayRetValue,
+  // @ts-expect-error returns a query of the wrong type.
+  ctx => {
+    return ctx.from.personWithMissing.build();
+  }
+);
+
+spacetime.anonymousView({ name: 'v4', public: true }, arrayRetValue, ctx => {
+  // @ts-expect-error returns a query of the wrong type.
+  const _invalid = ctx.from.person.where(row => row.id.eq('string')).build();
+  const _columnEqs = ctx.from.person.where(row => row.id.eq(row.id)).build();
+  return ctx.from.person.where(row => row.id.eq(5)).build();
+});
+
+spacetime.anonymousView({ name: 'v5', public: true }, arrayRetValue, ctx => {
+  const _nonIndexedSemijoin = ctx.from.person
+    .where(row => row.id.eq(5))
+    // @ts-expect-error person_id is not indexed.
+    .leftSemijoin(ctx.from.order, (p, o) => p.id.eq(o.person_id))
+    .build();
+  const _fromCompositeIndex = ctx.from.person
+    .where(row => row.id.eq(5))
+    .leftSemijoin(ctx.from.order, (p, o) => p.name.eq(o.person_name))
+    .build();
+  const _mixedScopeAndInJoinPredicate = ctx.from.person
+    // @ts-expect-error semijoin on(...) only supports one table scope for and/or clauses.
+    .leftSemijoin(ctx.from.order, (p, o) => p.id.eq(o.id).and(o.id.eq(5)))
+    .build();
+  return ctx.from.person
+    .where(row => row.id.eq(5))
+    .leftSemijoin(ctx.from.order, (p, o) => p.id.eq(o.id))
+    .build();
+});