@towns-protocol/sdk 0.0.191

package/dist/unauthenticatedClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauthenticatedClient.d.ts","sourceRoot":"","sources":["../src/unauthenticatedClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAiB,MAAM,uBAAuB,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAgB,MAAM,QAAQ,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAMnD,qBAAa,qBAAqB;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IAEvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,qBAAqB,CAA6D;gBAGtF,SAAS,EAAE,eAAe,EAC1B,kBAAkB,CAAC,EAAE,MAAM,EAE3B,IAAI,GAAE,kBAGL;IAmBC,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IAiCxE;;QAEI;IACE,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,cAAc,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA0B9D,UAAU;YA6DV,aAAa;IA0B3B,OAAO,CAAC,QAAQ;CAInB"}

package/dist/unauthenticatedClient.js

@@ -0,0 +1,156 @@
+import debug from 'debug';
+import { check, dlog, dlogError } from '@towns-protocol/dlog';
+import { hasElements, isDefined } from './check';
+import { getMiniblocks } from './makeStreamRpcClient';
+import { unpackStream } from './sign';
+import { StreamStateView } from './streamStateView';
+import { streamIdAsString, streamIdAsBytes, userIdFromAddress, makeUserStreamId } from './id';
+const SCROLLBACK_MAX_COUNT = 20;
+const SCROLLBACK_MULTIPLIER = 4n;
+export class UnauthenticatedClient {
+    rpcClient;
+    logCall;
+    logEmitFromClient;
+    logError;
+    unpackEnvelopeOpts;
+    userId = 'unauthenticatedClientUser';
+    getScrollbackRequests = new Map();
+    constructor(rpcClient, logNamespaceFilter, 
+    // this client is used for viewing public streams, disable signature and hash validation to make it as fast as possible
+    opts = {
+        disableSignatureValidation: true,
+        disableHashValidation: true,
+    }) {
+        if (logNamespaceFilter) {
+            debug.enable(logNamespaceFilter);
+        }
+        this.rpcClient = rpcClient;
+        const shortId = 'unauthClientShortId';
+        this.logCall = dlog('csb:cl:call').extend(shortId);
+        this.logEmitFromClient = dlog('csb:cl:emit').extend(shortId);
+        this.logError = dlogError('csb:cl:error').extend(shortId);
+        this.unpackEnvelopeOpts = opts;
+        this.logCall('new UnauthenticatedClient');
+    }
+    async userWithAddressExists(address) {
+        return this.userExists(userIdFromAddress(address));
+    }
+    async userExists(userId) {
+        const userStreamId = makeUserStreamId(userId);
+        return this.streamExists(userStreamId);
+    }
+    async streamExists(streamId) {
+        this.logCall('streamExists?', streamId);
+        const response = await this.rpcClient.getStream({
+            streamId: streamIdAsBytes(streamId),
+            optional: true,
+        });
+        this.logCall('streamExists=', streamId, response.stream);
+        return response.stream !== undefined;
+    }
+    async getStream(streamId) {
+        try {
+            this.logCall('getStream', streamId);
+            const response = await this.rpcClient.getStream({ streamId: streamIdAsBytes(streamId) });
+            this.logCall('getStream', response.stream);
+            check(isDefined(response.stream) && hasElements(response.stream.miniblocks), 'got bad stream');
+            const { streamAndCookie, snapshot, prevSnapshotMiniblockNum } = await unpackStream(response.stream, this.unpackEnvelopeOpts);
+            const streamView = new StreamStateView(this.userId, streamIdAsString(streamId));
+            streamView.initialize(streamAndCookie.nextSyncCookie, streamAndCookie.events, snapshot, streamAndCookie.miniblocks, [], prevSnapshotMiniblockNum, undefined, [], undefined);
+            return streamView;
+        }
+        catch (err) {
+            this.logCall('getStream', streamId, 'ERROR', err);
+            throw err;
+        }
+    }
+    /**
+     * @deprecated please use scrollbackByMs()
+     **/
+    async scrollbackToDate(streamView, toDate) {
+        return this.scrollbackByMs(streamView, toDate);
+    }
+    async scrollbackByMs(streamView, ms) {
+        this.logCall('scrollbackToDate', { streamId: streamView.streamId, ms });
+        const firstEvent = streamView.timeline.at(0);
+        // skip scrollback if limit is already reached
+        if (firstEvent?.createdAtEpochMs && !this.isWithin(firstEvent?.createdAtEpochMs, ms)) {
+            return;
+        }
+        // scrollback to get events till max scrollback, toDate or till no events are left
+        for (let i = 0; i < SCROLLBACK_MAX_COUNT; i++) {
+            const result = await this.scrollback(streamView);
+            if (result.terminus) {
+                break;
+            }
+            const currentOldestEvent = result.firstEvent;
+            this.logCall('scrollbackToDate result', {
+                oldest: currentOldestEvent?.createdAtEpochMs,
+                ms,
+            });
+            if (currentOldestEvent) {
+                if (!this.isWithin(currentOldestEvent.createdAtEpochMs, ms)) {
+                    break;
+                }
+            }
+        }
+    }
+    async scrollback(streamView) {
+        const currentRequest = this.getScrollbackRequests.get(streamView.streamId);
+        if (currentRequest) {
+            return currentRequest;
+        }
+        const _scrollback = async () => {
+            check(isDefined(streamView.miniblockInfo), `stream not initialized: ${streamView.streamId}`);
+            if (streamView.miniblockInfo.terminusReached) {
+                this.logCall('scrollback', streamView.streamId, 'terminus reached');
+                return { terminus: true, firstEvent: streamView.timeline.at(0) };
+            }
+            check(streamView.miniblockInfo.min >= streamView.prevSnapshotMiniblockNum);
+            this.logCall('scrollback', {
+                streamId: streamView.streamId,
+                miniblockInfo: streamView.miniblockInfo,
+                prevSnapshotMiniblockNum: streamView.prevSnapshotMiniblockNum,
+            });
+            const toExclusive = streamView.miniblockInfo.min;
+            const fromInclusive = streamView.prevSnapshotMiniblockNum;
+            const span = toExclusive - fromInclusive;
+            let fromInclusiveNew = toExclusive - span * SCROLLBACK_MULTIPLIER;
+            fromInclusiveNew = fromInclusiveNew < 0n ? 0n : fromInclusiveNew;
+            const response = await this.getMiniblocks(streamView.streamId, fromInclusiveNew, toExclusive);
+            // a race may occur here: if the state view has been reinitialized during the scrollback
+            // request, we need to discard the new miniblocks.
+            if ((streamView.miniblockInfo?.min ?? -1n) === toExclusive) {
+                streamView.prependEvents(response.miniblocks, undefined, response.terminus, undefined, undefined);
+                return { terminus: response.terminus, firstEvent: streamView.timeline.at(0) };
+            }
+            return { terminus: false, firstEvent: streamView.timeline.at(0) };
+        };
+        try {
+            const request = _scrollback();
+            this.getScrollbackRequests.set(streamView.streamId, request);
+            return await request;
+        }
+        finally {
+            this.getScrollbackRequests.delete(streamView.streamId);
+        }
+    }
+    async getMiniblocks(streamId, fromInclusive, toExclusive) {
+        if (toExclusive === fromInclusive) {
+            return {
+                miniblocks: [],
+                terminus: toExclusive === 0n,
+            };
+        }
+        const { miniblocks, terminus } = await getMiniblocks(this.rpcClient, streamId, fromInclusive, toExclusive, this.unpackEnvelopeOpts);
+        return {
+            terminus: terminus,
+            miniblocks: miniblocks,
+        };
+    }
+    isWithin(number, time) {
+        const minEpochMs = Date.now() - time;
+        return number > minEpochMs;
+    }
+}
+//# sourceMappingURL=unauthenticatedClient.js.map

