@kavo/graphql 0.4.0

package/dist/discovery.d.ts

@@ -0,0 +1,27 @@
+import type { ClassRef, EntityId } from "@kavo/core";
+import type { GraphQLSchema } from "graphql";
+import type { BoundCrudService } from "./schema.js";
+/** The minimum a host framework needs to hand this package about one `@Crud` entity. */
+export interface CrudEntityRef {
+    readonly entity: ClassRef;
+}
+/**
+ * The host-agnostic half of "discover every entity that registered
+ * GraphQL types and put them all on one schema." Two things stay
+ * deliberately outside this package, supplied by the caller instead:
+ *
+ * - **How to enumerate `@Crud` entities** — `@kavo/nest`'s `getCrudEntities()`,
+ *   a plain array an Express/Fastify/Next.js app builds by hand, or any
+ *   other host's own registry.
+ * - **How to resolve a bound service for one entity** — `@kavo/nest`'s
+ *   `ModuleRef` + `getCrudServiceToken`, a plain `Map`, or whatever DI
+ *   container that host uses.
+ *
+ * This function only ever touches `@kavo/core` shapes and this package's
+ * own type registry — never a host framework — so the same call works
+ * from `@kavo/nest`'s `BaseCrudGraphQLController` today and from a future
+ * `@kavo/express`/`@kavo/fastify`/`@kavo/nextjs` binding without either
+ * package importing the other (ADR-0016).
+ */
+export declare function resolveCrudGraphQLSchema(entities: readonly CrudEntityRef[], resolveService: (entity: ClassRef) => BoundCrudService<object, EntityId, unknown, unknown, unknown, unknown, unknown>): GraphQLSchema;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AAIxE,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GACpH,aAAa,CAYf"}

package/dist/discovery.js

@@ -0,0 +1,32 @@
+import { mergeCrudGraphQLSchemas } from "./schema.js";
+import { getCrudGraphQLTypes } from "./registry.js";
+/**
+ * The host-agnostic half of "discover every entity that registered
+ * GraphQL types and put them all on one schema." Two things stay
+ * deliberately outside this package, supplied by the caller instead:
+ *
+ * - **How to enumerate `@Crud` entities** — `@kavo/nest`'s `getCrudEntities()`,
+ *   a plain array an Express/Fastify/Next.js app builds by hand, or any
+ *   other host's own registry.
+ * - **How to resolve a bound service for one entity** — `@kavo/nest`'s
+ *   `ModuleRef` + `getCrudServiceToken`, a plain `Map`, or whatever DI
+ *   container that host uses.
+ *
+ * This function only ever touches `@kavo/core` shapes and this package's
+ * own type registry — never a host framework — so the same call works
+ * from `@kavo/nest`'s `BaseCrudGraphQLController` today and from a future
+ * `@kavo/express`/`@kavo/fastify`/`@kavo/nextjs` binding without either
+ * package importing the other (ADR-0016).
+ */
+export function resolveCrudGraphQLSchema(entities, resolveService) {
+    const bindings = [];
+    for (const { entity } of entities) {
+        const types = getCrudGraphQLTypes(entity);
+        if (types === undefined) {
+            continue;
+        }
+        bindings.push({ name: entity.name, service: resolveService(entity), ...types });
+    }
+    return mergeCrudGraphQLSchemas(bindings);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOpD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAkC,EAClC,cAAqH;IAErH,MAAM,QAAQ,GAAwF,EAAE,CAAC;IAEzG,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createCrudGraphQLSchema, mergeCrudGraphQLSchemas, type CrudGraphQLOptions, type BoundCrudService, } from "./schema.js";
+export { registerCrudGraphQLTypes, getCrudGraphQLTypes, type CrudGraphQLTypes } from "./registry.js";
+export { resolveCrudGraphQLSchema, type CrudEntityRef } from "./discovery.js";
+export { GraphQLJSON } from "./json-scalar.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,wBAAwB,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createCrudGraphQLSchema, mergeCrudGraphQLSchemas, } from "./schema.js";
+export { registerCrudGraphQLTypes, getCrudGraphQLTypes } from "./registry.js";
+export { resolveCrudGraphQLSchema } from "./discovery.js";
+export { GraphQLJSON } from "./json-scalar.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAyB,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,wBAAwB,EAAsB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/json-scalar.d.ts

