@sublay/js 7.9.0 → 7.9.1

package/dist/index.js

@@ -334,7 +334,7 @@ async function verifyEmail(client, data) {
 async function sendVerificationEmail(client, data) {
   const response = await client.projectInstance.post(
     "/auth/send-verification-email",
-    data ?? {}
+    data
   );
   return response.data;
 }

package/dist/index.mjs

@@ -302,7 +302,7 @@ async function verifyEmail(client, data) {
 async function sendVerificationEmail(client, data) {
   const response = await client.projectInstance.post(
     "/auth/send-verification-email",
-    data ?? {}
+    data
   );
   return response.data;
 }

package/package.json

@@ -1,23 +1,39 @@
 {
   "name": "@sublay/js",
-  "version": "7.9.0",
+  "version": "7.9.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "NOTICE"
   ],
   "description": "Official JavaScript SDK for Sublay",
+  "bugs": {
+    "url": "https://discord.com/invite/REKxnCJzPz"
+  },
+  "homepage": "https://docs.sublay.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sublay-io/monorepo.git",
+    "directory": "packages/js"
+  },
   "author": "Sublay team",
-  "license": "ISC",
+  "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
-    }
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
   },
   "dependencies": {
     "axios": "^1.15.0"
@@ -30,17 +46,12 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3"
   },
+  "engines": {
+    "node": ">=22.13"
+  },
   "scripts": {
-    "build": "tsup src/index.ts --dts --format cjs,esm",
-    "build:types": "tsc --emitDeclarationOnly",
-    "test": "jest",
-    "version:patch": "pnpm version patch --no-git-tag-version --no-git-checks",
-    "version:minor": "pnpm version minor --no-git-tag-version --no-git-checks",
-    "publish-beta": "pnpm test && pnpm publish --tag beta --no-git-checks",
-    "publish-prod": "pnpm test && pnpm publish --no-git-checks",
-    "publish-beta:patch": "pnpm version:patch && pnpm publish-beta",
-    "publish-beta:minor": "pnpm version:minor && pnpm publish-beta",
-    "publish-prod:patch": "pnpm version:patch && pnpm publish-prod",
-    "publish-prod:minor": "pnpm version:minor && pnpm publish-prod"
+    "build": "tsup src/index.ts --dts --format cjs,esm --clean",
+    "build:types": "tsc --noEmit",
+    "test": "jest"
   }
 }

package/dist/core/client.d.ts

@@ -1,64 +0,0 @@
-import { AxiosInstance } from "axios";
-export interface AuthTokens {
-    accessToken: string;
-    refreshToken: string;
-}
-export interface ClientConfig {
-    projectId: string;
-    /**
-     * Optional tokens to hydrate the SDK on init (SDK-managed mode) — e.g. tokens
-     * the host app persisted from a previous session.
-     */
-    initialTokens?: AuthTokens;
-    /**
-     * Optional async hook returning the current access token. **Providing it puts
-     * the SDK in "host-managed" mode**: the host owns the token and its refresh,
-     * and the SDK never stores or refreshes tokens itself.
-     */
-    getToken?: () => string | null | undefined | Promise<string | null | undefined>;
-    /**
-     * Called whenever the SDK sets, rotates, or clears tokens (SDK-managed mode
-     * only). Receives `null` on sign-out. Use it to persist tokens so a session
-     * survives a reload.
-     */
-    onAuthChange?: (tokens: AuthTokens | null) => void;
-}
-export declare class SublayHttpClient {
-    projectInstance: AxiosInstance;
-    private readonly baseURL;
-    private readonly hostManaged;
-    private readonly getToken?;
-    private readonly onAuthChange?;
-    private accessToken;
-    private refreshToken;
-    /** Shared so concurrent 403s trigger a single refresh (mutex). */
-    private refreshPromise;
-    constructor({ projectId, initialTokens, getToken, onAuthChange, }: ClientConfig);
-    /**
-     * The SDK's own in-memory access token (SDK-managed mode). Distinct from the
-     * `init({ getToken })` host hook, which supplies a token in host-managed mode.
-     */
-    getAccessToken(): string | null;
-    getRefreshToken(): string | null;
-    /**
-     * The `Authorization` header value (`Bearer <token>`) for the active auth
-     * mode, or `undefined` if there is no token. Host-managed mode reads the
-     * `getToken` hook; SDK-managed mode reads the in-memory access token. Use this
-     * for requests that bypass `projectInstance` (e.g. the SSE `askContent`
-     * stream, which needs `fetch` rather than axios).
-     */
-    getAuthHeader(): Promise<string | undefined>;
-    /** Store a full token pair (SDK-managed mode only; no-op when host-managed). */
-    setTokens(tokens: AuthTokens): void;
-    /** Update just the access token, e.g. after a refresh (no-op when host-managed). */
-    setAccessToken(accessToken: string): void;
-    /** Clear tokens and notify with null (SDK-managed mode only). */
-    clearTokens(): void;
-    /**
-     * Refresh the access token using the in-memory refresh token. A single shared
-     * promise (mutex) means concurrent 403s trigger only one network refresh. The
-     * call goes through a bare axios (not `projectInstance`) so it never re-enters
-     * the response interceptor. Returns the new access token, or null on failure.
-     */
-    private refreshAccessToken;
-}

