@typeb-digital/nucleus-sdk 0.0.6 → 0.1.0

package/dist/es/index.d.ts

@@ -40,6 +40,7 @@ type EmployeeIdentity = {
     jobTitle: string | null;
     department: string | null;
     employmentStatus: string;
+    employmentType: string | null;
     isExternal: boolean;
 };
 type EmployeeContact = {
@@ -76,6 +77,7 @@ type EmployeeCompensation = {
         hourlyBillableRate: number | null;
         monthlyCostRate: number | null;
         monthlyBillableRate: number | null;
+        salary: number | null;
         currencyCode: string;
         effectiveFrom: string;
     } | null;
@@ -86,6 +88,7 @@ type EmployeeCompensationHistory = {
         hourlyBillableRate: number | null;
         monthlyCostRate: number | null;
         monthlyBillableRate: number | null;
+        salary: number | null;
         currencyCode: string;
         effectiveFrom: string;
         effectiveTo: string | null;
@@ -107,6 +110,9 @@ type ProjectCore = {
     id: string;
     name: string;
     status: string;
+    /** Pipeline lifecycle: opportunity | proposal | won | active | closed. */
+    stage: string;
+    stageChangedAt: string | null;
     colorTag: string | null;
     iconName: string | null;
     startDate: string | null;
@@ -119,12 +125,18 @@ type ProjectTeam = {
     engagementLeadId: string | null;
     memberships: ProjectMembership[];
 };
-type ProjectFinancials = Record<never, never>;
+type ProjectFinancials = {
+    contractValue: number | null;
+    budget: number | null;
+    marginTarget: number | null;
+    financialsCurrency: string | null;
+};
 type ProjectIntegrations = {
     source: string | null;
     clockifyProjectId: string | null;
     clockifyWorkspaceId: string | null;
     apolloDealId: string | null;
+    twentyOpportunityId: string | null;
 };
 type ProjectBucketMap = {
     core: ProjectCore;
@@ -216,25 +228,179 @@ type GenericRateBucketMap = {
     core: GenericRateCore;
     financials: GenericRateFinancials;
 };
+type JurisdictionCore = {
+    id: string;
+    name: string;
+    code: string;
+    country: string | null;
+};
+type JurisdictionBucketMap = {
+    core: JurisdictionCore;
+};
+type LeaveTypeCore = {
+    id: string;
+    name: string;
+    description: string | null;
+    color: string | null;
+    sortOrder: number;
+};
+type LeaveTypeBucketMap = {
+    core: LeaveTypeCore;
+};
+type LeaveCore = {
+    id: string;
+    employeeId: string;
+    leaveTypeId: string;
+    startDate: string;
+    endDate: string;
+    days: number;
+    status: string;
+    source: string;
+};
+type LeaveDetails = {
+    reason: string | null;
+};
+type LeaveBucketMap = {
+    core: LeaveCore;
+    details: LeaveDetails;
+};
+type LeaveBalanceCore = {
+    id: string;
+    employeeId: string;
+    leaveTypeId: string;
+    year: number;
+    balanceDays: number;
+};
+type LeaveBalanceBucketMap = {
+    core: LeaveBalanceCore;
+};
+type PolicyCore = {
+    id: string;
+    title: string;
+    code: string;
+    category: string | null;
+    description: string | null;
+    currentVersion: number;
+    requiresAcknowledgement: boolean;
+    isPublished: boolean;
+};
+type PolicyContent = {
+    body: string | null;
+    fileKey: string | null;
+};
+type PolicyBucketMap = {
+    core: PolicyCore;
+    content: PolicyContent;
+};
+type PolicyAcknowledgementCore = {
+    id: string;
+    policyId: string;
+    employeeId: string;
+    version: number;
+    acknowledgedAt: string;
+};
+type PolicyAcknowledgementBucketMap = {
+    core: PolicyAcknowledgementCore;
+};
+type CalendarEventCore = {
+    id: string;
+    title: string;
+    description: string | null;
+    startDate: string;
+    endDate: string | null;
+    allDay: boolean;
+    type: string;
+    location: string | null;
+    color: string | null;
+    isPublished: boolean;
+};
+type CalendarEventBucketMap = {
+    core: CalendarEventCore;
+};
+type TimesheetCore = {
+    id: string;
+    employeeId: string;
+    projectId: string | null;
+    /** Entry start (Kimai `begin`). ISO 8601. */
+    startTime: string;
+    /** Entry end (Kimai `end`); null while running. ISO 8601. */
+    endTime: string | null;
+    durationMinutes: number;
+    billable: boolean;
+};
+type TimesheetDetails = {
+    description: string | null;
+    activityName: string | null;
+};
+type TimesheetIntegrations = {
+    source: string;
+    kimaiId: string | null;
+    kimaiActivityId: string | null;
+};
+type TimesheetBucketMap = {
+    core: TimesheetCore;
+    details: TimesheetDetails;
+    integrations: TimesheetIntegrations;
+};
+/**
+ * Per-resource scope: which buckets the app may read / create / update, and
+ * whether it may delete (record-level). Mirrors the platform's per-(resource,
+ * bucket, action) authorization. `read` drives the accessor return types;
+ * `create`/`update`/`delete` gate the mutation methods at compile time.
+ */
+type ResourceScope<M> = {
+    read?: readonly (keyof M)[];
+    create?: readonly (keyof M)[];
+    update?: readonly (keyof M)[];
+    delete?: boolean;
+};
 type ScopeDeclaration = {
-    employees?: readonly (keyof EmployeeBucketMap)[];
-    projects?: readonly (keyof ProjectBucketMap)[];
-    clients?: readonly (keyof ClientBucketMap)[];
-    partners?: readonly (keyof PartnerBucketMap)[];
-    departments?: readonly (keyof DepartmentBucketMap)[];
-    projectTypes?: readonly (keyof ProjectTypeBucketMap)[];
-    currencies?: readonly (keyof CurrencyBucketMap)[];
-    genericRates?: readonly (keyof GenericRateBucketMap)[];
+    employees?: ResourceScope<EmployeeBucketMap>;
+    projects?: ResourceScope<ProjectBucketMap>;
+    clients?: ResourceScope<ClientBucketMap>;
+    partners?: ResourceScope<PartnerBucketMap>;
+    departments?: ResourceScope<DepartmentBucketMap>;
+    projectTypes?: ResourceScope<ProjectTypeBucketMap>;
+    currencies?: ResourceScope<CurrencyBucketMap>;
+    genericRates?: ResourceScope<GenericRateBucketMap>;
+    jurisdictions?: ResourceScope<JurisdictionBucketMap>;
+    leaveTypes?: ResourceScope<LeaveTypeBucketMap>;
+    leaves?: ResourceScope<LeaveBucketMap>;
+    leaveBalances?: ResourceScope<LeaveBalanceBucketMap>;
+    policies?: ResourceScope<PolicyBucketMap>;
+    policyAcknowledgements?: ResourceScope<PolicyAcknowledgementBucketMap>;
+    calendarEvents?: ResourceScope<CalendarEventBucketMap>;
+    timesheets?: ResourceScope<TimesheetBucketMap>;
 };
+type ReadOf<RS, M> = RS extends {
+    read: readonly (keyof M)[];
+} ? RS['read'] : readonly [];
+type IfCreate<RS, T> = RS extends {
+    create: readonly [unknown, ...unknown[]];
+} ? T : never;
+type IfUpdate<RS, T> = RS extends {
+    update: readonly [unknown, ...unknown[]];
+} ? T : never;
+type IfDelete<RS, T> = RS extends {
+    delete: true;
+} ? T : never;
 type ResolveBuckets<M, B> = B extends readonly (keyof M)[] ? [B[number]] extends [never] ? NoScope : UnionToIntersection<M[B[number]]> : NoScope;
-type ResolveEmployee<S extends ScopeDeclaration> = ResolveBuckets<EmployeeBucketMap, S['employees']>;
-type ResolveProject<S extends ScopeDeclaration> = ResolveBuckets<ProjectBucketMap, S['projects']>;
-type ResolveClient<S extends ScopeDeclaration> = ResolveBuckets<ClientBucketMap, S['clients']>;
-type ResolvePartner<S extends ScopeDeclaration> = ResolveBuckets<PartnerBucketMap, S['partners']>;
-type ResolveDepartment<S extends ScopeDeclaration> = ResolveBuckets<DepartmentBucketMap, S['departments']>;
-type ResolveProjectType<S extends ScopeDeclaration> = ResolveBuckets<ProjectTypeBucketMap, S['projectTypes']>;
-type ResolveCurrency<S extends ScopeDeclaration> = ResolveBuckets<CurrencyBucketMap, S['currencies']>;
-type ResolveGenericRate<S extends ScopeDeclaration> = ResolveBuckets<GenericRateBucketMap, S['genericRates']>;
+type ResolveEmployee<S extends ScopeDeclaration> = ResolveBuckets<EmployeeBucketMap, ReadOf<S['employees'], EmployeeBucketMap>>;
+type ResolveProject<S extends ScopeDeclaration> = ResolveBuckets<ProjectBucketMap, ReadOf<S['projects'], ProjectBucketMap>>;
+type ResolveClient<S extends ScopeDeclaration> = ResolveBuckets<ClientBucketMap, ReadOf<S['clients'], ClientBucketMap>>;
+type ResolvePartner<S extends ScopeDeclaration> = ResolveBuckets<PartnerBucketMap, ReadOf<S['partners'], PartnerBucketMap>>;
+type ResolveDepartment<S extends ScopeDeclaration> = ResolveBuckets<DepartmentBucketMap, ReadOf<S['departments'], DepartmentBucketMap>>;
+type ResolveProjectType<S extends ScopeDeclaration> = ResolveBuckets<ProjectTypeBucketMap, ReadOf<S['projectTypes'], ProjectTypeBucketMap>>;
+type ResolveCurrency<S extends ScopeDeclaration> = ResolveBuckets<CurrencyBucketMap, ReadOf<S['currencies'], CurrencyBucketMap>>;
+type ResolveGenericRate<S extends ScopeDeclaration> = ResolveBuckets<GenericRateBucketMap, ReadOf<S['genericRates'], GenericRateBucketMap>>;
+type ResolveJurisdiction<S extends ScopeDeclaration> = ResolveBuckets<JurisdictionBucketMap, ReadOf<S['jurisdictions'], JurisdictionBucketMap>>;
+type ResolveLeaveType<S extends ScopeDeclaration> = ResolveBuckets<LeaveTypeBucketMap, ReadOf<S['leaveTypes'], LeaveTypeBucketMap>>;
+type ResolveLeave<S extends ScopeDeclaration> = ResolveBuckets<LeaveBucketMap, ReadOf<S['leaves'], LeaveBucketMap>>;
+type ResolveLeaveBalance<S extends ScopeDeclaration> = ResolveBuckets<LeaveBalanceBucketMap, ReadOf<S['leaveBalances'], LeaveBalanceBucketMap>>;
+type ResolvePolicy<S extends ScopeDeclaration> = ResolveBuckets<PolicyBucketMap, ReadOf<S['policies'], PolicyBucketMap>>;
+type ResolvePolicyAcknowledgement<S extends ScopeDeclaration> = ResolveBuckets<PolicyAcknowledgementBucketMap, ReadOf<S['policyAcknowledgements'], PolicyAcknowledgementBucketMap>>;
+type ResolveCalendarEvent<S extends ScopeDeclaration> = ResolveBuckets<CalendarEventBucketMap, ReadOf<S['calendarEvents'], CalendarEventBucketMap>>;
+type ResolveTimesheet<S extends ScopeDeclaration> = ResolveBuckets<TimesheetBucketMap, ReadOf<S['timesheets'], TimesheetBucketMap>>;
 type EmployeeExpandPath = 'manager' | 'partner';
 type WithEmployeeExpand<T, E extends readonly EmployeeExpandPath[], S extends ScopeDeclaration> = T & ('manager' extends E[number] ? {
     manager: ResolveEmployee<S> | null;
@@ -274,6 +440,173 @@ type PartnerExpandPath = 'employees';
 type WithPartnerExpand<T, E extends readonly PartnerExpandPath[], S extends ScopeDeclaration> = T & ('employees' extends E[number] ? {
     employees: Array<ResolveEmployee<S>>;
 } : unknown);
+type LeaveExpandPath = 'employee' | 'leaveType';
+type WithLeaveExpand<T, E extends readonly LeaveExpandPath[], S extends ScopeDeclaration> = T & ('employee' extends E[number] ? {
+    employee: ResolveEmployee<S> | null;
+} : unknown) & ('leaveType' extends E[number] ? {
+    leaveType: ResolveLeaveType<S> | null;
+} : unknown);
+type LeaveBalanceExpandPath = 'employee' | 'leaveType';
+type WithLeaveBalanceExpand<T, E extends readonly LeaveBalanceExpandPath[], S extends ScopeDeclaration> = T & ('employee' extends E[number] ? {
+    employee: ResolveEmployee<S> | null;
+} : unknown) & ('leaveType' extends E[number] ? {
+    leaveType: ResolveLeaveType<S> | null;
+} : unknown);
+type PolicyAcknowledgementExpandPath = 'employee' | 'policy';
+type WithPolicyAcknowledgementExpand<T, E extends readonly PolicyAcknowledgementExpandPath[], S extends ScopeDeclaration> = T & ('employee' extends E[number] ? {
+    employee: ResolveEmployee<S> | null;
+} : unknown) & ('policy' extends E[number] ? {
+    policy: ResolvePolicy<S> | null;
+} : unknown);
+type TimesheetExpandPath = 'employee' | 'project';
+type WithTimesheetExpand<T, E extends readonly TimesheetExpandPath[], S extends ScopeDeclaration> = T & ('employee' extends E[number] ? {
+    employee: ResolveEmployee<S> | null;
+} : unknown) & ('project' extends E[number] ? {
+    project: ResolveProject<S> | null;
+} : unknown);
+type LeaveCreateInput = {
+    employeeId: string;
+    leaveTypeId: string;
+    startDate: string;
+    endDate: string;
+    days: number;
+    reason?: string | null;
+    status?: string;
+    source?: string;
+};
+type LeaveUpdateInput = Partial<LeaveCreateInput>;
+type EmployeeUpdateInput = {
+    managerId?: string | null;
+    timezone?: string | null;
+};
+type ProjectCreateInput = {
+    name: string;
+    status?: string | null;
+    source?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+    colorTag?: string | null;
+    iconName?: string | null;
+    clientId: string;
+    projectTypeId?: string | null;
+    projectManagerId?: string | null;
+    engagementLeadId?: string | null;
+};
+type ProjectUpdateInput = Partial<ProjectCreateInput>;
+type ClientCreateInput = {
+    name: string;
+    code: string;
+    industry?: string | null;
+    website?: string | null;
+    country?: string | null;
+    contactPhone?: string | null;
+    defaultCurrency?: string | null;
+    primaryContactName?: string | null;
+    primaryContactEmail?: string | null;
+    notes?: string | null;
+};
+type ClientUpdateInput = Partial<ClientCreateInput>;
+type PartnerCreateInput = {
+    name: string;
+    contactName?: string | null;
+    contactEmail?: string | null;
+    contactPhone?: string | null;
+    notes?: string | null;
+};
+type PartnerUpdateInput = Partial<PartnerCreateInput>;
+type DepartmentCreateInput = {
+    name: string;
+    titles?: string[];
+    sortOrder?: number;
+};
+type DepartmentUpdateInput = Partial<DepartmentCreateInput>;
+type ProjectTypeCreateInput = {
+    name: string;
+    description?: string | null;
+    sortOrder?: number;
+};
+type ProjectTypeUpdateInput = Partial<ProjectTypeCreateInput>;
+type CurrencyCreateInput = {
+    code: string;
+    name: string;
+    symbol?: string | null;
+    isDefault?: boolean;
+    sortOrder?: number;
+};
+type CurrencyUpdateInput = Partial<Omit<CurrencyCreateInput, 'code'>>;
+type GenericRateCreateInput = {
+    title: string;
+    department: string;
+    costRate: number;
+    billableRate: number;
+    currencyCode?: string;
+};
+type GenericRateUpdateInput = Partial<GenericRateCreateInput>;
+type JurisdictionCreateInput = {
+    name: string;
+    code: string;
+    country?: string | null;
+};
+type JurisdictionUpdateInput = Partial<JurisdictionCreateInput>;
+type LeaveTypeCreateInput = {
+    name: string;
+    description?: string | null;
+    color?: string | null;
+    sortOrder?: number;
+};
+type LeaveTypeUpdateInput = Partial<LeaveTypeCreateInput>;
+type LeaveBalanceCreateInput = {
+    employeeId: string;
+    leaveTypeId: string;
+    year: number;
+    balanceDays?: number;
+};
+type LeaveBalanceUpdateInput = Partial<LeaveBalanceCreateInput>;
+type PolicyCreateInput = {
+    title: string;
+    code: string;
+    category?: string | null;
+    description?: string | null;
+    body?: string | null;
+    fileKey?: string | null;
+    currentVersion?: number;
+    requiresAcknowledgement?: boolean;
+    isPublished?: boolean;
+};
+type PolicyUpdateInput = Partial<PolicyCreateInput>;
+type PolicyAcknowledgementCreateInput = {
+    policyId: string;
+    employeeId: string;
+    version: number;
+    acknowledgedAt?: string;
+};
+type PolicyAcknowledgementUpdateInput = Partial<PolicyAcknowledgementCreateInput>;
+type CalendarEventCreateInput = {
+    title: string;
+    description?: string | null;
+    startDate: string;
+    endDate?: string | null;
+    allDay?: boolean;
+    type?: string;
+    location?: string | null;
+    color?: string | null;
+    isPublished?: boolean;
+};
+type CalendarEventUpdateInput = Partial<CalendarEventCreateInput>;
+type TimesheetCreateInput = {
+    employeeId: string;
+    projectId?: string | null;
+    startTime: string;
+    endTime?: string | null;
+    durationMinutes: number;
+    description?: string | null;
+    activityName?: string | null;
+    billable?: boolean;
+    source?: string;
+    kimaiId?: string | null;
+    kimaiActivityId?: string | null;
+};
+type TimesheetUpdateInput = Partial<TimesheetCreateInput>;
 type AppScopeInfo = {
     id: string;
     resource: string;
@@ -281,19 +614,34 @@ type AppScopeInfo = {
     status: 'active' | 'pending' | 'rejected';
     reviewNote: string | null;
 };
+type AppPermissionInfo = {
+    resource: string;
+    bucket: string | null;
+    action: 'read' | 'create' | 'update' | 'delete';
+    status: 'active' | 'pending' | 'rejected';
+    reviewNote: string | null;
+};
 type AppInfo = {
     id: string;
     appId: string;
     name: string;
     description: string | null;
     icon: string | null;
-    environment: string;
+    /** Publish lifecycle: draft | submitted | published | changes_requested | suspended. */
     status: string;
+    redirectUris: string[];
+    submittedAt: string | null;
+    publishedAt: string | null;
+    reviewNote: string | null;
+    /** Back-compat aggregate of permissions grouped by resource. */
     scopes: AppScopeInfo[];
+    /** Normalized per-(resource, bucket, action) permission rows. */
+    permissions?: AppPermissionInfo[];
     tokens: {
         id: string;
         tokenPrefix: string;
-        environment: string;
+        /** 'live' | 'test' — replaces the removed `environment`. */
+        mode: string;
         status: string;
         lastUsedAt: string | null;
         expiresAt: string | null;
@@ -313,6 +661,8 @@ declare class NucleusTransport {
     constructor(token: string, baseUrl?: string);
     get<T>(path: string, query?: Record<string, string | number | undefined>): Promise<SuccessResult<T> | ErrorResult>;
     post<T>(path: string, body: unknown): Promise<SuccessResult<T> | ErrorResult>;
+    put<T>(path: string, body: unknown): Promise<SuccessResult<T> | ErrorResult>;
+    patch<T>(path: string, body: unknown): Promise<SuccessResult<T> | ErrorResult>;
     del<T = null>(path: string, query?: Record<string, string | undefined>): Promise<SuccessResult<T> | ErrorResult>;
     getList<T>(path: string, query?: Record<string, string | number | undefined>): Promise<ListResult<T> | ErrorResult>;
 }
@@ -334,6 +684,10 @@ declare class EmployeesAccessor<S extends ScopeDeclaration> {
     getById<E extends readonly EmployeeExpandPath[] = never[]>(id: string, options?: {
         expand?: E;
     }): Promise<SingleResult<WithEmployeeExpand<ResolveEmployee<S>, E, S>>>;
+    /** Update an employee (managerId / timezone overrides). Requires `employees.update` scope. */
+    update(id: string, data: IfUpdate<S['employees'], EmployeeUpdateInput>): Promise<SingleResult<ResolveEmployee<S>>>;
+    /** Soft-delete an employee. Requires `employees.delete` scope. */
+    delete(id: IfDelete<S['employees'], string>): Promise<SingleResult<null>>;
 }
 
 type ProjectListParams = {
@@ -353,6 +707,12 @@ declare class ProjectsAccessor<S extends ScopeDeclaration> {
     getById<E extends readonly ProjectExpandPath[] = never[]>(id: string, options?: {
         expand?: E;
     }): Promise<SingleResult<WithProjectExpand<ResolveProject<S>, E, S>>>;
+    /** Create a project. Requires `projects.create` scope. */
+    create(data: IfCreate<S['projects'], ProjectCreateInput>): Promise<SingleResult<ResolveProject<S>>>;
+    /** Update a project. Requires `projects.update` scope. */
+    update(id: string, data: IfUpdate<S['projects'], ProjectUpdateInput>): Promise<SingleResult<ResolveProject<S>>>;
+    /** Soft-delete a project. Requires `projects.delete` scope. */
+    delete(id: IfDelete<S['projects'], string>): Promise<SingleResult<null>>;
 }
 
 type ClientListParams = {
@@ -372,6 +732,12 @@ declare class ClientsAccessor<S extends ScopeDeclaration> {
     getById<E extends readonly ClientExpandPath[] = never[]>(id: string, options?: {
         expand?: E;
     }): Promise<SingleResult<WithClientExpand<ResolveClient<S>, E, S>>>;
+    /** Create a client. Requires `clients.create` scope. */
+    create(data: IfCreate<S['clients'], ClientCreateInput>): Promise<SingleResult<ResolveClient<S>>>;
+    /** Update a client. Requires `clients.update` scope. */
+    update(id: string, data: IfUpdate<S['clients'], ClientUpdateInput>): Promise<SingleResult<ResolveClient<S>>>;
+    /** Soft-delete a client. Requires `clients.delete` scope. */
+    delete(id: IfDelete<S['clients'], string>): Promise<SingleResult<null>>;
 }
 
 type PartnerListParams = {
@@ -389,6 +755,12 @@ declare class PartnersAccessor<S extends ScopeDeclaration> {
     getById<E extends readonly PartnerExpandPath[] = never[]>(id: string, options?: {
         expand?: E;
     }): Promise<SingleResult<WithPartnerExpand<ResolvePartner<S>, E, S>>>;
+    /** Create a partner. Requires `partners.create` scope. */
+    create(data: IfCreate<S['partners'], PartnerCreateInput>): Promise<SingleResult<ResolvePartner<S>>>;
+    /** Update a partner. Requires `partners.update` scope. */
+    update(id: string, data: IfUpdate<S['partners'], PartnerUpdateInput>): Promise<SingleResult<ResolvePartner<S>>>;
+    /** Soft-delete a partner. Requires `partners.delete` scope. */
+    delete(id: IfDelete<S['partners'], string>): Promise<SingleResult<null>>;
 }
 
 type DepartmentListParams = {
@@ -401,6 +773,12 @@ declare class DepartmentsAccessor<S extends ScopeDeclaration> {
     constructor(transport: NucleusTransport);
     list(params?: DepartmentListParams): Promise<PaginatedResult<ResolveDepartment<S>>>;
     getById(id: string): Promise<SingleResult<ResolveDepartment<S>>>;
+    /** Create a department. Requires `departments.create` scope. */
+    create(data: IfCreate<S['departments'], DepartmentCreateInput>): Promise<SingleResult<ResolveDepartment<S>>>;
+    /** Update a department. Requires `departments.update` scope. */
+    update(id: string, data: IfUpdate<S['departments'], DepartmentUpdateInput>): Promise<SingleResult<ResolveDepartment<S>>>;
+    /** Soft-delete a department. Requires `departments.delete` scope. */
+    delete(id: IfDelete<S['departments'], string>): Promise<SingleResult<null>>;
 }
 
 type ProjectTypeListParams = {
@@ -412,6 +790,12 @@ declare class ProjectTypesAccessor<S extends ScopeDeclaration> {
     constructor(transport: NucleusTransport);
     list(params?: ProjectTypeListParams): Promise<PaginatedResult<ResolveProjectType<S>>>;
     getById(id: string): Promise<SingleResult<ResolveProjectType<S>>>;
+    /** Create a project type. Requires `projectTypes.create` scope. */
+    create(data: IfCreate<S['projectTypes'], ProjectTypeCreateInput>): Promise<SingleResult<ResolveProjectType<S>>>;
+    /** Update a project type. Requires `projectTypes.update` scope. */
+    update(id: string, data: IfUpdate<S['projectTypes'], ProjectTypeUpdateInput>): Promise<SingleResult<ResolveProjectType<S>>>;
+    /** Soft-delete a project type. Requires `projectTypes.delete` scope. */
+    delete(id: IfDelete<S['projectTypes'], string>): Promise<SingleResult<null>>;
 }
 
 type CurrencyListParams = {
@@ -423,6 +807,15 @@ declare class CurrenciesAccessor<S extends ScopeDeclaration> {
     constructor(transport: NucleusTransport);
     list(params?: CurrencyListParams): Promise<PaginatedResult<ResolveCurrency<S>>>;
     getByCode(code: string): Promise<SingleResult<ResolveCurrency<S>>>;
+    /** Create a currency. Requires `currencies.create` scope. */
+    create(data: IfCreate<S['currencies'], CurrencyCreateInput>): Promise<SingleResult<ResolveCurrency<S>>>;
+    /**
+     * Update a currency (keyed by its ISO code; `code` itself is immutable).
+     * Requires `currencies.update` scope.
+     */
+    update(code: string, data: IfUpdate<S['currencies'], CurrencyUpdateInput>): Promise<SingleResult<ResolveCurrency<S>>>;
+    /** Soft-delete a currency (keyed by its ISO code). Requires `currencies.delete` scope. */
+    delete(code: IfDelete<S['currencies'], string>): Promise<SingleResult<null>>;
 }
 
 type GenericRateListParams = {
@@ -435,6 +828,184 @@ declare class GenericRatesAccessor<S extends ScopeDeclaration> {
     constructor(transport: NucleusTransport);
     list(params?: GenericRateListParams): Promise<PaginatedResult<ResolveGenericRate<S>>>;
     getById(id: string): Promise<SingleResult<ResolveGenericRate<S>>>;
+    /** Create a generic rate. Requires `genericRates.create` scope. */
+    create(data: IfCreate<S['genericRates'], GenericRateCreateInput>): Promise<SingleResult<ResolveGenericRate<S>>>;
+    /** Update a generic rate. Requires `genericRates.update` scope. */
+    update(id: string, data: IfUpdate<S['genericRates'], GenericRateUpdateInput>): Promise<SingleResult<ResolveGenericRate<S>>>;
+    /** Soft-delete a generic rate. Requires `genericRates.delete` scope. */
+    delete(id: IfDelete<S['genericRates'], string>): Promise<SingleResult<null>>;
+}
+
+type JurisdictionListParams = {
+    search?: string;
+    page?: number;
+    pageSize?: number;
+};
+declare class JurisdictionsAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list(params?: JurisdictionListParams): Promise<PaginatedResult<ResolveJurisdiction<S>>>;
+    getById(id: string): Promise<SingleResult<ResolveJurisdiction<S>>>;
+    /** Create a jurisdiction. Requires `jurisdictions.create` scope. */
+    create(data: IfCreate<S['jurisdictions'], JurisdictionCreateInput>): Promise<SingleResult<ResolveJurisdiction<S>>>;
+    /** Update a jurisdiction. Requires `jurisdictions.update` scope. */
+    update(id: string, data: IfUpdate<S['jurisdictions'], JurisdictionUpdateInput>): Promise<SingleResult<ResolveJurisdiction<S>>>;
+    /** Soft-delete a jurisdiction. Requires `jurisdictions.delete` scope. */
+    delete(id: IfDelete<S['jurisdictions'], string>): Promise<SingleResult<null>>;
+}
+
+type LeaveTypeListParams = {
+    search?: string;
+    page?: number;
+    pageSize?: number;
+};
+declare class LeaveTypesAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list(params?: LeaveTypeListParams): Promise<PaginatedResult<ResolveLeaveType<S>>>;
+    getById(id: string): Promise<SingleResult<ResolveLeaveType<S>>>;
+    /** Create a leave type. Requires `leaveTypes.create` scope. */
+    create(data: IfCreate<S['leaveTypes'], LeaveTypeCreateInput>): Promise<SingleResult<ResolveLeaveType<S>>>;
+    /** Update a leave type. Requires `leaveTypes.update` scope. */
+    update(id: string, data: IfUpdate<S['leaveTypes'], LeaveTypeUpdateInput>): Promise<SingleResult<ResolveLeaveType<S>>>;
+    /** Soft-delete a leave type. Requires `leaveTypes.delete` scope. */
+    delete(id: IfDelete<S['leaveTypes'], string>): Promise<SingleResult<null>>;
+}
+
+type LeaveListParams = {
+    employeeId?: string;
+    leaveTypeId?: string;
+    status?: string;
+    page?: number;
+    pageSize?: number;
+    expand?: readonly LeaveExpandPath[];
+};
+declare class LeavesAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list<E extends readonly LeaveExpandPath[] = never[]>(params?: LeaveListParams & {
+        expand?: E;
+    }): Promise<PaginatedResult<WithLeaveExpand<ResolveLeave<S>, E, S>>>;
+    getById<E extends readonly LeaveExpandPath[] = never[]>(id: string, options?: {
+        expand?: E;
+    }): Promise<SingleResult<WithLeaveExpand<ResolveLeave<S>, E, S>>>;
+    /** Create a leave record. Requires `leaves.create` scope. */
+    create(data: IfCreate<S['leaves'], LeaveCreateInput>): Promise<SingleResult<ResolveLeave<S>>>;
+    /** Update a leave record. Requires `leaves.update` scope. */
+    update(id: string, data: IfUpdate<S['leaves'], LeaveUpdateInput>): Promise<SingleResult<ResolveLeave<S>>>;
+    /** Soft-delete a leave record. Requires `leaves.delete` scope. */
+    delete(id: IfDelete<S['leaves'], string>): Promise<SingleResult<null>>;
+}
+
+type LeaveBalanceListParams = {
+    employeeId?: string;
+    leaveTypeId?: string;
+    year?: number;
+    page?: number;
+    pageSize?: number;
+    expand?: readonly LeaveBalanceExpandPath[];
+};
+declare class LeaveBalancesAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list<E extends readonly LeaveBalanceExpandPath[] = never[]>(params?: LeaveBalanceListParams & {
+        expand?: E;
+    }): Promise<PaginatedResult<WithLeaveBalanceExpand<ResolveLeaveBalance<S>, E, S>>>;
+    getById<E extends readonly LeaveBalanceExpandPath[] = never[]>(id: string, options?: {
+        expand?: E;
+    }): Promise<SingleResult<WithLeaveBalanceExpand<ResolveLeaveBalance<S>, E, S>>>;
+    /** Create a leave balance. Requires `leaveBalances.create` scope. */
+    create(data: IfCreate<S['leaveBalances'], LeaveBalanceCreateInput>): Promise<SingleResult<ResolveLeaveBalance<S>>>;
+    /** Update a leave balance. Requires `leaveBalances.update` scope. */
+    update(id: string, data: IfUpdate<S['leaveBalances'], LeaveBalanceUpdateInput>): Promise<SingleResult<ResolveLeaveBalance<S>>>;
+    /** Soft-delete a leave balance. Requires `leaveBalances.delete` scope. */
+    delete(id: IfDelete<S['leaveBalances'], string>): Promise<SingleResult<null>>;
+}
+
+type PolicyListParams = {
+    search?: string;
+    category?: string;
+    page?: number;
+    pageSize?: number;
+};
+declare class PoliciesAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list(params?: PolicyListParams): Promise<PaginatedResult<ResolvePolicy<S>>>;
+    getById(id: string): Promise<SingleResult<ResolvePolicy<S>>>;
+    /** Create a policy. Requires `policies.create` scope. */
+    create(data: IfCreate<S['policies'], PolicyCreateInput>): Promise<SingleResult<ResolvePolicy<S>>>;
+    /** Update a policy. Requires `policies.update` scope. */
+    update(id: string, data: IfUpdate<S['policies'], PolicyUpdateInput>): Promise<SingleResult<ResolvePolicy<S>>>;
+    /** Soft-delete a policy. Requires `policies.delete` scope. */
+    delete(id: IfDelete<S['policies'], string>): Promise<SingleResult<null>>;
+}
+
+type PolicyAcknowledgementListParams = {
+    policyId?: string;
+    employeeId?: string;
+    page?: number;
+    pageSize?: number;
+    expand?: readonly PolicyAcknowledgementExpandPath[];
+};
+declare class PolicyAcknowledgementsAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list<E extends readonly PolicyAcknowledgementExpandPath[] = never[]>(params?: PolicyAcknowledgementListParams & {
+        expand?: E;
+    }): Promise<PaginatedResult<WithPolicyAcknowledgementExpand<ResolvePolicyAcknowledgement<S>, E, S>>>;
+    getById<E extends readonly PolicyAcknowledgementExpandPath[] = never[]>(id: string, options?: {
+        expand?: E;
+    }): Promise<SingleResult<WithPolicyAcknowledgementExpand<ResolvePolicyAcknowledgement<S>, E, S>>>;
+    /** Create a policy acknowledgement. Requires `policyAcknowledgements.create` scope. */
+    create(data: IfCreate<S['policyAcknowledgements'], PolicyAcknowledgementCreateInput>): Promise<SingleResult<ResolvePolicyAcknowledgement<S>>>;
+    /** Update a policy acknowledgement. Requires `policyAcknowledgements.update` scope. */
+    update(id: string, data: IfUpdate<S['policyAcknowledgements'], PolicyAcknowledgementUpdateInput>): Promise<SingleResult<ResolvePolicyAcknowledgement<S>>>;
+    /** Soft-delete a policy acknowledgement. Requires `policyAcknowledgements.delete` scope. */
+    delete(id: IfDelete<S['policyAcknowledgements'], string>): Promise<SingleResult<null>>;
+}
+
+type CalendarEventListParams = {
+    search?: string;
+    type?: string;
+    page?: number;
+    pageSize?: number;
+};
+declare class CalendarEventsAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list(params?: CalendarEventListParams): Promise<PaginatedResult<ResolveCalendarEvent<S>>>;
+    getById(id: string): Promise<SingleResult<ResolveCalendarEvent<S>>>;
+    /** Create a calendar event. Requires `calendarEvents.create` scope. */
+    create(data: IfCreate<S['calendarEvents'], CalendarEventCreateInput>): Promise<SingleResult<ResolveCalendarEvent<S>>>;
+    /** Update a calendar event. Requires `calendarEvents.update` scope. */
+    update(id: string, data: IfUpdate<S['calendarEvents'], CalendarEventUpdateInput>): Promise<SingleResult<ResolveCalendarEvent<S>>>;
+    /** Soft-delete a calendar event. Requires `calendarEvents.delete` scope. */
+    delete(id: IfDelete<S['calendarEvents'], string>): Promise<SingleResult<null>>;
+}
+
+type TimesheetListParams = {
+    employeeId?: string;
+    projectId?: string;
+    page?: number;
+    pageSize?: number;
+    expand?: readonly TimesheetExpandPath[];
+};
+declare class TimesheetsAccessor<S extends ScopeDeclaration> {
+    private readonly transport;
+    constructor(transport: NucleusTransport);
+    list<E extends readonly TimesheetExpandPath[] = never[]>(params?: TimesheetListParams & {
+        expand?: E;
+    }): Promise<PaginatedResult<WithTimesheetExpand<ResolveTimesheet<S>, E, S>>>;
+    getById<E extends readonly TimesheetExpandPath[] = never[]>(id: string, options?: {
+        expand?: E;
+    }): Promise<SingleResult<WithTimesheetExpand<ResolveTimesheet<S>, E, S>>>;
+    /** Create a timesheet entry. Requires `timesheets.create` scope. */
+    create(data: IfCreate<S['timesheets'], TimesheetCreateInput>): Promise<SingleResult<ResolveTimesheet<S>>>;
+    /** Update a timesheet entry. Requires `timesheets.update` scope. */
+    update(id: string, data: IfUpdate<S['timesheets'], TimesheetUpdateInput>): Promise<SingleResult<ResolveTimesheet<S>>>;
+    /** Soft-delete a timesheet entry. Requires `timesheets.delete` scope. */
+    delete(id: IfDelete<S['timesheets'], string>): Promise<SingleResult<null>>;
 }
 
 /**
@@ -566,9 +1137,9 @@ type NucleusClientConfig<S extends ScopeDeclaration> = {
  * export const nucleus = new NucleusClient({
  *   token: process.env.NUCLEUS_TOKEN!,
  *   scopes: {
- *     employees: ['identity', 'employment'],
- *     projects: ['core'],
- *     clients: ['identity'],
+ *     employees: { read: ['identity', 'employment'], update: ['contact'] },
+ *     projects: { read: ['core'] },
+ *     leaves: { read: ['core'], create: ['core'], delete: true },
  *   },
  * });
  * ```
@@ -586,6 +1157,14 @@ declare class NucleusClient<const S extends ScopeDeclaration> {
     readonly projectTypes: ProjectTypesAccessor<S>;
     readonly currencies: CurrenciesAccessor<S>;
     readonly genericRates: GenericRatesAccessor<S>;
+    readonly jurisdictions: JurisdictionsAccessor<S>;
+    readonly leaveTypes: LeaveTypesAccessor<S>;
+    readonly leaves: LeavesAccessor<S>;
+    readonly leaveBalances: LeaveBalancesAccessor<S>;
+    readonly policies: PoliciesAccessor<S>;
+    readonly policyAcknowledgements: PolicyAcknowledgementsAccessor<S>;
+    readonly calendarEvents: CalendarEventsAccessor<S>;
+    readonly timesheets: TimesheetsAccessor<S>;
     readonly apps: AppsAccessor;
     readonly files: FilesAccessor;
     readonly auth: AuthAccessor;
@@ -593,5 +1172,5 @@ declare class NucleusClient<const S extends ScopeDeclaration> {
 }
 
 export { FilesAccessor, NucleusClient, isError };
-export type { AppInfo, AppScopeInfo, ClientContact, ClientExpandPath, ClientFinancials, ClientIdentity, ClientNotes, CurrencyCore, DepartmentCore, EmployeeCompensation, EmployeeCompensationHistory, EmployeeContact, EmployeeEmployment, EmployeeExpandPath, EmployeeIdentity, EmployeeSensitive, ErrorCode, ErrorResult, ListParams as FileListParams, FileRecord, FileUrlResult, FileVisibility, GenericRateCore, GenericRateFinancials, GetUrlOptions, ListMeta, ListResult, NucleusClientConfig, PaginatedResult, PartnerContact, PartnerExpandPath, PartnerIdentity, PartnerNotes, ProjectCore, ProjectExpandPath, ProjectFinancials, ProjectIntegrations, ProjectMembership, ProjectTeam, ProjectTypeCore, ResolveClient, ResolveCurrency, ResolveDepartment, ResolveEmployee, ResolveGenericRate, ResolvePartner, ResolveProject, ResolveProjectType, ScopeDeclaration, SingleResult, SuccessResult, UploadParams, VerifiedToken, WithClientExpand, WithEmployeeExpand, WithPartnerExpand, WithProjectExpand };
+export type { AppInfo, AppPermissionInfo, AppScopeInfo, CalendarEventCore, ClientContact, ClientExpandPath, ClientFinancials, ClientIdentity, ClientNotes, CurrencyCore, DepartmentCore, EmployeeCompensation, EmployeeCompensationHistory, EmployeeContact, EmployeeEmployment, EmployeeExpandPath, EmployeeIdentity, EmployeeSensitive, ErrorCode, ErrorResult, ListParams as FileListParams, FileRecord, FileUrlResult, FileVisibility, GenericRateCore, GenericRateFinancials, GetUrlOptions, JurisdictionCore, LeaveBalanceCore, LeaveBalanceExpandPath, LeaveCore, LeaveDetails, LeaveExpandPath, LeaveTypeCore, ListMeta, ListResult, NucleusClientConfig, PaginatedResult, PartnerContact, PartnerExpandPath, PartnerIdentity, PartnerNotes, PolicyAcknowledgementCore, PolicyAcknowledgementExpandPath, PolicyContent, PolicyCore, ProjectCore, ProjectExpandPath, ProjectFinancials, ProjectIntegrations, ProjectMembership, ProjectTeam, ProjectTypeCore, ResolveCalendarEvent, ResolveClient, ResolveCurrency, ResolveDepartment, ResolveEmployee, ResolveGenericRate, ResolveJurisdiction, ResolveLeave, ResolveLeaveBalance, ResolveLeaveType, ResolvePartner, ResolvePolicy, ResolvePolicyAcknowledgement, ResolveProject, ResolveProjectType, ResolveTimesheet, ScopeDeclaration, SingleResult, SuccessResult, TimesheetCore, TimesheetDetails, TimesheetExpandPath, TimesheetIntegrations, UploadParams, VerifiedToken, WithClientExpand, WithEmployeeExpand, WithLeaveBalanceExpand, WithLeaveExpand, WithPartnerExpand, WithPolicyAcknowledgementExpand, WithProjectExpand, WithTimesheetExpand };
 //# sourceMappingURL=index.d.ts.map