package/dist/unauthenticatedClient.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,28 @@
+import { Permission } from '@towns-protocol/web3';
+export declare function unsafeProp<K extends keyof any | undefined>(prop: K): boolean;
+export declare function safeSet<O extends Record<any, any>, K extends keyof O>(obj: O, prop: K, value: O[K]): void;
+export declare function promiseTry<T>(fn: () => T | Promise<T>): Promise<T>;
+export declare function hashString(string: string): string;
+export declare function usernameChecksum(username: string, streamId: string): string;
+/**
+ * IConnectError contains a subset of the properties in ConnectError
+ */
+export type IConnectError = {
+    code: number;
+};
+export declare function isIConnectError(obj: unknown): obj is {
+    code: number;
+};
+export declare class MockEntitlementsDelegate {
+    isEntitled(_spaceId: string | undefined, _channelId: string | undefined, _user: string, _permission: Permission): Promise<boolean>;
+}
+export declare function removeCommon(x: string[], y: string[]): string[];
+export declare function getEnvVar(key: string, defaultValue?: string): string;
+export declare function isMobileSafari(): boolean;
+export declare function isBaseUrlIncluded(baseUrls: string[], fullUrl: string): boolean;
+export declare const randomUrlSelector: (urls: string) => string;
+export declare function getTime<T>(fn: () => Promise<T>): Promise<{
+    result: Awaited<T>;
+    time: number;
+}>;
+//# 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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAIjD,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAE5E;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACjE,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GACZ,IAAI,CAMN;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAElE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAElE;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAErE;AAED,qBAAa,wBAAwB;IAC3B,UAAU,CACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,UAAU,GACxB,OAAO,CAAC,OAAO,CAAC;CAItB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAuB/D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAW,GAAG,MAAM,CAYxE;AAED,wBAAgB,cAAc,IAAI,OAAO,CAQxC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK9E;AAED,eAAO,MAAM,iBAAiB,SAAU,MAAM,WAS7C,CAAA;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;;;GAKpD"}

