@skipruntime/helpers 0.0.1

package/dist/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class UnknownCollectionError extends Error {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;CAAG"}

package/dist/errors.js

@@ -0,0 +1,3 @@
+export class UnknownCollectionError extends Error {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;CAAG"}

package/dist/external.d.ts

@@ -0,0 +1,43 @@
+import type { Entry, ExternalService, TJSON } from "@skipruntime/api";
+export interface ExternalResource {
+    open(params: Record<string, string | number>, callbacks: {
+        update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+        error: (error: TJSON) => void;
+        loading: () => void;
+    }, reactiveAuth?: Uint8Array): void;
+    close(params: Record<string, string | number>, reactiveAuth?: Uint8Array): void;
+}
+export declare class GenericExternalService implements ExternalService {
+    private resources;
+    constructor(resources: Record<string, ExternalResource>);
+    subscribe(resourceName: string, params: Record<string, string | number>, callbacks: {
+        update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+        error: (error: TJSON) => void;
+        loading: () => void;
+    }, reactiveAuth?: Uint8Array): void;
+    unsubscribe(resourceName: string, params: Record<string, string>, reactiveAuth?: Uint8Array): void;
+    shutdown(): void;
+}
+export declare class TimerResource implements ExternalResource {
+    private intervals;
+    open(params: Record<string, string | number>, callbacks: {
+        update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+        error: (error: TJSON) => void;
+        loading: () => void;
+    }, reactiveAuth?: Uint8Array): void;
+    close(params: Record<string, string | number>, reactiveAuth?: Uint8Array): void;
+}
+export declare class Polled<S extends TJSON, K extends TJSON, V extends TJSON> implements ExternalResource {
+    private url;
+    private duration;
+    private conv;
+    private intervals;
+    constructor(url: string, duration: number, conv: (data: S) => Entry<K, V>[]);
+    open(params: Record<string, string | number>, callbacks: {
+        update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+        error: (error: TJSON) => void;
+        loading: () => void;
+    }, reactiveAuth?: Uint8Array): void;
+    close(params: Record<string, string | number>, reactiveAuth?: Uint8Array): void;
+}
+//# sourceMappingURL=external.d.ts.map

package/dist/external.d.ts.map

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

package/dist/external.js

@@ -0,0 +1,100 @@
+import { fetchJSON } from "./rest.js";
+export class GenericExternalService {
+    constructor(resources) {
+        this.resources = resources;
+    }
+    subscribe(resourceName, params, callbacks, reactiveAuth) {
+        const resource = this.resources[resourceName];
+        if (!resource) {
+            throw new Error(`Unkonwn resource named '${resourceName}'`);
+        }
+        resource.open(params, callbacks, reactiveAuth);
+    }
+    unsubscribe(resourceName, params, reactiveAuth) {
+        const resource = this.resources[resourceName];
+        if (!resource) {
+            throw new Error(`Unkonwn resource named '${resourceName}'`);
+        }
+        resource.close(params, reactiveAuth);
+    }
+    shutdown() {
+        return;
+    }
+}
+export class TimerResource {
+    constructor() {
+        this.intervals = new Map();
+    }
+    open(params, callbacks, reactiveAuth) {
+        const time = new Date().getTime();
+        const values = [];
+        for (const name of Object.keys(params)) {
+            values.push([name, [time]]);
+        }
+        callbacks.update(values, true);
+        const id = toId(params, reactiveAuth);
+        const intervals = {};
+        for (const [name, duration] of Object.entries(params)) {
+            const ms = Number(duration);
+            if (ms > 0) {
+                intervals[name] = setInterval(() => {
+                    const newvalue = [name, [new Date().getTime()]];
+                    callbacks.update([newvalue], true);
+                }, ms);
+            }
+        }
+        this.intervals.set(id, intervals);
+    }
+    close(params, reactiveAuth) {
+        const intervals = this.intervals.get(toId(params, reactiveAuth));
+        if (intervals != null) {
+            for (const interval of Object.values(intervals)) {
+                clearInterval(interval);
+            }
+        }
+    }
+}
+export class Polled {
+    constructor(url, duration, conv) {
+        this.url = url;
+        this.duration = duration;
+        this.conv = conv;
+        this.intervals = new Map();
+    }
+    open(params, callbacks, reactiveAuth) {
+        this.close(params, reactiveAuth);
+        const querieParams = {};
+        for (const [key, value] of Object.entries(params)) {
+            querieParams[key] = value.toString();
+        }
+        const strParams = new URLSearchParams(querieParams).toString();
+        const url = `${this.url}?${strParams}`;
+        const call = () => {
+            callbacks.loading();
+            fetchJSON(url, "GET", {})
+                .then((r) => {
+                callbacks.update(this.conv(r[0]), true);
+            })
+                .catch((e) => {
+                callbacks.error(e instanceof Error ? e.message : JSON.stringify(e));
+                console.error(e);
+            });
+        };
+        call();
+        this.intervals.set(toId(params, reactiveAuth), setInterval(call, this.duration));
+    }
+    close(params, reactiveAuth) {
+        const interval = this.intervals.get(toId(params, reactiveAuth));
+        if (interval) {
+            clearInterval(interval);
+        }
+    }
+}
+function toId(params, reactiveAuth) {
+    const strparams = Object.entries(params)
+        .map(([key, value]) => `${key}:${value.toString()}`)
+        .sort();
+    const hex = reactiveAuth ? Buffer.from(reactiveAuth).toString("hex") : "";
+    return `[${strparams.join(",")}]${hex}`;
+}
+//# sourceMappingURL=external.js.map

package/dist/external.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { SkipExternalService } from "./remote.js";
+export { type ExternalResource, GenericExternalService, Polled, } from "./external.js";
+export { Sum, Min, Max, CountMapper, parseReactiveResponse, reactiveResponseHeader, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,WAAW,EACX,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SkipExternalService } from "./remote.js";
+export { GenericExternalService, Polled, } from "./external.js";
+export { Sum, Min, Max, CountMapper, parseReactiveResponse, reactiveResponseHeader, } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAEL,sBAAsB,EACtB,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,WAAW,EACX,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/remote.d.ts

@@ -0,0 +1,23 @@
+import type { Entry, ExternalService, ReactiveResponse, TJSON } from "@skipruntime/api";
+import { Protocol } from "@skipruntime/client";
+import { type Entrypoint } from "./rest.js";
+export declare class SkipExternalService implements ExternalService {
+    private url;
+    private auth;
+    private creds?;
+    private client?;
+    private resources;
+    constructor(url: string, auth: (resource: string, params: Record<string, string>, reactiveAuth: Uint8Array) => Promise<ReactiveResponse>, creds?: Protocol.Creds | undefined);
+    static fromEntrypoint(entrypoint: Entrypoint, auth: (resource: string, params: Record<string, string>, reactiveAuth: Uint8Array) => Promise<ReactiveResponse>, creds?: Protocol.Creds): SkipExternalService;
+    static direct(entrypoint: Entrypoint, creds?: Protocol.Creds): SkipExternalService;
+    subscribe(resource: string, params: Record<string, string>, callbacks: {
+        update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+        error: (error: TJSON) => void;
+        loading: () => void;
+    }, reactiveAuth?: Uint8Array): void;
+    unsubscribe(resource: string, params: Record<string, string>, reactiveAuth?: Uint8Array): void;
+    shutdown(): void;
+    private subscribe_;
+    private toId;
+}
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,EACN,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAW,QAAQ,EAAU,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAMvD,qBAAa,mBAAoB,YAAW,eAAe;IAKvD,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,KAAK,CAAC;IAVhB,OAAO,CAAC,MAAM,CAAC,CAAoC;IACnD,OAAO,CAAC,SAAS,CAA+B;gBAGtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,UAAU,KACrB,OAAO,CAAC,gBAAgB,CAAC,EACtB,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,YAAA;IAGhC,MAAM,CAAC,cAAc,CACnB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,UAAU,KACrB,OAAO,CAAC,gBAAgB,CAAC,EAC9B,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,GACrB,mBAAmB;IAOtB,MAAM,CAAC,MAAM,CACX,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,GACrB,mBAAmB;IA0BtB,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE;QACT,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QAClE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,EACD,YAAY,CAAC,EAAE,UAAU,GACxB,IAAI;IAoBP,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,CAAC,EAAE,UAAU;IAQ3B,QAAQ,IAAI,IAAI;YAUF,UAAU;IAsBxB,OAAO,CAAC,IAAI;CAYb"}

package/dist/remote.js

@@ -0,0 +1,83 @@
+import { parseReactiveResponse } from "./utils.js";
+import { connect, Protocol, Client } from "@skipruntime/client";
+import { fetchJSON } from "./rest.js";
+export class SkipExternalService {
+    constructor(url, auth, creds) {
+        this.url = url;
+        this.auth = auth;
+        this.creds = creds;
+        this.resources = new Map();
+    }
+    static fromEntrypoint(entrypoint, auth, creds) {
+        let url = `ws://${entrypoint.host}:${entrypoint.port.toString()}`;
+        if (entrypoint.secured)
+            url = `wss://${entrypoint.host}:${entrypoint.port.toString()}`;
+        return new SkipExternalService(url, auth, creds);
+    }
+    static direct(entrypoint, creds) {
+        let url = `http://${entrypoint.host}:${entrypoint.port.toString()}`;
+        if (entrypoint.secured)
+            url = `https://${entrypoint.host}:${entrypoint.port.toString()}`;
+        const auth = async (resource, params, reactiveAuth) => {
+            const qParams = new URLSearchParams(params).toString();
+            const header = {
+                "X-Reactive-Auth": Buffer.from(reactiveAuth).toString("base64"),
+            };
+            const [_data, headers] = await fetchJSON(`${url}/v1/${resource}?${qParams}`, "HEAD", header);
+            const reactiveResponse = parseReactiveResponse(headers);
+            if (!reactiveResponse)
+                throw new Error("Reactive response must be suplied.");
+            return reactiveResponse;
+        };
+        return new SkipExternalService(url, auth, creds);
+    }
+    subscribe(resource, params, callbacks, reactiveAuth) {
+        if (!this.client) {
+            if (!this.creds) {
+                this.client = Protocol.generateCredentials().then((creds) => {
+                    this.creds = creds;
+                    return connect(this.url, this.creds).then((c) => [c, creds]);
+                });
+            }
+            else {
+                this.client = connect(this.url, this.creds).then((c) => {
+                    return [c, this.creds];
+                });
+            }
+        }
+        this.subscribe_(resource, params, callbacks, reactiveAuth).catch((e) => {
+            console.error(e);
+        });
+    }
+    unsubscribe(resource, params, reactiveAuth) {
+        const closable = this.resources.get(this.toId(resource, params, reactiveAuth));
+        if (closable)
+            closable.close();
+    }
+    shutdown() {
+        if (this.client) {
+            this.client
+                .then((client) => {
+                client[0].close();
+            })
+                .catch((e) => console.error(e));
+        }
+    }
+    async subscribe_(resource, params, callbacks, reactiveAuth) {
+        const [client, creds] = await this.client;
+        const publicKey = new Uint8Array(await Protocol.exportKey(creds.publicKey));
+        const reactive = await this.auth(resource, params, publicKey);
+        // TODO Manage Status
+        const close = client.subscribe(reactive.collection, BigInt(reactive.watermark), callbacks.update);
+        this.resources.set(this.toId(resource, params, reactiveAuth), close);
+    }
+    toId(resource, params, reactiveAuth) {
+        const strparams = [];
+        for (const key of Object.keys(params).sort()) {
+            strparams.push(`${key}:${params[key]}`);
+        }
+        const hex = reactiveAuth ? Buffer.from(reactiveAuth).toString("hex") : "";
+        return `${resource}[${strparams.join(",")}]${hex}`;
+    }
+}
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

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

package/dist/rest.d.ts

@@ -0,0 +1,22 @@
+import type { TJSON, Entry, ReactiveResponse } from "@skipruntime/api";
+export type Entrypoint = {
+    host: string;
+    port: number;
+    secured?: boolean;
+};
+export declare function fetchJSON<V>(url: string, method?: "POST" | "GET" | "PUT" | "PATCH" | "HEAD" | "DELETE", headers?: Record<string, string>, data?: TJSON): Promise<[V | null, Headers]>;
+export declare class SkipRESTService {
+    private entrypoint;
+    constructor(entrypoint?: Entrypoint);
+    getAll<K extends TJSON, V extends TJSON>(resource: string, params: Record<string, string>, reactiveAuth?: Uint8Array | string): Promise<{
+        values: Entry<K, V>[];
+        reactive?: ReactiveResponse;
+    }>;
+    head(resource: string, params: Record<string, string>, reactiveAuth: Uint8Array | string): Promise<ReactiveResponse>;
+    getArray<V extends TJSON>(resource: string, params: Record<string, string>, key: string, reactiveAuth?: Uint8Array | string): Promise<V[]>;
+    put<V extends TJSON>(collection: string, key: string, value: V[]): Promise<void>;
+    patch<K extends TJSON, V extends TJSON>(collection: string, values: Entry<K, V>[]): Promise<void>;
+    deleteKey(collection: string, key: string): Promise<void>;
+    private header;
+}
+//# sourceMappingURL=rest.d.ts.map

package/dist/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../src/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGvE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAQF,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAgB,EACpE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,IAAI,CAAC,EAAE,KAAK,GACX,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAqB9B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAGzB,UAAU,GAAE,UAGX;IAKG,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,KAAK,EAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,GACjC,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAC;IA0B5D,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,UAAU,GAAG,MAAM,GAChC,OAAO,CAAC,gBAAgB,CAAC;IAgBtB,QAAQ,CAAC,CAAC,SAAS,KAAK,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,GACjC,OAAO,CAAC,CAAC,EAAE,CAAC;IAWT,GAAG,CAAC,CAAC,SAAS,KAAK,EACvB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EAAE,GACT,OAAO,CAAC,IAAI,CAAC;IASV,KAAK,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,KAAK,EAC1C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC;IAIV,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,OAAO,CAAC,MAAM;CAgBf"}

package/dist/rest.js

@@ -0,0 +1,97 @@
+import { parseReactiveResponse } from "./utils.js";
+function toHttp(entrypoint) {
+    if (entrypoint.secured)
+        return `https://${entrypoint.host}:${entrypoint.port}`;
+    return `http://${entrypoint.host}:${entrypoint.port}`;
+}
+export async function fetchJSON(url, method = "GET", headers = {}, data) {
+    const body = data ? JSON.stringify(data) : undefined;
+    const response = await fetch(url, {
+        method,
+        body,
+        headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            ...headers,
+        },
+        signal: AbortSignal.timeout(1000),
+    });
+    if (!response.ok) {
+        throw new Error(`${response.status}: ${response.statusText}`);
+    }
+    const responseText = await response.text();
+    const responseJSON = responseText.length > 0 && responseText != response.statusText
+        ? JSON.parse(responseText)
+        : null;
+    return [responseJSON, response.headers];
+}
+export class SkipRESTService {
+    constructor(entrypoint = {
+        host: "localhost",
+        port: 3587,
+    }) {
+        this.entrypoint = toHttp(entrypoint);
+    }
+    async getAll(resource, params, reactiveAuth) {
+        const qParams = new URLSearchParams(params).toString();
+        let header = {};
+        if (reactiveAuth) {
+            if (typeof reactiveAuth == "string") {
+                header = {
+                    "X-Reactive-Auth": reactiveAuth,
+                };
+            }
+            else {
+                header = {
+                    "X-Reactive-Auth": Buffer.from(reactiveAuth.buffer).toString("base64"),
+                };
+            }
+        }
+        const [optValues, headers] = await fetchJSON(`${this.entrypoint}/v1/${resource}?${qParams}`, "GET", header);
+        const reactive = parseReactiveResponse(headers);
+        const values = optValues ?? [];
+        return reactive ? { values, reactive } : { values };
+    }
+    async head(resource, params, reactiveAuth) {
+        const qParams = new URLSearchParams(params).toString();
+        const header = this.header(reactiveAuth);
+        const [_data, headers] = await fetchJSON(`${this.entrypoint}/v1/${resource}?${qParams}`, "HEAD", header);
+        const reactiveResponse = parseReactiveResponse(headers);
+        if (!reactiveResponse)
+            throw new Error("Reactive response must be suplied.");
+        else {
+            return reactiveResponse;
+        }
+    }
+    async getArray(resource, params, key, reactiveAuth) {
+        const qParams = new URLSearchParams(params).toString();
+        const header = this.header(reactiveAuth);
+        const [data, _headers] = await fetchJSON(`${this.entrypoint}/v1/${resource}/${key}?${qParams}`, "GET", header);
+        return data ?? [];
+    }
+    async put(collection, key, value) {
+        await fetchJSON(`${this.entrypoint}/v1/${collection}/${key}`, "PUT", {}, value);
+    }
+    async patch(collection, values) {
+        await fetchJSON(`${this.entrypoint}/v1/${collection}`, "PATCH", {}, values);
+    }
+    async deleteKey(collection, key) {
+        await fetchJSON(`${this.entrypoint}/v1/${collection}/${key}`, "DELETE", {});
+    }
+    header(reactiveAuth) {
+        if (reactiveAuth) {
+            if (typeof reactiveAuth == "string") {
+                return {
+                    "X-Reactive-Auth": reactiveAuth,
+                };
+            }
+            else {
+                return {
+                    "X-Reactive-Auth": Buffer.from(reactiveAuth.buffer).toString("base64"),
+                };
+            }
+        }
+        return {};
+    }
+}
+//# sourceMappingURL=rest.js.map

package/dist/rest.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+import type { Opt } from "@skip-wasm/std";
+import { ManyToOneMapper } from "@skipruntime/api";
+import type { Accumulator, NonEmptyIterator, ReactiveResponse, TJSON } from "@skipruntime/api";
+export declare class Sum implements Accumulator<number, number> {
+    default: number;
+    accumulate(acc: number, value: number): number;
+    dismiss(acc: number, value: number): Opt<number>;
+}
+export declare class Min implements Accumulator<number, number> {
+    default: null;
+    accumulate(acc: Opt<number>, value: number): number;
+    dismiss(acc: number, value: number): Opt<number>;
+}
+export declare class Max implements Accumulator<number, number> {
+    default: null;
+    accumulate(acc: Opt<number>, value: number): number;
+    dismiss(acc: number, value: number): Opt<number>;
+}
+export declare class CountMapper<K extends TJSON, V extends TJSON> extends ManyToOneMapper<K, V, number> {
+    mapValues(values: NonEmptyIterator<V>): number;
+}
+export declare function parseReactiveResponse(header: Headers | string): ReactiveResponse | undefined;
+export declare function reactiveResponseHeader(reactiveResponse: ReactiveResponse): [string, string];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,EACN,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,GAAI,YAAW,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IACrD,OAAO,SAAK;IAEZ,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI9C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;CAGjD;AAED,qBAAa,GAAI,YAAW,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IACrD,OAAO,OAAQ;IAEf,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAInD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;CAGjD;AAED,qBAAa,GAAI,YAAW,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IACrD,OAAO,OAAQ;IAEf,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAInD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;CAGjD;AAED,qBAAa,WAAW,CACtB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,KAAK,CACf,SAAQ,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM;CAG/C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,GAAG,MAAM,GACvB,gBAAgB,GAAG,SAAS,CAU9B;AAED,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,gBAAgB,GACjC,CAAC,MAAM,EAAE,MAAM,CAAC,CAOlB"}

package/dist/utils.js

@@ -0,0 +1,58 @@
+import { ManyToOneMapper } from "@skipruntime/api";
+export class Sum {
+    constructor() {
+        this.default = 0;
+    }
+    accumulate(acc, value) {
+        return acc + value;
+    }
+    dismiss(acc, value) {
+        return acc - value;
+    }
+}
+export class Min {
+    constructor() {
+        this.default = null;
+    }
+    accumulate(acc, value) {
+        return acc === null ? value : Math.min(acc, value);
+    }
+    dismiss(acc, value) {
+        return value > acc ? acc : null;
+    }
+}
+export class Max {
+    constructor() {
+        this.default = null;
+    }
+    accumulate(acc, value) {
+        return acc === null ? value : Math.max(acc, value);
+    }
+    dismiss(acc, value) {
+        return value < acc ? acc : null;
+    }
+}
+export class CountMapper extends ManyToOneMapper {
+    mapValues(values) {
+        return values.toArray().length;
+    }
+}
+export function parseReactiveResponse(header) {
+    const strReactiveResponse = typeof header == "string"
+        ? header
+        : header.get("Skip-Reactive-Response-Token");
+    if (!strReactiveResponse)
+        return undefined;
+    return JSON.parse(strReactiveResponse, (key, value) => {
+        if (key == "watermark")
+            return BigInt(value);
+        return value;
+    });
+}
+export function reactiveResponseHeader(reactiveResponse) {
+    return [
+        "Skip-Reactive-Response-Token",
+        JSON.stringify(reactiveResponse, (_key, value) => typeof value === "bigint" ? value.toString() : value),
+    ];
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAQnD,MAAM,OAAO,GAAG;IAAhB;QACE,YAAO,GAAG,CAAC,CAAC;IASd,CAAC;IAPC,UAAU,CAAC,GAAW,EAAE,KAAa;QACnC,OAAO,GAAG,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,OAAO,GAAG,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IAAhB;QACE,YAAO,GAAG,IAAI,CAAC;IASjB,CAAC;IAPC,UAAU,CAAC,GAAgB,EAAE,KAAa;QACxC,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,OAAO,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IAAhB;QACE,YAAO,GAAG,IAAI,CAAC;IASjB,CAAC;IAPC,UAAU,CAAC,GAAgB,EAAE,KAAa;QACxC,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,OAAO,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,WAGX,SAAQ,eAA6B;IACrC,SAAS,CAAC,MAA2B;QACnC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAwB;IAExB,MAAM,mBAAmB,GACvB,OAAO,MAAM,IAAI,QAAQ;QACvB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IACjD,IAAI,CAAC,mBAAmB;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;QACpE,IAAI,GAAG,IAAI,WAAW;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC,CAAqB,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,gBAAkC;IAElC,OAAO;QACL,8BAA8B;QAC9B,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE,CAChE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CACrD;KACF,CAAC;AACJ,CAAC"}

package/eslint.config.js

@@ -0,0 +1,3 @@
+import config from "@skiplabs/eslint-config";
+
+export default [...config];

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@skipruntime/helpers",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./errors.js": "./dist/errors.js",
+    "./rest.js": "./dist/rest.js",
+    "./external.js": "./dist/external.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "eslint"
+  },
+  "author": "SkipLabs",
+  "license": "MIT",
+  "description": "",
+  "engines": {
+    "node": ">=22.6.0 <23.0.0"
+  },
+  "dependencies": {
+    "express": "^4.21.0",
+    "@skipruntime/client": "^0.0.1",
+    "@skipruntime/api": "^0.0.1"
+  }
+}

