@executor-js/plugin-graphql 0.0.1 → 0.0.2

package/README.md

@@ -1,51 +1,62 @@
-# @executor/plugin-graphql
+# @executor-js/plugin-graphql
 
 Introspect a GraphQL endpoint and expose its queries and mutations as invokable tools on an executor.
 
 ## Install
 
 ```sh
-bun add @executor/sdk @executor/plugin-graphql
+bun add @executor-js/sdk @executor-js/plugin-graphql
 # or
-npm install @executor/sdk @executor/plugin-graphql
+npm install @executor-js/sdk @executor-js/plugin-graphql
 ```
 
 ## Usage
 
 ```ts
-import { createExecutor } from "@executor/sdk";
-import { graphqlPlugin } from "@executor/plugin-graphql";
+import { createExecutor } from "@executor-js/sdk";
+import { graphqlPlugin } from "@executor-js/plugin-graphql";
 
 const executor = await createExecutor({
-  scope: { name: "my-app" },
+  onElicitation: "accept-all",
   plugins: [graphqlPlugin()] as const,
 });
 
 // Public endpoint — no auth
 await executor.graphql.addSource({
+  scope: executor.scopes[0]!.id,
   endpoint: "https://graphql.anilist.co",
   namespace: "anilist",
 });
 
 const tools = await executor.tools.list();
-const result = await executor.tools.invoke(
-  "anilist.Media",
-  { search: "Frieren" },
-  { onElicitation: "accept-all" },
-);
+const result = await executor.tools.invoke("anilist.Media", {
+  search: "Frieren",
+});
 ```
 
 ## Secret-backed auth
 
 ```ts
+import { createExecutor } from "@executor-js/sdk";
+import { graphqlPlugin } from "@executor-js/plugin-graphql";
+import { fileSecretsPlugin } from "@executor-js/plugin-file-secrets";
+
+const executor = await createExecutor({
+  onElicitation: "accept-all",
+  plugins: [fileSecretsPlugin(), graphqlPlugin()] as const,
+});
+
+const scope = executor.scopes[0]!.id;
+
 await executor.secrets.set({
   id: "github-token",
   name: "GitHub Token",
   value: "ghp_...",
-  purpose: "authentication",
+  scope,
 });
 
 await executor.graphql.addSource({
+  scope,
   endpoint: "https://api.github.com/graphql",
   namespace: "github",
   headers: {
@@ -56,10 +67,10 @@ await executor.graphql.addSource({
 
 ## Using with Effect
 
-If you're building on `@executor/sdk` (the raw Effect entry), import this plugin from its `/core` subpath instead:
+If you're building on `@executor-js/sdk/core` (the raw Effect entry), import this plugin from its `/core` subpath instead — it returns the Effect-shaped plugin with `Effect.Effect<...>`-returning methods rather than promisified wrappers:
 
 ```ts