package/dist/utils.js

@@ -0,0 +1,99 @@
+import { keccak256 } from 'ethereum-cryptography/keccak';
+import { bin_toHexString, isTestEnv, isNodeEnv } from '@towns-protocol/dlog';
+import { isBrowser, isNode } from 'browser-or-node';
+export function unsafeProp(prop) {
+    return prop === '__proto__' || prop === 'prototype' || prop === 'constructor';
+}
+export function safeSet(obj, prop, value) {
+    if (unsafeProp(prop)) {
+        throw new Error('Trying to modify prototype or constructor');
+    }
+    obj[prop] = value;
+}
+export function promiseTry(fn) {
+    return Promise.resolve(fn());
+}
+export function hashString(string) {
+    const encoded = new TextEncoder().encode(string);
+    const buffer = keccak256(encoded);
+    return bin_toHexString(buffer);
+}
+export function usernameChecksum(username, streamId) {
+    return hashString(`${username.toLowerCase()}:${streamId}`);
+}
+export function isIConnectError(obj) {
+    return obj !== null && typeof obj === 'object' && 'code' in obj && typeof obj.code === 'number';
+}
+export class MockEntitlementsDelegate {
+    async isEntitled(_spaceId, _channelId, _user, _permission) {
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return true;
+    }
+}
+export function removeCommon(x, y) {
+    const result = [];
+    let i = 0;
+    let j = 0;
+    while (i < x.length && j < y.length) {
+        if (x[i] < y[j]) {
+            result.push(x[i]);
+            i++;
+        }
+        else if (x[i] > y[j]) {
+            j++;
+        }
+        else {
+            i++;
+            j++;
+        }
+    }
+    // Append remaining elements from x
+    if (i < x.length) {
+        result.push(...x.slice(i));
+    }
+    return result;
+}
+export function getEnvVar(key, defaultValue = '') {
+    if (isNode || isTestEnv()) {
+        return process.env[key] ?? defaultValue;
+    }
+    if (isBrowser) {
+        if (localStorage != undefined) {
+            return localStorage.getItem(key) ?? defaultValue;
+        }
+    }
+    return defaultValue;
+}
+export function isMobileSafari() {
+    if (isNodeEnv()) {
+        return false;
+    }
+    if (!navigator || !navigator.userAgent) {
+        return false;
+    }
+    return /iPad|iPhone|iPod/.test(navigator.userAgent);
+}
+export function isBaseUrlIncluded(baseUrls, fullUrl) {
+    const urlObj = new URL(fullUrl);
+    const fullUrlBase = `${urlObj.protocol}//${urlObj.host}`;
+    return baseUrls.some((baseUrl) => fullUrlBase === baseUrl.trim());
+}
+export const randomUrlSelector = (urls) => {
+    const u = urls.split(',');
+    if (u.length === 0) {
+        throw new Error('No urls for backend provided');
+    }
+    else if (u.length === 1) {
+        return u[0];
+    }
+    else {
+        return u[Math.floor(Math.random() * u.length)];
+    }
+};
+export async function getTime(fn) {
+    const start = performance.now();
+    const result = await fn();
+    const end = performance.now();
+    return { result, time: end - start };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+    "name": "@towns-protocol/sdk",
+    "version": "0.0.191",
+    "packageManager": "yarn@3.8.0",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "cb": "yarn clean && yarn build",
+        "clean": "rm -rf dist",
+        "dev": "my-node src/index.ts",
+        "lint": "yarn eslint --format unix ./src  --max-warnings=0",
+        "lint:fix": "yarn lint --fix",
+        "test:unit": "vitest run --config vitest.config.unit.ts",
+        "test:ci": "yarn test:ci:multi:ne",
+        "test:ci:multi:ent:legacy": "vitest run --config vitest.config.multi_legacy.ts",
+        "test:ci:multi:ent": "vitest run --config vitest.config.ts",
+        "test:ci:multi:ne": "vitest run --config vitest.config.multi_ne.ts",
+        "test:ci:with-entitlements": "yarn test:ci:multi:ent",
+        "test:watch": "vitest --watch",
+        "watch": "tsc --watch"
+    },
+    "dependencies": {
+        "@bufbuild/protobuf": "^2.2.2",
+        "@connectrpc/connect": "^2.0.0",
+        "@connectrpc/connect-node": "^2.0.0",
+        "@connectrpc/connect-web": "^2.0.0",
+        "@ethereumjs/util": "^8.0.1",
+        "@towns-protocol/dlog": "workspace:^",
+        "@towns-protocol/encryption": "workspace:^",
+        "@towns-protocol/generated": "workspace:^",
+        "@towns-protocol/proto": "workspace:^",
+        "@towns-protocol/web3": "workspace:^",
+        "browser-or-node": "^3.0.0",
+        "debug": "^4.3.4",
+        "dexie": "^4.0.7",
+        "ethereum-cryptography": "^1.2.0",
+        "ethers": "^5.7.2",
+        "lodash": "^4.17.21",
+        "nanoid": "^4.0.0",
+        "p-limit": "^6.1.0",
+        "vitest": "3.0.5"
+    },
+    "devDependencies": {
+        "@testing-library/react": "^14.2.1",
+        "@types/debug": "^4.1.8",
+        "@types/lodash": "^4.14.186",
+        "@types/node": "^20.5.0",
+        "@types/seedrandom": "^3.0.4",
+        "@typescript-eslint/eslint-plugin": "^6.10.0",
+        "@typescript-eslint/parser": "^7.14.1",
+        "eslint": "^8.53.0",
+        "eslint-import-resolver-typescript": "^3.5.5",
+        "eslint-plugin-import": "^2.27.5",
+        "eslint-plugin-tsdoc": "^0.3.0",
+        "fake-indexeddb": "^4.0.1",
+        "happy-dom": "^15.11.7",
+        "ioredis": "^5.3.2",
+        "msgpackr": "^1.10.1",
+        "seedrandom": "^3.0.5",
+        "typed-emitter": "^2.1.0",
+        "typescript": "^5.1.6",
+        "vite-plugin-wasm": "^3.4.1",
+        "vitest-fetch-mock": "^0.4.3"
+    },
+    "files": [
+        "/dist"
+    ]
+}