API Reference

https://api.stormycms.com/graphql

query {
  page(id: "page_123") {
    id
    meta {
      title
      description
      keywords
    }
    layout_id
    components {
      id
      name
      text
    }
  }
}

query {
  pages(limit: 10, offset: 20) {
    id
    meta {
      title
    }
    created_at
  }
}

type Page {
  id: ID!              # Unique identifier
  meta: Metadata!      # Page metadata
  layouts: [Layout!]!  # Associated layouts
  layout_id: ID!       # Primary layout
  components: [Component!]!  # Page components
  component_ids: [ID!]!      # Component IDs
  site_id: ID!         # Site ID
}

type Layout {
  id: ID!                     # Unique identifier
  name: String!               # Layout name
  props: [[String!]!]!        # Translated properties
  components: [Component!]!   # Layout components
  component_ids: [ID!]!       # Component IDs
  outlet_id: ID!              # Content outlet ID
  child_layout_id: ID         # Child layout ID (optional)
}

type Site {
  id: ID!                              # Unique identifier
  name: String!                        # Site name
  owner_id: ID!                        # Owner user ID
  admin_ids: [UserIdWithDate!]!        # Admin users
  contributor_ids: [UserIdWithDate!]!  # Contributors
  client_id: String!                   # OAuth client ID
  redirect_urls: [String!]!            # OAuth redirect URLs
  created_at: String!                  # Creation timestamp
}

type Metadata {
  title: String!           # Page title
  description: String!     # SEO description
  keywords: [String!]!     # SEO keywords
}

type Component {
  id: ID!                     # Unique identifier
  name: String!               # Component type/name
  props: [[String!]!]!        # Translated properties
  text: String!               # Text content
  child_ids: [ID!]!           # Child component IDs
}

type UserIdWithDate {
  user_id: ID!      # User ID
  add_date: String! # When user was added
}

input MetadataInput {
  title: String          # Optional title
  description: String    # Optional description
  keywords: [String]     # Optional keywords
}

input ComponentInput {
  id: ID                               # Optional ID
  name: String                         # Optional component name
  props: [PropInput]                   # Optional properties
  text: [TranslationInput]             # Optional text content
  child_ids: [ID]                      # Optional child IDs
}

input PropInput {
  key: String!                         # Property key
  translations: [TranslationInput]!    # Property translations
}

input TranslationInput {
  locale: String!      # Language code (e.g., "en", "es")
  value: String!       # Translated value
}

{
  "errors": [
    {
      "message": "Page not found",
      "locations": [{ "line": 2, "column": 3 }],
      "path": ["page"],
      "extensions": { "code": "NOT_FOUND" }
    }
  ],
  "data": null
}

class StormyCMS {
  private apiKey: string;
  private clientId: string;
  private baseUrl: string;

  constructor(apiKey: string, clientId: string) {
    this.apiKey = apiKey;
    this.clientId = clientId;
    this.baseUrl = 'https://api.stormycms.com/graphql';
  }

  async query(query: string, variables?: any) {
    const response = await fetch(this.baseUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-site-api-key': this.apiKey,
        'x-client-id': this.clientId,
      },
      body: JSON.stringify({ query, variables }),
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const result = await response.json();

    if (result.errors) {
      throw new Error(result.errors[0].message);
    }

    return result.data;
  }

  async getPage(id: string) {
    return this.query(`
      query GetPage($id: ID!) {
        page(id: $id) {
          id
          meta { title description }
          components { id name text }
        }
      }
    `, { id });
  }
}