@symbiosis-lab/moss-plugin-matters 1.4.2

package/test-helpers/api-client.ts

@@ -0,0 +1,252 @@
+/**
+ * Direct HTTP client for E2E tests against Matters API
+ * Uses fetch directly without Tauri IPC
+ */
+
+export interface GraphQLResponse<T> {
+  data?: T;
+  errors?: Array<{ message: string }>;
+}
+
+const DEFAULT_ENDPOINT = "https://server.matters.icu/graphql";
+
+export async function graphqlQuery<T>(
+  query: string,
+  variables?: Record<string, unknown>,
+  endpoint = DEFAULT_ENDPOINT
+): Promise<T> {
+  const response = await fetch(endpoint, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ query, variables }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+  }
+
+  const result: GraphQLResponse<T> = await response.json();
+
+  if (result.errors && result.errors.length > 0) {
+    throw new Error(`GraphQL error: ${result.errors[0].message}`);
+  }
+
+  if (!result.data) {
+    throw new Error("No data returned from GraphQL query");
+  }
+
+  return result.data;
+}
+
+// Pre-defined queries for testing
+
+export const USER_ARTICLES_QUERY = `
+query UserArticles($userName: String!, $after: String) {
+  user(input: { userName: $userName }) {
+    id
+    userName
+    articles(input: { first: 50, after: $after, filter: { state: active } }) {
+      totalCount
+      pageInfo {
+        endCursor
+        hasNextPage
+      }
+      edges {
+        node {
+          id
+          title
+          slug
+          shortHash
+          content
+          summary
+          createdAt
+          revisedAt
+          tags {
+            id
+            content
+          }
+          cover
+        }
+      }
+    }
+  }
+}
+`;
+
+export const USER_PROFILE_QUERY = `
+query UserProfile($userName: String!) {
+  user(input: { userName: $userName }) {
+    id
+    userName
+    displayName
+    info {
+      description
+      profileCover
+    }
+    avatar
+    settings {
+      language
+    }
+  }
+}
+`;
+
+export const USER_COLLECTIONS_QUERY = `
+query UserCollections($userName: String!, $after: String) {
+  user(input: { userName: $userName }) {
+    id
+    collections(input: { first: 50, after: $after }) {
+      totalCount
+      pageInfo {
+        endCursor
+        hasNextPage
+      }
+      edges {
+        node {
+          id
+          title
+          description
+          cover
+          articles(input: { first: 100 }) {
+            edges {
+              node {
+                id
+                shortHash
+                title
+                slug
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+`;
+
+// Convenience functions for common operations
+
+export interface UserArticle {
+  id: string;
+  title: string;
+  slug: string;
+  shortHash: string;
+  content: string;
+  summary: string;
+  createdAt: string;
+  revisedAt?: string;
+  cover?: string;
+  tags?: Array<{ id: string; content: string }>;
+}
+
+export interface UserProfile {
+  id: string;
+  userName: string;
+  displayName: string;
+  avatar?: string;
+  info?: {
+    description?: string;
+    profileCover?: string;
+  };
+  settings?: {
+    language?: string;
+  };
+}
+
+export interface UserCollection {
+  id: string;
+  title: string;
+  description?: string;
+  cover?: string;
+  articles: {
+    edges?: Array<{
+      node: {
+        id: string;
+        shortHash: string;
+        title: string;
+        slug: string;
+      };
+    }>;
+  };
+}
+
+export async function fetchUserArticles(
+  userName: string,
+  endpoint = DEFAULT_ENDPOINT
+): Promise<UserArticle[]> {
+  const allArticles: UserArticle[] = [];
+  let cursor: string | undefined;
+
+  do {
+    const data = await graphqlQuery<{
+      user?: {
+        articles: {
+          edges?: Array<{ node: UserArticle }>;
+          pageInfo: { endCursor?: string; hasNextPage: boolean };
+        };
+      };
+    }>(USER_ARTICLES_QUERY, { userName, after: cursor }, endpoint);
+
+    if (!data.user) {
+      throw new Error(`User not found: ${userName}`);
+    }
+
+    const edges = data.user.articles.edges ?? [];
+    for (const edge of edges) {
+      allArticles.push(edge.node);
+    }
+
+    cursor = data.user.articles.pageInfo.hasNextPage
+      ? data.user.articles.pageInfo.endCursor
+      : undefined;
+  } while (cursor);
+
+  return allArticles;
+}
+
+export async function fetchUserProfile(
+  userName: string,
+  endpoint = DEFAULT_ENDPOINT
+): Promise<UserProfile | null> {
+  const data = await graphqlQuery<{
+    user?: UserProfile;
+  }>(USER_PROFILE_QUERY, { userName }, endpoint);
+
+  return data.user ?? null;
+}
+
+export async function fetchUserCollections(
+  userName: string,
+  endpoint = DEFAULT_ENDPOINT
+): Promise<UserCollection[]> {
+  const allCollections: UserCollection[] = [];
+  let cursor: string | undefined;
+
+  do {
+    const data = await graphqlQuery<{
+      user?: {
+        collections: {
+          edges?: Array<{ node: UserCollection }>;
+          pageInfo: { endCursor?: string; hasNextPage: boolean };
+        };
+      };
+    }>(USER_COLLECTIONS_QUERY, { userName, after: cursor }, endpoint);
+
+    if (!data.user) {
+      throw new Error(`User not found: ${userName}`);
+    }
+
+    const edges = data.user.collections.edges ?? [];
+    for (const edge of edges) {
+      allCollections.push(edge.node);
+    }
+
+    cursor = data.user.collections.pageInfo.hasNextPage
+      ? data.user.collections.pageInfo.endCursor
+      : undefined;
+  } while (cursor);
+
+  return allCollections;
+}

