@covenant-rpc/core 0.3.0 → 0.4.0

package/dist/channel.d.ts

@@ -0,0 +1,75 @@
+import { v } from "./validation";
+import type { ChannelDeclaration } from ".";
+import type { MaybePromise, ArrayToMap } from "./utils";
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+export declare const channelErrorSchema: v.Validator<{
+    channel: string;
+    params: Record<string, string>;
+    fault: "server" | "client" | "sidekick";
+    message: string;
+}>;
+export type ChannelError = v.Infer<typeof channelErrorSchema>;
+export declare const channelConnectionRequestSchema: v.Validator<{
+    channel: string;
+    params: Record<string, string>;
+    data: unknown;
+}>;
+export type ChannelConnectionRequest = v.Infer<typeof channelConnectionRequestSchema>;
+export declare const channelConnectionResponseSchema: v.Validator<{
+    channel: string;
+    params: Record<string, string>;
+    result: {
+        type: "OK";
+        token: string;
+    } | {
+        type: "ERROR";
+        error: {
+            channel: string;
+            params: Record<string, string>;
+            fault: "server" | "client" | "sidekick";
+            message: string;
+        };
+    };
+}>;
+export type ChannelConnectionResponse = v.Infer<typeof channelConnectionResponseSchema>;
+export declare const channelConnectionPayload: v.Validator<{
+    token: string;
+    channel: string;
+    params: Record<string, string>;
+    context: unknown;
+}>;
+export type ChannelConnectionPayload = v.Infer<typeof channelConnectionPayload>;
+export declare const serverMessageSchema: v.Validator<{
+    channel: string;
+    params: Record<string, string>;
+    data: unknown;
+}>;
+export type ServerMessage = v.Infer<typeof serverMessageSchema>;
+export declare const serverMessageWithContext: v.Validator<{
+    channel: string;
+    params: Record<string, string>;
+    data: unknown;
+    context: unknown;
+}>;
+export type ServerMessageWithContext = v.Infer<typeof serverMessageWithContext>;
+export interface ConnectionHandlerInputs<T, Params> {
+    inputs: T;
+    params: Params;
+    reject(reason: string, cause: "client" | "server"): never;
+}
+export interface MessageHandlerInputs<T, Params, Context> {
+    inputs: T;
+    params: Params;
+    context: Context;
+    error(reason: string, cause: "client" | "server"): never;
+}
+export type ChannelDefinition<T> = T extends ChannelDeclaration<infer ClientMessage, any, infer ConnectionRequest, infer ConnectionContext, infer Params> ? {
+    onConnect: (i: ConnectionHandlerInputs<StandardSchemaV1.InferOutput<ConnectionRequest>, ArrayToMap<Params>>) => MaybePromise<StandardSchemaV1.InferOutput<ConnectionContext>>;
+    onMessage: (i: MessageHandlerInputs<StandardSchemaV1.InferOutput<ClientMessage>, ArrayToMap<Params>, StandardSchemaV1.InferOutput<ConnectionContext>>) => MaybePromise<void>;
+} : never;
+export type InferChannelClientMessage<C> = C extends ChannelDeclaration<infer ClientMessage, any, any, any, any> ? StandardSchemaV1.InferOutput<ClientMessage> : never;
+export type InferChannelServerMessage<C> = C extends ChannelDeclaration<any, infer ServerMessage, any, any, any> ? StandardSchemaV1.InferOutput<ServerMessage> : never;
+export type InferChannelConnectionRequest<C> = C extends ChannelDeclaration<any, any, infer ConnectionRequest, any, any> ? StandardSchemaV1.InferOutput<ConnectionRequest> : never;
+export type InferChannelConnectionContext<C> = C extends ChannelDeclaration<any, any, any, infer ChannelContext, any> ? StandardSchemaV1.InferOutput<ChannelContext> : never;
+export type InferChannelParams<C> = C extends ChannelDeclaration<any, any, any, any, infer Params> ? ArrayToMap<Params> : never;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../channel.ts"],"names":[],"mappings":"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"}

package/dist/channel.js

