@nxara/olio-codegen 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nxara contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,239 @@
-# Temporary Holding Version
+# @nxara/olio-codegen
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Generate TypeScript types from GraphQL SDL.
+
+`@nxara/olio-codegen` discovers modules from a directory layout, reads each module's GraphQL SDL, and emits a single strongly typed TypeScript file: schema types, per-module operation contracts, and the application type.
+
+It is deliberately small - SDL in, types out. Schema composition belongs to `@nxara/olio-schema`, the runtime to `@nxara/olio`.
+
+## Install
+
+```sh
+bun add @nxara/olio-codegen graphql@16
+```
+
+`graphql` 16 is a peer dependency (not 17, which is about 4× slower on small queries).
+
+## Usage
+
+There is no bundled CLI; drive codegen from a short script:
+
+```ts
+import { codegen } from "@nxara/olio-codegen";
+
+await codegen({
+  root: import.meta.dirname,
+  modules: "src/modules",
+  typeDefs: "**/typedefs/**/*.gql",
+  output: "src/generated.ts"
+});
+```
+
+Relative paths (`modules`, `output`, `schemaOutput`) resolve against `root`, which defaults to the working directory; pass `import.meta.dirname` so the script runs the same from any folder. `typeDefs` is the exception: it resolves inside each module. `codegenClient` takes `root` the same way, for `schema` (unless it's a URL), `documents` and `output`.
+
+Both reject with a message that names the file and position. Uncaught, the runtime prints it with a stack; to print just the message:
+
+```ts
+await codegen({ ... }).catch((error: Error) => {
+  console.error(error.message);
+  process.exitCode = 1;
+});
+```
+
+`modules` points to a directory whose **direct child directories** are modules. `typeDefs` is resolved relative to each module directory. `codegen` discovers modules, loads and parses their SDL, generates TypeScript, and writes the output (creating parent directories as needed).
+
+SDL files are read exactly as `loadTypeDefs` in `@nxara/olio-tools` reads them (both go through `@nxara/olio-core/files`): `.graphql` / `.gql`, or `.ts` / `.js` files whose default export is SDL or a `DocumentNode`, so an app moving from untyped to typed keeps its SDL where it is (`typeDefs: "**/typedefs/**/*.{gql,ts}"`). Codegen imports `.ts` files, so run it with something that executes TypeScript (bun, tsx, or Node 23.6+).
+
+### Directives
+
+Pass `directives` to apply `@nxara/olio-schema` transformations before generation:
+
+```ts
+import { codegen } from "@nxara/olio-codegen";
+import { copyDirective, implementsDirective } from "@nxara/olio-schema";
+
+await codegen({
+  modules: "src/modules",
+  typeDefs: "**/typedefs/**/*.gql",
+  output: "src/generated.ts",
+  schemaOutput: "src/schema.graphql",
+  directives: [implementsDirective(), copyDirective()]
+});
+```
+
+Their names land in `Application` as `"~directives"`, and olio's types then require the same `directives` in `olio()`.
+
+Set `schemaOutput` to write the final schema to a file, printed from the built schema: each type once with its extensions merged in, the directives applied, ready for schema registries, linters and diff tools. Omit it to generate only TypeScript. The schema is validated before anything is written, so an invalid one fails codegen rather than the server.
+
+## Client types
+
+`codegenClient({ schema, documents, output })` generates the types for [`@nxara/olio-client`](../client), the way graphql-codegen does: `schema` is an SDL file (typically the `schemaOutput` file above) or the running server's URL, introspected (`headers` for one that needs a token); `documents` are the client's `.graphql` operations. The operations are checked against the schema first, with `file:line:column` errors. `watch: true` reruns when an operation (including a new file) or the schema file changes; a server URL isn't watched.
+
+Subscriptions go over WebSocket unless marked `@sse` (`subscription Feed @sse { … }`); `@ws` says the default explicitly. The directive is the client's: codegen records it in the document and removes it from the query the server receives, and imports only the transports the operations use. `@ws` / `@sse` on a query or mutation, both on one subscription, or with arguments, is an error.
+
+Per operation it emits the result type, the variables type and a typed document (`LoginMutation`, `LoginMutationVariables`, `LoginDocument`), plus `operations` for `createClient`. Types are what a client sees on the wire: enums by name, scalars through `ClientScalars`.
+
+```ts
+import { codegenClient } from "@nxara/olio-codegen";
+
+await codegenClient({
+  root: import.meta.dirname,
+  schema: "../server/src/schema.gql", // or "http://localhost:4000/graphql"
+  documents: "src/operations/*.graphql",
+  output: "src/generated.ts"
+});
+```
+
+## Modules
+
+Every direct child directory of `modules` is one module. The directory name is the module ID, and there are no nested modules:
+
+```
+src/modules/
+├── auth/
+│   ├── typedefs/auth.gql
+│   └── query.ts
+├── user/
+│   └── typedefs/user.gql
+└── sales/
+    ├── typedefs/sales.gql
+    └── orders/
+        └── typedefs/orders.gql
+```
+
+This yields modules `auth`, `user`, and `sales`. `typeDefs` resolves inside each module (`src/modules/auth/**/typedefs/**/*.gql`, and so on), so each module's files belong exclusively to that module.
+
+A direct subfolder of a module in which `typeDefs` finds files of its own is a **feature** of that module: here `sales/orders`, with its own entry in `Application` (`"sales/orders"`). Features don't nest.
+
+So the glob decides what is a feature, because codegen runs it inside each subfolder. `**/typedefs/**/*.gql` finds nothing inside `users/typedefs/` itself (there's no `typedefs/` in it), so that folder stays the module's own SDL. `**/*.gql` does find its files, so it makes `typedefs` a feature of every module (`"users/typedefs"`), and `users` ends up with no fields. Keep SDL in `typedefs/` folders and use `**/typedefs/**/*.gql`. The ID is used as-is as the module's key in `Application` (quoted when it is not a valid identifier).
+
+## Application
+
+`Application` lists, per module, the types it declares fields on. Register it with `@nxara/olio`, which derives resolver signatures and middleware targets from it:
+
+```ts
+export type Application = {
+  users: {
+    Query: {
+      type: Query;
+      fields: "user" | "users";
+      args: {
+        user: { id: string };
+      };
+    };
+    User: { type: User; fields: "__isTypeOf" | "id" | "name" };
+  };
+  posts: {
+    Post: { type: Post; fields: "__isTypeOf" | "id" };
+    User: { type: User; fields: "posts" }; // from `extend type User { posts: [Post!]! }`
+  };
+};
+```
+
+- **`type`** is the parent type. Resolvers receive it as `root` and return `type[field]`.
+- **`fields`** are the fields the module owns. A module owns every field it declares, whether in a definition or an `extend`, on root and non-root types alike. The defining module also owns `__isTypeOf` (objects) or `__resolveType` (interfaces and unions, which also list their possible types as `resolveType`).
+- **`args`** appears only for fields that take arguments.
+- **Enums** appear as `{ type; fields: never; enum: "A" | "B" }`, listing the values the module declares (an `extend enum` belongs to the extending module).
+- **Scalars** appear as `{ type; fields: never; scalar: true }` under the module that defines them, which supplies the implementation.
+- **`bypass`** lists, per owned field, the keys its `@bypass` gives it (`bypass: { login: "audit" | "auth" }`). olio types middleware's `bypass` set from every key listed here.
+- **`root`** marks a root type with its operation (`root: "query"`), so olio finds the roots whatever they're named. A hand-written `Application` needs it too.
+
+Middleware targets aren't emitted: a module's targets are its owned fields, and the application's are the root fields.
+
+## Supported SDL
+
+- Object types, interfaces, unions, enums, inputs, and scalars
+- Lists and nullability (`String`, `[String!]!`, …), mapped exactly
+- Type extensions (`extend type User { … }`)
+- Root operation types, under the default names or your own (`schema { query: RootQuery }`)
+
+A schema type can't be named `Application`, `Maybe`, `ResolveEnum`, `ResolveScalar` or `Scalars`, since the generated file declares those names itself.
+
+## Custom scalars
+
+Every scalar goes through one exported table, `Scalars`, so fields read `Scalars["DateTime"]["output"]`. Built-in scalars default to their usual TypeScript types (`ID`/`String` → `string`, `Int`/`Float` → `number`, `Boolean` → `boolean`), and custom scalars default to `unknown`. Register or remap any of them by augmenting `CustomScalars`:
+
+```ts
+declare module "@nxara/olio-codegen" {
+  interface CustomScalars {
+    DateTime: Date;
+    JSON: { input: string; output: unknown };
+    ID: string | ObjectId; // built-ins can be remapped too
+  }
+}
+```
+
+Use the table directly when you need a scalar's type: `Scalars["DateTime"]["input"]`.
+
+Like every registration, it goes in a `.ts` file, or a `.d.ts` with an `import` or `export {}`.
+
+## Enums with internal values
+
+Enums are their GraphQL names by default (`"ADMIN" | "GUEST"`). To store something else, such as a number or a lowercase string, register the internal type by augmenting `CustomEnums`:
+
+```ts
+declare module "@nxara/olio-codegen" {
+  interface CustomEnums {
+    OrderStatus: "confirmed" | "cancelled";
+  }
+}
+```
+
+Every generated position then uses it: object fields, arguments, and inputs, since graphql converts enum inputs to internal values too. Supply the values at runtime through the owning module's `enums` option. Once `CustomEnums` registers an enum, olio's types require it there, with a value for every value the module declares:
+
+```ts
+export const sales = module.sales({
+  typeDefs,
+  resolvers,
+  enums: { OrderStatus: { CONFIRMED: "confirmed", CANCELLED: "cancelled" } }
+});
+```
+
+To keep a map in its own file, write it with the typed builder: `export const OrderStatus = resolvers.sales.OrderStatus({ ... })`, then `enums: { OrderStatus }`, or load such files with `enums: await loadEnums(...)` from `@nxara/olio-tools` (unchecked, like `loadResolvers`).
+
+## Output
+
+`codegen` writes a single TypeScript file to `output`. For:
+
+```graphql
+type Query {
+  user: User
+}
+type User {
+  id: ID!
+  name: String
+}
+```
+
+the emitted `User` type is:
+
+```ts
+export type User = {
+  __typename?: "User";
+  id: Scalars["ID"]["output"];
+  name: Maybe<Scalars["String"]["output"]>;
+};
+```
+
+The full output contains:
+
+- the `Scalars` table
+- enums as `const` objects plus union types
+- object types (root types included), interfaces, inputs, and unions. Nullable inputs without a default are optional keys.
+- the `Application` type
+
+The header marks the file as generated:
+
+```ts
+// Generated by @nxara/olio-codegen - do not edit.
+```
+
+## Relationship to @nxara/olio-schema
+
+`@nxara/olio-schema` composes a schema into ordinary GraphQL; `@nxara/olio-codegen` then turns that GraphQL into TypeScript:
+
+```
+SDL → @nxara/olio-schema → DocumentNode → @nxara/olio-codegen → TypeScript
+```
+
+Codegen has no knowledge of `@implements` or `@copy` - it accepts `SchemaDirective[]` and passes the parsed document through the transformation pipeline.

package/dist/codegen.d.ts

@@ -0,0 +1,10 @@
+import { type DocumentNode, type GraphQLSchema } from "graphql";
+import { type CodegenModule, type GenerateOptions } from "./types.js";
+export interface Compiled {
+    document: DocumentNode;
+    code: string;
+    schema: GraphQLSchema;
+}
+export declare function compile(modules: readonly CodegenModule[], options?: GenerateOptions): Compiled;
+export declare function generate(modules: readonly CodegenModule[], options?: GenerateOptions): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAWjB,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,QAAQ;IAEvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;CACvB;AA8CD,wBAAgB,OAAO,CACrB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAyCV;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAER"}

package/dist/codegen.js

@@ -0,0 +1,77 @@
+import { compose } from "@nxara/olio-schema";
+import { isEnumType, isInputObjectType, isInterfaceType, isObjectType, isScalarType, isUnionType, parse, Source } from "graphql";
+import { emitApplication } from "./emit-application.js";
+import { emitEnum, emitInput, emitInterface, emitObject, emitUnion, region } from "./emit-type.js";
+import { BUILTIN_SCALARS, HEADER, RESERVED_NAMES } from "./types.js";
+const IMPORTS = 'import type { ResolveEnum, ResolveScalar } from "@nxara/olio-codegen";';
+const UTILS = "type Maybe<T> = T | null;";
+function toDocument(typeDef, name) {
+    return typeof typeDef === "string"
+        ? parse(new Source(typeDef, name))
+        : typeDef;
+}
+const FUNCTION_PROPS = new Set([
+    "apply",
+    "arguments",
+    "bind",
+    "call",
+    "caller",
+    "length",
+    "name",
+    "prototype",
+    "toString"
+]);
+function assertFeatureNames(ownership) {
+    for (const id of ownership.keys()) {
+        const [module = "", feature] = id.split("/");
+        if (feature === undefined)
+            continue;
+        const clash = FUNCTION_PROPS.has(feature)
+            ? "a reserved name"
+            : ownership.get(module)?.has(feature)
+                ? `type "${feature}" in module "${module}"`
+                : undefined;
+        if (clash) {
+            throw new Error(`Feature folder "${id}" clashes with ${clash}; rename the folder`);
+        }
+    }
+}
+function assertSupported(schema) {
+    for (const name of Object.keys(schema.getTypeMap())) {
+        if (RESERVED_NAMES.has(name)) {
+            throw new Error(`Type name "${name}" is reserved by the generated file; rename it`);
+        }
+    }
+}
+export function compile(modules, options = {}) {
+    const { document, schema, ownership, roots, bypass } = compose(modules.map((m) => ({
+        id: m.id,
+        typeDefs: (Array.isArray(m.typeDefs) ? m.typeDefs : [m.typeDefs]).map((d) => toDocument(d, m.id))
+    })), options.directives);
+    assertSupported(schema);
+    assertFeatureNames(ownership);
+    const types = Object.values(schema.getTypeMap())
+        .filter((t) => !t.name.startsWith("__") && !BUILTIN_SCALARS.has(t.name))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const scalars = Object.values(schema.getTypeMap())
+        .filter(isScalarType)
+        .map((t) => `  ${t.name}: ResolveScalar<"${t.name}">;`)
+        .sort();
+    const parts = [
+        HEADER,
+        IMPORTS,
+        UTILS,
+        `/** Every scalar's TypeScript types. Remap one through \`CustomScalars\`. */\nexport type Scalars = {\n${scalars.join("\n")}\n};`,
+        region("Enums", types.filter(isEnumType).map(emitEnum)),
+        region("Types", types.filter(isObjectType).map(emitObject)),
+        region("Inputs", types.filter(isInputObjectType).map(emitInput)),
+        region("Unions", types.filter(isUnionType).map(emitUnion)),
+        region("Interfaces", types.filter(isInterfaceType).map(emitInterface)),
+        emitApplication(schema, ownership, roots, bypass, (options.directives ?? []).map((d) => d.name))
+    ];
+    return { document, code: `${parts.join("\n\n")}\n`, schema };
+}
+export function generate(modules, options = {}) {
+    return compile(modules, options).code;
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

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

package/dist/emit-application.d.ts

@@ -0,0 +1,4 @@
+import type { Bypass, Ownership, RootTypes } from "@nxara/olio-schema";
+import { type GraphQLSchema } from "graphql";
+export declare function emitApplication(schema: GraphQLSchema, ownership: Ownership, roots: RootTypes, bypass: Bypass, directives: readonly string[]): string;
+//# sourceMappingURL=emit-application.d.ts.map

package/dist/emit-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-application.d.ts","sourceRoot":"","sources":["../src/emit-application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAqEjB,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAqBR"}

package/dist/emit-application.js

@@ -0,0 +1,66 @@
+import { isAbstractType, isEnumType, isObjectType, isScalarType } from "graphql";
+import { inputMember } from "./type-map.js";
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const moduleKey = (id) => IDENTIFIER.test(id) ? id : JSON.stringify(id);
+const union = (names) => names.length ? names.map((n) => `"${n}"`).join(" | ") : "never";
+function emitEntry(schema, operations, bypass, name, owned) {
+    const type = schema.getType(name);
+    const fields = [...owned].sort();
+    if (isEnumType(type)) {
+        return `    ${name}: { type: ${name}; fields: never; enum: ${union(fields)} };`;
+    }
+    if (isScalarType(type)) {
+        return `    ${name}: { type: Scalars["${name}"]["output"]; fields: never; scalar: true };`;
+    }
+    const members = [`type: ${name}`, `fields: ${union(fields)}`];
+    const operation = operations.get(name);
+    if (operation)
+        members.push(`root: "${operation}"`);
+    if (isAbstractType(type)) {
+        members.push(`resolveType: ${union(schema
+            .getPossibleTypes(type)
+            .map((t) => t.name)
+            .sort())}`);
+    }
+    const objectFields = isObjectType(type) ? type.getFields() : {};
+    const args = fields.flatMap((f) => {
+        const field = objectFields[f];
+        return field?.args.length
+            ? [`        ${f}: { ${field.args.map(inputMember).join("; ")} };`]
+            : [];
+    });
+    const bypassed = fields.flatMap((f) => {
+        const keys = bypass.get(`${name}.${f}`);
+        return keys ? [`        ${f}: ${union([...keys].sort())};`] : [];
+    });
+    const sections = [
+        ...(args.length ? ["      args: {", ...args, "      };"] : []),
+        ...(bypassed.length ? ["      bypass: {", ...bypassed, "      };"] : [])
+    ];
+    if (sections.length === 0)
+        return `    ${name}: { ${members.join("; ")} };`;
+    return [
+        `    ${name}: {`,
+        ...members.map((m) => `      ${m};`),
+        ...sections,
+        "    };"
+    ].join("\n");
+}
+export function emitApplication(schema, ownership, roots, bypass, directives) {
+    const operations = new Map(Object.entries(roots).map(([operation, name]) => [name, operation]));
+    const modules = [...ownership]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([id, types]) => {
+        const entries = [...types]
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([name, owned]) => emitEntry(schema, operations, bypass, name, owned));
+        return entries.length
+            ? `  ${moduleKey(id)}: {\n${entries.join("\n")}\n  };`
+            : `  ${moduleKey(id)}: {};`;
+    });
+    const used = directives.length
+        ? [`  "~directives": ${directives.map((d) => `"${d}"`).join(" | ")};`]
+        : [];
+    return `export type Application = {\n${[...used, ...modules].join("\n")}\n};`;
+}
+//# sourceMappingURL=emit-application.js.map

package/dist/emit-application.js.map

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

package/dist/emit-client.d.ts

@@ -0,0 +1,3 @@
+import { type DocumentNode, type GraphQLSchema } from "graphql";
+export declare function emitClient(schema: GraphQLSchema, documents: readonly DocumentNode[]): string;
+//# sourceMappingURL=emit-client.d.ts.map

package/dist/emit-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-client.d.ts","sourceRoot":"","sources":["../src/emit-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,KAAK,YAAY,EAUjB,KAAK,aAAa,EAGnB,MAAM,SAAS,CAAC;AAiUjB,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,MAAM,CAmGR"}