@sublay/js 7.8.0 → 7.9.1

package/dist/interfaces/ImageProcessing.d.ts

@@ -1,62 +0,0 @@
-export type ImageFit = "cover" | "contain" | "inside" | "outside";
-export type ImageFormat = "webp" | "jpeg" | "png" | "original";
-interface BaseImageOptions {
-    /** 1–100. Output quality. */
-    quality?: number;
-    format?: ImageFormat;
-    stripExif?: boolean;
-}
-/** Mode 1 — explicit width/height per named variant. */
-export interface ExactDimensionsOptions extends BaseImageOptions {
-    mode: "exact-dimensions";
-    /** Keyed by variant name, e.g. `{ thumbnail: { width, height } }`. 50–10000. */
-    dimensions: Record<string, {
-        width: number;
-        height: number;
-    }>;
-    fit?: ImageFit;
-}
-/** Mode 2a — fixed aspect ratio, sized by width per variant. */
-export interface AspectRatioWidthOptions extends BaseImageOptions {
-    mode: "aspect-ratio-width-based";
-    aspectRatio: {
-        width: number;
-        height: number;
-    };
-    /** Keyed by variant name → target width (50–10000). */
-    widths: Record<string, number>;
-    fit?: ImageFit;
-}
-/** Mode 2b — fixed aspect ratio, sized by height per variant. */
-export interface AspectRatioHeightOptions extends BaseImageOptions {
-    mode: "aspect-ratio-height-based";
-    aspectRatio: {
-        width: number;
-        height: number;
-    };
-    /** Keyed by variant name → target height (50–10000). */
-    heights: Record<string, number>;
-    fit?: ImageFit;
-}
-/** Mode 3 — preserve the source aspect ratio, bounded per variant. */
-export interface OriginalAspectOptions extends BaseImageOptions {
-    mode: "original-aspect";
-    /** Keyed by variant name → bounding size (50–10000). */
-    sizes: Record<string, number>;
-    /** Server restricts this mode to `inside` | `outside`. */
-    fit?: "inside" | "outside";
-}
-/** Mode 4 — multiple aspect ratios, sized per variant. */
-export interface MultiAspectRatioOptions extends BaseImageOptions {
-    mode: "multi-aspect-ratio";
-    /** 1–10 aspect ratios. */
-    aspectRatios: {
-        width: number;
-        height: number;
-    }[];
-    /** Keyed by variant name → target size (50–10000). */
-    sizes: Record<string, number>;
-    fit?: ImageFit;
-}
-export type ImageOptions = ExactDimensionsOptions | AspectRatioWidthOptions | AspectRatioHeightOptions | OriginalAspectOptions | MultiAspectRatioOptions;
-export {};

package/dist/interfaces/Mention.d.ts

@@ -1,12 +0,0 @@
-export type Mention = UserMention | SpaceMention;
-export interface UserMention {
-    type: "user";
-    id: string;
-    foreignId?: string | null;
-    username: string;
-}
-export interface SpaceMention {
-    type: "space";
-    id: string;
-    slug: string;
-}

package/dist/interfaces/OAuthIdentity.d.ts

@@ -1,14 +0,0 @@
-export interface OAuthIdentity {
-    id: string;
-    provider: string;
-    providerAccountId: string;
-    email: string | null;
-    name: string | null;
-    avatar: string | null;
-    isVerified: boolean;
-    createdAt: string;
-}
-export interface ListIdentitiesResponse {
-    identities: OAuthIdentity[];
-    hasPassword: boolean;
-}

package/dist/interfaces/Project.d.ts

@@ -1,14 +0,0 @@
-export interface Project {
-    id: string;
-    clientId: string;
-    name: string;
-    integrations: {
-        id: string;
-        projectId: string;
-        name: string;
-        data: Record<string, any>;
-        createdAt: string;
-    }[];
-    createdAt: string;
-    updatedAt: string;
-}

package/dist/interfaces/Push.d.ts