@@ -0,0 +1,44 @@
+import { v } from "./validation";
+export const channelErrorSchema = v.obj({
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    fault: v.union(v.literal("server"), v.literal("client"), v.literal("sidekick")),
+    message: v.string(),
+});
+// sent from the client to the server
+export const channelConnectionRequestSchema = v.obj({
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    data: v.unknown(),
+});
+// sent from the server back to the client to inform of a connection
+export const channelConnectionResponseSchema = v.obj({
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    result: v.union(v.obj({
+        type: v.literal("OK"),
+        token: v.string(),
+    }), v.obj({
+        type: v.literal("ERROR"),
+        error: channelErrorSchema,
+    }))
+});
+// sent from the server to the sidekick to inform of a new connection
+export const channelConnectionPayload = v.obj({
+    token: v.string(),
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    context: v.unknown(),
+});
+export const serverMessageSchema = v.obj({
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    data: v.unknown(),
+});
+export const serverMessageWithContext = v.obj({
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    data: v.unknown(),
+    context: v.unknown(),
+});
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAMjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,GAAG,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAIH,qCAAqC;AACrC,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,GAAG,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CAClB,CAAC,CAAC;AAGH,oEAAoE;AACpE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,GAAG,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,GAAG,CAAC;QACJ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC,EACF,CAAC,CAAC,GAAG,CAAC;QACJ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,KAAK,EAAE,kBAAkB;KAC1B,CAAC,CACH;CACF,CAAC,CAAC;AAGH,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,GAAG,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,GAAG,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CAClB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,GAAG,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+import type { ChannelError } from "./channel";
+import type { ProcedureError } from "./procedure";
+export declare class ThrowableProcedureError {
+    message: string;
+    httpCode: number;
+    constructor(message: string, httpCode: number);
+    static fromError(error: Error): ThrowableProcedureError;
+    static fromUnknown(k: unknown): ThrowableProcedureError;
+    toProcedureError(): ProcedureError;
+}
+export declare function procedureErrorFromUnknown(e: unknown): {
+    message: string;
+    code: number;
+};
+export declare class ThrowableChannelError {
+    message: string;
+    cause: "client" | "server" | "sidekick";
+    channel: string;
+    params: Record<string, string>;
+    constructor(message: string, channel: string, params: Record<string, string>, cause: "client" | "server" | "sidekick");
+    static fromError(error: Error, channel: string, params: Record<string, string>): ThrowableChannelError;
+    static fromUnknown(error: unknown, channel: string, params: Record<string, string>): ThrowableChannelError;
+    toChannelError(): ChannelError;
+}
+export declare function channelErrorFromUnknown(e: unknown, channel: string, params: Record<string, string>): {
+    channel: string;
+    params: Record<string, string>;
+    fault: "server" | "client" | "sidekick";
+    message: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,qBAAa,uBAAuB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;gBAEL,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK7C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,uBAAuB;IAIvD,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,uBAAuB;IAIvD,gBAAgB,IAAI,cAAc;CAMnC;AAGD,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO;;;EAOnD;AAGD,qBAAa,qBAAqB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU;IAOrH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,qBAAqB;IAItG,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,qBAAqB;IAK1G,cAAc,IAAI,YAAY;CAQ/B;AAGD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;EAOlG"}

package/dist/errors.js

@@ -0,0 +1,61 @@
+export class ThrowableProcedureError {
+    message;
+    httpCode;
+    constructor(message, httpCode) {
+        this.message = message;
+        this.httpCode = httpCode;
+    }
+    static fromError(error) {
+        return new ThrowableProcedureError(error.message, 500);
+    }
+    static fromUnknown(k) {
+        return new ThrowableProcedureError(`Unknown error: ${k}`, 500);
+    }
+    toProcedureError() {
+        return {
+            message: this.message,
+            code: this.httpCode,
+        };
+    }
+}
+export function procedureErrorFromUnknown(e) {
+    const err = e instanceof ThrowableProcedureError
+        ? e : e instanceof Error
+        ? ThrowableProcedureError.fromError(e)
+        : ThrowableProcedureError.fromUnknown(e);
+    return err.toProcedureError();
+}
+export class ThrowableChannelError {
+    message;
+    cause;
+    channel;
+    params;
+    constructor(message, channel, params, cause) {
+        this.message = message;
+        this.channel = channel;
+        this.params = params;
+        this.cause = cause;
+    }
+    static fromError(error, channel, params) {
+        return new ThrowableChannelError(error.message, channel, params, "server");
+    }
+    static fromUnknown(error, channel, params) {
+        return new ThrowableChannelError(`Unknown error: ${error}`, channel, params, "server");
+    }
+    toChannelError() {
+        return {
+            channel: this.channel,
+            params: this.params,
+            message: this.message,
+            fault: this.cause,
+        };
+    }
+}
+export function channelErrorFromUnknown(e, channel, params) {
+    const err = e instanceof ThrowableChannelError
+        ? e : e instanceof Error
+        ? ThrowableChannelError.fromError(e, channel, params)
+        : ThrowableChannelError.fromUnknown(e, channel, params);
+    return err.toChannelError();
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,uBAAuB;IAClC,OAAO,CAAS;IAChB,QAAQ,CAAS;IAEjB,YAAY,OAAe,EAAE,QAAgB;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAY;QAC3B,OAAO,IAAI,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,CAAU;QAC3B,OAAO,IAAI,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,gBAAgB;QACd,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,QAAQ;SACpB,CAAA;IACH,CAAC;CACF;AAGD,MAAM,UAAU,yBAAyB,CAAC,CAAU;IAClD,MAAM,GAAG,GAAG,CAAC,YAAY,uBAAuB;QAC9C,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK;QACxB,CAAC,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAE3C,OAAO,GAAG,CAAC,gBAAgB,EAAE,CAAC;AAChC,CAAC;AAGD,MAAM,OAAO,qBAAqB;IAChC,OAAO,CAAS;IAChB,KAAK,CAAmC;IACxC,OAAO,CAAS;IAChB,MAAM,CAAyB;IAE/B,YAAY,OAAe,EAAE,OAAe,EAAE,MAA8B,EAAE,KAAuC;QACnH,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAAY,EAAE,OAAe,EAAE,MAA8B;QAC5E,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,KAAc,EAAE,OAAe,EAAE,MAA8B;QAChF,OAAO,IAAI,qBAAqB,CAAC,kBAAkB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzF,CAAC;IAGD,cAAc;QACZ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAA;IACH,CAAC;CACF;AAGD,MAAM,UAAU,uBAAuB,CAAC,CAAU,EAAE,OAAe,EAAE,MAA8B;IACjG,MAAM,GAAG,GAAG,CAAC,YAAY,qBAAqB;QAC5C,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,KAAK;QACxB,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC;QACrD,CAAC,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE1D,OAAO,GAAG,CAAC,cAAc,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { MaybePromise } from "./utils";
+import type { ProcedureInputs } from "./procedure";
+export type ProcedureType = "mutation" | "query";
+export interface ProcedureDeclaration<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1, T> {
+    input: InputSchema;
+    output: OutputSchema;
+    type: T;
+}
+export type ProcedureMap = {
+    [p: string]: ProcedureDeclaration<StandardSchemaV1, StandardSchemaV1, ProcedureType>;
+};
+export interface ChannelDeclaration<ClientMessageSchema extends StandardSchemaV1, ServerMessageSchema extends StandardSchemaV1, ConnectionRequestSchema extends StandardSchemaV1, ConnectionContextSchema extends StandardSchemaV1, Params extends string[]> {
+    clientMessage: ClientMessageSchema;
+    serverMessage: ServerMessageSchema;
+    connectionRequest: ConnectionRequestSchema;
+    connectionContext: ConnectionContextSchema;
+    params: Params;
+}
+export type ChannelMap = {
+    [channel: string]: ChannelDeclaration<StandardSchemaV1, StandardSchemaV1, StandardSchemaV1, StandardSchemaV1, string[]>;
+};
+export interface Covenant<P extends ProcedureMap, C extends ChannelMap> {
+    procedures: P;
+    channels: C;
+}
+export declare function declareCovenant<P extends ProcedureMap, C extends ChannelMap>(covenant: Covenant<P, C>): Covenant<P, C>;
+export declare function mutation<Inputs extends StandardSchemaV1, Outputs extends StandardSchemaV1>({ input, output }: {
+    input: Inputs;
+    output: Outputs;
+}): ProcedureDeclaration<Inputs, Outputs, "mutation">;
+export declare function query<Inputs extends StandardSchemaV1, Outputs extends StandardSchemaV1>({ input, output }: {
+    input: Inputs;
+    output: Outputs;
+}): ProcedureDeclaration<Inputs, Outputs, "query">;
+export declare function channel<ClientMessageSchema extends StandardSchemaV1, ServerMessageSchema extends StandardSchemaV1, ConnectionRequestSchema extends StandardSchemaV1, ConnectionContextSchema extends StandardSchemaV1, Params extends string[]>(c: {
+    clientMessage: ClientMessageSchema;
+    serverMessage: ServerMessageSchema;
+    connectionRequest: ConnectionRequestSchema;
+    connectionContext: ConnectionContextSchema;
+    params: Params;
+}): {
+    clientMessage: ClientMessageSchema;
+    serverMessage: ServerMessageSchema;
+    connectionRequest: ConnectionRequestSchema;
+    connectionContext: ConnectionContextSchema;
+    params: Params;
+};
+export type ContextGenerator<Context extends StandardSchemaV1> = (i: ProcedureInputs<unknown, undefined, undefined>) => MaybePromise<StandardSchemaV1.InferOutput<Context>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,22 @@
+export function declareCovenant(covenant) {
+    return covenant;
+}
+export function mutation({ input, output }) {
+    return {
+        type: "mutation",
+        input,
+        output,
+    };
+}
+export function query({ input, output }) {
+    return {
+        type: "query",
+        input,
+        output,
+    };
+}
+// helper function to get better autocomplete
+export function channel(c) {
+    return c;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAwDA,MAAM,UAAU,eAAe,CAG7B,QAAwB;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,QAAQ,CAGtB,EAAE,KAAK,EAAE,MAAM,EAGhB;IACC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,MAAM;KACP,CAAA;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAGnB,EAAE,KAAK,EAAE,MAAM,EAGhB;IACC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK;QACL,MAAM;KACP,CAAA;AACH,CAAC;AAGD,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CAMrB,CAMD;IACC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/interfaces.d.ts

@@ -0,0 +1,21 @@
+import type { MaybePromise } from "./utils";
+import type { ChannelConnectionPayload, ChannelConnectionRequest, ChannelConnectionResponse, ChannelError, ServerMessage, ServerMessageWithContext } from "./channel";
+import type { ProcedureRequestBody, ProcedureResponse } from "./procedure";
+import type { SidekickIncomingMessage, SidekickOutgoingMessage } from "./sidekick/protocol";
+export interface ClientToServerConnection {
+    sendConnectionRequest(request: ChannelConnectionRequest): Promise<ChannelConnectionResponse>;
+    runProcedure(request: ProcedureRequestBody): Promise<ProcedureResponse>;
+}
+export interface ClientToSidekickConnection {
+    sendMessage(message: SidekickIncomingMessage): void;
+    onMessage(handler: (m: SidekickOutgoingMessage) => MaybePromise<void>): () => void;
+}
+export interface ServerToSidekickConnection {
+    addConnection(payload: ChannelConnectionPayload): Promise<Error | null>;
+    update(resources: string[]): Promise<Error | null>;
+    postMessage(message: ServerMessage): Promise<Error | null>;
+}
+export interface SidekickToServerConnection {
+    sendMessage(message: ServerMessageWithContext): Promise<ChannelError | null>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,YAAY,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACtK,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG5F,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7F,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACzE;AAGD,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpD,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,uBAAuB,KAAK,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;CACpF;AAGD,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACnD,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAC5D;AAGD,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAC9E"}

package/dist/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../interfaces.ts"],"names":[],"mappings":""}

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+export type LoggerLevel = "info" | "error" | "warn" | "slient" | "debug";
+export type Prefix = string | (() => string);
+export interface Logger {
+    prefixes: Prefix[];
+    level: LoggerLevel;
+    sublogger(prefix: Prefix): Logger;
+    pushPrefix(prefix: Prefix): Logger;
+    clone(): Logger;
+    debug(text: string): void;
+    info(text: string): void;
+    error(text: string): void;
+    warn(text: string): void;
+    fatal(text: string): never;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AACzE,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;AAE7C,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,KAAK,IAAI,MAAM,CAAC;IAChB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CAC5B"}

package/dist/logger.js

@@ -0,0 +1,4 @@
+// Logger interface for type safety in core
+// Implementation lives in @covenant-rpc/server
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../logger.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,+CAA+C"}

package/dist/procedure.d.ts

@@ -0,0 +1,69 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { ProcedureDeclaration, ProcedureType } from ".";
+import type { MaybePromise } from "./utils";
+import { v } from "./validation";
+import type { Logger } from "./logger";
+export interface ProcedureRequest {
+    headers: Headers;
+    input: unknown;
+    url: string;
+    procedure: string;
+    path: string;
+    req: Request;
+}
+export interface ProcedureInputs<Inputs, Context, Derivation> {
+    inputs: Inputs;
+    ctx: Context;
+    derived: Derivation;
+    request: ProcedureRequest;
+    logger: Logger;
+    setHeader: (name: string, value: string) => void;
+    deleteHeader: (name: string) => void;
+    error: (message: string, code: number) => never;
+}
+export interface ResourceInputs<Inputs, Context, Outputs> {
+    inputs: Inputs;
+    logger: Logger;
+    ctx: Context;
+    outputs: Outputs;
+}
+export type ProcedureDefinition<T, Context, Derivation> = T extends ProcedureDeclaration<infer InputSchema, infer OutputSchema, ProcedureType> ? {
+    procedure: (i: ProcedureInputs<StandardSchemaV1.InferOutput<InputSchema>, Context, Derivation>) => MaybePromise<StandardSchemaV1.InferOutput<OutputSchema>>;
+    resources: (i: ResourceInputs<StandardSchemaV1.InferOutput<InputSchema>, Context, StandardSchemaV1.InferOutput<OutputSchema>>) => MaybePromise<string[]>;
+} : never;
+export declare const procedureErrorSchema: v.Validator<{
+    message: string;
+    code: number;
+}>;
+export type ProcedureError = v.Infer<typeof procedureErrorSchema>;
+export declare const procedureResponseSchema: v.Validator<{
+    status: "OK";
+    data: unknown;
+    resources: string[];
+} | {
+    status: "ERR";
+    error: {
+        message: string;
+        code: number;
+    };
+}>;
+export type ProcedureResponse = v.Infer<typeof procedureResponseSchema>;
+export declare const procedureRequestBodySchema: v.Validator<{
+    procedure: string;
+    inputs: unknown;
+}>;
+export type ProcedureRequestBody = v.Infer<typeof procedureRequestBodySchema>;
+export type InferProcedureInputs<P> = P extends ProcedureDeclaration<infer InputSchema, any, any> ? StandardSchemaV1.InferInput<InputSchema> : never;
+export type InferProcedureOutputs<P> = P extends ProcedureDeclaration<any, infer OutputSchema, any> ? StandardSchemaV1.InferOutput<OutputSchema> : never;
+export type InferProcedureResult<P> = {
+    success: true;
+    data: InferProcedureOutputs<P>;
+    resources: string[];
+    error: null;
+} | {
+    success: false;
+    error: ProcedureError;
+    data: null;
+    resources: null;
+};
+//# sourceMappingURL=procedure.d.ts.map

package/dist/procedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.d.ts","sourceRoot":"","sources":["../procedure.ts"],"names":[],"mappings":"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"}

package/dist/procedure.js

@@ -0,0 +1,18 @@
+import { v } from "./validation";
+export const procedureErrorSchema = v.obj({
+    message: v.string(),
+    code: v.number(),
+});
+export const procedureResponseSchema = v.union(v.obj({
+    status: v.literal("OK"),
+    data: v.unknown(),
+    resources: v.array(v.string()),
+}), v.obj({
+    status: v.literal("ERR"),
+    error: procedureErrorSchema,
+}));
+export const procedureRequestBodySchema = v.obj({
+    procedure: v.string(),
+    inputs: v.unknown(),
+});
+//# sourceMappingURL=procedure.js.map

package/dist/procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.js","sourceRoot":"","sources":["../procedure.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AA+CjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,GAAG,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC5C,CAAC,CAAC,GAAG,CAAC;IACJ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC,EACF,CAAC,CAAC,GAAG,CAAC;IACJ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACxB,KAAK,EAAE,oBAAoB;CAC5B,CAAC,CACH,CAAC;AAIF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,GAAG,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC"}

package/dist/sidekick/protocol.d.ts

@@ -0,0 +1,89 @@
+import { v } from "../validation";
+export declare const subscribeMessageSchema: v.Validator<{
+    type: "subscribe";
+    token: string;
+}>;
+export type SubscribeMessage = v.Infer<typeof subscribeMessageSchema>;
+export declare const unsubscribeMessageSchema: v.Validator<{
+    type: "unsubscribe";
+    token: string;
+}>;
+export type UnsubscribeMessage = v.Infer<typeof unsubscribeMessageSchema>;
+export declare const sendMessageSchema: v.Validator<{
+    type: "send";
+    token: string;
+    channel: string;
+    params: Record<string, string>;
+    data: unknown;
+}>;
+export type SendMessage = v.Infer<typeof sendMessageSchema>;
+export declare const listenMessageSchema: v.Validator<{
+    type: "listen";
+    resources: string[];
+}>;
+export type ListenMessage = v.Infer<typeof listenMessageSchema>;
+export declare const unlistenMessageSchema: v.Validator<{
+    type: "unlisten";
+    resources: string[];
+}>;
+export type UnlistenMessage = v.Infer<typeof unlistenMessageSchema>;
+export declare const sidekickIncomingMessageSchema: v.Validator<{
+    type: "subscribe";
+    token: string;
+} | {
+    type: "unsubscribe";
+    token: string;
+} | {
+    type: "send";
+    token: string;
+    channel: string;
+    params: Record<string, string>;
+    data: unknown;
+} | {
+    type: "listen";
+    resources: string[];
+} | {
+    type: "unlisten";
+    resources: string[];
+}>;
+export type SidekickIncomingMessage = v.Infer<typeof sidekickIncomingMessageSchema>;
+export declare const sidekickOutgoingMessageSchema: v.Validator<{
+    type: "error";
+    error: {
+        channel: string;
+        params: Record<string, string>;
+        fault: "server" | "client" | "sidekick";
+        message: string;
+    };
+} | {
+    type: "message";
+    channel: string;
+    params: Record<string, string>;
+    data: unknown;
+} | {
+    type: "updated";
+    resource: string;
+} | {
+    type: "listening";
+    resources: string[];
+} | {
+    type: "unlistening";
+    resources: string[];
+} | {
+    type: "subscribed";
+    channel: string;
+    params: Record<string, string>;
+} | {
+    type: "unsubscribed";
+    channel: string;
+    params: Record<string, string>;
+} | {
+    type: "listening";
+    channel: string;
+    params: Record<string, string>;
+}>;
+export type SidekickOutgoingMessage = v.Infer<typeof sidekickOutgoingMessageSchema>;
+export declare function getChannelTopicName(channel: string, params: Record<string, string>): string;
+export declare function getResourceTopicName(resource: string): string;
+export declare function getMapId(wsId: string, topic: string): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/sidekick/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../sidekick/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAKlC,eAAO,MAAM,sBAAsB;;;EAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,wBAAwB;;;EAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;EAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;EAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;EAMzC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAGpF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCzC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAGpF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAGlF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,UAEpD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAEnD"}

package/dist/sidekick/protocol.js

@@ -0,0 +1,68 @@
+import { channelErrorSchema } from "../channel";
+import { v } from "../validation";
+// tokens are given to the server and the sidekick at the same time
+export const subscribeMessageSchema = v.obj({
+    type: v.literal("subscribe"),
+    token: v.string(),
+});
+export const unsubscribeMessageSchema = v.obj({
+    type: v.literal("unsubscribe"),
+    token: v.string(),
+});
+export const sendMessageSchema = v.obj({
+    type: v.literal("send"),
+    token: v.string(),
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    data: v.unknown(),
+});
+export const listenMessageSchema = v.obj({
+    type: v.literal("listen"),
+    resources: v.array(v.string()),
+});
+export const unlistenMessageSchema = v.obj({
+    type: v.literal("unlisten"),
+    resources: v.array(v.string()),
+});
+export const sidekickIncomingMessageSchema = v.union(subscribeMessageSchema, unsubscribeMessageSchema, sendMessageSchema, listenMessageSchema, unlistenMessageSchema);
+export const sidekickOutgoingMessageSchema = v.union(v.obj({
+    type: v.literal("error"),
+    error: channelErrorSchema,
+}), v.obj({
+    type: v.literal("message"),
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+    data: v.unknown(),
+}), v.obj({
+    type: v.literal("updated"),
+    resource: v.string(),
+}), v.obj({
+    type: v.literal("listening"),
+    resources: v.array(v.string()),
+}), v.obj({
+    type: v.literal("unlistening"),
+    resources: v.array(v.string()),
+}), v.obj({
+    type: v.literal("subscribed"),
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+}), v.obj({
+    type: v.literal("unsubscribed"),
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+}), v.obj({
+    type: v.literal("listening"),
+    channel: v.string(),
+    params: v.record(v.string(), v.string()),
+}));
+export function getChannelTopicName(channel, params) {
+    const map = Object.keys(params).map(k => `${k}:${params[k]}`).join(",");
+    return `channel:${channel}/${map}`;
+}
+export function getResourceTopicName(resource) {
+    return `resource:${resource}`;
+}
+export function getMapId(wsId, topic) {
+    return `${wsId}@${topic}`;
+}
+//# sourceMappingURL=protocol.js.map