@anaralabs/sdk 0.1.0

package/dist/openapi.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { ANARA_METHODS } from './schemas.js';
+function jsonSchema(schema) {
+    return z.toJSONSchema(schema, { target: 'draft-2020-12', io: 'input' });
+}
+/**
+ * Generates the OpenAPI 3.1 document for the anara.* surface straight from the
+ * zod method registry, so the spec is always in sync with the schemas the
+ * server validates with and the client is typed from. Each method is one POST
+ * operation at `/api/v1/sdk/{method}`; the request body is the method's
+ * positional args, the response is its return value.
+ */
+export function buildOpenApiDocument(options = {}) {
+    const paths = {};
+    for (const [name, spec] of Object.entries(ANARA_METHODS)) {
+        paths[`/api/v1/sdk/${name}`] = {
+            post: {
+                operationId: name.replace(/\./g, '_'),
+                summary: spec.summary,
+                'x-anara-scope': spec.write ? 'anara:write' : 'anara:read',
+                security: [{ ApiKeyAuth: [] }],
+                requestBody: {
+                    required: true,
+                    content: {
+                        'application/json': { schema: jsonSchema(spec.input) },
+                    },
+                },
+                responses: {
+                    '200': {
+                        description: 'Success',
+                        content: {
+                            'application/json': {
+                                schema: z.toJSONSchema(spec.output, {
+                                    target: 'draft-2020-12',
+                                    io: 'output',
+                                }),
+                            },
+                        },
+                    },
+                    '400': { description: 'Invalid request' },
+                    '401': { description: 'Missing or invalid API key' },
+                    '403': { description: 'Missing scope or no access to the resource' },
+                    '429': { description: 'Rate limited or destructive budget exceeded' },
+                },
+            },
+        };
+    }
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: options.title ?? 'Anara API',
+            version: options.version ?? '0.1.0',
+            description: 'The anara.* SDK surface — library search, research, entities, documents, store, and RLM — over an API key.',
+        },
+        ...(options.serverUrl ? { servers: [{ url: options.serverUrl }] } : {}),
+        components: {
+            securitySchemes: {
+                ApiKeyAuth: { type: 'apiKey', in: 'header', name: 'x-api-key' },
+            },
+        },
+        security: [{ ApiKeyAuth: [] }],
+        paths,
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAS7C,SAAS,UAAU,CAAC,MAAoB;IACtC,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAO,GAAmB,EAAE;IAC/D,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,GAAG;YAC7B,IAAI,EAAE;gBACJ,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;gBACrC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY;gBAC1D,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;gBAC9B,WAAW,EAAE;oBACX,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE;wBACP,kBAAkB,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;qBACvD;iBACF;gBACD,SAAS,EAAE;oBACT,KAAK,EAAE;wBACL,WAAW,EAAE,SAAS;wBACtB,OAAO,EAAE;4BACP,kBAAkB,EAAE;gCAClB,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;oCAClC,MAAM,EAAE,eAAe;oCACvB,EAAE,EAAE,QAAQ;iCACb,CAAC;6BACH;yBACF;qBACF;oBACD,KAAK,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE;oBACzC,KAAK,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE;oBACpD,KAAK,EAAE,EAAE,WAAW,EAAE,4CAA4C,EAAE;oBACpE,KAAK,EAAE,EAAE,WAAW,EAAE,6CAA6C,EAAE;iBACtE;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,WAAW;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;YACnC,WAAW,EACT,4GAA4G;SAC/G;QACD,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,UAAU,EAAE;YACV,eAAe,EAAE;gBACf,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC9B,KAAK;KACN,CAAC;AACJ,CAAC"}