@@ -1,74 +0,0 @@
-/**
- * Every push event type — the full app-notification type set plus the chat
- * `message` event (push-only). Mirrors the server's `PUSH_EVENT_TYPES` exactly
- * (server `src/constants/push/pushEvents.ts`); these are the only names a
- * `disabledTypes` set may contain.
- */
-export declare const PUSH_EVENT_TYPES: readonly ["entity-comment", "comment-reply", "entity-mention", "comment-mention", "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", "event-invite", "event-updated", "event-cancelled", "message"];
-export type PushEventType = (typeof PUSH_EVENT_TYPES)[number];
-/**
- * The four conversation-mute duration choices. Send the CHOICE, never a raw
- * timestamp — the server resolves it and represents "forever" via the explicit
- * `mutedForever` signal on the returned member. Mirrors the server's
- * `MUTE_DURATIONS` (server `src/helpers/push/muteDuration.ts`).
- */
-export declare const MUTE_DURATIONS: readonly ["8h", "24h", "1w", "forever"];
-export type MuteDuration = (typeof MUTE_DURATIONS)[number];
-/** Response of read/update notification preferences. */
-export interface NotificationPreferences {
-    disabledTypes: PushEventType[];
-}
-/**
- * A Web Push subscription in its SERIALIZED form — the JSON the server reads,
- * not the live browser object.
- *
- * A `PushSubscription` straight from `PushManager.subscribe()` does NOT satisfy
- * this type. It exposes its keys only through `getKey(name)`; there is no `keys`
- * property to read, so it is not assignable here under strict TypeScript, and
- * passing one through a cast sends a body the server rejects.
- *
- * To produce a value of this type:
- *
- * 1. **Serialize** the subscription with `subscription.toJSON()`.
- * 2. **Confirm** `endpoint`, `keys.p256dh` and `keys.auth` are all present —
- *    `PushSubscriptionJSON` types every one of them as optional, while the
- *    server requires all three as non-empty strings and 400s otherwise.
- *
- * ```ts
- * const json = subscription.toJSON();
- * if (!json.endpoint || !json.keys?.p256dh || !json.keys?.auth) {
- *   throw new Error("Incomplete Web Push subscription");
- * }
- * const webPushSubscription: WebPushSubscription = {
- *   endpoint: json.endpoint,
- *   keys: { p256dh: json.keys.p256dh, auth: json.keys.auth },
- * };
- * ```
- *
- * Mirrors the server's `webPushSubscriptionSchema`
- * (server `src/v7/validation/push-notifications/push-notifications.schema.ts`).
- */
-export interface WebPushSubscription {
-    endpoint: string;
-    keys: {
-        p256dh: string;
-        auth: string;
-    };
-}
-/**
- * Identifies one physical device. Mirrors the server's device-identifier body
- * exactly (server `src/v7/validation/push-notifications/push-notifications.schema.ts`):
- * a provider token for `ios`/`android`, a Web Push subscription for `web`. The
- * union encodes the server's own cross-check — it rejects the same
- * combinations the server's `superRefine` rejects.
- *
- * Passed to `auth.signOut` to unbind that device's push binding in the same
- * transaction as the sign-out.
- */
-export type PushDeviceIdentifier = {
-    platform: "ios" | "android";
-    token: string;
-} | {
-    platform: "web";
-    subscription: WebPushSubscription;
-};

package/dist/interfaces/Reaction.d.ts

@@ -1,23 +0,0 @@
-import { User } from "./User";
-export type ReactionType = "upvote" | "downvote" | "like" | "love" | "wow" | "sad" | "angry" | "funny";
-export interface ReactionCounts {
-    upvote: number;
-    downvote: number;
-    like: number;
-    love: number;
-    wow: number;
-    sad: number;
-    angry: number;
-    funny: number;
-}
-export interface Reaction {
-    id: string;
-    projectId: string;
-    targetType: "entity" | "comment";
-    targetId: string;
-    userId: string;
-    reactionType: ReactionType;
-    createdAt: string;
-    updatedAt: string;
-    user?: User;
-}