package/dist/core/multipart.d.ts

@@ -1,22 +0,0 @@
-/**
- * Helpers for building `multipart/form-data` request bodies. Shared by every
- * upload site (storage, chat messages, user avatar/banner) so they encode
- * fields identically: object/array values are JSON-stringified (the server
- * re-parses them), scalars are coerced to strings, and `undefined` is skipped.
- *
- * Do NOT set the request's `Content-Type` manually for these bodies — axios sets
- * it to `undefined` for a `FormData` instance so the browser writes the
- * multipart boundary itself.
- */
-/** Append a single field: skip `undefined`, JSON-stringify objects/arrays. */
-export declare function appendField(form: FormData, key: string, value: unknown): void;
-/** Append every own field of `fields` via {@link appendField}. */
-export declare function appendFields(form: FormData, fields: Record<string, unknown>): void;
-/**
- * Append a file part under `field`. The multipart filename is, in order of
- * precedence: an explicit `filename`, the `File`'s own name, then `fallback`.
- */
-export declare function appendFile(form: FormData, field: string, file: Blob | File, opts?: {
-    filename?: string;
-    fallback?: string;
-}): void;

package/dist/core/spaceReputationParams.d.ts

@@ -1,57 +0,0 @@
-/**
- * Input accepted by {@link buildSpaceReputationParams}: either the new
- * `spaceReputation` object or the deprecated flat props.
- *
- * The flat inputs accept `null` (in addition to `undefined`) so the helper's
- * contract matches `@sublay/core` and `@sublay/node` exactly; `null` is treated
- * as unset. js-sdk never persists these params, so the `null` tolerance is not
- * strictly required here, but matching the sibling helpers is harmless and
- * consistent.
- */
-export interface BuildSpaceReputationParamsInput {
-    spaceReputation?: {
-        spaceId: string | "none" | "context";
-        includeDescendants?: boolean;
-    };
-    /**
-     * @deprecated Pass `spaceReputation` instead. Accepted for back-compat.
-     */
-    spaceReputationId?: string | null;
-    /**
-     * @deprecated Pass `spaceReputation` instead. Accepted for back-compat.
-     */
-    spaceReputationDescendants?: boolean | null;
-}
-/**
- * Flat output handed to the query-string serializer (axios `params` or the
- * `askContent` `URLSearchParams`). Both keys are omitted when unset — never
- * bracketed, never nested.
- */
-export interface SpaceReputationFlatParams {
-    spaceReputationId?: string;
-    spaceReputationDescendants?: boolean;
-}
-/**
- * Normalize the `spaceReputation` object or the deprecated flat props down to
- * the flat query params the server understands
- * (`spaceReputationId` / `spaceReputationDescendants`).
- *
- * **Critical:** this is the only thing that prevents the nested
- * `spaceReputation` object from reaching a query-string serializer. Axios would
- * bracket-encode it (`spaceReputation[spaceId]=…`) and the `askContent`
- * `URLSearchParams` path would stringify it to `[object Object]`; the server
- * ignores both — silently no-opping the new (primary) form. Every
- * reputation-consuming module must route the object through here and merge only
- * the flat output.
- *
- * Rules (mirrors the `@sublay/core` / `@sublay/node` helper contract):
- * - **Object wins when present.** "Present" means the `spaceReputation` key was
- *   supplied at all (`spaceReputation !== undefined`) — even `{}` or a partial
- *   object suppresses the flat props.
- * - When **both** the object and a flat prop are supplied, the object wins and a
- *   one-time dev-only `console.warn` fires (never throws).
- * - The flat inputs tolerate `null` (treated as unset → param omitted).
- * - Output keys are omitted when unset; the result is always the two flat keys,
- *   never a bracketed/nested object.
- */
-export declare function buildSpaceReputationParams(input: BuildSpaceReputationParamsInput): SpaceReputationFlatParams;

