getjobber-cli 1.0.0__py3-none-any.whl

getjobber_cli/__init__.py

@@ -0,0 +1,5 @@
+"""GetJobber CLI - Terminal access to GetJobber CRM API."""
+
+from getjobber_cli.constants import APP_VERSION
+
+__version__ = APP_VERSION

getjobber_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for GetJobber CLI."""
+
+from getjobber_cli.cli import app
+
+if __name__ == "__main__":
+    app()

getjobber_cli/api/client.py

@@ -0,0 +1,149 @@
+"""GraphQL client for GetJobber API."""
+
+from typing import Any, Dict, Optional
+
+from gql import Client, gql
+from gql.transport.requests import RequestsHTTPTransport
+
+from getjobber_cli.constants import API_BASE_URL, DEFAULT_TIMEOUT
+from getjobber_cli.utils.errors import GraphQLError, JobberAPIError, NotAuthenticatedError
+
+
+def create_client(access_token: str, api_url: str = API_BASE_URL) -> Client:
+    """Create configured GraphQL client.
+
+    Args:
+        access_token: OAuth access token for authentication.
+        api_url: API endpoint URL.
+
+    Returns:
+        Configured GQL Client instance.
+
+    Raises:
+        NotAuthenticatedError: If access token is not provided.
+    """
+    if not access_token:
+        raise NotAuthenticatedError()
+
+    # Configure transport with authentication
+    # Jobber requires X-JOBBER-GRAPHQL-VERSION; pin to a known stable schema date
+    transport = RequestsHTTPTransport(
+        url=api_url,
+        headers={
+            "Authorization": f"Bearer {access_token}",
+            "Content-Type": "application/json",
+            "X-JOBBER-GRAPHQL-VERSION": "2025-04-16",
+        },
+        timeout=DEFAULT_TIMEOUT,
+        verify=True,
+        retries=3,
+    )
+
+    # Create client with schema introspection
+    client = Client(
+        transport=transport,
+        fetch_schema_from_transport=False,  # Disable for now, can be enabled later
+    )
+
+    return client
+
+
+def execute_query(client: Client, query: str, variables: Optional[Dict[str, Any]] = None) -> Dict:
+    """Execute a GraphQL query.
+
+    Args:
+        client: GQL Client instance.
+        query: GraphQL query string.
+        variables: Optional query variables.
+
+    Returns:
+        Query result dictionary.
+
+    Raises:
+        GraphQLError: If query execution fails.
+        JobberAPIError: If API returns an error.
+    """
+    try:
+        # Parse query
+        parsed_query = gql(query)
+
+        # Execute query
+        result = client.execute(parsed_query, variable_values=variables)
+        return result
+
+    except Exception as e:
+        error_message = str(e)
+
+        # Check if it's a GraphQL error with structured errors
+        if hasattr(e, "errors") and e.errors:
+            raise GraphQLError("GraphQL query failed", errors=e.errors)
+
+        # Check for authentication errors
+        if "401" in error_message or "Unauthorized" in error_message:
+            raise NotAuthenticatedError("Authentication failed. Please login again.")
+
+        # Check for rate limiting
+        if "429" in error_message or "rate limit" in error_message.lower():
+            from getjobber_cli.utils.errors import RateLimitError
+
+            raise RateLimitError()
+
+        # Generic GraphQL error
+        raise GraphQLError(error_message)
+
+
+def execute_mutation(
+    client: Client, mutation: str, variables: Optional[Dict[str, Any]] = None
+) -> Dict:
+    """Execute a GraphQL mutation.
+
+    Args:
+        client: GQL Client instance.
+        mutation: GraphQL mutation string.
+        variables: Optional mutation variables.
+
+    Returns:
+        Mutation result dictionary.
+
+    Raises:
+        GraphQLError: If mutation execution fails.
+        JobberAPIError: If API returns an error.
+    """
+    # Mutations use the same execution as queries
+    return execute_query(client, mutation, variables)
+
+
+class GraphQLClient:
+    """Wrapper class for GraphQL client operations."""
+
+    def __init__(self, access_token: str):
+        """Initialize GraphQL client wrapper.
+
+        Args:
+            access_token: OAuth access token.
+        """
+        self.client = create_client(access_token)
+
+    def query(self, query: str, variables: Optional[Dict[str, Any]] = None) -> Dict:
+        """Execute a GraphQL query.
+
+        Args:
+            query: GraphQL query string.
+            variables: Optional query variables.
+
+        Returns:
+            Query result dictionary.
+        """
+        return execute_query(self.client, query, variables)
+
+    def mutate(self, mutation: str, variables: Optional[Dict[str, Any]] = None) -> Dict:
+        """Execute a GraphQL mutation.
+
+        Args:
+            mutation: GraphQL mutation string.
+            variables: Optional mutation variables.
+
+        Returns:
+            Mutation result dictionary.
+        """
+        return execute_mutation(self.client, mutation, variables)

getjobber_cli/api/mutations.py

@@ -0,0 +1,251 @@
+"""Pre-built GraphQL mutations for GetJobber API."""
+
+# Client Mutations
+CREATE_CLIENT = """
+mutation CreateClient($input: ClientInput!) {
+  clientCreate(input: $input) {
+    client {
+      id
+      firstName
+      lastName
+      companyName
+      email
+      phoneNumber
+      createdAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+UPDATE_CLIENT = """
+mutation UpdateClient($id: ID!, $input: ClientInput!) {
+  clientUpdate(id: $id, input: $input) {
+    client {
+      id
+      firstName
+      lastName
+      companyName
+      email
+      phoneNumber
+      updatedAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+DELETE_CLIENT = """
+mutation DeleteClient($id: ID!) {
+  clientArchive(id: $id) {
+    client {
+      id
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+# Job Mutations
+CREATE_JOB = """
+mutation CreateJob($input: JobInput!) {
+  jobCreate(input: $input) {
+    job {
+      id
+      title
+      jobNumber
+      status
+      client {
+        id
+        firstName
+        lastName
+      }
+      createdAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+UPDATE_JOB = """
+mutation UpdateJob($id: ID!, $input: JobInput!) {
+  jobUpdate(id: $id, input: $input) {
+    job {
+      id
+      title
+      jobNumber
+      status
+      updatedAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+COMPLETE_JOB = """
+mutation CompleteJob($id: ID!) {
+  jobComplete(id: $id) {
+    job {
+      id
+      title
+      status
+      completedAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+# Quote Mutations
+CREATE_QUOTE = """
+mutation CreateQuote($input: QuoteInput!) {
+  quoteCreate(input: $input) {
+    quote {
+      id
+      quoteNumber
+      title
+      status
+      client {
+        id
+        firstName
+        lastName
+      }
+      totalAmount
+      createdAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+UPDATE_QUOTE = """
+mutation UpdateQuote($id: ID!, $input: QuoteInput!) {
+  quoteUpdate(id: $id, input: $input) {
+    quote {
+      id
+      quoteNumber
+      title
+      status
+      updatedAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+SEND_QUOTE = """
+mutation SendQuote($id: ID!) {
+  quoteSend(id: $id) {
+    quote {
+      id
+      quoteNumber
+      status
+      sentAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+APPROVE_QUOTE = """
+mutation ApproveQuote($id: ID!) {
+  quoteApprove(id: $id) {
+    quote {
+      id
+      quoteNumber
+      status
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+# Invoice Mutations
+CREATE_INVOICE = """
+mutation CreateInvoice($input: InvoiceInput!) {
+  invoiceCreate(input: $input) {
+    invoice {
+      id
+      invoiceNumber
+      subject
+      status
+      client {
+        id
+        firstName
+        lastName
+      }
+      totalAmount
+      createdAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+UPDATE_INVOICE = """
+mutation UpdateInvoice($id: ID!, $input: InvoiceInput!) {
+  invoiceUpdate(id: $id, input: $input) {
+    invoice {
+      id
+      invoiceNumber
+      subject
+      status
+      updatedAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""
+
+SEND_INVOICE = """
+mutation SendInvoice($id: ID!) {
+  invoiceSend(id: $id) {
+    invoice {
+      id
+      invoiceNumber
+      status
+      sentAt
+    }
+    userErrors {
+      message
+      path
+    }
+  }
+}
+"""

getjobber_cli/api/queries.py

@@ -0,0 +1,264 @@
+"""Pre-built GraphQL queries for GetJobber API."""
+
+# Client Queries
+LIST_CLIENTS = """
+query ListClients($first: Int, $after: String) {
+  clients(first: $first, after: $after) {
+    nodes {
+      id
+      firstName
+      lastName
+      companyName
+      email
+      phone
+      createdAt
+      updatedAt
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    totalCount
+  }
+}
+"""
+
+GET_CLIENT = """
+query GetClient($id: ID!) {
+  client(id: $id) {
+    id
+    firstName
+    lastName
+    companyName
+    email
+    phone
+    phones { nodes { number smsAllowed } }
+    billingAddress {
+      street1
+      street2
+      city
+      province
+      postalCode
+      country
+    }
+    tags
+    createdAt
+    updatedAt
+  }
+}
+"""
+
+SEARCH_CLIENTS = """
+query SearchClients($query: String!, $first: Int) {
+  clients(first: $first, filter: {search: $query}) {
+    nodes {
+      id
+      firstName
+      lastName
+      companyName
+      email
+      phone
+    }
+    totalCount
+  }
+}
+"""
+
+# Job Queries
+LIST_JOBS = """
+query ListJobs($first: Int, $after: String, $status: String) {
+  jobs(first: $first, after: $after, filter: {status: $status}) {
+    nodes {
+      id
+      title
+      jobNumber
+      status
+      client {
+        id
+        firstName
+        lastName
+        companyName
+      }
+      startAt
+      endAt
+      createdAt
+      updatedAt
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    totalCount
+  }
+}
+"""
+
+GET_JOB = """
+query GetJob($id: ID!) {
+  job(id: $id) {
+    id
+    title
+    jobNumber
+    status
+    description
+    client {
+      id
+      firstName
+      lastName
+      companyName
+      email
+    }
+    property {
+      id
+      address {
+        street1
+        street2
+        city
+        province
+        postalCode
+      }
+    }
+    startAt
+    endAt
+    totalAmount
+    createdAt
+    updatedAt
+  }
+}
+"""
+
+# Quote Queries
+LIST_QUOTES = """
+query ListQuotes($first: Int, $after: String, $status: String) {
+  quotes(first: $first, after: $after, filter: {status: $status}) {
+    nodes {
+      id
+      quoteNumber
+      title
+      status
+      client {
+        id
+        firstName
+        lastName
+        companyName
+      }
+      totalAmount
+      sentAt
+      createdAt
+      updatedAt
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    totalCount
+  }
+}
+"""
+
+GET_QUOTE = """
+query GetQuote($id: ID!) {
+  quote(id: $id) {
+    id
+    quoteNumber
+    title
+    status
+    message
+    client {
+      id
+      firstName
+      lastName
+      companyName
+      email
+    }
+    lineItems {
+      id
+      name
+      description
+      quantity
+      unitPrice
+      total
+    }
+    subtotal
+    taxAmount
+    totalAmount
+    sentAt
+    createdAt
+    updatedAt
+  }
+}
+"""
+
+# Invoice Queries
+LIST_INVOICES = """
+query ListInvoices($first: Int, $after: String, $status: String) {
+  invoices(first: $first, after: $after, filter: {status: $status}) {
+    nodes {
+      id
+      invoiceNumber
+      subject
+      status
+      client {
+        id
+        firstName
+        lastName
+        companyName
+      }
+      totalAmount
+      amountPaid
+      balance
+      dueDate
+      sentAt
+      createdAt
+      updatedAt
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+    totalCount
+  }
+}
+"""
+
+GET_INVOICE = """
+query GetInvoice($id: ID!) {
+  invoice(id: $id) {
+    id
+    invoiceNumber
+    subject
+    status
+    message
+    client {
+      id
+      firstName
+      lastName
+      companyName
+      email
+    }
+    job {
+      id
+      title
+      jobNumber
+    }
+    lineItems {
+      id
+      name
+      description
+      quantity
+      unitPrice
+      total
+    }
+    subtotal
+    taxAmount
+    totalAmount
+    amountPaid
+    balance
+    dueDate
+    sentAt
+    paidAt
+    createdAt
+    updatedAt
+  }
+}
+"""