package/dist/interfaces/Report.d.ts

@@ -1,38 +0,0 @@
-import { Entity } from "./Entity";
-import { Comment } from "./Comment";
-import { Space } from "./Space";
-export type ReportTargetType = "entity" | "comment" | "message";
-/**
- * The reasons the API accepts on a report. Server-enforced — anything outside
- * this set is rejected with `report/invalid-body`. Use `other` plus `details`
- * for anything the taxonomy doesn't cover.
- */
-export type ReportReason = "spam" | "inappropriateContent" | "harassment" | "misinformation" | "hateSpeech" | "violence" | "illegalActivity" | "selfHarm" | "other";
-export type ReportStatus = "pending" | "on-hold" | "escalated" | "dismissed" | "actioned";
-export interface UserReport {
-    id: string;
-    projectId: string;
-    reportId: string;
-    userId: string;
-    reason: string;
-    details: string | null;
-    createdAt: string;
-}
-export interface Report {
-    id: string;
-    projectId: string;
-    spaceId: string | null;
-    targetId: string;
-    targetType: ReportTargetType;
-    status: ReportStatus;
-    reporterCount: number;
-    createdAt: string;
-    updatedAt: string;
-    userReports?: UserReport[];
-    target?: Entity | Comment | null;
-    space?: Space | null;
-}
-export interface CreateReportResponse {
-    message: string;
-    code: "report/created" | "report/updated" | "report/already-reported";
-}

package/dist/interfaces/Rule.d.ts

