@nosana/api 2.11.2 → 2.13.1

package/dist/types.d.ts

@@ -2,8 +2,10 @@ import type { ClientManagerClient } from './client/client-manager/index.js';
 import type { BlockchainIndexerClient } from './client/blockchain-indexer/index.js';
 import type { HostManagerClient } from './client/host-manager/index.js';
 import type { DeploymentManagerClient } from './client/deployment-manager/index.js';
+import type { GenerateOptions } from '@nosana/authorization';
 import { TopupVaultOptions } from './routes/deployments/types.js';
-export { NosanaNetwork } from '@nosana/types';
+import { NosanaNetwork } from '@nosana/types';
+export { NosanaNetwork };
 export type { NosanaNetwork as NosanaNetworkType } from '@nosana/types';
 export interface SolanaConfig {
     network: string;
@@ -26,15 +28,28 @@ export type ExternalSolanaFunctions = {
 };
 export type SignerAuth = {
     identifier: string;
-    generate: (message: string) => Promise<string>;
+    generate: SignedHeaderAuth['generate'];
     solana: ExternalSolanaFunctions;
 };
+/**
+ * The minimal auth a node needs. A node verifies the signed `authorization`
+ * header against the job owner's key, so only a header generator is required;
+ * `x-user-id` is optional and unused by nodes. `SignerAuth` satisfies it, and
+ * an API-key caller supplies one backed by the client manager's signing service.
+ */
+export type SignedHeaderAuth = {
+    identifier?: string;
+    /** Terminal grants request fresh signing without touching the normal auth cache. */
+    generate: (message: string, options?: Pick<GenerateOptions, 'skipCache'>) => Promise<string>;
+};
 export type CreateNosanaApiOptions = Partial<{
     client_manager_url: string;
     host_manager_url: string;
     blockchain_indexer_url: string;
     /** Under API key auth this becomes the client manager proxy's forwarding target. */
     deployment_manager_url: string;
+    /** Domain under which every node's API answers, as `<address>.<domain>`. */
+    node_domain: string;
     include_credentials: boolean;
 }>;
 export interface Config {
@@ -42,6 +57,7 @@ export interface Config {
     host_manager_url: string;
     blockchain_indexer_url: string;
     deployment_manager_url: string;
+    node_domain: string;
     nos_address: string;
 }
 /**
@@ -53,8 +69,21 @@ export interface NosanaClients {
     blockchainIndexer: BlockchainIndexerClient;
     deploymentManager: DeploymentManagerClient;
 }
+/** An open stream, for as long as the caller wants it. */
+export type StreamSubscription = {
+    close: () => void;
+};
+/** What every stream reports besides its frames. */
+export interface StreamLifecycleHandlers {
+    /** The stream opened, or reopened after dropping: resynchronise from here. */
+    onOpen?: () => void;
+    onError?: (error: unknown) => void;
+}
 export interface DeploymentRouteClients {
     deploymentManager: DeploymentManagerClient;
+    /** Network and options a deployment needs to reach its jobs' nodes directly. */
+    environment: NosanaNetwork;
+    options?: CreateNosanaApiOptions;
 }
 export type DeploymentRouteClientsWithSigner = DeploymentRouteClients & {
     solana: ExternalSolanaFunctions;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,iEAAiE;IACjE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEvE,0EAA0E;IAC1E,yBAAyB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3F,oEAAoE;IACpE,wCAAwC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACpF,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC;IAC3C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oFAAoF;IACpF,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC,CAAA;AAEF,MAAM,WAAW,MAAM;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,mBAAmB,CAAC;IACnC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C,iBAAiB,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,MAAM,gCAAgC,GAAG,sBAAsB,GAAG;IACtE,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,3 +1,4 @@
 // Re-export shared types from @nosana/types
-export { NosanaNetwork } from '@nosana/types';
+import { NosanaNetwork } from '@nosana/types';
+export { NosanaNetwork };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/utils/eventStream.d.ts

@@ -0,0 +1,15 @@
+import type { ClientConnection } from '../client/type.utils.js';
+import type { StreamLifecycleHandlers, StreamSubscription } from '../types.js';
+export interface EventStreamHandlers extends StreamLifecycleHandlers {
+    /** One parsed frame. Frames that are not JSON are dropped before this. */
+    onMessage: (frame: unknown) => void;
+}
+/**
+ * Opens a server-sent event stream addressed and authenticated exactly as an
+ * ordinary request on the same connection. `EventSource` reconnects by itself,
+ * so errors are reported rather than thrown and `onOpen` may fire more than
+ * once. A handler that throws is swallowed with the malformed frames, the
+ * price of never letting one bad frame end the stream.
+ */
+export declare function openEventStream(connection: ClientConnection, path: string, handlers: EventStreamHandlers): StreamSubscription;
+//# sourceMappingURL=eventStream.d.ts.map

package/dist/utils/eventStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventStream.d.ts","sourceRoot":"","sources":["../../src/utils/eventStream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAClE,0EAA0E;IAC1E,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,gBAAgB,EAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mBAAmB,GAC5B,kBAAkB,CA0BpB"}

package/dist/utils/eventStream.js

@@ -0,0 +1,36 @@
+import { EventSource } from 'eventsource';
+import { tryParseJson } from './json.js';
+/**
+ * Opens a server-sent event stream addressed and authenticated exactly as an
+ * ordinary request on the same connection. `EventSource` reconnects by itself,
+ * so errors are reported rather than thrown and `onOpen` may fire more than
+ * once. A handler that throws is swallowed with the malformed frames, the
+ * price of never letting one bad frame end the stream.
+ */
+export function openEventStream(connection, path, handlers) {
+    const { baseUrl, headers, credentials } = connection;
+    const source = new EventSource(`${baseUrl}${path}`, {
+        fetch: async (input, init) => fetch(input, {
+            ...init,
+            // Under cookie auth there are no headers to copy, so the stream has to
+            // opt into sending the cookie or it authenticates as nobody.
+            ...(credentials ? { credentials } : {}),
+            headers: { ...init.headers, ...(await headers()) },
+        }),
+    });
+    source.onopen = () => handlers.onOpen?.();
+    source.onerror = (error) => handlers.onError?.(error);
+    source.onmessage = ({ data }) => {
+        const frame = tryParseJson(data);
+        if (frame === undefined)
+            return;
+        try {
+            handlers.onMessage(frame);
+        }
+        catch {
+            return;
+        }
+    };
+    return { close: () => source.close() };
+}
+//# sourceMappingURL=eventStream.js.map

package/dist/utils/eventStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventStream.js","sourceRoot":"","sources":["../../src/utils/eventStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAUzC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA4B,EAC5B,IAAY,EACZ,QAA6B;IAE7B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE;QAClD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC3B,KAAK,CAAC,KAAK,EAAE;YACX,GAAG,IAAI;YACP,uEAAuE;YACvE,6DAA6D;YAC7D,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,OAAO,EAAE,CAAC,EAAE;SACnD,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1C,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,IAAI,CAAC;YACH,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/utils/json.d.ts

@@ -0,0 +1,3 @@
+/** `JSON.parse` that answers `undefined` instead of throwing for text that is not JSON. */
+export declare function tryParseJson(text: string): unknown;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMlD"}

package/dist/utils/json.js

@@ -0,0 +1,10 @@
+/** `JSON.parse` that answers `undefined` instead of throwing for text that is not JSON. */
+export function tryParseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nosana/api",
-  "version": "2.11.2",
+  "version": "2.13.1",
   "description": "Nosana API module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -49,15 +49,19 @@
     "@typescript-eslint/eslint-plugin": "^8.38.0",
     "@typescript-eslint/parser": "^8.38.0",
     "@vitest/coverage-v8": "^4.0.3",
+    "bs58": "^6.0.0",
     "eslint": "^9.31.0",
     "eslint-plugin-import": "^2.32.0",
     "husky": "^9.1.7",
     "openapi-typescript": "^7.8.0",
+    "tweetnacl": "^1.0.3",
     "typescript": "^5.9.3",
     "vitest": "^4.0.3"
   },
   "dependencies": {
-    "@nosana/types": "2.7.3",
+    "@nosana/authorization": "2.13.0",
+    "@nosana/ssh": "2.13.1",
+    "@nosana/types": "2.13.0",
     "eventsource": "^4.1.0",
     "openapi-fetch": "^0.14.0"
   },
@@ -65,5 +69,5 @@
   "engines": {
     "node": ">=20.18.0"
   },
-  "gitHead": "2c103c8a5655854534132ad7ceffdd821b44a301"
+  "gitHead": "694cadb116a2dcb5d27a591ceba5f91daaf39c73"
 }