package/src/errors.ts

@@ -0,0 +1 @@
+export class UnknownCollectionError extends Error {}

package/src/external.ts

@@ -0,0 +1,174 @@
+import type { Entry, ExternalService, TJSON } from "@skipruntime/api";
+import { fetchJSON } from "./rest.js";
+
+export interface ExternalResource {
+  open(
+    params: Record<string, string | number>,
+    callbacks: {
+      update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+      error: (error: TJSON) => void;
+      loading: () => void;
+    },
+    reactiveAuth?: Uint8Array,
+  ): void;
+
+  close(
+    params: Record<string, string | number>,
+    reactiveAuth?: Uint8Array,
+  ): void;
+}
+
+export class GenericExternalService implements ExternalService {
+  constructor(private resources: Record<string, ExternalResource>) {}
+
+  subscribe(
+    resourceName: string,
+    params: Record<string, string | number>,
+    callbacks: {
+      update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+      error: (error: TJSON) => void;
+      loading: () => void;
+    },
+    reactiveAuth?: Uint8Array,
+  ): void {
+    const resource = this.resources[resourceName] as
+      | ExternalResource
+      | undefined;
+    if (!resource) {
+      throw new Error(`Unkonwn resource named '${resourceName}'`);
+    }
+    resource.open(params, callbacks, reactiveAuth);
+  }
+
+  unsubscribe(
+    resourceName: string,
+    params: Record<string, string>,
+    reactiveAuth?: Uint8Array,
+  ) {
+    const resource = this.resources[resourceName] as
+      | ExternalResource
+      | undefined;
+    if (!resource) {
+      throw new Error(`Unkonwn resource named '${resourceName}'`);
+    }
+    resource.close(params, reactiveAuth);
+  }
+
+  shutdown(): void {
+    return;
+  }
+}
+
+type Timeout = ReturnType<typeof setInterval>;
+
+export class TimerResource implements ExternalResource {
+  private intervals = new Map<string, Record<string, Timeout>>();
+
+  open(
+    params: Record<string, string | number>,
+    callbacks: {
+      update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+      error: (error: TJSON) => void;
+      loading: () => void;
+    },
+    reactiveAuth?: Uint8Array,
+  ) {
+    const time = new Date().getTime();
+    const values: Entry<string, number>[] = [];
+    for (const name of Object.keys(params)) {
+      values.push([name, [time]]);
+    }
+    callbacks.update(values, true);
+    const id = toId(params, reactiveAuth);
+    const intervals: Record<string, Timeout> = {};
+    for (const [name, duration] of Object.entries(params)) {
+      const ms = Number(duration);
+      if (ms > 0) {
+        intervals[name] = setInterval(() => {
+          const newvalue: Entry<TJSON, TJSON> = [name, [new Date().getTime()]];
+          callbacks.update([newvalue], true);
+        }, ms);
+      }
+    }
+    this.intervals.set(id, intervals);
+  }
+
+  close(
+    params: Record<string, string | number>,
+    reactiveAuth?: Uint8Array,
+  ): void {
+    const intervals = this.intervals.get(toId(params, reactiveAuth));
+    if (intervals != null) {
+      for (const interval of Object.values(intervals)) {
+        clearInterval(interval);
+      }
+    }
+  }
+}
+
+export class Polled<S extends TJSON, K extends TJSON, V extends TJSON>
+  implements ExternalResource
+{
+  private intervals = new Map<string, Timeout>();
+
+  constructor(
+    private url: string,
+    private duration: number,
+    private conv: (data: S) => Entry<K, V>[],
+  ) {}
+
+  open(
+    params: Record<string, string | number>,
+    callbacks: {
+      update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+      error: (error: TJSON) => void;
+      loading: () => void;
+    },
+    reactiveAuth?: Uint8Array,
+  ): void {
+    this.close(params, reactiveAuth);
+    const querieParams: Record<string, string> = {};
+    for (const [key, value] of Object.entries(params)) {
+      querieParams[key] = value.toString();
+    }
+    const strParams = new URLSearchParams(querieParams).toString();
+    const url = `${this.url}?${strParams}`;
+    const call = () => {
+      callbacks.loading();
+      fetchJSON(url, "GET", {})
+        .then((r) => {
+          callbacks.update(this.conv(r[0] as S), true);
+        })
+        .catch((e: unknown) => {
+          callbacks.error(e instanceof Error ? e.message : JSON.stringify(e));
+          console.error(e);
+        });
+    };
+    call();
+    this.intervals.set(
+      toId(params, reactiveAuth),
+      setInterval(call, this.duration),
+    );
+  }
+
+  close(
+    params: Record<string, string | number>,
+    reactiveAuth?: Uint8Array,
+  ): void {
+    const interval = this.intervals.get(toId(params, reactiveAuth));
+    if (interval) {
+      clearInterval(interval);
+    }
+  }
+}
+
+function toId(
+  params: Record<string, string | number>,
+  reactiveAuth?: Uint8Array,
+): string {
+  const strparams = Object.entries(params)
+    .map(([key, value]) => `${key}:${value.toString()}`)
+    .sort();
+  const hex = reactiveAuth ? Buffer.from(reactiveAuth).toString("hex") : "";
+  return `[${strparams.join(",")}]${hex}`;
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+export { SkipExternalService } from "./remote.js";
+export {
+  type ExternalResource,
+  GenericExternalService,
+  Polled,
+} from "./external.js";
+export {
+  Sum,
+  Min,
+  Max,
+  CountMapper,
+  parseReactiveResponse,
+  reactiveResponseHeader,
+} from "./utils.js";

package/src/remote.ts

@@ -0,0 +1,158 @@
+import type {
+  Entry,
+  ExternalService,
+  ReactiveResponse,
+  TJSON,
+} from "@skipruntime/api";
+import { parseReactiveResponse } from "./utils.js";
+
+import { connect, Protocol, Client } from "@skipruntime/client";
+import { fetchJSON, type Entrypoint } from "./rest.js";
+
+interface Closable {
+  close(): void;
+}
+
+export class SkipExternalService implements ExternalService {
+  private client?: Promise<[Client, Protocol.Creds]>;
+  private resources = new Map<string, Closable>();
+
+  constructor(
+    private url: string,
+    private auth: (
+      resource: string,
+      params: Record<string, string>,
+      reactiveAuth: Uint8Array,
+    ) => Promise<ReactiveResponse>,
+    private creds?: Protocol.Creds,
+  ) {}
+
+  static fromEntrypoint(
+    entrypoint: Entrypoint,
+    auth: (
+      resource: string,
+      params: Record<string, string>,
+      reactiveAuth: Uint8Array,
+    ) => Promise<ReactiveResponse>,
+    creds?: Protocol.Creds,
+  ): SkipExternalService {
+    let url = `ws://${entrypoint.host}:${entrypoint.port.toString()}`;
+    if (entrypoint.secured)
+      url = `wss://${entrypoint.host}:${entrypoint.port.toString()}`;
+    return new SkipExternalService(url, auth, creds);
+  }
+
+  static direct(
+    entrypoint: Entrypoint,
+    creds?: Protocol.Creds,
+  ): SkipExternalService {
+    let url = `http://${entrypoint.host}:${entrypoint.port.toString()}`;
+    if (entrypoint.secured)
+      url = `https://${entrypoint.host}:${entrypoint.port.toString()}`;
+    const auth = async (
+      resource: string,
+      params: Record<string, string>,
+      reactiveAuth: Uint8Array,
+    ) => {
+      const qParams = new URLSearchParams(params).toString();
+      const header = {
+        "X-Reactive-Auth": Buffer.from(reactiveAuth).toString("base64"),
+      };
+      const [_data, headers] = await fetchJSON(
+        `${url}/v1/${resource}?${qParams}`,
+        "HEAD",
+        header,
+      );
+      const reactiveResponse = parseReactiveResponse(headers);
+      if (!reactiveResponse)
+        throw new Error("Reactive response must be suplied.");
+      return reactiveResponse;
+    };
+    return new SkipExternalService(url, auth, creds);
+  }
+
+  subscribe(
+    resource: string,
+    params: Record<string, string>,
+    callbacks: {
+      update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+      error: (error: TJSON) => void;
+      loading: () => void;
+    },
+    reactiveAuth?: Uint8Array,
+  ): void {
+    if (!this.client) {
+      if (!this.creds) {
+        this.client = Protocol.generateCredentials().then((creds) => {
+          this.creds = creds;
+          return connect(this.url, this.creds).then((c) => [c, creds]);
+        });
+      } else {
+        this.client = connect(this.url, this.creds).then((c) => {
+          return [c, this.creds!];
+        });
+      }
+    }
+    this.subscribe_(resource, params, callbacks, reactiveAuth).catch(
+      (e: unknown) => {
+        console.error(e);
+      },
+    );
+  }
+
+  unsubscribe(
+    resource: string,
+    params: Record<string, string>,
+    reactiveAuth?: Uint8Array,
+  ) {
+    const closable = this.resources.get(
+      this.toId(resource, params, reactiveAuth),
+    );
+    if (closable) closable.close();
+  }
+
+  shutdown(): void {
+    if (this.client) {
+      this.client
+        .then((client) => {
+          client[0].close();
+        })
+        .catch((e: unknown) => console.error(e));
+    }
+  }
+
+  private async subscribe_(
+    resource: string,
+    params: Record<string, string>,
+    callbacks: {
+      update: (updates: Entry<TJSON, TJSON>[], isInit: boolean) => void;
+      error: (error: TJSON) => void;
+      loading: () => void;
+    },
+    reactiveAuth?: Uint8Array,
+  ): Promise<void> {
+    const [client, creds] = await this.client!;
+    const publicKey = new Uint8Array(await Protocol.exportKey(creds.publicKey));
+    const reactive = await this.auth(resource, params, publicKey);
+    // TODO Manage Status
+    const close = client.subscribe(
+      reactive.collection,
+      BigInt(reactive.watermark),
+      callbacks.update,
+    );
+    this.resources.set(this.toId(resource, params, reactiveAuth), close);
+  }
+
+  private toId(
+    resource: string,
+    params: Record<string, string>,
+    reactiveAuth?: Uint8Array,
+  ): string {
+    const strparams: string[] = [];
+    for (const key of Object.keys(params).sort()) {
+      strparams.push(`${key}:${params[key]}`);
+    }
+    const hex = reactiveAuth ? Buffer.from(reactiveAuth).toString("hex") : "";
+    return `${resource}[${strparams.join(",")}]${hex}`;
+  }
+}

package/src/rest.ts

@@ -0,0 +1,162 @@
+import type { TJSON, Entry, ReactiveResponse } from "@skipruntime/api";
+import { parseReactiveResponse } from "./utils.js";
+
+export type Entrypoint = {
+  host: string;
+  port: number;
+  secured?: boolean;
+};
+
+function toHttp(entrypoint: Entrypoint) {
+  if (entrypoint.secured)
+    return `https://${entrypoint.host}:${entrypoint.port}`;
+  return `http://${entrypoint.host}:${entrypoint.port}`;
+}
+
+export async function fetchJSON<V>(
+  url: string,
+  method: "POST" | "GET" | "PUT" | "PATCH" | "HEAD" | "DELETE" = "GET",
+  headers: Record<string, string> = {},
+  data?: TJSON,
+): Promise<[V | null, Headers]> {
+  const body = data ? JSON.stringify(data) : undefined;
+  const response = await fetch(url, {
+    method,
+    body,
+    headers: {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      ...headers,
+    },
+    signal: AbortSignal.timeout(1000),
+  });
+  if (!response.ok) {
+    throw new Error(`${response.status}: ${response.statusText}`);
+  }
+  const responseText = await response.text();
+  const responseJSON =
+    responseText.length > 0 && responseText != response.statusText
+      ? JSON.parse(responseText)
+      : null;
+  return [responseJSON, response.headers];
+}
+
+export class SkipRESTService {
+  private entrypoint: string;
+
+  constructor(
+    entrypoint: Entrypoint = {
+      host: "localhost",
+      port: 3587,
+    },
+  ) {
+    this.entrypoint = toHttp(entrypoint);
+  }
+
+  async getAll<K extends TJSON, V extends TJSON>(
+    resource: string,
+    params: Record<string, string>,
+    reactiveAuth?: Uint8Array | string,
+  ): Promise<{ values: Entry<K, V>[]; reactive?: ReactiveResponse }> {
+    const qParams = new URLSearchParams(params).toString();
+    let header = {};
+    if (reactiveAuth) {
+      if (typeof reactiveAuth == "string") {
+        header = {
+          "X-Reactive-Auth": reactiveAuth,
+        };
+      } else {
+        header = {
+          "X-Reactive-Auth": Buffer.from(reactiveAuth.buffer).toString(
+            "base64",
+          ),
+        };
+      }
+    }
+    const [optValues, headers] = await fetchJSON<Entry<K, V>[]>(
+      `${this.entrypoint}/v1/${resource}?${qParams}`,
+      "GET",
+      header,
+    );
+    const reactive = parseReactiveResponse(headers);
+    const values = optValues ?? [];
+    return reactive ? { values, reactive } : { values };
+  }
+
+  async head(
+    resource: string,
+    params: Record<string, string>,
+    reactiveAuth: Uint8Array | string,
+  ): Promise<ReactiveResponse> {
+    const qParams = new URLSearchParams(params).toString();
+    const header = this.header(reactiveAuth);
+    const [_data, headers] = await fetchJSON(
+      `${this.entrypoint}/v1/${resource}?${qParams}`,
+      "HEAD",
+      header,
+    );
+    const reactiveResponse = parseReactiveResponse(headers);
+    if (!reactiveResponse)
+      throw new Error("Reactive response must be suplied.");
+    else {
+      return reactiveResponse;
+    }
+  }
+
+  async getArray<V extends TJSON>(
+    resource: string,
+    params: Record<string, string>,
+    key: string,
+    reactiveAuth?: Uint8Array | string,
+  ): Promise<V[]> {
+    const qParams = new URLSearchParams(params).toString();
+    const header = this.header(reactiveAuth);
+    const [data, _headers] = await fetchJSON<V[]>(
+      `${this.entrypoint}/v1/${resource}/${key}?${qParams}`,
+      "GET",
+      header,
+    );
+    return data ?? [];
+  }
+
+  async put<V extends TJSON>(
+    collection: string,
+    key: string,
+    value: V[],
+  ): Promise<void> {
+    await fetchJSON(
+      `${this.entrypoint}/v1/${collection}/${key}`,
+      "PUT",
+      {},
+      value,
+    );
+  }
+
+  async patch<K extends TJSON, V extends TJSON>(
+    collection: string,
+    values: Entry<K, V>[],
+  ): Promise<void> {
+    await fetchJSON(`${this.entrypoint}/v1/${collection}`, "PATCH", {}, values);
+  }
+
+  async deleteKey(collection: string, key: string): Promise<void> {
+    await fetchJSON(`${this.entrypoint}/v1/${collection}/${key}`, "DELETE", {});
+  }
+
+  private header(reactiveAuth?: Uint8Array | string): Record<string, string> {
+    if (reactiveAuth) {
+      if (typeof reactiveAuth == "string") {
+        return {
+          "X-Reactive-Auth": reactiveAuth,
+        };
+      } else {
+        return {
+          "X-Reactive-Auth": Buffer.from(reactiveAuth.buffer).toString(
+            "base64",
+          ),
+        };
+      }
+    }
+    return {};
+  }
+}

package/src/utils.ts

@@ -0,0 +1,78 @@
+import type { Opt } from "@skip-wasm/std";
+import { ManyToOneMapper } from "@skipruntime/api";
+import type {
+  Accumulator,
+  NonEmptyIterator,
+  ReactiveResponse,
+  TJSON,
+} from "@skipruntime/api";
+
+export class Sum implements Accumulator<number, number> {
+  default = 0;
+
+  accumulate(acc: number, value: number): number {
+    return acc + value;
+  }
+
+  dismiss(acc: number, value: number): Opt<number> {
+    return acc - value;
+  }
+}
+
+export class Min implements Accumulator<number, number> {
+  default = null;
+
+  accumulate(acc: Opt<number>, value: number): number {
+    return acc === null ? value : Math.min(acc, value);
+  }
+
+  dismiss(acc: number, value: number): Opt<number> {
+    return value > acc ? acc : null;
+  }
+}
+
+export class Max implements Accumulator<number, number> {
+  default = null;
+
+  accumulate(acc: Opt<number>, value: number): number {
+    return acc === null ? value : Math.max(acc, value);
+  }
+
+  dismiss(acc: number, value: number): Opt<number> {
+    return value < acc ? acc : null;
+  }
+}
+
+export class CountMapper<
+  K extends TJSON,
+  V extends TJSON,
+> extends ManyToOneMapper<K, V, number> {
+  mapValues(values: NonEmptyIterator<V>): number {
+    return values.toArray().length;
+  }
+}
+
+export function parseReactiveResponse(
+  header: Headers | string,
+): ReactiveResponse | undefined {
+  const strReactiveResponse =
+    typeof header == "string"
+      ? header
+      : header.get("Skip-Reactive-Response-Token");
+  if (!strReactiveResponse) return undefined;
+  return JSON.parse(strReactiveResponse, (key: string, value: string) => {
+    if (key == "watermark") return BigInt(value);
+    return value;
+  }) as ReactiveResponse;
+}
+
+export function reactiveResponseHeader(
+  reactiveResponse: ReactiveResponse,
+): [string, string] {
+  return [
+    "Skip-Reactive-Response-Token",
+    JSON.stringify(reactiveResponse, (_key: string, value: unknown) =>
+      typeof value === "bigint" ? value.toString() : value,
+    ),
+  ];
+}

package/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "@skiplabs/tsconfig"
+}