@nosana/types 2.12.0 → 2.13.0

package/README.md

@@ -44,4 +44,15 @@ declare module '@nosana/types' {
 }
 ```
 
-For more info go to [learn.nosana.com](https://learn.nosana.com)
+For more info go to [learn.nosana.com](https://learn.nosana.com)
+## Node API contract
+
+`src/Schemas/nodeOpenApi.ts` is the OpenAPI 3.1 document for the HTTP API every node
+serves for its jobs, and the single source of truth for it. `JobDefinition`, `FlowState`
+and everything they reach are taken from the TypeScript types through typia at build
+time, so the document cannot drift from them. `pnpm generate:node` (after `pnpm build`)
+exports it to `openapi/node.openapi.json`, which ships with the package, and regenerates
+`src/Schemas/node.ts`, exported as the `NodeApiSchema` namespace. `@nosana/api` builds
+its node client from those types, and the node repository can type its route handlers
+against the same ones and serve `nodeOpenApiDocument()` at `/openapi.json` to join the
+gateway spec, its swagger and the MCP.

package/dist/Common/index.d.ts

@@ -20,4 +20,7 @@ export declare const NOSANA_PROGRAM_ADDRESSES: Record<NosanaNetwork, {
     pools: string;
     merkleDistributor: string;
 }>;
+/** A Solana address: base58 without the ambiguous characters, 32 to 44 characters long. */
+export declare const SOLANA_ADDRESS_PATTERN = "^[1-9A-HJ-NP-Za-km-z]{32,44}$";
+export declare function isSolanaAddress(value: string): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/Common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Common/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAInD,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,aAAa,EACb;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAuBO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Common/index.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAInD,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,aAAa,EACb;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAuBO,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAItE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/Common/index.js

@@ -39,4 +39,10 @@ export const NOSANA_PROGRAM_ADDRESSES = {
         merkleDistributor: 'merkp8F8f5EgYSYKadk3YiuQQdo3JPdnJWKviaaF425',
     },
 };
+/** A Solana address: base58 without the ambiguous characters, 32 to 44 characters long. */
+export const SOLANA_ADDRESS_PATTERN = '^[1-9A-HJ-NP-Za-km-z]{32,44}$';
+const SOLANA_ADDRESS = new RegExp(SOLANA_ADDRESS_PATTERN);
+export function isSolanaAddress(value) {
+    return SOLANA_ADDRESS.test(value);
+}
 //# sourceMappingURL=index.js.map

package/dist/Common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Common/index.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkC;IAC/D,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,6CAA6C;IACtE,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,6CAA6C;IACrE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,6CAA6C;CAC/D,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GASjC;IACF,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE;QACvB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,6CAA6C;QACtD,KAAK,EAAE,6CAA6C;QACpD,KAAK,EAAE,6CAA6C;QACpD,iBAAiB,EAAE,6CAA6C;KACjE;IACD,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE;QACtB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,6CAA6C;QACtD,KAAK,EAAE,6CAA6C;QACpD,KAAK,EAAE,6CAA6C;QACpD,iBAAiB,EAAE,6CAA6C;KACjE;IACD,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE;QACxB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,6CAA6C;QACtD,KAAK,EAAE,6CAA6C;QACpD,KAAK,EAAE,6CAA6C;QACpD,iBAAiB,EAAE,6CAA6C;KACjE;CACO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Common/index.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkC;IAC/D,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,6CAA6C;IACtE,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,6CAA6C;IACrE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,6CAA6C;CAC/D,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GASjC;IACF,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE;QACvB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,6CAA6C;QACtD,KAAK,EAAE,6CAA6C;QACpD,KAAK,EAAE,6CAA6C;QACpD,iBAAiB,EAAE,6CAA6C;KACjE;IACD,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE;QACtB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,6CAA6C;QACtD,KAAK,EAAE,6CAA6C;QACpD,KAAK,EAAE,6CAA6C;QACpD,iBAAiB,EAAE,6CAA6C;KACjE;IACD,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE;QACxB,IAAI,EAAE,6CAA6C;QACnD,OAAO,EAAE,6CAA6C;QACtD,KAAK,EAAE,6CAA6C;QACpD,KAAK,EAAE,6CAA6C;QACpD,iBAAiB,EAAE,6CAA6C;KACjE;CACO,CAAC;AAEX,2FAA2F;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AAEtE,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/Schemas/index.d.ts

@@ -1,3 +1,6 @@
 export * from "./api.js";
 export * from "./job.js";
+export { nodeOpenApiDocument, type NodeOpenApiDocument } from "./nodeOpenApi.js";
+/** The node API, generated from `openapi/node.openapi.json`; namespaced so its `paths` cannot collide with the gateway's. */
+export type * as NodeApiSchema from "./node.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/Schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAChF,6HAA6H;AAC7H,YAAY,KAAK,aAAa,MAAM,WAAW,CAAA"}

package/dist/Schemas/index.js

@@ -1,3 +1,4 @@
 export * from "./api.js";
 export * from "./job.js";
+export { nodeOpenApiDocument } from "./nodeOpenApi.js";
 //# sourceMappingURL=index.js.map

package/dist/Schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,mBAAmB,EAA4B,MAAM,kBAAkB,CAAA"}