@otonoma/paranet-client 2.11.0-rc.18

package/README.md

@@ -0,0 +1,2 @@
+# TypeScript Paranet Client Library
+This library includes two main client libraries: The `PncpClient` and `ParanetServiceClient`.

package/dist/client.d.ts

@@ -0,0 +1,168 @@
+import { BrokerClient } from "./proto/broker.grpc.client";
+import { PncpRequest, PncpMessage, PncpCallback } from "./proto/pncp";
+import { MessageResponse, PncpCallbackRequest } from "./proto/broker_api";
+import { ObservationCallback, ObservationMessageWrapper, ObservationRequest } from "./proto/observation";
+import { GrpcWebFetchTransport } from "@protobuf-ts/grpcweb-transport";
+import { RpcMetadata, RpcOptions, ServerStreamingCall, UnaryCall } from "@protobuf-ts/runtime-rpc";
+import { MessageRequest, PncpMessageObject, SkillRequest } from "./pncp";
+import { HealthClient } from "./proto/grpc/health/v1/health.client";
+export interface ParanetClientInit {
+    endpoint: string;
+    actorId: string;
+}
+export interface PncpClientInit {
+    endpoint: string;
+    actorId: string;
+    actorVersion?: string;
+    token?: string;
+    refreshToken?: string;
+}
+export declare class PncpClient {
+    transport: GrpcWebFetchTransport;
+    inner: BrokerClient;
+    health: HealthClient;
+    endpoint: string;
+    actorId: string;
+    actorVersion?: string;
+    token?: string;
+    refreshToken?: string;
+    tokenExp?: Date;
+    tokenCb?: (token: string, refresh: string) => void;
+    constructor(init: PncpClientInit);
+    healthCheck(service?: string): Promise<boolean>;
+    pncpRequest(req: SkillRequest): Promise<MessageResponse>;
+    directPncpRequest(req: PncpRequest): Promise<MessageResponse>;
+    pncpMessage(data: MessageRequest): Promise<MessageResponse>;
+    pncpMessageObject(data: PncpMessageObject): Promise<MessageResponse>;
+    directPncpMessage(data: PncpMessage): Promise<MessageResponse>;
+    pncpListener(): PncpListener;
+    observerListener(init: ObservationRequest): ParanetObserverListener;
+    login(creds: LoginCredentials): Promise<TokenResponse>;
+    refreshAuth(): Promise<TokenResponse>;
+    logout(): void;
+    setTokens(token?: string, refresh?: string): void;
+    setTokenCb(cb: (token: string, refresh: string) => void): void;
+    hasTokens(): boolean;
+    getTokens(): {
+        token?: string;
+        refresh?: string;
+    };
+    isTokenValid(): boolean;
+    getMetadata(): RpcMetadata;
+    issue<R extends object, T extends object>(req: R, f: (this: BrokerClient, req: R, metadata: RpcOptions) => UnaryCall<R, T>): Promise<T>;
+}
+export declare abstract class ParanetListener<Treq extends object, Tres extends object, TresIn extends object = Tres> {
+    client: PncpClient;
+    start?: (client: PncpClient) => void;
+    msg?: (msg: Tres, client: PncpClient) => void;
+    error?: (msg: string, fatal: boolean) => void;
+    disconnected?: () => void;
+    reconnected?: () => void;
+    shouldAutoReconnect: boolean;
+    streamState?: {
+        stream: ServerStreamingCall<Treq, TresIn>;
+        abort: AbortController;
+    };
+    protected constructor(client: PncpClient);
+    protected abstract getRequest(): RpcStreamRequest<Treq, TresIn>;
+    protected abstract getRes(t: TresIn): Tres | null;
+    onmessage(f: (msg: Tres, client: PncpClient) => void): this;
+    onstart(f: (client: PncpClient) => void): this;
+    onerror(f: (msg: string, isFatal: boolean) => void): this;
+    ondisconnect(f: () => void): this;
+    onreconnect(f: () => void): this;
+    autoReconnect(v: boolean): this;
+    connect(): void;
+    disconnect(): void;
+    makeDecoratedStream(isReconnect: boolean, timeout?: number): void;
+}
+export declare class PncpListener extends ParanetListener<PncpCallbackRequest, PncpCallback> {
+    constructor(client: PncpClient);
+    protected getRequest(): RpcStreamRequest<PncpCallbackRequest, PncpCallback>;
+    protected getRes(t: PncpCallback): PncpCallback | null;
+}
+interface RpcStreamRequest<TReq extends object, TRes extends object> {
+    method: (this: BrokerClient, body: TReq, meta: RpcOptions) => ServerStreamingCall<TReq, TRes>;
+    body: TReq;
+}
+export declare class ParanetObserverListener extends ParanetListener<ObservationRequest, ObservationCallback, ObservationMessageWrapper> {
+    init: ObservationRequest;
+    constructor(client: PncpClient, init: ObservationRequest);
+    protected getRequest(): RpcStreamRequest<ObservationRequest, ObservationMessageWrapper>;
+    protected getRes(t: ObservationMessageWrapper): ObservationCallback | null;
+}
+export declare abstract class BaseClient {
+    actorId: string;
+    endpoint: string;
+    protected token?: string;
+    protected refreshToken?: string;
+    protected tokenExp?: Date;
+    protected tokenCb?: (token: string, refresh: string) => void;
+    constructor(init: ParanetClientInit);
+    getEndpoint(): string;
+    login(secret: ActorSecret): Promise<TokenResponse>;
+    refreshAuth(): Promise<TokenResponse>;
+    logout(): void;
+    setTokens(token?: string, refresh?: string): void;
+    setTokenCb(cb: (token: string, refresh: string) => void): void;
+    hasTokens(): boolean;
+    getTokens(): {
+        token?: string;
+        refresh?: string;
+    };
+    isTokenValid(): boolean;
+    protected postJson<T>(path: string, body: any): Promise<T>;
+    protected post_(path: string, body: any, headers?: Record<string, string>): Promise<Response>;
+    protected get<T>(path: string): Promise<T>;
+    protected fetch(path: string, method: string, body?: any, headers?: Record<string, string>): Promise<Response>;
+    getHeaders(): any;
+}
+export declare class ParanetServiceClient extends BaseClient {
+    constructor(init: ParanetClientInit);
+    serviceEndpoint(): string;
+    schemaFetch(path: string): Promise<any>;
+    documentFetch({ name, id }: DocumentArgs): Promise<Response>;
+    documentUpload(data: File | any, args?: DocumentArgs): Promise<DocumentInfo>;
+    graphql(query: string, inputs?: Record<string, any>): Promise<any>;
+}
+export declare class SysClient extends BaseClient {
+    constructor(init: ParanetClientInit);
+    nodeInfo(): Promise<NodeInfo>;
+}
+export interface LoginCredentials {
+    secret: string;
+    kind: "password" | "token" | "jwt";
+}
+export type ActorSecret = {
+    password: string;
+} | {
+    token: string;
+} | {
+    jwt: string;
+};
+export type TokenResponse = {
+    access_token: string;
+    refresh_token: string;
+};
+export interface DocumentArgs {
+    name?: string;
+    id?: string;
+}
+export interface DocumentInfo {
+    id: string;
+    contentType: string;
+}
+export interface NodeInfo {
+    id: string;
+    name: string;
+    versions: {
+        broker: string;
+        expected_paraflow: string;
+        expected_paracord: string;
+        para_version: string;
+        platform_version: string;
+        platform_channel: string;
+    };
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,497 @@
+// Wrapper client around the paranet broker and data service.
+import { BrokerClient } from "./proto/broker.grpc.client";
+import { ConversationMembership } from "./proto/identifiers";
+import { SkillMatchStrategy, PncpMessageKind, } from "./proto/pncp";
+import { jwtDecode } from "jwt-decode";
+import { GrpcWebFetchTransport } from "@protobuf-ts/grpcweb-transport";
+import { fromJsonValue } from "./util";
+import { Value } from "./proto/otonoma/common/value";
+import { HealthClient } from "./proto/grpc/health/v1/health.client";
+import { HealthCheckResponse_ServingStatus } from "./proto/grpc/health/v1/health";
+export class PncpClient {
+    constructor(init) {
+        this.actorId = init.actorId;
+        this.endpoint = init.endpoint;
+        this.actorVersion = init.actorVersion;
+        // TODO: Consider passing in transport config.
+        this.transport = new GrpcWebFetchTransport({
+            baseUrl: init.endpoint,
+            format: "binary",
+            // TODO: Consider other methods here.
+        });
+        this.inner = new BrokerClient(this.transport);
+        this.health = new HealthClient(this.transport);
+    }
+    async healthCheck(service = "") {
+        const req = { service };
+        const response = this.health.check(req);
+        await response.status;
+        const data = await response.response;
+        return data.status === HealthCheckResponse_ServingStatus.SERVING;
+    }
+    async pncpRequest(req) {
+        let version = req.actorVersion || this.actorVersion;
+        if (!version) {
+            throw new Error("Invalid request, must know the actor version");
+        }
+        let pncpReq = {
+            body: {
+                subject: req.subject,
+                action: req.action,
+                body: Value.fromJson(req.body),
+            },
+            author: {
+                id: this.actorId,
+                version: version,
+            },
+            callback: req.callback ? fromJsonValue(req.callback) : undefined,
+            parentId: req.parentConversationId,
+            versionReq: req.versionReq,
+            targetActorId: req.targetId,
+            matchStrategy: req.matchStrategy || SkillMatchStrategy.BEST,
+            mustMatch: req.mustMatch || true,
+            useLock: req.useLock || false,
+            allowOpenMatch: req.allowOpenMatch || false,
+        };
+        return await this.directPncpRequest(pncpReq);
+    }
+    async directPncpRequest(req) {
+        let response = await this.issue(req, BrokerClient.prototype.skillRequest);
+        return response;
+    }
+    async pncpMessage(data) {
+        const [id, tag] = data.conversation.split("@");
+        const membership = tag === "requester" ? ConversationMembership.REQUESTER : tag === "fulfiller" ? ConversationMembership.FULFILLER : ConversationMembership.OBSERVER;
+        let pncpId = { id, membership };
+        return await this.pncpMessageObject({ id: pncpId, body: data.message });
+    }
+    async pncpMessageObject(data) {
+        let extra;
+        switch (data.body.type) {
+            case PncpMessageKind.PNCP_QUESTION: {
+                extra = {
+                    oneofKind: "question",
+                    question: {
+                        id: data.body.value.id,
+                        callback: data.body.value.callback ? fromJsonValue(data.body.value.callback) : undefined,
+                    }
+                };
+                break;
+            }
+            case PncpMessageKind.PNCP_ANSWER: {
+                extra = {
+                    oneofKind: "answer",
+                    answer: {
+                        replyTo: data.body.value.reply_to,
+                    }
+                };
+                break;
+            }
+            default: extra = { oneofKind: undefined };
+        }
+        let pncpMsg = {
+            id: data.id,
+            kind: data.body.type,
+            body: fromJsonValue(data.body.value.data),
+            extra,
+        };
+        return await this.directPncpMessage(pncpMsg);
+    }
+    async directPncpMessage(data) {
+        let response = await this.issue(data, BrokerClient.prototype.pncpMessageRequest);
+        return response;
+    }
+    // Creates a new pncp callback listener.
+    pncpListener() {
+        return new PncpListener(this);
+    }
+    observerListener(init) {
+        return new ParanetObserverListener(this, init);
+    }
+    async login(creds) {
+        let secret;
+        switch (creds.kind) {
+            case "token":
+                secret = { oneofKind: "token", token: creds.secret };
+                break;
+            case "password":
+                secret = { oneofKind: "password", password: creds.secret };
+                break;
+            default:
+                throw new Error("Invalid creds type");
+        }
+        let req = {
+            actorId: this.actorId,
+            secret,
+        };
+        let response = await this.issue(req, BrokerClient.prototype.login);
+        let token = response.token;
+        let refresh_token = response.refreshToken;
+        this.setTokens(token, refresh_token);
+        return { refresh_token, access_token: token };
+    }
+    async refreshAuth() {
+        if (!this.token || !this.refreshToken) {
+            throw new Error("Cannot refresh auth, no tokens set.");
+        }
+        let req = {
+            token: this.token,
+            refreshToken: this.refreshToken,
+        };
+        let response = await this.issue(req, BrokerClient.prototype.refreshToken);
+        let token = response.token;
+        let refreshToken = response.refreshToken;
+        this.setTokens(token, refreshToken);
+        return { refresh_token: refreshToken, access_token: token };
+    }
+    logout() {
+        this.setTokens();
+    }
+    setTokens(token, refresh) {
+        this.token = token;
+        this.refreshToken = refresh;
+        if (token && refresh) {
+            let decoded = jwtDecode(token);
+            this.tokenExp = decoded.exp ? new Date(decoded.exp * 1000) : undefined;
+            if (this.tokenCb) {
+                this.tokenCb(token, refresh);
+            }
+        }
+    }
+    setTokenCb(cb) {
+        this.tokenCb = cb;
+    }
+    hasTokens() {
+        return this.token != undefined;
+    }
+    getTokens() {
+        return { token: this.token, refresh: this.refreshToken };
+    }
+    isTokenValid() {
+        if (!this.tokenExp) {
+            return false;
+        }
+        let now = new Date();
+        // Add one minute to now. This will make it so the token "expires" sooner than it really
+        // does, but allow a more clear indication that it is time to refresh.
+        now.setTime(now.getTime() + 1000 * 60);
+        return now < this.tokenExp;
+    }
+    getMetadata() {
+        return {
+            'x-actor-id': this.actorId,
+            ...(this.token && { 'authorization': `Bearer ${this.token}` })
+        };
+    }
+    async issue(req, f) {
+        let md = this.getMetadata();
+        let response = f.bind(this.inner)(req, {
+            meta: md,
+        });
+        // Rejects if it failed.
+        await response.status;
+        let data = await response.response;
+        return data;
+    }
+}
+export class ParanetListener {
+    constructor(client) {
+        this.shouldAutoReconnect = true;
+        this.client = client;
+    }
+    onmessage(f) {
+        this.msg = f;
+        return this;
+    }
+    onstart(f) {
+        this.start = f;
+        return this;
+    }
+    onerror(f) {
+        this.error = f;
+        return this;
+    }
+    ondisconnect(f) {
+        this.disconnected = f;
+        return this;
+    }
+    onreconnect(f) {
+        this.reconnected = f;
+        return this;
+    }
+    autoReconnect(v) {
+        this.shouldAutoReconnect = v;
+        return this;
+    }
+    connect() {
+        this.makeDecoratedStream(false);
+    }
+    disconnect() {
+        if (this.streamState) {
+            this.streamState.abort.abort("disconnect called.");
+            this.streamState = undefined;
+        }
+    }
+    makeDecoratedStream(isReconnect, timeout = 100) {
+        if (this.streamState) {
+            this.disconnect();
+        }
+        // Set it up as a new one when we create a new stream.
+        let abort = new AbortController();
+        let { method, body } = this.getRequest();
+        let stream = method.bind(this.client.inner)(body, {
+            meta: this.client.getMetadata(),
+            abort: abort.signal
+        });
+        this.streamState = { stream, abort };
+        // Wait for the headers, indicating success.
+        // Note: This doesn't seem to work on firefox for some reason.
+        // Seems to be working fine in chrome though.
+        stream.headers.then((_headers) => {
+            this.start?.(this.client);
+            if (isReconnect) {
+                this.reconnected?.();
+            }
+        }).catch((err) => {
+            // We need this catch here because of retry looping.
+            // We don't need to call this.error on this because it will come through on the onError still.
+        });
+        // Handle the message stream finally.
+        stream.responses.onMessage((msg) => {
+            let unwrapped = this.getRes(msg);
+            if (unwrapped) {
+                this.msg?.(unwrapped, this.client);
+            }
+        });
+        stream.responses.onError(async (err) => {
+            // Check if we aborted to know if we should retry or not.
+            this.disconnected?.();
+            if (!abort.signal.aborted) {
+                if (err.name == "RpcError") {
+                    let rpcErr = err;
+                    if (rpcErr.code == "UNAUTHENTICATED") {
+                        try {
+                            await this.client.refreshAuth();
+                        }
+                        catch (e) {
+                            this.error?.(err.message, true);
+                            abort.abort("Unauthenticated");
+                            // Exit early in this case.
+                            return;
+                        }
+                    }
+                }
+                this.error?.(err.message, false);
+                if (this.shouldAutoReconnect) {
+                    // Increase timeout, saturated at 10000ms.
+                    timeout = 2 * timeout + 1;
+                    if (timeout > 10000)
+                        timeout = 10000;
+                    setTimeout(() => this.makeDecoratedStream(true, timeout), timeout);
+                }
+            }
+        });
+        // Semantically, this should never happen for a paranet connection, however, it might
+        // at some point in the future, so we should handle this case appropriately.
+        stream.responses.onComplete(() => {
+            this.disconnected?.();
+        });
+    }
+}
+export class PncpListener extends ParanetListener {
+    constructor(client) {
+        super(client);
+    }
+    getRequest() {
+        return {
+            method: BrokerClient.prototype.pncpCallbackStream,
+            body: {
+                disableSkillForwarding: false,
+            }
+        };
+    }
+    getRes(t) {
+        if (t.body.oneofKind == undefined)
+            return null;
+        return t;
+    }
+}
+export class ParanetObserverListener extends ParanetListener {
+    constructor(client, init) {
+        super(client);
+        this.init = init;
+    }
+    getRequest() {
+        return {
+            method: BrokerClient.prototype.createObserverStream,
+            body: this.init,
+        };
+    }
+    getRes(t) {
+        if (t.body)
+            return t.body;
+        return null;
+    }
+}
+export class BaseClient {
+    constructor(init) {
+        this.endpoint = cleanUrl(init.endpoint);
+        this.actorId = init.actorId;
+    }
+    getEndpoint() {
+        return this.endpoint;
+    }
+    // Logs in this client and stores the token on the client.
+    async login(secret) {
+        let id = this.actorId.split('@')[0];
+        console.log(secret);
+        let response = await this.postJson("login", {
+            id,
+            ...secret,
+        });
+        this.setTokens(response.access_token, response.refresh_token);
+        return response;
+    }
+    async refreshAuth() {
+        let tokens = await this.postJson("token/refresh", {
+            token: this.token,
+            refresh_token: this.refreshToken,
+        });
+        this.setTokens(tokens.access_token, tokens.refresh_token);
+        return tokens;
+    }
+    logout() {
+        this.setTokens();
+    }
+    setTokens(token, refresh) {
+        this.token = token;
+        this.refreshToken = refresh;
+        if (token && refresh) {
+            let decoded = jwtDecode(token);
+            this.tokenExp = decoded.exp ? new Date(decoded.exp * 1000) : undefined;
+            if (this.tokenCb) {
+                this.tokenCb(token, refresh);
+            }
+        }
+    }
+    setTokenCb(cb) {
+        this.tokenCb = cb;
+    }
+    hasTokens() {
+        return this.token != undefined;
+    }
+    getTokens() {
+        return { token: this.token, refresh: this.refreshToken };
+    }
+    isTokenValid() {
+        if (!this.tokenExp) {
+            return false;
+        }
+        let now = new Date();
+        // Add one minute to now. This will make it so the token "expires" sooner than it really
+        // does, but allow a more clear indication that it is time to refresh.
+        now.setTime(now.getTime() + 1000 * 60);
+        return now < this.tokenExp;
+    }
+    async postJson(path, body) {
+        let response = await this.post_(path, JSON.stringify(body), { "content-type": "application/json" });
+        return await response.json();
+    }
+    async post_(path, body, headers) {
+        let response = await this.fetch(path, "POST", body, headers);
+        return response;
+    }
+    async get(path) {
+        let response = await this.fetch(path, "GET");
+        return await response.json();
+    }
+    async fetch(path, method, body, headers) {
+        let url = `${this.endpoint}/${path}`;
+        const mkFetch = () => fetch(url, {
+            method,
+            body,
+            headers: {
+                ...(headers || {}),
+                ...this.getHeaders(),
+            },
+        });
+        let response = await mkFetch();
+        if (response.status == 401) {
+            await this.refreshAuth();
+            response = await mkFetch();
+        }
+        if (response.status != 200) {
+            let text = await response.text();
+            throw new Error(`Failed to read from endpoint "${url}" (${response.status}): ${text} `);
+        }
+        return response;
+    }
+    getHeaders() {
+        return {
+            "X-ACTOR-ID": this.actorId,
+            ...(this.token && { Authorization: `Bearer ${this.token}` }),
+        };
+    }
+}
+export class ParanetServiceClient extends BaseClient {
+    constructor(init) {
+        super(init);
+    }
+    serviceEndpoint() {
+        return this.endpoint;
+    }
+    // TODO fill in a specific type.
+    // TODO: At a higher level than this we need a schema manager which properly parses
+    // schemas and caches them.
+    async schemaFetch(path) {
+        return await this.get(`schema/${path}`);
+    }
+    async documentFetch({ name, id }) {
+        if (name) {
+            return await this.fetch(`document/fetch/name/${name}`, "GET");
+        }
+        if (id) {
+            return await this.fetch(`document/fetch/id/${id}`, "GET");
+        }
+        throw new Error("Must provide either a name or id to fetch a document.");
+    }
+    async documentUpload(data, args) {
+        const formData = new FormData();
+        formData.append("file", data);
+        let response = null;
+        if (args?.name) {
+            const url = `document/upload/name/${args.name}`;
+            response = await this.post_(url, formData);
+        }
+        else if (args?.id) {
+            const url = `document/upload/id/${args.id}`;
+            response = await this.post_(url, formData);
+        }
+        else {
+            response = await this.post_("document/upload", formData);
+        }
+        return await response.json();
+    }
+    async graphql(query, inputs) {
+        let response = await this.postJson("graphql", {
+            query,
+            variables: inputs,
+        });
+        return response;
+    }
+}
+export class SysClient extends BaseClient {
+    constructor(init) {
+        super(init);
+    }
+    async nodeInfo() {
+        return await this.get('node-info');
+    }
+}
+// Some util functions.
+function cleanUrl(url) {
+    if (url.endsWith("/")) {
+        url = url.slice(0, url.length - 1);
+    }
+    return url;
+}

package/dist/graphql.d.ts

@@ -0,0 +1,8 @@
+import { PncpMessageObject, PncpRequestObject, PncpPacketObject } from "./pncp";
+import * as schema from "./schema/paranet";
+import { ConversationId } from "./proto/identifiers";
+export declare function gqlSimplifyPncpPacket(req: schema.PncpPacket): PncpPacketObject;
+export declare function gqlSimplifyPncpRequest(req: schema.PncpRequest): PncpRequestObject;
+export declare function gqlSimplifyPncpMessage(req: schema.PncpMessage): PncpMessageObject;
+export declare function splitConversationId(convId: string): ConversationId;
+//# sourceMappingURL=graphql.d.ts.map

package/dist/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACjG,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAA0B,MAAM,qBAAqB,CAAC;AAE7E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,gBAAgB,CAK9E;AAGD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,GAAG,iBAAiB,CAejF;AAUD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,GAAG,iBAAiB,CAejF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAWlE"}