@typeb-digital/nucleus-sdk 0.0.1 → 0.0.2

package/src/resources/projects.ts

@@ -1,65 +0,0 @@
-import type {
-  ScopeDeclaration,
-  ResolveProject,
-  ProjectExpandPath,
-  WithProjectExpand,
-  SingleResult,
-  PaginatedResult,
-  ErrorResult,
-} from '../types';
-import type { NucleusTransport } from '../transport';
-import { transformProject } from '../transform';
-
-export type ProjectListParams = {
-  search?: string;
-  status?: string;
-  clientId?: string;
-  page?: number;
-  pageSize?: number;
-  expand?: readonly ProjectExpandPath[];
-};
-
-export class ProjectsAccessor<S extends ScopeDeclaration> {
-  constructor(private readonly transport: NucleusTransport) {}
-
-  async list<E extends readonly ProjectExpandPath[] = never[]>(
-    params?: ProjectListParams & { expand?: E },
-  ): Promise<PaginatedResult<WithProjectExpand<ResolveProject<S>, E, S>>> {
-    const query: Record<string, string | number | undefined> = {};
-    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<unknown>('/api/v1/data/projects', query);
-
-    if ('error' in result) return result as ErrorResult;
-
-    return {
-      data: result.data.map((r) => transformProject(r)) as WithProjectExpand<
-        ResolveProject<S>,
-        E,
-        S
-      >[],
-      meta: result.meta,
-    };
-  }
-
-  async getById<E extends readonly ProjectExpandPath[] = never[]>(
-    id: string,
-    options?: { expand?: E },
-  ): Promise<SingleResult<WithProjectExpand<ResolveProject<S>, E, S>>> {
-    const query: Record<string, string | undefined> = {};
-    if (options?.expand?.length) query['expand'] = options.expand.join(',');
-
-    const result = await this.transport.get<unknown>(`/api/v1/data/projects/${id}`, query);
-
-    if ('error' in result) return result as ErrorResult;
-
-    return {
-      data: transformProject(result.data) as WithProjectExpand<ResolveProject<S>, E, S>,
-    };
-  }
-}

package/src/transform.ts

@@ -1,266 +0,0 @@
-/**
- * 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.
- */
-
-type Raw = Record<string, unknown>;
-
-function str(v: unknown): string | null {
-  return typeof v === 'string' ? v : null;
-}
-function num(v: unknown): number | null {
-  return typeof v === 'number' ? v : null;
-}
-function bool(v: unknown): boolean {
-  return v === true;
-}
-
-function transformProfile(profile: unknown): Record<string, unknown> {
-  if (!profile || typeof profile !== 'object') return {};
-  const p = profile as Raw;
-  const out: Raw = {};
-  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: unknown): Record<string, unknown> | null {
-  if (!raw || typeof raw !== 'object') return null;
-  const r = raw as 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: unknown): Record<string, unknown> {
-  const r = (raw ?? {}) as 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']),
-  };
-}
-
-export function transformEmployee(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  // 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'] as unknown[]).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;
-}
-
-export function transformProject(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  // 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'] as unknown[]).map((m) => {
-      const mem = (m ?? {}) as Raw;
-      const entry: Raw = {
-        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;
-}
-
-export function transformClient(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  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'] as unknown[]).map(transformProject);
-  }
-
-  return out;
-}
-
-export function transformPartner(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  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'] as unknown[]).map(transformEmployee);
-  }
-
-  return out;
-}
-
-export function transformDepartment(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  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;
-}
-
-export function transformProjectType(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  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;
-}
-
-export function transformCurrency(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  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;
-}
-
-export function transformGenericRate(raw: unknown): Record<string, unknown> {
-  if (!raw || typeof raw !== 'object') return {};
-  const r = raw as Raw;
-  const out: Raw = {};
-
-  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;
-}

package/src/transport.ts

