@weirdfingers/boards 0.5.2 → 0.6.0

package/dist/index.d.mts

@@ -368,12 +368,18 @@ declare function createGraphQLClient({ url, subscriptionUrl, auth, tenantId, }:
 declare const USER_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const BOARD_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GENERATION_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const ARTIFACT_LINEAGE_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const ANCESTRY_NODE_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const DESCENDANT_NODE_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_CURRENT_USER: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_BOARDS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_GENERATORS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_GENERATIONS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const GET_ANCESTRY: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const GET_DESCENDANTS: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const GET_INPUT_ARTIFACTS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const CREATE_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const UPDATE_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const DELETE_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
@@ -383,6 +389,7 @@ declare const REMOVE_BOARD_MEMBER: urql.TypedDocumentNode<any, urql.AnyVariables
 declare const CREATE_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const CANCEL_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const RETRY_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const UPLOAD_ARTIFACT_FROM_URL: urql.TypedDocumentNode<any, urql.AnyVariables>;
 interface CreateBoardInput {
     title: string;
     description?: string;
@@ -404,6 +411,14 @@ interface CreateGenerationInput {
     inputParams: Record<string, unknown>;
     metadata?: Record<string, unknown>;
 }
+interface UploadArtifactInput {
+    boardId: string;
+    artifactType: ArtifactType;
+    fileUrl?: string;
+    originalFilename?: string;
+    userDescription?: string;
+    parentGenerationId?: string;
+}
 declare enum BoardRole {
     VIEWER = "VIEWER",
     EDITOR = "EDITOR",
@@ -417,12 +432,12 @@ declare enum GenerationStatus {
     CANCELLED = "CANCELLED"
 }
 declare enum ArtifactType {
-    IMAGE = "image",
-    VIDEO = "video",
-    AUDIO = "audio",
-    TEXT = "text",
-    LORA = "lora",
-    MODEL = "model"
+    IMAGE = "IMAGE",
+    VIDEO = "VIDEO",
+    AUDIO = "AUDIO",
+    TEXT = "TEXT",
+    LORA = "LORA",
+    MODEL = "MODEL"
 }
 
 /**
@@ -662,6 +677,132 @@ interface GeneratorsHook {
 }
 declare function useGenerators(options?: UseGeneratorsOptions): GeneratorsHook;
 
+/**
+ * Hook for uploading artifacts (images, videos, audio, text).
+ */
+
+interface UploadRequest {
+    boardId: string;
+    artifactType: ArtifactType;
+    source: File | string;
+    userDescription?: string;
+    parentGenerationId?: string;
+}
+interface UploadResult {
+    id: string;
+    storageUrl: string;
+    thumbnailUrl?: string;
+    status: "completed" | "failed";
+    artifactType: ArtifactType;
+    generatorName: string;
+}
+interface UploadHook {
+    upload: (request: UploadRequest) => Promise<UploadResult>;
+    isUploading: boolean;
+    progress: number;
+    error: Error | null;
+}
+declare function useUpload(): UploadHook;
+
+/**
+ * Hook for accessing generation lineage (ancestry and descendants).
+ */
+interface ArtifactLineage {
+    generationId: string;
+    role: string;
+    artifactType: string;
+}
+interface AncestryNode {
+    generation: {
+        id: string;
+        generatorName: string;
+        artifactType: string;
+        status: string;
+        storageUrl?: string;
+        thumbnailUrl?: string;
+        createdAt: string;
+        [key: string]: unknown;
+    };
+    depth: number;
+    role: string | null;
+    parents: AncestryNode[];
+}
+interface DescendantNode {
+    generation: {
+        id: string;
+        generatorName: string;
+        artifactType: string;
+        status: string;
+        storageUrl?: string;
+        thumbnailUrl?: string;
+        createdAt: string;
+        [key: string]: unknown;
+    };
+    depth: number;
+    role: string | null;
+    children: DescendantNode[];
+}
+interface UseAncestryOptions {
+    maxDepth?: number;
+    pause?: boolean;
+}
+interface UseAncestryHook {
+    ancestry: AncestryNode | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook for fetching the ancestry tree of a generation.
+ * @param generationId - The ID of the generation to fetch ancestry for
+ * @param options - Optional configuration (maxDepth, pause)
+ */
+declare function useAncestry(generationId: string, options?: UseAncestryOptions): UseAncestryHook;
+interface UseDescendantsOptions {
+    maxDepth?: number;
+    pause?: boolean;
+}
+interface UseDescendantsHook {
+    descendants: DescendantNode | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook for fetching the descendants tree of a generation.
+ * @param generationId - The ID of the generation to fetch descendants for
+ * @param options - Optional configuration (maxDepth, pause)
+ */
+declare function useDescendants(generationId: string, options?: UseDescendantsOptions): UseDescendantsHook;
+interface UseInputArtifactsOptions {
+    pause?: boolean;
+}
+interface UseInputArtifactsHook {
+    inputArtifacts: ArtifactLineage[];
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook for fetching the input artifacts of a generation.
+ * @param generationId - The ID of the generation to fetch input artifacts for
+ * @param options - Optional configuration (pause)
+ */
+declare function useInputArtifacts(generationId: string, options?: UseInputArtifactsOptions): UseInputArtifactsHook;
+/**
+ * Combined hook for fetching both ancestry and descendants.
+ * Useful for lineage explorer pages that show both trees.
+ */
+interface UseLineageOptions {
+    maxDepth?: number;
+    pause?: boolean;
+}
+interface UseLineageHook {
+    ancestry: AncestryNode | null;
+    descendants: DescendantNode | null;
+    inputArtifacts: ArtifactLineage[];
+    loading: boolean;
+    error: Error | null;
+}
+declare function useLineage(generationId: string, options?: UseLineageOptions): UseLineageHook;
+
 /**
  * Utilities for parsing generator JSON Schemas into structured data
  * suitable for dynamic UI generation.
@@ -766,4 +907,4 @@ declare function BoardsProvider({ children, apiUrl, graphqlUrl, subscriptionUrl,
 
 declare const VERSION = "0.1.0";
 
-export { ADD_BOARD_MEMBER, type ApiConfig, type Artifact$1 as Artifact, type ArtifactSlot, type ArtifactSlotInfo, ArtifactType, type AuthContextValue, AuthProvider, type AuthProviderConfig, type AuthState$1 as AuthState, BOARD_FRAGMENT, BaseAuthProvider, BoardRole, BoardsProvider, CANCEL_GENERATION, CREATE_BOARD, CREATE_GENERATION, type CreateBoardInput, type CreateGenerationInput, DELETE_BOARD, type DropdownField, GENERATION_FRAGMENT, GET_BOARD, GET_BOARDS, GET_CURRENT_USER, GET_GENERATION, GET_GENERATIONS, GET_GENERATORS, GenerationStatus, type Generator, type GeneratorInfo, type GeneratorSelectionContextValue, GeneratorSelectionProvider, NoAuthProvider, type NumberInputField, type ParsedGeneratorSchema, type PromptField, REMOVE_BOARD_MEMBER, RETRY_GENERATION, type SettingsField, type SignInOptions, type SliderField, type TextInputField, UPDATE_BOARD, UPDATE_BOARD_MEMBER_ROLE, USER_FRAGMENT, type UpdateBoardInput, type User$1 as User, VERSION, createGraphQLClient, getArtifactType, isArtifactReference, parseArtifactSlot, parseGeneratorSchema, parseSettingsField, useApiConfig, useAuth, useAuthOptional, useBoard, useBoards, useGeneration, useGeneratorSelection, useGenerators };
+export { ADD_BOARD_MEMBER, ANCESTRY_NODE_FRAGMENT, ARTIFACT_LINEAGE_FRAGMENT, type AncestryNode, type ApiConfig, type Artifact$1 as Artifact, type ArtifactLineage, type ArtifactSlot, type ArtifactSlotInfo, ArtifactType, type AuthContextValue, AuthProvider, type AuthProviderConfig, type AuthState$1 as AuthState, BOARD_FRAGMENT, BaseAuthProvider, BoardRole, BoardsProvider, CANCEL_GENERATION, CREATE_BOARD, CREATE_GENERATION, type CreateBoardInput, type CreateGenerationInput, DELETE_BOARD, DESCENDANT_NODE_FRAGMENT, type DescendantNode, type DropdownField, GENERATION_FRAGMENT, GET_ANCESTRY, GET_BOARD, GET_BOARDS, GET_CURRENT_USER, GET_DESCENDANTS, GET_GENERATION, GET_GENERATIONS, GET_GENERATORS, GET_INPUT_ARTIFACTS, GenerationStatus, type Generator, type GeneratorInfo, type GeneratorSelectionContextValue, GeneratorSelectionProvider, NoAuthProvider, type NumberInputField, type ParsedGeneratorSchema, type PromptField, REMOVE_BOARD_MEMBER, RETRY_GENERATION, type SettingsField, type SignInOptions, type SliderField, type TextInputField, UPDATE_BOARD, UPDATE_BOARD_MEMBER_ROLE, UPLOAD_ARTIFACT_FROM_URL, USER_FRAGMENT, type UpdateBoardInput, type UploadArtifactInput, type UploadHook, type UploadRequest, type UploadResult, type User$1 as User, VERSION, createGraphQLClient, getArtifactType, isArtifactReference, parseArtifactSlot, parseGeneratorSchema, parseSettingsField, useAncestry, useApiConfig, useAuth, useAuthOptional, useBoard, useBoards, useDescendants, useGeneration, useGeneratorSelection, useGenerators, useInputArtifacts, useLineage, useUpload };

package/dist/index.d.ts

@@ -368,12 +368,18 @@ declare function createGraphQLClient({ url, subscriptionUrl, auth, tenantId, }:
 declare const USER_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const BOARD_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GENERATION_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const ARTIFACT_LINEAGE_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const ANCESTRY_NODE_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const DESCENDANT_NODE_FRAGMENT: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_CURRENT_USER: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_BOARDS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_GENERATORS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_GENERATIONS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const GET_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const GET_ANCESTRY: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const GET_DESCENDANTS: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const GET_INPUT_ARTIFACTS: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const CREATE_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const UPDATE_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const DELETE_BOARD: urql.TypedDocumentNode<any, urql.AnyVariables>;
@@ -383,6 +389,7 @@ declare const REMOVE_BOARD_MEMBER: urql.TypedDocumentNode<any, urql.AnyVariables
 declare const CREATE_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const CANCEL_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
 declare const RETRY_GENERATION: urql.TypedDocumentNode<any, urql.AnyVariables>;
+declare const UPLOAD_ARTIFACT_FROM_URL: urql.TypedDocumentNode<any, urql.AnyVariables>;
 interface CreateBoardInput {
     title: string;
     description?: string;
@@ -404,6 +411,14 @@ interface CreateGenerationInput {
     inputParams: Record<string, unknown>;
     metadata?: Record<string, unknown>;
 }
+interface UploadArtifactInput {
+    boardId: string;
+    artifactType: ArtifactType;
+    fileUrl?: string;
+    originalFilename?: string;
+    userDescription?: string;
+    parentGenerationId?: string;
+}
 declare enum BoardRole {
     VIEWER = "VIEWER",
     EDITOR = "EDITOR",
@@ -417,12 +432,12 @@ declare enum GenerationStatus {
     CANCELLED = "CANCELLED"
 }
 declare enum ArtifactType {
-    IMAGE = "image",
-    VIDEO = "video",
-    AUDIO = "audio",
-    TEXT = "text",
-    LORA = "lora",
-    MODEL = "model"
+    IMAGE = "IMAGE",
+    VIDEO = "VIDEO",
+    AUDIO = "AUDIO",
+    TEXT = "TEXT",
+    LORA = "LORA",
+    MODEL = "MODEL"
 }
 
 /**
@@ -662,6 +677,132 @@ interface GeneratorsHook {
 }
 declare function useGenerators(options?: UseGeneratorsOptions): GeneratorsHook;
 
+/**
+ * Hook for uploading artifacts (images, videos, audio, text).
+ */
+
+interface UploadRequest {
+    boardId: string;
+    artifactType: ArtifactType;
+    source: File | string;
+    userDescription?: string;
+    parentGenerationId?: string;
+}
+interface UploadResult {
+    id: string;
+    storageUrl: string;
+    thumbnailUrl?: string;
+    status: "completed" | "failed";
+    artifactType: ArtifactType;
+    generatorName: string;
+}
+interface UploadHook {
+    upload: (request: UploadRequest) => Promise<UploadResult>;
+    isUploading: boolean;
+    progress: number;
+    error: Error | null;
+}
+declare function useUpload(): UploadHook;
+
+/**
+ * Hook for accessing generation lineage (ancestry and descendants).
+ */
+interface ArtifactLineage {
+    generationId: string;
+    role: string;
+    artifactType: string;
+}
+interface AncestryNode {
+    generation: {
+        id: string;
+        generatorName: string;
+        artifactType: string;
+        status: string;
+        storageUrl?: string;
+        thumbnailUrl?: string;
+        createdAt: string;
+        [key: string]: unknown;
+    };
+    depth: number;
+    role: string | null;
+    parents: AncestryNode[];
+}
+interface DescendantNode {
+    generation: {
+        id: string;
+        generatorName: string;
+        artifactType: string;
+        status: string;
+        storageUrl?: string;
+        thumbnailUrl?: string;
+        createdAt: string;
+        [key: string]: unknown;
+    };
+    depth: number;
+    role: string | null;
+    children: DescendantNode[];
+}
+interface UseAncestryOptions {
+    maxDepth?: number;
+    pause?: boolean;
+}
+interface UseAncestryHook {
+    ancestry: AncestryNode | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook for fetching the ancestry tree of a generation.
+ * @param generationId - The ID of the generation to fetch ancestry for
+ * @param options - Optional configuration (maxDepth, pause)
+ */
+declare function useAncestry(generationId: string, options?: UseAncestryOptions): UseAncestryHook;
+interface UseDescendantsOptions {
+    maxDepth?: number;
+    pause?: boolean;
+}
+interface UseDescendantsHook {
+    descendants: DescendantNode | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook for fetching the descendants tree of a generation.
+ * @param generationId - The ID of the generation to fetch descendants for
+ * @param options - Optional configuration (maxDepth, pause)
+ */
+declare function useDescendants(generationId: string, options?: UseDescendantsOptions): UseDescendantsHook;
+interface UseInputArtifactsOptions {
+    pause?: boolean;
+}
+interface UseInputArtifactsHook {
+    inputArtifacts: ArtifactLineage[];
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Hook for fetching the input artifacts of a generation.
+ * @param generationId - The ID of the generation to fetch input artifacts for
+ * @param options - Optional configuration (pause)
+ */
+declare function useInputArtifacts(generationId: string, options?: UseInputArtifactsOptions): UseInputArtifactsHook;
+/**
+ * Combined hook for fetching both ancestry and descendants.
+ * Useful for lineage explorer pages that show both trees.
+ */
+interface UseLineageOptions {
+    maxDepth?: number;
+    pause?: boolean;
+}
+interface UseLineageHook {
+    ancestry: AncestryNode | null;
+    descendants: DescendantNode | null;
+    inputArtifacts: ArtifactLineage[];
+    loading: boolean;
+    error: Error | null;
+}
+declare function useLineage(generationId: string, options?: UseLineageOptions): UseLineageHook;
+
 /**
  * Utilities for parsing generator JSON Schemas into structured data
  * suitable for dynamic UI generation.
@@ -766,4 +907,4 @@ declare function BoardsProvider({ children, apiUrl, graphqlUrl, subscriptionUrl,
 
 declare const VERSION = "0.1.0";
 
-export { ADD_BOARD_MEMBER, type ApiConfig, type Artifact$1 as Artifact, type ArtifactSlot, type ArtifactSlotInfo, ArtifactType, type AuthContextValue, AuthProvider, type AuthProviderConfig, type AuthState$1 as AuthState, BOARD_FRAGMENT, BaseAuthProvider, BoardRole, BoardsProvider, CANCEL_GENERATION, CREATE_BOARD, CREATE_GENERATION, type CreateBoardInput, type CreateGenerationInput, DELETE_BOARD, type DropdownField, GENERATION_FRAGMENT, GET_BOARD, GET_BOARDS, GET_CURRENT_USER, GET_GENERATION, GET_GENERATIONS, GET_GENERATORS, GenerationStatus, type Generator, type GeneratorInfo, type GeneratorSelectionContextValue, GeneratorSelectionProvider, NoAuthProvider, type NumberInputField, type ParsedGeneratorSchema, type PromptField, REMOVE_BOARD_MEMBER, RETRY_GENERATION, type SettingsField, type SignInOptions, type SliderField, type TextInputField, UPDATE_BOARD, UPDATE_BOARD_MEMBER_ROLE, USER_FRAGMENT, type UpdateBoardInput, type User$1 as User, VERSION, createGraphQLClient, getArtifactType, isArtifactReference, parseArtifactSlot, parseGeneratorSchema, parseSettingsField, useApiConfig, useAuth, useAuthOptional, useBoard, useBoards, useGeneration, useGeneratorSelection, useGenerators };
+export { ADD_BOARD_MEMBER, ANCESTRY_NODE_FRAGMENT, ARTIFACT_LINEAGE_FRAGMENT, type AncestryNode, type ApiConfig, type Artifact$1 as Artifact, type ArtifactLineage, type ArtifactSlot, type ArtifactSlotInfo, ArtifactType, type AuthContextValue, AuthProvider, type AuthProviderConfig, type AuthState$1 as AuthState, BOARD_FRAGMENT, BaseAuthProvider, BoardRole, BoardsProvider, CANCEL_GENERATION, CREATE_BOARD, CREATE_GENERATION, type CreateBoardInput, type CreateGenerationInput, DELETE_BOARD, DESCENDANT_NODE_FRAGMENT, type DescendantNode, type DropdownField, GENERATION_FRAGMENT, GET_ANCESTRY, GET_BOARD, GET_BOARDS, GET_CURRENT_USER, GET_DESCENDANTS, GET_GENERATION, GET_GENERATIONS, GET_GENERATORS, GET_INPUT_ARTIFACTS, GenerationStatus, type Generator, type GeneratorInfo, type GeneratorSelectionContextValue, GeneratorSelectionProvider, NoAuthProvider, type NumberInputField, type ParsedGeneratorSchema, type PromptField, REMOVE_BOARD_MEMBER, RETRY_GENERATION, type SettingsField, type SignInOptions, type SliderField, type TextInputField, UPDATE_BOARD, UPDATE_BOARD_MEMBER_ROLE, UPLOAD_ARTIFACT_FROM_URL, USER_FRAGMENT, type UpdateBoardInput, type UploadArtifactInput, type UploadHook, type UploadRequest, type UploadResult, type User$1 as User, VERSION, createGraphQLClient, getArtifactType, isArtifactReference, parseArtifactSlot, parseGeneratorSchema, parseSettingsField, useAncestry, useApiConfig, useAuth, useAuthOptional, useBoard, useBoards, useDescendants, useGeneration, useGeneratorSelection, useGenerators, useInputArtifacts, useLineage, useUpload };