rivetkit 2.0.2 → 2.0.4

package/README.md

@@ -1,12 +1,10 @@
 # RivetKit
 
-_Lightweight Libraries for Backends_
+_Library to build and scale stateful workloads_
 
-**This is not the RivetKit you are looking for. See [`@rivetkit/actor`](https://www.npmjs.com/package/@rivetkit/core).**
+[Learn More →](https://github.com/rivet-dev/rivetkit)
 
-[Learn More →](https://github.com/rivet-gg/rivetkit)
-
-[Discord](https://rivet.gg/discord) — [Documentation](https://rivetkit.org) — [Issues](https://github.com/rivet-gg/rivetkit/issues)
+[Discord](https://rivet.dev/discord) — [Documentation](https://rivetkit.org) — [Issues](https://github.com/rivet-dev/rivetkit/issues)
 
 ## License
 

package/dist/schemas/actor-persist/v1.ts

@@ -0,0 +1,225 @@
+import * as bare from "@bare-ts/lib"
+
+const config = /* @__PURE__ */ bare.Config({})
+
+export type u64 = bigint
+
+export type PersistedSubscription = {
+    readonly eventName: string,
+}
+
+export function readPersistedSubscription(bc: bare.ByteCursor): PersistedSubscription {
+    return {
+        eventName: bare.readString(bc),
+    }
+}
+
+export function writePersistedSubscription(bc: bare.ByteCursor, x: PersistedSubscription): void {
+    bare.writeString(bc, x.eventName)
+}
+
+function read0(bc: bare.ByteCursor): readonly PersistedSubscription[] {
+    const len = bare.readUintSafe(bc)
+    if (len === 0) { return [] }
+    const result = [readPersistedSubscription(bc)]
+    for (let i = 1; i < len; i++) {
+        result[i] = readPersistedSubscription(bc)
+    }
+    return result
+}
+
+function write0(bc: bare.ByteCursor, x: readonly PersistedSubscription[]): void {
+    bare.writeUintSafe(bc, x.length)
+    for (let i = 0; i < x.length; i++) {
+        writePersistedSubscription(bc, x[i])
+    }
+}
+
+export type PersistedConnection = {
+    readonly id: string,
+    readonly token: string,
+    readonly driver: string,
+    readonly driverState: ArrayBuffer,
+    readonly parameters: ArrayBuffer,
+    readonly state: ArrayBuffer,
+    readonly subscriptions: readonly PersistedSubscription[],
+    readonly lastSeen: u64,
+}
+
+export function readPersistedConnection(bc: bare.ByteCursor): PersistedConnection {
+    return {
+        id: bare.readString(bc),
+        token: bare.readString(bc),
+        driver: bare.readString(bc),
+        driverState: bare.readData(bc),
+        parameters: bare.readData(bc),
+        state: bare.readData(bc),
+        subscriptions: read0(bc),
+        lastSeen: bare.readU64(bc),
+    }
+}
+
+export function writePersistedConnection(bc: bare.ByteCursor, x: PersistedConnection): void {
+    bare.writeString(bc, x.id)
+    bare.writeString(bc, x.token)
+    bare.writeString(bc, x.driver)
+    bare.writeData(bc, x.driverState)
+    bare.writeData(bc, x.parameters)
+    bare.writeData(bc, x.state)
+    write0(bc, x.subscriptions)
+    bare.writeU64(bc, x.lastSeen)
+}
+
+function read1(bc: bare.ByteCursor): ArrayBuffer | null {
+    return bare.readBool(bc)
+        ? bare.readData(bc)
+        : null
+}
+
+function write1(bc: bare.ByteCursor, x: ArrayBuffer | null): void {
+    bare.writeBool(bc, x !== null)
+    if (x !== null) {
+        bare.writeData(bc, x)
+    }
+}
+
+export type GenericPersistedScheduleEvent = {
+    readonly action: string,
+    readonly args: ArrayBuffer | null,
+}
+
+export function readGenericPersistedScheduleEvent(bc: bare.ByteCursor): GenericPersistedScheduleEvent {
+    return {
+        action: bare.readString(bc),
+        args: read1(bc),
+    }
+}
+
+export function writeGenericPersistedScheduleEvent(bc: bare.ByteCursor, x: GenericPersistedScheduleEvent): void {
+    bare.writeString(bc, x.action)
+    write1(bc, x.args)
+}
+
+export type PersistedScheduleEventKind =
+    | { readonly tag: "GenericPersistedScheduleEvent", readonly val: GenericPersistedScheduleEvent }
+
+export function readPersistedScheduleEventKind(bc: bare.ByteCursor): PersistedScheduleEventKind {
+    const offset = bc.offset
+    const tag = bare.readU8(bc)
+    switch (tag) {
+        case 0:
+            return { tag: "GenericPersistedScheduleEvent", val: readGenericPersistedScheduleEvent(bc) }
+        default: {
+            bc.offset = offset
+            throw new bare.BareError(offset, "invalid tag")
+        }
+    }
+}
+
+export function writePersistedScheduleEventKind(bc: bare.ByteCursor, x: PersistedScheduleEventKind): void {
+    switch (x.tag) {
+        case "GenericPersistedScheduleEvent": {
+            bare.writeU8(bc, 0)
+            writeGenericPersistedScheduleEvent(bc, x.val)
+            break
+        }
+    }
+}
+
+export type PersistedScheduleEvent = {
+    readonly eventId: string,
+    readonly timestamp: u64,
+    readonly kind: PersistedScheduleEventKind,
+}
+
+export function readPersistedScheduleEvent(bc: bare.ByteCursor): PersistedScheduleEvent {
+    return {
+        eventId: bare.readString(bc),
+        timestamp: bare.readU64(bc),
+        kind: readPersistedScheduleEventKind(bc),
+    }
+}
+
+export function writePersistedScheduleEvent(bc: bare.ByteCursor, x: PersistedScheduleEvent): void {
+    bare.writeString(bc, x.eventId)
+    bare.writeU64(bc, x.timestamp)
+    writePersistedScheduleEventKind(bc, x.kind)
+}
+
+function read2(bc: bare.ByteCursor): readonly PersistedConnection[] {
+    const len = bare.readUintSafe(bc)
+    if (len === 0) { return [] }
+    const result = [readPersistedConnection(bc)]
+    for (let i = 1; i < len; i++) {
+        result[i] = readPersistedConnection(bc)
+    }
+    return result
+}
+
+function write2(bc: bare.ByteCursor, x: readonly PersistedConnection[]): void {
+    bare.writeUintSafe(bc, x.length)
+    for (let i = 0; i < x.length; i++) {
+        writePersistedConnection(bc, x[i])
+    }
+}
+
+function read3(bc: bare.ByteCursor): readonly PersistedScheduleEvent[] {
+    const len = bare.readUintSafe(bc)
+    if (len === 0) { return [] }
+    const result = [readPersistedScheduleEvent(bc)]
+    for (let i = 1; i < len; i++) {
+        result[i] = readPersistedScheduleEvent(bc)
+    }
+    return result
+}
+
+function write3(bc: bare.ByteCursor, x: readonly PersistedScheduleEvent[]): void {
+    bare.writeUintSafe(bc, x.length)
+    for (let i = 0; i < x.length; i++) {
+        writePersistedScheduleEvent(bc, x[i])
+    }
+}
+
+export type PersistedActor = {
+    readonly input: ArrayBuffer | null,
+    readonly hasInitialized: boolean,
+    readonly state: ArrayBuffer,
+    readonly connections: readonly PersistedConnection[],
+    readonly scheduledEvents: readonly PersistedScheduleEvent[],
+}
+
+export function readPersistedActor(bc: bare.ByteCursor): PersistedActor {
+    return {
+        input: read1(bc),
+        hasInitialized: bare.readBool(bc),
+        state: bare.readData(bc),
+        connections: read2(bc),
+        scheduledEvents: read3(bc),
+    }
+}
+
+export function writePersistedActor(bc: bare.ByteCursor, x: PersistedActor): void {
+    write1(bc, x.input)
+    bare.writeBool(bc, x.hasInitialized)
+    bare.writeData(bc, x.state)
+    write2(bc, x.connections)
+    write3(bc, x.scheduledEvents)
+}
+
+export function encodePersistedActor(x: PersistedActor): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writePersistedActor(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodePersistedActor(bytes: Uint8Array): PersistedActor {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readPersistedActor(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}

package/dist/schemas/client-protocol/v1.ts

@@ -0,0 +1,435 @@
+import * as bare from "@bare-ts/lib"
+
+const config = /* @__PURE__ */ bare.Config({})
+
+export type uint = bigint
+
+export type Init = {
+    readonly actorId: string,
+    readonly connectionId: string,
+    readonly connectionToken: string,
+}
+
+export function readInit(bc: bare.ByteCursor): Init {
+    return {
+        actorId: bare.readString(bc),
+        connectionId: bare.readString(bc),
+        connectionToken: bare.readString(bc),
+    }
+}
+
+export function writeInit(bc: bare.ByteCursor, x: Init): void {
+    bare.writeString(bc, x.actorId)
+    bare.writeString(bc, x.connectionId)
+    bare.writeString(bc, x.connectionToken)
+}
+
+function read0(bc: bare.ByteCursor): ArrayBuffer | null {
+    return bare.readBool(bc)
+        ? bare.readData(bc)
+        : null
+}
+
+function write0(bc: bare.ByteCursor, x: ArrayBuffer | null): void {
+    bare.writeBool(bc, x !== null)
+    if (x !== null) {
+        bare.writeData(bc, x)
+    }
+}
+
+function read1(bc: bare.ByteCursor): uint | null {
+    return bare.readBool(bc)
+        ? bare.readUint(bc)
+        : null
+}
+
+function write1(bc: bare.ByteCursor, x: uint | null): void {
+    bare.writeBool(bc, x !== null)
+    if (x !== null) {
+        bare.writeUint(bc, x)
+    }
+}
+
+export type Error = {
+    readonly group: string,
+    readonly code: string,
+    readonly message: string,
+    readonly metadata: ArrayBuffer | null,
+    readonly actionId: uint | null,
+}
+
+export function readError(bc: bare.ByteCursor): Error {
+    return {
+        group: bare.readString(bc),
+        code: bare.readString(bc),
+        message: bare.readString(bc),
+        metadata: read0(bc),
+        actionId: read1(bc),
+    }
+}
+
+export function writeError(bc: bare.ByteCursor, x: Error): void {
+    bare.writeString(bc, x.group)
+    bare.writeString(bc, x.code)
+    bare.writeString(bc, x.message)
+    write0(bc, x.metadata)
+    write1(bc, x.actionId)
+}
+
+export type ActionResponse = {
+    readonly id: uint,
+    readonly output: ArrayBuffer,
+}
+
+export function readActionResponse(bc: bare.ByteCursor): ActionResponse {
+    return {
+        id: bare.readUint(bc),
+        output: bare.readData(bc),
+    }
+}
+
+export function writeActionResponse(bc: bare.ByteCursor, x: ActionResponse): void {
+    bare.writeUint(bc, x.id)
+    bare.writeData(bc, x.output)
+}
+
+export type Event = {
+    readonly name: string,
+    readonly args: ArrayBuffer,
+}
+
+export function readEvent(bc: bare.ByteCursor): Event {
+    return {
+        name: bare.readString(bc),
+        args: bare.readData(bc),
+    }
+}
+
+export function writeEvent(bc: bare.ByteCursor, x: Event): void {
+    bare.writeString(bc, x.name)
+    bare.writeData(bc, x.args)
+}
+
+export type ToClientBody =
+    | { readonly tag: "Init", readonly val: Init }
+    | { readonly tag: "Error", readonly val: Error }
+    | { readonly tag: "ActionResponse", readonly val: ActionResponse }
+    | { readonly tag: "Event", readonly val: Event }
+
+export function readToClientBody(bc: bare.ByteCursor): ToClientBody {
+    const offset = bc.offset
+    const tag = bare.readU8(bc)
+    switch (tag) {
+        case 0:
+            return { tag: "Init", val: readInit(bc) }
+        case 1:
+            return { tag: "Error", val: readError(bc) }
+        case 2:
+            return { tag: "ActionResponse", val: readActionResponse(bc) }
+        case 3:
+            return { tag: "Event", val: readEvent(bc) }
+        default: {
+            bc.offset = offset
+            throw new bare.BareError(offset, "invalid tag")
+        }
+    }
+}
+
+export function writeToClientBody(bc: bare.ByteCursor, x: ToClientBody): void {
+    switch (x.tag) {
+        case "Init": {
+            bare.writeU8(bc, 0)
+            writeInit(bc, x.val)
+            break
+        }
+        case "Error": {
+            bare.writeU8(bc, 1)
+            writeError(bc, x.val)
+            break
+        }
+        case "ActionResponse": {
+            bare.writeU8(bc, 2)
+            writeActionResponse(bc, x.val)
+            break
+        }
+        case "Event": {
+            bare.writeU8(bc, 3)
+            writeEvent(bc, x.val)
+            break
+        }
+    }
+}
+
+export type ToClient = {
+    readonly body: ToClientBody,
+}
+
+export function readToClient(bc: bare.ByteCursor): ToClient {
+    return {
+        body: readToClientBody(bc),
+    }
+}
+
+export function writeToClient(bc: bare.ByteCursor, x: ToClient): void {
+    writeToClientBody(bc, x.body)
+}
+
+export function encodeToClient(x: ToClient): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writeToClient(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodeToClient(bytes: Uint8Array): ToClient {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readToClient(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}
+
+export type ActionRequest = {
+    readonly id: uint,
+    readonly name: string,
+    readonly args: ArrayBuffer,
+}
+
+export function readActionRequest(bc: bare.ByteCursor): ActionRequest {
+    return {
+        id: bare.readUint(bc),
+        name: bare.readString(bc),
+        args: bare.readData(bc),
+    }
+}
+
+export function writeActionRequest(bc: bare.ByteCursor, x: ActionRequest): void {
+    bare.writeUint(bc, x.id)
+    bare.writeString(bc, x.name)
+    bare.writeData(bc, x.args)
+}
+
+export type SubscriptionRequest = {
+    readonly eventName: string,
+    readonly subscribe: boolean,
+}
+
+export function readSubscriptionRequest(bc: bare.ByteCursor): SubscriptionRequest {
+    return {
+        eventName: bare.readString(bc),
+        subscribe: bare.readBool(bc),
+    }
+}
+
+export function writeSubscriptionRequest(bc: bare.ByteCursor, x: SubscriptionRequest): void {
+    bare.writeString(bc, x.eventName)
+    bare.writeBool(bc, x.subscribe)
+}
+
+export type ToServerBody =
+    | { readonly tag: "ActionRequest", readonly val: ActionRequest }
+    | { readonly tag: "SubscriptionRequest", readonly val: SubscriptionRequest }
+
+export function readToServerBody(bc: bare.ByteCursor): ToServerBody {
+    const offset = bc.offset
+    const tag = bare.readU8(bc)
+    switch (tag) {
+        case 0:
+            return { tag: "ActionRequest", val: readActionRequest(bc) }
+        case 1:
+            return { tag: "SubscriptionRequest", val: readSubscriptionRequest(bc) }
+        default: {
+            bc.offset = offset
+            throw new bare.BareError(offset, "invalid tag")
+        }
+    }
+}
+
+export function writeToServerBody(bc: bare.ByteCursor, x: ToServerBody): void {
+    switch (x.tag) {
+        case "ActionRequest": {
+            bare.writeU8(bc, 0)
+            writeActionRequest(bc, x.val)
+            break
+        }
+        case "SubscriptionRequest": {
+            bare.writeU8(bc, 1)
+            writeSubscriptionRequest(bc, x.val)
+            break
+        }
+    }
+}
+
+export type ToServer = {
+    readonly body: ToServerBody,
+}
+
+export function readToServer(bc: bare.ByteCursor): ToServer {
+    return {
+        body: readToServerBody(bc),
+    }
+}
+
+export function writeToServer(bc: bare.ByteCursor, x: ToServer): void {
+    writeToServerBody(bc, x.body)
+}
+
+export function encodeToServer(x: ToServer): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writeToServer(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodeToServer(bytes: Uint8Array): ToServer {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readToServer(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}
+
+export type HttpActionRequest = {
+    readonly args: ArrayBuffer,
+}
+
+export function readHttpActionRequest(bc: bare.ByteCursor): HttpActionRequest {
+    return {
+        args: bare.readData(bc),
+    }
+}
+
+export function writeHttpActionRequest(bc: bare.ByteCursor, x: HttpActionRequest): void {
+    bare.writeData(bc, x.args)
+}
+
+export function encodeHttpActionRequest(x: HttpActionRequest): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writeHttpActionRequest(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodeHttpActionRequest(bytes: Uint8Array): HttpActionRequest {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readHttpActionRequest(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}
+
+export type HttpActionResponse = {
+    readonly output: ArrayBuffer,
+}
+
+export function readHttpActionResponse(bc: bare.ByteCursor): HttpActionResponse {
+    return {
+        output: bare.readData(bc),
+    }
+}
+
+export function writeHttpActionResponse(bc: bare.ByteCursor, x: HttpActionResponse): void {
+    bare.writeData(bc, x.output)
+}
+
+export function encodeHttpActionResponse(x: HttpActionResponse): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writeHttpActionResponse(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodeHttpActionResponse(bytes: Uint8Array): HttpActionResponse {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readHttpActionResponse(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}
+
+export type HttpResponseError = {
+    readonly group: string,
+    readonly code: string,
+    readonly message: string,
+    readonly metadata: ArrayBuffer | null,
+}
+
+export function readHttpResponseError(bc: bare.ByteCursor): HttpResponseError {
+    return {
+        group: bare.readString(bc),
+        code: bare.readString(bc),
+        message: bare.readString(bc),
+        metadata: read0(bc),
+    }
+}
+
+export function writeHttpResponseError(bc: bare.ByteCursor, x: HttpResponseError): void {
+    bare.writeString(bc, x.group)
+    bare.writeString(bc, x.code)
+    bare.writeString(bc, x.message)
+    write0(bc, x.metadata)
+}
+
+export function encodeHttpResponseError(x: HttpResponseError): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writeHttpResponseError(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodeHttpResponseError(bytes: Uint8Array): HttpResponseError {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readHttpResponseError(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}
+
+export type HttpResolveRequest = null
+
+export type HttpResolveResponse = {
+    readonly actorId: string,
+}
+
+export function readHttpResolveResponse(bc: bare.ByteCursor): HttpResolveResponse {
+    return {
+        actorId: bare.readString(bc),
+    }
+}
+
+export function writeHttpResolveResponse(bc: bare.ByteCursor, x: HttpResolveResponse): void {
+    bare.writeString(bc, x.actorId)
+}
+
+export function encodeHttpResolveResponse(x: HttpResolveResponse): Uint8Array {
+    const bc = new bare.ByteCursor(
+        new Uint8Array(config.initialBufferLength),
+        config
+    )
+    writeHttpResolveResponse(bc, x)
+    return new Uint8Array(bc.view.buffer, bc.view.byteOffset, bc.offset)
+}
+
+export function decodeHttpResolveResponse(bytes: Uint8Array): HttpResolveResponse {
+    const bc = new bare.ByteCursor(bytes, config)
+    const result = readHttpResolveResponse(bc)
+    if (bc.offset < bc.view.byteLength) {
+        throw new bare.BareError(bc.offset, "remaining bytes")
+    }
+    return result
+}