@plures/praxis 1.0.2 → 1.1.0

package/dist/node/cloud/index.js

@@ -0,0 +1,456 @@
+import {
+  connectRelay,
+  createCloudRelay
+} from "../chunk-XCY2VIFX.js";
+import {
+  BillingProvider,
+  GitHubSponsorsClient,
+  SubscriptionStatus,
+  SubscriptionTier,
+  TIER_LIMITS,
+  checkUsageLimits,
+  createFreeSubscription,
+  createSponsorSubscription,
+  createSponsorsClient,
+  hasAccessToTier
+} from "../chunk-DSDC2JWZ.js";
+import {
+  GitHubOAuth,
+  authenticateWithDeviceFlow,
+  createGitHubOAuth
+} from "../chunk-FXQZXAWF.js";
+import "../chunk-QGM4M3NI.js";
+
+// src/cloud/marketplace.ts
+var MARKETPLACE_PLANS = {
+  solo: {
+    name: "Praxis Cloud Solo",
+    description: "For individual developers",
+    monthlyPriceInCents: 500,
+    // $5/month
+    yearlyPriceInCents: 5e3,
+    // $50/year (2 months free)
+    features: ["50,000 syncs/month", "1 GB storage", "10 apps/projects", "Standard support"]
+  },
+  team: {
+    name: "Praxis Cloud Team",
+    description: "For small teams",
+    monthlyPriceInCents: 2e3,
+    // $20/month
+    yearlyPriceInCents: 2e4,
+    // $200/year (2 months free)
+    features: [
+      "500,000 syncs/month",
+      "10 GB storage",
+      "50 apps/projects",
+      "Up to 10 team members",
+      "Standard support"
+    ]
+  },
+  enterprise: {
+    name: "Praxis Cloud Enterprise",
+    description: "For large teams and organizations",
+    monthlyPriceInCents: 5e3,
+    // $50/month
+    yearlyPriceInCents: 5e4,
+    // $500/year (2 months free)
+    features: [
+      "5,000,000 syncs/month",
+      "100 GB storage",
+      "1,000 apps/projects",
+      "Unlimited team members",
+      "Priority support",
+      "SLA guarantees"
+    ]
+  }
+};
+var GitHubMarketplaceClient = class {
+  token;
+  constructor(token) {
+    this.token = token;
+  }
+  /**
+   * Get accounts for the authenticated user
+   */
+  async getAccounts() {
+    try {
+      const response = await fetch("https://api.github.com/marketplace_listing/accounts", {
+        headers: {
+          Authorization: `Bearer ${this.token}`,
+          Accept: "application/vnd.github.v3+json"
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`GitHub API error: ${response.statusText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      console.error("Failed to get marketplace accounts:", error);
+      return [];
+    }
+  }
+  /**
+   * Get subscription from marketplace account
+   */
+  async getSubscription(accountId) {
+    const accounts = await this.getAccounts();
+    const account = accounts.find((a) => a.id === accountId);
+    if (!account) {
+      return null;
+    }
+    let tier = "free" /* FREE */;
+    if (account.plan.monthlyPriceInCents >= 5e3) {
+      tier = "enterprise" /* ENTERPRISE */;
+    } else if (account.plan.monthlyPriceInCents >= 2e3) {
+      tier = "team" /* TEAM */;
+    } else if (account.plan.monthlyPriceInCents >= 500) {
+      tier = "solo" /* SOLO */;
+    }
+    return {
+      tier,
+      status: "active" /* ACTIVE */,
+      provider: "marketplace" /* MARKETPLACE */,
+      marketplacePlanId: account.plan.id,
+      startDate: account.onFreeTrial && account.freeTrialEndsOn ? new Date(account.freeTrialEndsOn).getTime() : Date.now(),
+      periodEnd: account.nextBillingDate ? new Date(account.nextBillingDate).getTime() : void 0,
+      autoRenew: true,
+      limits: TIER_LIMITS[tier]
+    };
+  }
+  /**
+   * Handle marketplace webhook event
+   */
+  handleWebhookEvent(event) {
+    const account = event.marketplacePurchase.account;
+    if (event.action === "cancelled") {
+      return null;
+    }
+    let tier = "free" /* FREE */;
+    if (account.plan.monthlyPriceInCents >= 5e3) {
+      tier = "enterprise" /* ENTERPRISE */;
+    } else if (account.plan.monthlyPriceInCents >= 2e3) {
+      tier = "team" /* TEAM */;
+    } else if (account.plan.monthlyPriceInCents >= 500) {
+      tier = "solo" /* SOLO */;
+    }
+    return {
+      userId: account.id,
+      userLogin: account.login,
+      subscription: {
+        tier,
+        status: "active" /* ACTIVE */,
+        provider: "marketplace" /* MARKETPLACE */,
+        marketplacePlanId: account.plan.id,
+        startDate: Date.now(),
+        periodEnd: event.marketplacePurchase.nextBillingDate ? new Date(event.marketplacePurchase.nextBillingDate).getTime() : void 0,
+        autoRenew: true,
+        limits: TIER_LIMITS[tier]
+      }
+    };
+  }
+};
+function createMarketplaceClient(token) {
+  return new GitHubMarketplaceClient(token);
+}
+
+// src/cloud/provisioning.ts
+function generateStorageNamespace(githubLogin, userId) {
+  const sanitized = githubLogin.toLowerCase().replace(/[^a-z0-9]/g, "-");
+  const hash = userId.toString(36).padStart(6, "0");
+  return `gh-${sanitized}-${hash}`;
+}
+function generateTenantId(githubUser) {
+  return `github-${githubUser.id}`;
+}
+function createTenant(githubUser, subscription) {
+  const tenantId = generateTenantId(githubUser);
+  const storageNamespace = generateStorageNamespace(githubUser.login, githubUser.id);
+  return {
+    id: tenantId,
+    githubUserId: githubUser.id,
+    githubLogin: githubUser.login,
+    type: "user",
+    // Could be "organization" if checking org membership
+    subscription,
+    storageNamespace,
+    createdAt: Date.now(),
+    lastAccessedAt: Date.now()
+  };
+}
+function validateStorageNamespace(namespace) {
+  if (namespace.length < 3 || namespace.length > 63) {
+    return {
+      valid: false,
+      error: "Namespace must be 3-63 characters"
+    };
+  }
+  if (!/^[a-z0-9]/.test(namespace)) {
+    return {
+      valid: false,
+      error: "Namespace must start with a letter or number"
+    };
+  }
+  if (!/^[a-z0-9-]+$/.test(namespace)) {
+    return {
+      valid: false,
+      error: "Namespace can only contain lowercase letters, numbers, and hyphens"
+    };
+  }
+  if (/--/.test(namespace)) {
+    return {
+      valid: false,
+      error: "Namespace cannot contain consecutive hyphens"
+    };
+  }
+  return { valid: true };
+}
+function getAppStorageContainer(tenantNamespace, appId) {
+  const sanitizedAppId = appId.toLowerCase().replace(/[^a-z0-9]/g, "-");
+  return `${tenantNamespace}-${sanitizedAppId}`;
+}
+async function provisionTenant(githubUser, subscription) {
+  try {
+    const tenant = createTenant(githubUser, subscription);
+    const validation = validateStorageNamespace(tenant.storageNamespace);
+    if (!validation.valid) {
+      return {
+        success: false,
+        error: validation.error
+      };
+    }
+    console.log(`Provisioned tenant: ${tenant.id}`);
+    console.log(`Storage namespace: ${tenant.storageNamespace}`);
+    return {
+      success: true,
+      tenant
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function getOrCreateTenant(githubUser, subscription, tenantLookup) {
+  const tenantId = generateTenantId(githubUser);
+  const existing = await tenantLookup(tenantId);
+  if (existing) {
+    existing.lastAccessedAt = Date.now();
+    return existing;
+  }
+  const result = await provisionTenant(githubUser, subscription);
+  if (!result.success || !result.tenant) {
+    throw new Error(`Failed to provision tenant: ${result.error}`);
+  }
+  return result.tenant;
+}
+
+// src/cloud/relay/endpoints.ts
+var storage = {
+  syncs: /* @__PURE__ */ new Map(),
+  usage: /* @__PURE__ */ new Map()
+};
+async function healthEndpoint(context, _req) {
+  context.log("Health check requested");
+  const response = {
+    status: "healthy",
+    timestamp: Date.now(),
+    version: "0.1.0",
+    services: {
+      relay: true,
+      eventGrid: true,
+      storage: true,
+      auth: true
+    }
+  };
+  return {
+    status: 200,
+    headers: { "Content-Type": "application/json" },
+    body: response
+  };
+}
+async function syncEndpoint(context, req) {
+  context.log("Sync request received");
+  if (req.method !== "POST") {
+    return {
+      status: 405,
+      body: { error: "Method not allowed" }
+    };
+  }
+  const message = req.body;
+  if (!message || !message.appId) {
+    return {
+      status: 400,
+      body: { error: "Invalid sync message" }
+    };
+  }
+  const appSyncs = storage.syncs.get(message.appId) || [];
+  appSyncs.push(message);
+  storage.syncs.set(message.appId, appSyncs);
+  const usage = storage.usage.get(message.appId) || {
+    appId: message.appId,
+    syncCount: 0,
+    eventCount: 0,
+    factCount: 0,
+    storageBytes: 0,
+    periodStart: Date.now(),
+    periodEnd: Date.now()
+  };
+  usage.syncCount++;
+  usage.eventCount += message.events?.length || 0;
+  usage.factCount += message.facts?.length || 0;
+  usage.storageBytes += JSON.stringify(message).length;
+  usage.periodEnd = Date.now();
+  storage.usage.set(message.appId, usage);
+  context.log(`Synced for app ${message.appId}: ${usage.syncCount} total syncs`);
+  return {
+    status: 200,
+    headers: { "Content-Type": "application/json" },
+    body: {
+      success: true,
+      clock: message.clock,
+      timestamp: Date.now()
+    }
+  };
+}
+async function usageEndpoint(context, req) {
+  context.log("Usage metrics requested");
+  const appId = req.query.appId;
+  if (!appId) {
+    return {
+      status: 400,
+      body: { error: "appId query parameter is required" }
+    };
+  }
+  const usage = storage.usage.get(appId);
+  if (!usage) {
+    return {
+      status: 404,
+      body: { error: "No usage data found for this app" }
+    };
+  }
+  return {
+    status: 200,
+    headers: { "Content-Type": "application/json" },
+    body: usage
+  };
+}
+async function statsEndpoint(context, req) {
+  context.log("Stats requested");
+  const appId = req.query.appId;
+  if (!appId) {
+    return {
+      status: 400,
+      body: { error: "appId query parameter is required" }
+    };
+  }
+  const usage = storage.usage.get(appId);
+  const syncs = storage.syncs.get(appId) || [];
+  return {
+    status: 200,
+    headers: { "Content-Type": "application/json" },
+    body: {
+      appId,
+      totalSyncs: syncs.length,
+      usage: usage || null,
+      lastSync: syncs.length > 0 ? syncs[syncs.length - 1].timestamp : null
+    }
+  };
+}
+async function eventsEndpoint(context, req) {
+  context.log("Event forwarding requested");
+  if (req.method !== "POST") {
+    return {
+      status: 405,
+      body: { error: "Method not allowed" }
+    };
+  }
+  const { appId, events } = req.body;
+  if (!appId || !events) {
+    return {
+      status: 400,
+      body: { error: "Invalid event forwarding request" }
+    };
+  }
+  context.log(`Forwarding ${events.length} events for app ${appId}`);
+  return {
+    status: 200,
+    headers: { "Content-Type": "application/json" },
+    body: {
+      success: true,
+      forwarded: events.length,
+      timestamp: Date.now()
+    }
+  };
+}
+async function schemaEndpoint(context, req) {
+  context.log("Schema registry requested");
+  if (req.method === "POST") {
+    const { appId: appId2, schema } = req.body;
+    if (!appId2 || !schema) {
+      return {
+        status: 400,
+        body: { error: "Invalid schema registration request" }
+      };
+    }
+    context.log(`Schema registered for app ${appId2}`);
+    return {
+      status: 200,
+      headers: { "Content-Type": "application/json" },
+      body: {
+        success: true,
+        schemaId: `${appId2}-${Date.now()}`,
+        timestamp: Date.now()
+      }
+    };
+  }
+  const appId = req.query.appId;
+  if (!appId) {
+    return {
+      status: 400,
+      body: { error: "appId query parameter is required" }
+    };
+  }
+  return {
+    status: 200,
+    headers: { "Content-Type": "application/json" },
+    body: {
+      appId,
+      schema: null,
+      message: "Schema not found"
+    }
+  };
+}
+export {
+  BillingProvider,
+  GitHubMarketplaceClient,
+  GitHubOAuth,
+  GitHubSponsorsClient,
+  MARKETPLACE_PLANS,
+  SubscriptionStatus,
+  SubscriptionTier,
+  TIER_LIMITS,
+  authenticateWithDeviceFlow,
+  checkUsageLimits,
+  connectRelay,
+  createCloudRelay,
+  createFreeSubscription,
+  createGitHubOAuth,
+  createMarketplaceClient,
+  createSponsorSubscription,
+  createSponsorsClient,
+  createTenant,
+  eventsEndpoint,
+  generateStorageNamespace,
+  generateTenantId,
+  getAppStorageContainer,
+  getOrCreateTenant,
+  hasAccessToTier,
+  healthEndpoint,
+  provisionTenant,
+  schemaEndpoint,
+  statsEndpoint,
+  syncEndpoint,
+  usageEndpoint,
+  validateStorageNamespace
+};

package/dist/node/cloud-AXOK4PSN.js

@@ -0,0 +1,212 @@
+import {
+  connectRelay
+} from "./chunk-XCY2VIFX.js";
+import {
+  authenticateWithDeviceFlow
+} from "./chunk-FXQZXAWF.js";
+import "./chunk-QGM4M3NI.js";
+
+// src/cli/commands/cloud.ts
+import * as fs from "fs";
+import * as path from "path";
+var CONFIG_FILE = ".praxis-cloud.json";
+var GITHUB_CLIENT_ID = "Ov23liQxF7P0BqUxVXHk";
+function loadConfig() {
+  try {
+    const configPath = path.join(process.cwd(), CONFIG_FILE);
+    if (fs.existsSync(configPath)) {
+      const data = fs.readFileSync(configPath, "utf-8");
+      return JSON.parse(data);
+    }
+  } catch (error) {
+    console.warn("Failed to load cloud configuration:", error);
+  }
+  return null;
+}
+function saveConfig(config) {
+  try {
+    const configPath = path.join(process.cwd(), CONFIG_FILE);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`
+\u2713 Configuration saved to ${CONFIG_FILE}`);
+  } catch (error) {
+    console.error("Failed to save cloud configuration:", error);
+    throw error;
+  }
+}
+async function cloudInit(options) {
+  console.log("\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
+  console.log("\u2551   Welcome to Praxis Cloud Setup Wizard           \u2551");
+  console.log("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n");
+  const existingConfig = loadConfig();
+  if (existingConfig) {
+    console.log("\u26A0  Existing cloud configuration found.");
+    console.log(`   Endpoint: ${existingConfig.endpoint}`);
+    console.log(`   App ID: ${existingConfig.appId}
+`);
+  }
+  let endpoint = options.endpoint;
+  if (!endpoint) {
+    endpoint = "https://praxis-relay.azurewebsites.net";
+    console.log(`Using default endpoint: ${endpoint}`);
+  }
+  let appId = options.appId;
+  if (!appId) {
+    appId = path.basename(process.cwd());
+    console.log(`Using app ID from directory name: ${appId}`);
+  }
+  console.log("\n\u{1F510} Authenticating with GitHub...");
+  const authResult = await authenticateWithDeviceFlow(GITHUB_CLIENT_ID);
+  if (!authResult.success || !authResult.token) {
+    console.error("\n\u2717 Authentication failed");
+    process.exit(1);
+  }
+  console.log(`\u2713 Authenticated as ${authResult.user?.login || "unknown"}`);
+  console.log("\n\u{1F517} Testing connection to Praxis Cloud...");
+  try {
+    const config = {
+      endpoint,
+      appId,
+      authToken: authResult.token,
+      autoSync: options.autoSync,
+      syncInterval: options.interval ? parseInt(options.interval) : 5e3
+    };
+    const client = await connectRelay(endpoint, config);
+    const health = await client.getHealth();
+    if (health.status === "healthy") {
+      console.log("\u2713 Connected successfully!");
+      console.log(`  Status: ${health.status}`);
+      console.log(`  Version: ${health.version}`);
+    } else {
+      console.log(`\u26A0  Connected but service is ${health.status}`);
+    }
+    await client.disconnect();
+    const storedConfig = {
+      endpoint,
+      appId,
+      authToken: authResult.token,
+      autoSync: options.autoSync,
+      syncInterval: config.syncInterval
+    };
+    saveConfig(storedConfig);
+    console.log("\n\u2713 Praxis Cloud is now configured!");
+    console.log("\nNext steps:");
+    console.log("  \u2022 Use 'praxis cloud status' to check connection");
+    console.log("  \u2022 Use 'praxis cloud sync' to manually sync");
+    console.log("  \u2022 Use 'praxis cloud usage' to view metrics");
+    console.log("\nIn your code:");
+    console.log('  import { connectRelay } from "@plures/praxis/cloud";');
+    console.log(`  const relay = await connectRelay("${endpoint}", {`);
+    console.log(`    appId: "${appId}",`);
+    console.log(`    authToken: "<your-token>"`);
+    console.log("  });\n");
+  } catch (error) {
+    console.error("\n\u2717 Failed to connect to Praxis Cloud");
+    console.error(`  Error: ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
+  }
+}
+async function cloudStatus() {
+  const config = loadConfig();
+  if (!config) {
+    console.log("\n\u2717 No cloud configuration found");
+    console.log("  Run 'praxis cloud init' to set up cloud connection\n");
+    process.exit(1);
+  }
+  console.log("\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
+  console.log("\u2551   Praxis Cloud Status                             \u2551");
+  console.log("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n");
+  console.log(`Endpoint: ${config.endpoint}`);
+  console.log(`App ID: ${config.appId}`);
+  console.log(`Auto Sync: ${config.autoSync ? "enabled" : "disabled"}`);
+  if (config.autoSync) {
+    console.log(`Sync Interval: ${config.syncInterval}ms`);
+  }
+  try {
+    const client = await connectRelay(config.endpoint, config);
+    const health = await client.getHealth();
+    console.log(`
+Connection: \u2713 Connected`);
+    console.log(`Status: ${health.status}`);
+    console.log(`Version: ${health.version}`);
+    console.log("\nServices:");
+    console.log(`  Relay: ${health.services.relay ? "\u2713" : "\u2717"}`);
+    console.log(`  Event Grid: ${health.services.eventGrid ? "\u2713" : "\u2717"}`);
+    console.log(`  Storage: ${health.services.storage ? "\u2713" : "\u2717"}`);
+    console.log(`  Auth: ${health.services.auth ? "\u2713" : "\u2717"}`);
+    await client.disconnect();
+  } catch (error) {
+    console.log(`
+Connection: \u2717 Failed`);
+    console.log(`Error: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  console.log();
+}
+async function cloudSync() {
+  const config = loadConfig();
+  if (!config) {
+    console.log("\n\u2717 No cloud configuration found");
+    console.log("  Run 'praxis cloud init' to set up cloud connection\n");
+    process.exit(1);
+  }
+  console.log("\n\u{1F504} Syncing to Praxis Cloud...");
+  try {
+    const client = await connectRelay(config.endpoint, config);
+    await client.sync({
+      type: "delta",
+      appId: config.appId,
+      clock: {},
+      facts: [],
+      events: [],
+      timestamp: Date.now()
+    });
+    console.log("\u2713 Sync completed successfully\n");
+    await client.disconnect();
+  } catch (error) {
+    console.error("\n\u2717 Sync failed");
+    console.error(`  Error: ${error instanceof Error ? error.message : String(error)}
+`);
+    process.exit(1);
+  }
+}
+async function cloudUsage() {
+  const config = loadConfig();
+  if (!config) {
+    console.log("\n\u2717 No cloud configuration found");
+    console.log("  Run 'praxis cloud init' to set up cloud connection\n");
+    process.exit(1);
+  }
+  console.log("\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
+  console.log("\u2551   Praxis Cloud Usage Metrics                      \u2551");
+  console.log("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n");
+  try {
+    const client = await connectRelay(config.endpoint, config);
+    const usage = await client.getUsage();
+    console.log(`App ID: ${usage.appId}`);
+    console.log(`
+Metrics:`);
+    console.log(`  Total Syncs: ${usage.syncCount}`);
+    console.log(`  Events Forwarded: ${usage.eventCount}`);
+    console.log(`  Facts Synced: ${usage.factCount}`);
+    console.log(`  Storage Used: ${(usage.storageBytes / 1024).toFixed(2)} KB`);
+    const periodDuration = usage.periodEnd - usage.periodStart;
+    const durationHours = (periodDuration / 1e3 / 60 / 60).toFixed(1);
+    console.log(`
+Period: ${durationHours} hours`);
+    console.log(`  From: ${new Date(usage.periodStart).toLocaleString()}`);
+    console.log(`  To: ${new Date(usage.periodEnd).toLocaleString()}`);
+    console.log();
+    await client.disconnect();
+  } catch (error) {
+    console.error("\n\u2717 Failed to retrieve usage metrics");
+    console.error(`  Error: ${error instanceof Error ? error.message : String(error)}
+`);
+    process.exit(1);
+  }
+}
+export {
+  cloudInit,
+  cloudStatus,
+  cloudSync,
+  cloudUsage
+};