@contractspec/lib.graphql-federation 1.44.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+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

@@ -0,0 +1,69 @@
+# @contractspec/lib.graphql-federation
+
+Website: https://contractspec.io/
+
+
+GraphQL Federation utilities for Pothos.
+
+## Purpose
+
+To enable Apollo Federation support for Pothos schemas. This package configures the `@pothos/plugin-federation` and provides helpers for defining entities and resolving references.
+
+## Installation
+
+```bash
+npm install @contractspec/lib.graphql-federation
+# or
+bun add @contractspec/lib.graphql-federation
+```
+
+## Key Concepts
+
+- **Federation**: Apollo Federation V2 support.
+- **Entities**: defining `key` fields and `resolveReference` methods.
+
+## Usage
+
+```ts
+import { builder } from '@contractspec/lib.graphql-core';
+import '@contractspec/lib.graphql-federation'; // Side-effect import to register plugin if needed, or use factory
+
+builder.asEntity(User, {
+  key: builder.selection<{ id: string }>('id'),
+  resolveReference: (ref) => getUser(ref.id),
+});
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { SchemaTypes } from "@pothos/core";
+import "@pothos/plugin-federation";
+import { GraphQLSchema } from "graphql";
+
+//#region src/index.d.ts
+declare function toSubgraphSDL(schema: GraphQLSchema): string;
+declare function withEntityObject<T extends SchemaTypes>(builder: PothosSchemaTypes.SchemaBuilder<T>, name: string, keyFields: string[], fields: (t: any) => Record<string, any>, resolveReference: (ref: any, ctx: any) => Promise<any> | any): any;
+//#endregion
+export { toSubgraphSDL, withEntityObject };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;iBAKgB,aAAA,SAAsB;iBAItB,2BAA2B,sBAChC,iBAAA,CAAkB,cAAc,2DAGrB,+DACsB"}

package/dist/index.js

@@ -0,0 +1,21 @@
+import "@pothos/core";
+import "@pothos/plugin-federation";
+import { printSubgraphSchema } from "@apollo/subgraph";
+
+//#region src/index.ts
+function toSubgraphSDL(schema) {
+	return printSubgraphSchema(schema);
+}
+function withEntityObject(builder, name, keyFields, fields, resolveReference) {
+	const ref = builder.objectRef(name);
+	ref.implement({ fields });
+	builder.entity(name, {
+		key: keyFields.join(" "),
+		resolveReference
+	});
+	return ref;
+}
+
+//#endregion
+export { toSubgraphSDL, withEntityObject };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type SchemaTypes } from '@pothos/core';\nimport '@pothos/plugin-federation';\nimport { printSubgraphSchema } from '@apollo/subgraph';\nimport type { GraphQLSchema } from 'graphql';\n\nexport function toSubgraphSDL(schema: GraphQLSchema) {\n  return printSubgraphSchema(schema);\n}\n\nexport function withEntityObject<T extends SchemaTypes>(\n  builder: PothosSchemaTypes.SchemaBuilder<T>,\n  name: string,\n  keyFields: string[],\n  fields: (t: any) => Record<string, any>,\n  resolveReference: (ref: any, ctx: any) => Promise<any> | any\n) {\n  const ref = (builder as any).objectRef(name);\n  ref.implement({\n    fields,\n  });\n  (builder as any).entity(name, {\n    key: keyFields.join(' '),\n    resolveReference,\n  });\n  return ref;\n}\n"],"mappings":";;;;;AAKA,SAAgB,cAAc,QAAuB;AACnD,QAAO,oBAAoB,OAAO;;AAGpC,SAAgB,iBACd,SACA,MACA,WACA,QACA,kBACA;CACA,MAAM,MAAO,QAAgB,UAAU,KAAK;AAC5C,KAAI,UAAU,EACZ,QACD,CAAC;AACF,CAAC,QAAgB,OAAO,MAAM;EAC5B,KAAK,UAAU,KAAK,IAAI;EACxB;EACD,CAAC;AACF,QAAO"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@contractspec/lib.graphql-federation",
+  "version": "1.44.0",
+  "description": "Pothos federation helpers and subgraph schema export utilities",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "tsdown",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@pothos/core": "^4.9.1",
+    "@pothos/plugin-federation": "^4.0.0",
+    "@pothos/plugin-directives": "^4.2.3",
+    "graphql": "^16.8.1",
+    "@apollo/subgraph": "^2.12.2"
+  },
+  "peerDependencies": {
+    "graphql": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.typescript": "1.44.0",
+    "@contractspec/tool.tsdown": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "type": "module",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/graphql-federation"
+  },
+  "homepage": "https://contractspec.io"
+}