@agentuity/auth 0.0.108 → 0.0.110

package/dist/agentuity/plugins/organization.d.ts

@@ -0,0 +1,355 @@
+/**
+ * Organization plugin API types for @agentuity/auth.
+ *
+ * Server-side API methods for organization management provided by BetterAuth's
+ * organization plugin. Includes multi-tenancy support, member management,
+ * invitations, and access control.
+ *
+ * @see https://better-auth.com/docs/plugins/organization
+ * @module agentuity/plugins/organization
+ */
+/**
+ * Organization data returned from API calls.
+ */
+export interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+    logo?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt?: Date;
+}
+/**
+ * Member data within an organization.
+ */
+export interface OrganizationMember {
+    id: string;
+    userId: string;
+    organizationId: string;
+    role: string;
+    createdAt?: Date;
+    user?: {
+        id: string;
+        name?: string | null;
+        email: string;
+        image?: string | null;
+    };
+}
+/**
+ * Invitation data for organization invites.
+ */
+export interface OrganizationInvitation {
+    id: string;
+    email: string;
+    role: string;
+    organizationId: string;
+    inviterId: string;
+    status: 'pending' | 'accepted' | 'rejected' | 'canceled';
+    expiresAt: Date;
+    createdAt?: Date;
+    organization?: Organization;
+    inviter?: {
+        id: string;
+        name?: string | null;
+        email: string;
+    };
+}
+/**
+ * Server-side API methods for organization management.
+ *
+ * These methods are added by the BetterAuth organization plugin and provide
+ * multi-tenancy support including creating organizations, managing members,
+ * and handling invitations.
+ *
+ * @see https://better-auth.com/docs/plugins/organization
+ */
+export interface OrganizationApiMethods {
+    /**
+     * Create a new organization.
+     *
+     * The creator becomes the owner by default. If session headers are provided,
+     * the organization is created for the authenticated user. If `userId` is
+     * provided without headers (server-side only), it creates for that user.
+     */
+    createOrganization: (params: {
+        body: {
+            name: string;
+            slug: string;
+            logo?: string;
+            metadata?: Record<string, unknown>;
+            userId?: string;
+            keepCurrentActiveOrganization?: boolean;
+        };
+        headers?: Headers;
+    }) => Promise<Organization>;
+    /**
+     * List all organizations the user is a member of.
+     */
+    listOrganizations: (params: {
+        headers?: Headers;
+    }) => Promise<Organization[]>;
+    /**
+     * Get full organization details including members.
+     *
+     * By default uses the active organization. Pass `organizationId` or
+     * `organizationSlug` to get a specific organization.
+     */
+    getFullOrganization: (params: {
+        query?: {
+            organizationId?: string;
+            organizationSlug?: string;
+            membersLimit?: number;
+        };
+        headers?: Headers;
+    }) => Promise<(Organization & {
+        members?: OrganizationMember[];
+    }) | null>;
+    /**
+     * Set the active organization for the current session.
+     *
+     * Pass `organizationId: null` to unset the active organization.
+     */
+    setActiveOrganization: (params: {
+        body: {
+            organizationId: string | null;
+            organizationSlug?: string;
+        };
+        headers?: Headers;
+    }) => Promise<Organization | null>;
+    /**
+     * Update organization details.
+     *
+     * Requires appropriate permissions (typically owner or admin role).
+     */
+    updateOrganization: (params: {
+        body: {
+            organizationId?: string;
+            data: {
+                name?: string;
+                slug?: string;
+                logo?: string | null;
+                metadata?: Record<string, unknown> | null;
+            };
+        };
+        headers?: Headers;
+    }) => Promise<Organization>;
+    /**
+     * Delete an organization.
+     *
+     * Requires owner role. All members, invitations, and organization data
+     * will be removed.
+     */
+    deleteOrganization: (params: {
+        body: {
+            organizationId: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Check if an organization slug is available.
+     */
+    checkOrganizationSlug: (params: {
+        body: {
+            slug: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        status: boolean;
+    }>;
+    /**
+     * Create an invitation to join an organization.
+     *
+     * Sends an invitation email to the specified address. The user can then
+     * accept or reject the invitation.
+     */
+    createInvitation: (params: {
+        body: {
+            email: string;
+            role: string | string[];
+            organizationId?: string;
+            resend?: boolean;
+            teamId?: string;
+        };
+        headers?: Headers;
+    }) => Promise<OrganizationInvitation>;
+    /**
+     * Get details of a specific invitation.
+     */
+    getInvitation: (params: {
+        query: {
+            id: string;
+        };
+        headers?: Headers;
+    }) => Promise<OrganizationInvitation | null>;
+    /**
+     * List all invitations for an organization.
+     *
+     * Defaults to the active organization if `organizationId` is not provided.
+     */
+    listInvitations: (params: {
+        query?: {
+            organizationId?: string;
+        };
+        headers?: Headers;
+    }) => Promise<OrganizationInvitation[]>;
+    /**
+     * List all pending invitations for the current user.
+     *
+     * On the server, you can pass `email` to query for a specific user's invitations.
+     */
+    listUserInvitations: (params: {
+        query?: {
+            email?: string;
+        };
+        headers?: Headers;
+    }) => Promise<OrganizationInvitation[]>;
+    /**
+     * Accept an invitation to join an organization.
+     *
+     * The user must be authenticated. After accepting, they become a member
+     * of the organization with the role specified in the invitation.
+     */
+    acceptInvitation: (params: {
+        body: {
+            invitationId: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+        member?: OrganizationMember;
+    }>;
+    /**
+     * Reject an invitation to join an organization.
+     */
+    rejectInvitation: (params: {
+        body: {
+            invitationId: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Cancel a pending invitation.
+     *
+     * Typically used by organization admins to revoke an invitation.
+     */
+    cancelInvitation: (params: {
+        body: {
+            invitationId: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * List all members of an organization.
+     *
+     * Supports pagination, sorting, and filtering.
+     */
+    listMembers: (params: {
+        query?: {
+            organizationId?: string;
+            limit?: number;
+            offset?: number;
+            sortBy?: string;
+            sortDirection?: 'asc' | 'desc';
+            filterField?: string;
+            filterOperator?: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'contains';
+            filterValue?: string;
+        };
+        headers?: Headers;
+    }) => Promise<OrganizationMember[]>;
+    /**
+     * Add a member directly to an organization (server-only).
+     *
+     * Unlike invitations, this immediately adds the user as a member.
+     * Typically used for admin scripts, migrations, or automated onboarding.
+     */
+    addMember: (params: {
+        body: {
+            userId?: string | null;
+            role: string | string[];
+            organizationId?: string;
+            teamId?: string;
+        };
+        headers?: Headers;
+    }) => Promise<OrganizationMember>;
+    /**
+     * Remove a member from an organization.
+     */
+    removeMember: (params: {
+        body: {
+            memberIdOrEmail: string;
+            organizationId?: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Update a member's role in an organization.
+     */
+    updateMemberRole: (params: {
+        body: {
+            memberId: string;
+            role: string | string[];
+            organizationId?: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get the current user's member record in the active organization.
+     */
+    getActiveMember: (params: {
+        headers?: Headers;
+    }) => Promise<OrganizationMember | null>;
+    /**
+     * Get the current user's role in the active organization.
+     */
+    getActiveMemberRole: (params: {
+        headers?: Headers;
+    }) => Promise<{
+        role: string | null;
+    }>;
+    /**
+     * Leave an organization.
+     *
+     * The current user will be removed from the organization.
+     */
+    leaveOrganization: (params: {
+        body: {
+            organizationId: string;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Check if the current user has specific permissions.
+     *
+     * Works with BetterAuth's access control system. The permissions object
+     * maps resources to arrays of required actions.
+     *
+     * @example
+     * ```typescript
+     * const result = await auth.api.hasPermission({
+     *   body: { permissions: { project: ['create', 'update'] } },
+     *   headers,
+     * });
+     * ```
+     */
+    hasPermission: (params: {
+        body: {
+            permissions: Record<string, string[]>;
+        };
+        headers?: Headers;
+    }) => Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=organization.d.ts.map

package/dist/agentuity/plugins/organization.d.ts.map

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

package/dist/agentuity/plugins/organization.js

@@ -0,0 +1,12 @@
+/**
+ * Organization plugin API types for @agentuity/auth.
+ *
+ * Server-side API methods for organization management provided by BetterAuth's
+ * organization plugin. Includes multi-tenancy support, member management,
+ * invitations, and access control.
+ *
+ * @see https://better-auth.com/docs/plugins/organization
+ * @module agentuity/plugins/organization
+ */
+export {};
+//# sourceMappingURL=organization.js.map

package/dist/agentuity/plugins/organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.js","sourceRoot":"","sources":["../../../src/agentuity/plugins/organization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}