@objectstack/client 4.0.5 → 4.1.1

package/dist/index.d.mts

@@ -676,6 +676,92 @@ declare class ObjectStackClient {
         updateHostname: (id: string, hostname: string) => Promise<{
             project: any;
         }>;
+        /**
+         * Update the visibility of this project ('private' | 'public').
+         * `private` (default) hides the project from /pub/v1 enumeration but
+         * still allows anonymous artifact downloads when the URL includes an
+         * exact `?commit=<id>` (share-by-link). `public` lists the project and
+         * freely exposes all revisions.
+         */
+        updateVisibility: (id: string, visibility: "private" | "public") => Promise<{
+            project: any;
+        }>;
+        /**
+         * List published artifact revisions for a project. Each revision has
+         * an immutable commitId (content-addressable) and storage_key.
+         * Optional `branch` filter narrows to a single logical branch
+         * (default branch `main` also matches rows with NULL `branch`).
+         */
+        listRevisions: (id: string, opts?: {
+            limit?: number;
+            cursor?: string;
+            branch?: string;
+        }) => Promise<{
+            items: Array<{
+                commitId: string;
+                checksum: string;
+                storageKey: string;
+                sizeBytes: number;
+                builtAt: string;
+                publishedAt: string;
+                publishedBy: string | null;
+                note: string | null;
+                isCurrent: boolean;
+                branch: string;
+                isBranchHead: boolean;
+            }>;
+            nextCursor: string | null;
+            branch: string | null;
+        }>;
+        /**
+         * List logical branches for a project. Each branch has a head commit
+         * (latest published revision on that branch) and a count of revisions.
+         * Branches without a head row (e.g. all rows demoted) are omitted.
+         */
+        listBranches: (id: string) => Promise<{
+            projectId: string;
+            branches: Array<{
+                branch: string;
+                headCommitId: string;
+                headRevisionId: string;
+                revisionCount: number;
+                headPublishedAt: string | null;
+                headNote: string | null;
+                isCurrent: boolean;
+            }>;
+        }>;
+        /**
+         * Rename a branch. Updates every revision row in `from` to `to`.
+         * 409 if `to` already has rows.
+         */
+        renameBranch: (id: string, from: string, to: string) => Promise<{
+            projectId: string;
+            from: string;
+            to: string;
+            renamed: number;
+        }>;
+        /**
+         * Delete (demote) a branch. Soft-removal — clears `is_branch_head` on
+         * every row in this branch; the revisions themselves remain. The
+         * `main` branch and any branch carrying the active revision cannot be
+         * deleted.
+         */
+        deleteBranch: (id: string, name: string) => Promise<{
+            projectId: string;
+            branch: string;
+            demoted: number;
+            totalRevisions: number;
+        }>;
+        /**
+         * Activate (rollback to) a previously-published revision by commit id.
+         * Marks the target revision is_current=true and demotes the prior one.
+         */
+        activateRevision: (id: string, commitId: string) => Promise<{
+            projectId: string;
+            commitId: string;
+            activated: boolean;
+            previousCommitId: string | null;
+        }>;
         /**
          * Retry provisioning for a project stuck in `failed` (or
          * `provisioning`) state. The server re-runs the driver handshake; on
@@ -691,6 +777,35 @@ declare class ObjectStackClient {
         listMembers: (id: string) => Promise<{
             members: any[];
         }>;
+        /**
+         * Invite a member to a project. Caller must be `owner` or `admin`.
+         * Pass either `email` (resolved against the user table) or `user_id`.
+         * Returns `{ member, alreadyMember }` — `alreadyMember=true` means the
+         * row already existed; the call is idempotent.
+         */
+        addMember: (id: string, payload: {
+            email?: string;
+            user_id?: string;
+            role?: "owner" | "admin" | "member" | "viewer";
+        }) => Promise<{
+            member: any;
+            alreadyMember: boolean;
+        }>;
+        /**
+         * Update a member's role. Caller must be `owner` or `admin`. Demoting
+         * the last `owner` returns 409.
+         */
+        updateMemberRole: (id: string, memberId: string, role: "owner" | "admin" | "member" | "viewer") => Promise<{
+            member: any;
+        }>;
+        /**
+         * Remove a member. Owners/admins may remove anyone; non-privileged
+         * users may only remove themselves. Removing the last `owner` returns 409.
+         */
+        removeMember: (id: string, memberId: string) => Promise<{
+            removed: boolean;
+            memberId: string;
+        }>;
         /**
          * List ObjectQL drivers registered on the server. Useful for populating a
          * driver selector when provisioning a new project (memory / turso /

package/dist/index.d.ts

@@ -676,6 +676,92 @@ declare class ObjectStackClient {
         updateHostname: (id: string, hostname: string) => Promise<{
             project: any;
         }>;
+        /**
+         * Update the visibility of this project ('private' | 'public').
+         * `private` (default) hides the project from /pub/v1 enumeration but
+         * still allows anonymous artifact downloads when the URL includes an
+         * exact `?commit=<id>` (share-by-link). `public` lists the project and
+         * freely exposes all revisions.
+         */
+        updateVisibility: (id: string, visibility: "private" | "public") => Promise<{
+            project: any;
+        }>;
+        /**
+         * List published artifact revisions for a project. Each revision has
+         * an immutable commitId (content-addressable) and storage_key.
+         * Optional `branch` filter narrows to a single logical branch
+         * (default branch `main` also matches rows with NULL `branch`).
+         */
+        listRevisions: (id: string, opts?: {
+            limit?: number;
+            cursor?: string;
+            branch?: string;
+        }) => Promise<{
+            items: Array<{
+                commitId: string;
+                checksum: string;
+                storageKey: string;
+                sizeBytes: number;
+                builtAt: string;
+                publishedAt: string;
+                publishedBy: string | null;
+                note: string | null;
+                isCurrent: boolean;
+                branch: string;
+                isBranchHead: boolean;
+            }>;
+            nextCursor: string | null;
+            branch: string | null;
+        }>;
+        /**
+         * List logical branches for a project. Each branch has a head commit
+         * (latest published revision on that branch) and a count of revisions.
+         * Branches without a head row (e.g. all rows demoted) are omitted.
+         */
+        listBranches: (id: string) => Promise<{
+            projectId: string;
+            branches: Array<{
+                branch: string;
+                headCommitId: string;
+                headRevisionId: string;
+                revisionCount: number;
+                headPublishedAt: string | null;
+                headNote: string | null;
+                isCurrent: boolean;
+            }>;
+        }>;
+        /**
+         * Rename a branch. Updates every revision row in `from` to `to`.
+         * 409 if `to` already has rows.
+         */
+        renameBranch: (id: string, from: string, to: string) => Promise<{
+            projectId: string;
+            from: string;
+            to: string;
+            renamed: number;
+        }>;
+        /**
+         * Delete (demote) a branch. Soft-removal — clears `is_branch_head` on
+         * every row in this branch; the revisions themselves remain. The
+         * `main` branch and any branch carrying the active revision cannot be
+         * deleted.
+         */
+        deleteBranch: (id: string, name: string) => Promise<{
+            projectId: string;
+            branch: string;
+            demoted: number;
+            totalRevisions: number;
+        }>;
+        /**
+         * Activate (rollback to) a previously-published revision by commit id.
+         * Marks the target revision is_current=true and demotes the prior one.
+         */
+        activateRevision: (id: string, commitId: string) => Promise<{
+            projectId: string;
+            commitId: string;
+            activated: boolean;
+            previousCommitId: string | null;
+        }>;
         /**
          * Retry provisioning for a project stuck in `failed` (or
          * `provisioning`) state. The server re-runs the driver handshake; on
@@ -691,6 +777,35 @@ declare class ObjectStackClient {
         listMembers: (id: string) => Promise<{
             members: any[];
         }>;
+        /**
+         * Invite a member to a project. Caller must be `owner` or `admin`.
+         * Pass either `email` (resolved against the user table) or `user_id`.
+         * Returns `{ member, alreadyMember }` — `alreadyMember=true` means the
+         * row already existed; the call is idempotent.
+         */
+        addMember: (id: string, payload: {
+            email?: string;
+            user_id?: string;
+            role?: "owner" | "admin" | "member" | "viewer";
+        }) => Promise<{
+            member: any;
+            alreadyMember: boolean;
+        }>;
+        /**
+         * Update a member's role. Caller must be `owner` or `admin`. Demoting
+         * the last `owner` returns 409.
+         */
+        updateMemberRole: (id: string, memberId: string, role: "owner" | "admin" | "member" | "viewer") => Promise<{
+            member: any;
+        }>;
+        /**
+         * Remove a member. Owners/admins may remove anyone; non-privileged
+         * users may only remove themselves. Removing the last `owner` returns 409.
+         */
+        removeMember: (id: string, memberId: string) => Promise<{
+            removed: boolean;
+            memberId: string;
+        }>;
         /**
          * List ObjectQL drivers registered on the server. Useful for populating a
          * driver selector when provisioning a new project (memory / turso /

package/dist/index.js

@@ -766,6 +766,87 @@ var ObjectStackClient = class {
         });
         return this.unwrapResponse(res);
       },
+      /**
+       * Update the visibility of this project ('private' | 'public').
+       * `private` (default) hides the project from /pub/v1 enumeration but
+       * still allows anonymous artifact downloads when the URL includes an
+       * exact `?commit=<id>` (share-by-link). `public` lists the project and
+       * freely exposes all revisions.
+       */
+      updateVisibility: async (id, visibility) => {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}`, {
+          method: "PATCH",
+          body: JSON.stringify({ visibility })
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * List published artifact revisions for a project. Each revision has
+       * an immutable commitId (content-addressable) and storage_key.
+       * Optional `branch` filter narrows to a single logical branch
+       * (default branch `main` also matches rows with NULL `branch`).
+       */
+      listRevisions: async (id, opts) => {
+        const params = new URLSearchParams();
+        if (opts?.limit) params.set("limit", String(opts.limit));
+        if (opts?.cursor) params.set("cursor", opts.cursor);
+        if (opts?.branch) params.set("branch", opts.branch);
+        const qs = params.toString();
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/revisions${qs ? `?${qs}` : ""}`
+        );
+        return this.unwrapResponse(res);
+      },
+      /**
+       * List logical branches for a project. Each branch has a head commit
+       * (latest published revision on that branch) and a count of revisions.
+       * Branches without a head row (e.g. all rows demoted) are omitted.
+       */
+      listBranches: async (id) => {
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/branches`
+        );
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Rename a branch. Updates every revision row in `from` to `to`.
+       * 409 if `to` already has rows.
+       */
+      renameBranch: async (id, from, to) => {
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/branches/${encodeURIComponent(from)}/rename`,
+          {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ newName: to })
+          }
+        );
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Delete (demote) a branch. Soft-removal — clears `is_branch_head` on
+       * every row in this branch; the revisions themselves remain. The
+       * `main` branch and any branch carrying the active revision cannot be
+       * deleted.
+       */
+      deleteBranch: async (id, name) => {
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/branches/${encodeURIComponent(name)}`,
+          { method: "DELETE" }
+        );
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Activate (rollback to) a previously-published revision by commit id.
+       * Marks the target revision is_current=true and demotes the prior one.
+       */
+      activateRevision: async (id, commitId) => {
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/revisions/${encodeURIComponent(commitId)}/activate`,
+          { method: "POST" }
+        );
+        return this.unwrapResponse(res);
+      },
       /**
        * Retry provisioning for a project stuck in `failed` (or
        * `provisioning`) state. The server re-runs the driver handshake; on
@@ -785,6 +866,46 @@ var ObjectStackClient = class {
         const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members`);
         return this.unwrapResponse(res);
       },
+      /**
+       * Invite a member to a project. Caller must be `owner` or `admin`.
+       * Pass either `email` (resolved against the user table) or `user_id`.
+       * Returns `{ member, alreadyMember }` — `alreadyMember=true` means the
+       * row already existed; the call is idempotent.
+       */
+      addMember: async (id, payload) => {
+        const res = await this.fetch(`${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members`, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(payload)
+        });
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Update a member's role. Caller must be `owner` or `admin`. Demoting
+       * the last `owner` returns 409.
+       */
+      updateMemberRole: async (id, memberId, role) => {
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members/${encodeURIComponent(memberId)}`,
+          {
+            method: "PATCH",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ role })
+          }
+        );
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Remove a member. Owners/admins may remove anyone; non-privileged
+       * users may only remove themselves. Removing the last `owner` returns 409.
+       */
+      removeMember: async (id, memberId) => {
+        const res = await this.fetch(
+          `${this.baseUrl}/api/v1/cloud/projects/${encodeURIComponent(id)}/members/${encodeURIComponent(memberId)}`,
+          { method: "DELETE" }
+        );
+        return this.unwrapResponse(res);
+      },
       /**
        * List ObjectQL drivers registered on the server. Useful for populating a
        * driver selector when provisioning a new project (memory / turso /
@@ -2791,7 +2912,7 @@ var ObjectStackClient = class {
         status: res.status,
         error: errorBody
       });
-      const errorMessage = errorBody?.message || errorBody?.error?.message || res.statusText;
+      const errorMessage = errorBody?.message ?? errorBody?.error?.message ?? (typeof errorBody?.error === "string" ? errorBody.error : void 0) ?? res.statusText;
       const errorCode = errorBody?.code || errorBody?.error?.code;
       const error = new Error(`[ObjectStack] ${errorCode ? `${errorCode}: ` : ""}${errorMessage}`);
       error.code = errorCode;