@rool-dev/client 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Generic node - only `type` and `_meta` are required, all other fields are arbitrary.
+ * Consumer applications define their own node schemas.
+ */
+export interface RoolNode {
+    type: string;
+    _meta: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Hyperedge format - supports many-to-many relationships.
+ * Sources and targets are arrays of node IDs.
+ */
+export interface RoolEdge {
+    sources: string[];
+    targets: string[];
+    type: string;
+    _meta: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Graph structure - nodes and edges as maps keyed by ID.
+ * _meta is preserved but hidden from AI operations.
+ */
+export interface RoolGraphData {
+    nodes: Record<string, RoolNode>;
+    edges: Record<string, RoolEdge>;
+    _meta: Record<string, unknown>;
+}
+export type JSONPatchOp = {
+    op: 'add';
+    path: string;
+    value: unknown;
+} | {
+    op: 'remove';
+    path: string;
+} | {
+    op: 'replace';
+    path: string;
+    value: unknown;
+} | {
+    op: 'move';
+    path: string;
+    from: string;
+} | {
+    op: 'copy';
+    path: string;
+    from: string;
+} | {
+    op: 'test';
+    path: string;
+    value: unknown;
+};
+export type RoolGraphRole = 'owner' | 'editor' | 'viewer';
+export interface RoolGraphInfo {
+    id: string;
+    name: string;
+    role: RoolGraphRole;
+}
+export interface UserResult {
+    id: string;
+    email: string;
+}
+export interface RoolGraphUser {
+    id: string;
+    email: string;
+    role: RoolGraphRole;
+}
+export interface Account {
+    id: string;
+    email: string;
+    plan: string;
+    creditsBalance: number;
+    processedAt: string;
+}
+export interface MediaItem {
+    uuid: string;
+    url: string;
+    contentType: string;
+    size: number;
+    createdAt: string;
+}
+export interface PromptOptions {
+    nodeIds?: string[];
+    edgeIds?: string[];
+    metadata?: Record<string, unknown>;
+    responseSchema?: Record<string, unknown>;
+}
+export interface ImageResult {
+    url: string;
+}
+export type ImageAspectRatio = '1:1' | '3:4' | '4:3' | '9:16' | '16:9';
+export type ConnectionState = 'connected' | 'disconnected' | 'reconnecting';
+export type GraphEventType = 'graph_patched' | 'graph_changed' | 'graph_name_changed' | 'graph_created' | 'graph_deleted';
+export interface GraphEvent {
+    type: GraphEventType;
+    graphId: string;
+    timestamp: number;
+    patch?: JSONPatchOp[];
+}
+/**
+ * External auth provider interface for Electron or custom auth flows.
+ * When provided, rool-client delegates all auth operations to this provider.
+ */
+export interface AuthProvider {
+    /** Get current access token */
+    getToken: () => Promise<string | undefined>;
+    /** Get user info from current session */
+    getUser: () => {
+        email: string | null;
+        name: string | null;
+    };
+    /** Check if currently authenticated */
+    isAuthenticated?: () => boolean;
+    /** Initiate login (optional - some providers handle this externally) */
+    login?: () => void;
+    /** Logout and clear session (optional) */
+    logout?: () => void;
+}
+export interface RoolClientConfig {
+    /** Base URL of the Rool server (e.g., 'https://use.rool.dev') */
+    baseUrl: string;
+    /** localStorage key prefix (default: 'rool_') */
+    storagePrefix?: string;
+    /**
+     * External auth provider (e.g., for Electron).
+     * When provided, rool-client uses this instead of built-in web auth.
+     */
+    authProvider?: AuthProvider;
+}
+/**
+ * Client-level events (graph lifecycle, auth, connection).
+ */
+export interface RoolClientEvents {
+    /** Emitted when authentication state changes */
+    authStateChanged: (authenticated: boolean) => void;
+    /** Emitted when a new graph is created (by any client) */
+    graphCreated: (graphId: string) => void;
+    /** Emitted when a graph is deleted (by any client) */
+    graphDeleted: (graphId: string) => void;
+    /** Emitted when a graph is renamed (by any client) */
+    graphRenamed: (graphId: string, newName: string) => void;
+    /** Emitted when SSE connection state changes */
+    connectionStateChanged: (state: ConnectionState) => void;
+    /** Emitted on errors */
+    error: (error: Error, context?: string) => void;
+    /** Index signature for EventEmitter compatibility */
+    [key: string]: (...args: any[]) => void;
+}
+/**
+ * Graph-level events (content changes within a specific graph).
+ */
+export interface GraphEvents {
+    /** Emitted when the graph data changes (any change) */
+    changed: (data: RoolGraphData) => void;
+    /** Emitted when a node is added */
+    nodeAdded: (nodeId: string, node: RoolNode) => void;
+    /** Emitted when a node is updated */
+    nodeUpdated: (nodeId: string, node: RoolNode) => void;
+    /** Emitted when nodes are deleted */
+    nodesDeleted: (nodeIds: string[]) => void;
+    /** Emitted when an edge is added */
+    edgeAdded: (edgeId: string, edge: RoolEdge) => void;
+    /** Emitted when an edge is removed */
+    edgeRemoved: (edgeId: string) => void;
+    /** Emitted when a sync error occurs and the graph resyncs from server */
+    syncError: (error: Error) => void;
+    /** Index signature for EventEmitter compatibility */
+    [key: string]: (...args: any[]) => void;
+}
+export interface AuthTokens {
+    accessToken: string;
+    refreshToken: string | null;
+    expiresAt: number;
+}
+export interface UserInfo {
+    email: string | null;
+    name: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+// =============================================================================
+// Rool Client Types
+// Generic types for graph-based applications using the Rool server API
+// =============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oBAAoB;AACpB,uEAAuE;AACvE,gFAAgF"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@rool-dev/client",
+  "version": "0.1.0",
+  "description": "TypeScript client library for the Rool API",
+  "packageManager": "pnpm@9.15.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lightpost-one/gcp-backend.git",
+    "directory": "rool-client"
+  },
+  "keywords": [
+    "rool",
+    "graph",
+    "hypergraph",
+    "api-client",
+    "real-time"
+  ],
+  "author": {
+    "name": "Lightpost One",
+    "email": "info@lightpost.one",
+    "url": "https://lightpost.one"
+  },
+  "license": "UNLICENSED",
+  "dependencies": {
+    "fflate": "^0.8.2",
+    "graphql-sse": "^2.6.0",
+    "immutable-json-patch": "^6.0.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}