@ultrst-armada/kloks 1.2.1 → 1.3.0

package/packages/backend/dist/index.d.ts

@@ -11,9 +11,9 @@ export { BackendContract, BackendRegistry, CallbackDefinition, ConcurrencyConfli
 export { B as BackendClient, a as BackendClientOptions, b as BackendResolver, c as BackendResolverOptions, C as CallbackFn, d as CallbackRegistry, D as DomainProxy, E as ErrorHandler, e as EventBus, f as EventHandler, F as FrontendSession, g as FrontendSessionOptions, G as GapHandler, H as HTTPTransport, h as HTTPTransportOptions, I as ITransport, M as MessageHandler, S as SequenceCheckResult, i as SequenceTracker, W as WebSocketTransport, j as WebSocketTransportOptions, k as createBackendClient } from './WebSocketTransport-CxUzUfwl.js';
 export { I as IdempotencyManager } from './IdempotencyManager-B5MjK871.js';
 export { BackendClientInstance, BackendProvider, BackendProviderProps, useBackend, useBackendClient } from './client/index.js';
-export { AdaptedStorageConnection, AppAccountManifest, AppServiceDeclaration, CANONICAL_SRKL_URL, EcosystemAccount, EcosystemAccountsRequest, EcosystemAccountsResponse, EcosystemServiceCategory, SrklClient, SrklClientOptions, SrklEcosystemQueryOptions, SrklEcosystemResponse, SrklServiceAccount, UseSrklServicesOptions, UseSrklServicesResult, createSrklClient, getPrimarySrklDeploymentUrl, getSrklAccounts, srklListBackblazeBuckets, useSrklServices } from './srkl/index.js';
+export { AdaptedStorageConnection, AppAccountManifest, AppServiceDeclaration, CANONICAL_SRKL_URL, CredentialRegistryMap, EcosystemAccount, EcosystemAccountsRequest, EcosystemAccountsResponse, EcosystemServiceCategory, KeyMaterial, ServiceAccountEntry, SrklClient, SrklClientOptions, SrklCredentialRegistry, SrklEcosystemQueryOptions, SrklEcosystemResponse, SrklServiceAccount, SrklVaultAccessClient, SrklVaultAccessResponse, UseSrklServicesOptions, UseSrklServicesResult, VaultAccessClientOptions, createSrklClient, decryptVaultBufferInBrowser, getPrimarySrklDeploymentUrl, getSrklAccounts, globalCredentialRegistry, hexToBytes, srklListBackblazeBuckets, srklService, syncSrklAccounts, useSrklServices } from './srkl/index.js';
 export { BackendCommand, DomainService, ExecutableBackendFacade, ExecutionContext, JobDependencyGraph, NormalizedResult, OperationComponent, ResultFlowBridge, ServiceDispatcher, StateUpdateEvent, WorkerExecutionBoundary, createOperationComponent } from './execution/index.js';
-export { CompositeBackend, EndpointGenerator, GeneratedEndpointSummary, LocalService, RemoteServiceProxy, createBackend, createCompositeService, createLocalService, createRemoteService } from './services/index.js';
+export { CompositeBackend, EndpointGenerator, GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, LocalService, NodeGraphPersistenceService, NodeGraphValidationResult, RemoteServiceProxy, SaveGraphOptions, UniversalAppEntity, UniversalGraphEdge, UniversalGraphNode, UniversalNodeGraphDocument, UniversalStorageConnection, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument } from './services/index.js';
 import { AssetDataType as AssetDataType$1, AssetChannelType as AssetChannelType$1, GraphFolderInfo as GraphFolderInfo$1, GraphAssetItem as GraphAssetItem$1, SpaceNode, NodeConnection, DawProject } from '@ultrst-armada/kloks/state-graph';
 export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, ExecutionServiceDefinition, ExecutionServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade } from './krnl-services.js';
 export { EndpointDescriptor, IService, ProtocolAdapter, ServiceDefinition } from '@ultrst-armada/krnl';