@@ -0,0 +1,12 @@
+import { GraphQLScalarType } from "graphql";
+/**
+ * Arbitrary JSON, used for `filter` args until schema-derived
+ * `<Entity>FilterInput` types exist (tracked separately — that's the
+ * "derive types from entity metadata" work this package's proof-of-concept
+ * status has always deferred). The value that reaches a resolver is the
+ * raw filter AST (`FilterExpression` from `@kavo/core`) — the same shape
+ * any other programmatic caller of `QueryContext.filter` already hands
+ * core directly; there is no wire-string grammar to parse here.
+ */
+export declare const GraphQLJSON: GraphQLScalarType<unknown, unknown>;
+//# sourceMappingURL=json-scalar.d.ts.map

package/dist/json-scalar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-scalar.d.ts","sourceRoot":"","sources":["../src/json-scalar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA6B,MAAM,SAAS,CAAC;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,qCAMtB,CAAC"}

package/dist/json-scalar.js

@@ -0,0 +1,18 @@
+import { GraphQLScalarType, Kind, valueFromASTUntyped } from "graphql";
+/**
+ * Arbitrary JSON, used for `filter` args until schema-derived
+ * `<Entity>FilterInput` types exist (tracked separately — that's the
+ * "derive types from entity metadata" work this package's proof-of-concept
+ * status has always deferred). The value that reaches a resolver is the
+ * raw filter AST (`FilterExpression` from `@kavo/core`) — the same shape
+ * any other programmatic caller of `QueryContext.filter` already hands
+ * core directly; there is no wire-string grammar to parse here.
+ */
+export const GraphQLJSON = new GraphQLScalarType({
+    name: "JSON",
+    description: "Arbitrary JSON value — used here for a raw Kavo filter expression.",
+    serialize: (value) => value,
+    parseValue: (value) => value,
+    parseLiteral: (ast) => (ast.kind === Kind.NULL ? null : valueFromASTUntyped(ast)),
+});
+//# sourceMappingURL=json-scalar.js.map

package/dist/json-scalar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-scalar.js","sourceRoot":"","sources":["../src/json-scalar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC;IAC/C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,oEAAoE;IACjF,SAAS,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK;IACpC,UAAU,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK;IACrC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;CAClF,CAAC,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,38 @@
+import type { ClassRef } from "@kavo/core";
+import type { GraphQLInputObjectType, GraphQLObjectType } from "graphql";
+/**
+ * GraphQL object/input types (and which mutations to expose) for one
+ * entity — the hand-written part `registerCrudGraphQLTypes` attaches to a
+ * class. Each mutation flag/input mirrors `CrudGraphQLOptions` in
+ * `schema.ts` one for one — omit any of them to leave that mutation off
+ * the schema for this entity, same opt-in shape `@Crud`'s own `operations`
+ * config uses on the REST side.
+ */
+export interface CrudGraphQLTypes {
+    readonly itemType: GraphQLObjectType;
+    /** Omit to leave the `create<Name>` mutation off the schema for this entity. */
+    readonly createInputType?: GraphQLInputObjectType;
+    /** Omit to leave the `update<Name>` mutation off the schema for this entity. */
+    readonly updateInputType?: GraphQLInputObjectType;
+    /** Omit to leave the `patch<Name>` mutation off the schema for this entity. */
+    readonly patchInputType?: GraphQLInputObjectType;
+    /** Adds `delete<Name>(id): Boolean`. */
+    readonly deleteOne?: boolean;
+    /** Adds `restore<Name>(id): <Name>` — meaningful only for a soft-deletable entity. */
+    readonly restoreOne?: boolean;
+    /** Adds `purge<Name>(id): Boolean` — meaningful only for a soft-deletable entity. */
+    readonly purgeOne?: boolean;
+}
+/**
+ * Attaches GraphQL types to an entity once, next to its DTOs — the
+ * counterpart of `@kavo/nest`'s `getCrudEntities()`: a consumer can walk
+ * every `@Crud` entity and look up its GraphQL types here, wiring a merged
+ * schema with no per-entity list of its own (see `resolveCrudGraphQLSchema`
+ * in `discovery.ts`, which does exactly that). An entity with no
+ * registration here simply has no GraphQL surface — opt-in, not implied by
+ * `@Crud` alone. Process-wide, same scope as `@kavo/nest`'s own registry.
+ */
+export declare function registerCrudGraphQLTypes(entity: ClassRef, types: CrudGraphQLTypes): void;
+/** The types `registerCrudGraphQLTypes` attached to `entity`, or `undefined` if it never registered any. */
+export declare function getCrudGraphQLTypes(entity: ClassRef): CrudGraphQLTypes | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAClD,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACjD,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAExF;AAED,4GAA4G;AAC5G,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF"}

