@lifestreamdynamics/vault-sdk 1.0.0

package/dist/resources/teams.js

@@ -0,0 +1,395 @@
+import { handleError } from '../handle-error.js';
+/**
+ * Resource for managing teams, members, invitations, and team vaults.
+ *
+ * Teams allow users to collaborate on shared vaults with role-based access
+ * control. Team members can be owners, admins, or regular members.
+ *
+ * @example
+ * ```typescript
+ * const teams = await client.teams.list();
+ * const team = await client.teams.create({ name: 'Engineering' });
+ * const members = await client.teams.listMembers(team.id);
+ * ```
+ */
+export class TeamsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    // ── Team CRUD ──────────────────────────────────────────────────────
+    /**
+     * Lists all teams the authenticated user belongs to.
+     *
+     * @returns Array of team objects
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const teams = await client.teams.list();
+     * for (const team of teams) {
+     *   console.log(team.name);
+     * }
+     * ```
+     */
+    async list() {
+        try {
+            const data = await this.http.get('teams').json();
+            return data.teams;
+        }
+        catch (error) {
+            throw await handleError(error, 'Teams', '');
+        }
+    }
+    /**
+     * Retrieves a single team by ID.
+     *
+     * @param teamId - The unique identifier of the team
+     * @returns The team object
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user is not a member of the team
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const team = await client.teams.get('team-uuid');
+     * console.log(team.name, team.description);
+     * ```
+     */
+    async get(teamId) {
+        try {
+            return await this.http.get(`teams/${teamId}`).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+    /**
+     * Creates a new team. The authenticated user becomes the team owner.
+     *
+     * @param params - Team creation parameters
+     * @param params.name - Display name for the team (required)
+     * @param params.description - Optional description of the team's purpose
+     * @returns The newly created team object
+     * @throws {ValidationError} If the name is empty or invalid
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const team = await client.teams.create({
+     *   name: 'Engineering',
+     *   description: 'Backend and frontend engineering team',
+     * });
+     * console.log(team.id);
+     * ```
+     */
+    async create(params) {
+        try {
+            return await this.http.post('teams', { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', params.name);
+        }
+    }
+    /**
+     * Updates an existing team's metadata. Requires admin or owner role.
+     *
+     * Only the provided fields are modified; omitted fields remain unchanged.
+     *
+     * @param teamId - The unique identifier of the team to update
+     * @param params - Fields to update
+     * @param params.name - New display name for the team
+     * @param params.description - New description, or `null` to clear
+     * @returns The updated team object
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user lacks admin/owner role
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.teams.update('team-uuid', {
+     *   name: 'Platform Engineering',
+     * });
+     * ```
+     */
+    async update(teamId, params) {
+        try {
+            return await this.http.patch(`teams/${teamId}`, { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+    /**
+     * Permanently deletes a team. Only the team owner can delete a team.
+     *
+     * This removes all memberships, invitations, and team vault associations.
+     *
+     * @param teamId - The unique identifier of the team to delete
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user is not the team owner
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.teams.delete('team-uuid');
+     * ```
+     */
+    async delete(teamId) {
+        try {
+            await this.http.delete(`teams/${teamId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+    // ── Members ────────────────────────────────────────────────────────
+    /**
+     * Lists all members of a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @returns Array of team member objects with user details
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user is not a member of the team
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const members = await client.teams.listMembers('team-uuid');
+     * for (const member of members) {
+     *   console.log(member.user.email, member.role);
+     * }
+     * ```
+     */
+    async listMembers(teamId) {
+        try {
+            const data = await this.http.get(`teams/${teamId}/members`).json();
+            return data.members;
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+    /**
+     * Updates a team member's role. Requires admin or owner role.
+     *
+     * Cannot change the owner's role. Admins cannot promote others to owner.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param userId - The user ID of the member to update
+     * @param role - The new role to assign (`'admin'` or `'member'`)
+     * @returns The updated team member object
+     * @throws {NotFoundError} If the team or member is not found
+     * @throws {AuthorizationError} If the user lacks permission to change roles
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const member = await client.teams.updateMemberRole('team-uuid', 'user-uuid', 'admin');
+     * console.log(member.role); // 'admin'
+     * ```
+     */
+    async updateMemberRole(teamId, userId, role) {
+        try {
+            return await this.http.patch(`teams/${teamId}/members/${userId}`, { json: { role } }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Team member', userId);
+        }
+    }
+    /**
+     * Removes a member from a team. Requires admin or owner role.
+     *
+     * The team owner cannot be removed.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param userId - The user ID of the member to remove
+     * @throws {NotFoundError} If the team or member is not found
+     * @throws {AuthorizationError} If the user lacks permission or is trying to remove the owner
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.teams.removeMember('team-uuid', 'user-uuid');
+     * ```
+     */
+    async removeMember(teamId, userId) {
+        try {
+            await this.http.delete(`teams/${teamId}/members/${userId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'Team member', userId);
+        }
+    }
+    /**
+     * Leaves a team. The authenticated user removes themselves from the team.
+     *
+     * The team owner cannot leave; they must delete the team or transfer ownership first.
+     *
+     * @param teamId - The unique identifier of the team to leave
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user is the team owner
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.teams.leave('team-uuid');
+     * ```
+     */
+    async leave(teamId) {
+        try {
+            await this.http.post(`teams/${teamId}/members/leave`);
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+    // ── Invitations ────────────────────────────────────────────────────
+    /**
+     * Invites a user to join a team by email. Requires admin or owner role.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param email - Email address of the user to invite
+     * @param role - Role to assign upon acceptance (`'admin'` or `'member'`)
+     * @returns The created invitation object
+     * @throws {ValidationError} If the email is invalid or the user is already a member
+     * @throws {AuthorizationError} If the user lacks admin/owner role
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const invitation = await client.teams.inviteMember(
+     *   'team-uuid',
+     *   'colleague@example.com',
+     *   'member',
+     * );
+     * console.log(invitation.expiresAt);
+     * ```
+     */
+    async inviteMember(teamId, email, role) {
+        try {
+            return await this.http.post(`teams/${teamId}/invitations`, { json: { email, role } }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Team invitation', email);
+        }
+    }
+    /**
+     * Lists all pending invitations for a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @returns Array of pending invitation objects
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user is not a member of the team
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const invitations = await client.teams.listInvitations('team-uuid');
+     * for (const inv of invitations) {
+     *   console.log(inv.email, inv.role, inv.expiresAt);
+     * }
+     * ```
+     */
+    async listInvitations(teamId) {
+        try {
+            const data = await this.http.get(`teams/${teamId}/invitations`).json();
+            return data.invitations;
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+    /**
+     * Revokes a pending invitation. Requires admin or owner role.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param invitationId - The unique identifier of the invitation to revoke
+     * @throws {NotFoundError} If the team or invitation is not found
+     * @throws {AuthorizationError} If the user lacks admin/owner role
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.teams.revokeInvitation('team-uuid', 'invitation-uuid');
+     * ```
+     */
+    async revokeInvitation(teamId, invitationId) {
+        try {
+            await this.http.delete(`teams/${teamId}/invitations/${invitationId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'Team invitation', invitationId);
+        }
+    }
+    // ── Team Vaults ────────────────────────────────────────────────────
+    /**
+     * Creates a new vault under a team. Requires editor role or above.
+     *
+     * @param teamId - The unique identifier of the team
+     * @param params - Vault creation parameters
+     * @param params.name - Display name for the vault (required)
+     * @param params.description - Optional description of the vault's purpose
+     * @returns The newly created vault object
+     * @throws {ValidationError} If the name is empty or the slug conflicts
+     * @throws {AuthorizationError} If the user lacks the required team role
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const vault = await client.teams.createVault('team-uuid', {
+     *   name: 'Shared Docs',
+     *   description: 'Team documentation',
+     * });
+     * ```
+     */
+    async createVault(teamId, params) {
+        try {
+            return await this.http.post(`teams/${teamId}/vaults`, { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Team vault', params.name);
+        }
+    }
+    /**
+     * Lists all vaults belonging to a team.
+     *
+     * @param teamId - The unique identifier of the team
+     * @returns Array of vault objects
+     * @throws {NotFoundError} If no team exists with the given ID
+     * @throws {AuthorizationError} If the user is not a member of the team
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const vaults = await client.teams.listVaults('team-uuid');
+     * for (const vault of vaults) {
+     *   console.log(vault.name);
+     * }
+     * ```
+     */
+    async listVaults(teamId) {
+        try {
+            const data = await this.http.get(`teams/${teamId}/vaults`).json();
+            return data.vaults;
+        }
+        catch (error) {
+            throw await handleError(error, 'Team', teamId);
+        }
+    }
+}
+//# sourceMappingURL=teams.js.map

package/dist/resources/teams.js.map

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

package/dist/resources/user.d.ts

@@ -0,0 +1,92 @@
+import type { KyInstance } from 'ky';
+/** The authenticated user's profile. */
+export interface User {
+    /** Unique user identifier. */
+    id: string;
+    /** User email address. */
+    email: string;
+    /** Display name, if set. */
+    name: string | null;
+    /** User role (`user` or `admin`). */
+    role: string;
+    /** Current subscription tier (`free`, `pro`, or `business`). */
+    subscriptionTier: string;
+    /** ISO 8601 subscription expiry timestamp, or `null` for free tier. */
+    subscriptionExpiresAt: string | null;
+    /** ISO 8601 account creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: string;
+}
+/** Per-vault storage breakdown entry. */
+export interface VaultStorage {
+    /** Vault identifier. */
+    vaultId: string;
+    /** Vault display name. */
+    name: string;
+    /** Total bytes used by documents in this vault. */
+    bytes: number;
+    /** Number of documents in this vault. */
+    documentCount: number;
+}
+/** Storage usage statistics for the authenticated user. */
+export interface StorageUsage {
+    /** Total bytes used across all vaults. */
+    totalBytes: number;
+    /** Maximum bytes allowed by the user's plan. */
+    limitBytes: number;
+    /** Per-vault storage breakdown. */
+    vaults: VaultStorage[];
+    /** Total number of vaults. */
+    vaultCount: number;
+    /** Maximum number of vaults allowed by the user's plan. */
+    vaultLimit: number;
+    /** Current subscription tier. */
+    tier: string;
+}
+/**
+ * Resource for retrieving user profile and storage information.
+ *
+ * @example
+ * ```typescript
+ * const user = await client.user.me();
+ * console.log(user.email, user.subscriptionTier);
+ *
+ * const storage = await client.user.getStorage();
+ * console.log(`${storage.totalBytes}/${storage.limitBytes} bytes used`);
+ * ```
+ */
+export declare class UserResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Retrieves the current authenticated user's profile.
+     *
+     * @returns User profile object
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const user = await client.user.me();
+     * console.log(user.email, user.subscriptionTier);
+     * ```
+     */
+    me(): Promise<User>;
+    /**
+     * Retrieves storage usage breakdown for the current user.
+     *
+     * @returns Storage usage statistics including per-vault breakdown
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const storage = await client.user.getStorage();
+     * console.log(`Using ${storage.totalBytes}/${storage.limitBytes} bytes`);
+     * storage.vaults.forEach(v => console.log(`${v.name}: ${v.bytes} bytes`));
+     * ```
+     */
+    getStorage(): Promise<StorageUsage>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/resources/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/resources/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,wCAAwC;AACxC,MAAM,WAAW,IAAI;IACnB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;OAYG;IACG,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IASzB;;;;;;;;;;;;;OAaG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;CAO1C"}

package/dist/resources/user.js

@@ -0,0 +1,64 @@
+import { handleError } from '../handle-error.js';
+/**
+ * Resource for retrieving user profile and storage information.
+ *
+ * @example
+ * ```typescript
+ * const user = await client.user.me();
+ * console.log(user.email, user.subscriptionTier);
+ *
+ * const storage = await client.user.getStorage();
+ * console.log(`${storage.totalBytes}/${storage.limitBytes} bytes used`);
+ * ```
+ */
+export class UserResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Retrieves the current authenticated user's profile.
+     *
+     * @returns User profile object
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const user = await client.user.me();
+     * console.log(user.email, user.subscriptionTier);
+     * ```
+     */
+    async me() {
+        try {
+            const data = await this.http.get('users/me').json();
+            return data.user;
+        }
+        catch (error) {
+            throw await handleError(error, 'User', '');
+        }
+    }
+    /**
+     * Retrieves storage usage breakdown for the current user.
+     *
+     * @returns Storage usage statistics including per-vault breakdown
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const storage = await client.user.getStorage();
+     * console.log(`Using ${storage.totalBytes}/${storage.limitBytes} bytes`);
+     * storage.vaults.forEach(v => console.log(`${v.name}: ${v.bytes} bytes`));
+     * ```
+     */
+    async getStorage() {
+        try {
+            return await this.http.get('users/me/storage').json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Storage', '');
+        }
+    }
+}
+//# sourceMappingURL=user.js.map

package/dist/resources/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/resources/user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkDjD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE;QACN,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,EAAkB,CAAC;YACpE,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAgB,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}