@nosana/endpoints 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { ExposedPort, JobDefinition, Operation } from '@nosana/types';
+declare const createHash: (inputString: string, idLength?: number) => string;
+declare const getExposePorts: (op: Operation<"container/run">) => ExposedPort[];
+declare const isOpExposed: (op: Operation<"container/run">) => boolean;
+declare const getExposeIdHash: (flowId: string, op: number | string, port: number | string) => string;
+export type ExposedService = {
+    hash: string;
+    opIndex: number;
+    opId: string;
+    port: number | string;
+    hasHealthCheck: boolean;
+};
+declare const getJobExposeIdHash: (job: JobDefinition, flowId: string) => string[];
+declare const getJobExposedServices: (job: JobDefinition, flowId: string) => ExposedService[];
+export declare const isOperator: (v: string | number | object) => v is string;
+export declare const isSpreadMarker: (v: string | number | object) => boolean;
+export { getJobExposedServices, getJobExposeIdHash, getExposeIdHash, getExposePorts, isOpExposed, createHash, };

package/dist/index.js

@@ -0,0 +1,120 @@
+import bs58 from 'bs58';
+import nacl from 'tweetnacl';
+const createHash = (inputString, idLength = 44) => {
+    const base58Encoded = bs58.encode(nacl.hash(new TextEncoder().encode(inputString)));
+    return base58Encoded.slice(0, idLength);
+};
+const isPrivate = (job) => {
+    return job.ops.some((op) => {
+        if (op.type !== 'container/run')
+            return false;
+        const args = op.args;
+        const expose = args.expose;
+        const isExposed = (Array.isArray(expose) && expose.length > 0) ||
+            typeof expose === 'number' ||
+            typeof expose === 'string';
+        return isExposed && args.private === true;
+    });
+};
+const getExposePorts = (op) => {
+    const expose = op.args.expose;
+    if (!expose)
+        return [];
+    const isOperator = (v) => typeof v === 'string' && /^%%(ops|globals)\.[^%]+%%$/.test(v);
+    const isSpreadMarker = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) && '__spread__' in v;
+    if (typeof expose === 'number') {
+        return [{ port: expose, type: 'none' }];
+    }
+    if (typeof expose === 'string') {
+        // Skip dynamic operator strings; no concrete port to expose yet
+        if (isOperator(expose))
+            return [];
+        // Treat as concrete string port/range
+        return [{ port: expose, type: 'none' }];
+    }
+    if (Array.isArray(expose)) {
+        const out = [];
+        for (const e of expose) {
+            if (typeof e === 'number') {
+                out.push({ port: e, type: 'none' });
+                continue;
+            }
+            if (typeof e === 'string') {
+                if (isOperator(e))
+                    continue; // skip dynamic
+                out.push({ port: e, type: 'none' });
+                continue;
+            }
+            if (isSpreadMarker(e)) {
+                // dynamic spread marker; skip for concrete expose list
+                continue;
+            }
+            // assume ExposedPort shape; rely on typing for port union
+            out.push(e);
+        }
+        return out;
+    }
+    return [];
+};
+const isOpExposed = (op) => {
+    const exposePorts = getExposePorts(op);
+    return exposePorts.length > 0;
+};
+const getExposeIdHash = (flowId, op, port) => {
+    const idLength = 44;
+    const inputString = `${op}:${port}:${flowId}`;
+    return createHash(inputString, idLength);
+};
+const getJobExposeIdHash = (job, flowId) => {
+    const hashes = [];
+    const privateMode = isPrivate(job);
+    if (privateMode) {
+        return ['private'];
+    }
+    Object.entries(job.ops).forEach(([, op], index) => {
+        if (isOpExposed(op)) {
+            const exposePorts = getExposePorts(op);
+            exposePorts.forEach((port) => {
+                const exposeId = getExposeIdHash(flowId, index, port.port);
+                hashes.push(exposeId);
+            });
+        }
+    });
+    return hashes;
+};
+const getJobExposedServices = (job, flowId) => {
+    const hashes = [];
+    const privateMode = isPrivate(job);
+    if (privateMode) {
+        return [
+            {
+                hash: 'private',
+                opIndex: -1,
+                opId: '',
+                port: -1,
+                hasHealthCheck: false,
+            },
+        ];
+    }
+    Object.entries(job.ops).forEach(([, op], index) => {
+        if (isOpExposed(op)) {
+            const exposePorts = getExposePorts(op);
+            exposePorts.forEach((port) => {
+                const exposeId = getExposeIdHash(flowId, index, port.port);
+                hashes.push({
+                    hash: exposeId,
+                    opIndex: index,
+                    opId: op.id,
+                    port: port.port,
+                    hasHealthCheck: !!port.health_checks,
+                });
+            });
+        }
+    });
+    return hashes;
+};
+// Extract validation functions for reuse
+export const isOperator = (v) => typeof v === 'string' && /^%%(ops|globals)\.[^%]+%%$/.test(v);
+export const isSpreadMarker = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) && '__spread__' in v;
+export { getJobExposedServices, getJobExposeIdHash, getExposeIdHash, getExposePorts, isOpExposed, createHash, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@nosana/endpoints",
+  "version": "1.0.0",
+  "description": "Nosana endpoints module",
+  "main": "dist/index.js",
+  "type": "module",
+  "author": "Nosana",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "eslint": "eslint ./src",
+    "eslint:fix": "eslint --fix ./src",
+    "format": "npm run eslint",
+    "format:fix": "npm run eslint:fix",
+    "publish:public": "npm run build && npm publish --access public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.14",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "@vitest/coverage-v8": "^4.0.3",
+    "eslint": "^9.31.0",
+    "eslint-plugin-import": "^2.32.0",
+    "husky": "^9.1.7",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.3"
+  },
+  "dependencies": {
+    "@nosana/types": "^0.1.6",
+    "bs58": "^5.0.0",
+    "tweetnacl": "^1.0.3"
+  }
+}