package/dist/registry.js

@@ -0,0 +1,18 @@
+const typeRegistry = new Map();
+/**
+ * Attaches GraphQL types to an entity once, next to its DTOs — the
+ * counterpart of `@kavo/nest`'s `getCrudEntities()`: a consumer can walk
+ * every `@Crud` entity and look up its GraphQL types here, wiring a merged
+ * schema with no per-entity list of its own (see `resolveCrudGraphQLSchema`
+ * in `discovery.ts`, which does exactly that). An entity with no
+ * registration here simply has no GraphQL surface — opt-in, not implied by
+ * `@Crud` alone. Process-wide, same scope as `@kavo/nest`'s own registry.
+ */
+export function registerCrudGraphQLTypes(entity, types) {
+    typeRegistry.set(entity, types);
+}
+/** The types `registerCrudGraphQLTypes` attached to `entity`, or `undefined` if it never registered any. */
+export function getCrudGraphQLTypes(entity) {
+    return typeRegistry.get(entity);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AA2BA,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAgB,EAAE,KAAuB;IAChF,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAClD,OAAO,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,78 @@
+import { GraphQLObjectType, GraphQLSchema, type GraphQLFieldConfig, type GraphQLInputObjectType } from "graphql";
+import type { DefaultCrudService, EntityId } from "@kavo/core";
+/**
+ * What a query/mutation resolver in this binding actually calls — the
+ * transport-agnostic programmatic surface `createCrud` returns. Kept as a
+ * structural type (not `DefaultCrudService` itself) so a caller only has to
+ * satisfy the handful of methods a schema actually wires up, the same way
+ * `@kavo/nest`'s standard-operation routes bind to it. Exported (not just
+ * internal) so `discovery.ts`'s host-agnostic resolver callback can name it.
+ *
+ * Every standard operation is picked unconditionally — whether a given
+ * field actually reaches the schema is decided per entity by which
+ * `*InputType`/`include*` options `crudFields` receives, mirroring how
+ * `@Crud`'s own `operations` config opts entities in or out on the REST
+ * side. Calling `restoreOne`/`purgeOne` against an entity that never
+ * declared soft delete still raises `OperationDisabledException` from the
+ * engine itself — this binding does not re-check that, same as REST.
+ */
+export type BoundCrudService<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto> = Pick<DefaultCrudService<Entity, Id, CreateDto, UpdateDto, PatchDto, unknown, ItemDto, ListDto>, "findOne" | "findMany" | "createOne" | "updateOne" | "patchOne" | "deleteOne" | "restoreOne" | "purgeOne">;
+/**
+ * One entity's GraphQL binding: a query root (`<name>`/`<name>s`) plus
+ * whichever mutations its options ask for — every resolver a direct call
+ * into the same engine REST routes use, no parallel request pipeline.
+ * Each mutation is opt-in per entity: omit the corresponding option and
+ * that field never reaches the schema, the same "declare what you want"
+ * shape `createInputType` already had.
+ */
+export interface CrudGraphQLOptions<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto> {
+    /** Singular, capitalized entity name — becomes `Query.<lowerName>` / `<Name>List` / `createName` / etc. */
+    readonly name: string;
+    readonly service: BoundCrudService<Entity, Id, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto>;
+    readonly itemType: GraphQLObjectType;
+    /** Omit to leave the `create<Name>` mutation off the schema. */
+    readonly createInputType?: GraphQLInputObjectType;
+    /** Omit to leave the `update<Name>` mutation off the schema. */
+    readonly updateInputType?: GraphQLInputObjectType;
+    /** Omit to leave the `patch<Name>` mutation off the schema. */
+    readonly patchInputType?: GraphQLInputObjectType;
+    /** Adds `delete<Name>(id): Boolean`. */
+    readonly deleteOne?: boolean;
+    /** Adds `restore<Name>(id): <Name>` — meaningful only for a soft-deletable entity. */
+    readonly restoreOne?: boolean;
+    /** Adds `purge<Name>(id): Boolean` — meaningful only for a soft-deletable entity. */
+    readonly purgeOne?: boolean;
+}
+/**
+ * Field maps for one entity's binding — the unit `createCrudGraphQLSchema`
+ * wraps and `mergeCrudGraphQLSchemas`/`resolveCrudGraphQLSchema` combine.
+ * Not exported from the barrel: an internal building block, same status as
+ * `lowerFirst`.
+ */
+export declare function crudFields<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto>(options: CrudGraphQLOptions<Entity, Id, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto>): {
+    query: Record<string, GraphQLFieldConfig<unknown, unknown>>;
+    mutation: Record<string, GraphQLFieldConfig<unknown, unknown>>;
+};
+/**
+ * Builds a one-entity `GraphQLSchema` over an existing `createCrud`
+ * service. Schema derivation from entity metadata, relations, and
+ * filtering is still out of scope (ADR-worthy work, tracked separately):
+ * the caller supplies the GraphQL object/input types by hand, and every
+ * resolver delegates straight to the bound service, which itself is sugar
+ * over `engine.execute` — the identical pipeline REST runs.
+ *
+ * For an app with more than one entity, prefer `mergeCrudGraphQLSchemas` (or
+ * `resolveCrudGraphQLSchema` for a framework-driven registry) — they put
+ * every entity's fields on one `Query`/`Mutation` root instead of one
+ * schema (and one mounted endpoint) per entity.
+ */
+export declare function createCrudGraphQLSchema<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto>(options: CrudGraphQLOptions<Entity, Id, CreateDto, UpdateDto, PatchDto, ItemDto, ListDto>): GraphQLSchema;
+/**
+ * Combines several entities' bindings onto one `Query`/`Mutation` root —
+ * the shape an app actually wants: one `/graphql` endpoint for every
+ * `@Crud` entity, not one per entity. Each entry is the same options shape
+ * `createCrudGraphQLSchema` takes; field names are namespaced by each
+ * entity's own `name`, so entries never collide with each other.
+ */
+export declare function mergeCrudGraphQLSchemas(bindings: readonly CrudGraphQLOptions<object, EntityId, unknown, unknown, unknown, unknown, unknown>[]): GraphQLSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,iBAAiB,EACjB,aAAa,EAEb,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmB/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,gBAAgB,CAC1B,MAAM,SAAS,MAAM,EACrB,EAAE,SAAS,QAAQ,EACnB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,IACL,IAAI,CACN,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EACzF,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAC1G,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CACjC,MAAM,SAAS,MAAM,EACrB,EAAE,SAAS,QAAQ,EACnB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO;IAEP,2GAA2G;IAC3G,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjG,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,gEAAgE;IAChE,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAClD,gEAAgE;IAChE,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAClD,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACjD,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,SAAS,MAAM,EACrB,EAAE,SAAS,QAAQ,EACnB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EAEP,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GACxF;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CAChE,CAoGA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,SAAS,MAAM,EACrB,EAAE,SAAS,QAAQ,EACnB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,aAAa,CAO1G;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,GACrG,aAAa,CA8Bf"}

package/dist/schema.js

@@ -0,0 +1,162 @@
+import { GraphQLBoolean, GraphQLInt, GraphQLList, GraphQLNonNull, GraphQLObjectType, GraphQLSchema, GraphQLString, } from "graphql";
+import { ConfigurationException } from "@kavo/core";
+import { GraphQLJSON } from "./json-scalar.js";
+/**
+ * `sort: ["-createdAt", "name"]` → `[{ field: "createdAt", direction: "desc" }, { field: "name", direction: "asc" }]`
+ * — the same leading-`-` convention REST's `?sort=` wire param uses, translated here instead of through core's
+ * wire-string parser (this binding calls the programmatic `QueryContext` surface, which takes `Sort[]` objects
+ * directly, never wire strings).
+ */
+function parseSortArg(tokens) {
+    if (tokens === undefined)
+        return [];
+    return tokens.map((token) => token.startsWith("-")
+        ? { field: token.slice(1), direction: "desc" }
+        : { field: token, direction: "asc" });
+}
+function lowerFirst(value) {
+    return value.charAt(0).toLowerCase() + value.slice(1);
+}
+/**
+ * Field maps for one entity's binding — the unit `createCrudGraphQLSchema`
+ * wraps and `mergeCrudGraphQLSchemas`/`resolveCrudGraphQLSchema` combine.
+ * Not exported from the barrel: an internal building block, same status as
+ * `lowerFirst`.
+ */
+export function crudFields(options) {
+    const { name, service, itemType, createInputType, updateInputType, patchInputType, deleteOne, restoreOne, purgeOne } = options;
+    const fieldName = lowerFirst(name);
+    const idArgs = { id: { type: new GraphQLNonNull(GraphQLInt) } };
+    const listType = new GraphQLObjectType({
+        name: `${name}List`,
+        fields: {
+            items: { type: new GraphQLNonNull(new GraphQLList(new GraphQLNonNull(itemType))) },
+            total: { type: GraphQLInt },
+            limit: { type: new GraphQLNonNull(GraphQLInt) },
+            offset: { type: new GraphQLNonNull(GraphQLInt) },
+        },
+    });
+    const query = {
+        [fieldName]: {
+            type: itemType,
+            args: idArgs,
+            resolve: (_root, args) => service.findOne(args.id),
+        },
+        [`${fieldName}s`]: {
+            type: new GraphQLNonNull(listType),
+            args: {
+                limit: { type: GraphQLInt },
+                offset: { type: GraphQLInt },
+                sort: { type: new GraphQLList(new GraphQLNonNull(GraphQLString)) },
+                filter: { type: GraphQLJSON },
+            },
+            resolve: (_root, args) => service.findMany({
+                limit: args.limit,
+                offset: args.offset,
+                sort: parseSortArg(args.sort),
+                filter: args.filter ?? null,
+            }),
+        },
+    };
+    const mutation = {};
+    if (createInputType !== undefined) {
+        mutation[`create${name}`] = {
+            type: new GraphQLNonNull(itemType),
+            args: { input: { type: new GraphQLNonNull(createInputType) } },
+            resolve: (_root, args) => service.createOne(args.input),
+        };
+    }
+    if (updateInputType !== undefined) {
+        mutation[`update${name}`] = {
+            type: new GraphQLNonNull(itemType),
+            args: { ...idArgs, input: { type: new GraphQLNonNull(updateInputType) } },
+            resolve: (_root, args) => service.updateOne(args.id, args.input),
+        };
+    }
+    if (patchInputType !== undefined) {
+        mutation[`patch${name}`] = {
+            type: new GraphQLNonNull(itemType),
+            args: { ...idArgs, input: { type: new GraphQLNonNull(patchInputType) } },
+            resolve: (_root, args) => service.patchOne(args.id, args.input),
+        };
+    }
+    if (deleteOne === true) {
+        mutation[`delete${name}`] = {
+            type: new GraphQLNonNull(GraphQLBoolean),
+            args: idArgs,
+            resolve: async (_root, args) => {
+                await service.deleteOne(args.id);
+                return true;
+            },
+        };
+    }
+    if (restoreOne === true) {
+        mutation[`restore${name}`] = {
+            type: new GraphQLNonNull(itemType),
+            args: idArgs,
+            resolve: (_root, args) => service.restoreOne(args.id),
+        };
+    }
+    if (purgeOne === true) {
+        mutation[`purge${name}`] = {
+            type: new GraphQLNonNull(GraphQLBoolean),
+            args: idArgs,
+            resolve: async (_root, args) => {
+                await service.purgeOne(args.id);
+                return true;
+            },
+        };
+    }
+    return { query, mutation };
+}
+/**
+ * Builds a one-entity `GraphQLSchema` over an existing `createCrud`
+ * service. Schema derivation from entity metadata, relations, and
+ * filtering is still out of scope (ADR-worthy work, tracked separately):
+ * the caller supplies the GraphQL object/input types by hand, and every
+ * resolver delegates straight to the bound service, which itself is sugar
+ * over `engine.execute` — the identical pipeline REST runs.
+ *
+ * For an app with more than one entity, prefer `mergeCrudGraphQLSchemas` (or
+ * `resolveCrudGraphQLSchema` for a framework-driven registry) — they put
+ * every entity's fields on one `Query`/`Mutation` root instead of one
+ * schema (and one mounted endpoint) per entity.
+ */
+export function createCrudGraphQLSchema(options) {
+    const { query, mutation } = crudFields(options);
+    return new GraphQLSchema({
+        query: new GraphQLObjectType({ name: "Query", fields: query }),
+        mutation: Object.keys(mutation).length > 0 ? new GraphQLObjectType({ name: "Mutation", fields: mutation }) : undefined,
+    });
+}
+/**
+ * Combines several entities' bindings onto one `Query`/`Mutation` root —
+ * the shape an app actually wants: one `/graphql` endpoint for every
+ * `@Crud` entity, not one per entity. Each entry is the same options shape
+ * `createCrudGraphQLSchema` takes; field names are namespaced by each
+ * entity's own `name`, so entries never collide with each other.
+ */
+export function mergeCrudGraphQLSchemas(bindings) {
+    const query = {};
+    const mutation = {};
+    for (const binding of bindings) {
+        const fields = crudFields(binding);
+        Object.assign(query, fields.query);
+        Object.assign(mutation, fields.mutation);
+    }
+    if (Object.keys(query).length === 0) {
+        // An empty `Query` type is invalid GraphQL (`Type Query must define one
+        // or more fields.`) — graphql-js would only report that cryptically, on
+        // the first request, deep inside `graphql()`'s own schema validation.
+        // Failing fast here, at schema-build time, with a message that names the
+        // actual fix, is what `resolveCrudGraphQLSchema` (zero entities
+        // discovered) relies on to fail at boot instead of at request time.
+        throw new ConfigurationException("GraphQLSchema", "bindings", "no entity registered any GraphQL types — call registerCrudGraphQLTypes(Entity, {...}) " +
+            "for at least one @Crud entity before enabling a GraphQL endpoint");
+    }
+    return new GraphQLSchema({
+        query: new GraphQLObjectType({ name: "Query", fields: query }),
+        mutation: Object.keys(mutation).length > 0 ? new GraphQLObjectType({ name: "Mutation", fields: mutation }) : undefined,
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kavo/graphql",
+  "version": "0.4.0",
+  "description": "Kavo GraphQL binding — builds a GraphQL schema over a createCrud service, delegating every resolver to the same engine REST uses.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kavo-labs/kavo.git",
+    "directory": "packages/protocols/graphql"
+  },
+  "homepage": "https://github.com/kavo-labs/kavo/tree/main/packages/protocols/graphql#readme",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kavo/core": "workspace:^"
+  },
+  "peerDependencies": {
+    "graphql": "^17.0.0"
+  },
+  "devDependencies": {
+    "graphql": "^17.0.0"
+  }
+}