package/dist/interfaces/AppNotification.d.ts

@@ -1,258 +0,0 @@
-type AppNotificationType = "system" | "entity-comment" | "comment-reply" | "entity-mention" | "comment-mention" | "entity-upvote" | "comment-upvote" | "entity-reaction" | "comment-reaction" | "entity-reaction-milestone-specific" | "entity-reaction-milestone-total" | "comment-reaction-milestone-specific" | "comment-reaction-milestone-total" | "new-follow" | "connection-request" | "connection-accepted" | "space-membership-approved";
-interface BaseAppNotification {
-    id: string;
-    userId: string;
-    type: AppNotificationType;
-    isRead: boolean;
-    metadata: Record<string, any>;
-    createdAt: string;
-}
-export interface SystemNotification extends BaseAppNotification {
-    type: "system";
-    action: string;
-    metadata: {
-        title?: string;
-        content?: string;
-        buttonData: {
-            text: string;
-            url: string;
-        } | null;
-    };
-}
-export interface EntityCommentNotification extends BaseAppNotification {
-    type: "entity-comment";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface CommentReplyNotification extends BaseAppNotification {
-    type: "comment-reply";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        replyId: string;
-        replyContent: string | null | undefined;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface EntityMentionNotification extends BaseAppNotification {
-    type: "entity-mention";
-    action: "open-entity";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface CommentMentionNotification extends BaseAppNotification {
-    type: "comment-mention";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface EntityUpvoteNotification extends BaseAppNotification {
-    type: "entity-upvote";
-    action: "open-entity";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface CommentUpvoteNotification extends BaseAppNotification {
-    type: "comment-upvote";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface EntityReactionNotification extends BaseAppNotification {
-    type: "entity-reaction";
-    action: "open-entity";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        reactionType: string;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface CommentReactionNotification extends BaseAppNotification {
-    type: "comment-reaction";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        reactionType: string;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-interface MilestoneUser {
-    id: string;
-    name: string | null | undefined;
-    username: string | null | undefined;
-    avatar: string | null | undefined;
-}
-export interface EntityReactionMilestoneSpecificNotification extends BaseAppNotification {
-    type: "entity-reaction-milestone-specific";
-    action: "open-entity";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        reactionType: string;
-        milestoneCount: number;
-        lastThreeUsers: MilestoneUser[];
-    };
-}
-export interface EntityReactionMilestoneTotalNotification extends BaseAppNotification {
-    type: "entity-reaction-milestone-total";
-    action: "open-entity";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        milestoneCount: number;
-        reactionCounts: Record<string, number>;
-        lastThreeUsers: MilestoneUser[];
-    };
-}
-export interface CommentReactionMilestoneSpecificNotification extends BaseAppNotification {
-    type: "comment-reaction-milestone-specific";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        reactionType: string;
-        milestoneCount: number;
-        lastThreeUsers: MilestoneUser[];
-    };
-}
-export interface CommentReactionMilestoneTotalNotification extends BaseAppNotification {
-    type: "comment-reaction-milestone-total";
-    action: "open-comment";
-    metadata: {
-        entityId: string;
-        entityShortId: string;
-        entityTitle: string | null | undefined;
-        entityContent: string | null | undefined;
-        commentId: string;
-        commentContent: string | null | undefined;
-        milestoneCount: number;
-        reactionCounts: Record<string, number>;
-        lastThreeUsers: MilestoneUser[];
-    };
-}
-export interface SpaceMembershipApprovedNotification extends BaseAppNotification {
-    type: "space-membership-approved";
-    action: "open-space";
-    metadata: {
-        spaceId: string;
-        spaceName: string;
-        spaceShortId: string;
-        spaceSlug: string | null | undefined;
-        spaceAvatar: string | null | undefined;
-    };
-}
-export interface NewFollowNotification extends BaseAppNotification {
-    type: "new-follow";
-    action: "open-profile";
-    metadata: {
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface ConnectionRequestNotification extends BaseAppNotification {
-    type: "connection-request";
-    action: "open-profile";
-    metadata: {
-        connectionId: string;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export interface ConnectionAcceptedNotification extends BaseAppNotification {
-    type: "connection-accepted";
-    action: "open-profile";
-    metadata: {
-        connectionId: string;
-        initiatorId: string;
-        initiatorName: string | null | undefined;
-        initiatorUsername: string | null | undefined;
-        initiatorAvatar: string | null | undefined;
-    };
-}
-export type UnifiedAppNotification = SystemNotification | EntityCommentNotification | CommentReplyNotification | EntityMentionNotification | CommentMentionNotification | EntityUpvoteNotification | CommentUpvoteNotification | EntityReactionNotification | CommentReactionNotification | EntityReactionMilestoneSpecificNotification | EntityReactionMilestoneTotalNotification | CommentReactionMilestoneSpecificNotification | CommentReactionMilestoneTotalNotification | NewFollowNotification | ConnectionRequestNotification | ConnectionAcceptedNotification | SpaceMembershipApprovedNotification;
-export type PotentiallyPopulatedUnifiedAppNotification = UnifiedAppNotification & {
-    title?: string;
-    content?: string;
-};
-export {};

package/dist/interfaces/ChatMessage.d.ts

@@ -1,40 +0,0 @@
-import { GrantSummary } from "./ReputationGrant";
-import { GifData } from "./Comment";
-import { File } from "./File";
-import { Mention } from "./Mention";
-import { User } from "./User";
-export interface ChatMessage {
-    id: string;
-    projectId: string;
-    conversationId: string;
-    userId: string | null;
-    content: string | null;
-    gif: GifData | null;
-    mentions: Mention[];
-    files?: File[];
-    metadata: Record<string, any>;
-    parentMessageId: string | null;
-    quotedMessageId: string | null;
-    threadReplyCount: number;
-    reactionCounts: Record<string, number>;
-    userReactions: string[];
-    /**
-     * Reputation-grant summary. Opt-in — present exactly when the read requested
-     * `include=grants`. Once requested the server always returns the object,
-     * zero-filled rather than omitted, on projects with no grants and on projects
-     * without the reputation bundle alike.
-     */
-    grants?: GrantSummary;
-    editedAt: string | null;
-    userDeletedAt: string | null;
-    moderationStatus: "approved" | "removed" | null;
-    moderatedAt: string | null;
-    moderatedById: string | null;
-    moderatedByType: "client" | "user" | null;
-    moderationReason: string | null;
-    createdAt: string;
-    updatedAt: string;
-    user: User | null;
-    quotedMessage?: ChatMessage | null;
-    parentMessage?: ChatMessage | null;
-}

package/dist/interfaces/Collection.d.ts

@@ -1,10 +0,0 @@
-export interface Collection {
-    id: string;
-    projectId: string;
-    userId: string;
-    parentId: string | null;
-    name: string;
-    entityCount: number;
-    createdAt: string;
-    updatedAt: string;
-}

package/dist/interfaces/Comment.d.ts

@@ -1,50 +0,0 @@
-import { GrantSummary } from "./ReputationGrant";
-import { Entity } from "./Entity";
-import { Mention } from "./Mention";
-import { User } from "./User";
-import { ReactionCounts, ReactionType } from "./Reaction";
-export interface GifData {
-    id: string;
-    url: string;
-    gifUrl: string;
-    gifPreviewUrl: string;
-    altText: string;
-    aspectRatio: string;
-}
-export interface Comment {
-    id: string;
-    projectId: string;
-    foreignId: string | null;
-    entityId: string;
-    entity?: Entity;
-    userId: string;
-    user?: User;
-    parentId: string | null;
-    parentComment?: Comment;
-    content: string | null;
-    gif: GifData | null;
-    mentions: Mention[];
-    upvotes: string[];
-    downvotes: string[];
-    reactionCounts: ReactionCounts;
-    userReaction?: ReactionType | null;
-    repliesCount: number;
-    /**
-     * Reputation-grant summary. Opt-in — present exactly when the read requested
-     * `include=grants`. Once requested the server always returns the object,
-     * zero-filled rather than omitted, on projects with no grants and on projects
-     * without the reputation bundle alike.
-     */
-    grants?: GrantSummary;
-    metadata: Record<string, any>;
-    createdAt: string;
-    updatedAt: string;
-    deletedAt: string | null;
-    parentDeletedAt: string | null;
-    userDeletedAt: string | null;
-    moderationStatus: "approved" | "removed" | null;
-    moderatedAt: string | null;
-    moderatedById: string | null;
-    moderatedByType: "client" | "user" | null;
-    moderationReason: string | null;
-}

package/dist/interfaces/Connection.d.ts

@@ -1,67 +0,0 @@
-import { User } from "./User";
-export interface Connection {
-    id: string;
-    message?: string;
-    createdAt: string;
-}
-/** Returned by `POST /users/:userId/connection` (requestConnection). */
-export interface ConnectionRequestResponse {
-    id: string;
-    status: string;
-    createdAt: string;
-}
-export interface EstablishedConnection {
-    id: string;
-    connectedUser: User;
-    connectedAt: string;
-}
-export interface PendingConnection extends Connection {
-    user: User;
-    type: "received" | "sent";
-}
-export interface ConnectionRequestParams {
-    userId: string;
-    message?: string;
-}
-export interface ConnectionActionResponse {
-    id: string;
-    status: string;
-    createdAt?: string;
-    respondedAt?: string;
-}
-export interface ConnectionWithdrawResponse {
-    message: string;
-}
-export interface ConnectionCountResponse {
-    count: number;
-}
-export interface RemoveConnectionByUserIdResponse {
-    id?: string;
-    status?: string;
-    respondedAt?: string;
-    message?: string;
-    action?: "withdraw" | "disconnect" | "decline";
-}
-export interface ConnectionStatusNone {
-    status: "none";
-}
-export interface ConnectionStatusPending {
-    status: "pending";
-    type: "sent" | "received";
-    connectionId: string;
-    createdAt: string;
-}
-export interface ConnectionStatusConnected {
-    status: "connected";
-    connectionId: string;
-    connectedAt: string;
-    requestedAt: string;
-}
-export interface ConnectionStatusDeclined {
-    status: "declined";
-    type: "sent" | "received";
-    connectionId: string;
-    respondedAt: string;
-}
-export type ConnectionStatusResponse = ConnectionStatusNone | ConnectionStatusPending | ConnectionStatusConnected | ConnectionStatusDeclined;
-export type ConnectionStatus = "none" | "pending-sent" | "pending-received" | "connected" | "declined-sent" | "declined-received";