package/test-helpers/fixtures/articles.ts

@@ -0,0 +1,147 @@
+/**
+ * Sample article fixtures for testing
+ */
+
+import type { MattersArticle, MattersDraft, MattersCollection, MattersUserProfile } from "../../src/types";
+
+export const sampleArticle: MattersArticle = {
+  id: "QXJ0aWNsZToxMjM0NQ==",
+  title: "Test Article Title",
+  slug: "test-article-title",
+  shortHash: "abc123",
+  content: "<p>This is the article content with <strong>bold</strong> and <em>italic</em> text.</p>",
+  summary: "A brief summary of the article",
+  createdAt: "2024-01-15T10:30:00Z",
+  revisedAt: "2024-01-20T15:45:00Z",
+  cover: "https://assets.matters.town/processed/abc123-cover.jpg",
+  tags: [
+    { id: "VGFnOjE=", content: "Technology" },
+    { id: "VGFnOjI=", content: "Testing" },
+  ],
+};
+
+export const sampleArticleWithImages: MattersArticle = {
+  id: "QXJ0aWNsZTo2Nzg5MA==",
+  title: "Article with Images",
+  slug: "article-with-images",
+  shortHash: "def456",
+  content: `
+    <p>Introduction paragraph.</p>
+    <figure class="image">
+      <img src="https://assets.matters.town/processed/image1.jpg" alt="First image">
+      <figcaption>Caption for first image</figcaption>
+    </figure>
+    <p>Middle paragraph.</p>
+    <figure class="image">
+      <img src="https://assets.matters.town/processed/image2.png" alt="Second image">
+    </figure>
+    <p>Conclusion paragraph.</p>
+  `,
+  summary: "An article with embedded images",
+  createdAt: "2024-02-01T08:00:00Z",
+  tags: [],
+};
+
+export const sampleDraft: MattersDraft = {
+  id: "RHJhZnQ6OTg3NjU=",
+  title: "Draft in Progress",
+  content: "<p>This is a draft that is still being written.</p>",
+  summary: "Draft summary",
+  createdAt: "2024-02-10T12:00:00Z",
+  updatedAt: "2024-02-11T14:30:00Z",
+  tags: ["WIP", "Ideas"],
+  cover: undefined,
+};
+
+export const sampleCollection: MattersCollection = {
+  id: "Q29sbGVjdGlvbjoxMjM=",
+  title: "My Best Articles",
+  description: "A collection of my favorite articles",
+  cover: "https://assets.matters.town/processed/collection-cover.jpg",
+  articles: [
+    { id: "1", shortHash: "abc123", title: "Test Article Title", slug: "test-article-title" },
+    { id: "2", shortHash: "def456", title: "Article with Images", slug: "article-with-images" },
+  ],
+};
+
+export const sampleUserProfile: MattersUserProfile = {
+  userName: "testuser",
+  displayName: "Test User",
+  description: "A test user for unit tests",
+  avatar: "https://assets.matters.town/avatar/test.jpg",
+  profileCover: "https://assets.matters.town/cover/test.jpg",
+  language: "en",
+};
+
+export const sampleChineseUserProfile: MattersUserProfile = {
+  userName: "zhongwen",
+  displayName: "Traditional Chinese User",
+  description: "Traditional Chinese User Description",
+  avatar: "https://assets.matters.town/avatar/zh.jpg",
+  language: "zh_hant",
+};
+
+// Create multiple articles for pagination testing
+export function createMultipleArticles(count: number): MattersArticle[] {
+  return Array.from({ length: count }, (_, i) => ({
+    id: `QXJ0aWNsZToke2krMX0=`,
+    title: `Article ${i + 1}`,
+    slug: `article-${i + 1}`,
+    shortHash: `hash${i + 1}`,
+    content: `<p>Content for article ${i + 1}</p>`,
+    summary: `Summary for article ${i + 1}`,
+    createdAt: new Date(Date.now() - i * 86400000).toISOString(),
+    tags: [{ id: `VGFnOiR7aX0=`, content: `Tag${i % 5}` }],
+  }));
+}
+
+// Create articles that belong to multiple collections (for file mode testing)
+export function createMultiCollectionArticles(): {
+  articles: MattersArticle[];
+  collections: MattersCollection[];
+} {
+  const articles: MattersArticle[] = [
+    {
+      id: "1",
+      title: "Shared Article",
+      slug: "shared-article",
+      shortHash: "shared1",
+      content: "<p>This article belongs to multiple collections</p>",
+      summary: "Shared article summary",
+      createdAt: "2024-01-01T00:00:00Z",
+      tags: [],
+    },
+    {
+      id: "2",
+      title: "Exclusive Article",
+      slug: "exclusive-article",
+      shortHash: "excl1",
+      content: "<p>This article belongs to only one collection</p>",
+      summary: "Exclusive article summary",
+      createdAt: "2024-01-02T00:00:00Z",
+      tags: [],
+    },
+  ];
+
+  const collections: MattersCollection[] = [
+    {
+      id: "col1",
+      title: "Collection A",
+      description: "First collection",
+      articles: [
+        { id: "1", shortHash: "shared1", title: "Shared Article", slug: "shared-article" },
+        { id: "2", shortHash: "excl1", title: "Exclusive Article", slug: "exclusive-article" },
+      ],
+    },
+    {
+      id: "col2",
+      title: "Collection B",
+      description: "Second collection",
+      articles: [
+        { id: "1", shortHash: "shared1", title: "Shared Article", slug: "shared-article" },
+      ],
+    },
+  ];
+
+  return { articles, collections };
+}