@@ -1109,7 +1109,44 @@ declare function saveWorkspaceGraph(workspaceIdOrSlug: string, graphIdOrName: st
 declare function deleteWorkspaceGraph(workspaceIdOrSlug: string, graphIdOrName: string): Promise<boolean>;
 
 type ProviderType = 'VERCEL' | 'CLOUDFLARE' | 'AWS' | 'GCP' | 'FASTLY' | 'BACKBLAZE_B2' | 'CLOUDFLARE_R2' | 'SUPABASE' | 'NEON' | 'POSTGRESQL';
+type NodeType = 'ECOSYSTEM' | 'ECOSYSTEM_HUB' | 'SYSTEM_DATABASE' | 'SYSTEM_BUCKET' | 'ADMIN_CREDENTIALS' | 'APP_GRAPH_NODE' | 'APP' | 'APP_NODE' | 'APP_COMPONENT' | 'DEPLOYMENT' | 'WEIGHT_USER' | 'WEIGHT_RESOURCE' | 'WEIGHT_ACCOUNT' | 'WEIGHT_MULTIPLY' | 'WEIGHT_MODIFIER' | 'URL_NODE' | 'VARIANTS';
 type HealthState = 'HEALTHY' | 'DEGRADED' | 'UNHEALTHY';
+interface SystemDbConfig {
+    databaseUrl?: string;
+    provider?: string;
+    dbName?: string;
+    host?: string;
+    port?: number;
+    ssl?: boolean;
+    selectedTable?: string;
+    adminTable?: string;
+    adminEmailColumn?: string;
+    adminPasswordColumn?: string;
+    adminUsernameColumn?: string;
+    bucketTable?: string;
+    connectionStatus?: 'CONNECTED' | 'DISCONNECTED' | 'ERROR' | 'CONNECTING';
+    lastTestedAt?: string;
+    latencyMs?: number;
+    serverVersion?: string;
+    discoveredTables?: string[];
+    updatedAt?: string;
+}
+interface SystemBucketConfig {
+    bucketName?: string;
+    provider?: string;
+    endpoint?: string;
+    region?: string;
+    publicAccess?: boolean;
+    updatedAt?: string;
+}
+interface AdminCredentialsConfig {
+    adminEmail?: string;
+    adminSecretKey?: string;
+    depmJwtSecret?: string;
+    apiKey?: string;
+    lastRotatedAt?: string;
+    rotationHistoryCount?: number;
+}
 type AccountTier = 'hobby' | 'pro' | 'enterprise' | 'free' | 'payg' | 'custom';
 
 interface UnifiedResourceMetricItem<T = number> {
@@ -1371,6 +1408,77 @@ interface DeploymentEntity {
     resourceRate: number;
     createdAt: string;
 }
+interface AggregatedUrlItem {
+    url: string;
+    sourceNodeId: string;
+    sourceNodeName: string;
+    sourceNodeType: NodeType;
+    isDirect: boolean;
+    distance: number;
+}
+interface GraphNode {
+    id: string;
+    type: NodeType;
+    x: number;
+    y: number;
+    appId: string;
+    icon?: string;
+    name?: string;
+    componentName?: string;
+    publicLink?: string;
+    urlValue?: string;
+    urls?: string[];
+    aggregatedUrls?: string[];
+    aggregatedUrlItems?: AggregatedUrlItem[];
+    directUrls?: string[];
+    deploymentId?: string;
+    accountId?: string;
+    bubbleTargetType?: 'DOMAIN' | 'DEPLOYMENT';
+    domainUrl?: string;
+    deploymentUrl?: string;
+    weightModifierType?: 'USAGE' | 'USER_DEFINED' | 'ACCOUNT';
+    weightValue?: number;
+    systemDbData?: SystemDbConfig;
+    systemBucketData?: SystemBucketConfig;
+    adminCredsData?: AdminCredentialsConfig;
+    appData?: AppEntity;
+    evolutionScore?: number;
+    redundancyScore?: number;
+    modularityScore?: number;
+    variantsScore?: number;
+    visibilityScore?: number;
+    evolutionStage?: string;
+    ecosystemData?: {
+        connectedAppsCount?: number;
+        health?: HealthState;
+        status?: string;
+        routingRate?: number;
+        redundancyScore?: number;
+        modularityScore?: number;
+        variantsScore?: number;
+        visibilityScore?: number;
+        evolutionScore?: number;
+    };
+}
+interface GraphEdge {
+    id: string;
+    appId: string;
+    sourceId: string;
+    targetId: string;
+    sourceSocketId?: string;
+    targetSocketId?: string;
+    label?: string;
+}
+interface AppEntity {
+    id: string;
+    name: string;
+    icon: string;
+    description?: string;
+    publicLink: string;
+    folderName?: string;
+    createdAt: string;
+    updatedAt: string;
+}
 
 declare abstract class BaseResourceFetcher {
     abstract readonly provider: ProviderType;
@@ -1480,4 +1588,37 @@ declare class ResourceFetcherRegistry {
     static calculateDetailedScore(account?: AccountEntity, deployment?: DeploymentEntity): ResourceCalculationResult;
 }
 
-export { type AssetChannelType, type AssetDataType, type AssetFolderInfo, type AssetPoolItem, type AssetPoolScope, type B2AuthData, type BackendFacade, BaseDataProvider, BaseResourceFetcher, type CloudflareObservability, type CloudflareProjectItem, CloudflareResourceFetcher, type CloudflareUsageMetrics, type CredentialEntry, type CredentialManifest, type Deployment, type FunctionSet, FunctionalityTable, GRAPHS_ROOT, type IDataProvider, LEGACY_PROJECTS_ROOT, type OrchestrationFn, PROJECTS_ROOT, type ProjectMetadata, type PublicRouteRecord, type QueryFilter, ResourceFetcherRegistry, type Runtime, SAMPLES_GLOBAL_ROOT, SUPPORTED_AUDIO_EXTS, SUPPORTED_MIDI_EXTS, type ServerAudioSampleItem, type ServiceFacade, type ServiceRegistryRecord, type SortOrder, type SrklB2Account, SrklStorageService, type SyncFileResult, type UnifiedQueryResult, type UnifiedResourceMetricItem, type UnifiedResourceMetrics, VercelResourceFetcher, WORKSPACE_ASSETS_ROOT, WORKSPACE_ROOT, type WorkingWorkspaceConfig, type WorkspaceFolderResolution, type WorkspaceStorageConfig, b2DeleteFileVersion, b2DeleteFolder, buildProjectObservability, buildProjectsList, cleanDbUrl, configureStarterProjectTemplate, createAssetSubfolder, createCredential, createGraphAssetFolder, createGraphAssetFolder as createGraphAssetSubfolder, createGraphPackage, createWavBuffer, createWorkspace, createWorkspaceGraph, decryptSecretFromBlob, deleteAssetFromGraph, deleteAssetFromPool, deleteCredential, deleteGlobalSample, deleteGraphPackage, deleteProject, deleteProjectSample, deleteRoute, deleteWorkspace, deleteWorkspaceFile, deleteWorkspaceFolder, deleteWorkspaceGraph, encryptSecretToBlob, ensureAssetPoolDirectories, ensureGlobalSamples, ensureGraphAssetDirectories, ensureProjectAssets, ensureProjectsRoot, ensureWorkspaceStructure, exportEncryptedCredentials, fetchCloudflareData, fetchVercelData, findUserWorkspace, findWorkspaceRecord, formatRelativeCreated, getAllRoutes, getAssetPoolLocationPath, getAssetPoolPublicUrl, getB2BucketId, getCredential, getDefaultWorkingWorkspaceDir, getExecutions, getGatewayConfig, getGraphPackageById, getPrimarySrklDeploymentUrl as getPrimarySrklCoreDeploymentUrl, getProjectById, getPublicRouteByPath, getPublicRoutes, getSrklAccounts as getSrklCoreAccounts, getSrklStatus, getUnifiedDbUrl, getUsers, getWorkingWorkspaceConfig, getWorkingWorkspaceDir, getWorkspaceFolderKey, getWorkspaceFolderPrefix, getWorkspaceGraph, getWorkspaceStorageDetails, getWorkspaces, importEncryptedCredentials, importGraphDependency, initGlobalSamplesDirectory, isB2Workspace, listAllGraphPackages, listAllProjects, listBackblazeBuckets, listCredentials, listGlobalSamples, listProjectSamples, listWorkspaceFiles, listWorkspaceGraphs, loadCredentialManifest, loadWorkspaceData, loginUser, matchGatewayIngress, matchGatewayIngressAsync, queryUnifiedDb, readWorkspaceFile, recordExecution, removeGraphDependency, renameAppInWorkspaceData, resolveDynamicRouteFromDb, resolveWorkspaceConnection, resolveWorkspaceDir, saveAssetToGraph, saveAssetToPool, saveCredentialManifest, saveGlobalSample, saveGraphPackage, saveProject, saveProjectSample, saveWorkspaceData, saveWorkspaceGraph, scanAssetPool, scanGraphAssets, seedDefaultAssets, seedStarterGraphAssets, serverPublicRoutes, setServerPublicRoutes, setWorkingWorkspaceConfig, srklListBackblazeBuckets as srklCoreListBackblazeBuckets, syncWorkspace, syncWorkspaceCreateToBucket, syncWorkspaceDataToBucket, syncWorkspaceDeleteToBucket, updateCredential, updateWorkspace, upsertRoute, validateServiceDefinition, writeWorkspaceFile };
+/**
+ * Calculates the score (0.0 - 1.0) for a weight modifier or source node.
+ * WEIGHT_MULTIPLY itself is not a source score — its inputs are collected by traversal.
+ */
+declare function getWeightModifierScore(node: GraphNode, account?: AccountEntity, accounts?: AccountEntity[], nodes?: GraphNode[], edges?: GraphEdge[], deployments?: DeploymentEntity[]): number;
+/**
+ * Traverses graph to find all terminal weight modifier source nodes reachable from
+ * a deployment node, including traversing through WEIGHT_MULTIPLY aggregator nodes.
+ */
+declare function getConnectedWeightModifiers(deploymentNodeId: string, nodes: GraphNode[], edges: GraphEdge[]): GraphNode[];
+/**
+ * Computes the final combined weight for a deployment node by multiplying all connected
+ * weight modifier/source node scores together (traversing through WEIGHT_MULTIPLY nodes).
+ */
+declare function computeDeploymentFinalWeight(deploymentNodeId: string, nodes: GraphNode[], edges: GraphEdge[], accounts: AccountEntity[], deployments: DeploymentEntity[]): number;
+
+/**
+ * Calculates the score (0.0 - 1.0) for a WEIGHT_RESOURCE node based on real-time account usage metrics.
+ * Dynamically resolves provider-specific fetchers (Vercel, Cloudflare, etc.) using OOP inheritance.
+ * - Active CPU receives the most weight (50% / 0.50) across all services.
+ * - Function Invocations: 15% (0.15).
+ * - Compute Memory / Subrequests: 15% (0.15).
+ * - Edge Requests: 10% (0.10).
+ * - Fast Data Transfer / Bandwidth: 5% (0.05).
+ * - Other compute / network metrics: 5% (0.05).
+ * - Storage category parameters (Functions Storage, Deployment Storage, R2) are strictly EXCLUDED (0%).
+ */
+declare function computeUsageWeightScore(account?: AccountEntity, deployment?: DeploymentEntity): number;
+/**
+ * Traverses from a weight modifier node to find its connected deployment node.
+ */
+declare function getConnectedDeploymentNode(weightNodeId: string, nodes: GraphNode[], edges: GraphEdge[]): GraphNode | undefined;
+
+export { type AssetChannelType, type AssetDataType, type AssetFolderInfo, type AssetPoolItem, type AssetPoolScope, type B2AuthData, type BackendFacade, BaseDataProvider, BaseResourceFetcher, type CloudflareObservability, type CloudflareProjectItem, CloudflareResourceFetcher, type CloudflareUsageMetrics, type CredentialEntry, type CredentialManifest, type Deployment, type FunctionSet, FunctionalityTable, GRAPHS_ROOT, type IDataProvider, LEGACY_PROJECTS_ROOT, type OrchestrationFn, PROJECTS_ROOT, type ProjectMetadata, type PublicRouteRecord, type QueryFilter, ResourceFetcherRegistry, type Runtime, SAMPLES_GLOBAL_ROOT, SUPPORTED_AUDIO_EXTS, SUPPORTED_MIDI_EXTS, type ServerAudioSampleItem, type ServiceFacade, type ServiceRegistryRecord, type SortOrder, type SrklB2Account, SrklStorageService, type SyncFileResult, type UnifiedQueryResult, type UnifiedResourceMetricItem, type UnifiedResourceMetrics, VercelResourceFetcher, WORKSPACE_ASSETS_ROOT, WORKSPACE_ROOT, type WorkingWorkspaceConfig, type WorkspaceFolderResolution, type WorkspaceStorageConfig, b2DeleteFileVersion, b2DeleteFolder, buildProjectObservability, buildProjectsList, cleanDbUrl, computeDeploymentFinalWeight, computeUsageWeightScore, configureStarterProjectTemplate, createAssetSubfolder, createCredential, createGraphAssetFolder, createGraphAssetFolder as createGraphAssetSubfolder, createGraphPackage, createWavBuffer, createWorkspace, createWorkspaceGraph, decryptSecretFromBlob, deleteAssetFromGraph, deleteAssetFromPool, deleteCredential, deleteGlobalSample, deleteGraphPackage, deleteProject, deleteProjectSample, deleteRoute, deleteWorkspace, deleteWorkspaceFile, deleteWorkspaceFolder, deleteWorkspaceGraph, encryptSecretToBlob, ensureAssetPoolDirectories, ensureGlobalSamples, ensureGraphAssetDirectories, ensureProjectAssets, ensureProjectsRoot, ensureWorkspaceStructure, exportEncryptedCredentials, fetchCloudflareData, fetchVercelData, findUserWorkspace, findWorkspaceRecord, formatRelativeCreated, getAllRoutes, getAssetPoolLocationPath, getAssetPoolPublicUrl, getB2BucketId, getConnectedDeploymentNode, getConnectedWeightModifiers, getCredential, getDefaultWorkingWorkspaceDir, getExecutions, getGatewayConfig, getGraphPackageById, getPrimarySrklDeploymentUrl as getPrimarySrklCoreDeploymentUrl, getProjectById, getPublicRouteByPath, getPublicRoutes, getSrklAccounts as getSrklCoreAccounts, getSrklStatus, getUnifiedDbUrl, getUsers, getWeightModifierScore, getWorkingWorkspaceConfig, getWorkingWorkspaceDir, getWorkspaceFolderKey, getWorkspaceFolderPrefix, getWorkspaceGraph, getWorkspaceStorageDetails, getWorkspaces, importEncryptedCredentials, importGraphDependency, initGlobalSamplesDirectory, isB2Workspace, listAllGraphPackages, listAllProjects, listBackblazeBuckets, listCredentials, listGlobalSamples, listProjectSamples, listWorkspaceFiles, listWorkspaceGraphs, loadCredentialManifest, loadWorkspaceData, loginUser, matchGatewayIngress, matchGatewayIngressAsync, queryUnifiedDb, readWorkspaceFile, recordExecution, removeGraphDependency, renameAppInWorkspaceData, resolveDynamicRouteFromDb, resolveWorkspaceConnection, resolveWorkspaceDir, saveAssetToGraph, saveAssetToPool, saveCredentialManifest, saveGlobalSample, saveGraphPackage, saveProject, saveProjectSample, saveWorkspaceData, saveWorkspaceGraph, scanAssetPool, scanGraphAssets, seedDefaultAssets, seedStarterGraphAssets, serverPublicRoutes, setServerPublicRoutes, setWorkingWorkspaceConfig, srklListBackblazeBuckets as srklCoreListBackblazeBuckets, syncWorkspace, syncWorkspaceCreateToBucket, syncWorkspaceDataToBucket, syncWorkspaceDeleteToBucket, updateCredential, updateWorkspace, upsertRoute, validateServiceDefinition, writeWorkspaceFile };

package/packages/backend/dist/index.js

@@ -1,12 +1,33 @@
+import {
+  CompositeBackend,
+  EndpointGenerator,
+  LOCAL_STORAGE_GRAPHS_PREFIX,
+  NodeGraphPersistenceService,
+  createBackend,
+  createCompositeService,
+  createLocalService,
+  createRemoteService,
+  exportGraphAsJsonFile,
+  nodeGraphPersistence,
+  parseGraphJsonFile,
+  validateGraphDocument
+} from "./chunk-BM4QMVPA.js";
 import {
   CANONICAL_SRKL_URL,
   SrklClient,
+  SrklCredentialRegistry,
+  SrklVaultAccessClient,
   createSrklClient,
+  decryptVaultBufferInBrowser,
   getPrimarySrklDeploymentUrl,
   getSrklAccounts,
+  globalCredentialRegistry,
+  hexToBytes,
   srklListBackblazeBuckets,
+  srklService,
+  syncSrklAccounts,
   useSrklServices
-} from "./chunk-MN54ZIKZ.js";
+} from "./chunk-KX3OTBQ3.js";
 import "./chunk-LS3HWJBX.js";
 import {
   authorizeB2,
@@ -15,12 +36,6 @@ import {
   b2ListFileNames,
   b2UploadFile
 } from "./chunk-4QEMALXF.js";
-import {
-  BaseApiRoute,
-  createSSEResponse,
-  withAuth,
-  withCors
-} from "./chunk-TWCEVES2.js";
 import {
   SyncEngine,
   WorkspaceCloneSyncEngine,
@@ -41,7 +56,8 @@ import {
   StorageServiceFacade,
   WorkspaceServiceDefinition,
   WorkspaceServiceFacade
-} from "./chunk-OYQKQAEF.js";
+} from "./chunk-CU7RZBMF.js";
+import "./chunk-IPP4VURQ.js";
 import {
   BackblazeB2Adapter,
   BaseStorageAdapter,
@@ -61,6 +77,12 @@ import {
   formatCanonicalWorkspaceFolderName,
   sanitizeWorkspaceName
 } from "./chunk-FZKBTF34.js";
+import {
+  BaseApiRoute,
+  createSSEResponse,
+  withAuth,
+  withCors
+} from "./chunk-TWCEVES2.js";
 import {
   AdminGuard,
   BaseAccountProvider,
@@ -124,15 +146,6 @@ import {
 import {
   IdempotencyManager
 } from "./chunk-3EPY34R6.js";
-import {
-  CompositeBackend,
-  EndpointGenerator,
-  createBackend,
-  createCompositeService,
-  createLocalService,
-  createRemoteService
-} from "./chunk-P4HL4C6V.js";
-import "./chunk-IPP4VURQ.js";
 
 // src/data/BaseDataProvider.ts
 import { SkipoBase } from "@ultrst-armada/kloks/functions";
@@ -5340,10 +5353,12 @@ export {
   JobDependencyGraph,
   JobScheduler,
   LEGACY_PROJECTS_ROOT,
+  LOCAL_STORAGE_GRAPHS_PREFIX,
   LoadBalancer,
   LocalAccountProvider,
   LocalFSAdapter,
   LockManager,
+  NodeGraphPersistenceService,
   PROJECTS_ROOT,
   PasswordHasher,
   RateLimiter,
@@ -5358,7 +5373,9 @@ export {
   ServiceDispatcher,
   SessionManager,
   SrklClient,
+  SrklCredentialRegistry,
   SrklStorageService,
+  SrklVaultAccessClient,
   StorageAdapterFactory,
   StorageServiceDefinition,
   StorageServiceFacade,
@@ -5383,6 +5400,8 @@ export {
   buildProjectObservability,
   buildProjectsList,
   cleanDbUrl,
+  computeDeploymentFinalWeight,
+  computeUsageWeightScore,
   configureStarterProjectTemplate,
   createAssetSubfolder,
   createBackend,
@@ -5402,6 +5421,7 @@ export {
   createWorkspace,
   createWorkspaceGraph,
   decryptSecretFromBlob,
+  decryptVaultBufferInBrowser,
   deleteAssetFromGraph,
   deleteAssetFromPool,
   deleteCredential,
@@ -5424,6 +5444,7 @@ export {
   ensureS3DirectoryMarker,
   ensureWorkspaceStructure,
   exportEncryptedCredentials,
+  exportGraphAsJsonFile,
   fetchCloudflareData,
   fetchVercelData,
   findUserWorkspace,
@@ -5434,6 +5455,8 @@ export {
   getAssetPoolLocationPath,
   getAssetPoolPublicUrl,
   getB2BucketId,
+  getConnectedDeploymentNode,
+  getConnectedWeightModifiers,
   getCredential,
   getDefaultWorkingWorkspaceDir,
   getExecutions,
@@ -5450,6 +5473,7 @@ export {
   getSystemDatabaseUrls,
   getUnifiedDbUrl,
   getUsers,
+  getWeightModifierScore,
   getWorkingWorkspaceConfig,
   getWorkingWorkspaceDir,
   getWorkspaceFolderKey,
@@ -5457,6 +5481,8 @@ export {
   getWorkspaceGraph,
   getWorkspaceStorageDetails,
   getWorkspaces,
+  globalCredentialRegistry,
+  hexToBytes,
   importEncryptedCredentials,
   importGraphDependency,
   initGlobalSamplesDirectory,
@@ -5476,7 +5502,9 @@ export {
   loginUser,
   matchGatewayIngress,
   matchGatewayIngressAsync,
+  nodeGraphPersistence,
   normalizeBackblazeCredentials,
+  parseGraphJsonFile,
   permanentDeleteS3Folder,
   permanentDeleteS3Object,
   queryUnifiedDb,
@@ -5510,6 +5538,8 @@ export {
   setWorkingWorkspaceConfig,
   srklListBackblazeBuckets2 as srklCoreListBackblazeBuckets,
   srklListBackblazeBuckets,
+  srklService,
+  syncSrklAccounts,
   syncWorkspace,
   syncWorkspaceCreateToBucket,
   syncWorkspaceDataToBucket,
@@ -5520,6 +5550,7 @@ export {
   useBackend,
   useBackendClient,
   useSrklServices,
+  validateGraphDocument,
   validateServiceDefinition,
   withAuth,
   withCors,

package/packages/backend/dist/krnl-services.js

@@ -13,13 +13,13 @@ import {
   StorageServiceFacade,
   WorkspaceServiceDefinition,
   WorkspaceServiceFacade
-} from "./chunk-OYQKQAEF.js";
+} from "./chunk-CU7RZBMF.js";
+import "./chunk-IPP4VURQ.js";
 import "./chunk-J2J24JVC.js";
 import "./chunk-FZKBTF34.js";
 import "./chunk-25Y7AVTP.js";
 import "./chunk-QGHDJGYS.js";
 import "./chunk-3EPY34R6.js";
-import "./chunk-IPP4VURQ.js";
 export {
   AuthServiceDefinition,
   AuthServiceFacade,

package/packages/backend/dist/services/index.d.ts

@@ -63,4 +63,171 @@ declare class EndpointGenerator {
 declare function createBackend(name: string): CompositeBackend;
 declare function createCompositeService(name: string): CompositeBackend;
 
-export { CompositeBackend, EndpointGenerator, type GeneratedEndpointSummary, type LocalService, type RemoteServiceProxy, createBackend, createCompositeService, createLocalService, createRemoteService };
+/**
+ * @file types.ts
+ * @description Universal types for node graph document persistence, serialization, and storage sync.
+ */
+interface UniversalGraphNode {
+    id: string;
+    type?: string;
+    label?: string;
+    name?: string;
+    appId?: string;
+    deploymentId?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    data?: Record<string, any>;
+    [key: string]: any;
+}
+interface UniversalGraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    sourceSocket?: string;
+    targetSocket?: string;
+    appId?: string;
+    data?: Record<string, any>;
+    [key: string]: any;
+}
+interface UniversalAppEntity {
+    id: string;
+    name: string;
+    icon?: string;
+    description?: string;
+    publicLink?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: any;
+}
+interface UniversalStorageConnection {
+    id: string;
+    provider: 'local_fs' | 'backblaze_b2' | 'cloudflare_r2' | 'aws_s3' | 'supabase' | string;
+    localFolderName?: string;
+    b2BucketName?: string;
+    s3BucketName?: string;
+    r2BucketName?: string;
+    supabaseBucketName?: string;
+    [key: string]: any;
+}
+interface UniversalNodeGraphDocument {
+    $schema?: string;
+    version: string;
+    appId: string;
+    appName: string;
+    appIcon?: string;
+    description?: string;
+    publicLink?: string;
+    createdAt: string;
+    updatedAt: string;
+    exportedAt: string;
+    author?: {
+        userId?: string;
+        username?: string;
+        email?: string;
+        name?: string;
+        role?: string;
+    };
+    viewport?: {
+        zoom: number;
+        pan: {
+            x: number;
+            y: number;
+        };
+    };
+    graph: {
+        nodes: UniversalGraphNode[];
+        edges: UniversalGraphEdge[];
+    };
+    deployments?: any[];
+    storageMetadata?: {
+        provider: string;
+        targetName: string;
+        targetPath: string;
+        storageConnectionId?: string;
+        checksum?: string;
+        syncedAt?: string;
+    };
+}
+interface NodeGraphValidationResult {
+    valid: boolean;
+    errors: string[];
+    document?: UniversalNodeGraphDocument;
+}
+interface SaveGraphOptions {
+    app: UniversalAppEntity;
+    nodes: UniversalGraphNode[];
+    edges: UniversalGraphEdge[];
+    deployments?: any[];
+    viewport?: {
+        zoom: number;
+        pan: {
+            x: number;
+            y: number;
+        };
+    };
+    storageConnection?: UniversalStorageConnection;
+}
+declare const LOCAL_STORAGE_GRAPHS_PREFIX = "depm_graph_doc_";
+
+/**
+ * @file helpers.ts
+ * @description Helper functions for validating, exporting, and parsing universal node graph documents.
+ */
+
+/**
+ * Validates a parsed JSON object to verify it matches the UniversalNodeGraphDocument schema.
+ */
+declare function validateGraphDocument(data: any): NodeGraphValidationResult;
+/**
+ * Triggers a browser download of the node graph as a portable JSON file.
+ */
+declare function exportGraphAsJsonFile(graphDoc: UniversalNodeGraphDocument): void;
+/**
+ * Reads and parses a graph JSON file from an input file element.
+ */
+declare function parseGraphJsonFile(file: File): Promise<NodeGraphValidationResult>;
+
+/**
+ * @file nodeGraphPersistence.ts
+ * @description Universal Node Graph Persistence Service.
+ * Manages serialization, schema validation, browser localStorage caching,
+ * and direct persistence to file system or cloud storage adapters.
+ */
+
+declare class NodeGraphPersistenceService {
+    /**
+     * Generates a fully compliant v1.0.0 JSON document representing the app's complete node graph.
+     */
+    createGraphDocument(options: SaveGraphOptions): UniversalNodeGraphDocument;
+    /**
+     * Validates a parsed JSON object to verify it matches the NodeGraphDocument schema.
+     */
+    validateGraphDocument(data: any): NodeGraphValidationResult;
+    /**
+     * Saves the node graph to the selected user storage option (Local Folder or Cloud Bucket)
+     * and caches it in LocalStorage.
+     */
+    saveGraphToStorage(options: SaveGraphOptions, customDirectoryHandle?: any): Promise<{
+        success: boolean;
+        document: UniversalNodeGraphDocument;
+        message: string;
+        targetPath: string;
+    }>;
+    /**
+     * Loads a cached or previously saved node graph document for an app.
+     */
+    loadSavedGraph(appId: string): UniversalNodeGraphDocument | null;
+    /**
+     * Triggers a browser download of the node graph as a portable JSON file.
+     */
+    exportGraphAsJsonFile(graphDoc: UniversalNodeGraphDocument): void;
+    /**
+     * Reads and parses a graph JSON file from an input file element.
+     */
+    parseGraphJsonFile(file: File): Promise<NodeGraphValidationResult>;
+}
+declare const nodeGraphPersistence: NodeGraphPersistenceService;
+
+export { CompositeBackend, EndpointGenerator, type GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, type LocalService, NodeGraphPersistenceService, type NodeGraphValidationResult, type RemoteServiceProxy, type SaveGraphOptions, type UniversalAppEntity, type UniversalGraphEdge, type UniversalGraphNode, type UniversalNodeGraphDocument, type UniversalStorageConnection, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument };

package/packages/backend/dist/services/index.js

@@ -1,17 +1,29 @@
 import {
   CompositeBackend,
   EndpointGenerator,
+  LOCAL_STORAGE_GRAPHS_PREFIX,
+  NodeGraphPersistenceService,
   createBackend,
   createCompositeService,
   createLocalService,
-  createRemoteService
-} from "../chunk-P4HL4C6V.js";
+  createRemoteService,
+  exportGraphAsJsonFile,
+  nodeGraphPersistence,
+  parseGraphJsonFile,
+  validateGraphDocument
+} from "../chunk-BM4QMVPA.js";
 import "../chunk-IPP4VURQ.js";
 export {
   CompositeBackend,
   EndpointGenerator,
+  LOCAL_STORAGE_GRAPHS_PREFIX,
+  NodeGraphPersistenceService,
   createBackend,
   createCompositeService,
   createLocalService,
-  createRemoteService
+  createRemoteService,
+  exportGraphAsJsonFile,
+  nodeGraphPersistence,
+  parseGraphJsonFile,
+  validateGraphDocument
 };