@hed-hog/contact 0.0.329 → 0.0.331

package/hedhog/frontend/app/proposals/_components/proposal-types.ts.ejs

@@ -0,0 +1,172 @@
+export type ProposalStatus =
+  | 'draft'
+  | 'pending_approval'
+  | 'approved'
+  | 'rejected'
+  | 'cancelled'
+  | 'expired'
+  | 'contract_generated';
+
+export type ProposalContractCategory =
+  | 'employee'
+  | 'contractor'
+  | 'client'
+  | 'supplier'
+  | 'vendor'
+  | 'partner'
+  | 'internal'
+  | 'other';
+
+export type ProposalContractType =
+  | 'clt'
+  | 'pj'
+  | 'freelancer_agreement'
+  | 'service_agreement'
+  | 'fixed_term'
+  | 'recurring_service'
+  | 'nda'
+  | 'amendment'
+  | 'addendum'
+  | 'other';
+
+export type ProposalBillingModel =
+  | 'time_and_material'
+  | 'monthly_retainer'
+  | 'fixed_price';
+
+export type ProposalItemType =
+  | 'service'
+  | 'product'
+  | 'fee'
+  | 'discount'
+  | 'note'
+  | 'other';
+
+export type ProposalRecurrence =
+  | 'one_time'
+  | 'monthly'
+  | 'quarterly'
+  | 'yearly'
+  | 'other';
+
+export type ProposalItem = {
+  id?: number;
+  name: string;
+  description?: string | null;
+  quantity?: number | null;
+  unit_amount_cents?: number | null;
+  total_amount_cents?: number | null;
+  item_type?: ProposalItemType | string | null;
+  term_type?: string | null;
+  recurrence?: ProposalRecurrence | string | null;
+  start_date?: string | null;
+  end_date?: string | null;
+  due_day?: number | null;
+};
+
+export type ProposalRevision = {
+  id: number;
+  revision_number: number;
+  is_current?: boolean;
+  title: string;
+  summary?: string | null;
+  valid_until?: string | null;
+  status?: ProposalStatus | string;
+  proposal_item?: ProposalItem[];
+};
+
+export type ProposalApproval = {
+  id: number;
+  status?: string | null;
+  decision_note?: string | null;
+  submitted_at?: string | null;
+  decided_at?: string | null;
+};
+
+export type ProposalDocument = {
+  id: number;
+  file_id?: number | null;
+  file_name?: string | null;
+  mime_type?: string | null;
+  document_type?: string | null;
+  is_current?: boolean | null;
+  created_at?: string | null;
+};
+
+export type ProposalIntegrationLink = {
+  targetModule?: string;
+  targetEntityType?: string;
+  targetEntityId?: string;
+};
+
+export type ProposalRecord = {
+  id: number;
+  person_id: number;
+  code?: string | null;
+  title: string;
+  status: ProposalStatus;
+  contract_category?: ProposalContractCategory | null;
+  contract_type?: ProposalContractType | null;
+  billing_model?: ProposalBillingModel | null;
+  currency_code?: string | null;
+  subtotal_amount_cents?: number | null;
+  discount_amount_cents?: number | null;
+  tax_amount_cents?: number | null;
+  total_amount_cents?: number | null;
+  valid_until?: string | null;
+  current_revision_number?: number | null;
+  approval_count?: number | null;
+  required_approvals?: number | null;
+  current_user_has_approved?: boolean | null;
+  notes?: string | null;
+  created_at?: string | null;
+  updated_at?: string | null;
+  approved_at?: string | null;
+  person?: {
+    id: number;
+    name?: string | null;
+    trade_name?: string | null;
+    email?: string | null;
+    phone?: string | null;
+    avatar_id?: number | null;
+  } | null;
+  proposal_revision?: ProposalRevision[];
+  proposal_approval?: ProposalApproval[];
+  proposal_document?: ProposalDocument[];
+  integration_links?: ProposalIntegrationLink[];
+};
+
+export type GenerateProposalDocumentResponse = {
+  fileId?: number | null;
+  fileName?: string | null;
+  downloadUrl?: string | null;
+};
+
+// ─── Shared utilities ────────────────────────────────────────────────────────
+
+export function formatEnumLabel(value?: string | null) {
+  if (!value) return '—';
+  return value
+    .split('_')
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(' ');
+}
+
+export function getCurrentRevision(proposal?: ProposalRecord | null) {
+  if (!proposal?.proposal_revision?.length) return null;
+  return (
+    proposal.proposal_revision.find((revision) => revision.is_current) ??
+    proposal.proposal_revision[0]
+  );
+}
+
+export function openStoredFile(fileId?: number | null) {
+  if (!fileId) return;
+  const baseUrl = String(process.env.NEXT_PUBLIC_API_BASE_URL || '');
+  window.open(
+    `${baseUrl}/file/open/${fileId}`,
+    '_blank',
+    'noopener,noreferrer'
+  );
+}