@@ -1,22 +0,0 @@
-export interface Rule {
-    id: string;
-    projectId: string;
-    spaceId: string;
-    title: string;
-    description: string | null;
-    order: number;
-    lastApprovedBy: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface FetchManyRulesResponse {
-    data: Rule[];
-    count: number;
-}
-export interface DeleteRuleResponse {
-    message: string;
-    deletedRule: {
-        id: string;
-        title: string;
-    };
-}

package/dist/interfaces/Space.d.ts

@@ -1,130 +0,0 @@
-import { PaginatedResponse } from "./IPaginatedResponse";
-import { File } from "./File";
-export type ReadingPermission = "anyone" | "members";
-export type PostingPermission = "anyone" | "members" | "admins";
-export type SpaceVisibility = "public" | "unlisted" | "private";
-export type SpaceMemberRole = "admin" | "moderator" | "member";
-export type SpaceMemberStatus = "pending" | "active" | "banned" | "rejected";
-export interface SpaceMemberPermissions {
-    isAdmin: boolean;
-    isModerator: boolean;
-    isMember: boolean;
-    status: "pending" | "active" | "banned" | null;
-    canPost: boolean;
-    canModerate: boolean;
-    canRead: boolean;
-}
-export interface SpacePreview {
-    id: string;
-    shortId: string;
-    name: string;
-    slug: string | null;
-    avatarFileId: string | null;
-    readingPermission?: ReadingPermission;
-    visibility?: SpaceVisibility;
-    parentSpaceId?: string | null;
-    depth?: number;
-    avatarFile?: File;
-}
-export interface Space {
-    id: string;
-    projectId: string;
-    shortId: string;
-    slug: string | null;
-    name: string;
-    description: string | null;
-    avatarFileId: string | null;
-    bannerFileId: string | null;
-    userId: string;
-    readingPermission: ReadingPermission;
-    postingPermission: PostingPermission;
-    visibility: SpaceVisibility;
-    requireJoinApproval: boolean;
-    nsfw: boolean;
-    nsfwEffective: boolean;
-    parentSpaceId: string | null;
-    depth: number;
-    metadata: Record<string, any>;
-    createdAt: string;
-    updatedAt: string;
-    deletedAt: string | null;
-    membersCount: number;
-    childSpacesCount: number;
-    isMember?: boolean;
-    avatarFile?: File;
-    bannerFile?: File;
-}
-export interface SpaceDetailed extends Space {
-    memberPermissions: SpaceMemberPermissions | null;
-    parentSpace: SpacePreview | null;
-    childSpaces: SpacePreview[];
-}
-export interface UserSpaceItem {
-    space: Space;
-    membership: {
-        membershipId: string;
-        role: SpaceMemberRole;
-        status: SpaceMemberStatus;
-        joinedAt: string;
-    };
-}
-export type UserSpacesResponse = PaginatedResponse<UserSpaceItem>;
-export interface JoinSpaceResponse {
-    message: string;
-    membership: {
-        id: string;
-        spaceId: string;
-        userId: string;
-        role: "member";
-        status: "pending" | "active";
-        joinedAt: string;
-    };
-}
-export interface LeaveSpaceResponse {
-    message: string;
-}
-export interface UpdateMemberRoleResponse {
-    message: string;
-    membership: {
-        id: string;
-        role: SpaceMemberRole;
-        status: string;
-        joinedAt: string;
-        userId: string;
-    };
-}
-export interface ApproveMemberResponse {
-    message: string;
-    membership: {
-        id: string;
-        status: "active";
-        joinedAt: string;
-    };
-}
-export interface DeclineMemberResponse {
-    message: string;
-    membership: {
-        id: string;
-        status: "rejected";
-    };
-}
-export interface CheckMyMembershipResponse {
-    isMember: boolean;
-    role: "admin" | "moderator" | "member" | null;
-    status: "pending" | "active" | "banned" | "rejected" | null;
-    joinedAt: string | null;
-    permissions: {
-        canPost: boolean;
-        canModerate: boolean;
-        canRead: boolean;
-        isAdmin: boolean;
-        isModerator: boolean;
-    };
-}
-export interface DeleteSpaceResponse {
-    message: string;
-}
-export interface SpaceBreadcrumb {
-    breadcrumb: SpacePreview[];
-    depth: number;
-}

package/dist/interfaces/SpaceMember.d.ts

@@ -1,29 +0,0 @@
-import { PaginatedResponse } from "./IPaginatedResponse";
-import { SpaceMemberRole, SpaceMemberStatus } from "./Space";
-export interface SpaceMember {
-    id: string;
-    projectId: string;
-    spaceId: string;
-    userId: string;
-    role: SpaceMemberRole;
-    status: SpaceMemberStatus;
-    joinedAt: string;
-    createdAt: string;
-}
-export interface SpaceMemberWithUser {
-    membershipId: string;
-    role: SpaceMemberRole;
-    status: SpaceMemberStatus;
-    joinedAt: string;
-    user: {
-        id: string;
-        username: string;
-        displayName: string;
-        avatar: string;
-        metadata: object;
-    };
-}
-export type SpaceMembersResponse = PaginatedResponse<SpaceMemberWithUser>;
-export interface SpaceTeamResponse {
-    data: SpaceMemberWithUser[];
-}

package/dist/interfaces/SpaceReputation.d.ts

@@ -1,100 +0,0 @@
-/**
- * Shared optional params for opting a request into space-scoped reputation
- * enrichment. When set, users embedded in the response carry a
- * `spaceReputation` field (see {@link import("./User").UserFull}).
- *
- * Two variants exist because the server accepts a different value set per
- * endpoint class:
- * - {@link SpaceReputationContextParams} — context endpoints (entities,
- *   comments, chat, spaces, search, reports). Accept `<uuid> | "none" |
- *   "context"`.
- * - {@link SpaceReputationUserParams} — user-direct endpoints (the `users`
- *   module). Accept `<uuid> | "none"` only; `"context"` is rejected by the
- *   server (400).
- *
- * Both classes share the same param names and types — only the accepted
- * `spaceReputationId` value set (documented in JSDoc) differs.
- */
-/**
- * Space-reputation params for **context** endpoints.
- */
-export interface SpaceReputationContextParams {
-    /**
-     * Opt into space-scoped reputation enrichment. The primary form: an object
-     * describing the space and whether to include descendants.
-     *
-     * - `spaceId` — a space `<uuid>` (reputation within that specific space),
-     *   `"none"` (no space context — global reputation only), or `"context"`
-     *   (derive the space from each record's own context, e.g. a feed enriches
-     *   each row's author with reputation in that row's space).
-     * - `includeDescendants` — whether to include descendant spaces when
-     *   computing space-scoped reputation. Only honored with an explicit space
-     *   `<uuid>` (ignored for `"none"` / `"context"`).
-     */
-    spaceReputation?: {
-        spaceId: string | "none" | "context";
-        includeDescendants?: boolean;
-    };
-    /**
-     * @deprecated Pass the `spaceReputation` object instead. Retained for
-     * back-compat; removal is a later major version.
-     *
-     * Opt into space-scoped reputation enrichment. Accepted forms:
-     * - a space `<uuid>` — reputation within that specific space;
-     * - `"none"` — no space context (global reputation only);
-     * - `"context"` — derive the space from each record's own context
-     *   (e.g. a feed enriches each row's author with reputation in that row's
-     *   space).
-     */
-    spaceReputationId?: string;
-    /**
-     * @deprecated Pass the `spaceReputation` object (`includeDescendants`)
-     * instead. Retained for back-compat; removal is a later major version.
-     *
-     * Whether to include descendant spaces when computing space-scoped
-     * reputation. Only honored with an explicit space `<uuid>` (ignored for
-     * `"none"` / `"context"`).
-     */
-    spaceReputationDescendants?: boolean;
-}
-/**
- * Space-reputation params for **user-direct** endpoints (the `users` module).
- */
-export interface SpaceReputationUserParams {
-    /**
-     * Opt into space-scoped reputation enrichment. The primary form: an object
-     * describing the space and whether to include descendants.
-     *
-     * - `spaceId` — a space `<uuid>` (reputation within that specific space) or
-     *   `"none"` (no space context — global reputation only). `"context"` is
-     *   **rejected by the server (400)** on user-direct endpoints — there is no
-     *   per-record context to derive a space from.
-     * - `includeDescendants` — whether to include descendant spaces when
-     *   computing space-scoped reputation. Only honored with an explicit space
-     *   `<uuid>`.
-     */
-    spaceReputation?: {
-        spaceId: string | "none";
-        includeDescendants?: boolean;
-    };
-    /**
-     * @deprecated Pass the `spaceReputation` object instead. Retained for
-     * back-compat; removal is a later major version.
-     *
-     * Opt into space-scoped reputation enrichment. Accepted forms:
-     * - a space `<uuid>` — reputation within that specific space;
-     * - `"none"` — no space context (global reputation only).
-     *
-     * `"context"` is **rejected by the server (400)** on user-direct endpoints —
-     * there is no per-record context to derive a space from.
-     */
-    spaceReputationId?: string;
-    /**
-     * @deprecated Pass the `spaceReputation` object (`includeDescendants`)
-     * instead. Retained for back-compat; removal is a later major version.
-     *
-     * Whether to include descendant spaces when computing space-scoped
-     * reputation. Only honored with an explicit space `<uuid>`.
-     */
-    spaceReputationDescendants?: boolean;
-}

package/dist/interfaces/Table.d.ts

@@ -1,63 +0,0 @@
-import { SublayHttpClient } from "../core/client";
-import { PaginatedResponse } from "./IPaginatedResponse";
-/**
- * Custom-table types for the `/db` surface (row ops only — the js-sdk holds no
- * service key, so it carries no table-management/DDL surface).
- *
- * Names mirror the server's `/db` contract exactly.
- */
-export type DbFilterOperator = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "in" | "contains" | "like" | "isNull";
-export interface DbFilter {
-    column: string;
-    operator: DbFilterOperator;
-    value?: unknown;
-}
-export interface TableQuery {
-    page?: number;
-    limit?: number;
-    sortBy?: string;
-    sortDir?: "asc" | "desc";
-    /** AND-combined filter clauses. Serialized to a JSON query param. */
-    filters?: DbFilter[];
-    /** Surface soft-deleted rows on a paranoid table. */
-    includeDeleted?: boolean;
-}
-/** Shape every custom-table row shares (managed columns). */
-export interface TableRow {
-    id: string;
-    createdAt?: string;
-    updatedAt?: string;
-    deletedAt?: string | null;
-    [column: string]: unknown;
-}
-export interface DeleteResult {
-    deleted: boolean;
-    soft: boolean;
-}
-export interface BulkDeleteResult {
-    deletedCount: number;
-    soft: boolean;
-}
-export interface BulkDeleteProps {
-    rowIds?: string[];
-    filters?: DbFilter[];
-    force?: boolean;
-}
-/**
- * Per-table row-operations accessor returned by `client.table<T>(name)`.
- * The actor is derived server-side from the user token (js-sdk Rule A) — no
- * actor params here. No DDL surface (no service key).
- */
-export interface TableAccessor<T = TableRow> {
-    find(query?: TableQuery): Promise<PaginatedResponse<T>>;
-    findOne(rowId: string): Promise<T>;
-    create(data: Partial<T> | Record<string, unknown>): Promise<T>;
-    bulkCreate(rows: Array<Partial<T> | Record<string, unknown>>): Promise<T[]>;
-    update(rowId: string, data: Partial<T> | Record<string, unknown>): Promise<T>;
-    delete(rowId: string, opts?: {
-        force?: boolean;
-    }): Promise<DeleteResult>;
-    bulkDelete(params: BulkDeleteProps): Promise<BulkDeleteResult>;
-    restore(rowId: string): Promise<T>;
-}
-export type TableAccessorFactory = <T = TableRow>(client: SublayHttpClient, tableName: string) => TableAccessor<T>;

package/dist/interfaces/User.d.ts

@@ -1,46 +0,0 @@
-import { File } from "./File";
-export type UserRole = "admin" | "moderator" | "visitor";
-export type UserFull = {
-    id: string;
-    projectId: string;
-    foreignId: string | null;
-    role: UserRole;
-    email: string | null;
-    name: string | null;
-    username: string | null;
-    avatar: string | null;
-    avatarFileId: string | null;
-    bannerFileId: string | null;
-    avatarFile?: File | null;
-    bannerFile?: File | null;
-    bio: string | null;
-    birthdate: string | null;
-    location: {
-        type: "Point";
-        coordinates: [number, number];
-    } | null;
-    metadata: Record<string, any>;
-    secureMetadata: Record<string, any>;
-    reputation: number;
-    /**
-     * Space-scoped reputation, present only when the request opted in via
-     * `spaceReputationId` (and the project has the reputation bundle). It is the
-     * user's reputation within the requested space context — see
-     * {@link SpaceReputationContextParams} / {@link SpaceReputationUserParams}.
-     */
-    spaceReputation?: number;
-    isVerified: boolean;
-    isActive: boolean;
-    lastActive: string;
-    createdAt: string;
-    updatedAt: string;
-};
-export type AuthUser = Omit<UserFull, "secureMetadata"> & {
-    suspensions: {
-        reason: string | null;
-        startDate: string;
-        endDate: string | null;
-    }[];
-    authMethods: string[];
-};
-export type User = Omit<UserFull, "email" | "secureMetadata" | "isVerified" | "isActive" | "lastActive" | "updatedAt">;

package/dist/interfaces/UserSearch.d.ts

@@ -1,13 +0,0 @@
-/**
- * Shared optional params for text-searching a list of users
- * (followers / following / connections).
- *
- * - `query` — free-text search term. When omitted, no filtering is applied.
- * - `searchFields` — narrows which user field the term matches against. When
- *   omitted, the term matches either `username` OR `name` (case-insensitive
- *   substring). `"username"` / `"name"` restrict the match to that one field.
- */
-export interface UserSearchParams {
-    query?: string;
-    searchFields?: "username" | "name";
-}