@typeb-digital/nucleus-sdk 0.0.1 → 0.0.2

package/dist/cjs/index.cjs

@@ -0,0 +1,683 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var ofetch = require('ofetch');
+
+const DEFAULT_BASE_URL = 'https://nucleus.typeb.digital';
+function statusToCode(status, apiCode) {
+    if (apiCode === 'INVALID_SCOPE') return 'INVALID_SCOPE';
+    if (status === 404) return 'NOT_FOUND';
+    if (status === 429) return 'RATE_LIMITED';
+    return 'FORBIDDEN';
+}
+function makeErrorResult(code, message) {
+    return {
+        error: {
+            code,
+            message
+        }
+    };
+}
+class NucleusTransport {
+    constructor(token, baseUrl){
+        this.headers = {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json'
+        };
+        this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+    }
+    async get(path, query) {
+        try {
+            const params = query ? Object.fromEntries(Object.entries(query).filter(([, v])=>v !== undefined)) : undefined;
+            const envelope = await ofetch.$fetch(`${this.baseUrl}${path}`, {
+                method: 'GET',
+                headers: this.headers,
+                params
+            });
+            if (!envelope.success) {
+                return makeErrorResult('FORBIDDEN', envelope.error);
+            }
+            return {
+                data: envelope.data
+            };
+        } catch (err) {
+            if (err instanceof ofetch.FetchError) {
+                const body = err.data;
+                const code = statusToCode(err.status ?? 0, body?.error);
+                return makeErrorResult(code, err.message);
+            }
+            return makeErrorResult('NETWORK_ERROR', String(err));
+        }
+    }
+    async post(path, body) {
+        try {
+            const envelope = await ofetch.$fetch(`${this.baseUrl}${path}`, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(body)
+            });
+            if (!envelope.success) return makeErrorResult('FORBIDDEN', envelope.error);
+            return {
+                data: envelope.data
+            };
+        } catch (err) {
+            if (err instanceof ofetch.FetchError) {
+                const errBody = err.data;
+                return makeErrorResult(statusToCode(err.status ?? 0, errBody?.error), err.message);
+            }
+            return makeErrorResult('NETWORK_ERROR', String(err));
+        }
+    }
+    async del(path, query) {
+        try {
+            const params = query ? Object.fromEntries(Object.entries(query).filter(([, v])=>v !== undefined)) : undefined;
+            const envelope = await ofetch.$fetch(`${this.baseUrl}${path}`, {
+                method: 'DELETE',
+                headers: this.headers,
+                params
+            });
+            if (!envelope.success) return makeErrorResult('FORBIDDEN', envelope.error);
+            return {
+                data: envelope.data
+            };
+        } catch (err) {
+            if (err instanceof ofetch.FetchError) {
+                const errBody = err.data;
+                return makeErrorResult(statusToCode(err.status ?? 0, errBody?.error), err.message);
+            }
+            return makeErrorResult('NETWORK_ERROR', String(err));
+        }
+    }
+    async getList(path, query) {
+        try {
+            const params = query ? Object.fromEntries(Object.entries(query).filter(([, v])=>v !== undefined)) : undefined;
+            const envelope = await ofetch.$fetch(`${this.baseUrl}${path}`, {
+                method: 'GET',
+                headers: this.headers,
+                params
+            });
+            if (!envelope.success) {
+                return makeErrorResult('FORBIDDEN', envelope.error);
+            }
+            const { data, meta } = envelope;
+            const listMeta = {
+                total: meta.total,
+                page: meta.page,
+                pageSize: meta.pageSize,
+                hasMore: meta.page * meta.pageSize < meta.total
+            };
+            return {
+                data,
+                meta: listMeta
+            };
+        } catch (err) {
+            if (err instanceof ofetch.FetchError) {
+                const body = err.data;
+                const code = statusToCode(err.status ?? 0, body?.error);
+                return makeErrorResult(code, err.message);
+            }
+            return makeErrorResult('NETWORK_ERROR', String(err));
+        }
+    }
+}
+
+/**
+ * Transform utilities — map snake_case Prisma API responses to camelCase SDK types.
+ * Each function accepts `unknown` so it works regardless of which buckets were active.
+ */ function str(v) {
+    return typeof v === 'string' ? v : null;
+}
+function num(v) {
+    return typeof v === 'number' ? v : null;
+}
+function bool(v) {
+    return v === true;
+}
+function transformProfile(profile) {
+    if (!profile || typeof profile !== 'object') return {};
+    const p = profile;
+    const out = {};
+    if ('phone' in p) out['phone'] = p['phone'];
+    if ('city' in p) out['city'] = p['city'];
+    if ('country' in p) out['country'] = p['country'];
+    if ('biography' in p) out['biography'] = p['biography'];
+    if ('emergency_contact_name' in p || 'emergency_contact_phone' in p) {
+        out['emergencyContact'] = {
+            name: str(p['emergency_contact_name']),
+            phone: str(p['emergency_contact_phone'])
+        };
+    }
+    return out;
+}
+function transformCompensation(raw) {
+    if (!raw || typeof raw !== 'object') return null;
+    const r = raw;
+    return {
+        hourlyCostRate: num(r['hourly_cost_rate']),
+        hourlyBillableRate: num(r['hourly_billable_rate']),
+        monthlyCostRate: num(r['monthly_cost_rate']),
+        monthlyBillableRate: num(r['monthly_billable_rate']),
+        currencyCode: str(r['currency_code']) ?? 'USD',
+        effectiveFrom: str(r['effective_from']) ?? ''
+    };
+}
+function transformCompensationHistoryEntry(raw) {
+    const r = raw ?? {};
+    return {
+        hourlyCostRate: num(r['hourly_cost_rate']),
+        hourlyBillableRate: num(r['hourly_billable_rate']),
+        monthlyCostRate: num(r['monthly_cost_rate']),
+        monthlyBillableRate: num(r['monthly_billable_rate']),
+        currencyCode: str(r['currency_code']) ?? 'USD',
+        effectiveFrom: str(r['effective_from']) ?? '',
+        effectiveTo: str(r['effective_to'])
+    };
+}
+function transformEmployee(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    // identity
+    if ('id' in r) out['id'] = r['id'];
+    if ('display_name' in r) out['displayName'] = str(r['display_name']);
+    if ('first_name' in r) out['firstName'] = str(r['first_name']);
+    if ('last_name' in r) out['lastName'] = str(r['last_name']);
+    if ('email' in r) out['email'] = str(r['email']);
+    if ('picture_url' in r) out['pictureUrl'] = str(r['picture_url']);
+    if ('job_title' in r) out['jobTitle'] = str(r['job_title']);
+    if ('department' in r) out['department'] = str(r['department']);
+    if ('employment_status' in r) out['employmentStatus'] = str(r['employment_status']);
+    if ('is_external' in r) out['isExternal'] = bool(r['is_external']);
+    // employment
+    if ('start_date' in r) out['startDate'] = str(r['start_date']);
+    if ('weekly_capacity' in r) out['weeklyCapacity'] = num(r['weekly_capacity']);
+    if ('manager_id' in r) out['managerId'] = str(r['manager_id']);
+    if ('partner_id' in r) out['partnerId'] = str(r['partner_id']);
+    if ('timezone' in r) out['timezone'] = str(r['timezone']);
+    // sensitive
+    if ('birthday' in r) out['birthday'] = str(r['birthday']);
+    if ('custom_fields' in r) out['customFields'] = r['custom_fields'];
+    // profile JSON (contact + employment.biography + sensitive.emergencyContact)
+    if ('profile' in r) {
+        out['profile'] = transformProfile(r['profile']);
+    }
+    // synthesised compensation (injected by Layer 3 interceptor)
+    if ('current_compensation' in r) {
+        out['currentCompensation'] = transformCompensation(r['current_compensation']);
+    }
+    if ('compensation_history' in r && Array.isArray(r['compensation_history'])) {
+        out['compensationHistory'] = r['compensation_history'].map(transformCompensationHistoryEntry);
+    }
+    // Expand: manager / partner (recursively transformed)
+    if ('manager' in r) {
+        out['manager'] = r['manager'] ? transformEmployee(r['manager']) : null;
+    }
+    if ('partner' in r) {
+        out['partner'] = r['partner'] ? transformPartner(r['partner']) : null;
+    }
+    return out;
+}
+function transformProject(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    // core
+    if ('id' in r) out['id'] = r['id'];
+    if ('name' in r) out['name'] = str(r['name']);
+    if ('status' in r) out['status'] = str(r['status']);
+    if ('color_tag' in r) out['colorTag'] = str(r['color_tag']);
+    if ('icon_name' in r) out['iconName'] = str(r['icon_name']);
+    if ('start_date' in r) out['startDate'] = str(r['start_date']);
+    if ('end_date' in r) out['endDate'] = str(r['end_date']);
+    if ('project_type_id' in r) out['projectTypeId'] = str(r['project_type_id']);
+    if ('client_id' in r) out['clientId'] = str(r['client_id']);
+    // team
+    if ('project_manager_id' in r) out['projectManagerId'] = str(r['project_manager_id']);
+    if ('engagement_lead_id' in r) out['engagementLeadId'] = str(r['engagement_lead_id']);
+    if ('memberships' in r && Array.isArray(r['memberships'])) {
+        out['memberships'] = r['memberships'].map((m)=>{
+            const mem = m ?? {};
+            const entry = {
+                employeeId: str(mem['employee_id']),
+                role: str(mem['role'])
+            };
+            if ('employee' in mem) {
+                entry['employee'] = mem['employee'] ? transformEmployee(mem['employee']) : null;
+            }
+            return entry;
+        });
+    }
+    // integrations
+    if ('source' in r) out['source'] = str(r['source']);
+    if ('clockify_project_id' in r) out['clockifyProjectId'] = str(r['clockify_project_id']);
+    if ('clockify_workspace_id' in r) out['clockifyWorkspaceId'] = str(r['clockify_workspace_id']);
+    if ('apollo_deal_id' in r) out['apolloDealId'] = str(r['apollo_deal_id']);
+    // expand: client / projectType / projectManager / engagementLead
+    if ('client' in r) out['client'] = r['client'] ? transformClient(r['client']) : null;
+    if ('project_type' in r || 'projectType' in r) {
+        const pt = r['project_type'] ?? r['projectType'];
+        out['projectType'] = pt ? transformProjectType(pt) : null;
+    }
+    if ('project_manager' in r || 'projectManager' in r) {
+        const pm = r['project_manager'] ?? r['projectManager'];
+        out['projectManager'] = pm ? transformEmployee(pm) : null;
+    }
+    if ('engagement_lead' in r || 'engagementLead' in r) {
+        const el = r['engagement_lead'] ?? r['engagementLead'];
+        out['engagementLead'] = el ? transformEmployee(el) : null;
+    }
+    return out;
+}
+function transformClient(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    if ('id' in r) out['id'] = r['id'];
+    if ('name' in r) out['name'] = str(r['name']);
+    if ('code' in r) out['code'] = str(r['code']);
+    if ('industry' in r) out['industry'] = str(r['industry']);
+    if ('website' in r) out['website'] = str(r['website']);
+    if ('country' in r) out['country'] = str(r['country']);
+    if ('primary_contact_name' in r) out['primaryContactName'] = str(r['primary_contact_name']);
+    if ('primary_contact_email' in r) out['primaryContactEmail'] = str(r['primary_contact_email']);
+    if ('contact_phone' in r) out['contactPhone'] = str(r['contact_phone']);
+    if ('default_currency' in r) out['defaultCurrency'] = str(r['default_currency']);
+    if ('notes' in r) out['notes'] = str(r['notes']);
+    if ('projects' in r && Array.isArray(r['projects'])) {
+        out['projects'] = r['projects'].map(transformProject);
+    }
+    return out;
+}
+function transformPartner(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    if ('id' in r) out['id'] = r['id'];
+    if ('name' in r) out['name'] = str(r['name']);
+    if ('contact_name' in r) out['contactName'] = str(r['contact_name']);
+    if ('contact_email' in r) out['contactEmail'] = str(r['contact_email']);
+    if ('contact_phone' in r) out['contactPhone'] = str(r['contact_phone']);
+    if ('notes' in r) out['notes'] = str(r['notes']);
+    if ('employees' in r && Array.isArray(r['employees'])) {
+        out['employees'] = r['employees'].map(transformEmployee);
+    }
+    return out;
+}
+function transformDepartment(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    if ('id' in r) out['id'] = r['id'];
+    if ('name' in r) out['name'] = str(r['name']);
+    if ('titles' in r) out['titles'] = Array.isArray(r['titles']) ? r['titles'] : [];
+    if ('sort_order' in r) out['sortOrder'] = num(r['sort_order']) ?? 0;
+    return out;
+}
+function transformProjectType(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    if ('id' in r) out['id'] = r['id'];
+    if ('name' in r) out['name'] = str(r['name']);
+    if ('description' in r) out['description'] = str(r['description']);
+    if ('sort_order' in r) out['sortOrder'] = num(r['sort_order']) ?? 0;
+    return out;
+}
+function transformCurrency(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    if ('code' in r) out['code'] = r['code'];
+    if ('name' in r) out['name'] = str(r['name']);
+    if ('symbol' in r) out['symbol'] = str(r['symbol']);
+    if ('is_default' in r) out['isDefault'] = bool(r['is_default']);
+    if ('sort_order' in r) out['sortOrder'] = num(r['sort_order']) ?? 0;
+    return out;
+}
+function transformGenericRate(raw) {
+    if (!raw || typeof raw !== 'object') return {};
+    const r = raw;
+    const out = {};
+    if ('id' in r) out['id'] = r['id'];
+    if ('title' in r) out['title'] = str(r['title']);
+    if ('department' in r) out['department'] = str(r['department']);
+    if ('currency_code' in r) out['currencyCode'] = str(r['currency_code']);
+    if ('cost_rate' in r) out['costRate'] = num(r['cost_rate']);
+    if ('billable_rate' in r) out['billableRate'] = num(r['billable_rate']);
+    return out;
+}
+
+class EmployeesAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.search) query['search'] = params.search;
+        if (params?.department) query['department'] = params.department;
+        if (params?.employmentStatus) query['employmentStatus'] = params.employmentStatus;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        if (params?.expand?.length) query['expand'] = params.expand.join(',');
+        const result = await this.transport.getList('/api/v1/data/employees', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformEmployee(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id, options) {
+        const query = {};
+        if (options?.expand?.length) query['expand'] = options.expand.join(',');
+        const result = await this.transport.get(`/api/v1/data/employees/${id}`, query);
+        if ('error' in result) return result;
+        return {
+            data: transformEmployee(result.data)
+        };
+    }
+}
+
+class ProjectsAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.search) query['search'] = params.search;
+        if (params?.status) query['status'] = params.status;
+        if (params?.clientId) query['clientId'] = params.clientId;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        if (params?.expand?.length) query['expand'] = params.expand.join(',');
+        const result = await this.transport.getList('/api/v1/data/projects', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformProject(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id, options) {
+        const query = {};
+        if (options?.expand?.length) query['expand'] = options.expand.join(',');
+        const result = await this.transport.get(`/api/v1/data/projects/${id}`, query);
+        if ('error' in result) return result;
+        return {
+            data: transformProject(result.data)
+        };
+    }
+}
+
+class ClientsAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.search) query['search'] = params.search;
+        if (params?.industry) query['industry'] = params.industry;
+        if (params?.country) query['country'] = params.country;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        if (params?.expand?.length) query['expand'] = params.expand.join(',');
+        const result = await this.transport.getList('/api/v1/data/clients', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformClient(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id, options) {
+        const query = {};
+        if (options?.expand?.length) query['expand'] = options.expand.join(',');
+        const result = await this.transport.get(`/api/v1/data/clients/${id}`, query);
+        if ('error' in result) return result;
+        return {
+            data: transformClient(result.data)
+        };
+    }
+}
+
+class PartnersAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.search) query['search'] = params.search;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        if (params?.expand?.length) query['expand'] = params.expand.join(',');
+        const result = await this.transport.getList('/api/v1/data/partners', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformPartner(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id, options) {
+        const query = {};
+        if (options?.expand?.length) query['expand'] = options.expand.join(',');
+        const result = await this.transport.get(`/api/v1/data/partners/${id}`, query);
+        if ('error' in result) return result;
+        return {
+            data: transformPartner(result.data)
+        };
+    }
+}
+
+class DepartmentsAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.search) query['search'] = params.search;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        const result = await this.transport.getList('/api/v1/data/departments', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformDepartment(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id) {
+        const result = await this.transport.get(`/api/v1/data/departments/${id}`);
+        if ('error' in result) return result;
+        return {
+            data: transformDepartment(result.data)
+        };
+    }
+}
+
+class ProjectTypesAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        const result = await this.transport.getList('/api/v1/data/project-types', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformProjectType(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id) {
+        const result = await this.transport.get(`/api/v1/data/project-types/${id}`);
+        if ('error' in result) return result;
+        return {
+            data: transformProjectType(result.data)
+        };
+    }
+}
+
+class CurrenciesAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        const result = await this.transport.getList('/api/v1/data/currencies', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformCurrency(r)),
+            meta: result.meta
+        };
+    }
+    async getByCode(code) {
+        const result = await this.transport.get(`/api/v1/data/currencies/${code}`);
+        if ('error' in result) return result;
+        return {
+            data: transformCurrency(result.data)
+        };
+    }
+}
+
+class GenericRatesAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async list(params) {
+        const query = {};
+        if (params?.department) query['department'] = params.department;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        const result = await this.transport.getList('/api/v1/data/generic-rates', query);
+        if ('error' in result) return result;
+        return {
+            data: result.data.map((r)=>transformGenericRate(r)),
+            meta: result.meta
+        };
+    }
+    async getById(id) {
+        const result = await this.transport.get(`/api/v1/data/generic-rates/${id}`);
+        if ('error' in result) return result;
+        return {
+            data: transformGenericRate(result.data)
+        };
+    }
+}
+
+/**
+ * AppsAccessor — wraps the self-service app info endpoint (§3.8, §6).
+ * Calls GET /api/v1/platform/apps/me with the app token.
+ * This is the only platform endpoint accessible via app token.
+ */ class AppsAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    async me() {
+        const result = await this.transport.get('/api/v1/platform/apps/me');
+        if ('error' in result) return result;
+        return {
+            data: result.data
+        };
+    }
+}
+
+class FilesAccessor {
+    constructor(transport){
+        this.transport = transport;
+    }
+    /**
+   * Upload a file. Upsert semantics: re-uploading the same key overwrites the
+   * existing R2 object and updates the File record — no duplicate, no error.
+   */ async upload(params) {
+        return this.transport.post('/api/v1/platform/files', {
+            key: params.key,
+            file: params.file.toString('base64'),
+            mimeType: params.mimeType,
+            visibility: params.visibility,
+            ...params.allowedUsers !== undefined ? {
+                allowedUsers: params.allowedUsers
+            } : {},
+            ...params.metadata !== undefined ? {
+                metadata: params.metadata
+            } : {},
+            ...params.filename !== undefined ? {
+                filename: params.filename
+            } : {}
+        });
+    }
+    /**
+   * Resolve a usable URL for a file.
+   * - Public files  → deterministic CDN URL
+   * - Private app-wide files → fresh pre-signed URL (expires in R2_SIGNED_URL_TTL seconds)
+   * - Private user-scoped files → supply asUser; 403 if user is not in allowedUsers
+   */ async getUrl(key, options) {
+        return this.transport.post('/api/v1/platform/files/url', {
+            key,
+            ...options?.asUser ? {
+                asUser: options.asUser
+            } : {}
+        });
+    }
+    /** Soft-delete. Resolution of the key returns 404 thereafter. */ async delete(key) {
+        return this.transport.del('/api/v1/platform/files', {
+            key
+        });
+    }
+    /** List this app's files. Optionally filter by path prefix. */ async list(params) {
+        const query = {};
+        if (params?.prefix) query['prefix'] = params.prefix;
+        if (params?.page) query['page'] = params.page;
+        if (params?.pageSize) query['pageSize'] = params.pageSize;
+        return this.transport.getList('/api/v1/platform/files', query);
+    }
+}
+
+/**
+ * NucleusClient — entry point for the Nucleus server SDK.
+ *
+ * @example
+ * ```typescript
+ * import { NucleusClient } from '@typeb-digital/nucleus-sdk';
+ *
+ * export const nucleus = new NucleusClient({
+ *   token: process.env.NUCLEUS_TOKEN!,
+ *   scopes: {
+ *     employees: ['identity', 'employment'],
+ *     projects: ['core'],
+ *     clients: ['identity'],
+ *   },
+ * });
+ * ```
+ *
+ * The `scopes` object is the heart of the type system — it is declared once at
+ * instantiation and drives the return type of every method on the client.
+ * TypeScript infers it automatically; no explicit type parameters needed.
+ */ class NucleusClient {
+    constructor(config){
+        const transport = new NucleusTransport(config.token, config.baseUrl);
+        this.employees = new EmployeesAccessor(transport);
+        this.projects = new ProjectsAccessor(transport);
+        this.clients = new ClientsAccessor(transport);
+        this.partners = new PartnersAccessor(transport);
+        this.departments = new DepartmentsAccessor(transport);
+        this.projectTypes = new ProjectTypesAccessor(transport);
+        this.currencies = new CurrenciesAccessor(transport);
+        this.genericRates = new GenericRatesAccessor(transport);
+        this.apps = new AppsAccessor(transport);
+        this.files = new FilesAccessor(transport);
+    }
+}
+
+/**
+ * Nucleus SDK — Type System
+ *
+ * Bucket types are transcribed from docs/NUCLEUS_PIVOT.md §7 (Bucket Definitions).
+ * Each bucket type contains only that bucket's fields.
+ * The scope-to-type inference intersects selected bucket types at compile time.
+ */ // ─── Utility types ────────────────────────────────────────────────────────────
+// Converts a union to an intersection: A | B → A & B
+function isError(result) {
+    return 'error' in result;
+}
+
+exports.FilesAccessor = FilesAccessor;
+exports.NucleusClient = NucleusClient;
+exports.isError = isError;