@@ -1,145 +0,0 @@
-/**
- * HTTP transport — wraps ofetch so resource files never see raw network concerns.
- * All methods return result objects; they never throw.
- */
-
-import { $fetch, FetchError } from 'ofetch';
-import type { ErrorCode, ErrorResult, SuccessResult, ListResult, ListMeta } from './types';
-
-const DEFAULT_BASE_URL = 'https://nucleus.typeb.digital';
-
-type ApiSuccessEnvelope<T> = { success: true; data: T };
-type ApiPaginatedEnvelope<T> = {
-  success: true;
-  data: T[];
-  meta: { total: number; page: number; pageSize: number };
-};
-type ApiErrorEnvelope = { success: false; error: string };
-
-function statusToCode(status: number, apiCode?: string): ErrorCode {
-  if (apiCode === 'INVALID_SCOPE') return 'INVALID_SCOPE';
-  if (status === 404) return 'NOT_FOUND';
-  if (status === 429) return 'RATE_LIMITED';
-  return 'FORBIDDEN';
-}
-
-function makeErrorResult(code: ErrorCode, message: string): ErrorResult {
-  return { error: { code, message } };
-}
-
-export class NucleusTransport {
-  private readonly headers: Record<string, string>;
-  private readonly baseUrl: string;
-
-  constructor(token: string, baseUrl?: string) {
-    this.headers = {
-      Authorization: `Bearer ${token}`,
-      'Content-Type': 'application/json',
-    };
-    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
-  }
-
-  async get<T>(
-    path: string,
-    query?: Record<string, string | number | undefined>,
-  ): Promise<SuccessResult<T> | ErrorResult> {
-    try {
-      const params = query
-        ? Object.fromEntries(Object.entries(query).filter(([, v]) => v !== undefined))
-        : undefined;
-
-      const envelope = await $fetch<ApiSuccessEnvelope<T> | ApiErrorEnvelope>(
-        `${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 FetchError) {
-        const body = err.data as Partial<ApiErrorEnvelope> | undefined;
-        const code = statusToCode(err.status ?? 0, body?.error);
-        return makeErrorResult(code, err.message);
-      }
-      return makeErrorResult('NETWORK_ERROR', String(err));
-    }
-  }
-
-  async post<T>(path: string, body: unknown): Promise<SuccessResult<T> | ErrorResult> {
-    try {
-      const envelope = await $fetch<ApiSuccessEnvelope<T> | ApiErrorEnvelope>(
-        `${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 FetchError) {
-        const errBody = err.data as Partial<ApiErrorEnvelope> | undefined;
-        return makeErrorResult(statusToCode(err.status ?? 0, errBody?.error), err.message);
-      }
-      return makeErrorResult('NETWORK_ERROR', String(err));
-    }
-  }
-
-  async del<T = null>(
-    path: string,
-    query?: Record<string, string | undefined>,
-  ): Promise<SuccessResult<T> | ErrorResult> {
-    try {
-      const params = query
-        ? Object.fromEntries(Object.entries(query).filter(([, v]) => v !== undefined))
-        : undefined;
-      const envelope = await $fetch<ApiSuccessEnvelope<T> | ApiErrorEnvelope>(
-        `${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 FetchError) {
-        const errBody = err.data as Partial<ApiErrorEnvelope> | undefined;
-        return makeErrorResult(statusToCode(err.status ?? 0, errBody?.error), err.message);
-      }
-      return makeErrorResult('NETWORK_ERROR', String(err));
-    }
-  }
-
-  async getList<T>(
-    path: string,
-    query?: Record<string, string | number | undefined>,
-  ): Promise<ListResult<T> | ErrorResult> {
-    try {
-      const params = query
-        ? Object.fromEntries(Object.entries(query).filter(([, v]) => v !== undefined))
-        : undefined;
-
-      const envelope = await $fetch<ApiPaginatedEnvelope<T> | ApiErrorEnvelope>(
-        `${this.baseUrl}${path}`,
-        { method: 'GET', headers: this.headers, params },
-      );
-
-      if (!envelope.success) {
-        return makeErrorResult('FORBIDDEN', envelope.error);
-      }
-
-      const { data, meta } = envelope as ApiPaginatedEnvelope<T>;
-      const listMeta: 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 FetchError) {
-        const body = err.data as Partial<ApiErrorEnvelope> | undefined;
-        const code = statusToCode(err.status ?? 0, body?.error);
-        return makeErrorResult(code, err.message);
-      }
-      return makeErrorResult('NETWORK_ERROR', String(err));
-    }
-  }
-}