apps 0.0.1-beta.0

package/types/apps/src/contracts/graphql.d.ts

@@ -0,0 +1,102 @@
+/** GraphQL discovery contracts. Catalogs are evaluated with the selected account. */
+import { Schema, type Effect } from "effect";
+import { type JsonValue } from "./schema.js";
+/** Provider timeout policy, independent of any enclosing operation deadline. */
+export declare const GraphqlClientLimits: Schema.Struct<{
+    readonly timeoutMs: Schema.Int;
+    readonly maxTimeoutMs: Schema.Int;
+}>;
+export type GraphqlClientLimits = typeof GraphqlClientLimits.Type;
+/** Current GraphQL discovery and call timeout defaults. */
+export declare const defaultGraphqlClientLimits: {
+    readonly timeoutMs: number;
+    readonly maxTimeoutMs: number;
+};
+/** Endpoint and credential snapshot for one app evaluation. */
+export declare const GraphqlToolsOptions: Schema.Struct<{
+    readonly url: Schema.String;
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly signal: Schema.optional<Schema.instanceOf<AbortSignal, AbortSignal>>;
+    readonly timeoutMs: Schema.optional<Schema.Int>;
+}>;
+export type GraphqlToolsOptions = typeof GraphqlToolsOptions.Type;
+declare const GraphqlError_base: Schema.Class<GraphqlError, Schema.TaggedStruct<"GraphqlError", {
+    readonly phase: Schema.Literals<readonly ["discover", "call"]>;
+    readonly reason: Schema.Literals<readonly ["request", "unauthorized", "invalid_response", "invalid_input", "timeout", "execution"]>;
+    readonly status: Schema.optional<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+/** Safe failures omit upstream bodies. Execution means a valid GraphQL error response, not malformed data. */
+export declare class GraphqlError extends GraphqlError_base {
+}
+/** The introspection subset used by tools; unknown upstream fields are omitted. */
+export interface GraphqlTypeRef {
+    readonly kind: "SCALAR" | "OBJECT" | "INTERFACE" | "UNION" | "ENUM" | "INPUT_OBJECT" | "LIST" | "NON_NULL";
+    readonly name: string | null;
+    readonly ofType?: GraphqlTypeRef | null | undefined;
+}
+/** Recursive wrappers retain list and nullability information. */
+export declare const GraphqlTypeRef: Schema.Codec<GraphqlTypeRef>;
+/** Query/mutation arguments and return type. */
+export declare const GraphqlField: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.NullOr<Schema.String>;
+    readonly args: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly description: Schema.NullOr<Schema.String>;
+        readonly type: Schema.Codec<GraphqlTypeRef, GraphqlTypeRef, never, never>;
+        readonly defaultValue: Schema.NullOr<Schema.String>;
+    }>>;
+    readonly type: Schema.Codec<GraphqlTypeRef, GraphqlTypeRef, never, never>;
+}>;
+export type GraphqlField = typeof GraphqlField.Type;
+/** Parsed, account-specific remote schema. */
+export declare const GraphqlIntrospection: Schema.Struct<{
+    readonly __schema: Schema.Struct<{
+        readonly queryType: Schema.NullOr<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly mutationType: Schema.NullOr<Schema.Struct<{
+            readonly name: Schema.String;
+        }>>;
+        readonly types: Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["SCALAR", "OBJECT", "INTERFACE", "UNION", "ENUM", "INPUT_OBJECT", "LIST", "NON_NULL"]>;
+            readonly name: Schema.String;
+            readonly fields: Schema.NullOr<Schema.$Array<Schema.Struct<{
+                readonly name: Schema.String;
+                readonly description: Schema.NullOr<Schema.String>;
+                readonly args: Schema.$Array<Schema.Struct<{
+                    readonly name: Schema.String;
+                    readonly description: Schema.NullOr<Schema.String>;
+                    readonly type: Schema.Codec<GraphqlTypeRef, GraphqlTypeRef, never, never>;
+                    readonly defaultValue: Schema.NullOr<Schema.String>;
+                }>>;
+                readonly type: Schema.Codec<GraphqlTypeRef, GraphqlTypeRef, never, never>;
+            }>>>;
+            readonly inputFields: Schema.NullOr<Schema.$Array<Schema.Struct<{
+                readonly name: Schema.String;
+                readonly description: Schema.NullOr<Schema.String>;
+                readonly type: Schema.Codec<GraphqlTypeRef, GraphqlTypeRef, never, never>;
+                readonly defaultValue: Schema.NullOr<Schema.String>;
+            }>>>;
+            readonly enumValues: Schema.NullOr<Schema.$Array<Schema.Struct<{
+                readonly name: Schema.String;
+            }>>>;
+        }>>;
+    }>;
+}>;
+export type GraphqlIntrospection = typeof GraphqlIntrospection.Type;
+/** GraphQL responses keep data separate from protocol errors. */
+export declare const GraphqlResponse: Schema.Struct<{
+    readonly data: Schema.optional<Schema.NullOr<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>>;
+    readonly errors: Schema.optional<Schema.$Array<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>>;
+}>;
+/** A query or mutation bound to one selected account, with native Effect operations. */
+export interface GraphqlTool {
+    readonly description: string;
+    readonly readOnly: boolean;
+    readonly input: Schema.Decoder<JsonValue>;
+    readonly run: (context: unknown, input: JsonValue) => Effect.Effect<JsonValue, GraphqlError>;
+}
+/** One tool per root field; subscriptions require a separate long-lived host. */
+export type GraphqlTools = Readonly<Record<string, GraphqlTool>>;
+export {};