package/test-helpers/wallet-auth.ts

@@ -0,0 +1,305 @@
+/**
+ * Ethereum Wallet Authentication for E2E Testing
+ *
+ * Uses Ethereum wallet signature to authenticate with Matters.icu (test environment).
+ * This allows programmatic login without email verification.
+ *
+ * Authentication Flow (EIP-4361 Sign-In with Ethereum):
+ * 1. Generate signing message with wallet address
+ * 2. Sign the message with private key
+ * 3. Submit signature to login/signup
+ * 4. Receive auth token
+ *
+ * Environment Variables:
+ * - MATTERS_TEST_WALLET_PRIVATE_KEY: Ethereum private key for test account
+ * - MATTERS_TEST_ENDPOINT: GraphQL endpoint (default: https://server.matters.icu/graphql)
+ */
+
+import { graphqlQuery } from "./api-client";
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+const DEFAULT_ENDPOINT = "https://server.matters.icu/graphql";
+
+function getEnv(key: string): string | undefined {
+  return process.env[key];
+}
+
+// ============================================================================
+// GraphQL Mutations
+// ============================================================================
+
+const GENERATE_SIGNING_MESSAGE_MUTATION = `
+mutation GenerateSigningMessage($input: GenerateSigningMessageInput!) {
+  generateSigningMessage(input: $input) {
+    nonce
+    purpose
+    signingMessage
+    createdAt
+    expiredAt
+  }
+}
+`;
+
+const WALLET_LOGIN_MUTATION = `
+mutation WalletLogin($input: WalletLoginInput!) {
+  walletLogin(input: $input) {
+    auth
+    token
+    type
+    user {
+      id
+      userName
+      displayName
+    }
+  }
+}
+`;
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface GenerateSigningMessageResponse {
+  generateSigningMessage: {
+    nonce: string;
+    purpose: string;
+    signingMessage: string;
+    createdAt: string;
+    expiredAt: string;
+  };
+}
+
+interface WalletLoginResponse {
+  walletLogin: {
+    auth: boolean;
+    token: string | null;
+    type: "Login" | "Signup" | "LinkAccount";
+    user: {
+      id: string;
+      userName: string;
+      displayName: string;
+    } | null;
+  };
+}
+
+export interface WalletAuthResult {
+  token: string;
+  user: {
+    id: string;
+    userName: string;
+    displayName: string;
+  };
+  type: "Login" | "Signup" | "LinkAccount";
+}
+
+// ============================================================================
+// Wallet Utilities
+// ============================================================================
+
+/**
+ * Simple Ethereum signing implementation using Web Crypto API
+ * Note: For production, use ethers.js or viem
+ */
+
+// keccak256 hash function (simplified for personal_sign)
+// In real implementation, use ethers.js or viem
+async function signMessage(message: string, privateKey: string): Promise<string> {
+  // For now, we'll use dynamic import of ethers since it's commonly available
+  // In CI, we'll need to ensure ethers is installed as a dev dependency
+  try {
+    // Try to use ethers.js if available
+    const { Wallet } = await import("ethers");
+    const wallet = new Wallet(privateKey);
+    return wallet.signMessage(message);
+  } catch {
+    throw new Error(
+      "ethers.js is required for wallet signing. Install with: npm install --save-dev ethers"
+    );
+  }
+}
+
+/**
+ * Derive Ethereum address from private key
+ */
+async function getAddressFromPrivateKey(privateKey: string): Promise<string> {
+  try {
+    const { Wallet } = await import("ethers");
+    const wallet = new Wallet(privateKey);
+    return wallet.address;
+  } catch {
+    throw new Error(
+      "ethers.js is required for address derivation. Install with: npm install --save-dev ethers"
+    );
+  }
+}
+
+// ============================================================================
+// Authentication Functions
+// ============================================================================
+
+/**
+ * Authenticate with Matters using Ethereum wallet
+ *
+ * @param privateKey - Ethereum private key (hex string, with or without 0x prefix)
+ * @param endpoint - GraphQL endpoint (default: matters.icu test environment)
+ * @returns Authentication result with token and user info
+ */
+export async function walletLogin(
+  privateKey?: string,
+  endpoint = DEFAULT_ENDPOINT
+): Promise<WalletAuthResult> {
+  // Get private key from param or environment
+  const key = privateKey || getEnv("MATTERS_TEST_WALLET_PRIVATE_KEY");
+  if (!key) {
+    throw new Error(
+      "Private key required. Pass as parameter or set MATTERS_TEST_WALLET_PRIVATE_KEY environment variable."
+    );
+  }
+
+  // Normalize private key (ensure 0x prefix)
+  const normalizedKey = key.startsWith("0x") ? key : `0x${key}`;
+
+  // Step 1: Get wallet address
+  const address = await getAddressFromPrivateKey(normalizedKey);
+  console.log(`🔐 Authenticating with wallet: ${address}`);
+
+  // Step 2: Generate signing message
+  console.log("   Generating signing message...");
+  const signingData = await graphqlQuery<GenerateSigningMessageResponse>(
+    GENERATE_SIGNING_MESSAGE_MUTATION,
+    {
+      input: {
+        address,
+        purpose: "login",
+      },
+    },
+    endpoint
+  );
+
+  const { nonce, signingMessage } = signingData.generateSigningMessage;
+  console.log(`   Nonce: ${nonce}`);
+
+  // Step 3: Sign the message
+  console.log("   Signing message...");
+  const signature = await signMessage(signingMessage, normalizedKey);
+  console.log(`   Signature: ${signature.substring(0, 20)}...`);
+
+  // Step 4: Login with signature
+  console.log("   Submitting login...");
+  const loginData = await graphqlQuery<WalletLoginResponse>(
+    WALLET_LOGIN_MUTATION,
+    {
+      input: {
+        ethAddress: address,
+        nonce,
+        signature,
+        signedMessage: signingMessage,
+      },
+    },
+    endpoint
+  );
+
+  const { auth, token, type, user } = loginData.walletLogin;
+
+  if (!auth || !token || !user) {
+    throw new Error("Login failed: auth returned false or no token received");
+  }
+
+  console.log(`   ✅ ${type}: @${user.userName}`);
+
+  return {
+    token,
+    user,
+    type,
+  };
+}
+
+/**
+ * Create an authenticated GraphQL query function
+ *
+ * @param token - Authentication token from walletLogin
+ * @param endpoint - GraphQL endpoint
+ * @returns Function that makes authenticated GraphQL queries
+ */
+export function createAuthenticatedClient(
+  token: string,
+  endpoint = DEFAULT_ENDPOINT
+) {
+  return async function authenticatedQuery<T>(
+    query: string,
+    variables?: Record<string, unknown>
+  ): Promise<T> {
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-access-token": token,
+      },
+      body: JSON.stringify({ query, variables }),
+    });
+
+    if (!response.ok) {
+      throw new Error(`HTTP error: ${response.status} ${response.statusText}`);
+    }
+
+    interface GraphQLResponse<T> {
+      data?: T;
+      errors?: Array<{ message: string }>;
+    }
+
+    const result: GraphQLResponse<T> = await response.json();
+
+    if (result.errors && result.errors.length > 0) {
+      throw new Error(`GraphQL error: ${result.errors[0].message}`);
+    }
+
+    if (!result.data) {
+      throw new Error("No data returned from GraphQL query");
+    }
+
+    return result.data;
+  };
+}
+
+// ============================================================================
+// Test Utilities
+// ============================================================================
+
+/**
+ * Get or create a test account
+ *
+ * If the wallet has never been used, it will create a new account (Signup).
+ * Otherwise, it will log in to the existing account (Login).
+ */
+export async function getTestAccount(
+  endpoint = DEFAULT_ENDPOINT
+): Promise<WalletAuthResult> {
+  return walletLogin(undefined, endpoint);
+}
+
+/**
+ * Generate a new random wallet for testing
+ *
+ * Returns the private key and address.
+ * Note: The account won't exist on Matters until first login.
+ */
+export async function generateTestWallet(): Promise<{
+  privateKey: string;
+  address: string;
+}> {
+  try {
+    const { Wallet } = await import("ethers");
+    const wallet = Wallet.createRandom();
+    return {
+      privateKey: wallet.privateKey,
+      address: wallet.address,
+    };
+  } catch {
+    throw new Error(
+      "ethers.js is required. Install with: npm install --save-dev ethers"
+    );
+  }
+}