-import { graphqlPlugin } from "@executor/plugin-graphql";
+import { graphqlPlugin } from "@executor-js/plugin-graphql/core";
 ```
 
 ## Status

package/dist/api/group.d.ts

@@ -1,34 +1,139 @@
-import { HttpApiEndpoint, HttpApiGroup } from "@effect/platform";
+import { HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi";
+import { Schema } from "effect";
+import { InternalError } from "@executor-js/api";
 import { GraphqlIntrospectionError, GraphqlExtractionError } from "../sdk/errors";
-import { StoredSourceSchema } from "../sdk/stored-source";
-declare const GraphqlGroup_base: HttpApiGroup.HttpApiGroup<"graphql", HttpApiEndpoint.HttpApiEndpoint<"addSource", "POST", {
-    readonly scopeId: string & import("effect/Brand").Brand<"ScopeId">;
-}, never, {
-    readonly name?: string | undefined;
-    readonly endpoint: string;
-    readonly namespace?: string | undefined;
-    readonly headers?: {
-        readonly [x: string]: unknown;
-    } | undefined;
-    readonly introspectionJson?: string | undefined;
-}, never, {
-    readonly namespace: string;
-    readonly toolCount: number;
-}, GraphqlIntrospectionError | GraphqlExtractionError, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getSource", "GET", {
-    readonly scopeId: string & import("effect/Brand").Brand<"ScopeId">;
-    readonly namespace: string;
-}, never, never, never, StoredSourceSchema | null, never, never, never> | HttpApiEndpoint.HttpApiEndpoint<"updateSource", "PATCH", {
-    readonly scopeId: string & import("effect/Brand").Brand<"ScopeId">;
-    readonly namespace: string;
-}, never, {
-    readonly name?: string | undefined;
-    readonly endpoint?: string | undefined;
-    readonly headers?: {
-        readonly [x: string]: unknown;
-    } | undefined;
-}, never, {
-    readonly updated: boolean;
-}, never, never, never>, never, never, false>;
-export declare class GraphqlGroup extends GraphqlGroup_base {
-}
-export {};
+export declare const StoredSourceSchema: Schema.Struct<{
+    readonly namespace: Schema.String;
+    readonly name: Schema.String;
+    readonly endpoint: Schema.String;
+    readonly headers: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly secretId: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>]>>;
+    readonly queryParams: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly secretId: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>]>>;
+    readonly auth: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"none">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly connectionId: Schema.String;
+    }>]>;
+}>;
+export declare const GraphqlGroup: HttpApiGroup.HttpApiGroup<"graphql", HttpApiEndpoint.HttpApiEndpoint<"addSource", "POST", "/scopes/:scopeId/graphql/sources", HttpApiEndpoint.StringTree<Schema.Struct<{
+    scopeId: Schema.brand<Schema.String, "ScopeId">;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly endpoint: Schema.String;
+    readonly name: Schema.optional<Schema.String>;
+    readonly introspectionJson: Schema.optional<Schema.String>;
+    readonly namespace: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly auth: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"none">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly connectionId: Schema.String;
+    }>]>>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly toolCount: Schema.Number;
+    readonly namespace: Schema.String;
+}>>, HttpApiEndpoint.Json<typeof InternalError | Schema.decodeTo<Schema.declareConstructor<GraphqlIntrospectionError, {
+    readonly message: string;
+    readonly _tag: "GraphqlIntrospectionError";
+}, readonly [Schema.TaggedStruct<"GraphqlIntrospectionError", {
+    readonly message: Schema.String;
+}>], {
+    readonly message: string;
+    readonly _tag: "GraphqlIntrospectionError";
+}>, Schema.TaggedStruct<"GraphqlIntrospectionError", {
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<GraphqlExtractionError, {
+    readonly message: string;
+    readonly _tag: "GraphqlExtractionError";
+}, readonly [Schema.TaggedStruct<"GraphqlExtractionError", {
+    readonly message: Schema.String;
+}>], {
+    readonly message: string;
+    readonly _tag: "GraphqlExtractionError";
+}>, Schema.TaggedStruct<"GraphqlExtractionError", {
+    readonly message: Schema.String;
+}>, never, never>>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"getSource", "GET", "/scopes/:scopeId/graphql/sources/:namespace", HttpApiEndpoint.StringTree<Schema.Struct<{
+    scopeId: Schema.brand<Schema.String, "ScopeId">;
+    namespace: Schema.String;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.NullOr<Schema.Struct<{
+    readonly namespace: Schema.String;
+    readonly name: Schema.String;
+    readonly endpoint: Schema.String;
+    readonly headers: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly secretId: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>]>>;
+    readonly queryParams: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly secretId: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>]>>;
+    readonly auth: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"none">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly connectionId: Schema.String;
+    }>]>;
+}>>>, HttpApiEndpoint.Json<typeof InternalError | Schema.decodeTo<Schema.declareConstructor<GraphqlIntrospectionError, {
+    readonly message: string;
+    readonly _tag: "GraphqlIntrospectionError";
+}, readonly [Schema.TaggedStruct<"GraphqlIntrospectionError", {
+    readonly message: Schema.String;
+}>], {
+    readonly message: string;
+    readonly _tag: "GraphqlIntrospectionError";
+}>, Schema.TaggedStruct<"GraphqlIntrospectionError", {
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<GraphqlExtractionError, {
+    readonly message: string;
+    readonly _tag: "GraphqlExtractionError";
+}, readonly [Schema.TaggedStruct<"GraphqlExtractionError", {
+    readonly message: Schema.String;
+}>], {
+    readonly message: string;
+    readonly _tag: "GraphqlExtractionError";
+}>, Schema.TaggedStruct<"GraphqlExtractionError", {
+    readonly message: Schema.String;
+}>, never, never>>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"updateSource", "PATCH", "/scopes/:scopeId/graphql/sources/:namespace", HttpApiEndpoint.StringTree<Schema.Struct<{
+    scopeId: Schema.brand<Schema.String, "ScopeId">;
+    namespace: Schema.String;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly name: Schema.optional<Schema.String>;
+    readonly endpoint: Schema.optional<Schema.String>;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly auth: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"none">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+        readonly connectionId: Schema.String;
+    }>]>>;
+}>>, HttpApiEndpoint.StringTree<never>, HttpApiEndpoint.Json<Schema.Struct<{
+    readonly updated: Schema.Boolean;
+}>>, HttpApiEndpoint.Json<typeof InternalError | Schema.decodeTo<Schema.declareConstructor<GraphqlIntrospectionError, {
+    readonly message: string;
+    readonly _tag: "GraphqlIntrospectionError";
+}, readonly [Schema.TaggedStruct<"GraphqlIntrospectionError", {
+    readonly message: Schema.String;
+}>], {
+    readonly message: string;
+    readonly _tag: "GraphqlIntrospectionError";
+}>, Schema.TaggedStruct<"GraphqlIntrospectionError", {
+    readonly message: Schema.String;
+}>, never, never> | Schema.decodeTo<Schema.declareConstructor<GraphqlExtractionError, {
+    readonly message: string;
+    readonly _tag: "GraphqlExtractionError";
+}, readonly [Schema.TaggedStruct<"GraphqlExtractionError", {
+    readonly message: Schema.String;
+}>], {
+    readonly message: string;
+    readonly _tag: "GraphqlExtractionError";
+}>, Schema.TaggedStruct<"GraphqlExtractionError", {
+    readonly message: Schema.String;
+}>, never, never>>, never, never>, false>;

package/dist/api/handlers.d.ts

@@ -1,7 +1,7 @@
 import { Context } from "effect";
 import type { GraphqlPluginExtension } from "../sdk/plugin";
-declare const GraphqlExtensionService_base: Context.TagClass<GraphqlExtensionService, "GraphqlExtensionService", GraphqlPluginExtension>;
+declare const GraphqlExtensionService_base: Context.ServiceClass<GraphqlExtensionService, "GraphqlExtensionService", GraphqlPluginExtension>;
 export declare class GraphqlExtensionService extends GraphqlExtensionService_base {
 }
-export declare const GraphqlHandlers: import("effect/Layer").Layer<import("@effect/platform/HttpApiGroup").ApiGroup<"executor", "graphql">, never, GraphqlExtensionService>;
+export declare const GraphqlHandlers: import("effect/Layer").Layer<import("effect/unstable/httpapi/HttpApiGroup").ApiGroup<"executor", "graphql">, never, import("effect/unstable/http/HttpRouter").Request<"Requires", GraphqlExtensionService>>;
 export {};