@glowlabs-org/utils 0.2.25 → 0.2.26

package/src/lib/control-api/region-router.ts

@@ -6,6 +6,10 @@ import type {
   RegionWithMetadata,
   ActivationConfig,
   CreateRegionPayload,
+  CreateKickstarterPayload,
+  Kickstarter,
+  ActivationEvent,
+  KickstarterCreateResponse,
 } from "../types";
 
 // ---------------------------------------------------------------------------
@@ -41,6 +45,7 @@ export function RegionRouter(baseUrl: string) {
   let cachedRegions: Region[] = [];
   let isLoading = false;
   let isCreatingRegion = false;
+  let isCreatingKickstarter = false;
 
   // -------------------------------------------------------------------------
   // Queries
@@ -70,6 +75,20 @@ export function RegionRouter(baseUrl: string) {
     }
   };
 
+  const fetchActivationEvents = async (
+    regionId?: number
+  ): Promise<ActivationEvent[]> => {
+    try {
+      const query = typeof regionId === "number" ? `?regionId=${regionId}` : "";
+      const data = await request<{ events: ActivationEvent[] }>(
+        `/regions/activation-events${query}`
+      );
+      return data.events ?? [];
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    }
+  };
+
   // -------------------------------------------------------------------------
   // Mutations
   // -------------------------------------------------------------------------
@@ -90,6 +109,40 @@ export function RegionRouter(baseUrl: string) {
     }
   };
 
+  const createKickstarter = async (
+    payload: CreateKickstarterPayload
+  ): Promise<KickstarterCreateResponse> => {
+    isCreatingKickstarter = true;
+    try {
+      const data = await request<KickstarterCreateResponse>(
+        `/regions/kickstarters`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload),
+        }
+      );
+      // A new region may have been created; refresh regions cache
+      await fetchRegions();
+      return data;
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    } finally {
+      isCreatingKickstarter = false;
+    }
+  };
+
+  const fetchKickstarter = async (idOrSlug: string): Promise<Kickstarter> => {
+    try {
+      const data = await request<{ kickstarter: Kickstarter }>(
+        `/regions/kickstarters/${encodeURIComponent(idOrSlug)}`
+      );
+      return data.kickstarter;
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    }
+  };
+
   // -------------------------------------------------------------------------
   // Helpers (derived)
   // -------------------------------------------------------------------------
@@ -136,8 +189,11 @@ export function RegionRouter(baseUrl: string) {
     // Data access
     fetchRegions,
     fetchActivationConfig,
+    fetchActivationEvents,
+    fetchKickstarter,
     getRegionByCode,
     createRegion,
+    createKickstarter,
 
     // Cached data & flags
     get regions() {
@@ -149,5 +205,8 @@ export function RegionRouter(baseUrl: string) {
     get isCreatingRegion() {
       return isCreatingRegion;
     },
+    get isCreatingKickstarter() {
+      return isCreatingKickstarter;
+    },
   } as const;
 }

package/src/lib/types/index.ts

@@ -152,6 +152,70 @@ export interface RegionMetadata {
   flag?: string;
 }
 
+// ----------------------------- Kickstarters ---------------------------------
+export type KickstarterStatus =
+  | "draft"
+  | "awaiting-kickoff"
+  | "collecting-support"
+  | "ready-to-activate"
+  | "completed"
+  | "expired"
+  | "cancelled"
+  | "suspended";
+
+export interface CreateKickstarterPayload {
+  creatorWallet: string;
+  regionName: string;
+  isUs?: boolean;
+  title: string;
+  description: string;
+  stakeTargetGctl: string; // decimal string
+  requiredFarmCount?: number; // defaults server-side
+  requiredInstallerCount?: number; // defaults server-side
+}
+
+export interface KickstarterCreateResponse {
+  success: true;
+  id: string;
+}
+
+export interface Kickstarter {
+  id: string;
+  regionId: number;
+  creatorWallet: string;
+  title: string;
+  description: string;
+  slug: string;
+  status: KickstarterStatus | string;
+  createdAt: string; // ISO 8601
+  updatedAt: string; // ISO 8601
+  publishedAt?: string; // ISO 8601
+  completedAt?: string; // ISO 8601
+  cancelledAt?: string; // ISO 8601
+  expiredAt?: string; // ISO 8601
+  deadline: string; // ISO 8601
+  stakeTargetGctl: string; // decimal string
+  requiredFarmCount: number;
+  requiredInstallerCount: number;
+  stakeContributed: boolean;
+  farmProvided: boolean;
+  installerCertified: boolean;
+  kickoffTransferTxId?: string;
+  kickoffMintTxId?: string;
+  kickoffStakeEventId?: string;
+}
+
+export interface ActivationEvent {
+  id: string;
+  regionId: number;
+  epoch: number;
+  stakeThresholdMet: boolean;
+  solarFarmRequirementMet: boolean;
+  installerRequirementMet: boolean;
+  activated: boolean;
+  ts: string; // ISO 8601
+}
+
 // ---------------------------------------------------------------------------
 // Barrel exports (convenience)
 // ---------------------------------------------------------------------------