@adhd/apigen-core-client 0.3.0 → 0.3.1

package/lib/batch.d.ts

@@ -45,21 +45,6 @@ export interface BatchKindSchema {
     /** Present only when ≥2 operations share this kind (a 1-branch `oneOf` is not a union). */
     discriminator?: InlineDiscriminator;
 }
-/**
- * Build the input/output schema pair for one `_batch/<kind>` mount (F1).
- *
- * - **≥2 ops of that kind:** a real `oneOf` + `InlineDiscriminator` union,
- *   using the same-document JSON-Pointer mechanism (`morph-walk.ts`), never
- *   `union.ts`'s $ref/nominal mechanism (§1.1).
- * - **Exactly 1 op of that kind:** the single branch's shape directly, no
- *   `oneOf` wrapper — `detectDiscriminator` itself refuses below 2 variants
- *   (§1.1's "edge case the 0.0.1 draft missed"), and a one-variant `oneOf`
- *   is not a union.
- *
- * Throws if `ops` is empty — callers (mount-building) must never invoke this
- * for a kind with zero operations; `groupBatchableOperationsByKind` never
- * produces an empty group.
- */
 export declare function buildBatchKindSchema(ops: readonly Operation[]): BatchKindSchema;
 /**
  * One synthetic `_batch/<kind>` operation shape, minus `handler` — mounting

package/lib/esm-require.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A `require` bound to this module's own location — the ESM-safe replacement
+ * for a bare `require(...)` in code bundled to BOTH `dist/index.js` (CJS) and
+ * `dist/index.mjs` (ESM). Resolves bare specifiers from this package's
+ * `node_modules` exactly as the CJS build's native `require` does, and (like
+ * the native `require`) exposes `.resolve`, so it is a drop-in for both
+ * `require(x)` and `require.resolve(x)` call sites.
+ *
+ * The `@ts-ignore` below suppresses TS1343 in DOWNSTREAM packages only.
+ * `apigen-core-client` is the base of the apigen family, so every consumer's
+ * `vite-plugin-dts` type-check follows this package's SOURCE through the
+ * tsconfig path mapping — and each consumer pins `module: commonjs` in its own
+ * `tsconfig.json`, where `import.meta` is rejected (TS1343). This file is only
+ * ever TYPE-CHECKED downstream, never emitted by it (the consumer emits its
+ * own declarations; the JS here is bundled by Rollup, which shims
+ * `import.meta.url` per output format) — so suppressing the diagnostic is
+ * scoped and safe. `@ts-ignore` (not `@ts-expect-error`) is deliberate: this
+ * package's own build runs `module: esnext`, where no diagnostic exists, so an
+ * expect-error directive would itself fail as unused. The rule-disable above
+ * the `@ts-ignore` is the established repo pattern for this exact suppression
+ * (see packages/data/data-query-engine/src/lib/expressions.ts).
+ */
+export declare const lazyRequire: NodeRequire;

package/lib/stream-type.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Detects whether `typeText` (a return type, already `Promise<T> → T`
+ * unwrapped by the caller) is one of the recognized streaming wrappers, and
+ * if so, returns the unwrapped per-chunk element type's text.
+ *
+ * Returns `null` when `typeText` is not a full, single streaming-wrapper
+ * type — including when it's a union with a stream member (e.g.
+ * `AsyncGenerator<T> | null`), since only the outermost `<...>` closing at
+ * the very end of the string counts as "fully wrapped" (a union closes its
+ * generic early, mid-string).
+ *
+ * @param typeText - Textual return type, e.g. `'AsyncGenerator<Chunk, void, unknown>'`.
+ * @returns The element type text (e.g. `'Chunk'`), or `null` if not streaming.
+ */
+export declare function detectStreamElementType(typeText: string): string | null;

package/lib/types.d.ts

@@ -35,6 +35,18 @@ export interface PluginInput {
         importPath: string;
         fns?: Record<string, (...args: unknown[]) => unknown>;
         createClient?: (envelope: Record<string, unknown>) => Promise<unknown>;
+        /**
+         * The real, published version of THIS package (e.g. `package.json`'s own
+         * `version`, read fresh — never a compiled-in constant). Optional: most
+         * `PluginInput.packages` callers never populate it and every existing
+         * construction site across the monorepo remains valid without it.
+         * `@adhd/apigen-plugin-mcp`'s `createMcpServer` reads it (falling back to
+         * this package's own `apigen-mcp`/`1.0.0` identity when absent) so an MCP
+         * client's `initialize` handshake reports which REAL build it is talking
+         * to, instead of a hardcoded placeholder identical across every apigen
+         * host (MCP handshake identity finding, P5-cli-serve-transport).
+         */
+        version?: string;
     }>;
     outputDir: string;
     options: Record<string, unknown>;

package/package.json

@@ -1,17 +1,40 @@
 {
   "name": "@adhd/apigen-core-client",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "dependencies": {
     "ts-morph": "^23.0.0",
     "ts-json-schema-generator": "^2.3.0",
     "pino": "10.3.1",
     "typescript": "^6.0.3",
-    "@adhd/apigen-base-logical": "^0.1.1"
+    "@adhd/apigen-base-logical": "^0.1.2"
   },
   "main": "./index.js",
   "module": "./index.mjs",
   "typings": "./index.d.ts",
   "publishConfig": {
     "access": "public"
+  },
+  "description": "Code-first API generation - derive JSON Schemas from TypeScript types and live-mount to HTTP, MCP, CLI, OpenAPI, Python, and Java with zero codegen",
+  "keywords": [
+    "openapi",
+    "typescript",
+    "codegen",
+    "json-schema",
+    "swagger",
+    "api",
+    "code-first",
+    "mcp",
+    "grpc",
+    "schema"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/apigen/apigen-core-client"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/apigen/apigen-core-client#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
   }
 }